On Tue, Apr 27, 2010 at 7:58 AM, Alan Coopersmith <[email protected]> wrote: > Gaetan Nadon wrote: >> The root cause is simple: not all platforms have the tools to generate >> the docs. There maybe a solution: unlike executable code, docs do not >> need to be built on all platforms. A "doc only" tarball could be >> produced and posted like any other package. > > The long term solution we've desired for other reasons is to reduce the > number of documentation formats we use and tools we require. We've long > ago said (at least informally) that we consider LinuxDoc deprecated and > that it's still in our tree only because no one has had the time to translate > those documents to DocBook. When X.Org first started we had planned on > standardizing on DocBook/XML, though more recently there have been suggestions > toward standardizing on something more user friendly like AsciiDoc that can > be translated to DocBook and thus output the desired end results (.txt, .html, > .pdf) via the same tools.
FWIW, I've been poking at converting the linuxdoc sources in the server to docbook xml. There are only 3 of them, but dmx.sgml and DESIGN.sgml are large documents. The formats are similar, but it's a pretty manual process (especially since linuxdoc allows lots of behavior that's not valid xml). If anyone knows any automatic translators from linuxdoc to docbook, let me know. -- Dan _______________________________________________ [email protected]: X.Org development Archives: http://lists.x.org/archives/xorg-devel Info: http://lists.x.org/mailman/listinfo/xorg-devel
