[GHC] #1903: Meta-Proposal: Documentation should be required to say when exports were introduced

GHC trac at galois.com
Mon Nov 19 05:27:23 EST 2007


#1903: Meta-Proposal: Documentation should be required to say when exports were
introduced
----------------------+-----------------------------------------------------
 Reporter:  igloo     |          Owner:         
     Type:  proposal  |         Status:  new    
 Priority:  normal    |      Milestone:  Not GHC
Component:  Compiler  |        Version:  6.8.1  
 Severity:  normal    |     Resolution:         
 Keywords:            |     Difficulty:  Unknown
 Testcase:            |   Architecture:  Unknown
       Os:  Unknown   |  
----------------------+-----------------------------------------------------
Comment (by simonmar):

 I'd like to do this automatically with tool support.  For example, we can
 retain the `.haddock` files for previous versions of a package, and
 Haddock can infer when particular entities were introduced, and add the
 appropriate annotations.  IIRC Hoogle has some functionality that could be
 used for this too.

 Related to this is the need to compare APIs for determining whether
 version bumps are necessary.  We should therefore have a way to dump an
 API in a machine-readable format for use by Haddock and other tools.

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


More information about the Glasgow-haskell-bugs mailing list