951
Comment:
|
1804
converted to 1.6 markup
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
Launchpad allows you to host a branch of any project that has a presence on Launchpad. | You can host a Bazaar branch for any project that is registered in Launchpad. |
Line 3: | Line 3: |
To do this, you must have registered a SSH key from your person’s page, http://launchpad.net/people/+me. | '''Before you start:''' you must have registered an SSH key in your Launchpad account. To register a key, visit http://launchpad.net/people/+me/+editsshkeys |
Line 5: | Line 5: |
Then, just use the {{{bzr push}}} command to create the branch. | == Pushing your branch == |
Line 7: | Line 7: |
The push location must be of the form: | To create your branch, use {{{bzr push}}}. The push location should be of the form: |
Line 9: | Line 11: |
{{{sftp://}}}''login''{{{@bazaar.launchpad.net/~}}}''registrant''{{{/}}}''project''{{{/}}}''branch'' | {{{bzr+ssh://}}}''login''{{{@bazaar.launchpad.net/~}}}''registrant''{{{/}}}''project''{{{/}}}''branch'' |
Line 11: | Line 13: |
* ''login'' is your Launchpad person name: the last part of the URL of your person's page. Launchpad uses it to check the SSH key you are authenticating with. | === Push location explained === |
Line 13: | Line 15: |
* ''registrant'' is your Launchpad person name, or the name of a team you belong to. Use a team name to create a branch to which other people can upload. | * ''login'' is your Launchpad account name (or Launchpad ID): the last part of the URL of your Launchpad profile page. Launchpad uses it to check the SSH key you are authenticating with. * ''registrant'' is your Launchpad person name, or the name of a team you belong to. Use a team name to create a branch to which other members of that team can upload. |
Line 17: | Line 21: |
* ''name'' must be unique for a given registrant and project. | * ''branch'' must be unique for a given registrant and project, and should describe the sort of change being done in that branch. For instance, "rework-decorator-API", or "fix-bug-42123", or "improve-timeout-warning". == If you don't have a project to push that branch to == If you are working on an actual open source project, you should register the project first: https://launchpad.net/projects/+new-guided -- but if it's just an experiment, or throwaway code, you can host it using Launchpad's NonProjectBranches. == Learn more == Using Bazaar with Launchpad is explained in more detail on FeatureHighlights/EasyBranching. Setting up and using team branches to allow multiple people to commit to a single branch is explained on FeatureHighlights/TeamBranches. |
You can host a Bazaar branch for any project that is registered in Launchpad.
Before you start: you must have registered an SSH key in your Launchpad account. To register a key, visit http://launchpad.net/people/+me/+editsshkeys
Pushing your branch
To create your branch, use bzr push.
The push location should be of the form:
bzr+ssh://login@bazaar.launchpad.net/~registrant/project/branch
Push location explained
login is your Launchpad account name (or Launchpad ID): the last part of the URL of your Launchpad profile page. Launchpad uses it to check the SSH key you are authenticating with.
registrant is your Launchpad person name, or the name of a team you belong to. Use a team name to create a branch to which other members of that team can upload.
project is the name of the Launchpad project to register this branch on. The uploaded branch will appear in the listings for this project.
branch must be unique for a given registrant and project, and should describe the sort of change being done in that branch. For instance, "rework-decorator-API", or "fix-bug-42123", or "improve-timeout-warning".
If you don't have a project to push that branch to
If you are working on an actual open source project, you should register the project first: https://launchpad.net/projects/+new-guided -- but if it's just an experiment, or throwaway code, you can host it using Launchpad's NonProjectBranches.
Learn more
Using Bazaar with Launchpad is explained in more detail on FeatureHighlights/EasyBranching.
Setting up and using team branches to allow multiple people to commit to a single branch is explained on FeatureHighlights/TeamBranches.