From: Jarkko Hietaniemi Date: Thu, 18 Oct 2001 00:47:19 +0000 (+0000) Subject: Regen toc. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=10151d0966452be13ba80e564c1a4b44d3c05d9d;p=p5sagit%2Fp5-mst-13.2.git Regen toc. p4raw-id: //depot/perl@12488 --- diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index f9e39bc..5d78962 100644 --- a/pod/buildtoc.PL +++ b/pod/buildtoc.PL @@ -95,6 +95,7 @@ if (-d "pod") { qw( perl + perlintro perlfaq perltoc perlbook diff --git a/pod/perl.pod b/pod/perl.pod index 15e4e84..57416bc 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -12,9 +12,14 @@ B S<[ B<-sTuU> ]> S<[ B<-hv> ] [ B<-V>[:I] ]> S<[ B<-i>[I] ]> S<[ B<-e> I<'command'> ] [ B<--> ] [ I ] [ I ]...> -For ease of access, the Perl manual has been split up into several sections: +If you're new to Perl, you should start with L, which is a +general intro for beginners and provides some background to help you +navigate the rest of Perl's extensive documentation. + +For ease of access, the Perl manual has been split up into several sections. perl Perl overview (this section) + perlintro Perl introduction for beginners perlfaq Perl frequently asked questions perltoc Perl documentation table of contents perlbook Perl book information diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 9e11f7c..1c9f867 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -37,8 +37,56 @@ through to locate the proper section you're looking for. =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 2001/09/20 -03:03:00 $) +=head2 perlintro -- a brief introduction and overview of Perl + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item What is Perl? + +=item Running Perl programs + +=item Basic syntax overview + +=item Perl variable types + +Scalars, Arrays, Hashes + +=item Variable scoping + +=item Conditional and looping constructs + +if, while, for, foreach + +=item Builtin operators and functions + +Arithmetic, Numeric comparison, String comparison, Boolean logic, +Miscellaneous + +=item Files and I/O + +=item Regular expressions + +Simple matching, Simple substitution, More complex regular expressions, +Parentheses for capturing, Other regexp features + +=item Writing subroutines + +=item OO Perl + +=item Using Perl modules + +=back + +=item AUTHOR + +=back + +=head2 perlfaq - frequently asked questions about Perl ($Date: 2001/10/16 +13:27:22 $) =over 4 @@ -2507,8 +2555,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.1 $, -$Date: 2001/09/20 03:03:00 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.2 $, +$Date: 2001/10/16 13:27:22 $) =over 4 @@ -2563,8 +2611,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.7 $, $Date: 2001/10/09 -22:17:53 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.8 $, $Date: 2001/10/17 +14:14:20 $) =over 4 @@ -2633,8 +2681,6 @@ stringification, Pass by reference, Tie large variables to disk =item Where can I learn about CGI or Web programming in Perl? -=item Where can I learn about object-oriented Perl programming? - =item Where can I learn about linking C with Perl? [h2xs, xsubpp] =item I've read perlembed, perlguts, etc., but I can't embed perl in @@ -2861,8 +2907,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.2 $, $Date: 2001/09/26 -10:44:41 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.3 $, $Date: 2001/10/16 +13:27:22 $) =over 4 @@ -2954,7 +3000,7 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regexes ($Revision: 1.1 $, $Date: 2001/09/20 03:03:00 $) +=head2 perlfaq6 - Regexes ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22 $) =over 4 @@ -3020,8 +3066,8 @@ file? =back -=head2 perlfaq7 - Perl Language Issues ($Revision: 1.1 $, $Date: 2001/09/20 -03:03:00 $) +=head2 perlfaq7 - Perl Language Issues ($Revision: 1.2 $, $Date: 2001/10/16 +13:27:22 $) =over 4 @@ -3099,8 +3145,8 @@ is in scope? =back -=head2 perlfaq8 - System Interaction ($Revision: 1.1 $, $Date: 2001/09/20 -03:03:00 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.2 $, $Date: 2001/10/16 +13:27:22 $) =over 4 @@ -3227,7 +3273,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.2 $, $Date: 2001/09/28 06:40:07 +=head2 perlfaq9 - Networking ($Revision: 1.3 $, $Date: 2001/10/16 13:27:22 $) =over 4 @@ -15415,6 +15461,110 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =back +=head2 Test::Builder - Backend for building test libraries + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Construction + +B + +=back + +=back + +=over 4 + +=item Setting up tests + +B + +=back + +B + +B + +B + +B + +=over 4 + +=item Running tests + +B + +=back + +B, B + +B + +B + +B + +=over 4 + +=item Test style + +B + +=back + +B + +B, B + +=over 4 + +=item Output + +B + +=back + +B<_print> + +B, B, B + +=over 4 + +=item Test Status and Info + +B + +=back + +B + +B
I, B + +B + +B<_sanity_check> + +B<_whoa> + +B<_my_exit> + +=over 4 + +=item EXAMPLES + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 Test::Harness - run perl standard test scripts with statistics =over 4 @@ -15493,6 +15643,12 @@ C =item I love it when a plan comes together +=back + +=back + +=over 4 + =item Test names =item I'm ok, you're not ok. @@ -15501,8 +15657,6 @@ B =back -=back - B, B B @@ -15537,10 +15691,12 @@ B =item Comparision functions -B +B =back +B + B B @@ -15574,12 +15730,6 @@ B =back -B<_sanity_check> - -B<_whoa> - -B<_my_exit> - =over 4 =item EXAMPLE