Better and more examples are always welcome, if you have any ideas
please feel free to submit a patch.

Otherwise, I'll try to put something together for this and #6996
sometime this week.


On Mon, Sep 10, 2012 at 4:02 PM, eike.rb (Eike Dierks) <eike / inter.net> wrote:
>
> Issue #6997 has been updated by eike.rb (Eike Dierks).
>
>
> Ok, I was a bit blind on that,
> I think that I now do understand how it works.
>
> But anyway, the documentation should be improved.
>
> I'd suggest to improve the examples to make it more clear upfront.
>
>
> ----------------------------------------
> Bug #6997: Improve documentation for OptionParser
> https://bugs.ruby-lang.org/issues/6997#change-29235
>
> Author: eike.rb (Eike Dierks)
> Status: Open
> Priority: Normal
> Assignee:
> Category:
> Target version:
> ruby -v: ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-darwin10]
>
>
> The documentation for OptionParser should be improved.
>
> The current examples and and documentation do not yet describe
> how to access non option args
>
> I suggest to change the simple example in the doc as follows:
>
>    opts.banner = "Usage: example.rb [options] file ..."
>
>    p "files:" + ARGV
>
>
> It should be stated explicitely in the description,
> that parse! modifies the ARGV and removes all parseable args.
>
> At least that is how I believe that the OptionParser.parse! works?
> not yet tried it myself
>
>
>
>
>
>
>
>
>
>
>
>
> --
> http://bugs.ruby-lang.org/
>