[Xcb] [doc] first step of the documentation of sync.xml

[Jamey Sharp]

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

On 12/12/07, Eamon Walsh <ewalsh at tycho.nsa.gov> wrote:
> It would be nice if DocBook markup (<para>, etc.) could be present
> inside the <doc> container as though it were a docbook <section>.
> That could be used to generate docbook source and from there to man,
> html, etc.

I've said the same thing, but I intend to accept any patches that
improve the state of XCB's documentation, and Vincent has contributed
most of those patches, so Doxygen it is. ;-)

However, he's being careful to define an XML tagset for the
documentation (rather than using the non-XML Doxygen markup directly),
so I hope that translation to Docbook will be straightforward.

Furthermore, we consider the xcb-proto XML schema quite fluid still, so
this all may change again if somebody does the work. :-)

Jamey
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFHZM1rp1aplQ4I9mURAupuAJ4shlAskCHItRZv8IQASpK+OXJU8wCfc6Jq
a0fs+WgRYevmHk7Dx4mQ4oA=
=wrbo
-----END PGP SIGNATURE-----