This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
install.texi merged from mainline
- To: <gcc-patches at gcc dot gnu dot org>
- Subject: install.texi merged from mainline
- From: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: Sat, 23 Jun 2001 23:48:43 +0100 (BST)
I've merged the 3.0 branch install.texi from the mainline:
Index: ChangeLog
===================================================================
RCS file: /cvs/gcc/gcc/gcc/ChangeLog,v
retrieving revision 1.9240.2.648
retrieving revision 1.9240.2.650
diff -u -r1.9240.2.648 -r1.9240.2.650
--- ChangeLog 2001/06/22 23:13:54 1.9240.2.648
+++ ChangeLog 2001/06/23 22:46:21 1.9240.2.650
@@ -1,3 +1,16 @@
+2001-06-23 Joseph S. Myers <jsm28@cam.ac.uk>
+
+ * doc/install.texi: Merge from mainline:
+ 2001-06-21 Phil Edwards <pme@sources.redhat.com>
+ * doc/install.texi: Add 'c' to list of --enable-languages choices.
+ 2001-06-21 Stan Shebs <shebs@apple.com>
+ * doc/install.texi: Use the correct name "Objective-C" everywhere
+ instead of "Objective C".
+ 2001-06-15 Loren J. Rittle <ljrittle@acm.org>
+ * doc/install.texi: Use correct markup hints.
+ 2001-06-15 Loren J. Rittle <ljrittle@acm.org>
+ * doc/install.texi: Update --enable-threads to match reality.
+
2001-06-22 Joseph S. Myers <jsm28@cam.ac.uk>
* doc/gcc.texi: Update documentation of source files of C
Index: doc/install.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/install.texi,v
retrieving revision 1.1.2.28
retrieving revision 1.1.2.29
diff -u -r1.1.2.28 -r1.1.2.29
--- install.texi 2001/06/22 20:33:24 1.1.2.28
+++ install.texi 2001/06/23 22:42:18 1.1.2.29
@@ -33,7 +33,7 @@
@settitle Installing GCC: Binaries
@end ifset
-@comment $Id: install.texi,v 1.1.2.28 2001/06/22 20:33:24 jsm28 Exp $
+@comment $Id: install.texi,v 1.1.2.29 2001/06/23 22:42:18 jsm28 Exp $
@c Copyright (C) 2001 Free Software Foundation, Inc.
@c *** Converted to texinfo by Dean Wakerley, dean@wakerley.com
@@ -392,7 +392,7 @@
@samp{libstdc++-v3}), @samp{libffi}, @samp{zlib}, @samp{boehm-gc} and
@samp{libjava}. Note that @samp{libobjc} does not recognize itself by
any name, so, if you list package names in @option{--enable-shared},
-you'll only get static Objective C libraries. @samp{libf2c} and
+you'll only get static Objective-C libraries. @samp{libf2c} and
@samp{libiberty} do not support shared libraries at all.
Use @option{--disable-shared} to build only static libraries. Note that
@@ -455,6 +455,16 @@
library, and exception handling for other languages like C++ and Java.
On some systems, this is the default.
+In general, the best (and, in many cases, the only known) threading
+model available will be configured for use. Beware that on some
+systems, gcc has not been taught what threading models are generally
+available for the system. In this case, @option{--enable-threads} is an
+alias for @option{--enable-threads=single}.
+
+@item --disable-threads
+Specify that threading support should be disabled for the system.
+This is an alias for @option{--enable-threads=single}.
+
@item --enable-threads=@var{lib}
Specify that
@var{lib} is the thread support library. This affects the Objective-C
@@ -466,18 +476,20 @@
AIX thread support.
@item dce
DCE thread support.
-@item decosf1
-DEC OSF/1 thread support.
-@item irix
-SGI IRIX thread support.
@item mach
-Generic MACH thread support, known to work on NEXTSTEP.
-@item os2
-IBM OS/2 thread support.
+Generic MACH thread support, known to work on NEXTSTEP. (Please note
+that the file needed to support this configuration, @file{gthr-mach.h}, is
+missing and thus this setting will cause a known bootstrap failure.)
+@item no
+This is an alias for @samp{single}.
@item posix
Generic POSIX thread support.
@item pthreads
-Same as @samp{posix}.
+Same as @samp{posix} on arm*-*-linux*, *-*-chorusos* and *-*-freebsd*
+only. A future release of gcc might remove this alias or extend it
+to all platforms.
+@item rtems
+RTEMS thread support.
@item single
Disable thread support, should work for all platforms.
@item solaris
@@ -534,7 +546,7 @@
@var{langN} you can issue the following command in the
@file{gcc} directory of your GCC source tree:@* @samp{grep language=
*/config-lang.in}@* Currently, you can use any of the following:
-@code{c++}, @code{f77}, @code{java} and @code{objc}.
+@code{c}, @code{c++}, @code{f77}, @code{java} and @code{objc}.
@code{CHILL} is not currently maintained, and will almost
certainly fail to compile. Note that this switch does not work with
EGCS 1.1.2 or older versions of egcs. It is supported in GCC 2.95
@@ -899,7 +911,7 @@
@end example
The testing process will try to test as many components in the GCC
-distribution as possible, including the C, C++, Objective C and Fortran
+distribution as possible, including the C, C++, Objective-C and Fortran
compilers as well as the C++ and Java runtime libraries.
@section How can I run the test suite on selected tests?
@@ -1827,7 +1839,6 @@
@html
</p>
-<hr>
@end html
@html
@@ -2386,7 +2397,7 @@
Current GCC versions probably do not work on version 2 of the NeXT
operating system.
-On NeXTStep 3.0, the Objective C compiler does not work, due,
+On NeXTStep 3.0, the Objective-C compiler does not work, due,
apparently, to a kernel bug that it happens to trigger. This problem
does not happen on 3.1.
--
Joseph S. Myers
jsm28@cam.ac.uk