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 140132 - Generate Javadoc for Project menu should not be in PHP/Ruby distro
Summary: Generate Javadoc for Project menu should not be in PHP/Ruby distro
Status: RESOLVED FIXED
Alias: None
Product: projects
Classification: Unclassified
Component: Generic Infrastructure (show other bugs)
Version: 6.x
Hardware: All All
: P2 blocker (vote)
Assignee: Milos Kleint
URL:
Keywords: UI
Depends on:
Blocks:
 
Reported: 2008-07-15 17:03 UTC by Petr Jiricka
Modified: 2008-07-18 17:49 UTC (History)
4 users (show)

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 Petr Jiricka 2008-07-15 17:03:22 UTC
The Build Generate Javadoc for Project menu item is included in all distros, including PHP and Ruby. It should not be
available there - should be only in Java-based distros.
Comment 1 Jesse Glick 2008-07-16 15:21:23 UTC
This is part of project infrastructure (projectui to be specific). It could be hidden rather than disabled when
inapplicable to the selected project. Of course the same argument could be made for any of the project-sensitive actions
in the main menu - not sure if there is a consistency issue here. (IIRC, Build Project will already be hidden when
inapplicable.)

Also probably it would be wise to change the name to e.g. "Document Project" so it could potentially be bound more
generically, e.g. to build HTML documentation for any of the various C/C++ inline doc formats, or in a happier world
LaTeX from Literate Haskell, etc. etc.
Comment 2 Milos Kleint 2008-07-17 13:08:16 UTC
I'm also for Document Project name change. However as I understand it, it will still be disabled in php distro. Is that
ok, or is explicit removal requested?
Comment 3 Martin Krauskopf 2008-07-17 14:05:08 UTC
For Ruby distro "Generate Javadoc" should be hidden as Jesse said. If it is changed to "Document Project" we can utilize
it in Ruby (to build RDoc).
Comment 4 Petr Pisl 2008-07-17 14:18:49 UTC
From PHP distro point of view, it will be better to not have it there. At leas from my point of view. IMHO just
disabling can be misleading for users, who use only PHP IDE. If the action is presented here, but disabling, user will
think what he has to do to enable this action and start to use it. 

Document project name is much better and fits other technologies as well. In the future we want to support PHP
Documentor, which is equivalent to javadoc.
Comment 5 Milos Kleint 2008-07-18 09:56:56 UTC
for now (6.5) the action gets added only when java projects are enabled.
http://hg.netbeans.org/main/rev/74da38add0e5

A generic "Create Documentation" action can be created once the need arises. The ActionProvider's javadoc action name is
defined in java.project anyway as well.
Comment 6 Jesse Glick 2008-07-18 17:49:57 UTC
I think the proper fix would be for there to be an action defined in Actions, "document", labelled "Document Project",
registered in projectui but hidden unless enabled. The current patch should be OK for 6.5 since the action was already
defined in java.project.