Note [Api annotations]

Alan & Kim Zimmerman alan.zimm at
Wed Jul 20 12:50:12 UTC 2016

Hopefully at a future date they will be a part of the AST itself, so this
will be clearer.

In reality, looking at Parser.y is not enough, as there are some workings
in RdrHsSyn.hs too, and the process of attachment in Parser.y is sometimes
quite complex.

Basically the best reference is indeed ghc-exactprint, being an application
that expressly makes use of all of them.


On Wed, Jul 20, 2016 at 2:01 PM, Matthew Pickering <
matthewtpickering at> wrote:

> On Wed, Jul 20, 2016 at 12:22 PM, Ben Gamari <ben at> wrote:
> > Matthew Pickering <matthewtpickering at> writes:
> >
> >> These comments are meant to indicate which annotations each AST
> >> fragment has. However, they are rarely kept up to date and ultimately
> >> not that useful. If someone wants to
> >> know then it is easier to look at the `Annotate` module in
> >> `ghc-exactprint`where this information also exists programatically.
> >>
> > Hmm, the fact that this module is outside of GHC is a bit unfortunate.
> > If I'm looking at a random GHC commit from a year ago how am I to know
> > which annotations I can expect? I guess the testsuite?
> The only reliable way is to look at `Parser.y`.
> >
> > Cheers,
> >
> > - Ben
> >
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <>

More information about the ghc-devs mailing list