← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Vincent Ladeuil
  • Date: 2010-01-23 11:37:40 UTC
  • mto: (4984.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4985.
  • Revision ID: v.ladeuil+lp@free.fr-20100123113740-0a324t1w36zecx59
Wrong deprecation caught by pqm.

* bzrlib/log.py:
(_rebase_merge_depth): Don't deprecate, it's *still* used !

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
1
 
=====================================
2
 
README for Bazaar DEVELOPMENT VERSION
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
 
1
=================
 
2
README for Bazaar
 
3
=================
 
4
 
 
5
Bazaar (``bzr``) is a decentralized revision control system, designed to be
 
6
easy for developers and end users alike.  Bazaar is part of the GNU project
 
7
to develop a complete free operating system.
 
8
 
 
9
To install Bazaar, follow the instructions given at
 
10
http://bazaar-vcs.org/Download. Ready-to-install packages are available
 
11
for most popular operating systems or you can install from source.
 
12
 
 
13
To learn how to use Bazaar, see the official documentation at:
 
14
 
 
15
    http://doc.bazaar-vcs.org/en/
 
16
 
 
17
For additional training materials including screencasts and slides,
 
18
visit our community wiki documentation page at:
 
19
 
 
20
    http://bazaar-vcs.org/Documentation/
17
21
 
18
22
Bazaar is written in Python, and is sponsored by Canonical Limited, the
19
23
founders of Ubuntu and Launchpad. Bazaar is Free Software, and is released
20
24
under the GNU General Public License.
21
25
 
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
26
Bazaar highlights
27
27
=================
28
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 lern 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.
 
29
Bazaar directly supports both central version control (like cvs/svn) and
 
30
distributed version control (like git/hg). Developers can organize their
 
31
workspace in whichever way they want on a per project basis including:
 
32
 
 
33
* checkouts (like svn)
 
34
* feature branches (like hg)
 
35
* shared working tree (like git).
 
36
 
 
37
It also directly supports and encourages a large number of development best
 
38
practices like refactoring and pre-commit regression testing. Users can
 
39
choose between our command line tool and our cross-platform GUI application.
 
40
For further details, see our website at http://bazaar-vcs.org/en.
 
41
 
 
42
Feedback
 
43
========
 
44
 
 
45
If you encounter any problems with Bazaar, need help understanding it, or would
 
46
like to offer suggestions or feedback, please get in touch with us:
 
47
 
 
48
* Ask a question through our web support interface, at 
 
49
  https://answers.launchpad.net/bzr/
 
50
 
 
51
* Report bugs at https://bugs.launchpad.net/bzr/+filebug
 
52
 
 
53
* Write to us at bazaar@lists.canonical.com 
 
54
  You can join the list at <https://lists.ubuntu.com/mailman/listinfo/bazaar>.
 
55
  You don't need to subscribe to post, but your first post will be held 
 
56
  briefly for manual moderation.
 
57
 
 
58
* Talk to us in irc://irc.ubuntu.com/bzr
 
59
 
 
60
Our mission is to make a version control tool that developers LOVE to use
 
61
and that casual contributors feel confident with. Please let us know how
 
62
we're going.
 
63
 
 
64
The Bazaar Team