JAL-1620 version bump and release notes
[jalview.git] / help / html / menus / alwedit.html
1 <html>
2 <!--
3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2b1)
4  * Copyright (C) 2014 The Jalview Authors
5  * 
6  * This file is part of Jalview.
7  * 
8  * Jalview is free software: you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License 
10  * as published by the Free Software Foundation, either version 3
11  * of the License, or (at your option) any later version.
12  *  
13  * Jalview is distributed in the hope that it will be useful, but 
14  * WITHOUT ANY WARRANTY; without even the implied warranty 
15  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
16  * PURPOSE.  See the GNU General Public License for more details.
17  * 
18  * You should have received a copy of the GNU General Public License
19  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
20  * The Jalview Authors are detailed in the 'AUTHORS' file.
21  -->
22 <head>
23 <title>Alignment Window Menus</title>
24 </head>
25
26 <body>
27 <p><strong>Alignment Window Edit Menu</strong></p>
28 <ul>
29         <li><strong>Undo (Control Z)</strong><em><br>
30         This will undo any edits you make to the alignment. This applies to
31         insertion or deletion of gaps, cutting residues or sequences from the
32         alignment or pasting sequences to the current alignment or sorting the
33         alignment. <strong>NOTE:</strong> It DOES NOT undo colour changes,
34         adjustments to group sizes, or changes to the annotation panel. </em></li>
35         <li><strong>Redo (Control Y)<br>
36         </strong><em>Any actions which you undo can be redone using redo. </em></li>
37         <li><strong>Cut (Control X)<br>
38         </strong><em>This will make a copy of the currently selected residues
39         before removing them from your alignment. Click on a sequence name if
40         you wish to select a whole sequence. <br>
41         Use &lt;CTRL&gt; and X (&lt;APPLE&gt; and X on MacOSX) to cut.</em></li>
42         <li><strong>Copy (Control C)</strong><br>
43         <em>Copies the currently selected residues to the system clipboard
44         - you can also do this by pressing &lt;CTRL&gt; and C (&lt;APPLE&gt;
45         and C on MacOSX). <br>
46         If you try to paste the clipboard contents to a text editor, you will
47         see the format of the copied residues FASTA.</em></li>
48         <li><strong>Paste </strong>
49         <ul>
50                 <li><strong>To New Alignment (Control Shift V)<br>
51                 </strong><em>A new alignment window will be created from sequences
52                 previously copied or cut to the system clipboard. <br>
53                 Use &lt;CTRL&gt; and &lt;SHIFT&gt; and V(&lt;APPLE&gt; and
54                 &lt;SHIFT;&gt; and and V on MacOSX) to paste.</em></li>
55                 <li><strong>Add To This Alignment (Control V)<br>
56                 </strong><em>Copied sequences from another alignment window can be added
57                 to the current Jalview alignment. </em></li>
58         </ul>
59         </li>
60         <li><strong>Delete (Backspace)<br>
61         </strong><em>This will delete the currently selected residues without
62         copying them to the clipboard. Like the other edit operations, this can
63         be undone with <strong>Undo</strong>.</em></li>
64         <li><strong>Remove Left (Control L)<br>
65         </strong><em>If the alignment has marked columns, the alignment will be
66         trimmed to the left of the leftmost marked column. To mark a column,
67         mouse click the scale bar above the alignment. Click again to unmark a
68         column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
69         <li><strong>Remove Right (Control R)<br>
70         </strong><em>If the alignment has marked columns, the alignment will be
71         trimmed to the left of the leftmost marked column. To mark a column,
72         mouse click the scale bar above the alignment. Click again to unmark a
73         column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
74         <li><strong>Remove Empty Columns (Control E)<br>
75         </strong><em>All columns which only contain gap characters (&quot;-&quot;,
76         &quot;.&quot;) will be deleted.<br>
77         You may set the default gap character in <a
78                 href="../features/preferences.html">preferences</a>. </em></li>
79         <li><strong>Remove All Gaps (Control Shift E)</strong><br>
80         <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be deleted
81         from the selected area of the alignment. If no selection is made, ALL
82         the gaps in the alignment will be removed.<br>
83         You may set the default gap character in <a
84                 href="../features/preferences.html">preferences</a>. </em></li>
85         <li><strong>Remove Redundancy (Control D)<br>
86         </strong><em>Selecting this option brings up a window asking you to select
87         a threshold. If the percentage identity between any two sequences
88         (under the current alignment) exceeds this value then one of the
89         sequences (the shorter) is discarded. Press the &quot;Apply&quot;
90         button to remove redundant sequences. The &quot;Undo&quot; button will
91         undo the last redundancy deletion.</em></li>
92         <li><strong>Pad Gaps<br>
93         </strong><em>When selected, the alignment will be kept at minimal width (so
94         there are no empty columns before or after the first or last aligned
95         residue) and all sequences will be padded with gap characters 
96         before and after their terminating residues.<br>
97         This switch is useful when making a tree using unaligned sequences and
98         when working with alignment analysis programs which require 'properly
99         aligned sequences' to be all the same length.<br>
100         You may set the default for <strong>Pad Gaps</strong> in the <a
101                 href="../features/preferences.html">preferences</a>. </em></li>
102 </ul>
103 </body>
104 </html>