Doclifter and xorg-docs

[Peter Hutterer]

On Sun, Jun 15, 2008 at 10:33:58PM -0400, François-Denis Gonthier wrote:
> I've been playing around with trying to convert X11.protocol to
> docbook using doclifter.  My inexperience with troff is hurting me
> quite a bit, but xorg-docs seems to be missing the information how to
> rebuild the stuff that is in hardcopy.  I think knowing how the
> document is generated would help me better understand the process need
> to convert the protocol doc to docbook.
> 
> Is there anyone who can provide me with that missing information?

It's a bit of a try-and-error process.
Run doclifter, remove or alter the markup it complains about until it spits
out an xml file.
Try to convert the xml file by running "xmlto pdf protocol.xml", fix up the
xml until it succeeds.
Finally, go through the xml file by hand and remove the wrong conversions and
replace them with something more appropriate.

If you do a git log in xorg-docs, you can have a look at the steps I did to
convert the X input protocol, pretty much as described above.

Cheers,
  Peter