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 <[EMAIL PROTECTED]> 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:[EMAIL PROTECTED] > *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* <[EMAIL PROTECTED]> 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: [EMAIL PROTECTED] > 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 > [EMAIL PROTECTED] > > Take back the web - http://www.mozilla.org > > > > > -- > Steven Caswell > [EMAIL PROTECTED] > > Take back the web - http://www.mozilla.org > -- Steven Caswell [EMAIL PROTECTED] Take back the web - http://www.mozilla.org
