Adds section "Transcoding a Stream," listing relevant methods in IO.
Moves an example from section "String Encoding Example" to the new section.
Removes header "String Encoding Example" for now-empty section.
Changes items in section "Transcoding a String" from labeled list items to bullet list items. (Labeled list items are sometimes rendered with strange indentations for continued lines, and are always rendered with different indentations for the items.)
* Add encoding external/internal example to encoding.rdoc
* Add encoding external/internal example to encoding.rdoc
* Update doc/encoding.rdoc
I think there may be some more of these that I've recently put into io.c. Will check tomorrow and create new PR if so.
Co-authored-by: Peter Zhu <peter@peterzhu.ca>
Co-authored-by: Peter Zhu <peter@peterzhu.ca>
This is the beginning of an extended explication of Ruby encoding.
One of its more important jobs is to provide link targets for encoding documentation in other classes (String, File, IO, etc.). In particular, they can link to the "Encoding Options" section.
I'll have much to add to this document going forward, along with suitable adjustments in the class documentation.