[Haskell-cafe] Haddock chokes on function arguments

Arnaud Bailly arnaud.oqube at gmail.com
Thu Aug 25 16:25:20 CEST 2011

while trying to generate Haddock documentation (Haddock version 2.9.2, (c)
Simon Marlow 2006), it chokes on the following fragment

-- |Apply a given function over all elements of a list and select one of the
-- results.
selector :: (Arbitrary b) =>
            [a]      -> -- ^ Elements to select from
            (a -> b) -> -- ^ Constructor to apply to selected element
            Gen b
selector list ctor = oneof (map (return . ctor) list)

with the following error message:

'   parse error on input `-- ^ Elements to select from

I am puzzled as this is exactly how arguments are supposed to be documented,
according to http://www.haskell.org/haddock/doc/html/ch03s02.html#id565220

Any clues ?

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20110825/ac748af7/attachment.htm>

More information about the Haskell-Cafe mailing list