Fixup yang-model-api javadoc warnings

[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / repo / spi / SchemaSourceRegistry.java

diff --git a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/spi/SchemaSourceRegistry.java b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/spi/SchemaSourceRegistry.java
index dfa34b79a4547b637b26a21481ad512e198fc3f6..ad034f5e271093fba56f77c17ea9cc0a66818e75 100644 (file)
--- a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/spi/SchemaSourceRegistry.java
+++ b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/spi/SchemaSourceRegistry.java
@@ -12,35 +12,30 @@ import org.opendaylight.yangtools.yang.model.repo.api.SchemaSourceRepresentation
 import org.opendaylight.yangtools.yang.model.repo.api.SourceIdentifier;
 
 /**
- * Registry of all potentially available schema sources. Processes capable of
- * dynamic schema discovery, such as OSGi registry scanners, NETCONF clients
- * (with NETCONF monitoring extension) and similar can register
- * {@link SchemaSourceProvider} instances which would then acquire the schema
- * source.
+ * Registry of all potentially available schema sources. Processes capable of dynamic schema discovery, such as OSGi
+ * registry scanners, NETCONF clients (with NETCONF monitoring extension) and similar can register
+ * {@link SchemaSourceProvider} instances which would then acquire the schema source.
  */
 @Beta
 public interface SchemaSourceRegistry {
     /**
-     * Register a new schema source which is potentially available from a provider.
-     * A registration does not guarantee that a subsequent call to
-     * {@link SchemaSourceProvider#getSource(SourceIdentifier)} will succeed.
+     * Register a new schema source which is potentially available from a provider. A registration does not guarantee
+     * that a subsequent call to {@link SchemaSourceProvider#getSource(SourceIdentifier)} will succeed.
      *
+     * @param <T> schema source representation type
      * @param provider Resolver which can potentially resolve the identifier
      * @param source Schema source details
-     * @return A registration handle. Invoking {@link SchemaSourceRegistration#close()}
-     *         will cancel the registration.
+     * @return A registration handle. Invoking {@link SchemaSourceRegistration#close()} will cancel the registration.
      */
     <T extends SchemaSourceRepresentation> SchemaSourceRegistration<T> registerSchemaSource(
             SchemaSourceProvider<? super T> provider, PotentialSchemaSource<T> source);
 
     /**
-     * Register a schema source listener. The listener will be notified as new
-     * sources and their representations become available, subject to the provided
-     * filter.
+     * Register a schema source listener. The listener will be notified as new sources and their representations become
+     * available, subject to the provided filter.
      *
      * @param listener Schema source listener
-     * @return A registration handle. Invoking {@link SchemaListenerRegistration#close()}
-     *         will cancel the registration.
+     * @return A registration handle. Invoking {@link SchemaListenerRegistration#close()} will cancel the registration.
      */
     SchemaListenerRegistration registerSchemaSourceListener(SchemaSourceListener listener);
 }