[MERGE 0.9] Improve/Rewrite README file
Adeodato Simó
dato at net.com.org.es
Thu Aug 24 23:05:36 BST 2006
* Martin Pool [Mon, 14 Aug 2006 14:15:53 +1000]:
Hey, hi.
> On 14 Aug 2006, Adeodato Simó <dato at net.com.org.es> wrote:
> > Hi.
> > I'm attaching a patch to improve the README file for Bazaar, which IMHO
> > was a bit, erm, lacking. The list of features sorta-comes from [1].
> > I passed this patch to Martin on IRC a couple days ago, but it seems it
> > couldn't make 0.9. I'm sending it to the list for broader review, and
> > try not for it to get forgotten. ;-)
> > Ideally I'd merge it into 0.9, in case there's a 0.9.1 for other
> > reasons. If this is not appropriate, feel free to apply the diff to
> > bzr.dev.
> I've merged it into the 0.9 branch, and am putting it into .dev now. I
> think we will do an 0.9.1 if only to add the Windows installer source.
Seems like these merges never happened. I'm attaching the patch updated
for 0.10, and CC'ing Rob after mentioning this on IRC.
BTW, Rob, it was also mentioned on IRC that it'd be good to remove the
BRANCH.TODO file from the "release branch".
Cheers,
--
Adeodato Simó dato at net.com.org.es
Debian Developer adeodato at debian.org
Listening to: The Postal Service - Brand new colony
-------------- next part --------------
# Bazaar revision bundle v0.8
#
# message:
# Update for 0.10, fix typo (thanks, Lele!), add blank line.
#
# committer: Adeodato Simó <dato at net.com.org.es>
# date: Fri 2006-08-25 00:02:01.312999964 +0200
=== modified file README
--- README
+++ README
@@ -1,32 +1,69 @@
-*******************************
-Release notes for Bazaar-NG 0.8
-*******************************
-
-bazaar-ng is a distributed/decentralized version control system.
-
-Features include:
-
- * simple to use
-
- * runs on Unix and Windows
-
- * branches can be hosted on an http server with no special software
-
- * full directory versioning including tracking subdirectories,
- file renames, symlinks and execute-bits
-
- * friendly interface that should be familiar to users of cvs,
- svn or other systems
-
- * Python interface for extending and embedding, including a
- plugin interface
-
- * strong integrity protection, including gpg-signing
-
- * vibrant and active community
-
-For usage instructions see
-http://bazaar.canonical.com/IntroductionToBzr
-or run "bzr help"
-
-For installation instructions see ./INSTALL
+README for Bazaar 0.10
+======================
+
+Bazaar is a decentralized revision control system, designed to be easy
+for developers and end users alike.
+
+Bazaar 0.10 was released on Sept 4th, 2006. Check the NEWS file for a
+summary of the changes since 0.9.
+
+To install Bazaar from source, follow the instructions in the INSTALL
+file. Otherwise, you may want to check your distribution package manager
+for ready-to-install packages, or http://bazaar-vcs.org/DistroDownloads.
+
+To learn how to use Bazaar, check the documentation in the doc/ directory.
+Once installed, you can also run 'bzr help'. An always up-to-date and more
+complete set of documents can be found in the Bazaar website, at:
+
+ http://bazaar-vcs.org/Documentation
+
+Bazaar is written in Python, and is sponsored by Canonical Limited, the
+founders of Ubuntu and Launchpad. Bazaar is Free Software, and is released
+under the GNU General Public License.
+
+Bazaar was formerly known as Bazaar-NG, and some documentation still uses
+that old name. Also, since the Bazaar binary is called "bzr", many times this
+shorter name is used instead (like Subversion/svn and Mercurial/hg).
+
+
+Bazaar highlights
+=================
+
+ * Easy to use and intuitive.
+
+ Only five commands are needed to do all basic operations, and all
+ commands have documentation accessible via 'bzr help command'.
+ Bazaar's interface is also easy to learn for CVS and Subversion users.
+
+ * Robust and reliable.
+
+ Bazaar is developed under an extensive test suite. Branches can be
+ checked and verified for integrity at any time, and revisions can be
+ signed with PGP/GnuPG.
+
+ * Publish branches with HTTP.
+
+ Branches can be hosted on an HTTP server with no need for special
+ software on the server side. Branches can be uploaded by bzr itself
+ over SSH (SFTP), or with rsync.
+
+ * Adapts to multiple environments.
+
+ Bazaar runs on Linux and Windows, fully supports Unicode filenames,
+ and suits different development models, including centralized.
+
+ * Easily extended and customized.
+
+ A rich Python interface is provided for extending and embedding,
+ including a plugin interface. There are already many available plugins,
+ most of them registered at http://bazaar-vcs.org/PluginRegistry.
+
+ * Smart merging.
+
+ Changes will never be merged more than once, conflicts will be
+ minimized, and identical changes are dealt with well.
+
+ * Vibrant and active community.
+
+ Help with Bazaar is obtained easily, via the mailing list, or the IRC
+ channel. Check http://bazaar-vcs.org/BzrSupport for details.
# revision id: dato at net.com.org.es-20060824220201-85670c2179a36acf
# sha1: cfcdf4ab30842bad14ec9fa4e2af65d15ed60ff5
# inventory sha1: a6272552e31fabc2caf0e3a0ea34502d9706a927
# parent ids:
# dato at net.com.org.es-20060811012651-47b6f9759efc25f9
# base id: pqm at pqm.ubuntu.com-20060810013816-914bb9b7a31e8fd9
# properties:
# branch-nick: bzr.improve-README
# message:
# Revamp README file for Bazaar 0.9.
# committer: Adeodato Simó <dato at net.com.org.es>
# date: Fri 2006-08-11 03:26:51.707999945 +0200
=== modified file README // encoding:base64
LS0tIFJFQURNRQorKysgUkVBRE1FCkBAIC0xLDMyICsxLDY4IEBACi0qKioqKioqKioqKioqKioq
KioqKioqKioqKioqKioqCi1SZWxlYXNlIG5vdGVzIGZvciBCYXphYXItTkcgMC44Ci0qKioqKioq
KioqKioqKioqKioqKioqKioqKioqKioqCi0KLWJhemFhci1uZyBpcyBhIGRpc3RyaWJ1dGVkL2Rl
Y2VudHJhbGl6ZWQgdmVyc2lvbiBjb250cm9sIHN5c3RlbS4KLQotRmVhdHVyZXMgaW5jbHVkZToK
LQotICogc2ltcGxlIHRvIHVzZQotCi0gKiBydW5zIG9uIFVuaXggYW5kIFdpbmRvd3MKLQotICog
YnJhbmNoZXMgY2FuIGJlIGhvc3RlZCBvbiBhbiBodHRwIHNlcnZlciB3aXRoIG5vIHNwZWNpYWwg
c29mdHdhcmUKLQotICogZnVsbCBkaXJlY3RvcnkgdmVyc2lvbmluZyBpbmNsdWRpbmcgdHJhY2tp
bmcgc3ViZGlyZWN0b3JpZXMsIAotICAgZmlsZSByZW5hbWVzLCBzeW1saW5rcyBhbmQgZXhlY3V0
ZS1iaXRzCi0gICAKLSAqIGZyaWVuZGx5IGludGVyZmFjZSB0aGF0IHNob3VsZCBiZSBmYW1pbGlh
ciB0byB1c2VycyBvZiBjdnMsIAotICAgc3ZuIG9yIG90aGVyIHN5c3RlbXMKLQotICogUHl0aG9u
IGludGVyZmFjZSBmb3IgZXh0ZW5kaW5nIGFuZCBlbWJlZGRpbmcsIGluY2x1ZGluZyBhIAotICAg
cGx1Z2luIGludGVyZmFjZQotCi0gKiBzdHJvbmcgaW50ZWdyaXR5IHByb3RlY3Rpb24sIGluY2x1
ZGluZyBncGctc2lnbmluZwotCi0gKiB2aWJyYW50IGFuZCBhY3RpdmUgY29tbXVuaXR5Ci0KLUZv
ciB1c2FnZSBpbnN0cnVjdGlvbnMgc2VlIAotaHR0cDovL2JhemFhci5jYW5vbmljYWwuY29tL0lu
dHJvZHVjdGlvblRvQnpyCi1vciBydW4gImJ6ciBoZWxwIgotCi1Gb3IgaW5zdGFsbGF0aW9uIGlu
c3RydWN0aW9ucyBzZWUgLi9JTlNUQUxMCitSRUFETUUgZm9yIEJhemFhciAwLjkKKz09PT09PT09
PT09PT09PT09PT09PQorCitCYXphYXIgaXMgYSBkZWNlbnRyYWxpemVkIHJldmlzaW9uIGNvbnRy
b2wgc3lzdGVtLCBkZXNpZ25lZCB0byBiZSBlYXN5Citmb3IgZGV2ZWxvcGVycyBhbmQgZW5kIHVz
ZXJzIGFsaWtlLgorCitCYXphYXIgMC45IHdhcyByZWxlYXNlZCBvbiBBdWcgMVh0aCwgMjAwNi4g
Q2hlY2sgdGhlIE5FV1MgZmlsZSBmb3IgYQorc3VtbWFyeSBvZiB0aGUgY2hhbmdlcyBzaW5jZSAw
LjguMi4KKworVG8gaW5zdGFsbCBCYXphYXIgZnJvbSBzb3VyY2UsIGZvbGxvdyB0aGUgaW5zdHJ1
Y3Rpb25zIGluIHRoZSBJTlNUQUxMCitmaWxlLiBPdGhlcndpc2UsIHlvdSBtYXkgd2FudCB0byBj
aGVjayB5b3VyIGRpc3RyaWJ1dGlvbiBwYWNrYWdlIG1hbmFnZXIKK2ZvciByZWFkeS10by1pbnN0
YWxsIHBhY2thZ2VzLCBvciBodHRwOi8vYmF6YWFyLXZjcy5vcmcvRGlzdHJvRG93bmxvYWRzLgor
CitUbyBsZWFybiBob3cgdG8gdXNlIEJhemFhciwgY2hlY2sgdGhlIGRvY3VtZW50YXRpb24gaW4g
dGhlIGRvYy8gZGlyZWN0b3J5LgorT25jZSBpbnN0YWxsZWQsIHlvdSBjYW4gYWxzbyBydW4gJ2J6
ciBoZWxwJy4gQW4gYWx3YXlzIHVwLXRvLWRhdGUgYW5kIG1vcmUKK2NvbXBsZXRlIHNldCBvZiBk
b2N1bWVudHMgY2FuIGJlIGZvdW5kIGluIHRoZSBCYXphYXIgd2Vic2l0ZSwgYXQ6CisKKyAgICBo
dHRwOi8vYmF6YWFyLXZjcy5vcmcvRG9jdW1lbnRhdGlvbgorCitCYXphYXIgaXMgd3JpdHRlbiBp
biBQeXRob24sIGFuZCBpcyBzcG9uc29yZWQgYnkgQ2Fub25pY2FsIExpbWl0ZWQsIHRoZQorZm91
bmRlcnMgb2YgVWJ1bnR1IGFuZCBMYXVuY2hwYWQuIEJhemFhciBpcyBGcmVlIFNvZnR3YXJlLCBh
bmQgaXMgcmVsZWFzZWQKK3VuZGVyIHRoZSBHTlUgR2VuZXJhbCBQdWJsaWMgTGljZW5zZS4KKwor
QmF6YWFyIHdhcyBmb3JtZXJseSBrbm93biBhcyBCYXphYXItTkcsIGFuZCBzb21lIGRvY3VtZW50
YXRpb24gc3RpbGwgdXNlcwordGhhdCBvbGQgbmFtZS4gQWxzbywgc2luY2UgdGhlIEJhemFhciBi
aW5hcnkgaXMgY2FsbGVkICJienIiLCBtYW55IHRpbWVzIHRoaXMKK3Nob3J0ZXIgbmFtZSBpcyB1
c2VkIGluc3RlYWQgKGxpa2UgU3VidmVyc2lvbi9zdm4gYW5kIE1lcmN1cmlhbC9oZykuCisKK0Jh
emFhciBoaWdobGlnaHRzCis9PT09PT09PT09PT09PT09PQorCisgICogRWFzeSB0byB1c2UgYW5k
IGludHVpdGl2ZS4KKworICAgIE9ubHkgZml2ZSBjb21tYW5kcyBhcmUgbmVlZGVkIHRvIGRvIGFs
bCBiYXNpYyBvcGVyYXRpb25zLCBhbmQgYWxsCisgICAgY29tbWFuZHMgaGF2ZSBkb2N1bWVudGF0
aW9uIGFjY2Vzc2libGUgdmlhICdienIgaGVscCBjb21tYW5kJy4KKyAgICBCYXphYXIncyBpbnRl
cmZhY2UgaXMgYWxzbyBlYXN5IHRvIGxlcm4gZm9yIENWUyBhbmQgU3VidmVyc2lvbiB1c2Vycy4K
KworICAqIFJvYnVzdCBhbmQgcmVsaWFibGUuCisKKyAgICBCYXphYXIgaXMgZGV2ZWxvcGVkIHVu
ZGVyIGFuIGV4dGVuc2l2ZSB0ZXN0IHN1aXRlLiBCcmFuY2hlcyBjYW4gYmUKKyAgICBjaGVja2Vk
IGFuZCB2ZXJpZmllZCBmb3IgaW50ZWdyaXR5IGF0IGFueSB0aW1lLCBhbmQgcmV2aXNpb25zIGNh
biBiZQorICAgIHNpZ25lZCB3aXRoIFBHUC9HbnVQRy4KKworICogUHVibGlzaCBicmFuY2hlcyB3
aXRoIEhUVFAuCisKKyAgIEJyYW5jaGVzIGNhbiBiZSBob3N0ZWQgb24gYW4gSFRUUCBzZXJ2ZXIg
d2l0aCBubyBuZWVkIGZvciBzcGVjaWFsCisgICBzb2Z0d2FyZSBvbiB0aGUgc2VydmVyIHNpZGUu
IEJyYW5jaGVzIGNhbiBiZSB1cGxvYWRlZCBieSBienIgaXRzZWxmCisgICBvdmVyIFNTSCAoU0ZU
UCksIG9yIHdpdGggcnN5bmMuCisKKyAqIEFkYXB0cyB0byBtdWx0aXBsZSBlbnZpcm9ubWVudHMu
CisKKyAgIEJhemFhciBydW5zIG9uIExpbnV4IGFuZCBXaW5kb3dzLCBmdWxseSBzdXBwb3J0cyBV
bmljb2RlIGZpbGVuYW1lcywKKyAgIGFuZCBzdWl0cyBkaWZmZXJlbnQgZGV2ZWxvcG1lbnQgbW9k
ZWxzLCBpbmNsdWRpbmcgY2VudHJhbGl6ZWQuCisKKyAqIEVhc2lseSBleHRlbmRlZCBhbmQgY3Vz
dG9taXplZC4KKworICAgQSByaWNoIFB5dGhvbiBpbnRlcmZhY2UgaXMgcHJvdmlkZWQgZm9yIGV4
dGVuZGluZyBhbmQgZW1iZWRkaW5nLAorICAgaW5jbHVkaW5nIGEgcGx1Z2luIGludGVyZmFjZS4g
VGhlcmUgYXJlIGFscmVhZHkgbWFueSBhdmFpbGFibGUgcGx1Z2lucywKKyAgIG1vc3Qgb2YgdGhl
bSByZWdpc3RlcmVkIGF0IGh0dHA6Ly9iYXphYXItdmNzLm9yZy9QbHVnaW5SZWdpc3RyeS4KKwor
ICogU21hcnQgbWVyZ2luZy4KKworICAgIENoYW5nZXMgd2lsbCBuZXZlciBiZSBtZXJnZWQgbW9y
ZSB0aGFuIG9uY2UsIGNvbmZsaWN0cyB3aWxsIGJlCisgICAgbWluaW1pemVkLCBhbmQgaWRlbnRp
Y2FsIGNoYW5nZXMgYXJlIGRlYWx0IHdpdGggd2VsbC4KKworICogVmlicmFudCBhbmQgYWN0aXZl
IGNvbW11bml0eS4KKworICAgSGVscCB3aXRoIEJhemFhciBpcyBvYnRhaW5lZCBlYXNpbHksIHZp
YSB0aGUgbWFpbGluZyBsaXN0LCBvciB0aGUgSVJDCisgICBjaGFubmVsLiBDaGVjayBodHRwOi8v
YmF6YWFyLXZjcy5vcmcvQnpyU3VwcG9ydCBmb3IgZGV0YWlscy4KCg==
# revision id: dato at net.com.org.es-20060811012651-47b6f9759efc25f9
# sha1: 7a97c84ed3ceb99599805e5eb38bb9f6d54e9226
# inventory sha1: aaaee05146a429c5f930c9a15caf4b8161cd7c48
# parent ids:
# pqm at pqm.ubuntu.com-20060810013816-914bb9b7a31e8fd9
# properties:
# branch-nick: bzr.0.9
More information about the bazaar
mailing list