File README of Package tla-tools

tla-tools: Helpful utilities for use with tla
=============================================

tla-tools is a package of helpful commands to use with the tla program.

It can be found in the arch branch:

    miles@gnu.org--gnu-2004/tla-tools--devo--0

The archive miles@gnu.org--gnu-2004 is available from:

    [WWW]http://sourcecontrol.net/~miles/miles@gnu.org--gnu-2004

The main user commands in tla-tools are:

                            Switches an arch project tree's current branch to  
tla-switch                  another branch, changing the actual source files to
                            match (unlike the builtin tla command tla          
                            set-tree-version)                                  
                            Makes a new arch branch forking off the current    
tla-fork                    branch in a project tree, and makes that the tree's
                            current branch.                                    
tla-cvs-sync                Does bi-directional gatewaying of an arch branch   
                            with a CVS branch.                                 
tla-update-ids              Goes through a project tree, and automatically adds
                            or updates taglines and explicit id-tags.          
tla-file-log                Outputs arch changeset logs which affect a         
                            specified file.                                    
                            Looks through a project tree for ChangeLog.rej     
tla-fix-changelog-conflicts files (containing conflicts from merging changes to
                            the ChangeLog file), and tries to automatically fix
                            them up, using a simple rule.                      
tla-copy-changes            Copies changesets from one arch branch to another. 
                            Runs a tla command using the "partner version" of a
tla-partner                 project tree (defined by the contents of the file  
                            {arch}/+partner).                                  

Some other handy commands include:

                      Turns any changes in (GNU-style) ChangeLog files in a    
tla-changelogs-to-log project tree into a single log text appropriate for      
                      including in a tla commit log.                           
                      Does a tla commit with a log text appropriate for a      
tla-commit-merge      merge: the Summary: line mentions the merged version, and
                      the body is the output of tla log-for-merge filtered     
                      through tla-abbrev-merge-log.                            
                      A filter for the output of tla log-for-merge which       
tla-abbrev-merge-log  replace repetitive sequences of entries with an          
                      abbreviated form.                                        
tla-log-to-cvs-log    Converts an arch changeset commit log into a compact form
                      suitable for including in a CVS commit log.              
tla-fork-archive      Forks branches from one archive into another.