patch applied (ghc-new-tc/haddock2): Comments on instances

Simon Peyton Jones <[email protected]> Fri, 16 Jul 2010 08:02:45 -0700

Newsgroups	gmane.comp.lang.haskell.cvs.other
Message-ID	<[email protected]>

Tue Nov 24 12:55:49 PST 2009  David Waern <[email protected]>
  * Comments on instances
  
  Implementing this was a little trickier than I thought, since we need to match
  up instances from the renamed syntax with instances represented by
  InstEnv.Instance. This is due to the current design of Haddock, which matches
  comments with declarations from the renamed syntax, while getting the list of
  instances of a class/family directly using the GHC API.
  
  - Works for class instances only (Haddock has no support for type family
    instances yet)
  - The comments are rendered to the right of the instance head in the HTML output
  - No change to the .haddock file format
  - Works for normal user-written instances only. No comments are added on
    derived or TH-generated instances

    M ./src/Haddock/Backends/Html.hs -21 +26
    M ./src/Haddock/Interface.hs -1 +1
    M ./src/Haddock/Interface/AttachInstances.hs -11 +30
    M ./src/Haddock/Interface/Create.hs -6 +28
    M ./src/Haddock/Interface/Rename.hs -3 +12
    M ./src/Haddock/Types.hs -3 +12

View patch online:
http://darcs.haskell.org/cgi-bin/darcsweb.cgi?r=ghc-new-tc/haddock2;a=darcs_commitdiff;h=20091124205549-a762e-8ec017c5dcb2bec421bad0cbffd8231fe6f56373.gz