Enhanced RDoc for Integer

[BurdetteLamar]

Treats:

#allbits?
#anybits?
#nobits?
#succ
#pred
#chr`
#to_s
#+
#-

This is a replacement for the merged-then-reverted PR 5099, which had an offending character in a C-code comment (from an irb example). The containing RDoc is now moved out of numeric.c and into numeric.rb, which I hope will be ok.

[jeremyevans]

I did some more research into the chr method, and think the documentation should be fixed for it. It's probably best to fix the documentation, but still include the fixed documentation in the numeric.c file, for consistency. Only methods defined in numeric.rb should be documented there.

[jeremyevans]

Can you please remove this example line, or change it so it doesn't have the ÿ character? For example:

string = 255.chr(Encoding::UTF_8)
string.encoding # => Encoding::UTF_8

FWIW, on my machine (where Encoding.default_internal is nil):

255.chr(Encoding::UTF_8) # => "\u00FF"

So the example you are using depends on configuration.

[BurdetteLamar]

Done.

[jeremyevans]

I don't think this call-seq is correct in terms of the default argument:

Encoding.default_internal ='UTF-8'
255.chr.encoding # => #<Encoding:ASCII-8BIT>
255.chr(Encoding.default_internal).encoding # => #<Encoding:UTF-8>

Encoding.default_internal = nil
255.chr.encoding # => #<Encoding:ASCII-8BIT>
255.chr(Encoding.default_internal) # TypeError

Probably needs two call-seq lines, one for no argument and one for an argument provided, since the behavior when providing a argument with the given default value is not the same as not providing an argument.

[BurdetteLamar]

Done.

[jeremyevans]

Looks good!

[ioquatix]

TY!