Various pages: Add missing commas in SEE ALSO part II

This is a sequel to commit baf17bc4f2a3f3b02d, addressing the
issues with missing commas in the middle of SEE ALSO lists that
emerged since.

The awk script from the original commit was not working and had to
be slightly modified (s/["]SEE ALSO["]/"?SEE ALSO/), otherwise it
works like a charm. Here's the fixed script and its output just
before this commit:

for f in man*/*; do
awk '
    /^.SH "?SEE ALSO/ {
	sa=1; print "== " FILENAME " =="; print; next
    }
    /^\.(PP|SH)/ {
	sa=0; no=0; next
    }
    /^\.BR/ {
	if (sa==1) {
	    print;
	    if (no == 1)
		print "Missing comma in " FILENAME " +" FNR-1; no=0
	}
    }
    /^\.BR .*)$/ {
	if (sa==1)
	    no=1;
	next
    }
    /\.\\"/ {next}
    /.*/ {
	if (sa==1) {
	    print; next
	}
    }
' $f; done | grep Missing
Missing comma in man1/memusage.1 +272
Missing comma in man2/adjtimex.2 +597
Missing comma in man2/adjtimex.2 +598
Missing comma in man2/mkdir.2 +252
Missing comma in man2/sigaction.2 +1045
Missing comma in man2/sigaction.2 +1047
Missing comma in man3/mbsnrtowcs.3 +198
Missing comma in man3/ntp_gettime.3 +142
Missing comma in man3/strcmp.3 +219
Missing comma in man3/strtol.3 +302
Missing comma in man3/wcstombs.3 +120
Missing comma in man7/user_namespaces.7 +1378
Missing comma in man7/xattr.7 +198

Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man1/memusage.1 b/man1/memusage.1
index 9cc06838b9de15c3e5b7e7791f009302f5967053..aa5739eb029ef8da88fba00d422fedea0d297d7c 100644 (file)
--- a/man1/memusage.1
+++ b/man1/memusage.1
@@ -269,5 +269,5 @@ main(int argc, char *argv[])
 .EE
 .SH SEE ALSO
 .BR memusagestat (1),
-.BR mtrace (1)
+.BR mtrace (1),
 .BR ld.so (8)

diff --git a/man2/adjtimex.2 b/man2/adjtimex.2
index 1722369a117d0db6106f0c64babcd798a19c1b90..d802d52f9fa3b12161a4f0bbca889657cdf19493 100644 (file)
--- a/man2/adjtimex.2
+++ b/man2/adjtimex.2
@@ -594,8 +594,8 @@ is done by the kernel in timer context.
 Thus, it will take one tick into the second
 for the leap second to be inserted or deleted.
 .SH SEE ALSO
-.BR clock_gettime (2)
-.BR clock_settime (2)
+.BR clock_gettime (2),
+.BR clock_settime (2),
 .BR settimeofday (2),
 .BR adjtime (3),
 .BR ntp_gettime (3),

diff --git a/man2/mkdir.2 b/man2/mkdir.2
index 12b1312704de16bbf276d1237392b4eee48873d0..959169cade8c53d726f9d0555bf379154ff82b6a 100644 (file)
--- a/man2/mkdir.2
+++ b/man2/mkdir.2
@@ -249,5 +249,5 @@ argument.
 .BR stat (2),
 .BR umask (2),
 .BR unlink (2),
-.BR acl (5)
+.BR acl (5),
 .BR path_resolution (7)

diff --git a/man2/sigaction.2 b/man2/sigaction.2
index b4e63087866fb4297c3b04bd56774204410c0f9d..744cdfcc47edbf75d5126cb77422219fd6b9abaf 100644 (file)
--- a/man2/sigaction.2
+++ b/man2/sigaction.2
@@ -1042,9 +1042,9 @@ See
 .BR kill (1),
 .BR kill (2),
 .BR pause (2),
-.BR pidfd_send_signal (2)
+.BR pidfd_send_signal (2),
 .BR restart_syscall (2),
-.BR seccomp (2)
+.BR seccomp (2),
 .BR sigaltstack (2),
 .BR signal (2),
 .BR signalfd (2),

diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3
index 2e5420305aecec762680ede15523da25a79f410e..2e447bac8edd03cca64fc0ccdf234ae8f146530a 100644 (file)
--- a/man3/mbsnrtowcs.3
+++ b/man3/mbsnrtowcs.3
@@ -195,6 +195,6 @@ Passing NULL as
 is not multithread safe.
 .SH SEE ALSO
 .BR iconv (3),
-.BR mbrtowc (3)
+.BR mbrtowc (3),
 .BR mbsinit (3),
 .BR mbsrtowcs (3)

diff --git a/man3/ntp_gettime.3 b/man3/ntp_gettime.3
index ff54a1ee0ce04453c96f834a9b6fe6d235fcfdce..be80b480111c6026f9793f0fa5e8b7736076d2bd 100644 (file)
--- a/man3/ntp_gettime.3
+++ b/man3/ntp_gettime.3
@@ -139,7 +139,7 @@ is described in the NTP Kernel Application Program Interface.
 .BR ntp_gettimex ()
 is a GNU extension.
 .SH SEE ALSO
-.BR adjtimex (2)
+.BR adjtimex (2),
 .BR ntp_adjtime (3),
 .BR time (7)
 .PP

diff --git a/man3/strcmp.3 b/man3/strcmp.3
index dd187be223d31e0e908061ab2870ee5c86e6cbb5..f1046f2e312737003b6126f7e814607ae0be412a 100644 (file)
--- a/man3/strcmp.3
+++ b/man3/strcmp.3
@@ -216,5 +216,5 @@ main(int argc, char *argv[])
 .BR strncasecmp (3),
 .BR strverscmp (3),
 .BR wcscmp (3),
-.BR wcsncmp (3)
+.BR wcsncmp (3),
 .BR ascii (7)

diff --git a/man3/strtol.3 b/man3/strtol.3
index 960f61b3eb80fc182315fd72af0d2cc57892b6d0..02598b9832faaf6a6670e7cb586919ed6690883d 100644 (file)
--- a/man3/strtol.3
+++ b/man3/strtol.3
@@ -299,5 +299,5 @@ main(int argc, char *argv[])
 .BR atoi (3),
 .BR atol (3),
 .BR strtod (3),
-.BR strtoimax (3)
+.BR strtoimax (3),
 .BR strtoul (3),

diff --git a/man3/wcstombs.3 b/man3/wcstombs.3
index 8b3ca7d6f41ec7a5711f0a2e6b89fe2841adb9ee..749cc7b26d6b0217dfc5ca0f60460d5defff920d 100644 (file)
--- a/man3/wcstombs.3
+++ b/man3/wcstombs.3
@@ -117,5 +117,5 @@ provides a better interface to the same functionality.
 .BR mblen (3),
 .BR mbstowcs (3),
 .BR mbtowc (3),
-.BR wcsrtombs (3)
+.BR wcsrtombs (3),
 .BR wctomb (3)

diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7
index 0f2c89184948f4b210c21099d00b64b657733625..1975daf5e2afd075ed731e7e499063f2ef8e8334 100644 (file)
--- a/man7/user_namespaces.7
+++ b/man7/user_namespaces.7
@@ -1375,7 +1375,7 @@ main(int argc, char *argv[])
 .BR subgid (5),         \" From the shadow package
 .BR subuid (5),         \" From the shadow package
 .BR capabilities (7),
-.BR cgroup_namespaces (7)
+.BR cgroup_namespaces (7),
 .BR credentials (7),
 .BR namespaces (7),
 .BR pid_namespaces (7)

diff --git a/man7/xattr.7 b/man7/xattr.7
index 706dfa3442eb46b2206d3ba19d83eeb92f0bdd4b..23a928c1bda8e014c1927693c622eaff65c9fcbf 100644 (file)
--- a/man7/xattr.7
+++ b/man7/xattr.7
@@ -195,5 +195,5 @@ This page was formerly named
 .BR removexattr (2),
 .BR setxattr (2),
 .BR acl (5),
-.BR capabilities (7)
+.BR capabilities (7),
 .BR selinux (8)