kill: Adjust documentation for sigqueue

Added NEWS item
Changed the section for sigqueue as its 3 for me.

diff --git a/NEWS b/NEWS
index 58e689cd04aac75f5698f69489c58b7f058bd6d7..feef020ce3910be0aedf6fe4a15ff931863a1cb7 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,6 @@
 procps-ng NEXT
 --------------
+  * kill: Pass int to signalled process                    merge #32
   * pgrep: Check sanity of SG_ARG_MAX                      issue #152
   * pidof: show worker threads                             Redhat #1803640
   * ps.1: Mention stime alias                              issue #164

diff --git a/kill.1 b/kill.1
index a487f917b460d1fca827f6ea03d5ed67150e7a11..62be918d685dcb6b1f4cc517049efb5f3bf91cd8 100644 (file)
--- a/kill.1
+++ b/kill.1
@@ -44,6 +44,18 @@ The behavior of signals is explained in
 .BR signal (7)
 manual page.
 .TP
+\fB\-q\fR, \fB\-\-queue \fIvalue\fP
+Use
+.BR sigqueue(3)
+rather than
+.BR kill(2)
+and the value argument is used to specify
+an integer to be sent with the signal. If the receiving process has
+installed a handler for this signal using the SA_SIGINFO flag to
+.BR sigaction(2)
+, then it can obtain this data via the si_value field of the
+siginfo_t structure.
+.TP
 \fB\-l\fR, \fB\-\-list\fR [\fIsignal\fR]
 List signal names.  This option has optional argument, which
 will convert signal number to signal name, or other way round.
@@ -76,6 +88,7 @@ Send the default signal, SIGTERM, to all those processes.
 .BR pkill (1),
 .BR renice (1),
 .BR signal (7),
+.BR sigqueue (3),
 .BR skill (1)
 .SH STANDARDS
 This command meets appropriate standards. The