gnulib: lib/javacomp.h annotate

annotate lib/javacomp.h @ 17363:5a51fb7777a9

sys_select, sys_time: port 2013-01-30 Solaris 2.6 fix to Cygwin Problem reported by Marco Atzeri in <http://lists.gnu.org/archive/html/bug-gnulib/2013-03/msg00000.html>. * lib/sys_select.in.h [HAVE_SYS_SELECT_H && _CYGWIN_SYS_TIME_H]: Simply delegate to the system <sys/select.h> in this case too. Also, pay attention to _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TIME_H only if OSF/1, since otherwise Cygwin breaks, and it doesn't seem to be needed on Solaris either. * lib/sys_time.in.h [_CYGWIN_SYS_TIME_H]: Simply delgate to the system <sys/time.h> in this case.

author	Paul Eggert <eggert@cs.ucla.edu>
date	Tue, 19 Mar 2013 09:08:47 -0700
parents	e542fd46ad6f
children	344018b6e5d7

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 */

Mercurial > gnulib

annotate lib/javacomp.h @ 17363:5a51fb7777a9