ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 41292] New: - javadoc task: sourcepath for JDK sources broken
Date Thu, 04 Jan 2007 21:28:45 GMT
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=41292>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=41292

           Summary: javadoc task: sourcepath for JDK sources broken
           Product: Ant
           Version: 1.7.0
          Platform: Other
        OS/Version: Windows 2000
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Core
        AssignedTo: dev@ant.apache.org
        ReportedBy: andre.fuegenschuh@gmx.de


With the <javadoc> task I use a nested <packageset> element for my own project
packages and a the "sourcepath" attribute to link the JDK sources for to get
some descendant comments via {@inheritDoc}, like so:

class Foo extends JComponent {
  /**
   * {@inheritDoc}<p/>
   * My additional comments ...
   */
  public someJComponentMethod() {
    super.someJComponentMethod()
    ...
  }
}

My task looks like the following example:

<javadoc
  destdir="${destdir}"              // my output dir
  sourcepath="${sourcepath}"        // the *unzipped* JDK sources
  classpathref="${classpathref}"    // additional, external libraries.
  .../>

  ...
  <packageset dir="${src}"          // my sources dir
              includes="${pkg}/**"  // my project package
              excludes="${pkg.resources}/**"/>
  ...
</javadoc>

That way it works with Ant 1.6.*.

With Ant 1.7.0 (and Java 6 std. doclet), the entire JDK sources are loaded for
being documented!

task output:

Loading source files for package {my package}...
Loading source files for package {*all* JDK sources}...
...

I played a bit around with a combined <classpath> nested element and with
<excludepackage> and the like, but can't find a solution.

A bug (?) or is there another (new?) way to get the desired behaviour?

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message