NAME
tbp-initarchive - Initialize an archive and tree for tla-buildpackage
SYNOPSIS
tbp-initarchive [ options ] archive_name archive_location
working_location
DESCRIPTION
tbp-initarchive is designed to set up both the tla archive and the
working area for a tla-buildpackage setup. It automatically handles
all the tasks relating to running tla and tla-buildpackage
tbp-initarchive will create the tla archive archive_name in
archive_location, and check it out into working_location, having
initialized that working area for tla-buildpackage. If ~/.tla-
buildpackage does not exist, it will be created and the working
location will be written into it.
ARGUMENTS
archive_name
Gives the tla name of the archive to create. tla must not know
anything about it prior to running this command. An example
would be foo@example.com--debian.
archive_location
Gives the directory where tla will create its history files. It
must not exist prior to running this command.
working_location
Gives the directory where you will work with tla-buildpackage on
a daily basis.
OPTIONS
--make-archive-args=ARGUMENTS
pass ARGUMENTS to tla make-archive. e.g. --signed, to GPG sign
the archive contents
--init-tree-args=ARGUMENTS
pass ARGUMENTS to tla init-tree. e.g. --nested, if the working
directory is in a directory that is already controlled by tla.
-h, --help
display the help message and exit.
-v, --version
display version info and exit.
FILES
The following specific files are used by this application:
~/.tla-buildpackage
Specifies the default working copy location for all build
procedures. This file, and the directory it specifies, are both
normally created by tbp-initarchive.
ENVIRONMENT
The following environment variables are used by this application:
TBP_WC Specifies the working copy area for tla-buildpackage to use for
all build-related tasks, overriding the value in ~/.tla-
buildpackage, if any.
COPYRIGHT
tla-buildpackage, all associated scripts and programs, this manual, and
all build scripts are Copyright (C) 2003 John Goerzen, 2008 Hubert
Chathi.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
AUTHOR
tla-buildpackage, its modules, documentation, executables, and all
included files, except where noted, was written by John Goerzen
<jgoerzen@complete.org> and Hubert Chathi <hubert@uhoreg.ca>, and
copyright is held as stated in the COPYRIGHT section.
tla-buildpackage may be downloaded from the Debian packaging system or
at
<URL:http://packages.debian.org/tla-buildpackage>.
tla-buildpackage may also be downloaded using tla like this:
$ tla register-archive hubert@uhoreg.ca--public \
http://vcs.uhoreg.ca/arch/hubert@uhoreg.ca--public
$ tla get \
hubert@uhoreg.ca--public/tla-buildpackage--mainline--1.0 \
tla-buildpackage
SEE ALSO
Detailed usage information, including a background and a description of
how the tools fit together, can be found in the tla-buildpackage
Manual. On Debian systems, you may find this at /usr/share/doc/tla-
buildpackage.
tla-buildpackage applications have references in that manual and the
following manpages: tbp-initarchive(1), tbp-importdsc(1), tbp-
importorig(1), tbp-markdeb(1), tla-buildpackage(1).
Other related references include: tla(1).
27 March 2010