← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Andrew Bennetts
  • Date: 2008-05-21 02:34:32 UTC
  • mto: (3452.2.9 inter-remote-pack)
  • mto: This revision was merged to the branch mainline in revision 3452.
  • Revision ID: andrew.bennetts@canonical.com-20080521023432-rj4qn81st9sou7np
Buffer encoding of v3 messages to minimise write/send calls.  Doubles the speed of pushing over TCP with 500ms latency loopback.

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
4
4
 
5
5
Bazaar (``bzr``) is a decentralized revision control system, designed to be
6
6
easy for developers and end users alike.  Bazaar is part of the GNU project to
7
 
develop a complete free operating system <http://www.gnu.org/>, and a project
8
 
of Canonical <http://www.canonical.com/>.
9
 
 
10
 
Ready-to-install packages are available for most popular operating systems from
11
 
<http://wiki.bazaar.canonical.com/Download/> or you can install from source by
12
 
following the instructions in the INSTALL file.
13
 
 
14
 
To learn how to use Bazaar, see the official documentation in the `doc`
15
 
directory or at <http://doc.bazaar.canonical.com/en/>.
16
 
 
17
 
For additional training materials including screencasts and slides,
18
 
visit our community wiki documentation page at:
19
 
 
20
 
    http://wiki.bazaar.canonical.com/Documentation/
21
 
 
22
 
Bazaar is Free Software, and is released under the GNU General Public License,
23
 
version 2 or later.
 
7
develop a complete free operating system.
 
8
 
 
9
To install Bazaar from source, follow the instructions in the INSTALL
 
10
file. Otherwise, you may want to check your distribution package manager
 
11
for ready-to-install packages, or http://bazaar-vcs.org/DistroDownloads.
 
12
 
 
13
To learn how to use Bazaar, check the documentation in the doc/ directory.
 
14
Once installed, you can also run 'bzr help'. An always up-to-date and more
 
15
complete set of documents can be found in the Bazaar website, at:
 
16
 
 
17
    http://bazaar-vcs.org/Documentation
 
18
 
 
19
Bazaar is written in Python, and is sponsored by Canonical Limited, the
 
20
founders of Ubuntu and Launchpad. Bazaar is Free Software, and is released
 
21
under the GNU General Public License.
 
22
 
 
23
Bazaar was formerly known as Bazaar-NG.  It's the successor to ``baz``, a fork
 
24
of GNU arch, but shares no code.  (To upgrade from Baz, use the ``baz-import``
 
25
command in the bzrtools plugin.)
24
26
 
25
27
Bazaar highlights
26
28
=================
27
29
 
28
 
Bazaar directly supports both central version control (like cvs/svn) and
29
 
distributed version control (like git/hg). Developers can organize their
30
 
workspace in whichever way they want on a per project basis including:
31
 
 
32
 
* checkouts (like svn)
33
 
* feature branches (like hg)
34
 
* shared working tree (like git).
35
 
 
36
 
It also directly supports and encourages a large number of development best
37
 
practices like refactoring and pre-commit regression testing. Users can
38
 
choose between our command line tool and our cross-platform GUI application.
39
 
For further details, see our website at http://bazaar-vcs.org/en.
40
 
 
41
 
Feedback
42
 
========
 
30
* Easy to use and intuitive.
 
31
 
 
32
  Only five commands are needed to do all basic operations, and all
 
33
  commands have documentation accessible via 'bzr help command'.
 
34
  Bazaar's interface is also easy to learn for CVS and Subversion users.
 
35
 
 
36
* Robust and reliable.
 
37
 
 
38
  Bazaar is developed under an extensive test suite. Branches can be
 
39
  checked and verified for integrity at any time, and revisions can be
 
40
  signed with PGP/GnuPG.
 
41
 
 
42
* Publish branches with HTTP.
 
43
 
 
44
  Branches can be hosted on an HTTP server with no need for special
 
45
  software on the server side. Branches can be uploaded by bzr itself
 
46
  over SSH (SFTP), or with rsync.
 
47
 
 
48
* Adapts to multiple environments.
 
49
 
 
50
  Bazaar runs on Linux and Windows, fully supports Unicode filenames,
 
51
  and suits different development models, including centralized.
 
52
 
 
53
* Easily extended and customized.
 
54
 
 
55
  A rich Python interface is provided for extending and embedding,
 
56
  including a plugin interface. There are already many available plugins,
 
57
  most of them registered at http://bazaar-vcs.org/PluginRegistry.
 
58
 
 
59
* Smart merging.
 
60
 
 
61
  Changes will never be merged more than once, conflicts will be
 
62
  minimized, and identical changes are dealt with well.
 
63
 
 
64
* Vibrant and active community.
 
65
 
 
66
  Help with Bazaar is obtained easily, via the mailing list, or the IRC
 
67
  channel.
 
68
 
 
69
 
 
70
Registration and Feedback
 
71
=========================
43
72
 
44
73
If you encounter any problems with Bazaar, need help understanding it, or would
45
74
like to offer suggestions or feedback, please get in touch with us:
47
76
* Ask a question through our web support interface, at 
48
77
  https://answers.launchpad.net/bzr/
49
78
 
50
 
* Report bugs at https://bugs.launchpad.net/bzr/+filebug
 
79
* Report bugs at https://bugs.edge.launchpad.net/bzr/+filebug
51
80
 
52
81
* Write to us at bazaar@lists.canonical.com 
53
82
  You can join the list at <https://lists.ubuntu.com/mailman/listinfo/bazaar>.
56
85
 
57
86
* Talk to us in irc://irc.ubuntu.com/bzr
58
87
 
59
 
Our mission is to make a version control tool that developers LOVE to use
60
 
and that casual contributors feel confident with. Please let us know how
61
 
we're going.
62
 
 
 
88
* And see http://bazaar-vcs.org/BzrSupport for more.
 
89
 
 
90
If you would like to help us improve Bazaar by telling us about yourself and
 
91
what we could do better, please register and complete the online survey here:
 
92
http://www.surveymonkey.com/s.aspx?sm=L94RvLswhKdktrxiHWiX3g_3d_3d.  
 
93
Registration is completely optional. 
 
94
 
 
95
Enjoy,
63
96
The Bazaar Team