install.texi (Configuration): Fix markup.

* doc/install.texi (Configuration): Fix markup.
	(Specific, i?86-*-udk): Likewise.
	(Specific, alpha*-dec-osf*): Warn against --with-gnu-as,
	--with-gnu-ld.
	Document --enable-threads and --enable-libgcj status.
	(Specific, mips-sgi-irix*): Canonicalize triples.
	(Specific, mips-sgi-irix5): Warn about problems with this config.
	Mention required GNU as patch.
	Native assembler problems are fixed.
	(Specific, mips-sgi-irix6): Update O32 ABI support status.
	Document --enable-threads and --enable-libgcj status.

From-SVN: r44599
This commit is contained in:
Rainer Orth 2001-08-03 11:45:39 +00:00 committed by Rainer Orth
parent ef1f96f06c
commit b953cc4be9
2 changed files with 54 additions and 29 deletions

View File

@ -1,3 +1,17 @@
2001-08-03 Rainer Orth <ro@TechFak.Uni-Bielefeld.DE>
* doc/install.texi (Configuration): Fix markup.
(Specific, i?86-*-udk): Likewise.
(Specific, alpha*-dec-osf*): Warn against --with-gnu-as,
--with-gnu-ld.
Document --enable-threads and --enable-libgcj status.
(Specific, mips-sgi-irix*): Canonicalize triples.
(Specific, mips-sgi-irix5): Warn about problems with this config.
Mention required GNU as patch.
Native assembler problems are fixed.
(Specific, mips-sgi-irix6): Update O32 ABI support status.
Document --enable-threads and --enable-libgcj status.
2001-08-02 Nick Clifton <nickc@cambridge.redhat.com>
* Makefile.in, mklibgcc.in: Restore changes with fixed invocation

View File

@ -446,7 +446,7 @@ Check the
directory, where @var{exec_prefix} defaults to @var{prefix} which
defaults to @file{/usr/local} unless overridden by the
@option{--prefix=@var{pathname}} switch described above. @var{target} is the
target system triple, such as @var{sparc-sun-solaris2.7}, and
target system triple, such as @samp{sparc-sun-solaris2.7}, and
@var{version} denotes the GCC version, such as 3.0.
@item
Check operating system specific directories (e.g.@: @file{/usr/ccs/bin} on
@ -1336,11 +1336,11 @@ GNU Compiler Collection on your machine.
@item
@uref{#mips-mips-riscos*,,mips-mips-riscos*}
@item
@uref{#mips*-sgi-irix4,,mips*-sgi-irix4}
@uref{#mips-sgi-irix4,,mips-sgi-irix4}
@item
@uref{#mips*-sgi-irix5,,mips*-sgi-irix5}
@uref{#mips-sgi-irix5,,mips-sgi-irix5}
@item
@uref{#mips*-sgi-irix6,,mips*-sgi-irix6}
@uref{#mips-sgi-irix6,,mips-sgi-irix6}
@item
@uref{#mips-sony-sysv,,mips-sony-sysv}
@item
@ -1518,6 +1518,15 @@ or you can use a copy of GCC 2.95.3 or higher built on Tru64 UNIX V4.0:
% CC=gcc -Wa,-oldas @var{srcdir}/configure [@var{options}] [@var{target}]
@end example
As of GNU binutils 2.11.2, neither GNU @command{as} nor GNU @command{ld}
are supported on Tru64 UNIX, so you must not configure GCC with
@option{--with-gnu-as} or @option{--with-gnu-ld}.
The @option{--enable-threads} options isn't supported yet. A patch is
in preparation for a future release. The Java runtime library has been
reported to work on Tru64 UNIX V4.0F, V5.0, and V5.1, so you may try
@option{--enable-libgcj} and report your results.
GCC writes a @samp{.verstamp} directive to the assembler output file
unless it is built as a cross-compiler. It gets the version to use from
the system header file @file{/usr/include/stamp.h}. If you install a
@ -1988,7 +1997,7 @@ engineering and will hopefully be addressed in later releases.
This target emulates the SCO Universal Development Kit and requires that
package be installed. (If it is installed, you will have a
@file{/udk/usr/ccs/bin/cc} file present.) It's very much like the
@code{i?86-*-unixware7*} target
@samp{i?86-*-unixware7*} target
but is meant to be used when hosting on a system where UDK isn't the
default compiler such as OpenServer 5 or Unixware 2. This target will
generate binaries that will run on OpenServer, Unixware 2, or Unixware 7,
@ -2644,7 +2653,7 @@ avoiding a linker bug.
</p>
<hr>
@end html
@heading @anchor{mips*-sgi-irix4*}mips*-sgi-irix4*
@heading @anchor{mips-sgi-irix4}mips-sgi-irix4
In order to compile GCC on an SGI running IRIX 4, the ``c.hdr.lib''
option must be installed from the CD-ROM supplied from Silicon Graphics.
@ -2676,7 +2685,10 @@ ignored.
</p>
<hr>
@end html
@heading @anchor{mips*-sgi-irix5*}mips*-sgi-irix5*
@heading @anchor{mips-sgi-irix5}mips-sgi-irix5
This configuration has considerable problems, which will be fixed in a
future release.
In order to compile GCC on an SGI running IRIX 5, the ``compiler_dev.hdr''
subsystem must be installed from the IDO CD-ROM supplied by Silicon
@ -2699,27 +2711,13 @@ to increase its table size for switch statements with the
@option{-Wf,-XNg1500} option. If you use the @option{-O2}
optimization option, you also need to use @option{-Olimit 3000}.
To enable debugging under IRIX 5, you must use GNU @command{as} 2.5 or later,
To enable debugging under IRIX 5, you must use GNU @command{as} 2.11.2
or later,
and use the @option{--with-gnu-as} configure option when configuring GCC.
GNU @command{as} is distributed as part of the binutils package.
You must use GNU @command{as} on these platforms, as the native
assembler can not handle the code for exception handling support. Either
of these messages indicates that you are using the MIPS assembler when
instead you should be using GNU @command{as}:
@example
as0: Error: ./libgcc2.c, line 1:Badly delimited numeric literal
.4byte $LECIE1-$LSCIE1
as0: Error: ./libgcc2.c, line 1:malformed statement
@end example
or:
@example
as0: Error: ./libgcc2.c, line 1:undefined symbol in expression
.word $LECIE1-$LSCIE1
@end example
When using release 2.11.2, you need to apply a patch
@uref{http://sources.redhat.com/ml/binutils/2001-07/msg00352.html,,http://sources.redhat.com/ml/binutils/2001-07/msg00352.html}
which will be included in the next release of binutils.
When building GCC, the build process loops rebuilding @command{cc1} over
and over again. This happens on @samp{mips-sgi-irix5.2}, and possibly
@ -2733,7 +2731,7 @@ not have GNU @command{make} available.
</p>
<hr>
@end html
@heading @anchor{mips*-sgi-irix6}mips*-sgi-irix6
@heading @anchor{mips-sgi-irix6}mips-sgi-irix6
If you are using IRIX @command{cc} as your bootstrap compiler, you must
ensure that the N32 ABI is in use. To test this, compile a simple C
@ -2770,11 +2768,24 @@ You must @emph{not} use GNU @command{as} (which isn't built anyway as of
binutils 2.11.2) on IRIX 6 platforms; doing so will only cause problems.
GCC does not currently support generating O32 ABI binaries in the
@samp{mips-sgi-irix6} configurations. It used to be possible to create a GCC
@samp{mips-sgi-irix6} configurations. It is possible to create a GCC
with O32 ABI only support by configuring it for the @samp{mips-sgi-irix5}
target, which doesn't currently (2001-06-13) work itself. It is
target and using a patched GNU @command{as} 2.11.2 as documented in the
@uref{#mips-sgi-irix5,,@samp{mips-sgi-irix5}} section above. Using the
native assembler requires patches to GCC which will be included in a
future release. It is
expected that O32 ABI support will be available again in a future release.
The @option{--enable-threads} option doesn't currently work, a patch is
in preparation for a future release. The @option{--enable-libgcj}
option is disabled by default: IRIX 6 uses a very low default limit
(20480) for the command line length. Although libtool contains a
workaround for this problem, at least the N64 @samp{libgcj} is known not
to build despite this, running into an internal error of the native
@command{ld}. A sure fix is to increase this limit (@samp{ncargs}) to
its maximum of 262144 bytes. If you have root access, you can use the
@command{systune} command to do this.
GCC does not correctly pass/return structures which are
smaller than 16 bytes and which are not 8 bytes. The problem is very
involved and difficult to fix. It affects a number of other targets also,