This looks good.  This will prepare for the future when Java supports multiple bounds.

Mandy

On 8/5/20 2:37 PM, Joe Darcy wrote:
Hello,

Addressing some feedback from off-list discussions with Mandy, I propose changing the API notes to:

    @apiNote While to date a wildcard may have at most one upper[lower] bound, callers of this method should be written to accommodate multiple bounds.

Thanks,

-Joe

On 8/3/2020 9:24 AM, Joe Darcy wrote:
Hi David,

To provide a bit more context, the API was consciously designed to be future-proofed against the possibility of Java supporting multiple bounds here (JDK-4891872). As of yet, that change has not come to pass, and as you note may never come to pass. So besides in addition to the links into the JLS, I think it is reasonable to include an API note acknowledging the situation. How about:

    This method supports the existence of multiple bounds, but to date, a wildcard may have at most one upper/lower bound.

-Joe



Reply via email to