gnu-arch-users
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Gnu-arch-users] tla help text


From: Zenaan Harkness
Subject: [Gnu-arch-users] tla help text
Date: Tue, 21 Sep 2004 12:36:02 +1000

Example:

$ tla register-archive -H
change an archive location registration
usage: tla register-archive [options] [archive] location

  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -f, --force    overwrite existing location
  -d, --delete   delete archive registration

Record the location of ARCHIVE.
...


In the above, it would be clearer if [archive] were changed to [ARCHIVE]
or perhaps ARCHIVE were changed to [archive].  I do a sort of variable
substitution in my head, and the fact that the "variables" are not the
same is repeatedly causing me to do a double take, and cross check
carefully to see if I missed something.

I find this distracting/ annoying.

my 2c
zen




reply via email to

[Prev in Thread] Current Thread [Next in Thread]