Bug #8392

stdlib's 'forwardable' documentation has a bad example

Added by miragliuolo1 (Joe Miragliuolo) about 7 years ago. Updated about 7 years ago.

Target version:
ruby -v:
ruby 2.0.0p0 (2013-02-24 revision 39474) [x86_64-darwin11.4.2]


As this is a problem with the documentation, there are no steps required to reproduce it.
My Ruby version is currently ruby 2.0.0p0 (2013-02-24 revision 39474) [x86_64-darwin11.4.2], but this documentation problem appears to have been in Ruby since at least ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-darwin11.4.0].

The second example of the (({Forwardable})) module in stdlib appears to be a mish-mash of two separate and incompatible examples. It begins by defining deligators for a (({RecordCollection})) class, but then goes on to make a new instance of the (({Foo})) class (never defined), calling methods on that instance that are also never defined.

I expected it to show a new instance of the (({RecordCollection})) class and to call the methods that were delegated in the first parts of the example ((({:record_number, :size, :<<, :map}))).



Updated by zzak (Zachary Scott) about 7 years ago

  • Category set to doc
  • Status changed from Open to Assigned
  • Assignee set to zzak (Zachary Scott)
  • Target version set to 2.1.0

Updated by zzak (Zachary Scott) about 7 years ago

I have left some comments on the pull request, please check it.


Updated by zzak (Zachary Scott) about 7 years ago

  • Status changed from Assigned to Closed
  • % Done changed from 0 to 100

This issue was solved with changeset r40839.
Joe, thank you for reporting this issue.
Your contribution to Ruby is greatly appreciated.
May Ruby be with you.

  • lib/forwardable.rb: Forwardable examples in overview were broken Based on patch by @joem [Fixes GH-303] [Bug #8392]

Also available in: Atom PDF