Haddock fails on ConfigFile, but why?

Would love to get some help on making Haddock accept ConfigFile[1]. The error message is about as far from helpful as you can get ;) dist/build/tmp-15743/src/Data/ConfigFile/Monadic.hs:34:1: parse error on input `import' The author is informed but is as confused as me, it seems[2]. /M [1] http://hackage.haskell.org/package/ConfigFile [2] https://github.com/jgoerzen/configfile/issues/4 -- Magnus Therning OpenPGP: 0xAB4DFBA4 email: magnus@therning.org jabber: magnus@therning.org twitter: magthe http://therning.org/magnus Most software today is very much like an Egyptian pyramid with millions of bricks piled on top of each other, with no structural integrity, but just done by brute force and thousands of slaves. -- Alan Kay

On 22 October 2011 08:49, Magnus Therning
Would love to get some help on making Haddock accept ConfigFile[1]. The error message is about as far from helpful as you can get ;)
dist/build/tmp-15743/src/Data/ConfigFile/Monadic.hs:34:1: parse error on input `import'
The author is informed but is as confused as me, it seems[2].
Have you tried removing bits from that comment that precedes that line to try and track down where it's going wrong? -- Ivan Lazar Miljenovic Ivan.Miljenovic@gmail.com IvanMiljenovic.wordpress.com

On Friday 21 October 2011, 23:49:45, Magnus Therning wrote:
Would love to get some help on making Haddock accept ConfigFile[1]. The error message is about as far from helpful as you can get ;)
dist/build/tmp-15743/src/Data/ConfigFile/Monadic.hs:34:1: parse error on input `import'
The author is informed but is as confused as me, it seems[2].
/M
[1] http://hackage.haskell.org/package/ConfigFile [2] https://github.com/jgoerzen/configfile/issues/4
It may be that haddock requires the comments to be indented, or at least the bird-tracke code blocks.

On Friday 21 October 2011, 23:49:45, Magnus Therning wrote:
Would love to get some help on making Haddock accept ConfigFile[1]. The error message is about as far from helpful as you can get ;)
dist/build/tmp-15743/src/Data/ConfigFile/Monadic.hs:34:1: parse error on input `import'
The author is informed but is as confused as me, it seems[2].
Okay, a bit of experimentation showed that the imports must come before the haddock comment section $overview. Whether it's a haddock bug, or a feature request for haddock to handle such situations, I don't know. Cheers, Daniel

On Sat, Oct 22, 2011 at 12:50:48AM +0200, Daniel Fischer wrote:
On Friday 21 October 2011, 23:49:45, Magnus Therning wrote:
Would love to get some help on making Haddock accept ConfigFile[1]. The error message is about as far from helpful as you can get ;)
dist/build/tmp-15743/src/Data/ConfigFile/Monadic.hs:34:1: parse error on input `import'
The author is informed but is as confused as me, it seems[2].
Okay, a bit of experimentation showed that the imports must come before the haddock comment section $overview.
Whether it's a haddock bug, or a feature request for haddock to handle such situations, I don't know.
Thanks for taking your time to find this out. I've passed on the information to the author. /M -- Magnus Therning OpenPGP: 0xAB4DFBA4 email: magnus@therning.org jabber: magnus@therning.org twitter: magthe http://therning.org/magnus I invented the term Object-Oriented, and I can tell you I did not have C++ in mind. -- Alan Kay
participants (3)
-
Daniel Fischer
-
Ivan Lazar Miljenovic
-
Magnus Therning