Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | |
2 | =head1 NAME | |
3 | ||
4 | perltoc - perl documentation table of contents | |
5 | ||
6 | =head1 DESCRIPTION | |
7 | ||
8 | This page provides a brief table of contents for the rest of the Perl | |
9 | documentation set. It is meant to be scanned quickly or grepped | |
10 | through to locate the proper section you're looking for. | |
11 | ||
12 | =head1 BASIC DOCUMENTATION | |
13 | ||
14 | =head2 perl - Practical Extraction and Report Language | |
15 | ||
16 | =over 4 | |
17 | ||
18 | =item SYNOPSIS | |
19 | ||
20 | =over 4 | |
21 | ||
22 | =item Overview | |
23 | ||
24 | =item Tutorials | |
25 | ||
26 | =item Reference Manual | |
27 | ||
28 | =item Internals and C Language Interface | |
29 | ||
30 | =item Miscellaneous | |
31 | ||
32 | =item Language-Specific | |
33 | ||
34 | =item Platform-Specific | |
35 | ||
36 | =back | |
37 | ||
38 | =item DESCRIPTION | |
39 | ||
40 | =item AVAILABILITY | |
41 | ||
42 | =item ENVIRONMENT | |
43 | ||
44 | =item AUTHOR | |
45 | ||
46 | =item FILES | |
47 | ||
48 | =item SEE ALSO | |
49 | ||
50 | =item DIAGNOSTICS | |
51 | ||
52 | =item BUGS | |
53 | ||
54 | =item NOTES | |
55 | ||
56 | =back | |
57 | ||
58 | =head2 perlintro -- a brief introduction and overview of Perl | |
59 | ||
60 | =over 4 | |
61 | ||
62 | =item DESCRIPTION | |
63 | ||
64 | =over 4 | |
65 | ||
66 | =item What is Perl? | |
67 | ||
68 | =item Running Perl programs | |
69 | ||
70 | =item Basic syntax overview | |
71 | ||
72 | =item Perl variable types | |
73 | ||
74 | Scalars, Arrays, Hashes | |
75 | ||
76 | =item Variable scoping | |
77 | ||
78 | =item Conditional and looping constructs | |
79 | ||
80 | if, while, for, foreach | |
81 | ||
82 | =item Builtin operators and functions | |
83 | ||
84 | Arithmetic, Numeric comparison, String comparison, Boolean logic, | |
85 | Miscellaneous | |
86 | ||
87 | =item Files and I/O | |
88 | ||
89 | =item Regular expressions | |
90 | ||
91 | Simple matching, Simple substitution, More complex regular expressions, | |
92 | Parentheses for capturing, Other regexp features | |
93 | ||
94 | =item Writing subroutines | |
95 | ||
96 | =item OO Perl | |
97 | ||
98 | =item Using Perl modules | |
99 | ||
100 | =back | |
101 | ||
102 | =item AUTHOR | |
103 | ||
104 | =back | |
105 | ||
106 | =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11 | |
107 | 21:32:23 $) | |
108 | ||
109 | =over 4 | |
110 | ||
111 | =item DESCRIPTION | |
112 | ||
113 | =over 4 | |
114 | ||
115 | =item perlfaq: Structural overview of the FAQ. | |
116 | ||
117 | =item L<perlfaq1>: General Questions About Perl | |
118 | ||
119 | =item L<perlfaq2>: Obtaining and Learning about Perl | |
120 | ||
121 | =item L<perlfaq3>: Programming Tools | |
122 | ||
123 | =item L<perlfaq4>: Data Manipulation | |
124 | ||
125 | =item L<perlfaq5>: Files and Formats | |
126 | ||
127 | =item L<perlfaq6>: Regular Expressions | |
128 | ||
129 | =item L<perlfaq7>: General Perl Language Issues | |
130 | ||
131 | =item L<perlfaq8>: System Interaction | |
132 | ||
133 | =item L<perlfaq9>: Networking | |
134 | ||
135 | =back | |
136 | ||
137 | =item About the perlfaq documents | |
138 | ||
139 | =over 4 | |
140 | ||
141 | =item Where to get the perlfaq | |
142 | ||
143 | =item How to contribute to the perlfaq | |
144 | ||
145 | =item What will happen if you mail your Perl programming problems to the | |
146 | authors | |
147 | ||
148 | =back | |
149 | ||
150 | =item Credits | |
151 | ||
152 | =item Author and Copyright Information | |
153 | ||
154 | =over 4 | |
155 | ||
156 | =item Bundled Distributions | |
157 | ||
158 | =item Disclaimer | |
159 | ||
160 | =back | |
161 | ||
162 | =item Changes | |
163 | ||
164 | 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, | |
165 | 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, | |
166 | Initial Release: 11/March/97 | |
167 | ||
168 | =back | |
169 | ||
170 | =head2 perlbook - Perl book information | |
171 | ||
172 | =over 4 | |
173 | ||
174 | =item DESCRIPTION | |
175 | ||
176 | =back | |
177 | ||
178 | =head2 perlsyn - Perl syntax | |
179 | ||
180 | =over 4 | |
181 | ||
182 | =item DESCRIPTION | |
183 | ||
184 | =over 4 | |
185 | ||
186 | =item Declarations | |
187 | ||
188 | =item Simple statements | |
189 | ||
190 | =item Compound statements | |
191 | ||
192 | =item Loop Control | |
193 | ||
194 | =item For Loops | |
195 | ||
196 | =item Foreach Loops | |
197 | ||
198 | =item Basic BLOCKs and Switch Statements | |
199 | ||
200 | =item Goto | |
201 | ||
202 | =item PODs: Embedded Documentation | |
203 | ||
204 | =item Plain Old Comments (Not!) | |
205 | ||
206 | =back | |
207 | ||
208 | =back | |
209 | ||
210 | =head2 perldata - Perl data types | |
211 | ||
212 | =over 4 | |
213 | ||
214 | =item DESCRIPTION | |
215 | ||
216 | =over 4 | |
217 | ||
218 | =item Variable names | |
219 | ||
220 | =item Context | |
221 | ||
222 | =item Scalar values | |
223 | ||
224 | =item Scalar value constructors | |
225 | ||
226 | =item List value constructors | |
227 | ||
228 | =item Slices | |
229 | ||
230 | =item Typeglobs and Filehandles | |
231 | ||
232 | =back | |
233 | ||
234 | =item SEE ALSO | |
235 | ||
236 | =back | |
237 | ||
238 | =head2 perlop - Perl operators and precedence | |
239 | ||
240 | =over 4 | |
241 | ||
242 | =item SYNOPSIS | |
243 | ||
244 | =item DESCRIPTION | |
245 | ||
246 | =over 4 | |
247 | ||
248 | =item Terms and List Operators (Leftward) | |
249 | ||
250 | =item The Arrow Operator | |
251 | ||
252 | =item Auto-increment and Auto-decrement | |
253 | ||
254 | =item Exponentiation | |
255 | ||
256 | =item Symbolic Unary Operators | |
257 | ||
258 | =item Binding Operators | |
259 | ||
260 | =item Multiplicative Operators | |
261 | ||
262 | =item Additive Operators | |
263 | ||
264 | =item Shift Operators | |
265 | ||
266 | =item Named Unary Operators | |
267 | ||
268 | =item Relational Operators | |
269 | ||
270 | =item Equality Operators | |
271 | ||
272 | =item Bitwise And | |
273 | ||
274 | =item Bitwise Or and Exclusive Or | |
275 | ||
276 | =item C-style Logical And | |
277 | ||
278 | =item C-style Logical Or | |
279 | ||
280 | =item Range Operators | |
281 | ||
282 | =item Conditional Operator | |
283 | ||
284 | =item Assignment Operators | |
285 | ||
286 | =item Comma Operator | |
287 | ||
288 | =item List Operators (Rightward) | |
289 | ||
290 | =item Logical Not | |
291 | ||
292 | =item Logical And | |
293 | ||
294 | =item Logical or and Exclusive Or | |
295 | ||
296 | =item C Operators Missing From Perl | |
297 | ||
298 | unary &, unary *, (TYPE) | |
299 | ||
300 | =item Quote and Quote-like Operators | |
301 | ||
302 | =item Regexp Quote-Like Operators | |
303 | ||
304 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, | |
305 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, | |
306 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, | |
307 | y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF | |
308 | ||
309 | =item Gory details of parsing quoted constructs | |
310 | ||
311 | Finding the end, Removal of backslashes before delimiters, Interpolation, | |
312 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
313 | C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, | |
314 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
315 | regular expressions | |
316 | ||
317 | =item I/O Operators | |
318 | ||
319 | =item Constant Folding | |
320 | ||
321 | =item Bitwise String Operators | |
322 | ||
323 | =item Integer Arithmetic | |
324 | ||
325 | =item Floating-point Arithmetic | |
326 | ||
327 | =item Bigger Numbers | |
328 | ||
329 | =back | |
330 | ||
331 | =back | |
332 | ||
333 | =head2 perlsub - Perl subroutines | |
334 | ||
335 | =over 4 | |
336 | ||
337 | =item SYNOPSIS | |
338 | ||
339 | =item DESCRIPTION | |
340 | ||
341 | =over 4 | |
342 | ||
343 | =item Private Variables via my() | |
344 | ||
345 | =item Persistent Private Variables | |
346 | ||
347 | =item Temporary Values via local() | |
348 | ||
349 | =item Lvalue subroutines | |
350 | ||
351 | Lvalue subroutines are EXPERIMENTAL | |
352 | ||
353 | =item Passing Symbol Table Entries (typeglobs) | |
354 | ||
355 | =item When to Still Use local() | |
356 | ||
357 | =item Pass by Reference | |
358 | ||
359 | =item Prototypes | |
360 | ||
361 | =item Constant Functions | |
362 | ||
363 | =item Overriding Built-in Functions | |
364 | ||
365 | =item Autoloading | |
366 | ||
367 | =item Subroutine Attributes | |
368 | ||
369 | =back | |
370 | ||
371 | =item SEE ALSO | |
372 | ||
373 | =back | |
374 | ||
375 | =head2 perlfunc - Perl builtin functions | |
376 | ||
377 | =over 4 | |
378 | ||
379 | =item DESCRIPTION | |
380 | ||
381 | =over 4 | |
382 | ||
383 | =item Perl Functions by Category | |
384 | ||
385 | Functions for SCALARs or strings, Regular expressions and pattern matching, | |
386 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
387 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
388 | length data or records, Functions for filehandles, files, or directories, | |
389 | Keywords related to the control flow of your perl program, Keywords related | |
390 | to scoping, Miscellaneous functions, Functions for processes and process | |
391 | groups, Keywords related to perl modules, Keywords related to classes and | |
392 | object-orientedness, Low-level socket functions, System V interprocess | |
393 | communication functions, Fetching user and group info, Fetching network | |
394 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
395 | in perl5 | |
396 | ||
397 | =item Portability | |
398 | ||
399 | =item Alphabetical Listing of Perl Functions | |
400 | ||
401 | I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept | |
402 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, | |
403 | binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless | |
404 | REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp( | |
405 | LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER, | |
406 | chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, | |
407 | connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, | |
408 | dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete | |
409 | EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, | |
410 | each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, | |
411 | exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl | |
412 | FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, | |
413 | fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, | |
414 | getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam | |
415 | NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname | |
416 | NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr | |
417 | ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
418 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
419 | getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent | |
420 | STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, | |
421 | endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, | |
422 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, | |
423 | goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, | |
424 | import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl | |
425 | FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, | |
426 | last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, | |
427 | link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, | |
428 | lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map | |
429 | EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget | |
430 | KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my | |
431 | TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no | |
432 | Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct | |
433 | EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open | |
434 | FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, | |
435 | opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : | |
436 | ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE, | |
437 | package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, | |
438 | print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, | |
439 | printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, | |
440 | qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, | |
441 | rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read | |
442 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, | |
443 | readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, | |
444 | ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, | |
445 | require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir | |
446 | DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, | |
447 | rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir | |
448 | DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, | |
449 | semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
450 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority | |
451 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
452 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
453 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
454 | EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair | |
455 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, | |
456 | sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, | |
457 | splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split | |
458 | /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format | |
459 | parameter index, flags, vector flag, (minimum) width, precision, or maximum | |
460 | width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat | |
461 | FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME | |
462 | (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, | |
463 | substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr | |
464 | EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
465 | FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread | |
466 | FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
467 | FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite | |
468 | FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, | |
469 | syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie | |
470 | VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate | |
471 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, | |
472 | ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack | |
473 | TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST, | |
474 | use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST, | |
475 | values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn | |
476 | LIST, write FILEHANDLE, write EXPR, write, y/// | |
477 | ||
478 | =back | |
479 | ||
480 | =back | |
481 | ||
482 | =head2 perlreftut - Mark's very short tutorial about references | |
483 | ||
484 | =over 4 | |
485 | ||
486 | =item DESCRIPTION | |
487 | ||
488 | =item Who Needs Complicated Data Structures? | |
489 | ||
490 | =item The Solution | |
491 | ||
492 | =item Syntax | |
493 | ||
494 | =over 4 | |
495 | ||
496 | =item Making References | |
497 | ||
498 | =item Using References | |
499 | ||
500 | =back | |
501 | ||
502 | =item An Example | |
503 | ||
504 | =item Arrow Rule | |
505 | ||
506 | =item Solution | |
507 | ||
508 | =item The Rest | |
509 | ||
510 | =item Summary | |
511 | ||
512 | =item Credits | |
513 | ||
514 | =over 4 | |
515 | ||
516 | =item Distribution Conditions | |
517 | ||
518 | =back | |
519 | ||
520 | =back | |
521 | ||
522 | =head2 perldsc - Perl Data Structures Cookbook | |
523 | ||
524 | =over 4 | |
525 | ||
526 | =item DESCRIPTION | |
527 | ||
528 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, | |
529 | more elaborate constructs | |
530 | ||
531 | =item REFERENCES | |
532 | ||
533 | =item COMMON MISTAKES | |
534 | ||
535 | =item CAVEAT ON PRECEDENCE | |
536 | ||
537 | =item WHY YOU SHOULD ALWAYS C<use strict> | |
538 | ||
539 | =item DEBUGGING | |
540 | ||
541 | =item CODE EXAMPLES | |
542 | ||
543 | =item ARRAYS OF ARRAYS | |
544 | ||
545 | =over 4 | |
546 | ||
547 | =item Declaration of an ARRAY OF ARRAYS | |
548 | ||
549 | =item Generation of an ARRAY OF ARRAYS | |
550 | ||
551 | =item Access and Printing of an ARRAY OF ARRAYS | |
552 | ||
553 | =back | |
554 | ||
555 | =item HASHES OF ARRAYS | |
556 | ||
557 | =over 4 | |
558 | ||
559 | =item Declaration of a HASH OF ARRAYS | |
560 | ||
561 | =item Generation of a HASH OF ARRAYS | |
562 | ||
563 | =item Access and Printing of a HASH OF ARRAYS | |
564 | ||
565 | =back | |
566 | ||
567 | =item ARRAYS OF HASHES | |
568 | ||
569 | =over 4 | |
570 | ||
571 | =item Declaration of an ARRAY OF HASHES | |
572 | ||
573 | =item Generation of an ARRAY OF HASHES | |
574 | ||
575 | =item Access and Printing of an ARRAY OF HASHES | |
576 | ||
577 | =back | |
578 | ||
579 | =item HASHES OF HASHES | |
580 | ||
581 | =over 4 | |
582 | ||
583 | =item Declaration of a HASH OF HASHES | |
584 | ||
585 | =item Generation of a HASH OF HASHES | |
586 | ||
587 | =item Access and Printing of a HASH OF HASHES | |
588 | ||
589 | =back | |
590 | ||
591 | =item MORE ELABORATE RECORDS | |
592 | ||
593 | =over 4 | |
594 | ||
595 | =item Declaration of MORE ELABORATE RECORDS | |
596 | ||
597 | =item Declaration of a HASH OF COMPLEX RECORDS | |
598 | ||
599 | =item Generation of a HASH OF COMPLEX RECORDS | |
600 | ||
601 | =back | |
602 | ||
603 | =item Database Ties | |
604 | ||
605 | =item SEE ALSO | |
606 | ||
607 | =item AUTHOR | |
608 | ||
609 | =back | |
610 | ||
611 | =head2 perlrequick - Perl regular expressions quick start | |
612 | ||
613 | =over 4 | |
614 | ||
615 | =item DESCRIPTION | |
616 | ||
617 | =item The Guide | |
618 | ||
619 | =over 4 | |
620 | ||
621 | =item Simple word matching | |
622 | ||
623 | =item Using character classes | |
624 | ||
625 | =item Matching this or that | |
626 | ||
627 | =item Grouping things and hierarchical matching | |
628 | ||
629 | =item Extracting matches | |
630 | ||
631 | =item Matching repetitions | |
632 | ||
633 | =item More matching | |
634 | ||
635 | =item Search and replace | |
636 | ||
637 | =item The split operator | |
638 | ||
639 | =back | |
640 | ||
641 | =item BUGS | |
642 | ||
643 | =item SEE ALSO | |
644 | ||
645 | =item AUTHOR AND COPYRIGHT | |
646 | ||
647 | =over 4 | |
648 | ||
649 | =item Acknowledgments | |
650 | ||
651 | =back | |
652 | ||
653 | =back | |
654 | ||
655 | =head2 perlpod - the Plain Old Documentation format | |
656 | ||
657 | =over 4 | |
658 | ||
659 | =item DESCRIPTION | |
660 | ||
661 | =over 4 | |
662 | ||
663 | =item Ordinary Paragraph | |
664 | ||
665 | =item Verbatim Paragraph | |
666 | ||
667 | =item Command Paragraph | |
668 | ||
669 | C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading | |
670 | Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item | |
671 | I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end | |
672 | I<formatname>>, C<=for I<formatname> I<text...>> | |
673 | ||
674 | =item Formatting Codes | |
675 | ||
676 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, | |
677 | C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink, | |
678 | C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used | |
679 | for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces, | |
680 | C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null | |
681 | (zero-effect) formatting code | |
682 | ||
683 | =item The Intent | |
684 | ||
685 | =item Embedding Pods in Perl Modules | |
686 | ||
687 | =item Hints for Writing Pod | |
688 | ||
689 | =back | |
690 | ||
691 | =item SEE ALSO | |
692 | ||
693 | =item AUTHOR | |
694 | ||
695 | =back | |
696 | ||
697 | =head2 perlpodspec - Plain Old Documentation: format specification and | |
698 | notes | |
699 | ||
700 | =over 4 | |
701 | ||
702 | =item DESCRIPTION | |
703 | ||
704 | =item Pod Definitions | |
705 | ||
706 | =item Pod Commands | |
707 | ||
708 | "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", | |
709 | "=back", "=begin formatname", "=end formatname", "=for formatname text..." | |
710 | ||
711 | =item Pod Formatting Codes | |
712 | ||
713 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, | |
714 | C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for | |
715 | filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a | |
716 | null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, | |
717 | C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text | |
718 | contains non-breaking spaces | |
719 | ||
720 | =item Notes on Implementing Pod Processors | |
721 | ||
722 | =item About LE<lt>...E<gt> Codes | |
723 | ||
724 | First:, Second:, Third:, Fourth:, Fifth:, Sixth: | |
725 | ||
726 | =item About =over...=back Regions | |
727 | ||
728 | =item About Data Paragraphs and "=begin/=end" Regions | |
729 | ||
730 | =item SEE ALSO | |
731 | ||
732 | =item AUTHOR | |
733 | ||
734 | =back | |
735 | ||
736 | =head2 perlstyle - Perl style guide | |
737 | ||
738 | =over 4 | |
739 | ||
740 | =item DESCRIPTION | |
741 | ||
742 | =back | |
743 | ||
744 | =head2 perltrap - Perl traps for the unwary | |
745 | ||
746 | =over 4 | |
747 | ||
748 | =item DESCRIPTION | |
749 | ||
750 | =over 4 | |
751 | ||
752 | =item Awk Traps | |
753 | ||
754 | =item C Traps | |
755 | ||
756 | =item Sed Traps | |
757 | ||
758 | =item Shell Traps | |
759 | ||
760 | =item Perl Traps | |
761 | ||
762 | =item Perl4 to Perl5 Traps | |
763 | ||
764 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical | |
765 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
766 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
767 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
768 | ||
769 | =item Discontinuance, Deprecation, and BugFix traps | |
770 | ||
771 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, | |
772 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
773 | Discontinuance, Deprecation, Discontinuance, Discontinuance | |
774 | ||
775 | =item Parsing Traps | |
776 | ||
777 | Parsing, Parsing, Parsing, Parsing, Parsing | |
778 | ||
779 | =item Numerical Traps | |
780 | ||
781 | Numerical, Numerical, Numerical, Bitwise string ops | |
782 | ||
783 | =item General data type traps | |
784 | ||
785 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), | |
786 | (Constants), (Scalars), (Variable Suicide) | |
787 | ||
788 | =item Context Traps - scalar, list contexts | |
789 | ||
790 | (list context), (scalar context), (scalar context), (list, builtin) | |
791 | ||
792 | =item Precedence Traps | |
793 | ||
794 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, | |
795 | Precedence | |
796 | ||
797 | =item General Regular Expression Traps using s///, etc. | |
798 | ||
799 | Regular Expression, Regular Expression, Regular Expression, Regular | |
800 | Expression, Regular Expression, Regular Expression, Regular Expression, | |
801 | Regular Expression | |
802 | ||
803 | =item Subroutine, Signal, Sorting Traps | |
804 | ||
805 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle | |
806 | ||
807 | =item OS Traps | |
808 | ||
809 | (SysV), (SysV) | |
810 | ||
811 | =item Interpolation Traps | |
812 | ||
813 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, | |
814 | Interpolation, Interpolation, Interpolation, Interpolation | |
815 | ||
816 | =item DBM Traps | |
817 | ||
818 | DBM, DBM | |
819 | ||
820 | =item Unclassified Traps | |
821 | ||
822 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
823 | LIMIT specified | |
824 | ||
825 | =back | |
826 | ||
827 | =back | |
828 | ||
829 | =head2 perlrun - how to execute the Perl interpreter | |
830 | ||
831 | =over 4 | |
832 | ||
833 | =item SYNOPSIS | |
834 | ||
835 | =item DESCRIPTION | |
836 | ||
837 | =over 4 | |
838 | ||
839 | =item #! and quoting on non-Unix systems | |
840 | ||
841 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS | |
842 | ||
843 | =item Location of Perl | |
844 | ||
845 | =item Command Switches | |
846 | ||
847 | B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, | |
848 | B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, | |
849 | B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>], | |
850 | B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
851 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, | |
852 | B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, | |
853 | B<-X>, B<-x> I<directory> | |
854 | ||
855 | =back | |
856 | ||
857 | =item ENVIRONMENT | |
858 | ||
859 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, | |
860 | :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, | |
861 | PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS, | |
862 | PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port), | |
863 | SYS$LOGIN (specific to the VMS port) | |
864 | ||
865 | =back | |
866 | ||
867 | =head2 perldiag - various Perl diagnostics | |
868 | ||
869 | =over 4 | |
870 | ||
871 | =item DESCRIPTION | |
872 | ||
873 | =back | |
874 | ||
875 | =head2 perllexwarn - Perl Lexical Warnings | |
876 | ||
877 | =over 4 | |
878 | ||
879 | =item DESCRIPTION | |
880 | ||
881 | =over 4 | |
882 | ||
883 | =item Default Warnings and Optional Warnings | |
884 | ||
885 | =item What's wrong with B<-w> and C<$^W> | |
886 | ||
887 | =item Controlling Warnings from the Command Line | |
888 | ||
889 | B<-w>, B<-W>, B<-X> | |
890 | ||
891 | =item Backward Compatibility | |
892 | ||
893 | =item Category Hierarchy | |
894 | ||
895 | =item Fatal Warnings | |
896 | ||
897 | =item Reporting Warnings from a Module | |
898 | ||
899 | =back | |
900 | ||
901 | =item TODO | |
902 | ||
903 | =item SEE ALSO | |
904 | ||
905 | =item AUTHOR | |
906 | ||
907 | =back | |
908 | ||
909 | =head2 perldebtut - Perl debugging tutorial | |
910 | ||
911 | =over 4 | |
912 | ||
913 | =item DESCRIPTION | |
914 | ||
915 | =item use strict | |
916 | ||
917 | =item Looking at data and -w and v | |
918 | ||
919 | =item help | |
920 | ||
921 | =item Stepping through code | |
922 | ||
923 | =item Placeholder for a, w, t, T | |
924 | ||
925 | =item REGULAR EXPRESSIONS | |
926 | ||
927 | =item OUTPUT TIPS | |
928 | ||
929 | =item CGI | |
930 | ||
931 | =item GUIs | |
932 | ||
933 | =item SUMMARY | |
934 | ||
935 | =item SEE ALSO | |
936 | ||
937 | =item AUTHOR | |
938 | ||
939 | =item CONTRIBUTORS | |
940 | ||
941 | =back | |
942 | ||
943 | =head2 perldebug - Perl debugging | |
944 | ||
945 | =over 4 | |
946 | ||
947 | =item DESCRIPTION | |
948 | ||
949 | =item The Perl Debugger | |
950 | ||
951 | =over 4 | |
952 | ||
953 | =item Debugger Commands | |
954 | ||
955 | h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y | |
956 | [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l | |
957 | min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, | |
958 | ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b | |
959 | subname [condition], b postpone subname [condition], b load filename, b | |
960 | compile subname, B line, B *, a [line] command, A line, A *, w expr, W | |
961 | expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ | |
962 | command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ | |
963 | command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q | |
964 | or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] | |
965 | ||
966 | =item Configurable Options | |
967 | ||
968 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, | |
969 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
970 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>, | |
971 | C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>, | |
972 | C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, | |
973 | C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, | |
974 | C<NonStop> | |
975 | ||
976 | =item Debugger input/output | |
977 | ||
978 | Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame | |
979 | listing | |
980 | ||
981 | =item Debugging compile-time statements | |
982 | ||
983 | =item Debugger Customization | |
984 | ||
985 | =item Readline Support | |
986 | ||
987 | =item Editor Support for Debugging | |
988 | ||
989 | =item The Perl Profiler | |
990 | ||
991 | =back | |
992 | ||
993 | =item Debugging regular expressions | |
994 | ||
995 | =item Debugging memory usage | |
996 | ||
997 | =item SEE ALSO | |
998 | ||
999 | =item BUGS | |
1000 | ||
1001 | =back | |
1002 | ||
1003 | =head2 perlvar - Perl predefined variables | |
1004 | ||
1005 | =over 4 | |
1006 | ||
1007 | =item DESCRIPTION | |
1008 | ||
1009 | =over 4 | |
1010 | ||
1011 | =item Predefined Names | |
1012 | ||
1013 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', | |
1014 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, | |
1015 | HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, | |
1016 | IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, | |
1017 | HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, | |
1018 | IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, | |
1019 | IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, | |
1020 | $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, | |
1021 | HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, | |
1022 | HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, | |
1023 | HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, | |
1024 | @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as | |
1025 | C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, | |
1026 | $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> | |
1027 | is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as | |
1028 | C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), | |
1029 | $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, | |
1030 | IO::Handle->format_line_break_characters EXPR, | |
1031 | $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, | |
1032 | $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, | |
1033 | $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, | |
1034 | $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, | |
1035 | $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), | |
1036 | $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, | |
1037 | $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, | |
1038 | ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, | |
1039 | 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, | |
1040 | $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, | |
1041 | ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, | |
1042 | $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, | |
1043 | $SIG{expr} | |
1044 | ||
1045 | =item Error Indicators | |
1046 | ||
1047 | =item Technical Note on the Syntax of Variable Names | |
1048 | ||
1049 | =back | |
1050 | ||
1051 | =item BUGS | |
1052 | ||
1053 | =back | |
1054 | ||
1055 | =head2 perllol - Manipulating Arrays of Arrays in Perl | |
1056 | ||
1057 | =over 4 | |
1058 | ||
1059 | =item DESCRIPTION | |
1060 | ||
1061 | =over 4 | |
1062 | ||
1063 | =item Declaration and Access of Arrays of Arrays | |
1064 | ||
1065 | =item Growing Your Own | |
1066 | ||
1067 | =item Access and Printing | |
1068 | ||
1069 | =item Slices | |
1070 | ||
1071 | =back | |
1072 | ||
1073 | =item SEE ALSO | |
1074 | ||
1075 | =item AUTHOR | |
1076 | ||
1077 | =back | |
1078 | ||
1079 | =head2 perlopentut - tutorial on opening things in Perl | |
1080 | ||
1081 | =over 4 | |
1082 | ||
1083 | =item DESCRIPTION | |
1084 | ||
1085 | =item Open E<agrave> la shell | |
1086 | ||
1087 | =over 4 | |
1088 | ||
1089 | =item Simple Opens | |
1090 | ||
1091 | =item Pipe Opens | |
1092 | ||
1093 | =item The Minus File | |
1094 | ||
1095 | =item Mixing Reads and Writes | |
1096 | ||
1097 | =item Filters | |
1098 | ||
1099 | =back | |
1100 | ||
1101 | =item Open E<agrave> la C | |
1102 | ||
1103 | =over 4 | |
1104 | ||
1105 | =item Permissions E<agrave> la mode | |
1106 | ||
1107 | =back | |
1108 | ||
1109 | =item Obscure Open Tricks | |
1110 | ||
1111 | =over 4 | |
1112 | ||
1113 | =item Re-Opening Files (dups) | |
1114 | ||
1115 | =item Dispelling the Dweomer | |
1116 | ||
1117 | =item Paths as Opens | |
1118 | ||
1119 | =item Single Argument Open | |
1120 | ||
1121 | =item Playing with STDIN and STDOUT | |
1122 | ||
1123 | =back | |
1124 | ||
1125 | =item Other I/O Issues | |
1126 | ||
1127 | =over 4 | |
1128 | ||
1129 | =item Opening Non-File Files | |
1130 | ||
1131 | =item Binary Files | |
1132 | ||
1133 | =item File Locking | |
1134 | ||
1135 | =item IO Layers | |
1136 | ||
1137 | =back | |
1138 | ||
1139 | =item SEE ALSO | |
1140 | ||
1141 | =item AUTHOR and COPYRIGHT | |
1142 | ||
1143 | =item HISTORY | |
1144 | ||
1145 | =back | |
1146 | ||
1147 | =head2 perlpacktut - tutorial on C<pack> and C<unpack> | |
1148 | ||
1149 | =over 4 | |
1150 | ||
1151 | =item DESCRIPTION | |
1152 | ||
1153 | =item The Basic Principle | |
1154 | ||
1155 | =item Packing Text | |
1156 | ||
1157 | =item Packing Numbers | |
1158 | ||
1159 | =over 4 | |
1160 | ||
1161 | =item Integers | |
1162 | ||
1163 | =item Unpacking a Stack Frame | |
1164 | ||
1165 | =item How to Eat an Egg on a Net | |
1166 | ||
1167 | =item Floating point Numbers | |
1168 | ||
1169 | =back | |
1170 | ||
1171 | =item Exotic Templates | |
1172 | ||
1173 | =over 4 | |
1174 | ||
1175 | =item Bit Strings | |
1176 | ||
1177 | =item Uuencoding | |
1178 | ||
1179 | =item Doing Sums | |
1180 | ||
1181 | =item Unicode | |
1182 | ||
1183 | =item Another Portable Binary Encoding | |
1184 | ||
1185 | =back | |
1186 | ||
1187 | =item Lengths and Widths | |
1188 | ||
1189 | =over 4 | |
1190 | ||
1191 | =item String Lengths | |
1192 | ||
1193 | =item Dynamic Templates | |
1194 | ||
1195 | =back | |
1196 | ||
1197 | =item Packing and Unpacking C Structures | |
1198 | ||
1199 | =over 4 | |
1200 | ||
1201 | =item The Alignment Pit | |
1202 | ||
1203 | =item Alignment, Take 2 | |
1204 | ||
1205 | =item Alignment, Take 3 | |
1206 | ||
1207 | =item Pointers for How to Use Them | |
1208 | ||
1209 | =back | |
1210 | ||
1211 | =item Pack Recipes | |
1212 | ||
1213 | =item Funnies Section | |
1214 | ||
1215 | =item Authors | |
1216 | ||
1217 | =back | |
1218 | ||
1219 | =head2 perlretut - Perl regular expressions tutorial | |
1220 | ||
1221 | =over 4 | |
1222 | ||
1223 | =item DESCRIPTION | |
1224 | ||
1225 | =item Part 1: The basics | |
1226 | ||
1227 | =over 4 | |
1228 | ||
1229 | =item Simple word matching | |
1230 | ||
1231 | =item Using character classes | |
1232 | ||
1233 | =item Matching this or that | |
1234 | ||
1235 | =item Grouping things and hierarchical matching | |
1236 | ||
1237 | =item Extracting matches | |
1238 | ||
1239 | =item Matching repetitions | |
1240 | ||
1241 | =item Building a regexp | |
1242 | ||
1243 | =item Using regular expressions in Perl | |
1244 | ||
1245 | =back | |
1246 | ||
1247 | =item Part 2: Power tools | |
1248 | ||
1249 | =over 4 | |
1250 | ||
1251 | =item More on characters, strings, and character classes | |
1252 | ||
1253 | =item Compiling and saving regular expressions | |
1254 | ||
1255 | =item Embedding comments and modifiers in a regular expression | |
1256 | ||
1257 | =item Non-capturing groupings | |
1258 | ||
1259 | =item Looking ahead and looking behind | |
1260 | ||
1261 | =item Using independent subexpressions to prevent backtracking | |
1262 | ||
1263 | =item Conditional expressions | |
1264 | ||
1265 | =item A bit of magic: executing Perl code in a regular expression | |
1266 | ||
1267 | =item Pragmas and debugging | |
1268 | ||
1269 | =back | |
1270 | ||
1271 | =item BUGS | |
1272 | ||
1273 | =item SEE ALSO | |
1274 | ||
1275 | =item AUTHOR AND COPYRIGHT | |
1276 | ||
1277 | =over 4 | |
1278 | ||
1279 | =item Acknowledgments | |
1280 | ||
1281 | =back | |
1282 | ||
1283 | =back | |
1284 | ||
1285 | =head2 perlre - Perl regular expressions | |
1286 | ||
1287 | =over 4 | |
1288 | ||
1289 | =item DESCRIPTION | |
1290 | ||
1291 | i, m, s, x | |
1292 | ||
1293 | =over 4 | |
1294 | ||
1295 | =item Regular Expressions | |
1296 | ||
1297 | [1], [2], [3], cntrl, graph, print, punct, xdigit | |
1298 | ||
1299 | =item Extended Patterns | |
1300 | ||
1301 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, | |
1302 | C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ | |
1303 | code })>, C<(??{ code })>, C<< (?>pattern) >>, | |
1304 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
1305 | ||
1306 | =item Backtracking | |
1307 | ||
1308 | =item Version 8 Regular Expressions | |
1309 | ||
1310 | =item Warning on \1 vs $1 | |
1311 | ||
1312 | =item Repeated patterns matching zero-length substring | |
1313 | ||
1314 | =item Combining pieces together | |
1315 | ||
1316 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, | |
1317 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
1318 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
1319 | C<(?(condition)yes-pattern|no-pattern)> | |
1320 | ||
1321 | =item Creating custom RE engines | |
1322 | ||
1323 | =back | |
1324 | ||
1325 | =item BUGS | |
1326 | ||
1327 | =item SEE ALSO | |
1328 | ||
1329 | =back | |
1330 | ||
1331 | =head2 perlref - Perl references and nested data structures | |
1332 | ||
1333 | =over 4 | |
1334 | ||
1335 | =item NOTE | |
1336 | ||
1337 | =item DESCRIPTION | |
1338 | ||
1339 | =over 4 | |
1340 | ||
1341 | =item Making References | |
1342 | ||
1343 | =item Using References | |
1344 | ||
1345 | =item Symbolic references | |
1346 | ||
1347 | =item Not-so-symbolic references | |
1348 | ||
1349 | =item Pseudo-hashes: Using an array as a hash | |
1350 | ||
1351 | =item Function Templates | |
1352 | ||
1353 | =back | |
1354 | ||
1355 | =item WARNING | |
1356 | ||
1357 | =item SEE ALSO | |
1358 | ||
1359 | =back | |
1360 | ||
1361 | =head2 perlform - Perl formats | |
1362 | ||
1363 | =over 4 | |
1364 | ||
1365 | =item DESCRIPTION | |
1366 | ||
1367 | =over 4 | |
1368 | ||
1369 | =item Format Variables | |
1370 | ||
1371 | =back | |
1372 | ||
1373 | =item NOTES | |
1374 | ||
1375 | =over 4 | |
1376 | ||
1377 | =item Footers | |
1378 | ||
1379 | =item Accessing Formatting Internals | |
1380 | ||
1381 | =back | |
1382 | ||
1383 | =item WARNINGS | |
1384 | ||
1385 | =back | |
1386 | ||
1387 | =head2 perlboot - Beginner's Object-Oriented Tutorial | |
1388 | ||
1389 | =over 4 | |
1390 | ||
1391 | =item DESCRIPTION | |
1392 | ||
1393 | =over 4 | |
1394 | ||
1395 | =item If we could talk to the animals... | |
1396 | ||
1397 | =item Introducing the method invocation arrow | |
1398 | ||
1399 | =item Invoking a barnyard | |
1400 | ||
1401 | =item The extra parameter of method invocation | |
1402 | ||
1403 | =item Calling a second method to simplify things | |
1404 | ||
1405 | =item Inheriting the windpipes | |
1406 | ||
1407 | =item A few notes about @ISA | |
1408 | ||
1409 | =item Overriding the methods | |
1410 | ||
1411 | =item Starting the search from a different place | |
1412 | ||
1413 | =item The SUPER way of doing things | |
1414 | ||
1415 | =item Where we're at so far... | |
1416 | ||
1417 | =item A horse is a horse, of course of course -- or is it? | |
1418 | ||
1419 | =item Invoking an instance method | |
1420 | ||
1421 | =item Accessing the instance data | |
1422 | ||
1423 | =item How to build a horse | |
1424 | ||
1425 | =item Inheriting the constructor | |
1426 | ||
1427 | =item Making a method work with either classes or instances | |
1428 | ||
1429 | =item Adding parameters to a method | |
1430 | ||
1431 | =item More interesting instances | |
1432 | ||
1433 | =item A horse of a different color | |
1434 | ||
1435 | =item Summary | |
1436 | ||
1437 | =back | |
1438 | ||
1439 | =item SEE ALSO | |
1440 | ||
1441 | =item COPYRIGHT | |
1442 | ||
1443 | =back | |
1444 | ||
1445 | =head2 perltoot - Tom's object-oriented tutorial for perl | |
1446 | ||
1447 | =over 4 | |
1448 | ||
1449 | =item DESCRIPTION | |
1450 | ||
1451 | =item Creating a Class | |
1452 | ||
1453 | =over 4 | |
1454 | ||
1455 | =item Object Representation | |
1456 | ||
1457 | =item Class Interface | |
1458 | ||
1459 | =item Constructors and Instance Methods | |
1460 | ||
1461 | =item Planning for the Future: Better Constructors | |
1462 | ||
1463 | =item Destructors | |
1464 | ||
1465 | =item Other Object Methods | |
1466 | ||
1467 | =back | |
1468 | ||
1469 | =item Class Data | |
1470 | ||
1471 | =over 4 | |
1472 | ||
1473 | =item Accessing Class Data | |
1474 | ||
1475 | =item Debugging Methods | |
1476 | ||
1477 | =item Class Destructors | |
1478 | ||
1479 | =item Documenting the Interface | |
1480 | ||
1481 | =back | |
1482 | ||
1483 | =item Aggregation | |
1484 | ||
1485 | =item Inheritance | |
1486 | ||
1487 | =over 4 | |
1488 | ||
1489 | =item Overridden Methods | |
1490 | ||
1491 | =item Multiple Inheritance | |
1492 | ||
1493 | =item UNIVERSAL: The Root of All Objects | |
1494 | ||
1495 | =back | |
1496 | ||
1497 | =item Alternate Object Representations | |
1498 | ||
1499 | =over 4 | |
1500 | ||
1501 | =item Arrays as Objects | |
1502 | ||
1503 | =item Closures as Objects | |
1504 | ||
1505 | =back | |
1506 | ||
1507 | =item AUTOLOAD: Proxy Methods | |
1508 | ||
1509 | =over 4 | |
1510 | ||
1511 | =item Autoloaded Data Methods | |
1512 | ||
1513 | =item Inherited Autoloaded Data Methods | |
1514 | ||
1515 | =back | |
1516 | ||
1517 | =item Metaclassical Tools | |
1518 | ||
1519 | =over 4 | |
1520 | ||
1521 | =item Class::Struct | |
1522 | ||
1523 | =item Data Members as Variables | |
1524 | ||
1525 | =back | |
1526 | ||
1527 | =item NOTES | |
1528 | ||
1529 | =over 4 | |
1530 | ||
1531 | =item Object Terminology | |
1532 | ||
1533 | =back | |
1534 | ||
1535 | =item SEE ALSO | |
1536 | ||
1537 | =item AUTHOR AND COPYRIGHT | |
1538 | ||
1539 | =item COPYRIGHT | |
1540 | ||
1541 | =over 4 | |
1542 | ||
1543 | =item Acknowledgments | |
1544 | ||
1545 | =back | |
1546 | ||
1547 | =back | |
1548 | ||
1549 | =head2 perltooc - Tom's OO Tutorial for Class Data in Perl | |
1550 | ||
1551 | =over 4 | |
1552 | ||
1553 | =item DESCRIPTION | |
1554 | ||
1555 | =item Class Data in a Can | |
1556 | ||
1557 | =item Class Data as Package Variables | |
1558 | ||
1559 | =over 4 | |
1560 | ||
1561 | =item Putting All Your Eggs in One Basket | |
1562 | ||
1563 | =item Inheritance Concerns | |
1564 | ||
1565 | =item The Eponymous Meta-Object | |
1566 | ||
1567 | =item Indirect References to Class Data | |
1568 | ||
1569 | =item Monadic Classes | |
1570 | ||
1571 | =item Translucent Attributes | |
1572 | ||
1573 | =back | |
1574 | ||
1575 | =item Class Data as Lexical Variables | |
1576 | ||
1577 | =over 4 | |
1578 | ||
1579 | =item Privacy and Responsibility | |
1580 | ||
1581 | =item File-Scoped Lexicals | |
1582 | ||
1583 | =item More Inheritance Concerns | |
1584 | ||
1585 | =item Locking the Door and Throwing Away the Key | |
1586 | ||
1587 | =item Translucency Revisited | |
1588 | ||
1589 | =back | |
1590 | ||
1591 | =item NOTES | |
1592 | ||
1593 | =item SEE ALSO | |
1594 | ||
1595 | =item AUTHOR AND COPYRIGHT | |
1596 | ||
1597 | =item ACKNOWLEDGEMENTS | |
1598 | ||
1599 | =item HISTORY | |
1600 | ||
1601 | =back | |
1602 | ||
1603 | =head2 perlobj - Perl objects | |
1604 | ||
1605 | =over 4 | |
1606 | ||
1607 | =item DESCRIPTION | |
1608 | ||
1609 | =over 4 | |
1610 | ||
1611 | =item An Object is Simply a Reference | |
1612 | ||
1613 | =item A Class is Simply a Package | |
1614 | ||
1615 | =item A Method is Simply a Subroutine | |
1616 | ||
1617 | =item Method Invocation | |
1618 | ||
1619 | =item Indirect Object Syntax | |
1620 | ||
1621 | =item Default UNIVERSAL methods | |
1622 | ||
1623 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
1624 | ||
1625 | =item Destructors | |
1626 | ||
1627 | =item Summary | |
1628 | ||
1629 | =item Two-Phased Garbage Collection | |
1630 | ||
1631 | =back | |
1632 | ||
1633 | =item SEE ALSO | |
1634 | ||
1635 | =back | |
1636 | ||
1637 | =head2 perlbot - Bag'o Object Tricks (the BOT) | |
1638 | ||
1639 | =over 4 | |
1640 | ||
1641 | =item DESCRIPTION | |
1642 | ||
1643 | =item OO SCALING TIPS | |
1644 | ||
1645 | =item INSTANCE VARIABLES | |
1646 | ||
1647 | =item SCALAR INSTANCE VARIABLES | |
1648 | ||
1649 | =item INSTANCE VARIABLE INHERITANCE | |
1650 | ||
1651 | =item OBJECT RELATIONSHIPS | |
1652 | ||
1653 | =item OVERRIDING SUPERCLASS METHODS | |
1654 | ||
1655 | =item USING RELATIONSHIP WITH SDBM | |
1656 | ||
1657 | =item THINKING OF CODE REUSE | |
1658 | ||
1659 | =item CLASS CONTEXT AND THE OBJECT | |
1660 | ||
1661 | =item INHERITING A CONSTRUCTOR | |
1662 | ||
1663 | =item DELEGATION | |
1664 | ||
1665 | =back | |
1666 | ||
1667 | =head2 perltie - how to hide an object class in a simple variable | |
1668 | ||
1669 | =over 4 | |
1670 | ||
1671 | =item SYNOPSIS | |
1672 | ||
1673 | =item DESCRIPTION | |
1674 | ||
1675 | =over 4 | |
1676 | ||
1677 | =item Tying Scalars | |
1678 | ||
1679 | TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, | |
1680 | DESTROY this | |
1681 | ||
1682 | =item Tying Arrays | |
1683 | ||
1684 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, | |
1685 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, | |
1686 | key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this, | |
1687 | UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY | |
1688 | this | |
1689 | ||
1690 | =item Tying Hashes | |
1691 | ||
1692 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE | |
1693 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
1694 | this, NEXTKEY this, lastkey, UNTIE this, DESTROY this | |
1695 | ||
1696 | =item Tying FileHandles | |
1697 | ||
1698 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, | |
1699 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, | |
1700 | DESTROY this | |
1701 | ||
1702 | =item UNTIE this | |
1703 | ||
1704 | =item The C<untie> Gotcha | |
1705 | ||
1706 | =back | |
1707 | ||
1708 | =item SEE ALSO | |
1709 | ||
1710 | =item BUGS | |
1711 | ||
1712 | =item AUTHOR | |
1713 | ||
1714 | =back | |
1715 | ||
1716 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, | |
1717 | safe subprocesses, sockets, and semaphores) | |
1718 | ||
1719 | =over 4 | |
1720 | ||
1721 | =item DESCRIPTION | |
1722 | ||
1723 | =item Signals | |
1724 | ||
1725 | =over 4 | |
1726 | ||
1727 | =item Handling the SIGHUP Signal in Daemons | |
1728 | ||
1729 | =back | |
1730 | ||
1731 | =item Named Pipes | |
1732 | ||
1733 | =over 4 | |
1734 | ||
1735 | =item Deferred Signals | |
1736 | ||
1737 | Long running opcodes, Interrupting IO, Signals as "faults", Signals | |
1738 | triggered by operating system state | |
1739 | ||
1740 | =back | |
1741 | ||
1742 | =item Using open() for IPC | |
1743 | ||
1744 | =over 4 | |
1745 | ||
1746 | =item Filehandles | |
1747 | ||
1748 | =item Background Processes | |
1749 | ||
1750 | =item Complete Dissociation of Child from Parent | |
1751 | ||
1752 | =item Safe Pipe Opens | |
1753 | ||
1754 | =item Bidirectional Communication with Another Process | |
1755 | ||
1756 | =item Bidirectional Communication with Yourself | |
1757 | ||
1758 | =back | |
1759 | ||
1760 | =item Sockets: Client/Server Communication | |
1761 | ||
1762 | =over 4 | |
1763 | ||
1764 | =item Internet Line Terminators | |
1765 | ||
1766 | =item Internet TCP Clients and Servers | |
1767 | ||
1768 | =item Unix-Domain TCP Clients and Servers | |
1769 | ||
1770 | =back | |
1771 | ||
1772 | =item TCP Clients with IO::Socket | |
1773 | ||
1774 | =over 4 | |
1775 | ||
1776 | =item A Simple Client | |
1777 | ||
1778 | C<Proto>, C<PeerAddr>, C<PeerPort> | |
1779 | ||
1780 | =item A Webget Client | |
1781 | ||
1782 | =item Interactive Client with IO::Socket | |
1783 | ||
1784 | =back | |
1785 | ||
1786 | =item TCP Servers with IO::Socket | |
1787 | ||
1788 | Proto, LocalPort, Listen, Reuse | |
1789 | ||
1790 | =item UDP: Message Passing | |
1791 | ||
1792 | =item SysV IPC | |
1793 | ||
1794 | =item NOTES | |
1795 | ||
1796 | =item BUGS | |
1797 | ||
1798 | =item AUTHOR | |
1799 | ||
1800 | =item SEE ALSO | |
1801 | ||
1802 | =back | |
1803 | ||
1804 | =head2 perlfork - Perl's fork() emulation | |
1805 | ||
1806 | =over 4 | |
1807 | ||
1808 | =item SYNOPSIS | |
1809 | ||
1810 | =item DESCRIPTION | |
1811 | ||
1812 | =over 4 | |
1813 | ||
1814 | =item Behavior of other Perl features in forked pseudo-processes | |
1815 | ||
1816 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept | |
1817 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
1818 | files, directories and network sockets | |
1819 | ||
1820 | =item Resource limits | |
1821 | ||
1822 | =item Killing the parent process | |
1823 | ||
1824 | =item Lifetime of the parent process and pseudo-processes | |
1825 | ||
1826 | =item CAVEATS AND LIMITATIONS | |
1827 | ||
1828 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, | |
1829 | Global state maintained by XSUBs, Interpreter embedded in larger | |
1830 | application, Thread-safety of extensions | |
1831 | ||
1832 | =back | |
1833 | ||
1834 | =item BUGS | |
1835 | ||
1836 | =item AUTHOR | |
1837 | ||
1838 | =item SEE ALSO | |
1839 | ||
1840 | =back | |
1841 | ||
1842 | =head2 perlnumber - semantics of numbers and numeric operations in Perl | |
1843 | ||
1844 | =over 4 | |
1845 | ||
1846 | =item SYNOPSIS | |
1847 | ||
1848 | =item DESCRIPTION | |
1849 | ||
1850 | =item Storing numbers | |
1851 | ||
1852 | =item Numeric operators and numeric conversions | |
1853 | ||
1854 | =item Flavors of Perl numeric operations | |
1855 | ||
1856 | Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other | |
1857 | mathematical operators, Bitwise operators, Bitwise operators during C<use | |
1858 | integer>, Operators which expect an integer, Operators which expect a | |
1859 | string | |
1860 | ||
1861 | =item AUTHOR | |
1862 | ||
1863 | =item SEE ALSO | |
1864 | ||
1865 | =back | |
1866 | ||
1867 | =head2 perlthrtut - tutorial on threads in Perl | |
1868 | ||
1869 | =over 4 | |
1870 | ||
1871 | =item DESCRIPTION | |
1872 | ||
1873 | =item Status | |
1874 | ||
1875 | =item What Is A Thread Anyway? | |
1876 | ||
1877 | =item Threaded Program Models | |
1878 | ||
1879 | =over 4 | |
1880 | ||
1881 | =item Boss/Worker | |
1882 | ||
1883 | =item Work Crew | |
1884 | ||
1885 | =item Pipeline | |
1886 | ||
1887 | =back | |
1888 | ||
1889 | =item Native threads | |
1890 | ||
1891 | =item What kind of threads are Perl threads? | |
1892 | ||
1893 | =item Thread-Safe Modules | |
1894 | ||
1895 | =item Thread Basics | |
1896 | ||
1897 | =over 4 | |
1898 | ||
1899 | =item Basic Thread Support | |
1900 | ||
1901 | =item A Note about the Examples | |
1902 | ||
1903 | =item Creating Threads | |
1904 | ||
1905 | =item Giving up control | |
1906 | ||
1907 | =item Waiting For A Thread To Exit | |
1908 | ||
1909 | =item Ignoring A Thread | |
1910 | ||
1911 | =back | |
1912 | ||
1913 | =item Threads And Data | |
1914 | ||
1915 | =over 4 | |
1916 | ||
1917 | =item Shared And Unshared Data | |
1918 | ||
1919 | =item Thread Pitfalls: Races | |
1920 | ||
1921 | =back | |
1922 | ||
1923 | =item Synchronization and control | |
1924 | ||
1925 | =over 4 | |
1926 | ||
1927 | =item Controlling access: lock() | |
1928 | ||
1929 | =item A Thread Pitfall: Deadlocks | |
1930 | ||
1931 | =item Queues: Passing Data Around | |
1932 | ||
1933 | =item Semaphores: Synchronizing Data Access | |
1934 | ||
1935 | =item Basic semaphores | |
1936 | ||
1937 | =item Advanced Semaphores | |
1938 | ||
1939 | =item cond_wait() and cond_signal() | |
1940 | ||
1941 | =back | |
1942 | ||
1943 | =item General Thread Utility Routines | |
1944 | ||
1945 | =over 4 | |
1946 | ||
1947 | =item What Thread Am I In? | |
1948 | ||
1949 | =item Thread IDs | |
1950 | ||
1951 | =item Are These Threads The Same? | |
1952 | ||
1953 | =item What Threads Are Running? | |
1954 | ||
1955 | =back | |
1956 | ||
1957 | =item A Complete Example | |
1958 | ||
1959 | =item Performance considerations | |
1960 | ||
1961 | =item Process-scope Changes | |
1962 | ||
1963 | =item Thread-Safety of System Libraries | |
1964 | ||
1965 | =item Conclusion | |
1966 | ||
1967 | =item Bibliography | |
1968 | ||
1969 | =over 4 | |
1970 | ||
1971 | =item Introductory Texts | |
1972 | ||
1973 | =item OS-Related References | |
1974 | ||
1975 | =item Other References | |
1976 | ||
1977 | =back | |
1978 | ||
1979 | =item Acknowledgements | |
1980 | ||
1981 | =item AUTHOR | |
1982 | ||
1983 | =item Copyrights | |
1984 | ||
1985 | =back | |
1986 | ||
1987 | =head2 perlothrtut - old tutorial on threads in Perl | |
1988 | ||
1989 | =over 4 | |
1990 | ||
1991 | =item DESCRIPTION | |
1992 | ||
1993 | =item What Is A Thread Anyway? | |
1994 | ||
1995 | =item Threaded Program Models | |
1996 | ||
1997 | =over 4 | |
1998 | ||
1999 | =item Boss/Worker | |
2000 | ||
2001 | =item Work Crew | |
2002 | ||
2003 | =item Pipeline | |
2004 | ||
2005 | =back | |
2006 | ||
2007 | =item Native threads | |
2008 | ||
2009 | =item What kind of threads are perl threads? | |
2010 | ||
2011 | =item Threadsafe Modules | |
2012 | ||
2013 | =item Thread Basics | |
2014 | ||
2015 | =over 4 | |
2016 | ||
2017 | =item Basic Thread Support | |
2018 | ||
2019 | =item Creating Threads | |
2020 | ||
2021 | =item Giving up control | |
2022 | ||
2023 | =item Waiting For A Thread To Exit | |
2024 | ||
2025 | =item Errors In Threads | |
2026 | ||
2027 | =item Ignoring A Thread | |
2028 | ||
2029 | =back | |
2030 | ||
2031 | =item Threads And Data | |
2032 | ||
2033 | =over 4 | |
2034 | ||
2035 | =item Shared And Unshared Data | |
2036 | ||
2037 | =item Thread Pitfall: Races | |
2038 | ||
2039 | =item Controlling access: lock() | |
2040 | ||
2041 | =item Thread Pitfall: Deadlocks | |
2042 | ||
2043 | =item Queues: Passing Data Around | |
2044 | ||
2045 | =back | |
2046 | ||
2047 | =item Threads And Code | |
2048 | ||
2049 | =over 4 | |
2050 | ||
2051 | =item Semaphores: Synchronizing Data Access | |
2052 | ||
2053 | Basic semaphores, Advanced Semaphores | |
2054 | ||
2055 | =item Attributes: Restricting Access To Subroutines | |
2056 | ||
2057 | =item Subroutine Locks | |
2058 | ||
2059 | =item Methods | |
2060 | ||
2061 | =item Locking A Subroutine | |
2062 | ||
2063 | =back | |
2064 | ||
2065 | =item General Thread Utility Routines | |
2066 | ||
2067 | =over 4 | |
2068 | ||
2069 | =item What Thread Am I In? | |
2070 | ||
2071 | =item Thread IDs | |
2072 | ||
2073 | =item Are These Threads The Same? | |
2074 | ||
2075 | =item What Threads Are Running? | |
2076 | ||
2077 | =back | |
2078 | ||
2079 | =item A Complete Example | |
2080 | ||
2081 | =item Conclusion | |
2082 | ||
2083 | =item Bibliography | |
2084 | ||
2085 | =over 4 | |
2086 | ||
2087 | =item Introductory Texts | |
2088 | ||
2089 | =item OS-Related References | |
2090 | ||
2091 | =item Other References | |
2092 | ||
2093 | =back | |
2094 | ||
2095 | =item Acknowledgements | |
2096 | ||
2097 | =item AUTHOR | |
2098 | ||
2099 | =item Copyrights | |
2100 | ||
2101 | =back | |
2102 | ||
2103 | =head2 perlport - Writing portable Perl | |
2104 | ||
2105 | =over 4 | |
2106 | ||
2107 | =item DESCRIPTION | |
2108 | ||
2109 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> | |
2110 | portable | |
2111 | ||
2112 | =item ISSUES | |
2113 | ||
2114 | =over 4 | |
2115 | ||
2116 | =item Newlines | |
2117 | ||
2118 | =item Numbers endianness and Width | |
2119 | ||
2120 | =item Files and Filesystems | |
2121 | ||
2122 | =item System Interaction | |
2123 | ||
2124 | =item Command names versus file pathnames | |
2125 | ||
2126 | =item Interprocess Communication (IPC) | |
2127 | ||
2128 | =item External Subroutines (XS) | |
2129 | ||
2130 | =item Standard Modules | |
2131 | ||
2132 | =item Time and Date | |
2133 | ||
2134 | =item Character sets and character encoding | |
2135 | ||
2136 | =item Internationalisation | |
2137 | ||
2138 | =item System Resources | |
2139 | ||
2140 | =item Security | |
2141 | ||
2142 | =item Style | |
2143 | ||
2144 | =back | |
2145 | ||
2146 | =item CPAN Testers | |
2147 | ||
2148 | Mailing list: cpan-testers@perl.org, Testing results: | |
2149 | http://testers.cpan.org/ | |
2150 | ||
2151 | =item PLATFORMS | |
2152 | ||
2153 | =over 4 | |
2154 | ||
2155 | =item Unix | |
2156 | ||
2157 | =item DOS and Derivatives | |
2158 | ||
2159 | =item S<Mac OS> | |
2160 | ||
2161 | =item VMS | |
2162 | ||
2163 | =item VOS | |
2164 | ||
2165 | =item EBCDIC Platforms | |
2166 | ||
2167 | =item Acorn RISC OS | |
2168 | ||
2169 | =item Other perls | |
2170 | ||
2171 | =back | |
2172 | ||
2173 | =item FUNCTION IMPLEMENTATIONS | |
2174 | ||
2175 | =over 4 | |
2176 | ||
2177 | =item Alphabetical Listing of Perl Functions | |
2178 | ||
2179 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode | |
2180 | FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt | |
2181 | PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec | |
2182 | LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock | |
2183 | FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority | |
2184 | WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID, | |
2185 | getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
2186 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
2187 | getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN, | |
2188 | setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent, | |
2189 | endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob | |
2190 | EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link | |
2191 | OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, | |
2192 | msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open | |
2193 | FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink | |
2194 | EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, | |
2195 | semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, | |
2196 | setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt | |
2197 | SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, | |
2198 | shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, | |
2199 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat | |
2200 | EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
2201 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate | |
2202 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
2203 | wait, waitpid PID,FLAGS | |
2204 | ||
2205 | =back | |
2206 | ||
2207 | =item CHANGES | |
2208 | ||
2209 | v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, | |
2210 | v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 | |
2211 | May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February | |
2212 | 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September | |
2213 | 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, | |
2214 | v1.30, 03 August 1998, v1.23, 10 July 1998 | |
2215 | ||
2216 | =item Supported Platforms | |
2217 | ||
2218 | =item SEE ALSO | |
2219 | ||
2220 | =item AUTHORS / CONTRIBUTORS | |
2221 | ||
2222 | =back | |
2223 | ||
2224 | =head2 perllocale - Perl locale handling (internationalization and | |
2225 | localization) | |
2226 | ||
2227 | =over 4 | |
2228 | ||
2229 | =item DESCRIPTION | |
2230 | ||
2231 | =item PREPARING TO USE LOCALES | |
2232 | ||
2233 | =item USING LOCALES | |
2234 | ||
2235 | =over 4 | |
2236 | ||
2237 | =item The use locale pragma | |
2238 | ||
2239 | =item The setlocale function | |
2240 | ||
2241 | =item Finding locales | |
2242 | ||
2243 | =item LOCALE PROBLEMS | |
2244 | ||
2245 | =item Temporarily fixing locale problems | |
2246 | ||
2247 | =item Permanently fixing locale problems | |
2248 | ||
2249 | =item Permanently fixing your system's locale configuration | |
2250 | ||
2251 | =item Fixing system locale configuration | |
2252 | ||
2253 | =item The localeconv function | |
2254 | ||
2255 | =item I18N::Langinfo | |
2256 | ||
2257 | =back | |
2258 | ||
2259 | =item LOCALE CATEGORIES | |
2260 | ||
2261 | =over 4 | |
2262 | ||
2263 | =item Category LC_COLLATE: Collation | |
2264 | ||
2265 | =item Category LC_CTYPE: Character Types | |
2266 | ||
2267 | =item Category LC_NUMERIC: Numeric Formatting | |
2268 | ||
2269 | =item Category LC_MONETARY: Formatting of monetary amounts | |
2270 | ||
2271 | =item LC_TIME | |
2272 | ||
2273 | =item Other categories | |
2274 | ||
2275 | =back | |
2276 | ||
2277 | =item SECURITY | |
2278 | ||
2279 | =item ENVIRONMENT | |
2280 | ||
2281 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, | |
2282 | LC_NUMERIC, LC_TIME, LANG | |
2283 | ||
2284 | =item NOTES | |
2285 | ||
2286 | =over 4 | |
2287 | ||
2288 | =item Backward compatibility | |
2289 | ||
2290 | =item I18N:Collate obsolete | |
2291 | ||
2292 | =item Sort speed and memory use impacts | |
2293 | ||
2294 | =item write() and LC_NUMERIC | |
2295 | ||
2296 | =item Freely available locale definitions | |
2297 | ||
2298 | =item I18n and l10n | |
2299 | ||
2300 | =item An imperfect standard | |
2301 | ||
2302 | =back | |
2303 | ||
2304 | =item Unicode and UTF-8 | |
2305 | ||
2306 | =item BUGS | |
2307 | ||
2308 | =over 4 | |
2309 | ||
2310 | =item Broken systems | |
2311 | ||
2312 | =back | |
2313 | ||
2314 | =item SEE ALSO | |
2315 | ||
2316 | =item HISTORY | |
2317 | ||
2318 | =back | |
2319 | ||
2320 | =head2 perluniintro - Perl Unicode introduction | |
2321 | ||
2322 | =over 4 | |
2323 | ||
2324 | =item DESCRIPTION | |
2325 | ||
2326 | =over 4 | |
2327 | ||
2328 | =item Unicode | |
2329 | ||
2330 | =item Perl's Unicode Support | |
2331 | ||
2332 | =item Perl's Unicode Model | |
2333 | ||
2334 | =item Unicode and EBCDIC | |
2335 | ||
2336 | =item Creating Unicode | |
2337 | ||
2338 | =item Handling Unicode | |
2339 | ||
2340 | =item Legacy Encodings | |
2341 | ||
2342 | =item Unicode I/O | |
2343 | ||
2344 | =item Displaying Unicode As Text | |
2345 | ||
2346 | =item Special Cases | |
2347 | ||
2348 | =item Advanced Topics | |
2349 | ||
2350 | =item Miscellaneous | |
2351 | ||
2352 | =item Questions With Answers | |
2353 | ||
2354 | =item Hexadecimal Notation | |
2355 | ||
2356 | =item Further Resources | |
2357 | ||
2358 | =back | |
2359 | ||
2360 | =item UNICODE IN OLDER PERLS | |
2361 | ||
2362 | =item SEE ALSO | |
2363 | ||
2364 | =item ACKNOWLEDGMENTS | |
2365 | ||
2366 | =item AUTHOR, COPYRIGHT, AND LICENSE | |
2367 | ||
2368 | =back | |
2369 | ||
2370 | =head2 perlunicode - Unicode support in Perl | |
2371 | ||
2372 | =over 4 | |
2373 | ||
2374 | =item DESCRIPTION | |
2375 | ||
2376 | =over 4 | |
2377 | ||
2378 | =item Important Caveats | |
2379 | ||
2380 | Input and Output Layers, Regular Expressions, C<use utf8> still needed to | |
2381 | enable UTF-8/UTF-EBCDIC in scripts | |
2382 | ||
2383 | =item Byte and Character Semantics | |
2384 | ||
2385 | =item Effects of Character Semantics | |
2386 | ||
2387 | =item Scripts | |
2388 | ||
2389 | =item Blocks | |
2390 | ||
2391 | =item User-Defined Character Properties | |
2392 | ||
2393 | =item Character Encodings for Input and Output | |
2394 | ||
2395 | =item Unicode Regular Expression Support Level | |
2396 | ||
2397 | =item Unicode Encodings | |
2398 | ||
2399 | =item Security Implications of Unicode | |
2400 | ||
2401 | =item Unicode in Perl on EBCDIC | |
2402 | ||
2403 | =item Locales | |
2404 | ||
2405 | =item Using Unicode in XS | |
2406 | ||
2407 | =back | |
2408 | ||
2409 | =item BUGS | |
2410 | ||
2411 | =over 4 | |
2412 | ||
2413 | =item Interaction with Locales | |
2414 | ||
2415 | =item Interaction with Extensions | |
2416 | ||
2417 | =item Speed | |
2418 | ||
2419 | =back | |
2420 | ||
2421 | =item SEE ALSO | |
2422 | ||
2423 | =back | |
2424 | ||
2425 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms | |
2426 | ||
2427 | =over 4 | |
2428 | ||
2429 | =item DESCRIPTION | |
2430 | ||
2431 | =item COMMON CHARACTER CODE SETS | |
2432 | ||
2433 | =over 4 | |
2434 | ||
2435 | =item ASCII | |
2436 | ||
2437 | =item ISO 8859 | |
2438 | ||
2439 | =item Latin 1 (ISO 8859-1) | |
2440 | ||
2441 | =item EBCDIC | |
2442 | ||
2443 | =item 13 variant characters | |
2444 | ||
2445 | =item 0037 | |
2446 | ||
2447 | =item 1047 | |
2448 | ||
2449 | =item POSIX-BC | |
2450 | ||
2451 | =item Unicode code points versus EBCDIC code points | |
2452 | ||
2453 | =item Remaining Perl Unicode problems in EBCDIC | |
2454 | ||
2455 | =item Unicode and UTF | |
2456 | ||
2457 | =item Using Encode | |
2458 | ||
2459 | =back | |
2460 | ||
2461 | =item SINGLE OCTET TABLES | |
2462 | ||
2463 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 | |
2464 | ||
2465 | =item IDENTIFYING CHARACTER CODE SETS | |
2466 | ||
2467 | =item CONVERSIONS | |
2468 | ||
2469 | =over 4 | |
2470 | ||
2471 | =item tr/// | |
2472 | ||
2473 | =item iconv | |
2474 | ||
2475 | =item C RTL | |
2476 | ||
2477 | =back | |
2478 | ||
2479 | =item OPERATOR DIFFERENCES | |
2480 | ||
2481 | =item FUNCTION DIFFERENCES | |
2482 | ||
2483 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() | |
2484 | ||
2485 | =item REGULAR EXPRESSION DIFFERENCES | |
2486 | ||
2487 | =item SOCKETS | |
2488 | ||
2489 | =item SORTING | |
2490 | ||
2491 | =over 4 | |
2492 | ||
2493 | =item Ignore ASCII vs. EBCDIC sort differences. | |
2494 | ||
2495 | =item MONO CASE then sort data. | |
2496 | ||
2497 | =item Convert, sort data, then re convert. | |
2498 | ||
2499 | =item Perform sorting on one type of machine only. | |
2500 | ||
2501 | =back | |
2502 | ||
2503 | =item TRANSFORMATION FORMATS | |
2504 | ||
2505 | =over 4 | |
2506 | ||
2507 | =item URL decoding and encoding | |
2508 | ||
2509 | =item uu encoding and decoding | |
2510 | ||
2511 | =item Quoted-Printable encoding and decoding | |
2512 | ||
2513 | =item Caesarian ciphers | |
2514 | ||
2515 | =back | |
2516 | ||
2517 | =item Hashing order and checksums | |
2518 | ||
2519 | =item I18N AND L10N | |
2520 | ||
2521 | =item MULTI OCTET CHARACTER SETS | |
2522 | ||
2523 | =item OS ISSUES | |
2524 | ||
2525 | =over 4 | |
2526 | ||
2527 | =item OS/400 | |
2528 | ||
2529 | IFS access | |
2530 | ||
2531 | =item OS/390, z/OS | |
2532 | ||
2533 | chcp, dataset access, OS/390, z/OS iconv, locales | |
2534 | ||
2535 | =item VM/ESA? | |
2536 | ||
2537 | =item POSIX-BC? | |
2538 | ||
2539 | =back | |
2540 | ||
2541 | =item BUGS | |
2542 | ||
2543 | =item SEE ALSO | |
2544 | ||
2545 | =item REFERENCES | |
2546 | ||
2547 | =item HISTORY | |
2548 | ||
2549 | =item AUTHOR | |
2550 | ||
2551 | =back | |
2552 | ||
2553 | =head2 perlsec - Perl security | |
2554 | ||
2555 | =over 4 | |
2556 | ||
2557 | =item DESCRIPTION | |
2558 | ||
2559 | =over 4 | |
2560 | ||
2561 | =item Laundering and Detecting Tainted Data | |
2562 | ||
2563 | =item Switches On the "#!" Line | |
2564 | ||
2565 | =item Cleaning Up Your Path | |
2566 | ||
2567 | =item Security Bugs | |
2568 | ||
2569 | =item Protecting Your Programs | |
2570 | ||
2571 | =item Unicode | |
2572 | ||
2573 | =back | |
2574 | ||
2575 | =item SEE ALSO | |
2576 | ||
2577 | =back | |
2578 | ||
2579 | =head2 perlmod - Perl modules (packages and symbol tables) | |
2580 | ||
2581 | =over 4 | |
2582 | ||
2583 | =item DESCRIPTION | |
2584 | ||
2585 | =over 4 | |
2586 | ||
2587 | =item Packages | |
2588 | ||
2589 | =item Symbol Tables | |
2590 | ||
2591 | =item Package Constructors and Destructors | |
2592 | ||
2593 | =item Perl Classes | |
2594 | ||
2595 | =item Perl Modules | |
2596 | ||
2597 | =item Making your module threadsafe | |
2598 | ||
2599 | =back | |
2600 | ||
2601 | =item SEE ALSO | |
2602 | ||
2603 | =back | |
2604 | ||
2605 | =head2 perlmodinstall - Installing CPAN Modules | |
2606 | ||
2607 | =over 4 | |
2608 | ||
2609 | =item DESCRIPTION | |
2610 | ||
2611 | =over 4 | |
2612 | ||
2613 | =item PREAMBLE | |
2614 | ||
2615 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the | |
2616 | module (sometimes unnecessary), B<INSTALL> the module | |
2617 | ||
2618 | =back | |
2619 | ||
2620 | =item PORTABILITY | |
2621 | ||
2622 | =item HEY | |
2623 | ||
2624 | =item AUTHOR | |
2625 | ||
2626 | =item COPYRIGHT | |
2627 | ||
2628 | =back | |
2629 | ||
2630 | =head2 perlmodlib - constructing new Perl modules and finding existing ones | |
2631 | ||
2632 | =over 4 | |
2633 | ||
2634 | =item DESCRIPTION | |
2635 | ||
2636 | =item THE PERL MODULE LIBRARY | |
2637 | ||
2638 | =over 4 | |
2639 | ||
2640 | =item Pragmatic Modules | |
2641 | ||
2642 | attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes, | |
2643 | charnames, constant, diagnostics, encoding, fields, filetest, if, integer, | |
2644 | less, locale, open, ops, overload, re, sigtrap, sort, strict, subs, | |
2645 | threads, utf8, vars, vmsish, warnings, warnings::register | |
2646 | ||
2647 | =item Standard Modules | |
2648 | ||
2649 | AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, | |
2650 | B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, | |
2651 | B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, | |
2652 | B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, | |
2653 | CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, | |
2654 | CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, | |
2655 | Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest, | |
2656 | DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter, | |
2657 | Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, | |
2658 | ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, | |
2659 | ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any, | |
2660 | ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, | |
2661 | ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN, | |
2662 | ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, | |
2663 | ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest, | |
2664 | ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, | |
2665 | ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, | |
2666 | File::Compare, File::Copy, File::DosGlob, File::Find, File::Path, | |
2667 | File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions, | |
2668 | File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, | |
2669 | File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, | |
2670 | Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util, | |
2671 | I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, | |
2672 | IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency, | |
2673 | Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, | |
2674 | Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, | |
2675 | Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, | |
2676 | Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, | |
2677 | Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, | |
2678 | Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, | |
2679 | Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, | |
2680 | Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, | |
2681 | PerlIO, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions, | |
2682 | Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, | |
2683 | Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, | |
2684 | Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, | |
2685 | SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, | |
2686 | Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, | |
2687 | Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert, | |
2688 | Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple, | |
2689 | Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, | |
2690 | Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, | |
2691 | Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash, | |
2692 | Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, | |
2693 | Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, | |
2694 | Unicode::UCD, User::grent, User::pwent, Win32 | |
2695 | ||
2696 | =item Extension Modules | |
2697 | ||
2698 | =back | |
2699 | ||
2700 | =item CPAN | |
2701 | ||
2702 | =over 4 | |
2703 | ||
2704 | =item Africa | |
2705 | ||
2706 | South Africa | |
2707 | ||
2708 | =item Asia | |
2709 | ||
2710 | China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian | |
2711 | Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand | |
2712 | ||
2713 | =item Central America | |
2714 | ||
2715 | Costa Rica | |
2716 | ||
2717 | =item Europe | |
2718 | ||
2719 | Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, | |
2720 | Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, | |
2721 | Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia, | |
2722 | Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United | |
2723 | Kingdom | |
2724 | ||
2725 | =item North America | |
2726 | ||
2727 | Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico | |
2728 | ||
2729 | =item United States | |
2730 | ||
2731 | Alabama, California, Colorado, Delaware, District of Columbia, Florida, | |
2732 | Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York, | |
2733 | North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, | |
2734 | Utah, Virginia, ashington, Wisconsin | |
2735 | ||
2736 | =item Oceania | |
2737 | ||
2738 | Australia, New Zealand | |
2739 | ||
2740 | =item South America | |
2741 | ||
2742 | Argentina, Brazil, Chile | |
2743 | ||
2744 | =item RSYNC Mirrors | |
2745 | ||
2746 | =back | |
2747 | ||
2748 | =item Modules: Creation, Use, and Abuse | |
2749 | ||
2750 | =over 4 | |
2751 | ||
2752 | =item Guidelines for Module Creation | |
2753 | ||
2754 | =item Guidelines for Converting Perl 4 Library Scripts into Modules | |
2755 | ||
2756 | =item Guidelines for Reusing Application Code | |
2757 | ||
2758 | =back | |
2759 | ||
2760 | =item NOTE | |
2761 | ||
2762 | =back | |
2763 | ||
2764 | =head2 perlmodstyle - Perl module style guide | |
2765 | ||
2766 | =over 4 | |
2767 | ||
2768 | =item INTRODUCTION | |
2769 | ||
2770 | =item QUICK CHECKLIST | |
2771 | ||
2772 | =over 4 | |
2773 | ||
2774 | =item Before you start | |
2775 | ||
2776 | =item The API | |
2777 | ||
2778 | =item Stability | |
2779 | ||
2780 | =item Documentation | |
2781 | ||
2782 | =item Release considerations | |
2783 | ||
2784 | =back | |
2785 | ||
2786 | =item BEFORE YOU START WRITING A MODULE | |
2787 | ||
2788 | =over 4 | |
2789 | ||
2790 | =item Has it been done before? | |
2791 | ||
2792 | =item Do one thing and do it well | |
2793 | ||
2794 | =item What's in a name? | |
2795 | ||
2796 | =back | |
2797 | ||
2798 | =item DESIGNING AND WRITING YOUR MODULE | |
2799 | ||
2800 | =over 4 | |
2801 | ||
2802 | =item To OO or not to OO? | |
2803 | ||
2804 | =item Designing your API | |
2805 | ||
2806 | Write simple routines to do simple things, Separate functionality from | |
2807 | output, Provide sensible shortcuts and defaults, Naming conventions, | |
2808 | Parameter passing | |
2809 | ||
2810 | =item Strictness and warnings | |
2811 | ||
2812 | =item Backwards compatibility | |
2813 | ||
2814 | =item Error handling and messages | |
2815 | ||
2816 | =back | |
2817 | ||
2818 | =item DOCUMENTING YOUR MODULE | |
2819 | ||
2820 | =over 4 | |
2821 | ||
2822 | =item POD | |
2823 | ||
2824 | =item README, INSTALL, release notes, changelogs | |
2825 | ||
2826 | =back | |
2827 | ||
2828 | =item RELEASE CONSIDERATIONS | |
2829 | ||
2830 | =over 4 | |
2831 | ||
2832 | =item Version numbering | |
2833 | ||
2834 | =item Pre-requisites | |
2835 | ||
2836 | =item Testing | |
2837 | ||
2838 | =item Packaging | |
2839 | ||
2840 | =item Licensing | |
2841 | ||
2842 | =back | |
2843 | ||
2844 | =item COMMON PITFALLS | |
2845 | ||
2846 | =over 4 | |
2847 | ||
2848 | =item Reinventing the wheel | |
2849 | ||
2850 | =item Trying to do too much | |
2851 | ||
2852 | =item Inappropriate documentation | |
2853 | ||
2854 | =back | |
2855 | ||
2856 | =item SEE ALSO | |
2857 | ||
2858 | L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools, | |
2859 | http://pause.perl.org/, Any good book on software engineering | |
2860 | ||
2861 | =item AUTHOR | |
2862 | ||
2863 | =back | |
2864 | ||
2865 | =head2 perlnewmod - preparing a new module for distribution | |
2866 | ||
2867 | =over 4 | |
2868 | ||
2869 | =item DESCRIPTION | |
2870 | ||
2871 | =over 4 | |
2872 | ||
2873 | =item Warning | |
2874 | ||
2875 | =item What should I make into a module? | |
2876 | ||
2877 | =item Step-by-step: Preparing the ground | |
2878 | ||
2879 | Look around, Check it's new, Discuss the need, Choose a name, Check again | |
2880 | ||
2881 | =item Step-by-step: Making the module | |
2882 | ||
2883 | Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use | |
2884 | L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old | |
2885 | documentation|perlpod>, Write tests, Write the README | |
2886 | ||
2887 | =item Step-by-step: Distributing your module | |
2888 | ||
2889 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the | |
2890 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
2891 | ||
2892 | =back | |
2893 | ||
2894 | =item AUTHOR | |
2895 | ||
2896 | =item SEE ALSO | |
2897 | ||
2898 | =back | |
2899 | ||
2900 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date: | |
2901 | 2002/04/07 18:46:13 $) | |
2902 | ||
2903 | =over 4 | |
2904 | ||
2905 | =item DESCRIPTION | |
2906 | ||
2907 | =over 4 | |
2908 | ||
2909 | =item What is Perl? | |
2910 | ||
2911 | =item Who supports Perl? Who develops it? Why is it free? | |
2912 | ||
2913 | =item Which version of Perl should I use? | |
2914 | ||
2915 | =item What are perl4 and perl5? | |
2916 | ||
2917 | =item What is perl6? | |
2918 | ||
2919 | =item How stable is Perl? | |
2920 | ||
2921 | =item Is Perl difficult to learn? | |
2922 | ||
2923 | =item How does Perl compare with other languages like Java, Python, REXX, | |
2924 | Scheme, or Tcl? | |
2925 | ||
2926 | =item Can I do [task] in Perl? | |
2927 | ||
2928 | =item When shouldn't I program in Perl? | |
2929 | ||
2930 | =item What's the difference between "perl" and "Perl"? | |
2931 | ||
2932 | =item Is it a Perl program or a Perl script? | |
2933 | ||
2934 | =item What is a JAPH? | |
2935 | ||
2936 | =item Where can I get a list of Larry Wall witticisms? | |
2937 | ||
2938 | =item How can I convince my sysadmin/supervisor/employees to use version | |
2939 | 5/5.6.1/Perl instead of some other language? | |
2940 | ||
2941 | =back | |
2942 | ||
2943 | =item AUTHOR AND COPYRIGHT | |
2944 | ||
2945 | =back | |
2946 | ||
2947 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $, | |
2948 | $Date: 2002/04/26 16:56:35 $) | |
2949 | ||
2950 | =over 4 | |
2951 | ||
2952 | =item DESCRIPTION | |
2953 | ||
2954 | =over 4 | |
2955 | ||
2956 | =item What machines support Perl? Where do I get it? | |
2957 | ||
2958 | =item How can I get a binary version of Perl? | |
2959 | ||
2960 | =item I don't have a C compiler on my system. How can I compile perl? | |
2961 | ||
2962 | =item I copied the Perl binary from one machine to another, but scripts | |
2963 | don't work. | |
2964 | ||
2965 | =item I grabbed the sources and tried to compile but gdbm/dynamic | |
2966 | loading/malloc/linking/... failed. How do I make it work? | |
2967 | ||
2968 | =item What modules and extensions are available for Perl? What is CPAN? | |
2969 | What does CPAN/src/... mean? | |
2970 | ||
2971 | =item Is there an ISO or ANSI certified version of Perl? | |
2972 | ||
2973 | =item Where can I get information on Perl? | |
2974 | ||
2975 | =item What are the Perl newsgroups on Usenet? Where do I post questions? | |
2976 | ||
2977 | =item Where should I post source code? | |
2978 | ||
2979 | =item Perl Books | |
2980 | ||
2981 | References, Tutorials, Task-Oriented, Special Topics | |
2982 | ||
2983 | =item Perl in Magazines | |
2984 | ||
2985 | =item Perl on the Net: FTP and WWW Access | |
2986 | ||
2987 | =item What mailing lists are there for Perl? | |
2988 | ||
2989 | =item Archives of comp.lang.perl.misc | |
2990 | ||
2991 | =item Where can I buy a commercial version of Perl? | |
2992 | ||
2993 | =item Where do I send bug reports? | |
2994 | ||
2995 | =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? | |
2996 | ||
2997 | =back | |
2998 | ||
2999 | =item AUTHOR AND COPYRIGHT | |
3000 | ||
3001 | =back | |
3002 | ||
3003 | =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06 | |
3004 | 13:11:13 $) | |
3005 | ||
3006 | =over 4 | |
3007 | ||
3008 | =item DESCRIPTION | |
3009 | ||
3010 | =over 4 | |
3011 | ||
3012 | =item How do I do (anything)? | |
3013 | ||
3014 | =item How can I use Perl interactively? | |
3015 | ||
3016 | =item Is there a Perl shell? | |
3017 | ||
3018 | =item How do I debug my Perl programs? | |
3019 | ||
3020 | =item How do I profile my Perl programs? | |
3021 | ||
3022 | =item How do I cross-reference my Perl programs? | |
3023 | ||
3024 | =item Is there a pretty-printer (formatter) for Perl? | |
3025 | ||
3026 | =item Is there a ctags for Perl? | |
3027 | ||
3028 | =item Is there an IDE or Windows Perl Editor? | |
3029 | ||
3030 | Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl, | |
3031 | CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, | |
3032 | MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha | |
3033 | ||
3034 | =item Where can I get Perl macros for vi? | |
3035 | ||
3036 | =item Where can I get perl-mode for emacs? | |
3037 | ||
3038 | =item How can I use curses with Perl? | |
3039 | ||
3040 | =item How can I use X or Tk with Perl? | |
3041 | ||
3042 | =item How can I generate simple menus without using CGI or Tk? | |
3043 | ||
3044 | =item How can I make my Perl program run faster? | |
3045 | ||
3046 | =item How can I make my Perl program take less memory? | |
3047 | ||
3048 | Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and | |
3049 | stringification, Pass by reference, Tie large variables to disk | |
3050 | ||
3051 | =item Is it unsafe to return a pointer to local data? | |
3052 | ||
3053 | =item How can I free an array or hash so my program shrinks? | |
3054 | ||
3055 | =item How can I make my CGI script more efficient? | |
3056 | ||
3057 | =item How can I hide the source for my Perl program? | |
3058 | ||
3059 | =item How can I compile my Perl program into byte code or C? | |
3060 | ||
3061 | =item How can I compile Perl into Java? | |
3062 | ||
3063 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? | |
3064 | ||
3065 | =item Can I write useful Perl programs on the command line? | |
3066 | ||
3067 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? | |
3068 | ||
3069 | =item Where can I learn about CGI or Web programming in Perl? | |
3070 | ||
3071 | =item Where can I learn about object-oriented Perl programming? | |
3072 | ||
3073 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] | |
3074 | ||
3075 | =item I've read perlembed, perlguts, etc., but I can't embed perl in | |
3076 | my C program; what am I doing wrong? | |
3077 | ||
3078 | =item When I tried to run my script, I got this message. What does it mean? | |
3079 | ||
3080 | =item What's MakeMaker? | |
3081 | ||
3082 | =back | |
3083 | ||
3084 | =item AUTHOR AND COPYRIGHT | |
3085 | ||
3086 | =back | |
3087 | ||
3088 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30 | |
3089 | 07:04:25 $) | |
3090 | ||
3091 | =over 4 | |
3092 | ||
3093 | =item DESCRIPTION | |
3094 | ||
3095 | =item Data: Numbers | |
3096 | ||
3097 | =over 4 | |
3098 | ||
3099 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the | |
3100 | numbers I should be getting (eg, 19.95)? | |
3101 | ||
3102 | =item Why isn't my octal data interpreted correctly? | |
3103 | ||
3104 | =item Does Perl have a round() function? What about ceil() and floor()? | |
3105 | Trig functions? | |
3106 | ||
3107 | =item How do I convert between numeric representations? | |
3108 | ||
3109 | How do I convert hexadecimal into decimal, How do I convert from decimal to | |
3110 | hexadecimal, How do I convert from octal to decimal, How do I convert from | |
3111 | decimal to octal, How do I convert from binary to decimal, How do I convert | |
3112 | from decimal to binary | |
3113 | ||
3114 | =item Why doesn't & work the way I want it to? | |
3115 | ||
3116 | =item How do I multiply matrices? | |
3117 | ||
3118 | =item How do I perform an operation on a series of integers? | |
3119 | ||
3120 | =item How can I output Roman numerals? | |
3121 | ||
3122 | =item Why aren't my random numbers random? | |
3123 | ||
3124 | =item How do I get a random number between X and Y? | |
3125 | ||
3126 | =back | |
3127 | ||
3128 | =item Data: Dates | |
3129 | ||
3130 | =over 4 | |
3131 | ||
3132 | =item How do I find the week-of-the-year/day-of-the-year? | |
3133 | ||
3134 | =item How do I find the current century or millennium? | |
3135 | ||
3136 | =item How can I compare two dates and find the difference? | |
3137 | ||
3138 | =item How can I take a string and turn it into epoch seconds? | |
3139 | ||
3140 | =item How can I find the Julian Day? | |
3141 | ||
3142 | =item How do I find yesterday's date? | |
3143 | ||
3144 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? | |
3145 | ||
3146 | =back | |
3147 | ||
3148 | =item Data: Strings | |
3149 | ||
3150 | =over 4 | |
3151 | ||
3152 | =item How do I validate input? | |
3153 | ||
3154 | =item How do I unescape a string? | |
3155 | ||
3156 | =item How do I remove consecutive pairs of characters? | |
3157 | ||
3158 | =item How do I expand function calls in a string? | |
3159 | ||
3160 | =item How do I find matching/nesting anything? | |
3161 | ||
3162 | =item How do I reverse a string? | |
3163 | ||
3164 | =item How do I expand tabs in a string? | |
3165 | ||
3166 | =item How do I reformat a paragraph? | |
3167 | ||
3168 | =item How can I access/change the first N letters of a string? | |
3169 | ||
3170 | =item How do I change the Nth occurrence of something? | |
3171 | ||
3172 | =item How can I count the number of occurrences of a substring within a | |
3173 | string? | |
3174 | ||
3175 | =item How do I capitalize all the words on one line? | |
3176 | ||
3177 | =item How can I split a [character] delimited string except when inside | |
3178 | [character]? (Comma-separated files) | |
3179 | ||
3180 | =item How do I strip blank space from the beginning/end of a string? | |
3181 | ||
3182 | =item How do I pad a string with blanks or pad a number with zeroes? | |
3183 | ||
3184 | =item How do I extract selected columns from a string? | |
3185 | ||
3186 | =item How do I find the soundex value of a string? | |
3187 | ||
3188 | =item How can I expand variables in text strings? | |
3189 | ||
3190 | =item What's wrong with always quoting "$vars"? | |
3191 | ||
3192 | =item Why don't my <<HERE documents work? | |
3193 | ||
3194 | 1. There must be no space after the << part, 2. There (probably) should be | |
3195 | a semicolon at the end, 3. You can't (easily) have any space in front of | |
3196 | the tag | |
3197 | ||
3198 | =back | |
3199 | ||
3200 | =item Data: Arrays | |
3201 | ||
3202 | =over 4 | |
3203 | ||
3204 | =item What is the difference between a list and an array? | |
3205 | ||
3206 | =item What is the difference between $array[1] and @array[1]? | |
3207 | ||
3208 | =item How can I remove duplicate elements from a list or array? | |
3209 | ||
3210 | a), b), c), d), e) | |
3211 | ||
3212 | =item How can I tell whether a certain element is contained in a list or | |
3213 | array? | |
3214 | ||
3215 | =item How do I compute the difference of two arrays? How do I compute the | |
3216 | intersection of two arrays? | |
3217 | ||
3218 | =item How do I test whether two arrays or hashes are equal? | |
3219 | ||
3220 | =item How do I find the first array element for which a condition is true? | |
3221 | ||
3222 | =item How do I handle linked lists? | |
3223 | ||
3224 | =item How do I handle circular lists? | |
3225 | ||
3226 | =item How do I shuffle an array randomly? | |
3227 | ||
3228 | =item How do I process/modify each element of an array? | |
3229 | ||
3230 | =item How do I select a random element from an array? | |
3231 | ||
3232 | =item How do I permute N elements of a list? | |
3233 | ||
3234 | =item How do I sort an array by (anything)? | |
3235 | ||
3236 | =item How do I manipulate arrays of bits? | |
3237 | ||
3238 | =item Why does defined() return true on empty arrays and hashes? | |
3239 | ||
3240 | =back | |
3241 | ||
3242 | =item Data: Hashes (Associative Arrays) | |
3243 | ||
3244 | =over 4 | |
3245 | ||
3246 | =item How do I process an entire hash? | |
3247 | ||
3248 | =item What happens if I add or remove keys from a hash while iterating over | |
3249 | it? | |
3250 | ||
3251 | =item How do I look up a hash element by value? | |
3252 | ||
3253 | =item How can I know how many entries are in a hash? | |
3254 | ||
3255 | =item How do I sort a hash (optionally by value instead of key)? | |
3256 | ||
3257 | =item How can I always keep my hash sorted? | |
3258 | ||
3259 | =item What's the difference between "delete" and "undef" with hashes? | |
3260 | ||
3261 | =item Why don't my tied hashes make the defined/exists distinction? | |
3262 | ||
3263 | =item How do I reset an each() operation part-way through? | |
3264 | ||
3265 | =item How can I get the unique keys from two hashes? | |
3266 | ||
3267 | =item How can I store a multidimensional array in a DBM file? | |
3268 | ||
3269 | =item How can I make my hash remember the order I put elements into it? | |
3270 | ||
3271 | =item Why does passing a subroutine an undefined element in a hash create | |
3272 | it? | |
3273 | ||
3274 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or | |
3275 | array of hashes or arrays? | |
3276 | ||
3277 | =item How can I use a reference as a hash key? | |
3278 | ||
3279 | =back | |
3280 | ||
3281 | =item Data: Misc | |
3282 | ||
3283 | =over 4 | |
3284 | ||
3285 | =item How do I handle binary data correctly? | |
3286 | ||
3287 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
3288 | ||
3289 | =item How do I keep persistent data across program calls? | |
3290 | ||
3291 | =item How do I print out or copy a recursive data structure? | |
3292 | ||
3293 | =item How do I define methods for every class/object? | |
3294 | ||
3295 | =item How do I verify a credit card checksum? | |
3296 | ||
3297 | =item How do I pack arrays of doubles or floats for XS code? | |
3298 | ||
3299 | =back | |
3300 | ||
3301 | =item AUTHOR AND COPYRIGHT | |
3302 | ||
3303 | =back | |
3304 | ||
3305 | =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30 | |
3306 | 07:04:25 $) | |
3307 | ||
3308 | =over 4 | |
3309 | ||
3310 | =item DESCRIPTION | |
3311 | ||
3312 | =over 4 | |
3313 | ||
3314 | =item How do I flush/unbuffer an output filehandle? Why must I do this? | |
3315 | ||
3316 | =item How do I change one line in a file/delete a line in a file/insert a | |
3317 | line in the middle of a file/append to the beginning of a file? | |
3318 | ||
3319 | =item How do I count the number of lines in a file? | |
3320 | ||
3321 | =item How do I make a temporary file name? | |
3322 | ||
3323 | =item How can I manipulate fixed-record-length files? | |
3324 | ||
3325 | =item How can I make a filehandle local to a subroutine? How do I pass | |
3326 | filehandles between subroutines? How do I make an array of filehandles? | |
3327 | ||
3328 | =item How can I use a filehandle indirectly? | |
3329 | ||
3330 | =item How can I set up a footer format to be used with write()? | |
3331 | ||
3332 | =item How can I write() into a string? | |
3333 | ||
3334 | =item How can I output my numbers with commas added? | |
3335 | ||
3336 | =item How can I translate tildes (~) in a filename? | |
3337 | ||
3338 | =item How come when I open a file read-write it wipes it out? | |
3339 | ||
3340 | =item Why do I sometimes get an "Argument list too long" when I use <*>? | |
3341 | ||
3342 | =item Is there a leak/bug in glob()? | |
3343 | ||
3344 | =item How can I open a file with a leading ">" or trailing blanks? | |
3345 | ||
3346 | =item How can I reliably rename a file? | |
3347 | ||
3348 | =item How can I lock a file? | |
3349 | ||
3350 | =item Why can't I just open(FH, ">file.lock")? | |
3351 | ||
3352 | =item I still don't get locking. I just want to increment the number in | |
3353 | the file. How can I do this? | |
3354 | ||
3355 | =item All I want to do is append a small amount of text to the end of a | |
3356 | file. Do I still have to use locking? | |
3357 | ||
3358 | =item How do I randomly update a binary file? | |
3359 | ||
3360 | =item How do I get a file's timestamp in perl? | |
3361 | ||
3362 | =item How do I set a file's timestamp in perl? | |
3363 | ||
3364 | =item How do I print to more than one file at once? | |
3365 | ||
3366 | =item How can I read in an entire file all at once? | |
3367 | ||
3368 | =item How can I read in a file by paragraphs? | |
3369 | ||
3370 | =item How can I read a single character from a file? From the keyboard? | |
3371 | ||
3372 | =item How can I tell whether there's a character waiting on a filehandle? | |
3373 | ||
3374 | =item How do I do a C<tail -f> in perl? | |
3375 | ||
3376 | =item How do I dup() a filehandle in Perl? | |
3377 | ||
3378 | =item How do I close a file descriptor by number? | |
3379 | ||
3380 | =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't | |
3381 | `C:\temp\foo.exe` work? | |
3382 | ||
3383 | =item Why doesn't glob("*.*") get all the files? | |
3384 | ||
3385 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber | |
3386 | protected files? Isn't this a bug in Perl? | |
3387 | ||
3388 | =item How do I select a random line from a file? | |
3389 | ||
3390 | =item Why do I get weird spaces when I print an array of lines? | |
3391 | ||
3392 | =back | |
3393 | ||
3394 | =item AUTHOR AND COPYRIGHT | |
3395 | ||
3396 | =back | |
3397 | ||
3398 | =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01 | |
3399 | 22:31:09 $) | |
3400 | ||
3401 | =over 4 | |
3402 | ||
3403 | =item DESCRIPTION | |
3404 | ||
3405 | =over 4 | |
3406 | ||
3407 | =item How can I hope to use regular expressions without creating illegible | |
3408 | and unmaintainable code? | |
3409 | ||
3410 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters | |
3411 | ||
3412 | =item I'm having trouble matching over more than one line. What's wrong? | |
3413 | ||
3414 | =item How can I pull out lines between two patterns that are themselves on | |
3415 | different lines? | |
3416 | ||
3417 | =item I put a regular expression into $/ but it didn't work. What's wrong? | |
3418 | ||
3419 | =item How do I substitute case insensitively on the LHS while preserving | |
3420 | case on the RHS? | |
3421 | ||
3422 | =item How can I make C<\w> match national character sets? | |
3423 | ||
3424 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? | |
3425 | ||
3426 | =item How can I quote a variable to use in a regex? | |
3427 | ||
3428 | =item What is C</o> really for? | |
3429 | ||
3430 | =item How do I use a regular expression to strip C style comments from a | |
3431 | file? | |
3432 | ||
3433 | =item Can I use Perl regular expressions to match balanced text? | |
3434 | ||
3435 | =item What does it mean that regexes are greedy? How can I get around it? | |
3436 | ||
3437 | =item How do I process each word on each line? | |
3438 | ||
3439 | =item How can I print out a word-frequency or line-frequency summary? | |
3440 | ||
3441 | =item How can I do approximate matching? | |
3442 | ||
3443 | =item How do I efficiently match many regular expressions at once? | |
3444 | ||
3445 | =item Why don't word-boundary searches with C<\b> work for me? | |
3446 | ||
3447 | =item Why does using $&, $`, or $' slow my program down? | |
3448 | ||
3449 | =item What good is C<\G> in a regular expression? | |
3450 | ||
3451 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? | |
3452 | ||
3453 | =item What's wrong with using grep or map in a void context? | |
3454 | ||
3455 | =item How can I match strings with multibyte characters? | |
3456 | ||
3457 | =item How do I match a pattern that is supplied by the user? | |
3458 | ||
3459 | =back | |
3460 | ||
3461 | =item AUTHOR AND COPYRIGHT | |
3462 | ||
3463 | =back | |
3464 | ||
3465 | =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date: | |
3466 | 2002/03/26 15:48:32 $) | |
3467 | ||
3468 | =over 4 | |
3469 | ||
3470 | =item DESCRIPTION | |
3471 | ||
3472 | =over 4 | |
3473 | ||
3474 | =item Can I get a BNF/yacc/RE for the Perl language? | |
3475 | ||
3476 | =item What are all these $@%&* punctuation signs, and how do I know when to | |
3477 | use them? | |
3478 | ||
3479 | =item Do I always/never have to quote my strings or use semicolons and | |
3480 | commas? | |
3481 | ||
3482 | =item How do I skip some return values? | |
3483 | ||
3484 | =item How do I temporarily block warnings? | |
3485 | ||
3486 | =item What's an extension? | |
3487 | ||
3488 | =item Why do Perl operators have different precedence than C operators? | |
3489 | ||
3490 | =item How do I declare/create a structure? | |
3491 | ||
3492 | =item How do I create a module? | |
3493 | ||
3494 | =item How do I create a class? | |
3495 | ||
3496 | =item How can I tell if a variable is tainted? | |
3497 | ||
3498 | =item What's a closure? | |
3499 | ||
3500 | =item What is variable suicide and how can I prevent it? | |
3501 | ||
3502 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, | |
3503 | Regex}? | |
3504 | ||
3505 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, | |
3506 | Passing Methods | |
3507 | ||
3508 | =item How do I create a static variable? | |
3509 | ||
3510 | =item What's the difference between dynamic and lexical (static) scoping? | |
3511 | Between local() and my()? | |
3512 | ||
3513 | =item How can I access a dynamic variable while a similarly named lexical | |
3514 | is in scope? | |
3515 | ||
3516 | =item What's the difference between deep and shallow binding? | |
3517 | ||
3518 | =item Why doesn't "my($foo) = <FILE>;" work right? | |
3519 | ||
3520 | =item How do I redefine a builtin function, operator, or method? | |
3521 | ||
3522 | =item What's the difference between calling a function as &foo and foo()? | |
3523 | ||
3524 | =item How do I create a switch or case statement? | |
3525 | ||
3526 | =item How can I catch accesses to undefined variables/functions/methods? | |
3527 | ||
3528 | =item Why can't a method included in this same file be found? | |
3529 | ||
3530 | =item How can I find out my current package? | |
3531 | ||
3532 | =item How can I comment out a large block of perl code? | |
3533 | ||
3534 | =item How do I clear a package? | |
3535 | ||
3536 | =item How can I use a variable as a variable name? | |
3537 | ||
3538 | =back | |
3539 | ||
3540 | =item AUTHOR AND COPYRIGHT | |
3541 | ||
3542 | =back | |
3543 | ||
3544 | =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16 | |
3545 | 12:41:42 $) | |
3546 | ||
3547 | =over 4 | |
3548 | ||
3549 | =item DESCRIPTION | |
3550 | ||
3551 | =over 4 | |
3552 | ||
3553 | =item How do I find out which operating system I'm running under? | |
3554 | ||
3555 | =item How come exec() doesn't return? | |
3556 | ||
3557 | =item How do I do fancy stuff with the keyboard/screen/mouse? | |
3558 | ||
3559 | Keyboard, Screen, Mouse | |
3560 | ||
3561 | =item How do I print something out in color? | |
3562 | ||
3563 | =item How do I read just one key without waiting for a return key? | |
3564 | ||
3565 | =item How do I check whether input is ready on the keyboard? | |
3566 | ||
3567 | =item How do I clear the screen? | |
3568 | ||
3569 | =item How do I get the screen size? | |
3570 | ||
3571 | =item How do I ask the user for a password? | |
3572 | ||
3573 | =item How do I read and write the serial port? | |
3574 | ||
3575 | lockfiles, open mode, end of line, flushing output, non-blocking input | |
3576 | ||
3577 | =item How do I decode encrypted password files? | |
3578 | ||
3579 | =item How do I start a process in the background? | |
3580 | ||
3581 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies | |
3582 | ||
3583 | =item How do I trap control characters/signals? | |
3584 | ||
3585 | =item How do I modify the shadow password file on a Unix system? | |
3586 | ||
3587 | =item How do I set the time and date? | |
3588 | ||
3589 | =item How can I sleep() or alarm() for under a second? | |
3590 | ||
3591 | =item How can I measure time under a second? | |
3592 | ||
3593 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) | |
3594 | ||
3595 | =item Why doesn't my sockets program work under System V (Solaris)? What | |
3596 | does the error message "Protocol not supported" mean? | |
3597 | ||
3598 | =item How can I call my system's unique C functions from Perl? | |
3599 | ||
3600 | =item Where do I get the include files to do ioctl() or syscall()? | |
3601 | ||
3602 | =item Why do setuid perl scripts complain about kernel problems? | |
3603 | ||
3604 | =item How can I open a pipe both to and from a command? | |
3605 | ||
3606 | =item Why can't I get the output of a command with system()? | |
3607 | ||
3608 | =item How can I capture STDERR from an external command? | |
3609 | ||
3610 | =item Why doesn't open() return an error when a pipe open fails? | |
3611 | ||
3612 | =item What's wrong with using backticks in a void context? | |
3613 | ||
3614 | =item How can I call backticks without shell processing? | |
3615 | ||
3616 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, | |
3617 | ^Z on MS-DOS)? | |
3618 | ||
3619 | =item How can I convert my shell script to perl? | |
3620 | ||
3621 | =item Can I use perl to run a telnet or ftp session? | |
3622 | ||
3623 | =item How can I write expect in Perl? | |
3624 | ||
3625 | =item Is there a way to hide perl's command line from programs such as | |
3626 | "ps"? | |
3627 | ||
3628 | =item I {changed directory, modified my environment} in a perl script. How | |
3629 | come the change disappeared when I exited the script? How do I get my | |
3630 | changes to be visible? | |
3631 | ||
3632 | Unix | |
3633 | ||
3634 | =item How do I close a process's filehandle without waiting for it to | |
3635 | complete? | |
3636 | ||
3637 | =item How do I fork a daemon process? | |
3638 | ||
3639 | =item How do I find out if I'm running interactively or not? | |
3640 | ||
3641 | =item How do I timeout a slow event? | |
3642 | ||
3643 | =item How do I set CPU limits? | |
3644 | ||
3645 | =item How do I avoid zombies on a Unix system? | |
3646 | ||
3647 | =item How do I use an SQL database? | |
3648 | ||
3649 | =item How do I make a system() exit on control-C? | |
3650 | ||
3651 | =item How do I open a file without blocking? | |
3652 | ||
3653 | =item How do I install a module from CPAN? | |
3654 | ||
3655 | =item What's the difference between require and use? | |
3656 | ||
3657 | =item How do I keep my own module/library directory? | |
3658 | ||
3659 | =item How do I add the directory my program lives in to the module/library | |
3660 | search path? | |
3661 | ||
3662 | =item How do I add a directory to my include path at runtime? | |
3663 | ||
3664 | =item What is socket.ph and where do I get it? | |
3665 | ||
3666 | =back | |
3667 | ||
3668 | =item AUTHOR AND COPYRIGHT | |
3669 | ||
3670 | =back | |
3671 | ||
3672 | =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13 | |
3673 | $) | |
3674 | ||
3675 | =over 4 | |
3676 | ||
3677 | =item DESCRIPTION | |
3678 | ||
3679 | =over 4 | |
3680 | ||
3681 | =item What is the correct form of response from a CGI script? | |
3682 | ||
3683 | =item My CGI script runs from the command line but not the browser. (500 | |
3684 | Server Error) | |
3685 | ||
3686 | =item How can I get better error messages from a CGI program? | |
3687 | ||
3688 | =item How do I remove HTML from a string? | |
3689 | ||
3690 | =item How do I extract URLs? | |
3691 | ||
3692 | =item How do I download a file from the user's machine? How do I open a | |
3693 | file on another machine? | |
3694 | ||
3695 | =item How do I make a pop-up menu in HTML? | |
3696 | ||
3697 | =item How do I fetch an HTML file? | |
3698 | ||
3699 | =item How do I automate an HTML form submission? | |
3700 | ||
3701 | =item How do I decode or create those %-encodings on the web? | |
3702 | ||
3703 | =item How do I redirect to another page? | |
3704 | ||
3705 | =item How do I put a password on my web pages? | |
3706 | ||
3707 | =item How do I edit my .htpasswd and .htgroup files with Perl? | |
3708 | ||
3709 | =item How do I make sure users can't enter values into a form that cause my | |
3710 | CGI script to do bad things? | |
3711 | ||
3712 | =item How do I parse a mail header? | |
3713 | ||
3714 | =item How do I decode a CGI form? | |
3715 | ||
3716 | =item How do I check a valid mail address? | |
3717 | ||
3718 | =item How do I decode a MIME/BASE64 string? | |
3719 | ||
3720 | =item How do I return the user's mail address? | |
3721 | ||
3722 | =item How do I send mail? | |
3723 | ||
3724 | =item How do I use MIME to make an attachment to a mail message? | |
3725 | ||
3726 | =item How do I read mail? | |
3727 | ||
3728 | =item How do I find out my hostname/domainname/IP address? | |
3729 | ||
3730 | =item How do I fetch a news article or the active newsgroups? | |
3731 | ||
3732 | =item How do I fetch/put an FTP file? | |
3733 | ||
3734 | =item How can I do RPC in Perl? | |
3735 | ||
3736 | =back | |
3737 | ||
3738 | =item AUTHOR AND COPYRIGHT | |
3739 | ||
3740 | =back | |
3741 | ||
3742 | =head2 perlcompile - Introduction to the Perl Compiler-Translator | |
3743 | ||
3744 | =over 4 | |
3745 | ||
3746 | =item DESCRIPTION | |
3747 | ||
3748 | =over 4 | |
3749 | ||
3750 | =item Layout | |
3751 | ||
3752 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref | |
3753 | ||
3754 | =back | |
3755 | ||
3756 | =item Using The Back Ends | |
3757 | ||
3758 | =over 4 | |
3759 | ||
3760 | =item The Cross Referencing Back End | |
3761 | ||
3762 | i, &, s, r | |
3763 | ||
3764 | =item The Decompiling Back End | |
3765 | ||
3766 | =item The Lint Back End | |
3767 | ||
3768 | =item The Simple C Back End | |
3769 | ||
3770 | =item The Bytecode Back End | |
3771 | ||
3772 | =item The Optimized C Back End | |
3773 | ||
3774 | =back | |
3775 | ||
3776 | =item Module List for the Compiler Suite | |
3777 | ||
3778 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, | |
3779 | B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, | |
3780 | B::Stackobj, B::Stash, B::Terse, B::Xref | |
3781 | ||
3782 | =item KNOWN PROBLEMS | |
3783 | ||
3784 | =item AUTHOR | |
3785 | ||
3786 | =back | |
3787 | ||
3788 | =head2 perlembed - how to embed perl in your C program | |
3789 | ||
3790 | =over 4 | |
3791 | ||
3792 | =item DESCRIPTION | |
3793 | ||
3794 | =over 4 | |
3795 | ||
3796 | =item PREAMBLE | |
3797 | ||
3798 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from | |
3799 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
3800 | ||
3801 | =item ROADMAP | |
3802 | ||
3803 | =item Compiling your C program | |
3804 | ||
3805 | =item Adding a Perl interpreter to your C program | |
3806 | ||
3807 | =item Calling a Perl subroutine from your C program | |
3808 | ||
3809 | =item Evaluating a Perl statement from your C program | |
3810 | ||
3811 | =item Performing Perl pattern matches and substitutions from your C program | |
3812 | ||
3813 | =item Fiddling with the Perl stack from your C program | |
3814 | ||
3815 | =item Maintaining a persistent interpreter | |
3816 | ||
3817 | =item Execution of END blocks | |
3818 | ||
3819 | =item Maintaining multiple interpreter instances | |
3820 | ||
3821 | =item Using Perl modules, which themselves use C libraries, from your C | |
3822 | program | |
3823 | ||
3824 | =back | |
3825 | ||
3826 | =item Embedding Perl under Win32 | |
3827 | ||
3828 | =item MORAL | |
3829 | ||
3830 | =item AUTHOR | |
3831 | ||
3832 | =item COPYRIGHT | |
3833 | ||
3834 | =back | |
3835 | ||
3836 | =head2 perldebguts - Guts of Perl debugging | |
3837 | ||
3838 | =over 4 | |
3839 | ||
3840 | =item DESCRIPTION | |
3841 | ||
3842 | =item Debugger Internals | |
3843 | ||
3844 | =over 4 | |
3845 | ||
3846 | =item Writing Your Own Debugger | |
3847 | ||
3848 | =back | |
3849 | ||
3850 | =item Frame Listing Output Examples | |
3851 | ||
3852 | =item Debugging regular expressions | |
3853 | ||
3854 | =over 4 | |
3855 | ||
3856 | =item Compile-time output | |
3857 | ||
3858 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> | |
3859 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
3860 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
3861 | C<anchored(TYPE)> | |
3862 | ||
3863 | =item Types of nodes | |
3864 | ||
3865 | =item Run-time output | |
3866 | ||
3867 | =back | |
3868 | ||
3869 | =item Debugging Perl memory usage | |
3870 | ||
3871 | =over 4 | |
3872 | ||
3873 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> | |
3874 | ||
3875 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): | |
3876 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
3877 | 6144> | |
3878 | ||
3879 | =item Example of using B<-DL> switch | |
3880 | ||
3881 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> | |
3882 | ||
3883 | =item B<-DL> details | |
3884 | ||
3885 | C<!!!>, C<!!>, C<!> | |
3886 | ||
3887 | =item Limitations of B<-DL> statistics | |
3888 | ||
3889 | =back | |
3890 | ||
3891 | =item SEE ALSO | |
3892 | ||
3893 | =back | |
3894 | ||
3895 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs | |
3896 | ||
3897 | =over 4 | |
3898 | ||
3899 | =item DESCRIPTION | |
3900 | ||
3901 | =item SPECIAL NOTES | |
3902 | ||
3903 | =over 4 | |
3904 | ||
3905 | =item make | |
3906 | ||
3907 | =item Version caveat | |
3908 | ||
3909 | =item Dynamic Loading versus Static Loading | |
3910 | ||
3911 | =back | |
3912 | ||
3913 | =item TUTORIAL | |
3914 | ||
3915 | =over 4 | |
3916 | ||
3917 | =item EXAMPLE 1 | |
3918 | ||
3919 | =item EXAMPLE 2 | |
3920 | ||
3921 | =item What has gone on? | |
3922 | ||
3923 | =item Writing good test scripts | |
3924 | ||
3925 | =item EXAMPLE 3 | |
3926 | ||
3927 | =item What's new here? | |
3928 | ||
3929 | =item Input and Output Parameters | |
3930 | ||
3931 | =item The XSUBPP Program | |
3932 | ||
3933 | =item The TYPEMAP file | |
3934 | ||
3935 | =item Warning about Output Arguments | |
3936 | ||
3937 | =item EXAMPLE 4 | |
3938 | ||
3939 | =item What has happened here? | |
3940 | ||
3941 | =item Anatomy of .xs file | |
3942 | ||
3943 | =item Getting the fat out of XSUBs | |
3944 | ||
3945 | =item More about XSUB arguments | |
3946 | ||
3947 | =item The Argument Stack | |
3948 | ||
3949 | =item Extending your Extension | |
3950 | ||
3951 | =item Documenting your Extension | |
3952 | ||
3953 | =item Installing your Extension | |
3954 | ||
3955 | =item EXAMPLE 5 | |
3956 | ||
3957 | =item New Things in this Example | |
3958 | ||
3959 | =item EXAMPLE 6 | |
3960 | ||
3961 | =item New Things in this Example | |
3962 | ||
3963 | =item EXAMPLE 7 (Coming Soon) | |
3964 | ||
3965 | =item EXAMPLE 8 (Coming Soon) | |
3966 | ||
3967 | =item EXAMPLE 9 Passing open files to XSes | |
3968 | ||
3969 | =item Troubleshooting these Examples | |
3970 | ||
3971 | =back | |
3972 | ||
3973 | =item See also | |
3974 | ||
3975 | =item Author | |
3976 | ||
3977 | =over 4 | |
3978 | ||
3979 | =item Last Changed | |
3980 | ||
3981 | =back | |
3982 | ||
3983 | =back | |
3984 | ||
3985 | =head2 perlxs - XS language reference manual | |
3986 | ||
3987 | =over 4 | |
3988 | ||
3989 | =item DESCRIPTION | |
3990 | ||
3991 | =over 4 | |
3992 | ||
3993 | =item Introduction | |
3994 | ||
3995 | =item On The Road | |
3996 | ||
3997 | =item The Anatomy of an XSUB | |
3998 | ||
3999 | =item The Argument Stack | |
4000 | ||
4001 | =item The RETVAL Variable | |
4002 | ||
4003 | =item The MODULE Keyword | |
4004 | ||
4005 | =item The PACKAGE Keyword | |
4006 | ||
4007 | =item The PREFIX Keyword | |
4008 | ||
4009 | =item The OUTPUT: Keyword | |
4010 | ||
4011 | =item The NO_OUTPUT Keyword | |
4012 | ||
4013 | =item The CODE: Keyword | |
4014 | ||
4015 | =item The INIT: Keyword | |
4016 | ||
4017 | =item The NO_INIT Keyword | |
4018 | ||
4019 | =item Initializing Function Parameters | |
4020 | ||
4021 | =item Default Parameter Values | |
4022 | ||
4023 | =item The PREINIT: Keyword | |
4024 | ||
4025 | =item The SCOPE: Keyword | |
4026 | ||
4027 | =item The INPUT: Keyword | |
4028 | ||
4029 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords | |
4030 | ||
4031 | =item The C<length(NAME)> Keyword | |
4032 | ||
4033 | =item Variable-length Parameter Lists | |
4034 | ||
4035 | =item The C_ARGS: Keyword | |
4036 | ||
4037 | =item The PPCODE: Keyword | |
4038 | ||
4039 | =item Returning Undef And Empty Lists | |
4040 | ||
4041 | =item The REQUIRE: Keyword | |
4042 | ||
4043 | =item The CLEANUP: Keyword | |
4044 | ||
4045 | =item The POSTCALL: Keyword | |
4046 | ||
4047 | =item The BOOT: Keyword | |
4048 | ||
4049 | =item The VERSIONCHECK: Keyword | |
4050 | ||
4051 | =item The PROTOTYPES: Keyword | |
4052 | ||
4053 | =item The PROTOTYPE: Keyword | |
4054 | ||
4055 | =item The ALIAS: Keyword | |
4056 | ||
4057 | =item The OVERLOAD: Keyword | |
4058 | ||
4059 | =item The INTERFACE: Keyword | |
4060 | ||
4061 | =item The INTERFACE_MACRO: Keyword | |
4062 | ||
4063 | =item The INCLUDE: Keyword | |
4064 | ||
4065 | =item The CASE: Keyword | |
4066 | ||
4067 | =item The & Unary Operator | |
4068 | ||
4069 | =item Inserting POD, Comments and C Preprocessor Directives | |
4070 | ||
4071 | =item Using XS With C++ | |
4072 | ||
4073 | =item Interface Strategy | |
4074 | ||
4075 | =item Perl Objects And C Structures | |
4076 | ||
4077 | =item The Typemap | |
4078 | ||
4079 | =item Safely Storing Static Data in XS | |
4080 | ||
4081 | MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT | |
4082 | ||
4083 | =back | |
4084 | ||
4085 | =item EXAMPLES | |
4086 | ||
4087 | =item XS VERSION | |
4088 | ||
4089 | =item AUTHOR | |
4090 | ||
4091 | =back | |
4092 | ||
4093 | =head2 perlclib - Internal replacements for standard C library functions | |
4094 | ||
4095 | =over 4 | |
4096 | ||
4097 | =item DESCRIPTION | |
4098 | ||
4099 | =over 4 | |
4100 | ||
4101 | =item Conventions | |
4102 | ||
4103 | C<t>, C<p>, C<n>, C<s> | |
4104 | ||
4105 | =item File Operations | |
4106 | ||
4107 | =item File Input and Output | |
4108 | ||
4109 | =item File Positioning | |
4110 | ||
4111 | =item Memory Management and String Handling | |
4112 | ||
4113 | =item Character Class Tests | |
4114 | ||
4115 | =item F<stdlib.h> functions | |
4116 | ||
4117 | =item Miscellaneous functions | |
4118 | ||
4119 | =back | |
4120 | ||
4121 | =item SEE ALSO | |
4122 | ||
4123 | =back | |
4124 | ||
4125 | =head2 perlguts - Introduction to the Perl API | |
4126 | ||
4127 | =over 4 | |
4128 | ||
4129 | =item DESCRIPTION | |
4130 | ||
4131 | =item Variables | |
4132 | ||
4133 | =over 4 | |
4134 | ||
4135 | =item Datatypes | |
4136 | ||
4137 | =item What is an "IV"? | |
4138 | ||
4139 | =item Working with SVs | |
4140 | ||
4141 | =item Offsets | |
4142 | ||
4143 | =item What's Really Stored in an SV? | |
4144 | ||
4145 | =item Working with AVs | |
4146 | ||
4147 | =item Working with HVs | |
4148 | ||
4149 | =item Hash API Extensions | |
4150 | ||
4151 | =item References | |
4152 | ||
4153 | =item Blessed References and Class Objects | |
4154 | ||
4155 | =item Creating New Variables | |
4156 | ||
4157 | GV_ADDMULTI, GV_ADDWARN | |
4158 | ||
4159 | =item Reference Counts and Mortality | |
4160 | ||
4161 | =item Stashes and Globs | |
4162 | ||
4163 | =item Double-Typed SVs | |
4164 | ||
4165 | =item Magic Variables | |
4166 | ||
4167 | =item Assigning Magic | |
4168 | ||
4169 | =item Magic Virtual Tables | |
4170 | ||
4171 | =item Finding Magic | |
4172 | ||
4173 | =item Understanding the Magic of Tied Hashes and Arrays | |
4174 | ||
4175 | =item Localizing changes | |
4176 | ||
4177 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, | |
4178 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV | |
4179 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, | |
4180 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, | |
4181 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, | |
4182 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* | |
4183 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
4184 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
4185 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
4186 | save_hptr(HV **hptr)> | |
4187 | ||
4188 | =back | |
4189 | ||
4190 | =item Subroutines | |
4191 | ||
4192 | =over 4 | |
4193 | ||
4194 | =item XSUBs and the Argument Stack | |
4195 | ||
4196 | =item Calling Perl Routines from within C Programs | |
4197 | ||
4198 | =item Memory Allocation | |
4199 | ||
4200 | =item PerlIO | |
4201 | ||
4202 | =item Putting a C value on Perl stack | |
4203 | ||
4204 | =item Scratchpads | |
4205 | ||
4206 | =item Scratchpads and recursion | |
4207 | ||
4208 | =back | |
4209 | ||
4210 | =item Compiled code | |
4211 | ||
4212 | =over 4 | |
4213 | ||
4214 | =item Code tree | |
4215 | ||
4216 | =item Examining the tree | |
4217 | ||
4218 | =item Compile pass 1: check routines | |
4219 | ||
4220 | =item Compile pass 1a: constant folding | |
4221 | ||
4222 | =item Compile pass 2: context propagation | |
4223 | ||
4224 | =item Compile pass 3: peephole optimization | |
4225 | ||
4226 | =item Pluggable runops | |
4227 | ||
4228 | =back | |
4229 | ||
4230 | =item Examining internal data structures with the C<dump> functions | |
4231 | ||
4232 | =item How multiple interpreters and concurrency are supported | |
4233 | ||
4234 | =over 4 | |
4235 | ||
4236 | =item Background and PERL_IMPLICIT_CONTEXT | |
4237 | ||
4238 | =item So what happened to dTHR? | |
4239 | ||
4240 | =item How do I use all this in extensions? | |
4241 | ||
4242 | =item Should I do anything special if I call perl from multiple threads? | |
4243 | ||
4244 | =item Future Plans and PERL_IMPLICIT_SYS | |
4245 | ||
4246 | =back | |
4247 | ||
4248 | =item Internal Functions | |
4249 | ||
4250 | A, p, d, s, n, r, f, M, o, j, x | |
4251 | ||
4252 | =over 4 | |
4253 | ||
4254 | =item Formatted Printing of IVs, UVs, and NVs | |
4255 | ||
4256 | =item Pointer-To-Integer and Integer-To-Pointer | |
4257 | ||
4258 | =item Source Documentation | |
4259 | ||
4260 | =back | |
4261 | ||
4262 | =item Unicode Support | |
4263 | ||
4264 | =over 4 | |
4265 | ||
4266 | =item What B<is> Unicode, anyway? | |
4267 | ||
4268 | =item How can I recognise a UTF8 string? | |
4269 | ||
4270 | =item How does UTF8 represent Unicode characters? | |
4271 | ||
4272 | =item How does Perl store UTF8 strings? | |
4273 | ||
4274 | =item How do I convert a string to UTF8? | |
4275 | ||
4276 | =item Is there anything else I need to know? | |
4277 | ||
4278 | =back | |
4279 | ||
4280 | =item Custom Operators | |
4281 | ||
4282 | =item AUTHORS | |
4283 | ||
4284 | =item SEE ALSO | |
4285 | ||
4286 | =back | |
4287 | ||
4288 | =head2 perlcall - Perl calling conventions from C | |
4289 | ||
4290 | =over 4 | |
4291 | ||
4292 | =item DESCRIPTION | |
4293 | ||
4294 | An Error Handler, An Event Driven Program | |
4295 | ||
4296 | =item THE CALL_ FUNCTIONS | |
4297 | ||
4298 | call_sv, call_pv, call_method, call_argv | |
4299 | ||
4300 | =item FLAG VALUES | |
4301 | ||
4302 | =over 4 | |
4303 | ||
4304 | =item G_VOID | |
4305 | ||
4306 | =item G_SCALAR | |
4307 | ||
4308 | =item G_ARRAY | |
4309 | ||
4310 | =item G_DISCARD | |
4311 | ||
4312 | =item G_NOARGS | |
4313 | ||
4314 | =item G_EVAL | |
4315 | ||
4316 | =item G_KEEPERR | |
4317 | ||
4318 | =item Determining the Context | |
4319 | ||
4320 | =back | |
4321 | ||
4322 | =item KNOWN PROBLEMS | |
4323 | ||
4324 | =item EXAMPLES | |
4325 | ||
4326 | =over 4 | |
4327 | ||
4328 | =item No Parameters, Nothing returned | |
4329 | ||
4330 | =item Passing Parameters | |
4331 | ||
4332 | =item Returning a Scalar | |
4333 | ||
4334 | =item Returning a list of values | |
4335 | ||
4336 | =item Returning a list in a scalar context | |
4337 | ||
4338 | =item Returning Data from Perl via the parameter list | |
4339 | ||
4340 | =item Using G_EVAL | |
4341 | ||
4342 | =item Using G_KEEPERR | |
4343 | ||
4344 | =item Using call_sv | |
4345 | ||
4346 | =item Using call_argv | |
4347 | ||
4348 | =item Using call_method | |
4349 | ||
4350 | =item Using GIMME_V | |
4351 | ||
4352 | =item Using Perl to dispose of temporaries | |
4353 | ||
4354 | =item Strategies for storing Callback Context Information | |
4355 | ||
4356 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of | |
4357 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
4358 | callback | |
4359 | ||
4360 | =item Alternate Stack Manipulation | |
4361 | ||
4362 | =item Creating and calling an anonymous subroutine in C | |
4363 | ||
4364 | =back | |
4365 | ||
4366 | =item SEE ALSO | |
4367 | ||
4368 | =item AUTHOR | |
4369 | ||
4370 | =item DATE | |
4371 | ||
4372 | =back | |
4373 | ||
4374 | =head2 perlutil - utilities packaged with the Perl distribution | |
4375 | ||
4376 | =over 4 | |
4377 | ||
4378 | =item DESCRIPTION | |
4379 | ||
4380 | =over 4 | |
4381 | ||
4382 | =item DOCUMENTATION | |
4383 | ||
4384 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, | |
4385 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
4386 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
4387 | L<roffitall|roffitall> | |
4388 | ||
4389 | =item CONVERTORS | |
4390 | ||
4391 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> | |
4392 | ||
4393 | =item Administration | |
4394 | ||
4395 | L<libnetcfg|libnetcfg> | |
4396 | ||
4397 | =item Development | |
4398 | ||
4399 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, | |
4400 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
4401 | ||
4402 | =item SEE ALSO | |
4403 | ||
4404 | =back | |
4405 | ||
4406 | =back | |
4407 | ||
4408 | =head2 perlfilter - Source Filters | |
4409 | ||
4410 | =over 4 | |
4411 | ||
4412 | =item DESCRIPTION | |
4413 | ||
4414 | =item CONCEPTS | |
4415 | ||
4416 | =item USING FILTERS | |
4417 | ||
4418 | =item WRITING A SOURCE FILTER | |
4419 | ||
4420 | =item WRITING A SOURCE FILTER IN C | |
4421 | ||
4422 | B<Decryption Filters> | |
4423 | ||
4424 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE | |
4425 | ||
4426 | =item WRITING A SOURCE FILTER IN PERL | |
4427 | ||
4428 | =item USING CONTEXT: THE DEBUG FILTER | |
4429 | ||
4430 | =item CONCLUSION | |
4431 | ||
4432 | =item REQUIREMENTS | |
4433 | ||
4434 | =item AUTHOR | |
4435 | ||
4436 | =item Copyrights | |
4437 | ||
4438 | =back | |
4439 | ||
4440 | =head2 perldbmfilter - Perl DBM Filters | |
4441 | ||
4442 | =over 4 | |
4443 | ||
4444 | =item SYNOPSIS | |
4445 | ||
4446 | =item DESCRIPTION | |
4447 | ||
4448 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
4449 | B<filter_fetch_value> | |
4450 | ||
4451 | =over 4 | |
4452 | ||
4453 | =item The Filter | |
4454 | ||
4455 | =item An Example -- the NULL termination problem. | |
4456 | ||
4457 | =item Another Example -- Key is a C int. | |
4458 | ||
4459 | =back | |
4460 | ||
4461 | =item SEE ALSO | |
4462 | ||
4463 | =item AUTHOR | |
4464 | ||
4465 | =back | |
4466 | ||
4467 | =head2 perlapi - autogenerated documentation for the perl public API | |
4468 | ||
4469 | =over 4 | |
4470 | ||
4471 | =item DESCRIPTION | |
4472 | ||
4473 | =item "Gimme" Values | |
4474 | ||
4475 | GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID | |
4476 | ||
4477 | =item Array Manipulation Functions | |
4478 | ||
4479 | AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, | |
4480 | av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, | |
4481 | get_av, newAV, Nullav, sortsv | |
4482 | ||
4483 | =item Callback Functions | |
4484 | ||
4485 | call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv, | |
4486 | FREETMPS, LEAVE, SAVETMPS | |
4487 | ||
4488 | =item Character classes | |
4489 | ||
4490 | isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER | |
4491 | ||
4492 | =item Cloning an interpreter | |
4493 | ||
4494 | perl_clone | |
4495 | ||
4496 | =item CV Manipulation Functions | |
4497 | ||
4498 | CvSTASH, get_cv, Nullcv | |
4499 | ||
4500 | =item Embedding Functions | |
4501 | ||
4502 | load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct, | |
4503 | perl_free, perl_parse, perl_run, require_pv | |
4504 | ||
4505 | =item Functions in file pp_pack.c | |
4506 | ||
4507 | pack_cat, unpack_str | |
4508 | ||
4509 | =item Global Variables | |
4510 | ||
4511 | PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes | |
4512 | ||
4513 | =item GV Functions | |
4514 | ||
4515 | GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, | |
4516 | gv_fetchmeth_autoload, gv_stashpv, gv_stashsv | |
4517 | ||
4518 | =item Handy Values | |
4519 | ||
4520 | HEf_SVKEY, Nullch, Nullsv | |
4521 | ||
4522 | =item Hash Manipulation Functions | |
4523 | ||
4524 | get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, | |
4525 | HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists, | |
4526 | hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, | |
4527 | hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval, | |
4528 | hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv | |
4529 | ||
4530 | =item Magical Functions | |
4531 | ||
4532 | mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, | |
4533 | SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, | |
4534 | SvSetSV, SvSetSV_nosteal, SvSHARE | |
4535 | ||
4536 | =item Memory Management | |
4537 | ||
4538 | Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree, | |
4539 | savepv, savepvn, savesharedpv, StructCopy, Zero | |
4540 | ||
4541 | =item Miscellaneous Functions | |
4542 | ||
4543 | fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT, | |
4544 | strNE, strnEQ, strnNE | |
4545 | ||
4546 | =item Numeric functions | |
4547 | ||
4548 | grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin, | |
4549 | scan_hex, scan_oct | |
4550 | ||
4551 | =item Optree Manipulation Functions | |
4552 | ||
4553 | cv_const_sv, newCONSTSUB, newXS | |
4554 | ||
4555 | =item Stack Manipulation Macros | |
4556 | ||
4557 | dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp, | |
4558 | POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, | |
4559 | PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN, | |
4560 | XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, | |
4561 | XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES | |
4562 | ||
4563 | =item SV Flags | |
4564 | ||
4565 | svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG | |
4566 | ||
4567 | =item SV Manipulation Functions | |
4568 | ||
4569 | get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, | |
4570 | newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, | |
4571 | new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, | |
4572 | SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx, | |
4573 | SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, | |
4574 | SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, | |
4575 | SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte, | |
4576 | SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, | |
4577 | SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, | |
4578 | SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec, | |
4579 | SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, | |
4580 | SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, | |
4581 | SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, | |
4582 | sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, | |
4583 | sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv, | |
4584 | sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, | |
4585 | sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, | |
4586 | sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, | |
4587 | sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, | |
4588 | sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, | |
4589 | sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext, | |
4590 | sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing, | |
4591 | sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, | |
4592 | sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, | |
4593 | sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, | |
4594 | sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, | |
4595 | sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg, | |
4596 | sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, | |
4597 | sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, | |
4598 | sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, | |
4599 | sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, | |
4600 | sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, | |
4601 | sv_uv, sv_vcatpvfn, sv_vsetpvfn | |
4602 | ||
4603 | =item Unicode Support | |
4604 | ||
4605 | bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, | |
4606 | pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case, | |
4607 | to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr, | |
4608 | utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, | |
4609 | utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags | |
4610 | ||
4611 | =item Variables created by C<xsubpp> and C<xsubpp> internal functions | |
4612 | ||
4613 | ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST, | |
4614 | THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK | |
4615 | ||
4616 | =item Warning and Dieing | |
4617 | ||
4618 | croak, warn | |
4619 | ||
4620 | =item AUTHORS | |
4621 | ||
4622 | =item SEE ALSO | |
4623 | ||
4624 | =back | |
4625 | ||
4626 | =head2 perlintern - autogenerated documentation of purely B<internal> | |
4627 | Perl functions | |
4628 | ||
4629 | =over 4 | |
4630 | ||
4631 | =item DESCRIPTION | |
4632 | ||
4633 | =item Global Variables | |
4634 | ||
4635 | PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv, | |
4636 | PL_rs | |
4637 | ||
4638 | =item GV Functions | |
4639 | ||
4640 | is_gv_magical | |
4641 | ||
4642 | =item IO Functions | |
4643 | ||
4644 | start_glob | |
4645 | ||
4646 | =item Pad Data Structures | |
4647 | ||
4648 | CvPADLIST | |
4649 | ||
4650 | =item Stack Manipulation Macros | |
4651 | ||
4652 | djSP, LVRET | |
4653 | ||
4654 | =item SV Manipulation Functions | |
4655 | ||
4656 | report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas | |
4657 | ||
4658 | =item AUTHORS | |
4659 | ||
4660 | =item SEE ALSO | |
4661 | ||
4662 | =back | |
4663 | ||
4664 | =head2 perliol - C API for Perl's implementation of IO in Layers. | |
4665 | ||
4666 | =over 4 | |
4667 | ||
4668 | =item SYNOPSIS | |
4669 | ||
4670 | =item DESCRIPTION | |
4671 | ||
4672 | =over 4 | |
4673 | ||
4674 | =item History and Background | |
4675 | ||
4676 | =item Layers vs Disciplines | |
4677 | ||
4678 | =item Data Structures | |
4679 | ||
4680 | =item Functions and Attributes | |
4681 | ||
4682 | =item Per-instance Data | |
4683 | ||
4684 | =item Layers in action. | |
4685 | ||
4686 | =item Per-instance flag bits | |
4687 | ||
4688 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, | |
4689 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, | |
4690 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, | |
4691 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS | |
4692 | ||
4693 | =item Methods in Detail | |
4694 | ||
4695 | fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, | |
4696 | PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, | |
4697 | Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, | |
4698 | Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, | |
4699 | Set_ptrcnt | |
4700 | ||
4701 | =item Core Layers | |
4702 | ||
4703 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" | |
4704 | ||
4705 | =item Extension Layers | |
4706 | ||
4707 | ":encoding", ":scalar", ":via" | |
4708 | ||
4709 | =back | |
4710 | ||
4711 | =item TODO | |
4712 | ||
4713 | =back | |
4714 | ||
4715 | =head2 perlapio - perl's IO abstraction interface. | |
4716 | ||
4717 | =over 4 | |
4718 | ||
4719 | =item SYNOPSIS | |
4720 | ||
4721 | =item DESCRIPTION | |
4722 | ||
4723 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, | |
4724 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, | |
4725 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, | |
4726 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, | |
4727 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
4728 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
4729 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
4730 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
4731 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, | |
4732 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
4733 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> | |
4734 | ||
4735 | =over 4 | |
4736 | ||
4737 | =item Co-existence with stdio | |
4738 | ||
4739 | B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>, | |
4740 | B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)> | |
4741 | ||
4742 | =item "Fast gets" Functions | |
4743 | ||
4744 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, | |
4745 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, | |
4746 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, | |
4747 | B<PerlIO_get_bufsiz(f)> | |
4748 | ||
4749 | =item Other Functions | |
4750 | ||
4751 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), | |
4752 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) | |
4753 | ||
4754 | =back | |
4755 | ||
4756 | =back | |
4757 | ||
4758 | =head2 perltodo - Perl TO-DO List | |
4759 | ||
4760 | =over 4 | |
4761 | ||
4762 | =item DESCRIPTION | |
4763 | ||
4764 | =item To do during 5.6.x | |
4765 | ||
4766 | =over 4 | |
4767 | ||
4768 | =item Support for I/O disciplines | |
4769 | ||
4770 | =item Autoload bytes.pm | |
4771 | ||
4772 | =item Make "\u{XXXX}" et al work | |
4773 | ||
4774 | =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) | |
4775 | ||
4776 | =item Overloadable regex assertions | |
4777 | ||
4778 | =item Unicode | |
4779 | ||
4780 | =item Work out exit/die semantics for threads | |
4781 | ||
4782 | =item Better support for nonpreemptive threading systems like GNU pth | |
4783 | ||
4784 | =item Typed lexicals for compiler | |
4785 | ||
4786 | =item Compiler workarounds for Win32 | |
4787 | ||
4788 | =item AUTOLOADing in the compiler | |
4789 | ||
4790 | =item Fixing comppadlist when compiling | |
4791 | ||
4792 | =item Cleaning up exported namespace | |
4793 | ||
4794 | =item Complete signal handling | |
4795 | ||
4796 | =item Out-of-source builds | |
4797 | ||
4798 | =item POSIX realtime support | |
4799 | ||
4800 | =item UNIX98 support | |
4801 | ||
4802 | =item IPv6 Support | |
4803 | ||
4804 | =item Long double conversion | |
4805 | ||
4806 | =item Locales | |
4807 | ||
4808 | =item Arithmetic on non-Arabic numerals | |
4809 | ||
4810 | =item POSIX Unicode character classes | |
4811 | ||
4812 | =item Factoring out common suffices/prefices in regexps (trie optimization) | |
4813 | ||
4814 | =item Security audit shipped utilities | |
4815 | ||
4816 | =item Sort out the uid-setting mess | |
4817 | ||
4818 | =item Custom opcodes | |
4819 | ||
4820 | =item DLL Versioning | |
4821 | ||
4822 | =item Introduce @( and @) | |
4823 | ||
4824 | =item Floating point handling | |
4825 | ||
4826 | =item IV/UV preservation | |
4827 | ||
4828 | =item Replace pod2html with something using Pod::Parser | |
4829 | ||
4830 | =item Automate module testing on CPAN | |
4831 | ||
4832 | =item sendmsg and recvmsg | |
4833 | ||
4834 | =item Rewrite perlre documentation | |
4835 | ||
4836 | =item Convert example code to IO::Handle filehandles | |
4837 | ||
4838 | =item Document Win32 choices | |
4839 | ||
4840 | =item Check new modules | |
4841 | ||
4842 | =item Make roffitall find pods and libs itself | |
4843 | ||
4844 | =back | |
4845 | ||
4846 | =item To do at some point | |
4847 | ||
4848 | =over 4 | |
4849 | ||
4850 | =item Remove regular expression recursion | |
4851 | ||
4852 | =item Memory leaks after failed eval | |
4853 | ||
4854 | =item bitfields in pack | |
4855 | ||
4856 | =item Cross compilation | |
4857 | ||
4858 | =item Perl preprocessor / macros | |
4859 | ||
4860 | =item Perl lexer in Perl | |
4861 | ||
4862 | =item Using POSIX calls internally | |
4863 | ||
4864 | =item -i rename file when changed | |
4865 | ||
4866 | =item All ARGV input should act like E<lt>E<gt> | |
4867 | ||
4868 | =item Support for rerunning debugger | |
4869 | ||
4870 | =item Test Suite for the Debugger | |
4871 | ||
4872 | =item my sub foo { } | |
4873 | ||
4874 | =item One-pass global destruction | |
4875 | ||
4876 | =item Rewrite regexp parser | |
4877 | ||
4878 | =item Cache recently used regexps | |
4879 | ||
4880 | =item Cross-compilation support | |
4881 | ||
4882 | =item Bit-shifting bitvectors | |
4883 | ||
4884 | =item debugger pragma | |
4885 | ||
4886 | =item use less pragma | |
4887 | ||
4888 | =item switch structures | |
4889 | ||
4890 | =item Cache eval tree | |
4891 | ||
4892 | =item rcatmaybe | |
4893 | ||
4894 | =item Shrink opcode tables | |
4895 | ||
4896 | =item Optimize away @_ | |
4897 | ||
4898 | =item Prototypes versus indirect objects | |
4899 | ||
4900 | =item Install HTML | |
4901 | ||
4902 | =item Prototype method calls | |
4903 | ||
4904 | =item Return context prototype declarations | |
4905 | ||
4906 | =item magic_setisa | |
4907 | ||
4908 | =item Garbage collection | |
4909 | ||
4910 | =item IO tutorial | |
4911 | ||
4912 | =item Rewrite perldoc | |
4913 | ||
4914 | =item Install .3p manpages | |
4915 | ||
4916 | =item Unicode tutorial | |
4917 | ||
4918 | =item Update POSIX.pm for 1003.1-2 | |
4919 | ||
4920 | =item Retargetable installation | |
4921 | ||
4922 | =item POSIX emulation on non-POSIX systems | |
4923 | ||
4924 | =item Rename Win32 headers | |
4925 | ||
4926 | =item Finish off lvalue functions | |
4927 | ||
4928 | =item Update sprintf documentation | |
4929 | ||
4930 | =item Use fchown/fchmod internally | |
4931 | ||
4932 | =item Make v-strings overloaded objects | |
4933 | ||
4934 | =item Allow restricted hash assignment | |
4935 | ||
4936 | =item Should overload be inheritable? | |
4937 | ||
4938 | =item Taint rethink | |
4939 | ||
4940 | =back | |
4941 | ||
4942 | =item Vague ideas | |
4943 | ||
4944 | =over 4 | |
4945 | ||
4946 | =item ref() in list context | |
4947 | ||
4948 | =item Make tr/// return histogram of characters in list context | |
4949 | ||
4950 | =item Compile to real threaded code | |
4951 | ||
4952 | =item Structured types | |
4953 | ||
4954 | =item Modifiable $1 et al. | |
4955 | ||
4956 | =item Procedural interfaces for IO::*, etc. | |
4957 | ||
4958 | =item RPC modules | |
4959 | ||
4960 | =item Attach/detach debugger from running program | |
4961 | ||
4962 | =item GUI::Native | |
4963 | ||
4964 | =item foreach(reverse ...) | |
4965 | ||
4966 | =item Constant function cache | |
4967 | ||
4968 | =item Approximate regular expression matching | |
4969 | ||
4970 | =back | |
4971 | ||
4972 | =item Ongoing | |
4973 | ||
4974 | =over 4 | |
4975 | ||
4976 | =item Update guts documentation | |
4977 | ||
4978 | =item Add more tests | |
4979 | ||
4980 | =item Update auxiliary tools | |
4981 | ||
4982 | =item Create debugging macros | |
4983 | ||
4984 | =item truncate to the people | |
4985 | ||
4986 | =item Unicode in Filenames | |
4987 | ||
4988 | =back | |
4989 | ||
4990 | =item Recently done things | |
4991 | ||
4992 | =over 4 | |
4993 | ||
4994 | =item Alternative RE syntax module | |
4995 | ||
4996 | =item Safe signal handling | |
4997 | ||
4998 | =item Tie Modules | |
4999 | ||
5000 | =item gettimeofday | |
5001 | ||
5002 | =item setitimer and getimiter | |
5003 | ||
5004 | =item Testing __DIE__ hook | |
5005 | ||
5006 | =item CPP equivalent in Perl | |
5007 | ||
5008 | =item Explicit switch statements | |
5009 | ||
5010 | =item autocroak | |
5011 | ||
5012 | =item UTF/EBCDIC | |
5013 | ||
5014 | =item UTF Regexes | |
5015 | ||
5016 | =item perlcc to produce executable | |
5017 | ||
5018 | =item END blocks saved in compiled output | |
5019 | ||
5020 | =item Secure temporary file module | |
5021 | ||
5022 | =item Integrate Time::HiRes | |
5023 | ||
5024 | =item Turn Cwd into XS | |
5025 | ||
5026 | =item Mmap for input | |
5027 | ||
5028 | =item Byte to/from UTF8 and UTF8 to/from local conversion | |
5029 | ||
5030 | =item Add sockatmark support | |
5031 | ||
5032 | =item Mailing list archives | |
5033 | ||
5034 | =item Bug tracking | |
5035 | ||
5036 | =item Integrate MacPerl | |
5037 | ||
5038 | =item Web "nerve center" for Perl | |
5039 | ||
5040 | =item Regular expression tutorial | |
5041 | ||
5042 | =item Debugging Tutorial | |
5043 | ||
5044 | =item Integrate new modules | |
5045 | ||
5046 | =item Integrate profiler | |
5047 | ||
5048 | =item Y2K error detection | |
5049 | ||
5050 | =item Regular expression debugger | |
5051 | ||
5052 | =item POD checker | |
5053 | ||
5054 | =item "Dynamic" lexicals | |
5055 | ||
5056 | =item Cache precompiled modules | |
5057 | ||
5058 | =back | |
5059 | ||
5060 | =item Deprecated Wishes | |
5061 | ||
5062 | =over 4 | |
5063 | ||
5064 | =item Loop control on do{} | |
5065 | ||
5066 | =item Lexically scoped typeglobs | |
5067 | ||
5068 | =item format BOTTOM | |
5069 | ||
5070 | =item report HANDLE | |
5071 | ||
5072 | =item Generalised want()/caller()) | |
5073 | ||
5074 | =item Named prototypes | |
5075 | ||
5076 | =item Built-in globbing | |
5077 | ||
5078 | =item Regression tests for suidperl | |
5079 | ||
5080 | =item Cached hash values | |
5081 | ||
5082 | =item Add compression modules | |
5083 | ||
5084 | =item Reorganise documentation into tutorials/references | |
5085 | ||
5086 | =item Remove distinction between functions and operators | |
5087 | ||
5088 | =item Make XS easier to use | |
5089 | ||
5090 | =item Make embedding easier to use | |
5091 | ||
5092 | =item man for perl | |
5093 | ||
5094 | =item my $Package::variable | |
5095 | ||
5096 | =item "or" tests defined, not truth | |
5097 | ||
5098 | =item "class"-based lexicals | |
5099 | ||
5100 | =item byteperl | |
5101 | ||
5102 | =item Lazy evaluation / tail recursion removal | |
5103 | ||
5104 | =item Make "use utf8" the default | |
5105 | ||
5106 | =item Unicode collation and normalization | |
5107 | ||
5108 | =item pack/unpack tutorial | |
5109 | ||
5110 | =back | |
5111 | ||
5112 | =back | |
5113 | ||
5114 | =head2 perlhack - How to hack at the Perl internals | |
5115 | ||
5116 | =over 4 | |
5117 | ||
5118 | =item DESCRIPTION | |
5119 | ||
5120 | Does concept match the general goals of Perl?, Where is the | |
5121 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
5122 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
5123 | it preclude other desirable features?, Is the implementation robust?, Is | |
5124 | the implementation generic enough to be portable?, Is the implementation | |
5125 | tested?, Is there enough documentation?, Is there another way to do it?, | |
5126 | Does it create too much work?, Patches speak louder than words | |
5127 | ||
5128 | =over 4 | |
5129 | ||
5130 | =item Keeping in sync | |
5131 | ||
5132 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
5133 | NFS, rsync'ing the patches | |
5134 | ||
5135 | =item Why rsync the source tree | |
5136 | ||
5137 | It's easier to rsync the source tree, It's more reliable | |
5138 | ||
5139 | =item Why rsync the patches | |
5140 | ||
5141 | It's easier to rsync the patches, It's a good reference, Finding a start | |
5142 | point, Finding how to fix a bug, Finding the source of misbehaviour | |
5143 | ||
5144 | =item Perlbug remote interface | |
5145 | ||
5146 | 1 http://bugs.perl.org, 2 bugdb@perl.org, 3 | |
5147 | commands_and_bugdids@bugs.perl.org, notes, patches, tests | |
5148 | ||
5149 | =item Submitting patches | |
5150 | ||
5151 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
5152 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
5153 | ||
5154 | =item Finding Your Way Around | |
5155 | ||
5156 | Core modules, Tests, Documentation, Configure, Interpreter | |
5157 | ||
5158 | =item Elements of the interpreter | |
5159 | ||
5160 | Startup, Parsing, Optimization, Running | |
5161 | ||
5162 | =item Internal Variable Types | |
5163 | ||
5164 | =item Op Trees | |
5165 | ||
5166 | =item Stacks | |
5167 | ||
5168 | Argument stack, Mark stack, Save stack | |
5169 | ||
5170 | =item Millions of Macros | |
5171 | ||
5172 | =item Poking at Perl | |
5173 | ||
5174 | =item Using a source-level debugger | |
5175 | ||
5176 | run [args], break function_name, break source.c:xxx, step, next, continue, | |
5177 | finish, 'enter', print | |
5178 | ||
5179 | =item Dumping Perl Data Structures | |
5180 | ||
5181 | =item Patching | |
5182 | ||
5183 | =item Patching a core module | |
5184 | ||
5185 | =item Adding a new function to the core | |
5186 | ||
5187 | =item Writing a test | |
5188 | ||
5189 | F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, | |
5190 | F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib | |
5191 | ||
5192 | =item Special Make Test Targets | |
5193 | ||
5194 | coretest, test.deparse, minitest, test.third check.third utest.third | |
5195 | ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8 | |
5196 | ||
5197 | =back | |
5198 | ||
5199 | =item EXTERNAL TOOLS FOR DEBUGGING PERL | |
5200 | ||
5201 | =over 4 | |
5202 | ||
5203 | =item Rational Software's Purify | |
5204 | ||
5205 | =item Purify on Unix | |
5206 | ||
5207 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity | |
5208 | ||
5209 | =item Purify on NT | |
5210 | ||
5211 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug | |
5212 | ||
5213 | =item Compaq's/Digital's/HP's Third Degree | |
5214 | ||
5215 | =item PERL_DESTRUCT_LEVEL | |
5216 | ||
5217 | =item Profiling | |
5218 | ||
5219 | =item Gprof Profiling | |
5220 | ||
5221 | -a, -b, -e routine, -f routine, -s, -z | |
5222 | ||
5223 | =item GCC gcov Profiling | |
5224 | ||
5225 | =item Pixie Profiling | |
5226 | ||
5227 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, | |
5228 | -z[ero] | |
5229 | ||
5230 | =item Miscellaneous tricks | |
5231 | ||
5232 | =item CONCLUSION | |
5233 | ||
5234 | I<The Road goes ever on and on, down from the door where it began.> | |
5235 | ||
5236 | =back | |
5237 | ||
5238 | =item AUTHOR | |
5239 | ||
5240 | =back | |
5241 | ||
5242 | =head2 perlhist - the Perl history records | |
5243 | ||
5244 | =over 4 | |
5245 | ||
5246 | =item DESCRIPTION | |
5247 | ||
5248 | =item INTRODUCTION | |
5249 | ||
5250 | =item THE KEEPERS OF THE PUMPKIN | |
5251 | ||
5252 | =over 4 | |
5253 | ||
5254 | =item PUMPKIN? | |
5255 | ||
5256 | =back | |
5257 | ||
5258 | =item THE RECORDS | |
5259 | ||
5260 | =over 4 | |
5261 | ||
5262 | =item SELECTED RELEASE SIZES | |
5263 | ||
5264 | =item SELECTED PATCH SIZES | |
5265 | ||
5266 | =back | |
5267 | ||
5268 | =item THE KEEPERS OF THE RECORDS | |
5269 | ||
5270 | =back | |
5271 | ||
5272 | =head2 perldelta - what is new for perl v5.8.0 | |
5273 | ||
5274 | =over 4 | |
5275 | ||
5276 | =item DESCRIPTION | |
5277 | ||
5278 | =item Highlights In 5.8.0 | |
5279 | ||
5280 | =item Incompatible Changes | |
5281 | ||
5282 | =over 4 | |
5283 | ||
5284 | =item Binary Incompatibility | |
5285 | ||
5286 | =item 64-bit platforms and malloc | |
5287 | ||
5288 | =item AIX Dynaloading | |
5289 | ||
5290 | =item Attributes for C<my> variables now handled at run-time | |
5291 | ||
5292 | =item Socket Extension Dynamic in VMS | |
5293 | ||
5294 | =item IEEE-format Floating Point Default on OpenVMS Alpha | |
5295 | ||
5296 | =item New Unicode Semantics (no more C<use utf8>, almost) | |
5297 | ||
5298 | =item New Unicode Properties | |
5299 | ||
5300 | =item REF(...) Instead Of SCALAR(...) | |
5301 | ||
5302 | =item pack/unpack D/F recycled | |
5303 | ||
5304 | =item glob() now returns filenames in alphabetical order | |
5305 | ||
5306 | =item Deprecations | |
5307 | ||
5308 | =back | |
5309 | ||
5310 | =item Core Enhancements | |
5311 | ||
5312 | =over 4 | |
5313 | ||
5314 | =item Unicode Overhaul | |
5315 | ||
5316 | =item PerlIO is Now The Default | |
5317 | ||
5318 | =item ithreads | |
5319 | ||
5320 | =item Restricted Hashes | |
5321 | ||
5322 | =item Safe Signals | |
5323 | ||
5324 | =item Understanding of Numbers | |
5325 | ||
5326 | =item Arrays now always interpolate into double-quoted strings [561] | |
5327 | ||
5328 | =item Miscellaneous Changes | |
5329 | ||
5330 | =back | |
5331 | ||
5332 | =item Modules and Pragmata | |
5333 | ||
5334 | =over 4 | |
5335 | ||
5336 | =item New Modules and Pragmata | |
5337 | ||
5338 | =item Updated And Improved Modules and Pragmata | |
5339 | ||
5340 | =back | |
5341 | ||
5342 | =item Utility Changes | |
5343 | ||
5344 | =item New Documentation | |
5345 | ||
5346 | =item Performance Enhancements | |
5347 | ||
5348 | =item Installation and Configuration Improvements | |
5349 | ||
5350 | =over 4 | |
5351 | ||
5352 | =item Generic Improvements | |
5353 | ||
5354 | =item New Or Improved Platforms | |
5355 | ||
5356 | =back | |
5357 | ||
5358 | =item Selected Bug Fixes | |
5359 | ||
5360 | =over 4 | |
5361 | ||
5362 | =item Platform Specific Changes and Fixes | |
5363 | ||
5364 | =back | |
5365 | ||
5366 | =item New or Changed Diagnostics | |
5367 | ||
5368 | =item Changed Internals | |
5369 | ||
5370 | =item Security Vulnerability Closed [561] | |
5371 | ||
5372 | =item New Tests | |
5373 | ||
5374 | =item Known Problems | |
5375 | ||
5376 | =over 4 | |
5377 | ||
5378 | =item The Compiler Suite Is Still Very Experimental | |
5379 | ||
5380 | =item Localising Tied Arrays and Hashes Is Broken | |
5381 | ||
5382 | =item Building Extensions Can Fail Because Of Largefiles | |
5383 | ||
5384 | =item Modifying $_ Inside for(..) | |
5385 | ||
5386 | =item mod_perl 1.26 Doesn't Build With Threaded Perl | |
5387 | ||
5388 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
5389 | ||
5390 | =item libwww-perl (LWP) fails base/date #51 | |
5391 | ||
5392 | =item PDL failing some tests | |
5393 | ||
5394 | =item Perl_get_sv | |
5395 | ||
5396 | =item Self-tying Problems | |
5397 | ||
5398 | =item ext/threads/t/libc | |
5399 | ||
5400 | =item Failure of Thread (5.005-style) tests | |
5401 | ||
5402 | =item Timing problems | |
5403 | ||
5404 | =item Tied/Magical Array/Hash Elements Do Not Autovivify | |
5405 | ||
5406 | =item Unicode in package/class and subroutine names does not work | |
5407 | ||
5408 | =back | |
5409 | ||
5410 | =item Platform Specific Problems | |
5411 | ||
5412 | =over 4 | |
5413 | ||
5414 | =item AIX | |
5415 | ||
5416 | =item Alpha systems with old gccs fail several tests | |
5417 | ||
5418 | =item AmigaOS | |
5419 | ||
5420 | =item BeOS | |
5421 | ||
5422 | =item Cygwin "unable to remap" | |
5423 | ||
5424 | =item Cygwin ndbm tests fail on FAT | |
5425 | ||
5426 | =item DJGPP Failures | |
5427 | ||
5428 | =item FreeBSD built with ithreads coredumps reading large directories | |
5429 | ||
5430 | =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales | |
5431 | ||
5432 | =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 | |
5433 | ||
5434 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured | |
5435 | ||
5436 | =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint | |
5437 | ||
5438 | =item Linux With Sfio Fails op/misc Test 48 | |
5439 | ||
5440 | =item Mac OS X | |
5441 | ||
5442 | =item Mac OS X dyld undefined symbols | |
5443 | ||
5444 | =item OS/2 Test Failures | |
5445 | ||
5446 | =item op/sprintf tests 91, 129, and 130 | |
5447 | ||
5448 | =item Solaris 2.5 | |
5449 | ||
5450 | =item Solaris x86 Fails Tests With -Duse64bitint | |
5451 | ||
5452 | =item SUPER-UX (NEC SX) | |
5453 | ||
5454 | =item Term::ReadKey not working on Win32 | |
5455 | ||
5456 | =item UNICOS/mk | |
5457 | ||
5458 | =item UTS | |
5459 | ||
5460 | =item VOS (Stratus) | |
5461 | ||
5462 | =item VMS | |
5463 | ||
5464 | =item Win32 | |
5465 | ||
5466 | =item XML::Parser not working | |
5467 | ||
5468 | =item z/OS (OS/390) | |
5469 | ||
5470 | =item Unicode Support on EBCDIC Still Spotty | |
5471 | ||
5472 | =item Seen In Perl 5.7 But Gone Now | |
5473 | ||
5474 | =back | |
5475 | ||
5476 | =item Reporting Bugs | |
5477 | ||
5478 | =item SEE ALSO | |
5479 | ||
5480 | =item HISTORY | |
5481 | ||
5482 | =back | |
5483 | ||
5484 | =head2 perl572delta - what's new for perl v5.7.2 | |
5485 | ||
5486 | =over 4 | |
5487 | ||
5488 | =item DESCRIPTION | |
5489 | ||
5490 | =item Security Vulnerability Closed | |
5491 | ||
5492 | =item Incompatible Changes | |
5493 | ||
5494 | =over 4 | |
5495 | ||
5496 | =item 64-bit platforms and malloc | |
5497 | ||
5498 | =item AIX Dynaloading | |
5499 | ||
5500 | =item Socket Extension Dynamic in VMS | |
5501 | ||
5502 | =item Different Definition of the Unicode Character Classes \p{In...} | |
5503 | ||
5504 | =item Deprecations | |
5505 | ||
5506 | =back | |
5507 | ||
5508 | =item Core Enhancements | |
5509 | ||
5510 | =item Modules and Pragmata | |
5511 | ||
5512 | =over 4 | |
5513 | ||
5514 | =item New Modules and Distributions | |
5515 | ||
5516 | =item Updated And Improved Modules and Pragmata | |
5517 | ||
5518 | =back | |
5519 | ||
5520 | =item Utility Changes | |
5521 | ||
5522 | =item New Documentation | |
5523 | ||
5524 | =item Installation and Configuration Improvements | |
5525 | ||
5526 | =over 4 | |
5527 | ||
5528 | =item New Or Improved Platforms | |
5529 | ||
5530 | =item Generic Improvements | |
5531 | ||
5532 | =back | |
5533 | ||
5534 | =item Selected Bug Fixes | |
5535 | ||
5536 | =over 4 | |
5537 | ||
5538 | =item Platform Specific Changes and Fixes | |
5539 | ||
5540 | =back | |
5541 | ||
5542 | =item New or Changed Diagnostics | |
5543 | ||
5544 | =item Source Code Enhancements | |
5545 | ||
5546 | =over 4 | |
5547 | ||
5548 | =item MAGIC constants | |
5549 | ||
5550 | =item Better commented code | |
5551 | ||
5552 | =item Regex pre-/post-compilation items matched up | |
5553 | ||
5554 | =item gcc -Wall | |
5555 | ||
5556 | =back | |
5557 | ||
5558 | =item New Tests | |
5559 | ||
5560 | =item Known Problems | |
5561 | ||
5562 | =over 4 | |
5563 | ||
5564 | =item AIX | |
5565 | ||
5566 | =item Amiga Perl Invoking Mystery | |
5567 | ||
5568 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
5569 | ||
5570 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 | |
5571 | ||
5572 | =item HP-UX lib/io_multihomed Fails When LP64-Configured | |
5573 | ||
5574 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured | |
5575 | ||
5576 | =item Linux With Sfio Fails op/misc Test 48 | |
5577 | ||
5578 | =item OS/390 | |
5579 | ||
5580 | =item op/sprintf tests 129 and 130 | |
5581 | ||
5582 | =item Failure of Thread tests | |
5583 | ||
5584 | =item UNICOS | |
5585 | ||
5586 | =item UTS | |
5587 | ||
5588 | =item VMS | |
5589 | ||
5590 | =item Win32 | |
5591 | ||
5592 | =item Localising a Tied Variable Leaks Memory | |
5593 | ||
5594 | =item Self-tying of Arrays and Hashes Is Forbidden | |
5595 | ||
5596 | =item Variable Attributes are not Currently Usable for Tieing | |
5597 | ||
5598 | =item Building Extensions Can Fail Because Of Largefiles | |
5599 | ||
5600 | =item The Compiler Suite Is Still Experimental | |
5601 | ||
5602 | =item The Long Double Support is Still Experimental | |
5603 | ||
5604 | =back | |
5605 | ||
5606 | =item Reporting Bugs | |
5607 | ||
5608 | =item SEE ALSO | |
5609 | ||
5610 | =item HISTORY | |
5611 | ||
5612 | =back | |
5613 | ||
5614 | =head2 perl571delta - what's new for perl v5.7.1 | |
5615 | ||
5616 | =over 4 | |
5617 | ||
5618 | =item DESCRIPTION | |
5619 | ||
5620 | =item Security Vulnerability Closed | |
5621 | ||
5622 | =item Incompatible Changes | |
5623 | ||
5624 | =item Core Enhancements | |
5625 | ||
5626 | =over 4 | |
5627 | ||
5628 | =item AUTOLOAD Is Now Lvaluable | |
5629 | ||
5630 | =item PerlIO is Now The Default | |
5631 | ||
5632 | =item Signals Are Now Safe | |
5633 | ||
5634 | =back | |
5635 | ||
5636 | =item Modules and Pragmata | |
5637 | ||
5638 | =over 4 | |
5639 | ||
5640 | =item New Modules | |
5641 | ||
5642 | =item Updated And Improved Modules and Pragmata | |
5643 | ||
5644 | =back | |
5645 | ||
5646 | =item Performance Enhancements | |
5647 | ||
5648 | =item Utility Changes | |
5649 | ||
5650 | =item New Documentation | |
5651 | ||
5652 | =over 4 | |
5653 | ||
5654 | =item perlclib | |
5655 | ||
5656 | =item perliol | |
5657 | ||
5658 | =item README.aix | |
5659 | ||
5660 | =item README.bs2000 | |
5661 | ||
5662 | =item README.macos | |
5663 | ||
5664 | =item README.mpeix | |
5665 | ||
5666 | =item README.solaris | |
5667 | ||
5668 | =item README.vos | |
5669 | ||
5670 | =item Porting/repository.pod | |
5671 | ||
5672 | =back | |
5673 | ||
5674 | =item Installation and Configuration Improvements | |
5675 | ||
5676 | =over 4 | |
5677 | ||
5678 | =item New Or Improved Platforms | |
5679 | ||
5680 | =item Generic Improvements | |
5681 | ||
5682 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, | |
5683 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, | |
5684 | d_strtoq, d_u32align, d_ualarm, d_usleep | |
5685 | ||
5686 | =back | |
5687 | ||
5688 | =item Selected Bug Fixes | |
5689 | ||
5690 | =over 4 | |
5691 | ||
5692 | =item Platform Specific Changes and Fixes | |
5693 | ||
5694 | =back | |
5695 | ||
5696 | =item New or Changed Diagnostics | |
5697 | ||
5698 | =item Changed Internals | |
5699 | ||
5700 | =item New Tests | |
5701 | ||
5702 | =item Known Problems | |
5703 | ||
5704 | =over 4 | |
5705 | ||
5706 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl | |
5707 | ||
5708 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
5709 | ||
5710 | =item lib/io_multihomed Fails In LP64-Configured HP-UX | |
5711 | ||
5712 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
5713 | ||
5714 | =item lib/b test 19 | |
5715 | ||
5716 | =item Linux With Sfio Fails op/misc Test 48 | |
5717 | ||
5718 | =item sigaction test 13 in VMS | |
5719 | ||
5720 | =item sprintf tests 129 and 130 | |
5721 | ||
5722 | =item Failure of Thread tests | |
5723 | ||
5724 | =item Localising a Tied Variable Leaks Memory | |
5725 | ||
5726 | =item Self-tying of Arrays and Hashes Is Forbidden | |
5727 | ||
5728 | =item Building Extensions Can Fail Because Of Largefiles | |
5729 | ||
5730 | =item The Compiler Suite Is Still Experimental | |
5731 | ||
5732 | =back | |
5733 | ||
5734 | =item Reporting Bugs | |
5735 | ||
5736 | =item SEE ALSO | |
5737 | ||
5738 | =item HISTORY | |
5739 | ||
5740 | =back | |
5741 | ||
5742 | =head2 perl570delta - what's new for perl v5.7.0 | |
5743 | ||
5744 | =over 4 | |
5745 | ||
5746 | =item DESCRIPTION | |
5747 | ||
5748 | =item Security Vulnerability Closed | |
5749 | ||
5750 | =item Incompatible Changes | |
5751 | ||
5752 | =item Core Enhancements | |
5753 | ||
5754 | =item Modules and Pragmata | |
5755 | ||
5756 | =over 4 | |
5757 | ||
5758 | =item New Modules | |
5759 | ||
5760 | =item Updated And Improved Modules and Pragmata | |
5761 | ||
5762 | =back | |
5763 | ||
5764 | =item Utility Changes | |
5765 | ||
5766 | =item New Documentation | |
5767 | ||
5768 | =item Performance Enhancements | |
5769 | ||
5770 | =item Installation and Configuration Improvements | |
5771 | ||
5772 | =over 4 | |
5773 | ||
5774 | =item Generic Improvements | |
5775 | ||
5776 | =back | |
5777 | ||
5778 | =item Selected Bug Fixes | |
5779 | ||
5780 | =over 4 | |
5781 | ||
5782 | =item Platform Specific Changes and Fixes | |
5783 | ||
5784 | =back | |
5785 | ||
5786 | =item New or Changed Diagnostics | |
5787 | ||
5788 | =item Changed Internals | |
5789 | ||
5790 | =item Known Problems | |
5791 | ||
5792 | =over 4 | |
5793 | ||
5794 | =item Unicode Support Still Far From Perfect | |
5795 | ||
5796 | =item EBCDIC Still A Lost Platform | |
5797 | ||
5798 | =item Building Extensions Can Fail Because Of Largefiles | |
5799 | ||
5800 | =item ftmp-security tests warn 'system possibly insecure' | |
5801 | ||
5802 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
5803 | ||
5804 | =item Long Doubles Still Don't Work In Solaris | |
5805 | ||
5806 | =item Linux With Sfio Fails op/misc Test 48 | |
5807 | ||
5808 | =item Storable tests fail in some platforms | |
5809 | ||
5810 | =item Threads Are Still Experimental | |
5811 | ||
5812 | =item The Compiler Suite Is Still Experimental | |
5813 | ||
5814 | =back | |
5815 | ||
5816 | =item Reporting Bugs | |
5817 | ||
5818 | =item SEE ALSO | |
5819 | ||
5820 | =item HISTORY | |
5821 | ||
5822 | =back | |
5823 | ||
5824 | =head2 perl561delta - what's new for perl v5.6.x | |
5825 | ||
5826 | =over 4 | |
5827 | ||
5828 | =item DESCRIPTION | |
5829 | ||
5830 | =item Summary of changes between 5.6.0 and 5.6.1 | |
5831 | ||
5832 | =over 4 | |
5833 | ||
5834 | =item Security Issues | |
5835 | ||
5836 | =item Core bug fixes | |
5837 | ||
5838 | C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), | |
5839 | Bugs in regular expressions, "slurp" mode, Autovivification of symbolic | |
5840 | references to special variables, Lexical warnings, Spurious warnings and | |
5841 | errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, | |
5842 | map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, | |
5843 | Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no | |
5844 | Module;>, Tests | |
5845 | ||
5846 | =item Core features | |
5847 | ||
5848 | =item Configuration issues | |
5849 | ||
5850 | =item Documentation | |
5851 | ||
5852 | =item Bundled modules | |
5853 | ||
5854 | B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, | |
5855 | Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, | |
5856 | IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, | |
5857 | Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash | |
5858 | ||
5859 | =item Platform-specific improvements | |
5860 | ||
5861 | NCR MP-RAS, NonStop-UX | |
5862 | ||
5863 | =back | |
5864 | ||
5865 | =item Core Enhancements | |
5866 | ||
5867 | =over 4 | |
5868 | ||
5869 | =item Interpreter cloning, threads, and concurrency | |
5870 | ||
5871 | =item Lexically scoped warning categories | |
5872 | ||
5873 | =item Unicode and UTF-8 support | |
5874 | ||
5875 | =item Support for interpolating named characters | |
5876 | ||
5877 | =item "our" declarations | |
5878 | ||
5879 | =item Support for strings represented as a vector of ordinals | |
5880 | ||
5881 | =item Improved Perl version numbering system | |
5882 | ||
5883 | =item New syntax for declaring subroutine attributes | |
5884 | ||
5885 | =item File and directory handles can be autovivified | |
5886 | ||
5887 | =item open() with more than two arguments | |
5888 | ||
5889 | =item 64-bit support | |
5890 | ||
5891 | =item Large file support | |
5892 | ||
5893 | =item Long doubles | |
5894 | ||
5895 | =item "more bits" | |
5896 | ||
5897 | =item Enhanced support for sort() subroutines | |
5898 | ||
5899 | =item C<sort $coderef @foo> allowed | |
5900 | ||
5901 | =item File globbing implemented internally | |
5902 | ||
5903 | =item Support for CHECK blocks | |
5904 | ||
5905 | =item POSIX character class syntax [: :] supported | |
5906 | ||
5907 | =item Better pseudo-random number generator | |
5908 | ||
5909 | =item Improved C<qw//> operator | |
5910 | ||
5911 | =item Better worst-case behavior of hashes | |
5912 | ||
5913 | =item pack() format 'Z' supported | |
5914 | ||
5915 | =item pack() format modifier '!' supported | |
5916 | ||
5917 | =item pack() and unpack() support counted strings | |
5918 | ||
5919 | =item Comments in pack() templates | |
5920 | ||
5921 | =item Weak references | |
5922 | ||
5923 | =item Binary numbers supported | |
5924 | ||
5925 | =item Lvalue subroutines | |
5926 | ||
5927 | =item Some arrows may be omitted in calls through references | |
5928 | ||
5929 | =item Boolean assignment operators are legal lvalues | |
5930 | ||
5931 | =item exists() is supported on subroutine names | |
5932 | ||
5933 | =item exists() and delete() are supported on array elements | |
5934 | ||
5935 | =item Pseudo-hashes work better | |
5936 | ||
5937 | =item Automatic flushing of output buffers | |
5938 | ||
5939 | =item Better diagnostics on meaningless filehandle operations | |
5940 | ||
5941 | =item Where possible, buffered data discarded from duped input filehandle | |
5942 | ||
5943 | =item eof() has the same old magic as <> | |
5944 | ||
5945 | =item binmode() can be used to set :crlf and :raw modes | |
5946 | ||
5947 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" | |
5948 | ||
5949 | =item system(), backticks and pipe open now reflect exec() failure | |
5950 | ||
5951 | =item Improved diagnostics | |
5952 | ||
5953 | =item Diagnostics follow STDERR | |
5954 | ||
5955 | =item More consistent close-on-exec behavior | |
5956 | ||
5957 | =item syswrite() ease-of-use | |
5958 | ||
5959 | =item Better syntax checks on parenthesized unary operators | |
5960 | ||
5961 | =item Bit operators support full native integer width | |
5962 | ||
5963 | =item Improved security features | |
5964 | ||
5965 | =item More functional bareword prototype (*) | |
5966 | ||
5967 | =item C<require> and C<do> may be overridden | |
5968 | ||
5969 | =item $^X variables may now have names longer than one character | |
5970 | ||
5971 | =item New variable $^C reflects C<-c> switch | |
5972 | ||
5973 | =item New variable $^V contains Perl version as a string | |
5974 | ||
5975 | =item Optional Y2K warnings | |
5976 | ||
5977 | =item Arrays now always interpolate into double-quoted strings | |
5978 | ||
5979 | =back | |
5980 | ||
5981 | =item Modules and Pragmata | |
5982 | ||
5983 | =over 4 | |
5984 | ||
5985 | =item Modules | |
5986 | ||
5987 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, | |
5988 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
5989 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
5990 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
5991 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
5992 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
5993 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
5994 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
5995 | ||
5996 | =item Pragmata | |
5997 | ||
5998 | =back | |
5999 | ||
6000 | =item Utility Changes | |
6001 | ||
6002 | =over 4 | |
6003 | ||
6004 | =item dprofpp | |
6005 | ||
6006 | =item find2perl | |
6007 | ||
6008 | =item h2xs | |
6009 | ||
6010 | =item perlcc | |
6011 | ||
6012 | =item perldoc | |
6013 | ||
6014 | =item The Perl Debugger | |
6015 | ||
6016 | =back | |
6017 | ||
6018 | =item Improved Documentation | |
6019 | ||
6020 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, | |
6021 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
6022 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
6023 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
6024 | ||
6025 | =item Performance enhancements | |
6026 | ||
6027 | =over 4 | |
6028 | ||
6029 | =item Simple sort() using { $a <=> $b } and the like are optimized | |
6030 | ||
6031 | =item Optimized assignments to lexical variables | |
6032 | ||
6033 | =item Faster subroutine calls | |
6034 | ||
6035 | =item delete(), each(), values() and hash iteration are faster | |
6036 | ||
6037 | =back | |
6038 | ||
6039 | =item Installation and Configuration Improvements | |
6040 | ||
6041 | =over 4 | |
6042 | ||
6043 | =item -Dusethreads means something different | |
6044 | ||
6045 | =item New Configure flags | |
6046 | ||
6047 | =item Threadedness and 64-bitness now more daring | |
6048 | ||
6049 | =item Long Doubles | |
6050 | ||
6051 | =item -Dusemorebits | |
6052 | ||
6053 | =item -Duselargefiles | |
6054 | ||
6055 | =item installusrbinperl | |
6056 | ||
6057 | =item SOCKS support | |
6058 | ||
6059 | =item C<-A> flag | |
6060 | ||
6061 | =item Enhanced Installation Directories | |
6062 | ||
6063 | =item gcc automatically tried if 'cc' does not seem to be working | |
6064 | ||
6065 | =back | |
6066 | ||
6067 | =item Platform specific changes | |
6068 | ||
6069 | =over 4 | |
6070 | ||
6071 | =item Supported platforms | |
6072 | ||
6073 | =item DOS | |
6074 | ||
6075 | =item OS390 (OpenEdition MVS) | |
6076 | ||
6077 | =item VMS | |
6078 | ||
6079 | =item Win32 | |
6080 | ||
6081 | =back | |
6082 | ||
6083 | =item Significant bug fixes | |
6084 | ||
6085 | =over 4 | |
6086 | ||
6087 | =item <HANDLE> on empty files | |
6088 | ||
6089 | =item C<eval '...'> improvements | |
6090 | ||
6091 | =item All compilation errors are true errors | |
6092 | ||
6093 | =item Implicitly closed filehandles are safer | |
6094 | ||
6095 | =item Behavior of list slices is more consistent | |
6096 | ||
6097 | =item C<(\$)> prototype and C<$foo{a}> | |
6098 | ||
6099 | =item C<goto &sub> and AUTOLOAD | |
6100 | ||
6101 | =item C<-bareword> allowed under C<use integer> | |
6102 | ||
6103 | =item Failures in DESTROY() | |
6104 | ||
6105 | =item Locale bugs fixed | |
6106 | ||
6107 | =item Memory leaks | |
6108 | ||
6109 | =item Spurious subroutine stubs after failed subroutine calls | |
6110 | ||
6111 | =item Taint failures under C<-U> | |
6112 | ||
6113 | =item END blocks and the C<-c> switch | |
6114 | ||
6115 | =item Potential to leak DATA filehandles | |
6116 | ||
6117 | =back | |
6118 | ||
6119 | =item New or Changed Diagnostics | |
6120 | ||
6121 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet | |
6122 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
6123 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
6124 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
6125 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
6126 | passed through, /%s/ should probably be written as "%s", %s() called too | |
6127 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
6128 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
6129 | subroutine name, %s package attribute may clash with future reserved word: | |
6130 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
6131 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
6132 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
6133 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
6134 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
6135 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
6136 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
6137 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
6138 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
6139 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
6140 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
6141 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
6142 | "local" instead of "our"?), Document contains no data, entering effective | |
6143 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
6144 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
6145 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
6146 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
6147 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
6148 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
6149 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
6150 | separator character %s in attribute list, Invalid separator character %s in | |
6151 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
6152 | returning %s not implemented yet, Method %s not permitted, Missing | |
6153 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
6154 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
6155 | No space allowed after -%c, no UTC offset information; assuming local time | |
6156 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
6157 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
6158 | around "%s" list, Possible unintended interpolation of %s in string, | |
6159 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
6160 | instead, Premature end of script headers, Repeat count in pack overflows, | |
6161 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
6162 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
6163 | zero-length expression, switching effective %s is not implemented, This | |
6164 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
6165 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
6166 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
6167 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
6168 | list, Unterminated attribute list, Unterminated attribute parameter in | |
6169 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
6170 | CLI symbol "%s" too long, Version number must be a constant number | |
6171 | ||
6172 | =item New tests | |
6173 | ||
6174 | =item Incompatible Changes | |
6175 | ||
6176 | =over 4 | |
6177 | ||
6178 | =item Perl Source Incompatibilities | |
6179 | ||
6180 | CHECK is a new keyword, Treatment of list slices of undef has changed, | |
6181 | Format of $English::PERL_VERSION is different, Literals of the form | |
6182 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
6183 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
6184 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
6185 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), | |
6186 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
6187 | Text of some diagnostic output has changed, C<%@> has been removed, | |
6188 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
6189 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
6190 | on 64-bit platforms, More builtins taint their results | |
6191 | ||
6192 | =item C Source Incompatibilities | |
6193 | ||
6194 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> | |
6195 | ||
6196 | =item Compatible C Source API Changes | |
6197 | ||
6198 | C<PATCHLEVEL> is now C<PERL_VERSION> | |
6199 | ||
6200 | =item Binary Incompatibilities | |
6201 | ||
6202 | =back | |
6203 | ||
6204 | =item Known Problems | |
6205 | ||
6206 | =over 4 | |
6207 | ||
6208 | =item Localizing a tied hash element may leak memory | |
6209 | ||
6210 | =item Known test failures | |
6211 | ||
6212 | =item EBCDIC platforms not fully supported | |
6213 | ||
6214 | =item UNICOS/mk CC failures during Configure run | |
6215 | ||
6216 | =item Arrow operator and arrays | |
6217 | ||
6218 | =item Experimental features | |
6219 | ||
6220 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The | |
6221 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
6222 | globbing, The DB module, The regular expression code constructs: | |
6223 | ||
6224 | =back | |
6225 | ||
6226 | =item Obsolete Diagnostics | |
6227 | ||
6228 | Character class syntax [: :] is reserved for future extensions, Ill-formed | |
6229 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
6230 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
6231 | to mean "${$}<digit>" is deprecated | |
6232 | ||
6233 | =item Reporting Bugs | |
6234 | ||
6235 | =item SEE ALSO | |
6236 | ||
6237 | =item HISTORY | |
6238 | ||
6239 | =back | |
6240 | ||
6241 | =head2 perl56delta - what's new for perl v5.6.0 | |
6242 | ||
6243 | =over 4 | |
6244 | ||
6245 | =item DESCRIPTION | |
6246 | ||
6247 | =item Core Enhancements | |
6248 | ||
6249 | =over 4 | |
6250 | ||
6251 | =item Interpreter cloning, threads, and concurrency | |
6252 | ||
6253 | =item Lexically scoped warning categories | |
6254 | ||
6255 | =item Unicode and UTF-8 support | |
6256 | ||
6257 | =item Support for interpolating named characters | |
6258 | ||
6259 | =item "our" declarations | |
6260 | ||
6261 | =item Support for strings represented as a vector of ordinals | |
6262 | ||
6263 | =item Improved Perl version numbering system | |
6264 | ||
6265 | =item New syntax for declaring subroutine attributes | |
6266 | ||
6267 | =item File and directory handles can be autovivified | |
6268 | ||
6269 | =item open() with more than two arguments | |
6270 | ||
6271 | =item 64-bit support | |
6272 | ||
6273 | =item Large file support | |
6274 | ||
6275 | =item Long doubles | |
6276 | ||
6277 | =item "more bits" | |
6278 | ||
6279 | =item Enhanced support for sort() subroutines | |
6280 | ||
6281 | =item C<sort $coderef @foo> allowed | |
6282 | ||
6283 | =item File globbing implemented internally | |
6284 | ||
6285 | =item Support for CHECK blocks | |
6286 | ||
6287 | =item POSIX character class syntax [: :] supported | |
6288 | ||
6289 | =item Better pseudo-random number generator | |
6290 | ||
6291 | =item Improved C<qw//> operator | |
6292 | ||
6293 | =item Better worst-case behavior of hashes | |
6294 | ||
6295 | =item pack() format 'Z' supported | |
6296 | ||
6297 | =item pack() format modifier '!' supported | |
6298 | ||
6299 | =item pack() and unpack() support counted strings | |
6300 | ||
6301 | =item Comments in pack() templates | |
6302 | ||
6303 | =item Weak references | |
6304 | ||
6305 | =item Binary numbers supported | |
6306 | ||
6307 | =item Lvalue subroutines | |
6308 | ||
6309 | =item Some arrows may be omitted in calls through references | |
6310 | ||
6311 | =item Boolean assignment operators are legal lvalues | |
6312 | ||
6313 | =item exists() is supported on subroutine names | |
6314 | ||
6315 | =item exists() and delete() are supported on array elements | |
6316 | ||
6317 | =item Pseudo-hashes work better | |
6318 | ||
6319 | =item Automatic flushing of output buffers | |
6320 | ||
6321 | =item Better diagnostics on meaningless filehandle operations | |
6322 | ||
6323 | =item Where possible, buffered data discarded from duped input filehandle | |
6324 | ||
6325 | =item eof() has the same old magic as <> | |
6326 | ||
6327 | =item binmode() can be used to set :crlf and :raw modes | |
6328 | ||
6329 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" | |
6330 | ||
6331 | =item system(), backticks and pipe open now reflect exec() failure | |
6332 | ||
6333 | =item Improved diagnostics | |
6334 | ||
6335 | =item Diagnostics follow STDERR | |
6336 | ||
6337 | =item More consistent close-on-exec behavior | |
6338 | ||
6339 | =item syswrite() ease-of-use | |
6340 | ||
6341 | =item Better syntax checks on parenthesized unary operators | |
6342 | ||
6343 | =item Bit operators support full native integer width | |
6344 | ||
6345 | =item Improved security features | |
6346 | ||
6347 | =item More functional bareword prototype (*) | |
6348 | ||
6349 | =item C<require> and C<do> may be overridden | |
6350 | ||
6351 | =item $^X variables may now have names longer than one character | |
6352 | ||
6353 | =item New variable $^C reflects C<-c> switch | |
6354 | ||
6355 | =item New variable $^V contains Perl version as a string | |
6356 | ||
6357 | =item Optional Y2K warnings | |
6358 | ||
6359 | =item Arrays now always interpolate into double-quoted strings | |
6360 | ||
6361 | =back | |
6362 | ||
6363 | =item Modules and Pragmata | |
6364 | ||
6365 | =over 4 | |
6366 | ||
6367 | =item Modules | |
6368 | ||
6369 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, | |
6370 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
6371 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
6372 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
6373 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
6374 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
6375 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
6376 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
6377 | ||
6378 | =item Pragmata | |
6379 | ||
6380 | =back | |
6381 | ||
6382 | =item Utility Changes | |
6383 | ||
6384 | =over 4 | |
6385 | ||
6386 | =item dprofpp | |
6387 | ||
6388 | =item find2perl | |
6389 | ||
6390 | =item h2xs | |
6391 | ||
6392 | =item perlcc | |
6393 | ||
6394 | =item perldoc | |
6395 | ||
6396 | =item The Perl Debugger | |
6397 | ||
6398 | =back | |
6399 | ||
6400 | =item Improved Documentation | |
6401 | ||
6402 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, | |
6403 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
6404 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
6405 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
6406 | ||
6407 | =item Performance enhancements | |
6408 | ||
6409 | =over 4 | |
6410 | ||
6411 | =item Simple sort() using { $a <=> $b } and the like are optimized | |
6412 | ||
6413 | =item Optimized assignments to lexical variables | |
6414 | ||
6415 | =item Faster subroutine calls | |
6416 | ||
6417 | =item delete(), each(), values() and hash iteration are faster | |
6418 | ||
6419 | =back | |
6420 | ||
6421 | =item Installation and Configuration Improvements | |
6422 | ||
6423 | =over 4 | |
6424 | ||
6425 | =item -Dusethreads means something different | |
6426 | ||
6427 | =item New Configure flags | |
6428 | ||
6429 | =item Threadedness and 64-bitness now more daring | |
6430 | ||
6431 | =item Long Doubles | |
6432 | ||
6433 | =item -Dusemorebits | |
6434 | ||
6435 | =item -Duselargefiles | |
6436 | ||
6437 | =item installusrbinperl | |
6438 | ||
6439 | =item SOCKS support | |
6440 | ||
6441 | =item C<-A> flag | |
6442 | ||
6443 | =item Enhanced Installation Directories | |
6444 | ||
6445 | =back | |
6446 | ||
6447 | =item Platform specific changes | |
6448 | ||
6449 | =over 4 | |
6450 | ||
6451 | =item Supported platforms | |
6452 | ||
6453 | =item DOS | |
6454 | ||
6455 | =item OS390 (OpenEdition MVS) | |
6456 | ||
6457 | =item VMS | |
6458 | ||
6459 | =item Win32 | |
6460 | ||
6461 | =back | |
6462 | ||
6463 | =item Significant bug fixes | |
6464 | ||
6465 | =over 4 | |
6466 | ||
6467 | =item <HANDLE> on empty files | |
6468 | ||
6469 | =item C<eval '...'> improvements | |
6470 | ||
6471 | =item All compilation errors are true errors | |
6472 | ||
6473 | =item Implicitly closed filehandles are safer | |
6474 | ||
6475 | =item Behavior of list slices is more consistent | |
6476 | ||
6477 | =item C<(\$)> prototype and C<$foo{a}> | |
6478 | ||
6479 | =item C<goto &sub> and AUTOLOAD | |
6480 | ||
6481 | =item C<-bareword> allowed under C<use integer> | |
6482 | ||
6483 | =item Failures in DESTROY() | |
6484 | ||
6485 | =item Locale bugs fixed | |
6486 | ||
6487 | =item Memory leaks | |
6488 | ||
6489 | =item Spurious subroutine stubs after failed subroutine calls | |
6490 | ||
6491 | =item Taint failures under C<-U> | |
6492 | ||
6493 | =item END blocks and the C<-c> switch | |
6494 | ||
6495 | =item Potential to leak DATA filehandles | |
6496 | ||
6497 | =back | |
6498 | ||
6499 | =item New or Changed Diagnostics | |
6500 | ||
6501 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet | |
6502 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
6503 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
6504 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
6505 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
6506 | passed through, /%s/ should probably be written as "%s", %s() called too | |
6507 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
6508 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
6509 | subroutine name, %s package attribute may clash with future reserved word: | |
6510 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
6511 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
6512 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
6513 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
6514 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
6515 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
6516 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
6517 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
6518 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
6519 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
6520 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
6521 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
6522 | "local" instead of "our"?), Document contains no data, entering effective | |
6523 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
6524 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
6525 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
6526 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
6527 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
6528 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
6529 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
6530 | separator character %s in attribute list, Invalid separator character %s in | |
6531 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
6532 | returning %s not implemented yet, Method %s not permitted, Missing | |
6533 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
6534 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
6535 | No space allowed after -%c, no UTC offset information; assuming local time | |
6536 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
6537 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
6538 | around "%s" list, Possible unintended interpolation of %s in string, | |
6539 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
6540 | instead, Premature end of script headers, Repeat count in pack overflows, | |
6541 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
6542 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
6543 | zero-length expression, switching effective %s is not implemented, This | |
6544 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
6545 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
6546 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
6547 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
6548 | list, Unterminated attribute list, Unterminated attribute parameter in | |
6549 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
6550 | CLI symbol "%s" too long, Version number must be a constant number | |
6551 | ||
6552 | =item New tests | |
6553 | ||
6554 | =item Incompatible Changes | |
6555 | ||
6556 | =over 4 | |
6557 | ||
6558 | =item Perl Source Incompatibilities | |
6559 | ||
6560 | CHECK is a new keyword, Treatment of list slices of undef has changed, | |
6561 | Format of $English::PERL_VERSION is different, Literals of the form | |
6562 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
6563 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
6564 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
6565 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), | |
6566 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
6567 | Text of some diagnostic output has changed, C<%@> has been removed, | |
6568 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
6569 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
6570 | on 64-bit platforms, More builtins taint their results | |
6571 | ||
6572 | =item C Source Incompatibilities | |
6573 | ||
6574 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> | |
6575 | ||
6576 | =item Compatible C Source API Changes | |
6577 | ||
6578 | C<PATCHLEVEL> is now C<PERL_VERSION> | |
6579 | ||
6580 | =item Binary Incompatibilities | |
6581 | ||
6582 | =back | |
6583 | ||
6584 | =item Known Problems | |
6585 | ||
6586 | =over 4 | |
6587 | ||
6588 | =item Thread test failures | |
6589 | ||
6590 | =item EBCDIC platforms not supported | |
6591 | ||
6592 | =item In 64-bit HP-UX the lib/io_multihomed test may hang | |
6593 | ||
6594 | =item NEXTSTEP 3.3 POSIX test failure | |
6595 | ||
6596 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with | |
6597 | gcc | |
6598 | ||
6599 | =item UNICOS/mk CC failures during Configure run | |
6600 | ||
6601 | =item Arrow operator and arrays | |
6602 | ||
6603 | =item Experimental features | |
6604 | ||
6605 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The | |
6606 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
6607 | globbing, The DB module, The regular expression code constructs: | |
6608 | ||
6609 | =back | |
6610 | ||
6611 | =item Obsolete Diagnostics | |
6612 | ||
6613 | Character class syntax [: :] is reserved for future extensions, Ill-formed | |
6614 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
6615 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
6616 | to mean "${$}<digit>" is deprecated | |
6617 | ||
6618 | =item Reporting Bugs | |
6619 | ||
6620 | =item SEE ALSO | |
6621 | ||
6622 | =item HISTORY | |
6623 | ||
6624 | =back | |
6625 | ||
6626 | =head2 perl5005delta - what's new for perl5.005 | |
6627 | ||
6628 | =over 4 | |
6629 | ||
6630 | =item DESCRIPTION | |
6631 | ||
6632 | =item About the new versioning system | |
6633 | ||
6634 | =item Incompatible Changes | |
6635 | ||
6636 | =over 4 | |
6637 | ||
6638 | =item WARNING: This version is not binary compatible with Perl 5.004. | |
6639 | ||
6640 | =item Default installation structure has changed | |
6641 | ||
6642 | =item Perl Source Compatibility | |
6643 | ||
6644 | =item C Source Compatibility | |
6645 | ||
6646 | =item Binary Compatibility | |
6647 | ||
6648 | =item Security fixes may affect compatibility | |
6649 | ||
6650 | =item Relaxed new mandatory warnings introduced in 5.004 | |
6651 | ||
6652 | =item Licensing | |
6653 | ||
6654 | =back | |
6655 | ||
6656 | =item Core Changes | |
6657 | ||
6658 | =over 4 | |
6659 | ||
6660 | =item Threads | |
6661 | ||
6662 | =item Compiler | |
6663 | ||
6664 | =item Regular Expressions | |
6665 | ||
6666 | Many new and improved optimizations, Many bug fixes, New regular expression | |
6667 | constructs, New operator for precompiled regular expressions, Other | |
6668 | improvements, Incompatible changes | |
6669 | ||
6670 | =item Improved malloc() | |
6671 | ||
6672 | =item Quicksort is internally implemented | |
6673 | ||
6674 | =item Reliable signals | |
6675 | ||
6676 | =item Reliable stack pointers | |
6677 | ||
6678 | =item More generous treatment of carriage returns | |
6679 | ||
6680 | =item Memory leaks | |
6681 | ||
6682 | =item Better support for multiple interpreters | |
6683 | ||
6684 | =item Behavior of local() on array and hash elements is now well-defined | |
6685 | ||
6686 | =item C<%!> is transparently tied to the L<Errno> module | |
6687 | ||
6688 | =item Pseudo-hashes are supported | |
6689 | ||
6690 | =item C<EXPR foreach EXPR> is supported | |
6691 | ||
6692 | =item Keywords can be globally overridden | |
6693 | ||
6694 | =item C<$^E> is meaningful on Win32 | |
6695 | ||
6696 | =item C<foreach (1..1000000)> optimized | |
6697 | ||
6698 | =item C<Foo::> can be used as implicitly quoted package name | |
6699 | ||
6700 | =item C<exists $Foo::{Bar::}> tests existence of a package | |
6701 | ||
6702 | =item Better locale support | |
6703 | ||
6704 | =item Experimental support for 64-bit platforms | |
6705 | ||
6706 | =item prototype() returns useful results on builtins | |
6707 | ||
6708 | =item Extended support for exception handling | |
6709 | ||
6710 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods | |
6711 | ||
6712 | =item All C<printf> format conversions are handled internally | |
6713 | ||
6714 | =item New C<INIT> keyword | |
6715 | ||
6716 | =item New C<lock> keyword | |
6717 | ||
6718 | =item New C<qr//> operator | |
6719 | ||
6720 | =item C<our> is now a reserved word | |
6721 | ||
6722 | =item Tied arrays are now fully supported | |
6723 | ||
6724 | =item Tied handles support is better | |
6725 | ||
6726 | =item 4th argument to substr | |
6727 | ||
6728 | =item Negative LENGTH argument to splice | |
6729 | ||
6730 | =item Magic lvalues are now more magical | |
6731 | ||
6732 | =item <> now reads in records | |
6733 | ||
6734 | =back | |
6735 | ||
6736 | =item Supported Platforms | |
6737 | ||
6738 | =over 4 | |
6739 | ||
6740 | =item New Platforms | |
6741 | ||
6742 | =item Changes in existing support | |
6743 | ||
6744 | =back | |
6745 | ||
6746 | =item Modules and Pragmata | |
6747 | ||
6748 | =over 4 | |
6749 | ||
6750 | =item New Modules | |
6751 | ||
6752 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, | |
6753 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
6754 | Thread, attrs, fields, re | |
6755 | ||
6756 | =item Changes in existing modules | |
6757 | ||
6758 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, | |
6759 | MakeMaker, CPAN, Cwd | |
6760 | ||
6761 | =back | |
6762 | ||
6763 | =item Utility Changes | |
6764 | ||
6765 | =item Documentation Changes | |
6766 | ||
6767 | =item New Diagnostics | |
6768 | ||
6769 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
6770 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
6771 | package, Can't call method "%s" on an undefined value, Can't check | |
6772 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
6773 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
6774 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
6775 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
6776 | Character class syntax [: :] is reserved for future extensions, Character | |
6777 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
6778 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
6779 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
6780 | package main), Illegal hex digit ignored, No such array field, No such | |
6781 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
6782 | large request, Range iterator outside integer range, Recursive inheritance | |
6783 | detected while looking for method '%s' %s, Reference found where even-sized | |
6784 | list expected, Undefined value assigned to typeglob, Use of reserved word | |
6785 | "%s" is deprecated, perl: warning: Setting locale failed | |
6786 | ||
6787 | =item Obsolete Diagnostics | |
6788 | ||
6789 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open | |
6790 | temporary file, regexp too big | |
6791 | ||
6792 | =item Configuration Changes | |
6793 | ||
6794 | =item BUGS | |
6795 | ||
6796 | =item SEE ALSO | |
6797 | ||
6798 | =item HISTORY | |
6799 | ||
6800 | =back | |
6801 | ||
6802 | =head2 perl5004delta - what's new for perl5.004 | |
6803 | ||
6804 | =over 4 | |
6805 | ||
6806 | =item DESCRIPTION | |
6807 | ||
6808 | =item Supported Environments | |
6809 | ||
6810 | =item Core Changes | |
6811 | ||
6812 | =over 4 | |
6813 | ||
6814 | =item List assignment to %ENV works | |
6815 | ||
6816 | =item Change to "Can't locate Foo.pm in @INC" error | |
6817 | ||
6818 | =item Compilation option: Binary compatibility with 5.003 | |
6819 | ||
6820 | =item $PERL5OPT environment variable | |
6821 | ||
6822 | =item Limitations on B<-M>, B<-m>, and B<-T> options | |
6823 | ||
6824 | =item More precise warnings | |
6825 | ||
6826 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods | |
6827 | ||
6828 | =item Previously deprecated %OVERLOAD is no longer usable | |
6829 | ||
6830 | =item Subroutine arguments created only when they're modified | |
6831 | ||
6832 | =item Group vector changeable with C<$)> | |
6833 | ||
6834 | =item Fixed parsing of $$<digit>, &$<digit>, etc. | |
6835 | ||
6836 | =item Fixed localization of $<digit>, $&, etc. | |
6837 | ||
6838 | =item No resetting of $. on implicit close | |
6839 | ||
6840 | =item C<wantarray> may return undef | |
6841 | ||
6842 | =item C<eval EXPR> determines value of EXPR in scalar context | |
6843 | ||
6844 | =item Changes to tainting checks | |
6845 | ||
6846 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No | |
6847 | spawning if tainted $TERM doesn't look like a terminal name | |
6848 | ||
6849 | =item New Opcode module and revised Safe module | |
6850 | ||
6851 | =item Embedding improvements | |
6852 | ||
6853 | =item Internal change: FileHandle class based on IO::* classes | |
6854 | ||
6855 | =item Internal change: PerlIO abstraction interface | |
6856 | ||
6857 | =item New and changed syntax | |
6858 | ||
6859 | $coderef->(PARAMS) | |
6860 | ||
6861 | =item New and changed builtin constants | |
6862 | ||
6863 | __PACKAGE__ | |
6864 | ||
6865 | =item New and changed builtin variables | |
6866 | ||
6867 | $^E, $^H, $^M | |
6868 | ||
6869 | =item New and changed builtin functions | |
6870 | ||
6871 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in | |
6872 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
6873 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
6874 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
6875 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
6876 | ||
6877 | =item New builtin methods | |
6878 | ||
6879 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
6880 | ||
6881 | =item TIEHANDLE now supported | |
6882 | ||
6883 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this | |
6884 | LIST, READLINE this, GETC this, DESTROY this | |
6885 | ||
6886 | =item Malloc enhancements | |
6887 | ||
6888 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE | |
6889 | ||
6890 | =item Miscellaneous efficiency enhancements | |
6891 | ||
6892 | =back | |
6893 | ||
6894 | =item Support for More Operating Systems | |
6895 | ||
6896 | =over 4 | |
6897 | ||
6898 | =item Win32 | |
6899 | ||
6900 | =item Plan 9 | |
6901 | ||
6902 | =item QNX | |
6903 | ||
6904 | =item AmigaOS | |
6905 | ||
6906 | =back | |
6907 | ||
6908 | =item Pragmata | |
6909 | ||
6910 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
6911 | constant NAME => VALUE, use locale, use ops, use vmsish | |
6912 | ||
6913 | =item Modules | |
6914 | ||
6915 | =over 4 | |
6916 | ||
6917 | =item Required Updates | |
6918 | ||
6919 | =item Installation directories | |
6920 | ||
6921 | =item Module information summary | |
6922 | ||
6923 | =item Fcntl | |
6924 | ||
6925 | =item IO | |
6926 | ||
6927 | =item Math::Complex | |
6928 | ||
6929 | =item Math::Trig | |
6930 | ||
6931 | =item DB_File | |
6932 | ||
6933 | =item Net::Ping | |
6934 | ||
6935 | =item Object-oriented overrides for builtin operators | |
6936 | ||
6937 | =back | |
6938 | ||
6939 | =item Utility Changes | |
6940 | ||
6941 | =over 4 | |
6942 | ||
6943 | =item pod2html | |
6944 | ||
6945 | Sends converted HTML to standard output | |
6946 | ||
6947 | =item xsubpp | |
6948 | ||
6949 | C<void> XSUBs now default to returning nothing | |
6950 | ||
6951 | =back | |
6952 | ||
6953 | =item C Language API Changes | |
6954 | ||
6955 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for | |
6956 | manipulating hashes | |
6957 | ||
6958 | =item Documentation Changes | |
6959 | ||
6960 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, | |
6961 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
6962 | ||
6963 | =item New Diagnostics | |
6964 | ||
6965 | "my" variable %s masks earlier declaration in same scope, %s argument is | |
6966 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
6967 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
6968 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
6969 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
6970 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
6971 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
6972 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
6973 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
6974 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
6975 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
6976 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
6977 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
6978 | possible typo, Null picture in formline, Offset outside string, Out of | |
6979 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
6980 | attempt to put comments in qw() list, Possible attempt to separate words | |
6981 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
6982 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" | |
6983 | option, untie attempted while %d inner references still exist, Unrecognized | |
6984 | character %s, Unsupported function fork, Use of "$$<digit>" to mean | |
6985 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), | |
6986 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, | |
6987 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, | |
6988 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too | |
6989 | long, Process terminated by SIG%s | |
6990 | ||
6991 | =item BUGS | |
6992 | ||
6993 | =item SEE ALSO | |
6994 | ||
6995 | =item HISTORY | |
6996 | ||
6997 | =back | |
6998 | ||
6999 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems | |
7000 | ||
7001 | =over 4 | |
7002 | ||
7003 | =item DESCRIPTION | |
7004 | ||
7005 | =over 4 | |
7006 | ||
7007 | =item Compiling Perl 5 on AIX | |
7008 | ||
7009 | =item OS level | |
7010 | ||
7011 | =item Building Dynamic Extensions on AIX | |
7012 | ||
7013 | =item The IBM ANSI C Compiler | |
7014 | ||
7015 | =item Using GNU's gcc for building perl | |
7016 | ||
7017 | =item Using Large Files with Perl | |
7018 | ||
7019 | =item Threaded Perl | |
7020 | ||
7021 | =item 64-bit Perl | |
7022 | ||
7023 | =item AIX 4.2 and extensions using C++ with statics | |
7024 | ||
7025 | =back | |
7026 | ||
7027 | =item AUTHOR | |
7028 | ||
7029 | =item DATE | |
7030 | ||
7031 | =back | |
7032 | ||
7033 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS | |
7034 | ||
7035 | =over 4 | |
7036 | ||
7037 | =item DESCRIPTION | |
7038 | ||
7039 | =item AUTHOR | |
7040 | ||
7041 | =back | |
7042 | ||
7043 | =head2 perlamiga - Perl under Amiga OS | |
7044 | ||
7045 | =over 4 | |
7046 | ||
7047 | =item NOTE | |
7048 | ||
7049 | =item SYNOPSIS | |
7050 | ||
7051 | =back | |
7052 | ||
7053 | =over 4 | |
7054 | ||
7055 | =item DESCRIPTION | |
7056 | ||
7057 | =over 4 | |
7058 | ||
7059 | =item Prerequisites for Compiling Perl on AmigaOS | |
7060 | ||
7061 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> | |
7062 | ||
7063 | =item Starting Perl programs under AmigaOS | |
7064 | ||
7065 | =item Shortcomings of Perl under AmigaOS | |
7066 | ||
7067 | =back | |
7068 | ||
7069 | =item INSTALLATION | |
7070 | ||
7071 | =item Accessing documentation | |
7072 | ||
7073 | =over 4 | |
7074 | ||
7075 | =item Manpages for Perl on AmigaOS | |
7076 | ||
7077 | =item Perl HTML Documentation on AmigaOS | |
7078 | ||
7079 | =item Perl GNU Info Files on AmigaOS | |
7080 | ||
7081 | =item Perl LaTeX Documentation on AmigaOS | |
7082 | ||
7083 | =back | |
7084 | ||
7085 | =item BUILDING PERL ON AMIGAOS | |
7086 | ||
7087 | =over 4 | |
7088 | ||
7089 | =item Build Prerequisites for Perl on AmigaOS | |
7090 | ||
7091 | =item Getting the Perl Source for AmigaOS | |
7092 | ||
7093 | =item Making Perl on AmigaOS | |
7094 | ||
7095 | =item Testing Perl on AmigaOS | |
7096 | ||
7097 | =item Installing the built Perl on AmigaOS | |
7098 | ||
7099 | =back | |
7100 | ||
7101 | =item PERL 5.8.0 BROKEN IN AMIGAOS | |
7102 | ||
7103 | =item AUTHORS | |
7104 | ||
7105 | =item SEE ALSO | |
7106 | ||
7107 | =back | |
7108 | ||
7109 | =head2 perlbeos, README.beos - Perl version 5 on BeOS | |
7110 | ||
7111 | =over 4 | |
7112 | ||
7113 | =item DESCRIPTION | |
7114 | ||
7115 | =over 4 | |
7116 | ||
7117 | =item General Issues with Perl on BeOS | |
7118 | ||
7119 | =item BeOS Release-specific Notes | |
7120 | ||
7121 | R4 x86, R4 PPC | |
7122 | ||
7123 | =item Contact Information | |
7124 | ||
7125 | =item Update 2002-05-30 | |
7126 | ||
7127 | =back | |
7128 | ||
7129 | =back | |
7130 | ||
7131 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. | |
7132 | ||
7133 | =over 4 | |
7134 | ||
7135 | =item SYNOPSIS | |
7136 | ||
7137 | =item DESCRIPTION | |
7138 | ||
7139 | =over 4 | |
7140 | ||
7141 | =item gzip on BS2000 | |
7142 | ||
7143 | =item bison on BS2000 | |
7144 | ||
7145 | =item Unpacking Perl Distribution on BS2000 | |
7146 | ||
7147 | =item Compiling Perl on BS2000 | |
7148 | ||
7149 | =item Testing Perl on BS2000 | |
7150 | ||
7151 | =item Installing Perl on BS2000 | |
7152 | ||
7153 | =item Using Perl in the Posix-Shell of BS2000 | |
7154 | ||
7155 | =item Using Perl in "native" BS2000 | |
7156 | ||
7157 | =item Floating point anomalies on BS2000 | |
7158 | ||
7159 | =back | |
7160 | ||
7161 | =item AUTHORS | |
7162 | ||
7163 | =item SEE ALSO | |
7164 | ||
7165 | =over 4 | |
7166 | ||
7167 | =item Mailing list | |
7168 | ||
7169 | =back | |
7170 | ||
7171 | =item HISTORY | |
7172 | ||
7173 | =back | |
7174 | ||
7175 | =over 4 | |
7176 | ||
7177 | =item Name | |
7178 | ||
7179 | =item Description | |
7180 | ||
7181 | =item Build | |
7182 | ||
7183 | =over 4 | |
7184 | ||
7185 | =item Tools & SDK | |
7186 | ||
7187 | =item Make | |
7188 | ||
7189 | =back | |
7190 | ||
7191 | =item Acknowledgements | |
7192 | ||
7193 | =item Author | |
7194 | ||
7195 | =back | |
7196 | ||
7197 | =head2 perlcygwin, README.cygwin - Perl for Cygwin | |
7198 | ||
7199 | =over 4 | |
7200 | ||
7201 | =item SYNOPSIS | |
7202 | ||
7203 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN | |
7204 | ||
7205 | =over 4 | |
7206 | ||
7207 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) | |
7208 | ||
7209 | =item Cygwin Configuration | |
7210 | ||
7211 | C<PATH>, I<nroff>, Permissions | |
7212 | ||
7213 | =back | |
7214 | ||
7215 | =item CONFIGURE PERL ON CYGWIN | |
7216 | ||
7217 | =over 4 | |
7218 | ||
7219 | =item Stripping Perl Binaries on Cygwin | |
7220 | ||
7221 | =item Optional Libraries for Perl on Cygwin | |
7222 | ||
7223 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), | |
7224 | C<-lcygipc> (C<use IPC::SysV>), C<-lutil> | |
7225 | ||
7226 | =item Configure-time Options for Perl on Cygwin | |
7227 | ||
7228 | C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, | |
7229 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, | |
7230 | C<-Dmksymlinks> | |
7231 | ||
7232 | =item Suspicious Warnings on Cygwin | |
7233 | ||
7234 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines | |
7235 | ||
7236 | =back | |
7237 | ||
7238 | =item MAKE ON CYGWIN | |
7239 | ||
7240 | =over 4 | |
7241 | ||
7242 | =item Warnings on Cygwin | |
7243 | ||
7244 | =item ld2 on Cygwin | |
7245 | ||
7246 | =back | |
7247 | ||
7248 | =item TEST ON CYGWIN | |
7249 | ||
7250 | =over 4 | |
7251 | ||
7252 | =item File Permissions on Cygwin | |
7253 | ||
7254 | =item NDBM_File does not work on FAT filesystems | |
7255 | ||
7256 | =item Script Portability on Cygwin | |
7257 | ||
7258 | Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous | |
7259 | ||
7260 | =back | |
7261 | ||
7262 | =item INSTALL PERL ON CYGWIN | |
7263 | ||
7264 | =item MANIFEST ON CYGWIN | |
7265 | ||
7266 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl | |
7267 | Source, Compiled Module Source, Perl Modules/Scripts | |
7268 | ||
7269 | =item BUGS ON CYGWIN | |
7270 | ||
7271 | =item AUTHORS | |
7272 | ||
7273 | =item HISTORY | |
7274 | ||
7275 | =back | |
7276 | ||
7277 | =head2 perldgux - Perl under DG/UX. | |
7278 | ||
7279 | =over 4 | |
7280 | ||
7281 | =item SYNOPSIS | |
7282 | ||
7283 | =back | |
7284 | ||
7285 | =over 4 | |
7286 | ||
7287 | =item DESCRIPTION | |
7288 | ||
7289 | =item BUILDING PERL ON DG/UX | |
7290 | ||
7291 | =over 4 | |
7292 | ||
7293 | =item Non-threaded Perl on DG/UX | |
7294 | ||
7295 | =item Threaded Perl on DG/UX | |
7296 | ||
7297 | =item Testing Perl on DG/UX | |
7298 | ||
7299 | =item Installing the built perl on DG/UX | |
7300 | ||
7301 | =back | |
7302 | ||
7303 | =item AUTHOR | |
7304 | ||
7305 | =item SEE ALSO | |
7306 | ||
7307 | =back | |
7308 | ||
7309 | =head2 perldos - Perl under DOS, W31, W95. | |
7310 | ||
7311 | =over 4 | |
7312 | ||
7313 | =item SYNOPSIS | |
7314 | ||
7315 | =item DESCRIPTION | |
7316 | ||
7317 | =over 4 | |
7318 | ||
7319 | =item Prerequisites for Compiling Perl on DOS | |
7320 | ||
7321 | DJGPP, Pthreads | |
7322 | ||
7323 | =item Shortcomings of Perl under DOS | |
7324 | ||
7325 | =item Building Perl on DOS | |
7326 | ||
7327 | =item Testing Perl on DOS | |
7328 | ||
7329 | =item Installation of Perl on DOS | |
7330 | ||
7331 | =back | |
7332 | ||
7333 | =item BUILDING AND INSTALLING MODULES ON DOS | |
7334 | ||
7335 | =over 4 | |
7336 | ||
7337 | =item Building Prerequisites for Perl on DOS | |
7338 | ||
7339 | =item Unpacking CPAN Modules on DOS | |
7340 | ||
7341 | =item Building Non-XS Modules on DOS | |
7342 | ||
7343 | =item Building XS Modules on DOS | |
7344 | ||
7345 | =back | |
7346 | ||
7347 | =item AUTHOR | |
7348 | ||
7349 | =item SEE ALSO | |
7350 | ||
7351 | =back | |
7352 | ||
7353 | =head2 perlepoc, README.epoc - Perl for EPOC | |
7354 | ||
7355 | =over 4 | |
7356 | ||
7357 | =item SYNOPSIS | |
7358 | ||
7359 | =item INTRODUCTION | |
7360 | ||
7361 | =item INSTALLING PERL ON EPOC | |
7362 | ||
7363 | =item STARTING PERL ON EPOC | |
7364 | ||
7365 | =over 4 | |
7366 | ||
7367 | =item Editors on Epoc | |
7368 | ||
7369 | =item Features of Perl on Epoc | |
7370 | ||
7371 | =item Restrictions of Perl on Epoc | |
7372 | ||
7373 | =item Compiling Perl 5 on the EPOC cross compiling environment | |
7374 | ||
7375 | =back | |
7376 | ||
7377 | =item SUPPORT STATUS OF PERL ON EPOC | |
7378 | ||
7379 | =item AUTHOR | |
7380 | ||
7381 | =item LAST UPDATE | |
7382 | ||
7383 | =back | |
7384 | ||
7385 | =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems | |
7386 | ||
7387 | =over 4 | |
7388 | ||
7389 | =item DESCRIPTION | |
7390 | ||
7391 | =over 4 | |
7392 | ||
7393 | =item FreeBSD core dumps from readdir_r with ithreads | |
7394 | ||
7395 | =item $^X doesn't always contain a full path in FreeBSD | |
7396 | ||
7397 | =item Perl will no longer be part of "base FreeBSD" | |
7398 | ||
7399 | =back | |
7400 | ||
7401 | =item AUTHOR | |
7402 | ||
7403 | =back | |
7404 | ||
7405 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix | |
7406 | (HP-UX) systems | |
7407 | ||
7408 | =over 4 | |
7409 | ||
7410 | =item DESCRIPTION | |
7411 | ||
7412 | =over 4 | |
7413 | ||
7414 | =item Using perl as shipped with HP-UX | |
7415 | ||
7416 | =item Compiling Perl 5 on HP-UX | |
7417 | ||
7418 | =item PA-RISC | |
7419 | ||
7420 | =item PA-RISC 1.0 | |
7421 | ||
7422 | =item PA-RISC 1.1 | |
7423 | ||
7424 | =item PA-RISC 2.0 | |
7425 | ||
7426 | =item Itanium | |
7427 | ||
7428 | =item Portability Between PA-RISC Versions | |
7429 | ||
7430 | =item Itanium Processor Family and HP-UX | |
7431 | ||
7432 | =item Building Dynamic Extensions on HP-UX | |
7433 | ||
7434 | =item The HP ANSI C Compiler | |
7435 | ||
7436 | =item The GNU C Compiler | |
7437 | ||
7438 | =item Using Large Files with Perl on HP-UX | |
7439 | ||
7440 | =item Threaded Perl on HP-UX | |
7441 | ||
7442 | =item 64-bit Perl on HP-UX | |
7443 | ||
7444 | =item Oracle on HP-UX | |
7445 | ||
7446 | =item GDBM and Threads on HP-UX | |
7447 | ||
7448 | =item NFS filesystems and utime(2) on HP-UX | |
7449 | ||
7450 | =item perl -P and // and HP-UX | |
7451 | ||
7452 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl | |
7453 | ||
7454 | =back | |
7455 | ||
7456 | =item nss_delete core dump from op/pwent or op/grent | |
7457 | ||
7458 | =item AUTHOR | |
7459 | ||
7460 | =item DATE | |
7461 | ||
7462 | =back | |
7463 | ||
7464 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd | |
7465 | ||
7466 | =over 4 | |
7467 | ||
7468 | =item DESCRIPTION | |
7469 | ||
7470 | =over 4 | |
7471 | ||
7472 | =item Known Problems with Perl on Hurd | |
7473 | ||
7474 | =back | |
7475 | ||
7476 | =item AUTHOR | |
7477 | ||
7478 | =back | |
7479 | ||
7480 | =head2 perlirix, README.irix - Perl version 5 on Irix systems | |
7481 | ||
7482 | =over 4 | |
7483 | ||
7484 | =item DESCRIPTION | |
7485 | ||
7486 | =over 4 | |
7487 | ||
7488 | =item Building 32-bit Perl in Irix | |
7489 | ||
7490 | =item Building 64-bit Perl in Irix | |
7491 | ||
7492 | =item About Compiler Versions of Irix | |
7493 | ||
7494 | =item Linker Problems in Irix | |
7495 | ||
7496 | =item Malloc in Irix | |
7497 | ||
7498 | =item Building with threads in Irix | |
7499 | ||
7500 | =back | |
7501 | ||
7502 | =item AUTHOR | |
7503 | ||
7504 | =back | |
7505 | ||
7506 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen | |
7507 | systems | |
7508 | ||
7509 | =over 4 | |
7510 | ||
7511 | =item DESCRIPTION | |
7512 | ||
7513 | =over 4 | |
7514 | ||
7515 | =item Compiling Perl 5 on MachTen | |
7516 | ||
7517 | =item Failures during C<make test> on MachTen | |
7518 | ||
7519 | op/lexassign.t, pragma/warnings.t | |
7520 | ||
7521 | =item Building external modules on MachTen | |
7522 | ||
7523 | =back | |
7524 | ||
7525 | =item AUTHOR | |
7526 | ||
7527 | =item DATE | |
7528 | ||
7529 | =back | |
7530 | ||
7531 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) | |
7532 | ||
7533 | =over 4 | |
7534 | ||
7535 | =item SYNOPSIS | |
7536 | ||
7537 | =item DESCRIPTION | |
7538 | ||
7539 | =item AUTHOR | |
7540 | ||
7541 | =item DATE | |
7542 | ||
7543 | =back | |
7544 | ||
7545 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT | |
7546 | ||
7547 | =over 4 | |
7548 | ||
7549 | =item DESCRIPTION | |
7550 | ||
7551 | =item Known problems with Perl on MiNT | |
7552 | ||
7553 | =item AUTHOR | |
7554 | ||
7555 | =back | |
7556 | ||
7557 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE | |
7558 | ||
7559 | =over 4 | |
7560 | ||
7561 | =item SYNOPSIS | |
7562 | ||
7563 | =item NOTE | |
7564 | ||
7565 | =item Binary distribution from HP | |
7566 | ||
7567 | =item What's New in Perl for MPE/iX | |
7568 | ||
7569 | =item Welcome to Perl/iX | |
7570 | ||
7571 | =item System Requirements for Perl/iX | |
7572 | ||
7573 | =item How to Obtain Perl/iX | |
7574 | ||
7575 | =item Perl/iX Distribution Contents Highlights | |
7576 | ||
7577 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, | |
7578 | public_html/feedback.cgi, src/perl-5.6.0-mpe | |
7579 | ||
7580 | =item How to Compile Perl/iX | |
7581 | ||
7582 | 4, 6 | |
7583 | ||
7584 | =item Getting Started with Perl/iX | |
7585 | ||
7586 | =item MPE/iX Implementation Considerations | |
7587 | ||
7588 | =item Known Perl/iX Bugs Under Investigation | |
7589 | ||
7590 | =item Perl/iX To-Do List | |
7591 | ||
7592 | =item Perl/iX Change History | |
7593 | ||
7594 | =item AUTHOR | |
7595 | ||
7596 | =item Name | |
7597 | ||
7598 | =item Description | |
7599 | ||
7600 | =item Build | |
7601 | ||
7602 | =over 4 | |
7603 | ||
7604 | =item Tools & SDK | |
7605 | ||
7606 | =item Setup | |
7607 | ||
7608 | SetNWBld.bat, Buildtype.bat | |
7609 | ||
7610 | =item Make | |
7611 | ||
7612 | =item Interpreter | |
7613 | ||
7614 | =item Extensions | |
7615 | ||
7616 | =back | |
7617 | ||
7618 | =item Install | |
7619 | ||
7620 | =item Build new extensions | |
7621 | ||
7622 | =item Acknowledgements | |
7623 | ||
7624 | =item Authors | |
7625 | ||
7626 | =item Date | |
7627 | ||
7628 | =back | |
7629 | ||
7630 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. | |
7631 | ||
7632 | =over 4 | |
7633 | ||
7634 | =item SYNOPSIS | |
7635 | ||
7636 | =back | |
7637 | ||
7638 | =over 4 | |
7639 | ||
7640 | =item DESCRIPTION | |
7641 | ||
7642 | =over 4 | |
7643 | ||
7644 | =item Target | |
7645 | ||
7646 | =item Other OSes | |
7647 | ||
7648 | =item Prerequisites | |
7649 | ||
7650 | EMX, RSX, HPFS, pdksh | |
7651 | ||
7652 | =item Starting Perl programs under OS/2 (and DOS and...) | |
7653 | ||
7654 | =item Starting OS/2 (and DOS) programs under Perl | |
7655 | ||
7656 | =back | |
7657 | ||
7658 | =item Frequently asked questions | |
7659 | ||
7660 | =over 4 | |
7661 | ||
7662 | =item "It does not work" | |
7663 | ||
7664 | =item I cannot run external programs | |
7665 | ||
7666 | =item I cannot embed perl into my program, or use F<perl.dll> from my | |
7667 | program. | |
7668 | ||
7669 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use | |
7670 | L<ExtUtils::Embed>? | |
7671 | ||
7672 | =item C<``> and pipe-C<open> do not work under DOS. | |
7673 | ||
7674 | =item Cannot start C<find.exe "pattern" file> | |
7675 | ||
7676 | =back | |
7677 | ||
7678 | =item INSTALLATION | |
7679 | ||
7680 | =over 4 | |
7681 | ||
7682 | =item Automatic binary installation | |
7683 | ||
7684 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> | |
7685 | ||
7686 | =item Manual binary installation | |
7687 | ||
7688 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable | |
7689 | (statically linked), Executables for Perl utilities, Main Perl library, | |
7690 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
7691 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
7692 | Perl manual in F<.INF> format, Pdksh | |
7693 | ||
7694 | =item B<Warning> | |
7695 | ||
7696 | =back | |
7697 | ||
7698 | =item Accessing documentation | |
7699 | ||
7700 | =over 4 | |
7701 | ||
7702 | =item OS/2 F<.INF> file | |
7703 | ||
7704 | =item Plain text | |
7705 | ||
7706 | =item Manpages | |
7707 | ||
7708 | =item HTML | |
7709 | ||
7710 | =item GNU C<info> files | |
7711 | ||
7712 | =item F<PDF> files | |
7713 | ||
7714 | =item C<LaTeX> docs | |
7715 | ||
7716 | =back | |
7717 | ||
7718 | =item BUILD | |
7719 | ||
7720 | =over 4 | |
7721 | ||
7722 | =item The short story | |
7723 | ||
7724 | =item Prerequisites | |
7725 | ||
7726 | =item Getting perl source | |
7727 | ||
7728 | =item Application of the patches | |
7729 | ||
7730 | =item Hand-editing | |
7731 | ||
7732 | =item Making | |
7733 | ||
7734 | =item Testing | |
7735 | ||
7736 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, | |
7737 | F<op/stat.t> | |
7738 | ||
7739 | =item Installing the built perl | |
7740 | ||
7741 | =item C<a.out>-style build | |
7742 | ||
7743 | =back | |
7744 | ||
7745 | =item Build FAQ | |
7746 | ||
7747 | =over 4 | |
7748 | ||
7749 | =item Some C</> became C<\> in pdksh. | |
7750 | ||
7751 | =item C<'errno'> - unresolved external | |
7752 | ||
7753 | =item Problems with tr or sed | |
7754 | ||
7755 | =item Some problem (forget which ;-) | |
7756 | ||
7757 | =item Library ... not found | |
7758 | ||
7759 | =item Segfault in make | |
7760 | ||
7761 | =item op/sprintf test failure | |
7762 | ||
7763 | =back | |
7764 | ||
7765 | =item Specific (mis)features of OS/2 port | |
7766 | ||
7767 | =over 4 | |
7768 | ||
7769 | =item C<setpriority>, C<getpriority> | |
7770 | ||
7771 | =item C<system()> | |
7772 | ||
7773 | =item C<extproc> on the first line | |
7774 | ||
7775 | =item Additional modules: | |
7776 | ||
7777 | =item Prebuilt methods: | |
7778 | ||
7779 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, | |
7780 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
7781 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
7782 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
7783 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
7784 | C<Cwd::extLibpath_set( path [, type ] )>, | |
7785 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, | |
7786 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, | |
7787 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, | |
7788 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, | |
7789 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>, | |
7790 | C<OS2::DLLname([how [, \&xsub]])> | |
7791 | ||
7792 | =item Prebuilt variables: | |
7793 | ||
7794 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, | |
7795 | $OS2::nsyserror | |
7796 | ||
7797 | =item Misfeatures | |
7798 | ||
7799 | =item Modifications | |
7800 | ||
7801 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, | |
7802 | C<flock> | |
7803 | ||
7804 | =item Identifying DLLs | |
7805 | ||
7806 | =item Centralized management of resources | |
7807 | ||
7808 | C<HAB>, C<HMQ>, Treating errors reported by OS/2 API, | |
7809 | C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>, | |
7810 | C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>, | |
7811 | C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs | |
7812 | ||
7813 | =back | |
7814 | ||
7815 | =item Perl flavors | |
7816 | ||
7817 | =over 4 | |
7818 | ||
7819 | =item F<perl.exe> | |
7820 | ||
7821 | =item F<perl_.exe> | |
7822 | ||
7823 | =item F<perl__.exe> | |
7824 | ||
7825 | =item F<perl___.exe> | |
7826 | ||
7827 | =item Why strange names? | |
7828 | ||
7829 | =item Why dynamic linking? | |
7830 | ||
7831 | =item Why chimera build? | |
7832 | ||
7833 | =back | |
7834 | ||
7835 | =item ENVIRONMENT | |
7836 | ||
7837 | =over 4 | |
7838 | ||
7839 | =item C<PERLLIB_PREFIX> | |
7840 | ||
7841 | =item C<PERL_BADLANG> | |
7842 | ||
7843 | =item C<PERL_BADFREE> | |
7844 | ||
7845 | =item C<PERL_SH_DIR> | |
7846 | ||
7847 | =item C<USE_PERL_FLOCK> | |
7848 | ||
7849 | =item C<TMP> or C<TEMP> | |
7850 | ||
7851 | =back | |
7852 | ||
7853 | =item Evolution | |
7854 | ||
7855 | =over 4 | |
7856 | ||
7857 | =item Text-mode filehandles | |
7858 | ||
7859 | =item Priorities | |
7860 | ||
7861 | =item DLL name mangling: pre 5.6.2 | |
7862 | ||
7863 | =item DLL name mangling: 5.6.2 and beyond | |
7864 | ||
7865 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from | |
7866 | C<LIBPATH> | |
7867 | ||
7868 | =item DLL forwarder generation | |
7869 | ||
7870 | =item Threading | |
7871 | ||
7872 | =item Calls to external programs | |
7873 | ||
7874 | =item Memory allocation | |
7875 | ||
7876 | =item Threads | |
7877 | ||
7878 | C<COND_WAIT>, F<os2.c> | |
7879 | ||
7880 | =back | |
7881 | ||
7882 | =item BUGS | |
7883 | ||
7884 | =back | |
7885 | ||
7886 | =over 4 | |
7887 | ||
7888 | =item AUTHOR | |
7889 | ||
7890 | =item SEE ALSO | |
7891 | ||
7892 | =back | |
7893 | ||
7894 | =head2 perlos390, README.os390 - building and installing Perl for OS/390 | |
7895 | and z/OS | |
7896 | ||
7897 | =over 4 | |
7898 | ||
7899 | =item SYNOPSIS | |
7900 | ||
7901 | =item DESCRIPTION | |
7902 | ||
7903 | =over 4 | |
7904 | ||
7905 | =item Tools | |
7906 | ||
7907 | =item Unpacking Perl distribution on OS/390 | |
7908 | ||
7909 | =item Setup and utilities for Perl on OS/390 | |
7910 | ||
7911 | =item Configure Perl on OS/390 | |
7912 | ||
7913 | =item Build, Test, Install Perl on OS/390 | |
7914 | ||
7915 | =item Build Anomalies with Perl on OS/390 | |
7916 | ||
7917 | =item Testing Anomalies with Perl on OS/390 | |
7918 | ||
7919 | =item Installation Anomalies with Perl on OS/390 | |
7920 | ||
7921 | =item Usage Hints for Perl on OS/390 | |
7922 | ||
7923 | =item Floating Point Anomalies with Perl on OS/390 | |
7924 | ||
7925 | =item Modules and Extensions for Perl on OS/390 | |
7926 | ||
7927 | =back | |
7928 | ||
7929 | =item AUTHORS | |
7930 | ||
7931 | =item SEE ALSO | |
7932 | ||
7933 | =over 4 | |
7934 | ||
7935 | =item Mailing list for Perl on OS/390 | |
7936 | ||
7937 | =back | |
7938 | ||
7939 | =item HISTORY | |
7940 | ||
7941 | =back | |
7942 | ||
7943 | =head2 perlqnx, README.qnx - Perl version 5 on QNX | |
7944 | ||
7945 | =over 4 | |
7946 | ||
7947 | =item DESCRIPTION | |
7948 | ||
7949 | =over 4 | |
7950 | ||
7951 | =item Required Software for Compiling Perl on QNX4 | |
7952 | ||
7953 | /bin/sh, ar, nm, cpp, make | |
7954 | ||
7955 | =item Outstanding Issues with Perl on QNX4 | |
7956 | ||
7957 | =item QNX auxiliary files | |
7958 | ||
7959 | qnx/ar, qnx/cpp | |
7960 | ||
7961 | =item Outstanding issues with perl under QNX6 | |
7962 | ||
7963 | =back | |
7964 | ||
7965 | =item AUTHOR | |
7966 | ||
7967 | =back | |
7968 | ||
7969 | =head2 perlplan9 - Plan 9-specific documentation for Perl | |
7970 | ||
7971 | =over 4 | |
7972 | ||
7973 | =item DESCRIPTION | |
7974 | ||
7975 | =over 4 | |
7976 | ||
7977 | =item Invoking Perl | |
7978 | ||
7979 | =item What's in Plan 9 Perl | |
7980 | ||
7981 | =item What's not in Plan 9 Perl | |
7982 | ||
7983 | =item Perl5 Functions not currently supported in Plan 9 Perl | |
7984 | ||
7985 | =item Signals in Plan 9 Perl | |
7986 | ||
7987 | =back | |
7988 | ||
7989 | =item COMPILING AND INSTALLING PERL ON PLAN 9 | |
7990 | ||
7991 | =over 4 | |
7992 | ||
7993 | =item Installing Perl Documentation on Plan 9 | |
7994 | ||
7995 | =back | |
7996 | ||
7997 | =item BUGS | |
7998 | ||
7999 | =item Revision date | |
8000 | ||
8001 | =item AUTHOR | |
8002 | ||
8003 | =back | |
8004 | ||
8005 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems | |
8006 | ||
8007 | =over 4 | |
8008 | ||
8009 | =item DESCRIPTION | |
8010 | ||
8011 | =over 4 | |
8012 | ||
8013 | =item Solaris Version Numbers. | |
8014 | ||
8015 | =back | |
8016 | ||
8017 | =item RESOURCES | |
8018 | ||
8019 | Solaris FAQ, Precompiled Binaries, Solaris Documentation | |
8020 | ||
8021 | =item SETTING UP | |
8022 | ||
8023 | =over 4 | |
8024 | ||
8025 | =item File Extraction Problems on Solaris. | |
8026 | ||
8027 | =item Compiler and Related Tools on Solaris. | |
8028 | ||
8029 | =item Environment for Compiling Perl on Solaris | |
8030 | ||
8031 | =back | |
8032 | ||
8033 | =item RUN CONFIGURE. | |
8034 | ||
8035 | =over 4 | |
8036 | ||
8037 | =item 64-bit Issues with Perl on Solaris. | |
8038 | ||
8039 | =item Threads in Perl on Solaris. | |
8040 | ||
8041 | =item Malloc Issues with Perl on Solaris. | |
8042 | ||
8043 | =back | |
8044 | ||
8045 | =item MAKE PROBLEMS. | |
8046 | ||
8047 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: | |
8048 | relocation error:, dlopen: stub interception failed, #error "No | |
8049 | DATAMODEL_NATIVE specified", sh: ar: not found | |
8050 | ||
8051 | =item MAKE TEST | |
8052 | ||
8053 | =over 4 | |
8054 | ||
8055 | =item op/stat.t test 4 in Solaris | |
8056 | ||
8057 | =item nss_delete core dump from op/pwent or op/grent | |
8058 | ||
8059 | =back | |
8060 | ||
8061 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. | |
8062 | ||
8063 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. | |
8064 | ||
8065 | =over 4 | |
8066 | ||
8067 | =item Limits on Numbers of Open Files on Solaris. | |
8068 | ||
8069 | =back | |
8070 | ||
8071 | =item SOLARIS-SPECIFIC MODULES. | |
8072 | ||
8073 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. | |
8074 | ||
8075 | =over 4 | |
8076 | ||
8077 | =item Proc::ProcessTable on Solaris | |
8078 | ||
8079 | =item BSD::Resource on Solaris | |
8080 | ||
8081 | =item Net::SSLeay on Solaris | |
8082 | ||
8083 | =back | |
8084 | ||
8085 | =item AUTHOR | |
8086 | ||
8087 | =item LAST MODIFIED | |
8088 | ||
8089 | =back | |
8090 | ||
8091 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as | |
8092 | Digital UNIX formerly known as DEC OSF/1) systems | |
8093 | ||
8094 | =over 4 | |
8095 | ||
8096 | =item DESCRIPTION | |
8097 | ||
8098 | =over 4 | |
8099 | ||
8100 | =item Compiling Perl 5 on Tru64 | |
8101 | ||
8102 | =item Using Large Files with Perl on Tru64 | |
8103 | ||
8104 | =item Threaded Perl on Tru64 | |
8105 | ||
8106 | =item Long Doubles on Tru64 | |
8107 | ||
8108 | =item 64-bit Perl on Tru64 | |
8109 | ||
8110 | =item Warnings about floating-point overflow when compiling Perl on Tru64 | |
8111 | ||
8112 | =back | |
8113 | ||
8114 | =item Testing Perl on Tru64 | |
8115 | ||
8116 | =item ext/ODBM_File/odbm Test Failing With Static Builds | |
8117 | ||
8118 | =item Perl Fails Because Of Unresolved Symbol sockatmark | |
8119 | ||
8120 | =item AUTHOR | |
8121 | ||
8122 | =back | |
8123 | ||
8124 | =head2 perluts - Perl under UTS | |
8125 | ||
8126 | =over 4 | |
8127 | ||
8128 | =item SYNOPSIS | |
8129 | ||
8130 | =item DESCRIPTION | |
8131 | ||
8132 | =item BUILDING PERL ON UTS | |
8133 | ||
8134 | =item Installing the built perl on UTS | |
8135 | ||
8136 | =item AUTHOR | |
8137 | ||
8138 | =back | |
8139 | ||
8140 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. | |
8141 | ||
8142 | =over 4 | |
8143 | ||
8144 | =item SYNOPSIS | |
8145 | ||
8146 | =item DESCRIPTION | |
8147 | ||
8148 | =over 4 | |
8149 | ||
8150 | =item Unpacking Perl Distribution on VM/ESA | |
8151 | ||
8152 | =item Setup Perl and utilities on VM/ESA | |
8153 | ||
8154 | =item Configure Perl on VM/ESA | |
8155 | ||
8156 | =item Testing Anomalies of Perl on VM/ESA | |
8157 | ||
8158 | =item Usage Hints for Perl on VM/ESA | |
8159 | ||
8160 | =back | |
8161 | ||
8162 | =item AUTHORS | |
8163 | ||
8164 | =item SEE ALSO | |
8165 | ||
8166 | =over 4 | |
8167 | ||
8168 | =item Mailing list for Perl on VM/ESA | |
8169 | ||
8170 | =back | |
8171 | ||
8172 | =back | |
8173 | ||
8174 | =head2 perlvms - VMS-specific documentation for Perl | |
8175 | ||
8176 | =over 4 | |
8177 | ||
8178 | =item DESCRIPTION | |
8179 | ||
8180 | =item Installation | |
8181 | ||
8182 | =item Organization of Perl Images | |
8183 | ||
8184 | =over 4 | |
8185 | ||
8186 | =item Core Images | |
8187 | ||
8188 | =item Perl Extensions | |
8189 | ||
8190 | =item Installing static extensions | |
8191 | ||
8192 | =item Installing dynamic extensions | |
8193 | ||
8194 | =back | |
8195 | ||
8196 | =item File specifications | |
8197 | ||
8198 | =over 4 | |
8199 | ||
8200 | =item Syntax | |
8201 | ||
8202 | =item Wildcard expansion | |
8203 | ||
8204 | =item Pipes | |
8205 | ||
8206 | =back | |
8207 | ||
8208 | =item PERL5LIB and PERLLIB | |
8209 | ||
8210 | =item Command line | |
8211 | ||
8212 | =over 4 | |
8213 | ||
8214 | =item I/O redirection and backgrounding | |
8215 | ||
8216 | =item Command line switches | |
8217 | ||
8218 | -i, -S, -u | |
8219 | ||
8220 | =back | |
8221 | ||
8222 | =item Perl functions | |
8223 | ||
8224 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
8225 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
8226 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
8227 | LIST, waitpid PID,FLAGS | |
8228 | ||
8229 | =item Perl variables | |
8230 | ||
8231 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| | |
8232 | ||
8233 | =item Standard modules with VMS-specific differences | |
8234 | ||
8235 | =over 4 | |
8236 | ||
8237 | =item SDBM_File | |
8238 | ||
8239 | =back | |
8240 | ||
8241 | =item Revision date | |
8242 | ||
8243 | =item AUTHOR | |
8244 | ||
8245 | =back | |
8246 | ||
8247 | =head2 perlvos, README.vos - Perl for Stratus VOS | |
8248 | ||
8249 | =over 4 | |
8250 | ||
8251 | =item SYNOPSIS | |
8252 | ||
8253 | =over 4 | |
8254 | ||
8255 | =item Multiple methods to build perl for VOS | |
8256 | ||
8257 | =item Stratus POSIX Support | |
8258 | ||
8259 | =back | |
8260 | ||
8261 | =item INSTALLING PERL IN VOS | |
8262 | ||
8263 | =over 4 | |
8264 | ||
8265 | =item Compiling Perl 5 on VOS | |
8266 | ||
8267 | =item Installing Perl 5 on VOS | |
8268 | ||
8269 | =back | |
8270 | ||
8271 | =item USING PERL IN VOS | |
8272 | ||
8273 | =over 4 | |
8274 | ||
8275 | =item Unimplemented Features of Perl on VOS | |
8276 | ||
8277 | =item Restrictions of Perl on VOS | |
8278 | ||
8279 | =item Handling of underflow and overflow | |
8280 | ||
8281 | =back | |
8282 | ||
8283 | =item TEST STATUS | |
8284 | ||
8285 | =item SUPPORT STATUS | |
8286 | ||
8287 | =item AUTHOR | |
8288 | ||
8289 | =item LAST UPDATE | |
8290 | ||
8291 | =back | |
8292 | ||
8293 | =head2 perlwin32 - Perl under Windows | |
8294 | ||
8295 | =over 4 | |
8296 | ||
8297 | =item SYNOPSIS | |
8298 | ||
8299 | =item DESCRIPTION | |
8300 | ||
8301 | =over 4 | |
8302 | ||
8303 | =item Setting Up Perl on Win32 | |
8304 | ||
8305 | Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform | |
8306 | SDK 64-bit Compiler, Mingw32 with GCC | |
8307 | ||
8308 | =item Building | |
8309 | ||
8310 | =item Testing Perl on Win32 | |
8311 | ||
8312 | =item Installation of Perl on Win32 | |
8313 | ||
8314 | =item Usage Hints for Perl on Win32 | |
8315 | ||
8316 | Environment Variables, File Globbing, Using perl from the command line, | |
8317 | Building Extensions, Command-line Wildcard Expansion, Win32 Specific | |
8318 | Extensions, Notes on 64-bit Windows | |
8319 | ||
8320 | =item Running Perl Scripts | |
8321 | ||
8322 | Miscellaneous Things | |
8323 | ||
8324 | =back | |
8325 | ||
8326 | =item BUGS AND CAVEATS | |
8327 | ||
8328 | =item AUTHORS | |
8329 | ||
8330 | Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy | |
8331 | E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons | |
8332 | E<lt>nick@ing-simmons.netE<gt> | |
8333 | ||
8334 | =item SEE ALSO | |
8335 | ||
8336 | =item HISTORY | |
8337 | ||
8338 | =back | |
8339 | ||
8340 | =head1 PRAGMA DOCUMENTATION | |
8341 | ||
8342 | =head2 attrs - set/get attributes of a subroutine (deprecated) | |
8343 | ||
8344 | =over 4 | |
8345 | ||
8346 | =item SYNOPSIS | |
8347 | ||
8348 | =item DESCRIPTION | |
8349 | ||
8350 | method, locked | |
8351 | ||
8352 | =back | |
8353 | ||
8354 | =head2 re - Perl pragma to alter regular expression behaviour | |
8355 | ||
8356 | =over 4 | |
8357 | ||
8358 | =item SYNOPSIS | |
8359 | ||
8360 | =item DESCRIPTION | |
8361 | ||
8362 | =back | |
8363 | ||
8364 | =head2 threadshared::shared, threads::shared - Perl extension for sharing | |
8365 | data structures between threads | |
8366 | ||
8367 | =over 4 | |
8368 | ||
8369 | =item SYNOPSIS | |
8370 | ||
8371 | =item DESCRIPTION | |
8372 | ||
8373 | =item EXPORT | |
8374 | ||
8375 | =item FUNCTIONS | |
8376 | ||
8377 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, | |
8378 | cond_broadcast VARIABLE | |
8379 | ||
8380 | =item NOTES | |
8381 | ||
8382 | =item BUGS | |
8383 | ||
8384 | =item AUTHOR | |
8385 | ||
8386 | =item SEE ALSO | |
8387 | ||
8388 | =back | |
8389 | ||
8390 | =head2 threads - Perl extension allowing use of interpreter based threads | |
8391 | from perl | |
8392 | ||
8393 | =over 4 | |
8394 | ||
8395 | =item SYNOPSIS | |
8396 | ||
8397 | =item DESCRIPTION | |
8398 | ||
8399 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, | |
8400 | threads->self, $thread->tid, threads->object( tid ), threads->yield();, | |
8401 | threads->list();, async BLOCK; | |
8402 | ||
8403 | =item WARNINGS | |
8404 | ||
8405 | A thread exited while %d other threads were still running | |
8406 | ||
8407 | =item TODO | |
8408 | ||
8409 | =item BUGS | |
8410 | ||
8411 | Parent-Child threads, Returning objects, Creating threads inside BEGIN | |
8412 | blocks, PERL_OLD_SIGNALS are not threadsafe, will not be | |
8413 | ||
8414 | =item AUTHOR and COPYRIGHT | |
8415 | ||
8416 | =item SEE ALSO | |
8417 | ||
8418 | =back | |
8419 | ||
8420 | =head2 attributes - get/set subroutine or variable attributes | |
8421 | ||
8422 | =over 4 | |
8423 | ||
8424 | =item SYNOPSIS | |
8425 | ||
8426 | =item DESCRIPTION | |
8427 | ||
8428 | =over 4 | |
8429 | ||
8430 | =item Built-in Attributes | |
8431 | ||
8432 | locked, method, lvalue | |
8433 | ||
8434 | =item Available Subroutines | |
8435 | ||
8436 | get, reftype | |
8437 | ||
8438 | =item Package-specific Attribute Handling | |
8439 | ||
8440 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
8441 | ||
8442 | =item Syntax of Attribute Lists | |
8443 | ||
8444 | =back | |
8445 | ||
8446 | =item EXPORTS | |
8447 | ||
8448 | =over 4 | |
8449 | ||
8450 | =item Default exports | |
8451 | ||
8452 | =item Available exports | |
8453 | ||
8454 | =item Export tags defined | |
8455 | ||
8456 | =back | |
8457 | ||
8458 | =item EXAMPLES | |
8459 | ||
8460 | =item SEE ALSO | |
8461 | ||
8462 | =back | |
8463 | ||
8464 | =head2 attrs - set/get attributes of a subroutine (deprecated) | |
8465 | ||
8466 | =over 4 | |
8467 | ||
8468 | =item SYNOPSIS | |
8469 | ||
8470 | =item DESCRIPTION | |
8471 | ||
8472 | method, locked | |
8473 | ||
8474 | =back | |
8475 | ||
8476 | =head2 autouse - postpone load of modules until a function is used | |
8477 | ||
8478 | =over 4 | |
8479 | ||
8480 | =item SYNOPSIS | |
8481 | ||
8482 | =item DESCRIPTION | |
8483 | ||
8484 | =item WARNING | |
8485 | ||
8486 | =item AUTHOR | |
8487 | ||
8488 | =item SEE ALSO | |
8489 | ||
8490 | =back | |
8491 | ||
8492 | =head2 base - Establish IS-A relationship with base class at compile time | |
8493 | ||
8494 | =over 4 | |
8495 | ||
8496 | =item SYNOPSIS | |
8497 | ||
8498 | =item DESCRIPTION | |
8499 | ||
8500 | =item HISTORY | |
8501 | ||
8502 | =item SEE ALSO | |
8503 | ||
8504 | =back | |
8505 | ||
8506 | =head2 bigint - Transparent big integer support for Perl | |
8507 | ||
8508 | =over 4 | |
8509 | ||
8510 | =item SYNOPSIS | |
8511 | ||
8512 | =item DESCRIPTION | |
8513 | ||
8514 | =over 4 | |
8515 | ||
8516 | =item OPTIONS | |
8517 | ||
8518 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
8519 | ||
8520 | =item MATH LIBRARY | |
8521 | ||
8522 | =item INTERNAL FORMAT | |
8523 | ||
8524 | =item SIGN | |
8525 | ||
8526 | =item METHODS | |
8527 | ||
8528 | =back | |
8529 | ||
8530 | =item MODULES USED | |
8531 | ||
8532 | =item EXAMPLES | |
8533 | ||
8534 | =item LICENSE | |
8535 | ||
8536 | =item SEE ALSO | |
8537 | ||
8538 | =item AUTHORS | |
8539 | ||
8540 | =back | |
8541 | ||
8542 | =head2 bignum - Transparent BigNumber support for Perl | |
8543 | ||
8544 | =over 4 | |
8545 | ||
8546 | =item SYNOPSIS | |
8547 | ||
8548 | =item DESCRIPTION | |
8549 | ||
8550 | =over 4 | |
8551 | ||
8552 | =item OPTIONS | |
8553 | ||
8554 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
8555 | ||
8556 | =item MATH LIBRARY | |
8557 | ||
8558 | =item INTERNAL FORMAT | |
8559 | ||
8560 | =item SIGN | |
8561 | ||
8562 | =item METHODS | |
8563 | ||
8564 | =back | |
8565 | ||
8566 | =item MODULES USED | |
8567 | ||
8568 | =item EXAMPLES | |
8569 | ||
8570 | =item LICENSE | |
8571 | ||
8572 | =item SEE ALSO | |
8573 | ||
8574 | =item AUTHORS | |
8575 | ||
8576 | =back | |
8577 | ||
8578 | =head2 bigrat - Transparent BigNumber/BigRational support for Perl | |
8579 | ||
8580 | =over 4 | |
8581 | ||
8582 | =item SYNOPSIS | |
8583 | ||
8584 | =item DESCRIPTION | |
8585 | ||
8586 | =over 4 | |
8587 | ||
8588 | =item MODULES USED | |
8589 | ||
8590 | =item MATH LIBRARY | |
8591 | ||
8592 | =item SIGN | |
8593 | ||
8594 | =item METHODS | |
8595 | ||
8596 | =back | |
8597 | ||
8598 | =item EXAMPLES | |
8599 | ||
8600 | perl -Mbigrat -le 'print sqrt(33)' | |
8601 | perl -Mbigrat -le 'print 2*255' | |
8602 | perl -Mbigrat -le 'print 4.5+2*255' | |
8603 | perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' | |
8604 | perl -Mbigrat -le 'print 12->is_odd()'; | |
8605 | ||
8606 | =item LICENSE | |
8607 | ||
8608 | =item SEE ALSO | |
8609 | ||
8610 | =item AUTHORS | |
8611 | ||
8612 | =back | |
8613 | ||
8614 | =head2 blib - Use MakeMaker's uninstalled version of a package | |
8615 | ||
8616 | =over 4 | |
8617 | ||
8618 | =item SYNOPSIS | |
8619 | ||
8620 | =item DESCRIPTION | |
8621 | ||
8622 | =item BUGS | |
8623 | ||
8624 | =item AUTHOR | |
8625 | ||
8626 | =back | |
8627 | ||
8628 | =head2 bytes - Perl pragma to force byte semantics rather than character | |
8629 | semantics | |
8630 | ||
8631 | =over 4 | |
8632 | ||
8633 | =item SYNOPSIS | |
8634 | ||
8635 | =item DESCRIPTION | |
8636 | ||
8637 | =item SEE ALSO | |
8638 | ||
8639 | =back | |
8640 | ||
8641 | =head2 charnames - define character names for C<\N{named}> string literal | |
8642 | escapes | |
8643 | ||
8644 | =over 4 | |
8645 | ||
8646 | =item SYNOPSIS | |
8647 | ||
8648 | =item DESCRIPTION | |
8649 | ||
8650 | =item CUSTOM TRANSLATORS | |
8651 | ||
8652 | =item charnames::viacode(code) | |
8653 | ||
8654 | =item charnames::vianame(name) | |
8655 | ||
8656 | =item ALIASES | |
8657 | ||
8658 | =item ILLEGAL CHARACTERS | |
8659 | ||
8660 | =item BUGS | |
8661 | ||
8662 | =back | |
8663 | ||
8664 | =head2 constant - Perl pragma to declare constants | |
8665 | ||
8666 | =over 4 | |
8667 | ||
8668 | =item SYNOPSIS | |
8669 | ||
8670 | =item DESCRIPTION | |
8671 | ||
8672 | =item NOTES | |
8673 | ||
8674 | =over 4 | |
8675 | ||
8676 | =item List constants | |
8677 | ||
8678 | =item Defining multiple constants at once | |
8679 | ||
8680 | =item Magic constants | |
8681 | ||
8682 | =back | |
8683 | ||
8684 | =item TECHNICAL NOTES | |
8685 | ||
8686 | =item BUGS | |
8687 | ||
8688 | =item AUTHOR | |
8689 | ||
8690 | =item COPYRIGHT | |
8691 | ||
8692 | =back | |
8693 | ||
8694 | =head2 diagnostics - Perl compiler pragma to force verbose warning | |
8695 | diagnostics | |
8696 | ||
8697 | =over 4 | |
8698 | ||
8699 | =item SYNOPSIS | |
8700 | ||
8701 | =item DESCRIPTION | |
8702 | ||
8703 | =over 4 | |
8704 | ||
8705 | =item The C<diagnostics> Pragma | |
8706 | ||
8707 | =item The I<splain> Program | |
8708 | ||
8709 | =back | |
8710 | ||
8711 | =item EXAMPLES | |
8712 | ||
8713 | =item INTERNALS | |
8714 | ||
8715 | =item BUGS | |
8716 | ||
8717 | =item AUTHOR | |
8718 | ||
8719 | =back | |
8720 | ||
8721 | =head2 encoding - allows you to write your script in non-ascii or non-utf8 | |
8722 | ||
8723 | =over 4 | |
8724 | ||
8725 | =item SYNOPSIS | |
8726 | ||
8727 | =item ABSTRACT | |
8728 | ||
8729 | =item USAGE | |
8730 | ||
8731 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> | |
8732 | I<ENCNAME_IN> ...] ;, no encoding; | |
8733 | ||
8734 | =item CAVEATS | |
8735 | ||
8736 | =over 4 | |
8737 | ||
8738 | =item NOT SCOPED | |
8739 | ||
8740 | =item DO NOT MIX MULTIPLE ENCODINGS | |
8741 | ||
8742 | =back | |
8743 | ||
8744 | =item Non-ASCII Identifiers and Filter option | |
8745 | ||
8746 | use encoding I<ENCNAME> Filter=E<gt>1; | |
8747 | ||
8748 | =item EXAMPLE - Greekperl | |
8749 | ||
8750 | =item KNOWN PROBLEMS | |
8751 | ||
8752 | =item SEE ALSO | |
8753 | ||
8754 | =back | |
8755 | ||
8756 | =head2 fields - compile-time class fields | |
8757 | ||
8758 | =over 4 | |
8759 | ||
8760 | =item SYNOPSIS | |
8761 | ||
8762 | =item DESCRIPTION | |
8763 | ||
8764 | new, phash | |
8765 | ||
8766 | =item SEE ALSO | |
8767 | ||
8768 | =back | |
8769 | ||
8770 | =head2 filetest - Perl pragma to control the filetest permission operators | |
8771 | ||
8772 | =over 4 | |
8773 | ||
8774 | =item SYNOPSIS | |
8775 | ||
8776 | =item DESCRIPTION | |
8777 | ||
8778 | =over 4 | |
8779 | ||
8780 | =item subpragma access | |
8781 | ||
8782 | =back | |
8783 | ||
8784 | =back | |
8785 | ||
8786 | =head2 if - C<use> a Perl module if a condition holds | |
8787 | ||
8788 | =over 4 | |
8789 | ||
8790 | =item SYNOPSIS | |
8791 | ||
8792 | =item DESCRIPTION | |
8793 | ||
8794 | =item BUGS | |
8795 | ||
8796 | =item AUTHOR | |
8797 | ||
8798 | =back | |
8799 | ||
8800 | =head2 integer - Perl pragma to use integer arithmetic instead of floating | |
8801 | point | |
8802 | ||
8803 | =over 4 | |
8804 | ||
8805 | =item SYNOPSIS | |
8806 | ||
8807 | =item DESCRIPTION | |
8808 | ||
8809 | =back | |
8810 | ||
8811 | =head2 less - perl pragma to request less of something from the compiler | |
8812 | ||
8813 | =over 4 | |
8814 | ||
8815 | =item SYNOPSIS | |
8816 | ||
8817 | =item DESCRIPTION | |
8818 | ||
8819 | =back | |
8820 | ||
8821 | =head2 lib - manipulate @INC at compile time | |
8822 | ||
8823 | =over 4 | |
8824 | ||
8825 | =item SYNOPSIS | |
8826 | ||
8827 | =item DESCRIPTION | |
8828 | ||
8829 | =over 4 | |
8830 | ||
8831 | =item Adding directories to @INC | |
8832 | ||
8833 | =item Deleting directories from @INC | |
8834 | ||
8835 | =item Restoring original @INC | |
8836 | ||
8837 | =back | |
8838 | ||
8839 | =item CAVEATS | |
8840 | ||
8841 | =item NOTES | |
8842 | ||
8843 | =item SEE ALSO | |
8844 | ||
8845 | =item AUTHOR | |
8846 | ||
8847 | =back | |
8848 | ||
8849 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in | |
8850 | operations | |
8851 | ||
8852 | =over 4 | |
8853 | ||
8854 | =item SYNOPSIS | |
8855 | ||
8856 | =item DESCRIPTION | |
8857 | ||
8858 | =back | |
8859 | ||
8860 | =head2 open - perl pragma to set default PerlIO layers for input and output | |
8861 | ||
8862 | =over 4 | |
8863 | ||
8864 | =item SYNOPSIS | |
8865 | ||
8866 | =item DESCRIPTION | |
8867 | ||
8868 | =item NONPERLIO FUNCTIONALITY | |
8869 | ||
8870 | =item IMPLEMENTATION DETAILS | |
8871 | ||
8872 | =item SEE ALSO | |
8873 | ||
8874 | =back | |
8875 | ||
8876 | =head2 ops - Perl pragma to restrict unsafe operations when compiling | |
8877 | ||
8878 | =over 4 | |
8879 | ||
8880 | =item SYNOPSIS | |
8881 | ||
8882 | =item DESCRIPTION | |
8883 | ||
8884 | =item SEE ALSO | |
8885 | ||
8886 | =back | |
8887 | ||
8888 | =head2 overload - Package for overloading perl operations | |
8889 | ||
8890 | =over 4 | |
8891 | ||
8892 | =item SYNOPSIS | |
8893 | ||
8894 | =item DESCRIPTION | |
8895 | ||
8896 | =over 4 | |
8897 | ||
8898 | =item Declaration of overloaded functions | |
8899 | ||
8900 | =item Calling Conventions for Binary Operations | |
8901 | ||
8902 | FALSE, TRUE, C<undef> | |
8903 | ||
8904 | =item Calling Conventions for Unary Operations | |
8905 | ||
8906 | =item Calling Conventions for Mutators | |
8907 | ||
8908 | C<++> and C<-->, C<x=> and other assignment versions | |
8909 | ||
8910 | =item Overloadable Operations | |
8911 | ||
8912 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, | |
8913 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
8914 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> | |
8915 | ||
8916 | =item Inheritance and overloading | |
8917 | ||
8918 | Strings as values of C<use overload> directive, Overloading of an operation | |
8919 | is inherited by derived classes | |
8920 | ||
8921 | =back | |
8922 | ||
8923 | =item SPECIAL SYMBOLS FOR C<use overload> | |
8924 | ||
8925 | =over 4 | |
8926 | ||
8927 | =item Last Resort | |
8928 | ||
8929 | =item Fallback | |
8930 | ||
8931 | C<undef>, TRUE, defined, but FALSE | |
8932 | ||
8933 | =item Copy Constructor | |
8934 | ||
8935 | B<Example> | |
8936 | ||
8937 | =back | |
8938 | ||
8939 | =item MAGIC AUTOGENERATION | |
8940 | ||
8941 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, | |
8942 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
8943 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, | |
8944 | I<Copy operator> | |
8945 | ||
8946 | =item Losing overloading | |
8947 | ||
8948 | =item Run-time Overloading | |
8949 | ||
8950 | =item Public functions | |
8951 | ||
8952 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) | |
8953 | ||
8954 | =item Overloading constants | |
8955 | ||
8956 | integer, float, binary, q, qr | |
8957 | ||
8958 | =item IMPLEMENTATION | |
8959 | ||
8960 | =item Metaphor clash | |
8961 | ||
8962 | =item Cookbook | |
8963 | ||
8964 | =over 4 | |
8965 | ||
8966 | =item Two-face scalars | |
8967 | ||
8968 | =item Two-face references | |
8969 | ||
8970 | =item Symbolic calculator | |
8971 | ||
8972 | =item I<Really> symbolic calculator | |
8973 | ||
8974 | =back | |
8975 | ||
8976 | =item AUTHOR | |
8977 | ||
8978 | =item DIAGNOSTICS | |
8979 | ||
8980 | Odd number of arguments for overload::constant, `%s' is not an overloadable | |
8981 | type, `%s' is not a code reference | |
8982 | ||
8983 | =item BUGS | |
8984 | ||
8985 | =back | |
8986 | ||
8987 | =head2 re - Perl pragma to alter regular expression behaviour | |
8988 | ||
8989 | =over 4 | |
8990 | ||
8991 | =item SYNOPSIS | |
8992 | ||
8993 | =item DESCRIPTION | |
8994 | ||
8995 | =back | |
8996 | ||
8997 | =head2 sigtrap - Perl pragma to enable simple signal handling | |
8998 | ||
8999 | =over 4 | |
9000 | ||
9001 | =item SYNOPSIS | |
9002 | ||
9003 | =item DESCRIPTION | |
9004 | ||
9005 | =item OPTIONS | |
9006 | ||
9007 | =over 4 | |
9008 | ||
9009 | =item SIGNAL HANDLERS | |
9010 | ||
9011 | B<stack-trace>, B<die>, B<handler> I<your-handler> | |
9012 | ||
9013 | =item SIGNAL LISTS | |
9014 | ||
9015 | B<normal-signals>, B<error-signals>, B<old-interface-signals> | |
9016 | ||
9017 | =item OTHER | |
9018 | ||
9019 | B<untrapped>, B<any>, I<signal>, I<number> | |
9020 | ||
9021 | =back | |
9022 | ||
9023 | =item EXAMPLES | |
9024 | ||
9025 | =back | |
9026 | ||
9027 | =head2 sort - perl pragma to control sort() behaviour | |
9028 | ||
9029 | =over 4 | |
9030 | ||
9031 | =item SYNOPSIS | |
9032 | ||
9033 | =item DESCRIPTION | |
9034 | ||
9035 | =item CAVEATS | |
9036 | ||
9037 | =back | |
9038 | ||
9039 | =head2 strict - Perl pragma to restrict unsafe constructs | |
9040 | ||
9041 | =over 4 | |
9042 | ||
9043 | =item SYNOPSIS | |
9044 | ||
9045 | =item DESCRIPTION | |
9046 | ||
9047 | C<strict refs>, C<strict vars>, C<strict subs> | |
9048 | ||
9049 | =back | |
9050 | ||
9051 | =head2 subs - Perl pragma to predeclare sub names | |
9052 | ||
9053 | =over 4 | |
9054 | ||
9055 | =item SYNOPSIS | |
9056 | ||
9057 | =item DESCRIPTION | |
9058 | ||
9059 | =back | |
9060 | ||
9061 | =head2 threads - Perl extension allowing use of interpreter based threads | |
9062 | from perl | |
9063 | ||
9064 | =over 4 | |
9065 | ||
9066 | =item SYNOPSIS | |
9067 | ||
9068 | =item DESCRIPTION | |
9069 | ||
9070 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, | |
9071 | threads->self, $thread->tid, threads->object( tid ), threads->yield();, | |
9072 | threads->list();, async BLOCK; | |
9073 | ||
9074 | =item WARNINGS | |
9075 | ||
9076 | A thread exited while %d other threads were still running | |
9077 | ||
9078 | =item TODO | |
9079 | ||
9080 | =item BUGS | |
9081 | ||
9082 | Parent-Child threads, Returning objects, Creating threads inside BEGIN | |
9083 | blocks, PERL_OLD_SIGNALS are not threadsafe, will not be | |
9084 | ||
9085 | =item AUTHOR and COPYRIGHT | |
9086 | ||
9087 | =item SEE ALSO | |
9088 | ||
9089 | =back | |
9090 | ||
9091 | =head2 threadshared, threads::shared - Perl extension for sharing data | |
9092 | structures between threads | |
9093 | ||
9094 | =over 4 | |
9095 | ||
9096 | =item SYNOPSIS | |
9097 | ||
9098 | =item DESCRIPTION | |
9099 | ||
9100 | =item EXPORT | |
9101 | ||
9102 | =item FUNCTIONS | |
9103 | ||
9104 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, | |
9105 | cond_broadcast VARIABLE | |
9106 | ||
9107 | =item NOTES | |
9108 | ||
9109 | =item BUGS | |
9110 | ||
9111 | =item AUTHOR | |
9112 | ||
9113 | =item SEE ALSO | |
9114 | ||
9115 | =back | |
9116 | ||
9117 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source | |
9118 | code | |
9119 | ||
9120 | =over 4 | |
9121 | ||
9122 | =item SYNOPSIS | |
9123 | ||
9124 | =item DESCRIPTION | |
9125 | ||
9126 | =over 4 | |
9127 | ||
9128 | =item Utility functions | |
9129 | ||
9130 | $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]), | |
9131 | utf8::encode($string), $flag = utf8::decode($string), $flag = | |
9132 | utf8::valid(STRING) | |
9133 | ||
9134 | =back | |
9135 | ||
9136 | =item BUGS | |
9137 | ||
9138 | =item SEE ALSO | |
9139 | ||
9140 | =back | |
9141 | ||
9142 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) | |
9143 | ||
9144 | =over 4 | |
9145 | ||
9146 | =item SYNOPSIS | |
9147 | ||
9148 | =item DESCRIPTION | |
9149 | ||
9150 | =back | |
9151 | ||
9152 | =head2 vmsish - Perl pragma to control VMS-specific language features | |
9153 | ||
9154 | =over 4 | |
9155 | ||
9156 | =item SYNOPSIS | |
9157 | ||
9158 | =item DESCRIPTION | |
9159 | ||
9160 | C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> | |
9161 | ||
9162 | =back | |
9163 | ||
9164 | =head2 warnings - Perl pragma to control optional warnings | |
9165 | ||
9166 | =over 4 | |
9167 | ||
9168 | =item SYNOPSIS | |
9169 | ||
9170 | =item DESCRIPTION | |
9171 | ||
9172 | use warnings::register, warnings::enabled(), warnings::enabled($category), | |
9173 | warnings::enabled($object), warnings::warn($message), | |
9174 | warnings::warn($category, $message), warnings::warn($object, $message), | |
9175 | warnings::warnif($message), warnings::warnif($category, $message), | |
9176 | warnings::warnif($object, $message) | |
9177 | ||
9178 | =back | |
9179 | ||
9180 | =head2 warnings::register - warnings import function | |
9181 | ||
9182 | =over 4 | |
9183 | ||
9184 | =item SYNOPSIS | |
9185 | ||
9186 | =item DESCRIPTION | |
9187 | ||
9188 | =back | |
9189 | ||
9190 | =head1 MODULE DOCUMENTATION | |
9191 | ||
9192 | =head2 AnyDBM_File - provide framework for multiple DBMs | |
9193 | ||
9194 | =over 4 | |
9195 | ||
9196 | =item SYNOPSIS | |
9197 | ||
9198 | =item DESCRIPTION | |
9199 | ||
9200 | =over 4 | |
9201 | ||
9202 | =item DBM Comparisons | |
9203 | ||
9204 | [0], [1], [2], [3] | |
9205 | ||
9206 | =back | |
9207 | ||
9208 | =item SEE ALSO | |
9209 | ||
9210 | =back | |
9211 | ||
9212 | =head2 Attribute::Handlers - Simpler definition of attribute handlers | |
9213 | ||
9214 | =over 4 | |
9215 | ||
9216 | =item VERSION | |
9217 | ||
9218 | =item SYNOPSIS | |
9219 | ||
9220 | =item DESCRIPTION | |
9221 | ||
9222 | [0], [1], [2], [3], [4], [5] | |
9223 | ||
9224 | =over 4 | |
9225 | ||
9226 | =item Typed lexicals | |
9227 | ||
9228 | =item Type-specific attribute handlers | |
9229 | ||
9230 | =item Non-interpretive attribute handlers | |
9231 | ||
9232 | =item Phase-specific attribute handlers | |
9233 | ||
9234 | =item Attributes as C<tie> interfaces | |
9235 | ||
9236 | =back | |
9237 | ||
9238 | =item EXAMPLES | |
9239 | ||
9240 | =item DIAGNOSTICS | |
9241 | ||
9242 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s | |
9243 | attributes>, C<Declaration of %s attribute in package %s may clash with | |
9244 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, | |
9245 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't | |
9246 | be able to apply END handler> | |
9247 | ||
9248 | =item AUTHOR | |
9249 | ||
9250 | =item BUGS | |
9251 | ||
9252 | =item COPYRIGHT | |
9253 | ||
9254 | =back | |
9255 | ||
9256 | =head2 AutoLoader - load subroutines only on demand | |
9257 | ||
9258 | =over 4 | |
9259 | ||
9260 | =item SYNOPSIS | |
9261 | ||
9262 | =item DESCRIPTION | |
9263 | ||
9264 | =over 4 | |
9265 | ||
9266 | =item Subroutine Stubs | |
9267 | ||
9268 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
9269 | ||
9270 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine | |
9271 | ||
9272 | =item Package Lexicals | |
9273 | ||
9274 | =item Not Using AutoLoader | |
9275 | ||
9276 | =item B<AutoLoader> vs. B<SelfLoader> | |
9277 | ||
9278 | =back | |
9279 | ||
9280 | =item CAVEATS | |
9281 | ||
9282 | =item SEE ALSO | |
9283 | ||
9284 | =back | |
9285 | ||
9286 | =head2 AutoSplit - split a package for autoloading | |
9287 | ||
9288 | =over 4 | |
9289 | ||
9290 | =item SYNOPSIS | |
9291 | ||
9292 | =item DESCRIPTION | |
9293 | ||
9294 | $keep, $check, $modtime | |
9295 | ||
9296 | =over 4 | |
9297 | ||
9298 | =item Multiple packages | |
9299 | ||
9300 | =back | |
9301 | ||
9302 | =item DIAGNOSTICS | |
9303 | ||
9304 | =back | |
9305 | ||
9306 | =head2 B - The Perl Compiler | |
9307 | ||
9308 | =over 4 | |
9309 | ||
9310 | =item SYNOPSIS | |
9311 | ||
9312 | =item DESCRIPTION | |
9313 | ||
9314 | =item OVERVIEW OF CLASSES | |
9315 | ||
9316 | =over 4 | |
9317 | ||
9318 | =item SV-RELATED CLASSES | |
9319 | ||
9320 | =item B::SV METHODS | |
9321 | ||
9322 | REFCNT, FLAGS | |
9323 | ||
9324 | =item B::IV METHODS | |
9325 | ||
9326 | IV, IVX, UVX, int_value, needs64bits, packiv | |
9327 | ||
9328 | =item B::NV METHODS | |
9329 | ||
9330 | NV, NVX | |
9331 | ||
9332 | =item B::RV METHODS | |
9333 | ||
9334 | RV | |
9335 | ||
9336 | =item B::PV METHODS | |
9337 | ||
9338 | PV, RV, PVX | |
9339 | ||
9340 | =item B::PVMG METHODS | |
9341 | ||
9342 | MAGIC, SvSTASH | |
9343 | ||
9344 | =item B::MAGIC METHODS | |
9345 | ||
9346 | MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX | |
9347 | ||
9348 | =item B::PVLV METHODS | |
9349 | ||
9350 | TARGOFF, TARGLEN, TYPE, TARG | |
9351 | ||
9352 | =item B::BM METHODS | |
9353 | ||
9354 | USEFUL, PREVIOUS, RARE, TABLE | |
9355 | ||
9356 | =item B::GV METHODS | |
9357 | ||
9358 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, | |
9359 | LINE, FILE, FILEGV, GvREFCNT, FLAGS | |
9360 | ||
9361 | =item B::IO METHODS | |
9362 | ||
9363 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, | |
9364 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD | |
9365 | ||
9366 | =item B::AV METHODS | |
9367 | ||
9368 | FILL, MAX, OFF, ARRAY, AvFLAGS | |
9369 | ||
9370 | =item B::CV METHODS | |
9371 | ||
9372 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY, | |
9373 | CvFLAGS, const_sv | |
9374 | ||
9375 | =item B::HV METHODS | |
9376 | ||
9377 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY | |
9378 | ||
9379 | =item OP-RELATED CLASSES | |
9380 | ||
9381 | =item B::OP METHODS | |
9382 | ||
9383 | next, sibling, name, ppaddr, desc, targ, type, seq, flags, private | |
9384 | ||
9385 | =item B::UNOP METHOD | |
9386 | ||
9387 | first | |
9388 | ||
9389 | =item B::BINOP METHOD | |
9390 | ||
9391 | last | |
9392 | ||
9393 | =item B::LOGOP METHOD | |
9394 | ||
9395 | other | |
9396 | ||
9397 | =item B::LISTOP METHOD | |
9398 | ||
9399 | children | |
9400 | ||
9401 | =item B::PMOP METHODS | |
9402 | ||
9403 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, | |
9404 | pmpermflags, precomp, pmoffet | |
9405 | ||
9406 | =item B::SVOP METHOD | |
9407 | ||
9408 | sv, gv | |
9409 | ||
9410 | =item B::PADOP METHOD | |
9411 | ||
9412 | padix | |
9413 | ||
9414 | =item B::PVOP METHOD | |
9415 | ||
9416 | pv | |
9417 | ||
9418 | =item B::LOOP METHODS | |
9419 | ||
9420 | redoop, nextop, lastop | |
9421 | ||
9422 | =item B::COP METHODS | |
9423 | ||
9424 | label, stash, file, cop_seq, arybase, line | |
9425 | ||
9426 | =back | |
9427 | ||
9428 | =item FUNCTIONS EXPORTED BY C<B> | |
9429 | ||
9430 | main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist, | |
9431 | regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP, | |
9432 | METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE, | |
9433 | PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c, | |
9434 | cstring(STR), perlstring(STR), class(OBJ), threadsv_names | |
9435 | ||
9436 | =item AUTHOR | |
9437 | ||
9438 | =back | |
9439 | ||
9440 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate | |
9441 | bytecode | |
9442 | ||
9443 | =over 4 | |
9444 | ||
9445 | =item SYNOPSIS | |
9446 | ||
9447 | =item DESCRIPTION | |
9448 | ||
9449 | %insn_data, @insn_name, @optype, @specialsv_name | |
9450 | ||
9451 | =item AUTHOR | |
9452 | ||
9453 | =back | |
9454 | ||
9455 | =head2 B::Assembler - Assemble Perl bytecode | |
9456 | ||
9457 | =over 4 | |
9458 | ||
9459 | =item SYNOPSIS | |
9460 | ||
9461 | =item DESCRIPTION | |
9462 | ||
9463 | =item AUTHORS | |
9464 | ||
9465 | =back | |
9466 | ||
9467 | =head2 B::Bblock - Walk basic blocks | |
9468 | ||
9469 | =over 4 | |
9470 | ||
9471 | =item SYNOPSIS | |
9472 | ||
9473 | =item DESCRIPTION | |
9474 | ||
9475 | =over 4 | |
9476 | ||
9477 | =item Functions | |
9478 | ||
9479 | B<find_leaders> | |
9480 | ||
9481 | =back | |
9482 | ||
9483 | =item AUTHOR | |
9484 | ||
9485 | =back | |
9486 | ||
9487 | =head2 B::Bytecode - Perl compiler's bytecode backend | |
9488 | ||
9489 | =over 4 | |
9490 | ||
9491 | =item SYNOPSIS | |
9492 | ||
9493 | =item DESCRIPTION | |
9494 | ||
9495 | =item OPTIONS | |
9496 | ||
9497 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, | |
9498 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, | |
9499 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> | |
9500 | ||
9501 | =item EXAMPLES | |
9502 | ||
9503 | =item BUGS | |
9504 | ||
9505 | =item AUTHORS | |
9506 | ||
9507 | =back | |
9508 | ||
9509 | =head2 B::C - Perl compiler's C backend | |
9510 | ||
9511 | =over 4 | |
9512 | ||
9513 | =item SYNOPSIS | |
9514 | ||
9515 | =item DESCRIPTION | |
9516 | ||
9517 | =item OPTIONS | |
9518 | ||
9519 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
9520 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, | |
9521 | B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, | |
9522 | B<-llimit> | |
9523 | ||
9524 | =item EXAMPLES | |
9525 | ||
9526 | =item BUGS | |
9527 | ||
9528 | =item AUTHOR | |
9529 | ||
9530 | =back | |
9531 | ||
9532 | =head2 B::CC - Perl compiler's optimized C translation backend | |
9533 | ||
9534 | =over 4 | |
9535 | ||
9536 | =item SYNOPSIS | |
9537 | ||
9538 | =item DESCRIPTION | |
9539 | ||
9540 | =item OPTIONS | |
9541 | ||
9542 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
9543 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
9544 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
9545 | ||
9546 | =item EXAMPLES | |
9547 | ||
9548 | =item BUGS | |
9549 | ||
9550 | =item DIFFERENCES | |
9551 | ||
9552 | =over 4 | |
9553 | ||
9554 | =item Loops | |
9555 | ||
9556 | =item Context of ".." | |
9557 | ||
9558 | =item Arithmetic | |
9559 | ||
9560 | =item Deprecated features | |
9561 | ||
9562 | =back | |
9563 | ||
9564 | =item AUTHOR | |
9565 | ||
9566 | =back | |
9567 | ||
9568 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops | |
9569 | ||
9570 | =over 4 | |
9571 | ||
9572 | =item SYNOPSIS | |
9573 | ||
9574 | =item DESCRIPTION | |
9575 | ||
9576 | =item EXAMPLE | |
9577 | ||
9578 | =item OPTIONS | |
9579 | ||
9580 | B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, | |
9581 | B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>, | |
9582 | B<-terse>, B<-linenoise>, B<-debug>, B<-env> | |
9583 | ||
9584 | =item FORMATTING SPECIFICATIONS | |
9585 | ||
9586 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, | |
9587 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, | |
9588 | B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>, | |
9589 | B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, | |
9590 | B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, | |
9591 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, | |
9592 | B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, | |
9593 | B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> | |
9594 | ||
9595 | =item ABBREVIATIONS | |
9596 | ||
9597 | =over 4 | |
9598 | ||
9599 | =item OP flags abbreviations | |
9600 | ||
9601 | =item OP class abbreviations | |
9602 | ||
9603 | =back | |
9604 | ||
9605 | =item Using B::Concise outside of the O framework | |
9606 | ||
9607 | =item AUTHOR | |
9608 | ||
9609 | =back | |
9610 | ||
9611 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops | |
9612 | ||
9613 | =over 4 | |
9614 | ||
9615 | =item SYNOPSIS | |
9616 | ||
9617 | =item DESCRIPTION | |
9618 | ||
9619 | =item AUTHOR | |
9620 | ||
9621 | =back | |
9622 | ||
9623 | =head2 B::Deparse - Perl compiler backend to produce perl code | |
9624 | ||
9625 | =over 4 | |
9626 | ||
9627 | =item SYNOPSIS | |
9628 | ||
9629 | =item DESCRIPTION | |
9630 | ||
9631 | =item OPTIONS | |
9632 | ||
9633 | B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, | |
9634 | B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> | |
9635 | ||
9636 | =item USING B::Deparse AS A MODULE | |
9637 | ||
9638 | =over 4 | |
9639 | ||
9640 | =item Synopsis | |
9641 | ||
9642 | =item Description | |
9643 | ||
9644 | =item new | |
9645 | ||
9646 | =item ambient_pragmas | |
9647 | ||
9648 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits | |
9649 | ||
9650 | =item coderef2text | |
9651 | ||
9652 | =back | |
9653 | ||
9654 | =item BUGS | |
9655 | ||
9656 | =item AUTHOR | |
9657 | ||
9658 | =back | |
9659 | ||
9660 | =head2 B::Disassembler - Disassemble Perl bytecode | |
9661 | ||
9662 | =over 4 | |
9663 | ||
9664 | =item SYNOPSIS | |
9665 | ||
9666 | =item DESCRIPTION | |
9667 | ||
9668 | =item AUTHOR | |
9669 | ||
9670 | =back | |
9671 | ||
9672 | =head2 B::Lint - Perl lint | |
9673 | ||
9674 | =over 4 | |
9675 | ||
9676 | =item SYNOPSIS | |
9677 | ||
9678 | =item DESCRIPTION | |
9679 | ||
9680 | =item OPTIONS AND LINT CHECKS | |
9681 | ||
9682 | B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>, | |
9683 | B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> | |
9684 | ||
9685 | =item NON LINT-CHECK OPTIONS | |
9686 | ||
9687 | B<-u Package> | |
9688 | ||
9689 | =item BUGS | |
9690 | ||
9691 | =item AUTHOR | |
9692 | ||
9693 | =back | |
9694 | ||
9695 | =head2 B::O, O - Generic interface to Perl Compiler backends | |
9696 | ||
9697 | =over 4 | |
9698 | ||
9699 | =item SYNOPSIS | |
9700 | ||
9701 | =item DESCRIPTION | |
9702 | ||
9703 | =item CONVENTIONS | |
9704 | ||
9705 | =item IMPLEMENTATION | |
9706 | ||
9707 | =item BUGS | |
9708 | ||
9709 | =item AUTHOR | |
9710 | ||
9711 | =back | |
9712 | ||
9713 | =head2 B::Showlex - Show lexical variables used in functions or files | |
9714 | ||
9715 | =over 4 | |
9716 | ||
9717 | =item SYNOPSIS | |
9718 | ||
9719 | =item DESCRIPTION | |
9720 | ||
9721 | =item AUTHOR | |
9722 | ||
9723 | =back | |
9724 | ||
9725 | =head2 B::Stackobj - Helper module for CC backend | |
9726 | ||
9727 | =over 4 | |
9728 | ||
9729 | =item SYNOPSIS | |
9730 | ||
9731 | =item DESCRIPTION | |
9732 | ||
9733 | =item AUTHOR | |
9734 | ||
9735 | =back | |
9736 | ||
9737 | =head2 B::Stash - show what stashes are loaded | |
9738 | ||
9739 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops | |
9740 | ||
9741 | =over 4 | |
9742 | ||
9743 | =item SYNOPSIS | |
9744 | ||
9745 | =item DESCRIPTION | |
9746 | ||
9747 | =item AUTHOR | |
9748 | ||
9749 | =back | |
9750 | ||
9751 | =head2 B::Xref - Generates cross reference reports for Perl programs | |
9752 | ||
9753 | =over 4 | |
9754 | ||
9755 | =item SYNOPSIS | |
9756 | ||
9757 | =item DESCRIPTION | |
9758 | ||
9759 | =item OPTIONS | |
9760 | ||
9761 | C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> | |
9762 | ||
9763 | =item BUGS | |
9764 | ||
9765 | =item AUTHOR | |
9766 | ||
9767 | =back | |
9768 | ||
9769 | =head2 Bblock, B::Bblock - Walk basic blocks | |
9770 | ||
9771 | =over 4 | |
9772 | ||
9773 | =item SYNOPSIS | |
9774 | ||
9775 | =item DESCRIPTION | |
9776 | ||
9777 | =over 4 | |
9778 | ||
9779 | =item Functions | |
9780 | ||
9781 | B<find_leaders> | |
9782 | ||
9783 | =back | |
9784 | ||
9785 | =item AUTHOR | |
9786 | ||
9787 | =back | |
9788 | ||
9789 | =head2 Benchmark - benchmark running times of Perl code | |
9790 | ||
9791 | =over 4 | |
9792 | ||
9793 | =item SYNOPSIS | |
9794 | ||
9795 | =item DESCRIPTION | |
9796 | ||
9797 | =over 4 | |
9798 | ||
9799 | =item Methods | |
9800 | ||
9801 | new, debug, iters | |
9802 | ||
9803 | =item Standard Exports | |
9804 | ||
9805 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
9806 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( | |
9807 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
9808 | ||
9809 | =item Optional Exports | |
9810 | ||
9811 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [ | |
9812 | STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), | |
9813 | disablecache ( ), enablecache ( ), timesum ( T1, T2 ) | |
9814 | ||
9815 | =back | |
9816 | ||
9817 | =item NOTES | |
9818 | ||
9819 | =item EXAMPLES | |
9820 | ||
9821 | =item INHERITANCE | |
9822 | ||
9823 | =item CAVEATS | |
9824 | ||
9825 | =item SEE ALSO | |
9826 | ||
9827 | =item AUTHORS | |
9828 | ||
9829 | =item MODIFICATION HISTORY | |
9830 | ||
9831 | =back | |
9832 | ||
9833 | =head2 ByteLoader - load byte compiled perl code | |
9834 | ||
9835 | =over 4 | |
9836 | ||
9837 | =item SYNOPSIS | |
9838 | ||
9839 | =item DESCRIPTION | |
9840 | ||
9841 | =item AUTHOR | |
9842 | ||
9843 | =item SEE ALSO | |
9844 | ||
9845 | =back | |
9846 | ||
9847 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend | |
9848 | ||
9849 | =over 4 | |
9850 | ||
9851 | =item SYNOPSIS | |
9852 | ||
9853 | =item DESCRIPTION | |
9854 | ||
9855 | =item OPTIONS | |
9856 | ||
9857 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, | |
9858 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, | |
9859 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> | |
9860 | ||
9861 | =item EXAMPLES | |
9862 | ||
9863 | =item BUGS | |
9864 | ||
9865 | =item AUTHORS | |
9866 | ||
9867 | =back | |
9868 | ||
9869 | =head2 CGI - Simple Common Gateway Interface Class | |
9870 | ||
9871 | =over 4 | |
9872 | ||
9873 | =item SYNOPSIS | |
9874 | ||
9875 | =item ABSTRACT | |
9876 | ||
9877 | =item DESCRIPTION | |
9878 | ||
9879 | =over 4 | |
9880 | ||
9881 | =item PROGRAMMING STYLE | |
9882 | ||
9883 | =item CALLING CGI.PM ROUTINES | |
9884 | ||
9885 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): | |
9886 | ||
9887 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
9888 | ||
9889 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
9890 | ||
9891 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
9892 | ||
9893 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
9894 | ||
9895 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
9896 | ||
9897 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
9898 | ||
9899 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
9900 | ||
9901 | =item DELETING A PARAMETER COMPLETELY: | |
9902 | ||
9903 | =item DELETING ALL PARAMETERS: | |
9904 | ||
9905 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
9906 | ||
9907 | =item FETCHING THE PARAMETER LIST AS A HASH: | |
9908 | ||
9909 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: | |
9910 | ||
9911 | =item RETRIEVING CGI ERRORS | |
9912 | ||
9913 | =item USING THE FUNCTION-ORIENTED INTERFACE | |
9914 | ||
9915 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, | |
9916 | B<:standard>, B<:all> | |
9917 | ||
9918 | =item PRAGMAS | |
9919 | ||
9920 | -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, | |
9921 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, | |
9922 | -private_tempfiles | |
9923 | ||
9924 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS | |
9925 | ||
9926 | 1. start_table() (generates a <table> tag), 2. end_table() (generates a | |
9927 | </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates | |
9928 | a </ul> tag) | |
9929 | ||
9930 | =back | |
9931 | ||
9932 | =item GENERATING DYNAMIC DOCUMENTS | |
9933 | ||
9934 | =over 4 | |
9935 | ||
9936 | =item CREATING A STANDARD HTTP HEADER: | |
9937 | ||
9938 | =item GENERATING A REDIRECTION HEADER | |
9939 | ||
9940 | =item CREATING THE HTML DOCUMENT HEADER | |
9941 | ||
9942 | B<Parameters:>, 4, 5, 6.. | |
9943 | ||
9944 | =item ENDING THE HTML DOCUMENT: | |
9945 | ||
9946 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
9947 | ||
9948 | =item OBTAINING THE SCRIPT'S URL | |
9949 | ||
9950 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
9951 | (B<-query_string>), B<-base> | |
9952 | ||
9953 | =item MIXING POST AND URL PARAMETERS | |
9954 | ||
9955 | =back | |
9956 | ||
9957 | =item CREATING STANDARD HTML ELEMENTS: | |
9958 | ||
9959 | =over 4 | |
9960 | ||
9961 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
9962 | ||
9963 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
9964 | ||
9965 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
9966 | ||
9967 | =item NON-STANDARD HTML SHORTCUTS | |
9968 | ||
9969 | =item AUTOESCAPING HTML | |
9970 | ||
9971 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
9972 | charset([$charset]);, $flag = autoEscape([$flag]); | |
9973 | ||
9974 | =item PRETTY-PRINTING HTML | |
9975 | ||
9976 | =back | |
9977 | ||
9978 | =item CREATING FILL-OUT FORMS: | |
9979 | ||
9980 | =over 4 | |
9981 | ||
9982 | =item CREATING AN ISINDEX TAG | |
9983 | ||
9984 | =item STARTING AND ENDING A FORM | |
9985 | ||
9986 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
9987 | ||
9988 | =item CREATING A TEXT FIELD | |
9989 | ||
9990 | B<Parameters> | |
9991 | ||
9992 | =item CREATING A BIG TEXT FIELD | |
9993 | ||
9994 | =item CREATING A PASSWORD FIELD | |
9995 | ||
9996 | =item CREATING A FILE UPLOAD FIELD | |
9997 | ||
9998 | B<Parameters> | |
9999 | ||
10000 | =item CREATING A POPUP MENU | |
10001 | ||
10002 | =item CREATING A SCROLLING LIST | |
10003 | ||
10004 | B<Parameters:> | |
10005 | ||
10006 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
10007 | ||
10008 | B<Parameters:> | |
10009 | ||
10010 | =item CREATING A STANDALONE CHECKBOX | |
10011 | ||
10012 | B<Parameters:> | |
10013 | ||
10014 | =item CREATING A RADIO BUTTON GROUP | |
10015 | ||
10016 | B<Parameters:> | |
10017 | ||
10018 | =item CREATING A SUBMIT BUTTON | |
10019 | ||
10020 | B<Parameters:> | |
10021 | ||
10022 | =item CREATING A RESET BUTTON | |
10023 | ||
10024 | =item CREATING A DEFAULT BUTTON | |
10025 | ||
10026 | =item CREATING A HIDDEN FIELD | |
10027 | ||
10028 | B<Parameters:> | |
10029 | ||
10030 | =item CREATING A CLICKABLE IMAGE BUTTON | |
10031 | ||
10032 | B<Parameters:> | |
10033 | ||
10034 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
10035 | ||
10036 | =back | |
10037 | ||
10038 | =item HTTP COOKIES | |
10039 | ||
10040 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
10041 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
10042 | ||
10043 | =item WORKING WITH FRAMES | |
10044 | ||
10045 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
10046 | document in the HTTP header, 3. Specify the destination for the document in | |
10047 | the <form> tag | |
10048 | ||
10049 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS | |
10050 | ||
10051 | =item DEBUGGING | |
10052 | ||
10053 | =over 4 | |
10054 | ||
10055 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
10056 | ||
10057 | =back | |
10058 | ||
10059 | =item FETCHING ENVIRONMENT VARIABLES | |
10060 | ||
10061 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, | |
10062 | B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>, | |
10063 | B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, | |
10064 | B<server_software ()>, B<remote_user ()>, B<user_name ()>, | |
10065 | B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
10066 | ||
10067 | =item USING NPH SCRIPTS | |
10068 | ||
10069 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> | |
10070 | parameters | |
10071 | ||
10072 | =item Server Push | |
10073 | ||
10074 | multipart_init(), multipart_start(), multipart_end(), multipart_final() | |
10075 | ||
10076 | =item Avoiding Denial of Service Attacks | |
10077 | ||
10078 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script | |
10079 | basis>, B<2. Globally for all scripts> | |
10080 | ||
10081 | =item COMPATIBILITY WITH CGI-LIB.PL | |
10082 | ||
10083 | =item AUTHOR INFORMATION | |
10084 | ||
10085 | =item CREDITS | |
10086 | ||
10087 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
10088 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
10089 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
10090 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick | |
10091 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
10092 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
10093 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
10094 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
10095 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
10096 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
10097 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
10098 | ...and many many more.. | |
10099 | ||
10100 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
10101 | ||
10102 | =item BUGS | |
10103 | ||
10104 | =item SEE ALSO | |
10105 | ||
10106 | =back | |
10107 | ||
10108 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
10109 | ||
10110 | =over 4 | |
10111 | ||
10112 | =item SYNOPSIS | |
10113 | ||
10114 | =item ABSTRACT | |
10115 | ||
10116 | =item DESCRIPTION | |
10117 | ||
10118 | =item AUTHOR INFORMATION | |
10119 | ||
10120 | =item BUGS | |
10121 | ||
10122 | =item SEE ALSO | |
10123 | ||
10124 | =back | |
10125 | ||
10126 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
10127 | other) error log | |
10128 | ||
10129 | =over 4 | |
10130 | ||
10131 | =item SYNOPSIS | |
10132 | ||
10133 | =item DESCRIPTION | |
10134 | ||
10135 | =item REDIRECTING ERROR MESSAGES | |
10136 | ||
10137 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
10138 | ||
10139 | =over 4 | |
10140 | ||
10141 | =item Changing the default message | |
10142 | ||
10143 | =back | |
10144 | ||
10145 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS | |
10146 | ||
10147 | =item CHANGE LOG | |
10148 | ||
10149 | =item AUTHORS | |
10150 | ||
10151 | =item SEE ALSO | |
10152 | ||
10153 | =back | |
10154 | ||
10155 | =head2 CGI::Cookie - Interface to Netscape Cookies | |
10156 | ||
10157 | =over 4 | |
10158 | ||
10159 | =item SYNOPSIS | |
10160 | ||
10161 | =item DESCRIPTION | |
10162 | ||
10163 | =item USING CGI::Cookie | |
10164 | ||
10165 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
10166 | ||
10167 | =over 4 | |
10168 | ||
10169 | =item Creating New Cookies | |
10170 | ||
10171 | =item Sending the Cookie to the Browser | |
10172 | ||
10173 | =item Recovering Previous Cookies | |
10174 | ||
10175 | =item Manipulating Cookies | |
10176 | ||
10177 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
10178 | ||
10179 | =back | |
10180 | ||
10181 | =item AUTHOR INFORMATION | |
10182 | ||
10183 | =item BUGS | |
10184 | ||
10185 | =item SEE ALSO | |
10186 | ||
10187 | =back | |
10188 | ||
10189 | =head2 CGI::Fast - CGI Interface for Fast CGI | |
10190 | ||
10191 | =over 4 | |
10192 | ||
10193 | =item SYNOPSIS | |
10194 | ||
10195 | =item DESCRIPTION | |
10196 | ||
10197 | =item OTHER PIECES OF THE PUZZLE | |
10198 | ||
10199 | =item WRITING FASTCGI PERL SCRIPTS | |
10200 | ||
10201 | =item INSTALLING FASTCGI SCRIPTS | |
10202 | ||
10203 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
10204 | ||
10205 | =item EXTERNAL FASTCGI SERVER INVOCATION | |
10206 | ||
10207 | FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE | |
10208 | ||
10209 | =item CAVEATS | |
10210 | ||
10211 | =item AUTHOR INFORMATION | |
10212 | ||
10213 | =item BUGS | |
10214 | ||
10215 | =item SEE ALSO | |
10216 | ||
10217 | =back | |
10218 | ||
10219 | =head2 CGI::Pretty - module to produce nicely formatted HTML code | |
10220 | ||
10221 | =over 4 | |
10222 | ||
10223 | =item SYNOPSIS | |
10224 | ||
10225 | =item DESCRIPTION | |
10226 | ||
10227 | =over 4 | |
10228 | ||
10229 | =item Tags that won't be formatted | |
10230 | ||
10231 | =item Customizing the Indenting | |
10232 | ||
10233 | =back | |
10234 | ||
10235 | =item BUGS | |
10236 | ||
10237 | =item AUTHOR | |
10238 | ||
10239 | =item SEE ALSO | |
10240 | ||
10241 | =back | |
10242 | ||
10243 | =head2 CGI::Push - Simple Interface to Server Push | |
10244 | ||
10245 | =over 4 | |
10246 | ||
10247 | =item SYNOPSIS | |
10248 | ||
10249 | =item DESCRIPTION | |
10250 | ||
10251 | =item USING CGI::Push | |
10252 | ||
10253 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph | |
10254 | ||
10255 | =over 4 | |
10256 | ||
10257 | =item Heterogeneous Pages | |
10258 | ||
10259 | =item Changing the Page Delay on the Fly | |
10260 | ||
10261 | =back | |
10262 | ||
10263 | =item INSTALLING CGI::Push SCRIPTS | |
10264 | ||
10265 | =item AUTHOR INFORMATION | |
10266 | ||
10267 | =item BUGS | |
10268 | ||
10269 | =item SEE ALSO | |
10270 | ||
10271 | =back | |
10272 | ||
10273 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
10274 | ||
10275 | =over 4 | |
10276 | ||
10277 | =item SYNOPSIS | |
10278 | ||
10279 | =item ABSTRACT | |
10280 | ||
10281 | =item DESCRIPTION | |
10282 | ||
10283 | =item AUTHOR INFORMATION | |
10284 | ||
10285 | =item BUGS | |
10286 | ||
10287 | =item SEE ALSO | |
10288 | ||
10289 | =back | |
10290 | ||
10291 | =head2 CGI::Util - Internal utilities used by CGI module | |
10292 | ||
10293 | =over 4 | |
10294 | ||
10295 | =item SYNOPSIS | |
10296 | ||
10297 | =item DESCRIPTION | |
10298 | ||
10299 | =item AUTHOR INFORMATION | |
10300 | ||
10301 | =item SEE ALSO | |
10302 | ||
10303 | =back | |
10304 | ||
10305 | =head2 CPAN - query, download and build perl modules from CPAN sites | |
10306 | ||
10307 | =over 4 | |
10308 | ||
10309 | =item SYNOPSIS | |
10310 | ||
10311 | =item DESCRIPTION | |
10312 | ||
10313 | =over 4 | |
10314 | ||
10315 | =item Interactive Mode | |
10316 | ||
10317 | Searching for authors, bundles, distribution files and modules, make, test, | |
10318 | install, clean modules or distributions, get, readme, look module or | |
10319 | distribution, ls author, Signals | |
10320 | ||
10321 | =item CPAN::Shell | |
10322 | ||
10323 | =item autobundle | |
10324 | ||
10325 | =item recompile | |
10326 | ||
10327 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution | |
10328 | ||
10329 | =item Programmer's interface | |
10330 | ||
10331 | expand($type,@things), expandany(@things), Programming Examples | |
10332 | ||
10333 | =item Methods in the other Classes | |
10334 | ||
10335 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), | |
10336 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), | |
10337 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), | |
10338 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), | |
10339 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), | |
10340 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), | |
10341 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), | |
10342 | CPAN::Bundle::readme(), CPAN::Bundle::test(), | |
10343 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), | |
10344 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), | |
10345 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), | |
10346 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), | |
10347 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), | |
10348 | CPAN::Distribution::look(), CPAN::Distribution::make(), | |
10349 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), | |
10350 | CPAN::Distribution::test(), CPAN::Distribution::uptodate(), | |
10351 | CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), | |
10352 | CPAN::Module::as_glimpse(), CPAN::Module::as_string(), | |
10353 | CPAN::Module::clean(), CPAN::Module::cpan_file(), | |
10354 | CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), | |
10355 | CPAN::Module::description(), CPAN::Module::force($method,@args), | |
10356 | CPAN::Module::get(), CPAN::Module::inst_file(), | |
10357 | CPAN::Module::inst_version(), CPAN::Module::install(), | |
10358 | CPAN::Module::look(), CPAN::Module::make(), | |
10359 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), | |
10360 | CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() | |
10361 | ||
10362 | =item Cache Manager | |
10363 | ||
10364 | =item Bundles | |
10365 | ||
10366 | =item Prerequisites | |
10367 | ||
10368 | =item Finding packages and VERSION | |
10369 | ||
10370 | =item Debugging | |
10371 | ||
10372 | =item Floppy, Zip, Offline Mode | |
10373 | ||
10374 | =back | |
10375 | ||
10376 | =item CONFIGURATION | |
10377 | ||
10378 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> | |
10379 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
10380 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
10381 | [unshift|push|splice] E<lt>listE<gt>> | |
10382 | ||
10383 | =over 4 | |
10384 | ||
10385 | =item Note on urllist parameter's format | |
10386 | ||
10387 | =item urllist parameter has CD-ROM support | |
10388 | ||
10389 | =back | |
10390 | ||
10391 | =item SECURITY | |
10392 | ||
10393 | =item EXPORT | |
10394 | ||
10395 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES | |
10396 | ||
10397 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
10398 | ||
10399 | =over 4 | |
10400 | ||
10401 | =item Three basic types of firewalls | |
10402 | ||
10403 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade | |
10404 | ||
10405 | =item Configuring lynx or ncftp for going through a firewall | |
10406 | ||
10407 | =back | |
10408 | ||
10409 | =item FAQ | |
10410 | ||
10411 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10) | |
10412 | ||
10413 | =item BUGS | |
10414 | ||
10415 | =item AUTHOR | |
10416 | ||
10417 | =item TRANSLATIONS | |
10418 | ||
10419 | =item SEE ALSO | |
10420 | ||
10421 | =back | |
10422 | ||
10423 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization | |
10424 | ||
10425 | =over 4 | |
10426 | ||
10427 | =item SYNOPSIS | |
10428 | ||
10429 | =item DESCRIPTION | |
10430 | ||
10431 | =back | |
10432 | ||
10433 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS | |
10434 | module | |
10435 | ||
10436 | =over 4 | |
10437 | ||
10438 | =item SYNOPSIS | |
10439 | ||
10440 | =item DESCRIPTION | |
10441 | ||
10442 | =item SEE ALSO | |
10443 | ||
10444 | =back | |
10445 | ||
10446 | =head2 Carp, carp - warn of errors (from perspective of caller) | |
10447 | ||
10448 | =over 4 | |
10449 | ||
10450 | =item SYNOPSIS | |
10451 | ||
10452 | =item DESCRIPTION | |
10453 | ||
10454 | =over 4 | |
10455 | ||
10456 | =item Forcing a Stack Trace | |
10457 | ||
10458 | =back | |
10459 | ||
10460 | =item BUGS | |
10461 | ||
10462 | =back | |
10463 | ||
10464 | =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside | |
10465 | ||
10466 | =head2 Class::ISA -- report the search path for a class's ISA tree | |
10467 | ||
10468 | =over 4 | |
10469 | ||
10470 | =item SYNOPSIS | |
10471 | ||
10472 | =item DESCRIPTION | |
10473 | ||
10474 | =item FUNCTIONS | |
10475 | ||
10476 | the function Class::ISA::super_path($CLASS), the function | |
10477 | Class::ISA::self_and_super_path($CLASS), the function | |
10478 | Class::ISA::self_and_super_versions($CLASS) | |
10479 | ||
10480 | =item CAUTIONARY NOTES | |
10481 | ||
10482 | =item COPYRIGHT | |
10483 | ||
10484 | =item AUTHOR | |
10485 | ||
10486 | =back | |
10487 | ||
10488 | =head2 Class::Struct - declare struct-like datatypes as Perl classes | |
10489 | ||
10490 | =over 4 | |
10491 | ||
10492 | =item SYNOPSIS | |
10493 | ||
10494 | =item DESCRIPTION | |
10495 | ||
10496 | =over 4 | |
10497 | ||
10498 | =item The C<struct()> function | |
10499 | ||
10500 | =item Class Creation at Compile Time | |
10501 | ||
10502 | =item Element Types and Accessor Methods | |
10503 | ||
10504 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
10505 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
10506 | ||
10507 | =item Initializing with C<new> | |
10508 | ||
10509 | =back | |
10510 | ||
10511 | =item EXAMPLES | |
10512 | ||
10513 | Example 1, Example 2, Example 3 | |
10514 | ||
10515 | =item Author and Modification History | |
10516 | ||
10517 | =back | |
10518 | ||
10519 | =head2 Config - access Perl configuration information | |
10520 | ||
10521 | =over 4 | |
10522 | ||
10523 | =item SYNOPSIS | |
10524 | ||
10525 | =item DESCRIPTION | |
10526 | ||
10527 | myconfig(), config_sh(), config_vars(@names) | |
10528 | ||
10529 | =item EXAMPLE | |
10530 | ||
10531 | =item WARNING | |
10532 | ||
10533 | =item GLOSSARY | |
10534 | ||
10535 | =over 4 | |
10536 | ||
10537 | =item _ | |
10538 | ||
10539 | C<_a>, C<_exe>, C<_o> | |
10540 | ||
10541 | =item a | |
10542 | ||
10543 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, | |
10544 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, | |
10545 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, | |
10546 | C<asctime_r_proto>, C<awk> | |
10547 | ||
10548 | =item b | |
10549 | ||
10550 | C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> | |
10551 | ||
10552 | =item c | |
10553 | ||
10554 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
10555 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, | |
10556 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
10557 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, | |
10558 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, | |
10559 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, | |
10560 | C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> | |
10561 | ||
10562 | =item d | |
10563 | ||
10564 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, | |
10565 | C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, | |
10566 | C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, | |
10567 | C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, | |
10568 | C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, | |
10569 | C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>, | |
10570 | C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, | |
10571 | C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, | |
10572 | C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, | |
10573 | C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>, | |
10574 | C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>, | |
10575 | C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>, | |
10576 | C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, | |
10577 | C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>, | |
10578 | C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>, | |
10579 | C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>, | |
10580 | C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, | |
10581 | C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, | |
10582 | C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, | |
10583 | C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>, | |
10584 | C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, | |
10585 | C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, | |
10586 | C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, | |
10587 | C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, | |
10588 | C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, | |
10589 | C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, | |
10590 | C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, | |
10591 | C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>, | |
10592 | C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>, | |
10593 | C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>, | |
10594 | C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, | |
10595 | C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>, | |
10596 | C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>, | |
10597 | C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, | |
10598 | C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>, | |
10599 | C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, | |
10600 | C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>, | |
10601 | C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>, | |
10602 | C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, | |
10603 | C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, | |
10604 | C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, | |
10605 | C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, | |
10606 | C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>, | |
10607 | C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>, | |
10608 | C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>, | |
10609 | C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>, | |
10610 | C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, | |
10611 | C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, | |
10612 | C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, | |
10613 | C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, | |
10614 | C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, | |
10615 | C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, | |
10616 | C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, | |
10617 | C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, | |
10618 | C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, | |
10619 | C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, | |
10620 | C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, | |
10621 | C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, | |
10622 | C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>, | |
10623 | C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, | |
10624 | C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>, | |
10625 | C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>, | |
10626 | C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, | |
10627 | C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, | |
10628 | C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>, | |
10629 | C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>, | |
10630 | C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, | |
10631 | C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, | |
10632 | C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, | |
10633 | C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, | |
10634 | C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, | |
10635 | C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, | |
10636 | C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, | |
10637 | C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, | |
10638 | C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, | |
10639 | C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>, | |
10640 | C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, | |
10641 | C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, | |
10642 | C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, | |
10643 | C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, | |
10644 | C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>, | |
10645 | C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>, | |
10646 | C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>, | |
10647 | C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, | |
10648 | C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, | |
10649 | C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, | |
10650 | C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, | |
10651 | C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, | |
10652 | C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, | |
10653 | C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> | |
10654 | ||
10655 | =item e | |
10656 | ||
10657 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, | |
10658 | C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, | |
10659 | C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, | |
10660 | C<expr>, C<extensions>, C<extras> | |
10661 | ||
10662 | =item f | |
10663 | ||
10664 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
10665 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, | |
10666 | C<full_sed> | |
10667 | ||
10668 | =item g | |
10669 | ||
10670 | C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>, | |
10671 | C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>, | |
10672 | C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>, | |
10673 | C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>, | |
10674 | C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>, | |
10675 | C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>, | |
10676 | C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>, | |
10677 | C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, | |
10678 | C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, | |
10679 | C<gzip> | |
10680 | ||
10681 | =item h | |
10682 | ||
10683 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat> | |
10684 | ||
10685 | =item i | |
10686 | ||
10687 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, | |
10688 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, | |
10689 | C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, | |
10690 | C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, | |
10691 | C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, | |
10692 | C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, | |
10693 | C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, | |
10694 | C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, | |
10695 | C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, | |
10696 | C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, | |
10697 | C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, | |
10698 | C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, | |
10699 | C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, | |
10700 | C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, | |
10701 | C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, | |
10702 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, | |
10703 | C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, | |
10704 | C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, | |
10705 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>, | |
10706 | C<installman3dir>, C<installprefix>, C<installprefixexp>, | |
10707 | C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>, | |
10708 | C<installsitelib>, C<installstyle>, C<installusrbinperl>, | |
10709 | C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>, | |
10710 | C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> | |
10711 | ||
10712 | =item k | |
10713 | ||
10714 | C<known_extensions>, C<ksh> | |
10715 | ||
10716 | =item l | |
10717 | ||
10718 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, | |
10719 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
10720 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
10721 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
10722 | C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, | |
10723 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, | |
10724 | C<lseektype> | |
10725 | ||
10726 | =item m | |
10727 | ||
10728 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
10729 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
10730 | C<man3direxp>, C<man3ext> | |
10731 | ||
10732 | =item M | |
10733 | ||
10734 | C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>, | |
10735 | C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname> | |
10736 | ||
10737 | =item n | |
10738 | ||
10739 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, | |
10740 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, | |
10741 | C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, | |
10742 | C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, | |
10743 | C<nvsize>, C<nvtype> | |
10744 | ||
10745 | =item o | |
10746 | ||
10747 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
10748 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> | |
10749 | ||
10750 | =item p | |
10751 | ||
10752 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, | |
10753 | C<perl>, C<perl_patchlevel> | |
10754 | ||
10755 | =item P | |
10756 | ||
10757 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
10758 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, | |
10759 | C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, | |
10760 | C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize> | |
10761 | ||
10762 | =item q | |
10763 | ||
10764 | C<quadkind>, C<quadtype> | |
10765 | ||
10766 | =item r | |
10767 | ||
10768 | C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, | |
10769 | C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, | |
10770 | C<rmail>, C<run>, C<runnm> | |
10771 | ||
10772 | =item s | |
10773 | ||
10774 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
10775 | C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, | |
10776 | C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, | |
10777 | C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, | |
10778 | C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, | |
10779 | C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, | |
10780 | C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, | |
10781 | C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, | |
10782 | C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, | |
10783 | C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, | |
10784 | C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, | |
10785 | C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, | |
10786 | C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, | |
10787 | C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>, | |
10788 | C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, | |
10789 | C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>, | |
10790 | C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman> | |
10791 | ||
10792 | =item t | |
10793 | ||
10794 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, | |
10795 | C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, | |
10796 | C<ttyname_r_proto> | |
10797 | ||
10798 | =item u | |
10799 | ||
10800 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, | |
10801 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
10802 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, | |
10803 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>, | |
10804 | C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, | |
10805 | C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, | |
10806 | C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, | |
10807 | C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, | |
10808 | C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat> | |
10809 | ||
10810 | =item v | |
10811 | ||
10812 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, | |
10813 | C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>, | |
10814 | C<vendorprefixexp>, C<version>, C<version_patchlevel_string>, | |
10815 | C<versiononly>, C<vi>, C<voidflags> | |
10816 | ||
10817 | =item x | |
10818 | ||
10819 | C<xlibpth>, C<xs_apiversion> | |
10820 | ||
10821 | =item y | |
10822 | ||
10823 | C<yacc>, C<yaccflags> | |
10824 | ||
10825 | =item z | |
10826 | ||
10827 | C<zcat>, C<zip> | |
10828 | ||
10829 | =back | |
10830 | ||
10831 | =item NOTE | |
10832 | ||
10833 | =back | |
10834 | ||
10835 | =head2 Cwd - get pathname of current working directory | |
10836 | ||
10837 | =over 4 | |
10838 | ||
10839 | =item SYNOPSIS | |
10840 | ||
10841 | =item DESCRIPTION | |
10842 | ||
10843 | =over 4 | |
10844 | ||
10845 | =item getcwd and friends | |
10846 | ||
10847 | getcwd, cwd, fastcwd, fastgetcwd | |
10848 | ||
10849 | =item abs_path and friends | |
10850 | ||
10851 | abs_path, realpath, fast_abs_path | |
10852 | ||
10853 | =item $ENV{PWD} | |
10854 | ||
10855 | =back | |
10856 | ||
10857 | =item NOTES | |
10858 | ||
10859 | =item SEE ALSO | |
10860 | ||
10861 | =back | |
10862 | ||
10863 | =head2 DB - programmatic interface to the Perl debugging API (draft, | |
10864 | subject to | |
10865 | change) | |
10866 | ||
10867 | =over 4 | |
10868 | ||
10869 | =item SYNOPSIS | |
10870 | ||
10871 | =item DESCRIPTION | |
10872 | ||
10873 | =over 4 | |
10874 | ||
10875 | =item Global Variables | |
10876 | ||
10877 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
10878 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
10879 | $DB::lineno | |
10880 | ||
10881 | =item API Methods | |
10882 | ||
10883 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
10884 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
10885 | ||
10886 | =item Client Callback Methods | |
10887 | ||
10888 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
10889 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
10890 | CLIENT->output(LIST) | |
10891 | ||
10892 | =back | |
10893 | ||
10894 | =item BUGS | |
10895 | ||
10896 | =item AUTHOR | |
10897 | ||
10898 | =back | |
10899 | ||
10900 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x | |
10901 | ||
10902 | =over 4 | |
10903 | ||
10904 | =item SYNOPSIS | |
10905 | ||
10906 | =item DESCRIPTION | |
10907 | ||
10908 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> | |
10909 | ||
10910 | =over 4 | |
10911 | ||
10912 | =item Using DB_File with Berkeley DB version 2 or greater | |
10913 | ||
10914 | =item Interface to Berkeley DB | |
10915 | ||
10916 | =item Opening a Berkeley DB Database File | |
10917 | ||
10918 | =item Default Parameters | |
10919 | ||
10920 | =item In Memory Databases | |
10921 | ||
10922 | =back | |
10923 | ||
10924 | =item DB_HASH | |
10925 | ||
10926 | =over 4 | |
10927 | ||
10928 | =item A Simple Example | |
10929 | ||
10930 | =back | |
10931 | ||
10932 | =item DB_BTREE | |
10933 | ||
10934 | =over 4 | |
10935 | ||
10936 | =item Changing the BTREE sort order | |
10937 | ||
10938 | =item Handling Duplicate Keys | |
10939 | ||
10940 | =item The get_dup() Method | |
10941 | ||
10942 | =item The find_dup() Method | |
10943 | ||
10944 | =item The del_dup() Method | |
10945 | ||
10946 | =item Matching Partial Keys | |
10947 | ||
10948 | =back | |
10949 | ||
10950 | =item DB_RECNO | |
10951 | ||
10952 | =over 4 | |
10953 | ||
10954 | =item The 'bval' Option | |
10955 | ||
10956 | =item A Simple Example | |
10957 | ||
10958 | =item Extra RECNO Methods | |
10959 | ||
10960 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, | |
10961 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, | |
10962 | length, elements);> | |
10963 | ||
10964 | =item Another Example | |
10965 | ||
10966 | =back | |
10967 | ||
10968 | =item THE API INTERFACE | |
10969 | ||
10970 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = | |
10971 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
10972 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
10973 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
10974 | ||
10975 | =item DBM FILTERS | |
10976 | ||
10977 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
10978 | B<filter_fetch_value> | |
10979 | ||
10980 | =over 4 | |
10981 | ||
10982 | =item The Filter | |
10983 | ||
10984 | =item An Example -- the NULL termination problem. | |
10985 | ||
10986 | =item Another Example -- Key is a C int. | |
10987 | ||
10988 | =back | |
10989 | ||
10990 | =item HINTS AND TIPS | |
10991 | ||
10992 | =over 4 | |
10993 | ||
10994 | =item Locking: The Trouble with fd | |
10995 | ||
10996 | =item Safe ways to lock a database | |
10997 | ||
10998 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
10999 | ||
11000 | =item Sharing Databases With C Applications | |
11001 | ||
11002 | =item The untie() Gotcha | |
11003 | ||
11004 | =back | |
11005 | ||
11006 | =item COMMON QUESTIONS | |
11007 | ||
11008 | =over 4 | |
11009 | ||
11010 | =item Why is there Perl source in my database? | |
11011 | ||
11012 | =item How do I store complex data structures with DB_File? | |
11013 | ||
11014 | =item What does "Invalid Argument" mean? | |
11015 | ||
11016 | =item What does "Bareword 'DB_File' not allowed" mean? | |
11017 | ||
11018 | =back | |
11019 | ||
11020 | =item REFERENCES | |
11021 | ||
11022 | =item HISTORY | |
11023 | ||
11024 | =item BUGS | |
11025 | ||
11026 | =item AVAILABILITY | |
11027 | ||
11028 | =item COPYRIGHT | |
11029 | ||
11030 | =item SEE ALSO | |
11031 | ||
11032 | =item AUTHOR | |
11033 | ||
11034 | =back | |
11035 | ||
11036 | =head2 Data::Dumper - stringified perl data structures, suitable for both | |
11037 | printing and C<eval> | |
11038 | ||
11039 | =over 4 | |
11040 | ||
11041 | =item SYNOPSIS | |
11042 | ||
11043 | =item DESCRIPTION | |
11044 | ||
11045 | =over 4 | |
11046 | ||
11047 | =item Methods | |
11048 | ||
11049 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> | |
11050 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), | |
11051 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
11052 | I<$OBJ>->Reset | |
11053 | ||
11054 | =item Functions | |
11055 | ||
11056 | Dumper(I<LIST>) | |
11057 | ||
11058 | =item Configuration Variables or Methods | |
11059 | ||
11060 | $Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>), | |
11061 | $Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>), | |
11062 | $Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>), | |
11063 | $Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>), | |
11064 | $Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>), | |
11065 | $Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>), | |
11066 | $Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>), | |
11067 | $Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>), | |
11068 | $Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>), | |
11069 | $Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>), | |
11070 | $Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>), | |
11071 | $Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>), | |
11072 | $Data::Dumper::Useperl I<or> $I<OBJ>->Useperl(I<[NEWVAL]>), | |
11073 | $Data::Dumper::Sortkeys I<or> $I<OBJ>->Sortkeys(I<[NEWVAL]>), | |
11074 | $Data::Dumper::Deparse I<or> $I<OBJ>->Deparse(I<[NEWVAL]>) | |
11075 | ||
11076 | =item Exports | |
11077 | ||
11078 | Dumper | |
11079 | ||
11080 | =back | |
11081 | ||
11082 | =item EXAMPLES | |
11083 | ||
11084 | =item BUGS | |
11085 | ||
11086 | =item AUTHOR | |
11087 | ||
11088 | =item VERSION | |
11089 | ||
11090 | =item SEE ALSO | |
11091 | ||
11092 | =back | |
11093 | ||
11094 | =head2 Devel::DProf - a Perl code profiler | |
11095 | ||
11096 | =over 4 | |
11097 | ||
11098 | =item SYNOPSIS | |
11099 | ||
11100 | =item DESCRIPTION | |
11101 | ||
11102 | =item PROFILE FORMAT | |
11103 | ||
11104 | =item AUTOLOAD | |
11105 | ||
11106 | =item ENVIRONMENT | |
11107 | ||
11108 | =item BUGS | |
11109 | ||
11110 | =item SEE ALSO | |
11111 | ||
11112 | =back | |
11113 | ||
11114 | =head2 Devel::PPPort, Perl/Pollution/Portability | |
11115 | ||
11116 | =over 4 | |
11117 | ||
11118 | =item SYNOPSIS | |
11119 | ||
11120 | =item DESCRIPTION | |
11121 | ||
11122 | =over 4 | |
11123 | ||
11124 | =item WriteFile | |
11125 | ||
11126 | =back | |
11127 | ||
11128 | =item ppport.h | |
11129 | ||
11130 | =item AUTHOR | |
11131 | ||
11132 | =item SEE ALSO | |
11133 | ||
11134 | =back | |
11135 | ||
11136 | =head2 Devel::Peek - A data debugging tool for the XS programmer | |
11137 | ||
11138 | =over 4 | |
11139 | ||
11140 | =item SYNOPSIS | |
11141 | ||
11142 | =item DESCRIPTION | |
11143 | ||
11144 | =over 4 | |
11145 | ||
11146 | =item Runtime debugging | |
11147 | ||
11148 | =item Memory footprint debugging | |
11149 | ||
11150 | =back | |
11151 | ||
11152 | =item EXAMPLES | |
11153 | ||
11154 | =over 4 | |
11155 | ||
11156 | =item A simple scalar string | |
11157 | ||
11158 | =item A simple scalar number | |
11159 | ||
11160 | =item A simple scalar with an extra reference | |
11161 | ||
11162 | =item A reference to a simple scalar | |
11163 | ||
11164 | =item A reference to an array | |
11165 | ||
11166 | =item A reference to a hash | |
11167 | ||
11168 | =item Dumping a large array or hash | |
11169 | ||
11170 | =item A reference to an SV which holds a C pointer | |
11171 | ||
11172 | =item A reference to a subroutine | |
11173 | ||
11174 | =back | |
11175 | ||
11176 | =item EXPORTS | |
11177 | ||
11178 | =item BUGS | |
11179 | ||
11180 | =item AUTHOR | |
11181 | ||
11182 | =item SEE ALSO | |
11183 | ||
11184 | =back | |
11185 | ||
11186 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module | |
11187 | ||
11188 | =over 4 | |
11189 | ||
11190 | =item SYNOPSIS | |
11191 | ||
11192 | =item DESCRIPTION | |
11193 | ||
11194 | =back | |
11195 | ||
11196 | =head2 Digest:: - Modules that calculate message digests | |
11197 | ||
11198 | =over 4 | |
11199 | ||
11200 | =item SYNOPSIS | |
11201 | ||
11202 | =item DESCRIPTION | |
11203 | ||
11204 | I<binary>, I<hex>, I<base64> | |
11205 | ||
11206 | =item OO INTERFACE | |
11207 | ||
11208 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = | |
11209 | Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), | |
11210 | $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest | |
11211 | ||
11212 | =item SEE ALSO | |
11213 | ||
11214 | =item AUTHOR | |
11215 | ||
11216 | =back | |
11217 | ||
11218 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm | |
11219 | ||
11220 | =over 4 | |
11221 | ||
11222 | =item SYNOPSIS | |
11223 | ||
11224 | =item DESCRIPTION | |
11225 | ||
11226 | =item FUNCTIONS | |
11227 | ||
11228 | md5($data,...), md5_hex($data,...), md5_base64($data,...) | |
11229 | ||
11230 | =item METHODS | |
11231 | ||
11232 | $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), | |
11233 | $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest | |
11234 | ||
11235 | =item EXAMPLES | |
11236 | ||
11237 | =item SEE ALSO | |
11238 | ||
11239 | =item COPYRIGHT | |
11240 | ||
11241 | =item AUTHORS | |
11242 | ||
11243 | =back | |
11244 | ||
11245 | =head2 DirHandle - supply object methods for directory handles | |
11246 | ||
11247 | =over 4 | |
11248 | ||
11249 | =item SYNOPSIS | |
11250 | ||
11251 | =item DESCRIPTION | |
11252 | ||
11253 | =item NOTES | |
11254 | ||
11255 | =back | |
11256 | ||
11257 | =head2 Dumpvalue - provides screen dump of Perl data. | |
11258 | ||
11259 | =over 4 | |
11260 | ||
11261 | =item SYNOPSIS | |
11262 | ||
11263 | =item DESCRIPTION | |
11264 | ||
11265 | =over 4 | |
11266 | ||
11267 | =item Creation | |
11268 | ||
11269 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
11270 | C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, | |
11271 | C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
11272 | stopDbSignal | |
11273 | ||
11274 | =item Methods | |
11275 | ||
11276 | dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, | |
11277 | compactDump, veryCompact, set, get | |
11278 | ||
11279 | =back | |
11280 | ||
11281 | =back | |
11282 | ||
11283 | =head2 DynaLoader - Dynamically load C libraries into Perl code | |
11284 | ||
11285 | =over 4 | |
11286 | ||
11287 | =item SYNOPSIS | |
11288 | ||
11289 | =item DESCRIPTION | |
11290 | ||
11291 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
11292 | @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), | |
11293 | dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(), | |
11294 | dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), | |
11295 | bootstrap() | |
11296 | ||
11297 | =item AUTHOR | |
11298 | ||
11299 | =back | |
11300 | ||
11301 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
11302 | Perl code | |
11303 | ||
11304 | =over 4 | |
11305 | ||
11306 | =item SYNOPSIS | |
11307 | ||
11308 | =item DESCRIPTION | |
11309 | ||
11310 | =item AUTHOR | |
11311 | ||
11312 | =back | |
11313 | ||
11314 | =head2 Encode - character encodings | |
11315 | ||
11316 | =over 4 | |
11317 | ||
11318 | =item SYNOPSIS | |
11319 | ||
11320 | =over 4 | |
11321 | ||
11322 | =item Table of Contents | |
11323 | ||
11324 | =back | |
11325 | ||
11326 | =item DESCRIPTION | |
11327 | ||
11328 | =over 4 | |
11329 | ||
11330 | =item TERMINOLOGY | |
11331 | ||
11332 | =back | |
11333 | ||
11334 | =item PERL ENCODING API | |
11335 | ||
11336 | $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, | |
11337 | $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, | |
11338 | CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, | |
11339 | CHECK]); | |
11340 | ||
11341 | =over 4 | |
11342 | ||
11343 | =item Listing available encodings | |
11344 | ||
11345 | =item Defining Aliases | |
11346 | ||
11347 | =back | |
11348 | ||
11349 | =item Encoding via PerlIO | |
11350 | ||
11351 | =item Handling Malformed Data | |
11352 | ||
11353 | I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), | |
11354 | I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode | |
11355 | (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = | |
11356 | Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The | |
11357 | bitmask | |
11358 | ||
11359 | =over 4 | |
11360 | ||
11361 | =item Unimplemented fallback schemes | |
11362 | ||
11363 | =back | |
11364 | ||
11365 | =item Defining Encodings | |
11366 | ||
11367 | =item The UTF-8 flag | |
11368 | ||
11369 | Goal #1:, Goal #2:, Goal #3:, Goal #4: | |
11370 | ||
11371 | =over 4 | |
11372 | ||
11373 | =item Messing with Perl's Internals | |
11374 | ||
11375 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) | |
11376 | ||
11377 | =back | |
11378 | ||
11379 | =item SEE ALSO | |
11380 | ||
11381 | =item MAINTAINER | |
11382 | ||
11383 | =back | |
11384 | ||
11385 | =head2 Encode::Alias - alias definitions to encodings | |
11386 | ||
11387 | =over 4 | |
11388 | ||
11389 | =item SYNOPSIS | |
11390 | ||
11391 | =item DESCRIPTION | |
11392 | ||
11393 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
11394 | reference, e.g.: | |
11395 | ||
11396 | =over 4 | |
11397 | ||
11398 | =item Alias overloading | |
11399 | ||
11400 | =back | |
11401 | ||
11402 | =item SEE ALSO | |
11403 | ||
11404 | =back | |
11405 | ||
11406 | =head2 Encode::Byte - Single Byte Encodings | |
11407 | ||
11408 | =over 4 | |
11409 | ||
11410 | =item SYNOPSIS | |
11411 | ||
11412 | =item ABSTRACT | |
11413 | ||
11414 | =item DESCRIPTION | |
11415 | ||
11416 | =item SEE ALSO | |
11417 | ||
11418 | =back | |
11419 | ||
11420 | =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* | |
11421 | ||
11422 | =head2 Encode::CN - China-based Chinese Encodings | |
11423 | ||
11424 | =over 4 | |
11425 | ||
11426 | =item SYNOPSIS | |
11427 | ||
11428 | =item DESCRIPTION | |
11429 | ||
11430 | =item NOTES | |
11431 | ||
11432 | =item BUGS | |
11433 | ||
11434 | =item SEE ALSO | |
11435 | ||
11436 | =back | |
11437 | ||
11438 | =head2 Encode::CN::HZ -- internally used by Encode::CN | |
11439 | ||
11440 | =head2 Encode::Config -- internally used by Encode | |
11441 | ||
11442 | =head2 Encode::EBCDIC - EBCDIC Encodings | |
11443 | ||
11444 | =over 4 | |
11445 | ||
11446 | =item SYNOPSIS | |
11447 | ||
11448 | =item ABSTRACT | |
11449 | ||
11450 | =item DESCRIPTION | |
11451 | ||
11452 | =item SEE ALSO | |
11453 | ||
11454 | =back | |
11455 | ||
11456 | =head2 Encode::Encoding - Encode Implementation Base Class | |
11457 | ||
11458 | =over 4 | |
11459 | ||
11460 | =item SYNOPSIS | |
11461 | ||
11462 | =item DESCRIPTION | |
11463 | ||
11464 | =over 4 | |
11465 | ||
11466 | =item Methods you should implement | |
11467 | ||
11468 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]) | |
11469 | ||
11470 | =item Other methods defined in Encode::Encodings | |
11471 | ||
11472 | -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines() | |
11473 | ||
11474 | =item Example: Encode::ROT13 | |
11475 | ||
11476 | =back | |
11477 | ||
11478 | =item Why the heck Encode API is different? | |
11479 | ||
11480 | =over 4 | |
11481 | ||
11482 | =item Compiled Encodings | |
11483 | ||
11484 | =back | |
11485 | ||
11486 | =item SEE ALSO | |
11487 | ||
11488 | Scheme 1, Scheme 2, Other Schemes | |
11489 | ||
11490 | =back | |
11491 | ||
11492 | =head2 Encode::Guess -- Guesses encoding from data | |
11493 | ||
11494 | =over 4 | |
11495 | ||
11496 | =item SYNOPSIS | |
11497 | ||
11498 | =item ABSTRACT | |
11499 | ||
11500 | =item DESCRIPTION | |
11501 | ||
11502 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
11503 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
11504 | guess_encoding($data, [, I<list of suspects>]) | |
11505 | ||
11506 | =item CAVEATS | |
11507 | ||
11508 | =item TO DO | |
11509 | ||
11510 | =item SEE ALSO | |
11511 | ||
11512 | =back | |
11513 | ||
11514 | =head2 Encode::JP - Japanese Encodings | |
11515 | ||
11516 | =over 4 | |
11517 | ||
11518 | =item SYNOPSIS | |
11519 | ||
11520 | =item ABSTRACT | |
11521 | ||
11522 | =item DESCRIPTION | |
11523 | ||
11524 | =item Note on ISO-2022-JP(-1)? | |
11525 | ||
11526 | =item BUGS | |
11527 | ||
11528 | =item SEE ALSO | |
11529 | ||
11530 | =back | |
11531 | ||
11532 | =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* | |
11533 | ||
11534 | =head2 Encode::JP::JIS7 -- internally used by Encode::JP | |
11535 | ||
11536 | =head2 Encode::KR - Korean Encodings | |
11537 | ||
11538 | =over 4 | |
11539 | ||
11540 | =item SYNOPSIS | |
11541 | ||
11542 | =item DESCRIPTION | |
11543 | ||
11544 | =item BUGS | |
11545 | ||
11546 | =item SEE ALSO | |
11547 | ||
11548 | =back | |
11549 | ||
11550 | =head2 Encode::KR::2022_KR -- internally used by Encode::KR | |
11551 | ||
11552 | =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding | |
11553 | ||
11554 | =over 4 | |
11555 | ||
11556 | =item SYNOPSIS | |
11557 | ||
11558 | =item ABSTRACT | |
11559 | ||
11560 | =item DESCRIPTION | |
11561 | ||
11562 | =item BUGS | |
11563 | ||
11564 | =item SEE ALSO | |
11565 | ||
11566 | =back | |
11567 | ||
11568 | =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO | |
11569 | ||
11570 | =over 4 | |
11571 | ||
11572 | =item Overview | |
11573 | ||
11574 | =item How does it work? | |
11575 | ||
11576 | =item BUGS | |
11577 | ||
11578 | =over 4 | |
11579 | ||
11580 | =item Workaround | |
11581 | ||
11582 | =item How can I tell whether my encoding fully supports PerlIO ? | |
11583 | ||
11584 | =back | |
11585 | ||
11586 | =item SEE ALSO | |
11587 | ||
11588 | =back | |
11589 | ||
11590 | =head2 Encode::Supported -- Encodings supported by Encode | |
11591 | ||
11592 | =over 4 | |
11593 | ||
11594 | =item DESCRIPTION | |
11595 | ||
11596 | =over 4 | |
11597 | ||
11598 | =item Encoding Names | |
11599 | ||
11600 | =back | |
11601 | ||
11602 | =item Supported Encodings | |
11603 | ||
11604 | =over 4 | |
11605 | ||
11606 | =item Built-in Encodings | |
11607 | ||
11608 | =item Encode::Unicode -- other Unicode encodings | |
11609 | ||
11610 | =item Encode::Byte -- Extended ASCII | |
11611 | ||
11612 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
11613 | the Cyrillic world, gsm0338 - Hentai Latin 1 | |
11614 | ||
11615 | =item CJK: Chinese, Japanese, Korean (Multibyte) | |
11616 | ||
11617 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
11618 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, | |
11619 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
11620 | ||
11621 | =item Miscellaneous encodings | |
11622 | ||
11623 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess | |
11624 | ||
11625 | =back | |
11626 | ||
11627 | =item Unsupported encodings | |
11628 | ||
11629 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, | |
11630 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
11631 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
11632 | Various Mac encodings, (Mac) Indic encodings | |
11633 | ||
11634 | =item Encoding vs. Charset -- terminology | |
11635 | ||
11636 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
11637 | ||
11638 | =over 4 | |
11639 | ||
11640 | =item Microsoft-related naming mess | |
11641 | ||
11642 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
11643 | ||
11644 | =back | |
11645 | ||
11646 | =item Glossary | |
11647 | ||
11648 | character repertoire, coded character set (CCS), character encoding scheme | |
11649 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, | |
11650 | UTF-16 | |
11651 | ||
11652 | =item See Also | |
11653 | ||
11654 | =item References | |
11655 | ||
11656 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, | |
11657 | RFC, UC, Unicode Glossary | |
11658 | ||
11659 | =over 4 | |
11660 | ||
11661 | =item Other Notable Sites | |
11662 | ||
11663 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: | |
11664 | "Introduction to i18n" | |
11665 | ||
11666 | =item Offline sources | |
11667 | ||
11668 | C<CJKV Information Processing> by Ken Lunde | |
11669 | ||
11670 | =back | |
11671 | ||
11672 | =back | |
11673 | ||
11674 | =head2 Encode::Symbol - Symbol Encodings | |
11675 | ||
11676 | =over 4 | |
11677 | ||
11678 | =item SYNOPSIS | |
11679 | ||
11680 | =item ABSTRACT | |
11681 | ||
11682 | =item DESCRIPTION | |
11683 | ||
11684 | =item SEE ALSO | |
11685 | ||
11686 | =back | |
11687 | ||
11688 | =head2 Encode::TW - Taiwan-based Chinese Encodings | |
11689 | ||
11690 | =over 4 | |
11691 | ||
11692 | =item SYNOPSIS | |
11693 | ||
11694 | =item DESCRIPTION | |
11695 | ||
11696 | =item NOTES | |
11697 | ||
11698 | =item BUGS | |
11699 | ||
11700 | =item SEE ALSO | |
11701 | ||
11702 | =back | |
11703 | ||
11704 | =head2 Encode::Unicode -- Various Unicode Transformation Formats | |
11705 | ||
11706 | =over 4 | |
11707 | ||
11708 | =item SYNOPSIS | |
11709 | ||
11710 | =item ABSTRACT | |
11711 | ||
11712 | L<http://www.unicode.org/glossary/> says:, Quick Reference | |
11713 | ||
11714 | =item Size, Endianness, and BOM | |
11715 | ||
11716 | =over 4 | |
11717 | ||
11718 | =item by size | |
11719 | ||
11720 | =item by endianness | |
11721 | ||
11722 | BOM as integer when fetched in network byte order | |
11723 | ||
11724 | =back | |
11725 | ||
11726 | =item Surrogate Pairs | |
11727 | ||
11728 | =item SEE ALSO | |
11729 | ||
11730 | =back | |
11731 | ||
11732 | =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to | |
11733 | encodings | |
11734 | ||
11735 | =over 4 | |
11736 | ||
11737 | =item SYNOPSIS | |
11738 | ||
11739 | =item DESCRIPTION | |
11740 | ||
11741 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
11742 | reference, e.g.: | |
11743 | ||
11744 | =over 4 | |
11745 | ||
11746 | =item Alias overloading | |
11747 | ||
11748 | =back | |
11749 | ||
11750 | =item SEE ALSO | |
11751 | ||
11752 | =back | |
11753 | ||
11754 | =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- | |
11755 | Internally used by Encode::??::ISO_2022_* | |
11756 | ||
11757 | =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by | |
11758 | Encode::CN | |
11759 | ||
11760 | =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by | |
11761 | Encode | |
11762 | ||
11763 | =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode | |
11764 | Implementation Base Class | |
11765 | ||
11766 | =over 4 | |
11767 | ||
11768 | =item SYNOPSIS | |
11769 | ||
11770 | =item DESCRIPTION | |
11771 | ||
11772 | =over 4 | |
11773 | ||
11774 | =item Methods you should implement | |
11775 | ||
11776 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]) | |
11777 | ||
11778 | =item Other methods defined in Encode::Encodings | |
11779 | ||
11780 | -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines() | |
11781 | ||
11782 | =item Example: Encode::ROT13 | |
11783 | ||
11784 | =back | |
11785 | ||
11786 | =item Why the heck Encode API is different? | |
11787 | ||
11788 | =over 4 | |
11789 | ||
11790 | =item Compiled Encodings | |
11791 | ||
11792 | =back | |
11793 | ||
11794 | =item SEE ALSO | |
11795 | ||
11796 | Scheme 1, Scheme 2, Other Schemes | |
11797 | ||
11798 | =back | |
11799 | ||
11800 | =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from | |
11801 | data | |
11802 | ||
11803 | =over 4 | |
11804 | ||
11805 | =item SYNOPSIS | |
11806 | ||
11807 | =item ABSTRACT | |
11808 | ||
11809 | =item DESCRIPTION | |
11810 | ||
11811 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
11812 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
11813 | guess_encoding($data, [, I<list of suspects>]) | |
11814 | ||
11815 | =item CAVEATS | |
11816 | ||
11817 | =item TO DO | |
11818 | ||
11819 | =item SEE ALSO | |
11820 | ||
11821 | =back | |
11822 | ||
11823 | =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by | |
11824 | Encode::JP::2022_JP* | |
11825 | ||
11826 | =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used | |
11827 | by Encode::JP | |
11828 | ||
11829 | =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally | |
11830 | used by Encode::KR | |
11831 | ||
11832 | =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' | |
11833 | and 'Q' header encoding | |
11834 | ||
11835 | =over 4 | |
11836 | ||
11837 | =item SYNOPSIS | |
11838 | ||
11839 | =item ABSTRACT | |
11840 | ||
11841 | =item DESCRIPTION | |
11842 | ||
11843 | =item BUGS | |
11844 | ||
11845 | =item SEE ALSO | |
11846 | ||
11847 | =back | |
11848 | ||
11849 | =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document | |
11850 | on Encode and PerlIO | |
11851 | ||
11852 | =over 4 | |
11853 | ||
11854 | =item Overview | |
11855 | ||
11856 | =item How does it work? | |
11857 | ||
11858 | =item BUGS | |
11859 | ||
11860 | =over 4 | |
11861 | ||
11862 | =item Workaround | |
11863 | ||
11864 | =item How can I tell whether my encoding fully supports PerlIO ? | |
11865 | ||
11866 | =back | |
11867 | ||
11868 | =item SEE ALSO | |
11869 | ||
11870 | =back | |
11871 | ||
11872 | =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings | |
11873 | supported by Encode | |
11874 | ||
11875 | =over 4 | |
11876 | ||
11877 | =item DESCRIPTION | |
11878 | ||
11879 | =over 4 | |
11880 | ||
11881 | =item Encoding Names | |
11882 | ||
11883 | =back | |
11884 | ||
11885 | =item Supported Encodings | |
11886 | ||
11887 | =over 4 | |
11888 | ||
11889 | =item Built-in Encodings | |
11890 | ||
11891 | =item Encode::Unicode -- other Unicode encodings | |
11892 | ||
11893 | =item Encode::Byte -- Extended ASCII | |
11894 | ||
11895 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
11896 | the Cyrillic world, gsm0338 - Hentai Latin 1 | |
11897 | ||
11898 | =item CJK: Chinese, Japanese, Korean (Multibyte) | |
11899 | ||
11900 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
11901 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, | |
11902 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
11903 | ||
11904 | =item Miscellaneous encodings | |
11905 | ||
11906 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess | |
11907 | ||
11908 | =back | |
11909 | ||
11910 | =item Unsupported encodings | |
11911 | ||
11912 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, | |
11913 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
11914 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
11915 | Various Mac encodings, (Mac) Indic encodings | |
11916 | ||
11917 | =item Encoding vs. Charset -- terminology | |
11918 | ||
11919 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
11920 | ||
11921 | =over 4 | |
11922 | ||
11923 | =item Microsoft-related naming mess | |
11924 | ||
11925 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
11926 | ||
11927 | =back | |
11928 | ||
11929 | =item Glossary | |
11930 | ||
11931 | character repertoire, coded character set (CCS), character encoding scheme | |
11932 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, | |
11933 | UTF-16 | |
11934 | ||
11935 | =item See Also | |
11936 | ||
11937 | =item References | |
11938 | ||
11939 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, | |
11940 | RFC, UC, Unicode Glossary | |
11941 | ||
11942 | =over 4 | |
11943 | ||
11944 | =item Other Notable Sites | |
11945 | ||
11946 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: | |
11947 | "Introduction to i18n" | |
11948 | ||
11949 | =item Offline sources | |
11950 | ||
11951 | C<CJKV Information Processing> by Ken Lunde | |
11952 | ||
11953 | =back | |
11954 | ||
11955 | =back | |
11956 | ||
11957 | =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder | |
11958 | ||
11959 | =over 4 | |
11960 | ||
11961 | =item SYNOPSIS | |
11962 | ||
11963 | use Encode::Encoder; | |
11964 | # Encode::encode("ISO-8859-1", $data); | |
11965 | Encode::Encoder->new($data)->iso_8859_1; # OOP way | |
11966 | # shortcut | |
11967 | use Encode::Encoder qw(encoder); | |
11968 | encoder($data)->iso_8859_1; | |
11969 | # you can stack them! | |
11970 | encoder($data)->iso_8859_1->base64; # provided base64() is defined | |
11971 | # you can use it as a decoder as well | |
11972 | encoder($base64)->bytes('base64')->latin1; | |
11973 | # stringified | |
11974 | print encoder($data)->utf8->latin1; # prints the string in latin1 | |
11975 | # numified | |
11976 | encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) | |
11977 | ||
11978 | =item ABSTRACT | |
11979 | ||
11980 | =item Description | |
11981 | ||
11982 | =over 4 | |
11983 | ||
11984 | =item Predefined Methods | |
11985 | ||
11986 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), | |
11987 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
11988 | $e-E<gt>bytes([$encoding]) | |
11989 | ||
11990 | =item Example: base64 transcoder | |
11991 | ||
11992 | =item Operator Overloading | |
11993 | ||
11994 | =back | |
11995 | ||
11996 | =item SEE ALSO | |
11997 | ||
11998 | =back | |
11999 | ||
12000 | =head2 Encodencoding, encoding - allows you to write your script in | |
12001 | non-ascii or non-utf8 | |
12002 | ||
12003 | =over 4 | |
12004 | ||
12005 | =item SYNOPSIS | |
12006 | ||
12007 | =item ABSTRACT | |
12008 | ||
12009 | =item USAGE | |
12010 | ||
12011 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> | |
12012 | I<ENCNAME_IN> ...] ;, no encoding; | |
12013 | ||
12014 | =item CAVEATS | |
12015 | ||
12016 | =over 4 | |
12017 | ||
12018 | =item NOT SCOPED | |
12019 | ||
12020 | =item DO NOT MIX MULTIPLE ENCODINGS | |
12021 | ||
12022 | =back | |
12023 | ||
12024 | =item Non-ASCII Identifiers and Filter option | |
12025 | ||
12026 | use encoding I<ENCNAME> Filter=E<gt>1; | |
12027 | ||
12028 | =item EXAMPLE - Greekperl | |
12029 | ||
12030 | =item KNOWN PROBLEMS | |
12031 | ||
12032 | =item SEE ALSO | |
12033 | ||
12034 | =back | |
12035 | ||
12036 | =head2 Encoder, Encode::Encoder -- Object Oriented Encoder | |
12037 | ||
12038 | =over 4 | |
12039 | ||
12040 | =item SYNOPSIS | |
12041 | ||
12042 | use Encode::Encoder; | |
12043 | # Encode::encode("ISO-8859-1", $data); | |
12044 | Encode::Encoder->new($data)->iso_8859_1; # OOP way | |
12045 | # shortcut | |
12046 | use Encode::Encoder qw(encoder); | |
12047 | encoder($data)->iso_8859_1; | |
12048 | # you can stack them! | |
12049 | encoder($data)->iso_8859_1->base64; # provided base64() is defined | |
12050 | # you can use it as a decoder as well | |
12051 | encoder($base64)->bytes('base64')->latin1; | |
12052 | # stringified | |
12053 | print encoder($data)->utf8->latin1; # prints the string in latin1 | |
12054 | # numified | |
12055 | encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) | |
12056 | ||
12057 | =item ABSTRACT | |
12058 | ||
12059 | =item Description | |
12060 | ||
12061 | =over 4 | |
12062 | ||
12063 | =item Predefined Methods | |
12064 | ||
12065 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), | |
12066 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
12067 | $e-E<gt>bytes([$encoding]) | |
12068 | ||
12069 | =item Example: base64 transcoder | |
12070 | ||
12071 | =item Operator Overloading | |
12072 | ||
12073 | =back | |
12074 | ||
12075 | =item SEE ALSO | |
12076 | ||
12077 | =back | |
12078 | ||
12079 | =head2 English - use nice English (or awk) names for ugly punctuation | |
12080 | variables | |
12081 | ||
12082 | =over 4 | |
12083 | ||
12084 | =item SYNOPSIS | |
12085 | ||
12086 | =item DESCRIPTION | |
12087 | ||
12088 | =item PERFORMANCE | |
12089 | ||
12090 | =back | |
12091 | ||
12092 | =head2 Env - perl module that imports environment variables as scalars or | |
12093 | arrays | |
12094 | ||
12095 | =over 4 | |
12096 | ||
12097 | =item SYNOPSIS | |
12098 | ||
12099 | =item DESCRIPTION | |
12100 | ||
12101 | =item LIMITATIONS | |
12102 | ||
12103 | =item AUTHOR | |
12104 | ||
12105 | =back | |
12106 | ||
12107 | =head2 Errno - System errno constants | |
12108 | ||
12109 | =over 4 | |
12110 | ||
12111 | =item SYNOPSIS | |
12112 | ||
12113 | =item DESCRIPTION | |
12114 | ||
12115 | =item CAVEATS | |
12116 | ||
12117 | =item AUTHOR | |
12118 | ||
12119 | =item COPYRIGHT | |
12120 | ||
12121 | =back | |
12122 | ||
12123 | =head2 Exporter - Implements default import method for modules | |
12124 | ||
12125 | =over 4 | |
12126 | ||
12127 | =item SYNOPSIS | |
12128 | ||
12129 | =item DESCRIPTION | |
12130 | ||
12131 | =over 4 | |
12132 | ||
12133 | =item How to Export | |
12134 | ||
12135 | =item Selecting What To Export | |
12136 | ||
12137 | =item How to Import | |
12138 | ||
12139 | C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> | |
12140 | ||
12141 | =back | |
12142 | ||
12143 | =item Advanced features | |
12144 | ||
12145 | =over 4 | |
12146 | ||
12147 | =item Specialised Import Lists | |
12148 | ||
12149 | =item Exporting without using Exporter's import method | |
12150 | ||
12151 | =item Module Version Checking | |
12152 | ||
12153 | =item Managing Unknown Symbols | |
12154 | ||
12155 | =item Tag Handling Utility Functions | |
12156 | ||
12157 | =item Generating combined tags | |
12158 | ||
12159 | =item C<AUTOLOAD>ed Constants | |
12160 | ||
12161 | =back | |
12162 | ||
12163 | =back | |
12164 | ||
12165 | =head2 Exporter::Heavy - Exporter guts | |
12166 | ||
12167 | =over 4 | |
12168 | ||
12169 | =item SYNOPSIS | |
12170 | ||
12171 | =item DESCRIPTION | |
12172 | ||
12173 | =back | |
12174 | ||
12175 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in | |
12176 | Makefiles etc. | |
12177 | ||
12178 | =over 4 | |
12179 | ||
12180 | =item SYNOPSIS | |
12181 | ||
12182 | =item DESCRIPTION | |
12183 | ||
12184 | =back | |
12185 | ||
12186 | cat | |
12187 | ||
12188 | eqtime src dst | |
12189 | ||
12190 | rm_rf files... | |
12191 | ||
12192 | rm_f files... | |
12193 | ||
12194 | touch files .. | |
12195 | ||
12196 | mv source... destination | |
12197 | ||
12198 | cp source... destination | |
12199 | ||
12200 | chmod mode files.. | |
12201 | ||
12202 | mkpath directory.. | |
12203 | ||
12204 | test_f file | |
12205 | ||
12206 | =over 4 | |
12207 | ||
12208 | =item BUGS | |
12209 | ||
12210 | =item SEE ALSO | |
12211 | ||
12212 | =item AUTHOR | |
12213 | ||
12214 | =back | |
12215 | ||
12216 | =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles | |
12217 | ||
12218 | =over 4 | |
12219 | ||
12220 | =item SYNOPSIS | |
12221 | ||
12222 | =item DESCRIPTION | |
12223 | ||
12224 | B<test_harness> | |
12225 | ||
12226 | =back | |
12227 | ||
12228 | =head2 ExtUtils::Constant - generate XS code to import C header constants | |
12229 | ||
12230 | =over 4 | |
12231 | ||
12232 | =item SYNOPSIS | |
12233 | ||
12234 | =item DESCRIPTION | |
12235 | ||
12236 | =item USAGE | |
12237 | ||
12238 | IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF | |
12239 | ||
12240 | =item FUNCTIONS | |
12241 | ||
12242 | =back | |
12243 | ||
12244 | C_stringify NAME | |
12245 | ||
12246 | perl_stringify NAME | |
12247 | ||
12248 | constant_types | |
12249 | ||
12250 | memEQ_clause NAME, CHECKED_AT, INDENT | |
12251 | ||
12252 | assign INDENT, TYPE, PRE, POST, VALUE.. | |
12253 | ||
12254 | return_clause | |
12255 | ||
12256 | switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. | |
12257 | ||
12258 | params WHAT | |
12259 | ||
12260 | dump_names | |
12261 | ||
12262 | dogfood | |
12263 | ||
12264 | C_constant, name, type, value, macro, default, pre, post, def_pre =item | |
12265 | def_post, utf8 | |
12266 | ||
12267 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME | |
12268 | ||
12269 | autoload PACKAGE, VERSION, AUTOLOADER | |
12270 | ||
12271 | WriteMakefileSnippet | |
12272 | ||
12273 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, | |
12274 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME | |
12275 | ||
12276 | =over 4 | |
12277 | ||
12278 | =item AUTHOR | |
12279 | ||
12280 | =back | |
12281 | ||
12282 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications | |
12283 | ||
12284 | =over 4 | |
12285 | ||
12286 | =item SYNOPSIS | |
12287 | ||
12288 | =item DESCRIPTION | |
12289 | ||
12290 | =item @EXPORT | |
12291 | ||
12292 | =item FUNCTIONS | |
12293 | ||
12294 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), | |
12295 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
12296 | ||
12297 | =item EXAMPLES | |
12298 | ||
12299 | =item SEE ALSO | |
12300 | ||
12301 | =item AUTHOR | |
12302 | ||
12303 | =back | |
12304 | ||
12305 | =head2 ExtUtils::Install - install files from here to there | |
12306 | ||
12307 | =over 4 | |
12308 | ||
12309 | =item SYNOPSIS | |
12310 | ||
12311 | =item DESCRIPTION | |
12312 | ||
12313 | =back | |
12314 | ||
12315 | =head2 ExtUtils::Installed - Inventory management of installed modules | |
12316 | ||
12317 | =over 4 | |
12318 | ||
12319 | =item SYNOPSIS | |
12320 | ||
12321 | =item DESCRIPTION | |
12322 | ||
12323 | =item USAGE | |
12324 | ||
12325 | =item FUNCTIONS | |
12326 | ||
12327 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
12328 | packlist(), version() | |
12329 | ||
12330 | =item EXAMPLE | |
12331 | ||
12332 | =item AUTHOR | |
12333 | ||
12334 | =back | |
12335 | ||
12336 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them | |
12337 | ||
12338 | =over 4 | |
12339 | ||
12340 | =item SYNOPSIS | |
12341 | ||
12342 | =item DESCRIPTION | |
12343 | ||
12344 | For static extensions, For dynamic extensions at build/link time, For | |
12345 | dynamic extensions at load time | |
12346 | ||
12347 | =over 4 | |
12348 | ||
12349 | =item EXTRALIBS | |
12350 | ||
12351 | =item LDLOADLIBS and LD_RUN_PATH | |
12352 | ||
12353 | =item BSLOADLIBS | |
12354 | ||
12355 | =back | |
12356 | ||
12357 | =item PORTABILITY | |
12358 | ||
12359 | =over 4 | |
12360 | ||
12361 | =item VMS implementation | |
12362 | ||
12363 | =item Win32 implementation | |
12364 | ||
12365 | =back | |
12366 | ||
12367 | =item SEE ALSO | |
12368 | ||
12369 | =back | |
12370 | ||
12371 | =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass | |
12372 | ||
12373 | =over 4 | |
12374 | ||
12375 | =item SYNOPSIS | |
12376 | ||
12377 | =item DESCRIPTION | |
12378 | ||
12379 | =back | |
12380 | ||
12381 | =head2 ExtUtils::MM_Any - Platform agnostic MM methods | |
12382 | ||
12383 | =over 4 | |
12384 | ||
12385 | =item SYNOPSIS | |
12386 | ||
12387 | =item DESCRIPTION | |
12388 | ||
12389 | =item Inherently Cross-Platform Methods | |
12390 | ||
12391 | =over 4 | |
12392 | ||
12393 | =item File::Spec wrappers B<DEPRECATED> | |
12394 | ||
12395 | canonpath | |
12396 | ||
12397 | =back | |
12398 | ||
12399 | =back | |
12400 | ||
12401 | catdir | |
12402 | ||
12403 | catfile | |
12404 | ||
12405 | curdir | |
12406 | ||
12407 | file_name_is_absolute | |
12408 | ||
12409 | path | |
12410 | ||
12411 | rootdir | |
12412 | ||
12413 | updir | |
12414 | ||
12415 | =over 4 | |
12416 | ||
12417 | =item Thought To Be Cross-Platform Methods | |
12418 | ||
12419 | test_via_harness | |
12420 | ||
12421 | =back | |
12422 | ||
12423 | test_via_script | |
12424 | ||
12425 | =over 4 | |
12426 | ||
12427 | =item AUTHOR | |
12428 | ||
12429 | =back | |
12430 | ||
12431 | =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in | |
12432 | ExtUtils::MakeMaker | |
12433 | ||
12434 | =over 4 | |
12435 | ||
12436 | =item SYNOPSIS | |
12437 | ||
12438 | =item DESCRIPTION | |
12439 | ||
12440 | =back | |
12441 | ||
12442 | perl_archive | |
12443 | ||
12444 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in | |
12445 | ExtUtils::MakeMaker | |
12446 | ||
12447 | =over 4 | |
12448 | ||
12449 | =item SYNOPSIS | |
12450 | ||
12451 | =item DESCRIPTION | |
12452 | ||
12453 | canonpath, cflags, manifypods, perl_archive | |
12454 | ||
12455 | =back | |
12456 | ||
12457 | =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix | |
12458 | ||
12459 | =over 4 | |
12460 | ||
12461 | =item SYNOPSIS | |
12462 | ||
12463 | =item DESCRIPTION | |
12464 | ||
12465 | =over 4 | |
12466 | ||
12467 | =item Overridden methods | |
12468 | ||
12469 | B<replace_manpage_separator> | |
12470 | ||
12471 | =back | |
12472 | ||
12473 | =back | |
12474 | ||
12475 | =over 4 | |
12476 | ||
12477 | =item AUTHOR | |
12478 | ||
12479 | =item SEE ALSO | |
12480 | ||
12481 | =back | |
12482 | ||
12483 | =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in | |
12484 | ExtUtils::MakeMaker | |
12485 | ||
12486 | =over 4 | |
12487 | ||
12488 | =item SYNOPSIS | |
12489 | ||
12490 | =item DESCRIPTION | |
12491 | ||
12492 | =back | |
12493 | ||
12494 | maybe_command | |
12495 | ||
12496 | guess_name | |
12497 | ||
12498 | macify | |
12499 | ||
12500 | patternify | |
12501 | ||
12502 | init_main | |
12503 | ||
12504 | init_others | |
12505 | ||
12506 | init_dirscan | |
12507 | ||
12508 | libscan (o) | |
12509 | ||
12510 | constants (o) | |
12511 | ||
12512 | static (o) | |
12513 | ||
12514 | dlsyms (o) | |
12515 | ||
12516 | dynamic (o) | |
12517 | ||
12518 | clean (o) | |
12519 | ||
12520 | realclean (o) | |
12521 | ||
12522 | rulez (o) | |
12523 | ||
12524 | processPL (o) | |
12525 | ||
12526 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in | |
12527 | ExtUtils::MakeMaker | |
12528 | ||
12529 | =over 4 | |
12530 | ||
12531 | =item SYNOPSIS | |
12532 | ||
12533 | =item DESCRIPTION | |
12534 | ||
12535 | =back | |
12536 | ||
12537 | constants (o) | |
12538 | ||
12539 | static_lib (o) | |
12540 | ||
12541 | dynamic_lib (o) | |
12542 | ||
12543 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in | |
12544 | ExtUtils::MakeMaker | |
12545 | ||
12546 | =over 4 | |
12547 | ||
12548 | =item SYNOPSIS | |
12549 | ||
12550 | =item DESCRIPTION | |
12551 | ||
12552 | =item METHODS | |
12553 | ||
12554 | =back | |
12555 | ||
12556 | perl_archive_after | |
12557 | ||
12558 | =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix | |
12559 | ||
12560 | =over 4 | |
12561 | ||
12562 | =item SYNOPSIS | |
12563 | ||
12564 | =item DESCRIPTION | |
12565 | ||
12566 | =over 4 | |
12567 | ||
12568 | =item Overridden methods | |
12569 | ||
12570 | B<replace_manpage_separator> | |
12571 | ||
12572 | =back | |
12573 | ||
12574 | =back | |
12575 | ||
12576 | =over 4 | |
12577 | ||
12578 | =item AUTHOR | |
12579 | ||
12580 | =item SEE ALSO | |
12581 | ||
12582 | =back | |
12583 | ||
12584 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker | |
12585 | ||
12586 | =over 4 | |
12587 | ||
12588 | =item SYNOPSIS | |
12589 | ||
12590 | =item DESCRIPTION | |
12591 | ||
12592 | =item METHODS | |
12593 | ||
12594 | =back | |
12595 | ||
12596 | =over 4 | |
12597 | ||
12598 | =item SelfLoaded methods | |
12599 | ||
12600 | c_o (o) | |
12601 | ||
12602 | =back | |
12603 | ||
12604 | cflags (o) | |
12605 | ||
12606 | clean (o) | |
12607 | ||
12608 | const_cccmd (o) | |
12609 | ||
12610 | const_config (o) | |
12611 | ||
12612 | const_loadlibs (o) | |
12613 | ||
12614 | constants (o) | |
12615 | ||
12616 | depend (o) | |
12617 | ||
12618 | dir_target (o) | |
12619 | ||
12620 | dist (o) | |
12621 | ||
12622 | dist_basics (o) | |
12623 | ||
12624 | dist_ci (o) | |
12625 | ||
12626 | dist_core (o) | |
12627 | ||
12628 | dist_dir | |
12629 | ||
12630 | dist_test | |
12631 | ||
12632 | dlsyms (o) | |
12633 | ||
12634 | dynamic (o) | |
12635 | ||
12636 | dynamic_bs (o) | |
12637 | ||
12638 | dynamic_lib (o) | |
12639 | ||
12640 | exescan | |
12641 | ||
12642 | extliblist | |
12643 | ||
12644 | find_perl | |
12645 | ||
12646 | find_tests | |
12647 | ||
12648 | =over 4 | |
12649 | ||
12650 | =item Methods to actually produce chunks of text for the Makefile | |
12651 | ||
12652 | fixin | |
12653 | ||
12654 | =back | |
12655 | ||
12656 | force (o) | |
12657 | ||
12658 | guess_name | |
12659 | ||
12660 | has_link_code | |
12661 | ||
12662 | init_dirscan | |
12663 | ||
12664 | init_main | |
12665 | ||
12666 | init_others | |
12667 | ||
12668 | init_INST | |
12669 | ||
12670 | init_INSTALL | |
12671 | ||
12672 | init_lib2arch | |
12673 | ||
12674 | init_PERL | |
12675 | ||
12676 | init_PERM | |
12677 | ||
12678 | install (o) | |
12679 | ||
12680 | installbin (o) | |
12681 | ||
12682 | libscan (o) | |
12683 | ||
12684 | linkext (o) | |
12685 | ||
12686 | lsdir | |
12687 | ||
12688 | macro (o) | |
12689 | ||
12690 | makeaperl (o) | |
12691 | ||
12692 | makefile (o) | |
12693 | ||
12694 | manifypods (o) | |
12695 | ||
12696 | maybe_command | |
12697 | ||
12698 | maybe_command_in_dirs | |
12699 | ||
12700 | needs_linking (o) | |
12701 | ||
12702 | nicetext | |
12703 | ||
12704 | parse_abstract | |
12705 | ||
12706 | parse_version | |
12707 | ||
12708 | pasthru (o) | |
12709 | ||
12710 | perl_script | |
12711 | ||
12712 | perldepend (o) | |
12713 | ||
12714 | perm_rw (o) | |
12715 | ||
12716 | perm_rwx (o) | |
12717 | ||
12718 | pm_to_blib | |
12719 | ||
12720 | post_constants (o) | |
12721 | ||
12722 | post_initialize (o) | |
12723 | ||
12724 | postamble (o) | |
12725 | ||
12726 | ppd | |
12727 | ||
12728 | prefixify | |
12729 | ||
12730 | processPL (o) | |
12731 | ||
12732 | quote_paren | |
12733 | ||
12734 | realclean (o) | |
12735 | ||
12736 | replace_manpage_separator | |
12737 | ||
12738 | static (o) | |
12739 | ||
12740 | static_lib (o) | |
12741 | ||
12742 | staticmake (o) | |
12743 | ||
12744 | subdir_x (o) | |
12745 | ||
12746 | subdirs (o) | |
12747 | ||
12748 | test (o) | |
12749 | ||
12750 | test_via_harness (override) | |
12751 | ||
12752 | test_via_script (override) | |
12753 | ||
12754 | tool_autosplit (o) | |
12755 | ||
12756 | tools_other (o) | |
12757 | ||
12758 | tool_xsubpp (o) | |
12759 | ||
12760 | top_targets (o) | |
12761 | ||
12762 | writedoc | |
12763 | ||
12764 | xs_c (o) | |
12765 | ||
12766 | xs_cpp (o) | |
12767 | ||
12768 | xs_o (o) | |
12769 | ||
12770 | perl_archive | |
12771 | ||
12772 | perl_archive_after | |
12773 | ||
12774 | export_list | |
12775 | ||
12776 | =over 4 | |
12777 | ||
12778 | =item SEE ALSO | |
12779 | ||
12780 | =back | |
12781 | ||
12782 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
12783 | ExtUtils::MakeMaker | |
12784 | ||
12785 | =over 4 | |
12786 | ||
12787 | =item SYNOPSIS | |
12788 | ||
12789 | =item DESCRIPTION | |
12790 | ||
12791 | =over 4 | |
12792 | ||
12793 | =item Methods always loaded | |
12794 | ||
12795 | wraplist | |
12796 | ||
12797 | =back | |
12798 | ||
12799 | =back | |
12800 | ||
12801 | =over 4 | |
12802 | ||
12803 | =item Methods | |
12804 | ||
12805 | guess_name (override) | |
12806 | ||
12807 | =back | |
12808 | ||
12809 | find_perl (override) | |
12810 | ||
12811 | maybe_command (override) | |
12812 | ||
12813 | maybe_command_in_dirs (override) | |
12814 | ||
12815 | perl_script (override) | |
12816 | ||
12817 | replace_manpage_separator | |
12818 | ||
12819 | init_main (override) | |
12820 | ||
12821 | init_others (override) | |
12822 | ||
12823 | constants (override) | |
12824 | ||
12825 | cflags (override) | |
12826 | ||
12827 | const_cccmd (override) | |
12828 | ||
12829 | pm_to_blib (override) | |
12830 | ||
12831 | tool_autosplit (override) | |
12832 | ||
12833 | tool_sxubpp (override) | |
12834 | ||
12835 | xsubpp_version (override) | |
12836 | ||
12837 | tools_other (override) | |
12838 | ||
12839 | dist (override) | |
12840 | ||
12841 | c_o (override) | |
12842 | ||
12843 | xs_c (override) | |
12844 | ||
12845 | xs_o (override) | |
12846 | ||
12847 | top_targets (override) | |
12848 | ||
12849 | dlsyms (override) | |
12850 | ||
12851 | dynamic_lib (override) | |
12852 | ||
12853 | dynamic_bs (override) | |
12854 | ||
12855 | static_lib (override) | |
12856 | ||
12857 | manifypods (override) | |
12858 | ||
12859 | processPL (override) | |
12860 | ||
12861 | installbin (override) | |
12862 | ||
12863 | subdir_x (override) | |
12864 | ||
12865 | clean (override) | |
12866 | ||
12867 | realclean (override) | |
12868 | ||
12869 | dist_core (override) | |
12870 | ||
12871 | dist_test (override) | |
12872 | ||
12873 | install (override) | |
12874 | ||
12875 | perldepend (override) | |
12876 | ||
12877 | makefile (override) | |
12878 | ||
12879 | find_tests (override) | |
12880 | ||
12881 | test (override) | |
12882 | ||
12883 | makeaperl (override) | |
12884 | ||
12885 | nicetext (override) | |
12886 | ||
12887 | prefixify (override) | |
12888 | ||
12889 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in | |
12890 | ExtUtils::MakeMaker | |
12891 | ||
12892 | =over 4 | |
12893 | ||
12894 | =item SYNOPSIS | |
12895 | ||
12896 | =item DESCRIPTION | |
12897 | ||
12898 | =back | |
12899 | ||
12900 | constants (o) | |
12901 | ||
12902 | static_lib (o) | |
12903 | ||
12904 | dynamic_bs (o) | |
12905 | ||
12906 | dynamic_lib (o) | |
12907 | ||
12908 | perl_script | |
12909 | ||
12910 | pm_to_blib | |
12911 | ||
12912 | tool_autosplit (override) | |
12913 | ||
12914 | tools_other (o) | |
12915 | ||
12916 | xs_o (o) | |
12917 | ||
12918 | top_targets (o) | |
12919 | ||
12920 | manifypods (o) | |
12921 | ||
12922 | dist_ci (o) | |
12923 | ||
12924 | dist_core (o) | |
12925 | ||
12926 | pasthru (o) | |
12927 | ||
12928 | =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X | |
12929 | ||
12930 | =over 4 | |
12931 | ||
12932 | =item SYNOPSIS | |
12933 | ||
12934 | =item DESCRIPTION | |
12935 | ||
12936 | =back | |
12937 | ||
12938 | =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization | |
12939 | ||
12940 | =over 4 | |
12941 | ||
12942 | =item SYNOPSIS | |
12943 | ||
12944 | =item DESCRIPTION | |
12945 | ||
12946 | =back | |
12947 | ||
12948 | =head2 ExtUtils::MakeMaker - create an extension Makefile | |
12949 | ||
12950 | =over 4 | |
12951 | ||
12952 | =item SYNOPSIS | |
12953 | ||
12954 | =item DESCRIPTION | |
12955 | ||
12956 | =over 4 | |
12957 | ||
12958 | =item How To Write A Makefile.PL | |
12959 | ||
12960 | =item Default Makefile Behaviour | |
12961 | ||
12962 | =item make test | |
12963 | ||
12964 | =item make testdb | |
12965 | ||
12966 | =item make install | |
12967 | ||
12968 | =item PREFIX and LIB attribute | |
12969 | ||
12970 | =item AFS users | |
12971 | ||
12972 | =item Static Linking of a new Perl Binary | |
12973 | ||
12974 | =item Determination of Perl Library and Installation Locations | |
12975 | ||
12976 | =item Which architecture dependent directory? | |
12977 | ||
12978 | =item Using Attributes and Parameters | |
12979 | ||
12980 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, | |
12981 | CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, | |
12982 | EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST, | |
12983 | FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, | |
12984 | INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, | |
12985 | INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR, | |
12986 | INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, | |
12987 | INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, | |
12988 | INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB, | |
12989 | LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, | |
12990 | MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, | |
12991 | OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, | |
12992 | PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, | |
12993 | PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, | |
12994 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, | |
12995 | PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, | |
12996 | VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION | |
12997 | ||
12998 | =item Additional lowercase attributes | |
12999 | ||
13000 | clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, | |
13001 | tool_autosplit | |
13002 | ||
13003 | =item Overriding MakeMaker Methods | |
13004 | ||
13005 | =item The End Of Cargo Cult Programming | |
13006 | ||
13007 | C<<MAN3PODS => ' '>> | |
13008 | ||
13009 | =item Hintsfile support | |
13010 | ||
13011 | =item Distribution Support | |
13012 | ||
13013 | make distcheck, make skipcheck, make distclean, make manifest, | |
13014 | make distdir, make disttest, make tardist, make dist, make | |
13015 | uutardist, make shdist, make zipdist, make ci | |
13016 | ||
13017 | =item Disabling an extension | |
13018 | ||
13019 | =back | |
13020 | ||
13021 | =item ENVIRONMENT | |
13022 | ||
13023 | PERL_MM_OPT, PERL_MM_USE_DEFAULT | |
13024 | ||
13025 | =item SEE ALSO | |
13026 | ||
13027 | =item AUTHORS | |
13028 | ||
13029 | =back | |
13030 | ||
13031 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file | |
13032 | ||
13033 | =over 4 | |
13034 | ||
13035 | =item SYNOPSIS | |
13036 | ||
13037 | =item DESCRIPTION | |
13038 | ||
13039 | =item MANIFEST.SKIP | |
13040 | ||
13041 | =item EXPORT_OK | |
13042 | ||
13043 | =item GLOBAL VARIABLES | |
13044 | ||
13045 | =item DIAGNOSTICS | |
13046 | ||
13047 | C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, | |
13048 | C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> | |
13049 | ||
13050 | =item ENVIRONMENT | |
13051 | ||
13052 | B<PERL_MM_MANIFEST_DEBUG> | |
13053 | ||
13054 | =item SEE ALSO | |
13055 | ||
13056 | =item AUTHOR | |
13057 | ||
13058 | =back | |
13059 | ||
13060 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c | |
13061 | ||
13062 | =over 4 | |
13063 | ||
13064 | =item SYNOPSIS | |
13065 | ||
13066 | =item DESCRIPTION | |
13067 | ||
13068 | =item SEE ALSO | |
13069 | ||
13070 | =back | |
13071 | ||
13072 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader | |
13073 | ||
13074 | =over 4 | |
13075 | ||
13076 | =item SYNOPSIS | |
13077 | ||
13078 | =item DESCRIPTION | |
13079 | ||
13080 | =back | |
13081 | ||
13082 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
13083 | extension | |
13084 | ||
13085 | =over 4 | |
13086 | ||
13087 | =item SYNOPSIS | |
13088 | ||
13089 | =item DESCRIPTION | |
13090 | ||
13091 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
13092 | ||
13093 | =item AUTHOR | |
13094 | ||
13095 | =item REVISION | |
13096 | ||
13097 | =back | |
13098 | ||
13099 | =head2 ExtUtils::Packlist - manage .packlist files | |
13100 | ||
13101 | =over 4 | |
13102 | ||
13103 | =item SYNOPSIS | |
13104 | ||
13105 | =item DESCRIPTION | |
13106 | ||
13107 | =item USAGE | |
13108 | ||
13109 | =item FUNCTIONS | |
13110 | ||
13111 | new(), read(), write(), validate(), packlist_file() | |
13112 | ||
13113 | =item EXAMPLE | |
13114 | ||
13115 | =item AUTHOR | |
13116 | ||
13117 | =back | |
13118 | ||
13119 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
13120 | ||
13121 | =over 4 | |
13122 | ||
13123 | =item SYNOPSIS | |
13124 | ||
13125 | =item DESCRIPTION | |
13126 | ||
13127 | =back | |
13128 | ||
13129 | =head2 Fatal - replace functions with equivalents which succeed or die | |
13130 | ||
13131 | =over 4 | |
13132 | ||
13133 | =item SYNOPSIS | |
13134 | ||
13135 | =item DESCRIPTION | |
13136 | ||
13137 | =item AUTHOR | |
13138 | ||
13139 | =back | |
13140 | ||
13141 | =head2 Fcntl - load the C Fcntl.h defines | |
13142 | ||
13143 | =over 4 | |
13144 | ||
13145 | =item SYNOPSIS | |
13146 | ||
13147 | =item DESCRIPTION | |
13148 | ||
13149 | =item NOTE | |
13150 | ||
13151 | =item EXPORTED SYMBOLS | |
13152 | ||
13153 | =back | |
13154 | ||
13155 | =head2 File::Basename, fileparse - split a pathname into pieces | |
13156 | ||
13157 | =over 4 | |
13158 | ||
13159 | =item SYNOPSIS | |
13160 | ||
13161 | =item DESCRIPTION | |
13162 | ||
13163 | fileparse_set_fstype, fileparse | |
13164 | ||
13165 | =item EXAMPLES | |
13166 | ||
13167 | C<basename>, C<dirname> | |
13168 | ||
13169 | =back | |
13170 | ||
13171 | =head2 File::CheckTree, validate - run many filetest checks on a tree | |
13172 | ||
13173 | =over 4 | |
13174 | ||
13175 | =item SYNOPSIS | |
13176 | ||
13177 | =item DESCRIPTION | |
13178 | ||
13179 | =item AUTHOR | |
13180 | ||
13181 | =item HISTORY | |
13182 | ||
13183 | =back | |
13184 | ||
13185 | =head2 File::Compare - Compare files or filehandles | |
13186 | ||
13187 | =over 4 | |
13188 | ||
13189 | =item SYNOPSIS | |
13190 | ||
13191 | =item DESCRIPTION | |
13192 | ||
13193 | =item RETURN | |
13194 | ||
13195 | =item AUTHOR | |
13196 | ||
13197 | =back | |
13198 | ||
13199 | =head2 File::Copy - Copy files or filehandles | |
13200 | ||
13201 | =over 4 | |
13202 | ||
13203 | =item SYNOPSIS | |
13204 | ||
13205 | =item DESCRIPTION | |
13206 | ||
13207 | =over 4 | |
13208 | ||
13209 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) | |
13210 | ||
13211 | rmscopy($from,$to[,$date_flag]) | |
13212 | ||
13213 | =back | |
13214 | ||
13215 | =item RETURN | |
13216 | ||
13217 | =item NOTES | |
13218 | ||
13219 | =item AUTHOR | |
13220 | ||
13221 | =back | |
13222 | ||
13223 | =head2 File::DosGlob - DOS like globbing and then some | |
13224 | ||
13225 | =over 4 | |
13226 | ||
13227 | =item SYNOPSIS | |
13228 | ||
13229 | =item DESCRIPTION | |
13230 | ||
13231 | =item NOTES | |
13232 | ||
13233 | =item EXPORTS (by request only) | |
13234 | ||
13235 | =item BUGS | |
13236 | ||
13237 | =item AUTHOR | |
13238 | ||
13239 | =item HISTORY | |
13240 | ||
13241 | =item SEE ALSO | |
13242 | ||
13243 | =back | |
13244 | ||
13245 | =head2 File::Find - Traverse a directory tree. | |
13246 | ||
13247 | =over 4 | |
13248 | ||
13249 | =item SYNOPSIS | |
13250 | ||
13251 | =item DESCRIPTION | |
13252 | ||
13253 | B<find>, B<finddepth> | |
13254 | ||
13255 | =over 4 | |
13256 | ||
13257 | =item %options | |
13258 | ||
13259 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, | |
13260 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, | |
13261 | C<untaint>, C<untaint_pattern>, C<untaint_skip> | |
13262 | ||
13263 | =item The wanted function | |
13264 | ||
13265 | C<$File::Find::dir> is the current directory name,, C<$_> is the current | |
13266 | filename within that directory, C<$File::Find::name> is the complete | |
13267 | pathname to the file | |
13268 | ||
13269 | =back | |
13270 | ||
13271 | =item WARNINGS | |
13272 | ||
13273 | =item CAVEAT | |
13274 | ||
13275 | $dont_use_nlink, symlinks | |
13276 | ||
13277 | =item NOTES | |
13278 | ||
13279 | =item HISTORY | |
13280 | ||
13281 | =back | |
13282 | ||
13283 | =head2 File::Glob - Perl extension for BSD glob routine | |
13284 | ||
13285 | =over 4 | |
13286 | ||
13287 | =item SYNOPSIS | |
13288 | ||
13289 | =item DESCRIPTION | |
13290 | ||
13291 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, | |
13292 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, | |
13293 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> | |
13294 | ||
13295 | =item DIAGNOSTICS | |
13296 | ||
13297 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
13298 | ||
13299 | =item NOTES | |
13300 | ||
13301 | =item AUTHOR | |
13302 | ||
13303 | =back | |
13304 | ||
13305 | =head2 File::Path - create or remove directory trees | |
13306 | ||
13307 | =over 4 | |
13308 | ||
13309 | =item SYNOPSIS | |
13310 | ||
13311 | =item DESCRIPTION | |
13312 | ||
13313 | =item AUTHORS | |
13314 | ||
13315 | =back | |
13316 | ||
13317 | =head2 File::Spec - portably perform operations on file names | |
13318 | ||
13319 | =over 4 | |
13320 | ||
13321 | =item SYNOPSIS | |
13322 | ||
13323 | =item DESCRIPTION | |
13324 | ||
13325 | =item METHODS | |
13326 | ||
13327 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, | |
13328 | no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, | |
13329 | splitdir, catpath(), abs2rel, rel2abs() | |
13330 | ||
13331 | =item SEE ALSO | |
13332 | ||
13333 | =item AUTHORS | |
13334 | ||
13335 | =back | |
13336 | ||
13337 | =head2 File::Spec::Cygwin - methods for Cygwin file specs | |
13338 | ||
13339 | =over 4 | |
13340 | ||
13341 | =item SYNOPSIS | |
13342 | ||
13343 | =item DESCRIPTION | |
13344 | ||
13345 | =back | |
13346 | ||
13347 | =head2 File::Spec::Epoc - methods for Epoc file specs | |
13348 | ||
13349 | =over 4 | |
13350 | ||
13351 | =item SYNOPSIS | |
13352 | ||
13353 | =item DESCRIPTION | |
13354 | ||
13355 | canonpath() | |
13356 | ||
13357 | =back | |
13358 | ||
13359 | =over 4 | |
13360 | ||
13361 | =item SEE ALSO | |
13362 | ||
13363 | =back | |
13364 | ||
13365 | =head2 File::Spec::Functions - portably perform operations on file names | |
13366 | ||
13367 | =over 4 | |
13368 | ||
13369 | =item SYNOPSIS | |
13370 | ||
13371 | =item DESCRIPTION | |
13372 | ||
13373 | =over 4 | |
13374 | ||
13375 | =item Exports | |
13376 | ||
13377 | =back | |
13378 | ||
13379 | =item SEE ALSO | |
13380 | ||
13381 | =back | |
13382 | ||
13383 | =head2 File::Spec::Mac - File::Spec for Mac OS (Classic) | |
13384 | ||
13385 | =over 4 | |
13386 | ||
13387 | =item SYNOPSIS | |
13388 | ||
13389 | =item DESCRIPTION | |
13390 | ||
13391 | =item METHODS | |
13392 | ||
13393 | canonpath | |
13394 | ||
13395 | =back | |
13396 | ||
13397 | catdir() | |
13398 | ||
13399 | catfile | |
13400 | ||
13401 | curdir | |
13402 | ||
13403 | devnull | |
13404 | ||
13405 | rootdir | |
13406 | ||
13407 | tmpdir | |
13408 | ||
13409 | updir | |
13410 | ||
13411 | file_name_is_absolute | |
13412 | ||
13413 | path | |
13414 | ||
13415 | splitpath | |
13416 | ||
13417 | splitdir | |
13418 | ||
13419 | catpath | |
13420 | ||
13421 | abs2rel | |
13422 | ||
13423 | rel2abs | |
13424 | ||
13425 | =over 4 | |
13426 | ||
13427 | =item AUTHORS | |
13428 | ||
13429 | =item SEE ALSO | |
13430 | ||
13431 | =back | |
13432 | ||
13433 | canonpath | |
13434 | ||
13435 | splitpath | |
13436 | ||
13437 | splitdir | |
13438 | ||
13439 | catpath | |
13440 | ||
13441 | =head2 File::Spec::OS2 - methods for OS/2 file specs | |
13442 | ||
13443 | =over 4 | |
13444 | ||
13445 | =item SYNOPSIS | |
13446 | ||
13447 | =item DESCRIPTION | |
13448 | ||
13449 | =back | |
13450 | ||
13451 | =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec | |
13452 | modules | |
13453 | ||
13454 | =over 4 | |
13455 | ||
13456 | =item SYNOPSIS | |
13457 | ||
13458 | =item DESCRIPTION | |
13459 | ||
13460 | =item METHODS | |
13461 | ||
13462 | canonpath() | |
13463 | ||
13464 | =back | |
13465 | ||
13466 | catdir() | |
13467 | ||
13468 | catfile | |
13469 | ||
13470 | curdir | |
13471 | ||
13472 | devnull | |
13473 | ||
13474 | rootdir | |
13475 | ||
13476 | tmpdir | |
13477 | ||
13478 | updir | |
13479 | ||
13480 | no_upwards | |
13481 | ||
13482 | case_tolerant | |
13483 | ||
13484 | file_name_is_absolute | |
13485 | ||
13486 | path | |
13487 | ||
13488 | join | |
13489 | ||
13490 | splitpath | |
13491 | ||
13492 | splitdir | |
13493 | ||
13494 | catpath() | |
13495 | ||
13496 | abs2rel | |
13497 | ||
13498 | rel2abs() | |
13499 | ||
13500 | =over 4 | |
13501 | ||
13502 | =item SEE ALSO | |
13503 | ||
13504 | =back | |
13505 | ||
13506 | =head2 File::Spec::VMS - methods for VMS file specs | |
13507 | ||
13508 | =over 4 | |
13509 | ||
13510 | =item SYNOPSIS | |
13511 | ||
13512 | =item DESCRIPTION | |
13513 | ||
13514 | eliminate_macros | |
13515 | ||
13516 | =back | |
13517 | ||
13518 | fixpath | |
13519 | ||
13520 | =over 4 | |
13521 | ||
13522 | =item Methods always loaded | |
13523 | ||
13524 | canonpath (override) | |
13525 | ||
13526 | =back | |
13527 | ||
13528 | catdir | |
13529 | ||
13530 | catfile | |
13531 | ||
13532 | curdir (override) | |
13533 | ||
13534 | devnull (override) | |
13535 | ||
13536 | rootdir (override) | |
13537 | ||
13538 | tmpdir (override) | |
13539 | ||
13540 | updir (override) | |
13541 | ||
13542 | case_tolerant (override) | |
13543 | ||
13544 | path (override) | |
13545 | ||
13546 | file_name_is_absolute (override) | |
13547 | ||
13548 | splitpath (override) | |
13549 | ||
13550 | splitdir (override) | |
13551 | ||
13552 | catpath (override) | |
13553 | ||
13554 | abs2rel (override) | |
13555 | ||
13556 | rel2abs (override) | |
13557 | ||
13558 | =over 4 | |
13559 | ||
13560 | =item SEE ALSO | |
13561 | ||
13562 | =back | |
13563 | ||
13564 | =head2 File::Spec::Win32 - methods for Win32 file specs | |
13565 | ||
13566 | =over 4 | |
13567 | ||
13568 | =item SYNOPSIS | |
13569 | ||
13570 | =item DESCRIPTION | |
13571 | ||
13572 | devnull | |
13573 | ||
13574 | =back | |
13575 | ||
13576 | tmpdir | |
13577 | ||
13578 | catfile | |
13579 | ||
13580 | canonpath | |
13581 | ||
13582 | splitpath | |
13583 | ||
13584 | splitdir | |
13585 | ||
13586 | catpath | |
13587 | ||
13588 | =over 4 | |
13589 | ||
13590 | =item Note For File::Spec::Win32 Maintainers | |
13591 | ||
13592 | =back | |
13593 | ||
13594 | =over 4 | |
13595 | ||
13596 | =item SEE ALSO | |
13597 | ||
13598 | =back | |
13599 | ||
13600 | =head2 File::Temp - return name and handle of a temporary file safely | |
13601 | ||
13602 | =over 4 | |
13603 | ||
13604 | =item PORTABILITY | |
13605 | ||
13606 | =item SYNOPSIS | |
13607 | ||
13608 | =item DESCRIPTION | |
13609 | ||
13610 | =back | |
13611 | ||
13612 | =over 4 | |
13613 | ||
13614 | =item FUNCTIONS | |
13615 | ||
13616 | B<tempfile> | |
13617 | ||
13618 | =back | |
13619 | ||
13620 | B<tempdir> | |
13621 | ||
13622 | =over 4 | |
13623 | ||
13624 | =item MKTEMP FUNCTIONS | |
13625 | ||
13626 | B<mkstemp> | |
13627 | ||
13628 | =back | |
13629 | ||
13630 | B<mkstemps> | |
13631 | ||
13632 | B<mkdtemp> | |
13633 | ||
13634 | B<mktemp> | |
13635 | ||
13636 | =over 4 | |
13637 | ||
13638 | =item POSIX FUNCTIONS | |
13639 | ||
13640 | B<tmpnam> | |
13641 | ||
13642 | =back | |
13643 | ||
13644 | B<tmpfile> | |
13645 | ||
13646 | =over 4 | |
13647 | ||
13648 | =item ADDITIONAL FUNCTIONS | |
13649 | ||
13650 | B<tempnam> | |
13651 | ||
13652 | =back | |
13653 | ||
13654 | =over 4 | |
13655 | ||
13656 | =item UTILITY FUNCTIONS | |
13657 | ||
13658 | B<unlink0> | |
13659 | ||
13660 | =back | |
13661 | ||
13662 | =over 4 | |
13663 | ||
13664 | =item PACKAGE VARIABLES | |
13665 | ||
13666 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
13667 | ||
13668 | =back | |
13669 | ||
13670 | TopSystemUID | |
13671 | ||
13672 | =over 4 | |
13673 | ||
13674 | =item WARNING | |
13675 | ||
13676 | =over 4 | |
13677 | ||
13678 | =item Temporary files and NFS | |
13679 | ||
13680 | =back | |
13681 | ||
13682 | =item HISTORY | |
13683 | ||
13684 | =item SEE ALSO | |
13685 | ||
13686 | =item AUTHOR | |
13687 | ||
13688 | =back | |
13689 | ||
13690 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
13691 | ||
13692 | =over 4 | |
13693 | ||
13694 | =item SYNOPSIS | |
13695 | ||
13696 | =item DESCRIPTION | |
13697 | ||
13698 | =item BUGS | |
13699 | ||
13700 | =item NOTE | |
13701 | ||
13702 | =item AUTHOR | |
13703 | ||
13704 | =back | |
13705 | ||
13706 | =head2 FileCache - keep more files open than the system permits | |
13707 | ||
13708 | =over 4 | |
13709 | ||
13710 | =item SYNOPSIS | |
13711 | ||
13712 | =item DESCRIPTION | |
13713 | ||
13714 | cacheout EXPR, cacheout MODE, EXPR | |
13715 | ||
13716 | =item CAVEATS | |
13717 | ||
13718 | =item BUGS | |
13719 | ||
13720 | =back | |
13721 | ||
13722 | =head2 FileHandle - supply object methods for filehandles | |
13723 | ||
13724 | =over 4 | |
13725 | ||
13726 | =item SYNOPSIS | |
13727 | ||
13728 | =item DESCRIPTION | |
13729 | ||
13730 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
13731 | ||
13732 | =item SEE ALSO | |
13733 | ||
13734 | =back | |
13735 | ||
13736 | =head2 Filter::Simple - Simplified source filtering | |
13737 | ||
13738 | =over 4 | |
13739 | ||
13740 | =item SYNOPSIS | |
13741 | ||
13742 | =item DESCRIPTION | |
13743 | ||
13744 | =over 4 | |
13745 | ||
13746 | =item The Problem | |
13747 | ||
13748 | =item A Solution | |
13749 | ||
13750 | =item Disabling or changing <no> behaviour | |
13751 | ||
13752 | =item All-in-one interface | |
13753 | ||
13754 | =item Filtering only specific components of source code | |
13755 | ||
13756 | C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">, | |
13757 | C<"all"> | |
13758 | ||
13759 | =item Filtering only the code parts of source code | |
13760 | ||
13761 | Most source code ceases to be grammatically correct when it is broken up | |
13762 | into the pieces between string literals and regexes. So the C<'code'> | |
13763 | component filter behaves slightly differently from the other partial | |
13764 | filters | |
13765 | described in the previous section. | |
13766 | ||
13767 | =item Using Filter::Simple with an explicit C<import> subroutine | |
13768 | ||
13769 | =item Using Filter::Simple and Exporter together | |
13770 | ||
13771 | =item How it works | |
13772 | ||
13773 | =back | |
13774 | ||
13775 | =item AUTHOR | |
13776 | ||
13777 | =item COPYRIGHT | |
13778 | ||
13779 | =back | |
13780 | ||
13781 | =head2 Filter::Util::Call - Perl Source Filter Utility Module | |
13782 | ||
13783 | =over 4 | |
13784 | ||
13785 | =item SYNOPSIS | |
13786 | ||
13787 | =item DESCRIPTION | |
13788 | ||
13789 | =over 4 | |
13790 | ||
13791 | =item B<use Filter::Util::Call> | |
13792 | ||
13793 | =item B<import()> | |
13794 | ||
13795 | =item B<filter() and anonymous sub> | |
13796 | ||
13797 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> | |
13798 | ||
13799 | =back | |
13800 | ||
13801 | =item EXAMPLES | |
13802 | ||
13803 | =over 4 | |
13804 | ||
13805 | =item Example 1: A simple filter. | |
13806 | ||
13807 | =item Example 2: Using the context | |
13808 | ||
13809 | =item Example 3: Using the context within the filter | |
13810 | ||
13811 | =item Example 4: Using filter_del | |
13812 | ||
13813 | =back | |
13814 | ||
13815 | =item Filter::Simple | |
13816 | ||
13817 | =item AUTHOR | |
13818 | ||
13819 | =item DATE | |
13820 | ||
13821 | =back | |
13822 | ||
13823 | =head2 FindBin - Locate directory of original perl script | |
13824 | ||
13825 | =over 4 | |
13826 | ||
13827 | =item SYNOPSIS | |
13828 | ||
13829 | =item DESCRIPTION | |
13830 | ||
13831 | =item EXPORTABLE VARIABLES | |
13832 | ||
13833 | =item KNOWN ISSUES | |
13834 | ||
13835 | =item KNOWN BUGS | |
13836 | ||
13837 | =item AUTHORS | |
13838 | ||
13839 | =item COPYRIGHT | |
13840 | ||
13841 | =back | |
13842 | ||
13843 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
13844 | ||
13845 | =over 4 | |
13846 | ||
13847 | =item SYNOPSIS | |
13848 | ||
13849 | =item DESCRIPTION | |
13850 | ||
13851 | =item AVAILABILITY | |
13852 | ||
13853 | =item BUGS | |
13854 | ||
13855 | =item SEE ALSO | |
13856 | ||
13857 | =back | |
13858 | ||
13859 | =head2 Getopt::Long - Extended processing of command line options | |
13860 | ||
13861 | =over 4 | |
13862 | ||
13863 | =item SYNOPSIS | |
13864 | ||
13865 | =item DESCRIPTION | |
13866 | ||
13867 | =item Command Line Options, an Introduction | |
13868 | ||
13869 | =item Getting Started with Getopt::Long | |
13870 | ||
13871 | =over 4 | |
13872 | ||
13873 | =item Simple options | |
13874 | ||
13875 | =item A little bit less simple options | |
13876 | ||
13877 | =item Mixing command line option with other arguments | |
13878 | ||
13879 | =item Options with values | |
13880 | ||
13881 | =item Options with multiple values | |
13882 | ||
13883 | =item Options with hash values | |
13884 | ||
13885 | =item User-defined subroutines to handle options | |
13886 | ||
13887 | =item Options with multiple names | |
13888 | ||
13889 | =item Case and abbreviations | |
13890 | ||
13891 | =item Summary of Option Specifications | |
13892 | ||
13893 | !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : | |
13894 | + [ I<desttype> ] | |
13895 | ||
13896 | =back | |
13897 | ||
13898 | =item Advanced Possibilities | |
13899 | ||
13900 | =over 4 | |
13901 | ||
13902 | =item Object oriented interface | |
13903 | ||
13904 | =item Thread Safety | |
13905 | ||
13906 | =item Documentation and help texts | |
13907 | ||
13908 | =item Storing options in a hash | |
13909 | ||
13910 | =item Bundling | |
13911 | ||
13912 | =item The lonesome dash | |
13913 | ||
13914 | =item Argument callback | |
13915 | ||
13916 | =back | |
13917 | ||
13918 | =item Configuring Getopt::Long | |
13919 | ||
13920 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, | |
13921 | require_order, permute, bundling (default: disabled), bundling_override | |
13922 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
13923 | (default: disabled), pass_through (default: disabled), prefix, | |
13924 | prefix_pattern, debug (default: disabled) | |
13925 | ||
13926 | =item Return values and Errors | |
13927 | ||
13928 | =item Legacy | |
13929 | ||
13930 | =over 4 | |
13931 | ||
13932 | =item Default destinations | |
13933 | ||
13934 | =item Alternative option starters | |
13935 | ||
13936 | =item Configuration variables | |
13937 | ||
13938 | =back | |
13939 | ||
13940 | =item Trouble Shooting | |
13941 | ||
13942 | =over 4 | |
13943 | ||
13944 | =item Warning: Ignoring '!' modifier for short option | |
13945 | ||
13946 | =item GetOptions does not return a false result when an option is not | |
13947 | supplied | |
13948 | ||
13949 | =item GetOptions does not split the command line correctly | |
13950 | ||
13951 | =item How do I put a "-?" option into a Getopt::Long? | |
13952 | ||
13953 | =back | |
13954 | ||
13955 | =item AUTHOR | |
13956 | ||
13957 | =item COPYRIGHT AND DISCLAIMER | |
13958 | ||
13959 | =back | |
13960 | ||
13961 | =head2 Getopt::Std, getopt - Process single-character switches with switch | |
13962 | clustering | |
13963 | ||
13964 | =over 4 | |
13965 | ||
13966 | =item SYNOPSIS | |
13967 | ||
13968 | =item DESCRIPTION | |
13969 | ||
13970 | =back | |
13971 | ||
13972 | =head2 Hash::Util - A selection of general-utility hash subroutines | |
13973 | ||
13974 | =over 4 | |
13975 | ||
13976 | =item SYNOPSIS | |
13977 | ||
13978 | =item DESCRIPTION | |
13979 | ||
13980 | =over 4 | |
13981 | ||
13982 | =item Restricted hashes | |
13983 | ||
13984 | lock_keys, unlock_keys | |
13985 | ||
13986 | =back | |
13987 | ||
13988 | =back | |
13989 | ||
13990 | lock_value, unlock_value | |
13991 | ||
13992 | B<lock_hash>, B<unlock_hash> | |
13993 | ||
13994 | =over 4 | |
13995 | ||
13996 | =item AUTHOR | |
13997 | ||
13998 | =item SEE ALSO | |
13999 | ||
14000 | =back | |
14001 | ||
14002 | =head2 I18N::Collate - compare 8-bit scalar data according to the current | |
14003 | locale | |
14004 | ||
14005 | =over 4 | |
14006 | ||
14007 | =item SYNOPSIS | |
14008 | ||
14009 | =item DESCRIPTION | |
14010 | ||
14011 | =back | |
14012 | ||
14013 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language | |
14014 | tags | |
14015 | ||
14016 | =over 4 | |
14017 | ||
14018 | =item SYNOPSIS | |
14019 | ||
14020 | =item DESCRIPTION | |
14021 | ||
14022 | =back | |
14023 | ||
14024 | the function is_language_tag($lang1) | |
14025 | ||
14026 | the function extract_language_tags($whatever) | |
14027 | ||
14028 | the function same_language_tag($lang1, $lang2) | |
14029 | ||
14030 | the function similarity_language_tag($lang1, $lang2) | |
14031 | ||
14032 | the function is_dialect_of($lang1, $lang2) | |
14033 | ||
14034 | the function super_languages($lang1) | |
14035 | ||
14036 | the function locale2language_tag($locale_identifier) | |
14037 | ||
14038 | the function encode_language_tag($lang1) | |
14039 | ||
14040 | the function alternate_language_tags($lang1) | |
14041 | ||
14042 | the function @langs = panic_languages(@accept_languages) | |
14043 | ||
14044 | =over 4 | |
14045 | ||
14046 | =item ABOUT LOWERCASING | |
14047 | ||
14048 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS | |
14049 | ||
14050 | =item SEE ALSO | |
14051 | ||
14052 | =item COPYRIGHT | |
14053 | ||
14054 | =item AUTHOR | |
14055 | ||
14056 | =back | |
14057 | ||
14058 | =head2 I18N::LangTags::List -- tags and names for human languages | |
14059 | ||
14060 | =over 4 | |
14061 | ||
14062 | =item SYNOPSIS | |
14063 | ||
14064 | =item DESCRIPTION | |
14065 | ||
14066 | =item ABOUT LANGUAGE TAGS | |
14067 | ||
14068 | =item LIST OF LANGUAGES | |
14069 | ||
14070 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} : | |
14071 | Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)], | |
14072 | {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} : | |
14073 | Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} : | |
14074 | Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} : | |
14075 | Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} : | |
14076 | Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages], | |
14077 | [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} : | |
14078 | Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, | |
14079 | {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} : | |
14080 | Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu | |
14081 | (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak | |
14082 | (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} : | |
14083 | Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : | |
14084 | Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : | |
14085 | Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : | |
14086 | Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, | |
14087 | [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], | |
14088 | [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} : | |
14089 | Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} | |
14090 | : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : | |
14091 | Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, | |
14092 | {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : | |
14093 | Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and | |
14094 | pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)], | |
14095 | [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles | |
14096 | and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} : | |
14097 | Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default | |
14098 | (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi} | |
14099 | : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : | |
14100 | Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, | |
14101 | {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, | |
14102 | {en} : English, {enm} : Old English (1100-1500), {ang} : Old English | |
14103 | (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} : | |
14104 | Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : | |
14105 | Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} | |
14106 | : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : | |
14107 | Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, | |
14108 | {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, | |
14109 | {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500), | |
14110 | {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : | |
14111 | Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : | |
14112 | Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : | |
14113 | Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian, | |
14114 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : | |
14115 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, | |
14116 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo, | |
14117 | {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)], | |
14118 | {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language | |
14119 | Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira} | |
14120 | : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} : | |
14121 | Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} : | |
14122 | Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian, | |
14123 | {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} : | |
14124 | Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} : | |
14125 | Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi} | |
14126 | : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu, | |
14127 | {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi, | |
14128 | {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} : | |
14129 | Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru} | |
14130 | : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba, | |
14131 | {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} : | |
14132 | Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} : | |
14133 | Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} : | |
14134 | Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian, | |
14135 | {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} : | |
14136 | Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu, | |
14137 | {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo | |
14138 | languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} : | |
14139 | Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men} | |
14140 | : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} : | |
14141 | Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} : | |
14142 | Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} | |
14143 | : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} : | |
14144 | Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} : | |
14145 | Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : | |
14146 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, | |
14147 | {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami, | |
14148 | {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} | |
14149 | : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, | |
14150 | {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya, | |
14151 | {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian | |
14152 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : | |
14153 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : | |
14154 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian | |
14155 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} | |
14156 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], | |
14157 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : | |
14158 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, | |
14159 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : | |
14160 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan | |
14161 | languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)], | |
14162 | {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} : | |
14163 | Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup, | |
14164 | [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan, | |
14165 | {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika, | |
14166 | {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} : | |
14167 | Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)], | |
14168 | {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} : | |
14169 | Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern | |
14170 | Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es} | |
14171 | : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} : | |
14172 | Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} : | |
14173 | Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} : | |
14174 | Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te} | |
14175 | : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig} | |
14176 | : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit, | |
14177 | {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga | |
14178 | (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} : | |
14179 | Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish | |
14180 | (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi, | |
14181 | {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} : | |
14182 | Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} : | |
14183 | Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages], | |
14184 | {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof, | |
14185 | {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut, | |
14186 | {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik | |
14187 | languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : | |
14188 | Zhuang, {zu} : Zulu, {zun} : Zuni | |
14189 | ||
14190 | =item SEE ALSO | |
14191 | ||
14192 | =item COPYRIGHT AND DISCLAIMER | |
14193 | ||
14194 | =item AUTHOR | |
14195 | ||
14196 | =back | |
14197 | ||
14198 | =head2 I18N::Langinfo - query locale information | |
14199 | ||
14200 | =over 4 | |
14201 | ||
14202 | =item SYNOPSIS | |
14203 | ||
14204 | =item DESCRIPTION | |
14205 | ||
14206 | =over 4 | |
14207 | ||
14208 | =item EXPORT | |
14209 | ||
14210 | =back | |
14211 | ||
14212 | =item SEE ALSO | |
14213 | ||
14214 | =item AUTHOR | |
14215 | ||
14216 | =item COPYRIGHT AND LICENSE | |
14217 | ||
14218 | =back | |
14219 | ||
14220 | =head2 IO - load various IO modules | |
14221 | ||
14222 | =over 4 | |
14223 | ||
14224 | =item SYNOPSIS | |
14225 | ||
14226 | =item DESCRIPTION | |
14227 | ||
14228 | =back | |
14229 | ||
14230 | =head2 IO::Dir - supply object methods for directory handles | |
14231 | ||
14232 | =over 4 | |
14233 | ||
14234 | =item SYNOPSIS | |
14235 | ||
14236 | =item DESCRIPTION | |
14237 | ||
14238 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
14239 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
14240 | ||
14241 | =item SEE ALSO | |
14242 | ||
14243 | =item AUTHOR | |
14244 | ||
14245 | =item COPYRIGHT | |
14246 | ||
14247 | =back | |
14248 | ||
14249 | =head2 IO::File - supply object methods for filehandles | |
14250 | ||
14251 | =over 4 | |
14252 | ||
14253 | =item SYNOPSIS | |
14254 | ||
14255 | =item DESCRIPTION | |
14256 | ||
14257 | =item CONSTRUCTOR | |
14258 | ||
14259 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
14260 | ||
14261 | =item METHODS | |
14262 | ||
14263 | open( FILENAME [,MODE [,PERMS]] ) | |
14264 | ||
14265 | =item SEE ALSO | |
14266 | ||
14267 | =item HISTORY | |
14268 | ||
14269 | =back | |
14270 | ||
14271 | =head2 IO::Handle - supply object methods for I/O handles | |
14272 | ||
14273 | =over 4 | |
14274 | ||
14275 | =item SYNOPSIS | |
14276 | ||
14277 | =item DESCRIPTION | |
14278 | ||
14279 | =item CONSTRUCTOR | |
14280 | ||
14281 | new (), new_from_fd ( FD, MODE ) | |
14282 | ||
14283 | =item METHODS | |
14284 | ||
14285 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
14286 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
14287 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
14288 | $io->blocking ( [ BOOL ] ), $io->untaint | |
14289 | ||
14290 | =item NOTE | |
14291 | ||
14292 | =item SEE ALSO | |
14293 | ||
14294 | =item BUGS | |
14295 | ||
14296 | =item HISTORY | |
14297 | ||
14298 | =back | |
14299 | ||
14300 | =head2 IO::Pipe - supply object methods for pipes | |
14301 | ||
14302 | =over 4 | |
14303 | ||
14304 | =item SYNOPSIS | |
14305 | ||
14306 | =item DESCRIPTION | |
14307 | ||
14308 | =item CONSTRUCTOR | |
14309 | ||
14310 | new ( [READER, WRITER] ) | |
14311 | ||
14312 | =item METHODS | |
14313 | ||
14314 | reader ([ARGS]), writer ([ARGS]), handles () | |
14315 | ||
14316 | =item SEE ALSO | |
14317 | ||
14318 | =item AUTHOR | |
14319 | ||
14320 | =item COPYRIGHT | |
14321 | ||
14322 | =back | |
14323 | ||
14324 | =head2 IO::Poll - Object interface to system poll call | |
14325 | ||
14326 | =over 4 | |
14327 | ||
14328 | =item SYNOPSIS | |
14329 | ||
14330 | =item DESCRIPTION | |
14331 | ||
14332 | =item METHODS | |
14333 | ||
14334 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
14335 | IO ), handles( [ EVENT_MASK ] ) | |
14336 | ||
14337 | =item SEE ALSO | |
14338 | ||
14339 | =item AUTHOR | |
14340 | ||
14341 | =item COPYRIGHT | |
14342 | ||
14343 | =back | |
14344 | ||
14345 | =head2 IO::Seekable - supply seek based methods for I/O objects | |
14346 | ||
14347 | =over 4 | |
14348 | ||
14349 | =item SYNOPSIS | |
14350 | ||
14351 | =item DESCRIPTION | |
14352 | ||
14353 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), | |
14354 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
14355 | $io->tell | |
14356 | ||
14357 | =item SEE ALSO | |
14358 | ||
14359 | =item HISTORY | |
14360 | ||
14361 | =back | |
14362 | ||
14363 | =head2 IO::Select - OO interface to the select system call | |
14364 | ||
14365 | =over 4 | |
14366 | ||
14367 | =item SYNOPSIS | |
14368 | ||
14369 | =item DESCRIPTION | |
14370 | ||
14371 | =item CONSTRUCTOR | |
14372 | ||
14373 | new ( [ HANDLES ] ) | |
14374 | ||
14375 | =item METHODS | |
14376 | ||
14377 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
14378 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
14379 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
14380 | ||
14381 | =item EXAMPLE | |
14382 | ||
14383 | =item AUTHOR | |
14384 | ||
14385 | =item COPYRIGHT | |
14386 | ||
14387 | =back | |
14388 | ||
14389 | =head2 IO::Socket - Object interface to socket communications | |
14390 | ||
14391 | =over 4 | |
14392 | ||
14393 | =item SYNOPSIS | |
14394 | ||
14395 | =item DESCRIPTION | |
14396 | ||
14397 | =item CONSTRUCTOR | |
14398 | ||
14399 | new ( [ARGS] ) | |
14400 | ||
14401 | =item METHODS | |
14402 | ||
14403 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, | |
14404 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
14405 | ||
14406 | =item SEE ALSO | |
14407 | ||
14408 | =item AUTHOR | |
14409 | ||
14410 | =item COPYRIGHT | |
14411 | ||
14412 | =back | |
14413 | ||
14414 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets | |
14415 | ||
14416 | =over 4 | |
14417 | ||
14418 | =item SYNOPSIS | |
14419 | ||
14420 | =item DESCRIPTION | |
14421 | ||
14422 | =item CONSTRUCTOR | |
14423 | ||
14424 | new ( [ARGS] ) | |
14425 | ||
14426 | =over 4 | |
14427 | ||
14428 | =item METHODS | |
14429 | ||
14430 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
14431 | () | |
14432 | ||
14433 | =back | |
14434 | ||
14435 | =item SEE ALSO | |
14436 | ||
14437 | =item AUTHOR | |
14438 | ||
14439 | =item COPYRIGHT | |
14440 | ||
14441 | =back | |
14442 | ||
14443 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets | |
14444 | ||
14445 | =over 4 | |
14446 | ||
14447 | =item SYNOPSIS | |
14448 | ||
14449 | =item DESCRIPTION | |
14450 | ||
14451 | =item CONSTRUCTOR | |
14452 | ||
14453 | new ( [ARGS] ) | |
14454 | ||
14455 | =item METHODS | |
14456 | ||
14457 | hostpath(), peerpath() | |
14458 | ||
14459 | =item SEE ALSO | |
14460 | ||
14461 | =item AUTHOR | |
14462 | ||
14463 | =item COPYRIGHT | |
14464 | ||
14465 | =back | |
14466 | ||
14467 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory | |
14468 | handles | |
14469 | ||
14470 | =over 4 | |
14471 | ||
14472 | =item SYNOPSIS | |
14473 | ||
14474 | =item DESCRIPTION | |
14475 | ||
14476 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
14477 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
14478 | ||
14479 | =item SEE ALSO | |
14480 | ||
14481 | =item AUTHOR | |
14482 | ||
14483 | =item COPYRIGHT | |
14484 | ||
14485 | =back | |
14486 | ||
14487 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles | |
14488 | ||
14489 | =over 4 | |
14490 | ||
14491 | =item SYNOPSIS | |
14492 | ||
14493 | =item DESCRIPTION | |
14494 | ||
14495 | =item CONSTRUCTOR | |
14496 | ||
14497 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
14498 | ||
14499 | =item METHODS | |
14500 | ||
14501 | open( FILENAME [,MODE [,PERMS]] ) | |
14502 | ||
14503 | =item SEE ALSO | |
14504 | ||
14505 | =item HISTORY | |
14506 | ||
14507 | =back | |
14508 | ||
14509 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O | |
14510 | handles | |
14511 | ||
14512 | =over 4 | |
14513 | ||
14514 | =item SYNOPSIS | |
14515 | ||
14516 | =item DESCRIPTION | |
14517 | ||
14518 | =item CONSTRUCTOR | |
14519 | ||
14520 | new (), new_from_fd ( FD, MODE ) | |
14521 | ||
14522 | =item METHODS | |
14523 | ||
14524 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
14525 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
14526 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
14527 | $io->blocking ( [ BOOL ] ), $io->untaint | |
14528 | ||
14529 | =item NOTE | |
14530 | ||
14531 | =item SEE ALSO | |
14532 | ||
14533 | =item BUGS | |
14534 | ||
14535 | =item HISTORY | |
14536 | ||
14537 | =back | |
14538 | ||
14539 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes | |
14540 | ||
14541 | =over 4 | |
14542 | ||
14543 | =item SYNOPSIS | |
14544 | ||
14545 | =item DESCRIPTION | |
14546 | ||
14547 | =item CONSTRUCTOR | |
14548 | ||
14549 | new ( [READER, WRITER] ) | |
14550 | ||
14551 | =item METHODS | |
14552 | ||
14553 | reader ([ARGS]), writer ([ARGS]), handles () | |
14554 | ||
14555 | =item SEE ALSO | |
14556 | ||
14557 | =item AUTHOR | |
14558 | ||
14559 | =item COPYRIGHT | |
14560 | ||
14561 | =back | |
14562 | ||
14563 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call | |
14564 | ||
14565 | =over 4 | |
14566 | ||
14567 | =item SYNOPSIS | |
14568 | ||
14569 | =item DESCRIPTION | |
14570 | ||
14571 | =item METHODS | |
14572 | ||
14573 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
14574 | IO ), handles( [ EVENT_MASK ] ) | |
14575 | ||
14576 | =item SEE ALSO | |
14577 | ||
14578 | =item AUTHOR | |
14579 | ||
14580 | =item COPYRIGHT | |
14581 | ||
14582 | =back | |
14583 | ||
14584 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for | |
14585 | I/O objects | |
14586 | ||
14587 | =over 4 | |
14588 | ||
14589 | =item SYNOPSIS | |
14590 | ||
14591 | =item DESCRIPTION | |
14592 | ||
14593 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), | |
14594 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
14595 | $io->tell | |
14596 | ||
14597 | =item SEE ALSO | |
14598 | ||
14599 | =item HISTORY | |
14600 | ||
14601 | =back | |
14602 | ||
14603 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system | |
14604 | call | |
14605 | ||
14606 | =over 4 | |
14607 | ||
14608 | =item SYNOPSIS | |
14609 | ||
14610 | =item DESCRIPTION | |
14611 | ||
14612 | =item CONSTRUCTOR | |
14613 | ||
14614 | new ( [ HANDLES ] ) | |
14615 | ||
14616 | =item METHODS | |
14617 | ||
14618 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
14619 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
14620 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
14621 | ||
14622 | =item EXAMPLE | |
14623 | ||
14624 | =item AUTHOR | |
14625 | ||
14626 | =item COPYRIGHT | |
14627 | ||
14628 | =back | |
14629 | ||
14630 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket | |
14631 | communications | |
14632 | ||
14633 | =over 4 | |
14634 | ||
14635 | =item SYNOPSIS | |
14636 | ||
14637 | =item DESCRIPTION | |
14638 | ||
14639 | =item CONSTRUCTOR | |
14640 | ||
14641 | new ( [ARGS] ) | |
14642 | ||
14643 | =item METHODS | |
14644 | ||
14645 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, | |
14646 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
14647 | ||
14648 | =item SEE ALSO | |
14649 | ||
14650 | =item AUTHOR | |
14651 | ||
14652 | =item COPYRIGHT | |
14653 | ||
14654 | =back | |
14655 | ||
14656 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for | |
14657 | AF_INET domain sockets | |
14658 | ||
14659 | =over 4 | |
14660 | ||
14661 | =item SYNOPSIS | |
14662 | ||
14663 | =item DESCRIPTION | |
14664 | ||
14665 | =item CONSTRUCTOR | |
14666 | ||
14667 | new ( [ARGS] ) | |
14668 | ||
14669 | =over 4 | |
14670 | ||
14671 | =item METHODS | |
14672 | ||
14673 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
14674 | () | |
14675 | ||
14676 | =back | |
14677 | ||
14678 | =item SEE ALSO | |
14679 | ||
14680 | =item AUTHOR | |
14681 | ||
14682 | =item COPYRIGHT | |
14683 | ||
14684 | =back | |
14685 | ||
14686 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for | |
14687 | AF_UNIX domain sockets | |
14688 | ||
14689 | =over 4 | |
14690 | ||
14691 | =item SYNOPSIS | |
14692 | ||
14693 | =item DESCRIPTION | |
14694 | ||
14695 | =item CONSTRUCTOR | |
14696 | ||
14697 | new ( [ARGS] ) | |
14698 | ||
14699 | =item METHODS | |
14700 | ||
14701 | hostpath(), peerpath() | |
14702 | ||
14703 | =item SEE ALSO | |
14704 | ||
14705 | =item AUTHOR | |
14706 | ||
14707 | =item COPYRIGHT | |
14708 | ||
14709 | =back | |
14710 | ||
14711 | =head2 IPC::Msg - SysV Msg IPC object class | |
14712 | ||
14713 | =over 4 | |
14714 | ||
14715 | =item SYNOPSIS | |
14716 | ||
14717 | =item DESCRIPTION | |
14718 | ||
14719 | =item METHODS | |
14720 | ||
14721 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
14722 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
14723 | FLAGS ] ), stat | |
14724 | ||
14725 | =item SEE ALSO | |
14726 | ||
14727 | =item AUTHOR | |
14728 | ||
14729 | =item COPYRIGHT | |
14730 | ||
14731 | =back | |
14732 | ||
14733 | =head2 IPC::Open2, open2 - open a process for both reading and writing | |
14734 | ||
14735 | =over 4 | |
14736 | ||
14737 | =item SYNOPSIS | |
14738 | ||
14739 | =item DESCRIPTION | |
14740 | ||
14741 | =item WARNING | |
14742 | ||
14743 | =item SEE ALSO | |
14744 | ||
14745 | =back | |
14746 | ||
14747 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error | |
14748 | handling | |
14749 | ||
14750 | =over 4 | |
14751 | ||
14752 | =item SYNOPSIS | |
14753 | ||
14754 | =item DESCRIPTION | |
14755 | ||
14756 | =item WARNING | |
14757 | ||
14758 | =back | |
14759 | ||
14760 | =head2 IPC::Semaphore - SysV Semaphore IPC object class | |
14761 | ||
14762 | =over 4 | |
14763 | ||
14764 | =item SYNOPSIS | |
14765 | ||
14766 | =item DESCRIPTION | |
14767 | ||
14768 | =item METHODS | |
14769 | ||
14770 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
14771 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
14772 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
14773 | , VALUE ), stat | |
14774 | ||
14775 | =item SEE ALSO | |
14776 | ||
14777 | =item AUTHOR | |
14778 | ||
14779 | =item COPYRIGHT | |
14780 | ||
14781 | =back | |
14782 | ||
14783 | =head2 IPC::SysV - SysV IPC constants | |
14784 | ||
14785 | =over 4 | |
14786 | ||
14787 | =item SYNOPSIS | |
14788 | ||
14789 | =item DESCRIPTION | |
14790 | ||
14791 | ftok( PATH, ID ) | |
14792 | ||
14793 | =item SEE ALSO | |
14794 | ||
14795 | =item AUTHORS | |
14796 | ||
14797 | =item COPYRIGHT | |
14798 | ||
14799 | =back | |
14800 | ||
14801 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class | |
14802 | ||
14803 | =over 4 | |
14804 | ||
14805 | =item SYNOPSIS | |
14806 | ||
14807 | =item DESCRIPTION | |
14808 | ||
14809 | =item METHODS | |
14810 | ||
14811 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
14812 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
14813 | FLAGS ] ), stat | |
14814 | ||
14815 | =item SEE ALSO | |
14816 | ||
14817 | =item AUTHOR | |
14818 | ||
14819 | =item COPYRIGHT | |
14820 | ||
14821 | =back | |
14822 | ||
14823 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object | |
14824 | class | |
14825 | ||
14826 | =over 4 | |
14827 | ||
14828 | =item SYNOPSIS | |
14829 | ||
14830 | =item DESCRIPTION | |
14831 | ||
14832 | =item METHODS | |
14833 | ||
14834 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
14835 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
14836 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
14837 | , VALUE ), stat | |
14838 | ||
14839 | =item SEE ALSO | |
14840 | ||
14841 | =item AUTHOR | |
14842 | ||
14843 | =item COPYRIGHT | |
14844 | ||
14845 | =back | |
14846 | ||
14847 | =head2 List::Util - A selection of general-utility list subroutines | |
14848 | ||
14849 | =over 4 | |
14850 | ||
14851 | =item SYNOPSIS | |
14852 | ||
14853 | =item DESCRIPTION | |
14854 | ||
14855 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
14856 | BLOCK LIST, shuffle LIST, sum LIST | |
14857 | ||
14858 | =item KNOWN BUGS | |
14859 | ||
14860 | =item SUGGESTED ADDITIONS | |
14861 | ||
14862 | =item COPYRIGHT | |
14863 | ||
14864 | =back | |
14865 | ||
14866 | =head2 List::Utilib::List::Util, List::Util - A selection of | |
14867 | general-utility list subroutines | |
14868 | ||
14869 | =over 4 | |
14870 | ||
14871 | =item SYNOPSIS | |
14872 | ||
14873 | =item DESCRIPTION | |
14874 | ||
14875 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
14876 | BLOCK LIST, shuffle LIST, sum LIST | |
14877 | ||
14878 | =item KNOWN BUGS | |
14879 | ||
14880 | =item SUGGESTED ADDITIONS | |
14881 | ||
14882 | =item COPYRIGHT | |
14883 | ||
14884 | =back | |
14885 | ||
14886 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of | |
14887 | general-utility scalar subroutines | |
14888 | ||
14889 | =over 4 | |
14890 | ||
14891 | =item SYNOPSIS | |
14892 | ||
14893 | =item DESCRIPTION | |
14894 | ||
14895 | blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype | |
14896 | EXPR, tainted EXPR, weaken REF | |
14897 | ||
14898 | =item KNOWN BUGS | |
14899 | ||
14900 | =item COPYRIGHT | |
14901 | ||
14902 | =item BLATANT PLUG | |
14903 | ||
14904 | =back | |
14905 | ||
14906 | =head2 Locale::Constants - constants for Locale codes | |
14907 | ||
14908 | =over 4 | |
14909 | ||
14910 | =item SYNOPSIS | |
14911 | ||
14912 | =item DESCRIPTION | |
14913 | ||
14914 | =item KNOWN BUGS AND LIMITATIONS | |
14915 | ||
14916 | =item SEE ALSO | |
14917 | ||
14918 | Locale::Language, Locale::Country, Locale::Script, Locale::Currency | |
14919 | ||
14920 | =item AUTHOR | |
14921 | ||
14922 | =item COPYRIGHT | |
14923 | ||
14924 | =back | |
14925 | ||
14926 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) | |
14927 | ||
14928 | =over 4 | |
14929 | ||
14930 | =item SYNOPSIS | |
14931 | ||
14932 | =item DESCRIPTION | |
14933 | ||
14934 | B<alpha-2>, B<alpha-3>, B<numeric> | |
14935 | ||
14936 | =item CONVERSION ROUTINES | |
14937 | ||
14938 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), | |
14939 | country_code2code( CODE, CODESET, CODESET ) | |
14940 | ||
14941 | =item QUERY ROUTINES | |
14942 | ||
14943 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> | |
14944 | ||
14945 | =item SEMI-PRIVATE ROUTINES | |
14946 | ||
14947 | =over 4 | |
14948 | ||
14949 | =item alias_code | |
14950 | ||
14951 | =item rename_country | |
14952 | ||
14953 | =back | |
14954 | ||
14955 | =item EXAMPLES | |
14956 | ||
14957 | =item DOMAIN NAMES | |
14958 | ||
14959 | =item KNOWN BUGS AND LIMITATIONS | |
14960 | ||
14961 | =item SEE ALSO | |
14962 | ||
14963 | Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO | |
14964 | 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, | |
14965 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, | |
14966 | http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html | |
14967 | ||
14968 | =item AUTHOR | |
14969 | ||
14970 | =item COPYRIGHT | |
14971 | ||
14972 | =back | |
14973 | ||
14974 | =head2 Locale::Currency - ISO three letter codes for currency | |
14975 | identification (ISO 4217) | |
14976 | ||
14977 | =over 4 | |
14978 | ||
14979 | =item SYNOPSIS | |
14980 | ||
14981 | =item DESCRIPTION | |
14982 | ||
14983 | XTS, XXX | |
14984 | ||
14985 | =item CONVERSION ROUTINES | |
14986 | ||
14987 | code2currency(), currency2code() | |
14988 | ||
14989 | =item QUERY ROUTINES | |
14990 | ||
14991 | C<all_currency_codes()>, C<all_currency_names()> | |
14992 | ||
14993 | =item EXAMPLES | |
14994 | ||
14995 | =item KNOWN BUGS AND LIMITATIONS | |
14996 | ||
14997 | =item SEE ALSO | |
14998 | ||
14999 | Locale::Country, Locale::Script, ISO 4217:1995, | |
15000 | http://www.bsi-global.com/iso4217currency | |
15001 | ||
15002 | =item AUTHOR | |
15003 | ||
15004 | =item COPYRIGHT | |
15005 | ||
15006 | =back | |
15007 | ||
15008 | =head2 Locale::Language - ISO two letter codes for language identification | |
15009 | (ISO 639) | |
15010 | ||
15011 | =over 4 | |
15012 | ||
15013 | =item SYNOPSIS | |
15014 | ||
15015 | =item DESCRIPTION | |
15016 | ||
15017 | =item CONVERSION ROUTINES | |
15018 | ||
15019 | code2language(), language2code() | |
15020 | ||
15021 | =item QUERY ROUTINES | |
15022 | ||
15023 | C<all_language_codes()>, C<all_language_names()> | |
15024 | ||
15025 | =item EXAMPLES | |
15026 | ||
15027 | =item KNOWN BUGS AND LIMITATIONS | |
15028 | ||
15029 | =item SEE ALSO | |
15030 | ||
15031 | Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), | |
15032 | http://lcweb.loc.gov/standards/iso639-2/langhome.html | |
15033 | ||
15034 | =item AUTHOR | |
15035 | ||
15036 | =item COPYRIGHT | |
15037 | ||
15038 | =back | |
15039 | ||
15040 | =head2 Locale::Maketext -- framework for localization | |
15041 | ||
15042 | =over 4 | |
15043 | ||
15044 | =item SYNOPSIS | |
15045 | ||
15046 | =item DESCRIPTION | |
15047 | ||
15048 | =item QUICK OVERVIEW | |
15049 | ||
15050 | =item METHODS | |
15051 | ||
15052 | =over 4 | |
15053 | ||
15054 | =item Construction Methods | |
15055 | ||
15056 | =item The "maketext" Method | |
15057 | ||
15058 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto | |
15059 | ||
15060 | =item Utility Methods | |
15061 | ||
15062 | $language->quant($number, $singular), $language->quant($number, $singular, | |
15063 | $plural), $language->quant($number, $singular, $plural, $negative), | |
15064 | $language->numf($number), $language->sprintf($format, @items), | |
15065 | $language->language_tag(), $language->encoding() | |
15066 | ||
15067 | =item Language Handle Attributes and Internals | |
15068 | ||
15069 | =back | |
15070 | ||
15071 | =item LANGUAGE CLASS HIERARCHIES | |
15072 | ||
15073 | =item ENTRIES IN EACH LEXICON | |
15074 | ||
15075 | =item BRACKET NOTATION | |
15076 | ||
15077 | =item AUTO LEXICONS | |
15078 | ||
15079 | =item CONTROLLING LOOKUP FAILURE | |
15080 | ||
15081 | =item HOW TO USE MAKETEXT | |
15082 | ||
15083 | =item SEE ALSO | |
15084 | ||
15085 | =item COPYRIGHT AND DISCLAIMER | |
15086 | ||
15087 | =item AUTHOR | |
15088 | ||
15089 | =back | |
15090 | ||
15091 | =head2 Locale::Maketext::TPJ13 -- article about software localization | |
15092 | ||
15093 | =over 4 | |
15094 | ||
15095 | =item SYNOPSIS | |
15096 | ||
15097 | =item DESCRIPTION | |
15098 | ||
15099 | =item Localization and Perl: gettext breaks, Maketext fixes | |
15100 | ||
15101 | =over 4 | |
15102 | ||
15103 | =item A Localization Horror Story: It Could Happen To You | |
15104 | ||
15105 | =item The Linguistic View | |
15106 | ||
15107 | =item Breaking gettext | |
15108 | ||
15109 | =item Replacing gettext | |
15110 | ||
15111 | =item Buzzwords: Abstraction and Encapsulation | |
15112 | ||
15113 | =item Buzzword: Isomorphism | |
15114 | ||
15115 | =item Buzzword: Inheritance | |
15116 | ||
15117 | =item Buzzword: Concision | |
15118 | ||
15119 | =item The Devil in the Details | |
15120 | ||
15121 | =item The Proof in the Pudding: Localizing Web Sites | |
15122 | ||
15123 | =item References | |
15124 | ||
15125 | =back | |
15126 | ||
15127 | =back | |
15128 | ||
15129 | =head2 Locale::Script - ISO codes for script identification (ISO 15924) | |
15130 | ||
15131 | =over 4 | |
15132 | ||
15133 | =item SYNOPSIS | |
15134 | ||
15135 | =item DESCRIPTION | |
15136 | ||
15137 | B<alpha-2>, B<alpha-3>, B<numeric> | |
15138 | ||
15139 | =over 4 | |
15140 | ||
15141 | =item SPECIAL CODES | |
15142 | ||
15143 | =back | |
15144 | ||
15145 | =item CONVERSION ROUTINES | |
15146 | ||
15147 | code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), | |
15148 | script_code2code( CODE, CODESET, CODESET ) | |
15149 | ||
15150 | =item QUERY ROUTINES | |
15151 | ||
15152 | C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> | |
15153 | ||
15154 | =item EXAMPLES | |
15155 | ||
15156 | =item KNOWN BUGS AND LIMITATIONS | |
15157 | ||
15158 | =item SEE ALSO | |
15159 | ||
15160 | Locale::Language, Locale::Currency, Locale::Country, ISO 15924, | |
15161 | http://www.evertype.com/standards/iso15924/ | |
15162 | ||
15163 | =item AUTHOR | |
15164 | ||
15165 | =item COPYRIGHT | |
15166 | ||
15167 | =back | |
15168 | ||
15169 | =head2 MIME::Base64 - Encoding and decoding of base64 strings | |
15170 | ||
15171 | =over 4 | |
15172 | ||
15173 | =item SYNOPSIS | |
15174 | ||
15175 | =item DESCRIPTION | |
15176 | ||
15177 | encode_base64($str, [$eol]), decode_base64($str) | |
15178 | ||
15179 | =item DIAGNOSTICS | |
15180 | ||
15181 | Premature end of base64 data, Premature padding of base64 data | |
15182 | ||
15183 | =item EXAMPLES | |
15184 | ||
15185 | =item COPYRIGHT | |
15186 | ||
15187 | =back | |
15188 | ||
15189 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding | |
15190 | of quoted-printable strings | |
15191 | ||
15192 | =over 4 | |
15193 | ||
15194 | =item SYNOPSIS | |
15195 | ||
15196 | =item DESCRIPTION | |
15197 | ||
15198 | encode_qp($str), decode_qp($str); | |
15199 | ||
15200 | =item COPYRIGHT | |
15201 | ||
15202 | =back | |
15203 | ||
15204 | =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable | |
15205 | strings | |
15206 | ||
15207 | =over 4 | |
15208 | ||
15209 | =item SYNOPSIS | |
15210 | ||
15211 | =item DESCRIPTION | |
15212 | ||
15213 | encode_qp($str), decode_qp($str); | |
15214 | ||
15215 | =item COPYRIGHT | |
15216 | ||
15217 | =back | |
15218 | ||
15219 | =head2 Math::BigFloat - Arbitrary size floating point math package | |
15220 | ||
15221 | =over 4 | |
15222 | ||
15223 | =item SYNOPSIS | |
15224 | ||
15225 | =item DESCRIPTION | |
15226 | ||
15227 | =over 4 | |
15228 | ||
15229 | =item Canonical notation | |
15230 | ||
15231 | =item Output | |
15232 | ||
15233 | =item C<mantissa()>, C<exponent()> and C<parts()> | |
15234 | ||
15235 | =item Accuracy vs. Precision | |
15236 | ||
15237 | =item Rounding | |
15238 | ||
15239 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale | |
15240 | ), fround ( -$scale ) and fround ( 0 ) | |
15241 | ||
15242 | =back | |
15243 | ||
15244 | =item EXAMPLES | |
15245 | ||
15246 | # not ready yet | |
15247 | ||
15248 | =item Autocreating constants | |
15249 | ||
15250 | =over 4 | |
15251 | ||
15252 | =item Math library | |
15253 | ||
15254 | =item Using Math::BigInt::Lite | |
15255 | ||
15256 | =back | |
15257 | ||
15258 | =item BUGS | |
15259 | ||
15260 | =item CAVEAT | |
15261 | ||
15262 | stringify, bstr(), bdiv, Modifying and =, bpow | |
15263 | ||
15264 | =item LICENSE | |
15265 | ||
15266 | =item AUTHORS | |
15267 | ||
15268 | =back | |
15269 | ||
15270 | =head2 Math::BigInt - Arbitrary size integer math package | |
15271 | ||
15272 | =over 4 | |
15273 | ||
15274 | =item SYNOPSIS | |
15275 | ||
15276 | =item DESCRIPTION | |
15277 | ||
15278 | Canonical notation, Input, Output | |
15279 | ||
15280 | =item METHODS | |
15281 | ||
15282 | =over 4 | |
15283 | ||
15284 | =item config | |
15285 | ||
15286 | =item accuracy | |
15287 | ||
15288 | =item brsft | |
15289 | ||
15290 | =item new | |
15291 | ||
15292 | =item bnan | |
15293 | ||
15294 | =item bzero | |
15295 | ||
15296 | =item binf | |
15297 | ||
15298 | =item bone | |
15299 | ||
15300 | =item is_one()/is_zero()/is_nan()/is_inf() | |
15301 | ||
15302 | =item is_positive()/is_negative() | |
15303 | ||
15304 | $x->is_positive(); # true if >= 0 | |
15305 | $x->is_negative(); # true if < 0 | |
15306 | ||
15307 | =item is_odd()/is_even()/is_int() | |
15308 | ||
15309 | =item bcmp | |
15310 | ||
15311 | =item bacmp | |
15312 | ||
15313 | =item sign | |
15314 | ||
15315 | =item bcmp | |
15316 | ||
15317 | =item bneg | |
15318 | ||
15319 | =item babs | |
15320 | ||
15321 | =item bnorm | |
15322 | ||
15323 | =item bnot | |
15324 | ||
15325 | =item binc | |
15326 | ||
15327 | =item bdec | |
15328 | ||
15329 | =item badd | |
15330 | ||
15331 | =item bsub | |
15332 | ||
15333 | =item bmul | |
15334 | ||
15335 | =item bdiv | |
15336 | ||
15337 | =item bmod | |
15338 | ||
15339 | =item bmodinv | |
15340 | ||
15341 | =item bmodpow | |
15342 | ||
15343 | =item bpow | |
15344 | ||
15345 | =item blsft | |
15346 | ||
15347 | =item brsft | |
15348 | ||
15349 | =item band | |
15350 | ||
15351 | =item bior | |
15352 | ||
15353 | =item bxor | |
15354 | ||
15355 | =item bnot | |
15356 | ||
15357 | =item bsqrt | |
15358 | ||
15359 | =item bfac | |
15360 | ||
15361 | =item round | |
15362 | ||
15363 | =item bround | |
15364 | ||
15365 | =item bfround | |
15366 | ||
15367 | =item bfloor | |
15368 | ||
15369 | =item bceil | |
15370 | ||
15371 | =item bgcd | |
15372 | ||
15373 | =item blcm | |
15374 | ||
15375 | =item exponent | |
15376 | ||
15377 | =item mantissa | |
15378 | ||
15379 | =item parts | |
15380 | ||
15381 | =item copy | |
15382 | ||
15383 | =item as_number | |
15384 | ||
15385 | =item bsstr | |
15386 | ||
15387 | =item as_hex | |
15388 | ||
15389 | =item as_bin | |
15390 | ||
15391 | =back | |
15392 | ||
15393 | =item ACCURACY and PRECISION | |
15394 | ||
15395 | =over 4 | |
15396 | ||
15397 | =item Precision P | |
15398 | ||
15399 | =item Accuracy A | |
15400 | ||
15401 | =item Fallback F | |
15402 | ||
15403 | =item Rounding mode R | |
15404 | ||
15405 | 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy | |
15406 | (significant digits), Setting/Accessing, Creating numbers, Usage, | |
15407 | Precedence, Overriding globals, Local settings, Rounding, Default values, | |
15408 | Remarks | |
15409 | ||
15410 | =back | |
15411 | ||
15412 | =item INTERNALS | |
15413 | ||
15414 | =over 4 | |
15415 | ||
15416 | =item MATH LIBRARY | |
15417 | ||
15418 | =item SIGN | |
15419 | ||
15420 | =item mantissa(), exponent() and parts() | |
15421 | ||
15422 | =back | |
15423 | ||
15424 | =item EXAMPLES | |
15425 | ||
15426 | use Math::BigInt; | |
15427 | ||
15428 | =item Autocreating constants | |
15429 | ||
15430 | =item PERFORMANCE | |
15431 | ||
15432 | =over 4 | |
15433 | ||
15434 | =item Alternative math libraries | |
15435 | ||
15436 | =item SUBCLASSING | |
15437 | ||
15438 | =back | |
15439 | ||
15440 | =item Subclassing Math::BigInt | |
15441 | ||
15442 | =item UPGRADING | |
15443 | ||
15444 | =over 4 | |
15445 | ||
15446 | =item Auto-upgrade | |
15447 | ||
15448 | bsqrt(), div(), blog() | |
15449 | ||
15450 | =back | |
15451 | ||
15452 | =item BUGS | |
15453 | ||
15454 | Out of Memory!, Fails to load Calc on Perl prior 5.6.0 | |
15455 | ||
15456 | =item CAVEATS | |
15457 | ||
15458 | stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity | |
15459 | handling, Modifying and =, bpow, Overloading -$x, Mixing different object | |
15460 | types, bsqrt(), brsft() | |
15461 | ||
15462 | =item LICENSE | |
15463 | ||
15464 | =item SEE ALSO | |
15465 | ||
15466 | =item AUTHORS | |
15467 | ||
15468 | =back | |
15469 | ||
15470 | =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt | |
15471 | ||
15472 | =over 4 | |
15473 | ||
15474 | =item SYNOPSIS | |
15475 | ||
15476 | =item DESCRIPTION | |
15477 | ||
15478 | =item EXPORT | |
15479 | ||
15480 | =item WRAP YOUR OWN | |
15481 | ||
15482 | =item LICENSE | |
15483 | ||
15484 | This program is free software; you may redistribute it and/or modify it | |
15485 | under | |
15486 | the same terms as Perl itself. | |
15487 | ||
15488 | =item AUTHORS | |
15489 | ||
15490 | =item SEE ALSO | |
15491 | ||
15492 | =back | |
15493 | ||
15494 | =head2 Math::BigRat - arbitrarily big rationals | |
15495 | ||
15496 | =over 4 | |
15497 | ||
15498 | =item SYNOPSIS | |
15499 | ||
15500 | =item DESCRIPTION | |
15501 | ||
15502 | =over 4 | |
15503 | ||
15504 | =item MATH LIBRARY | |
15505 | ||
15506 | =back | |
15507 | ||
15508 | =item METHODS | |
15509 | ||
15510 | =over 4 | |
15511 | ||
15512 | =item new() | |
15513 | ||
15514 | =item numerator() | |
15515 | ||
15516 | =item denominator() | |
15517 | ||
15518 | $d = $x->denominator(); | |
15519 | ||
15520 | =item parts() | |
15521 | ||
15522 | =item as_number() | |
15523 | ||
15524 | =item bfac() | |
15525 | ||
15526 | =item blog() | |
15527 | ||
15528 | =item bround()/round()/bfround() | |
15529 | ||
15530 | =back | |
15531 | ||
15532 | =item BUGS | |
15533 | ||
15534 | =item LICENSE | |
15535 | ||
15536 | =item SEE ALSO | |
15537 | ||
15538 | =item AUTHORS | |
15539 | ||
15540 | =back | |
15541 | ||
15542 | =head2 Math::Complex - complex numbers and associated mathematical | |
15543 | functions | |
15544 | ||
15545 | =over 4 | |
15546 | ||
15547 | =item SYNOPSIS | |
15548 | ||
15549 | =item DESCRIPTION | |
15550 | ||
15551 | =item OPERATIONS | |
15552 | ||
15553 | =item CREATION | |
15554 | ||
15555 | =item STRINGIFICATION | |
15556 | ||
15557 | =over 4 | |
15558 | ||
15559 | =item CHANGED IN PERL 5.6 | |
15560 | ||
15561 | =back | |
15562 | ||
15563 | =item USAGE | |
15564 | ||
15565 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
15566 | ||
15567 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
15568 | ||
15569 | =item BUGS | |
15570 | ||
15571 | =item AUTHORS | |
15572 | ||
15573 | =back | |
15574 | ||
15575 | =head2 Math::Trig - trigonometric functions | |
15576 | ||
15577 | =over 4 | |
15578 | ||
15579 | =item SYNOPSIS | |
15580 | ||
15581 | =item DESCRIPTION | |
15582 | ||
15583 | =item TRIGONOMETRIC FUNCTIONS | |
15584 | ||
15585 | B<tan> | |
15586 | ||
15587 | =over 4 | |
15588 | ||
15589 | =item ERRORS DUE TO DIVISION BY ZERO | |
15590 | ||
15591 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
15592 | ||
15593 | =back | |
15594 | ||
15595 | =item PLANE ANGLE CONVERSIONS | |
15596 | ||
15597 | =item RADIAL COORDINATE CONVERSIONS | |
15598 | ||
15599 | =over 4 | |
15600 | ||
15601 | =item COORDINATE SYSTEMS | |
15602 | ||
15603 | =item 3-D ANGLE CONVERSIONS | |
15604 | ||
15605 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
15606 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
15607 | ||
15608 | =back | |
15609 | ||
15610 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS | |
15611 | ||
15612 | =item EXAMPLES | |
15613 | ||
15614 | =over 4 | |
15615 | ||
15616 | =item CAVEAT FOR GREAT CIRCLE FORMULAS | |
15617 | ||
15618 | =back | |
15619 | ||
15620 | =item BUGS | |
15621 | ||
15622 | =item AUTHORS | |
15623 | ||
15624 | =back | |
15625 | ||
15626 | =head2 Memoize - Make functions faster by trading space for time | |
15627 | ||
15628 | =over 4 | |
15629 | ||
15630 | =item SYNOPSIS | |
15631 | ||
15632 | =item DESCRIPTION | |
15633 | ||
15634 | =item DETAILS | |
15635 | ||
15636 | =item OPTIONS | |
15637 | ||
15638 | =over 4 | |
15639 | ||
15640 | =item INSTALL | |
15641 | ||
15642 | =item NORMALIZER | |
15643 | ||
15644 | =item C<SCALAR_CACHE>, C<LIST_CACHE> | |
15645 | ||
15646 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> | |
15647 | ||
15648 | =back | |
15649 | ||
15650 | =item OTHER FACILITIES | |
15651 | ||
15652 | =over 4 | |
15653 | ||
15654 | =item C<unmemoize> | |
15655 | ||
15656 | =item C<flush_cache> | |
15657 | ||
15658 | =back | |
15659 | ||
15660 | =item CAVEATS | |
15661 | ||
15662 | =item PERSISTENT CACHE SUPPORT | |
15663 | ||
15664 | =item EXPIRATION SUPPORT | |
15665 | ||
15666 | =item BUGS | |
15667 | ||
15668 | =item MAILING LIST | |
15669 | ||
15670 | =item AUTHOR | |
15671 | ||
15672 | =item COPYRIGHT AND LICENSE | |
15673 | ||
15674 | =item THANK YOU | |
15675 | ||
15676 | =back | |
15677 | ||
15678 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for | |
15679 | Storable use | |
15680 | ||
15681 | =over 4 | |
15682 | ||
15683 | =item DESCRIPTION | |
15684 | ||
15685 | =back | |
15686 | ||
15687 | =head2 Memoize::Expire - Plug-in module for automatic expiration of | |
15688 | memoized values | |
15689 | ||
15690 | =over 4 | |
15691 | ||
15692 | =item SYNOPSIS | |
15693 | ||
15694 | =item DESCRIPTION | |
15695 | ||
15696 | =item INTERFACE | |
15697 | ||
15698 | TIEHASH, EXISTS, STORE | |
15699 | ||
15700 | =item ALTERNATIVES | |
15701 | ||
15702 | =item CAVEATS | |
15703 | ||
15704 | =item AUTHOR | |
15705 | ||
15706 | =item SEE ALSO | |
15707 | ||
15708 | =back | |
15709 | ||
15710 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics | |
15711 | ||
15712 | =over 4 | |
15713 | ||
15714 | =item DESCRIPTION | |
15715 | ||
15716 | =back | |
15717 | ||
15718 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics | |
15719 | ||
15720 | =over 4 | |
15721 | ||
15722 | =item DESCRIPTION | |
15723 | ||
15724 | =back | |
15725 | ||
15726 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for | |
15727 | Storable use | |
15728 | ||
15729 | =over 4 | |
15730 | ||
15731 | =item DESCRIPTION | |
15732 | ||
15733 | =back | |
15734 | ||
15735 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for | |
15736 | Storable use | |
15737 | ||
15738 | =over 4 | |
15739 | ||
15740 | =item DESCRIPTION | |
15741 | ||
15742 | =back | |
15743 | ||
15744 | =head2 Memoize::Storable - store Memoized data in Storable database | |
15745 | ||
15746 | =over 4 | |
15747 | ||
15748 | =item DESCRIPTION | |
15749 | ||
15750 | =back | |
15751 | ||
15752 | =head2 NDBM_File - Tied access to ndbm files | |
15753 | ||
15754 | =over 4 | |
15755 | ||
15756 | =item SYNOPSIS | |
15757 | ||
15758 | =item DESCRIPTION | |
15759 | ||
15760 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
15761 | ||
15762 | =item DIAGNOSTICS | |
15763 | ||
15764 | =over 4 | |
15765 | ||
15766 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
15767 | ||
15768 | =back | |
15769 | ||
15770 | =item BUGS AND WARNINGS | |
15771 | ||
15772 | =back | |
15773 | ||
15774 | =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch | |
15775 | ||
15776 | =over 4 | |
15777 | ||
15778 | =item SYNOPSIS | |
15779 | ||
15780 | =item DESCRIPTION | |
15781 | ||
15782 | =over 4 | |
15783 | ||
15784 | =item Enforcing redispatch | |
15785 | ||
15786 | =item Avoiding repetitions | |
15787 | ||
15788 | =back | |
15789 | ||
15790 | =item AUTHOR | |
15791 | ||
15792 | =item BUGS AND IRRITATIONS | |
15793 | ||
15794 | =item COPYRIGHT | |
15795 | ||
15796 | =back | |
15797 | ||
15798 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) | |
15799 | ||
15800 | =over 4 | |
15801 | ||
15802 | =item SYNOPSIS | |
15803 | ||
15804 | =item DESCRIPTION | |
15805 | ||
15806 | =item USER METHODS | |
15807 | ||
15808 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), | |
15809 | dataend () | |
15810 | ||
15811 | =item CLASS METHODS | |
15812 | ||
15813 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... | |
15814 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), | |
15815 | ungetline ( TEXT ), read_until_dot (), tied_fh () | |
15816 | ||
15817 | =item EXPORTS | |
15818 | ||
15819 | =item AUTHOR | |
15820 | ||
15821 | =item COPYRIGHT | |
15822 | ||
15823 | =back | |
15824 | ||
15825 | =head2 Net::Config - Local configuration data for libnet | |
15826 | ||
15827 | =over 4 | |
15828 | ||
15829 | =item SYNOPSYS | |
15830 | ||
15831 | =item DESCRIPTION | |
15832 | ||
15833 | =item METHODS | |
15834 | ||
15835 | requires_firewall HOST | |
15836 | ||
15837 | =item NetConfig VALUES | |
15838 | ||
15839 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, | |
15840 | time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, | |
15841 | ftp_int_pasive, local_netmask, test_hosts, test_exists | |
15842 | ||
15843 | =back | |
15844 | ||
15845 | =head2 Net::Domain - Attempt to evaluate the current host's internet name | |
15846 | and domain | |
15847 | ||
15848 | =over 4 | |
15849 | ||
15850 | =item SYNOPSIS | |
15851 | ||
15852 | =item DESCRIPTION | |
15853 | ||
15854 | hostfqdn (), hostname (), hostdomain () | |
15855 | ||
15856 | =item AUTHOR | |
15857 | ||
15858 | =item COPYRIGHT | |
15859 | ||
15860 | =back | |
15861 | ||
15862 | =head2 Net::FTP - FTP Client class | |
15863 | ||
15864 | =over 4 | |
15865 | ||
15866 | =item SYNOPSIS | |
15867 | ||
15868 | =item DESCRIPTION | |
15869 | ||
15870 | =item OVERVIEW | |
15871 | ||
15872 | =item CONSTRUCTOR | |
15873 | ||
15874 | new (HOST [,OPTIONS]) | |
15875 | ||
15876 | =item METHODS | |
15877 | ||
15878 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), | |
15879 | site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) | |
15880 | ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME | |
15881 | ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ), | |
15882 | mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get ( | |
15883 | REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ] | |
15884 | ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [, | |
15885 | REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported ( | |
15886 | CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR | |
15887 | ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( | |
15888 | FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, | |
15889 | DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), | |
15890 | pasv_wait ( NON_PASV_SERVER ), abort (), quit () | |
15891 | ||
15892 | =over 4 | |
15893 | ||
15894 | =item Methods for the adventurous | |
15895 | ||
15896 | quot (CMD [,ARGS]) | |
15897 | ||
15898 | =back | |
15899 | ||
15900 | =item THE dataconn CLASS | |
15901 | ||
15902 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), | |
15903 | bytes_read (), abort (), close () | |
15904 | ||
15905 | =item UNIMPLEMENTED | |
15906 | ||
15907 | B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> | |
15908 | ||
15909 | =item REPORTING BUGS | |
15910 | ||
15911 | =item AUTHOR | |
15912 | ||
15913 | =item SEE ALSO | |
15914 | ||
15915 | =item USE EXAMPLES | |
15916 | ||
15917 | http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz | |
15918 | ||
15919 | =item CREDITS | |
15920 | ||
15921 | =item COPYRIGHT | |
15922 | ||
15923 | =back | |
15924 | ||
15925 | =head2 Net::NNTP - NNTP Client class | |
15926 | ||
15927 | =over 4 | |
15928 | ||
15929 | =item SYNOPSIS | |
15930 | ||
15931 | =item DESCRIPTION | |
15932 | ||
15933 | =item CONSTRUCTOR | |
15934 | ||
15935 | new ( [ HOST ] [, OPTIONS ]) | |
15936 | ||
15937 | =item METHODS | |
15938 | ||
15939 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( | |
15940 | [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ | |
15941 | MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] | |
15942 | ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), | |
15943 | postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, | |
15944 | DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), | |
15945 | post ( [ MESSAGE ] ), postfh (), slave (), quit () | |
15946 | ||
15947 | =over 4 | |
15948 | ||
15949 | =item Extension methods | |
15950 | ||
15951 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), | |
15952 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN | |
15953 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( | |
15954 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ | |
15955 | GROUP ] ), reader | |
15956 | ||
15957 | =back | |
15958 | ||
15959 | =item UNSUPPORTED | |
15960 | ||
15961 | =item DEFINITIONS | |
15962 | ||
15963 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> | |
15964 | ||
15965 | =item SEE ALSO | |
15966 | ||
15967 | =item AUTHOR | |
15968 | ||
15969 | =item COPYRIGHT | |
15970 | ||
15971 | =back | |
15972 | ||
15973 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) | |
15974 | ||
15975 | =over 4 | |
15976 | ||
15977 | =item SYNOPSIS | |
15978 | ||
15979 | =item DESCRIPTION | |
15980 | ||
15981 | =item EXAMPLES | |
15982 | ||
15983 | =item CONSTRUCTOR | |
15984 | ||
15985 | new ( [ HOST, ] [ OPTIONS ] ) | |
15986 | ||
15987 | =item METHODS | |
15988 | ||
15989 | user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [, | |
15990 | PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM | |
15991 | [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ | |
15992 | MSGNUM ] ), delete ( MSGNUM ), reset (), quit () | |
15993 | ||
15994 | =item NOTES | |
15995 | ||
15996 | =item SEE ALSO | |
15997 | ||
15998 | =item AUTHOR | |
15999 | ||
16000 | =item COPYRIGHT | |
16001 | ||
16002 | =back | |
16003 | ||
16004 | =head2 Net::Ping - check a remote host for reachability | |
16005 | ||
16006 | =over 4 | |
16007 | ||
16008 | =item SYNOPSIS | |
16009 | ||
16010 | =item DESCRIPTION | |
16011 | ||
16012 | =over 4 | |
16013 | ||
16014 | =item Functions | |
16015 | ||
16016 | Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, | |
16017 | $timeout]);, $p->source_verify( { 0 | 1 } );, $p->hires( { 0 | 1 } );, | |
16018 | $p->bind($local_addr);, $p->open($host);, $p->close();, pingecho($host [, | |
16019 | $timeout]); | |
16020 | ||
16021 | =back | |
16022 | ||
16023 | =item WARNING | |
16024 | ||
16025 | =item NOTES | |
16026 | ||
16027 | =item INSTALL | |
16028 | ||
16029 | =item AUTHORS | |
16030 | ||
16031 | =item COPYRIGHT | |
16032 | ||
16033 | =back | |
16034 | ||
16035 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client | |
16036 | ||
16037 | =over 4 | |
16038 | ||
16039 | =item SYNOPSIS | |
16040 | ||
16041 | =item DESCRIPTION | |
16042 | ||
16043 | =item EXAMPLES | |
16044 | ||
16045 | =item CONSTRUCTOR | |
16046 | ||
16047 | new Net::SMTP [ HOST, ] [ OPTIONS ] | |
16048 | ||
16049 | =item METHODS | |
16050 | ||
16051 | banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME, | |
16052 | PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail ( | |
16053 | ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [, | |
16054 | ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc ( | |
16055 | ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ | |
16056 | DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), | |
16057 | quit () | |
16058 | ||
16059 | =item ADDRESSES | |
16060 | ||
16061 | =item SEE ALSO | |
16062 | ||
16063 | =item AUTHOR | |
16064 | ||
16065 | =item COPYRIGHT | |
16066 | ||
16067 | =back | |
16068 | ||
16069 | =head2 Net::Time - time and daytime network client interface | |
16070 | ||
16071 | =over 4 | |
16072 | ||
16073 | =item SYNOPSIS | |
16074 | ||
16075 | =item DESCRIPTION | |
16076 | ||
16077 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, | |
16078 | PROTOCOL [, TIMEOUT]]]) | |
16079 | ||
16080 | =item AUTHOR | |
16081 | ||
16082 | =item COPYRIGHT | |
16083 | ||
16084 | =back | |
16085 | ||
16086 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() | |
16087 | functions | |
16088 | ||
16089 | =over 4 | |
16090 | ||
16091 | =item SYNOPSIS | |
16092 | ||
16093 | =item DESCRIPTION | |
16094 | ||
16095 | =item EXAMPLES | |
16096 | ||
16097 | =item NOTE | |
16098 | ||
16099 | =item AUTHOR | |
16100 | ||
16101 | =back | |
16102 | ||
16103 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions | |
16104 | ||
16105 | =over 4 | |
16106 | ||
16107 | =item DESCRIPTION | |
16108 | ||
16109 | =over 4 | |
16110 | ||
16111 | =item Where to get this document | |
16112 | ||
16113 | =item How to contribute to this document | |
16114 | ||
16115 | =back | |
16116 | ||
16117 | =item Author and Copyright Information | |
16118 | ||
16119 | =over 4 | |
16120 | ||
16121 | =item Disclaimer | |
16122 | ||
16123 | =back | |
16124 | ||
16125 | =item Obtaining and installing libnet | |
16126 | ||
16127 | =over 4 | |
16128 | ||
16129 | =item What is libnet ? | |
16130 | ||
16131 | =item Which version of perl do I need ? | |
16132 | ||
16133 | =item What other modules do I need ? | |
16134 | ||
16135 | =item What machines support libnet ? | |
16136 | ||
16137 | =item Where can I get the latest libnet release | |
16138 | ||
16139 | =back | |
16140 | ||
16141 | =item Using Net::FTP | |
16142 | ||
16143 | =over 4 | |
16144 | ||
16145 | =item How do I download files from an FTP server ? | |
16146 | ||
16147 | =item How do I transfer files in binary mode ? | |
16148 | ||
16149 | =item How can I get the size of a file on a remote FTP server ? | |
16150 | ||
16151 | =item How can I get the modification time of a file on a remote FTP server | |
16152 | ? | |
16153 | ||
16154 | =item How can I change the permissions of a file on a remote server ? | |
16155 | ||
16156 | =item Can I do a reget operation like the ftp command ? | |
16157 | ||
16158 | =item How do I get a directory listing from an FTP server ? | |
16159 | ||
16160 | =item Changing directory to "" does not fail ? | |
16161 | ||
16162 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? | |
16163 | ||
16164 | =item I am behind an FTP proxy firewall, but cannot access machines outside | |
16165 | ? | |
16166 | ||
16167 | =item My ftp proxy firewall does not listen on port 21 | |
16168 | ||
16169 | =item Is it possible to change the file permissions of a file on an FTP | |
16170 | server ? | |
16171 | ||
16172 | =item I have seen scripts call a method message, but cannot find it | |
16173 | documented ? | |
16174 | ||
16175 | =item Why does Net::FTP not implement mput and mget methods | |
16176 | ||
16177 | =back | |
16178 | ||
16179 | =item Using Net::SMTP | |
16180 | ||
16181 | =over 4 | |
16182 | ||
16183 | =item Why can't the part of an Email address after the @ be used as the | |
16184 | hostname ? | |
16185 | ||
16186 | =item Why does Net::SMTP not do DNS MX lookups ? | |
16187 | ||
16188 | =item The verify method always returns true ? | |
16189 | ||
16190 | =back | |
16191 | ||
16192 | =item Debugging scripts | |
16193 | ||
16194 | =over 4 | |
16195 | ||
16196 | =item How can I debug my scripts that use Net::* modules ? | |
16197 | ||
16198 | =back | |
16199 | ||
16200 | =item AUTHOR AND COPYRIGHT | |
16201 | ||
16202 | =back | |
16203 | ||
16204 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() | |
16205 | functions | |
16206 | ||
16207 | =over 4 | |
16208 | ||
16209 | =item SYNOPSIS | |
16210 | ||
16211 | =item DESCRIPTION | |
16212 | ||
16213 | =item EXAMPLES | |
16214 | ||
16215 | =item NOTE | |
16216 | ||
16217 | =item AUTHOR | |
16218 | ||
16219 | =back | |
16220 | ||
16221 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() | |
16222 | functions | |
16223 | ||
16224 | =over 4 | |
16225 | ||
16226 | =item SYNOPSIS | |
16227 | ||
16228 | =item DESCRIPTION | |
16229 | ||
16230 | =item NOTE | |
16231 | ||
16232 | =item AUTHOR | |
16233 | ||
16234 | =back | |
16235 | ||
16236 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() | |
16237 | functions | |
16238 | ||
16239 | =over 4 | |
16240 | ||
16241 | =item SYNOPSIS | |
16242 | ||
16243 | =item DESCRIPTION | |
16244 | ||
16245 | =item EXAMPLES | |
16246 | ||
16247 | =item NOTE | |
16248 | ||
16249 | =item AUTHOR | |
16250 | ||
16251 | =back | |
16252 | ||
16253 | =head2 Netrc, Net::Netrc - OO interface to users netrc file | |
16254 | ||
16255 | =over 4 | |
16256 | ||
16257 | =item SYNOPSIS | |
16258 | ||
16259 | =item DESCRIPTION | |
16260 | ||
16261 | =item THE .netrc FILE | |
16262 | ||
16263 | machine name, default, login name, password string, account string, macdef | |
16264 | name | |
16265 | ||
16266 | =item CONSTRUCTOR | |
16267 | ||
16268 | lookup ( MACHINE [, LOGIN ]) | |
16269 | ||
16270 | =item METHODS | |
16271 | ||
16272 | login (), password (), account (), lpa () | |
16273 | ||
16274 | =item AUTHOR | |
16275 | ||
16276 | =item SEE ALSO | |
16277 | ||
16278 | =item COPYRIGHT | |
16279 | ||
16280 | =back | |
16281 | ||
16282 | =head2 O - Generic interface to Perl Compiler backends | |
16283 | ||
16284 | =over 4 | |
16285 | ||
16286 | =item SYNOPSIS | |
16287 | ||
16288 | =item DESCRIPTION | |
16289 | ||
16290 | =item CONVENTIONS | |
16291 | ||
16292 | =item IMPLEMENTATION | |
16293 | ||
16294 | =item BUGS | |
16295 | ||
16296 | =item AUTHOR | |
16297 | ||
16298 | =back | |
16299 | ||
16300 | =head2 ODBM_File - Tied access to odbm files | |
16301 | ||
16302 | =over 4 | |
16303 | ||
16304 | =item SYNOPSIS | |
16305 | ||
16306 | =item DESCRIPTION | |
16307 | ||
16308 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
16309 | ||
16310 | =item DIAGNOSTICS | |
16311 | ||
16312 | =over 4 | |
16313 | ||
16314 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
16315 | ||
16316 | =back | |
16317 | ||
16318 | =item BUGS AND WARNINGS | |
16319 | ||
16320 | =back | |
16321 | ||
16322 | =head2 Opcode - Disable named opcodes when compiling perl code | |
16323 | ||
16324 | =over 4 | |
16325 | ||
16326 | =item SYNOPSIS | |
16327 | ||
16328 | =item DESCRIPTION | |
16329 | ||
16330 | =item NOTE | |
16331 | ||
16332 | =item WARNING | |
16333 | ||
16334 | =item Operator Names and Operator Lists | |
16335 | ||
16336 | an operator name (opname), an operator tag name (optag), a negated opname | |
16337 | or optag, an operator set (opset) | |
16338 | ||
16339 | =item Opcode Functions | |
16340 | ||
16341 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), | |
16342 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
16343 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
16344 | opdump (PAT) | |
16345 | ||
16346 | =item Manipulating Opsets | |
16347 | ||
16348 | =item TO DO (maybe) | |
16349 | ||
16350 | =back | |
16351 | ||
16352 | =over 4 | |
16353 | ||
16354 | =item Predefined Opcode Tags | |
16355 | ||
16356 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, | |
16357 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, | |
16358 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
16359 | :dangerous | |
16360 | ||
16361 | =item SEE ALSO | |
16362 | ||
16363 | =item AUTHORS | |
16364 | ||
16365 | =back | |
16366 | ||
16367 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted | |
16368 | compartments | |
16369 | ||
16370 | =over 4 | |
16371 | ||
16372 | =item SYNOPSIS | |
16373 | ||
16374 | =item DESCRIPTION | |
16375 | ||
16376 | a new namespace, an operator mask | |
16377 | ||
16378 | =item WARNING | |
16379 | ||
16380 | =over 4 | |
16381 | ||
16382 | =item RECENT CHANGES | |
16383 | ||
16384 | =item Methods in class Safe | |
16385 | ||
16386 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
16387 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
16388 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
16389 | root (NAMESPACE), mask (MASK) | |
16390 | ||
16391 | =item Some Safety Issues | |
16392 | ||
16393 | Memory, CPU, Snooping, Signals, State Changes | |
16394 | ||
16395 | =item AUTHOR | |
16396 | ||
16397 | =back | |
16398 | ||
16399 | =back | |
16400 | ||
16401 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when | |
16402 | compiling | |
16403 | ||
16404 | =over 4 | |
16405 | ||
16406 | =item SYNOPSIS | |
16407 | ||
16408 | =item DESCRIPTION | |
16409 | ||
16410 | =item SEE ALSO | |
16411 | ||
16412 | =back | |
16413 | ||
16414 | =head2 POSIX - Perl interface to IEEE Std 1003.1 | |
16415 | ||
16416 | =over 4 | |
16417 | ||
16418 | =item SYNOPSIS | |
16419 | ||
16420 | =item DESCRIPTION | |
16421 | ||
16422 | =item NOTE | |
16423 | ||
16424 | =item CAVEATS | |
16425 | ||
16426 | =item FUNCTIONS | |
16427 | ||
16428 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, | |
16429 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
16430 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
16431 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
16432 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
16433 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
16434 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
16435 | fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, | |
16436 | getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, | |
16437 | getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, | |
16438 | iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, | |
16439 | isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, | |
16440 | longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, | |
16441 | memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, | |
16442 | opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, | |
16443 | qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, | |
16444 | rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, | |
16445 | setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
16446 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
16447 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
16448 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, | |
16449 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
16450 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
16451 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
16452 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
16453 | wctomb, write | |
16454 | ||
16455 | =item CLASSES | |
16456 | ||
16457 | =over 4 | |
16458 | ||
16459 | =item POSIX::SigAction | |
16460 | ||
16461 | new | |
16462 | ||
16463 | =item POSIX::SigSet | |
16464 | ||
16465 | new, addset, delset, emptyset, fillset, ismember | |
16466 | ||
16467 | =item POSIX::Termios | |
16468 | ||
16469 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, | |
16470 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
16471 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
16472 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
16473 | values, c_oflag field values | |
16474 | ||
16475 | =back | |
16476 | ||
16477 | =item PATHNAME CONSTANTS | |
16478 | ||
16479 | Constants | |
16480 | ||
16481 | =item POSIX CONSTANTS | |
16482 | ||
16483 | Constants | |
16484 | ||
16485 | =item SYSTEM CONFIGURATION | |
16486 | ||
16487 | Constants | |
16488 | ||
16489 | =item ERRNO | |
16490 | ||
16491 | Constants | |
16492 | ||
16493 | =item FCNTL | |
16494 | ||
16495 | Constants | |
16496 | ||
16497 | =item FLOAT | |
16498 | ||
16499 | Constants | |
16500 | ||
16501 | =item LIMITS | |
16502 | ||
16503 | Constants | |
16504 | ||
16505 | =item LOCALE | |
16506 | ||
16507 | Constants | |
16508 | ||
16509 | =item MATH | |
16510 | ||
16511 | Constants | |
16512 | ||
16513 | =item SIGNAL | |
16514 | ||
16515 | Constants | |
16516 | ||
16517 | =item STAT | |
16518 | ||
16519 | Constants, Macros | |
16520 | ||
16521 | =item STDLIB | |
16522 | ||
16523 | Constants | |
16524 | ||
16525 | =item STDIO | |
16526 | ||
16527 | Constants | |
16528 | ||
16529 | =item TIME | |
16530 | ||
16531 | Constants | |
16532 | ||
16533 | =item UNISTD | |
16534 | ||
16535 | Constants | |
16536 | ||
16537 | =item WAIT | |
16538 | ||
16539 | Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, | |
16540 | WTERMSIG, WIFSTOPPED, WSTOPSIG | |
16541 | ||
16542 | =back | |
16543 | ||
16544 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* | |
16545 | name space | |
16546 | ||
16547 | =over 4 | |
16548 | ||
16549 | =item SYNOPSIS | |
16550 | ||
16551 | =item DESCRIPTION | |
16552 | ||
16553 | unix, stdio, perlio, crlf, utf8, bytes, raw, pop | |
16554 | ||
16555 | =over 4 | |
16556 | ||
16557 | =item Alternatives to raw | |
16558 | ||
16559 | =item Defaults and how to override them | |
16560 | ||
16561 | =back | |
16562 | ||
16563 | =item AUTHOR | |
16564 | ||
16565 | =item SEE ALSO | |
16566 | ||
16567 | =back | |
16568 | ||
16569 | =head2 PerlIO::encoding - encoding layer | |
16570 | ||
16571 | =over 4 | |
16572 | ||
16573 | =item SYNOPSIS | |
16574 | ||
16575 | =item DESCRIPTION | |
16576 | ||
16577 | =item SEE ALSO | |
16578 | ||
16579 | =back | |
16580 | ||
16581 | =head2 PerlIO::scalar - support module for in-memory IO. | |
16582 | ||
16583 | =over 4 | |
16584 | ||
16585 | =item SYNOPSIS | |
16586 | ||
16587 | =item DESCRIPTION | |
16588 | ||
16589 | =back | |
16590 | ||
16591 | =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl | |
16592 | ||
16593 | =over 4 | |
16594 | ||
16595 | =item SYNOPSIS | |
16596 | ||
16597 | =item DESCRIPTION | |
16598 | ||
16599 | =item EXPECTED METHODS | |
16600 | ||
16601 | $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), | |
16602 | $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]), | |
16603 | $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]), | |
16604 | $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), | |
16605 | $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), | |
16606 | $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), | |
16607 | $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh), | |
16608 | $obj->EOF($fh) | |
16609 | ||
16610 | =item EXAMPLES | |
16611 | ||
16612 | =over 4 | |
16613 | ||
16614 | =item Example - a Hexadecimal Handle | |
16615 | ||
16616 | =back | |
16617 | ||
16618 | =back | |
16619 | ||
16620 | =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings | |
16621 | ||
16622 | =over 4 | |
16623 | ||
16624 | =item SYNOPSIS | |
16625 | ||
16626 | =item DESCRIPTION | |
16627 | ||
16628 | =item SEE ALSO | |
16629 | ||
16630 | =item COPYRIGHT | |
16631 | ||
16632 | =back | |
16633 | ||
16634 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors | |
16635 | ||
16636 | =over 4 | |
16637 | ||
16638 | =item SYNOPSIS | |
16639 | ||
16640 | =item OPTIONS/ARGUMENTS | |
16641 | ||
16642 | =over 4 | |
16643 | ||
16644 | =item podchecker() | |
16645 | ||
16646 | B<-warnings> =E<gt> I<val> | |
16647 | ||
16648 | =back | |
16649 | ||
16650 | =item DESCRIPTION | |
16651 | ||
16652 | =item DIAGNOSTICS | |
16653 | ||
16654 | =over 4 | |
16655 | ||
16656 | =item Errors | |
16657 | ||
16658 | empty =headn, =over on line I<N> without closing =back, =item without | |
16659 | previous =over, =back without previous =over, No argument for =begin, =end | |
16660 | without =begin, Nested =begin's, =for without formatter specification, | |
16661 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
16662 | interior-sequence "I<SEQ>", nested commands | |
16663 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
16664 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
16665 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
16666 | after =back | |
16667 | ||
16668 | =item Warnings | |
16669 | ||
16670 | multiple occurrence of link target I<name>, line containing nothing but | |
16671 | whitespace in paragraph, file does not start with =head, previous =item has | |
16672 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> | |
16673 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No | |
16674 | items in =over, No argument for =item, empty section in previous paragraph, | |
16675 | Verbatim paragraph in NAME section | |
16676 | ||
16677 | =item Hyperlinks | |
16678 | ||
16679 | ignoring leading/trailing whitespace in link, (section) in '$page' | |
16680 | deprecated, alternative text/node '%s' contains non-escaped | or / | |
16681 | ||
16682 | =back | |
16683 | ||
16684 | =item RETURN VALUE | |
16685 | ||
16686 | =item EXAMPLES | |
16687 | ||
16688 | =item INTERFACE | |
16689 | ||
16690 | =back | |
16691 | ||
16692 | C<Pod::Checker-E<gt>new( %options )> | |
16693 | ||
16694 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, | |
16695 | @args )> | |
16696 | ||
16697 | C<$checker-E<gt>num_errors()> | |
16698 | ||
16699 | C<$checker-E<gt>name()> | |
16700 | ||
16701 | C<$checker-E<gt>node()> | |
16702 | ||
16703 | C<$checker-E<gt>idx()> | |
16704 | ||
16705 | C<$checker-E<gt>hyperlink()> | |
16706 | ||
16707 | =over 4 | |
16708 | ||
16709 | =item AUTHOR | |
16710 | ||
16711 | =back | |
16712 | ||
16713 | =head2 Pod::Find - find POD documents in directory trees | |
16714 | ||
16715 | =over 4 | |
16716 | ||
16717 | =item SYNOPSIS | |
16718 | ||
16719 | =item DESCRIPTION | |
16720 | ||
16721 | =back | |
16722 | ||
16723 | =over 4 | |
16724 | ||
16725 | =item C<pod_find( { %opts } , @directories )> | |
16726 | ||
16727 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> | |
16728 | 1> | |
16729 | ||
16730 | =back | |
16731 | ||
16732 | =over 4 | |
16733 | ||
16734 | =item C<simplify_name( $str )> | |
16735 | ||
16736 | =back | |
16737 | ||
16738 | =over 4 | |
16739 | ||
16740 | =item C<pod_where( { %opts }, $pod )> | |
16741 | ||
16742 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
16743 | 1> | |
16744 | ||
16745 | =back | |
16746 | ||
16747 | =over 4 | |
16748 | ||
16749 | =item C<contains_pod( $file , $verbose )> | |
16750 | ||
16751 | =back | |
16752 | ||
16753 | =over 4 | |
16754 | ||
16755 | =item AUTHOR | |
16756 | ||
16757 | =item SEE ALSO | |
16758 | ||
16759 | =back | |
16760 | ||
16761 | =head2 Pod::Html - module to convert pod files to HTML | |
16762 | ||
16763 | =over 4 | |
16764 | ||
16765 | =item SYNOPSIS | |
16766 | ||
16767 | =item DESCRIPTION | |
16768 | ||
16769 | =item ARGUMENTS | |
16770 | ||
16771 | backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, | |
16772 | infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, | |
16773 | title, verbose | |
16774 | ||
16775 | =item EXAMPLE | |
16776 | ||
16777 | =item ENVIRONMENT | |
16778 | ||
16779 | =item AUTHOR | |
16780 | ||
16781 | =item SEE ALSO | |
16782 | ||
16783 | =item COPYRIGHT | |
16784 | ||
16785 | =back | |
16786 | ||
16787 | =head2 Pod::InputObjects - objects representing POD input paragraphs, | |
16788 | commands, etc. | |
16789 | ||
16790 | =over 4 | |
16791 | ||
16792 | =item SYNOPSIS | |
16793 | ||
16794 | =item REQUIRES | |
16795 | ||
16796 | =item EXPORTS | |
16797 | ||
16798 | =item DESCRIPTION | |
16799 | ||
16800 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package | |
16801 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
16802 | ||
16803 | =back | |
16804 | ||
16805 | =over 4 | |
16806 | ||
16807 | =item B<Pod::InputSource> | |
16808 | ||
16809 | =back | |
16810 | ||
16811 | =over 4 | |
16812 | ||
16813 | =item B<new()> | |
16814 | ||
16815 | =back | |
16816 | ||
16817 | =over 4 | |
16818 | ||
16819 | =item B<name()> | |
16820 | ||
16821 | =back | |
16822 | ||
16823 | =over 4 | |
16824 | ||
16825 | =item B<handle()> | |
16826 | ||
16827 | =back | |
16828 | ||
16829 | =over 4 | |
16830 | ||
16831 | =item B<was_cutting()> | |
16832 | ||
16833 | =back | |
16834 | ||
16835 | =over 4 | |
16836 | ||
16837 | =item B<Pod::Paragraph> | |
16838 | ||
16839 | =back | |
16840 | ||
16841 | =over 4 | |
16842 | ||
16843 | =item Pod::Paragraph-E<gt>B<new()> | |
16844 | ||
16845 | =back | |
16846 | ||
16847 | =over 4 | |
16848 | ||
16849 | =item $pod_para-E<gt>B<cmd_name()> | |
16850 | ||
16851 | =back | |
16852 | ||
16853 | =over 4 | |
16854 | ||
16855 | =item $pod_para-E<gt>B<text()> | |
16856 | ||
16857 | =back | |
16858 | ||
16859 | =over 4 | |
16860 | ||
16861 | =item $pod_para-E<gt>B<raw_text()> | |
16862 | ||
16863 | =back | |
16864 | ||
16865 | =over 4 | |
16866 | ||
16867 | =item $pod_para-E<gt>B<cmd_prefix()> | |
16868 | ||
16869 | =back | |
16870 | ||
16871 | =over 4 | |
16872 | ||
16873 | =item $pod_para-E<gt>B<cmd_separator()> | |
16874 | ||
16875 | =back | |
16876 | ||
16877 | =over 4 | |
16878 | ||
16879 | =item $pod_para-E<gt>B<parse_tree()> | |
16880 | ||
16881 | =back | |
16882 | ||
16883 | =over 4 | |
16884 | ||
16885 | =item $pod_para-E<gt>B<file_line()> | |
16886 | ||
16887 | =back | |
16888 | ||
16889 | =over 4 | |
16890 | ||
16891 | =item B<Pod::InteriorSequence> | |
16892 | ||
16893 | =back | |
16894 | ||
16895 | =over 4 | |
16896 | ||
16897 | =item Pod::InteriorSequence-E<gt>B<new()> | |
16898 | ||
16899 | =back | |
16900 | ||
16901 | =over 4 | |
16902 | ||
16903 | =item $pod_seq-E<gt>B<cmd_name()> | |
16904 | ||
16905 | =back | |
16906 | ||
16907 | =over 4 | |
16908 | ||
16909 | =item $pod_seq-E<gt>B<prepend()> | |
16910 | ||
16911 | =back | |
16912 | ||
16913 | =over 4 | |
16914 | ||
16915 | =item $pod_seq-E<gt>B<append()> | |
16916 | ||
16917 | =back | |
16918 | ||
16919 | =over 4 | |
16920 | ||
16921 | =item $pod_seq-E<gt>B<nested()> | |
16922 | ||
16923 | =back | |
16924 | ||
16925 | =over 4 | |
16926 | ||
16927 | =item $pod_seq-E<gt>B<raw_text()> | |
16928 | ||
16929 | =back | |
16930 | ||
16931 | =over 4 | |
16932 | ||
16933 | =item $pod_seq-E<gt>B<left_delimiter()> | |
16934 | ||
16935 | =back | |
16936 | ||
16937 | =over 4 | |
16938 | ||
16939 | =item $pod_seq-E<gt>B<right_delimiter()> | |
16940 | ||
16941 | =back | |
16942 | ||
16943 | =over 4 | |
16944 | ||
16945 | =item $pod_seq-E<gt>B<parse_tree()> | |
16946 | ||
16947 | =back | |
16948 | ||
16949 | =over 4 | |
16950 | ||
16951 | =item $pod_seq-E<gt>B<file_line()> | |
16952 | ||
16953 | =back | |
16954 | ||
16955 | =over 4 | |
16956 | ||
16957 | =item Pod::InteriorSequence::B<DESTROY()> | |
16958 | ||
16959 | =back | |
16960 | ||
16961 | =over 4 | |
16962 | ||
16963 | =item B<Pod::ParseTree> | |
16964 | ||
16965 | =back | |
16966 | ||
16967 | =over 4 | |
16968 | ||
16969 | =item Pod::ParseTree-E<gt>B<new()> | |
16970 | ||
16971 | =back | |
16972 | ||
16973 | =over 4 | |
16974 | ||
16975 | =item $ptree-E<gt>B<top()> | |
16976 | ||
16977 | =back | |
16978 | ||
16979 | =over 4 | |
16980 | ||
16981 | =item $ptree-E<gt>B<children()> | |
16982 | ||
16983 | =back | |
16984 | ||
16985 | =over 4 | |
16986 | ||
16987 | =item $ptree-E<gt>B<prepend()> | |
16988 | ||
16989 | =back | |
16990 | ||
16991 | =over 4 | |
16992 | ||
16993 | =item $ptree-E<gt>B<append()> | |
16994 | ||
16995 | =back | |
16996 | ||
16997 | =over 4 | |
16998 | ||
16999 | =item $ptree-E<gt>B<raw_text()> | |
17000 | ||
17001 | =back | |
17002 | ||
17003 | =over 4 | |
17004 | ||
17005 | =item Pod::ParseTree::B<DESTROY()> | |
17006 | ||
17007 | =back | |
17008 | ||
17009 | =over 4 | |
17010 | ||
17011 | =item SEE ALSO | |
17012 | ||
17013 | =item AUTHOR | |
17014 | ||
17015 | =back | |
17016 | ||
17017 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex | |
17018 | ||
17019 | =over 4 | |
17020 | ||
17021 | =item SYNOPSIS | |
17022 | ||
17023 | =item DESCRIPTION | |
17024 | ||
17025 | =back | |
17026 | ||
17027 | =over 4 | |
17028 | ||
17029 | =item OBJECT METHODS | |
17030 | ||
17031 | C<initialize> | |
17032 | ||
17033 | =back | |
17034 | ||
17035 | =over 4 | |
17036 | ||
17037 | =item Data Accessors | |
17038 | ||
17039 | B<AddPreamble> | |
17040 | ||
17041 | =back | |
17042 | ||
17043 | B<AddPostamble> | |
17044 | ||
17045 | B<Head1Level> | |
17046 | ||
17047 | B<Label> | |
17048 | ||
17049 | B<LevelNoNum> | |
17050 | ||
17051 | B<MakeIndex> | |
17052 | ||
17053 | B<ReplaceNAMEwithSection> | |
17054 | ||
17055 | B<StartWithNewPage> | |
17056 | ||
17057 | B<TableOfContents> | |
17058 | ||
17059 | B<UniqueLabels> | |
17060 | ||
17061 | B<UserPreamble> | |
17062 | ||
17063 | B<UserPostamble> | |
17064 | ||
17065 | B<Lists> | |
17066 | ||
17067 | =over 4 | |
17068 | ||
17069 | =item Subclassed methods | |
17070 | ||
17071 | =back | |
17072 | ||
17073 | B<begin_pod> | |
17074 | ||
17075 | B<end_pod> | |
17076 | ||
17077 | B<command> | |
17078 | ||
17079 | B<verbatim> | |
17080 | ||
17081 | B<textblock> | |
17082 | ||
17083 | B<interior_sequence> | |
17084 | ||
17085 | =over 4 | |
17086 | ||
17087 | =item List Methods | |
17088 | ||
17089 | B<begin_list> | |
17090 | ||
17091 | =back | |
17092 | ||
17093 | B<end_list> | |
17094 | ||
17095 | B<add_item> | |
17096 | ||
17097 | =over 4 | |
17098 | ||
17099 | =item Methods for headings | |
17100 | ||
17101 | B<head> | |
17102 | ||
17103 | =back | |
17104 | ||
17105 | =over 4 | |
17106 | ||
17107 | =item Internal methods | |
17108 | ||
17109 | B<_output> | |
17110 | ||
17111 | =back | |
17112 | ||
17113 | B<_replace_special_chars> | |
17114 | ||
17115 | B<_replace_special_chars_late> | |
17116 | ||
17117 | B<_create_label> | |
17118 | ||
17119 | B<_create_index> | |
17120 | ||
17121 | B<_clean_latex_commands> | |
17122 | ||
17123 | B<_split_delimited> | |
17124 | ||
17125 | =over 4 | |
17126 | ||
17127 | =item NOTES | |
17128 | ||
17129 | =item SEE ALSO | |
17130 | ||
17131 | =item AUTHORS | |
17132 | ||
17133 | =item COPYRIGHT | |
17134 | ||
17135 | =item REVISION | |
17136 | ||
17137 | =back | |
17138 | ||
17139 | =head2 Pod::Man - Convert POD data to formatted *roff input | |
17140 | ||
17141 | =over 4 | |
17142 | ||
17143 | =item SYNOPSIS | |
17144 | ||
17145 | =item DESCRIPTION | |
17146 | ||
17147 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, | |
17148 | release, section | |
17149 | ||
17150 | =item DIAGNOSTICS | |
17151 | ||
17152 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote | |
17153 | specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown | |
17154 | escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched | |
17155 | =back | |
17156 | ||
17157 | =item BUGS | |
17158 | ||
17159 | =item CAVEATS | |
17160 | ||
17161 | =item SEE ALSO | |
17162 | ||
17163 | =item AUTHOR | |
17164 | ||
17165 | =item COPYRIGHT AND LICENSE | |
17166 | ||
17167 | =back | |
17168 | ||
17169 | =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text | |
17170 | ||
17171 | =over 4 | |
17172 | ||
17173 | =item SYNOPSIS | |
17174 | ||
17175 | =item DESCRIPTION | |
17176 | ||
17177 | =item SEE ALSO | |
17178 | ||
17179 | =item AUTHOR | |
17180 | ||
17181 | =item COPYRIGHT AND LICENSE | |
17182 | ||
17183 | =back | |
17184 | ||
17185 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion | |
17186 | ||
17187 | =over 4 | |
17188 | ||
17189 | =item SYNOPSIS | |
17190 | ||
17191 | =item DESCRIPTION | |
17192 | ||
17193 | =back | |
17194 | ||
17195 | =over 4 | |
17196 | ||
17197 | =item Pod::List | |
17198 | ||
17199 | Pod::List-E<gt>new() | |
17200 | ||
17201 | =back | |
17202 | ||
17203 | $list-E<gt>file() | |
17204 | ||
17205 | $list-E<gt>start() | |
17206 | ||
17207 | $list-E<gt>indent() | |
17208 | ||
17209 | $list-E<gt>type() | |
17210 | ||
17211 | $list-E<gt>rx() | |
17212 | ||
17213 | $list-E<gt>item() | |
17214 | ||
17215 | $list-E<gt>parent() | |
17216 | ||
17217 | $list-E<gt>tag() | |
17218 | ||
17219 | =over 4 | |
17220 | ||
17221 | =item Pod::Hyperlink | |
17222 | ||
17223 | Pod::Hyperlink-E<gt>new() | |
17224 | ||
17225 | =back | |
17226 | ||
17227 | $link-E<gt>parse($string) | |
17228 | ||
17229 | $link-E<gt>markup($string) | |
17230 | ||
17231 | $link-E<gt>text() | |
17232 | ||
17233 | $link-E<gt>warning() | |
17234 | ||
17235 | $link-E<gt>file(), $link-E<gt>line() | |
17236 | ||
17237 | $link-E<gt>page() | |
17238 | ||
17239 | $link-E<gt>node() | |
17240 | ||
17241 | $link-E<gt>alttext() | |
17242 | ||
17243 | $link-E<gt>type() | |
17244 | ||
17245 | $link-E<gt>link() | |
17246 | ||
17247 | =over 4 | |
17248 | ||
17249 | =item Pod::Cache | |
17250 | ||
17251 | Pod::Cache-E<gt>new() | |
17252 | ||
17253 | =back | |
17254 | ||
17255 | $cache-E<gt>item() | |
17256 | ||
17257 | $cache-E<gt>find_page($name) | |
17258 | ||
17259 | =over 4 | |
17260 | ||
17261 | =item Pod::Cache::Item | |
17262 | ||
17263 | Pod::Cache::Item-E<gt>new() | |
17264 | ||
17265 | =back | |
17266 | ||
17267 | $cacheitem-E<gt>page() | |
17268 | ||
17269 | $cacheitem-E<gt>description() | |
17270 | ||
17271 | $cacheitem-E<gt>path() | |
17272 | ||
17273 | $cacheitem-E<gt>file() | |
17274 | ||
17275 | $cacheitem-E<gt>nodes() | |
17276 | ||
17277 | $cacheitem-E<gt>find_node($name) | |
17278 | ||
17279 | $cacheitem-E<gt>idx() | |
17280 | ||
17281 | =over 4 | |
17282 | ||
17283 | =item AUTHOR | |
17284 | ||
17285 | =item SEE ALSO | |
17286 | ||
17287 | =back | |
17288 | ||
17289 | =head2 Pod::Parser - base class for creating POD filters and translators | |
17290 | ||
17291 | =over 4 | |
17292 | ||
17293 | =item SYNOPSIS | |
17294 | ||
17295 | =item REQUIRES | |
17296 | ||
17297 | =item EXPORTS | |
17298 | ||
17299 | =item DESCRIPTION | |
17300 | ||
17301 | =item QUICK OVERVIEW | |
17302 | ||
17303 | =item PARSING OPTIONS | |
17304 | ||
17305 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), | |
17306 | B<-warnings> (default: unset) | |
17307 | ||
17308 | =back | |
17309 | ||
17310 | =over 4 | |
17311 | ||
17312 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES | |
17313 | ||
17314 | =back | |
17315 | ||
17316 | =over 4 | |
17317 | ||
17318 | =item B<command()> | |
17319 | ||
17320 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
17321 | ||
17322 | =back | |
17323 | ||
17324 | =over 4 | |
17325 | ||
17326 | =item B<verbatim()> | |
17327 | ||
17328 | C<$text>, C<$line_num>, C<$pod_para> | |
17329 | ||
17330 | =back | |
17331 | ||
17332 | =over 4 | |
17333 | ||
17334 | =item B<textblock()> | |
17335 | ||
17336 | C<$text>, C<$line_num>, C<$pod_para> | |
17337 | ||
17338 | =back | |
17339 | ||
17340 | =over 4 | |
17341 | ||
17342 | =item B<interior_sequence()> | |
17343 | ||
17344 | =back | |
17345 | ||
17346 | =over 4 | |
17347 | ||
17348 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES | |
17349 | ||
17350 | =back | |
17351 | ||
17352 | =over 4 | |
17353 | ||
17354 | =item B<new()> | |
17355 | ||
17356 | =back | |
17357 | ||
17358 | =over 4 | |
17359 | ||
17360 | =item B<initialize()> | |
17361 | ||
17362 | =back | |
17363 | ||
17364 | =over 4 | |
17365 | ||
17366 | =item B<begin_pod()> | |
17367 | ||
17368 | =back | |
17369 | ||
17370 | =over 4 | |
17371 | ||
17372 | =item B<begin_input()> | |
17373 | ||
17374 | =back | |
17375 | ||
17376 | =over 4 | |
17377 | ||
17378 | =item B<end_input()> | |
17379 | ||
17380 | =back | |
17381 | ||
17382 | =over 4 | |
17383 | ||
17384 | =item B<end_pod()> | |
17385 | ||
17386 | =back | |
17387 | ||
17388 | =over 4 | |
17389 | ||
17390 | =item B<preprocess_line()> | |
17391 | ||
17392 | =back | |
17393 | ||
17394 | =over 4 | |
17395 | ||
17396 | =item B<preprocess_paragraph()> | |
17397 | ||
17398 | =back | |
17399 | ||
17400 | =over 4 | |
17401 | ||
17402 | =item METHODS FOR PARSING AND PROCESSING | |
17403 | ||
17404 | =back | |
17405 | ||
17406 | =over 4 | |
17407 | ||
17408 | =item B<parse_text()> | |
17409 | ||
17410 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> | |
17411 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
17412 | I<code-ref>|I<method-name> | |
17413 | ||
17414 | =back | |
17415 | ||
17416 | =over 4 | |
17417 | ||
17418 | =item B<interpolate()> | |
17419 | ||
17420 | =back | |
17421 | ||
17422 | =over 4 | |
17423 | ||
17424 | =item B<parse_paragraph()> | |
17425 | ||
17426 | =back | |
17427 | ||
17428 | =over 4 | |
17429 | ||
17430 | =item B<parse_from_filehandle()> | |
17431 | ||
17432 | =back | |
17433 | ||
17434 | =over 4 | |
17435 | ||
17436 | =item B<parse_from_file()> | |
17437 | ||
17438 | =back | |
17439 | ||
17440 | =over 4 | |
17441 | ||
17442 | =item ACCESSOR METHODS | |
17443 | ||
17444 | =back | |
17445 | ||
17446 | =over 4 | |
17447 | ||
17448 | =item B<errorsub()> | |
17449 | ||
17450 | =back | |
17451 | ||
17452 | =over 4 | |
17453 | ||
17454 | =item B<cutting()> | |
17455 | ||
17456 | =back | |
17457 | ||
17458 | =over 4 | |
17459 | ||
17460 | =item B<parseopts()> | |
17461 | ||
17462 | =back | |
17463 | ||
17464 | =over 4 | |
17465 | ||
17466 | =item B<output_file()> | |
17467 | ||
17468 | =back | |
17469 | ||
17470 | =over 4 | |
17471 | ||
17472 | =item B<output_handle()> | |
17473 | ||
17474 | =back | |
17475 | ||
17476 | =over 4 | |
17477 | ||
17478 | =item B<input_file()> | |
17479 | ||
17480 | =back | |
17481 | ||
17482 | =over 4 | |
17483 | ||
17484 | =item B<input_handle()> | |
17485 | ||
17486 | =back | |
17487 | ||
17488 | =over 4 | |
17489 | ||
17490 | =item B<input_streams()> | |
17491 | ||
17492 | =back | |
17493 | ||
17494 | =over 4 | |
17495 | ||
17496 | =item B<top_stream()> | |
17497 | ||
17498 | =back | |
17499 | ||
17500 | =over 4 | |
17501 | ||
17502 | =item PRIVATE METHODS AND DATA | |
17503 | ||
17504 | =back | |
17505 | ||
17506 | =over 4 | |
17507 | ||
17508 | =item B<_push_input_stream()> | |
17509 | ||
17510 | =back | |
17511 | ||
17512 | =over 4 | |
17513 | ||
17514 | =item B<_pop_input_stream()> | |
17515 | ||
17516 | =back | |
17517 | ||
17518 | =over 4 | |
17519 | ||
17520 | =item TREE-BASED PARSING | |
17521 | ||
17522 | =item SEE ALSO | |
17523 | ||
17524 | =item AUTHOR | |
17525 | ||
17526 | =back | |
17527 | ||
17528 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. | |
17529 | ||
17530 | =over 4 | |
17531 | ||
17532 | =item SYNOPSIS | |
17533 | ||
17534 | =item DESCRIPTION | |
17535 | ||
17536 | =over 4 | |
17537 | ||
17538 | =item EXPORT | |
17539 | ||
17540 | =back | |
17541 | ||
17542 | =item AUTHOR | |
17543 | ||
17544 | =item SEE ALSO | |
17545 | ||
17546 | =back | |
17547 | ||
17548 | =head2 Pod::Select, podselect() - extract selected sections of POD from | |
17549 | input | |
17550 | ||
17551 | =over 4 | |
17552 | ||
17553 | =item SYNOPSIS | |
17554 | ||
17555 | =item REQUIRES | |
17556 | ||
17557 | =item EXPORTS | |
17558 | ||
17559 | =item DESCRIPTION | |
17560 | ||
17561 | =item SECTION SPECIFICATIONS | |
17562 | ||
17563 | =item RANGE SPECIFICATIONS | |
17564 | ||
17565 | =back | |
17566 | ||
17567 | =over 4 | |
17568 | ||
17569 | =item OBJECT METHODS | |
17570 | ||
17571 | =back | |
17572 | ||
17573 | =over 4 | |
17574 | ||
17575 | =item B<curr_headings()> | |
17576 | ||
17577 | =back | |
17578 | ||
17579 | =over 4 | |
17580 | ||
17581 | =item B<select()> | |
17582 | ||
17583 | =back | |
17584 | ||
17585 | =over 4 | |
17586 | ||
17587 | =item B<add_selection()> | |
17588 | ||
17589 | =back | |
17590 | ||
17591 | =over 4 | |
17592 | ||
17593 | =item B<clear_selections()> | |
17594 | ||
17595 | =back | |
17596 | ||
17597 | =over 4 | |
17598 | ||
17599 | =item B<match_section()> | |
17600 | ||
17601 | =back | |
17602 | ||
17603 | =over 4 | |
17604 | ||
17605 | =item B<is_selected()> | |
17606 | ||
17607 | =back | |
17608 | ||
17609 | =over 4 | |
17610 | ||
17611 | =item EXPORTED FUNCTIONS | |
17612 | ||
17613 | =back | |
17614 | ||
17615 | =over 4 | |
17616 | ||
17617 | =item B<podselect()> | |
17618 | ||
17619 | B<-output>, B<-sections>, B<-ranges> | |
17620 | ||
17621 | =back | |
17622 | ||
17623 | =over 4 | |
17624 | ||
17625 | =item PRIVATE METHODS AND DATA | |
17626 | ||
17627 | =back | |
17628 | ||
17629 | =over 4 | |
17630 | ||
17631 | =item B<_compile_section_spec()> | |
17632 | ||
17633 | =back | |
17634 | ||
17635 | =over 4 | |
17636 | ||
17637 | =item $self->{_SECTION_HEADINGS} | |
17638 | ||
17639 | =back | |
17640 | ||
17641 | =over 4 | |
17642 | ||
17643 | =item $self->{_SELECTED_SECTIONS} | |
17644 | ||
17645 | =back | |
17646 | ||
17647 | =over 4 | |
17648 | ||
17649 | =item SEE ALSO | |
17650 | ||
17651 | =item AUTHOR | |
17652 | ||
17653 | =back | |
17654 | ||
17655 | =head2 Pod::Text - Convert POD data to formatted ASCII text | |
17656 | ||
17657 | =over 4 | |
17658 | ||
17659 | =item SYNOPSIS | |
17660 | ||
17661 | =item DESCRIPTION | |
17662 | ||
17663 | alt, code, indent, loose, quotes, sentence, width | |
17664 | ||
17665 | =item DIAGNOSTICS | |
17666 | ||
17667 | Bizarre space in item, Item called without tag, Can't open %s for reading: | |
17668 | %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, | |
17669 | %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: | |
17670 | Unmatched =back | |
17671 | ||
17672 | =item RESTRICTIONS | |
17673 | ||
17674 | =item NOTES | |
17675 | ||
17676 | =item SEE ALSO | |
17677 | ||
17678 | =item AUTHOR | |
17679 | ||
17680 | =item COPYRIGHT AND LICENSE | |
17681 | ||
17682 | =back | |
17683 | ||
17684 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text | |
17685 | ||
17686 | =over 4 | |
17687 | ||
17688 | =item SYNOPSIS | |
17689 | ||
17690 | =item DESCRIPTION | |
17691 | ||
17692 | =item BUGS | |
17693 | ||
17694 | =item SEE ALSO | |
17695 | ||
17696 | =item AUTHOR | |
17697 | ||
17698 | =item COPYRIGHT AND LICENSE | |
17699 | ||
17700 | =back | |
17701 | ||
17702 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike | |
17703 | text | |
17704 | ||
17705 | =over 4 | |
17706 | ||
17707 | =item SYNOPSIS | |
17708 | ||
17709 | =item DESCRIPTION | |
17710 | ||
17711 | =item BUGS | |
17712 | ||
17713 | =item SEE ALSO | |
17714 | ||
17715 | =item AUTHOR | |
17716 | ||
17717 | =item COPYRIGHT AND LICENSE | |
17718 | ||
17719 | =back | |
17720 | ||
17721 | =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format | |
17722 | escapes | |
17723 | ||
17724 | =over 4 | |
17725 | ||
17726 | =item SYNOPSIS | |
17727 | ||
17728 | =item DESCRIPTION | |
17729 | ||
17730 | =item NOTES | |
17731 | ||
17732 | =item SEE ALSO | |
17733 | ||
17734 | =item AUTHOR | |
17735 | ||
17736 | =item COPYRIGHT AND LICENSE | |
17737 | ||
17738 | =back | |
17739 | ||
17740 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod | |
17741 | documentation | |
17742 | ||
17743 | =over 4 | |
17744 | ||
17745 | =item SYNOPSIS | |
17746 | ||
17747 | =item ARGUMENTS | |
17748 | ||
17749 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
17750 | C<-pathlist> | |
17751 | ||
17752 | =item DESCRIPTION | |
17753 | ||
17754 | =item EXAMPLES | |
17755 | ||
17756 | =over 4 | |
17757 | ||
17758 | =item Recommended Use | |
17759 | ||
17760 | =back | |
17761 | ||
17762 | =item CAVEATS | |
17763 | ||
17764 | =item AUTHOR | |
17765 | ||
17766 | =item ACKNOWLEDGEMENTS | |
17767 | ||
17768 | =back | |
17769 | ||
17770 | =head2 Pod::t::basic, basic.pod - Test of various basic POD features in | |
17771 | translators. | |
17772 | ||
17773 | =over 4 | |
17774 | ||
17775 | =item HEADINGS | |
17776 | ||
17777 | =item This C<is> a "level 1" heading | |
17778 | ||
17779 | =over 4 | |
17780 | ||
17781 | =item ``Level'' "2 I<heading> | |
17782 | ||
17783 | =back | |
17784 | ||
17785 | =item This C<is> a "level 1" heading | |
17786 | ||
17787 | =over 4 | |
17788 | ||
17789 | =item ``Level'' 2 I<heading> | |
17790 | ||
17791 | =back | |
17792 | ||
17793 | =item LINKS | |
17794 | ||
17795 | =item OVER AND ITEMS | |
17796 | ||
17797 | This is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item | |
17798 | text | |
17799 | ||
17800 | =item FORMATTING CODES | |
17801 | ||
17802 | E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol> | |
17803 | ||
17804 | =item VERBATIM | |
17805 | ||
17806 | =item CONCLUSION | |
17807 | ||
17808 | =back | |
17809 | ||
17810 | =head2 Pod::t::htmlescp, Escape Sequences Test | |
17811 | ||
17812 | =over 4 | |
17813 | ||
17814 | =item DESCRIPTION | |
17815 | ||
17816 | =back | |
17817 | ||
17818 | =head2 Pod::t::htmlview, Test HTML Rendering | |
17819 | ||
17820 | =over 4 | |
17821 | ||
17822 | =item SYNOPSIS | |
17823 | ||
17824 | =item DESCRIPTION | |
17825 | ||
17826 | =item METHODS =E<gt> OTHER STUFF | |
17827 | ||
17828 | =over 4 | |
17829 | ||
17830 | =item new() | |
17831 | ||
17832 | foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2 | |
17833 | Sat, 3 Mat | |
17834 | ||
17835 | =item old() | |
17836 | ||
17837 | =back | |
17838 | ||
17839 | =item TESTING FOR AND BEGIN | |
17840 | ||
17841 | =item TESTING URLs hyperlinking | |
17842 | ||
17843 | =item SEE ALSO | |
17844 | ||
17845 | =back | |
17846 | ||
17847 | =head2 SDBM_File - Tied access to sdbm files | |
17848 | ||
17849 | =over 4 | |
17850 | ||
17851 | =item SYNOPSIS | |
17852 | ||
17853 | =item DESCRIPTION | |
17854 | ||
17855 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
17856 | ||
17857 | =item DIAGNOSTICS | |
17858 | ||
17859 | =over 4 | |
17860 | ||
17861 | =item C<sdbm store returned -1, errno 22, key "..." at ...> | |
17862 | ||
17863 | =back | |
17864 | ||
17865 | =item BUGS AND WARNINGS | |
17866 | ||
17867 | =back | |
17868 | ||
17869 | =head2 Safe - Compile and execute code in restricted compartments | |
17870 | ||
17871 | =over 4 | |
17872 | ||
17873 | =item SYNOPSIS | |
17874 | ||
17875 | =item DESCRIPTION | |
17876 | ||
17877 | a new namespace, an operator mask | |
17878 | ||
17879 | =item WARNING | |
17880 | ||
17881 | =over 4 | |
17882 | ||
17883 | =item RECENT CHANGES | |
17884 | ||
17885 | =item Methods in class Safe | |
17886 | ||
17887 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
17888 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
17889 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
17890 | root (NAMESPACE), mask (MASK) | |
17891 | ||
17892 | =item Some Safety Issues | |
17893 | ||
17894 | Memory, CPU, Snooping, Signals, State Changes | |
17895 | ||
17896 | =item AUTHOR | |
17897 | ||
17898 | =back | |
17899 | ||
17900 | =back | |
17901 | ||
17902 | =head2 Scalar::Util - A selection of general-utility scalar subroutines | |
17903 | ||
17904 | =over 4 | |
17905 | ||
17906 | =item SYNOPSIS | |
17907 | ||
17908 | =item DESCRIPTION | |
17909 | ||
17910 | blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype | |
17911 | EXPR, tainted EXPR, weaken REF | |
17912 | ||
17913 | =item KNOWN BUGS | |
17914 | ||
17915 | =item COPYRIGHT | |
17916 | ||
17917 | =item BLATANT PLUG | |
17918 | ||
17919 | =back | |
17920 | ||
17921 | =head2 Search::Dict, look - search for key in dictionary file | |
17922 | ||
17923 | =over 4 | |
17924 | ||
17925 | =item SYNOPSIS | |
17926 | ||
17927 | =item DESCRIPTION | |
17928 | ||
17929 | =back | |
17930 | ||
17931 | =head2 SelectSaver - save and restore selected file handle | |
17932 | ||
17933 | =over 4 | |
17934 | ||
17935 | =item SYNOPSIS | |
17936 | ||
17937 | =item DESCRIPTION | |
17938 | ||
17939 | =back | |
17940 | ||
17941 | =head2 SelfLoader - load functions only on demand | |
17942 | ||
17943 | =over 4 | |
17944 | ||
17945 | =item SYNOPSIS | |
17946 | ||
17947 | =item DESCRIPTION | |
17948 | ||
17949 | =over 4 | |
17950 | ||
17951 | =item The __DATA__ token | |
17952 | ||
17953 | =item SelfLoader autoloading | |
17954 | ||
17955 | =item Autoloading and package lexicals | |
17956 | ||
17957 | =item SelfLoader and AutoLoader | |
17958 | ||
17959 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. | |
17960 | ||
17961 | =item Classes and inherited methods. | |
17962 | ||
17963 | =back | |
17964 | ||
17965 | =item Multiple packages and fully qualified subroutine names | |
17966 | ||
17967 | =back | |
17968 | ||
17969 | =head2 Shell - run shell commands transparently within perl | |
17970 | ||
17971 | =over 4 | |
17972 | ||
17973 | =item SYNOPSIS | |
17974 | ||
17975 | =item DESCRIPTION | |
17976 | ||
17977 | =over 4 | |
17978 | ||
17979 | =item OBJECT ORIENTED SYNTAX | |
17980 | ||
17981 | =back | |
17982 | ||
17983 | =item AUTHOR | |
17984 | ||
17985 | =back | |
17986 | ||
17987 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C | |
17988 | socket.h defines and structure manipulators | |
17989 | ||
17990 | =over 4 | |
17991 | ||
17992 | =item SYNOPSIS | |
17993 | ||
17994 | =item DESCRIPTION | |
17995 | ||
17996 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, | |
17997 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, | |
17998 | ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, | |
17999 | unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un | |
18000 | SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
18001 | ||
18002 | =back | |
18003 | ||
18004 | =head2 Storable - persistence for Perl data structures | |
18005 | ||
18006 | =over 4 | |
18007 | ||
18008 | =item SYNOPSIS | |
18009 | ||
18010 | =item DESCRIPTION | |
18011 | ||
18012 | =item MEMORY STORE | |
18013 | ||
18014 | =item ADVISORY LOCKING | |
18015 | ||
18016 | =item SPEED | |
18017 | ||
18018 | =item CANONICAL REPRESENTATION | |
18019 | ||
18020 | =item FORWARD COMPATIBILITY | |
18021 | ||
18022 | utf8 data, restricted hashes, files from future versions of Storable | |
18023 | ||
18024 | =item ERROR REPORTING | |
18025 | ||
18026 | =item WIZARDS ONLY | |
18027 | ||
18028 | =over 4 | |
18029 | ||
18030 | =item Hooks | |
18031 | ||
18032 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
18033 | I<serialized>, .. | |
18034 | ||
18035 | =item Predicates | |
18036 | ||
18037 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
18038 | C<Storable::is_retrieving> | |
18039 | ||
18040 | =item Recursion | |
18041 | ||
18042 | =item Deep Cloning | |
18043 | ||
18044 | =back | |
18045 | ||
18046 | =item Storable magic | |
18047 | ||
18048 | =item EXAMPLES | |
18049 | ||
18050 | =item WARNING | |
18051 | ||
18052 | =item BUGS | |
18053 | ||
18054 | =over 4 | |
18055 | ||
18056 | =item 64 bit data in perl 5.6.0 and 5.6.1 | |
18057 | ||
18058 | =back | |
18059 | ||
18060 | =item CREDITS | |
18061 | ||
18062 | =item AUTHOR | |
18063 | ||
18064 | =item SEE ALSO | |
18065 | ||
18066 | =back | |
18067 | ||
18068 | =head2 Switch - A switch statement for Perl | |
18069 | ||
18070 | =over 4 | |
18071 | ||
18072 | =item VERSION | |
18073 | ||
18074 | =item SYNOPSIS | |
18075 | ||
18076 | =item BACKGROUND | |
18077 | ||
18078 | =item DESCRIPTION | |
18079 | ||
18080 | =over 4 | |
18081 | ||
18082 | =item Allowing fall-through | |
18083 | ||
18084 | =item Automating fall-through | |
18085 | ||
18086 | =item Alternative syntax | |
18087 | ||
18088 | =item Higher-order Operations | |
18089 | ||
18090 | =back | |
18091 | ||
18092 | =item DEPENDENCIES | |
18093 | ||
18094 | =item AUTHOR | |
18095 | ||
18096 | =item BUGS | |
18097 | ||
18098 | =item LIMITATION | |
18099 | ||
18100 | =item COPYRIGHT | |
18101 | ||
18102 | =back | |
18103 | ||
18104 | =head2 Symbol - manipulate Perl symbols and their names | |
18105 | ||
18106 | =over 4 | |
18107 | ||
18108 | =item SYNOPSIS | |
18109 | ||
18110 | =item DESCRIPTION | |
18111 | ||
18112 | =back | |
18113 | ||
18114 | =head2 Sys::Hostname - Try every conceivable way to get hostname | |
18115 | ||
18116 | =over 4 | |
18117 | ||
18118 | =item SYNOPSIS | |
18119 | ||
18120 | =item DESCRIPTION | |
18121 | ||
18122 | =item AUTHOR | |
18123 | ||
18124 | =back | |
18125 | ||
18126 | =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl | |
18127 | interface to the UNIX syslog(3) calls | |
18128 | ||
18129 | =over 4 | |
18130 | ||
18131 | =item SYNOPSIS | |
18132 | ||
18133 | =item DESCRIPTION | |
18134 | ||
18135 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
18136 | setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added | |
18137 | in 5.004_02), closelog | |
18138 | ||
18139 | =item EXAMPLES | |
18140 | ||
18141 | =item SEE ALSO | |
18142 | ||
18143 | =item AUTHOR | |
18144 | ||
18145 | =back | |
18146 | ||
18147 | =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - | |
18148 | Perl interface to the UNIX syslog(3) calls | |
18149 | ||
18150 | =over 4 | |
18151 | ||
18152 | =item SYNOPSIS | |
18153 | ||
18154 | =item DESCRIPTION | |
18155 | ||
18156 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
18157 | setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added | |
18158 | in 5.004_02), closelog | |
18159 | ||
18160 | =item EXAMPLES | |
18161 | ||
18162 | =item SEE ALSO | |
18163 | ||
18164 | =item AUTHOR | |
18165 | ||
18166 | =back | |
18167 | ||
18168 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences | |
18169 | ||
18170 | =over 4 | |
18171 | ||
18172 | =item SYNOPSIS | |
18173 | ||
18174 | =item DESCRIPTION | |
18175 | ||
18176 | =item DIAGNOSTICS | |
18177 | ||
18178 | Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in | |
18179 | use, Invalid attribute name %s, Name "%s" used only once: possible typo, No | |
18180 | comma allowed after filehandle, No name for escape sequence %s | |
18181 | ||
18182 | =item ENVIRONMENT | |
18183 | ||
18184 | ANSI_COLORS_DISABLED | |
18185 | ||
18186 | =item RESTRICTIONS | |
18187 | ||
18188 | =item NOTES | |
18189 | ||
18190 | =item SEE ALSO | |
18191 | ||
18192 | =item AUTHORS | |
18193 | ||
18194 | =item COPYRIGHT AND LICENSE | |
18195 | ||
18196 | =back | |
18197 | ||
18198 | =head2 Term::Cap - Perl termcap interface | |
18199 | ||
18200 | =over 4 | |
18201 | ||
18202 | =item SYNOPSIS | |
18203 | ||
18204 | =item DESCRIPTION | |
18205 | ||
18206 | =over 4 | |
18207 | ||
18208 | =item METHODS | |
18209 | ||
18210 | =back | |
18211 | ||
18212 | =back | |
18213 | ||
18214 | B<Tgetent>, OSPEED, TERM | |
18215 | ||
18216 | B<Tpad>, B<$string>, B<$cnt>, B<$FH> | |
18217 | ||
18218 | B<Tputs>, B<$cap>, B<$cnt>, B<$FH> | |
18219 | ||
18220 | B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> | |
18221 | ||
18222 | B<Trequire> | |
18223 | ||
18224 | =over 4 | |
18225 | ||
18226 | =item EXAMPLES | |
18227 | ||
18228 | =item COPYRIGHT AND LICENSE | |
18229 | ||
18230 | =item AUTHOR | |
18231 | ||
18232 | =item SEE ALSO | |
18233 | ||
18234 | =back | |
18235 | ||
18236 | =head2 Term::Complete - Perl word completion module | |
18237 | ||
18238 | =over 4 | |
18239 | ||
18240 | =item SYNOPSIS | |
18241 | ||
18242 | =item DESCRIPTION | |
18243 | ||
18244 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> | |
18245 | ||
18246 | =item DIAGNOSTICS | |
18247 | ||
18248 | =item BUGS | |
18249 | ||
18250 | =item AUTHOR | |
18251 | ||
18252 | =back | |
18253 | ||
18254 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. If | |
18255 | no real package is found, substitutes stubs instead of basic functions. | |
18256 | ||
18257 | =over 4 | |
18258 | ||
18259 | =item SYNOPSIS | |
18260 | ||
18261 | =item DESCRIPTION | |
18262 | ||
18263 | =item Minimal set of supported functions | |
18264 | ||
18265 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>, | |
18266 | C<MinLine>, C<findConsole>, Attribs, C<Features> | |
18267 | ||
18268 | =item Additional supported functions | |
18269 | ||
18270 | C<tkRunning>, C<ornaments>, C<newTTY> | |
18271 | ||
18272 | =item EXPORTS | |
18273 | ||
18274 | =item ENVIRONMENT | |
18275 | ||
18276 | =item CAVEATS | |
18277 | ||
18278 | =back | |
18279 | ||
18280 | =head2 Test - provides a simple framework for writing test scripts | |
18281 | ||
18282 | =over 4 | |
18283 | ||
18284 | =item SYNOPSIS | |
18285 | ||
18286 | =item DESCRIPTION | |
18287 | ||
18288 | =over 4 | |
18289 | ||
18290 | =item Functions | |
18291 | ||
18292 | B<plan> | |
18293 | ||
18294 | =back | |
18295 | ||
18296 | =back | |
18297 | ||
18298 | B<_to_value> | |
18299 | ||
18300 | B<ok> | |
18301 | ||
18302 | =over 4 | |
18303 | ||
18304 | =item TEST TYPES | |
18305 | ||
18306 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
18307 | ||
18308 | =item ONFAIL | |
18309 | ||
18310 | =item BUGS and CAVEATS | |
18311 | ||
18312 | =item NOTE | |
18313 | ||
18314 | =item SEE ALSO | |
18315 | ||
18316 | =item AUTHOR | |
18317 | ||
18318 | =back | |
18319 | ||
18320 | =head2 Test::Builder - Backend for building test libraries | |
18321 | ||
18322 | =over 4 | |
18323 | ||
18324 | =item SYNOPSIS | |
18325 | ||
18326 | =item DESCRIPTION | |
18327 | ||
18328 | =over 4 | |
18329 | ||
18330 | =item Construction | |
18331 | ||
18332 | B<new> | |
18333 | ||
18334 | =back | |
18335 | ||
18336 | =back | |
18337 | ||
18338 | =over 4 | |
18339 | ||
18340 | =item Setting up tests | |
18341 | ||
18342 | B<exported_to> | |
18343 | ||
18344 | =back | |
18345 | ||
18346 | B<plan> | |
18347 | ||
18348 | B<expected_tests> | |
18349 | ||
18350 | B<no_plan> | |
18351 | ||
18352 | B<skip_all> | |
18353 | ||
18354 | =over 4 | |
18355 | ||
18356 | =item Running tests | |
18357 | ||
18358 | B<ok> | |
18359 | ||
18360 | =back | |
18361 | ||
18362 | B<is_eq>, B<is_num> | |
18363 | ||
18364 | B<isnt_eq>, B<isnt_num> | |
18365 | ||
18366 | B<like>, B<unlike> | |
18367 | ||
18368 | B<maybe_regex> | |
18369 | ||
18370 | B<cmp_ok> | |
18371 | ||
18372 | B<BAILOUT> | |
18373 | ||
18374 | B<skip> | |
18375 | ||
18376 | B<todo_skip> | |
18377 | ||
18378 | B<skip_rest> | |
18379 | ||
18380 | =over 4 | |
18381 | ||
18382 | =item Test style | |
18383 | ||
18384 | B<level> | |
18385 | ||
18386 | =back | |
18387 | ||
18388 | B<use_numbers> | |
18389 | ||
18390 | B<no_header>, B<no_ending> | |
18391 | ||
18392 | =over 4 | |
18393 | ||
18394 | =item Output | |
18395 | ||
18396 | B<diag> | |
18397 | ||
18398 | =back | |
18399 | ||
18400 | B<_print> | |
18401 | ||
18402 | B<output>, B<failure_output>, B<todo_output> | |
18403 | ||
18404 | =over 4 | |
18405 | ||
18406 | =item Test Status and Info | |
18407 | ||
18408 | B<current_test> | |
18409 | ||
18410 | =back | |
18411 | ||
18412 | B<summary> | |
18413 | ||
18414 | B<details> I<UNIMPLEMENTED>, B<todo> | |
18415 | ||
18416 | B<caller> | |
18417 | ||
18418 | B<_sanity_check> | |
18419 | ||
18420 | B<_whoa> | |
18421 | ||
18422 | B<_my_exit> | |
18423 | ||
18424 | =over 4 | |
18425 | ||
18426 | =item THREADS | |
18427 | ||
18428 | =item EXAMPLES | |
18429 | ||
18430 | =item SEE ALSO | |
18431 | ||
18432 | =item AUTHORS | |
18433 | ||
18434 | =item COPYRIGHT | |
18435 | ||
18436 | =back | |
18437 | ||
18438 | =head2 Test::Harness - run perl standard test scripts with statistics | |
18439 | ||
18440 | =over 4 | |
18441 | ||
18442 | =item SYNOPSIS | |
18443 | ||
18444 | =item DESCRIPTION | |
18445 | ||
18446 | =over 4 | |
18447 | ||
18448 | =item The test script output | |
18449 | ||
18450 | B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>, | |
18451 | B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything | |
18452 | else> | |
18453 | ||
18454 | =item Taint mode | |
18455 | ||
18456 | =item Configuration variables. | |
18457 | ||
18458 | B<$Test::Harness::verbose>, B<$Test::Harness::switches> | |
18459 | ||
18460 | =item Failure | |
18461 | ||
18462 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of | |
18463 | Failed> | |
18464 | ||
18465 | =item Functions | |
18466 | ||
18467 | B<runtests> | |
18468 | ||
18469 | =back | |
18470 | ||
18471 | =back | |
18472 | ||
18473 | B<_all_ok> | |
18474 | ||
18475 | B<_globdir> | |
18476 | ||
18477 | B<_run_all_tests> | |
18478 | ||
18479 | B<_mk_leader> | |
18480 | ||
18481 | B<_leader_width> | |
18482 | ||
18483 | =over 4 | |
18484 | ||
18485 | =item EXPORT | |
18486 | ||
18487 | =item DIAGNOSTICS | |
18488 | ||
18489 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests | |
18490 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat | |
18491 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
18492 | %s>, C<FAILED--Further testing stopped: %s> | |
18493 | ||
18494 | =item ENVIRONMENT | |
18495 | ||
18496 | C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, | |
18497 | C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, | |
18498 | C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> | |
18499 | ||
18500 | =item EXAMPLE | |
18501 | ||
18502 | =item SEE ALSO | |
18503 | ||
18504 | =item AUTHORS | |
18505 | ||
18506 | =item TODO | |
18507 | ||
18508 | =item BUGS | |
18509 | ||
18510 | =back | |
18511 | ||
18512 | =head2 Test::Harness::Assert - simple assert | |
18513 | ||
18514 | =over 4 | |
18515 | ||
18516 | =item SYNOPSIS | |
18517 | ||
18518 | =item DESCRIPTION | |
18519 | ||
18520 | =over 4 | |
18521 | ||
18522 | =item Functions | |
18523 | ||
18524 | B<assert> | |
18525 | ||
18526 | =back | |
18527 | ||
18528 | =back | |
18529 | ||
18530 | =over 4 | |
18531 | ||
18532 | =item AUTHOR | |
18533 | ||
18534 | =item SEE ALSO | |
18535 | ||
18536 | =back | |
18537 | ||
18538 | =head2 Test::Harness::Iterator - Internal Test::Harness Iterator | |
18539 | ||
18540 | =over 4 | |
18541 | ||
18542 | =item SYNOPSIS | |
18543 | ||
18544 | =item DESCRIPTION | |
18545 | ||
18546 | =back | |
18547 | ||
18548 | =head2 Test::Harness::Straps - detailed analysis of test results | |
18549 | ||
18550 | =over 4 | |
18551 | ||
18552 | =item SYNOPSIS | |
18553 | ||
18554 | =item DESCRIPTION | |
18555 | ||
18556 | =over 4 | |
18557 | ||
18558 | =item Construction | |
18559 | ||
18560 | B<new> | |
18561 | ||
18562 | =back | |
18563 | ||
18564 | =back | |
18565 | ||
18566 | B<_init> | |
18567 | ||
18568 | =over 4 | |
18569 | ||
18570 | =item Analysis | |
18571 | ||
18572 | B<analyze> | |
18573 | ||
18574 | =back | |
18575 | ||
18576 | B<analyze_fh> | |
18577 | ||
18578 | B<analyze_file> | |
18579 | ||
18580 | B<_switches> | |
18581 | ||
18582 | B<_INC2PERL5LIB> | |
18583 | ||
18584 | B<_filtered_INC> | |
18585 | ||
18586 | B<_restore_PERL5LIB> | |
18587 | ||
18588 | =over 4 | |
18589 | ||
18590 | =item Parsing | |
18591 | ||
18592 | B<_is_comment> | |
18593 | ||
18594 | =back | |
18595 | ||
18596 | B<_is_header> | |
18597 | ||
18598 | B<_is_test> | |
18599 | ||
18600 | B<_is_bail_out> | |
18601 | ||
18602 | B<_reset_file_state> | |
18603 | ||
18604 | =over 4 | |
18605 | ||
18606 | =item Results | |
18607 | ||
18608 | B<_detailize> | |
18609 | ||
18610 | =back | |
18611 | ||
18612 | =over 4 | |
18613 | ||
18614 | =item EXAMPLES | |
18615 | ||
18616 | =item AUTHOR | |
18617 | ||
18618 | =item SEE ALSO | |
18619 | ||
18620 | =back | |
18621 | ||
18622 | =head2 Test::More - yet another framework for writing test scripts | |
18623 | ||
18624 | =over 4 | |
18625 | ||
18626 | =item SYNOPSIS | |
18627 | ||
18628 | =item DESCRIPTION | |
18629 | ||
18630 | =over 4 | |
18631 | ||
18632 | =item I love it when a plan comes together | |
18633 | ||
18634 | =back | |
18635 | ||
18636 | =back | |
18637 | ||
18638 | =over 4 | |
18639 | ||
18640 | =item Test names | |
18641 | ||
18642 | =item I'm ok, you're not ok. | |
18643 | ||
18644 | B<ok> | |
18645 | ||
18646 | =back | |
18647 | ||
18648 | B<is>, B<isnt> | |
18649 | ||
18650 | B<like> | |
18651 | ||
18652 | B<unlike> | |
18653 | ||
18654 | B<cmp_ok> | |
18655 | ||
18656 | B<can_ok> | |
18657 | ||
18658 | B<isa_ok> | |
18659 | ||
18660 | B<pass>, B<fail> | |
18661 | ||
18662 | =over 4 | |
18663 | ||
18664 | =item Diagnostics | |
18665 | ||
18666 | B<diag> | |
18667 | ||
18668 | =back | |
18669 | ||
18670 | =over 4 | |
18671 | ||
18672 | =item Module tests | |
18673 | ||
18674 | B<use_ok> | |
18675 | ||
18676 | =back | |
18677 | ||
18678 | B<require_ok> | |
18679 | ||
18680 | =over 4 | |
18681 | ||
18682 | =item Conditional tests | |
18683 | ||
18684 | B<SKIP: BLOCK> | |
18685 | ||
18686 | =back | |
18687 | ||
18688 | B<TODO: BLOCK>, B<todo_skip> | |
18689 | ||
18690 | When do I use SKIP vs. TODO? | |
18691 | ||
18692 | =over 4 | |
18693 | ||
18694 | =item Comparison functions | |
18695 | ||
18696 | B<is_deeply> | |
18697 | ||
18698 | =back | |
18699 | ||
18700 | B<eq_array> | |
18701 | ||
18702 | B<eq_hash> | |
18703 | ||
18704 | B<eq_set> | |
18705 | ||
18706 | =over 4 | |
18707 | ||
18708 | =item Extending and Embedding Test::More | |
18709 | ||
18710 | B<builder> | |
18711 | ||
18712 | =back | |
18713 | ||
18714 | =over 4 | |
18715 | ||
18716 | =item NOTES | |
18717 | ||
18718 | =item BUGS and CAVEATS | |
18719 | ||
18720 | Making your own ok(), The eq_* family has some caveats, Test::Harness | |
18721 | upgrades | |
18722 | ||
18723 | =item HISTORY | |
18724 | ||
18725 | =item SEE ALSO | |
18726 | ||
18727 | =item AUTHORS | |
18728 | ||
18729 | =item COPYRIGHT | |
18730 | ||
18731 | =back | |
18732 | ||
18733 | =head2 Test::Simple - Basic utilities for writing tests. | |
18734 | ||
18735 | =over 4 | |
18736 | ||
18737 | =item SYNOPSIS | |
18738 | ||
18739 | =item DESCRIPTION | |
18740 | ||
18741 | B<ok> | |
18742 | ||
18743 | =back | |
18744 | ||
18745 | =over 4 | |
18746 | ||
18747 | =item EXAMPLE | |
18748 | ||
18749 | =item CAVEATS | |
18750 | ||
18751 | =item NOTES | |
18752 | ||
18753 | =item HISTORY | |
18754 | ||
18755 | =item SEE ALSO | |
18756 | ||
18757 | L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, | |
18758 | L<Test::Harness> | |
18759 | ||
18760 | =item AUTHORS | |
18761 | ||
18762 | =item COPYRIGHT | |
18763 | ||
18764 | =back | |
18765 | ||
18766 | =head2 Test::Tutorial - A tutorial about writing really basic tests | |
18767 | ||
18768 | =over 4 | |
18769 | ||
18770 | =item DESCRIPTION | |
18771 | ||
18772 | =over 4 | |
18773 | ||
18774 | =item Nuts and bolts of testing. | |
18775 | ||
18776 | =item Where to start? | |
18777 | ||
18778 | =item Names | |
18779 | ||
18780 | =item Test the manual | |
18781 | ||
18782 | =item Sometimes the tests are wrong | |
18783 | ||
18784 | =item Testing lots of values | |
18785 | ||
18786 | =item Informative names | |
18787 | ||
18788 | =item Skipping tests | |
18789 | ||
18790 | =item Todo tests | |
18791 | ||
18792 | =item Testing with taint mode. | |
18793 | ||
18794 | =back | |
18795 | ||
18796 | =item FOOTNOTES | |
18797 | ||
18798 | =item AUTHORS | |
18799 | ||
18800 | =item COPYRIGHT | |
18801 | ||
18802 | =back | |
18803 | ||
18804 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list | |
18805 | ||
18806 | =over 4 | |
18807 | ||
18808 | =item SYNOPSIS | |
18809 | ||
18810 | =item DESCRIPTION | |
18811 | ||
18812 | =item EXAMPLE | |
18813 | ||
18814 | =back | |
18815 | ||
18816 | =head2 Text::Balanced - Extract delimited text sequences from strings. | |
18817 | ||
18818 | =over 4 | |
18819 | ||
18820 | =item SYNOPSIS | |
18821 | ||
18822 | =item DESCRIPTION | |
18823 | ||
18824 | =over 4 | |
18825 | ||
18826 | =item General behaviour in list contexts | |
18827 | ||
18828 | [0], [1], [2] | |
18829 | ||
18830 | =item General behaviour in scalar and void contexts | |
18831 | ||
18832 | =item A note about prefixes | |
18833 | ||
18834 | =item C<extract_delimited> | |
18835 | ||
18836 | =item C<extract_bracketed> | |
18837 | ||
18838 | =item C<extract_tagged> | |
18839 | ||
18840 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, | |
18841 | [0], [1], [2], [3], [4], [5] | |
18842 | ||
18843 | =item C<gen_extract_tagged> | |
18844 | ||
18845 | =item C<extract_quotelike> | |
18846 | ||
18847 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] | |
18848 | ||
18849 | =item C<extract_quotelike> and "here documents" | |
18850 | ||
18851 | [0], [1], [2], [3], [4], [5], [6], [7..10] | |
18852 | ||
18853 | =item C<extract_codeblock> | |
18854 | ||
18855 | =item C<extract_multiple> | |
18856 | ||
18857 | =item C<gen_delimited_pat> | |
18858 | ||
18859 | =back | |
18860 | ||
18861 | =item DIAGNOSTICS | |
18862 | ||
18863 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, | |
18864 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike | |
18865 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, | |
18866 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, | |
18867 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing | |
18868 | bracket: expected "%c" but found "%s">, C<No block delimiter found after | |
18869 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier | |
18870 | after dereferencer>, C<Did not find expected opening bracket at %s>, | |
18871 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike | |
18872 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: | |
18873 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid | |
18874 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing | |
18875 | tag> | |
18876 | ||
18877 | =item AUTHOR | |
18878 | ||
18879 | =item BUGS AND IRRITATIONS | |
18880 | ||
18881 | =item COPYRIGHT | |
18882 | ||
18883 | =back | |
18884 | ||
18885 | =head2 Text::ParseWords - parse text into an array of tokens or array of | |
18886 | arrays | |
18887 | ||
18888 | =over 4 | |
18889 | ||
18890 | =item SYNOPSIS | |
18891 | ||
18892 | =item DESCRIPTION | |
18893 | ||
18894 | =item EXAMPLES | |
18895 | ||
18896 | =item AUTHORS | |
18897 | ||
18898 | =back | |
18899 | ||
18900 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described | |
18901 | by Knuth | |
18902 | ||
18903 | =over 4 | |
18904 | ||
18905 | =item SYNOPSIS | |
18906 | ||
18907 | =item DESCRIPTION | |
18908 | ||
18909 | =item EXAMPLES | |
18910 | ||
18911 | =item LIMITATIONS | |
18912 | ||
18913 | =item AUTHOR | |
18914 | ||
18915 | =back | |
18916 | ||
18917 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and | |
18918 | unexpand(1) | |
18919 | ||
18920 | =over 4 | |
18921 | ||
18922 | =item SYNOPSIS | |
18923 | ||
18924 | =item DESCRIPTION | |
18925 | ||
18926 | =item BUGS | |
18927 | ||
18928 | =item AUTHOR | |
18929 | ||
18930 | =back | |
18931 | ||
18932 | =head2 Text::Wrap - line wrapping to form simple paragraphs | |
18933 | ||
18934 | =over 4 | |
18935 | ||
18936 | =item SYNOPSIS | |
18937 | ||
18938 | =item DESCRIPTION | |
18939 | ||
18940 | =item OVERRIDES | |
18941 | ||
18942 | =item EXAMPLE | |
18943 | ||
18944 | =item AUTHOR | |
18945 | ||
18946 | =back | |
18947 | ||
18948 | =head2 Thread - manipulate threads in Perl (for old code only) | |
18949 | ||
18950 | =over 4 | |
18951 | ||
18952 | =item CAVEAT | |
18953 | ||
18954 | =item SYNOPSIS | |
18955 | ||
18956 | =item DESCRIPTION | |
18957 | ||
18958 | =item FUNCTIONS | |
18959 | ||
18960 | $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, | |
18961 | LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, | |
18962 | cond_signal VARIABLE, cond_broadcast VARIABLE, yield | |
18963 | ||
18964 | =item METHODS | |
18965 | ||
18966 | join, eval, detach, equal, tid, flags, done | |
18967 | ||
18968 | =item LIMITATIONS | |
18969 | ||
18970 | =item SEE ALSO | |
18971 | ||
18972 | =back | |
18973 | ||
18974 | =head2 Thread::Queue - thread-safe queues | |
18975 | ||
18976 | =over 4 | |
18977 | ||
18978 | =item SYNOPSIS | |
18979 | ||
18980 | =item DESCRIPTION | |
18981 | ||
18982 | =item FUNCTIONS AND METHODS | |
18983 | ||
18984 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
18985 | ||
18986 | =item SEE ALSO | |
18987 | ||
18988 | =back | |
18989 | ||
18990 | =head2 Thread::Semaphore - thread-safe semaphores | |
18991 | ||
18992 | =over 4 | |
18993 | ||
18994 | =item SYNOPSIS | |
18995 | ||
18996 | =item DESCRIPTION | |
18997 | ||
18998 | =item FUNCTIONS AND METHODS | |
18999 | ||
19000 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
19001 | ||
19002 | =back | |
19003 | ||
19004 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably | |
19005 | (for old code) | |
19006 | ||
19007 | =over 4 | |
19008 | ||
19009 | =item CAVEAT | |
19010 | ||
19011 | =item SYNOPSIS | |
19012 | ||
19013 | =item DESCRIPTION | |
19014 | ||
19015 | =item BUGS | |
19016 | ||
19017 | =back | |
19018 | ||
19019 | =head2 Thread::Specific - thread-specific keys | |
19020 | ||
19021 | =over 4 | |
19022 | ||
19023 | =item SYNOPSIS | |
19024 | ||
19025 | =item DESCRIPTION | |
19026 | ||
19027 | =back | |
19028 | ||
19029 | =head2 Tie::Array - base class for tied arrays | |
19030 | ||
19031 | =over 4 | |
19032 | ||
19033 | =item SYNOPSIS | |
19034 | ||
19035 | =item DESCRIPTION | |
19036 | ||
19037 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
19038 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, | |
19039 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
19040 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
19041 | ||
19042 | =item CAVEATS | |
19043 | ||
19044 | =item AUTHOR | |
19045 | ||
19046 | =back | |
19047 | ||
19048 | =head2 Tie::File - Access the lines of a disk file via a Perl array | |
19049 | ||
19050 | =over 4 | |
19051 | ||
19052 | =item SYNOPSIS | |
19053 | ||
19054 | =item DESCRIPTION | |
19055 | ||
19056 | =over 4 | |
19057 | ||
19058 | =item C<recsep> | |
19059 | ||
19060 | =item C<autochomp> | |
19061 | ||
19062 | =item C<mode> | |
19063 | ||
19064 | =item C<memory> | |
19065 | ||
19066 | =item C<dw_size> | |
19067 | ||
19068 | =item Option Format | |
19069 | ||
19070 | =back | |
19071 | ||
19072 | =item Public Methods | |
19073 | ||
19074 | =over 4 | |
19075 | ||
19076 | =item C<flock> | |
19077 | ||
19078 | =item C<autochomp> | |
19079 | ||
19080 | =item C<defer>, C<flush>, C<discard>, and C<autodefer> | |
19081 | ||
19082 | =back | |
19083 | ||
19084 | =item Tying to an already-opened filehandle | |
19085 | ||
19086 | =item Deferred Writing | |
19087 | ||
19088 | =over 4 | |
19089 | ||
19090 | =item Autodeferring | |
19091 | ||
19092 | =back | |
19093 | ||
19094 | =item CAVEATS | |
19095 | ||
19096 | =item SUBCLASSING | |
19097 | ||
19098 | =item WHAT ABOUT C<DB_File>? | |
19099 | ||
19100 | =item AUTHOR | |
19101 | ||
19102 | =item LICENSE | |
19103 | ||
19104 | =item WARRANTY | |
19105 | ||
19106 | =item THANKS | |
19107 | ||
19108 | =item TODO | |
19109 | ||
19110 | =back | |
19111 | ||
19112 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied | |
19113 | handles | |
19114 | ||
19115 | =over 4 | |
19116 | ||
19117 | =item SYNOPSIS | |
19118 | ||
19119 | =item DESCRIPTION | |
19120 | ||
19121 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
19122 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
19123 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, | |
19124 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
19125 | ||
19126 | =item MORE INFORMATION | |
19127 | ||
19128 | =item COMPATIBILITY | |
19129 | ||
19130 | =back | |
19131 | ||
19132 | =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for | |
19133 | tied hashes | |
19134 | ||
19135 | =over 4 | |
19136 | ||
19137 | =item SYNOPSIS | |
19138 | ||
19139 | =item DESCRIPTION | |
19140 | ||
19141 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY | |
19142 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this | |
19143 | ||
19144 | =item Inheriting from B<Tie::StdHash> | |
19145 | ||
19146 | =item Inheriting from B<Tie::ExtraHash> | |
19147 | ||
19148 | =item C<UNTIE> and C<DESTROY> | |
19149 | ||
19150 | =item MORE INFORMATION | |
19151 | ||
19152 | =back | |
19153 | ||
19154 | =head2 Tie::Memoize - add data to hash when needed | |
19155 | ||
19156 | =over 4 | |
19157 | ||
19158 | =item SYNOPSIS | |
19159 | ||
19160 | =item DESCRIPTION | |
19161 | ||
19162 | =item Inheriting from B<Tie::Memoize> | |
19163 | ||
19164 | =item EXAMPLE | |
19165 | ||
19166 | =item BUGS | |
19167 | ||
19168 | =item AUTHOR | |
19169 | ||
19170 | =back | |
19171 | ||
19172 | =head2 Tie::RefHash - use references as hash keys | |
19173 | ||
19174 | =over 4 | |
19175 | ||
19176 | =item SYNOPSIS | |
19177 | ||
19178 | =item DESCRIPTION | |
19179 | ||
19180 | =item EXAMPLE | |
19181 | ||
19182 | =item AUTHOR | |
19183 | ||
19184 | =item VERSION | |
19185 | ||
19186 | =item SEE ALSO | |
19187 | ||
19188 | =back | |
19189 | ||
19190 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied | |
19191 | scalars | |
19192 | ||
19193 | =over 4 | |
19194 | ||
19195 | =item SYNOPSIS | |
19196 | ||
19197 | =item DESCRIPTION | |
19198 | ||
19199 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this | |
19200 | ||
19201 | =item MORE INFORMATION | |
19202 | ||
19203 | =back | |
19204 | ||
19205 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing | |
19206 | ||
19207 | =over 4 | |
19208 | ||
19209 | =item SYNOPSIS | |
19210 | ||
19211 | =item DESCRIPTION | |
19212 | ||
19213 | =item CAVEATS | |
19214 | ||
19215 | =back | |
19216 | ||
19217 | =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval | |
19218 | timers | |
19219 | ||
19220 | =over 4 | |
19221 | ||
19222 | =item SYNOPSIS | |
19223 | ||
19224 | =item DESCRIPTION | |
19225 | ||
19226 | gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, | |
19227 | $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), | |
19228 | alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer, | |
19229 | getitimer ( $which ) | |
19230 | ||
19231 | =item EXAMPLES | |
19232 | ||
19233 | =item C API | |
19234 | ||
19235 | =item CAVEATS | |
19236 | ||
19237 | =item AUTHORS | |
19238 | ||
19239 | =item REVISION | |
19240 | ||
19241 | =item COPYRIGHT | |
19242 | ||
19243 | =back | |
19244 | ||
19245 | =head2 Time::Local - efficiently compute time from local and GMT time | |
19246 | ||
19247 | =over 4 | |
19248 | ||
19249 | =item SYNOPSIS | |
19250 | ||
19251 | =item DESCRIPTION | |
19252 | ||
19253 | =item IMPLEMENTATION | |
19254 | ||
19255 | =item BUGS | |
19256 | ||
19257 | =back | |
19258 | ||
19259 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() | |
19260 | function | |
19261 | ||
19262 | =over 4 | |
19263 | ||
19264 | =item SYNOPSIS | |
19265 | ||
19266 | =item DESCRIPTION | |
19267 | ||
19268 | =item NOTE | |
19269 | ||
19270 | =item AUTHOR | |
19271 | ||
19272 | =back | |
19273 | ||
19274 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() | |
19275 | function | |
19276 | ||
19277 | =over 4 | |
19278 | ||
19279 | =item SYNOPSIS | |
19280 | ||
19281 | =item DESCRIPTION | |
19282 | ||
19283 | =item NOTE | |
19284 | ||
19285 | =item AUTHOR | |
19286 | ||
19287 | =back | |
19288 | ||
19289 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime | |
19290 | ||
19291 | =over 4 | |
19292 | ||
19293 | =item SYNOPSIS | |
19294 | ||
19295 | =item DESCRIPTION | |
19296 | ||
19297 | =item AUTHOR | |
19298 | ||
19299 | =back | |
19300 | ||
19301 | =head2 UNIVERSAL - base class for ALL classes (blessed references) | |
19302 | ||
19303 | =over 4 | |
19304 | ||
19305 | =item SYNOPSIS | |
19306 | ||
19307 | =item DESCRIPTION | |
19308 | ||
19309 | $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD | |
19310 | ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] ) | |
19311 | ||
19312 | =back | |
19313 | ||
19314 | =head2 Unicode::Collate - Unicode Collation Algorithm | |
19315 | ||
19316 | =over 4 | |
19317 | ||
19318 | =item SYNOPSIS | |
19319 | ||
19320 | =item DESCRIPTION | |
19321 | ||
19322 | =over 4 | |
19323 | ||
19324 | =item Constructor and Tailoring | |
19325 | ||
19326 | alternate, backwards, entry, ignoreName, ignoreChar, level, normalization, | |
19327 | overrideCJK, overrideHangul, preprocess, rearrange, table, undefName, | |
19328 | undefChar, katakana_before_hiragana, upper_before_lower | |
19329 | ||
19330 | =item Methods for Collation | |
19331 | ||
19332 | C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = | |
19333 | $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, | |
19334 | C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, | |
19335 | $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = | |
19336 | $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, | |
19337 | C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm = | |
19338 | $Collator-E<gt>viewSortKey($string)>, C<$position = | |
19339 | $Collator-E<gt>index($string, $substring)>, C<($position, $length) = | |
19340 | $Collator-E<gt>index($string, $substring)> | |
19341 | ||
19342 | =item Other Methods | |
19343 | ||
19344 | UCA_Version, Base_Unicode_Version | |
19345 | ||
19346 | =item EXPORT | |
19347 | ||
19348 | =item TODO | |
19349 | ||
19350 | =item CAVEAT | |
19351 | ||
19352 | =item BUGS | |
19353 | ||
19354 | =back | |
19355 | ||
19356 | =item AUTHOR | |
19357 | ||
19358 | =item SEE ALSO | |
19359 | ||
19360 | http://www.unicode.org/unicode/reports/tr10/, | |
19361 | http://www.unicode.org/unicode/reports/tr10/allkeys.txt, | |
19362 | http://www.unicode.org/unicode/reports/tr15/, | |
19363 | http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize> | |
19364 | ||
19365 | =back | |
19366 | ||
19367 | =head2 Unicode::Normalize - Unicode Normalization Forms | |
19368 | ||
19369 | =over 4 | |
19370 | ||
19371 | =item SYNOPSIS | |
19372 | ||
19373 | =item DESCRIPTION | |
19374 | ||
19375 | =over 4 | |
19376 | ||
19377 | =item Normalization Forms | |
19378 | ||
19379 | C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, | |
19380 | C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, | |
19381 | C<$normalized_string = normalize($form_name, $string)> | |
19382 | ||
19383 | =item Decomposition and Composition | |
19384 | ||
19385 | C<$decomposed_string = decompose($string)>, C<$decomposed_string = | |
19386 | decompose($string, $useCompatMapping)>, C<$reordered_string = | |
19387 | reorder($string)>, C<$composed_string = compose($string)> | |
19388 | ||
19389 | =item Quick Check | |
19390 | ||
19391 | C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = | |
19392 | checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = | |
19393 | check($form_name, $string)> | |
19394 | ||
19395 | =item Character Data | |
19396 | ||
19397 | C<$canonical_decomposed = getCanon($codepoint)>, | |
19398 | C<$compatibility_decomposed = getCompat($codepoint)>, | |
19399 | C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, | |
19400 | C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = | |
19401 | isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, | |
19402 | C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>, | |
19403 | C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> | |
19404 | ||
19405 | =item EXPORT | |
19406 | ||
19407 | =back | |
19408 | ||
19409 | =item AUTHOR | |
19410 | ||
19411 | =item SEE ALSO | |
19412 | ||
19413 | http://www.unicode.org/unicode/reports/tr15/, | |
19414 | http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt | |
19415 | ||
19416 | =back | |
19417 | ||
19418 | =head2 Unicode::UCD - Unicode character database | |
19419 | ||
19420 | =over 4 | |
19421 | ||
19422 | =item SYNOPSIS | |
19423 | ||
19424 | =item DESCRIPTION | |
19425 | ||
19426 | =back | |
19427 | ||
19428 | =over 4 | |
19429 | ||
19430 | =item charinfo | |
19431 | ||
19432 | =back | |
19433 | ||
19434 | =over 4 | |
19435 | ||
19436 | =item charblock | |
19437 | ||
19438 | =back | |
19439 | ||
19440 | =over 4 | |
19441 | ||
19442 | =item charscript | |
19443 | ||
19444 | =back | |
19445 | ||
19446 | =over 4 | |
19447 | ||
19448 | =item charblocks | |
19449 | ||
19450 | =back | |
19451 | ||
19452 | =over 4 | |
19453 | ||
19454 | =item charscripts | |
19455 | ||
19456 | =back | |
19457 | ||
19458 | =over 4 | |
19459 | ||
19460 | =item Blocks versus Scripts | |
19461 | ||
19462 | =item Matching Scripts and Blocks | |
19463 | ||
19464 | =item Code Point Arguments | |
19465 | ||
19466 | =item charinrange | |
19467 | ||
19468 | =back | |
19469 | ||
19470 | =over 4 | |
19471 | ||
19472 | =item compexcl | |
19473 | ||
19474 | =back | |
19475 | ||
19476 | =over 4 | |
19477 | ||
19478 | =item casefold | |
19479 | ||
19480 | =back | |
19481 | ||
19482 | =over 4 | |
19483 | ||
19484 | =item casespec | |
19485 | ||
19486 | =back | |
19487 | ||
19488 | =over 4 | |
19489 | ||
19490 | =item Unicode::UCD::UnicodeVersion | |
19491 | ||
19492 | =back | |
19493 | ||
19494 | =over 4 | |
19495 | ||
19496 | =item Implementation Note | |
19497 | ||
19498 | =back | |
19499 | ||
19500 | =over 4 | |
19501 | ||
19502 | =item BUGS | |
19503 | ||
19504 | =item AUTHOR | |
19505 | ||
19506 | =back | |
19507 | ||
19508 | =head2 User::grent - by-name interface to Perl's built-in getgr*() | |
19509 | functions | |
19510 | ||
19511 | =over 4 | |
19512 | ||
19513 | =item SYNOPSIS | |
19514 | ||
19515 | =item DESCRIPTION | |
19516 | ||
19517 | =item NOTE | |
19518 | ||
19519 | =item AUTHOR | |
19520 | ||
19521 | =back | |
19522 | ||
19523 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() | |
19524 | functions | |
19525 | ||
19526 | =over 4 | |
19527 | ||
19528 | =item SYNOPSIS | |
19529 | ||
19530 | =item DESCRIPTION | |
19531 | ||
19532 | =over 4 | |
19533 | ||
19534 | =item System Specifics | |
19535 | ||
19536 | =back | |
19537 | ||
19538 | =item NOTE | |
19539 | ||
19540 | =item AUTHOR | |
19541 | ||
19542 | =item HISTORY | |
19543 | ||
19544 | March 18th, 2000 | |
19545 | ||
19546 | =back | |
19547 | ||
19548 | =head2 Win32 - Interfaces to some Win32 API Functions | |
19549 | ||
19550 | =over 4 | |
19551 | ||
19552 | =item DESCRIPTION | |
19553 | ||
19554 | =over 4 | |
19555 | ||
19556 | =item Alphabetical Listing of Win32 Functions | |
19557 | ||
19558 | Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), | |
19559 | Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), | |
19560 | Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), | |
19561 | Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), | |
19562 | Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), | |
19563 | Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), | |
19564 | Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(), | |
19565 | Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, | |
19566 | PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, | |
19567 | Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), | |
19568 | Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, | |
19569 | SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), | |
19570 | Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), | |
19571 | Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW), | |
19572 | Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR), | |
19573 | Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID), | |
19574 | Win32::UnregisterServer(LIBRARYNAME) | |
19575 | ||
19576 | =back | |
19577 | ||
19578 | =back | |
19579 | ||
19580 | =head2 XSLoader - Dynamically load C libraries into Perl code | |
19581 | ||
19582 | =over 4 | |
19583 | ||
19584 | =item SYNOPSIS | |
19585 | ||
19586 | =item DESCRIPTION | |
19587 | ||
19588 | =item AUTHOR | |
19589 | ||
19590 | =back | |
19591 | ||
19592 | =head1 AUXILIARY DOCUMENTATION | |
19593 | ||
19594 | Here should be listed all the extra programs' documentation, but they | |
19595 | don't all have manual pages yet: | |
19596 | ||
19597 | =over 4 | |
19598 | ||
19599 | =item a2p | |
19600 | ||
19601 | =item s2p | |
19602 | ||
19603 | =item find2perl | |
19604 | ||
19605 | =item h2ph | |
19606 | ||
19607 | =item c2ph | |
19608 | ||
19609 | =item h2xs | |
19610 | ||
19611 | =item xsubpp | |
19612 | ||
19613 | =item pod2man | |
19614 | ||
19615 | =item wrapsuid | |
19616 | ||
19617 | =back | |
19618 | ||
19619 | =head1 AUTHOR | |
19620 | ||
19621 | Larry Wall <F<larry@wall.org>>, with the help of oodles | |
19622 | of other folks. | |
19623 |