Please note:The SCons wiki is in read-only mode due to ongoing spam/DoS issues. Also, new account creation is currently disabled. We are looking into alternative wiki hosts.

The following sections try to outline a few workflows for managing external SCons Tools as packages on Launchpad (Bazaar).

Basic branching

If you simply want to use an external Tool, or have a look at the sources, issue the command given in the "Branch/Clone" column of the ToolsIndex. This will give you a local copy to work with. Example:

bzr branch lp:scons-vala vala

Patching or extending and then, finally, contributing your code, needs a little more effort...

Getting a Launchpad login

We assume that you have initially branched an existing tool, modified it and want to publish your changes.

Merging, contributing your patched code

The practice currently regarded best, is to branch the current mainline of a Tool, add your changes, and then propose your branch for a merge via Launchpad. One of the Tool's admins should then merge the user's branch locally, resolve conflicts and finally pushes the result up again.

Setting up a project for a new tool

The single steps are:

"xyz" is the name of your tool.

bzr push lp:~user/scons-xyz/trunk

which pushes it to the automatically created "trunk" series.

How to add a downloadable archive to your new project

Select the "trunk" series in the Project's main page

click_series_in_overview.png

"Create a new milestone" and enter a version number

create_milestone.png

Back in the overview page for the "trunk" series, create a new release

create_release.png

Fill out the form for the release and confirm

enter_data_and_confirm.png

Go back to the tool's page on Launchpad, and do a refresh in your browser. Then click on the "trunk" series link. You should see a page like this:

trunkseries1.png

If this has not been done already, link the uploaded branch to this series. Clicking on "Link the branch to this series", select the "trunk" branch...

trunkseries2.png

and get the addition of the series confirmed, after clicking

trunkseries3.png

Now you can add your TAR archive for download

add_file_for_download.png

...

file_was_uploaded.png

and the archive should get available for download.

release_downloadable.png

Additional links

Some helpful links are

ToolsBazaarWorkflows (last edited 2010-12-12 12:48:05 by DirkBaechle)