man: Format function references consistently

Always format functions as: .BR func ()

Signed-off-by: Michael Kerrisk <>
diff --git a/man/keyctl.1 b/man/keyctl.1
index 56b29ce..8bacfb2 100644
--- a/man/keyctl.1
+++ b/man/keyctl.1
@@ -137,7 +137,9 @@
 (*) Assumed request_key authorisation key: \fB@a\fR or \fB-7\fR
-This selects the authorisation key provided to the request_key() helper to
+This selects the authorisation key provided to the
+.BR request_key ()
+helper to
 permit it to access the callers keyrings and instantiate the target key.
 (*) Keyring by name: \fB%:<name>\fR
diff --git a/man/keyctl_instantiate.3 b/man/keyctl_instantiate.3
index 7989e22..9041d69 100644
--- a/man/keyctl_instantiate.3
+++ b/man/keyctl_instantiate.3
@@ -49,7 +49,9 @@
 of its keyrings for this to succeed, and that authority must not have been
-The authorising key is allocated by request_key() when it needs to invoke
+The authorising key is allocated by
+.BR request_key()
+when it needs to invoke
 userspace to generate a key for the requesting process.  This is then attached
 to one of the keyrings of the userspace process to which the task of
 instantiating the key is given:
@@ -105,12 +107,16 @@
 specifies the error to be returned when a search hits the key (this is
-Note that keyctl_reject() falls back to keyctl_negate() if the kernel does not
+Note that
+.BR keyctl_reject ()
+falls back to
+.BR keyctl_negate ()
+if the kernel does not
 support it.
 .BR keyctl_negate ()
-.IR keyctl_reject ()
+.BR keyctl_reject ()
 with an error code of
diff --git a/man/keyctl_set_reqkey_keyring.3 b/man/keyctl_set_reqkey_keyring.3
index a83976e..b34cb36 100644
--- a/man/keyctl_set_reqkey_keyring.3
+++ b/man/keyctl_set_reqkey_keyring.3
@@ -24,7 +24,9 @@
 and returns the old setting.
 After this operation has been issued, keys acquired by implicit key requests,
-such as might be performed by open() on an AFS or NFS filesystem, will be
+such as might be performed by
+.BR open ()
+on an AFS or NFS filesystem, will be
 linked by default to the specified keyring by this function.
 The valid values of
diff --git a/man/keyutils.7 b/man/keyutils.7
index b49e21e..39f12a5 100644
--- a/man/keyutils.7
+++ b/man/keyutils.7
@@ -34,11 +34,11 @@
 should be specified to the linker.
 Three system calls are provided:
-.IP \fBadd_key\fP()
+.BR \fBadd_key\fP()
 Supply a new key to the kernel.
-.IP \fBrequest_key\fP()
+.BR \fBrequest_key\fP()
 Find an existing key for use, or, optionally, create one if one does not exist.
-.IP \fBkeyctl\fP()
+.BR \fBkeyctl\fP()
 Control a key in various ways.  The library provides a variety of wrappers
 around this system call and those should be used rather than calling it
diff --git a/man/recursive_key_scan.3 b/man/recursive_key_scan.3
index ed7f440..5e8a58d 100644
--- a/man/recursive_key_scan.3
+++ b/man/recursive_key_scan.3
@@ -45,7 +45,7 @@
 .BR recursive_session_key_scan ()
 works exactly like
-.IR recursive_key_scan ()
+.BR recursive_key_scan ()
 with the caller's session keyring specified as the starting keyring.
 The callback function is called for each link found in all the keyrings in the
@@ -62,12 +62,12 @@
 .BR desc " and " desc_len
 A pointer to the raw description and its length as retrieved with
-.IR keyctl_describe_alloc ().
+.BR keyctl_describe_alloc ().
 These will be NULL and \-1 respectively if the description couldn't be
 retrieved and
 .I errno
 will retain the error from
-.IR keyctl_describe_alloc ().
+.BR keyctl_describe_alloc ().
 .B data
 The data passed to the scanner function.