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
_______________________________________________
Gnu-arch-users mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/gnu-arch-users
GNU arch home page:
http://savannah.gnu.org/projects/gnu-arch/
