@since annotations on exports
from Ben Gamari:
It should be possible to annotate re-exported declarations with
@sinceannotations. For instance, imagine we have a moduleFoo. In version0.2of the package providingFoowe might decide we want to re-exportBar.batfromFoo. In order to communicate this change to the user we would want to write something like:module Foo ( bat -- ^ @since 0.2 ) where import Bar (bat)Ideally
Foo's documentation would then reproduce the documentation ofFoobut with the@sinceannotation saying something likeSince: 0.2 (exported from 'Bar').The syntax here is somewhat odd:
@sincecomments in export lists must be expressed as-- ^docstrings as the usual-- |syntax in an export list is already used to express a docstring comment detached from any declaration.