Very cool! It did a surprisingly good job. But, not perfect -- I also noticed quite a few formatting problems:
1) The sections are in scrambled (non-book) order. This might not be a problem in the future, as some docs may move away from the use of transitive text (e.g. "The following chapters..."), but it's definitely something we'd need to fix in the short term. 2) Many problems with indentation in mono-spaced examples. 3) Shading is missing in many places. 4) We'd want to get better control over the headers and footers (e.g. "This page last changed on Feb 28, 2008 by neuron" and "Document generated by Confluence on Mar 04, 2008 13:57"). Those are great for a Wiki, but not so great for a printed manual. 5) Generally, if we want to replace the existing toolchain, we'd need some way to get to a "professional" level of PDF. The Confluence PDF outputter is good, but it needs to get all the way there, I think. 6) In the long run, and this is still an open issue, we probably want to get all the Wiki-based OpenSolaris materials to an OpenSolaris Wiki, rather than continuing to leverage Sun's wikis.sun.com. When OpenSolaris gets its Wiki, it might or might not be Confluence. Mike This message posted from opensolaris.org
