[IPython-dev] Quick launchpad guide for would-be contributors

[Ville M. Vainio]

Here is a short guide to launchpad I wrote for Leo editor. It's
applicable to ipython as well, when you substitute "ipython" for
"leo-editor"

--------

Many users will want to track the development version of Leo, in order to stay
on top of the latest features and bugfixes. Running the development version is
quite safe and easy, and it's also a requirement if you want to contribute to
Leo.

1. First, you need to get Bazaar (bzr) from http://bazaar-vcs.org. For windows
 users we recommend the standalone installer - the python installer may have
 problems pushing to Launchpad. Plain bzr installer only contains the command
 line version, so you might want to augment that with a friendly GUI - qbzr is
 recommended as it's the easiest one to install. It provides command like
 ``bzr qlog``, ``bzr qannotate`` etc.

2. Get Leo from launchpad by doing::

   bzr branch lp:leo-editor

And that's it! You can run leo/src/leo.py directly. When you want to refresh the
code with latest modifications from Launchpad, run ``bzr pull``.

If you make modifications to Leo (with the interest in sharing them with the Leo
community), you can check them in to your local branch by doing ``bzr checkin``.
Now, to actually request your changes to be merged to Leo trunk, you need a
Launchpad account with RSA keys in place. There is showmedo video about how to
accomplish this on Windows using puttygen and pageant at
``http://showmedo.com/videos/video?name=1510070&fromSeriesID=151``.

After your Launchpad account is set up, go to
``https://launchpad.net/leo-editor``, choose Code tab -> Register Branch, select
Branch type "Hosted" and fill in descriptive details about the branch. After
that, go to the branch home page from Code tab again, and copy-paste the push
command line to terminal. For example, for branch::

  https://code.launchpad.net/~leo-editor-team/leo-editor/mod_rclick

The push command is::

  bzr push bzr+ssh://my_name@bazaar.launchpad.net/~leo-editor-team/leo-editor/mod_rclick

You may wish to add --remember command line option to bzr push, to direct all
future pushes to that location. Then, you only need to execute ``bzr push``.

After your branch is pushed, you can email the Leo mailing list and request it
to be reviewed and merged to trunk.

-- 
Ville M. Vainio - vivainio.googlepages.com
blog=360.yahoo.com/villevainio - g[mail | talk]='vivainio'