1
=====================================
2
README for Bazaar DEVELOPMENT VERSION
3
=====================================
5
Bazaar is a decentralized revision control system, designed to be easy
6
for developers and end users alike.
8
To install Bazaar from source, follow the instructions in the INSTALL
9
file. Otherwise, you may want to check your distribution package manager
10
for ready-to-install packages, or http://bazaar-vcs.org/DistroDownloads.
12
To learn how to use Bazaar, check the documentation in the doc/ directory.
13
Once installed, you can also run 'bzr help'. An always up-to-date and more
14
complete set of documents can be found in the Bazaar website, at:
16
http://bazaar-vcs.org/Documentation
18
Bazaar is written in Python, and is sponsored by Canonical Limited, the
19
founders of Ubuntu and Launchpad. Bazaar is Free Software, and is released
20
under the GNU General Public License.
22
Bazaar was formerly known as Bazaar-NG, and some documentation still uses
23
that old name. Also, since the Bazaar binary is called "bzr", many times this
24
shorter name is used instead (like Subversion/svn and Mercurial/hg).
29
* Easy to use and intuitive.
31
Only five commands are needed to do all basic operations, and all
32
commands have documentation accessible via 'bzr help command'.
33
Bazaar's interface is also easy to lern for CVS and Subversion users.
35
* Robust and reliable.
37
Bazaar is developed under an extensive test suite. Branches can be
38
checked and verified for integrity at any time, and revisions can be
39
signed with PGP/GnuPG.
41
* Publish branches with HTTP.
43
Branches can be hosted on an HTTP server with no need for special
44
software on the server side. Branches can be uploaded by bzr itself
45
over SSH (SFTP), or with rsync.
47
* Adapts to multiple environments.
49
Bazaar runs on Linux and Windows, fully supports Unicode filenames,
50
and suits different development models, including centralized.
52
* Easily extended and customized.
54
A rich Python interface is provided for extending and embedding,
55
including a plugin interface. There are already many available plugins,
56
most of them registered at http://bazaar-vcs.org/PluginRegistry.
60
Changes will never be merged more than once, conflicts will be
61
minimized, and identical changes are dealt with well.
63
* Vibrant and active community.
65
Help with Bazaar is obtained easily, via the mailing list, or the IRC
66
channel. Check http://bazaar-vcs.org/BzrSupport for details.
1
***********************************
2
Release notes for Bazaar-NG (pre-0)
3
***********************************
5
mbp@sourcefrog.net, March 2005, Canberra
13
* There is little locking or transaction control here; if you
14
interrupt it the tree may be arbitrarily broken. This will be
17
* Don't use this for critical data; at the very least keep separate
18
regular snapshots of your tree.
24
This is mostly developed on Linux (Ubuntu); it should work on Unix,
25
Windows, or OS X with relatively little trouble.
27
The only dependency is Python, at least 2.3 and preferably 2.4. On
28
Windows, Python2.4 is required.
30
You may optionally install cElementTree to speed up some operations.
36
The best way to install bzr is to symlink the ``bzr`` command onto a
37
directory on your path. For example::
39
ln -s ~/work/bzr/bzr ~/bin/bzr
41
If you use a symlink for this, Python will be able to automatically
42
find the bzr libraries. Otherwise you must ensure they are listed on
45
After installing, please run the test suite to identify any problems
50
If you use the setup.py script then bzr will be installed into the
51
specified path. In this case you must install ElementTree or
52
cElementTree separately.