Introducing yourself to bzr

Introducing yourself to bzr
You would like your name and email in the revision log.

Run:

$ bzr whoami "Joe Doe "
Now try:

$ bzr whoami
Joe Doe

Creating your personal branch
You work on your personal branch. After you create it, you don't need web access to commit changes. Create a branch of an existing project:


$ bzr branch http://example.com/code/foobar.dev foobar.joe
Branched 1 revision(s).

Hacking

$ cd foobar.joe
$ hack...
What have you done:


$ bzr diff
=== modified file 'foo.c'
--- foo.c
+++ foo.c
@@ -30,6 +30,7 @@

#include "foo.h"

+
static PyObject *
_pyfribidi_log2vis (PyObject * self, PyObject * args, PyObject * kw)
{
Time to commit your hard work:


$ bzr commit -m 'added some whitespace'
Committed revision 2.

Viewing the Revision Log

$ bzr log
------------------------------------------------------------
revno: 2
committer: Joe Doe
branch nick: foobar.joe
timestamp: Mon 2006-02-06 01:33:35 +0200
message:
added some whitespace
------------------------------------------------------------
revno: 1
committer: James Hacker
branch nick: foobar.dev
timestamp: Mon 2006-02-06 01:06:11 +0200
message:
initial revision

Updating Your Branch from the Main Branch
While you work hard on your branch, others may have committed new code to the main branch. You would like to merge changes from the main branch into your branch from time to time:


$ bzr merge
Using saved location: http://example.com/code/foobar.dev
All changes applied successfully.
What was changed in the main branch?

$ bzr diff
=== modified file 'pyfribidi.c'
--- pyfribidi.c
+++ pyfribidi.c
@@ -236,6 +236,7 @@
PyMem_Del (logical);
PyMem_Del (visual);

+ /* evil hack! */
return result;
}
Commit the changes from the main branch:

$ bzr commit -m 'merge from main branch'
Committed revision 6.

Publishing Your Branch
You can simply use rsync to copy your branch to a web server, but using bzr push is the easiest way. Note that to use sftp, your need to install paramiko and pyCrypto. See the InstallationFaq page in the wiki.

Let's assume you want to publish your branch in jod.example.com/foobar.joe:

$ bzr push sftp://jod@jod.example.com/public_html/foobar.joe/
2 revision(s) pushed.
Now anyone can get your branch with (try it yourself!):

bzr get http://jod.example.com/foobar.joe/

Learning More
To learn about bzr commands::

$ bzr help commands
To learn about the foo command::

$ bzr help foo