From: Sami Kerola <kerolasa@iki.fi>
Date: Sun, 22 Mar 2020 09:37:41 +0000 (+0000)
Subject: docs: kill.1 add note about shell-internal kill implementations
X-Git-Tag: v2.35.2~35
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=9bfed00d920d1a40c0eaed15147fa2dddc392390;p=thirdparty%2Futil-linux.git

docs: kill.1 add note about shell-internal kill implementations

Requested-by: Ilia Baryshnikov <qwelias@gmail.com>
Reference: https://github.com/karelzak/util-linux/issues/991#issuecomment-602108648
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
---

diff --git a/misc-utils/kill.1 b/misc-utils/kill.1
index 24cfe79990..65872ce197 100644
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.1
@@ -164,10 +164,19 @@ and the description of
 .B CLONE_THREAD
 in
 .BR clone (2).
-
+.P
+Various shells have provide an internal kill implementation 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:
+.BR "/bin/kill --version"
 .SH RETURN CODES
 .B kill
 has the following return codes:
+.PP
+.RS
+.PD 0
 .TP
 .B 0
 success
@@ -177,7 +186,8 @@ failure
 .TP
 .B 64
 partial success (when more than one process specified)
-
+.PD
+.RE
 .SH SEE ALSO
 .BR bash (1),
 .BR tcsh (1),