CoCoViLa - a compiler compiler for visual languages

Main | Download | Webstart | CVS | Tutorial | Screenshots | Publications

This project's SourceForge.net CVS repository can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the modulename. When prompted for a password for anonymous, simply press the Enter key. To determine the names of the modules created by this project, you may examine CVS repository via the provided web-based CVS repository viewer.

cvs -d:pserver:anonymous@vsledit.cvs.sourceforge.net:/cvsroot/vsledit login
 
cvs -z3 -d:pserver:anonymous@vsledit.cvs.sourceforge.net:/cvsroot/vsledit co -P modulename

Using Ant and Java Development Kit (JDK)

To get the latest CVS version up and running quickly just follow these three steps. We assume here that you have a CVS client, JDK 1.5 or newer, and Apache Ant already properly set up. If this is not the case then please follow the instructions provided with the respective software packages or refer to the documentation of your operating system.

1. Check out the latest revision of the application and standard packages from CVS to the new directory cocovila-cvs. The module "cocovila" contains everything needed for building the sources and working with standard packages.
   cvs -z3 -d:pserver:anonymous@vsledit.cvs.sourceforge.net:/cvsroot/vsledit co -P -d cocovila-cvs cocovila
2. Change to the source directory:
   cd cocovila-cvs/src
3. Start CoCoViLa Scheme Editor or Class Editor:
   ant run-se
   or
   ant run-ce

Later, to update your local source tree to the latest version execute:
cvs up -Pd
in the directory cocovila-cvs. The commands "ant run-se" and "ant run-ce" started in cocovila-cvs/src will automatically take care of compiling the changes so addidional steps should not be required. If something does not work as expected an "ant clean" followed by "ant run-..." might help.

Using Ant and Java Runtime Environment (JRE)

It is also possible to compile the source code of CoCoViLa with the bundled compiler. In this case only the JRE is needed and the JDK is not required. To use this method the following line must be added (or uncommented) to the file src/build.properties after checking out the source from CVS:
compiler=org.eclipse.jdt.core.JDTCompilerAdapter
By default Ant cannot find the bundled compiler and putting it to the CLASSPATH environment variable is not recommended. Therefore, all the ant commands must be given an additional command line argument: "-lib ../lib/ejc.jar". The command sequence to download the code and get CoCoViLa running would be as follows (compare to the commands given in previous section):

1. cvs -z3 -d:pserver:anonymous@vsledit.cvs.sourceforge.net:/cvsroot/vsledit co -P -d cocovila-cvs cocovila
2. cd cocovila-cvs/src
3. Edit build.properties to add or uncomment the compiler parameter
4. ant -lib ../lib/ejc.jar run-se (note the -lib argument here)