[v4,17/18] Documentation for the RISC-V 32-bit port

Message ID 6b04040addd0fe87cb349b5b1b9cda14e38f74b2.1597243100.git.alistair.francis@wdc.com
State Superseded
Headers show
Series
  • glibc port for 32-bit RISC-V (RV32)
Related show

Commit Message

There is already RISC-V 64-bit port information in the documentation.
Let's add some documentation entries for the RISC-V 32-bit as well.
---
 NEWS   | 9 ++++++++-
 README | 1 +
 2 files changed, 9 insertions(+), 1 deletion(-)

-- 
2.27.0

Comments

Michael Kerrisk \(man-pages\) via Libc-alpha Aug. 18, 2020, 11:59 p.m. | #1
On Wed, 12 Aug 2020, Alistair Francis wrote:

> diff --git a/NEWS b/NEWS

> index 2937adc3f3..c039a7aede 100644

> --- a/NEWS

> +++ b/NEWS

> @@ -9,7 +9,14 @@ Version 2.33

>  

>  Major new features:

>  

> -  [Add new features here]

> +* Support for the RISC-V ISA running on Linux has been expanded to run on

> +  32-bit hardware.  This requires at least Linux 5.4 and is supported for

> +  the following ISA and ABI pairs:

> +    - rv32imac ilp32

> +    - rv32imafdc ilp32

> +    - rv32imafdc ilp32d

> +  The 32-bit RISC-V port requires the Linux kernel 5.4+, GCC 7.1+ and

> +  binutils 2.28+.


 This repeats the Linux version, and I think the use of "+" in version 
numbers qualifies as slang we would better avoid in such a user-visible 
document (well, there's no previous such use here ever anyway).  We also 
seem to avoid the use of "kernel" in references to Linux versions here.

 How about:

* Support for the RISC-V ISA running on Linux has been expanded to run on
  32-bit hardware.  This is supported for the following ISA and ABI pairs:

    - rv32imac ilp32
    - rv32imafdc ilp32
    - rv32imafdc ilp32d

  The 32-bit RISC-V port requires at least Linux 5.4, GCC 7.1 and binutils 
  2.28.

then?

  Maciej

Patch

diff --git a/NEWS b/NEWS
index 2937adc3f3..c039a7aede 100644
--- a/NEWS
+++ b/NEWS
@@ -9,7 +9,14 @@  Version 2.33
 
 Major new features:
 
-  [Add new features here]
+* Support for the RISC-V ISA running on Linux has been expanded to run on
+  32-bit hardware.  This requires at least Linux 5.4 and is supported for
+  the following ISA and ABI pairs:
+    - rv32imac ilp32
+    - rv32imafdc ilp32
+    - rv32imafdc ilp32d
+  The 32-bit RISC-V port requires the Linux kernel 5.4+, GCC 7.1+ and
+  binutils 2.28+.
 
 Deprecated and removed features, and other changes affecting compatibility:
 
diff --git a/README b/README
index 903f07e484..d0f0edb393 100644
--- a/README
+++ b/README
@@ -39,6 +39,7 @@  The GNU C Library supports these configurations for using Linux kernels:
 	powerpc64*-*-linux-gnu	Big-endian and little-endian.
 	s390-*-linux-gnu
 	s390x-*-linux-gnu
+	riscv32-*-linux-gnu
 	riscv64-*-linux-gnu
 	sh[34]-*-linux-gnu
 	sparc*-*-linux-gnu