help documentation for Jalview 2.7
authorjprocter <jprocter@compbio.dundee.ac.uk>
Tue, 20 Sep 2011 15:44:37 +0000 (16:44 +0100)
committerjprocter <jprocter@compbio.dundee.ac.uk>
Tue, 20 Sep 2011 15:44:37 +0000 (16:44 +0100)
13 files changed:
help/help.jhm
help/helpTOC.xml
help/html/features/clarguments.html
help/html/features/groovy.html
help/html/menus/alignmentMenu.html
help/html/menus/wsmenu.html
help/html/releases.html
help/html/webServices/clustalw.html [deleted file]
help/html/webServices/index.html
help/html/webServices/mafft.html [deleted file]
help/html/webServices/msaclient.html
help/html/webServices/muscle.html [deleted file]
help/html/webServices/shmr.html [new file with mode: 0755]

index 0ed676c..6ed0d7b 100755 (executable)
    <mapID target="wsparams" url="html/webServices/webServicesParams.html"/>
    <mapID target="wsprefs" url="html/webServices/webServicesPrefs.html"/>
    <mapID target="msaservice" url="html/webServices/msaclient.html"/>
-   <mapID target="clustal" url="html/webServices/clustalw.html"/>
-   <mapID target="muscle" url="html/webServices/muscle.html"/>
-   <mapID target="mafft" url="html/webServices/mafft.html"/>
    <mapID target="jnet" url="html/webServices/jnet.html"/>
+   <mapID target="shmrws" url="html/webServices/shmr.html"/>
    <mapID target="seqfetch" url="html/features/seqfetch.html"/>
    <mapID target="dbreffetcher" url="html/webservices/dbreffetcher.html"/>
    <mapID target="seqmappings" url="html/features/seqmappings.html"/>
index 3e41ba3..a1cf057 100755 (executable)
 <tocitem text="Jalview Documentation" target="home" expand="true" >
        <tocitem text="What's new" target="new" expand="true">
       <tocitem text="Jaba Web Services" target="jabaws"/>
-      <tocitem text="Superpositions with Jmol 12" target="pdbjmol"/>
-      <tocitem text="Web Service Parameters" target="wsparams"/>
-      <tocitem text="Web Service Preferences" target="wsprefs"/>
-      <tocitem text="Release History" target="release"/>
+      <tocitem text="Enhanced Jmol/Jalview interaction" target="pdbjmol"/>
+          <tocitem text="Sequence Harmony Multi-Relief Analysis" target="shmrws"/>
+      <tocitem text="Default Colouring preferences" target=""/>
        </tocitem>
     <tocitem text="Editing Alignments" target ="edit"/>        
     <tocitem text="Cursor Mode" target="cursor"/>
        <tocitem text="JABAWS" target="jabaws"/>
        <tocitem text="Web Service Preferences" target="wsprefs"/>
        <tocitem text="Web Service Parameters" target="wsparams"/>
-          <tocitem text="Sequence Alignment" target="msaservice" expand="false">
-               <tocitem text="Clustal Alignment" target="clustal"/>
-                <tocitem text="Muscle Alignment" target="muscle"/>
-                <tocitem text="MAFFT Alignment" target="mafft"/>
+       <tocitem text="Sequence Alignment" target="msaservice" expand="false">
                 <tocitem text="Multiple Alignment Subjobs" target="msaservice"/>
             </tocitem>
           <tocitem text="Secondary Structure Prediction" target="jnet"/>
+          <tocitem text="Sequence Harmony Multi-Relief Analysis" target="shmrws"/>
                <tocitem text="Sequence Retrieval" target="seqfetch"/>
                <tocitem text="Database Reference Retrieval" target="dbreffetcher"/>
                <tocitem text="DAS Feature Retrieval" target="das.viewing"/>
index 9ca64a6..88657f8 100644 (file)
  </tr>
 
  <tr> 
- <td><div align="center">-props FILE</div></td>
+ <td><div align="center">-props FILE/URL</div></td>
  <td><div align="left">Use the given Jalview properties file instead 
  of users default.</div></td>
  </tr>
  <tr> 
- <td><div align="center">-features FILE</div></td>
+ <td><div align="center">-features FILE/URL</div></td>
  <td><div align="left"> 
  <p>Use the given file to add sequence features to an alignment. 
  See <a href="featuresFormat.html" target="NEW">Features 
@@ -55,7 +55,7 @@
  </tr>
        <tr>
                <td>
-               <div align="center">-annotations FILE</div>
+               <div align="center">-annotations FILE/URL</div>
                </td>
                <td>Add precalculated annotations to the alignment. See <a
                        href="annotationsFormat.html" target="NEW">Annotation File</a>
@@ -63,7 +63,7 @@
        </tr>
        <tr>
                <td>
-               <div align="center">-tree FILE</div>
+               <div align="center">-tree FILE/URL</div>
                <td>
                <div align="left">Load the given newick format tree file onto
                the alignment</div>
        </tr>
        <tr>
                <td>
-               <div align="center">-groovy FILE</div>
+               <div align="center">-groovy FILE/URL</div>
                <td>
                <div align="left">Execute groovy script in FILE (where FILE may be 'STDIN' to read from the standard input) after all other
                arguments have been processed</div>
        </tr>
        <tr>
        <td>
-               <div align="center">-vdoc VAMSAS DOCUMENT FILE or URL</div>
+               <div align="center">-vdoc VAMSAS DOCUMENT FILE/URL</div>
                <td>
                <div align="left">Import the given vamsas document into a new session.<br><em>New in 2.5</em></div>
                </td>
        </tr>
        <tr>
                <td>
-               <div align="center">-groovy FILE</div>
-               <td>
-               <div align="left">Execute groovy script in FILE (where FILE may be 'STDIN' to read from the standard input) after all other
-               arguments have been processed</div>
-               </td>
-       </tr>
-       <tr>
-               <td>
                <div align="center">-fasta FILE</div>
                </td>
 
index d9aa13f..4f571dc 100644 (file)
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
 -->\r
-<head><title>Groovy Shell</title></head>\r
+<head>\r
+<title>Groovy Shell</title>\r
+</head>\r
 <body>\r
-<p><strong>The Groovy Shell</strong></p>\r
-<p><a href="http://groovy.codehaus.org/">Groovy</a> is an &quot;<em>agile and dynamic \r
-language for the Java platform</em>&quot;. The groovy scripting language makes it \r
-extremely easy to programmatically interact with Java programs, in much the same \r
-way that Javascript is used to generate and interact with applets and other \r
-objects on the page.</p>\r
-<p><strong><em>Getting Groovy...</em></strong><br>\r
-Jalview Groovy support is only possible if the core groovy \r
-jars which include the GroovyShell are present on the CLASSPATH \r
-when Jalview is started.</p><p>The jars are obtained from the \r
-<em>embedded</em> directory within the <a \r
-href="http://dist.codehaus.org/groovy/distributions">groovy \r
-distribution</a>. The easiest way of adding them to the \r
-Jalview classpath is to download and build jalview from \r
-it's source distribution, and then add the groovy-all-*.jar \r
-to the lib directory whose path is given in the java.ext.dirs property.</p>\r
-<p><strong>Opening Jalview's Groovy Console</strong><br>If groovy is available, then the \r
-<strong>Tools&#8594;Groovy Console...</strong> menu entry will be available \r
-from the Jalview Desktop's drop-down menu. Selecting this will open the\r
-<a href="http://groovy.codehaus.org/Groovy+Console">Groovy Console</a> which \r
-allows you to interactively execute Groovy scripts within the Jalview run-time environment.</p>\r
-<p><strong>Executing groovy scripts on Jalview startup</strong><br>\r
-The -groovy &lt;script&gt; option on the <a href="commandline.html"/>\r
-Jalview command line</a> will execute the contents of \r
-&lt;script&gt;. &lt;script&gt; may be a file, or alternatively if it is &quot;STDIN&quot; \r
-then the standard input will be used.</p>\r
-<p><strong>Access to Jalview's functions from Groovy Scripts</strong><br>\r
-There is as yet no properly defined scripting interface to Jalview, but all the\r
-public methods of the jalview class hierarchy can be called from Groovy scripts. \r
-The access point for this is the <strong>Jalview</strong> object defined in\r
-the groovy environent which corresponds to the <pre>jalview.gui.Desktop</pre> object which\r
-manages all the Jalview windows.</p>  \r
-Here's an example to get you started:<br>\r
-<ul><li>Getting the title, alignment and first sequence from the current alignFrame<br>\r
-<pre>\r
+       <p>\r
+               <strong>The Groovy Shell</strong>\r
+       </p>\r
+       <p>\r
+               <a href="http://groovy.codehaus.org/">Groovy</a> is an &quot;<em>agile\r
+                       and dynamic language for the Java platform</em>&quot;. The groovy\r
+               scripting language makes it extremely easy to programmatically\r
+               interact with Java programs, in much the same way that Javascript is\r
+               used to generate and interact with applets and other objects on the\r
+               page.\r
+       </p>\r
+       <p>\r
+               <strong><em>Getting Groovy...</em>\r
+               </strong><br> Jalview Groovy support is only possible if the core groovy\r
+               jars which include the GroovyShell are present on the CLASSPATH when\r
+               Jalview is started.\r
+       </p>\r
+       <p>\r
+               The jars are obtained from the <em>embedded</em> directory within the\r
+               <a href="http://dist.codehaus.org/groovy/distributions">groovy\r
+                       distribution</a>. The easiest way of adding them to the Jalview classpath\r
+               is to download and build jalview from it's source distribution, and\r
+               then add the groovy-all-*.jar to the lib directory whose path is given\r
+               in the java.ext.dirs property.\r
+       </p>\r
+       <p>\r
+               <strong>Opening Jalview's Groovy Console</strong><br>If groovy is\r
+               available, then the <strong>Tools&#8594;Groovy Console...</strong>\r
+               menu entry will be available from the Jalview Desktop's drop-down\r
+               menu. Selecting this will open the <a\r
+                       href="http://groovy.codehaus.org/Groovy+Console">Groovy Console</a>\r
+               which allows you to interactively execute Groovy scripts within the\r
+               Jalview run-time environment.\r
+       </p>\r
+       <p>\r
+               <strong>Executing groovy scripts on Jalview startup</strong><br>\r
+               The -groovy &lt;script&gt; option on the <a href="commandline.html" />\r
+               Jalview command line</a> will execute the contents of &lt;script&gt;.\r
+               &lt;script&gt; may be a file, a URL, or alternatively if it is\r
+               &quot;STDIN&quot; then the standard input will be used.<br>\r
+               <em>Note: The groovy script will be executed <strong>after</strong>\r
+                       any data is loaded, and <strong>before</strong> images or any output\r
+                       files are written. This allows you to perform customised jalview\r
+                       analysis workflows with groovy.</em>\r
+       </p>\r
+       <p>\r
+               <strong>Access to Jalview's functions from Groovy Scripts</strong><br>\r
+               There is as yet no properly defined scripting interface to Jalview,\r
+               but all the public methods of the jalview class hierarchy can be\r
+               called from Groovy scripts. The access point for this is the <strong>Jalview</strong>\r
+               object defined in the groovy environent which corresponds to the\r
+       <pre>jalview.gui.Desktop</pre>\r
+       object which manages all the Jalview windows.\r
+       </p>\r
+       Here's an example to get you started:\r
+       <br>\r
+       <ul>\r
+               <li>Getting the title, alignment and first sequence from the\r
+                       current alignFrame<br> <pre>\r
 def alf = Jalview.getAlignframes();\r
 print alf[0].getTitle();\r
 def alignment = alf[0].viewport.alignment;\r
 def seq = alignment.getSequenceAt(0);\r
-</pre>\r
-</li>\r
-</ul>\r
-</p>\r
+</pre></li>\r
+<li>When running a groovy script from the command line, the alignment that was just loaded can be referred to like so:<br><pre>\r
+print currentAlFrame.getTitle();</pre>\r
+       </ul>\r
+       </p>\r
 \r
-<p>&nbsp;</p>\r
+       <p>&nbsp;</p>\r
 </body>\r
 </html>\r
index 8156e93..c628cf1 100755 (executable)
 </head>
 
 <body>
-<p><strong>Alignment Window Menus</strong></p>
-       <li><strong>File</strong>
+       <p>
+               <strong>Alignment Window Menus</strong>
+       </p>
        <ul>
-               <li><strong>Fetch Sequence</strong><br>
-               <em>Shows a dialog window in which you can select known ids from
-               Uniprot, EMBL, EMBLCDS or PDB database using Web Services provided by
-               the European Bioinformatics Institute. See <a
-                       href="../features/seqfetch.html">Sequence Fetcher</a></em>.</li>
-               <li><strong>Add Sequences</strong><em><br>
-               Add sequences to the visible alignment from file, URL, or cut &amp;
-               paste window </em></li>
-               <li><strong>Reload</strong><em><br>
-               Reloads the alignment from the original file, if available.<br>
-               <strong>Warning: This will delete any edits, analyses and
-               colourings applied since the alignment was last saved, and cannot be
-               undone.</strong></em></li>
-               <li><strong>Save (Control S)</strong><em><br>
-               Saves the alignment to the file it was loaded from (if available), in
-               the same format, updating the original in place. </em></li>
-               <li><strong>Save As (Control Shift S)<br>
-               </strong><em>Save the alignment to local file. A file selection window
-               will open, use the &quot;Files of type:&quot; selection box to
-               determine which <a href="../io/index.html">alignment format</a> to
-               save as.</em></li>
-               <li><strong>Output to Textbox<br>
-               </strong><em>The alignment will be displayed in plain text in a new
-               window, which you can &quot;Copy and Paste&quot; using the pull down
-               menu, or your standard operating system copy and paste keys. The
-               output window also has a <strong>&quot;New Window&quot;</strong>
-               button to import the (possibly edited) text as a new alignment.<br>
-               Select the format of the text by selecting one of the following menu
-               items.</em>
-               <ul>
-                       <li><strong>FASTA</strong> <em></em></li>
-                       <li><strong>MSF</strong></li>
-                       <li><strong>CLUSTAL</strong></li>
-                       <li><strong>BLC</strong></li>
-                       <li><strong>PIR</strong></li>
-                       <li><strong>PFAM</strong></li>
-               </ul>
-               </li>
-               <li><strong>Print (Control P)<br>
-               </strong><em>Jalview will print the alignment using the current fonts and
-               colours of your alignment. If the alignment has annotations visible,
-               these will be printed below the alignment. If the alignment is wrapped
-               the number of residues per line of your alignment will depend on the
-               paper width or your alignment window width, whichever is the smaller.
-               </em></li>
-               <li><strong>Export Image</strong> <em><br>
-               Creates an alignment graphic with the current view's annotation,
-               alignment background colours and group colours. If the alignment is <a
-                       href="../features/wrap.html">wrapped</a>, the output will also be
-               wrapped and will have the same visible residue width as the open
-               alignment. </em>
-               <ul>
-                       <li><strong>HTML<br>
-                       </strong><em>Create a <a href="../io/export.html">web page</a> from your
-                       alignment.</em></li>
-                       <li><strong>EPS<br>
-                       </strong><em>Create an <a href="../io/export.html">Encapsulated
-                       Postscript</a> file from your alignment.</em></li>
-                       <li><strong>PNG<br>
-                       </strong><em>Create a <a href="../io/export.html">Portable Network
-                       Graphics</a> file from your alignment.</em></li>
-               </ul>
-               </li>
-               <li><strong>Export Features</strong><em><br>
-               All features visible on the alignment can be saved to file or
-               displayed in a textbox in either Jalview or GFF format</em></li>
-               <li><strong>Export Annotations</strong><em><br>
-               All annotations visible on the alignment can be saved to file or
-               displayed in a textbox in Jalview annotations format. </em></li>
-               <li><strong>Load Associated Tree<br>
-               </strong><em>Jalview can <a href="../calculations/treeviewer.html">view
-               trees</a> stored in the Newick file format, and associate them with the
-               alignment. Note: the ids of the tree file and your alignment MUST be
-               the same.</em></li>
-               <li><strong>Load Features / Annotations<br>
-               </strong><em>Load files describing precalculated <a
-                       href="../features/featuresFormat.html">sequence features</a> or <a
-                       href="../features/annotationsFormat.html">alignment annotations</a>.</em></li>
-               <li><strong>Close (Control W)</strong><br>
-               <em>Close the alignment window. Make sure you have saved your
-               alignment before you close - either as a Jalview project or by using
-               the <strong>Save As</strong> menu.</em></li>
-       </ul>
-       </li>
-       <li><strong>Edit</strong>
-       <ul>
-               <li><strong>Undo (Control Z)</strong><em><br>
-               This will undo any edits you make to the alignment. This applies to
-               insertion or deletion of gaps, cutting residues or sequences from the
-               alignment or pasting sequences to the current alignment or sorting the
-               alignment. <strong>NOTE:</strong> It DOES NOT undo colour changes,
-               adjustments to group sizes, or changes to the annotation panel. </em></li>
-               <li><strong>Redo (Control Y)<br>
-               </strong><em>Any actions which you undo can be redone using redo. </em></li>
-               <li><strong>Cut (Control X)<br>
-               </strong><em>This will make a copy of the currently selected residues
-               before removing them from your alignment. Click on a sequence name if
-               you wish to select a whole sequence. <br>
-               Use &lt;CTRL&gt; and X (&lt;APPLE&gt; and X on MacOSX) to cut.</em></li>
-               <li><strong>Copy (Control C)</strong><br>
-               <em>Copies the currently selected residues to the system
-               clipboard - you can also do this by pressing &lt;CTRL&gt; and C
-               (&lt;APPLE&gt; and C on MacOSX). <br>
-               If you try to paste the clipboard contents to a text editor, you will
-               see the format of the copied residues FASTA.</em></li>
-               <li><strong>Paste </strong>
-               <ul>
-                       <li><strong>To New Alignment (Control Shift V)<br>
-                       </strong><em>A new alignment window will be created from sequences
-                       previously copied or cut to the system clipboard. <br>
-                       Use &lt;CTRL&gt; and &lt;SHIFT&gt; and V(&lt;APPLE&gt; and
-                       &lt;SHIFT;&gt; and and V on MacOSX) to paste.</em></li>
-                       <li><strong>Add To This Alignment (Control V)<br>
-                       </strong><em>Copied sequences from another alignment window can be added
-                       to the current Jalview alignment. </em></li>
-               </ul>
-               </li>
-               <li><strong>Delete (Backspace)<br>
-               </strong><em>This will delete the currently selected residues without
-               copying them to the clipboard. Like the other edit operations, this
-               can be undone with <strong>Undo</strong>.</em></li>
-               <li><strong>Remove Left (Control L)<br>
-               </strong><em>If the alignment has marked columns, the alignment will be
-               trimmed to the left of the leftmost marked column. To mark a column,
-               mouse click the scale bar above the alignment. Click again to unmark a
-               column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
-               <li><strong>Remove Right (Control R)<br>
-               </strong><em>If the alignment has marked columns, the alignment will be
-               trimmed to the left of the leftmost marked column. To mark a column,
-               mouse click the scale bar above the alignment. Click again to unmark a
-               column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
-               <li><strong>Remove Empty Columns (Control E)<br>
-               </strong><em>All columns which only contain gap characters (&quot;-&quot;,
-               &quot;.&quot;) will be deleted.<br>
-               You may set the default gap character in <a
-                       href="../features/preferences.html">preferences</a>. </em></li>
-               <li><strong>Remove All Gaps (Control Shift E)</strong><br>
-               <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be deleted
-               from the selected area of the alignment. If no selection is made, ALL
-               the gaps in the alignment will be removed.<br>
-               You may set the default gap character in <a
-                       href="../features/preferences.html">preferences</a>. </em></li>
-               <li><strong>Remove Redundancy (Control D)<br>
-               </strong><em>Selecting this option brings up a window asking you to select
-               a threshold. If the percentage identity between any two sequences
-               (under the current alignment) exceeds this value then one of the
-               sequences (the shorter) is discarded. Press the &quot;Apply&quot;
-               button to remove redundant sequences. The &quot;Undo&quot; button will
-               undo the last redundancy deletion.</em></li>
-               <li><strong>Pad Gaps<br>
-               </strong><em>When selected, the alignment will be kept at minimal width
-               (so there no empty columns before or after the first or last aligned
-               residue) and all sequences will be padded with gap characters to the
-               before and after their terminating residues.<br>
-               This switch is useful when making a tree using unaligned sequences and
-               when working with alignment analysis programs which require 'properly
-               aligned sequences' to be all the same length.<br>
-               You may set the default for <strong>Pad Gaps</strong> in the <a
-                       href="../features/preferences.html">preferences</a>. </em></li>
-       </ul>
-       </li>
-       <li><strong>Select</strong>
-       <ul>
-               <li><strong><a href="../features/search.html">Find...
-               (Control F)</a></strong><em><br>
-               Opens the Find dialog box to search for residues, sequence name or
-               residue position within the alignment and create new sequence features
-               from the queries. </em></li>
-               <li><strong>Select All (Control A)<br>
-               </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></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 marked columns
-               will be deselected. </em><em> <br>
-               Use &lt;ESCAPE&gt; to deselect all.</em></li>
-               <li><strong>Invert Sequence Selection (Control I)<br>
-               </strong><em>Any sequence ids currently not selected will replace the
-               current selection. </em></li>
-               <li><strong>Invert Column Selection (Control Alt I)<br>
-               </strong><em>Any columns currently not selected will replace the current
-               column selection. </em></li>
-               <li><strong>Undefine Groups (Control U)<br>
-               </strong><em>The alignment will be reset with no defined groups.<br>
-               <strong>WARNING</strong>: This cannot be undone.</em></li>
-               <li><strong>Make Groups<br/></strong>
-               <em>The currently selected groups of the alignment will be 
-               subdivided according to the contents of the currently selected region. 
-               <br/>Use this to subdivide an alignment based on the 
-               different combinations of residues observed at specific 
-               positions. (new in jalview 2.5)</em></li>
-       </ul>
-       </li>
-       <li><strong>View</strong>
-       <ul>
-               <li><strong>New View (Control T)</strong><em><br>
-               Creates a new view from the current alignment view. </em></li>
-               <li><strong>Expand Views (X)</strong><em><br>
-               Display each view associated with the alignment in its own alignment
-               window, allowing several views to be displayed simultaneously. </em></li>
-               <li><strong>Gather Views (G)</strong><em><br>
-               Each view associated with the alignment will be displayed within its
-               own tab on the current alignment window. </em></li>
-               <li><strong>Show&#8594;(all Columns / Sequences / Sequences and Columns)</strong><em><br>
-               All hidden Columns / Sequences / Sequences and Columns will be revealed. </em></li>
-               <li><strong>Hide&#8594;(all Columns / Sequences / Selected Region / All but Selected Region )</strong><em><br>
-               Hides the all the currently selected Columns / Sequences / Region or everything but the selected Region.</em></li>
-                 <li><strong>Automatic Scrolling<br>
-    </strong><em>When selected, the view will automatically scroll to display the
-    highlighted sequence position corresponding to the position under the mouse 
-    pointer in a linked alignment or structure view.</em>
-               </li>
-               <li><strong>Show Annotations<br>
-               </strong><em>If this is selected the &quot;Annotation Panel&quot; will be
-               displayed below the alignment. The default setting is to display the
-               conservation calculation, quality calculation and consensus values as
-               bar charts. </em></li>
-    <li><strong>Autocalculated Annotation<br></strong>Settings for the display of autocalculated annotation.
-    <ul><li>
-       <strong>Apply to all groups<br></strong>
-       When ticked, any modification to the current settings will be applied to all autocalculated annotation.
-       </li> 
-       <li>
-       <strong>Show Consensus Histogram<br></strong>
-       Enable or disable the display of the histogram above the consensus sequence.
-       </li>
-       <li>
-       <strong>Show Consensus Profile<br></strong>
-               Enable or disable the display of the sequence logo above the consensus sequence.
-       </li>
-       <li>
-       <strong>Group Conservation<br></strong>
-       When ticked, display a conservation row for all groups (only available for protein alignments).
-       </li>
-       <li>
-       <strong>Apply to all groups<br></strong>
-       When ticked, display a consensus row for all groups.
-       </li>
-       </ul>
-    </li>
-    <li><strong>Show Sequence Features</strong><br>
-               <em>Show or hide sequence features on this alignment.</em></li>
-               <li><strong><a href="../features/featuresettings.html">Seqence
-               Feature Settings...</a></strong><em><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 servers.</em></li>
-               <li><strong>Sequence ID Tooltip</strong><em> (application only)
-    <br>This submenu's options allow the inclusion or exclusion of 
-    non-positional sequence features or database cross references 
-    from the tooltip shown when the mouse hovers over the sequence ID panel.</em></li> 
-  <li><strong>Alignment Properties...<br/>
-    </strong><em>Displays some simple statistics computed for the
-    current alignment view and any named properties defined on the
-    whole alignment.</em></li>
-               <li><strong><a href="../features/overview.html">Overview
-               Window</a><br>
-               </strong><em>A scaled version of the alignment will be displayed in a
-               small window. A red box will indicate the currently visible area of
-               the alignment. Move the visible region using the mouse. </em></li>
-       </ul>
-       </li>
-       <li><strong>Alignment Window Format Menu</strong>
-       <ul>
-               <li><strong>Font...<br>
-               </strong><em>Opens the &quot;Choose Font&quot; dialog box, in order to
-               change the font of the display and enable or disable 'smooth fonts'
-               (anti-aliasing) for faster alignment rendering. </em></li>
-               <li><strong>Wrap<br>
-               </strong><em>When ticked, the alignment display is &quot;<a
-                       href="../features/wrap.html">wrapped</a>&quot; to the width of the
-               alignment window. This is useful if your alignment has only a few
-               sequences to view its full width at once.<br>
-               Additional options for display of sequence numbering and scales are
-               also visible in wrapped layout mode:<br>
-               <ul>
-                       <li><strong>Scale Above</strong><br>
-                       Show the alignment column position scale.</li>
-                       <li><strong>Scale Left</strong><br>
-                       Show the sequence position for the first aligned residue in each row
-                       in the left column of the alignment.</li>
-                       <li><strong>Scale Right</strong><br>
-                       Show the sequence position for the last aligned residue in each row
-                       in the right-most column of the alignment.</li>
-               <li><strong>Show Sequence Limits<br>
-               </strong><em>If this box is selected the sequence name will have the start
-               and end position of the sequence appended to the name, in the format
-               NAME/START-END</em></li>
-               <li><strong>Right Align Sequence ID<br>
-               </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.</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>
-               <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 conjunction with
-               &quot;Colour Text.&quot; </em></li>
-               <li><strong>Text<br>
-               </strong><em>If this is selected the residues will be displayed using the
-               standard 1 character amino acid alphabet.</em></li>
-               <li><strong>Colour Text<br>
-               </strong><em>If this is selected the residues will be coloured according
-               to the background colour associated with that residue. The colour is
-               slightly darker than background so the amino acid symbol remains
-               visible. </em></li>
-               <li><strong>Show Gaps<br>
-               </strong><em>When this is selected, gap characters will be displayed as
-               &quot;.&quot; or &quot;-&quot;. If unselected, then gap characters
-               will appear as blank spaces. <br>
-               You may set the default gap character in <a
-                       href="../features/preferences.html">preferences</a>.</em></li>
-                       <li><strong>Centre Annotation Labels<br>
-                       </strong><em>Select this to center labels along an annotation row 
-                       relative to their associated column (default is off, i.e. left-justified).</em></li>
-                           <li><strong>Show Unconserved<br>
-    </strong><em>When this is selected, all consensus sequence symbols will be rendered as a '.', highlighting mutations in highly conserved alignments.
-    </em></li>
-                       
-       </ul>
-       <li><strong>Colour</strong>
-       <ul>
-               <li><strong>Apply Colour To All Groups<br>
-               </strong><em>If this is selected, any changes made to the background
-               colour will be applied to all currently defined groups.<br>
-               </em></li>
-               <li><strong><a href="../colourSchemes/textcolour.html">Colour
-               Text...</a></strong><em><br>
-               Opens the Colour Text dialog box to set a different text colour for
-               light and dark background, and the intensity threshold for transition
-               between them. </em></li>
-               <li>Colour Scheme options: <strong>None, ClustalX,
-               Blosum62 Score, Percentage Identity, Zappo, Taylor, Hydrophobicity,
-               Helix Propensity, Strand Propensity, Turn Propensity, Buried Index,
-               Nucleotide, User Defined<br>
-               </strong> <em>See <a href="../colourSchemes/index.html">colours</a> for a
-               description of all colour schemes.</em><br>
-               </li>
-               <li><strong>By Conservation<br>
-               </strong><em>See <a href="../colourSchemes/conservation.html">Colouring
-               by Conservation</a>.</em><br>
-               </li>
-               <li><strong>Modify Conservation Threshold<br>
-               </strong><em>Use this to display the conservation threshold slider window.
-               Useful if the window has been closed, or if the 'by conservation'
-               option appears to be doing nothing!</em><br>
-               </li>
-               <li><strong>Above Identity Threshold<br>
-               </strong><em>See <a href="../colourSchemes/abovePID.html">Above
-               Percentage Identity</a></em><strong>.<br>
-               </strong></li>
-               <li><strong>Modify Identity Threshold<br>
-               </strong><em>Use this to set the threshold value for colouring above
-               Identity. Useful if the window has been closed.<br>
-               </em></li>
-               <li><strong>By Annotation</strong><br>
-               <em>Colours the alignment on a per-column value from a specified
-               annotation. See <a href="../colourSchemes/annotationColouring.html">Annotation
-               Colouring</a>.</em><br>
-               </li>
-       </ul>
-       </li>
-       <li><strong>Calculate</strong>
-       <ul>
-               <li><strong>Sort </strong>
-               <ul>
-                       <li><strong>by ID</strong><em><br>
-                       This will sort the sequences according to sequence name. If the sort
-                       is repeated, the order of the sorted sequences will be inverted. </em></li>
-                       <li><strong>by Length</strong><em><br>
-        This will sort the sequences according to their length (excluding gap characters). If the sort is 
-        repeated, the order of the sorted sequences will be inverted. </em></li>
-               <li><strong>by Group</strong><strong><br>
-                       </strong><em>This will sort the sequences according to sequence name. If
-                       the sort is repeated, the order of the sorted sequences will be
-                       inverted. </em><strong></strong></li>
-                       <li><strong>by Pairwise Identity<br>
-                       </strong><em>This will sort the selected sequences by their percentage
-                       identity to the consensus sequence. The most similar sequence is put
-                       at the top. </em></li>
-                       <li><em>The <a href="../calculations/sorting.html">Sort
-                       menu</a> will have some additional options if you have just done a
-                       multiple alignment calculation, or opened a tree 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>Average Distance Using % Identity</strong></li>
-                       <li><strong>Neighbour Joining Using % Identity</strong></li>
-                       <li><strong>Average Distance Using Blosum62</strong></li>
-                       <li><strong>Neighbour Joining Using Blosum62<br>
-                       </strong></li>
-               </ul>
-               </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 the
-               BLOSUM62 scores in 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 large alignments it can be useful to deselect
-               &quot;Autocalculate Consensus&quot; when editing. This prevents the
-               sometimes lengthy calculations performed after each sequence edit.</em> <br>
-               </li>
-       </ul>
-       </li>
-       <li><strong>Web Service<br>
-       </strong> 
-         <ul><li><strong>Fetch DB References</strong><br>
-  <em>This will use any of the database services that Jalview is aware 
-  of (e.g. DAS sequence servers and the WSDBFetch service provided by the EBI)
-   to verify the sequence and retrieve all database cross references and PDB ids
-   associated with all or just the selected sequences in the alignment.</em><br>
-  </li>
-       </ul>
-       <em>Selecting one of the following menu items starts a remote
-       service on compute facilities at the University of Dundee. You need a
-       continuous network connection in order to use these services through
-       Jalview. </em>
-       <ul>
-               <li><strong>Alignment</strong>
-               <ul>
-                       <li><strong>ClustalW Multiple Sequence Alignment</strong><br>
-                       <em> Submits all, or just the currently selected sequences for
-                       alignment with clustal W.</em></li>
-                       <li><strong>ClustalW Multiple Sequence Alignment
-                       Realign</strong><br>
-                       <em> Submits the alignment or currently selected region for
-                       re-alignment with clustal W. Use this if you have added some new
-                       sequences to an existing alignment.</em></li>
-                       <li><strong>MAFFT Multiple Sequence Alignment</strong><br>
-                       <em>Submits all, or just the currently selected region for
-                       alignment with MAFFT. </em></li>
-                       <li><strong>Muscle Multiple Protein Sequence Alignment</strong><br>
-                       <em> Submits all, or just the currently selected sequences for
-                       alignment using Muscle. Do not use this if you are working with
-                       nucleic acid sequences.</em></li>
-               </ul>
-               </li>
-               <li><strong>Secondary Structure Prediction</strong>
-               <ul>
-                       <li><strong>JPred Secondary Structure Prediction</strong><br>
-                       <em>Secondary structure prediction by network consensus. The
-                       behaviour of this calculation depends on the current selection: </em></li>
-                       <li><em>If nothing is selected, and the displayed sequences
-                       appear to be aligned, then a JNet prediction will be run for the
-                       first sequence in the alignment, using the current alignment.
-                       Otherwise the first sequence will be submitted for prediction. </em></li>
-                       <li><em>If just one sequence (or a region on one sequence)
-                       has been selected, it will be submitted to the automatic JNet
-                       prediction server for homolog detection and prediction. </em></li>
-                       <li><em>If a set of sequences are selected, and they appear
-                       to be aligned, then the alignment will be used for a Jnet prediction
-                       on the <strong>first</strong> sequence in the set (that is, the one
-                       that appears first in the alignment window). </em></li>
-               </ul>
+               <li><strong>File</strong>
+                       <ul>
+                               <li><strong>Fetch Sequence</strong><br> <em>Shows a
+                                               dialog window in which you can select known ids from Uniprot,
+                                               EMBL, EMBLCDS or PDB database using Web Services provided by the
+                                               European Bioinformatics Institute. See <a
+                                               href="../features/seqfetch.html">Sequence Fetcher</a> </em>.</li>
+                               <li><strong>Add Sequences</strong><em><br> Add
+                                               sequences to the visible alignment from file, URL, or cut &amp;
+                                               paste window </em>
+                               </li>
+                               <li><strong>Reload</strong><em><br> Reloads the
+                                               alignment from the original file, if available.<br> <strong>Warning:
+                                                       This will delete any edits, analyses and colourings applied since
+                                                       the alignment was last saved, and cannot be undone.</strong> </em>
+                               </li>
+                               <li><strong>Save (Control S)</strong><em><br> Saves
+                                               the alignment to the file it was loaded from (if available), in
+                                               the same format, updating the original in place. </em>
+                               </li>
+                               <li><strong>Save As (Control Shift S)<br> </strong><em>Save
+                                               the alignment to local file. A file selection window will open,
+                                               use the &quot;Files of type:&quot; selection box to determine
+                                               which <a href="../io/index.html">alignment format</a> to save as.</em>
+                               </li>
+                               <li><strong>Output to Textbox<br> </strong><em>The
+                                               alignment will be displayed in plain text in a new window, which
+                                               you can &quot;Copy and Paste&quot; using the pull down menu, or
+                                               your standard operating system copy and paste keys. The output
+                                               window also has a <strong>&quot;New Window&quot;</strong> button
+                                               to import the (possibly edited) text as a new alignment.<br>
+                                               Select the format of the text by selecting one of the following
+                                               menu items.</em>
+                                       <ul>
+                                               <li><strong>FASTA</strong> <em></em>
+                                               </li>
+                                               <li><strong>MSF</strong>
+                                               </li>
+                                               <li><strong>CLUSTAL</strong>
+                                               </li>
+                                               <li><strong>BLC</strong>
+                                               </li>
+                                               <li><strong>PIR</strong>
+                                               </li>
+                                               <li><strong>PFAM</strong>
+                                               </li>
+                                       </ul></li>
+                               <li><strong>Print (Control P)<br> </strong><em>Jalview
+                                               will print the alignment using the current fonts and colours of
+                                               your alignment. If the alignment has annotations visible, these
+                                               will be printed below the alignment. If the alignment is wrapped
+                                               the number of residues per line of your alignment will depend on
+                                               the paper width or your alignment window width, whichever is the
+                                               smaller. </em>
+                               </li>
+                               <li><strong>Export Image</strong> <em><br> Creates an
+                                               alignment graphic with the current view's annotation, alignment
+                                               background colours and group colours. If the alignment is <a
+                                               href="../features/wrap.html">wrapped</a>, the output will also be
+                                               wrapped and will have the same visible residue width as the open
+                                               alignment. </em>
+                                       <ul>
+                                               <li><strong>HTML<br> </strong><em>Create a <a
+                                                               href="../io/export.html">web page</a> from your alignment.</em>
+                                               </li>
+                                               <li><strong>EPS<br> </strong><em>Create an <a
+                                                               href="../io/export.html">Encapsulated Postscript</a> file from
+                                                               your alignment.</em>
+                                               </li>
+                                               <li><strong>PNG<br> </strong><em>Create a <a
+                                                               href="../io/export.html">Portable Network Graphics</a> file from
+                                                               your alignment.</em>
+                                               </li>
+                                       </ul></li>
+                               <li><strong>Export Features</strong><em><br> All
+                                               features visible on the alignment can be saved to file or
+                                               displayed in a textbox in either Jalview or GFF format</em>
+                               </li>
+                               <li><strong>Export Annotations</strong><em><br> All
+                                               annotations visible on the alignment can be saved to file or
+                                               displayed in a textbox in Jalview annotations format. </em>
+                               </li>
+                               <li><strong>Load Associated Tree<br> </strong><em>Jalview
+                                               can <a href="../calculations/treeviewer.html">view trees</a>
+                                               stored in the Newick file format, and associate them with the
+                                               alignment. Note: the ids of the tree file and your alignment MUST
+                                               be the same.</em></li>
+                               <li><strong>Load Features / Annotations<br> </strong><em>Load
+                                               files describing precalculated <a
+                                               href="../features/featuresFormat.html">sequence features</a> or <a
+                                               href="../features/annotationsFormat.html">alignment
+                                                       annotations</a>.</em></li>
+                               <li><strong>Close (Control W)</strong><br> <em>Close
+                                               the alignment window. Make sure you have saved your alignment
+                                               before you close - either as a Jalview project or by using the <strong>Save
+                                                       As</strong> menu.</em>
+                               </li>
+                       </ul></li>
+               <li><strong>Edit</strong>
+                       <ul>
+                               <li><strong>Undo (Control Z)</strong><em><br> This
+                                               will undo any edits you make to the alignment. This applies to
+                                               insertion or deletion of gaps, cutting residues or sequences from
+                                               the alignment or pasting sequences to the current alignment or
+                                               sorting the alignment. <strong>NOTE:</strong> It DOES NOT undo
+                                               colour changes, adjustments to group sizes, or changes to the
+                                               annotation panel. </em>
+                               </li>
+                               <li><strong>Redo (Control Y)<br> </strong><em>Any
+                                               actions which you undo can be redone using redo. </em>
+                               </li>
+                               <li><strong>Cut (Control X)<br> </strong><em>This
+                                               will make a copy of the currently selected residues before
+                                               removing them from your alignment. Click on a sequence name if you
+                                               wish to select a whole sequence. <br> Use &lt;CTRL&gt; and X
+                                               (&lt;APPLE&gt; and X on MacOSX) to cut.</em>
+                               </li>
+                               <li><strong>Copy (Control C)</strong><br> <em>Copies
+                                               the currently selected residues to the system clipboard - you can
+                                               also do this by pressing &lt;CTRL&gt; and C (&lt;APPLE&gt; and C
+                                               on MacOSX). <br> If you try to paste the clipboard contents
+                                               to a text editor, you will see the format of the copied residues
+                                               FASTA.</em></li>
+                               <li><strong>Paste </strong>
+                                       <ul>
+                                               <li><strong>To New Alignment (Control Shift V)<br>
+                                               </strong><em>A new alignment window will be created from sequences
+                                                               previously copied or cut to the system clipboard. <br> Use
+                                                               &lt;CTRL&gt; and &lt;SHIFT&gt; and V(&lt;APPLE&gt; and
+                                                               &lt;SHIFT;&gt; and and V on MacOSX) to paste.</em>
+                                               </li>
+                                               <li><strong>Add To This Alignment (Control V)<br>
+                                               </strong><em>Copied sequences from another alignment window can be
+                                                               added to the current Jalview alignment. </em>
+                                               </li>
+                                       </ul></li>
+                               <li><strong>Delete (Backspace)<br> </strong><em>This
+                                               will delete the currently selected residues without copying them
+                                               to the clipboard. Like the other edit operations, this can be
+                                               undone with <strong>Undo</strong>.</em>
+                               </li>
+                               <li><strong>Remove Left (Control L)<br> </strong><em>If
+                                               the alignment has marked columns, the alignment will be trimmed to
+                                               the left of the leftmost marked column. To mark a column, mouse
+                                               click the scale bar above the alignment. Click again to unmark a
+                                               column, or select &quot;Deselect All&quot; to deselect all
+                                               columns.</em></li>
+                               <li><strong>Remove Right (Control R)<br> </strong><em>If
+                                               the alignment has marked columns, the alignment will be trimmed to
+                                               the left of the leftmost marked column. To mark a column, mouse
+                                               click the scale bar above the alignment. Click again to unmark a
+                                               column, or select &quot;Deselect All&quot; to deselect all
+                                               columns.</em></li>
+                               <li><strong>Remove Empty Columns (Control E)<br>
+                               </strong><em>All columns which only contain gap characters
+                                               (&quot;-&quot;, &quot;.&quot;) will be deleted.<br> You may
+                                               set the default gap character in <a
+                                               href="../features/preferences.html">preferences</a>. </em>
+                               </li>
+                               <li><strong>Remove All Gaps (Control Shift E)</strong><br>
+                                       <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be
+                                               deleted from the selected area of the alignment. If no selection
+                                               is made, ALL the gaps in the alignment will be removed.<br>
+                                               You may set the default gap character in <a
+                                               href="../features/preferences.html">preferences</a>. </em>
+                               </li>
+                               <li><strong>Remove Redundancy (Control D)<br> </strong><em>Selecting
+                                               this option brings up a window asking you to select a threshold.
+                                               If the percentage identity between any two sequences (under the
+                                               current alignment) exceeds this value then one of the sequences
+                                               (the shorter) is discarded. Press the &quot;Apply&quot; button to
+                                               remove redundant sequences. The &quot;Undo&quot; button will undo
+                                               the last redundancy deletion.</em>
+                               </li>
+                               <li><strong>Pad Gaps<br> </strong><em>When selected,
+                                               the alignment will be kept at minimal width (so there no empty
+                                               columns before or after the first or last aligned residue) and all
+                                               sequences will be padded with gap characters to the before and
+                                               after their terminating residues.<br> This switch is useful
+                                               when making a tree using unaligned sequences and when working with
+                                               alignment analysis programs which require 'properly aligned
+                                               sequences' to be all the same length.<br> You may set the
+                                               default for <strong>Pad Gaps</strong> in the <a
+                                               href="../features/preferences.html">preferences</a>. </em>
+                               </li>
+                       </ul></li>
+               <li><strong>Select</strong>
+                       <ul>
+                               <li><strong><a href="../features/search.html">Find...
+                                                       (Control F)</a> </strong><em><br> Opens the Find dialog box to
+                                               search for residues, sequence name or residue position within the
+                                               alignment and create new sequence features from the queries. </em>
+                               </li>
+                               <li><strong>Select All (Control A)<br> </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></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 marked columns will
+                                               be deselected. </em><em> <br> Use &lt;ESCAPE&gt; to deselect
+                                               all.</em></li>
+                               <li><strong>Invert Sequence Selection (Control I)<br>
+                               </strong><em>Any sequence ids currently not selected will replace the
+                                               current selection. </em>
+                               </li>
+                               <li><strong>Invert Column Selection (Control Alt I)<br>
+                               </strong><em>Any columns currently not selected will replace the current
+                                               column selection. </em>
+                               </li>
+                               <li><strong>Undefine Groups (Control U)<br> </strong><em>The
+                                               alignment will be reset with no defined groups.<br> <strong>WARNING</strong>:
+                                               This cannot be undone.</em>
+                               </li>
+                               <li><strong>Make Groups<br /> </strong> <em>The currently
+                                               selected groups of the alignment will be subdivided according to
+                                               the contents of the currently selected region. <br />Use this to
+                                               subdivide an alignment based on the different combinations of
+                                               residues observed at specific positions. (new in jalview 2.5)</em>
+                               </li>
+                       </ul></li>
+               <li><strong>View</strong>
+                       <ul>
+                               <li><strong>New View (Control T)</strong><em><br>
+                                               Creates a new view from the current alignment view. </em>
+                               </li>
+                               <li><strong>Expand Views (X)</strong><em><br> Display
+                                               each view associated with the alignment in its own alignment
+                                               window, allowing several views to be displayed simultaneously. </em>
+                               </li>
+                               <li><strong>Gather Views (G)</strong><em><br> Each
+                                               view associated with the alignment will be displayed within its
+                                               own tab on the current alignment window. </em>
+                               </li>
+                               <li><strong>Show&#8594;(all Columns / Sequences /
+                                               Sequences and Columns)</strong><em><br> All hidden Columns /
+                                               Sequences / Sequences and Columns will be revealed. </em>
+                               </li>
+                               <li><strong>Hide&#8594;(all Columns / Sequences /
+                                               Selected Region / All but Selected Region )</strong><em><br>
+                                               Hides the all the currently selected Columns / Sequences / Region
+                                               or everything but the selected Region.</em>
+                               </li>
+                               <li><strong>Automatic Scrolling<br> </strong><em>When
+                                               selected, the view will automatically scroll to display the
+                                               highlighted sequence position corresponding to the position under
+                                               the mouse pointer in a linked alignment or structure view.</em></li>
+                               <li><strong>Show Annotations<br> </strong><em>If this
+                                               is selected the &quot;Annotation Panel&quot; will be displayed
+                                               below the alignment. The default setting is to display the
+                                               conservation calculation, quality calculation and consensus values
+                                               as bar charts. </em>
+                               </li>
+                               <li><strong>Autocalculated Annotation<br> </strong><em>Settings
+                                       for the display of autocalculated annotation.</em>
+                                       <ul>
+                                               <li><strong>Apply to all groups<br> </strong><em> When
+                                                       ticked, any modification to the current settings will be applied
+                                                       to all autocalculated annotation.</em></li>
+                                               <li><strong>Show Consensus Histogram<br> </strong><em>
+                                                       Enable or disable the display of the histogram above the
+                                                       consensus sequence.</em></li>
+                                               <li><strong>Show Consensus Profile<br> </strong><em> Enable
+                                                       or disable the display of the sequence logo above the consensus
+                                                       sequence.</em></li>
+                                               <li><strong>Group Conservation<br> </strong><em> When
+                                                       ticked, display a conservation row for all groups (only available
+                                                       for protein alignments).</em></li>
+                                               <li><strong>Apply to all groups<br> </strong><em> When
+                                                       ticked, display a consensus row for all groups.</em></li>
+                                       </ul></li>
+                               <li><strong>Show Sequence Features</strong><br> <em>Show
+                                               or hide sequence features on this alignment.</em>
+                               </li>
+                               <li><strong><a href="../features/featuresettings.html">Seqence
+                                                       Feature Settings...</a> </strong><em><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 servers.</em>
+                               </li>
+                               <li><strong>Sequence ID Tooltip</strong><em> (application
+                                               only) <br>This submenu's options allow the inclusion or
+                                               exclusion of non-positional sequence features or database cross
+                                               references from the tooltip shown when the mouse hovers over the
+                                               sequence ID panel.</em>
+                               </li>
+                               <li><strong>Alignment Properties...<br /> </strong><em>Displays
+                                               some simple statistics computed for the current alignment view and
+                                               any named properties defined on the whole alignment.</em>
+                               </li>
+                               <li><strong><a href="../features/overview.html">Overview
+                                                       Window</a><br> </strong><em>A scaled version of the alignment will
+                                               be displayed in a small window. A red box will indicate the
+                                               currently visible area of the alignment. Move the visible region
+                                               using the mouse. </em>
+                               </li>
+                       </ul></li>
+               <li><strong>Alignment Window Format Menu</strong>
+                       <ul>
+                               <li><strong>Font...<br> </strong><em>Opens the
+                                               &quot;Choose Font&quot; dialog box, in order to change the font of
+                                               the display and enable or disable 'smooth fonts' (anti-aliasing)
+                                               for faster alignment rendering. </em></li>
+                               <li><strong>Wrap<br> </strong><em>When ticked, the
+                                               alignment display is &quot;<a href="../features/wrap.html">wrapped</a>&quot;
+                                               to the width of the alignment window. This is useful if your
+                                               alignment has only a few sequences to view its full width at once.</em><br>
+                                       Additional options for display of sequence numbering and scales are
+                                       also visible in wrapped layout mode:<br>
+                                       <ul>
+                                               <li><strong>Scale Above</strong><br><em> Show the alignment
+                                                       column position scale.</em></li>
+                                               <li><strong>Scale Left</strong><br><em> Show the sequence
+                                                       position for the first aligned residue in each row in the left
+                                                       column of the alignment.</em></li>
+                                               <li><strong>Scale Right</strong><br><em> Show the sequence
+                                                       position for the last aligned residue in each row in the
+                                                       right-most column of the alignment.</em></li>
+                                               <li><strong>Show Sequence Limits<br> </strong><em>If
+                                                               this box is selected the sequence name will have the start and
+                                                               end position of the sequence appended to the name, in the format
+                                                               NAME/START-END</em>
+                                               </li>
+                                               <li><strong>Right Align Sequence ID<br> </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. 
+                                               </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>
+                                               <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 conjunction with
+                                                               &quot;Colour Text.&quot; </em>
+                                               </li>
+                                               <li><strong>Text<br> </strong><em>If this is
+                                                               selected the residues will be displayed using the standard 1
+                                                               character amino acid alphabet.</em>
+                                               </li>
+                                               <li><strong>Colour Text<br> </strong><em>If this is
+                                                               selected the residues will be coloured according to the
+                                                               background colour associated with that residue. The colour is
+                                                               slightly darker than background so the amino acid symbol remains
+                                                               visible. </em>
+                                               </li>
+                                               <li><strong>Show Gaps<br> </strong><em>When this is
+                                                               selected, gap characters will be displayed as &quot;.&quot; or
+                                                               &quot;-&quot;. If unselected, then gap characters will appear as
+                                                               blank spaces. <br> You may set the default gap character in
+                                                               <a href="../features/preferences.html">preferences</a>.</em>
+                                               </li>
+                                               <li><strong>Centre Annotation Labels<br> </strong><em>Select
+                                                               this to center labels along an annotation row relative to their
+                                                               associated column (default is off, i.e. left-justified).</em>
+                                               </li>
+                                               <li><strong>Show Unconserved<br> </strong><em>When
+                                                               this is selected, all consensus sequence symbols will be
+                                                               rendered as a '.', highlighting mutations in highly conserved
+                                                               alignments. </em>
+                                               </li>
+
+                                       </ul></li>
+                       </ul>
                </li>
+
+               <li><strong>Colour</strong>
+                       <ul>
+                               <li><strong>Apply Colour To All Groups<br> </strong><em>If
+                                               this is selected, any changes made to the background colour will
+                                               be applied to all currently defined groups.<br> </em>
+                               </li>
+                               <li><strong><a href="../colourSchemes/textcolour.html">Colour
+                                                       Text...</a> </strong><em><br> Opens the Colour Text dialog box to
+                                               set a different text colour for light and dark background, and the
+                                               intensity threshold for transition between them. </em>
+                               </li>
+                               <li>Colour Scheme options: <strong>None, ClustalX,
+                                               Blosum62 Score, Percentage Identity, Zappo, Taylor,
+                                               Hydrophobicity, Helix Propensity, Strand Propensity, Turn
+                                               Propensity, Buried Index, Nucleotide, User Defined<br> </strong> <em>See
+                                               <a href="../colourSchemes/index.html">colours</a> for a
+                                               description of all colour schemes.</em><br></li>
+                               <li><strong>By Conservation<br> </strong><em>See <a
+                                               href="../colourSchemes/conservation.html">Colouring by
+                                                       Conservation</a>.</em><br></li>
+                               <li><strong>Modify Conservation Threshold<br> </strong><em>Use
+                                               this to display the conservation threshold slider window. Useful
+                                               if the window has been closed, or if the 'by conservation' option
+                                               appears to be doing nothing!</em><br></li>
+                               <li><strong>Above Identity Threshold<br> </strong><em>See
+                                               <a href="../colourSchemes/abovePID.html">Above Percentage
+                                                       Identity</a> </em><strong>.<br> </strong>
+                               </li>
+                               <li><strong>Modify Identity Threshold<br> </strong><em>Use
+                                               this to set the threshold value for colouring above Identity.
+                                               Useful if the window has been closed.<br> </em>
+                               </li>
+                               <li><strong>By Annotation</strong><br> <em>Colours
+                                               the alignment on a per-column value from a specified annotation.
+                                               See <a href="../colourSchemes/annotationColouring.html">Annotation
+                                                       Colouring</a>.</em><br></li>
+                       </ul></li>
+               <li><strong>Calculate</strong>
+                       <ul>
+                               <li><strong>Sort </strong>
+                                       <ul>
+                                               <li><strong>by ID</strong><em><br> This will sort
+                                                               the sequences according to sequence name. If the sort is
+                                                               repeated, the order of the sorted sequences will be inverted. </em>
+                                               </li>
+                                               <li><strong>by Length</strong><em><br> This will
+                                                               sort the sequences according to their length (excluding gap
+                                                               characters). If the sort is repeated, the order of the sorted
+                                                               sequences will be inverted. </em></li>
+                                               <li><strong>by Group</strong><strong><br> </strong><em>This
+                                                               will sort the sequences according to sequence name. If the sort
+                                                               is repeated, the order of the sorted sequences will be inverted.
+                                               </em><strong></strong></li>
+                                               <li><strong>by Pairwise Identity<br> </strong><em>This
+                                                               will sort the selected sequences by their percentage identity to
+                                                               the consensus sequence. The most similar sequence is put at the
+                                                               top. </em></li>
+                                               <li><em>The <a href="../calculations/sorting.html">Sort
+                                                                       menu</a> will have some additional options if you have just done a
+                                                               multiple alignment calculation, or opened a tree 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>Average Distance Using % Identity</strong></li>
+                                               <li><strong>Neighbour Joining Using % Identity</strong></li>
+                                               <li><strong>Average Distance Using Blosum62</strong></li>
+                                               <li><strong>Neighbour Joining Using Blosum62<br>
+                                               </strong></li>
+                                       </ul>
+                               </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 the BLOSUM62 scores
+                                               in 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
+                                               large alignments it can be useful to deselect &quot;Autocalculate
+                                               Consensus&quot; when editing. This prevents the sometimes lengthy
+                                               calculations performed after each sequence edit.</em> <br>
+                               </li>
+                               <li><strong>Sort With New Tree</strong><br> <em>When
+                                               enabled, Jalview will automatically sort the alignment when a new
+                                               tree is calculated or loaded onto it.</em> <br></li>
+                       </ul></li>
+
+               <li><strong>Web Service Menu</strong><br /> <em>This menu
+                               is dynamic, and may contain user-defined web service entries in
+                               addition to any of the following ones:</em>
+                       <ul>
+                               <li><strong>Fetch DB References</strong><br> <em>This
+                                               will use any of the database services that Jalview is aware of
+                                               (e.g. DAS sequence servers and the WSDBFetch service provided by
+                                               the EBI) to verify the sequence and retrieve all database cross
+                                               references and PDB ids associated with all or just the selected
+                                               sequences in the alignment. <br />'Standard Databases' will check
+                                               sequences against the EBI databases plus any active DAS sequence
+                                               sources, or you can verify against a specific source from one of
+                                               the sub-menus.</em><br></li>
+                               <li><strong>Envision2 Services</strong><br /><em> Submits one or
+                                       more sequences, sequence IDs or database references to analysis
+                                       workflows provided by the <a
+                                       href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2 web
+                                               application</a>. This allows Jalview users to easily access the EnCore
+                                       network of databases and analysis services developed by members of
+                                       <a href="http://www.enfin.org">ENFIN</a></em>.</li>
+                       </ul>
+                       <p>Selecting items from the following submenus will start a
+                               remote service on compute facilities at the University of Dundee, or
+                               elsewhere. You need a continuous network connection in order to use
+                               these services through Jalview.
+                       </p>
+                       <ul>
+                               <li><strong>Alignment</strong><br /><em> Align the currently
+                                       selected sequences or all sequences in the alignment, or re-align
+                                       unaligned sequences to the aligned sequences. Entries in this menu
+                                       provide access to the various alignment programs supported by <a
+                                       href="../webServices/JABAWS.html">JABAWS</a>. See the <a
+                                       href="../webServices/msaclient.html">Multiple Sequence
+                                               Alignment webservice client</a> entry for more information.</em></li>
+                               <li><strong>Secondary Structure Prediction</strong>
+                                       <ul>
+                                               <li><strong>JPred Secondary Structure Prediction</strong><br>
+                                                       <em>Secondary structure prediction by network consensus. See
+                                                               the <a href="../webServices/jnet.html">Jpred3</a> client entry for
+                                                               more information. The behaviour of this calculation depends on
+                                                               the current selection:
+                                                               <ul>
+                                                                       <li>If nothing is selected, and the displayed sequences
+                                                                               appear to be aligned, then a JNet prediction will be run for
+                                                                               the first sequence in the alignment, using the current
+                                                                               alignment. Otherwise the first sequence will be submitted for
+                                                                               prediction.</li>
+                                                                       <li>If just one sequence (or a region on one sequence) has
+                                                                               been selected, it will be submitted to the automatic JNet
+                                                                               prediction server for homolog detection and prediction.</li>
+                                                                       <li>If a set of sequences are selected, and they appear to
+                                                                               be aligned, then the alignment will be used for a Jnet
+                                                                               prediction on the <strong>first</strong> sequence in the set
+                                                                               (that is, the one that appears first in the alignment window).
+                                                                       </li>
+                                                               </ul> </em>
+                                       </ul></li>
+                               <li><strong>Analysis</strong><br />
+                                       <ul>
+                                               <li><strong>Sequence Harmony Multi-Relief</strong><br> <em>Performs
+                                                               functional residue analysis on a protein family alignment with
+                                                               sub-families defined on it. See the <a
+                                                               href="../webServices/shmr.html">SHMR client</a> entry for more
+                                                               information.</em>
+                                               </li>
+                                       </ul></li>
+                       </ul></li>
        </ul>
-       </li>
-</ul>
+
 </body>
 </html>
index bac5a96..beb5443 100755 (executable)
 <head><title>Web Service Menu</title></head>
 
 <body>
-<p><strong>Web Service Menu</strong></p>
-<ul>
-  <li><strong>Fetch DB References</strong><br>
-  <em>This will use any of the database services that Jalview is aware 
-  of (e.g. DAS sequence servers and the WSDBFetch service provided by the EBI)
-   to verify the sequence and retrieve all database cross references and PDB ids
-   associated with all or just the selected sequences in the alignment.
-   <br/>'Standard Databases' will check sequences against the EBI databases 
-   plus any active DAS sequence sources, or you can verify against a specific 
-   source from one of the sub-menus.</em><br>
-  </li>
-  <li><strong>Envision2 Services</strong><br/>
-  Submits one or more sequences, sequence IDs or database references to analysis workflows provided 
-by the <a href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2
-web application</a>. This allows Jalview users to easily access the EnCore network of
-databases and analysis services developed by members of <a href="http://www.enfin.org">ENFIN</a>.
-  </li>
-  </ul>
-    </strong> <em>Selecting one of the following menu items starts a remote service 
-  on compute facilities at the University of Dundee. You need a continuous network 
-  connection in order to use these services through Jalview. </em> </p>
-  <ul>
-  <li><strong>Alignment</strong> 
-    <ul>
-      <li><strong>ClustalW Multiple Sequence Alignment</strong><br>
-        <em> Submits all, or just the currently selected sequences for alignment 
-        with clustal W.</em></li>
-      <li><strong>ClustalW Multiple Sequence Alignment Realign</strong><br>
-        <em> Submits the alignment or currently selected region for re-alignment 
-        with clustal W. This enables you to align more sequences to an existing alignment.</em></li>
-      <li><strong>MAFFT Multiple Sequence Alignment</strong><br>
-        <em>Submits all, or just the currently selected region for alignment with 
-        MAFFT. </em> </li>
-      <li><strong>Muscle Multiple Protein Sequence Alignment</strong><br>
-        <em> Submits all, or just the currently selected sequences for alignment 
-        using Muscle. Do not use this if you are working with nucleic acid sequences.</em></li>
-    </ul>
-  </li>
-  <li><strong>Secondary Structure Prediction</strong> 
-    <ul>
-      <li><strong>JPred Secondary Structure Prediction</strong><br>
-        <em>Secondary structure prediction by network consensus. The behaviour 
-        of this calculation depends on the current selection: </em></li>
-      <li><em>If nothing is selected, and the displayed sequences appear to be 
-        aligned, then a JNet prediction will be run for the first sequence in 
-        the alignment, using the current alignment. Otherwise the first sequence 
-        will be submitted for prediction. </em></li>
-      <li><em>If just one sequence (or a region on one sequence) has been selected, 
-        it will be submitted to the automatic JNet prediction server for homolog 
-        detection and prediction. </em></li>
-      <li><em>If a set of sequences are selected, and they appear to be aligned, 
-        then the alignment will be used for a Jnet prediction on the <strong>first</strong> 
-        sequence in the set (that is, the one that appears first in the alignment 
-        window). </em> </li>
-    </ul>
-  </li>
-</ul>
-<p><strong> </strong></p>
+               <p><strong>Web Service Menu</strong><br /> <em>This menu
+                               is dynamic, and may contain user-defined web service entries in
+                               addition to any of the following ones:</em>
+                       <ul>
+                               <li><strong>Fetch DB References</strong><br> <em>This
+                                               will use any of the database services that Jalview is aware of
+                                               (e.g. DAS sequence servers and the WSDBFetch service provided by
+                                               the EBI) to verify the sequence and retrieve all database cross
+                                               references and PDB ids associated with all or just the selected
+                                               sequences in the alignment. <br />'Standard Databases' will check
+                                               sequences against the EBI databases plus any active DAS sequence
+                                               sources, or you can verify against a specific source from one of
+                                               the sub-menus.</em><br></li>
+                               <li><strong>Envision2 Services</strong><br /><em> Submits one or
+                                       more sequences, sequence IDs or database references to analysis
+                                       workflows provided by the <a
+                                       href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2 web
+                                               application</a>. This allows Jalview users to easily access the EnCore
+                                       network of databases and analysis services developed by members of
+                                       <a href="http://www.enfin.org">ENFIN</a></em>.</li>
+                       </ul>
+                       <p>Selecting items from the following submenus will start a
+                               remote service on compute facilities at the University of Dundee, or
+                               elsewhere. You need a continuous network connection in order to use
+                               these services through Jalview.
+                       </p>
+                       <ul>
+                               <li><strong>Alignment</strong><br /><em> Align the currently
+                                       selected sequences or all sequences in the alignment, or re-align
+                                       unaligned sequences to the aligned sequences. Entries in this menu
+                                       provide access to the various alignment programs supported by <a
+                                       href="../webServices/JABAWS.html">JABAWS</a>. See the <a
+                                       href="../webServices/msaclient.html">Multiple Sequence
+                                               Alignment webservice client</a> entry for more information.</em></li>
+                               <li><strong>Secondary Structure Prediction</strong>
+                                       <ul>
+                                               <li><strong>JPred Secondary Structure Prediction</strong><br>
+                                                       <em>Secondary structure prediction by network consensus. See
+                                                               the <a href="../webServices/jnet.html">Jpred3</a> client entry for
+                                                               more information. The behaviour of this calculation depends on
+                                                               the current selection:
+                                                               <ul>
+                                                                       <li>If nothing is selected, and the displayed sequences
+                                                                               appear to be aligned, then a JNet prediction will be run for
+                                                                               the first sequence in the alignment, using the current
+                                                                               alignment. Otherwise the first sequence will be submitted for
+                                                                               prediction.</li>
+                                                                       <li>If just one sequence (or a region on one sequence) has
+                                                                               been selected, it will be submitted to the automatic JNet
+                                                                               prediction server for homolog detection and prediction.</li>
+                                                                       <li>If a set of sequences are selected, and they appear to
+                                                                               be aligned, then the alignment will be used for a Jnet
+                                                                               prediction on the <strong>first</strong> sequence in the set
+                                                                               (that is, the one that appears first in the alignment window).
+                                                                       </li>
+                                                               </ul> </em>
+                                       </ul></li>
+                               <li><strong>Analysis</strong><br />
+                                       <ul>
+                                               <li><strong>Sequence Harmony Multi-Relief</strong><br> <em>Performs
+                                                               functional residue analysis on a protein family alignment with
+                                                               sub-families defined on it. See the <a
+                                                               href="../webServices/shmr.html">SHMR client</a> entry for more
+                                                               information.</em>
+                                               </li>
+                                       </ul></li>
+       </ul>
 </body>
 </html>
index 92cc453..19ff3e7 100755 (executable)
                <div align="center"><em><strong>Issues Resolved</strong></em></div>
                </td>
        </tr>
-       <tr>
-           <td>
-               <div align="center"><strong><a name="Jalview2.6.1">2.6.1</a></strong><br>
-               <em>15/11/2010</em></div>
-               </td>
-               <td><em>Application</em>
-               <ul>
-       <li>New warning dialog when the Jalview Desktop cannot contact web services</li>
-    <li>JABA service parameters for a preset are shown in service job window</li>
-    <li>JABA Service menu entries reworded</li>
-</ul>
-               </td>
-               <td>
-               <ul>
-                   <li>Modeller PIR IO broken - cannot correctly import a pir file emitted by jalview</li>
-<li>Existing feature settings transferred to new alignment view created from cut'n'paste</li>
-<li>Improved test for mixed amino/nucleotide chains when parsing PDB files</li>
-<li>Consensus and conservation annotation rows occasionally become blank for all new windows</li>
-<li>Exception raised when right clicking above sequences in wrapped view mode</li>
-               </ul>
-               <em>Application</em>
-               <ul>
-       <li>multiple multiply aligned structure views cause cpu usage to hit 100% and computer to hang</li>
-    <li>Web Service parameter layout breaks for long user parameter names</li>
-    <li>Jaba service discovery hangs desktop if Jaba server is down</li>
-    </ul>
-       </td>
-       </tr>
-       <tr>
+               <tr>
+                       <td>
+                               <div align="center">
+                                       <strong><a name="Jalview2.7">2.7</a>
+                                       </strong><br> <em>20/09/2011</em>
+                               </div></td>
+                       <td><em>Application</em>
+                               <ul>
+                                       <li>tweaked default layout of web services menu</li>
+                                       <li>view/alignment association menu to enable user to easily
+                                               specify which alignment a multi-structure view takes its
+                                               colours/correspondences from</li>
+                                       <li>allow properties file location to be specified as URL </li>
+                                               <li>extend jalview project to preserve associations between
+                                                       many alignment views and a single Jmol display</li>
+                                               <li>Store annotation row height in jalview project file</li>
+                                               <li>annotation row column label formatting attributes stored
+                                                       in project file</li>
+                                               <li>annotation row order for auto-calculated annotation rows
+                                                       preserved in jalview project file</li>
+                                               <li>visual progress indication when Jalview state is saved
+                                                       using Desktop window menu</li>
+                                               <li>visual indication that command line arguments are still
+                                                       being processed</li>
+                                               <li>groovy script execution from URL</li>
+                                               <li>colour by annotation default min and max colours in
+                                                       preferences</li>
+                                               <li>automatically associate PDB files dragged onto an
+                                                       alignment with sequences that have high similarity and matching
+                                                       IDs</li>
+                                               <li>update JGoogleAnalytics to latest release (0.3)</li>
+                                               <li>&#39;view structures&#39; option to open many structures
+                                                       in same window</li>
+                                               <li>Sort associated views menu option for tree panel</li>
+                                               <li>group all JABA and non-JABA services for a particular
+                                                       analysis function in its own submenu</li>
+                               </ul> <em>Applet</em>
+                       <ul>
+                                       <li>userdefined and autogenerated annotation rows for groups</li>
+                                       <li>adjustment of alignment annotation pane height</li>
+                                       <li>annotation scrollbar for annotation panel</li>
+                                       <li>drag to reorder annotation rows in annotation panel</li>
+                                       <li>&#39;automaticScrolling&#39; parameter</li>
+                                       <li>allow sequences with partial ID string matches to be
+                                               annotated from GFF/jalview features files</li>
+                                       <li>sequence logo annotation row in applet</li>
+                                       <li>Absolute paths relative to host server in applet
+                                               parameters are treated as such</li>
+                                       <li>New in the JalviewLite javascript API:
+                                               <ul>
+                                                       <li>jalviewLite.js javascript library</li>
+                                                       <li>Javascript callbacks for
+                                                               <ul>
+                                                                       <li>applet initialisation</li>
+                                                                       <li>sequence/alignment mouse-overs and selections</li>
+                                                               </ul>
+                                                       </li>
+                                                       <li>scrollTo row and column alignment scrolling functions</li>
+                                                       <li>select sequence/alignment regions from javascript</li>
+                                                       <li>javascript structure viewer harness to pass messages
+                                                               between Jmol and Jalview when running as distinct applets</li>
+                                                       <li>sortBy method</li>
+                                                       <li>set of applet and application examples shipped with
+                                                               documentation</li>
+                                                       <li>new example to demonstrate jalviewLite and Jmol
+                                                               javascript message exchange</li>
+                                               </ul>
+                               </ul> <em>General</em>
+                               <ul>
+                                       <li>enable Jmol displays to be associated with multiple
+                                               multiple alignments</li>
+                                       <li>Option to automatically sort alignment with new tree</li>
+                                       <li>user configurable link to enable redirects to a
+                                               www.jalview.org mirror</li>
+                                       <li>Jmol colours option for Jmol displays</li>
+                                       <li>configurable newline string when writing alignment and
+                                               other flat files</li>
+                                       <li>Allow alignment annotation description lines to contain
+                                               html tags</li>
+                               </ul> <em>Documentation and Development</em>
+                               <ul>
+                                       <li>add groovy test harness for bulk load testing to examples
+                                       </li>
+                                       <li>groovy script to load and align a set of sequences using a
+                                               web service before displaying the result in the Jalview desktop</li>
+                                       <li>restructured javascript and applet api documentation</li>
+                                       <li>ant target to publish example html files with applet archive</li>
+                                       <li>netbeans project for building jalview from source</li>
+                                       <li>ant task to create online javadoc for jalview source</li>
+                               </ul></td>
+                       <td><em>Application</em>
+                               <ul>
+                                       <li>user defined colourscheme throws exception when current
+                                               built in colourscheme is saved as new scheme</li>
+                                       <li>AlignFrame-&gt;Save in application pops up save dialog for
+                                               valid filename/format</li>
+                                       <li>cannot view associated structure for uniprot sequence</li>
+                                       <li>pdb file association breaks for Uniprot sequence P37173</li>
+                                       <li>associate PDB from file dialog does not tell you which
+                                               sequence is to be associated with the file</li>
+                                       <li>find All raises null pointer exception when query only
+                                               matches sequence IDs</li>
+                                       <li>pre 2.6 jalview project cannot be loaded into v2.6</li>
+                                       <li>Jalview project with Jmol views created with Jalview 2.4
+                                               cannot be loaded</li>
+                                       <li>filetype associations not installed for webstart launch</li>
+                                       <li>two or more chains in a single PDB file associated with
+                                               sequences in different alignments do not get coloured by their
+                                               associated sequence</li>
+                                       <li>visibility status of autocalculated annotation row not
+                                               preserved when project is loaded</li>
+                                       <li>tree bootstraps are not preserved when saved as a jalview
+                                               project</li>
+                                       <li>envision2 workflow tooltips are corrupted</li>
+                                       <li>enabling show group conservation also enables colour by
+                                               conservation</li>
+                                       <li>duplicate group associated conservation or consensus
+                                               created on new view</li>
+                                       <li>annotation scrollbar not displayed after &#39;show all
+                                               hidden annotation rows&#39; option selected</li>
+                                       <li>alignment quality not updated after alignment annotation
+                                               row is hidden then shown</li>
+                                       <li>preserve colouring of structures coloured by sequences in pre
+                                               jalview 2.7 projects</li>
+                                       <li>Web service job parameter dialog is not laid out properly
+                                       </li>
+                                       <li>web services menu not refreshed after &#39;reset
+                                               services&#39; button is pressed in preferences</li>
+                                       <li>annotation off by one in jalview v2_3 example project</li>
+                                       <li>structures imported from file and saved in project get
+                                               name like jalview_pdb1234.txt when reloaded</li>
+                                       <li>Jalview does not always retrieve progress of a JABAWS job
+                                               execution in full once it is complete</li>
+                               </ul> <em>Applet</em>
+                               <ul>
+                                       <li>alignment height set incorrectly when lots of annotation
+                                               rows are displayed</li>
+                                       <li>relative URLs in feature HTML text not resolved to
+                                               codebase</li>
+                                       <li>view follows highlighting does not work for positions in
+                                               sequences</li>
+                                       <li>&lt;= shown as = in tooltip</li>
+                                       <li>export features raises exception when no features exist</li>
+                                       <li>separator string used for serialising lists of ids for
+                                               javascript api is modified when separator string provided as
+                                               parameter</li>
+                                       <li>null pointer exception when selecting tree leaves for
+                                               alignment with no existing selection</li>
+                                       <li>relative URLs for datasources assumed to be relative to
+                                               applet&#39;s codebase</li>
+                                       <li>status bar not updated after finished searching and search
+                                               wraps around to first result</li>
+                                       <li>StructureSelectionManager instance shared between several
+                                               jalview applets causes race conditions and memory leaks</li>
+                                       <li>hover tooltip and mouseover of position on structure not
+                                               sent from Jmol in applet</li>
+                                       <li>certain sequences of javascript method calls to applet API
+                                               fatally hang browser</li>
+                               </ul> <em>General</em>
+                               <ul>
+                                       <li>view follows structure mouseover scrolls beyond position
+                                               with wrapped view and hidden regions</li>
+                                       <li>Find sequence position moves to wrong residue with/without
+                                               hidden columns</li>
+                                       <li>Sequence length given in alignment properties window is
+                                               off by 1</li>
+                                       <li>InvalidNumberFormat exceptions thrown when trying to
+                                               import PDB like structure files</li>
+                                       <li>positional search results are only highlighted between
+                                               user-supplied sequence start/end bounds</li>
+                                       <li>end attribute of sequence is not validated</li>
+                                       <li>Find dialog only finds first sequence containing a given
+                                               sequence position</li>
+                                       <li>sequence numbering not preserved in MSF alignment output</li>
+                                       <li>Jalview PDB file reader does not extract sequence from
+                                               nucleotide chains correctly</li>
+                                       <li>annotation row height and visibility attributes not stored
+                                               in jalview project</li>
+                                       <li>structure colours not updated when tree partition changed
+                                               in alignment</li>
+                                       <li>sequence associated secondary structure not correctly
+                                               parsed in interleaved stockholm</li>
+                                       <li>colour by annotation dialog does not restore current state
+                                       </li>
+                                       <li>Hiding (nearly) all sequences doesn&#39;t work properly</li>
+                                       <li>sequences containing lowercase letters are not properly
+                                               associated with their pdb files</li>
+                               </ul> <em>Documentation and Development</em>
+                               <ul>
+                                       <li>schemas/JalviewWsParamSet.xsd corrupted by ApplyCopyright
+                                               tool</li>
+                               </ul></td>
+               </tr>
+               <tr>
+                       <td>
+                               <div align="center">
+                                       <strong><a name="Jalview2.6.1">2.6.1</a>
+                                       </strong><br> <em>15/11/2010</em>
+                               </div></td>
+                       <td><em>Application</em>
+                               <ul>
+                                       <li>New warning dialog when the Jalview Desktop cannot contact
+                                               web services</li>
+                                       <li>JABA service parameters for a preset are shown in service
+                                               job window</li>
+                                       <li>JABA Service menu entries reworded</li>
+                               </ul></td>
+                       <td>
+                               <ul>
+                                       <li>Modeller PIR IO broken - cannot correctly import a pir
+                                               file emitted by jalview</li>
+                                       <li>Existing feature settings transferred to new alignment
+                                               view created from cut'n'paste</li>
+                                       <li>Improved test for mixed amino/nucleotide chains when
+                                               parsing PDB files</li>
+                                       <li>Consensus and conservation annotation rows occasionally
+                                               become blank for all new windows</li>
+                                       <li>Exception raised when right clicking above sequences in
+                                               wrapped view mode</li>
+                               </ul> <em>Application</em>
+                               <ul>
+                                       <li>multiple multiply aligned structure views cause cpu usage
+                                               to hit 100% and computer to hang</li>
+                                       <li>Web Service parameter layout breaks for long user
+                                               parameter names</li>
+                                       <li>Jaba service discovery hangs desktop if Jaba server is
+                                               down</li>
+                               </ul></td>
+               </tr>
+               <tr>
                <td>
                <div align="center"><strong><a name="Jalview2.6">2.6</a></strong><br>
                <em>26/9/2010</em></div>
diff --git a/help/html/webServices/clustalw.html b/help/html/webServices/clustalw.html
deleted file mode 100755 (executable)
index 81ccc4e..0000000
+++ /dev/null
@@ -1,46 +0,0 @@
-<html>
-<!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6.1)
- * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
- * 
- * 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/>.
--->
-<head><title>ClustalW Alignment</title></head>
-<body>
-<p><strong>ClustalW Alignments</strong></p>
-<p>ClustalW is a program for multiple sequence alignment. It works
-with both DNA and protein sequences, and can also perform profile
-profile alignments to align two or more multiple sequence
-alignments.</p>
-<p>
-Thompson, J.D., Higgins, D.G. and Gibson, T.J. (1994) <br>
-CLUSTAL W: improving the sensitivity of progressive multiple
-sequence alignment through sequence weighting, position specific gap
-penalties and weight matrix choice.<br>
-<em>Nucleic Acids Research</em> <strong>22</strong> 4673-4680
-</p>
-<p>There are two versions of this alignment function, which will operate
-on the selected region, if any, or the whole sequence set:</p>
-<ul>
-  <li><strong>Web Service&#8594;Alignment&#8594;ClustalW Multiple Sequence Alignment</strong><br>
-    Aligns using the clustalW program, ignoring any gaps in the submitted sequence 
-    set. </li>
-  <li><strong>Web Service&#8594;Alignment&#8594;ClustalW Mulitple Sequence Alignment 
-    Realign </strong><br>
-    Submits the sequences with existing gaps to clustalW, which will preserve 
-    existing gaps and re-align those regions which are not optimal. </li>
-</ul>
-<em>As of Jalview 2.6, alignment services accessed via the 'Alignment' submenu should be considered legacy Jalview SOAP services.</em>
-</body>
-</html>
index 939db64..82a1902 100755 (executable)
 <title>Web Services</title>
 </head>
 <body>
-<p><strong>Web services</strong></p>
+       <p>
+               <strong>Web services</strong>
+       </p>
 
-<p>Jalview includes clients for a variety of web services for both
-bioinformatic data retrieval and analysis.
-<ul>
-       <li>The <a href="../features/seqfetch.html">Sequence Fetcher</a>
-       utilises web services for sequence, alignment and structure retrieval
-       provided by the European Bioinformatics Institute (EBI) and Distributed
-       Annotation System servers that are capable of serving sequences.</li>
-       <li>The <a href="../features/dasfeatures.html">DAS Feature
-       Fetcher</a> enables the retrieval and visualization of features from DAS
-       annotation sources</li>
-       <li>The <a href="dbreffetcher.html">Database Reference Fetcher</a>
-       transfers database references from records available from DAS or the
-       public sequence databases.</li>
-       <li>The <strong>Web Services</strong> menu in each alignment
-       window also provides access to the following:
+       <p>Jalview includes clients for a variety of web services for both
+               bioinformatic data retrieval and analysis.
        <ul>
-               <li>Jalview SOAP Web Services for sequence alignment and
-               secondary structure prediction based at the University of Dundee.</li>
-               <li>Services for submitting IDs and sequences to external
-               bioinformatics services such as <a href="#envision2">Envision2</a>.</li>
-               <li>Programs for multiple sequence alignment, made available <em>via</em>
-               <a href="JABAWS.html">Java Bioinformatic Analysis Web Service
-               (JABAWS)</a> servers.</li>
+               <li>The <a href="../features/seqfetch.html">Sequence Fetcher</a>
+                       utilises web services for sequence, alignment and structure retrieval
+                       provided by the European Bioinformatics Institute (EBI) and
+                       Distributed Annotation System servers that are capable of serving
+                       sequences.</li>
+               <li>The <a href="../features/dasfeatures.html">DAS Feature
+                               Fetcher</a> enables the retrieval and visualization of features from DAS
+                       annotation sources</li>
+               <li>The <a href="dbreffetcher.html">Database Reference
+                               Fetcher</a> transfers database references from records available from
+                       DAS or the public sequence databases.</li>
+               <li>The <strong>Web Services</strong> menu in each alignment
+                       window also provides access to the following:
+                       <ul>
+                               <li>Programs for <a href="msaclient.html">multiple sequence
+                                               alignment</a>, made available <em>via</em> <a href="JABAWS.html">Java
+                                               Bioinformatic Analysis Web Service (JABAWS)</a> servers.</li>
+                               <li>Jalview SOAP Web Services for <a href="jnet.html">secondary
+                                               structure prediction</a> based at the University of Dundee.</li>
+                               <li>Services for alignment analysis, such as <a
+                                       href="shmr.html">Sequence Harmony Multi Relief</a>.
+                               <li>Services for submitting IDs and sequences to external
+                                       bioinformatics services such as Envision2 (see <a href="#envision2">below</a>).</li>
+                       </ul>
+                       <p>
+                               <strong>Web Service Dialog Box</strong>
+                       </p> <img src="clwqueued.gif">
+                       <p>This dialog box is displayed when a web service job is
+                               submitted. It gives the name of the service and any method citation
+                               information, and monitors the progress of the calculation. The
+                               cancel button will permanently cancel the job, but this is only
+                               possible for some services.</p> The <a href="webServicesPrefs.html">Web
+                               Services Preference panel</a> controls the display and appearance of the
+                       submission and analysis services in the <strong>Web Services</strong>
+                       menu.</li>
+               <li>If Jalview encounters problems accessing any services, it may
+                       display a <a href="webServicesPrefs.html#wswarnings">warning
+                               dialog box</a> (this can be turned off using the web services
+                       preferences tab).</li>
        </ul>
-       The <a href="webServicesPrefs.html">Web Services Preference panel</a>
-       controls the display and appearance of the submission and analysis
-       services in the <strong>Web Services</strong> menu.</li>
-       <li>If Jalview encounters problems accessing any services, it may
-       display a <a href="webServicesPrefs.html#wswarnings">warning dialog
-       box</a> (this can be turned off using the web services preferences tab).</li>
-</ul>
-</p>
-<p><strong>More about Jalview's Web Services</strong> <br>
-Jalview's distributed computations are SOAP based services exposing
-protein sequence alignment and secondary structure prediction programs.
-These services actually run on the cluster based in the School of Life
-Sciences, University of Dundee, and are maintained by the Barton group.</p>
-<p><strong><a name="envision2">Envision2 Services</a></strong></p>
-<p>Since version 2.5, Jalview has included a client to enable the
-user to submit one or more sequences or sequence IDs to analysis
-workflows provided by the <a
-       href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2 web
-application</a>. This allows Jalview users to easily access the EnCore
-network of databases and analysis services developed by ENFIN (<a
-       href="http://www.enfin.org">www.enfin.org</a>).</p>
-<br />
-<p><strong>Web Service Dialog Box</strong></p>
-<img src="clwqueued.gif">
-<p>This dialog box is displayed when a web service job is submitted.
-It gives the name of the service and any method citation information,
-and monitors the progress of the calculation. The cancel button will
-permanently cancel the job, but this is only possible for some services.
-</p>
-<p>Current services:
-<ul>
-       <a href="msaclient.html"><strong>Multiple Sequence
-       Alignment Services</strong></a>
-       <ul>
-               <li><a href="clustalw.html">ClustalW Multiple Alignment and
-               re-alignment</a><br>
-               The clustal W service remains one of the more popular Jalview
-               features.</li>
-               <li><a href="muscle.html">Muscle Multiple Alignment</a><br>
-               High Quality and High Throughput multiple alignments of proteins. This
-               method can sometimes be more accurate than ClustalW when dealing with
-               diverse sets of sequences.</li>
-               <li><a href="mafft.html">MAFFT</a><br>
-               Multiple Alignment with Fast Fourier Transforms - a highly accurate
-               and high throughput dna and amino acid alignment method, performing at
-               least as well as ClustalW and Muscle.</li>
-               <li>Other alignment methods are also available via <a
-                       href="JABAWS.html">JABAWS</a>. For more information about a
-               particular service, see the documentation available via the <a
-                       href="webServicesParams.html">web services parameter dialog box</a>.</li>
-       </ul>
-       </li>
-       <li><strong>Secondary Structure Prediction</strong>
-       <ul>
-               <li><a href="jnet.html">JNet</a><br>
-               This is a front end to the <a
-                       href="http://www.compbio.dundee.ac.uk/www-jpred/">JNet www server</a>
-               allowing single sequence or profile based prediction.</li>
-       </ul>
-       </li>
-</ul>
-</p>
-
+       </p>
+       <p>
+               <strong>More about Jalview's Web Services</strong> <br> Jalview's
+               distributed computations utilise <a
+                       href="http://en.wikipedia.org/wiki/SOAP">SOAP</a> and <a
+                       href="http://en.wikipedia.org/wiki/Representational_State_Transfer">REST</a>
+               web services exposing sequence alignment, analysis, and secondary
+               structure prediction programs. Originally, Jalview 2's services were
+               maintained by the Barton group at the University of Dundee, and ran
+               programs on the Life Sciences High-performace Computing Cluster. With
+               the advent of <a href="http://www.compbio.dundee.ac.uk/JABAWS">JABAWS</a>,
+               however, it is possible for anyone to host Jalview web services.
+       </p>
+       <p>
+               <strong><a name="envision2">Envision2 Services</a>
+               </strong>
+       </p>
+       <p>
+               Since version 2.5, Jalview has included a client to enable the user to
+               submit one or more sequences or sequence IDs to analysis workflows
+               provided by the <a href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2
+                       web application</a>. This allows Jalview users to easily access the
+               EnCore network of databases and analysis services developed by ENFIN (<a
+                       href="http://www.enfin.org">www.enfin.org</a>).
+       </p>
 </body>
 </html>
diff --git a/help/html/webServices/mafft.html b/help/html/webServices/mafft.html
deleted file mode 100644 (file)
index 052e565..0000000
+++ /dev/null
@@ -1,36 +0,0 @@
-<html>
-<!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6.1)
- * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
- * 
- * 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/>.
--->
-<head><title>MAFFT Multiple Sequence Alignments</title></head>
-<body>
-<p><strong>MAFFT Multiple Sequence Alignments</strong></p>
-<p> Katoh, K., K. Kuma, K., Toh, H., and Miyata, T. (2005) &quot;MAFFT version 
-  5: improvement in accuracy of multiple sequence alignment.&quot; Nucleic Acids 
-  Research, 33 511-518</p>
-<p>MAFFT is a program for the multiple alignment of nucleic acid or protein
-sequences, and is available from the <strong>Web
-Service&#8594;Alignment&#8594;MAFFT Multiple Sequence
-Alignment</strong> entry in the web services menu.</p>
-<p>MAFFT utilizes algorithms for spectral correlation to identify
-homologous regions in a fast-fourier transform representation of each
-sequence. The Jalview web service runs MAFFT using the
-'--auto' option which picks optimal parameters
-for the set of sequences to be aligned.</p>
-<em>As of Jalview 2.6, alignment services accessed via the 'Alignment' submenu should be considered legacy Jalview SOAP services.</em>
-</body>
-</html>
index 0d413fc..de12faa 100644 (file)
 </head>
 <body>
 <strong>Multiple Sequence Alignment Web Services</strong>
-<p>Multiple sequence alignment services can be accessed from either
-the <strong>Alignment</strong> or the <strong>JABAWS Alignment</strong>
-submenu of the Alignment Window's <strong>Web Service</strong> menu.
-When an entry from one of these menus is selected, either the currently
-selected residues, or the whole sequence set (if there is no selection
-or only one sequence is selected) will be submitted for multiple
-sequence alignment.</p>
-<p>There are two kinds of multiple sequence alignment operations
+       <p>
+               Multiple sequence alignment services are accessed from the <strong>Alignment</strong>
+               submenu of the Alignment Window's <strong>Web Service</strong> menu.
+               When an entry from one of these menus is selected, either the
+               currently selected residues, or the whole sequence set (if there is no
+               selection or only one sequence is selected) will be submitted for
+               multiple sequence alignment.
+       </p>
+       <p>There are two kinds of multiple sequence alignment operations
 available:
 <ul>
        <li><em>alignment</em> - where a new alignment is constructed from
@@ -37,9 +38,24 @@ available:
        used by the service to construct a profile based alignment of the
        remaining unaligned sequences.</li>
 </ul>
-The <a href="JABAWS.html">JABAWS Alignment services</a> also offer a
-range of predefined alignment settings and the opportunity for you to
-define your own set of parameters for running the alingment program.</p>
+       <strong>JABAWS Alignment services</strong><br> Most alignment services are
+       provided by the
+       <a href="JABAWS.html">JABAWS framework</a>, which allows you to
+       customise the precise parameters used when running each alignment
+       prgoram. In addition to the 'Default settings', you may choose from a
+       range of alignment preset settings, or create your own using the
+       <a href="webServicesParams.html">'Edit Settings And Run ..' dialog
+               box</a>.
+       </p>
+       <p><strong>Alignment programs supported by JABAWS</strong><ul>
+       <li><a href="http://www.clustal.org/">ClustalW</a> (version 2.0.12)</li>
+  <li><a href="http://align.bmr.kyushu-u.ac.jp/mafft/software/">Mafft</a> (version 6.713)</li>
+  <li><a href="http://www.drive5.com/muscle">Muscle</a> (version 3.7) </li>
+  <li><a href="http://www.tcoffee.org/Projects_home_page/t_coffee_home_page.html">Tcoffee</a> (version 8.14) </li>
+  <li><a href="http://probcons.stanford.edu/">Probcons</a> (version 1.12)</li>
+  </ul>
+</p>
+
 <p><strong>Multiple Alignments of Sequences with hidden
 columns</strong><br>
 Multiple alignment services are 'column separable' analysis operations.
diff --git a/help/html/webServices/muscle.html b/help/html/webServices/muscle.html
deleted file mode 100755 (executable)
index 1a3de9f..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-<html>
-<!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6.1)
- * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
- * 
- * 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/>.
--->
-<head><title>Muscle Alignment</title></head>
-<body>
-<p><strong>Muscle Alignments</strong></p>
-<p>Muscle is a program for the alignment of many protein sequences.</p>
-<p>
-Edgar, Robert C. (2004), MUSCLE: multiple sequence alignment with high
-accuracy and high throughput<br>
-<em>Nucleic Acids Research</em> <strong>32</strong>(5), 1792-97.</p>
-<p> This alignment method is applied to the selected region, if any, or the whole 
-  sequence set when the <strong>Web Service&#8594;Alignment&#8594;Muscle 
-  Protein Sequence Alignment</strong> menu item is selected. </p>
-<em>As of Jalview 2.6, alignment services accessed via the 'Alignment' submenu should be considered legacy Jalview SOAP services.</em>
-</body>
-</html>
diff --git a/help/html/webServices/shmr.html b/help/html/webServices/shmr.html
new file mode 100755 (executable)
index 0000000..4051ac5
--- /dev/null
@@ -0,0 +1,65 @@
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6.1)
+ * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
+ * 
+ * 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/>.
+-->
+<head>
+<title>Multi-Group Sequence Harmony and Multi-Relief</title>
+</head>
+<body>
+       <strong>Functional residue analysis with Sequence Harmony and
+               Multi-Relief</strong>
+       <p>
+               The Sequence Harmony and Multi-Relief (SHMR) service (<a
+                       href="#shmrref">Brandt, Feenstra and Heringa, 2010</a>) available
+               from the <em>Analysis</em> sub-menu of the alignment window's web
+               services menu provides a method for the identification of significant
+               patterns of <em>sub-family variation</em> amongst the columns of an
+               alignment.
+       </p>
+       <p>
+               <strong>Instructions for use</strong><br> The service requires a
+               protein sequence multiple alignment that has been sub-divided into
+               groups containing at least two non-identical protein sequences. An
+               easy way to create groups is to use the built-in <a
+                       href="../calculations/tree.html">neighbour-joining or UPGMA tree</a>
+               routines to calculate a tree for the alignment, and then click on the
+               tree to subdivide the alignment.
+       </p>
+       <p>
+               The SHMR service operates on the currently selected visible region(s)
+               of the alignment. Once submitted, a job progress window will display
+               status information about your job, including a URL which allows you to
+               visit the status page on the
+               <a href="http://www.ibi.vu.nl/programs/shmrwww/">IBIVU SHMR server</a>.
+       </p>
+       <p>When the job is complete, Jalview will automatically open a new
+               window containing the alignment and groups that were submitted for
+               analysis, with additional histograms added portraying the SHMR scores
+               for each column of the sub-grouped alignment.</p>
+       <p>
+               If you use this service in your work, please cite :<br /><a name="shmrref"/> Brandt,
+               B.W.*, Feenstra, K.A*. and Heringa, J. (2010) Multi-Harmony: detecting
+               functional specificity from sequence alignment. <a
+                       href="http://nar.oxfordjournals.org/cgi/content/abstract/gkq415">Nucleic
+                       Acids Res. 38: W35-W40.</a> (<em>* joint first authors</em>)
+       <p>
+       <strong><em>Note:</em></strong> The SHMR service is implemented with Jalview's RESTful
+               web service client, first introduced in Jalview 2.7.
+       </ul>
+       </p>
+</body>
+</html>