Fixes for Javadoc when building on Java 26 EA (helidon-io#11174)

* Move config metadata annotations to source retention to avoid strange warnings with javadoc on Java 26
* Fixed Grpc client blueprint javadoc reference to a valid method
* Added Grpc javadoc link

Author: tomas-langer

config/metadata/README.md

@@ -84,19 +84,22 @@ To add meta configuration:
     <dependency>
         <groupId>io.helidon.config</groupId>
         <artifactId>helidon-config-metadata</artifactId>
-        <optional>true</optional>
     </dependency>
     ```
 2. Update the `module-info.java` by adding 
     ```java
-    requires static io.helidon.config.metadata;
+    requires io.helidon.config.metadata;
     ```
 3. Annotate the configured class using `@Configured` - usually the builder class. If there is only a factory method, annotate the class containing the factory method
 4. Annotate builder methods using `@ConfiguredOption` - the type of the parameter will be used as type of the property, provides full customization using annotation properties 
 5. In case a factory method is the only one available, annotate it with repeating `@ConfiguredOption` to list all annotations
 6. Look at existing examples if in doubt
 7. Check the output in `target/classes/META-INF/helidon` to see what was generated
 
+NOTE: you can use `optional` dependency and `requires static` if you never use an enum constant from the metadata module.
+In case an enum constant (such as `Kind.LIST`) is used, the dependency must be transitive, and you must use `requires` without 
+static
+
 ## Generate Config Reference Documentation
 
 There are two ways to do this:

config/metadata/metadata/src/main/java/io/helidon/config/metadata/Configured.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021, 2024 Oracle and/or its affiliates.
+ * Copyright (c) 2021, 2026 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@
  * using an annotation processor.
  */
 @Target(ElementType.TYPE)
-@Retention(RetentionPolicy.CLASS)
+@Retention(RetentionPolicy.SOURCE)
 public @interface Configured {
     /**
      * Whether this is a root configuration object.

config/metadata/metadata/src/main/java/io/helidon/config/metadata/ConfiguredOption.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021, 2024 Oracle and/or its affiliates.
+ * Copyright (c) 2021, 2026 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -46,7 +46,7 @@
  */
 @Target(ElementType.METHOD)
 @Inherited
-@Retention(RetentionPolicy.CLASS)
+@Retention(RetentionPolicy.SOURCE)
 @Repeatable(ConfiguredOptions.class)
 public @interface ConfiguredOption {
     /**

config/metadata/metadata/src/main/java/io/helidon/config/metadata/ConfiguredOptions.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021, 2024 Oracle and/or its affiliates.
+ * Copyright (c) 2021, 2026 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,7 +27,7 @@
  */
 @Target(ElementType.METHOD)
 @Inherited
-@Retention(RetentionPolicy.CLASS)
+@Retention(RetentionPolicy.SOURCE)
 public @interface ConfiguredOptions {
     /**
      * Group of options when used on a type.

config/metadata/metadata/src/main/java/io/helidon/config/metadata/ConfiguredValue.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021, 2024 Oracle and/or its affiliates.
+ * Copyright (c) 2021, 2026 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,7 +22,7 @@
 /**
  * Can be used to define a list of possible values of an option.
  */
-@Retention(RetentionPolicy.CLASS)
+@Retention(RetentionPolicy.SOURCE)
 public @interface ConfiguredValue {
     /**
      * Value of the option.

etc/javadoc/grpc-api/element-list

@@ -0,0 +1,26 @@
+io.grpc
+io.grpc.auth
+io.grpc.binarylog.v1
+io.grpc.channelz.v1
+io.grpc.gcp.csm.observability
+io.grpc.grpclb
+io.grpc.health.v1
+io.grpc.inprocess
+io.grpc.lb.v1
+io.grpc.netty
+io.grpc.okhttp
+io.grpc.opentelemetry
+io.grpc.protobuf
+io.grpc.protobuf.lite
+io.grpc.protobuf.services
+io.grpc.reflection.v1
+io.grpc.reflection.v1alpha
+io.grpc.services
+io.grpc.servlet
+io.grpc.servlet.jakarta
+io.grpc.stub
+io.grpc.stub.annotations
+io.grpc.testing
+io.grpc.util
+io.grpc.xds
+io.grpc.xds.orca

http/http/pom.xml

@@ -80,6 +80,7 @@
             <groupId>io.helidon.config</groupId>
             <artifactId>helidon-config-metadata</artifactId>
             <optional>true</optional>
+            <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>io.helidon.config</groupId>

pom.xml

@@ -200,6 +200,7 @@
         <javadoc.link.opentracing>https://static.javadoc.io/io.opentracing/opentracing-api/${version.lib.opentracing}</javadoc.link.opentracing>
         <javadoc.link.prometheus>https://static.javadoc.io/io.prometheus/simpleclient/${version.lib.prometheus}</javadoc.link.prometheus>
         <javadoc.link.zipkin>https://static.javadoc.io/io.zipkin.reporter2/zipkin-reporter/2.12.3</javadoc.link.zipkin>
+        <javadoc.link.grpc-api>https://grpc.github.io/grpc-java/javadoc</javadoc.link.grpc-api>
 
         <!--suppress UnresolvedMavenProperty -->
         <javadoc.pkg.dir>${top.parent.basedir}/etc/javadoc</javadoc.pkg.dir>
@@ -452,6 +453,10 @@
                                 <url>${javadoc.link.oci-addons-oke-workload-identity}</url>
                                 <location>${javadoc.pkg.dir}/oci-addons-oke-workload-identity</location>
                             </offlineLink>
+                            <offlineLink>
+                                <url>${javadoc.link.grpc-api}</url>
+                                <location>${javadoc.pkg.dir}/grpc-api</location>
+                            </offlineLink>
                         </offlineLinks>
                         <additionalJOptions combine.children="append">
                             <additionalJOption>-J-Dhttp.agent=maven-javadoc-plugin</additionalJOption>
@@ -577,6 +582,7 @@
                                 <failOnWarning>true</failOnWarning>
                                 <ignoredDependencies>
                                     <dependency>io.helidon.common.features:helidon-common-features-api:*</dependency>
+                                    <dependency>io.helidon.config:helidon-config-metadata:*</dependency>
                                 </ignoredDependencies>
                             </configuration>
                         </execution>

webclient/grpc/src/main/java/io/helidon/webclient/grpc/GrpcClientProtocolConfigBlueprint.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2024, 2025 Oracle and/or its affiliates.
+ * Copyright (c) 2024, 2026 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -102,7 +102,7 @@ default String type() {
      * {@link io.grpc.ClientCall.Listener#onClose(io.grpc.Status, io.grpc.Metadata)}.
      *
      * @return duration to wait for the next data request from listener
-     * @see io.grpc.ClientCall.Listener#request(int)
+     * @see io.grpc.ClientCall#request(int)
      */
     @Option.Configured
     @Option.Default("PT1S")