Two more things to note:
It failed on jdk 5 on Linux, and if I remove
src/main/java/com/sun/appserv/management, the docs build correctly, if
not incompletely. I'm slowly adding directories back in to see which
one causes the failure, then I'll camp out there.
On Thu, Aug 7, 2008 at 1:52 PM, Lloyd Chambers <Lloyd.Chambers_at_sun.com> wrote:
> Jason,
>
> Thanks, I'm in the midst of correcting all the javadoc errors. Feel free to
> commit, but I've already committed some changes, and there might be
> conflicts.
>
> It's not clear the bad links stuff is causing the problem.
>
> Lloyd
>
> ..............................................
> Lloyd Chambers
> lloyd.chambers_at_sun.com
> GlassFish team, admin
>
>
>
>
> On Aug 7, 2008, at 11:39 AM, Jason Lee wrote:
>
>> 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
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>>
>
>
> ---------------------------------------------------------------------
> 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