perlapi: Combine is_safe_syscall, IS_SAFE_SYSCALL

Author: khwilliamson

inline.h

@@ -3289,9 +3289,12 @@ Perl_uv_to_utf8_flags(pTHX_ U8 *d, UV uv, UV flags)
 /*
 =for apidoc_section $utility
 
-=for apidoc is_safe_syscall
+=for apidoc        is_safe_syscall
+=for apidoc_item ||IS_SAFE_SYSCALL|
 
-Test that the given C<pv> (with length C<len>) doesn't contain any internal
+These are synonymous.
+
+They 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.
@@ -3300,8 +3303,6 @@ 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
 */
 

perl.h

@@ -8411,17 +8411,7 @@ so no C<x++>.
 #endif
 
 
-/*
-=for apidoc_section $utility
-
-=for apidoc Am|bool|IS_SAFE_SYSCALL|NN const char *pv|STRLEN len|NN const char *what|NN const char *op_name
-
-Same as L</is_safe_syscall>.
-
-=cut
-
-Allows one ending \0
-*/
+/* Allows one ending \0 */
 #define IS_SAFE_SYSCALL(p, len, what, op_name) (Perl_is_safe_syscall(aTHX_ (p), (len), (what), (op_name)))
 
 #define IS_SAFE_PATHNAME(p, len, op_name) IS_SAFE_SYSCALL((p), (len), "pathname", (op_name))