This might be a nice way of generating wxWidgets docs in all kinds of formats. The idea is: 1) manually convert some of the wx reference manual to docbook 2) automatically convert the class stuff to docbook (xml2docbook.xsl) 3) use docbook tools to generate html, pdf, chm, etc. == Step 1: Manually converting some of the wxWidgets reference manual == 1.1 Export to HTML (todo) 1.2 Hand-convert HTML to XML (todo, result should be inserted into xml2docbook.xsl) == Step 2: automatically convert the class stuff to docbook == 2.1 write xml2docbook.xsl (work done, not finished) == Step 3: use docbook tools to generate html, pdf, chm, etc. == using docbook2* tools (which are jade wrappers) TODO: references need page numbers. === 3.x generating htmlhelp (with wine) === (see also: www.codeproject.com/winhelp/docbook_howto.asp) * download the htmlhelp package from http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp * unpack it by running it with wine * when it complains about a DLL, use `lsof' to find out which temporary directory it was using, and copy the extracted files to a safe place (they get removed when the program terminates). * xslt /foo/bar/htmlhelp.xsl wxdocs.xml * wine hhc.exe htmlhelp.hhp