[commit: ghc] master: Provide a utility to check API Annotations docs (c3b0215)

Sun Nov 1 09:46:57 UTC 2015

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/c3b02150b516963422ed4b9b200a38814a35b535/ghc

>---------------------------------------------------------------

commit c3b02150b516963422ed4b9b200a38814a35b535
Author: Alan Zimmerman <alan.zimm at gmail.com>
Date:   Sun Nov 1 10:18:25 2015 +0100

    Provide a utility to check API Annotations docs

    A utility to check API Annotations was provided in
    https://git.haskell.org/ghc.git/commitdiff/43751b2436f370d956d8021b3cdd3
    eb77801470b

    This commit had poor documentation.

    This patch improves the output generated by the utility as well as
    supplying better documentation

    Test Plan: ./validate

    Reviewers: simonpj, austin, bgamari

    Reviewed By: austin, bgamari

    Subscribers: thomie, mpickering

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

    GHC Trac Issues: #10917

>---------------------------------------------------------------

c3b02150b516963422ed4b9b200a38814a35b535
 compiler/parser/Parser.y                           |   5 +
 testsuite/tests/ghc-api/annotations/Makefile       |   3 +-
 testsuite/tests/ghc-api/annotations/T10255.stdout  |  57 +-
 testsuite/tests/ghc-api/annotations/T10268.stdout  |  81 +--
 testsuite/tests/ghc-api/annotations/T10269.stdout  |  51 +-
 testsuite/tests/ghc-api/annotations/T10278.stdout  | 252 +++----
 testsuite/tests/ghc-api/annotations/T10280.stdout  |  54 +-
 testsuite/tests/ghc-api/annotations/T10307.stdout  |  52 +-
 testsuite/tests/ghc-api/annotations/T10309.stdout  |  55 +-
 testsuite/tests/ghc-api/annotations/T10312.stdout  | 729 +++++++--------------
 testsuite/tests/ghc-api/annotations/T10354.stdout  | 129 ++--
 testsuite/tests/ghc-api/annotations/T10357.stdout  | 162 ++---
 testsuite/tests/ghc-api/annotations/T10358.stdout  |  84 +--
 testsuite/tests/ghc-api/annotations/T10396.stdout  |  60 +-
 testsuite/tests/ghc-api/annotations/T10399.stdout  | 225 +++----
 .../tests/ghc-api/annotations/boolFormula.stdout   | 335 ++++------
 .../tests/ghc-api/annotations/exampleTest.stdout   | 231 +++----
 utils/check-api-annotations/Main.hs                |  34 +-
 utils/check-api-annotations/README                 |  85 +++
 19 files changed, 974 insertions(+), 1710 deletions(-)

Diff suppressed because of size. To see it, use:

    git diff-tree --root --patch-with-stat --no-color --find-copies-harder --ignore-space-at-eol --cc c3b02150b516963422ed4b9b200a38814a35b535