← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/installing_bazaar.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-10-31 03:15:38 UTC
  • mfrom: (3806.1.1 contrib)
  • Revision ID: pqm@pqm.ubuntu.com-20081031031538-0ih0zi2owevf6fwu
Add contrib/bzr_ssh_path_limiter. (Andrew Bennetts)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/installing_bazaar.txt
 
1
Installing Bazaar
 
2
=================
 
3
 
 
4
Linux
 
5
-----
 
6
 
 
7
Bazaar packages are available for most popular Linux distributions
 
8
including Ubuntu/Debian, Red Hat and Gentoo.
 
9
See http://bazaar-vcs.org/Download for the latest instructions.
 
10
 
 
11
Windows
 
12
-------
 
13
 
 
14
For Windows users, an installer is available that includes
 
15
the core Bazaar package together with necessary pre-requisites
 
16
and some useful plug-ins.
 
17
See http://bazaar-vcs.org/Download for the latest instructions.
 
18
 
 
19
Note: If you are running Cygwin on Windows, a Bazaar for Cygwin package
 
20
is available and ought to be used instead of the Windows version.
 
21
 
 
22
Other operating systems
 
23
-----------------------
 
24
 
 
25
Beyond Linux and Windows, Bazaar packages are available for a large
 
26
range of other operating systems include Mac OS X, FreeBSD and Solaris.
 
27
See http://bazaar-vcs.org/Download for the latest instructions.
 
28
 
 
29
 
 
30
Installing from scratch
 
31
-----------------------
 
32
 
 
33
If you wish to install Bazaar from scratch rather than using a
 
34
pre-built package, the steps are:
 
35
 
 
36
  1. If it is not installed already, install Python 2.4 or later.
 
37
 
 
38
  2. Download the ``bazaar-xxx.tar.gz`` file (where xxx is the version
 
39
     number) from http://bazaar-vcs.org/Download or from Launchpad
 
40
     (https://launchpad.net/~bzr/).
 
41
 
 
42
  3. Unpack the archive using tar, WinZip or equivalent.
 
43
 
 
44
  4. Put the created directory on your PATH.
 
45
 
 
46
To test the installation, try running the **bzr** command like this::
 
47
 
 
48
  bzr version
 
49
 
 
50
This will display the version of Bazaar you have installed. If this
 
51
doesn't work, please contact us via email or IRC so we can help you
 
52
get things working.
 
53
 
 
54
 
 
55
Running the development version
 
56
-------------------------------
 
57
 
 
58
You may wish to always be using the very latest development version of
 
59
Bazaar. Note that this is not recommended for
 
60
the majority of users as there is an increased risk of bugs. On the other
 
61
hand, the development version is remarkably solid (thanks to the processes
 
62
we follow) and running it makes it easier for you to send us changes for
 
63
bugs and improvements. It also helps us by having more people testing
 
64
the latest software.
 
65
 
 
66
Here are the steps to follow:
 
67
 
 
68
  1. Install Bazaar using one of the methods given above.
 
69
 
 
70
  2. Get a copy of the development version like this::
 
71
 
 
72
       bzr branch http://bazaar-vcs.org/bzr/bzr.dev
 
73
 
 
74
  3. Put the created directory (bzr.dev) on your PATH.
 
75
 
 
76
Advanced users may also wish to build the optional C extensions for greater
 
77
speed. This can be done using ``make`` and requires ``pyrex`` and a C compiler.
 
78
Please contact us on email or IRC if you need assistance with this.
 
79
 
 
80
 
 
81
Running multiple versions
 
82
-------------------------
 
83
 
 
84
It's easy to have multiple versions of Bazaar installed and to switch
 
85
between them. To do this,
 
86
simply provide the full pathname to the **bzr** command you wish to run.
 
87
The relevant libraries will be automatically detected and used. Of course,
 
88
if you do not provide a pathname, then the **bzr** used will be the one
 
89
found on your system path as normal.
 
90
 
 
91
Note that this capability is particularly useful if you wish to run
 
92
(or test) both the latest released version and the development version say.