X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlrun.pod;h=a72c2c01f6a78d80df5c2348f92b9e4e0bbbf851;hb=42e1efa1e62f0d241a2d8e4847bce98f732060a3;hp=a0115bc99de51e728e2f8cd31c6ee35f2e1e2aed;hpb=5a22a2bbf3880b61603040e7bdfddd4d5f5809a5;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlrun.pod b/pod/perlrun.pod index a0115bc..a72c2c0 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -9,7 +9,6 @@ B S<[ B<-sTtuUWX> ]> S<[ B<-cw> ] [ B<-d>[B][:I] ] [ B<-D>[I] ]> S<[ B<-pna> ] [ B<-F>I ] [ B<-l>[I] ] [ B<-0>[I] ]> S<[ B<-I>I ] [ B<-m>[B<->]I ] [ B<-M>[B<->]I<'module...'> ] [ B<-f> ]> - S<[ B<-A>[I][=I] ]> S<[ B<-C [I] >]> S<[ B<-P> ]> S<[ B<-S> ]> @@ -260,19 +259,6 @@ format: C<-0xHHH...>, where the C are valid hexadecimal digits. (This means that you cannot use the C<-x> with a directory name that consists of hexadecimal digits.) -=item B<-A[I][=I]> -X<-A> - -Activates the assertions given after the equal sign as a comma-separated -list of assertion names or regular expressions. If no assertion name -is given, activates all assertions. - -The module L is used by default to activate the -selected assertions. An alternate module may be specified including -its name between the switch and the equal sign. - -See L and L. - =item B<-a> X<-a> X @@ -360,10 +346,10 @@ switch was therefore "recycled".) X<-c> causes Perl to check the syntax of the program and then exit without -executing it. Actually, it I execute C, C, and -C blocks, because these are considered as occurring outside the -execution of your program. C and C blocks, however, will -be skipped. +executing it. Actually, it I execute C, C, +C, and C blocks, because these are considered as occurring +outside the execution of your program. C and C blocks, +however, will be skipped. =item B<-d> X<-d> X<-dt> @@ -1023,14 +1009,17 @@ X A list of directories in which to look for Perl library files before looking in the standard library and the current directory. Any architecture-specific directories under the specified -locations are automatically included if they exist. If PERL5LIB is not -defined, PERLLIB is used. Directories are separated (like in PATH) by -a colon on unixish platforms and by a semicolon on Windows (the proper -path separator being given by the command C). +locations are automatically included if they exist (this lookup +being done at interpreter startup time.) + +If PERL5LIB is not defined, PERLLIB is used. Directories are separated +(like in PATH) by a colon on unixish platforms and by a semicolon on +Windows (the proper path separator being given by the command C). When running taint checks (either because the program was running setuid -or setgid, or the B<-T> switch was used), neither variable is used. -The program should instead say: +or setgid, or the B<-T> or B<-t> switch was specified), neither variable +is used. The program should instead say: use lib "/my/directory"; @@ -1055,7 +1044,9 @@ emphasise their similarity to variable "attributes". But the code that parses layer specification strings (which is also used to decode the PERLIO environment variable) treats the colon as a separator. -An unset or empty PERLIO is equivalent to C<:stdio>. +An unset or empty PERLIO is equivalent to the default set of layers for +your platform, for example C<:unix:perlio> on UNIX-like systems +and C<:unix:crlf> on Windows and other DOS-like systems. The list becomes the default for I perl's IO. Consequently only built-in layers can appear in this list, as external layers (such as :encoding()) need