[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12445891 ] Norval Hope commented on DIRSERVER-748: ---------------------------------------
Turns out this isn't a Maven problem but a problem in javadoc itself: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5082928 The problem is caused because any "<a" in a javadoc comment which isn't a "<a href="...">...</a> stuffs up javadoc completely, due to a missing resource key, which hasn't been fixed despite being known for years. The problems are strings like: * ... * ... <alpha> ::= ... in org.apache.directory.shared.ldap.util.DNUtils. which need to be replaced by "<alpha> ...". I used the regex "\*.*<[aA][a-zA-Z0-9]" to find problematic strings in shared/ldap but needs to be done over whole project (and as I have local mods I'll need to work off a clean 1.1 build in order to submit a patch). > "Maven Site" fails so can't generate javadoc, and not available on DS website > either > ------------------------------------------------------------------------------------ > > Key: DIRSERVER-748 > URL: http://issues.apache.org/jira/browse/DIRSERVER-748 > Project: Directory ApacheDS > Issue Type: Task > Affects Versions: 1.0 > Environment: JDK 1.5.06, Maven 2.0.4 > Reporter: Norval Hope > Priority: Critical > > "Maven site" on a virgin 1.0 branch gives this exception: > C:/src/ad_branch_1.0/shared/ldap/src/main/java/org/apache/directory/shared/ldap/ > exception/LdapAuthenticationException.java:38: warning - Tag @link: reference > no > t found: ResultCodeEnum.INVALIDCREDENTIALS > 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.redirectRelativeL > inks(HtmlDocletWriter.java:1526) > at > com.sun.tools.doclets.formats.html.HtmlDocletWriter.commentTagsToStri > ng(HtmlDocletWriter.java:1438) > at > com.sun.tools.doclets.formats.html.HtmlDocletWriter.printCommentTags( > HtmlDocletWriter.java:1397) > at > com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComme > nt(HtmlDocletWriter.java:1370) > at > com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComme > nt(HtmlDocletWriter.java:1366) > at > com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(A > bstractIndexWriter.java:192) > at > com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescripti > on(AbstractIndexWriter.java:164) > at > com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateConten > ts(AbstractIndexWriter.java:89) > at > com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFil > e(SingleIndexWriter.java:76) > at > com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleI > ndexWriter.java:52) > at > com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(Html > Doclet.java:103) > at > com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration > (AbstractDoclet.java:122) > at > com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractD > oclet.java:64) > at > com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:4 > 2) > 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(DelegatingMethodAcces > sorImpl.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) > Fixed one instance of this problem in GracefulShutdownResponse:35 (illegal > @see instead of @link in javadoc comment) but just failed again further on > and can't tell which particular warning is to blame this time. Seems like a > maven config problem to my untrained eye, which I'm afraid means I don't know > how to approach debugging it. > Marked as "critical" as I presume it is a "must fix" prior to the 1.0 release. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira
