diff options
author | Dave Mitchell <davem@fdisolutions.com> | 2007-05-20 23:10:15 +0000 |
---|---|---|
committer | Dave Mitchell <davem@fdisolutions.com> | 2007-05-20 23:10:15 +0000 |
commit | 907b3e23950be4dd31c150e1902fbd26201355bd (patch) | |
tree | 7b9c95a262315e6e15824a38639960ea0b9361a7 /pod | |
parent | 882227b7f0b6e1ca62725268e60a7fd0211899ca (diff) | |
download | perl-907b3e23950be4dd31c150e1902fbd26201355bd.tar.gz |
delete thrdvar.h and move its contents to intrpvar.h
p4raw-id: //depot/perl@31245
Diffstat (limited to 'pod')
-rw-r--r-- | pod/perlapi.pod | 132 | ||||
-rw-r--r-- | pod/perlintern.pod | 172 | ||||
-rw-r--r-- | pod/perltodo.pod | 2 |
3 files changed, 153 insertions, 153 deletions
diff --git a/pod/perlapi.pod b/pod/perlapi.pod index 7c0aa88403..cd84734aef 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -1223,72 +1223,6 @@ Found in file pp_pack.c =back -=head1 Global Variables - -=over 8 - -=item PL_modglobal -X<PL_modglobal> - -C<PL_modglobal> is a general purpose, interpreter global HV for use by -extensions that need to keep information on a per-interpreter basis. -In a pinch, it can also be used as a symbol table for extensions -to share data among each other. It is a good idea to use keys -prefixed by the package name of the extension that owns the data. - - HV* PL_modglobal - -=for hackers -Found in file intrpvar.h - -=item PL_na -X<PL_na> - -A convenience variable which is typically used with C<SvPV> when one -doesn't care about the length of the string. It is usually more efficient -to either declare a local variable and use that instead or to use the -C<SvPV_nolen> macro. - - STRLEN PL_na - -=for hackers -Found in file thrdvar.h - -=item PL_sv_no -X<PL_sv_no> - -This is the C<false> SV. See C<PL_sv_yes>. Always refer to this as -C<&PL_sv_no>. - - SV PL_sv_no - -=for hackers -Found in file intrpvar.h - -=item PL_sv_undef -X<PL_sv_undef> - -This is the C<undef> SV. Always refer to this as C<&PL_sv_undef>. - - SV PL_sv_undef - -=for hackers -Found in file intrpvar.h - -=item PL_sv_yes -X<PL_sv_yes> - -This is the C<true> SV. See C<PL_sv_no>. Always refer to this as -C<&PL_sv_yes>. - - SV PL_sv_yes - -=for hackers -Found in file intrpvar.h - - -=back - =head1 GV Functions =over 8 @@ -3135,6 +3069,72 @@ Found in file pad.c =back +=head1 Per-Interpreter Variables + +=over 8 + +=item PL_modglobal +X<PL_modglobal> + +C<PL_modglobal> is a general purpose, interpreter global HV for use by +extensions that need to keep information on a per-interpreter basis. +In a pinch, it can also be used as a symbol table for extensions +to share data among each other. It is a good idea to use keys +prefixed by the package name of the extension that owns the data. + + HV* PL_modglobal + +=for hackers +Found in file intrpvar.h + +=item PL_na +X<PL_na> + +A convenience variable which is typically used with C<SvPV> when one +doesn't care about the length of the string. It is usually more efficient +to either declare a local variable and use that instead or to use the +C<SvPV_nolen> macro. + + STRLEN PL_na + +=for hackers +Found in file intrpvar.h + +=item PL_sv_no +X<PL_sv_no> + +This is the C<false> SV. See C<PL_sv_yes>. Always refer to this as +C<&PL_sv_no>. + + SV PL_sv_no + +=for hackers +Found in file intrpvar.h + +=item PL_sv_undef +X<PL_sv_undef> + +This is the C<undef> SV. Always refer to this as C<&PL_sv_undef>. + + SV PL_sv_undef + +=for hackers +Found in file intrpvar.h + +=item PL_sv_yes +X<PL_sv_yes> + +This is the C<true> SV. See C<PL_sv_no>. Always refer to this as +C<&PL_sv_yes>. + + SV PL_sv_yes + +=for hackers +Found in file intrpvar.h + + +=back + =head1 Simple Exception Handling Macros =over 8 diff --git a/pod/perlintern.pod b/pod/perlintern.pod index 2d0c3a7576..73c21c31e2 100644 --- a/pod/perlintern.pod +++ b/pod/perlintern.pod @@ -353,92 +353,6 @@ Found in file pp_ctl.c =back -=head1 Global Variables - -=over 8 - -=item PL_DBsingle -X<PL_DBsingle> - -When Perl is run in debugging mode, with the B<-d> switch, this SV is a -boolean which indicates whether subs are being single-stepped. -Single-stepping is automatically turned on after every step. This is the C -variable which corresponds to Perl's $DB::single variable. See -C<PL_DBsub>. - - SV * PL_DBsingle - -=for hackers -Found in file intrpvar.h - -=item PL_DBsub -X<PL_DBsub> - -When Perl is run in debugging mode, with the B<-d> switch, this GV contains -the SV which holds the name of the sub being debugged. This is the C -variable which corresponds to Perl's $DB::sub variable. See -C<PL_DBsingle>. - - GV * PL_DBsub - -=for hackers -Found in file intrpvar.h - -=item PL_DBtrace -X<PL_DBtrace> - -Trace variable used when Perl is run in debugging mode, with the B<-d> -switch. This is the C variable which corresponds to Perl's $DB::trace -variable. See C<PL_DBsingle>. - - SV * PL_DBtrace - -=for hackers -Found in file intrpvar.h - -=item PL_dowarn -X<PL_dowarn> - -The C variable which corresponds to Perl's $^W warning variable. - - bool PL_dowarn - -=for hackers -Found in file intrpvar.h - -=item PL_last_in_gv -X<PL_last_in_gv> - -The GV which was last used for a filehandle input operation. (C<< <FH> >>) - - GV* PL_last_in_gv - -=for hackers -Found in file thrdvar.h - -=item PL_ofs_sv -X<PL_ofs_sv> - -The output field separator - C<$,> in Perl space. - - SV* PL_ofs_sv - -=for hackers -Found in file thrdvar.h - -=item PL_rs -X<PL_rs> - -The input record separator - C<$/> in Perl space. - - SV* PL_rs - -=for hackers -Found in file thrdvar.h - - -=back - =head1 GV Functions =over 8 @@ -943,6 +857,92 @@ Found in file pad.c =back +=head1 Per-Interpreter Variables + +=over 8 + +=item PL_DBsingle +X<PL_DBsingle> + +When Perl is run in debugging mode, with the B<-d> switch, this SV is a +boolean which indicates whether subs are being single-stepped. +Single-stepping is automatically turned on after every step. This is the C +variable which corresponds to Perl's $DB::single variable. See +C<PL_DBsub>. + + SV * PL_DBsingle + +=for hackers +Found in file intrpvar.h + +=item PL_DBsub +X<PL_DBsub> + +When Perl is run in debugging mode, with the B<-d> switch, this GV contains +the SV which holds the name of the sub being debugged. This is the C +variable which corresponds to Perl's $DB::sub variable. See +C<PL_DBsingle>. + + GV * PL_DBsub + +=for hackers +Found in file intrpvar.h + +=item PL_DBtrace +X<PL_DBtrace> + +Trace variable used when Perl is run in debugging mode, with the B<-d> +switch. This is the C variable which corresponds to Perl's $DB::trace +variable. See C<PL_DBsingle>. + + SV * PL_DBtrace + +=for hackers +Found in file intrpvar.h + +=item PL_dowarn +X<PL_dowarn> + +The C variable which corresponds to Perl's $^W warning variable. + + bool PL_dowarn + +=for hackers +Found in file intrpvar.h + +=item PL_last_in_gv +X<PL_last_in_gv> + +The GV which was last used for a filehandle input operation. (C<< <FH> >>) + + GV* PL_last_in_gv + +=for hackers +Found in file intrpvar.h + +=item PL_ofs_sv +X<PL_ofs_sv> + +The output field separator - C<$,> in Perl space. + + SV* PL_ofs_sv + +=for hackers +Found in file intrpvar.h + +=item PL_rs +X<PL_rs> + +The input record separator - C<$/> in Perl space. + + SV* PL_rs + +=for hackers +Found in file intrpvar.h + + +=back + =head1 Stack Manipulation Macros =over 8 diff --git a/pod/perltodo.pod b/pod/perltodo.pod index 88b56b18d0..6b7a08916a 100644 --- a/pod/perltodo.pod +++ b/pod/perltodo.pod @@ -134,7 +134,7 @@ for example POSIX passes Exporter some very memory hungry data structures. There is a script F<embed.pl> that generates several header files to prefix all of Perl's symbols in a consistent way, to provide some semblance of namespace support in C<C>. Functions are declared in F<embed.fnc>, variables -in F<interpvar.h> and F<thrdvar.h>. Quite a few of the functions and variables +in F<interpvar.h>. Quite a few of the functions and variables are conditionally declared there, using C<#ifdef>. However, F<embed.pl> doesn't understand the C macros, so the rules about which symbols are present when is duplicated in F<makedef.pl>. Writing things twice is bad, m'kay. |