[patch] install.texi: gcn - update llvm reqirements, gcn/nvptx - newlib use version

[patch] install.texi: gcn - update llvm reqirements, gcn/nvptx - newlib use version

[Tobias Burnus]

[-- Attachment #1.1: Type: text/plain, Size: 1598 bytes --]

That's for https://gcc.gnu.org/install/specific.html

[I did notice (just before submitting) that the bullet list
 was incomplete - hence, I added it. (Also one ref missed a '-x'.)
 However, main reason for this patch is for GCN:]

The listed LLVM version for GCN was outdated.

For newlib, I also decided to change from a date/hash-based
versioning to a release version - for both nvptx and gcn.

[There are some reasons to recommend 4.3.0 once released (or current git),
but those fixes are only very nice and not strictly required. (See below.)]

OK for mainline + GCC 12 backport?

* * *

Regarding newlib:

* Last release:
- 4.2.0 (Dec 2021, end of year snapshot, "newlib-snapshot-20211231" git tag)

* GCN
- The last bugfix was 2019-11-07, but that's also in 3.2.0
  but after the previously listed date
- Afterwards, there was only fix after the Makefile reorg (2022-03-21)
  but that's a post 4.2.0 change. For some reasons, reorg also exposed
  a preexisting issue ("I'm not sure how this ever worked?")

* nvptx: More recent nvptx changes:
- fix calloc for nvptx: "Fix Bug libc/28945" (Mar 22) - next annual snapshot
- "newlib: Only call _fputwc_r if ELIX_LEVEL >= 4" (Mar 22) - next annual snapshot
- "nvptx: Emulate clock and other machine stubs." (Aug 21) - in 4.2.0

Tobias


-----------------
Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955

[-- Attachment #2: fix-install-texi.diff --]
[-- Type: text/x-patch, Size: 3092 bytes --]

install.texi: gcn - update llvm reqirements, gcn/nvptx - newlib use version

gcc/
	* doc/install.texi (Specific): Add missing items to bullet list.
	(amdgcn): Update LLVM requirements, use version not date for newlib.
	(nvptx): Use version not git hash for newlib.

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index cc01c691dc1..4931e0b4fc5 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -3563,16 +3563,28 @@ information have to.
 @item
 @uref{#alpha-x-x,,alpha*-*-*}
 @item
+@uref{#amdgcn-x-amdhsa,,amdgcn-*-amdhsa}
+@item
 @uref{#amd64-x-solaris2,,amd64-*-solaris2*}
 @item
+@uref{#arc-x-elf32,,arc-*-elf32}
+@item
+@uref{#arc-linux-uclibc,,arc-linux-uclibc}
+@item
 @uref{#arm-x-eabi,,arm-*-eabi}
 @item
 @uref{#avr,,avr}
 @item
 @uref{#bfin,,Blackfin}
 @item
+@uref{#cris,,cris}
+@item
 @uref{#dos,,DOS}
 @item
+@uref{#epiphany-x-elf,,epiphany-*-elf}
+@item
+@uref{#ft32-x-elf,,ft32-*-elf}
+@item
 @uref{#x-x-freebsd,,*-*-freebsd*}
 @item
 @uref{#h8300-hms,,h8300-hms}
@@ -3597,6 +3609,8 @@ information have to.
 @item
 @uref{#iq2000-x-elf,,iq2000-*-elf}
 @item
+@uref{#loongarch,,loongarch}
+@item
 @uref{#lm32-x-elf,,lm32-*-elf}
 @item
 @uref{#lm32-x-uclinux,,lm32-*-uclinux}
@@ -3607,12 +3621,16 @@ information have to.
 @item
 @uref{#m68k-x-x,,m68k-*-*}
 @item
-@uref{#m68k-uclinux,,m68k-uclinux}
+@uref{#m68k-x-uclinux,,m68k-*-uclinux}
 @item
 @uref{#microblaze-x-elf,,microblaze-*-elf}
 @item
 @uref{#mips-x-x,,mips-*-*}
 @item
+@uref{#moxie-x-elf,,moxie-*-elf}
+@item
+@uref{#msp430-x-elf,,msp430-*-elf}
+@item
 @uref{#nds32le-x-elf,,nds32le-*-elf}
 @item
 @uref{#nds32be-x-elf,,nds32be-*-elf}
@@ -3651,6 +3669,10 @@ information have to.
 @item
 @uref{#riscv64-x-linux,,riscv64-*-linux}
 @item
+@uref{#rl78-x-elf,,rl78-*-elf}
+@item
+@uref{#rx-x-elf,,rx-*-elf}
+@item
 @uref{#s390-x-linux,,s390-*-linux*}
 @item
 @uref{#s390x-x-linux,,s390x-*-linux*}
@@ -3765,14 +3787,14 @@ This is a synonym for @samp{x86_64-*-solaris2*}.
 @heading amdgcn-*-amdhsa
 AMD GCN GPU target.
 
-Instead of GNU Binutils, you will need to install LLVM 6, or later, and copy
+Instead of GNU Binutils, you will need to install LLVM 13.0.1, or later, and copy
 @file{bin/llvm-mc} to @file{amdgcn-amdhsa/bin/as},
 @file{bin/lld} to @file{amdgcn-amdhsa/bin/ld},
 @file{bin/llvm-nm} to @file{amdgcn-amdhsa/bin/nm}, and
 @file{bin/llvm-ar} to both @file{bin/amdgcn-amdhsa-ar} and
 @file{bin/amdgcn-amdhsa-ranlib}.
 
-Use Newlib (2019-01-16, or newer).
+Use Newlib (3.2.0, or newer).
 
 To run the binaries, install the HSA Runtime from the
 @uref{https://rocm.github.io,,ROCm Platform}, and use
@@ -4589,8 +4611,7 @@ Instead of GNU binutils, you will need to install
 Tell GCC where to find it:
 @option{--with-build-time-tools=[install-nvptx-tools]/nvptx-none/bin}.
 
-You will need newlib 3.0 git revision
-cd31fbb2aea25f94d7ecedc9db16dfc87ab0c316 or later.  It can be
+You will need newlib 3.1.0 or later.  It can be
 automatically built together with GCC@.  For this, add a symbolic link
 to nvptx-newlib's @file{newlib} directory to the directory containing
 the GCC sources.

Re: [patch] install.texi: gcn - update llvm reqirements, gcn/nvptx - newlib use version

[Tobias Burnus]

[-- Attachment #1: Type: text/plain, Size: 745 bytes --]

On 30.09.22 10:00, Tobias Burnus wrote:

That's for https://gcc.gnu.org/install/specific.html
...
            * doc/install.texi (Specific): Add missing items to bullet list.
            (amdgcn): Update LLVM requirements, use version not date for newlib.
            (nvptx): Use version not git hash for newlib.


Now committed as obvious (+ Andrew's LGTM on IRC) as https://gcc.gnu.org/r13-3056-ge886ebd17965d78f609b62479f4f48085108389c

Thanks,

Tobias


-----------------
Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955