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

Christoph Dreis christoph.dreis at freenet.de
Mon Oct 30 16:05:53 UTC 2017


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