util-linux.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 1/5] Manual pages: kill.1: various language, spelling, and formatting fixes
@ 2020-05-25 12:59 Michael Kerrisk (man-pages)
  2020-05-25 12:59 ` [PATCH 2/5] Manual pages: kill.1: improve the description of the --timout option Michael Kerrisk (man-pages)
                   ` (4 more replies)
  0 siblings, 5 replies; 6+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-05-25 12:59 UTC (permalink / raw)
  To: mtk.manpages, Karel Zak; +Cc: util-linux

These seem all "obviously correct", so I'm rolling them up into
one patch.

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 misc-utils/kill.1 | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/misc-utils/kill.1 b/misc-utils/kill.1
index 6fd50036d..1c12f8a14 100644
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.1
@@ -34,7 +34,9 @@ then the KILL signal may be used; be aware that the latter signal
 cannot be caught, and so does not give the target process the opportunity
 to perform any clean-up before terminating.
 .PP
-Most modern shells have a builtin kill command, with a usage rather similar to
+Most modern shells have a builtin
+.B kill
+command, with a usage rather similar to
 that of the command described here.  The
 .BR \-\-all ,
 .BR \-\-pid ", and"
@@ -49,7 +51,7 @@ The list of processes to be signaled can be a mixture of names and PIDs.
 .I pid
 Each
 .I pid
-can be one of four things:
+can be expressed in one of the following ways:
 .RS
 .TP
 .I n
@@ -87,7 +89,7 @@ The signal to send.  It may be given as a name or a number.
 \fB\-l\fR, \fB\-\-list\fR [\fInumber\fR]
 Print a list of signal names, or convert the given signal number to a name.
 The signals can be found in
-.I /usr/\:include/\:linux/\:signal.h
+.IR /usr/\:include/\:linux/\:signal.h .
 .TP
 \fB\-L\fR, \fB\-\-table\fR
 Similar to \fB\-l\fR, but it will print signal names and their corresponding
@@ -102,10 +104,12 @@ Only print the process ID (PID) of the named processes, do not send any
 signals.
 .TP
 \fB\-\-verbose\fR
-Print PID(s) that will be signaled with kill along with the signal.
+Print PID(s) that will be signaled with
+.B kill
+along with the signal.
 .TP
 \fB\-q\fR, \fB\-\-queue\fR \fIvalue\fR
-Use
+Send the signal using
 .BR sigqueue (3)
 rather than
 .BR kill (2).
@@ -132,7 +136,7 @@ to wait for a period defined in
 before sending follow-up
 .I signal
 to process.
-This feature is implemented by PID file-descriptor and guaranties that
+This feature is implemented by PID file-descriptor and guarantees that
 follow-up signals are sent to the same process or not sent if the process no
 more exist.  Note that the operating system may re-use PIDs and implement the
 same feature in a shell by kill and sleep commands sequence may introduce a
@@ -182,11 +186,14 @@ and the description of
 in
 .BR clone (2).
 .P
-Various shells have provide an internal kill implementation that is
+Various shells provide a builtin
+.B kill
+command that is
 preferred in relation to the
 .BR kill (1)
-executable described by this manual.  Easiest way to ensure one is executing
-the executable is to use full path when calling the command, for example:
+executable described by this manual.
+The easiest way to ensure one is executing the command described in this page
+is to use the full path when calling the command, for example:
 .B "/bin/kill \-\-version"
 .SH AUTHORS
 .MT svalente@mit.edu
-- 
2.26.2


^ permalink raw reply related	[flat|nested] 6+ messages in thread
end of thread, other threads:[~2020-05-28 12:53 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-05-25 12:59 [PATCH 1/5] Manual pages: kill.1: various language, spelling, and formatting fixes Michael Kerrisk (man-pages)
2020-05-25 12:59 ` [PATCH 2/5] Manual pages: kill.1: improve the description of the --timout option Michael Kerrisk (man-pages)
2020-05-25 12:59 ` [PATCH 3/5] Manual pages: ipcmk.1, ipcrm.1, ipcs.1, lsipc.1: SEE ALSO: add sysvipc(7) Michael Kerrisk (man-pages)
2020-05-25 12:59 ` [PATCH 4/5] Man pages: ipcmk.1, ipcs.1, lsipc.1: explicitly mention "System V" Michael Kerrisk (man-pages)
2020-05-25 12:59 ` [PATCH 5/5] Manual pages: rename EXAMPLE section to EXAMPLES Michael Kerrisk (man-pages)
2020-05-28 12:53 ` [PATCH 1/5] Manual pages: kill.1: various language, spelling, and formatting fixes Karel Zak

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).