X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=6f10ab669b8f661a4a97e5474eb76dec3290831b;hb=cf5baa4869b9f9ab8e2d559f474c8e805806c370;hp=94c22077d930ce1826d4060936b5cca62ab93942;hpb=fa17183e4e4721f6874a0dd838c61a23ea86804f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 94c2207..6f10ab6 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -29,6 +29,8 @@ through to locate the proper section you're looking for. =item Miscellaneous +=item Language-Specific + =item Platform-Specific =back @@ -346,6 +348,8 @@ regular expressions =item Lvalue subroutines +Lvalue subroutines are EXPERIMENTAL + =item Passing Symbol Table Entries (typeglobs) =item When to Still Use local() @@ -396,44 +400,45 @@ in perl5 I<-X> 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 THING, 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,MODE,REFERENCE, 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 +binmode FILEHANDLE, LAYER, 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 THING, 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 +TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no +Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct +EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open +FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, +opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : +ATTRS, our TYPE EXPR : ATTRS, 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, @@ -446,14 +451,16 @@ 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, shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep -EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL, -socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort -BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice -ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split -/PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf -FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat -EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK, -substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr +EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair +SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, +sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, +splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split +/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format +parameter index, flags, vector flag, (minimum) width, precision, or maximum +width, size, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat +EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, +sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr +EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek @@ -849,317 +856,19 @@ B<-X>, B<-x> I =item ENVIRONMENT -HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL -(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL, -PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to -the VMS port) - -=item DESCRIPTION - -accept() on closed socket %s, Allocation too large: %lx, '!' allowed only -after types %s, Ambiguous call resolved as CORE::%s(), qualify as such or -use &, Ambiguous range in transliteration operator, Ambiguous use of %s -resolved as %s, '|' and '<' may not both be specified on command line, '|' -and '>' may not both be specified on command line, Applying %s to %s will -act on scalar(%s), Args must match #! line, Arg too short for msgsnd, %s -argument is not a HASH or ARRAY element, %s argument is not a HASH or ARRAY -element or slice, %s argument is not a subroutine name, Argument "%s" isn't -numeric%s, Array @%s missing the @ in argument %d of %s(), assertion -botched: %s, Assertion failed: file "%s", Assignment to both a list and a -scalar, Attempt to access disallowed key '%s' in a fixed hash, Attempt to -clear a fixed hash, Attempt to delete readonly key '%s' from a fixed hash, -Attempt to delete disallowed key '%s' from a fixed hash, Attempt to bless -into a reference, Attempt to free non-arena SV: 0x%lx, Attempt to free -nonexistent shared string, Attempt to free temp prematurely, Attempt to -free unreferenced glob pointers, Attempt to free unreferenced scalar, -Attempt to join self, Attempt to pack pointer to temporary value, Attempt -to use reference as lvalue in substr, Bad arg length for %s, is %d, should -be %s, Bad evalled substitution pattern, Bad filehandle: %s, Bad free() -ignored, Bad hash, Bad index while coercing array into hash, Badly placed -()'s, Bad name after %s::, Bad realloc() ignored, Bad symbol for array, Bad -symbol for filehandle, Bad symbol for hash, Bareword found in conditional, -Bareword "%s" not allowed while "strict subs" in use, Bareword "%s" refers -to nonexistent package, BEGIN failed--compilation aborted, BEGIN not safe -after errors--compilation aborted, \1 better written as $1, Binary number > -0b11111111111111111111111111111111 non-portable, bind() on closed socket -%s, binmode() on closed filehandle %s, Bit vector size > 32 non-portable, -Bizarre copy of %s in %s, B<-P> not allowed for setuid/setgid script, -Buffer overflow in prime_env_iter: %s, Callback called exit, %s() called -too early to check prototype, / cannot take a count, Can't bless -non-reference value, Can't call method "%s" in empty package "%s", Can't -call method "%s" on an undefined value, Can't call method "%s" on unblessed -reference, Can't call method "%s" without a package or object reference, -Can't chdir to %s, Can't check filesystem of script "%s" for nosuid, Can't -coerce array into hash, Can't coerce %s to integer in %s, Can't coerce %s -to number in %s, Can't coerce %s to string in %s, Can't create pipe -mailbox, Can't declare class for non-scalar %s in "%s", Can't declare %s in -"%s", Can't do inplace edit: %s is not a regular file, Can't do inplace -edit on %s: %s, Can't do inplace edit without backup, Can't do inplace -edit: %s would not be unique, Can't do {n,m} with n > m in regex; marked by -<-- HERE in m/%s/, Can't do setegid!, Can't do seteuid!, Can't do setuid, -Can't do waitpid with flags, Can't emulate -%s on #! line, Can't exec "%s": -%s, Can't exec %s, Can't execute %s, Can't find an opnumber for "%s", Can't -find %s character property "%s", Can't find label %s, Can't find %s on -PATH, Can't find %s on PATH, '.' not in PATH, Can't find string terminator -%s anywhere before EOF, Can't find %s property definition %s, Can't fork, -Can't get filespec - stale stat buffer?, Can't get pipe mailbox device -name, Can't get SYSGEN parameter value for MAXBUF, Can't "goto" into the -middle of a foreach loop, Can't "goto" out of a pseudo block, Can't goto -subroutine from an eval-string, Can't goto subroutine outside a subroutine, -Can't ignore signal CHLD, forcing to default, Can't "last" outside a loop -block, Can't localize lexical variable %s, Can't localize pseudo-hash -element, Can't localize through a reference, Can't locate file %s, Can't -locate auto/%s.al in @INC, Can't locate object method "%s" via package -"%s", (perhaps you forgot to load "%s"?), Can't locate package %s for -@%s::ISA, Can't make list assignment to \%ENV on this system, Can't modify -%s in %s, Can't modify nonexistent substring, Can't modify non-lvalue -subroutine call, Can't msgrcv to read-only var, Can't "next" outside a loop -block, Can't open %s: %s, Can't open bidirectional pipe, Can't open error -file %s as stderr, Can't open input file %s as stdin, Can't open output -file %s as stdout, Can't open output pipe (name: %s), Can't open perl -script%s: %s, Can't read CRTL environ, Can't redefine active sort -subroutine %s, Can't "redo" outside a loop block, Can't remove %s: %s, -skipping file, Can't rename %s to %s: %s, skipping file, Can't reopen input -pipe (name: %s) in binary mode, Can't resolve method `%s' overloading `%s' -in package `%s', Can't reswap uid and euid, Can't return %s from lvalue -subroutine, Can't return %s to lvalue scalar context, Can't return outside -a subroutine, Can't stat script "%s", Can't swap uid and euid, Can't take -log of %g, Can't take sqrt of %g, Can't undef active subroutine, Can't -unshift, Can't upgrade that kind of scalar, Can't upgrade to undef, Can't -use an undefined value as %s reference, Can't use anonymous symbol table -for method lookup, Can't use bareword ("%s") as %s ref while "strict refs" -in use, Can't use %! because Errno.pm is not available, Can't use %s for -loop variable, Can't use global %s in "my", Can't use "my %s" in sort -comparison, Can't use %s ref as %s ref, Can't use string ("%s") as %s ref -while "strict refs" in use, Can't use subscript on %s, Can't use \%c to -mean $%c in expression, Can't weaken a nonreference, Can't x= to read-only -value, Character in "C" format wrapped, Character in "c" format wrapped, -close() on unopened filehandle %s, %s: Command not found, Compilation -failed in require, Complex regular subexpression recursion limit (%d) -exceeded, connect() on closed socket %s, Constant(%s)%s: %s, Constant is -not %s reference, Constant subroutine %s redefined, Constant subroutine %s -undefined, Copy method did not return a reference, CORE::%s is not a -keyword, corrupted regexp pointers, corrupted regexp program, Corrupt -malloc ptr 0x%lx at 0x%lx, C<-p> destination: %s, C<-T> and C<-B> not -implemented on filehandles, Deep recursion on subroutine "%s", -defined(@array) is deprecated, defined(%hash) is deprecated, %s defines -neither package nor VERSION--version check failed, Delimiter for here -document is too long, Did not produce a valid header, %s did not return a -true value, (Did you mean &%s instead?), (Did you mean "local" instead of -"our"?), (Did you mean $ or @ instead of %?), Died, Document contains no -data, %s does not define %s::VERSION--version check failed, Don't know how -to handle magic of type '%s', do_study: out of memory, (Do you need to -predeclare %s?), dump() better written as CORE::dump(), Duplicate free() -ignored, elseif should be elsif, Empty %s, entering effective %s failed, -Error converting file specification %s, %s: Eval-group in insecure regular -expression, %s: Eval-group not allowed at run time, %s: Eval-group not -allowed, use re 'eval', Excessively long <> operator, exec? I'm not *that* -kind of operating system, Execution of %s aborted due to compilation -errors, Exiting eval via %s, Exiting format via %s, Exiting pseudo-block -via %s, Exiting subroutine via %s, Exiting substitution via %s, Explicit -blessing to '' (assuming package main), %s: Expression syntax, %s -failed--call queue aborted, False [] range "%s" in regex; marked by <-- -HERE in m/%s/, Fatal VMS error at %s, line %d, fcntl is not implemented, -Filehandle %s opened only for input, Filehandle %s opened only for output, -Final $ should be \$ or $name, Final @ should be \@ or @name, flock() on -closed filehandle %s, Quantifier follows nothing in regex;, Format not -terminated, Format %s redefined, Found = in conditional, should be ==, %s -found where operator expected, gdbm store returned %d, errno %d, key "%s", -gethostent not implemented, get%sname() on closed socket %s, getpwnam -returned invalid UIC %#o for user "%s", getsockopt() on closed socket %s, -Global symbol "%s" requires explicit package name, glob failed (%s), Glob -not terminated, Got an error from DosAllocMem, goto must have label, -%s-group starts with a count, %s had compilation errors, Had to create %s -unexpectedly, Hash %%s missing the % in argument %d of %s(), %s has too -many errors, Hexadecimal number > 0xffffffff non-portable, Identifier too -long, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal -character %s (carriage return), Illegal character in prototype for %s : %s, -Illegal division by zero, Illegal hexadecimal digit %s ignored, Illegal -modulus zero, Illegal number of bits in vec, Illegal octal digit %s, -Illegal octal digit %s ignored, Illegal switch in PERL5OPT: %s, Ill-formed -CRTL environ value "%s", Ill-formed message in prime_env_iter: |%s|, (in -cleanup) %s, In EBCDIC the v-string components cannot exceed 2147483647, -Insecure dependency in %s, Insecure directory in %s, Insecure $ENV{%s} -while running %s, Integer overflow in %s number, Internal disaster in -regex; marked by <-- HERE in m/%s/, Internal inconsistency in tracking -vforks, Internal urp in regex; marked by <-- HERE in m/%s/, %s (...) -interpreted as function, Invalid %s attribute: %s, Invalid %s attributes: -%s, Invalid conversion in %s: "%s", Invalid [] range "%s" in regex; marked -by <-- HERE in m/%s/, Invalid [] range "%s" in transliteration operator, -Invalid separator character %s in attribute list, Invalid type in pack: -'%s', Invalid type in unpack: '%s', ioctl is not implemented, ioctl() on -unopened %s, IO::Socket::atmark not implemented on this architecture, `%s' -is not a code reference, `%s' is not an overloadable type, junk on end of -regexp, Label not found for "last %s", Label not found for "next %s", Label -not found for "redo %s", leaving effective %s failed, listen() on closed -socket %s, lstat() on filehandle %s, Lvalue subs returning %s not -implemented yet, Lookbehind longer than %d not implemented in regex;, -Malformed PERLLIB_PREFIX, Malformed prototype for %s: %s, Malformed UTF-8 -character (%s), Malformed UTF-16 surrogate, %s matches null string many -times in regex;, "%s" may clash with future reserved word, % may only be -used in unpack, Method for operation %s not found in package %s during -blessing, Method %s not permitted, Might be a runaway multi-line %s string -starting on line %d, Misplaced _ in number, Missing %sbrace%s on \N{}, -Missing comma after first argument to %s function, Missing command in piped -open, Missing name in "my sub", Missing $ on loop variable, (Missing -operator before %s?), Missing right brace on %s, Missing right curly or -square bracket, (Missing semicolon on previous line?), Modification of a -read-only value attempted, Modification of non-creatable array value -attempted, %s, Modification of non-creatable hash value attempted, %s, -Module name must be constant, Module name required with -%c option, More -than one argument to open, msg%s not implemented, Multidimensional syntax -%s not supported, / must be followed by a*, A* or Z*, / must be followed by -a, A or Z, / must follow a numeric type, "my sub" not yet implemented, "my" -variable %s can't be in a package, Name "%s::%s" used only once: possible -typo, Negative length, Negative offset to vec in lvalue context, Nested -quantifiers in regex; marked by <-- HERE in m/%s/, %s never introduced, No -%s allowed while running setuid, No B<-e> allowed in setuid scripts, No -comma allowed after %s, No command into which to pipe on command line, No -DB::DB routine defined, No dbm on this machine, No DBsub routine, No error -file after 2> or 2>> on command line, No input file after < on command -line, No #! line, "no" not allowed in expression, No output file after > on -command line, No output file after > or >> on command line, No package name -allowed for variable %s in "our", No Perl script found in input, No -setregid available, No setreuid available, No space allowed after -%c, No -%s specified for -%c, No such class %s, No such pipe open, No such -pseudo-hash field "%s", No such pseudo-hash field "%s" in variable %s of -type %s, No such signal: SIG%s, Not a CODE reference, Not a format -reference, Not a GLOB reference, Not a HASH reference, Not an ARRAY -reference, Not a perl script, Not a SCALAR reference, Not a subroutine -reference, Not a subroutine reference in overload table, Not enough -arguments for %s, Not enough format arguments, %s: not found, %s not -allowed in length fields, no UTC offset information; assuming local time is -UTC, Null filename used, NULL OP IN RUN, Null picture in formline, Null -realloc, NULL regexp argument, NULL regexp parameter, Number too long, -Octal number in vector unsupported, Octal number > 037777777777 -non-portable, Odd number of arguments for overload::constant, Odd number of -elements in anonymous hash, Odd number of elements in hash assignment, -Offset outside string, -%s on unopened filehandle %s, %s() on unopened %s, -oops: oopsAV, oops: oopsHV, Operation `%s': no method found, %s, Operator -or semicolon missing before %s, "our" variable %s redeclared, Out of -memory!, Out of memory during "large" request for %s, Out of memory during -request for %s, Out of memory during ridiculously large request, Out of -memory for yacc stack, @ outside of string, %s package attribute may clash -with future reserved word: %s, page overflow, panic: %s, panic: ck_grep, -panic: ck_split, panic: corrupt saved stack index, panic: del_backref, -panic: die %s, panic: pp_match%s, panic: do_subst, panic: do_trans_%s, -panic: frexp, panic: goto, panic: INTERPCASEMOD, panic: INTERPCONCAT, -panic: kid popen errno read, panic: last, panic: leave_scope clearsv, -panic: leave_scope inconsistency, panic: magic_killbackrefs, panic: malloc, -panic: mapstart, panic: null array, panic: pad_alloc, panic: pad_free -curpad, panic: pad_free po, panic: pad_reset curpad, panic: pad_sv po, -panic: pad_swipe curpad, panic: pad_swipe po, panic: pp_iter, panic: -pp_split, panic: realloc, panic: restartop, panic: return, panic: scan_num, -panic: sv_insert, panic: top_env, panic: yylex, panic: utf16_to_utf8: odd -bytelen, Parentheses missing around "%s" list, Perl %s required--this is -only version %s, stopped, PERL_SH_DIR too long, perl: warning: Setting -locale failed, perlio: argument list not closed for layer "%s", perlio: -invalid separator character %s in attribute list, perlio: unknown layer -"%s", Permission denied, pid %x not a child, P must have an explicit size, -POSIX syntax [%s] belongs inside character classes in regex;, POSIX syntax -[. .] is reserved for future extensions in regex;, POSIX syntax [= =] is -reserved for future extensions in regex;, POSIX class [:%s:] unknown in -regex;, POSIX getpgrp can't take an argument, Possible attempt to put -comments in qw() list, Possible attempt to separate words with commas, -Possible memory corruption: %s overflowed 3rd argument, Possible unintended -interpolation of %s in string, Possible Y2K bug: %s, pragma "attrs" is -deprecated, use "sub NAME : ATTRS" instead, Precedence problem: open %s -should be open(%s), Premature end of script headers, printf() on closed -filehandle %s, print() on closed filehandle %s, Process terminated by -SIG%s, Prototype mismatch: %s vs %s, Prototype not terminated, Quantifier -in {,} bigger than %d in regex;, Quantifier unexpected on zero-length -expression;, Range iterator outside integer range, readline() on closed -filehandle %s, Reallocation too large: %lx, realloc() of freed memory -ignored, Recompile perl with B<-D>DEBUGGING to use B<-D> switch, Recursive -inheritance detected in package '%s', Recursive inheritance detected while -looking for method %s, Reference found where even-sized list expected, -Reference is already weak, Reference miscount in sv_replace(), Reference to -nonexistent group in regex;, regexp memory corruption, Regexp out of space, -Repeat count in pack overflows, Repeat count in unpack overflows, Reversed -%s= operator, Runaway format, Scalar value @%s[%s] better written as -$%s[%s], Scalar value @%s{%s} better written as $%s{%s}, Scalars leaked: -%d, Script is not setuid/setgid in suidperl, Search pattern not terminated, -%sseek() on unopened filehandle, select not implemented, Self-ties of -arrays and hashes are not supported, Semicolon seems to be missing, -semi-panic: attempt to dup freed string, sem%s not implemented, send() on -closed socket %s, Sequence (? incomplete in regex; marked by <-- HERE in -m/%s/, Sequence (?{...}) not terminated or not {}-balanced in regex;, -Sequence (?%s...) not implemented in regex;, Sequence (?%s...) not -recognized in regex;, Sequence (?#... not terminated in regex;, 500 Server -error, Server error, setegid() not implemented, seteuid() not implemented, -setpgrp can't take arguments, setrgid() not implemented, setruid() not -implemented, setsockopt() on closed socket %s, Setuid/gid script is -writable by world, shm%s not implemented, <> should be quotes, /%s/ should -probably be written as "%s", shutdown() on closed socket %s, SIG%s handler -"%s" not defined, sort is now a reserved word, Sort subroutine didn't -return a numeric value, Sort subroutine didn't return single value, -splice() offset past end of array, Split loop, Statement unlikely to be -reached, stat() on unopened filehandle %s, Stub found while resolving -method `%s' overloading %s, Subroutine %s redefined, Substitution loop, -Substitution pattern not terminated, Substitution replacement not -terminated, substr outside of string, suidperl is no longer needed since -%s, Switch (?(condition)... contains too many branches in regex;, Switch -condition not recognized in regex;, switching effective %s is not -implemented, syntax error, syntax error at line %d: `%s' unexpected, syntax -error in file %s at line %d, next 2 tokens "%s", %s syntax OK, System V %s -is not implemented on this machine, syswrite() on closed filehandle %s, -Target of goto is too deeply nested, tell() on unopened filehandle, That -use of $[ is unsupported, The crypt() function is unimplemented due to -excessive paranoia, The %s function is unimplemented, The stat preceding %s -wasn't an lstat, This Perl can't reset CRTL environ elements (%s), This -Perl can't set CRTL environ elements (%s=%s), times not implemented, Too -few args to syscall, Too late for "B<-T>" option, Too late for "-%s" -option, Too late to run %s block, Too many args to syscall, Too many -arguments for %s, Too many )'s, Too many ('s, Trailing \ in regex m/%s/, -Transliteration pattern not terminated, Transliteration replacement not -terminated, truncate not implemented, Type of arg %d to %s must be %s (not -%s), umask not implemented, Unable to create sub named "%s", Unbalanced -context: %d more PUSHes than POPs, Unbalanced saves: %d more saves than -restores, Unbalanced scopes: %d more ENTERs than LEAVEs, Unbalanced tmps: -%d more allocs than frees, Undefined format "%s" called, Undefined sort -subroutine "%s" called, Undefined subroutine &%s called, Undefined -subroutine called, Undefined subroutine in sort, Undefined top format "%s" -called, Undefined value assigned to typeglob, %s: Undefined variable, -unexec of %s into %s failed!, Unicode character %s is illegal, Unknown -BYTEORDER, Unknown "re" subpragma '%s' (known ones are: %s), Unknown switch -condition (?(%.2s in regex;, Unknown open() mode '%s', Unknown process %x -sent message to prime_env_iter: %s, Unknown warnings category '%s', -unmatched [ in regex; marked by <-- HERE in m/%s/, unmatched ( in regex; -marked by <-- HERE in m/%s/, Unmatched right %s bracket, Unquoted string -"%s" may clash with future reserved word, Unrecognized character %s, /%s/: -Unrecognized escape \\%c in character class passed through, Unrecognized -escape \\%c passed through in regex;, Unrecognized escape \\%c passed -through, Unrecognized signal name "%s", Unrecognized switch: -%s (-h will -show valid options), Unsuccessful %s on filename containing newline, -Unsupported directory function "%s" called, Unsupported function %s, -Unsupported function fork, Unsupported script encoding, Unsupported socket -function "%s" called, Unterminated attribute list, Unterminated attribute -parameter in attribute list, Unterminated compressed integer, Unterminated -<> operator, untie attempted while %d inner references still exist, Useless -(?%s) - use /%s modifier in regex;, Useless (?-%s) - don't use /%s modifier -in regex;, Useless use of %s in void context, Useless use of "re" pragma, -Useless use of sort in scalar context, Useless use of %s with no values, -"use" not allowed in expression, Use of bare << to mean <<"" is deprecated, -Use of *glob{FILEHANDLE} is deprecated, Use of chdir('') or chdir(undef) as -chdir() deprecated, Use of implicit split to @_ is deprecated, Use of -inherited AUTOLOAD for non-method %s() is deprecated, Use of -l on -filehandle %s, Use of "package" with no arguments is deprecated, Use of %s -in printf format not supported, Use of $* is deprecated, Use of %s is -deprecated, Use of $# is deprecated, Use of reference "%s" as array index, -Use of reserved word "%s" is deprecated, Use of tainted arguments in %s is -deprecated, Use of uninitialized value%s, Using a hash as a reference is -deprecated, Using an array as a reference is deprecated, UTF-16 surrogate -%s, Value of %s can be "0"; test with defined(), Value of CLI symbol "%s" -too long, Variable "%s" is not imported%s, "%s" variable %s masks earlier -declaration in same %s, Variable "%s" may be unavailable, Variable syntax, -Variable "%s" will not stay shared, Variable length lookbehind not -implemented in regex;, Version number must be a constant number, v-string -in use/require is non-portable, Warning: something's wrong, Warning: unable -to close filehandle %s properly, Warning: Use of "%s" without parentheses -is ambiguous, Wide character in %s, write() on closed filehandle %s, X -outside of string, x outside of string, Xsub "%s" called in sort, Xsub -called in sort, YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!, You -need to quote "%s" +HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, +:perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, +PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS, +PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port), +SYS$LOGIN (specific to the VMS port) + +=back + +=head2 perldiag - various Perl diagnostics + +=over 4 + +=item DESCRIPTION =back @@ -1243,16 +952,16 @@ B<-w>, B<-W>, B<-X> =item Debugger Commands -h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], -T, s [expr], n [expr], r, , c [line|sub], l, l min+incr, l min-max, l -line, l subname, -, v [line], f filename, /pattern/, ?pattern?, L [abw], S -[[!]regex], t, t expr, b, b [line] [condition], b subname [condition], b -postpone subname [condition], b load filename, b compile subname, B line, B -*, a [line] command, A line, A *, w expr, W expr, W *, o, o booloption .., -o anyoption? .., o option=value .., < ?, < [ command ], << command, > ?, > -command, >> command, { ?, { [ command ], {{ command, ! number, ! -number, ! -pattern, !! cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m -expr, M, man [manpage] +h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y +[level [vars]], T, s [expr], n [expr], r, , c [line|sub], l, l +min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, +?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b +subname [condition], b postpone subname [condition], b load filename, b +compile subname, B line, B *, a [line] command, A line, A *, w expr, W +expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ +command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ +command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q +or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] =item Configurable Options @@ -1321,7 +1030,7 @@ $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, $@, +$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, @@ -1422,6 +1131,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item File Locking +=item IO Layers + =back =item SEE ALSO @@ -2010,11 +1721,20 @@ safe subprocesses, sockets, and semaphores) =item Signals +=over 4 + +=item Handling the SIGHUP Signal in Daemons + +=back + =item Named Pipes =over 4 -=item WARNING +=item Deferred Signals + +Long running opcodes, Interrupting IO, Signals as "faults", Signals +triggered by operating system state =back @@ -2080,7 +1800,7 @@ Proto, LocalPort, Listen, Reuse =back -=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) +=head2 perlfork - Perl's fork() emulation =over 4 @@ -2132,8 +1852,8 @@ application, Thread-safety of extensions =item Flavors of Perl numeric operations -Arithmetic operators except, C, Arithmetic operators except, -C, Bitwise operators, C, Bitwise operators, C, Other +mathematical operators, Bitwise operators, Bitwise operators during C, Operators which expect an integer, Operators which expect a string @@ -2149,6 +1869,116 @@ string =item DESCRIPTION +=item Status + +=item What Is A Thread Anyway? + +=item Threaded Program Models + +=over 4 + +=item Boss/Worker + +=item Work Crew + +=item Pipeline + +=back + +=item Native threads + +=item What kind of threads are Perl threads? + +=item Threadsafe Modules + +=item Thread Basics + +=over 4 + +=item Basic Thread Support + +=item A Note about the Examples + +=item Creating Threads + +=item Giving up control + +=item Waiting For A Thread To Exit + +=item Ignoring A Thread + +=back + +=item Threads And Data + +=over 4 + +=item Shared And Unshared Data + +=item Thread Pitfalls: Races + +=back + +=item Synchronization and control + +=over 4 + +=item Controlling access: lock() + +=item A Thread Pitfall: Deadlocks + +=item Queues: Passing Data Around + +=item Semaphores: Synchronizing Data Access + +=item Basic semaphores + +=item Advanced Semaphores + +=item cond_wait() and cond_signal() + +=back + +=item General Thread Utility Routines + +=over 4 + +=item What Thread Am I In? + +=item Thread IDs + +=item Are These Threads The Same? + +=item What Threads Are Running? + +=back + +=item A Complete Example + +=item Performance considerations + +=item Threadsafety of System Libraries + +=item Conclusion + +=item Bibliography + +=over 4 + +=item Introductory Texts + +=item OS-Related References + +=item Other References + +=back + +=item Acknowledgements + +=item AUTHOR + +=item Copyrights + =back =head2 perlothrtut - old tutorial on threads in Perl @@ -2288,6 +2118,8 @@ portable =item System Interaction +=item Command names versus file pathnames + =item Interprocess Communication (IPC) =item External Subroutines (XS) @@ -2349,16 +2181,15 @@ 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, +getprotoent, getservent, 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, shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, @@ -2467,6 +2298,8 @@ LC_NUMERIC, LC_TIME, LANG =back +=item Unicode and UTF-8 + =item BUGS =over 4 @@ -2495,6 +2328,8 @@ LC_NUMERIC, LC_TIME, LANG =item Perl's Unicode Model +=item Unicode and EBCDIC + =item Creating Unicode =item Handling Unicode @@ -2513,8 +2348,6 @@ LC_NUMERIC, LC_TIME, LANG =item Questions With Answers -, , , , , , - =item Hexadecimal Notation =item Further Resources @@ -2525,7 +2358,7 @@ LC_NUMERIC, LC_TIME, LANG =item SEE ALSO -=item ACKNOWLEDGEMENTS +=item ACKNOWLEDGMENTS =item AUTHOR, COPYRIGHT, AND LICENSE @@ -2541,33 +2374,49 @@ LC_NUMERIC, LC_TIME, LANG =item Important Caveats -Input and Output Disciplines, Regular Expressions, C still needed -to enable UTF-8/UTF-EBCDIC in scripts +Input and Output Layers, Regular Expressions, C still needed to +enable UTF-8/UTF-EBCDIC in scripts -=item Byte and Character semantics +=item Byte and Character Semantics -=item Effects of character semantics +=item Effects of Character Semantics =item Scripts =item Blocks -=item Character encodings for input and output +=item User-Defined Character Properties + +=item Character Encodings for Input and Output =item Unicode Regular Expression Support Level =item Unicode Encodings -=item Security Implications of Malformed UTF-8 +=item Security Implications of Unicode =item Unicode in Perl on EBCDIC +=item Locales + =item Using Unicode in XS =back =item BUGS +=over 4 + +=item Interaction with Locales + +=item Interaction with Extensions + +=item Speed + +=back + +=item SEE ALSO + =back =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms @@ -2596,6 +2445,10 @@ to enable UTF-8/UTF-EBCDIC in scripts =item POSIX-BC +=item Unicode code points versus EBCDIC code points + +=item Remaining Perl Unicode problems in EBCDIC + =item Unicode and UTF =item Using Encode @@ -2712,6 +2565,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Protecting Your Programs +=item Unicode + =back =item SEE ALSO @@ -2781,49 +2636,59 @@ module (sometimes unnecessary), B the module =item Pragmatic Modules -attributes, autouse, base, blib, bytes, charnames, constant, diagnostics, -encoding, fields, filetest, integer, less, locale, open, overload, sigtrap, -sort, strict, subs, utf8, vars, vmsish, warnings, warnings::register +attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes, +charnames, constant, diagnostics, encoding, fields, filetest, if, integer, +less, locale, open, ops, overload, re, sigtrap, sort, strict, subs, +threads, utf8, vars, vmsish, warnings, warnings::register =item Standard Modules -AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, 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, Devel::SelfStubber, -Digest, DirHandle, Dumpvalue, 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, +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, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest, +DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter, +Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, +ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, +ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any, +ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, +ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN, +ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, +ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, -ExtUtils::testlib, Fatal, File::Basename, File::CheckTree, File::Compare, -File::Copy, File::DosGlob, File::Find, File::Path, File::Spec, -File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions, +ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, +File::Compare, File::Copy, File::DosGlob, File::Find, File::Path, +File::Spec, File::Spec::Cygwin, 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, IPC::Open2, IPC::Open3, -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::Storable, 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, -PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, -Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, -Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color, -Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic, -Search::Dict, SelectSaver, SelfLoader, Shell, Switch, Symbol, -Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test, -Test::Builder, Test::Harness, Test::More, Test::Simple, Test::Tutorial, -Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, -Text::Wrap, Thread, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, -Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, -Time::tm, UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, -User::pwent, Win32 +Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util, +I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, +IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency, +Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, +Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, +Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, +Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, +Memoize::NDBM_File, Memoize::SDBM_File, 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, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions, +Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, +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::Builder, Test::Harness, Test::Harness::Assert, +Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple, +Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, +Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, +Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash, +Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, +Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, +Unicode::UCD, User::grent, User::pwent, Win32 =item Extension Modules @@ -2835,18 +2700,46 @@ User::pwent, Win32 =item Africa +South Africa + =item Asia +China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian +Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand + =item Central America +Costa Rica + =item Europe +Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, +Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, +Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia, +Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United +Kingdom + =item North America +Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico + +=item United States + +Alabama, California, Colorado, Delaware, District of Columbia, Florida, +Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York, +North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, +Utah, Virginia, ashington, Wisconsin + =item Oceania +Australia, New Zealand + =item South America +Argentina, Brazil, Chile + +=item RSYNC Mirrors + =back =item Modules: Creation, Use, and Abuse @@ -3001,8 +2894,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date: -2002/02/21 14:49:15 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date: +2002/04/07 18:46:13 $) =over 4 @@ -3048,8 +2941,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $, -$Date: 2002/03/09 21:01:13 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $, +$Date: 2002/04/26 16:56:35 $) =over 4 @@ -3104,8 +2997,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11 -19:29:52 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06 +13:11:13 $) =over 4 @@ -3131,7 +3024,7 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? -Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, +Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl, CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha @@ -3189,8 +3082,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11 -22:15:19 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30 +07:04:25 $) =over 4 @@ -3210,10 +3103,10 @@ Trig functions? =item How do I convert between numeric representations? -B, B, B, B, B, B +How do I convert hexadecimal into decimal, How do I convert from decimal to +hexadecimal, How do I convert from octal to decimal, How do I convert from +decimal to octal, How do I convert from binary to decimal, How do I convert +from decimal to binary =item Why doesn't & work the way I want it to? @@ -3406,8 +3299,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11 -22:25:25 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30 +07:04:25 $) =over 4 @@ -3499,8 +3392,8 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31 -04:27:55 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01 +22:31:09 $) =over 4 @@ -3566,8 +3459,8 @@ file? =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date: -2002/01/31 04:27:55 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date: +2002/03/26 15:48:32 $) =over 4 @@ -3645,8 +3538,8 @@ is in scope? =back -=head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28 -04:17:27 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16 +12:41:42 $) =over 4 @@ -3773,7 +3666,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27 +=head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13 $) =over 4 @@ -3875,12 +3768,14 @@ i, &, s, r =item The Optimized C Back End -B, O, 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 - =back +=item Module List for the Compiler Suite + +B, O, 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 + =item KNOWN PROBLEMS =item AUTHOR @@ -4066,7 +3961,7 @@ C, C, C =item EXAMPLE 8 (Coming Soon) -=item EXAMPLE 9 (Coming Soon) +=item EXAMPLE 9 Passing open files to XSes =item Troubleshooting these Examples @@ -4256,6 +4151,8 @@ C, C

, C, C =item Creating New Variables +GV_ADDMULTI, GV_ADDWARN + =item Reference Counts and Mortality =item Stashes and Globs @@ -4599,8 +4496,8 @@ CvSTASH, get_cv, Nullcv =item Embedding Functions -load_module, perl_alloc, perl_construct, perl_destruct, perl_free, -perl_parse, perl_run, require_pv +load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct, +perl_free, perl_parse, perl_run, require_pv =item Functions in file pp_pack.c @@ -4624,8 +4521,8 @@ HEf_SVKEY, Nullch, Nullsv get_hv, 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, newHV, Nullhv +hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval, +hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv =item Magical Functions @@ -4635,8 +4532,8 @@ SvSetSV, SvSetSV_nosteal, SvSHARE =item Memory Management -Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv, -savepvn, savesharedpv, StructCopy, Zero +Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree, +savepv, savepvn, savesharedpv, StructCopy, Zero =item Miscellaneous Functions @@ -4666,22 +4563,22 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG =item SV Manipulation Functions -get_sv, looks_like_number, memcmp_byte_utf8, newRV_inc, newRV_noinc, newSV, -newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, -newSVsv, newSVuv, new_vstring, SvCUR, SvCUR_set, SvEND, 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, SvSTASH, -SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, -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, +get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, +newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, +new_vstring, SvCUR, SvCUR_set, SvEND, 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, SvSTASH, SvTAINT, +SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, 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_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, @@ -4692,13 +4589,13 @@ sv_nounlocking, 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_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_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn +sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_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_utf8_upgrade_flags, +sv_uv, sv_vcatpvfn, sv_vsetpvfn =item Unicode Support @@ -4792,10 +4689,11 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS =item Methods in Detail -name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS, -PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup, -Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, -Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt +fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, +PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, +Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, +Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, +Set_ptrcnt =item Core Layers @@ -4803,7 +4701,7 @@ Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt =item Extension Layers -":encoding", ":Scalar", ":Object" or ":Perl" +":encoding", ":scalar", ":via" =back @@ -4835,8 +4733,8 @@ B, B, B =item Co-existence with stdio -B, B, -B, B +B, B, +B, B =item "Fast gets" Functions @@ -4876,12 +4774,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Unicode -=item use Thread for iThreads - -=item make perl_clone optionally clone ops - =item Work out exit/die semantics for threads +=item Better support for nonpreemptive threading systems like GNU pth + =item Typed lexicals for compiler =item Compiler workarounds for Win32 @@ -4906,8 +4802,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Locales -=item Thread-safe regexes - =item Arithmetic on non-Arabic numerals =item POSIX Unicode character classes @@ -4918,6 +4812,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Sort out the uid-setting mess +=item Custom opcodes + =item DLL Versioning =item Introduce @( and @) @@ -4978,8 +4874,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Cache recently used regexps -=item Re-entrant functions - =item Cross-compilation support =item Bit-shifting bitvectors @@ -5036,6 +4930,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Allow restricted hash assignment +=item Should overload be inheritable? + +=item Taint rethink + =back =item Vague ideas @@ -5078,6 +4976,12 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Update auxiliary tools +=item Create debugging macros + +=item truncate to the people + +=item Unicode in Filenames + =back =item Recently done things @@ -5198,10 +5102,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Unicode collation and normalization -=item Create debugging macros - -=item truncate to the people - =item pack/unpack tutorial =back @@ -5231,7 +5131,7 @@ 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 +It's easier to rsync the source tree, It's more reliable =item Why rsync the patches @@ -5286,6 +5186,11 @@ finish, 'enter', print F, F, F, F, F, F, F, F, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib +=item Special Make Test Targets + +coretest, test.deparse, minitest, test.third check.third utest.third +ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8 + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -5302,7 +5207,7 @@ F, F, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug -=item Compaq's/Digital's Third Degree +=item Compaq's/Digital's/HP's Third Degree =item PERL_DESTRUCT_LEVEL @@ -5319,6 +5224,8 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, -z[ero] +=item Miscellaneous tricks + =item CONCLUSION I @@ -5371,22 +5278,28 @@ I =over 4 +=item Binary Incompatibility + =item 64-bit platforms and malloc =item AIX Dynaloading -=item Attributes for C variables now handled at run-time. +=item Attributes for C variables now handled at run-time =item Socket Extension Dynamic in VMS =item IEEE-format Floating Point Default on OpenVMS Alpha +=item New Unicode Semantics (no more C, almost) + =item New Unicode Properties =item REF(...) Instead Of SCALAR(...) =item pack/unpack D/F recycled +=item glob() now returns filenames in alphabetical order + =item Deprecations =back @@ -5395,14 +5308,20 @@ I =over 4 +=item Unicode Overhaul + =item PerlIO is Now The Default -=item Safe Signals +=item ithreads -=item Unicode Overhaul +=item Restricted Hashes + +=item Safe Signals =item Understanding of Numbers +=item Arrays now always interpolate into double-quoted strings [561] + =item Miscellaneous Changes =back @@ -5445,7 +5364,7 @@ I =item Changed Internals -=item Security Vulnerability Closed +=item Security Vulnerability Closed [561] =item New Tests @@ -5453,47 +5372,99 @@ I =over 4 -=item AIX +=item The Compiler Suite Is Still Very Experimental -=item Amiga Perl Invoking Mystery +=item Localising Tied Arrays and Hashes Is Broken + +=item Building Extensions Can Fail Because Of Largefiles + +=item Modifying $_ Inside for(..) + +=item mod_perl 1.26 Doesn't Build With Threaded Perl =item lib/ftmp-security tests warn 'system possibly insecure' -=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured +=item libwww-perl (LWP) fails base/date #51 + +=item PDL failing some tests + +=item Perl_get_sv + +=item Self-tying Problems + +=item ext/threads/t/libc + +=item Failure of Thread (5.005-style) tests + +=item Timing problems + +=item Tied/Magical Array/Hash Elements Do Not Autovivify + +=item Unicode in package/class and subroutine names does not work + +=back + +=item Platform Specific Problems + +=over 4 + +=item AIX + +=item Alpha systems with old gccs fail several tests + +=item AmigaOS + +=item BeOS + +=item Cygwin "unable to remap" + +=item Cygwin ndbm tests fail on FAT + +=item DJGPP Failures + +=item FreeBSD built with ithreads coredumps reading large directories + +=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales + +=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 + +=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured + +=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint =item Linux With Sfio Fails op/misc Test 48 =item Mac OS X -=item OS/390 +=item Mac OS X dyld undefined symbols -=item op/sprintf tests 129 and 130 +=item OS/2 Test Failures -=item Failure of Thread tests +=item op/sprintf tests 91, 129, and 130 -=item UNICOS +=item Solaris 2.5 -=item UNICOS and UNICOS/mk +=item Solaris x86 Fails Tests With -Duse64bitint -=item UTS +=item SUPER-UX (NEC SX) -=item VMS +=item Term::ReadKey not working on Win32 -=item Win32 +=item UNICOS/mk -=item Localising a Tied Variable Leaks Memory +=item UTS -=item Localising Tied Arrays and Hashes Is Broken +=item VOS (Stratus) -=item Self-tying of Arrays and Hashes Is Forbidden +=item VMS -=item Building Extensions Can Fail Because Of Largefiles +=item Win32 -=item Unicode Support on EBCDIC Still Spotty +=item XML::Parser not working -=item The Compiler Suite Is Still Experimental +=item z/OS (OS/390) -=item The Long Double Support Is Still Experimental +=item Unicode Support on EBCDIC Still Spotty =item Seen In Perl 5.7 But Gone Now @@ -6235,8 +6206,6 @@ C is now C =item Known test failures -, , - =item EBCDIC platforms not fully supported =item UNICOS/mk CC failures during Configure run @@ -7072,6 +7041,8 @@ long, Process terminated by SIG%s =over 4 +=item NOTE + =item SYNOPSIS =back @@ -7124,6 +7095,8 @@ B, B =back +=item PERL 5.8.0 BROKEN IN AMIGAOS + =item AUTHORS =item SEE ALSO @@ -7146,7 +7119,7 @@ R4 x86, R4 PPC =item Contact Information -=item Update 2002-03-02 +=item Update 2002-05-30 =back @@ -7245,7 +7218,7 @@ C, I, Permissions =item Optional Libraries for Perl on Cygwin C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), -C<-lcygipc> (C) +C<-lcygipc> (C), C<-lutil> =item Configure-time Options for Perl on Cygwin @@ -7275,6 +7248,8 @@ I, Win9x and C, Compiler/Preprocessor defines =item File Permissions on Cygwin +=item NDBM_File does not work on FAT filesystems + =item Script Portability on Cygwin Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous @@ -7384,16 +7359,8 @@ DJGPP, Pthreads =item STARTING PERL ON EPOC -=item STOPPING PERL ON EPOC - -=item USING PERL ON EPOC - =over 4 -=item I/O Redirection on Epoc - -=item PATH Names on Epoc - =item Editors on Epoc =item Features of Perl on Epoc @@ -7412,8 +7379,7 @@ DJGPP, Pthreads =back -=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix -(HP-UX) systems +=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems =over 4 @@ -7421,13 +7387,34 @@ DJGPP, Pthreads =over 4 -=item Using perl as shipped with HP-UX +=item FreeBSD core dumps from readdir_r with ithreads -=item Compiling Perl 5 on HP-UX +=item $^X doesn't always contain a full path in FreeBSD -=item PA-RISC +=item Perl will no longer be part of "base FreeBSD" -=item PA-RISC 1.0 +=back + +=item AUTHOR + +=back + +=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix +(HP-UX) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Using perl as shipped with HP-UX + +=item Compiling Perl 5 on HP-UX + +=item PA-RISC + +=item PA-RISC 1.0 =item PA-RISC 1.1 @@ -7443,12 +7430,16 @@ DJGPP, Pthreads =item The HP ANSI C Compiler +=item The GNU C Compiler + =item Using Large Files with Perl on HP-UX =item Threaded Perl on HP-UX =item 64-bit Perl on HP-UX +=item Oracle on HP-UX + =item GDBM and Threads on HP-UX =item NFS filesystems and utime(2) on HP-UX @@ -7483,6 +7474,32 @@ DJGPP, Pthreads =back +=head2 perlirix, README.irix - Perl version 5 on Irix systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Building 32-bit Perl in Irix + +=item Building 64-bit Perl in Irix + +=item About Compiler Versions of Irix + +=item Linker Problems in Irix + +=item Malloc in Irix + +=item Building with threads in Irix + +=back + +=item AUTHOR + +=back + =head2 perlmachten, README.machten - Perl version 5 on Power MachTen systems @@ -7585,7 +7602,7 @@ public_html/feedback.cgi, src/perl-5.6.0-mpe =item Setup -Buildtype.bat, SetNWBld.bat, MPKBuild.bat +SetNWBld.bat, Buildtype.bat =item Make @@ -7599,8 +7616,6 @@ Buildtype.bat, SetNWBld.bat, MPKBuild.bat =item Build new extensions -=item Known Issues - =item Acknowledgements =item Authors @@ -7768,11 +7783,13 @@ C, C, OS2::SysInfo(), OS2::BootDrive(), C, C, C, C, C, -OS2::get_control87(), C +OS2::get_control87(), C, +C =item Prebuilt variables: -$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, +$OS2::nsyserror =item Misfeatures @@ -7785,7 +7802,10 @@ C =item Centralized management of resources -C, C +C, C, Treating errors reported by OS/2 API, +C, C, C, +C, C, +C, C, Loading DLLs and ordinals in DLLs =back @@ -7831,6 +7851,8 @@ C, C =over 4 +=item Text-mode filehandles + =item Priorities =item DLL name mangling: pre 5.6.2 @@ -8088,6 +8110,10 @@ Digital UNIX formerly known as DEC OSF/1) systems =item Testing Perl on Tru64 +=item ext/ODBM_File/odbm Test Failing With Static Builds + +=item Perl Fails Because Of Unresolved Symbol sockatmark + =item AUTHOR =back @@ -8247,8 +8273,12 @@ LIST, waitpid PID,FLAGS =item Restrictions of Perl on VOS +=item Handling of underflow and overflow + =back +=item TEST STATUS + =item SUPPORT STATUS =item AUTHOR @@ -8257,7 +8287,7 @@ LIST, waitpid PID,FLAGS =back -=head2 perlwin32 - Perl under Win32 +=head2 perlwin32 - Perl under Windows =over 4 @@ -8269,7 +8299,8 @@ LIST, waitpid PID,FLAGS =item Setting Up Perl on Win32 -Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC +Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform +SDK 64-bit Compiler, Mingw32 with GCC =item Building @@ -8281,7 +8312,11 @@ Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC Environment Variables, File Globbing, Using perl from the command line, Building Extensions, Command-line Wildcard Expansion, Win32 Specific -Extensions, Running Perl Scripts, Miscellaneous Things +Extensions, Notes on 64-bit Windows + +=item Running Perl Scripts + +Miscellaneous Things =back @@ -8336,8 +8371,8 @@ data structures between threads =item FUNCTIONS -share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE, -cond_signal VARIABLE, cond_broadcast VARIABLE +share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, +cond_broadcast VARIABLE =item NOTES @@ -8359,19 +8394,21 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid +threads->self, $thread->tid, threads->object( tid ), threads->yield();, +threads->list();, async BLOCK; -=item TODO +=item WARNINGS -Fix so the return value is returned when you join, Add join_all, Fix memory -leaks! +A thread exited while %d other threads were still running -=item AUTHOR and COPYRIGHT +=item TODO =item BUGS -creating a thread from within a thread is unsafe under win32, -PERL_OLD_SIGNALS are not threadsafe, will not be +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be + +=item AUTHOR and COPYRIGHT =item SEE ALSO @@ -8463,6 +8500,114 @@ method, locked =back +=head2 bigint - Transparent big integer support for Perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item OPTIONS + +a or accuracy, p or precision, t or trace, l or lib, v or version + +=item MATH LIBRARY + +=item INTERNAL FORMAT + +=item SIGN + +=item METHODS + +=back + +=item MODULES USED + +=item EXAMPLES + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + +=head2 bignum - Transparent BigNumber support for Perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item OPTIONS + +a or accuracy, p or precision, t or trace, l or lib, v or version + +=item MATH LIBRARY + +=item INTERNAL FORMAT + +=item SIGN + +=item METHODS + +=back + +=item MODULES USED + +=item EXAMPLES + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + +=head2 bigrat - Transparent BigNumber/BigRational support for Perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item MODULES USED + +=item MATH LIBRARY + +=item SIGN + +=item METHODS + +=back + +=item EXAMPLES + + perl -Mbigrat -le 'print sqrt(33)' + perl -Mbigrat -le 'print 2*255' + perl -Mbigrat -le 'print 4.5+2*255' + perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' + perl -Mbigrat -le 'print 12->is_odd()'; + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + =head2 blib - Use MakeMaker's uninstalled version of a package =over 4 @@ -8491,7 +8636,7 @@ semantics =back =head2 charnames - define character names for C<\N{named}> string literal -escapes. +escapes =over 4 @@ -8503,7 +8648,9 @@ escapes. =item charnames::viacode(code) -=item charnames::vianame(code) +=item charnames::vianame(name) + +=item ALIASES =item ILLEGAL CHARACTERS @@ -8568,14 +8715,34 @@ diagnostics =back -=head2 encoding - pragma to control the conversion of legacy data into -Unicode +=head2 encoding - allows you to write your script in non-ascii or non-utf8 =over 4 =item SYNOPSIS -=item DESCRIPTION +=item ABSTRACT + +=item USAGE + +use encoding [I] ;, use encoding I [ STDIN =E +I ...] ;, no encoding; + +=item CAVEATS + +=over 4 + +=item NOT SCOPED + +=item DO NOT MIX MULTIPLE ENCODINGS + +=back + +=item Non-ASCII Identifiers and Filter option + +use encoding I Filter=E1; + +=item EXAMPLE - Greekperl =item KNOWN PROBLEMS @@ -8668,6 +8835,8 @@ point =item CAVEATS +=item NOTES + =item SEE ALSO =item AUTHOR @@ -8685,7 +8854,7 @@ operations =back -=head2 open - perl pragma to set default disciplines for input and output +=head2 open - perl pragma to set default PerlIO layers for input and output =over 4 @@ -8860,6 +9029,8 @@ B, B, I, I =item DESCRIPTION +=item CAVEATS + =back =head2 strict - Perl pragma to restrict unsafe constructs @@ -8894,19 +9065,21 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid +threads->self, $thread->tid, threads->object( tid ), threads->yield();, +threads->list();, async BLOCK; -=item TODO +=item WARNINGS -Fix so the return value is returned when you join, Add join_all, Fix memory -leaks! +A thread exited while %d other threads were still running -=item AUTHOR and COPYRIGHT +=item TODO =item BUGS -creating a thread from within a thread is unsafe under win32, -PERL_OLD_SIGNALS are not threadsafe, will not be +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be + +=item AUTHOR and COPYRIGHT =item SEE ALSO @@ -8925,8 +9098,8 @@ structures between threads =item FUNCTIONS -share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE, -cond_signal VARIABLE, cond_broadcast VARIABLE +share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, +cond_broadcast VARIABLE =item NOTES @@ -8951,11 +9124,14 @@ code =item Utility functions -$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), -utf8::encode($string), $flag = utf8::decode($string) +$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]), +utf8::encode($string), $flag = utf8::decode($string), $flag = +utf8::valid(STRING) =back +=item BUGS + =item SEE ALSO =back @@ -9252,7 +9428,7 @@ main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist, regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c, -cstring(STR), class(OBJ), threadsv_names +cstring(STR), perlstring(STR), class(OBJ), threadsv_names =item AUTHOR @@ -9525,6 +9701,8 @@ B<-u Package> =item IMPLEMENTATION +=item BUGS + =item AUTHOR =back @@ -9577,7 +9755,7 @@ B<-u Package> =item OPTIONS -C<-oFILENAME>, C<-r>, C<-D[tO]> +C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> =item BUGS @@ -10362,12 +10540,11 @@ C<_a>, C<_exe>, C<_o> C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C +C, C =item b -C, C, C, C, C, C, -C, C +C, C, C, C, C, C, C =item c @@ -10376,38 +10553,48 @@ C, C, C, C, C, C, C, C, C, C, C, C, 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 C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -10416,40 +10603,43 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -10457,12 +10647,14 @@ C, C, C, 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, C, C, C, +C, C, C, +C, C, C, C, +C, C, C =item f @@ -10472,8 +10664,15 @@ C =item g -C, C, C, C, C, -C, C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, +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 h @@ -10483,9 +10682,9 @@ C, C, C, C =item i C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -10517,8 +10716,9 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, 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 m @@ -10535,8 +10735,9 @@ C, C, C, C, C, C C, C, C, C, C, C, 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 o @@ -10561,30 +10762,35 @@ C, C =item r -C, C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C =item s C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, 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 t C, C, C, C, C, C, C, -C, C, C, C, C, C +C, C, C, C, C, C, C, +C =item u @@ -11064,8 +11270,8 @@ stopDbSignal =item Methods -dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump, -veryCompact, set, get +dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, +compactDump, veryCompact, set, get =back @@ -11108,83 +11314,85 @@ Perl code =item SYNOPSIS -=item DESCRIPTION - =over 4 -=item TERMINOLOGY +=item Table of Contents =back -=item ENCODINGS +=item DESCRIPTION =over 4 -=item Characteristics of an Encoding +=item TERMINOLOGY -=item Types of Encodings +=back -Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, -Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings +=item PERL ENCODING API -=item Specifying Encodings +$octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, +$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, +CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, +CHECK]); -1. By name, 2. As an object +=over 4 -=item Encoding Names +=item Listing available encodings -The MIME name as defined in IETF RFCs, The name in the IANA registry, The -name used by the organization that defined it +=item Defining Aliases =back -=item PERL ENCODING API +=item Encoding via PerlIO -=over 4 +=item Handling Malformed Data -=item Generic Encoding Interface +I = Encode::FB_DEFAULT ( == 0), I = Encode::FB_CROAK ( == 1), +I = Encode::FB_QUIET, I = Encode::FB_WARN, perlqq mode +(I = Encode::FB_PERLQQ), HTML charref mode (I = +Encode::FB_HTMLCREF), XML charref mode (I = Encode::FB_XMLCREF), The +bitmask -=item Handling Malformed Data +=over 4 -Scheme 1, Scheme 2, Other Schemes +=item Unimplemented fallback schemes + +=back -=item UTF-8 / utf8 +=item Defining Encodings -=item Other Encodings of Unicode +=item The UTF-8 flag -=item Listing available encodings +Goal #1:, Goal #2:, Goal #3:, Goal #4: -=item Defining Aliases +=over 4 -As a simple string, As a qr// compiled regular expression, e.g.:, As a code -reference, e.g.: +=item Messing with Perl's Internals -=item Defining Encodings +is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back -=item Encoding and IO +=item SEE ALSO -=item Encoding How to ... +=item MAINTAINER -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 +=back -=item Messing with Perl's Internals +=head2 Encode::Alias - alias definitions to encodings -is_utf8(STRING [, CHECK]), valid_utf8(STRING) +=over 4 -=item IMPLEMENTATION CLASSES +=item SYNOPSIS --Ename, -Enew_sequence, -Eencode($string,$check), --Edecode($octets,$check) +=item DESCRIPTION -=over 4 +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: -=item Compiled Encodings +=over 4 -.enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other -variants of EBCDIC, symbol and dingbats as used by Tk on X11 +=item Alias overloading =back @@ -11192,19 +11400,23 @@ variants of EBCDIC, symbol and dingbats as used by Tk on X11 =back -=head2 Encode::Tcl - Tcl encodings +=head2 Encode::Byte - Single Byte Encodings =over 4 =item SYNOPSIS +=item ABSTRACT + =item DESCRIPTION =item SEE ALSO =back -=head2 Encode::Tcl::Escape - Tcl Escape encodings +=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* + +=head2 Encode::CN - China-based Chinese Encodings =over 4 @@ -11212,23 +11424,33 @@ variants of EBCDIC, symbol and dingbats as used by Tk on X11 =item DESCRIPTION +=item NOTES + +=item BUGS + =item SEE ALSO =back -=head2 Encode::Tcl::Extended - Tcl EUC encodings +=head2 Encode::CN::HZ -- internally used by Encode::CN + +=head2 Encode::Config -- internally used by Encode + +=head2 Encode::EBCDIC - EBCDIC Encodings =over 4 =item SYNOPSIS +=item ABSTRACT + =item DESCRIPTION =item SEE ALSO =back -=head2 Encode::Tcl::Table - Tcl Table encodings +=head2 Encode::Encoding - Encode Implementation Base Class =over 4 @@ -11236,87 +11458,618 @@ variants of EBCDIC, symbol and dingbats as used by Tk on X11 =item DESCRIPTION -=item SEE ALSO - -=back +=over 4 -=head2 Encode::lib::Encode::Tcl, Encode::Tcl - Tcl encodings +=item Methods you should implement -=over 4 +-Eencode($string [,$check]), -Edecode($octets [,$check]) -=item SYNOPSIS +=item Other methods defined in Encode::Encodings -=item DESCRIPTION +-Ename, -Enew_sequence, -Eperlio_ok(), -Eneeds_lines() -=item SEE ALSO +=item Example: Encode::ROT13 =back -=head2 Encode::lib::Encode::Tcl::Escape, Encode::Tcl::Escape - Tcl Escape -encodings +=item Why the heck Encode API is different? =over 4 -=item SYNOPSIS +=item Compiled Encodings -=item DESCRIPTION +=back =item SEE ALSO +Scheme 1, Scheme 2, Other Schemes + =back -=head2 Encode::lib::Encode::Tcl::Extended, Encode::Tcl::Extended - Tcl EUC -encodings +=head2 Encode::Guess -- Guesses encoding from data =over 4 =item SYNOPSIS +=item ABSTRACT + =item DESCRIPTION +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I]) + +=item CAVEATS + +=item TO DO + =item SEE ALSO =back -=head2 Encode::lib::Encode::Tcl::Table, Encode::Tcl::Table - Tcl Table -encodings +=head2 Encode::JP - Japanese Encodings =over 4 =item SYNOPSIS +=item ABSTRACT + =item DESCRIPTION -=item SEE ALSO +=item Note on ISO-2022-JP(-1)? + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* + +=head2 Encode::JP::JIS7 -- internally used by Encode::JP + +=head2 Encode::KR - Korean Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::KR::2022_KR -- internally used by Encode::KR + +=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO + +=over 4 + +=item Overview + +=item How does it work? + +=item BUGS + +=over 4 + +=item Workaround + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back + +=item SEE ALSO + +=back + +=head2 Encode::Supported -- Encodings supported by Encode + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings + +=item Encode::Unicode -- other Unicode encodings + +=item Encode::Byte -- Extended ASCII + +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 + +=item CJK: Chinese, Japanese, Korean (Multibyte) + +Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN + +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess + +=back + +=item Unsupported encodings + + ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, +Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran +System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, +Various Mac encodings, (Mac) Indic encodings + +=item Encoding vs. Charset -- terminology + +=item Encoding Classification (by Anton Tagunov and Dan Kogai) + +=over 4 + +=item Microsoft-related naming mess + +KS_C_5601-1987, GB2312, Big5, Shift_JIS + +=back + +=item Glossary + +character repertoire, coded character set (CCS), character encoding scheme +(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, +UTF-16 + +=item See Also + +=item References + +ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary + +=over 4 + +=item Other Notable Sites + +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" + +=item Offline sources + +C by Ken Lunde + +=back + +=back + +=head2 Encode::Symbol - Symbol Encodings + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 Encode::TW - Taiwan-based Chinese Encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item NOTES + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::Unicode -- Various Unicode Transformation Formats + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +L says:, Quick Reference + +=item Size, Endianness, and BOM + +=over 4 + +=item by size + +=item by endianness + +BOM as integer when fetched in network byte order + +=back + +=item Surrogate Pairs + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to +encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=over 4 + +=item Alias overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- +Internally used by Encode::??::ISO_2022_* + +=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by +Encode::CN + +=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by +Encode + +=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode +Implementation Base Class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods you should implement + +-Eencode($string [,$check]), -Edecode($octets [,$check]) + +=item Other methods defined in Encode::Encodings + +-Ename, -Enew_sequence, -Eperlio_ok(), -Eneeds_lines() + +=item Example: Encode::ROT13 + +=back + +=item Why the heck Encode API is different? + +=over 4 + +=item Compiled Encodings + +=back + +=item SEE ALSO + +Scheme 1, Scheme 2, Other Schemes + +=back + +=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from +data + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I]) + +=item CAVEATS + +=item TO DO + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by +Encode::JP::2022_JP* + +=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used +by Encode::JP + +=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally +used by Encode::KR + +=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' +and 'Q' header encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document +on Encode and PerlIO + +=over 4 + +=item Overview + +=item How does it work? + +=item BUGS + +=over 4 + +=item Workaround + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back + +=item SEE ALSO + +=back + +=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings +supported by Encode + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings + +=item Encode::Unicode -- other Unicode encodings + +=item Encode::Byte -- Extended ASCII + +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 + +=item CJK: Chinese, Japanese, Korean (Multibyte) + +Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN + +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess =back -=head2 Encode::lib::EncodeFormat, EncodeFormat - the format of encoding -tables of the Encode extension +=item Unsupported encodings + + ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, +Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran +System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, +Various Mac encodings, (Mac) Indic encodings + +=item Encoding vs. Charset -- terminology + +=item Encoding Classification (by Anton Tagunov and Dan Kogai) =over 4 -=item DESCRIPTION +=item Microsoft-related naming mess + +KS_C_5601-1987, GB2312, Big5, Shift_JIS -[1] B, [2] B, [3] B, [4] B +=back -=item KEYWORDS +=item Glossary -=item COPYRIGHT +character repertoire, coded character set (CCS), character encoding scheme +(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, +UTF-16 + +=item See Also + +=item References + +ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary + +=over 4 + +=item Other Notable Sites + +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" + +=item Offline sources + +C by Ken Lunde =back -=head2 EncodeFormat - the format of encoding tables of the Encode extension +=back + +=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder =over 4 -=item DESCRIPTION +=item SYNOPSIS -[1] B, [2] B, [3] B, [4] B + use Encode::Encoder; + # Encode::encode("ISO-8859-1", $data); + Encode::Encoder->new($data)->iso_8859_1; # OOP way + # shortcut + use Encode::Encoder qw(encoder); + encoder($data)->iso_8859_1; + # you can stack them! + encoder($data)->iso_8859_1->base64; # provided base64() is defined + # you can use it as a decoder as well + encoder($base64)->bytes('base64')->latin1; + # stringified + print encoder($data)->utf8->latin1; # prints the string in latin1 + # numified + encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) -=item KEYWORDS +=item ABSTRACT -=item COPYRIGHT +=item Description + +=over 4 + +=item Predefined Methods + +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) + +=item Example: base64 transcoder + +=item Operator Overloading + +=back + +=item SEE ALSO + +=back + +=head2 Encodencoding, encoding - allows you to write your script in +non-ascii or non-utf8 + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item USAGE + +use encoding [I] ;, use encoding I [ STDIN =E +I ...] ;, no encoding; + +=item CAVEATS + +=over 4 + +=item NOT SCOPED + +=item DO NOT MIX MULTIPLE ENCODINGS + +=back + +=item Non-ASCII Identifiers and Filter option + +use encoding I Filter=E1; + +=item EXAMPLE - Greekperl + +=item KNOWN PROBLEMS + +=item SEE ALSO + +=back + +=head2 Encoder, Encode::Encoder -- Object Oriented Encoder + +=over 4 + +=item SYNOPSIS + + use Encode::Encoder; + # Encode::encode("ISO-8859-1", $data); + Encode::Encoder->new($data)->iso_8859_1; # OOP way + # shortcut + use Encode::Encoder qw(encoder); + encoder($data)->iso_8859_1; + # you can stack them! + encoder($data)->iso_8859_1->base64; # provided base64() is defined + # you can use it as a decoder as well + encoder($base64)->bytes('base64')->latin1; + # stringified + print encoder($data)->utf8->latin1; # prints the string in latin1 + # numified + encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) + +=item ABSTRACT + +=item Description + +=over 4 + +=item Predefined Methods + +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) + +=item Example: base64 transcoder + +=item Operator Overloading + +=back + +=item SEE ALSO =back @@ -11457,6 +12210,18 @@ test_f file =back +=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +B + +=back + =head2 ExtUtils::Constant - generate XS code to import C header constants =over 4 @@ -11475,6 +12240,8 @@ IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF C_stringify NAME +perl_stringify NAME + constant_types memEQ_clause NAME, CHECKED_AT, INDENT @@ -11492,7 +12259,7 @@ dump_names dogfood C_constant, name, type, value, macro, default, pre, post, def_pre =item -def_post +def_post, utf8 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME @@ -11571,7 +12338,8 @@ packlist(), version() =item DESCRIPTION -For static extensions, For dynamic extensions, For dynamic extensions +For static extensions, For dynamic extensions at build/link time, For +dynamic extensions at load time =over 4 @@ -11597,6 +12365,66 @@ For static extensions, For dynamic extensions, For dynamic extensions =back +=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 ExtUtils::MM_Any - Platform agnostic MM methods + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Inherently Cross-Platform Methods + +=over 4 + +=item File::Spec wrappers B + +canonpath + +=back + +=back + +catdir + +catfile + +curdir + +file_name_is_absolute + +path + +rootdir + +updir + +=over 4 + +=item Thought To Be Cross-Platform Methods + +test_via_harness + +=back + +test_via_script + +=over 4 + +=item AUTHOR + +=back + =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -11623,7 +12451,33 @@ canonpath, cflags, manifypods, perl_archive =back -=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Overridden methods + +B + +=back + +=back + +=over 4 + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in ExtUtils::MakeMaker =over 4 @@ -11634,41 +12488,54 @@ ExtUtils::MakeMaker =back -catfile +maybe_command -constants (o) +guess_name -static_lib (o) +macify -dynamic_bs (o) +patternify -dynamic_lib (o) +init_main -canonpath +init_others -perl_script +init_dirscan -pm_to_blib +libscan (o) -test_via_harness (o) +constants (o) -tool_autosplit (override) +static (o) -tools_other (o) +dlsyms (o) -xs_o (o) +dynamic (o) -top_targets (o) +clean (o) -htmlifypods (o) +realclean (o) -manifypods (o) +rulez (o) -dist_ci (o) +processPL (o) -dist_core (o) +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker -pasthru (o) +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +constants (o) + +static_lib (o) + +dynamic_lib (o) =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -11685,7 +12552,7 @@ ExtUtils::MakeMaker perl_archive_after -=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker +=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix =over 4 @@ -11693,27 +12560,35 @@ perl_archive_after =item DESCRIPTION -=item METHODS - =over 4 -=item Preloaded methods +=item Overridden methods -canonpath +B =back =back -catdir +=over 4 -catfile +=item AUTHOR -curdir +=item SEE ALSO -rootdir +=back -updir +=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=back =over 4 @@ -11747,9 +12622,9 @@ dist_ci (o) dist_core (o) -dist_dir (o) +dist_dir -dist_test (o) +dist_test dlsyms (o) @@ -11763,10 +12638,10 @@ exescan extliblist -file_name_is_absolute - find_perl +find_tests + =over 4 =item Methods to actually produce chunks of text for the Makefile @@ -11781,13 +12656,21 @@ guess_name has_link_code -htmlifypods (o) +init_dirscan + +init_main + +init_others + +init_INST + +init_INSTALL -init_dirscan +init_lib2arch -init_main +init_PERL -init_others +init_PERM install (o) @@ -11815,20 +12698,16 @@ needs_linking (o) nicetext -parse_version - parse_abstract -pasthru (o) +parse_version -path +pasthru (o) perl_script perldepend (o) -ppd - perm_rw (o) perm_rwx (o) @@ -11841,6 +12720,8 @@ post_initialize (o) postamble (o) +ppd + prefixify processPL (o) @@ -11863,9 +12744,9 @@ subdirs (o) test (o) -test_via_harness (o) +test_via_harness (override) -test_via_script (o) +test_via_script (override) tool_autosplit (o) @@ -11914,11 +12795,9 @@ wraplist =back -rootdir (override) - =over 4 -=item SelfLoaded methods +=item Methods guess_name (override) @@ -11926,18 +12805,16 @@ guess_name (override) find_perl (override) -path (override) - maybe_command (override) maybe_command_in_dirs (override) perl_script (override) -file_name_is_absolute (override) - replace_manpage_separator +init_main (override) + init_others (override) constants (override) @@ -11986,12 +12863,8 @@ clean (override) realclean (override) -dist_basics (override) - dist_core (override) -dist_dir (override) - dist_test (override) install (override) @@ -12000,16 +12873,16 @@ perldepend (override) makefile (override) -test (override) - -test_via_harness (override) +find_tests (override) -test_via_script (override) +test (override) makeaperl (override) nicetext (override) +prefixify (override) + =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -12021,8 +12894,6 @@ ExtUtils::MakeMaker =back -catfile - constants (o) static_lib (o) @@ -12031,14 +12902,10 @@ dynamic_bs (o) dynamic_lib (o) -canonpath - perl_script pm_to_blib -test_via_harness (o) - tool_autosplit (override) tools_other (o) @@ -12047,8 +12914,6 @@ xs_o (o) top_targets (o) -htmlifypods (o) - manifypods (o) dist_ci (o) @@ -12057,6 +12922,26 @@ dist_core (o) pasthru (o) +=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + =head2 ExtUtils::MakeMaker - create an extension Makefile =over 4 @@ -12091,20 +12976,21 @@ pasthru (o) 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, -INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR, -INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, -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, 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 +EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST, +FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, +INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, +INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR, +INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, +INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, +INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB, +LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, +MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, +OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, +PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, +PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, +PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, +PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, +VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -12113,13 +12999,17 @@ tool_autosplit =item Overriding MakeMaker Methods +=item The End Of Cargo Cult Programming + +C< ' '>> + =item Hintsfile support =item Distribution Support make distcheck, make skipcheck, make distclean, make manifest, - make distdir, make tardist, make dist, make uutardist, make -shdist, make zipdist, make ci + make distdir, make disttest, make tardist, make dist, make +uutardist, make shdist, make zipdist, make ci =item Disabling an extension @@ -12151,8 +13041,8 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT =item DIAGNOSTICS -C I, C I, C I<$!>, -C I +C I, C I, C I, +C I<$!>, C I =item ENVIRONMENT @@ -12283,6 +13173,10 @@ C, C =item DESCRIPTION +=item AUTHOR + +=item HISTORY + =back =head2 File::Compare - Compare files or filehandles @@ -12455,25 +13349,9 @@ splitdir, catpath(), abs2rel, rel2abs() =item DESCRIPTION -devnull - -=back - -tmpdir - -path - canonpath() -splitpath - -splitdir - -catpath - -abs2rel - -rel2abs() +=back =over 4 @@ -12706,6 +13584,12 @@ catpath =over 4 +=item Note For File::Spec::Win32 Maintainers + +=back + +=over 4 + =item SEE ALSO =back @@ -12822,6 +13706,10 @@ TopSystemUID =item DESCRIPTION +cacheout EXPR, cacheout MODE, EXPR + +=item CAVEATS + =item BUGS =back @@ -13008,6 +13896,8 @@ B<$_>, B<$status>, B and B, B =item Object oriented interface +=item Thread Safety + =item Documentation and help texts =item Storing options in a hash @@ -13997,7 +14887,7 @@ general-utility scalar subroutines =item DESCRIPTION -blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype +blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype EXPR, tainted EXPR, weaken REF =item KNOWN BUGS @@ -14068,7 +14958,7 @@ C, C Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, http://www.egt.ie/standards/iso3166/iso3166-1-en.html, -http://www.cia.gov/cia/publications/factbook/docs/app-f.html +http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html =item AUTHOR @@ -14352,6 +15242,14 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale =item Autocreating constants +=over 4 + +=item Math library + +=item Using Math::BigInt::Lite + +=back + =item BUGS =item CAVEAT @@ -14378,6 +15276,8 @@ Canonical notation, Input, Output =over 4 +=item config + =item accuracy =item brsft @@ -14392,21 +15292,14 @@ Canonical notation, Input, Output =item bone -=item is_one() / is_zero() / is_nan() / is_positive() / is_negative() / -is_inf() / is_odd() / is_even() / is_int() +=item is_one()/is_zero()/is_nan()/is_inf() + +=item is_positive()/is_negative() - $x->is_zero(); # true if arg is +0 - $x->is_nan(); # true if arg is NaN - $x->is_one(); # true if arg is +1 - $x->is_one('-'); # true if arg is -1 - $x->is_odd(); # true if odd, false for even - $x->is_even(); # true if even, false for odd $x->is_positive(); # true if >= 0 $x->is_negative(); # true if < 0 - $x->is_inf(); # true if +inf - $x->is_inf('-'); # true if -inf (sign is default -'+') - $x->is_int(); # true if $x is an integer + +=item is_odd()/is_even()/is_int() =item bcmp @@ -14438,6 +15331,10 @@ is_inf() / is_odd() / is_even() / is_int() =item bmod +=item bmodinv + +=item bmodpow + =item bpow =item blsft @@ -14589,6 +15486,54 @@ the same terms as Perl itself. =back +=head2 Math::BigRat - arbitrarily big rationals + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item MATH LIBRARY + +=back + +=item METHODS + +=over 4 + +=item new() + +=item numerator() + +=item denominator() + + $d = $x->denominator(); + +=item parts() + +=item as_number() + +=item bfac() + +=item blog() + +=item bround()/round()/bfround() + +=back + +=item BUGS + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + =head2 Math::Complex - complex numbers and associated mathematical functions @@ -14673,7 +15618,7 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =back -=head2 Memoize - Make your functions faster by trading space for time +=head2 Memoize - Make functions faster by trading space for time =over 4 @@ -15063,9 +16008,10 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit () =item Functions -Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, -$p->bind($local_addr);, $p->ping($host [, $timeout]);, $p->open($host);, -$p->open($host);, $p->close();, pingecho($host [, $timeout]); +Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, +$timeout]);, $p->source_verify( { 0 | 1 } );, $p->hires( { 0 | 1 } );, +$p->bind($local_addr);, $p->open($host);, $p->close();, pingecho($host [, +$timeout]); =back @@ -15073,6 +16019,8 @@ $p->open($host);, $p->close();, pingecho($host [, $timeout]); =item NOTES +=item INSTALL + =item AUTHORS =item COPYRIGHT @@ -15103,6 +16051,8 @@ ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), quit () +=item ADDRESSES + =item SEE ALSO =item AUTHOR @@ -15336,6 +16286,8 @@ login (), password (), account (), lpa () =item IMPLEMENTATION +=item BUGS + =item AUTHOR =back @@ -15593,10 +16545,12 @@ name space =item DESCRIPTION -unix, stdio, perlio, crlf, utf8, raw +unix, stdio, perlio, crlf, utf8, bytes, raw, pop =over 4 +=item Alternatives to raw + =item Defaults and how to override them =back @@ -15607,7 +16561,19 @@ unix, stdio, perlio, crlf, utf8, raw =back -=head2 PerlIO::Scalar - support module for in-memory IO. +=head2 PerlIO::encoding - encoding layer + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + +=head2 PerlIO::scalar - support module for in-memory IO. =over 4 @@ -15617,7 +16583,7 @@ unix, stdio, perlio, crlf, utf8, raw =back -=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl +=head2 PerlIO::via - Helper class for PerlIO layers implemented in perl =over 4 @@ -15625,13 +16591,18 @@ unix, stdio, perlio, crlf, utf8, raw =item DESCRIPTION +=item EXPECTED METHODS + $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) +$obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]), +$obj->FDOPEN($fd[,$fh]), $obj->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) + +=item EXAMPLES =over 4 @@ -15641,6 +16612,20 @@ $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) =back +=head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item COPYRIGHT + +=back + =head2 Pod::Checker, podchecker() - check pod documents for syntax errors =over 4 @@ -15677,7 +16662,7 @@ after =back =item Warnings -multiple occurence of link target I, line containing nothing but +multiple occurrence 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 @@ -16176,7 +17161,7 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =back -=head2 Pod::ParseLink -- Parse an LEE formatting code in POD text +=head2 Pod::ParseLink - Parse an LEE formatting code in POD text =over 4 @@ -16184,6 +17169,8 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =item DESCRIPTION +=item SEE ALSO + =item AUTHOR =item COPYRIGHT AND LICENSE @@ -16726,8 +17713,8 @@ text =back -=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII -text with format escapes +=head2 Pod::Text::Termcap - Convert POD data to ASCII text with format +escapes =over 4 @@ -16815,6 +17802,43 @@ E, E, E, E, E, E =back +=head2 Pod::t::htmlescp, Escape Sequences Test + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Pod::t::htmlview, Test HTML Rendering + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS =E OTHER STUFF + +=over 4 + +=item new() + +foo, bar, baz, C Cat, Sat S the>, MatE!E, 1 Cat, 2 +Sat, 3 Mat + +=item old() + +=back + +=item TESTING FOR AND BEGIN + +=item TESTING URLs hyperlinking + +=item SEE ALSO + +=back + =head2 SDBM_File - Tied access to sdbm files =over 4 @@ -16878,7 +17902,7 @@ Memory, CPU, Snooping, Signals, State Changes =item DESCRIPTION -blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype +blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype EXPR, tainted EXPR, weaken REF =item KNOWN BUGS @@ -16972,7 +17996,7 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN =back -=head2 Storable - persistency for perl data structures +=head2 Storable - persistence for Perl data structures =over 4 @@ -16988,6 +18012,10 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN =item CANONICAL REPRESENTATION +=item FORWARD COMPATIBILITY + +utf8 data, restricted hashes, files from future versions of Storable + =item ERROR REPORTING =item WIZARDS ONLY @@ -17018,9 +18046,13 @@ C =item BUGS -=item CREDITS +=over 4 -=item TRANSLATIONS +=item 64 bit data in perl 5.6.0 and 5.6.1 + +=back + +=item CREDITS =item AUTHOR @@ -17096,8 +18128,8 @@ interface to the UNIX syslog(3) calls =item DESCRIPTION openlog $ident, $logopt, $facility, syslog $priority, $format, @args, -setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), -closelog +setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added +in 5.004_02), closelog =item EXAMPLES @@ -17117,8 +18149,8 @@ Perl interface to the UNIX syslog(3) calls =item DESCRIPTION openlog $ident, $logopt, $facility, syslog $priority, $format, @args, -setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), -closelog +setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added +in 5.004_02), closelog =item EXAMPLES @@ -17154,7 +18186,7 @@ ANSI_COLORS_DISABLED =item AUTHORS -=item LICENSE +=item COPYRIGHT AND LICENSE =back @@ -17328,6 +18360,8 @@ B, B B, B +B + B B @@ -17384,6 +18418,8 @@ B<_my_exit> =over 4 +=item THREADS + =item EXAMPLES =item SEE ALSO @@ -17448,13 +18484,13 @@ B<_leader_width> C, C, C, C, C, C +%s>, C =item ENVIRONMENT -C, C, C, -C, C, C, -C +C, C, C, +C, C, C, +C, C =item EXAMPLE @@ -17646,6 +18682,8 @@ B B, B +When do I use SKIP vs. TODO? + =over 4 =item Comparison functions @@ -17902,7 +18940,7 @@ unexpand(1) =back -=head2 Thread - manipulate threads in Perl +=head2 Thread - manipulate threads in Perl (for old code only) =over 4 @@ -17959,9 +18997,12 @@ new, new NUMBER, down, down NUMBER, up, up NUMBER =back =head2 Thread::Signal - Start a thread which runs signal handlers reliably +(for old code) =over 4 +=item CAVEAT + =item SYNOPSIS =item DESCRIPTION @@ -18011,9 +19052,13 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST =item C +=item C + =item C -=item C +=item C + +=item C =item Option Format @@ -18025,24 +19070,28 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST =item C -=item Tying to an already-opened filehandle +=item C -=back +=item C, C, C, and C -=item CAVEATS +=back -=over 4 +=item Tying to an already-opened filehandle -=item Efficiency Note +=item Deferred Writing -=item Efficiency Note 2 +=over 4 -=item Efficiency Note 3 +=item Autodeferring =back =item CAVEATS +=item SUBCLASSING + +=item WHAT ABOUT C? + =item AUTHOR =item LICENSE @@ -18257,7 +19306,7 @@ $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD =back -=head2 Unicode::Collate - use UCA (Unicode Collation Algorithm) +=head2 Unicode::Collate - Unicode Collation Algorithm =over 4 @@ -18273,34 +19322,44 @@ alternate, backwards, entry, ignoreName, ignoreChar, level, normalization, overrideCJK, overrideHangul, preprocess, rearrange, table, undefName, undefChar, katakana_before_hiragana, upper_before_lower -=item Other methods +=item Methods for Collation C<@sorted = $Collator-Esort(@not_sorted)>, C<$result = $Collator-Ecmp($a, $b)>, C<$result = $Collator-Eeq($a, $b)>, C<$result = $Collator-Ene($a, $b)>, C<$result = $Collator-Elt($a, $b)>, C<$result = $Collator-Ele($a, $b)>, C<$result = $Collator-Egt($a, $b)>, C<$result = $Collator-Ege($a, $b)>, -C<$sortKey = $Collator-EgetSortKey($string)>, C<$position = +C<$sortKey = $Collator-EgetSortKey($string)>, C<$sortKeyForm = +$Collator-EviewSortKey($string)>, C<$position = $Collator-Eindex($string, $substring)>, C<($position, $length) = $Collator-Eindex($string, $substring)> +=item Other Methods + +UCA_Version, Base_Unicode_Version + =item EXPORT =item TODO =item CAVEAT +=item BUGS + =back =item AUTHOR =item SEE ALSO -Unicode Collation Algorithm - Unicode TR #10, L +http://www.unicode.org/unicode/reports/tr10/, +http://www.unicode.org/unicode/reports/tr10/allkeys.txt, +http://www.unicode.org/unicode/reports/tr15/, +http://www.unicode.org/unicode/reports/tr18, L =back -=head2 Unicode::Normalize - normalized forms of Unicode text +=head2 Unicode::Normalize - Unicode Normalization Forms =over 4 @@ -18312,28 +19371,42 @@ Unicode Collation Algorithm - Unicode TR #10, L =item Normalization Forms -C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>, -C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>, -C<$normalized_string = normalize($form_name, $raw_string)> +C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, +C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, +C<$normalized_string = normalize($form_name, $string)> + +=item Decomposition and Composition + +C<$decomposed_string = decompose($string)>, C<$decomposed_string = +decompose($string, $useCompatMapping)>, C<$reordered_string = +reorder($string)>, C<$composed_string = compose($string)> + +=item Quick Check + +C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = +checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = +check($form_name, $string)> =item Character Data C<$canonical_decomposed = getCanon($codepoint)>, -C<$compatibility_decomposed = getCompat($codepoint)>, C<$uv_composite = -getComposite($uv_here, $uv_next)>, C<$combining_class = -getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)> +C<$compatibility_decomposed = getCompat($codepoint)>, +C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, +C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = +isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, +C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>, +C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> =item EXPORT -=item TODO - =back =item AUTHOR =item SEE ALSO -http://www.unicode.org/unicode/reports/tr15/ +http://www.unicode.org/unicode/reports/tr15/, +http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt =back @@ -18483,7 +19556,7 @@ Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), -Win32::GetNextAvailDrive(), Win32::GetOSVersion(), +Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(), Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), @@ -18499,24 +19572,6 @@ Win32::UnregisterServer(LIBRARYNAME) =back -=head2 XS::Typemap - module to test the XS typemaps distributed with perl - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=back - -=over 4 - -=item NOTES - -=item AUTHOR - -=back - =head2 XSLoader - Dynamically load C libraries into Perl code =over 4