Commit 97a2feb6 by Matthias Klose Committed by Matthias Klose

install.texi: Remove references to java/libjava.

2016-11-15  Matthias Klose  <doko@ubuntu.com>

        * doc/install.texi: Remove references to java/libjava.
        * doc/sourcebuild.texi: Likewise.

From-SVN: r242455
parent 27b3b3f4
2016-11-15 Matthias Klose <doko@ubuntu.com>
* doc/install.texi: Remove references to java/libjava.
* doc/sourcebuild.texi: Likewise.
2016-11-15 Richard Sandiford <richard.sandiford@arm.com> 2016-11-15 Richard Sandiford <richard.sandiford@arm.com>
Alan Hayward <alan.hayward@arm.com> Alan Hayward <alan.hayward@arm.com>
David Sherwood <david.sherwood@arm.com> David Sherwood <david.sherwood@arm.com>
...@@ -498,28 +498,6 @@ Useful when submitting patches for the GCC source code. ...@@ -498,28 +498,6 @@ Useful when submitting patches for the GCC source code.
Necessary when applying patches, created with @command{diff}, to one's Necessary when applying patches, created with @command{diff}, to one's
own sources. own sources.
@item ecj1
@itemx gjavah
If you wish to modify @file{.java} files in libjava, you will need to
configure with @option{--enable-java-maintainer-mode}, and you will need
to have executables named @command{ecj1} and @command{gjavah} in your path.
The @command{ecj1} executable should run the Eclipse Java compiler via
the GCC-specific entry point. You can download a suitable jar from
@uref{ftp://sourceware.org/pub/java/}, or by running the script
@command{contrib/download_ecj}.
@item antlr.jar version 2.7.1 (or later)
@itemx antlr binary
If you wish to build the @command{gjdoc} binary in libjava, you will
need to have an @file{antlr.jar} library available. The library is
searched for in system locations but can be specified with
@option{--with-antlr-jar=} instead. When configuring with
@option{--enable-java-maintainer-mode}, you will need to have one of
the executables named @command{cantlr}, @command{runantlr} or
@command{antlr} in your path.
@end table @end table
@html @html
...@@ -550,9 +528,9 @@ tarballs compressed with @command{gzip} or ...@@ -550,9 +528,9 @@ tarballs compressed with @command{gzip} or
Please refer to the @uref{http://gcc.gnu.org/releases.html,,releases web page} Please refer to the @uref{http://gcc.gnu.org/releases.html,,releases web page}
for information on how to obtain GCC@. for information on how to obtain GCC@.
The source distribution includes the C, C++, Objective-C, Fortran, Java, The source distribution includes the C, C++, Objective-C, Fortran,
and Ada (in the case of GCC 3.1 and later) compilers, as well as and Ada (in the case of GCC 3.1 and later) compilers, as well as
runtime libraries for C++, Objective-C, Fortran, and Java. runtime libraries for C++, Objective-C, and Fortran.
For previous versions these were downloadable as separate components such For previous versions these were downloadable as separate components such
as the core GCC distribution, which included the C language front end and as the core GCC distribution, which included the C language front end and
shared components, and language-specific distributions including the shared components, and language-specific distributions including the
...@@ -934,7 +912,7 @@ only for the listed packages. For other packages, only static libraries ...@@ -934,7 +912,7 @@ only for the listed packages. For other packages, only static libraries
will be built. Package names currently recognized in the GCC tree are will be built. Package names currently recognized in the GCC tree are
@samp{libgcc} (also known as @samp{gcc}), @samp{libstdc++} (not @samp{libgcc} (also known as @samp{gcc}), @samp{libstdc++} (not
@samp{libstdc++-v3}), @samp{libffi}, @samp{zlib}, @samp{boehm-gc}, @samp{libstdc++-v3}), @samp{libffi}, @samp{zlib}, @samp{boehm-gc},
@samp{ada}, @samp{libada}, @samp{libjava}, @samp{libgo}, and @samp{libobjc}. @samp{ada}, @samp{libada}, @samp{libgo}, and @samp{libobjc}.
Note @samp{libiberty} does not support shared libraries at all. Note @samp{libiberty} does not support shared libraries at all.
Use @option{--disable-shared} to build only static libraries. Note that Use @option{--disable-shared} to build only static libraries. Note that
...@@ -1178,7 +1156,7 @@ Use little endian by default. Provide a multilib for big endian. ...@@ -1178,7 +1156,7 @@ Use little endian by default. Provide a multilib for big endian.
@item --enable-threads @item --enable-threads
Specify that the target Specify that the target
supports threads. This affects the Objective-C compiler and runtime supports threads. This affects the Objective-C compiler and runtime
library, and exception handling for other languages like C++ and Java. library, and exception handling for other languages like C++.
On some systems, this is the default. On some systems, this is the default.
In general, the best (and, in many cases, the only known) threading In general, the best (and, in many cases, the only known) threading
...@@ -1195,7 +1173,7 @@ This is an alias for @option{--enable-threads=single}. ...@@ -1195,7 +1173,7 @@ This is an alias for @option{--enable-threads=single}.
Specify that Specify that
@var{lib} is the thread support library. This affects the Objective-C @var{lib} is the thread support library. This affects the Objective-C
compiler and runtime library, and exception handling for other languages compiler and runtime library, and exception handling for other languages
like C++ and Java. The possibilities for @var{lib} are: like C++. The possibilities for @var{lib} are:
@table @code @table @code
@item aix @item aix
...@@ -1443,7 +1421,7 @@ addition, @samp{libstdc++}'s include files will be installed into ...@@ -1443,7 +1421,7 @@ addition, @samp{libstdc++}'s include files will be installed into
@option{--with-gxx-include-dir=@var{dirname}}. Using this option is @option{--with-gxx-include-dir=@var{dirname}}. Using this option is
particularly useful if you intend to use several versions of GCC in particularly useful if you intend to use several versions of GCC in
parallel. This is currently supported by @samp{libgfortran}, parallel. This is currently supported by @samp{libgfortran},
@samp{libjava}, @samp{libstdc++}, and @samp{libobjc}. @samp{libstdc++}, and @samp{libobjc}.
@item @anchor{WithAixSoname}--with-aix-soname=@samp{aix}, @samp{svr4} or @samp{both} @item @anchor{WithAixSoname}--with-aix-soname=@samp{aix}, @samp{svr4} or @samp{both}
Traditional AIX shared library versioning (versioned @code{Shared Object} Traditional AIX shared library versioning (versioned @code{Shared Object}
...@@ -1563,7 +1541,7 @@ grep ^language= */config-lang.in ...@@ -1563,7 +1541,7 @@ grep ^language= */config-lang.in
@end smallexample @end smallexample
Currently, you can use any of the following: Currently, you can use any of the following:
@code{all}, @code{ada}, @code{c}, @code{c++}, @code{fortran}, @code{all}, @code{ada}, @code{c}, @code{c++}, @code{fortran},
@code{go}, @code{java}, @code{jit}, @code{lto}, @code{objc}, @code{obj-c++}. @code{go}, @code{jit}, @code{lto}, @code{objc}, @code{obj-c++}.
Building the Ada compiler has special requirements, see below. Building the Ada compiler has special requirements, see below.
If you do not pass this flag, or specify the option @code{all}, then all If you do not pass this flag, or specify the option @code{all}, then all
default languages available in the @file{gcc} sub-tree will be configured. default languages available in the @file{gcc} sub-tree will be configured.
...@@ -2415,13 +2393,6 @@ native compiler. You can then use the native GCC compiler to build the ...@@ -2415,13 +2393,6 @@ native compiler. You can then use the native GCC compiler to build the
cross compiler. The installed native compiler needs to be GCC version cross compiler. The installed native compiler needs to be GCC version
2.95 or later. 2.95 or later.
If the cross compiler is to be built with support for the Java
programming language and the ability to compile .java source files is
desired, the installed native compiler used to build the cross
compiler needs to be the same GCC version as the cross compiler. In
addition the cross compiler needs to be configured with
@option{--with-ecj-jar=@dots{}}.
Assuming you have already installed a native copy of GCC and configured Assuming you have already installed a native copy of GCC and configured
your cross compiler, issue the command @command{make}, which performs the your cross compiler, issue the command @command{make}, which performs the
following steps: following steps:
...@@ -2624,7 +2595,7 @@ on a simulator as described at @uref{http://gcc.gnu.org/simtest-howto.html}. ...@@ -2624,7 +2595,7 @@ on a simulator as described at @uref{http://gcc.gnu.org/simtest-howto.html}.
In order to run sets of tests selectively, there are targets In order to run sets of tests selectively, there are targets
@samp{make check-gcc} and language specific @samp{make check-c}, @samp{make check-gcc} and language specific @samp{make check-c},
@samp{make check-c++}, @samp{make check-fortran}, @samp{make check-java}, @samp{make check-c++}, @samp{make check-fortran},
@samp{make check-ada}, @samp{make check-objc}, @samp{make check-obj-c++}, @samp{make check-ada}, @samp{make check-objc}, @samp{make check-obj-c++},
@samp{make check-lto} @samp{make check-lto}
in the @file{gcc} subdirectory of the object directory. You can also in the @file{gcc} subdirectory of the object directory. You can also
...@@ -2722,19 +2693,6 @@ supported in the @file{gcc} subdirectory. (To see how this works, try ...@@ -2722,19 +2693,6 @@ supported in the @file{gcc} subdirectory. (To see how this works, try
typing @command{echo} before the example given here.) typing @command{echo} before the example given here.)
@section Additional testing for Java Class Libraries
The Java runtime tests can be executed via @samp{make check}
in the @file{@var{target}/libjava/testsuite} directory in
the build tree.
The @uref{http://sourceware.org/mauve/,,Mauve Project} provides
a suite of tests for the Java Class Libraries. This suite can be run
as part of libgcj testing by placing the Mauve tree within the libjava
testsuite at @file{libjava/testsuite/libjava.mauve/mauve}, or by
specifying the location of that tree when invoking @samp{make}, as in
@samp{make MAUVEDIR=~/mauve check}.
@section How to interpret test results @section How to interpret test results
The result of running the testsuite are various @file{*.sum} and @file{*.log} The result of running the testsuite are various @file{*.sum} and @file{*.log}
...@@ -2819,7 +2777,7 @@ you specified with the @option{--prefix} to configure (or ...@@ -2819,7 +2777,7 @@ you specified with the @option{--prefix} to configure (or
@file{/usr/local} by default). (If you specified @option{--bindir}, @file{/usr/local} by default). (If you specified @option{--bindir},
that directory will be used instead; otherwise, if you specified that directory will be used instead; otherwise, if you specified
@option{--exec-prefix}, @file{@var{exec-prefix}/bin} will be used.) @option{--exec-prefix}, @file{@var{exec-prefix}/bin} will be used.)
Headers for the C++ and Java libraries are installed in Headers for the C++ library are installed in
@file{@var{prefix}/include}; libraries in @file{@var{libdir}} @file{@var{prefix}/include}; libraries in @file{@var{libdir}}
(normally @file{@var{prefix}/lib}); internal parts of the compiler in (normally @file{@var{prefix}/lib}); internal parts of the compiler in
@file{@var{libdir}/gcc} and @file{@var{libexecdir}/gcc}; documentation @file{@var{libdir}/gcc} and @file{@var{libexecdir}/gcc}; documentation
...@@ -3468,9 +3426,9 @@ The version of binutils installed in @file{/usr/bin} probably works ...@@ -3468,9 +3426,9 @@ The version of binutils installed in @file{/usr/bin} probably works
with this release of GCC@. Bootstrapping against the latest GNU with this release of GCC@. Bootstrapping against the latest GNU
binutils and/or the version found in @file{/usr/ports/devel/binutils} has binutils and/or the version found in @file{/usr/ports/devel/binutils} has
been known to enable additional features and improve overall testsuite been known to enable additional features and improve overall testsuite
results. However, it is currently known that boehm-gc (which itself results. However, it is currently known that boehm-gc may not configure
is required for java) may not configure properly on FreeBSD prior to properly on FreeBSD prior to the FreeBSD 7.0 release with GNU binutils
the FreeBSD 7.0 release with GNU binutils after 2.16.1. after 2.16.1.
@html @html
<hr /> <hr />
...@@ -3568,8 +3526,7 @@ with the one implemented under HP-UX 11 using secondary definitions. ...@@ -3568,8 +3526,7 @@ with the one implemented under HP-UX 11 using secondary definitions.
GCC 3.0 and up support HP-UX 11. GCC 2.95.x is not supported and cannot GCC 3.0 and up support HP-UX 11. GCC 2.95.x is not supported and cannot
be used to compile GCC 3.0 and up. be used to compile GCC 3.0 and up.
The libffi and libjava libraries haven't been ported to 64-bit HP-UX@ The libffi library haven't been ported to 64-bit HP-UX@ and doesn't build.
and don't build.
Refer to @uref{binaries.html,,binaries} for information about obtaining Refer to @uref{binaries.html,,binaries} for information about obtaining
precompiled GCC binaries for HP-UX@. Precompiled binaries must be obtained precompiled GCC binaries for HP-UX@. Precompiled binaries must be obtained
...@@ -3582,11 +3539,7 @@ unbundled compiler, or a binary distribution of GCC@. ...@@ -3582,11 +3539,7 @@ unbundled compiler, or a binary distribution of GCC@.
It is possible to build GCC 3.3 starting with the bundled HP compiler, It is possible to build GCC 3.3 starting with the bundled HP compiler,
but the process requires several steps. GCC 3.3 can then be used to but the process requires several steps. GCC 3.3 can then be used to
build later versions. The fastjar program contains ISO C code and build later versions.
can't be built with the HP bundled compiler. This problem can be
avoided by not building the Java language. For example, use the
@option{--enable-languages="c,c++,f77,objc"} option in your configure
command.
There are several possible approaches to building the distribution. There are several possible approaches to building the distribution.
Binutils can be built first using the HP tools. Then, the GCC Binutils can be built first using the HP tools. Then, the GCC
...@@ -4286,8 +4239,8 @@ you can install a pre-built GCC to bootstrap and install GCC. See the ...@@ -4286,8 +4239,8 @@ you can install a pre-built GCC to bootstrap and install GCC. See the
@uref{binaries.html,,binaries page} for details. @uref{binaries.html,,binaries page} for details.
The Solaris 2 @command{/bin/sh} will often fail to configure The Solaris 2 @command{/bin/sh} will often fail to configure
@samp{libstdc++-v3}, @samp{boehm-gc} or @samp{libjava}. We therefore @samp{libstdc++-v3}or @samp{boehm-gc}. We therefore recommend using the
recommend using the following initial sequence of commands following initial sequence of commands
@smallexample @smallexample
% CONFIG_SHELL=/bin/ksh % CONFIG_SHELL=/bin/ksh
...@@ -4351,9 +4304,6 @@ GNU binutils. @samp{libstdc++} symbol versioning will be disabled if no ...@@ -4351,9 +4304,6 @@ GNU binutils. @samp{libstdc++} symbol versioning will be disabled if no
appropriate version is found. Solaris @command{c++filt} from the Solaris appropriate version is found. Solaris @command{c++filt} from the Solaris
Studio compilers does @emph{not} work. Studio compilers does @emph{not} work.
GNU @command{make} version 3.81 or later is required to build libjava
with the Solaris linker.
Sun bug 4927647 sometimes causes random spurious testsuite failures Sun bug 4927647 sometimes causes random spurious testsuite failures
related to missing diagnostic output. This bug doesn't affect GCC related to missing diagnostic output. This bug doesn't affect GCC
itself, rather it is a kernel bug triggered by the @command{expect} itself, rather it is a kernel bug triggered by the @command{expect}
......
...@@ -28,8 +28,8 @@ subdirectories that contain parts of GCC and its runtime libraries: ...@@ -28,8 +28,8 @@ subdirectories that contain parts of GCC and its runtime libraries:
@table @file @table @file
@item boehm-gc @item boehm-gc
The Boehm conservative garbage collector, used as part of the Java The Boehm conservative garbage collector, optionally used as part of
runtime library. the ObjC runtime library when configured with @option{--enable-objc-gc}.
@item config @item config
Autoconf macros and Makefile fragments used throughout the tree. Autoconf macros and Makefile fragments used throughout the tree.
...@@ -76,7 +76,7 @@ The C preprocessor library. ...@@ -76,7 +76,7 @@ The C preprocessor library.
The Decimal Float support library. The Decimal Float support library.
@item libffi @item libffi
The @code{libffi} library, used as part of the Java runtime library. The @code{libffi} library, used as part of the Go runtime library.
@item libgcc @item libgcc
The GCC runtime library. The GCC runtime library.
...@@ -100,9 +100,6 @@ about this library. ...@@ -100,9 +100,6 @@ about this library.
@item libitm @item libitm
The runtime support library for transactional memory. The runtime support library for transactional memory.
@item libjava
The Java runtime library.
@item libobjc @item libobjc
The Objective-C and Objective-C++ runtime library. The Objective-C and Objective-C++ runtime library.
...@@ -122,9 +119,8 @@ Plugin used by the linker if link-time optimizations are enabled. ...@@ -122,9 +119,8 @@ Plugin used by the linker if link-time optimizations are enabled.
Scripts used by the @code{gccadmin} account on @code{gcc.gnu.org}. Scripts used by the @code{gccadmin} account on @code{gcc.gnu.org}.
@item zlib @item zlib
The @code{zlib} compression library, used by the Java front end, as The @code{zlib} compression library, used for compressing and
part of the Java runtime library, and for compressing and uncompressing uncompressing GCC's intermediate language in LTO object files.
GCC's intermediate language in LTO object files.
@end table @end table
The build system in the top level directory, including how recursion The build system in the top level directory, including how recursion
...@@ -629,8 +625,8 @@ for some purposes such as arguments to @option{--enable-languages}. ...@@ -629,8 +625,8 @@ for some purposes such as arguments to @option{--enable-languages}.
If defined, this variable lists (space-separated) language front ends If defined, this variable lists (space-separated) language front ends
other than C that this front end requires to be enabled (with the other than C that this front end requires to be enabled (with the
names given being their @code{language} settings). For example, the names given being their @code{language} settings). For example, the
Java front end depends on the C++ front end, so sets Obj-C++ front end depends on the C++ and ObjC front ends, so sets
@samp{lang_requires=c++}. @samp{lang_requires="objc c++"}.
@item subdir_requires @item subdir_requires
If defined, this variable lists (space-separated) front end directories If defined, this variable lists (space-separated) front end directories
other than C that this front end requires to be present. For example, other than C that this front end requires to be present. For example,
...@@ -862,7 +858,6 @@ here; FIXME: document the others. ...@@ -862,7 +858,6 @@ here; FIXME: document the others.
* Test Directives:: Directives used within DejaGnu tests. * Test Directives:: Directives used within DejaGnu tests.
* Ada Tests:: The Ada language testsuites. * Ada Tests:: The Ada language testsuites.
* C Tests:: The C language testsuites. * C Tests:: The C language testsuites.
* libgcj Tests:: The Java library testsuites.
* LTO Testing:: Support for testing link-time optimizations. * LTO Testing:: Support for testing link-time optimizations.
* gcov Testing:: Support for testing gcov. * gcov Testing:: Support for testing gcov.
* profopt Testing:: Support for testing profile-directed optimizations. * profopt Testing:: Support for testing profile-directed optimizations.
...@@ -2600,29 +2595,6 @@ Test the testsuite itself using @file{gcc.test-framework/test-framework.exp}. ...@@ -2600,29 +2595,6 @@ Test the testsuite itself using @file{gcc.test-framework/test-framework.exp}.
FIXME: merge in @file{testsuite/README.gcc} and discuss the format of FIXME: merge in @file{testsuite/README.gcc} and discuss the format of
test cases and magic comments more. test cases and magic comments more.
@node libgcj Tests
@section The Java library testsuites.
Runtime tests are executed via @samp{make check} in the
@file{@var{target}/libjava/testsuite} directory in the build
tree. Additional runtime tests can be checked into this testsuite.
Regression testing of the core packages in libgcj is also covered by the
Mauve testsuite. The @uref{http://sourceware.org/mauve/,,Mauve Project}
develops tests for the Java Class Libraries. These tests are run as part
of libgcj testing by placing the Mauve tree within the libjava testsuite
sources at @file{libjava/testsuite/libjava.mauve/mauve}, or by specifying
the location of that tree when invoking @samp{make}, as in
@samp{make MAUVEDIR=~/mauve check}.
To detect regressions, a mechanism in @file{mauve.exp} compares the
failures for a test run against the list of expected failures in
@file{libjava/testsuite/libjava.mauve/xfails} from the source hierarchy.
Update this file when adding new failing tests to Mauve, or when fixing
bugs in libgcj that had caused Mauve test failures.
We encourage developers to contribute test cases to Mauve.
@node LTO Testing @node LTO Testing
@section Support for testing link-time optimizations @section Support for testing link-time optimizations
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment