~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Robert Collins
  • Date: 2006-09-25 00:03:15 UTC
  • mto: This revision was merged to the branch mainline in revision 2038.
  • Revision ID: robertc@robertcollins.net-20060925000315-d096352885e1b2ec
(Robert Collins) bzr 0.11rc1 has branch, bump bzr.dev version to 0.12

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
=================
2
 
README for Bazaar
3
 
=================
4
 
 
5
 
Bazaar is a decentralized revision control system, designed to be easy
6
 
for developers and end users alike.
7
 
 
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.
11
 
 
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:
15
 
 
16
 
    http://bazaar-vcs.org/Documentation
17
 
 
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.
21
 
 
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).
25
 
 
26
 
Bazaar highlights
27
 
=================
28
 
 
29
 
  * Easy to use and intuitive.
30
 
 
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 learn for CVS and Subversion users.
34
 
 
35
 
  * Robust and reliable.
36
 
 
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.
40
 
 
41
 
 * Publish branches with HTTP.
42
 
 
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.
46
 
 
47
 
 * Adapts to multiple environments.
48
 
 
49
 
   Bazaar runs on Linux and Windows, fully supports Unicode filenames,
50
 
   and suits different development models, including centralized.
51
 
 
52
 
 * Easily extended and customized.
53
 
 
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.
57
 
 
58
 
 * Smart merging.
59
 
 
60
 
    Changes will never be merged more than once, conflicts will be
61
 
    minimized, and identical changes are dealt with well.
62
 
 
63
 
 * Vibrant and active community.
64
 
 
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
README for Bazaar 0.11
 
3
**********************
 
4
 
 
5
Bazaar is a distributed/decentralized version control system.
 
6
 
 
7
Features include:
 
8
 
 
9
 * simple to use
 
10
 
 
11
 * runs on Unix and Windows
 
12
 
 
13
 * branches can be hosted on an http server with no special software
 
14
 
 
15
 * full directory versioning including tracking subdirectories, 
 
16
   file renames, symlinks and execute-bits
 
17
   
 
18
 * friendly interface that should be familiar to users of cvs, 
 
19
   svn or other systems
 
20
 
 
21
 * Python interface for extending and embedding, including a 
 
22
   plugin interface
 
23
 
 
24
 * strong integrity protection, including gpg-signing
 
25
 
 
26
 * vibrant and active community
 
27
 
 
28
For usage instructions see 
 
29
http://doc.bazaar-vcs.org/
 
30
or run "bzr help"
 
31
 
 
32
For installation instructions see ./INSTALL