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 145863 - javadoc error badges do not work correctly
Summary: javadoc error badges do not work correctly
Status: RESOLVED FIXED
Alias: None
Product: editor
Classification: Unclassified
Component: Hints & Annotations (show other bugs)
Version: 6.x
Hardware: PC Linux
: P3 blocker with 1 vote (vote)
Assignee: Max Sauer
URL:
Keywords:
Depends on:
Blocks: 154718
  Show dependency tree
 
Reported: 2008-09-02 09:29 UTC by mgoe
Modified: 2008-12-05 14:36 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 mgoe 2008-09-02 09:29:24 UTC
In NetBeans IDE 6.5 Beta (Build 200808111757) javadoc error badges do not work correctly. Sometimes they don't work at 
all, sometimes they work for some time. This makes this feature useless (therefore P1). I'm using "Show As: 
Warning", "Scope: private" for "Create Javadoc" and "Error in Javadoc".
Comment 1 Max Sauer 2008-09-02 09:53:07 UTC
According to our bug priority guidelines, this is a P3, sorry. Could you please provide some use cases, example files, scenarios and your system 
specification and your messages.log file? (located in your userdir, usually $HOME/.netbeans/<version>/var/log/messages.log) In the meantime, I'll make 
some overall investigation. Thanks.
Comment 2 Max Sauer 2008-09-02 10:23:44 UTC
I've just tried and everything works correctly for me in

Product Version: NetBeans IDE Dev (Build 080901)
Java: 1.5.0_13; Java HotSpot(TM) Client VM 1.5.0_13-119
System: Mac OS X version 10.5.3 running on i386; MacRoman; en_US (nb)
Comment 3 mgoe 2008-09-02 10:34:11 UTC
Unfortunately I don't have a way to reproduce. As I said sometimes it works and sometimes it doesn't.

The Bug Priority Guidelines on http://wiki.netbeans.org/BugPriorityGuidelines say:
P1: "Product feature does not work, no workaround exists"
This is the case and therefore I think P1 is correct.
P3: "Part of a product feature is affected, a viable workaround exists"
As far as I can see there is no workaround available and therefore it can't be P3.

I'm using an openSUSE 11 System with Intel Core2 CPU and 3GB RAM with jdk 1.6.0_10-rc-b27.

The only suspicious messages in the log files are:
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.db uses org.openide.options which is deprecated: 
Use org.openide.util.NbPreferences instead.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.ide.kit uses 
org.netbeans.modules.editor.highlights which is deprecated: Use org.netbeans.spi.highlighting (Editor Library 2) 
instead.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.xml.text uses 
org.netbeans.modules.editor.deprecated.pre61completion which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.j2ee.common uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.web.core uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.j2ee.persistence uses 
org.netbeans.modules.editor.deprecated.pre61completion which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.j2ee.ejbcore uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.web.refactoring uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.visualweb.insync uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd uses 
org.netbeans.modules.editor.deprecated.pre61completion which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd uses org.openide.options which is deprecated: 
Use org.openide.util.NbPreferences instead.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.editor uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.editor uses org.openide.options which is 
deprecated: Use org.openide.util.NbPreferences instead.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.model.services uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.classview uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.completion uses 
org.netbeans.modules.editor.deprecated.pre61completion which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.modelimpl uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.refactoring uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.gotodeclaration uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.qnavigator uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.cnd.navigation uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.asm uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.visualweb.designer.jsf uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.web.jsf.navigation uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.web.jsf.navigation uses org.openide.options which 
is deprecated: Use org.openide.util.NbPreferences instead.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.javascript.editing uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.j2ee.ejbjarproject uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.profiler uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.groovy.editor uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.visualweb.palette uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.visualweb.project.jsfloader uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.j2ee.websphere6 uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.core.modules]: the module org.netbeans.modules.web.struts uses 
org.netbeans.modules.editor.deprecated.pre61settings which is deprecated.
WARNING [org.netbeans.modules.editor.settings.storage.ProfilesTracker]: Ignoring profile 'NetBeansEarth', it's got the 
same display name as 'Earth
WARNING [org.netbeans.editor.DrawLayerList]: Using deprecated DrawLayer: highlight-layer z-order: 3000 class: 
org.netbeans.modules.editor.highlights.HighlightLayer Layer class 
org.netbeans.modules.editor.highlights.HighlightLayer, name='highlight-layer
WARNING [org.netbeans.editor.DrawLayerList]: Using deprecated DrawLayer: annotation-layer z-order: 2100 class: 
org.netbeans.editor.DrawLayerFactory$AnnotationLayer Layer class org.netbeans.editor.DrawLayerFactory$AnnotationLayer, 
name='annotation-layer
Comment 4 Max Sauer 2008-09-02 12:17:35 UTC
Sorry, but this is not a P1 issue. P1 would be appropriate in case there was ie. a deadlock, dataloss, non-functional editor... You can write the javadoc 
yourself -- that's the workaround imo. Thanks for the additional info. Note that P3 does not mean this issue won't be fixed -- in fact, most of fixed issues 
are P3. Thanks for your understanding.
Comment 5 Max Sauer 2008-09-02 12:44:44 UTC
One more question: What type of project are you working on? (ie. j2se project, netbeans module project, web-type project...)

In case it is a Netbeans-Module-Type project, note that the javadoc hints are designed to be shown only for packages considered publicly accessible for 
use by other compilation units. If not, then even public classes in the package should be treated as effectively private by the IDE (though the Java compiler 
will not forbid you to access them). 
Comment 6 mgoe 2008-09-02 14:20:02 UTC
It's a module suite project. I wasn't aware that the checks are only performed for (module) public packages. So I 
can't say for sure if my observation was caused by this "feature". Would it be possible to check the entire project 
(all classes regardless of module accessibility and access modifiers)? Perhaps as an additional option? This would be 
very useful if all classes should be documented.
Comment 7 Max Sauer 2008-09-02 14:34:46 UTC
Yes, I agree it is not very clear at first glance. I'll add new option (a checkbox), something like 'Consider package accessibility' or something like that.
Comment 8 mgoe 2008-09-02 14:41:39 UTC
That would be great. Thank you.
Comment 9 Max Sauer 2008-09-22 10:10:53 UTC
I've added a checkbox (in fact, two checkboxes) to preferences (Tools|Options|Editor|Hints|Javadoc|Create Javadoc/Error in Javadoc), which should enable 
these hints even for publicly inaccessible packages. Marking as fixed, please verify.
---
http://hg.netbeans.org/main/rev/eb4e857c11de
Comment 10 Quality Engineering 2008-09-22 17:27:39 UTC
Integrated into 'main-golden', will be available in build *200809221401* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main/rev/eb4e857c11de
User: Max Sauer <msauer@netbeans.org>
Log: #145863: javadoc error badges do not work correctly