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

Bug 318819

Summary:	Incorrect documentation in Workbench User Guide - Getting Started->Basic Tutorial->Rearranging Views and Editors->Drop Cursors
Product:	[Eclipse Project] Platform	Reporter:	Daniel Alvarez Arribas <daniel.alvarez>
Component:	Doc	Assignee:	Dani Megert <daniel_megert>
Status:	RESOLVED FIXED	QA Contact:
Severity:	trivial
Priority:	P3	CC:	daniel_megert
Version:	3.6
Target Milestone:	3.7 M1
Hardware:	All
OS:	All
Whiteboard:

Description Daniel Alvarez Arribas

2010-07-04 16:23:55 EDT

Build Identifier: 20100617-1415

The Workbench User Guide section "Getting Started->Basic Tutorial->Rearranging Views and Editors->Drop Cursors" states the following:

"Restricted: If the mouse button is released when a restricted cursor is displayed, the view will not dock there. For example, a view cannot be docked in the editor area"

At least the example provided is incorrect. I tried dragging a view (e.g. the project explorer or the outline view) on the editor area, but the "restricted" drop cursor did not appear. Instead the cursor became a regular dock cursor and I could successfully place the view either above, below, left or right of the editor area. Minimizing the editor will automatically maximize any adjacent view, thus effectively placing the view in the editor area. IIUC this means it is possible to dock a view in the editor area. In any case, no "restricted" drop cursor is shown.

I would have fixed the docs myself if the docs allowed for user-contributed changes...

Reproducible: Always

Steps to Reproduce:
1. Start Eclipse Helios (I use Eclipse IDE for Java EE).
2. On the Welcome page click on "Workbench basics"
3. In the index tree select Getting Started->Basic Tutorial->Rearranging Views and Editors->Drop Cursors"
4. There you are.

Comment 1 Daniel Alvarez Arribas

2010-07-04 18:09:28 EDT

"Minimizing the editor will automatically maximize any adjacent
view, thus effectively placing the view in the editor area."

To avoid confusion with actual maximizing... I actually meant: "Minimizing the editor will automatically enlarge adjacent views to occupy the space freed up by the minimized editor, thus effectively placing a view in the editor area."

Comment 2 Dani Megert

2010-07-05 04:25:50 EDT

Fixed in /org.eclipse.platform.doc.user/gettingStarted/qs-39c.htm.

>I would have fixed the docs myself if the docs allowed for user-contributed
>changes...
You can check out the doc from CVS, fix it and attach a patch to the bug report.