JAL-1683 replace year/version strings with tokens in source
[jalview.git] / help / html / features / featuresettings.html
index c0fbf32..c433e1f 100755 (executable)
@@ -1,21 +1,24 @@
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)
- * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
  * 
  * This file is part of Jalview.
  * 
  * Jalview is free software: you can redistribute it and/or
  * modify it under the terms of the GNU General Public License 
- * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
- * 
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *  
  * Jalview is distributed in the hope that it will be useful, but 
  * WITHOUT ANY WARRANTY; without even the implied warranty 
  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
  * PURPOSE.  See the GNU General Public License for more details.
  * 
- * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
--->
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
 <head>
 <title>Sequence Feature Settings Dialog Box</title>
 </head>
@@ -36,7 +39,30 @@ they are currently being displayed (only the ticked features and groups
 are displayed). <strong><em>You can change the colour or
 shading style used for a feature in the associated alignment by clicking
 on its colour box.</em></strong></p>
-<p><strong><em>Feature settings pop-up menu</em></strong><br>
+       <p>
+               <a name="selectbyfeature"><strong><em>Selecting
+                                       alignment columns by feature</em></strong></a><br> <strong>Double-clicking
+                       a feature type</strong> in the <strong>Feature
+                       Settings</strong> dialog allows you to select columns in the
+               alignment that contain (or do not contain) features of that type. If a
+               region of the alignment is currently selected, then only features in
+               the current selection will be searched. The following keys affect the
+               way in which selections are made:<ul>
+               <li>Hold down <strong>Alt</strong> to select columns not
+                       containing features of a particular type.
+               </li>
+               <li>Hold down <strong>Shift</strong> to add columns to the
+                       current selection.
+               </li>
+               <li>Press <strong>Command/Windows key</strong> to toggle column
+                       selection state (XOR)
+               </li>
+       </ul>
+       Options are also provided in the feature's pop-up menu (see below).
+       <br />
+       <em>Select columns by feature was added in Jalview 2.8.1</em>
+       </p>
+  <p><strong><em>Feature settings pop-up menu</em></strong><br>
 <strong>Right-click</strong> on a feature to open a pop-up menu that
 allows you to sort the alignment or current selection using that feature
 type (see below), or toggle the type of colouring used for the feature.
@@ -50,8 +76,8 @@ alignment based on the average score or total number of currently active
 features and groups on each sequence. To order the alignment using a
 specific feature type, use the <em>sort by ..</em> entries in the pop-up
 menu for that type.<br>
-<em>Feature sorting and graduated feature colouring was introduced
-in jalview 2.5</em></p>
+<em>Feature sorting and graduated feature colouring were introduced
+in Jalview 2.5</em></p>
 
 <p><strong>Transparency and Feature Ordering</strong></p>
 <p>It is important to realise that sequence features are often not
@@ -59,7 +85,7 @@ distinct and often overlap (for example, a metal binding site feature
 may be attached to one position along a stretch of sequence marked with
 a secondary structure feature).</p>
 <p>The ordering of the sequence features in the dialog box list is
-the order used by jalview for rendering sequence features. A feature at
+the order used by Jalview for rendering sequence features. A feature at
 the bottom of the list is rendered <em>below</em> a feature higher up in
 the list.<br>
 <em><strong>You can change the order of a feature by