Re: [RFC] Deprecate svn_opt_args_to_target_array2() in 1.5.x?

Arfrever Frehtes Taifersar Arahesis wrote:
> svn_opt_args_to_target_array2() was replaced by svn_opt_args_to_target_array3()
> which is also available in 1.5.x.
>
> svn_opt_args_to_target_array2() mistakenly wasn't marked with
> the '@deprecated' tag.
>
> I would like to add the '@deprecated' tag for svn_opt_args_to_target_array2().
> Should I use:
> @deprecated Provided for backward compatibility with the 1.4 API.
> ... or ...
> @deprecated Provided for backward compatibility with the 1.5 API.
> ?
>
> Personally I would prefer the first one and I also think that this change
> should be backported to the 1.5.x branch.
> Would anybody like to oppose to this?

If a symbol was in introduced in 1.x, previous versions of the symbol are
provided for compat with the 1.(x-1) API. If it isn't documented as such,
that's a doc bug.

-Hyrum