JAL-3111 JAL-3150 revised Jalview archive documentation and noted instructions about...
authorJim Procter <jprocter@issues.jalview.org>
Tue, 2 Jul 2019 22:30:52 +0000 (23:30 +0100)
committerJim Procter <jprocter@issues.jalview.org>
Tue, 2 Jul 2019 22:30:52 +0000 (23:30 +0100)
help/help/html/features/jalarchive.html

index 94180a6..ef6cb4f 100755 (executable)
     <strong>Jalview Project Archives</strong>
   </p>
 
-  <p>These are java archives of an XML file containing alignments,
-    trees and Jalview display information. A data exchange standard is
-    currently being developed, so there is no stable schema yet, but
-    Jalview web services will soon make use of the same interchange
-    format.</p>
+  <p>These are Zip archives of an XML file containing alignments,
+    trees, Principal Component Analyses (since 2.11.0), 3D structures,
+    and display information for Jalview, VARNA, Jmol and UCSF Chimera.
+    XML documents conform to a schema, and changes to the format are
+    made to ensure future versions of Jalview will be able to read old
+    Jalview project files.</p>
   <p>
-    For those who want to know...<br> Jalview uses java classes
-    automatically created using <a href="http://www.castor.org">Castor</a>.
-    Jalview 2.08 uses descriptor classes which significantly increase
-    the speed of marshalling / unmarshalling java objects into XML.
-    Files created prior to Jalview 2.08 can still be read in, but they
-    will be saved in the new format.
+    <em>For those who want to know...</em><br> Jalview 2.11.0
+    onwards employ the JAX-B java to XML binding framework to read and
+    write Jalview project files. Earlier versions of Jalview employed <a
+      href="http://www.castor.org">Castor</a>. Jalview 2.08 used
+    descriptor classes which significantly increase the speed of
+    marshalling / unmarshalling java objects into XML. <br /> <br />
+    Files created prior to Jalview 2.08 can no longer be read by Jalview
+    2.11.0. If you need to import old project files, then please import
+    them to Jalview 2.10.5 (available from the Jalview version archive)
+    and save the project again to convert it to the new format.
   </p>
 </body>
 </html>