%include "default.mgp"
%page

%center
GNU Arch FIXIT






The GNU Arch Revision Control System - LCA 2004 FIXIT

Where I learn what is hard for you, and we address it...





%size 3
Copyright (c) 2004, Robert Collins <robertc@squid-cache.org>. Redistribution permitted under the GNU GPL Version 2.
%page

%center
Revision Control Recap

%left
Revisions.
	A specific copy of a file or project. A revision has predecessors and successors, which gives an ordering: given two revisions for a file, one is logically 'before' the other.

Projects AKA modules AKA categories.
	A group of files collected together, usually tightly bound to the same concept or issue.
	I.E. 'My system config'. 'Squid'. 'm4'.
%page

%center
Revision Control Recap (cont)

%left
Branches aka forks.
	A set of Revisions all related by the nature of the changes involved.
		by version: linux 2.2 / linux 2.4 / linux 2.6 
		by goal: mainline / experimental / feature-X

Merging
	Taking the some or all of the changes within a branch and applying them to another branch.
		backporting fix X from linux 2.6 to 2.4.
		applying the changes made in an experimental branch to the mainline.

%page

%center
GNU Arch key features

%left
	GPG Signed changesets.

	Multiuser safe - full isolation on archive transations.

	Distributed operation
		Multiple repositories are supported by the core design.
		Merging and branching across repositories is the expected norm of operation.

	Powerful merging features.

	Multiple repository access protocols
		HTTP with webDAV (vanilla apache for instance).
		HTTP without webDAV.
		SFTP
		FTP
		Unix file access.
%page

%center
GNU Arch key features (cont)

%left
	Local and remote archive access's

	Robust repository format.

	Automated changelog generation.

	Some Configuration managment assistance.

	Integrated mirror facilities.

%page

%center
GNU Arch Resources

%left
	Home page: http://regexps.srparish.net/www/

	GNU Arch project page: http://www.gnu.org/directory/GNU/arch.html

	Mailing lists: http://savannah.gnu.org/mail/?group=gnu-arch

	Tutorial: http://regexps.srparish.net/tutorial-tla/arch.html

	Wiki: http://gnuarch.org/

	List of repositories: http://gnuarch.org/bin/view/Main/ArchiveRegistry

%page

%center
Usage idioms

%left
Arch is flexible... two common styles of usage:

	End user tracking a branch
		tla register-archive <location>
		tla get <branch> <local dir>

	End user doing adhoc patches
		(optional) tla make-archive --mirror-from <location> <local mirror dir>
		tla make-category -A <users-archive> <project-category>
		tla make-branch <users-archive>/<project-category>--<branchforpatches>
		tla make-version <users-archive>/<project-category>--<branchforpatches>--<version>
		tla tag <upstream-branch>  <users-archive>/<project-category>--<branchforpatches>--<version>
		tla get <users-archive>/<project-category>--<branchforpatches>--<version> <local dir>
		<hack>
		tla commit
		<hack>
		...


%page

%center
So, what do YOU want to do with it....

%left
	....
	a text representation for arch changesets - mbp