apr-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stas Bekman <s...@stason.org>
Subject Re: svn commit: r106663 - /apr/apr/trunk/CHANGES /apr/apr/trunk/include/apr_file_io.h
Date Mon, 29 Nov 2004 19:15:17 GMT
William A. Rowe, Jr. wrote:
> At 11:45 AM 11/29/2004, Stas Bekman wrote:
> 
>>William A. Rowe, Jr. wrote:
>>
>>>At 10:50 AM 11/29/2004, Stas Bekman wrote:
>>>
>>>
>>>>Also should the deprecated macros stay in this file or can those be moved
to some dedicated file to reduce the noise?
>>>
>>>They stay in place.  During the next major+1 bump, the RM
>>>trawls through the files looking for @deprecated, and simply
>>>strips them out.  
>>
>>That's not possible with this particular change, since everything (APR/httpd) still
uses the old macros.
> 
> 
> No, it's a requirement when we push major+1.  Then again,
> httpd may stay with 1.x, or may have a prerequisite 1.1
> (meaning we assume your change is there) or it may even

So when will it be possible to know whether it'll be in or not? If someone 
decides to remove those later, why do I waste my time?

> move to 2.x - in which case we -must- update all occurrences 
> within httpd.

Understood.

> There is no reason to keep using the old symbols in apr[-util/-iconv]
> so feel free to start migrating those.

I'll be working on symbols that I touch, at the moment I don't have to 
time to work on other things. Once mod_perl 2.0 is out I may be able to 
spend more time on other things.

>>>The way doxygen works, you would not want
>>>these moving out of scope to another file.
>>
>>Is there a way to put them in a different file and tell doxygen that the following
entries really belong to a different file?
> 
> 
> 1. it isn't pretty and
> 
> 2. you can't force a user to include another file from minor
>    to minor bump.  Their code should keep compiling w/o changes.
> 
> Please don't worry that this seems 'polluted' - the next major
> bump cleans this all out.  In the meantime, if they look for
> these symbols grep APR_FOO include/* they should find the old
> and new flavors in the same file, helping them with their own
> migration tasks.

Good point.


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

Mime
View raw message