optional display of database refs and non-positional features
[jalview.git] / help / html / keys.html
index 6db5df4..61c55cc 100755 (executable)
 <body>\r
 <p><strong>Key Strokes</strong></p>\r
 <p>\r
-Jalview responds a number of key strokes, and has two distinct modes of\r
-keyboard operation. The <em>F2</em> key switches between 'Normal' and\r
-<a href="features/cursorMode.html">'Cursor'</a> mode operation.\r
+Jalview has two distinct modes of keyboard operation - in 'Normal'\r
+ mode, single keystrokes (including those shown next to menu items)\r
+ provide short cuts to common commands. In <a\r
+ href="features/cursorMode.html">'Cursor'</a> mode (enabled by\r
+ <em>F2</em>), some of these are disabled and more complex 'Compound\r
+ Keystrokes' can be entered to perform precise navigation, selection\r
+ and editing operations.\r
 </p>\r
 <table border="1">\r
-<tr>\r
-<td><strong>Key</strong></td><td><strong>Which Mode</strong></td><td><strong>Action</strong></td>\r
-</tr>\r
-<!--<tr>\r
+  <tr> \r
+    <td><strong>Key</strong></td>\r
+    <td><strong>Which Mode</strong></td>\r
+    <td><strong>Action</strong></td>\r
+  </tr>\r
+  <!--<tr>\r
 <td><strong>Escape</strong></td><td>Both</td>\r
 <td>The Panic button.</td></tr>\r
 <tr> -->\r
-<td><strong>\r
-Escape</strong></td><td>Normal</td>\r
-<td>Clears the current selection region,\r
-highlighted columns and highlghted residues.\r
-</td></tr><tr>\r
-<td><strong>Escape</strong></td><td>Cursor</td>\r
-As in normal mode, but also cancels any partially entered commands</td>\r
-</tr>\r
-<tr>\r
-<td><strong><em>F1</em></strong></td><td>Both</td>Show Help Documentation</td></tr>\r
-<tr>\r
-<td><strong><em>F2</em></strong></td><td></td><td>Toggle Cursor mode on / off</td>\r
-</tr>\r
-<tr>\r
-<td><strong>Control 'Z'</strong></td><td>Both</td><td>Undoes the last sequence edit</td>\r
-</tr>\r
-<tr>\r
-<td><strong>Up Arrow</strong></td><td>Normal</td>Moves selected sequence(s) up the\r
-alignment</td></tr>\r
-<tr>\r
-<td><strong>Down Arrow</strong></td><td>Normal</td>Moves selected sequence(s) down the\r
-alignment.</td></tr>\r
-<tr><strong>Cursor Keys<br>(Arrow Keys)</strong></td><td>Cursor</td><td>Move cursor around alignment</td>\r
-</tr>\r
-<tr>\r
-<td><strong>Control 'A'</strong></td><td>Both</td><td>Selects all sequences in the alignment</td>\r
-</tr>\r
-<tr>\r
-<td><strong>Control 'C'</strong></td><td>Both</td><td>Copies the selected region into\r
-the clipboard as a Fasta format file<br><em>nb. not available in applet, as no clipboard is available</em></td>\r
-</tr>\r
-<tr><td><strong>Control 'V'</strong></td><td>Both</td>Pastes the contents of the clipboard\r
-to a new \r
-  alignment window. (same as the Alignment Window menu Edit->Paste\r
-  command)<br><em>nb. if the paste is from a Jalview alignment, any\r
-  sequence and alignment annotations will also be copied over.</em></td>\r
-</tr>\r
-<tr>\r
-<td><strong>Control 'X'</strong></td><td>Both</td><td>Cuts the (fully) selected\r
-sequences from the alignment.<!-- not yet in this version \r
+  <tr> \r
+    <td><strong> Escape</strong></td>\r
+    <td>Normal</td>\r
+    <td>Clears the current selection region, highlighted columns and highlghted \r
+      residues. </td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Escape</strong></td>\r
+    <td>Cursor</td>\r
+    <td>As in normal mode, but also cancels any partially entered commands</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong><em>F1</em></strong></td>\r
+    <td>Both</td>\r
+    <td>Show Help Documentation</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong><em>F2</em></strong></td>\r
+    <td></td>\r
+    <td>Toggle Cursor mode on / off</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'Z'</strong></td>\r
+    <td>Both</td>\r
+    <td>Undoes the last sequence edit</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'Y'</strong></td>\r
+    <td>Both</td>\r
+    <td>Redo the last sequence edit undone.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Up Arrow</strong></td>\r
+    <td>Normal</td>\r
+    <td>Moves selected sequence(s) up the alignment</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Down Arrow</strong></td>\r
+    <td>Normal</td>\r
+    <td>Moves selected sequence(s) down the alignment.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Left Arrow</strong></td>\r
+    <td>Normal </td>\r
+    <td>Slides selected sequence(s) left. Press Alt key to slide in cursor mode</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Right Arrow</strong></td>\r
+    <td>Normal</td>\r
+    <td>Slides selected sequence(s) right. Press Alt key to slide in cursor mode</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Cursor Keys<br>\r
+      (Arrow Keys)</strong></td>\r
+    <td>Cursor</td>\r
+    <td>Move cursor around alignment</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Page Up</strong></td>\r
+    <td>Both</td>\r
+    <td>Scroll up the alignment view</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Page Down</strong></td>\r
+    <td>Both</td>\r
+    <td>Scroll down the alignment view</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'A'</strong></td>\r
+    <td>Both</td>\r
+    <td>Selects all sequences in the alignment</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'I'</strong></td>\r
+    <td>Both </td>\r
+    <td>Invert sequence selection. </td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control Alt 'I'</strong></td>\r
+    <td>Both </td>\r
+    <td>Invert column selection. </td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'C'</strong></td>\r
+    <td>Both</td>\r
+    <td>Copies the selected region into the clipboard as a Fasta format file<br> \r
+      <em>nb. not available in applet, as no clipboard is available</em></td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'V'</strong></td>\r
+    <td>Both</td>\r
+    <td> Paste the contents of the clipboard to the current alignment window. \r
+      (Alignment Window->Edit->Paste->Add to this Alignment)<br> <em>nb. if the \r
+      paste is from a Jalview alignment, any sequence and alignment annotations \r
+      will also be copied over.</em></td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control Shift 'V'</strong></td>\r
+    <td>Both</td>\r
+    <td>Paste the contents of the clipboard to a new alignment window. (Alignment \r
+      Window->Edit->Paste->To New Alignment)</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'X'</strong></td>\r
+    <td>Both</td>\r
+    <td>Cuts the (fully) selected sequences from the alignment. \r
+      <!-- not yet in this version \r
 This will not happen if only some\r
-columns are selected, you should use the <a href="features/regionHiding.html">Hide Regions feature</a> instead.--></td>\r
-</tr>\r
-<tr>\r
-<td><strong>Control 'F'</strong></td><td>Both</td><td>Launches the search\r
-window</td></tr>\r
+columns are selected, you should use the <a href="features/regionHiding.html">Hide Regions feature</a> instead.-->\r
+    </td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'F'</strong></td>\r
+    <td>Both</td>\r
+    <td>Launches the search window</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>H</strong></td>\r
+    <td>Both</td>\r
+    <td>Hides / Reveals selected columns and sequences</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'H'</strong></td>\r
+    <td>Both</td>\r
+    <td>Hides / Reveals selected columns</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Shift 'H'</strong></td>\r
+    <td>Both</td>\r
+    <td>Hides / Reveals selected sequences</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'O'</strong></td>\r
+    <td>Both</td>\r
+    <td>Input new alignment from file</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'S'</strong></td>\r
+    <td>Both</td>\r
+    <td>Save alignment with current filename and format</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control Shift 'S'</strong></td>\r
+    <td>Both</td>\r
+    <td>Save alignment as a new file or with a different format</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'P'</strong></td>\r
+    <td>Both</td>\r
+    <td>Opens the print dialog box to print the current view</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'W'</strong></td>\r
+    <td>Both</td>\r
+    <td>Closes the current view or the current alignment</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Backspace</strong></td>\r
+    <td>Normal</td>\r
+    <td>Delete the currently selected rows or columns from the alignment.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'L'</strong></td>\r
+    <td>Left</td>\r
+    <td>Remove columns to left of left-most column marker.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'R'</strong></td>\r
+    <td>Both</td>\r
+    <td>Remove columns to right of right-most column marker.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'E'</strong></td>\r
+    <td>Both</td>\r
+    <td>Remove gapped columns</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control Shift 'E'</strong></td>\r
+    <td>Both</td>\r
+    <td>Remove all gaps</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong>Control 'D'</strong></td>\r
+    <td>Both</td>\r
+    <td>Open the 'Remove redundancy' Dialog box.</td>\r
+  </tr>\r
+  <tr> \r
+    <td><strong></strong></td>\r
+    <td>Normal</td>\r
+    <td></td>\r
+  </tr>\r
 </table>\r
 <p>The compound commands available in the Cursor mode are summarised\r
 below. Single letter commands can be prefixed by digits to specify a repetition\r