diff options
author | Alejandro Colomar <alx@kernel.org> | 2022-10-30 18:59:09 +0100 |
---|---|---|
committer | Alejandro Colomar <alx@kernel.org> | 2022-10-30 23:50:30 +0100 |
commit | 4c1c52748a06141996fccbf23fb8d9e15cba11e8 (patch) | |
tree | db53f9fd936fcbe72e41f7b2414f60689f25e045 /man3type | |
parent | bd14f1e3236a1f016b7a8a85deb34379c4470687 (diff) |
Many pages: Use correct letter case in page titles (TH)
Scripted change:
$ find man* -type f \
| xargs grep -L '\.so' \
| while read f; do
P=$(basename $f);
T=$(grep '\.TH ' $f | cut -f2,3 -d' ' | sed 's/ /./');
p=$(echo $P | tr '[:upper:]' '[:lower:]');
t=$(echo $T | tr '[:upper:]' '[:lower:]');
Tn=$(echo $T | sed 's/\.[^.]\+$//')
Pn=$(echo $P | sed 's/\.[^.]\+$//')
N=$(man_section $f NAME \
| sed -n '/NAME/,/ - /p' \
| sed 's/ - .*//' \
| grep -v '^NAME$' \
| tr ', ' '\n' \
| grep -i "^$Pn$" \
| head -n1)
test $P = $T \
&& test -n $N \
&& continue;
if test "x$p" != "x$t"; then
echo 1 $P $T $N;
elif test -z "$N"; then
echo 2 $P $T $N;
else
sed -i "/\.TH /s/$Tn/$N/" $f;
fi;
done;
On 10/30/22 23:00, G. Branden Robinson wrote:
> For those to whom this change is coming as an unpleasant surprise, the
> forthcoming groff 1.23.0 features an option that will reverse this
> change at rendering time.
>
> From groff_man(7):
>
> -rCT=1 Capitalize titles, setting the man page title (the first
> argument to .TH) in full capitals in headers and footers.
> This transformation is off by default because it discards
> case distinction information.
>
> This register can also be set in a site-local "man.local" file to force
> it on for all pages. On Debian-based systems, this file is in
> /etc/groff. The following line will do the trick.
>
> .nr CT 1
>
> The groff_man_style(7) man page offers further examples of such
> rendering customization.
>
> /usr/local/share/groff/site-tmac/man.local
> Put site‐local changes and customizations into this file.
>
> .\" Use narrower indentation on terminals and similar.
> .if n .nr IN 4n
> .\" Put only one space after the end of a sentence.
> .ss 12 0 \" See groff(7).
> .\" Keep pages narrow even on wide terminals.
> .if n .if \n[LL]>78n .nr LL 78n
> .\" Ensure hyperlinks are enabled for terminals.
> .nr U 1
>
> On multi‐user systems, it is more considerate to users whose
> preferences may differ from the administrator’s to be less
> aggressive with such settings, or to permit their override
> with a user‐specific man.local file. This can be achieved by
> placing one or both of following requests at the end of the
> site‐local file.
> .soquiet \V[XDG_CONFIG_HOME]/man.local
> .soquiet \V[HOME]/.man.local
> However, a security‐sandboxed man(1) program may lack
> permission to open such files.
Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man3type')
-rw-r--r-- | man3type/aiocb.3type | 2 | ||||
-rw-r--r-- | man3type/blkcnt_t.3type | 2 | ||||
-rw-r--r-- | man3type/blksize_t.3type | 2 | ||||
-rw-r--r-- | man3type/cc_t.3type | 2 | ||||
-rw-r--r-- | man3type/clock_t.3type | 2 | ||||
-rw-r--r-- | man3type/clockid_t.3type | 2 | ||||
-rw-r--r-- | man3type/dev_t.3type | 2 | ||||
-rw-r--r-- | man3type/div_t.3type | 2 | ||||
-rw-r--r-- | man3type/double_t.3type | 2 | ||||
-rw-r--r-- | man3type/epoll_event.3type | 2 | ||||
-rw-r--r-- | man3type/fenv_t.3type | 2 | ||||
-rw-r--r-- | man3type/id_t.3type | 2 | ||||
-rw-r--r-- | man3type/intN_t.3type | 2 | ||||
-rw-r--r-- | man3type/intmax_t.3type | 2 | ||||
-rw-r--r-- | man3type/intptr_t.3type | 2 | ||||
-rw-r--r-- | man3type/iovec.3type | 2 | ||||
-rw-r--r-- | man3type/lconv.3type | 2 | ||||
-rw-r--r-- | man3type/mode_t.3type | 2 | ||||
-rw-r--r-- | man3type/off_t.3type | 2 | ||||
-rw-r--r-- | man3type/ptrdiff_t.3type | 2 | ||||
-rw-r--r-- | man3type/size_t.3type | 2 | ||||
-rw-r--r-- | man3type/sockaddr.3type | 2 | ||||
-rw-r--r-- | man3type/time_t.3type | 2 | ||||
-rw-r--r-- | man3type/timespec.3type | 2 | ||||
-rw-r--r-- | man3type/timeval.3type | 2 | ||||
-rw-r--r-- | man3type/tm.3type | 2 | ||||
-rw-r--r-- | man3type/va_list.3type | 2 | ||||
-rw-r--r-- | man3type/void.3type | 2 |
28 files changed, 28 insertions, 28 deletions
diff --git a/man3type/aiocb.3type b/man3type/aiocb.3type index 7b4730d0b..7bfe97162 100644 --- a/man3type/aiocb.3type +++ b/man3type/aiocb.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH AIOCB 3type (date) "Linux man-pages (unreleased)" +.TH aiocb 3type (date) "Linux man-pages (unreleased)" .SH NAME aiocb \- asynchronous I/O control block .SH LIBRARY diff --git a/man3type/blkcnt_t.3type b/man3type/blkcnt_t.3type index 5a20eeac8..c9bb2ed40 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 (date) "Linux man-pages (unreleased)" +.TH blkcnt_t 3type (date) "Linux man-pages (unreleased)" .SH NAME blkcnt_t \- file block counts .SH LIBRARY diff --git a/man3type/blksize_t.3type b/man3type/blksize_t.3type index 4032ce195..0b1c82bcd 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 (date) "Linux man-pages (unreleased)" +.TH blksize_t 3type (date) "Linux man-pages (unreleased)" .SH NAME blksize_t \- file block sizes .SH LIBRARY diff --git a/man3type/cc_t.3type b/man3type/cc_t.3type index 8908b4d41..ef0d44107 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 (date) "Linux man-pages (unreleased)" +.TH cc_t 3type (date) "Linux man-pages (unreleased)" .SH NAME cc_t, speed_t, tcflag_t \- terminal special characters, baud rates, modes .SH LIBRARY diff --git a/man3type/clock_t.3type b/man3type/clock_t.3type index 6676bc56d..b3fdf0346 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 (date) "Linux man-pages (unreleased)" +.TH clock_t 3type (date) "Linux man-pages (unreleased)" .SH NAME clock_t \- system time .SH LIBRARY diff --git a/man3type/clockid_t.3type b/man3type/clockid_t.3type index c5a3b5f11..092a07c15 100644 --- a/man3type/clockid_t.3type +++ b/man3type/clockid_t.3type @@ -1,4 +1,4 @@ -.TH CLOCKID_T 3type (date) "Linux man-pages (unreleased)" +.TH clockid_t 3type (date) "Linux man-pages (unreleased)" .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 62ca80bc9..898886b84 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 (date) "Linux man-pages (unreleased)" +.TH dev_t 3type (date) "Linux man-pages (unreleased)" .SH NAME dev_t \- device ID .SH LIBRARY diff --git a/man3type/div_t.3type b/man3type/div_t.3type index 7e50cf21e..fa4330709 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 (date) "Linux man-pages (unreleased)" +.TH div_t 3type (date) "Linux man-pages (unreleased)" .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 a3b07701f..1ece47c89 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 (date) "Linux man-pages (unreleased)" +.TH double_t 3type (date) "Linux man-pages (unreleased)" .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 40b324873..4e4d34284 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 (date) "Linux man-pages (unreleased)" +.TH epoll_event 3type (date) "Linux man-pages (unreleased)" .SH NAME epoll_event, epoll_data, epoll_data_t \- epoll event diff --git a/man3type/fenv_t.3type b/man3type/fenv_t.3type index 38919dd88..086f1d977 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 (date) "Linux man-pages (unreleased)" +.TH fenv_t 3type (date) "Linux man-pages (unreleased)" .SH NAME fenv_t, fexcept_t \- floating-point environment .SH LIBRARY diff --git a/man3type/id_t.3type b/man3type/id_t.3type index db8801345..d6bc97b6f 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 (date) "Linux man-pages (unreleased)" +.TH id_t 3type (date) "Linux man-pages (unreleased)" .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 6c5bc18eb..ca30516ef 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 (date) "Linux man-pages (unreleased)" +.TH intN_t 3type (date) "Linux man-pages (unreleased)" .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 e44c34df1..8c2f9ff0f 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 (date) "Linux man-pages (unreleased)" +.TH intmax_t 3type (date) "Linux man-pages (unreleased)" .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 4be2a1a88..9b614fac6 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 (date) "Linux man-pages (unreleased)" +.TH intptr_t 3type (date) "Linux man-pages (unreleased)" .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 13d6406d8..5f3a7e3ef 100644 --- a/man3type/iovec.3type +++ b/man3type/iovec.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH IOVEC 3type (date) "Linux man-pages (unreleased)" +.TH iovec 3type (date) "Linux man-pages (unreleased)" .SH NAME iovec \- Vector I/O data structure .SH LIBRARY diff --git a/man3type/lconv.3type b/man3type/lconv.3type index 8d6e029f9..d96ec91a1 100644 --- a/man3type/lconv.3type +++ b/man3type/lconv.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH LCONV 3type (date) "Linux man-pages (unreleased)" +.TH lconv 3type (date) "Linux man-pages (unreleased)" .SH NAME lconv \- numeric formatting information .SH LIBRARY diff --git a/man3type/mode_t.3type b/man3type/mode_t.3type index ebd557a72..2ea1784cc 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 (date) "Linux man-pages (unreleased)" +.TH mode_t 3type (date) "Linux man-pages (unreleased)" .SH NAME mode_t \- file attributes .SH LIBRARY diff --git a/man3type/off_t.3type b/man3type/off_t.3type index f0256c157..1e8734fa6 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 (date) "Linux man-pages (unreleased)" +.TH off_t 3type (date) "Linux man-pages (unreleased)" .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 ef8fd0286..a4d41e5e7 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 (date) "Linux man-pages (unreleased)" +.TH ptrdiff_t 3type (date) "Linux man-pages (unreleased)" .SH NAME ptrdiff_t \- count of elements or array index .SH LIBRARY diff --git a/man3type/size_t.3type b/man3type/size_t.3type index 07f776f59..ba02993a2 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 (date) "Linux man-pages (unreleased)" +.TH size_t 3type (date) "Linux man-pages (unreleased)" .SH NAME size_t, ssize_t \- count of bytes .SH LIBRARY diff --git a/man3type/sockaddr.3type b/man3type/sockaddr.3type index 0f0f34165..319a5e552 100644 --- a/man3type/sockaddr.3type +++ b/man3type/sockaddr.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH SOCKADDR 3type (date) "Linux man-pages (unreleased)" +.TH sockaddr 3type (date) "Linux man-pages (unreleased)" .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/time_t.3type b/man3type/time_t.3type index df7d91df1..0808236c9 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 (date) "Linux man-pages (unreleased)" +.TH time_t 3type (date) "Linux man-pages (unreleased)" .SH NAME time_t, suseconds_t, useconds_t \- integer time .SH LIBRARY diff --git a/man3type/timespec.3type b/man3type/timespec.3type index 1509ee8a2..fdddcc778 100644 --- a/man3type/timespec.3type +++ b/man3type/timespec.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH TIMESPEC 3type (date) "Linux man-pages (unreleased)" +.TH timespec 3type (date) "Linux man-pages (unreleased)" .SH NAME timespec \- time in seconds and nanoseconds .SH LIBRARY diff --git a/man3type/timeval.3type b/man3type/timeval.3type index cfb71bcd3..36a7a4820 100644 --- a/man3type/timeval.3type +++ b/man3type/timeval.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH TIMEVAL 3type (date) "Linux man-pages (unreleased)" +.TH timeval 3type (date) "Linux man-pages (unreleased)" .SH NAME timeval \- time in seconds and microseconds .SH LIBRARY diff --git a/man3type/tm.3type b/man3type/tm.3type index 15c373a58..6df7f78a0 100644 --- a/man3type/tm.3type +++ b/man3type/tm.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH TM 3type (date) "Linux man-pages (unreleased)" +.TH tm 3type (date) "Linux man-pages (unreleased)" .SH NAME tm \- broken-down time .SH LIBRARY diff --git a/man3type/va_list.3type b/man3type/va_list.3type index fe785e34d..004860d5c 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 (date) "Linux man-pages (unreleased)" +.TH va_list 3type (date) "Linux man-pages (unreleased)" .SH NAME va_list \- variable argument list .SH LIBRARY diff --git a/man3type/void.3type b/man3type/void.3type index 567e7653f..ddcbf482f 100644 --- a/man3type/void.3type +++ b/man3type/void.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH VOID 3type (date) "Linux man-pages (unreleased)" +.TH void 3type (date) "Linux man-pages (unreleased)" .SH NAME void \- abstract type .SH SYNOPSIS |