RE: Embedded pager

> Van: anatoly techtonik [mailto:techtonik_at_gmail.com]
>
> SVN command line help is getting huge with every release. I really
> miss pager for reading command line help in windows. I've tired of
> extra typing to pipe help output to "more" once in a while to get
> to arguments list format. As I was asked to discuss this prior to
> entering bug report, I post this request here.

Do you have any suggestions on how to handle this? I mean, the huge help is there for a reason, since there are lots of options, and lots of important things to say about them. That said, I guess it wouldn't hurt to have a short version, just listing the syntax, arguments format, ...?

Maybe a new "usage" command should be added that does exactly this, like so:
-------------
$ svn usage checkout
checkout (co): Check out a working copy from a repository.
usage: checkout URL[@REV]... [PATH]
Valid options:
  -r [--revision] ARG : ARG (some commands also take ARG1:ARG2 range)
                             A revision argument can be one of:
                                NUMBER revision number
                                '{' DATE '}' revision at start of the date
                                'HEAD' latest in repository
                                'BASE' base rev of item's working copy
                                'COMMITTED' last commit at or before BASE
                                'PREV' revision just before COMMITTED
  -q [--quiet] : print nothing, or only summary information
  -N [--non-recursive] : obsolete; try --depth=files or --depth=immediates
  --depth ARG : limit operation by depth ARG ('empty', 'files',
                            'immediates', or 'infinity')
  --force : force operation to run
  --ignore-externals : ignore externals definitions
---------------

What do you think? Or even without the options, just the first two lines?

Regards,
Johan

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=1065&dsMessageId=2387135

To unsubscribe from this discussion, e-mail: [users-unsubscribe_at_subversion.tigris.org].
Received on 2009-08-27 00:06:36 CEST