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

[James Blackwell]

Zenaan: 
> 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
> http://lists.gnu.org/mailman/listinfo/gnu-arch-users
>
> GNU arch home page:
> http://savannah.gnu.org/projects/gnu-arch/
>


-- 
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