Commit | Line | Data |
---|---|---|
cb1a09d0 AD |
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 | |
28757baa | 9 | documentation set. It is meant to be scanned quickly or grepped |
402d0d99 | 10 | through to locate the proper section you're looking for. |
cb1a09d0 AD |
11 | |
12 | =head1 BASIC DOCUMENTATION | |
13 | ||
cb1a09d0 AD |
14 | =head2 perl - Practical Extraction and Report Language |
15 | ||
d420ca49 | 16 | =over 4 |
a45bd81d | 17 | |
cb1a09d0 AD |
18 | =item SYNOPSIS |
19 | ||
69fba242 JH |
20 | =over 4 |
21 | ||
22 | =item Overview | |
23 | ||
24 | =item Tutorials | |
25 | ||
cb52f95f JH |
26 | =item Reference Manual |
27 | ||
69fba242 JH |
28 | =item Internals and C Language Interface |
29 | ||
30 | =item Miscellaneous | |
31 | ||
32 | =item Platform-Specific | |
33 | ||
34 | =back | |
35 | ||
cb1a09d0 AD |
36 | =item DESCRIPTION |
37 | ||
14218588 | 38 | =item AVAILABILITY |
cb1a09d0 AD |
39 | |
40 | =item ENVIRONMENT | |
41 | ||
cb1a09d0 AD |
42 | =item AUTHOR |
43 | ||
cb1a09d0 AD |
44 | =item FILES |
45 | ||
cb1a09d0 AD |
46 | =item SEE ALSO |
47 | ||
cb1a09d0 AD |
48 | =item DIAGNOSTICS |
49 | ||
cb1a09d0 AD |
50 | =item BUGS |
51 | ||
cb1a09d0 AD |
52 | =item NOTES |
53 | ||
a45bd81d GS |
54 | =back |
55 | ||
10151d09 JH |
56 | =head2 perlintro -- a brief introduction and overview of Perl |
57 | ||
58 | =over 4 | |
59 | ||
60 | =item DESCRIPTION | |
61 | ||
62 | =over 4 | |
63 | ||
64 | =item What is Perl? | |
65 | ||
66 | =item Running Perl programs | |
67 | ||
68 | =item Basic syntax overview | |
69 | ||
70 | =item Perl variable types | |
71 | ||
72 | Scalars, Arrays, Hashes | |
73 | ||
74 | =item Variable scoping | |
75 | ||
76 | =item Conditional and looping constructs | |
77 | ||
78 | if, while, for, foreach | |
79 | ||
80 | =item Builtin operators and functions | |
81 | ||
82 | Arithmetic, Numeric comparison, String comparison, Boolean logic, | |
83 | Miscellaneous | |
84 | ||
85 | =item Files and I/O | |
86 | ||
87 | =item Regular expressions | |
88 | ||
89 | Simple matching, Simple substitution, More complex regular expressions, | |
90 | Parentheses for capturing, Other regexp features | |
91 | ||
92 | =item Writing subroutines | |
93 | ||
94 | =item OO Perl | |
95 | ||
96 | =item Using Perl modules | |
97 | ||
98 | =back | |
99 | ||
100 | =item AUTHOR | |
101 | ||
102 | =back | |
103 | ||
fa17183e JH |
104 | =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11 |
105 | 21:32:23 $) | |
68dc0745 | 106 | |
d420ca49 | 107 | =over 4 |
a45bd81d | 108 | |
68dc0745 | 109 | =item DESCRIPTION |
110 | ||
983dbef6 | 111 | =over 4 |
68dc0745 | 112 | |
983dbef6 | 113 | =item perlfaq: Structural overview of the FAQ. |
68dc0745 | 114 | |
983dbef6 | 115 | =item L<perlfaq1>: General Questions About Perl |
68dc0745 | 116 | |
983dbef6 | 117 | =item L<perlfaq2>: Obtaining and Learning about Perl |
68dc0745 | 118 | |
983dbef6 | 119 | =item L<perlfaq3>: Programming Tools |
68dc0745 | 120 | |
983dbef6 | 121 | =item L<perlfaq4>: Data Manipulation |
68dc0745 | 122 | |
983dbef6 | 123 | =item L<perlfaq5>: Files and Formats |
68dc0745 | 124 | |
fe9287c4 | 125 | =item L<perlfaq6>: Regular Expressions |
68dc0745 | 126 | |
983dbef6 | 127 | =item L<perlfaq7>: General Perl Language Issues |
68dc0745 | 128 | |
983dbef6 | 129 | =item L<perlfaq8>: System Interaction |
68dc0745 | 130 | |
983dbef6 | 131 | =item L<perlfaq9>: Networking |
68dc0745 | 132 | |
a45bd81d GS |
133 | =back |
134 | ||
983dbef6 | 135 | =item About the perlfaq documents |
68dc0745 | 136 | |
d420ca49 | 137 | =over 4 |
a45bd81d | 138 | |
983dbef6 | 139 | =item Where to get the perlfaq |
68dc0745 | 140 | |
983dbef6 | 141 | =item How to contribute to the perlfaq |
68dc0745 | 142 | |
983dbef6 JH |
143 | =item What will happen if you mail your Perl programming problems to the |
144 | authors | |
68dc0745 | 145 | |
983dbef6 | 146 | =back |
68dc0745 | 147 | |
983dbef6 | 148 | =item Credits |
68dc0745 | 149 | |
983dbef6 | 150 | =item Author and Copyright Information |
68dc0745 | 151 | |
983dbef6 JH |
152 | =over 4 |
153 | ||
154 | =item Bundled Distributions | |
155 | ||
156 | =item Disclaimer | |
68dc0745 | 157 | |
4755096e | 158 | =back |
68dc0745 | 159 | |
983dbef6 JH |
160 | =item Changes |
161 | ||
162 | 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, | |
163 | 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, | |
164 | Initial Release: 11/March/97 | |
165 | ||
4755096e | 166 | =back |
68dc0745 | 167 | |
4755096e | 168 | =head2 perlbook - Perl book information |
68dc0745 | 169 | |
d420ca49 | 170 | =over 4 |
68dc0745 | 171 | |
4755096e | 172 | =item DESCRIPTION |
68dc0745 | 173 | |
a45bd81d GS |
174 | =back |
175 | ||
4755096e | 176 | =head2 perlsyn - Perl syntax |
a45bd81d | 177 | |
d420ca49 | 178 | =over 4 |
68dc0745 | 179 | |
180 | =item DESCRIPTION | |
181 | ||
d420ca49 | 182 | =over 4 |
68dc0745 | 183 | |
4755096e | 184 | =item Declarations |
68dc0745 | 185 | |
4755096e | 186 | =item Simple statements |
68dc0745 | 187 | |
4755096e | 188 | =item Compound statements |
3fe9a6f1 | 189 | |
4755096e | 190 | =item Loop Control |
68dc0745 | 191 | |
4755096e | 192 | =item For Loops |
68dc0745 | 193 | |
4755096e | 194 | =item Foreach Loops |
68dc0745 | 195 | |
4755096e | 196 | =item Basic BLOCKs and Switch Statements |
68dc0745 | 197 | |
4755096e | 198 | =item Goto |
68dc0745 | 199 | |
4755096e | 200 | =item PODs: Embedded Documentation |
68dc0745 | 201 | |
4755096e | 202 | =item Plain Old Comments (Not!) |
68dc0745 | 203 | |
4755096e | 204 | =back |
68dc0745 | 205 | |
4755096e | 206 | =back |
193fb0af | 207 | |
4755096e | 208 | =head2 perldata - Perl data types |
68dc0745 | 209 | |
d420ca49 | 210 | =over 4 |
68dc0745 | 211 | |
4755096e | 212 | =item DESCRIPTION |
68dc0745 | 213 | |
d420ca49 | 214 | =over 4 |
68dc0745 | 215 | |
4755096e | 216 | =item Variable names |
68dc0745 | 217 | |
4755096e | 218 | =item Context |
68dc0745 | 219 | |
4755096e GS |
220 | =item Scalar values |
221 | ||
222 | =item Scalar value constructors | |
223 | ||
224 | =item List value constructors | |
225 | ||
226 | =item Slices | |
227 | ||
228 | =item Typeglobs and Filehandles | |
68dc0745 | 229 | |
230 | =back | |
231 | ||
4755096e | 232 | =item SEE ALSO |
68dc0745 | 233 | |
a45bd81d GS |
234 | =back |
235 | ||
4755096e | 236 | =head2 perlop - Perl operators and precedence |
68dc0745 | 237 | |
d420ca49 | 238 | =over 4 |
a45bd81d | 239 | |
4755096e GS |
240 | =item SYNOPSIS |
241 | ||
68dc0745 | 242 | =item DESCRIPTION |
243 | ||
d420ca49 | 244 | =over 4 |
68dc0745 | 245 | |
4755096e | 246 | =item Terms and List Operators (Leftward) |
68dc0745 | 247 | |
4755096e | 248 | =item The Arrow Operator |
68dc0745 | 249 | |
4755096e | 250 | =item Auto-increment and Auto-decrement |
68dc0745 | 251 | |
4755096e | 252 | =item Exponentiation |
68dc0745 | 253 | |
4755096e | 254 | =item Symbolic Unary Operators |
68dc0745 | 255 | |
4755096e | 256 | =item Binding Operators |
68dc0745 | 257 | |
4755096e | 258 | =item Multiplicative Operators |
68dc0745 | 259 | |
4755096e | 260 | =item Additive Operators |
68dc0745 | 261 | |
4755096e | 262 | =item Shift Operators |
14218588 | 263 | |
4755096e | 264 | =item Named Unary Operators |
68dc0745 | 265 | |
4755096e | 266 | =item Relational Operators |
68dc0745 | 267 | |
4755096e | 268 | =item Equality Operators |
68dc0745 | 269 | |
4755096e | 270 | =item Bitwise And |
68dc0745 | 271 | |
4755096e | 272 | =item Bitwise Or and Exclusive Or |
68dc0745 | 273 | |
4755096e | 274 | =item C-style Logical And |
68dc0745 | 275 | |
4755096e | 276 | =item C-style Logical Or |
68dc0745 | 277 | |
4755096e | 278 | =item Range Operators |
68dc0745 | 279 | |
4755096e | 280 | =item Conditional Operator |
68dc0745 | 281 | |
4755096e | 282 | =item Assignment Operators |
68dc0745 | 283 | |
4755096e | 284 | =item Comma Operator |
68dc0745 | 285 | |
4755096e | 286 | =item List Operators (Rightward) |
68dc0745 | 287 | |
4755096e | 288 | =item Logical Not |
68dc0745 | 289 | |
4755096e | 290 | =item Logical And |
14218588 | 291 | |
4755096e | 292 | =item Logical or and Exclusive Or |
68dc0745 | 293 | |
4755096e | 294 | =item C Operators Missing From Perl |
68dc0745 | 295 | |
4755096e | 296 | unary &, unary *, (TYPE) |
68dc0745 | 297 | |
4755096e | 298 | =item Quote and Quote-like Operators |
68dc0745 | 299 | |
4755096e | 300 | =item Regexp Quote-Like Operators |
68dc0745 | 301 | |
4755096e | 302 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, |
2d967e39 JH |
303 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, |
304 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, | |
35bf961c | 305 | y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF |
68dc0745 | 306 | |
4755096e | 307 | =item Gory details of parsing quoted constructs |
68dc0745 | 308 | |
4755096e GS |
309 | Finding the end, Removal of backslashes before delimiters, Interpolation, |
310 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
311 | C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, | |
312 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
313 | regular expressions | |
68dc0745 | 314 | |
4755096e | 315 | =item I/O Operators |
68dc0745 | 316 | |
4755096e | 317 | =item Constant Folding |
68dc0745 | 318 | |
4755096e GS |
319 | =item Bitwise String Operators |
320 | ||
321 | =item Integer Arithmetic | |
322 | ||
323 | =item Floating-point Arithmetic | |
324 | ||
325 | =item Bigger Numbers | |
68dc0745 | 326 | |
a45bd81d GS |
327 | =back |
328 | ||
4755096e GS |
329 | =back |
330 | ||
c2e66d9e GS |
331 | =head2 perlsub - Perl subroutines |
332 | ||
d420ca49 | 333 | =over 4 |
c2e66d9e GS |
334 | |
335 | =item SYNOPSIS | |
336 | ||
337 | =item DESCRIPTION | |
338 | ||
d420ca49 | 339 | =over 4 |
c2e66d9e GS |
340 | |
341 | =item Private Variables via my() | |
342 | ||
343 | =item Persistent Private Variables | |
344 | ||
345 | =item Temporary Values via local() | |
346 | ||
347 | =item Lvalue subroutines | |
348 | ||
349 | =item Passing Symbol Table Entries (typeglobs) | |
350 | ||
351 | =item When to Still Use local() | |
352 | ||
c2e66d9e GS |
353 | =item Pass by Reference |
354 | ||
355 | =item Prototypes | |
356 | ||
357 | =item Constant Functions | |
358 | ||
359 | =item Overriding Built-in Functions | |
360 | ||
361 | =item Autoloading | |
362 | ||
363 | =item Subroutine Attributes | |
364 | ||
365 | =back | |
366 | ||
367 | =item SEE ALSO | |
368 | ||
369 | =back | |
370 | ||
371 | =head2 perlfunc - Perl builtin functions | |
372 | ||
d420ca49 | 373 | =over 4 |
c2e66d9e GS |
374 | |
375 | =item DESCRIPTION | |
376 | ||
d420ca49 | 377 | =over 4 |
c2e66d9e GS |
378 | |
379 | =item Perl Functions by Category | |
380 | ||
381 | Functions for SCALARs or strings, Regular expressions and pattern matching, | |
382 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
383 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
384 | length data or records, Functions for filehandles, files, or directories, | |
385 | Keywords related to the control flow of your perl program, Keywords related | |
386 | to scoping, Miscellaneous functions, Functions for processes and process | |
387 | groups, Keywords related to perl modules, Keywords related to classes and | |
388 | object-orientedness, Low-level socket functions, System V interprocess | |
389 | communication functions, Fetching user and group info, Fetching network | |
390 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
391 | in perl5 | |
392 | ||
393 | =item Portability | |
394 | ||
395 | =item Alphabetical Listing of Perl Functions | |
396 | ||
397 | I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept | |
398 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, | |
399 | binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME, | |
400 | bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, | |
07fcf8ff JH |
401 | chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr |
402 | NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir | |
403 | DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt | |
404 | PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, | |
405 | defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, | |
406 | dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval | |
407 | BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, | |
408 | fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock | |
409 | FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE, | |
410 | getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority | |
411 | WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname | |
412 | NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname | |
413 | NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, | |
414 | getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, | |
415 | gethostent, getnetent, getprotoent, getservent, setpwent, setgrent, | |
416 | sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent | |
417 | STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent, | |
418 | endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, | |
419 | glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep | |
420 | EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index | |
421 | STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join | |
422 | EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc, | |
423 | lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen | |
428dc699 JH |
424 | SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log, |
425 | lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK, | |
426 | mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv | |
07fcf8ff JH |
427 | ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, |
428 | next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open | |
493a87da JH |
429 | FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open |
430 | FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord | |
431 | EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package | |
432 | NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos | |
433 | SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE | |
434 | FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, | |
435 | q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, | |
436 | quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read | |
437 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, | |
438 | readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, | |
439 | ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, | |
440 | require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir | |
441 | DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, | |
442 | rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir | |
443 | DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, | |
444 | semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
c2e66d9e GS |
445 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority |
446 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
447 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
448 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
80cbd5ad JH |
449 | EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL, |
450 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort | |
451 | BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice | |
452 | ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split | |
453 | /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf | |
454 | FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat | |
455 | EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK, | |
456 | substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr | |
c2e66d9e GS |
457 | EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen |
458 | FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread | |
459 | FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
460 | FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite | |
461 | FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, | |
462 | syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie | |
463 | VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate | |
464 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, | |
465 | ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack | |
466 | TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST, | |
467 | use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST, | |
468 | values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn | |
469 | LIST, write FILEHANDLE, write EXPR, write, y/// | |
470 | ||
471 | =back | |
472 | ||
473 | =back | |
474 | ||
4755096e | 475 | =head2 perlreftut - Mark's very short tutorial about references |
68dc0745 | 476 | |
d420ca49 | 477 | =over 4 |
a45bd81d | 478 | |
68dc0745 | 479 | =item DESCRIPTION |
480 | ||
4755096e GS |
481 | =item Who Needs Complicated Data Structures? |
482 | ||
483 | =item The Solution | |
484 | ||
485 | =item Syntax | |
68dc0745 | 486 | |
d420ca49 | 487 | =over 4 |
68dc0745 | 488 | |
4755096e | 489 | =item Making References |
46fc3d4c | 490 | |
4755096e | 491 | =item Using References |
68dc0745 | 492 | |
4755096e | 493 | =back |
68dc0745 | 494 | |
4755096e | 495 | =item An Example |
68dc0745 | 496 | |
4755096e | 497 | =item Arrow Rule |
14218588 | 498 | |
4755096e | 499 | =item Solution |
68dc0745 | 500 | |
4755096e | 501 | =item The Rest |
68dc0745 | 502 | |
4755096e | 503 | =item Summary |
68dc0745 | 504 | |
4755096e GS |
505 | =item Credits |
506 | ||
d420ca49 | 507 | =over 4 |
4755096e GS |
508 | |
509 | =item Distribution Conditions | |
68dc0745 | 510 | |
511 | =back | |
512 | ||
4755096e GS |
513 | =back |
514 | ||
515 | =head2 perldsc - Perl Data Structures Cookbook | |
68dc0745 | 516 | |
d420ca49 | 517 | =over 4 |
68dc0745 | 518 | |
4755096e | 519 | =item DESCRIPTION |
68dc0745 | 520 | |
4755096e GS |
521 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
522 | more elaborate constructs | |
14218588 | 523 | |
4755096e | 524 | =item REFERENCES |
68dc0745 | 525 | |
4755096e | 526 | =item COMMON MISTAKES |
68dc0745 | 527 | |
4755096e | 528 | =item CAVEAT ON PRECEDENCE |
68dc0745 | 529 | |
4755096e | 530 | =item WHY YOU SHOULD ALWAYS C<use strict> |
14218588 | 531 | |
4755096e | 532 | =item DEBUGGING |
68dc0745 | 533 | |
4755096e | 534 | =item CODE EXAMPLES |
68dc0745 | 535 | |
4755096e | 536 | =item ARRAYS OF ARRAYS |
68dc0745 | 537 | |
d420ca49 | 538 | =over 4 |
68dc0745 | 539 | |
ba62762e | 540 | =item Declaration of an ARRAY OF ARRAYS |
68dc0745 | 541 | |
ba62762e | 542 | =item Generation of an ARRAY OF ARRAYS |
68dc0745 | 543 | |
ba62762e | 544 | =item Access and Printing of an ARRAY OF ARRAYS |
68dc0745 | 545 | |
4755096e | 546 | =back |
68dc0745 | 547 | |
4755096e | 548 | =item HASHES OF ARRAYS |
68dc0745 | 549 | |
d420ca49 | 550 | =over 4 |
68dc0745 | 551 | |
4755096e | 552 | =item Declaration of a HASH OF ARRAYS |
68dc0745 | 553 | |
4755096e | 554 | =item Generation of a HASH OF ARRAYS |
68dc0745 | 555 | |
4755096e | 556 | =item Access and Printing of a HASH OF ARRAYS |
68dc0745 | 557 | |
4755096e | 558 | =back |
68dc0745 | 559 | |
4755096e | 560 | =item ARRAYS OF HASHES |
68dc0745 | 561 | |
d420ca49 | 562 | =over 4 |
68dc0745 | 563 | |
ba62762e | 564 | =item Declaration of an ARRAY OF HASHES |
68dc0745 | 565 | |
ba62762e | 566 | =item Generation of an ARRAY OF HASHES |
68dc0745 | 567 | |
ba62762e | 568 | =item Access and Printing of an ARRAY OF HASHES |
14218588 | 569 | |
4755096e | 570 | =back |
68dc0745 | 571 | |
4755096e | 572 | =item HASHES OF HASHES |
68dc0745 | 573 | |
d420ca49 | 574 | =over 4 |
68dc0745 | 575 | |
4755096e | 576 | =item Declaration of a HASH OF HASHES |
68dc0745 | 577 | |
4755096e | 578 | =item Generation of a HASH OF HASHES |
68dc0745 | 579 | |
4755096e | 580 | =item Access and Printing of a HASH OF HASHES |
68dc0745 | 581 | |
582 | =back | |
583 | ||
4755096e | 584 | =item MORE ELABORATE RECORDS |
68dc0745 | 585 | |
d420ca49 | 586 | =over 4 |
68dc0745 | 587 | |
4755096e | 588 | =item Declaration of MORE ELABORATE RECORDS |
14218588 | 589 | |
4755096e | 590 | =item Declaration of a HASH OF COMPLEX RECORDS |
68dc0745 | 591 | |
4755096e | 592 | =item Generation of a HASH OF COMPLEX RECORDS |
68dc0745 | 593 | |
4755096e | 594 | =back |
68dc0745 | 595 | |
4755096e | 596 | =item Database Ties |
68dc0745 | 597 | |
4755096e | 598 | =item SEE ALSO |
68dc0745 | 599 | |
4755096e | 600 | =item AUTHOR |
14218588 | 601 | |
4755096e | 602 | =back |
68dc0745 | 603 | |
4755096e | 604 | =head2 perlrequick - Perl regular expressions quick start |
68dc0745 | 605 | |
d420ca49 | 606 | =over 4 |
68dc0745 | 607 | |
4755096e | 608 | =item DESCRIPTION |
68dc0745 | 609 | |
4755096e | 610 | =item The Guide |
68dc0745 | 611 | |
d420ca49 | 612 | =over 4 |
68dc0745 | 613 | |
4755096e | 614 | =item Simple word matching |
68dc0745 | 615 | |
4755096e | 616 | =item Using character classes |
68dc0745 | 617 | |
4755096e | 618 | =item Matching this or that |
68dc0745 | 619 | |
4755096e | 620 | =item Grouping things and hierarchical matching |
68dc0745 | 621 | |
4755096e | 622 | =item Extracting matches |
68dc0745 | 623 | |
4755096e | 624 | =item Matching repetitions |
68dc0745 | 625 | |
4755096e | 626 | =item More matching |
68dc0745 | 627 | |
4755096e | 628 | =item Search and replace |
68dc0745 | 629 | |
4755096e | 630 | =item The split operator |
68dc0745 | 631 | |
632 | =back | |
633 | ||
4755096e | 634 | =item BUGS |
68dc0745 | 635 | |
4755096e | 636 | =item SEE ALSO |
68dc0745 | 637 | |
4755096e | 638 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 639 | |
d420ca49 | 640 | =over 4 |
68dc0745 | 641 | |
4755096e | 642 | =item Acknowledgments |
14218588 | 643 | |
68dc0745 | 644 | =back |
645 | ||
a45bd81d GS |
646 | =back |
647 | ||
8a93676d | 648 | =head2 perlpod - the Plain Old Documentation format |
68dc0745 | 649 | |
d420ca49 | 650 | =over 4 |
a45bd81d | 651 | |
68dc0745 | 652 | =item DESCRIPTION |
653 | ||
d420ca49 | 654 | =over 4 |
68dc0745 | 655 | |
8a93676d SB |
656 | =item Ordinary Paragraph |
657 | ||
c2e66d9e | 658 | =item Verbatim Paragraph |
68dc0745 | 659 | |
c2e66d9e | 660 | =item Command Paragraph |
68dc0745 | 661 | |
8a93676d SB |
662 | C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading |
663 | Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item | |
664 | I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end | |
665 | I<formatname>>, C<=for I<formatname> I<text...>> | |
666 | ||
667 | =item Formatting Codes | |
668 | ||
669 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, | |
670 | C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink, | |
671 | C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used | |
672 | for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces, | |
673 | C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null | |
674 | (zero-effect) formatting code | |
68dc0745 | 675 | |
c2e66d9e | 676 | =item The Intent |
68dc0745 | 677 | |
c2e66d9e | 678 | =item Embedding Pods in Perl Modules |
68dc0745 | 679 | |
8a93676d SB |
680 | =item Hints for Writing Pod |
681 | ||
682 | =back | |
683 | ||
684 | =item SEE ALSO | |
685 | ||
686 | =item AUTHOR | |
193fb0af | 687 | |
c2e66d9e | 688 | =back |
68dc0745 | 689 | |
8a93676d SB |
690 | =head2 perlpodspec - Plain Old Documentation: format specification and |
691 | notes | |
692 | ||
693 | =over 4 | |
694 | ||
695 | =item DESCRIPTION | |
696 | ||
697 | =item Pod Definitions | |
698 | ||
699 | =item Pod Commands | |
700 | ||
701 | "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", | |
702 | "=back", "=begin formatname", "=end formatname", "=for formatname text..." | |
703 | ||
704 | =item Pod Formatting Codes | |
705 | ||
706 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, | |
707 | C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for | |
708 | filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a | |
709 | null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, | |
710 | C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text | |
711 | contains non-breaking spaces | |
712 | ||
713 | =item Notes on Implementing Pod Processors | |
714 | ||
715 | =item About LE<lt>...E<gt> Codes | |
716 | ||
717 | First:, Second:, Third:, Fourth:, Fifth:, Sixth: | |
718 | ||
719 | =item About =over...=back Regions | |
720 | ||
721 | =item About Data Paragraphs and "=begin/=end" Regions | |
722 | ||
c2e66d9e | 723 | =item SEE ALSO |
68dc0745 | 724 | |
c2e66d9e | 725 | =item AUTHOR |
68dc0745 | 726 | |
c2e66d9e | 727 | =back |
68dc0745 | 728 | |
c2e66d9e | 729 | =head2 perlstyle - Perl style guide |
68dc0745 | 730 | |
d420ca49 | 731 | =over 4 |
c2e66d9e GS |
732 | |
733 | =item DESCRIPTION | |
68dc0745 | 734 | |
4755096e | 735 | =back |
68dc0745 | 736 | |
c2e66d9e | 737 | =head2 perltrap - Perl traps for the unwary |
68dc0745 | 738 | |
d420ca49 | 739 | =over 4 |
68dc0745 | 740 | |
c2e66d9e | 741 | =item DESCRIPTION |
68dc0745 | 742 | |
d420ca49 | 743 | =over 4 |
68dc0745 | 744 | |
c2e66d9e | 745 | =item Awk Traps |
68dc0745 | 746 | |
c2e66d9e | 747 | =item C Traps |
4755096e | 748 | |
c2e66d9e | 749 | =item Sed Traps |
4755096e | 750 | |
c2e66d9e | 751 | =item Shell Traps |
4755096e | 752 | |
c2e66d9e | 753 | =item Perl Traps |
68dc0745 | 754 | |
c2e66d9e | 755 | =item Perl4 to Perl5 Traps |
68dc0745 | 756 | |
c2e66d9e GS |
757 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
758 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
759 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
760 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
761 | ||
762 | =item Discontinuance, Deprecation, and BugFix traps | |
763 | ||
764 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, | |
765 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
766 | Discontinuance, Deprecation, Discontinuance, Discontinuance | |
767 | ||
768 | =item Parsing Traps | |
769 | ||
07fcf8ff | 770 | Parsing, Parsing, Parsing, Parsing, Parsing |
c2e66d9e GS |
771 | |
772 | =item Numerical Traps | |
773 | ||
774 | Numerical, Numerical, Numerical, Bitwise string ops | |
775 | ||
776 | =item General data type traps | |
777 | ||
778 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), | |
779 | (Constants), (Scalars), (Variable Suicide) | |
780 | ||
781 | =item Context Traps - scalar, list contexts | |
782 | ||
783 | (list context), (scalar context), (scalar context), (list, builtin) | |
784 | ||
785 | =item Precedence Traps | |
786 | ||
787 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, | |
788 | Precedence | |
789 | ||
790 | =item General Regular Expression Traps using s///, etc. | |
791 | ||
792 | Regular Expression, Regular Expression, Regular Expression, Regular | |
793 | Expression, Regular Expression, Regular Expression, Regular Expression, | |
794 | Regular Expression | |
795 | ||
796 | =item Subroutine, Signal, Sorting Traps | |
797 | ||
798 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle | |
799 | ||
800 | =item OS Traps | |
801 | ||
802 | (SysV), (SysV) | |
803 | ||
804 | =item Interpolation Traps | |
805 | ||
806 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, | |
807 | Interpolation, Interpolation, Interpolation, Interpolation | |
808 | ||
809 | =item DBM Traps | |
810 | ||
811 | DBM, DBM | |
812 | ||
813 | =item Unclassified Traps | |
814 | ||
815 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
816 | LIMIT specified | |
68dc0745 | 817 | |
4755096e | 818 | =back |
68dc0745 | 819 | |
c2e66d9e | 820 | =back |
14218588 | 821 | |
c2e66d9e | 822 | =head2 perlrun - how to execute the Perl interpreter |
68dc0745 | 823 | |
d420ca49 | 824 | =over 4 |
c2e66d9e GS |
825 | |
826 | =item SYNOPSIS | |
827 | ||
828 | =item DESCRIPTION | |
68dc0745 | 829 | |
d420ca49 | 830 | =over 4 |
68dc0745 | 831 | |
c2e66d9e GS |
832 | =item #! and quoting on non-Unix systems |
833 | ||
834 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS | |
835 | ||
836 | =item Location of Perl | |
837 | ||
838 | =item Command Switches | |
839 | ||
91e74348 | 840 | B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, |
c2e66d9e GS |
841 | B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, |
842 | B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>], | |
843 | B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
844 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, | |
0e9b9e0c JH |
845 | B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, |
846 | B<-X>, B<-x> I<directory> | |
68dc0745 | 847 | |
4755096e | 848 | =back |
68dc0745 | 849 | |
c2e66d9e GS |
850 | =item ENVIRONMENT |
851 | ||
852 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL | |
853 | (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL, | |
cb52f95f JH |
854 | PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to |
855 | the VMS port) | |
c2e66d9e | 856 | |
c2e66d9e GS |
857 | =item DESCRIPTION |
858 | ||
ff426ff2 JH |
859 | accept() on closed socket %s, Allocation too large: %lx, '!' allowed only |
860 | after types %s, Ambiguous call resolved as CORE::%s(), qualify as such or | |
861 | use &, Ambiguous range in transliteration operator, Ambiguous use of %s | |
862 | resolved as %s, '|' and '<' may not both be specified on command line, '|' | |
863 | and '>' may not both be specified on command line, Applying %s to %s will | |
864 | act on scalar(%s), Args must match #! line, Arg too short for msgsnd, %s | |
865 | argument is not a HASH or ARRAY element, %s argument is not a HASH or ARRAY | |
866 | element or slice, %s argument is not a subroutine name, Argument "%s" isn't | |
867 | numeric%s, Array @%s missing the @ in argument %d of %s(), assertion | |
868 | botched: %s, Assertion failed: file "%s", Assignment to both a list and a | |
80327a3d JH |
869 | scalar, Attempt to access disallowed key '%s' in a fixed hash, Attempt to |
870 | clear a fixed hash, Attempt to delete readonly key '%s' from a fixed hash, | |
871 | Attempt to delete disallowed key '%s' from a fixed hash, Attempt to bless | |
872 | into a reference, Attempt to free non-arena SV: 0x%lx, Attempt to free | |
873 | nonexistent shared string, Attempt to free temp prematurely, Attempt to | |
874 | free unreferenced glob pointers, Attempt to free unreferenced scalar, | |
875 | Attempt to join self, Attempt to pack pointer to temporary value, Attempt | |
876 | to use reference as lvalue in substr, Bad arg length for %s, is %d, should | |
877 | be %s, Bad evalled substitution pattern, Bad filehandle: %s, Bad free() | |
878 | ignored, Bad hash, Bad index while coercing array into hash, Badly placed | |
879 | ()'s, Bad name after %s::, Bad realloc() ignored, Bad symbol for array, Bad | |
880 | symbol for filehandle, Bad symbol for hash, Bareword found in conditional, | |
ff426ff2 JH |
881 | Bareword "%s" not allowed while "strict subs" in use, Bareword "%s" refers |
882 | to nonexistent package, BEGIN failed--compilation aborted, BEGIN not safe | |
883 | after errors--compilation aborted, \1 better written as $1, Binary number > | |
884 | 0b11111111111111111111111111111111 non-portable, bind() on closed socket | |
885 | %s, binmode() on closed filehandle %s, Bit vector size > 32 non-portable, | |
886 | Bizarre copy of %s in %s, B<-P> not allowed for setuid/setgid script, | |
887 | Buffer overflow in prime_env_iter: %s, Callback called exit, %s() called | |
888 | too early to check prototype, / cannot take a count, Can't bless | |
889 | non-reference value, Can't call method "%s" in empty package "%s", Can't | |
890 | call method "%s" on an undefined value, Can't call method "%s" on unblessed | |
891 | reference, Can't call method "%s" without a package or object reference, | |
892 | Can't chdir to %s, Can't check filesystem of script "%s" for nosuid, Can't | |
893 | coerce array into hash, Can't coerce %s to integer in %s, Can't coerce %s | |
894 | to number in %s, Can't coerce %s to string in %s, Can't create pipe | |
895 | mailbox, Can't declare class for non-scalar %s in "%s", Can't declare %s in | |
896 | "%s", Can't do inplace edit: %s is not a regular file, Can't do inplace | |
897 | edit on %s: %s, Can't do inplace edit without backup, Can't do inplace | |
898 | edit: %s would not be unique, Can't do {n,m} with n > m in regex; marked by | |
899 | <-- HERE in m/%s/, Can't do setegid!, Can't do seteuid!, Can't do setuid, | |
900 | Can't do waitpid with flags, Can't emulate -%s on #! line, Can't exec "%s": | |
901 | %s, Can't exec %s, Can't execute %s, Can't find an opnumber for "%s", Can't | |
902 | find %s character property "%s", Can't find label %s, Can't find %s on | |
903 | PATH, Can't find %s on PATH, '.' not in PATH, Can't find string terminator | |
904 | %s anywhere before EOF, Can't find %s property definition %s, Can't fork, | |
905 | Can't get filespec - stale stat buffer?, Can't get pipe mailbox device | |
906 | name, Can't get SYSGEN parameter value for MAXBUF, Can't "goto" into the | |
907 | middle of a foreach loop, Can't "goto" out of a pseudo block, Can't goto | |
908 | subroutine from an eval-string, Can't goto subroutine outside a subroutine, | |
909 | Can't ignore signal CHLD, forcing to default, Can't "last" outside a loop | |
910 | block, Can't localize lexical variable %s, Can't localize pseudo-hash | |
fa1c7b03 JH |
911 | element, Can't localize through a reference, Can't locate %s, Can't locate |
912 | auto/%s.al in @INC, Can't locate object method "%s" via package "%s", | |
913 | (perhaps you forgot to load "%s"?), Can't locate package %s for @%s::ISA, | |
914 | Can't make list assignment to \%ENV on this system, Can't modify %s in %s, | |
915 | Can't modify nonexistent substring, Can't modify non-lvalue subroutine | |
916 | call, Can't msgrcv to read-only var, Can't "next" outside a loop block, | |
917 | Can't open %s: %s, Can't open bidirectional pipe, Can't open error file %s | |
918 | as stderr, Can't open input file %s as stdin, Can't open output file %s as | |
919 | stdout, Can't open output pipe (name: %s), Can't open perl script%s: %s, | |
920 | Can't read CRTL environ, Can't redefine active sort subroutine %s, Can't | |
921 | "redo" outside a loop block, Can't remove %s: %s, skipping file, Can't | |
922 | rename %s to %s: %s, skipping file, Can't reopen input pipe (name: %s) in | |
923 | binary mode, Can't resolve method `%s' overloading `%s' in package `%s', | |
924 | Can't reswap uid and euid, Can't return %s from lvalue subroutine, Can't | |
925 | return %s to lvalue scalar context, Can't return outside a subroutine, | |
926 | Can't stat script "%s", Can't swap uid and euid, Can't take log of %g, | |
927 | Can't take sqrt of %g, Can't undef active subroutine, Can't unshift, Can't | |
928 | upgrade that kind of scalar, Can't upgrade to undef, Can't use an undefined | |
929 | value as %s reference, Can't use anonymous symbol table for method lookup, | |
930 | Can't use bareword ("%s") as %s ref while "strict refs" in use, Can't use | |
931 | %! because Errno.pm is not available, Can't use %s for loop variable, Can't | |
932 | use global %s in "my", Can't use "my %s" in sort comparison, Can't use %s | |
933 | ref as %s ref, Can't use string ("%s") as %s ref while "strict refs" in | |
934 | use, Can't use subscript on %s, Can't use \%c to mean $%c in expression, | |
935 | Can't weaken a nonreference, Can't x= to read-only value, Character in "C" | |
936 | format wrapped, Character in "c" format wrapped, close() on unopened | |
937 | filehandle %s, %s: Command not found, Compilation failed in require, | |
938 | Complex regular subexpression recursion limit (%d) exceeded, connect() on | |
939 | closed socket %s, Constant(%s)%s: %s, Constant is not %s reference, | |
940 | Constant subroutine %s redefined, Constant subroutine %s undefined, Copy | |
941 | method did not return a reference, CORE::%s is not a keyword, corrupted | |
942 | regexp pointers, corrupted regexp program, Corrupt malloc ptr 0x%lx at | |
943 | 0x%lx, C<-p> destination: %s, C<-T> and C<-B> not implemented on | |
944 | filehandles, Deep recursion on subroutine "%s", defined(@array) is | |
945 | deprecated, defined(%hash) is deprecated, %s defines neither package nor | |
946 | VERSION--version check failed, Delimiter for here document is too long, Did | |
947 | not produce a valid header, %s did not return a true value, (Did you mean | |
948 | &%s instead?), (Did you mean "local" instead of "our"?), (Did you mean $ or | |
949 | @ instead of %?), Died, Document contains no data, %s does not define | |
950 | %s::VERSION--version check failed, Don't know how to handle magic of type | |
951 | '%s', do_study: out of memory, (Do you need to predeclare %s?), dump() | |
952 | better written as CORE::dump(), Duplicate free() ignored, elseif should be | |
953 | elsif, Empty %s, entering effective %s failed, Error converting file | |
954 | specification %s, %s: Eval-group in insecure regular expression, %s: | |
955 | Eval-group not allowed at run time, %s: Eval-group not allowed, use re | |
956 | 'eval', Excessively long <> operator, exec? I'm not *that* kind of | |
957 | operating system, Execution of %s aborted due to compilation errors, | |
958 | Exiting eval via %s, Exiting format via %s, Exiting pseudo-block via %s, | |
959 | Exiting subroutine via %s, Exiting substitution via %s, Explicit blessing | |
960 | to '' (assuming package main), %s: Expression syntax, %s failed--call queue | |
961 | aborted, False [] range "%s" in regex; marked by <-- HERE in m/%s/, Fatal | |
962 | VMS error at %s, line %d, fcntl is not implemented, Filehandle %s opened | |
963 | only for input, Filehandle %s opened only for output, Final $ should be \$ | |
964 | or $name, Final @ should be \@ or @name, flock() on closed filehandle %s, | |
965 | Quantifier follows nothing in regex;, Format not terminated, Format %s | |
966 | redefined, Found = in conditional, should be ==, %s found where operator | |
967 | expected, gdbm store returned %d, errno %d, key "%s", gethostent not | |
968 | implemented, get%sname() on closed socket %s, getpwnam returned invalid UIC | |
969 | %#o for user "%s", getsockopt() on closed socket %s, Global symbol "%s" | |
970 | requires explicit package name, glob failed (%s), Glob not terminated, Got | |
971 | an error from DosAllocMem, goto must have label, %s-group starts with a | |
972 | count, %s had compilation errors, Had to create %s unexpectedly, Hash %%s | |
973 | missing the % in argument %d of %s(), %s has too many errors, Hexadecimal | |
974 | number > 0xffffffff non-portable, Identifier too long, Illegal binary digit | |
975 | %s, Illegal binary digit %s ignored, Illegal character %s (carriage | |
976 | return), Illegal character in prototype for %s : %s, Illegal division by | |
977 | zero, Illegal hexadecimal digit %s ignored, Illegal modulus zero, Illegal | |
978 | number of bits in vec, Illegal octal digit %s, Illegal octal digit %s | |
979 | ignored, Illegal switch in PERL5OPT: %s, Ill-formed CRTL environ value | |
980 | "%s", Ill-formed message in prime_env_iter: |%s|, (in cleanup) %s, In | |
981 | EBCDIC the v-string components cannot exceed 2147483647, Insecure | |
982 | dependency in %s, Insecure directory in %s, Insecure $ENV{%s} while running | |
983 | %s, Integer overflow in %s number, Internal disaster in regex; marked by | |
984 | <-- HERE in m/%s/, Internal inconsistency in tracking vforks, Internal urp | |
985 | in regex; marked by <-- HERE in m/%s/, %s (...) interpreted as function, | |
986 | Invalid %s attribute: %s, Invalid %s attributes: %s, Invalid conversion in | |
987 | %s: "%s", Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/, | |
988 | Invalid [] range "%s" in transliteration operator, Invalid separator | |
989 | character %s in attribute list, Invalid type in pack: '%s', Invalid type in | |
990 | unpack: '%s', ioctl is not implemented, ioctl() on unopened %s, | |
991 | IO::Socket::atmark not implemented on this architecture, `%s' is not a code | |
992 | reference, `%s' is not an overloadable type, junk on end of regexp, Label | |
993 | not found for "last %s", Label not found for "next %s", Label not found for | |
994 | "redo %s", leaving effective %s failed, listen() on closed socket %s, | |
995 | lstat() on filehandle %s, Lvalue subs returning %s not implemented yet, | |
996 | Lookbehind longer than %d not implemented in regex;, Malformed | |
997 | PERLLIB_PREFIX, Malformed prototype for %s: %s, Malformed UTF-8 character | |
998 | (%s), Malformed UTF-16 surrogate, %s matches null string many times in | |
999 | regex;, "%s" may clash with future reserved word, % may only be used in | |
1000 | unpack, Method for operation %s not found in package %s during blessing, | |
1001 | Method %s not permitted, Might be a runaway multi-line %s string starting | |
1002 | on line %d, Misplaced _ in number, Missing %sbrace%s on \N{}, Missing comma | |
1003 | after first argument to %s function, Missing command in piped open, Missing | |
1004 | name in "my sub", Missing $ on loop variable, (Missing operator before | |
1005 | %s?), Missing right brace on %s, Missing right curly or square bracket, | |
1006 | (Missing semicolon on previous line?), Modification of a read-only value | |
1007 | attempted, Modification of non-creatable array value attempted, %s, | |
1008 | Modification of non-creatable hash value attempted, %s, Module name must be | |
1009 | constant, Module name required with -%c option, More than one argument to | |
1010 | open, msg%s not implemented, Multidimensional syntax %s not supported, / | |
1011 | must be followed by a*, A* or Z*, / must be followed by a, A or Z, / must | |
1012 | follow a numeric type, "my sub" not yet implemented, "my" variable %s can't | |
1013 | be in a package, Name "%s::%s" used only once: possible typo, Negative | |
1014 | length, Negative offset to vec in lvalue context, Nested quantifiers in | |
1015 | regex; marked by <-- HERE in m/%s/, %s never introduced, No %s allowed | |
1016 | while running setuid, No B<-e> allowed in setuid scripts, No comma allowed | |
1017 | after %s, No command into which to pipe on command line, No DB::DB routine | |
1018 | defined, No dbm on this machine, No DBsub routine, No error file after 2> | |
1019 | or 2>> on command line, No input file after < on command line, No #! line, | |
1020 | "no" not allowed in expression, No output file after > on command line, No | |
1021 | output file after > or >> on command line, No package name allowed for | |
1022 | variable %s in "our", No Perl script found in input, No setregid available, | |
1023 | No setreuid available, No space allowed after -%c, No %s specified for -%c, | |
1024 | No such class %s, No such pipe open, No such pseudo-hash field "%s", No | |
1025 | such pseudo-hash field "%s" in variable %s of type %s, No such signal: | |
1026 | SIG%s, Not a CODE reference, Not a format reference, Not a GLOB reference, | |
1027 | Not a HASH reference, Not an ARRAY reference, Not a perl script, Not a | |
1028 | SCALAR reference, Not a subroutine reference, Not a subroutine reference in | |
1029 | overload table, Not enough arguments for %s, Not enough format arguments, | |
1030 | %s: not found, %s not allowed in length fields, no UTC offset information; | |
1031 | assuming local time is UTC, Null filename used, NULL OP IN RUN, Null | |
1032 | picture in formline, Null realloc, NULL regexp argument, NULL regexp | |
1033 | parameter, Number too long, Octal number in vector unsupported, Octal | |
1034 | number > 037777777777 non-portable, Odd number of arguments for | |
1035 | overload::constant, Odd number of elements in anonymous hash, Odd number of | |
1036 | elements in hash assignment, Offset outside string, -%s on unopened | |
1037 | filehandle %s, %s() on unopened %s, oops: oopsAV, oops: oopsHV, Operation | |
1038 | `%s': no method found, %s, Operator or semicolon missing before %s, "our" | |
1039 | variable %s redeclared, Out of memory!, Out of memory during "large" | |
1040 | request for %s, Out of memory during request for %s, Out of memory during | |
1041 | ridiculously large request, Out of memory for yacc stack, @ outside of | |
1042 | string, %s package attribute may clash with future reserved word: %s, page | |
1043 | overflow, panic: %s, panic: ck_grep, panic: ck_split, panic: corrupt saved | |
1044 | stack index, panic: del_backref, panic: die %s, panic: pp_match%s, panic: | |
1045 | do_subst, panic: do_trans_%s, panic: frexp, panic: goto, panic: | |
1046 | INTERPCASEMOD, panic: INTERPCONCAT, panic: kid popen errno read, panic: | |
1047 | last, panic: leave_scope clearsv, panic: leave_scope inconsistency, panic: | |
1048 | magic_killbackrefs, panic: malloc, panic: mapstart, panic: null array, | |
1049 | panic: pad_alloc, panic: pad_free curpad, panic: pad_free po, panic: | |
1050 | pad_reset curpad, panic: pad_sv po, panic: pad_swipe curpad, panic: | |
1051 | pad_swipe po, panic: pp_iter, panic: pp_split, panic: realloc, panic: | |
1052 | restartop, panic: return, panic: scan_num, panic: sv_insert, panic: | |
1053 | top_env, panic: yylex, panic: utf16_to_utf8: odd bytelen, Parentheses | |
1054 | missing around "%s" list, Perl %s required--this is only version %s, | |
1055 | stopped, PERL_SH_DIR too long, perl: warning: Setting locale failed, | |
1056 | perlio: argument list not closed for layer "%s", perlio: invalid separator | |
1057 | character %s in attribute list, perlio: unknown layer "%s", Permission | |
1058 | denied, pid %x not a child, P must have an explicit size, POSIX syntax [%s] | |
1059 | belongs inside character classes in regex;, POSIX syntax [. .] is reserved | |
1060 | for future extensions in regex;, POSIX syntax [= =] is reserved for future | |
1061 | extensions in regex;, POSIX class [:%s:] unknown in regex;, POSIX getpgrp | |
1062 | can't take an argument, Possible attempt to put comments in qw() list, | |
1063 | Possible attempt to separate words with commas, Possible memory corruption: | |
1064 | %s overflowed 3rd argument, Possible unintended interpolation of %s in | |
1065 | string, Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : | |
1066 | ATTRS" instead, Precedence problem: open %s should be open(%s), Premature | |
1067 | end of script headers, printf() on closed filehandle %s, print() on closed | |
1068 | filehandle %s, Process terminated by SIG%s, Prototype mismatch: %s vs %s, | |
1069 | Prototype not terminated, Quantifier in {,} bigger than %d in regex;, | |
1070 | Quantifier unexpected on zero-length expression;, Range iterator outside | |
1071 | integer range, readline() on closed filehandle %s, Reallocation too large: | |
1072 | %lx, realloc() of freed memory ignored, Recompile perl with B<-D>DEBUGGING | |
1073 | to use B<-D> switch, Recursive inheritance detected in package '%s', | |
1074 | Recursive inheritance detected while looking for method %s, Reference found | |
1075 | where even-sized list expected, Reference is already weak, Reference | |
1076 | miscount in sv_replace(), Reference to nonexistent group in regex;, regexp | |
1077 | memory corruption, Regexp out of space, Repeat count in pack overflows, | |
1078 | Repeat count in unpack overflows, Reversed %s= operator, Runaway format, | |
1079 | Scalar value @%s[%s] better written as $%s[%s], Scalar value @%s{%s} better | |
1080 | written as $%s{%s}, Scalars leaked: %d, Script is not setuid/setgid in | |
1081 | suidperl, Search pattern not terminated, %sseek() on unopened filehandle, | |
1082 | select not implemented, Self-ties of arrays and hashes are not supported, | |
1083 | Semicolon seems to be missing, semi-panic: attempt to dup freed string, | |
1084 | sem%s not implemented, send() on closed socket %s, Sequence (? incomplete | |
1085 | in regex; marked by <-- HERE in m/%s/, Sequence (?{...}) not terminated or | |
1086 | not {}-balanced in regex;, Sequence (?%s...) not implemented in regex;, | |
1087 | Sequence (?%s...) not recognized in regex;, Sequence (?#... not terminated | |
1088 | in regex;, 500 Server error, Server error, setegid() not implemented, | |
1089 | seteuid() not implemented, setpgrp can't take arguments, setrgid() not | |
1090 | implemented, setruid() not implemented, setsockopt() on closed socket %s, | |
1091 | Setuid/gid script is writable by world, shm%s not implemented, <> should be | |
1092 | quotes, /%s/ should probably be written as "%s", shutdown() on closed | |
1093 | socket %s, SIG%s handler "%s" not defined, sort is now a reserved word, | |
1094 | Sort subroutine didn't return a numeric value, Sort subroutine didn't | |
1095 | return single value, splice() offset past end of array, Split loop, | |
1096 | Statement unlikely to be reached, stat() on unopened filehandle %s, Stub | |
1097 | found while resolving method `%s' overloading %s, Subroutine %s redefined, | |
1098 | Substitution loop, Substitution pattern not terminated, Substitution | |
1099 | replacement not terminated, substr outside of string, suidperl is no longer | |
1100 | needed since %s, Switch (?(condition)... contains too many branches in | |
1101 | regex;, Switch condition not recognized in regex;, switching effective %s | |
1102 | is not implemented, syntax error, syntax error at line %d: `%s' unexpected, | |
1103 | syntax error in file %s at line %d, next 2 tokens "%s", %s syntax OK, | |
1104 | System V %s is not implemented on this machine, syswrite() on closed | |
1105 | filehandle %s, Target of goto is too deeply nested, tell() on unopened | |
1106 | filehandle, That use of $[ is unsupported, The crypt() function is | |
1107 | unimplemented due to excessive paranoia, The %s function is unimplemented, | |
1108 | The stat preceding %s wasn't an lstat, This Perl can't reset CRTL environ | |
1109 | elements (%s), This Perl can't set CRTL environ elements (%s=%s), times not | |
1110 | implemented, Too few args to syscall, Too late for "B<-T>" option, Too late | |
1111 | for "-%s" option, Too late to run %s block, Too many args to syscall, Too | |
1112 | many arguments for %s, Too many )'s, Too many ('s, Trailing \ in regex | |
1113 | m/%s/, Transliteration pattern not terminated, Transliteration replacement | |
1114 | not terminated, truncate not implemented, Type of arg %d to %s must be %s | |
1115 | (not %s), umask not implemented, Unable to create sub named "%s", | |
1116 | Unbalanced context: %d more PUSHes than POPs, Unbalanced saves: %d more | |
1117 | saves than restores, Unbalanced scopes: %d more ENTERs than LEAVEs, | |
1118 | Unbalanced tmps: %d more allocs than frees, Undefined format "%s" called, | |
1119 | Undefined sort subroutine "%s" called, Undefined subroutine &%s called, | |
1120 | Undefined subroutine called, Undefined subroutine in sort, Undefined top | |
1121 | format "%s" called, Undefined value assigned to typeglob, %s: Undefined | |
1122 | variable, unexec of %s into %s failed!, Unicode character %s is illegal, | |
1123 | Unknown BYTEORDER, Unknown "re" subpragma '%s' (known ones are: %s), | |
1124 | Unknown switch condition (?(%.2s in regex;, Unknown open() mode '%s', | |
1125 | Unknown process %x sent message to prime_env_iter: %s, Unknown warnings | |
1126 | category '%s', unmatched [ in regex; marked by <-- HERE in m/%s/, unmatched | |
1127 | ( in regex; marked by <-- HERE in m/%s/, Unmatched right %s bracket, | |
1128 | Unquoted string "%s" may clash with future reserved word, Unrecognized | |
1129 | character %s, /%s/: Unrecognized escape \\%c in character class passed | |
1130 | through, Unrecognized escape \\%c passed through in regex;, Unrecognized | |
1131 | escape \\%c passed through, Unrecognized signal name "%s", Unrecognized | |
1132 | switch: -%s (-h will show valid options), Unsuccessful %s on filename | |
1133 | containing newline, Unsupported directory function "%s" called, Unsupported | |
1134 | function %s, Unsupported function fork, Unsupported script encoding, | |
1135 | Unsupported socket function "%s" called, Unterminated attribute list, | |
1136 | Unterminated attribute parameter in attribute list, Unterminated compressed | |
1137 | integer, Unterminated <> operator, untie attempted while %d inner | |
1138 | references still exist, Useless (?%s) - use /%s modifier in regex;, Useless | |
1139 | (?-%s) - don't use /%s modifier in regex;, Useless use of %s in void | |
1140 | context, Useless use of "re" pragma, Useless use of sort in scalar context, | |
1141 | Useless use of %s with no values, "use" not allowed in expression, Use of | |
1142 | bare << to mean <<"" is deprecated, Use of *glob{FILEHANDLE} is deprecated, | |
1143 | Use of chdir('') or chdir(undef) as chdir() deprecated, Use of implicit | |
1144 | split to @_ is deprecated, Use of inherited AUTOLOAD for non-method %s() is | |
1145 | deprecated, Use of -l on filehandle %s, Use of "package" with no arguments | |
1146 | is deprecated, Use of %s in printf format not supported, Use of $* is | |
1147 | deprecated, Use of %s is deprecated, Use of $# is deprecated, Use of | |
1148 | reference "%s" as array index, Use of reserved word "%s" is deprecated, Use | |
1149 | of tainted arguments in %s is deprecated, Use of uninitialized value%s, | |
1150 | Using a hash as a reference is deprecated, Using an array as a reference is | |
1151 | deprecated, UTF-16 surrogate %s, Value of %s can be "0"; test with | |
1152 | defined(), Value of CLI symbol "%s" too long, Variable "%s" is not | |
1153 | imported%s, "%s" variable %s masks earlier declaration in same %s, Variable | |
1154 | "%s" may be unavailable, Variable syntax, Variable "%s" will not stay | |
1155 | shared, Variable length lookbehind not implemented in regex;, Version | |
1156 | number must be a constant number, v-string in use/require is non-portable, | |
1157 | Warning: something's wrong, Warning: unable to close filehandle %s | |
1158 | properly, Warning: Use of "%s" without parentheses is ambiguous, Wide | |
1159 | character in %s, write() on closed filehandle %s, X outside of string, x | |
1160 | outside of string, Xsub "%s" called in sort, Xsub called in sort, YOU | |
1161 | HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!, You need to quote "%s" | |
ff426ff2 | 1162 | |
4755096e | 1163 | =back |
68dc0745 | 1164 | |
4755096e | 1165 | =head2 perllexwarn - Perl Lexical Warnings |
68dc0745 | 1166 | |
d420ca49 | 1167 | =over 4 |
68dc0745 | 1168 | |
4755096e | 1169 | =item DESCRIPTION |
68dc0745 | 1170 | |
d420ca49 | 1171 | =over 4 |
68dc0745 | 1172 | |
4755096e | 1173 | =item Default Warnings and Optional Warnings |
14218588 | 1174 | |
4755096e | 1175 | =item What's wrong with B<-w> and C<$^W> |
68dc0745 | 1176 | |
4755096e | 1177 | =item Controlling Warnings from the Command Line |
68dc0745 | 1178 | |
4755096e | 1179 | B<-w>, B<-W>, B<-X> |
a45bd81d | 1180 | |
4755096e | 1181 | =item Backward Compatibility |
68dc0745 | 1182 | |
4755096e | 1183 | =item Category Hierarchy |
a45bd81d | 1184 | |
4755096e | 1185 | =item Fatal Warnings |
68dc0745 | 1186 | |
4755096e | 1187 | =item Reporting Warnings from a Module |
68dc0745 | 1188 | |
4755096e | 1189 | =back |
68dc0745 | 1190 | |
4755096e | 1191 | =item TODO |
68dc0745 | 1192 | |
4755096e | 1193 | =item SEE ALSO |
68dc0745 | 1194 | |
4755096e | 1195 | =item AUTHOR |
68dc0745 | 1196 | |
4755096e | 1197 | =back |
68dc0745 | 1198 | |
10862624 RF |
1199 | =head2 perldebtut - Perl debugging tutorial |
1200 | ||
d420ca49 | 1201 | =over 4 |
10862624 RF |
1202 | |
1203 | =item DESCRIPTION | |
1204 | ||
1205 | =item use strict | |
1206 | ||
ff426ff2 | 1207 | =item Looking at data and -w and v |
d396a558 JH |
1208 | |
1209 | =item help | |
10862624 RF |
1210 | |
1211 | =item Stepping through code | |
1212 | ||
1213 | =item Placeholder for a, w, t, T | |
1214 | ||
d396a558 | 1215 | =item REGULAR EXPRESSIONS |
10862624 | 1216 | |
d396a558 | 1217 | =item OUTPUT TIPS |
10862624 RF |
1218 | |
1219 | =item CGI | |
1220 | ||
1221 | =item GUIs | |
1222 | ||
d396a558 | 1223 | =item SUMMARY |
10862624 RF |
1224 | |
1225 | =item SEE ALSO | |
1226 | ||
1227 | =item AUTHOR | |
1228 | ||
1229 | =item CONTRIBUTORS | |
1230 | ||
1231 | =back | |
1232 | ||
4755096e | 1233 | =head2 perldebug - Perl debugging |
68dc0745 | 1234 | |
d420ca49 | 1235 | =over 4 |
68dc0745 | 1236 | |
4755096e | 1237 | =item DESCRIPTION |
68dc0745 | 1238 | |
4755096e | 1239 | =item The Perl Debugger |
68dc0745 | 1240 | |
d420ca49 | 1241 | =over 4 |
68dc0745 | 1242 | |
4755096e | 1243 | =item Debugger Commands |
68dc0745 | 1244 | |
fa1c7b03 JH |
1245 | h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y |
1246 | [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l | |
1247 | min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, | |
1248 | ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b | |
1249 | subname [condition], b postpone subname [condition], b load filename, b | |
1250 | compile subname, B line, B *, a [line] command, A line, A *, w expr, W | |
1251 | expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ | |
1252 | command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ | |
1253 | command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or | |
1254 | ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] | |
68dc0745 | 1255 | |
4755096e | 1256 | =item Configurable Options |
68dc0745 | 1257 | |
4755096e GS |
1258 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, |
1259 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
a6fb92f1 | 1260 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>, |
12b7c5c7 JH |
1261 | C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>, |
1262 | C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, | |
1263 | C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, | |
1264 | C<NonStop> | |
68dc0745 | 1265 | |
4755096e | 1266 | =item Debugger input/output |
68dc0745 | 1267 | |
4755096e GS |
1268 | Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame |
1269 | listing | |
68dc0745 | 1270 | |
4755096e | 1271 | =item Debugging compile-time statements |
68dc0745 | 1272 | |
4755096e | 1273 | =item Debugger Customization |
68dc0745 | 1274 | |
4755096e | 1275 | =item Readline Support |
68dc0745 | 1276 | |
4755096e | 1277 | =item Editor Support for Debugging |
68dc0745 | 1278 | |
4755096e | 1279 | =item The Perl Profiler |
68dc0745 | 1280 | |
4755096e | 1281 | =back |
68dc0745 | 1282 | |
4755096e | 1283 | =item Debugging regular expressions |
68dc0745 | 1284 | |
4755096e | 1285 | =item Debugging memory usage |
14218588 | 1286 | |
4755096e | 1287 | =item SEE ALSO |
68dc0745 | 1288 | |
4755096e | 1289 | =item BUGS |
68dc0745 | 1290 | |
a45bd81d GS |
1291 | =back |
1292 | ||
c2e66d9e | 1293 | =head2 perlvar - Perl predefined variables |
68dc0745 | 1294 | |
d420ca49 | 1295 | =over 4 |
a45bd81d | 1296 | |
68dc0745 | 1297 | =item DESCRIPTION |
1298 | ||
d420ca49 | 1299 | =over 4 |
68dc0745 | 1300 | |
c2e66d9e | 1301 | =item Predefined Names |
68dc0745 | 1302 | |
640374d0 | 1303 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
354a27bf | 1304 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, |
53d7eaa8 JH |
1305 | HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, |
1306 | IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, | |
1307 | HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, | |
2a2bf5f4 JH |
1308 | IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, |
1309 | IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, | |
1310 | $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, | |
53d7eaa8 JH |
1311 | HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, |
1312 | HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, | |
1313 | HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, | |
2a2bf5f4 JH |
1314 | @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as |
1315 | C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, | |
1316 | $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> | |
1317 | is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as | |
53d7eaa8 JH |
1318 | C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), |
1319 | $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, | |
2a2bf5f4 JH |
1320 | IO::Handle->format_line_break_characters EXPR, |
1321 | $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, | |
cb52f95f | 1322 | $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, |
fa1c7b03 | 1323 | $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, |
cb52f95f JH |
1324 | $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, |
1325 | $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), | |
1326 | $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, | |
1327 | $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, | |
428dc699 JH |
1328 | ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, |
1329 | 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, | |
1330 | $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, | |
1331 | ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, | |
1332 | $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} | |
68dc0745 | 1333 | |
c2e66d9e | 1334 | =item Error Indicators |
68dc0745 | 1335 | |
c2e66d9e | 1336 | =item Technical Note on the Syntax of Variable Names |
4755096e | 1337 | |
c2e66d9e GS |
1338 | =back |
1339 | ||
1340 | =item BUGS | |
4755096e GS |
1341 | |
1342 | =back | |
1343 | ||
c2e66d9e | 1344 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
4755096e | 1345 | |
d420ca49 | 1346 | =over 4 |
c2e66d9e GS |
1347 | |
1348 | =item DESCRIPTION | |
1349 | ||
4d4e713d JH |
1350 | =over 4 |
1351 | ||
c2e66d9e GS |
1352 | =item Declaration and Access of Arrays of Arrays |
1353 | ||
1354 | =item Growing Your Own | |
1355 | ||
1356 | =item Access and Printing | |
1357 | ||
1358 | =item Slices | |
1359 | ||
4d4e713d JH |
1360 | =back |
1361 | ||
c2e66d9e GS |
1362 | =item SEE ALSO |
1363 | ||
1364 | =item AUTHOR | |
4755096e GS |
1365 | |
1366 | =back | |
1367 | ||
c2e66d9e | 1368 | =head2 perlopentut - tutorial on opening things in Perl |
4755096e | 1369 | |
d420ca49 | 1370 | =over 4 |
4755096e GS |
1371 | |
1372 | =item DESCRIPTION | |
1373 | ||
c2e66d9e GS |
1374 | =item Open E<agrave> la shell |
1375 | ||
d420ca49 | 1376 | =over 4 |
4755096e | 1377 | |
c2e66d9e | 1378 | =item Simple Opens |
4755096e | 1379 | |
c2e66d9e | 1380 | =item Pipe Opens |
4755096e | 1381 | |
c2e66d9e | 1382 | =item The Minus File |
4755096e | 1383 | |
c2e66d9e | 1384 | =item Mixing Reads and Writes |
4755096e GS |
1385 | |
1386 | =item Filters | |
1387 | ||
1388 | =back | |
1389 | ||
1390 | =item Open E<agrave> la C | |
1391 | ||
d420ca49 | 1392 | =over 4 |
4755096e GS |
1393 | |
1394 | =item Permissions E<agrave> la mode | |
1395 | ||
1396 | =back | |
1397 | ||
1398 | =item Obscure Open Tricks | |
1399 | ||
d420ca49 | 1400 | =over 4 |
4755096e GS |
1401 | |
1402 | =item Re-Opening Files (dups) | |
1403 | ||
1404 | =item Dispelling the Dweomer | |
1405 | ||
1406 | =item Paths as Opens | |
1407 | ||
1408 | =item Single Argument Open | |
1409 | ||
1410 | =item Playing with STDIN and STDOUT | |
1411 | ||
1412 | =back | |
1413 | ||
1414 | =item Other I/O Issues | |
1415 | ||
d420ca49 | 1416 | =over 4 |
4755096e GS |
1417 | |
1418 | =item Opening Non-File Files | |
1419 | ||
1420 | =item Binary Files | |
1421 | ||
1422 | =item File Locking | |
1423 | ||
1424 | =back | |
1425 | ||
1426 | =item SEE ALSO | |
1427 | ||
1428 | =item AUTHOR and COPYRIGHT | |
1429 | ||
1430 | =item HISTORY | |
1431 | ||
1432 | =back | |
1433 | ||
34babc16 JH |
1434 | =head2 perlpacktut - tutorial on C<pack> and C<unpack> |
1435 | ||
1436 | =over 4 | |
1437 | ||
1438 | =item DESCRIPTION | |
1439 | ||
1440 | =item The Basic Principle | |
1441 | ||
1442 | =item Packing Text | |
1443 | ||
1444 | =item Packing Numbers | |
1445 | ||
1446 | =over 4 | |
1447 | ||
1448 | =item Integers | |
1449 | ||
1450 | =item Unpacking a Stack Frame | |
1451 | ||
1452 | =item How to Eat an Egg on a Net | |
1453 | ||
1454 | =item Floating point Numbers | |
1455 | ||
1456 | =back | |
1457 | ||
1458 | =item Exotic Templates | |
1459 | ||
1460 | =over 4 | |
1461 | ||
1462 | =item Bit Strings | |
1463 | ||
1464 | =item Uuencoding | |
1465 | ||
1466 | =item Doing Sums | |
1467 | ||
1468 | =item Unicode | |
1469 | ||
493a87da JH |
1470 | =item Another Portable Binary Encoding |
1471 | ||
34babc16 JH |
1472 | =back |
1473 | ||
1474 | =item Lengths and Widths | |
1475 | ||
1476 | =over 4 | |
1477 | ||
1478 | =item String Lengths | |
1479 | ||
1480 | =item Dynamic Templates | |
1481 | ||
34babc16 JH |
1482 | =back |
1483 | ||
1484 | =item Packing and Unpacking C Structures | |
1485 | ||
1486 | =over 4 | |
1487 | ||
1488 | =item The Alignment Pit | |
1489 | ||
1490 | =item Alignment, Take 2 | |
1491 | ||
248e172a JH |
1492 | =item Alignment, Take 3 |
1493 | ||
34babc16 JH |
1494 | =item Pointers for How to Use Them |
1495 | ||
1496 | =back | |
1497 | ||
1498 | =item Pack Recipes | |
1499 | ||
493a87da JH |
1500 | =item Funnies Section |
1501 | ||
34babc16 JH |
1502 | =item Authors |
1503 | ||
1504 | =back | |
1505 | ||
c2e66d9e | 1506 | =head2 perlretut - Perl regular expressions tutorial |
4755096e | 1507 | |
d420ca49 | 1508 | =over 4 |
4755096e GS |
1509 | |
1510 | =item DESCRIPTION | |
1511 | ||
c2e66d9e | 1512 | =item Part 1: The basics |
4755096e | 1513 | |
d420ca49 | 1514 | =over 4 |
4755096e | 1515 | |
c2e66d9e | 1516 | =item Simple word matching |
4755096e | 1517 | |
c2e66d9e | 1518 | =item Using character classes |
4755096e | 1519 | |
c2e66d9e | 1520 | =item Matching this or that |
4755096e | 1521 | |
c2e66d9e | 1522 | =item Grouping things and hierarchical matching |
4755096e | 1523 | |
c2e66d9e | 1524 | =item Extracting matches |
4755096e | 1525 | |
c2e66d9e | 1526 | =item Matching repetitions |
4755096e | 1527 | |
c2e66d9e | 1528 | =item Building a regexp |
4755096e | 1529 | |
c2e66d9e | 1530 | =item Using regular expressions in Perl |
4755096e | 1531 | |
c2e66d9e | 1532 | =back |
4755096e | 1533 | |
c2e66d9e | 1534 | =item Part 2: Power tools |
4755096e | 1535 | |
d420ca49 | 1536 | =over 4 |
4755096e | 1537 | |
c2e66d9e | 1538 | =item More on characters, strings, and character classes |
4755096e | 1539 | |
c2e66d9e | 1540 | =item Compiling and saving regular expressions |
4755096e | 1541 | |
c2e66d9e | 1542 | =item Embedding comments and modifiers in a regular expression |
4755096e | 1543 | |
c2e66d9e | 1544 | =item Non-capturing groupings |
4755096e | 1545 | |
c2e66d9e | 1546 | =item Looking ahead and looking behind |
4755096e | 1547 | |
c2e66d9e | 1548 | =item Using independent subexpressions to prevent backtracking |
4755096e | 1549 | |
c2e66d9e | 1550 | =item Conditional expressions |
4755096e | 1551 | |
c2e66d9e | 1552 | =item A bit of magic: executing Perl code in a regular expression |
4755096e | 1553 | |
c2e66d9e | 1554 | =item Pragmas and debugging |
4755096e GS |
1555 | |
1556 | =back | |
1557 | ||
c2e66d9e | 1558 | =item BUGS |
4755096e | 1559 | |
c2e66d9e | 1560 | =item SEE ALSO |
4755096e | 1561 | |
c2e66d9e | 1562 | =item AUTHOR AND COPYRIGHT |
4755096e | 1563 | |
d420ca49 | 1564 | =over 4 |
4755096e | 1565 | |
c2e66d9e | 1566 | =item Acknowledgments |
4755096e GS |
1567 | |
1568 | =back | |
1569 | ||
4755096e GS |
1570 | =back |
1571 | ||
c2e66d9e | 1572 | =head2 perlre - Perl regular expressions |
4755096e | 1573 | |
d420ca49 | 1574 | =over 4 |
4755096e GS |
1575 | |
1576 | =item DESCRIPTION | |
1577 | ||
c2e66d9e | 1578 | i, m, s, x |
4755096e | 1579 | |
d420ca49 | 1580 | =over 4 |
4755096e | 1581 | |
c2e66d9e | 1582 | =item Regular Expressions |
4755096e | 1583 | |
428dc699 | 1584 | [1], [2], [3], cntrl, graph, print, punct, xdigit |
4755096e | 1585 | |
c2e66d9e | 1586 | =item Extended Patterns |
4755096e | 1587 | |
c2e66d9e GS |
1588 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, |
1589 | C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ | |
1590 | code })>, C<(??{ code })>, C<< (?>pattern) >>, | |
1591 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
4755096e | 1592 | |
c2e66d9e | 1593 | =item Backtracking |
4755096e | 1594 | |
c2e66d9e | 1595 | =item Version 8 Regular Expressions |
4755096e | 1596 | |
c2e66d9e | 1597 | =item Warning on \1 vs $1 |
4755096e | 1598 | |
c2e66d9e GS |
1599 | =item Repeated patterns matching zero-length substring |
1600 | ||
1601 | =item Combining pieces together | |
1602 | ||
1603 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, | |
1604 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
1605 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
1606 | C<(?(condition)yes-pattern|no-pattern)> | |
1607 | ||
1608 | =item Creating custom RE engines | |
4755096e GS |
1609 | |
1610 | =back | |
1611 | ||
c2e66d9e | 1612 | =item BUGS |
4755096e | 1613 | |
c2e66d9e | 1614 | =item SEE ALSO |
4755096e | 1615 | |
c2e66d9e GS |
1616 | =back |
1617 | ||
d396a558 JH |
1618 | =head2 perlref - Perl references and nested data structures |
1619 | ||
d420ca49 | 1620 | =over 4 |
d396a558 JH |
1621 | |
1622 | =item NOTE | |
1623 | ||
1624 | =item DESCRIPTION | |
1625 | ||
d420ca49 | 1626 | =over 4 |
d396a558 JH |
1627 | |
1628 | =item Making References | |
1629 | ||
1630 | =item Using References | |
1631 | ||
1632 | =item Symbolic references | |
1633 | ||
1634 | =item Not-so-symbolic references | |
1635 | ||
1636 | =item Pseudo-hashes: Using an array as a hash | |
1637 | ||
1638 | =item Function Templates | |
1639 | ||
1640 | =back | |
1641 | ||
1642 | =item WARNING | |
1643 | ||
1644 | =item SEE ALSO | |
1645 | ||
1646 | =back | |
1647 | ||
c2e66d9e | 1648 | =head2 perlform - Perl formats |
4755096e | 1649 | |
d420ca49 | 1650 | =over 4 |
4755096e | 1651 | |
c2e66d9e | 1652 | =item DESCRIPTION |
4755096e | 1653 | |
d420ca49 | 1654 | =over 4 |
4755096e | 1655 | |
c2e66d9e | 1656 | =item Format Variables |
4755096e | 1657 | |
c2e66d9e | 1658 | =back |
4755096e | 1659 | |
c2e66d9e | 1660 | =item NOTES |
4755096e | 1661 | |
d420ca49 | 1662 | =over 4 |
c2e66d9e GS |
1663 | |
1664 | =item Footers | |
1665 | ||
1666 | =item Accessing Formatting Internals | |
4755096e GS |
1667 | |
1668 | =back | |
1669 | ||
c2e66d9e | 1670 | =item WARNINGS |
4755096e GS |
1671 | |
1672 | =back | |
1673 | ||
d396a558 | 1674 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
4755096e | 1675 | |
d420ca49 | 1676 | =over 4 |
4755096e GS |
1677 | |
1678 | =item DESCRIPTION | |
1679 | ||
d420ca49 | 1680 | =over 4 |
c2e66d9e | 1681 | |
d396a558 JH |
1682 | =item If we could talk to the animals... |
1683 | ||
1684 | =item Introducing the method invocation arrow | |
1685 | ||
1686 | =item Invoking a barnyard | |
1687 | ||
1688 | =item The extra parameter of method invocation | |
1689 | ||
1690 | =item Calling a second method to simplify things | |
1691 | ||
1692 | =item Inheriting the windpipes | |
1693 | ||
1694 | =item A few notes about @ISA | |
1695 | ||
1696 | =item Overriding the methods | |
1697 | ||
1698 | =item Starting the search from a different place | |
1699 | ||
1700 | =item The SUPER way of doing things | |
1701 | ||
1702 | =item Where we're at so far... | |
1703 | ||
1704 | =item A horse is a horse, of course of course -- or is it? | |
1705 | ||
1706 | =item Invoking an instance method | |
1707 | ||
1708 | =item Accessing the instance data | |
1709 | ||
1710 | =item How to build a horse | |
1711 | ||
1712 | =item Inheriting the constructor | |
1713 | ||
1714 | =item Making a method work with either classes or instances | |
1715 | ||
1716 | =item Adding parameters to a method | |
1717 | ||
1718 | =item More interesting instances | |
1719 | ||
1720 | =item A horse of a different color | |
1721 | ||
1722 | =item Summary | |
1723 | ||
1724 | =back | |
1725 | ||
1726 | =item SEE ALSO | |
1727 | ||
1728 | =item COPYRIGHT | |
1729 | ||
1730 | =back | |
1731 | ||
1732 | =head2 perltoot - Tom's object-oriented tutorial for perl | |
c2e66d9e | 1733 | |
d420ca49 | 1734 | =over 4 |
4755096e | 1735 | |
d396a558 | 1736 | =item DESCRIPTION |
4755096e | 1737 | |
d396a558 | 1738 | =item Creating a Class |
4755096e | 1739 | |
d420ca49 | 1740 | =over 4 |
4755096e | 1741 | |
d396a558 | 1742 | =item Object Representation |
4755096e | 1743 | |
d396a558 | 1744 | =item Class Interface |
4755096e | 1745 | |
d396a558 | 1746 | =item Constructors and Instance Methods |
c2e66d9e | 1747 | |
d396a558 | 1748 | =item Planning for the Future: Better Constructors |
c2e66d9e | 1749 | |
d396a558 | 1750 | =item Destructors |
c2e66d9e | 1751 | |
d396a558 | 1752 | =item Other Object Methods |
4755096e GS |
1753 | |
1754 | =back | |
1755 | ||
d396a558 | 1756 | =item Class Data |
4755096e | 1757 | |
d420ca49 | 1758 | =over 4 |
4755096e | 1759 | |
d396a558 | 1760 | =item Accessing Class Data |
4755096e | 1761 | |
d396a558 | 1762 | =item Debugging Methods |
4755096e | 1763 | |
d396a558 | 1764 | =item Class Destructors |
4755096e | 1765 | |
d396a558 | 1766 | =item Documenting the Interface |
4755096e | 1767 | |
d396a558 | 1768 | =back |
4755096e | 1769 | |
d396a558 JH |
1770 | =item Aggregation |
1771 | ||
1772 | =item Inheritance | |
1773 | ||
d420ca49 | 1774 | =over 4 |
d396a558 JH |
1775 | |
1776 | =item Overridden Methods | |
1777 | ||
1778 | =item Multiple Inheritance | |
1779 | ||
1780 | =item UNIVERSAL: The Root of All Objects | |
4755096e | 1781 | |
c2e66d9e | 1782 | =back |
4755096e | 1783 | |
d396a558 | 1784 | =item Alternate Object Representations |
4755096e | 1785 | |
d420ca49 | 1786 | =over 4 |
4755096e | 1787 | |
d396a558 | 1788 | =item Arrays as Objects |
4755096e | 1789 | |
d396a558 JH |
1790 | =item Closures as Objects |
1791 | ||
1792 | =back | |
1793 | ||
1794 | =item AUTOLOAD: Proxy Methods | |
1795 | ||
d420ca49 | 1796 | =over 4 |
d396a558 JH |
1797 | |
1798 | =item Autoloaded Data Methods | |
1799 | ||
1800 | =item Inherited Autoloaded Data Methods | |
1801 | ||
1802 | =back | |
1803 | ||
1804 | =item Metaclassical Tools | |
1805 | ||
d420ca49 | 1806 | =over 4 |
d396a558 JH |
1807 | |
1808 | =item Class::Struct | |
1809 | ||
1810 | =item Data Members as Variables | |
4755096e | 1811 | |
d420ca49 AD |
1812 | =back |
1813 | ||
c2e66d9e | 1814 | =item NOTES |
4755096e | 1815 | |
d420ca49 AD |
1816 | =over 4 |
1817 | ||
d396a558 JH |
1818 | =item Object Terminology |
1819 | ||
1820 | =back | |
1821 | ||
1822 | =item SEE ALSO | |
1823 | ||
1824 | =item AUTHOR AND COPYRIGHT | |
1825 | ||
1826 | =item COPYRIGHT | |
1827 | ||
d420ca49 | 1828 | =over 4 |
c2e66d9e | 1829 | |
d396a558 | 1830 | =item Acknowledgments |
c2e66d9e | 1831 | |
d396a558 | 1832 | =back |
c2e66d9e | 1833 | |
d396a558 | 1834 | =back |
c2e66d9e | 1835 | |
890a53b9 | 1836 | =head2 perltooc - Tom's OO Tutorial for Class Data in Perl |
c2e66d9e | 1837 | |
d420ca49 | 1838 | =over 4 |
c2e66d9e | 1839 | |
d396a558 | 1840 | =item DESCRIPTION |
c2e66d9e | 1841 | |
dc5c060f JH |
1842 | =item Class Data in a Can |
1843 | ||
d396a558 JH |
1844 | =item Class Data as Package Variables |
1845 | ||
d420ca49 | 1846 | =over 4 |
d396a558 JH |
1847 | |
1848 | =item Putting All Your Eggs in One Basket | |
1849 | ||
1850 | =item Inheritance Concerns | |
1851 | ||
1852 | =item The Eponymous Meta-Object | |
1853 | ||
1854 | =item Indirect References to Class Data | |
1855 | ||
1856 | =item Monadic Classes | |
1857 | ||
1858 | =item Translucent Attributes | |
4755096e GS |
1859 | |
1860 | =back | |
1861 | ||
d396a558 | 1862 | =item Class Data as Lexical Variables |
4755096e | 1863 | |
d420ca49 | 1864 | =over 4 |
4755096e | 1865 | |
d396a558 JH |
1866 | =item Privacy and Responsibility |
1867 | ||
1868 | =item File-Scoped Lexicals | |
1869 | ||
1870 | =item More Inheritance Concerns | |
1871 | ||
1872 | =item Locking the Door and Throwing Away the Key | |
1873 | ||
1874 | =item Translucency Revisited | |
4755096e | 1875 | |
c2e66d9e | 1876 | =back |
4755096e | 1877 | |
d396a558 JH |
1878 | =item NOTES |
1879 | ||
c2e66d9e | 1880 | =item SEE ALSO |
4755096e | 1881 | |
d396a558 JH |
1882 | =item AUTHOR AND COPYRIGHT |
1883 | ||
1884 | =item ACKNOWLEDGEMENTS | |
1885 | ||
c2e66d9e | 1886 | =item HISTORY |
4755096e | 1887 | |
c2e66d9e | 1888 | =back |
4755096e | 1889 | |
d396a558 | 1890 | =head2 perlobj - Perl objects |
4755096e | 1891 | |
d420ca49 | 1892 | =over 4 |
4755096e | 1893 | |
c2e66d9e | 1894 | =item DESCRIPTION |
4755096e | 1895 | |
d420ca49 | 1896 | =over 4 |
4755096e | 1897 | |
d396a558 | 1898 | =item An Object is Simply a Reference |
4755096e | 1899 | |
d396a558 | 1900 | =item A Class is Simply a Package |
4755096e | 1901 | |
d396a558 | 1902 | =item A Method is Simply a Subroutine |
4755096e | 1903 | |
d396a558 | 1904 | =item Method Invocation |
4755096e | 1905 | |
bd28ded5 | 1906 | =item Indirect Object Syntax |
d396a558 JH |
1907 | |
1908 | =item Default UNIVERSAL methods | |
1909 | ||
1910 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
1911 | ||
1912 | =item Destructors | |
1913 | ||
1914 | =item Summary | |
1915 | ||
1916 | =item Two-Phased Garbage Collection | |
4755096e | 1917 | |
c2e66d9e | 1918 | =back |
4755096e | 1919 | |
d396a558 JH |
1920 | =item SEE ALSO |
1921 | ||
1922 | =back | |
1923 | ||
1924 | =head2 perlbot - Bag'o Object Tricks (the BOT) | |
1925 | ||
d420ca49 | 1926 | =over 4 |
d396a558 JH |
1927 | |
1928 | =item DESCRIPTION | |
1929 | ||
1930 | =item OO SCALING TIPS | |
1931 | ||
1932 | =item INSTANCE VARIABLES | |
1933 | ||
1934 | =item SCALAR INSTANCE VARIABLES | |
1935 | ||
1936 | =item INSTANCE VARIABLE INHERITANCE | |
1937 | ||
1938 | =item OBJECT RELATIONSHIPS | |
1939 | ||
1940 | =item OVERRIDING SUPERCLASS METHODS | |
1941 | ||
1942 | =item USING RELATIONSHIP WITH SDBM | |
1943 | ||
1944 | =item THINKING OF CODE REUSE | |
1945 | ||
1946 | =item CLASS CONTEXT AND THE OBJECT | |
1947 | ||
1948 | =item INHERITING A CONSTRUCTOR | |
1949 | ||
1950 | =item DELEGATION | |
1951 | ||
1952 | =back | |
1953 | ||
1954 | =head2 perltie - how to hide an object class in a simple variable | |
1955 | ||
d420ca49 | 1956 | =over 4 |
d396a558 JH |
1957 | |
1958 | =item SYNOPSIS | |
1959 | ||
1960 | =item DESCRIPTION | |
1961 | ||
d420ca49 | 1962 | =over 4 |
d396a558 JH |
1963 | |
1964 | =item Tying Scalars | |
1965 | ||
93d73c42 JH |
1966 | TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, |
1967 | DESTROY this | |
d396a558 JH |
1968 | |
1969 | =item Tying Arrays | |
1970 | ||
1971 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, | |
165c0277 JH |
1972 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
1973 | key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this, | |
1974 | UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY | |
1975 | this | |
d396a558 JH |
1976 | |
1977 | =item Tying Hashes | |
1978 | ||
1979 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE | |
1980 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
93d73c42 | 1981 | this, NEXTKEY this, lastkey, UNTIE this, DESTROY this |
d396a558 JH |
1982 | |
1983 | =item Tying FileHandles | |
1984 | ||
1985 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, | |
93d73c42 JH |
1986 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, |
1987 | DESTROY this | |
d396a558 | 1988 | |
9fa7f388 JH |
1989 | =item UNTIE this |
1990 | ||
d396a558 JH |
1991 | =item The C<untie> Gotcha |
1992 | ||
1993 | =back | |
4755096e | 1994 | |
c2e66d9e | 1995 | =item SEE ALSO |
4755096e | 1996 | |
d396a558 JH |
1997 | =item BUGS |
1998 | ||
1999 | =item AUTHOR | |
2000 | ||
c2e66d9e | 2001 | =back |
4755096e | 2002 | |
c2e66d9e GS |
2003 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
2004 | safe subprocesses, sockets, and semaphores) | |
4755096e | 2005 | |
d420ca49 | 2006 | =over 4 |
4755096e | 2007 | |
c2e66d9e | 2008 | =item DESCRIPTION |
4755096e | 2009 | |
c2e66d9e | 2010 | =item Signals |
4755096e | 2011 | |
c2e66d9e | 2012 | =item Named Pipes |
4755096e | 2013 | |
d420ca49 | 2014 | =over 4 |
4755096e | 2015 | |
c2e66d9e | 2016 | =item WARNING |
4755096e | 2017 | |
c2e66d9e | 2018 | =back |
4755096e | 2019 | |
c2e66d9e | 2020 | =item Using open() for IPC |
4755096e | 2021 | |
d420ca49 | 2022 | =over 4 |
4755096e | 2023 | |
c2e66d9e | 2024 | =item Filehandles |
4755096e | 2025 | |
c2e66d9e | 2026 | =item Background Processes |
4755096e | 2027 | |
c2e66d9e | 2028 | =item Complete Dissociation of Child from Parent |
4755096e | 2029 | |
c2e66d9e | 2030 | =item Safe Pipe Opens |
4755096e | 2031 | |
c2e66d9e | 2032 | =item Bidirectional Communication with Another Process |
4755096e | 2033 | |
c2e66d9e | 2034 | =item Bidirectional Communication with Yourself |
4755096e GS |
2035 | |
2036 | =back | |
2037 | ||
c2e66d9e | 2038 | =item Sockets: Client/Server Communication |
4755096e | 2039 | |
d420ca49 | 2040 | =over 4 |
4755096e | 2041 | |
c2e66d9e | 2042 | =item Internet Line Terminators |
4755096e | 2043 | |
c2e66d9e | 2044 | =item Internet TCP Clients and Servers |
4755096e | 2045 | |
c2e66d9e GS |
2046 | =item Unix-Domain TCP Clients and Servers |
2047 | ||
2048 | =back | |
2049 | ||
2050 | =item TCP Clients with IO::Socket | |
4755096e | 2051 | |
d420ca49 | 2052 | =over 4 |
4755096e | 2053 | |
c2e66d9e | 2054 | =item A Simple Client |
4755096e | 2055 | |
c2e66d9e | 2056 | C<Proto>, C<PeerAddr>, C<PeerPort> |
4755096e | 2057 | |
c2e66d9e | 2058 | =item A Webget Client |
4755096e | 2059 | |
c2e66d9e | 2060 | =item Interactive Client with IO::Socket |
4755096e | 2061 | |
c2e66d9e | 2062 | =back |
4755096e | 2063 | |
c2e66d9e | 2064 | =item TCP Servers with IO::Socket |
4755096e | 2065 | |
c2e66d9e | 2066 | Proto, LocalPort, Listen, Reuse |
4755096e | 2067 | |
c2e66d9e | 2068 | =item UDP: Message Passing |
4755096e | 2069 | |
c2e66d9e | 2070 | =item SysV IPC |
4755096e | 2071 | |
c2e66d9e | 2072 | =item NOTES |
4755096e | 2073 | |
c2e66d9e | 2074 | =item BUGS |
4755096e | 2075 | |
c2e66d9e | 2076 | =item AUTHOR |
4755096e | 2077 | |
c2e66d9e | 2078 | =item SEE ALSO |
4755096e GS |
2079 | |
2080 | =back | |
2081 | ||
bd28ded5 | 2082 | =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) |
4755096e | 2083 | |
d420ca49 | 2084 | =over 4 |
4755096e | 2085 | |
c2e66d9e GS |
2086 | =item SYNOPSIS |
2087 | ||
2088 | =item DESCRIPTION | |
4755096e | 2089 | |
d420ca49 | 2090 | =over 4 |
4755096e | 2091 | |
c2e66d9e | 2092 | =item Behavior of other Perl features in forked pseudo-processes |
4755096e | 2093 | |
c2e66d9e GS |
2094 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
2095 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
2096 | files, directories and network sockets | |
4755096e | 2097 | |
c2e66d9e | 2098 | =item Resource limits |
4755096e | 2099 | |
c2e66d9e | 2100 | =item Killing the parent process |
4755096e | 2101 | |
c2e66d9e | 2102 | =item Lifetime of the parent process and pseudo-processes |
4755096e | 2103 | |
c2e66d9e | 2104 | =item CAVEATS AND LIMITATIONS |
4755096e | 2105 | |
c2e66d9e GS |
2106 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
2107 | Global state maintained by XSUBs, Interpreter embedded in larger | |
2108 | application, Thread-safety of extensions | |
4755096e | 2109 | |
c2e66d9e | 2110 | =back |
4755096e | 2111 | |
c2e66d9e GS |
2112 | =item BUGS |
2113 | ||
2114 | =item AUTHOR | |
2115 | ||
2116 | =item SEE ALSO | |
4755096e GS |
2117 | |
2118 | =back | |
2119 | ||
c2e66d9e | 2120 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
4755096e | 2121 | |
d420ca49 | 2122 | =over 4 |
4755096e | 2123 | |
c2e66d9e | 2124 | =item SYNOPSIS |
4755096e | 2125 | |
c2e66d9e | 2126 | =item DESCRIPTION |
4755096e | 2127 | |
c2e66d9e | 2128 | =item Storing numbers |
4755096e | 2129 | |
c2e66d9e | 2130 | =item Numeric operators and numeric conversions |
4755096e | 2131 | |
c2e66d9e | 2132 | =item Flavors of Perl numeric operations |
4755096e | 2133 | |
c2e66d9e GS |
2134 | Arithmetic operators except, C<no integer>, Arithmetic operators except, |
2135 | C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use | |
2136 | integer>, Operators which expect an integer, Operators which expect a | |
2137 | string | |
4755096e | 2138 | |
c2e66d9e | 2139 | =item AUTHOR |
4755096e | 2140 | |
c2e66d9e | 2141 | =item SEE ALSO |
4755096e GS |
2142 | |
2143 | =back | |
2144 | ||
c2e66d9e | 2145 | =head2 perlthrtut - tutorial on threads in Perl |
4755096e | 2146 | |
d420ca49 | 2147 | =over 4 |
4755096e GS |
2148 | |
2149 | =item DESCRIPTION | |
2150 | ||
53d7eaa8 JH |
2151 | =back |
2152 | ||
2153 | =head2 perlothrtut - old tutorial on threads in Perl | |
2154 | ||
2155 | =over 4 | |
2156 | ||
2157 | =item DESCRIPTION | |
2158 | ||
c2e66d9e | 2159 | =item What Is A Thread Anyway? |
4755096e | 2160 | |
c2e66d9e | 2161 | =item Threaded Program Models |
4755096e | 2162 | |
d420ca49 | 2163 | =over 4 |
4755096e | 2164 | |
c2e66d9e | 2165 | =item Boss/Worker |
4755096e | 2166 | |
c2e66d9e | 2167 | =item Work Crew |
4755096e | 2168 | |
c2e66d9e | 2169 | =item Pipeline |
4755096e GS |
2170 | |
2171 | =back | |
2172 | ||
c2e66d9e | 2173 | =item Native threads |
4755096e | 2174 | |
c2e66d9e | 2175 | =item What kind of threads are perl threads? |
4755096e | 2176 | |
c2e66d9e | 2177 | =item Threadsafe Modules |
4755096e | 2178 | |
c2e66d9e | 2179 | =item Thread Basics |
4755096e | 2180 | |
d420ca49 | 2181 | =over 4 |
4755096e | 2182 | |
c2e66d9e | 2183 | =item Basic Thread Support |
4755096e | 2184 | |
c2e66d9e | 2185 | =item Creating Threads |
4755096e | 2186 | |
c2e66d9e | 2187 | =item Giving up control |
4755096e | 2188 | |
c2e66d9e | 2189 | =item Waiting For A Thread To Exit |
4755096e | 2190 | |
c2e66d9e | 2191 | =item Errors In Threads |
4755096e | 2192 | |
c2e66d9e | 2193 | =item Ignoring A Thread |
4755096e GS |
2194 | |
2195 | =back | |
2196 | ||
c2e66d9e | 2197 | =item Threads And Data |
4755096e | 2198 | |
d420ca49 | 2199 | =over 4 |
4755096e | 2200 | |
c2e66d9e | 2201 | =item Shared And Unshared Data |
4755096e | 2202 | |
c2e66d9e | 2203 | =item Thread Pitfall: Races |
4755096e | 2204 | |
c2e66d9e | 2205 | =item Controlling access: lock() |
4755096e | 2206 | |
c2e66d9e | 2207 | =item Thread Pitfall: Deadlocks |
4755096e | 2208 | |
c2e66d9e | 2209 | =item Queues: Passing Data Around |
4755096e | 2210 | |
c2e66d9e | 2211 | =back |
4755096e | 2212 | |
c2e66d9e | 2213 | =item Threads And Code |
4755096e | 2214 | |
d420ca49 | 2215 | =over 4 |
4755096e | 2216 | |
c2e66d9e | 2217 | =item Semaphores: Synchronizing Data Access |
4755096e | 2218 | |
c2e66d9e | 2219 | Basic semaphores, Advanced Semaphores |
4755096e | 2220 | |
c2e66d9e | 2221 | =item Attributes: Restricting Access To Subroutines |
4755096e | 2222 | |
c2e66d9e | 2223 | =item Subroutine Locks |
4755096e | 2224 | |
c2e66d9e | 2225 | =item Methods |
4755096e | 2226 | |
c2e66d9e | 2227 | =item Locking A Subroutine |
4755096e GS |
2228 | |
2229 | =back | |
2230 | ||
c2e66d9e | 2231 | =item General Thread Utility Routines |
4755096e | 2232 | |
d420ca49 | 2233 | =over 4 |
4755096e | 2234 | |
c2e66d9e | 2235 | =item What Thread Am I In? |
4755096e | 2236 | |
c2e66d9e | 2237 | =item Thread IDs |
4755096e | 2238 | |
c2e66d9e | 2239 | =item Are These Threads The Same? |
4755096e | 2240 | |
c2e66d9e | 2241 | =item What Threads Are Running? |
4755096e | 2242 | |
c2e66d9e | 2243 | =back |
4755096e | 2244 | |
c2e66d9e | 2245 | =item A Complete Example |
4755096e | 2246 | |
c2e66d9e | 2247 | =item Conclusion |
4755096e | 2248 | |
c2e66d9e | 2249 | =item Bibliography |
4755096e | 2250 | |
d420ca49 | 2251 | =over 4 |
4755096e | 2252 | |
c2e66d9e | 2253 | =item Introductory Texts |
4755096e | 2254 | |
c2e66d9e | 2255 | =item OS-Related References |
4755096e | 2256 | |
c2e66d9e | 2257 | =item Other References |
4755096e GS |
2258 | |
2259 | =back | |
2260 | ||
c2e66d9e | 2261 | =item Acknowledgements |
4755096e | 2262 | |
c2e66d9e | 2263 | =item AUTHOR |
4755096e | 2264 | |
c2e66d9e | 2265 | =item Copyrights |
4755096e | 2266 | |
c2e66d9e | 2267 | =back |
4755096e | 2268 | |
c2e66d9e | 2269 | =head2 perlport - Writing portable Perl |
4755096e | 2270 | |
d420ca49 | 2271 | =over 4 |
4755096e | 2272 | |
c2e66d9e | 2273 | =item DESCRIPTION |
4755096e | 2274 | |
c2e66d9e GS |
2275 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
2276 | portable | |
4755096e | 2277 | |
c2e66d9e | 2278 | =item ISSUES |
4755096e | 2279 | |
d420ca49 | 2280 | =over 4 |
4755096e | 2281 | |
c2e66d9e | 2282 | =item Newlines |
4755096e | 2283 | |
c2e66d9e | 2284 | =item Numbers endianness and Width |
4755096e | 2285 | |
c2e66d9e | 2286 | =item Files and Filesystems |
4755096e | 2287 | |
c2e66d9e | 2288 | =item System Interaction |
4755096e | 2289 | |
c2e66d9e | 2290 | =item Interprocess Communication (IPC) |
4755096e | 2291 | |
c2e66d9e | 2292 | =item External Subroutines (XS) |
4755096e | 2293 | |
c2e66d9e | 2294 | =item Standard Modules |
4755096e | 2295 | |
c2e66d9e | 2296 | =item Time and Date |
4755096e | 2297 | |
c2e66d9e | 2298 | =item Character sets and character encoding |
4755096e | 2299 | |
c2e66d9e | 2300 | =item Internationalisation |
4755096e | 2301 | |
c2e66d9e | 2302 | =item System Resources |
4755096e | 2303 | |
c2e66d9e | 2304 | =item Security |
4755096e | 2305 | |
c2e66d9e | 2306 | =item Style |
4755096e GS |
2307 | |
2308 | =back | |
2309 | ||
c2e66d9e | 2310 | =item CPAN Testers |
4755096e | 2311 | |
c2e66d9e GS |
2312 | Mailing list: cpan-testers@perl.org, Testing results: |
2313 | http://testers.cpan.org/ | |
4755096e | 2314 | |
c2e66d9e | 2315 | =item PLATFORMS |
4755096e | 2316 | |
d420ca49 | 2317 | =over 4 |
4755096e | 2318 | |
c2e66d9e | 2319 | =item Unix |
4755096e | 2320 | |
c2e66d9e | 2321 | =item DOS and Derivatives |
4755096e | 2322 | |
c2e66d9e | 2323 | =item S<Mac OS> |
4755096e | 2324 | |
c2e66d9e | 2325 | =item VMS |
4755096e | 2326 | |
c2e66d9e | 2327 | =item VOS |
4755096e | 2328 | |
c2e66d9e | 2329 | =item EBCDIC Platforms |
4755096e | 2330 | |
c2e66d9e | 2331 | =item Acorn RISC OS |
4755096e | 2332 | |
c2e66d9e | 2333 | =item Other perls |
4755096e GS |
2334 | |
2335 | =back | |
2336 | ||
c2e66d9e | 2337 | =item FUNCTION IMPLEMENTATIONS |
4755096e | 2338 | |
d420ca49 | 2339 | =over 4 |
4755096e | 2340 | |
c2e66d9e GS |
2341 | =item Alphabetical Listing of Perl Functions |
2342 | ||
2343 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode | |
2344 | FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt | |
2345 | PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec | |
ba62762e JH |
2346 | LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock |
2347 | FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority | |
2348 | WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID, | |
2349 | getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
2350 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
2351 | getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent | |
2352 | STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, | |
2353 | endhostent, endnetent, endprotoent, endservent, getsockopt | |
2354 | SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, | |
2355 | kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, | |
2356 | lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv | |
2357 | ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe | |
2358 | READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select | |
2359 | RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget | |
2360 | KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, | |
c2e66d9e GS |
2361 | setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt |
2362 | SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, | |
80cbd5ad JH |
2363 | shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, |
2364 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat | |
2365 | EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
d396a558 JH |
2366 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate |
2367 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
2368 | wait, waitpid PID,FLAGS | |
4755096e | 2369 | |
d396a558 | 2370 | =back |
4755096e | 2371 | |
d396a558 | 2372 | =item CHANGES |
4755096e | 2373 | |
603b90a8 JH |
2374 | v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, |
2375 | v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 | |
2376 | May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February | |
2377 | 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September | |
2378 | 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, | |
2379 | v1.30, 03 August 1998, v1.23, 10 July 1998 | |
4755096e | 2380 | |
d396a558 | 2381 | =item Supported Platforms |
4755096e | 2382 | |
d396a558 | 2383 | =item SEE ALSO |
4755096e | 2384 | |
d396a558 | 2385 | =item AUTHORS / CONTRIBUTORS |
4755096e | 2386 | |
4755096e GS |
2387 | =back |
2388 | ||
d396a558 JH |
2389 | =head2 perllocale - Perl locale handling (internationalization and |
2390 | localization) | |
4755096e | 2391 | |
d420ca49 | 2392 | =over 4 |
4755096e | 2393 | |
d396a558 | 2394 | =item DESCRIPTION |
4755096e | 2395 | |
d396a558 JH |
2396 | =item PREPARING TO USE LOCALES |
2397 | ||
2398 | =item USING LOCALES | |
4755096e | 2399 | |
d420ca49 | 2400 | =over 4 |
4755096e | 2401 | |
d396a558 | 2402 | =item The use locale pragma |
4755096e | 2403 | |
d396a558 | 2404 | =item The setlocale function |
4755096e | 2405 | |
d396a558 | 2406 | =item Finding locales |
4755096e | 2407 | |
d396a558 | 2408 | =item LOCALE PROBLEMS |
4755096e | 2409 | |
d396a558 | 2410 | =item Temporarily fixing locale problems |
4755096e | 2411 | |
d396a558 | 2412 | =item Permanently fixing locale problems |
4755096e | 2413 | |
d396a558 | 2414 | =item Permanently fixing your system's locale configuration |
4755096e | 2415 | |
d396a558 | 2416 | =item Fixing system locale configuration |
4755096e | 2417 | |
d396a558 | 2418 | =item The localeconv function |
4755096e | 2419 | |
d0363f02 JH |
2420 | =item I18N::Langinfo |
2421 | ||
4755096e GS |
2422 | =back |
2423 | ||
d396a558 | 2424 | =item LOCALE CATEGORIES |
4755096e | 2425 | |
d420ca49 | 2426 | =over 4 |
4755096e | 2427 | |
d396a558 | 2428 | =item Category LC_COLLATE: Collation |
4755096e | 2429 | |
d396a558 | 2430 | =item Category LC_CTYPE: Character Types |
4755096e | 2431 | |
d396a558 | 2432 | =item Category LC_NUMERIC: Numeric Formatting |
4755096e | 2433 | |
d396a558 | 2434 | =item Category LC_MONETARY: Formatting of monetary amounts |
4755096e | 2435 | |
d396a558 | 2436 | =item LC_TIME |
4755096e | 2437 | |
d396a558 | 2438 | =item Other categories |
4755096e | 2439 | |
d396a558 | 2440 | =back |
4755096e | 2441 | |
d396a558 | 2442 | =item SECURITY |
4755096e | 2443 | |
d396a558 | 2444 | =item ENVIRONMENT |
4755096e | 2445 | |
d396a558 JH |
2446 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
2447 | LC_NUMERIC, LC_TIME, LANG | |
4755096e | 2448 | |
d396a558 | 2449 | =item NOTES |
4755096e | 2450 | |
d420ca49 | 2451 | =over 4 |
4755096e | 2452 | |
d396a558 | 2453 | =item Backward compatibility |
4755096e | 2454 | |
d396a558 | 2455 | =item I18N:Collate obsolete |
4755096e | 2456 | |
d396a558 | 2457 | =item Sort speed and memory use impacts |
4755096e | 2458 | |
d396a558 | 2459 | =item write() and LC_NUMERIC |
4755096e | 2460 | |
d396a558 | 2461 | =item Freely available locale definitions |
4755096e | 2462 | |
d396a558 | 2463 | =item I18n and l10n |
4755096e | 2464 | |
d396a558 | 2465 | =item An imperfect standard |
4755096e GS |
2466 | |
2467 | =back | |
2468 | ||
b2deec1d JH |
2469 | =item Unicode and UTF-8 |
2470 | ||
d396a558 | 2471 | =item BUGS |
4755096e | 2472 | |
d420ca49 | 2473 | =over 4 |
4755096e | 2474 | |
d396a558 | 2475 | =item Broken systems |
4755096e GS |
2476 | |
2477 | =back | |
2478 | ||
2479 | =item SEE ALSO | |
2480 | ||
d396a558 | 2481 | =item HISTORY |
4755096e GS |
2482 | |
2483 | =back | |
2484 | ||
07fcf8ff | 2485 | =head2 perluniintro - Perl Unicode introduction |
ba62762e JH |
2486 | |
2487 | =over 4 | |
2488 | ||
2489 | =item DESCRIPTION | |
2490 | ||
2491 | =over 4 | |
2492 | ||
2493 | =item Unicode | |
2494 | ||
2495 | =item Perl's Unicode Support | |
2496 | ||
2497 | =item Perl's Unicode Model | |
2498 | ||
b2deec1d JH |
2499 | =item Unicode and EBCDIC |
2500 | ||
ba62762e JH |
2501 | =item Creating Unicode |
2502 | ||
2503 | =item Handling Unicode | |
2504 | ||
2505 | =item Legacy Encodings | |
2506 | ||
2507 | =item Unicode I/O | |
2508 | ||
3ecb3787 JH |
2509 | =item Displaying Unicode As Text |
2510 | ||
ba62762e JH |
2511 | =item Special Cases |
2512 | ||
2513 | =item Advanced Topics | |
2514 | ||
2515 | =item Miscellaneous | |
2516 | ||
2517 | =item Questions With Answers | |
2518 | ||
ff426ff2 | 2519 | , , , , , , |
ba62762e JH |
2520 | |
2521 | =item Hexadecimal Notation | |
2522 | ||
2523 | =item Further Resources | |
2524 | ||
2525 | =back | |
2526 | ||
34babc16 JH |
2527 | =item UNICODE IN OLDER PERLS |
2528 | ||
ba62762e JH |
2529 | =item SEE ALSO |
2530 | ||
2531 | =item ACKNOWLEDGEMENTS | |
2532 | ||
2533 | =item AUTHOR, COPYRIGHT, AND LICENSE | |
2534 | ||
2535 | =back | |
2536 | ||
d396a558 | 2537 | =head2 perlunicode - Unicode support in Perl |
4755096e | 2538 | |
d420ca49 | 2539 | =over 4 |
4755096e GS |
2540 | |
2541 | =item DESCRIPTION | |
2542 | ||
d420ca49 | 2543 | =over 4 |
4755096e | 2544 | |
e42c74e1 | 2545 | =item Important Caveats |
4755096e | 2546 | |
d396a558 | 2547 | Input and Output Disciplines, Regular Expressions, C<use utf8> still needed |
ad0029c4 | 2548 | to enable UTF-8/UTF-EBCDIC in scripts |
4755096e | 2549 | |
d396a558 | 2550 | =item Byte and Character semantics |
4755096e | 2551 | |
d396a558 | 2552 | =item Effects of character semantics |
4755096e | 2553 | |
fbe3d936 JH |
2554 | =item Scripts |
2555 | ||
2556 | =item Blocks | |
2557 | ||
d396a558 | 2558 | =item Character encodings for input and output |
4755096e | 2559 | |
80327a3d | 2560 | =item Unicode Regular Expression Support Level |
ba62762e JH |
2561 | |
2562 | =item Unicode Encodings | |
2563 | ||
ba62762e JH |
2564 | =item Security Implications of Malformed UTF-8 |
2565 | ||
2566 | =item Unicode in Perl on EBCDIC | |
2567 | ||
b2deec1d JH |
2568 | =item Locales |
2569 | ||
37b1fd75 JH |
2570 | =item Using Unicode in XS |
2571 | ||
ba62762e JH |
2572 | =back |
2573 | ||
80327a3d | 2574 | =item BUGS |
4755096e | 2575 | |
b2deec1d JH |
2576 | =item SEE ALSO |
2577 | ||
4755096e GS |
2578 | =back |
2579 | ||
d396a558 | 2580 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms |
4755096e | 2581 | |
d420ca49 | 2582 | =over 4 |
4755096e | 2583 | |
d396a558 | 2584 | =item DESCRIPTION |
4755096e | 2585 | |
d396a558 | 2586 | =item COMMON CHARACTER CODE SETS |
4755096e | 2587 | |
d420ca49 | 2588 | =over 4 |
4755096e | 2589 | |
d396a558 | 2590 | =item ASCII |
4755096e | 2591 | |
d396a558 | 2592 | =item ISO 8859 |
4755096e | 2593 | |
d396a558 | 2594 | =item Latin 1 (ISO 8859-1) |
4755096e | 2595 | |
d396a558 | 2596 | =item EBCDIC |
4755096e | 2597 | |
d396a558 | 2598 | =item 13 variant characters |
4755096e | 2599 | |
d396a558 | 2600 | =item 0037 |
4755096e | 2601 | |
d396a558 | 2602 | =item 1047 |
4755096e | 2603 | |
d396a558 | 2604 | =item POSIX-BC |
4755096e | 2605 | |
b2deec1d JH |
2606 | =item Unicode code points versus EBCDIC code points |
2607 | ||
2608 | =item Remaining Perl Unicode problems in EBCDIC | |
2609 | ||
41ca3a40 JH |
2610 | =item Unicode and UTF |
2611 | ||
ff426ff2 JH |
2612 | =item Using Encode |
2613 | ||
4755096e GS |
2614 | =back |
2615 | ||
d396a558 | 2616 | =item SINGLE OCTET TABLES |
4755096e | 2617 | |
41ca3a40 | 2618 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 |
4755096e | 2619 | |
d396a558 | 2620 | =item IDENTIFYING CHARACTER CODE SETS |
4755096e | 2621 | |
d396a558 | 2622 | =item CONVERSIONS |
4755096e | 2623 | |
d420ca49 | 2624 | =over 4 |
37d4d706 JH |
2625 | |
2626 | =item tr/// | |
2627 | ||
2628 | =item iconv | |
2629 | ||
2630 | =item C RTL | |
2631 | ||
2632 | =back | |
2633 | ||
d396a558 | 2634 | =item OPERATOR DIFFERENCES |
4755096e | 2635 | |
d396a558 | 2636 | =item FUNCTION DIFFERENCES |
4755096e | 2637 | |
d396a558 | 2638 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() |
4755096e | 2639 | |
d396a558 | 2640 | =item REGULAR EXPRESSION DIFFERENCES |
4755096e | 2641 | |
d396a558 | 2642 | =item SOCKETS |
4755096e | 2643 | |
d396a558 | 2644 | =item SORTING |
4755096e | 2645 | |
d420ca49 | 2646 | =over 4 |
4755096e | 2647 | |
9fa7f388 | 2648 | =item Ignore ASCII vs. EBCDIC sort differences. |
4755096e | 2649 | |
9fa7f388 | 2650 | =item MONO CASE then sort data. |
4755096e | 2651 | |
9fa7f388 | 2652 | =item Convert, sort data, then re convert. |
4755096e | 2653 | |
d396a558 | 2654 | =item Perform sorting on one type of machine only. |
4755096e GS |
2655 | |
2656 | =back | |
2657 | ||
41ca3a40 | 2658 | =item TRANSFORMATION FORMATS |
37d4d706 | 2659 | |
d420ca49 | 2660 | =over 4 |
37d4d706 JH |
2661 | |
2662 | =item URL decoding and encoding | |
2663 | ||
2664 | =item uu encoding and decoding | |
2665 | ||
2666 | =item Quoted-Printable encoding and decoding | |
2667 | ||
41ca3a40 | 2668 | =item Caesarian ciphers |
37d4d706 JH |
2669 | |
2670 | =back | |
2671 | ||
2672 | =item Hashing order and checksums | |
4755096e | 2673 | |
d396a558 | 2674 | =item I18N AND L10N |
4755096e | 2675 | |
d396a558 | 2676 | =item MULTI OCTET CHARACTER SETS |
4755096e | 2677 | |
d396a558 | 2678 | =item OS ISSUES |
4755096e | 2679 | |
d420ca49 | 2680 | =over 4 |
4755096e | 2681 | |
d396a558 | 2682 | =item OS/400 |
7029d033 | 2683 | |
d396a558 | 2684 | IFS access |
4755096e | 2685 | |
41ca3a40 | 2686 | =item OS/390, z/OS |
4755096e | 2687 | |
41ca3a40 | 2688 | chcp, dataset access, OS/390, z/OS iconv, locales |
4755096e | 2689 | |
d396a558 | 2690 | =item VM/ESA? |
4755096e | 2691 | |
d396a558 | 2692 | =item POSIX-BC? |
4755096e | 2693 | |
d396a558 | 2694 | =back |
4755096e | 2695 | |
9fa7f388 JH |
2696 | =item BUGS |
2697 | ||
b3b6085d PP |
2698 | =item SEE ALSO |
2699 | ||
d396a558 | 2700 | =item REFERENCES |
c2e66d9e | 2701 | |
41ca3a40 JH |
2702 | =item HISTORY |
2703 | ||
d396a558 | 2704 | =item AUTHOR |
4755096e GS |
2705 | |
2706 | =back | |
2707 | ||
d396a558 | 2708 | =head2 perlsec - Perl security |
4755096e | 2709 | |
d420ca49 | 2710 | =over 4 |
4755096e | 2711 | |
4755096e GS |
2712 | =item DESCRIPTION |
2713 | ||
d420ca49 | 2714 | =over 4 |
4755096e | 2715 | |
d396a558 | 2716 | =item Laundering and Detecting Tainted Data |
4755096e | 2717 | |
d396a558 | 2718 | =item Switches On the "#!" Line |
4755096e | 2719 | |
d396a558 | 2720 | =item Cleaning Up Your Path |
c2e66d9e | 2721 | |
d396a558 | 2722 | =item Security Bugs |
c2e66d9e | 2723 | |
d396a558 | 2724 | =item Protecting Your Programs |
4755096e GS |
2725 | |
2726 | =back | |
2727 | ||
c2e66d9e GS |
2728 | =item SEE ALSO |
2729 | ||
4755096e GS |
2730 | =back |
2731 | ||
c2e66d9e | 2732 | =head2 perlmod - Perl modules (packages and symbol tables) |
4755096e | 2733 | |
d420ca49 | 2734 | =over 4 |
4755096e GS |
2735 | |
2736 | =item DESCRIPTION | |
2737 | ||
d420ca49 | 2738 | =over 4 |
4755096e | 2739 | |
c2e66d9e | 2740 | =item Packages |
4755096e | 2741 | |
c2e66d9e | 2742 | =item Symbol Tables |
4755096e | 2743 | |
c2e66d9e | 2744 | =item Package Constructors and Destructors |
4755096e | 2745 | |
c2e66d9e | 2746 | =item Perl Classes |
4755096e | 2747 | |
c2e66d9e | 2748 | =item Perl Modules |
4755096e | 2749 | |
a6fb92f1 JH |
2750 | =item Making your module threadsafe |
2751 | ||
4755096e GS |
2752 | =back |
2753 | ||
c2e66d9e | 2754 | =item SEE ALSO |
4755096e | 2755 | |
c2e66d9e | 2756 | =back |
4755096e | 2757 | |
35bf961c JH |
2758 | =head2 perlmodinstall - Installing CPAN Modules |
2759 | ||
2760 | =over 4 | |
2761 | ||
2762 | =item DESCRIPTION | |
2763 | ||
2764 | =over 4 | |
2765 | ||
2766 | =item PREAMBLE | |
2767 | ||
2768 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the | |
2769 | module (sometimes unnecessary), B<INSTALL> the module | |
2770 | ||
2771 | =back | |
2772 | ||
2773 | =item PORTABILITY | |
2774 | ||
2775 | =item HEY | |
2776 | ||
2777 | =item AUTHOR | |
2778 | ||
2779 | =item COPYRIGHT | |
2780 | ||
2781 | =back | |
2782 | ||
c2e66d9e | 2783 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
4755096e | 2784 | |
d420ca49 | 2785 | =over 4 |
4755096e | 2786 | |
c2e66d9e | 2787 | =item DESCRIPTION |
4755096e | 2788 | |
c2e66d9e | 2789 | =item THE PERL MODULE LIBRARY |
4755096e | 2790 | |
d420ca49 | 2791 | =over 4 |
4755096e | 2792 | |
c2e66d9e | 2793 | =item Pragmatic Modules |
4755096e | 2794 | |
fa1c7b03 JH |
2795 | attributes, autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, |
2796 | constant, diagnostics, encoding, fields, filetest, if, integer, less, | |
2797 | locale, open, overload, re, sigtrap, sort, strict, subs, utf8, vars, | |
b2deec1d | 2798 | vmsish, warnings, warnings::register |
4755096e | 2799 | |
c2e66d9e | 2800 | =item Standard Modules |
4755096e | 2801 | |
fa1c7b03 JH |
2802 | AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, CGI, |
2803 | CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, | |
2804 | CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, | |
2805 | Carp::Heavy, Class::ISA, Class::Struct, Cwd, DB, Devel::SelfStubber, | |
2806 | Digest, DirHandle, Dumpvalue, English, Env, Exporter, Exporter::Heavy, | |
c27482a4 | 2807 | ExtUtils::Command, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, |
b2deec1d JH |
2808 | ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_BeOS, |
2809 | ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix, | |
2810 | ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker, | |
2811 | ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, | |
fa1c7b03 | 2812 | ExtUtils::Packlist, ExtUtils::testlib, Fatal, File::Basename, |
b2deec1d JH |
2813 | File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find, |
2814 | File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, | |
2815 | File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, | |
2816 | File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, | |
2817 | FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util, | |
fa1c7b03 | 2818 | I18N::Collate, I18N::LangTags, I18N::LangTags::List, IPC::Open2, |
b2deec1d JH |
2819 | IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency, |
2820 | Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, | |
2821 | Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, | |
fa1c7b03 JH |
2822 | Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, |
2823 | Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, | |
2824 | Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NEXT, Net::Cmd, | |
b2deec1d JH |
2825 | Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, |
2826 | Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, | |
fa1c7b03 JH |
2827 | Net::protoent, Net::servent, PerlIO, Pod::Checker, Pod::Find, |
2828 | Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, | |
2829 | Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, | |
2830 | Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, | |
2831 | Pod::Usage, Pod::t::basic, Search::Dict, SelectSaver, SelfLoader, Shell, | |
2832 | Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, | |
2833 | Test, Test::Builder, Test::Harness, Test::Harness::Assert, | |
b2deec1d JH |
2834 | Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple, |
2835 | Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, | |
2836 | Text::Soundex, Text::Tabs, Text::Wrap, Thread, Tie::Array, Tie::File, | |
2837 | Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar, | |
2838 | Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm, | |
2839 | UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, User::pwent, Win32 | |
4755096e | 2840 | |
c2e66d9e | 2841 | =item Extension Modules |
4755096e | 2842 | |
c2e66d9e | 2843 | =back |
4755096e | 2844 | |
c2e66d9e | 2845 | =item CPAN |
4755096e | 2846 | |
603b90a8 JH |
2847 | =over 4 |
2848 | ||
2849 | =item Africa | |
2850 | ||
2851 | =item Asia | |
2852 | ||
2853 | =item Central America | |
2854 | ||
2855 | =item Europe | |
2856 | ||
2857 | =item North America | |
2858 | ||
2859 | =item Oceania | |
2860 | ||
2861 | =item South America | |
2862 | ||
2863 | =back | |
4755096e | 2864 | |
c2e66d9e | 2865 | =item Modules: Creation, Use, and Abuse |
4755096e | 2866 | |
d420ca49 | 2867 | =over 4 |
4755096e | 2868 | |
c2e66d9e | 2869 | =item Guidelines for Module Creation |
4755096e | 2870 | |
c2e66d9e | 2871 | =item Guidelines for Converting Perl 4 Library Scripts into Modules |
4755096e | 2872 | |
c2e66d9e | 2873 | =item Guidelines for Reusing Application Code |
4755096e | 2874 | |
c2e66d9e | 2875 | =back |
4755096e | 2876 | |
c2e66d9e | 2877 | =item NOTE |
4755096e | 2878 | |
c2e66d9e | 2879 | =back |
4755096e | 2880 | |
35bf961c | 2881 | =head2 perlmodstyle - Perl module style guide |
4755096e | 2882 | |
d420ca49 | 2883 | =over 4 |
4755096e | 2884 | |
35bf961c JH |
2885 | =item INTRODUCTION |
2886 | ||
2887 | =item QUICK CHECKLIST | |
4755096e | 2888 | |
d420ca49 | 2889 | =over 4 |
4755096e | 2890 | |
35bf961c | 2891 | =item Before you start |
4755096e | 2892 | |
35bf961c JH |
2893 | =item The API |
2894 | ||
2895 | =item Stability | |
2896 | ||
2897 | =item Documentation | |
2898 | ||
2899 | =item Release considerations | |
4755096e | 2900 | |
c2e66d9e | 2901 | =back |
4755096e | 2902 | |
35bf961c | 2903 | =item BEFORE YOU START WRITING A MODULE |
a9ef4385 | 2904 | |
35bf961c | 2905 | =over 4 |
c2e66d9e | 2906 | |
35bf961c | 2907 | =item Has it been done before? |
c2e66d9e | 2908 | |
35bf961c JH |
2909 | =item Do one thing and do it well |
2910 | ||
2911 | =item What's in a name? | |
2912 | ||
2913 | =back | |
2914 | ||
2915 | =item DESIGNING AND WRITING YOUR MODULE | |
2916 | ||
2917 | =over 4 | |
2918 | ||
2919 | =item To OO or not to OO? | |
2920 | ||
2921 | =item Designing your API | |
2922 | ||
2923 | Write simple routines to do simple things, Separate functionality from | |
2924 | output, Provide sensible shortcuts and defaults, Naming conventions, | |
2925 | Parameter passing | |
2926 | ||
2927 | =item Strictness and warnings | |
2928 | ||
2929 | =item Backwards compatibility | |
2930 | ||
2931 | =item Error handling and messages | |
2932 | ||
2933 | =back | |
2934 | ||
2935 | =item DOCUMENTING YOUR MODULE | |
2936 | ||
2937 | =over 4 | |
2938 | ||
2939 | =item POD | |
2940 | ||
2941 | =item README, INSTALL, release notes, changelogs | |
2942 | ||
2943 | =back | |
2944 | ||
2945 | =item RELEASE CONSIDERATIONS | |
2946 | ||
2947 | =over 4 | |
2948 | ||
2949 | =item Version numbering | |
2950 | ||
2951 | =item Pre-requisites | |
2952 | ||
2953 | =item Testing | |
2954 | ||
2955 | =item Packaging | |
2956 | ||
2957 | =item Licensing | |
2958 | ||
2959 | =back | |
2960 | ||
2961 | =item COMMON PITFALLS | |
2962 | ||
2963 | =over 4 | |
2964 | ||
2965 | =item Reinventing the wheel | |
2966 | ||
2967 | =item Trying to do too much | |
2968 | ||
2969 | =item Inappropriate documentation | |
2970 | ||
2971 | =back | |
2972 | ||
2973 | =item SEE ALSO | |
2974 | ||
2975 | L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools, | |
2976 | http://pause.perl.org/, Any good book on software engineering | |
2977 | ||
2978 | =item AUTHOR | |
4755096e GS |
2979 | |
2980 | =back | |
2981 | ||
c2e66d9e | 2982 | =head2 perlnewmod - preparing a new module for distribution |
4755096e | 2983 | |
d420ca49 | 2984 | =over 4 |
4755096e | 2985 | |
c2e66d9e | 2986 | =item DESCRIPTION |
4755096e | 2987 | |
d420ca49 | 2988 | =over 4 |
4755096e | 2989 | |
c2e66d9e | 2990 | =item Warning |
4755096e | 2991 | |
c2e66d9e | 2992 | =item What should I make into a module? |
4755096e | 2993 | |
c2e66d9e | 2994 | =item Step-by-step: Preparing the ground |
4755096e | 2995 | |
c2e66d9e | 2996 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
4755096e | 2997 | |
c2e66d9e | 2998 | =item Step-by-step: Making the module |
4755096e | 2999 | |
c2e66d9e | 3000 | Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use |
4d4e713d JH |
3001 | L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old |
3002 | documentation|perlpod>, Write tests, Write the README | |
4755096e | 3003 | |
c2e66d9e | 3004 | =item Step-by-step: Distributing your module |
4755096e | 3005 | |
c2e66d9e GS |
3006 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
3007 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
4755096e | 3008 | |
c2e66d9e | 3009 | =back |
4755096e | 3010 | |
c2e66d9e | 3011 | =item AUTHOR |
4755096e | 3012 | |
c2e66d9e | 3013 | =item SEE ALSO |
4755096e GS |
3014 | |
3015 | =back | |
3016 | ||
fa17183e JH |
3017 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date: |
3018 | 2002/02/21 14:49:15 $) | |
4755096e | 3019 | |
d420ca49 | 3020 | =over 4 |
4755096e GS |
3021 | |
3022 | =item DESCRIPTION | |
3023 | ||
d420ca49 | 3024 | =over 4 |
4755096e GS |
3025 | |
3026 | =item What is Perl? | |
3027 | ||
3028 | =item Who supports Perl? Who develops it? Why is it free? | |
3029 | ||
3030 | =item Which version of Perl should I use? | |
3031 | ||
3032 | =item What are perl4 and perl5? | |
3033 | ||
3034 | =item What is perl6? | |
3035 | ||
3036 | =item How stable is Perl? | |
3037 | ||
3038 | =item Is Perl difficult to learn? | |
3039 | ||
3040 | =item How does Perl compare with other languages like Java, Python, REXX, | |
3041 | Scheme, or Tcl? | |
3042 | ||
3043 | =item Can I do [task] in Perl? | |
3044 | ||
3045 | =item When shouldn't I program in Perl? | |
3046 | ||
3047 | =item What's the difference between "perl" and "Perl"? | |
3048 | ||
3049 | =item Is it a Perl program or a Perl script? | |
3050 | ||
3051 | =item What is a JAPH? | |
3052 | ||
3053 | =item Where can I get a list of Larry Wall witticisms? | |
3054 | ||
165c0277 | 3055 | =item How can I convince my sysadmin/supervisor/employees to use version |
fe9287c4 | 3056 | 5/5.6.1/Perl instead of some other language? |
4755096e GS |
3057 | |
3058 | =back | |
3059 | ||
3060 | =item AUTHOR AND COPYRIGHT | |
3061 | ||
3062 | =back | |
3063 | ||
fa17183e JH |
3064 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $, |
3065 | $Date: 2002/03/09 21:01:13 $) | |
4755096e | 3066 | |
d420ca49 | 3067 | =over 4 |
4755096e GS |
3068 | |
3069 | =item DESCRIPTION | |
3070 | ||
d420ca49 | 3071 | =over 4 |
4755096e GS |
3072 | |
3073 | =item What machines support Perl? Where do I get it? | |
3074 | ||
3075 | =item How can I get a binary version of Perl? | |
3076 | ||
3077 | =item I don't have a C compiler on my system. How can I compile perl? | |
3078 | ||
3079 | =item I copied the Perl binary from one machine to another, but scripts | |
3080 | don't work. | |
3081 | ||
3082 | =item I grabbed the sources and tried to compile but gdbm/dynamic | |
3083 | loading/malloc/linking/... failed. How do I make it work? | |
3084 | ||
3085 | =item What modules and extensions are available for Perl? What is CPAN? | |
3086 | What does CPAN/src/... mean? | |
3087 | ||
3088 | =item Is there an ISO or ANSI certified version of Perl? | |
3089 | ||
3090 | =item Where can I get information on Perl? | |
3091 | ||
3092 | =item What are the Perl newsgroups on Usenet? Where do I post questions? | |
3093 | ||
3094 | =item Where should I post source code? | |
3095 | ||
3096 | =item Perl Books | |
3097 | ||
3098 | References, Tutorials, Task-Oriented, Special Topics | |
3099 | ||
3100 | =item Perl in Magazines | |
3101 | ||
3102 | =item Perl on the Net: FTP and WWW Access | |
3103 | ||
3104 | =item What mailing lists are there for Perl? | |
3105 | ||
3106 | =item Archives of comp.lang.perl.misc | |
3107 | ||
3108 | =item Where can I buy a commercial version of Perl? | |
3109 | ||
3110 | =item Where do I send bug reports? | |
3111 | ||
04b01f78 | 3112 | =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? |
4755096e GS |
3113 | |
3114 | =back | |
3115 | ||
3116 | =item AUTHOR AND COPYRIGHT | |
3117 | ||
3118 | =back | |
3119 | ||
12b7c5c7 JH |
3120 | =head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11 |
3121 | 19:29:52 $) | |
4755096e | 3122 | |
d420ca49 | 3123 | =over 4 |
4755096e GS |
3124 | |
3125 | =item DESCRIPTION | |
3126 | ||
d420ca49 | 3127 | =over 4 |
4755096e GS |
3128 | |
3129 | =item How do I do (anything)? | |
3130 | ||
3131 | =item How can I use Perl interactively? | |
3132 | ||
3133 | =item Is there a Perl shell? | |
3134 | ||
3135 | =item How do I debug my Perl programs? | |
3136 | ||
3137 | =item How do I profile my Perl programs? | |
3138 | ||
3139 | =item How do I cross-reference my Perl programs? | |
3140 | ||
3141 | =item Is there a pretty-printer (formatter) for Perl? | |
3142 | ||
3143 | =item Is there a ctags for Perl? | |
3144 | ||
3145 | =item Is there an IDE or Windows Perl Editor? | |
3146 | ||
245d750e JH |
3147 | Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, |
3148 | CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, | |
603b90a8 JH |
3149 | MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha |
3150 | ||
4755096e GS |
3151 | =item Where can I get Perl macros for vi? |
3152 | ||
3153 | =item Where can I get perl-mode for emacs? | |
3154 | ||
3155 | =item How can I use curses with Perl? | |
3156 | ||
3157 | =item How can I use X or Tk with Perl? | |
3158 | ||
3159 | =item How can I generate simple menus without using CGI or Tk? | |
3160 | ||
4755096e GS |
3161 | =item How can I make my Perl program run faster? |
3162 | ||
3163 | =item How can I make my Perl program take less memory? | |
3164 | ||
35bf961c JH |
3165 | Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and |
3166 | stringification, Pass by reference, Tie large variables to disk | |
3167 | ||
4755096e GS |
3168 | =item Is it unsafe to return a pointer to local data? |
3169 | ||
3170 | =item How can I free an array or hash so my program shrinks? | |
3171 | ||
3172 | =item How can I make my CGI script more efficient? | |
3173 | ||
3174 | =item How can I hide the source for my Perl program? | |
3175 | ||
3176 | =item How can I compile my Perl program into byte code or C? | |
3177 | ||
3178 | =item How can I compile Perl into Java? | |
3179 | ||
3180 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? | |
3181 | ||
3182 | =item Can I write useful Perl programs on the command line? | |
3183 | ||
3184 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? | |
3185 | ||
3186 | =item Where can I learn about CGI or Web programming in Perl? | |
3187 | ||
cb52f95f JH |
3188 | =item Where can I learn about object-oriented Perl programming? |
3189 | ||
4755096e GS |
3190 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] |
3191 | ||
3192 | =item I've read perlembed, perlguts, etc., but I can't embed perl in | |
d420ca49 | 3193 | my C program; what am I doing wrong? |
4755096e | 3194 | |
fe9287c4 | 3195 | =item When I tried to run my script, I got this message. What does it mean? |
4755096e GS |
3196 | |
3197 | =item What's MakeMaker? | |
3198 | ||
3199 | =back | |
3200 | ||
3201 | =item AUTHOR AND COPYRIGHT | |
3202 | ||
3203 | =back | |
3204 | ||
fa17183e JH |
3205 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11 |
3206 | 22:15:19 $) | |
4755096e | 3207 | |
d420ca49 | 3208 | =over 4 |
4755096e GS |
3209 | |
3210 | =item DESCRIPTION | |
3211 | ||
3212 | =item Data: Numbers | |
3213 | ||
d420ca49 | 3214 | =over 4 |
4755096e GS |
3215 | |
3216 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the | |
3217 | numbers I should be getting (eg, 19.95)? | |
3218 | ||
3219 | =item Why isn't my octal data interpreted correctly? | |
3220 | ||
3221 | =item Does Perl have a round() function? What about ceil() and floor()? | |
3222 | Trig functions? | |
3223 | ||
fe9287c4 | 3224 | =item How do I convert between numeric representations? |
1fdc5aa6 JH |
3225 | |
3226 | B<How do I convert Hexadecimal into decimal:>, B<How do I convert from | |
3227 | decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How | |
3228 | do I convert from decimal to octal:>, B<How do I convert from binary to | |
3229 | decimal:>, B<How do I convert from decimal to binary:> | |
4755096e GS |
3230 | |
3231 | =item Why doesn't & work the way I want it to? | |
3232 | ||
3233 | =item How do I multiply matrices? | |
3234 | ||
3235 | =item How do I perform an operation on a series of integers? | |
3236 | ||
3237 | =item How can I output Roman numerals? | |
3238 | ||
3239 | =item Why aren't my random numbers random? | |
3240 | ||
fa17183e JH |
3241 | =item How do I get a random number between X and Y? |
3242 | ||
4755096e GS |
3243 | =back |
3244 | ||
3245 | =item Data: Dates | |
3246 | ||
d420ca49 | 3247 | =over 4 |
4755096e GS |
3248 | |
3249 | =item How do I find the week-of-the-year/day-of-the-year? | |
3250 | ||
3251 | =item How do I find the current century or millennium? | |
3252 | ||
3253 | =item How can I compare two dates and find the difference? | |
3254 | ||
3255 | =item How can I take a string and turn it into epoch seconds? | |
3256 | ||
3257 | =item How can I find the Julian Day? | |
3258 | ||
3259 | =item How do I find yesterday's date? | |
3260 | ||
3261 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? | |
3262 | ||
3263 | =back | |
3264 | ||
3265 | =item Data: Strings | |
3266 | ||
d420ca49 | 3267 | =over 4 |
4755096e GS |
3268 | |
3269 | =item How do I validate input? | |
3270 | ||
3271 | =item How do I unescape a string? | |
3272 | ||
3273 | =item How do I remove consecutive pairs of characters? | |
3274 | ||
3275 | =item How do I expand function calls in a string? | |
3276 | ||
3277 | =item How do I find matching/nesting anything? | |
3278 | ||
3279 | =item How do I reverse a string? | |
3280 | ||
3281 | =item How do I expand tabs in a string? | |
3282 | ||
3283 | =item How do I reformat a paragraph? | |
3284 | ||
3285 | =item How can I access/change the first N letters of a string? | |
3286 | ||
3287 | =item How do I change the Nth occurrence of something? | |
3288 | ||
3289 | =item How can I count the number of occurrences of a substring within a | |
3290 | string? | |
3291 | ||
3292 | =item How do I capitalize all the words on one line? | |
3293 | ||
3294 | =item How can I split a [character] delimited string except when inside | |
3295 | [character]? (Comma-separated files) | |
3296 | ||
3297 | =item How do I strip blank space from the beginning/end of a string? | |
3298 | ||
3299 | =item How do I pad a string with blanks or pad a number with zeroes? | |
3300 | ||
3301 | =item How do I extract selected columns from a string? | |
3302 | ||
3303 | =item How do I find the soundex value of a string? | |
3304 | ||
3305 | =item How can I expand variables in text strings? | |
3306 | ||
3307 | =item What's wrong with always quoting "$vars"? | |
3308 | ||
3309 | =item Why don't my <<HERE documents work? | |
3310 | ||
3311 | 1. There must be no space after the << part, 2. There (probably) should be | |
3312 | a semicolon at the end, 3. You can't (easily) have any space in front of | |
3313 | the tag | |
3314 | ||
3315 | =back | |
3316 | ||
3317 | =item Data: Arrays | |
3318 | ||
d420ca49 | 3319 | =over 4 |
4755096e GS |
3320 | |
3321 | =item What is the difference between a list and an array? | |
3322 | ||
3323 | =item What is the difference between $array[1] and @array[1]? | |
3324 | ||
3325 | =item How can I remove duplicate elements from a list or array? | |
3326 | ||
ab648d5e | 3327 | a), b), c), d), e) |
4755096e | 3328 | |
389925df JH |
3329 | =item How can I tell whether a certain element is contained in a list or |
3330 | array? | |
4755096e GS |
3331 | |
3332 | =item How do I compute the difference of two arrays? How do I compute the | |
3333 | intersection of two arrays? | |
3334 | ||
3335 | =item How do I test whether two arrays or hashes are equal? | |
3336 | ||
3337 | =item How do I find the first array element for which a condition is true? | |
3338 | ||
3339 | =item How do I handle linked lists? | |
3340 | ||
3341 | =item How do I handle circular lists? | |
3342 | ||
3343 | =item How do I shuffle an array randomly? | |
3344 | ||
3345 | =item How do I process/modify each element of an array? | |
3346 | ||
3347 | =item How do I select a random element from an array? | |
3348 | ||
3349 | =item How do I permute N elements of a list? | |
3350 | ||
3351 | =item How do I sort an array by (anything)? | |
3352 | ||
3353 | =item How do I manipulate arrays of bits? | |
3354 | ||
3355 | =item Why does defined() return true on empty arrays and hashes? | |
3356 | ||
3357 | =back | |
3358 | ||
3359 | =item Data: Hashes (Associative Arrays) | |
3360 | ||
d420ca49 | 3361 | =over 4 |
4755096e GS |
3362 | |
3363 | =item How do I process an entire hash? | |
3364 | ||
3365 | =item What happens if I add or remove keys from a hash while iterating over | |
3366 | it? | |
3367 | ||
3368 | =item How do I look up a hash element by value? | |
3369 | ||
3370 | =item How can I know how many entries are in a hash? | |
3371 | ||
3372 | =item How do I sort a hash (optionally by value instead of key)? | |
3373 | ||
3374 | =item How can I always keep my hash sorted? | |
3375 | ||
3376 | =item What's the difference between "delete" and "undef" with hashes? | |
3377 | ||
3378 | =item Why don't my tied hashes make the defined/exists distinction? | |
3379 | ||
3380 | =item How do I reset an each() operation part-way through? | |
3381 | ||
3382 | =item How can I get the unique keys from two hashes? | |
3383 | ||
3384 | =item How can I store a multidimensional array in a DBM file? | |
3385 | ||
3386 | =item How can I make my hash remember the order I put elements into it? | |
3387 | ||
3388 | =item Why does passing a subroutine an undefined element in a hash create | |
3389 | it? | |
3390 | ||
3391 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or | |
3392 | array of hashes or arrays? | |
3393 | ||
3394 | =item How can I use a reference as a hash key? | |
3395 | ||
3396 | =back | |
3397 | ||
3398 | =item Data: Misc | |
3399 | ||
d420ca49 | 3400 | =over 4 |
4755096e GS |
3401 | |
3402 | =item How do I handle binary data correctly? | |
3403 | ||
3404 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
3405 | ||
3406 | =item How do I keep persistent data across program calls? | |
3407 | ||
3408 | =item How do I print out or copy a recursive data structure? | |
3409 | ||
3410 | =item How do I define methods for every class/object? | |
3411 | ||
3412 | =item How do I verify a credit card checksum? | |
3413 | ||
3414 | =item How do I pack arrays of doubles or floats for XS code? | |
3415 | ||
3416 | =back | |
3417 | ||
3418 | =item AUTHOR AND COPYRIGHT | |
3419 | ||
3420 | =back | |
3421 | ||
fa17183e JH |
3422 | =head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11 |
3423 | 22:25:25 $) | |
4755096e | 3424 | |
d420ca49 | 3425 | =over 4 |
4755096e GS |
3426 | |
3427 | =item DESCRIPTION | |
3428 | ||
d420ca49 | 3429 | =over 4 |
4755096e GS |
3430 | |
3431 | =item How do I flush/unbuffer an output filehandle? Why must I do this? | |
3432 | ||
3433 | =item How do I change one line in a file/delete a line in a file/insert a | |
3434 | line in the middle of a file/append to the beginning of a file? | |
3435 | ||
3436 | =item How do I count the number of lines in a file? | |
3437 | ||
3438 | =item How do I make a temporary file name? | |
3439 | ||
3440 | =item How can I manipulate fixed-record-length files? | |
3441 | ||
3442 | =item How can I make a filehandle local to a subroutine? How do I pass | |
3443 | filehandles between subroutines? How do I make an array of filehandles? | |
3444 | ||
3445 | =item How can I use a filehandle indirectly? | |
3446 | ||
3447 | =item How can I set up a footer format to be used with write()? | |
3448 | ||
3449 | =item How can I write() into a string? | |
3450 | ||
3451 | =item How can I output my numbers with commas added? | |
3452 | ||
3453 | =item How can I translate tildes (~) in a filename? | |
3454 | ||
3455 | =item How come when I open a file read-write it wipes it out? | |
3456 | ||
3457 | =item Why do I sometimes get an "Argument list too long" when I use <*>? | |
3458 | ||
3459 | =item Is there a leak/bug in glob()? | |
3460 | ||
3461 | =item How can I open a file with a leading ">" or trailing blanks? | |
3462 | ||
3463 | =item How can I reliably rename a file? | |
3464 | ||
3465 | =item How can I lock a file? | |
3466 | ||
3467 | =item Why can't I just open(FH, ">file.lock")? | |
3468 | ||
3469 | =item I still don't get locking. I just want to increment the number in | |
3470 | the file. How can I do this? | |
3471 | ||
1fa7ca25 JH |
3472 | =item All I want to do is append a small amount of text to the end of a |
3473 | file. Do I still have to use locking? | |
3474 | ||
4755096e GS |
3475 | =item How do I randomly update a binary file? |
3476 | ||
3477 | =item How do I get a file's timestamp in perl? | |
3478 | ||
3479 | =item How do I set a file's timestamp in perl? | |
3480 | ||
3481 | =item How do I print to more than one file at once? | |
3482 | ||
3483 | =item How can I read in an entire file all at once? | |
3484 | ||
3485 | =item How can I read in a file by paragraphs? | |
3486 | ||
3487 | =item How can I read a single character from a file? From the keyboard? | |
3488 | ||
3489 | =item How can I tell whether there's a character waiting on a filehandle? | |
3490 | ||
3491 | =item How do I do a C<tail -f> in perl? | |
3492 | ||
3493 | =item How do I dup() a filehandle in Perl? | |
3494 | ||
3495 | =item How do I close a file descriptor by number? | |
3496 | ||
fa17183e | 3497 | =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't |
4755096e GS |
3498 | `C:\temp\foo.exe` work? |
3499 | ||
3500 | =item Why doesn't glob("*.*") get all the files? | |
3501 | ||
3502 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber | |
3503 | protected files? Isn't this a bug in Perl? | |
3504 | ||
3505 | =item How do I select a random line from a file? | |
3506 | ||
3507 | =item Why do I get weird spaces when I print an array of lines? | |
3508 | ||
3509 | =back | |
3510 | ||
3511 | =item AUTHOR AND COPYRIGHT | |
3512 | ||
3513 | =back | |
3514 | ||
fe9287c4 JH |
3515 | =head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31 |
3516 | 04:27:55 $) | |
4755096e | 3517 | |
d420ca49 | 3518 | =over 4 |
4755096e GS |
3519 | |
3520 | =item DESCRIPTION | |
3521 | ||
d420ca49 | 3522 | =over 4 |
4755096e GS |
3523 | |
3524 | =item How can I hope to use regular expressions without creating illegible | |
3525 | and unmaintainable code? | |
3526 | ||
3527 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters | |
3528 | ||
3529 | =item I'm having trouble matching over more than one line. What's wrong? | |
3530 | ||
3531 | =item How can I pull out lines between two patterns that are themselves on | |
3532 | different lines? | |
3533 | ||
3534 | =item I put a regular expression into $/ but it didn't work. What's wrong? | |
3535 | ||
d420ca49 | 3536 | =item How do I substitute case insensitively on the LHS while preserving |
4755096e GS |
3537 | case on the RHS? |
3538 | ||
3539 | =item How can I make C<\w> match national character sets? | |
3540 | ||
3541 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? | |
3542 | ||
3543 | =item How can I quote a variable to use in a regex? | |
3544 | ||
3545 | =item What is C</o> really for? | |
3546 | ||
3547 | =item How do I use a regular expression to strip C style comments from a | |
3548 | file? | |
3549 | ||
3550 | =item Can I use Perl regular expressions to match balanced text? | |
3551 | ||
3552 | =item What does it mean that regexes are greedy? How can I get around it? | |
3553 | ||
165c0277 | 3554 | =item How do I process each word on each line? |
4755096e GS |
3555 | |
3556 | =item How can I print out a word-frequency or line-frequency summary? | |
3557 | ||
3558 | =item How can I do approximate matching? | |
3559 | ||
3560 | =item How do I efficiently match many regular expressions at once? | |
3561 | ||
3562 | =item Why don't word-boundary searches with C<\b> work for me? | |
3563 | ||
3564 | =item Why does using $&, $`, or $' slow my program down? | |
3565 | ||
3566 | =item What good is C<\G> in a regular expression? | |
3567 | ||
3568 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? | |
3569 | ||
3570 | =item What's wrong with using grep or map in a void context? | |
3571 | ||
3572 | =item How can I match strings with multibyte characters? | |
3573 | ||
3574 | =item How do I match a pattern that is supplied by the user? | |
3575 | ||
3576 | =back | |
3577 | ||
3578 | =item AUTHOR AND COPYRIGHT | |
3579 | ||
3580 | =back | |
3581 | ||
fe9287c4 JH |
3582 | =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date: |
3583 | 2002/01/31 04:27:55 $) | |
4755096e | 3584 | |
d420ca49 | 3585 | =over 4 |
4755096e GS |
3586 | |
3587 | =item DESCRIPTION | |
3588 | ||
d420ca49 | 3589 | =over 4 |
4755096e GS |
3590 | |
3591 | =item Can I get a BNF/yacc/RE for the Perl language? | |
3592 | ||
3593 | =item What are all these $@%&* punctuation signs, and how do I know when to | |
3594 | use them? | |
3595 | ||
3596 | =item Do I always/never have to quote my strings or use semicolons and | |
3597 | commas? | |
3598 | ||
3599 | =item How do I skip some return values? | |
68dc0745 | 3600 | |
3601 | =item How do I temporarily block warnings? | |
3602 | ||
3603 | =item What's an extension? | |
3604 | ||
3605 | =item Why do Perl operators have different precedence than C operators? | |
3606 | ||
3607 | =item How do I declare/create a structure? | |
3608 | ||
3609 | =item How do I create a module? | |
3610 | ||
3611 | =item How do I create a class? | |
3612 | ||
3613 | =item How can I tell if a variable is tainted? | |
3614 | ||
3615 | =item What's a closure? | |
3616 | ||
46fc3d4c | 3617 | =item What is variable suicide and how can I prevent it? |
3618 | ||
68dc0745 | 3619 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
14218588 | 3620 | Regex}? |
68dc0745 | 3621 | |
14218588 | 3622 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
68dc0745 | 3623 | Passing Methods |
3624 | ||
3625 | =item How do I create a static variable? | |
3626 | ||
14218588 | 3627 | =item What's the difference between dynamic and lexical (static) scoping? |
68dc0745 | 3628 | Between local() and my()? |
3629 | ||
3630 | =item How can I access a dynamic variable while a similarly named lexical | |
3631 | is in scope? | |
3632 | ||
3633 | =item What's the difference between deep and shallow binding? | |
3634 | ||
b38f6a39 | 3635 | =item Why doesn't "my($foo) = <FILE>;" work right? |
68dc0745 | 3636 | |
54310121 | 3637 | =item How do I redefine a builtin function, operator, or method? |
68dc0745 | 3638 | |
3639 | =item What's the difference between calling a function as &foo and foo()? | |
3640 | ||
3641 | =item How do I create a switch or case statement? | |
3642 | ||
3643 | =item How can I catch accesses to undefined variables/functions/methods? | |
3644 | ||
3645 | =item Why can't a method included in this same file be found? | |
3646 | ||
3647 | =item How can I find out my current package? | |
3648 | ||
46fc3d4c | 3649 | =item How can I comment out a large block of perl code? |
3650 | ||
14218588 GS |
3651 | =item How do I clear a package? |
3652 | ||
3653 | =item How can I use a variable as a variable name? | |
3654 | ||
68dc0745 | 3655 | =back |
3656 | ||
3657 | =item AUTHOR AND COPYRIGHT | |
3658 | ||
a45bd81d GS |
3659 | =back |
3660 | ||
fe9287c4 JH |
3661 | =head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28 |
3662 | 04:17:27 $) | |
68dc0745 | 3663 | |
d420ca49 | 3664 | =over 4 |
a45bd81d | 3665 | |
68dc0745 | 3666 | =item DESCRIPTION |
3667 | ||
d420ca49 | 3668 | =over 4 |
68dc0745 | 3669 | |
3670 | =item How do I find out which operating system I'm running under? | |
3671 | ||
3672 | =item How come exec() doesn't return? | |
3673 | ||
3674 | =item How do I do fancy stuff with the keyboard/screen/mouse? | |
3675 | ||
3676 | Keyboard, Screen, Mouse | |
3677 | ||
fb9cefb4 GS |
3678 | =item How do I print something out in color? |
3679 | ||
3680 | =item How do I read just one key without waiting for a return key? | |
3681 | ||
3682 | =item How do I check whether input is ready on the keyboard? | |
3683 | ||
3684 | =item How do I clear the screen? | |
3685 | ||
3686 | =item How do I get the screen size? | |
3687 | ||
68dc0745 | 3688 | =item How do I ask the user for a password? |
3689 | ||
3690 | =item How do I read and write the serial port? | |
3691 | ||
3692 | lockfiles, open mode, end of line, flushing output, non-blocking input | |
3693 | ||
3694 | =item How do I decode encrypted password files? | |
3695 | ||
3696 | =item How do I start a process in the background? | |
3697 | ||
fb9cefb4 | 3698 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
68dc0745 | 3699 | |
3700 | =item How do I trap control characters/signals? | |
3701 | ||
3702 | =item How do I modify the shadow password file on a Unix system? | |
3703 | ||
3704 | =item How do I set the time and date? | |
3705 | ||
3706 | =item How can I sleep() or alarm() for under a second? | |
3707 | ||
3708 | =item How can I measure time under a second? | |
3709 | ||
3710 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) | |
3711 | ||
d420ca49 | 3712 | =item Why doesn't my sockets program work under System V (Solaris)? What |
68dc0745 | 3713 | does the error message "Protocol not supported" mean? |
3714 | ||
3715 | =item How can I call my system's unique C functions from Perl? | |
3716 | ||
3717 | =item Where do I get the include files to do ioctl() or syscall()? | |
3718 | ||
3719 | =item Why do setuid perl scripts complain about kernel problems? | |
3720 | ||
3721 | =item How can I open a pipe both to and from a command? | |
3722 | ||
3fe9a6f1 | 3723 | =item Why can't I get the output of a command with system()? |
3724 | ||
68dc0745 | 3725 | =item How can I capture STDERR from an external command? |
3726 | ||
3727 | =item Why doesn't open() return an error when a pipe open fails? | |
3728 | ||
3729 | =item What's wrong with using backticks in a void context? | |
3730 | ||
3731 | =item How can I call backticks without shell processing? | |
3732 | ||
3733 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, | |
54310121 | 3734 | ^Z on MS-DOS)? |
68dc0745 | 3735 | |
3736 | =item How can I convert my shell script to perl? | |
3737 | ||
3738 | =item Can I use perl to run a telnet or ftp session? | |
3739 | ||
3740 | =item How can I write expect in Perl? | |
3741 | ||
3742 | =item Is there a way to hide perl's command line from programs such as | |
3743 | "ps"? | |
3744 | ||
3745 | =item I {changed directory, modified my environment} in a perl script. How | |
3746 | come the change disappeared when I exited the script? How do I get my | |
3747 | changes to be visible? | |
3748 | ||
fb9cefb4 | 3749 | Unix |
68dc0745 | 3750 | |
3751 | =item How do I close a process's filehandle without waiting for it to | |
3752 | complete? | |
3753 | ||
3754 | =item How do I fork a daemon process? | |
3755 | ||
68dc0745 | 3756 | =item How do I find out if I'm running interactively or not? |
3757 | ||
3758 | =item How do I timeout a slow event? | |
3759 | ||
3760 | =item How do I set CPU limits? | |
3761 | ||
3762 | =item How do I avoid zombies on a Unix system? | |
3763 | ||
3764 | =item How do I use an SQL database? | |
3765 | ||
3766 | =item How do I make a system() exit on control-C? | |
3767 | ||
3768 | =item How do I open a file without blocking? | |
3769 | ||
14218588 | 3770 | =item How do I install a module from CPAN? |
68dc0745 | 3771 | |
fb9cefb4 GS |
3772 | =item What's the difference between require and use? |
3773 | ||
46fc3d4c | 3774 | =item How do I keep my own module/library directory? |
3775 | ||
3776 | =item How do I add the directory my program lives in to the module/library | |
3777 | search path? | |
3778 | ||
3779 | =item How do I add a directory to my include path at runtime? | |
3780 | ||
14218588 GS |
3781 | =item What is socket.ph and where do I get it? |
3782 | ||
68dc0745 | 3783 | =back |
3784 | ||
fc36a67e | 3785 | =item AUTHOR AND COPYRIGHT |
3786 | ||
a45bd81d GS |
3787 | =back |
3788 | ||
fe9287c4 | 3789 | =head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27 |
3fe9a6f1 | 3790 | $) |
68dc0745 | 3791 | |
d420ca49 | 3792 | =over 4 |
a45bd81d | 3793 | |
68dc0745 | 3794 | =item DESCRIPTION |
3795 | ||
d420ca49 | 3796 | =over 4 |
68dc0745 | 3797 | |
35bf961c JH |
3798 | =item What is the correct form of response from a CGI script? |
3799 | ||
d420ca49 | 3800 | =item My CGI script runs from the command line but not the browser. (500 |
fb9cefb4 GS |
3801 | Server Error) |
3802 | ||
3803 | =item How can I get better error messages from a CGI program? | |
68dc0745 | 3804 | |
3805 | =item How do I remove HTML from a string? | |
3806 | ||
3807 | =item How do I extract URLs? | |
3808 | ||
3809 | =item How do I download a file from the user's machine? How do I open a | |
3810 | file on another machine? | |
3811 | ||
3812 | =item How do I make a pop-up menu in HTML? | |
3813 | ||
3814 | =item How do I fetch an HTML file? | |
3815 | ||
fb9cefb4 GS |
3816 | =item How do I automate an HTML form submission? |
3817 | ||
3818 | =item How do I decode or create those %-encodings on the web? | |
68dc0745 | 3819 | |
3820 | =item How do I redirect to another page? | |
3821 | ||
3822 | =item How do I put a password on my web pages? | |
3823 | ||
3824 | =item How do I edit my .htpasswd and .htgroup files with Perl? | |
3825 | ||
46fc3d4c | 3826 | =item How do I make sure users can't enter values into a form that cause my |
3827 | CGI script to do bad things? | |
3828 | ||
193fb0af | 3829 | =item How do I parse a mail header? |
68dc0745 | 3830 | |
3831 | =item How do I decode a CGI form? | |
3832 | ||
193fb0af | 3833 | =item How do I check a valid mail address? |
68dc0745 | 3834 | |
3835 | =item How do I decode a MIME/BASE64 string? | |
3836 | ||
193fb0af | 3837 | =item How do I return the user's mail address? |
68dc0745 | 3838 | |
fb9cefb4 GS |
3839 | =item How do I send mail? |
3840 | ||
2d967e39 JH |
3841 | =item How do I use MIME to make an attachment to a mail message? |
3842 | ||
fb9cefb4 | 3843 | =item How do I read mail? |
68dc0745 | 3844 | |
3845 | =item How do I find out my hostname/domainname/IP address? | |
3846 | ||
3847 | =item How do I fetch a news article or the active newsgroups? | |
3848 | ||
3849 | =item How do I fetch/put an FTP file? | |
3850 | ||
3851 | =item How can I do RPC in Perl? | |
3852 | ||
3853 | =back | |
3854 | ||
3855 | =item AUTHOR AND COPYRIGHT | |
3856 | ||
a45bd81d GS |
3857 | =back |
3858 | ||
4755096e | 3859 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
a45bd81d | 3860 | |
d420ca49 | 3861 | =over 4 |
cb1a09d0 | 3862 | |
8ebc5c01 | 3863 | =item DESCRIPTION |
cb1a09d0 | 3864 | |
d420ca49 | 3865 | =over 4 |
fb9cefb4 | 3866 | |
4755096e | 3867 | =item Layout |
a45bd81d | 3868 | |
4755096e | 3869 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
637e9122 | 3870 | |
4755096e | 3871 | =back |
c76ac1ee | 3872 | |
4755096e | 3873 | =item Using The Back Ends |
c76ac1ee | 3874 | |
d420ca49 | 3875 | =over 4 |
694468e3 | 3876 | |
4755096e | 3877 | =item The Cross Referencing Back End |
c76ac1ee | 3878 | |
4755096e | 3879 | i, &, s, r |
637e9122 | 3880 | |
4755096e | 3881 | =item The Decompiling Back End |
37590e52 | 3882 | |
4755096e | 3883 | =item The Lint Back End |
c76ac1ee | 3884 | |
4755096e | 3885 | =item The Simple C Back End |
37590e52 | 3886 | |
4755096e | 3887 | =item The Bytecode Back End |
a45bd81d | 3888 | |
4755096e | 3889 | =item The Optimized C Back End |
a45bd81d | 3890 | |
4755096e GS |
3891 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, |
3892 | B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, | |
3893 | B::Stash, B::Terse, B::Xref | |
c76ac1ee | 3894 | |
4755096e | 3895 | =back |
b38f6a39 | 3896 | |
4755096e | 3897 | =item KNOWN PROBLEMS |
fb9cefb4 | 3898 | |
4755096e | 3899 | =item AUTHOR |
c76ac1ee | 3900 | |
4755096e | 3901 | =back |
a45bd81d | 3902 | |
4755096e | 3903 | =head2 perlembed - how to embed perl in your C program |
c76ac1ee | 3904 | |
d420ca49 | 3905 | =over 4 |
a45bd81d | 3906 | |
4755096e | 3907 | =item DESCRIPTION |
fb9cefb4 | 3908 | |
d420ca49 | 3909 | =over 4 |
c76ac1ee | 3910 | |
4755096e | 3911 | =item PREAMBLE |
fb9cefb4 | 3912 | |
4755096e GS |
3913 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
3914 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
fb9cefb4 | 3915 | |
4755096e | 3916 | =item ROADMAP |
fb9cefb4 | 3917 | |
4755096e | 3918 | =item Compiling your C program |
c76ac1ee | 3919 | |
4755096e | 3920 | =item Adding a Perl interpreter to your C program |
c76ac1ee | 3921 | |
4755096e | 3922 | =item Calling a Perl subroutine from your C program |
fb9cefb4 | 3923 | |
4755096e | 3924 | =item Evaluating a Perl statement from your C program |
c76ac1ee | 3925 | |
4755096e | 3926 | =item Performing Perl pattern matches and substitutions from your C program |
c76ac1ee | 3927 | |
4755096e | 3928 | =item Fiddling with the Perl stack from your C program |
37590e52 | 3929 | |
4755096e | 3930 | =item Maintaining a persistent interpreter |
c76ac1ee | 3931 | |
53d7eaa8 JH |
3932 | =item Execution of END blocks |
3933 | ||
4755096e | 3934 | =item Maintaining multiple interpreter instances |
694468e3 | 3935 | |
4755096e GS |
3936 | =item Using Perl modules, which themselves use C libraries, from your C |
3937 | program | |
c76ac1ee | 3938 | |
14218588 | 3939 | =back |
fb9cefb4 | 3940 | |
d420ca49 | 3941 | =item Embedding Perl under Win32 |
fb9cefb4 | 3942 | |
4755096e | 3943 | =item MORAL |
c76ac1ee | 3944 | |
4755096e | 3945 | =item AUTHOR |
fb9cefb4 | 3946 | |
4755096e | 3947 | =item COPYRIGHT |
c76ac1ee | 3948 | |
4755096e | 3949 | =back |
c76ac1ee | 3950 | |
4755096e | 3951 | =head2 perldebguts - Guts of Perl debugging |
a45bd81d | 3952 | |
d420ca49 | 3953 | =over 4 |
c76ac1ee | 3954 | |
4755096e | 3955 | =item DESCRIPTION |
c76ac1ee | 3956 | |
4755096e | 3957 | =item Debugger Internals |
c76ac1ee | 3958 | |
d420ca49 | 3959 | =over 4 |
c76ac1ee | 3960 | |
4755096e | 3961 | =item Writing Your Own Debugger |
c76ac1ee | 3962 | |
37590e52 | 3963 | =back |
c76ac1ee | 3964 | |
4755096e | 3965 | =item Frame Listing Output Examples |
c76ac1ee | 3966 | |
4755096e | 3967 | =item Debugging regular expressions |
c76ac1ee | 3968 | |
d420ca49 | 3969 | =over 4 |
c76ac1ee | 3970 | |
4755096e | 3971 | =item Compile-time output |
c76ac1ee | 3972 | |
4755096e GS |
3973 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
3974 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
3975 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
3976 | C<anchored(TYPE)> | |
c76ac1ee | 3977 | |
4755096e | 3978 | =item Types of nodes |
c76ac1ee | 3979 | |
4755096e | 3980 | =item Run-time output |
c76ac1ee | 3981 | |
37590e52 | 3982 | =back |
c76ac1ee | 3983 | |
4755096e | 3984 | =item Debugging Perl memory usage |
c76ac1ee | 3985 | |
d420ca49 | 3986 | =over 4 |
c76ac1ee | 3987 | |
4755096e | 3988 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
c76ac1ee | 3989 | |
4755096e GS |
3990 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
3991 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
3992 | 6144> | |
c76ac1ee | 3993 | |
4755096e | 3994 | =item Example of using B<-DL> switch |
c76ac1ee | 3995 | |
4755096e | 3996 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> |
c76ac1ee | 3997 | |
4755096e | 3998 | =item B<-DL> details |
37590e52 | 3999 | |
4755096e | 4000 | C<!!!>, C<!!>, C<!> |
37590e52 | 4001 | |
4755096e | 4002 | =item Limitations of B<-DL> statistics |
37590e52 | 4003 | |
4755096e | 4004 | =back |
37590e52 | 4005 | |
4755096e | 4006 | =item SEE ALSO |
c76ac1ee GS |
4007 | |
4008 | =back | |
4009 | ||
4755096e | 4010 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
c76ac1ee | 4011 | |
d420ca49 | 4012 | =over 4 |
c76ac1ee | 4013 | |
4755096e | 4014 | =item DESCRIPTION |
c76ac1ee | 4015 | |
4755096e | 4016 | =item SPECIAL NOTES |
c76ac1ee | 4017 | |
d420ca49 | 4018 | =over 4 |
c76ac1ee | 4019 | |
4755096e | 4020 | =item make |
c76ac1ee | 4021 | |
4755096e GS |
4022 | =item Version caveat |
4023 | ||
4024 | =item Dynamic Loading versus Static Loading | |
c76ac1ee GS |
4025 | |
4026 | =back | |
fb9cefb4 | 4027 | |
4755096e | 4028 | =item TUTORIAL |
cb1a09d0 | 4029 | |
d420ca49 | 4030 | =over 4 |
8ebc5c01 | 4031 | |
4755096e | 4032 | =item EXAMPLE 1 |
fb9cefb4 | 4033 | |
4755096e | 4034 | =item EXAMPLE 2 |
fb9cefb4 | 4035 | |
4755096e | 4036 | =item What has gone on? |
5cd24f17 | 4037 | |
4755096e | 4038 | =item Writing good test scripts |
cb1a09d0 | 4039 | |
4755096e | 4040 | =item EXAMPLE 3 |
774d564b | 4041 | |
4755096e | 4042 | =item What's new here? |
c76ac1ee | 4043 | |
4755096e | 4044 | =item Input and Output Parameters |
c76ac1ee | 4045 | |
4755096e | 4046 | =item The XSUBPP Program |
b38f6a39 | 4047 | |
4755096e | 4048 | =item The TYPEMAP file |
c76ac1ee | 4049 | |
4755096e | 4050 | =item Warning about Output Arguments |
37590e52 | 4051 | |
4755096e | 4052 | =item EXAMPLE 4 |
37590e52 | 4053 | |
4755096e | 4054 | =item What has happened here? |
c76ac1ee | 4055 | |
4755096e | 4056 | =item Anatomy of .xs file |
37590e52 | 4057 | |
4755096e | 4058 | =item Getting the fat out of XSUBs |
cb1a09d0 | 4059 | |
4755096e | 4060 | =item More about XSUB arguments |
37590e52 | 4061 | |
4755096e | 4062 | =item The Argument Stack |
a45bd81d | 4063 | |
4755096e | 4064 | =item Extending your Extension |
a45bd81d | 4065 | |
4755096e | 4066 | =item Documenting your Extension |
37590e52 | 4067 | |
4755096e | 4068 | =item Installing your Extension |
37590e52 | 4069 | |
4755096e | 4070 | =item EXAMPLE 5 |
37590e52 | 4071 | |
4755096e | 4072 | =item New Things in this Example |
37590e52 | 4073 | |
4755096e | 4074 | =item EXAMPLE 6 |
37590e52 | 4075 | |
4755096e | 4076 | =item New Things in this Example |
37590e52 | 4077 | |
4755096e | 4078 | =item EXAMPLE 7 (Coming Soon) |
37590e52 | 4079 | |
4755096e | 4080 | =item EXAMPLE 8 (Coming Soon) |
37590e52 | 4081 | |
4755096e | 4082 | =item EXAMPLE 9 (Coming Soon) |
37590e52 | 4083 | |
4755096e | 4084 | =item Troubleshooting these Examples |
37590e52 | 4085 | |
4755096e | 4086 | =back |
37590e52 | 4087 | |
4755096e | 4088 | =item See also |
37590e52 | 4089 | |
4755096e | 4090 | =item Author |
37590e52 | 4091 | |
d420ca49 | 4092 | =over 4 |
37590e52 | 4093 | |
4755096e | 4094 | =item Last Changed |
37590e52 GS |
4095 | |
4096 | =back | |
4097 | ||
4755096e GS |
4098 | =back |
4099 | ||
4100 | =head2 perlxs - XS language reference manual | |
37590e52 | 4101 | |
d420ca49 | 4102 | =over 4 |
37590e52 | 4103 | |
4755096e | 4104 | =item DESCRIPTION |
37590e52 | 4105 | |
d420ca49 | 4106 | =over 4 |
37590e52 | 4107 | |
4755096e | 4108 | =item Introduction |
37590e52 | 4109 | |
4755096e | 4110 | =item On The Road |
37590e52 | 4111 | |
4755096e | 4112 | =item The Anatomy of an XSUB |
37590e52 | 4113 | |
4755096e | 4114 | =item The Argument Stack |
37590e52 | 4115 | |
4755096e | 4116 | =item The RETVAL Variable |
37590e52 | 4117 | |
4755096e | 4118 | =item The MODULE Keyword |
37590e52 | 4119 | |
4755096e | 4120 | =item The PACKAGE Keyword |
37590e52 | 4121 | |
4755096e | 4122 | =item The PREFIX Keyword |
37590e52 | 4123 | |
4755096e | 4124 | =item The OUTPUT: Keyword |
fb9cefb4 | 4125 | |
91331b4f JH |
4126 | =item The NO_OUTPUT Keyword |
4127 | ||
4755096e GS |
4128 | =item The CODE: Keyword |
4129 | ||
4130 | =item The INIT: Keyword | |
4131 | ||
4132 | =item The NO_INIT Keyword | |
4133 | ||
4134 | =item Initializing Function Parameters | |
4135 | ||
4136 | =item Default Parameter Values | |
4137 | ||
4138 | =item The PREINIT: Keyword | |
4139 | ||
4140 | =item The SCOPE: Keyword | |
4141 | ||
4142 | =item The INPUT: Keyword | |
4143 | ||
165c0277 | 4144 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords |
91331b4f | 4145 | |
ff426ff2 JH |
4146 | =item The C<length(NAME)> Keyword |
4147 | ||
4755096e GS |
4148 | =item Variable-length Parameter Lists |
4149 | ||
4150 | =item The C_ARGS: Keyword | |
4151 | ||
4152 | =item The PPCODE: Keyword | |
4153 | ||
4154 | =item Returning Undef And Empty Lists | |
4155 | ||
4156 | =item The REQUIRE: Keyword | |
fb9cefb4 | 4157 | |
4755096e | 4158 | =item The CLEANUP: Keyword |
fb9cefb4 | 4159 | |
354a27bf | 4160 | =item The POSTCALL: Keyword |
91331b4f | 4161 | |
4755096e | 4162 | =item The BOOT: Keyword |
cb1a09d0 | 4163 | |
4755096e | 4164 | =item The VERSIONCHECK: Keyword |
cb1a09d0 | 4165 | |
4755096e | 4166 | =item The PROTOTYPES: Keyword |
cb1a09d0 | 4167 | |
4755096e | 4168 | =item The PROTOTYPE: Keyword |
a45bd81d | 4169 | |
4755096e | 4170 | =item The ALIAS: Keyword |
cb1a09d0 | 4171 | |
940adb21 JH |
4172 | =item The OVERLOAD: Keyword |
4173 | ||
4755096e | 4174 | =item The INTERFACE: Keyword |
a45bd81d | 4175 | |
4755096e | 4176 | =item The INTERFACE_MACRO: Keyword |
cb1a09d0 | 4177 | |
4755096e | 4178 | =item The INCLUDE: Keyword |
cb1a09d0 | 4179 | |
4755096e | 4180 | =item The CASE: Keyword |
cb1a09d0 | 4181 | |
4755096e | 4182 | =item The & Unary Operator |
cb1a09d0 | 4183 | |
2cc61e15 | 4184 | =item Inserting POD, Comments and C Preprocessor Directives |
cb1a09d0 | 4185 | |
4755096e | 4186 | =item Using XS With C++ |
cb1a09d0 | 4187 | |
4755096e | 4188 | =item Interface Strategy |
cb1a09d0 | 4189 | |
4755096e | 4190 | =item Perl Objects And C Structures |
14218588 | 4191 | |
4755096e | 4192 | =item The Typemap |
cb1a09d0 | 4193 | |
07fcf8ff JH |
4194 | =item Safely Storing Static Data in XS |
4195 | ||
4196 | MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT | |
4197 | ||
8ebc5c01 | 4198 | =back |
cb1a09d0 | 4199 | |
4755096e GS |
4200 | =item EXAMPLES |
4201 | ||
4202 | =item XS VERSION | |
4203 | ||
4204 | =item AUTHOR | |
14218588 | 4205 | |
a45bd81d GS |
4206 | =back |
4207 | ||
f40a6c71 SC |
4208 | =head2 perlclib - Internal replacements for standard C library functions |
4209 | ||
4210 | =over 4 | |
4211 | ||
4212 | =item DESCRIPTION | |
4213 | ||
4214 | =over 4 | |
4215 | ||
4216 | =item Conventions | |
4217 | ||
4218 | C<t>, C<p>, C<n>, C<s> | |
4219 | ||
4220 | =item File Operations | |
4221 | ||
4222 | =item File Input and Output | |
4223 | ||
4224 | =item File Positioning | |
4225 | ||
4226 | =item Memory Management and String Handling | |
4227 | ||
4228 | =item Character Class Tests | |
4229 | ||
4230 | =item F<stdlib.h> functions | |
4231 | ||
4232 | =item Miscellaneous functions | |
4233 | ||
4234 | =back | |
4235 | ||
4236 | =item SEE ALSO | |
4237 | ||
4238 | =back | |
4239 | ||
4755096e | 4240 | =head2 perlguts - Introduction to the Perl API |
cb1a09d0 | 4241 | |
d420ca49 | 4242 | =over 4 |
a45bd81d | 4243 | |
8ebc5c01 | 4244 | =item DESCRIPTION |
cb1a09d0 | 4245 | |
4755096e | 4246 | =item Variables |
cb1a09d0 | 4247 | |
d420ca49 | 4248 | =over 4 |
cb1a09d0 | 4249 | |
4755096e | 4250 | =item Datatypes |
cb1a09d0 | 4251 | |
4755096e | 4252 | =item What is an "IV"? |
cb1a09d0 | 4253 | |
4755096e | 4254 | =item Working with SVs |
cb1a09d0 | 4255 | |
37d4d706 JH |
4256 | =item Offsets |
4257 | ||
4755096e | 4258 | =item What's Really Stored in an SV? |
cb1a09d0 | 4259 | |
4755096e | 4260 | =item Working with AVs |
cb1a09d0 | 4261 | |
4755096e | 4262 | =item Working with HVs |
cb1a09d0 | 4263 | |
4755096e | 4264 | =item Hash API Extensions |
cb1a09d0 | 4265 | |
4755096e | 4266 | =item References |
cb1a09d0 | 4267 | |
4755096e | 4268 | =item Blessed References and Class Objects |
774d564b | 4269 | |
4755096e | 4270 | =item Creating New Variables |
cb1a09d0 | 4271 | |
4755096e | 4272 | =item Reference Counts and Mortality |
a45bd81d | 4273 | |
4755096e | 4274 | =item Stashes and Globs |
cb1a09d0 | 4275 | |
4755096e | 4276 | =item Double-Typed SVs |
a45bd81d | 4277 | |
4755096e | 4278 | =item Magic Variables |
cb1a09d0 | 4279 | |
4755096e | 4280 | =item Assigning Magic |
cb1a09d0 | 4281 | |
4755096e | 4282 | =item Magic Virtual Tables |
cb1a09d0 | 4283 | |
4755096e | 4284 | =item Finding Magic |
cb1a09d0 | 4285 | |
4755096e | 4286 | =item Understanding the Magic of Tied Hashes and Arrays |
cb1a09d0 | 4287 | |
4755096e | 4288 | =item Localizing changes |
cb1a09d0 | 4289 | |
4755096e | 4290 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
e42c74e1 JH |
4291 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV |
4292 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, | |
4293 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, | |
4294 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, | |
4295 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* | |
4296 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
4297 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
4298 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
4299 | save_hptr(HV **hptr)> | |
cb1a09d0 | 4300 | |
4755096e | 4301 | =back |
cb1a09d0 | 4302 | |
4755096e | 4303 | =item Subroutines |
cb1a09d0 | 4304 | |
d420ca49 | 4305 | =over 4 |
cb1a09d0 | 4306 | |
4755096e | 4307 | =item XSUBs and the Argument Stack |
cb1a09d0 | 4308 | |
4755096e | 4309 | =item Calling Perl Routines from within C Programs |
cb1a09d0 | 4310 | |
4755096e | 4311 | =item Memory Allocation |
cb1a09d0 | 4312 | |
4755096e | 4313 | =item PerlIO |
cb1a09d0 | 4314 | |
4755096e | 4315 | =item Putting a C value on Perl stack |
cb1a09d0 | 4316 | |
4755096e | 4317 | =item Scratchpads |
cb1a09d0 | 4318 | |
4755096e | 4319 | =item Scratchpads and recursion |
cb1a09d0 | 4320 | |
4755096e | 4321 | =back |
cb1a09d0 | 4322 | |
4755096e | 4323 | =item Compiled code |
cb1a09d0 | 4324 | |
d420ca49 | 4325 | =over 4 |
cb1a09d0 | 4326 | |
4755096e | 4327 | =item Code tree |
cb1a09d0 | 4328 | |
4755096e | 4329 | =item Examining the tree |
cb1a09d0 | 4330 | |
4755096e | 4331 | =item Compile pass 1: check routines |
cb1a09d0 | 4332 | |
4755096e | 4333 | =item Compile pass 1a: constant folding |
cb1a09d0 | 4334 | |
4755096e | 4335 | =item Compile pass 2: context propagation |
cb1a09d0 | 4336 | |
4755096e | 4337 | =item Compile pass 3: peephole optimization |
cb1a09d0 | 4338 | |
27713a04 JH |
4339 | =item Pluggable runops |
4340 | ||
4755096e | 4341 | =back |
cb1a09d0 | 4342 | |
165c0277 JH |
4343 | =item Examining internal data structures with the C<dump> functions |
4344 | ||
4755096e | 4345 | =item How multiple interpreters and concurrency are supported |
cb1a09d0 | 4346 | |
d420ca49 | 4347 | =over 4 |
cb1a09d0 | 4348 | |
4755096e | 4349 | =item Background and PERL_IMPLICIT_CONTEXT |
cb1a09d0 | 4350 | |
0d0e97a6 JH |
4351 | =item So what happened to dTHR? |
4352 | ||
4755096e | 4353 | =item How do I use all this in extensions? |
cb1a09d0 | 4354 | |
0d0e97a6 JH |
4355 | =item Should I do anything special if I call perl from multiple threads? |
4356 | ||
4755096e | 4357 | =item Future Plans and PERL_IMPLICIT_SYS |
cb1a09d0 | 4358 | |
4755096e | 4359 | =back |
fb9cefb4 | 4360 | |
7029d033 JH |
4361 | =item Internal Functions |
4362 | ||
0d0e97a6 | 4363 | A, p, d, s, n, r, f, M, o, j, x |
7029d033 | 4364 | |
d420ca49 | 4365 | =over 4 |
7029d033 | 4366 | |
a9ef4385 | 4367 | =item Formatted Printing of IVs, UVs, and NVs |
91e74348 | 4368 | |
9fa7f388 JH |
4369 | =item Pointer-To-Integer and Integer-To-Pointer |
4370 | ||
7029d033 JH |
4371 | =item Source Documentation |
4372 | ||
4373 | =back | |
4374 | ||
4375 | =item Unicode Support | |
4376 | ||
d420ca49 | 4377 | =over 4 |
7029d033 JH |
4378 | |
4379 | =item What B<is> Unicode, anyway? | |
4380 | ||
4381 | =item How can I recognise a UTF8 string? | |
4382 | ||
4383 | =item How does UTF8 represent Unicode characters? | |
4384 | ||
4385 | =item How does Perl store UTF8 strings? | |
4386 | ||
4387 | =item How do I convert a string to UTF8? | |
4388 | ||
4389 | =item Is there anything else I need to know? | |
4390 | ||
4391 | =back | |
4392 | ||
53d7eaa8 JH |
4393 | =item Custom Operators |
4394 | ||
4755096e | 4395 | =item AUTHORS |
fb9cefb4 | 4396 | |
4755096e | 4397 | =item SEE ALSO |
cb1a09d0 | 4398 | |
4755096e | 4399 | =back |
cb1a09d0 | 4400 | |
4755096e | 4401 | =head2 perlcall - Perl calling conventions from C |
193fb0af | 4402 | |
d420ca49 | 4403 | =over 4 |
cb1a09d0 | 4404 | |
4755096e | 4405 | =item DESCRIPTION |
68dc0745 | 4406 | |
4755096e | 4407 | An Error Handler, An Event Driven Program |
193fb0af | 4408 | |
4755096e | 4409 | =item THE CALL_ FUNCTIONS |
cb1a09d0 | 4410 | |
4755096e | 4411 | call_sv, call_pv, call_method, call_argv |
a45bd81d | 4412 | |
4755096e | 4413 | =item FLAG VALUES |
cb1a09d0 | 4414 | |
d420ca49 | 4415 | =over 4 |
a45bd81d | 4416 | |
4755096e | 4417 | =item G_VOID |
cb1a09d0 | 4418 | |
4755096e | 4419 | =item G_SCALAR |
55497cff | 4420 | |
4755096e | 4421 | =item G_ARRAY |
cb1a09d0 | 4422 | |
4755096e | 4423 | =item G_DISCARD |
cb1a09d0 | 4424 | |
4755096e | 4425 | =item G_NOARGS |
c76ac1ee | 4426 | |
4755096e | 4427 | =item G_EVAL |
14218588 | 4428 | |
4755096e | 4429 | =item G_KEEPERR |
cb1a09d0 | 4430 | |
4755096e | 4431 | =item Determining the Context |
7d2bfb28 | 4432 | |
4755096e | 4433 | =back |
cb1a09d0 | 4434 | |
4755096e | 4435 | =item KNOWN PROBLEMS |
cb1a09d0 | 4436 | |
4755096e | 4437 | =item EXAMPLES |
fb9cefb4 | 4438 | |
d420ca49 | 4439 | =over 4 |
a45bd81d | 4440 | |
4755096e | 4441 | =item No Parameters, Nothing returned |
a45bd81d | 4442 | |
4755096e | 4443 | =item Passing Parameters |
fb9cefb4 | 4444 | |
4755096e | 4445 | =item Returning a Scalar |
cb1a09d0 | 4446 | |
4755096e | 4447 | =item Returning a list of values |
14218588 | 4448 | |
4755096e | 4449 | =item Returning a list in a scalar context |
14218588 | 4450 | |
4755096e | 4451 | =item Returning Data from Perl via the parameter list |
a45bd81d | 4452 | |
4755096e | 4453 | =item Using G_EVAL |
cb1a09d0 | 4454 | |
4755096e | 4455 | =item Using G_KEEPERR |
a45bd81d | 4456 | |
4755096e | 4457 | =item Using call_sv |
cb1a09d0 | 4458 | |
4755096e | 4459 | =item Using call_argv |
cb1a09d0 | 4460 | |
4755096e | 4461 | =item Using call_method |
cb1a09d0 | 4462 | |
4755096e | 4463 | =item Using GIMME_V |
68dc0745 | 4464 | |
4755096e | 4465 | =item Using Perl to dispose of temporaries |
68dc0745 | 4466 | |
4755096e | 4467 | =item Strategies for storing Callback Context Information |
193fb0af | 4468 | |
4755096e GS |
4469 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
4470 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
4471 | callback | |
cb1a09d0 | 4472 | |
4755096e GS |
4473 | =item Alternate Stack Manipulation |
4474 | ||
4475 | =item Creating and calling an anonymous subroutine in C | |
cb1a09d0 AD |
4476 | |
4477 | =back | |
4478 | ||
4755096e | 4479 | =item SEE ALSO |
1e422769 | 4480 | |
4755096e GS |
4481 | =item AUTHOR |
4482 | ||
4483 | =item DATE | |
1e422769 | 4484 | |
a45bd81d GS |
4485 | =back |
4486 | ||
4755096e | 4487 | =head2 perlutil - utilities packaged with the Perl distribution |
cb1a09d0 | 4488 | |
d420ca49 | 4489 | =over 4 |
a45bd81d | 4490 | |
cb1a09d0 AD |
4491 | =item DESCRIPTION |
4492 | ||
d420ca49 | 4493 | =over 4 |
cb1a09d0 | 4494 | |
4755096e GS |
4495 | =item DOCUMENTATION |
4496 | ||
a6fb92f1 JH |
4497 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, |
4498 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
4499 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
4500 | L<roffitall|roffitall> | |
4755096e GS |
4501 | |
4502 | =item CONVERTORS | |
cb1a09d0 | 4503 | |
4755096e | 4504 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
cb1a09d0 | 4505 | |
a6fb92f1 JH |
4506 | =item Administration |
4507 | ||
4508 | L<libnetcfg|libnetcfg> | |
4509 | ||
4755096e | 4510 | =item Development |
14218588 | 4511 | |
4755096e GS |
4512 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
4513 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
cb1a09d0 | 4514 | |
4755096e | 4515 | =item SEE ALSO |
cb1a09d0 AD |
4516 | |
4517 | =back | |
4518 | ||
a45bd81d GS |
4519 | =back |
4520 | ||
4755096e | 4521 | =head2 perlfilter - Source Filters |
cb1a09d0 | 4522 | |
d420ca49 | 4523 | =over 4 |
a45bd81d | 4524 | |
cb1a09d0 AD |
4525 | =item DESCRIPTION |
4526 | ||
4755096e | 4527 | =item CONCEPTS |
cb1a09d0 | 4528 | |
4755096e | 4529 | =item USING FILTERS |
cb1a09d0 | 4530 | |
4755096e | 4531 | =item WRITING A SOURCE FILTER |
cb1a09d0 | 4532 | |
4755096e | 4533 | =item WRITING A SOURCE FILTER IN C |
fb9cefb4 | 4534 | |
4755096e | 4535 | B<Decryption Filters> |
14218588 | 4536 | |
4755096e | 4537 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE |
cb1a09d0 | 4538 | |
4755096e GS |
4539 | =item WRITING A SOURCE FILTER IN PERL |
4540 | ||
4541 | =item USING CONTEXT: THE DEBUG FILTER | |
4542 | ||
4543 | =item CONCLUSION | |
4544 | ||
4545 | =item REQUIREMENTS | |
4546 | ||
4547 | =item AUTHOR | |
4548 | ||
4549 | =item Copyrights | |
14218588 | 4550 | |
a45bd81d GS |
4551 | =back |
4552 | ||
4755096e | 4553 | =head2 perldbmfilter - Perl DBM Filters |
cb1a09d0 | 4554 | |
d420ca49 | 4555 | =over 4 |
a45bd81d | 4556 | |
cb1a09d0 AD |
4557 | =item SYNOPSIS |
4558 | ||
cb1a09d0 AD |
4559 | =item DESCRIPTION |
4560 | ||
4755096e GS |
4561 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
4562 | B<filter_fetch_value> | |
cb1a09d0 | 4563 | |
d420ca49 | 4564 | =over 4 |
193fb0af | 4565 | |
4755096e | 4566 | =item The Filter |
cb1a09d0 | 4567 | |
4755096e | 4568 | =item An Example -- the NULL termination problem. |
c76ac1ee | 4569 | |
4755096e | 4570 | =item Another Example -- Key is a C int. |
cb1a09d0 | 4571 | |
4755096e | 4572 | =back |
193fb0af | 4573 | |
4755096e | 4574 | =item SEE ALSO |
193fb0af | 4575 | |
4755096e | 4576 | =item AUTHOR |
cb1a09d0 | 4577 | |
4755096e | 4578 | =back |
cb1a09d0 | 4579 | |
4755096e | 4580 | =head2 perlapi - autogenerated documentation for the perl public API |
44a8e56a | 4581 | |
d420ca49 | 4582 | =over 4 |
cb1a09d0 | 4583 | |
4755096e | 4584 | =item DESCRIPTION |
cb1a09d0 | 4585 | |
04b01f78 JH |
4586 | =item "Gimme" Values |
4587 | ||
4588 | GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID | |
4589 | ||
4590 | =item Array Manipulation Functions | |
4591 | ||
7029d033 JH |
4592 | AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, |
4593 | av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, | |
04b01f78 JH |
4594 | get_av, newAV, Nullav, sortsv |
4595 | ||
4596 | =item Callback Functions | |
4597 | ||
4598 | call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv, | |
4599 | FREETMPS, LEAVE, SAVETMPS | |
4600 | ||
4601 | =item Character classes | |
4602 | ||
4603 | isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER | |
4604 | ||
4605 | =item Cloning an interpreter | |
4606 | ||
4607 | perl_clone | |
4608 | ||
4609 | =item CV Manipulation Functions | |
4610 | ||
4611 | CvSTASH, get_cv, Nullcv | |
4612 | ||
4613 | =item Embedding Functions | |
4614 | ||
4615 | load_module, perl_alloc, perl_construct, perl_destruct, perl_free, | |
4616 | perl_parse, perl_run, require_pv | |
4617 | ||
ff426ff2 JH |
4618 | =item Functions in file pp_pack.c |
4619 | ||
4620 | pack_cat, unpack_str | |
4621 | ||
04b01f78 JH |
4622 | =item Global Variables |
4623 | ||
4624 | PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes | |
4625 | ||
4626 | =item GV Functions | |
4627 | ||
80327a3d JH |
4628 | GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, |
4629 | gv_fetchmeth_autoload, gv_stashpv, gv_stashsv | |
04b01f78 JH |
4630 | |
4631 | =item Handy Values | |
4632 | ||
4633 | HEf_SVKEY, Nullch, Nullsv | |
4634 | ||
4635 | =item Hash Manipulation Functions | |
4636 | ||
4637 | get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, | |
4638 | HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists, | |
4639 | hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, | |
4640 | hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, | |
4641 | hv_store_ent, hv_undef, newHV, Nullhv | |
4642 | ||
4643 | =item Magical Functions | |
4644 | ||
37b1fd75 | 4645 | mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, |
fe9287c4 JH |
4646 | SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, |
4647 | SvSetSV, SvSetSV_nosteal, SvSHARE | |
04b01f78 JH |
4648 | |
4649 | =item Memory Management | |
4650 | ||
4651 | Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv, | |
fe9287c4 | 4652 | savepvn, savesharedpv, StructCopy, Zero |
04b01f78 JH |
4653 | |
4654 | =item Miscellaneous Functions | |
4655 | ||
4656 | fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT, | |
4657 | strNE, strnEQ, strnNE | |
4658 | ||
4659 | =item Numeric functions | |
4660 | ||
4661 | grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin, | |
4662 | scan_hex, scan_oct | |
4663 | ||
4664 | =item Optree Manipulation Functions | |
4665 | ||
4666 | cv_const_sv, newCONSTSUB, newXS | |
4667 | ||
04b01f78 JH |
4668 | =item Stack Manipulation Macros |
4669 | ||
4670 | dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp, | |
4671 | POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, | |
4672 | PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN, | |
4673 | XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, | |
4674 | XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES | |
4675 | ||
4676 | =item SV Flags | |
4677 | ||
4678 | svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG | |
4679 | ||
4680 | =item SV Manipulation Functions | |
4681 | ||
fa1c7b03 JH |
4682 | get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, |
4683 | newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, | |
4684 | new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, | |
4685 | SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx, | |
4686 | SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, | |
4687 | SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, | |
4688 | SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte, | |
4689 | SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, | |
4690 | SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, | |
4691 | SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec, | |
4692 | SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, | |
4693 | SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, | |
4694 | SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, | |
4695 | sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, | |
4696 | sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv, | |
4697 | sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, | |
59075ca9 | 4698 | sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, |
ff426ff2 JH |
4699 | sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, |
4700 | sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, | |
4701 | sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, | |
4702 | sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext, | |
4703 | sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing, | |
4704 | sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, | |
4705 | sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, | |
4706 | sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, | |
4707 | sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, | |
4708 | sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, | |
4709 | sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, | |
4710 | sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, | |
4711 | sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, | |
4712 | sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, | |
4713 | sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, | |
fe9287c4 | 4714 | sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn |
04b01f78 JH |
4715 | |
4716 | =item Unicode Support | |
4717 | ||
4718 | bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, | |
4719 | pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case, | |
4720 | to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr, | |
37b1fd75 | 4721 | utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, |
04b01f78 JH |
4722 | utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags |
4723 | ||
4724 | =item Variables created by C<xsubpp> and C<xsubpp> internal functions | |
4725 | ||
4726 | ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST, | |
4727 | THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK | |
4728 | ||
4729 | =item Warning and Dieing | |
4730 | ||
4731 | croak, warn | |
c76ac1ee | 4732 | |
4755096e | 4733 | =item AUTHORS |
cb1a09d0 AD |
4734 | |
4735 | =item SEE ALSO | |
4736 | ||
a45bd81d GS |
4737 | =back |
4738 | ||
91331b4f | 4739 | =head2 perlintern - autogenerated documentation of purely B<internal> |
4755096e | 4740 | Perl functions |
cb1a09d0 | 4741 | |
d420ca49 | 4742 | =over 4 |
a45bd81d | 4743 | |
cb1a09d0 AD |
4744 | =item DESCRIPTION |
4745 | ||
fe9287c4 JH |
4746 | =item Global Variables |
4747 | ||
4748 | PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv, | |
4749 | PL_rs | |
4750 | ||
4751 | =item GV Functions | |
4752 | ||
4753 | is_gv_magical | |
4754 | ||
4755 | =item IO Functions | |
4756 | ||
4757 | start_glob | |
4758 | ||
4759 | =item Pad Data Structures | |
4760 | ||
4761 | CvPADLIST | |
4762 | ||
4763 | =item Stack Manipulation Macros | |
4764 | ||
4765 | djSP, LVRET | |
4766 | ||
4767 | =item SV Manipulation Functions | |
4768 | ||
4769 | report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas | |
4755096e GS |
4770 | |
4771 | =item AUTHORS | |
4772 | ||
4773 | =item SEE ALSO | |
4774 | ||
4775 | =back | |
4776 | ||
dc5c060f JH |
4777 | =head2 perliol - C API for Perl's implementation of IO in Layers. |
4778 | ||
4779 | =over 4 | |
4780 | ||
4781 | =item SYNOPSIS | |
4782 | ||
4783 | =item DESCRIPTION | |
4784 | ||
4785 | =over 4 | |
4786 | ||
4787 | =item History and Background | |
4788 | ||
4789 | =item Layers vs Disciplines | |
4790 | ||
4791 | =item Data Structures | |
4792 | ||
dc5c060f JH |
4793 | =item Functions and Attributes |
4794 | ||
dc5c060f JH |
4795 | =item Per-instance Data |
4796 | ||
4797 | =item Layers in action. | |
4798 | ||
4799 | =item Per-instance flag bits | |
4800 | ||
4801 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, | |
4802 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, | |
4803 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, | |
4804 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS | |
4805 | ||
4806 | =item Methods in Detail | |
4807 | ||
ff426ff2 JH |
4808 | name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS, |
4809 | PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup, | |
4810 | Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, | |
4811 | Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt | |
dc5c060f JH |
4812 | |
4813 | =item Core Layers | |
4814 | ||
4815 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" | |
4816 | ||
4817 | =item Extension Layers | |
4818 | ||
ab1e085c | 4819 | ":encoding", ":Scalar", ":Object" or ":Perl" |
dc5c060f JH |
4820 | |
4821 | =back | |
4822 | ||
04b01f78 JH |
4823 | =item TODO |
4824 | ||
dc5c060f JH |
4825 | =back |
4826 | ||
4755096e GS |
4827 | =head2 perlapio - perl's IO abstraction interface. |
4828 | ||
d420ca49 | 4829 | =over 4 |
cb1a09d0 | 4830 | |
4755096e | 4831 | =item SYNOPSIS |
cb1a09d0 | 4832 | |
4755096e | 4833 | =item DESCRIPTION |
cb1a09d0 | 4834 | |
dc5c060f JH |
4835 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, |
4836 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, | |
4837 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, | |
4755096e GS |
4838 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, |
4839 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
4840 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
4841 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
4842 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
dc5c060f JH |
4843 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, |
4844 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
4845 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> | |
cb1a09d0 | 4846 | |
d420ca49 | 4847 | =over 4 |
cb1a09d0 | 4848 | |
4755096e | 4849 | =item Co-existence with stdio |
cb1a09d0 | 4850 | |
4755096e | 4851 | B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>, |
dc5c060f JH |
4852 | B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)> |
4853 | ||
4854 | =item "Fast gets" Functions | |
4855 | ||
4856 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, | |
4857 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, | |
4858 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, | |
4859 | B<PerlIO_get_bufsiz(f)> | |
4860 | ||
4861 | =item Other Functions | |
4862 | ||
4863 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), | |
4864 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) | |
cb1a09d0 | 4865 | |
4755096e | 4866 | =back |
c635e13b | 4867 | |
a45bd81d GS |
4868 | =back |
4869 | ||
4755096e | 4870 | =head2 perltodo - Perl TO-DO List |
c635e13b | 4871 | |
d420ca49 | 4872 | =over 4 |
a45bd81d | 4873 | |
c635e13b | 4874 | =item DESCRIPTION |
cb1a09d0 | 4875 | |
245d750e | 4876 | =item To do during 5.6.x |
cb1a09d0 | 4877 | |
d420ca49 | 4878 | =over 4 |
cb1a09d0 | 4879 | |
245d750e | 4880 | =item Support for I/O disciplines |
cb1a09d0 | 4881 | |
53d7eaa8 | 4882 | =item Autoload bytes.pm |
cb1a09d0 | 4883 | |
245d750e | 4884 | =item Make "\u{XXXX}" et al work |
cb1a09d0 | 4885 | |
53d7eaa8 | 4886 | =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) |
4755096e | 4887 | |
53d7eaa8 | 4888 | =item Overloadable regex assertions |
4755096e | 4889 | |
e61ecf27 | 4890 | =item Unicode |
cb1a09d0 | 4891 | |
245d750e | 4892 | =item use Thread for iThreads |
cb1a09d0 | 4893 | |
2ca5449f JH |
4894 | =item make perl_clone optionally clone ops |
4895 | ||
245d750e | 4896 | =item Work out exit/die semantics for threads |
cb1a09d0 | 4897 | |
245d750e | 4898 | =item Typed lexicals for compiler |
4755096e | 4899 | |
245d750e | 4900 | =item Compiler workarounds for Win32 |
4755096e | 4901 | |
245d750e | 4902 | =item AUTOLOADing in the compiler |
4755096e | 4903 | |
245d750e | 4904 | =item Fixing comppadlist when compiling |
8ebc5c01 | 4905 | |
245d750e | 4906 | =item Cleaning up exported namespace |
4755096e | 4907 | |
245d750e | 4908 | =item Complete signal handling |
cb1a09d0 | 4909 | |
245d750e | 4910 | =item Out-of-source builds |
cb1a09d0 | 4911 | |
245d750e | 4912 | =item POSIX realtime support |
cb1a09d0 | 4913 | |
245d750e | 4914 | =item UNIX98 support |
cb1a09d0 | 4915 | |
245d750e | 4916 | =item IPv6 Support |
cb1a09d0 | 4917 | |
245d750e | 4918 | =item Long double conversion |
cb1a09d0 | 4919 | |
245d750e | 4920 | =item Locales |
cb1a09d0 | 4921 | |
245d750e | 4922 | =item Thread-safe regexes |
cb1a09d0 | 4923 | |
245d750e JH |
4924 | =item Arithmetic on non-Arabic numerals |
4925 | ||
4926 | =item POSIX Unicode character classes | |
4927 | ||
4928 | =item Factoring out common suffices/prefices in regexps (trie optimization) | |
4929 | ||
4930 | =item Security audit shipped utilities | |
4931 | ||
f502af34 | 4932 | =item Sort out the uid-setting mess |
245d750e | 4933 | |
b2deec1d JH |
4934 | =item Custom opcodes |
4935 | ||
245d750e JH |
4936 | =item DLL Versioning |
4937 | ||
4938 | =item Introduce @( and @) | |
4939 | ||
4940 | =item Floating point handling | |
4941 | ||
4942 | =item IV/UV preservation | |
4943 | ||
4944 | =item Replace pod2html with something using Pod::Parser | |
4945 | ||
4946 | =item Automate module testing on CPAN | |
4947 | ||
4948 | =item sendmsg and recvmsg | |
4949 | ||
4950 | =item Rewrite perlre documentation | |
cb1a09d0 | 4951 | |
245d750e | 4952 | =item Convert example code to IO::Handle filehandles |
4755096e | 4953 | |
245d750e | 4954 | =item Document Win32 choices |
4755096e | 4955 | |
245d750e | 4956 | =item Check new modules |
4755096e | 4957 | |
245d750e | 4958 | =item Make roffitall find pods and libs itself |
c635e13b | 4959 | |
a45bd81d GS |
4960 | =back |
4961 | ||
245d750e | 4962 | =item To do at some point |
fb9cefb4 | 4963 | |
d420ca49 | 4964 | =over 4 |
a45bd81d | 4965 | |
245d750e | 4966 | =item Remove regular expression recursion |
fb9cefb4 | 4967 | |
245d750e | 4968 | =item Memory leaks after failed eval |
fb9cefb4 | 4969 | |
245d750e | 4970 | =item bitfields in pack |
fb9cefb4 | 4971 | |
245d750e | 4972 | =item Cross compilation |
fb9cefb4 | 4973 | |
245d750e | 4974 | =item Perl preprocessor / macros |
fb9cefb4 | 4975 | |
245d750e | 4976 | =item Perl lexer in Perl |
fb9cefb4 | 4977 | |
245d750e | 4978 | =item Using POSIX calls internally |
4755096e | 4979 | |
245d750e | 4980 | =item -i rename file when changed |
4755096e | 4981 | |
245d750e | 4982 | =item All ARGV input should act like E<lt>E<gt> |
4755096e | 4983 | |
245d750e | 4984 | =item Support for rerunning debugger |
4755096e | 4985 | |
fbe3d936 JH |
4986 | =item Test Suite for the Debugger |
4987 | ||
245d750e | 4988 | =item my sub foo { } |
4755096e | 4989 | |
245d750e | 4990 | =item One-pass global destruction |
fb9cefb4 | 4991 | |
245d750e | 4992 | =item Rewrite regexp parser |
a45bd81d | 4993 | |
245d750e | 4994 | =item Cache recently used regexps |
a45bd81d | 4995 | |
245d750e | 4996 | =item Re-entrant functions |
a45bd81d | 4997 | |
245d750e | 4998 | =item Cross-compilation support |
a45bd81d | 4999 | |
245d750e | 5000 | =item Bit-shifting bitvectors |
a45bd81d | 5001 | |
245d750e | 5002 | =item debugger pragma |
a45bd81d | 5003 | |
245d750e | 5004 | =item use less pragma |
a45bd81d | 5005 | |
245d750e | 5006 | =item switch structures |
a45bd81d | 5007 | |
245d750e | 5008 | =item Cache eval tree |
a45bd81d | 5009 | |
245d750e | 5010 | =item rcatmaybe |
a45bd81d | 5011 | |
245d750e | 5012 | =item Shrink opcode tables |
a45bd81d | 5013 | |
245d750e | 5014 | =item Optimize away @_ |
a45bd81d | 5015 | |
245d750e | 5016 | =item Prototypes versus indirect objects |
a45bd81d | 5017 | |
07fcf8ff | 5018 | =item Install HTML |
a45bd81d | 5019 | |
245d750e | 5020 | =item Prototype method calls |
a45bd81d | 5021 | |
245d750e | 5022 | =item Return context prototype declarations |
a45bd81d | 5023 | |
245d750e | 5024 | =item magic_setisa |
4755096e | 5025 | |
245d750e | 5026 | =item Garbage collection |
4755096e | 5027 | |
245d750e | 5028 | =item IO tutorial |
4755096e | 5029 | |
245d750e | 5030 | =item Rewrite perldoc |
4755096e | 5031 | |
3958b146 | 5032 | =item Install .3p manpages |
245d750e JH |
5033 | |
5034 | =item Unicode tutorial | |
4755096e | 5035 | |
245d750e | 5036 | =item Update POSIX.pm for 1003.1-2 |
3958b146 | 5037 | |
772ff3b9 | 5038 | =item Retargetable installation |
245d750e JH |
5039 | |
5040 | =item POSIX emulation on non-POSIX systems | |
5041 | ||
5042 | =item Rename Win32 headers | |
5043 | ||
5044 | =item Finish off lvalue functions | |
5045 | ||
5046 | =item Update sprintf documentation | |
5047 | ||
5048 | =item Use fchown/fchmod internally | |
a45bd81d | 5049 | |
cb52f95f JH |
5050 | =item Make v-strings overloaded objects |
5051 | ||
80327a3d JH |
5052 | =item Allow restricted hash assignment |
5053 | ||
a45bd81d GS |
5054 | =back |
5055 | ||
245d750e | 5056 | =item Vague ideas |
cb1a09d0 | 5057 | |
d420ca49 | 5058 | =over 4 |
a45bd81d | 5059 | |
245d750e | 5060 | =item ref() in list context |
cb1a09d0 | 5061 | |
53d7eaa8 | 5062 | =item Make tr/// return histogram of characters in list context |
cb1a09d0 | 5063 | |
245d750e | 5064 | =item Compile to real threaded code |
3958b146 | 5065 | |
772ff3b9 | 5066 | =item Structured types |
3958b146 | 5067 | |
772ff3b9 | 5068 | =item Modifiable $1 et al. |
4755096e | 5069 | |
245d750e | 5070 | =item Procedural interfaces for IO::*, etc. |
cb1a09d0 | 5071 | |
245d750e | 5072 | =item RPC modules |
cb1a09d0 | 5073 | |
245d750e | 5074 | =item Attach/detach debugger from running program |
cb1a09d0 | 5075 | |
245d750e | 5076 | =item GUI::Native |
cb1a09d0 | 5077 | |
245d750e | 5078 | =item foreach(reverse ...) |
cb1a09d0 | 5079 | |
245d750e | 5080 | =item Constant function cache |
cb1a09d0 | 5081 | |
245d750e | 5082 | =item Approximate regular expression matching |
cb1a09d0 | 5083 | |
a45bd81d GS |
5084 | =back |
5085 | ||
245d750e | 5086 | =item Ongoing |
4755096e | 5087 | |
245d750e | 5088 | =over 4 |
4755096e | 5089 | |
245d750e | 5090 | =item Update guts documentation |
cb1a09d0 | 5091 | |
245d750e | 5092 | =item Add more tests |
a45bd81d | 5093 | |
245d750e | 5094 | =item Update auxiliary tools |
cb1a09d0 | 5095 | |
4755096e | 5096 | =back |
cb1a09d0 | 5097 | |
245d750e | 5098 | =item Recently done things |
cb1a09d0 | 5099 | |
d420ca49 | 5100 | =over 4 |
cb1a09d0 | 5101 | |
f502af34 JH |
5102 | =item Alternative RE syntax module |
5103 | ||
245d750e | 5104 | =item Safe signal handling |
cb1a09d0 | 5105 | |
245d750e | 5106 | =item Tie Modules |
cb1a09d0 | 5107 | |
245d750e | 5108 | =item gettimeofday |
193fb0af | 5109 | |
245d750e | 5110 | =item setitimer and getimiter |
193fb0af | 5111 | |
245d750e | 5112 | =item Testing __DIE__ hook |
193fb0af | 5113 | |
245d750e | 5114 | =item CPP equivalent in Perl |
193fb0af | 5115 | |
245d750e | 5116 | =item Explicit switch statements |
193fb0af | 5117 | |
245d750e | 5118 | =item autocroak |
193fb0af | 5119 | |
245d750e | 5120 | =item UTF/EBCDIC |
cb1a09d0 | 5121 | |
245d750e | 5122 | =item UTF Regexes |
cb1a09d0 | 5123 | |
245d750e | 5124 | =item perlcc to produce executable |
cb1a09d0 | 5125 | |
245d750e | 5126 | =item END blocks saved in compiled output |
cb1a09d0 | 5127 | |
245d750e | 5128 | =item Secure temporary file module |
cb1a09d0 | 5129 | |
245d750e | 5130 | =item Integrate Time::HiRes |
cb1a09d0 | 5131 | |
245d750e | 5132 | =item Turn Cwd into XS |
cb1a09d0 | 5133 | |
245d750e | 5134 | =item Mmap for input |
cb1a09d0 | 5135 | |
245d750e | 5136 | =item Byte to/from UTF8 and UTF8 to/from local conversion |
cb1a09d0 | 5137 | |
245d750e | 5138 | =item Add sockatmark support |
cb1a09d0 | 5139 | |
245d750e | 5140 | =item Mailing list archives |
cb1a09d0 | 5141 | |
245d750e | 5142 | =item Bug tracking |
cb1a09d0 | 5143 | |
245d750e | 5144 | =item Integrate MacPerl |
cb1a09d0 | 5145 | |
245d750e | 5146 | =item Web "nerve center" for Perl |
cb1a09d0 | 5147 | |
245d750e | 5148 | =item Regular expression tutorial |
cb1a09d0 | 5149 | |
245d750e | 5150 | =item Debugging Tutorial |
4755096e | 5151 | |
245d750e | 5152 | =item Integrate new modules |
4755096e | 5153 | |
245d750e | 5154 | =item Integrate profiler |
4755096e | 5155 | |
245d750e | 5156 | =item Y2K error detection |
4755096e | 5157 | |
245d750e | 5158 | =item Regular expression debugger |
4755096e | 5159 | |
245d750e | 5160 | =item POD checker |
4755096e | 5161 | |
245d750e | 5162 | =item "Dynamic" lexicals |
4755096e | 5163 | |
245d750e | 5164 | =item Cache precompiled modules |
cb1a09d0 | 5165 | |
245d750e | 5166 | =back |
cb1a09d0 | 5167 | |
245d750e | 5168 | =item Deprecated Wishes |
cb1a09d0 | 5169 | |
245d750e | 5170 | =over 4 |
cb1a09d0 | 5171 | |
245d750e | 5172 | =item Loop control on do{} |
cb1a09d0 | 5173 | |
245d750e | 5174 | =item Lexically scoped typeglobs |
cb1a09d0 | 5175 | |
245d750e | 5176 | =item format BOTTOM |
3958b146 | 5177 | |
772ff3b9 | 5178 | =item report HANDLE |
cb1a09d0 | 5179 | |
245d750e | 5180 | =item Generalised want()/caller()) |
3958b146 | 5181 | |
772ff3b9 | 5182 | =item Named prototypes |
cb1a09d0 | 5183 | |
245d750e | 5184 | =item Built-in globbing |
4755096e | 5185 | |
245d750e | 5186 | =item Regression tests for suidperl |
4755096e | 5187 | |
245d750e | 5188 | =item Cached hash values |
4755096e | 5189 | |
245d750e | 5190 | =item Add compression modules |
cb1a09d0 | 5191 | |
245d750e | 5192 | =item Reorganise documentation into tutorials/references |
cb1a09d0 | 5193 | |
245d750e | 5194 | =item Remove distinction between functions and operators |
cb1a09d0 | 5195 | |
245d750e | 5196 | =item Make XS easier to use |
cb1a09d0 | 5197 | |
245d750e | 5198 | =item Make embedding easier to use |
cb1a09d0 | 5199 | |
245d750e | 5200 | =item man for perl |
cb1a09d0 | 5201 | |
245d750e | 5202 | =item my $Package::variable |
cb1a09d0 | 5203 | |
245d750e | 5204 | =item "or" tests defined, not truth |
4755096e | 5205 | |
245d750e | 5206 | =item "class"-based lexicals |
4755096e | 5207 | |
245d750e | 5208 | =item byteperl |
4755096e | 5209 | |
245d750e | 5210 | =item Lazy evaluation / tail recursion removal |
cb1a09d0 | 5211 | |
a6fb92f1 JH |
5212 | =item Make "use utf8" the default |
5213 | ||
53d7eaa8 JH |
5214 | =item Unicode collation and normalization |
5215 | ||
890a53b9 JH |
5216 | =item Create debugging macros |
5217 | ||
37b1fd75 JH |
5218 | =item truncate to the people |
5219 | ||
fe9287c4 JH |
5220 | =item pack/unpack tutorial |
5221 | ||
a45bd81d GS |
5222 | =back |
5223 | ||
4755096e GS |
5224 | =back |
5225 | ||
5226 | =head2 perlhack - How to hack at the Perl internals | |
cb1a09d0 | 5227 | |
d420ca49 | 5228 | =over 4 |
a45bd81d | 5229 | |
4755096e GS |
5230 | =item DESCRIPTION |
5231 | ||
5232 | Does concept match the general goals of Perl?, Where is the | |
5233 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
5234 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
5235 | it preclude other desirable features?, Is the implementation robust?, Is | |
428dc699 JH |
5236 | the implementation generic enough to be portable?, Is the implementation |
5237 | tested?, Is there enough documentation?, Is there another way to do it?, | |
5238 | Does it create too much work?, Patches speak louder than words | |
d420ca49 AD |
5239 | |
5240 | =over 4 | |
5241 | ||
5242 | =item Keeping in sync | |
5243 | ||
5244 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
9cd42e2a JH |
5245 | NFS, rsync'ing the patches |
5246 | ||
5247 | =item Why rsync the source tree | |
5248 | ||
5249 | It's easier to rsync the source tree, It's more recent, It's more reliable | |
5250 | ||
5251 | =item Why rsync the patches | |
5252 | ||
5253 | It's easier to rsync the patches, It's a good reference, Finding a start | |
5254 | point, Finding how to fix a bug, Finding the source of misbehaviour | |
d420ca49 | 5255 | |
1fdc5aa6 JH |
5256 | =item Perlbug remote interface |
5257 | ||
5258 | 1 http://bugs.perl.org, 2 bugdb@perl.org, 3 | |
5259 | commands_and_bugdids@bugs.perl.org, notes, patches, tests | |
5260 | ||
d420ca49 AD |
5261 | =item Submitting patches |
5262 | ||
5263 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
5264 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
cb1a09d0 | 5265 | |
7029d033 | 5266 | =item Finding Your Way Around |
cb1a09d0 | 5267 | |
9cd42e2a | 5268 | Core modules, Tests, Documentation, Configure, Interpreter |
4755096e | 5269 | |
7029d033 | 5270 | =item Elements of the interpreter |
4755096e | 5271 | |
7029d033 | 5272 | Startup, Parsing, Optimization, Running |
4755096e | 5273 | |
7029d033 | 5274 | =item Internal Variable Types |
4755096e | 5275 | |
7029d033 | 5276 | =item Op Trees |
4755096e | 5277 | |
7029d033 | 5278 | =item Stacks |
4755096e | 5279 | |
7029d033 | 5280 | Argument stack, Mark stack, Save stack |
4755096e | 5281 | |
7029d033 | 5282 | =item Millions of Macros |
4755096e | 5283 | |
7029d033 | 5284 | =item Poking at Perl |
4755096e | 5285 | |
7029d033 | 5286 | =item Using a source-level debugger |
4755096e | 5287 | |
7029d033 | 5288 | run [args], break function_name, break source.c:xxx, step, next, continue, |
d420ca49 | 5289 | finish, 'enter', print |
4755096e | 5290 | |
7029d033 | 5291 | =item Dumping Perl Data Structures |
4755096e | 5292 | |
7029d033 | 5293 | =item Patching |
cb1a09d0 | 5294 | |
9cd42e2a JH |
5295 | =item Patching a core module |
5296 | ||
53d7eaa8 JH |
5297 | =item Adding a new function to the core |
5298 | ||
9cd42e2a JH |
5299 | =item Writing a test |
5300 | ||
5301 | F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, | |
cb52f95f | 5302 | F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib |
9cd42e2a | 5303 | |
91331b4f JH |
5304 | =back |
5305 | ||
5306 | =item EXTERNAL TOOLS FOR DEBUGGING PERL | |
5307 | ||
d420ca49 | 5308 | =over 4 |
91331b4f JH |
5309 | |
5310 | =item Rational Software's Purify | |
5311 | ||
5312 | =item Purify on Unix | |
5313 | ||
5314 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity | |
5315 | ||
5316 | =item Purify on NT | |
5317 | ||
5318 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug | |
5319 | ||
ab1e085c JH |
5320 | =item Compaq's/Digital's Third Degree |
5321 | ||
5322 | =item PERL_DESTRUCT_LEVEL | |
5323 | ||
51a35ef1 JH |
5324 | =item Profiling |
5325 | ||
772ff3b9 JH |
5326 | =item Gprof Profiling |
5327 | ||
5328 | -a, -b, -e routine, -f routine, -s, -z | |
5329 | ||
51a35ef1 JH |
5330 | =item GCC gcov Profiling |
5331 | ||
ab1e085c JH |
5332 | =item Pixie Profiling |
5333 | ||
772ff3b9 | 5334 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, |
245d750e | 5335 | -z[ero] |
ab1e085c | 5336 | |
b2deec1d JH |
5337 | =item Miscellaneous tricks |
5338 | ||
7029d033 | 5339 | =item CONCLUSION |
cb1a09d0 | 5340 | |
7029d033 | 5341 | I<The Road goes ever on and on, down from the door where it began.> |
cb1a09d0 | 5342 | |
8ebc5c01 | 5343 | =back |
cb1a09d0 | 5344 | |
7029d033 | 5345 | =item AUTHOR |
cb1a09d0 AD |
5346 | |
5347 | =back | |
5348 | ||
7029d033 | 5349 | =head2 perlhist - the Perl history records |
7d2bfb28 | 5350 | |
d420ca49 | 5351 | =over 4 |
7d2bfb28 | 5352 | |
7029d033 | 5353 | =item DESCRIPTION |
cb1a09d0 | 5354 | |
7029d033 | 5355 | =item INTRODUCTION |
cb1a09d0 | 5356 | |
7029d033 | 5357 | =item THE KEEPERS OF THE PUMPKIN |
cb1a09d0 | 5358 | |
d420ca49 | 5359 | =over 4 |
cb1a09d0 | 5360 | |
7029d033 | 5361 | =item PUMPKIN? |
cb1a09d0 | 5362 | |
a45bd81d GS |
5363 | =back |
5364 | ||
7029d033 | 5365 | =item THE RECORDS |
cb1a09d0 | 5366 | |
d420ca49 | 5367 | =over 4 |
cb1a09d0 | 5368 | |
7029d033 | 5369 | =item SELECTED RELEASE SIZES |
cb1a09d0 | 5370 | |
7029d033 | 5371 | =item SELECTED PATCH SIZES |
cb1a09d0 | 5372 | |
7029d033 | 5373 | =back |
cb1a09d0 | 5374 | |
7029d033 | 5375 | =item THE KEEPERS OF THE RECORDS |
cb1a09d0 | 5376 | |
a45bd81d GS |
5377 | =back |
5378 | ||
428dc699 | 5379 | =head2 perldelta - what is new for perl v5.8.0 |
603b90a8 JH |
5380 | |
5381 | =over 4 | |
5382 | ||
5383 | =item DESCRIPTION | |
5384 | ||
3ecb3787 | 5385 | =item Highlights In 5.8.0 |
493a87da | 5386 | |
428dc699 JH |
5387 | =item Incompatible Changes |
5388 | ||
5389 | =over 4 | |
5390 | ||
5391 | =item 64-bit platforms and malloc | |
5392 | ||
5393 | =item AIX Dynaloading | |
5394 | ||
95f0a2f1 SB |
5395 | =item Attributes for C<my> variables now handled at run-time. |
5396 | ||
428dc699 JH |
5397 | =item Socket Extension Dynamic in VMS |
5398 | ||
493a87da JH |
5399 | =item IEEE-format Floating Point Default on OpenVMS Alpha |
5400 | ||
f502af34 | 5401 | =item New Unicode Properties |
428dc699 | 5402 | |
34babc16 JH |
5403 | =item REF(...) Instead Of SCALAR(...) |
5404 | ||
ff426ff2 JH |
5405 | =item pack/unpack D/F recycled |
5406 | ||
428dc699 JH |
5407 | =item Deprecations |
5408 | ||
5409 | =back | |
5410 | ||
5411 | =item Core Enhancements | |
5412 | ||
5413 | =over 4 | |
5414 | ||
428dc699 JH |
5415 | =item PerlIO is Now The Default |
5416 | ||
37b1fd75 | 5417 | =item Safe Signals |
428dc699 | 5418 | |
34babc16 JH |
5419 | =item Unicode Overhaul |
5420 | ||
428dc699 JH |
5421 | =item Understanding of Numbers |
5422 | ||
f502af34 | 5423 | =item Miscellaneous Changes |
34babc16 | 5424 | |
428dc699 JH |
5425 | =back |
5426 | ||
5427 | =item Modules and Pragmata | |
5428 | ||
5429 | =over 4 | |
5430 | ||
34babc16 | 5431 | =item New Modules and Pragmata |
428dc699 JH |
5432 | |
5433 | =item Updated And Improved Modules and Pragmata | |
5434 | ||
5435 | =back | |
5436 | ||
5437 | =item Utility Changes | |
5438 | ||
5439 | =item New Documentation | |
5440 | ||
5441 | =item Performance Enhancements | |
5442 | ||
5443 | =item Installation and Configuration Improvements | |
5444 | ||
5445 | =over 4 | |
5446 | ||
5447 | =item Generic Improvements | |
5448 | ||
5449 | =item New Or Improved Platforms | |
5450 | ||
5451 | =back | |
5452 | ||
5453 | =item Selected Bug Fixes | |
5454 | ||
5455 | =over 4 | |
5456 | ||
5457 | =item Platform Specific Changes and Fixes | |
5458 | ||
5459 | =back | |
5460 | ||
5461 | =item New or Changed Diagnostics | |
5462 | ||
5463 | =item Changed Internals | |
5464 | ||
5465 | =item Security Vulnerability Closed | |
5466 | ||
5467 | =item New Tests | |
5468 | ||
5469 | =item Known Problems | |
5470 | ||
5471 | =over 4 | |
5472 | ||
5473 | =item AIX | |
5474 | ||
5475 | =item Amiga Perl Invoking Mystery | |
5476 | ||
fa1c7b03 JH |
5477 | =item mod_perl 1.26 Doesn't Build With Threaded Perl |
5478 | ||
428dc699 JH |
5479 | =item lib/ftmp-security tests warn 'system possibly insecure' |
5480 | ||
428dc699 JH |
5481 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
5482 | ||
5483 | =item Linux With Sfio Fails op/misc Test 48 | |
5484 | ||
493a87da JH |
5485 | =item Mac OS X |
5486 | ||
fa1c7b03 | 5487 | =item op/sprintf tests 91, 129, and 130 |
428dc699 | 5488 | |
fa1c7b03 | 5489 | =item Failure of Thread (5.005-style) tests |
428dc699 JH |
5490 | |
5491 | =item UNICOS | |
5492 | ||
ff426ff2 JH |
5493 | =item UNICOS and UNICOS/mk |
5494 | ||
fa1c7b03 JH |
5495 | =item UNICOS/mk |
5496 | ||
428dc699 JH |
5497 | =item UTS |
5498 | ||
5499 | =item VMS | |
5500 | ||
04b01f78 JH |
5501 | =item Win32 |
5502 | ||
428dc699 JH |
5503 | =item Localising a Tied Variable Leaks Memory |
5504 | ||
fa1c7b03 JH |
5505 | =item z/OS (OS/390) |
5506 | ||
34babc16 JH |
5507 | =item Localising Tied Arrays and Hashes Is Broken |
5508 | ||
428dc699 JH |
5509 | =item Self-tying of Arrays and Hashes Is Forbidden |
5510 | ||
428dc699 JH |
5511 | =item Building Extensions Can Fail Because Of Largefiles |
5512 | ||
34babc16 JH |
5513 | =item Unicode Support on EBCDIC Still Spotty |
5514 | ||
428dc699 JH |
5515 | =item The Compiler Suite Is Still Experimental |
5516 | ||
c4f1ce08 JH |
5517 | =item The Long Double Support Is Still Experimental |
5518 | ||
5519 | =item Seen In Perl 5.7 But Gone Now | |
428dc699 JH |
5520 | |
5521 | =back | |
5522 | ||
603b90a8 JH |
5523 | =item Reporting Bugs |
5524 | ||
5525 | =item SEE ALSO | |
5526 | ||
5527 | =item HISTORY | |
5528 | ||
5529 | =back | |
5530 | ||
d6483fcc | 5531 | =head2 perl572delta - what's new for perl v5.7.2 |
245d750e JH |
5532 | |
5533 | =over 4 | |
5534 | ||
5535 | =item DESCRIPTION | |
5536 | ||
5537 | =item Security Vulnerability Closed | |
5538 | ||
5539 | =item Incompatible Changes | |
5540 | ||
cb5953d6 JH |
5541 | =over 4 |
5542 | ||
5543 | =item 64-bit platforms and malloc | |
5544 | ||
e0539f61 JH |
5545 | =item AIX Dynaloading |
5546 | ||
5547 | =item Socket Extension Dynamic in VMS | |
5548 | ||
fbe3d936 JH |
5549 | =item Different Definition of the Unicode Character Classes \p{In...} |
5550 | ||
e0539f61 | 5551 | =item Deprecations |
772ff3b9 | 5552 | |
cb5953d6 JH |
5553 | =back |
5554 | ||
245d750e JH |
5555 | =item Core Enhancements |
5556 | ||
5557 | =item Modules and Pragmata | |
5558 | ||
5559 | =over 4 | |
5560 | ||
389925df | 5561 | =item New Modules and Distributions |
245d750e JH |
5562 | |
5563 | =item Updated And Improved Modules and Pragmata | |
5564 | ||
5565 | =back | |
5566 | ||
245d750e JH |
5567 | =item Utility Changes |
5568 | ||
5569 | =item New Documentation | |
5570 | ||
5571 | =item Installation and Configuration Improvements | |
5572 | ||
5573 | =over 4 | |
5574 | ||
5575 | =item New Or Improved Platforms | |
5576 | ||
5577 | =item Generic Improvements | |
5578 | ||
5579 | =back | |
5580 | ||
5581 | =item Selected Bug Fixes | |
5582 | ||
5583 | =over 4 | |
5584 | ||
5585 | =item Platform Specific Changes and Fixes | |
5586 | ||
5587 | =back | |
5588 | ||
5589 | =item New or Changed Diagnostics | |
5590 | ||
354a27bf | 5591 | =item Source Code Enhancements |
245d750e JH |
5592 | |
5593 | =over 4 | |
5594 | ||
354a27bf JH |
5595 | =item MAGIC constants |
5596 | ||
5597 | =item Better commented code | |
5598 | ||
245d750e JH |
5599 | =item Regex pre-/post-compilation items matched up |
5600 | ||
354a27bf JH |
5601 | =item gcc -Wall |
5602 | ||
245d750e JH |
5603 | =back |
5604 | ||
5605 | =item New Tests | |
5606 | ||
5607 | =item Known Problems | |
5608 | ||
5609 | =over 4 | |
5610 | ||
e0539f61 JH |
5611 | =item AIX |
5612 | ||
5613 | =item Amiga Perl Invoking Mystery | |
245d750e JH |
5614 | |
5615 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
5616 | ||
e0539f61 | 5617 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 |
245d750e | 5618 | |
07fcf8ff | 5619 | =item HP-UX lib/io_multihomed Fails When LP64-Configured |
245d750e | 5620 | |
e0539f61 | 5621 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
245d750e JH |
5622 | |
5623 | =item Linux With Sfio Fails op/misc Test 48 | |
5624 | ||
fbe3d936 JH |
5625 | =item OS/390 |
5626 | ||
e0539f61 | 5627 | =item op/sprintf tests 129 and 130 |
245d750e JH |
5628 | |
5629 | =item Failure of Thread tests | |
5630 | ||
e0539f61 JH |
5631 | =item UNICOS |
5632 | ||
e0539f61 JH |
5633 | =item UTS |
5634 | ||
354a27bf JH |
5635 | =item VMS |
5636 | ||
d0363f02 JH |
5637 | =item Win32 |
5638 | ||
245d750e JH |
5639 | =item Localising a Tied Variable Leaks Memory |
5640 | ||
5641 | =item Self-tying of Arrays and Hashes Is Forbidden | |
5642 | ||
cb5953d6 JH |
5643 | =item Variable Attributes are not Currently Usable for Tieing |
5644 | ||
245d750e JH |
5645 | =item Building Extensions Can Fail Because Of Largefiles |
5646 | ||
5647 | =item The Compiler Suite Is Still Experimental | |
5648 | ||
e0539f61 JH |
5649 | =item The Long Double Support is Still Experimental |
5650 | ||
245d750e JH |
5651 | =back |
5652 | ||
5653 | =item Reporting Bugs | |
5654 | ||
5655 | =item SEE ALSO | |
5656 | ||
5657 | =item HISTORY | |
5658 | ||
5659 | =back | |
5660 | ||
603b90a8 JH |
5661 | =head2 perl571delta - what's new for perl v5.7.1 |
5662 | ||
5663 | =over 4 | |
5664 | ||
5665 | =item DESCRIPTION | |
5666 | ||
5667 | =item Security Vulnerability Closed | |
5668 | ||
5669 | =item Incompatible Changes | |
5670 | ||
5671 | =item Core Enhancements | |
5672 | ||
245d750e JH |
5673 | =over 4 |
5674 | ||
2ca5449f JH |
5675 | =item AUTOLOAD Is Now Lvaluable |
5676 | ||
245d750e JH |
5677 | =item PerlIO is Now The Default |
5678 | ||
5679 | =item Signals Are Now Safe | |
5680 | ||
5681 | =back | |
5682 | ||
bd28ded5 | 5683 | =item Modules and Pragmata |
603b90a8 JH |
5684 | |
5685 | =over 4 | |
5686 | ||
603b90a8 JH |
5687 | =item New Modules |
5688 | ||
5689 | =item Updated And Improved Modules and Pragmata | |
5690 | ||
5691 | =back | |
5692 | ||
5693 | =item Performance Enhancements | |
5694 | ||
5695 | =item Utility Changes | |
5696 | ||
5697 | =item New Documentation | |
5698 | ||
5699 | =over 4 | |
5700 | ||
5701 | =item perlclib | |
5702 | ||
5703 | =item perliol | |
5704 | ||
5705 | =item README.aix | |
5706 | ||
5707 | =item README.bs2000 | |
5708 | ||
5709 | =item README.macos | |
5710 | ||
5711 | =item README.mpeix | |
5712 | ||
5713 | =item README.solaris | |
5714 | ||
5715 | =item README.vos | |
5716 | ||
5717 | =item Porting/repository.pod | |
5718 | ||
5719 | =back | |
5720 | ||
603b90a8 JH |
5721 | =item Installation and Configuration Improvements |
5722 | ||
5723 | =over 4 | |
5724 | ||
5725 | =item New Or Improved Platforms | |
5726 | ||
5727 | =item Generic Improvements | |
5728 | ||
bd28ded5 JH |
5729 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, |
5730 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, | |
5731 | d_strtoq, d_u32align, d_ualarm, d_usleep | |
5732 | ||
603b90a8 JH |
5733 | =back |
5734 | ||
5735 | =item Selected Bug Fixes | |
5736 | ||
5737 | =over 4 | |
5738 | ||
5739 | =item Platform Specific Changes and Fixes | |
5740 | ||
5741 | =back | |
5742 | ||
5743 | =item New or Changed Diagnostics | |
5744 | ||
5745 | =item Changed Internals | |
5746 | ||
bd28ded5 JH |
5747 | =item New Tests |
5748 | ||
603b90a8 JH |
5749 | =item Known Problems |
5750 | ||
5751 | =over 4 | |
5752 | ||
bd28ded5 JH |
5753 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl |
5754 | ||
5755 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
5756 | ||
5757 | =item lib/io_multihomed Fails In LP64-Configured HP-UX | |
5758 | ||
5759 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
5760 | ||
603b90a8 JH |
5761 | =item lib/b test 19 |
5762 | ||
bd28ded5 | 5763 | =item Linux With Sfio Fails op/misc Test 48 |
603b90a8 JH |
5764 | |
5765 | =item sigaction test 13 in VMS | |
5766 | ||
5767 | =item sprintf tests 129 and 130 | |
5768 | ||
bd28ded5 JH |
5769 | =item Failure of Thread tests |
5770 | ||
5771 | =item Localising a Tied Variable Leaks Memory | |
5772 | ||
603b90a8 JH |
5773 | =item Self-tying of Arrays and Hashes Is Forbidden |
5774 | ||
bd28ded5 JH |
5775 | =item Building Extensions Can Fail Because Of Largefiles |
5776 | ||
5777 | =item The Compiler Suite Is Still Experimental | |
5778 | ||
603b90a8 JH |
5779 | =back |
5780 | ||
5781 | =item Reporting Bugs | |
5782 | ||
5783 | =item SEE ALSO | |
5784 | ||
5785 | =item HISTORY | |
5786 | ||
5787 | =back | |
5788 | ||
5789 | =head2 perl570delta - what's new for perl v5.7.0 | |
694468e3 | 5790 | |
d420ca49 | 5791 | =over 4 |
694468e3 | 5792 | |
7029d033 | 5793 | =item DESCRIPTION |
694468e3 | 5794 | |
a9ef4385 JH |
5795 | =item Security Vulnerability Closed |
5796 | ||
5797 | =item Incompatible Changes | |
5798 | ||
7029d033 | 5799 | =item Core Enhancements |
694468e3 | 5800 | |
7029d033 | 5801 | =item Modules and Pragmata |
694468e3 | 5802 | |
d420ca49 | 5803 | =over 4 |
a9ef4385 JH |
5804 | |
5805 | =item New Modules | |
5806 | ||
5807 | =item Updated And Improved Modules and Pragmata | |
5808 | ||
5809 | =back | |
5810 | ||
7029d033 | 5811 | =item Utility Changes |
694468e3 | 5812 | |
a9ef4385 | 5813 | =item New Documentation |
694468e3 | 5814 | |
a9ef4385 | 5815 | =item Performance Enhancements |
694468e3 | 5816 | |
7029d033 | 5817 | =item Installation and Configuration Improvements |
694468e3 | 5818 | |
d420ca49 | 5819 | =over 4 |
694468e3 | 5820 | |
a9ef4385 | 5821 | =item Generic Improvements |
694468e3 | 5822 | |
4755096e | 5823 | =back |
694468e3 | 5824 | |
a9ef4385 | 5825 | =item Selected Bug Fixes |
694468e3 | 5826 | |
d420ca49 | 5827 | =over 4 |
cb1a09d0 | 5828 | |
a9ef4385 | 5829 | =item Platform Specific Changes and Fixes |
cb1a09d0 | 5830 | |
a9ef4385 | 5831 | =back |
cb1a09d0 | 5832 | |
a9ef4385 JH |
5833 | =item New or Changed Diagnostics |
5834 | ||
5835 | =item Changed Internals | |
cb1a09d0 | 5836 | |
4755096e | 5837 | =item Known Problems |
cb1a09d0 | 5838 | |
d420ca49 | 5839 | =over 4 |
a9ef4385 JH |
5840 | |
5841 | =item Unicode Support Still Far From Perfect | |
5842 | ||
5843 | =item EBCDIC Still A Lost Platform | |
5844 | ||
5845 | =item Building Extensions Can Fail Because Of Largefiles | |
5846 | ||
93d73c42 JH |
5847 | =item ftmp-security tests warn 'system possibly insecure' |
5848 | ||
b3b6085d PP |
5849 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
5850 | ||
93d73c42 | 5851 | =item Long Doubles Still Don't Work In Solaris |
9fa7f388 | 5852 | |
b3b6085d PP |
5853 | =item Linux With Sfio Fails op/misc Test 48 |
5854 | ||
9fa7f388 | 5855 | =item Storable tests fail in some platforms |
a9ef4385 | 5856 | |
93d73c42 JH |
5857 | =item Threads Are Still Experimental |
5858 | ||
5859 | =item The Compiler Suite Is Still Experimental | |
5860 | ||
a9ef4385 | 5861 | =back |
193fb0af | 5862 | |
4755096e | 5863 | =item Reporting Bugs |
8ebc5c01 | 5864 | |
4755096e | 5865 | =item SEE ALSO |
8ebc5c01 | 5866 | |
4755096e | 5867 | =item HISTORY |
8ebc5c01 | 5868 | |
a45bd81d GS |
5869 | =back |
5870 | ||
f502af34 | 5871 | =head2 perl561delta - what's new for perl v5.6.x |
493a87da JH |
5872 | |
5873 | =over 4 | |
5874 | ||
5875 | =item DESCRIPTION | |
5876 | ||
5877 | =item Summary of changes between 5.6.0 and 5.6.1 | |
5878 | ||
5879 | =over 4 | |
5880 | ||
5881 | =item Security Issues | |
5882 | ||
5883 | =item Core bug fixes | |
5884 | ||
5885 | C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), | |
5886 | Bugs in regular expressions, "slurp" mode, Autovivification of symbolic | |
5887 | references to special variables, Lexical warnings, Spurious warnings and | |
5888 | errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, | |
5889 | map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, | |
5890 | Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no | |
5891 | Module;>, Tests | |
5892 | ||
5893 | =item Core features | |
5894 | ||
5895 | =item Configuration issues | |
5896 | ||
5897 | =item Documentation | |
5898 | ||
5899 | =item Bundled modules | |
5900 | ||
5901 | B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, | |
5902 | Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, | |
5903 | IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, | |
5904 | Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash | |
5905 | ||
5906 | =item Platform-specific improvements | |
5907 | ||
5908 | NCR MP-RAS, NonStop-UX | |
5909 | ||
04b01f78 JH |
5910 | =back |
5911 | ||
5912 | =item Core Enhancements | |
5913 | ||
5914 | =over 4 | |
5915 | ||
493a87da JH |
5916 | =item Interpreter cloning, threads, and concurrency |
5917 | ||
5918 | =item Lexically scoped warning categories | |
5919 | ||
5920 | =item Unicode and UTF-8 support | |
5921 | ||
5922 | =item Support for interpolating named characters | |
5923 | ||
5924 | =item "our" declarations | |
5925 | ||
5926 | =item Support for strings represented as a vector of ordinals | |
5927 | ||
5928 | =item Improved Perl version numbering system | |
5929 | ||
5930 | =item New syntax for declaring subroutine attributes | |
5931 | ||
5932 | =item File and directory handles can be autovivified | |
5933 | ||
5934 | =item open() with more than two arguments | |
5935 | ||
5936 | =item 64-bit support | |
5937 | ||
5938 | =item Large file support | |
5939 | ||
5940 | =item Long doubles | |
5941 | ||
5942 | =item "more bits" | |
5943 | ||
5944 | =item Enhanced support for sort() subroutines | |
5945 | ||
5946 | =item C<sort $coderef @foo> allowed | |
5947 | ||
5948 | =item File globbing implemented internally | |
5949 | ||
5950 | =item Support for CHECK blocks | |
5951 | ||
5952 | =item POSIX character class syntax [: :] supported | |
5953 | ||
5954 | =item Better pseudo-random number generator | |
5955 | ||
5956 | =item Improved C<qw//> operator | |
5957 | ||
5958 | =item Better worst-case behavior of hashes | |
5959 | ||
5960 | =item pack() format 'Z' supported | |
5961 | ||
5962 | =item pack() format modifier '!' supported | |
5963 | ||
5964 | =item pack() and unpack() support counted strings | |
5965 | ||
5966 | =item Comments in pack() templates | |
5967 | ||
5968 | =item Weak references | |
5969 | ||
5970 | =item Binary numbers supported | |
5971 | ||
5972 | =item Lvalue subroutines | |
5973 | ||
5974 | =item Some arrows may be omitted in calls through references | |
5975 | ||
5976 | =item Boolean assignment operators are legal lvalues | |
5977 | ||
5978 | =item exists() is supported on subroutine names | |
5979 | ||
5980 | =item exists() and delete() are supported on array elements | |
5981 | ||
5982 | =item Pseudo-hashes work better | |
5983 | ||
5984 | =item Automatic flushing of output buffers | |
5985 | ||
5986 | =item Better diagnostics on meaningless filehandle operations | |
5987 | ||
5988 | =item Where possible, buffered data discarded from duped input filehandle | |
5989 | ||
5990 | =item eof() has the same old magic as <> | |
5991 | ||
5992 | =item binmode() can be used to set :crlf and :raw modes | |
5993 | ||
5994 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" | |
5995 | ||
5996 | =item system(), backticks and pipe open now reflect exec() failure | |
5997 | ||
5998 | =item Improved diagnostics | |
5999 | ||
6000 | =item Diagnostics follow STDERR | |
6001 | ||
6002 | =item More consistent close-on-exec behavior | |
6003 | ||
6004 | =item syswrite() ease-of-use | |
6005 | ||
6006 | =item Better syntax checks on parenthesized unary operators | |
6007 | ||
6008 | =item Bit operators support full native integer width | |
6009 | ||
6010 | =item Improved security features | |
6011 | ||
6012 | =item More functional bareword prototype (*) | |
6013 | ||
6014 | =item C<require> and C<do> may be overridden | |
6015 | ||
6016 | =item $^X variables may now have names longer than one character | |
6017 | ||
6018 | =item New variable $^C reflects C<-c> switch | |
6019 | ||
6020 | =item New variable $^V contains Perl version as a string | |
6021 | ||
6022 | =item Optional Y2K warnings | |
6023 | ||
6024 | =item Arrays now always interpolate into double-quoted strings | |
6025 | ||
6026 | =back | |
6027 | ||
6028 | =item Modules and Pragmata | |
6029 | ||
6030 | =over 4 | |
6031 | ||
6032 | =item Modules | |
6033 | ||
6034 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, | |
6035 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
6036 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
6037 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
6038 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
6039 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
6040 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
6041 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
6042 | ||
6043 | =item Pragmata | |
6044 | ||
6045 | =back | |
6046 | ||
6047 | =item Utility Changes | |
6048 | ||
6049 | =over 4 | |
6050 | ||
6051 | =item dprofpp | |
6052 | ||
6053 | =item find2perl | |
6054 | ||
6055 | =item h2xs | |
6056 | ||
6057 | =item perlcc | |
6058 | ||
6059 | =item perldoc | |
6060 | ||
6061 | =item The Perl Debugger | |
6062 | ||
6063 | =back | |
6064 | ||
6065 | =item Improved Documentation | |
6066 | ||
6067 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, | |
6068 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
6069 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
6070 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
6071 | ||
6072 | =item Performance enhancements | |
6073 | ||
6074 | =over 4 | |
6075 | ||
6076 | =item Simple sort() using { $a <=> $b } and the like are optimized | |
6077 | ||
6078 | =item Optimized assignments to lexical variables | |
6079 | ||
6080 | =item Faster subroutine calls | |
6081 | ||
6082 | =item delete(), each(), values() and hash iteration are faster | |
6083 | ||
6084 | =back | |
6085 | ||
6086 | =item Installation and Configuration Improvements | |
6087 | ||
6088 | =over 4 | |
6089 | ||
6090 | =item -Dusethreads means something different | |
6091 | ||
6092 | =item New Configure flags | |
6093 | ||
6094 | =item Threadedness and 64-bitness now more daring | |
6095 | ||
6096 | =item Long Doubles | |
6097 | ||
6098 | =item -Dusemorebits | |
6099 | ||
6100 | =item -Duselargefiles | |
6101 | ||
6102 | =item installusrbinperl | |
6103 | ||
6104 | =item SOCKS support | |
6105 | ||
6106 | =item C<-A> flag | |
6107 | ||
6108 | =item Enhanced Installation Directories | |
6109 | ||
6110 | =item gcc automatically tried if 'cc' does not seem to be working | |
6111 | ||
6112 | =back | |
6113 | ||
6114 | =item Platform specific changes | |
6115 | ||
6116 | =over 4 | |
6117 | ||
6118 | =item Supported platforms | |
6119 | ||
6120 | =item DOS | |
6121 | ||
6122 | =item OS390 (OpenEdition MVS) | |
6123 | ||
6124 | =item VMS | |
6125 | ||
6126 | =item Win32 | |
6127 | ||
6128 | =back | |
6129 | ||
6130 | =item Significant bug fixes | |
6131 | ||
6132 | =over 4 | |
6133 | ||
6134 | =item <HANDLE> on empty files | |
6135 | ||
6136 | =item C<eval '...'> improvements | |
6137 | ||
6138 | =item All compilation errors are true errors | |
6139 | ||
6140 | =item Implicitly closed filehandles are safer | |
6141 | ||
6142 | =item Behavior of list slices is more consistent | |
6143 | ||
6144 | =item C<(\$)> prototype and C<$foo{a}> | |
6145 | ||
6146 | =item C<goto &sub> and AUTOLOAD | |
6147 | ||
6148 | =item C<-bareword> allowed under C<use integer> | |
6149 | ||
6150 | =item Failures in DESTROY() | |
6151 | ||
6152 | =item Locale bugs fixed | |
6153 | ||
6154 | =item Memory leaks | |
6155 | ||
6156 | =item Spurious subroutine stubs after failed subroutine calls | |
6157 | ||
6158 | =item Taint failures under C<-U> | |
6159 | ||
6160 | =item END blocks and the C<-c> switch | |
6161 | ||
6162 | =item Potential to leak DATA filehandles | |
6163 | ||
6164 | =back | |
6165 | ||
6166 | =item New or Changed Diagnostics | |
6167 | ||
6168 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet | |
6169 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
6170 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
6171 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
6172 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
6173 | passed through, /%s/ should probably be written as "%s", %s() called too | |
6174 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
6175 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
6176 | subroutine name, %s package attribute may clash with future reserved word: | |
6177 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
6178 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
6179 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
6180 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
6181 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
6182 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
6183 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
6184 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
6185 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
6186 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
6187 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
6188 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
6189 | "local" instead of "our"?), Document contains no data, entering effective | |
6190 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
6191 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
6192 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
6193 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
6194 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
6195 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
6196 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
6197 | separator character %s in attribute list, Invalid separator character %s in | |
6198 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
6199 | returning %s not implemented yet, Method %s not permitted, Missing | |
6200 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
6201 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
6202 | No space allowed after -%c, no UTC offset information; assuming local time | |
6203 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
6204 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
6205 | around "%s" list, Possible unintended interpolation of %s in string, | |
6206 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
6207 | instead, Premature end of script headers, Repeat count in pack overflows, | |
6208 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
6209 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
6210 | zero-length expression, switching effective %s is not implemented, This | |
6211 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
6212 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
6213 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
6214 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
6215 | list, Unterminated attribute list, Unterminated attribute parameter in | |
6216 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
6217 | CLI symbol "%s" too long, Version number must be a constant number | |
6218 | ||
6219 | =item New tests | |
6220 | ||
6221 | =item Incompatible Changes | |
6222 | ||
6223 | =over 4 | |
6224 | ||
6225 | =item Perl Source Incompatibilities | |
6226 | ||
6227 | CHECK is a new keyword, Treatment of list slices of undef has changed, | |
6228 | Format of $English::PERL_VERSION is different, Literals of the form | |
6229 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
6230 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
6231 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
6232 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), | |
6233 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
6234 | Text of some diagnostic output has changed, C<%@> has been removed, | |
6235 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
6236 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
6237 | on 64-bit platforms, More builtins taint their results | |
6238 | ||
6239 | =item C Source Incompatibilities | |
6240 | ||
6241 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> | |
6242 | ||
6243 | =item Compatible C Source API Changes | |
6244 | ||
6245 | C<PATCHLEVEL> is now C<PERL_VERSION> | |
6246 | ||
6247 | =item Binary Incompatibilities | |
6248 | ||
6249 | =back | |
6250 | ||
6251 | =item Known Problems | |
6252 | ||
6253 | =over 4 | |
6254 | ||
6255 | =item Localizing a tied hash element may leak memory | |
6256 | ||
6257 | =item Known test failures | |
6258 | ||
ff426ff2 | 6259 | , , |
493a87da JH |
6260 | |
6261 | =item EBCDIC platforms not fully supported | |
6262 | ||
6263 | =item UNICOS/mk CC failures during Configure run | |
6264 | ||
6265 | =item Arrow operator and arrays | |
6266 | ||
6267 | =item Experimental features | |
6268 | ||
6269 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The | |
6270 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
6271 | globbing, The DB module, The regular expression code constructs: | |
6272 | ||
6273 | =back | |
6274 | ||
6275 | =item Obsolete Diagnostics | |
6276 | ||
6277 | Character class syntax [: :] is reserved for future extensions, Ill-formed | |
6278 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
6279 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
6280 | to mean "${$}<digit>" is deprecated | |
6281 | ||
6282 | =item Reporting Bugs | |
6283 | ||
6284 | =item SEE ALSO | |
6285 | ||
6286 | =item HISTORY | |
6287 | ||
6288 | =back | |
6289 | ||
f502af34 | 6290 | =head2 perl56delta - what's new for perl v5.6.0 |
14218588 | 6291 | |
d420ca49 | 6292 | =over 4 |
a45bd81d | 6293 | |
14218588 GS |
6294 | =item DESCRIPTION |
6295 | ||
4755096e | 6296 | =item Core Enhancements |
14218588 | 6297 | |
d420ca49 | 6298 | =over 4 |
14218588 | 6299 | |
4755096e | 6300 | =item Interpreter cloning, threads, and concurrency |
14218588 | 6301 | |
4755096e | 6302 | =item Lexically scoped warning categories |
14218588 | 6303 | |
4755096e | 6304 | =item Unicode and UTF-8 support |
14218588 | 6305 | |
4755096e | 6306 | =item Support for interpolating named characters |
14218588 | 6307 | |
4755096e | 6308 | =item "our" declarations |
14218588 | 6309 | |
4755096e | 6310 | =item Support for strings represented as a vector of ordinals |
14218588 | 6311 | |
4755096e | 6312 | =item Improved Perl version numbering system |
14218588 | 6313 | |
4755096e | 6314 | =item New syntax for declaring subroutine attributes |
14218588 | 6315 | |
4755096e | 6316 | =item File and directory handles can be autovivified |
14218588 | 6317 | |
4755096e | 6318 | =item open() with more than two arguments |
14218588 | 6319 | |
4755096e | 6320 | =item 64-bit support |
14218588 | 6321 | |
4755096e | 6322 | =item Large file support |
14218588 | 6323 | |
4755096e | 6324 | =item Long doubles |
14218588 | 6325 | |
4755096e | 6326 | =item "more bits" |
14218588 | 6327 | |
4755096e | 6328 | =item Enhanced support for sort() subroutines |
14218588 | 6329 | |
4755096e | 6330 | =item C<sort $coderef @foo> allowed |
14218588 | 6331 | |
4755096e | 6332 | =item File globbing implemented internally |
14218588 | 6333 | |
4755096e | 6334 | =item Support for CHECK blocks |
14218588 | 6335 | |
4755096e | 6336 | =item POSIX character class syntax [: :] supported |
14218588 | 6337 | |
4755096e | 6338 | =item Better pseudo-random number generator |
a45bd81d | 6339 | |
4755096e | 6340 | =item Improved C<qw//> operator |
8ebc5c01 | 6341 | |
4755096e | 6342 | =item Better worst-case behavior of hashes |
a45bd81d | 6343 | |
4755096e | 6344 | =item pack() format 'Z' supported |
8ebc5c01 | 6345 | |
4755096e | 6346 | =item pack() format modifier '!' supported |
8ebc5c01 | 6347 | |
4755096e | 6348 | =item pack() and unpack() support counted strings |
8ebc5c01 | 6349 | |
4755096e | 6350 | =item Comments in pack() templates |
8ebc5c01 | 6351 | |
4755096e | 6352 | =item Weak references |
8ebc5c01 | 6353 | |
4755096e | 6354 | =item Binary numbers supported |
8ebc5c01 | 6355 | |
4755096e | 6356 | =item Lvalue subroutines |
14218588 | 6357 | |
4755096e | 6358 | =item Some arrows may be omitted in calls through references |
8ebc5c01 | 6359 | |
4755096e | 6360 | =item Boolean assignment operators are legal lvalues |
8ebc5c01 | 6361 | |
4755096e | 6362 | =item exists() is supported on subroutine names |
8ebc5c01 | 6363 | |
4755096e | 6364 | =item exists() and delete() are supported on array elements |
cb1a09d0 | 6365 | |
4755096e | 6366 | =item Pseudo-hashes work better |
cb1a09d0 | 6367 | |
4755096e | 6368 | =item Automatic flushing of output buffers |
cb1a09d0 | 6369 | |
4755096e | 6370 | =item Better diagnostics on meaningless filehandle operations |
cb1a09d0 | 6371 | |
4755096e | 6372 | =item Where possible, buffered data discarded from duped input filehandle |
a45bd81d | 6373 | |
4755096e | 6374 | =item eof() has the same old magic as <> |
cb1a09d0 | 6375 | |
4755096e | 6376 | =item binmode() can be used to set :crlf and :raw modes |
a45bd81d | 6377 | |
4755096e | 6378 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
cb1a09d0 | 6379 | |
4755096e | 6380 | =item system(), backticks and pipe open now reflect exec() failure |
cb1a09d0 | 6381 | |
4755096e | 6382 | =item Improved diagnostics |
cb1a09d0 | 6383 | |
4755096e | 6384 | =item Diagnostics follow STDERR |
cb1a09d0 | 6385 | |
4755096e | 6386 | =item More consistent close-on-exec behavior |
cb1a09d0 | 6387 | |
4755096e | 6388 | =item syswrite() ease-of-use |
cb1a09d0 | 6389 | |
4755096e | 6390 | =item Better syntax checks on parenthesized unary operators |
cb1a09d0 | 6391 | |
4755096e | 6392 | =item Bit operators support full native integer width |
cb1a09d0 | 6393 | |
4755096e | 6394 | =item Improved security features |
cb1a09d0 | 6395 | |
4755096e | 6396 | =item More functional bareword prototype (*) |
cb1a09d0 | 6397 | |
4755096e | 6398 | =item C<require> and C<do> may be overridden |
cb1a09d0 | 6399 | |
4755096e | 6400 | =item $^X variables may now have names longer than one character |
4fdae800 | 6401 | |
4755096e | 6402 | =item New variable $^C reflects C<-c> switch |
cb1a09d0 | 6403 | |
4755096e | 6404 | =item New variable $^V contains Perl version as a string |
cb1a09d0 | 6405 | |
4755096e | 6406 | =item Optional Y2K warnings |
cb1a09d0 | 6407 | |
4755096e | 6408 | =item Arrays now always interpolate into double-quoted strings |
cb1a09d0 | 6409 | |
a45bd81d GS |
6410 | =back |
6411 | ||
4755096e | 6412 | =item Modules and Pragmata |
cb1a09d0 | 6413 | |
d420ca49 | 6414 | =over 4 |
a45bd81d | 6415 | |
4755096e | 6416 | =item Modules |
cb1a09d0 | 6417 | |
4755096e GS |
6418 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
6419 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
6420 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
6421 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
6422 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
6423 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
6424 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
6425 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
cb1a09d0 | 6426 | |
4755096e | 6427 | =item Pragmata |
cb1a09d0 | 6428 | |
4755096e | 6429 | =back |
cb1a09d0 | 6430 | |
4755096e | 6431 | =item Utility Changes |
cb1a09d0 | 6432 | |
d420ca49 | 6433 | =over 4 |
cb1a09d0 | 6434 | |
4755096e | 6435 | =item dprofpp |
cb1a09d0 | 6436 | |
4755096e | 6437 | =item find2perl |
cb1a09d0 | 6438 | |
4755096e | 6439 | =item h2xs |
cb1a09d0 | 6440 | |
4755096e | 6441 | =item perlcc |
cb1a09d0 | 6442 | |
4755096e GS |
6443 | =item perldoc |
6444 | ||
6445 | =item The Perl Debugger | |
cb1a09d0 | 6446 | |
a45bd81d GS |
6447 | =back |
6448 | ||
4755096e | 6449 | =item Improved Documentation |
cb1a09d0 | 6450 | |
4755096e GS |
6451 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
6452 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
6453 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
6454 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
a45bd81d | 6455 | |
4755096e | 6456 | =item Performance enhancements |
cb1a09d0 | 6457 | |
d420ca49 | 6458 | =over 4 |
cb1a09d0 | 6459 | |
4755096e | 6460 | =item Simple sort() using { $a <=> $b } and the like are optimized |
cb1a09d0 | 6461 | |
4755096e | 6462 | =item Optimized assignments to lexical variables |
193fb0af | 6463 | |
4755096e GS |
6464 | =item Faster subroutine calls |
6465 | ||
6466 | =item delete(), each(), values() and hash iteration are faster | |
193fb0af GS |
6467 | |
6468 | =back | |
6469 | ||
4755096e | 6470 | =item Installation and Configuration Improvements |
cb1a09d0 | 6471 | |
d420ca49 | 6472 | =over 4 |
cb1a09d0 | 6473 | |
4755096e | 6474 | =item -Dusethreads means something different |
68dc0745 | 6475 | |
4755096e | 6476 | =item New Configure flags |
68dc0745 | 6477 | |
4755096e | 6478 | =item Threadedness and 64-bitness now more daring |
68dc0745 | 6479 | |
4755096e | 6480 | =item Long Doubles |
cb1a09d0 | 6481 | |
4755096e | 6482 | =item -Dusemorebits |
55497cff | 6483 | |
4755096e GS |
6484 | =item -Duselargefiles |
6485 | ||
6486 | =item installusrbinperl | |
6487 | ||
6488 | =item SOCKS support | |
6489 | ||
6490 | =item C<-A> flag | |
6491 | ||
6492 | =item Enhanced Installation Directories | |
193fb0af | 6493 | |
8ebc5c01 | 6494 | =back |
6495 | ||
4755096e | 6496 | =item Platform specific changes |
55497cff | 6497 | |
d420ca49 | 6498 | =over 4 |
cb1a09d0 | 6499 | |
4755096e | 6500 | =item Supported platforms |
193fb0af | 6501 | |
4755096e | 6502 | =item DOS |
55497cff | 6503 | |
4755096e GS |
6504 | =item OS390 (OpenEdition MVS) |
6505 | ||
6506 | =item VMS | |
6507 | ||
6508 | =item Win32 | |
55497cff | 6509 | |
c90c0ff4 | 6510 | =back |
6511 | ||
4755096e | 6512 | =item Significant bug fixes |
c90c0ff4 | 6513 | |
d420ca49 | 6514 | =over 4 |
c90c0ff4 | 6515 | |
4755096e | 6516 | =item <HANDLE> on empty files |
c90c0ff4 | 6517 | |
4755096e | 6518 | =item C<eval '...'> improvements |
c90c0ff4 | 6519 | |
4755096e | 6520 | =item All compilation errors are true errors |
c90c0ff4 | 6521 | |
4755096e | 6522 | =item Implicitly closed filehandles are safer |
cb1a09d0 | 6523 | |
4755096e | 6524 | =item Behavior of list slices is more consistent |
cb1a09d0 | 6525 | |
4755096e | 6526 | =item C<(\$)> prototype and C<$foo{a}> |
cb1a09d0 | 6527 | |
4755096e | 6528 | =item C<goto &sub> and AUTOLOAD |
c90c0ff4 | 6529 | |
4755096e | 6530 | =item C<-bareword> allowed under C<use integer> |
c90c0ff4 | 6531 | |
4755096e | 6532 | =item Failures in DESTROY() |
cb1a09d0 | 6533 | |
4755096e GS |
6534 | =item Locale bugs fixed |
6535 | ||
6536 | =item Memory leaks | |
6537 | ||
6538 | =item Spurious subroutine stubs after failed subroutine calls | |
cb1a09d0 | 6539 | |
4755096e | 6540 | =item Taint failures under C<-U> |
55497cff | 6541 | |
4755096e | 6542 | =item END blocks and the C<-c> switch |
55497cff | 6543 | |
4755096e | 6544 | =item Potential to leak DATA filehandles |
55497cff | 6545 | |
a45bd81d GS |
6546 | =back |
6547 | ||
4755096e | 6548 | =item New or Changed Diagnostics |
a45bd81d | 6549 | |
4755096e GS |
6550 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
6551 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
6552 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
6553 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
6554 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
6555 | passed through, /%s/ should probably be written as "%s", %s() called too | |
6556 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
6557 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
6558 | subroutine name, %s package attribute may clash with future reserved word: | |
6559 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
6560 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
6561 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
6562 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
6563 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
6564 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
6565 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
6566 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
6567 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
6568 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
6569 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
6570 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
6571 | "local" instead of "our"?), Document contains no data, entering effective | |
6572 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
6573 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
6574 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
6575 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
6576 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
6577 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
6578 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
6579 | separator character %s in attribute list, Invalid separator character %s in | |
6580 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
6581 | returning %s not implemented yet, Method %s not permitted, Missing | |
6582 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
6583 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
6584 | No space allowed after -%c, no UTC offset information; assuming local time | |
6585 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
6586 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
6587 | around "%s" list, Possible unintended interpolation of %s in string, | |
6588 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
6589 | instead, Premature end of script headers, Repeat count in pack overflows, | |
6590 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
6591 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
6592 | zero-length expression, switching effective %s is not implemented, This | |
6593 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
6594 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
6595 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
6596 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
6597 | list, Unterminated attribute list, Unterminated attribute parameter in | |
6598 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
6599 | CLI symbol "%s" too long, Version number must be a constant number | |
14218588 | 6600 | |
4755096e | 6601 | =item New tests |
14218588 | 6602 | |
4755096e | 6603 | =item Incompatible Changes |
14218588 | 6604 | |
d420ca49 | 6605 | =over 4 |
14218588 | 6606 | |
4755096e | 6607 | =item Perl Source Incompatibilities |
14218588 | 6608 | |
4755096e GS |
6609 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
6610 | Format of $English::PERL_VERSION is different, Literals of the form | |
6611 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
6612 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
6613 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
983dbef6 JH |
6614 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
6615 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
6616 | Text of some diagnostic output has changed, C<%@> has been removed, | |
6617 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
6618 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
6619 | on 64-bit platforms, More builtins taint their results | |
14218588 | 6620 | |
4755096e | 6621 | =item C Source Incompatibilities |
14218588 | 6622 | |
4755096e | 6623 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
14218588 | 6624 | |
4755096e | 6625 | =item Compatible C Source API Changes |
a45bd81d | 6626 | |
4755096e | 6627 | C<PATCHLEVEL> is now C<PERL_VERSION> |
55497cff | 6628 | |
4755096e | 6629 | =item Binary Incompatibilities |
a45bd81d | 6630 | |
4755096e | 6631 | =back |
55497cff | 6632 | |
4755096e | 6633 | =item Known Problems |
55497cff | 6634 | |
d420ca49 | 6635 | =over 4 |
55497cff | 6636 | |
4755096e | 6637 | =item Thread test failures |
b38f6a39 | 6638 | |
4755096e | 6639 | =item EBCDIC platforms not supported |
774d564b | 6640 | |
4755096e | 6641 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
774d564b | 6642 | |
4755096e | 6643 | =item NEXTSTEP 3.3 POSIX test failure |
774d564b | 6644 | |
4755096e GS |
6645 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
6646 | gcc | |
cb1a09d0 | 6647 | |
4755096e | 6648 | =item UNICOS/mk CC failures during Configure run |
cb1a09d0 | 6649 | |
4755096e | 6650 | =item Arrow operator and arrays |
cb1a09d0 | 6651 | |
4755096e | 6652 | =item Experimental features |
cb1a09d0 | 6653 | |
4755096e GS |
6654 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
6655 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
983dbef6 | 6656 | globbing, The DB module, The regular expression code constructs: |
cb1a09d0 | 6657 | |
b38f6a39 | 6658 | =back |
cb1a09d0 | 6659 | |
4755096e | 6660 | =item Obsolete Diagnostics |
b38f6a39 | 6661 | |
4755096e GS |
6662 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
6663 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
6664 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
6665 | to mean "${$}<digit>" is deprecated | |
6666 | ||
6667 | =item Reporting Bugs | |
cb1a09d0 | 6668 | |
b38f6a39 | 6669 | =item SEE ALSO |
cb1a09d0 | 6670 | |
4755096e | 6671 | =item HISTORY |
193fb0af | 6672 | |
8ebc5c01 | 6673 | =back |
cb1a09d0 | 6674 | |
f502af34 | 6675 | =head2 perl5005delta - what's new for perl5.005 |
193fb0af | 6676 | |
d420ca49 | 6677 | =over 4 |
193fb0af | 6678 | |
b38f6a39 | 6679 | =item DESCRIPTION |
193fb0af | 6680 | |
4755096e | 6681 | =item About the new versioning system |
193fb0af | 6682 | |
4755096e | 6683 | =item Incompatible Changes |
193fb0af | 6684 | |
d420ca49 | 6685 | =over 4 |
b38f6a39 | 6686 | |
4755096e | 6687 | =item WARNING: This version is not binary compatible with Perl 5.004. |
b38f6a39 | 6688 | |
4755096e | 6689 | =item Default installation structure has changed |
b38f6a39 | 6690 | |
4755096e | 6691 | =item Perl Source Compatibility |
193fb0af | 6692 | |
4755096e | 6693 | =item C Source Compatibility |
b38f6a39 | 6694 | |
4755096e | 6695 | =item Binary Compatibility |
b38f6a39 | 6696 | |
4755096e | 6697 | =item Security fixes may affect compatibility |
b38f6a39 | 6698 | |
4755096e | 6699 | =item Relaxed new mandatory warnings introduced in 5.004 |
b38f6a39 | 6700 | |
4755096e | 6701 | =item Licensing |
193fb0af GS |
6702 | |
6703 | =back | |
cb1a09d0 | 6704 | |
4755096e | 6705 | =item Core Changes |
fb9cefb4 | 6706 | |
d420ca49 | 6707 | =over 4 |
fb9cefb4 | 6708 | |
4755096e | 6709 | =item Threads |
fb9cefb4 | 6710 | |
4755096e | 6711 | =item Compiler |
fb9cefb4 | 6712 | |
4755096e | 6713 | =item Regular Expressions |
fb9cefb4 | 6714 | |
4755096e GS |
6715 | Many new and improved optimizations, Many bug fixes, New regular expression |
6716 | constructs, New operator for precompiled regular expressions, Other | |
6717 | improvements, Incompatible changes | |
fb9cefb4 | 6718 | |
4755096e | 6719 | =item Improved malloc() |
fb9cefb4 | 6720 | |
4755096e | 6721 | =item Quicksort is internally implemented |
ac65edd0 | 6722 | |
4755096e | 6723 | =item Reliable signals |
ac65edd0 | 6724 | |
4755096e | 6725 | =item Reliable stack pointers |
ac65edd0 | 6726 | |
4755096e | 6727 | =item More generous treatment of carriage returns |
ac65edd0 | 6728 | |
4755096e | 6729 | =item Memory leaks |
ac65edd0 | 6730 | |
4755096e | 6731 | =item Better support for multiple interpreters |
ac65edd0 | 6732 | |
4755096e | 6733 | =item Behavior of local() on array and hash elements is now well-defined |
ac65edd0 | 6734 | |
4755096e | 6735 | =item C<%!> is transparently tied to the L<Errno> module |
ac65edd0 | 6736 | |
4755096e | 6737 | =item Pseudo-hashes are supported |
b38f6a39 | 6738 | |
4755096e | 6739 | =item C<EXPR foreach EXPR> is supported |
ac65edd0 | 6740 | |
4755096e | 6741 | =item Keywords can be globally overridden |
ac65edd0 | 6742 | |
4755096e | 6743 | =item C<$^E> is meaningful on Win32 |
ac65edd0 | 6744 | |
4755096e | 6745 | =item C<foreach (1..1000000)> optimized |
cb1a09d0 | 6746 | |
4755096e | 6747 | =item C<Foo::> can be used as implicitly quoted package name |
a45bd81d | 6748 | |
4755096e | 6749 | =item C<exists $Foo::{Bar::}> tests existence of a package |
cb1a09d0 | 6750 | |
4755096e | 6751 | =item Better locale support |
a45bd81d | 6752 | |
4755096e | 6753 | =item Experimental support for 64-bit platforms |
cb1a09d0 | 6754 | |
4755096e | 6755 | =item prototype() returns useful results on builtins |
a45bd81d | 6756 | |
4755096e | 6757 | =item Extended support for exception handling |
cb1a09d0 | 6758 | |
4755096e | 6759 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods |
cb1a09d0 | 6760 | |
4755096e | 6761 | =item All C<printf> format conversions are handled internally |
55497cff | 6762 | |
4755096e | 6763 | =item New C<INIT> keyword |
b971f6e4 | 6764 | |
4755096e | 6765 | =item New C<lock> keyword |
cb1a09d0 | 6766 | |
4755096e | 6767 | =item New C<qr//> operator |
a6006777 | 6768 | |
4755096e | 6769 | =item C<our> is now a reserved word |
68dc0745 | 6770 | |
4755096e | 6771 | =item Tied arrays are now fully supported |
cb1a09d0 | 6772 | |
4755096e GS |
6773 | =item Tied handles support is better |
6774 | ||
6775 | =item 4th argument to substr | |
6776 | ||
6777 | =item Negative LENGTH argument to splice | |
6778 | ||
6779 | =item Magic lvalues are now more magical | |
6780 | ||
6781 | =item <> now reads in records | |
193fb0af | 6782 | |
a45bd81d GS |
6783 | =back |
6784 | ||
4755096e | 6785 | =item Supported Platforms |
cb1a09d0 | 6786 | |
d420ca49 | 6787 | =over 4 |
a45bd81d | 6788 | |
4755096e | 6789 | =item New Platforms |
cb1a09d0 | 6790 | |
4755096e | 6791 | =item Changes in existing support |
cb1a09d0 | 6792 | |
4755096e | 6793 | =back |
cb1a09d0 | 6794 | |
4755096e | 6795 | =item Modules and Pragmata |
cb1a09d0 | 6796 | |
d420ca49 | 6797 | =over 4 |
cb1a09d0 | 6798 | |
4755096e | 6799 | =item New Modules |
cb1a09d0 | 6800 | |
4755096e GS |
6801 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, |
6802 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
6803 | Thread, attrs, fields, re | |
cb1a09d0 | 6804 | |
4755096e | 6805 | =item Changes in existing modules |
cb1a09d0 | 6806 | |
4755096e | 6807 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, |
4d4e713d | 6808 | MakeMaker, CPAN, Cwd |
cb1a09d0 | 6809 | |
4755096e | 6810 | =back |
cb1a09d0 | 6811 | |
4755096e | 6812 | =item Utility Changes |
cb1a09d0 | 6813 | |
4755096e GS |
6814 | =item Documentation Changes |
6815 | ||
6816 | =item New Diagnostics | |
6817 | ||
6818 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
6819 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
6820 | package, Can't call method "%s" on an undefined value, Can't check | |
6821 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
6822 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
6823 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
6824 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
6825 | Character class syntax [: :] is reserved for future extensions, Character | |
6826 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
6827 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
6828 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
6829 | package main), Illegal hex digit ignored, No such array field, No such | |
6830 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
6831 | large request, Range iterator outside integer range, Recursive inheritance | |
ab648d5e JH |
6832 | detected while looking for method '%s' %s, Reference found where even-sized |
6833 | list expected, Undefined value assigned to typeglob, Use of reserved word | |
6834 | "%s" is deprecated, perl: warning: Setting locale failed | |
cb1a09d0 | 6835 | |
4755096e | 6836 | =item Obsolete Diagnostics |
cb1a09d0 | 6837 | |
4755096e GS |
6838 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open |
6839 | temporary file, regexp too big | |
cb1a09d0 | 6840 | |
4755096e | 6841 | =item Configuration Changes |
cb1a09d0 | 6842 | |
4755096e | 6843 | =item BUGS |
cb1a09d0 | 6844 | |
4755096e | 6845 | =item SEE ALSO |
cb1a09d0 | 6846 | |
4755096e | 6847 | =item HISTORY |
cb1a09d0 | 6848 | |
4755096e | 6849 | =back |
cb1a09d0 | 6850 | |
f502af34 | 6851 | =head2 perl5004delta - what's new for perl5.004 |
cb1a09d0 | 6852 | |
d420ca49 | 6853 | =over 4 |
cb1a09d0 | 6854 | |
4755096e | 6855 | =item DESCRIPTION |
cb1a09d0 | 6856 | |
4755096e | 6857 | =item Supported Environments |
cb1a09d0 | 6858 | |
4755096e | 6859 | =item Core Changes |
cb1a09d0 | 6860 | |
d420ca49 | 6861 | =over 4 |
cb1a09d0 | 6862 | |
4755096e | 6863 | =item List assignment to %ENV works |
cb1a09d0 | 6864 | |
d420ca49 | 6865 | =item Change to "Can't locate Foo.pm in @INC" error |
cb1a09d0 | 6866 | |
4755096e | 6867 | =item Compilation option: Binary compatibility with 5.003 |
cb1a09d0 | 6868 | |
4755096e | 6869 | =item $PERL5OPT environment variable |
cb1a09d0 | 6870 | |
4755096e | 6871 | =item Limitations on B<-M>, B<-m>, and B<-T> options |
cb1a09d0 | 6872 | |
4755096e | 6873 | =item More precise warnings |
cb1a09d0 | 6874 | |
4755096e | 6875 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods |
cb1a09d0 | 6876 | |
4755096e | 6877 | =item Previously deprecated %OVERLOAD is no longer usable |
cb1a09d0 | 6878 | |
4755096e | 6879 | =item Subroutine arguments created only when they're modified |
cb1a09d0 | 6880 | |
4755096e | 6881 | =item Group vector changeable with C<$)> |
a45bd81d | 6882 | |
4755096e | 6883 | =item Fixed parsing of $$<digit>, &$<digit>, etc. |
fb9cefb4 | 6884 | |
4755096e | 6885 | =item Fixed localization of $<digit>, $&, etc. |
a45bd81d | 6886 | |
4755096e | 6887 | =item No resetting of $. on implicit close |
fb9cefb4 | 6888 | |
4755096e | 6889 | =item C<wantarray> may return undef |
fb9cefb4 | 6890 | |
4755096e | 6891 | =item C<eval EXPR> determines value of EXPR in scalar context |
fb9cefb4 | 6892 | |
4755096e | 6893 | =item Changes to tainting checks |
fb9cefb4 | 6894 | |
4755096e GS |
6895 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No |
6896 | spawning if tainted $TERM doesn't look like a terminal name | |
fb9cefb4 | 6897 | |
4755096e | 6898 | =item New Opcode module and revised Safe module |
14218588 | 6899 | |
4755096e | 6900 | =item Embedding improvements |
fb9cefb4 | 6901 | |
4755096e | 6902 | =item Internal change: FileHandle class based on IO::* classes |
fb9cefb4 | 6903 | |
4755096e | 6904 | =item Internal change: PerlIO abstraction interface |
fb9cefb4 | 6905 | |
4755096e | 6906 | =item New and changed syntax |
fb9cefb4 | 6907 | |
4755096e | 6908 | $coderef->(PARAMS) |
fb9cefb4 | 6909 | |
4755096e | 6910 | =item New and changed builtin constants |
fb9cefb4 | 6911 | |
4755096e | 6912 | __PACKAGE__ |
14218588 | 6913 | |
4755096e | 6914 | =item New and changed builtin variables |
14218588 | 6915 | |
4755096e | 6916 | $^E, $^H, $^M |
fb9cefb4 | 6917 | |
4755096e | 6918 | =item New and changed builtin functions |
fb9cefb4 | 6919 | |
4755096e GS |
6920 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in |
6921 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
6922 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
6923 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
6924 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
fb9cefb4 | 6925 | |
4755096e | 6926 | =item New builtin methods |
fb9cefb4 | 6927 | |
4755096e | 6928 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
fb9cefb4 | 6929 | |
4755096e | 6930 | =item TIEHANDLE now supported |
fb9cefb4 | 6931 | |
4755096e GS |
6932 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this |
6933 | LIST, READLINE this, GETC this, DESTROY this | |
fb9cefb4 | 6934 | |
4755096e | 6935 | =item Malloc enhancements |
fb9cefb4 | 6936 | |
4755096e | 6937 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE |
fb9cefb4 | 6938 | |
4755096e | 6939 | =item Miscellaneous efficiency enhancements |
fb9cefb4 | 6940 | |
4755096e | 6941 | =back |
fb9cefb4 | 6942 | |
4755096e | 6943 | =item Support for More Operating Systems |
fb9cefb4 | 6944 | |
d420ca49 | 6945 | =over 4 |
fb9cefb4 | 6946 | |
4755096e | 6947 | =item Win32 |
14218588 | 6948 | |
4755096e | 6949 | =item Plan 9 |
fb9cefb4 | 6950 | |
4755096e | 6951 | =item QNX |
fb9cefb4 | 6952 | |
4755096e | 6953 | =item AmigaOS |
fb9cefb4 | 6954 | |
fb9cefb4 GS |
6955 | =back |
6956 | ||
4755096e GS |
6957 | =item Pragmata |
6958 | ||
6959 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
6960 | constant NAME => VALUE, use locale, use ops, use vmsish | |
6961 | ||
6962 | =item Modules | |
fb9cefb4 | 6963 | |
d420ca49 | 6964 | =over 4 |
fb9cefb4 | 6965 | |
4755096e | 6966 | =item Required Updates |
fb9cefb4 | 6967 | |
4755096e | 6968 | =item Installation directories |
fb9cefb4 | 6969 | |
4755096e | 6970 | =item Module information summary |
fb9cefb4 | 6971 | |
4755096e | 6972 | =item Fcntl |
14218588 | 6973 | |
4755096e | 6974 | =item IO |
14218588 | 6975 | |
4755096e | 6976 | =item Math::Complex |
b38f6a39 | 6977 | |
4755096e | 6978 | =item Math::Trig |
37590e52 | 6979 | |
4755096e | 6980 | =item DB_File |
fb9cefb4 | 6981 | |
4755096e GS |
6982 | =item Net::Ping |
6983 | ||
6984 | =item Object-oriented overrides for builtin operators | |
fb9cefb4 | 6985 | |
a45bd81d GS |
6986 | =back |
6987 | ||
4755096e | 6988 | =item Utility Changes |
cb1a09d0 | 6989 | |
d420ca49 | 6990 | =over 4 |
a45bd81d | 6991 | |
4755096e | 6992 | =item pod2html |
a45bd81d | 6993 | |
4755096e | 6994 | Sends converted HTML to standard output |
cb1a09d0 | 6995 | |
4755096e | 6996 | =item xsubpp |
a45bd81d | 6997 | |
4755096e | 6998 | C<void> XSUBs now default to returning nothing |
cb1a09d0 | 6999 | |
4755096e | 7000 | =back |
d516a115 | 7001 | |
4755096e | 7002 | =item C Language API Changes |
d516a115 | 7003 | |
4755096e GS |
7004 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for |
7005 | manipulating hashes | |
d516a115 | 7006 | |
4755096e | 7007 | =item Documentation Changes |
d516a115 | 7008 | |
4755096e GS |
7009 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, |
7010 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
d516a115 | 7011 | |
4755096e | 7012 | =item New Diagnostics |
cb1a09d0 | 7013 | |
4755096e GS |
7014 | "my" variable %s masks earlier declaration in same scope, %s argument is |
7015 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
7016 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
7017 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
7018 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
7019 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
7020 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
7021 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
7022 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
7023 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
7024 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
7025 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
7026 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
7027 | possible typo, Null picture in formline, Offset outside string, Out of | |
7028 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
7029 | attempt to put comments in qw() list, Possible attempt to separate words | |
7030 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
ab648d5e JH |
7031 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" |
7032 | option, untie attempted while %d inner references still exist, Unrecognized | |
7033 | character %s, Unsupported function fork, Use of "$$<digit>" to mean | |
7034 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), | |
7035 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, | |
7036 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, | |
7037 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too | |
7038 | long, Process terminated by SIG%s | |
cb1a09d0 | 7039 | |
4755096e | 7040 | =item BUGS |
d516a115 | 7041 | |
8ebc5c01 | 7042 | =item SEE ALSO |
cb1a09d0 | 7043 | |
4755096e | 7044 | =item HISTORY |
cb1a09d0 | 7045 | |
a45bd81d GS |
7046 | =back |
7047 | ||
37d4d706 JH |
7048 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems |
7049 | ||
d420ca49 | 7050 | =over 4 |
37d4d706 JH |
7051 | |
7052 | =item DESCRIPTION | |
7053 | ||
d420ca49 | 7054 | =over 4 |
37d4d706 JH |
7055 | |
7056 | =item Compiling Perl 5 on AIX | |
7057 | ||
7058 | =item OS level | |
7059 | ||
7060 | =item Building Dynamic Extensions on AIX | |
7061 | ||
7062 | =item The IBM ANSI C Compiler | |
7063 | ||
7064 | =item Using GNU's gcc for building perl | |
7065 | ||
7066 | =item Using Large Files with Perl | |
7067 | ||
7068 | =item Threaded Perl | |
7069 | ||
7070 | =item 64-bit Perl | |
7071 | ||
27713a04 | 7072 | =item AIX 4.2 and extensions using C++ with statics |
37d4d706 JH |
7073 | |
7074 | =back | |
7075 | ||
7076 | =item AUTHOR | |
7077 | ||
7078 | =item DATE | |
7079 | ||
7080 | =back | |
7081 | ||
a83b6f46 JH |
7082 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS |
7083 | ||
7084 | =over 4 | |
7085 | ||
7086 | =item DESCRIPTION | |
7087 | ||
7088 | =item AUTHOR | |
7089 | ||
7090 | =back | |
7091 | ||
165c0277 | 7092 | =head2 perlamiga - Perl under Amiga OS |
cb1a09d0 | 7093 | |
d420ca49 | 7094 | =over 4 |
a45bd81d | 7095 | |
4755096e | 7096 | =item SYNOPSIS |
cb1a09d0 | 7097 | |
a45bd81d GS |
7098 | =back |
7099 | ||
d420ca49 | 7100 | =over 4 |
a45bd81d | 7101 | |
8ebc5c01 | 7102 | =item DESCRIPTION |
cb1a09d0 | 7103 | |
d420ca49 | 7104 | =over 4 |
cb1a09d0 | 7105 | |
a83b6f46 | 7106 | =item Prerequisites for Compiling Perl on AmigaOS |
cb1a09d0 | 7107 | |
4755096e | 7108 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> |
cb1a09d0 | 7109 | |
4755096e | 7110 | =item Starting Perl programs under AmigaOS |
cb1a09d0 | 7111 | |
4755096e | 7112 | =item Shortcomings of Perl under AmigaOS |
cb1a09d0 | 7113 | |
4755096e | 7114 | =back |
cb1a09d0 | 7115 | |
4755096e | 7116 | =item INSTALLATION |
cb1a09d0 | 7117 | |
4755096e | 7118 | =item Accessing documentation |
cb1a09d0 | 7119 | |
d420ca49 | 7120 | =over 4 |
cb1a09d0 | 7121 | |
a83b6f46 | 7122 | =item Manpages for Perl on AmigaOS |
cb1a09d0 | 7123 | |
a83b6f46 | 7124 | =item Perl HTML Documentation on AmigaOS |
cb1a09d0 | 7125 | |
a83b6f46 | 7126 | =item Perl GNU Info Files on AmigaOS |
4755096e | 7127 | |
a83b6f46 | 7128 | =item Perl LaTeX Documentation on AmigaOS |
cb1a09d0 | 7129 | |
8ebc5c01 | 7130 | =back |
cb1a09d0 | 7131 | |
a83b6f46 | 7132 | =item BUILDING PERL ON AMIGAOS |
3e3baf6d | 7133 | |
d420ca49 | 7134 | =over 4 |
4755096e | 7135 | |
a83b6f46 | 7136 | =item Build Prerequisites for Perl on AmigaOS |
4755096e | 7137 | |
a83b6f46 | 7138 | =item Getting the Perl Source for AmigaOS |
4755096e | 7139 | |
a83b6f46 | 7140 | =item Making Perl on AmigaOS |
4755096e | 7141 | |
a83b6f46 | 7142 | =item Testing Perl on AmigaOS |
4755096e | 7143 | |
a83b6f46 | 7144 | =item Installing the built Perl on AmigaOS |
4755096e GS |
7145 | |
7146 | =back | |
cb1a09d0 | 7147 | |
165c0277 | 7148 | =item AUTHORS |
cb1a09d0 | 7149 | |
4755096e | 7150 | =item SEE ALSO |
f86702cc | 7151 | |
a45bd81d GS |
7152 | =back |
7153 | ||
a83b6f46 JH |
7154 | =head2 perlbeos, README.beos - Perl version 5 on BeOS |
7155 | ||
7156 | =over 4 | |
7157 | ||
7158 | =item DESCRIPTION | |
7159 | ||
7160 | =over 4 | |
7161 | ||
7162 | =item General Issues with Perl on BeOS | |
7163 | ||
7164 | =item BeOS Release-specific Notes | |
7165 | ||
7166 | R4 x86, R4 PPC | |
7167 | ||
7168 | =item Contact Information | |
7169 | ||
ff426ff2 | 7170 | =item Update 2002-03-02 |
04b01f78 | 7171 | |
a83b6f46 JH |
7172 | =back |
7173 | ||
7174 | =back | |
7175 | ||
2d967e39 | 7176 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. |
dc5c060f JH |
7177 | |
7178 | =over 4 | |
7179 | ||
7180 | =item SYNOPSIS | |
7181 | ||
7182 | =item DESCRIPTION | |
7183 | ||
7184 | =over 4 | |
7185 | ||
a83b6f46 | 7186 | =item gzip on BS2000 |
dc5c060f | 7187 | |
a83b6f46 | 7188 | =item bison on BS2000 |
dc5c060f | 7189 | |
a83b6f46 | 7190 | =item Unpacking Perl Distribution on BS2000 |
dc5c060f | 7191 | |
a83b6f46 | 7192 | =item Compiling Perl on BS2000 |
dc5c060f | 7193 | |
a83b6f46 | 7194 | =item Testing Perl on BS2000 |
dc5c060f | 7195 | |
a83b6f46 | 7196 | =item Installing Perl on BS2000 |
dc5c060f | 7197 | |
a83b6f46 | 7198 | =item Using Perl in the Posix-Shell of BS2000 |
2d967e39 JH |
7199 | |
7200 | =item Using Perl in "native" BS2000 | |
dc5c060f | 7201 | |
a83b6f46 | 7202 | =item Floating point anomalies on BS2000 |
dc5c060f JH |
7203 | |
7204 | =back | |
7205 | ||
7206 | =item AUTHORS | |
7207 | ||
7208 | =item SEE ALSO | |
7209 | ||
7210 | =over 4 | |
7211 | ||
7212 | =item Mailing list | |
7213 | ||
7214 | =back | |
7215 | ||
7216 | =item HISTORY | |
7217 | ||
7218 | =back | |
7219 | ||
a1f19229 JH |
7220 | =over 4 |
7221 | ||
7222 | =item Name | |
7223 | ||
7224 | =item Description | |
7225 | ||
7226 | =item Build | |
7227 | ||
7228 | =over 4 | |
7229 | ||
7230 | =item Tools & SDK | |
7231 | ||
7232 | =item Make | |
7233 | ||
7234 | =back | |
7235 | ||
7236 | =item Acknowledgements | |
7237 | ||
7238 | =item Author | |
7239 | ||
7240 | =back | |
7241 | ||
4755096e | 7242 | =head2 perlcygwin, README.cygwin - Perl for Cygwin |
cb1a09d0 | 7243 | |
d420ca49 | 7244 | =over 4 |
a45bd81d | 7245 | |
8ebc5c01 | 7246 | =item SYNOPSIS |
cb1a09d0 | 7247 | |
a83b6f46 | 7248 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN |
cb1a09d0 | 7249 | |
d420ca49 | 7250 | =over 4 |
cb1a09d0 | 7251 | |
4755096e | 7252 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
cb1a09d0 | 7253 | |
4755096e | 7254 | =item Cygwin Configuration |
cb1a09d0 | 7255 | |
4755096e | 7256 | C<PATH>, I<nroff>, Permissions |
cb1a09d0 | 7257 | |
a45bd81d GS |
7258 | =back |
7259 | ||
a83b6f46 | 7260 | =item CONFIGURE PERL ON CYGWIN |
cb1a09d0 | 7261 | |
d420ca49 | 7262 | =over 4 |
a45bd81d | 7263 | |
a83b6f46 | 7264 | =item Stripping Perl Binaries on Cygwin |
cb1a09d0 | 7265 | |
a83b6f46 | 7266 | =item Optional Libraries for Perl on Cygwin |
cb1a09d0 | 7267 | |
4755096e GS |
7268 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), |
7269 | C<-lcygipc> (C<use IPC::SysV>) | |
cb1a09d0 | 7270 | |
a83b6f46 | 7271 | =item Configure-time Options for Perl on Cygwin |
cb1a09d0 | 7272 | |
248e172a | 7273 | C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, |
ff426ff2 JH |
7274 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, |
7275 | C<-Dmksymlinks> | |
cb1a09d0 | 7276 | |
a83b6f46 | 7277 | =item Suspicious Warnings on Cygwin |
cb1a09d0 | 7278 | |
74cac757 | 7279 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines |
cb1a09d0 | 7280 | |
4755096e | 7281 | =back |
cb1a09d0 | 7282 | |
a83b6f46 | 7283 | =item MAKE ON CYGWIN |
cb1a09d0 | 7284 | |
d420ca49 | 7285 | =over 4 |
cb1a09d0 | 7286 | |
a83b6f46 | 7287 | =item Warnings on Cygwin |
cb1a09d0 | 7288 | |
a83b6f46 | 7289 | =item ld2 on Cygwin |
7d2bfb28 | 7290 | |
4755096e | 7291 | =back |
cb1a09d0 | 7292 | |
a83b6f46 | 7293 | =item TEST ON CYGWIN |
cb1a09d0 | 7294 | |
d420ca49 | 7295 | =over 4 |
cb1a09d0 | 7296 | |
a83b6f46 | 7297 | =item File Permissions on Cygwin |
7d2bfb28 | 7298 | |
a83b6f46 | 7299 | =item Script Portability on Cygwin |
cb1a09d0 | 7300 | |
4755096e | 7301 | Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous |
cb1a09d0 | 7302 | |
4755096e | 7303 | =back |
cb1a09d0 | 7304 | |
a83b6f46 | 7305 | =item INSTALL PERL ON CYGWIN |
cb1a09d0 | 7306 | |
a83b6f46 | 7307 | =item MANIFEST ON CYGWIN |
cb1a09d0 | 7308 | |
4755096e GS |
7309 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl |
7310 | Source, Compiled Module Source, Perl Modules/Scripts | |
7d2bfb28 | 7311 | |
a83b6f46 | 7312 | =item BUGS ON CYGWIN |
7d2bfb28 | 7313 | |
4755096e | 7314 | =item AUTHORS |
7d2bfb28 | 7315 | |
4755096e | 7316 | =item HISTORY |
7d2bfb28 | 7317 | |
4755096e | 7318 | =back |
193fb0af | 7319 | |
245d750e JH |
7320 | =head2 perldgux - Perl under DG/UX. |
7321 | ||
7322 | =over 4 | |
7323 | ||
7324 | =item SYNOPSIS | |
7325 | ||
7326 | =back | |
7327 | ||
7328 | =over 4 | |
7329 | ||
7330 | =item DESCRIPTION | |
7331 | ||
a83b6f46 | 7332 | =item BUILDING PERL ON DG/UX |
245d750e JH |
7333 | |
7334 | =over 4 | |
7335 | ||
a83b6f46 | 7336 | =item Non-threaded Perl on DG/UX |
245d750e | 7337 | |
a83b6f46 | 7338 | =item Threaded Perl on DG/UX |
245d750e | 7339 | |
a83b6f46 | 7340 | =item Testing Perl on DG/UX |
245d750e | 7341 | |
a83b6f46 | 7342 | =item Installing the built perl on DG/UX |
245d750e JH |
7343 | |
7344 | =back | |
7345 | ||
7346 | =item AUTHOR | |
7347 | ||
7348 | =item SEE ALSO | |
7349 | ||
7350 | =back | |
7351 | ||
fa17183e JH |
7352 | =head2 perldos - Perl under DOS, W31, W95. |
7353 | ||
7354 | =over 4 | |
7355 | ||
7356 | =item SYNOPSIS | |
7357 | ||
7358 | =item DESCRIPTION | |
7359 | ||
7360 | =over 4 | |
7361 | ||
7362 | =item Prerequisites for Compiling Perl on DOS | |
7363 | ||
7364 | DJGPP, Pthreads | |
7365 | ||
7366 | =item Shortcomings of Perl under DOS | |
7367 | ||
7368 | =item Building Perl on DOS | |
7369 | ||
7370 | =item Testing Perl on DOS | |
7371 | ||
7372 | =item Installation of Perl on DOS | |
7373 | ||
7374 | =back | |
7375 | ||
7376 | =item BUILDING AND INSTALLING MODULES ON DOS | |
7377 | ||
7378 | =over 4 | |
7379 | ||
7380 | =item Building Prerequisites for Perl on DOS | |
7381 | ||
7382 | =item Unpacking CPAN Modules on DOS | |
7383 | ||
7384 | =item Building Non-XS Modules on DOS | |
7385 | ||
7386 | =item Building XS Modules on DOS | |
7387 | ||
7388 | =back | |
7389 | ||
7390 | =item AUTHOR | |
7391 | ||
7392 | =item SEE ALSO | |
7393 | ||
7394 | =back | |
7395 | ||
9a997319 JH |
7396 | =head2 perlepoc, README.epoc - Perl for EPOC |
7397 | ||
d420ca49 | 7398 | =over 4 |
9a997319 JH |
7399 | |
7400 | =item SYNOPSIS | |
7401 | ||
7402 | =item INTRODUCTION | |
7403 | ||
7404 | =item INSTALLING PERL ON EPOC | |
7405 | ||
2d967e39 JH |
7406 | =item STARTING PERL ON EPOC |
7407 | ||
d420ca49 | 7408 | =over 4 |
9a997319 | 7409 | |
a83b6f46 | 7410 | =item Editors on Epoc |
9a997319 | 7411 | |
a83b6f46 | 7412 | =item Features of Perl on Epoc |
9a997319 | 7413 | |
a83b6f46 | 7414 | =item Restrictions of Perl on Epoc |
9a997319 JH |
7415 | |
7416 | =item Compiling Perl 5 on the EPOC cross compiling environment | |
7417 | ||
7418 | =back | |
7419 | ||
a83b6f46 | 7420 | =item SUPPORT STATUS OF PERL ON EPOC |
9a997319 JH |
7421 | |
7422 | =item AUTHOR | |
7423 | ||
7424 | =item LAST UPDATE | |
7425 | ||
7426 | =back | |
7427 | ||
4755096e GS |
7428 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix |
7429 | (HP-UX) systems | |
cb1a09d0 | 7430 | |
d420ca49 | 7431 | =over 4 |
a45bd81d | 7432 | |
cb1a09d0 AD |
7433 | =item DESCRIPTION |
7434 | ||
d420ca49 | 7435 | =over 4 |
7d2bfb28 | 7436 | |
35bf961c JH |
7437 | =item Using perl as shipped with HP-UX |
7438 | ||
4755096e | 7439 | =item Compiling Perl 5 on HP-UX |
7d2bfb28 | 7440 | |
4755096e | 7441 | =item PA-RISC |
cb1a09d0 | 7442 | |
4755096e | 7443 | =item PA-RISC 1.0 |
cb1a09d0 | 7444 | |
4755096e | 7445 | =item PA-RISC 1.1 |
cb1a09d0 | 7446 | |
4755096e | 7447 | =item PA-RISC 2.0 |
cb1a09d0 | 7448 | |
35bf961c JH |
7449 | =item Itanium |
7450 | ||
4755096e | 7451 | =item Portability Between PA-RISC Versions |
cb1a09d0 | 7452 | |
a83b6f46 | 7453 | =item Itanium Processor Family and HP-UX |
772ff3b9 | 7454 | |
4755096e | 7455 | =item Building Dynamic Extensions on HP-UX |
cb1a09d0 | 7456 | |
4755096e | 7457 | =item The HP ANSI C Compiler |
cb1a09d0 | 7458 | |
a83b6f46 | 7459 | =item Using Large Files with Perl on HP-UX |
cb1a09d0 | 7460 | |
a83b6f46 | 7461 | =item Threaded Perl on HP-UX |
cb1a09d0 | 7462 | |
a83b6f46 | 7463 | =item 64-bit Perl on HP-UX |
cb1a09d0 | 7464 | |
a83b6f46 | 7465 | =item GDBM and Threads on HP-UX |
cb1a09d0 | 7466 | |
a83b6f46 | 7467 | =item NFS filesystems and utime(2) on HP-UX |
7d2bfb28 | 7468 | |
a83b6f46 | 7469 | =item perl -P and // and HP-UX |
7029d033 | 7470 | |
a83b6f46 | 7471 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl |
772ff3b9 | 7472 | |
4755096e | 7473 | =back |
a45bd81d | 7474 | |
35bf961c JH |
7475 | =item nss_delete core dump from op/pwent or op/grent |
7476 | ||
4755096e | 7477 | =item AUTHOR |
a45bd81d | 7478 | |
4755096e | 7479 | =item DATE |
7d2bfb28 | 7480 | |
4755096e | 7481 | =back |
7d2bfb28 | 7482 | |
a83b6f46 JH |
7483 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd |
7484 | ||
7485 | =over 4 | |
7486 | ||
7487 | =item DESCRIPTION | |
7488 | ||
7489 | =over 4 | |
7490 | ||
7491 | =item Known Problems with Perl on Hurd | |
7492 | ||
7493 | =back | |
7494 | ||
7495 | =item AUTHOR | |
7496 | ||
7497 | =back | |
7498 | ||
4755096e GS |
7499 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen |
7500 | systems | |
7d2bfb28 | 7501 | |
d420ca49 | 7502 | =over 4 |
7d2bfb28 | 7503 | |
4755096e | 7504 | =item DESCRIPTION |
7d2bfb28 | 7505 | |
d420ca49 | 7506 | =over 4 |
c76ac1ee | 7507 | |
4755096e | 7508 | =item Compiling Perl 5 on MachTen |
c76ac1ee | 7509 | |
a83b6f46 | 7510 | =item Failures during C<make test> on MachTen |
2e1d04bc | 7511 | |
4755096e | 7512 | op/lexassign.t, pragma/warnings.t |
c76ac1ee | 7513 | |
a83b6f46 | 7514 | =item Building external modules on MachTen |
c76ac1ee | 7515 | |
4755096e | 7516 | =back |
c76ac1ee | 7517 | |
4755096e | 7518 | =item AUTHOR |
c76ac1ee | 7519 | |
4755096e | 7520 | =item DATE |
c76ac1ee GS |
7521 | |
7522 | =back | |
7523 | ||
e42c74e1 JH |
7524 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) |
7525 | ||
7526 | =over 4 | |
7527 | ||
7528 | =item SYNOPSIS | |
7529 | ||
7530 | =item DESCRIPTION | |
7531 | ||
7532 | =item AUTHOR | |
7533 | ||
7534 | =item DATE | |
7535 | ||
7536 | =back | |
7537 | ||
a83b6f46 JH |
7538 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT |
7539 | ||
7540 | =over 4 | |
7541 | ||
7542 | =item DESCRIPTION | |
7543 | ||
7544 | =item Known problems with Perl on MiNT | |
7545 | ||
7546 | =item AUTHOR | |
7547 | ||
7548 | =back | |
7549 | ||
ab648d5e JH |
7550 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE |
7551 | ||
ab648d5e JH |
7552 | =over 4 |
7553 | ||
772ff3b9 JH |
7554 | =item SYNOPSIS |
7555 | ||
7556 | =item NOTE | |
7557 | ||
248e172a JH |
7558 | =item Binary distribution from HP |
7559 | ||
07fcf8ff | 7560 | =item What's New in Perl for MPE/iX |
ab648d5e | 7561 | |
a83b6f46 | 7562 | =item Welcome to Perl/iX |
772ff3b9 | 7563 | |
a83b6f46 | 7564 | =item System Requirements for Perl/iX |
ab648d5e JH |
7565 | |
7566 | =item How to Obtain Perl/iX | |
7567 | ||
a83b6f46 | 7568 | =item Perl/iX Distribution Contents Highlights |
ab648d5e | 7569 | |
772ff3b9 JH |
7570 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, |
7571 | public_html/feedback.cgi, src/perl-5.6.0-mpe | |
7572 | ||
7573 | =item How to Compile Perl/iX | |
7574 | ||
7575 | 4, 6 | |
ab648d5e JH |
7576 | |
7577 | =item Getting Started with Perl/iX | |
7578 | ||
7579 | =item MPE/iX Implementation Considerations | |
7580 | ||
a83b6f46 | 7581 | =item Known Perl/iX Bugs Under Investigation |
772ff3b9 | 7582 | |
a83b6f46 | 7583 | =item Perl/iX To-Do List |
772ff3b9 | 7584 | |
a83b6f46 | 7585 | =item Perl/iX Change History |
ab648d5e | 7586 | |
a83b6f46 | 7587 | =item AUTHOR |
772ff3b9 | 7588 | |
9038e305 JH |
7589 | =item Name |
7590 | ||
7591 | =item Description | |
7592 | ||
7593 | =item Build | |
7594 | ||
7595 | =over 4 | |
7596 | ||
7597 | =item Tools & SDK | |
7598 | ||
7599 | =item Setup | |
7600 | ||
7601 | Buildtype.bat, SetNWBld.bat, MPKBuild.bat | |
7602 | ||
7603 | =item Make | |
7604 | ||
7605 | =item Interpreter | |
7606 | ||
7607 | =item Extensions | |
7608 | ||
7609 | =back | |
7610 | ||
7611 | =item Install | |
7612 | ||
7613 | =item Build new extensions | |
7614 | ||
7615 | =item Known Issues | |
7616 | ||
7617 | =item Acknowledgements | |
7618 | ||
51a35ef1 | 7619 | =item Authors |
9038e305 JH |
7620 | |
7621 | =item Date | |
7622 | ||
ab648d5e JH |
7623 | =back |
7624 | ||
4755096e | 7625 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. |
cb1a09d0 | 7626 | |
d420ca49 | 7627 | =over 4 |
c76ac1ee | 7628 | |
4755096e | 7629 | =item SYNOPSIS |
7d2bfb28 | 7630 | |
a45bd81d GS |
7631 | =back |
7632 | ||
d420ca49 AD |
7633 | =over 4 |
7634 | ||
7635 | =item DESCRIPTION | |
7636 | ||
7637 | =over 4 | |
a45bd81d | 7638 | |
4755096e | 7639 | =item Target |
cb1a09d0 | 7640 | |
4755096e | 7641 | =item Other OSes |
0a753a76 | 7642 | |
4755096e | 7643 | =item Prerequisites |
cb1a09d0 | 7644 | |
4755096e | 7645 | EMX, RSX, HPFS, pdksh |
cb1a09d0 | 7646 | |
4755096e | 7647 | =item Starting Perl programs under OS/2 (and DOS and...) |
cb1a09d0 | 7648 | |
4755096e | 7649 | =item Starting OS/2 (and DOS) programs under Perl |
cb1a09d0 | 7650 | |
4755096e | 7651 | =back |
cb1a09d0 | 7652 | |
4755096e | 7653 | =item Frequently asked questions |
cb1a09d0 | 7654 | |
d420ca49 | 7655 | =over 4 |
1e422769 | 7656 | |
4d4e713d JH |
7657 | =item "It does not work" |
7658 | ||
4755096e | 7659 | =item I cannot run external programs |
cb1a09d0 | 7660 | |
4755096e GS |
7661 | =item I cannot embed perl into my program, or use F<perl.dll> from my |
7662 | program. | |
cb1a09d0 | 7663 | |
4755096e GS |
7664 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use |
7665 | L<ExtUtils::Embed>? | |
cb1a09d0 | 7666 | |
4755096e | 7667 | =item C<``> and pipe-C<open> do not work under DOS. |
cb1a09d0 | 7668 | |
4755096e | 7669 | =item Cannot start C<find.exe "pattern" file> |
cb1a09d0 | 7670 | |
4755096e | 7671 | =back |
0a753a76 | 7672 | |
4755096e | 7673 | =item INSTALLATION |
cb1a09d0 | 7674 | |
d420ca49 | 7675 | =over 4 |
cb1a09d0 | 7676 | |
4755096e | 7677 | =item Automatic binary installation |
cb1a09d0 | 7678 | |
4755096e | 7679 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> |
cb1a09d0 | 7680 | |
4755096e | 7681 | =item Manual binary installation |
3e3baf6d | 7682 | |
4755096e GS |
7683 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable |
7684 | (statically linked), Executables for Perl utilities, Main Perl library, | |
7685 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
7686 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
7687 | Perl manual in F<.INF> format, Pdksh | |
d516a115 | 7688 | |
4755096e | 7689 | =item B<Warning> |
d516a115 | 7690 | |
0a753a76 | 7691 | =back |
7692 | ||
4755096e | 7693 | =item Accessing documentation |
0a753a76 | 7694 | |
d420ca49 | 7695 | =over 4 |
cb1a09d0 | 7696 | |
4755096e | 7697 | =item OS/2 F<.INF> file |
cb1a09d0 | 7698 | |
4755096e | 7699 | =item Plain text |
cb1a09d0 | 7700 | |
4755096e | 7701 | =item Manpages |
cb1a09d0 | 7702 | |
4755096e | 7703 | =item HTML |
cb1a09d0 | 7704 | |
4755096e | 7705 | =item GNU C<info> files |
cb1a09d0 | 7706 | |
ff426ff2 | 7707 | =item F<PDF> files |
cb1a09d0 | 7708 | |
4755096e | 7709 | =item C<LaTeX> docs |
cb1a09d0 | 7710 | |
0a753a76 | 7711 | =back |
7712 | ||
4755096e | 7713 | =item BUILD |
0a753a76 | 7714 | |
d420ca49 | 7715 | =over 4 |
0a753a76 | 7716 | |
4d4e713d JH |
7717 | =item The short story |
7718 | ||
4755096e | 7719 | =item Prerequisites |
0a753a76 | 7720 | |
4755096e | 7721 | =item Getting perl source |
0a753a76 | 7722 | |
4755096e | 7723 | =item Application of the patches |
0a753a76 | 7724 | |
4755096e | 7725 | =item Hand-editing |
0a753a76 | 7726 | |
4755096e | 7727 | =item Making |
0a753a76 | 7728 | |
4755096e GS |
7729 | =item Testing |
7730 | ||
7731 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, | |
4d4e713d | 7732 | F<op/stat.t> |
4755096e GS |
7733 | |
7734 | =item Installing the built perl | |
7735 | ||
7736 | =item C<a.out>-style build | |
0a753a76 | 7737 | |
7738 | =back | |
7739 | ||
4755096e | 7740 | =item Build FAQ |
c76ac1ee | 7741 | |
d420ca49 | 7742 | =over 4 |
c76ac1ee | 7743 | |
4755096e | 7744 | =item Some C</> became C<\> in pdksh. |
c76ac1ee | 7745 | |
4755096e | 7746 | =item C<'errno'> - unresolved external |
c76ac1ee | 7747 | |
4755096e | 7748 | =item Problems with tr or sed |
c76ac1ee | 7749 | |
4755096e | 7750 | =item Some problem (forget which ;-) |
c76ac1ee | 7751 | |
4755096e | 7752 | =item Library ... not found |
cb1a09d0 | 7753 | |
4755096e | 7754 | =item Segfault in make |
954c1994 | 7755 | |
d396a558 JH |
7756 | =item op/sprintf test failure |
7757 | ||
a45bd81d GS |
7758 | =back |
7759 | ||
4755096e | 7760 | =item Specific (mis)features of OS/2 port |
cb1a09d0 | 7761 | |
d420ca49 | 7762 | =over 4 |
a45bd81d | 7763 | |
4755096e | 7764 | =item C<setpriority>, C<getpriority> |
cb1a09d0 | 7765 | |
4755096e | 7766 | =item C<system()> |
cb1a09d0 | 7767 | |
4755096e | 7768 | =item C<extproc> on the first line |
cb1a09d0 | 7769 | |
4755096e | 7770 | =item Additional modules: |
cb1a09d0 | 7771 | |
4755096e GS |
7772 | =item Prebuilt methods: |
7773 | ||
7774 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, | |
7775 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
7776 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
7777 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
7778 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
4d4e713d JH |
7779 | C<Cwd::extLibpath_set( path [, type ] )>, |
7780 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, | |
7781 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, | |
7782 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, | |
7783 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, | |
7784 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)> | |
7785 | ||
7786 | =item Prebuilt variables: | |
7787 | ||
7788 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver | |
4755096e GS |
7789 | |
7790 | =item Misfeatures | |
7791 | ||
7792 | =item Modifications | |
7793 | ||
4d4e713d JH |
7794 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, |
7795 | C<flock> | |
7796 | ||
7797 | =item Identifying DLLs | |
7798 | ||
7799 | =item Centralized management of resources | |
7800 | ||
7801 | C<HAB>, C<HMQ> | |
4755096e GS |
7802 | |
7803 | =back | |
7804 | ||
7805 | =item Perl flavors | |
cb1a09d0 | 7806 | |
d420ca49 | 7807 | =over 4 |
cb1a09d0 | 7808 | |
4755096e | 7809 | =item F<perl.exe> |
54310121 | 7810 | |
4755096e | 7811 | =item F<perl_.exe> |
cb1a09d0 | 7812 | |
4755096e | 7813 | =item F<perl__.exe> |
cb1a09d0 | 7814 | |
4755096e | 7815 | =item F<perl___.exe> |
cb1a09d0 | 7816 | |
4755096e | 7817 | =item Why strange names? |
cb1a09d0 | 7818 | |
4755096e | 7819 | =item Why dynamic linking? |
cb1a09d0 | 7820 | |
4755096e | 7821 | =item Why chimera build? |
7d2bfb28 | 7822 | |
cb1a09d0 AD |
7823 | =back |
7824 | ||
4755096e | 7825 | =item ENVIRONMENT |
cb1a09d0 | 7826 | |
d420ca49 | 7827 | =over 4 |
cb1a09d0 | 7828 | |
4755096e | 7829 | =item C<PERLLIB_PREFIX> |
cb1a09d0 | 7830 | |
4755096e | 7831 | =item C<PERL_BADLANG> |
cb1a09d0 | 7832 | |
4755096e | 7833 | =item C<PERL_BADFREE> |
cb1a09d0 | 7834 | |
4755096e | 7835 | =item C<PERL_SH_DIR> |
cb1a09d0 | 7836 | |
4755096e | 7837 | =item C<USE_PERL_FLOCK> |
cb1a09d0 | 7838 | |
4755096e | 7839 | =item C<TMP> or C<TEMP> |
cb1a09d0 | 7840 | |
4755096e | 7841 | =back |
cb1a09d0 | 7842 | |
4755096e | 7843 | =item Evolution |
7d2bfb28 | 7844 | |
d420ca49 | 7845 | =over 4 |
cb1a09d0 | 7846 | |
4755096e | 7847 | =item Priorities |
cb1a09d0 | 7848 | |
354a27bf JH |
7849 | =item DLL name mangling: pre 5.6.2 |
7850 | ||
7851 | =item DLL name mangling: 5.6.2 and beyond | |
7852 | ||
7853 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from | |
7854 | C<LIBPATH> | |
7855 | ||
7856 | =item DLL forwarder generation | |
cb1a09d0 | 7857 | |
4755096e | 7858 | =item Threading |
cb1a09d0 | 7859 | |
4755096e | 7860 | =item Calls to external programs |
cb1a09d0 | 7861 | |
4755096e | 7862 | =item Memory allocation |
cb1a09d0 | 7863 | |
4755096e | 7864 | =item Threads |
cb1a09d0 | 7865 | |
4755096e | 7866 | C<COND_WAIT>, F<os2.c> |
cb1a09d0 | 7867 | |
4755096e | 7868 | =back |
5cd24f17 | 7869 | |
354a27bf JH |
7870 | =item BUGS |
7871 | ||
cb1a09d0 AD |
7872 | =back |
7873 | ||
d420ca49 | 7874 | =over 4 |
cb1a09d0 | 7875 | |
cb1a09d0 AD |
7876 | =item AUTHOR |
7877 | ||
4755096e | 7878 | =item SEE ALSO |
cb1a09d0 | 7879 | |
a45bd81d GS |
7880 | =back |
7881 | ||
248e172a JH |
7882 | =head2 perlos390, README.os390 - building and installing Perl for OS/390 |
7883 | and z/OS | |
c76ac1ee | 7884 | |
d420ca49 | 7885 | =over 4 |
a45bd81d | 7886 | |
4755096e GS |
7887 | =item SYNOPSIS |
7888 | ||
c76ac1ee GS |
7889 | =item DESCRIPTION |
7890 | ||
d420ca49 | 7891 | =over 4 |
c76ac1ee | 7892 | |
248e172a JH |
7893 | =item Tools |
7894 | ||
a83b6f46 | 7895 | =item Unpacking Perl distribution on OS/390 |
c76ac1ee | 7896 | |
a83b6f46 | 7897 | =item Setup and utilities for Perl on OS/390 |
c76ac1ee | 7898 | |
a83b6f46 | 7899 | =item Configure Perl on OS/390 |
c76ac1ee | 7900 | |
a83b6f46 | 7901 | =item Build, Test, Install Perl on OS/390 |
c76ac1ee | 7902 | |
a83b6f46 | 7903 | =item Build Anomalies with Perl on OS/390 |
74cac757 | 7904 | |
a83b6f46 | 7905 | =item Testing Anomalies with Perl on OS/390 |
74cac757 | 7906 | |
a83b6f46 | 7907 | =item Installation Anomalies with Perl on OS/390 |
c2e66d9e | 7908 | |
a83b6f46 | 7909 | =item Usage Hints for Perl on OS/390 |
c2e66d9e | 7910 | |
a83b6f46 | 7911 | =item Floating Point Anomalies with Perl on OS/390 |
c2e66d9e | 7912 | |
a83b6f46 | 7913 | =item Modules and Extensions for Perl on OS/390 |
c2e66d9e GS |
7914 | |
7915 | =back | |
7916 | ||
7917 | =item AUTHORS | |
7918 | ||
7919 | =item SEE ALSO | |
7920 | ||
d420ca49 | 7921 | =over 4 |
c2e66d9e | 7922 | |
a83b6f46 | 7923 | =item Mailing list for Perl on OS/390 |
c2e66d9e GS |
7924 | |
7925 | =back | |
7926 | ||
7927 | =item HISTORY | |
7928 | ||
7929 | =back | |
7930 | ||
a83b6f46 JH |
7931 | =head2 perlqnx, README.qnx - Perl version 5 on QNX |
7932 | ||
7933 | =over 4 | |
7934 | ||
7935 | =item DESCRIPTION | |
7936 | ||
7937 | =over 4 | |
7938 | ||
27713a04 | 7939 | =item Required Software for Compiling Perl on QNX4 |
a83b6f46 JH |
7940 | |
7941 | /bin/sh, ar, nm, cpp, make | |
7942 | ||
27713a04 | 7943 | =item Outstanding Issues with Perl on QNX4 |
a83b6f46 JH |
7944 | |
7945 | =item QNX auxiliary files | |
7946 | ||
7947 | qnx/ar, qnx/cpp | |
7948 | ||
27713a04 JH |
7949 | =item Outstanding issues with perl under QNX6 |
7950 | ||
a83b6f46 JH |
7951 | =back |
7952 | ||
7953 | =item AUTHOR | |
7954 | ||
7955 | =back | |
7956 | ||
7957 | =head2 perlplan9 - Plan 9-specific documentation for Perl | |
7958 | ||
7959 | =over 4 | |
7960 | ||
7961 | =item DESCRIPTION | |
7962 | ||
7963 | =over 4 | |
7964 | ||
7965 | =item Invoking Perl | |
7966 | ||
7967 | =item What's in Plan 9 Perl | |
7968 | ||
7969 | =item What's not in Plan 9 Perl | |
7970 | ||
7971 | =item Perl5 Functions not currently supported in Plan 9 Perl | |
7972 | ||
7973 | =item Signals in Plan 9 Perl | |
7974 | ||
7975 | =back | |
7976 | ||
7977 | =item COMPILING AND INSTALLING PERL ON PLAN 9 | |
7978 | ||
7979 | =over 4 | |
7980 | ||
7981 | =item Installing Perl Documentation on Plan 9 | |
7982 | ||
7983 | =back | |
7984 | ||
7985 | =item BUGS | |
7986 | ||
7987 | =item Revision date | |
7988 | ||
7989 | =item AUTHOR | |
7990 | ||
7991 | =back | |
7992 | ||
d420ca49 AD |
7993 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems |
7994 | ||
7995 | =over 4 | |
7996 | ||
7997 | =item DESCRIPTION | |
7998 | ||
7999 | =over 4 | |
8000 | ||
8001 | =item Solaris Version Numbers. | |
8002 | ||
8003 | =back | |
8004 | ||
8005 | =item RESOURCES | |
8006 | ||
8007 | Solaris FAQ, Precompiled Binaries, Solaris Documentation | |
8008 | ||
8009 | =item SETTING UP | |
8010 | ||
8011 | =over 4 | |
8012 | ||
a83b6f46 | 8013 | =item File Extraction Problems on Solaris. |
d420ca49 | 8014 | |
a83b6f46 | 8015 | =item Compiler and Related Tools on Solaris. |
d420ca49 | 8016 | |
a83b6f46 | 8017 | =item Environment for Compiling Perl on Solaris |
d420ca49 AD |
8018 | |
8019 | =back | |
8020 | ||
8021 | =item RUN CONFIGURE. | |
8022 | ||
8023 | =over 4 | |
8024 | ||
a83b6f46 | 8025 | =item 64-bit Issues with Perl on Solaris. |
d420ca49 | 8026 | |
a83b6f46 | 8027 | =item Threads in Perl on Solaris. |
d420ca49 | 8028 | |
a83b6f46 | 8029 | =item Malloc Issues with Perl on Solaris. |
d420ca49 AD |
8030 | |
8031 | =back | |
8032 | ||
8033 | =item MAKE PROBLEMS. | |
8034 | ||
8035 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: | |
8036 | relocation error:, dlopen: stub interception failed, #error "No | |
8037 | DATAMODEL_NATIVE specified", sh: ar: not found | |
8038 | ||
8039 | =item MAKE TEST | |
8040 | ||
8041 | =over 4 | |
8042 | ||
a83b6f46 | 8043 | =item op/stat.t test 4 in Solaris |
d420ca49 | 8044 | |
35bf961c JH |
8045 | =item nss_delete core dump from op/pwent or op/grent |
8046 | ||
d420ca49 AD |
8047 | =back |
8048 | ||
a83b6f46 | 8049 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. |
d420ca49 | 8050 | |
a83b6f46 | 8051 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. |
d420ca49 AD |
8052 | |
8053 | =over 4 | |
8054 | ||
a83b6f46 | 8055 | =item Limits on Numbers of Open Files on Solaris. |
d420ca49 AD |
8056 | |
8057 | =back | |
8058 | ||
8059 | =item SOLARIS-SPECIFIC MODULES. | |
8060 | ||
8061 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. | |
8062 | ||
8063 | =over 4 | |
8064 | ||
a83b6f46 | 8065 | =item Proc::ProcessTable on Solaris |
d420ca49 | 8066 | |
354a27bf | 8067 | =item BSD::Resource on Solaris |
d420ca49 | 8068 | |
354a27bf | 8069 | =item Net::SSLeay on Solaris |
74cac757 | 8070 | |
d420ca49 AD |
8071 | =back |
8072 | ||
8073 | =item AUTHOR | |
8074 | ||
8075 | =item LAST MODIFIED | |
8076 | ||
8077 | =back | |
8078 | ||
772ff3b9 JH |
8079 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as |
8080 | Digital UNIX formerly known as DEC OSF/1) systems | |
8081 | ||
8082 | =over 4 | |
8083 | ||
8084 | =item DESCRIPTION | |
8085 | ||
8086 | =over 4 | |
8087 | ||
8088 | =item Compiling Perl 5 on Tru64 | |
8089 | ||
8090 | =item Using Large Files with Perl on Tru64 | |
8091 | ||
8092 | =item Threaded Perl on Tru64 | |
8093 | ||
a83b6f46 JH |
8094 | =item Long Doubles on Tru64 |
8095 | ||
772ff3b9 JH |
8096 | =item 64-bit Perl on Tru64 |
8097 | ||
8098 | =item Warnings about floating-point overflow when compiling Perl on Tru64 | |
8099 | ||
8100 | =back | |
8101 | ||
8102 | =item Testing Perl on Tru64 | |
8103 | ||
fa1c7b03 JH |
8104 | =item ext/ODBM_File/odbm Test Failing With Static Builds |
8105 | ||
772ff3b9 JH |
8106 | =item AUTHOR |
8107 | ||
8108 | =back | |
8109 | ||
91144103 JH |
8110 | =head2 perluts - Perl under UTS |
8111 | ||
8112 | =over 4 | |
8113 | ||
8114 | =item SYNOPSIS | |
8115 | ||
8116 | =item DESCRIPTION | |
8117 | ||
8118 | =item BUILDING PERL ON UTS | |
8119 | ||
8120 | =item Installing the built perl on UTS | |
8121 | ||
8122 | =item AUTHOR | |
8123 | ||
8124 | =back | |
8125 | ||
dc5c060f JH |
8126 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. |
8127 | ||
8128 | =over 4 | |
8129 | ||
8130 | =item SYNOPSIS | |
8131 | ||
8132 | =item DESCRIPTION | |
8133 | ||
8134 | =over 4 | |
8135 | ||
a83b6f46 | 8136 | =item Unpacking Perl Distribution on VM/ESA |
dc5c060f | 8137 | |
a83b6f46 | 8138 | =item Setup Perl and utilities on VM/ESA |
dc5c060f | 8139 | |
a83b6f46 | 8140 | =item Configure Perl on VM/ESA |
dc5c060f | 8141 | |
a83b6f46 | 8142 | =item Testing Anomalies of Perl on VM/ESA |
dc5c060f | 8143 | |
a83b6f46 | 8144 | =item Usage Hints for Perl on VM/ESA |
dc5c060f | 8145 | |
dc5c060f JH |
8146 | =back |
8147 | ||
8148 | =item AUTHORS | |
8149 | ||
8150 | =item SEE ALSO | |
8151 | ||
8152 | =over 4 | |
8153 | ||
a83b6f46 | 8154 | =item Mailing list for Perl on VM/ESA |
dc5c060f JH |
8155 | |
8156 | =back | |
8157 | ||
8158 | =back | |
8159 | ||
4755096e | 8160 | =head2 perlvms - VMS-specific documentation for Perl |
954c1994 | 8161 | |
d420ca49 | 8162 | =over 4 |
954c1994 | 8163 | |
4755096e | 8164 | =item DESCRIPTION |
a45bd81d | 8165 | |
4755096e GS |
8166 | =item Installation |
8167 | ||
8168 | =item Organization of Perl Images | |
954c1994 | 8169 | |
d420ca49 | 8170 | =over 4 |
a45bd81d | 8171 | |
4755096e | 8172 | =item Core Images |
c76ac1ee | 8173 | |
4755096e | 8174 | =item Perl Extensions |
954c1994 | 8175 | |
4755096e | 8176 | =item Installing static extensions |
954c1994 | 8177 | |
4755096e | 8178 | =item Installing dynamic extensions |
954c1994 GS |
8179 | |
8180 | =back | |
8181 | ||
4755096e | 8182 | =item File specifications |
954c1994 | 8183 | |
d420ca49 | 8184 | =over 4 |
954c1994 | 8185 | |
4755096e | 8186 | =item Syntax |
2e1d04bc | 8187 | |
4755096e | 8188 | =item Wildcard expansion |
954c1994 | 8189 | |
4755096e | 8190 | =item Pipes |
c76ac1ee | 8191 | |
a45bd81d GS |
8192 | =back |
8193 | ||
4755096e GS |
8194 | =item PERL5LIB and PERLLIB |
8195 | ||
8196 | =item Command line | |
d516a115 | 8197 | |
d420ca49 | 8198 | =over 4 |
a45bd81d | 8199 | |
4755096e | 8200 | =item I/O redirection and backgrounding |
d516a115 | 8201 | |
4755096e | 8202 | =item Command line switches |
d516a115 | 8203 | |
4755096e GS |
8204 | -i, -S, -u |
8205 | ||
8206 | =back | |
8207 | ||
8208 | =item Perl functions | |
8209 | ||
8210 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
8211 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
8212 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
8213 | LIST, waitpid PID,FLAGS | |
8214 | ||
8215 | =item Perl variables | |
8216 | ||
ac4dd294 | 8217 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| |
4755096e GS |
8218 | |
8219 | =item Standard modules with VMS-specific differences | |
d516a115 | 8220 | |
d420ca49 | 8221 | =over 4 |
d516a115 | 8222 | |
4755096e | 8223 | =item SDBM_File |
d516a115 JH |
8224 | |
8225 | =back | |
8226 | ||
4755096e GS |
8227 | =item Revision date |
8228 | ||
8229 | =item AUTHOR | |
8230 | ||
8231 | =back | |
8232 | ||
9a997319 JH |
8233 | =head2 perlvos, README.vos - Perl for Stratus VOS |
8234 | ||
d420ca49 | 8235 | =over 4 |
9a997319 JH |
8236 | |
8237 | =item SYNOPSIS | |
8238 | ||
d420ca49 | 8239 | =over 4 |
9a997319 | 8240 | |
12b7c5c7 JH |
8241 | =item Multiple methods to build perl for VOS |
8242 | ||
9a997319 JH |
8243 | =item Stratus POSIX Support |
8244 | ||
8245 | =back | |
8246 | ||
8247 | =item INSTALLING PERL IN VOS | |
8248 | ||
d420ca49 | 8249 | =over 4 |
9a997319 JH |
8250 | |
8251 | =item Compiling Perl 5 on VOS | |
8252 | ||
8253 | =item Installing Perl 5 on VOS | |
8254 | ||
8255 | =back | |
8256 | ||
8257 | =item USING PERL IN VOS | |
8258 | ||
d420ca49 | 8259 | =over 4 |
9a997319 | 8260 | |
a83b6f46 | 8261 | =item Unimplemented Features of Perl on VOS |
9a997319 | 8262 | |
a83b6f46 | 8263 | =item Restrictions of Perl on VOS |
9a997319 JH |
8264 | |
8265 | =back | |
8266 | ||
8267 | =item SUPPORT STATUS | |
8268 | ||
8269 | =item AUTHOR | |
8270 | ||
8271 | =item LAST UPDATE | |
8272 | ||
8273 | =back | |
8274 | ||
3ecb3787 JH |
8275 | =head2 perlwin32 - Perl under Win32 |
8276 | ||
8277 | =over 4 | |
8278 | ||
8279 | =item SYNOPSIS | |
8280 | ||
8281 | =item DESCRIPTION | |
8282 | ||
8283 | =over 4 | |
8284 | ||
8285 | =item Setting Up Perl on Win32 | |
8286 | ||
8287 | Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC | |
8288 | ||
8289 | =item Building | |
8290 | ||
8291 | =item Testing Perl on Win32 | |
8292 | ||
8293 | =item Installation of Perl on Win32 | |
8294 | ||
8295 | =item Usage Hints for Perl on Win32 | |
8296 | ||
8297 | Environment Variables, File Globbing, Using perl from the command line, | |
8298 | Building Extensions, Command-line Wildcard Expansion, Win32 Specific | |
8299 | Extensions, Running Perl Scripts, Miscellaneous Things | |
8300 | ||
8301 | =back | |
8302 | ||
8303 | =item BUGS AND CAVEATS | |
8304 | ||
8305 | =item AUTHORS | |
8306 | ||
8307 | Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy | |
8308 | E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons | |
8309 | E<lt>nick@ing-simmons.netE<gt> | |
8310 | ||
8311 | =item SEE ALSO | |
8312 | ||
8313 | =item HISTORY | |
8314 | ||
8315 | =back | |
8316 | ||
8ebc5c01 | 8317 | =head1 PRAGMA DOCUMENTATION |
cb1a09d0 | 8318 | |
c76ac1ee | 8319 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
d516a115 | 8320 | |
d420ca49 | 8321 | =over 4 |
a45bd81d | 8322 | |
d516a115 JH |
8323 | =item SYNOPSIS |
8324 | ||
8325 | =item DESCRIPTION | |
8326 | ||
8327 | method, locked | |
8328 | ||
a45bd81d GS |
8329 | =back |
8330 | ||
fb9cefb4 GS |
8331 | =head2 re - Perl pragma to alter regular expression behaviour |
8332 | ||
d420ca49 | 8333 | =over 4 |
a45bd81d GS |
8334 | |
8335 | =item SYNOPSIS | |
fb9cefb4 GS |
8336 | |
8337 | =item DESCRIPTION | |
8338 | ||
a45bd81d GS |
8339 | =back |
8340 | ||
1fdc5aa6 JH |
8341 | =head2 threadshared::shared, threads::shared - Perl extension for sharing |
8342 | data structures between threads | |
8343 | ||
8344 | =over 4 | |
8345 | ||
8346 | =item SYNOPSIS | |
8347 | ||
8348 | =item DESCRIPTION | |
8349 | ||
1fdc5aa6 JH |
8350 | =item EXPORT |
8351 | ||
cb52f95f JH |
8352 | =item FUNCTIONS |
8353 | ||
8354 | share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE, | |
8355 | cond_signal VARIABLE, cond_broadcast VARIABLE | |
1fdc5aa6 | 8356 | |
04b01f78 JH |
8357 | =item NOTES |
8358 | ||
1fdc5aa6 JH |
8359 | =item BUGS |
8360 | ||
8361 | =item AUTHOR | |
8362 | ||
8363 | =item SEE ALSO | |
8364 | ||
8365 | =back | |
8366 | ||
e61ecf27 JH |
8367 | =head2 threads - Perl extension allowing use of interpreter based threads |
8368 | from perl | |
8369 | ||
8370 | =over 4 | |
8371 | ||
8372 | =item SYNOPSIS | |
8373 | ||
8374 | =item DESCRIPTION | |
8375 | ||
fe9287c4 | 8376 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, |
07fcf8ff | 8377 | threads->self, $thread->tid |
e61ecf27 JH |
8378 | |
8379 | =item TODO | |
8380 | ||
8381 | Fix so the return value is returned when you join, Add join_all, Fix memory | |
8382 | leaks! | |
8383 | ||
8384 | =item AUTHOR and COPYRIGHT | |
8385 | ||
8386 | =item BUGS | |
8387 | ||
35bf961c JH |
8388 | creating a thread from within a thread is unsafe under win32, |
8389 | PERL_OLD_SIGNALS are not threadsafe, will not be | |
e61ecf27 JH |
8390 | |
8391 | =item SEE ALSO | |
8392 | ||
8393 | =back | |
8394 | ||
c76ac1ee GS |
8395 | =head2 attributes - get/set subroutine or variable attributes |
8396 | ||
d420ca49 | 8397 | =over 4 |
a45bd81d | 8398 | |
c76ac1ee GS |
8399 | =item SYNOPSIS |
8400 | ||
8401 | =item DESCRIPTION | |
8402 | ||
d420ca49 | 8403 | =over 4 |
c76ac1ee GS |
8404 | |
8405 | =item Built-in Attributes | |
8406 | ||
694468e3 | 8407 | locked, method, lvalue |
c76ac1ee GS |
8408 | |
8409 | =item Available Subroutines | |
8410 | ||
8411 | get, reftype | |
8412 | ||
8413 | =item Package-specific Attribute Handling | |
8414 | ||
8415 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
8416 | ||
8417 | =item Syntax of Attribute Lists | |
8418 | ||
8419 | =back | |
8420 | ||
a45bd81d GS |
8421 | =item EXPORTS |
8422 | ||
d420ca49 | 8423 | =over 4 |
a45bd81d GS |
8424 | |
8425 | =item Default exports | |
8426 | ||
8427 | =item Available exports | |
8428 | ||
8429 | =item Export tags defined | |
8430 | ||
8431 | =back | |
8432 | ||
c76ac1ee GS |
8433 | =item EXAMPLES |
8434 | ||
8435 | =item SEE ALSO | |
8436 | ||
a45bd81d GS |
8437 | =back |
8438 | ||
fa1c7b03 | 8439 | =head2 autouse - postpone load of modules until a function is used |
cb52f95f JH |
8440 | |
8441 | =over 4 | |
8442 | ||
8443 | =item SYNOPSIS | |
8444 | ||
8445 | =item DESCRIPTION | |
8446 | ||
fa1c7b03 JH |
8447 | =item WARNING |
8448 | ||
8449 | =item AUTHOR | |
8450 | ||
8451 | =item SEE ALSO | |
cb52f95f JH |
8452 | |
8453 | =back | |
8454 | ||
fa1c7b03 | 8455 | =head2 base - Establish IS-A relationship with base class at compile time |
68dc0745 | 8456 | |
d420ca49 | 8457 | =over 4 |
a45bd81d | 8458 | |
68dc0745 | 8459 | =item SYNOPSIS |
8460 | ||
8461 | =item DESCRIPTION | |
8462 | ||
fa1c7b03 | 8463 | =item HISTORY |
68dc0745 | 8464 | |
fa1c7b03 JH |
8465 | =item SEE ALSO |
8466 | ||
8467 | =back | |
8468 | ||
8469 | =head2 bigint - Transparent big integer support for Perl | |
8470 | ||
8471 | =over 4 | |
8472 | ||
8473 | =item SYNOPSIS | |
8474 | ||
8475 | =item DESCRIPTION | |
8476 | ||
8477 | =over 4 | |
8478 | ||
8479 | =item OPTIONS | |
8480 | ||
8481 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
8482 | ||
8483 | =item MATH LIBRARY | |
8484 | ||
8485 | =item INTERNAL FORMAT | |
8486 | ||
8487 | =item SIGN | |
8488 | ||
8489 | =item METHODS | |
8490 | ||
8491 | =back | |
8492 | ||
8493 | =item MODULES USED | |
8494 | ||
8495 | =item EXAMPLES | |
8496 | ||
8497 | =item LICENSE | |
68dc0745 | 8498 | |
8499 | =item SEE ALSO | |
8500 | ||
fa1c7b03 JH |
8501 | =item AUTHORS |
8502 | ||
a45bd81d GS |
8503 | =back |
8504 | ||
fa1c7b03 | 8505 | =head2 bignum - Transparent BigNumber support for Perl |
d516a115 | 8506 | |
d420ca49 | 8507 | =over 4 |
a45bd81d | 8508 | |
d516a115 JH |
8509 | =item SYNOPSIS |
8510 | ||
8511 | =item DESCRIPTION | |
8512 | ||
fa1c7b03 JH |
8513 | =over 4 |
8514 | ||
8515 | =item OPTIONS | |
8516 | ||
8517 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
8518 | ||
8519 | =item MATH LIBRARY | |
8520 | ||
8521 | =item INTERNAL FORMAT | |
8522 | ||
8523 | =item SIGN | |
8524 | ||
8525 | =item METHODS | |
8526 | ||
8527 | =back | |
8528 | ||
8529 | =item MODULES USED | |
8530 | ||
8531 | =item EXAMPLES | |
8532 | ||
8533 | =item LICENSE | |
8534 | ||
8535 | =item SEE ALSO | |
8536 | ||
8537 | =item AUTHORS | |
8538 | ||
8539 | =back | |
8540 | ||
8541 | =head2 bigrat - Transparent BigNumber/BigRational support for Perl | |
8542 | ||
8543 | =over 4 | |
8544 | ||
8545 | =item SYNOPSIS | |
8546 | ||
8547 | =item DESCRIPTION | |
8548 | ||
8549 | =over 4 | |
8550 | ||
8551 | =item MODULES USED | |
8552 | ||
8553 | =item MATH LIBRARY | |
8554 | ||
8555 | =item SIGN | |
8556 | ||
8557 | =item METHODS | |
8558 | ||
8559 | =back | |
8560 | ||
8561 | =item EXAMPLES | |
8562 | ||
8563 | perl -Mbigrat -le 'print sqrt(33)' | |
8564 | perl -Mbigrat -le 'print 2*255' | |
8565 | perl -Mbigrat -le 'print 4.5+2*255' | |
8566 | perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' | |
8567 | perl -Mbigrat -le 'print 12->is_odd()'; | |
8568 | ||
8569 | =item LICENSE | |
14218588 | 8570 | |
fb9cefb4 | 8571 | =item SEE ALSO |
d516a115 | 8572 | |
fa1c7b03 JH |
8573 | =item AUTHORS |
8574 | ||
a45bd81d GS |
8575 | =back |
8576 | ||
8ebc5c01 | 8577 | =head2 blib - Use MakeMaker's uninstalled version of a package |
cb1a09d0 | 8578 | |
d420ca49 | 8579 | =over 4 |
a45bd81d | 8580 | |
8ebc5c01 | 8581 | =item SYNOPSIS |
cb1a09d0 | 8582 | |
8ebc5c01 | 8583 | =item DESCRIPTION |
cb1a09d0 | 8584 | |
8ebc5c01 | 8585 | =item BUGS |
cb1a09d0 | 8586 | |
8ebc5c01 | 8587 | =item AUTHOR |
cb1a09d0 | 8588 | |
a45bd81d GS |
8589 | =back |
8590 | ||
694468e3 GS |
8591 | =head2 bytes - Perl pragma to force byte semantics rather than character |
8592 | semantics | |
a45bd81d | 8593 | |
d420ca49 | 8594 | =over 4 |
a45bd81d GS |
8595 | |
8596 | =item SYNOPSIS | |
8597 | ||
8598 | =item DESCRIPTION | |
8599 | ||
694468e3 | 8600 | =item SEE ALSO |
a10cf691 | 8601 | |
a45bd81d GS |
8602 | =back |
8603 | ||
c76ac1ee | 8604 | =head2 charnames - define character names for C<\N{named}> string literal |
ba62762e | 8605 | escapes. |
c76ac1ee | 8606 | |
d420ca49 | 8607 | =over 4 |
a45bd81d | 8608 | |
c76ac1ee GS |
8609 | =item SYNOPSIS |
8610 | ||
8611 | =item DESCRIPTION | |
8612 | ||
8613 | =item CUSTOM TRANSLATORS | |
8614 | ||
ba62762e JH |
8615 | =item charnames::viacode(code) |
8616 | ||
34babc16 JH |
8617 | =item charnames::vianame(code) |
8618 | ||
80637b95 JH |
8619 | =item ILLEGAL CHARACTERS |
8620 | ||
c76ac1ee GS |
8621 | =item BUGS |
8622 | ||
a45bd81d GS |
8623 | =back |
8624 | ||
54310121 | 8625 | =head2 constant - Perl pragma to declare constants |
8626 | ||
d420ca49 | 8627 | =over 4 |
a45bd81d | 8628 | |
54310121 | 8629 | =item SYNOPSIS |
8630 | ||
8631 | =item DESCRIPTION | |
8632 | ||
8633 | =item NOTES | |
8634 | ||
890a53b9 JH |
8635 | =over 4 |
8636 | ||
8637 | =item List constants | |
8638 | ||
8639 | =item Defining multiple constants at once | |
8640 | ||
8641 | =item Magic constants | |
8642 | ||
8643 | =back | |
8644 | ||
8645 | =item TECHNICAL NOTES | |
54310121 | 8646 | |
8647 | =item BUGS | |
8648 | ||
8649 | =item AUTHOR | |
8650 | ||
8651 | =item COPYRIGHT | |
8652 | ||
a45bd81d GS |
8653 | =back |
8654 | ||
8ebc5c01 | 8655 | =head2 diagnostics - Perl compiler pragma to force verbose warning |
8656 | diagnostics | |
cb1a09d0 | 8657 | |
d420ca49 | 8658 | =over 4 |
a45bd81d | 8659 | |
8ebc5c01 | 8660 | =item SYNOPSIS |
cb1a09d0 | 8661 | |
8ebc5c01 | 8662 | =item DESCRIPTION |
cb1a09d0 | 8663 | |
d420ca49 | 8664 | =over 4 |
cb1a09d0 | 8665 | |
8ebc5c01 | 8666 | =item The C<diagnostics> Pragma |
cb1a09d0 | 8667 | |
8ebc5c01 | 8668 | =item The I<splain> Program |
cb1a09d0 | 8669 | |
8ebc5c01 | 8670 | =back |
cb1a09d0 | 8671 | |
8ebc5c01 | 8672 | =item EXAMPLES |
cb1a09d0 | 8673 | |
8ebc5c01 | 8674 | =item INTERNALS |
cb1a09d0 | 8675 | |
8ebc5c01 | 8676 | =item BUGS |
cb1a09d0 | 8677 | |
8ebc5c01 | 8678 | =item AUTHOR |
cb1a09d0 | 8679 | |
a45bd81d GS |
8680 | =back |
8681 | ||
cb52f95f JH |
8682 | =head2 encoding - pragma to control the conversion of legacy data into |
8683 | Unicode | |
8684 | ||
8685 | =over 4 | |
8686 | ||
8687 | =item SYNOPSIS | |
8688 | ||
8689 | =item DESCRIPTION | |
8690 | ||
8691 | =item KNOWN PROBLEMS | |
8692 | ||
8693 | =item SEE ALSO | |
8694 | ||
8695 | =back | |
8696 | ||
d516a115 JH |
8697 | =head2 fields - compile-time class fields |
8698 | ||
d420ca49 | 8699 | =over 4 |
a45bd81d | 8700 | |
d516a115 JH |
8701 | =item SYNOPSIS |
8702 | ||
8703 | =item DESCRIPTION | |
8704 | ||
694468e3 GS |
8705 | new, phash |
8706 | ||
fb9cefb4 GS |
8707 | =item SEE ALSO |
8708 | ||
a45bd81d GS |
8709 | =back |
8710 | ||
14218588 GS |
8711 | =head2 filetest - Perl pragma to control the filetest permission operators |
8712 | ||
d420ca49 | 8713 | =over 4 |
a45bd81d | 8714 | |
14218588 GS |
8715 | =item SYNOPSIS |
8716 | ||
14218588 GS |
8717 | =item DESCRIPTION |
8718 | ||
d420ca49 | 8719 | =over 4 |
14218588 GS |
8720 | |
8721 | =item subpragma access | |
8722 | ||
8723 | =back | |
8724 | ||
a45bd81d GS |
8725 | =back |
8726 | ||
12b7c5c7 JH |
8727 | =head2 if - C<use> a Perl module if a condition holds |
8728 | ||
8729 | =over 4 | |
8730 | ||
8731 | =item SYNOPSIS | |
8732 | ||
8733 | =item DESCRIPTION | |
8734 | ||
8735 | =item BUGS | |
8736 | ||
8737 | =item AUTHOR | |
8738 | ||
8739 | =back | |
8740 | ||
4d4e713d JH |
8741 | =head2 integer - Perl pragma to use integer arithmetic instead of floating |
8742 | point | |
cb1a09d0 | 8743 | |
d420ca49 | 8744 | =over 4 |
a45bd81d | 8745 | |
8ebc5c01 | 8746 | =item SYNOPSIS |
cb1a09d0 | 8747 | |
8ebc5c01 | 8748 | =item DESCRIPTION |
cb1a09d0 | 8749 | |
a45bd81d GS |
8750 | =back |
8751 | ||
8ebc5c01 | 8752 | =head2 less - perl pragma to request less of something from the compiler |
cb1a09d0 | 8753 | |
d420ca49 | 8754 | =over 4 |
a45bd81d | 8755 | |
8ebc5c01 | 8756 | =item SYNOPSIS |
cb1a09d0 | 8757 | |
8ebc5c01 | 8758 | =item DESCRIPTION |
cb1a09d0 | 8759 | |
a45bd81d GS |
8760 | =back |
8761 | ||
8ebc5c01 | 8762 | =head2 lib - manipulate @INC at compile time |
cb1a09d0 | 8763 | |
d420ca49 | 8764 | =over 4 |
a45bd81d | 8765 | |
8ebc5c01 | 8766 | =item SYNOPSIS |
cb1a09d0 | 8767 | |
8ebc5c01 | 8768 | =item DESCRIPTION |
cb1a09d0 | 8769 | |
d420ca49 | 8770 | =over 4 |
8ebc5c01 | 8771 | |
c76ac1ee | 8772 | =item Adding directories to @INC |
cb1a09d0 | 8773 | |
c76ac1ee | 8774 | =item Deleting directories from @INC |
cb1a09d0 | 8775 | |
c76ac1ee | 8776 | =item Restoring original @INC |
cb1a09d0 | 8777 | |
8ebc5c01 | 8778 | =back |
cb1a09d0 | 8779 | |
04b01f78 JH |
8780 | =item CAVEATS |
8781 | ||
8ebc5c01 | 8782 | =item SEE ALSO |
cb1a09d0 | 8783 | |
8ebc5c01 | 8784 | =item AUTHOR |
cb1a09d0 | 8785 | |
a45bd81d GS |
8786 | =back |
8787 | ||
8ebc5c01 | 8788 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
8789 | operations | |
cb1a09d0 | 8790 | |
d420ca49 | 8791 | =over 4 |
a45bd81d | 8792 | |
8ebc5c01 | 8793 | =item SYNOPSIS |
cb1a09d0 AD |
8794 | |
8795 | =item DESCRIPTION | |
8796 | ||
a45bd81d GS |
8797 | =back |
8798 | ||
b38f6a39 GS |
8799 | =head2 open - perl pragma to set default disciplines for input and output |
8800 | ||
d420ca49 | 8801 | =over 4 |
b38f6a39 GS |
8802 | |
8803 | =item SYNOPSIS | |
8804 | ||
8805 | =item DESCRIPTION | |
8806 | ||
0d0e97a6 JH |
8807 | =item NONPERLIO FUNCTIONALITY |
8808 | ||
8809 | =item IMPLEMENTATION DETAILS | |
b38f6a39 GS |
8810 | |
8811 | =item SEE ALSO | |
8812 | ||
8813 | =back | |
8814 | ||
8ebc5c01 | 8815 | =head2 overload - Package for overloading perl operations |
cb1a09d0 | 8816 | |
d420ca49 | 8817 | =over 4 |
a45bd81d | 8818 | |
8ebc5c01 | 8819 | =item SYNOPSIS |
cb1a09d0 | 8820 | |
8ebc5c01 | 8821 | =item DESCRIPTION |
cb1a09d0 | 8822 | |
d420ca49 | 8823 | =over 4 |
cb1a09d0 | 8824 | |
8ebc5c01 | 8825 | =item Declaration of overloaded functions |
cb1a09d0 | 8826 | |
8ebc5c01 | 8827 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 8828 | |
8ebc5c01 | 8829 | FALSE, TRUE, C<undef> |
cb1a09d0 | 8830 | |
8ebc5c01 | 8831 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 8832 | |
14218588 GS |
8833 | =item Calling Conventions for Mutators |
8834 | ||
8835 | C<++> and C<-->, C<x=> and other assignment versions | |
8836 | ||
8ebc5c01 | 8837 | =item Overloadable Operations |
cb1a09d0 | 8838 | |
8ebc5c01 | 8839 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
8840 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
14218588 | 8841 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
cb1a09d0 | 8842 | |
774d564b | 8843 | =item Inheritance and overloading |
8844 | ||
8845 | Strings as values of C<use overload> directive, Overloading of an operation | |
8846 | is inherited by derived classes | |
8847 | ||
8ebc5c01 | 8848 | =back |
cb1a09d0 | 8849 | |
8ebc5c01 | 8850 | =item SPECIAL SYMBOLS FOR C<use overload> |
cb1a09d0 | 8851 | |
d420ca49 | 8852 | =over 4 |
cb1a09d0 | 8853 | |
774d564b | 8854 | =item Last Resort |
cb1a09d0 | 8855 | |
91331b4f | 8856 | =item Fallback |
cb1a09d0 | 8857 | |
8ebc5c01 | 8858 | C<undef>, TRUE, defined, but FALSE |
cb1a09d0 | 8859 | |
8ebc5c01 | 8860 | =item Copy Constructor |
cb1a09d0 | 8861 | |
8ebc5c01 | 8862 | B<Example> |
cb1a09d0 | 8863 | |
8ebc5c01 | 8864 | =back |
cb1a09d0 | 8865 | |
8ebc5c01 | 8866 | =item MAGIC AUTOGENERATION |
cb1a09d0 | 8867 | |
8ebc5c01 | 8868 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
8869 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
14218588 GS |
8870 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
8871 | I<Copy operator> | |
cb1a09d0 | 8872 | |
14218588 | 8873 | =item Losing overloading |
cb1a09d0 | 8874 | |
8ebc5c01 | 8875 | =item Run-time Overloading |
cb1a09d0 | 8876 | |
8ebc5c01 | 8877 | =item Public functions |
cb1a09d0 | 8878 | |
8ebc5c01 | 8879 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 8880 | |
fb9cefb4 GS |
8881 | =item Overloading constants |
8882 | ||
8883 | integer, float, binary, q, qr | |
8884 | ||
8ebc5c01 | 8885 | =item IMPLEMENTATION |
cb1a09d0 | 8886 | |
14218588 GS |
8887 | =item Metaphor clash |
8888 | ||
8889 | =item Cookbook | |
8890 | ||
d420ca49 | 8891 | =over 4 |
14218588 GS |
8892 | |
8893 | =item Two-face scalars | |
8894 | ||
8895 | =item Two-face references | |
8896 | ||
8897 | =item Symbolic calculator | |
8898 | ||
8899 | =item I<Really> symbolic calculator | |
8900 | ||
4755096e | 8901 | =back |
497711e7 | 8902 | |
4755096e | 8903 | =item AUTHOR |
497711e7 | 8904 | |
4755096e | 8905 | =item DIAGNOSTICS |
497711e7 | 8906 | |
93d73c42 JH |
8907 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
8908 | type, `%s' is not a code reference | |
8909 | ||
4755096e | 8910 | =item BUGS |
497711e7 GS |
8911 | |
8912 | =back | |
8913 | ||
14218588 GS |
8914 | =head2 re - Perl pragma to alter regular expression behaviour |
8915 | ||
d420ca49 | 8916 | =over 4 |
a45bd81d | 8917 | |
14218588 GS |
8918 | =item SYNOPSIS |
8919 | ||
8920 | =item DESCRIPTION | |
8921 | ||
a45bd81d GS |
8922 | =back |
8923 | ||
8ebc5c01 | 8924 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 8925 | |
d420ca49 | 8926 | =over 4 |
a45bd81d | 8927 | |
8ebc5c01 | 8928 | =item SYNOPSIS |
cb1a09d0 | 8929 | |
8ebc5c01 | 8930 | =item DESCRIPTION |
cb1a09d0 | 8931 | |
8ebc5c01 | 8932 | =item OPTIONS |
cb1a09d0 | 8933 | |
d420ca49 | 8934 | =over 4 |
cb1a09d0 | 8935 | |
8ebc5c01 | 8936 | =item SIGNAL HANDLERS |
cb1a09d0 | 8937 | |
8ebc5c01 | 8938 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
cb1a09d0 | 8939 | |
8ebc5c01 | 8940 | =item SIGNAL LISTS |
cb1a09d0 | 8941 | |
8ebc5c01 | 8942 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
cb1a09d0 | 8943 | |
8ebc5c01 | 8944 | =item OTHER |
cb1a09d0 | 8945 | |
8ebc5c01 | 8946 | B<untrapped>, B<any>, I<signal>, I<number> |
cb1a09d0 | 8947 | |
8ebc5c01 | 8948 | =back |
cb1a09d0 | 8949 | |
8ebc5c01 | 8950 | =item EXAMPLES |
cb1a09d0 | 8951 | |
a45bd81d GS |
8952 | =back |
8953 | ||
428dc699 JH |
8954 | =head2 sort - perl pragma to control sort() behaviour |
8955 | ||
8956 | =over 4 | |
8957 | ||
8958 | =item SYNOPSIS | |
8959 | ||
8960 | =item DESCRIPTION | |
8961 | ||
8962 | =back | |
8963 | ||
8ebc5c01 | 8964 | =head2 strict - Perl pragma to restrict unsafe constructs |
cb1a09d0 | 8965 | |
d420ca49 | 8966 | =over 4 |
a45bd81d | 8967 | |
8ebc5c01 | 8968 | =item SYNOPSIS |
cb1a09d0 | 8969 | |
8ebc5c01 | 8970 | =item DESCRIPTION |
cb1a09d0 | 8971 | |
8ebc5c01 | 8972 | C<strict refs>, C<strict vars>, C<strict subs> |
cb1a09d0 | 8973 | |
a45bd81d GS |
8974 | =back |
8975 | ||
8ebc5c01 | 8976 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 | 8977 | |
d420ca49 | 8978 | =over 4 |
a45bd81d | 8979 | |
cb1a09d0 AD |
8980 | =item SYNOPSIS |
8981 | ||
cb1a09d0 AD |
8982 | =item DESCRIPTION |
8983 | ||
a45bd81d GS |
8984 | =back |
8985 | ||
bd28ded5 JH |
8986 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source |
8987 | code | |
14218588 | 8988 | |
d420ca49 | 8989 | =over 4 |
a45bd81d | 8990 | |
14218588 GS |
8991 | =item SYNOPSIS |
8992 | ||
8993 | =item DESCRIPTION | |
8994 | ||
4d4e713d JH |
8995 | =over 4 |
8996 | ||
8997 | =item Utility functions | |
8998 | ||
8999 | $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), | |
b2deec1d JH |
9000 | utf8::encode($string), $flag = utf8::decode($string), $flag = |
9001 | utf8::valid(STRING) | |
4d4e713d JH |
9002 | |
9003 | =back | |
9004 | ||
694468e3 | 9005 | =item SEE ALSO |
14218588 | 9006 | |
a45bd81d GS |
9007 | =back |
9008 | ||
9009 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) | |
9010 | ||
d420ca49 | 9011 | =over 4 |
cb1a09d0 | 9012 | |
8ebc5c01 | 9013 | =item SYNOPSIS |
cb1a09d0 | 9014 | |
8ebc5c01 | 9015 | =item DESCRIPTION |
cb1a09d0 | 9016 | |
a45bd81d GS |
9017 | =back |
9018 | ||
ba62762e JH |
9019 | =head2 vmsish - Perl pragma to control VMS-specific language features |
9020 | ||
9021 | =over 4 | |
9022 | ||
9023 | =item SYNOPSIS | |
9024 | ||
9025 | =item DESCRIPTION | |
9026 | ||
9027 | C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> | |
9028 | ||
9029 | =back | |
9030 | ||
4438c4b7 | 9031 | =head2 warnings - Perl pragma to control optional warnings |
14218588 | 9032 | |
d420ca49 | 9033 | =over 4 |
a45bd81d | 9034 | |
14218588 GS |
9035 | =item SYNOPSIS |
9036 | ||
9037 | =item DESCRIPTION | |
9038 | ||
a9ef4385 JH |
9039 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
9040 | warnings::enabled($object), warnings::warn($message), | |
9041 | warnings::warn($category, $message), warnings::warn($object, $message), | |
9042 | warnings::warnif($message), warnings::warnif($category, $message), | |
9043 | warnings::warnif($object, $message) | |
694468e3 | 9044 | |
a45bd81d GS |
9045 | =back |
9046 | ||
4755096e GS |
9047 | =head2 warnings::register - warnings import function |
9048 | ||
890a53b9 JH |
9049 | =over 4 |
9050 | ||
9051 | =item SYNOPSIS | |
9052 | ||
9053 | =item DESCRIPTION | |
9054 | ||
9055 | =back | |
9056 | ||
8ebc5c01 | 9057 | =head1 MODULE DOCUMENTATION |
cb1a09d0 | 9058 | |
8ebc5c01 | 9059 | =head2 AnyDBM_File - provide framework for multiple DBMs |
cb1a09d0 | 9060 | |
d420ca49 | 9061 | =over 4 |
a45bd81d | 9062 | |
cb1a09d0 AD |
9063 | =item SYNOPSIS |
9064 | ||
cb1a09d0 AD |
9065 | =item DESCRIPTION |
9066 | ||
d420ca49 | 9067 | =over 4 |
cb1a09d0 | 9068 | |
8ebc5c01 | 9069 | =item DBM Comparisons |
cb1a09d0 | 9070 | |
8ebc5c01 | 9071 | [0], [1], [2], [3] |
cb1a09d0 | 9072 | |
8ebc5c01 | 9073 | =back |
cb1a09d0 | 9074 | |
8ebc5c01 | 9075 | =item SEE ALSO |
cb1a09d0 | 9076 | |
a45bd81d GS |
9077 | =back |
9078 | ||
0e9b9e0c JH |
9079 | =head2 Attribute::Handlers - Simpler definition of attribute handlers |
9080 | ||
9081 | =over 4 | |
9082 | ||
9083 | =item VERSION | |
9084 | ||
9085 | =item SYNOPSIS | |
9086 | ||
9087 | =item DESCRIPTION | |
9088 | ||
9089 | [0], [1], [2], [3], [4], [5] | |
9090 | ||
9091 | =over 4 | |
9092 | ||
9093 | =item Typed lexicals | |
9094 | ||
9095 | =item Type-specific attribute handlers | |
9096 | ||
9097 | =item Non-interpretive attribute handlers | |
9098 | ||
9099 | =item Phase-specific attribute handlers | |
9100 | ||
9101 | =item Attributes as C<tie> interfaces | |
9102 | ||
9103 | =back | |
9104 | ||
9105 | =item EXAMPLES | |
9106 | ||
9107 | =item DIAGNOSTICS | |
9108 | ||
9109 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s | |
9110 | attributes>, C<Declaration of %s attribute in package %s may clash with | |
9111 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, | |
fe9287c4 JH |
9112 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't |
9113 | be able to apply END handler> | |
0e9b9e0c JH |
9114 | |
9115 | =item AUTHOR | |
9116 | ||
9117 | =item BUGS | |
9118 | ||
9119 | =item COPYRIGHT | |
9120 | ||
9121 | =back | |
9122 | ||
4a6725af | 9123 | =head2 AutoLoader - load subroutines only on demand |
cb1a09d0 | 9124 | |
d420ca49 | 9125 | =over 4 |
a45bd81d | 9126 | |
8ebc5c01 | 9127 | =item SYNOPSIS |
cb1a09d0 | 9128 | |
8ebc5c01 | 9129 | =item DESCRIPTION |
cb1a09d0 | 9130 | |
d420ca49 | 9131 | =over 4 |
cb1a09d0 | 9132 | |
4a6725af NT |
9133 | =item Subroutine Stubs |
9134 | ||
9135 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
cb1a09d0 | 9136 | |
4a6725af | 9137 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
cb1a09d0 | 9138 | |
8ebc5c01 | 9139 | =item Package Lexicals |
cb1a09d0 | 9140 | |
7029d033 JH |
9141 | =item Not Using AutoLoader |
9142 | ||
4a6725af | 9143 | =item B<AutoLoader> vs. B<SelfLoader> |
cb1a09d0 | 9144 | |
8ebc5c01 | 9145 | =back |
cb1a09d0 | 9146 | |
4a6725af NT |
9147 | =item CAVEATS |
9148 | ||
9149 | =item SEE ALSO | |
cb1a09d0 | 9150 | |
a45bd81d GS |
9151 | =back |
9152 | ||
8ebc5c01 | 9153 | =head2 AutoSplit - split a package for autoloading |
cb1a09d0 | 9154 | |
d420ca49 | 9155 | =over 4 |
a45bd81d | 9156 | |
8ebc5c01 | 9157 | =item SYNOPSIS |
cb1a09d0 | 9158 | |
8ebc5c01 | 9159 | =item DESCRIPTION |
cb1a09d0 | 9160 | |
193fb0af GS |
9161 | $keep, $check, $modtime |
9162 | ||
d420ca49 | 9163 | =over 4 |
193fb0af GS |
9164 | |
9165 | =item Multiple packages | |
9166 | ||
9167 | =back | |
cb1a09d0 | 9168 | |
8ebc5c01 | 9169 | =item DIAGNOSTICS |
cb1a09d0 | 9170 | |
a45bd81d GS |
9171 | =back |
9172 | ||
fb9cefb4 | 9173 | =head2 B - The Perl Compiler |
193fb0af | 9174 | |
d420ca49 | 9175 | =over 4 |
a45bd81d | 9176 | |
193fb0af GS |
9177 | =item SYNOPSIS |
9178 | ||
9179 | =item DESCRIPTION | |
9180 | ||
fb9cefb4 | 9181 | =item OVERVIEW OF CLASSES |
193fb0af | 9182 | |
d420ca49 | 9183 | =over 4 |
193fb0af | 9184 | |
fb9cefb4 | 9185 | =item SV-RELATED CLASSES |
193fb0af | 9186 | |
fb9cefb4 | 9187 | =item B::SV METHODS |
193fb0af | 9188 | |
fb9cefb4 | 9189 | REFCNT, FLAGS |
193fb0af | 9190 | |
fb9cefb4 | 9191 | =item B::IV METHODS |
193fb0af | 9192 | |
e42c74e1 | 9193 | IV, IVX, UVX, int_value, needs64bits, packiv |
193fb0af | 9194 | |
fb9cefb4 | 9195 | =item B::NV METHODS |
193fb0af | 9196 | |
fb9cefb4 | 9197 | NV, NVX |
193fb0af | 9198 | |
fb9cefb4 | 9199 | =item B::RV METHODS |
193fb0af | 9200 | |
fb9cefb4 | 9201 | RV |
193fb0af | 9202 | |
fb9cefb4 | 9203 | =item B::PV METHODS |
193fb0af | 9204 | |
f502af34 | 9205 | PV, RV, PVX |
193fb0af | 9206 | |
fb9cefb4 | 9207 | =item B::PVMG METHODS |
cb1a09d0 | 9208 | |
fb9cefb4 | 9209 | MAGIC, SvSTASH |
cb1a09d0 | 9210 | |
fb9cefb4 | 9211 | =item B::MAGIC METHODS |
cb1a09d0 | 9212 | |
f502af34 | 9213 | MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX |
cb1a09d0 | 9214 | |
fb9cefb4 | 9215 | =item B::PVLV METHODS |
cb1a09d0 | 9216 | |
fb9cefb4 | 9217 | TARGOFF, TARGLEN, TYPE, TARG |
cb1a09d0 | 9218 | |
fb9cefb4 | 9219 | =item B::BM METHODS |
cb1a09d0 | 9220 | |
fb9cefb4 | 9221 | USEFUL, PREVIOUS, RARE, TABLE |
cb1a09d0 | 9222 | |
fb9cefb4 | 9223 | =item B::GV METHODS |
cb1a09d0 | 9224 | |
e42c74e1 JH |
9225 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, |
9226 | LINE, FILE, FILEGV, GvREFCNT, FLAGS | |
54310121 | 9227 | |
fb9cefb4 | 9228 | =item B::IO METHODS |
cb1a09d0 | 9229 | |
fb9cefb4 | 9230 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
f502af34 | 9231 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD |
cb1a09d0 | 9232 | |
fb9cefb4 | 9233 | =item B::AV METHODS |
cb1a09d0 | 9234 | |
fb9cefb4 | 9235 | FILL, MAX, OFF, ARRAY, AvFLAGS |
cb1a09d0 | 9236 | |
fb9cefb4 | 9237 | =item B::CV METHODS |
cb1a09d0 | 9238 | |
a45bd81d | 9239 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY, |
a7ffa9b9 | 9240 | CvFLAGS, const_sv |
cb1a09d0 | 9241 | |
fb9cefb4 | 9242 | =item B::HV METHODS |
f86702cc | 9243 | |
fb9cefb4 | 9244 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
f86702cc | 9245 | |
fb9cefb4 | 9246 | =item OP-RELATED CLASSES |
f86702cc | 9247 | |
fb9cefb4 | 9248 | =item B::OP METHODS |
f86702cc | 9249 | |
c76ac1ee | 9250 | next, sibling, name, ppaddr, desc, targ, type, seq, flags, private |
f86702cc | 9251 | |
fb9cefb4 | 9252 | =item B::UNOP METHOD |
54310121 | 9253 | |
fb9cefb4 | 9254 | first |
dc848c6f | 9255 | |
fb9cefb4 | 9256 | =item B::BINOP METHOD |
54310121 | 9257 | |
fb9cefb4 | 9258 | last |
54310121 | 9259 | |
fb9cefb4 | 9260 | =item B::LOGOP METHOD |
54310121 | 9261 | |
fb9cefb4 | 9262 | other |
54310121 | 9263 | |
fb9cefb4 | 9264 | =item B::LISTOP METHOD |
54310121 | 9265 | |
fb9cefb4 | 9266 | children |
54310121 | 9267 | |
fb9cefb4 | 9268 | =item B::PMOP METHODS |
54310121 | 9269 | |
f502af34 JH |
9270 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, |
9271 | pmpermflags, precomp, pmoffet | |
54310121 | 9272 | |
fb9cefb4 | 9273 | =item B::SVOP METHOD |
54310121 | 9274 | |
a45bd81d | 9275 | sv, gv |
54310121 | 9276 | |
a45bd81d | 9277 | =item B::PADOP METHOD |
54310121 | 9278 | |
a45bd81d | 9279 | padix |
54310121 | 9280 | |
fb9cefb4 | 9281 | =item B::PVOP METHOD |
54310121 | 9282 | |
fb9cefb4 | 9283 | pv |
54310121 | 9284 | |
fb9cefb4 | 9285 | =item B::LOOP METHODS |
54310121 | 9286 | |
fb9cefb4 | 9287 | redoop, nextop, lastop |
54310121 | 9288 | |
fb9cefb4 | 9289 | =item B::COP METHODS |
54310121 | 9290 | |
a45bd81d | 9291 | label, stash, file, cop_seq, arybase, line |
54310121 | 9292 | |
fb9cefb4 | 9293 | =back |
54310121 | 9294 | |
fb9cefb4 | 9295 | =item FUNCTIONS EXPORTED BY C<B> |
54310121 | 9296 | |
f502af34 JH |
9297 | main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist, |
9298 | regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP, | |
9299 | METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE, | |
9300 | PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c, | |
b2deec1d | 9301 | cstring(STR), perlstring(STR), class(OBJ), threadsv_names |
54310121 | 9302 | |
fb9cefb4 | 9303 | =item AUTHOR |
54310121 | 9304 | |
a45bd81d GS |
9305 | =back |
9306 | ||
fb9cefb4 GS |
9307 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
9308 | bytecode | |
54310121 | 9309 | |
d420ca49 | 9310 | =over 4 |
a45bd81d | 9311 | |
fb9cefb4 | 9312 | =item SYNOPSIS |
54310121 | 9313 | |
fb9cefb4 | 9314 | =item DESCRIPTION |
54310121 | 9315 | |
80637b95 JH |
9316 | %insn_data, @insn_name, @optype, @specialsv_name |
9317 | ||
fb9cefb4 | 9318 | =item AUTHOR |
54310121 | 9319 | |
a45bd81d GS |
9320 | =back |
9321 | ||
fb9cefb4 | 9322 | =head2 B::Assembler - Assemble Perl bytecode |
54310121 | 9323 | |
d420ca49 | 9324 | =over 4 |
a45bd81d | 9325 | |
fb9cefb4 | 9326 | =item SYNOPSIS |
54310121 | 9327 | |
fb9cefb4 | 9328 | =item DESCRIPTION |
54310121 | 9329 | |
a9ef4385 | 9330 | =item AUTHORS |
54310121 | 9331 | |
a45bd81d GS |
9332 | =back |
9333 | ||
fb9cefb4 | 9334 | =head2 B::Bblock - Walk basic blocks |
54310121 | 9335 | |
d420ca49 | 9336 | =over 4 |
a45bd81d | 9337 | |
fb9cefb4 | 9338 | =item SYNOPSIS |
54310121 | 9339 | |
fb9cefb4 | 9340 | =item DESCRIPTION |
54310121 | 9341 | |
80637b95 JH |
9342 | =over 4 |
9343 | ||
9344 | =item Functions | |
9345 | ||
9346 | B<find_leaders> | |
9347 | ||
9348 | =back | |
9349 | ||
fb9cefb4 | 9350 | =item AUTHOR |
54310121 | 9351 | |
a45bd81d GS |
9352 | =back |
9353 | ||
fb9cefb4 | 9354 | =head2 B::Bytecode - Perl compiler's bytecode backend |
54310121 | 9355 | |
d420ca49 | 9356 | =over 4 |
a45bd81d | 9357 | |
fb9cefb4 | 9358 | =item SYNOPSIS |
54310121 | 9359 | |
fb9cefb4 GS |
9360 | =item DESCRIPTION |
9361 | ||
9362 | =item OPTIONS | |
9363 | ||
a45bd81d | 9364 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, |
a9ef4385 | 9365 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, |
4d4e713d | 9366 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> |
fb9cefb4 | 9367 | |
14218588 GS |
9368 | =item EXAMPLES |
9369 | ||
fb9cefb4 GS |
9370 | =item BUGS |
9371 | ||
a9ef4385 | 9372 | =item AUTHORS |
fb9cefb4 | 9373 | |
a45bd81d GS |
9374 | =back |
9375 | ||
fb9cefb4 GS |
9376 | =head2 B::C - Perl compiler's C backend |
9377 | ||
d420ca49 | 9378 | =over 4 |
a45bd81d | 9379 | |
fb9cefb4 GS |
9380 | =item SYNOPSIS |
9381 | ||
9382 | =item DESCRIPTION | |
9383 | ||
9384 | =item OPTIONS | |
9385 | ||
9386 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
04b01f78 | 9387 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, |
f502af34 JH |
9388 | B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, |
9389 | B<-llimit> | |
fb9cefb4 GS |
9390 | |
9391 | =item EXAMPLES | |
9392 | ||
9393 | =item BUGS | |
9394 | ||
9395 | =item AUTHOR | |
9396 | ||
a45bd81d GS |
9397 | =back |
9398 | ||
fb9cefb4 GS |
9399 | =head2 B::CC - Perl compiler's optimized C translation backend |
9400 | ||
d420ca49 | 9401 | =over 4 |
a45bd81d | 9402 | |
fb9cefb4 GS |
9403 | =item SYNOPSIS |
9404 | ||
9405 | =item DESCRIPTION | |
9406 | ||
9407 | =item OPTIONS | |
9408 | ||
9409 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
9410 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
9411 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
9412 | ||
9413 | =item EXAMPLES | |
9414 | ||
9415 | =item BUGS | |
9416 | ||
9417 | =item DIFFERENCES | |
9418 | ||
d420ca49 | 9419 | =over 4 |
fb9cefb4 GS |
9420 | |
9421 | =item Loops | |
9422 | ||
9423 | =item Context of ".." | |
9424 | ||
9425 | =item Arithmetic | |
9426 | ||
9427 | =item Deprecated features | |
9428 | ||
9429 | =back | |
9430 | ||
9431 | =item AUTHOR | |
9432 | ||
a45bd81d GS |
9433 | =back |
9434 | ||
76d3c696 JH |
9435 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops |
9436 | ||
9437 | =over 4 | |
9438 | ||
9439 | =item SYNOPSIS | |
9440 | ||
9441 | =item DESCRIPTION | |
9442 | ||
ff426ff2 JH |
9443 | =item EXAMPLE |
9444 | ||
76d3c696 JH |
9445 | =item OPTIONS |
9446 | ||
9447 | B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, | |
9448 | B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>, | |
9449 | B<-terse>, B<-linenoise>, B<-debug>, B<-env> | |
9450 | ||
9451 | =item FORMATTING SPECIFICATIONS | |
9452 | ||
9453 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, | |
9454 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, | |
9455 | B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>, | |
ff426ff2 JH |
9456 | B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, |
9457 | B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, | |
76d3c696 JH |
9458 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, |
9459 | B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, | |
9460 | B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> | |
9461 | ||
9462 | =item ABBREVIATIONS | |
9463 | ||
9464 | =over 4 | |
9465 | ||
9466 | =item OP flags abbreviations | |
9467 | ||
9468 | =item OP class abbreviations | |
9469 | ||
9470 | =back | |
9471 | ||
1fa7ca25 JH |
9472 | =item Using B::Concise outside of the O framework |
9473 | ||
76d3c696 JH |
9474 | =item AUTHOR |
9475 | ||
9476 | =back | |
9477 | ||
fb9cefb4 GS |
9478 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops |
9479 | ||
d420ca49 | 9480 | =over 4 |
a45bd81d | 9481 | |
fb9cefb4 GS |
9482 | =item SYNOPSIS |
9483 | ||
9484 | =item DESCRIPTION | |
9485 | ||
9486 | =item AUTHOR | |
9487 | ||
a45bd81d GS |
9488 | =back |
9489 | ||
fb9cefb4 GS |
9490 | =head2 B::Deparse - Perl compiler backend to produce perl code |
9491 | ||
d420ca49 | 9492 | =over 4 |
a45bd81d | 9493 | |
fb9cefb4 GS |
9494 | =item SYNOPSIS |
9495 | ||
9496 | =item DESCRIPTION | |
9497 | ||
9498 | =item OPTIONS | |
9499 | ||
fe9287c4 JH |
9500 | B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, |
9501 | B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> | |
c76ac1ee GS |
9502 | |
9503 | =item USING B::Deparse AS A MODULE | |
9504 | ||
d420ca49 | 9505 | =over 4 |
c76ac1ee GS |
9506 | |
9507 | =item Synopsis | |
9508 | ||
9509 | =item Description | |
9510 | ||
9511 | =item new | |
9512 | ||
d2f2ce36 JH |
9513 | =item ambient_pragmas |
9514 | ||
9515 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits | |
9516 | ||
c76ac1ee GS |
9517 | =item coderef2text |
9518 | ||
9519 | =back | |
fb9cefb4 GS |
9520 | |
9521 | =item BUGS | |
9522 | ||
9523 | =item AUTHOR | |
9524 | ||
a45bd81d GS |
9525 | =back |
9526 | ||
fb9cefb4 GS |
9527 | =head2 B::Disassembler - Disassemble Perl bytecode |
9528 | ||
d420ca49 | 9529 | =over 4 |
a45bd81d | 9530 | |
fb9cefb4 GS |
9531 | =item SYNOPSIS |
9532 | ||
9533 | =item DESCRIPTION | |
9534 | ||
9535 | =item AUTHOR | |
9536 | ||
a45bd81d GS |
9537 | =back |
9538 | ||
fb9cefb4 GS |
9539 | =head2 B::Lint - Perl lint |
9540 | ||
d420ca49 | 9541 | =over 4 |
a45bd81d | 9542 | |
fb9cefb4 GS |
9543 | =item SYNOPSIS |
9544 | ||
9545 | =item DESCRIPTION | |
9546 | ||
9547 | =item OPTIONS AND LINT CHECKS | |
9548 | ||
9549 | B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>, | |
9550 | B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> | |
9551 | ||
9552 | =item NON LINT-CHECK OPTIONS | |
9553 | ||
9554 | B<-u Package> | |
9555 | ||
9556 | =item BUGS | |
9557 | ||
9558 | =item AUTHOR | |
9559 | ||
a45bd81d GS |
9560 | =back |
9561 | ||
fb9cefb4 GS |
9562 | =head2 B::O, O - Generic interface to Perl Compiler backends |
9563 | ||
d420ca49 | 9564 | =over 4 |
a45bd81d | 9565 | |
fb9cefb4 GS |
9566 | =item SYNOPSIS |
9567 | ||
9568 | =item DESCRIPTION | |
9569 | ||
9570 | =item CONVENTIONS | |
9571 | ||
9572 | =item IMPLEMENTATION | |
9573 | ||
9574 | =item AUTHOR | |
9575 | ||
a45bd81d GS |
9576 | =back |
9577 | ||
fb9cefb4 GS |
9578 | =head2 B::Showlex - Show lexical variables used in functions or files |
9579 | ||
d420ca49 | 9580 | =over 4 |
a45bd81d | 9581 | |
fb9cefb4 GS |
9582 | =item SYNOPSIS |
9583 | ||
9584 | =item DESCRIPTION | |
9585 | ||
9586 | =item AUTHOR | |
9587 | ||
a45bd81d GS |
9588 | =back |
9589 | ||
fb9cefb4 GS |
9590 | =head2 B::Stackobj - Helper module for CC backend |
9591 | ||
d420ca49 | 9592 | =over 4 |
a45bd81d | 9593 | |
fb9cefb4 GS |
9594 | =item SYNOPSIS |
9595 | ||
9596 | =item DESCRIPTION | |
9597 | ||
9598 | =item AUTHOR | |
9599 | ||
a45bd81d GS |
9600 | =back |
9601 | ||
4755096e GS |
9602 | =head2 B::Stash - show what stashes are loaded |
9603 | ||
fb9cefb4 GS |
9604 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops |
9605 | ||
d420ca49 | 9606 | =over 4 |
a45bd81d | 9607 | |
fb9cefb4 GS |
9608 | =item SYNOPSIS |
9609 | ||
9610 | =item DESCRIPTION | |
9611 | ||
9612 | =item AUTHOR | |
9613 | ||
a45bd81d GS |
9614 | =back |
9615 | ||
fb9cefb4 GS |
9616 | =head2 B::Xref - Generates cross reference reports for Perl programs |
9617 | ||
d420ca49 | 9618 | =over 4 |
a45bd81d | 9619 | |
fb9cefb4 GS |
9620 | =item SYNOPSIS |
9621 | ||
9622 | =item DESCRIPTION | |
9623 | ||
9624 | =item OPTIONS | |
9625 | ||
b2deec1d | 9626 | C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> |
fb9cefb4 GS |
9627 | |
9628 | =item BUGS | |
9629 | ||
9630 | =item AUTHOR | |
9631 | ||
a45bd81d GS |
9632 | =back |
9633 | ||
a45bd81d GS |
9634 | =head2 Benchmark - benchmark running times of Perl code |
9635 | ||
d420ca49 | 9636 | =over 4 |
fb9cefb4 GS |
9637 | |
9638 | =item SYNOPSIS | |
9639 | ||
9640 | =item DESCRIPTION | |
9641 | ||
d420ca49 | 9642 | =over 4 |
fb9cefb4 GS |
9643 | |
9644 | =item Methods | |
9645 | ||
c76ac1ee | 9646 | new, debug, iters |
fb9cefb4 GS |
9647 | |
9648 | =item Standard Exports | |
9649 | ||
9650 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
c76ac1ee GS |
9651 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( |
9652 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
fb9cefb4 GS |
9653 | |
9654 | =item Optional Exports | |
9655 | ||
c76ac1ee | 9656 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [ |
ba62762e JH |
9657 | STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), |
9658 | disablecache ( ), enablecache ( ), timesum ( T1, T2 ) | |
fb9cefb4 GS |
9659 | |
9660 | =back | |
9661 | ||
9662 | =item NOTES | |
9663 | ||
a45bd81d GS |
9664 | =item EXAMPLES |
9665 | ||
fb9cefb4 GS |
9666 | =item INHERITANCE |
9667 | ||
9668 | =item CAVEATS | |
9669 | ||
a45bd81d GS |
9670 | =item SEE ALSO |
9671 | ||
fb9cefb4 GS |
9672 | =item AUTHORS |
9673 | ||
9674 | =item MODIFICATION HISTORY | |
9675 | ||
a45bd81d GS |
9676 | =back |
9677 | ||
14218588 GS |
9678 | =head2 ByteLoader - load byte compiled perl code |
9679 | ||
d420ca49 | 9680 | =over 4 |
a45bd81d | 9681 | |
14218588 GS |
9682 | =item SYNOPSIS |
9683 | ||
9684 | =item DESCRIPTION | |
9685 | ||
9686 | =item AUTHOR | |
9687 | ||
9688 | =item SEE ALSO | |
9689 | ||
a45bd81d GS |
9690 | =back |
9691 | ||
fb9cefb4 GS |
9692 | =head2 CGI - Simple Common Gateway Interface Class |
9693 | ||
d420ca49 | 9694 | =over 4 |
a45bd81d | 9695 | |
fb9cefb4 GS |
9696 | =item SYNOPSIS |
9697 | ||
9698 | =item ABSTRACT | |
9699 | ||
9700 | =item DESCRIPTION | |
9701 | ||
d420ca49 | 9702 | =over 4 |
fb9cefb4 GS |
9703 | |
9704 | =item PROGRAMMING STYLE | |
9705 | ||
9706 | =item CALLING CGI.PM ROUTINES | |
9707 | ||
fb9cefb4 GS |
9708 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): |
9709 | ||
9710 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
9711 | ||
9712 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
9713 | ||
9714 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
9715 | ||
9716 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
9717 | ||
9718 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
9719 | ||
9720 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
9721 | ||
9722 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
9723 | ||
9724 | =item DELETING A PARAMETER COMPLETELY: | |
9725 | ||
9726 | =item DELETING ALL PARAMETERS: | |
9727 | ||
9728 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
9729 | ||
a10cf691 GS |
9730 | =item FETCHING THE PARAMETER LIST AS A HASH: |
9731 | ||
fb9cefb4 GS |
9732 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
9733 | ||
a10cf691 GS |
9734 | =item RETRIEVING CGI ERRORS |
9735 | ||
fb9cefb4 GS |
9736 | =item USING THE FUNCTION-ORIENTED INTERFACE |
9737 | ||
f502af34 | 9738 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, |
fb9cefb4 GS |
9739 | B<:standard>, B<:all> |
9740 | ||
9741 | =item PRAGMAS | |
9742 | ||
bd28ded5 JH |
9743 | -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, |
9744 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, | |
9745 | -private_tempfiles | |
fb9cefb4 | 9746 | |
14218588 GS |
9747 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
9748 | ||
f502af34 JH |
9749 | 1. start_table() (generates a <table> tag), 2. end_table() (generates a |
9750 | </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates | |
9751 | a </ul> tag) | |
14218588 GS |
9752 | |
9753 | =back | |
fb9cefb4 GS |
9754 | |
9755 | =item GENERATING DYNAMIC DOCUMENTS | |
9756 | ||
d420ca49 | 9757 | =over 4 |
fb9cefb4 GS |
9758 | |
9759 | =item CREATING A STANDARD HTTP HEADER: | |
9760 | ||
9761 | =item GENERATING A REDIRECTION HEADER | |
9762 | ||
9763 | =item CREATING THE HTML DOCUMENT HEADER | |
9764 | ||
9765 | B<Parameters:>, 4, 5, 6.. | |
9766 | ||
9767 | =item ENDING THE HTML DOCUMENT: | |
9768 | ||
9769 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
9770 | ||
9771 | =item OBTAINING THE SCRIPT'S URL | |
9772 | ||
9773 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
37d4d706 | 9774 | (B<-query_string>), B<-base> |
fb9cefb4 | 9775 | |
14218588 GS |
9776 | =item MIXING POST AND URL PARAMETERS |
9777 | ||
fb9cefb4 GS |
9778 | =back |
9779 | ||
9780 | =item CREATING STANDARD HTML ELEMENTS: | |
9781 | ||
d420ca49 | 9782 | =over 4 |
fb9cefb4 GS |
9783 | |
9784 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
9785 | ||
9786 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
9787 | ||
9788 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
9789 | ||
9790 | =item NON-STANDARD HTML SHORTCUTS | |
9791 | ||
d722968f JH |
9792 | =item AUTOESCAPING HTML |
9793 | ||
9794 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
9795 | charset([$charset]);, $flag = autoEscape([$flag]); | |
9796 | ||
14218588 GS |
9797 | =item PRETTY-PRINTING HTML |
9798 | ||
fb9cefb4 GS |
9799 | =back |
9800 | ||
9801 | =item CREATING FILL-OUT FORMS: | |
9802 | ||
d420ca49 | 9803 | =over 4 |
fb9cefb4 GS |
9804 | |
9805 | =item CREATING AN ISINDEX TAG | |
9806 | ||
9807 | =item STARTING AND ENDING A FORM | |
9808 | ||
9809 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
9810 | ||
9811 | =item CREATING A TEXT FIELD | |
9812 | ||
9813 | B<Parameters> | |
9814 | ||
9815 | =item CREATING A BIG TEXT FIELD | |
9816 | ||
9817 | =item CREATING A PASSWORD FIELD | |
9818 | ||
9819 | =item CREATING A FILE UPLOAD FIELD | |
9820 | ||
9821 | B<Parameters> | |
9822 | ||
9823 | =item CREATING A POPUP MENU | |
9824 | ||
9825 | =item CREATING A SCROLLING LIST | |
9826 | ||
9827 | B<Parameters:> | |
9828 | ||
9829 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
54310121 | 9830 | |
9831 | B<Parameters:> | |
9832 | ||
9833 | =item CREATING A STANDALONE CHECKBOX | |
9834 | ||
9835 | B<Parameters:> | |
9836 | ||
9837 | =item CREATING A RADIO BUTTON GROUP | |
9838 | ||
9839 | B<Parameters:> | |
9840 | ||
9841 | =item CREATING A SUBMIT BUTTON | |
9842 | ||
9843 | B<Parameters:> | |
9844 | ||
9845 | =item CREATING A RESET BUTTON | |
9846 | ||
9847 | =item CREATING A DEFAULT BUTTON | |
9848 | ||
9849 | =item CREATING A HIDDEN FIELD | |
9850 | ||
9851 | B<Parameters:> | |
9852 | ||
9853 | =item CREATING A CLICKABLE IMAGE BUTTON | |
9854 | ||
ff426ff2 | 9855 | B<Parameters:> |
54310121 | 9856 | |
9857 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
9858 | ||
9859 | =back | |
9860 | ||
14218588 | 9861 | =item HTTP COOKIES |
54310121 | 9862 | |
9863 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
9864 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
9865 | ||
14218588 | 9866 | =item WORKING WITH FRAMES |
54310121 | 9867 | |
9868 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
9869 | document in the HTTP header, 3. Specify the destination for the document in | |
f502af34 | 9870 | the <form> tag |
54310121 | 9871 | |
c90c0ff4 | 9872 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
9873 | ||
54310121 | 9874 | =item DEBUGGING |
9875 | ||
d420ca49 | 9876 | =over 4 |
54310121 | 9877 | |
9878 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
9879 | ||
9880 | =back | |
9881 | ||
9882 | =item FETCHING ENVIRONMENT VARIABLES | |
9883 | ||
14218588 | 9884 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
ff426ff2 JH |
9885 | B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>, |
9886 | B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, | |
37d4d706 JH |
9887 | B<server_software ()>, B<remote_user ()>, B<user_name ()>, |
9888 | B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
54310121 | 9889 | |
fb9cefb4 | 9890 | =item USING NPH SCRIPTS |
54310121 | 9891 | |
fb9cefb4 | 9892 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
ab648d5e | 9893 | parameters |
54310121 | 9894 | |
fb9cefb4 | 9895 | =item Server Push |
54310121 | 9896 | |
2d967e39 | 9897 | multipart_init(), multipart_start(), multipart_end(), multipart_final() |
54310121 | 9898 | |
fb9cefb4 | 9899 | =item Avoiding Denial of Service Attacks |
54310121 | 9900 | |
fb9cefb4 GS |
9901 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
9902 | basis>, B<2. Globally for all scripts> | |
54310121 | 9903 | |
fb9cefb4 | 9904 | =item COMPATIBILITY WITH CGI-LIB.PL |
54310121 | 9905 | |
9906 | =item AUTHOR INFORMATION | |
9907 | ||
9908 | =item CREDITS | |
9909 | ||
9910 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
9911 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
9912 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
14218588 GS |
9913 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
9914 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
9915 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
9916 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
9917 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
9918 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
9919 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
9920 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
9921 | ...and many many more.. | |
54310121 | 9922 | |
9923 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
9924 | ||
9925 | =item BUGS | |
9926 | ||
9927 | =item SEE ALSO | |
9928 | ||
a45bd81d GS |
9929 | =back |
9930 | ||
9931 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
9932 | ||
d420ca49 | 9933 | =over 4 |
54310121 | 9934 | |
9935 | =item SYNOPSIS | |
9936 | ||
a45bd81d GS |
9937 | =item ABSTRACT |
9938 | ||
54310121 | 9939 | =item DESCRIPTION |
9940 | ||
a45bd81d | 9941 | =item AUTHOR INFORMATION |
137443ea | 9942 | |
a45bd81d | 9943 | =item BUGS |
54310121 | 9944 | |
9945 | =item SEE ALSO | |
9946 | ||
a45bd81d | 9947 | =back |
54310121 | 9948 | |
9949 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
9950 | other) error log | |
9951 | ||
d420ca49 | 9952 | =over 4 |
a45bd81d | 9953 | |
54310121 | 9954 | =item SYNOPSIS |
9955 | ||
9956 | =item DESCRIPTION | |
9957 | ||
9958 | =item REDIRECTING ERROR MESSAGES | |
9959 | ||
9960 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
9961 | ||
d420ca49 | 9962 | =over 4 |
fb9cefb4 GS |
9963 | |
9964 | =item Changing the default message | |
9965 | ||
9966 | =back | |
9967 | ||
10862624 RF |
9968 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS |
9969 | ||
54310121 | 9970 | =item CHANGE LOG |
9971 | ||
9972 | =item AUTHORS | |
9973 | ||
9974 | =item SEE ALSO | |
9975 | ||
a45bd81d GS |
9976 | =back |
9977 | ||
fb9cefb4 GS |
9978 | =head2 CGI::Cookie - Interface to Netscape Cookies |
9979 | ||
d420ca49 | 9980 | =over 4 |
a45bd81d | 9981 | |
fb9cefb4 GS |
9982 | =item SYNOPSIS |
9983 | ||
9984 | =item DESCRIPTION | |
9985 | ||
9986 | =item USING CGI::Cookie | |
9987 | ||
9988 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
9989 | ||
d420ca49 | 9990 | =over 4 |
fb9cefb4 GS |
9991 | |
9992 | =item Creating New Cookies | |
9993 | ||
9994 | =item Sending the Cookie to the Browser | |
9995 | ||
9996 | =item Recovering Previous Cookies | |
9997 | ||
9998 | =item Manipulating Cookies | |
9999 | ||
10000 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
10001 | ||
10002 | =back | |
10003 | ||
10004 | =item AUTHOR INFORMATION | |
10005 | ||
10006 | =item BUGS | |
10007 | ||
10008 | =item SEE ALSO | |
10009 | ||
a45bd81d GS |
10010 | =back |
10011 | ||
54310121 | 10012 | =head2 CGI::Fast - CGI Interface for Fast CGI |
10013 | ||
d420ca49 | 10014 | =over 4 |
a45bd81d | 10015 | |
54310121 | 10016 | =item SYNOPSIS |
10017 | ||
10018 | =item DESCRIPTION | |
10019 | ||
10020 | =item OTHER PIECES OF THE PUZZLE | |
10021 | ||
10022 | =item WRITING FASTCGI PERL SCRIPTS | |
10023 | ||
10024 | =item INSTALLING FASTCGI SCRIPTS | |
10025 | ||
10026 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
10027 | ||
53d7eaa8 JH |
10028 | =item EXTERNAL FASTCGI SERVER INVOCATION |
10029 | ||
10030 | FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE | |
10031 | ||
54310121 | 10032 | =item CAVEATS |
10033 | ||
10034 | =item AUTHOR INFORMATION | |
10035 | ||
10036 | =item BUGS | |
10037 | ||
10038 | =item SEE ALSO | |
10039 | ||
a45bd81d GS |
10040 | =back |
10041 | ||
c76ac1ee GS |
10042 | =head2 CGI::Pretty - module to produce nicely formatted HTML code |
10043 | ||
d420ca49 | 10044 | =over 4 |
a45bd81d | 10045 | |
c76ac1ee GS |
10046 | =item SYNOPSIS |
10047 | ||
10048 | =item DESCRIPTION | |
10049 | ||
d420ca49 | 10050 | =over 4 |
c76ac1ee GS |
10051 | |
10052 | =item Tags that won't be formatted | |
10053 | ||
a45bd81d GS |
10054 | =item Customizing the Indenting |
10055 | ||
c76ac1ee GS |
10056 | =back |
10057 | ||
10058 | =item BUGS | |
10059 | ||
10060 | =item AUTHOR | |
10061 | ||
10062 | =item SEE ALSO | |
10063 | ||
a45bd81d GS |
10064 | =back |
10065 | ||
54310121 | 10066 | =head2 CGI::Push - Simple Interface to Server Push |
10067 | ||
d420ca49 | 10068 | =over 4 |
a45bd81d | 10069 | |
54310121 | 10070 | =item SYNOPSIS |
10071 | ||
10072 | =item DESCRIPTION | |
10073 | ||
10074 | =item USING CGI::Push | |
10075 | ||
2d967e39 | 10076 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph |
54310121 | 10077 | |
d420ca49 | 10078 | =over 4 |
fb9cefb4 GS |
10079 | |
10080 | =item Heterogeneous Pages | |
10081 | ||
10082 | =item Changing the Page Delay on the Fly | |
10083 | ||
10084 | =back | |
10085 | ||
54310121 | 10086 | =item INSTALLING CGI::Push SCRIPTS |
10087 | ||
54310121 | 10088 | =item AUTHOR INFORMATION |
10089 | ||
10090 | =item BUGS | |
10091 | ||
10092 | =item SEE ALSO | |
10093 | ||
a45bd81d GS |
10094 | =back |
10095 | ||
10096 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
10097 | ||
d420ca49 | 10098 | =over 4 |
54310121 | 10099 | |
10100 | =item SYNOPSIS | |
10101 | ||
a45bd81d GS |
10102 | =item ABSTRACT |
10103 | ||
54310121 | 10104 | =item DESCRIPTION |
10105 | ||
a45bd81d | 10106 | =item AUTHOR INFORMATION |
54310121 | 10107 | |
a45bd81d GS |
10108 | =item BUGS |
10109 | ||
10110 | =item SEE ALSO | |
10111 | ||
10112 | =back | |
54310121 | 10113 | |
2d967e39 JH |
10114 | =head2 CGI::Util - Internal utilities used by CGI module |
10115 | ||
10116 | =over 4 | |
10117 | ||
10118 | =item SYNOPSIS | |
10119 | ||
10120 | =item DESCRIPTION | |
10121 | ||
10122 | =item AUTHOR INFORMATION | |
10123 | ||
10124 | =item SEE ALSO | |
10125 | ||
10126 | =back | |
10127 | ||
8ebc5c01 | 10128 | =head2 CPAN - query, download and build perl modules from CPAN sites |
cb1a09d0 | 10129 | |
d420ca49 | 10130 | =over 4 |
a45bd81d | 10131 | |
8ebc5c01 | 10132 | =item SYNOPSIS |
cb1a09d0 | 10133 | |
8ebc5c01 | 10134 | =item DESCRIPTION |
cb1a09d0 | 10135 | |
d420ca49 | 10136 | =over 4 |
cb1a09d0 | 10137 | |
8ebc5c01 | 10138 | =item Interactive Mode |
cb1a09d0 | 10139 | |
8ebc5c01 | 10140 | Searching for authors, bundles, distribution files and modules, make, test, |
694468e3 | 10141 | install, clean modules or distributions, get, readme, look module or |
f40a6c71 | 10142 | distribution, ls author, Signals |
cb1a09d0 | 10143 | |
8ebc5c01 | 10144 | =item CPAN::Shell |
cb1a09d0 | 10145 | |
774d564b | 10146 | =item autobundle |
10147 | ||
10148 | =item recompile | |
10149 | ||
d516a115 | 10150 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
dc848c6f | 10151 | |
10862624 | 10152 | =item Programmer's interface |
cb1a09d0 | 10153 | |
165c0277 JH |
10154 | expand($type,@things), expandany(@things), Programming Examples |
10155 | ||
10156 | =item Methods in the other Classes | |
10157 | ||
10158 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), | |
10159 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), | |
10160 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), | |
10161 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), | |
10162 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), | |
10163 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), | |
10164 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), | |
10165 | CPAN::Bundle::readme(), CPAN::Bundle::test(), | |
10166 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), | |
10167 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), | |
10168 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), | |
10169 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), | |
10170 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), | |
10171 | CPAN::Distribution::look(), CPAN::Distribution::make(), | |
10172 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), | |
10173 | CPAN::Distribution::test(), CPAN::Distribution::uptodate(), | |
10174 | CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), | |
10175 | CPAN::Module::as_glimpse(), CPAN::Module::as_string(), | |
10176 | CPAN::Module::clean(), CPAN::Module::cpan_file(), | |
10177 | CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), | |
10178 | CPAN::Module::description(), CPAN::Module::force($method,@args), | |
10179 | CPAN::Module::get(), CPAN::Module::inst_file(), | |
10180 | CPAN::Module::inst_version(), CPAN::Module::install(), | |
10181 | CPAN::Module::look(), CPAN::Module::make(), | |
10182 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), | |
10183 | CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() | |
d516a115 | 10184 | |
8ebc5c01 | 10185 | =item Cache Manager |
cb1a09d0 | 10186 | |
8ebc5c01 | 10187 | =item Bundles |
cb1a09d0 | 10188 | |
774d564b | 10189 | =item Prerequisites |
cb1a09d0 | 10190 | |
fb9cefb4 GS |
10191 | =item Finding packages and VERSION |
10192 | ||
774d564b | 10193 | =item Debugging |
10194 | ||
14218588 | 10195 | =item Floppy, Zip, Offline Mode |
cb1a09d0 AD |
10196 | |
10197 | =back | |
10198 | ||
8ebc5c01 | 10199 | =item CONFIGURATION |
cb1a09d0 | 10200 | |
694468e3 GS |
10201 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> |
10202 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
10203 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
10204 | [unshift|push|splice] E<lt>listE<gt>> | |
cb1a09d0 | 10205 | |
d420ca49 | 10206 | =over 4 |
d516a115 | 10207 | |
14218588 GS |
10208 | =item Note on urllist parameter's format |
10209 | ||
10210 | =item urllist parameter has CD-ROM support | |
d516a115 JH |
10211 | |
10212 | =back | |
10213 | ||
8ebc5c01 | 10214 | =item SECURITY |
cb1a09d0 | 10215 | |
8ebc5c01 | 10216 | =item EXPORT |
cb1a09d0 | 10217 | |
14218588 GS |
10218 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
10219 | ||
10220 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
10221 | ||
d420ca49 | 10222 | =over 4 |
10862624 RF |
10223 | |
10224 | =item Three basic types of firewalls | |
10225 | ||
14218588 GS |
10226 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade |
10227 | ||
93d73c42 | 10228 | =item Configuring lynx or ncftp for going through a firewall |
10862624 RF |
10229 | |
10230 | =back | |
10231 | ||
10232 | =item FAQ | |
10233 | ||
ab648d5e | 10234 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10) |
10862624 | 10235 | |
774d564b | 10236 | =item BUGS |
cb1a09d0 AD |
10237 | |
10238 | =item AUTHOR | |
10239 | ||
f40a6c71 SC |
10240 | =item TRANSLATIONS |
10241 | ||
8ebc5c01 | 10242 | =item SEE ALSO |
cb1a09d0 | 10243 | |
a45bd81d GS |
10244 | =back |
10245 | ||
8ebc5c01 | 10246 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
cb1a09d0 | 10247 | |
d420ca49 | 10248 | =over 4 |
a45bd81d | 10249 | |
cb1a09d0 AD |
10250 | =item SYNOPSIS |
10251 | ||
cb1a09d0 AD |
10252 | =item DESCRIPTION |
10253 | ||
a45bd81d GS |
10254 | =back |
10255 | ||
8ebc5c01 | 10256 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
10257 | module | |
cb1a09d0 | 10258 | |
d420ca49 | 10259 | =over 4 |
a45bd81d | 10260 | |
cb1a09d0 AD |
10261 | =item SYNOPSIS |
10262 | ||
cb1a09d0 AD |
10263 | =item DESCRIPTION |
10264 | ||
8ebc5c01 | 10265 | =item SEE ALSO |
cb1a09d0 | 10266 | |
a45bd81d GS |
10267 | =back |
10268 | ||
d516a115 | 10269 | =head2 Carp, carp - warn of errors (from perspective of caller) |
cb1a09d0 | 10270 | |
d420ca49 | 10271 | =over 4 |
a45bd81d | 10272 | |
8ebc5c01 | 10273 | =item SYNOPSIS |
cb1a09d0 | 10274 | |
8ebc5c01 | 10275 | =item DESCRIPTION |
cb1a09d0 | 10276 | |
d420ca49 | 10277 | =over 4 |
d516a115 JH |
10278 | |
10279 | =item Forcing a Stack Trace | |
10280 | ||
10281 | =back | |
10282 | ||
14218588 GS |
10283 | =item BUGS |
10284 | ||
a45bd81d GS |
10285 | =back |
10286 | ||
ab648d5e JH |
10287 | =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside |
10288 | ||
0d0e97a6 JH |
10289 | =head2 Class::ISA -- report the search path for a class's ISA tree |
10290 | ||
10291 | =over 4 | |
10292 | ||
10293 | =item SYNOPSIS | |
10294 | ||
10295 | =item DESCRIPTION | |
10296 | ||
10297 | =item FUNCTIONS | |
10298 | ||
10299 | the function Class::ISA::super_path($CLASS), the function | |
10300 | Class::ISA::self_and_super_path($CLASS), the function | |
10301 | Class::ISA::self_and_super_versions($CLASS) | |
10302 | ||
10303 | =item CAUTIONARY NOTES | |
10304 | ||
10305 | =item COPYRIGHT | |
10306 | ||
10307 | =item AUTHOR | |
10308 | ||
10309 | =back | |
10310 | ||
8cc95fdb | 10311 | =head2 Class::Struct - declare struct-like datatypes as Perl classes |
cb1a09d0 | 10312 | |
d420ca49 | 10313 | =over 4 |
a45bd81d | 10314 | |
cb1a09d0 AD |
10315 | =item SYNOPSIS |
10316 | ||
cb1a09d0 AD |
10317 | =item DESCRIPTION |
10318 | ||
d420ca49 | 10319 | =over 4 |
8cc95fdb | 10320 | |
10321 | =item The C<struct()> function | |
10322 | ||
d420ca49 AD |
10323 | =item Class Creation at Compile Time |
10324 | ||
8cc95fdb | 10325 | =item Element Types and Accessor Methods |
10326 | ||
10327 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
10328 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
10329 | ||
a10cf691 GS |
10330 | =item Initializing with C<new> |
10331 | ||
8cc95fdb | 10332 | =back |
10333 | ||
8ebc5c01 | 10334 | =item EXAMPLES |
cb1a09d0 | 10335 | |
a10cf691 | 10336 | Example 1, Example 2, Example 3 |
cb1a09d0 | 10337 | |
8cc95fdb | 10338 | =item Author and Modification History |
cb1a09d0 | 10339 | |
a45bd81d GS |
10340 | =back |
10341 | ||
14218588 GS |
10342 | =head2 Config - access Perl configuration information |
10343 | ||
d420ca49 | 10344 | =over 4 |
a45bd81d | 10345 | |
14218588 GS |
10346 | =item SYNOPSIS |
10347 | ||
10348 | =item DESCRIPTION | |
10349 | ||
10350 | myconfig(), config_sh(), config_vars(@names) | |
10351 | ||
10352 | =item EXAMPLE | |
10353 | ||
10354 | =item WARNING | |
10355 | ||
10356 | =item GLOSSARY | |
10357 | ||
d420ca49 | 10358 | =over 4 |
14218588 GS |
10359 | |
10360 | =item _ | |
10361 | ||
10362 | C<_a>, C<_exe>, C<_o> | |
10363 | ||
10364 | =item a | |
10365 | ||
640374d0 JH |
10366 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, |
10367 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, | |
10368 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, | |
b2deec1d | 10369 | C<asctime_r_proto>, C<awk> |
14218588 GS |
10370 | |
10371 | =item b | |
10372 | ||
c76ac1ee GS |
10373 | C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>, |
10374 | C<byacc>, C<byteorder> | |
14218588 GS |
10375 | |
10376 | =item c | |
10377 | ||
10378 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
93d73c42 JH |
10379 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, |
10380 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
772ff3b9 JH |
10381 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, |
10382 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, | |
b2deec1d JH |
10383 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, |
10384 | C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> | |
14218588 GS |
10385 | |
10386 | =item d | |
10387 | ||
2cc61e15 | 10388 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, |
b2deec1d JH |
10389 | C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, |
10390 | C<d_bcopy>, C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, | |
10391 | C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, | |
10392 | C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, | |
10393 | C<d_const>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, | |
10394 | C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, | |
10395 | C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, | |
10396 | C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, | |
10397 | C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, | |
10398 | C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, | |
10399 | C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, | |
10400 | C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, | |
10401 | C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, | |
758a5d79 JH |
10402 | C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, |
10403 | C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, | |
10404 | C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, | |
10405 | C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, | |
10406 | C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, | |
b2deec1d JH |
10407 | C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, |
10408 | C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, | |
10409 | C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, | |
10410 | C<d_gethostbyname_r>, C<d_gethostent_r>, C<d_gethostprotos>, | |
10411 | C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, C<d_getmnt>, | |
758a5d79 | 10412 | C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>, |
b2deec1d | 10413 | C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, |
758a5d79 JH |
10414 | C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, |
10415 | C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, | |
b2deec1d JH |
10416 | C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, |
10417 | C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, | |
10418 | C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, | |
10419 | C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, | |
10420 | C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, | |
10421 | C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, | |
890a53b9 JH |
10422 | C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, |
10423 | C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, | |
b2deec1d JH |
10424 | C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, |
10425 | C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, | |
10426 | C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, | |
10427 | C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, | |
10428 | C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, | |
10429 | C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, | |
10430 | C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, | |
10431 | C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, | |
10432 | C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, | |
10433 | C<d_nl_langinfo>, C<d_nv_preserves_uv> | |
10434 | ||
10435 | =item n | |
10436 | ||
10437 | C<nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>, | |
10438 | C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, | |
10439 | C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, | |
10440 | C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, | |
10441 | C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, | |
10442 | C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, | |
10443 | C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, | |
10444 | C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, | |
10445 | C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, | |
10446 | C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, | |
10447 | C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, | |
10448 | C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, | |
10449 | C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, | |
10450 | C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>, | |
10451 | C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, | |
10452 | C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>, | |
10453 | C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>, | |
10454 | C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, | |
10455 | C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, | |
10456 | C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>, | |
10457 | C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>, | |
10458 | C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, | |
10459 | C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, | |
10460 | C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, | |
10461 | C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, | |
10462 | C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, | |
34babc16 JH |
10463 | C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, |
10464 | C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, | |
10465 | C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, | |
10466 | C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, | |
b2deec1d JH |
10467 | C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>, |
10468 | C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, | |
10469 | C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, | |
10470 | C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, | |
10471 | C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, | |
10472 | C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>, | |
10473 | C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>, | |
80327a3d JH |
10474 | C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>, |
10475 | C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, | |
10476 | C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, | |
10477 | C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, | |
10478 | C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, | |
10479 | C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, | |
758a5d79 | 10480 | C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, |
b2deec1d | 10481 | C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> |
14218588 GS |
10482 | |
10483 | =item e | |
10484 | ||
b2deec1d JH |
10485 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, |
10486 | C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, | |
10487 | C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, | |
10488 | C<expr>, C<extensions>, C<extras> | |
14218588 GS |
10489 | |
10490 | =item f | |
10491 | ||
10492 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
5440bc8e JH |
10493 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, |
10494 | C<full_sed> | |
14218588 GS |
10495 | |
10496 | =item g | |
10497 | ||
b2deec1d JH |
10498 | C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>, |
10499 | C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>, | |
10500 | C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>, | |
10501 | C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>, | |
10502 | C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>, | |
10503 | C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>, | |
10504 | C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>, | |
10505 | C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, | |
10506 | C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> | |
14218588 GS |
10507 | |
10508 | =item h | |
10509 | ||
91331b4f | 10510 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat> |
14218588 GS |
10511 | |
10512 | =item i | |
10513 | ||
a45bd81d | 10514 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, |
b2deec1d JH |
10515 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, |
10516 | C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, | |
10517 | C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, | |
758a5d79 JH |
10518 | C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, |
10519 | C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, | |
10520 | C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, | |
10521 | C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, | |
10522 | C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, | |
10523 | C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, | |
10524 | C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, | |
10525 | C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, | |
10526 | C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, | |
10527 | C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, | |
10528 | C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, | |
10529 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, | |
10530 | C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, | |
10531 | C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, | |
10532 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>, | |
10533 | C<installman3dir>, C<installprefix>, C<installprefixexp>, | |
10534 | C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>, | |
10535 | C<installsitelib>, C<installstyle>, C<installusrbinperl>, | |
10536 | C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>, | |
10537 | C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> | |
14218588 GS |
10538 | |
10539 | =item k | |
10540 | ||
10541 | C<known_extensions>, C<ksh> | |
10542 | ||
10543 | =item l | |
10544 | ||
91331b4f JH |
10545 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, |
10546 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
10547 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
10548 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
b2deec1d JH |
10549 | C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, |
10550 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, | |
10551 | C<lseektype> | |
14218588 GS |
10552 | |
10553 | =item m | |
10554 | ||
10555 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
10556 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
10557 | C<man3direxp>, C<man3ext> | |
10558 | ||
10559 | =item M | |
10560 | ||
91331b4f | 10561 | C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>, |
b2deec1d | 10562 | C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>, |
165c0277 JH |
10563 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, |
10564 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, | |
10565 | C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>, | |
10566 | C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype> | |
14218588 GS |
10567 | |
10568 | =item o | |
10569 | ||
10570 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
d722968f | 10571 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> |
14218588 GS |
10572 | |
10573 | =item p | |
10574 | ||
694468e3 | 10575 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, |
640374d0 | 10576 | C<perl>, C<perl_patchlevel> |
a45bd81d GS |
10577 | |
10578 | =item P | |
10579 | ||
10580 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
91331b4f JH |
10581 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, |
10582 | C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, | |
34babc16 | 10583 | C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize> |
a45bd81d GS |
10584 | |
10585 | =item q | |
10586 | ||
10587 | C<quadkind>, C<quadtype> | |
14218588 GS |
10588 | |
10589 | =item r | |
10590 | ||
b2deec1d JH |
10591 | C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, |
10592 | C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, | |
10593 | C<rmail>, C<run>, C<runnm> | |
14218588 GS |
10594 | |
10595 | =item s | |
10596 | ||
10597 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
b2deec1d JH |
10598 | C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, |
10599 | C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, | |
10600 | C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, | |
10601 | C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, | |
10602 | C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, | |
10603 | C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, | |
10604 | C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, | |
dc5c060f JH |
10605 | C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, |
10606 | C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, | |
10607 | C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, | |
10608 | C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, | |
b2deec1d JH |
10609 | C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, |
10610 | C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>, | |
10611 | C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, | |
10612 | C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>, | |
10613 | C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman> | |
14218588 GS |
10614 | |
10615 | =item t | |
10616 | ||
5440bc8e | 10617 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, |
b2deec1d JH |
10618 | C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, |
10619 | C<ttyname_r_proto> | |
14218588 GS |
10620 | |
10621 | =item u | |
10622 | ||
a45bd81d GS |
10623 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, |
10624 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
694468e3 | 10625 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, |
5440bc8e JH |
10626 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>, |
10627 | C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, | |
10628 | C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, | |
10629 | C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, | |
10630 | C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, | |
10631 | C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat> | |
14218588 GS |
10632 | |
10633 | =item v | |
10634 | ||
b38f6a39 GS |
10635 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, |
10636 | C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>, | |
91144103 JH |
10637 | C<vendorprefixexp>, C<version>, C<version_patchlevel_string>, |
10638 | C<versiononly>, C<vi>, C<voidflags> | |
14218588 GS |
10639 | |
10640 | =item x | |
10641 | ||
694468e3 | 10642 | C<xlibpth>, C<xs_apiversion> |
14218588 | 10643 | |
fc6a272d JH |
10644 | =item y |
10645 | ||
10646 | C<yacc>, C<yaccflags> | |
10647 | ||
14218588 GS |
10648 | =item z |
10649 | ||
10650 | C<zcat>, C<zip> | |
10651 | ||
10652 | =back | |
10653 | ||
10654 | =item NOTE | |
10655 | ||
a45bd81d GS |
10656 | =back |
10657 | ||
ab1e085c | 10658 | =head2 Cwd - get pathname of current working directory |
cb1a09d0 | 10659 | |
d420ca49 | 10660 | =over 4 |
a45bd81d | 10661 | |
8ebc5c01 | 10662 | =item SYNOPSIS |
cb1a09d0 | 10663 | |
8ebc5c01 | 10664 | =item DESCRIPTION |
cb1a09d0 | 10665 | |
53d7eaa8 JH |
10666 | =over 4 |
10667 | ||
10668 | =item getcwd and friends | |
10669 | ||
10670 | getcwd, cwd, fastcwd, fastgetcwd | |
10671 | ||
10672 | =item abs_path and friends | |
10673 | ||
10674 | abs_path, realpath, fast_abs_path | |
10675 | ||
10676 | =item $ENV{PWD} | |
10677 | ||
10678 | =back | |
10679 | ||
d0363f02 JH |
10680 | =item NOTES |
10681 | ||
53d7eaa8 JH |
10682 | =item SEE ALSO |
10683 | ||
a45bd81d GS |
10684 | =back |
10685 | ||
14218588 GS |
10686 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
10687 | subject to | |
10688 | change) | |
10689 | ||
d420ca49 | 10690 | =over 4 |
a45bd81d | 10691 | |
14218588 GS |
10692 | =item SYNOPSIS |
10693 | ||
10694 | =item DESCRIPTION | |
10695 | ||
d420ca49 | 10696 | =over 4 |
14218588 GS |
10697 | |
10698 | =item Global Variables | |
10699 | ||
10700 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
10701 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
10702 | $DB::lineno | |
10703 | ||
10704 | =item API Methods | |
10705 | ||
10706 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
10707 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
10708 | ||
10709 | =item Client Callback Methods | |
10710 | ||
10711 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
10712 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
10713 | CLIENT->output(LIST) | |
10714 | ||
10715 | =back | |
10716 | ||
10717 | =item BUGS | |
10718 | ||
10719 | =item AUTHOR | |
10720 | ||
a45bd81d GS |
10721 | =back |
10722 | ||
d516a115 | 10723 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
cb1a09d0 | 10724 | |
d420ca49 | 10725 | =over 4 |
a45bd81d | 10726 | |
cb1a09d0 AD |
10727 | =item SYNOPSIS |
10728 | ||
cb1a09d0 AD |
10729 | =item DESCRIPTION |
10730 | ||
8ebc5c01 | 10731 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
cb1a09d0 | 10732 | |
d420ca49 | 10733 | =over 4 |
cb1a09d0 | 10734 | |
1fdc5aa6 | 10735 | =item Using DB_File with Berkeley DB version 2 or greater |
d516a115 | 10736 | |
68dc0745 | 10737 | =item Interface to Berkeley DB |
cb1a09d0 | 10738 | |
8ebc5c01 | 10739 | =item Opening a Berkeley DB Database File |
cb1a09d0 | 10740 | |
8ebc5c01 | 10741 | =item Default Parameters |
cb1a09d0 | 10742 | |
8ebc5c01 | 10743 | =item In Memory Databases |
cb1a09d0 AD |
10744 | |
10745 | =back | |
10746 | ||
8ebc5c01 | 10747 | =item DB_HASH |
cb1a09d0 | 10748 | |
d420ca49 | 10749 | =over 4 |
cb1a09d0 | 10750 | |
68dc0745 | 10751 | =item A Simple Example |
cb1a09d0 | 10752 | |
8ebc5c01 | 10753 | =back |
cb1a09d0 | 10754 | |
8ebc5c01 | 10755 | =item DB_BTREE |
cb1a09d0 | 10756 | |
d420ca49 | 10757 | =over 4 |
cb1a09d0 | 10758 | |
8ebc5c01 | 10759 | =item Changing the BTREE sort order |
cb1a09d0 | 10760 | |
68dc0745 | 10761 | =item Handling Duplicate Keys |
cb1a09d0 | 10762 | |
68dc0745 | 10763 | =item The get_dup() Method |
cb1a09d0 | 10764 | |
14218588 GS |
10765 | =item The find_dup() Method |
10766 | ||
10767 | =item The del_dup() Method | |
10768 | ||
8ebc5c01 | 10769 | =item Matching Partial Keys |
cb1a09d0 | 10770 | |
8ebc5c01 | 10771 | =back |
cb1a09d0 | 10772 | |
8ebc5c01 | 10773 | =item DB_RECNO |
cb1a09d0 | 10774 | |
d420ca49 | 10775 | =over 4 |
cb1a09d0 | 10776 | |
68dc0745 | 10777 | =item The 'bval' Option |
cb1a09d0 | 10778 | |
8ebc5c01 | 10779 | =item A Simple Example |
cb1a09d0 | 10780 | |
14218588 | 10781 | =item Extra RECNO Methods |
cb1a09d0 | 10782 | |
8ebc5c01 | 10783 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
1fa7ca25 JH |
10784 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, |
10785 | length, elements);> | |
cb1a09d0 | 10786 | |
8ebc5c01 | 10787 | =item Another Example |
cb1a09d0 | 10788 | |
8ebc5c01 | 10789 | =back |
cb1a09d0 | 10790 | |
8ebc5c01 | 10791 | =item THE API INTERFACE |
cb1a09d0 | 10792 | |
8ebc5c01 | 10793 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
10794 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
10795 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
10796 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
cb1a09d0 | 10797 | |
c76ac1ee GS |
10798 | =item DBM FILTERS |
10799 | ||
10800 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
10801 | B<filter_fetch_value> | |
10802 | ||
d420ca49 | 10803 | =over 4 |
c76ac1ee GS |
10804 | |
10805 | =item The Filter | |
10806 | ||
10807 | =item An Example -- the NULL termination problem. | |
10808 | ||
10809 | =item Another Example -- Key is a C int. | |
10810 | ||
10811 | =back | |
10812 | ||
8ebc5c01 | 10813 | =item HINTS AND TIPS |
cb1a09d0 | 10814 | |
d420ca49 | 10815 | =over 4 |
8ebc5c01 | 10816 | |
a45bd81d GS |
10817 | =item Locking: The Trouble with fd |
10818 | ||
10819 | =item Safe ways to lock a database | |
10820 | ||
10821 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
cb1a09d0 | 10822 | |
68dc0745 | 10823 | =item Sharing Databases With C Applications |
cb1a09d0 | 10824 | |
68dc0745 | 10825 | =item The untie() Gotcha |
4fdae800 | 10826 | |
8ebc5c01 | 10827 | =back |
cb1a09d0 | 10828 | |
8ebc5c01 | 10829 | =item COMMON QUESTIONS |
cb1a09d0 | 10830 | |
d420ca49 | 10831 | =over 4 |
cb1a09d0 | 10832 | |
8ebc5c01 | 10833 | =item Why is there Perl source in my database? |
cb1a09d0 | 10834 | |
8ebc5c01 | 10835 | =item How do I store complex data structures with DB_File? |
cb1a09d0 | 10836 | |
8ebc5c01 | 10837 | =item What does "Invalid Argument" mean? |
cb1a09d0 | 10838 | |
8ebc5c01 | 10839 | =item What does "Bareword 'DB_File' not allowed" mean? |
cb1a09d0 | 10840 | |
8ebc5c01 | 10841 | =back |
cb1a09d0 | 10842 | |
c76ac1ee GS |
10843 | =item REFERENCES |
10844 | ||
8ebc5c01 | 10845 | =item HISTORY |
cb1a09d0 | 10846 | |
8ebc5c01 | 10847 | =item BUGS |
cb1a09d0 | 10848 | |
8ebc5c01 | 10849 | =item AVAILABILITY |
cb1a09d0 | 10850 | |
d516a115 JH |
10851 | =item COPYRIGHT |
10852 | ||
8ebc5c01 | 10853 | =item SEE ALSO |
cb1a09d0 | 10854 | |
8ebc5c01 | 10855 | =item AUTHOR |
cb1a09d0 | 10856 | |
a45bd81d GS |
10857 | =back |
10858 | ||
fb9cefb4 GS |
10859 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
10860 | printing and C<eval> | |
10861 | ||
d420ca49 | 10862 | =over 4 |
a45bd81d | 10863 | |
fb9cefb4 GS |
10864 | =item SYNOPSIS |
10865 | ||
10866 | =item DESCRIPTION | |
10867 | ||
d420ca49 | 10868 | =over 4 |
fb9cefb4 GS |
10869 | |
10870 | =item Methods | |
10871 | ||
14218588 | 10872 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
b38f6a39 GS |
10873 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), |
10874 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
10875 | I<$OBJ>->Reset | |
fb9cefb4 GS |
10876 | |
10877 | =item Functions | |
10878 | ||
b38f6a39 | 10879 | Dumper(I<LIST>) |
fb9cefb4 GS |
10880 | |
10881 | =item Configuration Variables or Methods | |
10882 | ||
10883 | $Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>), | |
10884 | $Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>), | |
10885 | $Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>), | |
10886 | $Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>), | |
10887 | $Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>), | |
10888 | $Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>), | |
10889 | $Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>), | |
10890 | $Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>), | |
10891 | $Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>), | |
10892 | $Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>), | |
c76ac1ee | 10893 | $Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>), |
35bf961c JH |
10894 | $Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>), |
10895 | $Data::Dumper::Useperl I<or> $I<OBJ>->Useperl(I<[NEWVAL]>), | |
cb52f95f JH |
10896 | $Data::Dumper::Sortkeys I<or> $I<OBJ>->Sortkeys(I<[NEWVAL]>), |
10897 | $Data::Dumper::Deparse I<or> $I<OBJ>->Deparse(I<[NEWVAL]>) | |
fb9cefb4 GS |
10898 | |
10899 | =item Exports | |
10900 | ||
10901 | Dumper | |
10902 | ||
10903 | =back | |
10904 | ||
10905 | =item EXAMPLES | |
10906 | ||
10907 | =item BUGS | |
10908 | ||
10909 | =item AUTHOR | |
10910 | ||
10911 | =item VERSION | |
10912 | ||
10913 | =item SEE ALSO | |
10914 | ||
a45bd81d GS |
10915 | =back |
10916 | ||
c76ac1ee GS |
10917 | =head2 Devel::DProf - a Perl code profiler |
10918 | ||
d420ca49 | 10919 | =over 4 |
a45bd81d | 10920 | |
c76ac1ee GS |
10921 | =item SYNOPSIS |
10922 | ||
10923 | =item DESCRIPTION | |
10924 | ||
10925 | =item PROFILE FORMAT | |
10926 | ||
10927 | =item AUTOLOAD | |
10928 | ||
10929 | =item ENVIRONMENT | |
10930 | ||
10931 | =item BUGS | |
10932 | ||
10933 | =item SEE ALSO | |
10934 | ||
a45bd81d GS |
10935 | =back |
10936 | ||
428dc699 JH |
10937 | =head2 Devel::PPPort, Perl/Pollution/Portability |
10938 | ||
10939 | =over 4 | |
10940 | ||
10941 | =item SYNOPSIS | |
10942 | ||
10943 | =item DESCRIPTION | |
10944 | ||
10945 | =over 4 | |
10946 | ||
10947 | =item WriteFile | |
10948 | ||
10949 | =back | |
10950 | ||
493a87da JH |
10951 | =item ppport.h |
10952 | ||
428dc699 JH |
10953 | =item AUTHOR |
10954 | ||
10955 | =item SEE ALSO | |
10956 | ||
10957 | =back | |
10958 | ||
14218588 GS |
10959 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
10960 | ||
d420ca49 | 10961 | =over 4 |
a45bd81d | 10962 | |
14218588 GS |
10963 | =item SYNOPSIS |
10964 | ||
10965 | =item DESCRIPTION | |
10966 | ||
d420ca49 | 10967 | =over 4 |
37d4d706 | 10968 | |
07fcf8ff JH |
10969 | =item Runtime debugging |
10970 | ||
37d4d706 JH |
10971 | =item Memory footprint debugging |
10972 | ||
10973 | =back | |
10974 | ||
14218588 GS |
10975 | =item EXAMPLES |
10976 | ||
d420ca49 | 10977 | =over 4 |
14218588 GS |
10978 | |
10979 | =item A simple scalar string | |
10980 | ||
10981 | =item A simple scalar number | |
10982 | ||
10983 | =item A simple scalar with an extra reference | |
10984 | ||
10985 | =item A reference to a simple scalar | |
10986 | ||
10987 | =item A reference to an array | |
10988 | ||
10989 | =item A reference to a hash | |
10990 | ||
10991 | =item Dumping a large array or hash | |
10992 | ||
10993 | =item A reference to an SV which holds a C pointer | |
10994 | ||
10995 | =item A reference to a subroutine | |
10996 | ||
10997 | =back | |
10998 | ||
10999 | =item EXPORTS | |
11000 | ||
11001 | =item BUGS | |
11002 | ||
11003 | =item AUTHOR | |
11004 | ||
11005 | =item SEE ALSO | |
11006 | ||
a45bd81d GS |
11007 | =back |
11008 | ||
8ebc5c01 | 11009 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
cb1a09d0 | 11010 | |
d420ca49 | 11011 | =over 4 |
a45bd81d | 11012 | |
8ebc5c01 | 11013 | =item SYNOPSIS |
cb1a09d0 | 11014 | |
8ebc5c01 | 11015 | =item DESCRIPTION |
cb1a09d0 | 11016 | |
a45bd81d GS |
11017 | =back |
11018 | ||
ab1e085c JH |
11019 | =head2 Digest:: - Modules that calculate message digests |
11020 | ||
11021 | =over 4 | |
11022 | ||
11023 | =item SYNOPSIS | |
11024 | ||
11025 | =item DESCRIPTION | |
11026 | ||
11027 | I<binary>, I<hex>, I<base64> | |
11028 | ||
11029 | =item OO INTERFACE | |
11030 | ||
11031 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = | |
11032 | Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), | |
11033 | $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest | |
11034 | ||
11035 | =item SEE ALSO | |
11036 | ||
11037 | =item AUTHOR | |
11038 | ||
11039 | =back | |
11040 | ||
11041 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm | |
11042 | ||
11043 | =over 4 | |
11044 | ||
11045 | =item SYNOPSIS | |
11046 | ||
11047 | =item DESCRIPTION | |
11048 | ||
11049 | =item FUNCTIONS | |
11050 | ||
11051 | md5($data,...), md5_hex($data,...), md5_base64($data,...) | |
11052 | ||
11053 | =item METHODS | |
11054 | ||
11055 | $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), | |
11056 | $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest | |
11057 | ||
11058 | =item EXAMPLES | |
11059 | ||
11060 | =item SEE ALSO | |
11061 | ||
11062 | =item COPYRIGHT | |
11063 | ||
11064 | =item AUTHORS | |
11065 | ||
11066 | =back | |
11067 | ||
8ebc5c01 | 11068 | =head2 DirHandle - supply object methods for directory handles |
cb1a09d0 | 11069 | |
d420ca49 | 11070 | =over 4 |
a45bd81d | 11071 | |
8ebc5c01 | 11072 | =item SYNOPSIS |
cb1a09d0 | 11073 | |
8ebc5c01 | 11074 | =item DESCRIPTION |
cb1a09d0 | 11075 | |
ac4dd294 JH |
11076 | =item NOTES |
11077 | ||
a45bd81d GS |
11078 | =back |
11079 | ||
14218588 GS |
11080 | =head2 Dumpvalue - provides screen dump of Perl data. |
11081 | ||
d420ca49 | 11082 | =over 4 |
a45bd81d | 11083 | |
c76ac1ee | 11084 | =item SYNOPSIS |
14218588 GS |
11085 | |
11086 | =item DESCRIPTION | |
11087 | ||
d420ca49 | 11088 | =over 4 |
14218588 GS |
11089 | |
11090 | =item Creation | |
11091 | ||
11092 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
35bf961c JH |
11093 | C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, |
11094 | C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
14218588 GS |
11095 | stopDbSignal |
11096 | ||
11097 | =item Methods | |
11098 | ||
11099 | dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump, | |
11100 | veryCompact, set, get | |
11101 | ||
11102 | =back | |
11103 | ||
a45bd81d GS |
11104 | =back |
11105 | ||
14218588 GS |
11106 | =head2 DynaLoader - Dynamically load C libraries into Perl code |
11107 | ||
d420ca49 | 11108 | =over 4 |
a45bd81d | 11109 | |
14218588 GS |
11110 | =item SYNOPSIS |
11111 | ||
11112 | =item DESCRIPTION | |
11113 | ||
11114 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
11115 | @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), | |
b38f6a39 | 11116 | dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(), |
14218588 GS |
11117 | dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), |
11118 | bootstrap() | |
11119 | ||
11120 | =item AUTHOR | |
11121 | ||
a45bd81d GS |
11122 | =back |
11123 | ||
11124 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
11125 | Perl code | |
11126 | ||
d420ca49 | 11127 | =over 4 |
a45bd81d GS |
11128 | |
11129 | =item SYNOPSIS | |
11130 | ||
11131 | =item DESCRIPTION | |
11132 | ||
11133 | =item AUTHOR | |
11134 | ||
11135 | =back | |
11136 | ||
91331b4f JH |
11137 | =head2 Encode - character encodings |
11138 | ||
d420ca49 | 11139 | =over 4 |
91331b4f | 11140 | |
2d967e39 JH |
11141 | =item SYNOPSIS |
11142 | ||
11143 | =item DESCRIPTION | |
11144 | ||
2d967e39 JH |
11145 | =item PERL ENCODING API |
11146 | ||
11147 | =over 4 | |
11148 | ||
11149 | =item Generic Encoding Interface | |
91331b4f | 11150 | |
fa1c7b03 JH |
11151 | $bytes = encode(ENCODING, $string[, CHECK]), $string = decode(ENCODING, |
11152 | $bytes[, CHECK]), from_to($string, FROM_ENCODING, TO_ENCODING[, CHECK]) | |
11153 | ||
91331b4f JH |
11154 | =item Handling Malformed Data |
11155 | ||
2d967e39 JH |
11156 | Scheme 1, Scheme 2, Other Schemes |
11157 | ||
11158 | =item UTF-8 / utf8 | |
11159 | ||
fa1c7b03 | 11160 | $bytes = encode_utf8($string);, $string = decode_utf8($bytes [, CHECK]); |
2d967e39 | 11161 | |
fc6a272d JH |
11162 | =item Listing available encodings |
11163 | ||
11164 | =item Defining Aliases | |
11165 | ||
fa1c7b03 | 11166 | =back |
fc6a272d JH |
11167 | |
11168 | =item Defining Encodings | |
11169 | ||
2d967e39 JH |
11170 | =item Encoding and IO |
11171 | ||
2d967e39 JH |
11172 | =item Messing with Perl's Internals |
11173 | ||
fa1c7b03 | 11174 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) |
2d967e39 | 11175 | |
fa1c7b03 | 11176 | =item SEE ALSO |
2d967e39 | 11177 | |
fa1c7b03 JH |
11178 | =back |
11179 | ||
11180 | =head2 Encode::lib::Encode::Alias, Encode::Alias - alias defintions to | |
11181 | encodings | |
2d967e39 JH |
11182 | |
11183 | =over 4 | |
11184 | ||
fa1c7b03 | 11185 | =item SYNOPSIS |
2d967e39 | 11186 | |
fa1c7b03 JH |
11187 | =item DESCRIPTION |
11188 | ||
11189 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
11190 | reference, e.g.: | |
11191 | ||
11192 | =over 4 | |
11193 | ||
11194 | =item Alias overloading | |
2d967e39 JH |
11195 | |
11196 | =back | |
11197 | ||
11198 | =item SEE ALSO | |
11199 | ||
91331b4f JH |
11200 | =back |
11201 | ||
fa1c7b03 JH |
11202 | =head2 Encode::lib::Encode::Details, Encode::Details - implementation |
11203 | details of Encode.pm | |
fe9287c4 | 11204 | |
80327a3d JH |
11205 | =over 4 |
11206 | ||
80327a3d JH |
11207 | =item DESCRIPTION |
11208 | ||
fa1c7b03 JH |
11209 | =over 4 |
11210 | ||
11211 | =item TERMINOLOGY | |
80327a3d JH |
11212 | |
11213 | =back | |
11214 | ||
fa1c7b03 | 11215 | =item ENCODINGS |
80327a3d JH |
11216 | |
11217 | =over 4 | |
11218 | ||
fa1c7b03 | 11219 | =item Characteristics of an Encoding |
80327a3d | 11220 | |
fa1c7b03 | 11221 | =item Types of Encodings |
80327a3d | 11222 | |
fa1c7b03 JH |
11223 | Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, |
11224 | Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings | |
11225 | ||
11226 | =item Specifying Encodings | |
11227 | ||
11228 | 1. By name, 2. As an object | |
11229 | ||
11230 | =item Encoding Names | |
11231 | ||
11232 | The MIME name as defined in IETF RFCs, The name in the IANA registry, The | |
11233 | name used by the organization that defined it | |
11234 | ||
11235 | =item Encoding Classification | |
80327a3d JH |
11236 | |
11237 | =back | |
11238 | ||
fa1c7b03 | 11239 | =item PERL ENCODING API |
80327a3d JH |
11240 | |
11241 | =over 4 | |
11242 | ||
fa1c7b03 | 11243 | =item Generic Encoding Interface |
80327a3d | 11244 | |
fa1c7b03 | 11245 | =item Handling Malformed Data |
80327a3d | 11246 | |
fa1c7b03 | 11247 | Scheme 1, Scheme 2, Other Schemes |
80327a3d | 11248 | |
fa1c7b03 | 11249 | =item UTF-8 / utf8 |
80327a3d | 11250 | |
fa1c7b03 | 11251 | $bytes = encode_utf8($string);, $string = decode_utf8($bytes [,CHECK]); |
fe9287c4 | 11252 | |
fa1c7b03 | 11253 | =item Other Encodings of Unicode |
80327a3d | 11254 | |
fa1c7b03 | 11255 | =item Listing available encodings |
80327a3d | 11256 | |
fa1c7b03 | 11257 | =item Defining Aliases |
80327a3d | 11258 | |
fa1c7b03 JH |
11259 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code |
11260 | reference, e.g.: | |
11261 | ||
11262 | =item Defining Encodings | |
80327a3d JH |
11263 | |
11264 | =back | |
11265 | ||
fa1c7b03 JH |
11266 | =item Encoding and IO |
11267 | ||
11268 | =item Encoding How to ... | |
11269 | ||
11270 | IO with mixed content (faking iso-2022-*), MIME's Content-Length:, UTF-8 | |
11271 | strings in binary data, Perl/Encode wrappers on non-Unicode XS modules | |
11272 | ||
11273 | =item Messing with Perl's Internals | |
11274 | ||
11275 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) | |
11276 | ||
11277 | =item IMPLEMENTATION CLASSES | |
11278 | ||
11279 | -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check), | |
11280 | -E<gt>decode($octets,$check) | |
80327a3d JH |
11281 | |
11282 | =over 4 | |
11283 | ||
fa1c7b03 | 11284 | =item Compiled Encodings |
80327a3d | 11285 | |
fa1c7b03 JH |
11286 | .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other |
11287 | variants of EBCDIC, symbol and dingbats as used by Tk on X11 | |
11288 | ||
11289 | =back | |
80327a3d JH |
11290 | |
11291 | =item SEE ALSO | |
11292 | ||
11293 | =back | |
11294 | ||
fa1c7b03 JH |
11295 | =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode |
11296 | Implementation Base Class | |
80327a3d JH |
11297 | |
11298 | =over 4 | |
11299 | ||
11300 | =item SYNOPSIS | |
11301 | ||
11302 | =item DESCRIPTION | |
11303 | ||
fa1c7b03 JH |
11304 | -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check), |
11305 | -E<gt>decode($octets,$check) | |
11306 | ||
11307 | =over 4 | |
11308 | ||
11309 | =item Compiled Encodings | |
11310 | ||
11311 | .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other | |
11312 | variants of EBCDIC, symbol and dingbats as used by Tk on X11 | |
11313 | ||
11314 | =back | |
80327a3d JH |
11315 | |
11316 | =back | |
11317 | ||
fa1c7b03 JH |
11318 | =head2 Encode::lib::Encode::Supported, Encode::Supports -- Supported |
11319 | encodings by Encode | |
165c0277 JH |
11320 | |
11321 | =over 4 | |
11322 | ||
11323 | =item DESCRIPTION | |
11324 | ||
fa1c7b03 | 11325 | =over 4 |
165c0277 | 11326 | |
fa1c7b03 | 11327 | =item Encoding Names |
165c0277 JH |
11328 | |
11329 | =back | |
11330 | ||
fa1c7b03 | 11331 | =item Supported Encodings |
165c0277 JH |
11332 | |
11333 | =over 4 | |
11334 | ||
fa1c7b03 | 11335 | =item Built-in Encodings |
165c0277 | 11336 | |
fa1c7b03 | 11337 | =item Encode::Byte |
165c0277 | 11338 | |
fa1c7b03 | 11339 | =item The CJK: Chinese, Japanese, Korean (Multibyte) |
165c0277 | 11340 | |
fa1c7b03 JH |
11341 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, |
11342 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN | |
165c0277 | 11343 | |
fa1c7b03 | 11344 | =item Miscellaneous encodings |
165c0277 | 11345 | |
fa1c7b03 | 11346 | Encode::EBCDIC, Encode::Symbols |
cb1a09d0 | 11347 | |
fa1c7b03 | 11348 | =back |
a45bd81d | 11349 | |
fa1c7b03 | 11350 | =item Encoding vs. Charset |
cb1a09d0 | 11351 | |
fa1c7b03 | 11352 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) |
cb1a09d0 | 11353 | |
fa1c7b03 | 11354 | =item See Also |
694468e3 | 11355 | |
a45bd81d GS |
11356 | =back |
11357 | ||
fa1c7b03 JH |
11358 | =head2 English - use nice English (or awk) names for ugly punctuation |
11359 | variables | |
cb1a09d0 | 11360 | |
d420ca49 | 11361 | =over 4 |
a45bd81d | 11362 | |
cb1a09d0 AD |
11363 | =item SYNOPSIS |
11364 | ||
cb1a09d0 AD |
11365 | =item DESCRIPTION |
11366 | ||
fa1c7b03 | 11367 | =item PERFORMANCE |
cb1a09d0 | 11368 | |
a45bd81d GS |
11369 | =back |
11370 | ||
fa1c7b03 JH |
11371 | =head2 Env - perl module that imports environment variables as scalars or |
11372 | arrays | |
cb52f95f JH |
11373 | |
11374 | =over 4 | |
11375 | ||
11376 | =item SYNOPSIS | |
11377 | ||
11378 | =item DESCRIPTION | |
11379 | ||
fa1c7b03 | 11380 | =item LIMITATIONS |
cb52f95f JH |
11381 | |
11382 | =item AUTHOR | |
11383 | ||
cb52f95f JH |
11384 | =back |
11385 | ||
8ebc5c01 | 11386 | =head2 Exporter - Implements default import method for modules |
cb1a09d0 | 11387 | |
d420ca49 | 11388 | =over 4 |
a45bd81d | 11389 | |
8ebc5c01 | 11390 | =item SYNOPSIS |
cb1a09d0 | 11391 | |
8ebc5c01 | 11392 | =item DESCRIPTION |
cb1a09d0 | 11393 | |
d420ca49 | 11394 | =over 4 |
cb1a09d0 | 11395 | |
c76ac1ee GS |
11396 | =item How to Export |
11397 | ||
8ebc5c01 | 11398 | =item Selecting What To Export |
cb1a09d0 | 11399 | |
f502af34 JH |
11400 | =item How to Import |
11401 | ||
11402 | C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> | |
11403 | ||
11404 | =back | |
11405 | ||
11406 | =item Advanced features | |
11407 | ||
11408 | =over 4 | |
11409 | ||
8ebc5c01 | 11410 | =item Specialised Import Lists |
cb1a09d0 | 11411 | |
f502af34 | 11412 | =item Exporting without using Exporter's import method |
d516a115 | 11413 | |
8ebc5c01 | 11414 | =item Module Version Checking |
cb1a09d0 | 11415 | |
8ebc5c01 | 11416 | =item Managing Unknown Symbols |
cb1a09d0 | 11417 | |
8ebc5c01 | 11418 | =item Tag Handling Utility Functions |
cb1a09d0 | 11419 | |
80637b95 JH |
11420 | =item Generating combined tags |
11421 | ||
248e172a JH |
11422 | =item C<AUTOLOAD>ed Constants |
11423 | ||
8ebc5c01 | 11424 | =back |
cb1a09d0 | 11425 | |
a45bd81d GS |
11426 | =back |
11427 | ||
c76ac1ee GS |
11428 | =head2 Exporter::Heavy - Exporter guts |
11429 | ||
d420ca49 | 11430 | =over 4 |
a45bd81d | 11431 | |
04b01f78 | 11432 | =item SYNOPSIS |
c76ac1ee GS |
11433 | |
11434 | =item DESCRIPTION | |
11435 | ||
a45bd81d GS |
11436 | =back |
11437 | ||
68dc0745 | 11438 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
11439 | Makefiles etc. | |
11440 | ||
d420ca49 | 11441 | =over 4 |
a45bd81d | 11442 | |
dc848c6f | 11443 | =item SYNOPSIS |
68dc0745 | 11444 | |
11445 | =item DESCRIPTION | |
11446 | ||
a45bd81d GS |
11447 | =back |
11448 | ||
11449 | cat | |
11450 | ||
11451 | eqtime src dst | |
11452 | ||
e61ecf27 | 11453 | rm_rf files... |
a45bd81d GS |
11454 | |
11455 | rm_f files... | |
11456 | ||
11457 | touch files .. | |
11458 | ||
11459 | mv source... destination | |
11460 | ||
11461 | cp source... destination | |
11462 | ||
11463 | chmod mode files.. | |
11464 | ||
11465 | mkpath directory.. | |
11466 | ||
11467 | test_f file | |
11468 | ||
d420ca49 | 11469 | =over 4 |
68dc0745 | 11470 | |
11471 | =item BUGS | |
11472 | ||
11473 | =item SEE ALSO | |
11474 | ||
11475 | =item AUTHOR | |
11476 | ||
a45bd81d GS |
11477 | =back |
11478 | ||
772ff3b9 JH |
11479 | =head2 ExtUtils::Constant - generate XS code to import C header constants |
11480 | ||
11481 | =over 4 | |
11482 | ||
11483 | =item SYNOPSIS | |
11484 | ||
11485 | =item DESCRIPTION | |
11486 | ||
11487 | =item USAGE | |
11488 | ||
35bf961c | 11489 | IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF |
772ff3b9 JH |
11490 | |
11491 | =item FUNCTIONS | |
11492 | ||
11493 | =back | |
11494 | ||
11495 | C_stringify NAME | |
11496 | ||
fa1c7b03 JH |
11497 | perl_stringify NAME |
11498 | ||
772ff3b9 JH |
11499 | constant_types |
11500 | ||
11501 | memEQ_clause NAME, CHECKED_AT, INDENT | |
11502 | ||
9038e305 | 11503 | assign INDENT, TYPE, PRE, POST, VALUE.. |
2ef53570 | 11504 | |
4f233aa4 | 11505 | return_clause |
772ff3b9 | 11506 | |
ac4dd294 JH |
11507 | switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. |
11508 | ||
772ff3b9 JH |
11509 | params WHAT |
11510 | ||
ac4dd294 | 11511 | dump_names |
2ef53570 | 11512 | |
35bf961c JH |
11513 | dogfood |
11514 | ||
9038e305 | 11515 | C_constant, name, type, value, macro, default, pre, post, def_pre =item |
fa1c7b03 | 11516 | def_post, utf8 |
772ff3b9 JH |
11517 | |
11518 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME | |
11519 | ||
2ef53570 | 11520 | autoload PACKAGE, VERSION, AUTOLOADER |
772ff3b9 | 11521 | |
35bf961c JH |
11522 | WriteMakefileSnippet |
11523 | ||
9038e305 JH |
11524 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, |
11525 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME | |
11526 | ||
772ff3b9 JH |
11527 | =over 4 |
11528 | ||
11529 | =item AUTHOR | |
11530 | ||
11531 | =back | |
11532 | ||
8ebc5c01 | 11533 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
cb1a09d0 | 11534 | |
d420ca49 | 11535 | =over 4 |
a45bd81d | 11536 | |
cb1a09d0 AD |
11537 | =item SYNOPSIS |
11538 | ||
cb1a09d0 AD |
11539 | =item DESCRIPTION |
11540 | ||
8ebc5c01 | 11541 | =item @EXPORT |
cb1a09d0 | 11542 | |
8ebc5c01 | 11543 | =item FUNCTIONS |
cb1a09d0 | 11544 | |
8ebc5c01 | 11545 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
11546 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
cb1a09d0 | 11547 | |
8ebc5c01 | 11548 | =item EXAMPLES |
cb1a09d0 | 11549 | |
8ebc5c01 | 11550 | =item SEE ALSO |
cb1a09d0 | 11551 | |
8ebc5c01 | 11552 | =item AUTHOR |
cb1a09d0 | 11553 | |
a45bd81d GS |
11554 | =back |
11555 | ||
8ebc5c01 | 11556 | =head2 ExtUtils::Install - install files from here to there |
cb1a09d0 | 11557 | |
d420ca49 | 11558 | =over 4 |
a45bd81d | 11559 | |
8ebc5c01 | 11560 | =item SYNOPSIS |
cb1a09d0 | 11561 | |
8ebc5c01 | 11562 | =item DESCRIPTION |
cb1a09d0 | 11563 | |
a45bd81d GS |
11564 | =back |
11565 | ||
193fb0af GS |
11566 | =head2 ExtUtils::Installed - Inventory management of installed modules |
11567 | ||
d420ca49 | 11568 | =over 4 |
a45bd81d | 11569 | |
193fb0af GS |
11570 | =item SYNOPSIS |
11571 | ||
11572 | =item DESCRIPTION | |
11573 | ||
11574 | =item USAGE | |
11575 | ||
11576 | =item FUNCTIONS | |
11577 | ||
11578 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
11579 | packlist(), version() | |
11580 | ||
fb9cefb4 GS |
11581 | =item EXAMPLE |
11582 | ||
193fb0af GS |
11583 | =item AUTHOR |
11584 | ||
a45bd81d GS |
11585 | =back |
11586 | ||
8ebc5c01 | 11587 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
cb1a09d0 | 11588 | |
d420ca49 | 11589 | =over 4 |
a45bd81d | 11590 | |
8ebc5c01 | 11591 | =item SYNOPSIS |
cb1a09d0 | 11592 | |
8ebc5c01 | 11593 | =item DESCRIPTION |
cb1a09d0 | 11594 | |
8ebc5c01 | 11595 | For static extensions, For dynamic extensions, For dynamic extensions |
cb1a09d0 | 11596 | |
d420ca49 | 11597 | =over 4 |
cb1a09d0 | 11598 | |
8ebc5c01 | 11599 | =item EXTRALIBS |
cb1a09d0 | 11600 | |
8ebc5c01 | 11601 | =item LDLOADLIBS and LD_RUN_PATH |
cb1a09d0 | 11602 | |
8ebc5c01 | 11603 | =item BSLOADLIBS |
cb1a09d0 | 11604 | |
8ebc5c01 | 11605 | =back |
cb1a09d0 | 11606 | |
8ebc5c01 | 11607 | =item PORTABILITY |
cb1a09d0 | 11608 | |
d420ca49 | 11609 | =over 4 |
cb1a09d0 | 11610 | |
8ebc5c01 | 11611 | =item VMS implementation |
cb1a09d0 | 11612 | |
3e3baf6d TB |
11613 | =item Win32 implementation |
11614 | ||
8ebc5c01 | 11615 | =back |
cb1a09d0 | 11616 | |
8ebc5c01 | 11617 | =item SEE ALSO |
cb1a09d0 | 11618 | |
a45bd81d GS |
11619 | =back |
11620 | ||
f502af34 JH |
11621 | =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in |
11622 | ExtUtils::MakeMaker | |
11623 | ||
11624 | =over 4 | |
11625 | ||
11626 | =item SYNOPSIS | |
11627 | ||
11628 | =item DESCRIPTION | |
11629 | ||
11630 | =back | |
11631 | ||
11632 | perl_archive | |
11633 | ||
14218588 GS |
11634 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
11635 | ExtUtils::MakeMaker | |
11636 | ||
d420ca49 | 11637 | =over 4 |
a45bd81d | 11638 | |
14218588 GS |
11639 | =item SYNOPSIS |
11640 | ||
11641 | =item DESCRIPTION | |
11642 | ||
11643 | canonpath, cflags, manifypods, perl_archive | |
11644 | ||
a45bd81d GS |
11645 | =back |
11646 | ||
9038e305 JH |
11647 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in |
11648 | ExtUtils::MakeMaker | |
11649 | ||
11650 | =over 4 | |
11651 | ||
11652 | =item SYNOPSIS | |
11653 | ||
11654 | =item DESCRIPTION | |
11655 | ||
11656 | =back | |
11657 | ||
11658 | catfile | |
11659 | ||
11660 | constants (o) | |
11661 | ||
11662 | static_lib (o) | |
11663 | ||
11664 | dynamic_bs (o) | |
11665 | ||
11666 | dynamic_lib (o) | |
11667 | ||
11668 | canonpath | |
11669 | ||
11670 | perl_script | |
11671 | ||
11672 | pm_to_blib | |
11673 | ||
11674 | test_via_harness (o) | |
11675 | ||
11676 | tool_autosplit (override) | |
11677 | ||
11678 | tools_other (o) | |
11679 | ||
11680 | xs_o (o) | |
11681 | ||
11682 | top_targets (o) | |
11683 | ||
11684 | htmlifypods (o) | |
11685 | ||
11686 | manifypods (o) | |
11687 | ||
11688 | dist_ci (o) | |
11689 | ||
11690 | dist_core (o) | |
11691 | ||
11692 | pasthru (o) | |
11693 | ||
8ebc5c01 | 11694 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
11695 | ExtUtils::MakeMaker | |
cb1a09d0 | 11696 | |
d420ca49 | 11697 | =over 4 |
a45bd81d | 11698 | |
8ebc5c01 | 11699 | =item SYNOPSIS |
cb1a09d0 | 11700 | |
8ebc5c01 | 11701 | =item DESCRIPTION |
cb1a09d0 | 11702 | |
4d4e713d JH |
11703 | =item METHODS |
11704 | ||
a45bd81d GS |
11705 | =back |
11706 | ||
4d4e713d JH |
11707 | perl_archive_after |
11708 | ||
8ebc5c01 | 11709 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
cb1a09d0 | 11710 | |
d420ca49 | 11711 | =over 4 |
a45bd81d | 11712 | |
8ebc5c01 | 11713 | =item SYNOPSIS |
cb1a09d0 | 11714 | |
8ebc5c01 | 11715 | =item DESCRIPTION |
cb1a09d0 | 11716 | |
8ebc5c01 | 11717 | =item METHODS |
cb1a09d0 | 11718 | |
d420ca49 | 11719 | =over 4 |
cb1a09d0 | 11720 | |
8ebc5c01 | 11721 | =item Preloaded methods |
cb1a09d0 | 11722 | |
a45bd81d | 11723 | canonpath |
cb1a09d0 | 11724 | |
8ebc5c01 | 11725 | =back |
cb1a09d0 | 11726 | |
a45bd81d | 11727 | =back |
cb1a09d0 | 11728 | |
a45bd81d | 11729 | catdir |
cb1a09d0 | 11730 | |
a45bd81d | 11731 | catfile |
cb1a09d0 | 11732 | |
a45bd81d | 11733 | curdir |
cb1a09d0 | 11734 | |
a45bd81d | 11735 | rootdir |
cb1a09d0 | 11736 | |
a45bd81d | 11737 | updir |
cb1a09d0 | 11738 | |
d420ca49 | 11739 | =over 4 |
cb1a09d0 | 11740 | |
8ebc5c01 | 11741 | =item SelfLoaded methods |
cb1a09d0 | 11742 | |
a45bd81d | 11743 | c_o (o) |
cb1a09d0 | 11744 | |
8ebc5c01 | 11745 | =back |
cb1a09d0 | 11746 | |
a45bd81d | 11747 | cflags (o) |
68dc0745 | 11748 | |
a45bd81d | 11749 | clean (o) |
68dc0745 | 11750 | |
a45bd81d | 11751 | const_cccmd (o) |
68dc0745 | 11752 | |
a45bd81d | 11753 | const_config (o) |
68dc0745 | 11754 | |
a45bd81d | 11755 | const_loadlibs (o) |
cb1a09d0 | 11756 | |
a45bd81d | 11757 | constants (o) |
cb1a09d0 | 11758 | |
a45bd81d | 11759 | depend (o) |
cb1a09d0 | 11760 | |
a45bd81d | 11761 | dir_target (o) |
cb1a09d0 | 11762 | |
a45bd81d | 11763 | dist (o) |
cb1a09d0 | 11764 | |
a45bd81d | 11765 | dist_basics (o) |
cb1a09d0 | 11766 | |
a45bd81d | 11767 | dist_ci (o) |
cb1a09d0 | 11768 | |
a45bd81d | 11769 | dist_core (o) |
7d2bfb28 | 11770 | |
a45bd81d | 11771 | dist_dir (o) |
7d2bfb28 | 11772 | |
a45bd81d | 11773 | dist_test (o) |
7d2bfb28 | 11774 | |
a45bd81d | 11775 | dlsyms (o) |
7d2bfb28 | 11776 | |
a45bd81d | 11777 | dynamic (o) |
7d2bfb28 | 11778 | |
a45bd81d | 11779 | dynamic_bs (o) |
7d2bfb28 | 11780 | |
a45bd81d | 11781 | dynamic_lib (o) |
7d2bfb28 | 11782 | |
a45bd81d | 11783 | exescan |
cb1a09d0 | 11784 | |
a45bd81d | 11785 | extliblist |
cb1a09d0 | 11786 | |
a45bd81d | 11787 | file_name_is_absolute |
cb1a09d0 | 11788 | |
a45bd81d | 11789 | find_perl |
cb1a09d0 | 11790 | |
d420ca49 | 11791 | =over 4 |
cb1a09d0 | 11792 | |
a45bd81d | 11793 | =item Methods to actually produce chunks of text for the Makefile |
cb1a09d0 | 11794 | |
a45bd81d | 11795 | fixin |
cb1a09d0 | 11796 | |
a45bd81d | 11797 | =back |
cb1a09d0 | 11798 | |
a45bd81d | 11799 | force (o) |
d516a115 | 11800 | |
a45bd81d | 11801 | guess_name |
cb1a09d0 | 11802 | |
a45bd81d | 11803 | has_link_code |
14218588 | 11804 | |
a45bd81d | 11805 | htmlifypods (o) |
14218588 | 11806 | |
a45bd81d | 11807 | init_dirscan |
cb1a09d0 | 11808 | |
a45bd81d | 11809 | init_main |
cb1a09d0 | 11810 | |
a45bd81d | 11811 | init_others |
cb1a09d0 | 11812 | |
a45bd81d | 11813 | install (o) |
cb1a09d0 | 11814 | |
a45bd81d | 11815 | installbin (o) |
cb1a09d0 | 11816 | |
a45bd81d | 11817 | libscan (o) |
cb1a09d0 | 11818 | |
a45bd81d | 11819 | linkext (o) |
cb1a09d0 | 11820 | |
a45bd81d | 11821 | lsdir |
cb1a09d0 | 11822 | |
a45bd81d | 11823 | macro (o) |
cb1a09d0 | 11824 | |
a45bd81d | 11825 | makeaperl (o) |
cb1a09d0 | 11826 | |
a45bd81d | 11827 | makefile (o) |
cb1a09d0 | 11828 | |
a45bd81d | 11829 | manifypods (o) |
cb1a09d0 | 11830 | |
a45bd81d | 11831 | maybe_command |
14218588 | 11832 | |
a45bd81d | 11833 | maybe_command_in_dirs |
14218588 | 11834 | |
a45bd81d | 11835 | needs_linking (o) |
14218588 | 11836 | |
a45bd81d | 11837 | nicetext |
14218588 | 11838 | |
a45bd81d | 11839 | parse_version |
cb1a09d0 | 11840 | |
a45bd81d | 11841 | parse_abstract |
cb1a09d0 | 11842 | |
a45bd81d | 11843 | pasthru (o) |
cb1a09d0 | 11844 | |
a45bd81d | 11845 | path |
cb1a09d0 | 11846 | |
a45bd81d | 11847 | perl_script |
cb1a09d0 | 11848 | |
a45bd81d | 11849 | perldepend (o) |
402d0d99 | 11850 | |
a45bd81d | 11851 | ppd |
402d0d99 | 11852 | |
a45bd81d | 11853 | perm_rw (o) |
402d0d99 | 11854 | |
a45bd81d | 11855 | perm_rwx (o) |
402d0d99 | 11856 | |
a45bd81d | 11857 | pm_to_blib |
193fb0af | 11858 | |
a45bd81d | 11859 | post_constants (o) |
193fb0af | 11860 | |
a45bd81d | 11861 | post_initialize (o) |
193fb0af | 11862 | |
a45bd81d | 11863 | postamble (o) |
193fb0af | 11864 | |
a45bd81d | 11865 | prefixify |
193fb0af | 11866 | |
a45bd81d | 11867 | processPL (o) |
193fb0af | 11868 | |
cb52f95f JH |
11869 | quote_paren |
11870 | ||
a45bd81d | 11871 | realclean (o) |
fb9cefb4 | 11872 | |
a45bd81d | 11873 | replace_manpage_separator |
193fb0af | 11874 | |
a45bd81d | 11875 | static (o) |
cb1a09d0 | 11876 | |
a45bd81d GS |
11877 | static_lib (o) |
11878 | ||
11879 | staticmake (o) | |
11880 | ||
11881 | subdir_x (o) | |
11882 | ||
11883 | subdirs (o) | |
11884 | ||
11885 | test (o) | |
11886 | ||
11887 | test_via_harness (o) | |
11888 | ||
11889 | test_via_script (o) | |
11890 | ||
11891 | tool_autosplit (o) | |
11892 | ||
11893 | tools_other (o) | |
11894 | ||
11895 | tool_xsubpp (o) | |
11896 | ||
11897 | top_targets (o) | |
11898 | ||
11899 | writedoc | |
11900 | ||
11901 | xs_c (o) | |
11902 | ||
11903 | xs_cpp (o) | |
11904 | ||
11905 | xs_o (o) | |
11906 | ||
11907 | perl_archive | |
11908 | ||
fc6a272d JH |
11909 | perl_archive_after |
11910 | ||
a45bd81d GS |
11911 | export_list |
11912 | ||
d420ca49 | 11913 | =over 4 |
a45bd81d GS |
11914 | |
11915 | =item SEE ALSO | |
11916 | ||
11917 | =back | |
11918 | ||
11919 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
11920 | ExtUtils::MakeMaker | |
11921 | ||
d420ca49 | 11922 | =over 4 |
a45bd81d GS |
11923 | |
11924 | =item SYNOPSIS | |
11925 | ||
11926 | =item DESCRIPTION | |
11927 | ||
d420ca49 | 11928 | =over 4 |
a45bd81d GS |
11929 | |
11930 | =item Methods always loaded | |
11931 | ||
11932 | wraplist | |
11933 | ||
11934 | =back | |
11935 | ||
11936 | =back | |
11937 | ||
11938 | rootdir (override) | |
11939 | ||
d420ca49 | 11940 | =over 4 |
a45bd81d GS |
11941 | |
11942 | =item SelfLoaded methods | |
11943 | ||
11944 | guess_name (override) | |
11945 | ||
11946 | =back | |
11947 | ||
11948 | find_perl (override) | |
11949 | ||
11950 | path (override) | |
11951 | ||
11952 | maybe_command (override) | |
11953 | ||
11954 | maybe_command_in_dirs (override) | |
11955 | ||
11956 | perl_script (override) | |
11957 | ||
11958 | file_name_is_absolute (override) | |
11959 | ||
11960 | replace_manpage_separator | |
11961 | ||
11962 | init_others (override) | |
11963 | ||
11964 | constants (override) | |
11965 | ||
11966 | cflags (override) | |
11967 | ||
11968 | const_cccmd (override) | |
11969 | ||
11970 | pm_to_blib (override) | |
11971 | ||
11972 | tool_autosplit (override) | |
11973 | ||
11974 | tool_sxubpp (override) | |
11975 | ||
11976 | xsubpp_version (override) | |
11977 | ||
11978 | tools_other (override) | |
11979 | ||
11980 | dist (override) | |
11981 | ||
11982 | c_o (override) | |
11983 | ||
11984 | xs_c (override) | |
11985 | ||
11986 | xs_o (override) | |
11987 | ||
11988 | top_targets (override) | |
11989 | ||
11990 | dlsyms (override) | |
11991 | ||
11992 | dynamic_lib (override) | |
11993 | ||
11994 | dynamic_bs (override) | |
11995 | ||
11996 | static_lib (override) | |
11997 | ||
11998 | manifypods (override) | |
11999 | ||
12000 | processPL (override) | |
12001 | ||
12002 | installbin (override) | |
12003 | ||
12004 | subdir_x (override) | |
12005 | ||
12006 | clean (override) | |
12007 | ||
12008 | realclean (override) | |
12009 | ||
12010 | dist_basics (override) | |
12011 | ||
12012 | dist_core (override) | |
12013 | ||
12014 | dist_dir (override) | |
12015 | ||
12016 | dist_test (override) | |
12017 | ||
12018 | install (override) | |
12019 | ||
12020 | perldepend (override) | |
12021 | ||
12022 | makefile (override) | |
12023 | ||
12024 | test (override) | |
12025 | ||
12026 | test_via_harness (override) | |
12027 | ||
12028 | test_via_script (override) | |
12029 | ||
12030 | makeaperl (override) | |
12031 | ||
12032 | nicetext (override) | |
12033 | ||
12034 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in | |
12035 | ExtUtils::MakeMaker | |
12036 | ||
d420ca49 | 12037 | =over 4 |
a45bd81d GS |
12038 | |
12039 | =item SYNOPSIS | |
12040 | ||
12041 | =item DESCRIPTION | |
12042 | ||
12043 | =back | |
12044 | ||
12045 | catfile | |
12046 | ||
12047 | constants (o) | |
12048 | ||
12049 | static_lib (o) | |
12050 | ||
12051 | dynamic_bs (o) | |
12052 | ||
12053 | dynamic_lib (o) | |
12054 | ||
12055 | canonpath | |
12056 | ||
12057 | perl_script | |
12058 | ||
12059 | pm_to_blib | |
12060 | ||
12061 | test_via_harness (o) | |
12062 | ||
12063 | tool_autosplit (override) | |
12064 | ||
12065 | tools_other (o) | |
12066 | ||
12067 | xs_o (o) | |
12068 | ||
12069 | top_targets (o) | |
12070 | ||
12071 | htmlifypods (o) | |
12072 | ||
12073 | manifypods (o) | |
12074 | ||
12075 | dist_ci (o) | |
12076 | ||
12077 | dist_core (o) | |
12078 | ||
12079 | pasthru (o) | |
12080 | ||
12081 | =head2 ExtUtils::MakeMaker - create an extension Makefile | |
12082 | ||
d420ca49 | 12083 | =over 4 |
a45bd81d GS |
12084 | |
12085 | =item SYNOPSIS | |
12086 | ||
12087 | =item DESCRIPTION | |
12088 | ||
d420ca49 | 12089 | =over 4 |
a45bd81d GS |
12090 | |
12091 | =item How To Write A Makefile.PL | |
12092 | ||
12093 | =item Default Makefile Behaviour | |
12094 | ||
12095 | =item make test | |
12096 | ||
12097 | =item make testdb | |
12098 | ||
12099 | =item make install | |
12100 | ||
12101 | =item PREFIX and LIB attribute | |
12102 | ||
12103 | =item AFS users | |
12104 | ||
12105 | =item Static Linking of a new Perl Binary | |
12106 | ||
12107 | =item Determination of Perl Library and Installation Locations | |
12108 | ||
12109 | =item Which architecture dependent directory? | |
12110 | ||
12111 | =item Using Attributes and Parameters | |
12112 | ||
53d7eaa8 | 12113 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, |
a45bd81d GS |
12114 | CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, |
12115 | EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS, | |
12116 | HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, | |
12117 | INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR, | |
12118 | INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, | |
12119 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, | |
a7ffa9b9 NC |
12120 | INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR, |
12121 | INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, | |
12122 | MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, | |
389925df JH |
12123 | NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, |
12124 | PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW, | |
12125 | PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, | |
cb52f95f JH |
12126 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, |
12127 | PRINT_PREREQ, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT, | |
12128 | XSPROTOARG, XS_VERSION | |
a45bd81d GS |
12129 | |
12130 | =item Additional lowercase attributes | |
12131 | ||
12132 | clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, | |
12133 | tool_autosplit | |
12134 | ||
12135 | =item Overriding MakeMaker Methods | |
12136 | ||
12137 | =item Hintsfile support | |
12138 | ||
12139 | =item Distribution Support | |
12140 | ||
12141 | make distcheck, make skipcheck, make distclean, make manifest, | |
12142 | make distdir, make tardist, make dist, make uutardist, make | |
12143 | shdist, make zipdist, make ci | |
12144 | ||
12145 | =item Disabling an extension | |
12146 | ||
12147 | =back | |
12148 | ||
12149 | =item ENVIRONMENT | |
12150 | ||
1fdc5aa6 | 12151 | PERL_MM_OPT, PERL_MM_USE_DEFAULT |
a45bd81d GS |
12152 | |
12153 | =item SEE ALSO | |
12154 | ||
12155 | =item AUTHORS | |
12156 | ||
12157 | =back | |
12158 | ||
12159 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file | |
12160 | ||
d420ca49 | 12161 | =over 4 |
a45bd81d GS |
12162 | |
12163 | =item SYNOPSIS | |
12164 | ||
12165 | =item DESCRIPTION | |
12166 | ||
12167 | =item MANIFEST.SKIP | |
12168 | ||
12169 | =item EXPORT_OK | |
12170 | ||
12171 | =item GLOBAL VARIABLES | |
12172 | ||
12173 | =item DIAGNOSTICS | |
12174 | ||
12175 | C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>, | |
12176 | C<Added to MANIFEST:> I<file> | |
12177 | ||
165c0277 JH |
12178 | =item ENVIRONMENT |
12179 | ||
12180 | B<PERL_MM_MANIFEST_DEBUG> | |
12181 | ||
a45bd81d GS |
12182 | =item SEE ALSO |
12183 | ||
12184 | =item AUTHOR | |
12185 | ||
12186 | =back | |
12187 | ||
a45bd81d GS |
12188 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader |
12189 | ||
d420ca49 | 12190 | =over 4 |
a45bd81d GS |
12191 | |
12192 | =item SYNOPSIS | |
cb1a09d0 | 12193 | |
8ebc5c01 | 12194 | =item DESCRIPTION |
402d0d99 | 12195 | |
a45bd81d GS |
12196 | =back |
12197 | ||
12198 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
12199 | extension | |
12200 | ||
d420ca49 | 12201 | =over 4 |
a45bd81d GS |
12202 | |
12203 | =item SYNOPSIS | |
12204 | ||
12205 | =item DESCRIPTION | |
12206 | ||
12207 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
12208 | ||
12209 | =item AUTHOR | |
12210 | ||
12211 | =item REVISION | |
12212 | ||
12213 | =back | |
12214 | ||
12215 | =head2 ExtUtils::Packlist - manage .packlist files | |
12216 | ||
d420ca49 | 12217 | =over 4 |
a45bd81d GS |
12218 | |
12219 | =item SYNOPSIS | |
12220 | ||
12221 | =item DESCRIPTION | |
12222 | ||
12223 | =item USAGE | |
12224 | ||
12225 | =item FUNCTIONS | |
12226 | ||
12227 | new(), read(), write(), validate(), packlist_file() | |
12228 | ||
12229 | =item EXAMPLE | |
12230 | ||
12231 | =item AUTHOR | |
12232 | ||
12233 | =back | |
12234 | ||
12235 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
12236 | ||
d420ca49 | 12237 | =over 4 |
a45bd81d GS |
12238 | |
12239 | =item SYNOPSIS | |
12240 | ||
12241 | =item DESCRIPTION | |
12242 | ||
12243 | =back | |
12244 | ||
d516a115 JH |
12245 | =head2 Fatal - replace functions with equivalents which succeed or die |
12246 | ||
d420ca49 | 12247 | =over 4 |
a45bd81d | 12248 | |
d516a115 JH |
12249 | =item SYNOPSIS |
12250 | ||
12251 | =item DESCRIPTION | |
12252 | ||
12253 | =item AUTHOR | |
12254 | ||
a45bd81d GS |
12255 | =back |
12256 | ||
8ebc5c01 | 12257 | =head2 Fcntl - load the C Fcntl.h defines |
cb1a09d0 | 12258 | |
d420ca49 | 12259 | =over 4 |
a45bd81d | 12260 | |
8ebc5c01 | 12261 | =item SYNOPSIS |
cb1a09d0 | 12262 | |
8ebc5c01 | 12263 | =item DESCRIPTION |
cb1a09d0 | 12264 | |
8ebc5c01 | 12265 | =item NOTE |
cb1a09d0 | 12266 | |
8ebc5c01 | 12267 | =item EXPORTED SYMBOLS |
cb1a09d0 | 12268 | |
a45bd81d GS |
12269 | =back |
12270 | ||
8ebc5c01 | 12271 | =head2 File::Basename, fileparse - split a pathname into pieces |
7d2bfb28 | 12272 | |
d420ca49 | 12273 | =over 4 |
a45bd81d | 12274 | |
7d2bfb28 | 12275 | =item SYNOPSIS |
12276 | ||
7d2bfb28 | 12277 | =item DESCRIPTION |
12278 | ||
8ebc5c01 | 12279 | fileparse_set_fstype, fileparse |
7d2bfb28 | 12280 | |
8ebc5c01 | 12281 | =item EXAMPLES |
7d2bfb28 | 12282 | |
8ebc5c01 | 12283 | C<basename>, C<dirname> |
7d2bfb28 | 12284 | |
a45bd81d GS |
12285 | =back |
12286 | ||
8ebc5c01 | 12287 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
cb1a09d0 | 12288 | |
d420ca49 | 12289 | =over 4 |
a45bd81d | 12290 | |
cb1a09d0 AD |
12291 | =item SYNOPSIS |
12292 | ||
cb1a09d0 AD |
12293 | =item DESCRIPTION |
12294 | ||
a45bd81d GS |
12295 | =back |
12296 | ||
8ebc5c01 | 12297 | =head2 File::Compare - Compare files or filehandles |
cb1a09d0 | 12298 | |
d420ca49 | 12299 | =over 4 |
a45bd81d | 12300 | |
8ebc5c01 | 12301 | =item SYNOPSIS |
cb1a09d0 | 12302 | |
8ebc5c01 | 12303 | =item DESCRIPTION |
cb1a09d0 | 12304 | |
8ebc5c01 | 12305 | =item RETURN |
cb1a09d0 | 12306 | |
8ebc5c01 | 12307 | =item AUTHOR |
cb1a09d0 | 12308 | |
a45bd81d GS |
12309 | =back |
12310 | ||
8ebc5c01 | 12311 | =head2 File::Copy - Copy files or filehandles |
cb1a09d0 | 12312 | |
d420ca49 | 12313 | =over 4 |
a45bd81d | 12314 | |
8ebc5c01 | 12315 | =item SYNOPSIS |
cb1a09d0 | 12316 | |
8ebc5c01 | 12317 | =item DESCRIPTION |
cb1a09d0 | 12318 | |
d420ca49 | 12319 | =over 4 |
cb1a09d0 | 12320 | |
14218588 | 12321 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
cb1a09d0 | 12322 | |
8ebc5c01 | 12323 | rmscopy($from,$to[,$date_flag]) |
cb1a09d0 AD |
12324 | |
12325 | =back | |
12326 | ||
8ebc5c01 | 12327 | =item RETURN |
cb1a09d0 | 12328 | |
ac4dd294 JH |
12329 | =item NOTES |
12330 | ||
8ebc5c01 | 12331 | =item AUTHOR |
cb1a09d0 | 12332 | |
a45bd81d GS |
12333 | =back |
12334 | ||
3e3baf6d TB |
12335 | =head2 File::DosGlob - DOS like globbing and then some |
12336 | ||
d420ca49 | 12337 | =over 4 |
a45bd81d | 12338 | |
3e3baf6d TB |
12339 | =item SYNOPSIS |
12340 | ||
12341 | =item DESCRIPTION | |
12342 | ||
35bf961c JH |
12343 | =item NOTES |
12344 | ||
3e3baf6d TB |
12345 | =item EXPORTS (by request only) |
12346 | ||
12347 | =item BUGS | |
12348 | ||
12349 | =item AUTHOR | |
12350 | ||
12351 | =item HISTORY | |
12352 | ||
12353 | =item SEE ALSO | |
12354 | ||
a45bd81d GS |
12355 | =back |
12356 | ||
f502af34 | 12357 | =head2 File::Find - Traverse a directory tree. |
cb1a09d0 | 12358 | |
d420ca49 | 12359 | =over 4 |
a45bd81d | 12360 | |
8ebc5c01 | 12361 | =item SYNOPSIS |
cb1a09d0 | 12362 | |
8ebc5c01 | 12363 | =item DESCRIPTION |
cb1a09d0 | 12364 | |
f502af34 JH |
12365 | B<find>, B<finddepth> |
12366 | ||
12367 | =over 4 | |
12368 | ||
12369 | =item %options | |
12370 | ||
10862624 | 12371 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, |
5d80033a JH |
12372 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, |
12373 | C<untaint>, C<untaint_pattern>, C<untaint_skip> | |
a45bd81d | 12374 | |
f502af34 JH |
12375 | =item The wanted function |
12376 | ||
12377 | C<$File::Find::dir> is the current directory name,, C<$_> is the current | |
12378 | filename within that directory, C<$File::Find::name> is the complete | |
12379 | pathname to the file | |
12380 | ||
12381 | =back | |
12382 | ||
cb52f95f JH |
12383 | =item WARNINGS |
12384 | ||
a45bd81d GS |
12385 | =item CAVEAT |
12386 | ||
1fdc5aa6 JH |
12387 | $dont_use_nlink, symlinks |
12388 | ||
ac4dd294 JH |
12389 | =item NOTES |
12390 | ||
9038e305 JH |
12391 | =item HISTORY |
12392 | ||
a45bd81d GS |
12393 | =back |
12394 | ||
12395 | =head2 File::Glob - Perl extension for BSD glob routine | |
d516a115 | 12396 | |
d420ca49 | 12397 | =over 4 |
a45bd81d GS |
12398 | |
12399 | =item SYNOPSIS | |
12400 | ||
12401 | =item DESCRIPTION | |
12402 | ||
41ca3a40 JH |
12403 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, |
12404 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, | |
12405 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> | |
a45bd81d GS |
12406 | |
12407 | =item DIAGNOSTICS | |
12408 | ||
12409 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
12410 | ||
12411 | =item NOTES | |
12412 | ||
12413 | =item AUTHOR | |
12414 | ||
12415 | =back | |
12416 | ||
12417 | =head2 File::Path - create or remove directory trees | |
12418 | ||
d420ca49 | 12419 | =over 4 |
cb1a09d0 | 12420 | |
8ebc5c01 | 12421 | =item SYNOPSIS |
7d2bfb28 | 12422 | |
12423 | =item DESCRIPTION | |
12424 | ||
8ebc5c01 | 12425 | =item AUTHORS |
7d2bfb28 | 12426 | |
a45bd81d GS |
12427 | =back |
12428 | ||
fb9cefb4 GS |
12429 | =head2 File::Spec - portably perform operations on file names |
12430 | ||
d420ca49 | 12431 | =over 4 |
a45bd81d | 12432 | |
fb9cefb4 GS |
12433 | =item SYNOPSIS |
12434 | ||
12435 | =item DESCRIPTION | |
12436 | ||
53d7eaa8 JH |
12437 | =item METHODS |
12438 | ||
12439 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, | |
12440 | no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, | |
35bf961c | 12441 | splitdir, catpath(), abs2rel, rel2abs() |
53d7eaa8 | 12442 | |
fb9cefb4 GS |
12443 | =item SEE ALSO |
12444 | ||
12445 | =item AUTHORS | |
12446 | ||
a45bd81d GS |
12447 | =back |
12448 | ||
04b01f78 JH |
12449 | =head2 File::Spec::Cygwin - methods for Cygwin file specs |
12450 | ||
12451 | =over 4 | |
12452 | ||
12453 | =item SYNOPSIS | |
12454 | ||
12455 | =item DESCRIPTION | |
12456 | ||
12457 | =back | |
12458 | ||
2cc61e15 DD |
12459 | =head2 File::Spec::Epoc - methods for Epoc file specs |
12460 | ||
12461 | =over 4 | |
12462 | ||
12463 | =item SYNOPSIS | |
12464 | ||
12465 | =item DESCRIPTION | |
12466 | ||
35bf961c | 12467 | canonpath() |
2cc61e15 | 12468 | |
fa1c7b03 | 12469 | =back |
2cc61e15 DD |
12470 | |
12471 | =over 4 | |
12472 | ||
12473 | =item SEE ALSO | |
12474 | ||
12475 | =back | |
12476 | ||
14218588 GS |
12477 | =head2 File::Spec::Functions - portably perform operations on file names |
12478 | ||
d420ca49 | 12479 | =over 4 |
a45bd81d | 12480 | |
14218588 GS |
12481 | =item SYNOPSIS |
12482 | ||
12483 | =item DESCRIPTION | |
12484 | ||
d420ca49 | 12485 | =over 4 |
14218588 GS |
12486 | |
12487 | =item Exports | |
12488 | ||
12489 | =back | |
12490 | ||
12491 | =item SEE ALSO | |
12492 | ||
a45bd81d GS |
12493 | =back |
12494 | ||
35bf961c | 12495 | =head2 File::Spec::Mac - File::Spec for Mac OS (Classic) |
fb9cefb4 | 12496 | |
d420ca49 | 12497 | =over 4 |
a45bd81d | 12498 | |
fb9cefb4 GS |
12499 | =item SYNOPSIS |
12500 | ||
12501 | =item DESCRIPTION | |
12502 | ||
12503 | =item METHODS | |
12504 | ||
a45bd81d GS |
12505 | canonpath |
12506 | ||
12507 | =back | |
12508 | ||
35bf961c | 12509 | catdir() |
a45bd81d GS |
12510 | |
12511 | catfile | |
12512 | ||
12513 | curdir | |
12514 | ||
12515 | devnull | |
12516 | ||
12517 | rootdir | |
12518 | ||
12519 | tmpdir | |
12520 | ||
12521 | updir | |
12522 | ||
12523 | file_name_is_absolute | |
12524 | ||
12525 | path | |
12526 | ||
694468e3 GS |
12527 | splitpath |
12528 | ||
12529 | splitdir | |
12530 | ||
1fdc5aa6 | 12531 | catpath |
694468e3 GS |
12532 | |
12533 | abs2rel | |
12534 | ||
12535 | rel2abs | |
12536 | ||
d420ca49 | 12537 | =over 4 |
fb9cefb4 | 12538 | |
35bf961c JH |
12539 | =item AUTHORS |
12540 | ||
fb9cefb4 GS |
12541 | =item SEE ALSO |
12542 | ||
a45bd81d GS |
12543 | =back |
12544 | ||
04b01f78 JH |
12545 | canonpath |
12546 | ||
12547 | splitpath | |
12548 | ||
12549 | splitdir | |
12550 | ||
12551 | catpath | |
12552 | ||
fb9cefb4 GS |
12553 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
12554 | ||
d420ca49 | 12555 | =over 4 |
a45bd81d | 12556 | |
fb9cefb4 GS |
12557 | =item SYNOPSIS |
12558 | ||
12559 | =item DESCRIPTION | |
12560 | ||
a45bd81d GS |
12561 | =back |
12562 | ||
53d7eaa8 JH |
12563 | =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec |
12564 | modules | |
fb9cefb4 | 12565 | |
d420ca49 | 12566 | =over 4 |
a45bd81d | 12567 | |
fb9cefb4 GS |
12568 | =item SYNOPSIS |
12569 | ||
12570 | =item DESCRIPTION | |
12571 | ||
12572 | =item METHODS | |
12573 | ||
35bf961c | 12574 | canonpath() |
a45bd81d GS |
12575 | |
12576 | =back | |
12577 | ||
35bf961c | 12578 | catdir() |
a45bd81d GS |
12579 | |
12580 | catfile | |
12581 | ||
12582 | curdir | |
12583 | ||
12584 | devnull | |
12585 | ||
12586 | rootdir | |
12587 | ||
12588 | tmpdir | |
12589 | ||
12590 | updir | |
12591 | ||
12592 | no_upwards | |
12593 | ||
694468e3 GS |
12594 | case_tolerant |
12595 | ||
a45bd81d GS |
12596 | file_name_is_absolute |
12597 | ||
12598 | path | |
12599 | ||
12600 | join | |
12601 | ||
12602 | splitpath | |
12603 | ||
12604 | splitdir | |
12605 | ||
35bf961c | 12606 | catpath() |
a45bd81d GS |
12607 | |
12608 | abs2rel | |
12609 | ||
35bf961c | 12610 | rel2abs() |
a45bd81d | 12611 | |
d420ca49 | 12612 | =over 4 |
fb9cefb4 GS |
12613 | |
12614 | =item SEE ALSO | |
12615 | ||
a45bd81d GS |
12616 | =back |
12617 | ||
fb9cefb4 GS |
12618 | =head2 File::Spec::VMS - methods for VMS file specs |
12619 | ||
d420ca49 | 12620 | =over 4 |
a45bd81d | 12621 | |
fb9cefb4 GS |
12622 | =item SYNOPSIS |
12623 | ||
12624 | =item DESCRIPTION | |
12625 | ||
a45bd81d GS |
12626 | eliminate_macros |
12627 | ||
12628 | =back | |
12629 | ||
12630 | fixpath | |
c76ac1ee | 12631 | |
d420ca49 | 12632 | =over 4 |
fb9cefb4 GS |
12633 | |
12634 | =item Methods always loaded | |
12635 | ||
694468e3 | 12636 | canonpath (override) |
fb9cefb4 GS |
12637 | |
12638 | =back | |
12639 | ||
694468e3 GS |
12640 | catdir |
12641 | ||
a45bd81d GS |
12642 | catfile |
12643 | ||
12644 | curdir (override) | |
12645 | ||
12646 | devnull (override) | |
12647 | ||
12648 | rootdir (override) | |
12649 | ||
12650 | tmpdir (override) | |
12651 | ||
12652 | updir (override) | |
12653 | ||
694468e3 GS |
12654 | case_tolerant (override) |
12655 | ||
a45bd81d GS |
12656 | path (override) |
12657 | ||
12658 | file_name_is_absolute (override) | |
12659 | ||
694468e3 GS |
12660 | splitpath (override) |
12661 | ||
12662 | splitdir (override) | |
12663 | ||
12664 | catpath (override) | |
12665 | ||
37590e52 GS |
12666 | abs2rel (override) |
12667 | ||
12668 | rel2abs (override) | |
12669 | ||
d420ca49 | 12670 | =over 4 |
a45bd81d | 12671 | |
14218588 GS |
12672 | =item SEE ALSO |
12673 | ||
a45bd81d GS |
12674 | =back |
12675 | ||
fb9cefb4 GS |
12676 | =head2 File::Spec::Win32 - methods for Win32 file specs |
12677 | ||
d420ca49 | 12678 | =over 4 |
a45bd81d | 12679 | |
fb9cefb4 GS |
12680 | =item SYNOPSIS |
12681 | ||
12682 | =item DESCRIPTION | |
12683 | ||
a45bd81d GS |
12684 | devnull |
12685 | ||
12686 | =back | |
12687 | ||
12688 | tmpdir | |
12689 | ||
12690 | catfile | |
12691 | ||
12692 | canonpath | |
12693 | ||
12694 | splitpath | |
12695 | ||
12696 | splitdir | |
12697 | ||
12698 | catpath | |
12699 | ||
d420ca49 | 12700 | =over 4 |
a45bd81d | 12701 | |
14218588 | 12702 | =item SEE ALSO |
fb9cefb4 | 12703 | |
a45bd81d GS |
12704 | =back |
12705 | ||
d722968f JH |
12706 | =head2 File::Temp - return name and handle of a temporary file safely |
12707 | ||
d420ca49 | 12708 | =over 4 |
d722968f | 12709 | |
a9ef4385 JH |
12710 | =item PORTABILITY |
12711 | ||
d722968f JH |
12712 | =item SYNOPSIS |
12713 | ||
12714 | =item DESCRIPTION | |
12715 | ||
12716 | =back | |
12717 | ||
d420ca49 | 12718 | =over 4 |
d722968f JH |
12719 | |
12720 | =item FUNCTIONS | |
12721 | ||
12722 | B<tempfile> | |
12723 | ||
12724 | =back | |
12725 | ||
12726 | B<tempdir> | |
12727 | ||
d420ca49 | 12728 | =over 4 |
d722968f JH |
12729 | |
12730 | =item MKTEMP FUNCTIONS | |
12731 | ||
12732 | B<mkstemp> | |
12733 | ||
12734 | =back | |
12735 | ||
12736 | B<mkstemps> | |
12737 | ||
12738 | B<mkdtemp> | |
12739 | ||
12740 | B<mktemp> | |
12741 | ||
d420ca49 | 12742 | =over 4 |
d722968f JH |
12743 | |
12744 | =item POSIX FUNCTIONS | |
12745 | ||
12746 | B<tmpnam> | |
12747 | ||
12748 | =back | |
12749 | ||
12750 | B<tmpfile> | |
12751 | ||
d420ca49 | 12752 | =over 4 |
d722968f JH |
12753 | |
12754 | =item ADDITIONAL FUNCTIONS | |
12755 | ||
12756 | B<tempnam> | |
12757 | ||
12758 | =back | |
12759 | ||
d420ca49 | 12760 | =over 4 |
d722968f JH |
12761 | |
12762 | =item UTILITY FUNCTIONS | |
12763 | ||
12764 | B<unlink0> | |
12765 | ||
12766 | =back | |
12767 | ||
d420ca49 | 12768 | =over 4 |
d722968f JH |
12769 | |
12770 | =item PACKAGE VARIABLES | |
12771 | ||
12772 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
12773 | ||
12774 | =back | |
12775 | ||
12776 | TopSystemUID | |
12777 | ||
d420ca49 | 12778 | =over 4 |
d722968f JH |
12779 | |
12780 | =item WARNING | |
12781 | ||
165c0277 JH |
12782 | =over 4 |
12783 | ||
12784 | =item Temporary files and NFS | |
12785 | ||
12786 | =back | |
12787 | ||
4755096e GS |
12788 | =item HISTORY |
12789 | ||
12790 | =item SEE ALSO | |
12791 | ||
12792 | =item AUTHOR | |
12793 | ||
12794 | =back | |
12795 | ||
12796 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
12797 | ||
d420ca49 | 12798 | =over 4 |
4755096e GS |
12799 | |
12800 | =item SYNOPSIS | |
12801 | ||
12802 | =item DESCRIPTION | |
12803 | ||
12804 | =item NOTE | |
12805 | ||
12806 | =item AUTHOR | |
12807 | ||
12808 | =back | |
12809 | ||
12810 | =head2 FileCache - keep more files open than the system permits | |
12811 | ||
d420ca49 | 12812 | =over 4 |
4755096e GS |
12813 | |
12814 | =item SYNOPSIS | |
12815 | ||
12816 | =item DESCRIPTION | |
12817 | ||
12818 | =item BUGS | |
12819 | ||
12820 | =back | |
12821 | ||
12822 | =head2 FileHandle - supply object methods for filehandles | |
12823 | ||
d420ca49 | 12824 | =over 4 |
4755096e GS |
12825 | |
12826 | =item SYNOPSIS | |
12827 | ||
12828 | =item DESCRIPTION | |
12829 | ||
12830 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
12831 | ||
12832 | =item SEE ALSO | |
12833 | ||
12834 | =back | |
12835 | ||
165c0277 JH |
12836 | =head2 Filter::Simple - Simplified source filtering |
12837 | ||
12838 | =over 4 | |
12839 | ||
12840 | =item SYNOPSIS | |
12841 | ||
12842 | =item DESCRIPTION | |
12843 | ||
12844 | =over 4 | |
12845 | ||
12846 | =item The Problem | |
12847 | ||
12848 | =item A Solution | |
12849 | ||
1fa7ca25 JH |
12850 | =item Disabling or changing <no> behaviour |
12851 | ||
12852 | =item All-in-one interface | |
12853 | ||
07fcf8ff JH |
12854 | =item Filtering only specific components of source code |
12855 | ||
12856 | C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">, | |
12857 | C<"all"> | |
12858 | ||
12859 | =item Filtering only the code parts of source code | |
12860 | ||
12861 | Most source code ceases to be grammatically correct when it is broken up | |
12862 | into the pieces between string literals and regexes. So the C<'code'> | |
12863 | component filter behaves slightly differently from the other partial | |
12864 | filters | |
12865 | described in the previous section. | |
12866 | ||
34babc16 JH |
12867 | =item Using Filter::Simple with an explicit C<import> subroutine |
12868 | ||
53d7eaa8 JH |
12869 | =item Using Filter::Simple and Exporter together |
12870 | ||
165c0277 JH |
12871 | =item How it works |
12872 | ||
12873 | =back | |
12874 | ||
12875 | =item AUTHOR | |
12876 | ||
12877 | =item COPYRIGHT | |
12878 | ||
12879 | =back | |
12880 | ||
12881 | =head2 Filter::Util::Call - Perl Source Filter Utility Module | |
12882 | ||
12883 | =over 4 | |
12884 | ||
ab648d5e JH |
12885 | =item SYNOPSIS |
12886 | ||
165c0277 JH |
12887 | =item DESCRIPTION |
12888 | ||
12889 | =over 4 | |
12890 | ||
12891 | =item B<use Filter::Util::Call> | |
12892 | ||
12893 | =item B<import()> | |
12894 | ||
12895 | =item B<filter() and anonymous sub> | |
12896 | ||
12897 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> | |
12898 | ||
12899 | =back | |
12900 | ||
12901 | =item EXAMPLES | |
12902 | ||
12903 | =over 4 | |
12904 | ||
12905 | =item Example 1: A simple filter. | |
12906 | ||
12907 | =item Example 2: Using the context | |
12908 | ||
12909 | =item Example 3: Using the context within the filter | |
12910 | ||
12911 | =item Example 4: Using filter_del | |
12912 | ||
12913 | =back | |
12914 | ||
4d4e713d JH |
12915 | =item Filter::Simple |
12916 | ||
165c0277 JH |
12917 | =item AUTHOR |
12918 | ||
12919 | =item DATE | |
12920 | ||
12921 | =back | |
12922 | ||
4755096e GS |
12923 | =head2 FindBin - Locate directory of original perl script |
12924 | ||
d420ca49 | 12925 | =over 4 |
4755096e GS |
12926 | |
12927 | =item SYNOPSIS | |
12928 | ||
12929 | =item DESCRIPTION | |
12930 | ||
12931 | =item EXPORTABLE VARIABLES | |
12932 | ||
35bf961c JH |
12933 | =item KNOWN ISSUES |
12934 | ||
4755096e GS |
12935 | =item KNOWN BUGS |
12936 | ||
12937 | =item AUTHORS | |
12938 | ||
12939 | =item COPYRIGHT | |
12940 | ||
12941 | =back | |
12942 | ||
12943 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
12944 | ||
d420ca49 | 12945 | =over 4 |
4755096e GS |
12946 | |
12947 | =item SYNOPSIS | |
12948 | ||
12949 | =item DESCRIPTION | |
12950 | ||
12951 | =item AVAILABILITY | |
12952 | ||
12953 | =item BUGS | |
12954 | ||
12955 | =item SEE ALSO | |
12956 | ||
12957 | =back | |
12958 | ||
12959 | =head2 Getopt::Long - Extended processing of command line options | |
12960 | ||
d420ca49 | 12961 | =over 4 |
4755096e GS |
12962 | |
12963 | =item SYNOPSIS | |
12964 | ||
12965 | =item DESCRIPTION | |
12966 | ||
12967 | =item Command Line Options, an Introduction | |
12968 | ||
12969 | =item Getting Started with Getopt::Long | |
12970 | ||
d420ca49 | 12971 | =over 4 |
4755096e GS |
12972 | |
12973 | =item Simple options | |
12974 | ||
12975 | =item A little bit less simple options | |
12976 | ||
12977 | =item Mixing command line option with other arguments | |
12978 | ||
12979 | =item Options with values | |
12980 | ||
12981 | =item Options with multiple values | |
12982 | ||
12983 | =item Options with hash values | |
12984 | ||
12985 | =item User-defined subroutines to handle options | |
12986 | ||
12987 | =item Options with multiple names | |
12988 | ||
12989 | =item Case and abbreviations | |
12990 | ||
12991 | =item Summary of Option Specifications | |
12992 | ||
ff426ff2 JH |
12993 | !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : |
12994 | + [ I<desttype> ] | |
4755096e GS |
12995 | |
12996 | =back | |
12997 | ||
12998 | =item Advanced Possibilities | |
12999 | ||
d420ca49 | 13000 | =over 4 |
4755096e | 13001 | |
10862624 RF |
13002 | =item Object oriented interface |
13003 | ||
4755096e GS |
13004 | =item Documentation and help texts |
13005 | ||
13006 | =item Storing options in a hash | |
13007 | ||
13008 | =item Bundling | |
13009 | ||
13010 | =item The lonesome dash | |
13011 | ||
1fdc5aa6 | 13012 | =item Argument callback |
4755096e GS |
13013 | |
13014 | =back | |
13015 | ||
13016 | =item Configuring Getopt::Long | |
13017 | ||
9fa7f388 JH |
13018 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, |
13019 | require_order, permute, bundling (default: disabled), bundling_override | |
13020 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
13021 | (default: disabled), pass_through (default: disabled), prefix, | |
13022 | prefix_pattern, debug (default: disabled) | |
4755096e GS |
13023 | |
13024 | =item Return values and Errors | |
13025 | ||
13026 | =item Legacy | |
13027 | ||
d420ca49 | 13028 | =over 4 |
4755096e GS |
13029 | |
13030 | =item Default destinations | |
13031 | ||
13032 | =item Alternative option starters | |
13033 | ||
13034 | =item Configuration variables | |
13035 | ||
13036 | =back | |
13037 | ||
10862624 RF |
13038 | =item Trouble Shooting |
13039 | ||
d420ca49 | 13040 | =over 4 |
10862624 RF |
13041 | |
13042 | =item Warning: Ignoring '!' modifier for short option | |
13043 | ||
13044 | =item GetOptions does not return a false result when an option is not | |
13045 | supplied | |
13046 | ||
1fdc5aa6 JH |
13047 | =item GetOptions does not split the command line correctly |
13048 | ||
13049 | =item How do I put a "-?" option into a Getopt::Long? | |
13050 | ||
10862624 RF |
13051 | =back |
13052 | ||
4755096e GS |
13053 | =item AUTHOR |
13054 | ||
13055 | =item COPYRIGHT AND DISCLAIMER | |
13056 | ||
13057 | =back | |
13058 | ||
13059 | =head2 Getopt::Std, getopt - Process single-character switches with switch | |
13060 | clustering | |
13061 | ||
d420ca49 | 13062 | =over 4 |
4755096e GS |
13063 | |
13064 | =item SYNOPSIS | |
13065 | ||
13066 | =item DESCRIPTION | |
13067 | ||
13068 | =back | |
13069 | ||
80327a3d JH |
13070 | =head2 Hash::Util - A selection of general-utility hash subroutines |
13071 | ||
13072 | =over 4 | |
13073 | ||
13074 | =item SYNOPSIS | |
13075 | ||
13076 | =item DESCRIPTION | |
13077 | ||
13078 | =over 4 | |
13079 | ||
13080 | =item Restricted hashes | |
13081 | ||
13082 | lock_keys, unlock_keys | |
13083 | ||
13084 | =back | |
13085 | ||
13086 | =back | |
13087 | ||
13088 | lock_value, unlock_value | |
13089 | ||
13090 | B<lock_hash>, B<unlock_hash> | |
13091 | ||
13092 | =over 4 | |
13093 | ||
13094 | =item AUTHOR | |
13095 | ||
13096 | =item SEE ALSO | |
13097 | ||
13098 | =back | |
13099 | ||
4755096e GS |
13100 | =head2 I18N::Collate - compare 8-bit scalar data according to the current |
13101 | locale | |
13102 | ||
d420ca49 | 13103 | =over 4 |
4755096e GS |
13104 | |
13105 | =item SYNOPSIS | |
13106 | ||
13107 | =item DESCRIPTION | |
13108 | ||
13109 | =back | |
13110 | ||
772ff3b9 JH |
13111 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language |
13112 | tags | |
13113 | ||
13114 | =over 4 | |
13115 | ||
13116 | =item SYNOPSIS | |
13117 | ||
13118 | =item DESCRIPTION | |
13119 | ||
13120 | =back | |
13121 | ||
13122 | the function is_language_tag($lang1) | |
13123 | ||
13124 | the function extract_language_tags($whatever) | |
13125 | ||
13126 | the function same_language_tag($lang1, $lang2) | |
13127 | ||
13128 | the function similarity_language_tag($lang1, $lang2) | |
13129 | ||
13130 | the function is_dialect_of($lang1, $lang2) | |
13131 | ||
13132 | the function super_languages($lang1) | |
13133 | ||
13134 | the function locale2language_tag($locale_identifier) | |
13135 | ||
13136 | the function encode_language_tag($lang1) | |
13137 | ||
13138 | the function alternate_language_tags($lang1) | |
13139 | ||
4f233aa4 JH |
13140 | the function @langs = panic_languages(@accept_languages) |
13141 | ||
772ff3b9 JH |
13142 | =over 4 |
13143 | ||
13144 | =item ABOUT LOWERCASING | |
13145 | ||
13146 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS | |
13147 | ||
13148 | =item SEE ALSO | |
13149 | ||
13150 | =item COPYRIGHT | |
13151 | ||
13152 | =item AUTHOR | |
13153 | ||
13154 | =back | |
13155 | ||
4f233aa4 | 13156 | =head2 I18N::LangTags::List -- tags and names for human languages |
2ca5449f JH |
13157 | |
13158 | =over 4 | |
13159 | ||
13160 | =item SYNOPSIS | |
13161 | ||
4f233aa4 JH |
13162 | =item DESCRIPTION |
13163 | ||
2ca5449f JH |
13164 | =item ABOUT LANGUAGE TAGS |
13165 | ||
13166 | =item LIST OF LANGUAGES | |
13167 | ||
4f233aa4 JH |
13168 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} : |
13169 | Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)], | |
13170 | {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} : | |
13171 | Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} : | |
13172 | Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} : | |
13173 | Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} : | |
13174 | Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages], | |
13175 | [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} : | |
13176 | Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, | |
13177 | {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} : | |
13178 | Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu | |
13179 | (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak | |
13180 | (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} : | |
13181 | Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : | |
13182 | Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : | |
13183 | Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : | |
13184 | Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, | |
13185 | [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], | |
13186 | [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} : | |
13187 | Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} | |
13188 | : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : | |
13189 | Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, | |
13190 | {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : | |
13191 | Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and | |
13192 | pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)], | |
13193 | [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles | |
13194 | and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} : | |
13195 | Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default | |
13196 | (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi} | |
13197 | : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : | |
13198 | Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, | |
13199 | {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, | |
13200 | {en} : English, {enm} : Old English (1100-1500), {ang} : Old English | |
13201 | (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} : | |
13202 | Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : | |
13203 | Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} | |
13204 | : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : | |
13205 | Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, | |
13206 | {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, | |
13207 | {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500), | |
13208 | {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : | |
13209 | Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : | |
13210 | Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : | |
13211 | Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian, | |
13212 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : | |
13213 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, | |
13214 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo, | |
13215 | {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)], | |
13216 | {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language | |
13217 | Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira} | |
13218 | : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} : | |
13219 | Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} : | |
13220 | Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian, | |
13221 | {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} : | |
13222 | Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} : | |
13223 | Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi} | |
13224 | : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu, | |
13225 | {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi, | |
13226 | {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} : | |
13227 | Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru} | |
13228 | : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba, | |
13229 | {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} : | |
13230 | Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} : | |
13231 | Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} : | |
13232 | Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian, | |
13233 | {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} : | |
13234 | Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu, | |
13235 | {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo | |
13236 | languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} : | |
13237 | Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men} | |
13238 | : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} : | |
13239 | Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} : | |
13240 | Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} | |
13241 | : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} : | |
13242 | Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} : | |
13243 | Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : | |
13244 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, | |
13245 | {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami, | |
13246 | {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} | |
13247 | : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, | |
13248 | {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya, | |
13249 | {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian | |
13250 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : | |
13251 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : | |
13252 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian | |
13253 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} | |
13254 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], | |
13255 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : | |
13256 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, | |
fa1c7b03 JH |
13257 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : |
13258 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan | |
13259 | languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)], | |
13260 | {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} : | |
13261 | Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup, | |
13262 | [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan, | |
13263 | {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika, | |
13264 | {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} : | |
13265 | Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)], | |
13266 | {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} : | |
13267 | Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern | |
13268 | Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es} | |
13269 | : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} : | |
13270 | Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} : | |
13271 | Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} : | |
13272 | Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te} | |
13273 | : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig} | |
13274 | : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit, | |
13275 | {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga | |
13276 | (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} : | |
13277 | Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish | |
13278 | (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi, | |
13279 | {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} : | |
13280 | Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} : | |
13281 | Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages], | |
13282 | {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof, | |
13283 | {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut, | |
13284 | {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik | |
13285 | languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : | |
13286 | Zhuang, {zu} : Zulu, {zun} : Zuni | |
b38f6a39 | 13287 | |
4755096e | 13288 | =item SEE ALSO |
b38f6a39 | 13289 | |
fa1c7b03 | 13290 | =item COPYRIGHT AND DISCLAIMER |
b38f6a39 | 13291 | |
fa1c7b03 | 13292 | =item AUTHOR |
b38f6a39 | 13293 | |
4755096e | 13294 | =back |
b38f6a39 | 13295 | |
fa1c7b03 | 13296 | =head2 I18N::Langinfo - query locale information |
b38f6a39 | 13297 | |
d420ca49 | 13298 | =over 4 |
7d2bfb28 | 13299 | |
4755096e | 13300 | =item SYNOPSIS |
9607fc9c | 13301 | |
4755096e | 13302 | =item DESCRIPTION |
9607fc9c | 13303 | |
d420ca49 | 13304 | =over 4 |
cb1a09d0 | 13305 | |
fa1c7b03 | 13306 | =item EXPORT |
b38f6a39 GS |
13307 | |
13308 | =back | |
cb1a09d0 | 13309 | |
4755096e GS |
13310 | =item SEE ALSO |
13311 | ||
d516a115 JH |
13312 | =item AUTHOR |
13313 | ||
fa1c7b03 | 13314 | =item COPYRIGHT AND LICENSE |
d516a115 | 13315 | |
a45bd81d GS |
13316 | =back |
13317 | ||
fa1c7b03 | 13318 | =head2 IO - load various IO modules |
cb1a09d0 | 13319 | |
d420ca49 | 13320 | =over 4 |
a45bd81d | 13321 | |
8ebc5c01 | 13322 | =item SYNOPSIS |
cb1a09d0 | 13323 | |
8ebc5c01 | 13324 | =item DESCRIPTION |
cb1a09d0 | 13325 | |
a45bd81d GS |
13326 | =back |
13327 | ||
14218588 GS |
13328 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory |
13329 | handles | |
fb9cefb4 | 13330 | |
d420ca49 | 13331 | =over 4 |
a45bd81d | 13332 | |
fb9cefb4 GS |
13333 | =item SYNOPSIS |
13334 | ||
13335 | =item DESCRIPTION | |
13336 | ||
14218588 GS |
13337 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
13338 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
fb9cefb4 GS |
13339 | |
13340 | =item SEE ALSO | |
13341 | ||
14218588 | 13342 | =item AUTHOR |
fb9cefb4 GS |
13343 | |
13344 | =item COPYRIGHT | |
13345 | ||
a45bd81d GS |
13346 | =back |
13347 | ||
14218588 | 13348 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
fb9cefb4 | 13349 | |
d420ca49 | 13350 | =over 4 |
a45bd81d | 13351 | |
fb9cefb4 GS |
13352 | =item SYNOPSIS |
13353 | ||
13354 | =item DESCRIPTION | |
13355 | ||
14218588 GS |
13356 | =item CONSTRUCTOR |
13357 | ||
13358 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
13359 | ||
fb9cefb4 GS |
13360 | =item METHODS |
13361 | ||
14218588 | 13362 | open( FILENAME [,MODE [,PERMS]] ) |
fb9cefb4 GS |
13363 | |
13364 | =item SEE ALSO | |
13365 | ||
14218588 | 13366 | =item HISTORY |
fb9cefb4 | 13367 | |
a45bd81d GS |
13368 | =back |
13369 | ||
14218588 GS |
13370 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
13371 | handles | |
13372 | ||
d420ca49 | 13373 | =over 4 |
a45bd81d | 13374 | |
14218588 GS |
13375 | =item SYNOPSIS |
13376 | ||
13377 | =item DESCRIPTION | |
13378 | ||
13379 | =item CONSTRUCTOR | |
13380 | ||
13381 | new (), new_from_fd ( FD, MODE ) | |
13382 | ||
13383 | =item METHODS | |
13384 | ||
13385 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
13386 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
13387 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
13388 | $io->blocking ( [ BOOL ] ), $io->untaint | |
13389 | ||
13390 | =item NOTE | |
13391 | ||
13392 | =item SEE ALSO | |
13393 | ||
13394 | =item BUGS | |
13395 | ||
13396 | =item HISTORY | |
13397 | ||
a45bd81d GS |
13398 | =back |
13399 | ||
14218588 GS |
13400 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes |
13401 | ||
d420ca49 | 13402 | =over 4 |
a45bd81d | 13403 | |
14218588 GS |
13404 | =item SYNOPSIS |
13405 | ||
13406 | =item DESCRIPTION | |
13407 | ||
13408 | =item CONSTRUCTOR | |
13409 | ||
13410 | new ( [READER, WRITER] ) | |
13411 | ||
13412 | =item METHODS | |
13413 | ||
13414 | reader ([ARGS]), writer ([ARGS]), handles () | |
13415 | ||
13416 | =item SEE ALSO | |
13417 | ||
13418 | =item AUTHOR | |
13419 | ||
13420 | =item COPYRIGHT | |
13421 | ||
a45bd81d GS |
13422 | =back |
13423 | ||
14218588 GS |
13424 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call |
13425 | ||
d420ca49 | 13426 | =over 4 |
a45bd81d | 13427 | |
14218588 GS |
13428 | =item SYNOPSIS |
13429 | ||
13430 | =item DESCRIPTION | |
13431 | ||
13432 | =item METHODS | |
13433 | ||
13434 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
13435 | IO ), handles( [ EVENT_MASK ] ) | |
13436 | ||
13437 | =item SEE ALSO | |
13438 | ||
13439 | =item AUTHOR | |
13440 | ||
13441 | =item COPYRIGHT | |
13442 | ||
a45bd81d GS |
13443 | =back |
13444 | ||
14218588 GS |
13445 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for |
13446 | I/O objects | |
13447 | ||
d420ca49 | 13448 | =over 4 |
a45bd81d | 13449 | |
14218588 GS |
13450 | =item SYNOPSIS |
13451 | ||
13452 | =item DESCRIPTION | |
13453 | ||
1fa7ca25 JH |
13454 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
13455 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
74cac757 | 13456 | $io->tell |
14218588 | 13457 | |
4d4e713d JH |
13458 | =item SEE ALSO |
13459 | ||
14218588 GS |
13460 | =item HISTORY |
13461 | ||
a45bd81d GS |
13462 | =back |
13463 | ||
14218588 GS |
13464 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system |
13465 | call | |
13466 | ||
d420ca49 | 13467 | =over 4 |
a45bd81d | 13468 | |
14218588 GS |
13469 | =item SYNOPSIS |
13470 | ||
13471 | =item DESCRIPTION | |
13472 | ||
13473 | =item CONSTRUCTOR | |
13474 | ||
13475 | new ( [ HANDLES ] ) | |
13476 | ||
13477 | =item METHODS | |
13478 | ||
13479 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
13480 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
13481 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
13482 | ||
13483 | =item EXAMPLE | |
13484 | ||
13485 | =item AUTHOR | |
13486 | ||
13487 | =item COPYRIGHT | |
13488 | ||
a45bd81d GS |
13489 | =back |
13490 | ||
14218588 GS |
13491 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket |
13492 | communications | |
13493 | ||
d420ca49 | 13494 | =over 4 |
a45bd81d | 13495 | |
14218588 GS |
13496 | =item SYNOPSIS |
13497 | ||
13498 | =item DESCRIPTION | |
13499 | ||
13500 | =item CONSTRUCTOR | |
13501 | ||
13502 | new ( [ARGS] ) | |
13503 | ||
13504 | =item METHODS | |
13505 | ||
ab1e085c JH |
13506 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
13507 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
14218588 GS |
13508 | |
13509 | =item SEE ALSO | |
13510 | ||
13511 | =item AUTHOR | |
13512 | ||
13513 | =item COPYRIGHT | |
13514 | ||
a45bd81d GS |
13515 | =back |
13516 | ||
14218588 GS |
13517 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for |
13518 | AF_INET domain sockets | |
13519 | ||
d420ca49 | 13520 | =over 4 |
a45bd81d | 13521 | |
14218588 GS |
13522 | =item SYNOPSIS |
13523 | ||
13524 | =item DESCRIPTION | |
13525 | ||
13526 | =item CONSTRUCTOR | |
13527 | ||
13528 | new ( [ARGS] ) | |
13529 | ||
d420ca49 | 13530 | =over 4 |
14218588 GS |
13531 | |
13532 | =item METHODS | |
13533 | ||
13534 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
13535 | () | |
13536 | ||
13537 | =back | |
13538 | ||
13539 | =item SEE ALSO | |
13540 | ||
13541 | =item AUTHOR | |
13542 | ||
13543 | =item COPYRIGHT | |
13544 | ||
a45bd81d GS |
13545 | =back |
13546 | ||
14218588 GS |
13547 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for |
13548 | AF_UNIX domain sockets | |
13549 | ||
d420ca49 | 13550 | =over 4 |
a45bd81d | 13551 | |
14218588 GS |
13552 | =item SYNOPSIS |
13553 | ||
13554 | =item DESCRIPTION | |
13555 | ||
13556 | =item CONSTRUCTOR | |
13557 | ||
13558 | new ( [ARGS] ) | |
13559 | ||
13560 | =item METHODS | |
13561 | ||
13562 | hostpath(), peerpath() | |
13563 | ||
13564 | =item SEE ALSO | |
13565 | ||
13566 | =item AUTHOR | |
13567 | ||
13568 | =item COPYRIGHT | |
13569 | ||
a45bd81d | 13570 | =back |
14218588 GS |
13571 | |
13572 | =head2 IPC::Open2, open2 - open a process for both reading and writing | |
13573 | ||
d420ca49 | 13574 | =over 4 |
a45bd81d | 13575 | |
14218588 GS |
13576 | =item SYNOPSIS |
13577 | ||
13578 | =item DESCRIPTION | |
13579 | ||
13580 | =item WARNING | |
13581 | ||
13582 | =item SEE ALSO | |
13583 | ||
a45bd81d GS |
13584 | =back |
13585 | ||
14218588 GS |
13586 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error |
13587 | handling | |
13588 | ||
d420ca49 | 13589 | =over 4 |
14218588 GS |
13590 | |
13591 | =item SYNOPSIS | |
13592 | ||
13593 | =item DESCRIPTION | |
13594 | ||
a45bd81d | 13595 | =item WARNING |
14218588 | 13596 | |
a45bd81d | 13597 | =back |
14218588 GS |
13598 | |
13599 | =head2 IPC::SysV - SysV IPC constants | |
13600 | ||
d420ca49 | 13601 | =over 4 |
a45bd81d | 13602 | |
14218588 GS |
13603 | =item SYNOPSIS |
13604 | ||
13605 | =item DESCRIPTION | |
13606 | ||
13607 | ftok( PATH, ID ) | |
13608 | ||
13609 | =item SEE ALSO | |
13610 | ||
13611 | =item AUTHORS | |
13612 | ||
13613 | =item COPYRIGHT | |
13614 | ||
a45bd81d GS |
13615 | =back |
13616 | ||
14218588 GS |
13617 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class |
13618 | ||
d420ca49 | 13619 | =over 4 |
a45bd81d | 13620 | |
14218588 GS |
13621 | =item SYNOPSIS |
13622 | ||
13623 | =item DESCRIPTION | |
13624 | ||
13625 | =item METHODS | |
13626 | ||
13627 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
13628 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
13629 | FLAGS ] ), stat | |
13630 | ||
13631 | =item SEE ALSO | |
13632 | ||
13633 | =item AUTHOR | |
13634 | ||
13635 | =item COPYRIGHT | |
fb9cefb4 | 13636 | |
a45bd81d GS |
13637 | =back |
13638 | ||
fb9cefb4 GS |
13639 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object |
13640 | class | |
13641 | ||
d420ca49 | 13642 | =over 4 |
a45bd81d | 13643 | |
fb9cefb4 GS |
13644 | =item SYNOPSIS |
13645 | ||
13646 | =item DESCRIPTION | |
13647 | ||
13648 | =item METHODS | |
13649 | ||
13650 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
13651 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
13652 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
13653 | , VALUE ), stat | |
13654 | ||
13655 | =item SEE ALSO | |
13656 | ||
13657 | =item AUTHOR | |
13658 | ||
13659 | =item COPYRIGHT | |
13660 | ||
a45bd81d GS |
13661 | =back |
13662 | ||
41ca3a40 JH |
13663 | =head2 List::Utilib::List::Util, List::Util - A selection of |
13664 | general-utility list subroutines | |
13665 | ||
13666 | =over 4 | |
13667 | ||
13668 | =item SYNOPSIS | |
13669 | ||
13670 | =item DESCRIPTION | |
13671 | ||
13672 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
53d7eaa8 | 13673 | BLOCK LIST, shuffle LIST, sum LIST |
41ca3a40 | 13674 | |
f502af34 JH |
13675 | =item KNOWN BUGS |
13676 | ||
41ca3a40 JH |
13677 | =item SUGGESTED ADDITIONS |
13678 | ||
13679 | =item COPYRIGHT | |
13680 | ||
13681 | =back | |
13682 | ||
13683 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of | |
13684 | general-utility scalar subroutines | |
13685 | ||
13686 | =over 4 | |
13687 | ||
13688 | =item SYNOPSIS | |
13689 | ||
13690 | =item DESCRIPTION | |
13691 | ||
b2deec1d | 13692 | blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype |
1fa7ca25 | 13693 | EXPR, tainted EXPR, weaken REF |
41ca3a40 | 13694 | |
f502af34 JH |
13695 | =item KNOWN BUGS |
13696 | ||
41ca3a40 JH |
13697 | =item COPYRIGHT |
13698 | ||
13699 | =item BLATANT PLUG | |
13700 | ||
13701 | =back | |
13702 | ||
4d4e713d JH |
13703 | =head2 Locale::Constants - constants for Locale codes |
13704 | ||
13705 | =over 4 | |
13706 | ||
13707 | =item SYNOPSIS | |
13708 | ||
13709 | =item DESCRIPTION | |
13710 | ||
13711 | =item KNOWN BUGS AND LIMITATIONS | |
13712 | ||
13713 | =item SEE ALSO | |
13714 | ||
12b7c5c7 | 13715 | Locale::Language, Locale::Country, Locale::Script, Locale::Currency |
4d4e713d JH |
13716 | |
13717 | =item AUTHOR | |
13718 | ||
13719 | =item COPYRIGHT | |
13720 | ||
13721 | =back | |
13722 | ||
13723 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) | |
13724 | ||
13725 | =over 4 | |
13726 | ||
13727 | =item SYNOPSIS | |
13728 | ||
4d4e713d JH |
13729 | =item DESCRIPTION |
13730 | ||
13731 | B<alpha-2>, B<alpha-3>, B<numeric> | |
13732 | ||
4d4e713d JH |
13733 | =item CONVERSION ROUTINES |
13734 | ||
13735 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), | |
13736 | country_code2code( CODE, CODESET, CODESET ) | |
13737 | ||
4d4e713d JH |
13738 | =item QUERY ROUTINES |
13739 | ||
13740 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> | |
13741 | ||
80327a3d JH |
13742 | =item SEMI-PRIVATE ROUTINES |
13743 | ||
13744 | =over 4 | |
13745 | ||
13746 | =item alias_code | |
13747 | ||
13748 | =item rename_country | |
13749 | ||
13750 | =back | |
4d4e713d | 13751 | |
4d4e713d JH |
13752 | =item EXAMPLES |
13753 | ||
13754 | =item DOMAIN NAMES | |
13755 | ||
13756 | =item KNOWN BUGS AND LIMITATIONS | |
13757 | ||
13758 | =item SEE ALSO | |
13759 | ||
80327a3d JH |
13760 | Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO |
13761 | 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, | |
4d4e713d JH |
13762 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, |
13763 | http://www.cia.gov/cia/publications/factbook/docs/app-f.html | |
13764 | ||
13765 | =item AUTHOR | |
13766 | ||
13767 | =item COPYRIGHT | |
13768 | ||
13769 | =back | |
13770 | ||
13771 | =head2 Locale::Currency - ISO three letter codes for currency | |
13772 | identification (ISO 4217) | |
13773 | ||
13774 | =over 4 | |
13775 | ||
13776 | =item SYNOPSIS | |
13777 | ||
4d4e713d JH |
13778 | =item DESCRIPTION |
13779 | ||
13780 | XTS, XXX | |
13781 | ||
4d4e713d JH |
13782 | =item CONVERSION ROUTINES |
13783 | ||
13784 | code2currency(), currency2code() | |
13785 | ||
4d4e713d JH |
13786 | =item QUERY ROUTINES |
13787 | ||
13788 | C<all_currency_codes()>, C<all_currency_names()> | |
13789 | ||
4d4e713d JH |
13790 | =item EXAMPLES |
13791 | ||
13792 | =item KNOWN BUGS AND LIMITATIONS | |
13793 | ||
13794 | =item SEE ALSO | |
13795 | ||
12b7c5c7 JH |
13796 | Locale::Country, Locale::Script, ISO 4217:1995, |
13797 | http://www.bsi-global.com/iso4217currency | |
4d4e713d JH |
13798 | |
13799 | =item AUTHOR | |
13800 | ||
13801 | =item COPYRIGHT | |
13802 | ||
13803 | =back | |
13804 | ||
13805 | =head2 Locale::Language - ISO two letter codes for language identification | |
13806 | (ISO 639) | |
13807 | ||
13808 | =over 4 | |
13809 | ||
13810 | =item SYNOPSIS | |
13811 | ||
4d4e713d JH |
13812 | =item DESCRIPTION |
13813 | ||
4d4e713d JH |
13814 | =item CONVERSION ROUTINES |
13815 | ||
13816 | code2language(), language2code() | |
13817 | ||
4d4e713d JH |
13818 | =item QUERY ROUTINES |
13819 | ||
13820 | C<all_language_codes()>, C<all_language_names()> | |
13821 | ||
4d4e713d JH |
13822 | =item EXAMPLES |
13823 | ||
13824 | =item KNOWN BUGS AND LIMITATIONS | |
13825 | ||
13826 | =item SEE ALSO | |
13827 | ||
12b7c5c7 | 13828 | Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), |
4d4e713d JH |
13829 | http://lcweb.loc.gov/standards/iso639-2/langhome.html |
13830 | ||
13831 | =item AUTHOR | |
13832 | ||
13833 | =item COPYRIGHT | |
13834 | ||
13835 | =back | |
13836 | ||
772ff3b9 JH |
13837 | =head2 Locale::Maketext -- framework for localization |
13838 | ||
13839 | =over 4 | |
13840 | ||
13841 | =item SYNOPSIS | |
13842 | ||
13843 | =item DESCRIPTION | |
13844 | ||
13845 | =item QUICK OVERVIEW | |
13846 | ||
13847 | =item METHODS | |
13848 | ||
13849 | =over 4 | |
13850 | ||
13851 | =item Construction Methods | |
13852 | ||
772ff3b9 JH |
13853 | =item The "maketext" Method |
13854 | ||
13855 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto | |
13856 | ||
13857 | =item Utility Methods | |
13858 | ||
13859 | $language->quant($number, $singular), $language->quant($number, $singular, | |
13860 | $plural), $language->quant($number, $singular, $plural, $negative), | |
13861 | $language->numf($number), $language->sprintf($format, @items), | |
13862 | $language->language_tag(), $language->encoding() | |
13863 | ||
13864 | =item Language Handle Attributes and Internals | |
13865 | ||
13866 | =back | |
13867 | ||
13868 | =item LANGUAGE CLASS HIERARCHIES | |
13869 | ||
13870 | =item ENTRIES IN EACH LEXICON | |
13871 | ||
13872 | =item BRACKET NOTATION | |
13873 | ||
13874 | =item AUTO LEXICONS | |
13875 | ||
13876 | =item CONTROLLING LOOKUP FAILURE | |
13877 | ||
13878 | =item HOW TO USE MAKETEXT | |
13879 | ||
13880 | =item SEE ALSO | |
13881 | ||
13882 | =item COPYRIGHT AND DISCLAIMER | |
13883 | ||
13884 | =item AUTHOR | |
13885 | ||
13886 | =back | |
13887 | ||
13888 | =head2 Locale::Maketext::TPJ13 -- article about software localization | |
13889 | ||
13890 | =over 4 | |
13891 | ||
13892 | =item SYNOPSIS | |
13893 | ||
13894 | =item DESCRIPTION | |
13895 | ||
13896 | =item Localization and Perl: gettext breaks, Maketext fixes | |
13897 | ||
13898 | =over 4 | |
13899 | ||
13900 | =item A Localization Horror Story: It Could Happen To You | |
13901 | ||
13902 | =item The Linguistic View | |
13903 | ||
13904 | =item Breaking gettext | |
13905 | ||
13906 | =item Replacing gettext | |
13907 | ||
13908 | =item Buzzwords: Abstraction and Encapsulation | |
13909 | ||
13910 | =item Buzzword: Isomorphism | |
13911 | ||
13912 | =item Buzzword: Inheritance | |
13913 | ||
13914 | =item Buzzword: Concision | |
13915 | ||
13916 | =item The Devil in the Details | |
13917 | ||
13918 | =item The Proof in the Pudding: Localizing Web Sites | |
13919 | ||
13920 | =item References | |
13921 | ||
13922 | =back | |
13923 | ||
13924 | =back | |
13925 | ||
12b7c5c7 JH |
13926 | =head2 Locale::Script - ISO codes for script identification (ISO 15924) |
13927 | ||
13928 | =over 4 | |
13929 | ||
13930 | =item SYNOPSIS | |
13931 | ||
13932 | =item DESCRIPTION | |
13933 | ||
13934 | B<alpha-2>, B<alpha-3>, B<numeric> | |
13935 | ||
13936 | =over 4 | |
13937 | ||
13938 | =item SPECIAL CODES | |
13939 | ||
13940 | =back | |
13941 | ||
13942 | =item CONVERSION ROUTINES | |
13943 | ||
13944 | code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), | |
13945 | script_code2code( CODE, CODESET, CODESET ) | |
13946 | ||
13947 | =item QUERY ROUTINES | |
13948 | ||
13949 | C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> | |
13950 | ||
13951 | =item EXAMPLES | |
13952 | ||
13953 | =item KNOWN BUGS AND LIMITATIONS | |
13954 | ||
13955 | =item SEE ALSO | |
13956 | ||
13957 | Locale::Language, Locale::Currency, Locale::Country, ISO 15924, | |
13958 | http://www.evertype.com/standards/iso15924/ | |
13959 | ||
13960 | =item AUTHOR | |
13961 | ||
13962 | =item COPYRIGHT | |
13963 | ||
13964 | =back | |
13965 | ||
ab1e085c JH |
13966 | =head2 MIME::Base64 - Encoding and decoding of base64 strings |
13967 | ||
13968 | =over 4 | |
13969 | ||
13970 | =item SYNOPSIS | |
13971 | ||
13972 | =item DESCRIPTION | |
13973 | ||
13974 | encode_base64($str, [$eol]), decode_base64($str) | |
13975 | ||
13976 | =item DIAGNOSTICS | |
13977 | ||
13978 | Premature end of base64 data, Premature padding of base64 data | |
13979 | ||
13980 | =item EXAMPLES | |
13981 | ||
13982 | =item COPYRIGHT | |
13983 | ||
13984 | =back | |
13985 | ||
13986 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding | |
13987 | of quoted-printable strings | |
13988 | ||
13989 | =over 4 | |
13990 | ||
13991 | =item SYNOPSIS | |
13992 | ||
13993 | =item DESCRIPTION | |
13994 | ||
13995 | encode_qp($str), decode_qp($str); | |
13996 | ||
13997 | =item COPYRIGHT | |
13998 | ||
13999 | =back | |
14000 | ||
9038e305 | 14001 | =head2 Math::BigFloat - Arbitrary size floating point math package |
cb1a09d0 | 14002 | |
d420ca49 | 14003 | =over 4 |
a45bd81d | 14004 | |
8ebc5c01 | 14005 | =item SYNOPSIS |
cb1a09d0 AD |
14006 | |
14007 | =item DESCRIPTION | |
14008 | ||
9038e305 JH |
14009 | =over 4 |
14010 | ||
14011 | =item Canonical notation | |
14012 | ||
14013 | =item Output | |
14014 | ||
14015 | =item C<mantissa()>, C<exponent()> and C<parts()> | |
14016 | ||
14017 | =item Accuracy vs. Precision | |
14018 | ||
14019 | =item Rounding | |
14020 | ||
4f233aa4 JH |
14021 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale |
14022 | ), fround ( -$scale ) and fround ( 0 ) | |
9038e305 JH |
14023 | |
14024 | =back | |
14025 | ||
14026 | =item EXAMPLES | |
14027 | ||
9038e305 | 14028 | # not ready yet |
9038e305 JH |
14029 | |
14030 | =item Autocreating constants | |
14031 | ||
fa1c7b03 JH |
14032 | =over 4 |
14033 | ||
14034 | =item Math library | |
14035 | ||
14036 | =item Using Math::BigInt::Lite | |
14037 | ||
14038 | =back | |
14039 | ||
b38f6a39 | 14040 | =item BUGS |
7d2bfb28 | 14041 | |
9038e305 JH |
14042 | =item CAVEAT |
14043 | ||
14044 | stringify, bstr(), bdiv, Modifying and =, bpow | |
14045 | ||
14046 | =item LICENSE | |
14047 | ||
14048 | =item AUTHORS | |
7d2bfb28 | 14049 | |
b38f6a39 GS |
14050 | =back |
14051 | ||
14052 | =head2 Math::BigInt - Arbitrary size integer math package | |
14053 | ||
d420ca49 | 14054 | =over 4 |
8ebc5c01 | 14055 | |
b38f6a39 | 14056 | =item SYNOPSIS |
d516a115 | 14057 | |
b38f6a39 GS |
14058 | =item DESCRIPTION |
14059 | ||
14060 | Canonical notation, Input, Output | |
14061 | ||
ff426ff2 JH |
14062 | =item METHODS |
14063 | ||
14064 | =over 4 | |
14065 | ||
fa1c7b03 JH |
14066 | =item config |
14067 | ||
ff426ff2 JH |
14068 | =item accuracy |
14069 | ||
14070 | =item brsft | |
14071 | ||
14072 | =item new | |
14073 | ||
14074 | =item bnan | |
14075 | ||
14076 | =item bzero | |
14077 | ||
14078 | =item binf | |
14079 | ||
14080 | =item bone | |
14081 | ||
fa1c7b03 JH |
14082 | =item is_one()/is_zero()/is_nan()/is_inf() |
14083 | ||
14084 | =item is_positive()/is_negative() | |
ff426ff2 | 14085 | |
ff426ff2 JH |
14086 | $x->is_positive(); # true if >= 0 |
14087 | $x->is_negative(); # true if < 0 | |
fa1c7b03 JH |
14088 | |
14089 | =item is_odd()/is_even()/is_int() | |
ff426ff2 JH |
14090 | |
14091 | =item bcmp | |
14092 | ||
14093 | =item bacmp | |
14094 | ||
14095 | =item sign | |
14096 | ||
14097 | =item bcmp | |
14098 | ||
14099 | =item bneg | |
14100 | ||
14101 | =item babs | |
14102 | ||
14103 | =item bnorm | |
14104 | ||
14105 | =item bnot | |
14106 | ||
14107 | =item binc | |
14108 | ||
14109 | =item bdec | |
14110 | ||
14111 | =item badd | |
14112 | ||
14113 | =item bsub | |
14114 | ||
14115 | =item bmul | |
14116 | ||
14117 | =item bdiv | |
14118 | ||
14119 | =item bmod | |
14120 | ||
14121 | =item bpow | |
14122 | ||
14123 | =item blsft | |
14124 | ||
14125 | =item brsft | |
14126 | ||
14127 | =item band | |
14128 | ||
14129 | =item bior | |
14130 | ||
14131 | =item bxor | |
14132 | ||
14133 | =item bnot | |
14134 | ||
14135 | =item bsqrt | |
14136 | ||
14137 | =item bfac | |
14138 | ||
14139 | =item round | |
14140 | ||
14141 | =item bround | |
14142 | ||
14143 | =item bfround | |
14144 | ||
14145 | =item bfloor | |
14146 | ||
14147 | =item bceil | |
14148 | ||
14149 | =item bgcd | |
14150 | ||
14151 | =item blcm | |
14152 | ||
14153 | =item exponent | |
14154 | ||
14155 | =item mantissa | |
14156 | ||
14157 | =item parts | |
14158 | ||
14159 | =item copy | |
14160 | ||
14161 | =item as_number | |
14162 | ||
14163 | =item bsstr | |
14164 | ||
14165 | =item as_hex | |
14166 | ||
14167 | =item as_bin | |
14168 | ||
14169 | =back | |
14170 | ||
d0363f02 JH |
14171 | =item ACCURACY and PRECISION |
14172 | ||
9038e305 JH |
14173 | =over 4 |
14174 | ||
d0363f02 JH |
14175 | =item Precision P |
14176 | ||
14177 | =item Accuracy A | |
9038e305 | 14178 | |
d0363f02 | 14179 | =item Fallback F |
9038e305 | 14180 | |
d0363f02 JH |
14181 | =item Rounding mode R |
14182 | ||
14183 | 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy | |
14184 | (significant digits), Setting/Accessing, Creating numbers, Usage, | |
14185 | Precedence, Overriding globals, Local settings, Rounding, Default values, | |
14186 | Remarks | |
14187 | ||
14188 | =back | |
14189 | ||
14190 | =item INTERNALS | |
14191 | ||
14192 | =over 4 | |
9038e305 | 14193 | |
758a5d79 JH |
14194 | =item MATH LIBRARY |
14195 | ||
14196 | =item SIGN | |
14197 | ||
9038e305 JH |
14198 | =item mantissa(), exponent() and parts() |
14199 | ||
14200 | =back | |
b38f6a39 | 14201 | |
d0363f02 JH |
14202 | =item EXAMPLES |
14203 | ||
3ecb3787 | 14204 | use Math::BigInt; |
d0363f02 | 14205 | |
b38f6a39 | 14206 | =item Autocreating constants |
4a6725af | 14207 | |
9038e305 JH |
14208 | =item PERFORMANCE |
14209 | ||
d0363f02 JH |
14210 | =over 4 |
14211 | ||
758a5d79 | 14212 | =item Alternative math libraries |
d0363f02 | 14213 | |
ff426ff2 JH |
14214 | =item SUBCLASSING |
14215 | ||
14216 | =back | |
14217 | ||
14218 | =item Subclassing Math::BigInt | |
14219 | ||
14220 | =item UPGRADING | |
14221 | ||
14222 | =over 4 | |
14223 | ||
14224 | =item Auto-upgrade | |
14225 | ||
14226 | bsqrt(), div(), blog() | |
14227 | ||
d0363f02 JH |
14228 | =back |
14229 | ||
8ebc5c01 | 14230 | =item BUGS |
7d2bfb28 | 14231 | |
758a5d79 | 14232 | Out of Memory!, Fails to load Calc on Perl prior 5.6.0 |
9038e305 JH |
14233 | |
14234 | =item CAVEATS | |
14235 | ||
cb52f95f JH |
14236 | stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity |
14237 | handling, Modifying and =, bpow, Overloading -$x, Mixing different object | |
ff426ff2 | 14238 | types, bsqrt(), brsft() |
9038e305 JH |
14239 | |
14240 | =item LICENSE | |
14241 | ||
d0363f02 JH |
14242 | =item SEE ALSO |
14243 | ||
9038e305 | 14244 | =item AUTHORS |
7d2bfb28 | 14245 | |
a45bd81d GS |
14246 | =back |
14247 | ||
d0363f02 JH |
14248 | =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt |
14249 | ||
14250 | =over 4 | |
14251 | ||
14252 | =item SYNOPSIS | |
14253 | ||
14254 | =item DESCRIPTION | |
14255 | ||
14256 | =item EXPORT | |
14257 | ||
758a5d79 JH |
14258 | =item WRAP YOUR OWN |
14259 | ||
d0363f02 JH |
14260 | =item LICENSE |
14261 | ||
14262 | This program is free software; you may redistribute it and/or modify it | |
14263 | under | |
14264 | the same terms as Perl itself. | |
14265 | ||
14266 | =item AUTHORS | |
14267 | ||
14268 | =item SEE ALSO | |
14269 | ||
14270 | =back | |
14271 | ||
fa1c7b03 JH |
14272 | =head2 Math::BigRat - arbitrarily big rationals |
14273 | ||
14274 | =over 4 | |
14275 | ||
14276 | =item SYNOPSIS | |
14277 | ||
14278 | =item DESCRIPTION | |
14279 | ||
14280 | =over 4 | |
14281 | ||
14282 | =item MATH LIBRARY | |
14283 | ||
14284 | =back | |
14285 | ||
14286 | =item METHODS | |
14287 | ||
14288 | =over 4 | |
14289 | ||
14290 | =item new | |
14291 | ||
14292 | =item numerator | |
14293 | ||
14294 | =item denominator | |
14295 | ||
14296 | $d = $x->denominator(); | |
14297 | ||
14298 | =item parts | |
14299 | ||
14300 | =back | |
14301 | ||
14302 | =item BUGS | |
14303 | ||
14304 | =item LICENSE | |
14305 | ||
14306 | =item SEE ALSO | |
14307 | ||
14308 | =item AUTHORS | |
14309 | ||
14310 | =back | |
14311 | ||
d722968f JH |
14312 | =head2 Math::Complex - complex numbers and associated mathematical |
14313 | functions | |
14314 | ||
d420ca49 | 14315 | =over 4 |
d722968f JH |
14316 | |
14317 | =item SYNOPSIS | |
14318 | ||
14319 | =item DESCRIPTION | |
14320 | ||
14321 | =item OPERATIONS | |
14322 | ||
14323 | =item CREATION | |
14324 | ||
14325 | =item STRINGIFICATION | |
14326 | ||
d420ca49 | 14327 | =over 4 |
d722968f JH |
14328 | |
14329 | =item CHANGED IN PERL 5.6 | |
14330 | ||
14331 | =back | |
14332 | ||
14333 | =item USAGE | |
14334 | ||
14335 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
14336 | ||
14337 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
14338 | ||
14339 | =item BUGS | |
14340 | ||
14341 | =item AUTHORS | |
14342 | ||
14343 | =back | |
14344 | ||
4a6725af NT |
14345 | =head2 Math::Trig - trigonometric functions |
14346 | ||
d420ca49 | 14347 | =over 4 |
a45bd81d | 14348 | |
4a6725af NT |
14349 | =item SYNOPSIS |
14350 | ||
14351 | =item DESCRIPTION | |
14352 | ||
14353 | =item TRIGONOMETRIC FUNCTIONS | |
14354 | ||
fb9cefb4 GS |
14355 | B<tan> |
14356 | ||
d420ca49 | 14357 | =over 4 |
4a6725af | 14358 | |
5cd24f17 | 14359 | =item ERRORS DUE TO DIVISION BY ZERO |
14360 | ||
14361 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
4a6725af NT |
14362 | |
14363 | =back | |
14364 | ||
fb9cefb4 GS |
14365 | =item PLANE ANGLE CONVERSIONS |
14366 | ||
14367 | =item RADIAL COORDINATE CONVERSIONS | |
14368 | ||
d420ca49 | 14369 | =over 4 |
fb9cefb4 GS |
14370 | |
14371 | =item COORDINATE SYSTEMS | |
14372 | ||
14373 | =item 3-D ANGLE CONVERSIONS | |
14374 | ||
14375 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
14376 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
14377 | ||
14378 | =back | |
14379 | ||
0d0e97a6 | 14380 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS |
fb9cefb4 GS |
14381 | |
14382 | =item EXAMPLES | |
4a6725af | 14383 | |
0d0e97a6 JH |
14384 | =over 4 |
14385 | ||
14386 | =item CAVEAT FOR GREAT CIRCLE FORMULAS | |
14387 | ||
14388 | =back | |
14389 | ||
5cd24f17 | 14390 | =item BUGS |
14391 | ||
14392 | =item AUTHORS | |
14393 | ||
a45bd81d GS |
14394 | =back |
14395 | ||
9038e305 JH |
14396 | =head2 Memoize - Make your functions faster by trading space for time |
14397 | ||
14398 | =over 4 | |
14399 | ||
14400 | =item SYNOPSIS | |
14401 | ||
14402 | =item DESCRIPTION | |
14403 | ||
14404 | =item DETAILS | |
14405 | ||
14406 | =item OPTIONS | |
14407 | ||
14408 | =over 4 | |
14409 | ||
14410 | =item INSTALL | |
14411 | ||
14412 | =item NORMALIZER | |
14413 | ||
14414 | =item C<SCALAR_CACHE>, C<LIST_CACHE> | |
14415 | ||
14416 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> | |
14417 | ||
14418 | =back | |
14419 | ||
14420 | =item OTHER FACILITIES | |
14421 | ||
14422 | =over 4 | |
14423 | ||
14424 | =item C<unmemoize> | |
14425 | ||
14426 | =item C<flush_cache> | |
14427 | ||
14428 | =back | |
14429 | ||
14430 | =item CAVEATS | |
14431 | ||
14432 | =item PERSISTENT CACHE SUPPORT | |
14433 | ||
14434 | =item EXPIRATION SUPPORT | |
14435 | ||
14436 | =item BUGS | |
14437 | ||
14438 | =item MAILING LIST | |
14439 | ||
14440 | =item AUTHOR | |
14441 | ||
7a49b635 JH |
14442 | =item COPYRIGHT AND LICENSE |
14443 | ||
9038e305 JH |
14444 | =item THANK YOU |
14445 | ||
14446 | =back | |
14447 | ||
14448 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for | |
14449 | Storable use | |
14450 | ||
14451 | =over 4 | |
14452 | ||
14453 | =item DESCRIPTION | |
14454 | ||
14455 | =back | |
14456 | ||
14457 | =head2 Memoize::Expire - Plug-in module for automatic expiration of | |
14458 | memoized values | |
14459 | ||
14460 | =over 4 | |
14461 | ||
14462 | =item SYNOPSIS | |
14463 | ||
14464 | =item DESCRIPTION | |
14465 | ||
14466 | =item INTERFACE | |
14467 | ||
14468 | TIEHASH, EXISTS, STORE | |
14469 | ||
14470 | =item ALTERNATIVES | |
14471 | ||
14472 | =item CAVEATS | |
14473 | ||
14474 | =item AUTHOR | |
14475 | ||
14476 | =item SEE ALSO | |
14477 | ||
14478 | =back | |
14479 | ||
14480 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics | |
14481 | ||
14482 | =over 4 | |
14483 | ||
14484 | =item DESCRIPTION | |
14485 | ||
14486 | =back | |
14487 | ||
14488 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics | |
14489 | ||
14490 | =over 4 | |
14491 | ||
14492 | =item DESCRIPTION | |
14493 | ||
14494 | =back | |
14495 | ||
14496 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for | |
14497 | Storable use | |
14498 | ||
14499 | =over 4 | |
14500 | ||
14501 | =item DESCRIPTION | |
14502 | ||
14503 | =back | |
14504 | ||
14505 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for | |
14506 | Storable use | |
14507 | ||
14508 | =over 4 | |
14509 | ||
14510 | =item DESCRIPTION | |
14511 | ||
14512 | =back | |
14513 | ||
9038e305 JH |
14514 | =head2 Memoize::Storable - store Memoized data in Storable database |
14515 | ||
14516 | =over 4 | |
14517 | ||
14518 | =item DESCRIPTION | |
14519 | ||
14520 | =back | |
14521 | ||
8ebc5c01 | 14522 | =head2 NDBM_File - Tied access to ndbm files |
7d2bfb28 | 14523 | |
d420ca49 | 14524 | =over 4 |
a45bd81d | 14525 | |
8ebc5c01 | 14526 | =item SYNOPSIS |
7d2bfb28 | 14527 | |
4d4e713d JH |
14528 | =item DESCRIPTION |
14529 | ||
a9ef4385 JH |
14530 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
14531 | ||
14532 | =item DIAGNOSTICS | |
14533 | ||
d420ca49 | 14534 | =over 4 |
a9ef4385 JH |
14535 | |
14536 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
14537 | ||
14538 | =back | |
14539 | ||
14540 | =item BUGS AND WARNINGS | |
7d2bfb28 | 14541 | |
a45bd81d GS |
14542 | =back |
14543 | ||
1fa7ca25 JH |
14544 | =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch |
14545 | ||
14546 | =over 4 | |
14547 | ||
14548 | =item SYNOPSIS | |
14549 | ||
14550 | =item DESCRIPTION | |
14551 | ||
428dc699 JH |
14552 | =over 4 |
14553 | ||
14554 | =item Enforcing redispatch | |
14555 | ||
14556 | =item Avoiding repetitions | |
14557 | ||
14558 | =back | |
14559 | ||
1fa7ca25 JH |
14560 | =item AUTHOR |
14561 | ||
14562 | =item BUGS AND IRRITATIONS | |
14563 | ||
14564 | =item COPYRIGHT | |
14565 | ||
14566 | =back | |
14567 | ||
5d80033a JH |
14568 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) |
14569 | ||
14570 | =over 4 | |
14571 | ||
14572 | =item SYNOPSIS | |
14573 | ||
14574 | =item DESCRIPTION | |
14575 | ||
14576 | =item USER METHODS | |
14577 | ||
14578 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), | |
14579 | dataend () | |
14580 | ||
14581 | =item CLASS METHODS | |
14582 | ||
14583 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... | |
14584 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), | |
ff426ff2 | 14585 | ungetline ( TEXT ), read_until_dot (), tied_fh () |
5d80033a JH |
14586 | |
14587 | =item EXPORTS | |
14588 | ||
14589 | =item AUTHOR | |
14590 | ||
14591 | =item COPYRIGHT | |
14592 | ||
14593 | =back | |
14594 | ||
14595 | =head2 Net::Config - Local configuration data for libnet | |
14596 | ||
14597 | =over 4 | |
14598 | ||
14599 | =item SYNOPSYS | |
14600 | ||
14601 | =item DESCRIPTION | |
14602 | ||
14603 | =item METHODS | |
14604 | ||
14605 | requires_firewall HOST | |
14606 | ||
14607 | =item NetConfig VALUES | |
14608 | ||
14609 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, | |
53d7eaa8 JH |
14610 | time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, |
14611 | ftp_int_pasive, local_netmask, test_hosts, test_exists | |
5d80033a JH |
14612 | |
14613 | =back | |
14614 | ||
14615 | =head2 Net::Domain - Attempt to evaluate the current host's internet name | |
14616 | and domain | |
14617 | ||
14618 | =over 4 | |
14619 | ||
14620 | =item SYNOPSIS | |
14621 | ||
14622 | =item DESCRIPTION | |
14623 | ||
14624 | hostfqdn (), hostname (), hostdomain () | |
14625 | ||
14626 | =item AUTHOR | |
14627 | ||
14628 | =item COPYRIGHT | |
14629 | ||
14630 | =back | |
14631 | ||
5d80033a JH |
14632 | =head2 Net::FTP - FTP Client class |
14633 | ||
14634 | =over 4 | |
14635 | ||
14636 | =item SYNOPSIS | |
14637 | ||
14638 | =item DESCRIPTION | |
14639 | ||
14640 | =item OVERVIEW | |
14641 | ||
14642 | =item CONSTRUCTOR | |
14643 | ||
14644 | new (HOST [,OPTIONS]) | |
14645 | ||
14646 | =item METHODS | |
14647 | ||
14648 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), | |
14649 | site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) | |
14650 | ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME | |
53d7eaa8 JH |
14651 | ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ), |
14652 | mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get ( | |
14653 | REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ] | |
14654 | ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [, | |
14655 | REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported ( | |
14656 | CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR | |
14657 | ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( | |
14658 | FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, | |
14659 | DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), | |
14660 | pasv_wait ( NON_PASV_SERVER ), abort (), quit () | |
5d80033a JH |
14661 | |
14662 | =over 4 | |
14663 | ||
14664 | =item Methods for the adventurous | |
14665 | ||
14666 | quot (CMD [,ARGS]) | |
14667 | ||
14668 | =back | |
14669 | ||
14670 | =item THE dataconn CLASS | |
14671 | ||
14672 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), | |
53d7eaa8 | 14673 | bytes_read (), abort (), close () |
5d80033a JH |
14674 | |
14675 | =item UNIMPLEMENTED | |
14676 | ||
14677 | B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> | |
14678 | ||
14679 | =item REPORTING BUGS | |
14680 | ||
14681 | =item AUTHOR | |
14682 | ||
14683 | =item SEE ALSO | |
14684 | ||
53d7eaa8 JH |
14685 | =item USE EXAMPLES |
14686 | ||
14687 | http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz | |
14688 | ||
5d80033a JH |
14689 | =item CREDITS |
14690 | ||
14691 | =item COPYRIGHT | |
14692 | ||
14693 | =back | |
14694 | ||
14695 | =head2 Net::NNTP - NNTP Client class | |
14696 | ||
14697 | =over 4 | |
14698 | ||
14699 | =item SYNOPSIS | |
14700 | ||
14701 | =item DESCRIPTION | |
14702 | ||
14703 | =item CONSTRUCTOR | |
14704 | ||
14705 | new ( [ HOST ] [, OPTIONS ]) | |
14706 | ||
14707 | =item METHODS | |
14708 | ||
14709 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( | |
ff426ff2 JH |
14710 | [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ |
14711 | MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] | |
14712 | ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), | |
14713 | postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, | |
14714 | DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), | |
14715 | post ( [ MESSAGE ] ), postfh (), slave (), quit () | |
5d80033a JH |
14716 | |
14717 | =over 4 | |
14718 | ||
14719 | =item Extension methods | |
14720 | ||
14721 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), | |
14722 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN | |
14723 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( | |
14724 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ | |
14725 | GROUP ] ), reader | |
14726 | ||
14727 | =back | |
14728 | ||
14729 | =item UNSUPPORTED | |
14730 | ||
14731 | =item DEFINITIONS | |
14732 | ||
14733 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> | |
14734 | ||
14735 | =item SEE ALSO | |
14736 | ||
14737 | =item AUTHOR | |
14738 | ||
14739 | =item COPYRIGHT | |
14740 | ||
14741 | =back | |
14742 | ||
ff426ff2 | 14743 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) |
5d80033a JH |
14744 | |
14745 | =over 4 | |
14746 | ||
14747 | =item SYNOPSIS | |
14748 | ||
14749 | =item DESCRIPTION | |
14750 | ||
14751 | =item EXAMPLES | |
14752 | ||
14753 | =item CONSTRUCTOR | |
14754 | ||
14755 | new ( [ HOST, ] [ OPTIONS ] ) | |
14756 | ||
14757 | =item METHODS | |
14758 | ||
ff426ff2 JH |
14759 | user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [, |
14760 | PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM | |
14761 | [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ | |
14762 | MSGNUM ] ), delete ( MSGNUM ), reset (), quit () | |
5d80033a JH |
14763 | |
14764 | =item NOTES | |
14765 | ||
14766 | =item SEE ALSO | |
14767 | ||
14768 | =item AUTHOR | |
14769 | ||
14770 | =item COPYRIGHT | |
14771 | ||
14772 | =back | |
14773 | ||
8ebc5c01 | 14774 | =head2 Net::Ping - check a remote host for reachability |
7d2bfb28 | 14775 | |
d420ca49 | 14776 | =over 4 |
a45bd81d | 14777 | |
8ebc5c01 | 14778 | =item SYNOPSIS |
7d2bfb28 | 14779 | |
8ebc5c01 | 14780 | =item DESCRIPTION |
7d2bfb28 | 14781 | |
d420ca49 | 14782 | =over 4 |
8ebc5c01 | 14783 | |
14784 | =item Functions | |
7d2bfb28 | 14785 | |
04b01f78 JH |
14786 | Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, |
14787 | $p->bind($local_addr);, $p->ping($host [, $timeout]);, $p->open($host);, | |
14788 | $p->open($host);, $p->close();, pingecho($host [, $timeout]); | |
7d2bfb28 | 14789 | |
8ebc5c01 | 14790 | =back |
14791 | ||
493a87da JH |
14792 | =item WARNING |
14793 | ||
8ebc5c01 | 14794 | =item NOTES |
7d2bfb28 | 14795 | |
04b01f78 | 14796 | =item AUTHORS |
493a87da JH |
14797 | |
14798 | =item COPYRIGHT | |
14799 | ||
a45bd81d GS |
14800 | =back |
14801 | ||
5d80033a JH |
14802 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client |
14803 | ||
14804 | =over 4 | |
14805 | ||
14806 | =item SYNOPSIS | |
14807 | ||
14808 | =item DESCRIPTION | |
14809 | ||
14810 | =item EXAMPLES | |
14811 | ||
14812 | =item CONSTRUCTOR | |
14813 | ||
14814 | new Net::SMTP [ HOST, ] [ OPTIONS ] | |
14815 | ||
14816 | =item METHODS | |
14817 | ||
428dc699 JH |
14818 | banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME, |
14819 | PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail ( | |
14820 | ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [, | |
14821 | ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc ( | |
14822 | ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ | |
14823 | DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), | |
14824 | quit () | |
5d80033a JH |
14825 | |
14826 | =item SEE ALSO | |
14827 | ||
14828 | =item AUTHOR | |
14829 | ||
14830 | =item COPYRIGHT | |
14831 | ||
14832 | =back | |
14833 | ||
5d80033a JH |
14834 | =head2 Net::Time - time and daytime network client interface |
14835 | ||
14836 | =over 4 | |
14837 | ||
14838 | =item SYNOPSIS | |
14839 | ||
14840 | =item DESCRIPTION | |
14841 | ||
14842 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, | |
14843 | PROTOCOL [, TIMEOUT]]]) | |
14844 | ||
14845 | =item AUTHOR | |
14846 | ||
14847 | =item COPYRIGHT | |
14848 | ||
14849 | =back | |
14850 | ||
8ebc5c01 | 14851 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
14852 | functions | |
7d2bfb28 | 14853 | |
d420ca49 | 14854 | =over 4 |
a45bd81d | 14855 | |
8ebc5c01 | 14856 | =item SYNOPSIS |
7d2bfb28 | 14857 | |
8ebc5c01 | 14858 | =item DESCRIPTION |
7d2bfb28 | 14859 | |
cb1a09d0 AD |
14860 | =item EXAMPLES |
14861 | ||
8ebc5c01 | 14862 | =item NOTE |
cb1a09d0 | 14863 | |
8ebc5c01 | 14864 | =item AUTHOR |
cb1a09d0 | 14865 | |
a45bd81d GS |
14866 | =back |
14867 | ||
5d80033a JH |
14868 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions |
14869 | ||
14870 | =over 4 | |
14871 | ||
14872 | =item DESCRIPTION | |
14873 | ||
14874 | =over 4 | |
14875 | ||
14876 | =item Where to get this document | |
14877 | ||
14878 | =item How to contribute to this document | |
14879 | ||
14880 | =back | |
14881 | ||
14882 | =item Author and Copyright Information | |
14883 | ||
14884 | =over 4 | |
14885 | ||
14886 | =item Disclaimer | |
14887 | ||
14888 | =back | |
14889 | ||
14890 | =item Obtaining and installing libnet | |
14891 | ||
14892 | =over 4 | |
14893 | ||
14894 | =item What is libnet ? | |
14895 | ||
14896 | =item Which version of perl do I need ? | |
14897 | ||
14898 | =item What other modules do I need ? | |
14899 | ||
14900 | =item What machines support libnet ? | |
14901 | ||
14902 | =item Where can I get the latest libnet release | |
14903 | ||
14904 | =back | |
14905 | ||
14906 | =item Using Net::FTP | |
14907 | ||
14908 | =over 4 | |
14909 | ||
ba62762e | 14910 | =item How do I download files from an FTP server ? |
5d80033a JH |
14911 | |
14912 | =item How do I transfer files in binary mode ? | |
14913 | ||
14914 | =item How can I get the size of a file on a remote FTP server ? | |
14915 | ||
14916 | =item How can I get the modification time of a file on a remote FTP server | |
14917 | ? | |
14918 | ||
14919 | =item How can I change the permissions of a file on a remote server ? | |
14920 | ||
14921 | =item Can I do a reget operation like the ftp command ? | |
14922 | ||
ba62762e | 14923 | =item How do I get a directory listing from an FTP server ? |
5d80033a | 14924 | |
ba62762e | 14925 | =item Changing directory to "" does not fail ? |
5d80033a JH |
14926 | |
14927 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? | |
14928 | ||
ba62762e | 14929 | =item I am behind an FTP proxy firewall, but cannot access machines outside |
5d80033a JH |
14930 | ? |
14931 | ||
14932 | =item My ftp proxy firewall does not listen on port 21 | |
14933 | ||
14934 | =item Is it possible to change the file permissions of a file on an FTP | |
14935 | server ? | |
14936 | ||
14937 | =item I have seen scripts call a method message, but cannot find it | |
14938 | documented ? | |
14939 | ||
14940 | =item Why does Net::FTP not implement mput and mget methods | |
14941 | ||
14942 | =back | |
14943 | ||
14944 | =item Using Net::SMTP | |
14945 | ||
14946 | =over 4 | |
14947 | ||
14948 | =item Why can't the part of an Email address after the @ be used as the | |
14949 | hostname ? | |
14950 | ||
14951 | =item Why does Net::SMTP not do DNS MX lookups ? | |
14952 | ||
14953 | =item The verify method always returns true ? | |
14954 | ||
14955 | =back | |
14956 | ||
14957 | =item Debugging scripts | |
14958 | ||
14959 | =over 4 | |
14960 | ||
14961 | =item How can I debug my scripts that use Net::* modules ? | |
14962 | ||
14963 | =back | |
14964 | ||
14965 | =item AUTHOR AND COPYRIGHT | |
14966 | ||
14967 | =back | |
14968 | ||
8ebc5c01 | 14969 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
14970 | functions | |
cb1a09d0 | 14971 | |
d420ca49 | 14972 | =over 4 |
a45bd81d | 14973 | |
8ebc5c01 | 14974 | =item SYNOPSIS |
cb1a09d0 | 14975 | |
8ebc5c01 | 14976 | =item DESCRIPTION |
cb1a09d0 | 14977 | |
8ebc5c01 | 14978 | =item EXAMPLES |
cb1a09d0 | 14979 | |
8ebc5c01 | 14980 | =item NOTE |
cb1a09d0 | 14981 | |
8ebc5c01 | 14982 | =item AUTHOR |
cb1a09d0 | 14983 | |
a45bd81d GS |
14984 | =back |
14985 | ||
8ebc5c01 | 14986 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
14987 | functions | |
cb1a09d0 | 14988 | |
d420ca49 | 14989 | =over 4 |
a45bd81d | 14990 | |
8ebc5c01 | 14991 | =item SYNOPSIS |
cb1a09d0 AD |
14992 | |
14993 | =item DESCRIPTION | |
14994 | ||
8ebc5c01 | 14995 | =item NOTE |
cb1a09d0 | 14996 | |
8ebc5c01 | 14997 | =item AUTHOR |
cb1a09d0 | 14998 | |
a45bd81d GS |
14999 | =back |
15000 | ||
8ebc5c01 | 15001 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
15002 | functions | |
cb1a09d0 | 15003 | |
d420ca49 | 15004 | =over 4 |
a45bd81d | 15005 | |
cb1a09d0 AD |
15006 | =item SYNOPSIS |
15007 | ||
cb1a09d0 AD |
15008 | =item DESCRIPTION |
15009 | ||
8ebc5c01 | 15010 | =item EXAMPLES |
cb1a09d0 | 15011 | |
8ebc5c01 | 15012 | =item NOTE |
cb1a09d0 | 15013 | |
8ebc5c01 | 15014 | =item AUTHOR |
cb1a09d0 | 15015 | |
a45bd81d GS |
15016 | =back |
15017 | ||
5d80033a JH |
15018 | =head2 Netrc, Net::Netrc - OO interface to users netrc file |
15019 | ||
15020 | =over 4 | |
15021 | ||
15022 | =item SYNOPSIS | |
15023 | ||
15024 | =item DESCRIPTION | |
15025 | ||
15026 | =item THE .netrc FILE | |
15027 | ||
15028 | machine name, default, login name, password string, account string, macdef | |
15029 | name | |
15030 | ||
15031 | =item CONSTRUCTOR | |
15032 | ||
15033 | lookup ( MACHINE [, LOGIN ]) | |
15034 | ||
15035 | =item METHODS | |
15036 | ||
15037 | login (), password (), account (), lpa () | |
15038 | ||
15039 | =item AUTHOR | |
15040 | ||
15041 | =item SEE ALSO | |
15042 | ||
15043 | =item COPYRIGHT | |
15044 | ||
15045 | =back | |
15046 | ||
8ebc5c01 | 15047 | =head2 ODBM_File - Tied access to odbm files |
cb1a09d0 | 15048 | |
d420ca49 | 15049 | =over 4 |
a45bd81d | 15050 | |
cb1a09d0 AD |
15051 | =item SYNOPSIS |
15052 | ||
4d4e713d JH |
15053 | =item DESCRIPTION |
15054 | ||
a9ef4385 JH |
15055 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
15056 | ||
15057 | =item DIAGNOSTICS | |
15058 | ||
d420ca49 | 15059 | =over 4 |
a9ef4385 JH |
15060 | |
15061 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
15062 | ||
15063 | =back | |
15064 | ||
15065 | =item BUGS AND WARNINGS | |
cb1a09d0 | 15066 | |
a45bd81d GS |
15067 | =back |
15068 | ||
8ebc5c01 | 15069 | =head2 Opcode - Disable named opcodes when compiling perl code |
cb1a09d0 | 15070 | |
d420ca49 | 15071 | =over 4 |
a45bd81d | 15072 | |
8ebc5c01 | 15073 | =item SYNOPSIS |
cb1a09d0 | 15074 | |
8ebc5c01 | 15075 | =item DESCRIPTION |
cb1a09d0 | 15076 | |
8ebc5c01 | 15077 | =item NOTE |
cb1a09d0 | 15078 | |
8ebc5c01 | 15079 | =item WARNING |
cb1a09d0 | 15080 | |
8ebc5c01 | 15081 | =item Operator Names and Operator Lists |
cb1a09d0 | 15082 | |
8ebc5c01 | 15083 | an operator name (opname), an operator tag name (optag), a negated opname |
15084 | or optag, an operator set (opset) | |
cb1a09d0 | 15085 | |
8ebc5c01 | 15086 | =item Opcode Functions |
cb1a09d0 | 15087 | |
8ebc5c01 | 15088 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
15089 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
15090 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
15091 | opdump (PAT) | |
cb1a09d0 | 15092 | |
8ebc5c01 | 15093 | =item Manipulating Opsets |
cb1a09d0 | 15094 | |
8ebc5c01 | 15095 | =item TO DO (maybe) |
cb1a09d0 | 15096 | |
a45bd81d GS |
15097 | =back |
15098 | ||
d420ca49 | 15099 | =over 4 |
a45bd81d | 15100 | |
8ebc5c01 | 15101 | =item Predefined Opcode Tags |
cb1a09d0 | 15102 | |
8ebc5c01 | 15103 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
d516a115 JH |
15104 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
15105 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
15106 | :dangerous | |
cb1a09d0 | 15107 | |
8ebc5c01 | 15108 | =item SEE ALSO |
cb1a09d0 | 15109 | |
8ebc5c01 | 15110 | =item AUTHORS |
cb1a09d0 | 15111 | |
a45bd81d GS |
15112 | =back |
15113 | ||
8ebc5c01 | 15114 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
15115 | compartments | |
cb1a09d0 | 15116 | |
d420ca49 | 15117 | =over 4 |
a45bd81d | 15118 | |
cb1a09d0 AD |
15119 | =item SYNOPSIS |
15120 | ||
cb1a09d0 AD |
15121 | =item DESCRIPTION |
15122 | ||
8ebc5c01 | 15123 | a new namespace, an operator mask |
15124 | ||
15125 | =item WARNING | |
cb1a09d0 | 15126 | |
d420ca49 | 15127 | =over 4 |
cb1a09d0 | 15128 | |
8ebc5c01 | 15129 | =item RECENT CHANGES |
cb1a09d0 | 15130 | |
8ebc5c01 | 15131 | =item Methods in class Safe |
cb1a09d0 | 15132 | |
8ebc5c01 | 15133 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
15134 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
15135 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
15136 | root (NAMESPACE), mask (MASK) | |
cb1a09d0 | 15137 | |
8ebc5c01 | 15138 | =item Some Safety Issues |
cb1a09d0 | 15139 | |
8ebc5c01 | 15140 | Memory, CPU, Snooping, Signals, State Changes |
cb1a09d0 | 15141 | |
8ebc5c01 | 15142 | =item AUTHOR |
cb1a09d0 | 15143 | |
8ebc5c01 | 15144 | =back |
cb1a09d0 | 15145 | |
a45bd81d GS |
15146 | =back |
15147 | ||
8ebc5c01 | 15148 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
15149 | compiling | |
cb1a09d0 | 15150 | |
d420ca49 | 15151 | =over 4 |
a45bd81d | 15152 | |
14218588 | 15153 | =item SYNOPSIS |
cb1a09d0 | 15154 | |
8ebc5c01 | 15155 | =item DESCRIPTION |
cb1a09d0 | 15156 | |
8ebc5c01 | 15157 | =item SEE ALSO |
cb1a09d0 | 15158 | |
a45bd81d GS |
15159 | =back |
15160 | ||
cb1a09d0 AD |
15161 | =head2 POSIX - Perl interface to IEEE Std 1003.1 |
15162 | ||
d420ca49 | 15163 | =over 4 |
a45bd81d | 15164 | |
cb1a09d0 AD |
15165 | =item SYNOPSIS |
15166 | ||
cb1a09d0 AD |
15167 | =item DESCRIPTION |
15168 | ||
cb1a09d0 AD |
15169 | =item NOTE |
15170 | ||
8ebc5c01 | 15171 | =item CAVEATS |
cb1a09d0 AD |
15172 | |
15173 | =item FUNCTIONS | |
15174 | ||
8ebc5c01 | 15175 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
15176 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
15177 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
15178 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
15179 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
15180 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
15181 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
15182 | fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, | |
15183 | getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, | |
15184 | getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, | |
15185 | iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, | |
15186 | isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, | |
15187 | longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, | |
15188 | memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, | |
15189 | opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, | |
15190 | qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, | |
15191 | rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, | |
15192 | setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
15193 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
15194 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
4755096e GS |
15195 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, |
15196 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
15197 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
15198 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
15199 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
15200 | wctomb, write | |
cb1a09d0 AD |
15201 | |
15202 | =item CLASSES | |
15203 | ||
d420ca49 | 15204 | =over 4 |
cb1a09d0 | 15205 | |
cb1a09d0 AD |
15206 | =item POSIX::SigAction |
15207 | ||
cb1a09d0 AD |
15208 | new |
15209 | ||
15210 | =item POSIX::SigSet | |
15211 | ||
cb1a09d0 AD |
15212 | new, addset, delset, emptyset, fillset, ismember |
15213 | ||
15214 | =item POSIX::Termios | |
15215 | ||
cb1a09d0 AD |
15216 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
15217 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
15218 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
15219 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
15220 | values, c_oflag field values | |
15221 | ||
cb1a09d0 AD |
15222 | =back |
15223 | ||
15224 | =item PATHNAME CONSTANTS | |
15225 | ||
cb1a09d0 AD |
15226 | Constants |
15227 | ||
15228 | =item POSIX CONSTANTS | |
15229 | ||
cb1a09d0 AD |
15230 | Constants |
15231 | ||
15232 | =item SYSTEM CONFIGURATION | |
15233 | ||
cb1a09d0 AD |
15234 | Constants |
15235 | ||
15236 | =item ERRNO | |
15237 | ||
cb1a09d0 AD |
15238 | Constants |
15239 | ||
15240 | =item FCNTL | |
15241 | ||
cb1a09d0 AD |
15242 | Constants |
15243 | ||
15244 | =item FLOAT | |
15245 | ||
cb1a09d0 AD |
15246 | Constants |
15247 | ||
15248 | =item LIMITS | |
15249 | ||
cb1a09d0 AD |
15250 | Constants |
15251 | ||
15252 | =item LOCALE | |
15253 | ||
cb1a09d0 AD |
15254 | Constants |
15255 | ||
15256 | =item MATH | |
15257 | ||
cb1a09d0 AD |
15258 | Constants |
15259 | ||
15260 | =item SIGNAL | |
15261 | ||
cb1a09d0 AD |
15262 | Constants |
15263 | ||
15264 | =item STAT | |
15265 | ||
cb1a09d0 AD |
15266 | Constants, Macros |
15267 | ||
15268 | =item STDLIB | |
15269 | ||
cb1a09d0 AD |
15270 | Constants |
15271 | ||
15272 | =item STDIO | |
15273 | ||
cb1a09d0 AD |
15274 | Constants |
15275 | ||
15276 | =item TIME | |
15277 | ||
cb1a09d0 AD |
15278 | Constants |
15279 | ||
15280 | =item UNISTD | |
15281 | ||
cb1a09d0 AD |
15282 | Constants |
15283 | ||
15284 | =item WAIT | |
15285 | ||
04b01f78 JH |
15286 | Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, |
15287 | WTERMSIG, WIFSTOPPED, WSTOPSIG | |
cb1a09d0 | 15288 | |
a45bd81d GS |
15289 | =back |
15290 | ||
0d0e97a6 JH |
15291 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* |
15292 | name space | |
15293 | ||
15294 | =over 4 | |
15295 | ||
15296 | =item SYNOPSIS | |
15297 | ||
15298 | =item DESCRIPTION | |
15299 | ||
15300 | unix, stdio, perlio, crlf, utf8, raw | |
15301 | ||
15302 | =over 4 | |
15303 | ||
15304 | =item Defaults and how to override them | |
15305 | ||
15306 | =back | |
15307 | ||
15308 | =item AUTHOR | |
15309 | ||
15310 | =item SEE ALSO | |
15311 | ||
15312 | =back | |
15313 | ||
15314 | =head2 PerlIO::Scalar - support module for in-memory IO. | |
15315 | ||
15316 | =over 4 | |
15317 | ||
15318 | =item SYNOPSIS | |
15319 | ||
15320 | =item DESCRIPTION | |
15321 | ||
15322 | =back | |
15323 | ||
15324 | =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl | |
15325 | ||
15326 | =over 4 | |
15327 | ||
15328 | =item SYNOPSIS | |
15329 | ||
15330 | =item DESCRIPTION | |
15331 | ||
34babc16 | 15332 | $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), |
0d0e97a6 JH |
15333 | $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), |
15334 | $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), | |
15335 | $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), | |
15336 | $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), | |
15337 | $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), | |
15338 | $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) | |
15339 | ||
428dc699 JH |
15340 | =over 4 |
15341 | ||
15342 | =item Example - a Hexadecimal Handle | |
15343 | ||
15344 | =back | |
15345 | ||
0d0e97a6 JH |
15346 | =back |
15347 | ||
14218588 GS |
15348 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
15349 | ||
d420ca49 | 15350 | =over 4 |
a45bd81d | 15351 | |
14218588 GS |
15352 | =item SYNOPSIS |
15353 | ||
15354 | =item OPTIONS/ARGUMENTS | |
15355 | ||
d420ca49 | 15356 | =over 4 |
a45bd81d | 15357 | |
694468e3 | 15358 | =item podchecker() |
a45bd81d GS |
15359 | |
15360 | B<-warnings> =E<gt> I<val> | |
15361 | ||
15362 | =back | |
15363 | ||
14218588 GS |
15364 | =item DESCRIPTION |
15365 | ||
694468e3 GS |
15366 | =item DIAGNOSTICS |
15367 | ||
d420ca49 | 15368 | =over 4 |
a45bd81d | 15369 | |
694468e3 GS |
15370 | =item Errors |
15371 | ||
15372 | empty =headn, =over on line I<N> without closing =back, =item without | |
15373 | previous =over, =back without previous =over, No argument for =begin, =end | |
15374 | without =begin, Nested =begin's, =for without formatter specification, | |
15375 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
15376 | interior-sequence "I<SEQ>", nested commands | |
15377 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
15378 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
15379 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
15380 | after =back | |
15381 | ||
a45bd81d GS |
15382 | =item Warnings |
15383 | ||
93d73c42 | 15384 | multiple occurence of link target I<name>, line containing nothing but |
4d4e713d JH |
15385 | whitespace in paragraph, file does not start with =head, previous =item has |
15386 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> | |
15387 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No | |
15388 | items in =over, No argument for =item, empty section in previous paragraph, | |
15389 | Verbatim paragraph in NAME section | |
10862624 RF |
15390 | |
15391 | =item Hyperlinks | |
15392 | ||
4d4e713d JH |
15393 | ignoring leading/trailing whitespace in link, (section) in '$page' |
15394 | deprecated, alternative text/node '%s' contains non-escaped | or / | |
a45bd81d | 15395 | |
694468e3 | 15396 | =back |
a45bd81d GS |
15397 | |
15398 | =item RETURN VALUE | |
15399 | ||
14218588 GS |
15400 | =item EXAMPLES |
15401 | ||
694468e3 GS |
15402 | =item INTERFACE |
15403 | ||
15404 | =back | |
15405 | ||
10862624 RF |
15406 | C<Pod::Checker-E<gt>new( %options )> |
15407 | ||
694468e3 GS |
15408 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, |
15409 | @args )> | |
15410 | ||
15411 | C<$checker-E<gt>num_errors()> | |
15412 | ||
15413 | C<$checker-E<gt>name()> | |
15414 | ||
15415 | C<$checker-E<gt>node()> | |
15416 | ||
15417 | C<$checker-E<gt>idx()> | |
15418 | ||
15419 | C<$checker-E<gt>hyperlink()> | |
15420 | ||
d420ca49 | 15421 | =over 4 |
694468e3 | 15422 | |
14218588 GS |
15423 | =item AUTHOR |
15424 | ||
a45bd81d GS |
15425 | =back |
15426 | ||
694468e3 | 15427 | =head2 Pod::Find - find POD documents in directory trees |
a45bd81d | 15428 | |
d420ca49 | 15429 | =over 4 |
a45bd81d GS |
15430 | |
15431 | =item SYNOPSIS | |
15432 | ||
15433 | =item DESCRIPTION | |
15434 | ||
10862624 RF |
15435 | =back |
15436 | ||
d420ca49 | 15437 | =over 4 |
10862624 RF |
15438 | |
15439 | =item C<pod_find( { %opts } , @directories )> | |
a45bd81d | 15440 | |
10862624 RF |
15441 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> |
15442 | 1> | |
15443 | ||
15444 | =back | |
15445 | ||
d420ca49 | 15446 | =over 4 |
10862624 RF |
15447 | |
15448 | =item C<simplify_name( $str )> | |
15449 | ||
15450 | =back | |
15451 | ||
d420ca49 | 15452 | =over 4 |
10862624 RF |
15453 | |
15454 | =item C<pod_where( { %opts }, $pod )> | |
15455 | ||
15456 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
15457 | 1> | |
15458 | ||
15459 | =back | |
15460 | ||
d420ca49 | 15461 | =over 4 |
10862624 RF |
15462 | |
15463 | =item C<contains_pod( $file , $verbose )> | |
15464 | ||
15465 | =back | |
15466 | ||
d420ca49 | 15467 | =over 4 |
a45bd81d GS |
15468 | |
15469 | =item AUTHOR | |
15470 | ||
694468e3 GS |
15471 | =item SEE ALSO |
15472 | ||
a45bd81d GS |
15473 | =back |
15474 | ||
193fb0af | 15475 | =head2 Pod::Html - module to convert pod files to HTML |
54310121 | 15476 | |
d420ca49 | 15477 | =over 4 |
a45bd81d | 15478 | |
54310121 | 15479 | =item SYNOPSIS |
15480 | ||
15481 | =item DESCRIPTION | |
15482 | ||
15483 | =item ARGUMENTS | |
15484 | ||
d2f2ce36 JH |
15485 | backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, |
15486 | infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, | |
15487 | title, verbose | |
54310121 | 15488 | |
15489 | =item EXAMPLE | |
15490 | ||
c76ac1ee GS |
15491 | =item ENVIRONMENT |
15492 | ||
54310121 | 15493 | =item AUTHOR |
15494 | ||
54310121 | 15495 | =item SEE ALSO |
15496 | ||
15497 | =item COPYRIGHT | |
15498 | ||
a45bd81d GS |
15499 | =back |
15500 | ||
14218588 GS |
15501 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
15502 | commands, etc. | |
15503 | ||
d420ca49 | 15504 | =over 4 |
a45bd81d | 15505 | |
14218588 GS |
15506 | =item SYNOPSIS |
15507 | ||
15508 | =item REQUIRES | |
15509 | ||
15510 | =item EXPORTS | |
15511 | ||
15512 | =item DESCRIPTION | |
15513 | ||
10862624 RF |
15514 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package |
15515 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
14218588 | 15516 | |
a45bd81d GS |
15517 | =back |
15518 | ||
d420ca49 | 15519 | =over 4 |
a45bd81d | 15520 | |
14218588 GS |
15521 | =item B<Pod::InputSource> |
15522 | ||
a45bd81d GS |
15523 | =back |
15524 | ||
d420ca49 | 15525 | =over 4 |
14218588 GS |
15526 | |
15527 | =item B<new()> | |
15528 | ||
a45bd81d GS |
15529 | =back |
15530 | ||
d420ca49 | 15531 | =over 4 |
a45bd81d | 15532 | |
14218588 GS |
15533 | =item B<name()> |
15534 | ||
a45bd81d GS |
15535 | =back |
15536 | ||
d420ca49 | 15537 | =over 4 |
a45bd81d | 15538 | |
14218588 GS |
15539 | =item B<handle()> |
15540 | ||
a45bd81d GS |
15541 | =back |
15542 | ||
d420ca49 | 15543 | =over 4 |
a45bd81d | 15544 | |
14218588 GS |
15545 | =item B<was_cutting()> |
15546 | ||
15547 | =back | |
15548 | ||
d420ca49 | 15549 | =over 4 |
a45bd81d | 15550 | |
14218588 GS |
15551 | =item B<Pod::Paragraph> |
15552 | ||
a45bd81d GS |
15553 | =back |
15554 | ||
d420ca49 | 15555 | =over 4 |
14218588 | 15556 | |
10862624 | 15557 | =item Pod::Paragraph-E<gt>B<new()> |
14218588 | 15558 | |
a45bd81d GS |
15559 | =back |
15560 | ||
d420ca49 | 15561 | =over 4 |
a45bd81d | 15562 | |
10862624 | 15563 | =item $pod_para-E<gt>B<cmd_name()> |
14218588 | 15564 | |
a45bd81d GS |
15565 | =back |
15566 | ||
d420ca49 | 15567 | =over 4 |
a45bd81d | 15568 | |
10862624 | 15569 | =item $pod_para-E<gt>B<text()> |
14218588 | 15570 | |
a45bd81d GS |
15571 | =back |
15572 | ||
d420ca49 | 15573 | =over 4 |
a45bd81d | 15574 | |
10862624 | 15575 | =item $pod_para-E<gt>B<raw_text()> |
14218588 | 15576 | |
a45bd81d GS |
15577 | =back |
15578 | ||
d420ca49 | 15579 | =over 4 |
a45bd81d | 15580 | |
10862624 | 15581 | =item $pod_para-E<gt>B<cmd_prefix()> |
14218588 | 15582 | |
a45bd81d GS |
15583 | =back |
15584 | ||
d420ca49 | 15585 | =over 4 |
a45bd81d | 15586 | |
10862624 | 15587 | =item $pod_para-E<gt>B<cmd_separator()> |
14218588 | 15588 | |
a45bd81d GS |
15589 | =back |
15590 | ||
d420ca49 | 15591 | =over 4 |
a45bd81d | 15592 | |
10862624 | 15593 | =item $pod_para-E<gt>B<parse_tree()> |
14218588 | 15594 | |
a45bd81d GS |
15595 | =back |
15596 | ||
d420ca49 | 15597 | =over 4 |
a45bd81d | 15598 | |
10862624 | 15599 | =item $pod_para-E<gt>B<file_line()> |
14218588 GS |
15600 | |
15601 | =back | |
15602 | ||
d420ca49 | 15603 | =over 4 |
a45bd81d | 15604 | |
14218588 GS |
15605 | =item B<Pod::InteriorSequence> |
15606 | ||
a45bd81d GS |
15607 | =back |
15608 | ||
d420ca49 | 15609 | =over 4 |
14218588 | 15610 | |
10862624 | 15611 | =item Pod::InteriorSequence-E<gt>B<new()> |
14218588 | 15612 | |
a45bd81d GS |
15613 | =back |
15614 | ||
d420ca49 | 15615 | =over 4 |
a45bd81d | 15616 | |
10862624 | 15617 | =item $pod_seq-E<gt>B<cmd_name()> |
14218588 | 15618 | |
a45bd81d GS |
15619 | =back |
15620 | ||
d420ca49 | 15621 | =over 4 |
a45bd81d | 15622 | |
10862624 | 15623 | =item $pod_seq-E<gt>B<prepend()> |
14218588 | 15624 | |
a45bd81d GS |
15625 | =back |
15626 | ||
d420ca49 | 15627 | =over 4 |
a45bd81d | 15628 | |
10862624 | 15629 | =item $pod_seq-E<gt>B<append()> |
14218588 | 15630 | |
a45bd81d GS |
15631 | =back |
15632 | ||
d420ca49 | 15633 | =over 4 |
a45bd81d | 15634 | |
10862624 | 15635 | =item $pod_seq-E<gt>B<nested()> |
14218588 | 15636 | |
a45bd81d GS |
15637 | =back |
15638 | ||
d420ca49 | 15639 | =over 4 |
a45bd81d | 15640 | |
10862624 | 15641 | =item $pod_seq-E<gt>B<raw_text()> |
14218588 | 15642 | |
a45bd81d GS |
15643 | =back |
15644 | ||
d420ca49 | 15645 | =over 4 |
a45bd81d | 15646 | |
10862624 | 15647 | =item $pod_seq-E<gt>B<left_delimiter()> |
14218588 | 15648 | |
a45bd81d GS |
15649 | =back |
15650 | ||
d420ca49 | 15651 | =over 4 |
a45bd81d | 15652 | |
10862624 | 15653 | =item $pod_seq-E<gt>B<right_delimiter()> |
14218588 | 15654 | |
a45bd81d GS |
15655 | =back |
15656 | ||
d420ca49 | 15657 | =over 4 |
a45bd81d | 15658 | |
10862624 | 15659 | =item $pod_seq-E<gt>B<parse_tree()> |
14218588 | 15660 | |
a45bd81d GS |
15661 | =back |
15662 | ||
d420ca49 | 15663 | =over 4 |
a45bd81d | 15664 | |
10862624 | 15665 | =item $pod_seq-E<gt>B<file_line()> |
14218588 | 15666 | |
a45bd81d GS |
15667 | =back |
15668 | ||
d420ca49 | 15669 | =over 4 |
a45bd81d | 15670 | |
10862624 | 15671 | =item Pod::InteriorSequence::B<DESTROY()> |
14218588 GS |
15672 | |
15673 | =back | |
15674 | ||
d420ca49 | 15675 | =over 4 |
a45bd81d | 15676 | |
14218588 GS |
15677 | =item B<Pod::ParseTree> |
15678 | ||
a45bd81d GS |
15679 | =back |
15680 | ||
d420ca49 | 15681 | =over 4 |
14218588 | 15682 | |
10862624 | 15683 | =item Pod::ParseTree-E<gt>B<new()> |
14218588 | 15684 | |
a45bd81d GS |
15685 | =back |
15686 | ||
d420ca49 | 15687 | =over 4 |
a45bd81d | 15688 | |
10862624 | 15689 | =item $ptree-E<gt>B<top()> |
14218588 | 15690 | |
a45bd81d GS |
15691 | =back |
15692 | ||
d420ca49 | 15693 | =over 4 |
a45bd81d | 15694 | |
10862624 | 15695 | =item $ptree-E<gt>B<children()> |
14218588 | 15696 | |
a45bd81d GS |
15697 | =back |
15698 | ||
d420ca49 | 15699 | =over 4 |
a45bd81d | 15700 | |
10862624 | 15701 | =item $ptree-E<gt>B<prepend()> |
14218588 | 15702 | |
a45bd81d GS |
15703 | =back |
15704 | ||
d420ca49 | 15705 | =over 4 |
a45bd81d | 15706 | |
10862624 | 15707 | =item $ptree-E<gt>B<append()> |
14218588 | 15708 | |
a45bd81d GS |
15709 | =back |
15710 | ||
d420ca49 | 15711 | =over 4 |
a45bd81d | 15712 | |
10862624 | 15713 | =item $ptree-E<gt>B<raw_text()> |
14218588 | 15714 | |
a45bd81d GS |
15715 | =back |
15716 | ||
d420ca49 | 15717 | =over 4 |
a45bd81d | 15718 | |
10862624 | 15719 | =item Pod::ParseTree::B<DESTROY()> |
14218588 GS |
15720 | |
15721 | =back | |
15722 | ||
d420ca49 | 15723 | =over 4 |
a45bd81d | 15724 | |
14218588 GS |
15725 | =item SEE ALSO |
15726 | ||
15727 | =item AUTHOR | |
15728 | ||
a45bd81d GS |
15729 | =back |
15730 | ||
497711e7 GS |
15731 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex |
15732 | ||
d420ca49 | 15733 | =over 4 |
497711e7 GS |
15734 | |
15735 | =item SYNOPSIS | |
15736 | ||
15737 | =item DESCRIPTION | |
15738 | ||
15739 | =back | |
15740 | ||
d420ca49 | 15741 | =over 4 |
497711e7 GS |
15742 | |
15743 | =item OBJECT METHODS | |
15744 | ||
15745 | C<initialize> | |
15746 | ||
15747 | =back | |
15748 | ||
d420ca49 | 15749 | =over 4 |
497711e7 GS |
15750 | |
15751 | =item Data Accessors | |
15752 | ||
15753 | B<AddPreamble> | |
15754 | ||
15755 | =back | |
15756 | ||
15757 | B<AddPostamble> | |
15758 | ||
15759 | B<Head1Level> | |
15760 | ||
15761 | B<Label> | |
15762 | ||
15763 | B<LevelNoNum> | |
15764 | ||
15765 | B<MakeIndex> | |
15766 | ||
15767 | B<ReplaceNAMEwithSection> | |
15768 | ||
15769 | B<StartWithNewPage> | |
15770 | ||
15771 | B<TableOfContents> | |
15772 | ||
15773 | B<UniqueLabels> | |
15774 | ||
15775 | B<UserPreamble> | |
15776 | ||
15777 | B<UserPostamble> | |
15778 | ||
15779 | B<Lists> | |
15780 | ||
d420ca49 | 15781 | =over 4 |
497711e7 GS |
15782 | |
15783 | =item Subclassed methods | |
15784 | ||
15785 | =back | |
15786 | ||
15787 | B<begin_pod> | |
15788 | ||
15789 | B<end_pod> | |
15790 | ||
15791 | B<command> | |
15792 | ||
15793 | B<verbatim> | |
15794 | ||
15795 | B<textblock> | |
15796 | ||
15797 | B<interior_sequence> | |
15798 | ||
d420ca49 | 15799 | =over 4 |
497711e7 GS |
15800 | |
15801 | =item List Methods | |
15802 | ||
15803 | B<begin_list> | |
15804 | ||
15805 | =back | |
15806 | ||
15807 | B<end_list> | |
15808 | ||
15809 | B<add_item> | |
15810 | ||
d420ca49 | 15811 | =over 4 |
497711e7 GS |
15812 | |
15813 | =item Methods for headings | |
15814 | ||
15815 | B<head> | |
15816 | ||
15817 | =back | |
15818 | ||
d420ca49 | 15819 | =over 4 |
497711e7 GS |
15820 | |
15821 | =item Internal methods | |
15822 | ||
15823 | B<_output> | |
15824 | ||
15825 | =back | |
15826 | ||
15827 | B<_replace_special_chars> | |
15828 | ||
428dc699 JH |
15829 | B<_replace_special_chars_late> |
15830 | ||
497711e7 GS |
15831 | B<_create_label> |
15832 | ||
15833 | B<_create_index> | |
15834 | ||
15835 | B<_clean_latex_commands> | |
15836 | ||
428dc699 JH |
15837 | B<_split_delimited> |
15838 | ||
d420ca49 | 15839 | =over 4 |
497711e7 GS |
15840 | |
15841 | =item NOTES | |
15842 | ||
15843 | =item SEE ALSO | |
15844 | ||
15845 | =item AUTHORS | |
15846 | ||
15847 | =item COPYRIGHT | |
15848 | ||
15849 | =item REVISION | |
15850 | ||
15851 | =back | |
15852 | ||
c76ac1ee GS |
15853 | =head2 Pod::Man - Convert POD data to formatted *roff input |
15854 | ||
d420ca49 | 15855 | =over 4 |
a45bd81d | 15856 | |
c76ac1ee GS |
15857 | =item SYNOPSIS |
15858 | ||
15859 | =item DESCRIPTION | |
15860 | ||
07fcf8ff | 15861 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, |
91331b4f | 15862 | release, section |
c76ac1ee GS |
15863 | |
15864 | =item DIAGNOSTICS | |
15865 | ||
91331b4f | 15866 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote |
9cd42e2a | 15867 | specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown |
34babc16 JH |
15868 | escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched |
15869 | =back | |
c76ac1ee GS |
15870 | |
15871 | =item BUGS | |
15872 | ||
34babc16 JH |
15873 | =item CAVEATS |
15874 | ||
c76ac1ee GS |
15875 | =item SEE ALSO |
15876 | ||
15877 | =item AUTHOR | |
15878 | ||
d0363f02 JH |
15879 | =item COPYRIGHT AND LICENSE |
15880 | ||
a45bd81d GS |
15881 | =back |
15882 | ||
248e172a | 15883 | =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text |
07fcf8ff JH |
15884 | |
15885 | =over 4 | |
15886 | ||
15887 | =item SYNOPSIS | |
15888 | ||
15889 | =item DESCRIPTION | |
15890 | ||
15891 | =item AUTHOR | |
15892 | ||
15893 | =item COPYRIGHT AND LICENSE | |
15894 | ||
15895 | =back | |
15896 | ||
694468e3 GS |
15897 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion |
15898 | ||
d420ca49 | 15899 | =over 4 |
694468e3 GS |
15900 | |
15901 | =item SYNOPSIS | |
15902 | ||
15903 | =item DESCRIPTION | |
15904 | ||
15905 | =back | |
15906 | ||
d420ca49 | 15907 | =over 4 |
694468e3 GS |
15908 | |
15909 | =item Pod::List | |
15910 | ||
10862624 | 15911 | Pod::List-E<gt>new() |
694468e3 GS |
15912 | |
15913 | =back | |
15914 | ||
10862624 | 15915 | $list-E<gt>file() |
694468e3 | 15916 | |
10862624 | 15917 | $list-E<gt>start() |
694468e3 | 15918 | |
10862624 | 15919 | $list-E<gt>indent() |
694468e3 | 15920 | |
10862624 | 15921 | $list-E<gt>type() |
694468e3 | 15922 | |
10862624 | 15923 | $list-E<gt>rx() |
694468e3 | 15924 | |
10862624 | 15925 | $list-E<gt>item() |
694468e3 | 15926 | |
10862624 | 15927 | $list-E<gt>parent() |
694468e3 | 15928 | |
10862624 | 15929 | $list-E<gt>tag() |
694468e3 | 15930 | |
d420ca49 | 15931 | =over 4 |
694468e3 GS |
15932 | |
15933 | =item Pod::Hyperlink | |
15934 | ||
10862624 | 15935 | Pod::Hyperlink-E<gt>new() |
694468e3 GS |
15936 | |
15937 | =back | |
15938 | ||
10862624 | 15939 | $link-E<gt>parse($string) |
694468e3 | 15940 | |
10862624 | 15941 | $link-E<gt>markup($string) |
694468e3 | 15942 | |
10862624 | 15943 | $link-E<gt>text() |
694468e3 | 15944 | |
10862624 | 15945 | $link-E<gt>warning() |
694468e3 | 15946 | |
10862624 | 15947 | $link-E<gt>file(), $link-E<gt>line() |
694468e3 | 15948 | |
10862624 | 15949 | $link-E<gt>page() |
694468e3 | 15950 | |
10862624 | 15951 | $link-E<gt>node() |
694468e3 | 15952 | |
10862624 | 15953 | $link-E<gt>alttext() |
694468e3 | 15954 | |
10862624 | 15955 | $link-E<gt>type() |
694468e3 | 15956 | |
10862624 | 15957 | $link-E<gt>link() |
694468e3 | 15958 | |
d420ca49 | 15959 | =over 4 |
694468e3 GS |
15960 | |
15961 | =item Pod::Cache | |
15962 | ||
10862624 | 15963 | Pod::Cache-E<gt>new() |
694468e3 GS |
15964 | |
15965 | =back | |
15966 | ||
10862624 | 15967 | $cache-E<gt>item() |
694468e3 | 15968 | |
10862624 | 15969 | $cache-E<gt>find_page($name) |
694468e3 | 15970 | |
d420ca49 | 15971 | =over 4 |
694468e3 GS |
15972 | |
15973 | =item Pod::Cache::Item | |
15974 | ||
10862624 | 15975 | Pod::Cache::Item-E<gt>new() |
694468e3 GS |
15976 | |
15977 | =back | |
15978 | ||
10862624 | 15979 | $cacheitem-E<gt>page() |
694468e3 | 15980 | |
10862624 | 15981 | $cacheitem-E<gt>description() |
694468e3 | 15982 | |
10862624 | 15983 | $cacheitem-E<gt>path() |
694468e3 | 15984 | |
10862624 | 15985 | $cacheitem-E<gt>file() |
694468e3 | 15986 | |
10862624 | 15987 | $cacheitem-E<gt>nodes() |
694468e3 | 15988 | |
10862624 | 15989 | $cacheitem-E<gt>find_node($name) |
694468e3 | 15990 | |
10862624 | 15991 | $cacheitem-E<gt>idx() |
694468e3 | 15992 | |
d420ca49 | 15993 | =over 4 |
694468e3 GS |
15994 | |
15995 | =item AUTHOR | |
15996 | ||
15997 | =item SEE ALSO | |
15998 | ||
15999 | =back | |
16000 | ||
14218588 GS |
16001 | =head2 Pod::Parser - base class for creating POD filters and translators |
16002 | ||
d420ca49 | 16003 | =over 4 |
a45bd81d | 16004 | |
14218588 GS |
16005 | =item SYNOPSIS |
16006 | ||
16007 | =item REQUIRES | |
16008 | ||
16009 | =item EXPORTS | |
16010 | ||
16011 | =item DESCRIPTION | |
16012 | ||
16013 | =item QUICK OVERVIEW | |
16014 | ||
c76ac1ee GS |
16015 | =item PARSING OPTIONS |
16016 | ||
b38f6a39 GS |
16017 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), |
16018 | B<-warnings> (default: unset) | |
c76ac1ee | 16019 | |
a45bd81d GS |
16020 | =back |
16021 | ||
d420ca49 | 16022 | =over 4 |
a45bd81d | 16023 | |
14218588 GS |
16024 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES |
16025 | ||
a45bd81d GS |
16026 | =back |
16027 | ||
d420ca49 | 16028 | =over 4 |
a45bd81d | 16029 | |
14218588 GS |
16030 | =item B<command()> |
16031 | ||
16032 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
16033 | ||
a45bd81d GS |
16034 | =back |
16035 | ||
d420ca49 | 16036 | =over 4 |
a45bd81d | 16037 | |
14218588 GS |
16038 | =item B<verbatim()> |
16039 | ||
16040 | C<$text>, C<$line_num>, C<$pod_para> | |
16041 | ||
a45bd81d GS |
16042 | =back |
16043 | ||
d420ca49 | 16044 | =over 4 |
a45bd81d | 16045 | |
14218588 GS |
16046 | =item B<textblock()> |
16047 | ||
16048 | C<$text>, C<$line_num>, C<$pod_para> | |
16049 | ||
a45bd81d GS |
16050 | =back |
16051 | ||
d420ca49 | 16052 | =over 4 |
a45bd81d | 16053 | |
14218588 GS |
16054 | =item B<interior_sequence()> |
16055 | ||
a45bd81d GS |
16056 | =back |
16057 | ||
d420ca49 | 16058 | =over 4 |
a45bd81d | 16059 | |
14218588 GS |
16060 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES |
16061 | ||
a45bd81d GS |
16062 | =back |
16063 | ||
d420ca49 | 16064 | =over 4 |
a45bd81d | 16065 | |
14218588 GS |
16066 | =item B<new()> |
16067 | ||
a45bd81d GS |
16068 | =back |
16069 | ||
d420ca49 | 16070 | =over 4 |
a45bd81d | 16071 | |
14218588 GS |
16072 | =item B<initialize()> |
16073 | ||
a45bd81d GS |
16074 | =back |
16075 | ||
d420ca49 | 16076 | =over 4 |
a45bd81d | 16077 | |
14218588 GS |
16078 | =item B<begin_pod()> |
16079 | ||
a45bd81d GS |
16080 | =back |
16081 | ||
d420ca49 | 16082 | =over 4 |
a45bd81d | 16083 | |
14218588 GS |
16084 | =item B<begin_input()> |
16085 | ||
a45bd81d GS |
16086 | =back |
16087 | ||
d420ca49 | 16088 | =over 4 |
a45bd81d | 16089 | |
14218588 GS |
16090 | =item B<end_input()> |
16091 | ||
a45bd81d GS |
16092 | =back |
16093 | ||
d420ca49 | 16094 | =over 4 |
a45bd81d | 16095 | |
14218588 GS |
16096 | =item B<end_pod()> |
16097 | ||
a45bd81d GS |
16098 | =back |
16099 | ||
d420ca49 | 16100 | =over 4 |
a45bd81d | 16101 | |
14218588 GS |
16102 | =item B<preprocess_line()> |
16103 | ||
a45bd81d GS |
16104 | =back |
16105 | ||
d420ca49 | 16106 | =over 4 |
a45bd81d | 16107 | |
14218588 GS |
16108 | =item B<preprocess_paragraph()> |
16109 | ||
a45bd81d GS |
16110 | =back |
16111 | ||
d420ca49 | 16112 | =over 4 |
a45bd81d | 16113 | |
14218588 GS |
16114 | =item METHODS FOR PARSING AND PROCESSING |
16115 | ||
a45bd81d GS |
16116 | =back |
16117 | ||
d420ca49 | 16118 | =over 4 |
a45bd81d | 16119 | |
14218588 GS |
16120 | =item B<parse_text()> |
16121 | ||
c76ac1ee GS |
16122 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> |
16123 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
14218588 GS |
16124 | I<code-ref>|I<method-name> |
16125 | ||
a45bd81d GS |
16126 | =back |
16127 | ||
d420ca49 | 16128 | =over 4 |
a45bd81d | 16129 | |
14218588 GS |
16130 | =item B<interpolate()> |
16131 | ||
a45bd81d GS |
16132 | =back |
16133 | ||
d420ca49 | 16134 | =over 4 |
a45bd81d | 16135 | |
14218588 GS |
16136 | =item B<parse_paragraph()> |
16137 | ||
a45bd81d GS |
16138 | =back |
16139 | ||
d420ca49 | 16140 | =over 4 |
a45bd81d | 16141 | |
14218588 GS |
16142 | =item B<parse_from_filehandle()> |
16143 | ||
a45bd81d GS |
16144 | =back |
16145 | ||
d420ca49 | 16146 | =over 4 |
a45bd81d | 16147 | |
14218588 GS |
16148 | =item B<parse_from_file()> |
16149 | ||
a45bd81d GS |
16150 | =back |
16151 | ||
d420ca49 | 16152 | =over 4 |
a45bd81d | 16153 | |
14218588 GS |
16154 | =item ACCESSOR METHODS |
16155 | ||
a45bd81d GS |
16156 | =back |
16157 | ||
d420ca49 | 16158 | =over 4 |
a45bd81d | 16159 | |
c76ac1ee GS |
16160 | =item B<errorsub()> |
16161 | ||
a45bd81d GS |
16162 | =back |
16163 | ||
d420ca49 | 16164 | =over 4 |
a45bd81d | 16165 | |
14218588 GS |
16166 | =item B<cutting()> |
16167 | ||
a45bd81d GS |
16168 | =back |
16169 | ||
d420ca49 | 16170 | =over 4 |
a45bd81d | 16171 | |
c76ac1ee GS |
16172 | =item B<parseopts()> |
16173 | ||
a45bd81d GS |
16174 | =back |
16175 | ||
d420ca49 | 16176 | =over 4 |
a45bd81d | 16177 | |
14218588 GS |
16178 | =item B<output_file()> |
16179 | ||
a45bd81d GS |
16180 | =back |
16181 | ||
d420ca49 | 16182 | =over 4 |
a45bd81d | 16183 | |
14218588 GS |
16184 | =item B<output_handle()> |
16185 | ||
a45bd81d GS |
16186 | =back |
16187 | ||
d420ca49 | 16188 | =over 4 |
a45bd81d | 16189 | |
14218588 GS |
16190 | =item B<input_file()> |
16191 | ||
a45bd81d GS |
16192 | =back |
16193 | ||
d420ca49 | 16194 | =over 4 |
a45bd81d | 16195 | |
14218588 GS |
16196 | =item B<input_handle()> |
16197 | ||
a45bd81d GS |
16198 | =back |
16199 | ||
d420ca49 | 16200 | =over 4 |
a45bd81d | 16201 | |
14218588 GS |
16202 | =item B<input_streams()> |
16203 | ||
a45bd81d GS |
16204 | =back |
16205 | ||
d420ca49 | 16206 | =over 4 |
a45bd81d GS |
16207 | |
16208 | =item B<top_stream()> | |
16209 | ||
16210 | =back | |
16211 | ||
d420ca49 | 16212 | =over 4 |
14218588 GS |
16213 | |
16214 | =item PRIVATE METHODS AND DATA | |
16215 | ||
a45bd81d GS |
16216 | =back |
16217 | ||
d420ca49 | 16218 | =over 4 |
a45bd81d | 16219 | |
14218588 GS |
16220 | =item B<_push_input_stream()> |
16221 | ||
a45bd81d GS |
16222 | =back |
16223 | ||
d420ca49 | 16224 | =over 4 |
a45bd81d | 16225 | |
14218588 GS |
16226 | =item B<_pop_input_stream()> |
16227 | ||
a45bd81d GS |
16228 | =back |
16229 | ||
d420ca49 | 16230 | =over 4 |
a45bd81d | 16231 | |
c76ac1ee | 16232 | =item TREE-BASED PARSING |
14218588 GS |
16233 | |
16234 | =item SEE ALSO | |
16235 | ||
16236 | =item AUTHOR | |
16237 | ||
a45bd81d GS |
16238 | =back |
16239 | ||
b38f6a39 GS |
16240 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. |
16241 | ||
d420ca49 | 16242 | =over 4 |
b38f6a39 GS |
16243 | |
16244 | =item SYNOPSIS | |
16245 | ||
16246 | =item DESCRIPTION | |
16247 | ||
d420ca49 | 16248 | =over 4 |
b38f6a39 GS |
16249 | |
16250 | =item EXPORT | |
16251 | ||
16252 | =back | |
16253 | ||
16254 | =item AUTHOR | |
16255 | ||
16256 | =item SEE ALSO | |
16257 | ||
16258 | =back | |
16259 | ||
14218588 GS |
16260 | =head2 Pod::Select, podselect() - extract selected sections of POD from |
16261 | input | |
16262 | ||
d420ca49 | 16263 | =over 4 |
a45bd81d | 16264 | |
14218588 GS |
16265 | =item SYNOPSIS |
16266 | ||
16267 | =item REQUIRES | |
16268 | ||
16269 | =item EXPORTS | |
16270 | ||
16271 | =item DESCRIPTION | |
16272 | ||
16273 | =item SECTION SPECIFICATIONS | |
16274 | ||
16275 | =item RANGE SPECIFICATIONS | |
16276 | ||
a45bd81d GS |
16277 | =back |
16278 | ||
d420ca49 | 16279 | =over 4 |
a45bd81d | 16280 | |
14218588 GS |
16281 | =item OBJECT METHODS |
16282 | ||
a45bd81d GS |
16283 | =back |
16284 | ||
d420ca49 | 16285 | =over 4 |
a45bd81d | 16286 | |
14218588 GS |
16287 | =item B<curr_headings()> |
16288 | ||
a45bd81d GS |
16289 | =back |
16290 | ||
d420ca49 | 16291 | =over 4 |
a45bd81d | 16292 | |
14218588 GS |
16293 | =item B<select()> |
16294 | ||
a45bd81d GS |
16295 | =back |
16296 | ||
d420ca49 | 16297 | =over 4 |
a45bd81d | 16298 | |
14218588 GS |
16299 | =item B<add_selection()> |
16300 | ||
a45bd81d GS |
16301 | =back |
16302 | ||
d420ca49 | 16303 | =over 4 |
a45bd81d | 16304 | |
14218588 GS |
16305 | =item B<clear_selections()> |
16306 | ||
a45bd81d GS |
16307 | =back |
16308 | ||
d420ca49 | 16309 | =over 4 |
a45bd81d | 16310 | |
14218588 GS |
16311 | =item B<match_section()> |
16312 | ||
a45bd81d GS |
16313 | =back |
16314 | ||
d420ca49 | 16315 | =over 4 |
a45bd81d | 16316 | |
14218588 GS |
16317 | =item B<is_selected()> |
16318 | ||
a45bd81d GS |
16319 | =back |
16320 | ||
d420ca49 | 16321 | =over 4 |
a45bd81d | 16322 | |
14218588 GS |
16323 | =item EXPORTED FUNCTIONS |
16324 | ||
a45bd81d GS |
16325 | =back |
16326 | ||
d420ca49 | 16327 | =over 4 |
a45bd81d | 16328 | |
14218588 GS |
16329 | =item B<podselect()> |
16330 | ||
16331 | B<-output>, B<-sections>, B<-ranges> | |
16332 | ||
a45bd81d GS |
16333 | =back |
16334 | ||
d420ca49 | 16335 | =over 4 |
a45bd81d | 16336 | |
14218588 GS |
16337 | =item PRIVATE METHODS AND DATA |
16338 | ||
a45bd81d GS |
16339 | =back |
16340 | ||
d420ca49 | 16341 | =over 4 |
a45bd81d | 16342 | |
14218588 GS |
16343 | =item B<_compile_section_spec()> |
16344 | ||
a45bd81d GS |
16345 | =back |
16346 | ||
d420ca49 | 16347 | =over 4 |
14218588 GS |
16348 | |
16349 | =item $self->{_SECTION_HEADINGS} | |
16350 | ||
a45bd81d GS |
16351 | =back |
16352 | ||
d420ca49 | 16353 | =over 4 |
a45bd81d | 16354 | |
14218588 GS |
16355 | =item $self->{_SELECTED_SECTIONS} |
16356 | ||
16357 | =back | |
16358 | ||
d420ca49 | 16359 | =over 4 |
a45bd81d | 16360 | |
14218588 GS |
16361 | =item SEE ALSO |
16362 | ||
16363 | =item AUTHOR | |
16364 | ||
a45bd81d GS |
16365 | =back |
16366 | ||
c76ac1ee | 16367 | =head2 Pod::Text - Convert POD data to formatted ASCII text |
402d0d99 | 16368 | |
d420ca49 | 16369 | =over 4 |
a45bd81d | 16370 | |
402d0d99 | 16371 | =item SYNOPSIS |
16372 | ||
402d0d99 | 16373 | =item DESCRIPTION |
16374 | ||
1fdc5aa6 | 16375 | alt, code, indent, loose, quotes, sentence, width |
c76ac1ee GS |
16376 | |
16377 | =item DIAGNOSTICS | |
16378 | ||
1fdc5aa6 | 16379 | Bizarre space in item, Item called without tag, Can't open %s for reading: |
04b01f78 JH |
16380 | %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, |
16381 | %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: | |
1fdc5aa6 | 16382 | Unmatched =back |
c76ac1ee GS |
16383 | |
16384 | =item RESTRICTIONS | |
16385 | ||
16386 | =item NOTES | |
16387 | ||
16388 | =item SEE ALSO | |
16389 | ||
402d0d99 | 16390 | =item AUTHOR |
16391 | ||
d0363f02 JH |
16392 | =item COPYRIGHT AND LICENSE |
16393 | ||
a45bd81d GS |
16394 | =back |
16395 | ||
c76ac1ee GS |
16396 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text |
16397 | ||
d420ca49 | 16398 | =over 4 |
a45bd81d | 16399 | |
c76ac1ee GS |
16400 | =item SYNOPSIS |
16401 | ||
16402 | =item DESCRIPTION | |
16403 | ||
16404 | =item BUGS | |
16405 | ||
16406 | =item SEE ALSO | |
16407 | ||
16408 | =item AUTHOR | |
16409 | ||
d0363f02 JH |
16410 | =item COPYRIGHT AND LICENSE |
16411 | ||
a45bd81d GS |
16412 | =back |
16413 | ||
ab648d5e JH |
16414 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike |
16415 | text | |
16416 | ||
16417 | =over 4 | |
16418 | ||
16419 | =item SYNOPSIS | |
16420 | ||
16421 | =item DESCRIPTION | |
16422 | ||
16423 | =item BUGS | |
16424 | ||
16425 | =item SEE ALSO | |
16426 | ||
16427 | =item AUTHOR | |
16428 | ||
d0363f02 JH |
16429 | =item COPYRIGHT AND LICENSE |
16430 | ||
ab648d5e JH |
16431 | =back |
16432 | ||
c76ac1ee GS |
16433 | =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII |
16434 | text with format escapes | |
16435 | ||
d420ca49 | 16436 | =over 4 |
a45bd81d | 16437 | |
c76ac1ee GS |
16438 | =item SYNOPSIS |
16439 | ||
16440 | =item DESCRIPTION | |
16441 | ||
34babc16 JH |
16442 | =item NOTES |
16443 | ||
c76ac1ee GS |
16444 | =item SEE ALSO |
16445 | ||
16446 | =item AUTHOR | |
402d0d99 | 16447 | |
d0363f02 JH |
16448 | =item COPYRIGHT AND LICENSE |
16449 | ||
a45bd81d GS |
16450 | =back |
16451 | ||
14218588 GS |
16452 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
16453 | documentation | |
16454 | ||
d420ca49 | 16455 | =over 4 |
a45bd81d | 16456 | |
14218588 GS |
16457 | =item SYNOPSIS |
16458 | ||
16459 | =item ARGUMENTS | |
16460 | ||
16461 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
16462 | C<-pathlist> | |
16463 | ||
16464 | =item DESCRIPTION | |
16465 | ||
16466 | =item EXAMPLES | |
16467 | ||
d420ca49 | 16468 | =over 4 |
14218588 GS |
16469 | |
16470 | =item Recommended Use | |
16471 | ||
16472 | =back | |
16473 | ||
16474 | =item CAVEATS | |
16475 | ||
16476 | =item AUTHOR | |
16477 | ||
16478 | =item ACKNOWLEDGEMENTS | |
16479 | ||
a45bd81d GS |
16480 | =back |
16481 | ||
428dc699 JH |
16482 | =head2 Pod::t::basic, basic.pod - Test of various basic POD features in |
16483 | translators. | |
16484 | ||
16485 | =over 4 | |
16486 | ||
16487 | =item HEADINGS | |
16488 | ||
16489 | =item This C<is> a "level 1" heading | |
16490 | ||
16491 | =over 4 | |
16492 | ||
16493 | =item ``Level'' "2 I<heading> | |
16494 | ||
16495 | =back | |
16496 | ||
16497 | =item This C<is> a "level 1" heading | |
16498 | ||
16499 | =over 4 | |
16500 | ||
16501 | =item ``Level'' 2 I<heading> | |
16502 | ||
16503 | =back | |
16504 | ||
16505 | =item LINKS | |
16506 | ||
16507 | =item OVER AND ITEMS | |
16508 | ||
16509 | This is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item | |
16510 | text | |
16511 | ||
16512 | =item FORMATTING CODES | |
16513 | ||
16514 | E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol> | |
16515 | ||
16516 | =item VERBATIM | |
16517 | ||
04b01f78 JH |
16518 | =item CONCLUSION |
16519 | ||
428dc699 JH |
16520 | =back |
16521 | ||
fa1c7b03 | 16522 | =head2 Pod::t::htmlescp, Escape Sequences Test |
402d0d99 | 16523 | |
d420ca49 | 16524 | =over 4 |
a45bd81d | 16525 | |
8ebc5c01 | 16526 | =item DESCRIPTION |
402d0d99 | 16527 | |
a45bd81d GS |
16528 | =back |
16529 | ||
fa1c7b03 | 16530 | =head2 Pod::t::htmlview, Test HTML Rendering |
d46b76b3 | 16531 | |
d420ca49 | 16532 | =over 4 |
d46b76b3 JH |
16533 | |
16534 | =item SYNOPSIS | |
16535 | ||
16536 | =item DESCRIPTION | |
16537 | ||
fa1c7b03 | 16538 | =item METHODS =E<gt> OTHER STUFF |
d46b76b3 | 16539 | |
d420ca49 | 16540 | =over 4 |
d46b76b3 | 16541 | |
fa1c7b03 | 16542 | =item new() |
d46b76b3 | 16543 | |
fa1c7b03 JH |
16544 | foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2 |
16545 | Sat, 3 Mat | |
d46b76b3 | 16546 | |
fa1c7b03 | 16547 | =item old() |
d46b76b3 | 16548 | |
fa1c7b03 | 16549 | =back |
d46b76b3 | 16550 | |
fa1c7b03 | 16551 | =item TESTING FOR AND BEGIN |
d46b76b3 | 16552 | |
fa1c7b03 | 16553 | =item TESTING URLs hyperlinking |
d46b76b3 | 16554 | |
fa1c7b03 | 16555 | =item SEE ALSO |
d46b76b3 JH |
16556 | |
16557 | =back | |
16558 | ||
fa1c7b03 | 16559 | =head2 SDBM_File - Tied access to sdbm files |
41ca3a40 JH |
16560 | |
16561 | =over 4 | |
16562 | ||
16563 | =item SYNOPSIS | |
16564 | ||
16565 | =item DESCRIPTION | |
16566 | ||
fa1c7b03 | 16567 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
41ca3a40 | 16568 | |
fa1c7b03 | 16569 | =item DIAGNOSTICS |
f502af34 | 16570 | |
fa1c7b03 | 16571 | =over 4 |
41ca3a40 | 16572 | |
fa1c7b03 JH |
16573 | =item C<sdbm store returned -1, errno 22, key "..." at ...> |
16574 | ||
16575 | =back | |
16576 | ||
16577 | =item BUGS AND WARNINGS | |
41ca3a40 JH |
16578 | |
16579 | =back | |
16580 | ||
7d2bfb28 | 16581 | =head2 Search::Dict, look - search for key in dictionary file |
16582 | ||
d420ca49 | 16583 | =over 4 |
a45bd81d | 16584 | |
7d2bfb28 | 16585 | =item SYNOPSIS |
16586 | ||
7d2bfb28 | 16587 | =item DESCRIPTION |
16588 | ||
a45bd81d GS |
16589 | =back |
16590 | ||
7d2bfb28 | 16591 | =head2 SelectSaver - save and restore selected file handle |
16592 | ||
d420ca49 | 16593 | =over 4 |
a45bd81d | 16594 | |
7d2bfb28 | 16595 | =item SYNOPSIS |
16596 | ||
7d2bfb28 | 16597 | =item DESCRIPTION |
16598 | ||
a45bd81d GS |
16599 | =back |
16600 | ||
cb1a09d0 AD |
16601 | =head2 SelfLoader - load functions only on demand |
16602 | ||
d420ca49 | 16603 | =over 4 |
a45bd81d | 16604 | |
cb1a09d0 AD |
16605 | =item SYNOPSIS |
16606 | ||
cb1a09d0 AD |
16607 | =item DESCRIPTION |
16608 | ||
d420ca49 | 16609 | =over 4 |
cb1a09d0 AD |
16610 | |
16611 | =item The __DATA__ token | |
16612 | ||
cb1a09d0 AD |
16613 | =item SelfLoader autoloading |
16614 | ||
cb1a09d0 AD |
16615 | =item Autoloading and package lexicals |
16616 | ||
cb1a09d0 AD |
16617 | =item SelfLoader and AutoLoader |
16618 | ||
cb1a09d0 AD |
16619 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
16620 | ||
cb1a09d0 AD |
16621 | =item Classes and inherited methods. |
16622 | ||
cb1a09d0 AD |
16623 | =back |
16624 | ||
16625 | =item Multiple packages and fully qualified subroutine names | |
16626 | ||
a45bd81d GS |
16627 | =back |
16628 | ||
8ebc5c01 | 16629 | =head2 Shell - run shell commands transparently within perl |
cb1a09d0 | 16630 | |
d420ca49 | 16631 | =over 4 |
a45bd81d | 16632 | |
cb1a09d0 AD |
16633 | =item SYNOPSIS |
16634 | ||
cb1a09d0 AD |
16635 | =item DESCRIPTION |
16636 | ||
d420ca49 | 16637 | =over 4 |
d396a558 JH |
16638 | |
16639 | =item OBJECT ORIENTED SYNTAX | |
16640 | ||
16641 | =back | |
16642 | ||
8ebc5c01 | 16643 | =item AUTHOR |
cb1a09d0 | 16644 | |
a45bd81d GS |
16645 | =back |
16646 | ||
8ebc5c01 | 16647 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
16648 | socket.h defines and structure manipulators | |
cb1a09d0 | 16649 | |
d420ca49 | 16650 | =over 4 |
a45bd81d | 16651 | |
8ebc5c01 | 16652 | =item SYNOPSIS |
cb1a09d0 | 16653 | |
8ebc5c01 | 16654 | =item DESCRIPTION |
cb1a09d0 | 16655 | |
8ebc5c01 | 16656 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
f502af34 JH |
16657 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, |
16658 | ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, | |
16659 | unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un | |
16660 | SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
cb1a09d0 | 16661 | |
a45bd81d GS |
16662 | =back |
16663 | ||
a9ef4385 JH |
16664 | =head2 Storable - persistency for perl data structures |
16665 | ||
d420ca49 | 16666 | =over 4 |
a9ef4385 JH |
16667 | |
16668 | =item SYNOPSIS | |
16669 | ||
16670 | =item DESCRIPTION | |
16671 | ||
16672 | =item MEMORY STORE | |
16673 | ||
91331b4f JH |
16674 | =item ADVISORY LOCKING |
16675 | ||
a9ef4385 JH |
16676 | =item SPEED |
16677 | ||
16678 | =item CANONICAL REPRESENTATION | |
16679 | ||
16680 | =item ERROR REPORTING | |
16681 | ||
16682 | =item WIZARDS ONLY | |
16683 | ||
d420ca49 | 16684 | =over 4 |
a9ef4385 JH |
16685 | |
16686 | =item Hooks | |
16687 | ||
16688 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
16689 | I<serialized>, .. | |
16690 | ||
16691 | =item Predicates | |
16692 | ||
16693 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
16694 | C<Storable::is_retrieving> | |
16695 | ||
16696 | =item Recursion | |
16697 | ||
16698 | =item Deep Cloning | |
16699 | ||
16700 | =back | |
16701 | ||
f502af34 JH |
16702 | =item Storable magic |
16703 | ||
a9ef4385 JH |
16704 | =item EXAMPLES |
16705 | ||
16706 | =item WARNING | |
16707 | ||
16708 | =item BUGS | |
16709 | ||
16710 | =item CREDITS | |
16711 | ||
16712 | =item TRANSLATIONS | |
16713 | ||
16714 | =item AUTHOR | |
16715 | ||
16716 | =item SEE ALSO | |
16717 | ||
16718 | =back | |
16719 | ||
4d4e713d JH |
16720 | =head2 Switch - A switch statement for Perl |
16721 | ||
16722 | =over 4 | |
16723 | ||
16724 | =item VERSION | |
16725 | ||
16726 | =item SYNOPSIS | |
16727 | ||
16728 | =item BACKGROUND | |
16729 | ||
16730 | =item DESCRIPTION | |
16731 | ||
16732 | =over 4 | |
16733 | ||
16734 | =item Allowing fall-through | |
16735 | ||
16736 | =item Automating fall-through | |
16737 | ||
9cd42e2a JH |
16738 | =item Alternative syntax |
16739 | ||
4d4e713d JH |
16740 | =item Higher-order Operations |
16741 | ||
16742 | =back | |
16743 | ||
16744 | =item DEPENDENCIES | |
16745 | ||
16746 | =item AUTHOR | |
16747 | ||
16748 | =item BUGS | |
16749 | ||
ba62762e JH |
16750 | =item LIMITATION |
16751 | ||
4d4e713d JH |
16752 | =item COPYRIGHT |
16753 | ||
16754 | =back | |
16755 | ||
7d2bfb28 | 16756 | =head2 Symbol - manipulate Perl symbols and their names |
16757 | ||
d420ca49 | 16758 | =over 4 |
a45bd81d | 16759 | |
7d2bfb28 | 16760 | =item SYNOPSIS |
16761 | ||
7d2bfb28 | 16762 | =item DESCRIPTION |
16763 | ||
a45bd81d GS |
16764 | =back |
16765 | ||
cb1a09d0 AD |
16766 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
16767 | ||
d420ca49 | 16768 | =over 4 |
a45bd81d | 16769 | |
cb1a09d0 AD |
16770 | =item SYNOPSIS |
16771 | ||
cb1a09d0 AD |
16772 | =item DESCRIPTION |
16773 | ||
cb1a09d0 AD |
16774 | =item AUTHOR |
16775 | ||
a45bd81d GS |
16776 | =back |
16777 | ||
694468e3 GS |
16778 | =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - |
16779 | Perl interface to the UNIX syslog(3) calls | |
16780 | ||
d420ca49 | 16781 | =over 4 |
694468e3 GS |
16782 | |
16783 | =item SYNOPSIS | |
16784 | ||
16785 | =item DESCRIPTION | |
16786 | ||
16787 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
fa1c7b03 JH |
16788 | setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added |
16789 | in 5.004_02), closelog | |
694468e3 GS |
16790 | |
16791 | =item EXAMPLES | |
7d2bfb28 | 16792 | |
7d2bfb28 | 16793 | =item SEE ALSO |
16794 | ||
7d2bfb28 | 16795 | =item AUTHOR |
16796 | ||
a45bd81d GS |
16797 | =back |
16798 | ||
b38f6a39 GS |
16799 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences |
16800 | ||
d420ca49 | 16801 | =over 4 |
b38f6a39 GS |
16802 | |
16803 | =item SYNOPSIS | |
16804 | ||
16805 | =item DESCRIPTION | |
16806 | ||
16807 | =item DIAGNOSTICS | |
16808 | ||
d0363f02 JH |
16809 | Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in |
16810 | use, Invalid attribute name %s, Name "%s" used only once: possible typo, No | |
16811 | comma allowed after filehandle, No name for escape sequence %s | |
16812 | ||
16813 | =item ENVIRONMENT | |
16814 | ||
16815 | ANSI_COLORS_DISABLED | |
b38f6a39 GS |
16816 | |
16817 | =item RESTRICTIONS | |
16818 | ||
10862624 RF |
16819 | =item NOTES |
16820 | ||
d0363f02 JH |
16821 | =item SEE ALSO |
16822 | ||
b38f6a39 GS |
16823 | =item AUTHORS |
16824 | ||
d0363f02 JH |
16825 | =item LICENSE |
16826 | ||
b38f6a39 GS |
16827 | =back |
16828 | ||
cb1a09d0 AD |
16829 | =head2 Term::Cap - Perl termcap interface |
16830 | ||
d420ca49 | 16831 | =over 4 |
a45bd81d | 16832 | |
cb1a09d0 AD |
16833 | =item SYNOPSIS |
16834 | ||
cb1a09d0 AD |
16835 | =item DESCRIPTION |
16836 | ||
428dc699 JH |
16837 | =over 4 |
16838 | ||
16839 | =item METHODS | |
16840 | ||
16841 | =back | |
16842 | ||
16843 | =back | |
16844 | ||
16845 | B<Tgetent>, OSPEED, TERM | |
16846 | ||
16847 | B<Tpad>, B<$string>, B<$cnt>, B<$FH> | |
16848 | ||
16849 | B<Tputs>, B<$cap>, B<$cnt>, B<$FH> | |
16850 | ||
16851 | B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> | |
16852 | ||
16853 | B<Trequire> | |
16854 | ||
16855 | =over 4 | |
16856 | ||
cb1a09d0 AD |
16857 | =item EXAMPLES |
16858 | ||
428dc699 JH |
16859 | =item COPYRIGHT AND LICENSE |
16860 | ||
16861 | =item AUTHOR | |
16862 | ||
16863 | =item SEE ALSO | |
16864 | ||
a45bd81d GS |
16865 | =back |
16866 | ||
cb1a09d0 AD |
16867 | =head2 Term::Complete - Perl word completion module |
16868 | ||
d420ca49 | 16869 | =over 4 |
a45bd81d | 16870 | |
cb1a09d0 AD |
16871 | =item SYNOPSIS |
16872 | ||
cb1a09d0 AD |
16873 | =item DESCRIPTION |
16874 | ||
3fe9a6f1 | 16875 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
cb1a09d0 AD |
16876 | |
16877 | =item DIAGNOSTICS | |
16878 | ||
cb1a09d0 AD |
16879 | =item BUGS |
16880 | ||
cb1a09d0 AD |
16881 | =item AUTHOR |
16882 | ||
a45bd81d GS |
16883 | =back |
16884 | ||
8ebc5c01 | 16885 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. If |
16886 | no real package is found, substitutes stubs instead of basic functions. | |
7d2bfb28 | 16887 | |
d420ca49 | 16888 | =over 4 |
a45bd81d | 16889 | |
7d2bfb28 | 16890 | =item SYNOPSIS |
16891 | ||
7d2bfb28 | 16892 | =item DESCRIPTION |
16893 | ||
7d2bfb28 | 16894 | =item Minimal set of supported functions |
16895 | ||
7d2bfb28 | 16896 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>, |
9607fc9c | 16897 | C<MinLine>, C<findConsole>, Attribs, C<Features> |
16898 | ||
16899 | =item Additional supported functions | |
7d2bfb28 | 16900 | |
d516a115 JH |
16901 | C<tkRunning>, C<ornaments>, C<newTTY> |
16902 | ||
7d2bfb28 | 16903 | =item EXPORTS |
16904 | ||
9607fc9c | 16905 | =item ENVIRONMENT |
16906 | ||
ab1e085c JH |
16907 | =item CAVEATS |
16908 | ||
a45bd81d GS |
16909 | =back |
16910 | ||
4d4e713d | 16911 | =head2 Test - provides a simple framework for writing test scripts |
193fb0af | 16912 | |
d420ca49 | 16913 | =over 4 |
a45bd81d | 16914 | |
193fb0af GS |
16915 | =item SYNOPSIS |
16916 | ||
16917 | =item DESCRIPTION | |
16918 | ||
640374d0 JH |
16919 | =over 4 |
16920 | ||
16921 | =item Functions | |
16922 | ||
16923 | B<plan> | |
16924 | ||
16925 | =back | |
16926 | ||
16927 | =back | |
16928 | ||
16929 | B<_to_value> | |
16930 | ||
16931 | B<ok> | |
16932 | ||
16933 | =over 4 | |
16934 | ||
193fb0af GS |
16935 | =item TEST TYPES |
16936 | ||
16937 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
16938 | ||
16939 | =item ONFAIL | |
16940 | ||
640374d0 JH |
16941 | =item BUGS and CAVEATS |
16942 | ||
80327a3d | 16943 | =item NOTE |
640374d0 | 16944 | |
193fb0af GS |
16945 | =item SEE ALSO |
16946 | ||
16947 | =item AUTHOR | |
16948 | ||
a45bd81d GS |
16949 | =back |
16950 | ||
10151d09 JH |
16951 | =head2 Test::Builder - Backend for building test libraries |
16952 | ||
16953 | =over 4 | |
16954 | ||
16955 | =item SYNOPSIS | |
16956 | ||
16957 | =item DESCRIPTION | |
16958 | ||
16959 | =over 4 | |
16960 | ||
16961 | =item Construction | |
16962 | ||
16963 | B<new> | |
16964 | ||
16965 | =back | |
16966 | ||
16967 | =back | |
16968 | ||
16969 | =over 4 | |
16970 | ||
16971 | =item Setting up tests | |
16972 | ||
16973 | B<exported_to> | |
16974 | ||
16975 | =back | |
16976 | ||
16977 | B<plan> | |
16978 | ||
16979 | B<expected_tests> | |
16980 | ||
16981 | B<no_plan> | |
16982 | ||
16983 | B<skip_all> | |
16984 | ||
16985 | =over 4 | |
16986 | ||
16987 | =item Running tests | |
16988 | ||
16989 | B<ok> | |
16990 | ||
16991 | =back | |
16992 | ||
16993 | B<is_eq>, B<is_num> | |
16994 | ||
f502af34 JH |
16995 | B<isnt_eq>, B<isnt_num> |
16996 | ||
16997 | B<like>, B<unlike> | |
16998 | ||
16999 | B<cmp_ok> | |
17000 | ||
17001 | B<BAILOUT> | |
10151d09 JH |
17002 | |
17003 | B<skip> | |
17004 | ||
f502af34 JH |
17005 | B<todo_skip> |
17006 | ||
10151d09 JH |
17007 | B<skip_rest> |
17008 | ||
17009 | =over 4 | |
17010 | ||
17011 | =item Test style | |
17012 | ||
17013 | B<level> | |
17014 | ||
17015 | =back | |
17016 | ||
17017 | B<use_numbers> | |
17018 | ||
17019 | B<no_header>, B<no_ending> | |
17020 | ||
17021 | =over 4 | |
17022 | ||
17023 | =item Output | |
17024 | ||
17025 | B<diag> | |
17026 | ||
17027 | =back | |
17028 | ||
17029 | B<_print> | |
17030 | ||
17031 | B<output>, B<failure_output>, B<todo_output> | |
17032 | ||
17033 | =over 4 | |
17034 | ||
17035 | =item Test Status and Info | |
17036 | ||
17037 | B<current_test> | |
17038 | ||
17039 | =back | |
17040 | ||
17041 | B<summary> | |
17042 | ||
17043 | B<details> I<UNIMPLEMENTED>, B<todo> | |
17044 | ||
17045 | B<caller> | |
17046 | ||
17047 | B<_sanity_check> | |
17048 | ||
17049 | B<_whoa> | |
17050 | ||
17051 | B<_my_exit> | |
17052 | ||
17053 | =over 4 | |
17054 | ||
17055 | =item EXAMPLES | |
17056 | ||
10151d09 JH |
17057 | =item SEE ALSO |
17058 | ||
428dc699 JH |
17059 | =item AUTHORS |
17060 | ||
17061 | =item COPYRIGHT | |
17062 | ||
10151d09 JH |
17063 | =back |
17064 | ||
cb1a09d0 AD |
17065 | =head2 Test::Harness - run perl standard test scripts with statistics |
17066 | ||
d420ca49 | 17067 | =over 4 |
a45bd81d | 17068 | |
cb1a09d0 AD |
17069 | =item SYNOPSIS |
17070 | ||
cb1a09d0 AD |
17071 | =item DESCRIPTION |
17072 | ||
d420ca49 | 17073 | =over 4 |
7d2bfb28 | 17074 | |
17075 | =item The test script output | |
17076 | ||
f502af34 JH |
17077 | B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>, |
17078 | B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything | |
17079 | else> | |
17080 | ||
17081 | =item Taint mode | |
17082 | ||
17083 | =item Configuration variables. | |
17084 | ||
17085 | B<$Test::Harness::verbose>, B<$Test::Harness::switches> | |
640374d0 JH |
17086 | |
17087 | =item Failure | |
17088 | ||
17089 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of | |
17090 | Failed> | |
17091 | ||
17092 | =item Functions | |
17093 | ||
17094 | B<runtests> | |
17095 | ||
17096 | =back | |
dc5c060f | 17097 | |
7d2bfb28 | 17098 | =back |
17099 | ||
53d7eaa8 JH |
17100 | B<_all_ok> |
17101 | ||
640374d0 JH |
17102 | B<_globdir> |
17103 | ||
17104 | B<_run_all_tests> | |
17105 | ||
17106 | B<_mk_leader> | |
17107 | ||
f502af34 JH |
17108 | B<_leader_width> |
17109 | ||
640374d0 JH |
17110 | =over 4 |
17111 | ||
cb1a09d0 AD |
17112 | =item EXPORT |
17113 | ||
cb1a09d0 AD |
17114 | =item DIAGNOSTICS |
17115 | ||
7d2bfb28 | 17116 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
8ebc5c01 | 17117 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
17118 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
165c0277 | 17119 | %s>, C<FAILED--Further testing stopped%s> |
cb1a09d0 | 17120 | |
fb9cefb4 GS |
17121 | =item ENVIRONMENT |
17122 | ||
2d967e39 JH |
17123 | C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>, |
17124 | C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>, | |
17125 | C<HARNESS_ACTIVE> | |
17126 | ||
640374d0 JH |
17127 | =item EXAMPLE |
17128 | ||
cb1a09d0 AD |
17129 | =item SEE ALSO |
17130 | ||
7d2bfb28 | 17131 | =item AUTHORS |
17132 | ||
640374d0 JH |
17133 | =item TODO |
17134 | ||
cb1a09d0 AD |
17135 | =item BUGS |
17136 | ||
a45bd81d GS |
17137 | =back |
17138 | ||
f502af34 JH |
17139 | =head2 Test::Harness::Assert - simple assert |
17140 | ||
17141 | =over 4 | |
17142 | ||
17143 | =item SYNOPSIS | |
17144 | ||
17145 | =item DESCRIPTION | |
17146 | ||
17147 | =over 4 | |
17148 | ||
17149 | =item Functions | |
17150 | ||
17151 | B<assert> | |
17152 | ||
17153 | =back | |
17154 | ||
17155 | =back | |
17156 | ||
17157 | =over 4 | |
17158 | ||
17159 | =item AUTHOR | |
17160 | ||
17161 | =item SEE ALSO | |
17162 | ||
17163 | =back | |
17164 | ||
17165 | =head2 Test::Harness::Iterator - Internal Test::Harness Iterator | |
17166 | ||
17167 | =over 4 | |
17168 | ||
17169 | =item SYNOPSIS | |
17170 | ||
17171 | =item DESCRIPTION | |
17172 | ||
17173 | =back | |
17174 | ||
17175 | =head2 Test::Harness::Straps - detailed analysis of test results | |
17176 | ||
17177 | =over 4 | |
17178 | ||
17179 | =item SYNOPSIS | |
17180 | ||
17181 | =item DESCRIPTION | |
17182 | ||
17183 | =over 4 | |
17184 | ||
17185 | =item Construction | |
17186 | ||
17187 | B<new> | |
17188 | ||
17189 | =back | |
17190 | ||
17191 | =back | |
17192 | ||
17193 | B<_init> | |
17194 | ||
17195 | =over 4 | |
17196 | ||
17197 | =item Analysis | |
17198 | ||
17199 | B<analyze> | |
17200 | ||
17201 | =back | |
17202 | ||
17203 | B<analyze_fh> | |
17204 | ||
17205 | B<analyze_file> | |
17206 | ||
17207 | B<_switches> | |
17208 | ||
17209 | B<_INC2PERL5LIB> | |
17210 | ||
17211 | B<_filtered_INC> | |
17212 | ||
17213 | B<_restore_PERL5LIB> | |
17214 | ||
17215 | =over 4 | |
17216 | ||
17217 | =item Parsing | |
17218 | ||
17219 | B<_is_comment> | |
17220 | ||
17221 | =back | |
17222 | ||
17223 | B<_is_header> | |
17224 | ||
17225 | B<_is_test> | |
17226 | ||
17227 | B<_is_bail_out> | |
17228 | ||
17229 | B<_reset_file_state> | |
17230 | ||
17231 | =over 4 | |
17232 | ||
17233 | =item Results | |
17234 | ||
17235 | B<_detailize> | |
17236 | ||
17237 | =back | |
17238 | ||
17239 | =over 4 | |
17240 | ||
17241 | =item EXAMPLES | |
17242 | ||
17243 | =item AUTHOR | |
17244 | ||
17245 | =item SEE ALSO | |
17246 | ||
17247 | =back | |
17248 | ||
7a49b635 JH |
17249 | =head2 Test::More - yet another framework for writing test scripts |
17250 | ||
17251 | =over 4 | |
17252 | ||
17253 | =item SYNOPSIS | |
17254 | ||
17255 | =item DESCRIPTION | |
17256 | ||
17257 | =over 4 | |
17258 | ||
17259 | =item I love it when a plan comes together | |
17260 | ||
10151d09 JH |
17261 | =back |
17262 | ||
17263 | =back | |
17264 | ||
17265 | =over 4 | |
17266 | ||
7a49b635 JH |
17267 | =item Test names |
17268 | ||
17269 | =item I'm ok, you're not ok. | |
17270 | ||
17271 | B<ok> | |
17272 | ||
17273 | =back | |
17274 | ||
7a49b635 JH |
17275 | B<is>, B<isnt> |
17276 | ||
17277 | B<like> | |
17278 | ||
f502af34 JH |
17279 | B<unlike> |
17280 | ||
17281 | B<cmp_ok> | |
17282 | ||
53d7eaa8 JH |
17283 | B<can_ok> |
17284 | ||
17285 | B<isa_ok> | |
17286 | ||
7a49b635 JH |
17287 | B<pass>, B<fail> |
17288 | ||
17289 | =over 4 | |
17290 | ||
f502af34 JH |
17291 | =item Diagnostics |
17292 | ||
17293 | B<diag> | |
17294 | ||
17295 | =back | |
17296 | ||
17297 | =over 4 | |
17298 | ||
7a49b635 JH |
17299 | =item Module tests |
17300 | ||
53d7eaa8 | 17301 | B<use_ok> |
7a49b635 JH |
17302 | |
17303 | =back | |
17304 | ||
53d7eaa8 JH |
17305 | B<require_ok> |
17306 | ||
7a49b635 JH |
17307 | =over 4 |
17308 | ||
17309 | =item Conditional tests | |
17310 | ||
53d7eaa8 | 17311 | B<SKIP: BLOCK> |
7a49b635 JH |
17312 | |
17313 | =back | |
17314 | ||
f502af34 | 17315 | B<TODO: BLOCK>, B<todo_skip> |
7a49b635 JH |
17316 | |
17317 | =over 4 | |
17318 | ||
428dc699 | 17319 | =item Comparison functions |
7a49b635 | 17320 | |
10151d09 | 17321 | B<is_deeply> |
7a49b635 JH |
17322 | |
17323 | =back | |
17324 | ||
10151d09 JH |
17325 | B<eq_array> |
17326 | ||
7a49b635 JH |
17327 | B<eq_hash> |
17328 | ||
17329 | B<eq_set> | |
17330 | ||
17331 | =over 4 | |
17332 | ||
f502af34 JH |
17333 | =item Extending and Embedding Test::More |
17334 | ||
17335 | B<builder> | |
17336 | ||
17337 | =back | |
17338 | ||
17339 | =over 4 | |
17340 | ||
53d7eaa8 JH |
17341 | =item NOTES |
17342 | ||
7a49b635 JH |
17343 | =item BUGS and CAVEATS |
17344 | ||
f502af34 | 17345 | Making your own ok(), The eq_* family has some caveats, Test::Harness |
53d7eaa8 JH |
17346 | upgrades |
17347 | ||
7a49b635 JH |
17348 | =item HISTORY |
17349 | ||
17350 | =item SEE ALSO | |
17351 | ||
428dc699 JH |
17352 | =item AUTHORS |
17353 | ||
17354 | =item COPYRIGHT | |
17355 | ||
7a49b635 JH |
17356 | =back |
17357 | ||
17358 | =head2 Test::Simple - Basic utilities for writing tests. | |
17359 | ||
17360 | =over 4 | |
17361 | ||
17362 | =item SYNOPSIS | |
17363 | ||
17364 | =item DESCRIPTION | |
17365 | ||
17366 | B<ok> | |
17367 | ||
17368 | =back | |
17369 | ||
7a49b635 JH |
17370 | =over 4 |
17371 | ||
17372 | =item EXAMPLE | |
17373 | ||
17374 | =item CAVEATS | |
17375 | ||
53d7eaa8 JH |
17376 | =item NOTES |
17377 | ||
7a49b635 JH |
17378 | =item HISTORY |
17379 | ||
7a49b635 JH |
17380 | =item SEE ALSO |
17381 | ||
428dc699 | 17382 | L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, |
7a49b635 JH |
17383 | L<Test::Harness> |
17384 | ||
428dc699 JH |
17385 | =item AUTHORS |
17386 | ||
17387 | =item COPYRIGHT | |
17388 | ||
7a49b635 JH |
17389 | =back |
17390 | ||
e61ecf27 JH |
17391 | =head2 Test::Tutorial - A tutorial about writing really basic tests |
17392 | ||
17393 | =over 4 | |
17394 | ||
17395 | =item DESCRIPTION | |
17396 | ||
17397 | =over 4 | |
17398 | ||
17399 | =item Nuts and bolts of testing. | |
17400 | ||
17401 | =item Where to start? | |
17402 | ||
17403 | =item Names | |
17404 | ||
17405 | =item Test the manual | |
17406 | ||
17407 | =item Sometimes the tests are wrong | |
17408 | ||
17409 | =item Testing lots of values | |
17410 | ||
17411 | =item Informative names | |
17412 | ||
17413 | =item Skipping tests | |
17414 | ||
17415 | =item Todo tests | |
17416 | ||
17417 | =item Testing with taint mode. | |
17418 | ||
17419 | =back | |
17420 | ||
17421 | =item FOOTNOTES | |
17422 | ||
428dc699 JH |
17423 | =item AUTHORS |
17424 | ||
17425 | =item COPYRIGHT | |
17426 | ||
e61ecf27 JH |
17427 | =back |
17428 | ||
cb1a09d0 AD |
17429 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
17430 | ||
d420ca49 | 17431 | =over 4 |
a45bd81d | 17432 | |
cb1a09d0 AD |
17433 | =item SYNOPSIS |
17434 | ||
cb1a09d0 AD |
17435 | =item DESCRIPTION |
17436 | ||
cb1a09d0 AD |
17437 | =item EXAMPLE |
17438 | ||
a45bd81d GS |
17439 | =back |
17440 | ||
4d4e713d JH |
17441 | =head2 Text::Balanced - Extract delimited text sequences from strings. |
17442 | ||
17443 | =over 4 | |
17444 | ||
17445 | =item SYNOPSIS | |
17446 | ||
17447 | =item DESCRIPTION | |
17448 | ||
17449 | =over 4 | |
17450 | ||
17451 | =item General behaviour in list contexts | |
17452 | ||
17453 | [0], [1], [2] | |
17454 | ||
17455 | =item General behaviour in scalar and void contexts | |
17456 | ||
17457 | =item A note about prefixes | |
17458 | ||
17459 | =item C<extract_delimited> | |
17460 | ||
17461 | =item C<extract_bracketed> | |
17462 | ||
17463 | =item C<extract_tagged> | |
17464 | ||
17465 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, | |
17466 | [0], [1], [2], [3], [4], [5] | |
17467 | ||
17468 | =item C<gen_extract_tagged> | |
17469 | ||
17470 | =item C<extract_quotelike> | |
17471 | ||
17472 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] | |
17473 | ||
17474 | =item C<extract_quotelike> and "here documents" | |
17475 | ||
17476 | [0], [1], [2], [3], [4], [5], [6], [7..10] | |
17477 | ||
17478 | =item C<extract_codeblock> | |
17479 | ||
17480 | =item C<extract_multiple> | |
17481 | ||
17482 | =item C<gen_delimited_pat> | |
17483 | ||
17484 | =back | |
17485 | ||
17486 | =item DIAGNOSTICS | |
17487 | ||
17488 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, | |
17489 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike | |
17490 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, | |
17491 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, | |
17492 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing | |
17493 | bracket: expected "%c" but found "%s">, C<No block delimiter found after | |
17494 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier | |
17495 | after dereferencer>, C<Did not find expected opening bracket at %s>, | |
17496 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike | |
17497 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: | |
17498 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid | |
17499 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing | |
17500 | tag> | |
17501 | ||
17502 | =item AUTHOR | |
17503 | ||
17504 | =item BUGS AND IRRITATIONS | |
17505 | ||
17506 | =item COPYRIGHT | |
17507 | ||
17508 | =back | |
17509 | ||
193fb0af GS |
17510 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
17511 | arrays | |
cb1a09d0 | 17512 | |
d420ca49 | 17513 | =over 4 |
a45bd81d | 17514 | |
8ebc5c01 | 17515 | =item SYNOPSIS |
cb1a09d0 | 17516 | |
8ebc5c01 | 17517 | =item DESCRIPTION |
cb1a09d0 | 17518 | |
193fb0af GS |
17519 | =item EXAMPLES |
17520 | ||
8ebc5c01 | 17521 | =item AUTHORS |
cb1a09d0 | 17522 | |
a45bd81d GS |
17523 | =back |
17524 | ||
8ebc5c01 | 17525 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
17526 | by Knuth | |
cb1a09d0 | 17527 | |
d420ca49 | 17528 | =over 4 |
a45bd81d | 17529 | |
cb1a09d0 AD |
17530 | =item SYNOPSIS |
17531 | ||
cb1a09d0 AD |
17532 | =item DESCRIPTION |
17533 | ||
cb1a09d0 AD |
17534 | =item EXAMPLES |
17535 | ||
cb1a09d0 AD |
17536 | =item LIMITATIONS |
17537 | ||
cb1a09d0 AD |
17538 | =item AUTHOR |
17539 | ||
a45bd81d GS |
17540 | =back |
17541 | ||
8ebc5c01 | 17542 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
17543 | unexpand(1) | |
cb1a09d0 | 17544 | |
d420ca49 | 17545 | =over 4 |
a45bd81d | 17546 | |
8ebc5c01 | 17547 | =item SYNOPSIS |
cb1a09d0 | 17548 | |
8ebc5c01 | 17549 | =item DESCRIPTION |
cb1a09d0 | 17550 | |
8ebc5c01 | 17551 | =item BUGS |
cb1a09d0 | 17552 | |
8ebc5c01 | 17553 | =item AUTHOR |
cb1a09d0 | 17554 | |
a45bd81d GS |
17555 | =back |
17556 | ||
8ebc5c01 | 17557 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
cb1a09d0 | 17558 | |
d420ca49 | 17559 | =over 4 |
a45bd81d | 17560 | |
8ebc5c01 | 17561 | =item SYNOPSIS |
cb1a09d0 AD |
17562 | |
17563 | =item DESCRIPTION | |
17564 | ||
35bf961c JH |
17565 | =item OVERRIDES |
17566 | ||
8ebc5c01 | 17567 | =item EXAMPLE |
cb1a09d0 AD |
17568 | |
17569 | =item AUTHOR | |
17570 | ||
a45bd81d GS |
17571 | =back |
17572 | ||
07fcf8ff | 17573 | =head2 Thread - manipulate threads in Perl |
d516a115 | 17574 | |
d420ca49 | 17575 | =over 4 |
a45bd81d | 17576 | |
bd28ded5 JH |
17577 | =item CAVEAT |
17578 | ||
d516a115 JH |
17579 | =item SYNOPSIS |
17580 | ||
17581 | =item DESCRIPTION | |
17582 | ||
193fb0af GS |
17583 | =item FUNCTIONS |
17584 | ||
07fcf8ff JH |
17585 | $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, |
17586 | LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, | |
17587 | cond_signal VARIABLE, cond_broadcast VARIABLE, yield | |
193fb0af GS |
17588 | |
17589 | =item METHODS | |
17590 | ||
d420ca49 | 17591 | join, eval, detach, equal, tid, flags, done |
193fb0af GS |
17592 | |
17593 | =item LIMITATIONS | |
17594 | ||
d516a115 JH |
17595 | =item SEE ALSO |
17596 | ||
a45bd81d GS |
17597 | =back |
17598 | ||
d516a115 JH |
17599 | =head2 Thread::Queue - thread-safe queues |
17600 | ||
d420ca49 | 17601 | =over 4 |
a45bd81d | 17602 | |
d516a115 JH |
17603 | =item SYNOPSIS |
17604 | ||
193fb0af GS |
17605 | =item DESCRIPTION |
17606 | ||
17607 | =item FUNCTIONS AND METHODS | |
17608 | ||
17609 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
17610 | ||
17611 | =item SEE ALSO | |
17612 | ||
a45bd81d GS |
17613 | =back |
17614 | ||
d516a115 JH |
17615 | =head2 Thread::Semaphore - thread-safe semaphores |
17616 | ||
d420ca49 | 17617 | =over 4 |
a45bd81d | 17618 | |
d516a115 JH |
17619 | =item SYNOPSIS |
17620 | ||
193fb0af GS |
17621 | =item DESCRIPTION |
17622 | ||
17623 | =item FUNCTIONS AND METHODS | |
17624 | ||
17625 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
17626 | ||
a45bd81d GS |
17627 | =back |
17628 | ||
193fb0af GS |
17629 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
17630 | ||
d420ca49 | 17631 | =over 4 |
a45bd81d | 17632 | |
193fb0af GS |
17633 | =item SYNOPSIS |
17634 | ||
17635 | =item DESCRIPTION | |
17636 | ||
17637 | =item BUGS | |
17638 | ||
a45bd81d GS |
17639 | =back |
17640 | ||
d516a115 JH |
17641 | =head2 Thread::Specific - thread-specific keys |
17642 | ||
d420ca49 | 17643 | =over 4 |
a45bd81d | 17644 | |
d516a115 JH |
17645 | =item SYNOPSIS |
17646 | ||
14218588 GS |
17647 | =item DESCRIPTION |
17648 | ||
a45bd81d GS |
17649 | =back |
17650 | ||
d516a115 JH |
17651 | =head2 Tie::Array - base class for tied arrays |
17652 | ||
d420ca49 | 17653 | =over 4 |
a45bd81d | 17654 | |
37d4d706 | 17655 | =item SYNOPSIS |
d516a115 | 17656 | |
37d4d706 | 17657 | =item DESCRIPTION |
d516a115 JH |
17658 | |
17659 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
a45bd81d GS |
17660 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
17661 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
17662 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
d516a115 JH |
17663 | |
17664 | =item CAVEATS | |
17665 | ||
37d4d706 | 17666 | =item AUTHOR |
d516a115 | 17667 | |
a45bd81d GS |
17668 | =back |
17669 | ||
ff426ff2 JH |
17670 | =head2 Tie::File - Access the lines of a disk file via a Perl array |
17671 | ||
17672 | =over 4 | |
17673 | ||
17674 | =item SYNOPSIS | |
17675 | ||
17676 | =item DESCRIPTION | |
17677 | ||
17678 | =over 4 | |
17679 | ||
17680 | =item C<recsep> | |
17681 | ||
b2deec1d JH |
17682 | =item C<autochomp> |
17683 | ||
ff426ff2 JH |
17684 | =item C<mode> |
17685 | ||
b2deec1d JH |
17686 | =item C<memory> |
17687 | ||
17688 | =item C<dw_size> | |
ff426ff2 JH |
17689 | |
17690 | =item Option Format | |
17691 | ||
17692 | =back | |
17693 | ||
17694 | =item Public Methods | |
17695 | ||
17696 | =over 4 | |
17697 | ||
17698 | =item C<flock> | |
17699 | ||
b2deec1d | 17700 | =item C<autochomp> |
ff426ff2 | 17701 | |
b2deec1d | 17702 | =item C<defer>, C<flush>, and C<discard> |
ff426ff2 | 17703 | |
b2deec1d | 17704 | =back |
ff426ff2 | 17705 | |
b2deec1d | 17706 | =item Tying to an already-opened filehandle |
ff426ff2 | 17707 | |
b2deec1d | 17708 | =item Deferred Writing |
ff426ff2 | 17709 | |
b2deec1d | 17710 | =item CAVEATS |
ff426ff2 | 17711 | |
b2deec1d JH |
17712 | You might be tempted to think that deferred writing is like transactions, |
17713 | with C<flush> as C<commit> and C<discard> as C<rollback>, but it isn't, so | |
17714 | don't | |
ff426ff2 | 17715 | |
b2deec1d | 17716 | =item SUBCLASSING |
ff426ff2 | 17717 | |
b2deec1d | 17718 | =item WHAT ABOUT C<DB_File>? |
ff426ff2 JH |
17719 | |
17720 | =item AUTHOR | |
17721 | ||
17722 | =item LICENSE | |
17723 | ||
17724 | =item WARRANTY | |
17725 | ||
17726 | =item THANKS | |
17727 | ||
17728 | =item TODO | |
17729 | ||
17730 | =back | |
17731 | ||
14218588 GS |
17732 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
17733 | handles | |
193fb0af | 17734 | |
d420ca49 | 17735 | =over 4 |
a45bd81d | 17736 | |
193fb0af GS |
17737 | =item SYNOPSIS |
17738 | ||
17739 | =item DESCRIPTION | |
17740 | ||
17741 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
17742 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
14218588 GS |
17743 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
17744 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
193fb0af GS |
17745 | |
17746 | =item MORE INFORMATION | |
17747 | ||
37d4d706 JH |
17748 | =item COMPATIBILITY |
17749 | ||
a45bd81d GS |
17750 | =back |
17751 | ||
12b7c5c7 JH |
17752 | =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for |
17753 | tied hashes | |
8ebc5c01 | 17754 | |
d420ca49 | 17755 | =over 4 |
a45bd81d | 17756 | |
8ebc5c01 | 17757 | =item SYNOPSIS |
17758 | ||
17759 | =item DESCRIPTION | |
cb1a09d0 | 17760 | |
8ebc5c01 | 17761 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
17762 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this | |
cb1a09d0 | 17763 | |
12b7c5c7 JH |
17764 | =item Inheriting from B<Tie::StdHash> |
17765 | ||
17766 | =item Inheriting from B<Tie::ExtraHash> | |
17767 | ||
17768 | =item C<UNTIE> and C<DESTROY> | |
cb1a09d0 | 17769 | |
8ebc5c01 | 17770 | =item MORE INFORMATION |
cb1a09d0 | 17771 | |
a45bd81d GS |
17772 | =back |
17773 | ||
12b7c5c7 JH |
17774 | =head2 Tie::Memoize - add data to hash when needed |
17775 | ||
17776 | =over 4 | |
17777 | ||
17778 | =item SYNOPSIS | |
17779 | ||
17780 | =item DESCRIPTION | |
17781 | ||
17782 | =item Inheriting from B<Tie::Memoize> | |
17783 | ||
17784 | =item EXAMPLE | |
17785 | ||
17786 | =item BUGS | |
17787 | ||
17788 | =item AUTHOR | |
17789 | ||
17790 | =back | |
17791 | ||
8ebc5c01 | 17792 | =head2 Tie::RefHash - use references as hash keys |
cb1a09d0 | 17793 | |
d420ca49 | 17794 | =over 4 |
a45bd81d | 17795 | |
cb1a09d0 AD |
17796 | =item SYNOPSIS |
17797 | ||
cb1a09d0 AD |
17798 | =item DESCRIPTION |
17799 | ||
8ebc5c01 | 17800 | =item EXAMPLE |
cb1a09d0 AD |
17801 | |
17802 | =item AUTHOR | |
17803 | ||
8ebc5c01 | 17804 | =item VERSION |
cb1a09d0 | 17805 | |
8ebc5c01 | 17806 | =item SEE ALSO |
cb1a09d0 | 17807 | |
a45bd81d GS |
17808 | =back |
17809 | ||
8ebc5c01 | 17810 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
17811 | scalars | |
cb1a09d0 | 17812 | |
d420ca49 | 17813 | =over 4 |
a45bd81d | 17814 | |
cb1a09d0 AD |
17815 | =item SYNOPSIS |
17816 | ||
cb1a09d0 AD |
17817 | =item DESCRIPTION |
17818 | ||
8ebc5c01 | 17819 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
cb1a09d0 | 17820 | |
8ebc5c01 | 17821 | =item MORE INFORMATION |
cb1a09d0 | 17822 | |
a45bd81d GS |
17823 | =back |
17824 | ||
8ebc5c01 | 17825 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
cb1a09d0 | 17826 | |
d420ca49 | 17827 | =over 4 |
a45bd81d | 17828 | |
8ebc5c01 | 17829 | =item SYNOPSIS |
cb1a09d0 | 17830 | |
8ebc5c01 | 17831 | =item DESCRIPTION |
cb1a09d0 | 17832 | |
8ebc5c01 | 17833 | =item CAVEATS |
cb1a09d0 | 17834 | |
a45bd81d GS |
17835 | =back |
17836 | ||
1fdc5aa6 JH |
17837 | =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval |
17838 | timers | |
41ca3a40 JH |
17839 | |
17840 | =over 4 | |
17841 | ||
17842 | =item SYNOPSIS | |
17843 | ||
17844 | =item DESCRIPTION | |
17845 | ||
17846 | gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, | |
245d750e JH |
17847 | $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), |
17848 | alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer, | |
17849 | getitimer ( $which ) | |
41ca3a40 JH |
17850 | |
17851 | =item EXAMPLES | |
17852 | ||
17853 | =item C API | |
17854 | ||
245d750e JH |
17855 | =item CAVEATS |
17856 | ||
41ca3a40 JH |
17857 | =item AUTHORS |
17858 | ||
17859 | =item REVISION | |
17860 | ||
17861 | =item COPYRIGHT | |
17862 | ||
17863 | =back | |
17864 | ||
8ebc5c01 | 17865 | =head2 Time::Local - efficiently compute time from local and GMT time |
cb1a09d0 | 17866 | |
d420ca49 | 17867 | =over 4 |
a45bd81d | 17868 | |
8ebc5c01 | 17869 | =item SYNOPSIS |
cb1a09d0 | 17870 | |
8ebc5c01 | 17871 | =item DESCRIPTION |
cb1a09d0 | 17872 | |
14218588 GS |
17873 | =item IMPLEMENTATION |
17874 | ||
17875 | =item BUGS | |
17876 | ||
a45bd81d GS |
17877 | =back |
17878 | ||
8ebc5c01 | 17879 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
17880 | function | |
7d2bfb28 | 17881 | |
d420ca49 | 17882 | =over 4 |
a45bd81d | 17883 | |
7d2bfb28 | 17884 | =item SYNOPSIS |
17885 | ||
7d2bfb28 | 17886 | =item DESCRIPTION |
17887 | ||
8ebc5c01 | 17888 | =item NOTE |
7d2bfb28 | 17889 | |
8ebc5c01 | 17890 | =item AUTHOR |
7d2bfb28 | 17891 | |
a45bd81d GS |
17892 | =back |
17893 | ||
8ebc5c01 | 17894 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
17895 | function | |
7d2bfb28 | 17896 | |
d420ca49 | 17897 | =over 4 |
a45bd81d | 17898 | |
8ebc5c01 | 17899 | =item SYNOPSIS |
7d2bfb28 | 17900 | |
8ebc5c01 | 17901 | =item DESCRIPTION |
7d2bfb28 | 17902 | |
8ebc5c01 | 17903 | =item NOTE |
7d2bfb28 | 17904 | |
8ebc5c01 | 17905 | =item AUTHOR |
7d2bfb28 | 17906 | |
a45bd81d GS |
17907 | =back |
17908 | ||
8ebc5c01 | 17909 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 17910 | |
d420ca49 | 17911 | =over 4 |
a45bd81d | 17912 | |
7d2bfb28 | 17913 | =item SYNOPSIS |
17914 | ||
8ebc5c01 | 17915 | =item DESCRIPTION |
17916 | ||
17917 | =item AUTHOR | |
17918 | ||
a45bd81d GS |
17919 | =back |
17920 | ||
8ebc5c01 | 17921 | =head2 UNIVERSAL - base class for ALL classes (blessed references) |
17922 | ||
d420ca49 | 17923 | =over 4 |
a45bd81d | 17924 | |
8ebc5c01 | 17925 | =item SYNOPSIS |
7d2bfb28 | 17926 | |
17927 | =item DESCRIPTION | |
17928 | ||
ba62762e JH |
17929 | $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD |
17930 | ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] ) | |
7d2bfb28 | 17931 | |
a45bd81d GS |
17932 | =back |
17933 | ||
53d7eaa8 JH |
17934 | =head2 Unicode::Collate - use UCA (Unicode Collation Algorithm) |
17935 | ||
17936 | =over 4 | |
17937 | ||
17938 | =item SYNOPSIS | |
17939 | ||
17940 | =item DESCRIPTION | |
17941 | ||
17942 | =over 4 | |
17943 | ||
17944 | =item Constructor and Tailoring | |
17945 | ||
17946 | alternate, backwards, entry, ignoreName, ignoreChar, level, normalization, | |
17947 | overrideCJK, overrideHangul, preprocess, rearrange, table, undefName, | |
17948 | undefChar, katakana_before_hiragana, upper_before_lower | |
17949 | ||
17950 | =item Other methods | |
17951 | ||
ba62762e JH |
17952 | C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = |
17953 | $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, | |
17954 | C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, | |
17955 | $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = | |
17956 | $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, | |
17957 | C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$position = | |
17958 | $Collator-E<gt>index($string, $substring)>, C<($position, $length) = | |
17959 | $Collator-E<gt>index($string, $substring)> | |
53d7eaa8 JH |
17960 | |
17961 | =item EXPORT | |
17962 | ||
ff426ff2 JH |
17963 | =item TODO |
17964 | ||
53d7eaa8 JH |
17965 | =item CAVEAT |
17966 | ||
17967 | =back | |
17968 | ||
17969 | =item AUTHOR | |
17970 | ||
17971 | =item SEE ALSO | |
17972 | ||
ba62762e | 17973 | Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize> |
53d7eaa8 JH |
17974 | |
17975 | =back | |
17976 | ||
17977 | =head2 Unicode::Normalize - normalized forms of Unicode text | |
17978 | ||
17979 | =over 4 | |
17980 | ||
17981 | =item SYNOPSIS | |
17982 | ||
17983 | =item DESCRIPTION | |
17984 | ||
f502af34 JH |
17985 | =over 4 |
17986 | ||
17987 | =item Normalization Forms | |
17988 | ||
b2deec1d JH |
17989 | C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, |
17990 | C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, | |
17991 | C<$normalized_string = normalize($form_name, $string)> | |
17992 | ||
17993 | =item Decomposition and Composition | |
17994 | ||
17995 | C<$decomposed_string = decompose($string)>, C<$decomposed_string = | |
17996 | decompose($string, $useCompatMapping)>, C<$reordered_string = | |
17997 | reorder($string)>, C<$composed_string = compose($string)> | |
17998 | ||
17999 | =item Quick Check | |
18000 | ||
18001 | C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = | |
18002 | checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = | |
18003 | check($form_name, $string)> | |
53d7eaa8 | 18004 | |
f502af34 JH |
18005 | =item Character Data |
18006 | ||
18007 | C<$canonical_decomposed = getCanon($codepoint)>, | |
b2deec1d JH |
18008 | C<$compatibility_decomposed = getCompat($codepoint)>, |
18009 | C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, | |
18010 | C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = | |
18011 | isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, | |
18012 | C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>, | |
18013 | C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> | |
53d7eaa8 JH |
18014 | |
18015 | =item EXPORT | |
18016 | ||
18017 | =back | |
18018 | ||
18019 | =item AUTHOR | |
18020 | ||
18021 | =item SEE ALSO | |
18022 | ||
b2deec1d JH |
18023 | http://www.unicode.org/unicode/reports/tr15/, |
18024 | http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProperties.txt | |
53d7eaa8 JH |
18025 | |
18026 | =back | |
18027 | ||
2a2bf5f4 | 18028 | =head2 Unicode::UCD - Unicode character database |
354a27bf JH |
18029 | |
18030 | =over 4 | |
18031 | ||
18032 | =item SYNOPSIS | |
18033 | ||
18034 | =item DESCRIPTION | |
18035 | ||
18036 | =back | |
18037 | ||
18038 | =over 4 | |
18039 | ||
18040 | =item charinfo | |
18041 | ||
18042 | =back | |
18043 | ||
18044 | =over 4 | |
18045 | ||
18046 | =item charblock | |
18047 | ||
18048 | =back | |
18049 | ||
18050 | =over 4 | |
18051 | ||
fbe3d936 JH |
18052 | =item charscript |
18053 | ||
18054 | =back | |
18055 | ||
18056 | =over 4 | |
18057 | ||
389925df | 18058 | =item charblocks |
fbe3d936 JH |
18059 | |
18060 | =back | |
18061 | ||
18062 | =over 4 | |
18063 | ||
389925df JH |
18064 | =item charscripts |
18065 | ||
18066 | =back | |
18067 | ||
18068 | =over 4 | |
18069 | ||
18070 | =item Blocks versus Scripts | |
18071 | ||
18072 | =item Matching Scripts and Blocks | |
18073 | ||
d0363f02 JH |
18074 | =item Code Point Arguments |
18075 | ||
389925df JH |
18076 | =item charinrange |
18077 | ||
18078 | =back | |
18079 | ||
18080 | =over 4 | |
18081 | ||
d0363f02 JH |
18082 | =item compexcl |
18083 | ||
18084 | =back | |
18085 | ||
18086 | =over 4 | |
18087 | ||
18088 | =item casefold | |
18089 | ||
18090 | =back | |
18091 | ||
18092 | =over 4 | |
18093 | ||
18094 | =item casespec | |
18095 | ||
18096 | =back | |
18097 | ||
18098 | =over 4 | |
18099 | ||
2a2bf5f4 | 18100 | =item Unicode::UCD::UnicodeVersion |
389925df JH |
18101 | |
18102 | =back | |
18103 | ||
18104 | =over 4 | |
18105 | ||
18106 | =item Implementation Note | |
18107 | ||
18108 | =back | |
18109 | ||
18110 | =over 4 | |
fbe3d936 | 18111 | |
cb52f95f JH |
18112 | =item BUGS |
18113 | ||
354a27bf JH |
18114 | =item AUTHOR |
18115 | ||
18116 | =back | |
18117 | ||
8ebc5c01 | 18118 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
18119 | functions | |
7d2bfb28 | 18120 | |
d420ca49 | 18121 | =over 4 |
a45bd81d | 18122 | |
8ebc5c01 | 18123 | =item SYNOPSIS |
7d2bfb28 | 18124 | |
8ebc5c01 | 18125 | =item DESCRIPTION |
7d2bfb28 | 18126 | |
8ebc5c01 | 18127 | =item NOTE |
7d2bfb28 | 18128 | |
8ebc5c01 | 18129 | =item AUTHOR |
7d2bfb28 | 18130 | |
a45bd81d GS |
18131 | =back |
18132 | ||
8ebc5c01 | 18133 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
18134 | functions | |
cb1a09d0 | 18135 | |
d420ca49 | 18136 | =over 4 |
a45bd81d | 18137 | |
cb1a09d0 AD |
18138 | =item SYNOPSIS |
18139 | ||
cb1a09d0 AD |
18140 | =item DESCRIPTION |
18141 | ||
d420ca49 | 18142 | =over 4 |
b38f6a39 | 18143 | |
37590e52 | 18144 | =item System Specifics |
b38f6a39 GS |
18145 | |
18146 | =back | |
18147 | ||
37590e52 | 18148 | =item NOTE |
b38f6a39 GS |
18149 | |
18150 | =item AUTHOR | |
18151 | ||
37590e52 | 18152 | =item HISTORY |
b38f6a39 | 18153 | |
37590e52 | 18154 | March 18th, 2000 |
b38f6a39 GS |
18155 | |
18156 | =back | |
18157 | ||
4755096e GS |
18158 | =head2 Win32 - Interfaces to some Win32 API Functions |
18159 | ||
d420ca49 | 18160 | =over 4 |
4755096e GS |
18161 | |
18162 | =item DESCRIPTION | |
18163 | ||
d420ca49 | 18164 | =over 4 |
4755096e GS |
18165 | |
18166 | =item Alphabetical Listing of Win32 Functions | |
18167 | ||
18168 | Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), | |
18169 | Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), | |
18170 | Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), | |
18171 | Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), | |
18172 | Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), | |
18173 | Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), | |
18174 | Win32::GetNextAvailDrive(), Win32::GetOSVersion(), | |
18175 | Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, | |
983dbef6 JH |
18176 | PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, |
18177 | Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), | |
18178 | Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, | |
18179 | SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), | |
4755096e | 18180 | Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), |
12b7c5c7 JH |
18181 | Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW), |
18182 | Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR), | |
18183 | Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID), | |
18184 | Win32::UnregisterServer(LIBRARYNAME) | |
4755096e GS |
18185 | |
18186 | =back | |
18187 | ||
18188 | =back | |
18189 | ||
0d0e97a6 JH |
18190 | =head2 XS::Typemap - module to test the XS typemaps distributed with perl |
18191 | ||
18192 | =over 4 | |
18193 | ||
18194 | =item SYNOPSIS | |
18195 | ||
18196 | =item DESCRIPTION | |
18197 | ||
18198 | =back | |
18199 | ||
18200 | =over 4 | |
18201 | ||
18202 | =item NOTES | |
18203 | ||
18204 | =item AUTHOR | |
18205 | ||
18206 | =back | |
18207 | ||
a45bd81d GS |
18208 | =head2 XSLoader - Dynamically load C libraries into Perl code |
18209 | ||
d420ca49 | 18210 | =over 4 |
a45bd81d GS |
18211 | |
18212 | =item SYNOPSIS | |
18213 | ||
18214 | =item DESCRIPTION | |
18215 | ||
18216 | =item AUTHOR | |
18217 | ||
18218 | =back | |
18219 | ||
cb1a09d0 AD |
18220 | =head1 AUXILIARY DOCUMENTATION |
18221 | ||
8ebc5c01 | 18222 | Here should be listed all the extra programs' documentation, but they |
18223 | don't all have manual pages yet: | |
cb1a09d0 | 18224 | |
d420ca49 | 18225 | =over 4 |
a45bd81d | 18226 | |
cb1a09d0 AD |
18227 | =item a2p |
18228 | ||
18229 | =item s2p | |
18230 | ||
18231 | =item find2perl | |
18232 | ||
18233 | =item h2ph | |
18234 | ||
18235 | =item c2ph | |
18236 | ||
18237 | =item h2xs | |
18238 | ||
18239 | =item xsubpp | |
18240 | ||
18241 | =item pod2man | |
18242 | ||
18243 | =item wrapsuid | |
18244 | ||
a45bd81d GS |
18245 | =back |
18246 | ||
cb1a09d0 AD |
18247 | =head1 AUTHOR |
18248 | ||
2ae324a7 | 18249 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
8ebc5c01 | 18250 | of other folks. |
cb1a09d0 | 18251 |