Hello friendly GHCers, Last week I sent out poll asking opinions on moving the Users' Guide From Docbook to ReStructuredText. While the response wasn't particularly large in volume, those that did reply were quite supportive of the idea.
This week I took the time to clean up my hacked prototype. After quite
some build system wrangling, it's finally in a merge-worthy state as
D1294. You can see the output at,
http://smart-cactus.org/~ben/ghc-users-guide/html/index.html
http://smart-cactus.org/~ben/ghc-users-guide/users_guide.pdf
In addition to converting the DocBook to ReST, this also involved
ripping out the previously rather fragile system for building the `ghc`
manpage and describing GHC's flags in utils/mkUserGuidePart.
Feel free to look over the output. If there are no objections I'll
merge this tomorrow.
Future Work
-----------
* Verify the flag description in mkUserGuidePart against DynFlags
(checking for missing or invalid flags)
* Perhaps incorporate make flags representation a bit richer, encoding,
for instance, implication relationships between flags
* Generate flag descriptions for bash_completion and other shells
* Improve manpage content
* Be more precise about which code samples should be syntax highlighted
Cheers,
- Ben
signature.asc
Description: PGP signature
_______________________________________________ ghc-devs mailing list [email protected] http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
