Project

General

Profile

ActionsLike0

Bug #8392

closed

stdlib's 'forwardable' documentation has a bad example

Added by miragliuolo1 (Joe Miragliuolo) over 11 years ago. Updated over 11 years ago.

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

Description

=begin
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].

Problem:
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.

Expected:
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}))).

=end

Like0Actions #1

Updated by zzak (zzak _) over 11 years ago

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

Updated by zzak (zzak _) over 11 years ago

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

Like0Actions #3

Updated by zzak (zzak _) over 11 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]
ActionsLike0

Also available in: Atom PDF