Re: [patch] compiling multiple Java source files at once

[Per Bothner <per at bothner dot com>]

Tom Tromey <tromey@redhat.com> writes:

> Could you also make a patch to gcj.texi to document this?

How about this:

Index: gcj.texi
===================================================================
RCS file: /cvs/gcc/egcs/gcc/java/gcj.texi,v
retrieving revision 1.5
diff -u -r1.5 gcj.texi
--- gcj.texi	2001/02/08 01:49:53	1.5
+++ gcj.texi	2001/02/17 04:39:56
@@ -513,6 +513,7 @@
 options specific to @code{gcj}.
 
 @menu
+* Input and output files::
 * Input Options::		How gcj finds files
 * Encodings::                   Options controlling source file encoding
 * Warnings::			Options controlling warnings specific to gcj
@@ -520,6 +521,42 @@
 * Configure-time Options::	Options you won't use
 @end menu
 
+@node Input and output files
+@section Input and output files
+
+A @code{gcj} command is like a @code{gcc} command, in that it
+consists of a number of options and file names.  The following kinds
+of input file names are supported:
+
+@table @code
+@item @var{file}.java
+Java source files.
+@item @var{file}.class
+Java bytecode files.
+@item @var{file}.zip
+@itemx @var{file}.jar
+An archive containing one or more @code{.class} files, all of
+which are compiled.  The archive may be compressed.
+@item @@@var{file}
+A file containing a whitespace-separated list of input file names.
+(Currently, these must all be @code{.java} source files, but that
+may change.)
+Each named file is compiled, just as if it had been on the command line.
+@item @var{library}.a
+@itemx @var{library}.so
+@itemx -l@var{libname}
+Libraries to use when linking.  See the @code{gcc} manual.
+@end table
+
+You can specify more than one input file on the @code{gcj} command line,
+in which case they will all be compiled.  If you specify a
+@code{-o @var{FILENAME}}
+option, all the input files will be compiled together, producing a
+single output file, named @var{FILENAME}.
+This is allowed even when using one of the options @code{-C}, @code{-S},
+or @code{-c}.  (This is an extension beyond the what plain @code{gcc} allows.)
+(If more than one input file is specified, all must currently
+be @code{.java} files, though we hope to fix this.)
 
 @node Input Options
 @section Input Options

-- 
	--Per Bothner
per@bothner.com   http://www.bothner.com/~per/