Using GNU Arch

GNU Arch (tla) is the revision control system currently used on AweMUD.net. The archive name is elanthis@awemud.net--2004, and is located at http:www.awemud.net/arch/elanthis@awemud.net--2004.

The GNU Arch website has plenty of documentation, including a tutorial, for users new to Arch. The Arch Primer is also a good resource.

If you have never used Arch before, you must first set your user ID. This is done using the tla my-id command. You give it your name and email address, like so:

tla my-id "John Doe <jdoe@foo.bar>"

Of course, substitute in your real name and email address.

Second, you must tell Arch about the AweMUD.net archive. This is done using the tla register-archive command. To register the elanthis@awemud.net--2004 archive, you'd use this command:

tla register-archive elanthis@awemud.net--2004 http:www.awemud.net/arch/elanthis@awemud.net--2004

Not hard at all. For convenience sake, you can also set the AweMUD.net archive as your default. This can save typing later on. Doing this step is completely optional. You can change your default archive at any time. To set the AweMUD.net archive to be your default, use:

tla my-default-archive elanthis@awemud.net--2004

Of course, the part you're really interested in is getting a copy of AweMUD itself. This is quite easy, using the tla get command. You must specify a project and a branch. Examples of project names are awemud, scriptix, and pycl. The development branches of projects are called mainline, which is what you're probably interested in if you're using Arch to grab any projects from the site.

The following command will fetch the awemud project and put it in the directory called awemud. You can ignore the -A elanthis@awemud.net--2004 flag if you set your default archive as described above.

Notice how we specified the project and branch: awemud--mainline. If you wanted to get the scriptix project, you would used scriptix--mainline. The last argument is the directory you wish the project to be placed it. You may choose any directory name you desire.

Once you have a copy of a project, you may also use the tla update command to fetch any changes made to the archive since you originally downloaded it. Simply enter the directory you put the project in (using tla get), and use the command:

For more information on how to use Arch, please see the <a href="http:wiki.gnuarch.org">GNU Arch web site</a>.