diff -pruN 1.6.0-3/debian/changelog 1.6.0-5/debian/changelog
--- 1.6.0-3/debian/changelog	2025-10-14 04:52:50.000000000 +0000
+++ 1.6.0-5/debian/changelog	2025-10-28 15:56:51.000000000 +0000
@@ -1,3 +1,18 @@
+java-websocket (1.6.0-5) unstable; urgency=medium
+
+  * add debian/watch 
+  * run dh_auto_build -- javadoc instead of manual gradle javadoc
+    otherwise it fails to even run in sbuild
+  * B-D on default-jdk-doc and recommend it in -doc per Java policy 
+
+ -- Rene Engelhard <rene@debian.org>  Tue, 28 Oct 2025 16:56:51 +0100
+
+java-websocket (1.6.0-4) unstable; urgency=medium
+
+  * build and package the javadoc
+
+ -- Rene Engelhard <rene@debian.org>  Mon, 27 Oct 2025 17:15:17 +0100
+
 java-websocket (1.6.0-3) unstable; urgency=medium
 
   * debian/copyright: mention PD status of
diff -pruN 1.6.0-3/debian/control 1.6.0-5/debian/control
--- 1.6.0-3/debian/control	2025-10-14 04:52:50.000000000 +0000
+++ 1.6.0-5/debian/control	2025-10-28 15:51:08.000000000 +0000
@@ -3,7 +3,7 @@ Section: java
 Priority: optional
 Maintainer: Debian Java Maintainers <pkg-java-maintainers@lists.alioth.debian.org>
 Uploaders: Rene Engelhard <rene@debian.org>
-Build-Depends: debhelper-compat (= 13), default-jdk, gradle-debian-helper, maven-repo-helper
+Build-Depends: debhelper-compat (= 13), default-jdk, gradle-debian-helper, maven-repo-helper, default-jdk-doc
 Build-Depends-Indep: junit4 (>= 4.13.1), libslf4j2-java (>= 2.0.13)
 Standards-Version: 4.7.0
 Vcs-Git: https://salsa.debian.org/java-team/java-websocket.git
@@ -15,6 +15,16 @@ Architecture: all
 Depends: ${misc:Depends}, ${maven:Depends}
 Suggests: ${maven:OptionalDepends}
 Description: Java WebSocket client and server implementation in Java
- A barebone WebSocket client and server implementation written 100% in
+ A barebones WebSocket client and server implementation written 100% in
  Java
 
+Package: libjava-websocket-java-doc
+Architecture: all
+Depends: ${misc:Depends}
+Recommends: default-jdk-doc
+Description: Java WebSocket client and server implementation in Java -- API documentation
+ A barebones WebSocket client and server implementation written 100% in
+ Java
+ .
+ This package contains the javadoc/API documentation.
+
diff -pruN 1.6.0-3/debian/libjava-websocket-java-doc.install 1.6.0-5/debian/libjava-websocket-java-doc.install
--- 1.6.0-3/debian/libjava-websocket-java-doc.install	1970-01-01 00:00:00.000000000 +0000
+++ 1.6.0-5/debian/libjava-websocket-java-doc.install	2025-10-28 06:05:16.000000000 +0000
@@ -0,0 +1 @@
+build/docs/javadoc/* usr/share/doc/libjava-websocket-java/api
diff -pruN 1.6.0-3/debian/rules 1.6.0-5/debian/rules
--- 1.6.0-3/debian/rules	2025-10-14 04:52:50.000000000 +0000
+++ 1.6.0-5/debian/rules	2025-10-28 06:23:43.000000000 +0000
@@ -7,6 +7,10 @@ override_dh_auto_clean:
 	dh_auto_clean
 	mh_clean
 
+override_dh_auto_build:
+	dh_auto_build
+	dh_auto_build -- javadoc
+
 override_dh_auto_test:
 
 override_dh_auto_install:
diff -pruN 1.6.0-3/debian/watch 1.6.0-5/debian/watch
--- 1.6.0-3/debian/watch	1970-01-01 00:00:00.000000000 +0000
+++ 1.6.0-5/debian/watch	2025-10-28 06:05:16.000000000 +0000
@@ -0,0 +1,2 @@
+version=4
+https://github.com/TooTallNate/Java-WebSocket/tags .*/v?(\d.*)@ARCHIVE_EXT@