META-PROPOSAL: Documentation should be required to say when exports were introduced

Ian Lynagh igloo at earth.li
Sat Nov 17 09:13:18 EST 2007


Hi all,

This is trac #1903:
    http://hackage.haskell.org/trac/ghc/ticket/1903

One of the nice things about, for example, PHP is that if you look at
the documentation for one of its functions, e.g.
    http://www.php.net/manual/en/function.file-get-contents.php
it tells you that file_get_contents is available in PHP >= 4.3.0.

I propose that all exports in Haskell libraries should be required to
have such a thing in their haddock documentation. For the current code
we could either give the current versions as the date of introduction,
or do some digging and put precise data in.

Initial deadline: 1 December 2007. 


Thanks
Ian



More information about the Libraries mailing list