This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
regen/warnings.pl: Move some hidden pod
authorKarl Williamson <khw@cpan.org>
Sun, 16 Aug 2020 12:35:04 +0000 (06:35 -0600)
committerKarl Williamson <khw@cpan.org>
Fri, 4 Sep 2020 22:54:58 +0000 (16:54 -0600)
This is a long list of warning categories which doesn't print, but
exists to indicate to downstream tools, such as Devel::PPPort that these
categories exist and are documented.  Move them to the end of the file
so as to make the meat of things flow better.

regen/warnings.pl
warnings.h

index f813d93..99a765a 100644 (file)
@@ -371,10 +371,6 @@ EOM
       push @names, $name;
       $last_ver = $version ;
   }
-  print $warn "\n\n/*\n" ;
-
-  print $warn map { "=for apidoc Amnh||$_\n" } @names;
-  print $warn "\n=cut\n*/\n\n" ;
 
   print $warn tab(6, '#define WARNsize'),      " $warn_size\n" ;
   print $warn tab(6, '#define WARN_ALLstring'), ' "', ('\125' x $warn_size) , "\"\n" ;
@@ -484,9 +480,13 @@ category parameters passed.
              (unpackWARN4(x) &&                                        \
                isWARNf_on(PL_curcop->cop_warnings, unpackWARN4(x)))))))))
 
-/* end of file warnings.h */
 EOM
 
+  print $warn "\n\n/*\n" ;
+  print $warn map { "=for apidoc Amnh||$_\n" } @names;
+  print $warn "\n=cut\n*/\n\n" ;
+  print $warn "/* end of file warnings.h */\n";
+
   read_only_bottom_close_and_rename($warn);
 }
 
index 0f7d7eb..f2008fe 100644 (file)
 /* Warnings Categories added in Perl 5.031 */
 
 #define WARN_EXPERIMENTAL__ISA          73
-
-
-/*
-=for apidoc Amnh||WARN_ALL
-=for apidoc Amnh||WARN_CLOSURE
-=for apidoc Amnh||WARN_DEPRECATED
-=for apidoc Amnh||WARN_EXITING
-=for apidoc Amnh||WARN_GLOB
-=for apidoc Amnh||WARN_IO
-=for apidoc Amnh||WARN_CLOSED
-=for apidoc Amnh||WARN_EXEC
-=for apidoc Amnh||WARN_LAYER
-=for apidoc Amnh||WARN_NEWLINE
-=for apidoc Amnh||WARN_PIPE
-=for apidoc Amnh||WARN_UNOPENED
-=for apidoc Amnh||WARN_MISC
-=for apidoc Amnh||WARN_NUMERIC
-=for apidoc Amnh||WARN_ONCE
-=for apidoc Amnh||WARN_OVERFLOW
-=for apidoc Amnh||WARN_PACK
-=for apidoc Amnh||WARN_PORTABLE
-=for apidoc Amnh||WARN_RECURSION
-=for apidoc Amnh||WARN_REDEFINE
-=for apidoc Amnh||WARN_REGEXP
-=for apidoc Amnh||WARN_SEVERE
-=for apidoc Amnh||WARN_DEBUGGING
-=for apidoc Amnh||WARN_INPLACE
-=for apidoc Amnh||WARN_INTERNAL
-=for apidoc Amnh||WARN_MALLOC
-=for apidoc Amnh||WARN_SIGNAL
-=for apidoc Amnh||WARN_SUBSTR
-=for apidoc Amnh||WARN_SYNTAX
-=for apidoc Amnh||WARN_AMBIGUOUS
-=for apidoc Amnh||WARN_BAREWORD
-=for apidoc Amnh||WARN_DIGIT
-=for apidoc Amnh||WARN_PARENTHESIS
-=for apidoc Amnh||WARN_PRECEDENCE
-=for apidoc Amnh||WARN_PRINTF
-=for apidoc Amnh||WARN_PROTOTYPE
-=for apidoc Amnh||WARN_QW
-=for apidoc Amnh||WARN_RESERVED
-=for apidoc Amnh||WARN_SEMICOLON
-=for apidoc Amnh||WARN_TAINT
-=for apidoc Amnh||WARN_THREADS
-=for apidoc Amnh||WARN_UNINITIALIZED
-=for apidoc Amnh||WARN_UNPACK
-=for apidoc Amnh||WARN_UNTIE
-=for apidoc Amnh||WARN_UTF8
-=for apidoc Amnh||WARN_VOID
-=for apidoc Amnh||WARN_IMPRECISION
-=for apidoc Amnh||WARN_ILLEGALPROTO
-=for apidoc Amnh||WARN_NON_UNICODE
-=for apidoc Amnh||WARN_NONCHAR
-=for apidoc Amnh||WARN_SURROGATE
-=for apidoc Amnh||WARN_EXPERIMENTAL
-=for apidoc Amnh||WARN_EXPERIMENTAL__LEXICAL_SUBS
-=for apidoc Amnh||WARN_EXPERIMENTAL__REGEX_SETS
-=for apidoc Amnh||WARN_EXPERIMENTAL__SMARTMATCH
-=for apidoc Amnh||WARN_EXPERIMENTAL__POSTDEREF
-=for apidoc Amnh||WARN_EXPERIMENTAL__SIGNATURES
-=for apidoc Amnh||WARN_SYSCALLS
-=for apidoc Amnh||WARN_EXPERIMENTAL__BITWISE
-=for apidoc Amnh||WARN_EXPERIMENTAL__CONST_ATTR
-=for apidoc Amnh||WARN_EXPERIMENTAL__RE_STRICT
-=for apidoc Amnh||WARN_EXPERIMENTAL__REFALIASING
-=for apidoc Amnh||WARN_EXPERIMENTAL__WIN32_PERLIO
-=for apidoc Amnh||WARN_LOCALE
-=for apidoc Amnh||WARN_MISSING
-=for apidoc Amnh||WARN_REDUNDANT
-=for apidoc Amnh||WARN_EXPERIMENTAL__DECLARED_REFS
-=for apidoc Amnh||WARN_EXPERIMENTAL__ALPHA_ASSERTIONS
-=for apidoc Amnh||WARN_EXPERIMENTAL__SCRIPT_RUN
-=for apidoc Amnh||WARN_SHADOW
-=for apidoc Amnh||WARN_EXPERIMENTAL__PRIVATE_USE
-=for apidoc Amnh||WARN_EXPERIMENTAL__UNIPROP_WILDCARDS
-=for apidoc Amnh||WARN_EXPERIMENTAL__VLB
-=for apidoc Amnh||WARN_EXPERIMENTAL__ISA
-
-=cut
-*/
-
 #define WARNsize                        19
 #define WARN_ALLstring                  "\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125"
 #define WARN_NONEstring                         "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"
@@ -317,6 +236,87 @@ category parameters passed.
              (unpackWARN4(x) &&                                        \
                isWARNf_on(PL_curcop->cop_warnings, unpackWARN4(x)))))))))
 
+
+
+/*
+=for apidoc Amnh||WARN_ALL
+=for apidoc Amnh||WARN_CLOSURE
+=for apidoc Amnh||WARN_DEPRECATED
+=for apidoc Amnh||WARN_EXITING
+=for apidoc Amnh||WARN_GLOB
+=for apidoc Amnh||WARN_IO
+=for apidoc Amnh||WARN_CLOSED
+=for apidoc Amnh||WARN_EXEC
+=for apidoc Amnh||WARN_LAYER
+=for apidoc Amnh||WARN_NEWLINE
+=for apidoc Amnh||WARN_PIPE
+=for apidoc Amnh||WARN_UNOPENED
+=for apidoc Amnh||WARN_MISC
+=for apidoc Amnh||WARN_NUMERIC
+=for apidoc Amnh||WARN_ONCE
+=for apidoc Amnh||WARN_OVERFLOW
+=for apidoc Amnh||WARN_PACK
+=for apidoc Amnh||WARN_PORTABLE
+=for apidoc Amnh||WARN_RECURSION
+=for apidoc Amnh||WARN_REDEFINE
+=for apidoc Amnh||WARN_REGEXP
+=for apidoc Amnh||WARN_SEVERE
+=for apidoc Amnh||WARN_DEBUGGING
+=for apidoc Amnh||WARN_INPLACE
+=for apidoc Amnh||WARN_INTERNAL
+=for apidoc Amnh||WARN_MALLOC
+=for apidoc Amnh||WARN_SIGNAL
+=for apidoc Amnh||WARN_SUBSTR
+=for apidoc Amnh||WARN_SYNTAX
+=for apidoc Amnh||WARN_AMBIGUOUS
+=for apidoc Amnh||WARN_BAREWORD
+=for apidoc Amnh||WARN_DIGIT
+=for apidoc Amnh||WARN_PARENTHESIS
+=for apidoc Amnh||WARN_PRECEDENCE
+=for apidoc Amnh||WARN_PRINTF
+=for apidoc Amnh||WARN_PROTOTYPE
+=for apidoc Amnh||WARN_QW
+=for apidoc Amnh||WARN_RESERVED
+=for apidoc Amnh||WARN_SEMICOLON
+=for apidoc Amnh||WARN_TAINT
+=for apidoc Amnh||WARN_THREADS
+=for apidoc Amnh||WARN_UNINITIALIZED
+=for apidoc Amnh||WARN_UNPACK
+=for apidoc Amnh||WARN_UNTIE
+=for apidoc Amnh||WARN_UTF8
+=for apidoc Amnh||WARN_VOID
+=for apidoc Amnh||WARN_IMPRECISION
+=for apidoc Amnh||WARN_ILLEGALPROTO
+=for apidoc Amnh||WARN_NON_UNICODE
+=for apidoc Amnh||WARN_NONCHAR
+=for apidoc Amnh||WARN_SURROGATE
+=for apidoc Amnh||WARN_EXPERIMENTAL
+=for apidoc Amnh||WARN_EXPERIMENTAL__LEXICAL_SUBS
+=for apidoc Amnh||WARN_EXPERIMENTAL__REGEX_SETS
+=for apidoc Amnh||WARN_EXPERIMENTAL__SMARTMATCH
+=for apidoc Amnh||WARN_EXPERIMENTAL__POSTDEREF
+=for apidoc Amnh||WARN_EXPERIMENTAL__SIGNATURES
+=for apidoc Amnh||WARN_SYSCALLS
+=for apidoc Amnh||WARN_EXPERIMENTAL__BITWISE
+=for apidoc Amnh||WARN_EXPERIMENTAL__CONST_ATTR
+=for apidoc Amnh||WARN_EXPERIMENTAL__RE_STRICT
+=for apidoc Amnh||WARN_EXPERIMENTAL__REFALIASING
+=for apidoc Amnh||WARN_EXPERIMENTAL__WIN32_PERLIO
+=for apidoc Amnh||WARN_LOCALE
+=for apidoc Amnh||WARN_MISSING
+=for apidoc Amnh||WARN_REDUNDANT
+=for apidoc Amnh||WARN_EXPERIMENTAL__DECLARED_REFS
+=for apidoc Amnh||WARN_EXPERIMENTAL__ALPHA_ASSERTIONS
+=for apidoc Amnh||WARN_EXPERIMENTAL__SCRIPT_RUN
+=for apidoc Amnh||WARN_SHADOW
+=for apidoc Amnh||WARN_EXPERIMENTAL__PRIVATE_USE
+=for apidoc Amnh||WARN_EXPERIMENTAL__UNIPROP_WILDCARDS
+=for apidoc Amnh||WARN_EXPERIMENTAL__VLB
+=for apidoc Amnh||WARN_EXPERIMENTAL__ISA
+
+=cut
+*/
+
 /* end of file warnings.h */
 
 /* ex: set ro: */