Note [Api annotations]

[Matthew Pickering]

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
>