[PATCH input-mouse 13/14] README: keep the text version of README, discard the sgml version
Gaetan Nadon
memsize at videotron.ca
Sun May 16 13:15:37 PDT 2010
On Sat, 2010-05-15 at 22:39 +0200, Rémi Cardona wrote:
> Le 14/05/2010 22:50, Gaetan Nadon a écrit :
> > The linuxdoc doc tool is deprecated.
> > README files are exclusively text files.
> > The file had not been updated for 5 years.
>
> Is that file worth keeping and maybe converting to docbook like Alan did
> for the internal server doc?
>
I have been asking my self that question and counting on this review for
opinions. What tipped the balance (for me):
- The drivers appear not to be under development, so the file gets
rarely changed
- The file is almost all plain text (little or no formatting) except for
the generated toc.
- Plain text is acceptable for a README file
- docbook sgml is also a deprecated format. Conversion to Docbook xml is
not straightforward.
If we want to retain the marked-up source, I would put it (renamed) in
a /doc and have it installed. I don't like the current manual
half-generated half-git solution.
From:
Alan Coopersmith
<Alan.Coopersmith at Sun.COM>
To:
X.Org Developers
<xorg-devel at lists.x.org>
Subject:
X.Org documentation formats, plans,
conversions, etc.
Date:
Tue, 10 Nov 2009 21:40:32 -0800
(Wed, 00:40 EST)
At this point, these are the documentation input and output formats I know of:
Preferred output formats:
- man pages for commands and public API in client-side libraries,
to be installed in $(mandir)
- plain text, html & pdf for specifications and other documents,
to be installed in $(docdir) & published on the website
Preferred input formats:
- DocBook/XML (can generate man, text, html & pdf)
Acceptable input formats:
- AsciiDoc (can generate DocBook, thus all DocBook supports)
- Plain text
- man pages in troff -man format
- doxygen comments in source code
Deprecated input formats (no new docs should be added in these):
- troff -ms/-mm
- FrameMaker
- LinuxDoc
- DocBook/SGML
- TeX
> Cheers,
>
> Rémi
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20100516/5b7dc17a/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20100516/5b7dc17a/attachment.pgp>
More information about the xorg-devel
mailing list