X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=9b8654edc1192147fa2e7f71800a87193691e98a;hb=231c9faeb17b45588bbde0b49d0d32f25d2a1286;hp=89272113cfae639e2a8e244c5c58ad3d44b63fc3;hpb=4b661809a7c66d2c579a3f04c11e70664742d63e;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 8927211..9b8654e 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -19,16 +19,6 @@ through to locate the proper section you're looking for. =item DESCRIPTION -modularity and reusability using innumerable modules, embeddable and -extensible, roll-your-own magic variables (including multiple simultaneous -DBM implementations), subroutines can now be overridden, autoloaded, and -prototyped, arbitrarily nested data structures and anonymous functions, -object-oriented programming, compilability into C code or Perl bytecode, -support for light-weight processes (threads), support for -internationalization, localization, and Unicode, lexical scoping, regular -expression enhancements, enhanced debugger and interactive Perl -environment, with integrated editor support, POSIX 1003.1 compliant library - =item AVAILABILITY =item ENVIRONMENT @@ -54,276 +44,61 @@ environment, with integrated editor support, POSIX 1003.1 compliant library =item DESCRIPTION -perlfaq: Structural overview of the FAQ, L: General Questions -About Perl, What is Perl?, Who supports Perl? Who develops it? Why is it -free?, Which version of Perl should I use?, What are perl4 and perl5?, What -is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl -compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can -I do [task] in Perl?, When shouldn't I program in Perl?, What's the -difference between "perl" and "Perl"?, Is it a Perl program or a Perl -script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?, -How can I convince my sysadmin/supervisor/employees to use version -5/5.005/Perl instead of some other language?, L: Obtaining and -Learning about Perl, What machines support Perl? Where do I get it?, How -can I get a binary version of Perl?, I don't have a C compiler on my -system. How can I compile perl?, I copied the Perl binary from one machine -to another, but scripts don't work, I grabbed the sources and tried to -compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make -it work?, What modules and extensions are available for Perl? What is -CPAN? What does CPAN/src/... mean?, Is there an ISO or ANSI certified -version of Perl?, Where can I get information on Perl?, What are the Perl -newsgroups on Usenet? Where do I post questions?, Where should I post -source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW -Access, What mailing lists are there for Perl?, Archives of -comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where -do I send bug reports?, What is perl.com? Perl Mongers? pm.org? perl.org?, -L: Programming Tools, How do I do (anything)?, How can I use Perl -interactively?, Is there a Perl shell?, How do I debug my Perl programs?, -How do I profile my Perl programs?, How do I cross-reference my Perl -programs?, Is there a pretty-printer (formatter) for Perl?, Is there a -ctags for Perl?, Is there an IDE or Windows Perl Editor?, Where can I get -Perl macros for vi?, Where can I get perl-mode for emacs?, How can I use -curses with Perl?, How can I use X or Tk with Perl?, How can I generate -simple menus without using CGI or Tk?, What is undump?, How can I make my -Perl program run faster?, How can I make my Perl program take less memory?, -Is it unsafe to return a pointer to local data?, How can I free an array or -hash so my program shrinks?, How can I make my CGI script more efficient?, -How can I hide the source for my Perl program?, How can I compile my Perl -program into byte code or C?, How can I compile Perl into Java?, How can I -get C<#!perl> to work on [MS-DOS,NT,...]?, Can I write useful Perl programs -on the command line?, Why don't Perl one-liners work on my DOS/Mac/VMS -system?, Where can I learn about CGI or Web programming in Perl?, Where can -I learn about object-oriented Perl programming?, Where can I learn about -linking C with Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., -but I can't embed perl in my C program; what am I doing wrong?, When I -tried to run my script, I got this message. What does it mean?, What's -MakeMaker?, L: Data Manipulation, Why am I getting long decimals -(eg, 19.9499999999999) instead of the numbers I should be getting (eg, -19.95)?, Why isn't my octal data interpreted correctly?, Does Perl have a -round() function? What about ceil() and floor()? Trig functions?, How do -I convert bits into ints?, Why doesn't & work the way I want it to?, How do -I multiply matrices?, How do I perform an operation on a series of -integers?, How can I output Roman numerals?, Why aren't my random numbers -random?, How do I find the week-of-the-year/day-of-the-year?, How do I find -the current century or millennium?, How can I compare two dates and find -the difference?, How can I take a string and turn it into epoch seconds?, -How can I find the Julian Day?, How do I find yesterday's date?, Does Perl -have a Year 2000 problem? Is Perl Y2K compliant?, How do I validate -input?, How do I unescape a string?, How do I remove consecutive pairs of -characters?, How do I expand function calls in a string?, How do I find -matching/nesting anything?, How do I reverse a string?, How do I expand -tabs in a string?, How do I reformat a paragraph?, How can I access/change -the first N letters of a string?, How do I change the Nth occurrence of -something?, How can I count the number of occurrences of a substring within -a string?, How do I capitalize all the words on one line?, How can I split -a [character] delimited string except when inside [character]? -(Comma-separated files), How do I strip blank space from the beginning/end -of a string?, How do I pad a string with blanks or pad a number with -zeroes?, How do I extract selected columns from a string?, How do I find -the soundex value of a string?, How can I expand variables in text -strings?, What's wrong with always quoting "$vars"?, Why don't my <: Files and Formats, How do I flush/unbuffer an output -filehandle? Why must I do this?, How do I change one line in a file/delete -a line in a file/insert a line in the middle of a file/append to the -beginning of a file?, How do I count the number of lines in a file?, How do -I make a temporary file name?, How can I manipulate fixed-record-length -files?, How can I make a filehandle local to a subroutine? How do I pass -filehandles between subroutines? How do I make an array of filehandles?, -How can I use a filehandle indirectly?, How can I set up a footer format to -be used with write()?, How can I write() into a string?, How can I output -my numbers with commas added?, How can I translate tildes (~) in a -filename?, How come when I open a file read-write it wipes it out?, Why do -I sometimes get an "Argument list too long" when I use <*>?, Is there a -leak/bug in glob()?, How can I open a file with a leading ">" or trailing -blanks?, How can I reliably rename a file?, How can I lock a file?, Why -can't I just open(FH, ">file.lock")?, I still don't get locking. I just -want to increment the number in the file. How can I do this?, How do I -randomly update a binary file?, How do I get a file's timestamp in perl?, -How do I set a file's timestamp in perl?, How do I print to more than one -file at once?, How can I read in an entire file all at once?, How can I -read in a file by paragraphs?, How can I read a single character from a -file? From the keyboard?, How can I tell whether there's a character -waiting on a filehandle?, How do I do a C in perl?, How do I dup() -a filehandle in Perl?, How do I close a file descriptor by number?, Why -can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe` -work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me -delete read-only files? Why does C<-i> clobber protected files? Isn't -this a bug in Perl?, How do I select a random line from a file?, Why do I -get weird spaces when I print an array of lines?, L: Regexps, How -can I hope to use regular expressions without creating illegible and -unmaintainable code?, I'm having trouble matching over more than one line. -What's wrong?, How can I pull out lines between two patterns that are -themselves on different lines?, I put a regular expression into $/ but it -didn't work. What's wrong?, How do I substitute case insensitively on the -LHS while preserving case on the RHS?, How can I make C<\w> match national -character sets?, How can I match a locale-smart version of C?, -How can I quote a variable to use in a regex?, What is C really for?, -How do I use a regular expression to strip C style comments from a file?, -Can I use Perl regular expressions to match balanced text?, What does it -mean that regexes are greedy? How can I get around it?, How do I process -each word on each line?, How can I print out a word-frequency or -line-frequency summary?, How can I do approximate matching?, How do I -efficiently match many regular expressions at once?, Why don't -word-boundary searches with C<\b> work for me?, Why does using $&, $`, or -$' slow my program down?, What good is C<\G> in a regular expression?, Are -Perl regexes DFAs or NFAs? Are they POSIX compliant?, What's wrong with -using grep or map in a void context?, How can I match strings with -multibyte characters?, How do I match a pattern that is supplied by the -user?, L: General Perl Language Issues, Can I get a BNF/yacc/RE -for the Perl language?, What are all these $@%&* punctuation signs, and how -do I know when to use them?, Do I always/never have to quote my strings or -use semicolons and commas?, How do I skip some return values?, How do I -temporarily block warnings?, What's an extension?, Why do Perl operators -have different precedence than C operators?, How do I declare/create a -structure?, How do I create a module?, How do I create a class?, How can I -tell if a variable is tainted?, What's a closure?, What is variable suicide -and how can I prevent it?, How can I pass/return a {Function, FileHandle, -Array, Hash, Method, Regex}?, How do I create a static variable?, What's -the difference between dynamic and lexical (static) scoping? Between -local() and my()?, How can I access a dynamic variable while a similarly -named lexical is in scope?, What's the difference between deep and shallow -binding?, Why doesn't "my($foo) = ;" work right?, How do I redefine a -builtin function, operator, or method?, What's the difference between -calling a function as &foo and foo()?, How do I create a switch or case -statement?, How can I catch accesses to undefined -variables/functions/methods?, Why can't a method included in this same file -be found?, How can I find out my current package?, How can I comment out a -large block of perl code?, How do I clear a package?, How can I use a -variable as a variable name?, L: System Interaction, How do I -find out which operating system I'm running under?, How come exec() doesn't -return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I -print something out in color?, How do I read just one key without waiting -for a return key?, How do I check whether input is ready on the keyboard?, -How do I clear the screen?, How do I get the screen size?, How do I ask the -user for a password?, How do I read and write the serial port?, How do I -decode encrypted password files?, How do I start a process in the -background?, How do I trap control characters/signals?, How do I modify the -shadow password file on a Unix system?, How do I set the time and date?, -How can I sleep() or alarm() for under a second?, How can I measure time -under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception -handling), Why doesn't my sockets program work under System V (Solaris)? -What does the error message "Protocol not supported" mean?, How can I call -my system's unique C functions from Perl?, Where do I get the include files -to do ioctl() or syscall()?, Why do setuid perl scripts complain about -kernel problems?, How can I open a pipe both to and from a command?, Why -can't I get the output of a command with system()?, How can I capture -STDERR from an external command?, Why doesn't open() return an error when a -pipe open fails?, What's wrong with using backticks in a void context?, How -can I call backticks without shell processing?, Why can't my script read -from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I -convert my shell script to perl?, Can I use perl to run a telnet or ftp -session?, How can I write expect in Perl?, Is there a way to hide perl's -command line from programs such as "ps"?, I {changed directory, modified my -environment} in a perl script. How come the change disappeared when I -exited the script? How do I get my changes to be visible?, How do I close -a process's filehandle without waiting for it to complete?, How do I fork a -daemon process?, How do I find out if I'm running interactively or not?, -How do I timeout a slow event?, How do I set CPU limits?, How do I avoid -zombies on a Unix system?, How do I use an SQL database?, How do I make a -system() exit on control-C?, How do I open a file without blocking?, How do -I install a module from CPAN?, What's the difference between require and -use?, How do I keep my own module/library directory?, How do I add the -directory my program lives in to the module/library search path?, How do I -add a directory to my include path at runtime?, What is socket.ph and where -do I get it?, L: Networking, My CGI script runs from the command -line but not the browser. (500 Server Error), How can I get better error -messages from a CGI program?, How do I remove HTML from a string?, How do I -extract URLs?, How do I download a file from the user's machine? How do I -open a file on another machine?, How do I make a pop-up menu in HTML?, How -do I fetch an HTML file?, How do I automate an HTML form submission?, How -do I decode or create those %-encodings on the web?, How do I redirect to -another page?, How do I put a password on my web pages?, How do I edit my -.htpasswd and .htgroup files with Perl?, How do I make sure users can't -enter values into a form that cause my CGI script to do bad things?, How do -I parse a mail header?, How do I decode a CGI form?, How do I check a valid -mail address?, How do I decode a MIME/BASE64 string?, How do I return the -user's mail address?, How do I send mail?, How do I read mail?, How do I -find out my hostname/domainname/IP address?, How do I fetch a news article -or the active newsgroups?, How do I fetch/put an FTP file?, How can I do -RPC in Perl? - -=over 4 - -=item Where to get this document - -=item How to contribute to this document +=over 4 -=item What will happen if you mail your Perl programming problems to the -authors +=item perlfaq: Structural overview of the FAQ. -=back +=item L: General Questions About Perl -=item Credits +=item L: Obtaining and Learning about Perl -=item Author and Copyright Information +=item L: Programming Tools -=over 4 +=item L: Data Manipulation -=item Bundled Distributions +=item L: Files and Formats -=item Disclaimer +=item L: Regexps -=back +=item L: General Perl Language Issues -=item Changes +=item L: System Interaction -1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, -24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, -Initial Release: 11/March/97 +=item L: Networking =back -=head2 perltoc - perl documentation table of contents +=item About the perlfaq documents =over 4 -=item DESCRIPTION +=item Where to get the perlfaq -=item BASIC DOCUMENTATION +=item How to contribute to the perlfaq -=over 4 +=item What will happen if you mail your Perl programming problems to the +authors + +=back -=item perl - Practical Extraction and Report Language +=item Credits -SYNOPSIS, DESCRIPTION, AVAILABILITY, ENVIRONMENT, AUTHOR, FILES, SEE ALSO, -DIAGNOSTICS, BUGS, NOTES +=item Author and Copyright Information -=item perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 -20:38:02 $) +=over 4 + +=item Bundled Distributions -DESCRIPTION +=item Disclaimer =back +=item Changes + +1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, +24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, +Initial Release: 11/March/97 + =back =head2 perlbook - Perl book information @@ -511,10 +286,6 @@ regular expressions =item When to Still Use local() -1. You need to give a global variable a temporary value, especially $_, 2. -You need to create a local file or directory handle or a local function, 3. -You want to temporarily change just one element of an array or hash - =item Pass by Reference =item Prototypes @@ -609,14 +380,14 @@ 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, 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, 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,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 @@ -778,13 +549,6 @@ more elaborate constructs =item Using character classes -\d is a digit and represents [0-9], \s is a whitespace character and -represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and -represents [0-9a-zA-Z_], \D is a negated \d; it represents any character -but a digit [^0-9], \S is a negated \s; it represents any non-whitespace -character [^\s], \W is a negated \w; it represents any non-word character -[^\w], The period '.' matches any character but "\n" - =item Matching this or that =item Grouping things and hierarchical matching @@ -793,12 +557,6 @@ character [^\s], \W is a negated \w; it represents any non-word character =item Matching repetitions -C = match 'a' 1 or 0 times, C = match 'a' 0 or more times, i.e., -any number of times, C = match 'a' 1 or more times, i.e., at least -once, C = match at least C times, but not more than C times, -C = match at least C or more times, C = match exactly C -times - =item More matching =item Search and replace @@ -1168,6 +926,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item DESCRIPTION +=over 4 + =item Declaration and Access of Arrays of Arrays =item Growing Your Own @@ -1176,6 +936,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item Slices +=back + =item SEE ALSO =item AUTHOR @@ -1262,90 +1024,16 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item Using character classes -\d is a digit and represents [0-9], \s is a whitespace character and -represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and -represents [0-9a-zA-Z_], \D is a negated \d; it represents any character -but a digit [^0-9], \S is a negated \s; it represents any non-whitespace -character [^\s], \W is a negated \w; it represents any non-word character -[^\w], The period '.' matches any character but "\n", no modifiers (//): -Default behavior. C<'.'> matches any character except C<"\n">. C<^> -matches only at the beginning of the string and C<$> matches only at the -end or before a newline at the end, s modifier (//s): Treat string as a -single long line. C<'.'> matches any character, even C<"\n">. C<^> -matches only at the beginning of the string and C<$> matches only at the -end or before a newline at the end, m modifier (//m): Treat string as a set -of multiple lines. C<'.'> matches any character except C<"\n">. C<^> and -C<$> are able to match at the start or end of I line within the -string, both s and m modifiers (//sm): Treat string as a single long line, -but detect multiple lines. C<'.'> matches any character, even C<"\n">. -C<^> and C<$>, however, are able to match at the start or end of I -line within the string - =item Matching this or that =item Grouping things and hierarchical matching -0 Start with the first letter in the string 'a', 1 Try the first -alternative in the first group 'abd', 2 Match 'a' followed by 'b'. So far -so good, 3 'd' in the regexp doesn't match 'c' in the string - a dead end. -So backtrack two characters and pick the second alternative in the first -group 'abc', 4 Match 'a' followed by 'b' followed by 'c'. We are on a roll -and have satisfied the first group. Set $1 to 'abc', 5 Move on to the -second group and pick the first alternative 'df', 6 Match the 'd', 7 'f' in -the regexp doesn't match 'e' in the string, so a dead end. Backtrack one -character and pick the second alternative in the second group 'd', 8 'd' -matches. The second grouping is satisfied, so set $2 to 'd', 9 We are at -the end of the regexp, so we are done! We have matched 'abcd' out of the -string "abcde" - =item Extracting matches =item Matching repetitions -C = match 'a' 1 or 0 times, C = match 'a' 0 or more times, i.e., -any number of times, C = match 'a' 1 or more times, i.e., at least -once, C = match at least C times, but not more than C times, -C = match at least C or more times, C = match exactly C -times, Principle 0: Taken as a whole, any regexp will be matched at the -earliest possible position in the string, Principle 1: In an alternation -C, the leftmost alternative that allows a match for the whole -regexp will be the one used, Principle 2: The maximal matching quantifiers -C, C<*>, C<+> and C<{n,m}> will in general match as much of the string -as possible while still allowing the whole regexp to match, Principle 3: If -there are two or more elements in a regexp, the leftmost greedy quantifier, -if any, will match as much of the string as possible while still allowing -the whole regexp to match. The next leftmost greedy quantifier, if any, -will try to match as much of the string remaining available to it as -possible, while still allowing the whole regexp to match. And so on, until -all the regexp elements are satisfied, C = match 'a' 0 or 1 times. Try -0 first, then 1, C = match 'a' 0 or more times, i.e., any number of -times, but as few times as possible, C = match 'a' 1 or more times, -i.e., at least once, but as few times as possible, C = match at -least C times, not more than C times, as few times as possible, -C = match at least C times, but as few times as possible, -C = match exactly C times. Because we match exactly C times, -C is equivalent to C and is just there for notational -consistency, Principle 3: If there are two or more elements in a regexp, -the leftmost greedy (non-greedy) quantifier, if any, will match as much -(little) of the string as possible while still allowing the whole regexp to -match. The next leftmost greedy (non-greedy) quantifier, if any, will try -to match as much (little) of the string remaining available to it as -possible, while still allowing the whole regexp to match. And so on, until -all the regexp elements are satisfied, 0 Start with the first letter in the -string 't', 1 The first quantifier '.*' starts out by matching the whole -string 'the cat in the hat', 2 'a' in the regexp element 'at' doesn't match -the end of the string. Backtrack one character, 3 'a' in the regexp -element 'at' still doesn't match the last letter of the string 't', so -backtrack one more character, 4 Now we can match the 'a' and the 't', 5 -Move on to the third element '.*'. Since we are at the end of the string -and '.*' can match 0 times, assign it the empty string, 6 We are done! - =item Building a regexp -specifying the task in detail,, breaking down the problem into smaller -parts,, translating the small parts into regexps,, combining the regexps,, -and optimizing the final combined regexp - =item Using regular expressions in Perl =back @@ -1658,6 +1346,8 @@ C<(?(condition)yes-pattern|no-pattern)> =item DESCRIPTION +=item Class Data in a Can + =item Class Data as Package Variables =over 4 @@ -2129,8 +1819,6 @@ http://testers.cpan.org/ =item DOS and Derivatives -Build instructions for OS/2, L - =item S =item VMS @@ -2170,9 +1858,9 @@ 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, socketpair -SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat, -symlink OLDFILE,NEWFILE, syscall LIST, sysopen +shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, +socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat +EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, wait, waitpid PID,FLAGS @@ -2251,15 +1939,6 @@ localization) =item SECURITY -B (C, C, C, C and C):, -B (with C<\l>, C<\L>, C<\u> or C<\U>), -B (C):, B (C):, -B (printf() and write()):, B (lc(), lcfirst(), uc(), ucfirst()):, B (localeconv(), strcoll(), strftime(), strxfrm()):, B (isalnum(), isalpha(), isdigit(), isgraph(), -islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()): - =item ENVIRONMENT PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, @@ -2307,7 +1986,7 @@ LC_NUMERIC, LC_TIME, LANG =over 4 -=item Important Caveat +=item Important Caveats Input and Output Disciplines, Regular Expressions, C still needed to enable a few features @@ -2546,20 +2225,8 @@ User::pwent =item CPAN -Language Extensions and Documentation Tools, Development Support, Operating -System Interfaces, Networking, Device Control (modems) and InterProcess -Communication, Data Types and Data Type Utilities, Database Interfaces, -User Interfaces, Interfaces to / Emulations of Other Programming Languages, -File Names, File Systems and File Locking (see also File Handles), String -Processing, Language Text Processing, Parsing, and Searching, Option, -Argument, Parameter, and Configuration File Processing, -Internationalization and Locale, Authentication, Security, and Encryption, -World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities, -Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing, -and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and -exceptions etc), File Handle and Input/Output Stream Utilities, -Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe, -North America, South America +Africa, Asia, Australasia, Central America, Europe, North America, South +America =item Modules: Creation, Use, and Abuse @@ -2588,12 +2255,6 @@ to ::, Converts die(...) to croak(...), Several other minor changes =item Guidelines for Reusing Application Code -Complete applications rarely belong in the Perl Module Library, Many -applications contain some Perl code that could be reused, Break-out the -reusable code into one or more separate module files, Take the opportunity -to reconsider and redesign the interfaces, In some cases the 'application' -can then be reduced to a small - =back =item NOTE @@ -2959,11 +2620,7 @@ the tag =item How can I remove duplicate elements from a list or array? -a) If @in is sorted, and you want @out to be sorted: (this assumes all true -values in the array), b) If you don't know whether @in is sorted:, c) Like -(b), but @in contains only small integers:, d) A way to do (b) without any -loops or greps:, e) Like (d), but @in contains only small positive -integers: +a), b), c), d), e) =item How can I tell whether a list or array contains a certain element? @@ -3470,6 +3127,8 @@ CGI script to do bad things? =item How do I send mail? +=item How do I use MIME to make an attachment to a mail message? + =item How do I read mail? =item How do I find out my hostname/domainname/IP address? @@ -3545,14 +3204,6 @@ Perl?>, B, B =item ROADMAP -Compiling your C program, Adding a Perl interpreter to your C program, -Calling a Perl subroutine from your C program, Evaluating a Perl statement -from your C program, Performing Perl pattern matches and substitutions from -your C program, Fiddling with the Perl stack from your C program, -Maintaining a persistent interpreter, Maintaining multiple interpreter -instances, Using Perl modules, which themselves use C libraries, from your -C program, Embedding Perl under Win32 - =item Compiling your C program =item Adding a Perl interpreter to your C program @@ -3833,6 +3484,38 @@ C, C, C =back +=head2 perlclib - Internal replacements for standard C library functions + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Conventions + +C, C

, C, C + +=item File Operations + +=item File Input and Output + +=item File Positioning + +=item Memory Management and String Handling + +=item Character Class Tests + +=item F functions + +=item Miscellaneous functions + +=back + +=item SEE ALSO + +=back + =head2 perlguts - Introduction to the Perl API =over 4 @@ -3884,14 +3567,15 @@ C, C, C =item Localizing changes C, C, C, C, -C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, C, -C +C, C, C, C, C, C, C, +C, +C, +C, C, C, C, C, +C, C, +C, C, C =back @@ -3941,15 +3625,19 @@ C =item Background and PERL_IMPLICIT_CONTEXT +=item So what happened to dTHR? + =item How do I use all this in extensions? +=item Should I do anything special if I call perl from multiple threads? + =item Future Plans and PERL_IMPLICIT_SYS =back =item Internal Functions -A, p, d, s, n, r, f, m, o, j, x +A, p, d, s, n, r, f, M, o, j, x =over 4 @@ -4168,25 +3856,25 @@ B AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, -bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy, -croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, -eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, -get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod, -gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, -G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, -HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, -hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, +bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv, +CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, +dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, +get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, +gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, +G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, +HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, +hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, -isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, -MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, -mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, -NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, -newSVrv, newSVsv, newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, -Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_construct, perl_destruct, -perl_free, perl_parse, perl_run, PL_DBsingle, PL_DBsub, PL_DBtrace, -PL_dowarn, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, -POPl, POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, +isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, +ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy, +mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, +Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, +newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, +newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, +perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, +PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, +POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, @@ -4196,7 +3884,7 @@ SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, -SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV, +SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, @@ -4207,15 +3895,16 @@ sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, -sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_true, -sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, sv_usepvn_mg, -sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_vcatpvfn, -sv_vsetpvfn, THIS, toLOWER, toUPPER, U8 *s, utf8_distance, utf8_hop, -utf8_length, utf8_to_bytes, utf8_to_uv, utf8_to_uv_simple, warn, XPUSHi, -XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, -XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, -XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, -XS_VERSION_BOOTCHECK, Zero +sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, +sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, +sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, +sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, +utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, +utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, +warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, +XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, +XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, +XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item AUTHORS @@ -4230,7 +3919,8 @@ XS_VERSION_BOOTCHECK, Zero =item DESCRIPTION -djSP, is_gv_magical, start_glob +djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, +PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob =item AUTHORS @@ -4238,6 +3928,67 @@ djSP, is_gv_magical, start_glob =back +=head2 perliol - C API for Perl's implementation of IO in Layers. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item History and Background + +=item Layers vs Disciplines + +=item Data Structures + +1. The functions and attributes of the "layer class", 2. The per-instance +data for a particular handle + +=item Functions and Attributes + +=item Per-instance Data + +=item Layers in action. + +=item Per-instance flag bits + +PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, +PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, +PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, +PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS + +=item Methods in Detail + + IV (*Pushed)(PerlIO *f,const char *mode, SV *arg);, IV + (*Popped)(PerlIO *f);, PerlIO * (*Open)(...);, SV * +(*Getarg)(PerlIO *f);, IV (*Fileno)(PerlIO *f);, SSize_t +(*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO +*f, const void *vbuf, Size_t count);, SSize_t (*Write)(PerlIO *f, const +void *vbuf, Size_t count);, IV (*Seek)(PerlIO *f, Off_t +offset, int whence);, Off_t (*Tell)(PerlIO *f);, IV + (*Close)(PerlIO *f);, IV (*Flush)(PerlIO *f);, IV + (*Fill)(PerlIO *f);, IV (*Eof)(PerlIO *f);, IV + (*Error)(PerlIO *f);, void (*Clearerr)(PerlIO *f);, void + (*Setlinebuf)(PerlIO *f);, STDCHAR * (*Get_base)(PerlIO *f);, +Size_t (*Get_bufsiz)(PerlIO *f);, STDCHAR * +(*Get_ptr)(PerlIO *f);, SSize_t (*Get_cnt)(PerlIO *f);, void + (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt); + +=item Core Layers + +"unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" + +=item Extension Layers + +":encoding", ":Scalar", ":Object" or ":Perl" + +=back + +=back + =head2 perlapio - perl's IO abstraction interface. =over 4 @@ -4246,27 +3997,36 @@ djSP, is_gv_magical, start_glob =item DESCRIPTION -B, B, B, B, -B, B, +1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B, +B, B, B, +B, B, B, B, B, B, B, B, B, B, B, B, B, B, B, -B, B, B, -B, B, B, -B, B +B, B, B, +B, B, B, +B, B, B =over 4 =item Co-existence with stdio B, B, -B, B, B, -B, B, B, -B, B, -B, B, B, -B, B +B, B + +=item "Fast gets" Functions + +B, B, B, +B, B, B, +B, B, B, +B + +=item Other Functions + +PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), +'E' read, 'E' write, '+' read/write, PerlIO_debug(fmt,...) =back @@ -4651,6 +4411,14 @@ finish, 'enter', print DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug +=item Compaq's/Digital's Third Degree + +=item PERL_DESTRUCT_LEVEL + +=item Pixie Profiling + +-h, -l, -p, -h, -i, -l, -testcoverage, -zero + =item CONCLUSION I @@ -4719,15 +4487,6 @@ I =item Performance Enhancements -sort() has been changed to use mergesort internally as opposed to the -earlier quicksort. For very small lists this may result in slightly slower -sorting times, but in general the speedup should be at least 20%. -Additional bonuses are that the worst case behaviour of sort() is now -better (in computer science terms it now runs in time O(N log N), as -opposed to quicksort's Theta(N**2) worst-case run time behaviour), and that -sort() is now stable (meaning that elements with identical keys will stay -ordered as they were before the sort) - =item Installation and Configuration Improvements =over 4 @@ -4738,9 +4497,6 @@ ordered as they were before the sort) =item Selected Bug Fixes -sort() arguments are now compiled in the right wantarray context (they were -accidentally using the context of the sort() itself) - =over 4 =item Platform Specific Changes and Fixes @@ -5111,13 +4867,12 @@ Format of $English::PERL_VERSION is different, Literals of the form C<1.2.3> parse differently, Possibly changed pseudo-random number generator, Hashing function for hash keys has changed, C fails on read only values, Close-on-exec bit may be set on pipe and socket handles, -Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), values() and -C<\(%h)> operate on aliases to values, not copies, vec(EXPR,OFFSET,BITS) -enforces powers-of-two BITS, Text of some diagnostic output has changed, -C<%@> has been removed, Parenthesized not() behaves like a list operator, -Semantics of bareword prototype C<(*)> have changed, Semantics of bit -operators may have changed on 64-bit platforms, More builtins taint their -results +Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), +values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, +Text of some diagnostic output has changed, C<%@> has been removed, +Parenthesized not() behaves like a list operator, Semantics of bareword +prototype C<(*)> have changed, Semantics of bit operators may have changed +on 64-bit platforms, More builtins taint their results =item C Source Incompatibilities @@ -5154,8 +4909,7 @@ gcc Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The pseudo-hash data type, The Compiler suite, Internal implementation of file -globbing, The DB module, The regular expression constructs C<(?{ code })> -and C<(??{ code })> +globbing, The DB module, The regular expression code constructs: =back @@ -5194,10 +4948,6 @@ to mean "${$}" is deprecated =item C Source Compatibility -Core sources now require ANSI C compiler, All Perl global variables must -now be referenced with an explicit prefix, Enabling threads has source -compatibility issues - =item Binary Compatibility =item Security fixes may affect compatibility @@ -5311,7 +5061,7 @@ Thread, attrs, fields, re =item Changes in existing modules Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, -MakeMaker, CPAN, Cwd, Benchmark +MakeMaker, CPAN, Cwd =back @@ -5335,9 +5085,9 @@ Eval-group not allowed at run time, Explicit blessing to '' (assuming package main), Illegal hex digit ignored, No such array field, No such field "%s" in variable %s of type %s, Out of memory during ridiculously large request, Range iterator outside integer range, Recursive inheritance -detected while looking for method '%s' in package '%s', Reference found -where even-sized list expected, Undefined value assigned to typeglob, Use -of reserved word "%s" is deprecated, perl: warning: Setting locale failed +detected while looking for method '%s' %s, Reference found where even-sized +list expected, Undefined value assigned to typeglob, Use of reserved word +"%s" is deprecated, perl: warning: Setting locale failed =item Obsolete Diagnostics @@ -5534,14 +5284,14 @@ possible typo, Null picture in formline, Offset outside string, Out of memory!, Out of memory during request for %s, panic: frexp, Possible attempt to put comments in qw() list, Possible attempt to separate words with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found -while resolving method `%s' overloading `%s' in package `%s', Too late for -"B<-T>" option, untie attempted while %d inner references still exist, -Unrecognized character %s, Unsupported function fork, Use of "$$" to -mean "${$}" is deprecated, Value of %s can be "0"; test with -defined(), Variable "%s" may be unavailable, Variable "%s" will not stay -shared, Warning: something's wrong, Ill-formed logical name |%s| in -prime_env_iter, Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, -PERL_SH_DIR too long, Process terminated by SIG%s +while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" +option, untie attempted while %d inner references still exist, Unrecognized +character %s, Unsupported function fork, Use of "$$" to mean +"${$}" is deprecated, Value of %s can be "0"; test with defined(), +Variable "%s" may be unavailable, Variable "%s" will not stay shared, +Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, +Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too +long, Process terminated by SIG%s =item BUGS @@ -5609,11 +5359,6 @@ B, B =item Shortcomings of Perl under AmigaOS -fork(), some features of the UNIX filesystem regarding link count and file -dates, inplace operation (the -i switch) without backup file, umask() -works, but the correct permissions are only set when the file is -finally close()d - =back =item INSTALLATION @@ -5656,6 +5401,50 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back +=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item gzip + +=item bison + +=item Unpacking + +=item Compiling + +=item Testing + +=item Install + +=item Using Perl in the Posix-Shell + +=item Using Perl in "native" BS2000 + +=item Floating point anomalies + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=item HISTORY + +=back + =head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 @@ -5741,6 +5530,50 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldos - Perl under DOS, W31, W95. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Prerequisites + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building + +=item Testing + +=item Installation + +=back + +=item BUILDING AND INSTALLING MODULES + +=over 4 + +=item Prerequisites + +=item Unpacking CPAN Modules + +=item Building Non-XS Modules + +=item Building XS Modules + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -5751,11 +5584,15 @@ Source, Compiled Module Source, Perl Modules/Scripts =item INSTALLING PERL ON EPOC +=item STARTING PERL ON EPOC + +=item STOPPING PERL ON EPOC + =item USING PERL ON EPOC =over 4 -=item IO Redirection +=item I/O Redirection =item PATH Names @@ -5847,6 +5684,44 @@ op/lexassign.t, pragma/warnings.t =back +=head2 perlmacos, README.macos - Perl under Mac OS (Classic) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item DATE + +=back + +=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE + +=head1 SYNOPSIS + +=over 4 + +=item What's New + +=item System Requirements + +=item How to Obtain Perl/iX + +=item Distribution Contents Highlights + +README, public_html/feedback.cgi, 4, 6 + +=item Getting Started with Perl/iX + +=item MPE/iX Implementation Considerations + +=item Change History + +=back + =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. =over 4 @@ -5879,6 +5754,8 @@ EMX, RSX, HPFS, pdksh =over 4 +=item "It does not work" + =item I cannot run external programs =item I cannot embed perl into my program, or use F from my @@ -5937,6 +5814,8 @@ Perl manual in F<.INF> format, Pdksh =over 4 +=item The short story + =item Prerequisites =item Getting perl source @@ -5950,7 +5829,7 @@ Perl manual in F<.INF> format, Pdksh =item Testing A lot of C, Process terminated by SIGTERM/SIGINT, F, -F, F, F, F +F =item Installing the built perl @@ -5997,13 +5876,29 @@ C, C, C, C, C, C, C, C, C, -C +C, +C, C, +OS2::SysInfo(), OS2::BootDrive(), C, +C, C, +C, C, +OS2::get_control87(), C + +=item Prebuilt variables: + +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver =item Misfeatures =item Modifications -C, C, C, C, C, C +C, C, C, C, C, C, C, +C + +=item Identifying DLLs + +=item Centralized management of resources + +C, C =back @@ -6025,8 +5920,6 @@ C, C, C, C, C, C =item Why chimera build? -explicit fork(), open FH, "|-", open FH, "-|" - =back =item ENVIRONMENT @@ -6099,8 +5992,12 @@ C, F =item testing anomalies +=item installation anomalies + =item Usage Hints +=item Floating point anomalies + =item Modules and Extensions =back @@ -6119,80 +6016,39 @@ C, F =back -=head2 perlposix-bc, README.posix-bc - building and installing Perl for -BS2000 POSIX. +=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems =over 4 -=item SYNOPSIS - =item DESCRIPTION =over 4 -=item gzip +=item Solaris Version Numbers. -=item bison +=back -=item Unpacking +=item RESOURCES -=item Compiling +Solaris FAQ, Precompiled Binaries, Solaris Documentation -=item Testing +=item SETTING UP -=item Install +=over 4 -=item Using Perl +=item File Extraction Problems. -=back +=item Compiler and Related Tools. -=item AUTHORS +=item Environment -=item SEE ALSO +=back + +=item RUN CONFIGURE. =over 4 -=item Mailing list - -=back - -=item HISTORY - -=back - -=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems - -=over 4 - -=item DESCRIPTION - -=over 4 - -=item Solaris Version Numbers. - -=back - -=item RESOURCES - -Solaris FAQ, Precompiled Binaries, Solaris Documentation - -=item SETTING UP - -=over 4 - -=item File Extraction Problems. - -=item Compiler and Related Tools. - -=item Environment - -=back - -=item RUN CONFIGURE. - -=over 4 - -=item 64-bit Issues. +=item 64-bit Issues. =item Threads. @@ -6244,6 +6100,51 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Unpacking + +=item Setup and utilities + +=item Configure + +Don't turn on the compiler optimization flag "-O". There's a bug in the +compiler (APAR PQ18812) that generates some bad code the optimizer is on, +As VM/ESA doesn't fully support the fork() API programs relying on this +call will not work. I've replaced fork()/exec() with spawn() and the +standalone exec() with spawn(). This has a side effect when opening unnamed +pipes in a shell script: there is no child process generated under + +=item testing anomalies + +=item Usage Hints + +When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII +character sets are different. Perl builtin functions that may behave +differently under EBCDIC are mentioned in the perlport.pod document. + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=back + =head2 perlvms - VMS-specific documentation for Perl =over 4 @@ -6357,6 +6258,48 @@ LIST, waitpid PID,FLAGS =back +=head2 perlwin32 - Perl under Win32 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Setting Up + +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC + +=item Building + +=item Testing + +=item Installation + +=item Usage Hints + +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Running Perl Scripts, Miscellaneous Things + +=back + +=item BUGS AND CAVEATS + +=item AUTHORS + +Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE + +=item SEE ALSO + +=item HISTORY + +=back + =head1 PRAGMA DOCUMENTATION =head2 attrs - set/get attributes of a subroutine (deprecated) @@ -6586,8 +6529,8 @@ new, phash =back -=head2 integer - Perl pragma to compute arithmetic in integer instead of -double +=head2 integer - Perl pragma to use integer arithmetic instead of floating +point =over 4 @@ -6650,7 +6593,9 @@ operations =item DESCRIPTION -=item UNIMPLEMENTED FUNCTIONALITY +=item NONPERLIO FUNCTIONALITY + +=item IMPLEMENTATION DETAILS =item SEE ALSO @@ -6767,26 +6712,6 @@ type, `%s' is not a code reference =back -=head2 perlio - perl pragma to configure C level IO - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -unix, stdio, perlio - -=over 4 - -=item Defaults and how to override them - -=back - -=item AUTHOR - -=back - =head2 re - Perl pragma to alter regular expression behaviour =over 4 @@ -6849,6 +6774,19 @@ C, C, C =back +=head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data +and non-UTF data. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 utf8 - Perl pragma to enable/disable UTF-8 in source code =over 4 @@ -6857,6 +6795,15 @@ C, C, C =item DESCRIPTION +=over 4 + +=item Utility functions + +$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), +utf8::encode($string), $flag = utf8::decode($string) + +=back + =item SEE ALSO =back @@ -6981,7 +6928,7 @@ REFCNT, FLAGS =item B::IV METHODS -IV, IVX, needs64bits, packiv +IV, IVX, UVX, int_value, needs64bits, packiv =item B::NV METHODS @@ -6993,7 +6940,7 @@ RV =item B::PV METHODS -PV +PV, PVX =item B::PVMG METHODS @@ -7013,8 +6960,8 @@ USEFUL, PREVIOUS, RARE, TABLE =item B::GV METHODS -is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE, -FILEGV, GvREFCNT, FLAGS +is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, +LINE, FILE, FILEGV, GvREFCNT, FLAGS =item B::IO METHODS @@ -7142,8 +7089,7 @@ bytecode B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -7210,6 +7156,45 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> =back +=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OPTIONS + +B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, +B<-main>, B<-base>I, B<-bigendian>, B<-littleendian>, B<-concise>, +B<-terse>, B<-linenoise>, B<-debug>, B<-env> + +=item FORMATTING SPECIFICATIONS + +B<(x(>IB<;>IB<)x)>, B<(*(>IB<)*)>, +B<(*(>IB<;>IB<)*)>, B<(?(>IB<#>IIB<)?)>, +B<#>I, B<#>II, B<~>, B<#addr>, B<#arg>, B<#class>, +B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, +B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>, +B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, +B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, +B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> + +=item ABBREVIATIONS + +=over 4 + +=item OP flags abbreviations + +=item OP class abbreviations + +=back + +=item AUTHOR + +=back + =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops =over 4 @@ -7233,7 +7218,7 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> =item OPTIONS B<-l>, B<-p>, B<-q>, B<-u>I, B<-s>I, B, BI, -B, BIB<.> +B, BIB<.>, B<-x>I =item USING B::Deparse AS A MODULE @@ -7444,8 +7429,7 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -7471,10 +7455,6 @@ output. =back =item CALLING CGI.PM ROUTINES -1. Use another name for the argument, if one is available. For example, --value is an alias for -values, 2. Change the capitalization, e.g. -Values, -3. Put quotes around the argument name, e.g. '-values' - =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE @@ -7621,8 +7601,7 @@ B =item CREATING A CLICKABLE IMAGE BUTTON -B, 3. The third option (-align, optional) is an alignment -type, and may be TOP, BOTTOM or MIDDLE +B =item CREATING A JAVASCRIPT ACTION BUTTON @@ -7652,20 +7631,19 @@ the

tag =item FETCHING ENVIRONMENT VARIABLES B, B, B, B, -B, B, B Return the script -name as a partial URL, for self-refering scripts, B, B, B, B, B, +B, B, B, B, +B, B, B, B, B, B, B, B, B, B, B =item USING NPH SCRIPTS In the B statement, By calling the B method:, By using B<-nph> -parameters in the B and B statements: +parameters =item Server Push -multipart_init(), multipart_start(), multipart_end() +multipart_init(), multipart_start(), multipart_end(), multipart_final() =item Avoiding Denial of Service Attacks @@ -7840,7 +7818,7 @@ B, B, B, B, B =item USING CGI::Push --next_page, -last_page, -type, -delay, -cookie, -target, -expires +-next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph =over 4 @@ -7878,6 +7856,20 @@ B, B, B, B, B =back +=head2 CGI::Util - Internal utilities used by CGI module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR INFORMATION + +=item SEE ALSO + +=back + =head2 CPAN - query, download and build perl modules from CPAN sites =over 4 @@ -7892,7 +7884,7 @@ B, B, B, B, B Searching for authors, bundles, distribution files and modules, make, test, install, clean modules or distributions, get, readme, look module or -distribution, Signals +distribution, ls author, Signals =item CPAN::Shell @@ -7984,25 +7976,14 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade =item FAQ -1) I installed a new version of module X but CPAN keeps saying, I -have the old version installed, 2) So why is UNINST=1 not the default?, 3) -I want to clean up my mess, and install a new perl along with all -modules I have. How do I go about it?, 4) When I install bundles or -multiple modules with one command there is too much output to keep -track of, 5) I am not root, how can I install a module in a personal -directory?, 6) How to get a package, unwrap it, and make a change before - building it?, 7) I installed a Bundle and had a couple of fails. When I - retried, everything resolved nicely. Can this be fixed to work -on first try?, 8) In our intranet we have many modules for internal use. -How can I integrate these modules with CPAN.pm but without uploading - the modules to CPAN?, 9) When I run CPAN's shell, I get error msg -about line 1 to 4, setting meta input/output via the /etc/inputrc -file, 10) Some authors have strange characters in their names +1), 2), 3), 4), 5), 6), 7), 8), 9), 10) =item BUGS =item AUTHOR +=item TRANSLATIONS + =item SEE ALSO =back @@ -8048,6 +8029,30 @@ module =back +=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside + +=head2 Class::ISA -- report the search path for a class's ISA tree + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +the function Class::ISA::super_path($CLASS), the function +Class::ISA::self_and_super_path($CLASS), the function +Class::ISA::self_and_super_versions($CLASS) + +=item CAUTIONARY NOTES + +=item COPYRIGHT + +=item AUTHOR + +=back + =head2 Class::Struct - declare struct-like datatypes as Perl classes =over 4 @@ -8131,69 +8136,72 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C @@ -8305,17 +8313,17 @@ C, C, C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, 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 @@ -8344,6 +8352,10 @@ C, C, C, C, C C, C +=item y + +C, C + =item z C, C @@ -8354,7 +8366,7 @@ C, C =back -=head2 Cwd, getcwd - get pathname of current working directory +=head2 Cwd - get pathname of current working directory =over 4 @@ -8669,6 +8681,55 @@ Dumper =back +=head2 Digest:: - Modules that calculate message digests + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +I, I, I + +=item OO INTERFACE + +$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = +Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), +$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Digest::MD5 - Perl interface to the MD5 Algorithm + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS + +md5($data,...), md5_hex($data,...), md5_base64($data,...) + +=item METHODS + +$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), +$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest + +=item EXAMPLES + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHORS + +=back + =head2 DirHandle - supply object methods for directory handles =over 4 @@ -8740,30 +8801,98 @@ Perl code =over 4 +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + =item TERMINOLOGY -=item bytes +=back + +=item ENCODINGS + +=over 4 -=item chars +=item Characteristics of an Encoding -=item chars With Encoding +=item Types of Encodings -=item Testing For UTF-8 +Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, +Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings -=item Toggling UTF-8-ness +=item Specifying Encodings -=item UTF-16 and UTF-32 Encodings +1. By name, 2. As an object -=item Handling Malformed Data +=item Encoding Names + +The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry, +The name used by the the organization that defined it =back -=head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables -of the Encode extension +=item PERL ENCODING API =over 4 -=item DESCRIPTION +=item Generic Encoding Interface + +=item Handling Malformed Data + +Scheme 1, Scheme 2, Other Schemes + +=item UTF-8 / utf8 + +=item Other Encodings of Unicode + +=item Listing available encodings + +=item Defining Aliases + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=item Defining Encodings + +=back + +=item Encoding and IO + +=item Encoding How to ... + +IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 +strings in binary data, perl/Encode wrappers on non-Unicode XS modules + +=item Messing with Perl's Internals + +is_utf8(STRING [, CHECK]), valid_utf8(STRING) + +=item IMPLEMENTATION CLASSES + +-Ename, -Enew_sequence, -Eencode($string,$check), +-Edecode($octets,$check) + +=over 4 + +=item Compiled Encodings + +.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 + +=back + +=item SEE ALSO + +=back + +=head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables +of the Encode extension + +=over 4 + +=item DESCRIPTION [1] B, [2] B, [3] B, [4] B @@ -8773,6 +8902,8 @@ of the Encode extension =back +=head2 Encode::Tcl - Tcl encodings + =head2 EncodeFormat - the format of encoding tables of the Encode extension =over 4 @@ -9020,8 +9151,12 @@ ExtUtils::MakeMaker =item DESCRIPTION +=item METHODS + =back +perl_archive_after + =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -9220,6 +9355,8 @@ xs_o (o) perl_archive +perl_archive_after + export_list =over 4 @@ -9434,9 +9571,9 @@ INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX, -PL_FILES, PM, PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, -PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, -XSPROTOARG, XS_VERSION +PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, +PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, +VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -9698,7 +9835,8 @@ C, C =item DESCRIPTION C, C, C, C, C, -C, C, C, C, C +C, C, C, C, C, +C =item DIAGNOSTICS @@ -10146,6 +10284,8 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =over 4 +=item SYNOPSIS + =item DESCRIPTION =over 4 @@ -10174,6 +10314,8 @@ B<$_>, B<$status>, B and B, B =back +=item Filter::Simple + =item AUTHOR =item DATE @@ -10468,6 +10610,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10512,8 +10656,8 @@ new ( [ARGS] ) =item METHODS -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), -sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) =item SEE ALSO @@ -10706,6 +10850,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10752,145 +10898,386 @@ new ( [ARGS] ) =item METHODS -accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), -sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for +AF_INET domain sockets + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=over 4 + +=item METHODS + +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for +AF_UNIX domain sockets + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IPC::Msg - SysV Msg IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IPC::Open2, open2 - open a process for both reading and writing + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item WARNING + +=item SEE ALSO + +=back + +=head2 IPC::Open3, open3 - open a process for reading, writing, and error +handling + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item WARNING + +=back + +=head2 IPC::Semaphore - SysV Semaphore IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IPC::SysV - SysV IPC constants + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +ftok( PATH, ID ) + +=item SEE ALSO + +=item AUTHORS + +=item COPYRIGHT + +=back + +=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat =item SEE ALSO =item AUTHOR -=item COPYRIGHT +=item COPYRIGHT + +=back + +=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object +class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Constants - constants for Locale codes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Language, Locale::Country, Locale::Currency + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Country - ISO codes for country identification (ISO 3166) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +B, B, B + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) =back -=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for -AF_INET domain sockets - =over 4 -=item SYNOPSIS +=item QUERY ROUTINES -=item DESCRIPTION +C, C -=item CONSTRUCTOR +=back -new ( [ARGS] ) +=over 4 + +=item CODE ALIASING + +=back =over 4 -=item METHODS +=item EXAMPLES -sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost -() +=item DOMAIN NAMES -=back +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Language, Locale::Currency, ISO 3166, +http://www.din.de/gremien/nas/nabd/iso3166ma/, +http://www.egt.ie/standards/iso3166/iso3166-1-en.html, +http://www.cia.gov/cia/publications/factbook/docs/app-f.html + =item AUTHOR =item COPYRIGHT =back -=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for -AF_UNIX domain sockets +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) =over 4 =item SYNOPSIS -=item DESCRIPTION +=back -=item CONSTRUCTOR +=over 4 -new ( [ARGS] ) +=item DESCRIPTION -=item METHODS +XTS, XXX -hostpath(), peerpath() +=back -=item SEE ALSO +=over 4 -=item AUTHOR +=item CONVERSION ROUTINES -=item COPYRIGHT +code2currency(), currency2code() =back -=head2 IPC::Msg - SysV Msg IPC object class - =over 4 -=item SYNOPSIS +=item QUERY ROUTINES -=item DESCRIPTION +C, C -=item METHODS +=back -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency + =item AUTHOR =item COPYRIGHT =back -=head2 IPC::Open2, open2 - open a process for both reading and writing +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) =over 4 =item SYNOPSIS -=item DESCRIPTION +=back -=item WARNING +=over 4 -=item SEE ALSO +=item DESCRIPTION =back -=head2 IPC::Open3, open3 - open a process for reading, writing, and error -handling - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item CONVERSION ROUTINES -=item WARNING +code2language(), language2code() =back -=head2 IPC::Semaphore - SysV Semaphore IPC object class - =over 4 -=item SYNOPSIS +=item QUERY ROUTINES -=item DESCRIPTION +C, C -=item METHODS +=back -new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), -getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), -set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N -, VALUE ), stat +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS =item SEE ALSO +Locale::Country, Locale::Currency, ISO 639:1988 (E/F), +http://lcweb.loc.gov/standards/iso639-2/langhome.html + =item AUTHOR =item COPYRIGHT =back -=head2 IPC::SysV - SysV IPC constants +=head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -10898,17 +11285,20 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =item DESCRIPTION -ftok( PATH, ID ) +encode_base64($str, [$eol]), decode_base64($str) -=item SEE ALSO +=item DIAGNOSTICS -=item AUTHORS +Premature end of base64 data, Premature padding of base64 data + +=item EXAMPLES =item COPYRIGHT =back -=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings =over 4 @@ -10916,22 +11306,14 @@ ftok( PATH, ID ) =item DESCRIPTION -=item METHODS - -new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set -( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, -FLAGS ] ), stat - -=item SEE ALSO - -=item AUTHOR +encode_qp($str), decode_qp($str); =item COPYRIGHT =back -=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object -class +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings =over 4 @@ -10939,16 +11321,7 @@ class =item DESCRIPTION -=item METHODS - -new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), -getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), -set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N -, VALUE ), stat - -=item SEE ALSO - -=item AUTHOR +encode_qp($str), decode_qp($str); =item COPYRIGHT @@ -11059,10 +11432,16 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =back -=item GREAT CIRCLE DISTANCES +=item GREAT CIRCLE DISTANCES AND DIRECTIONS =item EXAMPLES +=over 4 + +=item CAVEAT FOR GREAT CIRCLE FORMULAS + +=back + =item BUGS =item AUTHORS @@ -11075,6 +11454,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11106,8 +11487,6 @@ $timeout]);, $p->close();, pingecho($host [, $timeout]); =back -=item WARNING - =item NOTES =back @@ -11200,6 +11579,8 @@ functions =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11435,6 +11816,57 @@ Constants, Macros =back +=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* +name space + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +unix, stdio, perlio, crlf, utf8, raw + +=over 4 + +=item Defaults and how to override them + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 PerlIO::Scalar - support module for in-memory IO. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]), +$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), +$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), +$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), +$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), +$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), +$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) + +=back + =head2 Pod::Checker, podchecker() - check pod documents for syntax errors =over 4 @@ -11472,18 +11904,16 @@ after =back =item Warnings multiple occurence of link target I, line containing nothing but -whitespace in paragraph, file does not start with =head, No numeric -argument for =over, previous =item has no contents, preceding non-item -paragraph(s), =item type mismatch (I vs. I), I unescaped -CE> in paragraph, Unknown entity, No items in =over, No argument -for =item, empty section in previous paragraph, Verbatim paragraph in NAME -section +whitespace in paragraph, file does not start with =head, previous =item has +no contents, preceding non-item paragraph(s), =item type mismatch (I +vs. I), I unescaped CE> in paragraph, Unknown entity, No +items in =over, No argument for =item, empty section in previous paragraph, +Verbatim paragraph in NAME section =item Hyperlinks -collapsing newlines to blanks, ignoring leading/trailing whitespace in -link, (section) in '$page' deprecated, alternative text/node '%s' contains -non-escaped | or / +ignoring leading/trailing whitespace in link, (section) in '$page' +deprecated, alternative text/node '%s' contains non-escaped | or / =back @@ -12476,6 +12906,23 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: =back +=head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike +text + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII text with format escapes @@ -12713,6 +13160,38 @@ C =back +=head2 Switch - A switch statement for Perl + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item BACKGROUND + +=item DESCRIPTION + +=over 4 + +=item Allowing fall-through + +=item Automating fall-through + +=item Higher-order Operations + +=back + +=item DEPENDENCIES + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT + +=back + =head2 Symbol - manipulate Perl symbols and their names =over 4 @@ -12851,9 +13330,11 @@ C, C, C =item ENVIRONMENT +=item CAVEATS + =back -=head2 Test - provides a simple framework for writing test scripts +=head2 Test - provides a simple framework for writing test scripts =over 4 @@ -12887,6 +13368,10 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item The test script output +B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, +B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, +B, B, B + =back =item EXPORT @@ -12900,6 +13385,10 @@ C, C, C, C, +C, C, C, +C + =item SEE ALSO =item AUTHORS @@ -12920,6 +13409,75 @@ C, C + +=item C + +=item C + +C $listref>, C $listref>, C $str>, +[0], [1], [2], [3], [4], [5] + +=item C + +=item C + +[0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] + +=item C and "here documents" + +[0], [1], [2], [3], [4], [5], [6], [7..10] + +=item C + +=item C + +=item C + +=back + +=item DIAGNOSTICS + + C, C, +C, C, C, +C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, C, C + +=item AUTHOR + +=item BUGS AND IRRITATIONS + +=item COPYRIGHT + +=back + =head2 Text::ParseWords - parse text into an array of tokens or array of arrays @@ -12931,12 +13489,6 @@ arrays =item EXAMPLES -0 a simple word, 1 multiple spaces are skipped because of our $delim, 2 use -of quotes to include a space in a word, 3 use of a backslash to include a -space in a word, 4 use of a backslash to remove the special meaning of a -double-quote, 5 another simple word (note the lack of effect of the -backslashed double-quote) - =item AUTHORS =back @@ -13292,11 +13844,10 @@ Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, -PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown(MACHINE, -MESSAGE, TIMEOUT, FORCECLOSE, REBOOT), Win32::IsWinNT(), Win32::IsWin95(), -Win32::LoadLibrary(LIBNAME), Win32::LoginName(), -Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE), -Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), +PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, +Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), +Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, +SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, @@ -13306,6 +13857,24 @@ PID), 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