2.2 documentation
authorjprocter <Jim Procter>
Mon, 27 Nov 2006 17:32:40 +0000 (17:32 +0000)
committerjprocter <Jim Procter>
Mon, 27 Nov 2006 17:32:40 +0000 (17:32 +0000)
21 files changed:
help/helpTOC.xml
help/html/calculations/pca.html
help/html/colourSchemes/textcolour.gif [new file with mode: 0644]
help/html/colourSchemes/textcolour.html
help/html/editing/index.html
help/html/features/creatinFeatures.html
help/html/features/das.gif [new file with mode: 0644]
help/html/features/das.jpg [deleted file]
help/html/features/dasfeatures.html
help/html/features/dassettings.html
help/html/features/featuresFormat.html
help/html/features/hiddenRegions.html
help/html/features/multipleViews.html
help/html/features/newkeystrokes.html
help/html/features/pdbviewer.html
help/html/io/index.html
help/html/menus/alignmentMenu.html
help/html/menus/alwfile.html
help/html/menus/index.html
help/html/menus/popupMenu.html
help/html/whatsNew.html

index 5252a30..c0c7f2c 100755 (executable)
@@ -21,7 +21,7 @@
        <tocitem text="Sequence Features" target="seqfeatures" expand="false">
           <tocitem text="Sequence Feature Settings" target="seqfeatures.settings"/>
           <tocitem text="Sequence Features File" target="features.fileformat"/>
-          <tocitem text="User Defined Sequence Features" target="search"/>
+          <tocitem text="User Defined Sequence Features" target="seqfeatcreat"/>
                  <tocitem text="Editing Sequence Features" target="seqfeatedit"/>
           <tocitem text="DAS Feature Retrieval" target="das.viewing"/>
          <tocitem text="DAS Feature Settings" target="das.settings"/>
index 8cbf0ca..acf9665 100755 (executable)
@@ -50,7 +50,7 @@ sequence in the associated alignment window views. Rectangular region
 based selection is also possible, by holding the 'S' key whilst
 left-clicking and dragging the mouse over the display. By default,
 points are only associated with the alignment view from which the PCA
-was calculated, but this may be changed via the <strong>Associate
+was calculated, but this may be changed via the <strong>View&#8594;Associate
 Nodes</strong> sub-menu.</p>
 <p>Initially, the display shows the first three components of the
 similarity space, but any eigenvector can be used by changing the
diff --git a/help/html/colourSchemes/textcolour.gif b/help/html/colourSchemes/textcolour.gif
new file mode 100644 (file)
index 0000000..a659156
Binary files /dev/null and b/help/html/colourSchemes/textcolour.gif differ
index 586bb06..f40116a 100644 (file)
@@ -5,12 +5,16 @@ Background Dependent Text Colour
 <body>
 <strong>Background Dependent Text Colour</strong>
 <p>The <strong>Colour&#8594;Text Colour</strong> menu entry opens
-the <strong>Text Colour</strong> dialog box. This contains a slider, and
-two colour icons showing the text colour for dark backgrounds (left hand
-end of slider), and light backgrounds (right hand end of slider). Drag
-the slider to change the threshold for transitioning between dark and
-light background colours, and select either of the colour boxes to open
-a colour chooser to select a different text colour.
+the <strong>&quot;Adjust Foreground Text Colour Threshold&quot;</strong>
+dialog box, allowing the colour of symbols rendered on dark or light
+backgrounds to be set for the current selection or the whole alignment.
 </p>
+<p><img src="textcolour.gif"></p>
+<p>The dialog box contains a slider, and two colour icons showing
+the text colour for dark backgrounds (left hand end of slider), and
+light backgrounds (right hand end of slider). Drag the slider to change
+the threshold for transitioning between dark and light background
+colours, and select either of the colour boxes to open a colour chooser
+to select a different text colour.</p>
 </body>
 </html>
index b0e8103..f71271a 100755 (executable)
@@ -1,56 +1,56 @@
-<html>\r
-<head><title>Editing</title></head>\r
-<body>\r
-<p><strong>Editing</strong></p>\r
-<p>There are two major ways to edit alignments - in 'Normal mode',\r
-gaps are inserted and deleted at the mouse pointer in various ways by\r
-clicking the left mouse button and pressing a combination of either\r
-shift and control (or the apple key on Macs) and dragging the mouse. Pressing\r
-<em>F2</em> toggles the alternative <a href="../features/cursorMode.html">'Cursor\r
-mode'</a> keyboard editing facility, where the space bar and delete \r
-keys add and remove gaps at the current editing position. The key\r
-strokes for both these modes are summarised in the <a\r
-href="../keys.html">keystrokes table</a>.</p>\r
-<p><strong>Tip:</strong> For large alignments, deselect &quot;Calculate -&gt; \r
-  Autocalculate Consensus&quot; to prevent the alignment performing lengthy calculations \r
-  after every edit. </p>\r
-<p><em>Inserting / removing gaps</em> - hold down the\r
-  &quot;Shift&quot; key. Click on a residue with the mouse and drag it\r
-  to the left or right to insert gaps and remove gaps.<br>\r
-  If the current selection is a group over all sequences in the\r
-  alignment, or a group over some sequences or all columns in the\r
-  alignment, then hold down either &quot;Control&quot; \r
-  key and drag the residue left or right to edit all sequences in the defined \r
-  group at once.</p>\r
-<p><em>Copy/paste/cut/delete</em> - any sequences which are in the current selection\r
-  box (indicated in red) may be cut and / or copied to a new alignment or deleted.\r
-</p>\r
-<p><em>Undo / redo</em> - editing of sequences (insertion/removal of gaps, removal\r
-  of sequences, trimming sequences etc) may be undone or redone at any time using\r
-  the appropriate menu items from the edit menu. The undo history list only allows\r
-  a maximum of 10 actions.\r
-<p><em>Trimming alignment</em> - First select a column by clicking the scale indicator\r
-  (above the sequences) The alignment may then be trimmed to the left or right\r
-  of this column. If multiple columns are selected, the alignment is trimmed to\r
-  the right of the rightmost selected column (or to the left of the leftmost selected\r
-  column)</p>\r
-<p><em>Remove gapped columns</em> - Removes columns within the alignment which\r
-  contain only space characters (&quot;-&quot; or &quot;.&quot; or &quot; &quot;)</p>\r
-<p><em>Removing gaps</em> - Removes all gaps from the alignment. Gaps are &quot;-&quot;\r
-  or &quot;.&quot; or &quot; &quot;.</p>\r
-<p><em>Set gap character</em> - Switches the gap character between &quot;.&quot; \r
-  and &quot;-&quot;. If the &quot;Render Gaps&quot; option from the &quot;View&quot; \r
-  menu is unticked all gaps will appear as blank spaces.</p>\r
-<p>&nbsp;</p>\r
-<p><strong>Editing In Selection Areas</strong></p>\r
-<a href="index.html">Editing</a> can be restricted to the current selection area. \r
-This allows the user to &quot;Lock&quot; the alignment either side of the selection \r
-area. Any gap insertions or deletions will only affect the current selection area.\r
-<p><img src="editing.jpg" width="428" height="186" align="top"></p>\r
-<p>In this example, if Sequence IL2RA_MACMU has gaps removed from position 98-104, \r
-  the same number of gaps will be inserted at position 116, (between M and L). \r
-</p>\r
-<p><em>Locked selection area based editing was introduced in Jalview 2.08</em></p>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<head><title>Editing</title></head>
+<body>
+<p><strong>Editing</strong></p>
+<p>There are two major ways to edit alignments - in 'Normal mode',
+gaps are inserted and deleted at the mouse pointer in various ways by
+clicking the left mouse button and pressing a combination of either
+shift and control (or the apple key on Macs) and dragging the mouse. Pressing
+<em>F2</em> toggles the alternative <a href="../features/cursorMode.html">'Cursor
+mode'</a> keyboard editing facility, where the space bar and delete 
+keys add and remove gaps at the current editing position. The key
+strokes for both these modes are summarised in the <a
+href="../keys.html">keystrokes table</a>.</p>
+<p><strong>Tip:</strong> For large alignments, deselect &quot;Calculate -&gt; 
+  Autocalculate Consensus&quot; to prevent the alignment performing lengthy calculations 
+  after every edit. </p>
+<p><em>Inserting / removing gaps</em> - hold down the
+  &quot;Shift&quot; key. Click on a residue with the mouse and drag it
+  to the left or right to insert gaps and remove gaps.<br>
+  If the current selection is a group over all sequences in the
+  alignment, or a group over some sequences or all columns in the
+  alignment, then hold down either &quot;Control&quot; 
+  key and drag the residue left or right to edit all sequences in the defined 
+  group at once.</p>
+<p><em>Copy/paste/cut/delete</em> - any sequences which are in the current selection
+  box (indicated in red) may be cut and / or copied to a new alignment or deleted.
+</p>
+<p><em>Undo / redo</em> - editing of sequences (insertion/removal of gaps, removal
+  of sequences, trimming sequences etc) may be undone or redone at any time using
+  the appropriate menu items from the edit menu. The undo history list only allows
+  a maximum of 10 actions.
+<p><em>Trimming alignment</em> - First select a column by clicking the scale indicator
+  (above the sequences) The alignment may then be trimmed to the left or right
+  of this column. If multiple columns are selected, the alignment is trimmed to
+  the right of the rightmost selected column (or to the left of the leftmost selected
+  column)</p>
+<p><em>Remove gapped columns</em> - Removes columns within the alignment which
+  contain only space characters (&quot;-&quot; or &quot;.&quot; or &quot; &quot;)</p>
+<p><em>Removing gaps</em> - Removes all gaps from the alignment. Gaps are &quot;-&quot;
+  or &quot;.&quot; or &quot; &quot;.</p>
+<p><em>Set gap character</em> - Switches the gap character between &quot;.&quot; 
+  and &quot;-&quot;. If the &quot;Render Gaps&quot; option from the &quot;View&quot; 
+  menu is unticked all gaps will appear as blank spaces.</p>
+<p>&nbsp;</p>
+<p><strong>Editing In Selection Areas</strong></p>
+Editing can be restricted to the current selection area. 
+This allows the user to &quot;Lock&quot; the alignment either side of the selection 
+area. Any gap insertions or deletions will only affect the current selection area.
+<p><img src="editing.jpg" width="428" height="186" align="top"></p>
+<p>In this example, if Sequence IL2RA_MACMU has gaps removed from position 98-104, 
+  the same number of gaps will be inserted at position 116, (between M and L). 
+</p>
+<p><em>Locked selection area based editing was introduced in Jalview 2.08</em></p>
+<p>&nbsp;</p>
+</body>
+</html>
index 486b75b..0ebb52f 100644 (file)
@@ -7,10 +7,10 @@
 <p>Jalview can create sequence features from the matches of a <a
        href="search.html">regular expression search</a>, or from the currently
 selected area via the <strong>&quot;selection&#8594;Create
-sequence feature&quot;</strong> entry in the selection area popup menu. In both
+sequence feature&quot;</strong> entry in the <a href="../menus/popupMenu.html">selection area popup menu</a>. In both
 cases, the <strong>Create Features</strong> dialog box will then be
 opened:</p>
-<img src="crnewfeature.gif">
+<p><img src="crnewfeature.gif"></p>
 <p>Select or enter the attributes for the features being created,
 and then press OK to create the new features.</p>
 <p>Each attribute is described below:
diff --git a/help/html/features/das.gif b/help/html/features/das.gif
new file mode 100644 (file)
index 0000000..1f884cb
Binary files /dev/null and b/help/html/features/das.gif differ
diff --git a/help/html/features/das.jpg b/help/html/features/das.jpg
deleted file mode 100644 (file)
index 78e061b..0000000
Binary files a/help/html/features/das.jpg and /dev/null differ
index 5dc334e..c2b4d49 100644 (file)
@@ -1,51 +1,65 @@
-<html>\r
-\r
-<head><title>DAS Features</title></head>\r
-\r
-<body>\r
-<p><strong>DAS Sequence Feature Retrieval</strong></p>\r
-<p>Jalview 2.1 can be set up to retrieve sequence features using the <a href="http://www.biodas.org">Distributed \r
-  Annotation System</a></p>\r
-<ol>\r
-  <li>Open the Feature Settings panel by selecting &quot;View -&gt; Feature Settings...&quot;</li>\r
-  <li>Click on the &quot;<a href="dassettings.html">DAS Settings</a>&quot; tabbed \r
-    pane.</li>\r
-  <li>Select the sources to use for DAS feature retireval, then click the &quot;Fetch \r
-    DAS Features&quot; button.</li>\r
-</ol>\r
-<p>If your DAS source selection contains sources which use Uniprot accession ids, \r
-  you will be asked whether Jalview should find Uniprot Accession ids for the \r
-  given sequence names. It is important to realise that many DAS sources only \r
-  use Uniprot accession ids, not names of sequences. <br>\r
-  The method of Uniprot accession id discovery is the same method which earlier \r
-  Jalview versions used for sequence feature retrieval, ie WSDbFetch provided \r
-  by the EBI.</p>\r
-<p>The process is as described:</p>\r
-<p><strong>The Sequence Identification Process</strong> </p>\r
-<p>Jalview will attempt to retrieve sequence features from Uniprot files using \r
-  the EBI dbFetch web service using the given sequence names (or Uniprot ID, if \r
-  available). A 100% match with the Uniprot record is required for Uniprot features \r
-  to be view on a sequence.</p>\r
-<p>The first step in the procedure for matching uniprot IDs to sequences is to \r
-  use the ID (name) of each sequence to retrieve Uniprot records directly.</p>\r
-<p> If a uniprot record (or set of records) is found for a sequence, then the \r
-  sequence is aligned to the one in the Uniprot record to determine the correct \r
-  start and end residue positions (which are displayed when the 'Show Full Sequence \r
-  ID' option is set). </p>\r
-<p>If the alignment reveals differences between the sequence in the alignment \r
-  and the one in the record, then Jalview will assume that the aligned sequence \r
-  is not the one in the uniprot record. </p>\r
-<p> In some cases, the ID used to retrieve Uniprot records may be out of date \r
-  and you will be notified of that a 100% match between the sequence and a Uniprot \r
-  record was identified, but the sequence name must be manually changed (by right \r
-  clicking on the sequence ID and selecting <strong>Sequence&#8594;Edit Name</strong>), \r
-  before Jalview will show its sequence features. \r
-<ul>\r
-  <li>remember to save your alignment if you have updated any of the sequence \r
-    IDs! </li>\r
-</ul>\r
-<p>&nbsp; \r
-<p>\r
-<p>&nbsp; \r
-</body>\r
-</html>\r
+<html>
+
+<head>
+<title>DAS Features</title>
+</head>
+
+<body>
+<p><strong>DAS Sequence Feature Retrieval</strong></p>
+<p>Jalview includes a client for retrieving sequence features via
+the <a href="http://www.biodas.org">Distributed Annotation System</a>.</p>
+<ol>
+       <li>Open the Feature Settings panel by selecting &quot;View -&gt;
+       Feature Settings...&quot;</li>
+       <li>Click on the &quot;<a href="dassettings.html">DAS Settings</a>&quot;
+       tabbed pane.</li>
+       <li>Select the sources to use for DAS feature retireval, then
+       click the &quot;Fetch DAS Features&quot; button.
+       <ul>
+               <li>Cancelling Feature Retrieval<br>
+               Press the <strong>Cancel Fetch</strong> button to immediately stop
+               feature retrieval. This will not remove any features already added to
+               the alignment, but will halt any outstanding DAS requests.<em>The
+               cancel fetch button is of particular use when one or more DAS
+               annotation servers are not responding!</em>
+       </ul>
+       </li>
+</ol>
+<p>If your DAS source selection contains sources which use Uniprot
+accession ids, you will be asked whether Jalview should find Uniprot
+Accession ids for the given sequence names. It is important to realise
+that many DAS sources only use Uniprot accession ids, rather than
+Swissprot/Uniprot sequence names.<br>
+<p><strong>The Sequence Identification Process</strong></p>
+The method of Uniprot accession id discovery is the same method which
+earlier Jalview versions used for sequence feature retrieval, and is now
+also used for
+<a href="viewingpdbs.html">PDB ID discovery</a>
+. Essentially, Jalview will try to retrieve Uniprot records via the
+EBI's WSDbFetch interface using each sequence's ID string (or each
+string in the ID separated by the '&#8739;' symbol).
+</p>
+<p>If a uniprot record (or set of records) is found for a sequence,
+then the sequence is aligned to the one in the Uniprot record to
+determine the correct start and end residue positions (which are
+displayed when the 'Show Full Sequence ID' option is set).</p>
+<p>If the alignment reveals differences between the sequence in the
+alignment and the one in the record, then Jalview will assume that the
+aligned sequence is not the one in the uniprot record.</p>
+<p>In some cases, the ID used to retrieve Uniprot records may be out
+of date and a dialog box will be opened indicating that a 100% match
+between the sequence and a Uniprot record was identified, but the
+sequence name is different. In this case, the ID must be manually
+changed (by right clicking on the sequence ID and selecting <strong>Sequence&#8594;Edit
+Name</strong>), before Jalview will show its sequence features.
+<ul>
+       <li><em>Note</em><br>
+       Please remember to save your alignment if either the start/end
+       numbering, or the sequence IDs were updated during the Uniprot ID
+       retrieval process.</li>
+</ul>
+<p>&nbsp;
+<p><em>DAS support was introduced in Jalview Version 2.1.</em></p>
+<p>&nbsp;
+</body>
+</html>
index f3e325d..30b36b1 100644 (file)
@@ -1,32 +1,32 @@
-<html>\r
-\r
-<head><title>DAS Settings</title></head>\r
-\r
-<body>\r
-<p><strong>DAS Settings</strong></p>\r
-<p>Jalview can retrieve and visualize features from many <a href="http://biodas.org/">DAS</a> \r
-  sources at once. The DAS sources are discovered and selected <em>via</em> the DAS settings panel.</p>\r
-<p><img src="das.jpg" width="497" height="365">\r
-<p>The available sources are listed in the table using each source's\r
-Nickname as its identifier. Clicking on a source's entry in the table\r
-reveals more information about that service in the panel to the\r
-right. Select the tickbox in the &quot;Use Source&quot; column for a\r
-source to add it to the set Jalview queries for alignment and sequence\r
-features.\r
-</p>\r
-<p>You can filter the visible DAS sources by authority, type and &quot;label&quot;. \r
-  You should read the DAS documentation to understand more about these values.\r
-<p><strong>Updating the list of sources</strong></p>\r
-<p>When the DAS Settings panel is first opened, and when the <strong>'Refresh\r
-  source'</strong> buton is pressed, a list of DAS sources\r
-  is retrieved from the DAS registry URL (set by default to the DAS\r
-  registration server at\r
-  http://das.sanger.ac.uk/registry/das1/sources/).</p>\r
-<p><strong>Adding your own DAS Sources</strong></p>\r
-<p>You can add your own DAS source to the list by clicking the &quot;Add Local \r
-  Source&quot; button. Enter the URL and nickname of your additional service. \r
-  It should be noted that Jalview 2.1 will not query additional sources for more \r
-  information, but this will be implemented in future editions. \r
-<p>&nbsp;\r
-</body>\r
-</html>\r
+<html>
+
+<head><title>DAS Settings</title></head>
+
+<body>
+<p><strong>DAS Settings</strong></p>
+<p>Jalview can retrieve and visualize features from many <a href="http://biodas.org/">DAS</a> 
+  sources at once. The DAS sources are discovered and selected <em>via</em> the DAS settings panel.</p>
+<p><img src="das.gif">
+<p>The available sources are listed in the table using each source's
+Nickname as its identifier. Clicking on a source's entry in the table
+reveals more information about that service in the panel to the
+right. Select the tickbox in the &quot;Use Source&quot; column for a
+source to add it to the set Jalview queries for alignment and sequence
+features.
+</p>
+<p>You can filter the visible DAS sources by authority, type and &quot;label&quot;. 
+  You should read the DAS documentation to understand more about these values.
+<p><strong>Updating the list of sources</strong></p>
+<p>When the DAS Settings panel is first opened, and when the <strong>'Refresh
+  source'</strong> buton is pressed, a list of DAS sources
+  is retrieved from the DAS registry URL (set by default to the DAS
+  registration server at
+  http://das.sanger.ac.uk/registry/das1/sources/).</p>
+<p><strong>Adding your own DAS Sources</strong></p>
+<p>You can add your own DAS source to the list by clicking the &quot;Add Local 
+  Source&quot; button. Enter the URL and nickname of your additional service. 
+  It should be noted that Jalview 2.1 will not query additional sources for more 
+  information, but this will be implemented in future editions. 
+<p>&nbsp;
+</body>
+</html>
index 77d62a7..b11e96b 100755 (executable)
@@ -1,77 +1,85 @@
-<html>\r
-\r
-<head><title>Sequence Features File</title></head>\r
-\r
-<body>\r
-<p><strong>Sequence Features File</strong></p>\r
-<p>The Sequence features file (which used to be known as the &quot;Groups\r
-file&quot; prior to version 2.08) is a simple way of getting\r
-your own sequence annotations into Jalview. It was introduced to allow\r
-sequence features to be rendered in the Jalview applet, and so is\r
-intentionally lightweight and minimal because the applet is often used\r
-in situations where data file size must be kept to a minimum, and no\r
-XML parser is available.</p>\r
-<p>Features files are imported into Jalview in the following ways:<br>\r
-<ul>\r
-<li>from the command line<strong><pre>\r
- -features &lt;<em>Features filename</em>&gt;</pre></strong></li>\r
-<li>Dragging a features file onto an alignment window</li>\r
-<li>Via the &quot;Load Features / Annotations&quot; entry in the\r
-<strong>File</strong> menu of an alignment window.</li>\r
-</ul>\r
-</p>\r
-<p><strong>Sequence Features File Format</strong></p>\r
-<p>A features file is a simple ASCII text file, where each line\r
-contains tab separated text fields. <strong>No comments are\r
-allowed</strong>.</p>\r
-<p>The first set of lines contain type definitions:<strong>\r
-<pre><em>Feature label</em>&#9;<em>Feature Colour</em></pre>\r
-</strong>A feature type has a text label, and a colour (specified as a\r
-red,green,blue 24 bit triplet either in hexadecimal (eg. 00ff00) or as comma\r
-separated numbers (ranging from 0 to 255)).\r
-<p>The remaining lines in the file are the sequence annotation\r
-definitions, where the now defined features are attached to regions on\r
-particular sequences, optionally with some descriptive text (displayed\r
-in a tooltip when the mouse is near the feature on that sequence). There are two alternate ways of referring to a\r
-sequence, either by its text ID, or its index in an associated\r
-alignment.<pre>\r
-<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em></pre>Normally,\r
-sequence features are associated with sequences rather than\r
-alignments, and the sequenceIndex field is given as &quot;-1&quot;. In\r
-order to specify a sequence by its index in a particular alignment, the\r
-sequenceId should be given as &quot;ID_NOT_SPECIFIED&quot;, otherwise the\r
-sequenceId field will be used in preference to the sequenceIndex field.</p><p>\r
-Feature annotations can be collected into named groups by prefixing\r
-definitions with lines of the\r
-form:<strong><pre>startgroup&#9;groupname</pre></strong>.. and\r
-subsequently post-fixing the group\r
-with:<strong><pre>endgroup&#9;groupname</pre></strong>Feature grouping\r
-was introduced in version 2.08, and used to control whether a set of features\r
-are either hidden or shown together in the <a href="seqfeatures.html">sequence Feature settings\r
-dialog box</a>.</p>\r
-<p>A complete example is shown below :<pre>\r
-domain&#9;red\r
-metal ion-binding site&#9;00ff00\r
-transit peptide&#9;0,105,215\r
-chain&#9;225,105,0\r
-modified residue&#9;105,225,35\r
-signal peptide&#9;0,155,165\r
-helix&#9;ff0000\r
-strand&#9;00ff00\r
-coil&#9;cccccc\r
-Your Own description here&#9;FER_CAPAA&#9;-1&#9;3&#9;93&#9;domain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;48&#9;144&#9;chain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;50&#9;140&#9;domain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;136&#9;136&#9;modified residue\r
-Your Own description here&#9;FER1_LYCES&#9;-1&#9;1&#9;47&#9;transit peptide\r
-Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;1&#9;48&#9;signal peptide\r
-Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;49&#9;144&#9;chain\r
-startgroup&#9;secondarystucture\r
-PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;52&#9;59&#9;strand\r
-PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;74&#9;80&#9;helix\r
-endgroup&#9;secondarystructure\r
-</pre>\r
-</li>\r
-</p>\r
-</body>\r
-</html>\r
+<html>
+
+<head>
+<title>Sequence Features File</title>
+</head>
+
+<body>
+<p><strong>Sequence Features File</strong></p>
+<p>The Sequence features file (which used to be known as the
+&quot;Groups file&quot; prior to version 2.08) is a simple way of
+getting your own sequence annotations into Jalview. It was introduced to
+allow sequence features to be rendered in the Jalview applet, and so is
+intentionally lightweight and minimal because the applet is often used
+in situations where data file size must be kept to a minimum, and no XML
+parser is available.</p>
+<p>Features files are imported into Jalview in the following ways:<br>
+<ul>
+       <li>from the command line<strong><pre>
+ -features &lt;<em>Features filename</em>&gt;</pre></strong></li>
+       <li>Dragging a features file onto an alignment window</li>
+       <li>Via the &quot;Load Features / Annotations&quot; entry in the <strong>File</strong>
+       menu of an alignment window.</li>
+</ul>
+</p>
+<p><strong>Sequence Features File Format</strong></p>
+<p>A features file is a simple ASCII text file, where each line
+contains tab separated text fields. <strong>No comments are
+allowed</strong>.</p>
+<p>The first set of lines contain type definitions:<strong>
+<pre><em>Feature label</em>&#9;<em>Feature Colour</em></pre> </strong>A feature
+type has a text label, and a colour (specified as a red,green,blue 24
+bit triplet either in hexadecimal (eg. 00ff00) or as comma separated
+numbers (ranging from 0 to 255)). The text label may contain simple HTML
+document body tags if enclosed by &quot;&lt;html&gt;&lt;/html&gt;&quot;
+and will be rendered as formatted tooltips in the Jalview Application
+(the Jalview applet is not capable of rendering HTML tooltips, so all
+formatting tags will be removed.</p>
+<p>The remaining lines in the file are the sequence annotation
+definitions, where the now defined features are attached to regions on
+particular sequences, optionally with some descriptive text (displayed
+in a tooltip when the mouse is near the feature on that sequence). There
+are two alternate ways of referring to a sequence, either by its text
+ID, or its index in an associated alignment.
+<pre>
+<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em></pre>
+Normally, sequence features are associated with sequences rather than
+alignments, and the sequenceIndex field is given as &quot;-1&quot;. In
+order to specify a sequence by its index in a particular alignment, the
+sequenceId should be given as &quot;ID_NOT_SPECIFIED&quot;, otherwise
+the sequenceId field will be used in preference to the sequenceIndex
+field.
+</p>
+<p>Feature annotations can be collected into named groups by
+prefixing definitions with lines of the form:<strong><pre>startgroup&#9;groupname</pre></strong>..
+and subsequently post-fixing the group with:<strong><pre>endgroup&#9;groupname</pre></strong>Feature
+grouping was introduced in version 2.08, and used to control whether a
+set of features are either hidden or shown together in the <a
+       href="seqfeatures.html">sequence Feature settings dialog box</a>.</p>
+<p>A complete example is shown below :
+<pre>
+domain&#9;red
+metal ion-binding site&#9;00ff00
+transit peptide&#9;0,105,215
+chain&#9;225,105,0
+modified residue&#9;105,225,35
+signal peptide&#9;0,155,165
+helix&#9;ff0000
+strand&#9;00ff00
+coil&#9;cccccc
+Your Own description here&#9;FER_CAPAA&#9;-1&#9;3&#9;93&#9;domain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;48&#9;144&#9;chain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;50&#9;140&#9;domain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;136&#9;136&#9;modified residue
+Your Own description here&#9;FER1_LYCES&#9;-1&#9;1&#9;47&#9;transit peptide
+Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;1&#9;48&#9;signal peptide
+Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;49&#9;144&#9;chain
+startgroup&#9;secondarystucture
+PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;52&#9;59&#9;strand
+PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;74&#9;80&#9;helix
+endgroup&#9;secondarystructure
+</pre>
+</li>
+</p>
+</body>
+</html>
index c5266d7..66413d9 100644 (file)
@@ -1,51 +1,64 @@
 <html>
-<head><title>Hidden Regions</title></head>
+<head>
+<title>Hidden Regions</title>
+</head>
 <body>
-<p><strong>Hidden Regions</strong> </p>
-<p>Use the keyboard key &quot;H&quot; to hide / reveal selected columns and sequences. 
-  To hide / reveal only selected sequences, use &quot;Shift H&quot;, to hide / 
-  reveal only selected columns, use &quot;Control H&quot;.</p>
+<p><strong>Hidden Regions</strong></p>
+<p>Use the keyboard key &quot;H&quot; to hide / reveal selected
+columns and sequences. To hide / reveal only selected sequences, use
+&quot;Shift H&quot;, to hide / reveal only selected columns, use
+&quot;Control H&quot;.</p>
 <p><strong><em>Hiding Sequences</em></strong><br>
-To hide selected sequences in an alignment, use the <strong>&quot;View 
-  -&gt; Hide -&gt; Selected Sequences&quot;</strong> menu item or simply select <strong>&quot;Hide 
-  Sequences&quot;</strong> from the Popup menu after a right click on the sequence Ids. 
-</p>
-<p>Hidden sequences will not be used in any calculations, editing or web service 
-  alignments performed on visible sequences. </p>
+To hide selected sequences in an alignment, use the <strong>&quot;View
+-&gt; Hide -&gt; Selected Sequences&quot;</strong> menu item or simply select <strong>&quot;Hide
+Sequences&quot;</strong> from the Popup menu after a right click on the sequence
+Ids.</p>
+<p>Hidden sequences will not be used in any calculations, editing or
+web service alignments performed on visible sequences.</p>
 <p><strong><em>Hidden Sequences Representatives</em></strong><br>
-A more advanced hide involves a right-mouse click on a sequence, then selecting 
-  <strong>&quot;SequenceID -&gt; Represent Group with SequenceId&quot;</strong>. Using this method 
-  of hiding sequences, any edits performed on the visible group representative 
-  will be propogated to all the sequences in that group. <br>
-  The hidden representative sequences will not be used in any
-  calculations or web service alignments (<em>nb. this may change in
-  the future</em>)
-</p>
+A more advanced hide involves a right-mouse click on a sequence, then
+selecting <strong>&quot;SequenceID -&gt; Represent Group with
+SequenceId&quot;</strong>. Using this method of hiding sequences, any edits
+performed on the visible group representative will be propogated to all
+the sequences in that group. <br>
+The hidden representative sequences will not be used in any calculations
+or web service alignments (<em>nb. this may change in the future</em>).
+<br>
+<strong>Warning:</strong>The representative sequence groups feature is
+not fully implemented in the jalview 2.2 release, following the
+introduction of Multiple views.</p>
 <p><strong><em>Hiding Columns</em></strong><br>
-To hide selected columns in an alignment, use the <strong>&quot;View 
-  -&gt; Hide -&gt; Selected Columns&quot;</strong> menu item, or right click within a region 
-  of selected columns in the scale above the alignment (only available in non 
-  wrapped mode) and select <strong>&quot;Hide Columns&quot;</strong>. </p>
-<p>When an alignment view contains hidden columns, certain constraints
-apply:<ul><li>Editing the alignment is bound by the hidden columns, <em>i.e.</em> you cannot move residues 
-  across a hidden column boundary.</li>
-<li><strong>Tree</strong>, <strong>pairwise alignment</strong> and <strong>PCA</strong> calculations will only be
-performed using the <em>visible</em> parts of the alignment.
-</li>
-<li><a
-  href="../webservices/msaclient.html">Multiple Sequence
-  Alignments</a> are performed locally on on each visible chunk of
-  the input, and concatenated with the hidden regions to form the
-  final result.</p>
-</li>
+To hide selected columns in an alignment, use the <strong>&quot;View
+-&gt; Hide -&gt; Selected Columns&quot;</strong> menu item, or right click within
+a region of selected columns in the scale above the alignment (only
+available in non wrapped mode) and select <strong>&quot;Hide
+Columns&quot;</strong>.</p>
+<p>When an alignment view contains hidden columns, certain
+constraints apply:
+<ul>
+       <li>Editing the alignment is bound by the hidden columns, <em>i.e.</em>
+       you cannot move residues across a hidden column boundary.</li>
+       <li><strong><a href="../calculations/tree.html">Tree</a></strong>,
+       <strong><a href="../calculations/pairwise.html">pairwise
+       alignment</a></strong> and <strong><a href="../calculations/pca.html">PCA</a></strong>
+       calculations will only be performed using the <em>visible</em> parts of
+       the alignment.</li>
+       <li><a href="../webservices/msaclient.html">Multiple Sequence
+       Alignments</a> are performed locally on on each visible chunk of the input,
+       and concatenated with the hidden regions to form the final result.
+       </p>
+       </li>
 </ul>
-<p><strong>Column Separability</strong><br>Calculations where hidden columns are
-  excluded, and a single analysis performed on the result, are termed <em>column-separable</em>.
-  The simple Tree and PCA calculations are column separable because essentially the same results
-  would be obtained if the excluded hidden columns were replaced by gaps as the input to the calculation.</p>
-  <p>Multiple Sequence alignment and secondary structure prediction are both non-column-separable, and 
-  so the exclusion of hidden regions leads to only 'locally optimal' results - sometimes 
-  different to that obtained when using the full alignment.</p>
+<p><strong>Column Separability</strong><br>
+Calculations where hidden columns are excluded, and a single analysis
+performed on the result, are termed <em>column-separable</em>. The
+simple Tree and PCA calculations are column separable because
+essentially the same results would be obtained if the excluded hidden
+columns were replaced by gaps as the input to the calculation.</p>
+<p>Multiple Sequence alignment and secondary structure prediction
+are both non-column-separable, and so the exclusion of hidden regions
+leads to only 'locally optimal' results - sometimes different to that
+obtained when using the full alignment.</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
index c4929e5..36bda32 100644 (file)
@@ -4,14 +4,14 @@
 </head>
 <body>
 <p><strong>Multiple Alignment Views<strong></p>
-<p>Multiple alignment views allow's the same alignment to be viewed
-in many different ways, either as multiple alignment tabs, or
-simultaneously in linked alignment windows. A view is an independent
-visualization of the same alignment, so each may have a different
-ordering, colouring, row and column hiding and seuqence feature and
-annotation display setting, but alignment, feature and annotation edits
-are common to all, since this affects the underlying data.</p>
-<p>A new view is created using the <strong>&quot;View&#8594;New
+<p>Multiple alignment views allows the same alignment to be viewed
+independently in many different ways simultaneously. Each view is an
+independent visualization of the same alignment, so each may have a
+different ordering, colouring, row and column hiding and seuqence
+feature and annotation display setting, but alignment, feature and
+annotation edits are common to all, since this affects the underlying
+data.</p>
+<p>Create a new view using the <strong>&quot;View&#8594;New
 View&quot;</strong> menu item, or by pressing <strong>Control+T</strong>. A newly
 created view will be identical to the view it was created from, but any
 changes to the way the alignment is coloured or displayed will only
@@ -29,15 +29,22 @@ to expand each view into its own linked alignment window. Expanded views
 are gathered back into into a single tabbed alignment window by pressing
 <strong>G</strong>, or by selecting <strong>&quot;View&#8594;Gather&quot;</strong>).
 </p>
-<p><strong>Tree Viewers, PCA Viewers, and Multiple Views</strong></p>
+<p><strong>Structure and Analysis Viewers and Multiple
+Views</strong></p>
 <p>A tree calculated on a particular view, or loaded onto it, is by
 default associated with just that view. However, the <a
        href="../calculations/treeviewer.html">Tree Viewer's</a> <strong>&quot;View&#8594;Associate
 leaves&quot;</strong> submenu allows a tree's view association to be changed to
 to any or all other views.</p>
-<p>The results of a <a href="../calculations/pca.html">PCA calculation</a> on a particular view
-may also be associated with other views, using the <strong>&quot;Associate
+<p>The results of a <a href="../calculations/pca.html">PCA
+calculation</a> on a particular view may also be associated with other
+views, using the PCA Viewer's <strong>&quot;View&#8594;Associate
 Nodes&quot;</strong> submenu.</p>
+<p>A <a href="pdbviewer.html">PDB Structure Viewer</a> opened on a
+structure associated with a sequence in a particular view will also, by
+default, only be associated with the sequence as it is displayed in that
+view. The &quot;View&#8594;Associate View&quot; submenu allows the
+association of alternative views.</p>
 <p><em>Multiple Views were introduced in Jalview 2.2</em></p>
 </body>
 </html>
index 110e21c..8fd671e 100644 (file)
@@ -4,10 +4,11 @@
 <strong>New Key Strokes and Menus</strong>
 <p>Many new <a href="../keys.html">keyboard shortcuts</a> have been
 added in Jalview 2.2 to make editing, selecting and navigating an
-alignment even easier. Some of the commands in the <strong>Edit</strong>
-and <strong>View</strong> menus present in earlier releases have also
-been moved into their own <strong>Select</strong> and <strong>Format</strong>
-menus. Some of the important new keystrokes are shown below :
+alignment even easier. The selection commands in the <strong>Edit</strong>
+menu, and the alignment formatting controls within the <strong>View</strong>
+menu have also been moved into their own respective <strong>Select</strong>
+and <strong>Format</strong> menus.</p>
+<p>Some of the most important new keystrokes are shown below :
 <ul>
        <li><strong>Page Up</strong> and <strong>Page Down</strong>
        scrolls through the alignment view.</li>
index bd240ea..97471a2 100755 (executable)
-<html>\r
-<head><title>PDB Viewer</title></head>\r
-<body>\r
-<p><strong>The PDB Viewer Window</strong>\r
-<p>This interactive structure viewing window is opened by selecting the\r
-<strong>&quot;Sequence&#8594;View PDB\r
-entry:&quot;</strong> entry in the <a\r
-href="../menus/popupMenu.html">sequence id pop-up menu</a>. This can only be\r
-done for sequences which have an <a href="viewingpdbs.html">associated\r
-PDB structure</a>.</p>\r
-<p><strong>Controls</strong></p>\r
-<p>The structure is rendered as an alpha-carbon trace. \r
-Moving the mouse over the structure brings up tooltips with a\r
-residue name and PDB sequence position. If a mapping exists to a\r
-residue in the associated sequence, then this will be highlighted in\r
-the alignment window, and vice versa for viewing the coordinates\r
-associated with a particular residue in the sequence.</p>\r
-<p>Selecting a residue highlights its associated sequence residue and\r
-alpha carbon location.</p>\r
-<p><table>\r
-<tr><td><strong>Action</strong></td><td><strong>Windows</strong></td><td><strong>Unix</strong></td><td><strong>Mac/OSX</strong></td></tr>\r
-<tr><td>Select/<br>Deselect<br>Residue</td><td>Left Click</td><td>Left\r
-Click</td><td>Click</td></tr>\r
-<tr><td>Rotate View</td><td>Left Click and Drag</td><td>Left Click and\r
-Drag</td><td>Click and Drag</td></tr>\r
-<tr><td>Roll View</td><td>Right Click and drag</td><td>Right Click and\r
-Drag</td><td>TODO</td></tr>\r
-<tr><td>Move Origin</td><td>Middle-Button and\r
-Drag</td><td>Middle-Button and Drag</td><td>TODO</td></tr>\r
-<tr><td>Zoom In</td><td>Up Arrow</td><td>Up Arrow</td><td>Up\r
-Arrow</td></tr>\r
-<tr><td>Zoom Out</td><td>Down Arrow</td><td>Down Arrow</td><td>Down Arrow</td></tr>\r
-</table>\r
-</p>\r
-<p>There are three menus:\r
-<ul>\r
-<li><Strong>File<br></strong><ul>\r
-<li><strong>Save As<br></strong><em>Saves the current view as an EPS or PNG file.</em>\r
-</li>\r
-<li><strong>View Mapping<br></strong><em>\r
-Opens a text window showing the alignment between the residues\r
-corresponding to alpha-carbon atoms in the PDB structure and the\r
-residues in the associated sequence.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-<li><strong>Colours<br></strong><ul>\r
-<li><strong>By Sequence<br></strong><em>\r
-Colours each residue in the structure with the colour of its\r
-corresponding residue in the associated sequence as rendered in the\r
-alignment window, including any Uniprot sequence features or region\r
-colourings.<br>Residues which only exist in the PDB structure are\r
-coloured white if they are insertions (relative to the associated\r
-sequence in the alignment) and grey if they are N or C terminal\r
-flanks outside the region mapped to the alignment window's sequence.</em></li>\r
-<li><strong>By Chain<br></strong><em>\r
-Assigns a random colour to each PDB chain.</em>\r
-<li><strong>Charge &amp; Cysteine<br></strong><em>\r
-Highlights cysteines in yellow, anionic (Aspartic Acid or Glutamic Acid) residues in red, and\r
-cationic (Lysine or Arginine) residues in blue.</em>\r
-</li>\r
-<li><strong><em>Standard and User Defined Jalview colourschemes.<br></em></strong>\r
-The remaining entries apply the colourschemes available from the\r
-standard and user defined <a href="../colourSchemes/index.html">amino acid colours</a>.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-<li><strong>View<br></strong><em>\r
-These options can be turned off to improve performance when viewing\r
-large structures, some at the expense of visual clarity.</em><ul>\r
-<li><strong>Wireframe<br></strong><em>\r
-Draws thin lines rather than thick lines for the\r
-alpha-carbon trace.</em>\r
-</li><li><strong>Depthcue<br></strong><em>Shades the structure so parts of the structure near\r
-the front of the view are brighter than those further away.</em>\r
-</li><li><strong>Z Buffering<br></strong><em>\r
-Applies depth sorting to correctly render occluded regions of the\r
-backbone trace.</em>\r
-</li>\r
-<li><strong>Show All Chains<br></strong><em>\r
-When turned on, shows all chains in the PDB file, not just the one\r
-associated with a sequence in the alignment window.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-</ul>\r
-</p>\r
-<p><strong>Notes for PDB Viewing in the Jalview Applet</strong>\r
-<p>The applet can only load PDB files by copying and pasting the text into \r
-  the popup window which appears when &quot;Show PDB Structure&quot; is selected \r
-  after right clicking on a sequence name.</p>\r
-</body>\r
-</html>\r
+<html>
+<head>
+<title>PDB Viewer</title>
+</head>
+<body>
+<p><strong>The PDB Viewer Window</strong>
+<p>This interactive structure viewing window is opened by selecting
+the <strong>&quot;Sequence&#8594;View PDB entry:&quot;</strong> entry in
+the <a href="../menus/popupMenu.html">sequence id pop-up menu</a>. This
+can only be done for sequences which have an <a href="viewingpdbs.html">associated
+PDB structure</a>.</p>
+<p><strong>Controls</strong></p>
+<p>The structure is rendered as an alpha-carbon trace. Moving the
+mouse over the structure brings up tooltips with a residue name and PDB
+sequence position. If a mapping exists to a residue in the associated
+sequence, then this will be highlighted in the associated view in its
+alignment window, and vice versa for viewing the coordinates associated
+with a particular residue in the sequence in a particular view on the
+alignment.</p>
+<p>Selecting a residue highlights its associated sequence residue
+and alpha carbon location.</p>
+<p>
+<table>
+       <tr>
+               <td><strong>Action</strong></td>
+               <td><strong>Windows</strong></td>
+               <td><strong>Unix</strong></td>
+               <td><strong>Mac/OSX</strong></td>
+       </tr>
+       <tr>
+               <td>Select/<br>
+               Deselect<br>
+               Residue</td>
+               <td>Left Click</td>
+               <td>Left Click</td>
+               <td>Click</td>
+       </tr>
+       <tr>
+               <td>Rotate View</td>
+               <td>Left Click and Drag</td>
+               <td>Left Click and Drag</td>
+               <td>Click and Drag</td>
+       </tr>
+       <tr>
+               <td>Roll View</td>
+               <td>Right Click and drag</td>
+               <td>Right Click and Drag</td>
+               <td>TODO</td>
+       </tr>
+       <tr>
+               <td>Move Origin</td>
+               <td>Middle-Button and Drag</td>
+               <td>Middle-Button and Drag</td>
+               <td>TODO</td>
+       </tr>
+       <tr>
+               <td>Zoom In</td>
+               <td>Up Arrow</td>
+               <td>Up Arrow</td>
+               <td>Up Arrow</td>
+       </tr>
+       <tr>
+               <td>Zoom Out</td>
+               <td>Down Arrow</td>
+               <td>Down Arrow</td>
+               <td>Down Arrow</td>
+       </tr>
+</table>
+</p>
+<p>There are three menus:
+<ul>
+       <li><Strong>File<br>
+       </strong>
+       <ul>
+               <li><strong>Save As<br>
+               </strong><em>Saves the current view as an EPS or PNG file.</em></li>
+               <li><strong>View Mapping<br>
+               </strong><em> Opens a text window showing the alignment between the
+               residues corresponding to alpha-carbon atoms in the PDB structure and
+               the residues in the associated sequence.</em></li>
+       </ul>
+       </li>
+       <li><strong>Colours<br>
+       </strong>
+       <ul>
+               <li><strong>By Sequence<br>
+               </strong><em> Colours each residue in the structure with the colour of its
+               corresponding residue in the associated sequence as rendered in the
+               associated alignment view, including any Uniprot sequence features or
+               region colourings.<br>
+               Residues which only exist in the PDB structure are coloured white if
+               they are insertions (relative to the associated sequence in the
+               alignment) and grey if they are N or C terminal flanks outside the
+               region mapped to the alignment window's sequence.</em></li>
+               <li><strong>By Chain<br>
+               </strong><em> Assigns a random colour to each PDB chain.</em>
+               <li><strong>Charge &amp; Cysteine<br>
+               </strong><em> Highlights cysteines in yellow, anionic (Aspartic Acid or
+               Glutamic Acid) residues in red, and cationic (Lysine or Arginine)
+               residues in blue.</em></li>
+               <li><strong><em>Standard and User Defined Jalview
+               colourschemes.<br>
+               </em></strong> The remaining entries apply the colourschemes available from the
+               standard and user defined <a href="../colourSchemes/index.html">amino
+               acid colours</a>.</em></li>
+       </ul>
+       </li>
+       <li><strong>View<br>
+       </strong><em> These options can be turned off to improve performance when
+       viewing large structures, some at the expense of visual clarity.</em>
+       <ul>
+               <li><strong>Wireframe<br>
+               </strong><em> Draws thin lines rather than thick lines for the
+               alpha-carbon trace.</em></li>
+               <li><strong>Depthcue<br>
+               </strong><em>Shades the structure so parts of the structure near the front
+               of the view are brighter than those further away.</em></li>
+               <li><strong>Z Buffering<br>
+               </strong><em> Applies depth sorting to correctly render occluded regions
+               of the backbone trace.</em></li>
+               <li><strong>Show All Chains<br>
+               </strong><em> When turned on, shows all chains in the PDB file, not just
+               the one associated with a sequence in the alignment window.</em></li>
+               <li><strong>Associate View</strong><br>
+               Change which view on the associated sequence's alignment is to be
+               associated with the PDB viewer.
+       </ul>
+       </li>
+</ul>
+</p>
+<p><strong>Notes for PDB Viewing in the Jalview Applet</strong>
+<p>The applet can only load PDB files by copying and pasting the
+text into the popup window which appears when &quot;Show PDB
+Structure&quot; is selected after right clicking on a sequence name.</p>
+</body>
+</html>
index d57de42..094fcbb 100755 (executable)
@@ -1,48 +1,57 @@
-<html>\r
-<head><title>Input/Output</title></head>\r
-<body>\r
-<p><strong>Input</strong></p>\r
-<p>Jalview can read alignment files in any of the following standard formats:</p>\r
-<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,\r
-NBRF/PIR (including MODELLER variant), Pfam/Stockholm</em></p>\r
-<p>The EBI has <a href="http://www.ebi.ac.uk/help/formats.html">examples</a> of\r
-  these file formats.</p>\r
-<p>Additionally, annotated whole sets of alignments and trees can be\r
-read from a <a href="../features/jalarchive.html">Jalview (jar)\r
-format</a> file using <strong>Desktop&#8594;Load\r
-Project</strong>. </p>\r
-<p>Use the <strong>Desktop&#8594;Input Alignment</strong> menu to read in files from:</p>\r
-<ul>\r
-  <li><strong>From File</strong>: the local file system</li>\r
-  <li><strong>From URL</strong>: the web (please use the full url)</li>\r
-  <li><strong>from Textbox</strong>: a copy and paste into the\r
-  &quot;Cut &amp; Paste&quot; text window</li>\r
-</ul>\r
-<p>Jalview will try to recognise the file type automatically (using\r
-some special <a href="fileformats.html">features</a>). If a\r
-file is of an unknown format or there is any other error reading the\r
-alignment file then you will be given an error message. If you think\r
-Jalview really should be able to read your file, then send an email\r
-containing the problem file to jalview@jalview.org.\r
-</p>\r
-<p>Jalview can also read jalview specific files for <a href="../features/featuresFormat.html">sequence features</a>\r
-and <a href="../features/annotationsFormat.html">alignment annotation</a>.</p>\r
-<p><strong>Output</strong> </p>\r
-<p>Each alignment, whether it is the original or an edited version may be saved\r
-  in the standard formats using <strong>File&#8594;Save As</strong></p>\r
-<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file, NBRF/PIR, Pfam/Stockholm</em></p>\r
-Jalview will by default append the sequence start and end to each sequence name, \r
-in the format /start-end. If you do not want this behaviour for a particular file \r
-output, open the &quot;Output&quot; tab on the <a href="../features/preferences.html">Preferences</a> window where you can \r
-select which file formats you want to append the start and end sequence positions \r
-for. In the case of PIR format, the output tab also contains a switch\r
-for turning on the output of Modeller style structured description\r
-lines.\r
-<p>Quantitative and symbolic <a href="../features/annotation.html">alignment annotation</a> can be exported as a\r
-comma separated value file by right clicking on an annotation row\r
-under the alignment.</p>\r
-<p>You can also save the current set of alignments and their colours, annotations and\r
-trees in a Jalview archive file using <strong>Desktop&#8594;Save project</strong>. </p>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<head>
+<title>Input/Output</title>
+</head>
+<body>
+<p><strong>Input</strong></p>
+<p>Jalview can read alignment files in any of the following standard
+formats:</p>
+<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
+NBRF/PIR (including MODELLER variant), Pfam/Stockholm</em></p>
+<p>The EBI has <a href="http://www.ebi.ac.uk/help/formats.html">examples</a>
+of these file formats.</p>
+<p>Additionally, whole sets of coloured and annotated alignments and
+trees can be read from a <a href="../features/jalarchive.html">Jalview
+(jar) format</a> file using <strong>Desktop&#8594;Load Project</strong>.</p>
+<p>Press &quot;Control O&quot; to open a file browser, or use
+the <strong>Desktop&#8594;Input Alignment</strong> menu to read in
+alignments from:</p>
+<ul>
+       <li><strong>From File</strong>: the local file system</li>
+       <li><strong>From URL</strong>: the web (please use the full url)</li>
+       <li><strong>from Textbox</strong>: a copy and paste into the
+       &quot;Cut &amp; Paste&quot; text window</li>
+</ul>
+<p>Jalview will try to recognise the file type automatically (using
+some special <a href="fileformats.html">features</a>). If a file is of
+an unknown format or there is any other error reading the alignment file
+then you will be given an error message. If you think Jalview really
+should be able to read your file, then send an email containing the
+problem file to jalview@jalview.org.</p>
+<p>Jalview can also read jalview specific files for <a
+       href="../features/featuresFormat.html">sequence features</a> and <a
+       href="../features/annotationsFormat.html">alignment annotation</a>.</p>
+<p><strong>Output</strong></p>
+<p>Each alignment, whether it is the original or an edited version
+may be saved in the standard formats using <strong>File&#8594;Save
+As</strong></p>
+<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
+NBRF/PIR, Pfam/Stockholm</em></p>
+Jalview will by default append the sequence start and end to each
+sequence name, in the format /start-end. If you do not want this
+behaviour for a particular file output, open the &quot;Output&quot; tab
+on the
+<a href="../features/preferences.html">Preferences</a>
+window where you can select which file formats you want to append the
+start and end sequence positions for. In the case of PIR format, the
+output tab also contains a switch for turning on the output of Modeller
+style structured description lines.
+<p>Quantitative and symbolic <a href="../features/annotation.html">alignment
+annotation</a> can be exported as a comma separated value file by right
+clicking on an annotation row under the alignment.</p>
+<p>You can also save the current set of alignments and their
+colours, annotations and trees in a Jalview archive file using <strong>Desktop&#8594;Save
+project</strong>.</p>
+<p>&nbsp;</p>
+</body>
+</html>
index 376792f..0795189 100755 (executable)
                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. <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>
index eb45924..bf1fed5 100755 (executable)
        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>
+       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>
        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
+       </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. <br>
+       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>
@@ -47,8 +50,8 @@
        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
+       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>
index 03d764a..cd1fd78 100755 (executable)
@@ -1,18 +1,22 @@
 <html>
-<head><title>Menus</title></head>
+<head>
+<title>Jalview's Menus</title>
+</head>
 
 <body>
-<p><strong>Menus</strong></p>
-<p>Menus are used in 3 places in Jalview - the &quot;Desktop Menu&quot;, the &quot;Alignment 
-  Menu&quot; and the &quot;Popup Menu&quot;.</p>
-<p>The <a href="desktopMenu.html">Desktop Menu</a> is always visible and is the 
-  starting point for loading new alignments.</p>
-<p>The <a href="alignmentMenu.html">Alignment Menu</a> is visible once and alignment 
-  has been opened.</p>
-<p>The <a href="popupMenu.html">Popup Menu</a> is made visible by clicking with 
-  the right mouse button on a sequence or the name of a sequence in an alignment 
-  window. </p>
-  <p>The <a href="alwannotations.html">Annotations Menu</a> is opened by right-clicking on an annotation row label.</p>
+<p><strong>Jalview's Menus</strong></p>
+<p>Menus are used in 3 places in Jalview - the &quot;Desktop
+Menu&quot;, the &quot;Alignment Menu&quot; and the &quot;Popup
+Menu&quot;.</p>
+<p>The <a href="desktopMenu.html">Desktop Menu</a> is always visible
+and is the starting point for loading new alignments.</p>
+<p>The <a href="alignmentMenu.html">Alignment Window Menus</a> are
+accessible once an alignment has been opened.</p>
+<p>The <a href="popupMenu.html">Popup Menus</a> are opened by
+clicking with the right mouse button in the alignment display area or on
+a sequence label in the alignment window.</p>
+<p>The <a href="alwannotations.html">Annotations Menu</a> is opened
+by right-clicking on an annotation row label or in an annotation row.</p>
 
 </body>
 </html>
index f885bd8..2c50c02 100755 (executable)
@@ -110,10 +110,7 @@ not be accessible when in 'Cursor Mode' (toggled with the F2 key).</em></p>
        </ul>
        </li>
        <li><strong>Hide Sequences</strong><br>
-       <em>This menu item lists all links which have been set up in the <a
-               href="../features/preferences.html">Preferences</a> Connections tab.
-       It is only displayed when you right click (Apple click) on a sequence
-       id. </em><strong><br>
+       <em>Hides the currently selected seuqences in this alignment view.</em><strong><br>
        <br>
        </strong></li>
 </ul>
index 344c322..651292e 100755 (executable)
@@ -1,54 +1,50 @@
 <html>
-<head><title>What's new ?</title></head>
+<head>
+<title>What's new ?</title>
+</head>
 <body>
-<p><strong>What's new ?</strong> </p>
+<p><strong>What's new ?</strong></p>
 
 <p><strong>Jalview Version 2.2</strong></p>
-<p>Multiple views with different styles, colours, hidden regions for one alignment
-</p>
-<p>Easily add, amend and delete sequence features
-</p>
-<p>&quot;Reload&quot; alignment from File or URL to revert to original
-</p>
-<p>&quot;Save&quot; to current filename or &quot;Save As&quot; to new filename
-</p>
-<p>Set different text colour for dark or light background
-</p>
-<p>Right align sequence ids
-</p>
+<p>Multiple views with different styles, colours, hidden regions for
+one alignment</p>
+<p>Easily add, amend and delete sequence features</p>
+<p>&quot;Reload&quot; alignment from File or URL to revert to
+original</p>
+<p>&quot;Save&quot; to current filename or &quot;Save As&quot; to
+new filename</p>
+<p>New <strong>&quot;New Window&quot;</strong> button on the
+&quot;Output To Textbox&quot; opens output window for quick 'sequence
+editing'.</p>
+<p>Set different text colour for dark or light background</p>
+<p>Right align sequence ids</p>
 <p>Set colour of lower case residues in a user defined colour scheme
 </p>
-<p>Menu Rearrangements: New <strong>Format</strong> for alignment layout and <strong>Select</strong> for region selection.
-</p>
-</p><p>Menu item accelerator keys added
-</p>
-<p>Control-V pastes sequences to active window, Control-Shift-V pastes to a new window.
-</p>
-<p>Raise/Minimise alignment and all associated windows from desktop window's <strong>window</strong> menu
+<p>Menu Rearrangements: New <strong>Format</strong> for alignment
+layout and <strong>Select</strong> for region selection.</p>
 </p>
+<p>Menu item accelerator keys added</p>
+<p>Control-V pastes sequences to active window, Control-Shift-V
+pastes to a new window.</p>
+<p>Raise/Minimise alignment and all associated windows from desktop
+window's <strong>window</strong> menu</p>
 <p>Select and colour whole branches of a tree</p>
 <p>'New Window' button on the 'Output to Text box' alignment output
 option to open a new alignment window after editing.</p>
 <p><strong>Issues Resolved</strong></p>
 </p>
-<p>
-Optimisations for large alignments: faster multithreaded calculations and Undo/Redo system.
-</p>
+<p>Optimisations for large alignments: faster multithreaded
+calculations and Undo/Redo system.</p>
 <p>Remove empty columns - if empty columns exist at the end of the
-alignment bug fixed.
-</p>
-<p>DAS feature fetching slowed down, doesn't overload DAS servers
-</p>
-<p>DAS feature fetching can be cancelled
-</p>
-<p>Correct display of &gt; and &lt; symbols for feature descriptions without explicit &lt;html&gt; tags.
-</p>
-<p>Zoom working in PCA viewer
-</p>
-<p>Sequence Descriptions retained after running a web service
-</p>
+alignment bug fixed.</p>
+<p>DAS feature fetching slowed down, doesn't overload DAS servers</p>
+<p>DAS feature fetching can be cancelled</p>
+<p>Correct display of &gt; and &lt; symbols for feature descriptions
+without explicit &lt;html&gt; tags.</p>
+<p>Zoom working in PCA viewer</p>
+<p>Sequence Descriptions retained after running a web service</p>
 <p>&nbsp;</p>
-<p>See the <a href="releases.html">Release History</a> page for details of all
-  new features and resolved issues. </p>
+<p>See the <a href="releases.html">Release History</a> page for
+details of all new features and resolved issues.</p>
 </body>
 </html>