Projects - Arch Tutorial

This is the start page for my Arch tutorial. Each individual node may be accessed here.

This page was made for the sake of convenience so that I may present a link more meaningful link than http://www.mwolson.org/projects/ when referring to this particular work.

My tutorial attempts to be kind to those who have short attention spans, like myself. The use of Emacs with Arch is covered.

Contents

Part 1 - Getting Started With Arch

How to set up your own projects and make your own custom Arch-managed versions of other projects that use Arch. This also has instructions for checking out projects that use Arch for development.

Part 2 - Developing With Arch

How to get into an easy basic routine for committing patches, with emphasis on using Emacs.

Part 3 - Cooperation and Arch

Working well with others, i.e. merging and requesting to have merges performed.

Part 4 - Arch Resources

Links to other places that have information on Arch and DVC.

Part 5 - Optimizing Arch

Making Arch faster and better.

History

Sun, Aug 12, 2007

• Remove Project Distribution from the rest of the Arch tutorial. I'm starting to phase out my use of Arch, and I'd like to reclaim the page for other purposes.
• Any remaining Arch-specific content has been moved to Getting Started With Arch.

Sat, Oct 28, 2006

Optimizing Arch:

• Fix omission in the example for tla library-add.

Sun, Aug 20, 2006

Optimizing Arch:

• New part of the tutorial which contains information on speeding up Arch.

Thu, Aug 10, 2006

Developing With Arch:

• Do not recommend auto-generated ChangeLog entries anymore, because they are rather inflexible. It is much better to just use `C-x 4 a' to add to a normal ChangeLog file.

Thu, Aug 03, 2006

Cooperation and Arch:

• Add new Merging changes back to a shared Arch archive chapter, which explains how to merge changes from a private Arch branch to a shared Arch archive.

Thu, Jun 01, 2006

Update everything to mention DVC instead of Xtla.

Thu, May 25, 2006

Cooperation and Arch:

• Add note about the difference between tla update and tla replay.

Sun, Oct 16, 2005

Developing With Arch:

• Direct people to the download page for xtla, rather than an Arch repository, since the latter changes a lot.

Wed, Jun 29, 2005

Getting Started With Arch:

• Use tla add-id instead of tla add, since the latter is deprecated in the most recent version of GNU Arch.
• Move Introducing yourself section to the top, since this needs to be done before setting up an archive.

Mon, May 30, 2005

The Contents section on this page was overhauled to make it more compact.

Cooperation and Arch:

• Add Going without a mirror section which explains how to generate those tricky .listing files — you will need them in order for others to be able to use your archive.

Sun, May 29, 2005

Developing With Arch:

• Remove the part of the Where do I put change log entries? section that described my method of trying to encapsulate a GNU-style ChangeLog in Arch's autogenerated log. I am now of the opinion that the xtla default ChangeLog style is much easier to use on a regular basis, and the generated logs look pretty good. No need to make the barrier of entry harder than it needs to be by describing an unnecessarily-complex method.

Sat, Mar 19, 2005

In preparation of publishing the link to this page on a website or two, I tidied up the tutorial.

Getting Started With Arch:

• Replaced incorrect use of "make-archive" with "archive-setup". Tla commands confuse me, too, at times.

Developing With Arch:

• Added an Emacs Lisp function that I made to automate a few steps in my method of formatting ChangeLogs.
• Cleaned up some truly awful grammar use.
• Made a new section called Anatomy of a change log entry that comes before I describe the various methods of composing log entries.

Arch Resources:

• Added several tutorials to the Tutorials section that seem to be worthwhile.

Fri, Mar 18, 2005

This start page first comes into existence.

---

[ Front | Projects | Index | Source ] Last updated Aug. 12, 2007