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

Show feedback again
Latest News
Gna! closing soon posted by beuc, Tue Jan 31 22:31:06 2017 - 4 replies
mail subsystem upgraded posted by beuc, Sat May 23 18:17:18 2015 - 1 reply
dl/home/cvs/svn/ upgraded to debian8 posted by beuc, Thu May 21 22:12:23 2015 - 2 replies SSL certificate renewed posted by zerodeux, Thu Apr 24 07:13:06 2014 - 4 replies
Heartbleed status and measures posted by beuc, Wed Apr 9 09:47:29 2014 - 2 replies
[125 news in archive]

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

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

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 is your local archive, where
'project' is your project name.

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

tla make-archive --listing --mirror \

Then, synchronize your public archive:

tla archive-mirror

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:


if [ "$1" == "commit" ]; then
tla archive-mirror ;

(Please note that your public mirror is locally know as

  • 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 \

  • Accessing a tla project archive

Firstly, register the tla archive with:

tla register-archive \

Then, retrieve the archive revision into a local directory:

tla get local-directory

For more details about GNU arch, please consider reading the documentation
available at
A community wiki is also worth browsing at

This article comes from the FAQ entry:


Message: 117
RE: Viewarch? (posted by yeupou, Sat Mar 13 18:29:55 2004)

Yes, someday. We have nothing against, we just have to study how we could add it cleanly.

Thread Author Date
Viewarch?nicooFri Mar 12 23:01:55 2004
      RE: Viewarch?yeupouSat Mar 13 18:29:55 2004


Post a followup to this message

You could post if you were logged in
Show feedback again

Back to the top

Powered by Savane 3.1-cleanup