DOCS Bundle format 4 aka 1.0alpha

[Aaron Bentley]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Robert Collins wrote:

>> After some discussion with Robert, I'm renaming the new format to bundle
>> format 4.  I've written up a document describing it which is close to
>> our actual output format.
> 
> This looks good. Perhaps it could go within doc/developers/bundles.txt
> though, as its quite short and would avoid a dereference to find it ?

Sure, but prolly around merging time, when the format is set in stone.
Right now I'm still working on it.

> It doesn't mention support for rich roots and subtrees as being
> represented in the bundle, but I presume that must be to prevent bundles
> from newer repositories being applied to older ones?

It will mention the serializer used, and this falls under serializer
mismatches, but I was really only focused on how to safely apply changes
when they are compatible.

When then are incompatible-- well, subtrees will cause xml5 or 6 to die
screaming.  Rich roots are more subtle.  I think we'll have to ensure
that transferring xml7 to xml5 doesn't lose any data, but I think we can
do that reasonably easily.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGezdv0F+nu1YWqI0RAhrSAKCCdcSGjUJYl7PGJ/aDAY/pPx0/8gCdGrBt
7tk9LzohRJofvIC9tc+E2Eo=
=PWIz
-----END PGP SIGNATURE-----