This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Improve description of is_safe_syscall()
authorKarl Williamson <khw@cpan.org>
Thu, 12 Sep 2019 20:23:18 +0000 (14:23 -0600)
committerKarl Williamson <khw@cpan.org>
Sun, 15 Sep 2019 16:39:56 +0000 (10:39 -0600)
Two parameters weren't described, nor the warnings category used.

inline.h

index 5a4729a..aa4e7b8 100644 (file)
--- a/inline.h
+++ b/inline.h
@@ -1892,11 +1892,15 @@ Perl_utf8_to_uvchr_buf_helper(pTHX_ const U8 *s, const U8 *send, STRLEN *retlen)
 
 =for apidoc is_safe_syscall
 
-Test that the given C<pv> doesn't contain any internal C<NUL> characters.
-If it does, set C<errno> to C<ENOENT>, optionally warn, and return FALSE.
+Test that the given C<pv> (with length C<len>) doesn't contain any internal
+C<NUL> characters.
+If it does, set C<errno> to C<ENOENT>, optionally warn using the C<syscalls>
+category, and return FALSE.
 
 Return TRUE if the name is safe.
 
+C<what> and C<op_name> are used in any warning.
+
 Used by the C<IS_SAFE_SYSCALL()> macro.
 
 =cut