Paul Querna wrote:
On Thu, 2004-05-27 at 14:13 -0700, Stas Bekman wrote:

As a postmortem to the sha1 support added after 2.0.49 was released. Should the apr docs carry a timestamp/version number of when a certain feature was added? Like a new tag @since in the doxygen docs? Otherwise how do you know what is the minimal version you have to require in your app, when you use a certain API/feature?



It is in the ChangeLog... or the CVS History. Thats How I have looked
up stuff before.


Not an optimal solution, a better solution would be to make actual APR
Releases that go with the HTTPd version being released, instead of
releasing HTTPd with an APR snapshot.

What about having a new doxygen token:

@since: apr x.x.x and/or apache 2.x.xx

whichever is appropriate. digging through CVS and ChangeLogs is not the most efficient way to do that. It doesn't have to be done at once, but at least start adding those tags when changing the existing API or introducing the new ones.

That's what we are using for mod_perl 2.0 API:
http://perl.apache.org/docs/2.0/api/index.html
Though I think we have only about 25% properly documented so far (Mostly APR:: manpages)


--
__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com

Reply via email to