This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 177555 - javadoc menu ignores doc-files directories
Summary: javadoc menu ignores doc-files directories
Status: RESOLVED DUPLICATE of bug 151813
Alias: None
Product: java
Classification: Unclassified
Component: Project (show other bugs)
Version: 6.x
Hardware: All All
: P3 normal (vote)
Assignee: Tomas Zezula
URL: https://issues.apache.org/bugzilla/sh...
Keywords:
Depends on:
Blocks:
 
Reported: 2009-11-25 00:25 UTC by tinca
Modified: 2010-10-25 15:35 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description tinca 2009-11-25 00:25:37 UTC 
Following the recommended way as described http://java.sun.com/j2se/javadoc/writingdoccomments/ and using Run/Generate javadoc menu yields no doc-files dir in the destination (generated) javadoc dir. Doing it all on the command line works fine. 

Thanks!
Comment 1 Milan Kubec 2009-11-25 02:41:25 UTC 
It seems to be a problem of Ant javadoc task itself. We can fix it by adding copy task:

<copy todir="${dist.javadoc.dir}">
    <fileset dir="${src.dir}">
        <include name="**/doc-files/**"/>
    </fileset>
</copy>

after javadoc is generated.

I've found in Ant bug database that the problem has been already fixed in Ant dev builds, but after 1.7.1 release, so it's not in NetBeans yet. The fix will require to have 'docfilessubdirs' as additionalparam.

So I suggest to use copy task for now.
Comment 2 tinca 2009-11-25 03:50:39 UTC 
Thank you for the quick turnaround and workaround suggestion!
Comment 3 Jesse Glick 2009-11-25 09:35:50 UTC 
It's not WONTFIX, we do plan to fix it, just TBD how and exactly when. For example, when Ant 1.8.0 is released and we bundle it, this needs to be open as a reminder to use that new attribute.

Please also put the Ant bug in the URL field for reference.
Comment 4 Tomas Zezula 2009-11-26 02:20:27 UTC 
Thanks Milan
Comment 5 Jesse Glick 2009-11-26 11:19:10 UTC 
In fact that Ant bug report claims that you can fix this without <copy> today, using Ant 1.7.1:

  additionalparam="-docfilessubdirs"

It also works today from nbbuild/javadoctools/template.xml though I have not checked why. Might not work in j2seproject just due to use of <fileset> rather than <packageset>, in which case this should be marked as blocking bug #49026 (includes/excludes support).
Comment 6 tinca 2009-11-30 03:42:55 UTC 
(In reply to comment #5)

> It also works today from nbbuild/javadoctools/template.xml though I have not
Wanted to try this, but can't find such.

> checked why. Might not work in j2seproject just due to use of <fileset> rather
You mean a project that was created as type of Java SE?

Thanks!
Comment 7 Tomas Zezula 2009-11-30 03:47:35 UTC 
>> It also works today from nbbuild/javadoctools/template.xml though I have not
>Wanted to try this, but can't find such.
It's a NetBeans IDE build script.

>> checked why. Might not work in j2seproject just due to use of <fileset> rather
>You mean a project that was created as type of Java SE?
Yes. j2seproject is Java SE project.
Comment 8 Tomas Zezula 2010-10-25 15:35:10 UTC 

*** This bug has been marked as a duplicate of bug 151813 ***