<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>On 30 May 2011, at 20:13, Alan Coopersmith wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>Yes - SolBook is still used as the source markup, from which the nroff output<br>is generated for man pages in the OS, and the html & pdf output for the site<br>formerly known as <a href="http://docs.sun.com">docs.sun.com</a>. The DTD is in the ON gate/packages - see<br>/usr/share/lib/sgml/locale/C/dtds/solbookv2 from pkg:/text/doctools .<br><br>For what it's worth, most of the html/pdf/txt docs on<br><span class="Apple-tab-span" style="white-space:pre"> </span><a href="http://www.x.org/releases/X11R7.6/doc/">http://www.x.org/releases/X11R7.6/doc/</a><br>were generated from Docbook/XML on a Solaris 11 Express machine, though I did<br>have to install a couple extra open source packages that aren't currently<br>in any of the consolidations/package repos:<br><span class="Apple-tab-span" style="white-space:pre"> </span>https://fedorahosted.org/xmlto/<br><span class="Apple-tab-span" style="white-space:pre"> </span>http://xmlgraphics.apache.org/fop/<br>as well as updating to a slightly newer version of the Docbook style sheets<br>than the JDS consolidation currently packages.<br><br>Personally, I just use emacs to edit docbook files, but I do the same for<br>html too, never having found (or looked that hard for) a more user-friendly<br>front end editor.<br></div></blockquote></div><br><div>Tales from the trenches are extremely helpful, thanks, Alan. I did a little searching around, trying to get a sense of how people who were maintaining documentation for large project, either as developers or as tech writers saw the state of the art. Here's a fairly random sample, which also provides some incidental name-dropping to give a sense of where different formats are being used:</div><div><br></div><div><a href="http://www.scons.org/wiki/DeveloperGuide/Documentation/Discussion">http://www.scons.org/wiki/DeveloperGuide/Documentation/Discussion</a></div><div><a href="http://freerangelibrarian.com/2009/06/07/docbook-xml-and-homebrew/">http://freerangelibrarian.com/2009/06/07/docbook-xml-and-homebrew/</a></div><div><a href="http://lethargy.org/~jesus/writes/xmlxslt-and-docbook-for-docs">http://lethargy.org/~jesus/writes/xmlxslt-and-docbook-for-docs</a></div><div><a href="http://blog.raspberry.nl/2011/04/12/documentation/">http://blog.raspberry.nl/2011/04/12/documentation/</a></div><div><a href="http://ffeathers.wordpress.com/2009/05/18/scroll-converts-wiki-to-docbook-and-pdf/">http://ffeathers.wordpress.com/2009/05/18/scroll-converts-wiki-to-docbook-and-pdf/</a></div><div><a href="https://docs.jboss.org/author/display/AUTHGUIDE/How+to+release+documentation">https://docs.jboss.org/author/display/AUTHGUIDE/How+to+release+documentation</a></div><div><a href="http://www.dmncommunications.com/weblog/?p=199">http://www.dmncommunications.com/weblog/?p=199</a></div><div><a href="http://lists.cs.uiuc.edu/pipermail/llvmdev/2010-August/034044.html">http://lists.cs.uiuc.edu/pipermail/llvmdev/2010-August/034044.html</a></div><div><a href="http://mark-story.com/posts/view/generating-documentation-with-sphinx">http://mark-story.com/posts/view/generating-documentation-with-sphinx</a></div><div><br></div><div>If anyone else has some points of reference that speak to what's worked for whom where, please share.</div></body></html>