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 23034 - [options] unclear mapping between JavaDoc and the JavaDoc Executor in advanced mode
Summary: [options] unclear mapping between JavaDoc and the JavaDoc Executor in advance...
Status: VERIFIED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Javadoc (show other bugs)
Version: 3.x
Hardware: PC Linux
: P1 blocker (vote)
Assignee: Chris Ledantec
URL:
Keywords: UI
Depends on:
Blocks:
 
Reported: 2002-05-02 09:44 UTC by Svata Dedic
Modified: 2003-02-04 14:12 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Svata Dedic 2002-05-02 09:44:57 UTC
There can be multiple JavaDoc Executors, each
customized for different  granularity, input or
output formats. The basic UI permits to work with
exactly one instance, but it's not clear which one
it is.
Comment 1 Svata Dedic 2002-05-02 10:12:56 UTC
Reassigning to the specification owner.
Comment 2 Chris Ledantec 2002-05-06 10:37:07 UTC
two possiblities: add a combo to the top of the Javadoc panel for
selecting the exector. then setting the default executor should live
with the defaults for c/d/e in Java Language. 

or: make the Javadoc panel where to select the exector and doclet and
modify the tree like so (this would address the doclet problem in
23035 too)

.
.
.
Javadoc
  +Javadoc Executors
     +e1
     +e2
     +e3
     +...
  +Doclets
     +d1
       +defs
       +generation
       +groups/links
       +text
     +d2
      ...

this makes the tree a little deeper here but does solve the problem...
Comment 3 Svata Dedic 2002-05-13 15:48:46 UTC
javadoc executors differ from javad executors by a few miles, IMHO.
The only thing they have in common is that they execute an external
process and pass FileSystems in some commandline parameter. 
While java executor is a recipe - or scheme - to execute user
programs, javadoc executor is a scheme how to process source code to
generate documentation (depth, granularity, ...). BTW maybe we should
change the name "javadoc executor" to something more user-friendly.
Comment 4 Chris Ledantec 2002-05-13 15:56:25 UTC
okay... i'll ask around to see if there about a better name.
Comment 5 Svata Dedic 2002-05-24 12:44:09 UTC
As the option system won't make it to 3.4, moving the reports to the
nearest later version/milestone
Comment 6 Chris Ledantec 2002-05-28 15:35:50 UTC
fixed this in the current revision of the doc.
Comment 7 Milan Kubec 2002-10-17 15:39:16 UTC
Would you point me to the doc to be able to verify the fix.
Comment 8 Chris Ledantec 2002-10-17 16:40:21 UTC
same as before though it has been pulled from the spec to be handled
by projects.

http://ui.netbeans.org/docs/hi/options/index.html
Comment 9 Svata Dedic 2002-10-17 18:25:51 UTC
Verified. The feature is going to be removed from Tools | Options so it does not
appear in T|O UI spec.