diff mbox series

install: Streamline the hppa*-hp-hpux* section

Message ID 4e180914-6f69-a2bc-157d-1d8fdb88142e@pfeifer.com
State New
Headers show
Series install: Streamline the hppa*-hp-hpux* section | expand

Commit Message

Gerald Pfeifer Dec. 17, 2023, 1:35 a.m. UTC
John, Jeff,

I suggest to streamline the hppa*-hp-hpux* installation instructions as 
follows. Okay?

In fact in the following sections there is even more, and more specific 
material, which would be great could you have a look at and help trim.

Gerald



From 52149282c3a77ccda6385f06f36323c71b26491a Mon Sep 17 00:00:00 2001
From: Gerald Pfeifer <gerald@pfeifer.com>
Date: Sun, 17 Dec 2023 09:33:40 +0800
Subject: [PATCH] install: Streamline the hppa*-hp-hpux* section

gcc:

	PR target/69374
	* doc/install.texi (Specific) <hppa*-hp-hpux*>: Remove a note on
        GCC 4.3.
	Remove details on how the HP assembler, which we document as not
        working, breaks.
---
 gcc/doc/install.texi | 17 -----------------
 1 file changed, 17 deletions(-)

Comments

John David Anglin Dec. 17, 2023, 2:06 a.m. UTC | #1
Hi Gerald,

I have one comment.  The only target currently supported is hppa64-hp-hpux11*.
While gas is required, only the HP ld works.

Otherwise, the change looks fine.

Dave

On 2023-12-16 8:35 p.m., Gerald Pfeifer wrote:
> John, Jeff,
>
> I suggest to streamline the hppa*-hp-hpux* installation instructions as
> follows. Okay?
>
> In fact in the following sections there is even more, and more specific
> material, which would be great could you have a look at and help trim.
>
> Gerald
>
>
>
> >From 52149282c3a77ccda6385f06f36323c71b26491a Mon Sep 17 00:00:00 2001
> From: Gerald Pfeifer <gerald@pfeifer.com>
> Date: Sun, 17 Dec 2023 09:33:40 +0800
> Subject: [PATCH] install: Streamline the hppa*-hp-hpux* section
>
> gcc:
>
> 	PR target/69374
> 	* doc/install.texi (Specific) <hppa*-hp-hpux*>: Remove a note on
>          GCC 4.3.
> 	Remove details on how the HP assembler, which we document as not
>          working, breaks.
> ---
>   gcc/doc/install.texi | 17 -----------------
>   1 file changed, 17 deletions(-)
>
> diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
> index 5ec81098d47..70d46feabf6 100644
> --- a/gcc/doc/install.texi
> +++ b/gcc/doc/install.texi
> @@ -4121,8 +4121,6 @@ longer a multiple of 2 bytes.
>   @end html
>   @anchor{hppa-hp-hpux}
>   @heading hppa*-hp-hpux*
> -Support for HP-UX version 9 and older was discontinued in GCC 3.4.
> -
>   We require using gas/binutils on all hppa platforms.  Version 2.19 or
>   later is recommended.
>   
> @@ -4130,21 +4128,6 @@ It may be helpful to configure GCC with the
>   @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}} and
>   @option{--with-as=@dots{}} options to ensure that GCC can find GAS@.
>   
> -The HP assembler should not be used with GCC.  It is rarely tested and may
> -not work.  It shouldn't be used with any languages other than C due to its
> -many limitations.
> -
> -Specifically, @option{-g} does not work (HP-UX uses a peculiar debugging
> -format which GCC does not know about).  It also inserts timestamps
> -into each object file it creates, causing the 3-stage comparison test to
> -fail during a bootstrap.  You should be able to continue by saying
> -@samp{make all-host all-target} after getting the failure from @samp{make}.
> -
> -Various GCC features are not supported.  For example, it does not support weak
> -symbols or alias definitions.  As a result, explicit template instantiations
> -are required when using C++.  This makes it difficult if not impossible to
> -build many C++ applications.
> -
>   There are two default scheduling models for instructions.  These are
>   PROCESSOR_7100LC and PROCESSOR_8000.  They are selected from the pa-risc
>   architecture specified for the target machine when configuring.
Gerald Pfeifer Dec. 17, 2023, 7:23 a.m. UTC | #2
On Sat, 16 Dec 2023, John David Anglin wrote:
> I have one comment.  The only target currently supported is 
> hppa64-hp-hpux11*. While gas is required, only the HP ld works.
> 
> Otherwise, the change looks fine.

Thank you, Dave!

I updated the patch accordingly, referring to gas (not gas/binutils) and 
being explicit around the flavor of ld to use, and pushed it.

Any further comments or suggestions, let me know.

Gerald


commit da70c5b17123b7c81155ef03fb4591b71a681344
Author: Gerald Pfeifer <gerald@pfeifer.com>
Date:   Sun Dec 17 15:13:39 2023 +0800

    install: Streamline the hppa*-hp-hpux* section
    
    gcc:
    
            PR target/69374
            * doc/install.texi (Specific) <hppa*-hp-hpux*>: Remove a note on
            GCC 4.3.
            Remove details on how the HP assembler, which we document as not
            working, breaks.
            <hppa*-hp-hpux11>: Note that only the HP linker is supported.

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 5ec81098d47..84d8834a9b5 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -4121,30 +4121,13 @@ longer a multiple of 2 bytes.
 @end html
 @anchor{hppa-hp-hpux}
 @heading hppa*-hp-hpux*
-Support for HP-UX version 9 and older was discontinued in GCC 3.4.
-
-We require using gas/binutils on all hppa platforms.  Version 2.19 or
+We require using gas on all hppa platforms.  Version 2.19 or
 later is recommended.
 
 It may be helpful to configure GCC with the
 @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}} and
 @option{--with-as=@dots{}} options to ensure that GCC can find GAS@.
 
-The HP assembler should not be used with GCC.  It is rarely tested and may
-not work.  It shouldn't be used with any languages other than C due to its
-many limitations.
-
-Specifically, @option{-g} does not work (HP-UX uses a peculiar debugging
-format which GCC does not know about).  It also inserts timestamps
-into each object file it creates, causing the 3-stage comparison test to
-fail during a bootstrap.  You should be able to continue by saying
-@samp{make all-host all-target} after getting the failure from @samp{make}.
-
-Various GCC features are not supported.  For example, it does not support weak
-symbols or alias definitions.  As a result, explicit template instantiations
-are required when using C++.  This makes it difficult if not impossible to
-build many C++ applications.
-
 There are two default scheduling models for instructions.  These are
 PROCESSOR_7100LC and PROCESSOR_8000.  They are selected from the pa-risc
 architecture specified for the target machine when configuring.
@@ -4269,9 +4252,7 @@ options, including program core dumps.  Binutils 2.14 corrects a
 problem on the 64-bit port resulting from HP's non-standard use of
 the .init and .fini sections for array initializers and finalizers.
 
-Although the HP and GNU linkers are both supported for the
-@samp{hppa64-hp-hpux11*} target, it is strongly recommended that the
-HP linker be used for link editing on this target.
+Only the HP linker is supported for the @samp{hppa64-hp-hpux11*} target.
 
 At this time, the GNU linker does not support the creation of long
 branch stubs.  As a result, it cannot successfully link binaries
diff mbox series

Patch

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 5ec81098d47..70d46feabf6 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -4121,8 +4121,6 @@  longer a multiple of 2 bytes.
 @end html
 @anchor{hppa-hp-hpux}
 @heading hppa*-hp-hpux*
-Support for HP-UX version 9 and older was discontinued in GCC 3.4.
-
 We require using gas/binutils on all hppa platforms.  Version 2.19 or
 later is recommended.
 
@@ -4130,21 +4128,6 @@  It may be helpful to configure GCC with the
 @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}} and
 @option{--with-as=@dots{}} options to ensure that GCC can find GAS@.
 
-The HP assembler should not be used with GCC.  It is rarely tested and may
-not work.  It shouldn't be used with any languages other than C due to its
-many limitations.
-
-Specifically, @option{-g} does not work (HP-UX uses a peculiar debugging
-format which GCC does not know about).  It also inserts timestamps
-into each object file it creates, causing the 3-stage comparison test to
-fail during a bootstrap.  You should be able to continue by saying
-@samp{make all-host all-target} after getting the failure from @samp{make}.
-
-Various GCC features are not supported.  For example, it does not support weak
-symbols or alias definitions.  As a result, explicit template instantiations
-are required when using C++.  This makes it difficult if not impossible to
-build many C++ applications.
-
 There are two default scheduling models for instructions.  These are
 PROCESSOR_7100LC and PROCESSOR_8000.  They are selected from the pa-risc
 architecture specified for the target machine when configuring.