X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=4a9495771fc29bc14d96cc73448a33653b6ec6f5;hb=888aee597441568824c1835285c8012bab253529;hp=b9d895f5fe05d79384a03343a7d9b9f64180da9d;hpb=80cbd5adeb014f6842efb4d766e17b263c48ea6f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index b9d895f..4a94957 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -17,6 +17,22 @@ through to locate the proper section you're looking for. =item SYNOPSIS +=over 4 + +=item Overview + +=item Tutorials + +=item Reference Manual + +=item Internals and C Language Interface + +=item Miscellaneous + +=item Platform-Specific + +=back + =item DESCRIPTION =item AVAILABILITY @@ -37,8 +53,56 @@ through to locate the proper section you're looking for. =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 -20:38:02 $) +=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 @@ -238,7 +302,7 @@ unary &, unary *, (TYPE) ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, -y/SEARCHLIST/REPLACEMENTLIST/cds +y/SEARCHLIST/REPLACEMENTLIST/cds, < FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, -chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER, -chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, -connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, -dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete -EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, -each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, -exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl -FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, -fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, -getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam -NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname -NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr -ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, -getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, -getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent -STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, -endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, -getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, -goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, -import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl -FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, -last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, -link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, -lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, -mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, -msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : -ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open -FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir -DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package -NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos -SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE -FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, -q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, -quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read -FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, -readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, -ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, -require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir -DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, -rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir -DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, -semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send +chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr +NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir +DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt +PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, +defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, +dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval +BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, +fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock +FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE, +getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority +WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname +NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname +NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, +getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, +gethostent, getnetent, getprotoent, getservent, setpwent, setgrent, +sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent +STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent, +endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, +glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep +EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index +STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join +EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc, +lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen +SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock, log EXPR, log, lstat +EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir +FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv +ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, +next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open +FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE, +opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, +pack TEMPLATE,LIST, package NAMESPACE, package, pipe +READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE +LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT, +LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/, +qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, +rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, +readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, +recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename +OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset, +return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex +STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar +EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select +FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl +ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, @@ -471,11 +537,11 @@ more elaborate constructs =over 4 -=item Declaration of a ARRAY OF ARRAYS +=item Declaration of an ARRAY OF ARRAYS -=item Generation of a ARRAY OF ARRAYS +=item Generation of an ARRAY OF ARRAYS -=item Access and Printing of a ARRAY OF ARRAYS +=item Access and Printing of an ARRAY OF ARRAYS =back @@ -495,11 +561,11 @@ more elaborate constructs =over 4 -=item Declaration of a ARRAY OF HASHES +=item Declaration of an ARRAY OF HASHES -=item Generation of a ARRAY OF HASHES +=item Generation of an ARRAY OF HASHES -=item Access and Printing of a ARRAY OF HASHES +=item Access and Printing of an ARRAY OF HASHES =back @@ -579,7 +645,7 @@ more elaborate constructs =back -=head2 perlpod - plain old documentation +=head2 perlpod - the Plain Old Documentation format =over 4 @@ -587,20 +653,73 @@ more elaborate constructs =over 4 +=item Ordinary Paragraph + =item Verbatim Paragraph =item Command Paragraph -=item Ordinary Block of Text +C<=head1 I>, C<=head2 I>, C<=head3 I>, C<=head4 I>, C<=over I>, C<=item +I>, C<=back>, C<=cut>, C<=pod>, C<=begin I>, C<=end +I>, C<=for I I> + +=item Formatting Codes + +CtextE> -- italic text, CtextE> -- bold text, +CcodeE> -- code text, CnameE> -- a hyperlink, +CescapeE> -- a character escape, CfilenameE> -- used +for filenames, CtextE> -- text contains non-breaking spaces, +Ctopic nameE> -- an index entry, CE> -- a null +(zero-effect) formatting code =item The Intent =item Embedding Pods in Perl Modules -=item Common Pod Pitfalls +=item Hints for Writing Pod + +=back + +=item SEE ALSO + +=item AUTHOR =back +=head2 perlpodspec - Plain Old Documentation: format specification and +notes + +=over 4 + +=item DESCRIPTION + +=item Pod Definitions + +=item Pod Commands + +"=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", +"=back", "=begin formatname", "=end formatname", "=for formatname text..." + +=item Pod Formatting Codes + +CtextE> -- italic text, CtextE> -- bold text, +CcodeE> -- code text, CfilenameE> -- style for +filenames, Ctopic nameE> -- an index entry, CE> -- a +null (zero-effect) formatting code, CnameE> -- a hyperlink, +CescapeE> -- a character escape, CtextE> -- text +contains non-breaking spaces + +=item Notes on Implementing Pod Processors + +=item About LE...E Codes + +First:, Second:, Third:, Fourth:, Fifth:, Sixth: + +=item About =over...=back Regions + +=item About Data Paragraphs and "=begin/=end" Regions + =item SEE ALSO =item AUTHOR @@ -648,7 +767,7 @@ Discontinuance, Deprecation, Discontinuance, Discontinuance =item Parsing Traps -Parsing, Parsing, Parsing, Parsing +Parsing, Parsing, Parsing, Parsing, Parsing =item Numerical Traps @@ -732,7 +851,8 @@ B<-x> I HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL (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) +PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to +the VMS port) =back @@ -832,16 +952,17 @@ b [line] [condition], b subname [condition], b postpone subname command, a [line], A, W expr, W, O booloption .., O anyoption? .., O option=value .., < ?, < [ command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !! -cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage] +cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man +[manpage] =item Configurable Options C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, 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 Debugger input/output @@ -880,35 +1001,36 @@ listing =item Predefined Names -$ARG, $_, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', -$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, $-, @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} +$ARG, $_, $a, $b, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', +$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, +HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, +IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, +HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, +IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, +IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, +$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, +HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, +HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, +HANDLE->format_lines_left(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, HANDLE->format_name(EXPR), +$FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, +IO::Handle->format_line_break_characters EXPR, +$FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, +$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, +$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, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, +${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, @F, @INC, +@_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item Error Indicators @@ -1340,7 +1462,7 @@ C<(?(condition)yes-pattern|no-pattern)> =back -=head2 perltootc - Tom's OO Tutorial for Class Data in Perl +=head2 perltooc - Tom's OO Tutorial for Class Data in Perl =over 4 @@ -1410,7 +1532,7 @@ C<(?(condition)yes-pattern|no-pattern)> =item Method Invocation -=item WARNING +=item Indirect Object Syntax =item Default UNIVERSAL methods @@ -1586,7 +1708,7 @@ Proto, LocalPort, Listen, Reuse =back -=head2 perlfork - Perl's fork() emulation +=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) =over 4 @@ -1655,6 +1777,14 @@ string =item DESCRIPTION +=back + +=head2 perlothrtut - old tutorial on threads in Perl + +=over 4 + +=item DESCRIPTION + =item What Is A Thread Anyway? =item Threaded Program Models @@ -1842,19 +1972,20 @@ http://testers.cpan.org/ -I FILEHANDLE, -I EXPR, -I, alarm SECONDS, alarm, binmode FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec -LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, -getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, -getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr -ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, -getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, -setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, -setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, -endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, -ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, -lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, -msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, -open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, -select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget +LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock +FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority +WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID, +getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, +getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, +getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent +STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, +endhostent, endnetent, endprotoent, endservent, getsockopt +SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, +kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, +lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv +ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe +READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select +RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, @@ -1869,12 +2000,12 @@ wait, waitpid PID,FLAGS =item CHANGES -v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999, -v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May -1999, v1.40, 11 April 1999, v1.39, 11 February 1999, v1.38, 31 December -1998, v1.37, 19 December 1998, v1.36, 9 September 1998, v1.35, 13 August -1998, v1.33, 06 August 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, -v1.23, 10 July 1998 +v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, +v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 +May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February +1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September +1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, +v1.30, 03 August 1998, v1.23, 10 July 1998 =item Supported Platforms @@ -1917,6 +2048,8 @@ localization) =item The localeconv function +=item I18N::Langinfo + =back =item LOCALE CATEGORIES @@ -1978,6 +2111,56 @@ LC_NUMERIC, LC_TIME, LANG =back +=head2 perluniintro - Perl Unicode introduction + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Unicode + +=item Perl's Unicode Support + +=item Perl's Unicode Model + +=item Creating Unicode + +=item Handling Unicode + +=item Legacy Encodings + +=item Unicode I/O + +=item Special Cases + +=item Advanced Topics + +=item Miscellaneous + +=item Questions With Answers + +Will My Old Scripts Break?, How Do I Make My Scripts Work With Unicode?, +How Do I Know Whether My String Is In Unicode?, How Do I Detect Invalid +UTF-8?, How Do I Convert Data Into UTF-8? Or Vice Versa?, How Do I Display +Unicode? How Do I Input Unicode?, How Does Unicode Work With Traditional +Locales? + +=item Hexadecimal Notation + +=item Further Resources + +=back + +=item SEE ALSO + +=item ACKNOWLEDGEMENTS + +=item AUTHOR, COPYRIGHT, AND LICENSE + +=back + =head2 perlunicode - Unicode support in Perl =over 4 @@ -1986,21 +2169,40 @@ LC_NUMERIC, LC_TIME, LANG =over 4 -=item Important Caveat +=item Important Caveats Input and Output Disciplines, Regular Expressions, C still needed -to enable a few features +to enable UTF-8/UTF-EBCDIC in scripts =item Byte and Character semantics =item Effects of character semantics +=item Scripts + +=item Blocks + =item Character encodings for input and output =back =item CAVEATS +=item UNICODE REGULAR EXPRESSION SUPPORT LEVEL + +=over 4 + +=item Unicode Encodings + +UTF-8, UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte Order Marks), +UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7 + +=item Security Implications of Malformed UTF-8 + +=item Unicode in Perl on EBCDIC + +=back + =item SEE ALSO =back @@ -2031,11 +2233,13 @@ to enable a few features =item POSIX-BC +=item Unicode and UTF + =back =item SINGLE OCTET TABLES -recipe 0, recipe 1, recipe 2, recipe 3, recipe 4 +recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 =item IDENTIFYING CHARACTER CODE SETS @@ -2075,7 +2279,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() =back -=item TRANFORMATION FORMATS +=item TRANSFORMATION FORMATS =over 4 @@ -2085,7 +2289,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() =item Quoted-Printable encoding and decoding -=item Caesarian cyphers +=item Caesarian ciphers =back @@ -2103,9 +2307,9 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() IFS access -=item OS/390 +=item OS/390, z/OS -chcp, dataset access, OS/390 iconv, locales +chcp, dataset access, OS/390, z/OS iconv, locales =item VM/ESA? @@ -2119,6 +2323,8 @@ chcp, dataset access, OS/390 iconv, locales =item REFERENCES +=item HISTORY + =item AUTHOR =back @@ -2165,12 +2371,39 @@ chcp, dataset access, OS/390 iconv, locales =item Perl Modules +=item Making your module threadsafe + =back =item SEE ALSO =back +=head2 perlmodinstall - Installing CPAN Modules + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item PREAMBLE + +B the file, B the file into a directory, B the +module (sometimes unnecessary), B the module + +=back + +=item PORTABILITY + +=item HEY + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 perlmodlib - constructing new Perl modules and finding existing ones =over 4 @@ -2185,39 +2418,52 @@ chcp, dataset access, OS/390 iconv, locales attributes, attrs, autouse, base, blib, bytes, charnames, constant, diagnostics, fields, filetest, integer, less, locale, open, ops, overload, -perlio, re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register +re, sigtrap, strict, subs, threads, utf8, vars, warnings, +warnings::register =item Standard Modules -AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, -B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint, -B::Showlex, B::Stackobj, B::Stash, 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, Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, -Dumpvalue, Encode, 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::Path, File::Spec, File::Spec::Epoc, -File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, -File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, -FileHandle, Filter::Simple, 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::LaTeX, 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, Storable, 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 +AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, +B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, +B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, +B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, +CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, +CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, +Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle, +Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env, +Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant, +ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, +ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, 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::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions, +File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, +File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, +Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate, +I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3, +Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country, +Locale::Currency, Locale::Language, Locale::Maketext, +Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, +Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, +Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, +Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT, +Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, +Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, +Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, +PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, +Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, +Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, +Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, +Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, +Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More, +Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced, +Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array, +Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, +Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, +Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent, +User::pwent, Win32 =item Extension Modules @@ -2225,8 +2471,23 @@ User::pwent =item CPAN -Africa, Asia, Australasia, Central America, Europe, North America, South -America +=over 4 + +=item Africa + +=item Asia + +=item Central America + +=item Europe + +=item North America + +=item Oceania + +=item South America + +=back =item Modules: Creation, Use, and Abuse @@ -2234,25 +2495,10 @@ America =item Guidelines for Module Creation -Do similar modules already exist in some form?, Try to design the new -module to be easy to extend and reuse, Some simple style guidelines, Select -what to export, Select a name for the module, Have you got it right?, -README and other Additional Files, A description of the -module/package/extension etc, A copyright notice - see below, Prerequisites -- what else you may need to have, How to build it - possible changes to -Makefile.PL etc, How to install it, Recent changes in this release, -especially incompatibilities, Changes / enhancements you plan to make in -the future, Adding a Copyright Notice, Give the module a -version/issue/release number, How to release and distribute a module, Take -care when changing a released module +Adding a Copyright Notice =item Guidelines for Converting Perl 4 Library Scripts into Modules -There is no requirement to convert anything, Consider the implications, -Make the most of the opportunity, The pl2pm utility will get you started, -Adds the standard Module prologue lines, Converts package specifiers from ' -to ::, Converts die(...) to croak(...), Several other minor changes - =item Guidelines for Reusing Application Code =back @@ -2261,28 +2507,104 @@ to ::, Converts die(...) to croak(...), Several other minor changes =back -=head2 perlmodinstall - Installing CPAN Modules +=head2 perlmodstyle - Perl module style guide =over 4 -=item DESCRIPTION +=item INTRODUCTION + +=item QUICK CHECKLIST =over 4 -=item PREAMBLE +=item Before you start -B the file, B the file into a directory, B the -module (sometimes unnecessary), B the module +=item The API + +=item Stability + +=item Documentation + +=item Release considerations =back -=item PORTABILITY +=item BEFORE YOU START WRITING A MODULE -=item HEY +=over 4 -=item AUTHOR +=item Has it been done before? -=item COPYRIGHT +=item Do one thing and do it well + +=item What's in a name? + +=back + +=item DESIGNING AND WRITING YOUR MODULE + +=over 4 + +=item To OO or not to OO? + +=item Designing your API + +Write simple routines to do simple things, Separate functionality from +output, Provide sensible shortcuts and defaults, Naming conventions, +Parameter passing + +=item Strictness and warnings + +=item Backwards compatibility + +=item Error handling and messages + +=back + +=item DOCUMENTING YOUR MODULE + +=over 4 + +=item POD + +=item README, INSTALL, release notes, changelogs + +=back + +=item RELEASE CONSIDERATIONS + +=over 4 + +=item Version numbering + +=item Pre-requisites + +=item Testing + +=item Packaging + +=item Licensing + +=back + +=item COMMON PITFALLS + +=over 4 + +=item Reinventing the wheel + +=item Trying to do too much + +=item Inappropriate documentation + +=back + +=item SEE ALSO + +L, L, L, L, Testing tools, +http://pause.perl.org/, Any good book on software engineering + +=item AUTHOR =back @@ -2321,8 +2643,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date: -1999/05/23 16:08:30 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 1.2 $, $Date: +2001/11/09 08:06:04 $) =over 4 @@ -2368,8 +2690,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $, -$Date: 1999/10/14 18:46:09 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.3 $, +$Date: 2001/11/09 08:06:04 $) =over 4 @@ -2424,8 +2746,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23 -16:08:30 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.9 $, $Date: 2001/11/09 +08:06:04 $) =over 4 @@ -2451,6 +2773,10 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? +Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, +CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, +MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha + =item Where can I get Perl macros for vi? =item Where can I get perl-mode for emacs? @@ -2467,6 +2793,9 @@ References, Tutorials, Task-Oriented, Special Topics =item How can I make my Perl program take less memory? +Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and +stringification, Pass by reference, Tie large variables to disk + =item Is it unsafe to return a pointer to local data? =item How can I free an array or hash so my program shrinks? @@ -2505,8 +2834,8 @@ mean? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23 -20:37:49 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.8 $, $Date: 2001/11/09 +08:06:04 $) =over 4 @@ -2524,7 +2853,12 @@ numbers I should be getting (eg, 19.95)? =item Does Perl have a round() function? What about ceil() and floor()? Trig functions? -=item How do I convert bits into ints? +=item How do I convert between numeric representations: + +B, B, B, B, B, B =item Why doesn't & work the way I want it to? @@ -2622,7 +2956,8 @@ the tag a), b), c), d), e) -=item How can I tell whether a list or array contains a certain element? +=item How can I tell whether a certain element is contained in a list or +array? =item How do I compute the difference of two arrays? How do I compute the intersection of two arrays? @@ -2714,8 +3049,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23 -16:08:30 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.4 $, $Date: 2001/11/09 +08:06:04 $) =over 4 @@ -2764,6 +3099,9 @@ filehandles between subroutines? How do I make an array of filehandles? =item I still don't get locking. I just want to increment the number in the file. How can I do this? +=item All I want to do is append a small amount of text to the end of a +file. Do I still have to use locking? + =item How do I randomly update a binary file? =item How do I get a file's timestamp in perl? @@ -2804,7 +3142,7 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $) +=head2 perlfaq6 - Regexes ($Revision: 1.4 $, $Date: 2001/11/09 08:06:04 $) =over 4 @@ -2870,8 +3208,8 @@ file? =back -=head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date: -1999/05/23 20:36:18 $) +=head2 perlfaq7 - Perl Language Issues ($Revision: 1.4 $, $Date: 2001/11/07 +02:27:50 $) =over 4 @@ -2949,8 +3287,8 @@ is in scope? =back -=head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23 -18:37:57 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.4 $, $Date: 2001/11/09 +08:06:04 $) =over 4 @@ -3077,7 +3415,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30 +=head2 perlfaq9 - Networking ($Revision: 1.5 $, $Date: 2001/11/09 08:06:04 $) =over 4 @@ -3086,6 +3424,8 @@ $) =over 4 +=item What is the correct form of response from a CGI script? + =item My CGI script runs from the command line but not the browser. (500 Server Error) @@ -3218,6 +3558,8 @@ Perl?>, B, B =item Maintaining a persistent interpreter +=item Execution of END blocks + =item Maintaining multiple interpreter instances =item Using Perl modules, which themselves use C libraries, from your C @@ -3442,7 +3784,7 @@ C, C, C =item The CLEANUP: Keyword -=item The POST_CALL: Keyword +=item The POSTCALL: Keyword =item The BOOT: Keyword @@ -3474,6 +3816,10 @@ C, C, C =item The Typemap +=item Safely Storing Static Data in XS + +MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT + =back =item EXAMPLES @@ -3567,14 +3913,15 @@ C, C

, C, C =item Localizing changes C, C, C, C, -C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, C, -C +C, C, C, C, C, C, C, +C, +C, +C, C, C, C, C, +C, C, +C, C, C =back @@ -3614,6 +3961,8 @@ C =item Compile pass 3: peephole optimization +=item Pluggable runops + =back =item Examining internal data structures with the C functions @@ -3624,15 +3973,19 @@ C =item Background and PERL_IMPLICIT_CONTEXT +=item So what happened to dTHR? + =item How do I use all this in extensions? +=item Should I do anything special if I call perl from multiple threads? + =item Future Plans and PERL_IMPLICIT_SYS =back =item Internal Functions -A, p, d, s, n, r, f, m, o, j, x +A, p, d, s, n, r, f, M, o, j, x =over 4 @@ -3662,6 +4015,8 @@ A, p, d, s, n, r, f, m, o, j, x =back +=item Custom Operators + =item AUTHORS =item SEE ALSO @@ -3773,6 +4128,10 @@ L L, L, L +=item Administration + +L + =item Development L, L, L and L, @@ -3851,55 +4210,71 @@ B AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, -bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv, -CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, -dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, -get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, -gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, -G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, -HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, -hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, +ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, +call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK, +dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND, +fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv, +get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number, +grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod, +gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, +G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, +HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, +hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, -ix, LEAVE, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, -mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB, -newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, -newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, -Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, -perl_construct, perl_destruct, perl_free, perl_parse, perl_run, -PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, -POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, -PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, -SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, -strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, -SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, -SvIOK_UV, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, -SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, -SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, -SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, -SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, -SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV, -SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, -SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, -sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, -sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec, -sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, -sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy, -sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, -sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, -sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, -sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, -sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, -sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, +ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy, +mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, +Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv, +newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, +newSVuv, newXS, newXSproto, Newz, new_vstring, Nullav, Nullch, Nullcv, +Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_clone, perl_construct, +perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na, +PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, +POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, +require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, scan_bin, +scan_hex, scan_oct, sharedsv_find, sharedsv_init, sharedsv_lock, +sharedsv_new, sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock, +sortsv, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, +strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, +SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, +SvIOK_UV, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, +SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, +SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, +SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, +SvPVutf8, SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, +SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, +SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, +SvSetMagicSV, SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, +SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, +SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, +SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVx, SvUVX, sv_2bool, +sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, +sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv, +sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, +sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, +sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec, +sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, +sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, +sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, +sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, +sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, +sv_pvutf8n_force, sv_recode_to_utf8, sv_reftype, sv_replace, +sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, +sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, +sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, +sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, +sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, +sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, -sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, -utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, -utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, -warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, -XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, -XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, -XS_VERSION, XS_VERSION_BOOTCHECK, Zero +sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, +THIS, toLOWER, toUPPER, to_utf8_case, utf8n_to_uvchr, utf8n_to_uvuni, +utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uvchr, +utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, +XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, +XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, +XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, +Zero =item AUTHORS @@ -3915,7 +4290,8 @@ XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item DESCRIPTION djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, -PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob +PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena, +sv_clean_all, sv_clean_objs, sv_free_arenas =item AUTHORS @@ -3939,15 +4315,8 @@ PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob =item Data Structures -1. The functions and attributes of the "layer class", 2. The per-instance -data for a particular handle - =item Functions and Attributes -1. Opening and setup functions, 2. Basic IO operations, 3. Stdio class -buffering options, 4. Functions to support Perl's traditional "fast" access -to the buffer - =item Per-instance Data =item Layers in action. @@ -4037,301 +4406,347 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item DESCRIPTION -=item Infrastructure +=item To do during 5.6.x =over 4 -=item Mailing list archives +=item Support for I/O disciplines -=item Bug tracking system +=item Autoload bytes.pm -=item Regression Tests +=item Make "\u{XXXX}" et al work -Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to -perl5 +=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) -=back +=item Overloadable regex assertions -=item Configure +=item Unicode -=over 4 +=item use Thread for iThreads -=item Install HTML +=item make perl_clone optionally clone ops -=back +=item Work out exit/die semantics for threads -=item Perl Language +=item Typed lexicals for compiler -=over 4 +=item Compiler workarounds for Win32 -=item 64-bit Perl +=item AUTOLOADing in the compiler -=item Prototypes +=item Fixing comppadlist when compiling -Named prototypes, Indirect objects, Method calls, Context, Scoped subs +=item Cleaning up exported namespace -=back +=item Complete signal handling -=item Perl Internals +=item Out-of-source builds -=over 4 +=item POSIX realtime support -=item magic_setisa +=item UNIX98 support -=item Garbage Collection +=item IPv6 Support -=item Reliable signals +=item Long double conversion -Alternate runops() for signal despatch, Figure out how to die() in delayed -sighandler, Add tests for Thread::Signal, Automatic tests against CPAN +=item Locales -=item Interpolated regex performance bugs +=item Thread-safe regexes -=item Memory leaks from failed eval/regcomp +=item Arithmetic on non-Arabic numerals -=item Make XS easier to use +=item POSIX Unicode character classes -=item Make embedded Perl easier to use +=item Factoring out common suffices/prefices in regexps (trie optimization) -=item Namespace cleanup +=item Security audit shipped utilities -=item MULTIPLICITY +=item Custom opcodes -=item MacPerl +=item DLL Versioning -=back +=item Introduce @( and @) -=item Documentation +=item Floating point handling -=over 4 +=item IV/UV preservation -=item A clear division into tutorial and reference +=item Replace pod2html with something using Pod::Parser -=item Remove the artificial distinction between operators and functions +=item Automate module testing on CPAN -=item More tutorials +=item sendmsg and recvmsg -Regular expressions, I/O, pack/unpack, Debugging +=item Rewrite perlre documentation -=item Include a search tool +=item Convert example code to IO::Handle filehandles -=item Include a locate tool +=item Document Win32 choices -=item Separate function manpages by default +=item Check new modules -=item Users can't find the manpages +=item Make roffitall find pods and libs itself -=item Install ALL Documentation +=back -=item Outstanding issues to be documented +=item To do at some point -=item Adapt www.linuxhq.com for Perl +=over 4 -=item Replace man with a perl program +=item Remove regular expression recursion -=item Unicode tutorial +=item Memory leaks after failed eval -=back +=item pack "(stuff)*" -=item Modules +=item bitfields in pack -=over 4 +=item Cross compilation -=item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2 +=item Perl preprocessor / macros -=item Module versions +=item Perl lexer in Perl -=item New modules +=item Using POSIX calls internally -=item Profiler +=item -i rename file when changed -=item Tie Modules +=item All ARGV input should act like EE -VecArray, SubstrArray, VirtualArray, ShiftSplice +=item Support for rerunning debugger -=item Procedural options +=item Test Suite for the Debugger -=item RPC +=item my sub foo { } -=item y2k localtime/gmtime +=item One-pass global destruction -=item Export File::Find variables +=item Rewrite regexp parser -=item Ioctl +=item Cache recently used regexps -=item Debugger attach/detach +=item Re-entrant functions -=item Regular Expression debugger +=item Cross-compilation support -=item Alternative RE Syntax +=item Bit-shifting bitvectors -=item Bundled modules +=item debugger pragma -=item Expect +=item use less pragma -=item GUI::Native +=item switch structures + +=item Cache eval tree -=item Update semibroken auxiliary tools; h2ph, a2p, etc. +=item rcatmaybe -=item pod2html +=item Shrink opcode tables -=item Podchecker +=item Optimize away @_ -=back +=item Prototypes versus indirect objects + +=item Install HTML -=item Tom's Wishes +=item Prototype method calls -=over 4 +=item Return context prototype declarations -=item Webperl +=item magic_setisa + +=item Garbage collection + +=item IO tutorial + +=item pack/unpack tutorial + +=item Rewrite perldoc + +=item Install .3p manpages + +=item Unicode tutorial -=item Mobile agents +=item Update POSIX.pm for 1003.1-2 -=item POSIX on non-POSIX +=item Retargetable installation -=item Portable installations +=item POSIX emulation on non-POSIX systems + +=item Rename Win32 headers + +=item Finish off lvalue functions + +=item Update sprintf documentation + +=item Use fchown/fchmod internally + +=item Make v-strings overloaded objects =back -=item Win32 Stuff +=item Vague ideas =over 4 -=item Rename new headers to be consistent with the rest +=item ref() in list context -=item Sort out the spawnvp() mess +=item Make tr/// return histogram of characters in list context -=item Work out DLL versioning +=item Compile to real threaded code -=item Style-check +=item Structured types -=back +=item Modifiable $1 et al. + +=item Procedural interfaces for IO::*, etc. + +=item RPC modules -=item Would be nice to have +=item Attach/detach debugger from running program -C, Contiguous bitfields in pack/unpack, lexperl, Bundled -perl preprocessor, Use posix calls internally where possible, format -BOTTOM, -i rename file only when successfully changed, All ARGV input -should act like <>, report HANDLE [formats], support in perlmain to rerun -debugger, lvalue functions +=item Alternative RE syntax module -=item Possible pragmas +=item GUI::Native + +=item foreach(reverse ...) + +=item Constant function cache + +=item Approximate regular expression matching + +=back + +=item Ongoing =over 4 -=item 'less' +=item Update guts documentation + +=item Add more tests + +=item Update auxiliary tools =back -=item Optimizations +=item Recently done things =over 4 -=item constant function cache +=item Safe signal handling -=item foreach(reverse...) +=item Tie Modules -=item Cache eval tree +=item gettimeofday -=item rcatmaybe +=item setitimer and getimiter -=item Shrink opcode tables +=item Testing __DIE__ hook -=item Cache hash value +=item CPP equivalent in Perl -=item Optimize away @_ where possible +=item Explicit switch statements -=item Optimize sort by { $a <=> $b } +=item autocroak -=item Rewrite regexp parser for better integrated optimization +=item UTF/EBCDIC -=back +=item UTF Regexes -=item Vague possibilities +=item perlcc to produce executable -ref function in list context, make tr/// return histogram in list context?, -Loop control on do{} et al, Explicit switch statements, compile to real -threaded code, structured types, Modifiable $1 et al +=item END blocks saved in compiled output -=item To Do Or Not To Do +=item Secure temporary file module -=over 4 +=item Integrate Time::HiRes -=item Making my() work on "package" variables +=item Turn Cwd into XS -=item "or" testing defined not truth +=item Mmap for input -=item "dynamic" lexicals +=item Byte to/from UTF8 and UTF8 to/from local conversion -=item "class"-based, rather than package-based "lexicals" +=item Add sockatmark support -=back +=item Mailing list archives -=item Threading +=item Bug tracking -=over 4 +=item Integrate MacPerl -=item Modules +=item Web "nerve center" for Perl -=item Testing +=item Regular expression tutorial + +=item Debugging Tutorial + +=item Integrate new modules -=item $AUTOLOAD +=item Integrate profiler -=item exit/die +=item Y2K error detection -=item External threads +=item Regular expression debugger -=item Thread::Pool +=item POD checker -=item thread-safety +=item "Dynamic" lexicals -=item Per-thread GVs +=item Cache precompiled modules =back -=item Compiler +=item Deprecated Wishes =over 4 -=item Optimization +=item Loop control on do{} -=item Byteperl +=item Lexically scoped typeglobs -=item Precompiled modules +=item format BOTTOM -=item Executables +=item report HANDLE -=item Typed lexicals +=item Generalised want()/caller()) -=item Win32 +=item Named prototypes -=item END blocks +=item Built-in globbing -=item _AUTOLOAD +=item Regression tests for suidperl -=item comppadlist +=item Cached hash values -=item Cached compilation +=item Add compression modules -=back +=item Reorganise documentation into tutorials/references -=item Recently Finished Tasks +=item Remove distinction between functions and operators -=over 4 +=item Make XS easier to use -=item Figure a way out of $^(capital letter) +=item Make embedding easier to use -=item Filenames +=item man for perl -=item Foreign lines +=item my $Package::variable -=item Namespace cleanup +=item "or" tests defined, not truth -=item ISA.pm +=item "class"-based lexicals -=item gettimeofday +=item byteperl + +=item Lazy evaluation / tail recursion removal -=item autocroak? +=item Make "use utf8" the default + +=item Unicode collation and normalization + +=item Create debugging macros =back @@ -4356,9 +4771,21 @@ work?, Patches speak louder than words =item Keeping in sync rsync'ing the source tree, Using rsync over the LAN, Using pushing over the -NFS, rsync'ing the patches, It's easier, It's more recent, It's more -reliable, It's easier, It's a good reference, Finding a start point, -Finding how to fix a bug, Finding the source of misbehaviour +NFS, rsync'ing the patches + +=item Why rsync the source tree + +It's easier to rsync the source tree, It's more recent, It's more reliable + +=item Why rsync the patches + +It's easier to rsync the patches, It's a good reference, Finding a start +point, Finding how to fix a bug, Finding the source of misbehaviour + +=item Perlbug remote interface + +1 http://bugs.perl.org, 2 bugdb@perl.org, 3 +commands_and_bugdids@bugs.perl.org, notes, patches, tests =item Submitting patches @@ -4367,7 +4794,7 @@ F, The perl5-porters FAQ =item Finding Your Way Around -Core modules, Documentation, Configure, Interpreter +Core modules, Tests, Documentation, Configure, Interpreter =item Elements of the interpreter @@ -4394,6 +4821,15 @@ finish, 'enter', print =item Patching +=item Patching a core module + +=item Adding a new function to the core + +=item Writing a test + +F, F, F, F, F, F, +F, F, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -4414,9 +4850,18 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item PERL_DESTRUCT_LEVEL +=item Profiling + +=item Gprof Profiling + +-a, -b, -e routine, -f routine, -s, -z + +=item GCC gcov Profiling + =item Pixie Profiling --h, -l, -p, -h, -i, -l, -testcoverage, -zero +-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, +-z[ero] =item CONCLUSION @@ -4458,7 +4903,21 @@ I =back -=head2 perldelta - what's new for perl v5.7.0 +=head2 perldelta - what will be new for perl v5.8.0 + +=over 4 + +=item DESCRIPTION + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl572delta - what's new for perl v5.7.2 =over 4 @@ -4468,13 +4927,27 @@ I =item Incompatible Changes +=over 4 + +=item 64-bit platforms and malloc + +=item AIX Dynaloading + +=item Socket Extension Dynamic in VMS + +=item Different Definition of the Unicode Character Classes \p{In...} + +=item Deprecations + +=back + =item Core Enhancements =item Modules and Pragmata =over 4 -=item New Modules +=item New Modules and Distributions =item Updated And Improved Modules and Pragmata @@ -4484,12 +4957,12 @@ I =item New Documentation -=item Performance Enhancements - =item Installation and Configuration Improvements =over 4 +=item New Or Improved Platforms + =item Generic Improvements =back @@ -4504,34 +4977,66 @@ I =item New or Changed Diagnostics -=item Changed Internals +=item Source Code Enhancements + +=over 4 + +=item MAGIC constants + +=item Better commented code + +=item Regex pre-/post-compilation items matched up + +=item gcc -Wall + +=back + +=item New Tests =item Known Problems =over 4 -=item Unicode Support Still Far From Perfect +=item AIX -=item EBCDIC Still A Lost Platform +=item Amiga Perl Invoking Mystery -=item Building Extensions Can Fail Because Of Largefiles +=item lib/ftmp-security tests warn 'system possibly insecure' -=item ftmp-security tests warn 'system possibly insecure' +=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 -=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX +=item HP-UX lib/io_multihomed Fails When LP64-Configured -=item Long Doubles Still Don't Work In Solaris +=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured =item Linux With Sfio Fails op/misc Test 48 -=item sprintf tests 129 and 130 +=item OS/390 -=item Storable tests fail in some platforms +=item op/sprintf tests 129 and 130 -=item Threads Are Still Experimental +=item Failure of Thread tests + +=item UNICOS + +=item UTS + +=item VMS + +=item Win32 + +=item Localising a Tied Variable Leaks Memory + +=item Self-tying of Arrays and Hashes Is Forbidden + +=item Variable Attributes are not Currently Usable for Tieing + +=item Building Extensions Can Fail Because Of Largefiles =item The Compiler Suite Is Still Experimental +=item The Long Double Support is Still Experimental + =back =item Reporting Bugs @@ -4542,160 +5047,370 @@ I =back -=head2 perl56delta, perldelta - what's new for perl v5.6.0 +=head2 perl571delta - what's new for perl v5.7.1 =over 4 =item DESCRIPTION +=item Security Vulnerability Closed + +=item Incompatible Changes + =item Core Enhancements =over 4 -=item Interpreter cloning, threads, and concurrency +=item AUTOLOAD Is Now Lvaluable -=item Lexically scoped warning categories +=item PerlIO is Now The Default -=item Unicode and UTF-8 support +=item Signals Are Now Safe -=item Support for interpolating named characters +=back -=item "our" declarations +=item Modules and Pragmata -=item Support for strings represented as a vector of ordinals +=over 4 -=item Improved Perl version numbering system +=item New Modules -=item New syntax for declaring subroutine attributes +=item Updated And Improved Modules and Pragmata -=item File and directory handles can be autovivified +=back -=item open() with more than two arguments +=item Performance Enhancements -=item 64-bit support +=item Utility Changes -=item Large file support +=item New Documentation -=item Long doubles +=over 4 -=item "more bits" +=item perlclib -=item Enhanced support for sort() subroutines +=item perliol -=item C allowed +=item README.aix -=item File globbing implemented internally +=item README.bs2000 -=item Support for CHECK blocks +=item README.macos -=item POSIX character class syntax [: :] supported +=item README.mpeix -=item Better pseudo-random number generator +=item README.solaris -=item Improved C operator +=item README.vos -=item Better worst-case behavior of hashes +=item Porting/repository.pod -=item pack() format 'Z' supported +=back -=item pack() format modifier '!' supported +=item Installation and Configuration Improvements -=item pack() and unpack() support counted strings +=over 4 -=item Comments in pack() templates +=item New Or Improved Platforms -=item Weak references +=item Generic Improvements -=item Binary numbers supported +d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, +need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, +d_strtoq, d_u32align, d_ualarm, d_usleep -=item Lvalue subroutines +=back -=item Some arrows may be omitted in calls through references +=item Selected Bug Fixes -=item Boolean assignment operators are legal lvalues +=over 4 -=item exists() is supported on subroutine names +=item Platform Specific Changes and Fixes -=item exists() and delete() are supported on array elements +=back -=item Pseudo-hashes work better +=item New or Changed Diagnostics -=item Automatic flushing of output buffers +=item Changed Internals -=item Better diagnostics on meaningless filehandle operations +=item New Tests -=item Where possible, buffered data discarded from duped input filehandle +=item Known Problems -=item eof() has the same old magic as <> +=over 4 -=item binmode() can be used to set :crlf and :raw modes +=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl -=item C<-T> filetest recognizes UTF-8 encoded files as "text" +=item lib/ftmp-security tests warn 'system possibly insecure' -=item system(), backticks and pipe open now reflect exec() failure +=item lib/io_multihomed Fails In LP64-Configured HP-UX -=item Improved diagnostics +=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX -=item Diagnostics follow STDERR +=item lib/b test 19 -=item More consistent close-on-exec behavior +=item Linux With Sfio Fails op/misc Test 48 -=item syswrite() ease-of-use +=item sigaction test 13 in VMS -=item Better syntax checks on parenthesized unary operators +=item sprintf tests 129 and 130 -=item Bit operators support full native integer width +=item Failure of Thread tests -=item Improved security features +=item Localising a Tied Variable Leaks Memory -=item More functional bareword prototype (*) +=item Self-tying of Arrays and Hashes Is Forbidden -=item C and C may be overridden +=item Building Extensions Can Fail Because Of Largefiles -=item $^X variables may now have names longer than one character +=item The Compiler Suite Is Still Experimental -=item New variable $^C reflects C<-c> switch +=back -=item New variable $^V contains Perl version as a string +=item Reporting Bugs -=item Optional Y2K warnings +=item SEE ALSO -=item Arrays now always interpolate into double-quoted strings +=item HISTORY =back -=item Modules and Pragmata +=head2 perl570delta - what's new for perl v5.7.0 =over 4 -=item Modules +=item DESCRIPTION -attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, -DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, -Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, -File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, -Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, -podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, -pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, -Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters +=item Security Vulnerability Closed -=item Pragmata +=item Incompatible Changes -=back +=item Core Enhancements -=item Utility Changes +=item Modules and Pragmata =over 4 -=item dprofpp +=item New Modules -=item find2perl +=item Updated And Improved Modules and Pragmata -=item h2xs +=back -=item perlcc +=item Utility Changes -=item perldoc +=item New Documentation + +=item Performance Enhancements + +=item Installation and Configuration Improvements + +=over 4 + +=item Generic Improvements + +=back + +=item Selected Bug Fixes + +=over 4 + +=item Platform Specific Changes and Fixes + +=back + +=item New or Changed Diagnostics + +=item Changed Internals + +=item Known Problems + +=over 4 + +=item Unicode Support Still Far From Perfect + +=item EBCDIC Still A Lost Platform + +=item Building Extensions Can Fail Because Of Largefiles + +=item ftmp-security tests warn 'system possibly insecure' + +=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX + +=item Long Doubles Still Don't Work In Solaris + +=item Linux With Sfio Fails op/misc Test 48 + +=item Storable tests fail in some platforms + +=item Threads Are Still Experimental + +=item The Compiler Suite Is Still Experimental + +=back + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl56delta, perldelta - what's new for perl v5.6.0 + +=over 4 + +=item DESCRIPTION + +=item Core Enhancements + +=over 4 + +=item Interpreter cloning, threads, and concurrency + +=item Lexically scoped warning categories + +=item Unicode and UTF-8 support + +=item Support for interpolating named characters + +=item "our" declarations + +=item Support for strings represented as a vector of ordinals + +=item Improved Perl version numbering system + +=item New syntax for declaring subroutine attributes + +=item File and directory handles can be autovivified + +=item open() with more than two arguments + +=item 64-bit support + +=item Large file support + +=item Long doubles + +=item "more bits" + +=item Enhanced support for sort() subroutines + +=item C allowed + +=item File globbing implemented internally + +=item Support for CHECK blocks + +=item POSIX character class syntax [: :] supported + +=item Better pseudo-random number generator + +=item Improved C operator + +=item Better worst-case behavior of hashes + +=item pack() format 'Z' supported + +=item pack() format modifier '!' supported + +=item pack() and unpack() support counted strings + +=item Comments in pack() templates + +=item Weak references + +=item Binary numbers supported + +=item Lvalue subroutines + +=item Some arrows may be omitted in calls through references + +=item Boolean assignment operators are legal lvalues + +=item exists() is supported on subroutine names + +=item exists() and delete() are supported on array elements + +=item Pseudo-hashes work better + +=item Automatic flushing of output buffers + +=item Better diagnostics on meaningless filehandle operations + +=item Where possible, buffered data discarded from duped input filehandle + +=item eof() has the same old magic as <> + +=item binmode() can be used to set :crlf and :raw modes + +=item C<-T> filetest recognizes UTF-8 encoded files as "text" + +=item system(), backticks and pipe open now reflect exec() failure + +=item Improved diagnostics + +=item Diagnostics follow STDERR + +=item More consistent close-on-exec behavior + +=item syswrite() ease-of-use + +=item Better syntax checks on parenthesized unary operators + +=item Bit operators support full native integer width + +=item Improved security features + +=item More functional bareword prototype (*) + +=item C and C may be overridden + +=item $^X variables may now have names longer than one character + +=item New variable $^C reflects C<-c> switch + +=item New variable $^V contains Perl version as a string + +=item Optional Y2K warnings + +=item Arrays now always interpolate into double-quoted strings + +=back + +=item Modules and Pragmata + +=over 4 + +=item Modules + +attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, +DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, +Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, +File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, +Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, +podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, +pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, +Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters + +=item Pragmata + +=back + +=item Utility Changes + +=over 4 + +=item dprofpp + +=item find2perl + +=item h2xs + +=item perlcc + +=item perldoc =item The Perl Debugger @@ -5324,9 +6039,7 @@ long, Process terminated by SIG%s =item 64-bit Perl -=item GDBM and Threads - -=item NFS filesystems and utime(2) +=item AIX 4.2 and extensions using C++ with statics =back @@ -5336,6 +6049,16 @@ long, Process terminated by SIG%s =back +=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=back + =head2 perlamiga - Perl under Amiga OS =over 4 @@ -5350,7 +6073,7 @@ long, Process terminated by SIG%s =over 4 -=item Prerequisites +=item Prerequisites for Compiling Perl on AmigaOS B, B @@ -5366,31 +6089,29 @@ B, B =over 4 -=item Manpages +=item Manpages for Perl on AmigaOS -=item B +=item Perl HTML Documentation on AmigaOS -=item B C files +=item Perl GNU Info Files on AmigaOS -=item C docs +=item Perl LaTeX Documentation on AmigaOS =back -=item BUILD +=item BUILDING PERL ON AMIGAOS =over 4 -=item Prerequisites - -=item Getting the perl source +=item Build Prerequisites for Perl on AmigaOS -=item Making +=item Getting the Perl Source for AmigaOS -sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib +=item Making Perl on AmigaOS -=item Testing +=item Testing Perl on AmigaOS -=item Installing the built perl +=item Installing the built Perl on AmigaOS =back @@ -5400,6 +6121,26 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back +=head2 perlbeos, README.beos - Perl version 5 on BeOS + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item General Issues with Perl on BeOS + +=item BeOS Release-specific Notes + +R4 x86, R4 PPC + +=item Contact Information + +=back + +=back + =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. =over 4 @@ -5410,23 +6151,23 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =over 4 -=item gzip +=item gzip on BS2000 -=item bison +=item bison on BS2000 -=item Unpacking +=item Unpacking Perl Distribution on BS2000 -=item Compiling +=item Compiling Perl on BS2000 -=item Testing +=item Testing Perl on BS2000 -=item Install +=item Installing Perl on BS2000 -=item Using Perl in the Posix-Shell +=item Using Perl in the Posix-Shell of BS2000 =item Using Perl in "native" BS2000 -=item Floating point anomalies +=item Floating point anomalies on BS2000 =back @@ -5444,84 +6185,106 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back -=head2 perlcygwin, README.cygwin - Perl for Cygwin - =over 4 -=item SYNOPSIS +=item Name + +=item Description -=item PREREQUISITES +=item Build =over 4 -=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) +=item Tools & SDK -=item Cygwin Configuration +=item Make -C, I, Permissions +=back + +=item Acknowledgements + +=item Author + +=back + +=head2 perlcygwin, README.cygwin - Perl for Cygwin + +=over 4 + +=item SYNOPSIS + +=item PREREQUISITES FOR COMPILING PERL ON CYGWIN + +=over 4 + +=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) + +=item Cygwin Configuration + +C, I, Permissions =back -=item CONFIGURE +=item CONFIGURE PERL ON CYGWIN =over 4 -=item Strip Binaries +=item Stripping Perl Binaries on Cygwin -=item Optional Libraries +=item Optional Libraries for Perl on Cygwin C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), C<-lcygipc> (C) -=item Configure-time Options +=item Configure-time Options for Perl on Cygwin C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>, C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles> -=item Suspicious Warnings +=item Suspicious Warnings on Cygwin I, Win9x and C, Compiler/Preprocessor defines =back -=item MAKE +=item MAKE ON CYGWIN =over 4 -=item Warnings +=item Warnings on Cygwin -=item ld2 +=item ld2 on Cygwin =back -=item TEST +=item TEST ON CYGWIN =over 4 -=item File Permissions +=item File Permissions on Cygwin -=item Hard Links +=item Hard Links on Cygwin -=item Filetime Granularity +=item Filetime Granularity on Cygwin -=item Tainting Checks +=item Tainting Checks on Cygwin -=item /etc/group +=item /etc/group on Cygwin -=item Script Portability +=item Script Portability on Cygwin Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous =back -=item INSTALL +=item INSTALL PERL ON CYGWIN -=item MANIFEST +=item MANIFEST ON CYGWIN Documentation, Build, Configure, Make, Install, Tests, Compiled Perl Source, Compiled Module Source, Perl Modules/Scripts -=item BUGS +=item BUGS ON CYGWIN =item AUTHORS @@ -5529,6 +6292,82 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldgux - Perl under DG/UX. + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=item BUILDING PERL ON DG/UX + +=over 4 + +=item Non-threaded Perl on DG/UX + +=item Threaded Perl on DG/UX + +=item Testing Perl on DG/UX + +=item Installing the built perl on DG/UX + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 perldos - Perl under DOS, W31, W95. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Prerequisites for Compiling Perl on DOS + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building Perl on DOS + +=item Testing Perl on DOS + +=item Installation of Perl on DOS + +=back + +=item BUILDING AND INSTALLING MODULES ON DOS + +=over 4 + +=item Building Prerequisites for Perl on DOS + +=item Unpacking CPAN Modules on DOS + +=item Building Non-XS Modules on DOS + +=item Building XS Modules on DOS + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -5547,21 +6386,21 @@ Source, Compiled Module Source, Perl Modules/Scripts =over 4 -=item I/O Redirection +=item I/O Redirection on Epoc -=item PATH Names +=item PATH Names on Epoc -=item Editors +=item Editors on Epoc -=item Features +=item Features of Perl on Epoc -=item Restrictions +=item Restrictions of Perl on Epoc =item Compiling Perl 5 on the EPOC cross compiling environment =back -=item SUPPORT STATUS +=item SUPPORT STATUS OF PERL ON EPOC =item AUTHOR @@ -5578,6 +6417,8 @@ Source, Compiled Module Source, Perl Modules/Scripts =over 4 +=item Using perl as shipped with HP-UX + =item Compiling Perl 5 on HP-UX =item PA-RISC @@ -5588,32 +6429,56 @@ Source, Compiled Module Source, Perl Modules/Scripts =item PA-RISC 2.0 +=item Itanium + =item Portability Between PA-RISC Versions +=item Itanium Processor Family and HP-UX + =item Building Dynamic Extensions on HP-UX =item The HP ANSI C Compiler -=item Using Large Files with Perl +=item Using Large Files with Perl on HP-UX -=item Threaded Perl +=item Threaded Perl on HP-UX -=item 64-bit Perl +=item 64-bit Perl on HP-UX -=item GDBM and Threads +=item GDBM and Threads on HP-UX -=item NFS filesystems and utime(2) +=item NFS filesystems and utime(2) on HP-UX -=item perl -P and // +=item perl -P and // and HP-UX + +=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl =back +=item nss_delete core dump from op/pwent or op/grent + =item AUTHOR =item DATE =back +=head2 perlhurd, README.hurd - Perl version 5 on Hurd + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Known Problems with Perl on Hurd + +=back + +=item AUTHOR + +=back + =head2 perlmachten, README.machten - Perl version 5 on Power MachTen systems @@ -5625,11 +6490,11 @@ systems =item Compiling Perl 5 on MachTen -=item Failures during C +=item Failures during C on MachTen op/lexassign.t, pragma/warnings.t -=item Building external modules +=item Building external modules on MachTen =back @@ -5639,27 +6504,102 @@ op/lexassign.t, pragma/warnings.t =back -=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE +=head2 perlmacos, README.macos - Perl under Mac OS (Classic) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item DATE + +=back + +=head2 perlmint, README.mint - Perl version 5 on Atari MiNT + +=over 4 + +=item DESCRIPTION + +=item Known problems with Perl on MiNT + +=item AUTHOR + +=back -=head1 SYNOPSIS +=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE =over 4 -=item What's New +=item SYNOPSIS + +=item NOTE + +=item What's New in Perl for MPE/iX -=item System Requirements +=item Welcome to Perl/iX + +=item System Requirements for Perl/iX =item How to Obtain Perl/iX -=item Distribution Contents Highlights +=item Perl/iX Distribution Contents Highlights + +README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, +public_html/feedback.cgi, src/perl-5.6.0-mpe -README, public_html/feedback.cgi, 4, 6 +=item How to Compile Perl/iX + + 4, 6 =item Getting Started with Perl/iX =item MPE/iX Implementation Considerations -=item Change History +=item Known Perl/iX Bugs Under Investigation + +=item Perl/iX To-Do List + +=item Perl/iX Change History + +=item AUTHOR + +=item Name + +=item Description + +=item Build + +=over 4 + +=item Tools & SDK + +=item Setup + +Buildtype.bat, SetNWBld.bat, MPKBuild.bat + +=item Make + +=item Interpreter + +=item Extensions + +=back + +=item Install + +=item Build new extensions + +=item Known Issues + +=item Acknowledgements + +=item Authors + +=item Date =back @@ -5887,7 +6827,14 @@ C, C =item Priorities -=item DLL name mangling +=item DLL name mangling: pre 5.6.2 + +=item DLL name mangling: 5.6.2 and beyond + +Global DLLs, specific DLLs, C and C, F<.> from +C + +=item DLL forwarder generation =item Threading @@ -5901,6 +6848,8 @@ C, F =back +=item BUGS + =back =over 4 @@ -5921,25 +6870,25 @@ C, F =over 4 -=item Unpacking +=item Unpacking Perl distribution on OS/390 -=item Setup and utilities +=item Setup and utilities for Perl on OS/390 -=item Configure +=item Configure Perl on OS/390 -=item Build, test, install +=item Build, Test, Install Perl on OS/390 -=item build anomalies +=item Build Anomalies with Perl on OS/390 -=item testing anomalies +=item Testing Anomalies with Perl on OS/390 -=item installation anomalies +=item Installation Anomalies with Perl on OS/390 -=item Usage Hints +=item Usage Hints for Perl on OS/390 -=item Floating point anomalies +=item Floating Point Anomalies with Perl on OS/390 -=item Modules and Extensions +=item Modules and Extensions for Perl on OS/390 =back @@ -5949,7 +6898,7 @@ C, F =over 4 -=item Mailing list +=item Mailing list for Perl on OS/390 =back @@ -5957,6 +6906,68 @@ C, F =back +=head2 perlqnx, README.qnx - Perl version 5 on QNX + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Required Software for Compiling Perl on QNX4 + +/bin/sh, ar, nm, cpp, make + +=item Outstanding Issues with Perl on QNX4 + +=item QNX auxiliary files + +qnx/ar, qnx/cpp + +=item Outstanding issues with perl under QNX6 + +=back + +=item AUTHOR + +=back + +=head2 perlplan9 - Plan 9-specific documentation for Perl + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Invoking Perl + +=item What's in Plan 9 Perl + +=item What's not in Plan 9 Perl + +=item Perl5 Functions not currently supported in Plan 9 Perl + +=item Signals in Plan 9 Perl + +=back + +=item COMPILING AND INSTALLING PERL ON PLAN 9 + +=over 4 + +=item Installing Perl Documentation on Plan 9 + +=back + +=item BUGS + +=item Revision date + +=item AUTHOR + +=back + =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems =over 4 @@ -5977,11 +6988,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation =over 4 -=item File Extraction Problems. +=item File Extraction Problems on Solaris. -=item Compiler and Related Tools. +=item Compiler and Related Tools on Solaris. -=item Environment +=item Environment for Compiling Perl on Solaris =back @@ -5989,11 +7000,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation =over 4 -=item 64-bit Issues. +=item 64-bit Issues with Perl on Solaris. -=item Threads. +=item Threads in Perl on Solaris. -=item Malloc Issues. +=item Malloc Issues with Perl on Solaris. =back @@ -6007,17 +7018,19 @@ DATAMODEL_NATIVE specified", sh: ar: not found =over 4 -=item op/stat.t test 4 +=item op/stat.t test 4 in Solaris + +=item nss_delete core dump from op/pwent or op/grent =back -=item PREBUILT BINARIES. +=item PREBUILT BINARIES OF PERL FOR SOLARIS. -=item RUNTIME ISSUES. +=item RUNTIME ISSUES FOR PERL ON SOLARIS. =over 4 -=item Limits on Numbers of Open Files. +=item Limits on Numbers of Open Files on Solaris. =back @@ -6027,11 +7040,11 @@ DATAMODEL_NATIVE specified", sh: ar: not found =over 4 -=item Proc::ProcessTable +=item Proc::ProcessTable on Solaris -=item BSD::Resource +=item BSD::Resource on Solaris -=item Net::SSLeay +=item Net::SSLeay on Solaris =back @@ -6041,7 +7054,36 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back -=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. +=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as +Digital UNIX formerly known as DEC OSF/1) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compiling Perl 5 on Tru64 + +=item Using Large Files with Perl on Tru64 + +=item Threaded Perl on Tru64 + +=item Long Doubles on Tru64 + +=item 64-bit Perl on Tru64 + +=item Warnings about floating-point overflow when compiling Perl on Tru64 + +=back + +=item Testing Perl on Tru64 + +=item AUTHOR + +=back + +=head2 perluts - Perl under UTS =over 4 @@ -6049,28 +7091,33 @@ DATAMODEL_NATIVE specified", sh: ar: not found =item DESCRIPTION +=item BUILDING PERL ON UTS + +=item Installing the built perl on UTS + +=item AUTHOR + +=back + +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + =over 4 -=item Unpacking +=item SYNOPSIS + +=item DESCRIPTION -=item Setup and utilities +=over 4 -=item Configure +=item Unpacking Perl Distribution on VM/ESA -Don't turn on the compiler optimization flag "-O". There's a bug in the -compiler (APAR PQ18812) that generates some bad code the optimizer is on, -As VM/ESA doesn't fully support the fork() API programs relying on this -call will not work. I've replaced fork()/exec() with spawn() and the -standalone exec() with spawn(). This has a side effect when opening unnamed -pipes in a shell script: there is no child process generated under +=item Setup Perl and utilities on VM/ESA -=item testing anomalies +=item Configure Perl on VM/ESA -=item Usage Hints +=item Testing Anomalies of Perl on VM/ESA -When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII -character sets are different. Perl builtin functions that may behave -differently under EBCDIC are mentioned in the perlport.pod document. +=item Usage Hints for Perl on VM/ESA =back @@ -6080,7 +7127,7 @@ differently under EBCDIC are mentioned in the perlport.pod document. =over 4 -=item Mailing list +=item Mailing list for Perl on VM/ESA =back @@ -6143,7 +7190,7 @@ LIST, waitpid PID,FLAGS =item Perl variables -%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $| +%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| =item Standard modules with VMS-specific differences @@ -6185,9 +7232,9 @@ LIST, waitpid PID,FLAGS =over 4 -=item Unimplemented Features +=item Unimplemented Features of Perl on VOS -=item Restrictions +=item Restrictions of Perl on VOS =back @@ -6199,9 +7246,7 @@ LIST, waitpid PID,FLAGS =back -=head1 PRAGMA DOCUMENTATION - -=head2 attrs - set/get attributes of a subroutine (deprecated) +=head2 perlwin32 - Perl under Win32 =over 4 @@ -6209,7 +7254,51 @@ LIST, waitpid PID,FLAGS =item DESCRIPTION -method, locked +=over 4 + +=item Setting Up Perl on Win32 + +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC + +=item Building + +=item Testing Perl on Win32 + +=item Installation of Perl on Win32 + +=item Usage Hints for Perl on Win32 + +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Running Perl Scripts, Miscellaneous Things + +=back + +=item BUGS AND CAVEATS + +=item AUTHORS + +Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE + +=item SEE ALSO + +=item HISTORY + +=back + +=head1 PRAGMA DOCUMENTATION + +=head2 attrs - set/get attributes of a subroutine (deprecated) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +method, locked =back @@ -6223,6 +7312,58 @@ method, locked =back +=head2 threadshared::shared, threads::shared - Perl extension for sharing +data structures between threads + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPORT + +=item FUNCTIONS + +share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE, +cond_signal VARIABLE, cond_broadcast VARIABLE + +=item BUGS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 threads - Perl extension allowing use of interpreter based threads +from perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$thread = new(function, LIST), $thread->join, $thread->detach, +threads->self, $thread->tid + +=item TODO + +Fix so the return value is returned when you join, Add join_all, Fix memory +leaks! + +=item AUTHOR and COPYRIGHT + +=item BUGS + +creating a thread from within a thread is unsafe under win32, +PERL_OLD_SIGNALS are not threadsafe, will not be + +=item SEE ALSO + +=back + =head2 attributes - get/set subroutine or variable attributes =over 4 @@ -6337,7 +7478,7 @@ semantics =back =head2 charnames - define character names for C<\N{named}> string literal -escape. +escapes. =over 4 @@ -6347,6 +7488,8 @@ escape. =item CUSTOM TRANSLATORS +=item charnames::viacode(code) + =item BUGS =back @@ -6361,7 +7504,17 @@ escape. =item NOTES -=item TECHNICAL NOTE +=over 4 + +=item List constants + +=item Defining multiple constants at once + +=item Magic constants + +=back + +=item TECHNICAL NOTES =item BUGS @@ -6398,6 +7551,21 @@ diagnostics =back +=head2 encoding - pragma to control the conversion of legacy data into +Unicode + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item KNOWN PROBLEMS + +=item SEE ALSO + +=back + =head2 fields - compile-time class fields =over 4 @@ -6492,7 +7660,9 @@ operations =item DESCRIPTION -=item UNIMPLEMENTED FUNCTIONALITY +=item NONPERLIO FUNCTIONALITY + +=item IMPLEMENTATION DETAILS =item SEE ALSO @@ -6609,26 +7779,6 @@ type, `%s' is not a code reference =back -=head2 perlio - perl pragma to configure C level IO - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -unix, stdio, perlio - -=over 4 - -=item Defaults and how to override them - -=back - -=item AUTHOR - -=back - =head2 re - Perl pragma to alter regular expression behaviour =over 4 @@ -6691,8 +7841,36 @@ C, C, C =back -=head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data -and non-UTF data. +=head2 threads - Perl extension allowing use of interpreter based threads +from perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$thread = new(function, LIST), $thread->join, $thread->detach, +threads->self, $thread->tid + +=item TODO + +Fix so the return value is returned when you join, Add join_all, Fix memory +leaks! + +=item AUTHOR and COPYRIGHT + +=item BUGS + +creating a thread from within a thread is unsafe under win32, +PERL_OLD_SIGNALS are not threadsafe, will not be + +=item SEE ALSO + +=back + +=head2 threadshared, threads::shared - Perl extension for sharing data +structures between threads =over 4 @@ -6700,11 +7878,23 @@ and non-UTF data. =item DESCRIPTION +=item EXPORT + +=item FUNCTIONS + +share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE, +cond_signal VARIABLE, cond_broadcast VARIABLE + +=item BUGS + +=item AUTHOR + =item SEE ALSO =back -=head2 utf8 - Perl pragma to enable/disable UTF-8 in source code +=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source +code =over 4 @@ -6735,6 +7925,18 @@ utf8::encode($string), $flag = utf8::decode($string) =back +=head2 vmsish - Perl pragma to control VMS-specific language features + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +C, C, C, C + +=back + =head2 warnings - Perl pragma to control optional warnings =over 4 @@ -6753,6 +7955,14 @@ warnings::warnif($object, $message) =head2 warnings::register - warnings import function +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + =head1 MODULE DOCUMENTATION =head2 AnyDBM_File - provide framework for multiple DBMs @@ -6775,6 +7985,49 @@ warnings::warnif($object, $message) =back +=head2 Attribute::Handlers - Simpler definition of attribute handlers + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item DESCRIPTION + +[0], [1], [2], [3], [4], [5] + +=over 4 + +=item Typed lexicals + +=item Type-specific attribute handlers + +=item Non-interpretive attribute handlers + +=item Phase-specific attribute handlers + +=item Attributes as C interfaces + +=back + +=item EXAMPLES + +=item DIAGNOSTICS + +C, C, C, C, +C, C + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT + +=back + =head2 AutoLoader - load subroutines only on demand =over 4 @@ -6845,7 +8098,7 @@ REFCNT, FLAGS =item B::IV METHODS -IV, IVX, needs64bits, packiv +IV, IVX, UVX, int_value, needs64bits, packiv =item B::NV METHODS @@ -6857,7 +8110,7 @@ RV =item B::PV METHODS -PV +PV, PVX =item B::PVMG METHODS @@ -6877,8 +8130,8 @@ USEFUL, PREVIOUS, RARE, TABLE =item B::GV METHODS -is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE, -FILEGV, GvREFCNT, FLAGS +is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, +LINE, FILE, FILEGV, GvREFCNT, FLAGS =item B::IO METHODS @@ -6950,8 +8203,9 @@ label, stash, file, cop_seq, arybase, line main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), -walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), -hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names +walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV), +ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), +threadsv_names =item AUTHOR @@ -7108,6 +8362,8 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> =back +=item Using B::Concise outside of the O framework + =item AUTHOR =back @@ -7134,7 +8390,7 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> =item OPTIONS -B<-l>, B<-p>, B<-q>, B<-u>I, B<-s>I, B, BI, +B<-l>, B<-p>, B<-q>, B<-f>I, B<-s>I, B, BI, B, BIB<.>, B<-x>I =item USING B::Deparse AS A MODULE @@ -7147,6 +8403,10 @@ B, BIB<.>, B<-x>I =item new +=item ambient_pragmas + +strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits + =item coderef2text =back @@ -7299,8 +8559,8 @@ TIMEDIFF, [ STYLE, [ FORMAT ] ] ) =item Optional Exports clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [ -STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( -), enablecache ( ), timesum ( T1, T2 ) +STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), +disablecache ( ), enablecache ( ), timesum ( T1, T2 ) =back @@ -7407,8 +8667,9 @@ B<:standard>, B<:all> =item PRAGMAS --any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls, --autoload, -no_debug, -debug, -private_tempfiles +-any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, +-newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, +-private_tempfiles =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS @@ -7518,7 +8779,8 @@ B =item CREATING A CLICKABLE IMAGE BUTTON -B +B, 3. The third option (-align, optional) is an alignment +type, and may be TOP, BOTTOM or MIDDLE =item CREATING A JAVASCRIPT ACTION BUTTON @@ -7548,8 +8810,9 @@ the

tag =item FETCHING ENVIRONMENT VARIABLES B, 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, B @@ -7691,6 +8954,10 @@ B, B, B, B, B =item USING FASTCGI SCRIPTS AS CGI SCRIPTS +=item EXTERNAL FASTCGI SERVER INVOCATION + +FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE + =item CAVEATS =item AUTHOR INFORMATION @@ -7948,6 +9215,28 @@ module =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside +=head2 Class::ISA -- report the search path for a class's ISA tree + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +the function Class::ISA::super_path($CLASS), the function +Class::ISA::self_and_super_path($CLASS), the function +Class::ISA::self_and_super_versions($CLASS) + +=item CAUTIONARY NOTES + +=item COPYRIGHT + +=item AUTHOR + +=back + =head2 Class::Struct - declare struct-like datatypes as Perl classes =over 4 @@ -8003,9 +9292,10 @@ C<_a>, C<_exe>, C<_o> =item a -C, C, C, C, C, -C, C, 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 b @@ -8017,13 +9307,9 @@ C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C - -=item C - -C, C, C, C, C, C, -C, C, C, 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 d @@ -8031,81 +9317,91 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, 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 C, C, C, C, C, C, -C, C, C +C, C, C, C =item f C, C, C, C, C, -C, C, C, C, C, C +C, C, C, C, C, C, +C =item g @@ -8120,28 +9416,28 @@ C, C, C, C C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, +C, C, 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 k @@ -8182,7 +9478,7 @@ C, C, C, C =item p C, C, C, C, C, C, -C +C, C =item P @@ -8198,7 +9494,7 @@ C, C =item r C, C, C, C, C, -C, C, C, C +C, C, C, C, C =item s @@ -8219,26 +9515,27 @@ C, C, C, C, C =item t -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 u C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C +C, C, C, C, +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 v C, C, C, C, C, C, C, C, -C, C, C, C, C +C, C, C, +C, C, C =item x @@ -8266,6 +9563,24 @@ C, C =item DESCRIPTION +=over 4 + +=item getcwd and friends + +getcwd, cwd, fastcwd, fastgetcwd + +=item abs_path and friends + +abs_path, realpath, fast_abs_path + +=item $ENV{PWD} + +=back + +=item NOTES + +=item SEE ALSO + =back =head2 DB - programmatic interface to the Perl debugging API (draft, @@ -8317,7 +9632,7 @@ B, B, B =over 4 -=item Using DB_File with Berkeley DB version 2 or 3 +=item Using DB_File with Berkeley DB version 2 or greater =item Interface to Berkeley DB @@ -8366,7 +9681,8 @@ B, B, B =item Extra RECNO Methods B<$X-Epush(list) ;>, B<$value = $X-Epop ;>, B<$X-Eshift>, -B<$X-Eunshift(list) ;>, B<$X-Elength> +B<$X-Eunshift(list) ;>, B<$X-Elength>, B<$X-Esplice(offset, +length, elements);> =item Another Example @@ -8475,7 +9791,10 @@ $Data::Dumper::Toaster I $I->Toaster(I<[NEWVAL]>), $Data::Dumper::Deepcopy I $I->Deepcopy(I<[NEWVAL]>), $Data::Dumper::Quotekeys I $I->Quotekeys(I<[NEWVAL]>), $Data::Dumper::Bless I $I->Bless(I<[NEWVAL]>), -$Data::Dumper::Maxdepth I $I->Maxdepth(I<[NEWVAL]>) +$Data::Dumper::Maxdepth I $I->Maxdepth(I<[NEWVAL]>), +$Data::Dumper::Useperl I $I->Useperl(I<[NEWVAL]>), +$Data::Dumper::Sortkeys I $I->Sortkeys(I<[NEWVAL]>), +$Data::Dumper::Deparse I $I->Deparse(I<[NEWVAL]>) =item Exports @@ -8525,6 +9844,8 @@ Dumper =over 4 +=item Runtime debugging + =item Memory footprint debugging =back @@ -8630,6 +9951,8 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest =item DESCRIPTION +=item NOTES + =back =head2 Dumpvalue - provides screen dump of Perl data. @@ -8645,8 +9968,8 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest =item Creation C, C, C, C, C, -C, C, C, C, C, -C, C, unctrl, subdump, bareStringify, quoteHighBit, +C, C, C, C, C, +C, C, unctrl, subdump, bareStringify, quoteHighBit, stopDbSignal =item Methods @@ -8720,8 +10043,8 @@ Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings =item Encoding Names -The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry, -The name used by the the organization that defined it +The MIME name as defined in IETF RFCs, The name in the IANA registry, The +name used by the organization that defined it =back @@ -8755,7 +10078,7 @@ reference, e.g.: =item Encoding How to ... IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 -strings in binary data, perl/Encode wrappers on non-Unicode XS modules +strings in binary data, Perl/Encode wrappers on non-Unicode XS modules =item Messing with Perl's Internals @@ -8907,7 +10230,7 @@ cat eqtime src dst -rm_f files... +rm_rf files... rm_f files... @@ -8933,7 +10256,7 @@ test_f file =back -=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications +=head2 ExtUtils::Constant - generate XS code to import C header constants =over 4 @@ -8941,42 +10264,94 @@ test_f file =item DESCRIPTION -=item @EXPORT +=item USAGE + +IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF =item FUNCTIONS -xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), -ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) +=back -=item EXAMPLES +C_stringify NAME -=item SEE ALSO +constant_types -=item AUTHOR +memEQ_clause NAME, CHECKED_AT, INDENT -=back +assign INDENT, TYPE, PRE, POST, VALUE.. -=head2 ExtUtils::Install - install files from here to there +return_clause -=over 4 +switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. -=item SYNOPSIS +params WHAT -=item DESCRIPTION +dump_names -=back +dogfood -=head2 ExtUtils::Installed - Inventory management of installed modules +C_constant, name, type, value, macro, default, pre, post, def_pre =item +def_post -=over 4 +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME -=item SYNOPSIS +autoload PACKAGE, VERSION, AUTOLOADER -=item DESCRIPTION +WriteMakefileSnippet -=item USAGE +WriteConstants ATTRIBUTE =E VALUE [, ...], NAME, DEFAULT_TYPE, +BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME -=item FUNCTIONS +=over 4 + +=item AUTHOR + +=back + +=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item @EXPORT + +=item FUNCTIONS + +xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), +ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) + +=item EXAMPLES + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 ExtUtils::Install - install files from here to there + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 ExtUtils::Installed - Inventory management of installed modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +=item FUNCTIONS new(), modules(), files(), directories(), directory_tree(), validate(), packlist(), version() @@ -9034,6 +10409,53 @@ canonpath, cflags, manifypods, perl_archive =back +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +catfile + +constants (o) + +static_lib (o) + +dynamic_bs (o) + +dynamic_lib (o) + +canonpath + +perl_script + +pm_to_blib + +test_via_harness (o) + +tool_autosplit (override) + +tools_other (o) + +xs_o (o) + +top_targets (o) + +htmlifypods (o) + +manifypods (o) + +dist_ci (o) + +dist_core (o) + +pasthru (o) + =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -9209,6 +10631,8 @@ prefixify processPL (o) +quote_paren + realclean (o) replace_manpage_separator @@ -9451,7 +10875,7 @@ pasthru (o) =item Using Attributes and Parameters -ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG, +ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS, HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, @@ -9461,11 +10885,12 @@ INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, -NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC, -PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX, -PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, -PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, -VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION +NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, +PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW, +PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, +PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, +PRINT_PREREQ, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT, +XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -9488,7 +10913,7 @@ shdist, make zipdist, make ci =item ENVIRONMENT -PERL_MM_OPT +PERL_MM_OPT, PERL_MM_USE_DEFAULT =item SEE ALSO @@ -9678,6 +11103,8 @@ rmscopy($from,$to[,$date_flag]) =item RETURN +=item NOTES + =item AUTHOR =back @@ -9690,6 +11117,8 @@ rmscopy($from,$to[,$date_flag]) =item DESCRIPTION +=item NOTES + =item EXPORTS (by request only) =item BUGS @@ -9711,11 +11140,19 @@ rmscopy($from,$to[,$date_flag]) =item DESCRIPTION C, C, C, C, C, -C, C, C, C, -C, C +C, C, C, C, +C, C, C + +=item WARNINGS =item CAVEAT +$dont_use_nlink, symlinks + +=item NOTES + +=item HISTORY + =back =head2 File::Glob - Perl extension for BSD glob routine @@ -9726,9 +11163,9 @@ C, C =item DESCRIPTION -C, C, C, C, C, -C, C, C, C, C, -C +C, C, C, C, C, +C, C, C, C, +C, C, C =item DIAGNOSTICS @@ -9760,6 +11197,12 @@ C, C =item DESCRIPTION +=item METHODS + +canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, +no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, +splitdir, catpath(), abs2rel, rel2abs() + =item SEE ALSO =item AUTHORS @@ -9782,7 +11225,7 @@ tmpdir path -canonpath +canonpath() splitpath @@ -9792,7 +11235,7 @@ catpath abs2rel -rel2abs +rel2abs() =over 4 @@ -9818,7 +11261,7 @@ rel2abs =back -=head2 File::Spec::Mac - File::Spec for MacOS +=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) =over 4 @@ -9832,7 +11275,7 @@ canonpath =back -catdir +catdir() catfile @@ -9862,6 +11305,8 @@ rel2abs =over 4 +=item AUTHORS + =item SEE ALSO =back @@ -9876,7 +11321,8 @@ rel2abs =back -=head2 File::Spec::Unix - methods used by File::Spec +=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec +modules =over 4 @@ -9886,11 +11332,11 @@ rel2abs =item METHODS -canonpath +canonpath() =back -catdir +catdir() catfile @@ -9918,11 +11364,11 @@ splitpath splitdir -catpath +catpath() abs2rel -rel2abs +rel2abs() =over 4 @@ -10162,6 +11608,25 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item A Solution +=item Disabling or changing behaviour + +=item All-in-one interface + +=item Filtering only specific components of source code + +C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">, +C<"all"> + +=item Filtering only the code parts of source code + +Most source code ceases to be grammatically correct when it is broken up +into the pieces between string literals and regexes. So the C<'code'> +component filter behaves slightly differently from the other partial +filters +described in the previous section. + +=item Using Filter::Simple and Exporter together + =item How it works =back @@ -10224,6 +11689,8 @@ B<$_>, B<$status>, B and B, B =item EXPORTABLE VARIABLES +=item KNOWN ISSUES + =item KNOWN BUGS =item AUTHORS @@ -10282,7 +11749,7 @@ B<$_>, B<$status>, B and B, B =item Summary of Option Specifications -!, +, s, i, f, : I [ I ] +!, +, s, i, o, f, : I [ I ] =back @@ -10300,7 +11767,7 @@ B<$_>, B<$status>, B and B, B =item The lonesome dash -=item Argument call-back +=item Argument callback =back @@ -10335,6 +11802,10 @@ prefix_pattern, debug (default: disabled) =item GetOptions does not return a false result when an option is not supplied +=item GetOptions does not split the command line correctly + +=item How do I put a "-?" option into a Getopt::Long? + =back =item AUTHOR @@ -10365,6 +11836,213 @@ locale =back +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +the function is_language_tag($lang1) + +the function extract_language_tags($whatever) + +the function same_language_tag($lang1, $lang2) + +the function similarity_language_tag($lang1, $lang2) + +the function is_dialect_of($lang1, $lang2) + +the function super_languages($lang1) + +the function locale2language_tag($locale_identifier) + +the function encode_language_tag($lang1) + +the function alternate_language_tags($lang1) + +the function @langs = panic_languages(@accept_languages) + +=over 4 + +=item ABOUT LOWERCASING + +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHOR + +=back + +=head2 I18N::LangTags::List -- tags and names for human languages + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item ABOUT LANGUAGE TAGS + +=item LIST OF LANGUAGES + +{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} : +Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)], +{aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} : +Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} : +Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} : +Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} : +Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages], +[{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} : +Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, +{ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} : +Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu +(Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak +(Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} : +Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : +Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : +Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : +Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, +[{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], +[{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} : +Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} +: Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : +Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, +{chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : +Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and +pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)], +[{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles +and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} : +Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default +(Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi} +: Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : +Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, +{efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, +{en} : English, {enm} : Old English (1100-1500), {ang} : Old English +(ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} : +Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : +Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} +: Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : +Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, +{gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, +{ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500), +{goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : +Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : +Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : +Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian, +{he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : +Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, +{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo, +{ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)], +{id} : Indonesian, {ia} : Interlingua (International Auxiliary Language +Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira} +: Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} : +Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} : +Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian, +{kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} : +Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} : +Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi} +: Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu, +{rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi, +{kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} : +Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru} +: Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba, +{lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} : +Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} : +Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} : +Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian, +{mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} : +Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu, +{mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo +languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} : +Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men} +: Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} : +Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} : +Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} +: Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} : +Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} : +Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : +Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, +{non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami, +{no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} +: Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, +{nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya, +{om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian +languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : +Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : +Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian +(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} +: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], +{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : +Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, +[{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : +Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan +languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)], +{sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} : +Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup, +[{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan, +{sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika, +{sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} : +Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)], +{sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} : +Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern +Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es} +: Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} : +Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} : +Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} : +Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te} +: Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig} +: Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit, +{tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga +(Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} : +Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish +(1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi, +{uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} : +Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} : +Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages], +{wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof, +{x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut, +{yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik +languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : +Zhuang, {zu} : Zulu, {zun} : Zuni + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR + +=back + +=head2 I18N::Langinfo - query locale information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + =head2 IO - load various IO modules =over 4 @@ -10498,8 +12176,8 @@ IO ), handles( [ EVENT_MASK ] ) =item DESCRIPTION -$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell =item SEE ALSO @@ -10738,8 +12416,8 @@ I/O objects =item DESCRIPTION -$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell =item SEE ALSO @@ -10992,6 +12670,59 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back +=head2 List::Util - A selection of general-utility list subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST + +=item SUGGESTED ADDITIONS + +=item COPYRIGHT + +=back + +=head2 List::Utilib::List::Util, List::Util - A selection of +general-utility list subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST + +=item SUGGESTED ADDITIONS + +=item COPYRIGHT + +=back + +=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype +EXPR, tainted EXPR, weaken REF + +=item COPYRIGHT + +=item BLATANT PLUG + +=back + =head2 Locale::Constants - constants for Locale codes =over 4 @@ -11169,7 +12900,7 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =back -=head2 MIME::Base64 - Encoding and decoding of base64 strings +=head2 Locale::Maketext -- framework for localization =over 4 @@ -11177,49 +12908,50 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =item DESCRIPTION -encode_base64($str, [$eol]), decode_base64($str) +=item QUICK OVERVIEW -=item DIAGNOSTICS +=item METHODS -Premature end of base64 data, Premature padding of base64 data +=over 4 -=item EXAMPLES +=item Construction Methods -=item COPYRIGHT +=item The "maketext" Method -=back +$lh->fail_with I $lh->fail_with(I), $lh->failure_handler_auto -=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding -of quoted-printable strings +=item Utility Methods -=over 4 +$language->quant($number, $singular), $language->quant($number, $singular, +$plural), $language->quant($number, $singular, $plural, $negative), +$language->numf($number), $language->sprintf($format, @items), +$language->language_tag(), $language->encoding() -=item SYNOPSIS +=item Language Handle Attributes and Internals -=item DESCRIPTION +=back -encode_qp($str), decode_qp($str); +=item LANGUAGE CLASS HIERARCHIES -=item COPYRIGHT +=item ENTRIES IN EACH LEXICON -=back +=item BRACKET NOTATION -=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable -strings +=item AUTO LEXICONS -=over 4 +=item CONTROLLING LOOKUP FAILURE -=item SYNOPSIS +=item HOW TO USE MAKETEXT -=item DESCRIPTION +=item SEE ALSO -encode_qp($str), decode_qp($str); +=item COPYRIGHT AND DISCLAIMER -=item COPYRIGHT +=item AUTHOR =back -=head2 Math::BigFloat - Arbitrary length float math package +=head2 Locale::Maketext::TPJ13 -- article about software localization =over 4 @@ -11227,37 +12959,37 @@ encode_qp($str), decode_qp($str); =item DESCRIPTION -number format, Error returns 'NaN', Division is computed to, Rounding is -performed +=item Localization and Perl: gettext breaks, Maketext fixes -=item BUGS +=over 4 -=item AUTHOR +=item A Localization Horror Story: It Could Happen To You -=back +=item The Linguistic View -=head2 Math::BigInt - Arbitrary size integer math package +=item Breaking gettext -=over 4 +=item Replacing gettext -=item SYNOPSIS +=item Buzzwords: Abstraction and Encapsulation -=item DESCRIPTION +=item Buzzword: Isomorphism -Canonical notation, Input, Output +=item Buzzword: Inheritance -=item EXAMPLES +=item Buzzword: Concision -=item Autocreating constants +=item The Devil in the Details -=item BUGS +=item The Proof in the Pudding: Localizing Web Sites -=item AUTHOR +=item References =back -=head2 Math::Complex - complex numbers and associated mathematical -functions +=back + +=head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -11265,31 +12997,35 @@ functions =item DESCRIPTION -=item OPERATIONS +encode_base64($str, [$eol]), decode_base64($str) -=item CREATION +=item DIAGNOSTICS -=item STRINGIFICATION +Premature end of base64 data, Premature padding of base64 data -=over 4 +=item EXAMPLES -=item CHANGED IN PERL 5.6 +=item COPYRIGHT =back -=item USAGE +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings -=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO +=over 4 -=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS +=item SYNOPSIS -=item BUGS +=item DESCRIPTION -=item AUTHORS +encode_qp($str), decode_qp($str); + +=item COPYRIGHT =back -=head2 Math::Trig - trigonometric functions +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings =over 4 @@ -11297,44 +13033,56 @@ functions =item DESCRIPTION -=item TRIGONOMETRIC FUNCTIONS +encode_qp($str), decode_qp($str); -B +=item COPYRIGHT + +=back + +=head2 Math::BigFloat - Arbitrary size floating point math package =over 4 -=item ERRORS DUE TO DIVISION BY ZERO +=item SYNOPSIS -=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS +=item DESCRIPTION -=back +=over 4 -=item PLANE ANGLE CONVERSIONS +=item Canonical notation -=item RADIAL COORDINATE CONVERSIONS +=item Output -=over 4 +=item C, C and C -=item COORDINATE SYSTEMS +=item Accuracy vs. Precision -=item 3-D ANGLE CONVERSIONS +=item Rounding -cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, -cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical +ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale +), fround ( -$scale ) and fround ( 0 ) =back -=item GREAT CIRCLE DISTANCES - =item EXAMPLES + # not ready yet + +=item Autocreating constants + =item BUGS +=item CAVEAT + +stringify, bstr(), bdiv, Modifying and =, bpow + +=item LICENSE + =item AUTHORS =back -=head2 NDBM_File - Tied access to ndbm files +=head2 Math::BigInt - Arbitrary size integer math package =over 4 @@ -11342,60 +13090,72 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item DESCRIPTION -C, C, C +Canonical notation, Input, Output -=item DIAGNOSTICS +=item ACCURACY and PRECISION =over 4 -=item C +=item Precision P -=back +=item Accuracy A -=item BUGS AND WARNINGS +=item Fallback F + +=item Rounding mode R + +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy +(significant digits), Setting/Accessing, Creating numbers, Usage, +Precedence, Overriding globals, Local settings, Rounding, Default values, +Remarks =back -=head2 Net::Ping - check a remote host for reachability +=item INTERNALS =over 4 -=item SYNOPSIS +=item MATH LIBRARY -=item DESCRIPTION +=item SIGN -=over 4 +=item mantissa(), exponent() and parts() -=item Functions +=back -Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, -$timeout]);, $p->close();, pingecho($host [, $timeout]); +=item EXAMPLES -=back + use Math::BigInt qw(bstr); -=item NOTES +=item Autocreating constants + +=item PERFORMANCE + +=over 4 + +=item Alternative math libraries =back -=head2 Net::hostent - by-name interface to Perl's built-in gethost*() -functions +=item BUGS -=over 4 +Out of Memory!, Fails to load Calc on Perl prior 5.6.0 -=item SYNOPSIS +=item CAVEATS -=item DESCRIPTION +stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity +handling, Modifying and =, bpow, Overloading -$x, Mixing different object +types, bsqrt() -=item EXAMPLES +=item LICENSE -=item NOTE +=item SEE ALSO -=item AUTHOR +=item AUTHORS =back -=head2 Net::netent - by-name interface to Perl's built-in getnet*() -functions +=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt =over 4 @@ -11403,15 +13163,23 @@ functions =item DESCRIPTION -=item EXAMPLES +=item EXPORT -=item NOTE +=item WRAP YOUR OWN -=item AUTHOR +=item LICENSE + +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. + +=item AUTHORS + +=item SEE ALSO =back -=head2 Net::protoent - by-name interface to Perl's built-in getproto*() +=head2 Math::Complex - complex numbers and associated mathematical functions =over 4 @@ -11420,30 +13188,31 @@ functions =item DESCRIPTION -=item NOTE - -=item AUTHOR +=item OPERATIONS -=back +=item CREATION -=head2 Net::servent - by-name interface to Perl's built-in getserv*() -functions +=item STRINGIFICATION =over 4 -=item SYNOPSIS +=item CHANGED IN PERL 5.6 -=item DESCRIPTION +=back -=item EXAMPLES +=item USAGE -=item NOTE +=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO -=item AUTHOR +=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS + +=item BUGS + +=item AUTHORS =back -=head2 O - Generic interface to Perl Compiler backends +=head2 Math::Trig - trigonometric functions =over 4 @@ -11451,37 +13220,50 @@ functions =item DESCRIPTION -=item CONVENTIONS +=item TRIGONOMETRIC FUNCTIONS -=item IMPLEMENTATION +B -=item AUTHOR +=over 4 + +=item ERRORS DUE TO DIVISION BY ZERO + +=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS =back -=head2 ODBM_File - Tied access to odbm files +=item PLANE ANGLE CONVERSIONS + +=item RADIAL COORDINATE CONVERSIONS =over 4 -=item SYNOPSIS +=item COORDINATE SYSTEMS -=item DESCRIPTION +=item 3-D ANGLE CONVERSIONS -C, C, C +cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, +cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical -=item DIAGNOSTICS +=back + +=item GREAT CIRCLE DISTANCES AND DIRECTIONS + +=item EXAMPLES =over 4 -=item C +=item CAVEAT FOR GREAT CIRCLE FORMULAS =back -=item BUGS AND WARNINGS +=item BUGS + +=item AUTHORS =back -=head2 Opcode - Disable named opcodes when compiling perl code +=head2 Memoize - Make your functions faster by trading space for time =over 4 @@ -11489,105 +13271,796 @@ C, C, C =item DESCRIPTION -=item NOTE - -=item WARNING +=item DETAILS -=item Operator Names and Operator Lists +=item OPTIONS -an operator name (opname), an operator tag name (optag), a negated opname -or optag, an operator set (opset) +=over 4 -=item Opcode Functions +=item INSTALL -opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), -full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), -define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), -opdump (PAT) +=item NORMALIZER -=item Manipulating Opsets +=item C, C -=item TO DO (maybe) +C, C, C, C, C =back +=item OTHER FACILITIES + =over 4 -=item Predefined Opcode Tags +=item C -:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, -:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, -:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, -:dangerous +=item C -=item SEE ALSO +=back -=item AUTHORS +=item CAVEATS + +=item PERSISTENT CACHE SUPPORT + +=item EXPIRATION SUPPORT + +=item BUGS + +=item MAILING LIST + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=item THANK YOU =back -=head2 Opcode::Safe, Safe - Compile and execute code in restricted -compartments +=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for +Storable use =over 4 -=item SYNOPSIS - =item DESCRIPTION -a new namespace, an operator mask +=back -=item WARNING +=head2 Memoize::Expire - Plug-in module for automatic expiration of +memoized values =over 4 -=item RECENT CHANGES +=item SYNOPSIS -=item Methods in class Safe +=item DESCRIPTION -permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, -...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from -(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), -root (NAMESPACE), mask (MASK) +=item INTERFACE -=item Some Safety Issues + TIEHASH, EXISTS, STORE -Memory, CPU, Snooping, Signals, State Changes +=item ALTERNATIVES + +=item CAVEATS =item AUTHOR -=back +=item SEE ALSO =back -=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when -compiling +=head2 Memoize::ExpireFile - test for Memoize expiration semantics =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item SEE ALSO - =back -=head2 POSIX - Perl interface to IEEE Std 1003.1 +=head2 Memoize::ExpireTest - test for Memoize expiration semantics =over 4 -=item SYNOPSIS - =item DESCRIPTION -=item NOTE +=back -=item CAVEATS +=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for +Storable use -=item FUNCTIONS +=over 4 -_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, +=item DESCRIPTION + +=back + +=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for +Storable use + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::Saves - Plug-in module to specify which return values +should be memoized + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEATS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Memoize::Storable - store Memoized data in Storable database + +=over 4 + +=item DESCRIPTION + +=back + +=head2 NDBM_File - Tied access to ndbm files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +C, C, C + +=item DIAGNOSTICS + +=over 4 + +=item C + +=back + +=item BUGS AND WARNINGS + +=back + +=head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item BUGS AND IRRITATIONS + +=item COPYRIGHT + +=back + +=head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USER METHODS + +debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), +dataend () + +=item CLASS METHODS + +debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... +]), unsupported (), response (), parse_response ( TEXT ), getline (), +ungetline ( TEXT ), read_until_dot () + +=item EXPORTS + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::Config - Local configuration data for libnet + +=over 4 + +=item SYNOPSYS + +=item DESCRIPTION + +=item METHODS + +requires_firewall HOST + +=item NetConfig VALUES + +nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, +time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, +ftp_int_pasive, local_netmask, test_hosts, test_exists + +=back + +=head2 Net::Domain - Attempt to evaluate the current host's internet name +and domain + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +hostfqdn (), hostname (), hostdomain () + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::FTP - FTP Client class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OVERVIEW + +=item CONSTRUCTOR + +new (HOST [,OPTIONS]) + +=item METHODS + +login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), +site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) +ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME +), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ), +mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get ( +REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ] +), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [, +REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported ( +CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR +] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( +FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, +DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), +pasv_wait ( NON_PASV_SERVER ), abort (), quit () + +=over 4 + +=item Methods for the adventurous + +quot (CMD [,ARGS]) + +=back + +=item THE dataconn CLASS + +read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), +bytes_read (), abort (), close () + +=item UNIMPLEMENTED + +B, B, B, B, B, B, B, B + +=item REPORTING BUGS + +=item AUTHOR + +=item SEE ALSO + +=item USE EXAMPLES + +http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz + +=item CREDITS + +=item COPYRIGHT + +=back + +=head2 Net::NNTP - NNTP Client class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ HOST ] [, OPTIONS ]) + +=item METHODS + +article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( +[ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ] +), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo ( +USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews ( +SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave +(), quit () + +=over 4 + +=item Extension methods + +newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), +overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN +), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( +MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ +GROUP ] ), reader + +=back + +=item UNSUPPORTED + +=item DEFINITIONS + +MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item CONSTRUCTOR + +new ( [ HOST, ] [ OPTIONS ] ) + +=item METHODS + +user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER, +PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, +FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete ( +MSGNUM ), reset (), quit () + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::Ping - check a remote host for reachability + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +icmp, udp, tcp, stream, external + +=over 4 + +=item Functions + +Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, +$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]); + +=back + +=item NOTES + +=back + +=head2 Net::SMTP - Simple Mail Transfer Protocol Client + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item CONSTRUCTOR + +new Net::SMTP [ HOST, ] [ OPTIONS ] + +=item METHODS + +banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [, +OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail ( +ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ), +to ( ADDRESS [, ADDRESS [...]] ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( +ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify +( ADDRESS ), help ( [ $subject ] ), quit () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::Time - time and daytime network client interface + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, +PROTOCOL [, TIMEOUT]]]) + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::hostent - by-name interface to Perl's built-in gethost*() +functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item NOTE + +=item AUTHOR + +=back + +=head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Where to get this document + +=item How to contribute to this document + +=back + +=item Author and Copyright Information + +=over 4 + +=item Disclaimer + +=back + +=item Obtaining and installing libnet + +=over 4 + +=item What is libnet ? + +=item Which version of perl do I need ? + +=item What other modules do I need ? + +=item What machines support libnet ? + +=item Where can I get the latest libnet release + +=back + +=item Using Net::FTP + +=over 4 + +=item How do I download files from an FTP server ? + +=item How do I transfer files in binary mode ? + +=item How can I get the size of a file on a remote FTP server ? + +=item How can I get the modification time of a file on a remote FTP server +? + +=item How can I change the permissions of a file on a remote server ? + +=item Can I do a reget operation like the ftp command ? + +=item How do I get a directory listing from an FTP server ? + +=item Changing directory to "" does not fail ? + +=item I am behind a SOCKS firewall, but the Firewall option does not work ? + +=item I am behind an FTP proxy firewall, but cannot access machines outside +? + +=item My ftp proxy firewall does not listen on port 21 + +=item Is it possible to change the file permissions of a file on an FTP +server ? + +=item I have seen scripts call a method message, but cannot find it +documented ? + +=item Why does Net::FTP not implement mput and mget methods + +=back + +=item Using Net::SMTP + +=over 4 + +=item Why can't the part of an Email address after the @ be used as the +hostname ? + +=item Why does Net::SMTP not do DNS MX lookups ? + +=item The verify method always returns true ? + +=back + +=item Debugging scripts + +=over 4 + +=item How can I debug my scripts that use Net::* modules ? + +=back + +=item AUTHOR AND COPYRIGHT + +=back + +=head2 Net::netent - by-name interface to Perl's built-in getnet*() +functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item NOTE + +=item AUTHOR + +=back + +=head2 Net::protoent - by-name interface to Perl's built-in getproto*() +functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTE + +=item AUTHOR + +=back + +=head2 Net::servent - by-name interface to Perl's built-in getserv*() +functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item NOTE + +=item AUTHOR + +=back + +=head2 Netrc, Net::Netrc - OO interface to users netrc file + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item THE .netrc FILE + +machine name, default, login name, password string, account string, macdef +name + +=item CONSTRUCTOR + +lookup ( MACHINE [, LOGIN ]) + +=item METHODS + +login (), password (), account (), lpa () + +=item AUTHOR + +=item SEE ALSO + +=item COPYRIGHT + +=back + +=head2 O - Generic interface to Perl Compiler backends + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONVENTIONS + +=item IMPLEMENTATION + +=item AUTHOR + +=back + +=head2 ODBM_File - Tied access to odbm files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +C, C, C + +=item DIAGNOSTICS + +=over 4 + +=item C + +=back + +=item BUGS AND WARNINGS + +=back + +=head2 Opcode - Disable named opcodes when compiling perl code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTE + +=item WARNING + +=item Operator Names and Operator Lists + +an operator name (opname), an operator tag name (optag), a negated opname +or optag, an operator set (opset) + +=item Opcode Functions + +opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), +full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), +define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), +opdump (PAT) + +=item Manipulating Opsets + +=item TO DO (maybe) + +=back + +=over 4 + +=item Predefined Opcode Tags + +:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, +:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, +:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, +:dangerous + +=item SEE ALSO + +=item AUTHORS + +=back + +=head2 Opcode::Safe, Safe - Compile and execute code in restricted +compartments + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +a new namespace, an operator mask + +=item WARNING + +=over 4 + +=item RECENT CHANGES + +=item Methods in class Safe + +permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, +...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from +(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), +root (NAMESPACE), mask (MASK) + +=item Some Safety Issues + +Memory, CPU, Snooping, Signals, State Changes + +=item AUTHOR + +=back + +=back + +=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when +compiling + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 POSIX - Perl interface to IEEE Std 1003.1 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTE + +=item CAVEATS + +=item FUNCTIONS + +_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, @@ -11614,222 +14087,647 @@ tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, wctomb, write -=item CLASSES +=item CLASSES + +=over 4 + +=item POSIX::SigAction + +new + +=item POSIX::SigSet + +new, addset, delset, emptyset, fillset, ismember + +=item POSIX::Termios + +new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, +getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, +setoflag, setospeed, Baud rate values, Terminal interface values, c_cc +field values, c_cflag field values, c_iflag field values, c_lflag field +values, c_oflag field values + +=back + +=item PATHNAME CONSTANTS + +Constants + +=item POSIX CONSTANTS + +Constants + +=item SYSTEM CONFIGURATION + +Constants + +=item ERRNO + +Constants + +=item FCNTL + +Constants + +=item FLOAT + +Constants + +=item LIMITS + +Constants + +=item LOCALE + +Constants + +=item MATH + +Constants + +=item SIGNAL + +Constants + +=item STAT + +Constants, Macros + +=item STDLIB + +Constants + +=item STDIO + +Constants + +=item TIME + +Constants + +=item UNISTD + +Constants + +=item WAIT + +Constants, Macros + +=back + +=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* +name space + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +unix, stdio, perlio, crlf, utf8, raw + +=over 4 + +=item Defaults and how to override them + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 PerlIO::Scalar - support module for in-memory IO. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]), +$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), +$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), +$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), +$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), +$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), +$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) + +=back + +=head2 Pod::Checker, podchecker() - check pod documents for syntax errors + +=over 4 + +=item SYNOPSIS + +=item OPTIONS/ARGUMENTS + +=over 4 + +=item podchecker() + +B<-warnings> =E I + +=back + +=item DESCRIPTION + +=item DIAGNOSTICS + +=over 4 + +=item Errors + +empty =headn, =over on line I without closing =back, =item without +previous =over, =back without previous =over, No argument for =begin, =end +without =begin, Nested =begin's, =for without formatter specification, +unresolved internal link I, Unknown command "I", Unknown +interior-sequence "I", nested commands +IE...IE...E...E, garbled entity I, Entity +number out of range, malformed link LEE, nonempty ZEE, +empty XEE, Spurious text after =pod / =cut, Spurious character(s) +after =back + +=item Warnings + +multiple occurence of link target I, line containing nothing but +whitespace in paragraph, file does not start with =head, previous =item has +no contents, preceding non-item paragraph(s), =item type mismatch (I +vs. I), I unescaped CE> in paragraph, Unknown entity, No +items in =over, No argument for =item, empty section in previous paragraph, +Verbatim paragraph in NAME section + +=item Hyperlinks + +ignoring leading/trailing whitespace in link, (section) in '$page' +deprecated, alternative text/node '%s' contains non-escaped | or / + +=back + +=item RETURN VALUE + +=item EXAMPLES + +=item INTERFACE + +=back + +Cnew( %options )> + +C<$checker-Epoderror( @args )>, C<$checker-Epoderror( {%opts}, +@args )> + +C<$checker-Enum_errors()> + +C<$checker-Ename()> + +C<$checker-Enode()> + +C<$checker-Eidx()> + +C<$checker-Ehyperlink()> + +=over 4 + +=item AUTHOR + +=back + +=head2 Pod::Find - find POD documents in directory trees + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=over 4 + +=item C + +C<-verbose =E 1>, C<-perl =E 1>, C<-script =E 1>, C<-inc =E +1> + +=back + +=over 4 + +=item C + +=back + +=over 4 + +=item C + +C<-inc =E 1>, C<-dirs =E [ $dir1, $dir2, ... ]>, C<-verbose =E +1> + +=back =over 4 -=item POSIX::SigAction +=item C -new +=back -=item POSIX::SigSet +=over 4 -new, addset, delset, emptyset, fillset, ismember +=item AUTHOR -=item POSIX::Termios +=item SEE ALSO -new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, -getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, -setoflag, setospeed, Baud rate values, Terminal interface values, c_cc -field values, c_cflag field values, c_iflag field values, c_lflag field -values, c_oflag field values +=back + +=head2 Pod::Html - module to convert pod files to HTML + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item ARGUMENTS + +backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, +infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, +title, verbose + +=item EXAMPLE + +=item ENVIRONMENT + +=item AUTHOR + +=item SEE ALSO + +=item COPYRIGHT =back -=item PATHNAME CONSTANTS +=head2 Pod::InputObjects - objects representing POD input paragraphs, +commands, etc. -Constants +=over 4 -=item POSIX CONSTANTS +=item SYNOPSIS -Constants +=item REQUIRES -=item SYSTEM CONFIGURATION +=item EXPORTS -Constants +=item DESCRIPTION -=item ERRNO +package B, package B, package +B, package B -Constants +=back -=item FCNTL +=over 4 -Constants +=item B -=item FLOAT +=back -Constants +=over 4 -=item LIMITS +=item B -Constants +=back -=item LOCALE +=over 4 -Constants +=item B -=item MATH +=back -Constants +=over 4 -=item SIGNAL +=item B -Constants +=back -=item STAT +=over 4 -Constants, Macros +=item B -=item STDLIB +=back -Constants +=over 4 -=item STDIO +=item B -Constants +=back -=item TIME +=over 4 -Constants +=item Pod::Paragraph-EB -=item UNISTD +=back -Constants +=over 4 -=item WAIT +=item $pod_para-EB -Constants, Macros +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item $pod_para-EB + +=back + +=over 4 + +=item B + +=back + +=over 4 + +=item Pod::InteriorSequence-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item $pod_seq-EB + +=back + +=over 4 + +=item Pod::InteriorSequence::B + +=back + +=over 4 + +=item B + +=back + +=over 4 + +=item Pod::ParseTree-EB + +=back + +=over 4 + +=item $ptree-EB + +=back + +=over 4 + +=item $ptree-EB + +=back + +=over 4 + +=item $ptree-EB + +=back + +=over 4 + +=item $ptree-EB + +=back + +=over 4 + +=item $ptree-EB =back -=head2 Pod::Checker, podchecker() - check pod documents for syntax errors - =over 4 -=item SYNOPSIS +=item Pod::ParseTree::B -=item OPTIONS/ARGUMENTS +=back =over 4 -=item podchecker() +=item SEE ALSO -B<-warnings> =E I +=item AUTHOR =back +=head2 Pod::LaTeX - Convert Pod data to formatted Latex + +=over 4 + +=item SYNOPSIS + =item DESCRIPTION -=item DIAGNOSTICS +=back =over 4 -=item Errors +=item OBJECT METHODS -empty =headn, =over on line I without closing =back, =item without -previous =over, =back without previous =over, No argument for =begin, =end -without =begin, Nested =begin's, =for without formatter specification, -unresolved internal link I, Unknown command "I", Unknown -interior-sequence "I", nested commands -IE...IE...E...E, garbled entity I, Entity -number out of range, malformed link LEE, nonempty ZEE, -empty XEE, Spurious text after =pod / =cut, Spurious character(s) -after =back +C -=item Warnings +=back -multiple occurence of link target I, line containing nothing but -whitespace in paragraph, file does not start with =head, previous =item has -no contents, preceding non-item paragraph(s), =item type mismatch (I -vs. I), I unescaped CE> in paragraph, Unknown entity, No -items in =over, No argument for =item, empty section in previous paragraph, -Verbatim paragraph in NAME section +=over 4 -=item Hyperlinks +=item Data Accessors -ignoring leading/trailing whitespace in link, (section) in '$page' -deprecated, alternative text/node '%s' contains non-escaped | or / +B =back -=item RETURN VALUE +B -=item EXAMPLES +B -=item INTERFACE +B