Mailing-List: contact dev-help@directory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Apache Directory Developers List" <dev@directory.apache.org>
Message-ID: <7790152.1162413677744.JavaMail.root@brutus>
Date: Wed, 1 Nov 2006 12:41:17 -0800 (PST)
From: "Emmanuel Lecharny (JIRA)" <jira@apache.org>
To: dev@directory.apache.org
Subject: [jira] Commented: (DIRSERVER-748) "Maven Site" fails so can't
 generate javadoc, and not available on DS website either
In-Reply-To: <33371465.1158896722375.JavaMail.jira@brutus>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

    [ 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