2.08, not 2.07
[jalview.git] / help / html / features / seqfeatures.html
index 2d8bce6..5283e38 100755 (executable)
@@ -1,29 +1,49 @@
 <html>\r
 <head><title>Sequence Features</title></head>\r
 <body>\r
-<p><strong>View&#8594;Sequence Features</strong></p>\r
-<p>When this option is selected, sequence features extracted from the <a href="http://www.ebi.uniprot.org/">Uniprot</a> \r
+<p><strong>Sequence Features</strong></p>\r
+<p>Jalview can colour parts of a sequence based on the presence of\r
+sequence features - which may be retrieved from database records (such\r
+as Uniprot), the result of <a href="search.html">sequence motif\r
+searches</a> or simply read from a <a\r
+href="featuresFormat.html">sequence features file</a>.</p>\r
+<p><strong>Sequence Feature Groups</strong></p>\r
+<p>Since Jalview 2.08, sequence features assigned to a sequence can be\r
+organised into groups, which may indicate that the features were all retrieved\r
+from the same database (such as Uniprot features), or generated by the\r
+same analysis process (as might be specified in a <a\r
+href="featuresFormat.html">sequence features file</a>).</p>\r
+<p><strong>Sequence Feature Inheritance</strong></p>\r
+<p>Since Jalview 2.08, sequence features are <em>global</em> to a set of\r
+sequences appearing (independently or together) in many different\r
+alignments. Practically, this means features loaded onto one alignment\r
+can be viewed in any alignments involving the same sequences. The same\r
+sequence appears in different alignments when a new alignment is\r
+generated by submitting an existing set of sequences to one of the\r
+alignment or prediction web services, and when sequences are copied\r
+and pasted into other alignment windows.</p>\r
+<p><strong>View&#8594;Show Sequence Features</strong></p>\r
+<p>Toggle the display of sequence features in this alignment. If\r
+feature retrieval has not already been carried out, then Jalview will\r
+automatically try to fetch sequence features (as described below).</p>\r
+<p><strong>View&#8594;Sequence Feature Settings...</strong>\r
+<p>Once sequence features have been loaded, their display can be fully\r
+  controlled using the alignment window's <a\r
+  href="featuresettings.html">Sequence Feature Settings</a> dialog\r
+  box. Feature colour schemes and display parameters are unique to a\r
+  particular alignment, so it is possible to colour the same sequence\r
+  features differently in different alignment views.</p>\r
+<p><strong>View&#8594;Fetch Sequence Features</strong></p>\r
+<p>When this option is selected, sequence features extracted from the\r
+  <a href="http://www.ebi.uniprot.org/index.html">Uniprot (http://www.ebi.unprot.org/index.html)</a>\r
   record for each sequence are displayed on the alignment.</p>\r
-<p>Jalview will attempt to retrieve sequence features from Uniprot files using \r
-  the EBI dbFetch web service using the given sequence names. A 100% match with \r
-  the Uniprot record is required to view the Sequence Features.</p>\r
-<p>More information about the feature is given in a tooltip, which is\r
-  viewed by moving the mouse pointer over a sequence feature. The\r
-  description associated with the feature will then be displayed in a small\r
-  label near the pointer.</p>\r
-<p><strong>View&#8594;Feature Settings...</strong>\r
-<p>Once sequence features have been loaded onto an alignment features can be hidden \r
-  or have their rendering priority changed using the Feature Settings dialog. \r
-  This displays all the features loaded, the colour and whether to display the \r
-  feature or not. You can easily change the colour by clicking the colour box.<br>\r
-  It is important to realise that the order in which features are drawn to the \r
-  alignment may result in overlapping features being hidden. Features at the foot \r
-  of the table are rendered first. Therefore features higher up the table will \r
-  be drawn over the top of lower featrues. You can change the order of the feature \r
-  priority by dragging the feature with your mouse. <br>\r
-  Use the transparency setting as another way to visualise overlapping features. \r
-<p><strong><em>You can save all features, with their current colours and visibility \r
-  in a Jalview format file. </em></strong>\r
+<p>Jalview will attempt to retrieve sequence features from Uniprot files using\r
+  the EBI dbFetch web service using the given sequence names (or\r
+  Uniprot ID, if available). A 100% match with\r
+  the Uniprot record is required for Uniprot features to be view on a sequence.</p>\r
+<p>More information about the feature is given in a tooltip, which is viewed by\r
+  moving the mouse pointer over a sequence feature. The description associated\r
+  with the feature will then be displayed in a small label near the pointer.</p>\r
 <p><strong>The Sequence Identification Process</strong>\r
 \r
   </p>\r
 \r
   </p>\r
 \r
-  <p> \r
+  <p>\r
   In some cases, the ID used to retrieve Uniprot records may be out of\r
   date and you will be notified of that a 100% match between the\r
   sequence and a Uniprot record was identified, but the sequence name\r
   must be manually changed (by right clicking on the sequence ID and selecting\r
   <strong>Sequence&#8594;Edit Name</strong>), before Jalview will show its sequence\r
-  features.<ul>\r
-  <li>remember to save your alignment if you have updated any of the\r
-  sequence IDs!\r
-  </li>\r
-  </ul></p>\r
+  features.\r
+<ul>\r
+  <li>remember to save your alignment if you have updated any of the sequence\r
+    IDs! </li>\r
+</ul>\r
+<p>Precalculated Sequence Features may be added to an alignment from the command\r
+  line, drag and drop, or from the &quot;File-&gt;Load Features / Annotations&quot;\r
+  menu item. See the <a href="featuresFormat.html">Features File Format</a> for\r
+  more details.</p>\r
 </body>\r
 </html>\r