← 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: Ian Clatworthy
  • Date: 2007-11-27 21:17:06 UTC
  • mto: (3054.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 3055.
  • Revision ID: ian.clatworthy@internode.on.net-20071127211706-871zcqst0yi5tcvl
make fixes suggested by proof-readers

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/installing_bazaar.txt
1
1
Installing Bazaar
2
2
=================
3
3
 
4
 
GNU/Linux
5
 
---------
 
4
Linux
 
5
-----
6
6
 
7
 
Bazaar packages are available for most popular GNU/Linux distributions
8
 
including Ubuntu, Debian, Red Hat and Gentoo.
9
 
See http://wiki.bazaar.canonical.com/Download for the latest instructions.
 
7
Bazaar packages are available for most popular Linux distributions
 
8
including Ubuntu/Debian, Red Hat and Gentoo.
 
9
See http://bazaar-vcs.org/Downloads for the latest instructions.
10
10
 
11
11
Windows
12
12
-------
14
14
For Windows users, an installer is available that includes
15
15
the core Bazaar package together with necessary pre-requisites
16
16
and some useful plug-ins.
17
 
See http://wiki.bazaar.canonical.com/Download for the latest instructions.
 
17
See http://bazaar-vcs.org/Downloads for the latest instructions.
18
18
 
19
19
Note: If you are running Cygwin on Windows, a Bazaar for Cygwin package
20
20
is available and ought to be used instead of the Windows version.
24
24
 
25
25
Beyond Linux and Windows, Bazaar packages are available for a large
26
26
range of other operating systems include Mac OS X, FreeBSD and Solaris.
27
 
See http://wiki.bazaar.canonical.com/Download for the latest instructions.
 
27
See http://bazaar-vcs.org/Downloads for the latest instructions.
28
28
 
29
29
 
30
30
Installing from scratch
33
33
If you wish to install Bazaar from scratch rather than using a
34
34
pre-built package, the steps are:
35
35
 
36
 
  1. If it is not installed already, install Python 2.6 or later.
 
36
  1. If it is not installed already, install Python 2.4 or later.
37
37
 
38
38
  2. Download the ``bazaar-xxx.tar.gz`` file (where xxx is the version
39
 
     number) from http://wiki.bazaar.canonical.com/Download or from Launchpad
 
39
     number) from http://bazaar-vcs.org/Downloads or from Launchpad
40
40
     (https://launchpad.net/~bzr/).
41
41
 
42
42
  3. Unpack the archive using tar, WinZip or equivalent.
52
52
get things working.
53
53
 
54
54
 
55
 
Installing into site-wide locations
56
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
57
 
 
58
 
Instead of adding the directory to your PATH, you can install bzr into the
59
 
system locations using::
60
 
 
61
 
  python setup.py install
62
 
 
63
 
If you do not have a compiler, or do not have the python development tools
64
 
installed, bzr supplies a (slower) pure-python implementation of all
65
 
extensions. You can install without compiling extensions with::
66
 
 
67
 
  python setup.py install build_ext --allow-python-fallback
68
 
 
69
 
 
70
 
 
71
55
Running the development version
72
56
-------------------------------
73
57
 
74
 
You may wish to always be using the very latest development version of
75
 
Bazaar. Note that this is not recommended for
 
58
If you wish to always be using the very latest development version of
 
59
Bazaar, it is easy to do so. Note that this is not recommended for
76
60
the majority of users as there is an increased risk of bugs. On the other
77
61
hand, the development version is remarkably solid (thanks to the processes
78
 
we follow) and running it makes it easier for you to send us changes for
79
 
bugs and improvements. It also helps us by having more people testing
80
 
the latest software.
 
62
we follow) and runnig it makes it easier for you to help us make Bazaar
 
63
even better either through increased testing or sending us changes for
 
64
bugs and improvements.
81
65
 
82
66
Here are the steps to follow:
83
67
 
85
69
 
86
70
  2. Get a copy of the development version like this::
87
71
 
88
 
       bzr branch lp:bzr
 
72
       bzr branch http://bazaar-vcs.org/bzr/bzr.dev
89
73
 
90
 
  3. Put the created directory on your PATH.
 
74
  3. Put the created directory (bzr.dev) on your PATH.
91
75
 
92
76
Advanced users may also wish to build the optional C extensions for greater
93
77
speed. This can be done using ``make`` and requires ``pyrex`` and a C compiler.
97
81
Running multiple versions
98
82
-------------------------
99
83
 
100
 
It's easy to have multiple versions of Bazaar installed and to switch
101
 
between them. To do this,
102
 
simply provide the full pathname to the **bzr** command you wish to run.
 
84
One of the neat things about Bazaar is that it's really easy to have
 
85
multiple versions installed and to switch between them. To do this,
 
86
simply provide the full path to the **bzr** command you wish to run.
103
87
The relevant libraries will be automatically detected and used. Of course,
104
 
if you do not provide a pathname, then the **bzr** used will be the one
105
 
found on your system path as normal.
 
88
if you do not provide a path, then the **bzr** used will be the one on
 
89
your path as normal.
106
90
 
107
91
Note that this capability is particularly useful if you wish to run
108
92
(or test) both the latest released version and the development version say.
 
93