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 223537 - Documentation popup for tags in hibernate mappings file no helpful documentation
Summary: Documentation popup for tags in hibernate mappings file no helpful documentation
Status: RESOLVED FIXED
Alias: None
Product: xml
Classification: Unclassified
Component: Text-Edit (show other bugs)
Version: 7.3
Hardware: PC Windows 7
: P3 normal (vote)
Assignee: Svata Dedic
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-12-09 01:32 UTC by markiewb
Modified: 2013-04-04 16:45 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
Shows the nonhelpful documentation popup (46.31 KB, image/png)
2012-12-09 01:33 UTC, markiewb
Details

Note You need to log in before you can comment on or make changes to this bug.
Description markiewb 2012-12-09 01:32:54 UTC
[ BUILD # : 201212080001 ]
[ JDK VERSION : 1.7.0_09 ]

Code completion in hibernate mapping file (documentation auto popup is 
enabled)

ACTUAL: documentation popup shows no helpful description - only a duplicate 
of the tag - see screenshot
EXPECTED: show real documentation or leave it out

---
Product Version: NetBeans IDE Dev (Build 201212080001)
Java: 1.7.0_09; Java HotSpot(TM) 64-Bit Server VM 23.5-b02
Runtime: Java(TM) SE Runtime Environment 1.7.0_09-b05
System: Windows 7 version 6.1 running on amd64; Cp1252; de_DE (nb)
Comment 1 markiewb 2012-12-09 01:33:27 UTC
Created attachment 129092 [details]
Shows the nonhelpful documentation popup
Comment 2 Sergey Petrov 2012-12-13 09:06:11 UTC
yes, may be nice to remove completely or fill with some information, will try in 7.3
Comment 3 Sergey Petrov 2012-12-13 09:37:34 UTC
just tried to create sample xml in j2se and add
<!DOCTYPE web-app PUBLIC
        	"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        	"http://java.sun.com/dtd/web-app_2_3.dtd">

and got the same for completion of this "web.xml", itt's generic nb xml completion. hibernate support adds nothing here.
Comment 4 Svata Dedic 2013-04-04 11:39:21 UTC
Hm. When using DTD-based completion, no documentation is ever created. For XML Schema-based files, "documentation" can be created from the annotation/documentation elements, if present.

Even Hibernate 4.1 final schema files do no contain these supplemental elements, some brief descriptions are provided as comments (with no particular scheme of placement, once before the element, once after the element, especially if an element occupies just one line).
Comment 5 Sergey Petrov 2013-04-04 11:44:25 UTC
Is there any sense to show this popup without any real information?
Comment 6 Svata Dedic 2013-04-04 16:45:39 UTC
Of course it is a nonsense.
BTW - a GrammarQuery can be created within Hibernate support and generate the possible completions instead of the default DTD-based grammar. In that case, proper documentation may be attached to the proposed completions.

Fixed in http://hg.netbeans.org/jet-main/rev/2cb9a6de24ff