table of contents
- NAME
- SYNOPSIS
- DESCRIPTION
- COMMAND OVERVIEW
- HELP
- USER COMMANDS
- PROJECT TREE COMMANDS
- PROJECT TREE INVENTORY COMMANDS
- PATCH SET COMMANDS
- ARCHIVE TRANSACTION COMMANDS
- ARCHIVE COMMANDS
- PATCH LOG COMMANDS
- MULTI-PROJECT CONFIGURATION COMMANDS
- COMMANDS FOR BRANCHING AND MERGING
- LOCAL CACHE COMMANDS
- REVISION LIBRARY COMMANDS
- PUBLISHED REVISIONS COMMANDS
- MISCELLANEOUS SCRIPTING SUPPORT
- ENVIRONMENT
- FILES
- SEE ALSO
tla(1) | tla arch client | tla(1) |
NAME¶
tla - arch command line client toolSYNOPSIS¶
tla command [ command_options ]DESCRIPTION¶
tla is an implementation of arch .Works on Whole Trees¶
arch keeps track of whole trees -- not just individual files. For example, if you change many files in a tree, arch can record all of those changes as a group rather than file-by-file; if you rename files or reorganize a tree, arch can record those tree arrangements along with your changes to file contents.Changeset Oriented¶
arch doesn´t simply "snapshot" your project trees. Instead, arch associates each revision with a particular changeset: a description of exactly what has changed. arch provides changeset oriented commands to help you review changesets, merge trees by applying changesets, examine the history of a tree by asking what changesets have been applied to it, and so forth.Fully Distributed¶
arch doesn´t rely on a central repository. For example, there is no need to give write access to a project´s archive to all significant contributors. Instead, each contributor can have their own archive for their work. arch seamlessly operates across archive boundaries.COMMAND OVERVIEW¶
Help¶
- tla help [options]
- provide help with arch
User Commands¶
- tla my-id [options] [id]
- print or change your id
- tla my-default-archive [options] [archive]
- print or change your default archive
- tla register-archive [options] [archive] location
- change an archive location registration
- tla whereis-archive [options] archive
- print an archive location registration
- tla archives [options] [search regular expression]
- report registered archives and their locations
Project Tree Commands¶
- tla init-tree [options] [[archive]/version]
- initialize a new project tree
- tla tree-root [options] [dir]
- find and print the root of a project tree
- tla tree-version [options] [dir]
- print the default version for a project tree
- tla tree-id [options] [dir]
- Print the tree identifier for a project tree
- tla tree-revision [options] [dir]
- Print the tree identifier for a project tree
- tla set-tree-version [options] [archive]/version
- set the default version for a project tree
- tla undo [options] [revision]
- undo and save changes in a project tree
- tla redo [options] [changeset]
- redo changes in project tree
- tla changes [options] [revision] [-- limit...]
- report about local changes in a project tree
- tla file-diff [options] file [revision]
- show local changes to a file
- tla diff [options] [revision] [-- files...]
- report about local changes in a project tree
- tla export [options] [revision] dir
- export all or some of a tree revision
Project Tree Inventory Commands¶
- tla inventory [options] [--] [dir]*
- inventory a source tree
- tla tree-lint [options] [dir]
- audit a source tree
- tla lint [options] [dir]
- audit a source tree
- tla id [options] file ...
- report the inventory id for a file
- tla id-tagging-method [options] [method]
- print or change a project tree id tagging method
- tla add [options] file ...
- add an explicit inventory id
- tla add-id [options] file ...
- add an explicit inventory id
- tla delete-id [options] file ...
- remove an explicit inventory id
- tla move-id [options] from to
- move an explicit inventory id
- tla touch [options] file ...
- add an explicit inventory id, touching the file.
- tla rm [options] file...
- remove a file (or dir, or symlink) and its explicit
inventory tag
- tla mv [options] from to OR from1 from2 ... dir
- move a file (or dir, or symlink) and its explicit inventory
tag
- tla explicit-default [options] [TAG-PREFIX]
- print or modify default ids
- tla default-id [options] [TAG-PREFIX]
- print or modify default ids
- tla id-tagging-defaults [options]
- print the default =tagging-method contents
Patch Set Commands¶
- tla changeset [options] ORIG MOD DEST [files]
- compute a whole-tree changeset
- tla mkpatch [options] ORIG MOD DEST [files]
- compute a whole-tree changeset
- tla apply-changeset [options] CHANGESET [TARGET]
- apply a whole-tree changeset
- tla dopatch [options] CHANGESET [TARGET]
- apply a whole-tree changeset
- tla show-changeset [options] [dir]
- generate a report from a changeset
Archive Transaction Commands¶
- tla make-archive [options] [name] location
- create a new archive directory
- tla archive-setup [options] [version ...]
- create new categories, branches and versions
- tla make-category [options] category
- create a new archive category
- tla make-branch [options] branch
- create a new archive branch
- tla make-version [options] version
- create a new archive version
- tla import [options] [[archive]/version]
- archive a full-source base-0 revision
- tla commit [options] [[archive]/version] [-- file ...]
- archive a changeset-based revision
- tla get [options] revision [dir]
- construct a project tree for a revision
- tla get-changeset [options] revision [dir]
- retrieve a changeset from an archive
- tla lock-revision [options] revision
- lock (or unlock) an archive revision
- tla archive-mirror [options] [from [to] [limit]]
- update an archive mirror
Archive Commands¶
- tla abrowse [options] [limit]
- print an outline describing archive contents
- tla rbrowse [options] [[ARCHIVE_NAME/]LIMIT_REGEX]
- print an outline describing an archive´s contents
- tla categories [options] [archive]
- list the categories in an archive
- tla branches [options] [category]
- list the branches in an archive category
- tla versions [options] [branch]
- list the versions in an archive branch
- tla revisions [options] [version]
- list the revisions in an archive version
- tla ancestry [options] [revision]
- display the ancestory of a revision
- tla ancestry-graph [options] [revision]
- display the ancestory of a revision
- tla cat-archive-log [options] revision
- print the contents of an archived log entry
- tla cacherev [options] [revision]
- cache a full source tree in an archive
- tla cachedrevs [options] [version]
- list cached revisions in an archive
- tla uncacherev [options] revision [dir]
- remove a cached full source tree from an archive
- tla archive-meta-info [options] item-name
- report meta-info from an archive
- tla archive-snapshot [options] dir [limit]
- update an archive snapshot
- tla archive-version [options]
- list the archive-version in an archive
- tla archive-fixup [options]
- fix ancillary files in an archive
Patch Log Commands¶
- tla make-log [options] [version]
- initialize a new log file entry
- tla log-versions [options]
- list patch log versions in a project tree
- tla add-log-version [options] [archive]/version
- add a patch log version to a project tree
- tla remove-log-version [options] [archive]/version
- remove a version´s patch log from a project tree
- tla logs [options] [[archive]/version ...]
- list patch logs for a version in a project tree
- tla cat-log [options] revision-spec
- print the contents of a project tree log entry
- tla changelog [options] [[archive]/version]
- generate a ChangeLog from a patch log
- tla log-for-merge [options] [[archive]/version]
- generate a log entry body for a merge
- tla merges [options] INTO [FROM]
- report where two branches have been merged
- tla new-merges [options] [[archive]/version]
- list tree patches new to a version
Multi-project Configuration Commands¶
- tla build-config [options] config
- instantiate a multi-project config
- tla cat-config [options] config
- output information about a multi-project config
Commands for Branching and Merging¶
- tla tag [options] SOURCE-REVISION TAG-VERSION
- create a continuation revision
- tla branch [options] [SOURCE] BRANCH
- create a continuation revision
- tla switch [options] [package]
- change the working trees version
- tla update [options] [version/revision]
- update a project tree
- tla replay [options] [version/revision...]
- apply revision changesets to a project tree
- tla star-merge [options] [FROM]
- merge mutually merged branches
- tla apply-delta [options] FROM(REVISION|DIR) TO(REVISION|DIR)
- compute a changeset between any two trees or revisions and
apply it to a project tree
- tla missing [options] [version]
- print patches missing from a project tree
- tla join-branch [options] version
- add a version as an ancestor of a project tree
- tla sync-tree [options] revision
- unify a project tree´s patch-log with a given revision
- tla delta [options] (REVISION|TREE)-A (REVISION|TREE)-B [DESTDIR]
- compute a changeset (or diff) between any two trees or
revisions
Local Cache Commands¶
- tla changes [options] [revision] [-- limit...]
- report about local changes in a project tree
- tla file-diff [options] file [revision]
- show local changes to a file
- tla file-find [options] file [revision]
- find given version of file
- tla pristines [options] [limit]
- list pristine trees in a project tree
- tla lock-pristine [options] revision
- lock (or unlock) a pristine tree
- tla add-pristine [options] revision
- ensure that a project tree has a particular pristine
revision
- tla find-pristine [options] revision
- find and print the path to a pristine revision
Revision Library Commands¶
- tla my-revision-library [options] [dir]
- print or change your revision library path
- tla library-config [options] library-dir
- configure parameters of a revision library
- tla library-find [options] revision
- find and print the location of a revision in the revision
library
- tla library-add [options] revision
- add a revision to the revision library
- tla library-remove [options] revision
- remove a revision from the revision library
- tla library-archives [options]
- list the archives in your revision library
- tla library-categories [options] [archive]
- list the categories in your revision library
- tla library-branches [options] [category]
- list the branches in a library category
- tla library-versions [options] [branch]
- list the versions in a library branch
- tla library-revisions [options] [version]
- list the revisions in a library version
- tla library-log [options] revision
- output a log message from the revision library
- tla library-file [options] file revision
- find a file in a revision library
Published Revisions Commands¶
- tla grab [options] location
- grab a published revision
Miscellaneous Scripting Support¶
- tla parse-package-name [options] name
- parse a package name
- tla valid-package-name [options] name
- test a package name for validity
- tla escape [--unescaped] string
- print strings in escaped or unescaped form
HELP¶
tla help¶
provide help with arch Usage: tla help [options]-h, --help Display a help message and exit.
-H Display a verbose help message and exit.
-b, --basic Display basic commands only
-V, --version Display a release identifier string
and exit.
tla $cmd -h
tla $cmd -H
USER COMMANDS¶
tla my-id¶
print or change your id Usage: tla my-id [options] [id]-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
-u, --uid print only the UID portion of the ID
Jane Hacker <jane.hacker@gnu.org>
tla my-default-archive¶
print or change your default archive Usage: tla my-default-archive [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´
-e, --errname specify program name for errors
-d, --delete unspecify your default archive
-s, --silent suppress reassuring messages
tla register-archive¶
change an archive location registration Usage: tla register-archive [options] [archive] location-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.
-f, --force overwrite existing location
--present-ok return 0 even if archive exists
-d, --delete delete archive registration
tla whereis-archive¶
print an archive location registration Usage: tla whereis-archive [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.
tla archives¶
report registered archives and their locations Usage: tla archives [options] [search regular expression]-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.
-n, --names print archive names only
-R, --exclude-remote Exclude MIRROR and SOURCE archives.
PROJECT TREE COMMANDS¶
tla init-tree¶
initialize a new project tree Usage: tla init-tree [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
--nested initialize a nested project tree.
tla tree-root¶
find and print the root of a project tree Usage: tla tree-root [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.
--accurate error for mid-txn trees
-s, --silent exit status only
1) The project tree was the subject of a commit that
was killed before the log entry was added to the
tree´s patch log. It is unknown whether or not
the commit took place in the archive. The {arch}
directory contains the log file as "++mid-commit".
2) The project tree was the subject of a killed commit, but
it is certain the commit took place. The log file
is stored as "++commit-definite".
3) The project tree patch log is fully up-to-date (as far as
arch knows).
tla tree-version¶
print the default version for a project tree Usage: tla tree-version [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.
tla tree-id¶
Print the tree identifier for a project tree Usage: tla tree-id [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.
tla tree-revision¶
Print the tree identifier for a project tree Usage: tla tree-revision [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.
tla set-tree-version¶
set the default version for a project tree Usage: tla set-tree-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
tla undo¶
undo and save changes in a project tree Usage: tla undo [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
-o, --output PATCH-DIR save changeset in PATCH-DIR
-n, --no-output do not save the changeset
-N, --forward pass the --forward option to `patch´
-q, --quiet no progress reports while computing changeset
--unescaped show filenames in unescaped form
tla redo¶
redo changes in project tree Usage: tla redo [options] [changeset]-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.
-N, --forward pass the --forward option to `patch´
-k, --keep do not delete the patch
-q, --quiet no progress reports while computing changeset
-d, --dir DIR Operate on project tree in DIR (default `.´)
--unescaped show filenames in unescaped form
tla changes¶
report about local changes in a project tree Usage: tla changes [options] [revision] [-- 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´.
-d, --dir DIR Change to DIR first.
-o, --output DIR Save changeset in DIR (implies --keep).
-v, --verbose Verbose changeset report.
-q, --quiet Suppress progress information
--diffs Include diffs in the output.
-k, --keep Don´t remove the output directory on termination.
--link hardlink unchanged files to revision library
--unescaped show filenames in unescaped form
tla file-diff¶
show local changes to a file Usage: tla file-diff [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´
-N, --new-file Treat missing file as empty
tla diff¶
report about local changes in a project tree Usage: tla diff [options] [revision] [-- files...]-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 Change to DIR first.
-o, --output DIR Save changeset in DIR.
-v, --verbose Verbose changeset report.
-q, --quiet Suppress progress information
-s, --summary Do not include diffs in the output.
-k, --keep Don´t remove the output directory on termination.
-L, --latest compare against the latest revision (HEAD) in branch
--link hardlink unchanged files to revision library
--unescaped show filenames in unescaped form
--limit LIMITS limit the diff to LIMITS
-D, --diff-options specify options for `diff´ (for display only)
tla export¶
export all or some of a tree revision Usage: tla export [options] [revision] dir-d, --dir DIR Change to DIR first.
-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.
-s, --silent no output
PROJECT TREE INVENTORY COMMANDS¶
tla inventory¶
inventory a source tree Usage: tla inventory [options] [--] [dir]*-h, --help display help
-H Display a verbose help message and exit.
-V, --version display version info
-s, --source list source files
-p, --precious list precious files
-b, --backups list backup files
-j, --junk list junk files
-u, --unrecognized list unrecognized files
-t, --trees list roots of nested trees
-d, --directories list only directories
-f, --files list only non-directories
-B, --both list both dirs and files
--kind indicate file kinds
--all include arch control files
--nested include nested trees
--ids list with ids (source files only)
--untagged include files that are missing ids
--explicit use explicit file ids
--implicit permit implicit file ids
--tagline permit tagline file ids
--names use name-based file ids
--unescaped show filenames in unescaped form
tla tree-lint¶
(alias for lint) Usage: tla tree-lint [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.
-s, --broken-symlinks Just list broken symlinks
-u, --unrecognized-files Just list files violating naming conventions
-t, --untagged-files Just list files lacking inventory ids
-m, --missing-files Just list inventory ids lacking corresponding files
-d, --duplicate-ids Just list duplicated ids
--strict exit with non-0 status on _any_ oddity
--unescaped show filenames in unescaped form
tla lint¶
audit a source tree Usage: tla lint [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.
-s, --broken-symlinks Just list broken symlinks
-u, --unrecognized-files Just list files violating naming conventions
-t, --untagged-files Just list files lacking inventory ids
-m, --missing-files Just list inventory ids lacking corresponding files
-d, --duplicate-ids Just list duplicated ids
--strict exit with non-0 status on _any_ oddity
--unescaped show filenames in unescaped form
tla id¶
report the inventory id for a file Usage: tla id [options] file ...-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.
--implicit Use the implicit id tagging method.
--tagline Use the tagline id tagging method (default).
--explicit Use the explicit id tagging method.
--names Use the names id tagging method.
--silent No output -- exit status only.
--unescaped show filenames in unescaped form
tla id-tagging-method¶
print or change a project tree id tagging method Usage: tla id-tagging-method [options] [method]-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
--strict exit with error if method not set
names -- use naming conventions only
implicit -- use naming conventions but permit
for inventory tags
explicit -- require explicit designation of source
tagline -- mix names, explicit and arch-tag: methods
tla add¶
(alias for add-id) Usage: tla add [options] file ...-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.
-i, --id ID Specify ID, instead of using auto-generated id.
tla add-id¶
add an explicit inventory id Usage: tla add-id [options] file ...-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.
-i, --id ID Specify ID, instead of using auto-generated id.
tla delete-id¶
remove an explicit inventory id Usage: tla delete-id [options] file ...-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.
tla move-id¶
move an explicit inventory id Usage: tla move-id [options] from to-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.
tla touch¶
add an explicit inventory id, touching the file. Usage: tla touch [options] file ...-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.
-i, --id ID Specify ID, instead of using auto-generated id.
tla rm¶
remove a file (or dir, or symlink) and its explicit inventory tag Usage: tla rm [options] file...-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.
tla mv¶
move a file (or dir, or symlink) and its explicit inventory tag Usage: tla mv [options] from to OR from1 from2 ... 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.
tla explicit-default¶
print or modify default ids Usage: tla explicit-default [options] [TAG-PREFIX]-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
-d, --delete remove the default
-s, --strong use the strong default (default)
-w, --weak use the weak default
--dont-care use the dont-care default
ID-PREFIX__BASENAME
tla default-id¶
(alias for explicit-default) Usage: tla default-id [options] [TAG-PREFIX]-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
-d, --delete remove the default
-s, --strong use the strong default (default)
-w, --weak use the weak default
--dont-care use the dont-care default
ID-PREFIX__BASENAME
tla id-tagging-defaults¶
print the default =tagging-method contents Usage: tla id-tagging-defaults [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.
PATCH SET COMMANDS¶
tla changeset¶
compute a whole-tree changeset Usage: tla changeset [options] ORIG MOD DEST [files]-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.
--file-list FILES record only diffs of selected files
--unescaped show filenames in unescaped form
tla mkpatch¶
(alias for changeset) Usage: tla mkpatch [options] ORIG MOD DEST [files]-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.
--file-list FILES record only diffs of selected files
--unescaped show filenames in unescaped form
tla apply-changeset¶
apply a whole-tree changeset Usage: tla apply-changeset [options] CHANGESET [TARGET]-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.
-N, --forward pass the --forward option to `patch´
-r, --reverse Apply the changeset in reverse
--unescaped show filenames in unescaped form
tla dopatch¶
(alias for apply-changeset) Usage: tla dopatch [options] CHANGESET [TARGET]-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.
-N, --forward pass the --forward option to `patch´
-r, --reverse Apply the changeset in reverse
--unescaped show filenames in unescaped form
tla show-changeset¶
generate a report from a changeset Usage: tla show-changeset [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.
--diffs include diff output
--unescaped show filenames in unescaped form
ARCHIVE TRANSACTION COMMANDS¶
tla make-archive¶
create a new archive directory Usage: tla make-archive [options] [name] location-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.
-m, --mirror MASTER create mirror of specified archive
-M, --mirror-from MASTER-SOURCE create pull-based mirror of specified archive
-l, --listing Keep .listing files up-to-date in this archive.
-t, --tla Create a tla format archive.
-b, --baz Create a baz format archive (the default).
-s, --signed GPG sign the contents of this archive.
tla make-archive --mirror MASTER LOCATION
tla make-archive --mirror MASTER MASTER-MIRROR LOCATION
tla make-archive --mirror-from MASTER-SOURCE LOCATION
tla make-archive --mirror MASTER-SOURCE MASTER LOCATION
tla archive-setup¶
create new categories, branches and versions Usage: tla archive-setup [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´
-f, --file FILE read the list of desired versions from FILE
-b, --branches make base-0 tags
-c, --cache archive cache when creating base-0 tags
% tla archive-setup proja--devo--1.0 projb
proja--devo--1.0 his@foo.com/proja--devo--1.0
tla make-category¶
create a new archive category Usage: tla make-category [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´
tla make-branch¶
create a new archive branch Usage: tla make-branch [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´
tla make-version¶
create a new archive version Usage: tla make-version [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´
tla import¶
archive a full-source base-0 revision Usage: tla import [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 Change to DIR first.
-l, --log FILE Commit with log file FILE.
-s, --summary TEXT log with summary TEXT plus log-for-merge output
-L, --log-message TEXT log with TEXT
-S, --setup Use `archive-setup´ if necessary; implied by default.
--no-setup Do not use `archive-setup´ even if necessary.
--unescaped show filenames in unescaped form
tla commit¶
archive a changeset-based revision Usage: tla commit [options] [[archive]/version] [-- file ...]-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
-l, --log FILE commit with log file FILE
-s, --summary TEXT log with summary TEXT plus log-for-merge output
-L, --log-message TEXT log with TEXT plus log-for-merge output
--strict strict tree-lint
--seal create a version-0 revision
--fix create a versionfix revision
--out-of-date-ok commit even if out of date
--file-list FILE commit only changes to files listed in FILE
--write-revision REVISION_FILE_SPEC write the new tree id to REVISION_FILE_SPEC before committing
--unescaped show filenames in unescaped form
tla get¶
construct a project tree for a revision Usage: tla get [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´
--cache DIR cache root for trees with pristines
--no-pristine don´t save a pristine copy
--link hardlink files to revision library instead of copying
--library ensure the revision is in a revision library
--sparse add library entries sparsely (--link, --library)
--non-sparse add library entries densely (--link, --library)
-s, --silent no output
--no-greedy-add do not allow greedy libraries to add revisions
--unescaped show filenames in unescaped form
tla get-changeset¶
retrieve a changeset from an archive Usage: tla get-changeset [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´
tla lock-revision¶
lock (or unlock) an archive revision Usage: tla lock-revision [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´
-u, --unlock release a lock owned by you
-b, --break break any existing lock
tla archive-mirror¶
update an archive mirror Usage: tla archive-mirror [options] [from [to] [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.
--no-cached don´t copy cached revisions
-s, --summary print the summary of each patch
--cached-tags copy only cachedrevs for tags to other archives
ARCHIVE COMMANDS¶
tla 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)
-C, --cacherevs show cached revisions
-f, --full print full patch level names
--desc implies -s -c -D -k -C
--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
tla rbrowse¶
print an outline describing an archive´s contents Usage: tla rbrowse [options] [[ARCHIVE_NAME/]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
tla 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´
tla 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´
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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´
tla 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´
tla 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´
% tla archive-meta-info name
tla 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´
./$ARCH.added
./$ARCH/
./$ARCH/$CAT.added
./$ARCH/$CAT/
./$ARCH/$CAT/$BRANCH/$VERSION/$REVISION.added
tla 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´
tla archive-fixup¶
fix ancillary 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´
PATCH LOG COMMANDS¶
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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
tla 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
%s %s INTO-RVN FROM-RVN
tla 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
MULTI-PROJECT CONFIGURATION COMMANDS¶
tla build-config¶
instantiate a multi-project config Usage: tla build-config [options] config-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
--no-pristines don´t create pristine copies
--link hardlink files to revision library instead of copying
--library ensure revisions are in the revision library
--sparse add library entries sparsely (--link, --library)
-r, --release-id overwrite ./=RELEASE-ID for this config
tla cat-config¶
output information about a multi-project config Usage: tla cat-config [options] config-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
-o, --output CFG write the output as config CFG
-f, --force overwrite an exiting config (with --output)
-s, --snap Show current patch levels of subtree packages.
--unescaped show filenames in unescaped form
./src/arch lord@emf.net--2003b/arch--devo--1.0
./src/arch lord@emf.net--2003b/arch--devo--1.0--patch-21
COMMANDS FOR BRANCHING AND MERGING¶
tla tag¶
create a continuation revision Usage: tla tag [options] SOURCE-REVISION TAG-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´
-l, --log FILE commit with log file FILE
--no-cacherev Do not cacherev tag even if different archive
--seal create a version-0 revision
--fix create a versionfix revision
-S, --setup Use `archive-setup´ if necessary; implied by default.
--no-setup Do not use `archive-setup´ even if necessary.
tla branch¶
create a continuation revision Usage: tla branch [options] [SOURCE] 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´
-l, --log FILE commit with log file FILE
--no-cacherev Do not cacherev tag even if different archive
--seal create a version-0 revision
--fix create a versionfix revision
tla switch¶
change the working trees version Usage: tla switch [options] [package]-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 Change to DIR first.
-q, --quiet Suppress progress information
tla update¶
update a project tree Usage: tla update [options] [version/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 Update project tree in DIR (default `.´)
-N, --forward pass the --forward option to `patch´
--dest DEST Instead of modifying the project tree in-place,
make a copy of it to DEST and apply the result to that
--unescaped show filenames in unescaped form
tla replay¶
apply revision changesets to a project tree Usage: tla replay [options] [version/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´
--list FILE read a list of patches to apply
--new replay only new patches
--reverse reverse the named patch
-N, --forward pass the --forward option to `patch´
-d, --dir DIR Operate on project tree in DIR (default `.´)
--dest DEST Instead of modifying the project tree in-place,
make a copy of it to DEST and apply the result to that
--skip-present skip patches that contain 1 or more patch logs already in this tree
--unescaped show filenames in unescaped form
,,replay.conflicts-in -- the name of the patch that caused conflicts
,,replay.remaining -- the list of patches not yet applied
tla star-merge¶
merge mutually merged branches Usage: tla star-merge [options] [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 tree archive
-c, --changes OUTPUT Generate but don´t apply the changeset.
-r, --reference VERSION Set reference version (default: project tree version)
-N, --forward pass the --forward option to `patch´
-t, --three-way Perform a 3-way (diff3-style) merge.
-d, --dir DIR Operate on project tree in DIR (default `.´)
--unescaped show filenames in unescaped form
delta (ANCESTOR, FROM)
tla apply-delta¶
compute a changeset between any two trees or revisions and apply it to a project tree Usage: tla apply-delta [options] FROM(REVISION|DIR) TO(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´
-N, --forward pass the --forward option to `patch´
--cache DIR specify a cache root for pristine copies
-d, --dir DIR Operate on project tree in DIR (default `.´)
--dest DEST Instead of modifying the project tree in-place,
make a copy of it to DEST and apply the result to that
--unescaped show filenames in unescaped form
0 No conflict during patch
1 Conflicts occurred during patch
3 Internal Error
tla missing¶
print patches missing from a project tree Usage: tla missing [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´
-q, --quiet produce no ordinary output
-x, --exit-status exit non-0 if patches are missing
-d, --dir DIR cd to DIR first
-r, --reverse sort from newest to oldest
-s, --summary display a summary of each missing patch
-c, --creator display the creator of each missing patch
-D, --date display the date of each missing patch
-f, --full print full revision names
--merges print a merge list for each missing patch
--skip-present skip patches that contain 1 or more patch logs already in this tree
PATCH-A PATCH-A
PATCH-A PATCH-B
PATCH-A PATCH-C
tla join-branch¶
add a version as an ancestor of a project tree Usage: tla join-branch [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 Operate on project tree in DIR (default `.´)
--dest DEST Instead of modifying the project tree in-place,
make a copy of it to DEST and apply the result to that
--unescaped show filenames in unescaped form
tla sync-tree¶
unify a project tree´s patch-log with a given revision Usage: tla sync-tree [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 Operate on project tree in DIR (default `.´)
--dest DEST Instead of modifying the project tree in-place,
make a copy of it to DEST and apply the result to that
--unescaped show filenames in unescaped form
tla delta¶
compute a changeset (or diff) between any two trees or revisions Usage: tla delta [options] (REVISION|TREE)-A (REVISION|TREE)-B [DESTDIR]-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 specify a cache root for pristine copies
-n, --no-changeset do not generate a changeset
--diffs print changeset report with diffs (implies -n)
--unescaped show filenames in unescaped form
tla delta tla--devo--1.1--patch-6 tla--devo--1.1--patch-8 ,,changes
Will pull patch-6 and patch-8 from tla--devo--1.1 and compute
a changeset, which will be saved in a newly created ,,changes
directory. If you would like a report instead,
append the --diffs option
LOCAL CACHE COMMANDS¶
tla changes¶
report about local changes in a project tree Usage: tla changes [options] [revision] [-- 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´.
-d, --dir DIR Change to DIR first.
-o, --output DIR Save changeset in DIR (implies --keep).
-v, --verbose Verbose changeset report.
-q, --quiet Suppress progress information
--diffs Include diffs in the output.
-k, --keep Don´t remove the output directory on termination.
--link hardlink unchanged files to revision library
--unescaped show filenames in unescaped form
tla file-diff¶
show local changes to a file Usage: tla file-diff [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´
-N, --new-file Treat missing file as empty
tla file-find¶
find given version of file Usage: tla file-find [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´
-N, --new-file Print missing file as `/dev/null´
--unescaped show filenames in unescaped form
tla pristines¶
list pristine trees in a project tree Usage: tla pristines [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.
-d, --dir DIR cd to DIR first
-u, --unlocked return only unlocked pristines
-l, --locked return only locked pristines
-r, --reverse reverse sort order
tla lock-pristine¶
lock (or unlock) a pristine tree Usage: tla lock-pristine [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
-u, --unlock unlock, rather than lock
tla add-pristine¶
ensure that a project tree has a particular pristine revision Usage: tla add-pristine [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
tla find-pristine¶
find and print the path to a pristine revision Usage: tla find-pristine [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
-u, --unlocked return only an unlocked pristine
-l, --locked return only a locked pristine
-t, --tree-only search this tree only, not siblings
-s, --silent exit status only
REVISION LIBRARY COMMANDS¶
tla 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)
tla 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
--non-sparse make the library not sparse
tla 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
tla 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
--unescaped show filenames in unescaped form
tla 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´
tla 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.
tla 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´
tla 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´
tla 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
tla 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
tla 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
tla 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
PUBLISHED REVISIONS COMMANDS¶
tla grab¶
grab a published revision Usage: tla grab [options] location-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.
MISCELLANEOUS SCRIPTING SUPPORT¶
tla parse-package-name¶
parse a package name Usage: tla parse-package-name [options] 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´
-a, --arch print the archive name
--non-arch print the non-archive part of the name
-c, --category print the category name
-b, --branch print the branch name
-p, --package print the package name
-v, --vsn print the version id
--package-version print the category--branch--version
-l, --lvl print the patch level
--patch-level synonym for --lvl
tla valid-package-name¶
test a package name for validity Usage: tla valid-package-name [options] 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.
-e, --errname specify program name for errors
--archive require and explicit archive
--no-archive prohibit and explicit archive
-c, --category require a category
-p, --package require category, permit branch
-v, --vsn require a version number
-l, --patch-level require a patch level
--lvl synonym for --patch-level
-t, --tolerant tolerate more specific names
tla escape¶
print strings in escaped or unescaped form Usage: tla escape [--unescaped] string-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.
--unescaped show filenames in unescaped form
ENVIRONMENT¶
- EDITOR
- If $EDITOR is set, use its value as the path of the text editor arch is to run when asking the user for text input. If unset, log messages must be given on the command line using the `-L´ parameter or in the file created by `tla make-log´.
- HOME
- User´s home directory, where arch looks for
.arch-cache/ and .arch-params/ .
- http_proxy HTTP_PROXY
- If $http_proxy or $HTTP_PROXY is set, arch used its value as the URL of the proxy to use for WebDAV accesses. $http_proxy has higher priority than $HTTP_PROXY. If unset, no proxy is used.
- TMPDIR
- If $TMPDIR is set, arch creates temporary files in the given directory. Otherwise, it uses `/tmp´.
FILES¶
- ${HOME}/.arch-cache/
- Directory where arch caches archive data
- ${HOME}/.arch-params/
- Directory where all the user´s settings are stored.
- ${HOME}/.arch-params/hook
- Hook script called after every execution of tla.
- ${HOME}/.arch-params/signing/
- Directory where the commands for signing and checking signatures are stored.
SEE ALSO¶
http://gnuarch.org/, http://wiki.gnuarch.org/2006-06-23 | 1.3.4 |