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


"Create a new milestone" and enter a version number


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


Fill out the form for the release and confirm


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:


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...


and get the addition of the series confirmed, after clicking


Now you can add your TAR archive for download




and the archive should get available for download.


Additional links

Some helpful links are

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