[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8. Patch Log Commands

8.1 make-log  initialize a new log file entry
8.2 log-versions  list patch log versions in a project tree
8.3 add-log-version  add a patch log version to a project tree
8.4 remove-log-version  remove a version's patch log from a project tree
8.5 logs  list patch logs for a version in a project tree
8.6 cat-log  print the contents of a project tree log entry
8.7 changelog  generate a ChangeLog from a patch log
8.8 log-for-merge  generate a log entry body for a merge
8.9 merges  report where two branches have been merged
8.10 new-merges  list tree patches new to a version

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.1 make-log

initialize a new log file entry

usage: tla make-log [options] [version]

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first

Create (if needed) a log entry file in the root of the project tree containing DIR, for the indicated VERSION.

The name of the new log file is printed to standard output.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.2 log-versions

list patch log versions in a project tree

usage: tla log-versions [options]

 
  -h, --help               Display a help message and exit.
  -H                       Display a verbose help message and exit.
  -V, --version            Display a release identifier string
                           and exit.
  -d, --dir DIR            cd to DIR first
  -a, --archive ARCHIVE    list only logs for ARCHIVE
  -c, --category CATEGORY  list only logs for CATEGORY
  -b, --branch BRANCH      list only logs for BRANCH
  -v, --vsn VERSION        list only logs for VERSION
  -r, --reverse            reverse the sort order

Print the list of versions for which there are patch logs in the project tree containing DIR (or the current directory).


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.3 add-log-version

add a patch log version to a project tree

usage: tla add-log-version [options] [archive]/version

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first

Add an initially empty list of patch log for VERSION to the project tree containing DIR (or the current directory).

A project tree patch log is a pre-requisite for checking the directory in on that version, or updating with patches from that version.

Note that versions recorded for a project tree are recorded by fully qualified version names: an archive name plus the name of a version within that archive.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.4 remove-log-version

remove a version's patch log from a project tree

usage: tla remove-log-version [options] [archive]/version

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first

Remove the patch log for VERSION from the project tree containing DIR (or the current directory).

Use this command with caution -- it erases revision history from the project tree!


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.5 logs

list patch logs for a version in a project tree

usage: tla logs [options] [[archive]/version ...]

 
  -h, --help            Display a help message and exit.
  -H                    Display a verbose help message and exit.
  -V, --version         Display a release identifier string
                        and exit.
  -A, --archive         Override `my-default-archive'
  -d, --dir DIR         cd to DIR first
  -r, --reverse         sort from newest to oldest
  -s, --summary         print the summary of each patch
  -c, --creator         print the creator of each patch
  -D, --date            print the date of each patch
  --local-merges        list merges from the same archive
  --foreign-merges      list merges from other archives
  --merges              list all merges
  -f, --full            print full patch level names

Print the list of patches applied to a project tree DIR (or the current directory) from VERSION.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.6 cat-log

print the contents of a project tree log entry

usage: tla cat-log [options] revision-spec

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first

Retrieve and print the patch log for the indicated revision from a project tree.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.7 changelog

generate a ChangeLog from a patch log

usage: tla changelog [options] [[archive]/version]

 
  -h, --help                  Display a help message and exit.
  -H                          Display a verbose help message and exit.
  -V, --version               Display a release identifier string
                              and exit.
  -A, --archive               Override `my-default-archive'
  -d, --dir DIR               cd to DIR first
  --no-files                  exclude file lists from ChangeLog
  --untagged                  don't implicitly tag the output file
  --new-entry PATCH,FILE      make FILE the first (top) entry
                                for patch level PATCH

Generate a ChangeLog for VERSION from the patch log for DIR.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.8 log-for-merge

generate a log entry body for a merge

usage: tla log-for-merge [options] [[archive]/version]

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first
  -r, --reverse  sort from newest to oldest

Generate a log entry body describing a merge into VERSION.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.9 merges

report where two branches have been merged

usage: tla merges [options] INTO [FROM]

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first
  -r, --reverse  sort from newest to oldest
  -f, --full     print full patch level names

Print a list of pairs of patch level names:

 
        %s	%s   INTO-RVN  FROM-RVN

where each pair indicates that at patch level INTO-RVN of INTO, the patch log entry FROM-RVN was added.

FROM may be a branch name, version name, or revision name. If a branch or version name, all merges from that branch or version are reported. If a revision name, only the merge points for that specific revision are reported.

INTO may be a version name or revision name. If a version name, all merge points within that version are printed. If a revision name, all merge points at that revision or earlier are printed.

Output is sorted using patch-level ordering of the first column.

Included patches are listed by full name unless FROM is a revision name. If FROM is a revision, --full causes its full name to be printed.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

8.10 new-merges

list tree patches new to a version

usage: tla new-merges [options] [[archive]/version]

 
  -h, --help     Display a help message and exit.
  -H             Display a verbose help message and exit.
  -V, --version  Display a release identifier string
                 and exit.
  -A, --archive  Override `my-default-archive'
  -d, --dir DIR  cd to DIR first
  -r, --reverse  sort from newest to oldest

List all patch log entries in the tree containing DIR that have not already been merged with VERSION.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by wilk on May, 11 2004 using texi2html