
Hi, GHC team The current GHC documentation is written using SGML with DocBook DTD and DSSL stylesheet. I tried to translate GHC users guide from SGML to XML and now I have XML-ised user guide with just few syntactic changes. The rewritten documentation can be translated to HTML using just a standard xsltproc tool (available for both Cygwin & Linux) and XSLT DocBook stylesheet. The main advantage of XML version is that there is already developed XSLT stylesheet which generates input for Microsoft HTML Help Compiler. The GTK development team was already developed stylesheet for DevHelp. Advantages of HTML Help browser and DevHelp are that both supports useful search engine. Haddock also has already developed HTML Help output and can be easy extended to generate .devhelp index file. I think that this will made GHC documentation much more easy for reading and browsing. Krasimir __________________________________________________ Do you Yahoo!? Yahoo! Mail Plus - Powerful. Affordable. Sign up now. http://mailplus.yahoo.com

Hi all.
The rewritten documentation can be translated to HTML using just a standard xsltproc tool (available for both Cygwin & Linux) and XSLT DocBook stylesheet. The main advantage of XML version is that there is already developed XSLT stylesheet which generates input for Microsoft HTML Help Compiler. ... I think that this will made GHC documentation much more easy for reading and browsing.
I would strongly support such a change. As an aside to you, Krasimir, I would like to say thanks for the great work you did this year on the Object-IO library which I use a lot when programming with GHC. Cheers Mike Thomas.
participants (2)
-
Krasimir Angelov
-
Mike Thomas