diff options
| -rw-r--r-- | pod/buildtoc.PL | 1 | ||||
| -rw-r--r-- | pod/perl.pod | 7 | ||||
| -rw-r--r-- | pod/perltoc.pod | 200 |
3 files changed, 182 insertions, 26 deletions
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index f9e39bc69d..5d789624db 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 15e4e84773..57416bcd6c 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -12,9 +12,14 @@ B<perl> S<[ B<-sTuU> ]> S<[ B<-hv> ] [ B<-V>[:I<configvar>] ]> S<[ B<-i>[I<extension>] ]> S<[ B<-e> I<'command'> ] [ B<--> ] [ I<programfile> ] [ I<argument> ]...> -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<perlintro>, 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 9e11f7c713..1c9f867973 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<new> + +=back + +=back + +=over 4 + +=item Setting up tests + +B<exported_to> + +=back + +B<plan> + +B<expected_tests> + +B<no_plan> + +B<skip_all> + +=over 4 + +=item Running tests + +B<ok> + +=back + +B<is_eq>, B<is_num> + +B<like> + +B<skip> + +B<skip_rest> + +=over 4 + +=item Test style + +B<level> + +=back + +B<use_numbers> + +B<no_header>, B<no_ending> + +=over 4 + +=item Output + +B<diag> + +=back + +B<_print> + +B<output>, B<failure_output>, B<todo_output> + +=over 4 + +=item Test Status and Info + +B<current_test> + +=back + +B<summary> + +B<details> I<UNIMPLEMENTED>, B<todo> + +B<caller> + +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<HARNESS_ACTIVE> =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<ok> =back -=back - B<is>, B<isnt> B<like> @@ -15537,10 +15691,12 @@ B<TODO: BLOCK> =item Comparision functions -B<eq_array> +B<is_deeply> =back +B<eq_array> + B<eq_hash> B<eq_set> @@ -15574,12 +15730,6 @@ B<ok> =back -B<_sanity_check> - -B<_whoa> - -B<_my_exit> - =over 4 =item EXAMPLE |