PATCH: gcc.gnu.org/install/{configure,specific}.html

[rbrown64 at csc dot com dot au]

Failing to provide --with-as= after configuring --with-gnu-as is a common
mistake. The following adds links back from install/specific.html back to
install/configure.html to better document the need.
gcc PR 2477  "gcc 2.95.3 won't build on HPUX 10.2 --with-gnu-as option"
is an example of the problem I think.
<http://gcc.gnu.org/cgi-bin/gnatsweb.pl?cmd=view&pr=2477&database=gcc>

binutils-2.11/gas does support HPPA2.0 doesn't it? There is no mention
of pa2.0 support in binutils-2.11/gas/NEWS .

2001-05-04  Rodney Brown  <rbrown64@csc.com.au>

     * specific.html: Update hppa*-hp-hpux* entry and add links back to
        configure.html#with-gnu-{as,ld}.
     * configure.html: Add #with-gnu-{as,ld}. Link back to --with-gnu-as from
       --with-gnu-ld.

--- specific.html   2001/05/04 03:10:05  1.1
+++ specific.html   2001/05/04 04:12:44
@@ -163,11 +163,11 @@

 <p>Specifically, <code>-g</code> does not work on HP-UX (since that system
 uses a peculiar debugging format which GCC does not know about), unless you
-use GAS and GDB and configure GCC with the <code>--with-gnu-as</code>
-option.</p>
+use GAS and GDB and configure GCC with the <code><a href="./configure.html#with-gnu-as">--with-gnu-as</a></code>
+and <code>--with-as=...</code> options.</p>

 <p>If you wish to use pa-risc 2.0 architecture support, you must use either
-the HP assembler or a recent
+the HP assembler, gas/binutils-2.11 or a recent
 <a href="ftp://sources.redhat.com/pub/binutils/snapshots";>snapshot of
 gas</a>.</p>

@@ -269,7 +269,7 @@
 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
+<code><a href="./configure.html#with-gnu-as">--with-gnu-as</a></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
@@ -740,8 +740,8 @@
 <hr>
 <h3><a name="elf_targets">all ELF targets (SVR4, Solaris, etc.)</a></h3>

-<p>C++ support is significantly better on ELF targets if you use the GNU
-linker; duplicate copies of inlines, vtables and template instantiations
+<p>C++ support is significantly better on ELF targets if you use the <a href="./configure.html#with-gnu-ld">GNU
+linker</a>; duplicate copies of inlines, vtables and template instantiations
 will be discarded automatically.</p>


--- configure.html  2001/05/04 03:10:05  1.1
+++ configure.html  2001/05/04 04:16:00
@@ -97,7 +97,7 @@
   the gcc version 2.95.x series, static libraries were the default on
   all systems.</li>

-  <li> <code>--with-gnu-as</code> -- Specify that the compiler should
+  <li> <code><a name="with-gnu-as">--with-gnu-as</a></code> -- Specify that the compiler should
   assume that the assembler it finds is the GNU assembler. However,
   this does not modify the rules to find an assembler and will result
   in confusion if the found assembler is not actually the GNU
@@ -126,7 +126,7 @@
   multiple assemblers installed and want to choose one that is not
   found by the above rules.</li>

-  <li> <code>--with-gnu-ld</code> -- Same as <code>--with-gnu-as</code> but
+  <li> <code><a name="with-gnu-ld">--with-gnu-ld</a></code> -- Same as <code><a href="#with-gnu-as">--with-gnu-as</a></code> but
   for the linker.</li>

   <li> <code>--with-ld=</code><i>/path/to/ld</i> -- Same as