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

[rbrown64 at csc dot com dot au]

Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at> on 05/12/2001 09:14:20

To:   <rbrown64@csc.com.au>
cc:   <gcc-patches@gcc.gnu.org>
Subject:  Re: PATCH: gcc.gnu.org/install/{configure,specific}.html


On Fri, 4 May 2001 rbrown64@csc.com.au wrote:
> 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.

Thanks, Rodney.  Unfortunately, when you submitted that patch the
wwwdocs/htdocs/install documentation was already frozen in preparation
of the move from HTML to texinfo.

Would you mind moving over your patch to gcc/doc/install.texi? I'll
immediately apply it then.

Thanks,
Gerald

These changes are untested - I don't yet have the necessary infrastructure
installed.

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

     * install.texi: Add html links for with-gnu-as & with-gnu-ld and refer
to them from hppa & SCO triplets.
        Link back to with-gnu-ld for all ELF platfoms.
        Reword avr binutils recommendation.

--- install.texi.orig    Thu May 17 12:06:39 2001
+++ install.texi    Thu May 17 12:55:09 2001
@@ -309,7 +309,10 @@
 libraries were the default on all systems.

 @item
-@option{--with-gnu-as} @minus{}@minus{} Specify that the compiler should assume that the
+@html
+<a name="with-gnu-as">@option{--with-gnu-as}</a>
+@end html
+ @minus{}@minus{} 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 found assembler is not actually the GNU assembler.
 If you have more than one assembler installed on your system, you may want to use this option
@@ -333,7 +336,10 @@
 multiple assemblers installed and want to choose one that is not found by the above rules.

 @item
-@option{--with-gnu-ld} @minus{}@minus{} Same as @option{--with-gnu-as} but for linker.
+@html
+<a name="with-gnu-ld">@option{--with-gnu-ld}</a>
+@end html
+ @minus{}@minus{} Same as @uref{#with-gnu-as,,@option{--with-gnu-as}} but for linker.

 @item
 @option{--with-ld=@emph{/path/to/ld}} @minus{}@minus{} Same as @option{--with-as}, but for the
@@ -1037,8 +1043,7 @@
 @uref{http://www.itnet.pl/amelektr/avr,,http://www.itnet.pl/amelektr/avr}
 @end itemize

-We strongly recommend to upgrade to binutils 2.11
-(or a current snapshot until 2.11 has been released).
+We @emph{strongly} recommend using binutils 2.11 or newer.

 The following error:
 @example
@@ -1075,11 +1080,11 @@

 Specifically, @option{-g} 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 @option{--with-gnu-as}
-option.
+use GAS and GDB and configure GCC with the @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}}
+and @option{--with-as=...} options.

 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
 @uref{ftp://sources.redhat.com/pub/binutils/snapshots,,snapshot of gas}.

 More specific information to hppa*-hp-hpux* targets follows.
@@ -1210,7 +1215,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
-@option{--with-gnu-as}.  You must use a recent version of GNU
+@uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}}.  You must use a recent version of GNU
 binutils; versions past 2.9.1 seem to work well.

 In general, the @option{--with-gnu-as} option isn't as well tested
@@ -1795,8 +1800,8 @@
 <h3><a name="elf_targets">all ELF targets (SVR4, Solaris, etc.)</a></h3>
 @end html

-C++ support is significantly better on ELF targets if you use the GNU
-linker; duplicate copies of inlines, vtables and template instantiations
+C++ support is significantly better on ELF targets if you use the @uref{./configure.html#with-gnu-ld,,GNU
+linker}; duplicate copies of inlines, vtables and template instantiations
 will be discarded automatically.