<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN">
<HTML>
<HEAD>
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8">
  <META NAME="GENERATOR" CONTENT="GtkHTML/3.26.0">
</HEAD>
<BODY>
On Sat, 2010-05-15 at 22:39 +0200, R&#233;mi Cardona wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
Le 14/05/2010 22:50, Gaetan Nadon a &#233;crit :
&gt; The linuxdoc doc tool is deprecated.
&gt; README files are exclusively text files.
&gt; 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?

</PRE>
</BLOCKQUOTE>
I have been asking my self that question and counting on this review for opinions. What tipped the balance (for me):<BR>
<BR>
- The drivers appear not to be under development, so the file gets rarely changed<BR>
- The file is almost all plain text (little or no formatting) except for the generated toc.<BR>
- Plain text is acceptable for a README file<BR>
- docbook sgml is also a deprecated format. Conversion to Docbook xml is not straightforward.<BR>
<BR>
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.<BR>
<BR>
<TABLE CELLPADDING="0">
<TR>
<TH NOWRAP ALIGN="right" VALIGN="top">
<B>From:&nbsp;</B>
</TH>
<TD>
Alan Coopersmith &lt;<A HREF="mailto:Alan%20Coopersmith%20%3cAlan.Coopersmith@Sun.COM%3e">Alan.Coopersmith@Sun.COM</A>&gt;
</TD>
</TR>
<TR>
<TH NOWRAP ALIGN="right" VALIGN="top">
<DIV ALIGN=right><B>To:&nbsp;</B></DIV>
</TH>
<TD>
X.Org Developers &lt;<A HREF="mailto:%22X.Org%20Developers%22%20%3cxorg-devel@lists.x.org%3e">xorg-devel@lists.x.org</A>&gt;
</TD>
</TR>
<TR>
<TH NOWRAP ALIGN="right" VALIGN="top">
<B>Subject:&nbsp;</B>
</TH>
<TD>
X.Org documentation formats, plans, conversions, etc.
</TD>
</TR>
<TR>
<TH NOWRAP ALIGN="right" VALIGN="top">
<DIV ALIGN=right><B>Date:&nbsp;</B></DIV>
</TH>
<TD>
Tue, 10 Nov 2009 21:40:32 -0800 <I>(Wed, 00:40 EST)</I>
</TD>
</TR>
</TABLE>
<BLOCKQUOTE>
<PRE>
<TT><FONT COLOR="#1a1a1a">At this point, these are the documentation input and output formats I know of:</FONT></TT>

<TT><FONT COLOR="#1a1a1a">Preferred output formats:</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - man pages for commands and public API in client-side libraries,</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;to be installed in $(mandir)</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - plain text, html &amp; pdf for specifications and other documents,</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;to be installed in $(docdir) &amp; published on the website</FONT></TT>

<TT><FONT COLOR="#1a1a1a">Preferred input formats:</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - DocBook/XML (can generate man, text, html &amp; pdf)</FONT></TT>

<TT><FONT COLOR="#1a1a1a">Acceptable input formats:</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - AsciiDoc (can generate DocBook, thus all DocBook supports)</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - Plain text</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - man pages in troff -man format</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - doxygen comments in source code</FONT></TT>

<TT><FONT COLOR="#1a1a1a">Deprecated input formats (no new docs should be added in these):</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - troff -ms/-mm</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - FrameMaker</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - LinuxDoc</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - DocBook/SGML</FONT></TT>
<TT><FONT COLOR="#1a1a1a">&nbsp; - TeX</FONT></TT>
</PRE>
</BLOCKQUOTE>
<BR>
<BLOCKQUOTE TYPE=CITE>
<PRE>
Cheers,

R&#233;mi
_______________________________________________
<A HREF="mailto:xorg-devel@lists.x.org">xorg-devel@lists.x.org</A>: X.Org development
Archives: <A HREF="http://lists.x.org/archives/xorg-devel">http://lists.x.org/archives/xorg-devel</A>
Info: <A HREF="http://lists.x.org/mailman/listinfo/xorg-devel">http://lists.x.org/mailman/listinfo/xorg-devel</A>
</PRE>
</BLOCKQUOTE>
</BODY>
</HTML>