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 23035

Summary: [options] Only one doclet supported ?
Product: java Reporter: Svata Dedic <sdedic>
Component: JavadocAssignee: Chris Ledantec <cledantec>
Status: CLOSED FIXED    
Severity: blocker Keywords: UI
Priority: P1    
Version: 3.x   
Hardware: PC   
OS: Linux   
URL: http://ui.netbeans.org/docs/hi/options/index.html#projectsjavadoc
Issue Type: DEFECT Exception Reporter:

Description Svata Dedic 2002-05-02 09:49:20 UTC
The basic UI supports settings for exactly one
doclet - the default one. There are several
commercional doclets, which are widely used bcs
they generate pre and post conditions into
documentation using custom JavaDoc tags.
Again, the mapping between this page and doclet
instances in Advanced mode is not specified.
Comment 1 Svata Dedic 2002-05-02 10:12:33 UTC
Reassigning to the specification owner.
Comment 2 Chris Ledantec 2002-05-06 10:03:33 UTC
:-) yes i realized this after redesigning it to behave more like a
compiler. this leads me to think that it should be a separate dialog
for editing the selected doclet -something similar to the original
design. you objected to a separate dialog then so here's your chance
to make another suggestion.

cL
Comment 3 Svata Dedic 2002-05-06 15:01:51 UTC
I objected against the pop-up dialogs, bcs. they feel very differently
from the rest of the Tools | Options system. Unlike all "browse..."
and such helper modal popups, these were quite complex.

Maybe either of suggestion in issue #23034 would work well. Please
note that doclets behave much like the compilers. There may be
multiple "engines" - especially the commercionally available ones can
have an extended set of options.
There's quite a few of options in the Doclet; the compiler-style combo
doclet switcher won't be good here.
So the options here I think are (as you suggested in 23034):
+ JavaDoc
    + Doclets
        +d1
          + category1
or
+ JavaDoc
    + Doclets
        +d1
and make the categories tabs in the right dialog: there will be only a
fixed (rather small) number of them, for any particular the doclet type. 

Now, what UI will be used create a new doclet definition ? Or could we
just allow to plug in and leave the doclet management (creation,
deletion) to the Advanced ?
Comment 4 Chris Ledantec 2002-05-09 17:27:40 UTC
it seems to me that limiting it to advanced wouldn't be consistent
with how we are treating other service types... the problem is that
there isn't much room for changing the layout of the ui for the
doclets so the stuff will have to be broken into more panels.
Comment 5 Svata Dedic 2002-05-13 15:16:37 UTC
so either more panels enlarging the tree, or tabbed dialog at the
right with those panels on individual tabs (one level taken from the
tree), OK ?

Comment 6 Chris Ledantec 2002-05-13 15:39:50 UTC
i've got a sketch that involves more nodes since tabs aren't used
anywhere else i'd like to see how it works without the tab approach...
i'll post it next week as i'm getting ready to visit a customer the
last half of this week.

cL
Comment 7 Svata Dedic 2002-05-24 12:44:05 UTC
As the option system won't make it to 3.4, moving the reports to the
nearest later version/milestone
Comment 8 Chris Ledantec 2002-05-28 15:36:21 UTC
fixed this in the current revision of the doc
Comment 9 Milan Kubec 2002-10-17 15:44:37 UTC
Svato, please could you verify this, I cannot find mentioned part at all.
Comment 10 Milan Kubec 2005-07-12 13:50:46 UTC
Closing.