[GHC] #5469: Reorganisation of exports in template-haskell library

[GHC]

#5469: Reorganisation of exports in template-haskell library
---------------------------------+------------------------------------------
    Reporter:  reinerp           |        Owner:              
        Type:  task              |       Status:  new         
    Priority:  normal            |    Milestone:              
   Component:  Template Haskell  |      Version:  7.2.1       
    Keywords:                    |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Unknown/Multiple  |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------

Comment(by reinerp):

 Fair enough.

 Do you propose the same for {{{TH.Lib}}}? That is, export everything from
 {{{TH.Lib}}}, and enumerate the exports explicitly in {{{TH}}}?

 I say we move the notes ({{{$unresolvedinfix}}}, etc) out of
 {{{TH.Syntax}}} and into {{{TH}}}. The reason for this is to encourage
 users to read the documentation for {{{TH}}}, and not send them away to
 {{{TH.Syntax}}} (which would be more poorly documented, since the exports
 wouldn't be meaningfully ordered or broken into sections). This does
 unfortunately mean that the notes are separated in the source code from
 the things they refer to, but on the other hand, the documentation will be
 improved by this.

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