Hi,
Anand Kumria <[EMAIL PROTECTED]> - Mon, Jul 14, 2003:
> Just a short bug to note that there is no manpage for tla.
Dan Weber <[EMAIL PROTECTED]> - Mon, May 10, 2004:
> attached is a newer version of the manpage I sent you. This one fixed
> a few new line errors I made.
I worked on another version in parallel! I'm really sad for the
duplication of work... Attached is my version.
I suggest the maintainer takes the job of merging our man pages. ;)
Bye,
--
Loïc Minier <[EMAIL PROTECTED]>
.\" This is the man page for tla (part of GNU arch).
.\" Most of this is borrowed from the "arch Meets hello-world" tutorial
.\" which is Copyright (C) 2001, 2002, 2003 Thomas Lord
.TH tla 1
.SH "NAME"
tla \- arch command line client tool
.SH "SYNOPSIS"
.TP
\fBtla\fP [-h|-H|--help|-V|--version] [\fIcommand\fP [\fIcommand_options\fP]]
.SH "OVERVIEW"
\fBarch\fP is a version control system, which allows you to keep old
versions of files and directories (usually source code), keep a log of
who, when, and why changes occurred, etc., like SVN, CVS, or RCS.
\fBarch\fP has a number of advantages compared to competing systems. Among
these are:
.SS "Works on Whole Trees"
.SP
\fBarch\fP keeps track of whole trees -- not just individual files. For
example, if you change many files in a tree, \fBarch\fP can record all of
those changes as a group rather than file-by-file; if you rename files or
reorganize a tree, \fBarch\fP can record those tree arrangements along with
your changes to file contents.
.SS "Changeset Oriented"
.SP
\fBarch\fP doesn't simply "snapshot" your project trees. Instead, \fBarch\fP
associates each revision with a particular changeset: a description of exactly
what has changed. \fBarch\fP 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.
.SS "Fully Distributed"
.SP
\fBarch\fP 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. \fBarch\fP seamlessly operates across archive boundaries.
.SH "OPTIONS"
.SP
Calling \fBarch\fP with any of the \fB-h\fP, \fB-H\fP, or \fB--help\fP flags
will print a short help text on the usage of the \fBtla\fP command-line client.
Calling \fBarch\fP with the \fB-V\fP, or \fB--version\fP flags
will print the version of the \fBtla\fP command-line client.
.SH "COMMANDS"
.SP
\fBarch\fP is largely a self documenting program, the \fBhelp\fP command will
display a categorized list of all available commands:
% tla help
To get more help for a command, try:
% tla command -h
Or:
% tla command -H
Here's a list of all available commands:
.SS "Help"
\fBhelp\fP : provide help with arch
.SS "User Commands"
\fBmy-id\fP : print or change your id
\fBmy-default-archive\fP : print or change your default archive
\fBregister-archive\fP : change an archive location registration
\fBwhereis-archive\fP : print an archive location registration
\fBarchives\fP : report registered archives and their locations
.SS "Project Tree Commands"
\fBinit-tree\fP : initialize a new project tree
\fBtree-root\fP : find and print the root of a project tree
\fBtree-version\fP : print the default version for a project tree
\fBset-tree-version\fP : set the default version for a project tree
\fBundo\fP : undo and save changes in a project tree
\fBredo\fP : redo changes in project tree
\fBchanges\fP : report about local changes in a project tree
\fBfile-diff\fP : show local changes to a file
.SS "Project Tree Inventory Commands"
\fBinventory\fP : inventory a source tree
\fBtree-lint\fP : audit a source tree
\fBid\fP : report the inventory id for a file
\fBid-tagging-method\fP : print or change a project tree id tagging method
\fBadd-id\fP : add an explicit inventory id
\fBadd\fP : (alias for add-id)
\fBdelete-id\fP : remove an explicit inventory id
\fBdelete\fP : (alias for delete-id)
\fBrm\fP : remove a file (or dir, or symlink) and its explicit inventory tag
(if any)
\fBmove-id\fP : move an explicit inventory id
\fBmove\fP : (alias for move-id)
\fBmv\fP : move a file (or dir, or symlink) and its explicit inventory tag (if
any)
\fBexplicit-default\fP : print or modify default ids
\fBdefault-id\fP : (alias for explicit-default)
\fBid-tagging-defaults\fP : print the default =tagging-method contents
.SS "Patch Set Commands"
\fBchangeset\fP : compute a whole-tree changeset
\fBmkpatch\fP : (alias for changeset)
\fBapply-changeset\fP : apply a whole-tree changeset
\fBdopatch\fP : (alias for apply-changeset)
\fBshow-changeset\fP : generate a report from a changeset
.SS "Archive Transaction Commands"
\fBmake-archive\fP : create a new archive directory
\fBarchive-setup\fP : create new categories, branches and versions
\fBmake-category\fP : create a new archive category
\fBmake-branch\fP : create a new archive branch
\fBmake-version\fP : create a new archive version
\fBimport\fP : archive a full-source base-0 revision
\fBcommit\fP : archive a changeset-based revision
\fBget\fP : construct a project tree for a revision
\fBget-changeset\fP : retrieve a changeset from an archive
\fBlock-revision\fP : lock (or unlock) an archive revision
\fBarchive-mirror\fP : update an archive mirror
.SS "Archive Commands"
\fBabrowse\fP : print an outline describing archive contents
\fBrbrowse\fP : print an outline describing an archive's contents
\fBcategories\fP : list the categories in an archive
\fBbranches\fP : list the branches in an archive category
\fBversions\fP : list the versions in an archive branch
\fBrevisions\fP : list the revisions in an archive version
\fBancestry\fP : display the ancestory of a revision
\fBancestry-graph\fP : display the ancestory of a revision
\fBcat-archive-log\fP : print the contents of an archived log entry
\fBcacherev\fP : cache a full source tree in an archive
\fBcachedrevs\fP : list cached revisions in an archive
\fBuncacherev\fP : remove a cached full source tree from an archive
\fBarchive-meta-info\fP : report meta-info from an archive
\fBarchive-snapshot\fP : update an archive snapshot
\fBarchive-version\fP : list the archive-version in an archive
\fBarchive-fixup\fP : fix ancillary files (e.g. .listing files) in an archive
.SS "Patch Log Commands"
\fBmake-log\fP : initialize a new log file entry
\fBlog-versions\fP : list patch log versions in a project tree
\fBadd-log-version\fP : add a patch log version to a project tree
\fBremove-log-version\fP : remove a version's patch log from a project tree
\fBlogs\fP : list patch logs for a version in a project tree
\fBcat-log\fP : print the contents of a project tree log entry
\fBchangelog\fP : generate a ChangeLog from a patch log
\fBlog-for-merge\fP : generate a log entry body for a merge
\fBmerges\fP : report where two branches have been merged
\fBnew-merges\fP : list tree patches new to a version
.SS "Multi-project Configuration Commands"
\fBbuild-config\fP : instantiate a multi-project config
\fBcat-config\fP : output information about a multi-project config
.SS "Commands for Branching and Merging"
\fBtag\fP : create a continuation revision (aka tag or branch)
\fBupdate\fP : update a project tree to reflect recent archived changes
\fBreplay\fP : apply revision changesets to a project tree
\fBstar-merge\fP : merge mutually merged branches
\fBapply-delta\fP : compute a changeset between any two trees or revisions and
apply it to a project tree
\fBmissing\fP : print patches missing from a project tree
\fBjoin-branch\fP : add a version as an ancestor of a project tree
\fBsync-tree\fP : unify a project tree's patch-log with a given revision
\fBdelta\fP : compute a changeset (or diff) between any two trees or revisions
.SS "Local Cache Commands"
\fBchanges\fP : report about local changes in a project tree
\fBfile-diff\fP : show local changes to a file
\fBfile-find\fP : find given version of file
\fBpristines\fP : list pristine trees in a project tree
\fBlock-pristine\fP : lock (or unlock) a pristine tree
\fBadd-pristine\fP : ensure that a project tree has a particular pristine
revision
\fBfind-pristine\fP : find and print the path to a pristine revision
.SS "Revision Library Commands"
\fBmy-revision-library\fP : print or change your revision library path
\fBlibrary-config\fP : configure parameters of a revision library
\fBlibrary-find\fP : find and print the location of a revision in the revision
library
\fBlibrary-add\fP : add a revision to the revision library
\fBlibrary-remove\fP : remove a revision from the revision library
\fBlibrary-archives\fP : list the archives in your revision library
\fBlibrary-categories\fP : list the categories in your revision library
\fBlibrary-branches\fP : list the branches in a library category
\fBlibrary-versions\fP : list the versions in a library branch
\fBlibrary-revisions\fP : list the revisions in a library version
\fBlibrary-log\fP : output a log message from the revision library
\fBlibrary-file\fP : find a file in a revision library
.SS "Published Revisions Commands"
\fBgrab\fP : grab a published revision
.SS "Miscellaneous Scripting Support"
\fBparse-package-name\fP : parse a package name
\fBvalid-package-name\fP : test a package name for validity
\fBescape\fP : print strings in escaped or unescaped form
