2.5 release doc
authorjprocter <Jim Procter>
Thu, 29 Apr 2010 15:03:44 +0000 (15:03 +0000)
committerjprocter <Jim Procter>
Thu, 29 Apr 2010 15:03:44 +0000 (15:03 +0000)
help/html/features/search.html
help/html/menus/alignmentMenu.html
help/html/menus/alwcalculate.html
help/html/menus/alwformat.html
help/html/menus/alwview.html
help/html/menus/desktopMenu.html
help/html/menus/wsmenu.html
help/html/releases.html
help/html/vamsas/index.html

index 3d60858..037c938 100755 (executable)
-<html>\r
-<head><title>Search</title>\r
-<style type="text/css">\r
-<!--\r
-td {\r
-       text-align: center;\r
-}\r
--->\r
-</style>\r
-</head>\r
-\r
-<body>\r
-<p><strong>Search</strong></p>\r
-<p>The search box is displayed by pressing Control and F or\r
-  selecting &quot;Find...&quot; from the &quot;Search&quot; menu.</p>\r
-<img src="search.gif" width="339" height="110">\r
-<p>&quot;Find next&quot; will find the next occurence of the specified and adjust \r
-  the alignment window view to show it, and &quot;Find all&quot; highlights all \r
-  matches for a pattern. The &quot;New Feature&quot; is a quick way to highlight \r
-  and group residues matching the specified search pattern throughout the alignment. \r
-<ul>\r
-  <li>The search uses regular expressions. (understands a mixture of posix and \r
-    perl style regex - see below for a summary)</li>\r
-  <li>Gaps are ignored when matching the query to the sequences in the alignment.</li>\r
-  <li>The search is applied to both sequences and their IDs but the &quot;Find \r
-    next&quot; and &quot;Find all&quot; buttons only count the sequence matches.</li>\r
-  <li>If a region is selected, then search will <strong>only</strong> be performed \r
-    on that region. </li>\r
-  <li>To quickly clear the current selection, press the &quot;Escape&quot; key.</li>\r
-  <li>Tick the &quot;Match Case&quot; box to perform a case sensitive search.</li>\r
-</ul>\r
-<p><strong>Creating Features from Search Results</strong></p>\r
-<p>\r
-  If &quot;New Feature&quot; is selected, the feature can be given a name from \r
-  a popup input box. Use the &quot;Feature Settings&quot; under the &quot;View&quot; \r
-  menu to change the visibility and colour of the new sequence feature.</p> \r
-<p><strong>A quick Regular Expression Guide</strong></p>\r
-<p>A regular expression is not just a simple text query - although it\r
-can be used like one, the query is not parsed literally, but\r
-interpreted like a series of instructions defining the features of the\r
-match. For example, a simple query like &quot;ACDED&quot; would\r
-match all occurences of that string, but &quot;ACD+ED&quot; matches\r
-both 'ACDDED' and 'ACDDDDDDDDED'. More usefully, the query\r
-&quot;[ILGVMA]{;5,}&quot; would find stretches of small,\r
-hydrophobic amino acids of at least five residues in length.\r
-</p>\r
-<p> The table\r
-below describes some of the regular expression syntax:<br></p>\r
-<table width="100%" border="1">\r
-  <tr>\r
-    <td width="24%">Regular Expression Element</td>\r
-    <td width="76%">Effect</td>\r
-  </tr>\r
-  <tr>\r
-    <td width="24%">.</td>\r
-    <td width="76%">Matches any single character</td>\r
-  </tr>\r
-  <tr>\r
-    <td>[]</td>\r
-    <td>Matches any one of the characters in the brackets</td>\r
-  </tr>\r
-  <tr>\r
-    <td>^</td>\r
-    <td>Matches at the start of an ID or sequence</td>\r
-  </tr>\r
-  <tr>\r
-    <td>$</td>\r
-    <td>Matches at the end of an ID or sequence</td>\r
-  </tr>\r
-  <tr>\r
-    <td>*</td>\r
-    <td>Matches if the preceding element matches zero or more times</td>\r
-  </tr>\r
-  <tr>\r
-    <td>?</td>\r
-    <td>Matches if the preceding element matched once or not at all</td>\r
-  </tr>\r
-  <tr>\r
-    <td>+</td>\r
-    <td>Matches if the preceding element matched at least once</td>\r
-  </tr>\r
-  <tr>\r
-    <td>{count}</td>\r
-    <td>Matches if the preceding element matches a specified number of\r
-    times\r
-    </td>\r
-  </tr>\r
-  <tr>\r
-    <td>{min,}</td>\r
-    <td> Matches of the preceding element matched at least the\r
-    specified number of times</td>\r
-  </tr>\r
-  <tr>\r
-    <td>{min,max} </td>\r
-    <td>Matches if the preceding element matches min or at most max\r
-    number of times</td>\r
-  </tr>\r
-</table>\r
-</body>\r
-</html>\r
+<html>
+<head><title>Search</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
+</style>
+</head>
+
+<body>
+<p><strong>Search</strong></p>
+<p>The search box is displayed by pressing Control and F or
+  selecting &quot;Find...&quot; from the &quot;Search&quot; menu.</p>
+<img src="search.gif" width="339" height="110">
+<p>&quot;Find next&quot; will find the next occurence of the specified and adjust 
+  the alignment window view to show it, and &quot;Find all&quot; highlights all 
+  matches for a pattern. The &quot;New Feature&quot; is a quick way to highlight 
+  and group residues matching the specified search pattern throughout the alignment. 
+<ul>
+  <li>The search uses regular expressions. (understands a mixture of posix and 
+    perl style regex - see below for a summary)</li>
+  <li>Gaps are ignored when matching the query to the sequences in the alignment.</li>
+  <li>The search is applied to both sequences and their IDs.</li>
+  <li>If a region is selected, then search will <strong>only</strong> be performed 
+    on that region. </li>
+  <li>To quickly clear the current selection, press the &quot;Escape&quot; key.</li>
+  <li>Tick the &quot;Match Case&quot; box to perform a case sensitive search.</li>
+</ul>
+<p><strong>Creating Features from Search Results</strong></p>
+<p>
+  If &quot;New Feature&quot; is selected, the feature can be given a name from 
+  a popup input box. Use the &quot;Feature Settings&quot; under the &quot;View&quot; 
+  menu to change the visibility and colour of the new sequence feature.</p> 
+<p><strong>A quick Regular Expression Guide</strong></p>
+<p>A regular expression is not just a simple text query - although it
+can be used like one, the query is not parsed literally, but
+interpreted like a series of instructions defining the features of the
+match. For example, a simple query like &quot;ACDED&quot; would
+match all occurences of that string, but &quot;ACD+ED&quot; matches
+both 'ACDDED' and 'ACDDDDDDDDED'. More usefully, the query
+&quot;[ILGVMA]{;5,}&quot; would find stretches of small,
+hydrophobic amino acids of at least five residues in length.
+</p>
+<p> The table
+below describes some of the regular expression syntax:<br></p>
+<table width="100%" border="1">
+  <tr>
+    <td width="24%">Regular Expression Element</td>
+    <td width="76%">Effect</td>
+  </tr>
+  <tr>
+    <td width="24%">.</td>
+    <td width="76%">Matches any single character</td>
+  </tr>
+  <tr>
+    <td>[]</td>
+    <td>Matches any one of the characters in the brackets</td>
+  </tr>
+  <tr>
+    <td>^</td>
+    <td>Matches at the start of an ID or sequence</td>
+  </tr>
+  <tr>
+    <td>$</td>
+    <td>Matches at the end of an ID or sequence</td>
+  </tr>
+  <tr>
+    <td>*</td>
+    <td>Matches if the preceding element matches zero or more times</td>
+  </tr>
+  <tr>
+    <td>?</td>
+    <td>Matches if the preceding element matched once or not at all</td>
+  </tr>
+  <tr>
+    <td>+</td>
+    <td>Matches if the preceding element matched at least once</td>
+  </tr>
+  <tr>
+    <td>{count}</td>
+    <td>Matches if the preceding element matches a specified number of
+    times
+    </td>
+  </tr>
+  <tr>
+    <td>{min,}</td>
+    <td> Matches of the preceding element matched at least the
+    specified number of times</td>
+  </tr>
+  <tr>
+    <td>{min,max} </td>
+    <td>Matches if the preceding element matches min or at most max
+    number of times</td>
+  </tr>
+</table>
+</body>
+</html>
index aceabce..b39bf25 100755 (executable)
                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>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>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 Sequence Features</strong><br>
+               <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>
     <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
                        <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>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 Group</strong><strong><br>
+                       <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>
index 700ce51..6284264 100755 (executable)
@@ -9,6 +9,9 @@
       <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. 
index 97cb88e..6e2f059 100644 (file)
     spaces. <br>
     You may set the default gap character in <a
                href="../features/preferences.html">preferences</a>.</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>
        <li><strong>Centre Column Labels<br>
     </strong><em>When this is selected, the text labels within each annotation row will be centred on the column that they are associated with.
     </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>
 </body>
 </html>
index 85ffe36..b34e692 100755 (executable)
@@ -25,7 +25,7 @@
     <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 settings will be applied to all autocalculated annotation.
+       When ticked, any modification to the current settings will be applied to all autocalculated annotation.
        </li> 
        <li>
        <strong>Show Consensus Histogram<br></strong>
index 40cfff8..89f510a 100755 (executable)
@@ -37,7 +37,7 @@
       </li>
        </ul>
        </li>
-       <li><strong>Tools </strong>
+       <li><strong>Tools</strong>
        <ul>
                <li><strong><a href="../features/preferences.html">Preferences<br>
                </a></strong><em>Change the default visual settings for opening new alignment
                <li><strong>Collect Garbage<br></strong>
                <em>Selecting this will initiate the Java Virtual Machine garbage collector, which might help free up some memory... perhaps.
                </em></li>
+               <li><strong>Java Console<br/></strong>
+               <em>Toggles the display of a the Jalview Java Console window. This setting will be remembered in your user preferences.</em></li>
                <li><strong>Groovy Console...<em> (only available if groovy is on the classpath)</em><br></strong>
                <em>Open's the <a href="../groovy.html">Groovy Console</a> for interactive scripting.</em><strong><br></strong></li>
                
        </ul>
        </li>
+       <li><strong>Vamsas</strong>
+       <em>For more details, read the <a href="../vamsas/index.html">Jalview VAMSAS documentation</a>.<br/>
+       When no session is active, the menu provides options for initiating a new VAMSAS session:</em>
+       <ul>
+       <li><strong>Connect to<br/></strong>
+       <em>Connect to one of the existing sessions available.</em></li>
+       <li><strong>New VAMSAS session<br/></strong>
+       <em>Initiates a new local VAMSAS session.</em></li>
+       <li><strong>Load VAMSAS session...<br/></strong>
+       <em>Opens a file browser allowing you to choose a VAMSAS document to import into a new local session.</em></li>
+       </ul>
+       <em>When Jalview is joined to a VAMSAS session, the menu contains the following:</em>
+       <ul>
+       <li><strong>Session Update<br/></strong>
+       <em>Sends alignment data in the Jalview desktop to the VAMSAS session.</em></li>
+       <li><strong>Save VAMSAS Session...<br/></strong>
+       <em>Saves the current session to a VAMSAS document archive.</em></li>
+       <li><strong>Stop VAMSAS Session<br/></strong>
+       <em>Disconnects from the current session. You may be asked if you want to save the current session's data if no other VAMSAS clients are connected.</em></li>
+       </ul>
+       </li>
        <li><strong>Help </strong>
        <ul>
                <li><strong>About<br>
index 7ee893b..bf07dd7 100755 (executable)
@@ -8,7 +8,16 @@
   <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>
+   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 
@@ -22,8 +31,7 @@
         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>
+        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>
index a81997e..6ee6480 100755 (executable)
@@ -20,7 +20,7 @@
 
                <td>
                <div align="center"><strong>2.5</strong><br>
-               <em>Not Yet Released</em></div>
+               <em>30th April 2010</em></div>
                </td>
                <td>
                <ul>
@@ -30,8 +30,7 @@
                        <li>Linked viewing of nucleic acid sequences and structures</li>
                        <li>Automatic Scrolling option in View menu to display the
                        currently highlighted region of an alignment.</li>
-                       <li>Order an alignment in order of average feature score or
-                       total feature count</li>
+                       <li>Order an alignment by sequence length, or using the average score or total feature count for each sequence.</li>
                        <li>Shading features by score or associated description</li>
                        <li>Subdivide alignment and groups based on identity of selected subsequence (Make Groups from Selection).</li>
                        <li>New hide/show options including Shift+Control+H to hide everything but the currently selected region.</li>
                                <li>Ensured that command line das feature retrieval completes
                                before alignment figures are generated.</li>
                                <li>Reduced time taken when opening file browser for first time.</li>
+                               <li>isAligned check prior to calculating tree, PCA or submitting an MSA to JNet now excludes hidden sequences.</li>
                        </ul>
                        </li>
                </ul>
index 23b4ced..ab31958 100644 (file)
 </head>\r
 <body>\r
 <p><strong>VAMSAS Interoperation</strong></p>\r
-<p>Jalview can interact with other applications using\r
- &quot;the <strong>VAMSAS Interoperation framework</strong>&quot; \r
- which is an experimental model for interoperation between \r
- bioinformatics applications (<strong>V</strong>isualization \r
- and <strong>A</strong>nalysis of <strong>Molecular</strong> \r
- <strong>S</strong>equences, <strong>Alignements</strong> \r
- and <strong>S</strong>tructures). Currently, the only other VAMSAS enabled application is <a href="http://www.topali.org">TOPALi</a> - a user friendly program for phylogenetics and evolutionary analysis. \r
- <p>VAMSAS enabled applications access\r
- a shared bioinformatics dataset containing sequences, alignments,\r
-  annotation and trees, which can be represented by an XML document \r
-  analogous to a <a href="../features/jalarchive.html">Jalview \r
-  Project Archive</a>.</p>\r
-<br><strong>Connecting to a VAMSAS session</strong><br>\r
-The VAMSAS functionality in Jalview is accessed through the Desktop's <strong>Vamsas</strong> menu. The options available in this menu depend on whether the application is currently interacting with a VAMSAS dataset in a <strong>VAMSAS session</strong>.\r
-When the application is not connected to a session is active, the menu options are as follows:<br>\r
-<ul><li><em>Connect to an existing session</em><br>\r
- If visible, this submenu contains a list of existing sessions that the VAMSAS framework has discovered on your computer. <br>Choose one to connect to it.</li>\r
-<li><em>New VAMSAS Session</em><br>\r
- This option will create a new session on your computer.</li>\r
-<li><em>Load VAMSAS Session...</em><br> \r
- This option will open a file browser window allowing you to select a VAMSAS session archive from which a new session will be created.</li>\r
- </ul>\r
- <br>\r
- Once you have successfully connected to a VAMSAS session, any data made available by other VAMSAS applications will be automatically imported into Jalview. However, in order to share the data in Jalview with other VAMSAS applications, \r
- you must manually select the <strong>Vamsas&#8594;&quot;Session Update&quot;</strong> entry that is visible when a session is active. Selecting this option will update the VAMSAS session document, with the data loaded into Jalview. Any new alignments, trees and annotation will be written to the session, in addition to any edits you have made to data originally stored in the document.\r
- <br>\r
- <strong>Saving the current session</strong><br>\r
- You can save the current session as a VAMSAS Session archive using the <strong>Vamsas&#8594;&quot;Session Update&quot;</strong>. The file contains a snapshot of the current VAMSAS session, including data from any other applications connected to the session.\r
- <strong>Leaving a VAMSAS session</strong><br>\r
- A session can be disconnected from at any time using the <strong>Vamsas&#8594;&quot;Stop Session&quot;</strong> option. Selecting this option will only disconnect Jalview from the session - any other applications will remain connected to the session. If Jalview is the only application connected to the session and you have not yet saved the VAMSAS session then you will be prompted with an optional 'Save VAMSAS session...' dialog box, allowing the session to be saved and returned to at a later date.\r
- <br>\r
- <strong>VAMSAS Session Persistence</strong><br>\r
- VAMSAS sessions are persistent - this means that they exist independently of any VAMSAS applications that are connected to them.\r
- This means that if something goes wrong with a VAMSAS application and it crashes or otherwise fails, the VAMSAS session it is connected to will (hopefully) be unaffected. For instance, if Jalview is killed or crashes whilst it is still connected to a session, that session can be recovered in a new Jalview instance using the <strong>Vamsas&#8594;&quot;Existing session&quot;</strong> sub menu.</p>\r
- <strong>A quick Demo</strong><br>\r
- Jalview can talk to itself through VAMSAS. Simply start two copies of the application, create a new vamsas session in one, and connect to the new session in the other. Then load your data into one of the applications, and use the <strong>Vamsas&#8594;&quot;Session Update&quot;</strong> menu entry to try to propagate the data to the other application.\r
- <br>\r
- <table>\r
- <tr><td>Data Sharing Capability</td><td>Jalview Version</td>\r
- </tr>\r
- <tr><td>Alignments, sequences and annotation, trees, database references, cDNA/protein mappings.</td><td>2.4</td></tr>\r
- <tr><td>Mouseover location across linked DNA, protein and structure positions.</td><td>2.4</td></tr>\r
- <tr><td>Jalview project settings (Multiple views, groups, tree partitions, colouring, window positions)</td><td>2.4.1</td></tr>\r
- <tr><td>Sequence region and column selections</td><td>2.4.1</td></tr>\r
- </table> \r
\r
- <p>\r
- For further details about the VAMSAS framework, please check the <a href="http://www.vamsas.ac.uk">VAMSAS website</a>. The VAMSAS framework is implemented as a Java 1.4 Library and depends on a number of other open source projects. Its source is will be released under the LGPL license.   \r
- &nbsp;</p>\r
+<p>Jalview can interact with other applications using &quot;the <strong>VAMSAS\r
+Interoperation framework</strong>&quot; which is an experimental model for\r
+interoperation between bioinformatics applications (<strong>V</strong>isualization\r
+and <strong>A</strong>nalysis of <strong>Molecular</strong> <strong>S</strong>equences,\r
+<strong>Alignements</strong> and <strong>S</strong>tructures).\r
+Currently, the only other VAMSAS enabled application is <a\r
+       href="http://www.topali.org">TOPALi</a> - a user friendly program for\r
+phylogenetics and evolutionary analysis.\r
+<p>VAMSAS enabled applications access a shared bioinformatics\r
+dataset containing sequences, alignments, annotation and trees, which\r
+can be represented by an XML document analogous to a <a\r
+       href="../features/jalarchive.html">Jalview Project Archive</a>.</p>\r
+<br>\r
+<strong>Connecting to a VAMSAS session</strong><br>\r
+The VAMSAS functionality in Jalview is accessed through the Desktop's <strong>Vamsas</strong>\r
+menu. The options available in this menu depend on whether the\r
+application is currently interacting with a VAMSAS dataset in a <strong>VAMSAS\r
+session</strong>. When the application is not connected to a session is active,\r
+the menu options are as follows:<br>\r
+<ul>\r
+       <li><em>Connect to an existing session</em><br>\r
+       If visible, this submenu contains a list of existing sessions that the\r
+       VAMSAS framework has discovered on your computer. <br>\r
+       Choose one to connect to it.</li>\r
+       <li><em>New VAMSAS Session</em><br>\r
+       This option will create a new session on your computer.</li>\r
+       <li><em>Load VAMSAS Session...</em><br>\r
+       This option will open a file browser window allowing you to select a\r
+       VAMSAS session archive from which a new session will be created.<br />\r
+       <em>New in 2.5</em>Sessions created from an imported document inherit\r
+       the file or URL for the document.</li>\r
+\r
+</ul>\r
+<br>\r
+<strong>VAMSAS and Firewalls</strong>: VAMSAS uses sockets to\r
+communicate between different programs. This means that after starting a\r
+session, your firewall software may ask you whether to allow the java\r
+executable access to the internet (port 53782). If you do not allow\r
+this, messages will not be exchanged with other VAMSAS applications.</br>\r
+<br>\r
+Once you have successfully connected to a VAMSAS session, any data made\r
+available by other VAMSAS applications will be automatically imported\r
+into Jalview. However, in order to share the data in Jalview with other\r
+VAMSAS applications, you must manually select the <strong>Vamsas&#8594;&quot;Session\r
+Update&quot;</strong> entry that is visible when a session is active. Selecting\r
+this option will update the VAMSAS session document, with the data\r
+loaded into Jalview. Any new alignments, trees and annotation will be\r
+written to the session, in addition to any edits you have made to data\r
+originally stored in the document. <br>\r
+<strong>Saving the current session</strong><br>\r
+You can save the current session as a VAMSAS Session archive using the <strong>Vamsas&#8594;&quot;Session\r
+Update&quot;</strong>. The file contains a snapshot of the current VAMSAS\r
+session, including data from any other applications connected to the\r
+session. <strong>Leaving a VAMSAS session</strong><br>\r
+A session can be disconnected from at any time using the <strong>Vamsas&#8594;&quot;Stop\r
+Session&quot;</strong> option. Selecting this option will only disconnect Jalview\r
+from the session - any other applications will remain connected to the\r
+session. If Jalview is the only application connected to the session and\r
+you have not yet saved the VAMSAS session then you will be prompted with\r
+an optional 'Save VAMSAS session...' dialog box, allowing the session to\r
+be saved and returned to at a later date. <br>\r
+<strong>VAMSAS Session Persistence</strong><br>\r
+VAMSAS sessions are persistent - this means that they exist\r
+independently of any VAMSAS applications that are connected to them.\r
+This means that if something goes wrong with a VAMSAS application and it\r
+crashes or otherwise fails, the VAMSAS session it is connected to will\r
+(hopefully) be unaffected. For instance, if Jalview is killed or crashes\r
+whilst it is still connected to a session, that session can be recovered\r
+in a new Jalview instance using the <strong>Vamsas&#8594;&quot;Existing\r
+session&quot;</strong> sub menu.</p>\r
+<strong>A quick Demo</strong>\r
+<br>\r
+Jalview can talk to itself through VAMSAS. Simply start two copies of\r
+the application, create a new vamsas session in one, and connect to the\r
+new session in the other. Then load your data into one of the\r
+applications, and use the\r
+<strong>Vamsas&#8594;&quot;Session Update&quot;</strong>\r
+menu entry to try to propagate the data to the other application.\r
+<br>\r
+<table>\r
+       <tr>\r
+               <td>Data Sharing Capability</td>\r
+               <td>Jalview Version</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Alignments, sequences and annotation, trees, database\r
+               references, cDNA/protein mappings.</td>\r
+               <td>2.4</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Mouseover location across linked DNA, protein and structure\r
+               positions.</td>\r
+               <td>2.4</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Jalview project settings (Multiple views, groups, tree\r
+               partitions, colouring, window positions)</td>\r
+               <td>2.5</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Sequence region and column selections</td>\r
+               <td>2.5</td>\r
+       </tr>\r
+</table>\r
+<br />\r
+<p>Version 0.2 of the VAMSAS client library is used in <em>Jalview\r
+2.4.1</em>. For further details about the VAMSAS framework, please check the\r
+<a href="http://www.vamsas.ac.uk">VAMSAS website</a>. The VAMSAS\r
+framework is implemented as a Java 1.4 Library and depends on a number\r
+of other open source projects. Its source is will be released under the\r
+LGPL license. &nbsp;</p>\r
 </body>\r
 </html>\r