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