Various Javadoc fixes to address Javadoc NPE failure.

Author: neilcsmith-net

pom.xml

@@ -133,6 +133,18 @@
           <release>8</release>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <version>3.4.2</version>
+        <configuration>
+          <archive>
+            <manifestEntries>
+              <Automatic-Module-Name>org.freedesktop.gstreamer</Automatic-Module-Name>
+            </manifestEntries>
+          </archive>
+        </configuration>
+      </plugin>
     </plugins>
   </build>
 

src/org/freedesktop/gstreamer/Bin.java

@@ -1,5 +1,5 @@
 /* 
- * Copyright (c) 2021 Neil C Smith
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (c) 2016 Christophe Lafolet
  * Copyright (c) 2009 Levente Farkas
  * Copyright (C) 2007 Wayne Meissner
@@ -496,7 +496,7 @@ public void disconnect(DO_LATENCY listener) {
 
     /**
      * Available details for pipeline graphs produced by
-     * {@link #debugToDotFile(int, java.lang.String, boolean)}
+     * {@link #debugToDotFile(java.util.EnumSet, java.lang.String)}
      */
     public static enum DebugGraphDetails implements NativeFlags<DebugGraphDetails> {
 

src/org/freedesktop/gstreamer/Bus.java

@@ -1,5 +1,5 @@
 /* 
- * Copyright (c) 2020 Neil C Smith
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (C) 2014 Tom Greenwood <[email protected]>
  * Copyright (C) 2007 Wayne Meissner
  * Copyright (C) 2004 Wim Taymans <[email protected]>
@@ -33,6 +33,7 @@
 import com.sun.jna.ptr.IntByReference;
 import com.sun.jna.ptr.LongByReference;
 import com.sun.jna.ptr.PointerByReference;
+import org.freedesktop.gstreamer.glib.GObject;
 import org.freedesktop.gstreamer.glib.NativeEnum;
 
 import org.freedesktop.gstreamer.glib.Natives;
@@ -766,9 +767,10 @@ public static interface BUFFERING {
          * {@code percent} is a value between 0 and 100. A value of 100 means
          * that the buffering completed.
          * <p>
-         * When {@code percent} is < 100 the application should PAUSE a PLAYING
-         * pipeline. When {@code percent} is 100, the application can set the
-         * pipeline (back) to PLAYING. <p>
+         * When {@code percent} is less than 100 the application should PAUSE a
+         * PLAYING pipeline. When {@code percent} is 100, the application can
+         * set the pipeline (back) to PLAYING.
+         * <p>
          * The application must be prepared to receive BUFFERING messages in the
          * PREROLLING state and may only set the pipeline to PLAYING after
          * receiving a message with {@code percent} set to 100, which can happen

src/org/freedesktop/gstreamer/BusSyncReply.java

@@ -1,5 +1,5 @@
 /* 
- * Copyright (c) 2019 Neil C Smith
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (c) 2007 Wayne Meissner
  * 
  * This file is part of gstreamer-java.
@@ -20,6 +20,7 @@
 package org.freedesktop.gstreamer;
 
 import org.freedesktop.gstreamer.glib.NativeEnum;
+import org.freedesktop.gstreamer.message.Message;
 
 /**
  * The result values for a GstBusSyncHandler.

src/org/freedesktop/gstreamer/Caps.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2019 Neil C Smith
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (c) 2009 Levente Farkas
  * Copyright (C) 2007 Wayne Meissner
  * Copyright (C) <2003> David A. Schleef <[email protected]>
@@ -38,12 +38,12 @@
  * given pad can handle. They are also stored in the {@link Registry} along with
  * a description of the {@link Element}.
  * <p>
- * Caps are exposed on the element pads using the {@link Pad#getCaps} method.
- * This method describes the possible types that the pad can handle or produce
- * at runtime.
+ * Caps are exposed on the element pads using the {@link Pad#getAllowedCaps() }
+ * method. This method describes the possible types that the pad can handle or
+ * produce at runtime.
  * <p>
  * Caps are also attached to buffers to describe the content of the data pointed
- * to by the buffer with {@link Buffer#setCaps}. Caps attached to a
+ * to by the buffer with {@link Sample#setCaps}. Caps attached to a
  * {@link Buffer} allow for format negotiation upstream and downstream.
  * <p>
  * A Caps can be constructed with the following code fragment:

src/org/freedesktop/gstreamer/ClockID.java

@@ -1,5 +1,5 @@
 /* 
- * Copyright (c) 2019 Neil C Smith
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (c) 2007 Wayne Meissner
  * 
  * This file is part of gstreamer-java.
@@ -57,7 +57,8 @@ public long getTime() {
      * Compares this ClockID to another.
      *
      * @param other The other ClockID to compare to
-     * @return negative value if a < b; zero if a = b; positive value if a > b
+     * @return negative value if
+     * {@code a < b; zero if a = b; positive value if a > b}
      */
     @Override
     public int compareTo(ClockID other) {

src/org/freedesktop/gstreamer/Context.java

@@ -1,4 +1,5 @@
 /*
+ * Copyright (c) 2025 Neil C Smith
  * Copyright (c) 2019 Christophe Lafolet
  * 
  * This file is part of gstreamer-java.
@@ -54,7 +55,7 @@
  * application should provide one if it can.
  * <p>
  * Contexts can be persistent. A persistent context is kept in elements when
- * they reach {@lin State#NULL}, non-persistent ones will be removed. Also, a
+ * they reach {@link State#NULL}, non-persistent ones will be removed. Also, a
  * non-persistent context won't override a previous persistent context set to an
  * element.
  */