Hello Simon, Friday, November 11, 2005, 5:51:55 PM, you wrote:
* The GHC user manual [currently generated using DocBook]
I think it should continue to be written in DocBook. (It should switch to DocBook XML if it's still using SGML DocBook.) XML documents are "type-safe" in contrast to LaTeX documents, for example. XML is well supported. DocBook stresses logical markup and allows very specific markup and therefore supports conversion into different formats (HTML, PDF, ...) very well. Again, what do others think?
SM> We already use DocBook XML, and I'm relatively pleased with it, except SM> for the fact that it's far from easy to set up a working DocBook SM> toolchain on your system unless your OS of choice is up to date and has SM> a well-maintained set of DocBook packages. how it will be possible to contribute in ghc docs? for example, if i wrote template haskell doc in MS Word, can i fo somethong to make it ready to including in ghc docs? -- Best regards, Bulat mailto:bulatz@HotPOP.com