On 11 November 2005 15:48, Bulat Ziganshin wrote:
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?
We already use DocBook XML, and I'm relatively pleased with it, except for the fact that it's far from easy to set up a working DocBook toolchain on your system unless your OS of choice is up to date and has 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?
You can either author in DocBook XML directly, or send us chunks of plain text and we'll do the markup for you (obviously we prefer the former, though). Cheers, Simon