From b865fc7d242e91f2d5246a9f185736c1389cb472 Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Mon, 10 Apr 2023 14:55:42 +0200
Subject: doc: Clarify list of platforms for year2038 support.

* doc/year2038.texi (Avoiding the year 2038 problem): List the platforms
on which year2038-required is known to fail vs. known to succeed.
---
 doc/year2038.texi | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

(limited to 'doc')

diff --git a/doc/year2038.texi b/doc/year2038.texi
index d98753101e..abb7b54c84 100644
--- a/doc/year2038.texi
+++ b/doc/year2038.texi
@@ -18,6 +18,51 @@ timestamps.  On older platforms that do not support timestamps after
 the year 2038, @samp{year2038-required} causes @command{configure} to
 fail.
 
+With the @samp{year2038-required} module, @command{configure} fails
+on the following 32-bit platforms (or ABIs in bi-arch systems):
+@itemize
+@item
+Linux with glibc < 2.34 on
+x86, arm, mips (32-bit or n32 ABI), powerpc, sparc, s390, hppa, m68k, sh, csky, microblaze, nios2,
+@item
+Linux/riscv32,
+@item
+Mac OS X on x86 and powerpc,
+@item
+GNU/Hurd/x86,
+@item
+GNU/kFreeBSD/x86,
+@item
+FreeBSD/x86,
+@item
+MidnightBSD/x86,
+@item
+AIX/powerpc,
+@item
+Solaris 10 and 11 on x86 and sparc,
+@item
+Cygwin/x86,
+@item
+Haiku/x86.
+@end itemize
+
+Whereas no failure will occur on the following 32-bit platforms or ABIs:
+@itemize
+@item
+Linux/x86 with glibc >= 2.34 on
+x86, arm, mips (32-bit or n32 ABI), powerpc, sparc, s390, hppa, m68k, sh, csky, microblaze, nios2,
+@item
+Linux/x86_64-x32,
+@item
+NetBSD on x86 and sparc,
+@item
+OpenBSD/x86,
+@item
+FreeBSD/arm,
+@item
+Minix 3.3.
+@end itemize
+
 The Gnulib module @samp{year2038} is like @samp{year2038-required},
 except that it causes @command{configure} to fail only when it appears
 that the current system should support post-2038 timestamps but
-- 
cgit v1.2.1