commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Steven Caswell <steven.casw...@gmail.com>
Subject Re: [lang] VOTE 2.1 release (new vote based on RC5)
Date Wed, 18 May 2005 21:37:50 GMT
I think I found the problem. I need to do some more investigation, but it 
looks like an issue with the version of the maven javadoc plugin I am using.

It looks like the maven-javadoc-plugin version 1.7 copies the source files 
to a separate area when there are source modifications in project.xml, and 
uses this area to remove the source modifications and then builds the 
javadoc from the remaining source. Apparently it doesn't drag the .html 
files along with the .java files, so the javadoc is void of overview and 
package contents.

Since I added the source modification in the latest project.xml, you may not 
have refreshed your local copy, so you would see the javadoc built without 
the source modifications, which I think is done on the src folder in place.

Or you might be using an older version of the javadoc plugin.

Now on to the maven users list.

On 5/10/05, Gary Gregory <ggregory@seagullsoftware.com> wrote:
> 
>  "I'm a bit confused as to why you get a different result."
> 
>  Indeed, it seems that your site is missing some information (the pkg 
> desc), while I get the full Javadoc generated. Weird.
> 
>  Gary
> 
>   ------------------------------
>  
> *From:* Steven Caswell [mailto:steven.caswell@gmail.com] 
> *Sent:* Tuesday, May 10, 2005 11:16 AM
> *To:* Gary Gregory
> *Cc:* Jakarta Commons Developers List
> *Subject:* Re: [lang] VOTE 2.1 release (new vote based on RC5)
>  
>  Gary,
> 
> Offhand I haven't a clue. I'll have to poke around and see if I can figure 
> it out. The docs at 
> http://people.apache.org/~stevencaswell/commons-lang-2.1/docs/apidocs/<http://people.apache.org/%7Estevencaswell/commons-lang-2.1/docs/apidocs/>came
from maven site:generate with Maven 
> 1.0.2, so I'm a bit confused as to why you get a different result.
>  
> 
> 
> A couple of questions. What is the JDK you are running the maven against? 
> and what op sys are you running it on. Not sure if either have any affect, 
> but it might be a place to start looking. My JDK is 1.4.2_08 and my op sys 
> is Windows XP.
>  
> 
> 
>  On 5/10/05, *Gary Gregory* <ggregory@seagullsoftware.com> wrote:
> 
> Steven:
> 
> When I look at the Javadocs here:
> 
> http://people.apache.org/~stevencaswell/commons-lang-2.1/docs/apidocs/in<http://people.apache.org/%7Estevencaswell/commons-lang-2.1/docs/apidocs/in>
> dex.html 
> 
> None of the comments from the package.html files show up in the package
> descriptions in the table in the frame:
> 
> http://people.apache.org/~stevencaswell/commons-lang-2.1/docs/apidocs/ov 
> <http://people.apache.org/%7Estevencaswell/commons-lang-2.1/docs/apidocs/ov>
> erview-summary.html
> 
> When I run a "maven site:generate" locally, I get the proper comments. I
> am using Maven 1.0.2.
> 
> How can this be?
> 
> Gary
> 
> -----Original Message-----
> From: Steven Caswell [mailto: steven.caswell@gmail.com]
> Sent: Wednesday, May 04, 2005 6:59 PM
> To: Jakarta Commons Developers List
> Subject: [lang] VOTE 2.1 release (new vote based on RC5)
> 
> RC5 is available at 
> http://www.apache.org/~stevencaswell/commons-lang-2.1<http://www.apache.org/%7Estevencaswell/commons-lang-2.1>
> 
> The significant change is the exclusion of the o.c.l.text package and
> associated javadocs, clover results, jdiff, clirr. I also found and 
> corrected the maven xdoc problem that caused the extra space between
> anchors
> and punctuation.
> 
> Hopefully we are ready to go with this one, so here is the vote:
> 
> [ ] +1
> [ ] -1
> 
> --
> Steven Caswell 
> steven.caswell@gmail.com
> 
> Take back the web - http://www.mozilla.org
>  
> 
> 
> 
> -- 
> Steven Caswell
> steven.caswell@gmail.com
> 
> Take back the web - http://www.mozilla.org 
>  



-- 
Steven Caswell
steven.caswell@gmail.com

Take back the web - http://www.mozilla.org

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message