JAL-1683 replace year/version strings with tokens in source
[jalview.git] / help / html / whatsNew.html
index d66c14c..3ee9b32 100755 (executable)
-<html>\r
-<head><title>What's new ?</title></head>\r
-<body>\r
-<p><strong>What's new ?</strong> </p>\r
-<p>If you are reading this then you will already have seen some of the recent changes\r
-  made to Jalview.<br>\r
-  Jalview takes advantage of some of the more recent user interface developments\r
-  in the Java programming language. For instance Jalview is now a multi windowed\r
-  application, this keeps all your Jalview windows neatly together in one main\r
-  application window. </p>\r
-<p>If you were familiar with the original Jalview, here is a list of important\r
-  features you should know about the current development:</p>\r
-<ul>\r
-  <li>Editing sequences is no longer the default when mouse clicking the alignment.\r
-    Instead, mouse clicking on the alignment creates a &quot;selection region&quot;\r
-    which may be full sequences or groups of residues.</li>\r
-  <li>To insert or edit the gaps in one sequence in alignment, the &quot;Shift&quot;\r
-    key must be held down when dragging the mouse.</li>\r
-  <li>To insert or edit gaps for a group of sequences, the &quot;Alt&quot; key\r
-    (or in X windows the &quot;Control&quot; key) must be held down.</li>\r
-  <li>Selecting colour schemes in the colour menu either sets just the &quot;background&quot;\r
-    colourscheme for the alignment, or - when the tickbox &quot;Apply colour to\r
-    all groups&quot; is ticked, applies the scheme to the background and all groups\r
-    defined on the alignment.</li>\r
-  <li>Use the right mouse button (apple and click on the Mac) whilst the pointer\r
-    is within the selection area to access the &quot;define&quot; region menu\r
-    to define a new region, give it a name, and change its colourscheme and display\r
-    properties.</li>\r
-  <li>Conservation is automatically updated whenever the alignment is edited</li>\r
-  <li>There is no &quot;quick draw&quot; option</li>\r
-  <li>Edits can be undone, and redone!</li>\r
-</ul>\r
-<table border="1">\r
-  <tr>\r
-    <td><div align="center"><em><strong>Release</strong></em></div></td>\r
-    <td><div align="center"><em><strong>New Features</strong></em></div></td>\r
-    <td><div align="center"><em><strong>Issues Resolved</strong></em></div></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.06</strong><br>\r
-        28/9/05</div></td>\r
-    <td><ul>\r
-        <li>View annotations in wrapped mode</li>\r
-        <li>More options for PCA viewer</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>GUI bugs resolved</li>\r
-        <li>Runs with -nodisplay from command line</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.05b</strong><br>\r
-        15/9/05</div></td>\r
-    <td><ul>\r
-        <li>Choose EPS export as lineart or text</li>\r
-        <li>Jar files are executable</li>\r
-        <li>Can read in Uracil - maps to unknown residue</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Known OutOfMemory errors give warning message</li>\r
-        <li>Overview window calculated more efficiently</li>\r
-        <li>Several GUI bugs resolved</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.05</strong><br>\r
-        30/8/05</div></td>\r
-    <td><ul>\r
-        <li>Edit and annotate in &quot;Wrapped&quot; view</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Several GUI bugs resolved</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.04</strong><br>\r
-        24/8/05</div></td>\r
-    <td><ul>\r
-        <li>Hold down mouse wheel &amp; scroll to change font size</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Improved JPred client reliability</li>\r
-        <li>Improved loading of Jalview files</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.03</strong><br>\r
-        18/8/05</div></td>\r
-    <td><ul>\r
-        <li>Set Proxy server name and port in preferences</li>\r
-        <li>Multiple URL links from sequence ids</li>\r
-        <li>User Defined Colours can have a scheme name and added to Colour Menu</li>\r
-        <li>Choose to ignore gaps in consensus calculation</li>\r
-        <li>Unix users can set default web browser</li>\r
-        <li>Runs without GUI for batch processing</li>\r
-        <li>Dynamically generated Web Service Menus</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>InstallAnywhere download for Sparc Solaris</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.02</strong><br>\r
-        18/7/05</div></td>\r
-    <td>&nbsp;</td>\r
-    <td><ul>\r
-        <li>Copy &amp; Paste order of sequences maintains alignment order.</li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td><div align="center"><strong>2.01</strong><br>\r
-        12/7/05</div></td>\r
-    <td><ul>\r
-        <li>Use delete key for deleting selection.</li>\r
-        <li>Use Mouse wheel to scroll sequences.</li>\r
-        <li>Help file updated to describe how to add alignment annotations.</li>\r
-        <li>Version and build date written to build properties file.</li>\r
-        <li>InstallAnywhere installation will check for updates at launch of Jalview.</li>\r
-      </ul></td>\r
-    <td><ul>\r
-        <li>Delete gaps bug fixed.</li>\r
-        <li>FileChooser sorts columns.</li>\r
-        <li>Can remove groups one by one.</li>\r
-        <li>Filechooser icons installed.</li>\r
-        <li>Finder ignores return character when searching. Return key will initiate\r
-          a search.<br>\r
-        </li>\r
-      </ul></td>\r
-  </tr>\r
-  <tr>\r
-    <td> <div align="center"><strong>2.0</strong><br>\r
-        20/6/05</div></td>\r
-    <td ><ul>\r
-        <li> New codebase</li>\r
-      </ul></td>\r
-    <td >&nbsp;</td>\r
-  </tr>\r
-</table>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ * 
+ * This file is part of Jalview.
+ * 
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License 
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *  
+ * Jalview is distributed in the hope that it will be useful, but 
+ * WITHOUT ANY WARRANTY; without even the implied warranty 
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
+ * PURPOSE.  See the GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>What's new ?</title>
+</head>
+<body>
+       <p>
+               <strong>What's new ?</strong>
+       </p>
+       <p>
+               Jalview 2.8.2 is the first release produced by our new core
+               development team.<br /> It incorporates many minor improvements and
+               bug-fixes, and new features for working with 3D structure data,
+               shading alignments by secondary structure and generation of alignment
+               figures as Scalable Vector Graphics. <br />The majority of
+               improvements in this version of Jalview concern the desktop
+               application. As ever, the highlights are detailed below,
+               and the full list is given in the <a
+                       href="releases.html#Jalview.2.8.2">Jalview 2.8.2 Release Notes</a>.
+       </p>
+       <p>
+               <strong>Annotation visualisation</strong> <br /> The alignment window
+               includes a new <em>Annotations</em> menu which provides controls for
+               the layout and display of sequence, group and alignment associated
+               annotation rows. It also now includes the <em>Autocalculated
+                       Annotation</em> submenu (formerly located in the View menu), which
+               includes settings for the calculation and display of sequence
+               consensus, logos, and amino acid conservation for the alignment and
+               subgroups.
+       </p>
+       <p>
+               <strong>Sequence associated annotation</strong><br /> New controls
+               have also been added to the Sequence ID popup menu for the propagation
+               and display of sequence associated annotation such as secondary
+               structure assignments and disorder predictions. Annotation associated
+               with one or a group of sequence already shown on the alignment may be
+               shown or hidden, and any available annotation from 3D structure or
+               calculations performed in other Jalview windows can be copied to the
+               alignment
+               <em>via</em> the <strong>Add Reference Annotation</strong> option.<br />
+               The <strong>Colour by annotation</strong> function has also been
+               improved, allowing secondary structure annotation to be used to shade
+               sequences and alignment columns. Protein sequences can be coloured
+               according to the presence of a helix or sheet at each position, and
+               RNA sequences can be shaded according to each structure's stem/helix
+               pattern - which enables different RNA folding topologies to be quickly
+               identified.
+       </p>
+       <p>
+               <strong>3D Structural data analysis and display</strong><br />
+               Jalview now employs Jmol's PDB data API to retrieve secondary
+               structure assignments made by the DSSP algorithm. It can also employ
+               web services to obtain secondary structure assignments from RNA
+               structures. These assignments are shown as sequence associated
+               annotation for sequences which have cross-references to the PDB, or
+               have had PDB files associated with them via the <em>Structures</em>
+               submenu of the sequence ID popup menu. The extraction and display of
+               secondary structure and B-factor column annotation is controlled <em>via</em>
+               a new <strong>Structure</strong> tab in the Jalview Desktop's
+               Preferences dialog box.
+       </p>
+       <p>
+               <Strong>Interoperation with UCSF Chimera</Strong><br /> The desktop
+               application can now be configured to employ UCSF Chimera for the
+               display of 3D structure data. UCSF Chimera is a python-based
+               high-performance molecular graphics and animation system developed by
+               the Resource for Biocomputing, Visualisation, and Informatics at the
+               University of California.<br />Jalview employs the 'StructureViz'
+               communication mechanism developed for Cytoscape by Morris et al.
+               (http://www.ncbi.nlm.nih.gov/pubmed/17623706) in 2007. This mechanism
+               allows Jalview to send commands to Chimera, enabling structures to be
+               superimposed and shaded according to associated multiple aligmment
+               views. <br />Support for Chimera in Jalview 2.8.2 is experimental, and we
+               would appreciate feedback ! Please send your comments to
+               jalview-discuss@jalview.org, and keep up to date with this feature's
+               development via http://issues.jalview.org/browse/JAL-1333.
+       </p>
+       <p>
+               <strong>Export of alignment figures as Scalable Vector
+                       Graphics</strong> <br />Scalable Vector Graphics (SVG) files are now widely
+               supported by web browsers and graphics design programs, and allow
+               high-quality graphics for interactive exploration and publication.
+               Jalview now supports the generation of SVGs interactively (via the
+               Export) menu, and from the command line for server-side figure
+               generation.
+       </p>
+
+</body>
+</html>