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