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.
Summary: | javadoc as a mouse tooltip | ||
---|---|---|---|
Product: | java | Reporter: | Tomas Mysik <tmysik> |
Component: | Editor | Assignee: | Dusan Balek <dbalek> |
Status: | RESOLVED FIXED | ||
Severity: | blocker | CC: | dkolar, gapon, jrojcek, kalali, markiewb, mprentice, mwisnicki, phrebejk, pjiricka, tor |
Priority: | P2 | ||
Version: | -FFJ- | ||
Hardware: | All | ||
OS: | All | ||
Issue Type: | ENHANCEMENT | Exception Reporter: | |
Attachments: | Proposed patch |
Description
Tomas Mysik
2007-02-15 15:18:41 UTC
That would be absolutely wicked! I always find myself pointing the mouse cursor on a method name and waiting for the IDE to show some information. After a while I realize that this particular IDE won't show anything :-(. No matter how many times I've forced myself to remember that there are no tooltips on method names in Netbeans I keep doing the same thing over and over again. Could we please add tooltips? My forehead is aching... Thank you. There is an Alt-Shift-Space shortcut for poping up a javadoc info. It is likely to be changed to something else, see issue #91122. While clicking into a document and pressing a shortcut is much more complicated that just hovering a mouse it can still be useful. yes, I know about ALT+SHIFT+SPACE but it's very annoying I think... when you're reading some sources it's "really slow, unpleasant etc." - I'm sure you know what I mean... (once more, try eclipse, you'll find out what I'm speaking about) Absolutely agree this is needed. I agree with Vita, I would hate it too. Based on where my mouse is, which is very random when I edit, the editor would show some arbitrary Javadoc. Sometimes maybe in pretty large popup and will hide parts of my editor. I see that eclipse lovers will argue about this a lot. Therefor may please HIE look at this issue and decide. In eclipse this is *not* random process - when you are typing no javadoc appears - you have to move your mouse again. I agree that javadoc (or any other mouse tooltips) should not show during typing. Just an idea: Maybe show the tooltip only when Ctrl is pressed. This works nicely with the "inspection" and "navigation" use case. The user wants to know what a method is about, she clicks Ctrl and hovers the mouse over the method, she reads the Javadoc which shows up immediately (if Ctrl is clicked). If the javadoc info is not enough she clicks the method link to see the implementation. Not very discoverable, but once the user finds it, I think it would work nicely. *** Issue 150638 has been marked as a duplicate of this issue. *** *** Bug 61050 has been marked as a duplicate of this bug. *** *** Bug 67774 has been marked as a duplicate of this bug. *** *** Bug 71805 has been marked as a duplicate of this bug. *** Created attachment 140777 [details]
Proposed patch
I like to propose a patch to solve this issue.
@Dusan: Please review this patch. It is more like a proof-of-concept, because it some caveats:
* hovering is slowed down by resolving the javadoc data
* not all HTML tags in the javadoc are rendered properly because internally the FastHTMLRenderer (?) is used
* tooltip get very large if you display large javadoc text (f.e. of java.util.HashMap)
(In reply to markiewb from comment #12) > * tooltip get very large if you display large javadoc text (f.e. of > java.util.HashMap) -> related to https://netbeans.org/bugzilla/show_bug.cgi?id=217324 Fixed in jet-main. http://hg.netbeans.org/jet-main/rev/c0d35747e100 How can I tell which version of NetBeans 8 contains this fix? I'm currently using NetBeans IDE 8.0 Beta (Build 201401141042) on Ubuntu 13.10 x64. Does this fix include hover support? The issues duplicated to this one appear to all require hover support. So it must be included. There is a mention about Ctrl hovering but that doesn't appear to work, nor does simply hovering over a method. I've looked through the menus and Editor settings but I can't find any way to turn this on. OK, this does appear to work, but has some room for improvement. Holding down Ctrl does indeed enable this feature. Mousing over a method and pressing Ctrl does not work however. You need to actually move the mouse to get the tooltip to appear. So holding Ctrl and then moving the mouse is more effective. Performance could certainly use a bit of a boost as the tooltips often take 0.5-2s longer than expected to appear. Thanks for getting this much implemented, it should be quite useful! |