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

[James Blackwell]

Ok. I worked on hiding "advanced" commands. The results are as follow: 

------------------------------------------------------------------
tla help | wc -l             | tla help --full | wc -l           |
94                           | 182                               |
-----------------------------+-----------------------------------+
tla help | grep ":" | wc -l  | tla help --full | grep ":" | wc -l|
43                           | 105                               |
------------------------------------------------------------------

Of course, that would annoy "advanced" users, so users can either run
"tla help --full" or run "tla help --enable-all-help" once, and tla will
show the full help from then on.


Here's the commands I kept: 

                        tla sub-commands
                        ----------------

* help

                 help : provide help with arch


* User Commands

                my-id : print or change your id
   my-default-archive : print or change your default archive
     register-archive : change an archive location registration
             archives : report registered archives and their locations


* Project Tree Commands

            init-tree : initialize a new project tree

                 undo : undo and save changes in a project tree
                 redo : redo changes in project tree
              changes : report about local changes in a project tree


* Project Tree Inventory Commands

            inventory : inventory a source tree
            tree-lint : audit a source tree
                   id : report the inventory id for a file
               add-id : add an explicit inventory id
                  add : (alias for add-id)
            delete-id : remove an explicit inventory id
               delete : (alias for delete-id)
                   rm : remove a file (or dir, or symlink) and its explicit 
inventory tag (if any)
              move-id : move an explicit inventory id
                 move : (alias for move-id)
                   mv : move a file (or dir, or symlink) and its explicit 
inventory tag (if any)
     explicit-default : print or modify default ids



* Archive Transaction Commands

         make-archive : create a new archive directory
        archive-setup : create new categories, branches and versions
               import : archive a full-source base-0 revision
               commit : archive a changeset-based revision
                  get : construct a project tree for a revision
       archive-mirror : update an archive mirror


* Archive Commands

              abrowse : print an outline describing archive contents
              rbrowse : print an outline describing an archive's contents
             cacherev : cache a full source tree in an archive


* Patch Log Commands

             make-log : initialize a new log file entry
                 logs : list patch logs for a version in a project tree
            changelog : generate a ChangeLog from a patch log


* Commands for Branching and Merging

                  tag : create a continuation revision (aka tag or branch)
               update : update a project tree to reflect recent archived changes
               replay : apply revision changesets to a project tree
           star-merge : merge mutually merged branches
              missing : print patches missing from a project tree



* Local Cache Commands

              changes : report about local changes in a project tree
            file-diff : show local changes to a file


* Revision Library Commands

  my-revision-library : print or change your revision library path
       library-config : configure parameters of a revision library


* Published Revisions Commands

                 grab : grab a published revision


Use tla command -h for help on `command', or tla command -H for detailed help.


Ok. Discuss.

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