[GHC] #10917: Provide a utility to check API Annotations

[GHC]

#10917: Provide a utility to check API Annotations
-------------------------------------+-------------------------------------
        Reporter:  alanz             |                Owner:  alanz
            Type:  bug               |               Status:  patch
        Priority:  normal            |            Milestone:  8.0.1
       Component:  Compiler          |              Version:  7.10.2
      Resolution:                    |             Keywords:
                                     |  ApiAnnotations
Operating System:  Unknown/Multiple  |         Architecture:
                                     |  Unknown/Multiple
 Type of failure:  None/Unknown      |            Test Case:
      Blocked By:                    |             Blocking:
 Related Tickets:                    |  Differential Rev(s):  Phab:D1368
       Wiki Page:                    |
-------------------------------------+-------------------------------------

Comment (by Ben Gamari <ben@…>):

 In [changeset:"43751b2436f370d956d8021b3cdd3eb77801470b/ghc" 43751b2/ghc]:
 {{{
 #!CommitTicketReference repository="ghc"
 revision="43751b2436f370d956d8021b3cdd3eb77801470b"
 Provide a utility to check API Annotations

 It is difficult for GHC developers to know if they have broken the API
 Annotations.

 This patch provides a utility that can be used as a test to show up
 errors in the API Annotations.

 It is based on the current tests for ghc-api/annotations which can parse
 a file using the just-built GHC API, and check that no annotations are
 disconnected from the ParsedSource in the output.

 In addition, it should be able to dump the annotations to a file, so a
 new feature developer can check that all changes to the parser do
 provide annotations.

 Trac ticket: #10917

 Test Plan: ./validate

 Reviewers: hvr, thomie, austin, bgamari

 Reviewed By: bgamari

 Differential Revision: https://phabricator.haskell.org/D1368

 GHC Trac Issues: #10917
 }}}

--
Ticket URL: <http://ghc.haskell.org/trac/ghc/ticket/10917#comment:3>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler