osdir.com


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [CANCEL][VOTE] Release Apache Commons RNG 1.1 based on RC6


On Wed, 8 Aug 2018 12:06:18 -0400, Rob Tompkins wrote:
On Aug 8, 2018, at 10:26 AM, Gilles <gilles@xxxxxxxxxxxxxxxxxxxxx> wrote:

On Wed, 8 Aug 2018 08:00:11 -0600, Gary Gregory wrote:
Oh and you should consider marking the API we are adding back as
@deprecated.

?
There is no replacement.
[I've tried to explain the issue in a previous message.]

We can state that in the javadoc, in the sense that we suggest that
you not consume this method specifically (and that there’s no need
to).

The methods are "protected". The only issue is for a developer
who would use (i.e. inherit from) a sampler, and then, for some
unfathomable reason, would circumvent the purpose of the public
API (by calling something other than "sample()").

The Javadoc of all sampler classes should simply state
-----
Do not inherit from this class as it will be made final in a
future release.
-----

Regards,
Gilles

[...]


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@xxxxxxxxxxxxxxxxxx
For additional commands, e-mail: dev-help@xxxxxxxxxxxxxxxxxx