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

7. Archive Commands

7.1 abrowse  print an outline describing archive contents
7.2 rbrowse  print an outline describing an archive's contents
7.3 categories  list the categories in an archive
7.4 branches  list the branches in an archive category
7.5 versions  list the versions in an archive branch
7.6 revisions  list the revisions in an archive version
7.7 ancestry  display the ancestory of a revision
7.8 ancestry-graph  display the ancestory of a revision
7.9 cat-archive-log  print the contents of an archived log entry
7.10 cacherev  cache a full source tree in an archive
7.11 cachedrevs  list cached revisions in an archive
7.12 uncacherev  remove a cached full source tree from an archive
7.13 archive-meta-info  report meta-info from an archive
7.14 archive-snapshot  update an archive snapshot
7.15 archive-version  list the archive-version in an archive
7.16 archive-fixup  fix ancillary files (e.g. .listing files) in an archive

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

7.1 abrowse

print an outline describing archive contents

usage: tla abrowse [options] [limit]

 
  -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'
  -r, --reverse          sort revisions from newest to oldest
  -s, --summary          print a summary of each patch
  -c, --creator          print the creator of each patch
  -D, --date             print the date of each patch
  -k, --kind             show each revision kind (import, changeset or id)
  -f, --full             print full patch level names
  --desc                 implies -s -c -D -k
  --local-merges         list merges from the same archive
  --foreign-merges       list merges from other archives
  --merges               list all merges
  --categories           show category names only
  --branches             show branch names only
  --versions             show version names only
  --omit-empty           omit empty or unchanged-since items
  --since SNAP-FILE      show revisions after those listed in SNAP-FILE
  --since-limits         limit output to items in the since file
  --snap SNAP-FILE       record the highest revisions shown
  --force                overwrite an existing snap-file

Describe the contents of an archive in outline format.

With LIMIT, look only that part of the archive.

LIMIT may be a fully qualified name and may be an archive name.


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

7.2 rbrowse

print an outline describing an archive's contents

usage: tla rbrowse [options] [LIMIT REGEX]

 
  -h, --help               Display a help message and exit.
  -H                       Display a verbose help message and exit.
  -V, --version            Display a release identifier string
  --all                    Search all archives
  --since SNAP-FILE        Only show differences since SNAP-FILE
  --snap SNAP-FILE         Snap an archive
  -f, --snap-force         Force snap writing
  -r                       Reverse patch logs
  -s                       Print the summary of matching patches
  -c                       Print the creator of matching patches
  -D                       Print the date of matching patches
  --patch-regex REGEX      Only show revisions that contain [REGEX]
                           (implies -s)
  -A, --archive            Use [archive] instead of default
  --show-sealed            Do not hide sealed branches

an outline of an archive will be printed, showing the categories, branches and revisions of the specified archive if no archive is given then `my-default-archive` is used.

If [LIMIT REGEX] is specified, revisions will only be shown if the category, branch or version matches [LIMIT REGEX]. If --patch-regex [REGEX] is given, then only patchlogs matching [REGEX] will be given


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

7.3 categories

list the categories in an archive

usage: tla categories [options] [archive]

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

Print a list of the categories present in an archive.


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

7.4 branches

list the branches in an archive category

usage: tla branches [options] [category]

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

Print a list of the branches within CATEGORY


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

7.5 versions

list the versions in an archive branch

usage: tla versions [options] [branch]

 
  -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'
  -r, --reverse  sort from newest to oldest

Print a list of versions within an archive branch.

The list is ordinarily sorted from oldest to newest, but the order can be changed with -r (--reverse).


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

7.6 revisions

list the revisions in an archive version

usage: tla revisions [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'
  -r, --reverse  sort from newest to oldest
  -f, --full     list fully qualified names
  -s, --summary  print a summary of each patch
  -c, --creator  print the creator of each patch
  -D, --date     print the date of each patch

Print a list of revisions within an archive version.

The list is ordinarily sorted from oldest to newest, but the order can be changed with -r (--reverse).

With optional arguments specifying patches, list only those patches, if they exist. If a listed patch does not exist, exit with status 1. The -r (--reverse) flag has no effect with optional arguments.


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

7.7 ancestry

display the ancestory of a revision

usage: tla ancestry [options] [revision]

 
  -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
  -m, --merges   show merges into this development line
  -r, --reverse  list oldest to newest
  -s, --summary  print a summary of each patch
  -c, --creator  print the creator of each patch
  -D, --date     print the date of each patch

Print the ancestry of a revision.


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

7.8 ancestry-graph

display the ancestory of a revision

usage: tla ancestry-graph [options] [revision]

 
  -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
  -m, --merges     show merges into this development line
  -r, --reverse    list oldest to newest
  -i, --immediate  show only the immediate ancestor
  -p, --previous   show the (namespace) previous revision

Print a list describing the ancestry of a revision.


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

7.9 cat-archive-log

print the contents of an archived log entry

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

 
  -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'
  --headers      show only log headers

Retrieve and print the log message for the indicated revision from its archive.


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

7.10 cacherev

cache a full source tree in an archive

usage: tla cacherev [options] [revision]

 
  -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'
  --cache DIR      cache root for trees with pristines

Cache a full-text copy of the indicated revision in the archive. This can speed up subsequent calls to "tla get" for that and subsequent revisions.

If no revision is specified, but the command is run from within a project tree, cache the latest revision in the default version of that tree.


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

7.11 cachedrevs

list cached revisions in an archive

usage: tla cachedrevs [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'

Report which revisions of VERSION have been cached as whole trees in the archive.

See also "tla cacherev -H".


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

7.12 uncacherev

remove a cached full source tree from an archive

usage: tla uncacherev [options] revision [dir]

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

Remove the cached form of REVISION from its archive.

If REVISION is not specified, but the command is run from within a project tree, uncache the latest revision in the default version of that tree.

Also see "tla cacherev -H".


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

7.13 archive-meta-info

report meta-info from an archive

usage: tla archive-meta-info [options] item-name

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

Print the contents of a meta-info file from an archive. For example,

 
    % tla archive-meta-info name

prints the official name of your default archive.


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

7.14 archive-snapshot

update an archive snapshot

usage: tla archive-snapshot [options] dir [limit]

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

Update the directory DIR with a "snapshot" of of an archive (or the part of the archive indicated by LIMIT

For each archive snapshotted, DIR will contain a file and subdirectory (where $ARCH is the name of the archive):

 
    ./$ARCH.added
    ./$ARCH/

Similarly, for each category snapshotted, DIR will contain:

 
    ./$ARCH/$CAT.added
    ./$ARCH/$CAT/

and so on, recursively, for branches and versions.

For each revision, the snapshot contains:

 
    ./$ARCH/$CAT/$BRANCH/$VERSION/$REVISION.added

and that file contains a copy of the patch log entry for that revision.

Snapshots can be used in combination with other tools ('make' is suggested) to trigger one-time events in response to new additions to an archive.


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

7.15 archive-version

list the archive-version in an archive

usage: tla archive-version [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.
  -A, --archive  Override `my-default-archive'

Print the archive format identifier string of an arch archive.


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

7.16 archive-fixup

fix ancillary files (e.g. .listing files) in an archive

usage: tla archive-fixup [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.
  -A, --archive  Override `my-default-archive'

This is a kind of "catch-all" command to fix the non-standard, non-transactional state of an archive. Currently its sole function is to repair .listing files in archives that use them.


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

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