dev@glassfish.java.net

Re: can't generated Javadoc on Mac OS X, JDK 1.5

From: Jason Lee <jason_at_steeplesoft.com>
Date: Thu, 7 Aug 2008 13:39:05 -0500

Lloyd, I'm seeing this to on Leopard. I thought it might be a broken
@link element in the javadoc (because of
doclet.malformed_html_link_tag), so I went grepping, and managed to
find some that look wrong. With your blessing, I'll commit these
changes:

Index: src/main/java/org/glassfish/admin/amx/config/grizzly/ProtocolConfig.java
===================================================================
--- src/main/java/org/glassfish/admin/amx/config/grizzly/ProtocolConfig.java (revision
21662)
+++ src/main/java/org/glassfish/admin/amx/config/grizzly/ProtocolConfig.java (working
copy)
@@ -117,9 +117,9 @@
     public void setOobInline(String oobInline);

     /**
- * Get the {_at_link Protocol> SSL configuration
+ * Get the {_at_link Protocol} SSL configuration
      *
- * @return the {_at_link Protocol> SSL configuration
+ * @return the {_at_link Protocol} SSL configuration
      */
     public SSLConfig getSSLConfig();

Index: src/main/java/com/sun/appserv/management/config/WebServiceEndpointConfigKeys.java
===================================================================
--- src/main/java/com/sun/appserv/management/config/WebServiceEndpointConfigKeys.java (revision
21662)
+++ src/main/java/com/sun/appserv/management/config/WebServiceEndpointConfigKeys.java (working
copy)
@@ -54,11 +54,11 @@
         public final static String JBI_ENABLED_KEY= "JBIEnabled";
         
         
- /** Key for use with @link {
WebServiceEndpointConfigCR#createWebServiceEndpointConfig} */
+ /** Key for use with {_at_link
WebServiceEndpointConfigCR#createWebServiceEndpointConfig} */
         public final static String MONITORING_LEVEL_KEY =
     "MonitoringLevel";

- /** Key for use with @link {
WebServiceEndpointConfigCR#createWebServiceEndpointConfig} */
+ /** Key for use with {_at_link
WebServiceEndpointConfigCR#createWebServiceEndpointConfig} */
         public final static String MAX_HISTORY_SIZE_KEY = "MaxHistorySize";
         
 }
Index: src/main/java/com/sun/appserv/management/config/JDBCConnectionPoolConfigKeys.java
===================================================================
--- src/main/java/com/sun/appserv/management/config/JDBCConnectionPoolConfigKeys.java (revision
21662)
+++ src/main/java/com/sun/appserv/management/config/JDBCConnectionPoolConfigKeys.java (working
copy)
@@ -61,36 +61,36 @@
         public final static String CONNECTION_VALIDATION_METHOD_KEY=
"connection-validation-method";
         
         
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String VALIDATION_TABLE_NAME_KEY =
"validation-table-name";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String DATASOURCE_CLASSNAME_KEY = "datasource-classname";
         /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String FAIL_ALL_CONNECTIONS_KEY = "fail-all-connections";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String IDLE_TIMEOUT_IN_SECONDS_KEY =
"idle-timeout-in-seconds";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String IS_CONNECTION_VALIDATION_REQUIRED_KEY=
"is-connection-validation-required";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String IS_ISOLATION_LEVEL_GUARANTEED_KEY=
"is-isolation-level-guaranteed";
         /**
- Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)}
+ Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)}
                 See {_at_link IsolationValues}.
         */
         public final static String TRANSACTION_ISOLATION_LEVEL_KEY=
"transaction-isolation-level";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String MAX_POOL_SIZE_KEY = "max-pool-size";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String MAX_WAIT_TIME_MILLIS_KEY =
"max-wait-time-in-millis";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String POOL_RESIZE_QUANTITY_KEY = "pool-resize-quantity";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String NON_TRANSACTIONAL_CONNECTIONS_KEY =
"non-transactional-connections";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String ALLOW_NON_COMPONENT_CALLERS_KEY =
"allow-non-component-callers";

         /**
- Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)}
+ Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)}
                 Possible values:
                 <ul>
                 <li>javax.sql.DataSource</li>
@@ -99,13 +99,13 @@
                 </ul>
         */
         public final static String RES_TYPE_KEY = "res-type";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String STEADY_POOL_SIZE_KEY = "steady-pool-size";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String DATABASE_NAME_KEY = "property.DatabaseName";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String DATABASE_USER_KEY = "property.User";
- /** Key for use with @link {
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
+ /** Key for use with {_at_link
DomainConfig#createJDBCConnectionPoolConfig(String, String, Map)} */
         public final static String DATABASE_PASSWORD_KEY = "property.Password";
 }

Index: src/main/java/com/sun/appserv/management/base/Pathnames.java
===================================================================
--- src/main/java/com/sun/appserv/management/base/Pathnames.java (revision
21662)
+++ src/main/java/com/sun/appserv/management/base/Pathnames.java (working copy)
@@ -49,7 +49,7 @@
     <li>root -- represents {_at_link com.sun.appserv.management.DomainRoot}</li>
     <li>root.SystemStatus -- represents {_at_link
com.sun.appserv.management.base.SystemStatus}</li>
     <li>root.domain -- represents {_at_link
com.sun.appserv.management.config.DomainConfig}</li>
- <li>root.domain.servers.server -- represents {_at_link
com.sun.appserv.management.config.ServerConfig 'server'}</li>
+ <li>root.domain.servers.server -- represents {_at_link
com.sun.appserv.management.config.ServerConfig} 'server'</li>
     </ul>
         <p>
     A 'target' of a dotted name is the AMX MBean to which it resolves.


On Thu, Aug 7, 2008 at 1:15 PM, Lloyd Chambers <Lloyd.Chambers_at_sun.com> wrote:
> Anyone know what might be causing this?
>
> MB2:amx-api lloyd$ mvn javadoc:javadoc
>
> ...
>
> java.util.MissingResourceException: Can't find resource for bundle
> com.sun.tools.doclets.formats.html.resources.standard, key
> doclet.malformed_html_link_tag
> at java.util.ResourceBundle.getObject(ResourceBundle.java:325)
> at java.util.ResourceBundle.getString(ResourceBundle.java:285)
> at
> com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:114)
> at
> com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:92)
> at
> com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:81)
> at
> com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.warning(MessageRetriever.java:290)
> at
> com.sun.tools.doclets.formats.html.HtmlDocletWriter.redirectRelativeLinks(HtmlDocletWriter.java:1526)
> at
> com.sun.tools.doclets.formats.html.HtmlDocletWriter.commentTagsToString(HtmlDocletWriter.java:1438)
> at
> com.sun.tools.doclets.formats.html.HtmlDocletWriter.printCommentTags(HtmlDocletWriter.java:1397)
> at
> com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1370)
> at
> com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1366)
> at
> com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(AbstractIndexWriter.java:192)
> at
> com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescription(AbstractIndexWriter.java:164)
> at
> com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateContents(AbstractIndexWriter.java:89)
> at
> com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFile(SingleIndexWriter.java:76)
> at
> com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleIndexWriter.java:52)
> at
> com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(HtmlDoclet.java:103)
> at
> com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:122)
> at
> com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64)
> at
> com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42)
> at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
> at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
> at
> sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
> at
> sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
> at java.lang.reflect.Method.invoke(Method.java:585)
> at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269)
> at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143)
> at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
> at com.sun.tools.javadoc.Start.begin(Start.java:128)
> at com.sun.tools.javadoc.Main.execute(Main.java:41)
> at com.sun.tools.javadoc.Main.main(Main.java:31)
>
> Command line was:"cd /v3/code/common/amx-api/target/site/apidocs &&
> /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home/bin/javadoc"
> @options @packages
>
>
> ..............................................
> Lloyd Chambers
> lloyd.chambers_at_sun.com
> GlassFish team, admin
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>
>



-- 
Jason Lee, SCJP
Senior Java Developer, Sun Microsystems
Mojarra and Mojarra Scales Dev Team
https://mojarra.dev.java.net
https://scales.dev.java.net
http://blogs.steeplesoft.com