aboutsummaryrefslogtreecommitdiffstats
path: root/man/man2const
diff options
authorAlejandro Colomar <alx@kernel.org>2025-06-06 13:27:02 +0200
committerAlejandro Colomar <alx@kernel.org>2025-06-28 16:51:43 +0200
commit8eea66b827a11bc8983da517499cc236c6cd97ba (patch)
treeaef545da6666369425609c27752453f9f9cf45d8 /man/man2const
parent6569dd9b22d256f26928ddcc398db9f123546171 (diff)
downloadman-pages-8eea66b827a11bc8983da517499cc236c6cd97ba.tar.gz
man/: SYNOPSIS: Don't highlight forward declarations of function parametersHEADmaster
Previously, many people confused these for actual parameters, since it's hard to distinguish a ',' from ';'. By removing bold/italics from these, it will be easier to distinguish them. The cases have been found with a script: $ find -type f \ | xargs grep -l '^\.TH ' \ | sort \ | xargs mansect SYNOPSIS \ | man /dev/stdin \ | grep -e '^[^ ]' -e '[^ ]( [^ )].*[^)];' \ | less; Reported-by: Mark Naughton <mnaughto@redhat.com> Suggested-by: Mark Harris <mark.hsj@gmail.com> Acked-by: Mark Naughton <mnaughto@redhat.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man2const')
-rw-r--r--man/man2const/KEYCTL_DESCRIBE.2const2
-rw-r--r--man/man2const/KEYCTL_DH_COMPUTE.2const2
-rw-r--r--man/man2const/KEYCTL_GET_SECURITY.2const2
-rw-r--r--man/man2const/KEYCTL_INSTANTIATE.2const4
-rw-r--r--man/man2const/KEYCTL_READ.2const2
-rw-r--r--man/man2const/KEYCTL_UPDATE.2const2
-rw-r--r--man/man2const/PR_GET_AUXV.2const2
7 files changed, 8 insertions, 8 deletions
diff --git a/man/man2const/KEYCTL_DESCRIBE.2const b/man/man2const/KEYCTL_DESCRIBE.2const
index 6522627bf2..8721ab6fb1 100644
--- a/man/man2const/KEYCTL_DESCRIBE.2const
+++ b/man/man2const/KEYCTL_DESCRIBE.2const
@@ -16,7 +16,7 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " size ;
+.BR "long syscall(" "size_t size;"
.BI " SYS_keyctl, KEYCTL_DESCRIBE, key_serial_t " key ,
.BI " char " desc "[_Nullable " size "], size_t " size );
.fi
diff --git a/man/man2const/KEYCTL_DH_COMPUTE.2const b/man/man2const/KEYCTL_DH_COMPUTE.2const
index ea074287e6..2fdbd8161b 100644
--- a/man/man2const/KEYCTL_DH_COMPUTE.2const
+++ b/man/man2const/KEYCTL_DH_COMPUTE.2const
@@ -16,7 +16,7 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " n ;
+.BR "long syscall(" "size_t n;"
.B " SYS_keyctl, KEYCTL_DH_COMPUTE,"
.BI " struct keyctl_dh_params *" dh_params ,
.BI " char " buf [ n "], size_t " n ,
diff --git a/man/man2const/KEYCTL_GET_SECURITY.2const b/man/man2const/KEYCTL_GET_SECURITY.2const
index c53be7ac53..18ceeabe70 100644
--- a/man/man2const/KEYCTL_GET_SECURITY.2const
+++ b/man/man2const/KEYCTL_GET_SECURITY.2const
@@ -16,7 +16,7 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " n ;
+.BR "long syscall(" "size_t n;"
.BI " SYS_keyctl, KEYCTL_GET_SECURITY, key_serial_t " key ,
.BI " char " buf "[_Nullable " n "], size_t " n );
.fi
diff --git a/man/man2const/KEYCTL_INSTANTIATE.2const b/man/man2const/KEYCTL_INSTANTIATE.2const
index cfb15a2918..c53237b9c5 100644
--- a/man/man2const/KEYCTL_INSTANTIATE.2const
+++ b/man/man2const/KEYCTL_INSTANTIATE.2const
@@ -19,11 +19,11 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " n ;
+.BR "long syscall(" "size_t n;"
.BI " SYS_keyctl, KEYCTL_INSTANTIATE, key_serial_t " key ,
.BI " const void " payload [ n "], size_t " n ,
.BI " key_serial_t " keyring );
-.BI "long syscall(size_t " n ;
+.BR "long syscall(" "size_t n;"
.BI " SYS_keyctl, KEYCTL_INSTANTIATE_IOV, key_serial_t " key ,
.BI " const struct iovec " payload [ n "], unsigned int " n ,
.BI " key_serial_t " keyring );
diff --git a/man/man2const/KEYCTL_READ.2const b/man/man2const/KEYCTL_READ.2const
index 9067ec6cb6..46cc26be5d 100644
--- a/man/man2const/KEYCTL_READ.2const
+++ b/man/man2const/KEYCTL_READ.2const
@@ -16,7 +16,7 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " size ;
+.BR "long syscall(" "size_t size;"
.BI " SYS_keyctl, KEYCTL_READ, key_serial_t " key ,
.BI " char " buf "[_Nullable " size "], size_t " size );
.fi
diff --git a/man/man2const/KEYCTL_UPDATE.2const b/man/man2const/KEYCTL_UPDATE.2const
index 46917a5e1d..13f2d05cdb 100644
--- a/man/man2const/KEYCTL_UPDATE.2const
+++ b/man/man2const/KEYCTL_UPDATE.2const
@@ -16,7 +16,7 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(size_t " size ;
+.BR "long syscall(" "size_t size;"
.BI " SYS_keyctl, KEYCTL_UPDATE, key_serial_t " key ,
.BI " void " payload [ size "], size_t " size );
.fi
diff --git a/man/man2const/PR_GET_AUXV.2const b/man/man2const/PR_GET_AUXV.2const
index 2bc8ceee65..b3484220a4 100644
--- a/man/man2const/PR_GET_AUXV.2const
+++ b/man/man2const/PR_GET_AUXV.2const
@@ -15,7 +15,7 @@ Standard C library
.BR "#include <linux/prctl.h>" " /* Definition of " PR_* " constants */"
.B #include <sys/prctl.h>
.P
-.BI "int prctl(size_t " size ;
+.BR "int prctl(" "size_t size;"
.BI " PR_GET_AUXV, void " auxv [ size "], unsigned long " size ", 0L, 0L);"
.fi
.SH DESCRIPTION