[PATCH RFC] protocol: add xslt stylesheet to prettify the protocol

Michael Hasselmann michaelh at openismus.com
Thu Feb 23 03:51:58 PST 2012


On Thu, 2012-02-23 at 21:20 +1000, Peter Hutterer wrote:
> On 23/02/12 19:57 , Tiago Vignatti wrote:
> > On 02/23/2012 07:58 AM, Peter Hutterer wrote:
> >> Includes rudimentary styling only.
> >>
> >> Signed-off-by: Peter Hutterer<peter.hutterer at who-t.net>
> >> ---
> >> A few things to note:
> >> - I'm not a designer
> >> - Having a html version of the protocol makes it a lot easier to read,
> >> and
> >> it certainly reveals missing bits of documentation in the protocol
> >> - the .css file is the one from wayland.freedesktop.org, someone could
> >> easily fix it to prettify the result a bit.
> >
> > I concur we need a prettier way to read the protocol. But what do you
> > think about the idea of dumping the whole protocol in a separate section
> > of main.tex instead?
> 
> largely depends on what you expect the canonical source to be. shouldn't 
> be that hard to knock up another xslt that converts the xml into latex.

I would prefer HTML over Latex. Especially if the resulting HTML is
hosted as some form of online documentation.

regards,
Michael



More information about the wayland-devel mailing list