[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Emphasizing commonly-used commands in 'svn help' output.

From: nick vajberg <nickvajberg_at_yahoo.dk>
Date: 2005-07-12 11:29:12 CEST

I really dislike the proposal of just showing a
partial list. There's a few tools that does this, and
they routinely confuse me.

The proper solution IMO is to group the commands into
logical categories; grep --help is a guiding example.

There should even be a short description for each
command, as with grep and a host of other commands.

A long list is not problematic as long as it is easy
on the eye.

I also dislike aliases. They do nothing but making the
help output harder to read and remembering the
commands gets more difficult for newbies. Making a
command a bit shorter to write is no argument; that
can be done by wrapper scripts for those in need.

Four aliases for 'delete' is, well, three to many.

So for instance (the categories would need some, uhm,
work):

Getting stuff from the repo:
  checkout
  commit
  update

Stuff that only affects the working copy:
  ...

Locking:
  lock
  unlock
  ...

Properties
  propdel
  propedit
  propget
  ...

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Jul 12 11:30:00 2005

This is an archived mail posted to the Subversion Dev mailing list.