[Bug][JDK10] Fix duplicated "a" occurrences in docs

Stuart Marks stuart.marks at oracle.com
Mon Oct 30 23:04:59 UTC 2017


I'll take this one. I just ran across another minor error I wanted to fix so 
I'll piggyback mine on yours.

https://bugs.openjdk.java.net/browse/JDK-8190382

Thanks for pointing these out!

s'marks


On 10/30/17 9:05 AM, Christoph Dreis wrote:
> The attached patched seems to have been dropped.
> 
> Sorry for any inconveniences.
> 
> ===== PATCH ======
> diff -r d87f89c74f54
> src/java.base/share/classes/java/lang/invoke/VarHandle.java
> --- a/src/java.base/share/classes/java/lang/invoke/VarHandle.java	Mon
> Oct 30 07:06:49 2017 -0700
> +++ b/src/java.base/share/classes/java/lang/invoke/VarHandle.java	Mon
> Oct 30 16:47:56 2017 +0100
> @@ -423,7 +423,7 @@
>    * {@link java.lang.invoke.MethodHandles#varHandleInvoker}.
>    *
>    * <h1>Interoperation between VarHandles and Java generics</h1>
> - * A VarHandle can be obtained for a variable, such as a a field, which is
> + * A VarHandle can be obtained for a variable, such as a field, which is
>    * declared with Java generic types.  As with the Core Reflection API, the
>    * VarHandle's variable type will be constructed from the erasure of the
>    * source-level type.  When a VarHandle access mode method is invoked, the
> 
> diff -r d87f89c74f54 src/java.base/share/classes/java/util/EventObject.java
> --- a/src/java.base/share/classes/java/util/EventObject.java	Mon Oct 30
> 07:06:49 2017 -0700
> +++ b/src/java.base/share/classes/java/util/EventObject.java	Mon Oct 30
> 16:47:56 2017 +0100
> @@ -70,7 +70,7 @@
>       /**
>        * Returns a String representation of this EventObject.
>        *
> -     * @return  A a String representation of this EventObject.
> +     * @return a String representation of this EventObject.
>        */
>       public String toString() {
>           return getClass().getName() + "[source=" + source + "]";
> 
> diff -r d87f89c74f54
> src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/Parameter
> izedTypeImpl.java
> ---
> a/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/Paramet
> erizedTypeImpl.java	Mon Oct 30 07:06:49 2017 -0700
> +++
> b/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/Paramet
> erizedTypeImpl.java	Mon Oct 30 16:47:56 2017 +0100
> @@ -66,7 +66,7 @@
>       /**
>        * Static factory. Given a (generic) class, actual type arguments
>        * and an owner type, creates a parameterized type.
> -     * This class can be instantiated with a a raw type that does not
> +     * This class can be instantiated with a raw type that does not
>        * represent a generic type, provided the list of actual type
>        * arguments is empty.
>        * If the ownerType argument is null, the declaring class of the
> 
> 
>> Hey,
>>
>> similar to JDK-8190323 the attached patch removes duplicated "a"
>> occurrences in java.base docs.
>>
>> Would be happy if this is sponsored.
>>
>> I wasn't sure about the capitalization change on EventObject. What's the
> rule
>> of thumb in cases where the class does not follow the guidelines for
> docs[1]?
>> Sticking to the overall class scheme or aligning everything?
>>
>> Cheers,
>> Christoph
>> [1] http://www.oracle.com/technetwork/articles/java/index-137868.html
> 
> 
> 


More information about the core-libs-dev mailing list