/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Robert Collins
  • Date: 2010-05-06 23:41:35 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506234135-yivbzczw1sejxnxc
Lock methods on ``Tree``, ``Branch`` and ``Repository`` are now
expected to return an object which can be used to unlock them. This reduces
duplicate code when using cleanups. The previous 'tokens's returned by
``Branch.lock_write`` and ``Repository.lock_write`` are now attributes
on the result of the lock_write. ``repository.RepositoryWriteLockResult``
and ``branch.BranchWriteLockResult`` document this. (Robert Collins)

``log._get_info_for_log_files`` now takes an add_cleanup callable.
(Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/installing_bazaar.txt
1
 
Installing Breezy
 
1
Installing Bazaar
2
2
=================
3
3
 
4
 
GNU/Linux
5
 
---------
 
4
Linux
 
5
-----
6
6
 
7
 
Breezy packages are available for most popular GNU/Linux distributions
8
 
including Ubuntu, Debian, Red Hat and Gentoo.
9
 
See https://www.breezy-vcs.org/pages/download.html 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/Download for the latest instructions.
10
10
 
11
11
Windows
12
12
-------
13
13
 
14
14
For Windows users, an installer is available that includes
15
 
the core Breezy package together with necessary pre-requisites
 
15
the core Bazaar package together with necessary pre-requisites
16
16
and some useful plug-ins.
17
 
See https://www.breezy-vcs.org/pages/download.html for the latest instructions.
 
17
See http://bazaar-vcs.org/Download for the latest instructions.
18
18
 
19
 
Note: If you are running Cygwin on Windows, a Breezy for Cygwin package
 
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.
21
21
 
22
22
Other operating systems
23
23
-----------------------
24
24
 
25
 
Beyond Linux and Windows, Breezy packages are available for a large
 
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 https://www.breezy-vcs.org/pages/download.html for the latest instructions.
 
27
See http://bazaar-vcs.org/Download for the latest instructions.
28
28
 
29
29
 
30
30
Installing from scratch
31
31
-----------------------
32
32
 
33
 
If you wish to install Breezy from scratch rather than using a
 
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.7 or later.
 
36
  1. If it is not installed already, install Python 2.4 or later.
37
37
 
38
 
  2. Download the ``breezy-xxx.tar.gz`` file (where xxx is the version
39
 
     number) from https://www.breezy-vcs.org/pages/download.html or from Launchpad
40
 
     (https://launchpad.net/~brz/).
 
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
41
 
42
42
  3. Unpack the archive using tar, WinZip or equivalent.
43
43
 
44
44
  4. Put the created directory on your PATH.
45
45
 
46
 
To test the installation, try running the **brz** command like this::
47
 
 
48
 
  brz version
49
 
 
50
 
This will display the version of Breezy you have installed. If this
 
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
51
doesn't work, please contact us via email or IRC so we can help you
52
52
get things working.
53
53
 
55
55
Installing into site-wide locations
56
56
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
57
57
 
58
 
Instead of adding the directory to your PATH, you can install brz into the
 
58
Instead of adding the directory to your PATH, you can install bzr into the
59
59
system locations using::
60
60
 
61
61
  python setup.py install
62
62
 
63
63
If you do not have a compiler, or do not have the python development tools
64
 
installed, brz supplies a (slower) pure-python implementation of all
 
64
installed, bzr supplies a (slower) pure-python implementation of all
65
65
extensions. You can install without compiling extensions with::
66
66
 
67
67
  python setup.py install build_ext --allow-python-fallback
72
72
-------------------------------
73
73
 
74
74
You may wish to always be using the very latest development version of
75
 
Breezy. Note that this is not recommended for
 
75
Bazaar. Note that this is not recommended for
76
76
the majority of users as there is an increased risk of bugs. On the other
77
77
hand, the development version is remarkably solid (thanks to the processes
78
78
we follow) and running it makes it easier for you to send us changes for
81
81
 
82
82
Here are the steps to follow:
83
83
 
84
 
  1. Install Breezy using one of the methods given above.
 
84
  1. Install Bazaar using one of the methods given above.
85
85
 
86
86
  2. Get a copy of the development version like this::
87
87
 
88
 
       brz branch lp:brz
 
88
       bzr branch lp:bzr
89
89
 
90
90
  3. Put the created directory on your PATH.
91
91
 
92
92
Advanced users may also wish to build the optional C extensions for greater
93
 
speed. This can be done using ``make`` and requires ``cython`` and a C compiler.
 
93
speed. This can be done using ``make`` and requires ``pyrex`` and a C compiler.
94
94
Please contact us on email or IRC if you need assistance with this.
95
95
 
96
96
 
97
97
Running multiple versions
98
98
-------------------------
99
99
 
100
 
It's easy to have multiple versions of Breezy installed and to switch
 
100
It's easy to have multiple versions of Bazaar installed and to switch
101
101
between them. To do this,
102
 
simply provide the full pathname to the **brz** command you wish to run.
 
102
simply provide the full pathname to the **bzr** command you wish to run.
103
103
The relevant libraries will be automatically detected and used. Of course,
104
 
if you do not provide a pathname, then the **brz** used will be the one
 
104
if you do not provide a pathname, then the **bzr** used will be the one
105
105
found on your system path as normal.
106
106
 
107
107
Note that this capability is particularly useful if you wish to run