Correct (Un)qualifiedQName javadoc 04/92204/2
authorRobert Varga <robert.varga@pantheon.tech>
Thu, 20 Aug 2020 09:35:23 +0000 (11:35 +0200)
committerRobert Varga <robert.varga@pantheon.tech>
Thu, 20 Aug 2020 10:07:30 +0000 (12:07 +0200)
This adds a bit of documentation and correcting a mitsaken @return.

Change-Id: I56ed5aa57969fad5230c8b3a30503f162888ee22
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
yang/yang-common/src/main/java/org/opendaylight/yangtools/yang/common/QualifiedQName.java
yang/yang-common/src/main/java/org/opendaylight/yangtools/yang/common/UnqualifiedQName.java

index 72be15e04561209583d81a372294cc607b47690c..1c12ecb4cf51ab8025eb411b00c014721d393609 100644 (file)
@@ -44,11 +44,11 @@ public final class QualifiedQName extends AbstractQName implements Comparable<Qu
     }
 
     /**
-     * Read an UnboundQName from a DataInput. The format is expected to match the output format of
+     * Read an QualifiedQName from a DataInput. The format is expected to match the output format of
      * {@link #writeTo(DataOutput)}.
      *
      * @param in DataInput to read
-     * @return An UnboundQName instance
+     * @return An QualifiedQName instance
      * @throws IOException if I/O error occurs
      */
     public static QualifiedQName readFrom(final DataInput in) throws IOException {
index 6d0bc42b0efbf5bbff17d00929291c3bddfcf3e3..c596dd86b2d9f1a796f970185fbbf4b1915e2641 100644 (file)
@@ -32,16 +32,23 @@ public final class UnqualifiedQName extends AbstractQName implements Comparable<
         super(localName);
     }
 
+    /**
+     * Create a new unqualified QName.
+     *
+     * @param localName The local name of this unqualified QName
+     * @return An UnqualifiedQName instance
+     * @throws IllegalArgumentException if localName is null or it does not conform to YANG localName requirements.
+     */
     public static UnqualifiedQName of(final String localName) {
         return new UnqualifiedQName(checkLocalName(localName));
     }
 
     /**
-     * Read an UnboundQName from a DataInput. The format is expected to match the output format of
+     * Read an UnqualifiedQName from a DataInput. The format is expected to match the output format of
      * {@link #writeTo(DataOutput)}.
      *
      * @param in DataInput to read
-     * @return An UnboundQName instance
+     * @return An UnqualifiedQName instance
      * @throws IOException if I/O error occurs
      */
     public static UnqualifiedQName readFrom(final DataInput in) throws IOException {