[PATCH] man/man7/signal.7: Update definition of SIGCHLD

[PATCH] man/man7/signal.7: Update definition of SIGCHLD

[Arkadiusz Drabczyk]

Link: <https://unix.stackexchange.com/q/790116/72304>
Link: <https://lore.kernel.org/linux-man/Z5U0Wh_KF3Ki62Pk@comp../>
Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
---
 man/man7/signal.7 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/man/man7/signal.7 b/man/man7/signal.7
index dd04c6d1a..d2929dab1 100644
--- a/man/man7/signal.7
+++ b/man/man7/signal.7
@@ -360,7 +360,8 @@ Linux supports the standard signals listed below.
 The second column of the table indicates which standard (if any)
 specified the signal: "P1990" indicates that the signal is described
 in the original POSIX.1-1990 standard;
-"P2001" indicates that the signal was added in SUSv2 and POSIX.1-2001.
+"P2001" indicates that the signal was added or its definition changed
+in SUSv2 and POSIX.1-2001.
 .TS
 l c c l
 ____
@@ -369,7 +370,7 @@ Signal	Standard	Action	Comment
 SIGABRT	P1990	Core	Abort signal from \fBabort\fP(3)
 SIGALRM	P1990	Term	Timer signal from \fBalarm\fP(2)
 SIGBUS	P2001	Core	Bus error (bad memory access)
-SIGCHLD	P1990	Ign	Child stopped or terminated
+SIGCHLD	P2001	Ign	Child stopped, terminated or continued
 SIGCLD	\-	Ign	A synonym for \fBSIGCHLD\fP
 SIGCONT	P1990	Cont	Continue if stopped
 SIGEMT	\-	Term	Emulator trap
-- 
2.45.2

Re: [PATCH] man/man7/signal.7: Update definition of SIGCHLD

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1763 bytes --]

Hi Arkadiusz,

On Sun, Feb 02, 2025 at 01:11:12PM +0100, Arkadiusz Drabczyk wrote:
> Link: <https://unix.stackexchange.com/q/790116/72304>
> Link: <https://lore.kernel.org/linux-man/Z5U0Wh_KF3Ki62Pk@comp../>
> Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
> ---
>  man/man7/signal.7 | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
> 
> diff --git a/man/man7/signal.7 b/man/man7/signal.7
> index dd04c6d1a..d2929dab1 100644
> --- a/man/man7/signal.7
> +++ b/man/man7/signal.7
> @@ -360,7 +360,8 @@ Linux supports the standard signals listed below.
>  The second column of the table indicates which standard (if any)
>  specified the signal: "P1990" indicates that the signal is described
>  in the original POSIX.1-1990 standard;
> -"P2001" indicates that the signal was added in SUSv2 and POSIX.1-2001.
> +"P2001" indicates that the signal was added or its definition changed
> +in SUSv2 and POSIX.1-2001.

Thanks!

>  .TS
>  l c c l
>  ____
> @@ -369,7 +370,7 @@ Signal	Standard	Action	Comment
>  SIGABRT	P1990	Core	Abort signal from \fBabort\fP(3)
>  SIGALRM	P1990	Term	Timer signal from \fBalarm\fP(2)
>  SIGBUS	P2001	Core	Bus error (bad memory access)
> -SIGCHLD	P1990	Ign	Child stopped or terminated
> +SIGCHLD	P2001	Ign	Child stopped, terminated or continued

Please add a comma before the 'or' (Oxford comma).  Other than that, it
LGTM.  Do you know if there are any other XSI extensions documented here
and what we do with them?  It would be interesting to be consistent
about that.


Cheers,
Alex

>  SIGCLD	\-	Ign	A synonym for \fBSIGCHLD\fP
>  SIGCONT	P1990	Cont	Continue if stopped
>  SIGEMT	\-	Term	Emulator trap
> -- 
> 2.45.2
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH] man/man7/signal.7: Update definition of SIGCHLD

[Arkadiusz Drabczyk]

On Sun, Feb 02, 2025 at 01:30:00PM +0100, Alejandro Colomar wrote:
> Please add a comma before the 'or' (Oxford comma).  Other than that, it
> LGTM.  Do you know if there are any other XSI extensions documented here
> and what we do with them?  It would be interesting to be consistent
> about that.

No, I don't. It would require a lot of manual work to go through all
of them but I agree that it's a job that needs to be done.

-- 
Arkadiusz Drabczyk <arkadiusz@drabczyk.org>

Re: [PATCH] man/man7/signal.7: Update definition of SIGCHLD

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1076 bytes --]

Hi Arkadiusz,

On Sun, Feb 02, 2025 at 02:06:43PM +0100, Arkadiusz Drabczyk wrote:
> On Sun, Feb 02, 2025 at 01:30:00PM +0100, Alejandro Colomar wrote:
> > Please add a comma before the 'or' (Oxford comma).  Other than that, it
> > LGTM.  Do you know if there are any other XSI extensions documented here
> > and what we do with them?  It would be interesting to be consistent
> > about that.
> 
> No, I don't. It would require a lot of manual work to go through all
> of them but I agree that it's a job that needs to be done.

Hmm, I've done it now and it wasn't that bad.  There seem to only be 3
signals that are specified as XSI extensions.

<https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/signal.h.html>

Apart from this SIGCHLD extension, there are:

	SIGSYS		A	Bad system call.
	SIGVTALRM	T	Virtual timer expired.

And we document them normally, without saying anything about them being
XSI extensions.  So I guess it's just fine to not do it with SIGCHLD.

Nice!  :)


Cheers,
Alex

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2] man/man7/signal.7: Update definition of SIGCHLD

[Arkadiusz Drabczyk]

Link: <https://unix.stackexchange.com/q/790116/72304>
Link: <https://lore.kernel.org/linux-man/Z5U0Wh_KF3Ki62Pk@comp../>
Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
---
 man/man7/signal.7 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/man/man7/signal.7 b/man/man7/signal.7
index dd04c6d1a..83251e071 100644
--- a/man/man7/signal.7
+++ b/man/man7/signal.7
@@ -360,7 +360,8 @@ Linux supports the standard signals listed below.
 The second column of the table indicates which standard (if any)
 specified the signal: "P1990" indicates that the signal is described
 in the original POSIX.1-1990 standard;
-"P2001" indicates that the signal was added in SUSv2 and POSIX.1-2001.
+"P2001" indicates that the signal was added or its definition changed
+in SUSv2 and POSIX.1-2001.
 .TS
 l c c l
 ____
@@ -369,7 +370,7 @@ Signal	Standard	Action	Comment
 SIGABRT	P1990	Core	Abort signal from \fBabort\fP(3)
 SIGALRM	P1990	Term	Timer signal from \fBalarm\fP(2)
 SIGBUS	P2001	Core	Bus error (bad memory access)
-SIGCHLD	P1990	Ign	Child stopped or terminated
+SIGCHLD	P2001	Ign	Child stopped, terminated, or continued
 SIGCLD	\-	Ign	A synonym for \fBSIGCHLD\fP
 SIGCONT	P1990	Cont	Continue if stopped
 SIGEMT	\-	Term	Emulator trap
-- 
2.45.2

Re: [PATCH v2] man/man7/signal.7: Update definition of SIGCHLD

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1692 bytes --]

Hi Arkadiusz,

On Sun, Feb 02, 2025 at 02:03:31PM +0100, Arkadiusz Drabczyk wrote:
> Link: <https://unix.stackexchange.com/q/790116/72304>
> Link: <https://lore.kernel.org/linux-man/Z5U0Wh_KF3Ki62Pk@comp../>
> Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>

Thanks!  I've applied the patch.
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=ac93c406a779bd0def5817d78c30f8a25bb318b9>


Cheers,
Alex

> ---
>  man/man7/signal.7 | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
> 
> diff --git a/man/man7/signal.7 b/man/man7/signal.7
> index dd04c6d1a..83251e071 100644
> --- a/man/man7/signal.7
> +++ b/man/man7/signal.7
> @@ -360,7 +360,8 @@ Linux supports the standard signals listed below.
>  The second column of the table indicates which standard (if any)
>  specified the signal: "P1990" indicates that the signal is described
>  in the original POSIX.1-1990 standard;
> -"P2001" indicates that the signal was added in SUSv2 and POSIX.1-2001.
> +"P2001" indicates that the signal was added or its definition changed
> +in SUSv2 and POSIX.1-2001.
>  .TS
>  l c c l
>  ____
> @@ -369,7 +370,7 @@ Signal	Standard	Action	Comment
>  SIGABRT	P1990	Core	Abort signal from \fBabort\fP(3)
>  SIGALRM	P1990	Term	Timer signal from \fBalarm\fP(2)
>  SIGBUS	P2001	Core	Bus error (bad memory access)
> -SIGCHLD	P1990	Ign	Child stopped or terminated
> +SIGCHLD	P2001	Ign	Child stopped, terminated, or continued
>  SIGCLD	\-	Ign	A synonym for \fBSIGCHLD\fP
>  SIGCONT	P1990	Cont	Continue if stopped
>  SIGEMT	\-	Term	Emulator trap
> -- 
> 2.45.2
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]