summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2022-05-11 11:23:58 -0600
committerKarl Williamson <khw@cpan.org>2022-05-11 15:02:44 -0600
commit2ec51eaf546e3a625ae6c3f5a49087554b65a0ee (patch)
treed35ad1f2f0e5369443e50d8b96a210e686202173
parent02cb41614a1110d29f53f2ec38a6a5da36e9a917 (diff)
downloadperl-2ec51eaf546e3a625ae6c3f5a49087554b65a0ee.tar.gz
perlapi: Add some commentary for rsignal()
-rw-r--r--t/porting/known_pod_issues.dat1
-rw-r--r--util.c6
2 files changed, 5 insertions, 2 deletions
diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat
index cd9ada9f0a..ef2ad55e36 100644
--- a/t/porting/known_pod_issues.dat
+++ b/t/porting/known_pod_issues.dat
@@ -310,6 +310,7 @@ sha1sum(1)
shadow(3)
Shell
Shell::Command
+sigaction(2)
signal(2)
sleep(3)
sock_init(3)
diff --git a/util.c b/util.c
index a0bc237996..80b94654d6 100644
--- a/util.c
+++ b/util.c
@@ -3123,8 +3123,10 @@ dup2(int oldfd, int newfd)
=for apidoc_section $signals
=for apidoc rsignal
-A wrapper for the C library L<signal(2)>. Don't use the latter, as the Perl
-version knows things that interact with the rest of the perl interpreter.
+A wrapper for the C library functions L<sigaction(2)> or L<signal(2)>.
+Use this instead of those libc functions, as the Perl version gives the
+safest available implementation, and knows things that interact with the
+rest of the perl interpreter.
=cut
*/