Fix javadoc warnings in SchemaNodeDefaults 03/95203/1
authorRobert Varga <robert.varga@pantheon.tech>
Wed, 17 Feb 2021 11:24:09 +0000 (12:24 +0100)
committerRobert Varga <robert.varga@pantheon.tech>
Wed, 17 Feb 2021 11:24:09 +0000 (12:24 +0100)
We have a few warnings here, clean them up.

Change-Id: I53203c5f0515786543562bb44b2278ab2b9509dd
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/SchemaNodeDefaults.java

index b9fae29b4add84264f134ee94d161e4ac57f56ae..c88c8352161393b088a88d5d58c4ef349930c027 100644 (file)
@@ -23,12 +23,13 @@ public final class SchemaNodeDefaults {
     }
 
     /**
-     * Report unsupported {@link SchemaNode#getPath()} implementation. This method is guaranteed to throw a
-     * RuntimeException.
+     * Report unsupported {@link SchemaNode#getPath()} implementation. This method is guaranteed to throw an
+     * {@link UnsupportedOperationException}.
      *
      * @param impl {@code this} object of invoking implementation
-     * @throws NullPointerException if impl is null
-     * @throws UnsupportedOperationException if impl is not null
+     * @return Nothing
+     * @throws NullPointerException if {@code impl} is null
+     * @throws UnsupportedOperationException always
      * @see SchemaNode#getPath()
      */
     // FIXME: 8.0.0: consider deprecating this method
@@ -40,8 +41,10 @@ public final class SchemaNodeDefaults {
      * Report unsupported {@link SchemaNode#getPath()} implementation if provided path is null.
      *
      * @param impl {@code this} object of invoking implementation
-     * @throws NullPointerException if impl is null
-     * @throws UnsupportedOperationException if path is null
+     * @param path A schema path
+     * @return {@code path} if non-null
+     * @throws NullPointerException if {@code impl} is null
+     * @throws UnsupportedOperationException if @{code path} is null
      * @see SchemaNode#getPath()
      */
     // FIXME: 8.0.0: consider deprecating this method