[GHC] #9294: More exports and documentation for GHC API Parser Module

[GHC]

#9294: More exports and documentation for GHC API Parser Module
------------------------------------+-------------------------------------
       Reporter:  agibiansky        |             Owner:  agibiansky
           Type:  feature request   |            Status:  new
       Priority:  normal            |         Milestone:
      Component:  GHC API           |           Version:  7.8.2
       Keywords:                    |  Operating System:  Unknown/Multiple
   Architecture:  Unknown/Multiple  |   Type of failure:  None/Unknown
     Difficulty:  Unknown           |         Test Case:
     Blocked By:                    |          Blocking:
Related Tickets:                    |
------------------------------------+-------------------------------------
 I would like to be able to use the GHC API for parsing. Right now this is
 in the Parser and Lexer modules:

 Parser:
 http://www.haskell.org/ghc/docs/7.8.2/html/libraries/ghc-7.8.2/Parser.html
 Lexer:
 http://www.haskell.org/ghc/docs/7.8.2/html/libraries/ghc-7.8.2/Lexer.html

 GHC currently exposes only a few parsers here. I'd like to make a few
 modifications:

 1. Expose a few more parsers than currently are exposed in the Parser
 module. In particular, I'd like import statements, type signatures,
 declarations, and expressions, at least, in addition to what's already
 there.

 2. Add some Haddock documentation to the top of the Parser module
 describing how to use it, since the types themselves are pretty opaque
 here.

 3. Export a clean and self-contained parsing API from the GHC module.

 See minor discussion here:
 http://comments.gmane.org/gmane.comp.lang.haskell.ghc.devel/4791

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