diff options
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/Makefile | 16 | ||||
| -rw-r--r-- | pod/perl.pod | 2 | ||||
| -rw-r--r-- | pod/perlfunc.pod | 7 | ||||
| -rw-r--r-- | pod/perlmod.pod | 66 | ||||
| -rw-r--r-- | pod/perlnews.pod | 37 | ||||
| -rw-r--r-- | pod/perlobj.pod | 28 | ||||
| -rw-r--r-- | pod/perltoot.pod | 4 | ||||
| -rw-r--r-- | pod/roffitall | 2 |
8 files changed, 72 insertions, 90 deletions
diff --git a/pod/Makefile b/pod/Makefile index 564a63a192..9012b5735b 100644 --- a/pod/Makefile +++ b/pod/Makefile @@ -17,10 +17,11 @@ POD = \ perlform.pod \ perlfunc.pod \ perlguts.pod \ - perli18n.pod \ perlipc.pod \ + perllocale.pod \ perllol.pod \ perlmod.pod \ + perlnews.pod \ perlobj.pod \ perlop.pod \ perlovl.pod \ @@ -34,6 +35,7 @@ POD = \ perlsyn.pod \ perltie.pod \ perltoc.pod \ + perltoot.pod \ perltrap.pod \ perlvar.pod \ perlxs.pod \ @@ -53,10 +55,11 @@ MAN = \ perlform.man \ perlfunc.man \ perlguts.man \ - perli18n.man \ perlipc.man \ + perllocale.man \ perllol.man \ perlmod.man \ + perlnews.man \ perlobj.man \ perlop.man \ perlovl.man \ @@ -70,6 +73,7 @@ MAN = \ perlsyn.man \ perltie.man \ perltoc.man \ + perltoot.man \ perltrap.man \ perlvar.man \ perlxs.man \ @@ -89,10 +93,11 @@ HTML = \ perlform.html \ perlfunc.html \ perlguts.html \ - perli18n.html \ perlipc.html \ + perllocale.html \ perllol.html \ perlmod.html \ + perlnews.html \ perlobj.html \ perlop.html \ perlovl.html \ @@ -106,6 +111,7 @@ HTML = \ perlsyn.html \ perltie.html \ perltoc.html \ + perltoot.html \ perltrap.html \ perlvar.html \ perlxs.html \ @@ -125,10 +131,11 @@ TEX = \ perlform.tex \ perlfunc.tex \ perlguts.tex \ - perli18n.tex \ perlipc.tex \ + perllocale.tex \ perllol.tex \ perlmod.tex \ + perlnews.tex \ perlobj.tex \ perlop.tex \ perlovl.tex \ @@ -142,6 +149,7 @@ TEX = \ perlsyn.tex \ perltie.tex \ perltoc.tex \ + perltoot.tex \ perltrap.tex \ perlvar.tex \ perlxs.tex \ diff --git a/pod/perl.pod b/pod/perl.pod index e43424f26b..76a0f269fe 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -268,7 +268,7 @@ directory. If PERL5LIB is defined, PERLLIB is not used. =back Perl also has environment variables that control how Perl handles -language-specific data. Please consult the L<perli18n> section. +language-specific data. Please consult L<perllocale>. Apart from these, Perl uses no other environment variables, except to make them available to the script being executed, and to child diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 9e6a7f12ea..fe3da14929 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -3392,8 +3392,11 @@ That is exactly equivalent to BEGIN { require Module; } If the VERSION argument is present between Module and LIST, then the -C<use> will fail if the C<$VERSION> variable in package Module is -less than VERSION. +C<use> will call the VERSION method in class Module with the given +version as an argument. The default VERSION method, inherited from +the Universal class, croaks if the given version is larger than the +value of the variable $Module::VERSION. (Note that there is not a +comma after VERSION!) Because this is a wide-open interface, pragmas (compiler directives) are also implemented this way. Currently implemented pragmas are: diff --git a/pod/perlmod.pod b/pod/perlmod.pod index e6081aa2e3..c2b1f6c961 100644 --- a/pod/perlmod.pod +++ b/pod/perlmod.pod @@ -380,7 +380,7 @@ manipulate @INC at compile time =item locale -use or ignore current locale for built-in operations (see L<perli18n>) +use or ignore current locale for built-in operations (see L<perllocale>) =item ops @@ -432,6 +432,18 @@ split a package for autoloading benchmark running times of code +=item CPAN + +interface to Comprehensive Perl Archive Network + +=item CPAN::FirstTime + +create a CPAN configuration file + +=item CPAN::Nox + +run CPAN while avoiding compiled extensions + =item Carp warn of errors (from perspective of caller) @@ -520,18 +532,6 @@ write linker options files for dynamic extension add blib/* directories to @INC -=item CPAN - -interface to Comprehensive Perl Archive Network - -=item CPAN::FirstTime - -create a CPAN configuration file - -=item CPAN::Nox - -run CPAN while avoiding compiled extensions - =item Fatal replace functions with equivalents which succeed or die @@ -648,50 +648,10 @@ complex numbers and associated mathematical functions tied access to ndbm files -=item Net::Cmd - -Base class for command-oriented protocols - -=item Net::Domain - -Domain Name System client - -=item Net::FTP - -File Transfer Protocol client - -=item Net::NNTP - -Network News Transfer Protocol client - -=item Net::Netrc - -.netrc lookup routines - =item Net::Ping Hello, anybody home? -=item Net::POP3 - -Post Office Protocol client - -=item Net::SMTP - -Simple Mail Transfer Protocol client - -=item Net::SNPP - -Simple Network Pager Protocol client - -=item Net::Telnet - -Telnet client - -=item Net::Time - -Time and NetTime protocols - =item Net::hostent by-name interface to Perl's built-in gethost*() functions diff --git a/pod/perlnews.pod b/pod/perlnews.pod index 7e6e626723..a624b21c17 100644 --- a/pod/perlnews.pod +++ b/pod/perlnews.pod @@ -162,10 +162,11 @@ this more than we have to.) =item use Module VERSION LIST If the VERSION argument is present between Module and LIST, then the -C<use> will fail if the $VERSION variable in package Module is -less than VERSION. - -Note that there is not a comma after the version! +C<use> will call the VERSION method in class Module with the given +version as an argument. The default VERSION method, inherited from +the Universal class, croaks if the given version is larger than the +value of the variable $Module::VERSION. (Note that there is not a +comma after VERSION!) =item prototype(FUNCTION) @@ -209,16 +210,16 @@ I<undef> is returned. =item VERSION( [NEED] ) -C<VERSION> returns the version number of the class (package). If the -NEED argument is given then it will check that the current version is -not less than NEED and die if this is not the case. This method is -normally called as a class method. This method is also called when the -C<VERSION> form of C<use> is used. +C<VERSION> returns the version number of the class (package). If the +NEED argument is given then it will check that the current version (as +defined by the $VERSION variable in the given package) not less than +NEED; it will die if this is not the case. This method is normally +called as a class method. This method is called automatically by the +C<VERSION> form of C<use>. use A 1.2 qw(some imported subs); - - A->VERSION( 1.2 ); - $ref->is_instance(); # True + # implies: + A->VERSION(1.2); =item class() @@ -425,18 +426,22 @@ new pods are included in section 1: =over 4 -=item L<perli18n> +=item L<perlnews> -Internationalization. +This document. -=item L<perlapio> +=item L<perllocale> -Perl internal IO abstraction interface. +Locale support (internationalization and localization). =item L<perltoot> Tutorial on Perl OO programming. +=item L<perlapio> + +Perl internal IO abstraction interface. + =item L<perldebug> Although not new, this has been massively updated. diff --git a/pod/perlobj.pod b/pod/perlobj.pod index 1d13d90c9a..9b1ede111f 100644 --- a/pod/perlobj.pod +++ b/pod/perlobj.pod @@ -281,7 +281,7 @@ are inherited by all other classes: =over 4 -=item isa ( CLASS ) +=item isa(CLASS) C<isa> returns I<true> if its object is blessed into a sub-class of C<CLASS> @@ -294,29 +294,30 @@ allows the ability to check what a reference points to. Example ... } -=item can ( METHOD ) +=item can(METHOD) C<can> checks to see if its object has a method called C<METHOD>, if it does then a reference to the sub is returned, if it does not then I<undef> is returned. -=item VERSION ( [ VERSION ] ) +=item VERSION( [NEED] ) -C<VERSION> returns the VERSION number of the class (package). If -an argument is given then it will check that the current version is not -less that the given argument. This method is normally called as a class -method. This method is also called when the C<VERSION> form of C<use> is -used. +C<VERSION> returns the version number of the class (package). If the +NEED argument is given then it will check that the current version (as +defined by the $VERSION variable in the given package) not less than +NEED; it will die if this is not the case. This method is normally +called as a class method. This method is called automatically by the +C<VERSION> form of C<use>. use A 1.2 qw(some imported subs); - - A->VERSION( 1.2 ); + # implies: + A->VERSION(1.2); -=item class () +=item class() C<class> returns the class name of its object. -=item is_instance () +=item is_instance() C<is_instance> returns true if its object is an instance of some class, false if its object is the class (package) itself. Example @@ -336,6 +337,9 @@ C<isa> uses a very similar method and cache-ing strategy. This may cause strange effects if the Perl code dynamically changes @ISA in any package. You may add other methods to the UNIVERSAL class via Perl or XS code. +You do not need to C<use UNIVERSAL> in order to make these methods +available to your program. This is necessary only if you wish to +have C<isa> available as a plain subroutine in the current package. =head2 Destructors diff --git a/pod/perltoot.pod b/pod/perltoot.pod index 3fdedc2513..ff8e24fb3e 100644 --- a/pod/perltoot.pod +++ b/pod/perltoot.pod @@ -928,7 +928,7 @@ superclass's name. This in particular is bad if you change which classes you inherit from, or add others. Fortunately, the pseudoclass SUPER comes to the rescue here. - $class->SUPER::debug($Debugging); + $self->SUPER::debug($Debugging); This way it starts looking in my class's @ISA. This only makes sense from I<within> a method call, though. Don't try to access anything @@ -1271,7 +1271,7 @@ Although this is the same function each time, it contains a different version of $self. When a method like C<$him-E<gt>name("Jason")> is called, its implicit -zeroth argument is as the invoking object just as it is with all method +zeroth argument is the invoking object just as it is with all method calls. But in this case, it's our code reference (something like a function pointer in C++, but with deep binding of lexical variables). There's not a lot to be done with a code reference beyond calling it, so diff --git a/pod/roffitall b/pod/roffitall index 024279a69e..3df9386103 100644 --- a/pod/roffitall +++ b/pod/roffitall @@ -2,11 +2,13 @@ #psroff -t -man -rC1 -rD1 -rF1 > /tmp/PerlDoc.ps 2>/tmp/PerlTOC.raw \ nroff -man -rC1 -rD1 -rF1 > /tmp/PerlDoc.txt 2>/tmp/PerlTOC.nr.raw \ /usr/local/man/man1/perl.1 \ + /usr/local/man/man1/perlnews.1 \ /usr/local/man/man1/perldata.1 \ /usr/local/man/man1/perlsyn.1 \ /usr/local/man/man1/perlop.1 \ /usr/local/man/man1/perlre.1 \ /usr/local/man/man1/perlrun.1 \ + /usr/local/man/man1/perllocale.1 \ /usr/local/man/man1/perlfunc.1 \ /usr/local/man/man1/perlvar.1 \ /usr/local/man/man1/perlsub.1 \ |