Since notice in instance declarations.

Oleg Grenrus oleg.grenrus at iki.fi
Fri Oct 2 15:51:44 UTC 2015


Dear all,

What you think, if instead of /Since: 4.8.0.0/, we start to use /Since: base-4.8.0.0/.
Adding the package name seems redundant, but on the other hand some haddock
instance lists look weird. For example in Cabal Distribution.Version docs [1] has:

NFData Version -- /Since: 1.3.0.0/

Luckily Cabal is in 1.2x, otherwise /Since: 1.3.0.0/ next to the NFData Version could be
very confusing.

What you think about this new practice?

Greetings,
Oleg Grenrus

[1] http://hackage.haskell.org/package/Cabal-1.22.4.0/docs/Distribution-Version.html#control.i:Version <http://hackage.haskell.org/package/Cabal-1.22.4.0/docs/Distribution-Version.html#control.i:Version>

P.S. also the [1] doesn’t show orphan `Binary Version` instance provided. I hope it was
a temporary glitch in haddock.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/libraries/attachments/20151002/fce8b411/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 842 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://mail.haskell.org/pipermail/libraries/attachments/20151002/fce8b411/attachment.sig>


More information about the Libraries mailing list