From a133eedc5b711e581b1f2f1aba9b6653faab1a46 Mon Sep 17 00:00:00 2001
From: John Zaitseff <J.Zaitseff@zap.org.au>
Date: Fri, 5 Jan 2024 11:44:41 +1100
Subject: [PATCH] Update INSTALL to reflect testing on Debian and Ubuntu
 distributions

Unfortunately, the current version (and possibly earlier versions) of the
NVIDIA HPC SDK compiler fails to work with Autoconf/Automake.
---
 INSTALL | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/INSTALL b/INSTALL
index ca1b97e..c18dfcc 100644
--- a/INSTALL
+++ b/INSTALL
@@ -208,15 +208,18 @@ tested with this version of Star Traders:
 ====================================  ======  =====  ========================
 Linux distribution                    Arch    Glibc  Compiler
 ====================================  ======  =====  ========================
-Debian GNU/Linux Unstable (Sid)       x86_64  2.33   GNU C Compiler 12.1.0
-Debian GNU/Linux Unstable (Sid)       x86_64  2.33   Clang (LLVM) 14.0.6
-Debian GNU/Linux 11.4 (Bullseye)      x86_64  2.31   GNU C Compiler 10.2.1
-Debian GNU/Linux 11.4 (Bullseye)      x86_64  2.31   Clang (LLVM) 11.0.1
-Ubuntu 22.04.1 LTS (Jammy Jellyfish)  x86_64  2.35   GNU C Compiler 11.2.0
-Ubuntu 22.04.1 LTS (Jammy Jellyfish)  x86_64  2.35   Clang (LLVM) 14.0.0
-Ubuntu 22.04.1 LTS (Jammy Jellyfish)  x86_64  2.35   NVIDIA HPC SDK 22.7
-Ubuntu 20.04.4 LTS (Focal Fossa)      x86_64  2.31   GNU C Compiler 9.4.0
+Debian GNU/Linux Unstable (Sid)       x86_64  2.37   GNU C Compiler 13.2.0
+Debian GNU/Linux Unstable (Sid)       x86_64  2.37   Clang (LLVM) 16.0.6
+Debian GNU/Linux 12.4 (Bookworm)      x86_64  2.36   GNU C Compiler 12.2.0
+Debian GNU/Linux 12.4 (Bookworm)      x86_64  2.36   Clang (LLVM) 14.0.6
+Ubuntu 23.10 (Mantic Minotaur)        x86_64  2.38   GNU C Compiler 13.2.0
+Ubuntu 23.10 (Mantic Minotaur)        x86_64  2.38   Clang (LLVM) 16.0.6
+Ubuntu 22.04.3 LTS (Jammy Jellyfish)  x86_64  2.35   GNU C Compiler 11.4.0
+Ubuntu 22.04.3 LTS (Jammy Jellyfish)  x86_64  2.35   Clang (LLVM) 14.0.0
+Ubuntu 20.04.6 LTS (Focal Fossa)      x86_64  2.31   GNU C Compiler 9.4.0
+Ubuntu 20.04.6 LTS (Focal Fossa)      x86_64  2.31   Clang (LLVM) 10.0.0
 Ubuntu 18.04.6 LTS (Bionic Beaver)    x86_64  2.27   GNU C Compiler 7.5.0
+Ubuntu 18.04.6 LTS (Bionic Beaver)    x86_64  2.27   Clang (LLVM) 6.0
 Fedora Linux 36                       x86_64  2.35   GNU C Compiler 12.1.1
 Red Hat Enterprise Linux 9.0          x86_64  2.34   GNU C Compiler 11.2.1
 Red Hat Enterprise Linux 8.6          x86_64  2.28   GNU C Compiler 8.5.0
@@ -312,9 +315,17 @@ list is almost certainly not exhaustive:
 ================  ======  ====================  ============
 Operating system   Arch   Compiler              Notes
 ================  ======  ====================  ============
+Linux (any)       x86_64  NVIDIA HPC SDK 23.11  [#nvidia1]_
 OpenBSD 7.1       x86_64  Clang (LLVM) 13.0.0   [#openbsd1]_
 ================  ======  ====================  ============
 
+.. [#nvidia1] The `NVIDIA HPC SDK`__ 23.11 compiler (and possibly earlier
+   versions) does not work due to a bug in ``nvc -E`` preprocessor
+   output.  See the `bug report`__ for further details.
+
+   __ https://developer.nvidia.com/nvidia-hpc-sdk-releases
+   __ https://forums.developer.nvidia.com/t/hpc-sdk-does-not-work-with-autoconf-automake-based-projects/277894
+
 .. [#openbsd1] The OpenBSD C library does not include
    :code:`<monetary.h>` nor its associated functions, particularly
    :code:`strfmon()`.