Diff for "Code/FindingAndDownloading"

Not logged in - Log In / Register

Differences between revisions 7 and 20 (spanning 13 versions)
Revision 7 as of 2008-09-05 10:36:08
Size: 5620
Editor: 92-237-59-186
Comment:
Revision 20 as of 2009-06-23 09:56:39
Size: 0
Editor: 202
Comment: delay in project
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
'''DRAFT: this page is a work in progress. Please [[Feedback|seek further help]] or check the [[TitleIndex|wiki index]] for a complete page on this topic.'''

||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||

= Overview =

Launchpad and Bazaar give you access to thousands of branches of code. With just a few keystrokes, you can download the code from any of the projects that has code registered in Launchpad.

So, what does it mean to have code registered in Launchpad? Well, it can be one of four things:

 * code in a Bazaar branch that's hosted directly by Launchpad
 * a Bazaar branch that's hosted elsewhere and mirrored by Launchpad
 * a Bazaar branch that's hosted elsewhere and monitored by Launchpad
 * a Subversion or CVS repository that's imported into a Bazaar branch hosted by Launchpad.

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:code-stats.png}}||
||<style="text-align: center;">'''Launchpad Code stats'''||
 
If all you want is to get hold of that code, you don't need to worry about its exact relationship with Launchpad because Launchpad sorts all that out for you.

= Getting code =

[[https://launchpad.net/do|GnomeDo]] is an application launcher for Gnome desktops. You can create your own branch of GnomeDo's ''trunk'' [[Projects/SeriesMilestonesReleases#Series|line of development]] with just a few keystrokes and without even having to visit Launchpad's web interface.

Once you've [[http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html#installation|got Bazaar on your system]], open a terminal and type the following:

{{{
$ bzr branch lp:do
}}}

Bazaar will now download the latest version of GnomeDo's trunk branch to your machine.

{{{
$ bzr branch lp:do
You have not informed bzr of your launchpad login. If you are attempting a
write operation and it fails, run "bzr launchpad-login YOUR_ID" and try again.
Branched 524 revision(s).
}}}

'''Note:''' Don't worry about the login notice, as you're not yet uploading anything to Launchpad.

Now you have your own local branch of the GnomeDo trunk, complete with full version control. You can commit any changes you like to that branch and, when you're ready, upload your version back to Launchpad to sit alongside the trunk and any other GnomeDo branches.

You can use this hassle-free way of obtaining branches for any project that has code registered in Launchpad. All you need is the Launchpad name of the project, which you can find by looking at the final portion of the URL to the project's Launchpad overview page. For example: in GnomeDo's case that's ```https://launchpad.net/do```

== Other branches associated with a project ==

If you want to download something other than a project's main line of development, you need to visit the project's code overview page.

Let's visit [[[[https://code.launchpad.net/do|GnomeDo]]|GnomeDo's code overview page]. Here you can see a list of all the GnomeDo-related branches that Launchpad knows about.

||<tablestyle="float:right; font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:do-series-branches.png}}||
||<style="text-align: center;">'''Branches associated with GnomeDo series'''||

Launchpad lists the branches in order of likely importance. So, the branch that the GnomeDo team have marked as their current development focus comes first - and is what you get when you use ```bzr branch lp:do```. At the time of writing, the following two branches are also associated with GnomeDo series; in this case ''0.6'' and ''devel''. The address you need to give Bazaar is also shown for both of these branches: for example, ```bzr branch lp:do/0.6``` and ```bzr branch lp:do/devel```.

=== Non-official branches ===

Launchpad and Bazaar's flexibility mean that anyone can upload their branch of code and associate it with any project in Launchpad. This is great news because you can get near instant access to all development effort for that project.

Click on any of the branches in GnomeDo's list and you'll see exactly what you need to type in order to download it and create your own local branch, using Bazaar.

||<tablestyle="float:right; font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:ian-mc.png}}||
||<style="text-align: center;">'''An experimental branch of GnomeDo'''||

== Code hosted elsewhere ==

So far, we've looked at branches of code that are hosted directly on Launchpad. Hosting on Launchpad is a quick and free way to publish your branch. However, as we saw in the introduction, you can use Launchpad to get hold of code that's hosted elsewhere too.

[[https://launchpad.net/bitlbee|Bitlbee]] is a gateway between various IM networks and IRC. The bitlbee trunk branch is hosted by Bitlebee themselves and mirrored by Launchpad. That makes no difference to actually getting hold of that branch. Simply type:

{{{
$ bzr branch lp:bitlbee
}}}

Similarly, you can get hold of the latest code from the [[https://launchpad.net/banshee|Banshee]] music player's Subversion repository as a Bazaar branch with:

{{{
$ bzr branch lp:banshee
}}}

Wherever code originates, simply visit its overview page in Launchpad to find the Bazaar command to download it to your own machine and create a local branch.

= Next step =

Once you've created your own branch, you can upload it to Launchpad.

Code/FindingAndDownloading (last edited 2009-06-26 05:52:07 by c-98-229-120-106)