[haddock] #93: Move lexing and parsing of doc strings into Haddock

[haddock]

#93: Move lexing and parsing of doc strings into Haddock
------------------------+---------------------------------------------------
Reporter:  waern        |        Owner:       
    Type:  refactoring  |       Status:  new  
Priority:  major        |    Milestone:  2.6.0
 Version:  2.4.1        |   Resolution:       
Keywords:               |  
------------------------+---------------------------------------------------
Changes (by waern):

  * summary:  Move lexing and parsing of Haddock comments into Haddock =>
              Move lexing and parsing of doc strings into
              Haddock

Old description:

> Currently, GHC does lexing and parsing of Haddock comments. This was
> decided so GHC could rename the Haddock comments during its renamer
> phase. Since it's possible to access the renaming environment from the
> GHC API, we could do the renaming in Haddock instead, which would enable
> us to move lexing and parsing of Haddock comments into Haddock. The
> advantage is that we don't have to do development to GHC in order to make
> changes to these components.

New description:

 Currently, GHC does lexing and parsing of doc strings. This was decided so
 GHC could rename them during its renamer phase. Since it's possible to
 access the renaming environment from the GHC API, we could do the renaming
 in Haddock instead, which would enable us to move lexing and parsing of
 doc strings into Haddock. The advantage is that we don't have to do
 development to GHC in order to make changes to these components.

-- 
Ticket URL: <http://trac.haskell.org/haddock/ticket/93#comment:2>
haddock <http://www.haskell.org/haddock>
Haddock, The Haskell Documentation Tool