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>
 <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
   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 
   whilst Jalview compiles the list of available sequence datasources from the 

-  currently defined DAS server registry.</strong>
+  currently defined DAS server registry.

 </p>
 </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>
   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
   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 
 <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