[Haskell] Making Haskell more open

Simon Marlow simonmar at microsoft.com
Fri Nov 11 11:11:51 EST 2005

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).


More information about the Haskell mailing list