JAL-1075 JAL-1062 documentation and new figure for db selection dialog

diff --git a/help/html/features/selectfetchdb.gif b/help/html/features/selectfetchdb.gif
new file mode 100644 (file)
index 0000000..6e1ce10
Binary files /dev/null and b/help/html/features/selectfetchdb.gif differ

diff --git a/help/html/features/seqfetch.html b/help/html/features/seqfetch.html
index a956d6d..e56fa7b 100755 (executable)
--- a/help/html/features/seqfetch.html
+++ b/help/html/features/seqfetch.html
@@ -23,24 +23,42 @@
 <p><strong>Sequence Fetcher</strong></p>
 <p>Jalview can retrieve sequences from certain databases using either the
 WSDBFetch service provided by the European Bioinformatics Institute, and, since Jalview 2.4, DAS servers capable of the <em>sequence</em> command (configured in <a href="dassettings.html">DAS settings</a>).</p>
-<img src="seqfetcher.gif" align="center" alt="The Jalview Sequence Fetcher Dialog Box">
-<p>The Sequence Fetcher dialog box can be opened via the &quot;File&quot; 
+       <img src="seqfetcher.gif" align="center"
+               alt="The Jalview Sequence Fetcher Dialog Box">
+       <p>The Sequence Fetcher dialog box can be opened via the &quot;File&quot; 
   menu on the main desktop in order to retrieve sequences as a new
   alignment, or opened via the &quot;File&quot; menu of an existing alignment
-  to import additional sequences. Please note, there will be a short delay when the sequence fetcher is first opened, 
+  to import additional sequences. There may be a short delay when the sequence fetcher is first opened, 
   whilst Jalview compiles the list of available sequence datasources from the 
-  currently defined DAS server registry.</strong>
+  currently defined DAS server registry.
 </p>
-<p>First, select the database you want to retrieve sequences from. Then, enter
+       <p>First, select the database you want to retrieve sequences from
+               by clicking the button labeled 'Select database retrieval source'. If
+               a database source is already selected, then the button's label will
+               change to show the currently selected database.</p>
+               <img src="selectfetchdb.gif" align="left" alt="Database selection dialog for fetching sequences (introduced in Jalview 2.8)">
+               <p>Since Jalview 2.8, the
+               available databases are shown as a tree in a popup dialog box. The
+               databases are ordered alphabetically, and if there are many sources
+               for the same type of sequence identifier, they will be grouped
+               together in a sub-branch branch labeled with the identifier.</p>
+       <p>Once you have selected the sequence database using the popup dialog box, enter
   one or more accession ids (as a semi-colon separated list), or press the 
   &quot;Example&quot; button to paste the example accession for the currently selected database into the retrieval box.
    Finally, press &quot;OK&quot; to initiate the retrieval.</p>
-<p>
+       <p><strong>Specifying chains for PDB IDs</strong>
   If you are retrieving sequences from the PDB, you can retrieve
   specific chains by appending a colon and the chain id to the PDB
-  id. For example :<br><pre> 1GAQ:A</pre><br>When retrieving from DAS sequence sources,
-  coordinate range arguments can be passed to the server using the standard DAS 
-  sequence command format (<strong>:&lt;start&gt;,&lt;end&gt;</strong>)</p>
+  id. For example :<br/><pre> 1GAQ:A</pre>
+  </p>
+   <p>
+    <strong>Only retrieving part of a sequence</strong> DAS sources
+    (indicated by a &quot;<em>(DAS)</em>&quot;) allow a range to be
+    specified in addition to a sequence ID. To retrieve 50 residues
+    starting at position 35 in UNIPROT sequence P73137 using the UNIPROT
+    DAS server, you would enter &quot;'P73137:35,84'.<br/><em>Full support for DAS range queries was introduced in Jalview 2.8</em>
+    </p>
+  
 <p>If you use the WSDBFetch sequence fetcher services (EMBL, Uniprot, PDB, PFAM, and RFAM)
    in work for publication, please cite:</p>
 <p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S., Tate J., Velankar 

diff --git a/help/html/features/seqfetcher.gif b/help/html/features/seqfetcher.gif
index 652976f..03ddd79 100644 (file)
Binary files a/help/html/features/seqfetcher.gif and b/help/html/features/seqfetcher.gif differ