Re: svn commit: r15002 - in trunk/subversion: clients/cmdline include libsvn_client tests/clients/cmdline

kfogel@collab.net wrote:
> Julian Foad <julianfoad@btopenworld.com> writes:
>> kfogel@collab.net wrote:
>>> julianfoad@tigris.org writes:
>>>> + * @deprecated Provided for backward compatibility with the 1.2 API.
>>>> */
>>>> svn_error_t *svn_client_import (svn_client_commit_info_t **commit_info,
>>>> const char *path,
>>> Should we be saying "1.2 API" there, or "1.0 API"?
>>
>> I think I sometimes had a clear notion of which was more appropriate,
>> but right now I've no idea. Anyone?
>
> I guess I think earliest applicable interface is best.

I think the other way - you can deduce the earliest interface trivially -
it's either 1.0, or the value of any @since tag, if present. It's harder to
deduce the latest applicable interface, so it seems better to specify that.

I think most instances of @deprecated in our code currently document the
latest applicable interface.

Max.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Jun 23 12:49:07 2005