You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@directory.apache.org by "Norbert Reilly (JIRA)" <ji...@apache.org> on 2006/09/22 05:45:22 UTC
[jira] Created: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
"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: Norbert Reilly
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
Re: [jira] Resolved: (DIRSERVER-748) "Maven Site" fails so can't generate javadoc, and not available on DS website either
Posted by Norval Hope <nr...@gmail.com>.
Ok, thanks.
My primary objective was just getting any javadoc generated, so
ignored the 200+ warnings and just fixed the fatal errors. Thanks for
going one step further.
As an aside, once I ran "mvn site" I noticed the top-level page had
broken links as it seemed to assume that the javadocs from all the
sub-project targets had been copied underneath the top-level target/
dir. Is there a step missing from the MOJO or something?
Thanks
Re: [jira] Resolved: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by Emmanuel Lecharny <el...@gmail.com>.
Norval Hope a écrit :
> On reading your earlier email, perhaps you patched 1.0 but not 1.1, or
> did you mean both had been pacthed?
Both are patched ... Took time, especially to remove a lot of waring in
shared/ldap !!!
Emmanuel
Re: [jira] Resolved: (DIRSERVER-748) "Maven Site" fails so can't generate javadoc, and not available on DS website either
Posted by Norval Hope <nr...@gmail.com>.
On reading your earlier email, perhaps you patched 1.0 but not 1.1, or
did you mean both had been pacthed?
On 11/2/06, Norval Hope <nr...@gmail.com> wrote:
> Hi Emmanuel,
>
> Shouldn't the patch for 1.0.x be applied too?
>
> Thanks
>
Re: [jira] Resolved: (DIRSERVER-748) "Maven Site" fails so can't generate javadoc, and not available on DS website either
Posted by Norval Hope <nr...@gmail.com>.
Hi Emmanuel,
Shouldn't the patch for 1.0.x be applied too?
Thanks
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Norval Hope (JIRA)" <ji...@apache.org>.
[ 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
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Emmanuel Lecharny (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12436811 ]
Emmanuel Lecharny commented on DIRSERVER-748:
---------------------------------------------
I can fix this one easily, but this won't help a lot, because we have more than one error with javadoc generation.
We should try to do a full pass on this issue, and raise it to bug (and not improvment or task), because as ADS is embedable, we must have a working javadoc.
Btw, we badly need to reference library javadoc, thus downloading sources. Working with the library binary jars is not enough.
Somebody want to spend some time fixing this problem ?
> "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: Norbert Reilly
> 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
[jira] Closed: (DIRSERVER-748) "Maven Site" fails so can't generate
javadoc, and not available on DS website either
Posted by "Norval Hope (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DIRSERVER-748?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Norval Hope closed DIRSERVER-748.
---------------------------------
> "Maven Site" fails so can't generate javadoc, and not available on DS website either
> ------------------------------------------------------------------------------------
>
> Key: DIRSERVER-748
> URL: https://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
> Assignee: Emmanuel Lecharny
> Priority: Critical
> Attachments: ad_1.0_remove_bad_javadoc_links.patch, ad_1.1_remove_bad_javadoc_links.patch
>
>
> "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.
-
You can reply to this email to add a comment to the issue online.
[jira] Resolved: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Emmanuel Lecharny (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=all ]
Emmanuel Lecharny resolved DIRSERVER-748.
-----------------------------------------
Resolution: Fixed
Assignee: Emmanuel Lecharny
Fixed, applying Norval patch and fixing waring on trunks.
> "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
> Assigned To: Emmanuel Lecharny
> Priority: Critical
> Attachments: ad_1.0_remove_bad_javadoc_links.patch, ad_1.1_remove_bad_javadoc_links.patch
>
>
> "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
[jira] Updated: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Norval Hope (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=all ]
Norval Hope updated DIRSERVER-748:
----------------------------------
Attachment: ad_1.0_remove_bad_javadoc_links.patch
ad_1.1_remove_bad_javadoc_links.patch
Here are patches for 1.0 and 1.1 trunk that resolve the javadoc dying issue
> "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
> Attachments: ad_1.0_remove_bad_javadoc_links.patch, ad_1.1_remove_bad_javadoc_links.patch
>
>
> "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
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Norbert Reilly (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12437411 ]
Norbert Reilly commented on DIRSERVER-748:
------------------------------------------
As well as the problems with the acutal javadoc, the error causing the "maven site" to bomb seems to be:
java.util.MissingResourceException: Can't find resource for bundle com.sun.tools
.doclets.formats.html.resources.standard, key doclet.malformed_html_link_tag
which looks to me like javadoc itself failing to find one of its built-in resource .properties files. The messages output by javadoc seem to all be warnings, so I think if the resource key "doclet.malformed_html_link_tag " could be resolved then the javadoc problems themselves wouldn't be fatal. That's what I meant by it looking like the problem looking like it has something to do with maven plug-in configuration. Hence the fix might best be seen as having two stages:
1) stop "maven site" from bombing in the presence of javadoc problems
2) fix all the javadoc to resolve any existing problems.
> "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: Norbert Reilly
> 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
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Emmanuel Lecharny (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12445911 ]
Emmanuel Lecharny commented on DIRSERVER-748:
---------------------------------------------
Norval, I think you are right, but it would be very kind of maven not to stop generating the javacdoc for the following files as soon as javadoc program is not happy with one file :)
> "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
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Emmanuel Lecharny (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12437486 ]
Emmanuel Lecharny commented on DIRSERVER-748:
---------------------------------------------
Hmmmmm...
I think you are right, and that we should fill a Maven JIRA for this problem.
> "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: Norbert Reilly
> 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
[jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
generate javadoc, and not available on DS website either
Posted by "Emmanuel Lecharny (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DIRSERVER-748?page=comments#action_12446372 ]
Emmanuel Lecharny commented on DIRSERVER-748:
---------------------------------------------
Thanks for the patches !
I have applied it on 1.0-trunks, and I also fixed all the shared/** javadoc warning. There is a _lot_ of work to do in order to have a correct javadoc ...
> "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
> Attachments: ad_1.0_remove_bad_javadoc_links.patch, ad_1.1_remove_bad_javadoc_links.patch
>
>
> "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