Skip to contentSkip to conversation

Several fixes and improvements to the manual pages

PATCH In review Alejandro Colomar 1 participant 12 messages Jun 19, 2024 – Jul 10, 2024

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

cover Several fixes and improvements to the manual pages

Hi David,

Here's a set of fixes and improvements to the manual pages. I'm preparing a lot more, but I'll send these already to taste the waters.

Have a lovely day!
Alex

*** BLURB HERE ***

Alejandro Colomar (10):
man/asymmetric-key.7: Use HISTORY instead of VERSIONS
man: Use the LIBRARY section
man: Fix TH arguments 4 and 5
man: Update date in TH
man: Use lowercase in TH 1st argument
man: Escape dashes in TH
man: Add SYNOPSYS section
man: Improve formatting of SYNOPSIS of commands man/keyctl.1: Improve formatting
man: Organize manual pages in subdirectories

 Makefile                                     |  10 +-
 man/{ => man1}/keyctl.1                      | 432 ++++++++++++++-----
 man/{ => man3}/find_key_by_type_and_name.3   |  11 +-
 man/{ => man3}/keyctl.3                      |  25 +-
 man/{ => man3}/keyctl_capabilities.3         |  13 +-
 man/{ => man3}/keyctl_chown.3                |  13 +-
 man/{ => man3}/keyctl_clear.3                |  13 +-
 man/{ => man3}/keyctl_describe.3             |  13 +-
 man/{ => man3}/keyctl_dh_compute.3           |  13 +-
 man/{ => man3}/keyctl_get_keyring_ID.3       |  13 +-
 man/{ => man3}/keyctl_get_persistent.3       |  13 +-
 man/{ => man3}/keyctl_get_security.3         |  13 +-
 man/{ => man3}/keyctl_instantiate.3          |  13 +-
 man/{ => man3}/keyctl_invalidate.3           |  13 +-
 man/{ => man3}/keyctl_join_session_keyring.3 |  13 +-
 man/{ => man3}/keyctl_link.3                 |  13 +-
 man/{ => man3}/keyctl_move.3                 |  13 +-
 man/{ => man3}/keyctl_pkey_decrypt.3         |   0
 man/{ => man3}/keyctl_pkey_encrypt.3         |  13 +-
 man/{ => man3}/keyctl_pkey_query.3           |  13 +-
 man/{ => man3}/keyctl_pkey_sign.3            |  13 +-
 man/{ => man3}/keyctl_pkey_verify.3          |   0
 man/{ => man3}/keyctl_read.3                 |  13 +-
 man/{ => man3}/keyctl_restrict_keyring.3     |  13 +-
 man/{ => man3}/keyctl_revoke.3               |  13 +-
 man/{ => man3}/keyctl_search.3               |  15 +-
 man/{ => man3}/keyctl_session_to_parent.3    |  13 +-
 man/{ => man3}/keyctl_set_reqkey_keyring.3   |  13 +-
 man/{ => man3}/keyctl_set_timeout.3          |  13 +-
 man/{ => man3}/keyctl_setperm.3              |  13 +-
 man/{ => man3}/keyctl_update.3               |  13 +-
 man/{ => man3}/keyctl_watch_key.3            |  13 +-
 man/{ => man3}/recursive_key_scan.3          |  11 +-
 man/{ => man5}/key.dns_resolver.conf.5       |   2 +-
 man/{ => man5}/request-key.conf.5            |   2 +-
 man/{ => man7}/asymmetric-key.7              |   4 +-
 man/{ => man7}/keyutils.7                    |  26 +-
 man/{ => man8}/key.dns_resolver.8            |   2 +-
 man/{ => man8}/request-key.8                 |  14 +-
 39 files changed, 498 insertions(+), 381 deletions(-)
 rename man/{ => man1}/keyctl.1 (89%)
 rename man/{ => man3}/find_key_by_type_and_name.3 (92%)
 rename man/{ => man3}/keyctl.3 (89%)
 rename man/{ => man3}/keyctl_capabilities.3 (94%)
 rename man/{ => man3}/keyctl_chown.3 (91%)
 rename man/{ => man3}/keyctl_clear.3 (89%)
 rename man/{ => man3}/keyctl_describe.3 (93%)
 rename man/{ => man3}/keyctl_dh_compute.3 (95%)
 rename man/{ => man3}/keyctl_get_keyring_ID.3 (92%)
 rename man/{ => man3}/keyctl_get_persistent.3 (93%)
 rename man/{ => man3}/keyctl_get_security.3 (93%)
 rename man/{ => man3}/keyctl_instantiate.3 (96%)
 rename man/{ => man3}/keyctl_invalidate.3 (90%)
 rename man/{ => man3}/keyctl_join_session_keyring.3 (91%)
 rename man/{ => man3}/keyctl_link.3 (92%)
 rename man/{ => man3}/keyctl_move.3 (92%)
 rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%)
 rename man/{ => man3}/keyctl_pkey_encrypt.3 (94%)
 rename man/{ => man3}/keyctl_pkey_query.3 (94%)
 rename man/{ => man3}/keyctl_pkey_sign.3 (95%)
 rename man/{ => man3}/keyctl_pkey_verify.3 (100%)
 rename man/{ => man3}/keyctl_read.3 (94%)
 rename man/{ => man3}/keyctl_restrict_keyring.3 (91%)
 rename man/{ => man3}/keyctl_revoke.3 (89%)
 rename man/{ => man3}/keyctl_search.3 (93%)
 rename man/{ => man3}/keyctl_session_to_parent.3 (91%)
 rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (93%)
 rename man/{ => man3}/keyctl_set_timeout.3 (90%)
 rename man/{ => man3}/keyctl_setperm.3 (94%)
 rename man/{ => man3}/keyctl_update.3 (91%)
 rename man/{ => man3}/keyctl_watch_key.3 (95%)
 rename man/{ => man3}/recursive_key_scan.3 (95%)
 rename man/{ => man5}/key.dns_resolver.conf.5 (95%)
 rename man/{ => man5}/request-key.conf.5 (98%)
 rename man/{ => man7}/asymmetric-key.7 (99%)
 rename man/{ => man7}/keyutils.7 (89%)
 rename man/{ => man8}/key.dns_resolver.8 (95%)
 rename man/{ => man8}/request-key.8 (92%)

Range-diff against v0:

 -:  ------- >  1:  ec0c2fa man/asymmetric-key.7: Use HISTORY instead of VERSIONS
 -:  ------- >  2:  8f02c27 man: Use the LIBRARY section
 -:  ------- >  3:  e3e616f man: Fix TH arguments 4 and 5
 -:  ------- >  4:  7762f59 man: Update date in TH
 -:  ------- >  5:  7294951 man: Use lowercase in TH 1st argument
 -:  ------- >  6:  3d6ef97 man: Escape dashes in TH
 -:  ------- >  7:  5794916 man: Add SYNOPSYS section
 -:  ------- >  8:  30c25a7 man: Improve formatting of SYNOPSIS of commands
 -:  ------- >  9:  ae1e052 man/keyctl.1: Improve formatting
 -:  ------- > 10:  93e44ce man: Organize manual pages in subdirectories
Signature · 1 line
2.45.2
#1 lore raw

PATCH 1/10 man/asymmetric-key.7: Use HISTORY instead of VERSIONS

The VERSIONS section is usually used to describe differences in different systems, focusing on portability to other current systems.

The HISTORY section is used to describe the history of an API, such as when it appeared, or when it was standardized, focusing on portability to older versions of the same system.

---
 man/asymmetric-key.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/asymmetric-key.7 +1 -1
index 5fc78cb..82193f6 100644
@@ -211,7 +211,7 @@ .SH BLACKLISTING
 that blacklisting is not retroactive, so an asymmetric key that is already on
 the system cannot be blacklisted by adding a matching blacklist entry later.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH VERSIONS
+.SH HISTORY
 The
 .B asymmetric
 key type first appeared in v3.7 of the Linux kernel, the
Signature · 1 line
2.45.2
#2 lore raw

PATCH 2/10 man: Use the LIBRARY section

In reply to Alejandro Colomar

This is the de-facto standard way of documenting the library that provides a function, and the linker option to link to it.

This LIBRARY section is used (at least) by FreeBSD and the Linux man-pages project.

---
 man/find_key_by_type_and_name.3   |  9 ++++-----
 man/keyctl.3                      | 11 ++++-------
 man/keyctl_capabilities.3         | 11 ++++-------
 man/keyctl_chown.3                | 11 ++++-------
 man/keyctl_clear.3                | 11 ++++-------
 man/keyctl_describe.3             | 11 ++++-------
 man/keyctl_dh_compute.3           | 11 ++++-------
 man/keyctl_get_keyring_ID.3       | 11 ++++-------
 man/keyctl_get_persistent.3       | 11 ++++-------
 man/keyctl_get_security.3         | 11 ++++-------
 man/keyctl_instantiate.3          | 11 ++++-------
 man/keyctl_invalidate.3           | 11 ++++-------
 man/keyctl_join_session_keyring.3 | 11 ++++-------
 man/keyctl_link.3                 | 11 ++++-------
 man/keyctl_move.3                 | 11 ++++-------
 man/keyctl_pkey_encrypt.3         | 11 ++++-------
 man/keyctl_pkey_query.3           | 11 ++++-------
 man/keyctl_pkey_sign.3            | 11 ++++-------
 man/keyctl_read.3                 | 11 ++++-------
 man/keyctl_restrict_keyring.3     | 11 ++++-------
 man/keyctl_revoke.3               | 11 ++++-------
 man/keyctl_search.3               | 13 ++++---------
 man/keyctl_session_to_parent.3    | 11 ++++-------
 man/keyctl_set_reqkey_keyring.3   | 11 ++++-------
 man/keyctl_set_timeout.3          | 11 ++++-------
 man/keyctl_setperm.3              | 11 ++++-------
 man/keyctl_update.3               | 11 ++++-------
 man/keyctl_watch_key.3            | 11 ++++-------
 man/keyutils.7                    | 12 ++++--------
 man/recursive_key_scan.3          |  9 ++++-----
 30 files changed, 120 insertions(+), 209 deletions(-)
man/find_key_by_type_and_name.3 +4 -5
index 2fbd21e..c961ece 100644
@@ -12,6 +12,10 @@
 .SH NAME
 find_key_by_type_and_name \- find a key by type and name
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -52,11 +56,6 @@ .SH ERRORS
 .B writable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl.3 +4 -7
index fda0363..708fcbe 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_*() \- key management function wrappers
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH DESCRIPTION
 The
 .BR keyctl ()
@@ -24,13 +28,6 @@ .SH DESCRIPTION
 .nf
 .B #include <keyutils.h>
 .RE
-.P
-and then telling the linker it should link in the library:
-.sp
-.RS
-.nf
-.B \-lkeyutils
-.RE
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH KEYCTL FUNCTIONS
 .BR keyctl_assume_authority (3)
man/keyctl_capabilities.3 +4 -7
index f816df6..86ec352 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_capabilities \- Query subsystem capabilities
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -104,13 +108,6 @@ .SH ERRORS
 .B EFAULT
 The buffer cannot be written to.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_chown.3 +4 -7
index f85840a..2006af4 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_chown \- change the ownership of a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -69,13 +73,6 @@ .SH ERRORS
 .B setattr
 permission to the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_clear.3 +4 -7
index 8da699e..34e7262 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_clear \- clear a keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -54,13 +58,6 @@ .SH ERRORS
 .B writable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_describe.3 +4 -7
index b4f100e..97d454b 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_describe \- describe a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS
 .B viewable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_dh_compute.3 +4 -7
index 5b79378..befb83d 100644
@@ -14,6 +14,10 @@ .SH NAME
 .br
 keyctl_dh_compute_kdf \- Derive key from a Diffie-Hellman shared secret
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -151,13 +155,6 @@ .SH ERRORS
 .I buflen
 is too big.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .BR keyctl (1),
 .br
man/keyctl_get_keyring_ID.3 +4 -7
index 6525292..4c2ca5c 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_get_keyring_ID \- get the ID of a special keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -77,13 +81,6 @@ .SH ERRORS
 The key quota for this user would be exceeded by creating this key or linking
 it to the keyring.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_get_persistent.3 +4 -7
index 8d79957..d878cbb 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_get_persistent \- get the persistent keyring for a user
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS
 .B write
 permission to the calling process.
 
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
man/keyctl_get_security.3 +4 -7
index a2c5b41..7113e2f 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_get_security \- retrieve a key's security context
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -83,13 +87,6 @@ .SH ERRORS
 .B viewable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_instantiate.3 +4 -7
index d436bf2..0d3b459 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -171,13 +175,6 @@ .SH ERRORS
 .B writable
 by the requester.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_invalidate.3 +4 -7
index 120da45..928319f 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_invalidate \- invalidate a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -57,13 +61,6 @@ .SH ERRORS
 .B searchable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_join_session_keyring.3 +4 -7
index 4e27717..b8ed639 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_join_session_keyring \- join a different session keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -63,13 +67,6 @@ .SH ERRORS
 .B searchable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_link.3 +4 -7
index 2cbc104..9046121 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -88,13 +92,6 @@ .SH ERRORS
 .B linkable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_move.3 +4 -7
index 6f144df..a8f0c7f 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_move \- Move a key between keyrings
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -89,13 +93,6 @@ .SH ERRORS
 .B EDQUOT
 Expanding to_keyring would exceed the keyring owner's quota.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_pkey_encrypt.3 +4 -7
index 5a5b71b..b199a05 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS
 .B EFAULT
 Bad address.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_pkey_query.3 +4 -7
index e70665f..e7613c8 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_pkey_query \- Query public key parameters
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -116,13 +120,6 @@ .SH ERRORS
 .B EFAULT
 Bad address.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_pkey_sign.3 +4 -7
index 4fb6a14..2f0b106 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -114,13 +118,6 @@ .SH ERRORS
 .B EFAULT
 Bad address.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_read.3 +4 -7
index 97b0e24..6728b5b 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_read \- read a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -92,13 +96,6 @@ .SH ERRORS
 .B EOPNOTSUPP
 The key type does not support reading of the payload data.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_restrict_keyring.3 +4 -7
index 468d5b4..9e4d023 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -66,13 +70,6 @@ .SH ERRORS
 .B ENOENT
 The key type exists but does not support restrictions.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_revoke.3 +4 -7
index 622f1ac..a973d39 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_revoke \- revoke a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -54,13 +58,6 @@ .SH ERRORS
 .B writable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_search.3 +4 -9
index f3e7bc5..f7db46d 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_search \- search a keyring for a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -117,15 +121,6 @@ .SH ERRORS
 .B link
 permission to the caller.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-Although this is a Linux system call, it is not present in
-.I libc
-but can be found rather in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_session_to_parent.3 +4 -7
index 829b3be..b05c030 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_session_to_parent \- set the parent process's session keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -56,13 +60,6 @@ .SH ERRORS
 .B linkable
 by the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_set_reqkey_keyring.3 +4 -7
index 6e6725e..e8d6afa 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_set_reqkey_keyring \- set the implicit destination keyring
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -81,13 +85,6 @@ .SH ERRORS
 .I reqkey_defl
 is invalid.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_set_timeout.3 +4 -7
index 24c7049..ec8b364 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_set_timeout \- set the expiration timer on a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -62,13 +66,6 @@ .SH ERRORS
 .B setattr
 permission to the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_setperm.3 +4 -7
index d5d9015..8607680 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_setperm \- change the permissions mask on a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -111,13 +115,6 @@ .SH ERRORS
 .B setattr
 permission to the calling process.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_update.3 +4 -7
index 2d44740..cdf0a8e 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_update \- update a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -77,13 +81,6 @@ .SH ERRORS
 .B EOPNOTSUPP
 The key type does not support the update operation on its keys.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyctl_watch_key.3 +4 -7
index 044b7a3..0cfba6f 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyctl_watch_key \- Watch for changes to a key
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -187,13 +191,6 @@ .SH ERRORS
 .B EBADSLT
 The specified key doesn't have a watch on it (removal only).
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-This is a library function that can be found in
-.IR libkeyutils .
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
man/keyutils.7 +4 -8
index e17253b..3ab193c 100644
@@ -12,6 +12,10 @@
 .SH NAME
 keyutils \- in-kernel key management utilities
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH DESCRIPTION
 The
 .B keyutils
@@ -25,14 +29,6 @@ .SH DESCRIPTION
 .B #include <keyutils.h>
 .RE
 .P
-To link with the library, the following:
-.P
-.RS
-.B \-lkeyutils
-.RE
-.P
-should be specified to the linker.
-.P
 Three system calls are provided:
 .TP
 .BR add_key (2)
man/recursive_key_scan.3 +4 -5
index 8658002..4e38d4a 100644
@@ -12,6 +12,10 @@
 .SH NAME
 recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH LIBRARY
+Key management utilities library
+.RI ( libkeyutils ,\~ \-lkeyutils )
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SYNOPSIS
 .nf
 .B #include <keyutils.h>
@@ -77,11 +81,6 @@ .SH RETURN VALUE
 .SH ERRORS
 Ignored.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-.SH LINKING
-When linking,
-.B \-lkeyutils
-should be specified to the linker.
-.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH SEE ALSO
 .ad l
 .nh
Signature · 1 line
2.45.2
#3 lore raw

PATCH 3/10 man: Fix TH arguments 4 and 5

In reply to Alejandro Colomar

mandoc_man(7) says:

TH Set the name of the manual page for use in the page header
and footer with the following syntax:

.TH name section date [source [volume]]

[...]. The recommended date format is YYYY‐MM‐DD as specified in the ISO‐8601 standard; if the argument does not conform, it is printed verbatim. If the date is empty or not specified, the current date is used. The optional source string specifies the organisation providing the utility. When unspecified, mandoc(1) uses its -Ios argument. The volume string replaces the default volume title of the section.

groff_man_style(7) says:

.TH identifier section [footer‐middle [footer‐inside [header‐middle]]]

[...]

By convention, footer‐middle is the date of the most recent modification to the man page source document, and footer‐ inside is the name and version or release of the project providing it.

The 5th argument is usually to be omitted, and it will default to the description of the chapter of the manual, that is, for man3 it will be "Library Functions Manual".

The 4th argument should be the name of the project providing the manual page, possibly including the version of it. For example, in the Linux man-pages project, we use the following in the git repository:

.TH keyctl 2 (date) "Linux man-pages (unreleased)"

and the following on a release:

	.TH keyctl 2 2024-06-15 "Linux man-pages 6.9.1"

Here, I'd use keyutils, or possibly keyutils-X.Y. For now, I've made it just contain the project name.

---
 man/asymmetric-key.7              | 2 +-
 man/find_key_by_type_and_name.3   | 2 +-
 man/key.dns_resolver.8            | 2 +-
 man/key.dns_resolver.conf.5       | 2 +-
 man/keyctl.1                      | 2 +-
 man/keyctl.3                      | 2 +-
 man/keyctl_capabilities.3         | 2 +-
 man/keyctl_chown.3                | 2 +-
 man/keyctl_clear.3                | 2 +-
 man/keyctl_describe.3             | 2 +-
 man/keyctl_dh_compute.3           | 2 +-
 man/keyctl_get_keyring_ID.3       | 2 +-
 man/keyctl_get_persistent.3       | 2 +-
 man/keyctl_get_security.3         | 2 +-
 man/keyctl_instantiate.3          | 2 +-
 man/keyctl_invalidate.3           | 2 +-
 man/keyctl_join_session_keyring.3 | 2 +-
 man/keyctl_link.3                 | 2 +-
 man/keyctl_move.3                 | 2 +-
 man/keyctl_pkey_encrypt.3         | 2 +-
 man/keyctl_pkey_query.3           | 2 +-
 man/keyctl_pkey_sign.3            | 2 +-
 man/keyctl_read.3                 | 2 +-
 man/keyctl_restrict_keyring.3     | 2 +-
 man/keyctl_revoke.3               | 2 +-
 man/keyctl_search.3               | 2 +-
 man/keyctl_session_to_parent.3    | 2 +-
 man/keyctl_set_reqkey_keyring.3   | 2 +-
 man/keyctl_set_timeout.3          | 2 +-
 man/keyctl_setperm.3              | 2 +-
 man/keyctl_update.3               | 2 +-
 man/keyctl_watch_key.3            | 2 +-
 man/keyutils.7                    | 2 +-
 man/recursive_key_scan.3          | 2 +-
 man/request-key.8                 | 2 +-
 man/request-key.conf.5            | 2 +-
 36 files changed, 36 insertions(+), 36 deletions(-)
man/asymmetric-key.7 +1 -1
index 82193f6..273f930 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH ASYMMETRIC-KEY 7 "8 Nov 2018" Linux "Asymmetric Kernel Key Type"
+.TH ASYMMETRIC-KEY 7 "8 Nov 2018" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
index c961ece..2a338e8 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" Linux "Linux Key Utility Calls"
+.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
index 0b17edd..c67df97 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER 8 "18 May 2020" Linux "Linux Key Management Utilities"
+.TH KEY.DNS_RESOLVER 8 "18 May 2020" keyutils
 .SH NAME
 key.dns_resolver \- upcall for request\-key to handle dns_resolver keys
 .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
index c944ad5..c395b8e 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" Linux "Linux Key Management Utilities"
+.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" keyutils
 .SH NAME
 key.dns_resolver.conf \- Kernel DNS resolver config
 .SH DESCRIPTION
man/keyctl.1 +1 -1
index c1d067f..7aa0cb7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL 1 "20 Feb 2014" Linux "Linux Key Management Utilities"
+.TH KEYCTL 1 "20 Feb 2014" keyutils
 .SH NAME
 keyctl \- key management facility control
 .SH SYNOPSIS
man/keyctl.3 +1 -1
index 708fcbe..0d04ea6 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL 3 "21 Feb 2014" Linux "Linux Key Management Calls"
+.TH KEYCTL 3 "21 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
index 86ec352..c687faa 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CAPABILITIES 3 "30 May 2019" Linux "Linux Key Management Calls"
+.TH KEYCTL_CAPABILITIES 3 "30 May 2019" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
index 2006af4..1c8fa9a 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CHOWN 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_CHOWN 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
index 34e7262..010b175 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CLEAR 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_CLEAR 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
index 97d454b..198f1b7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DESCRIBE 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_DESCRIBE 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
index befb83d..8a2d29f 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" Linux "Linux Key Management Calls"
+.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
index 4c2ca5c..a754aa1 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_persistent.3 +1 -1
index d878cbb..71d8626 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" Linux "Linux Key Management Calls"
+.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_persistent \- get the persistent keyring for a user
man/keyctl_get_security.3 +1 -1
index 7113e2f..b9b05c2 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" Linux "Linux Key Management Calls"
+.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
index 0d3b459..ff1dea5 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INSTANTIATE 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_INSTANTIATE 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
index 928319f..e54f505 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" Linux "Linux Key Management Calls"
+.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
index b8ed639..65233f8 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" Linux "Linux Key Management Calls"
+.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
index 9046121..7b607bf 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_LINK 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_LINK 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
index a8f0c7f..894e76d 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_MOVE 3 "29 May 2019" Linux "Linux Key Management Calls"
+.TH KEYCTL_MOVE 3 "29 May 2019" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
index b199a05..f3c5478 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" Linux "Linux Public-Key Encryption"
+.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
index e7613c8..837b9db 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" Linux "Linux Key Management Calls"
+.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
index 2f0b106..5997046 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" Linux "Linux Public-Key Signatures"
+.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
index 6728b5b..8b767a3 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_READ 3 "21 Feb 2014" Linux "Linux Key Management Calls"
+.TH KEYCTL_READ 3 "21 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
index 9e4d023..1f3d1eb 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" Linux "Linux Key Management Calls"
+.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
index a973d39..a00b1f8 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_REVOKE 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_REVOKE 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
index f7db46d..c779fb0 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SEARCH 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_SEARCH 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
index b05c030..e208459 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" Linux "Linux Key Management Calls"
+.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
index e8d6afa..e742f13 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
index ec8b364..b5d055b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
index 8607680..f246946 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SETPERM 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_SETPERM 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
index cdf0a8e..4cff75c 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_UPDATE 3 "4 May 2006" Linux "Linux Key Management Calls"
+.TH KEYCTL_UPDATE 3 "4 May 2006" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
index 0cfba6f..b8ed158 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" Linux "Linux Key Management Calls"
+.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
index 3ab193c..f17ee35 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYUTILS 7 "21 Feb 2014" Linux "Kernel key management"
+.TH KEYUTILS 7 "21 Feb 2014" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
index 4e38d4a..daf75f1 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" Linux "Linux Key Utility Calls"
+.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
index 50a7506..1db6ebc 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY 8 "15 Nov 2011" Linux "Linux Key Management Utilities"
+.TH REQUEST-KEY 8 "15 Nov 2011" keyutils
 .SH NAME
 request\-key \- handle key instantiation callback requests from the kernel
 .SH SYNOPSIS
man/request-key.conf.5 +1 -1
index 276c771..dde6295 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY.CONF 5 "15 November 2011" Linux "Linux Key Management Utilities"
+.TH REQUEST-KEY.CONF 5 "15 November 2011" keyutils
 .SH NAME
 request\-key.conf \- Instantiation handler configuration file
 .SH DESCRIPTION
Signature · 1 line
2.45.2
#4 lore raw

PATCH 4/10 man: Update date in TH

In reply to Alejandro Colomar

The date in the TH line is meant to be the date of last modification of the page. Also, the recommended date format is YYYY-MM-DD, which conforms to ISO-8601, so switch to it.

mandoc_man(7) says:

TH Set the name of the manual page for use in the page header
and footer with the following syntax:

.TH name section date [source [volume]]

[...]. The recommended date format is YYYY‐MM‐DD as specified in the ISO‐8601 standard; if the argument does not conform, it is printed verbatim. If the date is empty or not specified, the current date is used. [...]

groff_man_style(7) says:

.TH identifier section [footer‐middle [footer‐inside [header‐middle]]]

[...]

By convention, footer‐middle is the date of the most recent modification to the man page source document, [...]

[...]

In the title heading (.TH), the date of the page’s last revision is more important than packaging information; it should not be omitted. Ideally, a page maintainer will keep both up to date.

---
 man/asymmetric-key.7              | 2 +-
 man/find_key_by_type_and_name.3   | 2 +-
 man/key.dns_resolver.8            | 2 +-
 man/key.dns_resolver.conf.5       | 2 +-
 man/keyctl.1                      | 2 +-
 man/keyctl.3                      | 2 +-
 man/keyctl_capabilities.3         | 2 +-
 man/keyctl_chown.3                | 2 +-
 man/keyctl_clear.3                | 2 +-
 man/keyctl_describe.3             | 2 +-
 man/keyctl_dh_compute.3           | 2 +-
 man/keyctl_get_keyring_ID.3       | 2 +-
 man/keyctl_get_persistent.3       | 2 +-
 man/keyctl_get_security.3         | 2 +-
 man/keyctl_instantiate.3          | 2 +-
 man/keyctl_invalidate.3           | 2 +-
 man/keyctl_join_session_keyring.3 | 2 +-
 man/keyctl_link.3                 | 2 +-
 man/keyctl_move.3                 | 2 +-
 man/keyctl_pkey_encrypt.3         | 2 +-
 man/keyctl_pkey_query.3           | 2 +-
 man/keyctl_pkey_sign.3            | 2 +-
 man/keyctl_read.3                 | 2 +-
 man/keyctl_restrict_keyring.3     | 2 +-
 man/keyctl_revoke.3               | 2 +-
 man/keyctl_search.3               | 2 +-
 man/keyctl_session_to_parent.3    | 2 +-
 man/keyctl_set_reqkey_keyring.3   | 2 +-
 man/keyctl_set_timeout.3          | 2 +-
 man/keyctl_setperm.3              | 2 +-
 man/keyctl_update.3               | 2 +-
 man/keyctl_watch_key.3            | 2 +-
 man/keyutils.7                    | 2 +-
 man/recursive_key_scan.3          | 2 +-
 man/request-key.8                 | 2 +-
 man/request-key.conf.5            | 2 +-
 36 files changed, 36 insertions(+), 36 deletions(-)
man/asymmetric-key.7 +1 -1
index 273f930..70ed935 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH ASYMMETRIC-KEY 7 "8 Nov 2018" keyutils
+.TH ASYMMETRIC-KEY 7 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
index 2a338e8..802b9cd 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" keyutils
+.TH FIND_KEY_BY_TYPE_AND_NAME 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
index c67df97..383f5af 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER 8 "18 May 2020" keyutils
+.TH KEY.DNS_RESOLVER 8 2024-06-19 keyutils
 .SH NAME
 key.dns_resolver \- upcall for request\-key to handle dns_resolver keys
 .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
index c395b8e..43668ca 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" keyutils
+.TH KEY.DNS_RESOLVER.CONF 5 2024-06-19 keyutils
 .SH NAME
 key.dns_resolver.conf \- Kernel DNS resolver config
 .SH DESCRIPTION
man/keyctl.1 +1 -1
index 7aa0cb7..bb4856e 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL 1 "20 Feb 2014" keyutils
+.TH KEYCTL 1 2024-06-19 keyutils
 .SH NAME
 keyctl \- key management facility control
 .SH SYNOPSIS
man/keyctl.3 +1 -1
index 0d04ea6..ef59397 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL 3 "21 Feb 2014" keyutils
+.TH KEYCTL 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
index c687faa..6686143 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CAPABILITIES 3 "30 May 2019" keyutils
+.TH KEYCTL_CAPABILITIES 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
index 1c8fa9a..09d5129 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CHOWN 3 "4 May 2006" keyutils
+.TH KEYCTL_CHOWN 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
index 010b175..e17acac 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CLEAR 3 "4 May 2006" keyutils
+.TH KEYCTL_CLEAR 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
index 198f1b7..17573d0 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DESCRIBE 3 "4 May 2006" keyutils
+.TH KEYCTL_DESCRIBE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
index 8a2d29f..b986131 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" keyutils
+.TH KEYCTL_DH_COMPUTE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
index a754aa1..39d2115 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" keyutils
+.TH KEYCTL_GET_KEYRING_ID 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_persistent.3 +1 -1
index 71d8626..4f81ade 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" keyutils
+.TH KEYCTL_GET_PERSISTENT 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_persistent \- get the persistent keyring for a user
man/keyctl_get_security.3 +1 -1
index b9b05c2..b0f87ab 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" keyutils
+.TH KEYCTL_GET_SECURITY 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
index ff1dea5..08d0d37 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INSTANTIATE 3 "4 May 2006" keyutils
+.TH KEYCTL_INSTANTIATE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
index e54f505..c7edf7b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" keyutils
+.TH KEYCTL_INVALIDATE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
index 65233f8..0d5793e 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" keyutils
+.TH KEYCTL_JOIN_SESSION_KEYRING 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
index 7b607bf..bf57651 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_LINK 3 "4 May 2006" keyutils
+.TH KEYCTL_LINK 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
index 894e76d..14259d1 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_MOVE 3 "29 May 2019" keyutils
+.TH KEYCTL_MOVE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
index f3c5478..d81c625 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" keyutils
+.TH KEYCTL_PKEY_ENCRYPT 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
index 837b9db..211aca7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" keyutils
+.TH KEYCTL_PKEY_QUERY 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
index 5997046..0351cfe 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" keyutils
+.TH KEYCTL_PKEY_SIGN 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
index 8b767a3..a672526 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_READ 3 "21 Feb 2014" keyutils
+.TH KEYCTL_READ 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
index 1f3d1eb..63f9f7e 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" keyutils
+.TH KEYCTL_RESTRICT_KEYRING 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
index a00b1f8..22f8b4c 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_REVOKE 3 "4 May 2006" keyutils
+.TH KEYCTL_REVOKE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
index c779fb0..7b56310 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SEARCH 3 "4 May 2006" keyutils
+.TH KEYCTL_SEARCH 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
index e208459..56d2c92 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" keyutils
+.TH KEYCTL_SESSION_TO_PARENT 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
index e742f13..356a008 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" keyutils
+.TH KEYCTL_SET_REQKEY_KEYRING 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
index b5d055b..36c3274 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" keyutils
+.TH KEYCTL_SET_TIMEOUT 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
index f246946..30dff85 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SETPERM 3 "4 May 2006" keyutils
+.TH KEYCTL_SETPERM 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
index 4cff75c..d292c4f 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_UPDATE 3 "4 May 2006" keyutils
+.TH KEYCTL_UPDATE 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
index b8ed158..57534a8 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" keyutils
+.TH KEYCTL_GRANT_PERMISSION 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
index f17ee35..08402e0 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYUTILS 7 "21 Feb 2014" keyutils
+.TH KEYUTILS 7 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
index daf75f1..fe690f9 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" keyutils
+.TH RECURSIVE_KEY_SCAN 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
index 1db6ebc..242db77 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY 8 "15 Nov 2011" keyutils
+.TH REQUEST-KEY 8 2024-06-19 keyutils
 .SH NAME
 request\-key \- handle key instantiation callback requests from the kernel
 .SH SYNOPSIS
man/request-key.conf.5 +1 -1
index dde6295..29ba977 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY.CONF 5 "15 November 2011" keyutils
+.TH REQUEST-KEY.CONF 5 2024-06-19 keyutils
 .SH NAME
 request\-key.conf \- Instantiation handler configuration file
 .SH DESCRIPTION
Signature · 1 line
2.45.2
#5 lore raw

PATCH 5/10 man: Use lowercase in TH 1st argument

In reply to Alejandro Colomar

The maintainers of groff(1), mandoc(1), man(1), and the Linux man-pages project, and several others have reached a consensus that using upper case in the TH 1st argument is unnecessarily imprecise, and that it would be more appropriate to use the same case that the name of the thing to be documented: so for NULL, it would be upper case, but for printf, it would be lower case.

The use of upper case seems to have been inertia from a time when there was no bold face, so authors of the manual chose use upper case for emphasis. These days we can do better.

---
 man/asymmetric-key.7              | 2 +-
 man/find_key_by_type_and_name.3   | 2 +-
 man/key.dns_resolver.8            | 2 +-
 man/key.dns_resolver.conf.5       | 2 +-
 man/keyctl.1                      | 2 +-
 man/keyctl.3                      | 2 +-
 man/keyctl_capabilities.3         | 2 +-
 man/keyctl_chown.3                | 2 +-
 man/keyctl_clear.3                | 2 +-
 man/keyctl_describe.3             | 2 +-
 man/keyctl_dh_compute.3           | 2 +-
 man/keyctl_get_keyring_ID.3       | 2 +-
 man/keyctl_get_security.3         | 2 +-
 man/keyctl_instantiate.3          | 2 +-
 man/keyctl_invalidate.3           | 2 +-
 man/keyctl_join_session_keyring.3 | 2 +-
 man/keyctl_link.3                 | 2 +-
 man/keyctl_move.3                 | 2 +-
 man/keyctl_pkey_encrypt.3         | 2 +-
 man/keyctl_pkey_query.3           | 2 +-
 man/keyctl_pkey_sign.3            | 2 +-
 man/keyctl_read.3                 | 2 +-
 man/keyctl_restrict_keyring.3     | 2 +-
 man/keyctl_revoke.3               | 2 +-
 man/keyctl_search.3               | 2 +-
 man/keyctl_session_to_parent.3    | 2 +-
 man/keyctl_set_reqkey_keyring.3   | 2 +-
 man/keyctl_set_timeout.3          | 2 +-
 man/keyctl_setperm.3              | 2 +-
 man/keyctl_update.3               | 2 +-
 man/keyctl_watch_key.3            | 2 +-
 man/keyutils.7                    | 2 +-
 man/recursive_key_scan.3          | 2 +-
 man/request-key.8                 | 2 +-
 man/request-key.conf.5            | 2 +-
 35 files changed, 35 insertions(+), 35 deletions(-)
man/asymmetric-key.7 +1 -1
index 70ed935..bd338b4 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH ASYMMETRIC-KEY 7 2024-06-19 keyutils
+.TH asymmetric-key 7 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
index 802b9cd..c2e8130 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH FIND_KEY_BY_TYPE_AND_NAME 3 2024-06-19 keyutils
+.TH find_key_by_type_and_name 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
index 383f5af..aef61db 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER 8 2024-06-19 keyutils
+.TH key.dns_resolver 8 2024-06-19 keyutils
 .SH NAME
 key.dns_resolver \- upcall for request\-key to handle dns_resolver keys
 .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
index 43668ca..052a7ff 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEY.DNS_RESOLVER.CONF 5 2024-06-19 keyutils
+.TH key.dns_resolver.conf 5 2024-06-19 keyutils
 .SH NAME
 key.dns_resolver.conf \- Kernel DNS resolver config
 .SH DESCRIPTION
man/keyctl.1 +1 -1
index bb4856e..59eabf7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL 1 2024-06-19 keyutils
+.TH keyctl 1 2024-06-19 keyutils
 .SH NAME
 keyctl \- key management facility control
 .SH SYNOPSIS
man/keyctl.3 +1 -1
index ef59397..f583640 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL 3 2024-06-19 keyutils
+.TH keyctl 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
index 6686143..c56b6b2 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CAPABILITIES 3 2024-06-19 keyutils
+.TH keyctl_capabilities 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
index 09d5129..71b9332 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CHOWN 3 2024-06-19 keyutils
+.TH keyctl_chown 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
index e17acac..c25cae3 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_CLEAR 3 2024-06-19 keyutils
+.TH keyctl_clear 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
index 17573d0..409ec0a 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DESCRIBE 3 2024-06-19 keyutils
+.TH keyctl_describe 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
index b986131..0f2326d 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_DH_COMPUTE 3 2024-06-19 keyutils
+.TH keyctl_dh_compute 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
index 39d2115..0e7f82d 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_KEYRING_ID 3 2024-06-19 keyutils
+.TH keyctl_get_keyring_ID 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_security.3 +1 -1
index b0f87ab..f8d918b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GET_SECURITY 3 2024-06-19 keyutils
+.TH keyctl_get_security 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
index 08d0d37..c45a7cb 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INSTANTIATE 3 2024-06-19 keyutils
+.TH keyctl_instantiate 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
index c7edf7b..e29e0b4 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_INVALIDATE 3 2024-06-19 keyutils
+.TH keyctl_invalidate 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
index 0d5793e..b9d5f1b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_JOIN_SESSION_KEYRING 3 2024-06-19 keyutils
+.TH keyctl_join_session_keyring 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
index bf57651..b24a03b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_LINK 3 2024-06-19 keyutils
+.TH keyctl_link 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
index 14259d1..ec6834d 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_MOVE 3 2024-06-19 keyutils
+.TH keyctl_move 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
index d81c625..b3a4445 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_ENCRYPT 3 2024-06-19 keyutils
+.TH keyctl_pkey_encrypt 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
index 211aca7..ee194c7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_QUERY 3 2024-06-19 keyutils
+.TH keyctl_pkey_query 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
index 0351cfe..445114c 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYCTL_PKEY_SIGN 3 2024-06-19 keyutils
+.TH keyctl_pkey_sign 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
index a672526..cd0c117 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_READ 3 2024-06-19 keyutils
+.TH keyctl_read 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
index 63f9f7e..b94c4c4 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_RESTRICT_KEYRING 3 2024-06-19 keyutils
+.TH keyctl_restrict_keyring 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
index 22f8b4c..e07e708 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_REVOKE 3 2024-06-19 keyutils
+.TH keyctl_revoke 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
index 7b56310..149bb3b 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SEARCH 3 2024-06-19 keyutils
+.TH keyctl_search 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
index 56d2c92..aedb6a3 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SESSION_TO_PARENT 3 2024-06-19 keyutils
+.TH keyctl_session_to_parent 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
index 356a008..2f7d1f7 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_REQKEY_KEYRING 3 2024-06-19 keyutils
+.TH keyctl_set_reqkey_keyring 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
index 36c3274..f29feb4 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SET_TIMEOUT 3 2024-06-19 keyutils
+.TH keyctl_set_timeout 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
index 30dff85..628d34c 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_SETPERM 3 2024-06-19 keyutils
+.TH keyctl_setperm 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
index d292c4f..11a65db 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_UPDATE 3 2024-06-19 keyutils
+.TH keyctl_update 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
index 57534a8..f0087da 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH KEYCTL_GRANT_PERMISSION 3 2024-06-19 keyutils
+.TH keyctl_grant_permission 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
index 08402e0..5bb1742 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH KEYUTILS 7 2024-06-19 keyutils
+.TH keyutils 7 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
index fe690f9..aa78a25 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the Licence, or (at your option) any later version.
 .\"
-.TH RECURSIVE_KEY_SCAN 3 2024-06-19 keyutils
+.TH recursive_key_scan 3 2024-06-19 keyutils
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH NAME
 recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
index 242db77..1ce1761 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY 8 2024-06-19 keyutils
+.TH request-key 8 2024-06-19 keyutils
 .SH NAME
 request\-key \- handle key instantiation callback requests from the kernel
 .SH SYNOPSIS
man/request-key.conf.5 +1 -1
index 29ba977..fbee4df 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH REQUEST-KEY.CONF 5 2024-06-19 keyutils
+.TH request-key.conf 5 2024-06-19 keyutils
 .SH NAME
 request\-key.conf \- Instantiation handler configuration file
 .SH DESCRIPTION
Signature · 1 line
2.45.2
#6 lore raw

PATCH 6/10 man: Escape dashes in TH

In reply to Alejandro Colomar

When they document an identifier that uses a dash.

---
 man/request-key.8      | 2 +-
 man/request-key.conf.5 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
man/request-key.8 +1 -1
index 1ce1761..d49ca78 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH request-key 8 2024-06-19 keyutils
+.TH request\-key 8 2024-06-19 keyutils
 .SH NAME
 request\-key \- handle key instantiation callback requests from the kernel
 .SH SYNOPSIS
man/request-key.conf.5 +1 -1
index fbee4df..c2e77d4 100644
@@ -7,7 +7,7 @@
 .\" as published by the Free Software Foundation; either version
 .\" 2 of the License, or (at your option) any later version.
 .\"
-.TH request-key.conf 5 2024-06-19 keyutils
+.TH request\-key.conf 5 2024-06-19 keyutils
 .SH NAME
 request\-key.conf \- Instantiation handler configuration file
 .SH DESCRIPTION
Signature · 1 line
2.45.2
#7 lore raw

PATCH 7/10 man: Add SYNOPSYS section

In reply to Alejandro Colomar

This is a simpler and more standard way of documenting the header that provides these functions.

---
 man/keyctl.3   | 12 +++++-------
 man/keyutils.7 | 12 +++++-------
 2 files changed, 10 insertions(+), 14 deletions(-)
man/keyctl.3 +5 -7
index f583640..352b0c4 100644
@@ -16,18 +16,16 @@ .SH LIBRARY
 Key management utilities library
 .RI ( libkeyutils ,\~ \-lkeyutils )
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH SYNOPSIS
+.nf
+.B #include <keyutils.h>
+.fi
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH DESCRIPTION
 The
 .BR keyctl ()
 system call is a multiplexor for a number of key management functions.  These
 should be called via the wrappers in the libkeyutils library.
-.P
-The functions can be compiled in by including the \fBkeyutils\fR header file:
-.sp
-.RS
-.nf
-.B #include <keyutils.h>
-.RE
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH KEYCTL FUNCTIONS
 .BR keyctl_assume_authority (3)
man/keyutils.7 +5 -7
index 5bb1742..33811e7 100644
@@ -16,19 +16,17 @@ .SH LIBRARY
 Key management utilities library
 .RI ( libkeyutils ,\~ \-lkeyutils )
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.SH SYNOPSIS
+.nf
+.B #include <keyutils.h>
+.fi
+.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .SH DESCRIPTION
 The
 .B keyutils
 package is a library and a set of utilities for accessing the kernel
 \fBkeyrings\fP facility.
 .P
-A header file is supplied to provide the definitions and declarations required
-to access the library:
-.P
-.RS
-.B #include <keyutils.h>
-.RE
-.P
 Three system calls are provided:
 .TP
 .BR add_key (2)
Signature · 1 line
2.45.2
#8 lore raw

PATCH 8/10 man: Improve formatting of SYNOPSIS of commands

In reply to Alejandro Colomar
---
 man/keyctl.1      | 426 ++++++++++++++++++++++++++++++++++------------
 man/request-key.8 |  12 +-
 2 files changed, 324 insertions(+), 114 deletions(-)
man/keyctl.1 +314 -112
index 59eabf7..59172d4 100644
@@ -11,118 +11,320 @@
 .SH NAME
 keyctl \- key management facility control
 .SH SYNOPSIS
-\fBkeyctl\fR \-\-version
-.br
-\fBkeyctl\fR supports [<cap> | --raw]
-.br
-\fBkeyctl\fR id [<keyring>]
-.br
-\fBkeyctl\fR show [\-x] [<keyring>]
-.br
-\fBkeyctl\fR add [\-x] <type> <desc> <data> <keyring>
-.br
-\fBkeyctl\fR padd [\-x] <type> <desc> <keyring>
-.br
-\fBkeyctl\fR request <type> <desc> [<dest_keyring>]
-.br
-\fBkeyctl\fR request2 <type> <desc> <info> [<dest_keyring>]
-.br
-\fBkeyctl\fR prequest2 <type> <desc> [<dest_keyring>]
-.br
-\fBkeyctl\fR update [\-x] <key> <data>
-.br
-\fBkeyctl\fR pupdate [\-x] <key>
-.br
-\fBkeyctl\fR newring <name> <keyring>
-.br
-\fBkeyctl\fR revoke <key>
-.br
-\fBkeyctl\fR clear <keyring>
-.br
-\fBkeyctl\fR link <key> <keyring>
-.br
-\fBkeyctl\fR unlink <key> [<keyring>]
-.br
-\fBkeyctl\fR move [-f] <key> <from_keyring> <to_keyring>
-.br
-\fBkeyctl\fR search <keyring> <type> <desc> [<dest_keyring>]
-.br
-\fBkeyctl\fR restrict_keyring <keyring> [<type> [<restriction>]]
-.br
-\fBkeyctl\fR read <key>
-.br
-\fBkeyctl\fR pipe <key>
-.br
-\fBkeyctl\fR print <key>
-.br
-\fBkeyctl\fR list <keyring>
-.br
-\fBkeyctl\fR rlist <keyring>
-.br
-\fBkeyctl\fR describe <keyring>
-.br
-\fBkeyctl\fR rdescribe <keyring> [sep]
-.br
-\fBkeyctl\fR chown <key> <uid>
-.br
-\fBkeyctl\fR chgrp <key> <gid>
-.br
-\fBkeyctl\fR setperm <key> <mask>
-.br
-\fBkeyctl\fR new_session [<name>]
-.br
-\fBkeyctl\fR session
-.br
-\fBkeyctl\fR session \- [<prog> <arg1> <arg2> ...]
-.br
-\fBkeyctl\fR session <name> [<prog> <arg1> <arg2> ...]
-.br
-\fBkeyctl\fR instantiate [\-x] <key> <data> <keyring>
-.br
-\fBkeyctl\fR pinstantiate [\-x] <key> <keyring>
-.br
-\fBkeyctl\fR negate <key> <timeout> <keyring>
-.br
-\fBkeyctl\fR reject <key> <timeout> <error> <keyring>
-.br
-\fBkeyctl\fR timeout <key> <timeout>
-.br
-\fBkeyctl\fR security <key>
-.br
-\fBkeyctl\fR reap [\-v]
-.br
-\fBkeyctl\fR purge <type>
-.br
-\fBkeyctl\fR purge [\-i] [\-p] <type> <desc>
-.br
-\fBkeyctl\fR purge \-s <type> <desc>
-.br
-\fBkeyctl\fR get_persistent <keyring> [<uid>]
-.br
-\fBkeyctl\fR dh_compute <private> <prime> <base>
-.br
-\fBkeyctl\fR dh_compute_kdf <private> <prime> <base> <output_length> <hash_type>
-.br
-\fBkeyctl\fR dh_compute_kdf_oi [\-x] <private> <prime> <base> <output_length> <hash_type>
-.br
-\fBkeyctl\fR pkey_query <key> <pass> [k=v]*
-.br
-\fBkeyctl\fR pkey_encrypt <key> <pass> <datafile> [k=v]* ><encfile>
-.br
-\fBkeyctl\fR pkey_decrypt <key> <pass> <encfile> [k=v]* ><datafile>
-.br
-\fBkeyctl\fR pkey_sign <key> <pass> <datafile> [k=v]* ><sigfile>
-.br
-\fBkeyctl\fR pkey_decrypt <key> <pass> <datafile> <sigfile> [k=v]*
-.br
-\fBkeyctl\fR watch [\-f<filters>] <key>
-.br
-\fBkeyctl\fR watch_add <fd> <key>
-.br
-\fBkeyctl\fR watch_rm <fd> <key>
-.br
-\fBkeyctl\fR watch_session [\-f <filters>] [-n <name>] \\
-                <notifylog> <gclog> <fd> <prog> [<arg1> <arg2> ...]
+.SY keyctl
+.B \-\-version
+.YS
+.SY keyctl
+.B supports
+.RI [ cap \~|\~\fB--raw\fP]
+.YS
+.SY keyctl
+.B id
+.RI [ keyring ]
+.YS
+.SY keyctl
+.B show
+.RB [ \-x ]
+.RI [ keyring ]
+.YS
+.SY keyctl
+.B add
+.RB [ \-x ]
+.I type
+.I desc
+.I data
+.I keyring
+.YS
+.SY keyctl
+.B padd
+.RB [ \-x ]
+.I type
+.I desc
+.I keyring
+.YS
+.SY keyctl
+.B request
+.I type
+.I desc
+.RI [ dest_keyring ]
+.YS
+.SY keyctl
+.B request2
+.I type
+.I desc
+.I info
+.RI [ dest_keyring ]
+.YS
+.SY keyctl
+.B prequest2
+.I type
+.I desc
+.RI [ dest_keyring ]
+.YS
+.SY keyctl
+.B update
+.RB [ \-x ]
+.I key
+.I data
+.YS
+.SY keyctl
+.B pupdate
+.RB [ \-x ]
+.I key
+.YS
+.SY keyctl
+.B newring
+.I name
+.I keyring
+.YS
+.SY keyctl
+.B revoke
+.I key
+.YS
+.SY keyctl
+.B clear
+.I keyring
+.YS
+.SY keyctl
+.B link
+.I key
+.I keyring
+.YS
+.SY keyctl
+.B unlink
+.I key
+.RI [ keyring ]
+.YS
+.SY keyctl
+.B move
+.RB [ -f ]
+.I key
+.I from_keyring
+.I to_keyring
+.YS
+.SY keyctl
+.B search
+.I keyring
+.I type
+.I desc
+.RI [ dest_keyring ]
+.YS
+.SY keyctl
+.B restrict_keyring
+.I keyring
+.RI [ type
+.RI [ restriction ]]
+.YS
+.SY keyctl
+.B read
+.I key
+.YS
+.SY keyctl
+.B pipe
+.I key
+.YS
+.SY keyctl
+.B print
+.I key
+.YS
+.SY keyctl
+.B list
+.I keyring
+.YS
+.SY keyctl
+.B rlist
+.I keyring
+.YS
+.SY keyctl
+.B describe
+.I keyring
+.YS
+.SY keyctl
+.B rdescribe
+.I keyring
+.RB [ sep ]
+.YS
+.SY keyctl
+.B chown
+.I key
+.I uid
+.YS
+.SY keyctl
+.B chgrp
+.I key
+.I gid
+.YS
+.SY keyctl
+.B setperm
+.I key
+.I mask
+.YS
+.SY keyctl
+.B new_session
+.RI [ name ]
+.YS
+.SY keyctl
+.B session
+.YS
+.SY keyctl
+.B session
+.B \-
+.RI [ prog
+.IR args \~.\|.\|.]
+.YS
+.SY keyctl
+.B session
+.I name
+.RI [ prog
+.RI [ args \~.\|.\|.]]
+.YS
+.SY keyctl
+.B instantiate
+.RB [ \-x ]
+.I key
+.I data
+.I keyring
+.YS
+.SY keyctl
+.B pinstantiate
+.RB [ \-x ]
+.I key
+.I keyring
+.YS
+.SY keyctl
+.B negate
+.I key
+.I timeout
+.I keyring
+.YS
+.SY keyctl
+.B reject
+.I key
+.I timeout
+.I error
+.I keyring
+.YS
+.SY keyctl
+.B timeout
+.I key
+.I timeout
+.YS
+.SY keyctl
+.B security
+.I key
+.YS
+.SY keyctl
+.B reap
+.RB [ \-v ]
+.YS
+.SY keyctl
+.B purge
+.I type
+.YS
+.SY keyctl
+.B purge
+.RB [ \-i ]
+.RB [ \-p ]
+.I type
+.I desc
+.YS
+.SY keyctl
+.B purge
+.B \-s
+.I type
+.I desc
+.YS
+.SY keyctl
+.B get_persistent
+.I keyring
+.RI [ uid ]
+.YS
+.SY keyctl
+.B dh_compute
+.I private
+.I prime
+.I base
+.YS
+.SY keyctl
+.B dh_compute_kdf
+.I private
+.I prime
+.I base
+.I output_length
+.I hash_type
+.YS
+.SY keyctl
+.B dh_compute_kdf_oi
+.RB [ \-x ]
+.I private
+.I prime
+.I base
+.I output_length
+.I hash_type
+.YS
+.SY keyctl
+.B pkey_query
+.I key
+.I pass
+.RI [ k \fB=\fP v \~.\|.\|.]
+.YS
+.SY keyctl
+.B pkey_encrypt
+.I key
+.I pass
+.I datafile
+.RI [ k \fB=\fP v \~.\|.\|.\&]
+.I encfile
+.YS
+.SY keyctl
+.B pkey_decrypt
+.I key
+.I pass
+.I encfile
+.RI [ k \fB=\fP v \~.\|.\|.\&]
+.I datafile
+.YS
+.SY keyctl
+.B pkey_sign
+.I key
+.I pass
+.I datafile
+.RI [ k \fB=\fP v \~.\|.\|.\&]
+.I sigfile
+.YS
+.SY keyctl
+.B pkey_decrypt
+.I key
+.I pass
+.I datafile
+.I sigfile
+.RI [ k \fB=\fP v \~.\|.\|.]
+.YS
+.SY keyctl
+.B watch
+.RB [ \-f \~\fIfilters\fP]
+.I key
+.YS
+.SY keyctl
+.B watch_add
+.I fd
+.I key
+.YS
+.SY keyctl
+.B watch_rm
+.I fd
+.I key
+.YS
+.SY keyctl
+.B watch_session
+.RB [ \-f \~\fIfilters\fP]
+.RB [ \-n \~\fIname\fP]
+.I notifylog
+.I gclog
+.I fd
+.I prog
+.RI [ args \~.\|.\|.]
+.YS
 .SH DESCRIPTION
 This program is used to control the key management facility in various ways
 using a variety of subcommands.
man/request-key.8 +10 -2
index d49ca78..08f2ace 100644
@@ -11,8 +11,16 @@
 .SH NAME
 request\-key \- handle key instantiation callback requests from the kernel
 .SH SYNOPSIS
-\fB/sbin/request\-key \fR<op> <key> <uid> <gid> <threadring> <processring>
-	<sessionring> [<info>]
+.SY /sbin/request\-key
+.I op
+.I key
+.I uid
+.I gid
+.I threadring
+.I processring
+.I sessionring
+.RI [ info ]
+.YS
 .SH DESCRIPTION
 This program is invoked by the kernel when the kernel is asked for a key that
 it doesn't have immediately available. The kernel creates a partially set up
Signature · 1 line
2.45.2
#9 lore raw

PATCH 9/10 man/keyctl.1: Improve formatting

In reply to Alejandro Colomar
---
 man/keyctl.1 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
man/keyctl.1 +2 -2
index 59172d4..828223b 100644
@@ -369,11 +369,11 @@ .SH KEY IDENTIFIERS
 helper to
 permit it to access the callers keyrings and instantiate the target key.
 .TP
-Keyring by name: \fB%:<name>\fR
+Keyring by name: \f[B]%:\f[BI]name\f[R]
 A named keyring.  This will be searched for in the process's keyrings and in
 .IR /proc/keys .
 .TP
-Key by name: \fB%<type>:<name>\fR
+Key by name: \f[B]%\f[BI]type\f[B]:\f[BI]name\f[R]
 A named key of the given type.  This will be searched for in the process's
 keyrings and in
 .IR /proc/keys .
Signature · 1 line
2.45.2
#10 lore raw

PATCH 10/10 man: Organize manual pages in subdirectories

In reply to Alejandro Colomar
---
 Makefile                                     | 10 +++++-----
 man/{ => man1}/keyctl.1                      |  0
 man/{ => man3}/find_key_by_type_and_name.3   |  0
 man/{ => man3}/keyctl.3                      |  0
 man/{ => man3}/keyctl_capabilities.3         |  0
 man/{ => man3}/keyctl_chown.3                |  0
 man/{ => man3}/keyctl_clear.3                |  0
 man/{ => man3}/keyctl_describe.3             |  0
 man/{ => man3}/keyctl_dh_compute.3           |  0
 man/{ => man3}/keyctl_get_keyring_ID.3       |  0
 man/{ => man3}/keyctl_get_persistent.3       |  0
 man/{ => man3}/keyctl_get_security.3         |  0
 man/{ => man3}/keyctl_instantiate.3          |  0
 man/{ => man3}/keyctl_invalidate.3           |  0
 man/{ => man3}/keyctl_join_session_keyring.3 |  0
 man/{ => man3}/keyctl_link.3                 |  0
 man/{ => man3}/keyctl_move.3                 |  0
 man/{ => man3}/keyctl_pkey_decrypt.3         |  0
 man/{ => man3}/keyctl_pkey_encrypt.3         |  0
 man/{ => man3}/keyctl_pkey_query.3           |  0
 man/{ => man3}/keyctl_pkey_sign.3            |  0
 man/{ => man3}/keyctl_pkey_verify.3          |  0
 man/{ => man3}/keyctl_read.3                 |  0
 man/{ => man3}/keyctl_restrict_keyring.3     |  0
 man/{ => man3}/keyctl_revoke.3               |  0
 man/{ => man3}/keyctl_search.3               |  0
 man/{ => man3}/keyctl_session_to_parent.3    |  0
 man/{ => man3}/keyctl_set_reqkey_keyring.3   |  0
 man/{ => man3}/keyctl_set_timeout.3          |  0
 man/{ => man3}/keyctl_setperm.3              |  0
 man/{ => man3}/keyctl_update.3               |  0
 man/{ => man3}/keyctl_watch_key.3            |  0
 man/{ => man3}/recursive_key_scan.3          |  0
 man/{ => man5}/key.dns_resolver.conf.5       |  0
 man/{ => man5}/request-key.conf.5            |  0
 man/{ => man7}/asymmetric-key.7              |  0
 man/{ => man7}/keyutils.7                    |  0
 man/{ => man8}/key.dns_resolver.8            |  0
 man/{ => man8}/request-key.8                 |  0
 39 files changed, 5 insertions(+), 5 deletions(-)
 rename man/{ => man1}/keyctl.1 (100%)
 rename man/{ => man3}/find_key_by_type_and_name.3 (100%)
 rename man/{ => man3}/keyctl.3 (100%)
 rename man/{ => man3}/keyctl_capabilities.3 (100%)
 rename man/{ => man3}/keyctl_chown.3 (100%)
 rename man/{ => man3}/keyctl_clear.3 (100%)
 rename man/{ => man3}/keyctl_describe.3 (100%)
 rename man/{ => man3}/keyctl_dh_compute.3 (100%)
 rename man/{ => man3}/keyctl_get_keyring_ID.3 (100%)
 rename man/{ => man3}/keyctl_get_persistent.3 (100%)
 rename man/{ => man3}/keyctl_get_security.3 (100%)
 rename man/{ => man3}/keyctl_instantiate.3 (100%)
 rename man/{ => man3}/keyctl_invalidate.3 (100%)
 rename man/{ => man3}/keyctl_join_session_keyring.3 (100%)
 rename man/{ => man3}/keyctl_link.3 (100%)
 rename man/{ => man3}/keyctl_move.3 (100%)
 rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%)
 rename man/{ => man3}/keyctl_pkey_encrypt.3 (100%)
 rename man/{ => man3}/keyctl_pkey_query.3 (100%)
 rename man/{ => man3}/keyctl_pkey_sign.3 (100%)
 rename man/{ => man3}/keyctl_pkey_verify.3 (100%)
 rename man/{ => man3}/keyctl_read.3 (100%)
 rename man/{ => man3}/keyctl_restrict_keyring.3 (100%)
 rename man/{ => man3}/keyctl_revoke.3 (100%)
 rename man/{ => man3}/keyctl_search.3 (100%)
 rename man/{ => man3}/keyctl_session_to_parent.3 (100%)
 rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (100%)
 rename man/{ => man3}/keyctl_set_timeout.3 (100%)
 rename man/{ => man3}/keyctl_setperm.3 (100%)
 rename man/{ => man3}/keyctl_update.3 (100%)
 rename man/{ => man3}/keyctl_watch_key.3 (100%)
 rename man/{ => man3}/recursive_key_scan.3 (100%)
 rename man/{ => man5}/key.dns_resolver.conf.5 (100%)
 rename man/{ => man5}/request-key.conf.5 (100%)
 rename man/{ => man7}/asymmetric-key.7 (100%)
 rename man/{ => man7}/keyutils.7 (100%)
 rename man/{ => man8}/key.dns_resolver.8 (100%)
 rename man/{ => man8}/request-key.8 (100%)
Makefile +5 -5
index d8d4ee3..d8d058d 100644
@@ -221,15 +221,15 @@ endif
 	mkdir -p $(DESTDIR)$(ETCDIR)/request-key.d
 	mkdir -p $(DESTDIR)$(ETCDIR)/keyutils
 	mkdir -p $(DESTDIR)$(MAN1)
-	$(INSTALL) -m 0644 $(wildcard man/*.1) $(DESTDIR)$(MAN1)
+	$(INSTALL) -m 0644 $(wildcard man/man1/*.1) $(DESTDIR)$(MAN1)
 	mkdir -p $(DESTDIR)$(MAN3)
-	$(INSTALL) -m 0644 $(wildcard man/*.3) $(DESTDIR)$(MAN3)
+	$(INSTALL) -m 0644 $(wildcard man/man3/*.3) $(DESTDIR)$(MAN3)
 	mkdir -p $(DESTDIR)$(MAN5)
-	$(INSTALL) -m 0644 $(wildcard man/*.5) $(DESTDIR)$(MAN5)
+	$(INSTALL) -m 0644 $(wildcard man/man5/*.5) $(DESTDIR)$(MAN5)
 	mkdir -p $(DESTDIR)$(MAN7)
-	$(INSTALL) -m 0644 $(wildcard man/*.7) $(DESTDIR)$(MAN7)
+	$(INSTALL) -m 0644 $(wildcard man/man7/*.7) $(DESTDIR)$(MAN7)
 	mkdir -p $(DESTDIR)$(MAN8)
-	$(INSTALL) -m 0644 $(wildcard man/*.8) $(DESTDIR)$(MAN8)
+	$(INSTALL) -m 0644 $(wildcard man/man8/*.8) $(DESTDIR)$(MAN8)
 	$(LNS) keyctl_describe.3 $(DESTDIR)$(MAN3)/keyctl_describe_alloc.3
 	$(LNS) keyctl_get_security.3 $(DESTDIR)$(MAN3)/keyctl_get_security_alloc.3
 	$(LNS) keyctl_instantiate.3 $(DESTDIR)$(MAN3)/keyctl_instantiate_iov.3
man/man1/keyctl.1 renamed from man/keyctl.1 +0 -0
similarity index 100%
rename from man/keyctl.1
rename to man/man1/keyctl.1
man/man3/find_key_by_type_and_name.3 renamed from man/find_key_by_type_and_name.3 +0 -0
similarity index 100%
rename from man/find_key_by_type_and_name.3
rename to man/man3/find_key_by_type_and_name.3
man/man3/keyctl.3 renamed from man/keyctl.3 +0 -0
similarity index 100%
rename from man/keyctl.3
rename to man/man3/keyctl.3
man/man3/keyctl_capabilities.3 renamed from man/keyctl_capabilities.3 +0 -0
similarity index 100%
rename from man/keyctl_capabilities.3
rename to man/man3/keyctl_capabilities.3
man/man3/keyctl_chown.3 renamed from man/keyctl_chown.3 +0 -0
similarity index 100%
rename from man/keyctl_chown.3
rename to man/man3/keyctl_chown.3
man/man3/keyctl_clear.3 renamed from man/keyctl_clear.3 +0 -0
similarity index 100%
rename from man/keyctl_clear.3
rename to man/man3/keyctl_clear.3
man/man3/keyctl_describe.3 renamed from man/keyctl_describe.3 +0 -0
similarity index 100%
rename from man/keyctl_describe.3
rename to man/man3/keyctl_describe.3
man/man3/keyctl_dh_compute.3 renamed from man/keyctl_dh_compute.3 +0 -0
similarity index 100%
rename from man/keyctl_dh_compute.3
rename to man/man3/keyctl_dh_compute.3
man/man3/keyctl_get_keyring_ID.3 renamed from man/keyctl_get_keyring_ID.3 +0 -0
similarity index 100%
rename from man/keyctl_get_keyring_ID.3
rename to man/man3/keyctl_get_keyring_ID.3
man/man3/keyctl_get_persistent.3 renamed from man/keyctl_get_persistent.3 +0 -0
similarity index 100%
rename from man/keyctl_get_persistent.3
rename to man/man3/keyctl_get_persistent.3
man/man3/keyctl_get_security.3 renamed from man/keyctl_get_security.3 +0 -0
similarity index 100%
rename from man/keyctl_get_security.3
rename to man/man3/keyctl_get_security.3
man/man3/keyctl_instantiate.3 renamed from man/keyctl_instantiate.3 +0 -0
similarity index 100%
rename from man/keyctl_instantiate.3
rename to man/man3/keyctl_instantiate.3
man/man3/keyctl_invalidate.3 renamed from man/keyctl_invalidate.3 +0 -0
similarity index 100%
rename from man/keyctl_invalidate.3
rename to man/man3/keyctl_invalidate.3
man/man3/keyctl_join_session_keyring.3 renamed from man/keyctl_join_session_keyring.3 +0 -0
similarity index 100%
rename from man/keyctl_join_session_keyring.3
rename to man/man3/keyctl_join_session_keyring.3
man/man3/keyctl_link.3 renamed from man/keyctl_link.3 +0 -0
similarity index 100%
rename from man/keyctl_link.3
rename to man/man3/keyctl_link.3
man/man3/keyctl_move.3 renamed from man/keyctl_move.3 +0 -0
similarity index 100%
rename from man/keyctl_move.3
rename to man/man3/keyctl_move.3
man/man3/keyctl_pkey_decrypt.3 renamed from man/keyctl_pkey_decrypt.3 +0 -0
similarity index 100%
rename from man/keyctl_pkey_decrypt.3
rename to man/man3/keyctl_pkey_decrypt.3
man/man3/keyctl_pkey_encrypt.3 renamed from man/keyctl_pkey_encrypt.3 +0 -0
similarity index 100%
rename from man/keyctl_pkey_encrypt.3
rename to man/man3/keyctl_pkey_encrypt.3
man/man3/keyctl_pkey_query.3 renamed from man/keyctl_pkey_query.3 +0 -0
similarity index 100%
rename from man/keyctl_pkey_query.3
rename to man/man3/keyctl_pkey_query.3
man/man3/keyctl_pkey_sign.3 renamed from man/keyctl_pkey_sign.3 +0 -0
similarity index 100%
rename from man/keyctl_pkey_sign.3
rename to man/man3/keyctl_pkey_sign.3
man/man3/keyctl_pkey_verify.3 renamed from man/keyctl_pkey_verify.3 +0 -0
similarity index 100%
rename from man/keyctl_pkey_verify.3
rename to man/man3/keyctl_pkey_verify.3
man/man3/keyctl_read.3 renamed from man/keyctl_read.3 +0 -0
similarity index 100%
rename from man/keyctl_read.3
rename to man/man3/keyctl_read.3
man/man3/keyctl_restrict_keyring.3 renamed from man/keyctl_restrict_keyring.3 +0 -0
similarity index 100%
rename from man/keyctl_restrict_keyring.3
rename to man/man3/keyctl_restrict_keyring.3
man/man3/keyctl_revoke.3 renamed from man/keyctl_revoke.3 +0 -0
similarity index 100%
rename from man/keyctl_revoke.3
rename to man/man3/keyctl_revoke.3
man/man3/keyctl_search.3 renamed from man/keyctl_search.3 +0 -0
similarity index 100%
rename from man/keyctl_search.3
rename to man/man3/keyctl_search.3
man/man3/keyctl_session_to_parent.3 renamed from man/keyctl_session_to_parent.3 +0 -0
similarity index 100%
rename from man/keyctl_session_to_parent.3
rename to man/man3/keyctl_session_to_parent.3
man/man3/keyctl_set_reqkey_keyring.3 renamed from man/keyctl_set_reqkey_keyring.3 +0 -0
similarity index 100%
rename from man/keyctl_set_reqkey_keyring.3
rename to man/man3/keyctl_set_reqkey_keyring.3
man/man3/keyctl_set_timeout.3 renamed from man/keyctl_set_timeout.3 +0 -0
similarity index 100%
rename from man/keyctl_set_timeout.3
rename to man/man3/keyctl_set_timeout.3
man/man3/keyctl_setperm.3 renamed from man/keyctl_setperm.3 +0 -0
similarity index 100%
rename from man/keyctl_setperm.3
rename to man/man3/keyctl_setperm.3
man/man3/keyctl_update.3 renamed from man/keyctl_update.3 +0 -0
similarity index 100%
rename from man/keyctl_update.3
rename to man/man3/keyctl_update.3
man/man3/keyctl_watch_key.3 renamed from man/keyctl_watch_key.3 +0 -0
similarity index 100%
rename from man/keyctl_watch_key.3
rename to man/man3/keyctl_watch_key.3
man/man3/recursive_key_scan.3 renamed from man/recursive_key_scan.3 +0 -0
similarity index 100%
rename from man/recursive_key_scan.3
rename to man/man3/recursive_key_scan.3
man/man5/key.dns_resolver.conf.5 renamed from man/key.dns_resolver.conf.5 +0 -0
similarity index 100%
rename from man/key.dns_resolver.conf.5
rename to man/man5/key.dns_resolver.conf.5
man/man5/request-key.conf.5 renamed from man/request-key.conf.5 +0 -0
similarity index 100%
rename from man/request-key.conf.5
rename to man/man5/request-key.conf.5
man/man7/asymmetric-key.7 renamed from man/asymmetric-key.7 +0 -0
similarity index 100%
rename from man/asymmetric-key.7
rename to man/man7/asymmetric-key.7
man/man7/keyutils.7 renamed from man/keyutils.7 +0 -0
similarity index 100%
rename from man/keyutils.7
rename to man/man7/keyutils.7
man/man8/key.dns_resolver.8 renamed from man/key.dns_resolver.8 +0 -0
similarity index 100%
rename from man/key.dns_resolver.8
rename to man/man8/key.dns_resolver.8
man/man8/request-key.8 renamed from man/request-key.8 +0 -0
similarity index 100%
rename from man/request-key.8
rename to man/man8/request-key.8
Signature · 1 line
2.45.2
#11 lore raw
In reply to Alejandro Colomar
Quoted 4 lines · Alejandro Colomar

Hi David,

Here's a set of fixes and improvements to the manual pages. I'm preparing a lot more, but I'll send these already to taste the waters.

Ping.

Quoted 111 lines

Have a lovely day!
Alex

*** BLURB HERE ***

Alejandro Colomar (10):
man/asymmetric-key.7: Use HISTORY instead of VERSIONS
man: Use the LIBRARY section
man: Fix TH arguments 4 and 5
man: Update date in TH
man: Use lowercase in TH 1st argument
man: Escape dashes in TH
man: Add SYNOPSYS section
man: Improve formatting of SYNOPSIS of commands man/keyctl.1: Improve formatting
man: Organize manual pages in subdirectories

 Makefile                                     |  10 +-
 man/{ => man1}/keyctl.1                      | 432 ++++++++++++++-----
 man/{ => man3}/find_key_by_type_and_name.3   |  11 +-
 man/{ => man3}/keyctl.3                      |  25 +-
 man/{ => man3}/keyctl_capabilities.3         |  13 +-
 man/{ => man3}/keyctl_chown.3                |  13 +-
 man/{ => man3}/keyctl_clear.3                |  13 +-
 man/{ => man3}/keyctl_describe.3             |  13 +-
 man/{ => man3}/keyctl_dh_compute.3           |  13 +-
 man/{ => man3}/keyctl_get_keyring_ID.3       |  13 +-
 man/{ => man3}/keyctl_get_persistent.3       |  13 +-
 man/{ => man3}/keyctl_get_security.3         |  13 +-
 man/{ => man3}/keyctl_instantiate.3          |  13 +-
 man/{ => man3}/keyctl_invalidate.3           |  13 +-
 man/{ => man3}/keyctl_join_session_keyring.3 |  13 +-
 man/{ => man3}/keyctl_link.3                 |  13 +-
 man/{ => man3}/keyctl_move.3                 |  13 +-
 man/{ => man3}/keyctl_pkey_decrypt.3         |   0
 man/{ => man3}/keyctl_pkey_encrypt.3         |  13 +-
 man/{ => man3}/keyctl_pkey_query.3           |  13 +-
 man/{ => man3}/keyctl_pkey_sign.3            |  13 +-
 man/{ => man3}/keyctl_pkey_verify.3          |   0
 man/{ => man3}/keyctl_read.3                 |  13 +-
 man/{ => man3}/keyctl_restrict_keyring.3     |  13 +-
 man/{ => man3}/keyctl_revoke.3               |  13 +-
 man/{ => man3}/keyctl_search.3               |  15 +-
 man/{ => man3}/keyctl_session_to_parent.3    |  13 +-
 man/{ => man3}/keyctl_set_reqkey_keyring.3   |  13 +-
 man/{ => man3}/keyctl_set_timeout.3          |  13 +-
 man/{ => man3}/keyctl_setperm.3              |  13 +-
 man/{ => man3}/keyctl_update.3               |  13 +-
 man/{ => man3}/keyctl_watch_key.3            |  13 +-
 man/{ => man3}/recursive_key_scan.3          |  11 +-
 man/{ => man5}/key.dns_resolver.conf.5       |   2 +-
 man/{ => man5}/request-key.conf.5            |   2 +-
 man/{ => man7}/asymmetric-key.7              |   4 +-
 man/{ => man7}/keyutils.7                    |  26 +-
 man/{ => man8}/key.dns_resolver.8            |   2 +-
 man/{ => man8}/request-key.8                 |  14 +-
 39 files changed, 498 insertions(+), 381 deletions(-)
 rename man/{ => man1}/keyctl.1 (89%)
 rename man/{ => man3}/find_key_by_type_and_name.3 (92%)
 rename man/{ => man3}/keyctl.3 (89%)
 rename man/{ => man3}/keyctl_capabilities.3 (94%)
 rename man/{ => man3}/keyctl_chown.3 (91%)
 rename man/{ => man3}/keyctl_clear.3 (89%)
 rename man/{ => man3}/keyctl_describe.3 (93%)
 rename man/{ => man3}/keyctl_dh_compute.3 (95%)
 rename man/{ => man3}/keyctl_get_keyring_ID.3 (92%)
 rename man/{ => man3}/keyctl_get_persistent.3 (93%)
 rename man/{ => man3}/keyctl_get_security.3 (93%)
 rename man/{ => man3}/keyctl_instantiate.3 (96%)
 rename man/{ => man3}/keyctl_invalidate.3 (90%)
 rename man/{ => man3}/keyctl_join_session_keyring.3 (91%)
 rename man/{ => man3}/keyctl_link.3 (92%)
 rename man/{ => man3}/keyctl_move.3 (92%)
 rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%)
 rename man/{ => man3}/keyctl_pkey_encrypt.3 (94%)
 rename man/{ => man3}/keyctl_pkey_query.3 (94%)
 rename man/{ => man3}/keyctl_pkey_sign.3 (95%)
 rename man/{ => man3}/keyctl_pkey_verify.3 (100%)
 rename man/{ => man3}/keyctl_read.3 (94%)
 rename man/{ => man3}/keyctl_restrict_keyring.3 (91%)
 rename man/{ => man3}/keyctl_revoke.3 (89%)
 rename man/{ => man3}/keyctl_search.3 (93%)
 rename man/{ => man3}/keyctl_session_to_parent.3 (91%)
 rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (93%)
 rename man/{ => man3}/keyctl_set_timeout.3 (90%)
 rename man/{ => man3}/keyctl_setperm.3 (94%)
 rename man/{ => man3}/keyctl_update.3 (91%)
 rename man/{ => man3}/keyctl_watch_key.3 (95%)
 rename man/{ => man3}/recursive_key_scan.3 (95%)
 rename man/{ => man5}/key.dns_resolver.conf.5 (95%)
 rename man/{ => man5}/request-key.conf.5 (98%)
 rename man/{ => man7}/asymmetric-key.7 (99%)
 rename man/{ => man7}/keyutils.7 (89%)
 rename man/{ => man8}/key.dns_resolver.8 (95%)
 rename man/{ => man8}/request-key.8 (92%)

Range-diff against v0:

 -:  ------- >  1:  ec0c2fa man/asymmetric-key.7: Use HISTORY instead of VERSIONS
 -:  ------- >  2:  8f02c27 man: Use the LIBRARY section
 -:  ------- >  3:  e3e616f man: Fix TH arguments 4 and 5
 -:  ------- >  4:  7762f59 man: Update date in TH
 -:  ------- >  5:  7294951 man: Use lowercase in TH 1st argument
 -:  ------- >  6:  3d6ef97 man: Escape dashes in TH
 -:  ------- >  7:  5794916 man: Add SYNOPSYS section
 -:  ------- >  8:  30c25a7 man: Improve formatting of SYNOPSIS of commands
 -:  ------- >  9:  ae1e052 man/keyctl.1: Improve formatting
 -:  ------- > 10:  93e44ce man: Organize manual pages in subdirectories
Signature · 1 line
2.45.2
Signature · 1 line
<https://www.alejandro-colomar.es/>