2009/6/7 Dominic Steinitz <domi...@steinitz.org>:
> Ha! It's yet another of haddock's quirks. If I replace -- ^ by -- then haddock
> accepts {-#. I'll update the ticket you created.
>
> -- | The parse state
> data S = S {-# UNPACK #-} !BL.ByteString  -- ^ input
>           {-# UNPACK #-} !Int  -- ^ bytes read
>           {-# UNPACK #-} ![B.ByteString]
>           {-# UNPACK #-} !Int  -- ^ the failure depth
>
> -- | The parse state
> data S = S {-# UNPACK #-} !BL.ByteString  -- input
>           {-# UNPACK #-} !Int  -- bytes read
>           {-# UNPACK #-} ![B.ByteString]
>           {-# UNPACK #-} !Int  -- the failure depth

Haddock doesn't actually support comments on individual constructor
arguments. People often get confused by this, and the error message
isn't especially useful. We have a ticket for giving better error
messages:

  http://trac.haskell.org/haddock/ticket/94

We also have a ticket about the feature itself:

  http://trac.haskell.org/haddock/ticket/95

David
_______________________________________________
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe

Reply via email to