Recent changes to Command Line Reference

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Wed, 04 Dec 2013 19:12:32 -0000

--- v10
+++ v11
@@ -4,7 +4,7 @@

 You can download the current ecrash.jar from [here](https://sourceforge.net/projects/ecrashtesting/files/ecrash_2013_12_01.jar). 
 

-Alert: The installation of the Java Development Kit (JDK) is mandatory; the JRE installation won't work. You can download it from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
+Alert: The installation of the Java Development Kit (JDK) is mandatory; the JRE installation does not work. You can download it from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html).

 #####  Command Line Syntax:  
 ~~~~~~
@@ -48,12 +48,14 @@

 1 Download the Stack Project from [here](https://sourceforge.net/projects/ecrashtesting/files/StackProject.zip).
 2 Extract the project
-2 Place the ecrash's jar in the root folder.
-3 Execute the following command:
+3 Place the ecrash's jar in the root folder.
+4 Execute the following command:

 ~~~~~~
-java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -XX:+UseSplitVerifier -Dsun.lang.ClassLoader.allowArraySyntax=true ecrash.jar -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
+java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -XX:+UseSplitVerifier -Dsun.lang.ClassLoader.allowArraySyntax=true ecrash.jar -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myFirstTestSuite 
 ~~~~~~
+
+5. Open the folder "myFirstTestSuite" to check the statistics (folder "eCrashStatistics") and the test code (folder myjava/util/StackEcrashTest). The "ECJ_myFirstTestSuite" contains the ECJ configuration files.

 This example creates unit tests for the public methods and constructors available in the class [Stack](http://docs.oracle.com/javase/7/docs/api/java/util/Stack.html), which is a container class available in the JDK. 
 Note: In order to avoid conflicts, the package for the Stack Project was renamed (myjava.util instead of java.util).

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Wed, 04 Dec 2013 19:07:51 -0000

--- v9
+++ v10
@@ -52,7 +52,7 @@
 3 Execute the following command:

 ~~~~~~
-java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -XX:+UseSplitVerifier -Dsun.lang.ClassLoader.allowArraySyntax=true ecrash_2013_12_01.jar  -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
+java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -XX:+UseSplitVerifier -Dsun.lang.ClassLoader.allowArraySyntax=true ecrash.jar -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
 ~~~~~~

 This example creates unit tests for the public methods and constructors available in the class [Stack](http://docs.oracle.com/javase/7/docs/api/java/util/Stack.html), which is a container class available in the JDK.

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Wed, 04 Dec 2013 19:07:08 -0000

--- v8
+++ v9
@@ -2,7 +2,7 @@

 eCrash can be used from the command line. The list of available parameters is presented next. The support for other parameters is also under development.

-You can download the current ecrash.jar from [here]().
+You can download the current ecrash.jar from [here](https://sourceforge.net/projects/ecrashtesting/files/ecrash_2013_12_01.jar). 
 

 Alert: The installation of the Java Development Kit (JDK) is mandatory; the JRE installation won't work. You can download it from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html).

@@ -46,7 +46,7 @@

 #####  Example for the Stack Project:  

-1 Download the Stack Project from [here]().
+1 Download the Stack Project from [here](https://sourceforge.net/projects/ecrashtesting/files/StackProject.zip).
 2 Extract the project
 2 Place the ecrash's jar in the root folder.
 3 Execute the following command:

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Wed, 04 Dec 2013 18:57:26 -0000

--- v7
+++ v8
@@ -1,12 +1,17 @@
 # Command Line Reference #

-eCrash can be used from the command line, the list of available parameters is presented next. The support for other parameters is also under development.
+eCrash can be used from the command line. The list of available parameters is presented next. The support for other parameters is also under development.

+You can download the current ecrash.jar from [here]().
+

+Alert: The installation of the Java Development Kit (JDK) is mandatory; the JRE installation won't work. You can download it from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
+
+#####  Command Line Syntax:  
 ~~~~~~
-java [Java VM Options] ecrash_2013_12_01.jar  -testclass  [optional eCrash's parameters]
+java [Java VM Options] ecrash.jar  -testclass  [optional eCrash's parameters]
 ~~~~~~
+


-    

 #### eCrash's Command line parameters  

@@ -22,8 +27,6 @@
 seed |no |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
 notquit | no| When specified, the generation does not quits on run complete (ECJ Configuration)| No default value.
 junit4 |no |    When specified, the tests will be saved on the JUnit 4.x format. Otherwise, the JUnit 3.x is used. Usage: -junit4 | No default value.
-testclusterxml |no| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
-constantsfile|no |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.  
 verbosity |no |  When specified,  Outputs information about the test cases' generation. Usage: -verbosity | No default value.
 help| no|  Print the list of parameters. Usage: -help  | No default value.
 version| no   | Print the version information. Usage: -version | No default value.
@@ -44,6 +47,7 @@
 #####  Example for the Stack Project:  

 1 Download the Stack Project from [here]().
+2 Extract the project
 2 Place the ecrash's jar in the root folder.
 3 Execute the following command:

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Wed, 04 Dec 2013 18:01:13 -0000

--- v6
+++ v7
@@ -3,13 +3,12 @@
 eCrash can be used from the command line, the list of available parameters is presented next. The support for other parameters is also under development.

 ~~~~~~
-java  ecrash_2013_12_01.jar  -testclass  [optional eCrash's parameters]
+java [Java VM Options] ecrash_2013_12_01.jar  -testclass  [optional eCrash's parameters]
 ~~~~~~

+    

-
-
-#### eCrash's Command-line parameters ####
+#### eCrash's Command line parameters  

 Parameter  |Required |  Description  |Default Value
   ------------- | -------------| -------------| -------------
@@ -31,34 +30,29 @@

-#### Java VM Options #### 
+#### Java VM Options 

-VMArgument  | Description  | Value
+VM Argument  | Required  | Description
 ------------- | -------------  | ------------- 
--XX:MaxPermSize |  Usage: -XX:MaxPermSize=1024m| at least: 1024m
--XX:-UseGCOverheadLimit | | 
--Dsun.lang.ClassLoader.allowArraySyntax | .... Usage: -Dsun.lang.ClassLoader.allowArraySyntax=true | true
- -XX:-UseSplitVerifier | | 
+-XX:MaxPermSize| no, but you may need to specify it. | Size of the Permanent Generation. Usage: -XX:MaxPermSize=1024m| at least: 1024m 
+-XX:+UseGCOverheadLimit | no, but you may need to specify it. | Use a policy that limits the proportion of the VM's time that is spent in GC before an OutOfMemory error is thrown.
+-Dsun.lang.ClassLoader.allowArraySyntax | yes (whenever the class under test  deals  with arrays) |This VM argument is required to avoid problems when loading classes with array syntax. For instance  ClassLoader.loadClass() throws java.lang.ClassNotFoundException: [Ljava.lang.String; when the argument is not specified and you are dealing with arrays. In this particular case we were trying to load a array of String objects.  Usage: -Dsun.lang.ClassLoader.allowArraySyntax=true | true
+-XX:-UseSplitVerifier | no, but you may need to specify it | This may be required when  you are using the JDK 7 and you are dealing with classes that are compatible with JDK <=1.6 .

-#### Tutorials/Examples ####
+#### Tutorials/Examples  

-####### Example for the Stack Project: #######
+#####  Example for the Stack Project:  

 1 Download the Stack Project from [here]().
 2 Place the ecrash's jar in the root folder.
 3 Execute the following command:

 ~~~~~~
-java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -Dsun.lang.ClassLoader.allowArraySyntax=true   -XX:-UseSplitVerifier ecrash_2013_12_01.jar  -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
+java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -XX:+UseSplitVerifier -Dsun.lang.ClassLoader.allowArraySyntax=true ecrash_2013_12_01.jar  -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
 ~~~~~~

 This example creates unit tests for the public methods and constructors available in the class [Stack](http://docs.oracle.com/javase/7/docs/api/java/util/Stack.html), which is a container class available in the JDK. 
-Note: In order to avoid conflicts, the package for the Stack Project was renamed (
-myjava.util instead of java.util).
+Note: In order to avoid conflicts, the package for the Stack Project was renamed (myjava.util instead of java.util).

-####### Example for the Apache Ant Project (release 1.8.4): #######
-
-1 Download the Apache ant Project from [here]().
-2 Place the ecrash's jar in the root folder.
-3 Execute the following command:
+

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Tue, 03 Dec 2013 17:50:38 -0000

--- v5
+++ v6
@@ -18,9 +18,10 @@
 bindir | no |  Specify the relative path for the directory containing the binary code for the project. Usage: -bindir <*binaryfoldername*> | The default value is "bin"
 libdir | no  |   Specify the list of relative paths for the directories containing dependencies for the project under test. The list is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
 testfoldername | no | Name of the directory to which the test cases should be written. If the folder already exists, then a new folder is created with the name format: <*testfoldername*> + #number. Usage: -testfoldername <*testfoldername*> | The default value is "testEcrash". 
-generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is 30.
-population | no   | Specifies the population size that the genetic algorithm will create| The default value is 25.
+generations | no | Specifies the number of generations that the genetic algorithm will create.| The default value is 30.
+population | no   | Specifies the population size that the genetic algorithm will create.| The default value is 25.
 seed |no |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
+notquit | no| When specified, the generation does not quits on run complete (ECJ Configuration)| No default value.
 junit4 |no |    When specified, the tests will be saved on the JUnit 4.x format. Otherwise, the JUnit 3.x is used. Usage: -junit4 | No default value.
 testclusterxml |no| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
 constantsfile|no |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Tue, 03 Dec 2013 16:35:47 -0000

--- v4
+++ v5
@@ -3,8 +3,11 @@
 eCrash can be used from the command line, the list of available parameters is presented next. The support for other parameters is also under development.

 ~~~~~~
-java <*VM arguments list*> ecrash_2013_12_01.jar  -testclass <*class fullqualified name*> <*optional eCrash's parameters*>
+java  ecrash_2013_12_01.jar  -testclass  [optional eCrash's parameters]
 ~~~~~~
+
+
+

 #### eCrash's Command-line parameters ####

@@ -12,8 +15,8 @@
   ------------- | -------------| -------------| -------------
 testclass | yes |  Full qualified name for the class under test. Usage: -testclass <*fullqualifiedname*>  | No default value.
 projectpath  | no |  Specify the directory for the project under test. Usage: -projectpath <*fullpath*> | The current directory.
-bin | no |  Specify the directory containing the binary code for the project. Usage: <*binaryfoldername*> | The default value is "bin"
-lib | no  |   Specify the list of folders containing dependencies for the project under test. The list of folder is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
+bindir | no |  Specify the relative path for the directory containing the binary code for the project. Usage: -bindir <*binaryfoldername*> | The default value is "bin"
+libdir | no  |   Specify the list of relative paths for the directories containing dependencies for the project under test. The list is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
 testfoldername | no | Name of the directory to which the test cases should be written. If the folder already exists, then a new folder is created with the name format: <*testfoldername*> + #number. Usage: -testfoldername <*testfoldername*> | The default value is "testEcrash". 
 generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is 30.
 population | no   | Specifies the population size that the genetic algorithm will create| The default value is 25.

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Mon, 02 Dec 2013 18:06:40 -0000

--- v3
+++ v4
@@ -1,44 +1,60 @@
-Command Line Reference
----
+# Command Line Reference #

+eCrash can be used from the command line, the list of available parameters is presented next. The support for other parameters is also under development.

-eCrash can be used from the command line.
+~~~~~~
+java <*VM arguments list*> ecrash_2013_12_01.jar  -testclass <*class fullqualified name*> <*optional eCrash's parameters*>
+~~~~~~

-
+#### eCrash's Command-line parameters ####

 Parameter  |Required |  Description  |Default Value
   ------------- | -------------| -------------| -------------
-testclass | Yes |  Full qualified name for the class under test. Usage: -testclass <*fullqualifiedname*>  | No default value.
-projectpath  | No |  Specify the directory for the project under test. Usage: -projectpath <*fullpath*> | The current directory.
+testclass | yes |  Full qualified name for the class under test. Usage: -testclass <*fullqualifiedname*>  | No default value.
+projectpath  | no |  Specify the directory for the project under test. Usage: -projectpath <*fullpath*> | The current directory.
 bin | no |  Specify the directory containing the binary code for the project. Usage: <*binaryfoldername*> | The default value is "bin"
 lib | no  |   Specify the list of folders containing dependencies for the project under test. The list of folder is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
-testfoldername | No | Name of the directory to which the test cases should be written. If the folder already exists, then a new folder is created with the name format: <*testfoldername*> + #number. Usage: -testfoldername <*testfoldername*> | The default value is "testEcrash". 
-generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is  
-population | no   | Specifies the population size that the genetic algorithm will create| The default value is 
-seed |No |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
-junit4 |No |    When specified, the tests will be saved on the JUnit 4.x format. Otherwise, the JUnit 3.x is used. Usage: -junit4 | No default value.
-testclusterxml |No| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
-constantsfile|No |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.  
-verbosity |No |  When specified,  Outputs information about the test cases' generation | No default value.
-help| No|  Print the list of parameters. Usage: -help  | No default value.
-version| No   | Print the version information. Usage: -version | No default value.
+testfoldername | no | Name of the directory to which the test cases should be written. If the folder already exists, then a new folder is created with the name format: <*testfoldername*> + #number. Usage: -testfoldername <*testfoldername*> | The default value is "testEcrash". 
+generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is 30.
+population | no   | Specifies the population size that the genetic algorithm will create| The default value is 25.
+seed |no |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
+junit4 |no |    When specified, the tests will be saved on the JUnit 4.x format. Otherwise, the JUnit 3.x is used. Usage: -junit4 | No default value.
+testclusterxml |no| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
+constantsfile|no |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.  
+verbosity |no |  When specified,  Outputs information about the test cases' generation. Usage: -verbosity | No default value.
+help| no|  Print the list of parameters. Usage: -help  | No default value.
+version| no   | Print the version information. Usage: -version | No default value.

+#### Java VM Options #### 

-Tutorials/Examples
----
+VMArgument  | Description  | Value
+------------- | -------------  | ------------- 
+-XX:MaxPermSize |  Usage: -XX:MaxPermSize=1024m| at least: 1024m
+-XX:-UseGCOverheadLimit | | 
+-Dsun.lang.ClassLoader.allowArraySyntax | .... Usage: -Dsun.lang.ClassLoader.allowArraySyntax=true | true
+ -XX:-UseSplitVerifier | | 
+
+#### Tutorials/Examples ####
+
+####### Example for the Stack Project: #######
+
+1 Download the Stack Project from [here]().
+2 Place the ecrash's jar in the root folder.
+3 Execute the following command:
+
+~~~~~~
+java -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit -Dsun.lang.ClassLoader.allowArraySyntax=true   -XX:-UseSplitVerifier ecrash_2013_12_01.jar  -testclass myjava.util.Stack -verbosity -seed 123 -generations 50 -testfoldername myUnitTests 
+~~~~~~
+
+This example creates unit tests for the public methods and constructors available in the class [Stack](http://docs.oracle.com/javase/7/docs/api/java/util/Stack.html), which is a container class available in the JDK. 
+Note: In order to avoid conflicts, the package for the Stack Project was renamed (
+myjava.util instead of java.util).

-Example for the Stack Project:
+####### Example for the Apache Ant Project (release 1.8.4): #######

-*Download the Stack Project
-
-
-
-
-
-Example for the Apache Ant Project (release 1.8.4):
-
-*Download the Apache ant Project
-
+1 Download the Apache ant Project from [here]().
+2 Place the ecrash's jar in the root folder.
+3 Execute the following command:

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Mon, 02 Dec 2013 17:21:53 -0000

--- v2
+++ v3
@@ -12,10 +12,11 @@
 projectpath  | No |  Specify the directory for the project under test. Usage: -projectpath <*fullpath*> | The current directory.
 bin | no |  Specify the directory containing the binary code for the project. Usage: <*binaryfoldername*> | The default value is "bin"
 lib | no  |   Specify the list of folders containing dependencies for the project under test. The list of folder is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
+testfoldername | No | Name of the directory to which the test cases should be written. If the folder already exists, then a new folder is created with the name format: <*testfoldername*> + #number. Usage: -testfoldername <*testfoldername*> | The default value is "testEcrash". 
 generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is  
 population | no   | Specifies the population size that the genetic algorithm will create| The default value is 
 seed |No |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
-junit4 |No |    When specified, the tests will be saved on the JUnit 4x format. Otherwise, the JUnit 3x is used. Usage: -junit4 | No default value.
+junit4 |No |    When specified, the tests will be saved on the JUnit 4.x format. Otherwise, the JUnit 3.x is used. Usage: -junit4 | No default value.
 testclusterxml |No| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
 constantsfile|No |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.  
 verbosity |No |  When specified,  Outputs information about the test cases' generation | No default value.

Command Line Reference modified by Ana Filipa Nogueira

Ana Filipa Nogueira — Mon, 02 Dec 2013 12:56:57 -0000

--- v1
+++ v2
@@ -0,0 +1,43 @@
+Command Line Reference
+---
+
+
+eCrash can be used from the command line.
+
+
+ 
+Parameter  |Required |  Description  |Default Value
+  ------------- | -------------| -------------| -------------
+testclass | Yes |  Full qualified name for the class under test. Usage: -testclass <*fullqualifiedname*>  | No default value.
+projectpath  | No |  Specify the directory for the project under test. Usage: -projectpath <*fullpath*> | The current directory.
+bin | no |  Specify the directory containing the binary code for the project. Usage: <*binaryfoldername*> | The default value is "bin"
+lib | no  |   Specify the list of folders containing dependencies for the project under test. The list of folder is separated by ‘:’ in Unix systems and ‘;’ in Windows systems. | The default value is "lib".
+generations | no | Specifies the number of generations that the genetic algorithm will create| The default value is  
+population | no   | Specifies the population size that the genetic algorithm will create| The default value is 
+seed |No |   Specifies the seed used during the test data generation process (by default a new random seed is used when seed is not specified). | No default value.
+junit4 |No |    When specified, the tests will be saved on the JUnit 4x format. Otherwise, the JUnit 3x is used. Usage: -junit4 | No default value.
+testclusterxml |No| XML file containing a specification for the test cluster generation process. Usage: -testclusterxml <*filename*> | No default value.  
+constantsfile|No |XML file containing a specification of the constants that should be considered for each primitive type. Usage: -constantsfile <*filename*> | No default value.  
+verbosity |No |  When specified,  Outputs information about the test cases' generation | No default value.
+help| No|  Print the list of parameters. Usage: -help  | No default value.
+version| No   | Print the version information. Usage: -version | No default value.
+
+
+
+
+Tutorials/Examples
+---
+
+
+Example for the Stack Project:
+
+*Download the Stack Project
+
+
+
+
+
+Example for the Apache Ant Project (release 1.8.4):
+
+*Download the Apache ant Project
+