[Haskell-cafe] Haddock multiple definitions

[jabolopes at google.com]

Hi,

I cannot find a similar ticket, so it seems that no one has filed this
issue before.  As a general comment, I think this issue is a good
example that perhaps docstrings should go in the AST.

In any case, I would ask someone with a trac account in Haddock to
submit this ticket for me.  I apologize for the inconvenience, but,
for privacy concerns, I don't want an account in Haddock trac and it
does not seem possible to submit a ticket without first creating one.

Thanks,
Jose

On Fri, Aug 16, 2013 at 12:51:35AM +0300, Roman Cheplyaka wrote:
> In any case, it shouldn't fail with a parse error, since this is valid
> Haskell.
> 
> Please file a ticket at http://trac.haskell.org/haddock (but first see
> if it hasn't been reported before).
> 
> Roman
> 
> * jabolopes at google.com <jabolopes at google.com> [2013-08-15 15:24:23-0400]
> > Hi,
> > 
> > I am using
> > 
> >   GHC: 6.12.1
> >   Haddock: 2.6.0
> > 
> > and the following does not work with Haddock (GHC is fine!):
> > 
> >   -- Main
> > 
> >   -- | Blah blah blah
> >   (x, y, z) = (1, 2, 3)
> > 
> > $ haddock ...
> > /tmp/Main.hs:2:0: parse error on input `('
> > 
> > 
> > Is this a bug? Or it's just not part of Haddock?
> > 
> > 
> > This seems like an interesting feature to document several definitions
> > together, for example, error codes:
> > 
> > -- | Syscall error codes for blah...
> > --
> > -- errA when blah
> > -- ...
> > (errA, errB, errC) = ...
> > 
> > Cheers,
> > Jose
> > 
> > _______________________________________________
> > Haskell-Cafe mailing list
> > Haskell-Cafe at haskell.org
> > http://www.haskell.org/mailman/listinfo/haskell-cafe