← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/development-repo.txt

  • Committer: Jelmer Vernooij
  • Date: 2009-04-06 02:54:14 UTC
  • mfrom: (4253 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4255.
  • Revision ID: jelmer@samba.org-20090406025414-65tpjwcmjp5wa5oj
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/development-repo.txt
28
28
 
29
29
When a release of bzr is done, all the older numbered development
30
30
formats will be removed from 'bzr.dev', so we will not be carrying the
31
 
code for them around indefinately.
 
31
code for them around indefinately. 
32
32
 
33
33
Support for upgrade and migration
34
34
---------------------------------
40
40
 - users of a given development format can always get back onto regular
41
41
   formats by switching to the next bzr released version which is
42
42
   guaranteed to be able to upgrade from that development format.
43
 
 - users that routinely use bzr.dev should upgrade to the most recent
 
43
 - users that routinely use bzr.dev should upgrade to the most recent 
44
44
   development version available before pulling in bzr.dev changes
45
45
   around release time, as that is when old format cleanups will occur.
46
46
 
171
171
 
172
172
If you need any help or encounter any problems, please contact the developers
173
173
via the usual ways, i.e. chat to us on IRC or send a message to our mailing
174
 
list. See http://wiki.bazaar.canonical.com/BzrSupport for contact details.
 
174
list. See http://bazaar-vcs.org/BzrSupport for contact details.
175
175
 
176
176
 
177
177
Technical notes
244
244
development
245
245
-----------
246
246
 
247
 
Not currently available, as our development formats are all rich root or
248
 
subtrees now.
249
 
 
250
 
development-rich-root
251
 
---------------------
252
 
 
253
 
Currently an alias for Development6Subtree
 
247
Currently an alias for Development2
254
248
 
255
249
development-subtree
256
250
-------------------
257
251
 
258
 
Currently an alias for Development6Subtree
259
 
 
260
 
Development6RichRoot[Subtree]
261
 
-----------------------------
262
 
 
263
 
These formats use the new groupcompress delta compress and a CHK(Content
264
 
Hash Key) based inventory store which is much faster at incremental
265
 
operations than the prior XML based store.
266
 
*Note* Converting from a non-rich-root to a rich-root format is a
267
 
one-way upgrade, and you cannot merge back afterwards: using this format
268
 
for everyday use is likely to cause all developers of a project to
269
 
upgrade to a rich-root format themselves. This is fine, as bzr is moving
270
 
to make rich-root formats the default and to get all users to upgrade,
271
 
but we have not finalised the migration process, and until we do do not
272
 
recomment that casual users upgrade. Users of bzr-svn are already using
273
 
rich-root formats and can test with this with impunity.
 
252
Currently an alias for Development2Subtree
 
253
 
 
254
Development2[Subtree]
 
255
---------------------
 
256
 
 
257
These formats use B+Tree indices which are considerably faster than
 
258
the earlier indices in bzr.
 
259
 
 
260
Development5[Subtree]
 
261
---------------------
 
262
 
 
263
These formats use B+Tree indices and also offer a CHK based byte store
 
264
in addition to the revision/inventory/signatures and text stores.
274
265
 
275
266
 
276
267
..