RFR 8152205: jdk.security.provider.preferred is ambiguously documented

[Bradford Wetmore]

On 4/6/2016 6:40 PM, Wang Weijun wrote:
> In my DRBG changeset, I use this style:
>
> {@code jdk.security.provider.preferred} {@linkplain Security#getProperty(String) security property}

I like this or

{@code jdk.security.provider.preferred} {@link 
Security#getProperty(String) Security)

Brad


>
>
>
>> On Apr 7, 2016, at 8:23 AM, Bradford Wetmore <bradford.wetmore at oracle.com> wrote:
>>
>> If I was doing this from scratch, I would probably capitalize it to indicate it's a java.security.Security property and add inside the @code.
>>
>> {@code jdk.security.provider.preferred} security
>> ->
>> {@code jdk.security.provider.preferred Security}
>>
>> But I see it done that way in other places, so this is fine.
>>
>> Brad
>>
>>
>>
>> On 4/6/2016 3:47 PM, Xuelei Fan wrote:
>>> Looks fine to me.
>>>
>>> Xuelei
>>>
>>> On 4/7/2016 5:23 AM, Anthony Scarpino wrote:
>>>> I need a review of this very simple doc clarification.  Calling out
>>>> jdk.security.provider.preferred as a "security property" instead of just
>>>> a "property".
>>>>
>>>> http://cr.openjdk.java.net/~ascarpino/8152205/webrev/
>>>>
>>>> thanks.
>>>>
>>>> Tony
>>>
>