[Top][All Lists]

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

Re: [Gnu-arch-users] tla help text

From: James Blackwell
Subject: Re: [Gnu-arch-users] tla help text
Date: Tue, 21 Sep 2004 18:25:23 -0400

> 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'll happily accept the 's/\[archive]/[ARCHIVE]' change. 

However, changing ARCHIVE to [ARCHIVE] wouldn't be a proper change. 
Whether or not the optional [ARCHIVE] is given, the location of ARCHIVE
is actually recorded. 


> I find this distracting/ annoying.
> my 2c
> zen
> _______________________________________________
> Gnu-arch-users mailing list
> address@hidden
> GNU arch home page:

James Blackwell          Try something fun: For the next 24 hours, give
Smile more!              each person you meet a compliment!

GnuPG (ID 06357400) AAE4 8C76 58DA 5902 761D  247A 8A55 DA73 0635 7400

reply via email to

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