X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlhack.pod;h=d76261d0c30a2915ead4a2b440fb69e34093465c;hb=d77cdebfaf0c7eb784a132b575c93953a56db215;hp=1e5f02fc130f2eb9c29fee931433f564ab65e2cd;hpb=394175080ac257188727520a2ffea304e9ce811a;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlhack.pod b/pod/perlhack.pod index 1e5f02f..d76261d 100644 --- a/pod/perlhack.pod +++ b/pod/perlhack.pod @@ -156,7 +156,7 @@ altogether without further notice. =item Is the implementation generic enough to be portable? The worst patches make use of a system-specific features. It's highly -unlikely that nonportable additions to the Perl language will be +unlikely that non-portable additions to the Perl language will be accepted. =item Is the implementation tested? @@ -888,7 +888,7 @@ retrieves the return op from it, and returns it. =item Exception handing -Perl's exception handing (i.e. C etc) is built on top of the low-level +Perl's exception handing (i.e. C etc.) is built on top of the low-level C/C C-library functions. These basically provide a way to capture the current PC and SP registers and later restore them; i.e. a C continues at the point in code where a previous C @@ -1556,7 +1556,7 @@ C<-Wdeclaration-after-statement> =back The following flags would be nice to have but they would first need -their own Stygian stablemaster: +their own Augean stablemaster: =over 4 @@ -2111,6 +2111,11 @@ The old home for the module tests, you shouldn't put anything new in here. There are still some bits and pieces hanging around in here that need to be moved. Perhaps you could move them? Thanks! +=item F + +Tests for perl's method resolution order implementations +(see L). + =item F Tests for perl's built in functions that don't fit into any of the @@ -2216,7 +2221,7 @@ are expected to succeed (until they're specifically fixed, of course). =item minitest Run F on F, F, F, F, F, -F, and F tests. +F, F and F tests. =item test.valgrind check.valgrind utest.valgrind ucheck.valgrind @@ -2362,6 +2367,29 @@ running 'make test_notty'. =back +=head3 Other environment variables that may influence tests + +=over 4 + +=item PERL_TEST_Net_Ping + +Setting this variable runs all the Net::Ping modules tests, +otherwise some tests that interact with the outside world are skipped. +See L. + +=item PERL_TEST_NOVREXX + +Setting this variable skips the vrexx.t tests for OS2::REXX. + +=item PERL_TEST_NUMCONVERTS + +This sets a variable in op/numconvert.t. + +=back + +See also the documentation for the Test and Test::Harness modules, +for more environment variables that affect testing. + =head2 Common problems when patching Perl source code Perl source plays by ANSI C89 rules: no C99 (or C++) extensions. In @@ -2829,7 +2857,7 @@ not perfect, because the below is a compile-time check): #endif How does the HAS_QUUX become defined where it needs to be? Well, if -Foonix happens to be UNIXy enought to be able to run the Configure +Foonix happens to be UNIXy enough to be able to run the Configure script, and Configure has been taught about detecting and testing quux(), the HAS_QUUX will be correctly defined. In other platforms, the corresponding configuration step will hopefully do the same. @@ -2858,7 +2886,7 @@ But in any case, try to keep the features and operating systems separate. =item * -malloc(0), realloc(0), calloc(0, 0) are nonportable. To be portable +malloc(0), realloc(0), calloc(0, 0) are non-portable. To be portable allocate at least one byte. (In general you should rarely need to work at this low level, but instead use the various malloc wrappers.)