How to work with bazaar through the GUI on Windows

From OpenPetra Wiki
Jump to navigation Jump to search

Alternative: use Bazaar from the command line

If the GUI is not your prefered way of doing things, please see How to work with bazaar on the command line

Download Bazaar for Windows

You find the downloads for Bazaar for Windows here: http://wiki.bazaar.canonical.com/WindowsDownloads

We currently recommend to use the Standalone 2.2 Stable Release. This includes the core Bazaar distribution and several GUIs for Bazaar.

We have noticed that the german translation is not complete at all, and on German Windows systems the GUI is quite mixed up with several languages. Solution: delete all but the en locale directory from C:\Program Files\Bazaar\locale.

See also Visual Tour of Bazaar Explorer on Windows.

Setup your environment

Start Bazaar Explorer from the Start menu.

First screen of Bazaar Explorer

Go to Settings|Configuration|User Configuration to set your user name and email address:

User Configuration of Bazaar Explorer

If you prefer to use WinMerge for showing the diff of files, you can configure it in the same window as well:

Configure WinMerge

Now you should configure a directory where you will store all your branches. Go to "Start a new project", and click on "Initialize". Make sure to select the options "Shared repository" and "Branches in the repository will default to not having a working tree".

I have chosen the directory <My Documents>/openpetra/bzr/

Initialize Project Directory

You might be asked, if you want to create a new "hat". Just say yes. An explanation can be found here: http://wiki.bazaar.canonical.com/BzrExplorer#hats

Get the files

You can now download the trunk into your own directory, by clicking on the "Branch" button near the bottom of the window:

Checkout trunk

As a developer with ssh permissions for the repository, use this source URL:

bzr+ssh://bazaar@bzr.openpetra.org:2208/openpetra/trunk

For anonymous access, use

http://bzr.openpetra.org:8008/openpetra/trunk

The destination for the checked out trunk would be in my case:

<My Documents>/openpetra/bzr/trunk

Create a working branch

<My Documents>/openpetra/bzr/dev_0000166_my_feature