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

[Fernando Perez]

On Tue, Jun 3, 2008 at 11:01 AM, Ville M. Vainio <vivainio at gmail.com> wrote:
> 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"

Great, could you please update this in the wiki page we have ?

http://ipython.scipy.org/moin/Developer_Zone/Developer_Guidelines

It's important that this is in a permanent location besides the list
archives so newcomers find it right away.

Cheers,


f

> --------
>
> 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'
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://lists.ipython.scipy.org/mailman/listinfo/ipython-dev
>