On Jun 18, 2006, at 17:12, James B. wrote:
Please see http://ruby-doc.org/stdlib/status.html
This sounded interesting, so I dropped by, then started looking through
some of the files to see if I knew enough about Ruby to contribute.
Probably not yet. 
However, I wanted to compare a “done” module with
one of the unfinished ones, so I opened up getoptlong.rb, which is
marked as “done” and has a score of 10.
I think I found some typos or glitches.
OK, so the first puzzle is that it isn’t in my “ri” doc directory at
all. Now, since I don’t like ri’s interface, I rebuilt all the docs, so
my HTML version DOES have RDoc output for GetoptLong.
First was this. Under the heading “Constants,” I see
ORDERINGS = [REQUIRE_ORDER = 0, PERMUTE = 1, RETURN_IN_ORDER = 2]
Orderings.
ARGUMENT_FLAGS = [NO_ARGUMENT = 0, REQUIRED_ARGUMENT = 1,
OPTIONAL_ARGUMENT = 2]
Argument flags.
STATUS_TERMINATED = 0, 1, 2
It’s that last line that doesn’t make sense. The actual Ruby code looks
like
Orderings.
ORDERINGS = [REQUIRE_ORDER = 0, PERMUTE = 1, RETURN_IN_ORDER = 2]
Argument flags.
ARGUMENT_FLAGS = [NO_ARGUMENT = 0, REQUIRED_ARGUMENT = 1,
OPTIONAL_ARGUMENT = 2]
Status codes.
STATUS_YET, STATUS_STARTED, STATUS_TERMINATED = 0, 1, 2
Something about the status codes isn’t coming out through RDoc
correctly, I think.
The other item I spotted just looks like a simple typo.
Set/Unset `quit’ mode.
attr_writer :quiet
It seems likely to me that it should be “quiet” mode, not “quit” mode.
Where should I send such observations?