Improve javadoc

wkd-java/src/main/java/pgp/wkd/WKDAddressHelper.java

@@ -21,7 +21,12 @@ public class WKDAddressHelper {
      * The user-id is herein expected to follow the mail name-addr format described in RFC2822.
      *
      * Example User ID (angle normally not escaped):
-     * "Slim Shady <sshady@marshall-mathers.lp> [Yes, the real Shady]"
+     * {@code
+     * <pre>
+     *     Slim Shady <sshady@marshall-mathers.lp> [Yes, the real Shady]"
+     * </pre>
+     * }
+     *
      *
      * @see <a href="https://datatracker.ietf.org/doc/html/rfc4880#section-5.11">
      *     RFC4880 - OpenPGP Message Format - §5.11 User ID Packet</a>

wkd-java/src/main/java/pgp/wkd/discovery/CertificateFetcher.java

@@ -19,6 +19,7 @@ public interface CertificateFetcher {
      * Attempt to fetch an OpenPGP certificate from the Web Key Directory.
      *
      * @param address WKDAddress object
+     * @param method discovery method
      * @return input stream containing the certificate in its binary representation
      *
      * @throws IOException in case of an error

wkd-java/src/main/java/pgp/wkd/discovery/DiscoveryResult.java

@@ -48,6 +48,7 @@ public class DiscoveryResult {
      * This method does not close the output stream.
      *
      * @param outputStream output stream
+     * @throws IOException in case of an IO error
      */
     public void write(OutputStream outputStream)
             throws IOException {