Skip to contentSkip to conversation

man/man2/kill.2: Wording issue in kill(2) with sig=0

PATCH In review Amit Pinhas 2 participants 2 messages Feb 12, 2025 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#1 lore raw

PATCH v4 1/1 man/man2/kill.2: Wording issue in kill(2) with sig=0

In reply to a message not in the archive

The fix was found from the relevant man page itself, as it had a wording issue regarding the return value when sig=0.

---
 man/man2/kill.2 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/kill.2 +3 -1
index 96468622e..9d3a7411e 100644
@@ -79,7 +79,9 @@ .SH DESCRIPTION
 processes belong to the same session.
 (Historically, the rules were different; see HISTORY.)
 .SH RETURN VALUE
-On success (at least one signal was sent), zero is returned.
+On success, zero is returned.
+If signals were sent to a process group,
+success means that at least one signal was delivered.
 On error, \-1 is returned, and
 .I errno
 is set to indicate the error.
Signature · 1 line
2.43.0
#2 lore raw

Hi Amit,

Quoted 6 lines · Amit Pinhas

The fix was found from the relevant man page itself, as it had a wording issue regarding the return value when sig=0.

Thanks! This patch looks great. I've applied it. I applied some tweaks to the commit message, to better document the rationale:
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=71154d16c5b5fe09b46acdfdf7c8a57f8f2fb892>

I had plans to release a new version today, but haven't had time. I'll release hopefully later this week. Thanks for contributing!

Have a lovely night!
Alex

Quoted 23 lines
---
 man/man2/kill.2 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/kill.2 +3 -1
index 96468622e..9d3a7411e 100644
@@ -79,7 +79,9 @@ .SH DESCRIPTION
 processes belong to the same session.
 (Historically, the rules were different; see HISTORY.)
 .SH RETURN VALUE
-On success (at least one signal was sent), zero is returned.
+On success, zero is returned.
+If signals were sent to a process group,
+success means that at least one signal was delivered.
 On error, \-1 is returned, and
 .I errno
 is set to indicate the error.
Signature · 1 line
2.43.0
Signature · 1 line
<https://www.alejandro-colomar.es/>