Note [Api annotations]

[Alan & Kim Zimmerman]

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.

Alan

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

> On Wed, Jul 20, 2016 at 12:22 PM, Ben Gamari <ben at smart-cactus.org> wrote:
> > Matthew Pickering <matthewtpickering at gmail.com> 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: <http://mail.haskell.org/pipermail/ghc-devs/attachments/20160720/469d6ed2/attachment.html>