File: arch.txt
lnx-bbc--stable--2.1--patch-38 lnx-bbc--research--0.0--patch-33
Line 15Line 15
start reading this tutorial. We hope to keep it strictly relevant to the
lnx-bbc project.

start reading this tutorial. We hope to keep it strictly relevant to the
lnx-bbc project.

To start with, here's the nickel tour for using arch the same way you used to
use CVS:

=== Setup ===

----8<----
$ tla my-id "My Name <my-email@my-hostname.tld>"
$ gpg --gen-key
$ mkdir ~/.arch-params/signing/
$ echo 'gpg --default-key "<haesslich@lnx-bbc.org>" --clearsign' > ~/.arch-params/signing/\=default
$ echo '/usr/bin/tla-gpg-check gpg_command="gpg --keyserver subkeys.pgp.net --keyserver-options auto-key-retrieve --verify-files -"' > ~/.arch-params/signing/\=default.check
----8<----

=== Checkout ===

----8<----
$ tla register-archive sftp://haesslich@arch.lnx-bbc.org/var/www/arch/
$ tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--stable
$ tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--research
----8<----

=== Update ===

----8<----
$ tla update
----8<----

=== Checkin ===

----8<----
$ tla commit
----8<----

That should get you on your feet. To reap the benefits of the distributed
workflow that arch allows, read on for the $7 tour.


= Arch for core LNX-BBC developers =

This section assumes that you have a gargoyle account and are in the src
= Arch for core LNX-BBC developers =

This section assumes that you have a gargoyle account and are in the src
Line 124Line 88
----8<----
$ mkdir ~/.arch-params/signing/
$ echo 'gpg --default-key "<haesslich@lnx-bbc.org>" --clearsign' > ~/.arch-params/signing/\=default
----8<----
$ mkdir ~/.arch-params/signing/
$ echo 'gpg --default-key "<haesslich@lnx-bbc.org>" --clearsign' > ~/.arch-params/signing/\=default
$ echo '/usr/bin/tla-gpg-check gpg_command="gpg --keyserver subkeys.pgp.net --keyserver-options auto-key-retrieve --verify-files -"' > ~/.arch-params/signing/\=default.check
$ echo '/usr/bin/tla-gpg-check gpg_command="gpg --keyserver pgp.dtype.org --keyserver-options auto-key-retrieve --verify-files -"' > ~/.arch-params/signing/\=default.check
----8<----

=== Send your key to a public keyserver ===
----8<----

=== Send your key to a public keyserver ===
Line 134Line 98
server:

----8<----
server:

----8<----
$ gpg --keyserver subkeys.pgp.net --send-keys haesslich@lnx-bbc.org
$ gpg --keyserver pgp.dtype.org --send-keys haesslich@lnx-bbc.org
----8<----

== Check out a branch ==
----8<----

== Check out a branch ==
Line 456Line 420
== Downloading from the read-only archives ==

----8<----
== Downloading from the read-only archives ==

----8<----

$ tla my-id "Nobody Special <nobody@movealong.org>"
$ tla register-archive http://www.lnx-bbc.org/arch
$ tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--stable--2.1
----8<----
$ tla register-archive http://www.lnx-bbc.org/arch
$ tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--stable--2.1
----8<----
Line 477Line 442
history. This is far more powerful than receiving a changeset in e-mail, as we
get to play with your archive.

history. This is far more powerful than receiving a changeset in e-mail, as we
get to play with your archive.

== Archive Syndication ==

We now have <http://lnx-bbc.org/planet/ Planet LNX-BBC> to keep track of
development in various distributed branches. If you wish to have your
archive's lnx-bbc branches appear on the planet page, the easiest way is for
you to generate the rss out of cron.

First: get <http://arch.lnx-bbc.org/~nick/tla-rss tla-rss.sh> from the scripts
category.

----8<----
$ tla register-archive http://www.lnx-bbc.org/arch
$ tla get scripts--gargoyle-bin
----8<----

(You can use your sftp archive for this as well)

Then set up a cron job to run tla-rss.sh regularly with an appropriate archive
and archzoom URL. If you do not wish to install archzoom on your system,
lnx-bbc.org can be made to perform its functions (albeit inefficiently).

----8<----
*/10 * * * * $HOME/bin/tla-rss.sh -n 25 -u http://psax.org/~dave/archzoom/archzoom.cgi dave@psax.org--projects/lnx-bbc > $HOME/public_html/rss/lnx-bbc.rss

----8<----

This will make an RSS file every ten minutes with the 25 most recent commmits
from each lnx-bbc-- branch in Dave Barry's archive (provided you have
registered dave@psax.org--projects). You can specify full version IDs to
tla-rss.sh (to specify one branch in isolation), but to date you cannot give it
category--branch without also specifying a version.

Finally, come up with a code hobo (A.K.A. <http://www.gnome.org/~jdub/heads/
hackergotchi> head) to appear by your commits. <http://georgebox.org/ George
Moffitt> describes the process for turning a cropped head image into a
hackergotchi using the GIMP:

> I make four copies of the head,
> layered atop one another.
> At that point it looks like one head.
> Then I blur the second layer down by about 5,
> the next layer beneath that by about 10,
> and the bottom one by about 15;
> so you get a nice blur around the edge,
> but the regular face image is on top.

Make sure the image is a PNG that fades to a transparent background (with alpha
channels and all) and that you scale it to 100x100. Also, if you would like
your archive to have a special background image beneath the code hobo
(such as we do for the official research and stable branches), please make sure
that is scaled to 100x100 (though it can be in any format you like).


== Locations of common developer archive mirrors ==

== Locations of common developer archive mirrors ==

Nick Moffitt:                        <http://zork.net/~nick/arch/>
"Yosemite" Sam Phillips:        <http://dasbistro.com/~sam/archives/gar/>
Nate "inkblot" Riffe:                <http://www.movealong.org/~inkblot/arch/projects-2004>
Dave "Psykoyiko" Barry:                <http://psax.org/~dave/arch>
Nick Moffitt:        <http://zork.net/~nick/arch/>
Yosemite Sam:        <http://arch.lnx-bbc.org/~sam/arch/>