tbp-initarchive(1)

tbp-initarchive1

Initialize an archive and tree for tla-buildpackage

Usage

tbp-initarchive [options] archive_name archive_location working_location

Overview

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 [email protected].

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.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 3 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0

--help since Debian 5.0 (Lenny); --init-tree-args since Debian 5.0 (Lenny); --make-archive-args since Debian 5.0 (Lenny); --version since Debian 5.0 (Lenny); -h since Debian 5.0 (Lenny); -v since Debian 5.0 (Lenny).

Author

tla-buildpackage, its modules, documentation, executables, and all included files, except where noted, was written by John Goerzen <[email protected]> and Hubert Chathi <[email protected]>, 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 [email protected] \
  http://vcs.uhoreg.ca/arch/[email protected]
$ tla get \
  [email protected]/tla-buildpackage--mainline--1.0 \
  tla-buildpackage

From tla-buildpackage 0.9.14 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.