doc/index.html

   1 <!DOCTYPE html SYSTEM "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
   2 <html xmlns="http://www.w3.org/1999/xhtml">\r
   3 <head>\r
   4 Jalview Source Documentation\r
   5 </head>\r
   6 <body>\r
   7 <h1>Jalview Source Documentation</h1>\r
   8 <p>The file structure of the Jalview Source tree is as follows:\r
   9 <ul>\r
  10         <li>README - basic info for getting started with the source tree.</li>\r
  11         <li>LICENCE - the GPL Licence</li>\r
  12         <li>RELEASE - contains the name of the tag for the latest\r
  13         'official' Jalview release associated with the source.</li>\r
  14         <li>build.xml - ant build for jalview - the 'help' task gives\r
  15         information about each task, and there's lots of comments too.</li>\r
  16         <li></li>\r
  17         <li>src - all jalview source packages, including any specially\r
  18         adapted code from other GPL programs. See <a href="developing.html">Jalvew\r
  19         Development</a> for more info.</li>\r
  20         <li>lib - All the libraries that Jalview depends on. Every jar\r
  21         file in this directory should be added to the classpath when building\r
  22         or running the jalview application.</li>\r
  23         <li>help - the jalview JavaHelp documents<br>\r
  24         <ul>\r
  25                 <li>help.hs - the main index page. This is generated by the\r
  26                 jhindexer program run by the 'buildindices' task in build.xml</li>\r
  27                 <li>help.jhm - helpTOC map - an XML document listing simple names\r
  28                 for each html page that is linked to in the help contents structure.</li>\r
  29                 <li>helpTOC.xml - the table of contents presented to the user\r
  30                 when the help is opened.</li>\r
  31                 <li>icons - widgets needed for the help system GUI</li>\r
  32                 <li>html - the help documentation. It loosely follows the\r
  33                 following structure: <br>\r
  34                 <ul>\r
  35                         <li>calculations - pages concerning the calculations menu</li>\r
  36                         <li>webServices - pages describing web services</li>\r
  37                         <li>colourSchemes - the ways amino acids can be coloured and the\r
  38                         user interface for defining them</li>\r
  39                         <li>editing - mechanisms and interfaces for editing alignments</li>\r
  40                         <li>features - used to be the sequence features documentation,\r
  41                         but now contains all sorts of jalview 'features'.</li>\r
  42                         <li>io - getting data in and out of jalview</li>\r
  43                         <li>menus - all the menus in Jalview (and the applet)</li>\r
  44                         <li>misc - useful info</li>\r
  45                         <li>By convention, we try to maintain the whatsNew.html document\r
  46                         with each release and complete the releases.html matrix to detail\r
  47                         what has changed from one version to another.</li>\r
  48                         <li>keys.html contains all the keystrokes in Jalview - please\r
  49                         keep this up to date.</li>\r
  50                 </ul>\r
  51                 </li>\r
  52         </ul>\r
  53         </li>\r
  54         <li>resources - files needed at run-time for jalview execution.<br>\r
  55         <ul>\r
  56                 <li>images - icons used by jalview</li>\r
  57                 <li>log4j and commons-logging.properties - configure default\r
  58                 appenders and logging for Jalview, castor.</li>\r
  59                 <li>embl_mapping.xml - castor mapping file for the EMBL XML\r
  60                 Schema.</li>\r
  61                 .\r
  62                 <li>uniprot_mapping.xml - castor mapping file for the Uniprot XML\r
  63                 Schema.</li>\r
  64         </ul>\r
  65         </li>\r
  66         <li>schemas - XML schema definitions used or understood by\r
  67         Jalview.<br>\r
  68         Jalview uses castor to bind java to XML - either using mapping files\r
  69         hand-crafted from a schema in this directory, or from java objects\r
  70         generated from the schema and an associated set of properties. <br>\r
  71         See the castorbinding task in the ant build.xml file for more info.\r
  72         <ul>\r
  73                 <li>Jalview Project Archive XML Version 1<br>\r
  74                 vamsasJvV1.xsd<br>\r
  75                 jalviewJvV1.xsd<br>\r
  76                 jalview.nodesc.properties - sourcegenerator properties file</li>\r
  77                 <li>jalview Project Archive XML Version 2<br>\r
  78                 Jalview works out which version a project is by first trying\r
  79                 to parse XML with these schema definitions, and then if there are\r
  80                 problems, falls back to the V1 schema classes.\r
  81                 <ul>\r
  82                         <li>vamsas.xsd<br>\r
  83                         jalview.xsd<br>\r
  84                         jalview.properties - sourcegenerator properties file</li>\r
  85                 </ul></li>\r
  86                 <li>JalviewUserColours.xsd is used by both V1 and V2 project XML\r
  87                 definitions. This schema is also used to store user colour schemes\r
  88                 externally from the project file.</li>\r
  89         </ul>\r
  90         </li>\r
  91         <li>utils - various resources needed when building or deploying\r
  92         jalview.\r
  93         <ul>\r
  94                 <li>InstallAnywhere\r
  95                 <ul>\r
  96                         <li>Jalview.iap_xml is the InstallAnywhere XML project used to\r
  97                         create the Jalview InstallAnywhere distribution.</li>\r
  98                         <li>All the other files are bundled into this for installer\r
  99                         displays. The README_IA appears in the installation directory.</li>\r
 100                 </ul>\r
 101                 <li>jalopy<br>\r
 102                 This is a legacy directory - we intended to use jalopy for\r
 103                 standardising the jalview source formatting, but found it had a number\r
 104                 of bugs.</li>\r
 105                 <li>axis-ant.jar - tasks for constructing client skeletons from\r
 106                 WSDL documents.</li>\r
 107                 <li>roxes-ant-tasks-1.2-2004-01-30.jar - conditionals and other\r
 108                 useful ant tasks.</li>\r
 109                 <li>castor-*-codegen.jar and castor-*-anttask.jar - codegenerator\r
 110                 task and library for regenerating the Java classes from schemas. It is\r
 111                 important to update these and rebuild the source if the version of\r
 112                 castor that Jalview uses is updated.</li>\r
 113                 <li>gff2annot.pl - useful script to translate gff to jalview\r
 114                 features file format - although its not needed since Jalview can parse\r
 115                 GFF natively (normally at least).</li>\r
 116                 <li>jhall.jar, jhindexer.jar - the java help system and indexer\r
 117                 code to build the jalview help in the help directory.</li>\r
 118                 <li>proguard.jar - obfuscator used when creating\r
 119                 jalviewApplet.jar. See the build.xml file and the building jalview\r
 120                 documentation.</li>\r
 121         </ul>\r
 122         </li>\r
 123         <li>dist - where the Jars and JNLP file for the java webstart distribution is generated.</li>\r
 124         <li>installAnywhere - where the installAnywhere build is generated</li>\r
 125         <li><em>keys</em> - you might not have this - see <a\r
 126                 href="building.html">building</a> for info on how to create it.</li>\r
 127 </ul>\r
 128 </li>\r
 129 </ul>\r
 130 \r
 131 </body>\r
 132 </html>