[patch] add release notes to news
Martin Pool
mbp at sourcefrog.net
Fri May 5 08:25:27 BST 2006
This patch is meant to summarize the most-important things people need
to know when upgrading to 0.8. Many other details are already covered
in point form. Is there anything else that should be added/corrected?
--
Martin
-------------- next part --------------
=== modified file 'a/NEWS'
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,39 @@
-bzr 0.8rc1 2006-04-14
+bzr 0.8rc2 2006-05-05
+
+ NOTES WHEN UPGRADING:
+
+ Release 0.8 of bzr introduces a new format for history storage, called
+ 'knit', as an evolution of to the 'weave' format used in 0.7. Local
+ and remote operations are faster using weaves than knits. Several
+ operations including 'init', 'init-repo', and 'upgrade' take a
+ --format option that controls this. Branching from an existing branch
+ will keep the same format.
+
+ It is possible to merge, pull and push between branches of different
+ formats but this is slower than moving data between homogenous
+ branches. It is therefore recommended (but not required) that you
+ upgrade all branches for a project at the same time. Information on
+ formats is shown by 'bzr info'.
+
+ bzr 0.8 now allows creation of 'repositories', which hold the history
+ of files and revisions for several branches. Previously bzr kept all
+ the history for a branch within the .bzr directory at the root of the
+ branch, and this is still the default. To create a repository, use
+ the new 'bzr init-repo' command. Branches exist as directories under
+ the repository and contain just a small amount of information
+ indicating the current revision of the branch.
+
+ bzr 0.8 also supports 'checkouts', which are similar to in cvs and
+ subversion. Checkouts are associated with a branch (optionally in a
+ repository), which contains all the historical information. The
+ result is that a checkout can be deleted without losing any
+ already-committed revisions.
+
+ Repositories and checkouts are not supported with the 0.7 storage
+ format. To use them you must upgrad to either knits, or to the
+ 'metaweave' format, which uses weaves but changes the .bzr directory
+ arrangement.
+
IMPROVEMENTS:
@@ -208,7 +243,7 @@
* Move test case for uncommit to blackbox tests. (Olaf Conradi)
-bzr 0.7rc1 2006-01-09
+bzr 0.7 2006-01-09
CHANGES:
More information about the bazaar
mailing list