• Alan Zimmerman's avatar
    API Annotations documentation update, parsing issue, add example test · 851ed721
    Alan Zimmerman authored
    Summary:
    Add a reference note to each AnnKeywordId haddock comment so GHC
    developers will have an idea why they are there.
    
    Add a new test to ghc-api/annotations to serve as a template for other
    GHC developers when they need to update the parser. It provides output
    which checks that each SrcSpan that an annotation is attached to
    actually appears in the `ParsedSource`, and lists the individual
    annotations. The idea is that a developer writes a version of this
    which parses a sample file using whatever syntax is changed in
    Parser.y, and can then check that all the annotations come through.
    
    Depends on D538
    
    Test Plan: ./validate
    
    Reviewers: simonpj, hvr, austin
    
    Reviewed By: austin
    
    Subscribers: thomie, jstolarek
    
    Differential Revision: https://phabricator.haskell.org/D620
    851ed721
BasicTypes.hs 37.8 KB