~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: John Arbash Meinel
  • Date: 2008-08-25 21:50:11 UTC
  • mfrom: (0.11.3 tools)
  • mto: This revision was merged to the branch mainline in revision 3659.
  • Revision ID: john@arbash-meinel.com-20080825215011-de9esmzgkue3e522
Merge in Lukáš's helper scripts.
Update the packaging documents to describe how to do the releases
using bzr-builddeb to package all distro platforms
simultaneously.

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
README for Bazaar
3
3
=================
4
4
 
5
 
Bazaar is a decentralized revision control system, designed to be easy
6
 
for developers and end users alike.
 
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 to
 
7
develop a complete free operating system.
7
8
 
8
9
To install Bazaar from source, follow the instructions in the INSTALL
9
10
file. Otherwise, you may want to check your distribution package manager
19
20
founders of Ubuntu and Launchpad. Bazaar is Free Software, and is released
20
21
under the GNU General Public License.
21
22
 
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).
 
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.)
25
26
 
26
27
Bazaar highlights
27
28
=================
28
29
 
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.
 
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
 
67
69
 
68
70
Registration and Feedback
69
71
=========================
70
72
 
 
73
If you encounter any problems with Bazaar, need help understanding it, or would
 
74
like to offer suggestions or feedback, please get in touch with us:
 
75
 
 
76
* Ask a question through our web support interface, at 
 
77
  https://answers.launchpad.net/bzr/
 
78
 
 
79
* Report bugs at https://bugs.edge.launchpad.net/bzr/+filebug
 
80
 
 
81
* Write to us at bazaar@lists.canonical.com 
 
82
  You can join the list at <https://lists.ubuntu.com/mailman/listinfo/bazaar>.
 
83
  You don't need to subscribe to post, but your first post will be held 
 
84
  briefly for manual moderation.
 
85
 
 
86
* Talk to us in irc://irc.ubuntu.com/bzr
 
87
 
 
88
* And see http://bazaar-vcs.org/BzrSupport for more.
 
89
 
71
90
If you would like to help us improve Bazaar by telling us about yourself and
72
91
what we could do better, please register and complete the online survey here:
73
 
http://www.surveymonkey.com/s.aspx?sm=L94RvLswhKdktrxiHWiX3g_3d_3d.
74
 
 
75
 
Registration is completely optional. If you would like to provide feedback
76
 
in other ways, see http://bazaar-vcs.org/BzrSupport for alternative ways of
77
 
getting in contact with us.
 
92
http://www.surveymonkey.com/s.aspx?sm=L94RvLswhKdktrxiHWiX3g_3d_3d.  
 
93
Registration is completely optional. 
78
94
 
79
95
Enjoy,
80
96
The Bazaar Team