[pkgsrc/trunk]: pkgsrc/bootstrap bootstrap: Rototill README.Linux

[gdt <gdt%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/9fdbcd335558
branches:  trunk
changeset: 376432:9fdbcd335558
user:      gdt <gdt%pkgsrc.org@localhost>
date:      Thu Apr 07 15:16:55 2022 +0000

description:
bootstrap: Rototill README.Linux

Convert to markdown because the previous style was too confusing.  A
lot of this is ancient; mark it as such.  Fold in comments from Peter
Lai about working/non-working gcc versions.

diffstat:

 bootstrap/README.Linux |  44 ++++++++++++++++++++++++++++++--------------
 1 files changed, 30 insertions(+), 14 deletions(-)

diffs (67 lines):

diff -r 751996d541be -r 9fdbcd335558 bootstrap/README.Linux
--- a/bootstrap/README.Linux    Thu Apr 07 13:13:36 2022 +0000
+++ b/bootstrap/README.Linux    Thu Apr 07 15:16:55 2022 +0000
@@ -1,16 +1,39 @@
-$NetBSD: README.Linux,v 1.9 2021/02/12 13:00:48 cjep Exp $
+$NetBSD: README.Linux,v 1.10 2022/04/07 15:16:55 gdt Exp $
+
+# General
+
+Generally, bootstrapping on GNU/Linux is expected to Just Work with
+gcc.
+
+# Compilers
+
+## gcc
+
+gcc is the standard approach.
 
-Please read the general README file as well.
+As of 2022 it has been reported that systems with gcc 4.8 (e.g. RHEL7)
+do not bootstrap, but that gcc7 (AWS-flavored RHEL7) and gcc8 (RHEL8) succeed.
+
+## clang
+
+There are no reports of success or failure with clang.
 
-==========================================================================
+## icc
+
+Long ago, it was reported that icc (Intel C++ Compiler) 8.0 and 8.1
+have been tested on i386.  See the old section at the end.
+
+# Debian and derivatives
 
 For Debian and derivatives such as Ubuntu the following packages should be
-installed prior to attempting bootstrap
+installed prior to attempting bootstrap:
 
 apt-get install cvs libncurses5 libncurses5-dev gcc g++ zlib1g-dev \
                        zlib1g libssl-dev libudev-dev
 
-==========================================================================
+#  RedHat and derivatives
+
+## Old, undated, information
 
 Some versions of Linux (RHEL3 Update 2 for i386 for example) have a
 /usr/lib/libacl.la libtool archive file that lists /lib/libattr.la as a
@@ -25,16 +48,9 @@
 
 cp -p /usr/lib/libattr.la /lib
 
-==========================================================================
+# General old, undated information
 
-Some versions of Linux (for example Debian GNU/Linux) need either libtermcap
-or libcurses (libncurses).  Installing the distribution's libncurses-dev
-package (or equivalent) should fix related build problems.
-
-==========================================================================
-
-pkgsrc supports both gcc (GNU Compiler Collection) and icc (Intel C++
-Compiler). gcc is the default. icc 8.0 and 8.1 on i386 have been tested.
+## Details of using icc
 
 To bootstrap using icc, assuming the default icc installation
 directory: