[MERGE] Output refactoring and XML integration into bzrlib

[Aaron Bentley]

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

Blake Winton wrote:
> Aaron Bentley wrote:
>>>> Another thing, if you're going to introduce a machine-readable output
>>>> format, a description of that format would be useful.
>>>    I already have a dtd and xsd for log --xml output (and working in the
>>> status dtd/xsd). But don't known if dtd and/or xsd is enough. What would
>>> you recommend, dtd and/or xsd? or maybe another standard?.
>> No, I think you should provide something human-readable, not
>> machine-readable.
> 
> Relax-NG, say, to go with Bazaar-NG?  ;)
> http://relaxng.org/compact-tutorial-20030326.html

No, not a schema.  Something human-readable that describes what the
pieces mean, not merely what they are.

Some of the other formats we've documented are:

Bundle format 4:
http://doc.bazaar-vcs.org/latest/developers/bundle-format4.html

Container format 1:
http://doc.bazaar-vcs.org/latest/developers/container-format.html

Multi-parent diffs:
http://bazaar-vcs.org/DraftSpecs/MultiparentDiffs

> Or did you mean more like non-canonical paragraphs of text, explaining
> the format and its semantics, and giving examples?

Ideally, the paragraphs of text would be canonical.

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

iD8DBQFHOz2m0F+nu1YWqI0RAvekAJ0ce8tAfXQEdYxew/26jMm/S3rWSgCdH7vV
eFFYw0aLC+2O6D5lpgK/qTQ=
=4f7Q
-----END PGP SIGNATURE-----