[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