Mercurial > hg > octave-lojdl > gnulib-hg

annotate lib/javacomp.h @ 17426:90f3d53e01f5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
sig2str: port to C++ * lib/sig2str.h (sig2str, str2sig): Declare as extern "C". Reported by Daniel J Sebald in <http://lists.gnu.org/archive/html/bug-gnulib/2013-06/msg00000.html>.
author Paul Eggert <eggert@cs.ucla.edu>
date Sun, 02 Jun 2013 11:52:41 -0700
parents e542fd46ad6f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Compile a Java program.
17249
e542fd46ad6f maint: update all copyright year number ranges
Eric Blake <eblake@redhat.com>
parents: 16201
diff changeset
2 Copyright (C) 2001-2002, 2006, 2009-2013 Free Software Foundation, Inc.
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 Written by Bruno Haible <haible@clisp.cons.org>, 2001.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7022
diff changeset
5 This program is free software: you can redistribute it and/or modify
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7022
diff changeset
7 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7022
diff changeset
8 (at your option) any later version.
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 This program is distributed in the hope that it will be useful,
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13 GNU General Public License for more details.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15 You should have received a copy of the GNU General Public License
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 7022
diff changeset
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 #ifndef _JAVACOMP_H
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 #define _JAVACOMP_H
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 #include <stdbool.h>
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 /* Compile a Java source file to bytecode.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 java_sources is an array of source file names.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 classpaths is a list of pathnames to be prepended to the CLASSPATH.
7022
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
26
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
27 source_version can be: support for
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
28 1.3 inner classes
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
29 1.4 assert keyword
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
30 1.5 generic classes and methods
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
31 1.6 (not yet supported)
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
32 target_version can be: classfile version:
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
33 1.1 45.3
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
34 1.2 46.0
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
35 1.3 47.0
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
36 1.4 48.0
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
37 1.5 49.0
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
38 1.6 50.0
10092
ae7bf97ee30c Remove trailing spaces.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
39 target_version can also be given as NULL. In this case, the required
7022
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
40 target_version is determined from the found JVM (see javaversion.h).
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
41 Specifying target_version is useful when building a library (.jar) that is
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
42 useful outside the given package. Passing target_version = NULL is useful
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
43 when building an application.
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
44 It is unreasonable to ask for:
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
45 - target_version < 1.4 with source_version >= 1.4, or
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
46 - target_version < 1.5 with source_version >= 1.5, or
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
47 - target_version < 1.6 with source_version >= 1.6,
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
48 because even Sun's javac doesn't support these combinations.
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
49 It is redundant to ask for a target_version > source_version, since the
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
50 smaller target_version = source_version will also always work and newer JVMs
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
51 support the older target_versions too. Except for the case
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
52 target_version = 1.4, source_version = 1.3, which allows gcj versions 3.0
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
53 to 3.2 to be used.
987fd3cc122a Update from GNU gettext 0.15. Accept source and target versions.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
54
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
55 directory is the target directory. The .class file for class X.Y.Z is
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
56 written at directory/X/Y/Z.class. If directory is NULL, the .class
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
57 file is written in the source's directory.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
58 use_minimal_classpath = true means to ignore the user's CLASSPATH and
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
59 use a minimal one. This is likely to reduce possible problems if the
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
60 user's CLASSPATH contains garbage or a classes.zip file of the wrong
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
61 Java version.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
62 If verbose, the command to be executed will be printed.
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
63 Return false if OK, true on error. */
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
64 extern bool compile_java_class (const char * const *java_sources,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
65 unsigned int java_sources_count,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
66 const char * const *classpaths,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
67 unsigned int classpaths_count,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
68 const char *source_version,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
69 const char *target_version,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
70 const char *directory,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
71 bool optimize, bool debug,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
72 bool use_minimal_classpath,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10092
diff changeset
73 bool verbose);
5628
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
74
0ceadee93518 New module 'javacomp'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
75 #endif /* _JAVACOMP_H */