X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=1b111cbef7390143249518d6311fcd63bb8df23b;hb=1f950eb4f39b89f547d5802df0c94526d900d2f2;hp=6397388e5d99c58c6b43e33cdc1c1b1a359675ca;hpb=a2293a43268c593a8a95d38299057a646f0fb089;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 6397388..1b111cb 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -116,7 +116,7 @@ How do I reformat a paragraph?, How can I access/change the first N letters of a string?, How do I change the Nth occurrence of something?, How can I count the number of occurrences of a substring within a string?, How do I capitalize all the words on one line?, How can I split a [character] -delimited string except when inside[character]? (Comma-separated files), +delimited string except when inside [character]? (Comma-separated files), How do I strip blank space from the beginning/end of a string?, How do I pad a string with blanks or pad a number with zeroes?, How do I extract selected columns from a string?, How do I find the soundex value of a @@ -600,7 +600,7 @@ the tag =item How can I remove duplicate elements from a list or array? -a) If @in is sorted, and you want @out to be sorted:(this assumes all true +a) If @in is sorted, and you want @out to be sorted: (this assumes all true values in the array), b) If you don't know whether @in is sorted:, c) Like (b), but @in contains only small integers:, d) A way to do (b) without any loops or greps:, e) Like (d), but @in contains only small positive @@ -1751,7 +1751,8 @@ B<-x> I =item ENVIRONMENT HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL -(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL +(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL, +PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port) =back @@ -1869,33 +1870,34 @@ LIST, write FILEHANDLE, write EXPR, write, y/// =item Predefined Names $ARG, $_, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', -$LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number -HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE -EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, -$OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR, -$OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR, -$OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", +$LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, +input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, +input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, +autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE +EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE +EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR, $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR, -$FORMAT_LINES_LEFT, $-, @-, C<$`> is the same as C), -C<$&> is the same as C), C<$'> is the -same as C), C<$1> is the same as C, C<$2> is the same as C, C<$3> is the same as C), -format_name HANDLE EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR, -$FORMAT_TOP_NAME, $^, format_line_break_characters HANDLE EXPR, -$FORMAT_LINE_BREAK_CHARACTERS, $:, format_formfeed HANDLE EXPR, -$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR, -$ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, -$$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, -$GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], -$COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, -$INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, -0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, -$EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, $PERL_VERSION, $^V, -$WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, -$^X, $ARGV, @ARGV, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} +$FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, @-, C<$`> is the same as +C, C<$&> is the same as C, C<$'> is the same as C, C<$1> is the same +as C, C<$2> is the same as +C, C<$3> is the same as C, format_name HANDLE EXPR, $FORMAT_NAME, $~, +format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^, +format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS, +$:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, +$CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, +$EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, +$EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(, +$EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, +$DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, +$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, +0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, +$BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, +${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, +%ENV, $ENV{expr}, %SIG, $SIG{expr} =item Error Indicators @@ -1987,9 +1989,9 @@ You want to temporarily change just one element of an array or hash =item Pragmatic Modules -attributes, attrs, autouse, base, blib, caller, charnames, constant, -diagnostics, fields, filetest, integer, less, lib, locale, ops, overload, -re, sigtrap, strict, subs, utf8, vars, warnings +attributes, attrs, autouse, base, blib, bytes, charnames, constant, +diagnostics, fields, filetest, integer, less, lib, locale, open, ops, +overload, re, sigtrap, strict, subs, utf8, vars, warnings =item Standard Modules @@ -1998,31 +2000,28 @@ B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, -Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, -Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue, DynaLoader, English, -Env, Errno, Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Embed, -ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, +Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, Dumpvalue, +English, Env, Exporter, Exporter::Heavy, ExtUtils::Command, +ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, -File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob, -File::Path, File::Spec, File::Spec::Functions, File::Spec::Mac, -File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, -File::stat, FileCache, FileHandle, FindBin, GDBM_File, Getopt::Long, -Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File, IO::Handle, IO::Pipe, -IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, -IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3, IPC::Semaphore, -IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig, -Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, O, -Opcode, POSIX, Pod::Checker, Pod::Html, Pod::InputObjects, Pod::Man, -Pod::Parser, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Usage, -SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, -Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete, -Term::ReadLine, Test, Test::Harness, Text::Abbrev, Text::ParseWords, -Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash, -Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, -Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent +File::Compare, File::Copy, File::DosGlob, File::Find, File::Path, +File::Spec, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, +File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp, +File::stat, FileCache, FileHandle, FindBin, Getopt::Long, Getopt::Std, +I18N::Collate, IO, IPC::Open2, IPC::Open3, Math::BigFloat, Math::BigInt, +Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, +Net::protoent, Net::servent, O, ODBM_File, Opcode, Pod::Checker, Pod::Find, +Pod::Html, Pod::InputObjects, Pod::Man, Pod::ParseUtils, Pod::Parser, +Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Termcap, +Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, +Socket, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, +Test, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex, +Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, +Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm, +UNIVERSAL, User::grent, User::pwent =item Extension Modules @@ -2229,10 +2228,9 @@ B (with C<\l>, C<\L>, C<\u> or C<\U>), B (C):, B (C):, B (printf() and write()):, B (lc(), lcfirst(), uc(), ucfirst()):, B (localeconv(), strcoll(),strftime(), strxfrm()):, B (isalnum(), isalpha(), isdigit(),isgraph(), -islower(), isprint(), ispunct(), isspace(), isupper(), -isxdigit()): +functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B (isalnum(), isalpha(), isdigit(), isgraph(), +islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()): =item ENVIRONMENT @@ -3538,7 +3536,9 @@ B, B =item New Things in this Example -=item EXAMPLE 6 (Coming Soon) +=item EXAMPLE 6 + +=item New Things in this Example =item EXAMPLE 7 (Coming Soon) @@ -3871,6 +3871,8 @@ Zero =item DESCRIPTION +is_gv_magical + =item AUTHORS =item SEE ALSO @@ -4987,7 +4989,7 @@ B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m> =item CALLING CGI.PM ROUTINES -1. Use another name for the argument, if one is available. Forexample, +1. Use another name for the argument, if one is available. For example, -value is an alias for -values, 2. Change the capitalization, e.g. -Values, 3. Put quotes around the argument name, e.g. '-values' @@ -5026,8 +5028,8 @@ B<:standard>, B<:all> =item PRAGMAS --any, -compile, -nph, -newstyle_urls, -autoload, -no_debug, --private_tempfiles +-any, -compile, -nosticky, -nph, -newstyle_urls, -oldstyle_urls, -autoload, +-no_debug, -debug, -private_tempfiles =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS @@ -5074,6 +5076,11 @@ B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> =item NON-STANDARD HTML SHORTCUTS +=item AUTOESCAPING HTML + +$escaped_string = escapeHTML("unescaped string");, $charset = +charset([$charset]);, $flag = autoEscape([$flag]); + =item PRETTY-PRINTING HTML =back @@ -5132,9 +5139,8 @@ B =item CREATING A CLICKABLE IMAGE BUTTON -B, 3.The third option (-align, optional) is an alignment type, -and may be -TOP, BOTTOM or MIDDLE +B, 3. The third option (-align, optional) is an alignment +type, and may be TOP, BOTTOM or MIDDLE =item CREATING A JAVASCRIPT ACTION BUTTON @@ -5164,11 +5170,11 @@ the
tag =item FETCHING ENVIRONMENT VARIABLES B, B, B, B, -B, B, BReturn the script -name as a partial URL, for self-refering -scripts, B, B, B, B, B, B, B, -B, B, B, B +B, B, B Return the script +name as a partial URL, for self-refering scripts, B, B, B, B, B, +B, B, B, B, +B, B =item USING NPH SCRIPTS @@ -5600,10 +5606,10 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -5612,23 +5618,24 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -5638,24 +5645,24 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C =item e @@ -5736,7 +5743,7 @@ C, C =item o C, C, C, C, -C, C, C +C, C, C, C =item p @@ -7355,6 +7362,88 @@ rel2abs =back +=head2 File::Temp - return name and handle of a temporary file safely + +=over + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=over + +=item FUNCTIONS + +B + +=back + +B + +=over + +=item MKTEMP FUNCTIONS + +B + +=back + +B + +B + +B + +=over + +=item POSIX FUNCTIONS + +B + +=back + +B + +=over + +=item ADDITIONAL FUNCTIONS + +B + +=back + +=over + +=item UTILITY FUNCTIONS + +B + +=back + +=over + +=item PACKAGE VARIABLES + +B, STANDARD, MEDIUM, HIGH + +=back + +TopSystemUID + +=over + +=item WARNING + +=item HISTORY + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 File::stat - by-name interface to Perl's built-in stat() functions =over @@ -8188,6 +8277,39 @@ Canonical notation, Input, Output =back +=head2 Math::Complex - complex numbers and associated mathematical +functions + +=over + +=item SYNOPSIS + +=item DESCRIPTION + +=item OPERATIONS + +=item CREATION + +=item STRINGIFICATION + +=over + +=item CHANGED IN PERL 5.6 + +=back + +=item USAGE + +=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO + +=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS + +=item BUGS + +=item AUTHORS + +=back + =head2 Math::Trig - trigonometric functions =over @@ -9844,10 +9966,10 @@ arrays =item EXAMPLES -0a simple word, 1multiple spaces are skipped because of our $delim, 2use of -quotes to include a space in a word, 3use of a backslash to include a space -in a word, 4use of a backslash to remove the special meaning of a -double-quote, 5another simple word (note the lack of effect of the +0 a simple word, 1 multiple spaces are skipped because of our $delim, 2 use +of quotes to include a space in a word, 3 use of a backslash to include a +space in a word, 4 use of a backslash to remove the special meaning of a +double-quote, 5 another simple word (note the lack of effect of the backslashed double-quote) =item AUTHORS