[Xapian-discuss] Re: Deprecation policy question

[Fabrice Colin]

On 9/24/07, Richard Boulton <richard at lemurconsulting.com> wrote:
> ...
> The point which we wish to canvas opinion on is this final one.  The
> question is whether we should add the macro to features at the time we
> initially mark them as deprecated, or should wait until the next release
> series.  The advantage of adding the macro immediately is that users get
> as much warning as possible - but the disadvantage is that code which
> compiled fine at the start of a release series suddenly starts producing
> warnings (and indeed, fails to compile if -Werror is being used).
>
> There are actually 3 options:
>
> 1. Always add the deprecation macro as soon as the feature is deprecated
> (so, at version 1.0.3 in the above example).  This is good because users
> get as much warning as possible about changes they will need to make to
> their code, but bad because it will sometimes mean that it is not
> possible to write code which compiles without warnings with all
> revisions of xapian within a release series.
>
I vote for option 1.

Fabrice