Changes between Version 6 and Version 7 of Doc/compiler/running

Timestamp:

Mar 7, 2007, 3:03:27 PM (17 years ago)

Author:

/O=GRID-FR/C=FR/O=CNRS/OU=LAL/CN=Charles Loomis

Comment:

--

Doc/compiler/running

@@ -43 +43 @@
 where {{{...options...}}} is replaced with valid options for the panc ant task.  The full set of options can be found by looking at the javadoc information for the "org.quattor.pan.ant.PanCompilerTask" class in the javadoc distributed with the release.
 
-== Adjusting the Java Virtual Machine Memory ==
+== Adjusting the Java Virtual Machine Parameters ==
 
-The performance of the compiler can degrade markedly if there is not sufficient memory to do a particular compile and build.  The mechanism for increasing the available memory differs depending on how the compiler in invoked.
+The performance of the compiler can degrade markedly if there is not sufficient memory to do a particular compile and build.  Moreover, the default memory allocation and vary wildly depending on how and when the compiler is invoked.  Similarly, there are other options that may improve the performance of the compiler.  For instance, it is usually advisable to use the "-server" option.
 
 === Direct Invocation via Java ===
 
-If the java compiler class is being directly invoked via the {{{java}}} command, then the option "-Xmx" must be added.  For example to start java with 1024 MB, the following command and options can be used:
+If the java compiler class is being directly invoked via the {{{java}}} command, then the option "-Xmx" must be added to change the VM memory available.  For example to start java with 1024 MB, the following command and options can be used:
 {{{
 java -Xmx1024M org.quattor.pan.Compiler [options...]
 }}}
-For the panc command, currently the panc script must be edited to add this option.
+For the panc command, currently the panc script must be edited to add this option.  The same must be done for other options.
 
 === Direct Invocation via Ant ===
@@ -65 +65 @@
 setenv ANT_OPTS "-Xmx1024M"
 }}}
-depending on whether you use an "sh"- or "csh"-type shell.
+depending on whether you use an "sh"- or "csh"-type shell.  Other options can be similarly added to the environmental variable.  (The value is a space-separated list.)
 
 === Invocation via Eclipse ===
@@ -80 +80 @@
 
 If you invoke a new java virtual machine for each build, then you can change the ant arguments via the run parameters.  From within the "ant" view, right-click on the appropriate ant build file, and then select "Run As -> Ant Build...".  In the pop-up window, select the JRE tab.  In the "VM arguments" panel, add the "-Xmx<memory size>" option without the quotes.  (You can also add other options here.)  The next build will use these options.
+
+Other VM options can be changed in the same way.