This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Move PL_dowarn to Warnings section
authorKarl Williamson <khw@cpan.org>
Wed, 18 Nov 2020 03:35:01 +0000 (20:35 -0700)
committerKarl Williamson <khw@cpan.org>
Wed, 25 Nov 2020 13:15:06 +0000 (06:15 -0700)
intrpvar.h

index 1ea21ca..10fd8e1 100644 (file)
@@ -94,12 +94,17 @@ PERLVARI(I, tainted,        bool, FALSE)    /* using variables controlled by $< */
 PERLVAR(I, delaymagic, U16)            /* ($<,$>) = ... */
 
 /*
+=for apidoc_section $warning
 =for apidoc mn|U8|PL_dowarn
 
 The C variable that roughly corresponds to Perl's C<$^W> warning variable.
 However, C<$^W> is treated as a boolean, whereas C<PL_dowarn> is a
 collection of flag bits.
 
+On threaded perls, each thread has an independent copy of this variable;
+each initialized at creation time with the current value of the creating
+thread's copy.
+
 =cut
 */
 
@@ -171,6 +176,7 @@ PERLVAR(I, regmatch_state, regmatch_state *)
 PERLVAR(I, comppad,    PAD *)          /* storage for lexically scoped temporaries */
 
 /*
+=for apidoc_section Per-Interpreter Variables
 =for apidoc Amn|SV|PL_sv_undef
 This is the C<undef> SV.  Always refer to this as C<&PL_sv_undef>.