Synch with FSF

6 files changed, 66 insertions, 56 deletions

diff --git a/gnu/egcs/install/CONFIGURE b/gnu/egcs/install/CONFIGURE
index a881b59c76d..91338356255 100644
--- a/gnu/egcs/install/CONFIGURE
+++ b/gnu/egcs/install/CONFIGURE
@@ -111,8 +111,9 @@
        be built. For a list of valid values for _lang_x you can issue the
        following command in the gcc directory of your GCC source tree:
        grep language= */config-lang.in
-       Currently, you can use any of the following: CHILL, c++, f77, java
-       and objc. Please note, that this switch does not work with EGCS
+       Currently, you can use any of the following: c++, f77, java and
+       objc. 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 and
        newer versions.
        If you do not pass this flag, all languages available in the gcc
diff --git a/gnu/egcs/install/SPECIFIC b/gnu/egcs/install/SPECIFIC
index 9cadc511a7f..68e5aae1c0a 100644
--- a/gnu/egcs/install/SPECIFIC
+++ b/gnu/egcs/install/SPECIFIC
@@ -158,6 +158,15 @@
 
   i?86-*-sco3.2v5*
 
+   Unlike earlier versions of GCC, the ability to generate COFF with this
+   target is no longer provided.
+
+   Earlier versions of GCC emitted Dwarf-1 when generating ELF to allow
+   the system debugger to be used. That support was too burdensome to
+   maintain. GCC now emits only dwarf-2 for this target. This means you
+   may use either the UDK debugger or GDB to debug programs built by this
+   version of GCC.
+
    If you are building languages other than C, you must follow the
    instructions about invoking `make bootstrap' because the native
    OpenServer compiler will build a cc1plus that will not correctly parse
@@ -165,33 +174,25 @@
    `make bootstrap' if you are building with the native compiler._
 
    Use of the `-march-pentiumpro' flag can result in unrecognized opcodes
-   when using the native assembler. While it's rather rare to see these
-   emitted by GCC yet, errors of the basic form:
+   when using the native assembler on OS versions before 5.0.6. (Support
+   for P6 opcodes was added to the native ELF assembler in that version.)
+   While it's rather rare to see these emitted by GCC yet, errors of the
+   basic form:
   /usr/tmp/ccaNlqBc.s:22:unknown instruction: fcomip
   /usr/tmp/ccaNlqBc.s:50:unknown instruction: fucomip
 
    are symptoms of this problem. You may work around this by not building
-   affected files with that flag or by using the GNU assembler. Users of
+   affected files with that flag, by using the GNU assembler, or by using
+   the assembler provided with the current version of the OS. Users of
    GNU assembler should see the note below for hazards on doing so.
 
-   If you choose to configure with --enable-shared you should also
-   specify --with-gnu-as --disable-multilib even if you are not using the
-   GNU assembler. In doing so you will give up the ability to generate
-   COFF executables as described below. This combination of flags is
-   necessary to suppress negative interactions with multilibing.
-
    The native SCO assembler that is provided with the OS at no charge is
    normally required. If, however, you must be able to use the GNU
    assembler (perhaps you're compiling code with asms that require GAS
    syntax) you may configure this package using the flags --with-gnu-as.
    You must use a recent version of GNU binutils; versions past 2.9.1
-   seems to work well. If you select this option, you will be unable to
-   reliably build COFF images. In general, the --with-gnu-as option isn't
-   as well tested as the native assembler.
-
-   Unlike various prereleases of GCC that used -belf and defaulted to
-   COFF, you must now use the -melf and -mcoff flags to toggle between
-   the two object file formats. ELF is now the default.
+   seem to work well. In general, the --with-gnu-as option isn't as well
+   tested as the native assembler.
 
    Look in gcc/config/i386/sco5.h (search for "messy") for additional
    OpenServer-specific flags.
diff --git a/gnu/egcs/install/TEST b/gnu/egcs/install/TEST
index 2f3c38efd78..bb4dd41fcd8 100644
--- a/gnu/egcs/install/TEST
+++ b/gnu/egcs/install/TEST
@@ -12,8 +12,8 @@
    distribution contains testsuites; only if you downloaded the "core"
    compiler plus any front ends, you do not have the testsuites.
 
-   Second, you must have a new version of dejagnu on your system; dejagnu
-   1.3 will not work. We have made dejagnu snapshots available at
+   Second, you must have a current version of dejagnu installed; dejagnu
+   1.3 is not sufficient. We have made dejagnu snapshots available at
    [2]ftp://gcc.gnu.org/pub/gcc/infrastructure until a new version of
    dejagnu has been released.
 
diff --git a/gnu/egcs/install/configure.html b/gnu/egcs/install/configure.html
index 5e133e9a52c..69a6897d7d9 100644
--- a/gnu/egcs/install/configure.html
+++ b/gnu/egcs/install/configure.html
@@ -151,10 +151,12 @@ GCC.  A partial list of supported <tt>options</tt>:
   <tt>
   grep language= */config-lang.in
   </tt><br>
-  Currently, you can use any of the following: <tt>CHILL</tt>, <tt>c++</tt>,
-  <tt>f77</tt>, <tt>java</tt> and <tt>objc</tt>. Please note, that this switch
-  does not work with EGCS 1.1.2 or older versions of egcs.  It is supported
-  in GCC 2.95 and newer versions.<br>
+  Currently, you can use any of the following: <code>c++</code>,
+  <code>f77</code>, <code>java</code> and <code>objc</code>.
+  <code>CHILL</code> 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
+  and newer versions.  <br>
   If you do not pass this flag, all languages available in the <tt>gcc</tt> sub-tree
   will be configured.  Re-defining LANGUAGES when calling <tt>make bootstrap</tt>
   <b>*does not*</b> work anymore, as those language sub-directories might not have been
diff --git a/gnu/egcs/install/specific.html b/gnu/egcs/install/specific.html
index b116cbfc3b1..c7004ecf6d8 100644
--- a/gnu/egcs/install/specific.html
+++ b/gnu/egcs/install/specific.html
@@ -190,46 +190,52 @@ found on <a href="http://www.bitwizard.nl/sig11/">www.bitwizard.nl.</a></p>
 <hr>
 <h3><a name="ix86-*-sco3.2v5*">i?86-*-sco3.2v5*</a></h3>
 
+<p>Unlike earlier versions of GCC, the ability to generate COFF with this
+target is no longer provided.   
+
+<p>Earlier versions of GCC emitted Dwarf-1 when generating ELF to allow
+the system debugger to be used.  That support was too burdensome to
+maintain.  GCC now emits only dwarf-2 for this target.  This means you
+may use either the UDK debugger or GDB to debug programs built by this
+version of GCC.
+
 <p>If you are building languages other than C, you must follow the instructions
 about invoking `<code>make bootstrap</code>' because the native OpenServer
 compiler will build a <code>cc1plus</code> that will not correctly parse many
 valid C++ programs including those in <code>libgcc.a</code>.  <b>You must do a `<code>make bootstrap</code>' if you are building with the native compiler.</b></p>
 
 <p>Use of the `<code>-march-pentiumpro</code>' flag can result in
-unrecognized opcodes when using the native assembler.  While
-it's rather rare to see these emitted by GCC yet, errors of the basic form:</p>
+unrecognized opcodes when using the native assembler on OS versions before
+5.0.6. (Support for P6 opcodes was added to the native ELF assembler in
+that version.)  While it's rather rare to see these emitted by GCC yet, 
+errors of the basic form:</p>
 <pre>
   /usr/tmp/ccaNlqBc.s:22:unknown instruction: fcomip
   /usr/tmp/ccaNlqBc.s:50:unknown instruction: fucomip
 </pre>
-<p>are symptoms of this problem.   You may work around this by not
-building affected files with that flag or by using the GNU assembler.   
-Users of GNU assembler should see the note below for hazards on doing so.</p>
-
-<p>If you choose to configure with <code>--enable-shared</code> you should also
-specify <code>--with-gnu-as --disable-multilib</code> even if you are not
-using the GNU assembler.   In doing so you will give up the ability
-to generate COFF executables as described below.   This combination 
-of flags is necessary to suppress negative interactions with multilibing.</p>
-
-<p>The native SCO assembler that is provided with the OS at no charge
-is normally required.  If, however, you must be able to use the GNU
-assembler (perhaps you're compiling code with asms that require GAS syntax) 
-you may configure this package using the flags <code>--with-gnu-as</code>.  
-You must use a recent version of GNU binutils; versions past 2.9.1 seems to work well.
-If you select this option, you will be unable to reliably build COFF
-images.  In general, the <code>--with-gnu-as</code> option isn't as well tested as the native assembler.</p>
-
-<p>Unlike various prereleases of GCC that used <code>-belf</code> and 
-defaulted to COFF, you must now use the <code>-melf</code> and 
-<code>-mcoff</code> flags to toggle between the two object file formats.     
-ELF is now the default.</p>
-
-<p>Look in <code>gcc/config/i386/sco5.h</code> (search for "messy") for additional OpenServer-specific flags.</p>
-
-<p>Systems based on OpenServer before 5.0.4 (`<code>uname -X</code>' will
-tell you what you're running) require TLS597 from ftp.sco.com/TLS for
-C++ constructors and destructors to work right.</p>
+
+<p>are symptoms of this problem.  You may work around this by not
+building affected files with that flag, by using the GNU assembler, or
+by using the assembler provided with the current version of the OS.
+Users of GNU assembler should see the note below for hazards on doing
+so.</p>
+
+<p>The native SCO assembler that is provided with the OS at no
+charge is normally required.  If, however, you must be able to use
+the GNU assembler (perhaps you're compiling code with asms that
+require GAS syntax) you may configure this package using the flags
+<code>--with-gnu-as</code>.  You must use a recent version of GNU
+binutils; versions past 2.9.1 seem to work well.
+
+In general, the <code>--with-gnu-as</code> option isn't as well tested
+as the native assembler.</p>
+
+<p>Look in <code>gcc/config/i386/sco5.h</code> (search for "messy") for
+additional OpenServer-specific flags.</p>
+
+<p>Systems based on OpenServer before 5.0.4 (`<code>uname -X</code>'
+will tell you what you're running) require TLS597 from ftp.sco.com/TLS
+for C++ constructors and destructors to work right.</p>
 
 <p>The system linker in (at least) 5.0.4 and 5.0.5 will sometimes
 do the wrong thing for a construct that GCC will emit for PIC
diff --git a/gnu/egcs/install/test.html b/gnu/egcs/install/test.html
index b1774de94fd..465875b787d 100644
--- a/gnu/egcs/install/test.html
+++ b/gnu/egcs/install/test.html
@@ -19,8 +19,8 @@ testsuites</a>. The full distribution contains testsuites; only if you
 downloaded the "core" compiler plus any front ends, you do not have the
 testsuites.</p>
 
-<p>Second, you must have a new version of dejagnu on your system;
-dejagnu 1.3 will not work.  We have made dejagnu snapshots available at
+<p>Second, you must have a current version of dejagnu installed;
+dejagnu 1.3 is not sufficient.  We have made dejagnu snapshots available at
 <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure">ftp://gcc.gnu.org/pub/gcc/infrastructure</a>
 until a new version of dejagnu has been released.</p>