Article: Using the GNU Arch version control system for your project

Item posted by Jérôme Marant <jerome> on Sat 06 Mar 2004 06:35:46 PM UTC.

How do I use GNU Arch for my project?

(We assume that you already used your download area, that everything worked
well. If it is not the case, please read the related FAQ entries first)

There is currently more than one way to work with GNU arch: the decentralized
way and the centralized way.

• Setting up a public archive mirror (decentralized way)

The most common way of using arch is the decentralized way: the developer
works with his local archive and publishes it on a regular basis.

Let's assume my@address.org--2004-project is your local archive, where
'project' is your project name.

Firstly, setup your public archive at gna.org with the following command
('archive-2004' is the symbolic name for your public archive location)

tla make-archive --listing --mirror my@address.org--2004-project \
sftp://arch.gna.org/upload/project/archive-2004

Then, synchronize your public archive:

tla archive-mirror my@address.org--2004-project

Usually, it is more practical to synchronize your public archive whenever
commits are done into the local archive. This can be achieved by the means
of a commit hook. A hook is a small shell script that is run by tla when
commands are run. It is located at ~/.arch-params/hook.

Here is an example:

#!/bin/sh

if [ "$1" == "commit" ]; then
tla archive-mirror my@address.org--2004-project ;
fi

(Please note that your public mirror is locally know as
local-archive-name-MIRROR)

• Setting up a centralized public archive

If you want several developers to commit direclty into the same public
archive, you may be interested in making the public archive the main one,
so every authorized commiter can access it at any time.

This can be done that way:

tla make-archive --listing my@address.org--2004-project \
sftp://arch.gna.org/upload/project/archive-2004

• Accessing a tla project archive

Firstly, register the tla archive with:

tla register-archive my@address.org--2004-project \
http://arch.gna.org/project/archive-2004

Then, retrieve the archive revision into a local directory:

tla get my@address.org--2004-project/revision local-directory

For more details about GNU arch, please consider reading the documentation
available at http://www.gnu.org/software/gnu-arch.
A community wiki is also worth browsing at http://gnuarch.org.

This article comes from the FAQ entry:
https://gna.org/faq/?question=Arch_Server_--How_do_I_setup_a_tla_archive.txt