Issue #19247 has been updated by zverok (Victor Shepelev).
https://github.com/ruby/ruby/pull/6985 Fixes:
* Fiber
* SyntaxError
* Struct
* Time
* UnboundMethod
* GC
I plan to do at least two more before the release:
* One documenting all the changes in `Fiber::Scheduler` and `IOBuffer`
* One documenting `AbstractSyntaxTree` options and behaviors (besides new options for
`initialize`, there are new methods in `Node`, and some were missed in 3.0, too)
* (Maybe) One with wording/examples improvement for newly introduced methods, where it is
not critical.
----------------------------------------
Misc #19247: Ruby 3.2 documentation problems tracker
https://bugs.ruby-lang.org/issues/19247#change-100742
* Author: zverok (Victor Shepelev)
* Status: Open
* Priority: Normal
* Assignee: zverok (Victor Shepelev)
----------------------------------------
Bugs and problems:
* [
Fiber](https://docs.ruby-lang.org/en/master/Fiber.html):
* Formatting glitches for `::[]`, `::[]=`, `::storage`, `::storage=` (no references to
companion methods)
* Also there are some rendering glitches in Fiber, due to RDoc update? (Source
didn't change)
* After renaming SchedulerInterface to Scheduler, reference to it from Fiber are lost
* [
FiberScheduler](https://docs.ruby-lang.org/en/master/Fiber/Scheduler.html) has no docs
for new method `#io_select`
* [
SyntaxError](https://docs.ruby-lang.org/en/master/SyntaxError.html): new attribute
`#path` wrongly rendered
*
[
RubyVM::AbstractSyntaxTree](https://docs.ruby-lang.org/en/master/RubyVM/Abs…:
`error_tolerant:` and `keep_tokens:` options aren't documented or mentioned in the
docs
* [
Set](https://docs.ruby-lang.org/en/master/Set.html): docs still start with `require
'set'` :)
* [
Struct](https://docs.ruby-lang.org/en/master/Struct.html): no mention of the changed
requirement about keyword initialization.
*
[
Time#deconstruct_keys](https://docs.ruby-lang.org/en/master/Time.html#metho…
instead of listing keys refers to "the same as returned by to_h", which we
decided not to implement, my bad!
*
[
UnboundMethod#==](https://docs.ruby-lang.org/en/master/UnboundMethod.html#m…
says that methods are equal if are bound to the same object :) (shares docs with
`Method`?..)
*
[
GC::latest_gc_info](https://docs.ruby-lang.org/en/master/GC.html#method-c-l…
rendering glitch (old probably). It also lacks any docs about the structure of the hash
returned.
*
[
ObjectSpace.dump_all](https://docs.ruby-lang.org/en/master/ObjectSpace.html…
and several companion methods are weirdly documented as instance methods (RDoc glitch,
doubtfully easy to fix)
Things that could be improved:
*
[
Module#undefined_instance_methods](https://docs.ruby-lang.org/en/master/Mod…
is not really helpful :)
*
[
Refinement#refined_class](https://docs.ruby-lang.org/en/master/Refinement.h…
can use better explanation/example?
*
[
Thread::each_caller_location](https://docs.ruby-lang.org/en/master/Thread.h…
can use an example? (Also wrongly referred as instance method in
[
NEWS](https://docs.ruby-lang.org/en/master/NEWS_md.html#label-Core+classes+…)
I'll try to work on those ASAP.
--
https://bugs.ruby-lang.org/