Volunteering to assist with documentation docbook conversion.

Michael Verret michael.verret at gmail.com
Thu May 22 07:57:31 PDT 2008


> I did a couple man pages, and Eamon & Peter have done a couple larger docs.
> For examples of what we did, see:
>        lib/libXcomposite/man/   (but note bug #12725)
>        lib/libXtst/man/
>        doc/xorg-docs/sgml/core/Xserver-spec.sgml
>        doc/xorg-docs/specs/Xi/protocol.xml
>
> Obviously it would be good to establish some conventions for consistency
> (sgml or xml for instance).

Before I go too far, which do you prefer? My first instinct is XML.

> --
>        -Alan Coopersmith-           alan.coopersmith at sun.com
>         Sun Microsystems, Inc. - X Window System Engineering

That should be very helpful. Thanks.

> Just go for it. AFAIK, doc conversion is mostly done on a need+time basis, so
> you might be the only one working on it right now.
>
> As for the patches, I think it might be best if you attach them to a
> bugreport
> on bugs.freedesktop.org. This way there's a central place where we can find
> them and push them into the repositories.
>
> Cheers,
>  Peter

Consistency is wonderful, bugs.freedesktop.org is good.

Michael



More information about the xorg mailing list