| File: README.txt | |
|---|---|
| patch-10 | patch-11 |
| Line 22 | Line 22 |
| "gar" sitting in your current directory. You can rename it if you like. | "gar" sitting in your current directory. You can rename it if you like. |
| === From CVS === | === From arch === |
| The first step is to log into the CVS pserver. | The LNX-BBC project now uses arch as its revision control system. For more detailed information, see our <arch.html arch documentation>. What follows will allow you to download development trees quickly. |
| ----8<---- cvs -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs login ----8<---- Just hit return when it asks you for a password. You can now check out the STABLE or HEAD branches of the tree. ==== LNX-BBC 2.1 ==== Each release is tagged in the exact state used for it. These are typically snapshots of the STABLE branch (see below). For example, to grab the 2.1 release, we use the RELEASE_lnx-bbc_2_1 tag as follows: | The first step is to register our public arch mirror as a valid archive. |
| ----8<---- | ----8<---- |
| cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs co -r RELEASE_lnx-bbc_2_1 gar | tla register-archive lnx-bbc-devel@zork.net--gar http://www.lnx-bbc.org/arch |
| ----8<---- | ----8<---- |
| ==== STABLE ==== | You can now get the stable or research branches of the GAR tree. ==== the stable branch ==== |
| The <versions.html STABLE branch> is designed to compile on the | The <versions.html stable branch> is designed to compile on the |
| current revision of Debian Stable, although it may also work on other similarly composed GNU/Linux systems. However, our build system uses Debian Stable, and our <chroot.html published chroot environments> use | current revision of Debian Stable, although it may also work on other similarly composed GNU/Linux systems. However, our build system uses Debian Stable, and our <chroot.html published chroot environments> use |
| Line 55 | Line 48 |
| changes judiciously. ----8<---- | changes judiciously. ----8<---- |
| cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs co -r STABLE gar | tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--stable gar |
| ----8<---- | ----8<---- |
| ==== HEAD ==== | You should now have a working copy of the stable branch in a directory called "gar". |
| This is the <versions.html unstable branch> of the tree, and contains | ==== the research branch ==== This is the <versions.html research branch> of the tree, and contains |
| up-to-the-minute updates of what our developers have been working on. It typically builds on a Debian testing or unstable distribution, and may break on stable. You may find this to build on your more recent Red Hat distributions if the STABLE branch does not. ----8<---- | up-to-the-minute updates of what our developers have been working on. It typically builds on a Debian testing or unstable distribution, and may break on stable. You may find this to build on your more recent Red Hat distributions if the STABLE branch does not. ----8<---- |
| cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs co gar | tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--research gar |
| ----8<---- | ----8<---- |
| You should now have a working copy of the research branch in a directory called "gar". | |
| == Configuring GAR == You can either set environment variables or edit gar.conf.mk directly. | == Configuring GAR == You can either set environment variables or edit gar.conf.mk directly. |
| File: arch.txt | |
|---|---|
| patch-10 | patch-11 |
| Line 11 | Line 11 |
| * <http://wiki.gnuarch.org/moin.cgi/Learning_20Arch_20commands_20for_20CVS_20users Arch commands for CVS users> * <http://wiki.gnuarch.org/moin.cgi/Glossary the arch glossary> | * <http://wiki.gnuarch.org/moin.cgi/Learning_20Arch_20commands_20for_20CVS_20users Arch commands for CVS users> * <http://wiki.gnuarch.org/moin.cgi/Glossary the arch glossary> |
| So <http://wiki.gnuarch.org/moin.cgi/Getting_20Arch download arch> and start reading this tutorial. We hope to keep it strictly relevant to the lnx-bbc project. | |
| = 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 53 | Line 57 |
| signature! Thus, there are a few steps to take before you begin working with the official branches. | signature! Thus, there are a few steps to take before you begin working with the official branches. |
| Also, you ought to have gnupg 1.2 or better in order to have the keyserver functions we make use of. If you're running debian stable, consider adding the following line to your /etc/apt/sources.list: ----8<---- deb http://www.backports.org/debian stable tla gnupg ----8<---- This is how gargoyle gets its copies of arch and gpg. | |
| === Make a key === We plan to generate a keyring just for the lnx-bbc project, and use that to | === Make a key === We plan to generate a keyring just for the lnx-bbc project, and use that to |
| verify changeset signatures. We recommend using your @lnx-bbc.org address (the username is your username on gargoyle), since it is somewhat of a role account. | verify changeset signatures. You ought to make a fresh new key for the lnx-bbc project. We recommend using your @lnx-bbc.org address (the username is your username on gargoyle), since it is somewhat of a role account. |
| ----8<---- $ gpg --gen-key | ----8<---- $ gpg --gen-key |
| Line 330 | Line 344 |
| == moving files == | == moving files == |
| Arch has the "tla mv" command, which allows you to move a file from one place in a branch to another, retaining its revision history! | Arch has the "tla mv" command, which allows you to move a file from one place in a branch to another, retaining its revision history! == Speeding up remote operations == Arch uses SFTP as the remote protocol, and it's low-level enough that serious lag can be introduced while talking with gargoyle. To speed things up, you can create a local cache of individual files in the archive, otherwise known as a *library*. ----8<---- $ mkdir ~/.arch-library $ tla my-revision-library ~/.arch-library/ $ tla library-config --greedy ~/.arch-library/ $ tla library-add lnx-bbc-devel@zork.net--gar-autobuild/lnx-bbc--research--0.0 $ tla library-add lnx-bbc-devel@zork.net--gar-autobuild/lnx-bbc--stable--2.1 ----8<---- What you will now have is a greedy library that will automatically cache unpacked versions of all the files in those two branches you library-added. |
| == Public mirrors == | == Public mirrors == |
| File: download.txt | |
|---|---|
| patch-10 | patch-11 |
| Line 7 | Line 7 |
| If you're looking for the bleeding edge of LNX-BBC development, consider our <testing.html testing releases> or our | If you're looking for the bleeding edge of LNX-BBC development, consider our <testing.html testing releases> or our |
| <http://www.lnx-bbc.org/builds/ automated cvs builds>. | <http://www.lnx-bbc.org/builds/ automated arch builds>. |
| We use bittorrent in order to make downloads quicker. If you wish to help mirror the BBC images, the best way is to use our | We use bittorrent in order to make downloads quicker. If you wish to help mirror the BBC images, the best way is to use our |
| File: faq.txt | |
|---|---|
| patch-10 | patch-11 |
| Line 213 | Line 213 |
| Issue the following commands. ----8<---- | Issue the following commands. ----8<---- |
| cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs login cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs co gar | tla register-archive lnx-bbc-devel@zork.net--gar http://www.lnx-bbc.org/arch tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--research gar |
| ----8<---- Just hit return when it asks you for a password. | ----8<---- Just hit return when it asks you for a password. |
| Alternately, you can download <http://cvs.lnx-bbc.org/cvs/gar/gar.tar.gz?tarball=1 the latest CVS snapshot>, updated immediately from the latest CVS checkin. For the STABLE branch, issue the following instead: | For the stable branch, issue the following instead: |
| ----8<---- | ----8<---- |
| cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs login cvs -z3 -d:pserver:anonymous@cvs.lnx-bbc.org:/var/cvs co -r STABLE gar | tla register-archive lnx-bbc-devel@zork.net--gar http://www.lnx-bbc.org/arch tla get lnx-bbc-devel@zork.net--gar/lnx-bbc--stable gar |
| ----8<---- | ----8<---- |
| == When I try to get GAR, it hangs on wireless-tools! How do I fix this? == This is because you have a broken version of CVS, such as the one shipped with Red Hat. Try issuing the above commands without the -z3 flag. | |
| == When I try to build GAR, it fails on one package. How do I fix it? == Sadly, the nature of compilation is that it will behave differently on | == When I try to build GAR, it fails on one package. How do I fix it? == Sadly, the nature of compilation is that it will behave differently on |