get the html header comment right!
authorjprocter <Jim Procter>
Fri, 30 Apr 2010 15:11:37 +0000 (15:11 +0000)
committerjprocter <Jim Procter>
Fri, 30 Apr 2010 15:11:37 +0000 (15:11 +0000)
165 files changed:
doc/AddingGroovySupport.html
doc/building.html
doc/developing.html
doc/index.html
doc/newdmobj.html
help/html/calculations/consensus.html
help/html/calculations/conservation.html
help/html/calculations/pairwise.html
help/html/calculations/pca.html
help/html/calculations/quality.html
help/html/calculations/recoverInputdata.html
help/html/calculations/redundancy.html
help/html/calculations/sorting.html
help/html/calculations/tree.html
help/html/calculations/treeviewer.html
help/html/colourSchemes/abovePID.html
help/html/colourSchemes/annotationColouring.html
help/html/colourSchemes/blosum.html
help/html/colourSchemes/buried.html
help/html/colourSchemes/clustal.html
help/html/colourSchemes/conservation.html
help/html/colourSchemes/helix.html
help/html/colourSchemes/hydrophobic.html
help/html/colourSchemes/index.html
help/html/colourSchemes/nucleotide.html
help/html/colourSchemes/pid.html
help/html/colourSchemes/strand.html
help/html/colourSchemes/taylor.html
help/html/colourSchemes/textcolour.html
help/html/colourSchemes/turn.html
help/html/colourSchemes/user.html
help/html/colourSchemes/zappo.html
help/html/editing/index.html
help/html/features/annotation.html
help/html/features/annotationsFormat.html
help/html/features/clarguments.html
help/html/features/codingfeatures.html
help/html/features/commandline.html
help/html/features/creatinFeatures.html
help/html/features/cursorMode.html
help/html/features/dasfeatures.html
help/html/features/dassettings.html
help/html/features/editingFeatures.html
help/html/features/featuresFormat.html
help/html/features/featureschemes.html
help/html/features/featuresettings.html
help/html/features/groovy.html
help/html/features/hiddenRegions.html
help/html/features/jalarchive.html
help/html/features/jmol.html
help/html/features/multipleViews.html
help/html/features/newkeystrokes.html
help/html/features/overview.html
help/html/features/pdbviewer.html
help/html/features/preferences.html
help/html/features/search.html
help/html/features/seqfeatures.html
help/html/features/seqfetch.html
help/html/features/seqmappings.html
help/html/features/viewingpdbs.html
help/html/features/wrap.html
help/html/index.html
help/html/io/export.html
help/html/io/fileformats.html
help/html/io/index.html
help/html/io/modellerpir.html
help/html/jalviewjnlp.html
help/html/keys.html
help/html/memory.html
help/html/menus/alignmentMenu.html
help/html/menus/alwannotations.html
help/html/menus/alwcalculate.html
help/html/menus/alwcolour.html
help/html/menus/alwedit.html
help/html/menus/alwfile.html
help/html/menus/alwformat.html
help/html/menus/alwselect.html
help/html/menus/alwview.html
help/html/menus/desktopMenu.html
help/html/menus/index.html
help/html/menus/popupMenu.html
help/html/menus/wsmenu.html
help/html/misc/aaproperties.html
help/html/misc/aminoAcids.html
help/html/misc/geneticCode.html
help/html/privacy.html
help/html/vamsas/index.html
help/html/webServices/clustalw.html
help/html/webServices/dbreffetcher.html
help/html/webServices/index.html
help/html/webServices/jnet.html
help/html/webServices/mafft.html
help/html/webServices/msaclient.html
help/html/webServices/muscle.html
help/html/webServices/urllinks.html
utils/jalopy/docs/acknowledge.html
utils/jalopy/docs/bi01.html
utils/jalopy/docs/build.html
utils/jalopy/docs/comments.html
utils/jalopy/docs/contact.html
utils/jalopy/docs/contributors.html
utils/jalopy/docs/dedication.html
utils/jalopy/docs/dependencies.html
utils/jalopy/docs/docs.html
utils/jalopy/docs/download.html
utils/jalopy/docs/environment.html
utils/jalopy/docs/faq.html
utils/jalopy/docs/features.html
utils/jalopy/docs/footer.html
utils/jalopy/docs/header.html
utils/jalopy/docs/history.html
utils/jalopy/docs/imports.html
utils/jalopy/docs/indentation.html
utils/jalopy/docs/index.html
utils/jalopy/docs/inspector-naming.html
utils/jalopy/docs/inspector.html
utils/jalopy/docs/installation.html
utils/jalopy/docs/introduction.html
utils/jalopy/docs/ix01.html
utils/jalopy/docs/javadoc.html
utils/jalopy/docs/license-antlr.html
utils/jalopy/docs/license-apache.html
utils/jalopy/docs/license-bsd.html
utils/jalopy/docs/license-common-public.html
utils/jalopy/docs/license-gnu-doc.html
utils/jalopy/docs/license-gnu.html
utils/jalopy/docs/license-sun-public.html
utils/jalopy/docs/links.html
utils/jalopy/docs/manual.html
utils/jalopy/docs/messages.html
utils/jalopy/docs/misc.html
utils/jalopy/docs/part-core.html
utils/jalopy/docs/part-plugins.html
utils/jalopy/docs/plugin-ant-config.html
utils/jalopy/docs/plugin-ant-license.html
utils/jalopy/docs/plugin-ant-usage.html
utils/jalopy/docs/plugin-ant.html
utils/jalopy/docs/plugin-console-license.html
utils/jalopy/docs/plugin-console-usage.html
utils/jalopy/docs/plugin-console.html
utils/jalopy/docs/plugin-eclipse-integration.html
utils/jalopy/docs/plugin-eclipse-license.html
utils/jalopy/docs/plugin-eclipse.html
utils/jalopy/docs/plugin-jbuilder-integration.html
utils/jalopy/docs/plugin-jbuilder-license.html
utils/jalopy/docs/plugin-jbuilder.html
utils/jalopy/docs/plugin-jdev-integration.html
utils/jalopy/docs/plugin-jdev-license.html
utils/jalopy/docs/plugin-jdev.html
utils/jalopy/docs/plugin-jedit-integration.html
utils/jalopy/docs/plugin-jedit-license.html
utils/jalopy/docs/plugin-jedit.html
utils/jalopy/docs/plugin-netbeans-integration.html
utils/jalopy/docs/plugin-netbeans-license.html
utils/jalopy/docs/plugin-netbeans.html
utils/jalopy/docs/plugins.html
utils/jalopy/docs/printer.html
utils/jalopy/docs/project.html
utils/jalopy/docs/separation.html
utils/jalopy/docs/settings.html
utils/jalopy/docs/sorting.html
utils/jalopy/docs/usage.html
utils/jalopy/docs/whitespace.html
utils/jalopy/docs/wrapping.html
utils/jalopy/readme.html

index e18e273..275ddb0 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<title>Adding Groovy Support to Jalview
+</title>
+<body>
+<h1>
+Adding Groovy Support to Jalview
+</h1>
+<p>
+There is currently no scripting language 
+extension within Jalview, in part because a 
+scripting API has not yet been developed.
+</p>
+<p>It is, however, really easy to embed scripting
+engines like groovy. If groovy is detected on the 
+classpath, a new menu entry on the Desktop's Tools 
+menu will open the GroovyShell.
+</p>
+<p>Here are some scripts to get you started:</p>
+<ul><li>Getting the title, alignment and first sequence from the current alignFrame<br>
+<pre>
+def alf = Jalview.getAlignframes();
+print alf[0].getTitle();
+def alignment = alf[0].viewport.alignment;
+def seq = alignment.getSequenceAt(0);
+</pre>
+</li>
+</ul>
+<h1>Getting Groovy...</h1>
+<p>
+You need the core groovy jars which include the GroovyShell. The easiest way of doing
+this is to add the groovy-all-*.jar to the lib directory whose path is given in the java.ext.dirs property.</p>
+<p>The is obtained from the <em>embedded</em> directory within the <a 
+href="http://dist.codehaus.org/groovy/distributions"/>groovy distribution</a>).
+</p>
+<h2>TODO</h2>
+<p>
+Using Java class methods from Groovy is straightforward, but currently, there isn't a set of easy to use methods for the jalview objects. A Jalview Scripting API needs to be developed to make this easier.</p>
+<h3>Making it easier</h3>
+<p>jalview.bin.JalviewScript could be a top level jalview instance of a script execution thread, creating and maintaining the context for scripts operating on the jalview datamodel and interfacing with the Jalview GUI.
+</p> 
+</body>
+</html>
+
index e18e273..455251f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Building Jalview from Source</title>
+</head>
+<body>
+<h1>Building Jalview from Source</h1>
+<P>
+<p>
+You will need the following (hopefully):<br>
+<ul>
+<li>Java development kit (we used JDK1.4SE but JDK1.5 will work too,
+and maybe even jikes).
+<li>Ant (we think 1.5.4 is quite sufficient to use the simple build
+file supplied).
+</ul>
+With any luck, after setting your paths and JAVA_HOME correctly, you
+just need to change to the Jalview directory and run ant (this works
+from JBuilder and eclipse too).
+<pre>
+   ant
+</pre>
+
+</p>
+<p><strong>Building a webstart version of jalview</strong></p>
+Jalview depends on several libraries contained in the libs directory
+of the distribution.  In order to access them, they must all be signed
+jars - using the same jarsigner key as jalview itself. There is a
+build target in ant to make the signed jar files in a directory called
+dist. But first you need to make your own key:
+<p><strong>Making your own key</strong></p>
+
+<p>The ant 'makefulldist' target assumes that a keystore exists in a
+directory 'keys'. To make a key accessible using the default settings
+in the build.xml file then make the keys directory and add the
+jarsigner key with the following :
+</p>
+<pre>
+mkdir keys
+keytool -genkey -keystore keys/.keystore -keypass alignmentisfun
+-storepass alignmentisfun -alias jalview
+ (you will have to answer some personal questions here)
+ant makedist
+ (should eventually generate a Jalview.jnlp file
+  in ./dist along with a set of signed jars using the jalview
+  key)
+</pre>
+
+<p>
+
+<p>
+<address>
+<a href="mailto:help@jalview.org">Jalview development team</a>
+</address>
+</body>
+</html>
index 422b99a..4008a98 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">\r
+  <head>Developing Jalview</head>\r
+  <body>\r
+<p><h1>Developing Jalview</h1>\r
+</p>\r
+<ul>\r
+<li>Basic Source Structure Guidelines</li>\r
+<li>The Applet and The Application - whats the difference ?</li>\r
+<li>Package Architecture<br>\r
+</li>\r
+<li>Specific  Development Guidelines\r
+<ul>\r
+<li><a href="newdmobj.html">Adding new datamodel objects to Jalview</a></li>\r
+<li>Adding new IO capabilities to Jalview</li>\r
+<li>Adding new database types to Jalview</li>\r
+<li>Working with the Jalview DAS annotation fetcher</li>\r
+<li>Adding new analysis methods to jalview</li>\r
+<li>Adding new web service functionality to jalview</li>\r
+</ul>\r
+</li>\r
+</ul>\r
+</body>\r
+</html>\r
index 422b99a..c1e3718 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">\r
+<head>\r
+Jalview Source Documentation\r
+</head>\r
+<body>\r
+<h1>Jalview Source Documentation</h1>\r
+<p>The file structure of the Jalview Source tree is as follows:\r
+<ul>\r
+       <li>README - basic info for getting started with the source tree.</li>\r
+       <li>LICENCE - the GPL Licence</li>\r
+       <li>RELEASE - contains the name of the tag for the latest\r
+       'official' Jalview release associated with the source.</li>\r
+       <li>build.xml - ant build for jalview - the 'help' task gives\r
+       information about each task, and there's lots of comments too.</li>\r
+       <li></li>\r
+       <li>src - all jalview source packages, including any specially\r
+       adapted code from other GPL programs. See <a href="developing.html">Jalvew\r
+       Development</a> for more info.</li>\r
+       <li>lib - All the libraries that Jalview depends on. Every jar\r
+       file in this directory should be added to the classpath when building\r
+       or running the jalview application.</li>\r
+       <li>help - the jalview JavaHelp documents<br>\r
+       <ul>\r
+               <li>help.hs - the main index page. This is generated by the\r
+               jhindexer program run by the 'buildindices' task in build.xml</li>\r
+               <li>help.jhm - helpTOC map - an XML document listing simple names\r
+               for each html page that is linked to in the help contents structure.</li>\r
+               <li>helpTOC.xml - the table of contents presented to the user\r
+               when the help is opened.</li>\r
+               <li>icons - widgets needed for the help system GUI</li>\r
+               <li>html - the help documentation. It loosely follows the\r
+               following structure: <br>\r
+               <ul>\r
+                       <li>calculations - pages concerning the calculations menu</li>\r
+                       <li>webServices - pages describing web services</li>\r
+                       <li>colourSchemes - the ways amino acids can be coloured and the\r
+                       user interface for defining them</li>\r
+                       <li>editing - mechanisms and interfaces for editing alignments</li>\r
+                       <li>features - used to be the sequence features documentation,\r
+                       but now contains all sorts of jalview 'features'.</li>\r
+                       <li>io - getting data in and out of jalview</li>\r
+                       <li>menus - all the menus in Jalview (and the applet)</li>\r
+                       <li>misc - useful info</li>\r
+                       <li>By convention, we try to maintain the whatsNew.html document\r
+                       with each release and complete the releases.html matrix to detail\r
+                       what has changed from one version to another.</li>\r
+                       <li>keys.html contains all the keystrokes in Jalview - please\r
+                       keep this up to date.</li>\r
+               </ul>\r
+               </li>\r
+       </ul>\r
+       </li>\r
+       <li>resources - files needed at run-time for jalview execution.<br>\r
+       <ul>\r
+               <li>images - icons used by jalview</li>\r
+               <li>log4j and commons-logging.properties - configure default\r
+               appenders and logging for Jalview, castor.</li>\r
+               <li>embl_mapping.xml - castor mapping file for the EMBL XML\r
+               Schema.</li>\r
+               .\r
+               <li>uniprot_mapping.xml - castor mapping file for the Uniprot XML\r
+               Schema.</li>\r
+       </ul>\r
+       </li>\r
+       <li>schemas - XML schema definitions used or understood by\r
+       Jalview.<br>\r
+       Jalview uses castor to bind java to XML - either using mapping files\r
+       hand-crafted from a schema in this directory, or from java objects\r
+       generated from the schema and an associated set of properties. <br>\r
+       See the castorbinding task in the ant build.xml file for more info.\r
+       <ul>\r
+               <li>Jalview Project Archive XML Version 1<br>\r
+               vamsasJvV1.xsd<br>\r
+               jalviewJvV1.xsd<br>\r
+               jalview.nodesc.properties - sourcegenerator properties file</li>\r
+               <li>jalview Project Archive XML Version 2<br>\r
+               Jalview works out which version a project is by first trying\r
+               to parse XML with these schema definitions, and then if there are\r
+               problems, falls back to the V1 schema classes.\r
+               <ul>\r
+                       <li>vamsas.xsd<br>\r
+                       jalview.xsd<br>\r
+                       jalview.properties - sourcegenerator properties file</li>\r
+               </ul></li>\r
+               <li>JalviewUserColours.xsd is used by both V1 and V2 project XML\r
+               definitions. This schema is also used to store user colour schemes\r
+               externally from the project file.</li>\r
+       </ul>\r
+       </li>\r
+       <li>utils - various resources needed when building or deploying\r
+       jalview.\r
+       <ul>\r
+               <li>InstallAnywhere\r
+               <ul>\r
+                       <li>Jalview.iap_xml is the InstallAnywhere XML project used to\r
+                       create the Jalview InstallAnywhere distribution.</li>\r
+                       <li>All the other files are bundled into this for installer\r
+                       displays. The README_IA appears in the installation directory.</li>\r
+               </ul>\r
+               <li>jalopy<br>\r
+               This is a legacy directory - we intended to use jalopy for\r
+               standardising the jalview source formatting, but found it had a number\r
+               of bugs.</li>\r
+               <li>axis-ant.jar - tasks for constructing client skeletons from\r
+               WSDL documents.</li>\r
+               <li>roxes-ant-tasks-1.2-2004-01-30.jar - conditionals and other\r
+               useful ant tasks.</li>\r
+               <li>castor-*-codegen.jar and castor-*-anttask.jar - codegenerator\r
+               task and library for regenerating the Java classes from schemas. It is\r
+               important to update these and rebuild the source if the version of\r
+               castor that Jalview uses is updated.</li>\r
+               <li>gff2annot.pl - useful script to translate gff to jalview\r
+               features file format - although its not needed since Jalview can parse\r
+               GFF natively (normally at least).</li>\r
+               <li>jhall.jar, jhindexer.jar - the java help system and indexer\r
+               code to build the jalview help in the help directory.</li>\r
+               <li>proguard.jar - obfuscator used when creating\r
+               jalviewApplet.jar. See the build.xml file and the building jalview\r
+               documentation.</li>\r
+       </ul>\r
+       </li>\r
+       <li>dist - where the Jars and JNLP file for the java webstart distribution is generated.</li>\r
+       <li>installAnywhere - where the installAnywhere build is generated</li>\r
+       <li><em>keys</em> - you might not have this - see <a\r
+               href="building.html">building</a> for info on how to create it.</li>\r
+</ul>\r
+</li>\r
+</ul>\r
+\r
+</body>\r
+</html>\r
index 66edaf9..9c17f9c 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<head>\r
+<title>Adding New Datamodel Objects To Jalview</title>\r
+</head>\r
+<body>\r
+<h1>Adding New Datamodel Objects To Jalview</h1>\r
+<p>There are some basic requirements for all Jalview datamodel objects. None of them are mandatory, but each one makes it easier to integrate a new datamodel object into Jalview.</p>\r
+<p>The primary requirement of classes within jalview.datamodel is that all class implementations must be byte-code compatible with a java 1.1 runtime environment. This is an imposition from the Jalview applet, which is dependent on the core jalview.datamodel package. It is possible to include dependencies to objects which are not available to the JRE1.1 environment, providing you ensure that a test is made at run-time to decide if these dependencies are followed within any particular method. But generally, it is best to stick to 1.1 coding style - that is no generics, no fancy Iterators or use of specific JRE object methods and interfaces introduced after 1.1 (such as the get method for java.util.Vector).</p>\r
+<p><h3>Steps for integrating a new class into the datamodel</h3>\r
+<ol><li>Implement in Java 1.1 compatible source.</li>\r
+<li>Implement copy constructors for the benefit of any datamodel classes that reference it:\r
+<ul>\r
+<li>If it is referenced by AlignmentI or SequenceI<br>\r
+The jalview cut and paste mechanism relies on copy constructors and a 'pseudo-copy constructor' method to make new versions of datamodel objects which correctly inherit references to a subset of attributes referenced by the original objects, and otherwise contain complete duplicates of data (sequence characters, annotation and sequence features) local to that object.\r
+</li>\r
+</ul></li>\r
+<li>\r
+</body>\r
+</html>\r
index e18e273..dfb568e 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Consensus Annotation</title></head>
+<body>
+<p><strong>Alignment Consensus Annotation</strong></p>
+<p>The consensus displayed below the alignment is the percentage of the modal 
+  residue per column. By default this calculation takes includes gaps in column. 
+  You can choose to ignore gaps in the calculation by right clicking on the label 
+  &quot;Consensus&quot; to the left of the consensus bar chart. 
+<p>If the modal value is shared by more than 1 residue, a &quot;+&quot; symbol 
+  is used in the display for the simple reason that it is not possible to display 
+  multiple characters in a single character space.
+<p><strong>Copying the consensus sequence</strong></p>
+<p>Select the <strong>&quot;Copy Consensus Sequence&quot;</strong> entry from 
+the consensus annotation label to copy the alignment's consensus sequence to the 
+clipboard. 
+</p>
+</body>
+</html>
index e18e273..904c323 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Conservation Annotation</title></head>
+<body><p><strong>Alignment Conservation Annotation</strong></p>
+<p>This is an automatically calculated quantitative alignment
+annotation which measures the number of conserved physico-chemical
+properties conserved for each column of the alignment. Its calculation
+is based on the one used in
+  the AMAS method of multiple sequence alignment analysis :<br>
+<ul>Livingstone
+  C.D. and Barton G.J. (1993), Protein Sequence Alignments: A Strategy 
+  for the Hierarchical Analysis of Residue Conservation.<em>CABIOS</em> Vol. <b>9</b>
+  No. 6 (745-756)).
+</ul>
+</p>
+<p>Conservation is measured as a numerical index reflecting the conservation of 
+  <a href="../misc/aaproperties.html">physico-chemical 
+  properties</a> in the alignment: Identities score highest, and the next most 
+  conserved group contain substitutions to amino acids lying in the same physico-chemical 
+  class.</p>
+
+<p><em>Colouring an alignment by conservation</em><br>
+Conservation scores can be used to colour an alignment.  This is
+explained further in the help page for <a
+href="../colourSchemes/conservation.html">conservation colouring</a>.
+</p>
+</body>
+</html>
index e18e273..1b7aaf5 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Pairwise Alignment</title></head>
+<body>
+<p><strong>Pairwise alignment (Proteins only)</strong></p>
+<p>This calculation is performed on the selected sequences only. Java is not the
+  fastest language in the world and aligning more than a handful of sequences
+  will take a fair amount of time. <br>
+  For each pair of sequences the best global alignment is found using BLOSUM62
+  as the scoring matrix. The scores reported are the raw scores. The sequences
+  are aligned using a dynamic programming technique and using the following gap
+  penalties : </p>
+<p>Gap open : 12 <br>
+  Gap extend : 2 </p>
+<p>When you select the pairwise alignment option a new window will come up which
+  will display the alignments in a text format as they are calculated. Also displayed
+  is information about the alignment such as alignment score, length and percentage
+  identity between the sequences.</p>
+<p>&nbsp; </p>
+</body>
+</html>
index e18e273..d9b4b45 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Principal Component Analysis</title>
+</head>
+<body>
+<p><strong>Principal Component Analysis</strong></p>
+<p>This calculation creates a spatial representation of the
+similarities within a selected group, or all of the sequences in an
+alignment. After the calculation finishes, a 3D viewer displays the set
+of sequences as points in 'similarity space', and similar sequences tend
+to lie near each other in the space.</p>
+<p>Note: The calculation is computationally expensive, and may fail
+for very large sets of sequences - usually because the JVM has run out
+of memory. A future release of Jalview will be able to avoid this by
+executing the calculation via a web service.</p>
+<p>Principal components analysis is a technique for examining the
+structure of complex data sets. The components are a set of dimensions
+formed from the measured values in the data set, and the principle
+component is the one with the greatest magnitude, or length. The sets of
+measurements that differ the most should lie at either end of this
+principle axis, and the other axes correspond to less extreme patterns
+of variation in the data set.</p>
+
+<p>In this case, the components are generated by an eigenvector
+decomposition of the matrix formed from the sum of BLOSUM scores at each
+aligned position between each pair of sequences. The matrix is not
+symmetric - elements in the upper diagonal give the sum of scores for
+mutating in one direction, and the lower diagonal is the sum of scores
+for mutating in the other. This is a refinement of the method described
+in the paper by G. Casari, C. Sander and A. Valencia. Structural Biology
+volume 2, no. 2, February 1995 (<a
+       href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?cmd=Retrieve&db=pubmed&dopt=Abstract&list_uids=7749921">pubmed</a>)
+and implemented at the SeqSpace server at the EBI.</p>
+
+<p><strong>The PCA Viewer</strong></p>
+<p>This is an interactive display of the sequences positioned within
+the similarity space, as points in a rotateable 3D scatterplot. The
+colour of each sequence point is the same as the sequence group colours,
+white if no colour has been defined for the sequence, and green if the
+sequence is part of a the currently selected group.</p>
+<p>The 3d view can be rotated by dragging the mouse with the <strong>left
+mouse button</strong> pressed. The view can also be zoomed in and out with the up
+and down <strong>arrow keys</strong> (and the roll bar of the mouse if
+present). Labels will be shown for each sequence if the entry in the
+View menu is checked, and the plot background colour changed from the
+View&#8594;Background Colour.. dialog box. The File menu allows the view
+to be saved (<strong>File&#8594;Save</strong> submenu) as an EPS or PNG
+image or printed, and the original alignment data and matrix resulting
+from its PCA analysis to be retrieved.</p>
+<p>A tool tip gives the sequence ID corresponding to a point in the
+space, and clicking a point toggles the selection of the corresponding
+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>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
+selected dimension for the x, y, or z axis through each ones menu
+located below the 3d display.</p>
+<p>
+</body>
+</html>
index e18e273..28841b2 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Quality Annotation</title></head>
+<body>
+<p><strong>Alignment Quality Annotation</strong></p>
+<p>Alignment Quality is one of the automatically calculated
+quantitative alignment
+annotations displayed below the columns of a multiple sequence
+alignment (and can be used to shade the alignment). It is an ad-hoc
+measure of the likelihood of observing the mutations (if any) in a
+particular column of the alignment.</p>
+<p>
+More precisely, the quality score is inversely proportional to the
+average cost of all pairs of mutations oberved in a particular column
+of the alignment - a high alignment quality score for a column would
+suggest that there are no mutations, or most mutations observed are
+favourable.
+</p>
+
+<p><em>The Algorithm</em><br>
+The quality score is calculated for each column in an alignment by
+summing, for all mutations, the ratio of the two BLOSUM 62 scores for
+a mutation pair and each residue's conservered BLOSUM62 score (which
+is higher). This valueis normalised for each column, and then plotted
+on a scale from 0 to 1.
+</p>
+<p>
+Multiple alignment algorithms using the BLOSUM 62 substition matrices
+should, in theory, maximise alignment quality for an un-gapped
+alignment, and locally maximise quality for gapped alignments.
+</p>
+</body>
+</html>
index e18e273..71ecd09 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Viewing Input Data to PCA and Tree calculations</title></head>
+<body>
+
+<p><strong>Viewing Input Data to PCA and Tree calculations</strong></p>
+<p>It is always possible to retrieve the input data used to calculate
+  a tree or PCA plot by using the analysis window's 
+  <strong>&quot;File 
+  -&gt; Input Data...&quot;</strong> menu item. The Input Data will be
+  shown in a new alignment window, with any hidden columns
+  preserved.</p>
+</body>
+</html>
index e18e273..1c39419 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Removing Redundancy</title>
+</head>
+<body>
+<p><strong>Removing redundancy</strong></p>
+<p>Selecting the option in the Alignment window's <strong>Edit</strong>
+menu or pressing <strong>'CONTROL+D'</strong> brings up a dialog box
+asking you to select a threshold. If the percentage identity between the
+aligned positions of any two sequences in the visible alignment exceeds
+this value, the shorter sequence is discarded.<br><em>Note:</em> The redundancy
+calculation is done when the dialog box is opened. For large numbers
+of sequences this can take a long time as all pairs have to be compared.
+</p>
+</body>
+</html>
index e18e273..d11976f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Sorting Sequences</title>
+</head>
+<body>
+<p><strong>Sorting Sequences</strong></p>
+<p>Any group of selected sequences may be reordered by pressing the
+up or down arrow keys. The whole alignment may also be reordered by
+the use of the functions in the Sort menu (<strong>Calculate&#8594;Sort</strong>):
+</p>
+<ul>
+<li><p><strong>Sort by ID</strong></p>
+<p>Orders the sequences by the alphanumeric (0-9A-Za-z)
+precedence of their names.</p><p>
+</li>
+<li><p><strong>Sort by Group</strong></p>
+<p>Places sequences in the same group adjacent to each other.</p><p>
+</li>
+<li><p><strong>Sort by Pairwise Identity</strong></p>
+<p>Places pairs of sequences together that align with the greatest
+fraction of conserved residues.
+</p><p>
+</li>
+<li><p><strong>Sort by Tree Order</strong></p>
+<p>The leaf ordering of a particular phylogenetic tree is used to
+order the sequences corresponding to those leaves in the
+alignment.<br>
+If a tree has been calculated from or associated with the current
+alignment, its name will appear in the submenu <strong>Sort&#8594;By Tree Order</strong>.</p><p>
+</li>
+<li><p><strong>Sort by alignment ordering</strong></p>
+<p>Multiple alignment methods often order the sequences in their
+alignments by some measure of sequence identity.<br>
+If the current alignment has been generated by one of Jalview's
+alignment web services, the alignment ordering can be recovered by
+its corresponding entry in the Sort menu.
+</p>
+</li>
+<li><p><strong>Sort by Score</strong></p>
+<p>This menu appears if the alignment contains any <a href="../features/annotationsFormat.html">sequence associated
+alignment annotation</a> with associated score values. Each entry is the
+label for a distinct group of sequence associated annotation
+scores which can be used for sorting.</p>
+</ul>
+<p><strong>Reversing the Order</strong></p>
+<p>Selecting any item from the Sort menu will sort sequences in an
+ascending order according to the property defining the sort. If the
+same sort is re-applied, the sequences will be sorted in the inverse
+order. In the case of trees and alignment orderings, Jalview will
+remember your last choice for sorting the alignment and only apply the
+inverse ordering if you select the same tree or alignment ordering
+item again.</p>
+
+</body>
+</html>
index e18e273..e2629bc 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Tree Calculation</title></head>
+<body>
+<p><strong>Calculation of trees from alignments</strong></p>
+<p>Trees are calculated on either the complete alignment, or just the
+currently selected group of sequences, using the functions in the
+<strong>Calculate&#8594;Calculate tree</strong> submenu. 
+Once calculated, trees are displayed in a new <a 
+href="../calculations/treeviewer.html">tree viewing window</a>. There are
+four different calculations, using one of two distance measures and
+constructing the tree from one of two algorithms :
+</p>
+<p><strong>Distance Measures</strong></p>
+<p>Trees are calculated on the basis of a measure of similarity
+between each pair of sequences in the alignment :
+<ul>
+<li><strong>PID</strong><br>The percentage identity between the two
+sequences at each aligned position.<ul><li>PID = Number of equivalent
+aligned non-gap symbols * 100 / Smallest number of non-gap positions
+in either of both sequences<br><em>This is essentially the 'number of
+identical bases (or residues) per 100 base pairs (or residues)'.</em></li></ul>
+<li><strong>BLOSUM62</strong><br>The sum of BLOSUM62 scores for the
+residue pair at each aligned position.
+</ul>
+</p>
+<p><strong>Tree Construction Methods</strong></p>
+<p>Jalview currently supports two kinds of agglomerative clustering
+methods. These are not intended to substitute for rigorous
+phylogenetic tree construction, and may fail on very large alignments.
+<ul>
+<li><strong>UPGMA tree</strong><br>
+  UPGMA stands for Unweighted Pair-Group Method using Arithmetic
+  averages. Clusters are iteratively formed and extended by finding a
+  non-member sequence with the lowest average dissimilarity over the
+  cluster members.
+<p></p>
+</li>
+<li><strong>Neighbour Joining tree</strong><br>
+  First described in 1987 by Saitou and Nei, this method applies a
+  greedy algorithm to find the tree with the shortest branch
+  lengths.<br>
+  This method, as implemented in Jalview, is considerably more
+  expensive than UPGMA.
+</li>
+</ul>
+</p>
+<p>A newly calculated tree will be displayed in a new <a
+href="../calculations/treeviewer.html">tree viewing window</a>. In
+addition, a new entry with the same tree viewer window name will be added in the Sort
+menu so that the alignment can be reordered to reflect the ordering of
+the leafs of the tree. If the tree was calculated on a selected region
+of the alignment, then the title of the tree view will reflect this.</p>
+
+<p><strong>External Sources for Phylogenetic Trees</strong></p>
+  <p>A number of programs exist for the reliable construction of
+  phylogenetic trees, which can cope with large numbers of sequences,
+  use better distance methods and can perform bootstrapping. Jalview
+  can read <a
+  href="http://evolution.genetics.washington.edu/phylip/newick_doc.html">Newick</a>
+  format tree files using the 'Load Associated Tree' entry of the
+  alignment's File menu. Sequences in the alignment will be
+  automatically associated to nodes in the tree, by matching Sequence
+  IDs to the tree's leaf names.
+  </p>
+
+
+</body>
+</html>
index e18e273..b0cbb46 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>The Tree Viewing Window</title>
+</head>
+<body>
+<p><strong>The Tree Viewing Window</strong></p>
+<p>
+  The tree viewing window is opened when a tree has been <a href="tree.html">calculated 
+  from an alignment</a>, or imported via a file or web service. It includes <a href="#menus">menus</a> for 
+  controlling layout and file and figure creation, and enables 
+  various selection and colouring operations on the 
+  associated sequences in the alignment.</p>
+<p>
+<strong><em>Selecting Sequence Leaf Nodes</em></strong><br>
+  Selecting sequence ids at the leaves of the tree selects the
+  corresponding sequences in the original alignment. These selections
+  are also reflected in any other analysis windows associated with the
+  alignment, such as another tree viewer.</p>
+<p><strong><em>Grouping sequences by partitioning the tree at a particular distanec</em></strong><br>
+  Clicking anywhere along the extent of the tree (but not on a leaf or
+  internal node) defines a tree 'partition', by cutting every branch
+  of the tree spanning the depth where the mouse-click occurred. Groups
+  are created containing sequences at the leaves of each connected
+  sub tree. These groups are each given a different colour, which are
+  reflected in other windows in the same way as if the sequence ids
+  were selected, and can be edited in the same way as user defined
+  sequence groups.
+</p>
+<p>Tree partitions are useful for comparing clusters produced by
+different methods and measures. They are also an effective way of
+identifying specific patterns of conservation and mutation
+corresponding to the overall phylogenetic structure, when combined
+with the <a href="../colourSchemes/conservation.html">conservation
+based colour scheme</a>.</p>
+<p>
+<strong><em>Selecting Subtrees and changing the branch order and subtree group colour</em></strong><br>
+Moving the mouse over an internal node of the tree will highlight
+  it. You can then : <ul>
+  <li>Click the highlighted node to select all the sequences in that branch.
+  <li>Double-click the highlighted node to rearrange the tree
+  diagram by inverting the branch ordering at that
+  node.
+  <li>Right-click to open the 'Select Sub-Tree Colour' dialog box, to
+  pick a new colour for the sub-tree and associated sequences.
+  </ul>
+</p>
+<p><strong><a name="menus">
+File Menu</a></strong></p>
+<p>This menu allows the displayed tree to be saved as a Newick tree
+file (Save&#8594;Newick File), printed or exported as an image (PNG) or
+Postscript file. Finally, data used to calculate the tree can be
+retrieved with the 'Input Data...' entry.
+</p>
+<p><strong>View Menu</strong></p>
+<p>When the tree viewer is opened, it displays all the annotation
+associated with a tree. Trees calculated by Jalview have branch
+lengths, which correspond to the distance measure used to construct
+the tree. Tree imported from outside may also contain bootstrap information,
+and additional leaves from sequences not present in the associated
+alignment.
+</p>
+<p>The view menu contains options controlling the way a tree is
+rendered and labelled:
+<ul>
+<li><strong>Fit to Window</strong><p>
+The tree layout will be scaled to fit in the  display
+window. You may need to reduce the font size to minimise the leaf
+label overlap when this option is selected.
+</p></li>
+<li><strong>Font Size ...</strong><em>n</em><p>
+Brings up a dialog box to set the font size for the leaf
+names. <em>n</em> is the current font size.
+</p></li>
+<li><strong>Show Distances</strong><p>
+Labels each branch or leaf with its associated branch
+length.</p></li>
+<li><strong>Show Bootstrap values</strong><p>
+Labels each branch or leaf with its associated bootstrap value.
+</p></li>
+<li><strong>Mark unlinked leaves</strong><p>
+Toggles the display of a '*' at the beginning of a leaf label to
+indicate that there is no sequence corresponding to that leaf in the
+associated alignment.
+</p></li>
+<li><strong>Associate Leaves with ...</strong><p>
+Only visible when there are <a href="../features/multipleviews.html">multiple views</a> of the same
+alignment to show and edit which alignment views are associated with
+the leaves of the displayed tree.
+</p>
+</ul>
+</p>
+</body>
+</html>
index 7c03cfa..ed9c840 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Above PID Colours</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..9275a09 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Annotation Colouring</title></head>
+
+<body>
+<p><strong> Annotation Colouring </strong></p>
+<p>Jalview 2.08 allows an alignment to be coloured on a per-column basis based 
+  on any numerical annotation added to that alignment. </p>
+Select &quot;Colour&quot; <strong>&#8594;</strong> &quot;.. 
+  by Annotation&quot; to bring up the Colour by Annotation settings window. <br>
+  <br><div align="center">
+  <img src="annotationColourSetting.jpg" width="426" height="140"> </div>
+<ul>
+  <li>Select which annotation to base the colouring scheme on using the top left 
+    selection box.</li>
+  <li> If the &quot;Use Original Colours&quot; box is selected, the colouring 
+    scheme will use the colouring scheme present on the alignment before the Annotation 
+    Colour Settings window was displayed. </li>
+  <li>The colour scheme can display a colour gradient from a colour representing 
+    the minimum value in the selected annotation to a colour representing the 
+    maximum value in the selected annotation. Use the &quot;Min Colour&quot; and 
+    &quot;Max Colour&quot; to set the colour gradient range.</li>
+  <li>Select whether to colour the alignment above or below an adjustable threshold 
+    with the selection box center left of the window. </li>
+  <li>Change the threshold value with the slider, or enter the exact value in 
+    the text box. </li>
+</ul>
+<p align="center"><img src="annotationColours.jpg" width="475" height="262"> </p>
+</body>
+</html>
index 1f749be..fc840ce 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Blosum Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index f5b2eb4..f3aa716 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Buried Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index d97deca..1635b74 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Clustal Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..37804bc 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Colouring by Conservation</title></head>
+<body>
+<p><em>Colouring by Conservation</em></p>
+<p>This is an approach to alignment colouring which highlights
+  regions of an alignment where physicochemical properties are
+  conserved. It is based on the one used in
+  the AMAS method of multiple sequence alignment analysis (Livingstone
+  C.D. and Barton G.J. (1993), Protein Sequence Alignments: A Strategy 
+  for the Hierarchical Analysis of Residue Conservation.CABIOS Vol. 9
+  No. 6 (745-756)). See the <a href="../calculations/conservation.html">conservation calculation</a> help page for
+  a more thorough explanation of the calculation.
+</p>
+<p>For an already coloured alignment, the conservation index at each
+  alignment position is used to modify the shading intensity of the
+  colour at that position. This means that the most conserved columns
+  in each group have the most intense colours, and the least conserved
+  are the palest. The slider controls the contrast between these
+  extremes.</p>
+<p>Conservation can be calculated over all sequences in an alignment, or just
+  within specific groups (such as those defined by
+  <a href="../calculations/tree.html">phylogenetic tree partitioning</a>).
+  The option 'apply to all groups' controls whether the contrast
+  slider value will be applied to the indices for the currently
+  selected group, or all groups defined over the alignment.</p>
+</body>
+</html>
index 33fc5dd..fc5be4a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Helix Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index a09d63b..f4a3af4 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Hydrophobic Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index 7b0b6a5..f7e2050 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Colour Schemes</title>
+<style type="text/css">
+<!--
+td {
+       font-family: "Courier New", Courier, mono;
+       font-style: normal;
+       font-size: medium;
+}
+-->
 </style>
 </head>
 <body>
index 1898888..9d68fd5 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Nucleotide Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index f46b10c..c956c29 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Percentage Identity Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index 949b9f9..e7a15ed 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Strand Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index 638f202..14a809a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Taylor Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..054b26c 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+Background Dependent Text Colour
+</head>
+<body>
+<strong>Background Dependent Text Colour</strong>
+<p>The <strong>Colour&#8594;Text Colour</strong> menu entry opens
+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 0c1900e..8a3d10f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Turn Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..066ea17 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>User Defined Colours</title></head>
+<body>
+<p><em>User Defined Colours</em></p>
+<p><img src="userDefined.gif" width="719" height="368"> </p>
+<p>You may define any number of new colour schemes, each with a unique name. <br>
+  <br>
+  Each of the residues in a new colour scheme may be assigned a new user defined 
+  colour. <br>
+  <br>
+  Click &quot;Apply&quot; or &quot;OK&quot; to set your new colours on the active 
+  alignment window. </p>
+<p>Click &quot;Cancel&quot; to undo your changes if you pressed the &quot;Apply&quot; 
+  button. <br>
+  <br>
+  If you save your colour scheme with a unique name the colour scheme name will 
+  be added to the &quot;Colour&quot; menu on each new alignment window.<br>
+  <br>
+  Any saved colour schemes will be automatically loaded the next time you use 
+  Jalview.</p>
+</body>
+</html>
index c7589c5..3c29caa 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Zappo Colour Scheme</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..eaa5971 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<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 e18e273..95e233b 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Annotation</title></head>
+<body>
+<p><strong>Alignment Annotation</strong></p>
+
+<p>In addition to the definition of groups and sequence features,
+  Jalview can display symbols and graphs under the columns of an
+  alignment, and allow you to mark particular columns of an alignment and add symbols and text 
+  in the annotation area shown below the alignment (which may be hidden if <strong>View&#8594;Show 
+  Annotation</strong> is not ticked). Any displayed annotation row can be hidden (using the pop-up 
+  menu obtained by right-clicking the label), or re-ordered by dragging the label to a new 
+  position with the left mouse button.</p>
+<p>Web services can also add annotation to an alignment (see the
+  <a href="../webServices/jnet.html">JNet web service</a>), and as of Jalview 2.08 quantitative and symbolic
+  annotations can be added to an alignment via an <a href="annotationsFormat.html">Annotations 
+  File</a> dragged into the alignment window or loaded from the
+  alignment's file menu.</p>
+<p><strong>Interactive Alignment Annotation</strong></p>
+<p>
+Annotation rows are added using the <strong>Annotation Label</strong>
+menu, which is obtained by clicking anywhere on the annotation row labels
+area (below the sequence ID area).
+</p>
+<ul>
+  <li>Add New Row<br>
+    <em>Adds a new, named annotation row (a dialog box will pop up for you to 
+    enter the label for the new row). </em> </li>
+  <li>Hide Row<br>
+    <em>Hides the annotation row whose label was clicked in order to bring up 
+    the menu.</em> </li>
+  <li>Delete Row<br>
+    <em>Deletes the annotation row whose label was clicked in order to bring up 
+    the menu.</em> </li>
+  <li>Show All Hidden Rows<br>
+    <em>Shows all hidden annotation rows.</em> </li>
+          <li><strong>Export Annotation</strong> <em>(Application only)</em><br>
+       <em>Annotations can be saved to file or output to a text window in either the 
+        Jalview annotations format or as a spreadsheet style set of comma separated values (CSV). </em> </li>
+      <li><strong>Show Values in Text Box</strong> <em>(applet only)</em><br>
+        <em>Opens a text box with a list of comma-separated values corresponding 
+        to the annotation (numerical or otherwise) at each position in the row. 
+        This is useful to export alignment quality measurements for further analysis.</em> 
+      </li>
+      <li><strong>Scale Label To Column</strong><em>(introduced in 2.5)</em><br>
+      <em>Selecting this toggles whether column labels will be shrunk to fit within each column, or displayed using the view's standard font size.</em></li>
+</ul>
+<p>
+<strong>Editing Label and secondary structure Annotation</strong></p>
+<p>
+Use the <strong>left mouse button</strong> to select a position along the row that are to
+be annotated - these regions will be coloured red. <strong>Control</strong> and <strong>shift</strong> in combination
+with the left-click will select more than one position, or a range of
+positions on the alignment.
+</p>
+<p>Once the desired position has been selected, use the <strong>right mouse
+button</strong> to open the <strong>annotation menu</strong>:</p>
+<ul>
+<li>Helix<br><em>Mark selected positions with a helix glyph (a red
+oval), and optional text label (see below). A
+dialog box will open for you to enter the text. Consecutive ovals
+will be rendered as an unbroken red line.</em>
+</li>
+<li>Sheet<br><em>Mark selected positions with a sheet glyph (a green
+arrow oriented from left to right), and optional text label (see
+below). A dialog box will open for you to enter the text. Consecutive
+arrows will be joined together to form a single green arrow.</em>
+</li>
+<li>Label<br><em>Set the text label at the selected positions. A
+dialog box will open for you to enter the text.  If
+more that one consecutive position is marked with the same label, only
+the first position's label will be rendered.</em>
+</li>
+<li>Colour<br><em>Changes the colour of the annotation text label.</em>
+</li>
+<li>Remove Annotation<br><em>Blanks any annotation at the selected positions on
+the row. Note: <strong>This cannot be undone</strong></em>
+</li>
+</ul>
+<p>
+User defined annotation is stored and retrieved using <a
+href="../features/jalarchive.html">Jalview Archives</a>.
+</p>
+<p><em>Current Limitations</em></p>
+<p>As of version 2.4, the Jalview user interface does not support the 
+creation and editing quantitative annotation (histograms and line graphs), or 
+to create annotation associated with a specific sequence. It is also incapable of
+annotation grouping or changing the style of existing annotation (to change between line or bar charts, or to make multiple line graphs). These annotation capabilities are only possible by the import of an 
+<a href="annotationsFormat.html">Annotation file</a>.<br>
+</p>
+</body>
+</html>
index e18e273..7abe66a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>The Alignment Annotations File</title>
+</head>
+
+<body>
+<p><strong>The Alignment Annotations File</strong></p>
+<p>Alignment annotations can be imported onto an alignment since
+version 2.08 of Jalview, via an annotations file. It is a simple ASCII
+text file consisting of tab delimited records similar to the <a
+       href="featuresFormat.html">Sequence Features File</a>, and introduced
+primarily for use with the Jalview applet.</p>
+<p>Alignment annotations files are imported into Jalview in the
+following ways:<br>
+<ul>
+       <li>from the command line<strong><pre>
+ -annotations &lt;<em>Annotations filename</em>&gt;</pre></strong></li>
+       <li>Dragging an annotations 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>Annotations File Format</strong></p>
+<p>The File consists of lines containing an instruction followed by
+tab delimited fields, and any lines starting with &quot;#&quot; are
+ignored. The first non-commented out line of a valid Annotations file
+must begin with :<strong><pre>JALVIEW_ANNOTATION</pre></strong></p>
+<p>A row of annotation is added with a line like <strong><pre><em>GRAPH_TYPE</em>&#9;<em>Label</em>&#9;<em>Values</em></pre></strong></p>
+<p>The <em>GRAPH_TYPE</em> field, which appears first, defines the
+appearance of the annotation row when rendered by Jalview. The next field is the row label for the annotation. The final <em>Values</em> field contains a series of &quot;|&quot;
+separated value fields. Each value field is itself a comma separated list of fields of a particular type defined by the annotation row's
+GRAPH_TYPE. The allowed values of GRAPH_TYPE and the format of their respective value fields (with the trailing &quot;<strong>|</strong>&quot; symbol) are shown below:<ul>
+       <li>BAR_GRAPH<br>
+       Plots a histogram with labels below each bar.<br>
+       <em>number</em>,<em>text character</em>,<em>Tooltip text</em></li>
+       <li>LINE_GRAPH<br>
+       Draws a line between values on the annotation row.<br>
+       <em>number</em></li>
+       <li>NO_GRAPH<br>
+       For a row consisting of text labels and/or secondary structure symbols.<br>
+       <em>{Secondary Structure Symbol}</em>,<em>text label</em>,<em>Tooltip text</em><br>
+       Currently supported secondary structure structure symbols are <em>H</em> (for   helix) and <em>E</em> (for strand)</li>
+</ul>
+Any or all value fields may be left empty, as well as the BAR_GRAPH's
+text character field, and either or both of the text-label and secondary
+structure symbol fields of the NO_GRAPH type annotation rows.</p>
+<p>Color strings can be embedded in a value field by enclosing an RGB triplet in square brackets to colour that position in an annotation row.  
+</p>
+<p>You can associate an annotation with a sequence by preceding its
+definition with the line: 
+<pre>SEQUENCE_REF&#9;<em>seq_name</em>&#9;<em>[startIndex]</em></pre>
+All Annotations defined after a SEQUENCE_REF command will then be
+associated with that sequence, and the first field in the Value field
+list will (optionally) be placed at the <em>startIndex</em>'th column.</p>
+<ul><em>New in Jalview 2.4</em>: the tooltip displayed when the mouse is moved over the row 
+label for sequence associated annotation  gives the associated 
+sequence's name followed by the annotation row's description.<br/>
+<em>New in Jalview 2.5 Desktop</em>: Clicking on a sequence or group associated annotation row's label will highlight the sequence or sequence group in the alignment, and double clicking the annotation row label will select the associated sequence or group.</ul> 
+<p>Sequence associations are turned off for subsequent annotation
+definitions by: 
+<pre>SEQUENCE_REF&#9;ALIGNMENT</pre>
+</p>
+<p>Since version 2.5, Jalview allows annotation rows to be associated with a group defined on the alignment, by preceding the annotation row with the line:
+<pre>GROUP_REF&#9;<em>group_name</em></pre>
+Group association is turned off for subsequent annotation rows by 
+<pre>GROUP_REF&#9;<em>ALIGNMENT</em></pre>
+Annotations may be associated with both a sequence and a group, however - group annotations are still experimental and unexpected behaviour may be observed when editing alignments containing both group and sequence associated annotation rows.</p>
+<p><em>LINE_GRAPH</em> type annotations can be given a colour
+(specified as 24 bit RGB triplet in hexadecimal or comma separated
+values), combined onto the same vertical axis, and have ordinate lines
+(horizontal lines at a particular vertical axis value) using the
+following commands (respectively): 
+<pre>COLOUR&#9;<em>graph_name</em>&#9;<em>colour</em>
+COMBINE&#9;<em>graph_1_name</em>&#9;<em>graph_2_name</em>
+GRAPHLINE&#9;<em>graph_name</em>&#9;<em>value</em>&#9;<em>label</em>&#9;<em>colour</em><strong><em>
+</em></strong></pre>
+<h3><font face="Arial, Helvetica, sans-serif">(Since Jalview 2.5) ROWPROPERTIES</font></h3>
+<p>The visual display properties for a set of annotation rows can be modified using the following tab-delimited line:</p>
+<pre>ROWPROPERTIES&#9;<em>Row label</em>&#9;<em>centrelabs=true( or false)</em>&#9;<em>showalllabs=true(default is false)</em>&#9;<em>scaletofit=true (default is false)</em></pre>
+<p>This sets the visual display properties according to the given values for all the annotation rows with labels matching <em>Row label</em>. The properties mostly affect the display of multi-character column labels, and are as follows:
+<ul><li><em>centrelabs</em> Centre each label on its column.</li>
+<li><em>showalllabs</em> Show every column label rather than only the first of a run of identical labels (setting this to true can have a drastic effect on secondary structure rows).</li>
+<li><em>scaletofit</em> Shrink each label's font size so that the label fits within the column. Useful when annotating an alignment with a specific column numbering system. (<em>Not available in Jalview applet due to AWT 1.1 limitations</em>)</li>
+</ul></p>
+<h3><font face="Arial, Helvetica, sans-serif">(Since Jalview 2.2.1) SEQUENCE_GROUP</font></h3>
+<p>Groups of sequences can be defined using the tab delimited line</p>
+<pre>SEQUENCE_GROUP    Group_Name      Group_Start     Group_End       Sequences</pre>
+<p>The sequences can be defined by alignment index and a range of sequences can 
+  be defined in a comma delimited field such as</p>
+<p>2-5,8-15,20,22</p>
+<p>Enter * to select all groups. </p>
+<p>If the alignment indices are not known, enter -1 then a tab delimited list 
+  of sequence ids. </p>
+<p>If the SEQUENCE_REF has been defined, the group_start and group_end will be 
+  relative to the sequence residue numbering, otherwise the group_start and group_end 
+  will be the alignment column indices. </p>
+<p>The group can (optionally) be assigned various visualisation properties via 
+  another tab delimited line thus:</p>
+<pre>PROPERTIES        Group_name      tab_delimited_key_value_pairs
+</pre>
+<p>The key_value_pairs allow you to define a description and to colour the group 
+  in various ways. All, none or some of the following values could be used for 
+  a group:</p>
+<p>description=Text <br>
+  colour=Helix Propensity<br>
+  pidThreshold=0<br>
+  consThreshold=0<br>
+  outlineColour=red <br>
+  displayBoxes=true<br>
+  displayText=false<br>
+  colourText=false<br>
+  textCol1=black<br>
+  textCol2=black<br>
+  textColThreshold=0<br>
+  idColour=ff3322<br>
+ <!-- Not yet implemented in 2.5 release 
+  hide=false<br>
+  hidecols=false<br> -->
+  showunconserved=false</p>
+<ul><li><em>New Features in 2.4:</em><br>if the <strong>idColour</strong> property
+is given without specifying a colour scheme with the <strong>colour</strong>
+property, then the idColour will also be used to colour the sequence.</li>
+<li>the <strong>colour</strong> property can take either a colour scheme name,
+ or a single colour specification (either a colour name like 'red' or an RGB
+ triplet like 'ff0066'). If a single colour is specified, then the group
+ will be coloured with that colour.</li>
+ <!--  <li><em>New Features in 2.5</em></li>
+ <li>hide and hidecols instruct jalview to hide the sequences or columns covered by the group.</li> -->
+  <li>Sequence associated Groups<br>If a group is defined after a valid
+ <em>SEQUENCE_REF</em> sequence reference statement, the sequence representative
+ for the group will be set to the referenced sequence.<!-- <br><strong>Note:</strong> if the <em>hide</em> 
+ property is set then only the representative sequence for the group will be shown in the alignment.--></li>
+</ul>
+<p> </p>
+<p>An example Annotation file is given below:
+<pre>#Comment lines follow the hash symbol
+JALVIEW_ANNOTATION
+SEQUENCE_REF&#9;FER1_MESCR&#9;5
+BAR_GRAPH&#9;Bar Graph 1&#9;||-100,-|-200,-|-300,-|-400,-|200,+|300,+|150,+
+LINE_GRAPH&#9;Green Values&#9;1.1|2.2|1.3|3.4|0.7|1.4|3.3|2.2|2.1|-1.1|3.2
+LINE_GRAPH&#9;Red Values&#9;2.1|3.2|1.3|-1.4|5.5|1.4|1.3|4.2|-1.1|1.1|3.2
+BAR_GRAPH&#9;Bar Graph&#9;2 1,.|2,*|3,:|4,.|5,*|4,:|3,.|2|1|1|2|3|4|5|4
+NO_GRAPH&#9;Icons &#9;||||E,Sheet1|E|E||||H,Sheet 2|H|H|H||||||
+NO_GRAPH&#9;Purple Letters&#9;m|y|p|r|o|t|e|i|n
+COLOUR&#9;Bar Graph 2&#9;blue
+COLOUR&#9;Red Values&#9;255,0,0
+COLOUR&#9;Green Values&#9;green
+COLOUR&#9;Purple Letters&#9;151,52,228
+COMBINE&#9;Green Values&#9;Red Values
+GRAPHLINE&#9;Red Values&#9;2.6&#9;threshold&#9;black
+
+SEQUENCE_GROUP Group_A 30 50 *
+SEQUENCE_GROUP Group_B 1 351 2-5
+SEQUENCE_GROUP Group_C 12 14 -1 seq1   seq2    seq3
+PROPERTIES Group_A description=This is the description colour=Helix Propensity pidThreshold=0 outlineColour=red displayBoxes=true displayText=false    colourText=false textCol1=black textCol2=black textColThreshold=0
+PROPERTIES Group_B outlineColour=red
+PROPERTIES Group_C colour=Clustal
+</pre>
+</p>
+</body>
+</html>
index e18e273..9bca344 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<title>Jalview Command Line Arguments
+</title>
+<body>
+ <p><strong>The Jalview Executable's Command Line
+ Arguments</strong></p>
+ See <a href="commandline.html">running Jalview from the command
+ line</a> for more information.<br>
+ <table width="100%" border="1" cellspacing="0" cellpadding="0">
+ <tr > 
+ <td width="27%"><div align="center">-nodisplay</div></td>
+ <td width="73%"><div align="left">Run Jalview without User Interface. (automatically disables questionnaire, version and usage stats checks)</div></td>
+ </tr>
+
+ <tr> 
+ <td><div align="center">-props FILE</div></td>
+ <td><div align="left">Use the given Jalview properties file instead 
+ of users default.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-features FILE</div></td>
+ <td><div align="left"> 
+ <p>Use the given file to add sequence features to an alignment. 
+ See <a href="featuresFormat.html" target="NEW">Features 
+ File</a> (Known as Groups file prior to 2.08) description. </p>
+
+ </div></td>
+ </tr>
+       <tr>
+               <td>
+               <div align="center">-annotations FILE</div>
+               </td>
+               <td>Add precalculated annotations to the alignment. See <a
+                       href="annotationsFormat.html" target="NEW">Annotation File</a>
+               description.</td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-tree FILE</div>
+               <td>
+               <div align="left">Load the given newick format tree file onto
+               the alignment</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-questionnaire URL</div>
+               <td>
+               <div align="left">Queries the given URL for information about
+               any Jalview user questionnaires</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-noquestionnaire</div>
+               <td>
+               <div align="left">Turn off questionnaire check</div>
+               </td>
+       </tr>
+       <tr><td>
+               <div align="center">-nousagestats</div>
+               <td>
+               <div align="left">Turn off google analytics usage tracking</div>
+               </td>
+       </tr>
+       <tr><td>
+       <div align="center">-[no]sortbytree</div>
+               <td>
+               <div align="left">Enable or disable automatic sorting of associated view when a new tree is displayed</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-dasserver nickname=URL</div>
+               <td>
+               <div align="left">Add and enable a <a href="dassettings.html">DAS server</a> with given
+               nickname (alphanumeric or underscores only) for retrieval of features
+               for all alignments<br>
+               Sources that also support the sequence command may be specified by prepending the URL with 'sequence:'<br>
+               <em>e.g.</em> sequence:http://localdas.somewhere.org/das/source</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-fetchfrom nickname</div>
+               <td>
+               <div align="left">Query a <a href="dassettings.html">DAS source</a> called nickname for features for the alignments
+               and display them</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-groovy FILE</div>
+               <td>
+               <div align="left">Execute groovy script in FILE (where FILE may be 'STDIN' to read from the standard input) after all other
+               arguments have been processed</div>
+               </td>
+       </tr>
+       <tr>
+       <td>
+               <div align="center">-vdoc VAMSAS DOCUMENT FILE or URL</div>
+               <td>
+               <div align="left">Import the given vamsas document into a new session.<br><em>New in 2.5</em></div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-vsess VAMSAS SESSION URL</div>
+               <td>
+               <div align="left">Join the given vamsas session<br>If a document was also specified, this will be imported first and then committed as new data from Jalview to the specified session (Experimental - not yet enabled!).<em>New in 2.5</em></div></div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-groovy FILE</div>
+               <td>
+               <div align="left">Execute groovy script in FILE (where FILE may be 'STDIN' to read from the standard input) after all other
+               arguments have been processed</div>
+               </td>
+       </tr>
+       <tr>
+               <td>
+               <div align="center">-fasta FILE</div>
+               </td>
+
+               <td>
+               <div align="left">Create alignment file FILE in Fasta format.</div>
+               </td>
+       </tr>
+       <tr> 
+ <td><div align="center">-clustal FILE</div></td>
+ <td><div align="left">Create alignment file FILE in Clustal format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-msf FILE</div></td>
+
+ <td><div align="left">Create alignment file FILE in MSF format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-pileup FILE</div></td>
+ <td><div align="left">Create alignment file FILE in Pileup format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-pir FILE</div></td>
+
+ <td><div align="left">Create alignment file FILE in PIR format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-pfam FILE</div></td>
+ <td><div align="left">Create alignment file FILE in PFAM format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-blc FILE</div></td>
+ <td><div align="left">Create alignment file FILE in BLC format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-jalview FILE</div></td>
+
+ <td><div align="left">Create alignment file FILE in Jalview format.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-png FILE</div></td>
+ <td><div align="left">Create PNG image FILE from alignment.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-imgMap FILE</div></td>
+
+ <td><div align="left">Create HTML file FILE with image map of PNG 
+ image.</div></td>
+ </tr>
+ <tr> 
+ <td><div align="center">-eps FILE</div></td>
+ <td><div align="left">Create EPS file FILE from alignment.</div></td>
+ </tr>
+ </table>
+</body>
+</html>
index 66edaf9..d428c10 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<head>\r
+<title>DNA Sequence Coding Region Definition</title>\r
+</head>\r
+<body>\r
+<p><strong>DNA Sequence Coding Region Definition</strong></p>\r
+<p>Jalview includes the standard DNA codon translation table in\r
+order to be able to dynamically translate cDNA to its expressed\r
+protein sequence. DNA Sequence Coding Regions are sequence \r
+features that can be defined on any DNA sequence in order to\r
+mark stretches of cDNA that will be concatenated to form the\r
+series of codons that are translated by the <strong>&quot;\r
+Calculate&#8594;Translate cDNA&quot;</strong> menu function.    \r
+</p>\r
+</body>\r
+</html>\r
index e18e273..6c6f3eb 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Running Jalview from the command line</title></head>
+<body>
+ <p><strong>Running Jalview from the command line</strong></p>
+ <p>Jalview is most easily run from the command line if you have built
+ it from source, or via the 'Jalview' executable created from the
+ InstallAnywhere jalview installation. Both of these mechanisms allow
+ true command line execution of jalview - allowing you to provide
+ additional options.</p><p>
+The Java Webstart version of
+ jalview can be executed from the command line using something like
+ :
+ <pre>javaws http://www.jalview.org/webstart/jalview.jnlp -open
+ <em>yourFileName</em></pre>
+ But, this is not guaranteed to work on all versions of webstart on all
+ operating systems, and doesn't let you execute Jalview with any
+ additional parameters.
+ <p><strong>Running jalview from the InstallAnywhere
+ installation</strong></p>
+ <p>If you install with InstallAnywhere you can use several more commands. 
+ However, if you call the application with the link provided by InstallAnywhere 
+ any output from the application will be sent to output.txt, not standard 
+ out.<br>
+ The jalview application also requires a number of additional
+ libraries on the class path. The command line below adds the Jalview
+ installation's 'lib' directory to the list of directories that are
+ searched for jars to be added to the classpath:</p>
+<pre>java -Djava.ext.dirs=$INSTALL_DIR$/lib -cp $INSTALL_DIR$/jalview.jar jalview.bin.Jalview -open [FILE] </pre>
+ <p>Use '-help' to get more information on the <a
+ href="clarguments.html">command line arguments</a> that Jalview
+ accepts.</p>
+ <p>&nbsp;</p>
+ <p>&nbsp;</p>
+ </body>
+ </html>
index e18e273..824991d 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Creating Sequence Features</title>
+</head>
+<body>
+<strong>Creating Sequence Features</strong>
+<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 <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>
+<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:
+<ul>
+       <li><strong>Sequence Feature Name</strong>
+       <p>Either give the new features a new name or use the menu to
+       re-use an existing feature name.</p>
+       </li>
+       <li><strong>Feature group</strong>
+       <p>Enter a new group name, or re-use an existing group from the
+       pull-down menu.</p>
+       </li>
+       <li><strong>Feature Colour</strong>
+       <p>Keep the existing colour for this feature's name and group, or
+       select the colour box to open a colour chooser to pick a different one.</p>
+       </li>
+       <li><strong>Description</strong>
+       <p>Enter a description for all the features being created. Each
+       feature defined on a sequence may have its own description that will be
+       displayed in the tooltip for the feature in that region.</p>
+       </li>
+</ul>
+</p><p><em>Sequence Feature Creation was introduced in Jalview Version 2.2</em></p>
+</body>
+</html>
index e18e273..380c32a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Cursor Mode</title>
+</head>
+<body>
+<p><strong>Cursor Mode</strong></p>
+<p>Cursor mode is a new feature in Jalview 2.08, and allows more
+precise selection and editing of alignments through the use of the
+keyboard for both navigation and the input of editing and selection commands.</p>
+<p><em>F2</em> Toggles between normal and cursor editing modes. When
+in cursor mode, a black cursor appears in the residue area of the
+alignment, and any mouse clicks on that area will move the cursor to
+that position (this means that the region selection menu is
+unavailable in cursor mode).</p>
+<p><b>Navigation</b>
+<ul>
+  <li>Cursor keys - Move cursor around the alignment.</li>
+</ul>
+<ul>
+  <li>S - Type a number x then press 'S' to jump to sequence x.</li>
+</ul>
+<ul>
+  <li>C - Type a number x then press 'C' to jump to column x.</li>
+</ul>
+<ul>
+  <li>P - Type a number x then press 'P' to jump to position x in current sequence.</li>
+</ul>
+<ul>
+  <li>65,82&lt;return&gt; - Quick jump to column 65, sequence 82</li>
+</ul>
+</p>
+<p><b>Defining Regions</b>
+<ul>
+  <li>Q - Define the top left corner of the selection area</li>
+</ul>
+<ul>
+  <li>M - Define the bottom right corner of the selection area<br>
+  </li>
+</ul>
+<p><b>Editing The Alignment</b>
+<ul>
+  <li>Space - Insert a gap at the cursor position. <br>
+    To insert 12 spaces at the current cursor, type 12 before pressing Space.<br>
+    To group insert, hold control or shift together with space.</li>
+</ul>
+<ul>
+  <li>Delete (or backspace) - Delete a gap at the cursor position.<br>
+    To delete 12 spaces at the current cursor, type 12 before pressing
+    Delete (or backspace).<br>
+    To group delete, hold down control or shift together with Delete
+    (or backspace).</li>
+</ul>
+</p>
+</body>
+</html>
index e18e273..571343c 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>DAS Features</title>
+</head>
+
+<body>
+<p><strong>DAS Sequence Feature Retrieval</strong></p>
+<p>Jalview includes a client for retrieving sequences and their 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 retrieval, 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>
+The <a href="../webservices/dbreffetcher.html">database reference
+fetcher</a> documentation describes how Jalview discovers what database
+references are appropriate for the sequences in the alignment.
+<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 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 e18e273..7ccbbda 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>DAS Settings</title>
+</head>
+
+<body>
+<p><strong>DAS Settings</strong></p>
+<p>Jalview can retrieve sequences and features from many <a
+       href="http://biodas.org/">DAS</a> sources. The DAS sources that
+it uses are discovered and selected <em>via</em> the DAS settings panel,
+opened either from the <a href="featuresettings.html">View&#8594;Feature
+Settings</a> dialog box from the alignment window's menu bar, or the <a
+       href="featuresettings.html">Tools&#8594;Preferences</a> dialog box
+opened from the Desktop menu bar.</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 e18e273..d30f48f 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Amending or Deleting Sequence Features</title>
+</head>
+<body>
+<strong>Amending or Deleting Sequence Features</strong>
+<p>Double clicking a position in the alignment with one or more
+displayed sequence features opens the <strong>&quot;Amend/Delete
+Features&quot;</strong> dialog box.</p>
+<p><img src="amendfeature.gif"></p>
+<p>The dialog box only allows one of the features at the
+double-clicked position to be edited or deleted at a time, and it will
+also be highlighted in black in the alignment window.</p>
+<p>Choose which feature is to be modified by selecting it from the <strong>Sequence
+Feature Name</strong> <!-- and <strong>Feature Group</strong>  --> pull down
+menu. In addition to the Name, group, colour and description attributes
+described for the <a href="creatinFeatures.html">new feature dialog
+box</a>, a feature's start and end position can be changed either by
+entering a new position directly or by using the adjacent up and down
+buttons.</p>
+<p>Select <strong>Amend</strong> to update the feature, <strong>Delete</strong>
+to remove the selected feature, or <strong>Cancel</strong> to leave the
+feature unchanged.</p>
+<p><em>Sequence feature editing was implemented in Jalview 2.2</em></p>
+</body>
+</html>
index e18e273..b802c63 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<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><!-- &#9<em>Feature links</em>  --></pre> </strong>A feature
+type has a text label, and a colour specification. This can be either:
+<ul>
+       <li>A single colour specified as either a red,green,blue 24 bit
+       triplet in hexadecimal (eg. 00ff00) or as comma separated numbers
+       (ranging from 0 to 255))</li>
+       <li>A <a href="featureschemes.html">graduated colourscheme</a> specified as a &quot;|&quot; separated list
+       of fields:<pre>
+&lt;mincolor&gt;|&lt;maxcolor&gt;|[absolute|]&lt;minvalue&gt;|&lt;maxvalue&gt;[|&lt;thresholdtype&gt;|[&lt;threshold value&gt;]]
+</pre>The fields are as follows
+       <ul>
+               <li><em>mincolor</em> and <em>maxcolor</em><br>
+               Colour triplets specified as hexadecimal or comma separated values</li>
+               <li><em>absolute</em><br>
+               An optional switch indicating that the <em>minvalue</em> and <em>maxvalue</em>
+               parameters should be left as is, rather than rescaled according to the
+               range of scores for this feature type.
+               <li><em>minvalue</em> and <em>maxvalue</em><br>
+               Minimum and maximum values defining the range of scores for which the colour range will be defined over. If minvalue is greater than maxvalue then the linear mapping will have negative gradient.
+               </li>
+               <li><em>thresholdtype</em> <br>
+               Either &quot;none&quot;, &quot;below&quot;, or &quot;above&quot;. <em>below</em>
+               and <em>above</em> require an additional <em>threshold value</em>
+               which is used to control the display of features with a score either
+               below or above the value.</li>
+       </ul>
+       </li>
+</ul>
+</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>&#9;<em>score (optional)</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>The description may contain simple HTML document body tags if
+enclosed by &quot;&lt;html&gt;&lt;/html&gt;&quot; and these 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).<br>
+<em>Attaching Links to Sequence Features</em> <br>
+Any anchor tags in an html formatted description line will be translated
+into URL links. A link symbol will be displayed adjacent to any feature
+which includes links, and these are made available from the <a
+       href="../menus/popupMenu.html#sqid.popup">links submenu</a> of the
+popup menu which is obtained by right-clicking when a link symbol is
+displayed in the tooltip.<br>
+<em>Non-positional features</em><br>
+Specify the <em>start</em> and <em>end</em> for a feature to be <strong>0</strong>
+in order to attach it to the whole sequence. Non-positional features are
+shown in a tooltip when the mouse hovers over the sequence ID panel, and
+any embedded links can be accessed from the popup menu.
+<em>Scores</em><br>
+Scores can be associated with sequence features, and used to sort sequences or shade the alignment (this was added in jalview 2.4.X). The score field is optional, and malformed scores will be ignored.
+</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 e18e273..9f3d81d 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Sequence feature colour schemes</title>
+</head>
+
+<body>
+<p><strong>Sequence feature colour schemes</strong></p>
+<p>Jalview can visualize annotation present on parts of a sequence by
+overlaying colours according to the annotation present at each position.
+It allows features to be colored either according to type, or for a
+particular type, according to an individual feature's associated label
+or score. The <a href="featuresettings.html">Feature Settings dialog
+box</a> controls the order and display of each sequence annotation type, and
+also allows the colour scheme used for the the feature to be changed <em>via</em>
+the 'Graduated Colour' option in the sequence feature pop-up menu
+(obtained by right-clicking on a sequence feature).</p>
+
+<center><img src="featurecoloursettings.gif"><br/>Graduated
+feature colour scheme settings dialog box</img></center>
+<p>The Graduated Feature Colour dialog box has the following
+controls:
+<ul>
+       <li><em>Colour by Label</em> - when checked this derives a colour
+       for each feature based on the label text.</li>
+       <li><em>Min and Max Color boxes</em> - Click on these boxes to set
+       the minimum and maximum colours used to shade features by their
+       associated score.</li>
+       <li><em>Threshold type combo box</em> - Allows features to be
+       hidden features if their score is below or above a given threshold.<br />
+       <em>Set the threshold using the slider or type it in to the text
+       box. The threshold cannot be set outside the available range of feature
+       scores.</em>
+       </li>
+       <li><em>Threshold is Min/Max</em> - When checked, the threshold
+       will be used as the upper or lower limit when shading the features
+       according to their score using the Min and Max colour.</li>
+</ul>
+</p>
+<p><strong>Icon styles for graduated feature styles</strong><br/>
+<p>When a graduated colourscheme is applied to a feature, it is indicated in the feature settings or amend feature dialog box by the following types of icon:<br/>
+<center><table width="50%" border="1">
+<tr><td><strong>Type of Colouring</strong></td><td><strong>Icon</strong></td></tr>
+<tr><td><em>Graduated colour by Feature Score</em></td><td><img src="fcsminmax.gif"/></td></tr>
+<tr><td><em>Graduated colour thresholded (less than) by feature Score</em></td><td><img src="fcsltthan.gif"/></td></tr>
+<tr><td><em>Graduated colour thresholded (greater than) by feature Score</em></td><td><img src="fcsgtthan.gif"/></td></tr>
+<tr><td><em>Colour by Feature Label (may also be thresholded)</em></td><td><img src="fcsntlabel.gif"/></td></tr>
+<tr>
+       <td align="center" colspan="2">
+               <em>
+                       <strong>The current threshold is given in the
+       icon's tooltip.</strong>
+               </em>
+       </td></tr></table></center></p>
+<em>Graduated feature colours were introduced in Jalview 2.5</em>
+</body>
+</html>
index e18e273..390ad78 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Sequence Feature Settings Dialog Box</title>
+</head>
+<body>
+<p><strong>Sequence Feature Settings Dialog Box</strong></p>
+<p>Select <strong>View&#8594;Feature Settings...</strong> menu entry
+in an alignment window to open the feature settings dialog box, which
+allows you to precisely control the presence and appearance of sequence
+features for the current alignment.</p>
+<center><img src="featureSettings.gif" width="400" height="452">
+<br>
+Sequence Feature Settings for the Jalview Application</img></center>
+<p>The top section of the dialog box lists all the sequence feature
+groups, along with a tickbox for each that controls whether its features
+are displayed. The table in the middle lists all the features in the
+currently selected groups, along with their display colour and whether
+they are currently being displayed (only the ticked features and groups
+are displayed). <strong><em>You can change the colour used
+for a feature in the associated alignment by clicking on its colour box.</em></strong></p>
+<p><strong><em>Feature settings pop-up menu</em></strong><br>
+<strong>Right-click</strong> on a feature to open a pop-up menu that
+allows you to sort the alignment or current selection using that feature
+type (see below), or create a <a href="featureschemes.html">feature
+colourscheme</a> based on either the scores associated with that feature or
+from the feature's description (e.g. to distinguish different names
+associated with a DOMAIN feature).</p>
+<p><strong>Ordering alignment by features</strong><br>
+The 'Seq Sort by Score' and 'Seq Sort by Density' buttons will sort the
+alignment based on the average score or total number of currently active
+features and groups on each sequence. To order the alignment using a
+specific feature type, use the <em>sort by ..</em> entries in the pop-up
+menu for that type.<br>
+<em>Feature sorting and graduated feature colouring was introduced
+in jalview 2.5</em></p>
+
+<p><strong>Transparency and Feature Ordering</strong></p>
+<p>It is important to realise that sequence features are often not
+distinct and often overlap (for example, a metal binding site feature
+may be attached to one position along a stretch of sequence marked with
+a secondary structure feature).</p>
+<p>The ordering of the sequence features in the dialog box list is
+the order used by jalview for rendering sequence features. A feature at
+the bottom of the list is rendered <em>below</em> a feature higher up in
+the list.<br>
+<em><strong>You can change the order of a feature by
+dragging it up and down the list with the mouse</strong></em>.</p>
+<p>The <strong><em>Optimise order</em></strong> button (currently
+only available in the application) will re-order the feature render
+ordering based on the average length of each feature type.</p>
+<p>The <strong><em>transparency slider setting</em></strong>
+(currently only available in the application version) controls the
+visibility of features rendered below other features. Reducing the
+transparency will mean that features at the top of the list can obscure
+features lower down, and increasing it allows the user to 'see through'
+the upper layers of a set of features.</p>
+<p><strong><em>You can save all features, with their
+current colours and visibility in a Jalview format file. </em></strong></p>
+</body>
+</html>
index 66edaf9..4b63c61 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<head><title>Groovy Shell</title></head>\r
+<body>\r
+<p><strong>The Groovy Shell</strong></p>\r
+<p><a href="http://groovy.codehaus.org/">Groovy</a> is an &quot;<em>agile and dynamic \r
+language for the Java platform</em>&quot;. The groovy scripting language makes it \r
+extremely easy to programmatically interact with Java programs, in much the same \r
+way that Javascript is used to generate and interact with applets and other \r
+objects on the page.</p>\r
+<p><strong><em>Getting Groovy...</em></strong><br>\r
+Jalview Groovy support is only possible if the core groovy \r
+jars which include the GroovyShell are present on the CLASSPATH \r
+when Jalview is started.</p><p>The jars are obtained from the \r
+<em>embedded</em> directory within the <a \r
+href="http://dist.codehaus.org/groovy/distributions">groovy \r
+distribution</a>. The easiest way of adding them to the \r
+Jalview classpath is to download and build jalview from \r
+it's source distribution, and then add the groovy-all-*.jar \r
+to the lib directory whose path is given in the java.ext.dirs property.</p>\r
+<p><strong>Opening Jalview's Groovy Console</strong><br>If groovy is available, then the \r
+<strong>Tools&#8594;Groovy Console...</strong> menu entry will be available \r
+from the Jalview Desktop's drop-down menu. Selecting this will open the\r
+<a href="http://groovy.codehaus.org/Groovy+Console">Groovy Console</a> which \r
+allows you to interactively execute Groovy scripts within the Jalview run-time environment.</p>\r
+<p><strong>Executing groovy scripts on Jalview startup</strong><br>\r
+The -groovy &lt;script&gt; option on the <a href="commandline.html"/>\r
+Jalview command line</a> will execute the contents of \r
+&lt;script&gt;. &lt;script&gt; may be a file, or alternatively if it is &quot;STDIN&quot; \r
+then the standard input will be used.</p>\r
+<p><strong>Access to Jalview's functions from Groovy Scripts</strong><br>\r
+There is as yet no properly defined scripting interface to Jalview, but all the\r
+public methods of the jalview class hierarchy can be called from Groovy scripts. \r
+The access point for this is the <strong>Jalview</strong> object defined in\r
+the groovy environent which corresponds to the <pre>jalview.gui.Desktop</pre> object which\r
+manages all the Jalview windows.</p>  \r
+Here's an example to get you started:<br>\r
+<ul><li>Getting the title, alignment and first sequence from the current alignFrame<br>\r
+<pre>\r
+def alf = Jalview.getAlignframes();\r
+print alf[0].getTitle();\r
+def alignment = alf[0].viewport.alignment;\r
+def seq = alignment.getSequenceAt(0);\r
+</pre>\r
+</li>\r
+</ul>\r
+</p>\r
+\r
+<p>&nbsp;</p>\r
+</body>\r
+</html>\r
index e18e273..ed8c39d 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<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;. You can also use &quot;Shift&quot; and
+&quot;Control&quot; together to hide everything but the currently
+selected region.</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>
+<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><strong><em>Hidden Sequence Representatives and
+Multiple Views</em></strong><br>
+<em>A word of warning: hidden representative sequence groups are
+(still) only partly implemented in the jalview 2.5 release, and we hope
+to deal with the following issues in the future.</em><br>
+Currently, represented hidden groups are only made correctly if there is
+just one alignment view. When multiple views on an alignment exist, then
+the represented group will be displayed correctly in the view in which
+it was made, but in other views, both representative and hidden
+sequences will be visible, but will behave as if they are grouped. <br>
+Hidden representatives are propagated correctly to a new view if they
+exist in the current view. However, if the represented sequences are
+revealed in any one view, then in all other views they will simply be
+marked as hidden, and their association with the representative sequence
+will be lost.<br>
+</blockquote>
+</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><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>&nbsp;</p>
+<p>&nbsp;</p>
+<p>&nbsp;</p>
+</body>
+</html>
index e18e273..d32bbc0 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Jalview Archives</title>
+</head>
+<body>
+
+<p><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>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. 
+</p>
+</body>
+</html>
index 66edaf9..e7f963b 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<head>\r
+<title>The Jmol PDB Viewer</title>\r
+</head>\r
+<body>\r
+<p><strong>The Jmol PDB Viewer</strong>\r
+<p>The interactive structure viewing window is opened by selecting\r
+the <strong>&quot;Sequence&#8594;View PDB entry:&quot;</strong> entry in\r
+the <a href="../menus/popupMenu.html">sequence id pop-up menu</a>. This\r
+can only be done for sequences which have an <a href="viewingpdbs.html">associated\r
+PDB structure</a>.\r
+<p>Since Jalview 2.3, <a href="http://jmol.sourceforge.net/">Jmol</a>\r
+has been integrated into Jalview. It is automatically used by the\r
+application, and should also run in the applet in all latest web\r
+browsers. If jmol is not available, then the original <a\r
+href="pdbviewer.html">internal pdb viewer</a> will be used as a fallback.\r
+</p>\r
+<p><strong>Controls</strong></p>\r
+<p>The structure is by default rendered as a ribbon diagram. Moving the\r
+mouse over the structure brings up tooltips giving the residue name,\r
+PDB residue number and chain code, atom name and number\r
+([RES]Num:Chain.AtomName#AtomNumber). If a mapping exists to a residue\r
+in any associated sequences, then this will be highlighted in each\r
+one's alignment window. The converse also occurs - moving the mouse\r
+over an associated residue in an alignment window highlights the associated\r
+atoms in the displayed structures.</p>\r
+<p>Selecting a residue highlights its associated sequence residue\r
+and alpha carbon location. Double clicking an atom allows distances to\r
+be measured from it to any other atom in the structure.</p>\r
+<p>\r
+<table>\r
+       <tr>\r
+               <td><strong>Action</strong></td>\r
+               <td><strong>Windows</strong></td>\r
+               <td><strong>Unix</strong></td>\r
+               <td><strong>Mac/OSX</strong></td>\r
+       </tr>\r
+       <tr>\r
+               <td>Rotate View</td>\r
+               <td>Left Click and Drag</td>\r
+               <td>Left Click and Drag</td>\r
+               <td>Click and Drag</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Zoom</td>\r
+               <td>Shift + Left Click<br>drag mouse up or down</td>\r
+               <td>Shift + Left Click<br>or middle button<br>drag\r
+               mouse up or down</td>\r
+               <td>Left-Alt + Click and drag mouse up or down</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Select/<br>\r
+               Deselect<br>\r
+               Residue</td>\r
+               <td>Left Click</td>\r
+               <td>Left Click</td>\r
+               <td>Click</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Roll View</td>\r
+               <td>Shift + Left Click<br>drag mouse to left or\r
+               right</td>\r
+               <td>Shift + Left Click<br>or middle button<br>drag mouse to left or right</td>\r
+               <td>Left-Alt + Click and drag mouse to left or right</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Move Origin</td>\r
+               <td>Shift+Control+Left Click<br>or Middle Button<br>\r
+               + Drag</td>\r
+               <td>Middle-Button<br>and<br>drag</td>\r
+               <td>Shift+Control+Left Click<br>or Middle Button<br>\r
+               and drag</td>\r
+       </tr>\r
+       <tr>\r
+               <td>Jmol Menu</td>\r
+               <td>Right-Click</td>\r
+               <td>Right-Click</td>\r
+               <td>Apple-Click</td>\r
+       </tr>\r
+</table>\r
+</p>\r
+<p>The window has four menus:\r
+<ul>\r
+       <li><Strong>File<br>\r
+       </strong>\r
+       <ul>\r
+               <li><strong>Save As<br>\r
+               </strong><em>Save the displayed PDB File, or the current view as an EPS or PNG file.</em></li>\r
+               <li><strong>View Mapping<br>\r
+               </strong><em> Opens a text window showing the alignment between the\r
+               residues corresponding to alpha-carbon atoms in the PDB structure and\r
+               the residues in the associated sequence.</em></li>\r
+       </ul>\r
+       </li>\r
+       <li><strong>View</strong>\r
+       <ul>\r
+       <li><strong>Show Chains<br></strong><em>Select which of the PDB\r
+       file's chains are to be displayed.</em>\r
+       </li>\r
+       </ul>\r
+       <li><strong>Colours<br>\r
+       </strong>\r
+       <ul>\r
+               <li><strong>By Sequence<br>\r
+               </strong><em> Colours each residue in the structure with the colour of its\r
+               corresponding residue in the associated sequence as rendered in the\r
+               associated alignment view, including any Uniprot sequence features or\r
+               region colourings.<br>\r
+               Residues which only exist in the PDB structure are coloured white if\r
+               they are insertions (relative to the associated sequence in the\r
+               alignment) and grey if they are N or C terminal flanks outside the\r
+               region mapped to the alignment window's sequence.</em></li>\r
+               <li><strong>By Chain<br>\r
+               </strong><em> Assigns a random colour to each PDB chain.</em>\r
+               <li><strong>Charge &amp; Cysteine<br>\r
+               </strong><em> Highlights cysteines in yellow, anionic (Aspartic Acid or\r
+               Glutamic Acid) residues in red, and cationic (Lysine or Arginine)\r
+               residues in blue.</em></li>\r
+               <li><strong>Standard and User Defined Jalview\r
+               colourschemes.<br>\r
+               </strong><em>The remaining entries apply the colourschemes available from the\r
+               standard and user defined <a href="../colourSchemes/index.html">amino\r
+               acid colours</a>.</em></li>\r
+       </ul>\r
+       </li>\r
+       <li><strong>Help<br></strong><ul><li><strong>Jmol Help<br></strong><em>Access the Jmol Help\r
+       documentation in a new browser window.</em>\r
+       </li>\r
+       </ul>\r
+</li></ul>\r
+</p>\r
+<p><strong>Functionality provided by Jmol</strong>\r
+</p><p>The Jmol menu provides access to a number of features for\r
+controlling the colour and display of molecules, adding measurements and\r
+labels, plotting surfaces, and display animation. The 'Set Picking'\r
+menu controls the behaviour of single and double mouse clicking on the\r
+structure.</p>\r
+<p>The state of each Jmol display is stored within <a\r
+href="jalarchive.html">jalview archives</a> as a jmol state recovery script\r
+file. This means that any Jmol visualization effects that\r
+you add beyond those provided by Jalview will be able to be stored and\r
+recovered along with the displayed alignments in Jalview.\r
+</p><p><strong>More Information</strong>\r
+</p><p>Jmol is a sophisticated program in its own right, with its own\r
+command console and scripting language. Only the essentials have been\r
+described here - the interested reader is referred to \r
+<a href="http://jmol.sourceforge.net/docs/">Jmol's own comprehensive\r
+online documenation</a>.</p></p>\r
+</body>\r
+</html>\r
index e18e273..0191396 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Multiple Alignment Views</title>
+</head>
+<body>
+<p><strong>Multiple Alignment Views</strong></p>
+<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
+affect the new view.</p>
+<!--  TODO sharing selections between views -->
+<p>A particular view may focus on some specific aspect of an
+alignment - for example, hiding all but the region of an alignment
+containing a particular domain. <strong>Right-clicking</strong> a view's
+tab opens the View Name dialog box, allowing it to be renamed to
+something more meaningful.</p>
+<p><strong>Viewing Multiple Views Simultaneously</strong></p>
+<p>Multiple views of an alignment are, by default, gathered together
+as tabs within a single alignment window. They can be viewed
+simultanously by pressing <strong>X</strong> (or via <strong>&quot;View&#8594;Expand&quot;</strong>)
+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>Hidden Sequence Representatives and Multiple
+Views</strong></p>
+<p>There are some unexpected interactions between hidden sequence
+representatives and their display in multiple views. See the
+corresponding entry in the <a href="hiddenRegions.html">documentation
+for hidden regions</a>.</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 PCA Viewer's <strong>&quot;View&#8594;Associate
+Nodes&quot;</strong> submenu.</p>
+<p><a href="jmol.html">PDB Structure Viewers</a>
+opened on a structure associated with a sequence in a particular view are now (as of Jalview 2.3) associated with the same sequence in all views. This means that when 'Colour by Sequence' is selected in the structure view, the colour will be updated to the colours given in the view with the current input focus.
+<!--
+ 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 e18e273..46cbc94 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<title>New Key Strokes and Menus</title>
+<body>
+<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. 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 more important new keystrokes are shown below :
+<ul>
+       <li><strong>Page Up</strong> and <strong>Page Down</strong>
+       scrolls through the alignment view.</li>
+       <li><strong>Control I</strong> inverts the currently selected
+       sequence set, and <strong>Control Alt I</strong> will invert the
+       currently selected set of columns.
+       <li><strong>Control V</strong> will paste the contents of the
+       clipboard to the current alignment window, and <strong>Control
+       Shift V</strong> pastes the data to a new window.</li>
+       <li><strong>Control O</strong> opens the file browser for loading
+       a new alignment or Jalview archive.</li>
+       <li><strong>Control S</strong> saves the alignment with the
+       current filename and format, and <strong>Control Shift S</strong> opens
+       the <strong>Save As...</strong> dialog box.</li>
+       <li><strong>Control T</strong> creates a new alignment view, and <strong>Control
+       W</strong> closes the current view, or if none remain, then the whole alignment.</li>
+       <li><strong>Control E</strong> will remove gapped columns in the alignment.</li>
+       <li><strong>Control D</strong> opens the <strong>Remove Redundancy</strong> dialog box.</li>
+</ul>
+</p>
+</body>
+</html>
index e18e273..7181e36 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Overview Window</title></head>
+<body>
+<p><strong>View&#8594;Overview window</strong></p>
+<p>Select the overview window menu item to get a navigable image of the whole alignment.
+</p>
+<p>The red box indicates the currently viewed region of the alignment, this  
+  may be moved by clicking and dragging with the mouse.</p>
+<p><img src="overview.gif" width="407" height="137"></p>
+<p>&nbsp;</p>
+</body>
+</html>
index e18e273..f22424a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>PDB Viewer</title>
+</head>
+<body>
+<p><strong>The Jalview internal PDB Viewer</strong><br>
+Since Jalview 2.3, the <a href="jmol.html">Jmol PDB Viewer</a> is
+the main method for <a href="viewingpdbs.html">viewing PDB
+structures</a>. The documentation below concerns the original Jalview
+PDB viewer, which is only used in situations where Jmol is unavailable
+or cannot operate.</p>
+<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>, and the PDB Viewer will only be associated with the
+particular alignment view from which it was opened.</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>
+               <!--  NOT YET IMPLEMENTED <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 e18e273..e0aadf3 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Preferences</title>
+</head>
+
+<body>
+<p><strong>Preferences</strong></p>
+<p>There are four tabs in the Preferences dialog box:
+<ul>
+       <li>The <a href="#visual"><strong>&quot;Visual&quot;</strong>
+       Preferences</a> tab allows you to configure the default display for a new
+       alignment window.</li>
+       <li>The <a href="#connections"><strong>&quot;Connections&quot;</strong>
+       Preferences</a> tab allows you to change the links made from Jalview to
+       your default web browser.</li>
+       <li>The <a href="#output"><strong>&quot;Output&quot;</strong>
+       Preferences</a> tab contains settings affecting the export of sequence
+       alignments and EPS files.</li>
+       <li>The <a href="#editing"><strong>&quot;Editing&quot;</strong>
+       Preferences</a> tab contains settings affecting the export of sequence
+       alignments and EPS files.</li>
+       <li>The <a href="dassettings.html"><strong>&quot;DAS
+       Settings&quot;</strong> Preferences</a> tab allows you to select which DAS sources
+       to use when fetching DAS Features.</li>
+</ul>
+</p>
+<p><strong><a name="visual">Visual</a> Preferences tab</strong></p>
+<p><em>Maximise Window</em> - If this is selected, a new alignment
+window will stretch to fit the available space.</p>
+<p><em>Open Overview Window</em> - When this is selected, the <a
+       href="overview.html">alignment overview</a> panel is opened by default
+for a new alignment window.</p>
+<p><em>Show Annotations</em> - If this is selected the new window
+will display an annotation panel below the sequences. This annotation
+panel may have several rows describing the whole alignment. The 3
+standard annotations <em>Conservation</em>, <em>Quality</em> and <em>Consensus</em>
+for the alignment may be shown or hidden by default using the checkboxes
+below.</p>
+<p><em>Show group: Conservation and Consensus</em> controls the
+display of per-group automatic annotation.</p>
+<p><em>Consensus: Histogram and Logo</em> checkboxes control the
+display of the consensus histogram and sequence logo for consensus
+annotation rows.</p>
+<p><em>Full Sequence ID</em> - If selected the ID panel will display
+the name of a sequence plus the start and end residues in the format
+name/start-end. If not selected, the displayed ID will be the name of
+the sequence.</p>
+<p><em>Right Align IDs</em> - select to align all sequence IDs to
+the left-hand edge of the sequence alignment, rather than the left-hand
+edge of the alignment display window.</p>
+<p><em>Font</em> - The default font name, size and style can be set
+for a new alignment window.</p>
+<p><em>Sequence ID Tooltip</em>: Control the display of Database
+References and Non-positional annotation in the tooltip displayed when
+the mouse is over a sequence's ID.</p>
+<p><em>Sequence Name Italics</em> - select to apply the italicised
+vbersion of the font to sequence labels.</p>
+<p><em>Smooth Font</em> - Toggles anti-aliasing on / off for faster
+rendering of the alignment.</p>
+<p><em>Wrap Alignment</em> - Select whether to open new alignment
+windows in wrapped mode or not.</p>
+<p><em>Gap Symbol</em> - The default gap symbol may be set to either
+&quot;-&quot; or &quot;.&quot;</p>
+<p><em>Colour</em> - The default colour scheme for a new alignment
+window. If the chosen option is &quot;User Defined&quot; then the last
+User Defined Colour loaded or saved via the User Defined Colours panel
+will be loaded.</p>
+<p><em>Sort by</em> - When the alignment is loaded in, it will can
+be sorted by Id or pairwise identity.</p>
+<p><em>Open file</em> - If this is selected then the default
+alignment file will be opened when Jalview is started. You can change
+the default file by clicking on file name and either typing in the file
+path or selecting it from the file chooser window.</p>
+<p><a name="connections"><strong>&quot;Connections&quot;
+Preferences tab</strong></a></p>
+<p><em>URL Link From Sequence ID</em><br>
+These definitions are used to generate URLs from a sequence's ID or
+database cross references. Read more about <a
+       href="../webServices/urllinks.html#urllinks">configuring URL links
+here</a>.</p>
+<p><em>Default Browser (Unix)</em><br>
+Its difficult in Java to detect the default web browser for Unix users.
+If Jalview can't find your default web browser, enter the name or full
+path to your web browser application.</p>
+<p><em>Proxy Server</em><br>
+If you normally use a proxy server for using the internet, you must tick
+the box &quot;Use a Proxy Server&quot; and enter the address and port
+details as necessary. Web Services will not work if you are using a
+proxy server and do not enter the settings here.</p>
+<p><em>Usage statistics, Questionnaire and Version checks</em><br>
+Uncheck these options to prevent Jalview from submitting usage
+statistics to google analytics, checking for jalview questionnaires or
+retrieving details of the latest release version (at www.jalview.org).
+See the <a href="../privacy.html">user privacy statement</a> for more
+information.</p>
+<p><a name="output"><strong>Output Preferences tab</strong></a></p>
+<p><em>EPS Rendering Style</em><br>
+This is a selection box which allows the user to set a default rendering
+style for EPS export:
+<ul>
+       <li>&quot;Lineart&quot;<br>
+       EPS files will accurately reproduce the alignment view in Jalview and
+       all characters will be converted into line art. Files generated in this
+       way are large and are not easily editable, but have no font table
+       dependencies.</li>
+       <li>&quot;Text&quot;<br>
+       EPS files will be a mixture of text and lineart. This produces compact
+       files that can be edited easily in programs like Microsoft Word and
+       Adobe Illustrator, but can be problematic if the fonts available to
+       jalview are not accessible by the program reading the EPS file.
+       <li>&quot;Prompt each time&quot;<br>
+       Choose this to be asked select between Lineart and Text each time you
+       make an EPS file.</li>
+</ul>
+</p>
+<p><em>Sequence//Start-End Numbering</em><br>
+The output tab also has a group of checkboxes for each file format. If
+these are ticked, then Jalview will write files with the start and end
+sequence positions appended to each sequence id: <pre>
+  >ID/1-10
+  AACDEAAFEA
+</pre>
+<p>If the boxes are left unchecked for a particular format, the
+sequence limits will not be appended to the sequence id.</p>
+</p>
+<p><em>Use Modeller Output</em></p>
+<p>This option only applies to PIR format output. Jalview
+automatically reads PIR files with sequence descriptions compatible with
+the program <a href="http://salilab.org/modeller/">Modeller</a>. If this
+option is selected <a href="../io/modellerpir.html">Jalview will
+write Modeller style PIR files</a> with correct start/end numbering and PDB
+file association (if available). The Jalview id/start-end option is
+ignored if Modeller output is selected.
+<p><a name="editing"><strong>Editing Preferences tab</strong></a></p>
+<p>There are currently 2 options available which can be selected /
+deselected.</p>
+<p><em>AutoCalculate Consensus</em> - For large alignments it can be
+useful to deselect &quot;Autocalculate Consensus&quot; when editing.
+This prevents lengthy calculations which are performed after each
+sequence edit. New alignment windows will have their &quot;Autocalculate
+Consensus&quot; option set according to this setting.</p>
+<p><em>Pad gaps when editing</em> - New alignment windows will
+&quot;Pad Gaps&quot; according to this setting.</p>
+<p>&nbsp;</p>
+<p>&nbsp;</p>
+</body>
+</html>
index 1737668..6afbcdb 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Search</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..0c9313e 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Sequence Features</title>
+</head>
+<body>
+<p><strong>Sequence Features</strong></p>
+<p>Jalview can colour parts of a sequence based on the presence of
+sequence features - which may be retrieved from database records (such
+as Uniprot), the result of <a href="search.html">sequence motif
+searches</a> or simply read from a <a href="featuresFormat.html">sequence
+features file</a>. You can also <a href="creatinFeatures.html">create
+features</a> from the results of searches or the current selection, and <a
+       href="editingFeatures.html">edit features</a> by double clicking on
+them.</p>
+<p><strong>Sequence Feature Colouring Styles</strong></p>
+<p>By default, Jalview will assign a color to each feature based on
+its type. These colours can be changed from the <a
+       href="featuresettings.html">feature settings</a> and <a
+       href="editingFeatures.html">amend features</a> dialog boxes. Since
+Jalview 2.5, it is also possible to define <a href="featureschemes.html">feature
+colourschemes</a> to shade features based on their associated scores or text
+labels.</p>
+<p><strong>Sequence Feature Groups</strong></p>
+<p>Since Jalview 2.08, sequence features assigned to a sequence can
+be organised into groups, which may indicate that the features were all
+retrieved from the same database (such as Uniprot features), or
+generated by the same analysis process (as might be specified in a <a
+       href="featuresFormat.html">sequence features file</a>).</p>
+<p><strong>Sequence Feature Inheritance</strong></p>
+<p>Since Jalview 2.08, sequence features are <em>global</em> to a
+set of sequences appearing (independently or together) in many different
+alignments. Practically, this means features loaded onto one alignment
+can be viewed in any alignments involving the same sequences. The same
+sequence appears in different alignments when a new alignment is
+generated by submitting an existing set of sequences to one of the
+alignment or prediction web services, and when sequences are copied and
+pasted into other alignment windows.</p>
+<p><strong>View&#8594;Show Sequence Features</strong></p>
+<p>Toggle the display of sequence features in this alignment. If
+feature retrieval has not already been carried out, then Jalview will
+automatically try to fetch sequence features (as described below).</p>
+<p><strong>View&#8594;Sequence Feature Settings...</strong></p>
+<p>Once sequence features have been loaded, their display can be
+fully controlled using the alignment window's <a
+       href="featuresettings.html">Sequence Feature Settings</a> dialog box.
+Feature colour schemes and display parameters are unique to a particular
+alignment, so it is possible to colour the same sequence features
+differently in different alignment views.<br>
+Since Jalview 2.1, it is possible to add <a href="dassettings.html">DAS
+features</a> to an alignment via the DAS tabbed pane of the feature settings
+window.</p>
+<p><strong>View&#8594;Sequence ID Tooltip&#8594;Show
+Non-Positional features</strong><br>
+<em>Only available in application</em></br>
+</p>
+<p>Toggles the display of non-positional features in the sequence ID
+tooltip, and whether they will be included when sequence features are
+exported using &quot;File&#8594;Export Features&quot;.</p>
+<p>Precalculated Sequence Features may be added to an alignment from
+the command line, drag and drop, or from the &quot;File&#8594;Load
+Features / Annotations&quot; menu item. See the <a
+       href="featuresFormat.html">Features File Format</a> for more details.</p>
+</body>
+</html>
index e18e273..d8415c7 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Sequence Fetcher</title></head>
+<body>
+<p><strong>Sequence Fetcher</strong></p>
+<p>Jalview can retrieve sequences from certain databases using either the
+WSDBFetch service provided by the European Bioinformatics Institute, and, since Jalview 2.4, DAS servers capable of the <em>sequence</em> command (configured in <a href="dassettings.html">DAS settings</a>).</p>
+<img src="seqfetcher.gif" align="center" alt="The Jalview Sequence Fetcher Dialog Box">
+<p>The Sequence Fetcher dialog box can be opened via the &quot;File&quot; 
+  menu on the main desktop in order to retrieve sequences as a new
+  alignment, or opened via the &quot;File&quot; menu of an existing alignment
+  to import additional sequences. Please note, there will be a short delay when the sequence fetcher is first opened, 
+  whilst Jalview compiles the list of available sequence datasources from the 
+  currently defined DAS server registry.</strong>
+</p>
+<p>First, select the database you want to retrieve sequences from. Then, enter
+  one or more accession ids (as a semi-colon separated list), or press the 
+  &quot;Example&quot; button to paste the example accession for the currently selected database into the retrieval box.
+   Finally, press &quot;OK&quot; to initiate the retrieval.</p>
+<p>
+  If you are retrieving sequences from the PDB, you can retrieve
+  specific chains by appending a colon and the chain id to the PDB
+  id. For example :<br><pre> 1GAQ:A</pre><br>When retrieving from DAS sequence sources,
+  coordinate range arguments can be passed to the server using the standard DAS 
+  sequence command format (<strong>:&lt;start&gt;,&lt;end&gt;</strong>)</p>
+<p>If you use the WSDBFetch sequence fetcher services (EMBL, Uniprot, PDB and PFAM)
+   in work for publication, please cite:</p>
+<p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S., Tate J., Velankar 
+  S., Golovin A., Henrick K., Rice P., Stoehr P., Lopez R. <br>
+  SOAP-based services provided by the European Bioinformatics Institute.<br>
+  Nucleic Acids Res. 33(1):W25-W28 (2005) <br>
+  <br>
+  </p>
+</body>
+</html>
index 66edaf9..f2a9dbd 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<head>\r
+<title>Mapping Between Different Sequences</title>\r
+</head>\r
+<body>\r
+<p><strong>Mapping Between Different Sequences</strong></p>\r
+<p>A new feature in Jalview 2.3 is the ability to map between sequences in different \r
+  domains, based on alignment, or by the use of explicit mappings provided by \r
+  databases. </p>\r
+<p>The most familiar mapping is the one used to identify\r
+the coordinates corresponding to a displayed sequence when\r
+viewing a PDB file associated with a sequence (see \r
+<a href="viewingpdbs.html">&quot;Viewing PDB Files&quot;</a> \r
+for more information.</p>\r
+<p>The newest form of mapping supported by Jalview is the \r
+correspondence between DNA and protein sequences. This mapping\r
+can be imported directly from EMBL and EMBLCDS database records \r
+retrieved by the <a href="seqfetch.html">Sequence Fetcher</a>, \r
+and allows sequence features to be mapped directly from Uniprot \r
+das sources to their coding region on EMBL sequence records.\r
+</body>\r
+</html>\r
index e18e273..d979254 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>PDB Viewing</title></head>
+<body>
+<p><strong>Viewing PDB Structures</strong></p>
+<p>Jalview can view protein structures associated with a sequence via the <strong>&quot;Structure&#8594;View 
+  PDB entry:&quot;</strong> entries from a sequence's <a
+  href="../menus/popupMenu.html">pop-up menu</a>. This will open an
+  interactive display of the structure in a new window, or prompt you
+  to associate the sequence with an existing view of the selected
+  structure. See the <a href="jmol.html">Jmol PDB viewer</a> help page
+  for more information about the display.
+</p>
+<p>To associate PDB files with a sequence, right click on a sequence ID and select 
+  &quot;Structure<strong>&#8594;</strong> Associate Structure with Sequence&quot;, 
+  and one of the submenus:</p>
+<ul>
+  <li>From File - You can load a PDB file from the local machine or network and 
+    associate it with the selected sequence. PDB files associated in this way 
+    will also be saved in the <a href="jalarchive.html">Jalview Archive file</a>. <br>
+  </li>
+  <li>Enter PDB Id - Jalview will use WSDBFetch, provided by the EBI, to fetch 
+    the PDB file with the entered Id.<br>
+  </li>
+  <li>Discover PDB Ids - Jalview uses WSDBFetch, provided by the EBI, to discover 
+    PDB ids for all the sequences in the alignment which have valid Uniprot names 
+    / accession ids. </li>
+</ul>
+<p><strong>Importing PDB Entries or files in PDB format</strong><br>
+You can retrieve sequences from the PDB using the <a
+  href="seqfetch.html">Sequence Fetcher</a>. Any sequences retrieved with this 
+  service are automatically associated with their source database entry. For PDB 
+  sequences, simply select PDB as the database and enter your known PDB id (appended 
+  with ':' and a chain code, if desired).
+<br>Jalview will also read PDB files directly. Simply load in the file
+as you would an alignment file. The sequences of any peptide chains
+will be extracted from the file and viewed in the alignment window.
+<br><em>Note for jalview applet users: due to the applet security
+constraints, PDB Files can currently only be imported by cut and paste
+of the PDB file text into the text box opened by the 'From File' entry
+of the structure menu.</p>
+<p><strong>Viewing the PDB Residue Numbering</strong><br>
+Sequences which have PDB entry or PDB file associations are annotated
+with sequence features from a group named with the associated PDB
+accession number or file name. Each feature gives the corresponding
+PDB Residue Number for each mapped residue in the seuqence. The
+display of these features is controlled through the
+<strong>&quot;View&#8594;Sequence Features&quot;</strong> menu item
+and the <a href="featuresettings.html">Feature Settings dialog
+box</a>.</p> 
+</body>
+</html>
index e18e273..be160db 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Wrap Alignment</title></head>
+
+<body>
+<p><strong>View&#8594;Wrap alignment </strong></p>
+<p>Use this feature to wrap an alignment to the screen width. </p>
+<p>All output (HTML, Printing, JPG etc) will also be in this wrapped format.</p>
+<p>This is most useful when looking at alignments with less than 20 sequences.
+</p>
+<table width="480" border="1">
+  <tr><td>
+
+<table border="0"  cellpadding="0" cellspacing="0">
+        <tr>
+          <td colspan="6">&nbsp;</td>
+          <td colspan="9">10<br>
+            |</td>
+          <td></td>
+          <td colspan="9">20<br>
+            |</td>
+          <td></td>
+        </tr>
+        <tr>
+          <td nowrap>ADHR_DROPS/7-107&nbsp;&nbsp;</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#1ab3b3">H</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">C</td>
+          <td bgcolor="#1ab3b3">Y</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td>D</td>
+          <td bgcolor="#80b3e6">C</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td>A</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>E</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#1acc1a">S</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">M</td>
+          <td>T</td>
+          <td bgcolor="#e6331a">K</td>
+          <td>N</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">A</td>
+        </tr>
+        <tr>
+          <td nowrap>ADH_DROHE/5-105&nbsp;&nbsp;</td>
+          <td>S</td>
+          <td>N</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#1acc1a">S</td>
+          <td bgcolor="#e6331a">R</td>
+          <td>E</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td>K</td>
+          <td>S</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#cccc00">P</td>
+          <td>K</td>
+        </tr>
+        <tr>
+          <td nowrap>PGDH_HUMAN/6-106&nbsp;&nbsp;</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#e6994d">G</td>
+          <td>A</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td>Q</td>
+          <td bgcolor="#e6994d">G</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#e6994d">G</td>
+          <td>R</td>
+          <td>A</td>
+          <td>F</td>
+          <td>A</td>
+          <td bgcolor="#cc4dcc">E</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>L</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#e6994d">G</td>
+          <td>.</td>
+          <td bgcolor="#80b3e6">A</td>
+        </tr>
+        <tr>
+          <td height="5"></td>
+        </tr>
+        <tr>
+          <td colspan="6">&nbsp;</td>
+          <td colspan="9">36<br>
+            |</td>
+          <td></td>
+          <td colspan="9">46<br>
+            |</td>
+          <td></td>
+        </tr>
+        <tr>
+          <td nowrap>ADHR_DROPS/7-107&nbsp;&nbsp;</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>Q</td>
+          <td>S</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td>E</td>
+          <td bgcolor="#1acc1a">N</td>
+          <td bgcolor="#cccc00">P</td>
+          <td bgcolor="#cccc00">P</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>A</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#1acc1a">Q</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>Q</td>
+        </tr>
+        <tr>
+          <td nowrap>ADH_DROHE/5-105&nbsp;&nbsp;</td>
+          <td>N</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td>R</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td bgcolor="#1acc1a">N</td>
+          <td bgcolor="#cccc00">P</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td>A</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#cc4dcc">E</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>K</td>
+        </tr>
+        <tr>
+          <td nowrap>PGDH_HUMAN/6-106&nbsp;&nbsp;</td>
+          <td bgcolor="#e6331a">K</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td>W</td>
+          <td>N</td>
+          <td>L</td>
+          <td>E</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td bgcolor="#e6994d">G</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>V</td>
+          <td>Q</td>
+          <td bgcolor="#80b3e6">C</td>
+          <td>K</td>
+          <td>A</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td>L</td>
+        </tr>
+        <tr>
+          <td height="5"></td>
+        </tr>
+        <tr>
+          <td colspan="6">&nbsp;</td>
+          <td colspan="9">62<br>
+            |</td>
+          <td></td>
+          <td colspan="9">72<br>
+            |</td>
+          <td></td>
+        </tr>
+        <tr>
+          <td nowrap>ADHR_DROPS/7-107&nbsp;&nbsp;</td>
+          <td>S</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td>K</td>
+          <td bgcolor="#1ab3b3">H</td>
+          <td>S</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>T</td>
+          <td>Q</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#80b3e6">W</td>
+          <td>T</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#80b3e6">M</td>
+          <td bgcolor="#80b3e6">A</td>
+          <td>R</td>
+          <td bgcolor="#cc4dcc">E</td>
+          <td bgcolor="#cc4dcc">E</td>
+          <td>M</td>
+        </tr>
+        <tr>
+          <td nowrap>ADH_DROHE/5-105&nbsp;&nbsp;</td>
+          <td>A</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td>N</td>
+          <td bgcolor="#cccc00">P</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>K</td>
+          <td>V</td>
+          <td>T</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#1ab3b3">Y</td>
+          <td bgcolor="#cccc00">P</td>
+          <td bgcolor="#1ab3b3">Y</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td bgcolor="#cccc00">P</td>
+          <td>L</td>
+          <td>A</td>
+          <td bgcolor="#cc4dcc">E</td>
+          <td>T</td>
+        </tr>
+        <tr>
+          <td nowrap>PGDH_HUMAN/6-106&nbsp;&nbsp;</td>
+          <td>D</td>
+          <td>E</td>
+          <td>Q</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td>E</td>
+          <td bgcolor="#cccc00">P</td>
+          <td>.</td>
+          <td>.</td>
+          <td>.</td>
+          <td>Q</td>
+          <td>K</td>
+          <td bgcolor="#1acc1a">T</td>
+          <td bgcolor="#80b3e6">L</td>
+          <td bgcolor="#80b3e6">F</td>
+          <td bgcolor="#80b3e6">I</td>
+          <td>Q</td>
+          <td bgcolor="#80b3e6">C</td>
+          <td bgcolor="#cc4dcc">D</td>
+          <td bgcolor="#80b3e6">V</td>
+          <td>A</td>
+          <td>D</td>
+          <td>Q</td>
+          <td>Q</td>
+          <td bgcolor="#1acc1a">Q</td>
+          <td>L</td>
+          <td>.</td>
+        </tr>
+        <tr>
+          <td height="5"></td>
+        </tr>
+
+
+      </table>
+</table>
+
+
+</body>
+</html>
index e18e273..293790e 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Home Page</title></head>
+
+<body>
+<IMG src="align.jpg"><font size="4">
+<br><br>
+<strong>Jalview Documentation</strong></font>
+<br><br>
+Jalview (2009) is a fast Java multiple alignment editor and analysis tool. It
+features many of the functions of <a href="http://www.compbio.dundee.ac.uk/Software/Amas/amas.html">AMAS</a>,
+for the analysis of sub-families and the prediction of functional sites, but is
+fully interactive. (View the <a href="http://www.jalview.org">Jalview homepage</a>).
+<p></p>
+<p> If you use Jalview in your work, please cite the Jalview 2 paper in Bioinformatics: </p>
+<p>Waterhouse, A.M., Procter, J.B., Martin, D.M.A, Clamp, M., Barton, G.J (2009), <br>
+   &quot;Jalview version 2: A Multiple Sequence Alignment and Analysis Workbench,&quot;<br>
+   <em>Bioinformatics</em> <strong>25</strong> (9) 1189-1191 doi: 10.1093/bioinformatics/btp033
+</body>
+</html>
index e18e273..0b4b721 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Exporting alignments as artwork</title>
+</head>
+<body>
+<p><strong>Exporting alignments as graphics and lineart<a name="export"></a></strong></p>
+<p>The alignment view can be printed using
+<strong>File&#8594;Print</strong>, or exported in a number of ways via the
+<strong>File&#8594;Export</strong> menu:
+<ul>
+<li>HTML<br><em>for viewing in a web browser</em>
+</li>
+<li>PNG - a Portable Networks Graphics image<br><em>For low quality
+diagrams and powerpoint presentations</em>
+</li>
+<li>EPS - an Encapsulated Postscript Document<br><em>For high quality
+diagrams and publications.</em>
+</li></ul>
+  
+<p><em>Tips for working with EPS Files</em></p>
+<li>The EPS file generated by jalview contains vector graphics which are directly 
+  editable in graphics applications such as Adobe Illustrator.</li>
+<li>EPS files can be produced as &quot;Text&quot; or &quot;Lineart&quot;. Use 
+  &quot;Text&quot; if you want the final document to be MUCH smaller in diskspace 
+  and be able to search, edit and select text. Use &quot;Lineart&quot; if you 
+  want an exact image of the alignment as displayed in Jalview. This is useful 
+  if a 3rd Party EPS viewer does not have the same Font which the EPS file was 
+  created with.</li>
+<li>When importing an EPS into to a Microsoft office document, a snapshot image of the
+  file will be displayed which often looks blurred. Right-click the
+  image and choose &quot;Edit image.&quot; to convert it to word
+  drawing objects which give a truer WYSIWIG representation.
+  </li>
+  <li>
+  Mac OSX users will find that eps files are automatically converted into
+  PDF files. 
+  </li>
+</p>
+</body>
+</html>
index 797a7c4..c62c077 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Alignment Fileformats</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 <body>
index e18e273..b149bfc 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<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 help@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 e18e273..65e41bc 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Modeller PIR Format IO</title>
+</head>
+<body>
+<p><strong>Modeller PIR Format IO</strong></p>
+<p>The homology modelling program, <a
+href="http://salilab.org/modeller/">Modeller</a> uses a special form
+of the PIR format where information about sequence numbering and chain
+codes are written into the 'description' line between the PIR protein
+tag and the protein alignment entry:</p>
+<pre>&gt;P1;Q93Z60_ARATH
+sequence:Q93Z60_ARATH:1:.:118:.:.
+----MASTALSSAIVSTSFLRRQQTPISLRSLPFANT-QSLFGLKS-STARGGRVTAMATYKVKFITPEGEQ
+EVECEEDVYVLDAAEEAGLDLPYSCRAGSCSSCAGKVVSGSIDQSD------QSFLD-D-------------
+---------------------*
+&gt;P1;PDB|1FER|_
+structureX:1FER:1:.:105:.:.
+----------------------------------------------------AFVVTDNCIKCKY---TDCV
+EV-CPVDCFY----EGPNFLVIHPDECIDCALCEPECPAQAIFSEDEVPEDMQEFIQLNAELAEVWPNITEK
+KDPLPDAEDWDGVKGKLQHLE*
+</pre>
+<p>Jalview will attempt to parse any PIR entries conforming to the
+Modeller/PIR format, in order to extract the sequence start and end
+numbering and (possibly) a PDB file reference. The description line
+information is always stored in the sequence description string - so
+no information is lost if this parsing process fails.</p>
+<p>The 'Modeller Output' flag in the 'Output' tab of the Jalview <a href="../features/preferences.html">Preferences dialog
+box</a> controls whether Jalview will also output MODELLER style PIR
+files. In this case, any existing 'non-modeller PIR' header
+information in the description string of an alignment is appended to
+an automatically generated modeller description line for that
+sequence.</p>
+<p>The general format used for generating the Modeller/PIR sequence
+description line is shown below :
+<pre>&gt;P1;<em>Primary_Sequence_ID</em>
+<em>sequence or structureX</em>:<em>pdb-reference if
+  available</em>:<em>start residue</em>:<em>start chain code</em>:<em>end
+  residue</em>:<em>end chain code</em>:. <em>description text</em></pre>
+The first field is either sequence or structureX, depending upon the
+presence of a PDB database ID for the sequence. If the protein has no
+PDB reference, then the chain code is not specified, unless one
+already existed when the sequence was imported into Jalview.
+</body>
+</html>
index e18e273..0eacdb4 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Jalview local Jnlp File</title>
+</head>
+<body>
+<h1>Jalview local Jnlp File</h1>
+<pre>
+&lt;jnlp spec="1.0+" codebase="http://www.jalview.org/webstart/" href="http://www.jalview.org/webstart/jalview.jnlp"&gt;
+  &lt;information&gt;
+    &lt;title&gt;Jalview&lt;/title&gt;
+    &lt;vendor&gt;The Barton Group&lt;/vendor&gt;
+    &lt;homepage href="http://www.jalview.org"/&gt;
+    &lt;description&gt;Jalview Multiple Alignment Editor&lt;/description&gt;
+    &lt;description kind="short"&gt;Jalview&lt;/description&gt;
+    &lt;icon href="http://www.jalview.org/webstart/logo_big.gif" kind="default"/&gt;
+    &lt;association extensions="fa" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="fasta" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="fastq" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="blc" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="msf" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="pfam" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="aln" mime-type="application-x/ext-file"/&gt;
+    &lt;association extensions="pir" mime-type="application-x/ext-file"/&gt;
+    &lt;offline-allowed/&gt;
+  &lt;/information&gt;
+  &lt;security&gt;
+    &lt;all-permissions/&gt;
+  &lt;/security&gt;
+  &lt;resources&gt;
+  &lt;!-- <em>the additional memory parameters are here</em> --&gt;
+  &lt;j2se version="1.4+" initial-heap-size="500M" max-heap-size="1000M"/&gt;
+    &lt;jar href="jalview.jar"/&gt;
+               &lt;jar href="JGoogleAnalytics_0.2.jar"/&gt;
+               &lt;jar href="Jmol-11.0.2.jar"/&gt;
+               &lt;jar href="activation.jar"/&gt;
+               &lt;jar href="axis.jar"/&gt;
+               &lt;jar href="castor-1.1-cycle-xml.jar"/&gt;
+               &lt;jar href="commons-discovery.jar"/&gt;
+               &lt;jar href="commons-logging.jar"/&gt;
+               &lt;jar href="jaxrpc.jar"/&gt;
+               &lt;jar href="jhall.jar"/&gt;
+               &lt;jar href="log4j-1.2.8.jar"/&gt;
+               &lt;jar href="mail.jar"/&gt;
+               &lt;jar href="regex.jar"/&gt;
+               &lt;jar href="saaj.jar"/&gt;
+               &lt;jar href="vamsas-client.jar"/&gt;
+               &lt;jar href="wsdl4j.jar"/&gt;
+               &lt;jar href="xercesImpl.jar"/&gt;
+               &lt;jar href="xml-apis.jar"/&gt;
+               &lt;property name="jalview.version" value="2.4.0.b2"/&gt;
+  &lt;/resources&gt;
+  &lt;application-desc main-class="jalview.bin.Jalview"/&gt;
+&lt;/jnlp&gt;
+</pre>
+<address>
+<a
+href="http://www.jalview.org/mailman/listinfo/jalview-discuss">If you have problems, send an email to jalview-discuss</a>
+</address>
+</body>
+</html>
index e18e273..161f709 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Key Strokes</title></head>
+<body>
+<p><strong>Key Strokes</strong></p>
+<p>
+Jalview has two distinct modes of keyboard operation - in 'Normal'
+ mode, single keystrokes (including those shown next to menu items)
+ provide short cuts to common commands. In <a
+ href="features/cursorMode.html">'Cursor'</a> mode (enabled by
+ <em>F2</em>), some of these are disabled and more complex 'Compound
+ Keystrokes' can be entered to perform precise navigation, selection
+ and editing operations.
+</p>
+<table border="1">
+  <tr> 
+    <td><strong>Key</strong></td>
+    <td><strong>Which Mode</strong></td>
+    <td><strong>Action</strong></td>
+  </tr>
+  <!--<tr>
+<td><strong>Escape</strong></td><td>Both</td>
+<td>The Panic button.</td></tr>
+<tr> -->
+  <tr> 
+    <td><strong> Escape</strong></td>
+    <td>Normal</td>
+    <td>Clears the current selection region, highlighted columns and highlghted 
+      residues. </td>
+  </tr>
+  <tr> 
+    <td><strong>Escape</strong></td>
+    <td>Cursor</td>
+    <td>As in normal mode, but also cancels any partially entered commands</td>
+  </tr>
+  <tr> 
+    <td><strong><em>F1</em></strong></td>
+    <td>Both</td>
+    <td>Show Help Documentation</td>
+  </tr>
+  <tr> 
+    <td><strong><em>F2</em></strong></td>
+    <td></td>
+    <td>Toggle Cursor mode on / off</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'Z'</strong></td>
+    <td>Both</td>
+    <td>Undoes the last sequence edit</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'Y'</strong></td>
+    <td>Both</td>
+    <td>Redo the last sequence edit undone.</td>
+  </tr>
+  <tr> 
+    <td><strong>Up Arrow</strong></td>
+    <td>Normal</td>
+    <td>Moves selected sequence(s) up the alignment</td>
+  </tr>
+  <tr> 
+    <td><strong>Down Arrow</strong></td>
+    <td>Normal</td>
+    <td>Moves selected sequence(s) down the alignment.</td>
+  </tr>
+  <tr> 
+    <td><strong>Left Arrow</strong></td>
+    <td>Normal </td>
+    <td>Slides selected sequence(s) left. Press Alt key to slide in cursor mode</td>
+  </tr>
+  <tr> 
+    <td><strong>Right Arrow</strong></td>
+    <td>Normal</td>
+    <td>Slides selected sequence(s) right. Press Alt key to slide in cursor mode</td>
+  </tr>
+  <tr> 
+    <td><strong>Cursor Keys<br>
+      (Arrow Keys)</strong></td>
+    <td>Cursor</td>
+    <td>Move cursor around alignment</td>
+  </tr>
+  <tr> 
+    <td><strong>Page Up</strong></td>
+    <td>Both</td>
+    <td>Scroll up the alignment view</td>
+  </tr>
+  <tr> 
+    <td><strong>Page Down</strong></td>
+    <td>Both</td>
+    <td>Scroll down the alignment view</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'A'</strong></td>
+    <td>Both</td>
+    <td>Selects all sequences in the alignment</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'I'</strong></td>
+    <td>Both </td>
+    <td>Invert sequence selection. </td>
+  </tr>
+  <tr> 
+    <td><strong>Control Alt 'I'</strong></td>
+    <td>Both </td>
+    <td>Invert column selection. </td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'C'</strong></td>
+    <td>Both</td>
+    <td>Copies the selected region into the clipboard as a Fasta format file<br> 
+      <em>nb. not available in applet, as no clipboard is available</em></td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'V'</strong></td>
+    <td>Both</td>
+    <td> Paste the contents of the clipboard to the current alignment window. 
+      (Alignment Window->Edit->Paste->Add to this Alignment)<br> <em>nb. if the 
+      paste is from a Jalview alignment, any sequence and alignment annotations 
+      will also be copied over.</em></td>
+  </tr>
+  <tr> 
+    <td><strong>Control Shift 'V'</strong></td>
+    <td>Both</td>
+    <td>Paste the contents of the clipboard to a new alignment window. (Alignment 
+      Window->Edit->Paste->To New Alignment)</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'X'</strong></td>
+    <td>Both</td>
+    <td>Cuts the (fully) selected sequences from the alignment. 
+      <!-- not yet in this version 
+This will not happen if only some
+columns are selected, you should use the <a href="features/regionHiding.html">Hide Regions feature</a> instead.-->
+    </td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'F'</strong></td>
+    <td>Both</td>
+    <td>Launches the search window</td>
+  </tr>
+  <tr> 
+    <td><strong>H</strong></td>
+    <td>Both</td>
+    <td>Hides / Reveals selected columns and sequences</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'H'</strong></td>
+    <td>Both</td>
+    <td>Hides / Reveals selected columns</td>
+  </tr>
+  <tr> 
+    <td><strong>Shift 'H'</strong></td>
+    <td>Both</td>
+    <td>Hides / Reveals selected sequences</td>
+  </tr>
+  <tr>
+    <td><strong>Control + Shift 'H'</strong></td>
+    <td>Both</td>
+    <td>Hides everything but the current selection</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'O'</strong></td>
+    <td>Both</td>
+    <td>Input new alignment from file</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'S'</strong></td>
+    <td>Both</td>
+    <td>Save alignment with current filename and format</td>
+  </tr>
+  <tr> 
+    <td><strong>Control Shift 'S'</strong></td>
+    <td>Both</td>
+    <td>Save alignment as a new file or with a different format</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'P'</strong></td>
+    <td>Both</td>
+    <td>Opens the print dialog box to print the current view</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'W'</strong></td>
+    <td>Both</td>
+    <td>Closes the current view or the current alignment</td>
+  </tr>
+  <tr> 
+    <td><strong>Backspace</strong></td>
+    <td>Normal</td>
+    <td>Delete the currently selected rows or columns from the alignment.</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'L'</strong></td>
+    <td>Left</td>
+    <td>Remove columns to left of left-most column marker.</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'R'</strong></td>
+    <td>Both</td>
+    <td>Remove columns to right of right-most column marker.</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'E'</strong></td>
+    <td>Both</td>
+    <td>Remove gapped columns</td>
+  </tr>
+  <tr> 
+    <td><strong>Control Shift 'E'</strong></td>
+    <td>Both</td>
+    <td>Remove all gaps</td>
+  </tr>
+  <tr> 
+    <td><strong>Control 'D'</strong></td>
+    <td>Both</td>
+    <td>Open the 'Remove redundancy' Dialog box.</td>
+  </tr>
+  <tr> 
+    <td><strong></strong></td>
+    <td>Normal</td>
+    <td></td>
+  </tr>
+</table>
+<p>The compound commands available in the Cursor mode are summarised
+below. Single letter commands can be prefixed by digits to specify a repetition
+number, and some more complex commands take one or more numeric
+parameters (prefixing the command key and separated by commas).</p>
+<table border=1><tr><td><strong>Compound
+Command</strong></td><td>Mode</td><td>Action (and parameter description)</td></tr>
+<tr><td><strong>0-9</strong></td><td>Cursor</td><td>Begin entering a
+numeric parameter (<strong><em>p</em></strong>) or repetition number for a cursor movement or edit
+command.</td></tr>
+<tr><td><strong>,</strong></td><td>Cursor</td><td>Separates one or
+more numeric parameters (<em>e.g. <strong>p1</strong>,<strong>p2</strong></em>) for a command.</td></tr>
+<tr><td><strong><strong><em>p1</em></strong>,<strong><em>p2</em></strong><br>Return</strong></td><td>Cursor</td><td>Move cursor to a particular column (<strong><em>p1</em></strong>) and row (<strong><em>p2</em></strong>) in the alignment.<br><em>e.g. '5,6&lt;Return&gt;' moves the cursor to the 5th column in the 6th sequence.</em></td></tr>
+<tr><td><strong><em>p</em>S</strong></td><td>Cursor</td><td>Jump to the <strong><em>p</em></strong>'th sequence in the alignment.</td></tr>
+<tr><td><strong><em>p</em>P</strong></td><td>Cursor</td><td>Jump to <em><strong>p</strong></em>'th amino acid in current sequence.</td></tr>
+<tr><td><strong><em>p</em>C</strong></td><td>Cursor</td><td>Jump to <em><strong>p</strong></em>'th column in the alignment.</td></tr>
+<tr><td><strong>Q</strong></td><td>Cursor</td><td>Marks the top left corner of the selection area</td></tr>
+<tr><td><strong>M</strong></td><td>Cursor</td><td>Marks the bottom right corner of the selection area</td></tr>
+<tr><td><strong><em>[p]</em><br>Space</strong></td><td>Cursor</td><td>Inserts
+one (or optionally <strong><em>p</em></strong>) gaps at the current position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr>
+<tr><td><strong><em>[p]</em><br>Delete<br></strong></td><td>Cursor</td><td>Removes
+one (or optionally <strong><em>p</em></strong>) gaps at the cursor position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr>
+<tr><td><strong><em>[p]</em><br>Backspace<br></strong></td><td>Cursor</td><td>Removes
+one (or optionally <strong><em>p</em></strong>) gaps at the cursor position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr></table>
+<p>&nbsp;</p>
+<p>&nbsp;</p>
+</body>
+</html>
index e18e273..30a038c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Memory Settings</title></head>
+<body>
+<h2>
+  <center>
+    <strong>Memory Usage Settings for Jalview</strong>
+  </center>
+</h2>
+<p>Jalview sometimes runs out of memory. This is because of the way that Java
+  runs on a computer - what is actually run is a program called a virtual machine
+  (the JVM) which executes the java instructions. The JVM has limits on the memory
+  that can be allocated to the java program - and you might need to increase them
+  if you are working with particularly large datasets.<br>
+  If Jalview has not explicitly told you that it has run out of memory, then a
+  common sign is that a function that normally works seems to have no effect when
+  working with a larger set of sequences (this might include open dialog boxes
+  for saving PNG files, or when interpreting the result of a web service calculation).</p>
+  <p><em>Jalview Memory Usage Monitor</em>: If you are concerned about memory, or think that things might be behaving 
+  strangely because of a shortage of memory, then you can check this by enabling the 
+  memory usage monitor. This is done by selecting the <strong>Tools&#8594;Show Memory Usage</strong>
+  option. Once enabled, the memory usage monitor displays the currently 
+  available memory, the total memory, and the percentage free at the 
+  bottom left hand side of the Jalview Desktop window's background.</p>
+<p><em>Increasing the memory available to Jalview</em><br>
+The way you increase the memory settings for the JVM depends on which installation
+  of Jalview you use:</p>
+<ul>
+  <li><em><font size="3">Web Start Version</font></em>
+    <p>JavaWS sets the JVM parameters through special tags in the JNLP file. You'll
+      need to <a href="jalviewjnlp.html">make your own jnlp file</a> and add the following parameter into the
+      &lt;resources&gt; element.
+    <pre>
+&lt;j2se version="1.4+" initial-heap-size="500M" max-heap-size="1000M"/&gt;
+</pre>
+    Save the jnlp file somewhere and then - if you start Jalview through your
+    web browser, point your browser at the file's url, othewise simply run javaws
+    with the file location as its argument. The file's url is something like :<br>
+    <pre>
+file://&lt;full path to file&gt;
+</pre>
+    If jalview doesn't start up, see <a href="#memsetting">below</a>. You'll have
+    to edit the above settings in the JNLP file using a text editor, save it,
+    and try starting Jalview with it once more.
+    <p></li>
+  <li><em><font size="3">Install Anywhere version</font></em>
+    <p> You need to change the InstallAnywhere configuration settings for the
+      application. These are found in different places depending upon which operating
+      system you have :
+    <ul>
+      <li><em>Unix/Windows</em>
+        <p> Take a look inside the Jalview program installation directory (this
+          might be in C:\Program Files\Jalview on windows). You should find a
+          file called 'Jalview.lax' in it - make a backup, and then add the following
+          lines to the end of the original file :
+        <pre>
+lax.nl.java.option.java.heap.size.max=1000m
+lax.nl.java.option.java.heap.size.initial=500m
+</pre>
+        Case and (lack of) spaces are important here! Do not add any spaces after
+        the m in each line, and do not put any spaces before 'lax'.<br>
+        Also there MUST be a carriage return after the final line.
+        <p></p>
+      </li>
+      <li><em>Mac OSX</em>
+        <p>The lines you need to change are in the <em>Info.plist</em> file inside
+          the <em>Jalview.app/Contents</em> directory (which is where the installAnywhere
+          installation was made) :
+        <pre>
+&lt;key&ht;VMOptions&lt;/key&ht;
+&lt;array&gt;
+! &lt;string&gt;-Xms2M&lt;/string&gt;
+! &lt;string&gt;-Xmx64M&lt;/string&gt;
+&lt;/array&gt;
+</pre>
+        Exchange the above two string tags for :
+        <pre>
+&lt;string&gt;-Xms500M&lt;/string&gt;
+&lt;string&gt;-Xmx1000M&lt;/string&gt;
+</pre>
+        <p></p>
+      </li>
+    </ul>
+  <li><font size="3"><em>In all cases</em></font><br>
+    Save the file and try to start Jalview in the normal way. If it doesn't start,
+    see below... </li>
+</ul>
+<font size="3"><em>Jalview doesn't start... What do the memory settings mean ?<a name="memsetting"></a></em></font>
+<p> The 1000m value corresponds to the maximum number of megabytes of space that
+  java objects can occupy. The 500m is the initial heap size that java will run
+  in - increasing this can speed up memory allocation if you know you will need
+  500 meg of memory to begin with (ie it should speed up loading large alignments).
+</p>
+<p> If, after setting the initial and maximum heap size to some large value, you
+  cannot actually start Jalview, then the max and initial sizes are too big for
+  your machine (there seems to be a physical limit related to physical RAM - email
+  the usual address to enlighten us if you know better!). Our experiments found
+  1000m to be the biggest setting that could be used on a 1GB machine. Just try
+  reducing the sizes until Jalview starts up properly! </p>
+<p>&nbsp;</p>
+</body>
+</html>
index e18e273..f23c1b7 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Alignment Window Menus</title>
+</head>
+
+<body>
+<p><strong>Alignment Window Menus</strong></p>
+       <li><strong>File</strong>
+       <ul>
+               <li><strong>Fetch Sequence</strong><br>
+               <em>Shows a dialog window in which you can select known ids from
+               Uniprot, EMBL, EMBLCDS or PDB database using Web Services provided by
+               the European Bioinformatics Institute. See <a
+                       href="../features/seqfetch.html">Sequence Fetcher</a></em>.</li>
+               <li><strong>Add Sequences</strong><em><br>
+               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>
+               <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>
+               <li><strong>Save As (Control Shift S)<br>
+               </strong><em>Save the alignment to local file. A file selection window
+               will 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, 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>
+                       <li><strong>FASTA</strong> <em></em></li>
+                       <li><strong>MSF</strong></li>
+                       <li><strong>CLUSTAL</strong></li>
+                       <li><strong>BLC</strong></li>
+                       <li><strong>PIR</strong></li>
+                       <li><strong>PFAM</strong></li>
+               </ul>
+               </li>
+               <li><strong>Print (Control P)<br>
+               </strong><em>Jalview will print the alignment using the current fonts and
+               colours of your alignment. If the alignment has annotations visible,
+               these will be printed below the alignment. If the alignment is wrapped
+               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
+                       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>
+               <ul>
+                       <li><strong>HTML<br>
+                       </strong><em>Create a <a href="../io/export.html">web page</a> from your
+                       alignment.</em></li>
+                       <li><strong>EPS<br>
+                       </strong><em>Create an <a href="../io/export.html">Encapsulated
+                       Postscript</a> file from your alignment.</em></li>
+                       <li><strong>PNG<br>
+                       </strong><em>Create a <a href="../io/export.html">Portable Network
+                       Graphics</a> file from your alignment.</em></li>
+               </ul>
+               </li>
+               <li><strong>Export Features</strong><em><br>
+               All features visible on the alignment can be saved to file or
+               displayed in a textbox in either Jalview or GFF format</em></li>
+               <li><strong>Export Annotations</strong><em><br>
+               All annotations visible on the alignment can be saved to file or
+               displayed in a textbox in Jalview annotations format. </em></li>
+               <li><strong>Load Associated Tree<br>
+               </strong><em>Jalview can <a href="../calculations/treeviewer.html">view
+               trees</a> stored in the Newick file format, and associate them with the
+               alignment. Note: the ids of the tree file and your alignment MUST be
+               the same.</em></li>
+               <li><strong>Load Features / Annotations<br>
+               </strong><em>Load files describing precalculated <a
+                       href="../features/featuresFormat.html">sequence features</a> or <a
+                       href="../features/annotationsFormat.html">alignment annotations</a>.</em></li>
+               <li><strong>Close (Control W)</strong><br>
+               <em>Close the alignment window. Make sure you have saved your
+               alignment before you close - either as a Jalview project or by using
+               the <strong>Save As</strong> menu.</em></li>
+       </ul>
+       </li>
+       <li><strong>Edit</strong>
+       <ul>
+               <li><strong>Undo (Control Z)</strong><em><br>
+               This will undo any edits you make to the alignment. This applies to
+               insertion or deletion of gaps, cutting residues or sequences from the
+               alignment or pasting sequences to the current alignment or sorting the
+               alignment. <strong>NOTE:</strong> It DOES NOT undo colour changes,
+               adjustments to group sizes, or changes to the annotation panel. </em></li>
+               <li><strong>Redo (Control Y)<br>
+               </strong><em>Any actions which you undo can be redone using redo. </em></li>
+               <li><strong>Cut (Control X)<br>
+               </strong><em>This will make a copy of the currently selected residues
+               before removing them from your alignment. Click on a sequence name if
+               you wish to select a whole sequence. <br>
+               Use &lt;CTRL&gt; and X (&lt;APPLE&gt; and X on MacOSX) to cut.</em></li>
+               <li><strong>Copy (Control C)</strong><br>
+               <em>Copies the currently selected residues to the system
+               clipboard - you can also do this by pressing &lt;CTRL&gt; and C
+               (&lt;APPLE&gt; and C on MacOSX). <br>
+               If you try to paste the clipboard contents to a text editor, you will
+               see the format of the copied residues FASTA.</em></li>
+               <li><strong>Paste </strong>
+               <ul>
+                       <li><strong>To New Alignment (Control Shift V)<br>
+                       </strong><em>A new alignment window will be created from sequences
+                       previously copied or cut to the system clipboard. <br>
+                       Use &lt;CTRL&gt; and &lt;SHIFT&gt; and V(&lt;APPLE&gt; and
+                       &lt;SHIFT;&gt; and and V on MacOSX) to paste.</em></li>
+                       <li><strong>Add To This Alignment (Control V)<br>
+                       </strong><em>Copied sequences from another alignment window can be added
+                       to the current Jalview alignment. </em></li>
+               </ul>
+               </li>
+               <li><strong>Delete (Backspace)<br>
+               </strong><em>This will delete the currently selected residues without
+               copying them to the clipboard. Like the other edit operations, this
+               can be undone with <strong>Undo</strong>.</em></li>
+               <li><strong>Remove Left (Control L)<br>
+               </strong><em>If the alignment has marked columns, the alignment will be
+               trimmed to the left of the leftmost marked column. To mark a column,
+               mouse click the scale bar above the alignment. Click again to unmark a
+               column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
+               <li><strong>Remove Right (Control R)<br>
+               </strong><em>If the alignment has marked columns, the alignment will be
+               trimmed to the left of the leftmost marked column. To mark a column,
+               mouse click the scale bar above the alignment. Click again to unmark a
+               column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
+               <li><strong>Remove Empty Columns (Control E)<br>
+               </strong><em>All columns which only contain gap characters (&quot;-&quot;,
+               &quot;.&quot;) will be deleted.<br>
+               You may set the default gap character in <a
+                       href="../features/preferences.html">preferences</a>. </em></li>
+               <li><strong>Remove All Gaps (Control Shift E)</strong><br>
+               <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be deleted
+               from the selected area of the alignment. If no selection is made, ALL
+               the gaps in the alignment will be removed.<br>
+               You may set the default gap character in <a
+                       href="../features/preferences.html">preferences</a>. </em></li>
+               <li><strong>Remove Redundancy (Control D)<br>
+               </strong><em>Selecting this option brings up a window asking you to select
+               a threshold. If the percentage identity between any two sequences
+               (under the current alignment) exceeds this value then one of the
+               sequences (the shorter) is discarded. Press the &quot;Apply&quot;
+               button to remove redundant sequences. The &quot;Undo&quot; button will
+               undo the last redundancy deletion.</em></li>
+               <li><strong>Pad Gaps<br>
+               </strong><em>When selected, the alignment will be kept at minimal width
+               (so there no empty columns before or after the first or last aligned
+               residue) and all sequences will be padded with gap characters to the
+               before and after their terminating residues.<br>
+               This switch is useful when making a tree using unaligned sequences and
+               when working with alignment analysis programs which require 'properly
+               aligned sequences' to be all the same length.<br>
+               You may set the default for <strong>Pad Gaps</strong> in the <a
+                       href="../features/preferences.html">preferences</a>. </em></li>
+       </ul>
+       </li>
+       <li><strong>Select</strong>
+       <ul>
+               <li><strong><a href="../features/search.html">Find...
+               (Control F)</a></strong><em><br>
+               Opens the Find dialog box to search for residues, sequence name or
+               residue position within the alignment and create new sequence features
+               from the queries. </em></li>
+               <li><strong>Select All (Control A)<br>
+               </strong><em>Selects all the sequences and residues in the alignment. <br>
+               Use &lt;CTRL&gt; and A (&lt;APPLE&gt; and A on a MacOSX) to select
+               all.</em></li>
+               <li><strong>Deselect All (Escape)<br>
+               </strong><em>Removes the current selection box (red dashed box) from the
+               alignment window. All selected sequences, residues and marked columns
+               will be deselected. </em><em> <br>
+               Use &lt;ESCAPE&gt; to deselect all.</em></li>
+               <li><strong>Invert Sequence Selection (Control I)<br>
+               </strong><em>Any sequence ids currently not selected will replace the
+               current selection. </em></li>
+               <li><strong>Invert Column Selection (Control Alt I)<br>
+               </strong><em>Any columns currently not selected will replace the current
+               column selection. </em></li>
+               <li><strong>Undefine Groups (Control U)<br>
+               </strong><em>The alignment will be reset with no defined groups.<br>
+               <strong>WARNING</strong>: This cannot be undone.</em></li>
+               <li><strong>Make Groups<br/></strong>
+               <em>The currently selected groups of the alignment will be 
+               subdivided according to the contents of the currently selected region. 
+               <br/>Use this to subdivide an alignment based on the 
+               different combinations of residues observed at specific 
+               positions. (new in jalview 2.5)</em></li>
+       </ul>
+       </li>
+       <li><strong>View</strong>
+       <ul>
+               <li><strong>New View (Control T)</strong><em><br>
+               Creates a new view from the current alignment view. </em></li>
+               <li><strong>Expand Views (X)</strong><em><br>
+               Display each view associated with the alignment in its own alignment
+               window, allowing several views to be displayed simultaneously. </em></li>
+               <li><strong>Gather Views (G)</strong><em><br>
+               Each view associated with the alignment will be displayed within its
+               own tab on the current alignment window. </em></li>
+               <li><strong>Show&#8594;(all Columns / Sequences / Sequences and Columns)</strong><em><br>
+               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>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 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>
+               <em>Opens the Sequence Feature Settings dialog box to control the
+               colour and display of sequence features on the alignment, and
+               configure and retrieve features from DAS annotation servers.</em></li>
+               <li><strong>Sequence ID Tooltip</strong><em> (application only)
+    <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
+               small window. A red box will indicate the currently visible area of
+               the alignment. Move the visible region using the mouse. </em></li>
+       </ul>
+       </li>
+       <li><strong>Alignment Window Format Menu</strong>
+       <ul>
+               <li><strong>Font...<br>
+               </strong><em>Opens the &quot;Choose Font&quot; dialog box, in order to
+               change the font of the display and enable or disable 'smooth fonts'
+               (anti-aliasing) for faster alignment rendering. </em></li>
+               <li><strong>Wrap<br>
+               </strong><em>When ticked, the alignment display is &quot;<a
+                       href="../features/wrap.html">wrapped</a>&quot; to the width of the
+               alignment window. This is useful if your alignment has only a few
+               sequences to view its full width at once.<br>
+               Additional options for display of sequence numbering and scales are
+               also visible in wrapped layout mode:<br>
+               <ul>
+                       <li><strong>Scale Above</strong><br>
+                       Show the alignment column position scale.</li>
+                       <li><strong>Scale Left</strong><br>
+                       Show the sequence position for the first aligned residue in each row
+                       in the left column of the alignment.</li>
+                       <li><strong>Scale Right</strong><br>
+                       Show the sequence position for the last aligned residue in each row
+                       in the right-most column of the alignment.</li>
+               <li><strong>Show Sequence Limits<br>
+               </strong><em>If this box is selected the sequence name will have the start
+               and end position of the sequence appended to the name, in the format
+               NAME/START-END</em></li>
+               <li><strong>Right Align Sequence ID<br>
+               </strong><em>If this box is selected then the sequence names displayed in
+               the sequence label area will be aligned against the left-hand edge of
+               the alignment display, rather than the left-hand edge of the alignment
+               window.</li>
+               <li><strong>Show Hidden Markers<br>
+               </strong><em>When this box is selected, positions in the alignment where
+               rows and columns are hidden will be marked by blue arrows.</li>
+               <li><strong>Boxes</strong><em><br>
+               If this is selected the background of a residue will be coloured using
+               the selected background colour. Useful if used in conjunction with
+               &quot;Colour Text.&quot; </em></li>
+               <li><strong>Text<br>
+               </strong><em>If this is selected the residues will be displayed using the
+               standard 1 character amino acid alphabet.</em></li>
+               <li><strong>Colour Text<br>
+               </strong><em>If this is selected the residues will be coloured according
+               to the background colour associated with that residue. The colour is
+               slightly darker than background so the amino acid symbol remains
+               visible. </em></li>
+               <li><strong>Show Gaps<br>
+               </strong><em>When this is selected, gap characters will be displayed as
+               &quot;.&quot; or &quot;-&quot;. If unselected, then gap characters
+               will appear as blank spaces. <br>
+               You may set the default gap character in <a
+                       href="../features/preferences.html">preferences</a>.</em></li>
+                       <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>Apply Colour To All Groups<br>
+               </strong><em>If this is selected, any changes made to the background
+               colour will be applied to all currently defined groups.<br>
+               </em></li>
+               <li><strong><a href="../colourSchemes/textcolour.html">Colour
+               Text...</a></strong><em><br>
+               Opens the Colour Text dialog box to set a different text colour for
+               light and dark background, and the intensity threshold for transition
+               between them. </em></li>
+               <li>Colour Scheme options: <strong>None, ClustalX,
+               Blosum62 Score, Percentage Identity, Zappo, Taylor, Hydrophobicity,
+               Helix Propensity, Strand Propensity, Turn Propensity, Buried Index,
+               Nucleotide, User Defined<br>
+               </strong> <em>See <a href="../colourSchemes/index.html">colours</a> for a
+               description of all colour schemes.</em><br>
+               </li>
+               <li><strong>By Conservation<br>
+               </strong><em>See <a href="../colourSchemes/conservation.html">Colouring
+               by Conservation</a>.</em><br>
+               </li>
+               <li><strong>Modify Conservation Threshold<br>
+               </strong><em>Use this to display the conservation threshold slider window.
+               Useful if the window has been closed, or if the 'by conservation'
+               option appears to be doing nothing!</em><br>
+               </li>
+               <li><strong>Above Identity Threshold<br>
+               </strong><em>See <a href="../colourSchemes/abovePID.html">Above
+               Percentage Identity</a></em><strong>.<br>
+               </strong></li>
+               <li><strong>Modify Identity Threshold<br>
+               </strong><em>Use this to set the threshold value for colouring above
+               Identity. Useful if the window has been closed.<br>
+               </em></li>
+               <li><strong>By Annotation</strong><br>
+               <em>Colours the alignment on a per-column value from a specified
+               annotation. See <a href="../colourSchemes/annotationColouring.html">Annotation
+               Colouring</a>.</em><br>
+               </li>
+       </ul>
+       </li>
+       <li><strong>Calculate</strong>
+       <ul>
+               <li><strong>Sort </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 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>
+                       <li><strong>by Pairwise Identity<br>
+                       </strong><em>This will sort the selected sequences by their percentage
+                       identity to the consensus sequence. The most similar sequence is put
+                       at the top. </em></li>
+                       <li><em>The <a href="../calculations/sorting.html">Sort
+                       menu</a> will have some additional options if you have just done a
+                       multiple alignment calculation, or opened a tree viewer window.</em><br>
+                       </li>
+               </ul>
+               </li>
+               <li><strong>Calculate Tree </strong> <br>
+               <em>Functions for calculating trees on the alignment or the
+               currently selected region. See <a href="../calculations/tree.html">calculating
+               trees</a>.</em>
+               <ul>
+                       <li><strong>Average Distance Using % Identity</strong></li>
+                       <li><strong>Neighbour Joining Using % Identity</strong></li>
+                       <li><strong>Average Distance Using Blosum62</strong></li>
+                       <li><strong>Neighbour Joining Using Blosum62<br>
+                       </strong></li>
+               </ul>
+               </li>
+               <li><strong>Pairwise Alignments</strong><br>
+               <em>Applies Smith and Waterman algorithm to selected sequences.
+               See <a href="../calculations/pairwise.html">pairwise alignments</a>.</em><br>
+               </li>
+               <li><strong>Principal Component Analysis</strong><br>
+               <em>Shows a spatial clustering of the sequences based on the
+               BLOSUM62 scores in the alignment. See <a
+                       href="../calculations/pca.html">Principal Component Analysis</a>.</em> <br>
+               </li>
+               <li><strong>Extract Scores ... (optional)</strong><br>
+               <em>This option is only visible if Jalview detects one or more white-space separated values in the description line of the alignment sequences.<br>
+               When selected, these numbers are parsed into sequence associated annotation which can 
+               then be used to sort the alignment via the Sort by&#8594;Score menu.</em> <br>
+               </li>
+               <li><strong>Autocalculate Consensus</strong><br>
+               <em>For large alignments it can be useful to deselect
+               &quot;Autocalculate Consensus&quot; when editing. This prevents the
+               sometimes lengthy calculations performed after each sequence edit.</em> <br>
+               </li>
+       </ul>
+       </li>
+       <li><strong>Web Service<br>
+       </strong> 
+         <ul><li><strong>Fetch DB References</strong><br>
+  <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>
+  </li>
+       </ul>
+       <em>Selecting one of the following menu items starts a remote
+       service on compute facilities at the University of Dundee. You need a
+       continuous network connection in order to use these services through
+       Jalview. </em>
+       <ul>
+               <li><strong>Alignment</strong>
+               <ul>
+                       <li><strong>ClustalW Multiple Sequence Alignment</strong><br>
+                       <em> Submits all, or just the currently selected sequences for
+                       alignment 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>
+                       <li><strong>MAFFT Multiple Sequence Alignment</strong><br>
+                       <em>Submits all, or just the currently selected region for
+                       alignment with MAFFT. </em></li>
+                       <li><strong>Muscle Multiple Protein Sequence Alignment</strong><br>
+                       <em> Submits all, or just the currently selected sequences for
+                       alignment using Muscle. Do not use this if you are working with
+                       nucleic acid sequences.</em></li>
+               </ul>
+               </li>
+               <li><strong>Secondary Structure Prediction</strong>
+               <ul>
+                       <li><strong>JPred Secondary Structure Prediction</strong><br>
+                       <em>Secondary structure prediction by network consensus. The
+                       behaviour of this calculation depends on the current selection: </em></li>
+                       <li><em>If nothing is selected, and the displayed sequences
+                       appear to be aligned, then a JNet prediction will be run for the
+                       first sequence in the alignment, using the current alignment.
+                       Otherwise the first sequence will be submitted for prediction. </em></li>
+                       <li><em>If just one sequence (or a region on one sequence)
+                       has been selected, it will be submitted to the automatic JNet
+                       prediction server for homolog detection and prediction. </em></li>
+                       <li><em>If a set of sequences are selected, and they appear
+                       to be aligned, then the alignment will be used for a Jnet prediction
+                       on the <strong>first</strong> sequence in the set (that is, the one
+                       that appears first in the alignment window). </em></li>
+               </ul>
+               </li>
+       </ul>
+       </li>
+</ul>
+</body>
+</html>
index e18e273..93b6336 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Annotation Panel Menus</title>
+</head>
+<body>
+<p><strong>Annotation Panel Menus</strong></p>
+<ul>
+  <li> <strong>Annotation Label Popup Menu</strong><br>
+    <em>This menu is opened by clicking anywhere on the annotation row labels 
+    area (below the sequence ID area).</em> 
+    <ul>
+      <li><strong> Add New Row</strong><br>
+        <em>Adds a new, named annotation row (a dialog box will pop up for you 
+        to enter the label for the new row). </em> </li>
+      <li><strong>Hide Row</strong><br>
+        <em>Hides the annotation row whose label was clicked in order to bring 
+        up the menu.</em> </li>
+      <li><strong>Delete Row</strong><br>
+        <em>Deletes the annotation row whose label was clicked in order to bring 
+        up the menu.</em> </li>
+      <li><strong>Show All Hidden Rows</strong><br>
+        <em>Shows all hidden annotation rows.</em> </li>
+      <li><strong>Export Annotation</strong> <em>(Application only)</em><br>
+       <em>Annotations can be saved to file or output to a text window in either the 
+        Jalview annotations format or as a spreadsheet style set of comma separated values (CSV). </em> </li>
+      <li><strong>Show Values in Text Box</strong> <em>(applet only)</em><br>
+        <em>Opens a text box with a list of comma-separated values corresponding 
+        to the annotation (numerical or otherwise) at each position in the row. 
+        This is useful to export alignment quality measurements for further analysis.</em> 
+      </li>
+   </ul>
+   <em>The following additional entries are avalable when the popup menu is opened on a consensus sequence annotation row:</em> 
+   <ul>
+      <li><strong>Ignore Gaps in Consensus</strong><br>
+        If this checkbox is selected, all consensus calculations performed in 
+        the current Alignment window will be done without counting gaps as a consensus 
+        character.</li>
+      <li><strong>Copy Consensus Sequence</strong><br>
+        Copies the consensus sequence to the clipboard in Fasta format, to allow 
+        the consensus sequence to be added to an alignment. Note the copied sequence 
+        is not accessible to other programs if Jalview is running as an applet 
+        in a web page.</li>
+    </ul>
+  </li>
+  <li><strong>Annotation Popup Menu<br>
+    </strong><em>This menu is opened when right-clicking on the selected positions 
+    of an annotation.</em> 
+    <ul>
+      <li><strong>Helix</strong><br>
+        <em>Mark selected positions with a helix glyph (a red oval), and optional 
+        text label (see below). Consecutive ovals will be rendered as an unbroken 
+        red line.</em> </li>
+      <li><strong>Sheet</strong><br>
+        <em>Mark selected positions with a sheet glyph (a green arrow oriented 
+        from left to right), and optional text label (see below). Consecutive 
+        arrows will be joined together to form a single green arrow.</em> </li>
+      <li><strong>Label</strong><br>
+        <em>Sets the text label at the selected positions. If more that one consecutive 
+        position is marked with the same label, only the first position's label 
+        will be rendered.</em> </li>
+      <li><strong>Colour</strong><br>
+        <em>Changes the colour of the annotation text label.</em> </li>
+      <li><strong>Remove Annotation</strong><br>
+        <em>Blanks any annotation at the selected positions on the row. Note: 
+        <strong>This cannot be undone</strong></em> </li>
+    </ul>
+  </li>
+</ul>
+</body>
+</html>
index e18e273..eae9c92 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Window Menus</title></head>
+
+<body>
+<p><strong>Alignment Window Calculate Menu</strong></p>
+<ul>
+  <li><strong>Sort </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 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>
+      <li><strong>by Pairwise Identity<br>
+        </strong><em>This will sort the selected sequences by their percentage 
+        identity to the consensus sequence. The most similar sequence is put at 
+        the top. </em></li>
+      <li><em>The <a href="../calculations/sorting.html">Sort menu</a> will have 
+        some additional options if the alignment has any associated
+       score annotation, or you have just done a multiple alignment calculation
+        or opened a tree viewer window.</em><br>
+      </li>
+    </ul>
+  </li>
+  <li><strong>Calculate Tree </strong> <br>
+    <em>Functions for calculating trees on the alignment or the currently selected 
+    region. See <a
+    href="../calculations/tree.html">calculating trees</a>.</em> 
+    <ul>
+      <li><strong>Average Distance Using % Identity</strong></li>
+      <li><strong>Neighbour Joining Using % Identity</strong></li>
+      <li><strong>Average Distance Using Blosum62</strong></li>
+      <li><strong>Neighbour Joining Using Blosum62<br>
+        </strong></li>
+    </ul>
+  </li>
+  <li><strong>Pairwise Alignments</strong><br>
+    <em>Applies Smith and Waterman algorithm to selected sequences. See <a href="../calculations/pairwise.html">pairwise 
+    alignments</a>.</em><br>
+  </li>
+  <li><strong>Principal Component Analysis</strong><br>
+    <em>Shows a spatial clustering of the sequences based on the BLOSUM62 scores 
+    in the alignment. See <a href="../calculations/pca.html">Principal Component 
+    Analysis</a>.</em> <br>
+  </li>
+       <li><strong>Extract Scores ... (optional)</strong><br>
+               <em>This option is only visible if Jalview detects one or more white-space separated values in the description line of the alignment sequences.<br>
+               When selected, these numbers are parsed into sequence associated annotation which can 
+               then be used to sort the alignment via the Sort by&#8594;Score menu.</em> <br>
+       </li>
+  
+  <li><strong>Autocalculate Consensus</strong><br>
+    <em>For large alignments it can be useful to deselect &quot;Autocalculate 
+    Consensus&quot; when editing. This prevents the sometimes lengthy calculations 
+    performed after each sequence edit.</em> <br>
+  </li>
+</ul>
+  </body>
+</html>
index e18e273..f00487f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Alignment Window Menus</title></head>
+
+<body>
+<p><strong>Alignment Window Colour Menu</strong></p>
+  <ul>
+    <li><strong>Apply Colour To All Groups<br>
+      </strong><em>If this is selected, any changes made to the background colour 
+      will be applied to all currently defined groups.<br>
+      </em></li>
+      <li><strong><a href="../colourSchemes/textcolour.html">Colour
+  Text ...</a></strong><em><br>
+      Opens the Colour Text dialog box to set a different text colour for light and dark background, and the intensity threshold for transition between them.
+      </em></li>
+    <li>Colour Scheme options: <strong>None, ClustalX, Blosum62 Score, Percentage 
+      Identity, Zappo, Taylor, Hydrophobicity, Helix Propensity, Strand Propensity, 
+      Turn Propensity, Buried Index, Nucleotide, User Defined<br>
+      </strong> <em>See <a href="../colourSchemes/index.html">colours</a> for 
+      a description of all colour schemes.</em><br>
+    </li>
+    <li><strong>By Conservation<br>
+      </strong><em>See <a href="../colourSchemes/conservation.html">Colouring 
+      by Conservation</a>.</em><br>
+    </li>
+    <li><strong>Modify Conservation Threshold<br>
+      </strong><em>Use this to display the conservation threshold slider window. 
+      Useful if the window has been closed, or if the 'by conservation' option 
+      appears to be doing nothing!</em><br>
+    </li>
+    <li><strong>Above Identity Threshold<br>
+      </strong><em>See <a href="../colourSchemes/abovePID.html">Above Percentage 
+      Identity</a></em><strong>.<br>
+      </strong></li>
+    <li><strong>Modify Identity Threshold<br>
+      </strong><em>Use this to set the threshold value for colouring above Identity. 
+      Useful if the window has been closed.<br>
+      </em></li>
+    <li><strong>By Annotation</strong><br>
+      <em>Colours the alignment on a per-column value from a specified annotation. 
+      See <a href="../colourSchemes/annotationColouring.html">Annotation Colouring</a>.</em><br>
+    </li>
+  </ul>
+</body>
+</html>
index e18e273..ae97618 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Alignment Window Menus</title>
+</head>
+
+<body>
+<p><strong>Alignment Window Edit Menu</strong></p>
+<ul>
+       <li><strong>Undo (Control Z)</strong><em><br>
+       This will undo any edits you make to the alignment. This applies to
+       insertion or deletion of gaps, cutting residues or sequences from the
+       alignment or pasting sequences to the current alignment or sorting the
+       alignment. <strong>NOTE:</strong> It DOES NOT undo colour changes,
+       adjustments to group sizes, or changes to the annotation panel. </em></li>
+       <li><strong>Redo (Control Y)<br>
+       </strong><em>Any actions which you undo can be redone using redo. </em></li>
+       <li><strong>Cut (Control X)<br>
+       </strong><em>This will make a copy of the currently selected residues
+       before removing them from your alignment. Click on a sequence name if
+       you wish to select a whole sequence. <br>
+       Use &lt;CTRL&gt; and X (&lt;APPLE&gt; and X on MacOSX) to cut.</em></li>
+       <li><strong>Copy (Control C)</strong><br>
+       <em>Copies the currently selected residues to the system clipboard
+       - you can also do this by pressing &lt;CTRL&gt; and C (&lt;APPLE&gt;
+       and C on MacOSX). <br>
+       If you try to paste the clipboard contents to a text editor, you will
+       see the format of the copied residues FASTA.</em></li>
+       <li><strong>Paste </strong>
+       <ul>
+               <li><strong>To New Alignment (Control Shift V)<br>
+               </strong><em>A new alignment window will be created from sequences
+               previously copied or cut to the system clipboard. <br>
+               Use &lt;CTRL&gt; and &lt;SHIFT&gt; and V(&lt;APPLE&gt; and
+               &lt;SHIFT;&gt; and and V on MacOSX) to paste.</em></li>
+               <li><strong>Add To This Alignment (Control V)<br>
+               </strong><em>Copied sequences from another alignment window can be added
+               to the current Jalview alignment. </em></li>
+       </ul>
+       </li>
+       <li><strong>Delete (Backspace)<br>
+       </strong><em>This will delete the currently selected residues without
+       copying them to the clipboard. Like the other edit operations, this can
+       be undone with <strong>Undo</strong>.</em></li>
+       <li><strong>Remove Left (Control L)<br>
+       </strong><em>If the alignment has marked columns, the alignment will be
+       trimmed to the left of the leftmost marked column. To mark a column,
+       mouse click the scale bar above the alignment. Click again to unmark a
+       column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
+       <li><strong>Remove Right (Control R)<br>
+       </strong><em>If the alignment has marked columns, the alignment will be
+       trimmed to the left of the leftmost marked column. To mark a column,
+       mouse click the scale bar above the alignment. Click again to unmark a
+       column, or select &quot;Deselect All&quot; to deselect all columns.</em></li>
+       <li><strong>Remove Empty Columns (Control E)<br>
+       </strong><em>All columns which only contain gap characters (&quot;-&quot;,
+       &quot;.&quot;) will be deleted.<br>
+       You may set the default gap character in <a
+               href="../features/preferences.html">preferences</a>. </em></li>
+       <li><strong>Remove All Gaps (Control Shift E)</strong><br>
+       <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be deleted
+       from the selected area of the alignment. If no selection is made, ALL
+       the gaps in the alignment will be removed.<br>
+       You may set the default gap character in <a
+               href="../features/preferences.html">preferences</a>. </em></li>
+       <li><strong>Remove Redundancy (Control D)<br>
+       </strong><em>Selecting this option brings up a window asking you to select
+       a threshold. If the percentage identity between any two sequences
+       (under the current alignment) exceeds this value then one of the
+       sequences (the shorter) is discarded. Press the &quot;Apply&quot;
+       button to remove redundant sequences. The &quot;Undo&quot; button will
+       undo the last redundancy deletion.</em></li>
+       <li><strong>Pad Gaps<br>
+       </strong><em>When selected, the alignment will be kept at minimal width (so
+       there no empty columns before or after the first or last aligned
+       residue) and all sequences will be padded with gap characters to the
+       before and after their terminating residues.<br>
+       This switch is useful when making a tree using unaligned sequences and
+       when working with alignment analysis programs which require 'properly
+       aligned sequences' to be all the same length.<br>
+       You may set the default for <strong>Pad Gaps</strong> in the <a
+               href="../features/preferences.html">preferences</a>. </em></li>
+</ul>
+</body>
+</html>
index e18e273..93c7711 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Alignment Window Menus</title>
+</head>
+
+<body>
+<p><strong>Alignment Window File Menu</strong></p>
+<ul>
+       <li><strong>Fetch Sequence</strong><br>
+       <em>Shows a dialog window in which you can select known ids from
+       Uniprot, EMBL, EMBLCDS or PDB database using Web Services provided by
+       the European Bioinformatics Institute. See <a
+               href="../features/seqfetch.html">Sequence Fetcher</a></em>.</li>
+       <li><strong>Add Sequences</strong><em><br>
+       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>
+       <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>
+       <li><strong>Save As (Control Shift S)<br>
+       </strong><em>Save the alignment to local file. A file selection window will
+       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,
+       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>
+               <li><strong>FASTA</strong> <em></em></li>
+               <li><strong>MSF</strong></li>
+               <li><strong>CLUSTAL</strong></li>
+               <li><strong>BLC</strong></li>
+               <li><strong>PIR</strong></li>
+               <li><strong>PFAM</strong></li>
+       </ul>
+       </li>
+       <li><strong>Page Setup ...</strong><br>
+       <em>Open the printing system's Page Setup dialog box, to
+       control page size, layout and orientation.</em></li>
+       <li><strong>Print (Control P)<br>
+       </strong><em>Jalview will print the alignment using the current fonts and
+       colours of your alignment. If the alignment has annotations visible,
+       these will be printed below the alignment. If the alignment is wrapped
+       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
+               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>
+       <ul>
+               <li><strong>HTML<br>
+               </strong><em>Create a <a href="../io/export.html">web page</a> from your
+               alignment.</em></li>
+               <li><strong>EPS<br>
+               </strong><em>Create an <a href="../io/export.html">Encapsulated
+               Postscript</a> file from your alignment.</em></li>
+               <li><strong>PNG<br>
+               </strong><em>Create a <a href="../io/export.html">Portable Network
+               Graphics</a> file from your alignment.</em></li>
+       </ul>
+       </li>
+       <li><strong>Export Features</strong><em><br>
+       All features visible on the alignment can be saved to file or displayed
+       in a textbox in either Jalview or GFF format</em></li>
+       <li><strong>Export Annotations</strong><em><br>
+       All annotations visible on the alignment can be saved to file or
+       displayed in a textbox in Jalview annotations format. </em></li>
+       <li><strong>Load Associated Tree<br>
+       </strong><em>Jalview can <a href="../calculations/treeviewer.html">view
+       trees</a> stored in the Newick file format, and associate them with the
+       alignment. Note: the ids of the tree file and your alignment MUST be
+       the same.</em></li>
+       <li><strong>Load Features / Annotations<br>
+       </strong><em>Load files describing precalculated <a
+               href="../features/featuresFormat.html">sequence features</a> or <a
+               href="../features/annotationsFormat.html">alignment annotations</a>.</em></li>
+       <li><strong>Close (Control W)</strong><br>
+       <em>Close the alignment window. Make sure you have saved your
+       alignment before you close - either as a Jalview project or by using
+       the <strong>Save As</strong> menu.</em></li>
+</ul>
+</body>
+</html>
index e18e273..7c015db 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<p><strong>Alignment Window Format Menu</strong></p>
+<ul>
+  <li><strong>Font...</strong><br>
+    <em>Opens the &quot;Choose Font&quot; dialog box, in order to change the font 
+    of the display and enable or disable 'smooth fonts' (anti-aliasing) for faster 
+    alignment rendering. </em></em></li>
+  <li><strong>Wrap<br>
+    </strong><em>When ticked, the alignment display is &quot;<a
+               href="../features/wrap.html">wrapped</a>&quot; to the width of the alignment 
+    window. This is useful if your alignment has only a few sequences to view 
+    its full width at once.<br>
+    Additional options for display of sequence numbering and scales are also visible 
+    in wrapped layout mode:</em>
+    <ul>
+      <li><strong>Scale Left</strong><br>
+        <em>Show the sequence position for the first aligned residue in each row 
+        in the left column of the alignment.</em></li>
+      <li><strong>Scale Right</strong><br>
+        <em>Show the sequence position for the last aligned residue in each row 
+        in the right-most column of the alignment.</em></li>
+      <li><strong>Scale Above</strong><br>
+        <em>Show the alignment column position scale.</em></li>
+    </ul>
+  <li><strong>Show Sequence Limits<br>
+    </strong><em>If this box is selected the sequence name will have the start 
+    and end position of the sequence appended to the name, in the format NAME/START-END</em></li>
+  <li><strong>Right Align Sequence ID<br>
+    </strong> <em>If this box is selected then the sequence names displayed in 
+    the sequence label area will be aligned against the left-hand edge of the 
+    alignment display, rather than the left-hand edge of the alignment window.</em></li>
+  <li><strong>Show Hidden Markers<br>
+    </strong><em>When this box is selected, positions in the alignment where rows 
+    and columns are hidden will be marked by blue arrows.</em></li>
+  <li><strong>Boxes</strong><em><br>
+    If this is selected the background of a residue will be coloured using the 
+    selected background colour. Useful if used in conjunction with &quot;Colour 
+    Text.&quot; </em></li>
+  <li><strong>Text<br>
+    </strong><em>If this is selected the residues will be displayed using the 
+    standard 1 character amino acid alphabet.</em></li>
+  <li><strong>Colour Text<br>
+    </strong><em>If this is selected the residues will be coloured according to 
+    the background colour associated with that residue. The colour is slightly 
+    darker than background so the amino acid symbol remains visible. </em></li>
+  <li><strong>Show Gaps<br>
+    </strong><em>When this is selected, gap characters will be displayed as &quot;.&quot; 
+    or &quot;-&quot;. If unselected, then gap characters will appear as blank 
+    spaces. <br>
+    You may set the default gap character in <a
+               href="../features/preferences.html">preferences</a>.</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 e18e273..c0074bc 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><body>
+<p><strong>Alignment Window Select Menu</strong></p>
+<ul>
+       
+  <li><a href="../features/search.html"><strong>Find... (Control F)</strong></a><br>
+    <em>Opens the Find dialog box to search for residues, sequence name or residue 
+    position within the alignment and create new sequence features from the queries. 
+    </em>
+  <li><strong>Select All (Control A)</strong><strong><br>
+    </strong><em>Selects all the sequences and residues in the alignment. <br>
+    Use &lt;CTRL&gt; and A (&lt;APPLE&gt; and A on a MacOSX) to select all.</em></em></li>
+       <li><strong>Deselect All (Escape)<br>
+       </strong><em>Removes the current selection box (red dashed box) from the
+       alignment window. All selected sequences, residues and marked columns
+       will be deselected. </em><em> <br>
+       Use &lt;ESCAPE&gt; to deselect all.</em></li>
+       <li><strong>Invert Sequence Selection (Control I)<br>
+       </strong><em>Any sequence ids currently not selected will replace the
+       current selection. </em></li>
+       <li><strong>Invert Column Selection (Control Alt I)<br>
+       </strong><em>Any columns currently not selected will replace the current
+       column selection. </em></li>
+       <li><strong>Undefine Groups (Control U)<br>
+       </strong><em>The alignment will be reset with no defined groups.<br>
+       <strong>WARNING</strong>: This cannot be undone.</em></li>
+       <li><strong>Make Groups<br/></strong>
+       <em>The currently selected groups of the alignment will be subdivided according to the contents of the currently selected region. <br/>Use this to subdivide an alignment based on the different combinations of residues observed at specific positions. (new in jalview 2.5)</em></li>
+</ul>
+</body>
+</html>
index e18e273..e068a45 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Alignment Window Menus</title>
+</head>
+
+<body>
+<p><strong>Alignment Window View Menu</strong></p>
+<ul>
+  <li><strong>New View (Control T)</strong><em><br>
+    Creates a new view from the current alignment view. </em></li>
+  <li><strong>Expand Views (X)</strong><em><br>
+    Display each view associated with the alignment in its own alignment window, 
+    allowing several views to be displayed simultaneously. </em></li>
+  <li><strong>Gather Views (G)</strong><em><br>
+    Each view associated with the alignment will be displayed within its own tab 
+    on the current alignment window. </em></li>
+  <li><strong>Show&#8594;(all Columns / Sequences / Sequences and Columns</strong> )</strong><em><br>
+    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 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>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>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>
+    <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>
+    Opens the Sequence Feature Settings dialog box to control the colour and display 
+    of sequence features on the alignment, and configure and retrieve features 
+    from DAS annotation servers.</em></li>
+    <li><strong>Sequence ID Tooltip</strong><em> (application only)
+    <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 small 
+    window. A red box will indicate the currently visible area of the alignment. 
+    Move the visible region using the mouse. </em></li>
+</ul>
+<p>&nbsp;</p>
+</body>
+</html>
index e18e273..184733d 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Desktop Menus</title>
+</head>
+
+<body>
+<p><strong>Desktop Menus</strong></p>
+<ul>
+       <li><em> <strong>File</strong></em>
+       <ul>
+               <li><strong>Input Alignment from</strong><em> (See more on <a
+                       href="../io/index.html">file formats</a>) </em>
+               <ul>
+                       <li><strong>File (Control O)</strong><br>
+                       <em>open file(s) on your local file system</em></li>
+                       <li><strong>URL</strong><br>
+                       <em>open a file from a website. The URL MUST start with http://</em></li>
+                       <li><strong>Textbox</strong><br>
+                       <em>copy and paste an alignment into a text window</em></li>
+               </ul>
+               </li>
+               <li><strong>Fetch Sequence<br>
+               </strong><em>Shows a dialog window in which you can select known ids from
+               Uniprot, EMBL, EMBLCDS or PDB database using Web Services provided by
+               the European Bioinformatics Institute.</em></li>
+               <li><strong>Save Project</strong><br>
+               <em>Saves all currently open alignment windows with their current
+               view settings and any associated trees, as a <a
+                       href="../features/jalarchive.html">Jalview Archive</a> (which has a
+               .jar extension).</em></li>
+               <li><strong>Load Project</strong><br>
+               <em>Loads Jalview archives <strong>only</strong>.</em></li>
+               <li><strong>Quit</strong><br>
+        <em>Close Jalview. <br>
+        <strong>Note - any annotation you have made on alignments will be lost 
+        unless you Save your work before quitting.</strong></em><br>
+      </li>
+       </ul>
+       </li>
+       <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
+               windows.</em></li>
+               <li><strong>Show Memory Usage<br></strong>
+               <em>When ticked, the currently available memory will be displayed in the 
+               bottom right of the desktop background area.<br>
+               See the <a href="../memory.html">help on jalview memory settings</a> for more information.</em></li>
+               <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>
+               </strong><em>Displays the version and creation date of the application, as
+               well as acknowledgements and a citation reference. </em></li>
+               <li><strong>Documentation<br>
+               </strong><em>Displays help files as a browseable, searchable set of pages
+               with a table of contents. </em><strong><br>
+               </strong></li>
+       </ul>
+       </li>
+       <li><strong>Window</strong><br>
+       <em>Each time a new window is added to the Jalview Desktop a
+       corresponding menu item will be added to the &quot;Window&quot; menu
+       that will bring the window to the top of the pile when it is selected.
+       <ul>
+               <li><strong>Close All</strong><br>
+               Close all alignment and analysis windows.<br><strong>Note: This will erase all alignments from memory, and cannot be undone!</strong></li>
+               <li><strong>Raise Associated Windows</strong><br>
+               Bring all windows associated with the current alignment to the top of the pile. 
+               </li>
+               <li><strong>Minimise Associated Windows</strong><br>
+               Hide all windows related to the current alignment behind icons on the Jalview Desktop.
+               </ul>
+               </em></li>
+       </ul>
+</body>
+</html>
index e18e273..e6e641c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Jalview's Menus</title>
+</head>
+
+<body>
+<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 e18e273..8f03c9a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Popup Menu</title>
+</head>
+
+<body>
+<p><strong>Popup Menu</strong><br>
+<em>This menu is visible when right clicking either within a
+selected region on the alignment or on a selected sequence name. It may
+not be accessible when in 'Cursor Mode' (toggled with the F2 key).</em></p>
+<ul>
+  <li><strong>Selection</strong> 
+    <ul>
+      <li><strong>Edit </strong> 
+        <ul>
+          <li><strong>Copy</strong><br>
+            <em>Copys the selected region. In the applet version, the copied sequences 
+            are not available to the system clipboard.</em></li>
+          <li><strong>Cut<br>
+            </strong><em>Cuts the selected region from the alignment. In the applet 
+            version, the copied sequences are not available to the system clipboard.</em></li>
+          <li><strong>Edit Sequence</strong><br>
+            <em>Edit the selected sequence(s) directly. Spaces will be converted 
+            to the current gap character.</em></li>
+          <li><strong>To Upper Case</strong><em><strong><br>
+            </strong><em>Changes the case of selected region to lower case.</em> 
+            </em></li>
+          <li><strong>To Lower Case<br>
+            </strong><em>Changes the case of selected region to upper case.</em><strong> 
+            </strong></li>
+          <li><strong>Toggle Case</strong><br>
+            <em>Switches the case of all residues within the selected region.</em></li>
+        </ul>
+      </li>
+      <li><strong>Output to Textbox<br>
+        </strong><em>The selection area will be output to a a text window in the 
+        selected alignment format. </em></li>
+      <li><strong><a href="../features/creatinFeatures.html">Create Sequence Feature...</a></strong><br>
+        <em>Opens the dialog box for creating sequence features over the currently 
+        selected region on each selected sequence.</em></li>
+      <li><strong>Group</strong><br>
+        <em>Group Operations</em> 
+        <ul>
+          <li><strong>Group</strong><em>This is the first entry in the
+         menu, and will display the currently selected group's
+         name. Selecting it displays a window allowing the name and
+         description for this group to be edited. Click OK to set the
+         new name and decription, and cancel to leave the existing
+         name and description unchanged.</em></li>
+          <li><strong>Remove Group<br>
+            </strong><em>This will undefine the selected group. </em><strong> 
+            </strong></li>
+          <li><strong>Group Colour<br>
+            </strong><em>Sets the <a href="../colourSchemes/index.html">colour</a> 
+            of the group.</em><strong> </strong></li>
+          <li><strong>Boxes<br>
+            </strong><em>If selected the background of a residue within the selected 
+            group will be coloured according to the assigned colour scheme.</em><strong> 
+            </strong></li>
+          <li><strong>Text<br>
+            </strong><em>If selected the selected group will display text. </em></li>
+          <li><strong>Colour Text<br>
+            </strong><em>If selected the selected group will display text in a 
+            colour slightly darker than the background colour of that residue.</em></li>
+          <li><strong>Border Colour <br>
+            </strong><em>Selecting this will display a &quot;Colour Chooser&quot; 
+            window. Select a colour than press OK to set the border colour of 
+            a group.</em></li>
+       <li><strong>Show Unconserved<br>
+         </strong><em>When this is selected, all symbols in the group matching the consensus sequence at that column will be rendered as a '.', highlighting mutations in the group area.
+       </em></li>
+                   </ul>
+      </li>
+      <li><strong>Group Links<br>
+    </strong><em>This menu is only visible if there are group links available for the current selection.
+    </em> 
+    <ul>
+    <li><em>ID links</em> allow you to send IDs associated with the current selection to a web server.</li>
+    <li><em>Sequence links</em> allow you to send the sequences in the currently selected region to a web server.</li>
+    <li><em>Sequence and ID links</em> allow you to send sets of IDs and sequences associated with the current selection to a web server.</li>
+    </ul>
+    <em>Group Links were added in Jalview 2.5</em></li>
+    </ul>
+  </li>
+  <li><strong>Sequence Id<br>
+    </strong><em>This menu is only visible if you right-click on a sequence name. 
+    </em> 
+    <ul>
+      <li><strong>Edit Name/Description<br>
+        </strong><em>You may edit the name and description of each sequence. A 
+        window will be displayed asking for a new sequence name and sequence description 
+        to be entered. Press OK to accept your edit. To save sequence descriptions, 
+        you must save in Fasta, PIR or Jalview File format.</em></li>
+      <li><em> </em></li>
+      <li><strong>Represent Group With (Sequence Id)</strong><br>
+        <em>All sequences in the current selection group will be hidden, apart 
+        from (Sequence Id). Any edits performed on the visible representative 
+        sequence will be propagated to the hidden sequences. </em></li>
+      <li><a name="sqid.popup"><strong>Link</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.<br>
+        Since Jalview 2.4, links will also be made for database cross 
+        references (where the database name exactly matches the link name set up in <a href="../features/preferences.html">Preferences</a>).
+        <br>Since Jalview 2.5, links are also shown for non-positional sequence features attached to 
+        the sequence, and any regular-expression based URL links that 
+        matched the description line.
+        </em><strong><br>
+        </strong></li>
+    </ul>
+  </li>
+  <li><strong>Structure</strong> 
+    </strong><em>This menu is only visible if you right-click on a sequence name. 
+    </em> 
+    <ul>
+      <li><strong>Associate Structure with Sequence</strong> 
+        <ul>
+          <li><strong>From File<br>
+            </strong><em>Load a PDB file from local disk which will be associated 
+            with this sequence. This file will be used if the user subsequently 
+            clicks on &quot;View PDB Structure&quot; menu item.</em></li>
+          <li><strong>Enter PDB id<br>
+            </strong><em>Enter the PDB id from an input window. This PDB id will 
+            be used by the service WSDBFetch, provided by the EBI, to fetch the 
+            PDB file if the user subsequently clicks on &quot;View PDB Structure&quot; 
+            menu item. </em></li>
+          <li><strong>Discover PDB ids<br>
+            </strong><em>This will use the service WSDBFetch, provided by the 
+            EBI, to retrieve all PDB ids associated with the sequences in the 
+            alignment if the sequences have valid Uniprot names or accession ids. 
+            </em></li>
+        </ul>
+      </li>
+      <li><strong>View Structure<br>
+        </strong><em> If the sequence has an associated PDB file added by one 
+        of the methods described above, Jalview will display a 3D interactive 
+        viewer of the file.<br>
+        These entries will only be present if the sequence has <a
+                       href="../features/viewingpdbs.html">associated PDB structures</a>.</em><br>
+      </li>
+    </ul>
+  </li>
+  <li><strong>Hide Sequences</strong><br>
+    <em>Hides the currently selected sequences in this alignment view.</em><strong><br>
+    <br>
+    </strong></li>
+</ul>
+</body>
+</html>
index e18e273..86acf93 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Web Service Menu</title></head>
+
+<body>
+<p><strong>Web Service Menu</strong></p>
+<ul>
+  <li><strong>Fetch DB References</strong><br>
+  <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.
+   <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 
+  on compute facilities at the University of Dundee. You need a continuous network 
+  connection in order to use these services through Jalview. </em> </p>
+  <ul>
+  <li><strong>Alignment</strong> 
+    <ul>
+      <li><strong>ClustalW Multiple Sequence Alignment</strong><br>
+        <em> Submits all, or just the currently selected sequences for alignment 
+        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. 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>
+      <li><strong>Muscle Multiple Protein Sequence Alignment</strong><br>
+        <em> Submits all, or just the currently selected sequences for alignment 
+        using Muscle. Do not use this if you are working with nucleic acid sequences.</em></li>
+    </ul>
+  </li>
+  <li><strong>Secondary Structure Prediction</strong> 
+    <ul>
+      <li><strong>JPred Secondary Structure Prediction</strong><br>
+        <em>Secondary structure prediction by network consensus. The behaviour 
+        of this calculation depends on the current selection: </em></li>
+      <li><em>If nothing is selected, and the displayed sequences appear to be 
+        aligned, then a JNet prediction will be run for the first sequence in 
+        the alignment, using the current alignment. Otherwise the first sequence 
+        will be submitted for prediction. </em></li>
+      <li><em>If just one sequence (or a region on one sequence) has been selected, 
+        it will be submitted to the automatic JNet prediction server for homolog 
+        detection and prediction. </em></li>
+      <li><em>If a set of sequences are selected, and they appear to be aligned, 
+        then the alignment will be used for a Jnet prediction on the <strong>first</strong> 
+        sequence in the set (that is, the one that appears first in the alignment 
+        window). </em> </li>
+    </ul>
+  </li>
+</ul>
+<p><strong> </strong></p>
+</body>
+</html>
index e18e273..0d99405 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Amino Acid Properties</title>
+</head>
+<body><div align="center">
+<h1>Amino Acid Properties</h1>
+  <img src="properties.gif">
+  <br>
+  <table width="295" border="1" cellspacing="0" cellpadding="0">
+    <tr>
+      <td width="291"><pre><font size="4" face="Courier New, Courier, mono"><strong>ILVCAGMFYWHKREQDNSTPBZX-</strong>
+XXXXXXXXXXX&middot;·&middot;&middot;&middot;&middot;&middot;X&middot;&middot;&middot;XX Hydrophobic
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XXXXXXXXXX&middot;XXXXX Polar
+&middot;&middot;XXXX&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XXXXX&middot;&middot;XX Small
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;X&middot;&middot;XX Proline
+&middot;&middot;&middot;&middot;XX&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;X&middot;&middot;&middot;&middot;XX Tiny
+XXX&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XX Aliphatic
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;XXXX&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XX Aromatic
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XXX&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XX Positive
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;X&middot;X&middot;&middot;&middot;&middot;&middot;&middot;XX Negative
+&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;&middot;XXXX&middot;X&middot;&middot;&middot;&middot;&middot;&middot;XX Charged</font></pre></td>
+    </tr>
+  </table>
+  </div>
+<p><br>
+   From Livingstone, C. D. and Barton, G. J. (1993), <br>
+  "Protein Sequence Alignments: A Strategy for the Hierarchical Analysis of Residue
+  Conservation", Comp. Appl. Bio. Sci., 9, 745-756. </p>
+  <br>
+</div>
+</body>
+</html>
index e097390..9acb9da 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Amino Acids</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+       background-color: FFFFEE;
+}
+-->
 </style>
 </head>
 
index 1df8400..9bde5d7 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Genetic Code</title>
+<style type="text/css">
+<!--
+td {
+       text-align: center;
+}
+-->
 </style>
 </head>
 
index e18e273..b2f5a67 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Jalview Privacy Statement</title>
+</head>
+<body>
+<p><strong>Privacy for Jalview Users</strong><br>
+<p>The Jalview Desktop application which is available from the
+www.jalview.org site does not contain code designed collect personal or
+private information without your consent. However, we do collect usage
+statistics to work out who is using Jalview, so we can apply for funding
+to support Jalview development, and make it better for our users.</p>
+<p>Usage data is collected from the logs of various web services that the Jalview Desktop contacts through its normal operation.
+These are described below:</p>
+<ul>
+       <li><em>HTTP logs on the Jalview website</em><br>
+       We record IP addresses of machines which access the web site, either
+       via the browser when downloading the application, or when the Jalview
+       Desktop user interface is launched.<br><br>
+       <ul>
+               <li><i>The JNLP file at www.jalview.org/webstart/jalview.jnlp
+               is retrieved to determine if you are running the latest version of
+               Jalview.</i></li>
+               <li><i>The questionnaire web service at
+               www.jalview.org/cgi-bin/questionnaire.pl is checked and a unique
+               cookie for the current questionnaire is stored in the Jalview
+               properties file.</i></li>
+               <li><i>The Jalview web services stack is contacted to
+               retrieve the currently available web services. All interactions with
+               the public jalview web services are logged, but we delete all job data
+               (input data and results) after about two weeks.</i></li>
+       </ul><br>
+       </li>
+       <li><em>Google Analytics</em><br>
+       Since jalview 2.4.0b2, the Jalview Desktop records usage data with
+       Google Analytics via the <a
+               href="http://code.google.com/p/jgoogleanalytics/">JGoogleAnalytics</a>
+       class.<br>
+       The Google Analytics logs for Jalview version 2.4 only record the fact
+       that the application was started, but in the future, we will use this
+       mechanism to improve the Desktop user interface, by tracking which
+       parts of the user interface are being used most often.</li>
+</ul>
+</p>
+<p><strong>Stopping Jalview from calling home</strong><br>
+If you run Jalview in 'headless mode' via the command line, then the
+program shouldn't try to contact any of the web servers mentioned above
+(if it does, then it's a bug!). You can also specify some <a
+       href="features/commandline.html">command line options</a> to disable
+the questionnaire and usage statistics check. Finally, the <a
+       href="features/preferences.html#connections">Connections Tab</a> of the
+jalview preferences contains options for controlling the submission of
+usage statistics.
+<p><strong>Other Web Clients in Jalview</strong><br>
+The Jalview desktop is intended to make it easier to interact with
+web-based bioinformatics resources. However, we can't take any
+responsibility for the integrity of any external services you might
+access via the program. Sorry!</p>
+</body>
+</html>
index e18e273..ef7ec3a 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>VAMSAS Interoperation</title>
+</head>
+<body>
+<p><strong>VAMSAS Interoperation</strong></p>
+<p>Jalview can interact with other applications using &quot;the <strong>VAMSAS
+Interoperation framework</strong>&quot; which is an experimental model for
+interoperation between bioinformatics applications (<strong>V</strong>isualization
+and <strong>A</strong>nalysis of <strong>Molecular</strong> <strong>S</strong>equences,
+<strong>Alignements</strong> 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.
+<p>VAMSAS enabled applications access a shared bioinformatics
+dataset containing sequences, alignments, annotation and trees, which
+can be represented by an XML document analogous to a <a
+       href="../features/jalarchive.html">Jalview Project Archive</a>.</p>
+<br>
+<strong>Connecting to a VAMSAS session</strong><br>
+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>. When the application is not connected to a session is active,
+the menu options are as follows:<br>
+<ul>
+       <li><em>Connect to an existing session</em><br>
+       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>
+       <li><em>New VAMSAS Session</em><br>
+       This option will create a new session on your computer.</li>
+       <li><em>Load VAMSAS Session...</em><br>
+       This option will open a file browser window allowing you to select a
+       VAMSAS session archive from which a new session will be created.<br/>
+       <em>New in 2.5:</em>Sessions created from an imported document inherit
+       the file or URL for the document.</li>
+
+</ul>
+<br>
+<strong>VAMSAS and Firewalls</strong>: VAMSAS uses sockets to
+communicate between different programs. This means that after starting a
+session, your firewall software may ask you whether to allow the java
+executable access to the internet (port 53782). If you do not allow
+this, messages will not be exchanged with other VAMSAS applications.</br>
+<br>
+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, 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. <br>
+<strong>Saving the current session</strong><br>
+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. <strong>Leaving a VAMSAS session</strong><br>
+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. <br>
+<strong>VAMSAS Session Persistence</strong><br>
+VAMSAS sessions are persistent - this means that they exist
+independently of any VAMSAS applications that are connected to them.
+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>
+<strong>A quick Demo</strong>
+<br>
+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.
+<br>
+<table>
+       <tr>
+               <td>Data Sharing Capability</td>
+               <td>Jalview Version</td>
+       </tr>
+       <tr>
+               <td>Alignments, sequences and annotation, trees, database
+               references, cDNA/protein mappings.</td>
+               <td>2.4</td>
+       </tr>
+       <tr>
+               <td>Mouseover location across linked DNA, protein and structure
+               positions.</td>
+               <td>2.4</td>
+       </tr>
+       <tr>
+               <td>Jalview project settings (Multiple views, groups, tree
+               partitions, colouring, window positions)</td>
+               <td>2.5</td>
+       </tr>
+       <tr>
+               <td>Sequence region and column selections</td>
+               <td>2.5</td>
+       </tr>
+</table>
+<br />
+<p>Version 0.2 of the VAMSAS client library is used in <em>Jalview
+2.5</em>. 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 released under the
+LGPL license. &nbsp;</p>
+</body>
+</html>
index e18e273..cbfc115 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>ClustalW Alignment</title></head>
+<body>
+<p><strong>ClustalW Alignments</strong></p>
+<p>ClustalW is a program for multiple sequence alignment. It works
+with both DNA and protein sequences, and can also perform profile
+profile alignments to align two or more multiple sequence
+alignments.</p>
+<p>
+Thompson, J.D., Higgins, D.G. and Gibson, T.J. (1994) <br>
+CLUSTAL W: improving the sensitivity of progressive multiple
+sequence alignment through sequence weighting, position specific gap
+penalties and weight matrix choice.<br>
+<em>Nucleic Acids Research</em> <strong>22</strong> 4673-4680
+</p>
+<p>There are two versions of this alignment function, which will operate
+on the selected region, if any, or the whole sequence set:</p>
+<ul>
+  <li><strong>Web Service&#8594;Alignment&#8594;ClustalW Multiple Sequence Alignment</strong><br>
+    Aligns using the clustalW program, ignoring any gaps in the submitted sequence 
+    set. </li>
+  <li><strong>Web Service&#8594;Alignment&#8594;ClustalW Mulitple Sequence Alignment 
+    Realign </strong><br>
+    Submits the sequences with existing gaps to clustalW, which will preserve 
+    existing gaps and re-align those regions which are not optimal. </li>
+</ul>
+</body>
+</html>
index 422b99a..ef6fcac 100644 (file)
  * PURPOSE.  See the GNU General Public License for more details.\r
  * \r
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
--->\r
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">\r
+<head>\r
+Database Reference Fetching\r
+</head>\r
+<p>\r
+<p><strong>Discovering Database References for Sequences</strong><br>\r
+Database references are associated with a sequence are displayed as a\r
+list in the tooltip shown when mousing over its sequence ID. Jalview\r
+uses references for the retrieval of <a\r
+       href="../features/viewingpdbs.html">PDB structures</a> and <a\r
+       href="../features/dasfeatures.html">DAS features</a>, and for\r
+retrieving sequence cross-references such as the protein products of a\r
+DNA sequence.</p>\r
+<p><strong>Initiating reference retrieval</strong><br>\r
+The application provides three ways to access the retrieval function. Either:\r
+<ul><li>select the <strong>Discover PDB IDs</strong> option from the structure submenu of the sequence's popup menu</li>\r
+<li>Choose one of the options from the 'Fetch DB Refs' submenu in the alignment window's <strong>Web Services</strong> menu:<ul>\r
+<li><em>Standard Databases</em> will fetch references from the EBI databases plus currently selected DAS sources</li>\r
+<li>The other entries submenus leading to lists of individual database sources that Jalview can access.</li></ul></li>\r
+<li>Answer 'Yes' when asked if you wish to retrieve database references for your sequences after initiating a DAS Sequence Feature fetch.</li>\r
+</ul> \r
+<p>Jalview discovers references for a sequence by generating a set\r
+of ID queries from the ID string of each sequence in the alignment. It\r
+then tries to query a subset of all the databases it can access in order to match\r
+the alignment sequence to any records retrieved from the database. If a\r
+match is found, then the sequence is annotated with that database's\r
+reference, and any cross-references that it's records contain.</p>\r
+<p><strong>The Sequence Identification Process</strong><br>\r
+The method of accession id discovery is derived from the method which\r
+earlier Jalview versions used for Uniprot sequence feature retrieval,\r
+and was originally restricted to the identifaction of valid Uniprot\r
+accessions.<br>\r
+Essentially, Jalview will try to retrieve records from a subset of the databases\r
+accessible by the <a href="../features/seqfetch.html">sequence\r
+fetcher</a> using each sequence's ID string (or each string in the ID\r
+separated by the '&#8739;' symbol).</p>\r
+<p>If a record (or set of records) is retrieved by any query derived\r
+from the ID string of a sequence, then the sequence is aligned to the\r
+ones retrieved to determine the correct start and end residue positions\r
+(which are displayed when the 'Show Full Sequence ID' option). This is\r
+important for the correct display of the location of any features\r
+associated with that database.</p>\r
+<p>If the alignment reveals differences between the sequence in the\r
+alignment and the one in the record, then Jalview will assume that the\r
+aligned sequence is not the one in the retrieved record.</p>\r
+<p>In some cases, the ID used to retrieve records may be out\r
+of date and a dialog box will be opened indicating that a 100% match\r
+between the sequence and the record was identified, but the\r
+sequence name is different. In this case, the can be manually\r
+changed (by right clicking on the sequence ID and selecting <strong>Sequence&#8594;Edit\r
+Name</strong>).\r
+<ul>\r
+       <li><em>Note</em><br>\r
+       Please remember to save your alignment if either the start/end\r
+       numbering, or the sequence IDs were updated during the ID\r
+       retrieval process.</li>\r
+</ul>\r
+<body></body>\r
+</html>\r
index 62e881d..6425e9c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<html>
+<head>
+<title>Web Services</title>
+</head>
+<body>
+<p><strong>Web services</strong></p>
+
+<p>Jalview includes clients for a variety of web services for both
+bioinformatic data retrieval and analysis.
+<ul>
+       <li>The <a href="../features/seqfetcher.html">Sequence Fetcher</a>
+       utilises web services for sequence, alignment and structure retrieval
+       provided by the European Bioinformatics Institute (EBI) and Distributed
+       Annotation System servers that are capable of serving sequences.</li>
+       <li>The DAS Feature Fetcher enables the retrieval and
+       visualization of features from DAS annotation sources</li>
+       <li>Jalview SOAP Web Services for sequence and alignment analysis
+       are provided by the University of Dundee, and are available from the
+       Alignment window's <strong> Web Service</strong> menu.</li>
+</ul>
+</p>
+<p>Jalview's distributed computations are SOAP based services
+exposing protein sequence alignment and secondary structure prediction
+programs. These services actually run on the cluster based in the School
+of Life Sciences, University of Dundee, and are maintained by the Barton
+group.</p>
+<p><strong><a name="envision2">Envision2 Services</a></strong></p>
+<p>Jalview 2.5 includes a client to enable the user to
+submit one or more sequences or sequence IDs 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>.</p>
+<br/>
+<p><strong>Web Service Dialog Box</strong></p>
+<img src="clwqueued.gif">
+<p>This dialog box is displayed when a web service job is submitted.
+It gives the name of the service and any method citation information,
+and monitors the progress of the calculation. The cancel button will
+permanently cancel the job, but this is only possible for some services.
+</p>
+<p>Current services:
+<ul>
+       <a href="msaclient.html"><strong>Multiple Sequence
+       Alignment Services</strong></a>
+       <ul>
+               <li><a href="clustalw.html">ClustalW Multiple Alignment and
+               re-alignment</a><br>
+               The clustal W service remains one of the more popular Jalview
+               features.</li>
+               <li><a href="muscle.html">Muscle Multiple Alignment</a><br>
+               High Quality and High Throughput multiple alignments of proteins. This
+               method can sometimes be more accurate than ClustalW when dealing with
+               diverse sets of sequences.</li>
+               <li><a href="mafft.html">MAFFT</a><br>
+               Multiple Alignment with Fast Fourier Transforms - a highly accurate
+               and high throughput dna and amino acid alignment method, performing at
+               least as well as ClustalW and Muscle.</li>
+       </ul>
+       </li>
+       <li><strong>Secondary Structure Prediction</strong>
+       <ul>
+               <li><a href="jnet.html">JNet</a><br>
+               This is a front end to the existing <a
+                       href="http://www.compbio.dundee.ac.uk/www-jpred/">JNet www server</a>
+               allowing single sequence or profile based prediction.</li>
+       </ul>
+       </li>
+</ul>
+</p>
+<!--                   <p>Watch this space! These are some of the services
+                  planned to be released soon:<ul>
+                  <li>More alignment services: PROBCONS, T-COFFEE</li>
+                  <li>Repeat analysis
+                  </li>
+                  <li>Remote Homology Detection<br>
+                  </li>
+                  </ul>
+                  In the future, Jalview will also be able to new discover services
+                  dynamically, and distribute expensive analysis functions like <a
+                  href="../calculations/pca.html">PCA</a> to the Dundee machines.</p>-->
+</body>
+</html>
index e18e273..9bb6bd1 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>JNet Secondary Structure Prediction</title>
+</head>
+<body>
+<strong>JNet Secondary Structure Prediction</strong>
+<p>Secondary structure prediction methods attempts to infer the
+likely secondary structure for a protein based on its amino acid
+composition and similarity to sequences with known secondary structure.
+The JNet method uses several different neural networks and decides on
+the most likely prediction via a jury network. <br>
+<ul>
+       <li>
+       Cole C., Barber J.D. and Barton G.J. (2008) The Jpred 3 secondary structure prediction server
+       <em>Nucleic Acids Research</em> <strong>36</strong> W197-W201</li>
+       <li>
+       Cuff J. A and Barton G.J (1999) Application of enhanced
+       multiple sequence alignment profiles to improve protein secondary
+       structure prediction <em>Proteins</em> <strong>40</strong> 502-511</li>
+</ul>
+</p>
+The function available from the
+<strong>Web Service&#8594;Secondary Structure
+Prediction&#8594;JNet Secondary Structure Prediction</strong>
+menu does two different kinds of prediction, dependent upon the
+currently selected region:
+</p>
+<ul>
+       <li>If nothing is selected, and the displayed sequences appear to
+       be aligned, then a JNet prediction will be run for the first sequence
+       in the alignment, using the current alignment. Otherwise the first
+       sequence will be submitted for prediction.</li>
+       <li>If just one sequence (or a region on one sequence) has been
+       selected, it will be submitted to the automatic JNet prediction server
+       for homolog detection and prediction.</li>
+       <li>If a set of sequences are selected, and they appear to be
+       aligned, then the alignment will be used for a Jnet prediction on the <strong>first</strong>
+       sequence selected in the set (that is, the one nearest the top of the
+       alignment window).</li>
+</ul>
+<p><strong>Note</strong>: JNet secondary structure prediction is a
+'non-column-separable' service - predictions are based on the sequence
+profile of contiguous stretches of amino-acid sequence. A prediction
+will only be made on the visible parts of a sequence (see <a
+       href="../features/hiddenRegions.html">hiding columns</a>) as if it were
+a contiguous polypeptide chain. Prediction accuracy at the hidden column
+boundaries may therefore be less than indicated by JNet's own
+reliability score (see below).</p>
+<p>The result of a JNet prediction for a sequence is a new annotated
+alignment window:</p>
+<img src="jnetprediction.gif">
+<p>The sequence for which the prediction was made is the first one
+in the alignment. If a sequence based prediction was made then the
+remaining sequences in the alignment are the aligned parts of homologs
+which were used to construct a sequence profile for the prediction. If
+the prediction was made using a multiple alignment, then the original
+multiple alignment will be returned, annotated with the prediction.</p>
+The annotation bars below the alignment are as follows:
+</p>
+<ul>
+       <li>Lupas_21, Lupas_14, Lupas_28<br>
+       <em>Coiled-coil predictions for the sequence. These are binary
+       predictions for each location.</em></li>
+       <li>JNETSOL25,JNETSOL5,JNETSOL0<br>
+       <em>Solvent accessibility predictions - binary predictions of 25%,
+       5% or 0% solvent accessibility.</em></li>
+       <li>JNetPRED<br>
+       <em>The consensus prediction - helices are marked as red tubes,
+       and sheets as dark green arrows.</em></li>
+       <li>JNetCONF<br>
+       <em>The confidence estimate for the prediction. High values mean
+       high confidence. prediction - helices are marked as red tubes, and
+       sheets as dark green arrows.</em></li>
+       <li>JNetALIGN<br>
+       <em>Alignment based prediction - helices are marked as red tubes,
+       and sheets as dark green arrows.</em></li>
+       <li>JNetHMM<br>
+       <em>HMM profile based prediction - helices are marked as red
+       tubes, and sheets as dark green arrows.</em></li>
+       <li>jpred<br>
+       <em>Jpred prediction - helices are marked as red tubes, and sheets
+       as dark green arrows.</em></li>
+       <li>JNETPSSM<br>
+       <em>PSSM based prediction - helices are marked as red tubes, and
+       sheets as dark green arrows.</em></li>
+       <li>JNETFREQ<br>
+       <em>Amino Acid frequency based prediction - helices are marked as
+       red tubes, and sheets as dark green arrows.</em></li>
+       <li>JNETJURY<br>
+       <em>A '*' in this annotation indicates that the JNETJURY was
+       invoked to rationalise significantly different primary predictions.</em></li>
+</ul>
+</p>
+</body>
+</html>
index e18e273..e777fd4 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>MAFFT Multiple Sequence Alignments</title></head>
+<body>
+<p><strong>MAFFT Multiple Sequence Alignments</strong></p>
+<p> Katoh, K., K. Kuma, K., Toh, H., and Miyata, T. (2005) &quot;MAFFT version 
+  5: improvement in accuracy of multiple sequence alignment.&quot; Nucleic Acids 
+  Research, 33 511-518</p>
+<p>MAFFT is a program for the multiple alignment of nucleic acid or protein
+sequences, and is available from the <strong>Web
+Service&#8594;Alignment&#8594;MAFFT Multiple Sequence
+Alignment</strong> entry in the web services menu.</p>
+<p>MAFFT utilizes algorithms for spectral correlation to identify
+homologous regions in a fast-fourier transform representation of each
+sequence. The Jalview web service runs MAFFT using the
+'--auto' option which picks optimal parameters
+for the set of sequences to be aligned.</p>
+</body>
+</html>
index e18e273..7f4bac9 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+<title>Multiple Sequence Alignment Web Service</title>
+</head>
+<body>
+<strong>Multiple Sequence Alignment Web Services</strong>
+<p>
+Multiple sequence alignment services are accessed from the <strong>Web
+Service&#8594;Alignment</strong> menu. When an entry from this menu is
+selected, either the currently selected residues, or the whole
+sequence set (if there is no selection or only one sequence is
+selected) will be submitted for multiple sequence alignment.
+</p>
+<p>There are two kinds of multiple sequence alignment operations
+available:<ul>
+<li><em>alignment</em> - where a new alignment is constructed from the input
+</li>
+<li><em>realignment</em> -
+where any existing alignments in the input are passed to the service
+for profile based alignment.
+</li>
+</ul>
+</p>
+<p>
+<strong>Multiple Alignments of Sequences with hidden columns</strong><br>
+Multiple alignment services are 'column separable' analysis
+operations. If the input contains <a
+href="../features/hiddenRegions.html">hidden columns</a> then each
+visible segment of the input sequence set will be submitted for
+alignment separately, and the results concatenated (with the hidden
+regions preserved) once all alignment functions have completed. Each
+sub-job's state is reported in its own tab:
+<p><center><strong>Multiple Multiple Sequence Alignment sub jobs running at
+once</strong><center></p>
+<center><img src="multimafftjbs.gif" align="centre"></center>
+</p>
+</body>
+</html>
index e18e273..2af44a6 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head><title>Muscle Alignment</title></head>
+<body>
+<p><strong>Muscle Alignments</strong></p>
+<p>Muscle is a program for the alignment of many protein sequences.</p>
+<p>
+Edgar, Robert C. (2004), MUSCLE: multiple sequence alignment with high
+accuracy and high throughput<br>
+<em>Nucleic Acids Research</em> <strong>32</strong>(5), 1792-97.</p>
+<p> This alignment method is applied to the selected region, if any, or the whole 
+  sequence set when the <strong>Web Service&#8594;Alignment&#8594;Muscle 
+  Protein Sequence Alignment</strong> menu item is selected. </p>
+</body>
+</html>
index e18e273..56374f6 100644 (file)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+<head>
+Opening URLs from Jalview
+</head>
+<body>
+<p>
+<p><strong>Opening URLs from Jalview</strong><br>
+Both the applet and the desktop application are able to open URLs as
+'popups' in your web browser. <br>
+Double-clicking on the ID of a sequence will open the first URL that can
+be generated from its sequence ID. This is often the SRS site, but you
+can easily configure your own <a href="#urllinks>sequence URL links</a>.</p>
+<p>Other links for a sequence either derived from any other
+configured URL links, or imported from the sequence's annotation, are
+accessed by right clicking to open the sequence pop-up menu, and
+selecting from the <em>Links</em> submenu.</p>
+<p><strong><a name="urllinks">Configuring URL Links</a></strong>
+<br>URL links are defined in the &quot;Connections&quot; tab of the <a
+       href="../features/preferences.html">Jalview desktop preferences</a>, or
+specified as <a
+       href="http://www.jalview.org/examples/appletParameters.html#parameters">applet
+parameters</a>. <br>
+By default the item &quot;SRS&quot; is added to this link menu. This
+link will show a web page in your default browser with the selected
+sequence id as part of the URL.<br>
+In the preferences dialog box, click <strong>new</strong> to add a new
+link, and <strong>edit</strong> to modify an existing link, or <strong>delete</strong>
+to remove it.<br>
+You can name the link, this will be displayed on a new menu item under
+the &quot;Link&quot; menu when you right click on a sequence id. <br>
+The URL string must contain a token that can be replaced with a sequence
+ID. The simplest token is &quot;$SEQUENCE_ID$&quot;, which will be
+replaced by the chosen sequence id when you click on it.</p>
+<p>eg.<br>
+UniRef100 =
+http://www.ebi.uniprot.org/uniprot-srv/uniRefView.do?proteinAc=$SEQUENCE_ID$&amp;library=uniref100<br>
+Swissprot = http://www.expasy.org/uniprot/$SEQUENCE_ID$ <br>
+<br>
+Links will also be made for any database cross references associated
+with the sequence where the database name exactly matches a URL link
+name. In this case, the $SEQUENCE_ID$ string will be replaced with the
+accession string for the database cross-reference, rather than the
+sequence ID for the sequence (<em>since Jalview 2.4</em>).</p>
+<p><strong>Regular Expression Substitution</strong><br>
+A url may contain a string of the form $SEQUENCE_ID=/<em>regular
+expression</em>/=$. In this case, the regular expression will be applied to
+the full sequence ID string and the resulting match will be inserted
+into the URL. Groups of parentheses can be used to specify which regions
+of the regular expression will be used to generate the URL:
+<ul>
+       <li>Each top level parenthesis will yield a URL containing the
+       text matched within that parenthesis.</li>
+       <li>Regions matching sub-parentheses within a top-level
+       parenthesis will be concatenated to form the text inserted into the URL
+       for the top-level parenthesis.</li>
+       <em>Please Note:
+       <ul>
+               <li>The regular expressions supported by Jalview are those
+               provided by the <a href="www.javaregex.com">Stevesoft javaregex
+               package</a>.</li>
+               <li>Some characters must be escaped when specifying them as a
+               match within a regular expression.</li>
+       </ul>
+       <br>
+       Many Thanks to Bernd Brandt of the Free University of Amsterdam for
+       testing this new regular-expression expansion feature! </em>
+       <em>
+</ul>
+</p>
+</p>
+</body>
+</html>
index 62e881d..e1e4d98 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Acknowledgements</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="dedication.html" title="Dedication"><link rel="next" href="introduction.html" title="Introduction"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Acknowledgements</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="dedication.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="introduction.html">Next</a></td></tr></table><hr></div><div class="preface" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="acknowledge"></a>Acknowledgements</h2></div></div><div></div></div><p>
+First and foremost I wish to thank the creators of the free software libraries
+I use. Jalopy includes software developed by the
+<a href="http://www.apache.org/" target="_top">Apache Software Foundation</a>,
+the <a href="http://www.bluej.org/" target="_top">BlueJ Group</a>,
+<a href="http://www.saxproject.org/" target="_top">David Brownell</a>,
+<a href="http://sf.net/projects/saxon/" target="_top">Michael H. Kay</a>,
+the <a href="http://www.jdom.org" target="_top">JDOM group</a>,
+<a href="http://www.saxproject.org/" target="_top">David Megginson</a>,
+<a href="http://www.antlr.org/" target="_top">Terence Parr</a>,
+<a href="http://www.jedit.org/" target="_top">Slava Pestov</a>,
+<a href="http://www.urbanophile.com/~arenn/hacking/download.html" target="_top">Aaron M. Renn</a> and
+<a href="http://java.sun.com/xml/" target="_top">Sun Microsystems, Inc.</a>.
+Please refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for a more detailed list
+and the individual licensing terms.
+</p><p>
+I would like to say a big thanks to Michael Callum, Frank Klomp, Roman Sarychev,
+David Beutel, Denis N. Antonioli and Kees Kuip who contributed code.
+</p><p>
+Thanks also to all users who provided feedback, submitted bug reports and requested new
+features.
+</p><p>
+A special thanks to Larry Hamel for the initial proof-reading of this manual.
+</p><p>
+Last but not least, I wish to thank the <a href="http://sf.net/" target="_top">SourceForge</a>
+crew for not only hosting the Jalopy web site and providing the collaborative development
+infrastructure but also for their help and support in getting things up and running.
+</p><p>
+And finally, my special thanks to the bright light in the big city, whose love has been
+a home and a foreign country, the best of both worlds.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="dedication.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="introduction.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Dedication&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Introduction</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..b507c23 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Bibliography</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="next" href="ix01.html" title="Index"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Bibliography</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-sun-public.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ix01.html">Next</a></td></tr></table><hr></div><div class="bibliography"><div class="titlepage"><div><div><h2 class="title"><a name="d0e7903"></a>Bibliography</h2></div></div><div></div></div><div class="biblioentry"><p>[<span class="abbrev"><a name="bloch01"></a>Bloch01</span>] <span class="biblioset"><span class="author"><span class="firstname">Joshua</span> <span class="surname">Bloch</span>. </span><i><a href="http://java.sun.com/docs/books/effective/" target="_top">Effective Java</a></i>. <span class="subtitle">Programming Language Guide. </span><span class="publisher"><span class="publishername">Addison-Wesley, 2001. </span></span>
+  ISBN: <span class="isbn">0-201-31005-8. </span></span></p></div><div class="biblioentry"><p>[<span class="abbrev"><a name="friedl97"></a>Friedl97</span>] <span class="biblioset"><span class="author"><span class="firstname">Jeffrey E. F.</span> <span class="surname">Friedl</span>. </span><i>Mastering Regular Expressions</i>. <span class="publisher"><span class="publishername">O'Reilly, 1997. </span></span>
+  ISBN: <span class="isbn">1-56592-257-3. </span></span></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-sun-public.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ix01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Index</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..de51771 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;2.&nbsp;Building</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="previous" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="next" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="build.html#build-prerequisites" title="2.1.&nbsp;Prerequisites"><link rel="subsection" href="build.html#build-build" title="2.2.&nbsp;Building">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;2.&nbsp;Building</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;Jalopy core</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="usage.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="build"></a>Chapter&nbsp;2.&nbsp;Building</h2></div></div><div></div></div><a class="indexterm" name="d0e706"></a><p>
+Explains the steps involved in building Jalopy from the sources.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="build-prerequisites"></a>2.1.&nbsp;Prerequisites</h4></div></div><div></div></div><a class="indexterm" name="d0e716"></a><p>
+The following software must be installed separately, in order to build from the
+sources:
+</p><div class="table"><a name="tab-build-prerequisites"></a><p class="title"><b>Table&nbsp;2.1.&nbsp;Software needed to build from the sources</b></p><table summary="Software needed to build from the sources" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr><td style="" valign="top">Jakarta Ant</td><td style="">
+Jalopy comes with a simple, Ant-based build system. So you first need to obtain and
+install Ant as outlined in the
+<a href="http://jakarta.apache.org/ant/manual/install.html" target="_top">Ant manual</a>.
+The build system is only tested against the Ant 1.5.4 release, but later
+releases of Ant may also work.
+</td></tr><tr><td style="" valign="top">Oasis DocBook XML DTD</td><td style="">
+All documentation is written using DocBook Version 4.2 markup. You can get the DTD
+from the
+<a href="http://www.oasis-open.org/committees/docbook/xml/4.2/index.shtml" target="_top">OASIS web site</a>.
+Unpack the sources into a folder of your choice and remember this path as it will be
+needed for configuration later on.
+</td></tr><tr><td style="" valign="top">An XSLT processor</td><td style="">
+The DocBook markup needs to be transformed in order to make some user-friendly appearance.
+This is done via XSLT and Michael Kay's Saxon is the processor I found working with the
+Stylesheet package I use. You should download the current stable production
+release from SourceForge (<a href="http://saxon.sf.net" target="_top">http://saxon.sf.net</a>)
+and extract the file <tt class="filename">saxon.jar</tt> into the <tt class="filename">/lib</tt>
+folder of your Ant installation directory.  I also had to setup saxon to use
+Xerces as the XML parser by editing the
+META-INF/services/javax.xml.parsers.SAXParserFactory file inside of
+saxon.jar and replacing the alfred parser with org.apache.xerces.jaxp.SAXParserFactoryImpl
+</td></tr><tr><td style="" valign="top">DocBook XSL Stylesheets</td><td style="">
+To perform the markup translation you need Norman Walsh's XSL Stylesheet package.
+The version that works for me is 1.62.4. You can get it from SourceForge
+(<a href="http://docbook.sf.net" target="_top">http://docbook.sf.net</a>).
+Copy the file <tt class="filename">extensions/saxon651.jar</tt> that
+comes with the distribution into the <tt class="filename">/lib</tt> folder of your
+Ant installation directory as this file is needed for sophisticated table generation.
+</td></tr><tr><td style="" valign="top">A CVS client (optional)</td><td style="">
+If you plan to get the sources directly from CVS you need a CVS client. If your system
+does not come with one pre-installed (most Linux machines at least have the command-line
+client installed by default), you will certainly want to visit any of several good sites
+such as <a href="http://www.cvshome.org/" target="_top">http://www.cvshome.org/</a>
+which <a href="http://www.cvshome.org/dev/codes.html" target="_top">lists</a> available CVS clients
+for different platforms, their strengths and weaknesses. For what it's worth, I prefer
+<a href="http://www.smartcvs.com" target="_top">SmartCVS</a>.
+</td></tr></tbody></table></div><p></p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="build-build"></a>2.2.&nbsp;Building</h4></div></div><div></div></div><p>
+The basic steps to build Jalopy from the sources are:
+</p><div class="orderedlist"><ol type="1"><li><p>
+Get and install the needed software as outlined in <a href="build.html#build-prerequisites" title="2.1.&nbsp;Prerequisites">Section&nbsp;2.1, &#8220;Prerequisites&#8221;</a>.
+Make sure Ant is set up correctly.
+</p></li><li><p>
+Get the sources. Either download and unpack the
+<a href="./download.html#source" target="_top">Jalopy source distribution</a> which
+contains the complete Jalopy sources. Or grab the needed modules directly from the
+<a href="http://sourceforge.net/cvs/?group_id=45216" target="_top">CVS</a> tree.</p></li><li><p>
+Change to the directory where your Jalopy sources reside. You should find a
+directory layout somewhat similar to the following (each directory represents a
+module; the minimal needed modules are printed in <span class="emphasis"><em>bold</em></span>):
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+ ..
+   ant/                  The Ant Plug-in
+   <span class="bold"><b>build/</b></span>                The Jalopy build system
+   console/
+   <span class="bold"><b>docu/</b></span>                 All documentation sources
+   eclipse/              The Eclipse Plug-in
+   jbuilder/             The JBuilder Plug-in
+   jdeveloper/           The JDeveloper Plug-in
+   jedit/                The jEdit Plug-in
+   <span class="bold"><b>main/</b></span>                 The core Jalopy sources
+   netbeans/             The NetBeans/Sun ONE Studio Plug-in
+</pre></td></tr></table><p>
+Change directory into <tt class="filename">/build</tt> where the master build script
+lurks.
+</p></li><li><p>
+Adjust the global build properties to match your installation. The build
+system uses quite a few properties to control the build process and
+specify additional needed resources. You can find and adjust these properties in the file
+<tt class="filename">build.properties</tt>.
+</p><p>
+Luckily you only have to change some common properties to get things running:
+</p><div class="variablelist"><p class="title"><b>Common build properties</b></p><dl><dt><span class="term">DIR.DOCBOOK.XSL</span></dt><dd><p>
+Specifies the installation directory of the DocBook XSL Stylesheets package.
+Note that you have to specify a protocol, e.g. <tt class="filename">file:///G:/XML/docbook-xsl-1.62.4</tt>.
+</p></dd><dt><span class="term">DIR.DOCBOOK.DTD</span></dt><dd><p>
+Specifies the path where to find the DocBook XSL DTD.
+You have to adjust the default path to match your installation.
+</p></dd><dt><span class="term">LIB.PATH.<i class="replaceable"><tt>&lt;modulename&gt;</tt></i></span></dt><dd><p>
+Specifies additional library path(s) needed to build a certain module.
+You have to adjust the default path(s) to match your installation.
+</p></dd><dt><span class="term">PACKAGE.PATH.<i class="replaceable"><tt>&lt;libraryname&gt;</tt></i></span></dt><dd><p>
+Specifies the location to a directory containing the package-list file for a
+given library. This is optional and only needed by Javadoc to resolve links to
+documentation for externally referenced classes. Change the default path(s)
+to match your installation.
+</p></dd></dl></div></li><li><p>
+Once everything is set up, you can start a build using <span><b class="command">ant</b></span> <i class="parameter"><tt>target</tt></i>
+where <i class="parameter"><tt>target</tt></i> describes one of the main build targets (those with a
+description, use <span><b class="command">ant</b></span> <i class="parameter"><tt>-projecthelp</tt></i> to display
+the available targets). Just typing <span><b class="command">ant</b></span> will build the Jalopy
+core runtime distribution.
+</p></li><li><p>
+When a build is done, you can find the created distribution(s) in the
+<tt class="filename">tmp~/dist</tt> folder. The build system creates and stores all
+intermediate files and subdirectories under the <tt class="filename">tmp~</tt>
+directory.
+</p></li><li><p>
+If you make changes to the source code, just run Ant again; this will perform a
+faster <i class="firstterm">incremental</i> rebuild of the target.
+</p></li></ol></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="installation.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-core.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="usage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;1.&nbsp;Installation&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;3.&nbsp;Usage</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..8a75953 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.6.&nbsp;Comments</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="separation.html" title="4.3.5.&nbsp;Blank Lines"><link rel="next" href="imports.html" title="4.3.7.&nbsp;Imports"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="comments.html#coments-remove" title="4.3.6.1.&nbsp;Remove"><link rel="subsection" href="comments.html#coments-format" title="4.3.6.2.&nbsp;Format">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.6.&nbsp;Comments</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="separation.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="imports.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="comments"></a>4.3.6.&nbsp;Comments</h3></div></div><div></div></div><p>
+Controls how Jalopy handles certain types of comments.
+</p><p>
+As far as Jalopy is concerned, there are five types of comments:
+
+</p><div class="orderedlist"><ol type="1"><li><p><a name="comments-single"></a>
+Single-line comments <tt class="literal">// text</tt>
+</p><a class="indexterm" name="d0e3757"></a><a class="indexterm" name="d0e3762"></a><p>
+An <span class="emphasis"><em>end-of-line comment</em></span>: all text from the ASCII characters
+<tt class="literal">//</tt> to the end of the line
+</p><div class="example"><a name="ex-comments-single"></a><p class="title"><b>Example&nbsp;4.130.&nbsp;Single-line comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+<span class="bold"><b>// [PENDING] this should be part of the ErrorManager</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="comments-multi"></a>
+Multi-line comments <tt class="literal">/* text */</tt>
+</p><a class="indexterm" name="d0e3788"></a><a class="indexterm" name="d0e3793"></a><p>
+A <span class="emphasis"><em>traditional comment</em></span>: all text from the ASCII characters <tt class="literal">/*</tt>
+to the ASCII characters <tt class="literal">*/</tt>
+</p><div class="example"><a name="ex-comments-multi"></a><p class="title"><b>Example&nbsp;4.131.&nbsp;Multi-line comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+<span class="bold"><b>/* public int getSubregionStartOffset(int line, int subregion)
+{
+       ChunkCache.LineInfo[] lineInfos = chunkCache.getLineInfosForPhysicalLine(line);
+       return buffer.getLineStartOffset(lineInfos[subregion].physicalLine)
+               + lineInfos[subregion].offset;
+} */</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="comments-javadoc"></a>
+Javadoc comments <tt class="literal">/** text */</tt>
+</p><a class="indexterm" name="d0e3822"></a><a class="indexterm" name="d0e3827"></a><p>
+A <span class="emphasis"><em>documentation comment</em></span>: actually a special kind of
+multi-line comment as defined by the Sun Javadoc specification;
+all text from the ASCII characters <tt class="literal">/**</tt>
+to the ASCII characters <tt class="literal">*/</tt>
+</p><div class="example"><a name="ex-comments-javadoc"></a><p class="title"><b>Example&nbsp;4.132.&nbsp;Javadoc comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+<span class="bold"><b>/**
+ * A scroll listener will be notified when the text area is scrolled, either
+ * horizontally or vertically.
+ *
+ * @author Slava Pestov
+ * @since jEdit 3.2pre2
+ */</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="comments-separator"></a>
+Separator comments <tt class="literal">//~ text</tt>
+</p><a class="indexterm" name="d0e3856"></a><a class="indexterm" name="d0e3861"></a><p>
+A Jalopy-specific <span class="emphasis"><em>separator comment</em></span>: actually a special kind of single-line comment;
+all text from the ASCII characters
+<tt class="literal">//~</tt> to the end of the line
+</p><div class="example"><a name="ex-comments-separator"></a><p class="title"><b>Example&nbsp;4.133.&nbsp;Separator comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+<span class="bold"><b>//~ Inner classes .......................................</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="comments-pragma"></a>
+Pragma comments <tt class="literal">//J[directive]</tt>
+</p><a class="indexterm" name="d0e3887"></a><a class="indexterm" name="d0e3892"></a><p>
+A Jalopy-specific <span class="emphasis"><em>control comment</em></span>: actually a special kind of single-line comment;
+all text from the ASCII characters
+<tt class="literal">//J[-|+]</tt> to the end of the line
+</p><div class="example"><a name="ex-comments-control"></a><p class="title"><b>Example&nbsp;4.134.&nbsp;Control comments</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+<span class="bold"><b>//J-</b></span>
+    if {condition()) return value;
+<span class="bold"><b>//J+</b></span>
+</pre></td></tr></table></div><p>
+Currently, Jalopy recognizes two pragma comments: <tt class="literal">//J-</tt> and <tt class="literal">//J+</tt>
+</p><p>
+With these comments you can disable formatting for certain code sections.
+<tt class="literal">//J-</tt> tells Jalopy to disable formatting until <tt class="literal">//J+</tt>
+will enable it again. Note that these comments can only be used in conjunction! Omitting the <tt class="literal">//J+</tt> will certainly produce errors.
+</p></li></ol></div><p>
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="coments-remove"></a>4.3.6.1.&nbsp;Remove</h4></div></div><div></div></div><p>
+Controls whether and what types of comments should be removed during the
+formatting process.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="comments-remove-single"></a>
+Single-line comments
+</p><a class="indexterm" name="d0e3943"></a><a class="indexterm" name="d0e3948"></a><p>
+If enabled, removes all single-line comments found in a source file.
+</p></li><li><p><a name="comments-remove-multi"></a>
+Multi-line comments
+</p><a class="indexterm" name="d0e3956"></a><a class="indexterm" name="d0e3961"></a><p>
+If enabled, removes all multi-line comments (sometimes called block comments) found in a source file.
+</p></li><li><p><a name="comments-remove-javadoc"></a>
+Javadoc comments
+</p><a class="indexterm" name="d0e3969"></a><a class="indexterm" name="d0e3974"></a><p>
+If enabled, removes all Javadoc comments found in a source file. This may prove
+useful in conjunction with the <a href="javadoc.html#javadoc-generation" title="4.3.9.2.&nbsp;Generation">Javadoc auto-generation capabilities</a>
+to build Javadoc from scratch.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="coments-format"></a>4.3.6.2.&nbsp;Format</h4></div></div><div></div></div><p>
+Controls the reformatting of comments.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="comments-format-multi"></a>
+Multi-line comments
+</p><a class="indexterm" name="d0e3991"></a><a class="indexterm" name="d0e3996"></a><p>
+Enables the reformatting of multi-line comments. Only affects the leading
+asterixes of consecutive comment lines as shown in the examples below.
+</p><div class="example"><a name="ex-comments-multi-line"></a><p class="title"><b>Example&nbsp;4.135.&nbsp;Multi-line comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+/* Multi-line
+* comment.
+* end.
+*/
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-comments-multi-line-formatted"></a><p class="title"><b>Example&nbsp;4.136.&nbsp;Multi-line comment (reformatted)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+/* Multi-line
+ * comment.
+ * end.
+ */
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="separation.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="imports.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.5.&nbsp;Blank Lines&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.7.&nbsp;Imports</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..9d2518d 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Contact</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="trackers"></a>Trackers</h2></div></div><div></div></div><p>
+Please use the following SourceForge trackers to submit bug reports or post
+feature requests:
+</p><div class="blockquote"><blockquote class="blockquote"><table class="simplelist" border="0" summary="Simple list"><tr><td><a href="http://sf.net/tracker/?func=add&amp;group_id=45216&amp;atid=442212" target="_top">Submit a bug report</a></td></tr><tr><td><a href="http://sf.net/tracker/?func=add&amp;group_id=45216&amp;atid=442215" target="_top">Request a new feature</a></td></tr><tr><td><a href="http://sf.net/tracker/?func=add&amp;group_id=45216&amp;atid=442214" target="_top">Send a patch</a></td></tr><tr><td><a href="http://sf.net/tracker/?func=add&amp;group_id=45216&amp;atid=442213" target="_top">Ask for support</a></td></tr></table></blockquote></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailing-lists"></a>Mailing Lists</h2></div></div><div></div></div><p>
+If you want to provide feedback on this software or stay current with the
+latest development, you may want to join one of the Jalopy mailing lists.
+</p><div class="informaltable"><table cellspacing="0" cellpadding="2" border="0" style="border-collapse: collapse;border-top: 0.5pt solid ; border-bottom: 0.5pt solid ; border-left: 0.5pt solid ; border-right: 0.5pt solid ; "><colgroup><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">List</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Subscribe/Unsubcribe</th><th style="border-bottom: 0.5pt solid ; ">Browse Archives</th></tr></thead><tbody><tr><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; "><span class="bold"><b>jalopy-announce</b></span><p>A high-level
+announcements list, for things like major release notifications
+or important bug-fixes. This is not a discussion list, and is not open to
+public posting. Traffic is expected to be very low.
+</p><p>
+If you're interested in
+Jalopy, it is recommended you subscribe at a minimum to this list.
+</p></td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; "><a href="http://lists.sf.net/mailman/listinfo/jalopy-announce" target="_top">Subscribe/Unsubscribe</a></td><td style="border-bottom: 0.5pt solid ; "><a href="http://sourceforge.net/mailarchive/forum.php?forum=jalopy-announce" target="_top">Browse archives</a></td></tr><tr><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; "><span class="bold"><b>jalopy-user</b></span><p>
+Intended for
+users to ask questions, share knowledge, and discuss general Jalopy related issues.
+</p></td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; "><a href="http://lists.sf.net/mailman/listinfo/jalopy-user" target="_top">Subscribe/Unsubscribe</a></td><td style="border-bottom: 0.5pt solid ; "><a href="http://sourceforge.net/mailarchive/forum.php?forum=jalopy-user" target="_top">Browse archives</a></td></tr><tr><td style="border-right: 0.5pt solid ; "><span class="bold"><b>jalopy-development</b></span><p>
+Hosts development related discussions.
+</p></td><td style="border-right: 0.5pt solid ; "><a href="http://lists.sf.net/mailman/listinfo/jalopy-development" target="_top">Subscribe/Unsubscribe</a></td><td style=""><a href="http://sourceforge.net/mailarchive/forum.php?forum=jalopy-development" target="_top">Browse archives</a></td></tr></tbody></table></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..9a69927 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Contributors</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="contributors"></a>Contributors</h2></div></div><div></div></div><p>
+The following people have contributed to the Jalopy project:
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Michael Callum
+</li><li style="list-style-type: square">
+Frank Klomp
+</li><li style="list-style-type: square">
+Larry Hamel
+</li><li style="list-style-type: square">
+Roman Sarychev
+</li><li style="list-style-type: square">
+Denis N. Antonioli
+</li><li style="list-style-type: square">
+David Beutel
+</li><li style="list-style-type: square">
+Kees Kuip
+</li></ul></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..86d2b37 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Dedication</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="manual.html" title="Jalopy User Manual"><link rel="next" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Dedication</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="manual.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="acknowledge.html">Next</a></td></tr></table><hr></div><div class="preface" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="dedication"></a>Dedication</h2></div></div><div></div></div><p>
+This work is inspired by and dedicated to the poet who writes:
+</p><div class="blockquote"><blockquote class="blockquote"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e29"></a>Tabacaria</h2></div></div><div></div></div><div class="informaltable"><table border="0" style="border-collapse: collapse;"><colgroup><col></colgroup><tbody><tr><td style="">N&atilde;o sou nada.</td></tr><tr><td style="">Nunca serei nada.</td></tr><tr><td style="">N&atilde;o posso querer ser nada.</td></tr><tr><td style="">&Agrave; parte isso, tenho em mim todos os sonhos do mundo.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Janelas do meu quarto,</td></tr><tr><td style="">Do meu quarto de um dos milh&otilde;es do mundo que ningu&eacute;m sabe quem &eacute;</td></tr><tr><td style="">(E se soubessem quem &eacute;, o que saberiam?),</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Dais para o mist&eacute;rio de uma rua cruzada constantemente por gente,</td></tr><tr><td style="">Para uma rua inacess&iacute;vel a todos os pensamentos,</td></tr><tr><td style="">Real, impossivelmente real, certa, desconhecidamente certa,</td></tr><tr><td style="">Com o mist&eacute;rio das coisas por baixo das pedras e dos seres,</td></tr><tr><td style="">Com a morte a p&ocirc;r humidade nas paredes e cabelos brancos nos homens,</td></tr><tr><td style="">Com o Destino a conduzir a carro&ccedil;a de tudo pela estrada de nada. </td></tr><tr><td style="">Estou hoje vencido, como se soubesse a verdade. </td></tr><tr><td style="">Estou hoje l&uacute;cido, como se estivesse para morrer, </td></tr><tr><td style="">E n&atilde;o tivesse mais irmandade com as coisas </td></tr><tr><td style="">Sen&atilde;o uma despedida, tornando-se esta casa e este lado da rua</td></tr><tr><td style="">A fileira de carruagens de um comboio, e uma partida apitada</td></tr><tr><td style="">De dentro da minha cabe&ccedil;a, </td></tr><tr><td style="">E uma sacudidela dos meus nervos e um ranger de ossos na ida.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Estou hoje perplexo como quem pensou e achou e esqueceu.</td></tr><tr><td style="">Estou hoje dividido entre a lealdade que devo </td></tr><tr><td style="">Estou hoje dividido entre a lealdade que devo </td></tr><tr><td style="">E &agrave; sensa&ccedil;&atilde;o de que tudo &eacute; sonho, como coisa real por dentro.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Falhei em tudo.</td></tr><tr><td style="">Como n&atilde;o fiz prop&oacute;sito nenhum, talvez tudo fosse nada. </td></tr><tr><td style="">A aprendizagem que me deram,</td></tr><tr><td style="">Desci dela pela janela das traseiras da casa, </td></tr><tr><td style="">Fui at&eacute; ao campo com grandes prop&oacute;sitos. </td></tr><tr><td style="">Mas l&aacute; encontrei s&oacute; ervas e &aacute;rvores, </td></tr><tr><td style="">E quando havia gente era igual &agrave; outra. </td></tr><tr><td style="">Saio da janela, sento-me numa cadeira. Em que hei-de pensar? </td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Que sei eu do que serei, eu que n&atilde;o sei o que sou? </td></tr><tr><td style="">Ser o que penso? Mas penso ser tanta coisa!</td></tr><tr><td style="">E h&aacute; tantos que pensam ser a mesma coisa que n&atilde;o pode haver tantos!</td></tr><tr><td style="">G&ecirc;nio? Neste momento</td></tr><tr><td style="">Cem mil c&eacute;rebros se concebem em sonho g&ecirc;nios como eu,</td></tr><tr><td style="">E a hist&oacute;ria n&atilde;o marcar&aacute;, quem sabe?, nem um,</td></tr><tr><td style="">Nem haver&aacute; sen&atilde;o estrume de tantas conquistas futuras.</td></tr><tr><td style="">N&atilde;o, n&atilde;o creio em mim.</td></tr><tr><td style="">Em todos os manic&ocirc;mios h&aacute; doidos malucos com tantas certezas!</td></tr><tr><td style="">Eu, que n&atilde;o tenho nenhuma certeza, sou mais certo ou menos certo?</td></tr><tr><td style="">N&atilde;o, nem em mim...</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Em quantas mansardas e n&atilde;o-mansardas do mundo</td></tr><tr><td style="">N&atilde;o est&atilde;o nesta hora g&eacute;nios-para-si-mesmos sonhando?</td></tr><tr><td style="">Quantas aspira&ccedil;&otilde;es altas e nobres e l&uacute;cidas -</td></tr><tr><td style="">Sim, verdadeiramente altas e nobres e l&uacute;cidas -,</td></tr><tr><td style="">E quem sabe se realiz&aacute;veis,</td></tr><tr><td style="">Nunca ver&atilde;o a luz do sol real nem achar&atilde;o ouvidos de gente?</td></tr><tr><td style="">O mundo &eacute; para quem nasce para o conquistar</td></tr><tr><td style="">E n&atilde;o para quem sonha que pode conquist&aacute;-lo, ainda que tenha raz&atilde;o.
+</td></tr><tr><td style="">Tenho sonhado mais que o que Napole&atilde;o fez.</td></tr><tr><td style="">Tenho apertado ao peito hipot&eacute;tico mais humanidades do que Cristo,</td></tr><tr><td style="">Tenho feito filosofias em segredo que nenhum Kant escreveu.</td></tr><tr><td style="">Mas sou, e talvez serei sempre, o da mansarda,</td></tr><tr><td style="">Ainda que n&atilde;o more nela;</td></tr><tr><td style="">Serei sempre o que n&atilde;o nasceu para isso;</td></tr><tr><td style="">Serei sempre s&oacute; o que tinha qualidades;</td></tr><tr><td style="">Serei sempre o que esperou que lhe abrissem a porta ao p&eacute; de uma parede sem porta</td></tr><tr><td style="">E cantou a cantiga do Infinito numa capoeira,</td></tr><tr><td style="">E ouviu a voz de Deus num po&ccedil;o tapado.</td></tr><tr><td style="">Crer em mim? N&atilde;o, nem em nada.</td></tr><tr><td style="">Derrame-me a Natureza sobre a cabe&ccedil;a ardente</td></tr><tr><td style="">O seu sol, a sua chuva, o vento que me acha o cabelo,</td></tr><tr><td style="">E o resto que venha se vier, ou tiver que vir, ou n&atilde;o venha.</td></tr><tr><td style="">Escravos card&iacute;acos das estrelas,</td></tr><tr><td style="">Conquistamos todo o mundo antes de nos levantar da cama;</td></tr><tr><td style="">Mas acordamos e ele &eacute; opaco,</td></tr><tr><td style="">Levantamo-nos e ele &eacute; alheio,</td></tr><tr><td style="">Sa&iacute;mos de casa e ele &eacute; a terra inteira,</td></tr><tr><td style="">Mais o sistema solar e a Via L&aacute;ctea e o Indefinido.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">(Come chocolates, pequena;</td></tr><tr><td style="">Come chocolates!</td></tr><tr><td style="">Olha que n&atilde;o h&aacute; mais metaf&iacute;sica no mundo sen&atilde;o chocolates.</td></tr><tr><td style="">Olha que as religi&otilde;es todas n&atilde;o ensinam mais que a confeitaria.</td></tr><tr><td style="">Come, pequena suja, come!</td></tr><tr><td style="">Pudesse eu comer chocolates com a mesma verdade com que comes!</td></tr><tr><td style="">Mas eu penso e, ao tirar o papel de prata, que &eacute; de folhas de estanho,</td></tr><tr><td style="">Deito tudo para o ch&atilde;o, como tenho deitado a vida.)</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Mas ao menos fica da amargura do que nunca serei</td></tr><tr><td style="">A caligrafia r&aacute;pida destes versos,</td></tr><tr><td style="">P&oacute;rtico partido para o Imposs&iacute;vel.</td></tr><tr><td style="">Mas ao menos consagro a mim mesmo um desprezo sem l&aacute;grimas,</td></tr><tr><td style="">Nobre ao menos no gesto largo com que atiro</td></tr><tr><td style="">A roupa suja que sou, sem rol, pra o decurso das coisas,</td></tr><tr><td style="">E fico em casa sem camisa.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">(Tu, que consolas, que n&atilde;o existes e por isso consolas,</td></tr><tr><td style="">Ou deusa grega, concebida como est&aacute;tua que fosse viva,</td></tr><tr><td style="">Ou patr&iacute;cia romana, impossivelmente nobre e nefasta,</td></tr><tr><td style="">Ou princesa de trovadores, gentil&iacute;ssima e colorida,</td></tr><tr><td style="">Ou marquesa do s&eacute;culo dezoito, decotada e long&iacute;nqua,</td></tr><tr><td style="">Ou cocote c&eacute;lebre do tempo dos nossos pais,</td></tr><tr><td style="">Ou n&atilde;o sei qu&ecirc; moderno - n&atilde;o concebo bem o qu&ecirc; -,</td></tr><tr><td style="">Tudo isso, seja o que for, que sejas, se pode inspirar que inspire!</td></tr><tr><td style="">Meu cora&ccedil;&atilde;o &eacute; um balde despejado.</td></tr><tr><td style="">Como os que invocam esp&iacute;ritos invocam esp&iacute;ritos invoco</td></tr><tr><td style="">A mim mesmo e n&atilde;o encontro nada.</td></tr><tr><td style="">Chego &agrave; janela e vejo a rua com uma nitidez absoluta.</td></tr><tr><td style="">Vejo as lojas, vejo os passeios, vejo os carros que passam,</td></tr><tr><td style="">Vejo os entes vivos vestidos que se cruzam,</td></tr><tr><td style="">Vejo os c&atilde;es que tamb&eacute;m existem,</td></tr><tr><td style="">E tudo isto me pesa como uma condena&ccedil;&atilde;o ao degredo,</td></tr><tr><td style="">E tudo isto &eacute; estrangeiro, como tudo.) </td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Vivi, estudei, amei, e at&eacute; cri,</td></tr><tr><td style="">E hoje n&atilde;o h&aacute; mendigo que eu n&atilde;o inveje s&oacute; por n&atilde;o ser eu.</td></tr><tr><td style="">Olho a cada um os andrajos e as chagas e a mentira,</td></tr><tr><td style="">E penso: talvez nunca vivesses nem estudasses nem amasses nem cresses</td></tr><tr><td style="">(Porque &eacute; poss&iacute;vel fazer a realidade de tudo isso sem fazer nada disso);</td></tr><tr><td style="">Talvez tenhas existido apenas, como um lagarto a quem cortam o rabo</td></tr><tr><td style="">E que &eacute; rabo para aqu&eacute;m do lagarto remexidamente.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Fiz de mim o que n&atilde;o soube,</td></tr><tr><td style="">E o que podia fazer de mim n&atilde;o o fiz.</td></tr><tr><td style="">O domin&oacute; que vesti era errado. Conheceram-me logo por quem n&atilde;o era e n&atilde;o desmenti, e perdi-me.</td></tr><tr><td style="">Quando quis tirar a m&aacute;scara,</td></tr><tr><td style="">Estava pegada &agrave; cara.</td></tr><tr><td style="">Quando a tirei e me vi ao espelho,</td></tr><tr><td style="">J&aacute; tinha envelhecido.</td></tr><tr><td style="">Estava b&ecirc;bado, j&aacute; n&atilde;o sabia vestir o domin&oacute; que n&atilde;o tinha tirado.</td></tr><tr><td style="">Deitei fora a m&aacute;scara e dormi no vesti&aacute;rio</td></tr><tr><td style="">Como um c&atilde;o tolerado pela ger&ecirc;ncia</td></tr><tr><td style="">Por ser inofensivo</td></tr><tr><td style="">E vou escrever esta hist&oacute;ria para provar que sou sublime.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Ess&ecirc;ncia musical dos meus versos in&uacute;teis,</td></tr><tr><td style="">Quem me dera encontrar-te como coisa que eu fizesse,</td></tr><tr><td style="">E n&atilde;o ficasse sempre defronte da Tabacaria de defronte,</td></tr><tr><td style="">Calcando aos p&eacute;s a consci&ecirc;ncia de estar existindo, Como um tapete em que um b&ecirc;bado trope&ccedil;a</td></tr><tr><td style="">Ou um capacho que os ciganos roubaram e n&atilde;o valia nada.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Mas o dono da Tabacaria chegou &agrave; porta e ficou &agrave; porta.</td></tr><tr><td style="">Olho-o com o desconforto da cabe&ccedil;a mal voltada</td></tr><tr><td style="">E com o desconforto da alma mal-entendendo.</td></tr><tr><td style="">Ele morrer&aacute; e eu morrerei.</td></tr><tr><td style="">Ele deixar&aacute; a tabuleta, e eu deixarei versos.</td></tr><tr><td style="">A certa altura morrer&aacute; a tabuleta tamb&eacute;m, e os versos tamb&eacute;m.</td></tr><tr><td style="">Depois de certa altura morrer&aacute; a rua onde esteve a tabuleta,</td></tr><tr><td style="">E a l&iacute;ngua em que foram escritos os versos.</td></tr><tr><td style="">Morrer&aacute; depois o planeta girante em que tudo isto se deu.</td></tr><tr><td style="">Em outros sat&eacute;lites de outros sistemas qualquer coisa como gente</td></tr><tr><td style="">Continuar&aacute; fazendo coisas como versos e vivendo por baixo de coisas como tabuletas,</td></tr><tr><td style="">Sempre uma coisa defronte da outra,</td></tr><tr><td style="">Sempre uma coisa t&atilde;o in&uacute;til como a outra, </td></tr><tr><td style="">Sempre o imposs&iacute;vel t&atilde;o est&uacute;pido como o real,</td></tr><tr><td style="">Sempre o mist&eacute;rio do fundo t&atilde;o certo como o sono de mist&eacute;rio da superf&iacute;cie,</td></tr><tr><td style="">Sempre isto ou sempre outra coisa ou nem uma coisa nem outra.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Mas um homem entrou na Tabacaria (para comprar tabaco?),</td></tr><tr><td style="">E a realidade plaus&iacute;vel cai de repente em cima de mim.</td></tr><tr><td style="">Semiergo-me en&eacute;rgico, convencido, humano,</td></tr><tr><td style="">E vou tencionar escrever estes versos em que digo o contr&aacute;rio.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Acendo um cigarro ao pensar em escrev&ecirc;-los</td></tr><tr><td style="">E saboreio no cigarro a liberta&ccedil;&atilde;o de todos os pensamentos.</td></tr><tr><td style="">Sigo o fumo como uma rota pr&oacute;pria, </td></tr><tr><td style="">E gozo, num momento sensitivo e competente,</td></tr><tr><td style="">A liberta&ccedil;&atilde;o de todas as especula&ccedil;&otilde;es</td></tr><tr><td style="">E a consci&ecirc;ncia de que a metaf&iacute;sica &eacute; uma consequ&ecirc;ncia de estar mal disposto.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">Depois deito-me para tr&aacute;s na cadeira</td></tr><tr><td style="">E continuo fumando.</td></tr><tr><td style="">Enquanto o Destino mo conceder, continuarei fumando.</td></tr><tr><td style="">&nbsp;</td></tr><tr><td style="">(Se eu casasse com a filha da minha lavadeira  </td></tr><tr><td style="">Talvez fosse feliz.)</td></tr><tr><td style="">Visto isto, levanto-me da cadeira. Vou &agrave; janela.</td></tr><tr><td style="">O homem saiu da Tabacaria (metendo troco na algibeira das cal&ccedil;as?).</td></tr><tr><td style="">Ah, conhe&ccedil;o-o: &eacute; o Esteves sem metaf&iacute;sica.</td></tr><tr><td style="">(O dono da Tabacaria chegou &agrave; porta.)</td></tr><tr><td style="">Como por um instinto divino o Esteves voltou-se e viu-me.</td></tr><tr><td style="">Acenou-me adeus gritei-lhe Adeus &oacute; Esteves!, e o universo</td></tr><tr><td style="">Reconstruiu-se-me sem ideal nem esperan&ccedil;a, e o dono da Tabacaria sorriu.</td></tr></tbody></table></div></div></blockquote></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="manual.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="acknowledge.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Jalopy User Manual&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Acknowledgements</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..41bfd8a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;A.&nbsp;Library Dependencies</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="plugin-netbeans-license.html" title="11.3.&nbsp;License"><link rel="next" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;A.&nbsp;Library Dependencies</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-netbeans-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-bsd.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="dependencies"></a>Appendix&nbsp;A.&nbsp;Library Dependencies</h2></div></div><div></div></div><p>
+Depending on the distribution, Jalopy depends on some or all of the following
+freely available libraries:
+</p><div class="table"><a name="tab-library-dependencies"></a><p class="title"><b>Table&nbsp;A.1.&nbsp;Library dependencies</b></p><table summary="Library dependencies" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr><td style="">Name:</td><td style="">AElfred XML Parser 1.2</td></tr><tr><td style="">Author:</td><td style="">David Brownell, Michael H. Kay, Microstar Software Ltd.</td></tr><tr><td style="">License:</td><td style=""><a href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991">GNU General Public License</a></td></tr><tr><td style="">Info:</td><td style="">The parser is taken from the Saxon 6.5.2 release.</td></tr><tr><td style="">URL:</td><td style=""><a href="http://sf.net/projects/saxon/" target="_top">http://sf.net/projects/saxon/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">ANTLR Parser Generator 2.7.2a2</td></tr><tr><td style="">Author:</td><td style="">jGuru.com (MageLang Institute), project lead by Terence Parr</td></tr><tr><td style="">License:</td><td style=""><a href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS">Custom, Public Domain</a></td></tr><tr><td style="" valign="top">Info:</td><td style="">Contains some changes and fixes to make it work with Jalopy, re-packaged
+to avoid classpath clashes.
+</td></tr><tr><td style="">URL:</td><td style=""><a href="http://www.antlr.org/" target="_top">http://www.antlr.org/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">GNU getopt Java port 1.0.9</td></tr><tr><td style="">Author:</td><td style="">Aaron M. Renn</td></tr><tr><td style="">License:</td><td style=""><a href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991">GNU General Public License</a></td></tr><tr><td style="">URL:</td><td style=""><a href="http://www.urbanophile.com/~arenn/hacking/download.html" target="_top">http://www.urbanophile.com/~arenn/hacking/download.html</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">JAXP Java API for XML Processing 1.2</td></tr><tr><td style="">Author:</td><td style="">Sun Microsystems, Inc.</td></tr><tr><td style="">License:</td><td style=""><a href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1">Apache Software License</a></td></tr><tr><td style="">URL:</td><td style=""><a href="http://java.sun.com/xml/" target="_top">http://java.sun.com/xml/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">JDOM XML API 1.0 Beta 8</td></tr><tr><td style="">Author:</td><td style="">JDOM Group, lead by Jason Hunter and Brett McLaughlin</td></tr><tr><td style="">License:</td><td style="">BSD/Apache style</td></tr><tr><td style="">URL:</td><td style=""><a href="http://www.jdom.org/" target="_top">http://www.jdom.org/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">log4j logging toolkit 1.2.6</td></tr><tr><td style="">Author:</td><td style="">Apache Software Foundation</td></tr><tr><td style="">License:</td><td style=""><a href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1">Apache Software License</a></td></tr><tr><td style="" valign="top">Info:</td><td style="">Jalopy specifically needs 1.2.6 or above as I use an accessor that was
+only introduced with 1.2.6</td></tr><tr><td style="">URL:</td><td style=""><a href="http://jakarta.apache.org/log4j/" target="_top">http://jakarta.apache.org/log4j/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">Moe Editor 1.2.0</td></tr><tr><td style="">Author:</td><td style="">BlueJ Group at Monash University, Slava Pestov</td></tr><tr><td style="">License:</td><td style="">Public Domain</td></tr><tr><td style="" valign="top">Info:</td><td style="">Jalopy incorporates a stripped down version of the syntax package included in the
+Moe sources
+</td></tr><tr><td style="">URL:</td><td style=""><a href="http://www.bluej.org/" target="_top">http://www.bluej.org/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">Oro Regular Expressions 2.0.6</td></tr><tr><td style="">Author:</td><td style="">Apache Software Foundation</td></tr><tr><td style="">License:</td><td style=""><a href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1">Apache Software License</a></td></tr><tr><td style="">URL:</td><td style=""><a href="http://jakarta.apache.org/oro/" target="_top">http://jakarta.apache.org/oro/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr><tr><td style="">Name:</td><td style="">SAX Simple API for XML 2.0.1 </td></tr><tr><td style="">Author:</td><td style="">David Megginson, David Brownell</td></tr><tr><td style="">License:</td><td style="">Public Domain</td></tr><tr><td style="">URL:</td><td style=""><a href="http://www.saxproject.org/" target="_top">http://www.saxproject.org/</a></td></tr><tr><td style="">&nbsp;</td><td style="">&nbsp;</td></tr></tbody></table></div><p></p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-netbeans-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="license-bsd.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;B.&nbsp;The Jalopy BSD License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..59a0c46 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Documentation</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                        <a href="./history.html" class="navlink2">History</a> |
+                        <a href="./manual.html" class="navlink2">Manual</a> |
+                        <a href="./faq.html" class="navlink2">FAQ</a> |
+                        <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="documentation"></a>Documentation</h2></div></div><div></div></div><p>
+Jalopy comes with a complete and (hopefully) useful manual. It is mostly driven by
+example as I find this the simplest approach to explain the myriad of switches.
+</p><p>
+Note that the documentation is a work-in-progress. It could definitely benefit 
+from your feedback. I'm no native speaker and providing good documentation is 
+the hardest part for me regarding this project. All remarks, corrections, additions... are
+highly welcome.
+</p><p>
+Either use the navigation bar at the top of this page or follow this link to
+access the user manual: <a href="./manual.html" target="_top">http://jalopy.sf.net/manual.html</a>
+</p></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..98ca93d 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Downloads</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="downloads"></a>Downloads</h2></div></div><div></div></div><p>
+Download your copy of Jalopy today!
+</p><p>
+Jalopy comes in several flavors. End users most notably want to choose
+between one of the available Plug-in bundles. Each bundle provides the integration
+with exactly one application. Note that starting with 1.0b6 only the Console Plug-in
+provides command line capabilities!
+</p><p>
+Read the <a href="./history.html" target="_top">change history</a> for up-to-date
+information about the changes in the latest release.
+</p><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugins"></a>Plug-ins</h2></div></div><div></div></div><div class="informaltable"><table cellspacing="0" cellpadding="2" width="100%" border="0" style="border-collapse: collapse;"><colgroup><col><col><col><col></colgroup><thead><tr><th style="">Packages</th><th style="">Size</th><th style="">Date</th><th style="">Description</th></tr></thead><tbody><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-ant-0.6.2.zip" target="_top">Ant &gt;= 1.4 (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://jakarta.apache.org/ant/" target="_top">Ant</a> task, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-console-1.0.4.zip" target="_top">Console (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top">Command line interface, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-eclipse-0.2.7.zip" target="_top">Eclipse &gt;= 2.0 (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://www.eclipse.org/" target="_top">Eclipse</a> integration, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-jbuilder-0.7.7.zip" target="_top">JBuilder &gt;= 5.0 (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://www.borland.com/jbuilder/" target="_top">JBuilder</a> integration, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-jdeveloper-1.1.4.zip" target="_top">JDeveloper 9i (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://otn.oracle.com/products/jdev/" target="_top">JDeveloper</a> integration, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-jedit-0.3.7.zip" target="_top">jEdit &gt;= 4.1pre1 (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://www.jedit.org/" target="_top">jEdit</a> integration, contains Jalopy 1.0b11</td></tr><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-netbeans-0.3.5.zip" target="_top">NetBeans &gt;= 3.3 (.zip), Sun ONE Studio 4
+</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top"><a href="http://www.netbeans.org/" target="_top">NetBeans</a>/<a href="http://wwws.sun.com/software/sundev/jde/index.html" target="_top">Sun ONE Studio</a> integration, contains Jalopy 1.0b11</td></tr></tbody></table></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="source"></a>Sources</h2></div></div><div></div></div><div class="informaltable"><table cellspacing="0" cellpadding="2" border="0" style="border-collapse: collapse;"><colgroup><col><col><col><col></colgroup><thead><tr><th style="">Packages</th><th style="">Size</th><th style="">Date</th><th style="">Description</th></tr></thead><tbody><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-1.0b11.src.tar.gz" target="_top">Jalopy 1.0b11 (.src.tar.gz)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top">Contains the complete Jalopy 1.0b11 sources (core runtime + all Plug-ins)</td></tr></tbody></table></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="core"></a>
+Jalopy 1.0
+</h2></div></div><div></div></div><div class="informaltable"><table cellspacing="0" cellpadding="2" width="100%" border="0" style="border-collapse: collapse;"><colgroup><col><col><col><col></colgroup><thead><tr><th style="">Packages</th><th style="">Size</th><th style="">Date</th><th style="">Description</th></tr></thead><tbody><tr valign="top"><td style="" valign="top"><a href="http://prdownloads.sourceforge.net/jalopy/jalopy-1.0b11.zip" target="_top">Jalopy 1.0b11 (.zip)</a></td><td style="" align="center" valign="top">??? KB</td><td style="" align="center" valign="top">06/08/2004</td><td style="" valign="top">Jalopy core runtime, for users who want to integrate Jalopy into their own applications</td></tr></tbody></table></div></div><p>
+Prior versions can be obtained through the SourceForge file release area:
+<a href="http://sourceforge.net/project/showfiles.php?group_id=45216" target="_top">http://sourceforge.net/project/showfiles.php?group_id=45216</a>
+</p></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..0448dcc 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.8.&nbsp;Environment</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="imports.html" title="4.3.7.&nbsp;Imports"><link rel="next" href="javadoc.html" title="4.3.9.&nbsp;Javadoc"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="environment.html#environment-user" title="4.3.8.1.&nbsp;User environment variables"><link rel="subsection" href="environment.html#environment-system" title="4.3.8.2.&nbsp;System environment variables"><link rel="subsection" href="environment.html#environment-local" title="4.3.8.3.&nbsp;Local environment variables"><link rel="subsection" href="environment.html#environment-usage" title="4.3.8.4.&nbsp;Usage">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.8.&nbsp;Environment</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="imports.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="javadoc.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="environment"></a>4.3.8.&nbsp;Environment</h3></div></div><div></div></div><a class="indexterm" name="d0e4252"></a><a class="indexterm" name="d0e4257"></a><a class="indexterm" name="d0e4262"></a><a class="indexterm" name="d0e4265"></a><a class="indexterm" name="d0e4268"></a><p>
+Lets you specify/view environment variables. Environment variables can be used
+in headers, footers and Javadoc templates to form variable expressions that will
+be resolved during printing. I call this process <span class="emphasis"><em>variable interpolation</em></span>.
+</p><p>
+Environment variables are simple key/value pairs. Valid keys take the form
+<tt class="literal">([a-zA-Z_][a-zA-Z0-9_.])+</tt> and are case-sensitive. Values can be
+freely choosen.
+</p><div class="example"><a name="environment-variable-ex"></a><p class="title"><b>Example&nbsp;4.142.&nbsp;Sample environment variables</b></p><div class="variablelist"><dl><dt></dt><dd>
+author = &lt;a href="http://jalopy.sf.net/contact.html"&gt;Marco Hunsicker&lt;/a&gt;
+</dd><dt></dt><dd>
+project = Jalopy Java Source Code Formatter
+</dd></dl></div></div><p></p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="environment-user"></a>4.3.8.1.&nbsp;User environment variables</h4></div></div><div></div></div><p>
+Lets you specify you're user specific environment variables. Use the
+<span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span> buttons to
+add or remove items to and from the list.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="environment-system"></a>4.3.8.2.&nbsp;System environment variables</h4></div></div><div></div></div><p>
+All system environment variables are automatically available as well but
+cannot be changed from within Jalopy.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="environment-local"></a>4.3.8.3.&nbsp;Local environment variables</h4></div></div><div></div></div><p>Additionaly, Jalopy provides some local variables that are automatically set
+depending on the execution context.</p><p>
+The current list of valid local variables reads as follows:
+</p><div class="table"><a name="tab-environment-local"></a><p class="title"><b>Table&nbsp;4.1.&nbsp;Local environment variables</b></p><table summary="Local environment variables" cellspacing="0" cellpadding="3" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr><td style="">file</td><td style="">The absolute path of the currently processed Java file (e.g. <tt class="filename">/usr/projects/test/MyFile.java</tt>)</td></tr><tr><td style="">fileName</td><td style="">The name of the currently processed Java file (e.g. <tt class="filename">MyFile.java</tt>)</td></tr><tr><td style="">fileFormat</td><td style="">A string represention of the file format that will be used to write a file (e.g. UNIX or DOS)</td></tr><tr><td style="">package</td><td style="">The package name of the currently processed Java file (e.g. com.foo.mypackage)</td></tr><tr><td style="">convention</td><td style="">The name of the currently active code convention (as specified in the settings)</td></tr><tr><td style="">tabSize</td><td style="">The current indentation setting (as specified in the settings)</td></tr><tr><td style="">objectType</td><td style="">Only applies to Javadoc templates: Holds the type name of the class for a constructor.</td></tr><tr><td style="">paramType</td><td style="">Only applies to Javadoc templates: Holds the type name of a parameter.</td></tr><tr><td style="">exceptionType</td><td style="">Only applies to Javadoc templates: Holds the type name of a throws clause.</td></tr></tbody></table></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="environment-usage"></a>4.3.8.4.&nbsp;Usage</h4></div></div><div></div></div><p>
+Once defined, variables can then be enclosed with the dollar sign to form variable expressions.
+Variable expressions thus take the form <tt class="literal">$([a-zA-Z_][a-zA-Z0-9_.]+)$</tt>.
+</p><p>
+During printing these expressions will be interpolated and
+the value of the variable inserted into the output file.
+</p><div class="example"><a name="ex-environment-header-before"></a><p class="title"><b>Example&nbsp;4.143.&nbsp;Header template with environment variable expressions</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+//==============================================================================
+// file :       $fileName$
+// project:     $project$
+//
+// last change: date:       $Date$
+//              by:         $Author$
+//              revision:   $Revision$
+//------------------------------------------------------------------------------
+// copyright:   BSJT Software License (see class documentation)
+//==============================================================================
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-environment-header-after"></a><p class="title"><b>Example&nbsp;4.144.&nbsp;Header after interpolation</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+//==============================================================================
+// file :       Byte.java
+// project:     bsjt-rt
+//
+// last change: date:       $Date$
+//              by:         $Author$
+//              revision:   $Revision$
+//------------------------------------------------------------------------------
+// copyright:   BSJT Software License (see class documentation)
+//==============================================================================
+</pre></td></tr></table></div><p>
+As you see with the above example, if a variable is not defined, Jalopy won't
+touch the expression and simply preserve the original content. This way Jalopy
+works nicely with other source code tools and SCM products.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="imports.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="javadoc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.7.&nbsp;Imports&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.9.&nbsp;Javadoc</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..361f0a6 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - FAQ</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                        <a href="./history.html" class="navlink2">History</a> |
+                        <a href="./manual.html" class="navlink2">Manual</a> |
+                        <a href="./faq.html" class="navlink2">FAQ</a> |
+                        <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div></div><div></div></div><div class="qandaset"><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="d21e76"></a><a name="report-bugs"></a><b>Q:</b></td><td align="left" valign="top"><p>
+How do I report a bug I have found in Jalopy?
+</p></td></tr><tr class="answer"><td align="left" valign="top"><b>A:</b></td><td align="left" valign="top"><p>
+To be as helpful as possible to the Jalopy developer team and other users, you should use
+the <a href="http://sf.net/tracker/?group_id=45216&amp;atid=442212" target="_top">
+bug tracker database</a> that the Jalopy project maintains on the
+<a href="http://sf.net/" target="_top">SourceForge web site</a>. You do need to be a SourceForge
+member to post a bug report.
+</p><p>
+Before posting a bug report, spend a few moments searching the bug database to see if a
+similar report has already been made. The bug tracker has a search facility that will let
+you search for bug reports using a variety of criteria. If you find a similar bug report,
+and you have additional information to contribute, post a comment to the report. Only if
+you do not find a similar bug report, submit a new one.
+</p></td></tr><tr class="question"><td align="left" valign="top"><a name="d21e91"></a><a name="bug-report"></a><b>Q:</b></td><td align="left" valign="top"><p>
+What information should I include in a bug report?
+</p></td></tr><tr class="answer"><td align="left" valign="top"><b>A:</b></td><td align="left" valign="top"><p>
+The web form in the bug tracker report provides several fields for
+submitting information. If you are unsure about a particular
+item, leave it at the default setting provided in the form.
+</p><p>
+The more important fields are &#8220;<span class="quote">Category</span>&#8221;,
+&#8220;<span class="quote">Summary</span>&#8221; and the &#8220;<span class="quote">Initial comment</span>&#8221;.
+</p><p>
+When you write your initial comment describing the bug, you
+should specify the versions of Jalopy, the Plug-in environment, the Java platform and
+operating system you are using.
+</p><p>
+Be as specific as possible. If you encounter stack traces, attach them. If you have
+problems formatting a specific file, locate the cause of the error and attach
+the code section as a text file. Also attach your code convention as many errors only
+occur with a certain settings combination.
+</p><p>
+A more typical example should look like:
+</p><div class="informalexample"><a name="ex-bug-report"></a><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+I newly installed jalopy-1.0b9 on Windows NT with German locales, Sun JDK 1.3.1_05.
+I upgraded property file from jalopy-1.0b7 via Import/Export.
+
+When starting the jalopy settings dialog, I always have problems
+when I am on the "Sorting" panel. No entries are shown. Maybe
+this is a similar problem.
+
+I tried with different files. Always the same result.
+
+Using the Ant task (0.3.3 with Ant 1.4.1), I get a stack trace as attached. I attached
+my code convention also.
+</pre></td></tr></table></div><p>
+The attached stack trace could read as follows:
+</p><div class="informalexample"><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+[jalopy] Jalopy Java Source Code Formatter 1.0b9
+[jalopy] Format 1 source file
+[jalopy] X:\beans\booking\BookingService.java:0:0:
+Parse
+[jalopy] X:\beans\booking\BookingService.java:0:0:parsing took 170
+[jalopy] X:\beans\booking\BookingService.java:0:0:transform
+[jalopy] X:\beans\booking\BookingService.java:0:0:
+java.lang.NullPointerException
+[jalopy] java.lang.NullPointerException
+at de.hunsicker.jalopy.lang.Transformation.addSiblings(Transformation.java:167)
+at de.hunsicker.jalopy.lang.Transformation.sortDeclarations(Transformation.java:534)
+at de.hunsicker.jalopy.lang.Transformation.sort(Transformation.java:104)
+at de.hunsicker.jalopy.lang.Transformation.apply(Transformation.java:64)
+at de.hunsicker.jalopy.lang.JavaRecognizer.transform(JavaRecognizer.java:451)
+at de.hunsicker.jalopy.lang.JavaRecognizer.getParseTree(Java Recognizer.java:173)
+</pre></td></tr></table></div><p>
+The given information made it quite obvious that the auto-conversion of the code
+convention format from 1.0b7 to 1.0b9 failed for some reason.
+</p><p>
+Looking further at the supplied code convention revealed that the value of the sorting
+key was invalid and the actual cause was easy to spot.
+</p></td></tr></tbody></table></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..75188d5 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Feature list</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                        <a href="./history.html" class="navlink2">History</a> |
+                        <a href="./manual.html" class="navlink2">Manual</a> |
+                        <a href="./faq.html" class="navlink2">FAQ</a> |
+                        <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="featurelist"></a>Feature list</h2></div></div><div></div></div><div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+distributed settings support - share one code convention across multiple machines/platforms
+</li><li style="list-style-type: square">
+easy switching between several code conventions
+</li><li style="list-style-type: square">
+several pre-configured brace styles (C, Sun, GNU), but fully user-configurable
+</li><li style="list-style-type: square">
+auto-insertion/removal of obsolete braces
+</li><li style="list-style-type: square">
+special empty braces handling
+</li><li style="list-style-type: square">
+wide range of whitespace options for method declarations/calls, brackets, parentheses, operators, delimeters...
+</li><li style="list-style-type: square">
+prepending of leading whitespace before every line
+</li><li style="list-style-type: square">
+powerful indentation/alignment capabilities
+</li><li style="list-style-type: square">
+configurable line wrapping
+</li><li style="list-style-type: square">
+controlable amount of blank lines between certain sections, blocks, statements...
+</li><li style="list-style-type: square">
+comment removal for all sorts of comments
+</li><li style="list-style-type: square">
+special comments to prohibit formatting for certain pieces of code
+(uses the Jindent syntax to retain backward compatibility)
+</li><li style="list-style-type: square">
+auto-insertion of missing Javadoc comments (selectively configurable for the
+different access levels) with variable interpolation
+</li><li style="list-style-type: square">
+auto-removal/insertion/correction of obsolete/missing/wrong Javadoc standard tags
+</li><li style="list-style-type: square">
+auto-insertion of parentheses around expressions to make operator precedence obvious
+</li><li style="list-style-type: square">
+auto-insertion of a serial version UID for serializable classes
+</li><li style="list-style-type: square">
+sorting of class/interface/variable/constructor/method declarations
+</li><li style="list-style-type: square">
+sorting of access modifiers
+</li><li style="list-style-type: square">
+insertion of separation comments between class/interface/variable/constructor/method declarations
+</li><li style="list-style-type: square">
+insertion of custom header/footer templates at the begin/end of every file (with variable interpolation)
+</li><li style="list-style-type: square">
+sorting/grouping of import declarations
+</li><li style="list-style-type: square">
+import optimization: expansion of on-demand import declarations to several
+single-type declarations (and vice versa). As of today only implemented for
+the Ant and JBuilder Plug-in
+</li><li style="list-style-type: square">
+configurable message output
+</li><li style="list-style-type: square">
+numbered backups (1-30)
+</li><li style="list-style-type: square">
+multi-processor support
+</li><li style="list-style-type: square">
+client <a href="./api/index.html" target="_top">API</a> to make integration with other tools easy
+</li><li style="list-style-type: square">
+graphical application to customize the settings (with live-preview)
+</li><li style="list-style-type: square">
+powerful command line interface with regular expression filtering (<a href="./plugins.html" target="_top">Console Plug-in</a>)
+</li><li style="list-style-type: square">
+several <a href="./plugins.html" target="_top">Plug-ins</a> to integrate with common Java applications (current set includes
+<a href="./plugin-ant.html" target="_top">Ant</a>,
+<a href="./plugin-eclipse.html" target="_top">Eclipse</a>,
+<a href="./plugin-jbuilder.html" target="_top">JBuilder</a>,
+<a href="./plugin-jdev.html" target="_top">JDeveloper</a>,
+<a href="./plugin-jedit.html" target="_top">jEdit</a> and
+<a href="./plugin-netbeans.html" target="_top">NetBeans</a>/Sun ONE Studio)
+</li><li style="list-style-type: square">
+"<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>"
+ software, released under a <a href="./license-bsd.html" target="_top">BSD License</a></li></ul></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..322a958 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.11.&nbsp;Footer</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="header.html" title="4.3.10.&nbsp;Header"><link rel="next" href="sorting.html" title="4.3.12.&nbsp;Sorting"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.11.&nbsp;Footer</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="header.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="sorting.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="footer"></a>4.3.11.&nbsp;Footer</h3></div></div><div></div></div><a class="indexterm" name="d0e4834"></a><p>
+Controls the printing of footers. Refer to <a href="header.html" title="4.3.10.&nbsp;Header">Section&nbsp;4.3.10, &#8220;Header&#8221;</a> for an
+explanation of the different options.
+</p><p>
+Note that Jalopy always prints one trailing empty line after the footer.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="header.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="sorting.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.10.&nbsp;Header&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.12.&nbsp;Sorting</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..0e5e8ef 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.10.&nbsp;Header</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="javadoc.html" title="4.3.9.&nbsp;Javadoc"><link rel="next" href="footer.html" title="4.3.11.&nbsp;Footer"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="header.html#header-options" title="4.3.10.1.&nbsp;&#xA;Options&#xA;"><link rel="subsection" href="header.html#d0e4821" title="4.3.10.2.&nbsp;&#xA;Text&#xA;">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.10.&nbsp;Header</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="javadoc.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="footer.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="header"></a>4.3.10.&nbsp;Header</h3></div></div><div></div></div><p>
+Controls the printing of headers. It is always a good idea (and often a
+recommendation) to include a copyright notice at the top of every source file
+for a given project.
+</p><a class="indexterm" name="d0e4734"></a><a class="indexterm" name="d0e4737"></a><div class="example"><a name="ex-header-template"></a><p class="title"><b>Example&nbsp;4.148.&nbsp;Typical header template</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+/*
+ *                 Sun Public License Notice
+ *
+ * The contents of this file are subject to the Sun Public License
+ * Version 1.0 (the "License"). You may not use this file except in
+ * compliance with the License. A copy of the License is available at
+ * http://www.sun.com/
+ *
+ * The Original Code is NetBeans. The Initial Developer of the Original
+ * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun
+ * Microsystems, Inc. All Rights Reserved.
+ */
+</pre></td></tr></table></div><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Headers and Javadoc comments</h3><p>
+Be aware that Jalopy currently does not treat the header comments any special.
+If you're going to use a Javadoc comment (see <a href="javadoc.html" title="4.3.9.&nbsp;Javadoc">Section&nbsp;4.3.9, &#8220;Javadoc&#8221;</a>) for
+your header and have the Javadoc parsing enabled, you will see your header
+reformatted. Therefore, you should only use multi-line comments
+(like in the example above).
+</p></div><p></p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="header-options"></a>4.3.10.1.&nbsp;
+Options
+</h4></div></div><div></div></div><p>
+Lets you control the different header options.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="header-general"></a>4.3.10.1.1.&nbsp;General</h5></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>
+Use Header
+</p><p>
+Enables or disables the insertion of a header template at the top of every
+processed source file.
+</p></li><li><p><a name="header-smart-mode"></a>
+Smart Mode
+</p><a class="indexterm" name="d0e4772"></a><p>
+Lets you specify the number of single-line comments before the first node
+(either a package/import statement or a class/interface declaration) that
+should be recognized as part of a header and therefore removed. A size
+equal to zero, means <span class="emphasis"><em>Smart Mode</em></span> will be disabled.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="header-delete"></a>4.3.10.1.2.&nbsp;Delete Headers</h5></div></div><div></div></div><p>
+To avoid header duplication, you have to specify at least one identify key
+that can be used to uniquely recognize your header template. That way an
+existing header can be removed before a new one is inserted.
+</p><p>
+A good key for the template mentioned above would be
+<i class="firstterm">Sun Public License Notice</i>.
+Most typically this will be your company's name.
+</p><p>
+You can specify several keys to make it easy to switch between headers. Specify
+both a key for the old header that is to be removed and for your new header that
+should be inserted. This way, you are sure that even new additions that happens
+to contain the old header (maybe checked out from some SCM) are
+treated correctly.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Add...
+</p><p>
+Adds a new identify key to the list of keys.
+</p></li><li><p>
+Remove
+</p><p>
+Removes the currently selected key from the list.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="header-blank-lines"></a>4.3.10.1.3.&nbsp;Blank lines</h5></div></div><div></div></div><p>
+To separate the header from the rest of the source code, you may want to
+specify the blank lines before and after the header.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Before
+</p><p>
+Number of blank lines to insert before the header template.
+</p></li><li><p>
+After
+</p><p>
+Number of blank lines to insert after the header template.
+</p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4821"></a>4.3.10.2.&nbsp;
+Text
+</h4></div></div><div></div></div><p>
+Insert your header template here.
+</p><p>
+You can use variable expressions throughout the header text. Read
+<a href="environment.html" title="4.3.8.&nbsp;Environment">Section&nbsp;4.3.8, &#8220;Environment&#8221;</a> for more information about this feature.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="javadoc.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="footer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.9.&nbsp;Javadoc&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.11.&nbsp;Footer</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..089177c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Change history</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                        <a href="./history.html" class="navlink2">History</a> |
+                        <a href="./manual.html" class="navlink2">Manual</a> |
+                        <a href="./faq.html" class="navlink2">FAQ</a> |
+                        <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e75"></a>1.0 Beta 10 (2002-11-14)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Work started to provide a FAQ. There is currently only one topic: How one should submit a
+bug report
+</li></ul></div><p></p></li><li>
+Bug fixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Newlines after case statements were not printed (as always: only with Sun brace style)
+Reported by Sebastian Eigner
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=638369&amp;group_id=45216" target="_top">#638369</a>)
+</li><li style="list-style-type: square">
+In certain cases the indentation after printing assignments was not correct. Reported by
+Grzegorz Pilarczyk
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=638279&amp;group_id=45216" target="_top">#638279</a>)
+</li><li style="list-style-type: square">
+Array types were not correctly printed when they contained more complicated expressions.
+Reported by Benni Mas
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=638355&amp;group_id=45216" target="_top">#638355</a>)
+</li><li style="list-style-type: square">
+The settings format was not correctly updated from 1.0b7 to 1.0b8. Reported by
+Marc Gerstmair
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=637864&amp;group_id=45216" target="_top">#637864</a>)
+</li><li style="list-style-type: square">
+Code conventions were exported with platform specific encodings which could easily cause
+harm. Additionally no XML declaration was printed. Now <tt class="literal">UTF-8</tt> is used
+and the declaration printed. Reported by Tim Moore
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=637262&amp;group_id=45216" target="_top">#637262</a>)
+</li><li style="list-style-type: square">
+The wrapper scripts only worked when the full pathname to the script-files were used.
+Reported and fixed by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=637915&amp;group_id=45216" target="_top">#637915</a>).
+Thanks
+</li><li style="list-style-type: square">
+Blank lines before blocks without associated block statements
+(I call them <span class="emphasis"><em>freestanding blocks</em></span>) were not printed
+</li><li style="list-style-type: square">
+Additional semicolon(s) after the last import statement caused the blank lines logic to
+fail, no blank lines were printed for such a (rare) case
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+JBuilder Plug-in: the Plug-in now displays an error message if no compatible log4j version
+could be found in the classpath and shows a workaround for the problem
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e135"></a>1.0 Beta 9 (2002-11-12)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+New indentation policy. See
+<a href="./indentation.html#indentation-policy-standard" target="_top">Standard indent</a></li><li style="list-style-type: square">
+New alignment options for the <tt class="literal">operators</tt> and ternary expression. See
+<a href="./indentation.html#indentation-align-method-chains" target="_top">Align Method Call chains</a> and
+<a href="./indentation.html#indentation-align-ternary" target="_top">Align Ternary expressions</a></li><li style="list-style-type: square">
+The wrapping options has been extended. See
+<a href="./wrapping.html#wrap-left-parenthesis" target="_top">Wrap after left parenthesis</a>,
+<a href="./wrapping.html#wrap-right-parenthesis" target="_top">Wrap before right parenthesis</a>,
+<a href="./wrapping.html#wrap-after-assignment" target="_top">Wrap after assignments </a>,
+<a href="./wrapping.html#wrap-grouping-paren" target="_top">Wrap grouping parentheses</a>,
+<a href="./wrapping.html#wrap-always-extends" target="_top">Wrap after extends types when exceed</a>,
+<a href="./wrapping.html#wrap-always-implements" target="_top">Wrap after implements types when exceed</a>,
+<a href="./wrapping.html#wrap-always-throws" target="_top">Wrap after throws types when exceed</a> and
+<a href="./wrapping.html#wrap-always-param" target="_top">After parameters/expressions when exceed</a></li><li style="list-style-type: square">
+New curly brace wrapping option. See
+<a href="./printer.html#braces-different-wrapped" target="_top">Treat class/method block different if wrapped</a></li><li style="list-style-type: square">
+The output style for field Javadoc comments is now configurable. See
+<a href="./javadoc.html#javadoc-misc" target="_top">Field comments in single line</a></li></ul></div><p>
+All aforementioned features were requested, sponsored and thoroughly tested by the German
+<a href="http://www.tk-online.de/" target="_top">Techniker Krankenkasse</a>. Hurray!
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The sources have been internationalized. If you're willing to provide translations of the
+used message bundles, please <a href="./contact.html" target="_top">contact</a> me
+</li><li style="list-style-type: square">
+Jalopy now contains a simple Code Inspector that is able to inspect your sources for
+naming convention violations and possible code weaknesses. See the
+<a href="./inspector.html" target="_top">Code Inspector</a> chapter in the manual
+</li><li style="list-style-type: square">
+New history methods that uses checksums to better handle change detection for files.
+See <a href="./misc.html#misc-history" target="_top">History section</a>. Very cool feature
+contributed by Michael Callum
+</li><li style="list-style-type: square">
+Javadoc tag checking for <tt class="literal">@throws</tt> tags can now be enabled
+separately. See <a href="./javadoc.html#javadoc-correct-throws" target="_top">Correct @throws tags</a></li><li style="list-style-type: square">
+Array type brackets may now be printed after the identifier.
+See <a href="./misc.html#misc-array-brackets" target="_top">Misc section</a>.
+Requested by John Zukowski
+(<a href="http://sf.net/tracker/?func=detail&amp;aid=599239&amp;group_id=45216&amp;atid=442215" target="_top">#599239</a>)
+</li><li style="list-style-type: square">
+You can now specify whether Jalopy should insert a trailing empty line at the
+end of files in order to avoid problems with certain text formatters and processors.
+See <a href="./misc.html#misc-trailing-newline" target="_top">Misc section</a>. Note that
+Jalopy always inserts a trailing newline after EOF-comments (like footers).
+Requested by David Karr
+(<a href="http://sf.net/tracker/?func=detail&amp;aid=589696&amp;group_id=45216&amp;atid=442215" target="_top">#589696</a>)
+</li><li style="list-style-type: square">
+The order of import statement groups is now user configurable. See <a href="./imports.html" target="_top">Import section</a>.
+Requested by J&uuml;rgen Ebert
+(<a href="http://sf.net/tracker/?func=detail&amp;aid=591904&amp;group_id=45216&amp;atid=442215" target="_top">#591904</a>)
+</li><li style="list-style-type: square">
+The <i class="guilabel">Format</i> menu item now appears in the context menu of the Content
+Pane too
+</li><li style="list-style-type: square">
+Auto-correction for Javadoc <tt class="literal">@throws</tt> tags can now be
+controlled separately. See <a href="./javadoc.html#javadoc-correct-throws" target="_top">Correct <tt class="literal">@throws</tt> tags</a> for insight
+</li><li style="list-style-type: square">
+NetBeans Plug-in: the Format action is now available for Servlet nodes too
+</li><li style="list-style-type: square">
+JBuilder Plug-in: the Format item it now available in the context menu of content tab pane too
+</li><li style="list-style-type: square">
+JBuilder Plug-in: Breakpoints and Bookmarks are restored after formatting
+</li><li style="list-style-type: square">
+JDeveloper Plug-in: the Plug-in has been completely rewritten. Formatting works for
+workspaces too, the message output is displayed in a nice tree view. And the whole thing
+is now compatible with JDeveloper 9.0.3
+</li><li style="list-style-type: square">
+The core engine is now able to track positions. The IDE Plug-ins are therefore now able
+to restore the mouse pointer correctly (it will be positioned before the line with the
+node that was nearest to the last caret position)
+</li></ul></div><p></p></li><li>
+Bug fixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The cleanup of the backup directory could lead to NPE. Reported by Mike Dubman
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=617942&amp;group_id=45216" target="_top">#617942</a>)
+</li><li style="list-style-type: square">
+The output of array initializers has been improved. Reported by Kate Rhodes
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=617684&amp;group_id=45216" target="_top">#617684</a>)
+</li><li style="list-style-type: square">
+Important statements collapsing failed because of incompatible parsetree changes between 1.0b7 and 1.0b8. Reported by Mark Ralph
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=617608&amp;group_id=45216" target="_top">#617608</a>)
+</li><li style="list-style-type: square">
+Handling of Javadoc comments failed for methods/ctors returning an array type. Reported by Magnus Ihse
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=615039&amp;group_id=45216" target="_top">#615039</a>)
+</li><li style="list-style-type: square">
+The problem with wrong indentation after assignments has gone. Reported by Timo Carl
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=612049&amp;group_id=45216" target="_top">#612049</a>)
+</li><li style="list-style-type: square"><span class="emphasis"><em>Treat different</em></span> option has been corrected to work with all styles. Reported by Eric Lamontagne
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=611182&amp;group_id=45216" target="_top">#611182</a>)
+</li><li style="list-style-type: square">
+I've fixed some cases where Jalopy produced trailing whitespace on wrapping lines. There may still be others...
+Reported by Ralf Wiebicke
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=607697&amp;group_id=45216" target="_top">#607697</a>)
+</li><li style="list-style-type: square">
+The Javadoc printer failed to output HTML definition lists correctly. Reportey by
+David Cooper
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=607416&amp;group_id=45216" target="_top">#607416</a>)
+</li><li style="list-style-type: square">
+The Javadoc printer failed to output HTML defintion lists correcty. Reportey by
+David Cooper
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=607416&amp;group_id=45216" target="_top">#607416</a>)
+</li><li style="list-style-type: square">
+Array initializers inside statements were not printed correctly. Reported by
+Dirk Hoffmann
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=607303&amp;group_id=45216" target="_top">#607303</a>)
+</li><li style="list-style-type: square">
+Variable macros did (as documented) not work for names like <tt class="literal">user.name</tt>. Reported by
+Don Johnson
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=606173&amp;group_id=45216" target="_top">#606173</a>)
+</li><li style="list-style-type: square">
+Empty lines in multi-line comments produced trailing whitespace.
+Reported by Ralf Wiebicke
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=605998&amp;group_id=45216" target="_top">#605998</a>)
+</li><li style="list-style-type: square">
+Javadoc trailing comments were ignored. Jalopy will now (again) treat such cases as errors.
+Reported by Ralf Wiebicke
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=604072&amp;group_id=45216" target="_top">#604072</a>)
+</li><li style="list-style-type: square">
+Jalopy duplicated comments in some rare cases. Reported by David Cooper
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=604065&amp;group_id=45216" target="_top">#604065</a>)
+</li><li style="list-style-type: square">
+The console app failed to work on certain platforms due to classloading problems.
+Reported by Benjamin Geer
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=604038&amp;group_id=45216" target="_top">#604038</a></li><li style="list-style-type: square">
+No blank lines were kept for <tt class="literal">synchronized</tt> blocks. Reported by Kees Kuip
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=603455&amp;group_id=45216" target="_top">#603455</a></li><li style="list-style-type: square">
+Variable interpolation did not work in header or footers. Reported by Daniel Frey
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=601901&amp;group_id=45216" target="_top">#601901</a></li><li style="list-style-type: square">
+Jalopy lost trailing comments in certain cases. Reported by Shankar Unni, Steve Corwin, Ray Powell
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=601393&amp;group_id=45216" target="_top">#601393</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=602169&amp;group_id=45216" target="_top">#602169</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=603914&amp;group_id=45216" target="_top">#603914</a>)
+</li><li style="list-style-type: square">
+Jalopy failed to handle empty Javadoc Standard tags. Reported by Henrik Kj&aelig;r and Don Johnson
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=601204&amp;group_id=45216" target="_top">#601204</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=606163&amp;group_id=45216" target="_top">#606163</a>)
+</li><li style="list-style-type: square">
+JBuilder Plug-in: the Plug-in is now compatible with JBuilder 7.0. Reported by Simeon Zverinski
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=596821&amp;group_id=45216" target="_top">#596821</a>)
+</li><li style="list-style-type: square">
+The example Ant task in the manual contained a syntax error.
+Reported by Eric Larson
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=595777&amp;group_id=45216" target="_top">#595777</a>)
+</li><li style="list-style-type: square">
+With generating Javadoc comments enabled, existing
+variable/method/class-level comments were dropped if not in Javadoc style.
+Reported by John Zukowski
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=595164&amp;group_id=45216" target="_top">#595164</a>)
+</li><li style="list-style-type: square">
+Auto-insertion of braces for braceless if-else blocks did not work as expected
+(for Sun brace style). Reported by John Zukowski
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=595160&amp;group_id=45216" target="_top">#595160</a>)
+</li><li style="list-style-type: square">
+@throws tags were wrongly inserted in some cases. Reported by Jarek Sacha
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=594738&amp;group_id=45216" target="_top">#594738</a>)
+</li><li style="list-style-type: square">
+Printing of empty class/interface bodies failed, if cuddling of braces was
+enabled. Reported by Richard Tasker and Benjamin Geer
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=594076&amp;group_id=45216" target="_top">#594076</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=597080&amp;group_id=45216" target="_top">#597080</a>)
+</li><li style="list-style-type: square">
+@version tags were wrapped if max. line length exceeded, and therefore failed to
+be updated by CVS when checked in. Reported by Johnny Cass
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=592504&amp;group_id=45216" target="_top">#592504</a>)
+</li><li style="list-style-type: square">
+Jalopy used to insert two many blank lines before certain statements. Reported by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=592496&amp;group_id=45216" target="_top">#592496</a>)
+</li><li style="list-style-type: square"><tt class="filename">jalopy.sh</tt> and <tt class="filename">preferences.sh</tt> failed
+to work (under some unix flavors) because of wrong end-of-line characters.
+Actually a build/CVS problem. Reported and fixed by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=592487&amp;group_id=45216" target="_top">#592487</a>)
+</li><li style="list-style-type: square">
+Eclipse Plug-in: upon startup of the IDE <tt class="classname">org.eclipse.swt.SWTException: invalid thread access</tt>
+was thrown. Reportedy by Dirk Jacobs
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=567314&amp;group_id=45216" target="_top">#567314</a>)
+</li><li style="list-style-type: square">
+Backup files were always kept if the output target was not a file
+</li><li style="list-style-type: square">
+jEdit Plug-in: the <i class="guilabel">Format current Buffer</i> menu item was grayed out
+upon start-up if the buffer contained a non-Java file
+</li><li style="list-style-type: square">
+Console Plug-in: specifying several regular expression patterns did not work.
+Reported by Sameer Singh
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The <tt class="filename">.XML</tt> settings format has been revised. It should now be somewhat cleaner. These
+changes are transparent, the old settings format can be imported but only the new format
+will be exportet. Those who use the <tt class="filename">.XML</tt> format should re-export their settings to avoid
+the auto-transformation (and of course, there are many new switches)
+</li><li style="list-style-type: square">
+The <tt class="filename">/bin</tt> directory of the distributions have been renamed to
+<tt class="filename">/lib</tt>. For the Console and Ant Plug-ins the <tt class="filename">/bin</tt>
+now only contains the wrapper scripts and the libaries moved to <tt class="filename">/lib</tt>.
+</li><li style="list-style-type: square">
+Eclipse Plug-in: the <i class="guilabel">Format</i> label in the project view context menu
+no longer appears at the end. Suggested by Davor Cengija and Vincent Massol
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=578331&amp;group_id=45216" target="_top">#578331</a>)
+</li><li style="list-style-type: square">
+JBuilder Plug-in: the <i class="guilabel">Format</i> item in the project view context menu
+is now more context sensitive. It won't pop up for non-Java files. Additionally, when
+formatting the whole Project a confirmation message box appears
+</li><li style="list-style-type: square">
+The <tt class="literal">@todo</tt> tag is now part of the build-in tag list
+</li><li style="list-style-type: square">
+The Tab support has been rewritten. If tabs are enabled, *all* whitespace will
+be realized with tabs (not only leading whitespace as with the former
+implementation)
+</li><li style="list-style-type: square">
+Denis N. Antonioli contributed several patches for the Javadoc parser:
+<div class="itemizedlist"><ul type="circle"><li style="list-style-type: circle">
+The parser is now able to handle left curly braces that are not part of
+an In-line tag
+</li><li style="list-style-type: circle">
+Attributes must not be quoted and numeric attributes may also start with <tt class="literal">%</tt></li><li style="list-style-type: circle">
+The closing tags for &lt;dd&gt;, &lt;dl&gt;, &lt;dir&gt; are now optional
+</li></ul></div>
+Thank you!
+</li><li style="list-style-type: square">
+Parameter alignment of method or constructor declarations now works regardless
+of the indentation settings (it did not work with custom indentation in
+earlier versions)
+</li><li style="list-style-type: square">
+The preview frame no longer uses the (unmaintained) jEdit Public Domain text area but
+rather a standard <tt class="classname">JEditorPane</tt> with a highlighter dereived from
+the <a href="http://www.bluej.org/" target="_top">BlueJ</a> project (and that highlighter is
+again build upon the jEdit Public Domain syntax package). Users of prior betas may
+savely remove the file <tt class="filename">textarea-2.2.3.jar</tt> from their disks
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e523"></a>1.0 Beta 8 (2002-08-06)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Thanks to Frank Klomp from
+<a href="http://www.informatikatelier.com" target="_top">www.informatikatelier.com</a>
+a Plug-in for Oracle JDeveloper 9i is now available.
+See <a href="./plugins.html" target="_top">Plug-in section</a></li><li style="list-style-type: square">
+Jalopy now comes with a simple project manager to make switching between
+several code conventions easier.
+See <a href="./project.html" target="_top">Project section</a></li><li style="list-style-type: square">
+ConsolePlugin: new option <tt class="literal">--force</tt></li><li style="list-style-type: square">
+The line wrapping for chained method calls now works for nested calls too
+</li><li style="list-style-type: square">
+The settings dialog now comes with a live preview. Requested by Erik Dick
+(<a href="http://sf.net/tracker/?func=detail&amp;aid=563215&amp;group_id=45216&amp;atid=442215" target="_top">#563215</a>)
+</li><li style="list-style-type: square">
+Similar to Jindent, Jalopy is now able to perform variable interpolation for
+the header or footer and Javadoc comment templates.
+See <a href="./environment.html" target="_top">Environment variables</a> section.
+Requested by Erik Dick
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=563213&amp;group_id=45216" target="_top">#563213</a>)
+</li><li style="list-style-type: square">
+Similar to Jindent, you can now define custom Javadoc templates for
+fields, classes/interfaces, constructor and method comments. See
+<a href="./javadoc.html#javadoc-templates" target="_top">Javadoc Templates</a> section
+</li><li style="list-style-type: square">
+The sorting order for the Java modifiers is now configurable. See
+<a href="./sorting.html#sorting-modifier" target="_top">Sorting</a> section
+</li><li style="list-style-type: square">
+The texts for separator comments are now user configurable. See
+<a href="./separation.html#separation-comment" target="_top">Separation</a> section.
+Requested by Dirk Jacobs
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=567322&amp;group_id=45216" target="_top">#567322</a>).
+</li><li style="list-style-type: square">
+The grouping of import statements can now be disabled. See
+<a href="./imports.html#imports-grouping-depth" target="_top">Imports section</a>.
+Requested by Emil A. Lefkof
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=562475&amp;group_id=45216" target="_top">#562475</a>).
+</li><li style="list-style-type: square">
+Lowercase "<tt class="literal">l</tt>" as trailing character for literal
+longs will be automatically capitalized during printing
+</li><li style="list-style-type: square">
+The <tt class="literal">abstract</tt> modifier will be automatically removed if found
+for interface or interface method declarations (as these are implicitly
+<span class="emphasis"><em>abstract</em></span>).
+</li><li style="list-style-type: square">
+You can now specify whether Java sources should be parsed as JDK 1.4 compatible
+(the default) or if sources should be parsed without treating
+<tt class="literal">assert</tt> as a reserved keyword (i.e. JDK 1.3 compatible).
+See the <a href="./settings.html#general-compliance" target="_top">General section</a>.
+This change addresses bugs
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=565512&amp;group_id=45216" target="_top">#565512</a> and
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=576983&amp;group_id=45216" target="_top">#576983</a></li><li style="list-style-type: square">
+The header detection now provides a <span class="emphasis"><em>Smart Mode</em></span> for users
+who want to use singe-line comments for headers. If enabled, Jalopy treats the
+first <tt class="literal">n</tt> number of singe-line comments before the first
+node as part of a header and removes them.
+See the <a href="./header.html#header-smart-mode" target="_top">Header section</a></li><li style="list-style-type: square">
+The element sorting changed: Added was a new category
+<i class="guilabel">Static variables/initializers</i>
+to avoid touching the class initialization as required by the Java language
+specification ("static initializers and class variable initializers are
+executed in textual order"). This partially addresses the feature request
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=545603&amp;group_id=45216" target="_top">#545603</a> also.
+Reported by Kirk Wolf
+</li><li style="list-style-type: square">
+The import optimization feature is now available for the Ant Plug-in too. See
+the <a href="./plugin-ant-usage.html" target="_top">Ant Plug-in</a> chapter
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Setting for <i class="guilabel">Space before Brackets</i> didn't take effect
+</li><li style="list-style-type: square">
+Setting for <i class="guilabel">Space Before Brackets in Types</i> didn't take
+effect for something like <tt class="literal">new String[0]</tt></li><li style="list-style-type: square">
+jEdit Plug-in: The integration with the Gobal Options dialog doesn't suffer
+from the resizing problems anymore
+</li><li style="list-style-type: square">
+jEdit Plug-in: Jalopy directed all formatting messages always to the first view
+</li><li style="list-style-type: square">
+Read-only files don't cause exceptions anymore. Jalopy will now display a
+warning message. Reported by Andrew Barkley
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=587068&amp;group_id=45216" target="_top">#587068</a>)
+</li><li style="list-style-type: square">
+Enclosed creator constructs could lead to uncompilable code. Reported by
+Eddy Kivits
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=586450&amp;group_id=45216" target="_top">#586450</a>)
+</li><li style="list-style-type: square"><tt class="literal">do-while</tt> blocks without enclosing braces where not treated correctly.
+Reported by Marcel Toele
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=581394&amp;group_id=45216" target="_top">#581394</a>)
+</li><li style="list-style-type: square">
+The Javadoc printer missed a blank between the <tt class="literal">@link</tt> tag and
+following HTML links. Reportedy by Brian Harriger
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=581299&amp;group_id=45216" target="_top">#581299</a>)
+</li><li style="list-style-type: square">
+EOL characters were not correctly translated for multi-line, special and
+Javadoc comments. Reportedy by Olivier Mengu&eacute;
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=572130&amp;group_id=45216" target="_top">#572130</a>)
+</li><li style="list-style-type: square">
+Enabling the cuddling of empty braces lead to compilation errors if an
+trailing comment appeared before the opening brace. The cuddling is now disabled
+for such a (rare) case. Reported by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=568974&amp;group_id=45216" target="_top">#568974</a>)
+</li><li style="list-style-type: square">
+NPE during import that only appeared with certain JDKs. Reportedy by Davor Cengija
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=566205&amp;group_id=45216" target="_top">#566205</a>)
+</li><li style="list-style-type: square">
+The insertion of Javadoc comments did not work for classes/interfaces and
+fields (it was not implemented). Reported by Thomas B&ouml;rkel
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=564255&amp;group_id=45216" target="_top">#564255</a>)
+</li><li style="list-style-type: square">
+After importing settings from a distributed location, Jalopy did not use
+these settings if the host was unavailable on successive invocations (but
+rather the build-in defaults); now the imported settings are used and a
+warning message issued. Reported by Thomas B&ouml;rkel
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=563976&amp;group_id=45216" target="_top">#563976</a>)
+</li><li style="list-style-type: square">
+The Java Language Specification requires every single-line comment to be
+terminated by an end-of-line sequence, but Jalopy allowed a single-line-comment
+to be terminated by an end-of-file. Reported by Thomas B&ouml;rkel
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=563974&amp;group_id=45216" target="_top">#563974</a>)
+</li><li style="list-style-type: square">
+Ant 1.4.1 (or earlier) caused problems because of an incompatibility with the
+bundled AElfred parser. Therefore the parser (and all other 3rd party libraries)
+are no longer bundled to enable you to selectively copy the needed libs into
+the Ant <tt class="filename">/lib</tt> folder. Documentation was updated to explain
+the issue. Reported by Larry Hamel et.al.
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=563385&amp;group_id=45216" target="_top">#563385</a>)
+</li><li style="list-style-type: square">
+The Java parser failed for (strange) code like
+<tt class="literal">if (obj.getClass() == (byte.class))</tt>. Reported by Hui Lin
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562681&amp;group_id=45216" target="_top">#562681</a>)
+</li><li style="list-style-type: square"><tt class="literal">try</tt>/<tt class="literal">catch</tt> blocks were not correctly
+formatted (again only with Sun brace style). Reported by Emil A. Lefkof
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562039&amp;group_id=45216" target="_top">#562039</a>)
+</li><li style="list-style-type: square">
+Chained method calls were wrongly wrapped if part of an expression. Reported by Emil A. Lefkof
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562037&amp;group_id=45216" target="_top">#562037</a>)
+</li><li style="list-style-type: square">
+Fixed some bugs regarding (evil) Sun brace styling. Reported by
+Emil A. Lefkof, Thomas B&ouml;rkel, Larry Hamel and Christian Halstrick, Anders Johansson
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562034&amp;group_id=45216" target="_top">#562034</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=564247&amp;group_id=45216" target="_top">#564247</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=569306&amp;group_id=45216" target="_top">#569306</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=569031&amp;group_id=45216" target="_top">#569031</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=580600&amp;group_id=45216" target="_top">#580600</a>)
+</li><li style="list-style-type: square">
+The settings format was not correctly updated between 1.0b6 and 1.0b7
+causing an <tt class="classname">IllegalArgumentException</tt> if the history
+feature was disabled. Reported by Martin Spiller
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=561398&amp;group_id=45216" target="_top">#561398</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=561675&amp;group_id=45216" target="_top">#561675</a>)
+</li><li style="list-style-type: square">
+As the comment preserving/printing implementation has been rewritten, trailing
+comment support should now work in nearly all cases. At least all reported
+issues are now treated correctly. Reported by Stephane Houle, Emil A. Lefkof,
+Kees Kuip, John Wilson
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559222&amp;group_id=45216" target="_top">#559222</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=565820&amp;group_id=45216" target="_top">#565820</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562034&amp;group_id=45216" target="_top">#562034</a>,
+<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=578664&amp;group_id=45216" target="_top">#578664</a>)
+</li><li style="list-style-type: square">
+The user selected brace style did not take effect for anonymous inner classes.
+Reported by Ian Brown
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=545431&amp;group_id=45216" target="_top">#545431</a>)
+</li><li style="list-style-type: square">
+Fixed a minor GUI bug in the Javadoc panel (column headers did not show up
+using Windows L&amp;F). Reported by Thomas Sauzedde
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=544404&amp;group_id=45216" target="_top">#544404</a>)
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+JBuilder Plug-in: it now checks whether the classpath is correctly set up
+(whether all defined libraries exist) and if something seems to be broken,
+the import optimization feature is enabled to avoid errors (a dialog appears to
+inform you about the misconfiguration)
+</li><li style="list-style-type: square">
+JBuilder Plug-in: the <span><b class="guimenuitem">Jalopy Options...</b></span> menu item now
+appears in the Options group of the
+<span><b class="guimenu"><span class="accel">T</span>ools</b></span> menu.
+</li><li style="list-style-type: square">
+jEdit Plug-in: the Plug-in does not use ErrorList anymore, but rather relies
+on the MessageView Plug-in which is bundled with the distribution (as it is not
+yet available through the jEdit Plugin Central)
+</li><li style="list-style-type: square">
+The sorting logic for variable declarations now compares by access modifiers first,
+then (new!) type name and only if these two are equal by name (identifier)
+</li><li style="list-style-type: square">
+The Javadoc printer now inserts a newline after every found &lt;br&gt; tag
+(only happens if Javadoc parsing is enabled). This addresses the "Bug"
+reported by Tony Falabella (that was no bug but rather the behaviour I found
+sufficient)
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=562502&amp;group_id=45216" target="_top">#562502</a>)
+</li><li style="list-style-type: square">
+The default setting for the backup level changed, it is now set to "0"
+(no backups are kept)
+</li><li style="list-style-type: square">
+The settings dialog is no longer a modal dialog (necessary for the live preview)
+</li><li style="list-style-type: square">
+Started from the command line, the settings dialog now appears in the task
+bar (under Win32). Suggested by Knut Wannheden
+</li><li style="list-style-type: square">
+The bundled ANTLR runtime has been repackaged to avoid versioning problems
+</li><li style="list-style-type: square">
+Apart from the ANTLR runtime, the binary distributions no longer bundle the
+needed 3rd party libraries. Thus the installation procedure for some Plug-ins
+requires more care: you have to manually remove outdated 3rd party libraries
+before you copy the <tt class="filename">.jars</tt> provided with Jalopy into the
+Plug-in/module folder of your application (Applies to Ant, Console, JBuilder
+ and jEdit, if done manually)
+</li><li style="list-style-type: square">
+Some shipped 3rd party jars we're updated: log4j to 1.2.6, Oro to 2.0.6,
+JAXP to 1.2.
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e835"></a>1.0 Beta 7 (2002-05-26)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The wrapping behaviour for throws clauses is now more configurable. See
+<a href="./wrapping.html#wrap-before-throws" target="_top">Wrapping section</a>.
+Requested by Stephane Houle
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=559222&amp;group_id=45216" target="_top">#559222</a>)
+</li><li style="list-style-type: square">
+Indentation for <tt class="classname">extends</tt>, <tt class="classname">implements</tt>
+and <tt class="classname">throws</tt> can now be specified explicitly. See
+<a href="./indentation.html#indentation-sizes" target="_top">Indentation section</a></li><li style="list-style-type: square">
+Chained method calls are now wrapped (if line wrapping is enabled, of course).
+You can either force wrapping after every call
+(Refer to the <a href="./wrapping.html#wrap-call-chained" target="_top">Wrapping section</a>)
+or let wrapping happen automatically. Requested by Stephane Houle
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442215&amp;aid=559222&amp;group_id=45216" target="_top">#559222</a>)
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Sometimes stdin was not formatted. Reported and fixed by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559503&amp;group_id=45216" target="_top">#559503</a>)
+</li><li style="list-style-type: square">
+1.0b6 failed to work with JDK 1.3.0 due to a bug in the handling of the index
+list <tt class="filename">.jar</tt> entry. Ant 1.5beta1 named it "INDEX.LIST" but this JDK expects "Index.list"
+which in turn lead to classloading problems.
+Reported by Steve Bromley
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559704&amp;group_id=45216" target="_top">#559704</a>)
+and Joel Alaux
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559240&amp;group_id=45216" target="_top">#559240</a>)
+</li><li style="list-style-type: square">
+Console Plug-in: Parsing a non-valid Java file with stdin always resulted in an
+exitcode "0". It now returns "1" in such cases. Reported by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=560709&amp;group_id=45216" target="_top">#560709</a>)
+</li><li style="list-style-type: square">
+The file history failed to work (because of an initialization error)
+</li><li style="list-style-type: square">
+The wrapper scripts for the Console Plug-in failed to work (I forgot to rename
+the startup class that has changed in 1.0b6). Reported by Ronen Rotstain
+</li><li style="list-style-type: square">
+The JBuilder Plug-in is now compatible with jVI. Reported by Rich Kadel
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559761&amp;group_id=45216" target="_top">#559761</a>)
+</li><li style="list-style-type: square">
+Javadoc tags were (intensionally) only printed if the Javadoc comment belonged to a class/interface or
+method/ctor declaration. Reported by Tony Falabella
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=559357&amp;group_id=45216" target="_top">#559357</a>)
+</li><li style="list-style-type: square">
+Specifying a relative file as input source could lead to a file loss in case
+of RuntimeExceptions during the processing and a backup level of "0".
+Reported by Kees Kuip
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=558353&amp;group_id=45216" target="_top">#558353</a>)
+</li><li style="list-style-type: square">
+The NetBeans module failed to function properly due to a wrong Manifest <tt class="filename">.jar</tt> entry. Reported by Nico Max and Davide Baroncelli
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=558560&amp;group_id=45216" target="_top">#558560</a>)
+</li><li style="list-style-type: square">
+If <i class="guilabel">Space around Shift operators</i> was disabled, Jalopy failed to
+add whitespace around the <tt class="classname">instanceof</tt> operator. Reported by Roger Kemp
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=558482&amp;group_id=45216" target="_top">#558482</a>)
+</li><li style="list-style-type: square">
+Fixed a small but annoying bug regarding the alignment of assignments. Reported by GilloS
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=558638&amp;group_id=45216" target="_top">#558638</a>)
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The detection logic for debug logging calls has been slightly improved. Calls like
+<tt class="literal">Configuration.debug()</tt> won't be treated as logging calls anymore
+</li><li style="list-style-type: square">
+The custom Javadoc tag definitions are not stored in distinct files anymore but
+rather go into the settings file (to make it portable across system bounderies)
+</li><li style="list-style-type: square">
+The Ant task attribute handling changed: if you omit any optional attribute now the
+corresponding settings settings will be used for *all* attributes
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e953"></a>1.0 Beta 6 (2002-05-19)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Thanks to Roman Sarychev, Jalopy now provides the ability to import/export
+settings in an <tt class="filename">.XML</tt> format
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442215&amp;aid=549177&amp;group_id=45216" target="_top">#549177</a>)
+</li><li style="list-style-type: square">
+Jalopy is now able to keep original blank lines. See <a href="./separation.html#separation-misc-keep" target="_top">Separation section</a> for details
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442215&amp;aid=555914&amp;group_id=45216" target="_top">#555914</a>)
+</li><li style="list-style-type: square">
+Modifiers of declarations can now be sorted. See <a href="./sorting.html#sorting-general-modifiers" target="_top">Sort section</a> for details
+</li><li style="list-style-type: square">
+You can now enable the auto-insertion of an enclosing conditional for logging calls. See <a href="./misc.html#misc-logging-conditional" target="_top">Misc section</a> for details. Requested by Larry Hamel
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442215&amp;aid=550336&amp;group_id=45216" target="_top">#550336</a>)
+</li><li style="list-style-type: square">
+Parameters of method definitions can now be aligned. See <a href="./indentation.html#indentation-align-params" target="_top">Indentation section</a>. Requested by Gary Bentley
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442215&amp;aid=551205&amp;group_id=45216" target="_top">#551205</a>)
+</li><li style="list-style-type: square">
+The default grouping depth is now user configurable. See <a href="./imports.html#imports-grouping" target="_top">Imports section</a>. Requested by Larry Hamel
+</li><li style="list-style-type: square">
+Added new options (before and after curly braces, blocks...) to customize the blank lines behaviour. See <a href="./separation.html" target="_top">Separation section</a></li><li style="list-style-type: square">
+You can now print a blank between array type and initializer. Requested by David Weitzman
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442215&amp;aid=548888&amp;group_id=45216" target="_top">#548888</a>)
+</li><li style="list-style-type: square">
+Jalopy is now able to load its settings from an Internet address. Refer to the
+<a href="./settings.html#general" target="_top">General section</a> of the manual. Cool feature requested by Sven van't Veer
+</li><li style="list-style-type: square">
+You can now use stdin/stdout redirection from the command line. If no input
+file(s) are specified, Jalopy will start listening on stdin. Note that the
+command line interface is now only available via the Console Plug-in! See
+<a href="./plugin-console-usage.html#plugin-console-usage-example" target="_top">Examples section</a></li><li style="list-style-type: square">
+For array initializers you can now force a specfic number of elements to be
+printed on each line or whether all elements should be printed on one line.
+See <a href="./wrapping.html#wrap-misc-arrays" target="_top">Wrapping section</a></li><li style="list-style-type: square">
+Eclipse Plug-in: the Packages view context menu now contains a formatting menu item
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Eclipse Plug-in: Fixed a bug in the shutdown hook. Only occurred if one had not
+formatted several files at once during a session. Reported by Eric Vickery
+</li><li style="list-style-type: square">
+Multi-line comments were not printed correctly if parsing of multi-line comments was
+disabled and the individual lines not starting with a leading asterix. Reported by Tony Falabella
+(<a href="http://sf.net/tracker/?func=detail&amp;atid=442212&amp;aid=554141&amp;group_id=45216" target="_top">#554141</a>)
+</li><li style="list-style-type: square">
+Javadoc generation failed if <i class="guilabel">Parse/Format tags</i> was disabled. Reported by Gary Bentley
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=551194&amp;group_id=45216" target="_top">#551194</a>)
+</li><li style="list-style-type: square">
+Serial version UID check box didn't save. Reported by Kevin Duffey
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=551604&amp;group_id=45216" target="_top">#551604</a>)
+</li><li style="list-style-type: square">
+Formatting an opened file with one of the Plug-ins did not create a backup file. Reported by Warren Nicholls
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=545077&amp;group_id=45216" target="_top">#545077</a>)
+</li><li style="list-style-type: square">
+Custom Javadoc tag definitions are now loaded correctly and thus working. Reported by Arnd Empting
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=547028&amp;group_id=45216" target="_top">#547028</a>)
+</li><li style="list-style-type: square">
+Fixed an trailing comment bug for the Sun brace styling. Reported by Martin Spiller
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=545616&amp;group_id=45216" target="_top">#545616</a>)
+</li><li style="list-style-type: square">
+Eclipse Plug-in: After formatting the active editor, the IBeam cursor was not
+restored but rather the default cursor showed up
+</li><li style="list-style-type: square">
+Line wrapping for while and do-while expression parts now working (I forgot the markers)
+</li><li style="list-style-type: square">
+Fixed a blank lines issue for singe-line comments (printed one extra behind
+left curly braces, this is now user configurable)
+</li><li style="list-style-type: square">
+Fixed another blank lines issue for the Sun brace style (missed one blank
+line between blocks. Reported by Bradley Smith
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=545941&amp;group_id=45216" target="_top">#545941</a>,
+<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=544459&amp;group_id=45216" target="_top">#544459</a>)
+</li><li style="list-style-type: square">
+EOF comments weren't always treated correctly (in case of singe-line comments). Reported by Ian Brown
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=544706&amp;group_id=45216" target="_top">#544706</a>)
+</li><li style="list-style-type: square">
+jEdit Plug-in: Updated to work with 4.0 final. It now won't work with any prior release
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=544100&amp;group_id=45216" target="_top">#544100</a>)
+</li><li style="list-style-type: square">
+NetBeans Plug-in: fixed a build problem causing the <tt class="filename">.nbm</tt>
+file to be missing in the distro archive. Reported by Brian Ewins
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=544162&amp;group_id=45216" target="_top">#544162</a>)
+</li><li style="list-style-type: square">
+Fixed a minor bug in the JavadocPrinter regarding the printing of lists
+</li><li style="list-style-type: square">
+Footers were always removed no matter whether enabled or disabled
+</li><li style="list-style-type: square">
+Left curly brace for array initialization expression now regards the selected brace style
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The license terms have changed. The core runtime and most of the Plug-ins are now
+released under the <a href="license-bsd.html" target="_top">BSD license</a>.
+Due to license restrictions of a 3rd party library,
+the command line interface has been removed from *<span class="bold"><b>ALL</b></span>*
+distributions and a new Plug-in was created: the Console Plug-in.
+</li><li style="list-style-type: square">
+JBuilder Plug-in: switching project does not bring up a blocking progress dialog
+anymore. The class repository is loaded in a background thread
+</li><li style="list-style-type: square">
+All file dialogs are not opened directly anymore but are accessible via an
+intermediate component that provides a history
+</li><li style="list-style-type: square">
+Eclipse Plug-in: Updated the <tt class="filename">plugin.xml</tt> to work with the
+latest stable build (20020416). This change only regards the menu item to
+invoke the Jalopy settings dialog; this item now appears under the 'Window'
+menu as the 'Workbench' menu has been gone
+</li><li style="list-style-type: square">
+The Javadoc parser now recognizes &lt;br/&gt; as a valid HTML tag
+(<a href="http://sf.net/tracker/index.php?func=detail&amp;atid=442212&amp;aid=547028&amp;group_id=45216" target="_top">#547028</a>)
+</li><li style="list-style-type: square">
+The Javadoc parser now checks whether any custom tag definition was added/removed
+since the last run and therefore needs reloading
+</li><li style="list-style-type: square">
+Specifying an empty string input via Jalopy#setInput(String, String) no longer
+throws <tt class="classname">IllegalArgumentException</tt>, instead the input is
+handled like an up-to-date file
+</li><li style="list-style-type: square"><span><b class="guibutton">Load...</b></span> and <span><b class="guibutton">Save...</b></span> buttons on the
+General settings page has been renamed
+to <span><b class="guibutton">Import...</b></span> and <span><b class="guibutton">Export...</b></span></li><li style="list-style-type: square">
+Changed the comment handling of labeled statements: if the following loop had
+comments before, these were printed before the labeled statement, now they will
+be printed before the loop statement
+</li><li style="list-style-type: square">
+The build scripts has been updated to use Ant 1.5beta1 features. Prior Ant
+releases won't work anymore
+</li><li style="list-style-type: square">
+Updated the bundled log4j distribution to 1.2.1. Adopted the new naming scheme
+and renamed all <tt class="classname">Category</tt> and <tt class="classname">Priority</tt>
+instances. Note that 1.2 is *no* drop-in replacement (no matter what the log4j docu says)
+as they renamed a public (sic!) field I have to use
+</li><li style="list-style-type: square">
+jEdit Plug-in: The menu item to display the Jalopy settings dialog can now
+be added to the context menu
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1163"></a>1.0 Beta 5 (2000-04-14)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square"><tt class="classname">AbstractPlugin.java</tt> now comes with multi-processor
+support, so all IDE Plug-ins should operate faster on multi-processor machines.
+Refer to the <a href="misc.html#misc-threads" target="_top">Misc</a> section of the
+manual
+</li><li style="list-style-type: square">
+Ant Plug-in: Added multi-processor support, new parameter <i class="parameter"><tt>threads</tt></i> to specify
+the number of threads to use
+</li><li style="list-style-type: square">
+Declaration and assignments aligning now available. Refer to the
+<a href="indentation.html#indentation-align-ident" target="_top">Indentation</a> section of the
+manual
+</li><li style="list-style-type: square">
+Separation (blank lines) behaviour now configurable. Refer to the
+<a href="separation.html" target="_top">Separation</a> section of the manual
+</li><li style="list-style-type: square">
+Added Eclipse Plug-in (needs Eclipse 2.0)
+</li><li style="list-style-type: square">
+Jalopy now supports the common convention of using a single @see tag
+instead of all the other tags and won't insert any missing Javadoc tags in such
+cases. Same applies if the inline tag {@inheritDoc} is found in the description
+</li><li style="list-style-type: square">
+Work started to provide an extended index for the user manual.
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Javadoc add/remove didn't work for @return tag
+</li><li style="list-style-type: square">
+The editable combo boxes (<tt class="classname">NumberComboBoxEditor.java</tt>)
+caused exceptions on losing focus
+</li></ul></div><p></p></li><li>
+Changes
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Javadoc now also generated for methods/ctors without params.
+</li><li style="list-style-type: square">
+Ant Plug-in: Changed the configuration of the message output. It is
+now controlled by a single parameter <i class="parameter"><tt>loglevel</tt></i>. This may
+force you to update your build scripts. Refer to the
+<a href="plugin-ant-usage.html#tab-ant-params" target="_top">Ant section</a>
+of the manual to read about the list of valid parameters
+</li><li style="list-style-type: square">
+The source base has been split into different modules (to make CVS happy and
+life easier) and the build system has changed accordingly
+</li><li style="list-style-type: square">
+The website and all documentation is now auto-generated out of <tt class="filename">.XML</tt> files
+(using the Ant style task and DocBook XSL 1.50.0/Saxon 6.5.1)
+</li><li style="list-style-type: square">
+The entries of the history viewer are now sorted
+</li><li style="list-style-type: square">
+The web site has a new look
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1235"></a>1.0 Beta 4 (2000-03-20)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Jalopy now provides some decent user documentation. Many thanks to Larry
+Hamel for the proof-reading
+</li><li style="list-style-type: square">
+The line wrapping logic is now fully implemented
+</li><li style="list-style-type: square">
+New line wrapping option: You can now force the wrapping for parameter
+lists of method calls. Note that this switch only applies to those lists
+that contain another method call. Refer to the
+<a href="wrapping.html#wrap-always" target="_top">Wrap always</a> section of the manual.
+Nice feature suggested by David Beutel
+</li><li style="list-style-type: square">
+Continuation indentation is now available for ternary if-else epressions
+too. Refer to the
+<a href="indentation.html#indentation-misc-ternary-if-else" target="_top">Indentation</a> section of the manual
+</li><li style="list-style-type: square">
+New option: You can now specify whether you want indentation realized
+with tabs instead of spaces. Refer to the
+<a href="indentation.html#indentation-misc-tab" target="_top">Indentation</a> section of the manual.
+This feature was kindly donated by David Beutel
+</li><li style="list-style-type: square">
+The history feature is now more user configurable. You can specifiy
+whether you want to have it enabled at all and what policy you want to
+use. Choose between the comment based history (which inserts a small
+header on top of every file) or a file-driven history. Refer to the
+<a href="misc.html#misc-history" target="_top">Indentation</a> section of the manual.
+The history feature is now *disabled* by default
+</li><li style="list-style-type: square">
+Added two new wrapping options: <i class="guilabel">Before extends keyword</i> and
+<i class="guilabel">Before implements keyword</i>. Enabling any of them will force
+a newline before the given keyword. Refer to the
+<a href="wrapping.html#wrap-always" target="_top">Wrap always</a> section of the manual.
+Requested by John Bishop
+</li><li style="list-style-type: square">
+New option to control the printing of labels. You can now specify whether
+a line break should be printed after labels or not. Refer to the
+<a href="wrapping.html#wrap-always-label" target="_top">Wrap always</a> section of the manual
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Small bugfix regarding trailing comments and array initialization
+</li><li style="list-style-type: square">
+Line wrapping for parameter lists was always performed, no matter what
+preference setting given
+</li><li style="list-style-type: square">
+For ternary if-else statements, parentheses was always inserted for the
+expression part if <i class="guilabel">Insert parentheses around expressions</i> was enabled.
+Now parentheses are only inserted if actually needed
+</li><li style="list-style-type: square"><i class="guilabel">Indent labels</i> option didn't show up on the indentation settings page
+</li><li style="list-style-type: square">
+The Javadoc auto-generation facility no longer inserts @throws tags for throws
+clauses that are catched in the method body
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Settings pages <i class="guilabel">Braces</i> and <i class="guilabel">Block style</i>
+now merged into one page <i class="guilabel">Braces</i> with two tabs
+<i class="guilabel">Style</i> and <i class="guilabel">Misc</i></li><li style="list-style-type: square"><span><b class="guibutton">Cancel</b></span> button of the Progress monitor dialog renamed to
+<span><b class="guibutton">Stop</b></span> to reflect the fact that some files might have changed
+</li><li style="list-style-type: square">
+Settings page <i class="guilabel">Javadoc</i> cleaned up
+</li><li style="list-style-type: square">
+Specifying an identify key to delete existing headers/footers is now
+enforced
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1336"></a>1.0 Beta 3 (2000-03-10)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+New option: You can now specify whether you want to retain first column
+comments vs. indenting them relative to their position in the code. Refer to the
+<a href="indentation.html#indentation-misc-first-column" target="_top">Indentation</a> section of the manual
+</li><li style="list-style-type: square">
+New option: You can now use different brace styles for class/method
+blocks and other types of blocks (for Sun, GNU and Custom style)
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The Javadoc parser rework lead to an error with the Javadoc @throws tags
+verification. This has been fixed now (Actually only a build problem)
+</li><li style="list-style-type: square">
+If <i class="guilabel">Space before Case colon</i> was enabled, no space was printed for
+the default keyword
+</li><li style="list-style-type: square">
+The comment creation only worked if the comment parsing and tag checking
+was enabled too
+</li><li style="list-style-type: square">
+Formatting a non-file input produced wrong updates of the history header
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+The line-wrapping logic changed/improved somewhat
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1372"></a>1.0 Beta 2 (2002-03-05)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Custom Javadoc tag definitions now available
+</li><li style="list-style-type: square">
+New option: You can now choose whether you want an empty statement
+inserted into empty braces to make the intension obvious
+</li><li style="list-style-type: square">
+New option: You can now specify whether if-statements should generally use
+continuation indent. This option was added to address the fact that
+conventional indentation could make seeing the body difficult (as outlined
+in the Sun Java Conventions guide)
+</li><li style="list-style-type: square">
+New option: Line wrapping can now be performed before or after operators
+</li><li style="list-style-type: square">
+New option: You can now specify template texts for auto-inserted Javadoc tags.
+</li><li style="list-style-type: square">
+NetBeans Plug-in added (for NetBeans 3.3.1 and higher)
+</li><li style="list-style-type: square">
+jEdit Plug-in: updated to work with jEdit 4.0prev1 and higher
+</li><li style="list-style-type: square">
+JBuilder Plug-in: added the Format and Settings actions to the popup
+menu of the editor pane
+</li><li style="list-style-type: square">
+Ant Plug-in: new parameter <i class="parameter"><tt>style</tt></i> to set the settings file to use
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Fixed a bug regarding the wrong printing of parenthesis for certain
+rare cases
+</li><li style="list-style-type: square">
+Correction of mispelled Javadoc standard tags failed if the correct
+amount of tags was given for the method/ctor
+</li><li style="list-style-type: square">
+No space was printed after array elements for arrays that fit in
+one line
+</li><li style="list-style-type: square">
+Printing of trailing comments now works much more reliable
+</li><li style="list-style-type: square">
+No message was reported in case the user specified an invalid input file
+on the command line
+</li><li style="list-style-type: square">
+Progress dialog didn't show progress for files with an opened editor view
+</li><li style="list-style-type: square">
+If no arguments were given on the command line, no warning was printed.
+Now the usage notes will appear
+</li><li style="list-style-type: square">
+Fixed a horrible bug in the JBuilder Plug-in which caused wrong class
+repository updates if one switched JDKs
+</li><li style="list-style-type: square">
+Fixed an error in the initialization process of the logging facility for
+Plug-ins using the AbstractPlugin skeleton which hindered the updating
+of the errors/warnings count in the progress dialog
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+All Plug-ins now only available as bundles. This will certainly pertain
+until a branding mechanism is available to check whether a given Plug-in
+will work with a given Jalopy runtime (a la NetBeans?)
+</li><li style="list-style-type: square">
+Changed/refactored some method signatures in the client API for consistency
+and ease of use
+</li><li style="list-style-type: square">
+The Javadoc parser has been reworked to allow both custom standard and
+inline tags
+</li><li style="list-style-type: square">
+Some API documentation enhancements, updated the build script to only generate
+the documentation for the public client API, removed the documentation for the
+Plug-ins from the distribution Javadoc
+</li><li style="list-style-type: square">
+Moved the logic to set the settings file to use, from the command line
+interface into <tt class="classname">Jalopy.java</tt> to let Plug-ins easily set the settings file
+to use
+</li><li style="list-style-type: square">
+Updated the used ANTLR version to 2.7.2a2. Compiled with optimizations and
+without debugging info results in smaller archive sizes
+</li><li style="list-style-type: square">
+Many build-script improvements. It should now be possible to build a
+Jalopy runtime version without the need of Plug-in related 3rd-party
+libraries
+</li><li style="list-style-type: square">
+The Jalopy runtime classes and all needed library classes are now bundled
+into one .jar
+</li><li style="list-style-type: square">
+The customizer mini editor is no longer part of the runtime .jar
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1448"></a>1.0 Beta 1 (2002-02-13)</h2></div></div><div></div></div><div class="orderedlist"><ol type="i"><li>
+New Features
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+jEdit Plug-in added (for jEdit 3.2.2)
+</li><li style="list-style-type: square">
+The progress dialog now includes a cancel button
+</li></ul></div><p></p></li><li>
+Bugfixes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Settings dialog did not close when invoked on the command line
+with <span><b class="command">java Preferences</b></span></li><li style="list-style-type: square">
+Error in build script fixed (JavadocTokenTypes.txt now included in
+the .jars) to make the Javadoc auto-correction work
+</li><li style="list-style-type: square">
+Braces indentation not printed for left curly braces
+</li><li style="list-style-type: square">
+JBuilder Plug-in: Registered directories need to be reparsed on
+every startup for the import expansion/collapsing to work reliably
+</li></ul></div><p></p></li><li>
+Changes
+
+<div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+Changed default package depth for packages java, javax, gnu in the
+settings (former was 3, now uses 2)
+</li><li style="list-style-type: square">
+Changed the SwingWorker implementation to the one found in Doug Lea's
+<tt class="classname">util.concurrent</tt> package, refactored <tt class="classname">AbstractPlugin.java</tt>
+to use an inner class dereived from <tt class="classname">SwingWorker.java</tt>
+instead of extending <tt class="classname">SwingWorker.java</tt> itself
+</li><li style="list-style-type: square">
+Formatting a single file doesn't bring up the progress dialog anymore, but
+rather shows the system wait cursor and blocks all input
+</li><li style="list-style-type: square">
+Removed the Javadoc documentation from the Plug-in distributions
+</li></ul></div><p></p></li></ol></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d35e1498"></a>Initial beta version (2002-02-10)</h2></div></div><div></div></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..087fb92 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.7.&nbsp;Imports</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="comments.html" title="4.3.6.&nbsp;Comments"><link rel="next" href="environment.html" title="4.3.8.&nbsp;Environment"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="imports.html#imports-sorting" title="4.3.7.1.&nbsp;General"><link rel="subsection" href="imports.html#import-grouping" title="4.3.7.2.&nbsp;Grouping"><link rel="subsection" href="imports.html#import-optimization" title="4.3.7.3.&nbsp;Optimize">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.7.&nbsp;Imports</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="comments.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="environment.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="imports"></a>4.3.7.&nbsp;Imports</h3></div></div><div></div></div><a class="indexterm" name="d0e4017"></a><p>
+Controls the handling of import declarations.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="imports-sorting"></a>4.3.7.1.&nbsp;General</h4></div></div><div></div></div><a class="indexterm" name="d0e4025"></a><p>
+Enables the sorting of import statements. Sorting the import statements makes
+it simple to browse a long list of imports.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Sort import statements
+</p><p>
+Enables or disables the sorting of import statements. Enabling this option
+will sort all imports lexicographically.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-grouping"></a>4.3.7.2.&nbsp;Grouping</h4></div></div><div></div></div><a class="indexterm" name="d0e4039"></a><p>
+In addition to sorting, associated packages can be grouped together to reduce
+complexity by packing related information into a common unit.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="imports-grouping-depth"></a>
+Default grouping depth
+</p><a class="indexterm" name="d0e4052"></a><a class="indexterm" name="d0e4059"></a><p>
+Lets you define the default grouping depth. Only takes effect if sorting is enabled.
+</p><p>
+The grouping depth specifies the number of package name parts that are to
+be taken into account in order to determine whether two import statements are to
+be grouped together. For certain packages you may want to specify a grouping
+depth that differs from the default.
+</p><p>
+Statements are to be grouped together, if all relevant parts are equal. So via
+the grouping depth you can effectively specify how many parts are relevant.
+</p><p>
+To disable grouping at all, set the grouping depth to "<tt class="literal">0</tt>".
+</p><div class="example"><a name="ex-imports-grouping-depth-one"></a><p class="title"><b>Example&nbsp;4.137.&nbsp;Grouping depth java='1'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+import <span class="bold"><b>java</b></span>.awt.Color;
+import <span class="bold"><b>java</b></span>.awt.Component;
+import <span class="bold"><b>java</b></span>.awt.GridBagConstraints;
+import <span class="bold"><b>java</b></span>.awt.GridBagLayout;
+import <span class="bold"><b>java</b></span>.awt.event.ActionEvent;
+import <span class="bold"><b>java</b></span>.awt.event.ActionListener;
+import <span class="bold"><b>java</b></span>.util.ArrayList;
+import <span class="bold"><b>java</b></span>.util.List;
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-two"></a><p class="title"><b>Example&nbsp;4.138.&nbsp;Grouping depth java='2'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+import <span class="bold"><b>java.awt</b></span>.Color;
+import <span class="bold"><b>java.awt</b></span>.Component;
+import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;
+import <span class="bold"><b>java.awt</b></span>.GridBagLayout;
+import <span class="bold"><b>java.awt</b></span>.event.ActionEvent;
+import <span class="bold"><b>java.awt</b></span>.event.ActionListener;
+
+import <span class="bold"><b>java.util</b></span>.ArrayList;
+import <span class="bold"><b>java.util</b></span>.List;
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-three"></a><p class="title"><b>Example&nbsp;4.139.&nbsp;Grouping depth java= '3'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+import <span class="bold"><b>java.awt</b></span>.Color;
+import <span class="bold"><b>java.awt</b></span>.Component;
+import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;
+import <span class="bold"><b>java.awt</b></span>.GridBagLayout;
+
+import <span class="bold"><b>java.awt.event</b></span>.ActionEvent;
+import <span class="bold"><b>java.awt.event</b></span>.ActionListener;
+
+import <span class="bold"><b>java.util</b></span>.ArrayList;
+import <span class="bold"><b>java.util</b></span>.List;
+</pre></td></tr></table></div><p></p></li></ul></div><p>
+You can add/remove package fragments (e.g. javax, javax.swing or com.foo.sarah)
+via the <span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span>
+buttons to fine-tune the appearance for certain packages.
+</p><p>
+To specify the order in which related statements should appear, you
+may want to use the <span><b class="guibutton">Up</b></span> and <span><b class="guibutton">Down</b></span> buttons.
+</p><p>
+Note that the <tt class="literal">asterix</tt> represents all undefined packages.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-optimization"></a>4.3.7.3.&nbsp;Optimize</h4></div></div><div></div></div><p>
+Optimizes the import statements by either expanding or collapsing them. This
+is a nice feature that is currently only available with the Ant and
+JBuilder Plug-in.
+</p><a class="indexterm" name="d0e4189"></a><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-expand"></a>
+Expand on-demand imports
+<a class="indexterm" name="d0e4198"></a>
+</p><p>
+If enabled, tries to expand all on-demand import statements.
+</p><p><a name="imports-on-demand"></a>
+Expanding means to resolve all on-demand import statements (sometimes called
+wildcard imports) and replace them with single-type import statements (sometimes
+called explicit imports) of the types that are actually used in the source file.
+</p><a class="indexterm" name="d0e4208"></a><p>
+So the following on-demand import statement may be expanded into two
+single-type import statements that reference the needed types for this package.
+</p><div class="example"><a name="ex-imports-on-demand"></a><p class="title"><b>Example&nbsp;4.140.&nbsp;On-demand import statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+import java.util.*;
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-import-single-type"></a><p class="title"><b>Example&nbsp;4.141.&nbsp;Single-type import statements</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+import java.util.ArrayList;
+import java.util.List;
+</pre></td></tr></table></div><p>
+Using single-type imports is quite useful and an absolute requirement in the
+open source community as this code is usually really reviewed. Using
+single-type imports makes it easy for the code reader to quickly find
+out the package a particular type is in: You just search for the type name
+from the start of the source file.
+</p></li></ul></div><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-collapse"></a>
+Collapse single-type imports
+<a class="indexterm" name="d0e4232"></a>
+<a class="indexterm" name="d0e4238"></a>
+</p><p>
+If enabled, tries to collapse all single-type statements.
+</p><p>
+Collapsing means to remove all single-type imports of a given package and
+replace them with one on-demand import statement.
+</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="comments.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="environment.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.6.&nbsp;Comments&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.8.&nbsp;Environment</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..a281328 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.3.&nbsp;Indentation</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="whitespace.html" title="4.3.2.&nbsp;White Space"><link rel="next" href="wrapping.html" title="4.3.4.&nbsp;Wrapping"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="indentation.html#indentation-general" title="4.3.3.1.&nbsp;General"><link rel="subsection" href="indentation.html#indentation-misc" title="4.3.3.2.&nbsp;Misc"><link rel="subsection" href="indentation.html#indentation-align" title="4.3.3.3.&nbsp;Align"><link rel="subsection" href="indentation.html#indentation-continuation" title="4.3.3.4.&nbsp;Continuation">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.3.&nbsp;Indentation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="whitespace.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="wrapping.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="indentation"></a>4.3.3.&nbsp;Indentation</h3></div></div><div></div></div><p>
+Controls the indentation settings.
+<a class="indexterm" name="d0e2107"></a>
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="indentation-general"></a>4.3.3.1.&nbsp;General</h4></div></div><div></div></div><p>Lets you change the general indentation settings.</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="indentation-policy"></a>4.3.3.1.1.&nbsp;Policy</h5></div></div><div></div></div><p>
+Lets you choose the way lines should be indented.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="indentation-policy-standard"></a>
+Standard indent
+</p><p>
+With standard indentation, lines will be indented according to the
+current indentation level (Note that the indentation level changes as the block
+or parentheses level changes).
+</p><div class="example"><a name="indentation-method-decl-standard"></a><p class="title"><b>Example&nbsp;4.30.&nbsp;Method declaration (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one, int two, String three,
+    StringObject four, AnotherObject five) {
+...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="indentation-method-call-standard"></a><p class="title"><b>Example&nbsp;4.31.&nbsp;Method Call (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+vector.add(new AppServerReference(
+        "RemoteApplicationManager",
+        poa.create_reference_with_id("RemoteApplicationManager".getBytes(),
+            RemoteApplicationManagerHelper.id())));
+</pre></td></tr></table></div><p></p><div class="example"><a name="indentation-assign-standard"></a><p class="title"><b>Example&nbsp;4.32.&nbsp;Assignment (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doublette[InteressentenPflegeController.GEBURTSDATUM] = versichertenResultSetRow[i].field[0]
+    .substring(0, 2) + "."
+    + versichertenResultSetRow[i].field[0].substring(2, 4) + "."
+    + versichertenResultSetRow[i].field[0].substring(4, 6);
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-policy-deep"></a>
+Deep indent
+</p><p>
+Deep indentation means that lines will be indented relative to the current
+parentheses or assignment offset. This way consecutive code sections are somewhat easier
+to recognize at the downside of consuming more horizontal space.
+</p><div class="example"><a name="indentation-method-decl-deep"></a><p class="title"><b>Example&nbsp;4.33.&nbsp;Method declaration (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one, int two, String three,
+                              StringObject four, AnotherObject five) {
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="indentation-method-call-deep"></a><p class="title"><b>Example&nbsp;4.34.&nbsp;Method Call (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+this.add(lbPunktzahl,
+         new GridBagLayout(0, 1, 2, 1, 0.0, 0.0,
+                           GribBagConstraints.WEST,
+                           GribBagConstraints.NONE,
+                           new Insets(0, GribBagConstraints.WEST,
+                                      GribBagConstraints.WEST,
+                                      GribBagConstraints.WEST), 0, 0));
+</pre></td></tr></table></div><p></p><div class="example"><a name="indentation-assign-deep"></a><p class="title"><b>Example&nbsp;4.35.&nbsp;Assignment (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doublette[Controller.GEBURTSDATUM] = versichertenResultSetRow[i].field[0]
+                                     .substring(0, 2) + "."
+                                     + versichertenResultSetRow[i].field[0]
+                                       .substring(2, 4)
+                                     + "."
+                                     + versichertenResultSetRow[i].field[0]
+                                       .substring(4, 6);
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="indentation-sizes"></a>4.3.3.1.2.&nbsp;Sizes</h5></div></div><div></div></div><a class="indexterm" name="d0e2171"></a><p>
+Lets you set different indentation sizes.
+</p><div class="itemizedlist"><p></p><ul type="disc"><li><p><a name="indentation-sizes-general"></a>
+General indent
+<a class="indexterm" name="d0e2182"></a>
+</p><p>
+Specifies the number of spaces to use for general indentation (Studies have
+found that 2 to 4 spaces for indentation is optimal)
+</p><div class="example"><a name="ex-indentation-two-space"></a><p class="title"><b>Example&nbsp;4.36.&nbsp;2 space general indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class Preferences
+{
+-&gt;private Preferences()
+-&gt;{
+-&gt;}
+
+-&gt;public static void main(String[] argv)
+-&gt;{
+-&gt;-&gt;de.hunsicker.jalopy.swing.PreferencesDialog.main(argv);
+-&gt;}
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-four-space"></a><p class="title"><b>Example&nbsp;4.37.&nbsp;4 space general indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class Preferences
+{
+---&gt;private Preferences()
+---&gt;{
+---&gt;}
+
+---&gt;public static void main(String[] argv)
+---&gt;{
+---&gt;---&gt;de.hunsicker.jalopy.swing.PreferencesDialog.main(argv);
+---&gt;}
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-leading"></a>
+Leading indent
+<a class="indexterm" name="d0e2207"></a>
+</p><p>
+Specifies the number of spaces to prepend before every line printed.
+</p><div class="example"><a name="ex-indentation-six-leading"></a><p class="title"><b>Example&nbsp;4.38.&nbsp;6 space leading indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+-----&gt;public class Preferences
+-----&gt;{
+-----&gt;    private Preferences()
+-----&gt;    {
+-----&gt;    }
+
+-----&gt;    public static void main(String[] argv)
+-----&gt;    {
+-----&gt;        de.hunsicker.jalopy.swing.PreferencesDialog.main(argv);
+-----&gt;    }
+-----&gt;}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-continuation"></a>
+Continuation indent
+<a class="indexterm" name="d0e2226"></a>
+</p><p>
+Specifies the number of spaces that should be inserted in front of
+continuation lines, i.e. the consecutive lines in case of a line wrap.
+</p><div class="example"><a name="ex-indentation-two-continuation"></a><p class="title"><b>Example&nbsp;4.39.&nbsp;2 space continuation indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2)
+    -&gt;|| (condition3 &amp;&amp; condition4)
+    -&gt;|| !(condition5 &amp;&amp; condition6)) {
+    doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-four-continuation"></a><p class="title"><b>Example&nbsp;4.40.&nbsp;4 space continuation indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2)
+    ---&gt;|| (condition3 &amp;&amp; condition4)
+    ---&gt;|| !(condition5 &amp;&amp; condition6)) {
+    doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-trailing"></a>
+Trailing comment indent
+<a class="indexterm" name="d0e2251"></a>
+<a class="indexterm" name="d0e2259"></a>
+<a class="indexterm" name="d0e2265"></a>
+</p><p>
+Specifies the number of spaces to insert between trailing comments and the
+preceding statement.
+</p><div class="example"><a name="ex-indentation-three-trailing"></a><p class="title"><b>Example&nbsp;4.41.&nbsp;3 space trailing comment indent</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+new String[] {
+    "Sunday",--&gt;// Sunday
+    "Monday",--&gt;// Monday
+    "Tuesday",--&gt;// Tuesday
+    "Wednesday",--&gt;// Wednesday
+    "Thursday",--&gt;// Thursday
+    "Friday",--&gt;// Friday
+    "Saturday"--&gt;// Saturday
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-tab"></a>
+Original Tab indent
+</p><p>
+Specifies the original tabular size of the source code. Some indentations
+or alignments may fail, if you miss the correct size here.
+<a class="indexterm" name="d0e2282"></a>
+<a class="indexterm" name="d0e2288"></a>
+</p></li><li><p><a name="indentation-sizes-extends"></a>
+Extends indent
+</p><p>
+If enabled, specifies the whitespace to print before the <tt class="classname">extends</tt>
+keyword in case it was printed on a new line.
+</p><a class="indexterm" name="d0e2304"></a><div class="example"><a name="d0e2311"></a><p class="title"><b>Example&nbsp;4.42.&nbsp;extends indentation with 6 spaces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel
+------&gt;extends Puttable, Takable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-implements"></a>
+Implements indent
+</p><p>
+Specifies the whitespace to print before the <tt class="classname">implements</tt>
+keyword in case it was printed on a new line.
+</p><a class="indexterm" name="d0e2325"></a><div class="example"><a name="d0e2332"></a><p class="title"><b>Example&nbsp;4.43.&nbsp;implements indentation with 8 spaces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean
+-------&gt;implements Comparable, Cloneable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-sizes-throws"></a>
+Throws indent
+</p><p>
+Specifies the whitespace to print before the <tt class="classname">throws</tt>
+keyword in case it was printed on a new line.
+<a class="indexterm" name="d0e2346"></a>
+</p><div class="example"><a name="d0e2354"></a><p class="title"><b>Example&nbsp;4.44.&nbsp;throws indentation with 3 spaces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private static final File getDestinationFile(File dest, String packageName,
+                                             String filename)
+--&gt;throws IOException, FooException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="indentation-misc"></a>4.3.3.2.&nbsp;Misc</h4></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p><a name="indentation-misc-tab"></a>
+Use tabs to indent
+<a class="indexterm" name="d0e2369"></a>
+</p><p>
+Normally, Jalopy uses spaces to indent lines. If you prefer tabs, check this box.
+</p></li><li><p>
+Indent "case" from "switch"
+</p><p>
+The Sun Java code convention recommends a switch style where case statements
+are not indented relative to the switch statement as a whole. However, this
+option allows you to indent the case statements to make the entire switch
+statement stand out.
+</p><div class="example"><a name="ex-indentation-misch-switch-un"></a><p class="title"><b>Example&nbsp;4.45.&nbsp;Switch statement (unindented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+switch (prio)
+{
+case Priority.ERROR_INT :
+case Priority.FATAL_INT :
+    color = Color.red;
+    break;
+
+case Priority.WARN_INT :
+    color = Color.blue;
+    break;
+
+default:
+    color = Color.black;
+    break;
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-misc-switch"></a><p class="title"><b>Example&nbsp;4.46.&nbsp;Switch statement (indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+switch (prio)
+{
+---&gt;case Priority.ERROR_INT :
+---&gt;case Priority.FATAL_INT :
+---&gt;    color = Color.red;
+---&gt;    break;
+
+---&gt;case Priority.WARN_INT :
+---&gt;    color = Color.blue;
+---&gt;    break;
+
+---&gt;default:
+---&gt;    color = Color.black;
+---&gt;    break;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-misc-label"></a>
+Indent labels
+<a class="indexterm" name="d0e2397"></a>
+</p><p>
+Specifies whether lables should be indented with the current indentation level.
+</p><div class="example"><a name="ex-indentation-misc-label-unindent"></a><p class="title"><b>Example&nbsp;4.47.&nbsp;Unindented label</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+// advance to the first CLASS_DEF or INTERFACE_DEF
+<span class="bold"><b>LOOP</b></span>:
+        for (AST child = tree.getFirstChild();
+             child != null;
+             child = child.getNextSibling())
+        {
+            switch (child.getType())
+            {
+                case JavaTokenTypes.CLASS_DEF :
+                case JavaTokenTypes.INTERFACE_DEF :
+                    next = child;
+                    break LOOP;
+                default :
+                    break;
+            }
+        }
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-misc-label"></a><p class="title"><b>Example&nbsp;4.48.&nbsp;Indented label</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+        // advance to the first CLASS_DEF or INTERFACE_DEF
+        <span class="bold"><b>LOOP</b></span>:
+        for (AST child = tree.getFirstChild();
+             child != null;
+             child = child.getNextSibling())
+        {
+            switch (child.getType()) {
+                case JavaTokenTypes.CLASS_DEF :
+                case JavaTokenTypes.INTERFACE_DEF :
+                    next = child;
+                    break LOOP;
+
+                default :
+                    break;
+            }
+        }
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-misc-first-column"></a>
+Indent first column comments
+</p><p>
+Normally, all comments will be indented relative to their position in the code
+to avoid that comments break the logical structure of the program. Some
+developers may like to disable the indentation for first column comments
+during the developing phase.
+</p><div class="example"><a name="ex-indentation-misc-first-column"></a><p class="title"><b>Example&nbsp;4.49.&nbsp;First column comment (indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+    public static Printer create(AST node)
+    {
+
+        <span class="bold"><b>/*
+        if (node == null)
+        {
+            return new NullPrinter();
+        }
+        */</b></span>
+        return create(node.getType());
+    }
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-misc-first-column-unindented"></a><p class="title"><b>Example&nbsp;4.50.&nbsp;First column comment (unindented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+    public static Printer create(AST node)
+    {
+
+<span class="bold"><b>/*
+        if (node == null)
+        {
+            return new NullPrinter();
+        }
+*/</b></span>
+        return create(node.getType());
+    }
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="indentation-align"></a>4.3.3.3.&nbsp;Align</h4></div></div><div></div></div><a class="indexterm" name="d0e2450"></a><a class="indexterm" name="d0e2455"></a><div class="itemizedlist"><ul type="disc"><li><p><a name="indentation-align-ident"></a>
+Variable identifiers
+</p><p>
+If enabled, aligns the identifiers of variable declarations.
+</p><a class="indexterm" name="d0e2464"></a><div class="example"><a name="ex-indentation-misc-align-ident"></a><p class="title"><b>Example&nbsp;4.51.&nbsp;Variable identifiers</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String text = "text";
+int a = -1;
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-align-ident-aligned"></a><p class="title"><b>Example&nbsp;4.52.&nbsp;Variable identifiers (aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String        text = "text";
+int           a = -1;
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-align-assign"></a>
+Variable assignments
+</p><p>
+If enabled, aligns the assignment parts of variable declarations or, surprise, assignments.
+</p><a class="indexterm" name="d0e2488"></a><a class="indexterm" name="d0e2495"></a><div class="example"><a name="ex-indentation-align-assign-aligned"></a><p class="title"><b>Example&nbsp;4.53.&nbsp;Variable assignments (aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String text         = "text";
+int a               = -1;
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p>
+If both variable alignment options are enabled, you can achieve a style like
+the following:
+</p><div class="example"><a name="ex-indentation-align-both"></a><p class="title"><b>Example&nbsp;4.54.&nbsp;Variable identifiers/assignments (both aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String        text  = "text";
+int           a     = -1;
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p>
+
+</p></li><li><p><a name="indentation-align-params"></a>
+Method Def parameters
+</p><p>
+If enabled, aligns the parameters of method declarations. This only applies if
+all parameters will be wrapped; either because wrapping is forced or the
+max. line length is reached. To force aligning, you have to enable the
+wrapping for method parameters (See <a href="wrapping.html#wrap-method-params">Method Def parameters</a>).
+</p><a class="indexterm" name="d0e2524"></a><a class="indexterm" name="d0e2527"></a><div class="example"><a name="ex-indentation-align-params"></a><p class="title"><b>Example&nbsp;4.55.&nbsp;Method declaration parameters</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(final File file,
+                          File directory,
+                          int backupLevel)
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-align-params-aligned"></a><p class="title"><b>Example&nbsp;4.56.&nbsp;Method declaration parameters (aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(final File file,
+                          File       directory,
+                          int        backupLevel)
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-align-method-chains"></a>
+Method Call chains
+</p><p>
+If disabled, indentation happens according to the current indentation level.
+</p><div class="example"><a name="ex-indentation-align-call"></a><p class="title"><b>Example&nbsp;4.57.&nbsp;Method Call chain (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+Fachschluesselerzeugung.createService()
+.getNeuerFachschluesselServiceService(
+    FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT);
+</pre></td></tr></table></div><p>
+Otherwise indentation is performed relative to the column offset of the first chain link.
+</p><div class="example"><a name="ex-indentation-align-call-aligned"></a><p class="title"><b>Example&nbsp;4.58.&nbsp;Method Call chain  (aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+Fachschluesselerzeugung.createService()
+                       .getNeuerFachschluesselServiceService(
+                            FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT);
+</pre></td></tr></table></div><p></p></li><li><p><a name="indentation-align-ternary"></a>
+Ternary expressions
+</p><p>
+If disabled, ternary expressions are printed according to the current
+<a href="indentation.html#indentation-policy" title="4.3.3.1.1.&nbsp;Policy">indentation policy</a>.
+</p><div class="example"><a name="ex-indentation-ternary-standard"></a><p class="title"><b>Example&nbsp;4.59.&nbsp;Ternary operators (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+        alpha = (aLongBooleanExpression) ? beta    |
+        : gamma;                                   |
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-ternary-deep"></a><p class="title"><b>Example&nbsp;4.60.&nbsp;Ternary operators (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+        alpha = (aLongBooleanExpression) ? beta    |
+                : gamma;                           |
+</pre></td></tr></table></div><p>
+If enabled, the second operator will always be aligned relative to the first one.
+</p><div class="example"><a name="ex-indentation-ternary-align"></a><p class="title"><b>Example&nbsp;4.61.&nbsp;Ternary expresssions (aligned)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+        alpha = (aLongBooleanExpression) ? beta    |
+                                         : gamma;  |
+</pre></td></tr></table></div><p>
+Note that this switch only takes affect, if indeed a line break was inserted
+before the second expression. You can force such line breaks with the
+<a href="wrapping.html#wrap-ternary-colon">Wrap always before ternary expression colon</a> setting.
+</p></li></ul></div><p></p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="indentation-continuation"></a>4.3.3.4.&nbsp;Continuation</h4></div></div><div></div></div><a class="indexterm" name="d0e2597"></a><a class="indexterm" name="d0e2602"></a><p>
+Lets you specify extra indentation for consectutive lines of certain expressions.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="indentation-misc-continuation-if"></a>
+Blocks
+</p><p>
+The Sun brace style could make seeing the statement body difficult. To
+workaround this problem, you may want to use continuation indentation in case you like this
+brace style. This setting applies for <tt class="literal">if</tt>, <tt class="literal">for</tt>, <tt class="literal">while</tt>
+and <tt class="literal">do-while</tt> blocks.
+</p><div class="example"><a name="ex-indentation-misc-non-continuation"></a><p class="title"><b>Example&nbsp;4.62.&nbsp;Non-continuation indentation</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2)
+    || (condition3 &amp;&amp; condition4)
+    || !(condition5 &amp;&amp; condition6)) { // BAD WRAPS
+    doSomethingAboutIt();             // MAKE THIS LINE EASY TO MISS
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-indentation-misc-contiunation"></a><p class="title"><b>Example&nbsp;4.63.&nbsp;Continuation indentation</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2)
+        || (condition3 &amp;&amp; condition4)
+        || !(condition5 &amp;&amp; condition6)) {
+    doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p>
+Refer to <a href="printer.html#braces-style-styles" title="4.3.1.1.1.&nbsp;Styles">Section&nbsp;4.3.1.1.1, &#8220;Styles&#8221;</a> for the available brace style options.
+</p></li><li><p><a name="indentation-misc-ternary-if-else"></a>
+Operators
+</p><p>
+If enabled, indentation will be increased before an operand will be printed.
+</p><div class="example"><a name="ex-indentation-misc-ternary-if-else"></a><p class="title"><b>Example&nbsp;4.64.&nbsp;Ternary expression (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma
+               ---&gt;? COMMA_SPACE
+               ---&gt;: COMMA;
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="whitespace.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="wrapping.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.2.&nbsp;White Space&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.4.&nbsp;Wrapping</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..2f83c93 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy Java Source Code Formatter Beautifier Pretty Printer</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table><table cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                        <a href="./history.html" class="navlink2">History</a></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="overview"></a>Overview</h2></div></div><div></div></div><p>
+Jalopy is a source code formatter for the Sun Java programming language. It
+layouts any valid Java source code according to some widely configurable rules;
+to meet a certain coding style without putting a formatting burden on individual
+developers.
+</p><p>
+With Jalopy you will be able to transform any foreign coding style to your
+own liking, without any browbeating or bloodletting.
+</p><p>
+Jalopy's functionality covers:
+</p><div class="blockquote"><blockquote class="blockquote"><table class="simplelist" border="0" summary="Simple list"><tr><td>
+- <a href="./braces.html" target="_top">Brace style transformation</a>
+</td></tr><tr><td>
+- <a href="./whitespace.html" target="_top">Fine-grained whitespace settings</a>
+</td></tr><tr><td>
+- <a href="./indentation.html" target="_top">Indentation</a>
+</td></tr><tr><td>
+- <a href="./wrapping.html" target="_top">Intelligent line wrapping</a>
+</td></tr><tr><td>
+- <a href="./separation.html" target="_top">Code separation</a>
+</td></tr><tr><td>
+- <a href="./javadoc.html#javadoc-generation" target="_top">Javadoc auto-generation</a>
+</td></tr><tr><td>
+- <a href="./header.html" target="_top">Header/Footer templates</a>
+</td></tr><tr><td>
+- <a href="./plugin-console.html" target="_top">Powerful command-line interface</a>
+</td></tr><tr><td>
+- <a href="./api/index.html" target="_top">Client API</a>
+</td></tr><tr><td>
+- <a href="./plugins.html" target="_top">Several Plug-ins</a>
+</td></tr></table></blockquote></div><p>
+Jalopy is
+"<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a <a href="./license-bsd.html" target="_top">BSD License</a>. Please
+refer to <a href="./dependencies.html" target="_top">Appendix A</a> for the license terms of the
+accompanying 3rd party libraries and the different <a href="./part-plugins.html" target="_top">Plug-in chapters</a>
+for the license terms of the provided Plug-ins.
+</p></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..f125ecd 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.4.2.&nbsp;Naming</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="inspector.html" title="4.4.&nbsp;Code Inspector"><link rel="previous" href="inspector.html" title="4.4.&nbsp;Code Inspector"><link rel="next" href="messages.html" title="4.5.&nbsp;Messages"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="inspector-naming.html#inspector-naming-tester" title="4.4.2.1.&nbsp;Regular expression tester">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.4.2.&nbsp;Naming</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inspector.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.4.&nbsp;Code Inspector</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="messages.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="inspector-naming"></a>4.4.2.&nbsp;Naming</h3></div></div><div></div></div><a class="indexterm" name="d0e5379"></a><a class="indexterm" name="d0e5382"></a><p>
+Lets you specify the naming constraints for different Java source file elements. These
+constraints are naturally expressed with regular expressions (Perl 5.003 syntax).
+</p><p>
+The list component displays all covered elements along with their current regular
+expression.
+</p><p>
+Selecting an item in the list and either pressing the <span><b class="guibutton">Change...</b></span>
+button or double-clicking on the item will open a little regular expression testing tool
+that can be used to interactively craft a valid regular expression.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="inspector-naming-tester"></a>4.4.2.1.&nbsp;Regular expression tester</h4></div></div><div></div></div><a class="indexterm" name="d0e5399"></a><a class="indexterm" name="d0e5402"></a><p>
+The regular expression tester lets you interactively specifiy a valid regular expression
+that matches a certain String pattern.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Regexp
+</p><p>
+The <span><b class="guilabel">Regexp</b></span> text field is where you have to insert the regular
+expression. This text field initially contains the current regular expression for the
+list item that is under construction.
+</p><p>
+The used regular expression syntax is that of Perl 5.003. See <span class="emphasis"><em>Mastering Regular
+Expressions</em></span> [<a href="bi01.html#friedl97">Friedl97</a>] for an in-depth look at this
+regular expression flavor.
+</p></li><li><p>
+String
+</p><p>
+The <span><b class="guilabel">String</b></span> text field is where you have to type a String that should
+be matched by the specified regular expression. This text field is initially empty; you
+have to enter a String in order to be able to test the regular expression.
+</p></li></ul></div><p>
+Once you have setup up the text fields you can either use the <span><b class="guibutton">Test</b></span>
+button to soley perform the pattern matching test or the <span><b class="guibutton">Apply</b></span> button
+which both performs testing and - on success - closes the dialog and updates the list.
+</p><p>
+You can always use the <span><b class="guibutton">Cancel</b></span> button to cancel editing. The dialog
+will be closed nd no changes made to the list.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inspector.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="inspector.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="messages.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.4.&nbsp;Code Inspector&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.5.&nbsp;Messages</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..a712b57 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.4.&nbsp;Code Inspector</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="previous" href="misc.html" title="4.3.13.&nbsp;Misc"><link rel="next" href="inspector-naming.html" title="4.4.2.&nbsp;Naming"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="inspector.html#d0e5095" title="4.4.1.&nbsp;General"><link rel="subsection" href="inspector-naming.html" title="4.4.2.&nbsp;Naming">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.4.&nbsp;Code Inspector</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="misc.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;4.&nbsp;Settings</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="inspector-naming.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="inspector"></a>4.4.&nbsp;Code Inspector</h2></div></div><div></div></div><a class="indexterm" name="d0e5090"></a><p>
+Provides the configuration facility for the Jalopy Code Inspector. The Code Inspector is
+able to inspect Java source files for naming convention violations and possible code
+weaknesses.
+</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5095"></a>4.4.1.&nbsp;General</h3></div></div><div></div></div><p>
+Lets you control the general Code Inspector settings.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5100"></a>4.4.1.1.&nbsp;General</h4></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>
+Enable
+</p><p>
+Lets you enable or disable the Code Inspector as a whole.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5109"></a>4.4.1.2.&nbsp;Tips</h4></div></div><div></div></div><p>
+Lets you selectively choose what actions should be performed during inspection. Moving the
+mouse pointer onto a checkbox displays a minimalistic tooltip after a short delay.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Tip 1 - Don't substitute another type for <tt class="classname">Object</tt> in the equals declaration
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 35.
+</p></li><li><p>
+Tip 2 - Object the general contract when overriding <tt class="literal">equals</tt>
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 25.
+</p></li><li><p>
+Tip 3 - Always override <tt class="literal">hashCode</tt> when you override <tt class="literal">equals</tt>
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 36.
+</p></li><li><p>
+Tip 4 - Always override <tt class="literal">equals</tt> when you override <tt class="literal">hashCode</tt>
+</p></li><li><p>
+Tip 5 - Always override <tt class="literal">toString</tt>
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 42.
+</p></li><li><p>
+Tip 6 - Use interfaces only to define types
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 89.
+</p></li><li><p>
+Tip 7 - Replace structures with classes
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 97.
+</p></li><li><p>
+Tip 8 - Return zero-length arrays, not <tt class="literal">nulls</tt>
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 134.
+</p></li><li><p>
+Tip 9 - Adhere to generally accepted naming conventions
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 165.
+</p></li><li><p>
+Tip 10 - Refer to objects by their interfaces
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 156.
+</p></li><li><p>
+Tip 11 - Never declare that a method "throws Exception"
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 181.
+</p></li><li><p>
+Tip 12 - Never declare that a method "throws Throwable"
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 181.
+</p></li><li><p>
+Tip 13 - Don't ignore exceptions
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 187.
+</p></li><li><p>
+Tip 14 - Never invoke <tt class="literal">wait</tt> outside a loop
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 201.
+</p></li><li><p>
+Tip 15 - Avoid thread groups
+</p><p>
+For a detailed discussion see <span class="emphasis"><em>Effective Java</em></span> [<a href="bi01.html#bloch01">Bloch01</a>], pp. 211.
+</p></li><li><p>
+Tip 16 - Document collection types
+</p><p>
+As long as there are no strong-typed collections (a.k.a. Java Generics support) available,
+it is best to document the object type of the items hold by a collection.
+</p><div class="example"><a name="inspector-tip16"></a><p class="title"><b>Example&nbsp;4.154.&nbsp;Collection comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private static final List _favorableTypes = new ArrayList(20); // List of &lt;String&gt;
+</pre></td></tr></table></div><p></p></li><li><p>
+Tip 17 - Adhere to naming convention for collection types
+</p><p>
+If you use comments to document the object type of collection items, you should conform to
+a generally accepted naming convention.
+</p></li><li><p>
+Tip 18 - Avoid empty <tt class="literal">finally</tt> blocks
+</p><p>
+Empty <tt class="literal">finally</tt> blocks are of no use and may indicate programmer errors.
+</p><div class="example"><a name="inspector-tip18"></a><p class="title"><b>Example&nbsp;4.155.&nbsp;Empty <tt class="literal">finally</tt> block</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+Writer writer = null;
+
+try
+{
+    writer = new BufferedWriter(new FileWriter(file));
+    write.write(data);
+}
+catch (IOException ex)
+{
+    System.err.println("file could not be written -- " + file);
+}
+finally
+{
+}
+</pre></td></tr></table></div><p>
+The programmer certainly wanted to close the <tt class="classname">Writer</tt> in the
+<tt class="literal">finally</tt> block to ensure that allocated system resources will be freed.
+</p></li><li><p>
+Tip 19 - Avoid variable shadowing
+</p><p>
+Variable shadowing should be avoided on general principle, as it tends to be confusing.
+</p><p>
+For more information about shadowing, see the
+Java Developer Connection (JDC) Tech Tips, October 10, 2000
+(<a href="http://developer.java.sun.com/developer/TechTips/2000/tt1010.html#tip2" target="_top">
+http://developer.java.sun.com/developer/TechTips/2000/tt1010.html#tip2</a>, subscription needed) or
+section 6.3.2, "Obscured Declarations," section 7.5.2,
+"Type-Import-on-Demand Declaration," section 8.4.6, "Inheritance, Overriding, and Hiding,"
+section 8.4.8.5, "Example: Invocation of Hidden Class Methods," and section 14.4.3,
+"Shadowing of Names by Local variables" in "The Java Language Specification Second
+Edition" by Gosling, Joy, Steele, and Bracha
+(<a href="http://java.sun.com/docs/books/jls/" target="_top">http://java.sun.com/docs/books/jls/)</a>.
+</p></li><li><p>
+Tip 20 - Add <span class="emphasis"><em>NOI18N</em></span> comment for String literals
+</p><p>
+Enabling this tip will cause warnings for all String literals without associated
+<tt class="literal">/* NOI18N */</tt> comment.
+</p><p>
+Internationalizing Java applications is often done with nifty tools that use marker
+comments to indicate that a given String literal should not be considered for localization.
+Most tools (at least the ones I know of) use trailing single-line comments which may not
+be very robust for processing with a formatting tool such as Jalopy. In contrast the author
+uses a multi-line comment of the form <tt class="literal">/* NOI18N */</tt> that gets directly
+placed after a String literal and will therefore always stuck with it.
+</p><div class="example"><a name="inspector-tip20"></a><p class="title"><b>Example&nbsp;4.156.&nbsp;$NON-NLS-1$ comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+FileDialog dialog = new FileDialog(this,
+    ResourceBundle.getBundle(BUNDLE_NAME)
+    .getString("BTN_SAVE_AS", FileDialog.SAVE); //$NON-NLS-1$
+</pre></td></tr></table></div><p>
+This trailing comment could be easily moved away from its String literal during formatting
+which would result in an unwanted notice on successive internationalization runs.
+</p><div class="example"><a name="inspector-tip20a"></a><p class="title"><b>Example&nbsp;4.157.&nbsp;$NON-NLS-1$ comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+FileDialog dialog =
+    new FileDialog(this,
+                   ResourceBundle.getBundle(BUNDLE_NAME).
+                                  getString("BTN_SAVE_AS",
+                   FileDialog.SAVE); //$NON-NLS-1$
+</pre></td></tr></table></div><p></p><div class="example"><a name="inspector-tip20b"></a><p class="title"><b>Example&nbsp;4.158.&nbsp;NOI18N comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+FileDialog dialog =
+    new FileDialog(this,
+                   ResourceBundle.getBundle(BUNDLE_NAME).
+                                  getString("BTN_SAVE_AS" /* NOI18N */),
+                   FileDialog.SAVE);
+</pre></td></tr></table></div><p></p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="misc.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="settings.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="inspector-naming.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.13.&nbsp;Misc&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.4.2.&nbsp;Naming</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..87ed6d5 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;1.&nbsp;Installation</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="previous" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="next" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements"><link rel="subsection" href="installation.html#installation-installation" title="1.2.&nbsp;Installing Jalopy">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;1.&nbsp;Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="part-core.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;Jalopy core</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="build.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="installation"></a>Chapter&nbsp;1.&nbsp;Installation</h2></div></div><div></div></div><a class="indexterm" name="d0e665"></a><p>
+Provides a quick introduction on how to install a binary Jalopy distribution.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="installation-requirements"></a>1.1.&nbsp;System requirements</h4></div></div><div></div></div><a class="indexterm" name="d0e675"></a><p>
+Jalopy requires a properly configured JDK or JRE version 1.3 or later on
+your system.
+</p><p><a name="installation-dependencies"></a>
+Jalopy depends on and comes with several freely available Java libraries. For more
+information regarding this 3rd party libraries refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a>.
+</p><a class="indexterm" name="d0e684"></a></div><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Incompatibility with Sun JDK 1.4</h3><p>
+The contained Javadoc parser may not work properly under Sun JDK 1.4. Refer to
+<a href="javadoc.html" title="4.3.9.&nbsp;Javadoc">Section&nbsp;4.3.9, &#8220;Javadoc&#8221;</a> for more information regarding this issue.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="installation-installation"></a>1.2.&nbsp;Installing Jalopy</h4></div></div><div></div></div><a class="indexterm" name="d0e697"></a><p>
+Installation depends on the distribution you received. Please refer to the individual
+Plug-in chapters in <a href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins">Part&nbsp;II, &#8220;Plug-ins&#8221;</a> for detailed information.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="part-core.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-core.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="build.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part&nbsp;I.&nbsp;Jalopy core&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;2.&nbsp;Building</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..56e6332 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Introduction</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="acknowledge.html" title="Acknowledgements"><link rel="next" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="acknowledge.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="part-core.html">Next</a></td></tr></table><hr></div><div class="preface" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="introduction"></a>Introduction</h2></div></div><div></div></div><a class="indexterm" name="d0e637"></a><p>
+Jalopy is a source code formatting tool for the Sun Java Programming Language.
+It can insert and remove indentation, enforce brace styles, wrap lines, sort
+and group imports, add headers and footers, handle whitespace, insert/remove
+and correct Javadoc entries to match method signatures and much more.
+</p><p>
+If your development team can agree on a coding style, Jalopy can help you
+maintain it, without any browbeating or bloodletting. With a simple Ant target,
+you can format all the source into the style, as often as you like.
+</p><p>
+Jalopy is written in Java and there are several Plug-ins available to integrate
+the formatting engine into some of the more popular Java applications, including Ant,
+Eclipse, JBuilder, JDeveloper, jEdit and NetBeans/Sun ONE Studio.
+</p><p>
+Jalopy is
+"<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a <a href="./license-bsd.html" target="_top">BSD License</a>.
+For the individual license terms of the provided Plug-ins, please refer to the
+different Plug-in chapters in <a href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins">Part&nbsp;II, &#8220;Plug-ins&#8221;</a>.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="acknowledge.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="part-core.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Acknowledgements&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Part&nbsp;I.&nbsp;Jalopy core</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..852758e 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Index</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="bi01.html" title="Bibliography"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Index</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bi01.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;</td></tr></table><hr></div><div class="index"><div class="titlepage"><div><div><h2 class="title"><a name="d0e7950"></a>Index</h2></div></div><div></div></div><div class="index"><div class="indexdiv"><h3>A</h3><dl><dt>Alignment, <a href="indentation.html#indentation-align">Align</a></dt><dd><dl><dt>Assignments, <a href="indentation.html#indentation-align-assign">Align</a></dt><dt>Method Def parameters, <a href="indentation.html#indentation-align-params">Align</a></dt><dt>Variables</dt><dd><dl><dt>assignments, <a href="indentation.html#indentation-align-assign">Align</a></dt><dt>identifiers, <a href="indentation.html#indentation-align-ident">Align</a></dt></dl></dd></dl></dd><dt>Ant, <a href="plugin-ant.html">Ant Plug-in task</a></dt><dd><dl><dt>taskdef, <a href="plugin-ant.html#plugin-ant-installation-installation">Installation</a></dt></dl></dd><dt>Apache Software License, <a href="license-apache.html">The Apache Software License, Version 1.1</a></dt><dt>Assignment operators, <a href="whitespace.html#padding-assign">Spaces around</a></dt><dt>Auto-correction, <a href="javadoc.html#javadoc-correct">General</a></dt></dl></div><div class="indexdiv"><h3>B</h3><dl><dt>Bitwise operators, <a href="whitespace.html#padding-bitwise">Spaces around</a></dt><dt>Blank lines, <a href="separation.html#blank-lines-package">General</a>, <a href="separation.html#separation-misc-left-curly">Misc</a></dt><dd><dl><dt>After left curly brace, <a href="separation.html#separation-misc-left-curly">Misc</a></dt><dt>Before right curly brace, <a href="separation.html#separation-misc-right-curly">Misc</a></dt><dt>Case blocks, <a href="separation.html#blank-lines-case">General</a></dt><dt>Classes, <a href="separation.html#blank-lines-classes">General</a></dt><dt>Control statements, <a href="separation.html#blank-lines-control">General</a></dt><dt>Interfaces, <a href="separation.html#blank-lines-interfaces">General</a></dt><dt>Javadoc, <a href="separation.html#blank-lines-javadoc">General</a></dt><dt>Last Import statement, <a href="separation.html#blank-lines-import">General</a></dt><dt>Methods/Constructors, <a href="separation.html#blank-lines-methods">General</a></dt><dt>Multi-line comments, <a href="separation.html#blank-lines-ml-comments">General</a></dt><dt>Package statement, <a href="separation.html#blank-lines-package">General</a></dt><dt>Single-line comments, <a href="separation.html#blank-lines-sl-comments">General</a></dt><dt>Statement blocks, <a href="separation.html#blank-lines-blocks">General</a></dt><dt>Variable declarations, <a href="separation.html#blank-lines-declarations">General</a></dt></dl></dd><dt>Braces, <a href="printer.html#braces">Braces</a>, <a href="whitespace.html#padding-braces">Spaces around</a></dt><dd><dl><dt>cuddle, <a href="printer.html#braces-empty-cuddle">Empty braces</a></dt><dt>Empty, <a href="printer.html#braces-empty">Empty braces</a></dt><dt>empty, <a href="printer.html#braces-empty-statement">Empty braces</a></dt><dt>insert, <a href="printer.html#braces-insert">Insert braces</a></dt><dt>padding, <a href="whitespace.html#padding-braces">Spaces around</a></dt><dt>remove, <a href="printer.html#braces-remove">Remove braces</a></dt><dt>style, <a href="printer.html#braces-style">General</a></dt><dd><dl><dt>C, <a href="printer.html#braces-style-c">Styles</a></dt><dt>custom, <a href="printer.html#braces-style-custom">Styles</a></dt><dt>GNU, <a href="printer.html#braces-style-c">Styles</a></dt><dt>Sun, <a href="printer.html#braces-style-sun">Styles</a></dt></dl></dd><dt>whitespace, <a href="printer.html#braces-whitespace">Whitespace</a></dt><dt>wrapping, <a href="printer.html#braces-wrapping">Wrapping</a></dt></dl></dd><dt>Brackets, <a href="whitespace.html#padding-brackets">Spaces around</a></dt><dd><dl><dt>padding, <a href="whitespace.html#padding-brackets">Spaces around</a></dt></dl></dd><dt>Build, <a href="build.html">Building</a></dt><dd><dl><dt>Ant, <a href="build.html#build-prerequisites">Prerequisites</a></dt><dt>CVS, <a href="build.html#build-prerequisites">Prerequisites</a></dt><dt>DocBook, <a href="build.html#build-prerequisites">Prerequisites</a></dt><dt>Prerequisites, <a href="build.html#build-prerequisites">Prerequisites</a></dt><dt>XSLT, <a href="build.html#build-prerequisites">Prerequisites</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>Chunks, <a href="separation.html#chunks">Chunks</a></dt><dd><dl><dt>By Blank lines, <a href="separation.html#chunks-blank-lines">Chunks</a></dt><dt>By comments, <a href="separation.html#chunks-comments">Chunks</a></dt></dl></dd><dt>Code Convention, <a href="settings.html#code-convention">General</a></dt><dt>Code Inspector, <a href="inspector.html">Code Inspector</a></dt><dd><dl><dt>Naming, <a href="inspector-naming.html">Naming</a></dt></dl></dd><dt>Comma, <a href="whitespace.html#whitespace-after-comma">Space after</a></dt><dt>Command line, <a href="plugin-console-usage.html#synopsis">Synopsis</a></dt><dd><dl><dt>arguments, <a href="plugin-console-usage.html#usage-options">Synopsis</a></dt><dt>options, <a href="plugin-console-usage.html#usage-options">Synopsis</a></dt></dl></dd><dt>Comment</dt><dd><dl><dt>Header, <a href="header.html">Header</a></dt><dt>trailing, <a href="indentation.html#indentation-sizes-trailing">Sizes</a></dt></dl></dd><dt>Comment-based history, <a href="misc.html#history-comment">History</a></dt><dt>Comments</dt><dd><dl><dt>for history, <a href="misc.html#history-comment">History</a></dt><dt>Javadoc, <a href="comments.html#comments-javadoc">Comments</a>, <a href="javadoc.html#javadoc-correct">General</a></dt><dt>Javadoc comments, <a href="comments.html#comments-remove-javadoc">Remove</a>, <a href="javadoc.html#javadoc-format">General</a></dt><dt>Multi-line, <a href="comments.html#comments-multi">Comments</a></dt><dt>Multi-line comments, <a href="comments.html#comments-remove-multi">Remove</a>, <a href="comments.html#comments-format-multi">Format</a></dt><dt>Pragma, <a href="comments.html#comments-pragma">Comments</a></dt><dt>Separator, <a href="comments.html#comments-separator">Comments</a></dt><dt>Single-line, <a href="comments.html#comments-single">Comments</a></dt><dt>Single-line comments, <a href="comments.html#comments-remove-single">Remove</a></dt></dl></dd><dt>Common Public License Version, <a href="license-common-public.html">Common Public License Version 1.0</a></dt><dt>Compatibility</dt><dd><dl><dt>source, <a href="settings.html#general-compliance">Compliance</a></dt></dl></dd><dt>Compliance, <a href="settings.html#general-compliance">Compliance</a></dt><dt>Console, <a href="plugin-console.html">Console Application</a></dt><dt>Continuation, <a href="indentation.html#indentation-continuation">Continuation</a></dt><dt>Cuddled braces, <a href="printer.html#braces-empty-cuddle">Empty braces</a></dt></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>Deep indent, <a href="wrapping.html#wrap-sizes-deep">General</a></dt><dt>Dependencies, <a href="installation.html#installation-dependencies">System requirements</a></dt></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>Eclipse, <a href="plugin-eclipse.html">Eclipse Plug-in</a></dt><dt>Empty braces, <a href="printer.html#braces-empty">Empty braces</a></dt><dt>Empty statement, <a href="printer.html#braces-empty-statement">Empty braces</a></dt><dt>Environment, <a href="environment.html">Environment</a></dt><dt>Environment variables, <a href="environment.html">Environment</a></dt><dt>Extension, <a href="plugin-jdev.html">JDeveloper Extension</a></dt></dl></div><div class="indexdiv"><h3>F</h3><dl><dt>File-based history, <a href="misc.html#history-file">History</a></dt><dt>Footer, <a href="footer.html">Footer</a></dt></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>GNU Free Documentation License, <a href="license-gnu-doc.html">GNU Free Documentation License Version 1.1, March 2000</a></dt><dt>GNU GENERAL PUBLIC LICENSE, <a href="license-gnu.html">GNU GENERAL PUBLIC LICENSE Version 2, June 1991</a></dt><dt>Grouping depth, <a href="imports.html#imports-grouping-depth">Grouping</a></dt></dl></div><div class="indexdiv"><h3>H</h3><dl><dt>Header, <a href="header.html">Header</a></dt><dd><dl><dt>Smart Mode, <a href="header.html#header-smart-mode">General</a></dt></dl></dd><dt>History, <a href="misc.html#misc-history">History</a></dt><dd><dl><dt>comment, <a href="misc.html#history-comment">History</a></dt><dt>file, <a href="misc.html#history-file">History</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>Imports, <a href="imports.html">Imports</a></dt><dd><dl><dt>collapse, <a href="imports.html#import-optimization-collapse">Optimize</a></dt><dt>expand, <a href="imports.html#import-optimization-expand">Optimize</a></dt><dt>grouping, <a href=""></a></dt><dt>on-demand, <a href="imports.html#imports-on-demand">Optimize</a></dt><dt>optimization, <a href="imports.html#import-optimization">Optimize</a></dt><dt>single-type, <a href="imports.html#import-optimization-collapse">Optimize</a></dt><dt>sorting, <a href="imports.html#imports-sorting">General</a></dt><dd><dl><dt>grouping depth, <a href="imports.html#imports-grouping-depth">Grouping</a></dt></dl></dd></dl></dd><dt>Indentation, <a href="indentation.html">Indentation</a></dt><dd><dl><dt>Aligment, <a href="indentation.html#indentation-align">Align</a></dt><dt>Continutation, <a href="indentation.html#indentation-continuation">Continuation</a></dt><dt>sizes, <a href="indentation.html#indentation-sizes">Sizes</a></dt><dd><dl><dt>Continuation, <a href="indentation.html#indentation-sizes-continuation">Sizes</a></dt><dt>extends, <a href="indentation.html#indentation-sizes-extends">Sizes</a></dt><dt>General, <a href="indentation.html#indentation-sizes-general">Sizes</a></dt><dt>implements, <a href="indentation.html#indentation-sizes-implements">Sizes</a></dt><dt>Leading, <a href="indentation.html#indentation-sizes-leading">Sizes</a></dt><dt>Tabular, <a href="indentation.html#indentation-sizes-tab">Sizes</a></dt><dt>throws, <a href="indentation.html#indentation-sizes-throws">Sizes</a></dt><dt>Trailing comment, <a href="indentation.html#indentation-sizes-trailing">Sizes</a></dt></dl></dd></dl></dd><dt>Installation, <a href="installation.html">Installation</a>, <a href="installation.html#installation-installation">Installing Jalopy</a></dt><dd><dl><dt>Ant, <a href="plugin-ant.html#plugin-ant-installation-installation">Installation</a>, <a href="plugin-console.html#plugin-console-installation-installation">Installation</a></dt><dt>Eclipse Plug-in, <a href="plugin-eclipse.html#plugin-eclipse-installation-installation">Installation</a></dt><dt>JBuilder OpenTool, <a href="plugin-jbuilder.html#plugin-jbuilder-installation-installation">Installation</a></dt><dt>JDeveloper Plug-in, <a href="plugin-jdev.html#plugin-jdev-installation-installation">Installation</a></dt><dt>jEdit Plug-in, <a href="plugin-jedit.html#plugin-jedit-installation-installation">Installation</a></dt><dt>NetBeans Module, <a href="plugin-netbeans.html#plugin-netbeans-installation-installation">Installation</a></dt><dt>Sun ONE Studio Module, <a href="plugin-netbeans.html#plugin-netbeans-installation-installation">Installation</a></dt></dl></dd><dt>Interpolation, <a href="environment.html">Environment</a></dt><dt>Introduction, <a href="introduction.html">Introduction</a></dt></dl></div><div class="indexdiv"><h3>J</h3><dl><dt>Javadoc comments, <a href="comments.html#comments-javadoc">Comments</a>, <a href="comments.html#comments-remove-javadoc">Remove</a>, <a href="javadoc.html#javadoc-format">General</a></dt><dt>JBuilder, <a href="plugin-jbuilder.html">JBuilder OpenTool</a></dt><dt>JDeveloper, <a href="plugin-jdev.html">JDeveloper Extension</a></dt><dt>jEdit, <a href="plugin-jedit.html">jEdit Plug-in</a></dt></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Label, <a href="wrapping.html#wrap-always-pane">Wrap always</a></dt><dd><dl><dt>indent, <a href="indentation.html#indentation-misc-label">Misc</a></dt><dt>wrap, <a href="wrapping.html#wrap-always-pane">Wrap always</a></dt></dl></dd><dt>Licenses</dt><dd><dl><dt>ANTLR, <a href="license-antlr.html">ANTLR SOFTWARE RIGHTS</a></dt><dt>Apache Software License, <a href="license-apache.html">The Apache Software License, Version 1.1</a></dt><dt>BSD, <a href="license-bsd.html">The Jalopy BSD License</a></dt><dt>Common Public License Version, <a href="license-common-public.html">Common Public License Version 1.0</a></dt><dt>GNU Free Documentation License, <a href="license-gnu-doc.html">GNU Free Documentation License Version 1.1, March 2000</a></dt><dt>GNU GENERAL PUBLIC LICENSE, <a href="license-gnu.html">GNU GENERAL PUBLIC LICENSE Version 2, June 1991</a></dt><dt>Sun Public License Version, <a href="license-sun-public.html">SUN PUBLIC LICENSE Version 1.0</a></dt></dl></dd><dt>Line length, <a href="wrapping.html#wrap-sizes-line">General</a></dt><dt>Line wrapping, <a href="wrapping.html">Wrapping</a></dt><dt>Logical operators, <a href="whitespace.html#padding-logical">Spaces around</a></dt></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>Mathematical operators, <a href="whitespace.html#padding-mathematical">Spaces around</a></dt><dt>Method Def parameters, <a href="indentation.html#indentation-align-params">Align</a>, <a href="wrapping.html#wrap-method-params">Wrap always</a></dt><dt>Module</dt><dd><dl><dt>NetBeans, <a href="plugin-netbeans.html">NetBeans/Sun ONE Studio module</a></dt><dt>Sun ONE Studio, <a href="plugin-netbeans.html">NetBeans/Sun ONE Studio module</a></dt></dl></dd><dt>Multi-line comments, <a href="comments.html#comments-multi">Comments</a>, <a href="comments.html#comments-remove-multi">Remove</a>, <a href="comments.html#comments-format-multi">Format</a></dt></dl></div><div class="indexdiv"><h3>N</h3><dl><dt>Naming, <a href="inspector-naming.html">Naming</a></dt><dt>NetBeans, <a href="plugin-netbeans.html">NetBeans/Sun ONE Studio module</a></dt></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>OpenTool, <a href="plugin-jbuilder.html">JBuilder OpenTool</a></dt><dt>Operators</dt><dd><dl><dt>Assignment, <a href="whitespace.html#padding-assign">Spaces around</a></dt><dt>Bitwise, <a href="whitespace.html#padding-bitwise">Spaces around</a></dt><dt>Logical, <a href="whitespace.html#padding-logical">Spaces around</a></dt><dt>Mathematical, <a href="whitespace.html#padding-mathematical">Spaces around</a></dt><dt>Relational, <a href="whitespace.html#padding-relational">Spaces around</a></dt><dt>Shift, <a href="whitespace.html#padding-shift">Spaces around</a></dt><dt>wrap after, <a href="wrapping.html#wrap-after">Policy</a></dt><dt>wrap before, <a href="wrapping.html#wrap-before">Policy</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>P</h3><dl><dt>Padding, <a href="whitespace.html#padding">Spaces around</a></dt><dt>Parentheses, <a href="whitespace.html#whitespace-before-parentheses">Space before</a>, <a href="whitespace.html#padding-parentheses">Spaces around</a>, <a href="misc.html#paren-add">Misc</a></dt><dd><dl><dt>insert around expressions, <a href="misc.html#paren-add">Misc</a></dt><dt>padding, <a href="whitespace.html#padding-parentheses">Spaces around</a></dt></dl></dd><dt>Plug-in</dt><dd><dl><dt>Ant, <a href="plugin-ant.html">Ant Plug-in task</a></dt><dt>Console, <a href="plugin-console.html">Console Application</a></dt><dt>Eclipse, <a href="plugin-eclipse.html">Eclipse Plug-in</a></dt><dt>JBuilder, <a href="plugin-jbuilder.html">JBuilder OpenTool</a></dt><dt>JDeveloper, <a href="plugin-jdev.html">JDeveloper Extension</a></dt><dt>jEdit, <a href="plugin-jedit.html">jEdit Plug-in</a></dt><dt>NetBeans, <a href="plugin-netbeans.html">NetBeans/Sun ONE Studio module</a></dt></dl></dd><dt>Policy</dt><dd><dl><dt>Wrapping, <a href="wrapping.html#wrap-policy">Policy</a></dt></dl></dd><dt>Pragma comments, <a href="comments.html#comments-pragma">Comments</a></dt><dt>Printer, <a href="printer.html">Printer</a></dt><dt>Projects, <a href="project.html">Projects</a></dt></dl></div><div class="indexdiv"><h3>R</h3><dl><dt>Regular expression</dt><dd><dl><dt>Tester, <a href="inspector-naming.html#inspector-naming-tester">Regular expression tester</a></dt></dl></dd><dt>Regular expression tester, <a href="inspector-naming.html#inspector-naming-tester">Regular expression tester</a></dt><dt>Regular expressions, <a href="plugin-console-usage.html#usage-options">Synopsis</a></dt><dt>Relational operators, <a href="whitespace.html#padding-relational">Spaces around</a></dt></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>Semicolon, <a href="whitespace.html#whitespace-after-semi">Space after</a></dt><dt>Separator comment, <a href="separation.html#separation-comment">Comments</a></dt><dt>Separator comments, <a href="comments.html#comments-separator">Comments</a></dt><dt>Serial version UID, <a href="misc.html#misc-insert-uid">Misc</a></dt><dt>Settings, <a href="settings.html">Settings</a></dt><dt>Settings directory, <a href="settings.html#settings-directory">Settings</a></dt><dt>Shift operators, <a href="whitespace.html#padding-shift">Spaces around</a></dt><dt>Single-line comments, <a href="comments.html#comments-single">Comments</a>, <a href="comments.html#comments-remove-single">Remove</a></dt><dt>Software License, <a href="license-bsd.html">The Jalopy BSD License</a>, <a href="license-antlr.html">ANTLR SOFTWARE RIGHTS</a></dt><dt>Source compatibility, <a href="settings.html#general-compliance">Compliance</a></dt><dt>Sun ONE Studio, <a href="plugin-netbeans.html">NetBeans/Sun ONE Studio module</a></dt><dt>Sun Public License, <a href="license-sun-public.html">SUN PUBLIC LICENSE Version 1.0</a></dt><dt>Synopsis, <a href="plugin-console-usage.html#synopsis">Synopsis</a></dt><dt>System requirements, <a href="installation.html#installation-requirements">System requirements</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>Tabs</dt><dd><dl><dt>size, <a href="indentation.html#indentation-sizes-tab">Sizes</a></dt><dt>use, <a href="indentation.html#indentation-misc-tab">Misc</a></dt></dl></dd><dt>taskdef, <a href="plugin-ant.html#plugin-ant-installation-installation">Installation</a></dt><dt>Trailing Comment, <a href="indentation.html#indentation-sizes-trailing">Sizes</a></dt><dt>Type cast, <a href="whitespace.html#whitespace-after-cast">Space after</a></dt></dl></div><div class="indexdiv"><h3>U</h3><dl><dt>Usage, <a href="usage.html">Usage</a>, <a href="plugin-console-usage.html#synopsis">Synopsis</a></dt><dd><dl><dt>examples, <a href="plugin-console-usage.html#plugin-console-usage-example">Examples</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>V</h3><dl><dt>Variables</dt><dd><dl><dt>Environment, <a href="environment.html">Environment</a></dt><dt>Interpolation, <a href="environment.html">Environment</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>W</h3><dl><dt>White Space, <a href="whitespace.html">White Space</a></dt><dt>Whitespace</dt><dd><dl><dt>after, <a href="whitespace.html#space-after">Space after</a></dt><dd><dl><dt>comma, <a href="whitespace.html#whitespace-after-comma">Space after</a></dt><dt>semicolon, <a href="whitespace.html#whitespace-after-semi">Space after</a></dt><dt>type cast, <a href="whitespace.html#whitespace-after-cast">Space after</a></dt></dl></dd><dt>before, <a href="whitespace.html#whitespace-before">Space before</a></dt><dd><dl><dt>braces, <a href="whitespace.html#whitespace-before-braces">Space before</a></dt><dt>brackets, <a href="whitespace.html#whitespace-before-brackets">Space before</a></dt><dt>colon, <a href="whitespace.html#whitespace-before-colon">Space before</a></dt><dt>parentheses, <a href="whitespace.html#whitespace-before-parentheses">Space before</a></dt></dl></dd><dt>padding, <a href="whitespace.html#padding">Spaces around</a></dt><dd><dl><dt>Assignment operators, <a href="whitespace.html#padding-assign">Spaces around</a></dt><dt>Bitwise operators, <a href="whitespace.html#padding-bitwise">Spaces around</a></dt><dt>Braces, <a href="whitespace.html#padding-braces">Spaces around</a></dt><dt>Brackets, <a href="whitespace.html#padding-brackets">Spaces around</a></dt><dt>Logical operators, <a href="whitespace.html#padding-logical">Spaces around</a></dt><dt>Mathematical operators, <a href="whitespace.html#padding-mathematical">Spaces around</a></dt><dt>Parentheses, <a href="whitespace.html#padding-parentheses">Spaces around</a></dt><dt>Relational operators, <a href="whitespace.html#padding-relational">Spaces around</a></dt><dt>Shift operators, <a href="whitespace.html#padding-shift">Spaces around</a></dt></dl></dd></dl></dd><dt>Wrapping, <a href="wrapping.html">Wrapping</a></dt><dd><dl><dt>Deep indent, <a href="wrapping.html#wrap-sizes-deep">General</a></dt><dt>Line length, <a href="wrapping.html#wrap-sizes-line">General</a></dt><dt>Method Def parameters, <a href="wrapping.html#wrap-method-params">Wrap always</a></dt><dt>Policy, <a href="wrapping.html#wrap-policy">Policy</a></dt></dl></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bi01.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;</td></tr><tr><td width="40%" align="left" valign="top">Bibliography&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..ee66a8a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.9.&nbsp;Javadoc</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="environment.html" title="4.3.8.&nbsp;Environment"><link rel="next" href="header.html" title="4.3.10.&nbsp;Header"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="javadoc.html#javadoc-general" title="4.3.9.1.&nbsp;General"><link rel="subsection" href="javadoc.html#javadoc-generation" title="4.3.9.2.&nbsp;Generation"><link rel="subsection" href="javadoc.html#javadoc-templates" title="4.3.9.3.&nbsp;Templates"><link rel="subsection" href="javadoc.html#javadoc-tags" title="4.3.9.4.&nbsp;Custom Tags">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.9.&nbsp;Javadoc</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="environment.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="header.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="javadoc"></a>4.3.9.&nbsp;Javadoc</h3></div></div><div></div></div><p>
+Let's you control all Javadoc-related options. Refer to the
+<a href="http://java.sun.com/j2se/javadoc/index.html" target="_top">Javadoc home page</a>
+for more information about Sun's Javadoc tool.
+</p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Incompatibility with Sun JDK 1.4</h3><p>
+Note that the Javadoc parsing for Jalopy may not work properly under Sun
+JDK 1.4 with the Client JVM. This seems to be a problem with the garbage
+collection. You may want to enable the Server JVM as a workaround.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-general"></a>4.3.9.1.&nbsp;General</h4></div></div><div></div></div><p>
+Controls the general handling of Javadoc comments.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="javadoc-format"></a>
+Parse/Format comments
+</p><a class="indexterm" name="d0e4420"></a><a class="indexterm" name="d0e4425"></a><p>
+Enables the parsing of existing Javadoc comments which in turn leads to a
+reformatting of the original comment style during the printing.
+</p><p>
+The used parser mostly supports HTML 3.2 and is not loose in a sense most browsers
+are these days: tags not contained in the standard will produce errors. And you
+should always strive to produce well-formed HTML
+(it works for the <tt class="literal">&lt;p&gt;</tt>, <tt class="literal">&lt;li&gt;</tt>,
+<tt class="literal">&lt;dd&gt;</tt>, <tt class="literal">&lt;dt&gt;</tt> and <tt class="literal">&lt;dir&gt;</tt>
+tags, but anyway).
+</p><p>
+Don't forget that the standard HTML metacharacters, such as less and greater signs
+(<tt class="literal">&lt;</tt>, <tt class="literal">&gt;</tt>) or the ambersand (<tt class="literal">&amp;</tt>), ...
+and the commercial "at" sign (<tt class="literal">@</tt>) needs to be
+escaped if not used as part of another HTML or Javadoc tag.
+</p><div class="table"><a name="tab-character-entities"></a><p class="title"><b>Table&nbsp;4.2.&nbsp;Character entities</b></p><table summary="Character entities" border="0" style="border-collapse: collapse;border-top: 0.5pt solid ; border-bottom: 0.5pt solid ; border-left: 0.5pt solid ; border-right: 0.5pt solid ; "><colgroup><col><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Symbol</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Numeric Entity</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Named Entity</th><th style="border-bottom: 0.5pt solid ; ">Description</th></tr></thead><tbody><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;038;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;amp</td><td style="border-bottom: 0.5pt solid ; " valign="top">Ambersand</td></tr><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&lt;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;060;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;lt;</td><td style="border-bottom: 0.5pt solid ; " valign="top">Less than</td></tr><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&gt;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;062;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp;gt;</td><td style="border-bottom: 0.5pt solid ; " valign="top">Greater than</td></tr><tr valign="top"><td style="border-right: 0.5pt solid ; " align="center" valign="top">@</td><td style="border-right: 0.5pt solid ; " align="center" valign="top">&amp;064;</td><td style="border-right: 0.5pt solid ; " valign="top">&nbsp;</td><td style="" valign="top">Commercial "at" sign</td></tr></tbody></table></div><p></p><div class="example"><a name="ex-escape-html"></a><p class="title"><b>Example&nbsp;4.145.&nbsp;Escaping characters in Javadoc comments</b></p><p>Don't use</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+/**
+ * @author &lt;a href="mailto:first.last@company.com"&gt;first.last<span class="bold"><b>@</b></span>company.com&lt;/a&gt;
+ */
+</pre></td></tr></table><p>But rather use</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+/**
+ * @author &lt;a href="mailto:first.last@company.com"&gt;first.last<span class="bold"><b>&amp;064;</b></span>company.com&lt;/a&gt;
+ */
+</pre></td></tr></table></div><p></p></li><li><p><a name="javadoc-correct"></a>
+Correct tags
+</p><a class="indexterm" name="d0e4534"></a><a class="indexterm" name="d0e4539"></a><a class="indexterm" name="d0e4542"></a><p>
+Enables the auto-insertion or -removal of missing and obsolete Javadoc tags (all but the <tt class="literal">@throws</tt> tag, see below) and
+the correction of misspelled Javadoc tag names.
+</p></li><li><p><a name="javadoc-correct-throws"></a>
+Correct @throws tags
+</p><p>
+Controls the auto-correction for <tt class="literal">@throws</tt> tags. If enabled,
+Jalopy enforces a distinct <tt class="literal">@throws</tt> tag for every exception
+thrown by a method/constructor. Thus, if a method only declares to throw an
+<tt class="classname">IOException</tt> but throws a <tt class="classname">FileNotFoundException</tt>
+(which is a subclass of the former) too, Jalopy will add a declaration for the latter.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-generation"></a>4.3.9.2.&nbsp;Generation</h4></div></div><div></div></div><p>
+Controls the auto-generation of missing Javadoc comments.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="javadoc-generation-selection"></a>4.3.9.2.1.&nbsp;Element/Level</h5></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>
+Element/Level
+</p><p>
+Lets you selectively enable the auto-generation of missing Javadoc comments for
+specific class elements and access levels.
+</p></li><li><p>
+Include inner classes
+</p><p>
+Enables the auto-generation feature for inner classes, too. The
+auto-generation does not apply to anonymous inner classes.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="javadoc-misc"></a>4.3.9.2.2.&nbsp;Misc</h5></div></div><div></div></div><p>
+Let's you control miscellaneous Javadoc settings.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Field comments in single line
+</p><p>
+Let's you specify how Javadoc comments of fields, that fit into one line, should be printed.
+</p><div class="example"><a name="ex-javadoc-field"></a><p class="title"><b>Example&nbsp;4.146.&nbsp;Field Javadoc comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+/**
+ * What history policy should be used?
+ */
+private History.Policy _historyPolicy = History.Policy.DISABLED;
+</pre></td></tr></table></div><p>
+If enabled, Javadoc comments for fields will be printed in a single line,
+if possible.
+</p><div class="example"><a name="ex-javadoc-field-short"></a><p class="title"><b>Example&nbsp;4.147.&nbsp;Field Javadoc comment (shortened)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+/** What history policy should be used? */
+private History.Policy _historyPolicy = History.Policy.DISABLED;
+</pre></td></tr></table></div><p>
+Note that this switch does not take affect for field template comments,
+as template are not parsed but inserted as-is.
+</p><p>
+Note further that the <a href="javadoc.html#javadoc-format">Javadoc parsing</a>
+must be enabled for this feature to work.
+</p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-templates"></a>4.3.9.3.&nbsp;Templates</h4></div></div><div></div></div><p>
+Let's you define templates to be inserted for the different declaration elements.
+Each element (Class, Interface, Constructor, Method and Field) has its
+own template.
+</p><p>
+Depending on the element type, a template consists of up to five parts that
+together form a valid Javadoc comment. Note that the resulting comment will
+be inserted as-is, and it is your responsibility to define the templates
+in a consistent style.
+</p><p>
+You can use variable expressions throughout your templates. Read
+<a href="environment.html" title="4.3.8.&nbsp;Environment">Section&nbsp;4.3.8, &#8220;Environment&#8221;</a> for more information about this feature.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-tags"></a>4.3.9.4.&nbsp;Custom Tags</h4></div></div><div></div></div><p>
+Allows the definition of custom Javadoc tags to aid the syntax checking of
+Javadoc comments, and enable the auto-correction of misspelled custom tag names.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="javadoc-tags-standard"></a>4.3.9.4.1.&nbsp;Standard Tags</h5></div></div><div></div></div><p>
+Allows the definition of custom Javadoc standard tag names. The current build-in Standard
+tags are:
+<tt class="literal">@author</tt>,
+<tt class="literal">@deprecated</tt>,
+<tt class="literal">@exception</tt>,
+<tt class="literal">@param</tt>,
+<tt class="literal">@return</tt>,
+<tt class="literal">@see</tt>,
+<tt class="literal">@serial</tt>,
+<tt class="literal">@serialData</tt>,
+<tt class="literal">@serialField</tt>,
+<tt class="literal">@since</tt>,
+<tt class="literal">@throws</tt>,
+<tt class="literal">@todo</tt>,
+<tt class="literal">@version</tt>
+</p><p>
+Use the <span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span> buttons
+to add or remove items from the list.
+</p><p>
+Valid standard tag names have the form
+<tt class="literal">@[a-zA-Z]+</tt>, e.g. <tt class="literal">@exclude</tt>.
+</p></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="javadoc-tags-inline"></a>4.3.9.4.2.&nbsp;In-line Tags</h5></div></div><div></div></div><p>
+Allows the definition of custom Javadoc in-line tag names.
+The current build-in In-line tags are:
+<tt class="literal">@docRoot</tt>,
+<tt class="literal">@inheritDoc</tt>,
+<tt class="literal">@link</tt>,
+<tt class="literal">@linkPlain</tt>,
+<tt class="literal">@value</tt>
+</p><p>
+Use the <span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span> buttons
+to add or remove items from the list.
+</p><p>
+Valid in-line tag names have the form
+<tt class="literal">@[a-zA-Z]+</tt>, e.g. <tt class="literal">@mylink</tt>.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="environment.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="header.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.8.&nbsp;Environment&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.10.&nbsp;Header</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..444453b 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="next" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-bsd.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-apache.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-antlr"></a>Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS</h2></div></div><div></div></div><a class="indexterm" name="d0e7201"></a><a class="indexterm" name="d0e7204"></a><p>
+ANTLR 1989-2000 Developed by jGuru.com (MageLang Institute),
+<a href="http://www.antlr.org" target="_top">http://www.ANTLR.org</a> and
+<a href="http://www.jguru.com" target="_top">http://www.jGuru.com</a>
+</p><p>
+We reserve no legal rights to the ANTLR -- it is fully in the
+public domain. An individual or company may do whatever
+they wish with source code distributed with ANTLR or the
+code generated by ANTLR, including the incorporation of
+ANTLR, or its output, into commerical software.
+</p><p>
+We encourage users to develop software with ANTLR. However,
+we do ask that credit is given to us for developing
+ANTLR. By "credit", we mean that if you use ANTLR or
+incorporate any source code into one of your programs
+(commercial product, research project, or otherwise) that
+you acknowledge this fact somewhere in the documentation,
+research report, etc... If you like ANTLR and have
+developed a nice tool with the output, please mention that
+you developed it using ANTLR. In addition, we ask that the
+headers remain intact in our source code. As long as these
+guidelines are kept, we expect to continue enhancing this
+system and expect to make other tools available as they are
+completed.
+</p><p>
+The primary ANTLR guy:
+</p><p>
+Terence Parr
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-bsd.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="license-apache.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;B.&nbsp;The Jalopy BSD License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..1571a3a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="next" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-antlr.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-gnu.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-apache"></a>Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1</h2></div></div><div></div></div><a class="indexterm" name="d0e7229"></a><a class="indexterm" name="d0e7232"></a><p>
+Copyright (C) 1999 The Apache Software Foundation. All rights reserved.
+</p><p>
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+</p><div class="orderedlist"><ol type="1"><li><p>
+Redistributions of  source code must  retain the above copyright  notice,
+this list of conditions and the following disclaimer.
+</p></li><li><p>
+Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+</p></li><li><p>
+The end-user documentation included with the redistribution, if any, must
+include  the following  acknowledgment:  "This product includes  software
+developed  by the  Apache Software Foundation  (http://www.apache.org/)."
+Alternately, this  acknowledgment may  appear in the software itself,  if
+and wherever such third-party acknowledgments normally appear.
+</p></li><li><p>
+The names "Ant" and  "Apache Software Foundation"  must not be used to
+endorse  or promote  products derived  from this  software without  prior
+written permission. For written permission, please contact
+apache@apache.org.
+</p></li><li><p>
+Products  derived from this software may not  be called "Apache", nor may
+"Apache" appear  in their name,  without prior written permission  of the
+Apache Software Foundation.
+</p></li></ol></div><p>
+  THIS SOFTWARE IS PROVIDED ''AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
+  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+  FITNESS  FOR A PARTICULAR  PURPOSE ARE  DISCLAIMED.  IN NO  EVENT SHALL  THE
+  APACHE SOFTWARE  FOUNDATION  OR ITS CONTRIBUTORS  BE LIABLE FOR  ANY DIRECT,
+  INDIRECT, INCIDENTAL, SPECIAL,  EXEMPLARY, OR CONSEQUENTIAL  DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS
+  OF USE, DATA, OR  PROFITS; OR BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON
+  ANY  THEORY OF LIABILITY,  WHETHER  IN CONTRACT,  STRICT LIABILITY,  OR TORT
+  (INCLUDING  NEGLIGENCE OR  OTHERWISE) ARISING IN  ANY WAY OUT OF THE  USE OF
+  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+</p><p>
+  This software  consists of voluntary contributions made by many individuals
+  on behalf of the Apache Software Foundation. For more information on the
+  Apache Software Foundation, please see
+  <a href="http://www.apache.org/" target="_top">http://www.apache.org</a>.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-antlr.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="license-gnu.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..e69de29 100755 (executable)
@@ -1,18 +0,0 @@
-
-<!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)
- * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
- * 
- * 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/>.
--->
index 62e881d..447e5be 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;G.&nbsp;Common Public License Version 1.0</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="next" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;G.&nbsp;Common Public License Version 1.0</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-gnu-doc.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-sun-public.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-common-public"></a>Appendix&nbsp;G.&nbsp;Common Public License Version 1.0</h2></div></div><div></div></div><a class="indexterm" name="d0e7564"></a><a class="indexterm" name="d0e7567"></a><p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.</p><p><span class="bold"><b>1. DEFINITIONS</b></span></p><p>
+"Contribution" means:
+</p><div class="variablelist"><dl><dt></dt><dd><p>
+a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and
+</p><p>b) in the case of each subsequent Contributor:</p><p> i) changes to the Program, and</p><p>ii) additions to the Program;</p><p>
+where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.
+</p></dd></dl></div><p>
+"Contributor" means any person or entity that distributes the Program.
+</p><p>
+"Licensed Patents" mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.
+</p><p>
+"Program" means the Contributions distributed in accordance with this Agreement.
+</p><p>
+"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.
+</p><p><span class="bold"><b>2. GRANT OF RIGHTS</b></span></p><div class="variablelist"><dl><dt></dt><dd><p>
+a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.
+</p><p>
+b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.
+</p><p>
+c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.
+</p><p>
+d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.
+</p></dd></dl></div><p><span class="bold"><b>3. REQUIREMENTS</b></span></p><p>
+d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.
+</p><div class="variablelist"><dl><dt></dt><dd><p>
+a) it complies with the terms and conditions of this Agreement; and
+</p><p>b) its license agreement:</p><p>
+i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;
+</p><p>
+ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;
+</p><p>
+iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and
+</p><p>
+iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.
+</p></dd></dl></div><p>
+When the Program is made available in source code form:
+</p><div class="variablelist"><dl><dt></dt><dd><p>
+a) it must be made available under this Agreement; and
+</p><p>
+b) a copy of this Agreement must be included with each copy of the Program.
+</p><p>
+Contributors may not remove or alter any copyright notices contained within the Program.
+</p><p>
+Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.
+</p></dd></dl></div><p><span class="bold"><b>4. COMMERCIAL DISTRIBUTION</b></span></p><p>
+Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.
+</p><p>
+For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.
+</p><p><span class="bold"><b>5. NO WARRANTY</b></span></p><p>
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.
+</p><p><span class="bold"><b>6. DISCLAIMER OF LIABILITY</b></span></p><p>
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+</p><p><span class="bold"><b>7. GENERAL</b></span></p><p>
+If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
+</p><p>
+If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.
+</p><p>
+All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.
+</p><p>
+Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.
+</p><p>
+This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-gnu-doc.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="license-sun-public.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..36ebb87 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="next" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-gnu.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-common-public.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-gnu-doc"></a>Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000</h2></div></div><div></div></div><a class="indexterm" name="d0e7403"></a><a class="indexterm" name="d0e7406"></a><p>
+ Copyright (C) 2000  Free Software Foundation, Inc.
+     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+</p><p>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+</p><p>
+0. PREAMBLE
+</p><p>
+The purpose of this License is to make a manual, textbook, or other
+written document "free" in the sense of freedom: to assure everyone
+the effective freedom to copy and redistribute it, with or without
+modifying it, either commercially or noncommercially.  Secondarily,
+this License preserves for the author and publisher a way to get
+credit for their work, while not being considered responsible for
+modifications made by others.
+</p><p>
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+</p><p>
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+</p><p>
+1. APPLICABILITY AND DEFINITIONS
+</p><p>
+This License applies to any manual or other work that contains a
+notice placed by the copyright holder saying it can be distributed
+under the terms of this License.  The "Document", below, refers to any
+such manual or work.  Any member of the public is a licensee, and is
+addressed as "you".
+</p><p>
+A "Modified Version" of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+</p><p>
+A "Secondary Section" is a named appendix or a front-matter section of
+the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall subject
+(or to related matters) and contains nothing that could fall directly
+within that overall subject.  (For example, if the Document is in part a
+textbook of mathematics, a Secondary Section may not explain any
+mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+</p><p>
+The "Invariant Sections" are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.
+</p><p>
+The "Cover Texts" are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.
+</p><p>
+A "Transparent" copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, whose contents can be viewed and edited directly and
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup has been designed to thwart or discourage
+subsequent modification by readers is not Transparent.  A copy that is
+not "Transparent" is called "Opaque".
+</p><p>
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
+or XML using a publicly available DTD, and standard-conforming simple
+HTML designed for human modification.  Opaque formats include
+PostScript, PDF, proprietary formats that can be read and edited only
+by proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the
+machine-generated HTML produced by some word processors for output
+purposes only.
+</p><p>
+The "Title Page" means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, "Title Page" means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+</p><p>
+2. VERBATIM COPYING
+</p><p>
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+</p><p>
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+</p><p>
+3. COPYING IN QUANTITY
+</p><p>
+If you publish printed copies of the Document numbering more than 100,
+and the Document's license notice requires Cover Texts, you must enclose
+the copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+</p><p>
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+</p><p>
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a publicly-accessible computer-network location containing a complete
+Transparent copy of the Document, free of added material, which the
+general network-using public has access to download anonymously at no
+charge using public-standard network protocols.  If you use the latter
+option, you must take reasonably prudent steps, when you begin
+distribution of Opaque copies in quantity, to ensure that this
+Transparent copy will remain thus accessible at the stated location
+until at least one year after the last time you distribute an Opaque
+copy (directly or through your agents or retailers) of that edition to
+the public.
+</p><p>
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+</p><p>
+4. MODIFICATIONS
+</p><p>
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+</p><div class="orderedlist"><ol type="A"><li><p>
+ Use in the Title Page (and on the covers, if any) a title distinct
+   from that of the Document, and from those of previous versions
+   (which should, if there were any, be listed in the History section
+   of the Document).  You may use the same title as a previous version
+   if the original publisher of that version gives permission.
+</p></li><li><p>
+ List on the Title Page, as authors, one or more persons or entities
+   responsible for authorship of the modifications in the Modified
+   Version, together with at least five of the principal authors of the
+   Document (all of its principal authors, if it has less than five).
+</p></li><li><p>
+ State on the Title page the name of the publisher of the
+  Modified Version, as the publisher.
+</p></li><li><p>
+Preserve all the copyright notices of the Document.
+</p></li><li><p>
+ Add an appropriate copyright notice for your modifications
+   adjacent to the other copyright notices.
+</p></li><li><p>
+ Include, immediately after the copyright notices, a license notice
+   giving the public permission to use the Modified Version under the
+   terms of this License, in the form shown in the Addendum below.
+</p></li><li><p>
+ Preserve in that license notice the full lists of Invariant Sections
+   and required Cover Texts given in the Document's license notice.
+</p></li><li><p>
+ Include an unaltered copy of this License.
+</p></li><li><p>
+ Preserve the section entitled "History", and its title, and add to
+   it an item stating at least the title, year, new authors, and
+   publisher of the Modified Version as given on the Title Page.  If
+   there is no section entitled "History" in the Document, create one
+   stating the title, year, authors, and publisher of the Document as
+   given on its Title Page, then add an item describing the Modified
+   Version as stated in the previous sentence.
+</p></li><li><p>
+ Preserve the network location, if any, given in the Document for
+   public access to a Transparent copy of the Document, and likewise
+   the network locations given in the Document for previous versions
+   it was based on.  These may be placed in the "History" section.
+   You may omit a network location for a work that was published at
+   least four years before the Document itself, or if the original
+   publisher of the version it refers to gives permission.
+</p></li><li><p>
+ In any section entitled "Acknowledgements" or "Dedications",
+   preserve the section's title, and preserve in the section all the
+   substance and tone of each of the contributor acknowledgements
+   and/or dedications given therein.
+</p></li><li><p>
+ Preserve all the Invariant Sections of the Document,
+   unaltered in their text and in their titles.  Section numbers
+   or the equivalent are not considered part of the section titles.
+</p></li><li><p>
+ Delete any section entitled "Endorsements".  Such a section
+   may not be included in the Modified Version.
+</p></li><li><p>
+ Do not retitle any existing section as "Endorsements"
+   or to conflict in title with any Invariant Section.
+</p></li></ol></div><p>
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+</p><p>
+You may add a section entitled "Endorsements", provided it contains
+nothing but endorsements of your Modified Version by various
+parties--for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+</p><p>
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+</p><p>
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+</p><p>
+5. COMBINING DOCUMENTS
+</p><p>
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice.
+</p><p>
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+</p><p>
+In the combination, you must combine any sections entitled "History"
+in the various original documents, forming one section entitled
+"History"; likewise combine any sections entitled "Acknowledgements",
+and any sections entitled "Dedications".  You must delete all sections
+entitled "Endorsements."
+</p><p>
+6. COLLECTIONS OF DOCUMENTS
+</p><p>
+You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+</p><p>
+You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+</p><p>
+7. AGGREGATION WITH INDEPENDENT WORKS
+</p><p>
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, does not as a whole count as a Modified Version
+of the Document, provided no compilation copyright is claimed for the
+compilation.  Such a compilation is called an "aggregate", and this
+License does not apply to the other self-contained works thus compiled
+with the Document, on account of their being thus compiled, if they
+are not themselves derivative works of the Document.
+</p><p>
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one quarter
+of the entire aggregate, the Document's Cover Texts may be placed on
+covers that surround only the Document within the aggregate.
+Otherwise they must appear on covers around the whole aggregate.
+</p><p>
+8. TRANSLATION
+</p><p>
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License provided that you also include the
+original English version of this License.  In case of a disagreement
+between the translation and the original English version of this
+License, the original English version will prevail.
+</p><p>
+9. TERMINATION
+</p><p>
+You may not copy, modify, sublicense, or distribute the Document except
+as expressly provided for under this License.  Any other attempt to
+copy, modify, sublicense or distribute the Document is void, and will
+automatically terminate your rights under this License.  However,
+parties who have received copies, or rights, from you under this
+License will not have their licenses terminated so long as such
+parties remain in full compliance.
+</p><p>
+10. FUTURE REVISIONS OF THIS LICENSE
+</p><p>
+The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time.  Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.  See
+<a href="http://www.gnu.org/copyleft/" target="_top">http://www.gnu.org/copyleft</a>.
+</p><p>
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.
+</p><p>
+ADDENDUM: How to use this License for your documents
+</p><p>
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+</p><div class="blockquote"><blockquote class="blockquote"><p>
+      Copyright (c)  YEAR  YOUR NAME.
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the GNU Free Documentation License, Version 1.1
+      or any later version published by the Free Software Foundation;
+      with the Invariant Sections being LIST THEIR TITLES, with the
+      Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+      A copy of the license is included in the section entitled "GNU
+      Free Documentation License".
+</p></blockquote></div><p>
+If you have no Invariant Sections, write "with no Invariant Sections"
+instead of saying which ones are invariant.  If you have no
+Front-Cover Texts, write "no Front-Cover Texts" instead of
+"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
+</p><p>
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-gnu.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="license-common-public.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;G.&nbsp;Common Public License Version 1.0</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index d14f59f..48dd4f9 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="next" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-apache.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="license-gnu-doc.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-gnu"></a>Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991</h2></div></div><div></div></div><a class="indexterm" name="d0e7268"></a><a class="indexterm" name="d0e7271"></a><p>
+Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+</p><p>
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+</p><p>
+Preamble
+</p><p>
+The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+</p><p>
+When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+</p><p>
+To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+</p><p>
+For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+</p><p>
+We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+</p><p>
+Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+</p><p>
+Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+</p><p>
+The precise terms and conditions for copying, distribution and
+modification follow.
+</p><p>
+                   GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+</p><p>
+0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+</p><p>
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+</p><p>
+1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+</p><p>
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+</p><p>
+2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+</p><div class="blockquote"><blockquote class="blockquote"><p>
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+    </p><p>
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+    </p><p>
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+    </p></blockquote></div><p>
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+</p><p>
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+</p><p>
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+</p><p>
+3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+</p><div class="blockquote"><blockquote class="blockquote"><p>
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+    </p><p>    
     b) Accompany it with a written offer, valid for at least three
     years, to give any third party, for a charge no more than your
     cost of physically performing source distribution, a complete
index 62e881d..f60d7ed 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="next" href="bi01.html" title="Bibliography"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="license-common-public.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="bi01.html">Next</a></td></tr></table><hr></div><div class="appendix" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="license-sun-public"></a>Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0</h2></div></div><div></div></div><a class="indexterm" name="d0e7696"></a><a class="indexterm" name="d0e7699"></a><div class="orderedlist"><ol type="1"><li><p>
+Definitions.
+</p><div class="blockquote"><blockquote class="blockquote"><p>1.0.1. "Commercial Use" means distribution or otherwise making the Covered Code available to a third party.</p><p>1.1. "Contributor" means each entity that creates or contributes to the creation of Modifications.</p><p>1.2. "Contributor Version" means the combination of the Original Code, prior Modifications used by a Contributor, and the Modifications made by that particular Contributor.</p><p>1.3. "Covered Code" means the Original Code or Modifications or the combination of the Original Code and Modifications, in each case including portions thereof and corresponding documentation released with the source code.</p><p>1.4. "Electronic Distribution Mechanism" means a mechanism generally accepted in the software development community for the electronic transfer of data.</p><p>1.5. "Executable" means Covered Code in any form other than Source Code.</p><p>1.6. "Initial Developer" means the individual or entity identified as the Initial Developer in the Source Code notice required by Exhibit A.</p><p>1.7. "Larger Work" means a work which combines Covered Code or portions thereof with code not governed by the terms of this License.</p><p>1.8. "License" means this document.</p><p>1.8.1. "Licensable" means having the right to grant, to the maximum extent possible, whether at the time of the initial grant or subsequently acquired, any and all of the rights conveyed herein.</p><p>1.9. "Modifications" means any addition to or deletion from the substance or structure of either the Original Code or any previous Modifications. When Covered Code is released as a series of files, a Modification is:</p><div class="orderedlist"><ol type="A"><li><p>Any addition to or deletion from the contents of a file containing Original Code or previous Modifications.</p></li><li><p>Any new file that contains any part of the Original Code or previous Modifications.</p></li></ol></div><p>1.10. "Original Code"../ means Source Code of computer software code which is described in the Source Code notice required by Exhibit A as Original Code, and which, at the time of its release under this License is not already Covered Code governed by this License.</p><p>1.10.1. "Patent Claims" means any patent claim(s), now owned or hereafter acquired, including without limitation, method, process, and apparatus claims, in any patent Licensable by grantor.</p><p>1.11. "Source Code"../ means the preferred form of the Covered Code for making modifications to it, including all modules it contains, plus any associated documentation, interface definition files, scripts used to control compilation and installation of an Executable, or source code differential comparisons against either the Original Code or another well known, available Covered Code of the Contributor's choice. The Source Code can be in a compressed or archival form, provided the appropriate decompression or de-archiving software is widely available for no charge.</p><p>1.12. "You" (or "Your") means an individual or a legal entity exercising rights under, and complying with all of the terms of, this License or a future version of this License issued under Section 6.1. For legal entities, "You" includes any entity which controls, is controlled by, or is under common control with You. For purposes of this definition, "control"../ means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity.</p></blockquote></div></li><li><p>
+Source Code License.
+</p><div class="blockquote"><blockquote class="blockquote"><p>2.1 The Initial Developer Grant.</p><div class="blockquote"><blockquote class="blockquote"><p>The Initial Developer hereby grants You a world-wide, royalty-free, non-exclusive license, subject to third party intellectual property claims:</p><p>(a) under intellectual property rights (other than patent or trademark) Licensable by Initial Developer to use, reproduce, modify, display, perform, sublicense and distribute the Original Code (or portions thereof) with or without Modifications, and/or as part of a Larger Work; and</p><p>(b) under Patent Claims infringed by the making, using or selling of Original Code, to make, have made, use, practice, sell, and offer for sale, and/or otherwise dispose of the Original Code (or portions thereof).</p><p>(c) the licenses granted in this Section 2.1(a) and (b) are effective on the date Initial Developer first distributes Original Code under the terms of this License.</p><p>(d) Notwithstanding Section 2.1(b) above, no patent license is granted: 1) for code that You delete from the Original Code; 2) separate from the Original Code; or 3) for infringements caused by: i) the modification of the Original Code or ii) the combination of the Original Code with other software or devices.</p></blockquote></div><p>2.2. Contributor Grant.</p><div class="blockquote"><blockquote class="blockquote"><p>Subject to third party intellectual property claims, each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license</p><div class="blockquote"><blockquote class="blockquote"><p>(a) under intellectual property rights (other than patent or trademark) Licensable by Contributor, to use, reproduce, modify, display, perform, sublicense and distribute the Modifications created by such Contributor (or portions thereof) either on an unmodified basis, with other Modifications, as Covered Code and/or as part of a Larger Work; and</p><p>b) under Patent Claims infringed by the making, using, or selling of Modifications made by that Contributor either alone and/or in combination with its Contributor Version (or portions of such combination), to make, use, sell, offer for sale, have made, and/or otherwise dispose of: 1) Modifications made by that Contributor (or portions thereof); and 2) the combination of Modifications made by that Contributor with its Contributor Version (or portions of such combination).</p><p>(c) the licenses granted in Sections 2.2(a) and 2.2(b) are effective on the date Contributor first makes Commercial Use of the Covered Code.</p><p>(d) notwithstanding Section 2.2(b) above, no patent license is granted: 1) for any code that Contributor has deleted from the Contributor Version; 2) separate from the Contributor Version; 3) for infringements caused by: i) third party modifications of Contributor Version or ii) the combination of Modifications made by that Contributor with other software (except as part of the Contributor Version) or other devices; or 4) under Patent Claims infringed by Covered Code in the absence of Modifications made by that Contributor.</p></blockquote></div></blockquote></div></blockquote></div></li><li><p>Distribution Obligations.</p><div class="blockquote"><blockquote class="blockquote"><p>3.1. Application of License.</p><p>The Modifications which You create or to which You contribute are governed by the terms of this License, including without limitation Section 2.2. The Source Code version of Covered Code may be distributed only under the terms of this License or a future version of this License released under Section 6.1, and You must include a copy of this License with every copy of the Source Code You distribute. You may not offer or impose any terms on any Source Code version that alters or restricts the applicable version of this License or the recipients' rights hereunder. However, You may include an additional document offering the additional rights described in Section 3.5.</p><p>3.2. Availability of Source Code.</p><p>Any Modification which You create or to which You contribute must be made available in Source Code form under the terms of this License either on the same media as an Executable version or via an accepted Electronic Distribution Mechanism to anyone to whom you made an Executable version available; and if made available via Electronic Distribution Mechanism, must remain available for at least twelve (12) months after the date it initially became available, or at least six (6) months after a subsequent version of that particular Modification has been made available to such recipients. You are responsible for ensuring that the Source Code version remains available even if the Electronic Distribution Mechanism is maintained by a third party.</p><p>3.3. Description of Modifications.</p><p>You must cause all Covered Code to which You contribute to contain a file documenting the changes You made to create that Covered Code and the date of any change. You must include a prominent statement that the Modification is derived, directly or indirectly, from Original Code provided by the Initial Developer and including the name of the Initial Developer in (a) the Source Code, and (b) in any notice in an Executable version or related documentation in which You describe the origin or ownership of the Covered Code.</p><p>3.4. Intellectual Property Matters.</p><div class="blockquote"><blockquote class="blockquote"><p>(a) Third Party Claims. If Contributor has knowledge that a license under a third party's intellectual property rights is required to exercise the rights granted by such Contributor under Sections 2.1 or 2.2, Contributor must include a text file with the Source Code distribution titled "../LEGAL'' which describes the claim and the party making the claim in sufficient detail that a recipient will know whom to contact. If Contributor obtains such knowledge after the Modification is made available as described in Section 3.2, Contributor shall promptly modify the LEGAL file in all copies Contributor makes available thereafter and shall take other steps (such as notifying appropriate mailing lists or newsgroups) reasonably calculated to inform those who received the Covered Code that new knowledge has been obtained.</p><p>(b) Contributor APIs.</p><p>If Contributor's Modifications include an application programming interface ("API"../) and Contributor has knowledge of patent licenses which are reasonably necessary to implement that API, Contributor must also include this information in the LEGAL file.</p><p>(c) Representations.</p><p>Contributor represents that, except as disclosed pursuant to Section 3.4(a) above, Contributor believes that Contributor's Modifications are Contributor's original creation(s) and/or Contributor has sufficient rights to grant the rights conveyed by this License.</p><p>3.5. Required Notices.</p><p>You must duplicate the notice in Exhibit A in each file of the Source Code. If it is not possible to put such notice in a particular Source Code file due to its structure, then You must include such notice in a location (such as a relevant directory) where a user would be likely to look for such a notice. If You created one or more Modification(s) You may add your name as a Contributor to the notice described in Exhibit A. You must also duplicate this License in any documentation for the Source Code where You describe recipients' rights or ownership rights relating to Covered Code. You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Covered Code. However, You may do so only on Your own behalf, and not on behalf of the Initial Developer or any Contributor. You must make it absolutely clear than any such warranty, support, indemnity or liability obligation is offered by You alone, and You hereby agree to indemnify the Initial Developer and every Contributor for any liability incurred by the Initial Developer or such Contributor as a result of warranty, support, indemnity or liability terms You offer.</p><p>3.6. Distribution of Executable Versions.</p><p>You may distribute Covered Code in Executable form only if the requirements of Section 3.1-3.5 have been met for that Covered Code, and if You include a notice stating that the Source Code version of the Covered Code is available under the terms of this License, including a description of how and where You have fulfilled the obligations of Section 3.2. The notice must be conspicuously included in any notice in an Executable version, related documentation or collateral in which You describe recipients' rights relating to the Covered Code. You may distribute the Executable version of Covered Code or ownership rights under a license of Your choice, which may contain terms different from this License, provided that You are in compliance with the terms of this License and that the license for the Executable version does not attempt to limit or alter the recipient's rights in the Source Code version from the rights set forth in this License. If You distribute the Executable version under a different license You must make it absolutely clear that any terms which differ from this License are offered by You alone, not by the Initial Developer or any Contributor. You hereby agree to indemnify the Initial Developer and every Contributor for any liability incurred by the Initial Developer or such Contributor as a result of any such terms You offer.</p><p>3.7. Larger Works.</p><p>You may create a Larger Work by combining Covered Code with other code not governed by the terms of this License and distribute the Larger Work as a single product. In such a case, You must make sure the requirements of this License are fulfilled for the Covered Code.</p></blockquote></div></blockquote></div></li><li><p>Inability to Comply Due to Statute or Regulation.</p><p>
+If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Code due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be included in the LEGAL file described in Section 3.4 and must be included with all distributions of the Source Code. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it.
+</p></li><li><p>Application of this License.</p><p>
+This License applies to code to which the Initial Developer has attached the notice in Exhibit A and to related Covered Code.
+</p></li><li><p>Versions of the License.</p><div class="blockquote"><blockquote class="blockquote"><p>6.1. New Versions.</p><p>Sun Microsystems, Inc. ("Sun") may publish revised and/or new versions of the License from time to time. Each version will be given a distinguishing version number. </p><p>6.2. Effect of New Versions.</p><p>Once Covered Code has been published under a particular version of the License, You may always continue to use it under the terms of that version. You may also choose to use such Covered Code under the terms of any subsequent version of the License published by Sun. No one other than Sun has the right to modify the terms applicable to Covered Code created under this License.</p><p>6.3. Derivative Works.</p><p>If You create or use a modified version of this License (which you may only do in order to apply it to code which is not already Covered Code governed by this License), You must: (a) rename Your license so that the phrases "Sun," "Sun Public License," or "SPL"../ or any confusingly similar phrase do not appear in your license (except to note that your license differs from this License) and (b) otherwise make it clear that Your version of the license contains terms which differ from the Sun Public License. (Filling in the name of the Initial Developer, Original Code or Contributor in the notice described in Exhibit A shall not of themselves be deemed to be modifications of this License.)</p></blockquote></div></li><li><p>DISCLAIMER OF WARRANTY.</p><p>COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "../AS IS'' BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED CODE IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.</p></li><li><p>TERMINATION.</p><p>8.1. This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such breach within 30 days of becoming aware of the breach. All sublicenses to the Covered Code which are properly granted shall survive any termination of this License. Provisions which, by their nature, must remain in effect beyond the termination of this License shall survive.</p><p>8.2. If You initiate litigation by asserting a patent infringement claim (excluding declaratory judgment actions) against Initial Developer or a Contributor (the Initial Developer or Contributor against whom You file such action is referred to as "Participant") alleging that:</p><div class="blockquote"><blockquote class="blockquote"><p>(a) such Participant's Contributor Version directly or indirectly infringes any patent, then any and all rights granted by such Participant to You under Sections 2.1 and/or 2.2 of this License shall, upon 60 days notice from Participant terminate prospectively, unless if within 60 days after receipt of notice You either: (i) agree in writing to pay Participant a mutually agreeable reasonable royalty for Your past and future use of Modifications made by such Participant, or (ii) withdraw Your litigation claim with respect to the Contributor Version against such Participant. If within 60 days of notice, a reasonable royalty and payment arrangement are not mutually agreed upon in writing by the parties or the litigation claim is not withdrawn, the rights granted by Participant to You under Sections 2.1 and/or 2.2 automatically terminate at the expiration of the 60 day notice period specified above.</p><p>(b) any software, hardware, or device, other than such Participant's Contributor Version, directly or indirectly infringes any patent, then any rights granted to You by such Participant under Sections 2.1(b) and 2.2(b) are revoked effective as of the date You first made, used, sold, distributed, or had made, Modifications made by that Participant.</p></blockquote></div><p>8.3. If You assert a patent infringement claim against Participant alleging that such Participant's Contributor Version directly or indirectly infringes any patent where such claim is resolved (such as by license or settlement) prior to the initiation of patent infringement litigation, then the reasonable value of the licenses granted by such Participant under Sections 2.1 or 2.2 shall be taken into account in determining the amount or value of any payment or license.</p><p>8.4. In the event of termination under Sections 8.1 or 8.2 above, all end user license agreements (excluding distributors and resellers) which have been validly granted by You or any distributor hereunder prior to termination shall survive termination.</p></li><li><p>LIMITATION OF LIABILITY.</p><p>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED CODE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND LIMITATION MAY NOT APPLY TO YOU.</p></li><li><p>U.S. GOVERNMENT END USERS.
+</p><p>The Covered Code is a "commercial item," as that term is defined in 48 C.F.R. 2.101 (Oct. 1995), consisting of "commercial computer software" and "commercial computer software documentation,"../ as such terms are used in 48 C.F.R. 12.212 (Sept. 1995). Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995), all U.S. Government End Users acquire Covered Code with only those rights set forth herein.</p></li><li><p>MISCELLANEOUS.
+</p><p>This License represents the complete agreement concerning subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This License shall be governed by California law provisions (except to the extent applicable law, if any, provides otherwise), excluding its conflict-of-law provisions. With respect to disputes in which at least one party is a citizen of, or an entity chartered or registered to do business in the United States of America, any litigation relating to this License shall be subject to the jurisdiction of the Federal Courts of the Northern District of California, with venue lying in Santa Clara County, California, with the losing party responsible for costs, including without limitation, court costs and reasonable attorneys' fees and expenses. The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not apply to this License.</p></li><li><p>RESPONSIBILITY FOR CLAIMS.</p><p>As between Initial Developer and the Contributors, each party is responsible for claims and damages arising, directly or indirectly, out of its utilization of rights under this License and You agree to work with Initial Developer and Contributors to distribute such responsibility on an equitable basis. Nothing herein is intended or shall be deemed to constitute any admission of liability.</p></li><li><p>MULTIPLE-LICENSED CODE.</p><p>Initial Developer may designate portions of the Covered Code as ?Multiple-Licensed?. ?Multiple-Licensed? means that the Initial Developer permits you to utilize portions of the Covered Code under Your choice of the alternative licenses, if any, specified by the Initial Developer in the file described in Exhibit A.</p></li></ol></div><p>Exhibit A - Sun Public License Notice.</p><div class="blockquote"><blockquote class="blockquote"><p>The contents of this file are subject to the Sun Public License
+Version 1.0 (the License); you may not use this file except in
+compliance with the License. A copy of the License is available at
+http://www.sun.com/
+</p><p>The Original Code is _________________. The Initial Developer of the
+Original Code is ___________. Portions created by ______ are Copyright
+(C)_________. All Rights Reserved.</p><p>Contributor(s): ______________________________________.</p><p>Alternatively, the contents of this file may be used under the terms
+of the _____ license (the ?[___] License?), in which case the
+provisions of [______] License are applicable instead of those above.
+If you wish to allow use of your version of this file only under the
+terms of the [____] License and not to allow others to use your
+version of this file under the SPL, indicate your decision by deleting
+the provisions above and replace them with the notice and other
+provisions required by the [___] License. If you do not delete the
+provisions above, a recipient may use your version of this file under
+either the SPL or the [___] License.</p><p>[NOTE: The text of this Exhibit A may differ slightly from the text of
+the notices in the Source Code files of the Original Code. You should
+use the text of this Exhibit A rather than the text found in the
+Original Code Source Code for Your Modifications.]</p></blockquote></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="license-common-public.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="bi01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;G.&nbsp;Common Public License Version 1.0&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Bibliography</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..aec22d8 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Links</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="integrator"></a>Integrators</h2></div></div><div></div></div><div class="blockquote"><blockquote class="blockquote"><div class="informaltable"><table cellspacing="0" cellpadding="2" width="100%" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr valign="top"><td style="" valign="top"><a href="http://koalagml.sf.net/" target="_top">koalaGML</a></td><td style="" valign="top">Java/Swing Code Generator</td></tr><tr valign="top"><td style="" valign="top"><a href="http://openuss.sourceforge.net/" target="_top">OpenUSS</a></td><td style="" valign="top">J2EE-based E-Learning platform</td></tr><tr valign="top"><td style="" valign="top"><a href="http://www.informatikatelier.com/" target="_top">FormsWizard, PLSQLWizard</a></td><td style="" valign="top">Translators for Oracle applications to Java (commercial)</td></tr></tbody></table></div></blockquote></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="open-source"></a>Related Open Source projects</h2></div></div><div></div></div><div class="blockquote"><blockquote class="blockquote"><div class="informaltable"><table cellspacing="0" cellpadding="2" width="100%" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr valign="top"><td style="" valign="top"><a href="http://astyle.sf.net/" target="_top">Artistic Style</a></td><td style="" valign="top">Java Source Code Indentation Filter</td></tr><tr valign="top"><td style="" valign="top"><a href="http://sf.net/projects/barat/" target="_top">Barat</a></td><td style="" valign="top">Code Parser/Analyser</td></tr><tr valign="top"><td style="" valign="top"><a href="http://checkstyle.sf.net/" target="_top">CheckStyle</a></td><td style="" valign="top">Java Coding Convention Checker</td></tr><tr valign="top"><td style="" valign="top"><a href="http://importscrubber.sf.net/" target="_top">ImportScrubber</a></td><td style="" valign="top">Java Import Optimizer</td></tr><tr valign="top"><td style="" valign="top"><a href="http://www.tiobe.com/jacobe.htm" target="_top">Jacobe</a></td><td style="" valign="top">Java Source Code Formatter (not Open Source, but free)</td></tr><tr valign="top"><td style="" valign="top"><a href="http://jcsc.sf.net/" target="_top">JCSC</a></td><td style="" valign="top">Java Coding Style Checker</td></tr><tr valign="top"><td style="" valign="top"><a href="http://jrefactory.sf.net/" target="_top">JRefactory</a></td><td style="" valign="top">Java Refactoring Tool</td></tr><tr valign="top"><td style="" valign="top"><a href="http://mozart-dev.sf.net/" target="_top">Mozart Development Environment</a></td><td style="" valign="top">Framework for user extensible compilers and development tools</td></tr><tr valign="top"><td style="" valign="top"><a href="http://pmd.sf.net/" target="_top">PMD</a></td><td style="" valign="top">Java source code analyser/checker</td></tr><tr valign="top"><td style="" valign="top"><a href="http://qdox.sf.net/" target="_top">QDox</a></td><td style="" valign="top">Framework for extracting class/interface/method definitions</td></tr><tr valign="top"><td style="" valign="top"><a href="http://recoder.sf.net/" target="_top">Recoder</a></td><td style="" valign="top">Source Code Metaprogramming Framework</td></tr><tr valign="top"><td style="" valign="top"><a href="http://www.serc.nl/people/florijn/work/designchecking/RevJava.htm" target="_top">RevJava</a></td><td style="" valign="top">Review assistant for Java programs</td></tr><tr valign="top"><td style="" valign="top"><a href="http://transmogrify.sf.net/" target="_top">Transmogrify</a></td><td style="" valign="top">Java Refactoring Tool</td></tr></tbody></table></div></blockquote></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="commercial"></a>Related commercial projects</h2></div></div><div></div></div><div class="blockquote"><blockquote class="blockquote"><div class="informaltable"><table cellspacing="0" cellpadding="2" width="100%" border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><tbody><tr valign="top"><td style="" valign="top"><a href="http://www.jenssoft.com/" target="_top">CodeCompanion</a></td><td style="" valign="top">Java Coding Convention Checker</td></tr><tr valign="top"><td style="" valign="top"><a href="http://www.jindent.com/" target="_top">Jindent</a></td><td style="" valign="top">Java Source Code Formatter</td></tr></tbody></table></div></blockquote></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="convention"></a>Code Conventions and Style Guides</h2></div></div><div></div></div><div class="blockquote"><blockquote class="blockquote"><table class="simplelist" border="0" summary="Simple list"><tr><td>
+<a href="http://www.ambysoft.com/javaCodingStandards.html" target="_top">AmbySoft Coding Standards for Java</a>
+</td></tr><tr><td>
+<a href="http://geosoft.no/javastyle.html" target="_top">Geosoft Java Programming Style Guidelines</a>
+</td></tr><tr><td>
+<a href="http://www.javaranch.com/style.jsp" target="_top">JavaRanch Java Programming Style Guide</a>
+</td></tr><tr><td>
+<a href="http://www.infospheres.caltech.edu/resources/code_standards/java_standard.html" target="_top">Infospheres Java Coding Standard</a>
+</td></tr><tr><td>
+<a href="http://developer.netscape.com/docs/technote/java/codestyle.html" target="_top">Netscape's Software Coding Standards for Java</a>
+</td></tr><tr><td>
+<a href="http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html" target="_top">Sun Java Code Convention</a>
+</td></tr></table></blockquote></div></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..a571a21 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy User Manual</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="next" href="dedication.html" title="Dedication"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Jalopy User Manual</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="dedication.html">Next</a></td></tr></table><hr></div><div class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Jalopy User Manual</h1></div><div><p class="copyright">Copyright &copy; 2004 Marco Hunsicker</p></div><div><div class="legalnotice"><p class="legalnotice-title"><b>Legal Notice</b></p><p>
+Permission is granted to copy, distribute and/or modify this document under
+the terms of the GNU Free Documentation License, Version 1.1 or any later
+version published by the Free Software Foundation; with no "Invariant Sections",
+"Front-Cover Texts" or "Back-Cover Texts", each as defined in the license.
+</p><p>
+For a copy of the license terms refer to <a href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000">Appendix&nbsp;F, <i>GNU Free Documentation License Version 1.1, March 2000</i></a>.
+</p></div></div></div><div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><ul><li><span class="preface"><a href="dedication.html">Dedication</a></span></li><li><span class="preface"><a href="acknowledge.html">Acknowledgements</a></span></li><li><span class="preface"><a href="introduction.html">Introduction</a></span></li><li><span class="part"><a href="part-core.html">I. Jalopy core</a></span><ul><li><span class="chapter"><a href="installation.html">1. Installation</a></span></li><li><span class="chapter"><a href="build.html">2. Building</a></span></li><li><span class="chapter"><a href="usage.html">3. Usage</a></span></li><li><span class="chapter"><a href="settings.html">4. Settings</a></span><ul><li><span class="sect1"><a href="settings.html#general">4.1. General</a></span><ul><li><span class="sect2"><a href="settings.html#general-convention">4.1.1. Convention</a></span></li><li><span class="sect2"><a href="settings.html#general-compliance">4.1.2. Compliance</a></span></li><li><span class="sect2"><a href="settings.html#import-export">4.1.3. Import/Export</a></span></li></ul></li><li><span class="sect1"><a href="project.html">4.2. Projects</a></span></li><li><span class="sect1"><a href="printer.html">4.3. Printer</a></span><ul><li><span class="sect2"><a href="printer.html#braces">4.3.1. Braces</a></span></li><li><span class="sect2"><a href="whitespace.html">4.3.2. White Space</a></span></li><li><span class="sect2"><a href="indentation.html">4.3.3. Indentation</a></span></li><li><span class="sect2"><a href="wrapping.html">4.3.4. Line Wrapping</a></span></li><li><span class="sect2"><a href="separation.html">4.3.5. Blank Lines</a></span></li><li><span class="sect2"><a href="comments.html">4.3.6. Comments</a></span></li><li><span class="sect2"><a href="imports.html">4.3.7. Imports</a></span></li><li><span class="sect2"><a href="environment.html">4.3.8. Environment</a></span></li><li><span class="sect2"><a href="javadoc.html">4.3.9. Javadoc</a></span></li><li><span class="sect2"><a href="header.html">4.3.10. Header</a></span></li><li><span class="sect2"><a href="footer.html">4.3.11. Footer</a></span></li><li><span class="sect2"><a href="sorting.html">4.3.12. Sorting</a></span></li><li><span class="sect2"><a href="misc.html">4.3.13. Misc</a></span></li></ul></li><li><span class="sect1"><a href="inspector.html">4.4. Code Inspector</a></span><ul><li><span class="sect2"><a href="inspector.html#d0e5095">4.4.1. General</a></span></li><li><span class="sect2"><a href="inspector-naming.html">4.4.2. Naming</a></span></li></ul></li><li><span class="sect1"><a href="messages.html">4.5. Messages</a></span></li></ul></li></ul></li><li><span class="part"><a href="part-plugins.html">II. Plug-ins</a></span><ul><li><span class="chapter"><a href="plugin-ant.html">5. Ant Plug-in task</a></span><ul><li><span class="sect1"><a href="plugin-ant.html#plugin-ant-installation">5.1. Installation</a></span><ul><li><span class="sect2"><a href="plugin-ant.html#plugin-ant-installation-requirements">5.1.1. System requirements</a></span></li><li><span class="sect2"><a href="plugin-ant.html#plugin-ant-installation-installation">5.1.2. Installation</a></span></li></ul></li><li><span class="sect1"><a href="plugin-ant-config.html">5.2. Configuration</a></span></li><li><span class="sect1"><a href="plugin-ant-usage.html">5.3. Usage</a></span></li><li><span class="sect1"><a href="plugin-ant-license.html">5.4. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-console.html">6. Console Application</a></span><ul><li><span class="sect1"><a href="plugin-console.html#plugin-console-installation">6.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-console-usage.html">6.2. Usage</a></span></li><li><span class="sect1"><a href="plugin-console-license.html">6.3. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-eclipse.html">7. Eclipse Plug-in</a></span><ul><li><span class="sect1"><a href="plugin-eclipse.html#plugin-eclipse-installation">7.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-eclipse-integration.html">7.2. Integration</a></span></li><li><span class="sect1"><a href="plugin-eclipse-license.html">7.3. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-jbuilder.html">8. JBuilder OpenTool</a></span><ul><li><span class="sect1"><a href="plugin-jbuilder.html#plugin-jbuilder-installation">8.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-jbuilder-integration.html">8.2. Integration</a></span></li><li><span class="sect1"><a href="plugin-jbuilder-license.html">8.3. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-jdev.html">9. JDeveloper Extension</a></span><ul><li><span class="sect1"><a href="plugin-jdev.html#plugin-jdev-installation">9.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-jdev-integration.html">9.2. Integration</a></span></li><li><span class="sect1"><a href="plugin-jdev-license.html">9.3. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-jedit.html">10. jEdit Plug-in</a></span><ul><li><span class="sect1"><a href="plugin-jedit.html#plugin-jedit-installation">10.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-jedit-integration.html">10.2. Integration</a></span></li><li><span class="sect1"><a href="plugin-jedit-license.html">10.3. License</a></span></li></ul></li><li><span class="chapter"><a href="plugin-netbeans.html">11. NetBeans/Sun ONE Studio module</a></span><ul><li><span class="sect1"><a href="plugin-netbeans.html#plugin-netbeans-installation">11.1. Installation</a></span></li><li><span class="sect1"><a href="plugin-netbeans-integration.html">11.2. Integration</a></span></li><li><span class="sect1"><a href="plugin-netbeans-license.html">11.3. License</a></span></li></ul></li></ul></li><li><span class="appendix"><a href="dependencies.html">A. Library Dependencies</a></span></li><li><span class="appendix"><a href="license-bsd.html">B. The Jalopy BSD License</a></span></li><li><span class="appendix"><a href="license-antlr.html">C. ANTLR SOFTWARE RIGHTS</a></span></li><li><span class="appendix"><a href="license-apache.html">D. The Apache Software License, Version 1.1</a></span></li><li><span class="appendix"><a href="license-gnu.html">E. GNU GENERAL PUBLIC LICENSE Version 2, June 1991</a></span></li><li><span class="appendix"><a href="license-gnu-doc.html">F. GNU Free Documentation License Version 1.1, March 2000</a></span></li><li><span class="appendix"><a href="license-common-public.html">G. Common Public License Version 1.0</a></span></li><li><span class="appendix"><a href="license-sun-public.html">H. SUN PUBLIC LICENSE Version 1.0</a></span></li><li><span class="bibliography"><a href="bi01.html">Bibliography</a></span></li><li><span class="index"><a href="ix01.html">Index</a></span></li></ul></div><div class="list-of-tables"><p><b>List of Tables</b></p><ul><li>2.1. <a href="build.html#tab-build-prerequisites">Software needed to build from the sources</a></li><li>4.1. <a href="environment.html#tab-environment-local">Local environment variables</a></li><li>4.2. <a href="javadoc.html#tab-character-entities">Character entities</a></li><li>5.1. <a href="plugin-ant-usage.html#tab-ant-params">Jalopy Ant task parameters</a></li><li>A.1. <a href="dependencies.html#tab-library-dependencies">Library dependencies</a></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="dedication.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right" valign="top">&nbsp;Dedication</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..ede8c34 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.5.&nbsp;Messages</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="previous" href="inspector-naming.html" title="4.4.2.&nbsp;Naming"><link rel="next" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="messages.html#messages-categories" title="4.5.1.&nbsp;Categories"><link rel="subsection" href="messages.html#messsages-misc" title="4.5.2.&nbsp;Misc">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.5.&nbsp;Messages</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inspector-naming.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;4.&nbsp;Settings</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="part-plugins.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="messages"></a>4.5.&nbsp;Messages</h2></div></div><div></div></div><p>
+Controls the Jalopy message output.
+</p><p>
+Given the sensitive nature of automatic source code processing, it is quite
+important to keep informed about what is going on during the formatting process.
+The default configuration should be sufficient for most users, so there should
+seldom arise the need to change anything here.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="messages-categories"></a>4.5.1.&nbsp;Categories</h4></div></div><div></div></div><p>
+Jalopy provides different message categories for setting verbosity level.
+Changing the threshold from <b class="userinput"><tt>ERROR</tt></b> to <b class="userinput"><tt>DEBUG</tt></b>
+successively displays more (albeit not necessarily more useful) messages.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+General
+</p><p>
+General purpose chain for I/O activity and all sorts of stuff that doesn't fit
+elsewhere.
+</p></li><li><p>
+Parsing
+</p><p>
+Message chain for messages related to the Java language parser.
+</p></li><li><p>
+Javadoc parsing
+</p><p>
+Message chain for messages related to the parsing of Javadoc comments.
+</p></li><li><p>
+Transforming
+</p><p>
+Message chain for messages related to the post-processing of the generated AST.
+</p></li><li><p>
+Printing
+</p><p>
+Message chain for the main printing engine.
+</p></li><li><p>
+Javadoc Printing
+</p><p>
+Message chain for Javadoc printing related messages.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="messsages-misc"></a>4.5.2.&nbsp;Misc</h4></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>
+Show stacktrace
+</p><p>
+Enables or disables the inclusion of the current execution stack trace with
+error messages. This proves useful in case you need to file a bug report as it
+reveals the source of the error.
+</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inspector-naming.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="settings.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="part-plugins.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.4.2.&nbsp;Naming&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Part&nbsp;II.&nbsp;Plug-ins</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..8534439 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.13.&nbsp;Misc</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="sorting.html" title="4.3.12.&nbsp;Sorting"><link rel="next" href="inspector.html" title="4.4.&nbsp;Code Inspector"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="misc.html#misc-misc" title="4.3.13.1.&nbsp;Misc"><link rel="subsection" href="misc.html#misc-history" title="4.3.13.2.&nbsp;History"><link rel="subsection" href="misc.html#misc-backup" title="4.3.13.3.&nbsp;Backup"><link rel="subsection" href="misc.html#misc-threads" title="4.3.13.4.&nbsp;Threads">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.13.&nbsp;Misc</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sorting.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="inspector.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="misc"></a>4.3.13.&nbsp;Misc</h3></div></div><div></div></div><p>
+Lets you control miscellaneous settings that doesn't fit elsewhere.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="misc-misc"></a>4.3.13.1.&nbsp;Misc</h4></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p><a name="paren-add"></a>
+Insert expression parentheses
+</p><a class="indexterm" name="d0e4907"></a><a class="indexterm" name="d0e4912"></a><p>
+It is always good advise to use more parentheses than you think you need. They
+may not be needed, but they add clarity and don't cost anything.
+</p><div class="example"><a name="ex-misc-expr"></a><p class="title"><b>Example&nbsp;4.150.&nbsp;How is this expression evaluated?</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int result = 12 + 4 % 3 * 7 / 8;
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-misc-expr-continued"></a><p class="title"><b>Example&nbsp;4.151.&nbsp;How is this expression evaluated? (continued)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int result = 12 + ((4 % 3 * 7) / 8);
+</pre></td></tr></table></div><p></p></li><li><p><a name="misc-insert-uid"></a>
+Insert serial version UID
+</p><a class="indexterm" name="d0e4932"></a><p>
+Common sense dictates to declare an explicit serial version UID in every
+serializable class to eliminate the serial version UID as a potential source
+of incompatibility (with the additional benefit of a small performance gain).
+If this switch is enabled and the class directly dereives from either
+<tt class="filename">java.io.Serializable</tt> or <tt class="filename">java.io.Externalizable</tt>,
+Jalopy computes and inserts a serial version UID for the class.
+</p><p>
+For this feature to work, the class that has its serial version UID computed
+needs to be available on the classpath.
+</p></li><li><p><a name="misc-logging-conditional"></a>
+Insert logging conditional
+</p><p>
+Typically, logging systems have a method that submits a logging message like
+
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+logger.debug("some message: " + someVar);
+</pre></td></tr></table><p>
+</p><p>
+This is fine, but if the debug level is set such that this message will
+<span class="emphasis"><em>NOT</em></span> display, then time is wasted doing the string marshalling.
+</p><p>
+Thus, the preferred way to do this is
+
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+if (logger.isDebugEnabled()) {
+    logger.debug("some message: " + someVar);
+}
+</pre></td></tr></table><p>
+
+which will only use CPU time if the log message is needed. Enabling this switch
+will ensure that every logging call with the debug level set will be enclosed with
+the conditional expression.
+</p><p>
+Use this feature with care! The current implementation only supports the Jakarta
+Log4J toolkit and is somewhat weak in that every method call called
+<i class="firstterm">debug</i> is treated as a logging call which could be incorrect
+in your application. However, it works fine for the <i class="firstterm">l7dlog</i> calls.
+</p></li><li><p><a name="misc-trailing-newline"></a>
+Insert trailing newline
+</p><p>
+If enabled, Jalopy inserts an empty line at the end of every file. This may
+help to avoid problems with certain text formatters and processors.
+</p><p>
+Note that Jalopy always inserts at least one empty line after footers, so there
+is no real need (but it doesn't hurt) to check the mark in case footer insertion
+will be performed (see <a href="footer.html" title="4.3.11.&nbsp;Footer">Section&nbsp;4.3.11, &#8220;Footer&#8221;</a>)
+</p></li><li><p><a name="misc-array-brackets"></a>
+Array brackets after identifiers
+</p><p>
+Lets you choose where the brackets of array types should be placed.
+</p><p>
+By default, Jalopy prints the square brackets right after the array type.
+</p><div class="example"><a name="ex-misc-array-brackets"></a><p class="title"><b>Example&nbsp;4.152.&nbsp;Array brackets after type</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int[] a;
+</pre></td></tr></table></div><p>
+But C/C++ programmers may expect them to appear after the identifier.
+</p><div class="example"><a name="ex-misc-array-brackets-identifier"></a><p class="title"><b>Example&nbsp;4.153.&nbsp;Array brackets after identifier</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int a[];
+</pre></td></tr></table></div><p></p></li><li><p>
+Force formatting
+</p><p>
+Jalopy can keep track of which files have been formatted previously.
+See <a href="misc.html#misc-history" title="4.3.13.2.&nbsp;History">Section&nbsp;4.3.13.2, &#8220;History&#8221;</a> below. If History is enabled, Jalopy will
+exclude files that have a modification date coincident with the last formatting.
+However, you can override this history check to force a format. For example,
+you might need to update the copyright notice for the whole code base. Enabling
+this switch ensures that all source files are always be formatted. Note that
+this switch is only meaningful if the history feature is enabled.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="misc-history"></a>4.3.13.2.&nbsp;History</h4></div></div><div></div></div><a class="indexterm" name="d0e5010"></a><p>
+The history feature offers a way to optimize the speed at which Jalopy processes
+of a group of files repeatedly. Using history, Jalopy is able to track file
+modifications between successive invocations, and only format those source
+files which have actually changed, or which weren't processed previously.
+This can save a huge amount of execution time for a project that is formatted
+repeatedly over time. There are two methods for keeping history.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="history-file"></a>
+Use history file
+</p><a class="indexterm" name="d0e5019"></a><a class="indexterm" name="d0e5024"></a><p>
+If you can't get along with a history header comment at the top of each source
+file, but would like historical optimization, the file-based approach may work
+for you. The history information of previous formatting will be saved in a file
+<tt class="filename">history.dat</tt> under the Jalopy settings directory.
+</p><p>
+Note that this file will grow over time, especially if one manages several big
+projects. So the history file could become quite huge. As all history entries
+are read into memory at startup, it could eat up quite a bit of memory space.
+Therefore a little history viewer is provided which enables you to selectively
+remove obsolete entries.
+</p><p>
+In order to effectively use formatting of a project with several developers it is
+nice to be able to only format files which have changed. There are three methods of
+working out if a file has changed provided in a drop down. Timestamp will use the
+modification time of the file, this does not work very well with source control
+and multiple developers. There are two standard checksums available. These
+work by taking a checksum of the file and comparing it to the one in the history file.
+If this checksum is different, the file is parsed and formatted in memory and a new
+checksum calculated. If the new checksum is different than the checksum for the
+unformatted file, it is written to disk. This stops files that have just been updated
+from source control from having being formatted (and timestamps updated).
+</p><p>
+Use the <span><b class="guibutton">View...</b></span> button to display the history viewer. You
+can selectively remove entries via the popup menu.
+</p></li><li><p><a name="history-comment"></a>
+Use history comments
+</p><a class="indexterm" name="d0e5044"></a><a class="indexterm" name="d0e5049"></a><a class="indexterm" name="d0e5054"></a><p>
+Jalopy will insert a small comment in the first line of every source file.
+The comment encodes the time a file was last formatted along with the package
+name of the file. This method is precise and relatively foolproof but does not work well
+with SCM tools.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="misc-backup"></a>4.3.13.3.&nbsp;Backup</h4></div></div><div></div></div><p>
+For security reasons Jalopy creates a backup copy of the currently
+processed file so it can be restored in case a severe error occured during the
+formatting process. The original file is stored in the backup directory and normally
+deleted after the newly formatted file has been successfully written.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Level
+</p><p>
+The backup level defines how many numbered backups should be retained (up to 30).
+The default is to never hold any backups.
+</p></li><li><p>
+Directory
+</p><p>
+Specifies where file backups are stored. You should leave this setting untouched
+in order to make your code convention portable across different systems and platforms.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="misc-threads"></a>4.3.13.4.&nbsp;Threads</h4></div></div><div></div></div><p>
+Jalopy, more precisely the provided Plug-ins, are multi-threaded. On
+multi-processor systems the work can be divided onto several processors to
+speed up processing.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Number
+</p><p>
+Specifies the number of processing threads to be used. This setting should be
+equal to the number of processors your system has.
+</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sorting.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="inspector.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.12.&nbsp;Sorting&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.4.&nbsp;Code Inspector</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..1340c78 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Part&nbsp;I.&nbsp;Jalopy core</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="introduction.html" title="Introduction"><link rel="next" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Part&nbsp;I.&nbsp;Jalopy core</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="introduction.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="installation.html">Next</a></td></tr></table><hr></div><div class="part" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="part-core"></a>Jalopy core</h1></div></div><div></div></div><div class="partintro" lang="en"><div><div></div><div></div></div><p>
+This part of the manual covers the core Jalopy engine: generic installation and
+usage instructions along with a detailed discussion of the available switches
+to customize application behavior and formatting output.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="introduction.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="installation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Introduction&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;1.&nbsp;Installation</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..9ddbeaf 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Part&nbsp;II.&nbsp;Plug-ins</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="manual.html" title="Jalopy User Manual"><link rel="previous" href="messages.html" title="4.5.&nbsp;Messages"><link rel="next" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Part&nbsp;II.&nbsp;Plug-ins</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="messages.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-ant.html">Next</a></td></tr></table><hr></div><div class="part" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="part-plugins"></a>Plug-ins</h1></div></div><div></div></div><div class="partintro" lang="en"><div><div></div><div></div></div><p>
+This part of the manual covers the different Plug-ins available.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="messages.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-ant.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.5.&nbsp;Messages&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;5.&nbsp;Ant Plug-in task</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..c8f1bea 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>5.2.&nbsp;Configuration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="previous" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="next" href="plugin-ant-usage.html" title="5.3.&nbsp;Usage"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.2.&nbsp;Configuration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-ant.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;5.&nbsp;Ant Plug-in task</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-usage.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-ant-config"></a>5.2.&nbsp;Configuration</h2></div></div><div></div></div><p>
+To display the settings dialog you should use the provided wrapper script for
+your platform (available in the <tt class="filename">/bin</tt> folder of the distribution).
+</p><p>
+Of course, you can setup the classpath yourself by adding all
+<tt class="filename">.jar</tt> files as usual to the classpath and then type
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+java Preferences
+</pre></td></tr></table><p></p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-ant.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-ant.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-usage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;5.&nbsp;Ant Plug-in task&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;5.3.&nbsp;Usage</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..e1cdd0e 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>5.4.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="previous" href="plugin-ant-usage.html" title="5.3.&nbsp;Usage"><link rel="next" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.4.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-ant-usage.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;5.&nbsp;Ant Plug-in task</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-console.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-ant-license"></a>5.4.&nbsp;License</h2></div></div><div></div></div><p>
+The Ant Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a BSD license.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-ant-usage.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-ant.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-console.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.3.&nbsp;Usage&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;6.&nbsp;Console Application</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..24b1cf3 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>5.3.&nbsp;Usage</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="previous" href="plugin-ant-config.html" title="5.2.&nbsp;Configuration"><link rel="next" href="plugin-ant-license.html" title="5.4.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-ant-usage.html#plugin-ant-usage-example" title="5.3.1.&nbsp;Example">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.3.&nbsp;Usage</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-ant-config.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;5.&nbsp;Ant Plug-in task</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-ant-usage"></a>5.3.&nbsp;Usage</h2></div></div><div></div></div><p>
+The Jalopy task can take a few parameters to control the runtime behavior of
+Jalopy. If omitted, your current preferences settings will be used.
+</p><p>
+Nested <a href="http://jakarta.apache.org/ant/manual/CoreTypes/fileset.html" target="_top">FileSets</a>
+can and should be used to specify the source files and/or directories.
+</p><div class="table"><a name="tab-ant-params"></a><p class="title"><b>Table&nbsp;5.1.&nbsp;Jalopy Ant task parameters</b></p><table summary="Jalopy Ant task parameters" cellspacing="0" cellpadding="3" border="0" style="border-collapse: collapse;border-top: 0.5pt solid ; border-bottom: 0.5pt solid ; border-left: 0.5pt solid ; border-right: 0.5pt solid ; "><colgroup><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Attribute</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Description</th><th style="border-bottom: 0.5pt solid ; ">Required</th></tr></thead><tbody><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">backup</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Indicates whether backup copies for all file sources should be kept.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">classpathrev</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">The classpath to setup the class repository with, given as a <a href="http://jakarta.apache.org/ant/manual/using.html#references" target="_top">reference</a> to a path defined elsewhere. If you want the <a href="imports.html#import-optimization" title="4.3.7.3.&nbsp;Optimize">import optimization feature</a> to work, you have to specify the classpath reference you use to compile your sources here.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">convention</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Sets the location to the convention file to use - given either relative to the project's basedir or as an absolute local path or internet address. If omitted, the current settings are used, if available. Otherwise the Jalopy build-in defaults will be used.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">destdir</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Sets the destination directory to create/copy all formatting output into. If the given directory does not exist, it will be created. If this attribute is ommitted, all input files will simply be overriden.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">encoding</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Sets the encoding that controls how Jalopy interprets text files containing characters beyond the ASCII character set. Defaults to the platform default encoding.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">failonerror</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Indicates whether a run should be held if errors occured. Defaults to "true".</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">file</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Specifies a single source file to format.</td><td style="border-bottom: 0.5pt solid ; ">Yes, if no fileset is specified.</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">fileformat</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Sets the file format of the output files. The file format controls what end of line character is used. Either one of "UNIX", "DOS", MAC", "DEFAULT" or "AUTO" can be used. Defaults to "AUTO" (case insensitive).</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">force</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Indicates whether the formatting of files should be forced, even if the file is up-to-date.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">history</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Specifies the history policy to use. Either one of
+  "COMMENT", "FILE" or
+  "NONE" can be used.
+  </td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">javadoc</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Indicates whether Javadoc related messages should be printed.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">loglevel</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Specifies the logging level for message output. Either one of
+  "ERROR", "WARN", "INFO" or "DEBUG" can be used.</td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr style="border-bottom: 0.5pt solid ; "><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">style</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">DEPRECATED. See <span class="emphasis"><em>convention</em></span></td><td style="border-bottom: 0.5pt solid ; ">No</td></tr><tr><td style="border-right: 0.5pt solid ; ">threads</td><td style="border-right: 0.5pt solid ; ">Specifies the number of processing threads to use. Integer between <tt class="literal">1</tt> - <tt class="literal">8</tt>.
+  </td><td style="">No</td></tr></tbody></table></div><p></p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-ant-usage-example"></a>5.3.1.&nbsp;Example</h4></div></div><div></div></div><p>
+The following example demonstrates how you can make use of the Jalopy Ant task.
+</p><p>
+Note that the "format" target depends on the "compile" target.
+This way we can be sure that the given classpathref does cover all types used
+in your sources (and this is an absolute necessity for the import optimization feature
+to work reliable).
+</p><div class="example"><a name="ex-ant-build-file"></a><p class="title"><b>Example&nbsp;5.1.&nbsp;Example Ant build file</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+&lt;?xml version="1.0" ?&gt;
+&lt;project name="myProject" default="format" basedir="." &gt;
+
+  &lt;property name="dir.jalopy" value="/mystuff/jalopy/bin" /&gt;
+  &lt;property name="dir.lib" value="${basedir}/ext/lib" /&gt;
+  &lt;property name="dir.compile" value="${basedir}/tmp~/build/classes" /&gt;
+  &lt;property name="dir.src.java" value="${basedir}/src/java" /&gt;
+
+  &lt;!-- ==================================================================== --&gt;
+  &lt;!-- Defines the Jalopy task                                              --&gt;
+  &lt;!-- ==================================================================== --&gt;
+  &lt;taskdef name="jalopy"
+           classname="de.hunsicker.jalopy.plugin.ant.AntPlugin"&gt;
+    &lt;!--
+
+      we did not copy the needed .jars into the /lib directory of Ant in order
+      to avoid possible classpath issues, so we have to specify a lookup
+      classpath here
+
+      --&gt;
+    &lt;classpath&gt;
+      &lt;fileset dir="${dir.jalopy}"&gt;
+        &lt;include name="*.jar" /&gt;
+      &lt;/fileset&gt;
+    &lt;/classpath&gt;
+  &lt;/taskdef&gt;
+
+
+  &lt;!-- ==================================================================== --&gt;
+  &lt;!-- Defines the project classpath                                        --&gt;
+  &lt;!-- ==================================================================== --&gt;
+  &lt;path id="project.classpath" &gt;
+
+    &lt;!-- our compilation directory --&gt;
+    &lt;pathelement location="${dir.compile}" /&gt;
+
+    &lt;!-- needed 3rd party libraries --&gt;
+    &lt;fileset dir="${dir.lib}" &gt;
+      &lt;include name="**/*.jar" /&gt;
+    &lt;/fileset&gt;
+  &lt;/path&gt;
+
+
+  &lt;!-- ==================================================================== --&gt;
+  &lt;!-- Compiles the project sources                                         --&gt;
+  &lt;!-- ==================================================================== --&gt;
+  &lt;target name="compile"
+          depends="init"&gt;
+    &lt;javac destdir="${dir.compile}"
+           fork="true"&gt;
+      &lt;classpath refid="project.classpath" /&gt;
+      &lt;src path="${dir.src.java}" /&gt;
+    &lt;/javac&gt;
+  &lt;/target&gt;
+
+
+  &lt;!-- ==================================================================== --&gt;
+  &lt;!-- Formats all source files                                             --&gt;
+  &lt;!-- ==================================================================== --&gt;
+  &lt;target name="format" depends="compile"&gt;
+
+    &lt;!--
+
+      Invokes Jalopy as follows:
+
+      - All formatted files will have unix fileformat (\n)
+      - Load your code convention from the given url
+      - Override the convention to use the file history feature
+      - Override the convention to use alder32 checksums of files for history testing
+      - Override the convention to use loglevel "info"
+      - Override the convention to use 2 threads
+      - The import optimization feature will work (if enabled in the active
+        convention), because a classpath reference is specified
+
+        Don't forget to setup an include pattern as Jalopy truly expects
+        valid Java source files as input!
+
+      --&gt;
+    &lt;jalopy fileformat="unix"
+            convention="http://www.foo.com/myConvention.xml"
+            history="file"
+            historymethod="adler32"
+            loglevel="info"
+            threads="2"
+            classpathref="project.classpath"&gt;
+      &lt;fileset dir="${dir.src.java}"&gt;
+        &lt;include name="**/*.java" /&gt;
+      &lt;/fileset&gt;
+    &lt;/jalopy&gt;
+  &lt;/target&gt;
+&lt;/project&gt;
+</pre></td></tr></table></div><p></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-ant-config.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-ant.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.2.&nbsp;Configuration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;5.4.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..e964a08 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;5.&nbsp;Ant Plug-in task</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="next" href="plugin-ant-config.html" title="5.2.&nbsp;Configuration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-ant.html#plugin-ant-installation" title="5.1.&nbsp;Installation"><link rel="section" href="plugin-ant-config.html" title="5.2.&nbsp;Configuration"><link rel="section" href="plugin-ant-usage.html" title="5.3.&nbsp;Usage"><link rel="section" href="plugin-ant-license.html" title="5.4.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;5.&nbsp;Ant Plug-in task</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="part-plugins.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-config.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-ant"></a>Chapter&nbsp;5.&nbsp;Ant Plug-in task</h2></div></div><div></div></div><a class="indexterm" name="d0e5516"></a><a class="indexterm" name="d0e5521"></a><p>
+Describes the installation and usage of the Jalopy Ant Plug-in task.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-ant-installation"></a>5.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved in getting the Ant task up and running.
+</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plugin-ant-installation-requirements"></a>5.1.1.&nbsp;System requirements</h3></div></div><div></div></div><p>
+The Plug-in requires Ant 1.3 or higher. It has been tested with 1.3 and 1.5 versions of Ant.
+Please feel free to notify of other success stories.
+See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a> for the basic requirements to
+run Jalopy.
+</p><p>
+To obtain more information about this wonderful build tool, visit the official
+Ant home page at the Apache Jakarta site:
+<a href="http://jakarta.apache.org/ant/" target="_top">http://jakarta.apache.org/ant/</a>
+</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plugin-ant-installation-installation"></a>5.1.2.&nbsp;Installation</h3></div></div><div></div></div><a class="indexterm" name="d0e5546"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or compressed
+<tt class="filename">.tar</tt> archive. Unzipping either one of these files into a directory
+of your choice (referred to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>)
+will produce three subdirectories <tt class="filename">/bin</tt>, <tt class="filename">/docs</tt>
+and <tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  bin/       contains wrapper scripts for different platforms
+  docs/      contains the documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><a class="indexterm" name="d0e5576"></a><a class="indexterm" name="d0e5579"></a><p>
+Before you can use the Jalopy Ant task in your build scripts, you have to add
+it to your system. Maybe the simplest way is to utilize the
+<span><b class="command">&lt;taskdef&gt;</b></span> element in your build script as follows:
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+&lt;taskdef name="jalopy"
+         classname="de.hunsicker.jalopy.plugin.ant.AntPlugin"&gt;
+  &lt;classpath&gt;
+    &lt;fileset dir="<i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib"&gt;
+      &lt;include name="*.jar" /&gt;
+    &lt;/fileset&gt;
+  &lt;/classpath&gt;
+&lt;/taskdef&gt;
+</pre></td></tr></table><p>
+If you rather want to add the provided libraries to your classpath (either by
+copying the libraries into the <tt class="filename">/lib</tt> folder of your Ant
+installation or setting up the classpath as usual), please be aware that the
+provided parser (<tt class="filename">aelfred-<i class="replaceable"><tt>xxx</tt></i>.jar</tt>)
+is incompatible with Ant 1.4.1 or prior releases. If you happen to use one of
+these outdated versions, the parser library must not be copied into the
+<tt class="filename">/lib</tt> folder (or added to the classpath) otherwise Ant will fail to work!
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="part-plugins.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-ant-config.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part&nbsp;II.&nbsp;Plug-ins&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;5.2.&nbsp;Configuration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..b379bc3 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>6.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="previous" href="plugin-console-usage.html" title="6.2.&nbsp;Usage"><link rel="next" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-console-usage.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;6.&nbsp;Console Application</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-console-license"></a>6.3.&nbsp;License</h2></div></div><div></div></div><p>
+The Console Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under the GNU General Public License. See <a href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991">Appendix&nbsp;E, <i>GNU GENERAL PUBLIC LICENSE Version 2, June 1991</i></a>
+for more information.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the Jalopy license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-console-usage.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-console.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.2.&nbsp;Usage&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;7.&nbsp;Eclipse Plug-in</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..5f33ceb 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>6.2.&nbsp;Usage</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="previous" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="next" href="plugin-console-license.html" title="6.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-console-usage.html#synopsis" title="6.2.1.&nbsp;Synopsis"><link rel="subsection" href="plugin-console-usage.html#plugin-console-usage-example" title="6.2.2.&nbsp;Examples">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">6.2.&nbsp;Usage</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-console.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;6.&nbsp;Console Application</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-console-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-console-usage"></a>6.2.&nbsp;Usage</h2></div></div><div></div></div><p>
+Presents the available command line options along with some usage examples.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="synopsis"></a>6.2.1.&nbsp;Synopsis</h4></div></div><div></div></div><a class="indexterm" name="d0e5901"></a><a class="indexterm" name="d0e5904"></a><a class="indexterm" name="d0e5907"></a><p>
+To start Jalopy from the command line you may either use
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+jalopy [-options] <i class="replaceable"><tt>args</tt></i>...
+</pre></td></tr></table><p>
+or
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+java Jalopy [-options] <i class="replaceable"><tt>args</tt></i>...
+</pre></td></tr></table><p>
+or
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+java -jar jalopy-<i class="replaceable"><tt>&lt;version&gt;</tt></i>.jar [-options] <i class="replaceable"><tt>args</tt></i>...
+</pre></td></tr></table><p>
+depending on your installation option.
+</p><p><a name="usage-options"></a>
+You can specify as many <i class="replaceable"><tt>args</tt></i> as you want,
+where <i class="replaceable"><tt>args</tt></i> describes either files,
+directories or filter expressions. You can use any valid Perl5 (5.003)
+regular expression as a filter expression.
+</p><a class="indexterm" name="d0e5944"></a><a class="indexterm" name="d0e5949"></a><a class="indexterm" name="d0e5954"></a><div class="simplesect" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="options"></a>Options</h5></div></div><div></div></div><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+-c, --convention=FILE   use FILE as code convention file
+    --disclaimer        print software disclaimer
+-d, --dest=DIR          use DIR as base output directory
+-e, --encoding=WORD     assume WORD as encoding of input files where WORD
+                        describes one of the JDK supported encodings
+                        (if omitted, the platform default is used)
+-f, --format=WORD       use WORD as output file format where WORD can be
+                        either UNIX, DOS, MAC, AUTO (the default) or DEFAULT
+                        (all case-insensitive)
+    --force             force formatting even if file up-to-date
+-h, --help              display this help
+    --nobackup          don't keep backup files
+-r, --recursive{=NUM}   recurse into directories, up to NUM levels
+                        if NUM is omitted, recurses indefinitely
+-t, --thread=NUM        use NUM processing threads
+-v, --version           print product version and exit
+</pre></td></tr></table><p>
+If no input file(s) are given, Jalopy starts listening on <span class="emphasis"><em>STDIN</em></span>.
+</p></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-console-usage-example"></a>6.2.2.&nbsp;Examples</h4></div></div><div></div></div><p>
+</p><div class="example"><a name="ex-command-line-one"></a><p class="title"><b>Example&nbsp;6.1.&nbsp;Sample command line usage</b></p><a class="indexterm" name="d0e5975"></a><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+jalopy -r <i class="replaceable"><tt>myDirectory</tt></i>
+</pre></td></tr></table><p>
+Formats all Java source files found in directory <i class="replaceable"><tt>myDirectory</tt></i>
+and all subdirectories. Creates backup copies of all files. The file format
+of the original source files will be kept.
+</p></div><p>
+
+</p><div class="example"><a name="ex-command-line-two"></a><p class="title"><b>Example&nbsp;6.2.&nbsp;Sample command line usage</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+jalopy -d <i class="replaceable"><tt>/directory</tt></i> -f DOS
+<i class="replaceable"><tt>myFile1.java myFile2.java</tt></i>
+</pre></td></tr></table><p>
+Formats the two files <i class="replaceable"><tt>myFile1.java</tt></i> and
+<i class="replaceable"><tt>myFile2.java</tt></i> and writes the new files into
+directory <i class="replaceable"><tt>/directory</tt></i>. Uses DOS as the file
+format of the new files.
+</p></div><p>
+
+</p><div class="example"><a name="ex-command-line-three"></a><p class="title"><b>Example&nbsp;6.3.&nbsp;Sample command line usage</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+jalopy -r 3 -d <i class="replaceable"><tt>/directory</tt></i> ^A.*java
+</pre></td></tr></table><p>
+Formats all Java source files found in the current directory and three
+levels down that begin with a captial 'A' and writes the new files into
+directory <i class="replaceable"><tt>/tmp</tt></i>. The file format of the
+original source files will be kept.
+</p></div><p>
+
+</p><div class="example"><a name="ex-command-line-four"></a><p class="title"><b>Example&nbsp;6.4.&nbsp;Sample command line usage</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+type f:\test\in.java | jalopy &gt; out.java
+</pre></td></tr></table><p>
+Formats the file <tt class="filename">f:\test\in.java</tt> read from STDIN and
+outputs its formatted contents to the file <tt class="filename">out.java</tt> in the
+current directory.
+</p></div><p>
+
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-console.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-console.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-console-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;6.&nbsp;Console Application&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;6.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..113c235 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;6.&nbsp;Console Application</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-ant-license.html" title="5.4.&nbsp;License"><link rel="next" href="plugin-console-usage.html" title="6.2.&nbsp;Usage"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-console.html#plugin-console-installation" title="6.1.&nbsp;Installation"><link rel="section" href="plugin-console-usage.html" title="6.2.&nbsp;Usage"><link rel="section" href="plugin-console-license.html" title="6.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;6.&nbsp;Console Application</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-ant-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-console-usage.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-console"></a>Chapter&nbsp;6.&nbsp;Console Application</h2></div></div><div></div></div><a class="indexterm" name="d0e5799"></a><a class="indexterm" name="d0e5804"></a><p>
+The Console application provides a powerful command line interface for Jalopy.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-console-installation"></a>6.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the Console Plug-in.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-console-installation-requirements"></a>6.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a> for the basic requirements to
+run Jalopy.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-console-installation-installation"></a>6.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e5824"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or compressed <tt class="filename">.tar</tt> file.
+Unzipping either one of these files into a directory of your choice (referred
+to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>) will produce three
+subdirectories <tt class="filename">/bin</tt>, <tt class="filename">/docs</tt> and
+<tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  bin/       contains wrapper scripts for different platforms
+  docs/      contains the documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><p>
+Wrapper scripts are provided for the common platforms, so you may want to add
+the <tt class="filename">/bin</tt> folder to your path. If your platform
+is not covered you should make use of the <tt class="option">-jar</tt> option of the
+Java application launcher (the <span><b class="command">java -jar</b></span> command), since
+this requires no classpath manipulation. If you don't want to use the
+<tt class="option">-jar</tt> option, you have to add the <tt class="filename">.jar</tt>
+files as usual to your classpath.
+</p><p>
+For the Unix Bash shell, this means can be achieved using
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+export CLASSPATH=${CLASSPATH}:<i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib/jalopy-console-<i class="replaceable"><tt>&lt;version&gt;</tt></i>.jar
+</pre></td></tr></table><p>
+For Windows, use something like
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="synopsis">
+set CLASSPATH=%CLASSPATH%;<i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>\lib\jalopy-console-<i class="replaceable"><tt>&lt;version&gt;</tt></i>.jar
+</pre></td></tr></table><p>
+Refer to your system documentation on how to apply these changes more permanently.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-ant-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-console-usage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.4.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;6.2.&nbsp;Usage</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..08dfeba 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>7.2.&nbsp;Integration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="previous" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="next" href="plugin-eclipse-license.html" title="7.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-eclipse-integration.html#d0e6138" title="7.2.1.&nbsp;Main menu bar"><link rel="subsection" href="plugin-eclipse-integration.html#d0e6176" title="7.2.2.&nbsp;Java Editor context menu"><link rel="subsection" href="plugin-eclipse-integration.html#d0e6191" title="7.2.3.&nbsp;Project, Folder, File context menus">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">7.2.&nbsp;Integration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-eclipse.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;7.&nbsp;Eclipse Plug-in</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-eclipse-integration"></a>7.2.&nbsp;Integration</h2></div></div><div></div></div><p>
+Shows how the Plug-in is integrated into the Eclipse IDE.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6138"></a>7.2.1.&nbsp;Main menu bar</h4></div></div><div></div></div><p>
+Currently, the software adds a new item into the main menu bar of Eclipse
+to launch the Jalopy settings dialog. Note that the this configuration
+dialog is actually a Java Swing dialog launched in-process so the
+appearance and behaviour may slightly differ compared to native applications.
+A future version will bring tightly integration with the Eclipse workbench
+preferences dialog.
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square"><p>
+<span><b class="guimenu"><span class="accel">W</span>indow</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy Settings...</b></span>
+</p><p>
+Displays the Jalopy settings dialog. Use this item if you want to change the
+settings that control the layout of any formatted code.
+</p></li></ul></div><p>
+The menu item appears only for certain views/editors. If you want to
+enable it permanently, mark
+<span><b class="guimenu"><span class="accel">W</span>indow</b></span>-&gt;<span><b class="guimenuitem">Customi<span class="accel">z</span>e Perspective...</b></span>-&gt;<span><b class="guimenuitem">Action Sets</b></span>-&gt;<span><b class="guimenuitem">Jalopy</b></span>
+
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6176"></a>7.2.2.&nbsp;Java Editor context menu</h4></div></div><div></div></div><p>
+The software adds a new menu item to the context menu of Java editors.
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square"><p>
+<span><b class="guimenuitem">Format with Jalopy</b></span>
+</p><p>
+Formats the contents of the editor.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6191"></a>7.2.3.&nbsp;Project, Folder, File context menus</h4></div></div><div></div></div><p>
+The software adds a new menu item to the context menu of projects, folders and
+Java source files in the navigation view of the Java perspective.
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square"><p>
+<span><b class="guimenuitem">Format</b></span>
+</p><p>
+Formats the selected files. Depending on the object type (project, folder, file) formats
+either all Java source files of the project, the contents of the selected folder(s)
+(including subfolders) or the currently selected Java source file(s).
+</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-eclipse.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-eclipse.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;7.&nbsp;Eclipse Plug-in&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;7.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..06cf4fa 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>7.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="previous" href="plugin-eclipse-integration.html" title="7.2.&nbsp;Integration"><link rel="next" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">7.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-eclipse-integration.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;7.&nbsp;Eclipse Plug-in</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-eclipse-license"></a>7.3.&nbsp;License</h2></div></div><div></div></div><p>
+The Eclipse Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under the Common Public License. See <a href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0">Appendix&nbsp;G, <i>Common Public License Version 1.0</i></a>
+for more information.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the Jalopy license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-eclipse-integration.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-eclipse.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7.2.&nbsp;Integration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;8.&nbsp;JBuilder OpenTool</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..75fab6c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;7.&nbsp;Eclipse Plug-in</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-console-license.html" title="6.3.&nbsp;License"><link rel="next" href="plugin-eclipse-integration.html" title="7.2.&nbsp;Integration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-eclipse.html#plugin-eclipse-installation" title="7.1.&nbsp;Installation"><link rel="section" href="plugin-eclipse-integration.html" title="7.2.&nbsp;Integration"><link rel="section" href="plugin-eclipse-license.html" title="7.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;7.&nbsp;Eclipse Plug-in</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-console-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse-integration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-eclipse"></a>Chapter&nbsp;7.&nbsp;Eclipse Plug-in</h2></div></div><div></div></div><a class="indexterm" name="d0e6064"></a><a class="indexterm" name="d0e6067"></a><p>
+Describes the installation and usage of the Jalopy Eclipse Plug-in.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-eclipse-installation"></a>7.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the Eclipse Plug-in.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-eclipse-installation-requirements"></a>7.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+This Plug-in requires Eclipse 2.0 or higher. It has only been tested with Eclipse 2.0.
+See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a> for the basic requirements
+to run Jalopy.
+</p><p>
+To obtain more information about this powerful IDE, visit the official
+Eclipse homepage:
+<a href="http://www.eclipse.org/" target="_top">http://www.eclipse.org/</a>
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-eclipse-installation-installation"></a>7.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e6094"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or
+compressed <tt class="filename">.tar</tt> archive. Unzipping either one of these
+files into a directory of your choice (referred to as
+<i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>) will produce two
+subdirectories <tt class="filename">/de.hunsicker.jalopy.plugin.eclipse_<i class="replaceable"><tt>version</tt></i></tt>
+and <tt class="filename">/docs</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  de.hunsicker.jalopy.plugin.eclipse_<i class="replaceable"><tt>version</tt></i>/    contains the Plug-in files
+  docs/                                          contains the documentation
+</pre></td></tr></table><p>
+</p><p>
+Copy the <tt class="filename">de.hunsicker.jalopy.plugin.eclipse_<i class="replaceable"><tt>version</tt></i></tt>
+folder into your Eclipse plugin directory and
+restart Eclipse. That's all there is to it, you are now ready to run Jalopy
+from within Eclipse.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-console-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-eclipse-integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">6.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;7.2.&nbsp;Integration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..92d21ad 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>8.2.&nbsp;Integration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="previous" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="next" href="plugin-jbuilder-license.html" title="8.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-jbuilder-integration.html#d0e6308" title="8.2.1.&nbsp;AppBrowser main menu"><link rel="subsection" href="plugin-jbuilder-integration.html#d0e6357" title="8.2.2.&nbsp;Project pane popup-menu "><link rel="subsection" href="plugin-jbuilder-integration.html#d0e6367" title="8.2.3.&nbsp;Editor view popup menu&#xA;">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">8.2.&nbsp;Integration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jbuilder.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;8.&nbsp;JBuilder OpenTool</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jbuilder-integration"></a>8.2.&nbsp;Integration</h2></div></div><div></div></div><p>
+Shows how the Plug-in is integrated into the JBuilder IDE.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6308"></a>8.2.1.&nbsp;AppBrowser main menu</h4></div></div><div></div></div><p>
+The software adds two new menu items into the main menu of the AppBrowser to
+seamlessly integrate with JBuilder:
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+<span><b class="guimenu"><span class="accel">P</span>roject</b></span>-&gt;<span><b class="guimenuitem">Forma<span class="accel">t</span> &lt;file&gt;</b></span> (<span><b class="shortcut"><span class="keysym">Ctrl</span>-<span class="keysym">Shift</span>-<span class="keysym">F10</span></b></span>)
+</p><p>
+Formats the current editor view. Use this item if you need to format the
+current opened file.
+</p><p>
+Only available if there is an open view that contains a Java source file.
+</p></li><li><p>
+<span><b class="guimenu"><span class="accel">T</span>ools</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy Options...</b></span>.
+</p><p>
+Displays the Jalopy settings dialog.
+</p><p>
+Use this item if you want to configure your settings to control the
+layout of any formatted code.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6357"></a>8.2.2.&nbsp;Project pane popup-menu </h4></div></div><div></div></div><p>
+There will also be a new menu item available at the end of the popup-menu of
+the Project pane: <span><b class="guimenuitem">Format</b></span>. Use this item if you want
+to format several files at once. All currently selected files are formatted.
+</p><p>
+If it happens that a file has an open editor view, this view will be updated,
+not the actual file. You have to save the view first to see the physical file
+updated.
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6367"></a>8.2.3.&nbsp;Editor view popup menu
+</h4></div></div><div></div></div><p>
+Both the <span><b class="guimenuitem">Format &lt;file&gt;</b></span> and <span><b class="guimenuitem">Jalopy Options...</b></span> items can be also reached via the popup menu of the active editor view.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jbuilder.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jbuilder.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;8.&nbsp;JBuilder OpenTool&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;8.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..2d70807 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>8.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="previous" href="plugin-jbuilder-integration.html" title="8.2.&nbsp;Integration"><link rel="next" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">8.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jbuilder-integration.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;8.&nbsp;JBuilder OpenTool</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jbuilder-license"></a>8.3.&nbsp;License</h2></div></div><div></div></div><p>
+The JBuilder Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a BSD license.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jbuilder-integration.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jbuilder.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.2.&nbsp;Integration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;9.&nbsp;JDeveloper Extension</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..bac41b8 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;8.&nbsp;JBuilder OpenTool</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-eclipse-license.html" title="7.3.&nbsp;License"><link rel="next" href="plugin-jbuilder-integration.html" title="8.2.&nbsp;Integration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-jbuilder.html#plugin-jbuilder-installation" title="8.1.&nbsp;Installation"><link rel="section" href="plugin-jbuilder-integration.html" title="8.2.&nbsp;Integration"><link rel="section" href="plugin-jbuilder-license.html" title="8.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;8.&nbsp;JBuilder OpenTool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-eclipse-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder-integration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-jbuilder"></a>Chapter&nbsp;8.&nbsp;JBuilder OpenTool</h2></div></div><div></div></div><a class="indexterm" name="d0e6228"></a><a class="indexterm" name="d0e6231"></a><a class="indexterm" name="d0e6234"></a><p>
+Describes the installation and usage of the Jalopy JBuilder Plug-in OpenTool.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jbuilder-installation"></a>8.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the JBuilder Plug-in.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jbuilder-installation-requirements"></a>8.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+The JBuilder Plug-in requires JBuilder 5.0 or higher. It has only been tested with JBuilder
+Personal 6.0 and 7.0. See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a>
+for the basic requirements to run Jalopy.
+</p><p>
+To obtain more information about this
+powerful IDE, visit the official JBuilder homepage at the Borland site:
+<a href="http://www.borland.com/jbuilder/" target="_top">http://www.borland.com/jbuilder/</a>
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jbuilder-installation-installation"></a>8.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e6261"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or compressed <tt class="filename">.tar</tt> file.
+Unzipping either one of these files into a directory of your choice (referred
+to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>) will produce two
+subdirectories <tt class="filename">/docs</tt> and <tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  docs/      contains documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><p>
+Remove all files from any prior Jalopy version from
+your JBuilder extension directory (<tt class="filename">/lib/ext</tt>).
+</p><p>
+Further installation is simple: just copy all files from your
+<tt class="filename"><i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib</tt> folder
+into the <tt class="filename">/lib/ext</tt> directory of your JBuilder distribution.
+JBuilder will then need to be restarted before Jalopy begins working.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-eclipse-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jbuilder-integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;8.2.&nbsp;Integration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..906c6c3 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>9.2.&nbsp;Integration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="previous" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="next" href="plugin-jdev-license.html" title="9.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-jdev-integration.html#d0e6473" title="9.2.1.&nbsp;Navigator context menu"><link rel="subsection" href="plugin-jdev-integration.html#d0e6490" title="9.2.2.&nbsp;Java editor context menu"><link rel="subsection" href="plugin-jdev-integration.html#d0e6505" title="9.2.3.&nbsp;Preferences dialog">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">9.2.&nbsp;Integration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jdev.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;9.&nbsp;JDeveloper Extension</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jdev-integration"></a>9.2.&nbsp;Integration</h2></div></div><div></div></div><p>
+Shows how the Plug-in is integrated into the JDeveloper IDE.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6473"></a>9.2.1.&nbsp;Navigator context menu</h4></div></div><div></div></div><p>
+The software adds a new menu item into the context popup menu of the Navigator:
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+<span><b class="guimenuitem">Format [Workspace|Project]</b></span>
+</p><p>
+By selecting the "Format" menu item, all Java sources of the
+selected node are formatted according to the current Jalopy preferences.
+</p><p>
+The item appears in the popup menu if the user clicks the right mouse button on
+a Java source node or any other parent node that may contain Java sources
+(such as Workspace, Project, Directory, EJB or BC4J nodes).
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6490"></a>9.2.2.&nbsp;Java editor context menu</h4></div></div><div></div></div><p>
+The software adds a new menu item into the context popup menu of Java code editors:
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+<span><b class="guimenuitem">Format</b></span>
+</p><p>
+By selecting the "Format" menu item, the contents of the active code editor view
+are formatted according to the current Jalopy preferences.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6505"></a>9.2.3.&nbsp;Preferences dialog</h4></div></div><div></div></div><p>
+The Jalopy preferences are integrated into the preferences dialog of
+JDeveloper 9i which is reachable through the
+<span><b class="guimenu"><span class="accel">T</span>ools</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">P</span>references...</b></span>
+menu.
+Each Jalopy preferences page is added as a subentry to the main Jalopy
+preferences entry.
+</p><p>
+Jalopy preferences are stored in the <tt class="filename">$HOME/.jalopy</tt> directory.
+This is in contrast to other JDeveloper preferences which are stored within the
+IDE configuration files. It is intentional in order to allow reuse of Jalopy
+preferences between different IDEs. Note that in this release, Jalopy
+preferences are stored whenever the user leaves a page. If the user moves to
+another settings page, all settings are stored to disk even if the user
+chooses to cancel the preferences dialog later on.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jdev.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jdev.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;9.&nbsp;JDeveloper Extension&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;9.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..fea13a6 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>9.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="previous" href="plugin-jdev-integration.html" title="9.2.&nbsp;Integration"><link rel="next" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">9.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jdev-integration.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;9.&nbsp;JDeveloper Extension</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jdev-license"></a>9.3.&nbsp;License</h2></div></div><div></div></div><p>
+The JDeveloper Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a BSD license.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jdev-integration.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jdev.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">9.2.&nbsp;Integration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;10.&nbsp;jEdit Plug-in</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..68cd50c 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;9.&nbsp;JDeveloper Extension</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-jbuilder-license.html" title="8.3.&nbsp;License"><link rel="next" href="plugin-jdev-integration.html" title="9.2.&nbsp;Integration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-jdev.html#plugin-jdev-installation" title="9.1.&nbsp;Installation"><link rel="section" href="plugin-jdev-integration.html" title="9.2.&nbsp;Integration"><link rel="section" href="plugin-jdev-license.html" title="9.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;9.&nbsp;JDeveloper Extension</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jbuilder-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev-integration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-jdev"></a>Chapter&nbsp;9.&nbsp;JDeveloper Extension</h2></div></div><div></div></div><a class="indexterm" name="d0e6398"></a><a class="indexterm" name="d0e6401"></a><a class="indexterm" name="d0e6404"></a><p>
+Describes the installation and usage of the Jalopy JDeveloper Plug-in Extension.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jdev-installation"></a>9.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the JDeveloper Plug-in.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jdev-installation-requirements"></a>9.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+The JDeveloper Plug-in requires Oracle9i JDeveloper or later. 1.1.3 is the
+latest version and has only been tested with JDeveloper 10g Production.  Older
+releases may work on JDeveloper 9.0.2 and 9.0.3. See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a> for the basic
+requirements to run Jalopy.
+</p><p>
+To obtain more information about this powerful IDE, visit the official JDeveloper homepage
+at the Oracle site:
+<a href="http://otn.oracle.com/products/jdev/" target="_top">http://otn.oracle.com/products/jdev/</a>
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jdev-installation-installation"></a>9.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e6431"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or
+compressed <tt class="filename">.tar</tt> file. Unzipping either one of these files
+into a directory of your choice (referred to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>)
+will produce two subdirectories <tt class="filename">/docs</tt> and <tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  docs/      contains the documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><p>
+Further installation is simple: just copy all files from the
+<tt class="filename"><i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib</tt> folder
+into the <tt class="filename">/jdev/lib/ext</tt> directory of your JDeveloper
+distribution. JDeveloper will then need to be restarted before Jalopy begins
+working.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jbuilder-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jdev-integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;9.2.&nbsp;Integration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..7529668 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>10.2.&nbsp;Integration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="previous" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="next" href="plugin-jedit-license.html" title="10.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">10.2.&nbsp;Integration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jedit.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;10.&nbsp;jEdit Plug-in</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jedit-integration"></a>10.2.&nbsp;Integration</h2></div></div><div></div></div><p>
+Shows how the Plug-in is integrated into jEdit.
+</p><p>
+The software adds a new menu item group into the <span><b class="guimenu"><span class="accel">P</span>lugins</b></span>
+menu of the editor view. Available are two new menu items:
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+<span><b class="guimenu"><span class="accel">P</span>lugins</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy</b></span>-&gt;<span><b class="guimenuitem">Forma<span class="accel">t</span> current Buffer</b></span>.
+</p><p>
+Formats the contents of the active text area.
+</p><p>
+Note that this menu item reflects the state of the text area: it will only be enabled
+if the current edit mode is actually the <i class="firstterm">java</i> mode.
+</p></li><li><p>
+<span><b class="guimenu"><span class="accel">P</span>lugins</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy Options...</b></span>.
+</p><p>
+Displays the Jalopy settings dialog.
+</p><p>
+Use this item if you want to change your settings to control the
+layout of any formatted code.
+</p></li></ul></div><p>
+These options are available under jEdit's Global Options dialog, too.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jedit.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jedit.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;10.&nbsp;jEdit Plug-in&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;10.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..72f045d 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>10.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="previous" href="plugin-jedit-integration.html" title="10.2.&nbsp;Integration"><link rel="next" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">10.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jedit-integration.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;10.&nbsp;jEdit Plug-in</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jedit-license"></a>10.3.&nbsp;License</h2></div></div><div></div></div><p>
+The jEdit Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under a BSD license.
+</p><p>
+See <a href="http://jalopy.sf.net/license-bsd.html" target="_top">Appendix B</a> of the manual
+for the license and refer to <a href="http://jalopy.sf.net/dependencies.html" target="_top">Appendix A</a> for
+the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jedit-integration.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-jedit.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.2.&nbsp;Integration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..1927417 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;10.&nbsp;jEdit Plug-in</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-jdev-license.html" title="9.3.&nbsp;License"><link rel="next" href="plugin-jedit-integration.html" title="10.2.&nbsp;Integration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-jedit.html#plugin-jedit-installation" title="10.1.&nbsp;Installation"><link rel="section" href="plugin-jedit-integration.html" title="10.2.&nbsp;Integration"><link rel="section" href="plugin-jedit-license.html" title="10.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;10.&nbsp;jEdit Plug-in</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jdev-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit-integration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-jedit"></a>Chapter&nbsp;10.&nbsp;jEdit Plug-in</h2></div></div><div></div></div><a class="indexterm" name="d0e6545"></a><a class="indexterm" name="d0e6548"></a><p>
+Describes the installation and usage of the Jalopy jEdit Plug-in.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-jedit-installation"></a>10.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the jEdit Plug-in.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jedit-installation-requirements"></a>10.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+The Jalopy jEdit Plug-in requires at least jEdit 4.1pre1 and MessageView 0.1.0.
+If you want to import/exprt XML settings, you need the XML Plug-in also.
+Refer to the Jalopy user manual for the basic requirements to run Jalopy (You
+may find the latest version on the Jalopy website,
+<a href="http://jalopy.sf.net/installation.html" target="_top">http://jalopy.sf.net/installation.html</a>)
+</p><p>
+To obtain more information about this wonderful Editor, visit the official
+jEdit homepage:
+<a href="http://www.jedit.org/" target="_top">http://www.jedit.org/</a>
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-jedit-installation-installation"></a>10.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e6576"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or compressed
+<tt class="filename">.tar</tt> archive. Unzipping either one of these files into a directory
+of your choice (referred to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>) will
+produce two subdirectories <tt class="filename">/docs</tt> and <tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  docs/      contains the documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><p>
+If there is already an older version of Jalopy installed, you have to remove it
+prior to install. Open the Plugin Manager via
+<span><b class="guimenu"><span class="accel">P</span>lugins</b></span>-&gt;<span><b class="guimenuitem">Plugin <span class="accel">M</span>anager</b></span>, select the Jalopy Java Source Code Formatter entry and
+press <span><b class="guilabel">Remove Plugins</b></span>.
+</p><p>
+Further installation is simple: just copy all <tt class="filename">.jar</tt> files
+contained  in the <tt class="filename"><i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib</tt> folder
+into the <tt class="filename">/jars</tt> directory of your jEdit distribution.
+jEdit will then need to be restarted before Jalopy begins working.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jdev-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-jedit-integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">9.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;10.2.&nbsp;Integration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..26ac7ce 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>11.2.&nbsp;Integration</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="previous" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="next" href="plugin-netbeans-license.html" title="11.3.&nbsp;License"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="plugin-netbeans-integration.html#d0e6828" title="11.2.1.&nbsp;Workspace main menu"><link rel="subsection" href="plugin-netbeans-integration.html#d0e6878" title="11.2.2.&nbsp;Explorer popup-menu">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">11.2.&nbsp;Integration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-netbeans.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans-license.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-netbeans-integration"></a>11.2.&nbsp;Integration</h2></div></div><div></div></div><p>
+Shows how the Plug-in is integrated into the NetBeans IDE.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6828"></a>11.2.1.&nbsp;Workspace main menu</h4></div></div><div></div></div><p>
+The software adds two new menu items into the main menu of the current
+Workspace to seamlessly integrate with NetBeans:
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+<span><b class="guimenu"><span class="accel">B</span>uild</b></span>-&gt;<span><b class="guimenuitem">Forma<span class="accel">t</span> [All]</b></span> (<span><b class="shortcut"><span class="keysym">Ctrl</span>-<span class="keysym">Shift</span>-<span class="keysym">F10</span></b></span>).
+</p><p>
+Formats the currently selected node(s).
+</p><p>
+Only available if there are indeed nodes selected which represents or contains
+Java source files.
+</p></li><li><p>
+<span><b class="guimenu"><span class="accel">T</span>ools</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">J</span>alopy Options...</b></span>.
+</p><p>
+Displays the Jalopy settings dialog.
+</p><p>
+Use this item if you want to change your settings to control the
+layout of any formatted code.
+</p></li></ul></div><p></p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6878"></a>11.2.2.&nbsp;Explorer popup-menu</h4></div></div><div></div></div><p>
+The <span><b class="guimenuitem">Format [All]</b></span> item can be also reached via the
+popup menu of the Explorer. Note that the item only appears for folder nodes
+or plain Java source files. It does not work for form based nodes.
+</p><p>
+If it happens that a file has an open editor view, this view will be updated,
+not the actual file. You have to save the view first to see the physical file
+updated.
+</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-netbeans.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-netbeans.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans-license.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;11.3.&nbsp;License</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..321c9bd 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>11.3.&nbsp;License</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="previous" href="plugin-netbeans-integration.html" title="11.2.&nbsp;Integration"><link rel="next" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">11.3.&nbsp;License</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-netbeans-integration.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="dependencies.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-netbeans-license"></a>11.3.&nbsp;License</h2></div></div><div></div></div><p>
+The NetBeans Plug-in is "<span class="bold"><b><a href="http://opensource.org/docs/certification_mark.php" target="_top">OSI Certified Open Source Software</a></b></span>",
+released under the Sun Public License. See <a href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0">Appendix&nbsp;H, <i>SUN PUBLIC LICENSE Version 1.0</i></a>
+for more information.
+</p><p>
+See <a href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License">Appendix&nbsp;B, <i>The Jalopy BSD License</i></a> for the Jalopy license
+and refer to <a href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies">Appendix&nbsp;A, <i>Library Dependencies</i></a> for the license terms of the accompanying 3rd party libraries.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-netbeans-integration.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="plugin-netbeans.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="dependencies.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.2.&nbsp;Integration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;A.&nbsp;Library Dependencies</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..d462344 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="previous" href="plugin-jedit-license.html" title="10.3.&nbsp;License"><link rel="next" href="plugin-netbeans-integration.html" title="11.2.&nbsp;Integration"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="plugin-netbeans.html#plugin-netbeans-installation" title="11.1.&nbsp;Installation"><link rel="section" href="plugin-netbeans-integration.html" title="11.2.&nbsp;Integration"><link rel="section" href="plugin-netbeans-license.html" title="11.3.&nbsp;License">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="plugin-jedit-license.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;II.&nbsp;Plug-ins</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans-integration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="plugin-netbeans"></a>Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module</h2></div></div><div></div></div><a class="indexterm" name="d0e6715"></a><a class="indexterm" name="d0e6718"></a><a class="indexterm" name="d0e6721"></a><a class="indexterm" name="d0e6726"></a><a class="indexterm" name="d0e6731"></a><p>
+Describes the installation and usage of the Jalopy NetBeans/Sun ONE Studio Plug-in module.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugin-netbeans-installation"></a>11.1.&nbsp;Installation</h2></div></div><div></div></div><p>
+Explains the steps involved to install the NetBeans Plug-in module.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-netbeans-installation-requirements"></a>11.1.1.&nbsp;System requirements</h4></div></div><div></div></div><p>
+The Plug-in requires NetBeans 3.3 (or above) or Sun ONE Studio 4. It has only been
+tested with NetBeans 3.4.
+See <a href="installation.html#installation-requirements" title="1.1.&nbsp;System requirements">Section&nbsp;1.1, &#8220;System requirements&#8221;</a> for the basic requirements
+to run Jalopy.
+</p><p>
+To obtain more information about this
+powerful IDE, visit the official NetBeans homepage:
+<a href="http://www.netbeans.org/" target="_top">http://www.netbeans.org/</a> or the Sun ONE Studio
+pages at Sun:
+<a href="http://wwws.sun.com/software/sundev/jde/index.html" target="_top">http://wwws.sun.com/software/sundev/jde/</a>
+</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="plugin-netbeans-installation-installation"></a>11.1.2.&nbsp;Installation</h4></div></div><div></div></div><a class="indexterm" name="d0e6761"></a><a class="indexterm" name="d0e6766"></a><p>
+The Plug-in comes either as a single <tt class="filename">.zip</tt> or compressed
+<tt class="filename">.tar</tt> file. Unzipping either one of these files into a directory
+of your choice (referred to as <i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>)
+will produce two subdirectories <tt class="filename">/docs</tt> and
+<tt class="filename">/lib</tt>.
+</p><p>
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">
+..
+  docs/      contains the documentation
+  lib/       contains all necessary libraries
+</pre></td></tr></table><p>
+</p><p>
+Now follow these steps to install the Jalopy Plug-in:
+</p><div class="orderedlist"><ol type="1"><li><p>
+Start NetBeans/Sun ONE Studio.
+</p></li><li><p>
+Open the Update Center Wizard by selecting
+<span><b class="guimenu"><span class="accel">T</span>ools</b></span>-&gt;<span><b class="guimenuitem"><span class="accel">U</span>pdate Center...</b></span>
+(You need to have the Auto Update module enabled for this to work).
+</p></li><li><p>
+On the first page 'Select Location of modules', choose 'Install Manually
+Downloaded Modules (.nbm Files)', select the <tt class="filename">.nbm</tt> contained
+in <tt class="filename"><i class="replaceable"><tt>&lt;INST_DIR&gt;</tt></i>/lib</tt> and
+proceed through all steps of the wizard as outlined.
+</p></li></ol></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="plugin-jedit-license.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-plugins.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="plugin-netbeans-integration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.3.&nbsp;License&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;11.2.&nbsp;Integration</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..eb0299f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Jalopy - Plug-ins</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><meta name="keywords" content="Java, convention, source, code, formatter, beautifier, pretty, printer, format, beautify, layout, coding, open, style, standard, transform, parser, Sun, ANTLR, Ant, Eclipse, JBuilder, NetBeans, jEdit, jakarta, JDeveloper, generator, generation, JDE, maven">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+            This page generated: <strong>June 8 2004</strong></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="plugins"></a>Plug-ins</h2></div></div><div></div></div><p>
+There are several Plug-ins available for Jalopy to add its extended formatting 
+capabilities to your favourite Java IDE or build tool.
+</p><p>
+Below you find a list with the current Plug-ins. Click on the entries 
+to get more information.
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square"><a href="./plugin-ant.html" target="_top">Ant 1.4 or above</a></li><li style="list-style-type: square"><a href="./plugin-console.html" target="_top">Console (Command line tool)</a></li><li style="list-style-type: square"><a href="./plugin-eclipse.html" target="_top">Eclipse 3.0 or above</a></li><li style="list-style-type: square"><a href="./plugin-jbuilder.html" target="_top">JBuilder 5.0 or above</a></li><li style="list-style-type: square"><a href="./plugin-jdev.html" target="_top">JDeveloper 10g</a></li><li style="list-style-type: square"><a href="./plugin-jedit.html" target="_top">jEdit 4.1pre1 or above</a></li><li style="list-style-type: square"><a href="./plugin-netbeans.html" target="_top">NetBeans 3.3 or above</a></li></ul></div><p>
+More to come!
+</p></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..2248952 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.&nbsp;Printer</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="previous" href="project.html" title="4.2.&nbsp;Projects"><link rel="next" href="whitespace.html" title="4.3.2.&nbsp;White Space"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="printer.html#braces" title="4.3.1.&nbsp;Braces"><link rel="subsection" href="whitespace.html" title="4.3.2.&nbsp;White Space"><link rel="subsection" href="indentation.html" title="4.3.3.&nbsp;Indentation"><link rel="subsection" href="wrapping.html" title="4.3.4.&nbsp;Wrapping"><link rel="subsection" href="separation.html" title="4.3.5.&nbsp;Blank Lines"><link rel="subsection" href="comments.html" title="4.3.6.&nbsp;Comments"><link rel="subsection" href="imports.html" title="4.3.7.&nbsp;Imports"><link rel="subsection" href="environment.html" title="4.3.8.&nbsp;Environment"><link rel="subsection" href="javadoc.html" title="4.3.9.&nbsp;Javadoc"><link rel="subsection" href="header.html" title="4.3.10.&nbsp;Header"><link rel="subsection" href="footer.html" title="4.3.11.&nbsp;Footer"><link rel="subsection" href="sorting.html" title="4.3.12.&nbsp;Sorting"><link rel="subsection" href="misc.html" title="4.3.13.&nbsp;Misc">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.&nbsp;Printer</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="project.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;4.&nbsp;Settings</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="whitespace.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="printer"></a>4.3.&nbsp;Printer</h2></div></div><div></div></div><a class="indexterm" name="d0e1088"></a><p>
+Lets you control all printer related settings.
+</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="braces"></a>4.3.1.&nbsp;Braces</h3></div></div><div></div></div><a class="indexterm" name="d0e1097"></a><p>
+Controls the handling of curly braces (the Java block delimeters).
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="braces-style"></a>4.3.1.1.&nbsp;General</h4></div></div><div></div></div><a class="indexterm" name="d0e1105"></a><p>
+Controls how the enclosing block delimeters - left and right curly
+brace - are printed. You can either choose from a predefined set of common
+styles or build one on your own.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-style-styles"></a>4.3.1.1.1.&nbsp;Styles</h5></div></div><div></div></div><p>
+Controls which brace style will be used to lay out blocks.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="braces-style-c"></a>
+C style
+</p><a class="indexterm" name="d0e1121"></a><p>
+Selects the C brace style. This style is sometimes called "Allman style" or "BSD style".
+</p><div class="example"><a name="ex-brace-style-c"></a><p class="title"><b>Example&nbsp;4.1.&nbsp;C style</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (!isDone)
+<span class="bold"><b>{</b></span>
+    doSomething();
+<span class="bold"><b>}</b></span>
+else
+<span class="bold"><b>{</b></span>
+    System.err.println("Finished");
+<span class="bold"><b>}</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="braces-style-sun"></a>
+Sun style
+</p><a class="indexterm" name="d0e1151"></a><p>
+Selects the Sun brace style. Sometimes called "K&amp;R style".
+</p><div class="example"><a name="ex-brace-style-sun"></a><p class="title"><b>Example&nbsp;4.2.&nbsp;Sun style</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (!isDone) <span class="bold"><b>{</b></span>
+    doSomething();
+<span class="bold"><b>}</b></span> else <span class="bold"><b>{</b></span>
+    System.err.println("Finished");
+<span class="bold"><b>}</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="braces-style-gnu"></a>
+GNU style
+</p><a class="indexterm" name="d0e1181"></a><p>
+Selects the GNU brace style.
+</p><div class="example"><a name="ex-brace-style-gnu"></a><p class="title"><b>Example&nbsp;4.3.&nbsp;GNU style</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (!isDone)
+  <span class="bold"><b>{</b></span>
+    doSomething();
+  <span class="bold"><b>}</b></span>
+else
+  <span class="bold"><b>{</b></span>
+    System.err.println("Finished");
+  <span class="bold"><b>}</b></span>
+</pre></td></tr></table></div><p></p></li><li><p><a name="braces-style-custom"></a>
+Custom style
+</p><a class="indexterm" name="d0e1211"></a><p>
+Selecting this option will enable you to freely choose between the different brace
+style options discussed below.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-wrapping"></a>4.3.1.1.2.&nbsp;Wrapping</h5></div></div><div></div></div><a class="indexterm" name="d0e1223"></a><p>
+Controls the brace wrapping options.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Newline before left brace
+</p><p>
+If enabled, always prints a newline before the left curly brace.
+</p></li><li><p>
+Newline after right brace
+</p><p>
+If enabled, prints a newline after the left curly brace (when possible).
+</p></li><li><p>
+Treat class/method blocks different
+</p><p>
+It is common in the Java developer community to have the opening brace
+at the end of the line of the keyword for all types of blocks (Sun brace style).
+One may find the C++ convention of treating class/interface and method/constructor
+blocks different from other blocks useful. With this switch you can achieve
+exactly that: if enabled, class/interface and method/constructor blocks are
+then always printed in C brace style (newline before left brace).
+</p></li><li><p><a name="braces-different-wrapped"></a>
+Treat class/method blocks different if wrapped
+</p><p>
+With this switch enabled, the opening brace for class/interface or
+method/constructor blocks will always be printed on a new line (C style), if
+either the parameter list spawns several lines and a <tt class="literal">throws</tt>
+clause follows, or one of the possible clauses (<tt class="literal">extends</tt>,
+<tt class="literal">implements</tt>, <tt class="literal">throws</tt>) was wrapped.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-whitespace"></a>4.3.1.1.3.&nbsp;Whitespace</h5></div></div><div></div></div><a class="indexterm" name="d0e1266"></a><p>
+Controls the indentation whitespace for the left and right curly brace.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Before left brace
+</p><p>
+Number of spaces to print before the left curly brace.
+</p></li><li><p>
+After left brace
+</p><p>
+Number of spaces to print after the left curly brace.
+</p></li><li><p>
+After right brace
+</p><p>
+Number of spaces to print after the right curly brace.
+</p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="braces-misc"></a>4.3.1.2.&nbsp;Misc</h4></div></div><div></div></div><p>
+Controls miscellaneous brace options.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-insert"></a>4.3.1.2.1.&nbsp;Insert braces</h5></div></div><div></div></div><a class="indexterm" name="d0e1297"></a><p>
+Per definition braces are superfluous on single statements, but it is
+a common recommendation that braces should be always used in such cases.
+With this option, you can specify whether missing braces for single
+statements should be inserted for the control statements <tt class="function">if</tt>,
+<tt class="function">for</tt>, <tt class="function">while</tt> and <tt class="function">do-while</tt>.
+</p><p>
+Enabling this option for <tt class="function">while</tt> statements would render
+</p><div class="example"><a name="ex-brace-insertion"></a><p class="title"><b>Example&nbsp;4.4.&nbsp;Brace insertion</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+while (!isDone)
+    doSomething();
+</pre></td></tr></table><p>
+into
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+while (!isDone)
+{
+    doSomething();
+}
+</pre></td></tr></table></div><p></p></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-remove"></a>4.3.1.2.2.&nbsp;Remove braces</h5></div></div><div></div></div><a class="indexterm" name="d0e1334"></a><p>
+It is permittable to remove braces in case they are superfluous. This not only
+applies to the control statements <tt class="function">if</tt>, <tt class="function">for</tt>,
+<tt class="function">while</tt> and <tt class="function">do-while</tt>, but also to every
+block in general (remember a block is just a sequence of statements,
+local class declarations and local variable declaration statements within
+braces).
+</p><div class="example"><a name="ex-brace-removal"></a><p class="title"><b>Example&nbsp;4.5.&nbsp;Brace removal</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (int i = 0; i &lt; 100; i++)
+{
+    sum += value[i];
+}
+</pre></td></tr></table><p>
+would become
+</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (int i = 0; i &lt; 100; i++)
+    sum += value[i];
+</pre></td></tr></table></div><p></p></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="braces-empty"></a>4.3.1.2.3.&nbsp;Empty braces</h5></div></div><div></div></div><a class="indexterm" name="d0e1366"></a><a class="indexterm" name="d0e1369"></a><p>
+Controls how empty braces should be handled. If no option is selected,
+they are left untouched.
+</p><div class="example"><a name="ex-brace-empty"></a><p class="title"><b>Example&nbsp;4.6.&nbsp;Empty braces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (in != null)
+{
+    try
+    {
+        in.close();
+    }
+    catch (IOException ignored)
+    {
+    }
+}
+</pre></td></tr></table></div><p>
+All options don't apply to class/interface and method/constructor bodies but
+are only used for control statements and blocks.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="braces-empty-statement"></a>
+Insert empty statement
+<a class="indexterm" name="d0e1387"></a>
+<a class="indexterm" name="d0e1393"></a>
+
+</p><p>
+Inserts an empty statement to make it obvious for the reader that the empty braces
+are intentional.
+</p><div class="example"><a name="ex-braces-empty-statement"></a><p class="title"><b>Example&nbsp;4.7.&nbsp;Empty braces with empty statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (in != null)
+{
+    try
+    {
+        in.close();
+    }
+    catch (IOException ignored)
+    {
+        <span class="bold"><b>;</b></span>
+    }
+}
+</pre></td></tr></table></div></li></ul></div><div class="itemizedlist"><ul type="disc"><li><p>
+Cuddle braces
+</p><p><a name="braces-empty-cuddle"></a>
+Cuddles the braces. They will be printed right after the control statement.
+<a class="indexterm" name="d0e1413"></a>
+<a class="indexterm" name="d0e1419"></a>
+</p><div class="example"><a name="ex-braces-empty-cuddle"></a><p class="title"><b>Example&nbsp;4.8.&nbsp;Cuddled empty braces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (in != null)
+{
+    try
+    {
+        in.close();
+    }
+    catch (IOException ignored) <span class="bold"><b>{}</b></span>
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="project.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="settings.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="whitespace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.2.&nbsp;Projects&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.2.&nbsp;White Space</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..5e3d846 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.2.&nbsp;Projects</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="previous" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="next" href="printer.html" title="4.3.&nbsp;Printer"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.2.&nbsp;Projects</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="settings.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;4.&nbsp;Settings</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="printer.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="project"></a>4.2.&nbsp;Projects</h2></div></div><div></div></div><a class="indexterm" name="d0e1053"></a><p>
+Enables you to manage your Jalopy settings in a project-like manner. For every
+project you define, Jalopy creates a new subdirectory (under its main settings directory),
+where all related files will be stored.
+
+</p><p>
+The list component displays all currently known project spaces. Click on an
+entry to see what actions are available.
+</p><p>
+
+</p><p>
+The different actions are:
+</p><p>
+
+</p><div class="itemizedlist"><ul type="disc"><li><p><span><b class="guibutton">Add...</b></span></p><p>Displays a dialog that lets you define a new project. The project
+meta-information consists of a name and a short description. The name defines
+the subdirectory where all project settings will reside, therefore you should
+avoid characters that your platform does not allow to be used in file paths.
+</p></li><li><p><span><b class="guibutton">Remove</b></span></p><p>Lets you remove the selected project. A project may only be removed if it
+is not active. The default project cannot be removed.</p></li><li><p><span><b class="guibutton">Activate</b></span></p><p>Activates the selected project. The stored settings will be loaded and the
+configuration dialog updates accordingly.</p></li></ul></div><p>
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="settings.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="settings.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="printer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;4.&nbsp;Settings&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.&nbsp;Printer</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..d45925e 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.5.&nbsp;Blank Lines</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="wrapping.html" title="4.3.4.&nbsp;Wrapping"><link rel="next" href="comments.html" title="4.3.6.&nbsp;Comments"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="separation.html#separation-blank-lines" title="4.3.5.1.&nbsp;General"><link rel="subsection" href="separation.html#separation-misc" title="4.3.5.2.&nbsp;Misc"><link rel="subsection" href="separation.html#separation-comment" title="4.3.5.3.&nbsp;Comments">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.5.&nbsp;Blank Lines</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="wrapping.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="comments.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="separation"></a>4.3.5.&nbsp;Blank Lines</h3></div></div><div></div></div><p>
+Controls the Jalopy Blank Lines settings: the insertion of blank lines to
+separate statements or declarations with different functions or meanings.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="separation-blank-lines"></a>4.3.5.1.&nbsp;General</h4></div></div><div></div></div><p>
+Lets you specify the general blank lines sizes for different Java source file elements.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="blank-lines-package"></a>
+Package statement
+</p><a class="indexterm" name="d0e3379"></a><a class="indexterm" name="d0e3382"></a><p>
+Lets you control how many blank lines should be printed after the package statement.
+</p><div class="example"><a name="ex-blank-lines-package"></a><p class="title"><b>Example&nbsp;4.115.&nbsp;3 Blank lines after package statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">package de.hunsicker.jalopy.printer;
+&lt;--
+&lt;--
+&lt;--
+import antlr.collections.AST;
+
+import de.hunsicker.jalopy.parser.JavaAST;
+import de.hunsicker.jalopy.parser.JavaTokenTypes;
+
+...
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-import"></a>
+Last import statement
+</p><a class="indexterm" name="d0e3398"></a><a class="indexterm" name="d0e3401"></a><p>
+Lets you control how many blank lines should be printed after the last import statement.
+</p><div class="example"><a name="ex-blank-lines-import"></a><p class="title"><b>Example&nbsp;4.116.&nbsp;4 Blank lines after last import statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">package de.hunsicker.jalopy.printer;
+
+import antlr.collections.AST;
+
+import de.hunsicker.jalopy.parser.JavaAST;
+import de.hunsicker.jalopy.parser.JavaTokenTypes;
+&lt;--
+&lt;--
+&lt;--
+&lt;--
+public class Printer
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-classes"></a>
+Classes
+</p><a class="indexterm" name="d0e3417"></a><a class="indexterm" name="d0e3420"></a><p>
+Lets you control how many blank lines should be printed between two
+class declarations.
+</p><div class="example"><a name="blank-lines-class"></a><p class="title"><b>Example&nbsp;4.117.&nbsp;2 Blank lines between two class declarations</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">class One
+{
+    ...
+}
+&lt;--
+&lt;--
+class Two
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-interfaces"></a>
+Interfaces
+</p><a class="indexterm" name="d0e3436"></a><a class="indexterm" name="d0e3439"></a><p>
+Lets you control how many blank lines should be printed between two
+interface declarations.
+</p><div class="example"><a name="blank-lines-ifc"></a><p class="title"><b>Example&nbsp;4.118.&nbsp;3 Blank lines between two interface declarations</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">interface One
+{
+    ...
+}
+&lt;--
+&lt;--
+&lt;--
+interface Two
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-methods"></a>
+Methods
+</p><a class="indexterm" name="d0e3455"></a><a class="indexterm" name="d0e3458"></a><p>
+Lets you control how many blank lines should be printed between two
+method/constructor declarations.
+</p><div class="example"><a name="blank-lines-method"></a><p class="title"><b>Example&nbsp;4.119.&nbsp;3 Blank lines between two method declarations</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">public static Printer getInstance()
+{
+    return INSTANCE;
+}
+&lt;--
+&lt;--
+&lt;--
+public void print(AST node, ASTWriter out)
+           throws IOException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-blocks"></a>
+Blocks
+</p><a class="indexterm" name="d0e3474"></a><a class="indexterm" name="d0e3477"></a><p>
+Lets you control how many blank lines should be printed before and after
+statement blocks (if-else , for, while, do-while, switch, try-catch-finally, synchronized).
+Note that the 'Blank lines after' setting also applies for anonymous inner classes.
+</p><div class="example"><a name="ex-blank-lines-blocks"></a><p class="title"><b>Example&nbsp;4.120.&nbsp;2 Blank lines between before and after blocks</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">AST type = null;
+&lt;--
+&lt;--
+switch (next.getType())
+{
+    case JavaTokenTypes.LPAREN :
+        type = PrinterUtils.advanceToFirstNonParen(next);
+        break;
+    default :
+        type = next;
+        break;
+}
+&lt;--
+&lt;--
+AST ident = type.getFirstChild();
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-declarations"></a>
+Declarations
+</p><a class="indexterm" name="d0e3493"></a><a class="indexterm" name="d0e3496"></a><p>
+Lets you control how many blank lines should be printed before and after
+variable declarations.
+</p></li><li><p><a name="blank-lines-case"></a>
+Case blocks
+</p><a class="indexterm" name="d0e3506"></a><a class="indexterm" name="d0e3509"></a><p>
+Lets you control how many blank lines should be printed before each case
+block of a switch expression.
+</p><div class="example"><a name="ex-blank-lines-case"></a><p class="title"><b>Example&nbsp;4.121.&nbsp;3 Blank lines before case blocks</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">switch (next.getType())
+{
+&lt;--
+&lt;--
+&lt;--
+    case JavaTokenTypes.LPAREN :
+        type = PrinterUtils.advanceToFirstNonParen(next);
+        break;
+&lt;--
+&lt;--
+&lt;--
+    default :
+        type = next;
+        break;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-control"></a>
+Control statements
+</p><a class="indexterm" name="d0e3525"></a><a class="indexterm" name="d0e3528"></a><p>
+Lets you control how many blank lines should be printed before the statements
+<span><b class="command">return</b></span>, <span><b class="command">break</b></span> and <span><b class="command">continue</b></span>.
+</p><div class="example"><a name="ex-blank-lines-control"></a><p class="title"><b>Example&nbsp;4.122.&nbsp;2 Blank lines before case control statements</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">switch (next.getType())
+{
+    case JavaTokenTypes.LPAREN :
+        type = PrinterUtils.advanceToFirstNonParen(next);
+&lt;--
+&lt;--
+        break;
+
+    default :
+        type = next;
+&lt;--
+&lt;--
+        break;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="blank-lines-sl-comments"></a>
+Single-line comments
+</p><a class="indexterm" name="d0e3553"></a><a class="indexterm" name="d0e3556"></a><p>
+Lets you control how many blank lines should be printed before single-line
+comments.
+</p></li><li><p><a name="blank-lines-ml-comments"></a>
+Multi-line comments
+</p><a class="indexterm" name="d0e3566"></a><a class="indexterm" name="d0e3569"></a><p>
+Lets you control how many blank lines should be printed before multi-line
+comments.
+</p></li><li><p><a name="blank-lines-javadoc"></a>
+Javadoc comments
+</p><a class="indexterm" name="d0e3579"></a><a class="indexterm" name="d0e3582"></a><p>
+Lets you control how many blank lines should be printed before Javadoc
+comments.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="separation-misc"></a>4.3.5.2.&nbsp;Misc</h4></div></div><div></div></div><p>Lets you control miscellaneous separation settings.</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3594"></a>4.3.5.2.1.&nbsp;Misc</h5></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p><a name="separation-misc-left-curly"></a>
+Blank lines after left curly brace
+</p><a class="indexterm" name="d0e3601"></a><a class="indexterm" name="d0e3604"></a><p>
+Forces the given number of blank lines after left curly braces no matter
+what your other blank lines settings say.
+</p><div class="example"><a name="ex-separation-before-blocks"></a><p class="title"><b>Example&nbsp;4.123.&nbsp;Blank lines before blocks=1</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">public void foo()
+{
+&lt;--
+    if (condition())
+    {
+&lt;--
+        if (anotherCondition())
+        {
+            doSomething();
+        }
+    }
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-separation-misc-left-curly-yes"></a><p class="title"><b>Example&nbsp;4.124.&nbsp;Blank lines before blocks=1, Blank lines after left curly braces=0</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">public void foo()
+{
+    if (condition())
+    {
+        if (anotherCondition())
+        {
+            doSomething();
+        }
+    }
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="separation-misc-right-curly"></a>
+Blank lines before right curly brace
+</p><a class="indexterm" name="d0e3626"></a><a class="indexterm" name="d0e3629"></a><p>
+Forces the given number of blank lines before closing curly braces no matter
+what your other blank lines settings say.
+</p><div class="example"><a name="ex-separation-misc-left-curly-no"></a><p class="title"><b>Example&nbsp;4.125.&nbsp;Blank lines before blocks=1</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">public void foo()
+{
+    if (condititon())
+    {
+        if (anotherCondition())
+        {
+            doSomething();
+&lt;--
+        }
+&lt;--
+    }
+&lt;--
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="separation-misc-keep"></a>
+Keep Blank lines up to
+</p><p>
+If enabled, retains up to the given number of blank lines found in the
+original source. This only works for method or constructor bodies. Note that Jalopy
+still takes your other blank lines settings into account.
+</p><div class="example"><a name="ex-separation-misc-keep-no"></a><p class="title"><b>Example&nbsp;4.126.&nbsp;Source code with blank lines to separate code sections</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">aMVString = new MultiValueString("abc");
+&lt;--
+System.out.println("MV = "+aMVString);
+&lt;--
+System.out.println("MV0 = "+aMVString.extract(0));
+System.out.println("MV1 = "+aMVString.extract(1));
+System.out.println("MV2 = "+aMVString.extract(2));
+System.out.println("");
+</pre></td></tr></table></div><p>
+If this feature is left disabled, Jalopy will print the individual lines according
+to the current blank lines settings but won't try to retain any blank lines.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="chunks"></a>4.3.5.2.2.&nbsp;Chunks</h5></div></div><div></div></div><a class="indexterm" name="d0e3657"></a><p>
+Lets you define what makes a chunk: a section of associated statements.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="chunks-comments"></a>
+By comments
+</p><a class="indexterm" name="d0e3666"></a><a class="indexterm" name="d0e3669"></a><p>
+If enabled, a statement with a comment before is recognized as the start of a new
+chunk.
+</p><div class="example"><a name="ex-chunks-comments"></a><p class="title"><b>Example&nbsp;4.127.&nbsp;Aligning variable declarations</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String        text  = "text";
+int           a     = -1;
+
+// create a new entry
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-chunks-comments-enabled"></a><p class="title"><b>Example&nbsp;4.128.&nbsp;Aligning variable declarations with chunking by comments</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String text  = "text";
+int    a     = -1;
+
+// create a new entry
+History.Entry entry = new History.Entry(text);
+</pre></td></tr></table></div><p></p></li><li><p><a name="chunks-blank-lines"></a>
+By Blank lines
+</p><a class="indexterm" name="d0e3691"></a><a class="indexterm" name="d0e3694"></a><p>
+If enabled, a statement which has one or more blank lines before is recognized
+as the start of a new chunk.
+</p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="separation-comment"></a>4.3.5.3.&nbsp;Comments</h4></div></div><div></div></div><p>
+Lets you control the behaviour of the separator comments. If the
+<a href="sorting.html" title="4.3.12.&nbsp;Sorting">sorting of class elements</a> is enabled, Separator comments
+can be inserted before every element section, to make it easier to identify the
+different parts of a source file.
+</p><a class="indexterm" name="d0e3709"></a><div class="example"><a name="ex-separation-comment"></a><p class="title"><b>Example&nbsp;4.129.&nbsp;Separator comment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+//~ Methods ------------------------------------------------------------------
+</pre></td></tr></table></div><p></p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3718"></a>4.3.5.3.1.&nbsp;General</h5></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>
+Add separator comments
+</p><p>
+Enables the insertions of separator comments.
+</p></li><li><p>
+Add separator comments for inner classes
+</p><p>
+The insertion of separator comments for inner classes/interfaces may lead to
+confusion, therefore you can control it here separately.
+</p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3732"></a>4.3.5.3.2.&nbsp;Descriptions</h5></div></div><div></div></div><p>Lets you define the description text for each of the different class elements.</p></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3737"></a>4.3.5.3.3.&nbsp;Fill character</h5></div></div><div></div></div><p>Lets you define the fill character for the comments.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="wrapping.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="comments.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.4.&nbsp;Wrapping&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.6.&nbsp;Comments</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..025a308 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;4.&nbsp;Settings</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="previous" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="next" href="project.html" title="4.2.&nbsp;Projects"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="section" href="settings.html#general" title="4.1.&nbsp;General"><link rel="section" href="project.html" title="4.2.&nbsp;Projects"><link rel="section" href="printer.html" title="4.3.&nbsp;Printer"><link rel="section" href="inspector.html" title="4.4.&nbsp;Code Inspector"><link rel="section" href="messages.html" title="4.5.&nbsp;Messages">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;4.&nbsp;Settings</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="usage.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;Jalopy core</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="project.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="settings"></a>Chapter&nbsp;4.&nbsp;Settings</h2></div></div><div></div></div><a class="indexterm" name="d0e942"></a><p>
+Provides a detailed discussion of all available settings to configure Jalopy.
+</p><p><a name="settings-directory"></a>
+Jalopy stores all settings as files inside its
+<i class="firstterm">Settings directory</i> (or subdirectories thereof).
+This directory is located in the user home directory (<tt class="filename">$HOME/.jalopy</tt>).
+</p><a class="indexterm" name="d0e957"></a><p>
+A graphical user interface is provided to easily configure the settings.
+Please refer to the individual Plug-in chapters in <a href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins">Part&nbsp;II, &#8220;Plug-ins&#8221;</a>
+for information on how to display it from within the Plug-in you received.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="general"></a>4.1.&nbsp;General</h2></div></div><div></div></div><p><a name="code-convention"></a>
+Jalopy stores its settings in a binary file
+<tt class="filename">$HOME/.jalopy/<i class="replaceable"><tt>PROJECT_DIR</tt></i>/preferences.dat</tt>.
+However you can import/export your settings in both the binary, and a textual
+XML format. A group of settings forms a <i class="firstterm">code convention</i>.
+</p><a class="indexterm" name="d0e979"></a><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="general-convention"></a>4.1.1.&nbsp;Convention</h3></div></div><div></div></div><p>
+Lets you name a group of settings, a code convention.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Name
+</p><p>
+The name of the code convention. The name must be no longer than 10 characters.
+</p></li><li><p>
+Description
+</p><p>
+Stores a short description for the code convention.
+</p></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="general-compliance"></a>4.1.2.&nbsp;Compliance</h3></div></div><div></div></div><p>
+Lets you specify whether Java sources should be treated as JDK 1.3 or
+as JDK 1.4 compatible. The latter means <tt class="literal">assert</tt> will be
+recognized as a reserved keyword.
+</p><a class="indexterm" name="d0e1006"></a><a class="indexterm" name="d0e1009"></a><a class="indexterm" name="d0e1012"></a><div class="itemizedlist"><ul type="disc"><li><p>
+Source compatibility
+</p><p>
+Lets you choose the JDK version to use for source compatibility.
+</p></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="import-export"></a>4.1.3.&nbsp;Import/Export</h3></div></div><div></div></div><p>
+Use the <span><b class="guibutton">Import...</b></span> and <span><b class="guibutton">Export...</b></span>
+buttons to import an already-saved code convention, or export your current settings as
+a new code convention. You can choose between the binary <tt class="filename">.jal</tt> format
+or an XML representation.
+</p><p>
+Jalopy is able to import settings from both local and distributed locations.
+Just specify a valid Internet address (either starting with <i class="firstterm">http://</i> or
+<i class="firstterm">www.</i>) for the latter. Jalopy will then attempt to synchronize
+its settings with the given url on every invocation. That way it is easy to
+share a single code convention across a group of developers.
+</p><p>
+Please note that versions prior to 1.0b8 stored the backup directory always as
+an absolute file. Therefore after importing a code convention, you should
+check whether this directory points to your preferred backup directory. This
+advice holds true even for later versions in case you've changed the default
+backup directory.
+</p><p>
+However if the backup directory setting is left untouched, the directory is
+stored relative to the Jalopy settings directory. This way you can savely
+share your code convention across different systems and platforms.
+</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="usage.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-core.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="project.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;3.&nbsp;Usage&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.2.&nbsp;Projects</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..5aac458 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.12.&nbsp;Sorting</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="footer.html" title="4.3.11.&nbsp;Footer"><link rel="next" href="misc.html" title="4.3.13.&nbsp;Misc"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="sorting.html#sorting-general" title="4.3.12.1.&nbsp;Declarations"><link rel="subsection" href="sorting.html#d0e4876" title="4.3.12.2.&nbsp;Modifiers">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.12.&nbsp;Sorting</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="footer.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="misc.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="sorting"></a>4.3.12.&nbsp;Sorting</h3></div></div><div></div></div><p>Lets you tweak the sorting settings.</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sorting-general"></a>4.3.12.1.&nbsp;Declarations</h4></div></div><div></div></div><p>
+At first glance, sorting of class declaration elements may seem somewhat
+obscure, but good sorting can lead to a reduction of complexity if the
+location of each element is predictable.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="sorting-general-elements"></a>
+Sort class elements
+</p><p>
+Enables or disables the sorting of class elements.
+</p><div class="example"><a name="ex-sort-file"></a><p class="title"><b>Example&nbsp;4.149.&nbsp;Sorted Java source file (with <a href="separation.html#separation-comment" title="4.3.5.3.&nbsp;Comments">Separator comments</a>)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+class TypePrinter
+    extends AbstractPrinter
+{
+    //~ Instance/static variables ----------------------------------------------
+
+    /** Singleton. */
+    private final static Printer INSTANCE = new TypePrinter();
+
+    //~ Constructors -----------------------------------------------------------
+
+    /**
+     * Creates a new TypePrinter object.
+     */
+    protected TypePrinter()
+    {
+    }
+
+    //~ Methods ----------------------------------------------------------------
+
+    public static Printer getInstance()
+    {
+        return INSTANCE;
+    }
+
+    public void print(AST node, ASTWriter out)
+               throws IOException
+    {
+        AST child = node.getFirstChild();
+        PrinterFactory.create(child).print(child, out);
+    }
+}
+</pre></td></tr></table></div><p></p></li><li><p>Ordering</p><p>
+You can specify the order in which static variable/initializer, instance variable,
+instance initializer, constructor, method, inner class and interface elements
+should appear in source files by selecting the element type and moving it up or
+down the list.
+</p><p>
+If you enable any of the check boxes, all elements of the selected type
+(within a section) will be sorted too. First by access modifier
+(public, protected, package protected, private) and - for two elements with the
+same accessibility - lexicographically. For methods those which follow the Java
+Bean pattern (getXXX, setXXX, isXXX) will be sorted first.
+</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4876"></a>4.3.12.2.&nbsp;Modifiers</h4></div></div><div></div></div><p><a name="sorting-modifier"></a>
+Enables or disables the sorting of declaration modifiers.
+</p><div class="itemizedlist"><ul type="disc"><li><p>Ordering</p><p>
+Lets you specify the order in which the individual modifiers should appear.
+Select an entry and use the <span><b class="guibutton">Up</b></span> and <span><b class="guibutton">Down</b></span>
+buttons to move it to the desired location.
+</p></li></ul></div><p></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="footer.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="misc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.11.&nbsp;Footer&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.13.&nbsp;Misc</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..75fe0f4 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Chapter&nbsp;3.&nbsp;Usage</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="previous" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="next" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;3.&nbsp;Usage</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="build.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;Jalopy core</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="settings.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="usage"></a>Chapter&nbsp;3.&nbsp;Usage</h2></div></div><div></div></div><a class="indexterm" name="d0e931"></a><p>Usage depends on the distribution you received. Please refer to the
+individual Plug-in chapters in <a href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins">Part&nbsp;II, &#8220;Plug-ins&#8221;</a> for details.
+</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="build.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="part-core.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="settings.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;2.&nbsp;Building&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;4.&nbsp;Settings</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..86081a9 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.2.&nbsp;White Space</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="printer.html" title="4.3.&nbsp;Printer"><link rel="next" href="indentation.html" title="4.3.3.&nbsp;Indentation"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="whitespace.html#whitespace-before" title="4.3.2.1.&nbsp;Space before"><link rel="subsection" href="whitespace.html#space-after" title="4.3.2.2.&nbsp;Space after"><link rel="subsection" href="whitespace.html#padding" title="4.3.2.3.&nbsp;Spaces around">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.2.&nbsp;White Space</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="printer.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="indentation.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="whitespace"></a>4.3.2.&nbsp;White Space</h3></div></div><div></div></div><a class="indexterm" name="d0e1436"></a><p>
+Controls the white space handling for the individual components of Java statements.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="whitespace-before"></a>4.3.2.1.&nbsp;Space before</h4></div></div><div></div></div><a class="indexterm" name="d0e1444"></a><p>
+Lets you choose the components that should get one leading space inserted before them.
+</p><div class="itemizedlist"><ul type="disc"><li><p>
+Method declaration parentheses
+</p><div class="example"><a name="ex-space-before-method-paren"></a><p class="title"><b>Example&nbsp;4.9.&nbsp;Method declaration parentheses</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void someMethod<span class="bold"><b>(</b></span>)) {
+  ...
+}
+
+public void someMethod <span class="bold"><b>(</b></span>)) {
+  ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-before-parentheses"></a>
+Method call parentheses
+</p><a class="indexterm" name="d0e1470"></a><a class="indexterm" name="d0e1477"></a><div class="example"><a name="ex-space-before-method-call-paren"></a><p class="title"><b>Example&nbsp;4.10.&nbsp;Method call parentheses</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (Iterator i = pointList.iterator<span class="bold"><b>(</b></span>); i.hasNext<span class="bold"><b>(</b></span>);) {
+    ...
+}
+
+for (Iterator i = pointList.iterator <span class="bold"><b>(</b></span>); i.hasNext <span class="bold"><b>(</b></span>);) {
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p>
+Statement parentheses
+</p><div class="example"><a name="ex-space-before-statement-paren"></a><p class="title"><b>Example&nbsp;4.11.&nbsp;Statement parentheses</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+while<span class="bold"><b>(</b></span>!isDone)
+    doSomething();
+
+while <span class="bold"><b>(</b></span>!isDone)
+    doSomething();
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-before-braces"></a>
+Braces
+</p><a class="indexterm" name="d0e1516"></a><div class="example"><a name="ex-space-before-braces"></a><p class="title"><b>Example&nbsp;4.12.&nbsp;Braces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+    String[] values = new String[]<span class="bold"><b>{</b></span>
+        "One", "Two", "Three", "Four", "Five", "Six", "Seven"
+    };
+
+    String[] values = new String[] <span class="bold"><b>{</b></span>
+        "One", "Two", "Three", "Four", "Five", "Six", "Seven"
+    };
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-before-brackets"></a>
+Brackets
+</p><a class="indexterm" name="d0e1538"></a><div class="example"><a name="ex-space-before-brackets"></a><p class="title"><b>Example&nbsp;4.13.&nbsp;Brackets</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (i = 0; i &lt; 100; i++)
+    sum += value<span class="bold"><b>[</b></span>i];
+
+for (i = 0; i &lt; 100; i++)
+    sum += value <span class="bold"><b>[</b></span>i];
+</pre></td></tr></table></div><p></p></li><li><p>
+Brackets in types
+</p><div class="example"><a name="ex-space-before-brackets-types"></a><p class="title"><b>Example&nbsp;4.14.&nbsp;Brackets in types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String<span class="bold"><b>[</b></span>] names = (String<span class="bold"><b>[</b></span>])data.toArray(new String<span class="bold"><b>[</b></span>]);
+
+String <span class="bold"><b>[</b></span>] names = (String <span class="bold"><b>[</b></span>])data.toArray(new String <span class="bold"><b>[</b></span>]);
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-before-colon"></a>
+Case colon
+</p><a class="indexterm" name="d0e1587"></a><div class="example"><a name="ex-space-before-case-colon"></a><p class="title"><b>Example&nbsp;4.15.&nbsp;Case colon</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+switch (character) {
+    case 'A'<span class="bold"><b>:</b></span>
+        break;
+}
+
+switch (character) {
+    case 'A' <span class="bold"><b>:</b></span>
+        break;
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="space-after"></a>4.3.2.2.&nbsp;Space after</h4></div></div><div></div></div><a class="indexterm" name="d0e1609"></a><p>
+Lets you choose what components should have one trailing space inserted after the component.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="whitespace-after-comma"></a>
+Comma
+</p><a class="indexterm" name="d0e1620"></a><a class="indexterm" name="d0e1627"></a><div class="example"><a name="ex-space-after-comma"></a><p class="title"><b>Example&nbsp;4.16.&nbsp;Comma</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething (a<span class="bold"><b>,</b></span>b<span class="bold"><b>,</b></span>c<span class="bold"><b>,</b></span>d);
+
+doSomething (a<span class="bold"><b>,</b></span> b<span class="bold"><b>,</b></span> c<span class="bold"><b>,</b></span> d);
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-after-semi"></a>
+Semicolon
+</p><a class="indexterm" name="d0e1657"></a><a class="indexterm" name="d0e1664"></a><div class="example"><a name="ex-space-after-semi"></a><p class="title"><b>Example&nbsp;4.17.&nbsp;Semicolon</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (i=0<span class="bold"><b>;</b></span>i&lt;<span class="bold"><b></b></span>10<span class="bold"><b>;</b></span>i++) ...
+
+for (i=0<span class="bold"><b>;</b></span> i&lt;<span class="bold"><b></b></span>10<span class="bold"><b>;</b></span> i++) ...
+</pre></td></tr></table></div><p></p></li><li><p><a name="whitespace-after-cast"></a>
+Type Cast
+</p><a class="indexterm" name="d0e1692"></a><a class="indexterm" name="d0e1699"></a><div class="example"><a name="ex-space-after-cast"></a><p class="title"><b>Example&nbsp;4.18.&nbsp;Type Cast</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int line = ((JavaAST<span class="bold"><b>)</b></span>node).getStartLine();
+
+int line = ((JavaAST<span class="bold"><b>)</b></span> node).getStartLine();
+</pre></td></tr></table></div><p></p></li><li><p>
+Negation
+</p><p>
+Prints a space after the unary operators Logical NOT (!) and Bitwise NOT (~).
+</p><div class="example"><a name="ex-space-after-negation"></a><p class="title"><b>Example&nbsp;4.19.&nbsp;Logical NOT</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+while(!isDone) {
+    doSomething();
+}
+
+while(! isDone) {
+    doSomething();
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="padding"></a>4.3.2.3.&nbsp;Spaces around</h4></div></div><div></div></div><p>
+Controls what components should have both a leading and trailing space inserted. This is sometimes called "padding".
+<a class="indexterm" name="d0e1730"></a>
+<a class="indexterm" name="d0e1736"></a>
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="padding-assign"></a>
+Assignment Operators
+<a class="indexterm" name="d0e1744"></a>
+<a class="indexterm" name="d0e1748"></a>
+<a class="indexterm" name="d0e1754"></a>
+
+</p><div class="example"><a name="ex-padding-op-assign"></a><p class="title"><b>Example&nbsp;4.20.&nbsp;Assignment Operators (=, +=, -=, *=, \=, %=, &amp;=, |=, ^=, &lt;&lt;=, &gt;&gt;=, &gt;&gt;&gt;=)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+a<span class="bold"><b>=</b></span>(b+c)*d;
+a <span class="bold"><b>=</b></span> (b+c)*d;
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-logical"></a>
+Logical Operators
+<a class="indexterm" name="d0e1777"></a>
+<a class="indexterm" name="d0e1781"></a>
+<a class="indexterm" name="d0e1787"></a>
+</p><div class="example"><a name="ex-padding-op-logical"></a><p class="title"><b>Example&nbsp;4.21.&nbsp;Logical Operators (&amp;&amp;, ||)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if((LA(1)=='/')<span class="bold"><b>&amp;&amp;</b></span>(LA(2)!='*'<span class="bold"><b>||</b></span>(LA(2)=='*'<span class="bold"><b>&amp;&amp;</b></span>LA(3)!='*'))) ...
+
+if((LA(1)=='/') <span class="bold"><b>&amp;&amp;</b></span> (LA(2)!='*' <span class="bold"><b>||</b></span> (LA(2)=='*' <span class="bold"><b>&amp;&amp;</b></span> LA(3)!='*'))) ...
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-relational"></a>
+Relational Operators
+<a class="indexterm" name="d0e1822"></a>
+<a class="indexterm" name="d0e1828"></a>
+<a class="indexterm" name="d0e1832"></a>
+
+</p><div class="example"><a name="ex-padding-op-relational"></a><p class="title"><b>Example&nbsp;4.22.&nbsp;Relational Operators (==, !=, &lt;, &gt;, &lt;=, &gt;=)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if((LA(1)<span class="bold"><b>==</b></span>'\n'||LA(1)<span class="bold"><b>==</b></span>'\r')) ...
+
+if((LA(1) <span class="bold"><b>==</b></span> '\n'||LA(1) <span class="bold"><b>==</b></span> '\r')) ...
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-bitwise"></a>
+Bitwise Operators
+<a class="indexterm" name="d0e1861"></a>
+<a class="indexterm" name="d0e1865"></a>
+<a class="indexterm" name="d0e1871"></a>
+</p><div class="example"><a name="ex-padding-op-bitwise"></a><p class="title"><b>Example&nbsp;4.23.&nbsp;Bitwise Operators (&amp;, |, ^)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static final boolean isUnix()
+{
+    return (getOperatingSystem()<span class="bold"><b>&amp;</b></span>PLAT_UNIX) != 0;
+}
+
+public static final boolean isUnix()
+{
+    return (getOperatingSystem()<span class="bold"><b> &amp; </b></span>PLAT_UNIX) != 0;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-mathematical"></a>
+Mathematical Operators
+<a class="indexterm" name="d0e1894"></a>
+<a class="indexterm" name="d0e1898"></a>
+<a class="indexterm" name="d0e1904"></a>
+
+</p><div class="example"><a name="ex-padding-op-math"></a><p class="title"><b>Example&nbsp;4.24.&nbsp;Mathematical Operators (+, -, /, *, %)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+a=(b<span class="bold"><b>+</b></span>c)<span class="bold"><b>*</b></span>d;
+
+a=(b <span class="bold"><b>+</b></span> c) <span class="bold"><b>*</b></span> d;
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-shift"></a>
+Shift Operators
+<a class="indexterm" name="d0e1933"></a>
+<a class="indexterm" name="d0e1937"></a>
+<a class="indexterm" name="d0e1943"></a>
+</p><div class="example"><a name="ex-padding-op-shift"></a><p class="title"><b>Example&nbsp;4.25.&nbsp;Shift Operators (&lt;&lt;, &gt;&gt;, &gt;&gt;&gt;)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if(((1L<span class="bold"><b>&lt;&lt;</b></span>i)&amp;l)!=0)
+    System.out.print("1");
+
+if(((1L <span class="bold"><b>&lt;&lt;</b></span> i)&amp;l)!=0)
+    System.out.print("1");
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-braces"></a>
+Braces
+<a class="indexterm" name="d0e1966"></a>
+<a class="indexterm" name="d0e1970"></a>
+<a class="indexterm" name="d0e1976"></a>
+
+</p><div class="example"><a name="ex-padding-braces"></a><p class="title"><b>Example&nbsp;4.26.&nbsp;Braces</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+Object[] items = <span class="bold"><b>{</b></span>"2", "3", "4"<span class="bold"><b>}</b></span>;
+
+Object[] items = <span class="bold"><b>{</b></span> "2", "3", "4" <span class="bold"><b>}</b></span>;
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-brackets"></a>
+Brackets
+<a class="indexterm" name="d0e2005"></a>
+<a class="indexterm" name="d0e2009"></a>
+<a class="indexterm" name="d0e2015"></a>
+</p><div class="example"><a name="ex-padding-brackets"></a><p class="title"><b>Example&nbsp;4.27.&nbsp;Brackets</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+for (i = 0; i &lt; 100; i++)
+    sum += value<span class="bold"><b>[</b></span>i<span class="bold"><b>]</b></span>;
+
+for(i = 0; i &lt; 100; i++)
+    sum += value<span class="bold"><b>[</b></span> i <span class="bold"><b>]</b></span>;
+</pre></td></tr></table></div><p></p></li><li><p><a name="padding-parentheses"></a>
+Parentheses
+<a class="indexterm" name="d0e2044"></a>
+<a class="indexterm" name="d0e2048"></a>
+<a class="indexterm" name="d0e2054"></a>
+</p><div class="example"><a name="ex-padding-paren"></a><p class="title"><b>Example&nbsp;4.28.&nbsp;Parentheses</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+GridBagLayout layout = new GridBagLayout();
+setLayout<span class="bold"><b>(</b></span>layout<span class="bold"><b>)</b></span>;
+
+GridBagLayout layout = new GridBagLayout();
+setLayout<span class="bold"><b>(</b></span> layout <span class="bold"><b>)</b></span>;
+</pre></td></tr></table></div><p></p></li><li><p>
+Type Cast Parentheses
+</p><div class="example"><a name="ex-padding-cast"></a><p class="title"><b>Example&nbsp;4.29.&nbsp;Type Cast Parentheses</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+int line = (<span class="bold"><b>(</b></span>JavaAST<span class="bold"><b>)</b></span>node).getStartLine();
+
+int line = (<span class="bold"><b>(</b></span> JavaAST <span class="bold"><b>)</b></span>node).getStartLine();
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="printer.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="indentation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.&nbsp;Printer&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.3.&nbsp;Indentation</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 62e881d..824116f 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>4.3.4.&nbsp;Wrapping</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3.&nbsp;Printer"><link rel="previous" href="indentation.html" title="4.3.3.&nbsp;Indentation"><link rel="next" href="separation.html" title="4.3.5.&nbsp;Blank Lines"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part&nbsp;I.&nbsp;Jalopy core"><link rel="chapter" href="installation.html" title="Chapter&nbsp;1.&nbsp;Installation"><link rel="chapter" href="build.html" title="Chapter&nbsp;2.&nbsp;Building"><link rel="chapter" href="usage.html" title="Chapter&nbsp;3.&nbsp;Usage"><link rel="chapter" href="settings.html" title="Chapter&nbsp;4.&nbsp;Settings"><link rel="part" href="part-plugins.html" title="Part&nbsp;II.&nbsp;Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter&nbsp;5.&nbsp;Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter&nbsp;6.&nbsp;Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter&nbsp;7.&nbsp;Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter&nbsp;8.&nbsp;JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter&nbsp;9.&nbsp;JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter&nbsp;10.&nbsp;jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter&nbsp;11.&nbsp;NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix&nbsp;A.&nbsp;Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix&nbsp;B.&nbsp;The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix&nbsp;C.&nbsp;ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix&nbsp;D.&nbsp;The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix&nbsp;E.&nbsp;GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix&nbsp;F.&nbsp;GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix&nbsp;G.&nbsp;Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix&nbsp;H.&nbsp;SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="wrapping.html#wrap-general" title="4.3.4.1.&nbsp;General"><link rel="subsection" href="wrapping.html#wrap-always" title="4.3.4.2.&nbsp;Always"><link rel="subsection" href="wrapping.html#wrap-misc" title="4.3.4.3.&nbsp;Misc">
+      <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> 
+      <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> 
+    </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> &#149;
+                    <a href="./download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./links.html" class="navlink">Links</a> &#149;
+                    <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> |
+                    <a href="./history.html" class="navlink2">History</a> |
+                    <a href="./manual.html" class="navlink2">Manual</a> |
+                    <a href="./faq.html" class="navlink2">FAQ</a> |
+                    <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px">
+                    This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.4.&nbsp;Wrapping</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="indentation.html">Prev</a>&nbsp;</td><th width="60%" align="center">4.3.&nbsp;Printer</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="separation.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="wrapping"></a>4.3.4.&nbsp;Wrapping</h3></div></div><div></div></div><a class="indexterm" name="d0e2657"></a><a class="indexterm" name="d0e2660"></a><p>
+Controls when and how lines gets wrapped.
+</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-general"></a>4.3.4.1.&nbsp;General</h4></div></div><div></div></div><p>
+Lets you control the general line wrapping options.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-general-general"></a>4.3.4.1.1.&nbsp;General</h5></div></div><div></div></div><p>
+Lets you control the general line wrapping options.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-use"></a>
+Wrap lines
+</p><p>
+Enables or disables the automatic line wrapping.
+</p></li><li><p><a name="wrap-sizes-line"></a>
+Line length
+</p><p>
+Lets you specify the maximum line length. Jalopy tries (more or less) to limit
+each line within the given length.
+</p><a class="indexterm" name="d0e2686"></a><a class="indexterm" name="d0e2691"></a></li><li><p><a name="wrap-sizes-deep"></a>
+Deep indent
+</p><a class="indexterm" name="d0e2697"></a><a class="indexterm" name="d0e2702"></a><p>
+Specifies the length after which a gap will be identified as "deep indented".
+Jalopy tries to avoid these kind of gaps and will force a line break or apply
+another indentation scheme, if this size is exceeded.
+</p><div class="example"><a name="ex-wrap-sizes-deep"></a><p class="title"><b>Example&nbsp;4.65.&nbsp;Deep indent size (60) not exceeded</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+                                                            |                  |
+    protected static synchronized File getANewDestinationFile(File dest,       |
+                                                            | String packageName,
+                                                            | String filename) |
+|----------------- the gap ---------------------------|throws IOException      |
+    {                                                       |                  |
+    }                                                       |                  |
+                                                            |                  |
+                                                            60                 79
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-sizes-deep-exceed"></a><p class="title"><b>Example&nbsp;4.66.&nbsp;Deep indent size (50) exeeded</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+                                                  |                            |
+    protected static synchronized File getANewDestinationFile(File dest,       |
+                                                  |           String packageName,
+                                                  |           String filename) |
+|----------------- the gap ---------------------------|throws IOException      |
+    {                                             |                            |
+    }                                             |                            |
+                                                  |                            |
+                                                  50                           79
+</pre></td></tr></table></div></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-policy"></a>4.3.4.1.2.&nbsp;Policy</h5></div></div><div></div></div><a class="indexterm" name="d0e2721"></a><a class="indexterm" name="d0e2726"></a><p>
+Lets you fine-control the wrapping behaviour.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-left-parenthesis"></a>
+Wrap after left parenthesis
+</p><p>
+Lets you control the wrapping behaviour for statement and expression lists.
+</p><p>
+If left disabled, the first line break will be preferably inserted
+behind the first parameter or expression and only occurs after the left
+parenthesis if the maximum line length would be exceeded.</p><div class="example"><a name="ex-wrap-left-parenthesis-disabled"></a><p class="title"><b>Example&nbsp;4.67.&nbsp;Wrap after left parenthesis (disabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+                                                                               |
+appServerReferencesVector.add<span class="bold"><b>(</b></span>new AppServerReference<span class="bold"><b>(</b></span>
+        "RemoteApplicationManager",                                            |
+        poa.create_reference_with_id<span class="bold"><b>(</b></span>         |
+            "RemoteApplicationManager".getBytes(),                             |
+            RemoteApplicationManagerHelper.id())));                            |
+                                                                               |
+</pre></td></tr></table></div><p>
+Otherwise the line break will always occur behind the left parenthesis.
+</p><div class="example"><a name="ex-wrap-left-parenthesis-enabled"></a><p class="title"><b>Example&nbsp;4.68.&nbsp;Wrap after left parenthesis (enabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+appServerReferencesVector.add<span class="bold"><b>(</b></span>
+    new AppServerReference<span class="bold"><b>(</b></span>
+        "RemoteApplicationManager",
+        poa.create_reference_with_id<span class="bold"><b>(</b></span>
+            "RemoteApplicationManager".getBytes(),
+            RemoteApplicationManagerHelper.id())));
+</pre></td></tr></table></div><p>
+This switch affects the output style of method/constructor declarations and
+calls, creator statements and <tt class="literal">if-else</tt>, <tt class="literal">for</tt>,
+<tt class="literal">while</tt> and <tt class="literal">do-while</tt> blocks.
+</p><p>
+As per default, the wrapped lines will be indended using
+<a href="indentation.html#indentation-policy-standard">Standard indentation</a>, but you
+may want to apply another indentation scheme. See
+<a href="indentation.html#indentation-policy" title="4.3.3.1.1.&nbsp;Policy">Section&nbsp;4.3.3.1.1, &#8220;Policy&#8221;</a> for more information.
+</p><p></p></li><li><p><a name="wrap-right-parenthesis"></a>
+Wrap before right parenthesis
+</p><p>
+Forces a line break before the right parenthesis of parameter or expression lists.
+The parenthesis will be intended according to the current indentation level.
+Only takes action if at least one parameter/expression was indeed wrapped.
+</p><p>
+This switch affects the output style of method/constructor declarations and
+calls, creator statements and <tt class="literal">if-else</tt>, <tt class="literal">for</tt>,
+<tt class="literal">while</tt> and <tt class="literal">do-while</tt> blocks.
+</p><div class="example"><a name="ex-wrap-right-parenthesis"></a><p class="title"><b>Example&nbsp;4.69.&nbsp;Right parenthesis (disabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one,
+                              int two,
+                              String three,
+                              StringObject four,
+                              AnotherObject five<span class="bold"><b>)</b></span> {
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-right-parenthesis-enabled"></a><p class="title"><b>Example&nbsp;4.70.&nbsp;Right parenthesis (enabled)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public void severalParameters(String one,
+                              int two,
+                              String three,
+                              StringObject four,
+                              AnotherObject five
+<span class="bold"><b>)</b></span> {
+}
+</pre></td></tr></table></div><p>
+Both switches combined, looks like the following example:
+</p><div class="example"><a name="ex-wrap-left-right-parenthesis"></a><p class="title"><b>Example&nbsp;4.71.&nbsp;Left and right parenthesis</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+appServerReferencesVector.add<span class="bold"><b>(</b></span>
+    new AppServerReference<span class="bold"><b>(</b></span>
+        "RemoteApplicationManager",
+        poa.create_reference_with_id<span class="bold"><b>(</b></span>
+            "RemoteApplicationManager".getBytes(),
+            RemoteApplicationManagerHelper.id()
+        <span class="bold"><b>)</b></span>
+    <span class="bold"><b>)</b></span>
+<span class="bold"><b>)</b></span>;
+</pre></td></tr></table></div><p>
+For blocks the output may go like this:
+</p><div class="example"><a name="ex-wrap-left-right-parenthesis-wrapped-continue"></a><p class="title"><b>Example&nbsp;4.72.&nbsp;Left and right parenthesis (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if <span class="bold"><b>(</b></span>
+    "pick".equals(m.getName()) &amp;&amp; m.isStatic() &amp;&amp; m.isPublic()
+<span class="bold"><b>)</b></span> {
+    pickFound = true;
+}
+else if <span class="bold"><b>(</b></span>
+    "pick".equals(m.getName()) &amp;&amp; m.isStatic() &amp;&amp; m.isPublic()
+<span class="bold"><b>)</b></span> {
+    pickFound = true;
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-grouping-paren"></a>
+Wrap grouping parentheses
+</p><p>
+Lets you control the wrapping behaviour for grouping parentheses. If enabled,
+linebreaks are inserted after left and before right parentheses of grouped
+expressions to let the expression(s) stand out.
+</p><div class="example"><a name="ex-wrap-grouping-no"></a><p class="title"><b>Example&nbsp;4.73.&nbsp;Grouping parentheses (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+    !<span class="bold"><b>(</b></span>(bankverbindung instanceof ObjectValue)
+    || (bankverbindung instanceof PrimitiveValue<span class="bold"><b>)</b></span>)
+) {
+    throw new RuntimeException();
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-grouping"></a><p class="title"><b>Example&nbsp;4.74.&nbsp;Wrapped grouping parentheses (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+    !<span class="bold"><b>(</b></span>
+        (bankverbindung instanceof ObjectValue)
+        || (bankverbindung instanceof TkPrimitiveValue)
+    <span class="bold"><b>)</b></span>
+) {
+    throw new RuntimeException();
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-after-assignment"></a>
+Wrap after assignments
+</p><p>
+Lets you control the way wrapping takes action for assignments. If left disabled,
+line wrapping preferably occurs as part of the expression printing. Otherwise
+wrapping will be performed right after the assignment.
+</p><div class="example"><a name="ex-wrap-assignment-no"></a><p class="title"><b>Example&nbsp;4.75.&nbsp;Don't wrap after assignment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+this.interessentenNr = new InteressentenNr(
+        Fachschluesselerzeugung.createService()
+        .getNeuerFachschluessel(
+            FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
+        )
+    );
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-assignment"></a><p class="title"><b>Example&nbsp;4.76.&nbsp;Wrap after assignment</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+this.interessentenNr =
+    new InteressentenNr(
+        Fachschluesselerzeugung.createService()
+        .getNeuerFachschluessel(
+            FachschluesselerzeugungService.FACHSCHLUESSEL_KZ_INTERESSENT
+        )
+    );
+</pre></td></tr></table></div><p></p></li></ul></div><p>
+Line wrapping will often occur with statements that consist of several (possibly long)
+expressions. Here you specify whether line wrapping should occur
+before or after the expression operator.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-before"></a>
+Wrap before operators
+</p><a class="indexterm" name="d0e2926"></a><p>
+If enabled, lines will be wrapped before the operator. The operator will be
+printed with the continuation line.
+</p><div class="example"><a name="ex-wrap-before"></a><p class="title"><b>Example&nbsp;4.77.&nbsp;Wrap before operators</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2)
+    || (condition3 &amp;&amp; condition4)
+    || !(condition5 &amp;&amp; condition6))
+{
+    doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-after"></a>
+Wrap after operators
+</p><a class="indexterm" name="d0e2942"></a><p>
+If enabled, lines will be wrapped after the operator.
+</p><div class="example"><a name="ex-wrap-after"></a><p class="title"><b>Example&nbsp;4.78.&nbsp;Wrap after operators</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if ((condition1 &amp;&amp; condition2) ||
+    (condition3 &amp;&amp; condition4) ||
+    !(condition5 &amp;&amp; condition6))
+{
+    doSomethingAboutIt();
+}
+</pre></td></tr></table></div><p>
+If you happen to use Sun Brace styling, you might want to enable
+<a href="indentation.html#indentation-misc-continuation-if">continuation indentation</a>
+to let the statement body stand out.
+</p><p></p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-always"></a>4.3.4.2.&nbsp;Always</h4></div></div><div></div></div><p>
+Lets you choose the statements/expressions that are to be wrapped always.
+</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-always-pane"></a>4.3.4.2.1.&nbsp;Wrap always</h5></div></div><div></div></div><p>
+For certain cases, the need may arise to force line wrapping to achieve a
+consistent, uniform look. If you enable any of the following switches, line wrapping
+will occur for the specified cases no matter whether you have enabled general
+line wrapping or not.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-before-extends"></a>
+Before extends keyword
+</p><p>
+Forces a line break before the extends keyword of a class/interface declaration.
+</p><div class="example"><a name="ex-wrap-before-extends"></a><p class="title"><b>Example&nbsp;4.79.&nbsp;Class/Interface extends keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable, Takable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-extends-wrapped"></a><p class="title"><b>Example&nbsp;4.80.&nbsp;Class/Interface extends keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel
+    extends Puttable, Takable
+{
+    ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-extends">Extends Indent</a> setting.
+If you leave the switch disabled, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p>
+After extends types
+</p><p>
+Forces a line wrap after each type name of the extended classes.
+</p><div class="example"><a name="ex-wrap-after-extends"></a><p class="title"><b>Example&nbsp;4.81.&nbsp;Class/Interface extends types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable, Takable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-extends-wrapped"></a><p class="title"><b>Example&nbsp;4.82.&nbsp;Class/Interface extends types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface Channel extends Puttable,
+                                 Takable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-before-implements"></a>
+Before implements keyword
+</p><p>
+Forces a line break before the implements keyword of a class declaration.
+</p><div class="example"><a name="ex-wrap-before-implements"></a><p class="title"><b>Example&nbsp;4.83.&nbsp;implements keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable, Cloneable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-implements-wrapped"></a><p class="title"><b>Example&nbsp;4.84.&nbsp;implements keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean
+    implements Comparable, Cloneable
+{
+    ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-implements">Implements Indent</a> setting.
+If you leave the switch disabled, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p><a name="wrap-after-implements"></a>
+After implements types
+</p><p>
+Forces a line wrap after each type name of the implemented classes.
+</p><div class="example"><a name="ex-wrap-implements-types"></a><p class="title"><b>Example&nbsp;4.85.&nbsp;Class implements types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable, Cloneable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-implements-types-wrapped"></a><p class="title"><b>Example&nbsp;4.86.&nbsp;Class implements types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class SynchronizedBoolean implements Comparable,
+                                            Cloneable
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-before-throws"></a>
+Before throws keyword
+</p><p>
+Forces a line break before the throws keyword of a method/constructor declaration.
+</p><div class="example"><a name="ex-wrap-before-throws"></a><p class="title"><b>Example&nbsp;4.87.&nbsp;throws keyword</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+                                String filename) throws IOException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-before-throws-wrapped"></a><p class="title"><b>Example&nbsp;4.88.&nbsp;throws keyword (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+                                String filename)
+                         throws IOException
+{
+    ...
+}
+</pre></td></tr></table></div><p>
+You can control the space printed before the keyword with the
+<a href="indentation.html#indentation-sizes-throws">Throws Indent</a> setting. If you
+leave the switch disabled, Jalopy tries to align the throws clause with the
+method/constructor parameters as with the above example. If no alignment is
+possible, the clause will be printed with
+<a href="indentation.html#indentation-sizes-general">standard indentation</a>.
+</p></li><li><p><a name="wrap-after-throws"></a>
+After throws types
+</p><p>
+Forces a line wrap after each type name of the throws clause of a method/constructor declaration.
+</p><div class="example"><a name="ex-wrap-after-throws-types"></a><p class="title"><b>Example&nbsp;4.89.&nbsp;throws types</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+                                String filename)
+                         throws IOException, FooException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-throws-types-wrapped"></a><p class="title"><b>Example&nbsp;4.90.&nbsp;throws types (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName,
+                                String filename)
+                         throws IOException,
+                                FooException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-after-throws-types-wrapped-standard"></a><p class="title"><b>Example&nbsp;4.91.&nbsp;throws types (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private static final File getDestinationFile(File dest, String packageName,
+                                             String filename)
+    throws IOException,
+          FooException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-method-params"></a>
+Method Def parameters
+</p><a class="indexterm" name="d0e3103"></a><a class="indexterm" name="d0e3106"></a><p>
+Forces a line wrap after each parameter of a method or constructor declaration.
+</p><div class="example"><a name="ex-wrap-method-params"></a><p class="title"><b>Example&nbsp;4.92.&nbsp;Method declaration parameters</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(File file, File directory, int backupLevel)
+                   throws IOException
+{
+    ...
+}
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-method-params-wrapped"></a><p class="title"><b>Example&nbsp;4.93.&nbsp;Method declaration parameters (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public static File create(File file,
+                          File directory,
+                          int backupLevel)
+                   throws IOException
+{
+    ...
+}
+</pre></td></tr></table></div></li><li><p><a name="wrap-call-chained"></a>
+Method Call chains
+</p><p>
+Forces a line wrap after each chained method call.
+</p><div class="example"><a name="ex-wrap-call-chained"></a><p class="title"><b>Example&nbsp;4.94.&nbsp;Chained Method Call</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+message.format(ERROR_SOURCE_ADDRESS).param (m_session.getAimName()).send();
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-call-chained-wrapped"></a><p class="title"><b>Example&nbsp;4.95.&nbsp;Chained Method Call (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+message.format(ERROR_SOURCE_ADDRESS)
+       .param (m_session.getAimName())
+       .send();
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-method-call-params"></a>
+Method Call parameters
+</p><p>
+Forces a line wrap after each parameter of a method call.
+</p><div class="example"><a name="ex-wrap-method-call"></a><p class="title"><b>Example&nbsp;4.96.&nbsp;Method call</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name", encryptPassword("password", _secretKey),
+                      "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-method-call-wrapped"></a><p class="title"><b>Example&nbsp;4.97.&nbsp;Method call (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name",
+                      encryptPassword("password",
+                                      _secretKey),
+                      "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p></li><li><p>
+Method Call parameters if nested
+</p><p>
+Forces a line wrap after each parameter of a method call if at least one
+parameter is a method call itself. This option can prove especially useful if
+one prefers to nest method calls as parameters rather than adding local
+variables just to hold those parameters.
+</p><div class="example"><a name="ex-wrap-method-call-nested-wrapped"></a><p class="title"><b>Example&nbsp;4.98.&nbsp;Method call if nested (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+doSomething();
+_userDatabase.addUser("Name",
+                      encryptPassword("password", _secretKey),
+                      "123 fake address");
+doSomethingElse();
+</pre></td></tr></table></div><p></p></li><li><p>
+Ternary expression question mark (<tt class="literal">?</tt>)
+</p><p>
+Forces a line wrap after the first operand.
+</p><div class="example"><a name="ex-wrap-ternary-expr"></a><p class="title"><b>Example&nbsp;4.99.&nbsp;Ternary expression question mark (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma
+               ? COMMA_SPACE : COMMA;
+</pre></td></tr></table></div><p>
+Indentation for consecutive lines depends on the used <a href="indentation.html#indentation-policy" title="4.3.3.1.1.&nbsp;Policy">indenatation policy</a>.
+You may further want to use <a href="indentation.html#indentation-misc-ternary-if-else">continuation indentation</a>.
+</p></li><li><p><a name="wrap-ternary-colon"></a>
+Ternary expression colon (<tt class="literal">:</tt>)
+</p><p>
+Forces a line wrap after the second operand.
+</p><div class="example"><a name="ex-wrap-ternary-values"></a><p class="title"><b>Example&nbsp;4.100.&nbsp;Ternary expression colon</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma ? COMMA_SPACE
+                               : COMMA;
+</pre></td></tr></table></div><p>
+If both switches are disabled, ternary expressions are printed in one line (if everything fits in one line, that is).
+</p><div class="example"><a name="ex-wrap-ternary"></a><p class="title"><b>Example&nbsp;4.101.&nbsp;Ternary expressions</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma ? COMMA_SPACE : COMMA;
+</pre></td></tr></table></div><p>
+If both switches are enabled, you can force a style like the following:
+</p><div class="example"><a name="ex-wrap-ternary-continued"></a><p class="title"><b>Example&nbsp;4.102.&nbsp;Ternary expressions (continued)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String comma = spaceAfterComma
+    ? COMMA_SPACE
+    : COMMA;
+</pre></td></tr></table></div><p></p></li><li><p><a name="wrap-always-label"></a>
+Labels
+</p><a class="indexterm" name="d0e3222"></a><a class="indexterm" name="d0e3225"></a><p>
+Forces a line wrap after labels.
+</p><div class="example"><a name="ex-wrap-always-label"></a><p class="title"><b>Example&nbsp;4.103.&nbsp;Label</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+// advance to the first CLASS_DEF or INTERFACE_DEF
+LOOP:   for (AST child = tree.getFirstChild();
+             child != null;
+             child = child.getNextSibling())
+        {
+            switch (child.getType())
+            {
+                case JavaTokenTypes.CLASS_DEF :
+                case JavaTokenTypes.INTERFACE_DEF :
+                    next = child;
+                    break LOOP;
+
+                default :
+                    break;
+            }
+        }
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wraping-always-label-wrapped"></a><p class="title"><b>Example&nbsp;4.104.&nbsp;Label (wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+// advance to the first CLASS_DEF or INTERFACE_DEF
+LOOP:
+        for (AST child = tree.getFirstChild();
+             child != null;
+             child = child.getNextSibling())
+        {
+            switch (child.getType())
+            {
+                case JavaTokenTypes.CLASS_DEF :
+                case JavaTokenTypes.INTERFACE_DEF :
+                    next = child;
+                    break LOOP;
+
+                default :
+                    break;
+            }
+        }
+</pre></td></tr></table></div><p></p></li></ul></div></div><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-always-exceed"></a>4.3.4.2.2.&nbsp;Wrap always when exceed</h5></div></div><div></div></div><p>
+Lets you force wrapping for <span class="emphasis"><em>all</em></span> parameter or expressions if
+the parameter or expression list would otherwise exceed the maximal line length.
+If you enable any of the following switches, line wrapping
+may occur for the specified cases no matter whether you have enabled general
+line wrapping or not.
+</p><div class="itemizedlist"><ul type="disc"><li><p><a name="wrap-always-extends"></a>
+After extends types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">extends</tt> clause of a
+class/interface declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-extends"></a><p class="title"><b>Example&nbsp;4.105.&nbsp;Extends types wrapped as needed (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface VeryImportantInterface                        |
+    extends LeastImportantInterface, LessImportantInterface,   |
+        ImportantInterface                                     |
+}                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-extends-enabled"></a><p class="title"><b>Example&nbsp;4.106.&nbsp;Extends types wrapping forced (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public interface VeryImportantInterface                        |
+    extends LeastImportantInterface,                           |
+        LessImportantInterface,                                |
+        ImportantInterface                                     |
+}                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-implements"></a>
+After implements types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">implements</tt> clause of a
+class/interface declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-implements"></a><p class="title"><b>Example&nbsp;4.107.&nbsp;Implements types wrapped as needed (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class ImportantClass                                    |
+    implements ImportantInterface, Serializable, Comparable,   |
+        Cloneable                                              |
+}                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-implements-enabled"></a><p class="title"><b>Example&nbsp;4.108.&nbsp;Implements types wrapping forced (standard indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+public class ImportantClass                                    |
+    implements ImportantInterface,                             |
+        Serializable,                                          |
+        Comparable,                                            |
+        Cloneable                                              |
+}                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-throws"></a>
+After throws types
+</p><p>
+Forces a line wrap after each type name of the <tt class="literal">throws</tt> clause of a
+method/constructor declaration if the whole clause does not fit in one line.
+</p><div class="example"><a name="ex-wrap-always-throws"></a><p class="title"><b>Example&nbsp;4.109.&nbsp;Throws types wrapped as needed (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName, |
+                                String filename)               |
+                         throws IOException, FooException,     |
+                                FooBarException                |
+{                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div><p></p><div class="example"><a name="wrap-always-throws-enabled"></a><p class="title"><b>Example&nbsp;4.110.&nbsp;Throws types wrapping forced (deep indented)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+private File getDestinationFile(File dest, String packageName, |
+                                String filename)               |
+                         throws IOException,                   |
+                                FooException,                  |
+                                FooBarException                |
+{                                                              |
+    ...                                                        |
+}                                                              |
+</pre></td></tr></table></div></li><li><p><a name="wrap-always-param"></a>
+After parameters/expressions
+</p><p>
+If enabled, this switch will cause all parameters/expressions to be
+wrapped, if and only if the first parameter/expression of the list has been
+wrapped.
+</p><div class="example"><a name="ex-wrap-all"></a><p class="title"><b>Example&nbsp;4.111.&nbsp;Expression list (all wrapped)</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+if (
+    "pick".equals(m.getName()) &amp;&amp;
+    m.isStatic() &amp;&amp;
+    m.isPublic()
+) {
+    pickFound = true;
+}
+else if (
+    "pick".equals(m.getName()) &amp;&amp;
+    m.isStatic() &amp;&amp;
+    m.isPublic()
+) {
+    pickFound = true;
+}
+</pre></td></tr></table></div><p></p></li></ul></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="wrap-misc"></a>4.3.4.3.&nbsp;Misc</h4></div></div><div></div></div><p>Lets you control miscellaneous wrapping settings.</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="wrap-misc-arrays"></a>4.3.4.3.1.&nbsp;Arrays</h5></div></div><div></div></div><p>Contains options to control the wrapping for arrays.</p><div class="itemizedlist"><ul type="disc"><li><p>Wrap as needed</p><p>Enabling this options means array elements will be wrapped so that they
+will be limited within the current <a href="wrapping.html#wrap-sizes-line">line length</a> setting.</p><div class="example"><a name="ex-wrap-arrays-as-needed"></a><p class="title"><b>Example&nbsp;4.112.&nbsp;Wrap as needed</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = {                                               |
+    "patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter",  |
+    "okButton.top=patternPanel.bottom+20",                             |
+    "okButton.right=form.hcenter-10", "cancelButton.vcenter=10",       |
+    "cancelButton.left=10"                                             |
+};                                                                     |
+</pre></td></tr></table></div><p></p></li><li><p>Wrap after element</p><p>Forces a newline after every  n-th element.</p><div class="example"><a name="ex-wrap-arrays-after-one"></a><p class="title"><b>Example&nbsp;4.113.&nbsp;Wrap after element 1</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = {                                               |
+    "patternPanel.top=form.top",                                       |
+    "patternPanel.hcenter=form.hcenter",                               |
+    "okButton.top=patternPanel.bottom+20",                             |
+    "okButton.right=form.hcenter-10",                                  |
+    "cancelButton.vcenter=10",                                         |
+    "cancelButton.left=10"                                             |
+};                                                                     |
+</pre></td></tr></table></div><p></p><div class="example"><a name="ex-wrap-arrays-after-two"></a><p class="title"><b>Example&nbsp;4.114.&nbsp;Wrap after element 2</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">
+String[] constraints = {                                               |
+    "patternPanel.top=form.top", "patternPanel.hcenter=form.hcenter",
+    "okButton.top=patternPanel.bottom+20", "okButton.right=form.hcenter-10",
+    "cancelButton.vcenter=10", "cancelButton.left=10"                  |
+};                                                                     |
+</pre></td></tr></table></div><p>
+If both options are left disabled, the array elements will be printed in one
+line, right after the left curly brace.
+</p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="indentation.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="separation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.3.&nbsp;Indentation&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;4.3.5.&nbsp;Blank Lines</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&amp;type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>
index 49c78cd..1262ed1 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title></title><link rel="stylesheet" href="./docs/site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"></head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="center"><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./docs/index.html" class="navlink">Overview</a> &#149;
+                    <a href="./docs/download.html" class="navlink">Download</a> &#149;
+                    <a href="./docs/docs.html" class="navlink">Documentation</a> &#149;
+                    <a href="./docs/plugins.html" class="navlink">Plug-ins</a> &#149;
+                    <a href="./docs/links.html" class="navlink">Links</a> &#149;
+                    <a href="./docs/contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" style="padding-right:3px"></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" width="100%" cellspacing="0" cellpadding="5"><tbody><tr><td><div class="article" lang="en"><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e2"></a>README Ant Task</h2></div></div><div></div></div></div><p>
+This is the README for the Ant Task distribution of the Jalopy Java
+Source Code Formatter. This Plug-in provides the integration with the
+wonderful Jakarta build tool.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e5"></a>1.&nbsp;Distribution libraries</h2></div></div><div></div></div><p>
+This distribution contains the following libraries:
+</p><div class="itemizedlist"><ul type="square"><li style="list-style-type: square">
+  AElfred XML Parser (<tt class="filename">aelfred-1.2.jar</tt>)
+</li><li style="list-style-type: square">
+  A modified and re-packaged <a href="http://www.antlr.org" target="_top">ANTLR</a> Parser Generator runtime 2.7.2a2 (bundled with the Jalopy runtime)
+</li><li style="list-style-type: square">
+  Jalopy Java Source Code Formatter runtime (<tt class="filename">jalopy-1.0b11.jar</tt>)
+</li><li style="list-style-type: square">
+  Jalopy Ant Task (<tt class="filename">jalopy-ant-0.6.2.jar</tt>)
+</li><li style="list-style-type: square"><a href="http://java.sun.com/xml/" target="_top">JAXP</a> Java API for XML Processing (<tt class="filename">jaxp-1.2.jar</tt>)
+</li><li style="list-style-type: square"><a href="http://www.jdom.org/" target="_top">JDOM</a> XML API (<tt class="filename">jdom-1.0b8.jar</tt>)
+</li><li style="list-style-type: square"><a href="http://jakarta.apache.org/log4j/" target="_top">log4j</a> logging toolkit (<tt class="filename">log4j-1.2.6.jar</tt>)
+</li><li style="list-style-type: square"><a href="http://jakarta.apache.org/oro/" target="_top">Oro</a> Regular expressions (<tt class="filename">oro-2.0.6.jar</tt>)
+</li><li style="list-style-type: square"><a href="http://www.saxproject.org/" target="_top">SAX</a> Simple API for XML (<tt class="filename">sax-2.0.1.jar</tt>)
+</li></ul></div><p></p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e33"></a>2.&nbsp;Latest version</h2></div></div><div></div></div><p>
+Details of the latest version can be found on the Jalopy project
+web site at SourceForge, see
+<a href="http://jalopy.sf.net/" target="_top">http://jalopy.sf.net</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e37"></a>3.&nbsp;Installation</h2></div></div><div></div></div><p>
+For installation instructions, see
+<a href="./docs/plugin-ant.html#plugin-ant-installation" target="_top">/docs/plugin-ant.html</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e41"></a>4.&nbsp;Custom build</h2></div></div><div></div></div><p>
+For build instructions, see
+<a href="./docs/build.html" target="_top">/docs/build.html</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e45"></a>5.&nbsp;Change history</h2></div></div><div></div></div><p>
+To learn about implementation changes, fixed bugs and new features of this
+version, see <a href="./docs/history.html" target="_top">/docs/history.html</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e49"></a>6.&nbsp;Licensing</h2></div></div><div></div></div><p>
+This Plug-in is licensed under a
+<a href="./docs/license-bsd.html" target="_top">BSD License</a>. For
+additional license terms of the used 3rd-party libraries, please refer to
+<a href="./docs/dependencies.html" target="_top">Appendix A</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e54"></a>7.&nbsp;Contact</h2></div></div><div></div></div><p>
+For ways to contact the author or submit bug, feature or support requests, see
+<a href="./docs/contact.html" target="_top">/docs/contact.html</a>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d4e58"></a>8.&nbsp;Contributors</h2></div></div><div></div></div><p>
+For a list of project contributors, see
+<a href="./docs/contributors.html" target="_top">/docs/contributors.html</a>.
+</p></div></div></td></tr><tr><td height="20"></td></tr></tbody></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle">
+            Copyright &copy; 2001-2002, <a class="footer" href="./docs/contact.html">Marco Hunsicker</a>. All rights reserved.
+          </td></tr></table></body></html>