Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Johan Tibell
On Tue, Sep 4, 2012 at 2:29 PM, Herbert Valerio Riedel wrote: > "Bryan O'Sullivan" writes: >> I think it would be very useful. We don't have any way of specifying >> identifier-level attributes right now that I know of, and such a capability >> would be helpful beyond just this use, too. > > ...w

Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Herbert Valerio Riedel
"Bryan O'Sullivan" writes: > I think it would be very useful. We don't have any way of specifying > identifier-level attributes right now that I know of, and such a capability > would be helpful beyond just this use, too. ...what other use-cases for identifier-level attributes do you have in mind

Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Evan Laforge
> Would such an enhancement to Haddock be worthwhile or is it a bad idea? > Has such a proposal come up in the past already? Are there alternative > approaches to consider? It would be even cooler to automatically figure them out from the hackage history. I recently stumbled across a document sys

Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Bardur Arantsson
On 09/04/2012 12:56 PM, Herbert Valerio Riedel wrote: > Hello Haskellers, > > I've been wondering whether it might be useful to add a feature to > Haddock similar to what can be found in other API documentation systems, > specifically an optional parseable "since"-attribute, declaring the last > p

Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Bryan O'Sullivan
On Tue, Sep 4, 2012 at 3:56 AM, Herbert Valerio Riedel wrote: > I've been wondering whether it might be useful to add a feature to > Haddock similar to what can be found in other API documentation systems, > specifically an optional parseable "since"-attribute, declaring the last > package versio

Re: RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Greg Weber
a lot of packages are doing this already, would be nice to formalize it On Tue, Sep 4, 2012 at 3:56 AM, Herbert Valerio Riedel wrote: > Hello Haskellers, > > I've been wondering whether it might be useful to add a feature to > Haddock similar to what can be found in other API documentation system

RFC: Adding support for an API-"since"-version-attribute to Haddock?

2012-09-04 Thread Herbert Valerio Riedel
Hello Haskellers, I've been wondering whether it might be useful to add a feature to Haddock similar to what can be found in other API documentation systems, specifically an optional parseable "since"-attribute, declaring the last package version when the associated definition/symbol was introduce