1 /* Compile a Java program. 2 Copyright (C) 2001-2002, 2006 Free Software Foundation, Inc. 3 Written by Bruno Haible <haible@clisp.cons.org>, 2001. 4 5 This program is free software; you can redistribute it and/or modify 6 it under the terms of the GNU General Public License as published by 7 the Free Software Foundation; either version 2, or (at your option) 8 any later version. 9 10 This program is distributed in the hope that it will be useful, 11 but WITHOUT ANY WARRANTY; without even the implied warranty of 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 GNU General Public License for more details. 14 15 You should have received a copy of the GNU General Public License 16 along with this program; if not, write to the Free Software Foundation, 17 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ 18 19 #ifndef _JAVACOMP_H 20 #define _JAVACOMP_H 21 22 #include <stdbool.h> 23 24 /* Compile a Java source file to bytecode. 25 java_sources is an array of source file names. 26 classpaths is a list of pathnames to be prepended to the CLASSPATH. 27 28 source_version can be: support for 29 1.3 inner classes 30 1.4 assert keyword 31 1.5 generic classes and methods 32 1.6 (not yet supported) 33 target_version can be: classfile version: 34 1.1 45.3 35 1.2 46.0 36 1.3 47.0 37 1.4 48.0 38 1.5 49.0 39 1.6 50.0 40 target_version can also be given as NULL. In this case, the required 41 target_version is determined from the found JVM (see javaversion.h). 42 Specifying target_version is useful when building a library (.jar) that is 43 useful outside the given package. Passing target_version = NULL is useful 44 when building an application. 45 It is unreasonable to ask for: 46 - target_version < 1.4 with source_version >= 1.4, or 47 - target_version < 1.5 with source_version >= 1.5, or 48 - target_version < 1.6 with source_version >= 1.6, 49 because even Sun's javac doesn't support these combinations. 50 It is redundant to ask for a target_version > source_version, since the 51 smaller target_version = source_version will also always work and newer JVMs 52 support the older target_versions too. Except for the case 53 target_version = 1.4, source_version = 1.3, which allows gcj versions 3.0 54 to 3.2 to be used. 55 56 directory is the target directory. The .class file for class X.Y.Z is 57 written at directory/X/Y/Z.class. If directory is NULL, the .class 58 file is written in the source's directory. 59 use_minimal_classpath = true means to ignore the user's CLASSPATH and 60 use a minimal one. This is likely to reduce possible problems if the 61 user's CLASSPATH contains garbage or a classes.zip file of the wrong 62 Java version. 63 If verbose, the command to be executed will be printed. 64 Return false if OK, true on error. */ 65 extern bool compile_java_class (const char * const *java_sources, 66 unsigned int java_sources_count, 67 const char * const *classpaths, 68 unsigned int classpaths_count, 69 const char *source_version, 70 const char *target_version, 71 const char *directory, 72 bool optimize, bool debug, 73 bool use_minimal_classpath, 74 bool verbose); 75 76 #endif /* _JAVACOMP_H */ 77