Merge remote-tracking branch 'origin/develop' into feature/JAL-2587
authorkiramt <k.mourao@dundee.ac.uk>
Thu, 10 Aug 2017 13:54:37 +0000 (14:54 +0100)
committerkiramt <k.mourao@dundee.ac.uk>
Thu, 10 Aug 2017 13:54:37 +0000 (14:54 +0100)
19 files changed:
help/help.jhm
help/helpTOC.xml
help/html/calculations/calculatedialog.png [new file with mode: 0644]
help/html/calculations/calculations.html [new file with mode: 0644]
help/html/calculations/pca.html
help/html/calculations/tree.html
help/html/features/search.html
help/html/features/search.png [new file with mode: 0644]
help/html/features/searchclearhist.png [new file with mode: 0644]
help/html/features/searchhist.png [new file with mode: 0644]
help/html/features/viewingpdbs.html
help/html/menus/alignmentMenu.html
help/html/menus/alwcalculate.html
help/html/releases.html
help/html/whatsNew.html
src/jalview/gui/Jalview2XML.java
src/jalview/gui/SliderPanel.java
src/jalview/viewmodel/AlignmentViewport.java
test/jalview/gui/AlignFrameTest.java

index 363f549..cb0c4c4 100755 (executable)
    <mapID target="calcs.alconserv" url="html/calculations/conservation.html"/>
    <mapID target="calcs.alstrconsensus" url="html/calculations/structureconsensus.html"/>  
    <mapID target="calcs.consensus" url="html/calculations/consensus.html"/>   
+   <mapID target="calcs.dialog" url="html/calculations/calculations.html"/>
    
    <mapID target="nucleicAcids" url="html/na/index.html"/>
    
index a8aadf5..f3311a7 100755 (executable)
@@ -24,6 +24,7 @@
        <tocitem text="Jalview Documentation" target="home" expand="true">
                        <tocitem text="What's new" target="new" expand="true">
                                <tocitem text="Latest Release Notes" target="release"/>
+        <tocitem text="Calculations Dialog" target="calcs.dialog"/>
                                <tocitem text="Groovy Features Counter example" target="groovy.featurescounter"/>
                                <tocitem text="Custom Colourschemes in Groovy" target="groovy.colours"/>
                                <tocitem text="Omit hidden regions in Overview" target="overview"/>
                
                <tocitem text="Calculations" expand="false">
                        <tocitem text="Sorting alignments" target="sorting" />
-                       <tocitem text="Calculating trees" target="trees" />
-                       <tocitem text="Principal Component Analysis" target="pca" />
+                       <tocitem text="Trees and PCA" target="calcs.dialog" expand="false">
+                         <tocitem text="Calculating trees" target="trees" />
+                         <tocitem text="Principal Component Analysis" target="pca" />
+                       </tocitem>
                        <tocitem text="Tree/PCA Input Data" target="recoverInputdata" />
                        <tocitem text="Pairwise Alignments" target="pairwise" />
                        <tocitem text="Remove Redundancy" target="redundancy" />
diff --git a/help/html/calculations/calculatedialog.png b/help/html/calculations/calculatedialog.png
new file mode 100644 (file)
index 0000000..fdc0c0d
Binary files /dev/null and b/help/html/calculations/calculatedialog.png differ
diff --git a/help/html/calculations/calculations.html b/help/html/calculations/calculations.html
new file mode 100644 (file)
index 0000000..c194cd9
--- /dev/null
@@ -0,0 +1,55 @@
+<html>
+<!--
+ * 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.
+ *  
+ * 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/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>The Alignment Calculations Dialog</title>
+</head>
+<body>
+  <p>
+    <strong>The Alignment Calculations Dialog</strong>
+  </p>
+  <img
+    alt="Alignment Calculations dialog box - opened via Calculations->Tree or PCA..."
+    src="calculatedialog.png" width="350" height="241">
+  <p>
+    The <strong>Calculations Dialog</strong> (shown above) is opened via
+    the <strong>Calculations&#8594;Calculate Tree or PCA...</strong>
+    menu entry.
+  </p>
+  <p>
+    It allows you to select the type of alignment analysis calculation (<a
+      href="pca.html">PCA</a> or <a href="tree.html">Tree</a>), and the
+    sequence similarity score model that will be used to perform the
+    analysis.
+  </p>
+  <p>
+    <strong>Adding additional score models</strong><br />Jalview can
+    import substitution matrices in both <a
+      href="http://www.genome.jp/aaindex/aaindex_help.html">AAindex</a>
+    and NCBI format (see e.g. <a
+      href="http://ftp.ncbi.nlm.nih.gov/blast/matrices/">ftp://ftp.ncbi.nlm.nih.gov/blast/matrices/</a>).
+    In Jalview 2.10.2, the easiest way to import new models is to drag
+    the score model file onto any alignment window. See the <a
+      href="scorematrices.html">Substitution Matrices Documentation</a>
+    for more information.
+  </p>
+</body>
+</html>
index c38d9ac..7ffb160 100755 (executable)
   <p>
     <strong>Principal Component Analysis</strong>
   </p>
+  <p>A principal component analysis can be performed via the 
+  <a href="calculations.html">calculations dialog</a> which is accessed by selecting <strong>Calculate&#8594;Calculate
+      Tree or PCA...</strong>.</p>
   <p>This calculation creates a spatial representation of the
     similarities within a selected group, or all of the sequences in an
     alignment. After the calculation finishes, a 3D viewer displays the
     set of sequences as points in 'similarity space', and similar
     sequences tend to lie near each other in the space.</p>
   <p>
-    <em>Caveats</em><br />The calculation is computationally expensive,
-    and may fail for very large sets of sequences - usually because the
-    JVM has run out of memory. A future release of Jalview will be able
-    to avoid this by executing the calculation via a web service.
+    <em>Caveats</em><br />The calculation can be computationally
+    expensive, and may fail for very large sets of sequences - usually
+    because the JVM has run out of memory. However, the PCA
+    implementation in Jalview 2.10.2 employs more memory efficient
+    matrix storage structures, allowing larger PCAs to be performed.
   </p>
 
   <p>
index 59736ca..95904b6 100755 (executable)
@@ -28,8 +28,8 @@
   </p>
   <p>
     Trees are calculated on either the complete alignment, or just the
-    currently selected group of sequences, using the functions in the <strong>Calculate&#8594;Calculate
-      tree</strong> submenu. Once calculated, trees are displayed in a new <a
+    currently selected group of sequences, via the <a href="calculations.html">calculations dialog</a> opened from the <strong>Calculate&#8594;Calculate
+      Tree or PCA...</strong> menu entry. Once calculated, trees are displayed in a new <a
       href="../calculations/treeviewer.html">tree viewing
       window</a>. There are four different calculations, using one of two
     distance measures and constructing the tree from one of two
index 69f3315..72e5bdf 100755 (executable)
@@ -24,7 +24,7 @@
 <style type="text/css">
 <!--
 td {
-       text-align: center;
+  text-align: center;
 }
 -->
 </style>
@@ -36,8 +36,8 @@ td {
   </p>
   <p>The search box is displayed by pressing Control and F or
     selecting &quot;Find...&quot; from the &quot;Search&quot; menu.</p>
-  <img src="search.gif" width="339" height="110">
-  <p>&quot;Find next&quot; will find the next occurence of the
+  <img src="search.png" width="398" height="124">
+  <p>&quot;Find next&quot; will find the next occurrence of the
     specified and adjust the alignment window view to show it, and
     &quot;Find all&quot; highlights all matches for a pattern. The
     &quot;New Feature&quot; is a quick way to highlight and group
@@ -48,7 +48,10 @@ td {
       of posix and perl style regex - see below for a summary)</li>
     <li>Gaps are ignored when matching the query to the sequences
       in the alignment.</li>
-    <li>The search is applied to both sequences and their IDs.</li>
+    <li>The search is applied to both sequences and their IDs, and
+      optionally also to the description string (<em>since Jalview
+        2.10</em>)
+    </li>
     <li>If a region is selected, then search will <strong>only</strong>
       be performed on that region.
     </li>
@@ -56,6 +59,9 @@ td {
       &quot;Escape&quot; key.</li>
     <li>Tick the &quot;Match Case&quot; box to perform a case
       sensitive search.</li>
+    <li>To access a <a ref="#queryhistory">previously used
+        query</a> press the down arrow or click on the button on the right
+      of the text field.
   </ul>
   <p>
     <strong>Creating Features from Search Results</strong>
@@ -77,7 +83,7 @@ td {
     highlighted region.
   </p>
   <p>
-  
+
     <strong>A quick Regular Expression Guide</strong>
   </p>
   <p>A regular expression is not just a simple text query - although
@@ -142,5 +148,26 @@ td {
         max number of times</td>
     </tr>
   </table>
+  <p>
+    <a name="queryhistory" /><strong>Search History</strong>
+  </p>
+  <p>A record of all the recent queries made via the Find dialog are
+    stored along with your Jalview user preferences. To open the search
+    history, click on the button to the right of the query field, or
+    press the down arrow key.</p>
+  <img src="searchhist.png" width="404" height="185" align="left" />
+  <p>The search history keeps up to 99 queries by default. To clear
+    the history, or modify the size of the history, right-click the text
+    box.</p>
+  <img src="searchclearhist.png" width="402" height="121" align="left" />
+  <p>
+    <strong>Other dialogs that provide a query history</strong>
+  </p>
+  <p>
+    Jalview's <a href="uniprotsequencefetcher.html">Uniprot</a> and <a
+      href="pdbsequencefetcher.html">PDB</a> free text database search
+    dialogs also provide a query history.
+  </p>
+  <em>The query histories were introduced in Jalview 2.10.2</em>
 </body>
 </html>
diff --git a/help/html/features/search.png b/help/html/features/search.png
new file mode 100644 (file)
index 0000000..89adb1a
Binary files /dev/null and b/help/html/features/search.png differ
diff --git a/help/html/features/searchclearhist.png b/help/html/features/searchclearhist.png
new file mode 100644 (file)
index 0000000..200c4d3
Binary files /dev/null and b/help/html/features/searchclearhist.png differ
diff --git a/help/html/features/searchhist.png b/help/html/features/searchhist.png
new file mode 100644 (file)
index 0000000..e157b56
Binary files /dev/null and b/help/html/features/searchhist.png differ
index f60da1a..0fcbbf9 100755 (executable)
       </ul></li>
   </ol>
   <p>
-  <strong>Structure Viewers in the Jalview Desktop</strong><br/>
-  The
-  <a href="jmol.html">Jmol viewer</a> has been included since Jalview
-  2.3. Jalview 2.8.2 included support for
-  <a href="chimera.html">Chimera</a>, provided it is installed and can
-  be launched by Jalview. The default viewer can be configured in the
-  <a href="preferences.html#structure">Structure tab</a> in the
-  <strong>Tools&rarr;Preferences</strong> dialog box.
+    <strong>Structure Viewers in the Jalview Desktop</strong><br /> The
+    <a href="jmol.html">Jmol viewer</a> has been included since Jalview
+    2.3. Jalview 2.8.2 included support for <a href="chimera.html">Chimera</a>,
+    provided it is installed and can be launched by Jalview. The default
+    viewer can be configured in the <a href="preferences.html#structure">Structure
+      tab</a> in the <strong>Tools&rarr;Preferences</strong> dialog box.
   <p>
     Structure data imported into Jalview can also be processed to
     display secondary structure and temperature factor annotation. See
     whether structure views already exist for the selected structures or
     aligned sequences.
   </p>
+  <p>If multiple structures are selected, then Jalview will always
+    create a new structure view. The selected structures will be
+    imported into this view, and superposed with the matched positions
+    from the aligned sequences. A message in the structure viewer's
+    status bar will be shown if not enough aligned columns were
+    available to perform a superposition.</p>
   <p>
-    If multiple structures are selected, then Jalview will always create
-    a new structure view. The selected structures will be imported into
-    this view, and superposed with the matched positions from the
-    aligned sequences.<br /> If a <strong>single</strong> PDB structure
-    is selected, one of the following will happen:
+    If a <strong>single</strong> PDB structure is selected, one of the
+    following will happen:
   </p>
 
   <ul>
 
     <li>If another structure is already shown for the current
       alignment, then you will be asked if you want to add and <a
-      href="jmol.html#align"></a> to
-    the structure in the existing view. (<em>new feature in Jalview
-      2.6</em>).
-  </li>
+      href="jmol.html#align"></a> to the structure in the existing view.
+      (<em>new feature in Jalview 2.6</em>).
+    </li>
 
     <li>If the structure is already shown, then you will be
       prompted to associate the sequence with an existing view of the
index 51ad601..00a2ec4 100755 (executable)
         </strong><em>Selects all the sequences and residues in the
             alignment. <br> Use &lt;CTRL&gt; and A (&lt;APPLE&gt;
             and A on a MacOSX) to select all.
-        </em></em></li>
+        </em></li>
         <li><strong>Deselect All (Escape)<br>
         </strong><em>Removes the current selection box (red dashed box) from
             the alignment window. All selected sequences, residues and
             or hide sequence features on this alignment.</em></li>
         <li><strong><a
             href="../features/featuresettings.html">Sequence
-              Feature Settings...</a> </strong><em><br> <em>Opens the
+              Feature Settings...</a> </strong><br> <em>Opens the
               Sequence Feature Settings dialog box to control the colour
               and display of sequence features on the alignment, and
               configure and retrieve features from DAS annotation
             </strong><em>If this box is selected then the sequence names
                 displayed in the sequence label area will be aligned
                 against the left-hand edge of the alignment display,
-                rather than the left-hand edge of the alignment window.
+                rather than the left-hand edge of the alignment window.</em>
             </li>
             <li><strong>Show Hidden Markers<br>
             </strong><em>When this box is selected, positions in the
                 alignment where rows and columns are hidden will be
-                marked by blue arrows. </li>
+                marked by blue arrows. </em></li>
             <li><strong>Boxes</strong><em><br> If this is
                 selected the background of a residue will be coloured
                 using the selected background colour. Useful if used in
                 symbols will be rendered as a '.', highlighting
                 mutations in highly conserved alignments. </em></li>
 
-          </ul></li>
       </ul></li>
 
   </ul>
               viewer window.
           </em><br></li>
         </ul></li>
-      <li><strong>Calculate Tree </strong> <br> <em>Functions
-          for calculating trees on the alignment or the currently
-          selected region. See <a href="../calculations/tree.html">calculating
-            trees</a>.
-      </em>
-        <ul>
-          <li><strong>Neighbour Joining Using PAM250 </strong></li>
-          <li><strong>Neighbour Joining Using Sequence
-              Feature Similarity</strong></li>
-          <li><strong>Neighbour Joining Using Blosum62 </strong></li>
-          <li><strong>Neighbour Joining Using % Identity</strong></li>
-          <li><strong>Average Distance Using PAM250 </strong></li>
-          <li><strong>Average Distance Using Sequence
-              Feature Similarity</strong></li>
-          <li><strong>Average Distance Using Blosum62</strong></li>
-          <li><strong>Average Distance Using % Identity</strong></li>
-        </ul> <strong>Note: Since Version 2.8.1, a number of
-          additional similarity measures for tree calculation are
-          provided in this menu.</strong></li>
-      <li><strong>Pairwise Alignments</strong><br> <em>Applies
-          Smith and Waterman algorithm to selected sequences. See <a
-          href="../calculations/pairwise.html">pairwise
-            alignments</a>.
+    <li><strong>Calculate Tree or PCA ...</strong><em> <br> Opens the 
+    <a href="../calculations/calculations.html">calculations dialog</a> for
+        for calculating <a href="../calculations/tree.html">trees</a> or
+         <a href="../calculations/pca.html">principle component analysis 
+         plots</a> on the alignment or the currently selected
+        region. 
       </em><br></li>
-      <li><strong>Principal Component Analysis</strong><br> <em>Shows
-          a spatial clustering of the sequences based on similarity
-          scores calculated with the alignment. See <a
-          href="../calculations/pca.html">Principal
-            Component Analysis</a>.
-      </em> <br></li>
-      <li><strong>Extract Scores ... (optional)</strong><br> <em>This
-          option is only visible if Jalview detects one or more
-          white-space separated values in the description line of the
-          alignment sequences.<br> When selected, these numbers are
-          parsed into sequence associated annotation which can then be
-          used to sort the alignment via the Sort by&#8594;Score menu.
-      </em> <br></li>
-      <li><strong>Autocalculate Consensus</strong><br> <em>For
+    <li><strong>Pairwise Alignments</strong><br> <em>Applies
+        Smith and Waterman algorithm to selected sequences. See <a
+        href="../calculations/pairwise.html">pairwise
+          alignments</a>.
+    </em><br></li>
+    <li><strong>Extract Scores ... (optional)</strong><br> <em>This
+        option is only visible if Jalview detects one or more
+        white-space separated values in the description line of the
+        alignment sequences.<br> When selected, these numbers are
+        parsed into sequence associated annotation which can then be
+        used to sort the alignment via the Sort by&#8594;Score menu.
+    </em> <br></li>
+    <li><strong>Autocalculate Consensus</strong><br> <em>For
           large alignments it can be useful to deselect
           &quot;Autocalculate Consensus&quot; when editing. This
           prevents the sometimes lengthy calculations performed after
                 in Jalview 2.8.1</strong>
             </li>
             <li>'Standard Databases' will check sequences against
-              the EBI databases plus any active DAS sequence sources<</li>
+              the EBI databases plus any active DAS sequence sources</li>
           </ul> Other sub-menus allow you to pick a specific source to query
           - sources are listed alphabetically according to their
           nickname.
index 8032348..c7a1c87 100755 (executable)
             window.
         </em><br></li>
       </ul></li>
-    <li><strong>Calculate Tree </strong> <br> <em>Functions
-        for calculating trees on the alignment or the currently selected
-        region. See <a href="../calculations/tree.html">calculating
-          trees</a>.
-    </em>
-      <ul>
-        <li><strong>Neighbour Joining Using PAM250<br>
-        </strong></li>
-        <li><strong>Neighbour Joining Using Sequence
-            Feature Similarity</strong></li>
-        <li><strong>Neighbour Joining Using Blosum62<br>
-        </strong></li>
-        <li><strong>Neighbour Joining Using % Identity</strong></li>
-        <li><strong>Average Distance Using PAM250<br>
-        </strong></li>
-        <li><strong>Average Distance Using Sequence
-            Feature Similarity</strong></li>
-        <li><strong>Average Distance Using Blosum62</strong></li>
-        <li><strong>Average Distance Using % Identity</strong></li>
-      </ul></li>
+    <li><strong>Calculate Tree or PCA ...</strong> <br> <em>Opens the 
+    <a href="../calculations/calculations.html">calculations dialog</a> for
+        for calculating <a href="../calculations/tree.html">trees</a> or
+         <a href="../calculations/pca.html">principle component analysis 
+         plots</a> on the alignment or the currently selected
+        region. 
+      </em><br>
+    </li>
     <li><strong>Pairwise Alignments</strong><br> <em>Applies
         Smith and Waterman algorithm to selected sequences. See <a
         href="../calculations/pairwise.html">pairwise
           alignments</a>.
     </em><br></li>
-    <li><strong>Principal Component Analysis</strong><br> <em>Shows
-        a spatial clustering of the sequences based on similarity scores
-        calculated over the alignment.. See <a
-        href="../calculations/pca.html">Principal Component
-          Analysis</a>.
-    </em> <br></li>
     <li><strong>Extract Scores ... (optional)</strong><br> <em>This
         option is only visible if Jalview detects one or more
         white-space separated values in the description line of the
index 5376db8..ea9bbf5 100755 (executable)
 ul {
   /* remove bullets, narrower indent */
   list-style-type: none;
-  margin:0;
+  margin: 0;
   padding-left: 10px;
   padding-bottom: 4px;
 }
 
 li {
   /* separate the items from eachother */
-   margin-left: -3px;
-   padding-bottom: 3px;
-   padding-left: 6px;   
+  margin-left: -3px;
+  padding-bottom: 3px;
+  padding-left: 6px;
 }
+
 li:before {
   /*   doesnt get processed in javahelp */
   content: '\00b7 ';
   padding: 3px;
   margin-left: -14px;
 }
-
 </style>
 </head>
 <body>
@@ -70,20 +70,55 @@ li:before {
     <tr>
       <td width="60" nowrap>
         <div align="center">
-          <strong><a name="Jalview.2.10.2">2.10.2</a><br />
-            <em>8/8/2017</em></strong>
+          <strong><a name="Jalview.2.10.2">2.10.2</a><br /> <em>8/8/2017</em></strong>
         </div>
       </td>
       <td><div align="left">
           <em>General</em>
           <ul>
-                 <li><!-- JAL-2379 -->Revised implementation of PCA for speed and memory efficiency (~30x faster)</li>
-                 <li><!-- JAL-2500 -->Trees computed on Sequence Feature Similarity may have different topology due to increased precision</li>
-                 <li><!-- JAL-2360,JAL-2371, -->More robust colours and shader model for alignments and groups</li>
-          <li><!--  JAL-384 -->Custom shading schemes created via groovy scripts</li>
-          <li><!--  JAL-2491 -->linked scrolling of CDS/Protein views via Overview or sequence motif search operations</li>
-          <li><!--  JAL-2526 -->Efficiency improvements for interacting with alignment and overview windows</li>
-          <li><!-- JAL-2388 -->Hidden columns and sequences can be omitted in Overview</li>
+            <li>
+              <!-- JAL-2379 -->Revised implementation of PCA for speed
+              and memory efficiency (~30x faster)
+            </li>
+            <li>
+              <!-- JAL-2403 -->Revised implementation of sequence
+              similarity scores as used by Tree, PCA, Shading Consensus
+              and other calculations
+              <ul>
+                <li>
+                  <!-- JAL-2416 -->Score matrices are stored as resource
+                  files within the Jalview codebase
+                <li>
+                  <!-- JAL-2500 -->Trees computed on Sequence Feature
+                  Similarity may have different topology due to
+                  increased precision
+                </li>
+              </ul>
+            </li>
+            <li>
+              <!-- JAL-1632 -->Tree/PCA calculation menu items merged to
+              a calculation dialog box
+            </li>
+            <li>
+              <!-- JAL-2360,JAL-2371, -->More robust colours and shader
+              model for alignments and groups
+            </li>
+            <li>
+              <!--  JAL-384 -->Custom shading schemes created via groovy
+              scripts
+            </li>
+            <li>
+              <!--  JAL-2491 -->linked scrolling of CDS/Protein views
+              via Overview or sequence motif search operations
+            </li>
+            <li>
+              <!--  JAL-2526 -->Efficiency improvements for interacting
+              with alignment and overview windows
+            </li>
+            <li>
+              <!-- JAL-2388 -->Hidden columns and sequences can be
+              omitted in Overview
+            </li>
             <li>
               <!-- JAL-2535 -->Posterior probability annotation from
               Stockholm files imported as sequence associated annotation
@@ -93,20 +128,74 @@ li:before {
               extension when importing structure files without embedded
               names or PDB accessions
             </li>
-          <li><!-- JAL-2547 -->Amend sequence features dialog box can be opened by double clicking gaps within sequence feature extent</li>
-         <li><!-- JAL-2631 -->Graduated feature colour style example included in the example feature file</li>
+            <li>
+              <!-- JAL-2547 -->Amend sequence features dialog box can be
+              opened by double clicking gaps within sequence feature
+              extent
+            </li>
+            <li>
+              <!-- JAL-2631 -->Graduated feature colour style example
+              included in the example feature file
+            </li>
+            <li>
+              <!-- JAL-1933 -->Occupancy annotation row shows number of
+              ungapped positions in each column of the alignment.
+            </li>
+            <li>
+              <!-- JAL-2533 -->File extension pruned from Sequence ID
+              for sequences derived from structure files without
+              embedded database accession
+            </li>
+            <li>
+              <!-- JAL-1476 -->Status bar message shown when not enough
+              aligned positions were available to create a 3D structure
+              superposition.
+            </li>
+            <li>
+              <!-- JAL-2507 -->More robust per-sequence positional
+              annotation input/output via stockholm flatfile
+            </li>
+
           </ul>
           <em>Application</em>
           <ul>
             <li>
-              <!-- JAL-2447 -->
-              Experimental Features Checkbox in Desktop's Tools
-              menu to hide or show untested features in the application.
+              <!-- JAL-2447 --> Experimental Features Checkbox in
+              Desktop's Tools menu to hide or show untested features in
+              the application.
+            </li>
+            <li>
+              <!-- JAL-1476 -->Warning in alignment status bar when
+              there are not enough columns to superimpose structures in
+              Chimera
+            </li>
+            <li>
+              <!-- JAL-1596 -->Faster Chimera/Jalview communication by
+              file-based command exchange
+            </li>
+            <li>
+              <!-- JAL-2316, -->URLs for viewing database
+              cross-references provided by identifiers.org and the
+              EMBL-EBI's MIRIAM DB
+            </li>
+            <li>
+              <!-- JAL-2549 -->Updated JABAWS client to v2.2
+            </li>
+            <li>
+              <!-- JAL-2416 -->Drag and drop load of AAIndex and NCBI
+              format sequence substitution matrices
+            </li>
+            <li>
+              <!-- JAL-2375 -->Structure chooser automatically shows
+              Cached Structures rather than querying the PDBe if
+              structures are already available for sequences
+            </li>
+            <li>
+              <!-- JAL-2520 -->Structures imported via URL are cached in
+              the Jalview project rather than downloaded again when the
+              project is reopened.
             </li>
-            <li><!-- JAL-1476 -->Warning in alignment status bar when there are not enough columns to superimpose structures in Chimera</li>
-          <li><!-- JAL-1596 -->Faster Chimera/Jalview communication by file-based command exchange</li>  
-          <li><!-- JAL-2316, -->URLs for viewing database cross-references provided by identifiers.org and the EMBL-EBI's MIRIAM DB</li>
-          <li><!-- JAL-2549 -->Updated JABAWS client to v2.2</li>
+
           </ul>
           <em>Experimental features</em>
           <ul>
@@ -118,25 +207,49 @@ li:before {
           </ul>
           <em>Applet</em>
           <ul>
-          <li><!--  --></li>
+            <li>
+              <!--  -->
+            </li>
           </ul>
           <em>Test Suite</em>
           <ul>
-          <li><!--  JAL-2474 -->Added PrivilegedAccessor to test suite</li>
-          <li><!-- JAL-2326 -->Prevent or clear modal dialogs raised during tests</li>
-          <li><!--  -->  
-          <em>Scripting</em>
-          <ul>
-                       <li><!-- JAL-2344 -->FileFormatI interface for describing and identifying file formats (instead of String constants)</li>
-          </ul>
+            <li>
+              <!--  JAL-2474 -->Added PrivilegedAccessor to test suite
+            </li>
+            <li>
+              <!-- JAL-2326 -->Prevent or clear modal dialogs raised
+              during tests
+            </li>
+            <li>
+              <!-- JAL-2485, -->External service integration tests for
+              Uniprot REST Free Text Search Client
+            </li>
+            <li>
+              <!--  --> <em>Scripting</em>
+              <ul>
+                <li>
+                  <!-- JAL-2344 -->FileFormatI interface for describing
+                  and identifying file formats (instead of String
+                  constants)
+                </li>
+                <li>
+                  <!-- JAL-2228 -->FeatureCounter script refactored for
+                  efficiency when counting all displayed features (not
+                  backwards compatible with 2.10.1)
+                </li>
+                <li></li>
+
+
+              </ul>
           </ul>
-          </div></td><td><div align="left">
+        </div></td>
+      <td><div align="left">
           <em>General</em>
           <ul>
             <li>
               <!-- JAL-2398, -->Fixed incorrect value in BLOSUM 62 score
-              matrix - C->R should be '-3'<br />Old matrix restored with
-              this one-line groovy script:<br />jalview.analysis.scoremodels.ScoreModels.instance.BLOSUM62.@matrix[4][1]=3
+              matrix - C->R should be '-3'<br />Old matrix restored
+              with this one-line groovy script:<br />jalview.analysis.scoremodels.ScoreModels.instance.BLOSUM62.@matrix[4][1]=3
             </li>
             <li>
               <!-- JAL-2397 -->Fixed Jalview's treatment of gaps in PCA
@@ -154,85 +267,380 @@ li:before {
               jalview.viewmodel.PCAModel.scoreGapAsAny=false // to
               restore 2.10.2 mode
             </li>
-            <li><!-- JAL-2346 -->Reopening Colour by annotation dialog doesn't reselect a specific sequence's associated annotation after it was used for colouring a view</li>
-          <li><!-- JAL-2430 -->Hidden regions in alignment views are not coloured in linked structure views</li>
-          <li><!-- JAL-2419 -->Current selection lost if popup menu opened on a region of alignment without groups</li>
-          <li><!-- JAL-2374 -->Popup menu not always shown for regions of an alignment with overlapping groups</li> 
-          <li><!-- JAL-2310 -->Finder double counts if both a sequence's name and description match</li>
-          <li><!-- JAL-2370 -->Hiding column selection containing two hidden regions results in incorrect hidden regions</li>
-          <li><!-- JAL-2377 -->PCA calculation could hang when generating output report when working with highly redundant alignments</li>
-          <li><!-- JAL-2365 -->Cannot configure feature colours with lightGray or darkGray via features file</li>
-          <li><!-- JAL-2421 -->Overview window visible region moves erratically when hidden rows or columns are present</li>
-          <li><!-- JAL-2362 -->Per-residue colourschemes applied via the Structure Viewer's colour menu don't correspond to sequence colouring</li>  
-          <li><!-- JAL-2405 -->Protein specific colours only offered in colour and group colour menu for protein alignments</li>
-          <li><!-- JAL-2386 -->'Apply to all groups' setting when changing colour does not apply Conservation slider value to all groups</li>
-          <li><!-- JAL-2385 -->Colour threshold slider doesn't update to reflect currently selected view or group's shading thresholds</li>
-          <li><!-- JAL-2373 -->Percentage identity and conservation menu items do not show a tick or allow shading to be disabled</li>
-          <li><!-- JAL-2385 -->Conservation shading or PID threshold lost when base colourscheme changed if slider not visible</li>
-          <li><!-- JAL-2547 -->Sequence features shown in tooltip for gaps before start of features</li>
-          <li><!-- JAL-2576 -->Very large alignments take a long time to load</li>
-           <li><!-- JAL-2623 -->Graduated feature colour threshold not restored to UI when feature colour is edited</li>
-           <li><!-- JAL-2624 -->Feature colour thresholds not respected when rendered on overview and structures when opacity at 100%</li>
-           <li><!-- JAL-2630 -->Structure and alignment overview update as graduate feature colour settings are modified via the dialog box</li>
-           <li><!-- JAL-147 -->Vertical scrollbar jumps one page-width at a time when scrolling vertically in wrapped mode.</li>
-           <li><!-- JAL-2034 -->Overview window doesn't always update when a group defined on the alignment is resized</li>
-           <li><!-- JAL-2605 -->Mouseovers on left/right scale region in wrapped view result in positional status updates</li>
-           <li><!-- JAL-2563 -->Status bar shows position for ambiguous amino acid and nucleotide symbols</li>
-           <li><!-- JAL-2602 -->Copy consensus sequence failed if alignment included gapped columns</li>
-           <li><!-- JAL-2589 -->User defined gap colour not shown in overview when features overlaid on alignment</li>
-           </ul>
-             <strong>Documentation</strong>
-             <ul>
-               <li><!-- JAL-2339 -->Release notes reformatted for readibility with the built-in Java help viewer</li>
+            <li>
+              <!-- JAL-2424 -->Fixed off-by-one bug that affected
+              scaling of branch lengths for trees computed using
+              Sequence Feature Similarity.
+            </li>
+            <li>
+              <!-- JAL-2346 -->Reopening Colour by annotation dialog
+              doesn't reselect a specific sequence's associated
+              annotation after it was used for colouring a view
+            </li>
+            <li>
+              <!-- JAL-2430 -->Hidden regions in alignment views are not
+              coloured in linked structure views
+            </li>
+            <li>
+              <!-- JAL-2419 -->Current selection lost if popup menu
+              opened on a region of alignment without groups
+            </li>
+            <li>
+              <!-- JAL-2374 -->Popup menu not always shown for regions
+              of an alignment with overlapping groups
+            </li>
+            <li>
+              <!-- JAL-2310 -->Finder double counts if both a sequence's
+              name and description match
+            </li>
+            <li>
+              <!-- JAL-2370 -->Hiding column selection containing two
+              hidden regions results in incorrect hidden regions
+            </li>
+            <li>
+              <!-- JAL-2377 -->PCA calculation could hang when
+              generating output report when working with highly
+              redundant alignments
+            </li>
+            <li>
+              <!-- JAL-2365 -->Cannot configure feature colours with
+              lightGray or darkGray via features file
+            </li>
+            <li>
+              <!-- JAL-2421 -->Overview window visible region moves
+              erratically when hidden rows or columns are present
+            </li>
+            <li>
+              <!-- JAL-2362 -->Per-residue colourschemes applied via the
+              Structure Viewer's colour menu don't correspond to
+              sequence colouring
+            </li>
+            <li>
+              <!-- JAL-2405 -->Protein specific colours only offered in
+              colour and group colour menu for protein alignments
+            </li>
+            <li>
+              <!-- JAL-2386 -->'Apply to all groups' setting when
+              changing colour does not apply Conservation slider value
+              to all groups
+            </li>
+            <li>
+              <!-- JAL-2385 -->Colour threshold slider doesn't update to
+              reflect currently selected view or group's shading
+              thresholds
+            </li>
+            <li>
+              <!-- JAL-2373 -->Percentage identity and conservation menu
+              items do not show a tick or allow shading to be disabled
+            </li>
+            <li>
+              <!-- JAL-2385 -->Conservation shading or PID threshold
+              lost when base colourscheme changed if slider not visible
+            </li>
+            <li>
+              <!-- JAL-2547 -->Sequence features shown in tooltip for
+              gaps before start of features
+            </li>
+            <li>
+              <!-- JAL-2576 -->Very large alignments take a long time to
+              load
+            </li>
+            <li>
+              <!-- JAL-2623 -->Graduated feature colour threshold not
+              restored to UI when feature colour is edited
+            </li>
+            <li>
+              <!-- JAL-2624 -->Feature colour thresholds not respected
+              when rendered on overview and structures when opacity at
+              100%
+            </li>
+            <li>
+              <!-- JAL-2630 -->Structure and alignment overview update
+              as graduate feature colour settings are modified via the
+              dialog box
+            </li>
+            <li>
+              <!-- JAL-147 -->Vertical scrollbar jumps one page-width at
+              a time when scrolling vertically in wrapped mode.
+            </li>
+            <li>
+              <!-- JAL-2034 -->Overview window doesn't always update
+              when a group defined on the alignment is resized
+            </li>
+            <li>
+              <!-- JAL-2605 -->Mouseovers on left/right scale region in
+              wrapped view result in positional status updates
+            </li>
+            <li>
+              <!-- JAL-2563 -->Status bar shows position for ambiguous
+              amino acid and nucleotide symbols
+            </li>
+            <li>
+              <!-- JAL-2602 -->Copy consensus sequence failed if
+              alignment included gapped columns
+            </li>
+            <li>
+              <!-- JAL-2589 -->User defined gap colour not shown in
+              overview when features overlaid on alignment
+            </li>
+            <li>
+              <!-- JAL-2473 -->Minimum size set for Jalview windows so
+              widgets don't permanently disappear
+            </li>
+            <li>
+              <!-- JAL-2503 -->Cannot select or filter quantitative
+              annotation that are shown only as column labels (e.g.
+              T-Coffee column reliability scores)
+            </li>
+            <li>
+              <!-- JAL-2589 -->Gap colours in user-defined colourschemes
+              are not shown
+            </li>
+            <li>
+              <!-- JAL-2594 -->Exception thrown if trying to create a
+              sequence feature on gaps only
+            </li>
+            <li>
+              <!-- JAL-2544 --> Sort by features includes features to
+              right of selected region when gaps present on right-hand
+              boundary
+            </li>
+            <li>
+              <!-- JAL-2504 -->Features created with 'New feature'
+              button from a Find inherit previously defined feature type
+              rather than the Find query string
+            </li>
+            <li>
+              <!-- JAL-2423  -->incorrect title in output window when
+              exporting tree calculated in Jalview
+            </li>
+            <li>
+              <!-- JAL-2507 -->Per-sequence RNA secondary structures
+              added after a sequence was imported are not written to
+              Stockholm File
+            </li>
+            <li>
+              <!-- JAL-2509 -->WUSS notation for simple pseudoknots lost
+              when importing RNA secondary structure via Stockholm
+            </li>
+            <li>
+              <!-- JAL-2509 -->Secondary structure arrows for [] and {}
+              not shown in correct direction for simple pseudoknots
+            </li>
+            <li>
+              <!-- JAL-2437 -->Hiding sequences at bottom of alignment
+              and then revealing them reorders sequences on the
+              alignment
+            </li>
+            <li>
+              <!-- JAL-964 -->Group panel in sequence feature settings
+              doesn't update to reflect available set of groups after
+              interactively adding or modifying features
+            </li>
+            <li>
+              <!-- JAL-2225 -->Sequence Database chooser unusable on
+              Linux
+            </li>
+            <li>
+              <!-- JAL -->
+            </li>
+            <li>
+              <!-- JAL -->
+            </li>
+            <li>
+              <!-- JAL -->
+            </li>
+          </ul>
+          <strong>Documentation</strong>
+          <ul>
+            <li>
+              <!-- JAL-2339 -->Release notes reformatted for readibility
+              with the built-in Java help viewer
+            </li>
+            <li>
+              <!-- JAL-1644 -->Find documentation updated with 'search
+              sequence description' option
+            </li>
           </ul>
           <em>Application</em>
           <ul>
-          <li><!-- JAL-2401 -->Easier creation of colours for all 'Lower case' residues (button in colourscheme editor debugged and new documentation and tooltips added)</li> 
-          <li><!-- JAL-2399-->Text colour threshold's 'Cancel' button doesn't restore group-specific text colour thresholds</li>
-          <li><!-- JAL-2243 -->Feature settings panel does not update as new features are added to alignment</li> 
-          <li><!-- JAL-2436 -->Structure viewer's View -> Colour By view selection menu changes colours of alignment views</li>
-          <li><!--  JAL-2366 -->Proxy server address and port always appear enabled in Preferences->Connections</li>
-          <li><!-- JAL-2426 -->Spurious exceptions in console raised from alignment calculation workers after alignment has been closed</li>
-          <li><!-- JAL-1608 -->Typo in selection popup menu - Create groups now 'Create Group'</li>
-          <li><!-- JAL-1608 -->CMD/CTRL and G or Shift G for Create/Undefine group doesn't always work</li>
-          <li><!-- JAL-2464 -->Tree Viewer's Print Dialog doesn't get shown again after pressing 'Cancel'</li>
-          <li><!--  JAL-2461 -->DAS registry not found exceptions removed from console output</li>
-          <li><!--  JAL-2383 -->Above PID colour threshold not recovered when alignment view imported from project</li> 
-          <li><!-- JAL-2465 -->No mappings generated between structure and sequences extracted from structure files imported via URL</li>
+            <li>
+              <!-- JAL-2225 -->Sequence Database chooser doesn't show
+              available databases panel on Linux
+            </li>
+            <li>
+              <!-- JAL-2519 -->EnsemblGenomes example failing after
+              release of Ensembl v.88
+            </li>
+            <li>
+              <!-- JAL-2361 -->User Defined Colours not added to Colour
+              menu
+            </li>
+            <li>
+              <!-- JAL-2401 -->Easier creation of colours for all 'Lower
+              case' residues (button in colourscheme editor debugged and
+              new documentation and tooltips added)
+            </li>
+            <li>
+              <!-- JAL-2399-->Text colour threshold's 'Cancel' button
+              doesn't restore group-specific text colour thresholds
+            </li>
+            <li>
+              <!-- JAL-2243 -->Feature settings panel does not update as
+              new features are added to alignment
+            </li>
+            <li>
+              <!-- JAL-2532 -->Cancel in feature settings reverts
+              changes to feature colours via the Amend features dialog
+            </li>
+            <li>
+              <!-- JAL-2506 -->Null pointer exception when attempting to
+              edit graduated feature colour via amend features dialog
+              box
+            </li>
+            <li>
+              <!-- JAL-2436 -->Structure viewer's View -> Colour By view
+              selection menu changes colours of alignment views
+            </li>
+            <li>
+              <!--  JAL-2366 -->Proxy server address and port always
+              appear enabled in Preferences->Connections
+            </li>
+            <li>
+              <!-- JAL-2426 -->Spurious exceptions in console raised
+              from alignment calculation workers after alignment has
+              been closed
+            </li>
+            <li>
+              <!-- JAL-1608 -->Typo in selection popup menu - Create
+              groups now 'Create Group'
+            </li>
+            <li>
+              <!-- JAL-1608 -->CMD/CTRL and G or Shift G for
+              Create/Undefine group doesn't always work
+            </li>
+            <li>
+              <!-- JAL-2464 -->Tree Viewer's Print Dialog doesn't get
+              shown again after pressing 'Cancel'
+            </li>
+            <li>
+              <!--  JAL-2461 -->DAS registry not found exceptions
+              removed from console output
+            </li>
+            <li>
+              <!--  JAL-2383 -->Above PID colour threshold not recovered
+              when alignment view imported from project
+            </li>
+            <li>
+              <!-- JAL-2520,JAL-2465 -->No mappings generated between
+              structure and sequences extracted from structure files
+              imported via URL and viewed in Jmol
+            </li>
             <li>
               <!-- JAL-2520 -->Structures loaded via URL are saved in
               Jalview Projects rather than fetched via URL again when
               the project is loaded and the structure viewed
             </li>
-            <li><!-- JAL-1256 -->Trackpad horizontal scroll gesture adjusts start position in wrap mode</li>
-            <li><!-- JAL-2563 -->Status bar doesn't show positions for ambiguous amino acids</li>
-          <li><!-- JAL-2291 -->Hide insertions in PopUp menu excludes gaps in selection, current sequence and only within selected columns</li>
-         <li><!-- JAL-2582 -->Cannot retrieve protein products from Ensembl by Peptide ID</li>
-         <li><!-- JAL-2431 -->cDNA Consensus annotation not shown in CDS/Protein view after CDS sequences added for aligned proteins</li>
+            <li>
+              <!-- JAL-1256 -->Trackpad horizontal scroll gesture
+              adjusts start position in wrap mode
+            </li>
+            <li>
+              <!-- JAL-2563 -->Status bar doesn't show positions for
+              ambiguous amino acids
+            </li>
+            <li>
+              <!-- JAL-2291 -->Hide insertions in PopUp menu excludes
+              gaps in selection, current sequence and only within
+              selected columns
+            </li>
+            <li>
+              <!-- JAL-2582 -->Cannot retrieve protein products from
+              Ensembl by Peptide ID
+            </li>
+            <li>
+              <!-- JAL-2431 -->cDNA Consensus annotation not shown in
+              CDS/Protein view after CDS sequences added for aligned
+              proteins
+            </li>
+            <li>
+              <!-- JAL-2482, JAL-2487 -->Incorrect PDB-Uniprot mappings
+              created from SIFTs, and spurious 'Couldn't open structure
+              in Chimera' errors raised after April 2017 update (problem
+              due to 'null' string rather than empty string used for
+              residues with no corresponding PDB mapping).
+            </li>
+
+
           </ul>
           <em>Applet</em>
           <ul>
-          <li><!-- JAL-2468 -->Switching between Nucleotide and Protein score models doesn't always result in an updated PCA plot</li>
-          <li><!-- JAL-2442 -->Features not rendered as transparent on overview or linked structure view</li> 
-          <li><!--  JAL-2372 -->Colour group by conservation doesn't work (since 2.8)</li>
-          <li><!-- JAL-2517 -->Hitting Cancel after applying user-defined colourscheme doesn't restore original colourscheme</li>
+            <li>
+              <!-- JAL- -->
+            </li>
+            <li>
+              <!-- JAL-2468 -->Switching between Nucleotide and Protein
+              score models doesn't always result in an updated PCA plot
+            </li>
+            <li>
+              <!-- JAL-2442 -->Features not rendered as transparent on
+              overview or linked structure view
+            </li>
+            <li>
+              <!--  JAL-2372 -->Colour group by conservation doesn't
+              work (since 2.8)
+            </li>
+            <li>
+              <!-- JAL-2517 -->Hitting Cancel after applying
+              user-defined colourscheme doesn't restore original
+              colourscheme
+            </li>
           </ul>
           <em>New Known Issues</em>
           <ul>
-          <li><!--  JAL-2566 -->Protein/CDS view scrolling not always in phase after a sequence motif find operation</li>
-          <li><!-- JAL-2550 -->Importing annotation file with rows containing just upper and lower case letters are interpreted as WUSS rna secondary structure symbols</li>  
-            <li><!-- JAL-2590 -->Cannot load Newick trees from eggnog ortholog database</li>
+            <li>
+              <!--  JAL-2566 -->Protein/CDS view scrolling not always in
+              phase after a sequence motif find operation
+            </li>
+            <li>
+              <!-- JAL-2550 -->Importing annotation file with rows
+              containing just upper and lower case letters are
+              interpreted as WUSS rna secondary structure symbols
+            </li>
+            <li>
+              <!-- JAL-2590 -->Cannot load Newick trees from eggnog
+              ortholog database
+            </li>
+            <li>
+              <!-- JAL-2468 -->Status bar shows 'Marked x columns
+              containing features of type Highlight' when 'B" is pressed
+              to mark columns containing highlighted regions.
+            </li>
           </ul>
           <em>Test Suite</em>
-          <ul><li><!-- JAL-2314 -->Unit test failure: jalview.ws.jabaws.RNAStructExportImport setup fails</li>
-          <li><!-- JAL- --></li>
+          <ul>
+            <li>
+              <!-- JAL-2314 -->Unit test failure:
+              jalview.ws.jabaws.RNAStructExportImport setup fails
+            </li>
+            <li>
+              <!-- JAL-2307 -->Unit test failure:
+              jalview.ws.sifts.SiftsClientTest due to compatibility
+              problems with deep array comparison equality asserts in
+              successive versions of TestNG
+            </li>
+            <li>
+              <!-- JAL-2479 -->Relocated StructureChooserTest and
+              ParameterUtilsTest Unit tests to Network suite
+            </li>
+
           </ul>
-          </div>
+        </div>
+    
     <tr>
       <td width="60" nowrap>
         <div align="center">
-          <strong><a name="Jalview.2.10.1">2.10.1</a><br />
-            <em>29/11/2016</em></strong>
+          <strong><a name="Jalview.2.10.1">2.10.1</a><br /> <em>29/11/2016</em></strong>
         </div>
       </td>
       <td><div align="left">
@@ -243,7 +651,8 @@ li:before {
               for all consensus calculations
             </li>
             <li>
-              <!-- JAL-2177 -->Jmol updated to version 14.6.4 (released 3rd Oct 2016)
+              <!-- JAL-2177 -->Jmol updated to version 14.6.4 (released
+              3rd Oct 2016)
             </li>
             <li>Updated Jalview's Certum code signing certificate
               for 2016-2017</li>
@@ -271,9 +680,9 @@ li:before {
             </li>
             <li>
               <!-- JAL-1738-->New keystroke (B) and Select highlighted
-              columns menu item to mark columns containing
-              highlighted regions (e.g. from structure selections or results
-              of a Find operation)
+              columns menu item to mark columns containing highlighted
+              regions (e.g. from structure selections or results of a
+              Find operation)
             </li>
             <li>
               <!-- JAL-2284-->Command line option for batch-generation
@@ -373,73 +782,78 @@ li:before {
               lysozyme results in a PDB Client error dialog box
             </li>
             <li>
-            <!-- JAL-2319 -->Structure View's mapping report switched ranges for PDB and sequence for SIFTS</li> 
-            <!-- JAL-2319 -->SIFTS 'Not_Observed' residues mapped to non-existant coordindate data</li> 
+              <!-- JAL-2319 -->Structure View's mapping report switched
+              ranges for PDB and sequence for SIFTS
+            </li>
+            <!-- JAL-2319 -->
+            SIFTS 'Not_Observed' residues mapped to non-existant
+            coordindate data
+            </li>
           </ul>
-<!--           <em>New Known Issues</em>
+          <!--           <em>New Known Issues</em>
           <ul>
             <li></li>
           </ul> -->
         </div>
       </td>
     </tr>
-      <td width="60" nowrap>
-        <div align="center">
-          <strong><a name="Jalview.2.10.0b1">2.10.0b1</a><br />
-            <em>25/10/2016</em></strong>
-        </div>
-      </td>
-      <td><em>Application</em>
+    <td width="60" nowrap>
+      <div align="center">
+        <strong><a name="Jalview.2.10.0b1">2.10.0b1</a><br />
+          <em>25/10/2016</em></strong>
+      </div>
+    </td>
+    <td><em>Application</em>
+      <ul>
+        <li>3D Structure chooser opens with 'Cached structures'
+          view if structures already loaded</li>
+        <li>Progress bar reports models as they are loaded to
+          structure views</li>
+      </ul></td>
+    <td>
+      <div align="left">
+        <em>General</em>
         <ul>
-          <li>3D Structure chooser opens with 'Cached structures'
-            view if structures already loaded</li>
-          <li>Progress bar reports models as they are loaded to
-            structure views</li>
-        </ul></td>
-      <td>
-        <div align="left">
-          <em>General</em>
-          <ul>
-            <li>Colour by conservation always enabled and no tick
-              shown in menu when BLOSUM or PID shading applied</li>
-            <li>FER1_ARATH and FER2_ARATH labels were switched in
-              example sequences/projects/trees</li>
-          </ul>
-          <em>Application</em>
-          <ul>
-            <li>Jalview projects with views of local PDB structure
-              files saved on Windows cannot be opened on OSX</li>
-            <li>Multiple structure views can be opened and
-              superposed without timeout for structures with multiple
-              models or multiple sequences in alignment</li>
-            <li>Cannot import or associated local PDB files without
-              a PDB ID HEADER line</li>
-            <li>RMSD is not output in Jmol console when
-              superposition is performed</li>
-            <li>Drag and drop of URL from Browser fails for Linux
-              and OSX versions earlier than El Capitan</li>
-            <li>ENA client ignores invalid content from ENA server</li>
-            <li>Exceptions are not raised in console when ENA
-              client attempts to fetch non-existent IDs via Fetch DB
-              Refs UI option</li>
-            <li>Exceptions are not raised in console when a new
-              view is created on the alignment</li>
-            <li>OSX right-click fixed for group selections:
-              CMD-click to insert/remove gaps in groups and CTRL-click
-              to open group pop-up menu</li>
-          </ul>
-          <em>Build and deployment</em>
-          <ul>
-            <li>URL link checker now copes with multi-line anchor
-              tags</li>
-          </ul>
-          <em>New Known Issues</em>
-          <ul>
-            <li>Drag and drop from URL links in browsers do not
-              work on Windows</li>
-          </ul>
-        </div>
-      </td>
+          <li>Colour by conservation always enabled and no tick
+            shown in menu when BLOSUM or PID shading applied</li>
+          <li>FER1_ARATH and FER2_ARATH labels were switched in
+            example sequences/projects/trees</li>
+        </ul>
+        <em>Application</em>
+        <ul>
+          <li>Jalview projects with views of local PDB structure
+            files saved on Windows cannot be opened on OSX</li>
+          <li>Multiple structure views can be opened and superposed
+            without timeout for structures with multiple models or
+            multiple sequences in alignment</li>
+          <li>Cannot import or associated local PDB files without a
+            PDB ID HEADER line</li>
+          <li>RMSD is not output in Jmol console when superposition
+            is performed</li>
+          <li>Drag and drop of URL from Browser fails for Linux and
+            OSX versions earlier than El Capitan</li>
+          <li>ENA client ignores invalid content from ENA server</li>
+          <li>Exceptions are not raised in console when ENA client
+            attempts to fetch non-existent IDs via Fetch DB Refs UI
+            option</li>
+          <li>Exceptions are not raised in console when a new view
+            is created on the alignment</li>
+          <li>OSX right-click fixed for group selections: CMD-click
+            to insert/remove gaps in groups and CTRL-click to open group
+            pop-up menu</li>
+        </ul>
+        <em>Build and deployment</em>
+        <ul>
+          <li>URL link checker now copes with multi-line anchor
+            tags</li>
+        </ul>
+        <em>New Known Issues</em>
+        <ul>
+          <li>Drag and drop from URL links in browsers do not work
+            on Windows</li>
+        </ul>
+      </div>
+    </td>
     </tr>
     <tr>
       <td width="60" nowrap>
@@ -450,8 +864,8 @@ li:before {
       <td><em>General</em>
         <ul>
           <li>
-          <!-- JAL-2124 -->Updated Spanish translations.
-          </li> 
+            <!-- JAL-2124 -->Updated Spanish translations.
+          </li>
           <li>
             <!-- JAL-2164,JAL-1919,JAL-2148 -->Jmol now primary parser
             for importing structure data to Jalview. Enables mmCIF and
@@ -741,7 +1155,7 @@ li:before {
               load even when Consensus calculation is disabled
             </li>
             <li>
-              <!-- JAL-1932 -->Remove right on penultimate column of 
+              <!-- JAL-1932 -->Remove right on penultimate column of
               alignment does nothing
             </li>
           </ul>
@@ -829,7 +1243,8 @@ li:before {
             </li>
             <li>
               <!-- JAL-2036 -->Enable 'Get Cross-References' in menu
-              after fetching cross-references, and restoring from project
+              after fetching cross-references, and restoring from
+              project
             </li>
             <li>
               <!-- JAL-2032 -->Mouseover of a copy of a sequence is not
@@ -894,7 +1309,8 @@ li:before {
               <!-- JAL-2284 -->Unable to read old Jalview projects that
               contain non-XML data added after Jalvew wrote project.
             </li>
-            <li><!-- JAL-2118 -->Newly created annotation row reorders
+            <li>
+              <!-- JAL-2118 -->Newly created annotation row reorders
               after clicking on it to create new annotation for a
               column.
             </li>
@@ -966,9 +1382,12 @@ li:before {
         </ul> <em>Applet</em>
         <ul>
           <li>Split frame example added to applet examples page</li>
-        </ul><em>Build and Deployment</em>
+        </ul> <em>Build and Deployment</em>
         <ul>
-          <li><!--  JAL-1888 -->New ant target for running Jalview's test suite</li>
+          <li>
+            <!--  JAL-1888 -->New ant target for running Jalview's test
+            suite
+          </li>
         </ul></td>
       <td>
         <div align="left">
@@ -1356,10 +1775,10 @@ li:before {
           </li>
 
         </ul> <!--  <em>Applet</em>
-                               <ul>
-                               </ul> <em>General</em>
-                               <ul> 
-                               </ul>--> <em>Deployment and Documentation</em>
+        <ul>
+        </ul> <em>General</em>
+        <ul> 
+        </ul>--> <em>Deployment and Documentation</em>
         <ul>
           <li>2G and 1G options in launchApp have no effect on
             memory allocation</li>
@@ -1567,8 +1986,7 @@ li:before {
             <a href="https://www.certum.eu">Certum</a> to the Jalview
             open source project).
           </li>
-          <li>Jalview SRS links replaced by UniProt and EBI-search
-          </li>
+          <li>Jalview SRS links replaced by UniProt and EBI-search</li>
           <li>Output in Stockholm format</li>
           <li>Allow import of data from gzipped files</li>
           <li>Export/import group and sequence associated line
@@ -2197,11 +2615,6 @@ li:before {
         <ul>
           <li>URL links generated from description line for
             regular-expression based URL links (applet and application)
-
-
-
-
-
           
           <li>Non-positional feature URL links are shown in link
             menu</li>
@@ -2229,8 +2642,8 @@ li:before {
           <li>Enable or disable non-positional feature and database
             references in sequence ID tooltip from View menu in
             application.</li>
-          <!--                 <li>New hidden columns and rows and representatives capabilities
-                       in annotations file (in progress - not yet fully implemented)</li> -->
+          <!--      <li>New hidden columns and rows and representatives capabilities
+      in annotations file (in progress - not yet fully implemented)</li> -->
           <li>Group-associated consensus, sequence logos and
             conservation plots</li>
           <li>Symbol distributions for each column can be exported
@@ -2654,11 +3067,6 @@ li:before {
           <li>Cancel button for DAS Feature Fetching
           <li>PCA and PDB Viewers zoom via mouse roller
           <li>User-defined sub-tree colours and sub-tree selection
-
-
-
-
-
           
           <li>'New Window' button on the 'Output to Text box'
         </ul>
@@ -2673,11 +3081,6 @@ li:before {
           <li>Fixed Remove Empty Columns Bug (empty columns at end
             of alignment)
           <li>Slowed DAS Feature Fetching for increased robustness.
-
-
-
-
-
           
           <li>Made angle brackets in ASCII feature descriptions
             display correctly
@@ -2689,11 +3092,6 @@ li:before {
           <li>WsDbFetch query/result association resolved
           <li>Tree leaf to sequence mapping improved
           <li>Smooth fonts switch moved to FontChooser dialog box.
-
-
-
-
-
           
         </ul>
       </td>
index 8a0436d..60769a4 100755 (executable)
     highlights are below.
   </p>
   <ul>
-    <li><strong>New UI, and faster and more configurable implementation for PCA, Neighbour-Joining and UPGMA Trees</strong><br>
+    <li><strong>New UI, and faster and more configurable
+        implementation for PCA, Neighbour-Joining and UPGMA Trees</strong><br>
       Menu entries for calculating PCA and different types of tree have
       been replaced by a single <em>Calculations</em> dialog box. The
-      underlying implementation for the PCA and tree calculations have been
-      made faster and more memory efficient. A new framework has also been
-      created for the score models used to calculate distances between
-      sequences. This framework allows import of substitution matrices in
-      NCBI and AAIndex format, and custom score models to be created via a
-      groovy script.</li>
+      underlying implementation for the PCA and tree calculations have
+      been made faster and more memory efficient. A new framework has
+      also been created for the score models used to calculate distances
+      between sequences. This framework allows import of substitution
+      matrices in NCBI and AAIndex format, and custom score models to be
+      created via a groovy script.</li>
     <li><strong>Update to JABAWS 2.2</strong><br />Jalview's
       alignment, protein conservation analysis, and protein disorder and
       RNA secondary structure prediction services are now provided by <a
@@ -64,6 +65,9 @@
           (just select the region containing insertions to remove)
           without affecting the rest of the hidden columns.</li>
       </ul></li>
+    <li>Recent search histories for <a
+      href="features/search.html#queryhistory">Find</a> and the free
+      text search system (for querying Uniprot and the PDBe).</li>
   </ul>
   <p>
     <strong><a name="experimental">Experimental Features</a></strong>
         the Chimera viewer's Chimera menu</a> allow positional annotation to
       be exchanged between Chimera and Jalview.</li>
   </ul>
+  <p>
+    <strong>Scripting</strong><br />New <a
+      href="http://www.jalview.org/examples/groovy">groovy examples</a>
+    demonstrate Jalview 2.10.2 APIs for creation of data-driven
+    colourschemes, and custom alignment file handlers. The <a
+      href="groovy/featuresCounter.html">FeatureAnnotationWorker</a>
+    introduced in Jalview 2.10 has also been refactored to allow
+    efficient counting across multiple feature types. Please be aware
+    that feature counter scripts created for earlier versions will not
+    execute in Jalview 2.10.2.
+  </p>
 </body>
 </html>
index 45988fb..d472ef8 100644 (file)
@@ -4423,13 +4423,6 @@ public class Jalview2XML
 
     }
     // recover view properties and display parameters
-    if (view.getViewName() != null)
-    {
-      af.viewport.viewName = view.getViewName();
-      af.setInitialTabVisible();
-    }
-    af.setBounds(view.getXpos(), view.getYpos(), view.getWidth(),
-            view.getHeight());
 
     af.viewport.setShowAnnotation(view.getShowAnnotation());
     af.viewport.setAbovePIDThreshold(view.getPidSelected());
@@ -4463,6 +4456,14 @@ public class Jalview2XML
     af.viewport.setShowUnconserved(view.hasShowUnconserved() ? view
             .isShowUnconserved() : false);
     af.viewport.getRanges().setStartRes(view.getStartRes());
+
+    if (view.getViewName() != null)
+    {
+      af.viewport.viewName = view.getViewName();
+      af.setInitialTabVisible();
+    }
+    af.setBounds(view.getXpos(), view.getYpos(), view.getWidth(),
+            view.getHeight());
     // startSeq set in af.alignPanel.updateLayout below
     af.alignPanel.updateLayout();
     ColourSchemeI cs = null;
index ec53e93..2176719 100755 (executable)
@@ -365,7 +365,7 @@ public class SliderPanel extends GSliderPanel
     }
     if (forConservation)
     {
-      if (!scheme.conservationApplied())
+      if (!scheme.conservationApplied() && sg != null)
       {
         /*
          * first time the colour scheme has had Conservation shading applied
index 5a7a27f..70f16d9 100644 (file)
@@ -641,6 +641,20 @@ public abstract class AlignmentViewport implements AlignViewportI,
     {
       if (getConservationSelected())
       {
+        int retry = 0;
+        synchronized (this)
+        {
+          while (isCalcInProgress() && retry < 10)
+          {
+            try
+            {
+              wait(50);
+              retry++;
+            } catch (InterruptedException e)
+            {
+            }
+          }
+        }
         residueShading.setConservation(hconservation);
       }
       residueShading.alignmentChanged(alignment, hiddenRepSequences);
index 67098ae..af9c045 100644 (file)
@@ -544,10 +544,11 @@ public class AlignFrameTest
     assertEquals(af.alignPanel.getViewName(), "View 1");
     AlignViewport av2 = af.getViewport();
     assertNotSame(av, av2);
+    assertSame(av2, af.alignPanel.av);
     rs = av2.getResidueShading();
     assertNotSame(av.getResidueShading(), rs);
     assertEquals(rs.getThreshold(), 10);
-    assertTrue(rs.conservationApplied());
+    assertTrue(rs.conservationApplied(), rs.toString());
     assertEquals(rs.getConservationInc(), 20);
     assertEquals(av2.getAlignment().getGroups().size(), 1);
     sg = av2.getAlignment().getGroups().get(0);