[Monotone-devel] Why?

[Richard Levitte - VMS Whacker]

I've a couple of gripes that I need to share:

1. 'monotone update' still takes an optional argument.  Is there any
   reason why it doesn't use --revision like all the others?  If noone
   minds a change to using --revision, I've a change ready to be
   commited.
2. Why on earth does everyone insist on putting all those random
   [--revision=REVISION] and other options in the arguments help for
   the command when those options are already explained above the
   command help?  The commands currently having that kind of extra
   garbage are 'log', 'checkout', 'diff' and 'cdiff'.  I could
   understand it for those taking two --revision, but honestly, I
   think the help on --revision should be extended to say this is
   possible.  However, for a command like 'checkout', it's just plain
   silly:

     : ; ./monotone checkout --help
     Usage: monotone [OPTION...] command [ARGS...]
     [...]
     Options specific to 'monotone checkout':
       -b, --branch=STRING       select branch cert for operation
       -r, --revision=STRING     select revision id for operation
     
          checkout [--revision=REVISION] [DIRECTORY]
            check out revision from database into directory

   I'd like to change it to look like this:

     : ; ./monotone checkout --help
     Usage: monotone [OPTION...] command [ARGS...]
     [...]
     Options specific to 'monotone checkout':
       -b, --branch=STRING       select branch cert for operation
       -r, --revision=STRING     select revision id for operation
     
          checkout [DIRECTORY]
            check out revision from database into directory

     : ; ./monotone log --help
     Usage: monotone [OPTION...] command [ARGS...]
     [...]
     Options specific to 'monotone log':
       -r, --revision=STRING     select revision id for operation
       --last=LONG               limit the log output to the given number of 
entries
       --brief                   print a brief version of the normal output
     
          log [file]
            print history in reverse order (filtering by 'file').  If one or 
more revisions
            are given, use them as a starting point.

   Opinions?

Cheers,
Richard

-----
Please consider sponsoring my work on free software.
See http://www.free.lp.se/sponsoring.html for details.

-- 
Richard Levitte                         address@hidden
                                        http://richard.levitte.org/

"When I became a man I put away childish things, including
 the fear of childishness and the desire to be very grown up."
                                                -- C.S. Lewis