| 6 | | == Binary Packages == |
| 7 | | |
| 8 | | Packages are built with the Java 1.5 compiler on linux and Mac OS X. The code is 100% java is is machine independent and aside from machine-specific package formats (RPM, DMG, etc.) and command line scripts can be used anywhere a Java 1.5 or later JVM is available. The pan compiler packages can be found in the [https://sourceforge.net/project/showfiles.php?group_id=221766 Quattor SourceForge repository]. |
| 9 | | |
| 10 | | == Sources == |
| 11 | | === Checkout of Sources === |
| 12 | | |
| 13 | | The source for the pan compiler is managed through a [http://subversion.tigris.org/ subversion] repository. The mainline development ("trunk") can be checked out with a subversion client with the command: |
| 14 | | {{{ |
| 15 | | svn checkout https://svn.lal.in2p3.fr/LCG/QWG/panc/trunk |
| 16 | | }}} |
| 17 | | Specific versions of the compiler can be checked out from the tags area: |
| 18 | | {{{ |
| 19 | | svn checkout https://svn.lal.in2p3.fr/LCG/QWG/panc/tags/7.1.15 |
| 20 | | }}} |
| 21 | | where the tags correspond to the version of the compiler. All of the tags can be found by pointing a web browser at the subversion [http://svn.lal.in2p3.fr/LCG/QWG/panc/tags repository]. The source may also be browsed through [https://trac.lal.in2p3.fr/LCGQWG/browser/panc Trac]. |
| 22 | | |
| 23 | | The major version of the pan compiler changes when there are changes to the pan language itself. The minor version (second number) changes when there are significant changes in the compiler. Note that even minor versions are considered "stable" and odd minor versions are considered "development". The patch number changes when small changes and bug fixes are made to the compiler or the associated documentation. |
| 24 | | |
| 25 | | === Building === |
| 26 | | |
| 27 | | Correctly building the java-implementation of the pan compiler requires version 1.5.0 or later of a Java Development Kit (JDK). Full versions of java for linux, solaris, and windows can be obtained from [http://java.sun.com/ Sun]. The [http://openjdk.java.net/ OpenJDK] version of java also works well if it is available for your platform.The GNU implementation of java (gjc) included in many linux distributions is '''not sufficient''' to build or run the pan compiler. |
| 28 | | |
| 29 | | The build of the compiler is done via [http://ant.apache.org/ ant] that also depends on java. For ant to find the correct version, the environment variable JAVA_HOME should be defined: |
| 30 | | {{{ |
| 31 | | export JAVA_HOME=<path to java area> |
| 32 | | }}} |
| 33 | | or |
| 34 | | {{{ |
| 35 | | setenv JAVA_HOME <path to java area> |
| 36 | | }}} |
| 37 | | depending on the type of shell that you use. After that, the entire build can be accomplished with: |
| 38 | | {{{ |
| 39 | | ./external/apache-ant/bin/ant --noconfig |
| 40 | | }}} |
| 41 | | where the current working directory is the root of the directory checked out from subversion. The default build will compile all of the java sources, run the unit tests, and package the compiler. Tarballs (plain, gzipped, and bzipped) as well as a zip file are created on all platforms. The build will also create an RPM on platforms that support it and a DMG file for Mac OS X. The final packages can be found in the "build/packages" subdirectory. |
| 42 | | |
| 43 | | |
| | 6 | The compiler and documentation (including installation instructions) are available from [https://sourceforge.net/projects/quattor/files/panc/ SourceForge]. |
