[Gnu-arch-users] Re: "Newbie-ized help"

[Anand Kumria]

On Mon, 27 Sep 2004 20:04:37 +0900, Miles Bader wrote:

> Cameron Patrick <address@hidden> writes:
>> For a list of available commands, use `tla help CATEGORY', where CATEGORY
>> is one of:
>>
>>      starting : Setting up arch for the first time
>>        common : Most commonly used arch commands
>>       merging : Commands for branching and merging
>>      archives : Creating, modifying and mirroring arch archives
>>     libraries : Configuring and manipulating revision libraries
>>           all : All tla sub-commands
> 
> I like your general structure, and the "common" subset you show seems
> pretty sensible and nicely short.
> 
> Two points:
> 
>   1) Perhaps there should be a "deprecated" category, to show those
>      deprecated aliases which are now _never_ shown (which would show
>      even more commands than "all").

Why bother? If the command is deprecated only people who know about it
will care. Presumably tla <deprecated> -H would work and report the
new command name.

> 
>   2) Please show "add-id", not "add".
> 

Please don't, that wouldn't be 'newbie' friendly.

Thanks,
Anand