• View
• Edit
• History
• Print

GnuArch

Solfege is available from two public arch repositories, http://www.solfege.org/arch/solfege-2006 and http://mirrors.sourcecontrol.net/tca@gnu.org-solfege-2006. You can use the baz or tla tools to access the repository. The tools are quite compatible, so if I only give an example with one of the tools, then you can use exactly the same options for both tools.

There is some documentation that you might find interesting at http://www.dpkg.org/ArchRepository.

You need some extra packages installed to compile the code right from the arch repository. This list might not be complete, so please add to it, and ask on the mailing list if you need help.

• libglib-2.0-dev (need the file gobject-2.0.pc)
• Swig

Before you start

To get reasonable performance, you should create a revision library. This is a directory storing copies of all versions you download using tla, to avoid fetching things over the net more than necessary.

First, lets check if you already have a revision library. If so, then you can skip this section.

 $ tla my-revision-library
 my-revision-library: no revision library path set

You can use any directory you want, but it should be writable by you:

 $ mkdir ~/revision-library
 $ tla my-revision-library ~/revision-library

Then check again, and see that it has been created:

 $ tla my-revision-library ~/revision-library
 $ tla my-revision-library
 /home/yourname/revision-library

Lets see how the revision library is configured:

 $ tla library-config ~/revision-library/
 * library /home/tom/revision-library/
 greedy? no
 sparse? no

I think this is a reasonable default:

 $ tla library-config --greedy --sparse ~/revision-library/
 * library /home/tom/revision-library/
 greedy? yes
 sparse? yes

Getting the source

Solfege is mirrored to two public archives. To get access to the archive you first have to register one of the archives:

 tla register-archive http://www.solfege.org/arch/solfege-2006

or

 tla register-archive http://mirrors.sourcecontrol.net/tca@gnu.org--solfege-2006

The archive on www.solfege.org get new updates a little faster than mirrors.sourcecontrol, but the latter is faster to download from.

Then, to check out the source code of the 3.1 development branch using arch:

 tla get tca@gnu.org--solfege-2006/solfege--unstable--3.1

This can take very long time if you use tla, approx 10 minutes for www.solfege.org, 3 minutes for mirrors.sourcecontrol.net. It will look like tla has crashed. But It has not. If you monitor your network traffic, you will see that tla is downloading stuff. baz is faster, it will take 1-2 minutes. Remember that it will take only a few seconds next time, because of the revision library.

And for the stable 3.0 branch:

 tla get tca@gnu.org--solfege-2006/solfege--stable--3.0

Hacking

After hacking the code, you can see what files have changed by running:

 tla changes

or

 baz status

To see the actual changes:

 tla changes --diffs

or

 baz diff

To create a changeset you can send by email:

 tla changes -o DIRNAME

or

 baz diff -o DIRNAME

Then tar and zip DIRNAME .

You can browse the archives at http://sourcecontrol.net: solfege-2004 and solfege-2005 and solfege-2006.

You don't have to use baz or tla to contribute code to Solfege. If you just add a small bugfix or write a few new lesson files, the easiest will probably be to send me a patch or the new files. But I (TomCato) think GNU Arch is a very nice piece of software, so I encourage you to have a look at it.

Creating a local branch

Todo. baz: http://freedesktop.org/Software/debrix(approve sites)