All pages: Replace the 4th argument to .TH by "Linux man-pages (unreleased)"

On 8/20/22 13:57, Alejandro Colomar wrote:
> On 8/20/22 07:43, G. Branden Robinson wrote:
>>
>> In my opinion it would benefit readers of the Linux man-pages if the
>> fourth argument to `TH` were what it is in many other man pages: an
>> identifier for the name and version number of the release originating
>> them.  In every page it would be clear what version of the man-pages was
>> being viewed.  Little sophistication would be demanded of the user to
>> check the Web to determine the relative age of the pages, independently
>> of the modification date of the particular page.  Such usage would be
>> congruent with the argument's purpose in AT&T and BSD Unix, where this
>> datum was "7th Edition", "System III", or "4.2 Berkeley Distribution",
>> or similar.
>
> I thought about it in the past...  That field was the only thing that
> said where a function came from.  If we removed GNU (or something else),
> how would someone know where does the function or whatever comes from??
>
> I guess that's also why the colophon was appended to the pages by
> Michael.  Since we couldn't use the 4th field for that, we had to have a
> COLOPHON section.
>
> However, the addition of the LIBRARY section seems to fix this issue,
> and so now we have an even more precise way to determine where a given
> function comes from (including the library file name, and the linker
> option).
>
> This gives me another argument for those who don't like to have a
> LIBRARY section for libc stuff (since -lc is unnecessary), and consider
> it noise.
>
>>
>> Further, as the libc-related man pages in this project expand coverage
>> to other libcs than GNU's, the alternatives to the empty string
>> proferred in man-pages(7) seem less and less appropriate.
>
> Agree.  LIBRARY seems much more appropriate for that purpose.
>
> And this helps remove the COLOPHON section (or at least, we don't need
> to autogenerate it, since the version number now comes in .TH, and the
> COLOPHON is static; so I can even move it to a smaller REPORTING BUGS
> section).

Scripted change:

$ find man* -type f \
  |xargs sed -Ei '/^.TH /s/(.TH +[^ ]+ +[^ ]+ +[^ ]+) +"[^"]*"/\1 "Linux man-pages (unreleased)"/'

$ find man* -type f \
  |xargs sed -Ei '/^.TH /s/(.TH +[^ ]+ +[^ ]+ +[^ ]+) +[^" ]+/\1 "Linux man-pages (unreleased)"/'

$ git restore man5/tzfile.5
$ git restore man8/zdump.8
$ git restore man8/zic.8
$ git restore man7/bpf-helpers.7

Link: <https://lore.kernel.org/linux-man/20220819180323.dbsgxh5qvcjabjm6@jwilk.net/T/#u>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.de>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>

32 files changed, 32 insertions, 32 deletions

diff --git a/man3type/aiocb.3type b/man3type/aiocb.3type
index 6703bca79..830430b22 100644
--- a/man3type/aiocb.3type
+++ b/man3type/aiocb.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH AIOCB 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH AIOCB 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 aiocb \- asynchronous I/O control block
 .SH LIBRARY
diff --git a/man3type/blkcnt_t.3type b/man3type/blkcnt_t.3type
index f03e04a44..b8a5b085a 100644
--- a/man3type/blkcnt_t.3type
+++ b/man3type/blkcnt_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH BLKCNT_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH BLKCNT_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 blkcnt_t \- file block counts
 .SH LIBRARY
diff --git a/man3type/blksize_t.3type b/man3type/blksize_t.3type
index 7b724287f..e9a70a66d 100644
--- a/man3type/blksize_t.3type
+++ b/man3type/blksize_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH BLKSIZE_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH BLKSIZE_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 blksize_t \- file block sizes
 .SH LIBRARY
diff --git a/man3type/cc_t.3type b/man3type/cc_t.3type
index 5e51b05af..541186ee5 100644
--- a/man3type/cc_t.3type
+++ b/man3type/cc_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH CC_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH CC_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 cc_t \- terminal special characters
 .SH LIBRARY
diff --git a/man3type/clock_t.3type b/man3type/clock_t.3type
index 4cddf561e..145f51423 100644
--- a/man3type/clock_t.3type
+++ b/man3type/clock_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH CLOCK_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH CLOCK_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 clock_t \- system time
 .SH LIBRARY
diff --git a/man3type/clockid_t.3type b/man3type/clockid_t.3type
index 95ca1a56a..1574d7f29 100644
--- a/man3type/clockid_t.3type
+++ b/man3type/clockid_t.3type
@@ -1,4 +1,4 @@
-.TH CLOCKID_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH CLOCKID_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 clockid_t \- clock ID for the clock and timer functions
 .SH LIBRARY
diff --git a/man3type/dev_t.3type b/man3type/dev_t.3type
index 5676b6909..7300fb4fc 100644
--- a/man3type/dev_t.3type
+++ b/man3type/dev_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH DEV_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH DEV_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 dev_t \- device ID
 .SH LIBRARY
diff --git a/man3type/div_t.3type b/man3type/div_t.3type
index fcab0c9aa..716cdc9c2 100644
--- a/man3type/div_t.3type
+++ b/man3type/div_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH DIV_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH DIV_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 div_t, ldiv_t, lldiv_t, imaxdiv_t \-
 quotient and remainder of an integer division
diff --git a/man3type/double_t.3type b/man3type/double_t.3type
index ca37c66cc..7ad482968 100644
--- a/man3type/double_t.3type
+++ b/man3type/double_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH DOUBLE_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH DOUBLE_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 float_t, double_t \- most efficient floating types
 .SH LIBRARY
diff --git a/man3type/epoll_event.3type b/man3type/epoll_event.3type
index 8380f4e7b..2983c1ffb 100644
--- a/man3type/epoll_event.3type
+++ b/man3type/epoll_event.3type
@@ -3,7 +3,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH EPOLL_EVENT 3type 2022-06-19 Linux "Linux Programmer's Manual"
+.TH EPOLL_EVENT 3type 2022-06-19 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 epoll_event, epoll_data, epoll_data_t
 \- epoll event
diff --git a/man3type/fenv_t.3type b/man3type/fenv_t.3type
index aded4bdfb..8441d8cb4 100644
--- a/man3type/fenv_t.3type
+++ b/man3type/fenv_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH FENV_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH FENV_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 fenv_t, fexcept_t \- floating-point environment
 .SH LIBRARY
diff --git a/man3type/id_t.3type b/man3type/id_t.3type
index 3221bdb56..8eee12446 100644
--- a/man3type/id_t.3type
+++ b/man3type/id_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH ID_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH ID_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 pid_t, uid_t, gid_t, id_t \- process/user/group identifier
 .SH LIBRARY
diff --git a/man3type/intN_t.3type b/man3type/intN_t.3type
index 0093135bd..12c6c5cdc 100644
--- a/man3type/intN_t.3type
+++ b/man3type/intN_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH INTN_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH INTN_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 intN_t, int8_t, int16_t, int32_t, int64_t,
 uintN_t, uint8_t, uint16_t, uint32_t, uint64_t
diff --git a/man3type/intmax_t.3type b/man3type/intmax_t.3type
index 76a234f48..1214b8fa2 100644
--- a/man3type/intmax_t.3type
+++ b/man3type/intmax_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH INTMAX_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH INTMAX_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 intmax_t, uintmax_t \- greatest-width basic integer types
 .SH LIBRARY
diff --git a/man3type/intptr_t.3type b/man3type/intptr_t.3type
index fc7646c96..ec529495e 100644
--- a/man3type/intptr_t.3type
+++ b/man3type/intptr_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH INTPTR_T 3type 2022-02-25 Linux "Linux Programmer's Manual"
+.TH INTPTR_T 3type 2022-02-25 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 intptr_t, uintptr_t \- integer types wide enough to hold pointers
 .SH LIBRARY
diff --git a/man3type/iovec.3type b/man3type/iovec.3type
index efd2a601c..340fda29d 100644
--- a/man3type/iovec.3type
+++ b/man3type/iovec.3type
@@ -3,7 +3,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH IOVEC 3type 2022-06-17 Linux "Linux Programmer's Manual"
+.TH IOVEC 3type 2022-06-17 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 iovec \- Vector I/O data structure
 .SH LIBRARY
diff --git a/man3type/itimerspec.3type b/man3type/itimerspec.3type
index 4ae0470cd..1012568af 100644
--- a/man3type/itimerspec.3type
+++ b/man3type/itimerspec.3type
@@ -3,7 +3,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH itimerspec 3type 2022-08-01 Linux "Linux Programmer's Manual"
+.TH itimerspec 3type 2022-08-01 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 timespec \- interval for a timer with nanosecond precision
 .SH LIBRARY
diff --git a/man3type/lconv.3type b/man3type/lconv.3type
index df30dd9d4..ddde7d22a 100644
--- a/man3type/lconv.3type
+++ b/man3type/lconv.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH LCONV 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH LCONV 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 lconv \- numeric formatting information
 .SH LIBRARY
diff --git a/man3type/mode_t.3type b/man3type/mode_t.3type
index a98f9c860..a879e3397 100644
--- a/man3type/mode_t.3type
+++ b/man3type/mode_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH MODE_T 3type 2021-11-02 Linux "Linux Programmer's Manual"
+.TH MODE_T 3type 2021-11-02 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 mode_t \- file attributes
 .SH LIBRARY
diff --git a/man3type/off_t.3type b/man3type/off_t.3type
index 22cefbb96..9cc6ddd58 100644
--- a/man3type/off_t.3type
+++ b/man3type/off_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH OFF_T 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.TH OFF_T 3type 2022-07-20 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 off_t, off64_t, loff_t \- file sizes
 .SH LIBRARY
diff --git a/man3type/ptrdiff_t.3type b/man3type/ptrdiff_t.3type
index 71e3995b5..890e5bad6 100644
--- a/man3type/ptrdiff_t.3type
+++ b/man3type/ptrdiff_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH PTRDIFF_T 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.TH PTRDIFF_T 3type 2022-07-20 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 ptrdiff_t \- count of elements or array index
 .SH LIBRARY
diff --git a/man3type/regex_t.3type b/man3type/regex_t.3type
index 3b2f66204..610c02b7e 100644
--- a/man3type/regex_t.3type
+++ b/man3type/regex_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH regex_t 3type 2022-07-22 Linux "Linux Programmer's Manual"
+.TH regex_t 3type 2022-07-22 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 regex_t, regmatch_t, regoff_t
 \- regular expression matching
diff --git a/man3type/size_t.3type b/man3type/size_t.3type
index c4c123929..cdda30d24 100644
--- a/man3type/size_t.3type
+++ b/man3type/size_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH SIZE_T 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.TH SIZE_T 3type 2022-07-20 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 size_t, ssize_t \- count of bytes
 .SH LIBRARY
diff --git a/man3type/sockaddr.3type b/man3type/sockaddr.3type
index 9367158e1..79251ec69 100644
--- a/man3type/sockaddr.3type
+++ b/man3type/sockaddr.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH SOCKADDR 3type 2022-02-24 Linux "Linux Programmer's Manual"
+.TH SOCKADDR 3type 2022-02-24 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 sockaddr, sockaddr_storage, sockaddr_in, sockaddr_in6, sockaddr_un, socklen_t,
 in_addr, in6_addr, in_addr_t, in_port_t,
diff --git a/man3type/stat.3type b/man3type/stat.3type
index 9e521e584..1d384d9d8 100644
--- a/man3type/stat.3type
+++ b/man3type/stat.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH stat 3type 2022-07-22 Linux "Linux Programmer's Manual"
+.TH stat 3type 2022-07-22 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 stat \- file status
 .SH LIBRARY
diff --git a/man3type/time_t.3type b/man3type/time_t.3type
index 38c9c5cbb..0a60a6a75 100644
--- a/man3type/time_t.3type
+++ b/man3type/time_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH TIME_T 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.TH TIME_T 3type 2022-07-20 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 time_t, suseconds_t, useconds_t \- integer time
 .SH LIBRARY
diff --git a/man3type/timer_t.3type b/man3type/timer_t.3type
index a0aefbdc8..f087635f0 100644
--- a/man3type/timer_t.3type
+++ b/man3type/timer_t.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH timer_t 3type 2022-07-22 Linux "Linux Programmer's Manual"
+.TH timer_t 3type 2022-07-22 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 timer_t \- timer ID
 .SH LIBRARY
diff --git a/man3type/timespec.3type b/man3type/timespec.3type
index 52a55ea1d..fd69d1ce7 100644
--- a/man3type/timespec.3type
+++ b/man3type/timespec.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH TIMESPEC 3type 2022-07-21 Linux "Linux Programmer's Manual"
+.TH TIMESPEC 3type 2022-07-21 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 timespec \- time in seconds and nanoseconds
 .SH LIBRARY
diff --git a/man3type/timeval.3type b/man3type/timeval.3type
index b03f67e4a..cb84fc867 100644
--- a/man3type/timeval.3type
+++ b/man3type/timeval.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH TIMEVAL 3type 2022-07-21 Linux "Linux Programmer's Manual"
+.TH TIMEVAL 3type 2022-07-21 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 timeval \- time in seconds and microseconds
 .SH LIBRARY
diff --git a/man3type/tm.3type b/man3type/tm.3type
index 450bfbfe5..a3effccb7 100644
--- a/man3type/tm.3type
+++ b/man3type/tm.3type
@@ -3,7 +3,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH TM 3type 2022-06-15 Linux "Linux Programmer's Manual"
+.TH TM 3type 2022-06-15 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 tm \- broken-down time
 .SH LIBRARY
diff --git a/man3type/va_list.3type b/man3type/va_list.3type
index 1dfa4bba2..150d27551 100644
--- a/man3type/va_list.3type
+++ b/man3type/va_list.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH VA_LIST 3type 2022-07-21 Linux "Linux Programmer's Manual"
+.TH VA_LIST 3type 2022-07-21 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 va_list \- variable argument list
 .SH LIBRARY
diff --git a/man3type/void.3type b/man3type/void.3type
index 106fd9933..269b628fc 100644
--- a/man3type/void.3type
+++ b/man3type/void.3type
@@ -4,7 +4,7 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\"
-.TH VOID 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.TH VOID 3type 2022-07-20 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
 .SH NAME
 void \- abstract type
 .SH SYNOPSIS