Community
Participate
Working Groups
Build Identifier: 20100917-0705 A tooltip is opened with a calculated preferred size in a java editor after moving the mouse cursor over e.g. a method declaration. Unfortunately, this size is usually too small and has to be resized each time which is really annoying. It will be useful to have an option like "Remember Size". This feature has already been implemented in Quick Type Hierarchy. It is possible to enable "Remember Size" and "Remember Location" there. Additional information commandId: org.eclipse.ui.edit.text.showInformation keyBinding: F2 name: show tooltip description Reproducible: Always Steps to Reproduce: 1. Move the mouse cursor over a method declaration in a Java source file. 2. Resize the tooltip. 3. Move the mouse cursor over another method declaration in a Java source file. 4. Tooltip size is restored.
(In reply to comment #0) > 4. Tooltip size is restored. 4. Tooltip size has been reset.
In contrast to the Quick Type Hierarchy, we try to make the Javadoc hovers as small as possible initially (so that they show all contents but don't contain unnecessary white space). Therefore, the Javadoc hover size can only be a "Preferred maximum size". Since the hovers don't always start with the same size, and since you can move the mouse into the hovers and quickly resize them depending on how much you want to see of a specific hover, I think the best strategy is not a general "Remember size" mode, but an explicit "Remember as maximum size" action. That way, you can still resize the hovers dynamically without affecting the stored maximum. If you feel like you need to resize them all the time, the action would allow you to store a maximum size explicitly.
This is ok for me.
Created attachment 289380 [details] Javadoc label in Eclipse that shows a truncated returns clause.
Created attachment 289383 [details] The documentations and the labels size increased, but label is still short.
Created attachment 289386 [details] Returns element invisible following first sentence and four parameters.
(In reply to Markus Keller from comment #2) > In contrast to the Quick Type Hierarchy, we try to make the Javadoc hovers > as small as possible initially (so that they show all contents but don't > contain unnecessary white space). Therefore, the Javadoc hover size can only > be a "Preferred maximum size". I'd like to describe the current status, the way it appears in my Eclipse installation: The Javadoc tooltips (hovering labels) adapt to the amount of documentation that is provided for the Java element in question, but the way the size of the labels is calculated could be improved. More precisely, quite often it is too short and will cut off, for example, a "@returns" clause of a Javadoc snippet, even if enough screen space is available. I understand that those labels should not waste space but I personally would find it helpful when viewing a Java methods documentation to see most of the relevant documentation clauses, like parameters and return value, without resizing the label. I have attached parts of three screenshots to illustrate what I mean. The first image shows how even for a tiny Java method with only two parameters and a short introductory sentence the "@return" clause is omitted from the initially visible contents of the tooltip. The second image confirms your statement that the labels size does in fact adapt to the amount of documentation. But as the documentation also grew, the label still cuts out relevant content, even though just a few more pixels in height would suffice to render the whole Javadoc snippet. The final screenshot just shows, that if elements are added to a documentation snippet, the tooltip label grows further, but a relevant "@returns" clause is still invisible. I observe this behavior on Windows 10 with all recent Eclipse releases up to and including 2024-03 (precisely Version: 2024-03 (4.31.0) Build id: 20240307-1437 ). Only if consensus exists for that, I do suggest to render the complete Javadoc snippet that is provived for a Java declaration within Eclipses documentation tooltip (hovering label) unless a maximum size would be exceeded.
For reference, there are comments about this outside of Eclipses Bugzilla, for example: https://stackoverflow.com/questions/1988920/how-to-increase-content-assist-tooltip-size-in-eclipse-pdt https://stackoverflow.com/questions/41315314/changing-the-default-size-of-the-docstring-hover-tooltip-in-eclipse-pydev https://stackoverflow.com/questions/9735022/how-to-adjust-the-default-size-of-the-javadoc-popup-window-in-eclipse?rq=4 I am not involved in those.
