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

Summary: No way to add Javadoc to freerform project
Product: projects Reporter: John Jullion-ceccarelli <johnjullion>
Component: AntAssignee: Petr Hrebejk <phrebejk>
Status: CLOSED DUPLICATE    
Severity: blocker CC: jrojcek
Priority: P2    
Version: 4.x   
Hardware: All   
OS: All   
Issue Type: DEFECT Exception Reporter:
Bug Depends on:    
Bug Blocks: 42682    

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