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 46055 - No way to add Javadoc to freerform project
Summary: No way to add Javadoc to freerform project
Status: CLOSED DUPLICATE of bug 47498
Alias: None
Product: projects
Classification: Unclassified
Component: Ant (show other bugs)
Version: 4.x
Hardware: All All
: P2 blocker (vote)
Assignee: Petr Hrebejk
URL:
Keywords:
Depends on:
Blocks: 42682
  Show dependency tree
 
Reported: 2004-07-12 17:15 UTC by John Jullion-ceccarelli
Modified: 2006-03-24 10:16 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 John Jullion-ceccarelli 2004-07-12 17:15:58 UTC 
Since there's no way to add a Java Class Library
to a freeform project's classpath (can only add
JAR file and source folder), there seems to be no
way to add Javadoc to the project.
Comment 1 Jesse Glick 2004-07-12 21:32:35 UTC 
If you just add a JAR your classpath that matches a defined Java
library, it should work.
Comment 2 John Jullion-ceccarelli 2004-07-13 09:48:37 UTC 
Yes but this is not obvious at all to the user - it wasn't even
obvious to the HIE who wrote the spec or the docs writer documenting
it :-). In the user's mind we've established the Library Manager/Java
Class Libraries as the mechanism for adding Javadoc and source code to
a project. Why not carry that over to freeform projects?
Comment 3 jrojcek 2004-07-13 10:37:12 UTC 
I have to admit that it really isn't straightforward. I suggest we allow the user to add also 
libraries to classpath. 

Also using the JDK (its sources and Javadoc) in freeform project is problematic.
Comment 4 Jesse Glick 2004-07-14 18:27:53 UTC 
It's backwards. You already have the classpath for a freeform project
defined, you are describing it. If you want to associate Javadoc
and/or source with an entry, you can create a Java Library with a
matching JAR. We *could* permit the GUI customizer for the freeform
project to let you pick a Java Library rather than a raw JAR for a
classpath entry, but I think this would rarely be used correctly, and
is more likely to cause confusion over what the freeform customizer
does (describe an existing project defined and structured
independently of the IDE) than be helpful.

Re. JDKs - a bit different. If you explicitly specify a boot classpath
(currently supported only in project.xml), it works just as for the
classpath - if the path matches a registered JDK, that JDK's docs and
sources will be used. Otherwise, the first JDK with a matching spec
version (1.4, etc.) in the Platform Manager will be used for finding
Javadoc, sources, and an exact list of classes to use in code completion.
Comment 5 jrojcek 2004-07-15 09:36:44 UTC 
So, a question: If I put a JAR into the classpath of regular J2SE project and a library 
containing that JAR already exists, is the javadoc and sources used for this JAR in that 
project?
Comment 6 Jesse Glick 2004-07-15 18:32:10 UTC 
Yes, they should be.
Comment 7 Jesse Glick 2004-08-19 17:01:07 UTC 
x
Comment 8 Jesse Glick 2004-08-19 17:01:21 UTC 

*** This issue has been marked as a duplicate of 47498 ***
Comment 9 Marian Mirilovic 2005-07-19 15:17:49 UTC 
verified duplicate