diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 4b23f4e2222..0a8495525ba 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,12 @@ +2004-02-20 Mohan Embar + Tom Tromey + + * doc/install.texi: Moved --disable-libgcj and + --with-system-zlib documentation to new section for + Java-specific options. + Added explicit Cross-Compiler-Specific Options subheading. + Added section for Java-specific options. + 2004-02-20 Matt Kraai * doc/install.texi (Building the Ada compiler): Remove diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 17a54f2132a..45763ab12fa 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -554,6 +554,10 @@ GCC@. A list of supported @var{options} follows; @samp{configure --help} may list other options, but those not listed below may not work and should not normally be used. +Note that each @option{--enable} option has a corresponding +@option{--disable} option and that each @option{--with} option has a +corresponding @option{--without} option. + @table @code @item --prefix=@var{dirname} Specify the toplevel installation @@ -1034,18 +1038,6 @@ be built. This can be useful for debugging, or for compatibility with previous Ada build procedures, when it was required to explicitly do a @samp{make -C gcc gnatlib_and_tools}. -@item --disable-libgcj -Specify that the run-time libraries -used by GCJ should not be built. This is useful in case you intend -to use GCJ with some other run-time, or you're going to install it -separately, or it just happens not to build on your particular -machine. In general, if the Java front end is enabled, the GCJ -libraries will be enabled too, unless they're known to not work on -the target platform. If GCJ is enabled but @samp{libgcj} isn't built, you -may need to port it; in this case, before modifying the top-level -@file{configure.in} so that @samp{libgcj} is enabled by default on this platform, -you may use @option{--enable-libgcj} to override the default. - @item --with-dwarf2 Specify that the compiler should use DWARF 2 debugging information as the default. @@ -1139,10 +1131,6 @@ build procedure to use the host's @code{catgets} in this situation. Search for libiconv header files in @file{@var{dir}/include} and libiconv library files in @file{@var{dir}/lib}. -@item --with-system-zlib -Use installed zlib rather than that included with GCC@. This option -only applies if the Java front end is being built. - @item --enable-obsolete Enable configuration for an obsoleted system. If you attempt to configure GCC for a system (build, host, or target) which has been @@ -1154,7 +1142,8 @@ is removed entirely in the next major release, unless someone steps forward to maintain the port. @end table -Some options which only apply to building cross compilers: +@subheading Cross-Compiler-Specific Options +The following options only apply to building cross compilers. @table @code @item --with-sysroot @itemx --with-sysroot=@var{dir} @@ -1202,9 +1191,141 @@ omitted from @file{libgcc.a} on the assumption that it will be provided by @samp{newlib}. @end table -Note that each @option{--enable} option has a corresponding -@option{--disable} option and that each @option{--with} option has a -corresponding @option{--without} option. +@subheading Java-Specific Options + +The following option applies to the build of the Java front end. + +@table @code +@item --disable-libgcj +Specify that the run-time libraries +used by GCJ should not be built. This is useful in case you intend +to use GCJ with some other run-time, or you're going to install it +separately, or it just happens not to build on your particular +machine. In general, if the Java front end is enabled, the GCJ +libraries will be enabled too, unless they're known to not work on +the target platform. If GCJ is enabled but @samp{libgcj} isn't built, you +may need to port it; in this case, before modifying the top-level +@file{configure.in} so that @samp{libgcj} is enabled by default on this platform, +you may use @option{--enable-libgcj} to override the default. + +@end table + +The following options apply to building @samp{libgcj}. + +@subsubheading General Options + +@table @code +@item --disable-getenv-properties +Don't set system properties from @env{GCJ_PROPERTIES}. + +@item --enable-hash-synchronization +Use a global hash table for monitor locks. Ordinarily, +@samp{libgcj}'s @samp{configure} script automatically makes +the correct choice for this option for your platform. Only use +this if you know you need the library to be configured differently. + +@item --enable-interpreter +Enable the Java interpreter. The interpreter is automatically +enabled by default on all platforms that support it. This option +is really only useful if you want to disable the interpreter +(using @option{--disable-interpreter}). + +@item --disable-java-net +Disable java.net. This disables the native part of java.net only, +using non-functional stubs for native method implementations. + +@item --disable-jvmpi +Disable JVMPI support. + +@item --with-ecos +Enable runtime eCos target support. + +@item --without-libffi +Don't use @samp{libffi}. This will disable the interpreter and JNI +support as well, as these require @samp{libffi} to work. + +@item --enable-libgcj-debug +Enable runtime debugging code. + +@item --enable-libgcj-multifile +If specified, causes all @file{.java} source files to be +compiled into @file{.class} files in one invocation of +@samp{gcj}. This can speed up build time, but is more +resource-intensive. If this option is unspecified or +disabled, @samp{gcj} is invoked once for each @file{.java} +file to compile into a @file{.class} file. + +@item --with-libiconv-prefix=DIR +Search for libiconv in @file{DIR/include} and @file{DIR/lib}. + +@item --enable-sjlj-exceptions +Force use of @code{builtin_setjmp} for exceptions. @samp{configure} +ordinarily picks the correct value based on the platform. Only use +this option if you are sure you need a different setting. + +@item --with-system-zlib +Use installed @samp{zlib} rather than that included with GCC@. + +@item --with-win32-nlsapi=ansi, unicows or unicode +Indicates how MinGW @samp{libgcj} translates between UNICODE +characters and the Win32 API. +@table @code +@item ansi +Use the single-byte @code{char} and the Win32 A functions natively, +translating to and from UNICODE when using these functions. If +unspecified, this is the default. + +@item unicows +Use the @code{WCHAR} and Win32 W functions natively. Adds +@code{-lunicows} to @file{libgcj.spec} to link with @samp{libunicows}. +@file{unicows.dll} needs to be deployed on Microsoft Windows 9X machines +running built executables. @file{libunicows.a}, an open-source +import library around Microsoft's @code{unicows.dll}, is obtained from +@uref{http://libunicows.sourceforge.net/}, which also gives details +on getting @file{unicows.dll} from Microsoft. + +@item unicode +Use the @code{WCHAR} and Win32 W functions natively. Does @emph{not} +add @code{-lunicows} to @file{libgcj.spec}. The built executables will +only run on Microsoft Windows NT and above. +@end table +@end table + +@subsubheading AWT-Specific Options + +@table @code +@item --with-x +Use the X Window System. + +@item --enable-java-awt=PEER(S) +Specifies the AWT peer library or libraries to build alongside +@samp{libgcj}. If this option is unspecified or disabled, AWT +will be non-functional. Current valid values are @option{gtk} and +@option{xlib}. Multiple libraries should be separated by a +comma (i.e. @option{--enable-java-awt=gtk,xlib}). + +@item --enable-gtk-cairo +Build the cairo Graphics2D implementation on GTK. + +@item --enable-java-gc=TYPE +Choose garbage collector. Defaults to @option{boehm} if unspecified. + +@item --disable-gtktest +Do not try to compile and run a test GTK+ program. + +@item --disable-glibtest +Do not try to compile and run a test GLIB program. + +@item --with-libart-prefix=PFX +Prefix where libart is installed (optional). + +@item --with-libart-exec-prefix=PFX +Exec prefix where libart is installed (optional). + +@item --disable-libarttest +Do not try to compile and run a test libart program. + +@end table @html