directory-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Emmanuel Lecharny (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't generate javadoc, and not available on DS website either
Date Fri, 22 Sep 2006 10:23:44 GMT
    [ 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

        

Mime
View raw message