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

[Cameron Patrick]

James Blackwell wrote:
> Ok. Discuss.

94 lines is still a heck of a lot of help output. Some of the ones
you've left in are aliases (which shouldn't be included in "newbie"
help) and some of them are what I'd consider esoteric
(e.g. explicit-default -- after reading the help on it, I'm still not
sure what it does or why I'd ever want to use it).

Why show both abrowse and rbrowse in the "newbie" help?  I've only
ever used abrowse, but from reading this list it seems that rbrowse
can do a superset of what abrowse can.  Also, the current organisation
of sub-headings etc seem kind of arbitrary, at least to a newcomer.

How about splitting them by "task"?

A (sub-optimal) first shot, showing the tla commands I use regularly:

tla help -> a short introduction, points to other help
tla help starting -> my-id, my-revision-library, library-config
                     make-archive, my-default-archive,
                     register-archive, archives
tla help common -> init-tree, import, tree-lint,
                   get, commit, update,
                   add, rm, mv,
                   changes, undo, redo,
                   inventory, logs, changelog
tla help merging -> tag, star-merge, replay,
                    revisions, logs, missing
tla help archives -> my-default-archive, register-archive,
                     make-archive, archives
                     abrowse, archive-mirror,
                     cacherev, uncacherev, cachedrevs
tla help libraries -> my-revision-library, library-config,
                      library-add, library-remove,
                      ???
tla help configs (??) -> build-config, cat-config, grab 
tla help all -> the whole lot

Regards,

Cameron.