ruby.git/doc/string/split.rdoc, branch v3_4_9

[DOC] Fix the default `limit` of String#split

2024-11-19T03:15:48+00:00

We can't pass `nil` as the second parameter of `String#split`.
Therefore, descriptions like "if limit is nil, ..." are not appropriate.

s/ocurs/occurs/

2024-02-15T08:01:02+00:00

[DOC] Enhanced RDoc for String (#5726)

2022-03-28T20:49:18+00:00



Treats:

    #ljust
    #rjust
    #center
    #partition
    #rpartition

[DOC] Use RDoc inclusions in string.c (#5683)

2022-03-21T19:58:00+00:00



As @peterzhu2118 and @duerst have pointed out, putting string method's RDoc into doc/ (which allows non-ASCII in examples) makes the "click to toggle source" feature not work for that method.

This PR moves the primary method doc back into string.c, then includes RDoc from doc/string/*.rdoc, and also removes doc/string.rdoc.

The affected methods are:

    ::new
    #bytes
    #each_byte
    #each_line
    #split

The call-seq is in string.c because it works there; it did not work when the call-seq is in doc/string/*.rdoc.

This PR also updates the relevant guidance in doc/documentation_guide.rdoc.