X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperl.pod;h=d1365a28656b9f789f19ab66b831e31bb7f7ebbd;hb=62703e7218aceb3f5d30f70a2307dd02e5eb8c63;hp=9f3824d96ed884b2bd1aaaa6030e0d5689ad5cb9;hpb=9a997319a2cb3566368aef4411c3714ed702d800;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perl.pod b/pod/perl.pod index 9f3824d..d1365a2 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -12,114 +12,190 @@ 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. + +=head2 Overview perl Perl overview (this section) - perlfaq Perl frequently asked questions + perlintro Perl introduction for beginners perltoc Perl documentation table of contents - perlbook Perl book information - perlsyn Perl syntax - perldata Perl data structures - perlop Perl operators and precedence - perlsub Perl subroutines - perlfunc Perl builtin functions +=head2 Tutorials + perlreftut Perl references short introduction perldsc Perl data structures intro - perlrequick Perl regular expressions quick start - perlpod Perl plain old documentation + perllol Perl data structures: arrays of arrays + + perlrequick Perl regular expressions quick start + perlretut Perl regular expressions tutorial + + perlboot Perl OO tutorial for beginners + perltoot Perl OO tutorial, part 1 + perltooc Perl OO tutorial, part 2 + perlbot Perl OO tricks and examples + perlstyle Perl style guide + + perlcheat Perl cheat sheet perltrap Perl traps for the unwary + perldebtut Perl debugging tutorial + + perlfaq Perl frequently asked questions + perlfaq1 General Questions About Perl + perlfaq2 Obtaining and Learning about Perl + perlfaq3 Programming Tools + perlfaq4 Data Manipulation + perlfaq5 Files and Formats + perlfaq6 Regexes + perlfaq7 Perl Language Issues + perlfaq8 System Interaction + perlfaq9 Networking + +=head2 Reference Manual + perlsyn Perl syntax + perldata Perl data structures + perlop Perl operators and precedence + perlsub Perl subroutines + perlfunc Perl built-in functions + perlopentut Perl open() tutorial + perlpacktut Perl pack() and unpack() tutorial + perlpod Perl plain old documentation + perlpodspec Perl plain old documentation format specification perlrun Perl execution and options perldiag Perl diagnostic messages - perllexwarn Perl warnings and their control - perldebtut Perl debugging tutorial + perllexwarn Perl warnings and their control perldebug Perl debugging - perlvar Perl predefined variables - perllol Perl data structures: arrays of arrays - perlopentut Perl open() tutorial - perlretut Perl regular expressions tutorial - perlre Perl regular expressions, the rest of the story + perlreref Perl regular expressions quick reference perlref Perl references, the rest of the story - perlform Perl formats - - perlboot Perl OO tutorial for beginners - perltoot Perl OO tutorial, part 1 - perltootc Perl OO tutorial, part 2 perlobj Perl objects - perlbot Perl OO tricks and examples perltie Perl objects hidden behind simple variables + perldbmfilter Perl DBM filters perlipc Perl interprocess communication perlfork Perl fork() information perlnumber Perl number semantics + perlthrtut Perl threads tutorial + perlothrtut Old Perl threads tutorial perlport Perl portability guide perllocale Perl locale support - perlunicode Perl unicode support + perluniintro Perl Unicode introduction + perlunicode Perl Unicode support perlebcdic Considerations for running Perl on EBCDIC platforms perlsec Perl security perlmod Perl modules: how they work perlmodlib Perl modules: how to write and use + perlmodstyle Perl modules: how to write modules with style perlmodinstall Perl modules: how to install from CPAN perlnewmod Perl modules: preparing a new module for distribution - perlfaq1 General Questions About Perl - perlfaq2 Obtaining and Learning about Perl - perlfaq3 Programming Tools - perlfaq4 Data Manipulation - perlfaq5 Files and Formats - perlfaq6 Regexes - perlfaq7 Perl Language Issues - perlfaq8 System Interaction - perlfaq9 Networking + perlutil utilities packaged with the Perl distribution + + perlcompile Perl compiler suite intro + + perlfilter Perl source filters - perlcompile Perl compiler suite intro +=head2 Internals and C Language Interface perlembed Perl ways to embed perl in your C or C++ application - perldebguts Perl debugging guts and tips + perldebguts Perl debugging guts and tips perlxstut Perl XS tutorial perlxs Perl XS application programming interface + perlclib Internal replacements for standard C library functions perlguts Perl internal functions for those doing extensions perlcall Perl calling conventions from C - perlutil utilities packaged with the Perl distribution - perlfilter Perl source filters - perldbmfilter Perl DBM filters + perlapi Perl API listing (autogenerated) perlintern Perl internal functions (autogenerated) + perliol C API for Perl's implementation of IO in Layers perlapio Perl internal IO abstraction interface - perltodo Perl things to do + perlhack Perl hackers guide +=head2 Miscellaneous + + perlbook Perl book information + perltodo Perl things to do + + perldoc Look up Perl documentation in Pod format + perlhist Perl history records perldelta Perl changes since previous version - perl56delta Perl changes in version 5.6 + perl592delta Perl changes in version 5.9.2 + perl591delta Perl changes in version 5.9.1 + perl590delta Perl changes in version 5.9.0 + perl586delta Perl changes in version 5.8.6 + perl585delta Perl changes in version 5.8.5 + perl584delta Perl changes in version 5.8.4 + perl583delta Perl changes in version 5.8.3 + perl582delta Perl changes in version 5.8.2 + perl581delta Perl changes in version 5.8.1 + perl58delta Perl changes in version 5.8.0 + perl573delta Perl changes in version 5.7.3 + perl572delta Perl changes in version 5.7.2 + perl571delta Perl changes in version 5.7.1 + perl570delta Perl changes in version 5.7.0 + perl561delta Perl changes in version 5.6.1 + perl56delta Perl changes in version 5.6 perl5005delta Perl changes in version 5.005 perl5004delta Perl changes in version 5.004 + perlartistic Perl Artistic License + perlgpl GNU General Public License + +=head2 Language-Specific + + perlcn Perl for Simplified Chinese (in EUC-CN) + perljp Perl for Japanese (in EUC-JP) + perlko Perl for Korean (in EUC-KR) + perltw Perl for Traditional Chinese (in Big5) + +=head2 Platform-Specific + perlaix Perl notes for AIX - perlamiga Perl notes for Amiga + perlamiga Perl notes for AmigaOS + perlapollo Perl notes for Apollo DomainOS + perlbeos Perl notes for BeOS + perlbs2000 Perl notes for POSIX-BC BS2000 + perlce Perl notes for WinCE perlcygwin Perl notes for Cygwin + perldgux Perl notes for DG/UX perldos Perl notes for DOS perlepoc Perl notes for EPOC + perlfreebsd Perl notes for FreeBSD perlhpux Perl notes for HP-UX - perlmachten Perl notes for Power MachTen + perlhurd Perl notes for Hurd + perlirix Perl notes for Irix + perlmachten Perl notes for Power MachTen + perlmacos Perl notes for Mac OS (Classic) + perlmacosx Perl notes for Mac OS X + perlmint Perl notes for MiNT + perlmpeix Perl notes for MPE/iX + perlnetware Perl notes for NetWare perlos2 Perl notes for OS/2 perlos390 Perl notes for OS/390 - perlposix-bc Perl notes for POSIX-BC + perlos400 Perl notes for OS/400 + perlplan9 Perl notes for Plan 9 + perlqnx Perl notes for QNX + perlsolaris Perl notes for Solaris + perltru64 Perl notes for Tru64 + perluts Perl notes for UTS + perlvmesa Perl notes for VM/ESA perlvms Perl notes for VMS perlvos Perl notes for Stratus VOS perlwin32 Perl notes for Windows -(If you're intending to read these straight through for the first time, -the suggested order will tend to reduce the number of forward references.) By default, the manpages listed above are installed in the F directory. @@ -189,58 +265,81 @@ But wait, there's more... Begun in 1993 (see L), Perl version 5 is nearly a complete rewrite that provides the following additional benefits: -=over +=over 4 -=item * modularity and reusability using innumerable modules +=item * + +modularity and reusability using innumerable modules Described in L, L, and L. -=item * embeddable and extensible +=item * + +embeddable and extensible Described in L, L, L, L, L, and L. -=item * roll-your-own magic variables (including multiple simultaneous DBM implementations) +=item * + +roll-your-own magic variables (including multiple simultaneous DBM +implementations) Described in L and L. -=item * subroutines can now be overridden, autoloaded, and prototyped +=item * + +subroutines can now be overridden, autoloaded, and prototyped Described in L. -=item * arbitrarily nested data structures and anonymous functions +=item * + +arbitrarily nested data structures and anonymous functions Described in L, L, L, and L. -=item * object-oriented programming +=item * + +object-oriented programming -Described in L, L, and L. +Described in L, L, L, L, +and L. -=item * compilability into C code or Perl bytecode +=item * -Described in L and L. +support for light-weight processes (threads) -=item * support for light-weight processes (threads) +Described in L and L. -Described in L and L. +=item * -=item * support for internationalization, localization, and Unicode +support for Unicode, internationalization, and localization -Described in L and L. +Described in L, L and L. -=item * lexical scoping +=item * + +lexical scoping Described in L. -=item * regular expression enhancements +=item * + +regular expression enhancements Described in L, with additional examples in L. -=item * enhanced debugger and interactive Perl environment, with integrated editor support +=item * + +enhanced debugger and interactive Perl environment, +with integrated editor support + +Described in L, L and L. -Described in L. +=item * -=item * POSIX 1003.1 compliant library +POSIX 1003.1 compliant library Described in L. @@ -276,8 +375,10 @@ Perl developers, please write to perl-thanks@perl.org . a2p awk to perl translator s2p sed to perl translator - http://www.perl.com/ the Perl Home Page - http://www.perl.com/CPAN the Comprehensive Perl Archive + http://www.perl.org/ the Perl homepage + http://www.perl.com/ Perl articles (O'Reilly Media) + http://www.cpan.org/ the Comprehensive Perl Archive + http://www.pm.org/ the Perl Mongers =head1 DIAGNOSTICS