OpenE2K/gcc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

install.texi: Moved --disable-libgcj and --with-system-zlib documentation to new section for...

Browse Source 
* 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.

Co-Authored-By: Tom Tromey <tromey@redhat.com>

From-SVN: r78166
This commit is contained in:
Mohan Embar 2004-02-20 12:55:00 +00:00 committed by Mohan Embar
parent 6e059adb24
commit c1c3bb0cbd
2 changed files with 150 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
gcc/ChangeLog
View File

@ -1,3 +1,12 @@
2004-02-20 Mohan Embar <gnustuff@thisiscool.com>
Tom Tromey <tromey@redhat.com>
* 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 <kraai@alumni.cmu.edu>
* doc/install.texi (Building the Ada compiler): Remove

161
gcc/doc/install.texi
View File

@ -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
<hr />