12. Revision Library Commands

12.1 my-revision-library		print or change your revision library path
12.2 library-config		configure parameters of a revision library
12.3 library-find		find and print the location of a revision in the revision library
12.4 library-add		add a revision to the revision library
12.5 library-remove		remove a revision from the revision library
12.6 library-archives		list the archives in your revision library
12.7 library-categories		list the categories in your revision library
12.8 library-branches		list the branches in a library category
12.9 library-versions		list the versions in a library branch
12.10 library-revisions		list the revisions in a library version
12.11 library-log		output a log message from the revision library
12.12 library-file		find a file in a revision library

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.1 my-revision-library

print or change your revision library path

usage: tla my-revision-library [options] [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.
  -e, --errname      specify program name for errors
  -d, --delete       unspecify your revision library
  -s, --silent       suppress reassuring messages
  --search           use the full search path
  --add              use the full add path
  --search-only      use the search-only path
  --add-only         use the add-only path
  --first            prepend to the path if setting (default appends)

With no argument, and without -d, print the path to your revision library.

With an argument, record DIR as the path to your revision library in ~/.arch-params/=revision-library

With the option -d (--delete) and no argument, ensure that you do not have a revision library path set in ~/.arch-params.

If no revision library is set, the program exits with status 1, printing an error message unless the -s (--silent) option is given.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.2 library-config

configure parameters of a revision library

usage: tla library-config [options] library-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.
  --greedy          make the library greedy
  --non-greedy      make the library not greedy
  --sparse          make the library sparse (by default)
  --non-sparse      make the library not sparse (by default)

Set/show various parameters for a revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.3 library-find

find and print the location of a revision in the revision library

usage: tla library-find [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'
  -e, --errname  specify program name for errors
  -s, --silent   suppress reassuring messages

Find REVISION in your revision library and print its path. If the revision is not present, print an error message (unless --silent is specified) and exit with non-0 status.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.4 library-add

add a revision to the revision library

usage: tla library-add [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'
  -s, --sparse          Don't fill in gaps in the library.
  --non-sparse          Fill in gaps in the library.
  -L, --library LIB     specify which library to add to
  --for-links PATH      require a lib on the same device as PATH

Add REVISION to your revision library.

This command has no effect and exits with status 0 if the indicated revision is already in the library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.5 library-remove

remove a revision from the revision library

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

Remove REVISION from your revision library.

If the revision is not present, print an error message and exit with non-0 status.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.6 library-archives

list the archives in your revision library

usage: tla library-archives [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.

List all archives with records in the revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.7 library-categories

list the categories in your revision library

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

List all categories within a given archive in the revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.8 library-branches

list the branches in a library category

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

List all branches within CATEGORY in the revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.9 library-versions

list the versions in a library branch

usage: tla library-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

List all versions within a particular archive/branch with records in the revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.10 library-revisions

list the revisions in a library version

usage: tla library-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

List all revisions within a particular archive/version with records in the revision library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.11 library-log

output a log message from the revision library

usage: tla library-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'
  -s, --silent   suppress reassuring messages

Print the log message for REVISION from the library.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

12.12 library-file

find a file in a revision library

usage: tla library-file [options] file 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'
  --id           interpret FILE as an inventory id
  --this         interpret FILE as a file within a project tree

Find FILE in REVISION in your revision library and print its path. If the revision or file is not present, print an error message and exit with non-0 status.

[ << ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

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