Re: [Haskell-cafe] Problem with haddock - it dislikes my comments

28 Feb 2009

      ...
...
...
...
...
"Colin" == Colin Paul Adams  writes:
...
...
...
...
...
"Gwern" == Gwern Branwen  writes:
    Gwern> On Sat, Feb 28, 2009 at 2:59 PM, Colin Paul Adams
    Gwern>  wrote:
    >>> Having just read the Haddock manual , I am haddocking (may I
    >>> copyleft that verb?) my code.
    >>> 
    >>> But half-way through this data type, I discover that haddock
    >>> rejects my non-haddock comments, although GHC is fine:
>>> How can I document the components of each constructor?

    Gwern> http://trac.haskell.org/haddock/ticket/60 ?

    Colin> That seems to be a different bug - my haddock comments are
    Colin> accepted fine - it's the plain Haskell ones (no ^) that it
    Colin> complains about as a parse error. 

No, I'm wrong - it does seem to be the same problem.

Since the ticket has been downgraded to a minor problem, it seems the
Haddock team doesn't want to allow documentation of components, except
when they are named fields.
-- 
Colin Adams
Preston Lancashire