carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/158/1/.cp/userguide/Task-Focused-Interface.html
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     1
<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     2
<html xmlns="http://www.w3.org/1999/xhtml">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     3
	<head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     4
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     5
		<title>Mylyn Reference - Task-Focused Interface</title>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     6
		<link type="text/css" rel="stylesheet" href="book.css"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     7
	</head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     8
	<body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     9
		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    10
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    11
				<th style="width: 100%" align="center" colspan="3">Task-Focused Interface</th>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    12
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    13
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    14
				<td style="width: 20%" align="left">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    15
					<a href="Task-Editor.html" title="Task Editor">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    16
						<img alt="Previous" border="0" src="images/images/prev.gif"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    17
					</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    18
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    19
				<td style="width: 60%" align="center"></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    20
				<td style="width: 20%" align="right">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    21
					<a href="Team-Support.html" title="Team Support">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    22
						<img alt="Next" border="0" src="images/images/next.gif"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    23
					</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    24
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    25
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    26
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    27
				<td style="width: 20%" align="left" valign="top">Task Editor</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    28
				<td style="width: 60%" align="center"></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    29
				<td style="width: 20%" align="right" valign="top">Team Support</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    30
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    31
		</table><hr/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    32
		<h1 id="Task-Focused_Interface">Task-Focused Interface</h1>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    33
		<p>The task-focused interface is oriented around tasks and offers several ways to focus the interface on only what is relevant for the currently active task.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    34
		<h2 id="Focusing_Navigator_Views">Focusing Navigator Views</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    35
		<p>You can focus navigator views (e.g. Package Explorer, Project Explorer, Navigator) by toggling the "Focus on Active Task" button in the toolbar. When focused, the view will show only the resources that are "interesting" for the currently active task.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    36
		<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    37
			<img border="0" src="images/Feature-Guide-3.0-Package-Explorer-Focused.png"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    38
		</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    39
		<h2 id="Alt.2BClick_Navigation">Alt+Click Navigation</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    40
		<p>To navigate to a new resource that is not a part of the active task's context, you can toggle "Focus on Active Task" off, browse to the resource, and then click "Focus on Active Task" again to see only relevant resources. A more efficient way to add new resources is to use Alt+Click navigation (Clicking the mouse while holding the Alt key).</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    41
		<p>When a view is in Focused mode, you can Alt+Click a node to temporarily show all of its children.  </p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    42
		<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    43
			<li>Once an element that was previously not interesting is selected with the mouse, it becomes interesting the other child elements will disappear. The clicked element is now a part of the task's context.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    44
			<li>Alt can be held down while clicking to drill down from a top-level element to a deeply nested element that is to be added to the task context.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    45
			<li>Multiple Alt+Clicks are supported so that you can add several elements to the task context. As soon as a normal click is made, uninteresting elements will disappear.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    46
			<li>Ctrl+Clicks (i.e. disjoint selections, use Command key on Mac) are also supported and will cause each element clicked to become interesting.  The first normal click will cause uninteresting elements to disappear.  Note that Ctrl+clicked elements will become interesting (turn from gray to black) but only the most recently-clicked one will be selected while Alt is held down.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    47
		</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    48
		<h2 id="Focusing_Editors">Focusing Editors</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    49
		<p>Some editors such as the Java editor support focusing. Clicking the Focus button in the toolbar will fold all declarations that are not part of the active task context.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    50
		<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    51
			<img border="0" src="images/Feature-Guide-3.0-Focused-Editor.png"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    52
		</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    53
		<h2 id="Task-focused_Ordering">Task-focused Ordering</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    54
		<p>When a task is active, elements that are interesting are displayed more prominently. For example, when you open the Java Open Type dialog (Ctrl+Shift+T), types that are interesting for the active task are shown first. Similarly, when you use ctrl+space to autocomplete a method name in a Java source file, methods that are in the task context are displayed at the top.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    55
		<h2 id="Working_Set_Integration">Working Set Integration</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    56
		<p>When Focus is applied to a navigator view, the working sets filter for that navigator view will be disabled. This ensures that you see all interesting elements when working on a task that spans working sets. To enforce visibility of only elements within one working set, do the following:</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    57
		<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    58
			<li>Set the view to show working sets as top-level elements.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    59
			<li>Use the 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    60
				<i>Go Into</i> action on the popup menu of the working set node in the view to scope the view down to just the working set.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    61
			</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    62
		</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    63
		<h2 id="Open_Task_dialog">Open Task dialog</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    64
		<p>An 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    65
			<i>Open Type</i> style dialog is available for opening tasks (<code>Ctrl+F12</code>) and for activating tasks (<code>Ctrl+F9</code>). The list is initially populated by recently active tasks.  The active task can also be deactivated via <code>Ctrl+Shift+F9</code>.  This can be used as a keyboard-only alternative for multi-tasking without the 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    66
			<i>Task List</i> view visible.  These actions appear in the 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    67
			<i>Navigate</i> menu.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    68
		</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    69
		<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    70
			<img border="0" src="images/Feature-Reference-3.0-Open-Task.png"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    71
		</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    72
		<h2 id="Task_Hyperlinking">Task Hyperlinking</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    73
		<p>In the task editor, comments that include text of the form bug#123 or task#123 or bug 123 will be hyperlinked.  Ctrl+clicking on this text will open the task or bug in the rich task editor.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    74
		<p>To support hyperlinks within other text editors such as code or .txt files, the project that contains the file must be associated with a particular task repository. This is configured by right-clicking on the project and navigating to "Properties" > "Task Repository" and selecting the task repository used when working with this project.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    75
		<h2 id="Reporting_Bugs_from_the_Error_Log">Reporting Bugs from the Error Log</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    76
		<p>Bugs can created directly from events in the 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    77
			<i>Error Log</i> view.  This will create a new repository task editor with the summary and description populated with the error event's details.  If the Connector you are using does not have a rich editor, the event details will be placed into the clipboard so that you can paste them into the web-based editor that will be opened automatically.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    78
		</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    79
		<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    80
			<img border="0" src="images/Feature-Reference-3.0-Error-Log.png"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    81
		</p><hr/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    82
		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    83
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    84
				<td style="width: 20%" align="left">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    85
					<a href="Task-Editor.html" title="Task Editor">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    86
						<img alt="Previous" border="0" src="images/images/prev.gif"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    87
					</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    88
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    89
				<td style="width: 60%" align="center">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    90
					<a href="Mylyn Reference.html" title="Mylyn Reference">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    91
						<img alt="Mylyn Reference" border="0" src="images/images/home.gif"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    92
					</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    93
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    94
				<td style="width: 20%" align="right">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    95
					<a href="Team-Support.html" title="Team Support">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    96
						<img alt="Next" border="0" src="images/images/next.gif"/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    97
					</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    98
				</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    99
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   100
			<tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   101
				<td style="width: 20%" align="left" valign="top">Task Editor</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   102
				<td style="width: 60%" align="center"></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   103
				<td style="width: 20%" align="right" valign="top">Team Support</td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   104
			</tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   105
		</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   106
	</body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   107
</html>