kill: (man) improve PID:inode description

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

diff --git a/misc-utils/kill.1.adoc b/misc-utils/kill.1.adoc
index 6c5da13e0d24281ff5571730368e4d4290f83d86..05247c285a852e0834a3338a81628de588dce375 100644 (file)
--- a/misc-utils/kill.1.adoc
+++ b/misc-utils/kill.1.adoc
@@ -19,13 +19,13 @@ kill - terminate a process
 
 == SYNOPSIS
 
-*kill*  [**-**_signal_|*-s* _signal_|*-p*]  [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _pid_|_pid_:_pidfd_inode_|_name_...
+*kill*  [**-**_signal_|*-s* _signal_|*-p*]  [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _PID_[:_inode_]...
 
-*kill*  [**-**_signal_|*-s* _signal_] _pid_|_pid_:_pidfd_inode_...
+*kill*  [**-**_signal_|*-s* _signal_] _PID_[:_inode_]...
 
 *kill* *-l* [_number_|``0x``_sigmask_] | *-L*
 
-*kill* *-d* _pid_
+*kill* *-d* _PID_[:_inode_]
 
 == DESCRIPTION
 
@@ -41,8 +41,8 @@ If _signal_ is 0, then no actual signal is sent, but error checking is still per
 
 The list of processes to be signaled can be a mixture of names and PIDs.
 
-_pid_::
-Each _pid_ can be expressed in one of the following ways:
+_PID_::
+Each _PID_ can be expressed in one of the following ways:
 _n_;;
 where _n_ is larger than 0. The process with PID _n_ is signaled.
 *0*;;
@@ -52,8 +52,9 @@ All processes with a PID larger than 1 are signaled.
 **-**__n__;;
 where _n_ is larger than 1. All processes in process group _n_ are signaled. When an argument of the form '-n' is given, and it is meant to denote a process group, either a signal must be specified first, or the argument must be preceded by a '--' option, otherwise it will be taken as the signal to send.
 
-_pid_:_pidfd_inode_::
-A process can be referenced by its _pid_ plus _pidfd_inode_ (pid:pidfd_inode), to uniquely identify it and perform race-free signalling. This works only for the options -s, --signal and -_signal_. Requires kernel version 6.9 and later.
+_PID_:_inode_::
+A process can be referenced with the format *PID:inode*, where the _inode_ uniquely identifies the process identity in the pidfs. This feature enables race-free process signalling and requires kernel version 6.9 or later.
+Note that this only works for the option *--signal* and the *-_signal_* notation. Lastly, to retrieve a process's inode number you can use the *getino*(1) utility.
 
 _name_::
 All processes invoked using this _name_ will be signaled.
@@ -144,12 +145,13 @@ The original version was taken from BSD 4.4.
 
 *bash*(1),
 *tcsh*(1),
+*getino*(1),
 *sigaction*(2),
 *kill*(2),
 *sigqueue*(3),
-*signal*(7)
-*proc(5)*
-*proc_pid_status(5)*
+*signal*(7),
+*proc*(5),
+*proc_pid_status*(5)
 
 include::man-common/bugreports.adoc[]