[tomcat] 05/05: Add Javadoc for the Common Annotation API

[markt]

This is an automated email from the ASF dual-hosted git repository.

markt pushed a commit to branch 7.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git

commit 38a69916b9ddfc789c8eac3b46b175b2dc8d6efe
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Mon Sep 23 21:32:55 2019 +0100

    Add Javadoc for the Common Annotation API
---
 build.xml                           | 22 ++++++++++++++++++++++
 java/javax/annotation/Resource.java |  2 ++
 webapps/docs/changelog.xml          |  3 +++
 webapps/docs/project.xml            |  2 ++
 4 files changed, 29 insertions(+)

diff --git a/build.xml b/build.xml
index 3af3184..8fbe02d 100644
--- a/build.xml
+++ b/build.xml
@@ -2028,6 +2028,27 @@ Apache Tomcat ${version} native binaries for Win64 
AMD64/EMT64 platform.
     description="Create the Tomcat javadoc" >
     <fail unless="java.7.home"
           message="The java.7.home property must be set for javadoc build"/>
+    <javadoc packagenames="javax.annotation.*"
+      sourcepath="${tomcat.dist}/src/java"
+      destdir="${tomcat.dist}/webapps/docs/annotationapi"
+      version="true"
+      windowtitle="Common Annotations 1.1 API Documentation - Apache Tomcat 
${version}"
+      doctitle="Common Annotations 1.1 API - Apache Tomcat ${version}"
+      header="&lt;b&gt;Common Annotations 1.1 - Apache Tomcat 
${version}&lt;/b&gt;"
+      bottom="Copyright &amp;#169; 2000-${year} Apache Software Foundation. 
All Rights Reserved."
+      encoding="UTF-8"
+      docencoding="UTF-8"
+      charset="UTF-8"
+      additionalparam="-breakiterator -notimestamp ${java9.javadoc.options}"
+      source="${compile.source}"
+      maxmemory="512m"
+      failonerror="true"
+      failonwarning="true">
+      <classpath>
+        <path refid="compile.classpath"/>
+        <path location="${ant.core.lib}"/>
+      </classpath>
+    </javadoc>
     <javadoc packagenames="javax.servlet.*"
       excludepackagenames="javax.servlet.jsp.*"
       sourcepath="${tomcat.dist}/src/java"
@@ -2138,6 +2159,7 @@ Apache Tomcat ${version} native binaries for Win64 
AMD64/EMT64 platform.
         <path refid="tomcat.webservices.classpath"/>
         <path location="${ant.core.lib}"/>
       </classpath>
+      <link href="../annotationapi"/>
       <link href="../servletapi"/>
       <link href="../jspapi"/>
       <link href="../elapi"/>
diff --git a/java/javax/annotation/Resource.java 
b/java/javax/annotation/Resource.java
index 19a63b1..0ef8c41 100644
--- a/java/javax/annotation/Resource.java
+++ b/java/javax/annotation/Resource.java
@@ -40,6 +40,8 @@ public @interface Resource {
     public String mappedName() default "";
     /**
      * @since Common Annotations 1.1
+     *
+     * @return The name of the entry, if any, to use for this resource
      */
     public String lookup() default "";
 }
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index f7ca4df..3018274 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -165,6 +165,9 @@
         Spelling and formatting corrections for the cluster how-to. Pull 
request
         provided by Bill Mitchell. (markt)
       </fix>
+      <docs>
+        Add Javadoc for the Common Annotations API implementation. (markt)
+      </docs>
     </changelog>
   </subsection>
   <subsection name="Other">
diff --git a/webapps/docs/project.xml b/webapps/docs/project.xml
index ebf0e16..f05047d 100644
--- a/webapps/docs/project.xml
+++ b/webapps/docs/project.xml
@@ -86,6 +86,8 @@
         <item name="EL 2.2 Javadocs"       href="elapi/index.html"/>
         <item name="WebSocket 1.1 Javadocs"
               href="websocketapi/index.html"/>
+        <item name="Common Annotations 1.1 Javadocs"
+              href="annotationapi/index.html"/>
         <item name="JK 1.2 Documentation"
               href="https://tomcat.apache.org/connectors-doc/"/>
     </menu>


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org