~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/bundle-format4.txt

  • Committer: Aaron Bentley
  • Date: 2007-07-04 23:38:26 UTC
  • mto: This revision was merged to the branch mainline in revision 2631.
  • Revision ID: aaron.bentley@utoronto.ca-20070704233826-jkp63376wi1n96mm
update docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
113
113
 
114
114
Putting the format marker in plaintext ensures that old clients will give good
115
115
diagnostics, but renders the file unreadable by standard bzip2 utilities.
116
 
``bzr bundle-info -v`` can be used to dump the unencoded output.
117
116
 
118
117
Serialization
119
118
~~~~~~~~~~~~~
189
188
    and revision data.  May be ``xml5``, ``xml6`` or ``xml7``.
190
189
:supports_rich_root: 1 if the source repository supports rich roots,
191
190
    0 otherwise.
192
 
:supports_tree_references: 1 if the source repository supports subtree
193
 
    references, 0 otherwise.
194
191
 
195
192
 
196
193
Implementation notes
230
227
~~~~~~~~~~~~~~~~~
231
228
 
232
229
Note that there may be model differences requiring additional changes.  These
233
 
differences are described by the "supports_rich_root" and
234
 
"supports_tree_references" values in the info record.
 
230
differences are described by the "supports_rich_root" value in the info record.
235
231
 
236
232
A subset of xml6 and xml7 records are compatible with xml5 (i.e. those that
237
233
were converted from xml5 originally).
238
234
 
239
 
When installing from a supports_tree_references bundle to a repository that
240
 
does not support tree references, clients should halt if they encounter a
241
 
record containing a tree reference.
 
235
When installing from a bundle whose serializer supports tree references to a
 
236
repository that does not support tree references, clients should halt if they
 
237
encounter a record containing a tree reference.
242
238
 
243
239
When installing from a supports_rich_root bundle to a repository that does not
244
240
support rich roots, clients should halt if they encounter an inventory record