---
name: "tbp-initarchive"
section: "1"
platform: "linux"
package: "tla-buildpackage"
version: "0.9.14"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/tbp-initarchive"
---

# tbp-initarchive(1)

Initialize an archive and tree for tla-buildpackage

## 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-initarchive/1.md), [**tbp-importdsc**(1)](/tbp-importdsc/1.md), [**tbp-importorig**(1)](/tbp-importorig/1.md), [**tbp-markdeb**(1)](/tbp-markdeb/1.md), [**tla-buildpackage**(1)](/tla-buildpackage/1.md).

Other related references include: [**tla**(1)](/tla/1.md).