Bryan's Bazaar Tutorial
Bryan: there are a number of steps you can skip in your little tutorial:
You don't need to set
my-default-archive. If you often work with multiple archives, you can treat working copies for all archives pretty much the same. If you are currently inside a working copy, any branch names you use will be relative to your current one, so you can still use short branch names in almost all cases (this is similar to the reason I don't set
$CVSROOTwhen working with CVS).
If you have a directory which contains only the files you want to import into your Bazaar archive, the following command will add them all, and convert the directory into a Bazaar working copy:
cd background-channels baz import -a email@example.com/background-channels--dev--0.1
No need for
archive-mirrorin your working copy will mirror that archive, so doesn't need
Other people probably don't want to set your archive as their default. Also, they can ommit the
baz get http://gnome.org/~clarkbw/arch/background-channels--dev--0.1
This checks out the branch, and registers the archive as a side effect.
If you want to find out what is inside an archive, the following command is quite convenient:
baz abrowse http://gnome.org/~clarkbw/arch
Some things you might want to do:
If you have a PGP key, create a signed archive. This will cryptographically sign all revisions. When people checkout your branches, the signatures get checked automatically (this is useful if the server hosting your mirror gets broken into and you need to verify that nothing has been tampered with). If you have already created the archive, you can turn on signing with
baz change-archive(remember to update the mirror archive too).
If you turn on signing, consider using a PGP agent like gnome-gpg. You can configure it in
It is customary to name the archive directory the same as the archive name. This has the benefit that the branch name matches the last portion of the URL.
If you haven't set up a revision library, you should do so:
mkdir ~/.arch-revlib baz my-revision-library ~/.arch-revlib baz library-config --greedy --sparse ~/.arch-revlib
Reverse the order of those last two revlib commands: baz my-revision-library ~/.arch-revlib baz library-config --greedy --sparse ~/.arch-revlib