[jhc] improved jhc manual

John Meacham john at repetae.net
Wed Jun 4 01:29:26 UTC 2014


Hi all, I just wanted to show off the new jhc manual
http://repetae.net/computer/jhc/manual.html

If anyone has any feedback, that would be great, even better would be
patches of course :) Manual writing is not my strong point.

The entire manual is in the darcs repo as markdown formatted files or
as literate code embedded in the source files.

Something I need to figure out is how to get haddock to not barf on
jhc's input files. A problem with haddock is that it tries to
replicate ghc's module chasing algorithm and falls down when anything
is slightly off, jhc's ability to handle recursive modules throws it
for a loop. Now I can easily get jhc to spit out fully resolved module
names, it does so with the --annotate-source option, but need some
sort of hook into haddock saying "don't try to resolve module names,
here they all are."

Even haddock just having a 'keep going' option would be great to get
something out there. Or even improving haddock to handle recursive
module imports.

    John

-- 
John Meacham - http://notanumber.net/


More information about the jhc mailing list