Bug 473112 - The Moving and Docking Views section isn't accurate
Summary: The Moving and Docking Views section isn't accurate
Status: RESOLVED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Doc (show other bugs)
Version: 4.6   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 4.6 RC3   Edit
Assignee: Patrik Suzzi CLA
QA Contact:
URL: http://help.eclipse.org/mars/topic/or...
Whiteboard:
Keywords: Documentation
Depends on:
Blocks:
 
Reported: 2015-07-20 16:39 EDT by Tony Weddle CLA
Modified: 2016-05-27 03:36 EDT (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Tony Weddle CLA 2015-07-20 16:39:17 EDT 
The help page in the URL field documents the facilities for moving views around, including detaching views from the main window. If mentions the "title bar" but views don't have title bars; they have tabs and menu/tool bars. This can be confusing if a view is detached and exists in its own window. The window has a title bar but the view can't be re-attached by dragging the title bar of the window; the tab must be used.

Also, there is a paragraph about using the "pop-up menu for the view". None of the ways mentioned, to get the pop-up view, work. There is no "title bar" for a view and left clicking the icon in the tab has no effect. Also, right clicking in the views tab or tool bar doesn't provide a menu with any of the options mentioned. At least not for any of the views I tried.

Lastly, the word "sortcut" is a misspelling of the word "shortcut".
Comment 1 Dani Megert CLA 2016-05-19 06:39:48 EDT 
Patrik, can you take that bug for RC3?
Comment 2 Dani Megert CLA 2016-05-20 10:51:44 EDT 
(In reply to Dani Megert from comment #1)
> Patrik, can you take that bug for RC3?

Ping!
Comment 3 Dani Megert CLA 2016-05-24 09:59:15 EDT 
(In reply to Dani Megert from comment #2)
> (In reply to Dani Megert from comment #1)
> > Patrik, can you take that bug for RC3?
> 
> Ping!

Patrik?
Comment 4 Patrik Suzzi CLA 2016-05-24 10:57:16 EDT 
(In reply to Dani Megert from comment #3)
> (In reply to Dani Megert from comment #2)
> > (In reply to Dani Megert from comment #1)
> > > Patrik, can you take that bug for RC3?

Yes, I will take it. Sorry for taking so long.
Comment 5 Patrik Suzzi CLA 2016-05-24 11:32:04 EDT 
For the mentioned points:

(1) I'm going to replace "title bar" with "tab", I think it is clear. 
See http://imgur.com/im6cMia

(2) I don't see any pop-up menu, so I'm going to delete the entire paragraph "You can also move a view by using the pop-up menu ..."

(3) Plus, the drop cursors are not used anymore, and my idea is to drop the table, and replace with a sentence like the following: 

While dragging the view, you will see a feedback that shows where the view will be moved to:
* A vertical bar: marks the insertion between other tabs / views. 
* A Rectangle: shows the positioning of the view in an empty area, like a when repositioning the view in the IDE layout, or when moving it in an external area.
* A Prohibition sign: signals you can not dock the view in this area.


What do you think?
Comment 6 Tony Weddle CLA 2016-05-25 02:12:34 EDT 
I'd be happy with that!
Comment 7 Eclipse Genie CLA 2016-05-25 04:49:23 EDT 
New Gerrit change created: https://git.eclipse.org/r/73562
Comment 8 Patrik Suzzi CLA 2016-05-25 04:51:44 EDT 
The document is updated. You get an idea of the changes via visual comparison: 
http://i.imgur.com/NCdlELb.png