Hi Bruno,

I pushed the attached patch fixing a tiny issue I noticed. When you
updated the POSIX links to POSIX.1-2024, the headers included in
POSIX.1-2017 but removed in POSIX.1-2024 also had their links
updated. This can seen on the stropts.h page on gnu.org, for example,
which has a POSIX link which leads you to a 404 error [1].

I assume you likely did something like this:

   $ prev='@url{https://pubs.opengroup.org/onlinepubs/9699919799/'
   $ curr='@url{https://pubs.opengroup.org/onlinepubs/9799919799/'
   $ sed -i "s|$prev|$curr|g" doc/posix-headers/*.texi

This does not work since doc/posix-headers/*.texi contains headers that
have been removed from POSIX. If we were running the command on
doc/posix-functions/*.texi that would be fine since we move functions
removed from POSIX to doc/pastposix-functions/*.texi.

What do you think about creating a doc/pastposix-headers/*.texi to make
it a bit easier to maintain? I can write the patch, but figured it was
worth asking before reorganizing things.

Collin

[1] https://www.gnu.org/software/gnulib/manual/html_node/stropts_002eh.html

>From f70d494fa92e56b0274f568d075c570f83ff8774 Mon Sep 17 00:00:00 2001
Message-ID: <f70d494fa92e56b0274f568d075c570f83ff8774.1770505012.git.collin.fu...@gmail.com>
From: Collin Funk <[email protected]>
Date: Sat, 7 Feb 2026 14:43:47 -0800
Subject: [PATCH] doc: Fix links to headers removed in POSIX.1-2024 (regr.
 2024-07-20).

* doc/posix-headers/stropts.texi: Use the POSIX.1-2017 link where this
header exists.
* doc/posix-headers/trace.texi: Likewise.
* doc/posix-headers/ulimit.texi: Likewise.
* doc/posix-headers/utime.texi: Likewise.
---
 ChangeLog                      | 9 +++++++++
 doc/posix-headers/stropts.texi | 2 +-
 doc/posix-headers/trace.texi   | 2 +-
 doc/posix-headers/ulimit.texi  | 2 +-
 doc/posix-headers/utime.texi   | 2 +-
 5 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 04d4d77b72..519558b8e3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2026-02-07  Collin Funk  <[email protected]>
+
+	doc: Fix links to headers removed in POSIX.1-2024 (regr. 2024-07-20).
+	* doc/posix-headers/stropts.texi: Use the POSIX.1-2017 link where this
+	header exists.
+	* doc/posix-headers/trace.texi: Likewise.
+	* doc/posix-headers/ulimit.texi: Likewise.
+	* doc/posix-headers/utime.texi: Likewise.
+
 2026-02-07  Pádraig Brady  <[email protected]>
 
 	gendocs: support compound $MAKEINFO
diff --git a/doc/posix-headers/stropts.texi b/doc/posix-headers/stropts.texi
index 360eb4ee41..2558888d95 100644
--- a/doc/posix-headers/stropts.texi
+++ b/doc/posix-headers/stropts.texi
@@ -2,7 +2,7 @@ @node stropts.h
 @section @file{stropts.h}
 
 Removed in POSIX.1-2024.
-POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stropts.h.html}
+POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stropts.h.html}
 
 Gnulib module: ---
 
diff --git a/doc/posix-headers/trace.texi b/doc/posix-headers/trace.texi
index 2f96828d09..271f78fd55 100644
--- a/doc/posix-headers/trace.texi
+++ b/doc/posix-headers/trace.texi
@@ -2,7 +2,7 @@ @node trace.h
 @section @file{trace.h}
 
 Removed in POSIX.1-2024.
-POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/trace.h.html}
+POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/trace.h.html}
 
 Gnulib module: ---
 
diff --git a/doc/posix-headers/ulimit.texi b/doc/posix-headers/ulimit.texi
index ece5952367..5e39096795 100644
--- a/doc/posix-headers/ulimit.texi
+++ b/doc/posix-headers/ulimit.texi
@@ -2,7 +2,7 @@ @node ulimit.h
 @section @file{ulimit.h}
 
 Removed in POSIX.1-2024.
-POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/ulimit.h.html}
+POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/ulimit.h.html}
 
 Gnulib module: ---
 
diff --git a/doc/posix-headers/utime.texi b/doc/posix-headers/utime.texi
index f48ede5f48..2a5bcbc75a 100644
--- a/doc/posix-headers/utime.texi
+++ b/doc/posix-headers/utime.texi
@@ -2,7 +2,7 @@ @node utime.h
 @section @file{utime.h}
 
 Removed in POSIX.1-2024.
-POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/utime.h.html}
+POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/utime.h.html}
 
 Gnulib module: utime-h
 @mindex utime-h
-- 
2.53.0

Reply via email to