[Gnu-arch-users] Re: Question about bug 8206

[Pedro Perez]

Miles Bader wrote:
> Is the help output for "changes" really the right place for this sort of
> thing?
Hello Miles,
   I honestly believe this is one of the best placed for this type of 
information. Quoting from the current tla tutorial
"arch is largely a self documenting program." 
(http://www.gnu.org/software/gnu-arch/tutorial/Introducing-arch.html#Introducing-arch)

As a user, the closer the information is to the command that generates 
it, the better it is, no? While protocols and implementation details 
should be documented elsewhere, others should be documented as close to 
the user as possible.
> It could be handy to have the info in the program, but this
> format is used many places, not just in "changes", and in addition I
> presume that most people look at -H output to get quick option help.
>   
If Debian uses the output of -H to generate a manpage (as Sylvain 
Beucier says), then is there a better place for this type of information?
> How about just adding a new command like "tla help-changesets" or
> something, which outputs exactly that info...?  The "tla changes" help
> output can then say something like "For a description of the changeset
> summary output, use the command `tla help-changesets'" (and other
> commands might say the same thing).
>   
While, it could be argue that the last thing that tla needs at this time 
is yet another command, it is an interesting suggestion.

--
Pedro Perez