Bzr checkout

From Stellarium Wiki
Jump to: navigation, search

Bazaar (BZR) is a distributed source code control system system. It lets us keep track of changes to the Stellarium code base, merge changes from different developers and revert back to old version of files if necessary.

If you want to see what the current development version of Stellarium is like, you can get the "work in progress" version of the source code from the Stellarium Bazaar repository at Launchpad. Source code can be accessed by anyone. Because Bazaar is a distributed revision control system, anyone can maintain their own branch of the code, although only developers can commit into the official branch on the Launchpad servers.

For more detailed information about Bazaar see the Bazaar website.

Important Note: The development version of Stellarium is a work in progress. It may be that at the time you download it, the sourcecode does not function as expected, and might not even compile. Please don't flood the forums and bug report areas with build problems for the development version of Stellarium. If there is a build problem, your best bet is to try to figure out the problem yourself from the error messages your compiler spits out. Non-developers will have a tough time with this, so their best bet might be to wait a week or two and check out the code again.

What you need

To get the development code, you will need to download Bazaar. Once you've installed Bazaar, have a look at the documentation to understand better how to use it.

If you are using Windows and TortoiseSVN tick the Windows Shell Extensions (TortoiseBZR) box during Install it will make down loading updates easier.

Checking out Stellarium sourcecode

Command Line Bazaar client

It’s easy-peasy:

  1. Open a terminal / console / whatever for your OS, and change directory to where you want the code to go.
  2. Execute the following command:
bzr co lp:stellarium

This operation takes a while for the first time 600MB+ download

To Update if you have the Windows TortoiseSVN Shell extension installed. Change to your installed folder, click

Files - TortoiseBZR - update. The default will be the working tree then press OK 

This will download the changes.

From the command line, you would go to the source code directory (which contains the .bzr folder) and write:

bzr update

That’s it — you should now have a new directory, stellarium which contains the source code. If you’re a newbie, see the INSTALL file in that directory, or consult Compilation on Linux , Windows Build Instructions or Compilation on Mac OS X to find out how to build the code.

If you want to implement a new feature which requires more than a few lines of change, it is best to develop this in a separate branch.

  1. Open a terminal / console / whatever for your OS, and change directory to where you want the code to go.
  2. Execute the following command:
bzr branch lp:stellarium _myNewFeature_

This creates a directory _myNewFeature_ with your private copy of trunk. You can then edit at will, and you can push your branch to launchpad where others can see it. See instructions for that command (and other branches) at When your branch does reliably what it should do, you can propose a merge. This means, your code will go under revision by the core team members, and when (1) it is useful and (2) all comments/requests for change are fulfilled, it may be merged.

In case you hit some dead end, please be so kind to set dead branches to "abandoned" state, so they are no longer listed.

Personal tools
in this wiki
other languages