Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 56964

Summary: [content assist] Javadoc drawn under dock/screen during content assist
Product: [Eclipse Project] Platform Reporter: Channing Walton <channingwalton>
Component: TextAssignee: Platform-Text-Inbox <platform-text-inbox>
Status: RESOLVED FIXED QA Contact:
Severity: minor    
Priority: P3 CC: andre_weinand, iyers, malanon, michaelvanmeekeren, susan
Version: 3.0Keywords: helpwanted
Target Milestone: 3.3 M1   
Hardware: Macintosh   
OS: Mac OS X - Carbon (unsup.)   
Whiteboard:
Attachments:
Description Flags
Example of problem none

Description Channing Walton CLA 2004-03-31 15:08:02 EST
Whilst using content assist, quite often the javadoc popup is placed too low on the screen, dropping off 
the screen and/or is obscured by the dock.

Chang
Comment 1 Dani Megert CLA 2004-04-01 02:48:04 EST
Can you attach a picture.

Works on XP. André, do you also see this?
Comment 2 Channing Walton CLA 2004-04-01 03:05:06 EST
Created attachment 9085 [details]
Example of problem

This is an example of the javadoc popup appearing under the dock and dropping
off the bottom of the screen.
Comment 3 Dani Megert CLA 2005-02-09 05:30:56 EST
*** Bug 84735 has been marked as a duplicate of this bug. ***
Comment 4 Missing name CLA 2005-11-27 18:35:51 EST
This is an annoying bug - any chance of a fix in 3.2M4 ?
I am using 3.2M3.
Comment 5 Andre Weinand CLA 2005-11-28 06:29:19 EST
I can only reproduce this problem if the content assist window has been manually resized (made wider) so that there is not enough space left for the comments hover both on the left and right side of the content assist window. In this case the comments hover is placed beneath content assist, and the Dock is *not* respected.
Comment 6 Missing name CLA 2005-11-28 15:30:17 EST
Firstly let me note that this issue is with the supplementary "JavaDoc window" displayed via content assist and the supplementary "template preview" window displayed via content assist (this comes up when you up and down arrow on the template proposals).

Secondly, this happens if you are editing some thing in the lower half of the editor window; the lower you are the worse the problem.

In JBuilder, the windows are automatically drawn in the upper half i.e 

   1) find out which half of the editor you are in or if the window will fit
   2) if not flip it and draw it above/below content assist window accordingly

Cheers and goodwill.
Comment 7 Missing name CLA 2005-11-28 15:34:37 EST
(In reply to comment #5)
You are right, but there are times when the method signatures are long and the content assist window needs to be wider. So most of us just leave it wide enough.
But with suggestion in comment #6, this should never be a problem - each user can choose the width of their content assist window.
Comment 8 Dani Megert CLA 2005-11-29 13:01:31 EST
We allow the window to be placed on the left, right or bottom but not above because it would hide the text you're currently typing.

I've added code that prevents from drawing over the dock/task bar but this will not help you since the only thing this fix does is make the tool tip smaller.

There are two possible fixes
1) we allow to draw on top of the content assist popup *plus* line height
2) we do another iteration when trying right, left, bottom but with a smaller
   size

We are currently not working on this for 3.2 but will happily accept a good patch.
Comment 9 Missing name CLA 2005-11-29 15:23:52 EST
I am primarily a JBuilder user moving to Eclipse. I had spent some time building up knowledge about plugins for JBuilder and even developed a few useful plugins. 
I will have to start all over again to learn about Eclipse internals to submit a patch. Current projects are also keeping us very busy.

In anycase thanks for the time you guys are putting into this. Greatly appreciated.

Just a note on comment #8; Displaying the supplementary window above (as opposed to below) will not make any major difference. Presently, when you are closer to the lower half of the editor, the primary "content assist" window takes up a lot of space above the line being typed any way - so the suppl window will just sit above the content assist window. 

Time permitting - we should go for this solution.

Cheers and goodwill
Comment 10 Dani Megert CLA 2005-11-30 03:45:40 EST
We will have to see on all Platforms how it looks like: maybe the easiest solution is in fact to allow the additional popup to be above the content assist popup.
Comment 11 Dani Megert CLA 2006-04-13 15:06:41 EDT
*** Bug 136703 has been marked as a duplicate of this bug. ***
Comment 12 Tom Hofmann CLA 2006-06-19 05:52:15 EDT
This shouldn't happen any longer as the popup placement has been fixed to better choose a good location and size for both the proposal popup and the additional info.

Please reopen if you still see this in an upcoming build > 20060619.
Comment 13 Channing Walton CLA 2006-06-19 15:03:02 EDT
(In reply to comment #12)
> This shouldn't happen any longer ...

thanks Tom