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 | ||
cb1a09d0 AD |
20 | =item DESCRIPTION |
21 | ||
14218588 | 22 | =item AVAILABILITY |
cb1a09d0 AD |
23 | |
24 | =item ENVIRONMENT | |
25 | ||
cb1a09d0 AD |
26 | =item AUTHOR |
27 | ||
cb1a09d0 AD |
28 | =item FILES |
29 | ||
cb1a09d0 AD |
30 | =item SEE ALSO |
31 | ||
cb1a09d0 AD |
32 | =item DIAGNOSTICS |
33 | ||
cb1a09d0 AD |
34 | =item BUGS |
35 | ||
cb1a09d0 AD |
36 | =item NOTES |
37 | ||
a45bd81d GS |
38 | =back |
39 | ||
14218588 GS |
40 | =head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 |
41 | 20:38:02 $) | |
68dc0745 | 42 | |
d420ca49 | 43 | =over 4 |
a45bd81d | 44 | |
68dc0745 | 45 | =item DESCRIPTION |
46 | ||
983dbef6 | 47 | =over 4 |
68dc0745 | 48 | |
983dbef6 | 49 | =item perlfaq: Structural overview of the FAQ. |
68dc0745 | 50 | |
983dbef6 | 51 | =item L<perlfaq1>: General Questions About Perl |
68dc0745 | 52 | |
983dbef6 | 53 | =item L<perlfaq2>: Obtaining and Learning about Perl |
68dc0745 | 54 | |
983dbef6 | 55 | =item L<perlfaq3>: Programming Tools |
68dc0745 | 56 | |
983dbef6 | 57 | =item L<perlfaq4>: Data Manipulation |
68dc0745 | 58 | |
983dbef6 | 59 | =item L<perlfaq5>: Files and Formats |
68dc0745 | 60 | |
983dbef6 | 61 | =item L<perlfaq6>: Regexps |
68dc0745 | 62 | |
983dbef6 | 63 | =item L<perlfaq7>: General Perl Language Issues |
68dc0745 | 64 | |
983dbef6 | 65 | =item L<perlfaq8>: System Interaction |
68dc0745 | 66 | |
983dbef6 | 67 | =item L<perlfaq9>: Networking |
68dc0745 | 68 | |
a45bd81d GS |
69 | =back |
70 | ||
983dbef6 | 71 | =item About the perlfaq documents |
68dc0745 | 72 | |
d420ca49 | 73 | =over 4 |
a45bd81d | 74 | |
983dbef6 | 75 | =item Where to get the perlfaq |
68dc0745 | 76 | |
983dbef6 | 77 | =item How to contribute to the perlfaq |
68dc0745 | 78 | |
983dbef6 JH |
79 | =item What will happen if you mail your Perl programming problems to the |
80 | authors | |
68dc0745 | 81 | |
983dbef6 | 82 | =back |
68dc0745 | 83 | |
983dbef6 | 84 | =item Credits |
68dc0745 | 85 | |
983dbef6 | 86 | =item Author and Copyright Information |
68dc0745 | 87 | |
983dbef6 JH |
88 | =over 4 |
89 | ||
90 | =item Bundled Distributions | |
91 | ||
92 | =item Disclaimer | |
68dc0745 | 93 | |
4755096e | 94 | =back |
68dc0745 | 95 | |
983dbef6 JH |
96 | =item Changes |
97 | ||
98 | 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, | |
99 | 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, | |
100 | Initial Release: 11/March/97 | |
101 | ||
4755096e | 102 | =back |
68dc0745 | 103 | |
4755096e | 104 | =head2 perlbook - Perl book information |
68dc0745 | 105 | |
d420ca49 | 106 | =over 4 |
68dc0745 | 107 | |
4755096e | 108 | =item DESCRIPTION |
68dc0745 | 109 | |
a45bd81d GS |
110 | =back |
111 | ||
4755096e | 112 | =head2 perlsyn - Perl syntax |
a45bd81d | 113 | |
d420ca49 | 114 | =over 4 |
68dc0745 | 115 | |
116 | =item DESCRIPTION | |
117 | ||
d420ca49 | 118 | =over 4 |
68dc0745 | 119 | |
4755096e | 120 | =item Declarations |
68dc0745 | 121 | |
4755096e | 122 | =item Simple statements |
68dc0745 | 123 | |
4755096e | 124 | =item Compound statements |
3fe9a6f1 | 125 | |
4755096e | 126 | =item Loop Control |
68dc0745 | 127 | |
4755096e | 128 | =item For Loops |
68dc0745 | 129 | |
4755096e | 130 | =item Foreach Loops |
68dc0745 | 131 | |
4755096e | 132 | =item Basic BLOCKs and Switch Statements |
68dc0745 | 133 | |
4755096e | 134 | =item Goto |
68dc0745 | 135 | |
4755096e | 136 | =item PODs: Embedded Documentation |
68dc0745 | 137 | |
4755096e | 138 | =item Plain Old Comments (Not!) |
68dc0745 | 139 | |
4755096e | 140 | =back |
68dc0745 | 141 | |
4755096e | 142 | =back |
193fb0af | 143 | |
4755096e | 144 | =head2 perldata - Perl data types |
68dc0745 | 145 | |
d420ca49 | 146 | =over 4 |
68dc0745 | 147 | |
4755096e | 148 | =item DESCRIPTION |
68dc0745 | 149 | |
d420ca49 | 150 | =over 4 |
68dc0745 | 151 | |
4755096e | 152 | =item Variable names |
68dc0745 | 153 | |
4755096e | 154 | =item Context |
68dc0745 | 155 | |
4755096e GS |
156 | =item Scalar values |
157 | ||
158 | =item Scalar value constructors | |
159 | ||
160 | =item List value constructors | |
161 | ||
162 | =item Slices | |
163 | ||
164 | =item Typeglobs and Filehandles | |
68dc0745 | 165 | |
166 | =back | |
167 | ||
4755096e | 168 | =item SEE ALSO |
68dc0745 | 169 | |
a45bd81d GS |
170 | =back |
171 | ||
4755096e | 172 | =head2 perlop - Perl operators and precedence |
68dc0745 | 173 | |
d420ca49 | 174 | =over 4 |
a45bd81d | 175 | |
4755096e GS |
176 | =item SYNOPSIS |
177 | ||
68dc0745 | 178 | =item DESCRIPTION |
179 | ||
d420ca49 | 180 | =over 4 |
68dc0745 | 181 | |
4755096e | 182 | =item Terms and List Operators (Leftward) |
68dc0745 | 183 | |
4755096e | 184 | =item The Arrow Operator |
68dc0745 | 185 | |
4755096e | 186 | =item Auto-increment and Auto-decrement |
68dc0745 | 187 | |
4755096e | 188 | =item Exponentiation |
68dc0745 | 189 | |
4755096e | 190 | =item Symbolic Unary Operators |
68dc0745 | 191 | |
4755096e | 192 | =item Binding Operators |
68dc0745 | 193 | |
4755096e | 194 | =item Multiplicative Operators |
68dc0745 | 195 | |
4755096e | 196 | =item Additive Operators |
68dc0745 | 197 | |
4755096e | 198 | =item Shift Operators |
14218588 | 199 | |
4755096e | 200 | =item Named Unary Operators |
68dc0745 | 201 | |
4755096e | 202 | =item Relational Operators |
68dc0745 | 203 | |
4755096e | 204 | =item Equality Operators |
68dc0745 | 205 | |
4755096e | 206 | =item Bitwise And |
68dc0745 | 207 | |
4755096e | 208 | =item Bitwise Or and Exclusive Or |
68dc0745 | 209 | |
4755096e | 210 | =item C-style Logical And |
68dc0745 | 211 | |
4755096e | 212 | =item C-style Logical Or |
68dc0745 | 213 | |
4755096e | 214 | =item Range Operators |
68dc0745 | 215 | |
4755096e | 216 | =item Conditional Operator |
68dc0745 | 217 | |
4755096e | 218 | =item Assignment Operators |
68dc0745 | 219 | |
4755096e | 220 | =item Comma Operator |
68dc0745 | 221 | |
4755096e | 222 | =item List Operators (Rightward) |
68dc0745 | 223 | |
4755096e | 224 | =item Logical Not |
68dc0745 | 225 | |
4755096e | 226 | =item Logical And |
14218588 | 227 | |
4755096e | 228 | =item Logical or and Exclusive Or |
68dc0745 | 229 | |
4755096e | 230 | =item C Operators Missing From Perl |
68dc0745 | 231 | |
4755096e | 232 | unary &, unary *, (TYPE) |
68dc0745 | 233 | |
4755096e | 234 | =item Quote and Quote-like Operators |
68dc0745 | 235 | |
4755096e | 236 | =item Regexp Quote-Like Operators |
68dc0745 | 237 | |
4755096e | 238 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, |
2d967e39 JH |
239 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, |
240 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, | |
4755096e | 241 | y/SEARCHLIST/REPLACEMENTLIST/cds |
68dc0745 | 242 | |
4755096e | 243 | =item Gory details of parsing quoted constructs |
68dc0745 | 244 | |
4755096e GS |
245 | Finding the end, Removal of backslashes before delimiters, Interpolation, |
246 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
247 | C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, | |
248 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
249 | regular expressions | |
68dc0745 | 250 | |
4755096e | 251 | =item I/O Operators |
68dc0745 | 252 | |
4755096e | 253 | =item Constant Folding |
68dc0745 | 254 | |
4755096e GS |
255 | =item Bitwise String Operators |
256 | ||
257 | =item Integer Arithmetic | |
258 | ||
259 | =item Floating-point Arithmetic | |
260 | ||
261 | =item Bigger Numbers | |
68dc0745 | 262 | |
a45bd81d GS |
263 | =back |
264 | ||
4755096e GS |
265 | =back |
266 | ||
c2e66d9e GS |
267 | =head2 perlsub - Perl subroutines |
268 | ||
d420ca49 | 269 | =over 4 |
c2e66d9e GS |
270 | |
271 | =item SYNOPSIS | |
272 | ||
273 | =item DESCRIPTION | |
274 | ||
d420ca49 | 275 | =over 4 |
c2e66d9e GS |
276 | |
277 | =item Private Variables via my() | |
278 | ||
279 | =item Persistent Private Variables | |
280 | ||
281 | =item Temporary Values via local() | |
282 | ||
283 | =item Lvalue subroutines | |
284 | ||
285 | =item Passing Symbol Table Entries (typeglobs) | |
286 | ||
287 | =item When to Still Use local() | |
288 | ||
c2e66d9e GS |
289 | =item Pass by Reference |
290 | ||
291 | =item Prototypes | |
292 | ||
293 | =item Constant Functions | |
294 | ||
295 | =item Overriding Built-in Functions | |
296 | ||
297 | =item Autoloading | |
298 | ||
299 | =item Subroutine Attributes | |
300 | ||
301 | =back | |
302 | ||
303 | =item SEE ALSO | |
304 | ||
305 | =back | |
306 | ||
307 | =head2 perlfunc - Perl builtin functions | |
308 | ||
d420ca49 | 309 | =over 4 |
c2e66d9e GS |
310 | |
311 | =item DESCRIPTION | |
312 | ||
d420ca49 | 313 | =over 4 |
c2e66d9e GS |
314 | |
315 | =item Perl Functions by Category | |
316 | ||
317 | Functions for SCALARs or strings, Regular expressions and pattern matching, | |
318 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
319 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
320 | length data or records, Functions for filehandles, files, or directories, | |
321 | Keywords related to the control flow of your perl program, Keywords related | |
322 | to scoping, Miscellaneous functions, Functions for processes and process | |
323 | groups, Keywords related to perl modules, Keywords related to classes and | |
324 | object-orientedness, Low-level socket functions, System V interprocess | |
325 | communication functions, Fetching user and group info, Fetching network | |
326 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
327 | in perl5 | |
328 | ||
329 | =item Portability | |
330 | ||
331 | =item Alphabetical Listing of Perl Functions | |
332 | ||
333 | I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept | |
334 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, | |
335 | binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME, | |
336 | bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, | |
337 | chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER, | |
338 | chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, | |
d396a558 | 339 | connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, |
c2e66d9e GS |
340 | dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete |
341 | EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, | |
342 | each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, | |
343 | exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl | |
344 | FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, | |
345 | fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, | |
346 | getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam | |
347 | NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname | |
348 | NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr | |
349 | ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
350 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
351 | getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent | |
352 | STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, | |
353 | endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, | |
354 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, | |
355 | goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, | |
356 | import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl | |
357 | FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, | |
358 | last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, | |
359 | link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, | |
91e74348 JH |
360 | lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, |
361 | mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, | |
362 | msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : | |
363 | ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open | |
772ff3b9 JH |
364 | FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, |
365 | open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR | |
366 | : ATTRIBUTES, pack TEMPLATE,LIST, package NAMESPACE, package, pipe | |
367 | READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE | |
368 | LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT, | |
369 | LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/, | |
370 | qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, | |
371 | rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, | |
372 | readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, | |
373 | recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename | |
245d750e JH |
374 | OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset, |
375 | return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex | |
376 | STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar | |
377 | EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select | |
378 | FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl | |
379 | ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
c2e66d9e GS |
380 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority |
381 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
382 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
383 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
80cbd5ad JH |
384 | EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL, |
385 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort | |
386 | BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice | |
387 | ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split | |
388 | /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf | |
389 | FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat | |
390 | EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK, | |
391 | substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr | |
c2e66d9e GS |
392 | EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen |
393 | FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread | |
394 | FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
395 | FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite | |
396 | FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, | |
397 | syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie | |
398 | VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate | |
399 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, | |
400 | ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack | |
401 | TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST, | |
402 | use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST, | |
403 | values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn | |
404 | LIST, write FILEHANDLE, write EXPR, write, y/// | |
405 | ||
406 | =back | |
407 | ||
408 | =back | |
409 | ||
4755096e | 410 | =head2 perlreftut - Mark's very short tutorial about references |
68dc0745 | 411 | |
d420ca49 | 412 | =over 4 |
a45bd81d | 413 | |
68dc0745 | 414 | =item DESCRIPTION |
415 | ||
4755096e GS |
416 | =item Who Needs Complicated Data Structures? |
417 | ||
418 | =item The Solution | |
419 | ||
420 | =item Syntax | |
68dc0745 | 421 | |
d420ca49 | 422 | =over 4 |
68dc0745 | 423 | |
4755096e | 424 | =item Making References |
46fc3d4c | 425 | |
4755096e | 426 | =item Using References |
68dc0745 | 427 | |
4755096e | 428 | =back |
68dc0745 | 429 | |
4755096e | 430 | =item An Example |
68dc0745 | 431 | |
4755096e | 432 | =item Arrow Rule |
14218588 | 433 | |
4755096e | 434 | =item Solution |
68dc0745 | 435 | |
4755096e | 436 | =item The Rest |
68dc0745 | 437 | |
4755096e | 438 | =item Summary |
68dc0745 | 439 | |
4755096e GS |
440 | =item Credits |
441 | ||
d420ca49 | 442 | =over 4 |
4755096e GS |
443 | |
444 | =item Distribution Conditions | |
68dc0745 | 445 | |
446 | =back | |
447 | ||
4755096e GS |
448 | =back |
449 | ||
450 | =head2 perldsc - Perl Data Structures Cookbook | |
68dc0745 | 451 | |
d420ca49 | 452 | =over 4 |
68dc0745 | 453 | |
4755096e | 454 | =item DESCRIPTION |
68dc0745 | 455 | |
4755096e GS |
456 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
457 | more elaborate constructs | |
14218588 | 458 | |
4755096e | 459 | =item REFERENCES |
68dc0745 | 460 | |
4755096e | 461 | =item COMMON MISTAKES |
68dc0745 | 462 | |
4755096e | 463 | =item CAVEAT ON PRECEDENCE |
68dc0745 | 464 | |
4755096e | 465 | =item WHY YOU SHOULD ALWAYS C<use strict> |
14218588 | 466 | |
4755096e | 467 | =item DEBUGGING |
68dc0745 | 468 | |
4755096e | 469 | =item CODE EXAMPLES |
68dc0745 | 470 | |
4755096e | 471 | =item ARRAYS OF ARRAYS |
68dc0745 | 472 | |
d420ca49 | 473 | =over 4 |
68dc0745 | 474 | |
4755096e | 475 | =item Declaration of a ARRAY OF ARRAYS |
68dc0745 | 476 | |
4755096e | 477 | =item Generation of a ARRAY OF ARRAYS |
68dc0745 | 478 | |
4755096e | 479 | =item Access and Printing of a ARRAY OF ARRAYS |
68dc0745 | 480 | |
4755096e | 481 | =back |
68dc0745 | 482 | |
4755096e | 483 | =item HASHES OF ARRAYS |
68dc0745 | 484 | |
d420ca49 | 485 | =over 4 |
68dc0745 | 486 | |
4755096e | 487 | =item Declaration of a HASH OF ARRAYS |
68dc0745 | 488 | |
4755096e | 489 | =item Generation of a HASH OF ARRAYS |
68dc0745 | 490 | |
4755096e | 491 | =item Access and Printing of a HASH OF ARRAYS |
68dc0745 | 492 | |
4755096e | 493 | =back |
68dc0745 | 494 | |
4755096e | 495 | =item ARRAYS OF HASHES |
68dc0745 | 496 | |
d420ca49 | 497 | =over 4 |
68dc0745 | 498 | |
4755096e | 499 | =item Declaration of a ARRAY OF HASHES |
68dc0745 | 500 | |
4755096e | 501 | =item Generation of a ARRAY OF HASHES |
68dc0745 | 502 | |
4755096e | 503 | =item Access and Printing of a ARRAY OF HASHES |
14218588 | 504 | |
4755096e | 505 | =back |
68dc0745 | 506 | |
4755096e | 507 | =item HASHES OF HASHES |
68dc0745 | 508 | |
d420ca49 | 509 | =over 4 |
68dc0745 | 510 | |
4755096e | 511 | =item Declaration of a HASH OF HASHES |
68dc0745 | 512 | |
4755096e | 513 | =item Generation of a HASH OF HASHES |
68dc0745 | 514 | |
4755096e | 515 | =item Access and Printing of a HASH OF HASHES |
68dc0745 | 516 | |
517 | =back | |
518 | ||
4755096e | 519 | =item MORE ELABORATE RECORDS |
68dc0745 | 520 | |
d420ca49 | 521 | =over 4 |
68dc0745 | 522 | |
4755096e | 523 | =item Declaration of MORE ELABORATE RECORDS |
14218588 | 524 | |
4755096e | 525 | =item Declaration of a HASH OF COMPLEX RECORDS |
68dc0745 | 526 | |
4755096e | 527 | =item Generation of a HASH OF COMPLEX RECORDS |
68dc0745 | 528 | |
4755096e | 529 | =back |
68dc0745 | 530 | |
4755096e | 531 | =item Database Ties |
68dc0745 | 532 | |
4755096e | 533 | =item SEE ALSO |
68dc0745 | 534 | |
4755096e | 535 | =item AUTHOR |
14218588 | 536 | |
4755096e | 537 | =back |
68dc0745 | 538 | |
4755096e | 539 | =head2 perlrequick - Perl regular expressions quick start |
68dc0745 | 540 | |
d420ca49 | 541 | =over 4 |
68dc0745 | 542 | |
4755096e | 543 | =item DESCRIPTION |
68dc0745 | 544 | |
4755096e | 545 | =item The Guide |
68dc0745 | 546 | |
d420ca49 | 547 | =over 4 |
68dc0745 | 548 | |
4755096e | 549 | =item Simple word matching |
68dc0745 | 550 | |
4755096e | 551 | =item Using character classes |
68dc0745 | 552 | |
4755096e | 553 | =item Matching this or that |
68dc0745 | 554 | |
4755096e | 555 | =item Grouping things and hierarchical matching |
68dc0745 | 556 | |
4755096e | 557 | =item Extracting matches |
68dc0745 | 558 | |
4755096e | 559 | =item Matching repetitions |
68dc0745 | 560 | |
4755096e | 561 | =item More matching |
68dc0745 | 562 | |
4755096e | 563 | =item Search and replace |
68dc0745 | 564 | |
4755096e | 565 | =item The split operator |
68dc0745 | 566 | |
567 | =back | |
568 | ||
4755096e | 569 | =item BUGS |
68dc0745 | 570 | |
4755096e | 571 | =item SEE ALSO |
68dc0745 | 572 | |
4755096e | 573 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 574 | |
d420ca49 | 575 | =over 4 |
68dc0745 | 576 | |
4755096e | 577 | =item Acknowledgments |
14218588 | 578 | |
68dc0745 | 579 | =back |
580 | ||
a45bd81d GS |
581 | =back |
582 | ||
c2e66d9e | 583 | =head2 perlpod - plain old documentation |
68dc0745 | 584 | |
d420ca49 | 585 | =over 4 |
a45bd81d | 586 | |
68dc0745 | 587 | =item DESCRIPTION |
588 | ||
d420ca49 | 589 | =over 4 |
68dc0745 | 590 | |
c2e66d9e | 591 | =item Verbatim Paragraph |
68dc0745 | 592 | |
c2e66d9e | 593 | =item Command Paragraph |
68dc0745 | 594 | |
c2e66d9e | 595 | =item Ordinary Block of Text |
68dc0745 | 596 | |
c2e66d9e | 597 | =item The Intent |
68dc0745 | 598 | |
c2e66d9e | 599 | =item Embedding Pods in Perl Modules |
68dc0745 | 600 | |
c2e66d9e | 601 | =item Common Pod Pitfalls |
193fb0af | 602 | |
c2e66d9e | 603 | =back |
68dc0745 | 604 | |
c2e66d9e | 605 | =item SEE ALSO |
68dc0745 | 606 | |
c2e66d9e | 607 | =item AUTHOR |
68dc0745 | 608 | |
c2e66d9e | 609 | =back |
68dc0745 | 610 | |
c2e66d9e | 611 | =head2 perlstyle - Perl style guide |
68dc0745 | 612 | |
d420ca49 | 613 | =over 4 |
c2e66d9e GS |
614 | |
615 | =item DESCRIPTION | |
68dc0745 | 616 | |
4755096e | 617 | =back |
68dc0745 | 618 | |
c2e66d9e | 619 | =head2 perltrap - Perl traps for the unwary |
68dc0745 | 620 | |
d420ca49 | 621 | =over 4 |
68dc0745 | 622 | |
c2e66d9e | 623 | =item DESCRIPTION |
68dc0745 | 624 | |
d420ca49 | 625 | =over 4 |
68dc0745 | 626 | |
c2e66d9e | 627 | =item Awk Traps |
68dc0745 | 628 | |
c2e66d9e | 629 | =item C Traps |
4755096e | 630 | |
c2e66d9e | 631 | =item Sed Traps |
4755096e | 632 | |
c2e66d9e | 633 | =item Shell Traps |
4755096e | 634 | |
c2e66d9e | 635 | =item Perl Traps |
68dc0745 | 636 | |
c2e66d9e | 637 | =item Perl4 to Perl5 Traps |
68dc0745 | 638 | |
c2e66d9e GS |
639 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
640 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
641 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
642 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
643 | ||
644 | =item Discontinuance, Deprecation, and BugFix traps | |
645 | ||
646 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, | |
647 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
648 | Discontinuance, Deprecation, Discontinuance, Discontinuance | |
649 | ||
650 | =item Parsing Traps | |
651 | ||
652 | Parsing, Parsing, Parsing, Parsing | |
653 | ||
654 | =item Numerical Traps | |
655 | ||
656 | Numerical, Numerical, Numerical, Bitwise string ops | |
657 | ||
658 | =item General data type traps | |
659 | ||
660 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), | |
661 | (Constants), (Scalars), (Variable Suicide) | |
662 | ||
663 | =item Context Traps - scalar, list contexts | |
664 | ||
665 | (list context), (scalar context), (scalar context), (list, builtin) | |
666 | ||
667 | =item Precedence Traps | |
668 | ||
669 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, | |
670 | Precedence | |
671 | ||
672 | =item General Regular Expression Traps using s///, etc. | |
673 | ||
674 | Regular Expression, Regular Expression, Regular Expression, Regular | |
675 | Expression, Regular Expression, Regular Expression, Regular Expression, | |
676 | Regular Expression | |
677 | ||
678 | =item Subroutine, Signal, Sorting Traps | |
679 | ||
680 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle | |
681 | ||
682 | =item OS Traps | |
683 | ||
684 | (SysV), (SysV) | |
685 | ||
686 | =item Interpolation Traps | |
687 | ||
688 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, | |
689 | Interpolation, Interpolation, Interpolation, Interpolation | |
690 | ||
691 | =item DBM Traps | |
692 | ||
693 | DBM, DBM | |
694 | ||
695 | =item Unclassified Traps | |
696 | ||
697 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
698 | LIMIT specified | |
68dc0745 | 699 | |
4755096e | 700 | =back |
68dc0745 | 701 | |
c2e66d9e | 702 | =back |
14218588 | 703 | |
c2e66d9e | 704 | =head2 perlrun - how to execute the Perl interpreter |
68dc0745 | 705 | |
d420ca49 | 706 | =over 4 |
c2e66d9e GS |
707 | |
708 | =item SYNOPSIS | |
709 | ||
710 | =item DESCRIPTION | |
68dc0745 | 711 | |
d420ca49 | 712 | =over 4 |
68dc0745 | 713 | |
c2e66d9e GS |
714 | =item #! and quoting on non-Unix systems |
715 | ||
716 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS | |
717 | ||
718 | =item Location of Perl | |
719 | ||
720 | =item Command Switches | |
721 | ||
91e74348 | 722 | B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, |
c2e66d9e GS |
723 | B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, |
724 | B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>], | |
725 | B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
726 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, | |
727 | B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>, | |
728 | B<-x> I<directory> | |
68dc0745 | 729 | |
4755096e | 730 | =back |
68dc0745 | 731 | |
c2e66d9e GS |
732 | =item ENVIRONMENT |
733 | ||
734 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL | |
735 | (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL, | |
736 | PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port) | |
737 | ||
738 | =back | |
739 | ||
740 | =head2 perldiag - various Perl diagnostics | |
741 | ||
d420ca49 | 742 | =over 4 |
c2e66d9e GS |
743 | |
744 | =item DESCRIPTION | |
745 | ||
4755096e | 746 | =back |
68dc0745 | 747 | |
4755096e | 748 | =head2 perllexwarn - Perl Lexical Warnings |
68dc0745 | 749 | |
d420ca49 | 750 | =over 4 |
68dc0745 | 751 | |
4755096e | 752 | =item DESCRIPTION |
68dc0745 | 753 | |
d420ca49 | 754 | =over 4 |
68dc0745 | 755 | |
4755096e | 756 | =item Default Warnings and Optional Warnings |
14218588 | 757 | |
4755096e | 758 | =item What's wrong with B<-w> and C<$^W> |
68dc0745 | 759 | |
4755096e | 760 | =item Controlling Warnings from the Command Line |
68dc0745 | 761 | |
4755096e | 762 | B<-w>, B<-W>, B<-X> |
a45bd81d | 763 | |
4755096e | 764 | =item Backward Compatibility |
68dc0745 | 765 | |
4755096e | 766 | =item Category Hierarchy |
a45bd81d | 767 | |
4755096e | 768 | =item Fatal Warnings |
68dc0745 | 769 | |
4755096e | 770 | =item Reporting Warnings from a Module |
68dc0745 | 771 | |
4755096e | 772 | =back |
68dc0745 | 773 | |
4755096e | 774 | =item TODO |
68dc0745 | 775 | |
4755096e | 776 | =item SEE ALSO |
68dc0745 | 777 | |
4755096e | 778 | =item AUTHOR |
68dc0745 | 779 | |
4755096e | 780 | =back |
68dc0745 | 781 | |
10862624 RF |
782 | =head2 perldebtut - Perl debugging tutorial |
783 | ||
d420ca49 | 784 | =over 4 |
10862624 RF |
785 | |
786 | =item DESCRIPTION | |
787 | ||
788 | =item use strict | |
789 | ||
d396a558 JH |
790 | =item Looking at data and -w and w |
791 | ||
792 | =item help | |
10862624 RF |
793 | |
794 | =item Stepping through code | |
795 | ||
796 | =item Placeholder for a, w, t, T | |
797 | ||
d396a558 | 798 | =item REGULAR EXPRESSIONS |
10862624 | 799 | |
d396a558 | 800 | =item OUTPUT TIPS |
10862624 RF |
801 | |
802 | =item CGI | |
803 | ||
804 | =item GUIs | |
805 | ||
d396a558 | 806 | =item SUMMARY |
10862624 RF |
807 | |
808 | =item SEE ALSO | |
809 | ||
810 | =item AUTHOR | |
811 | ||
812 | =item CONTRIBUTORS | |
813 | ||
814 | =back | |
815 | ||
4755096e | 816 | =head2 perldebug - Perl debugging |
68dc0745 | 817 | |
d420ca49 | 818 | =over 4 |
68dc0745 | 819 | |
4755096e | 820 | =item DESCRIPTION |
68dc0745 | 821 | |
4755096e | 822 | =item The Perl Debugger |
68dc0745 | 823 | |
d420ca49 | 824 | =over 4 |
68dc0745 | 825 | |
4755096e | 826 | =item Debugger Commands |
68dc0745 | 827 | |
4755096e GS |
828 | h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n |
829 | [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname, | |
830 | -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr, | |
831 | b [line] [condition], b subname [condition], b postpone subname | |
832 | [condition], b load filename, b compile subname, d [line], D, a [line] | |
833 | command, a [line], A, W expr, W, O booloption .., O anyoption? .., O | |
834 | option=value .., < ?, < [ command ], << command, > ?, > command, >> | |
835 | command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !! | |
836 | cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage] | |
68dc0745 | 837 | |
4755096e | 838 | =item Configurable Options |
68dc0745 | 839 | |
4755096e GS |
840 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, |
841 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
a6fb92f1 JH |
842 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>, |
843 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
844 | C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, | |
845 | C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop> | |
68dc0745 | 846 | |
4755096e | 847 | =item Debugger input/output |
68dc0745 | 848 | |
4755096e GS |
849 | Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame |
850 | listing | |
68dc0745 | 851 | |
4755096e | 852 | =item Debugging compile-time statements |
68dc0745 | 853 | |
4755096e | 854 | =item Debugger Customization |
68dc0745 | 855 | |
4755096e | 856 | =item Readline Support |
68dc0745 | 857 | |
4755096e | 858 | =item Editor Support for Debugging |
68dc0745 | 859 | |
4755096e | 860 | =item The Perl Profiler |
68dc0745 | 861 | |
4755096e | 862 | =back |
68dc0745 | 863 | |
4755096e | 864 | =item Debugging regular expressions |
68dc0745 | 865 | |
4755096e | 866 | =item Debugging memory usage |
14218588 | 867 | |
4755096e | 868 | =item SEE ALSO |
68dc0745 | 869 | |
4755096e | 870 | =item BUGS |
68dc0745 | 871 | |
a45bd81d GS |
872 | =back |
873 | ||
c2e66d9e | 874 | =head2 perlvar - Perl predefined variables |
68dc0745 | 875 | |
d420ca49 | 876 | =over 4 |
a45bd81d | 877 | |
68dc0745 | 878 | =item DESCRIPTION |
879 | ||
d420ca49 | 880 | =over 4 |
68dc0745 | 881 | |
c2e66d9e | 882 | =item Predefined Names |
68dc0745 | 883 | |
640374d0 | 884 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
354a27bf | 885 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, |
c2e66d9e GS |
886 | input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, |
887 | input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, | |
888 | autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE | |
889 | EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE | |
890 | EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", | |
891 | $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE | |
892 | EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR, | |
893 | $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR, | |
894 | $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, @-, C<$`> is the same as | |
895 | C<substr($var, 0, $-[0])>, C<$&> is the same as C<substr($var, $-[0], $+[0] | |
896 | - $-[0])>, C<$'> is the same as C<substr($var, $+[0])>, C<$1> is the same | |
897 | as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> is the same as | |
898 | C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as C<substr $var, | |
899 | $-[3], $+[3] - $-[3])>, format_name HANDLE EXPR, $FORMAT_NAME, $~, | |
900 | format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^, | |
901 | format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS, | |
902 | $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, | |
903 | $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, | |
904 | $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, | |
905 | $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(, | |
906 | $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, | |
354a27bf | 907 | $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, |
c2e66d9e GS |
908 | $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, |
909 | 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, | |
910 | $BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, | |
640374d0 JH |
911 | ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @F, @INC, @_, |
912 | %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} | |
68dc0745 | 913 | |
c2e66d9e | 914 | =item Error Indicators |
68dc0745 | 915 | |
c2e66d9e | 916 | =item Technical Note on the Syntax of Variable Names |
4755096e | 917 | |
c2e66d9e GS |
918 | =back |
919 | ||
920 | =item BUGS | |
4755096e GS |
921 | |
922 | =back | |
923 | ||
c2e66d9e | 924 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
4755096e | 925 | |
d420ca49 | 926 | =over 4 |
c2e66d9e GS |
927 | |
928 | =item DESCRIPTION | |
929 | ||
4d4e713d JH |
930 | =over 4 |
931 | ||
c2e66d9e GS |
932 | =item Declaration and Access of Arrays of Arrays |
933 | ||
934 | =item Growing Your Own | |
935 | ||
936 | =item Access and Printing | |
937 | ||
938 | =item Slices | |
939 | ||
4d4e713d JH |
940 | =back |
941 | ||
c2e66d9e GS |
942 | =item SEE ALSO |
943 | ||
944 | =item AUTHOR | |
4755096e GS |
945 | |
946 | =back | |
947 | ||
c2e66d9e | 948 | =head2 perlopentut - tutorial on opening things in Perl |
4755096e | 949 | |
d420ca49 | 950 | =over 4 |
4755096e GS |
951 | |
952 | =item DESCRIPTION | |
953 | ||
c2e66d9e GS |
954 | =item Open E<agrave> la shell |
955 | ||
d420ca49 | 956 | =over 4 |
4755096e | 957 | |
c2e66d9e | 958 | =item Simple Opens |
4755096e | 959 | |
c2e66d9e | 960 | =item Pipe Opens |
4755096e | 961 | |
c2e66d9e | 962 | =item The Minus File |
4755096e | 963 | |
c2e66d9e | 964 | =item Mixing Reads and Writes |
4755096e GS |
965 | |
966 | =item Filters | |
967 | ||
968 | =back | |
969 | ||
970 | =item Open E<agrave> la C | |
971 | ||
d420ca49 | 972 | =over 4 |
4755096e GS |
973 | |
974 | =item Permissions E<agrave> la mode | |
975 | ||
976 | =back | |
977 | ||
978 | =item Obscure Open Tricks | |
979 | ||
d420ca49 | 980 | =over 4 |
4755096e GS |
981 | |
982 | =item Re-Opening Files (dups) | |
983 | ||
984 | =item Dispelling the Dweomer | |
985 | ||
986 | =item Paths as Opens | |
987 | ||
988 | =item Single Argument Open | |
989 | ||
990 | =item Playing with STDIN and STDOUT | |
991 | ||
992 | =back | |
993 | ||
994 | =item Other I/O Issues | |
995 | ||
d420ca49 | 996 | =over 4 |
4755096e GS |
997 | |
998 | =item Opening Non-File Files | |
999 | ||
1000 | =item Binary Files | |
1001 | ||
1002 | =item File Locking | |
1003 | ||
1004 | =back | |
1005 | ||
1006 | =item SEE ALSO | |
1007 | ||
1008 | =item AUTHOR and COPYRIGHT | |
1009 | ||
1010 | =item HISTORY | |
1011 | ||
1012 | =back | |
1013 | ||
c2e66d9e | 1014 | =head2 perlretut - Perl regular expressions tutorial |
4755096e | 1015 | |
d420ca49 | 1016 | =over 4 |
4755096e GS |
1017 | |
1018 | =item DESCRIPTION | |
1019 | ||
c2e66d9e | 1020 | =item Part 1: The basics |
4755096e | 1021 | |
d420ca49 | 1022 | =over 4 |
4755096e | 1023 | |
c2e66d9e | 1024 | =item Simple word matching |
4755096e | 1025 | |
c2e66d9e | 1026 | =item Using character classes |
4755096e | 1027 | |
c2e66d9e | 1028 | =item Matching this or that |
4755096e | 1029 | |
c2e66d9e | 1030 | =item Grouping things and hierarchical matching |
4755096e | 1031 | |
c2e66d9e | 1032 | =item Extracting matches |
4755096e | 1033 | |
c2e66d9e | 1034 | =item Matching repetitions |
4755096e | 1035 | |
c2e66d9e | 1036 | =item Building a regexp |
4755096e | 1037 | |
c2e66d9e | 1038 | =item Using regular expressions in Perl |
4755096e | 1039 | |
c2e66d9e | 1040 | =back |
4755096e | 1041 | |
c2e66d9e | 1042 | =item Part 2: Power tools |
4755096e | 1043 | |
d420ca49 | 1044 | =over 4 |
4755096e | 1045 | |
c2e66d9e | 1046 | =item More on characters, strings, and character classes |
4755096e | 1047 | |
c2e66d9e | 1048 | =item Compiling and saving regular expressions |
4755096e | 1049 | |
c2e66d9e | 1050 | =item Embedding comments and modifiers in a regular expression |
4755096e | 1051 | |
c2e66d9e | 1052 | =item Non-capturing groupings |
4755096e | 1053 | |
c2e66d9e | 1054 | =item Looking ahead and looking behind |
4755096e | 1055 | |
c2e66d9e | 1056 | =item Using independent subexpressions to prevent backtracking |
4755096e | 1057 | |
c2e66d9e | 1058 | =item Conditional expressions |
4755096e | 1059 | |
c2e66d9e | 1060 | =item A bit of magic: executing Perl code in a regular expression |
4755096e | 1061 | |
c2e66d9e | 1062 | =item Pragmas and debugging |
4755096e GS |
1063 | |
1064 | =back | |
1065 | ||
c2e66d9e | 1066 | =item BUGS |
4755096e | 1067 | |
c2e66d9e | 1068 | =item SEE ALSO |
4755096e | 1069 | |
c2e66d9e | 1070 | =item AUTHOR AND COPYRIGHT |
4755096e | 1071 | |
d420ca49 | 1072 | =over 4 |
4755096e | 1073 | |
c2e66d9e | 1074 | =item Acknowledgments |
4755096e GS |
1075 | |
1076 | =back | |
1077 | ||
4755096e GS |
1078 | =back |
1079 | ||
c2e66d9e | 1080 | =head2 perlre - Perl regular expressions |
4755096e | 1081 | |
d420ca49 | 1082 | =over 4 |
4755096e GS |
1083 | |
1084 | =item DESCRIPTION | |
1085 | ||
c2e66d9e | 1086 | i, m, s, x |
4755096e | 1087 | |
d420ca49 | 1088 | =over 4 |
4755096e | 1089 | |
c2e66d9e | 1090 | =item Regular Expressions |
4755096e | 1091 | |
c2e66d9e | 1092 | cntrl, graph, print, punct, xdigit |
4755096e | 1093 | |
c2e66d9e | 1094 | =item Extended Patterns |
4755096e | 1095 | |
c2e66d9e GS |
1096 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, |
1097 | C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ | |
1098 | code })>, C<(??{ code })>, C<< (?>pattern) >>, | |
1099 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
4755096e | 1100 | |
c2e66d9e | 1101 | =item Backtracking |
4755096e | 1102 | |
c2e66d9e | 1103 | =item Version 8 Regular Expressions |
4755096e | 1104 | |
c2e66d9e | 1105 | =item Warning on \1 vs $1 |
4755096e | 1106 | |
c2e66d9e GS |
1107 | =item Repeated patterns matching zero-length substring |
1108 | ||
1109 | =item Combining pieces together | |
1110 | ||
1111 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, | |
1112 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
1113 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
1114 | C<(?(condition)yes-pattern|no-pattern)> | |
1115 | ||
1116 | =item Creating custom RE engines | |
4755096e GS |
1117 | |
1118 | =back | |
1119 | ||
c2e66d9e | 1120 | =item BUGS |
4755096e | 1121 | |
c2e66d9e | 1122 | =item SEE ALSO |
4755096e | 1123 | |
c2e66d9e GS |
1124 | =back |
1125 | ||
d396a558 JH |
1126 | =head2 perlref - Perl references and nested data structures |
1127 | ||
d420ca49 | 1128 | =over 4 |
d396a558 JH |
1129 | |
1130 | =item NOTE | |
1131 | ||
1132 | =item DESCRIPTION | |
1133 | ||
d420ca49 | 1134 | =over 4 |
d396a558 JH |
1135 | |
1136 | =item Making References | |
1137 | ||
1138 | =item Using References | |
1139 | ||
1140 | =item Symbolic references | |
1141 | ||
1142 | =item Not-so-symbolic references | |
1143 | ||
1144 | =item Pseudo-hashes: Using an array as a hash | |
1145 | ||
1146 | =item Function Templates | |
1147 | ||
1148 | =back | |
1149 | ||
1150 | =item WARNING | |
1151 | ||
1152 | =item SEE ALSO | |
1153 | ||
1154 | =back | |
1155 | ||
c2e66d9e | 1156 | =head2 perlform - Perl formats |
4755096e | 1157 | |
d420ca49 | 1158 | =over 4 |
4755096e | 1159 | |
c2e66d9e | 1160 | =item DESCRIPTION |
4755096e | 1161 | |
d420ca49 | 1162 | =over 4 |
4755096e | 1163 | |
c2e66d9e | 1164 | =item Format Variables |
4755096e | 1165 | |
c2e66d9e | 1166 | =back |
4755096e | 1167 | |
c2e66d9e | 1168 | =item NOTES |
4755096e | 1169 | |
d420ca49 | 1170 | =over 4 |
c2e66d9e GS |
1171 | |
1172 | =item Footers | |
1173 | ||
1174 | =item Accessing Formatting Internals | |
4755096e GS |
1175 | |
1176 | =back | |
1177 | ||
c2e66d9e | 1178 | =item WARNINGS |
4755096e GS |
1179 | |
1180 | =back | |
1181 | ||
d396a558 | 1182 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
4755096e | 1183 | |
d420ca49 | 1184 | =over 4 |
4755096e GS |
1185 | |
1186 | =item DESCRIPTION | |
1187 | ||
d420ca49 | 1188 | =over 4 |
c2e66d9e | 1189 | |
d396a558 JH |
1190 | =item If we could talk to the animals... |
1191 | ||
1192 | =item Introducing the method invocation arrow | |
1193 | ||
1194 | =item Invoking a barnyard | |
1195 | ||
1196 | =item The extra parameter of method invocation | |
1197 | ||
1198 | =item Calling a second method to simplify things | |
1199 | ||
1200 | =item Inheriting the windpipes | |
1201 | ||
1202 | =item A few notes about @ISA | |
1203 | ||
1204 | =item Overriding the methods | |
1205 | ||
1206 | =item Starting the search from a different place | |
1207 | ||
1208 | =item The SUPER way of doing things | |
1209 | ||
1210 | =item Where we're at so far... | |
1211 | ||
1212 | =item A horse is a horse, of course of course -- or is it? | |
1213 | ||
1214 | =item Invoking an instance method | |
1215 | ||
1216 | =item Accessing the instance data | |
1217 | ||
1218 | =item How to build a horse | |
1219 | ||
1220 | =item Inheriting the constructor | |
1221 | ||
1222 | =item Making a method work with either classes or instances | |
1223 | ||
1224 | =item Adding parameters to a method | |
1225 | ||
1226 | =item More interesting instances | |
1227 | ||
1228 | =item A horse of a different color | |
1229 | ||
1230 | =item Summary | |
1231 | ||
1232 | =back | |
1233 | ||
1234 | =item SEE ALSO | |
1235 | ||
1236 | =item COPYRIGHT | |
1237 | ||
1238 | =back | |
1239 | ||
1240 | =head2 perltoot - Tom's object-oriented tutorial for perl | |
c2e66d9e | 1241 | |
d420ca49 | 1242 | =over 4 |
4755096e | 1243 | |
d396a558 | 1244 | =item DESCRIPTION |
4755096e | 1245 | |
d396a558 | 1246 | =item Creating a Class |
4755096e | 1247 | |
d420ca49 | 1248 | =over 4 |
4755096e | 1249 | |
d396a558 | 1250 | =item Object Representation |
4755096e | 1251 | |
d396a558 | 1252 | =item Class Interface |
4755096e | 1253 | |
d396a558 | 1254 | =item Constructors and Instance Methods |
c2e66d9e | 1255 | |
d396a558 | 1256 | =item Planning for the Future: Better Constructors |
c2e66d9e | 1257 | |
d396a558 | 1258 | =item Destructors |
c2e66d9e | 1259 | |
d396a558 | 1260 | =item Other Object Methods |
4755096e GS |
1261 | |
1262 | =back | |
1263 | ||
d396a558 | 1264 | =item Class Data |
4755096e | 1265 | |
d420ca49 | 1266 | =over 4 |
4755096e | 1267 | |
d396a558 | 1268 | =item Accessing Class Data |
4755096e | 1269 | |
d396a558 | 1270 | =item Debugging Methods |
4755096e | 1271 | |
d396a558 | 1272 | =item Class Destructors |
4755096e | 1273 | |
d396a558 | 1274 | =item Documenting the Interface |
4755096e | 1275 | |
d396a558 | 1276 | =back |
4755096e | 1277 | |
d396a558 JH |
1278 | =item Aggregation |
1279 | ||
1280 | =item Inheritance | |
1281 | ||
d420ca49 | 1282 | =over 4 |
d396a558 JH |
1283 | |
1284 | =item Overridden Methods | |
1285 | ||
1286 | =item Multiple Inheritance | |
1287 | ||
1288 | =item UNIVERSAL: The Root of All Objects | |
4755096e | 1289 | |
c2e66d9e | 1290 | =back |
4755096e | 1291 | |
d396a558 | 1292 | =item Alternate Object Representations |
4755096e | 1293 | |
d420ca49 | 1294 | =over 4 |
4755096e | 1295 | |
d396a558 | 1296 | =item Arrays as Objects |
4755096e | 1297 | |
d396a558 JH |
1298 | =item Closures as Objects |
1299 | ||
1300 | =back | |
1301 | ||
1302 | =item AUTOLOAD: Proxy Methods | |
1303 | ||
d420ca49 | 1304 | =over 4 |
d396a558 JH |
1305 | |
1306 | =item Autoloaded Data Methods | |
1307 | ||
1308 | =item Inherited Autoloaded Data Methods | |
1309 | ||
1310 | =back | |
1311 | ||
1312 | =item Metaclassical Tools | |
1313 | ||
d420ca49 | 1314 | =over 4 |
d396a558 JH |
1315 | |
1316 | =item Class::Struct | |
1317 | ||
1318 | =item Data Members as Variables | |
4755096e | 1319 | |
d420ca49 AD |
1320 | =back |
1321 | ||
c2e66d9e | 1322 | =item NOTES |
4755096e | 1323 | |
d420ca49 AD |
1324 | =over 4 |
1325 | ||
d396a558 JH |
1326 | =item Object Terminology |
1327 | ||
1328 | =back | |
1329 | ||
1330 | =item SEE ALSO | |
1331 | ||
1332 | =item AUTHOR AND COPYRIGHT | |
1333 | ||
1334 | =item COPYRIGHT | |
1335 | ||
d420ca49 | 1336 | =over 4 |
c2e66d9e | 1337 | |
d396a558 | 1338 | =item Acknowledgments |
c2e66d9e | 1339 | |
d396a558 | 1340 | =back |
c2e66d9e | 1341 | |
d396a558 | 1342 | =back |
c2e66d9e | 1343 | |
d396a558 | 1344 | =head2 perltootc - Tom's OO Tutorial for Class Data in Perl |
c2e66d9e | 1345 | |
d420ca49 | 1346 | =over 4 |
c2e66d9e | 1347 | |
d396a558 | 1348 | =item DESCRIPTION |
c2e66d9e | 1349 | |
dc5c060f JH |
1350 | =item Class Data in a Can |
1351 | ||
d396a558 JH |
1352 | =item Class Data as Package Variables |
1353 | ||
d420ca49 | 1354 | =over 4 |
d396a558 JH |
1355 | |
1356 | =item Putting All Your Eggs in One Basket | |
1357 | ||
1358 | =item Inheritance Concerns | |
1359 | ||
1360 | =item The Eponymous Meta-Object | |
1361 | ||
1362 | =item Indirect References to Class Data | |
1363 | ||
1364 | =item Monadic Classes | |
1365 | ||
1366 | =item Translucent Attributes | |
4755096e GS |
1367 | |
1368 | =back | |
1369 | ||
d396a558 | 1370 | =item Class Data as Lexical Variables |
4755096e | 1371 | |
d420ca49 | 1372 | =over 4 |
4755096e | 1373 | |
d396a558 JH |
1374 | =item Privacy and Responsibility |
1375 | ||
1376 | =item File-Scoped Lexicals | |
1377 | ||
1378 | =item More Inheritance Concerns | |
1379 | ||
1380 | =item Locking the Door and Throwing Away the Key | |
1381 | ||
1382 | =item Translucency Revisited | |
4755096e | 1383 | |
c2e66d9e | 1384 | =back |
4755096e | 1385 | |
d396a558 JH |
1386 | =item NOTES |
1387 | ||
c2e66d9e | 1388 | =item SEE ALSO |
4755096e | 1389 | |
d396a558 JH |
1390 | =item AUTHOR AND COPYRIGHT |
1391 | ||
1392 | =item ACKNOWLEDGEMENTS | |
1393 | ||
c2e66d9e | 1394 | =item HISTORY |
4755096e | 1395 | |
c2e66d9e | 1396 | =back |
4755096e | 1397 | |
d396a558 | 1398 | =head2 perlobj - Perl objects |
4755096e | 1399 | |
d420ca49 | 1400 | =over 4 |
4755096e | 1401 | |
c2e66d9e | 1402 | =item DESCRIPTION |
4755096e | 1403 | |
d420ca49 | 1404 | =over 4 |
4755096e | 1405 | |
d396a558 | 1406 | =item An Object is Simply a Reference |
4755096e | 1407 | |
d396a558 | 1408 | =item A Class is Simply a Package |
4755096e | 1409 | |
d396a558 | 1410 | =item A Method is Simply a Subroutine |
4755096e | 1411 | |
d396a558 | 1412 | =item Method Invocation |
4755096e | 1413 | |
bd28ded5 | 1414 | =item Indirect Object Syntax |
d396a558 JH |
1415 | |
1416 | =item Default UNIVERSAL methods | |
1417 | ||
1418 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
1419 | ||
1420 | =item Destructors | |
1421 | ||
1422 | =item Summary | |
1423 | ||
1424 | =item Two-Phased Garbage Collection | |
4755096e | 1425 | |
c2e66d9e | 1426 | =back |
4755096e | 1427 | |
d396a558 JH |
1428 | =item SEE ALSO |
1429 | ||
1430 | =back | |
1431 | ||
1432 | =head2 perlbot - Bag'o Object Tricks (the BOT) | |
1433 | ||
d420ca49 | 1434 | =over 4 |
d396a558 JH |
1435 | |
1436 | =item DESCRIPTION | |
1437 | ||
1438 | =item OO SCALING TIPS | |
1439 | ||
1440 | =item INSTANCE VARIABLES | |
1441 | ||
1442 | =item SCALAR INSTANCE VARIABLES | |
1443 | ||
1444 | =item INSTANCE VARIABLE INHERITANCE | |
1445 | ||
1446 | =item OBJECT RELATIONSHIPS | |
1447 | ||
1448 | =item OVERRIDING SUPERCLASS METHODS | |
1449 | ||
1450 | =item USING RELATIONSHIP WITH SDBM | |
1451 | ||
1452 | =item THINKING OF CODE REUSE | |
1453 | ||
1454 | =item CLASS CONTEXT AND THE OBJECT | |
1455 | ||
1456 | =item INHERITING A CONSTRUCTOR | |
1457 | ||
1458 | =item DELEGATION | |
1459 | ||
1460 | =back | |
1461 | ||
1462 | =head2 perltie - how to hide an object class in a simple variable | |
1463 | ||
d420ca49 | 1464 | =over 4 |
d396a558 JH |
1465 | |
1466 | =item SYNOPSIS | |
1467 | ||
1468 | =item DESCRIPTION | |
1469 | ||
d420ca49 | 1470 | =over 4 |
d396a558 JH |
1471 | |
1472 | =item Tying Scalars | |
1473 | ||
93d73c42 JH |
1474 | TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, |
1475 | DESTROY this | |
d396a558 JH |
1476 | |
1477 | =item Tying Arrays | |
1478 | ||
1479 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, | |
165c0277 JH |
1480 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
1481 | key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this, | |
1482 | UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY | |
1483 | this | |
d396a558 JH |
1484 | |
1485 | =item Tying Hashes | |
1486 | ||
1487 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE | |
1488 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
93d73c42 | 1489 | this, NEXTKEY this, lastkey, UNTIE this, DESTROY this |
d396a558 JH |
1490 | |
1491 | =item Tying FileHandles | |
1492 | ||
1493 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, | |
93d73c42 JH |
1494 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, |
1495 | DESTROY this | |
d396a558 | 1496 | |
9fa7f388 JH |
1497 | =item UNTIE this |
1498 | ||
d396a558 JH |
1499 | =item The C<untie> Gotcha |
1500 | ||
1501 | =back | |
4755096e | 1502 | |
c2e66d9e | 1503 | =item SEE ALSO |
4755096e | 1504 | |
d396a558 JH |
1505 | =item BUGS |
1506 | ||
1507 | =item AUTHOR | |
1508 | ||
c2e66d9e | 1509 | =back |
4755096e | 1510 | |
c2e66d9e GS |
1511 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
1512 | safe subprocesses, sockets, and semaphores) | |
4755096e | 1513 | |
d420ca49 | 1514 | =over 4 |
4755096e | 1515 | |
c2e66d9e | 1516 | =item DESCRIPTION |
4755096e | 1517 | |
c2e66d9e | 1518 | =item Signals |
4755096e | 1519 | |
c2e66d9e | 1520 | =item Named Pipes |
4755096e | 1521 | |
d420ca49 | 1522 | =over 4 |
4755096e | 1523 | |
c2e66d9e | 1524 | =item WARNING |
4755096e | 1525 | |
c2e66d9e | 1526 | =back |
4755096e | 1527 | |
c2e66d9e | 1528 | =item Using open() for IPC |
4755096e | 1529 | |
d420ca49 | 1530 | =over 4 |
4755096e | 1531 | |
c2e66d9e | 1532 | =item Filehandles |
4755096e | 1533 | |
c2e66d9e | 1534 | =item Background Processes |
4755096e | 1535 | |
c2e66d9e | 1536 | =item Complete Dissociation of Child from Parent |
4755096e | 1537 | |
c2e66d9e | 1538 | =item Safe Pipe Opens |
4755096e | 1539 | |
c2e66d9e | 1540 | =item Bidirectional Communication with Another Process |
4755096e | 1541 | |
c2e66d9e | 1542 | =item Bidirectional Communication with Yourself |
4755096e GS |
1543 | |
1544 | =back | |
1545 | ||
c2e66d9e | 1546 | =item Sockets: Client/Server Communication |
4755096e | 1547 | |
d420ca49 | 1548 | =over 4 |
4755096e | 1549 | |
c2e66d9e | 1550 | =item Internet Line Terminators |
4755096e | 1551 | |
c2e66d9e | 1552 | =item Internet TCP Clients and Servers |
4755096e | 1553 | |
c2e66d9e GS |
1554 | =item Unix-Domain TCP Clients and Servers |
1555 | ||
1556 | =back | |
1557 | ||
1558 | =item TCP Clients with IO::Socket | |
4755096e | 1559 | |
d420ca49 | 1560 | =over 4 |
4755096e | 1561 | |
c2e66d9e | 1562 | =item A Simple Client |
4755096e | 1563 | |
c2e66d9e | 1564 | C<Proto>, C<PeerAddr>, C<PeerPort> |
4755096e | 1565 | |
c2e66d9e | 1566 | =item A Webget Client |
4755096e | 1567 | |
c2e66d9e | 1568 | =item Interactive Client with IO::Socket |
4755096e | 1569 | |
c2e66d9e | 1570 | =back |
4755096e | 1571 | |
c2e66d9e | 1572 | =item TCP Servers with IO::Socket |
4755096e | 1573 | |
c2e66d9e | 1574 | Proto, LocalPort, Listen, Reuse |
4755096e | 1575 | |
c2e66d9e | 1576 | =item UDP: Message Passing |
4755096e | 1577 | |
c2e66d9e | 1578 | =item SysV IPC |
4755096e | 1579 | |
c2e66d9e | 1580 | =item NOTES |
4755096e | 1581 | |
c2e66d9e | 1582 | =item BUGS |
4755096e | 1583 | |
c2e66d9e | 1584 | =item AUTHOR |
4755096e | 1585 | |
c2e66d9e | 1586 | =item SEE ALSO |
4755096e GS |
1587 | |
1588 | =back | |
1589 | ||
bd28ded5 | 1590 | =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) |
4755096e | 1591 | |
d420ca49 | 1592 | =over 4 |
4755096e | 1593 | |
c2e66d9e GS |
1594 | =item SYNOPSIS |
1595 | ||
1596 | =item DESCRIPTION | |
4755096e | 1597 | |
d420ca49 | 1598 | =over 4 |
4755096e | 1599 | |
c2e66d9e | 1600 | =item Behavior of other Perl features in forked pseudo-processes |
4755096e | 1601 | |
c2e66d9e GS |
1602 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
1603 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
1604 | files, directories and network sockets | |
4755096e | 1605 | |
c2e66d9e | 1606 | =item Resource limits |
4755096e | 1607 | |
c2e66d9e | 1608 | =item Killing the parent process |
4755096e | 1609 | |
c2e66d9e | 1610 | =item Lifetime of the parent process and pseudo-processes |
4755096e | 1611 | |
c2e66d9e | 1612 | =item CAVEATS AND LIMITATIONS |
4755096e | 1613 | |
c2e66d9e GS |
1614 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
1615 | Global state maintained by XSUBs, Interpreter embedded in larger | |
1616 | application, Thread-safety of extensions | |
4755096e | 1617 | |
c2e66d9e | 1618 | =back |
4755096e | 1619 | |
c2e66d9e GS |
1620 | =item BUGS |
1621 | ||
1622 | =item AUTHOR | |
1623 | ||
1624 | =item SEE ALSO | |
4755096e GS |
1625 | |
1626 | =back | |
1627 | ||
c2e66d9e | 1628 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
4755096e | 1629 | |
d420ca49 | 1630 | =over 4 |
4755096e | 1631 | |
c2e66d9e | 1632 | =item SYNOPSIS |
4755096e | 1633 | |
c2e66d9e | 1634 | =item DESCRIPTION |
4755096e | 1635 | |
c2e66d9e | 1636 | =item Storing numbers |
4755096e | 1637 | |
c2e66d9e | 1638 | =item Numeric operators and numeric conversions |
4755096e | 1639 | |
c2e66d9e | 1640 | =item Flavors of Perl numeric operations |
4755096e | 1641 | |
c2e66d9e GS |
1642 | Arithmetic operators except, C<no integer>, Arithmetic operators except, |
1643 | C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use | |
1644 | integer>, Operators which expect an integer, Operators which expect a | |
1645 | string | |
4755096e | 1646 | |
c2e66d9e | 1647 | =item AUTHOR |
4755096e | 1648 | |
c2e66d9e | 1649 | =item SEE ALSO |
4755096e GS |
1650 | |
1651 | =back | |
1652 | ||
c2e66d9e | 1653 | =head2 perlthrtut - tutorial on threads in Perl |
4755096e | 1654 | |
d420ca49 | 1655 | =over 4 |
4755096e GS |
1656 | |
1657 | =item DESCRIPTION | |
1658 | ||
c2e66d9e | 1659 | =item What Is A Thread Anyway? |
4755096e | 1660 | |
c2e66d9e | 1661 | =item Threaded Program Models |
4755096e | 1662 | |
d420ca49 | 1663 | =over 4 |
4755096e | 1664 | |
c2e66d9e | 1665 | =item Boss/Worker |
4755096e | 1666 | |
c2e66d9e | 1667 | =item Work Crew |
4755096e | 1668 | |
c2e66d9e | 1669 | =item Pipeline |
4755096e GS |
1670 | |
1671 | =back | |
1672 | ||
c2e66d9e | 1673 | =item Native threads |
4755096e | 1674 | |
c2e66d9e | 1675 | =item What kind of threads are perl threads? |
4755096e | 1676 | |
c2e66d9e | 1677 | =item Threadsafe Modules |
4755096e | 1678 | |
c2e66d9e | 1679 | =item Thread Basics |
4755096e | 1680 | |
d420ca49 | 1681 | =over 4 |
4755096e | 1682 | |
c2e66d9e | 1683 | =item Basic Thread Support |
4755096e | 1684 | |
c2e66d9e | 1685 | =item Creating Threads |
4755096e | 1686 | |
c2e66d9e | 1687 | =item Giving up control |
4755096e | 1688 | |
c2e66d9e | 1689 | =item Waiting For A Thread To Exit |
4755096e | 1690 | |
c2e66d9e | 1691 | =item Errors In Threads |
4755096e | 1692 | |
c2e66d9e | 1693 | =item Ignoring A Thread |
4755096e GS |
1694 | |
1695 | =back | |
1696 | ||
c2e66d9e | 1697 | =item Threads And Data |
4755096e | 1698 | |
d420ca49 | 1699 | =over 4 |
4755096e | 1700 | |
c2e66d9e | 1701 | =item Shared And Unshared Data |
4755096e | 1702 | |
c2e66d9e | 1703 | =item Thread Pitfall: Races |
4755096e | 1704 | |
c2e66d9e | 1705 | =item Controlling access: lock() |
4755096e | 1706 | |
c2e66d9e | 1707 | =item Thread Pitfall: Deadlocks |
4755096e | 1708 | |
c2e66d9e | 1709 | =item Queues: Passing Data Around |
4755096e | 1710 | |
c2e66d9e | 1711 | =back |
4755096e | 1712 | |
c2e66d9e | 1713 | =item Threads And Code |
4755096e | 1714 | |
d420ca49 | 1715 | =over 4 |
4755096e | 1716 | |
c2e66d9e | 1717 | =item Semaphores: Synchronizing Data Access |
4755096e | 1718 | |
c2e66d9e | 1719 | Basic semaphores, Advanced Semaphores |
4755096e | 1720 | |
c2e66d9e | 1721 | =item Attributes: Restricting Access To Subroutines |
4755096e | 1722 | |
c2e66d9e | 1723 | =item Subroutine Locks |
4755096e | 1724 | |
c2e66d9e | 1725 | =item Methods |
4755096e | 1726 | |
c2e66d9e | 1727 | =item Locking A Subroutine |
4755096e GS |
1728 | |
1729 | =back | |
1730 | ||
c2e66d9e | 1731 | =item General Thread Utility Routines |
4755096e | 1732 | |
d420ca49 | 1733 | =over 4 |
4755096e | 1734 | |
c2e66d9e | 1735 | =item What Thread Am I In? |
4755096e | 1736 | |
c2e66d9e | 1737 | =item Thread IDs |
4755096e | 1738 | |
c2e66d9e | 1739 | =item Are These Threads The Same? |
4755096e | 1740 | |
c2e66d9e | 1741 | =item What Threads Are Running? |
4755096e | 1742 | |
c2e66d9e | 1743 | =back |
4755096e | 1744 | |
c2e66d9e | 1745 | =item A Complete Example |
4755096e | 1746 | |
c2e66d9e | 1747 | =item Conclusion |
4755096e | 1748 | |
c2e66d9e | 1749 | =item Bibliography |
4755096e | 1750 | |
d420ca49 | 1751 | =over 4 |
4755096e | 1752 | |
c2e66d9e | 1753 | =item Introductory Texts |
4755096e | 1754 | |
c2e66d9e | 1755 | =item OS-Related References |
4755096e | 1756 | |
c2e66d9e | 1757 | =item Other References |
4755096e GS |
1758 | |
1759 | =back | |
1760 | ||
c2e66d9e | 1761 | =item Acknowledgements |
4755096e | 1762 | |
c2e66d9e | 1763 | =item AUTHOR |
4755096e | 1764 | |
c2e66d9e | 1765 | =item Copyrights |
4755096e | 1766 | |
c2e66d9e | 1767 | =back |
4755096e | 1768 | |
c2e66d9e | 1769 | =head2 perlport - Writing portable Perl |
4755096e | 1770 | |
d420ca49 | 1771 | =over 4 |
4755096e | 1772 | |
c2e66d9e | 1773 | =item DESCRIPTION |
4755096e | 1774 | |
c2e66d9e GS |
1775 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
1776 | portable | |
4755096e | 1777 | |
c2e66d9e | 1778 | =item ISSUES |
4755096e | 1779 | |
d420ca49 | 1780 | =over 4 |
4755096e | 1781 | |
c2e66d9e | 1782 | =item Newlines |
4755096e | 1783 | |
c2e66d9e | 1784 | =item Numbers endianness and Width |
4755096e | 1785 | |
c2e66d9e | 1786 | =item Files and Filesystems |
4755096e | 1787 | |
c2e66d9e | 1788 | =item System Interaction |
4755096e | 1789 | |
c2e66d9e | 1790 | =item Interprocess Communication (IPC) |
4755096e | 1791 | |
c2e66d9e | 1792 | =item External Subroutines (XS) |
4755096e | 1793 | |
c2e66d9e | 1794 | =item Standard Modules |
4755096e | 1795 | |
c2e66d9e | 1796 | =item Time and Date |
4755096e | 1797 | |
c2e66d9e | 1798 | =item Character sets and character encoding |
4755096e | 1799 | |
c2e66d9e | 1800 | =item Internationalisation |
4755096e | 1801 | |
c2e66d9e | 1802 | =item System Resources |
4755096e | 1803 | |
c2e66d9e | 1804 | =item Security |
4755096e | 1805 | |
c2e66d9e | 1806 | =item Style |
4755096e GS |
1807 | |
1808 | =back | |
1809 | ||
c2e66d9e | 1810 | =item CPAN Testers |
4755096e | 1811 | |
c2e66d9e GS |
1812 | Mailing list: cpan-testers@perl.org, Testing results: |
1813 | http://testers.cpan.org/ | |
4755096e | 1814 | |
c2e66d9e | 1815 | =item PLATFORMS |
4755096e | 1816 | |
d420ca49 | 1817 | =over 4 |
4755096e | 1818 | |
c2e66d9e | 1819 | =item Unix |
4755096e | 1820 | |
c2e66d9e | 1821 | =item DOS and Derivatives |
4755096e | 1822 | |
c2e66d9e | 1823 | =item S<Mac OS> |
4755096e | 1824 | |
c2e66d9e | 1825 | =item VMS |
4755096e | 1826 | |
c2e66d9e | 1827 | =item VOS |
4755096e | 1828 | |
c2e66d9e | 1829 | =item EBCDIC Platforms |
4755096e | 1830 | |
c2e66d9e | 1831 | =item Acorn RISC OS |
4755096e | 1832 | |
c2e66d9e | 1833 | =item Other perls |
4755096e GS |
1834 | |
1835 | =back | |
1836 | ||
c2e66d9e | 1837 | =item FUNCTION IMPLEMENTATIONS |
4755096e | 1838 | |
d420ca49 | 1839 | =over 4 |
4755096e | 1840 | |
c2e66d9e GS |
1841 | =item Alphabetical Listing of Perl Functions |
1842 | ||
1843 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode | |
1844 | FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt | |
1845 | PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec | |
1846 | LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, | |
1847 | getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, | |
1848 | getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr | |
1849 | ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, | |
1850 | getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, | |
1851 | setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, | |
1852 | setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, | |
1853 | endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, | |
1854 | ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, | |
1855 | lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, | |
1856 | msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, | |
1857 | open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, | |
1858 | select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget | |
1859 | KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, | |
1860 | setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt | |
1861 | SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, | |
80cbd5ad JH |
1862 | shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, |
1863 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat | |
1864 | EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
d396a558 JH |
1865 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate |
1866 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
1867 | wait, waitpid PID,FLAGS | |
4755096e | 1868 | |
d396a558 | 1869 | =back |
4755096e | 1870 | |
d396a558 | 1871 | =item CHANGES |
4755096e | 1872 | |
603b90a8 JH |
1873 | v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, |
1874 | v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 | |
1875 | May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February | |
1876 | 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September | |
1877 | 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, | |
1878 | v1.30, 03 August 1998, v1.23, 10 July 1998 | |
4755096e | 1879 | |
d396a558 | 1880 | =item Supported Platforms |
4755096e | 1881 | |
d396a558 | 1882 | =item SEE ALSO |
4755096e | 1883 | |
d396a558 | 1884 | =item AUTHORS / CONTRIBUTORS |
4755096e | 1885 | |
d396a558 | 1886 | =item VERSION |
4755096e GS |
1887 | |
1888 | =back | |
1889 | ||
d396a558 JH |
1890 | =head2 perllocale - Perl locale handling (internationalization and |
1891 | localization) | |
4755096e | 1892 | |
d420ca49 | 1893 | =over 4 |
4755096e | 1894 | |
d396a558 | 1895 | =item DESCRIPTION |
4755096e | 1896 | |
d396a558 JH |
1897 | =item PREPARING TO USE LOCALES |
1898 | ||
1899 | =item USING LOCALES | |
4755096e | 1900 | |
d420ca49 | 1901 | =over 4 |
4755096e | 1902 | |
d396a558 | 1903 | =item The use locale pragma |
4755096e | 1904 | |
d396a558 | 1905 | =item The setlocale function |
4755096e | 1906 | |
d396a558 | 1907 | =item Finding locales |
4755096e | 1908 | |
d396a558 | 1909 | =item LOCALE PROBLEMS |
4755096e | 1910 | |
d396a558 | 1911 | =item Temporarily fixing locale problems |
4755096e | 1912 | |
d396a558 | 1913 | =item Permanently fixing locale problems |
4755096e | 1914 | |
d396a558 | 1915 | =item Permanently fixing your system's locale configuration |
4755096e | 1916 | |
d396a558 | 1917 | =item Fixing system locale configuration |
4755096e | 1918 | |
d396a558 | 1919 | =item The localeconv function |
4755096e GS |
1920 | |
1921 | =back | |
1922 | ||
d396a558 | 1923 | =item LOCALE CATEGORIES |
4755096e | 1924 | |
d420ca49 | 1925 | =over 4 |
4755096e | 1926 | |
d396a558 | 1927 | =item Category LC_COLLATE: Collation |
4755096e | 1928 | |
d396a558 | 1929 | =item Category LC_CTYPE: Character Types |
4755096e | 1930 | |
d396a558 | 1931 | =item Category LC_NUMERIC: Numeric Formatting |
4755096e | 1932 | |
d396a558 | 1933 | =item Category LC_MONETARY: Formatting of monetary amounts |
4755096e | 1934 | |
d396a558 | 1935 | =item LC_TIME |
4755096e | 1936 | |
d396a558 | 1937 | =item Other categories |
4755096e | 1938 | |
d396a558 | 1939 | =back |
4755096e | 1940 | |
d396a558 | 1941 | =item SECURITY |
4755096e | 1942 | |
d396a558 | 1943 | =item ENVIRONMENT |
4755096e | 1944 | |
d396a558 JH |
1945 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
1946 | LC_NUMERIC, LC_TIME, LANG | |
4755096e | 1947 | |
d396a558 | 1948 | =item NOTES |
4755096e | 1949 | |
d420ca49 | 1950 | =over 4 |
4755096e | 1951 | |
d396a558 | 1952 | =item Backward compatibility |
4755096e | 1953 | |
d396a558 | 1954 | =item I18N:Collate obsolete |
4755096e | 1955 | |
d396a558 | 1956 | =item Sort speed and memory use impacts |
4755096e | 1957 | |
d396a558 | 1958 | =item write() and LC_NUMERIC |
4755096e | 1959 | |
d396a558 | 1960 | =item Freely available locale definitions |
4755096e | 1961 | |
d396a558 | 1962 | =item I18n and l10n |
4755096e | 1963 | |
d396a558 | 1964 | =item An imperfect standard |
4755096e GS |
1965 | |
1966 | =back | |
1967 | ||
d396a558 | 1968 | =item BUGS |
4755096e | 1969 | |
d420ca49 | 1970 | =over 4 |
4755096e | 1971 | |
d396a558 | 1972 | =item Broken systems |
4755096e GS |
1973 | |
1974 | =back | |
1975 | ||
1976 | =item SEE ALSO | |
1977 | ||
d396a558 | 1978 | =item HISTORY |
4755096e GS |
1979 | |
1980 | =back | |
1981 | ||
d396a558 | 1982 | =head2 perlunicode - Unicode support in Perl |
4755096e | 1983 | |
d420ca49 | 1984 | =over 4 |
4755096e GS |
1985 | |
1986 | =item DESCRIPTION | |
1987 | ||
d420ca49 | 1988 | =over 4 |
4755096e | 1989 | |
e42c74e1 | 1990 | =item Important Caveats |
4755096e | 1991 | |
d396a558 JH |
1992 | Input and Output Disciplines, Regular Expressions, C<use utf8> still needed |
1993 | to enable a few features | |
4755096e | 1994 | |
d396a558 | 1995 | =item Byte and Character semantics |
4755096e | 1996 | |
d396a558 | 1997 | =item Effects of character semantics |
4755096e | 1998 | |
afd1eb53 NIS |
1999 | =item Scripts |
2000 | ||
2001 | =item Blocks | |
2002 | ||
d396a558 | 2003 | =item Character encodings for input and output |
4755096e | 2004 | |
d396a558 JH |
2005 | =back |
2006 | ||
2007 | =item CAVEATS | |
2008 | ||
2009 | =item SEE ALSO | |
4755096e GS |
2010 | |
2011 | =back | |
2012 | ||
d396a558 | 2013 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms |
4755096e | 2014 | |
d420ca49 | 2015 | =over 4 |
4755096e | 2016 | |
d396a558 | 2017 | =item DESCRIPTION |
4755096e | 2018 | |
d396a558 | 2019 | =item COMMON CHARACTER CODE SETS |
4755096e | 2020 | |
d420ca49 | 2021 | =over 4 |
4755096e | 2022 | |
d396a558 | 2023 | =item ASCII |
4755096e | 2024 | |
d396a558 | 2025 | =item ISO 8859 |
4755096e | 2026 | |
d396a558 | 2027 | =item Latin 1 (ISO 8859-1) |
4755096e | 2028 | |
d396a558 | 2029 | =item EBCDIC |
4755096e | 2030 | |
d396a558 | 2031 | =item 13 variant characters |
4755096e | 2032 | |
d396a558 | 2033 | =item 0037 |
4755096e | 2034 | |
d396a558 | 2035 | =item 1047 |
4755096e | 2036 | |
d396a558 | 2037 | =item POSIX-BC |
4755096e | 2038 | |
41ca3a40 JH |
2039 | =item Unicode and UTF |
2040 | ||
4755096e GS |
2041 | =back |
2042 | ||
d396a558 | 2043 | =item SINGLE OCTET TABLES |
4755096e | 2044 | |
41ca3a40 | 2045 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 |
4755096e | 2046 | |
d396a558 | 2047 | =item IDENTIFYING CHARACTER CODE SETS |
4755096e | 2048 | |
d396a558 | 2049 | =item CONVERSIONS |
4755096e | 2050 | |
d420ca49 | 2051 | =over 4 |
37d4d706 JH |
2052 | |
2053 | =item tr/// | |
2054 | ||
2055 | =item iconv | |
2056 | ||
2057 | =item C RTL | |
2058 | ||
2059 | =back | |
2060 | ||
d396a558 | 2061 | =item OPERATOR DIFFERENCES |
4755096e | 2062 | |
d396a558 | 2063 | =item FUNCTION DIFFERENCES |
4755096e | 2064 | |
d396a558 | 2065 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() |
4755096e | 2066 | |
d396a558 | 2067 | =item REGULAR EXPRESSION DIFFERENCES |
4755096e | 2068 | |
d396a558 | 2069 | =item SOCKETS |
4755096e | 2070 | |
d396a558 | 2071 | =item SORTING |
4755096e | 2072 | |
d420ca49 | 2073 | =over 4 |
4755096e | 2074 | |
9fa7f388 | 2075 | =item Ignore ASCII vs. EBCDIC sort differences. |
4755096e | 2076 | |
9fa7f388 | 2077 | =item MONO CASE then sort data. |
4755096e | 2078 | |
9fa7f388 | 2079 | =item Convert, sort data, then re convert. |
4755096e | 2080 | |
d396a558 | 2081 | =item Perform sorting on one type of machine only. |
4755096e GS |
2082 | |
2083 | =back | |
2084 | ||
41ca3a40 | 2085 | =item TRANSFORMATION FORMATS |
37d4d706 | 2086 | |
d420ca49 | 2087 | =over 4 |
37d4d706 JH |
2088 | |
2089 | =item URL decoding and encoding | |
2090 | ||
2091 | =item uu encoding and decoding | |
2092 | ||
2093 | =item Quoted-Printable encoding and decoding | |
2094 | ||
41ca3a40 | 2095 | =item Caesarian ciphers |
37d4d706 JH |
2096 | |
2097 | =back | |
2098 | ||
2099 | =item Hashing order and checksums | |
4755096e | 2100 | |
d396a558 | 2101 | =item I18N AND L10N |
4755096e | 2102 | |
d396a558 | 2103 | =item MULTI OCTET CHARACTER SETS |
4755096e | 2104 | |
d396a558 | 2105 | =item OS ISSUES |
4755096e | 2106 | |
d420ca49 | 2107 | =over 4 |
4755096e | 2108 | |
d396a558 | 2109 | =item OS/400 |
7029d033 | 2110 | |
d396a558 | 2111 | IFS access |
4755096e | 2112 | |
41ca3a40 | 2113 | =item OS/390, z/OS |
4755096e | 2114 | |
41ca3a40 | 2115 | chcp, dataset access, OS/390, z/OS iconv, locales |
4755096e | 2116 | |
d396a558 | 2117 | =item VM/ESA? |
4755096e | 2118 | |
d396a558 | 2119 | =item POSIX-BC? |
4755096e | 2120 | |
d396a558 | 2121 | =back |
4755096e | 2122 | |
9fa7f388 JH |
2123 | =item BUGS |
2124 | ||
b3b6085d PP |
2125 | =item SEE ALSO |
2126 | ||
d396a558 | 2127 | =item REFERENCES |
c2e66d9e | 2128 | |
41ca3a40 JH |
2129 | =item HISTORY |
2130 | ||
d396a558 | 2131 | =item AUTHOR |
4755096e GS |
2132 | |
2133 | =back | |
2134 | ||
d396a558 | 2135 | =head2 perlsec - Perl security |
4755096e | 2136 | |
d420ca49 | 2137 | =over 4 |
4755096e | 2138 | |
4755096e GS |
2139 | =item DESCRIPTION |
2140 | ||
d420ca49 | 2141 | =over 4 |
4755096e | 2142 | |
d396a558 | 2143 | =item Laundering and Detecting Tainted Data |
4755096e | 2144 | |
d396a558 | 2145 | =item Switches On the "#!" Line |
4755096e | 2146 | |
d396a558 | 2147 | =item Cleaning Up Your Path |
c2e66d9e | 2148 | |
d396a558 | 2149 | =item Security Bugs |
c2e66d9e | 2150 | |
d396a558 | 2151 | =item Protecting Your Programs |
4755096e GS |
2152 | |
2153 | =back | |
2154 | ||
c2e66d9e GS |
2155 | =item SEE ALSO |
2156 | ||
4755096e GS |
2157 | =back |
2158 | ||
c2e66d9e | 2159 | =head2 perlmod - Perl modules (packages and symbol tables) |
4755096e | 2160 | |
d420ca49 | 2161 | =over 4 |
4755096e GS |
2162 | |
2163 | =item DESCRIPTION | |
2164 | ||
d420ca49 | 2165 | =over 4 |
4755096e | 2166 | |
c2e66d9e | 2167 | =item Packages |
4755096e | 2168 | |
c2e66d9e | 2169 | =item Symbol Tables |
4755096e | 2170 | |
c2e66d9e | 2171 | =item Package Constructors and Destructors |
4755096e | 2172 | |
c2e66d9e | 2173 | =item Perl Classes |
4755096e | 2174 | |
c2e66d9e | 2175 | =item Perl Modules |
4755096e | 2176 | |
a6fb92f1 JH |
2177 | =item Making your module threadsafe |
2178 | ||
4755096e GS |
2179 | =back |
2180 | ||
c2e66d9e | 2181 | =item SEE ALSO |
4755096e | 2182 | |
c2e66d9e | 2183 | =back |
4755096e | 2184 | |
c2e66d9e | 2185 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
4755096e | 2186 | |
d420ca49 | 2187 | =over 4 |
4755096e | 2188 | |
c2e66d9e | 2189 | =item DESCRIPTION |
4755096e | 2190 | |
c2e66d9e | 2191 | =item THE PERL MODULE LIBRARY |
4755096e | 2192 | |
d420ca49 | 2193 | =over 4 |
4755096e | 2194 | |
c2e66d9e | 2195 | =item Pragmatic Modules |
4755096e | 2196 | |
c2e66d9e | 2197 | attributes, attrs, autouse, base, blib, bytes, charnames, constant, |
d420ca49 | 2198 | diagnostics, fields, filetest, integer, less, locale, open, ops, overload, |
603b90a8 JH |
2199 | re, sigtrap, strict, subs, unicode::distinct, utf8, vars, warnings, |
2200 | warnings::register | |
4755096e | 2201 | |
c2e66d9e | 2202 | =item Standard Modules |
4755096e | 2203 | |
dc6b6eef JH |
2204 | AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, |
2205 | B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, | |
2206 | B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, | |
2207 | B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, | |
2208 | CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, | |
2209 | CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, | |
2210 | Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle, | |
2211 | Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env, | |
2212 | Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant, | |
2213 | ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, | |
a6fb92f1 JH |
2214 | ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix, |
2215 | ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker, | |
2216 | ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, | |
2217 | ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, | |
2218 | File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find, | |
2219 | File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions, | |
2220 | File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, | |
2221 | File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, | |
2222 | Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate, | |
2223 | I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3, | |
2224 | Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, | |
2225 | Locale::Maketext, Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, | |
2226 | Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, | |
2227 | Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, | |
2228 | Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT, | |
afd1eb53 NIS |
2229 | Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, |
2230 | Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, | |
2231 | Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, | |
2232 | PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, | |
2233 | Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, | |
2234 | Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, | |
2235 | Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, | |
2236 | Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, | |
2237 | Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More, | |
2238 | Test::Simple, Text::Abbrev, Text::Balanced, Text::ParseWords, | |
2239 | Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, | |
2240 | Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, | |
2241 | Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, | |
2242 | Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, | |
2243 | Unicode::UCD, User::grent, User::pwent, Win32 | |
4755096e | 2244 | |
c2e66d9e | 2245 | =item Extension Modules |
4755096e | 2246 | |
c2e66d9e | 2247 | =back |
4755096e | 2248 | |
c2e66d9e | 2249 | =item CPAN |
4755096e | 2250 | |
603b90a8 JH |
2251 | =over 4 |
2252 | ||
2253 | =item Africa | |
2254 | ||
2255 | =item Asia | |
2256 | ||
2257 | =item Central America | |
2258 | ||
2259 | =item Europe | |
2260 | ||
2261 | =item North America | |
2262 | ||
2263 | =item Oceania | |
2264 | ||
2265 | =item South America | |
2266 | ||
2267 | =back | |
4755096e | 2268 | |
c2e66d9e | 2269 | =item Modules: Creation, Use, and Abuse |
4755096e | 2270 | |
d420ca49 | 2271 | =over 4 |
4755096e | 2272 | |
c2e66d9e | 2273 | =item Guidelines for Module Creation |
4755096e | 2274 | |
603b90a8 | 2275 | Adding a Copyright Notice |
4755096e | 2276 | |
c2e66d9e | 2277 | =item Guidelines for Converting Perl 4 Library Scripts into Modules |
4755096e | 2278 | |
c2e66d9e | 2279 | =item Guidelines for Reusing Application Code |
4755096e | 2280 | |
c2e66d9e | 2281 | =back |
4755096e | 2282 | |
c2e66d9e | 2283 | =item NOTE |
4755096e | 2284 | |
c2e66d9e | 2285 | =back |
4755096e | 2286 | |
c2e66d9e | 2287 | =head2 perlmodinstall - Installing CPAN Modules |
4755096e | 2288 | |
d420ca49 | 2289 | =over 4 |
4755096e | 2290 | |
c2e66d9e | 2291 | =item DESCRIPTION |
4755096e | 2292 | |
d420ca49 | 2293 | =over 4 |
4755096e | 2294 | |
c2e66d9e | 2295 | =item PREAMBLE |
4755096e | 2296 | |
c2e66d9e GS |
2297 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
2298 | module (sometimes unnecessary), B<INSTALL> the module | |
4755096e | 2299 | |
c2e66d9e | 2300 | =back |
4755096e | 2301 | |
a9ef4385 JH |
2302 | =item PORTABILITY |
2303 | ||
c2e66d9e GS |
2304 | =item HEY |
2305 | ||
2306 | =item AUTHOR | |
2307 | ||
2308 | =item COPYRIGHT | |
4755096e GS |
2309 | |
2310 | =back | |
2311 | ||
c2e66d9e | 2312 | =head2 perlnewmod - preparing a new module for distribution |
4755096e | 2313 | |
d420ca49 | 2314 | =over 4 |
4755096e | 2315 | |
c2e66d9e | 2316 | =item DESCRIPTION |
4755096e | 2317 | |
d420ca49 | 2318 | =over 4 |
4755096e | 2319 | |
c2e66d9e | 2320 | =item Warning |
4755096e | 2321 | |
c2e66d9e | 2322 | =item What should I make into a module? |
4755096e | 2323 | |
c2e66d9e | 2324 | =item Step-by-step: Preparing the ground |
4755096e | 2325 | |
c2e66d9e | 2326 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
4755096e | 2327 | |
c2e66d9e | 2328 | =item Step-by-step: Making the module |
4755096e | 2329 | |
c2e66d9e | 2330 | Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use |
4d4e713d JH |
2331 | L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old |
2332 | documentation|perlpod>, Write tests, Write the README | |
4755096e | 2333 | |
c2e66d9e | 2334 | =item Step-by-step: Distributing your module |
4755096e | 2335 | |
c2e66d9e GS |
2336 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
2337 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
4755096e | 2338 | |
c2e66d9e | 2339 | =back |
4755096e | 2340 | |
c2e66d9e | 2341 | =item AUTHOR |
4755096e | 2342 | |
c2e66d9e | 2343 | =item SEE ALSO |
4755096e GS |
2344 | |
2345 | =back | |
2346 | ||
2347 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date: | |
2348 | 1999/05/23 16:08:30 $) | |
2349 | ||
d420ca49 | 2350 | =over 4 |
4755096e GS |
2351 | |
2352 | =item DESCRIPTION | |
2353 | ||
d420ca49 | 2354 | =over 4 |
4755096e GS |
2355 | |
2356 | =item What is Perl? | |
2357 | ||
2358 | =item Who supports Perl? Who develops it? Why is it free? | |
2359 | ||
2360 | =item Which version of Perl should I use? | |
2361 | ||
2362 | =item What are perl4 and perl5? | |
2363 | ||
2364 | =item What is perl6? | |
2365 | ||
2366 | =item How stable is Perl? | |
2367 | ||
2368 | =item Is Perl difficult to learn? | |
2369 | ||
2370 | =item How does Perl compare with other languages like Java, Python, REXX, | |
2371 | Scheme, or Tcl? | |
2372 | ||
2373 | =item Can I do [task] in Perl? | |
2374 | ||
2375 | =item When shouldn't I program in Perl? | |
2376 | ||
2377 | =item What's the difference between "perl" and "Perl"? | |
2378 | ||
2379 | =item Is it a Perl program or a Perl script? | |
2380 | ||
2381 | =item What is a JAPH? | |
2382 | ||
2383 | =item Where can I get a list of Larry Wall witticisms? | |
2384 | ||
165c0277 JH |
2385 | =item How can I convince my sysadmin/supervisor/employees to use version |
2386 | 5/5.005/Perl instead of some other language? | |
4755096e GS |
2387 | |
2388 | =back | |
2389 | ||
2390 | =item AUTHOR AND COPYRIGHT | |
2391 | ||
2392 | =back | |
2393 | ||
2394 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $, | |
2395 | $Date: 1999/10/14 18:46:09 $) | |
2396 | ||
d420ca49 | 2397 | =over 4 |
4755096e GS |
2398 | |
2399 | =item DESCRIPTION | |
2400 | ||
d420ca49 | 2401 | =over 4 |
4755096e GS |
2402 | |
2403 | =item What machines support Perl? Where do I get it? | |
2404 | ||
2405 | =item How can I get a binary version of Perl? | |
2406 | ||
2407 | =item I don't have a C compiler on my system. How can I compile perl? | |
2408 | ||
2409 | =item I copied the Perl binary from one machine to another, but scripts | |
2410 | don't work. | |
2411 | ||
2412 | =item I grabbed the sources and tried to compile but gdbm/dynamic | |
2413 | loading/malloc/linking/... failed. How do I make it work? | |
2414 | ||
2415 | =item What modules and extensions are available for Perl? What is CPAN? | |
2416 | What does CPAN/src/... mean? | |
2417 | ||
2418 | =item Is there an ISO or ANSI certified version of Perl? | |
2419 | ||
2420 | =item Where can I get information on Perl? | |
2421 | ||
2422 | =item What are the Perl newsgroups on Usenet? Where do I post questions? | |
2423 | ||
2424 | =item Where should I post source code? | |
2425 | ||
2426 | =item Perl Books | |
2427 | ||
2428 | References, Tutorials, Task-Oriented, Special Topics | |
2429 | ||
2430 | =item Perl in Magazines | |
2431 | ||
2432 | =item Perl on the Net: FTP and WWW Access | |
2433 | ||
2434 | =item What mailing lists are there for Perl? | |
2435 | ||
2436 | =item Archives of comp.lang.perl.misc | |
2437 | ||
2438 | =item Where can I buy a commercial version of Perl? | |
2439 | ||
2440 | =item Where do I send bug reports? | |
2441 | ||
2442 | =item What is perl.com? Perl Mongers? pm.org? perl.org? | |
2443 | ||
2444 | =back | |
2445 | ||
2446 | =item AUTHOR AND COPYRIGHT | |
2447 | ||
2448 | =back | |
2449 | ||
2450 | =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23 | |
2451 | 16:08:30 $) | |
2452 | ||
d420ca49 | 2453 | =over 4 |
4755096e GS |
2454 | |
2455 | =item DESCRIPTION | |
2456 | ||
d420ca49 | 2457 | =over 4 |
4755096e GS |
2458 | |
2459 | =item How do I do (anything)? | |
2460 | ||
2461 | =item How can I use Perl interactively? | |
2462 | ||
2463 | =item Is there a Perl shell? | |
2464 | ||
2465 | =item How do I debug my Perl programs? | |
2466 | ||
2467 | =item How do I profile my Perl programs? | |
2468 | ||
2469 | =item How do I cross-reference my Perl programs? | |
2470 | ||
2471 | =item Is there a pretty-printer (formatter) for Perl? | |
2472 | ||
2473 | =item Is there a ctags for Perl? | |
2474 | ||
2475 | =item Is there an IDE or Windows Perl Editor? | |
2476 | ||
245d750e JH |
2477 | Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, |
2478 | CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, | |
603b90a8 JH |
2479 | MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha |
2480 | ||
4755096e GS |
2481 | =item Where can I get Perl macros for vi? |
2482 | ||
2483 | =item Where can I get perl-mode for emacs? | |
2484 | ||
2485 | =item How can I use curses with Perl? | |
2486 | ||
2487 | =item How can I use X or Tk with Perl? | |
2488 | ||
2489 | =item How can I generate simple menus without using CGI or Tk? | |
2490 | ||
2491 | =item What is undump? | |
2492 | ||
2493 | =item How can I make my Perl program run faster? | |
2494 | ||
2495 | =item How can I make my Perl program take less memory? | |
2496 | ||
2497 | =item Is it unsafe to return a pointer to local data? | |
2498 | ||
2499 | =item How can I free an array or hash so my program shrinks? | |
2500 | ||
2501 | =item How can I make my CGI script more efficient? | |
2502 | ||
2503 | =item How can I hide the source for my Perl program? | |
2504 | ||
2505 | =item How can I compile my Perl program into byte code or C? | |
2506 | ||
2507 | =item How can I compile Perl into Java? | |
2508 | ||
2509 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? | |
2510 | ||
2511 | =item Can I write useful Perl programs on the command line? | |
2512 | ||
2513 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? | |
2514 | ||
2515 | =item Where can I learn about CGI or Web programming in Perl? | |
2516 | ||
2517 | =item Where can I learn about object-oriented Perl programming? | |
2518 | ||
2519 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] | |
2520 | ||
2521 | =item I've read perlembed, perlguts, etc., but I can't embed perl in | |
d420ca49 | 2522 | my C program; what am I doing wrong? |
4755096e GS |
2523 | |
2524 | =item When I tried to run my script, I got this message. What does it | |
2525 | mean? | |
2526 | ||
2527 | =item What's MakeMaker? | |
2528 | ||
2529 | =back | |
2530 | ||
2531 | =item AUTHOR AND COPYRIGHT | |
2532 | ||
2533 | =back | |
2534 | ||
2535 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23 | |
2536 | 20:37:49 $) | |
2537 | ||
d420ca49 | 2538 | =over 4 |
4755096e GS |
2539 | |
2540 | =item DESCRIPTION | |
2541 | ||
2542 | =item Data: Numbers | |
2543 | ||
d420ca49 | 2544 | =over 4 |
4755096e GS |
2545 | |
2546 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the | |
2547 | numbers I should be getting (eg, 19.95)? | |
2548 | ||
2549 | =item Why isn't my octal data interpreted correctly? | |
2550 | ||
2551 | =item Does Perl have a round() function? What about ceil() and floor()? | |
2552 | Trig functions? | |
2553 | ||
2554 | =item How do I convert bits into ints? | |
2555 | ||
2556 | =item Why doesn't & work the way I want it to? | |
2557 | ||
2558 | =item How do I multiply matrices? | |
2559 | ||
2560 | =item How do I perform an operation on a series of integers? | |
2561 | ||
2562 | =item How can I output Roman numerals? | |
2563 | ||
2564 | =item Why aren't my random numbers random? | |
2565 | ||
2566 | =back | |
2567 | ||
2568 | =item Data: Dates | |
2569 | ||
d420ca49 | 2570 | =over 4 |
4755096e GS |
2571 | |
2572 | =item How do I find the week-of-the-year/day-of-the-year? | |
2573 | ||
2574 | =item How do I find the current century or millennium? | |
2575 | ||
2576 | =item How can I compare two dates and find the difference? | |
2577 | ||
2578 | =item How can I take a string and turn it into epoch seconds? | |
2579 | ||
2580 | =item How can I find the Julian Day? | |
2581 | ||
2582 | =item How do I find yesterday's date? | |
2583 | ||
2584 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? | |
2585 | ||
2586 | =back | |
2587 | ||
2588 | =item Data: Strings | |
2589 | ||
d420ca49 | 2590 | =over 4 |
4755096e GS |
2591 | |
2592 | =item How do I validate input? | |
2593 | ||
2594 | =item How do I unescape a string? | |
2595 | ||
2596 | =item How do I remove consecutive pairs of characters? | |
2597 | ||
2598 | =item How do I expand function calls in a string? | |
2599 | ||
2600 | =item How do I find matching/nesting anything? | |
2601 | ||
2602 | =item How do I reverse a string? | |
2603 | ||
2604 | =item How do I expand tabs in a string? | |
2605 | ||
2606 | =item How do I reformat a paragraph? | |
2607 | ||
2608 | =item How can I access/change the first N letters of a string? | |
2609 | ||
2610 | =item How do I change the Nth occurrence of something? | |
2611 | ||
2612 | =item How can I count the number of occurrences of a substring within a | |
2613 | string? | |
2614 | ||
2615 | =item How do I capitalize all the words on one line? | |
2616 | ||
2617 | =item How can I split a [character] delimited string except when inside | |
2618 | [character]? (Comma-separated files) | |
2619 | ||
2620 | =item How do I strip blank space from the beginning/end of a string? | |
2621 | ||
2622 | =item How do I pad a string with blanks or pad a number with zeroes? | |
2623 | ||
2624 | =item How do I extract selected columns from a string? | |
2625 | ||
2626 | =item How do I find the soundex value of a string? | |
2627 | ||
2628 | =item How can I expand variables in text strings? | |
2629 | ||
2630 | =item What's wrong with always quoting "$vars"? | |
2631 | ||
2632 | =item Why don't my <<HERE documents work? | |
2633 | ||
2634 | 1. There must be no space after the << part, 2. There (probably) should be | |
2635 | a semicolon at the end, 3. You can't (easily) have any space in front of | |
2636 | the tag | |
2637 | ||
2638 | =back | |
2639 | ||
2640 | =item Data: Arrays | |
2641 | ||
d420ca49 | 2642 | =over 4 |
4755096e GS |
2643 | |
2644 | =item What is the difference between a list and an array? | |
2645 | ||
2646 | =item What is the difference between $array[1] and @array[1]? | |
2647 | ||
2648 | =item How can I remove duplicate elements from a list or array? | |
2649 | ||
ab648d5e | 2650 | a), b), c), d), e) |
4755096e | 2651 | |
afd1eb53 NIS |
2652 | =item How can I tell whether a certain element is contained in a list or |
2653 | array? | |
4755096e GS |
2654 | |
2655 | =item How do I compute the difference of two arrays? How do I compute the | |
2656 | intersection of two arrays? | |
2657 | ||
2658 | =item How do I test whether two arrays or hashes are equal? | |
2659 | ||
2660 | =item How do I find the first array element for which a condition is true? | |
2661 | ||
2662 | =item How do I handle linked lists? | |
2663 | ||
2664 | =item How do I handle circular lists? | |
2665 | ||
2666 | =item How do I shuffle an array randomly? | |
2667 | ||
2668 | =item How do I process/modify each element of an array? | |
2669 | ||
2670 | =item How do I select a random element from an array? | |
2671 | ||
2672 | =item How do I permute N elements of a list? | |
2673 | ||
2674 | =item How do I sort an array by (anything)? | |
2675 | ||
2676 | =item How do I manipulate arrays of bits? | |
2677 | ||
2678 | =item Why does defined() return true on empty arrays and hashes? | |
2679 | ||
2680 | =back | |
2681 | ||
2682 | =item Data: Hashes (Associative Arrays) | |
2683 | ||
d420ca49 | 2684 | =over 4 |
4755096e GS |
2685 | |
2686 | =item How do I process an entire hash? | |
2687 | ||
2688 | =item What happens if I add or remove keys from a hash while iterating over | |
2689 | it? | |
2690 | ||
2691 | =item How do I look up a hash element by value? | |
2692 | ||
2693 | =item How can I know how many entries are in a hash? | |
2694 | ||
2695 | =item How do I sort a hash (optionally by value instead of key)? | |
2696 | ||
2697 | =item How can I always keep my hash sorted? | |
2698 | ||
2699 | =item What's the difference between "delete" and "undef" with hashes? | |
2700 | ||
2701 | =item Why don't my tied hashes make the defined/exists distinction? | |
2702 | ||
2703 | =item How do I reset an each() operation part-way through? | |
2704 | ||
2705 | =item How can I get the unique keys from two hashes? | |
2706 | ||
2707 | =item How can I store a multidimensional array in a DBM file? | |
2708 | ||
2709 | =item How can I make my hash remember the order I put elements into it? | |
2710 | ||
2711 | =item Why does passing a subroutine an undefined element in a hash create | |
2712 | it? | |
2713 | ||
2714 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or | |
2715 | array of hashes or arrays? | |
2716 | ||
2717 | =item How can I use a reference as a hash key? | |
2718 | ||
2719 | =back | |
2720 | ||
2721 | =item Data: Misc | |
2722 | ||
d420ca49 | 2723 | =over 4 |
4755096e GS |
2724 | |
2725 | =item How do I handle binary data correctly? | |
2726 | ||
2727 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
2728 | ||
2729 | =item How do I keep persistent data across program calls? | |
2730 | ||
2731 | =item How do I print out or copy a recursive data structure? | |
2732 | ||
2733 | =item How do I define methods for every class/object? | |
2734 | ||
2735 | =item How do I verify a credit card checksum? | |
2736 | ||
2737 | =item How do I pack arrays of doubles or floats for XS code? | |
2738 | ||
2739 | =back | |
2740 | ||
2741 | =item AUTHOR AND COPYRIGHT | |
2742 | ||
2743 | =back | |
2744 | ||
2745 | =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23 | |
2746 | 16:08:30 $) | |
2747 | ||
d420ca49 | 2748 | =over 4 |
4755096e GS |
2749 | |
2750 | =item DESCRIPTION | |
2751 | ||
d420ca49 | 2752 | =over 4 |
4755096e GS |
2753 | |
2754 | =item How do I flush/unbuffer an output filehandle? Why must I do this? | |
2755 | ||
2756 | =item How do I change one line in a file/delete a line in a file/insert a | |
2757 | line in the middle of a file/append to the beginning of a file? | |
2758 | ||
2759 | =item How do I count the number of lines in a file? | |
2760 | ||
2761 | =item How do I make a temporary file name? | |
2762 | ||
2763 | =item How can I manipulate fixed-record-length files? | |
2764 | ||
2765 | =item How can I make a filehandle local to a subroutine? How do I pass | |
2766 | filehandles between subroutines? How do I make an array of filehandles? | |
2767 | ||
2768 | =item How can I use a filehandle indirectly? | |
2769 | ||
2770 | =item How can I set up a footer format to be used with write()? | |
2771 | ||
2772 | =item How can I write() into a string? | |
2773 | ||
2774 | =item How can I output my numbers with commas added? | |
2775 | ||
2776 | =item How can I translate tildes (~) in a filename? | |
2777 | ||
2778 | =item How come when I open a file read-write it wipes it out? | |
2779 | ||
2780 | =item Why do I sometimes get an "Argument list too long" when I use <*>? | |
2781 | ||
2782 | =item Is there a leak/bug in glob()? | |
2783 | ||
2784 | =item How can I open a file with a leading ">" or trailing blanks? | |
2785 | ||
2786 | =item How can I reliably rename a file? | |
2787 | ||
2788 | =item How can I lock a file? | |
2789 | ||
2790 | =item Why can't I just open(FH, ">file.lock")? | |
2791 | ||
2792 | =item I still don't get locking. I just want to increment the number in | |
2793 | the file. How can I do this? | |
2794 | ||
1fa7ca25 JH |
2795 | =item All I want to do is append a small amount of text to the end of a |
2796 | file. Do I still have to use locking? | |
2797 | ||
4755096e GS |
2798 | =item How do I randomly update a binary file? |
2799 | ||
2800 | =item How do I get a file's timestamp in perl? | |
2801 | ||
2802 | =item How do I set a file's timestamp in perl? | |
2803 | ||
2804 | =item How do I print to more than one file at once? | |
2805 | ||
2806 | =item How can I read in an entire file all at once? | |
2807 | ||
2808 | =item How can I read in a file by paragraphs? | |
2809 | ||
2810 | =item How can I read a single character from a file? From the keyboard? | |
2811 | ||
2812 | =item How can I tell whether there's a character waiting on a filehandle? | |
2813 | ||
2814 | =item How do I do a C<tail -f> in perl? | |
2815 | ||
2816 | =item How do I dup() a filehandle in Perl? | |
2817 | ||
2818 | =item How do I close a file descriptor by number? | |
2819 | ||
2820 | =item Why can't I use "C:\temp\foo" in DOS paths? What doesn't | |
2821 | `C:\temp\foo.exe` work? | |
2822 | ||
2823 | =item Why doesn't glob("*.*") get all the files? | |
2824 | ||
2825 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber | |
2826 | protected files? Isn't this a bug in Perl? | |
2827 | ||
2828 | =item How do I select a random line from a file? | |
2829 | ||
2830 | =item Why do I get weird spaces when I print an array of lines? | |
2831 | ||
2832 | =back | |
2833 | ||
2834 | =item AUTHOR AND COPYRIGHT | |
2835 | ||
2836 | =back | |
2837 | ||
2838 | =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $) | |
2839 | ||
d420ca49 | 2840 | =over 4 |
4755096e GS |
2841 | |
2842 | =item DESCRIPTION | |
2843 | ||
d420ca49 | 2844 | =over 4 |
4755096e GS |
2845 | |
2846 | =item How can I hope to use regular expressions without creating illegible | |
2847 | and unmaintainable code? | |
2848 | ||
2849 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters | |
2850 | ||
2851 | =item I'm having trouble matching over more than one line. What's wrong? | |
2852 | ||
2853 | =item How can I pull out lines between two patterns that are themselves on | |
2854 | different lines? | |
2855 | ||
2856 | =item I put a regular expression into $/ but it didn't work. What's wrong? | |
2857 | ||
d420ca49 | 2858 | =item How do I substitute case insensitively on the LHS while preserving |
4755096e GS |
2859 | case on the RHS? |
2860 | ||
2861 | =item How can I make C<\w> match national character sets? | |
2862 | ||
2863 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? | |
2864 | ||
2865 | =item How can I quote a variable to use in a regex? | |
2866 | ||
2867 | =item What is C</o> really for? | |
2868 | ||
2869 | =item How do I use a regular expression to strip C style comments from a | |
2870 | file? | |
2871 | ||
2872 | =item Can I use Perl regular expressions to match balanced text? | |
2873 | ||
2874 | =item What does it mean that regexes are greedy? How can I get around it? | |
2875 | ||
165c0277 | 2876 | =item How do I process each word on each line? |
4755096e GS |
2877 | |
2878 | =item How can I print out a word-frequency or line-frequency summary? | |
2879 | ||
2880 | =item How can I do approximate matching? | |
2881 | ||
2882 | =item How do I efficiently match many regular expressions at once? | |
2883 | ||
2884 | =item Why don't word-boundary searches with C<\b> work for me? | |
2885 | ||
2886 | =item Why does using $&, $`, or $' slow my program down? | |
2887 | ||
2888 | =item What good is C<\G> in a regular expression? | |
2889 | ||
2890 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? | |
2891 | ||
2892 | =item What's wrong with using grep or map in a void context? | |
2893 | ||
2894 | =item How can I match strings with multibyte characters? | |
2895 | ||
2896 | =item How do I match a pattern that is supplied by the user? | |
2897 | ||
2898 | =back | |
2899 | ||
2900 | =item AUTHOR AND COPYRIGHT | |
2901 | ||
2902 | =back | |
2903 | ||
2904 | =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date: | |
2905 | 1999/05/23 20:36:18 $) | |
2906 | ||
d420ca49 | 2907 | =over 4 |
4755096e GS |
2908 | |
2909 | =item DESCRIPTION | |
2910 | ||
d420ca49 | 2911 | =over 4 |
4755096e GS |
2912 | |
2913 | =item Can I get a BNF/yacc/RE for the Perl language? | |
2914 | ||
2915 | =item What are all these $@%&* punctuation signs, and how do I know when to | |
2916 | use them? | |
2917 | ||
2918 | =item Do I always/never have to quote my strings or use semicolons and | |
2919 | commas? | |
2920 | ||
2921 | =item How do I skip some return values? | |
68dc0745 | 2922 | |
2923 | =item How do I temporarily block warnings? | |
2924 | ||
2925 | =item What's an extension? | |
2926 | ||
2927 | =item Why do Perl operators have different precedence than C operators? | |
2928 | ||
2929 | =item How do I declare/create a structure? | |
2930 | ||
2931 | =item How do I create a module? | |
2932 | ||
2933 | =item How do I create a class? | |
2934 | ||
2935 | =item How can I tell if a variable is tainted? | |
2936 | ||
2937 | =item What's a closure? | |
2938 | ||
46fc3d4c | 2939 | =item What is variable suicide and how can I prevent it? |
2940 | ||
68dc0745 | 2941 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
14218588 | 2942 | Regex}? |
68dc0745 | 2943 | |
14218588 | 2944 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
68dc0745 | 2945 | Passing Methods |
2946 | ||
2947 | =item How do I create a static variable? | |
2948 | ||
14218588 | 2949 | =item What's the difference between dynamic and lexical (static) scoping? |
68dc0745 | 2950 | Between local() and my()? |
2951 | ||
2952 | =item How can I access a dynamic variable while a similarly named lexical | |
2953 | is in scope? | |
2954 | ||
2955 | =item What's the difference between deep and shallow binding? | |
2956 | ||
b38f6a39 | 2957 | =item Why doesn't "my($foo) = <FILE>;" work right? |
68dc0745 | 2958 | |
54310121 | 2959 | =item How do I redefine a builtin function, operator, or method? |
68dc0745 | 2960 | |
2961 | =item What's the difference between calling a function as &foo and foo()? | |
2962 | ||
2963 | =item How do I create a switch or case statement? | |
2964 | ||
2965 | =item How can I catch accesses to undefined variables/functions/methods? | |
2966 | ||
2967 | =item Why can't a method included in this same file be found? | |
2968 | ||
2969 | =item How can I find out my current package? | |
2970 | ||
46fc3d4c | 2971 | =item How can I comment out a large block of perl code? |
2972 | ||
14218588 GS |
2973 | =item How do I clear a package? |
2974 | ||
2975 | =item How can I use a variable as a variable name? | |
2976 | ||
68dc0745 | 2977 | =back |
2978 | ||
2979 | =item AUTHOR AND COPYRIGHT | |
2980 | ||
a45bd81d GS |
2981 | =back |
2982 | ||
14218588 GS |
2983 | =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23 |
2984 | 18:37:57 $) | |
68dc0745 | 2985 | |
d420ca49 | 2986 | =over 4 |
a45bd81d | 2987 | |
68dc0745 | 2988 | =item DESCRIPTION |
2989 | ||
d420ca49 | 2990 | =over 4 |
68dc0745 | 2991 | |
2992 | =item How do I find out which operating system I'm running under? | |
2993 | ||
2994 | =item How come exec() doesn't return? | |
2995 | ||
2996 | =item How do I do fancy stuff with the keyboard/screen/mouse? | |
2997 | ||
2998 | Keyboard, Screen, Mouse | |
2999 | ||
fb9cefb4 GS |
3000 | =item How do I print something out in color? |
3001 | ||
3002 | =item How do I read just one key without waiting for a return key? | |
3003 | ||
3004 | =item How do I check whether input is ready on the keyboard? | |
3005 | ||
3006 | =item How do I clear the screen? | |
3007 | ||
3008 | =item How do I get the screen size? | |
3009 | ||
68dc0745 | 3010 | =item How do I ask the user for a password? |
3011 | ||
3012 | =item How do I read and write the serial port? | |
3013 | ||
3014 | lockfiles, open mode, end of line, flushing output, non-blocking input | |
3015 | ||
3016 | =item How do I decode encrypted password files? | |
3017 | ||
3018 | =item How do I start a process in the background? | |
3019 | ||
fb9cefb4 | 3020 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
68dc0745 | 3021 | |
3022 | =item How do I trap control characters/signals? | |
3023 | ||
3024 | =item How do I modify the shadow password file on a Unix system? | |
3025 | ||
3026 | =item How do I set the time and date? | |
3027 | ||
3028 | =item How can I sleep() or alarm() for under a second? | |
3029 | ||
3030 | =item How can I measure time under a second? | |
3031 | ||
3032 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) | |
3033 | ||
d420ca49 | 3034 | =item Why doesn't my sockets program work under System V (Solaris)? What |
68dc0745 | 3035 | does the error message "Protocol not supported" mean? |
3036 | ||
3037 | =item How can I call my system's unique C functions from Perl? | |
3038 | ||
3039 | =item Where do I get the include files to do ioctl() or syscall()? | |
3040 | ||
3041 | =item Why do setuid perl scripts complain about kernel problems? | |
3042 | ||
3043 | =item How can I open a pipe both to and from a command? | |
3044 | ||
3fe9a6f1 | 3045 | =item Why can't I get the output of a command with system()? |
3046 | ||
68dc0745 | 3047 | =item How can I capture STDERR from an external command? |
3048 | ||
3049 | =item Why doesn't open() return an error when a pipe open fails? | |
3050 | ||
3051 | =item What's wrong with using backticks in a void context? | |
3052 | ||
3053 | =item How can I call backticks without shell processing? | |
3054 | ||
3055 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, | |
54310121 | 3056 | ^Z on MS-DOS)? |
68dc0745 | 3057 | |
3058 | =item How can I convert my shell script to perl? | |
3059 | ||
3060 | =item Can I use perl to run a telnet or ftp session? | |
3061 | ||
3062 | =item How can I write expect in Perl? | |
3063 | ||
3064 | =item Is there a way to hide perl's command line from programs such as | |
3065 | "ps"? | |
3066 | ||
3067 | =item I {changed directory, modified my environment} in a perl script. How | |
3068 | come the change disappeared when I exited the script? How do I get my | |
3069 | changes to be visible? | |
3070 | ||
fb9cefb4 | 3071 | Unix |
68dc0745 | 3072 | |
3073 | =item How do I close a process's filehandle without waiting for it to | |
3074 | complete? | |
3075 | ||
3076 | =item How do I fork a daemon process? | |
3077 | ||
68dc0745 | 3078 | =item How do I find out if I'm running interactively or not? |
3079 | ||
3080 | =item How do I timeout a slow event? | |
3081 | ||
3082 | =item How do I set CPU limits? | |
3083 | ||
3084 | =item How do I avoid zombies on a Unix system? | |
3085 | ||
3086 | =item How do I use an SQL database? | |
3087 | ||
3088 | =item How do I make a system() exit on control-C? | |
3089 | ||
3090 | =item How do I open a file without blocking? | |
3091 | ||
14218588 | 3092 | =item How do I install a module from CPAN? |
68dc0745 | 3093 | |
fb9cefb4 GS |
3094 | =item What's the difference between require and use? |
3095 | ||
46fc3d4c | 3096 | =item How do I keep my own module/library directory? |
3097 | ||
3098 | =item How do I add the directory my program lives in to the module/library | |
3099 | search path? | |
3100 | ||
3101 | =item How do I add a directory to my include path at runtime? | |
3102 | ||
14218588 GS |
3103 | =item What is socket.ph and where do I get it? |
3104 | ||
68dc0745 | 3105 | =back |
3106 | ||
fc36a67e | 3107 | =item AUTHOR AND COPYRIGHT |
3108 | ||
a45bd81d GS |
3109 | =back |
3110 | ||
14218588 | 3111 | =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30 |
3fe9a6f1 | 3112 | $) |
68dc0745 | 3113 | |
d420ca49 | 3114 | =over 4 |
a45bd81d | 3115 | |
68dc0745 | 3116 | =item DESCRIPTION |
3117 | ||
d420ca49 | 3118 | =over 4 |
68dc0745 | 3119 | |
d420ca49 | 3120 | =item My CGI script runs from the command line but not the browser. (500 |
fb9cefb4 GS |
3121 | Server Error) |
3122 | ||
3123 | =item How can I get better error messages from a CGI program? | |
68dc0745 | 3124 | |
3125 | =item How do I remove HTML from a string? | |
3126 | ||
3127 | =item How do I extract URLs? | |
3128 | ||
3129 | =item How do I download a file from the user's machine? How do I open a | |
3130 | file on another machine? | |
3131 | ||
3132 | =item How do I make a pop-up menu in HTML? | |
3133 | ||
3134 | =item How do I fetch an HTML file? | |
3135 | ||
fb9cefb4 GS |
3136 | =item How do I automate an HTML form submission? |
3137 | ||
3138 | =item How do I decode or create those %-encodings on the web? | |
68dc0745 | 3139 | |
3140 | =item How do I redirect to another page? | |
3141 | ||
3142 | =item How do I put a password on my web pages? | |
3143 | ||
3144 | =item How do I edit my .htpasswd and .htgroup files with Perl? | |
3145 | ||
46fc3d4c | 3146 | =item How do I make sure users can't enter values into a form that cause my |
3147 | CGI script to do bad things? | |
3148 | ||
193fb0af | 3149 | =item How do I parse a mail header? |
68dc0745 | 3150 | |
3151 | =item How do I decode a CGI form? | |
3152 | ||
193fb0af | 3153 | =item How do I check a valid mail address? |
68dc0745 | 3154 | |
3155 | =item How do I decode a MIME/BASE64 string? | |
3156 | ||
193fb0af | 3157 | =item How do I return the user's mail address? |
68dc0745 | 3158 | |
fb9cefb4 GS |
3159 | =item How do I send mail? |
3160 | ||
2d967e39 JH |
3161 | =item How do I use MIME to make an attachment to a mail message? |
3162 | ||
fb9cefb4 | 3163 | =item How do I read mail? |
68dc0745 | 3164 | |
3165 | =item How do I find out my hostname/domainname/IP address? | |
3166 | ||
3167 | =item How do I fetch a news article or the active newsgroups? | |
3168 | ||
3169 | =item How do I fetch/put an FTP file? | |
3170 | ||
3171 | =item How can I do RPC in Perl? | |
3172 | ||
3173 | =back | |
3174 | ||
3175 | =item AUTHOR AND COPYRIGHT | |
3176 | ||
a45bd81d GS |
3177 | =back |
3178 | ||
4755096e | 3179 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
a45bd81d | 3180 | |
d420ca49 | 3181 | =over 4 |
cb1a09d0 | 3182 | |
8ebc5c01 | 3183 | =item DESCRIPTION |
cb1a09d0 | 3184 | |
d420ca49 | 3185 | =over 4 |
fb9cefb4 | 3186 | |
4755096e | 3187 | =item Layout |
a45bd81d | 3188 | |
4755096e | 3189 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
637e9122 | 3190 | |
4755096e | 3191 | =back |
c76ac1ee | 3192 | |
4755096e | 3193 | =item Using The Back Ends |
c76ac1ee | 3194 | |
d420ca49 | 3195 | =over 4 |
694468e3 | 3196 | |
4755096e | 3197 | =item The Cross Referencing Back End |
c76ac1ee | 3198 | |
4755096e | 3199 | i, &, s, r |
637e9122 | 3200 | |
4755096e | 3201 | =item The Decompiling Back End |
37590e52 | 3202 | |
4755096e | 3203 | =item The Lint Back End |
c76ac1ee | 3204 | |
4755096e | 3205 | =item The Simple C Back End |
37590e52 | 3206 | |
4755096e | 3207 | =item The Bytecode Back End |
a45bd81d | 3208 | |
4755096e | 3209 | =item The Optimized C Back End |
a45bd81d | 3210 | |
4755096e GS |
3211 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, |
3212 | B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, | |
3213 | B::Stash, B::Terse, B::Xref | |
c76ac1ee | 3214 | |
4755096e | 3215 | =back |
b38f6a39 | 3216 | |
4755096e | 3217 | =item KNOWN PROBLEMS |
fb9cefb4 | 3218 | |
4755096e | 3219 | =item AUTHOR |
c76ac1ee | 3220 | |
4755096e | 3221 | =back |
a45bd81d | 3222 | |
4755096e | 3223 | =head2 perlembed - how to embed perl in your C program |
c76ac1ee | 3224 | |
d420ca49 | 3225 | =over 4 |
a45bd81d | 3226 | |
4755096e | 3227 | =item DESCRIPTION |
fb9cefb4 | 3228 | |
d420ca49 | 3229 | =over 4 |
c76ac1ee | 3230 | |
4755096e | 3231 | =item PREAMBLE |
fb9cefb4 | 3232 | |
4755096e GS |
3233 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
3234 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
fb9cefb4 | 3235 | |
4755096e | 3236 | =item ROADMAP |
fb9cefb4 | 3237 | |
4755096e | 3238 | =item Compiling your C program |
c76ac1ee | 3239 | |
4755096e | 3240 | =item Adding a Perl interpreter to your C program |
c76ac1ee | 3241 | |
4755096e | 3242 | =item Calling a Perl subroutine from your C program |
fb9cefb4 | 3243 | |
4755096e | 3244 | =item Evaluating a Perl statement from your C program |
c76ac1ee | 3245 | |
4755096e | 3246 | =item Performing Perl pattern matches and substitutions from your C program |
c76ac1ee | 3247 | |
4755096e | 3248 | =item Fiddling with the Perl stack from your C program |
37590e52 | 3249 | |
4755096e | 3250 | =item Maintaining a persistent interpreter |
c76ac1ee | 3251 | |
4755096e | 3252 | =item Maintaining multiple interpreter instances |
694468e3 | 3253 | |
4755096e GS |
3254 | =item Using Perl modules, which themselves use C libraries, from your C |
3255 | program | |
c76ac1ee | 3256 | |
14218588 | 3257 | =back |
fb9cefb4 | 3258 | |
d420ca49 | 3259 | =item Embedding Perl under Win32 |
fb9cefb4 | 3260 | |
4755096e | 3261 | =item MORAL |
c76ac1ee | 3262 | |
4755096e | 3263 | =item AUTHOR |
fb9cefb4 | 3264 | |
4755096e | 3265 | =item COPYRIGHT |
c76ac1ee | 3266 | |
4755096e | 3267 | =back |
c76ac1ee | 3268 | |
4755096e | 3269 | =head2 perldebguts - Guts of Perl debugging |
a45bd81d | 3270 | |
d420ca49 | 3271 | =over 4 |
c76ac1ee | 3272 | |
4755096e | 3273 | =item DESCRIPTION |
c76ac1ee | 3274 | |
4755096e | 3275 | =item Debugger Internals |
c76ac1ee | 3276 | |
d420ca49 | 3277 | =over 4 |
c76ac1ee | 3278 | |
4755096e | 3279 | =item Writing Your Own Debugger |
c76ac1ee | 3280 | |
37590e52 | 3281 | =back |
c76ac1ee | 3282 | |
4755096e | 3283 | =item Frame Listing Output Examples |
c76ac1ee | 3284 | |
4755096e | 3285 | =item Debugging regular expressions |
c76ac1ee | 3286 | |
d420ca49 | 3287 | =over 4 |
c76ac1ee | 3288 | |
4755096e | 3289 | =item Compile-time output |
c76ac1ee | 3290 | |
4755096e GS |
3291 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
3292 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
3293 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
3294 | C<anchored(TYPE)> | |
c76ac1ee | 3295 | |
4755096e | 3296 | =item Types of nodes |
c76ac1ee | 3297 | |
4755096e | 3298 | =item Run-time output |
c76ac1ee | 3299 | |
37590e52 | 3300 | =back |
c76ac1ee | 3301 | |
4755096e | 3302 | =item Debugging Perl memory usage |
c76ac1ee | 3303 | |
d420ca49 | 3304 | =over 4 |
c76ac1ee | 3305 | |
4755096e | 3306 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
c76ac1ee | 3307 | |
4755096e GS |
3308 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
3309 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
3310 | 6144> | |
c76ac1ee | 3311 | |
4755096e | 3312 | =item Example of using B<-DL> switch |
c76ac1ee | 3313 | |
4755096e | 3314 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> |
c76ac1ee | 3315 | |
4755096e | 3316 | =item B<-DL> details |
37590e52 | 3317 | |
4755096e | 3318 | C<!!!>, C<!!>, C<!> |
37590e52 | 3319 | |
4755096e | 3320 | =item Limitations of B<-DL> statistics |
37590e52 | 3321 | |
4755096e | 3322 | =back |
37590e52 | 3323 | |
4755096e | 3324 | =item SEE ALSO |
c76ac1ee GS |
3325 | |
3326 | =back | |
3327 | ||
4755096e | 3328 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
c76ac1ee | 3329 | |
d420ca49 | 3330 | =over 4 |
c76ac1ee | 3331 | |
4755096e | 3332 | =item DESCRIPTION |
c76ac1ee | 3333 | |
4755096e | 3334 | =item SPECIAL NOTES |
c76ac1ee | 3335 | |
d420ca49 | 3336 | =over 4 |
c76ac1ee | 3337 | |
4755096e | 3338 | =item make |
c76ac1ee | 3339 | |
4755096e GS |
3340 | =item Version caveat |
3341 | ||
3342 | =item Dynamic Loading versus Static Loading | |
c76ac1ee GS |
3343 | |
3344 | =back | |
fb9cefb4 | 3345 | |
4755096e | 3346 | =item TUTORIAL |
cb1a09d0 | 3347 | |
d420ca49 | 3348 | =over 4 |
8ebc5c01 | 3349 | |
4755096e | 3350 | =item EXAMPLE 1 |
fb9cefb4 | 3351 | |
4755096e | 3352 | =item EXAMPLE 2 |
fb9cefb4 | 3353 | |
4755096e | 3354 | =item What has gone on? |
5cd24f17 | 3355 | |
4755096e | 3356 | =item Writing good test scripts |
cb1a09d0 | 3357 | |
4755096e | 3358 | =item EXAMPLE 3 |
774d564b | 3359 | |
4755096e | 3360 | =item What's new here? |
c76ac1ee | 3361 | |
4755096e | 3362 | =item Input and Output Parameters |
c76ac1ee | 3363 | |
4755096e | 3364 | =item The XSUBPP Program |
b38f6a39 | 3365 | |
4755096e | 3366 | =item The TYPEMAP file |
c76ac1ee | 3367 | |
4755096e | 3368 | =item Warning about Output Arguments |
37590e52 | 3369 | |
4755096e | 3370 | =item EXAMPLE 4 |
37590e52 | 3371 | |
4755096e | 3372 | =item What has happened here? |
c76ac1ee | 3373 | |
4755096e | 3374 | =item Anatomy of .xs file |
37590e52 | 3375 | |
4755096e | 3376 | =item Getting the fat out of XSUBs |
cb1a09d0 | 3377 | |
4755096e | 3378 | =item More about XSUB arguments |
37590e52 | 3379 | |
4755096e | 3380 | =item The Argument Stack |
a45bd81d | 3381 | |
4755096e | 3382 | =item Extending your Extension |
a45bd81d | 3383 | |
4755096e | 3384 | =item Documenting your Extension |
37590e52 | 3385 | |
4755096e | 3386 | =item Installing your Extension |
37590e52 | 3387 | |
4755096e | 3388 | =item EXAMPLE 5 |
37590e52 | 3389 | |
4755096e | 3390 | =item New Things in this Example |
37590e52 | 3391 | |
4755096e | 3392 | =item EXAMPLE 6 |
37590e52 | 3393 | |
4755096e | 3394 | =item New Things in this Example |
37590e52 | 3395 | |
4755096e | 3396 | =item EXAMPLE 7 (Coming Soon) |
37590e52 | 3397 | |
4755096e | 3398 | =item EXAMPLE 8 (Coming Soon) |
37590e52 | 3399 | |
4755096e | 3400 | =item EXAMPLE 9 (Coming Soon) |
37590e52 | 3401 | |
4755096e | 3402 | =item Troubleshooting these Examples |
37590e52 | 3403 | |
4755096e | 3404 | =back |
37590e52 | 3405 | |
4755096e | 3406 | =item See also |
37590e52 | 3407 | |
4755096e | 3408 | =item Author |
37590e52 | 3409 | |
d420ca49 | 3410 | =over 4 |
37590e52 | 3411 | |
4755096e | 3412 | =item Last Changed |
37590e52 GS |
3413 | |
3414 | =back | |
3415 | ||
4755096e GS |
3416 | =back |
3417 | ||
3418 | =head2 perlxs - XS language reference manual | |
37590e52 | 3419 | |
d420ca49 | 3420 | =over 4 |
37590e52 | 3421 | |
4755096e | 3422 | =item DESCRIPTION |
37590e52 | 3423 | |
d420ca49 | 3424 | =over 4 |
37590e52 | 3425 | |
4755096e | 3426 | =item Introduction |
37590e52 | 3427 | |
4755096e | 3428 | =item On The Road |
37590e52 | 3429 | |
4755096e | 3430 | =item The Anatomy of an XSUB |
37590e52 | 3431 | |
4755096e | 3432 | =item The Argument Stack |
37590e52 | 3433 | |
4755096e | 3434 | =item The RETVAL Variable |
37590e52 | 3435 | |
4755096e | 3436 | =item The MODULE Keyword |
37590e52 | 3437 | |
4755096e | 3438 | =item The PACKAGE Keyword |
37590e52 | 3439 | |
4755096e | 3440 | =item The PREFIX Keyword |
37590e52 | 3441 | |
4755096e | 3442 | =item The OUTPUT: Keyword |
fb9cefb4 | 3443 | |
91331b4f JH |
3444 | =item The NO_OUTPUT Keyword |
3445 | ||
4755096e GS |
3446 | =item The CODE: Keyword |
3447 | ||
3448 | =item The INIT: Keyword | |
3449 | ||
3450 | =item The NO_INIT Keyword | |
3451 | ||
3452 | =item Initializing Function Parameters | |
3453 | ||
3454 | =item Default Parameter Values | |
3455 | ||
3456 | =item The PREINIT: Keyword | |
3457 | ||
3458 | =item The SCOPE: Keyword | |
3459 | ||
3460 | =item The INPUT: Keyword | |
3461 | ||
165c0277 | 3462 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords |
91331b4f | 3463 | |
4755096e GS |
3464 | =item Variable-length Parameter Lists |
3465 | ||
3466 | =item The C_ARGS: Keyword | |
3467 | ||
3468 | =item The PPCODE: Keyword | |
3469 | ||
3470 | =item Returning Undef And Empty Lists | |
3471 | ||
3472 | =item The REQUIRE: Keyword | |
fb9cefb4 | 3473 | |
4755096e | 3474 | =item The CLEANUP: Keyword |
fb9cefb4 | 3475 | |
354a27bf | 3476 | =item The POSTCALL: Keyword |
91331b4f | 3477 | |
4755096e | 3478 | =item The BOOT: Keyword |
cb1a09d0 | 3479 | |
4755096e | 3480 | =item The VERSIONCHECK: Keyword |
cb1a09d0 | 3481 | |
4755096e | 3482 | =item The PROTOTYPES: Keyword |
cb1a09d0 | 3483 | |
4755096e | 3484 | =item The PROTOTYPE: Keyword |
a45bd81d | 3485 | |
4755096e | 3486 | =item The ALIAS: Keyword |
cb1a09d0 | 3487 | |
4755096e | 3488 | =item The INTERFACE: Keyword |
a45bd81d | 3489 | |
4755096e | 3490 | =item The INTERFACE_MACRO: Keyword |
cb1a09d0 | 3491 | |
4755096e | 3492 | =item The INCLUDE: Keyword |
cb1a09d0 | 3493 | |
4755096e | 3494 | =item The CASE: Keyword |
cb1a09d0 | 3495 | |
4755096e | 3496 | =item The & Unary Operator |
cb1a09d0 | 3497 | |
2cc61e15 | 3498 | =item Inserting POD, Comments and C Preprocessor Directives |
cb1a09d0 | 3499 | |
4755096e | 3500 | =item Using XS With C++ |
cb1a09d0 | 3501 | |
4755096e | 3502 | =item Interface Strategy |
cb1a09d0 | 3503 | |
4755096e | 3504 | =item Perl Objects And C Structures |
14218588 | 3505 | |
4755096e | 3506 | =item The Typemap |
cb1a09d0 | 3507 | |
8ebc5c01 | 3508 | =back |
cb1a09d0 | 3509 | |
4755096e GS |
3510 | =item EXAMPLES |
3511 | ||
3512 | =item XS VERSION | |
3513 | ||
3514 | =item AUTHOR | |
14218588 | 3515 | |
a45bd81d GS |
3516 | =back |
3517 | ||
f40a6c71 SC |
3518 | =head2 perlclib - Internal replacements for standard C library functions |
3519 | ||
3520 | =over 4 | |
3521 | ||
3522 | =item DESCRIPTION | |
3523 | ||
3524 | =over 4 | |
3525 | ||
3526 | =item Conventions | |
3527 | ||
3528 | C<t>, C<p>, C<n>, C<s> | |
3529 | ||
3530 | =item File Operations | |
3531 | ||
3532 | =item File Input and Output | |
3533 | ||
3534 | =item File Positioning | |
3535 | ||
3536 | =item Memory Management and String Handling | |
3537 | ||
3538 | =item Character Class Tests | |
3539 | ||
3540 | =item F<stdlib.h> functions | |
3541 | ||
3542 | =item Miscellaneous functions | |
3543 | ||
3544 | =back | |
3545 | ||
3546 | =item SEE ALSO | |
3547 | ||
3548 | =back | |
3549 | ||
4755096e | 3550 | =head2 perlguts - Introduction to the Perl API |
cb1a09d0 | 3551 | |
d420ca49 | 3552 | =over 4 |
a45bd81d | 3553 | |
8ebc5c01 | 3554 | =item DESCRIPTION |
cb1a09d0 | 3555 | |
4755096e | 3556 | =item Variables |
cb1a09d0 | 3557 | |
d420ca49 | 3558 | =over 4 |
cb1a09d0 | 3559 | |
4755096e | 3560 | =item Datatypes |
cb1a09d0 | 3561 | |
4755096e | 3562 | =item What is an "IV"? |
cb1a09d0 | 3563 | |
4755096e | 3564 | =item Working with SVs |
cb1a09d0 | 3565 | |
37d4d706 JH |
3566 | =item Offsets |
3567 | ||
4755096e | 3568 | =item What's Really Stored in an SV? |
cb1a09d0 | 3569 | |
4755096e | 3570 | =item Working with AVs |
cb1a09d0 | 3571 | |
4755096e | 3572 | =item Working with HVs |
cb1a09d0 | 3573 | |
4755096e | 3574 | =item Hash API Extensions |
cb1a09d0 | 3575 | |
4755096e | 3576 | =item References |
cb1a09d0 | 3577 | |
4755096e | 3578 | =item Blessed References and Class Objects |
774d564b | 3579 | |
4755096e | 3580 | =item Creating New Variables |
cb1a09d0 | 3581 | |
4755096e | 3582 | =item Reference Counts and Mortality |
a45bd81d | 3583 | |
4755096e | 3584 | =item Stashes and Globs |
cb1a09d0 | 3585 | |
4755096e | 3586 | =item Double-Typed SVs |
a45bd81d | 3587 | |
4755096e | 3588 | =item Magic Variables |
cb1a09d0 | 3589 | |
4755096e | 3590 | =item Assigning Magic |
cb1a09d0 | 3591 | |
4755096e | 3592 | =item Magic Virtual Tables |
cb1a09d0 | 3593 | |
4755096e | 3594 | =item Finding Magic |
cb1a09d0 | 3595 | |
4755096e | 3596 | =item Understanding the Magic of Tied Hashes and Arrays |
cb1a09d0 | 3597 | |
4755096e | 3598 | =item Localizing changes |
cb1a09d0 | 3599 | |
4755096e | 3600 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
e42c74e1 JH |
3601 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV |
3602 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, | |
3603 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, | |
3604 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, | |
3605 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* | |
3606 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
3607 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
3608 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
3609 | save_hptr(HV **hptr)> | |
cb1a09d0 | 3610 | |
4755096e | 3611 | =back |
cb1a09d0 | 3612 | |
4755096e | 3613 | =item Subroutines |
cb1a09d0 | 3614 | |
d420ca49 | 3615 | =over 4 |
cb1a09d0 | 3616 | |
4755096e | 3617 | =item XSUBs and the Argument Stack |
cb1a09d0 | 3618 | |
4755096e | 3619 | =item Calling Perl Routines from within C Programs |
cb1a09d0 | 3620 | |
4755096e | 3621 | =item Memory Allocation |
cb1a09d0 | 3622 | |
4755096e | 3623 | =item PerlIO |
cb1a09d0 | 3624 | |
4755096e | 3625 | =item Putting a C value on Perl stack |
cb1a09d0 | 3626 | |
4755096e | 3627 | =item Scratchpads |
cb1a09d0 | 3628 | |
4755096e | 3629 | =item Scratchpads and recursion |
cb1a09d0 | 3630 | |
4755096e | 3631 | =back |
cb1a09d0 | 3632 | |
4755096e | 3633 | =item Compiled code |
cb1a09d0 | 3634 | |
d420ca49 | 3635 | =over 4 |
cb1a09d0 | 3636 | |
4755096e | 3637 | =item Code tree |
cb1a09d0 | 3638 | |
4755096e | 3639 | =item Examining the tree |
cb1a09d0 | 3640 | |
4755096e | 3641 | =item Compile pass 1: check routines |
cb1a09d0 | 3642 | |
4755096e | 3643 | =item Compile pass 1a: constant folding |
cb1a09d0 | 3644 | |
4755096e | 3645 | =item Compile pass 2: context propagation |
cb1a09d0 | 3646 | |
4755096e | 3647 | =item Compile pass 3: peephole optimization |
cb1a09d0 | 3648 | |
4755096e | 3649 | =back |
cb1a09d0 | 3650 | |
165c0277 JH |
3651 | =item Examining internal data structures with the C<dump> functions |
3652 | ||
4755096e | 3653 | =item How multiple interpreters and concurrency are supported |
cb1a09d0 | 3654 | |
d420ca49 | 3655 | =over 4 |
cb1a09d0 | 3656 | |
4755096e | 3657 | =item Background and PERL_IMPLICIT_CONTEXT |
cb1a09d0 | 3658 | |
0d0e97a6 JH |
3659 | =item So what happened to dTHR? |
3660 | ||
4755096e | 3661 | =item How do I use all this in extensions? |
cb1a09d0 | 3662 | |
0d0e97a6 JH |
3663 | =item Should I do anything special if I call perl from multiple threads? |
3664 | ||
4755096e | 3665 | =item Future Plans and PERL_IMPLICIT_SYS |
cb1a09d0 | 3666 | |
4755096e | 3667 | =back |
fb9cefb4 | 3668 | |
7029d033 JH |
3669 | =item Internal Functions |
3670 | ||
0d0e97a6 | 3671 | A, p, d, s, n, r, f, M, o, j, x |
7029d033 | 3672 | |
d420ca49 | 3673 | =over 4 |
7029d033 | 3674 | |
a9ef4385 | 3675 | =item Formatted Printing of IVs, UVs, and NVs |
91e74348 | 3676 | |
9fa7f388 JH |
3677 | =item Pointer-To-Integer and Integer-To-Pointer |
3678 | ||
7029d033 JH |
3679 | =item Source Documentation |
3680 | ||
3681 | =back | |
3682 | ||
3683 | =item Unicode Support | |
3684 | ||
d420ca49 | 3685 | =over 4 |
7029d033 JH |
3686 | |
3687 | =item What B<is> Unicode, anyway? | |
3688 | ||
3689 | =item How can I recognise a UTF8 string? | |
3690 | ||
3691 | =item How does UTF8 represent Unicode characters? | |
3692 | ||
3693 | =item How does Perl store UTF8 strings? | |
3694 | ||
3695 | =item How do I convert a string to UTF8? | |
3696 | ||
3697 | =item Is there anything else I need to know? | |
3698 | ||
3699 | =back | |
3700 | ||
4755096e | 3701 | =item AUTHORS |
fb9cefb4 | 3702 | |
4755096e | 3703 | =item SEE ALSO |
cb1a09d0 | 3704 | |
4755096e | 3705 | =back |
cb1a09d0 | 3706 | |
4755096e | 3707 | =head2 perlcall - Perl calling conventions from C |
193fb0af | 3708 | |
d420ca49 | 3709 | =over 4 |
cb1a09d0 | 3710 | |
4755096e | 3711 | =item DESCRIPTION |
68dc0745 | 3712 | |
4755096e | 3713 | An Error Handler, An Event Driven Program |
193fb0af | 3714 | |
4755096e | 3715 | =item THE CALL_ FUNCTIONS |
cb1a09d0 | 3716 | |
4755096e | 3717 | call_sv, call_pv, call_method, call_argv |
a45bd81d | 3718 | |
4755096e | 3719 | =item FLAG VALUES |
cb1a09d0 | 3720 | |
d420ca49 | 3721 | =over 4 |
a45bd81d | 3722 | |
4755096e | 3723 | =item G_VOID |
cb1a09d0 | 3724 | |
4755096e | 3725 | =item G_SCALAR |
55497cff | 3726 | |
4755096e | 3727 | =item G_ARRAY |
cb1a09d0 | 3728 | |
4755096e | 3729 | =item G_DISCARD |
cb1a09d0 | 3730 | |
4755096e | 3731 | =item G_NOARGS |
c76ac1ee | 3732 | |
4755096e | 3733 | =item G_EVAL |
14218588 | 3734 | |
4755096e | 3735 | =item G_KEEPERR |
cb1a09d0 | 3736 | |
4755096e | 3737 | =item Determining the Context |
7d2bfb28 | 3738 | |
4755096e | 3739 | =back |
cb1a09d0 | 3740 | |
4755096e | 3741 | =item KNOWN PROBLEMS |
cb1a09d0 | 3742 | |
4755096e | 3743 | =item EXAMPLES |
fb9cefb4 | 3744 | |
d420ca49 | 3745 | =over 4 |
a45bd81d | 3746 | |
4755096e | 3747 | =item No Parameters, Nothing returned |
a45bd81d | 3748 | |
4755096e | 3749 | =item Passing Parameters |
fb9cefb4 | 3750 | |
4755096e | 3751 | =item Returning a Scalar |
cb1a09d0 | 3752 | |
4755096e | 3753 | =item Returning a list of values |
14218588 | 3754 | |
4755096e | 3755 | =item Returning a list in a scalar context |
14218588 | 3756 | |
4755096e | 3757 | =item Returning Data from Perl via the parameter list |
a45bd81d | 3758 | |
4755096e | 3759 | =item Using G_EVAL |
cb1a09d0 | 3760 | |
4755096e | 3761 | =item Using G_KEEPERR |
a45bd81d | 3762 | |
4755096e | 3763 | =item Using call_sv |
cb1a09d0 | 3764 | |
4755096e | 3765 | =item Using call_argv |
cb1a09d0 | 3766 | |
4755096e | 3767 | =item Using call_method |
cb1a09d0 | 3768 | |
4755096e | 3769 | =item Using GIMME_V |
68dc0745 | 3770 | |
4755096e | 3771 | =item Using Perl to dispose of temporaries |
68dc0745 | 3772 | |
4755096e | 3773 | =item Strategies for storing Callback Context Information |
193fb0af | 3774 | |
4755096e GS |
3775 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
3776 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
3777 | callback | |
cb1a09d0 | 3778 | |
4755096e GS |
3779 | =item Alternate Stack Manipulation |
3780 | ||
3781 | =item Creating and calling an anonymous subroutine in C | |
cb1a09d0 AD |
3782 | |
3783 | =back | |
3784 | ||
4755096e | 3785 | =item SEE ALSO |
1e422769 | 3786 | |
4755096e GS |
3787 | =item AUTHOR |
3788 | ||
3789 | =item DATE | |
1e422769 | 3790 | |
a45bd81d GS |
3791 | =back |
3792 | ||
4755096e | 3793 | =head2 perlutil - utilities packaged with the Perl distribution |
cb1a09d0 | 3794 | |
d420ca49 | 3795 | =over 4 |
a45bd81d | 3796 | |
cb1a09d0 AD |
3797 | =item DESCRIPTION |
3798 | ||
d420ca49 | 3799 | =over 4 |
cb1a09d0 | 3800 | |
4755096e GS |
3801 | =item DOCUMENTATION |
3802 | ||
a6fb92f1 JH |
3803 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, |
3804 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
3805 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
3806 | L<roffitall|roffitall> | |
4755096e GS |
3807 | |
3808 | =item CONVERTORS | |
cb1a09d0 | 3809 | |
4755096e | 3810 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
cb1a09d0 | 3811 | |
a6fb92f1 JH |
3812 | =item Administration |
3813 | ||
3814 | L<libnetcfg|libnetcfg> | |
3815 | ||
4755096e | 3816 | =item Development |
14218588 | 3817 | |
4755096e GS |
3818 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
3819 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
cb1a09d0 | 3820 | |
4755096e | 3821 | =item SEE ALSO |
cb1a09d0 AD |
3822 | |
3823 | =back | |
3824 | ||
a45bd81d GS |
3825 | =back |
3826 | ||
4755096e | 3827 | =head2 perlfilter - Source Filters |
cb1a09d0 | 3828 | |
d420ca49 | 3829 | =over 4 |
a45bd81d | 3830 | |
cb1a09d0 AD |
3831 | =item DESCRIPTION |
3832 | ||
4755096e | 3833 | =item CONCEPTS |
cb1a09d0 | 3834 | |
4755096e | 3835 | =item USING FILTERS |
cb1a09d0 | 3836 | |
4755096e | 3837 | =item WRITING A SOURCE FILTER |
cb1a09d0 | 3838 | |
4755096e | 3839 | =item WRITING A SOURCE FILTER IN C |
fb9cefb4 | 3840 | |
4755096e | 3841 | B<Decryption Filters> |
14218588 | 3842 | |
4755096e | 3843 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE |
cb1a09d0 | 3844 | |
4755096e GS |
3845 | =item WRITING A SOURCE FILTER IN PERL |
3846 | ||
3847 | =item USING CONTEXT: THE DEBUG FILTER | |
3848 | ||
3849 | =item CONCLUSION | |
3850 | ||
3851 | =item REQUIREMENTS | |
3852 | ||
3853 | =item AUTHOR | |
3854 | ||
3855 | =item Copyrights | |
14218588 | 3856 | |
a45bd81d GS |
3857 | =back |
3858 | ||
4755096e | 3859 | =head2 perldbmfilter - Perl DBM Filters |
cb1a09d0 | 3860 | |
d420ca49 | 3861 | =over 4 |
a45bd81d | 3862 | |
cb1a09d0 AD |
3863 | =item SYNOPSIS |
3864 | ||
cb1a09d0 AD |
3865 | =item DESCRIPTION |
3866 | ||
4755096e GS |
3867 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
3868 | B<filter_fetch_value> | |
cb1a09d0 | 3869 | |
d420ca49 | 3870 | =over 4 |
193fb0af | 3871 | |
4755096e | 3872 | =item The Filter |
cb1a09d0 | 3873 | |
4755096e | 3874 | =item An Example -- the NULL termination problem. |
c76ac1ee | 3875 | |
4755096e | 3876 | =item Another Example -- Key is a C int. |
cb1a09d0 | 3877 | |
4755096e | 3878 | =back |
193fb0af | 3879 | |
4755096e | 3880 | =item SEE ALSO |
193fb0af | 3881 | |
4755096e | 3882 | =item AUTHOR |
cb1a09d0 | 3883 | |
4755096e | 3884 | =back |
cb1a09d0 | 3885 | |
4755096e | 3886 | =head2 perlapi - autogenerated documentation for the perl public API |
44a8e56a | 3887 | |
d420ca49 | 3888 | =over 4 |
cb1a09d0 | 3889 | |
4755096e | 3890 | =item DESCRIPTION |
cb1a09d0 | 3891 | |
7029d033 JH |
3892 | AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, |
3893 | av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, | |
ac4dd294 JH |
3894 | ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, |
3895 | call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK, | |
3896 | dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND, | |
afd1eb53 NIS |
3897 | fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv, |
3898 | get_sv, GIMME, GIMME_V, grok_number, grok_numeric_radix, GvSV, | |
3899 | gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, | |
3900 | gv_stashsv, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, | |
3901 | HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, | |
3902 | HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists, | |
3903 | hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, | |
3904 | hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, | |
3905 | hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, | |
3906 | isUPPER, is_utf8_char, is_utf8_string, items, ix, LEAVE, load_module, | |
3907 | looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, | |
3908 | mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, | |
3909 | newRV_inc, newRV_noinc, newSV, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, | |
3910 | newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, | |
3911 | Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, | |
3912 | perl_clone, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, | |
3913 | PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, | |
3914 | POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, | |
3915 | PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, | |
3916 | SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, | |
3917 | strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, | |
3918 | SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, | |
3919 | SvIOK_UV, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, | |
3920 | SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, | |
3921 | SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, | |
3922 | SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, | |
3923 | SvPVutf8, SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, | |
3924 | SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, | |
3925 | SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, | |
3926 | SvSetMagicSV, SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, | |
3927 | SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, | |
3928 | SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, | |
3929 | SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, | |
3930 | sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, | |
3931 | sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv, | |
3932 | sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, | |
3933 | sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, | |
3934 | sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec, | |
3935 | sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, | |
3936 | sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, | |
a6fb92f1 JH |
3937 | sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, |
3938 | sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, | |
3939 | sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, | |
4f233aa4 JH |
3940 | sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset, |
3941 | sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, | |
3942 | sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, | |
640374d0 JH |
3943 | sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, |
3944 | sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, | |
a6fb92f1 JH |
3945 | sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, |
3946 | sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, | |
3947 | sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, | |
3948 | sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, | |
3949 | toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, | |
3950 | utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, | |
3951 | uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, | |
3952 | XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, | |
3953 | XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, | |
3954 | XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero | |
c76ac1ee | 3955 | |
4755096e | 3956 | =item AUTHORS |
cb1a09d0 AD |
3957 | |
3958 | =item SEE ALSO | |
3959 | ||
a45bd81d GS |
3960 | =back |
3961 | ||
91331b4f | 3962 | =head2 perlintern - autogenerated documentation of purely B<internal> |
4755096e | 3963 | Perl functions |
cb1a09d0 | 3964 | |
d420ca49 | 3965 | =over 4 |
a45bd81d | 3966 | |
cb1a09d0 AD |
3967 | =item DESCRIPTION |
3968 | ||
dc5c060f | 3969 | djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, |
a6fb92f1 JH |
3970 | PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena, |
3971 | sv_clean_all, sv_clean_objs, sv_free_arenas | |
4755096e GS |
3972 | |
3973 | =item AUTHORS | |
3974 | ||
3975 | =item SEE ALSO | |
3976 | ||
3977 | =back | |
3978 | ||
dc5c060f JH |
3979 | =head2 perliol - C API for Perl's implementation of IO in Layers. |
3980 | ||
3981 | =over 4 | |
3982 | ||
3983 | =item SYNOPSIS | |
3984 | ||
3985 | =item DESCRIPTION | |
3986 | ||
3987 | =over 4 | |
3988 | ||
3989 | =item History and Background | |
3990 | ||
3991 | =item Layers vs Disciplines | |
3992 | ||
3993 | =item Data Structures | |
3994 | ||
3995 | 1. The functions and attributes of the "layer class", 2. The per-instance | |
3996 | data for a particular handle | |
3997 | ||
3998 | =item Functions and Attributes | |
3999 | ||
dc5c060f JH |
4000 | =item Per-instance Data |
4001 | ||
4002 | =item Layers in action. | |
4003 | ||
4004 | =item Per-instance flag bits | |
4005 | ||
4006 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, | |
4007 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, | |
4008 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, | |
4009 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS | |
4010 | ||
4011 | =item Methods in Detail | |
4012 | ||
ab1e085c JH |
4013 | IV (*Pushed)(PerlIO *f,const char *mode, SV *arg);, IV |
4014 | (*Popped)(PerlIO *f);, PerlIO * (*Open)(...);, SV * | |
4015 | (*Getarg)(PerlIO *f);, IV (*Fileno)(PerlIO *f);, SSize_t | |
4016 | (*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO | |
4017 | *f, const void *vbuf, Size_t count);, SSize_t (*Write)(PerlIO *f, const | |
4018 | void *vbuf, Size_t count);, IV (*Seek)(PerlIO *f, Off_t | |
4019 | offset, int whence);, Off_t (*Tell)(PerlIO *f);, IV | |
4020 | (*Close)(PerlIO *f);, IV (*Flush)(PerlIO *f);, IV | |
4021 | (*Fill)(PerlIO *f);, IV (*Eof)(PerlIO *f);, IV | |
4022 | (*Error)(PerlIO *f);, void (*Clearerr)(PerlIO *f);, void | |
4023 | (*Setlinebuf)(PerlIO *f);, STDCHAR * (*Get_base)(PerlIO *f);, | |
4024 | Size_t (*Get_bufsiz)(PerlIO *f);, STDCHAR * | |
4025 | (*Get_ptr)(PerlIO *f);, SSize_t (*Get_cnt)(PerlIO *f);, void | |
4026 | (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt); | |
dc5c060f JH |
4027 | |
4028 | =item Core Layers | |
4029 | ||
4030 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" | |
4031 | ||
4032 | =item Extension Layers | |
4033 | ||
ab1e085c | 4034 | ":encoding", ":Scalar", ":Object" or ":Perl" |
dc5c060f JH |
4035 | |
4036 | =back | |
4037 | ||
4038 | =back | |
4039 | ||
4755096e GS |
4040 | =head2 perlapio - perl's IO abstraction interface. |
4041 | ||
d420ca49 | 4042 | =over 4 |
cb1a09d0 | 4043 | |
4755096e | 4044 | =item SYNOPSIS |
cb1a09d0 | 4045 | |
4755096e | 4046 | =item DESCRIPTION |
cb1a09d0 | 4047 | |
dc5c060f JH |
4048 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, |
4049 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, | |
4050 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, | |
4755096e GS |
4051 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, |
4052 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
4053 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
4054 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
4055 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
dc5c060f JH |
4056 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, |
4057 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
4058 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> | |
cb1a09d0 | 4059 | |
d420ca49 | 4060 | =over 4 |
cb1a09d0 | 4061 | |
4755096e | 4062 | =item Co-existence with stdio |
cb1a09d0 | 4063 | |
4755096e | 4064 | B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>, |
dc5c060f JH |
4065 | B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)> |
4066 | ||
4067 | =item "Fast gets" Functions | |
4068 | ||
4069 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, | |
4070 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, | |
4071 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, | |
4072 | B<PerlIO_get_bufsiz(f)> | |
4073 | ||
4074 | =item Other Functions | |
4075 | ||
4076 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), | |
4077 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) | |
cb1a09d0 | 4078 | |
4755096e | 4079 | =back |
c635e13b | 4080 | |
a45bd81d GS |
4081 | =back |
4082 | ||
4755096e | 4083 | =head2 perltodo - Perl TO-DO List |
c635e13b | 4084 | |
d420ca49 | 4085 | =over 4 |
a45bd81d | 4086 | |
c635e13b | 4087 | =item DESCRIPTION |
cb1a09d0 | 4088 | |
245d750e | 4089 | =item To do during 5.6.x |
cb1a09d0 | 4090 | |
d420ca49 | 4091 | =over 4 |
cb1a09d0 | 4092 | |
245d750e | 4093 | =item Support for I/O disciplines |
cb1a09d0 | 4094 | |
245d750e | 4095 | =item Eliminate need for "use utf8"; |
cb1a09d0 | 4096 | |
afd1eb53 | 4097 | =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) |
a6fb92f1 | 4098 | |
245d750e | 4099 | =item Autoload byte.pm |
cb1a09d0 | 4100 | |
245d750e | 4101 | =item Make "\u{XXXX}" et al work |
cb1a09d0 | 4102 | |
245d750e | 4103 | =item Overloadable regex assertions |
4755096e | 4104 | |
245d750e | 4105 | =item Unicode collation and normalization |
4755096e | 4106 | |
245d750e | 4107 | =item Unicode case mappings |
4755096e | 4108 | |
245d750e | 4109 | =item Unicode regular expression character classes |
cb1a09d0 | 4110 | |
245d750e | 4111 | =item use Thread for iThreads |
cb1a09d0 | 4112 | |
2ca5449f JH |
4113 | =item make perl_clone optionally clone ops |
4114 | ||
245d750e | 4115 | =item Work out exit/die semantics for threads |
cb1a09d0 | 4116 | |
245d750e | 4117 | =item Typed lexicals for compiler |
4755096e | 4118 | |
245d750e | 4119 | =item Compiler workarounds for Win32 |
4755096e | 4120 | |
245d750e | 4121 | =item AUTOLOADing in the compiler |
4755096e | 4122 | |
245d750e | 4123 | =item Fixing comppadlist when compiling |
8ebc5c01 | 4124 | |
245d750e | 4125 | =item Cleaning up exported namespace |
4755096e | 4126 | |
245d750e | 4127 | =item Complete signal handling |
cb1a09d0 | 4128 | |
245d750e | 4129 | =item Out-of-source builds |
cb1a09d0 | 4130 | |
245d750e | 4131 | =item POSIX realtime support |
cb1a09d0 | 4132 | |
245d750e | 4133 | =item UNIX98 support |
cb1a09d0 | 4134 | |
245d750e | 4135 | =item IPv6 Support |
cb1a09d0 | 4136 | |
245d750e | 4137 | =item Long double conversion |
cb1a09d0 | 4138 | |
245d750e | 4139 | =item Locales |
cb1a09d0 | 4140 | |
245d750e | 4141 | =item Thread-safe regexes |
cb1a09d0 | 4142 | |
245d750e JH |
4143 | =item Arithmetic on non-Arabic numerals |
4144 | ||
4145 | =item POSIX Unicode character classes | |
4146 | ||
4147 | =item Factoring out common suffices/prefices in regexps (trie optimization) | |
4148 | ||
4149 | =item Security audit shipped utilities | |
4150 | ||
4151 | =item Custom opcodes | |
4152 | ||
4153 | =item spawnvp() on Win32 | |
4154 | ||
4155 | =item DLL Versioning | |
4156 | ||
4157 | =item Introduce @( and @) | |
4158 | ||
4159 | =item Floating point handling | |
4160 | ||
4161 | =item IV/UV preservation | |
4162 | ||
4163 | =item Replace pod2html with something using Pod::Parser | |
4164 | ||
4165 | =item Automate module testing on CPAN | |
4166 | ||
4167 | =item sendmsg and recvmsg | |
4168 | ||
4169 | =item Rewrite perlre documentation | |
cb1a09d0 | 4170 | |
245d750e | 4171 | =item Convert example code to IO::Handle filehandles |
4755096e | 4172 | |
245d750e | 4173 | =item Document Win32 choices |
4755096e | 4174 | |
245d750e | 4175 | =item Check new modules |
4755096e | 4176 | |
245d750e | 4177 | =item Make roffitall find pods and libs itself |
c635e13b | 4178 | |
a45bd81d GS |
4179 | =back |
4180 | ||
245d750e | 4181 | =item To do at some point |
fb9cefb4 | 4182 | |
d420ca49 | 4183 | =over 4 |
a45bd81d | 4184 | |
245d750e | 4185 | =item Remove regular expression recursion |
fb9cefb4 | 4186 | |
245d750e | 4187 | =item Memory leaks after failed eval |
fb9cefb4 | 4188 | |
245d750e | 4189 | =item pack "(stuff)*" |
fb9cefb4 | 4190 | |
245d750e | 4191 | =item bitfields in pack |
fb9cefb4 | 4192 | |
245d750e | 4193 | =item Cross compilation |
fb9cefb4 | 4194 | |
245d750e | 4195 | =item Perl preprocessor / macros |
fb9cefb4 | 4196 | |
245d750e | 4197 | =item Perl lexer in Perl |
fb9cefb4 | 4198 | |
245d750e | 4199 | =item Using POSIX calls internally |
4755096e | 4200 | |
245d750e | 4201 | =item -i rename file when changed |
4755096e | 4202 | |
245d750e | 4203 | =item All ARGV input should act like E<lt>E<gt> |
4755096e | 4204 | |
245d750e | 4205 | =item Support for rerunning debugger |
4755096e | 4206 | |
afd1eb53 NIS |
4207 | =item Test Suite for the Debugger |
4208 | ||
245d750e | 4209 | =item my sub foo { } |
4755096e | 4210 | |
245d750e | 4211 | =item One-pass global destruction |
fb9cefb4 | 4212 | |
245d750e | 4213 | =item Rewrite regexp parser |
a45bd81d | 4214 | |
245d750e | 4215 | =item Cache recently used regexps |
a45bd81d | 4216 | |
245d750e | 4217 | =item Re-entrant functions |
a45bd81d | 4218 | |
245d750e | 4219 | =item Cross-compilation support |
a45bd81d | 4220 | |
245d750e | 4221 | =item Bit-shifting bitvectors |
a45bd81d | 4222 | |
245d750e | 4223 | =item debugger pragma |
a45bd81d | 4224 | |
245d750e | 4225 | =item use less pragma |
a45bd81d | 4226 | |
245d750e | 4227 | =item switch structures |
a45bd81d | 4228 | |
245d750e | 4229 | =item Cache eval tree |
a45bd81d | 4230 | |
245d750e | 4231 | =item rcatmaybe |
a45bd81d | 4232 | |
245d750e | 4233 | =item Shrink opcode tables |
a45bd81d | 4234 | |
245d750e | 4235 | =item Optimize away @_ |
a45bd81d | 4236 | |
245d750e | 4237 | =item Prototypes versus indirect objects |
a45bd81d | 4238 | |
245d750e | 4239 | =item Install HMTL |
a45bd81d | 4240 | |
245d750e | 4241 | =item Prototype method calls |
a45bd81d | 4242 | |
245d750e | 4243 | =item Return context prototype declarations |
a45bd81d | 4244 | |
245d750e | 4245 | =item magic_setisa |
4755096e | 4246 | |
245d750e | 4247 | =item Garbage collection |
4755096e | 4248 | |
245d750e | 4249 | =item IO tutorial |
4755096e | 4250 | |
245d750e | 4251 | =item pack/unpack tutorial |
4755096e | 4252 | |
245d750e | 4253 | =item Rewrite perldoc |
4755096e | 4254 | |
3958b146 | 4255 | =item Install .3p manpages |
245d750e JH |
4256 | |
4257 | =item Unicode tutorial | |
4755096e | 4258 | |
245d750e | 4259 | =item Update POSIX.pm for 1003.1-2 |
3958b146 | 4260 | |
772ff3b9 | 4261 | =item Retargetable installation |
245d750e JH |
4262 | |
4263 | =item POSIX emulation on non-POSIX systems | |
4264 | ||
4265 | =item Rename Win32 headers | |
4266 | ||
4267 | =item Finish off lvalue functions | |
4268 | ||
4269 | =item Update sprintf documentation | |
4270 | ||
4271 | =item Use fchown/fchmod internally | |
a45bd81d GS |
4272 | |
4273 | =back | |
4274 | ||
245d750e | 4275 | =item Vague ideas |
cb1a09d0 | 4276 | |
d420ca49 | 4277 | =over 4 |
a45bd81d | 4278 | |
245d750e | 4279 | =item ref() in list context |
cb1a09d0 | 4280 | |
245d750e | 4281 | =item Make tr/// return histogram |
cb1a09d0 | 4282 | |
245d750e | 4283 | =item Compile to real threaded code |
3958b146 | 4284 | |
772ff3b9 | 4285 | =item Structured types |
3958b146 | 4286 | |
772ff3b9 | 4287 | =item Modifiable $1 et al. |
4755096e | 4288 | |
245d750e | 4289 | =item Procedural interfaces for IO::*, etc. |
cb1a09d0 | 4290 | |
245d750e | 4291 | =item RPC modules |
cb1a09d0 | 4292 | |
245d750e | 4293 | =item Attach/detach debugger from running program |
cb1a09d0 | 4294 | |
245d750e | 4295 | =item Alternative RE syntax module |
cb1a09d0 | 4296 | |
245d750e | 4297 | =item GUI::Native |
cb1a09d0 | 4298 | |
245d750e | 4299 | =item foreach(reverse ...) |
cb1a09d0 | 4300 | |
245d750e | 4301 | =item Constant function cache |
cb1a09d0 | 4302 | |
245d750e | 4303 | =item Approximate regular expression matching |
cb1a09d0 | 4304 | |
a45bd81d GS |
4305 | =back |
4306 | ||
245d750e | 4307 | =item Ongoing |
4755096e | 4308 | |
245d750e | 4309 | =over 4 |
4755096e | 4310 | |
245d750e | 4311 | =item Update guts documentation |
cb1a09d0 | 4312 | |
245d750e | 4313 | =item Add more tests |
a45bd81d | 4314 | |
245d750e | 4315 | =item Update auxiliary tools |
cb1a09d0 | 4316 | |
4755096e | 4317 | =back |
cb1a09d0 | 4318 | |
245d750e | 4319 | =item Recently done things |
cb1a09d0 | 4320 | |
d420ca49 | 4321 | =over 4 |
cb1a09d0 | 4322 | |
245d750e | 4323 | =item Safe signal handling |
cb1a09d0 | 4324 | |
245d750e | 4325 | =item Tie Modules |
cb1a09d0 | 4326 | |
245d750e | 4327 | =item gettimeofday |
193fb0af | 4328 | |
245d750e | 4329 | =item setitimer and getimiter |
193fb0af | 4330 | |
245d750e | 4331 | =item Testing __DIE__ hook |
193fb0af | 4332 | |
245d750e | 4333 | =item CPP equivalent in Perl |
193fb0af | 4334 | |
245d750e | 4335 | =item Explicit switch statements |
193fb0af | 4336 | |
245d750e | 4337 | =item autocroak |
193fb0af | 4338 | |
245d750e | 4339 | =item UTF/EBCDIC |
cb1a09d0 | 4340 | |
245d750e | 4341 | =item UTF Regexes |
cb1a09d0 | 4342 | |
245d750e | 4343 | =item perlcc to produce executable |
cb1a09d0 | 4344 | |
245d750e | 4345 | =item END blocks saved in compiled output |
cb1a09d0 | 4346 | |
245d750e | 4347 | =item Secure temporary file module |
cb1a09d0 | 4348 | |
245d750e | 4349 | =item Integrate Time::HiRes |
cb1a09d0 | 4350 | |
245d750e | 4351 | =item Turn Cwd into XS |
cb1a09d0 | 4352 | |
245d750e | 4353 | =item Mmap for input |
cb1a09d0 | 4354 | |
245d750e | 4355 | =item Byte to/from UTF8 and UTF8 to/from local conversion |
cb1a09d0 | 4356 | |
245d750e | 4357 | =item Add sockatmark support |
cb1a09d0 | 4358 | |
245d750e | 4359 | =item Mailing list archives |
cb1a09d0 | 4360 | |
245d750e | 4361 | =item Bug tracking |
cb1a09d0 | 4362 | |
245d750e | 4363 | =item Integrate MacPerl |
cb1a09d0 | 4364 | |
245d750e | 4365 | =item Web "nerve center" for Perl |
cb1a09d0 | 4366 | |
245d750e | 4367 | =item Regular expression tutorial |
cb1a09d0 | 4368 | |
245d750e | 4369 | =item Debugging Tutorial |
4755096e | 4370 | |
245d750e | 4371 | =item Integrate new modules |
4755096e | 4372 | |
245d750e | 4373 | =item Integrate profiler |
4755096e | 4374 | |
245d750e | 4375 | =item Y2K error detection |
4755096e | 4376 | |
245d750e | 4377 | =item Regular expression debugger |
4755096e | 4378 | |
245d750e | 4379 | =item POD checker |
4755096e | 4380 | |
245d750e | 4381 | =item "Dynamic" lexicals |
4755096e | 4382 | |
245d750e | 4383 | =item Cache precompiled modules |
cb1a09d0 | 4384 | |
245d750e | 4385 | =back |
cb1a09d0 | 4386 | |
245d750e | 4387 | =item Deprecated Wishes |
cb1a09d0 | 4388 | |
245d750e | 4389 | =over 4 |
cb1a09d0 | 4390 | |
245d750e | 4391 | =item Loop control on do{} |
cb1a09d0 | 4392 | |
245d750e | 4393 | =item Lexically scoped typeglobs |
cb1a09d0 | 4394 | |
245d750e | 4395 | =item format BOTTOM |
3958b146 | 4396 | |
772ff3b9 | 4397 | =item report HANDLE |
cb1a09d0 | 4398 | |
245d750e | 4399 | =item Generalised want()/caller()) |
3958b146 | 4400 | |
772ff3b9 | 4401 | =item Named prototypes |
cb1a09d0 | 4402 | |
245d750e | 4403 | =item Built-in globbing |
4755096e | 4404 | |
245d750e | 4405 | =item Regression tests for suidperl |
4755096e | 4406 | |
245d750e | 4407 | =item Cached hash values |
4755096e | 4408 | |
245d750e | 4409 | =item Add compression modules |
cb1a09d0 | 4410 | |
245d750e | 4411 | =item Reorganise documentation into tutorials/references |
cb1a09d0 | 4412 | |
245d750e | 4413 | =item Remove distinction between functions and operators |
cb1a09d0 | 4414 | |
245d750e | 4415 | =item Make XS easier to use |
cb1a09d0 | 4416 | |
245d750e | 4417 | =item Make embedding easier to use |
cb1a09d0 | 4418 | |
245d750e | 4419 | =item man for perl |
cb1a09d0 | 4420 | |
245d750e | 4421 | =item my $Package::variable |
cb1a09d0 | 4422 | |
245d750e | 4423 | =item "or" tests defined, not truth |
4755096e | 4424 | |
245d750e | 4425 | =item "class"-based lexicals |
4755096e | 4426 | |
245d750e | 4427 | =item byteperl |
4755096e | 4428 | |
245d750e | 4429 | =item Lazy evaluation / tail recursion removal |
cb1a09d0 | 4430 | |
a6fb92f1 JH |
4431 | =item Make "use utf8" the default |
4432 | ||
a45bd81d GS |
4433 | =back |
4434 | ||
4755096e GS |
4435 | =back |
4436 | ||
4437 | =head2 perlhack - How to hack at the Perl internals | |
cb1a09d0 | 4438 | |
d420ca49 | 4439 | =over 4 |
a45bd81d | 4440 | |
4755096e GS |
4441 | =item DESCRIPTION |
4442 | ||
4443 | Does concept match the general goals of Perl?, Where is the | |
4444 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
4445 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
4446 | it preclude other desirable features?, Is the implementation robust?, Is | |
4447 | the implementation generic enough to be portable?, Is there enough | |
4448 | documentation?, Is there another way to do it?, Does it create too much | |
d420ca49 AD |
4449 | work?, Patches speak louder than words |
4450 | ||
4451 | =over 4 | |
4452 | ||
4453 | =item Keeping in sync | |
4454 | ||
4455 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
2cc61e15 DD |
4456 | NFS, rsync'ing the patches, It's easier, It's more recent, It's more |
4457 | reliable, It's easier, It's a good reference, Finding a start point, | |
4458 | Finding how to fix a bug, Finding the source of misbehaviour | |
d420ca49 AD |
4459 | |
4460 | =item Submitting patches | |
4461 | ||
4462 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
4463 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
cb1a09d0 | 4464 | |
7029d033 | 4465 | =item Finding Your Way Around |
cb1a09d0 | 4466 | |
7029d033 | 4467 | Core modules, Documentation, Configure, Interpreter |
4755096e | 4468 | |
7029d033 | 4469 | =item Elements of the interpreter |
4755096e | 4470 | |
7029d033 | 4471 | Startup, Parsing, Optimization, Running |
4755096e | 4472 | |
7029d033 | 4473 | =item Internal Variable Types |
4755096e | 4474 | |
7029d033 | 4475 | =item Op Trees |
4755096e | 4476 | |
7029d033 | 4477 | =item Stacks |
4755096e | 4478 | |
7029d033 | 4479 | Argument stack, Mark stack, Save stack |
4755096e | 4480 | |
7029d033 | 4481 | =item Millions of Macros |
4755096e | 4482 | |
7029d033 | 4483 | =item Poking at Perl |
4755096e | 4484 | |
7029d033 | 4485 | =item Using a source-level debugger |
4755096e | 4486 | |
7029d033 | 4487 | run [args], break function_name, break source.c:xxx, step, next, continue, |
d420ca49 | 4488 | finish, 'enter', print |
4755096e | 4489 | |
7029d033 | 4490 | =item Dumping Perl Data Structures |
4755096e | 4491 | |
7029d033 | 4492 | =item Patching |
cb1a09d0 | 4493 | |
91331b4f JH |
4494 | =back |
4495 | ||
4496 | =item EXTERNAL TOOLS FOR DEBUGGING PERL | |
4497 | ||
d420ca49 | 4498 | =over 4 |
91331b4f JH |
4499 | |
4500 | =item Rational Software's Purify | |
4501 | ||
4502 | =item Purify on Unix | |
4503 | ||
4504 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity | |
4505 | ||
4506 | =item Purify on NT | |
4507 | ||
4508 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug | |
4509 | ||
ab1e085c JH |
4510 | =item Compaq's/Digital's Third Degree |
4511 | ||
4512 | =item PERL_DESTRUCT_LEVEL | |
4513 | ||
772ff3b9 JH |
4514 | =item Gprof Profiling |
4515 | ||
4516 | -a, -b, -e routine, -f routine, -s, -z | |
4517 | ||
ab1e085c JH |
4518 | =item Pixie Profiling |
4519 | ||
772ff3b9 | 4520 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, |
245d750e | 4521 | -z[ero] |
ab1e085c | 4522 | |
7029d033 | 4523 | =item CONCLUSION |
cb1a09d0 | 4524 | |
7029d033 | 4525 | I<The Road goes ever on and on, down from the door where it began.> |
cb1a09d0 | 4526 | |
8ebc5c01 | 4527 | =back |
cb1a09d0 | 4528 | |
7029d033 | 4529 | =item AUTHOR |
cb1a09d0 AD |
4530 | |
4531 | =back | |
4532 | ||
7029d033 | 4533 | =head2 perlhist - the Perl history records |
7d2bfb28 | 4534 | |
d420ca49 | 4535 | =over 4 |
7d2bfb28 | 4536 | |
7029d033 | 4537 | =item DESCRIPTION |
cb1a09d0 | 4538 | |
7029d033 | 4539 | =item INTRODUCTION |
cb1a09d0 | 4540 | |
7029d033 | 4541 | =item THE KEEPERS OF THE PUMPKIN |
cb1a09d0 | 4542 | |
d420ca49 | 4543 | =over 4 |
cb1a09d0 | 4544 | |
7029d033 | 4545 | =item PUMPKIN? |
cb1a09d0 | 4546 | |
a45bd81d GS |
4547 | =back |
4548 | ||
7029d033 | 4549 | =item THE RECORDS |
cb1a09d0 | 4550 | |
d420ca49 | 4551 | =over 4 |
cb1a09d0 | 4552 | |
7029d033 | 4553 | =item SELECTED RELEASE SIZES |
cb1a09d0 | 4554 | |
7029d033 | 4555 | =item SELECTED PATCH SIZES |
cb1a09d0 | 4556 | |
7029d033 | 4557 | =back |
cb1a09d0 | 4558 | |
7029d033 | 4559 | =item THE KEEPERS OF THE RECORDS |
cb1a09d0 | 4560 | |
a45bd81d GS |
4561 | =back |
4562 | ||
603b90a8 JH |
4563 | =head2 perldelta - what will be new for perl v5.8.0 |
4564 | ||
4565 | =over 4 | |
4566 | ||
4567 | =item DESCRIPTION | |
4568 | ||
4569 | =item Reporting Bugs | |
4570 | ||
4571 | =item SEE ALSO | |
4572 | ||
4573 | =item HISTORY | |
4574 | ||
4575 | =back | |
4576 | ||
245d750e JH |
4577 | =head2 perl572delta, perl571delta - what's new for perl v5.7.2 |
4578 | ||
4579 | =over 4 | |
4580 | ||
4581 | =item DESCRIPTION | |
4582 | ||
4583 | =item Security Vulnerability Closed | |
4584 | ||
4585 | =item Incompatible Changes | |
4586 | ||
cb5953d6 JH |
4587 | =over 4 |
4588 | ||
4589 | =item 64-bit platforms and malloc | |
4590 | ||
e0539f61 JH |
4591 | =item AIX Dynaloading |
4592 | ||
4593 | =item Socket Extension Dynamic in VMS | |
4594 | ||
afd1eb53 NIS |
4595 | =item Different Definition of the Unicode Character Classes \p{In...} |
4596 | ||
e0539f61 | 4597 | =item Deprecations |
772ff3b9 | 4598 | |
cb5953d6 JH |
4599 | =back |
4600 | ||
245d750e JH |
4601 | =item Core Enhancements |
4602 | ||
4603 | =item Modules and Pragmata | |
4604 | ||
4605 | =over 4 | |
4606 | ||
afd1eb53 | 4607 | =item New Modules and Distributions |
245d750e JH |
4608 | |
4609 | =item Updated And Improved Modules and Pragmata | |
4610 | ||
4611 | =back | |
4612 | ||
245d750e JH |
4613 | =item Utility Changes |
4614 | ||
4615 | =item New Documentation | |
4616 | ||
4617 | =item Installation and Configuration Improvements | |
4618 | ||
4619 | =over 4 | |
4620 | ||
4621 | =item New Or Improved Platforms | |
4622 | ||
4623 | =item Generic Improvements | |
4624 | ||
4625 | =back | |
4626 | ||
4627 | =item Selected Bug Fixes | |
4628 | ||
4629 | =over 4 | |
4630 | ||
4631 | =item Platform Specific Changes and Fixes | |
4632 | ||
4633 | =back | |
4634 | ||
4635 | =item New or Changed Diagnostics | |
4636 | ||
354a27bf | 4637 | =item Source Code Enhancements |
245d750e JH |
4638 | |
4639 | =over 4 | |
4640 | ||
354a27bf JH |
4641 | =item MAGIC constants |
4642 | ||
4643 | =item Better commented code | |
4644 | ||
245d750e JH |
4645 | =item Regex pre-/post-compilation items matched up |
4646 | ||
354a27bf JH |
4647 | =item gcc -Wall |
4648 | ||
245d750e JH |
4649 | =back |
4650 | ||
4651 | =item New Tests | |
4652 | ||
4653 | =item Known Problems | |
4654 | ||
4655 | =over 4 | |
4656 | ||
e0539f61 JH |
4657 | =item AIX |
4658 | ||
4659 | =item Amiga Perl Invoking Mystery | |
245d750e JH |
4660 | |
4661 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
4662 | ||
e0539f61 | 4663 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 |
245d750e | 4664 | |
e0539f61 | 4665 | =item HP-UX lib/io_multihomed Fails When LP64-Configur |
245d750e | 4666 | |
e0539f61 | 4667 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
245d750e JH |
4668 | |
4669 | =item Linux With Sfio Fails op/misc Test 48 | |
4670 | ||
afd1eb53 NIS |
4671 | =item OS/390 |
4672 | ||
e0539f61 | 4673 | =item op/sprintf tests 129 and 130 |
245d750e JH |
4674 | |
4675 | =item Failure of Thread tests | |
4676 | ||
e0539f61 JH |
4677 | =item UNICOS |
4678 | ||
4679 | =item UNICOS/mk ext/IPC/SysV/t/sem test 8 | |
4680 | ||
4681 | =item UTS | |
4682 | ||
354a27bf JH |
4683 | =item VMS |
4684 | ||
245d750e JH |
4685 | =item Localising a Tied Variable Leaks Memory |
4686 | ||
4687 | =item Self-tying of Arrays and Hashes Is Forbidden | |
4688 | ||
cb5953d6 JH |
4689 | =item Variable Attributes are not Currently Usable for Tieing |
4690 | ||
245d750e JH |
4691 | =item Building Extensions Can Fail Because Of Largefiles |
4692 | ||
4693 | =item The Compiler Suite Is Still Experimental | |
4694 | ||
e0539f61 JH |
4695 | =item The Long Double Support is Still Experimental |
4696 | ||
245d750e JH |
4697 | =back |
4698 | ||
4699 | =item Reporting Bugs | |
4700 | ||
4701 | =item SEE ALSO | |
4702 | ||
4703 | =item HISTORY | |
4704 | ||
4705 | =back | |
4706 | ||
603b90a8 JH |
4707 | =head2 perl571delta - what's new for perl v5.7.1 |
4708 | ||
4709 | =over 4 | |
4710 | ||
4711 | =item DESCRIPTION | |
4712 | ||
4713 | =item Security Vulnerability Closed | |
4714 | ||
4715 | =item Incompatible Changes | |
4716 | ||
4717 | =item Core Enhancements | |
4718 | ||
245d750e JH |
4719 | =over 4 |
4720 | ||
2ca5449f JH |
4721 | =item AUTOLOAD Is Now Lvaluable |
4722 | ||
245d750e JH |
4723 | =item PerlIO is Now The Default |
4724 | ||
4725 | =item Signals Are Now Safe | |
4726 | ||
4727 | =back | |
4728 | ||
bd28ded5 | 4729 | =item Modules and Pragmata |
603b90a8 JH |
4730 | |
4731 | =over 4 | |
4732 | ||
603b90a8 JH |
4733 | =item New Modules |
4734 | ||
4735 | =item Updated And Improved Modules and Pragmata | |
4736 | ||
4737 | =back | |
4738 | ||
4739 | =item Performance Enhancements | |
4740 | ||
4741 | =item Utility Changes | |
4742 | ||
4743 | =item New Documentation | |
4744 | ||
4745 | =over 4 | |
4746 | ||
4747 | =item perlclib | |
4748 | ||
4749 | =item perliol | |
4750 | ||
4751 | =item README.aix | |
4752 | ||
4753 | =item README.bs2000 | |
4754 | ||
4755 | =item README.macos | |
4756 | ||
4757 | =item README.mpeix | |
4758 | ||
4759 | =item README.solaris | |
4760 | ||
4761 | =item README.vos | |
4762 | ||
4763 | =item Porting/repository.pod | |
4764 | ||
4765 | =back | |
4766 | ||
603b90a8 JH |
4767 | =item Installation and Configuration Improvements |
4768 | ||
4769 | =over 4 | |
4770 | ||
4771 | =item New Or Improved Platforms | |
4772 | ||
4773 | =item Generic Improvements | |
4774 | ||
bd28ded5 JH |
4775 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, |
4776 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, | |
4777 | d_strtoq, d_u32align, d_ualarm, d_usleep | |
4778 | ||
603b90a8 JH |
4779 | =back |
4780 | ||
4781 | =item Selected Bug Fixes | |
4782 | ||
4783 | =over 4 | |
4784 | ||
4785 | =item Platform Specific Changes and Fixes | |
4786 | ||
4787 | =back | |
4788 | ||
4789 | =item New or Changed Diagnostics | |
4790 | ||
4791 | =item Changed Internals | |
4792 | ||
bd28ded5 JH |
4793 | =item New Tests |
4794 | ||
603b90a8 JH |
4795 | =item Known Problems |
4796 | ||
4797 | =over 4 | |
4798 | ||
bd28ded5 JH |
4799 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl |
4800 | ||
4801 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
4802 | ||
4803 | =item lib/io_multihomed Fails In LP64-Configured HP-UX | |
4804 | ||
4805 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
4806 | ||
603b90a8 JH |
4807 | =item lib/b test 19 |
4808 | ||
bd28ded5 | 4809 | =item Linux With Sfio Fails op/misc Test 48 |
603b90a8 JH |
4810 | |
4811 | =item sigaction test 13 in VMS | |
4812 | ||
4813 | =item sprintf tests 129 and 130 | |
4814 | ||
bd28ded5 JH |
4815 | =item Failure of Thread tests |
4816 | ||
4817 | =item Localising a Tied Variable Leaks Memory | |
4818 | ||
603b90a8 JH |
4819 | =item Self-tying of Arrays and Hashes Is Forbidden |
4820 | ||
bd28ded5 JH |
4821 | =item Building Extensions Can Fail Because Of Largefiles |
4822 | ||
4823 | =item The Compiler Suite Is Still Experimental | |
4824 | ||
603b90a8 JH |
4825 | =back |
4826 | ||
4827 | =item Reporting Bugs | |
4828 | ||
4829 | =item SEE ALSO | |
4830 | ||
4831 | =item HISTORY | |
4832 | ||
4833 | =back | |
4834 | ||
4835 | =head2 perl570delta - what's new for perl v5.7.0 | |
694468e3 | 4836 | |
d420ca49 | 4837 | =over 4 |
694468e3 | 4838 | |
7029d033 | 4839 | =item DESCRIPTION |
694468e3 | 4840 | |
a9ef4385 JH |
4841 | =item Security Vulnerability Closed |
4842 | ||
4843 | =item Incompatible Changes | |
4844 | ||
7029d033 | 4845 | =item Core Enhancements |
694468e3 | 4846 | |
7029d033 | 4847 | =item Modules and Pragmata |
694468e3 | 4848 | |
d420ca49 | 4849 | =over 4 |
a9ef4385 JH |
4850 | |
4851 | =item New Modules | |
4852 | ||
4853 | =item Updated And Improved Modules and Pragmata | |
4854 | ||
4855 | =back | |
4856 | ||
7029d033 | 4857 | =item Utility Changes |
694468e3 | 4858 | |
a9ef4385 | 4859 | =item New Documentation |
694468e3 | 4860 | |
a9ef4385 | 4861 | =item Performance Enhancements |
694468e3 | 4862 | |
7029d033 | 4863 | =item Installation and Configuration Improvements |
694468e3 | 4864 | |
d420ca49 | 4865 | =over 4 |
694468e3 | 4866 | |
a9ef4385 | 4867 | =item Generic Improvements |
694468e3 | 4868 | |
4755096e | 4869 | =back |
694468e3 | 4870 | |
a9ef4385 | 4871 | =item Selected Bug Fixes |
694468e3 | 4872 | |
d420ca49 | 4873 | =over 4 |
cb1a09d0 | 4874 | |
a9ef4385 | 4875 | =item Platform Specific Changes and Fixes |
cb1a09d0 | 4876 | |
a9ef4385 | 4877 | =back |
cb1a09d0 | 4878 | |
a9ef4385 JH |
4879 | =item New or Changed Diagnostics |
4880 | ||
4881 | =item Changed Internals | |
cb1a09d0 | 4882 | |
4755096e | 4883 | =item Known Problems |
cb1a09d0 | 4884 | |
d420ca49 | 4885 | =over 4 |
a9ef4385 JH |
4886 | |
4887 | =item Unicode Support Still Far From Perfect | |
4888 | ||
4889 | =item EBCDIC Still A Lost Platform | |
4890 | ||
4891 | =item Building Extensions Can Fail Because Of Largefiles | |
4892 | ||
93d73c42 JH |
4893 | =item ftmp-security tests warn 'system possibly insecure' |
4894 | ||
b3b6085d PP |
4895 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
4896 | ||
93d73c42 | 4897 | =item Long Doubles Still Don't Work In Solaris |
9fa7f388 | 4898 | |
b3b6085d PP |
4899 | =item Linux With Sfio Fails op/misc Test 48 |
4900 | ||
9fa7f388 | 4901 | =item Storable tests fail in some platforms |
a9ef4385 | 4902 | |
93d73c42 JH |
4903 | =item Threads Are Still Experimental |
4904 | ||
4905 | =item The Compiler Suite Is Still Experimental | |
4906 | ||
a9ef4385 | 4907 | =back |
193fb0af | 4908 | |
4755096e | 4909 | =item Reporting Bugs |
8ebc5c01 | 4910 | |
4755096e | 4911 | =item SEE ALSO |
8ebc5c01 | 4912 | |
4755096e | 4913 | =item HISTORY |
8ebc5c01 | 4914 | |
a45bd81d GS |
4915 | =back |
4916 | ||
4755096e | 4917 | =head2 perl56delta, perldelta - what's new for perl v5.6.0 |
14218588 | 4918 | |
d420ca49 | 4919 | =over 4 |
a45bd81d | 4920 | |
14218588 GS |
4921 | =item DESCRIPTION |
4922 | ||
4755096e | 4923 | =item Core Enhancements |
14218588 | 4924 | |
d420ca49 | 4925 | =over 4 |
14218588 | 4926 | |
4755096e | 4927 | =item Interpreter cloning, threads, and concurrency |
14218588 | 4928 | |
4755096e | 4929 | =item Lexically scoped warning categories |
14218588 | 4930 | |
4755096e | 4931 | =item Unicode and UTF-8 support |
14218588 | 4932 | |
4755096e | 4933 | =item Support for interpolating named characters |
14218588 | 4934 | |
4755096e | 4935 | =item "our" declarations |
14218588 | 4936 | |
4755096e | 4937 | =item Support for strings represented as a vector of ordinals |
14218588 | 4938 | |
4755096e | 4939 | =item Improved Perl version numbering system |
14218588 | 4940 | |
4755096e | 4941 | =item New syntax for declaring subroutine attributes |
14218588 | 4942 | |
4755096e | 4943 | =item File and directory handles can be autovivified |
14218588 | 4944 | |
4755096e | 4945 | =item open() with more than two arguments |
14218588 | 4946 | |
4755096e | 4947 | =item 64-bit support |
14218588 | 4948 | |
4755096e | 4949 | =item Large file support |
14218588 | 4950 | |
4755096e | 4951 | =item Long doubles |
14218588 | 4952 | |
4755096e | 4953 | =item "more bits" |
14218588 | 4954 | |
4755096e | 4955 | =item Enhanced support for sort() subroutines |
14218588 | 4956 | |
4755096e | 4957 | =item C<sort $coderef @foo> allowed |
14218588 | 4958 | |
4755096e | 4959 | =item File globbing implemented internally |
14218588 | 4960 | |
4755096e | 4961 | =item Support for CHECK blocks |
14218588 | 4962 | |
4755096e | 4963 | =item POSIX character class syntax [: :] supported |
14218588 | 4964 | |
4755096e | 4965 | =item Better pseudo-random number generator |
a45bd81d | 4966 | |
4755096e | 4967 | =item Improved C<qw//> operator |
8ebc5c01 | 4968 | |
4755096e | 4969 | =item Better worst-case behavior of hashes |
a45bd81d | 4970 | |
4755096e | 4971 | =item pack() format 'Z' supported |
8ebc5c01 | 4972 | |
4755096e | 4973 | =item pack() format modifier '!' supported |
8ebc5c01 | 4974 | |
4755096e | 4975 | =item pack() and unpack() support counted strings |
8ebc5c01 | 4976 | |
4755096e | 4977 | =item Comments in pack() templates |
8ebc5c01 | 4978 | |
4755096e | 4979 | =item Weak references |
8ebc5c01 | 4980 | |
4755096e | 4981 | =item Binary numbers supported |
8ebc5c01 | 4982 | |
4755096e | 4983 | =item Lvalue subroutines |
14218588 | 4984 | |
4755096e | 4985 | =item Some arrows may be omitted in calls through references |
8ebc5c01 | 4986 | |
4755096e | 4987 | =item Boolean assignment operators are legal lvalues |
8ebc5c01 | 4988 | |
4755096e | 4989 | =item exists() is supported on subroutine names |
8ebc5c01 | 4990 | |
4755096e | 4991 | =item exists() and delete() are supported on array elements |
cb1a09d0 | 4992 | |
4755096e | 4993 | =item Pseudo-hashes work better |
cb1a09d0 | 4994 | |
4755096e | 4995 | =item Automatic flushing of output buffers |
cb1a09d0 | 4996 | |
4755096e | 4997 | =item Better diagnostics on meaningless filehandle operations |
cb1a09d0 | 4998 | |
4755096e | 4999 | =item Where possible, buffered data discarded from duped input filehandle |
a45bd81d | 5000 | |
4755096e | 5001 | =item eof() has the same old magic as <> |
cb1a09d0 | 5002 | |
4755096e | 5003 | =item binmode() can be used to set :crlf and :raw modes |
a45bd81d | 5004 | |
4755096e | 5005 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
cb1a09d0 | 5006 | |
4755096e | 5007 | =item system(), backticks and pipe open now reflect exec() failure |
cb1a09d0 | 5008 | |
4755096e | 5009 | =item Improved diagnostics |
cb1a09d0 | 5010 | |
4755096e | 5011 | =item Diagnostics follow STDERR |
cb1a09d0 | 5012 | |
4755096e | 5013 | =item More consistent close-on-exec behavior |
cb1a09d0 | 5014 | |
4755096e | 5015 | =item syswrite() ease-of-use |
cb1a09d0 | 5016 | |
4755096e | 5017 | =item Better syntax checks on parenthesized unary operators |
cb1a09d0 | 5018 | |
4755096e | 5019 | =item Bit operators support full native integer width |
cb1a09d0 | 5020 | |
4755096e | 5021 | =item Improved security features |
cb1a09d0 | 5022 | |
4755096e | 5023 | =item More functional bareword prototype (*) |
cb1a09d0 | 5024 | |
4755096e | 5025 | =item C<require> and C<do> may be overridden |
cb1a09d0 | 5026 | |
4755096e | 5027 | =item $^X variables may now have names longer than one character |
4fdae800 | 5028 | |
4755096e | 5029 | =item New variable $^C reflects C<-c> switch |
cb1a09d0 | 5030 | |
4755096e | 5031 | =item New variable $^V contains Perl version as a string |
cb1a09d0 | 5032 | |
4755096e | 5033 | =item Optional Y2K warnings |
cb1a09d0 | 5034 | |
4755096e | 5035 | =item Arrays now always interpolate into double-quoted strings |
cb1a09d0 | 5036 | |
a45bd81d GS |
5037 | =back |
5038 | ||
4755096e | 5039 | =item Modules and Pragmata |
cb1a09d0 | 5040 | |
d420ca49 | 5041 | =over 4 |
a45bd81d | 5042 | |
4755096e | 5043 | =item Modules |
cb1a09d0 | 5044 | |
4755096e GS |
5045 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
5046 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
5047 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
5048 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
5049 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
5050 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
5051 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
5052 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
cb1a09d0 | 5053 | |
4755096e | 5054 | =item Pragmata |
cb1a09d0 | 5055 | |
4755096e | 5056 | =back |
cb1a09d0 | 5057 | |
4755096e | 5058 | =item Utility Changes |
cb1a09d0 | 5059 | |
d420ca49 | 5060 | =over 4 |
cb1a09d0 | 5061 | |
4755096e | 5062 | =item dprofpp |
cb1a09d0 | 5063 | |
4755096e | 5064 | =item find2perl |
cb1a09d0 | 5065 | |
4755096e | 5066 | =item h2xs |
cb1a09d0 | 5067 | |
4755096e | 5068 | =item perlcc |
cb1a09d0 | 5069 | |
4755096e GS |
5070 | =item perldoc |
5071 | ||
5072 | =item The Perl Debugger | |
cb1a09d0 | 5073 | |
a45bd81d GS |
5074 | =back |
5075 | ||
4755096e | 5076 | =item Improved Documentation |
cb1a09d0 | 5077 | |
4755096e GS |
5078 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
5079 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
5080 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
5081 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
a45bd81d | 5082 | |
4755096e | 5083 | =item Performance enhancements |
cb1a09d0 | 5084 | |
d420ca49 | 5085 | =over 4 |
cb1a09d0 | 5086 | |
4755096e | 5087 | =item Simple sort() using { $a <=> $b } and the like are optimized |
cb1a09d0 | 5088 | |
4755096e | 5089 | =item Optimized assignments to lexical variables |
193fb0af | 5090 | |
4755096e GS |
5091 | =item Faster subroutine calls |
5092 | ||
5093 | =item delete(), each(), values() and hash iteration are faster | |
193fb0af GS |
5094 | |
5095 | =back | |
5096 | ||
4755096e | 5097 | =item Installation and Configuration Improvements |
cb1a09d0 | 5098 | |
d420ca49 | 5099 | =over 4 |
cb1a09d0 | 5100 | |
4755096e | 5101 | =item -Dusethreads means something different |
68dc0745 | 5102 | |
4755096e | 5103 | =item New Configure flags |
68dc0745 | 5104 | |
4755096e | 5105 | =item Threadedness and 64-bitness now more daring |
68dc0745 | 5106 | |
4755096e | 5107 | =item Long Doubles |
cb1a09d0 | 5108 | |
4755096e | 5109 | =item -Dusemorebits |
55497cff | 5110 | |
4755096e GS |
5111 | =item -Duselargefiles |
5112 | ||
5113 | =item installusrbinperl | |
5114 | ||
5115 | =item SOCKS support | |
5116 | ||
5117 | =item C<-A> flag | |
5118 | ||
5119 | =item Enhanced Installation Directories | |
193fb0af | 5120 | |
8ebc5c01 | 5121 | =back |
5122 | ||
4755096e | 5123 | =item Platform specific changes |
55497cff | 5124 | |
d420ca49 | 5125 | =over 4 |
cb1a09d0 | 5126 | |
4755096e | 5127 | =item Supported platforms |
193fb0af | 5128 | |
4755096e | 5129 | =item DOS |
55497cff | 5130 | |
4755096e GS |
5131 | =item OS390 (OpenEdition MVS) |
5132 | ||
5133 | =item VMS | |
5134 | ||
5135 | =item Win32 | |
55497cff | 5136 | |
c90c0ff4 | 5137 | =back |
5138 | ||
4755096e | 5139 | =item Significant bug fixes |
c90c0ff4 | 5140 | |
d420ca49 | 5141 | =over 4 |
c90c0ff4 | 5142 | |
4755096e | 5143 | =item <HANDLE> on empty files |
c90c0ff4 | 5144 | |
4755096e | 5145 | =item C<eval '...'> improvements |
c90c0ff4 | 5146 | |
4755096e | 5147 | =item All compilation errors are true errors |
c90c0ff4 | 5148 | |
4755096e | 5149 | =item Implicitly closed filehandles are safer |
cb1a09d0 | 5150 | |
4755096e | 5151 | =item Behavior of list slices is more consistent |
cb1a09d0 | 5152 | |
4755096e | 5153 | =item C<(\$)> prototype and C<$foo{a}> |
cb1a09d0 | 5154 | |
4755096e | 5155 | =item C<goto &sub> and AUTOLOAD |
c90c0ff4 | 5156 | |
4755096e | 5157 | =item C<-bareword> allowed under C<use integer> |
c90c0ff4 | 5158 | |
4755096e | 5159 | =item Failures in DESTROY() |
cb1a09d0 | 5160 | |
4755096e GS |
5161 | =item Locale bugs fixed |
5162 | ||
5163 | =item Memory leaks | |
5164 | ||
5165 | =item Spurious subroutine stubs after failed subroutine calls | |
cb1a09d0 | 5166 | |
4755096e | 5167 | =item Taint failures under C<-U> |
55497cff | 5168 | |
4755096e | 5169 | =item END blocks and the C<-c> switch |
55497cff | 5170 | |
4755096e | 5171 | =item Potential to leak DATA filehandles |
55497cff | 5172 | |
a45bd81d GS |
5173 | =back |
5174 | ||
4755096e | 5175 | =item New or Changed Diagnostics |
a45bd81d | 5176 | |
4755096e GS |
5177 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
5178 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
5179 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
5180 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
5181 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
5182 | passed through, /%s/ should probably be written as "%s", %s() called too | |
5183 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
5184 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
5185 | subroutine name, %s package attribute may clash with future reserved word: | |
5186 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
5187 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
5188 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
5189 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
5190 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
5191 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
5192 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
5193 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
5194 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
5195 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
5196 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
5197 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
5198 | "local" instead of "our"?), Document contains no data, entering effective | |
5199 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
5200 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
5201 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
5202 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
5203 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
5204 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
5205 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
5206 | separator character %s in attribute list, Invalid separator character %s in | |
5207 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
5208 | returning %s not implemented yet, Method %s not permitted, Missing | |
5209 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
5210 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
5211 | No space allowed after -%c, no UTC offset information; assuming local time | |
5212 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
5213 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
5214 | around "%s" list, Possible unintended interpolation of %s in string, | |
5215 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
5216 | instead, Premature end of script headers, Repeat count in pack overflows, | |
5217 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
5218 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
5219 | zero-length expression, switching effective %s is not implemented, This | |
5220 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
5221 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
5222 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
5223 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
5224 | list, Unterminated attribute list, Unterminated attribute parameter in | |
5225 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
5226 | CLI symbol "%s" too long, Version number must be a constant number | |
14218588 | 5227 | |
4755096e | 5228 | =item New tests |
14218588 | 5229 | |
4755096e | 5230 | =item Incompatible Changes |
14218588 | 5231 | |
d420ca49 | 5232 | =over 4 |
14218588 | 5233 | |
4755096e | 5234 | =item Perl Source Incompatibilities |
14218588 | 5235 | |
4755096e GS |
5236 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
5237 | Format of $English::PERL_VERSION is different, Literals of the form | |
5238 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
5239 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
5240 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
983dbef6 JH |
5241 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
5242 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
5243 | Text of some diagnostic output has changed, C<%@> has been removed, | |
5244 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
5245 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
5246 | on 64-bit platforms, More builtins taint their results | |
14218588 | 5247 | |
4755096e | 5248 | =item C Source Incompatibilities |
14218588 | 5249 | |
4755096e | 5250 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
14218588 | 5251 | |
4755096e | 5252 | =item Compatible C Source API Changes |
a45bd81d | 5253 | |
4755096e | 5254 | C<PATCHLEVEL> is now C<PERL_VERSION> |
55497cff | 5255 | |
4755096e | 5256 | =item Binary Incompatibilities |
a45bd81d | 5257 | |
4755096e | 5258 | =back |
55497cff | 5259 | |
4755096e | 5260 | =item Known Problems |
55497cff | 5261 | |
d420ca49 | 5262 | =over 4 |
55497cff | 5263 | |
4755096e | 5264 | =item Thread test failures |
b38f6a39 | 5265 | |
4755096e | 5266 | =item EBCDIC platforms not supported |
774d564b | 5267 | |
4755096e | 5268 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
774d564b | 5269 | |
4755096e | 5270 | =item NEXTSTEP 3.3 POSIX test failure |
774d564b | 5271 | |
4755096e GS |
5272 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
5273 | gcc | |
cb1a09d0 | 5274 | |
4755096e | 5275 | =item UNICOS/mk CC failures during Configure run |
cb1a09d0 | 5276 | |
4755096e | 5277 | =item Arrow operator and arrays |
cb1a09d0 | 5278 | |
4755096e | 5279 | =item Experimental features |
cb1a09d0 | 5280 | |
4755096e GS |
5281 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
5282 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
983dbef6 | 5283 | globbing, The DB module, The regular expression code constructs: |
cb1a09d0 | 5284 | |
b38f6a39 | 5285 | =back |
cb1a09d0 | 5286 | |
4755096e | 5287 | =item Obsolete Diagnostics |
b38f6a39 | 5288 | |
4755096e GS |
5289 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
5290 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
5291 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
5292 | to mean "${$}<digit>" is deprecated | |
5293 | ||
5294 | =item Reporting Bugs | |
cb1a09d0 | 5295 | |
b38f6a39 | 5296 | =item SEE ALSO |
cb1a09d0 | 5297 | |
4755096e | 5298 | =item HISTORY |
193fb0af | 5299 | |
8ebc5c01 | 5300 | =back |
cb1a09d0 | 5301 | |
4755096e | 5302 | =head2 perl5005delta, perldelta - what's new for perl5.005 |
193fb0af | 5303 | |
d420ca49 | 5304 | =over 4 |
193fb0af | 5305 | |
b38f6a39 | 5306 | =item DESCRIPTION |
193fb0af | 5307 | |
4755096e | 5308 | =item About the new versioning system |
193fb0af | 5309 | |
4755096e | 5310 | =item Incompatible Changes |
193fb0af | 5311 | |
d420ca49 | 5312 | =over 4 |
b38f6a39 | 5313 | |
4755096e | 5314 | =item WARNING: This version is not binary compatible with Perl 5.004. |
b38f6a39 | 5315 | |
4755096e | 5316 | =item Default installation structure has changed |
b38f6a39 | 5317 | |
4755096e | 5318 | =item Perl Source Compatibility |
193fb0af | 5319 | |
4755096e | 5320 | =item C Source Compatibility |
b38f6a39 | 5321 | |
4755096e | 5322 | =item Binary Compatibility |
b38f6a39 | 5323 | |
4755096e | 5324 | =item Security fixes may affect compatibility |
b38f6a39 | 5325 | |
4755096e | 5326 | =item Relaxed new mandatory warnings introduced in 5.004 |
b38f6a39 | 5327 | |
4755096e | 5328 | =item Licensing |
193fb0af GS |
5329 | |
5330 | =back | |
cb1a09d0 | 5331 | |
4755096e | 5332 | =item Core Changes |
fb9cefb4 | 5333 | |
d420ca49 | 5334 | =over 4 |
fb9cefb4 | 5335 | |
4755096e | 5336 | =item Threads |
fb9cefb4 | 5337 | |
4755096e | 5338 | =item Compiler |
fb9cefb4 | 5339 | |
4755096e | 5340 | =item Regular Expressions |
fb9cefb4 | 5341 | |
4755096e GS |
5342 | Many new and improved optimizations, Many bug fixes, New regular expression |
5343 | constructs, New operator for precompiled regular expressions, Other | |
5344 | improvements, Incompatible changes | |
fb9cefb4 | 5345 | |
4755096e | 5346 | =item Improved malloc() |
fb9cefb4 | 5347 | |
4755096e | 5348 | =item Quicksort is internally implemented |
ac65edd0 | 5349 | |
4755096e | 5350 | =item Reliable signals |
ac65edd0 | 5351 | |
4755096e | 5352 | =item Reliable stack pointers |
ac65edd0 | 5353 | |
4755096e | 5354 | =item More generous treatment of carriage returns |
ac65edd0 | 5355 | |
4755096e | 5356 | =item Memory leaks |
ac65edd0 | 5357 | |
4755096e | 5358 | =item Better support for multiple interpreters |
ac65edd0 | 5359 | |
4755096e | 5360 | =item Behavior of local() on array and hash elements is now well-defined |
ac65edd0 | 5361 | |
4755096e | 5362 | =item C<%!> is transparently tied to the L<Errno> module |
ac65edd0 | 5363 | |
4755096e | 5364 | =item Pseudo-hashes are supported |
b38f6a39 | 5365 | |
4755096e | 5366 | =item C<EXPR foreach EXPR> is supported |
ac65edd0 | 5367 | |
4755096e | 5368 | =item Keywords can be globally overridden |
ac65edd0 | 5369 | |
4755096e | 5370 | =item C<$^E> is meaningful on Win32 |
ac65edd0 | 5371 | |
4755096e | 5372 | =item C<foreach (1..1000000)> optimized |
cb1a09d0 | 5373 | |
4755096e | 5374 | =item C<Foo::> can be used as implicitly quoted package name |
a45bd81d | 5375 | |
4755096e | 5376 | =item C<exists $Foo::{Bar::}> tests existence of a package |
cb1a09d0 | 5377 | |
4755096e | 5378 | =item Better locale support |
a45bd81d | 5379 | |
4755096e | 5380 | =item Experimental support for 64-bit platforms |
cb1a09d0 | 5381 | |
4755096e | 5382 | =item prototype() returns useful results on builtins |
a45bd81d | 5383 | |
4755096e | 5384 | =item Extended support for exception handling |
cb1a09d0 | 5385 | |
4755096e | 5386 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods |
cb1a09d0 | 5387 | |
4755096e | 5388 | =item All C<printf> format conversions are handled internally |
55497cff | 5389 | |
4755096e | 5390 | =item New C<INIT> keyword |
b971f6e4 | 5391 | |
4755096e | 5392 | =item New C<lock> keyword |
cb1a09d0 | 5393 | |
4755096e | 5394 | =item New C<qr//> operator |
a6006777 | 5395 | |
4755096e | 5396 | =item C<our> is now a reserved word |
68dc0745 | 5397 | |
4755096e | 5398 | =item Tied arrays are now fully supported |
cb1a09d0 | 5399 | |
4755096e GS |
5400 | =item Tied handles support is better |
5401 | ||
5402 | =item 4th argument to substr | |
5403 | ||
5404 | =item Negative LENGTH argument to splice | |
5405 | ||
5406 | =item Magic lvalues are now more magical | |
5407 | ||
5408 | =item <> now reads in records | |
193fb0af | 5409 | |
a45bd81d GS |
5410 | =back |
5411 | ||
4755096e | 5412 | =item Supported Platforms |
cb1a09d0 | 5413 | |
d420ca49 | 5414 | =over 4 |
a45bd81d | 5415 | |
4755096e | 5416 | =item New Platforms |
cb1a09d0 | 5417 | |
4755096e | 5418 | =item Changes in existing support |
cb1a09d0 | 5419 | |
4755096e | 5420 | =back |
cb1a09d0 | 5421 | |
4755096e | 5422 | =item Modules and Pragmata |
cb1a09d0 | 5423 | |
d420ca49 | 5424 | =over 4 |
cb1a09d0 | 5425 | |
4755096e | 5426 | =item New Modules |
cb1a09d0 | 5427 | |
4755096e GS |
5428 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, |
5429 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
5430 | Thread, attrs, fields, re | |
cb1a09d0 | 5431 | |
4755096e | 5432 | =item Changes in existing modules |
cb1a09d0 | 5433 | |
4755096e | 5434 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, |
4d4e713d | 5435 | MakeMaker, CPAN, Cwd |
cb1a09d0 | 5436 | |
4755096e | 5437 | =back |
cb1a09d0 | 5438 | |
4755096e | 5439 | =item Utility Changes |
cb1a09d0 | 5440 | |
4755096e GS |
5441 | =item Documentation Changes |
5442 | ||
5443 | =item New Diagnostics | |
5444 | ||
5445 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
5446 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
5447 | package, Can't call method "%s" on an undefined value, Can't check | |
5448 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
5449 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
5450 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
5451 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
5452 | Character class syntax [: :] is reserved for future extensions, Character | |
5453 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
5454 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
5455 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
5456 | package main), Illegal hex digit ignored, No such array field, No such | |
5457 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
5458 | large request, Range iterator outside integer range, Recursive inheritance | |
ab648d5e JH |
5459 | detected while looking for method '%s' %s, Reference found where even-sized |
5460 | list expected, Undefined value assigned to typeglob, Use of reserved word | |
5461 | "%s" is deprecated, perl: warning: Setting locale failed | |
cb1a09d0 | 5462 | |
4755096e | 5463 | =item Obsolete Diagnostics |
cb1a09d0 | 5464 | |
4755096e GS |
5465 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open |
5466 | temporary file, regexp too big | |
cb1a09d0 | 5467 | |
4755096e | 5468 | =item Configuration Changes |
cb1a09d0 | 5469 | |
4755096e | 5470 | =item BUGS |
cb1a09d0 | 5471 | |
4755096e | 5472 | =item SEE ALSO |
cb1a09d0 | 5473 | |
4755096e | 5474 | =item HISTORY |
cb1a09d0 | 5475 | |
4755096e | 5476 | =back |
cb1a09d0 | 5477 | |
4755096e | 5478 | =head2 perl5004delta, perldelta - what's new for perl5.004 |
cb1a09d0 | 5479 | |
d420ca49 | 5480 | =over 4 |
cb1a09d0 | 5481 | |
4755096e | 5482 | =item DESCRIPTION |
cb1a09d0 | 5483 | |
4755096e | 5484 | =item Supported Environments |
cb1a09d0 | 5485 | |
4755096e | 5486 | =item Core Changes |
cb1a09d0 | 5487 | |
d420ca49 | 5488 | =over 4 |
cb1a09d0 | 5489 | |
4755096e | 5490 | =item List assignment to %ENV works |
cb1a09d0 | 5491 | |
d420ca49 | 5492 | =item Change to "Can't locate Foo.pm in @INC" error |
cb1a09d0 | 5493 | |
4755096e | 5494 | =item Compilation option: Binary compatibility with 5.003 |
cb1a09d0 | 5495 | |
4755096e | 5496 | =item $PERL5OPT environment variable |
cb1a09d0 | 5497 | |
4755096e | 5498 | =item Limitations on B<-M>, B<-m>, and B<-T> options |
cb1a09d0 | 5499 | |
4755096e | 5500 | =item More precise warnings |
cb1a09d0 | 5501 | |
4755096e | 5502 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods |
cb1a09d0 | 5503 | |
4755096e | 5504 | =item Previously deprecated %OVERLOAD is no longer usable |
cb1a09d0 | 5505 | |
4755096e | 5506 | =item Subroutine arguments created only when they're modified |
cb1a09d0 | 5507 | |
4755096e | 5508 | =item Group vector changeable with C<$)> |
a45bd81d | 5509 | |
4755096e | 5510 | =item Fixed parsing of $$<digit>, &$<digit>, etc. |
fb9cefb4 | 5511 | |
4755096e | 5512 | =item Fixed localization of $<digit>, $&, etc. |
a45bd81d | 5513 | |
4755096e | 5514 | =item No resetting of $. on implicit close |
fb9cefb4 | 5515 | |
4755096e | 5516 | =item C<wantarray> may return undef |
fb9cefb4 | 5517 | |
4755096e | 5518 | =item C<eval EXPR> determines value of EXPR in scalar context |
fb9cefb4 | 5519 | |
4755096e | 5520 | =item Changes to tainting checks |
fb9cefb4 | 5521 | |
4755096e GS |
5522 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No |
5523 | spawning if tainted $TERM doesn't look like a terminal name | |
fb9cefb4 | 5524 | |
4755096e | 5525 | =item New Opcode module and revised Safe module |
14218588 | 5526 | |
4755096e | 5527 | =item Embedding improvements |
fb9cefb4 | 5528 | |
4755096e | 5529 | =item Internal change: FileHandle class based on IO::* classes |
fb9cefb4 | 5530 | |
4755096e | 5531 | =item Internal change: PerlIO abstraction interface |
fb9cefb4 | 5532 | |
4755096e | 5533 | =item New and changed syntax |
fb9cefb4 | 5534 | |
4755096e | 5535 | $coderef->(PARAMS) |
fb9cefb4 | 5536 | |
4755096e | 5537 | =item New and changed builtin constants |
fb9cefb4 | 5538 | |
4755096e | 5539 | __PACKAGE__ |
14218588 | 5540 | |
4755096e | 5541 | =item New and changed builtin variables |
14218588 | 5542 | |
4755096e | 5543 | $^E, $^H, $^M |
fb9cefb4 | 5544 | |
4755096e | 5545 | =item New and changed builtin functions |
fb9cefb4 | 5546 | |
4755096e GS |
5547 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in |
5548 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
5549 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
5550 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
5551 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
fb9cefb4 | 5552 | |
4755096e | 5553 | =item New builtin methods |
fb9cefb4 | 5554 | |
4755096e | 5555 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
fb9cefb4 | 5556 | |
4755096e | 5557 | =item TIEHANDLE now supported |
fb9cefb4 | 5558 | |
4755096e GS |
5559 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this |
5560 | LIST, READLINE this, GETC this, DESTROY this | |
fb9cefb4 | 5561 | |
4755096e | 5562 | =item Malloc enhancements |
fb9cefb4 | 5563 | |
4755096e | 5564 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE |
fb9cefb4 | 5565 | |
4755096e | 5566 | =item Miscellaneous efficiency enhancements |
fb9cefb4 | 5567 | |
4755096e | 5568 | =back |
fb9cefb4 | 5569 | |
4755096e | 5570 | =item Support for More Operating Systems |
fb9cefb4 | 5571 | |
d420ca49 | 5572 | =over 4 |
fb9cefb4 | 5573 | |
4755096e | 5574 | =item Win32 |
14218588 | 5575 | |
4755096e | 5576 | =item Plan 9 |
fb9cefb4 | 5577 | |
4755096e | 5578 | =item QNX |
fb9cefb4 | 5579 | |
4755096e | 5580 | =item AmigaOS |
fb9cefb4 | 5581 | |
fb9cefb4 GS |
5582 | =back |
5583 | ||
4755096e GS |
5584 | =item Pragmata |
5585 | ||
5586 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
5587 | constant NAME => VALUE, use locale, use ops, use vmsish | |
5588 | ||
5589 | =item Modules | |
fb9cefb4 | 5590 | |
d420ca49 | 5591 | =over 4 |
fb9cefb4 | 5592 | |
4755096e | 5593 | =item Required Updates |
fb9cefb4 | 5594 | |
4755096e | 5595 | =item Installation directories |
fb9cefb4 | 5596 | |
4755096e | 5597 | =item Module information summary |
fb9cefb4 | 5598 | |
4755096e | 5599 | =item Fcntl |
14218588 | 5600 | |
4755096e | 5601 | =item IO |
14218588 | 5602 | |
4755096e | 5603 | =item Math::Complex |
b38f6a39 | 5604 | |
4755096e | 5605 | =item Math::Trig |
37590e52 | 5606 | |
4755096e | 5607 | =item DB_File |
fb9cefb4 | 5608 | |
4755096e GS |
5609 | =item Net::Ping |
5610 | ||
5611 | =item Object-oriented overrides for builtin operators | |
fb9cefb4 | 5612 | |
a45bd81d GS |
5613 | =back |
5614 | ||
4755096e | 5615 | =item Utility Changes |
cb1a09d0 | 5616 | |
d420ca49 | 5617 | =over 4 |
a45bd81d | 5618 | |
4755096e | 5619 | =item pod2html |
a45bd81d | 5620 | |
4755096e | 5621 | Sends converted HTML to standard output |
cb1a09d0 | 5622 | |
4755096e | 5623 | =item xsubpp |
a45bd81d | 5624 | |
4755096e | 5625 | C<void> XSUBs now default to returning nothing |
cb1a09d0 | 5626 | |
4755096e | 5627 | =back |
d516a115 | 5628 | |
4755096e | 5629 | =item C Language API Changes |
d516a115 | 5630 | |
4755096e GS |
5631 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for |
5632 | manipulating hashes | |
d516a115 | 5633 | |
4755096e | 5634 | =item Documentation Changes |
d516a115 | 5635 | |
4755096e GS |
5636 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, |
5637 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
d516a115 | 5638 | |
4755096e | 5639 | =item New Diagnostics |
cb1a09d0 | 5640 | |
4755096e GS |
5641 | "my" variable %s masks earlier declaration in same scope, %s argument is |
5642 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
5643 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
5644 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
5645 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
5646 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
5647 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
5648 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
5649 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
5650 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
5651 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
5652 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
5653 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
5654 | possible typo, Null picture in formline, Offset outside string, Out of | |
5655 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
5656 | attempt to put comments in qw() list, Possible attempt to separate words | |
5657 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
ab648d5e JH |
5658 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" |
5659 | option, untie attempted while %d inner references still exist, Unrecognized | |
5660 | character %s, Unsupported function fork, Use of "$$<digit>" to mean | |
5661 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), | |
5662 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, | |
5663 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, | |
5664 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too | |
5665 | long, Process terminated by SIG%s | |
cb1a09d0 | 5666 | |
4755096e | 5667 | =item BUGS |
d516a115 | 5668 | |
8ebc5c01 | 5669 | =item SEE ALSO |
cb1a09d0 | 5670 | |
4755096e | 5671 | =item HISTORY |
cb1a09d0 | 5672 | |
a45bd81d GS |
5673 | =back |
5674 | ||
37d4d706 JH |
5675 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems |
5676 | ||
d420ca49 | 5677 | =over 4 |
37d4d706 JH |
5678 | |
5679 | =item DESCRIPTION | |
5680 | ||
d420ca49 | 5681 | =over 4 |
37d4d706 JH |
5682 | |
5683 | =item Compiling Perl 5 on AIX | |
5684 | ||
5685 | =item OS level | |
5686 | ||
5687 | =item Building Dynamic Extensions on AIX | |
5688 | ||
5689 | =item The IBM ANSI C Compiler | |
5690 | ||
5691 | =item Using GNU's gcc for building perl | |
5692 | ||
5693 | =item Using Large Files with Perl | |
5694 | ||
5695 | =item Threaded Perl | |
5696 | ||
5697 | =item 64-bit Perl | |
5698 | ||
5699 | =item GDBM and Threads | |
5700 | ||
5701 | =item NFS filesystems and utime(2) | |
5702 | ||
5703 | =back | |
5704 | ||
5705 | =item AUTHOR | |
5706 | ||
5707 | =item DATE | |
5708 | ||
5709 | =back | |
5710 | ||
a83b6f46 JH |
5711 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS |
5712 | ||
5713 | =over 4 | |
5714 | ||
5715 | =item DESCRIPTION | |
5716 | ||
5717 | =item AUTHOR | |
5718 | ||
5719 | =back | |
5720 | ||
165c0277 | 5721 | =head2 perlamiga - Perl under Amiga OS |
cb1a09d0 | 5722 | |
d420ca49 | 5723 | =over 4 |
a45bd81d | 5724 | |
4755096e | 5725 | =item SYNOPSIS |
cb1a09d0 | 5726 | |
a45bd81d GS |
5727 | =back |
5728 | ||
d420ca49 | 5729 | =over 4 |
a45bd81d | 5730 | |
8ebc5c01 | 5731 | =item DESCRIPTION |
cb1a09d0 | 5732 | |
d420ca49 | 5733 | =over 4 |
cb1a09d0 | 5734 | |
a83b6f46 | 5735 | =item Prerequisites for Compiling Perl on AmigaOS |
cb1a09d0 | 5736 | |
4755096e | 5737 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> |
cb1a09d0 | 5738 | |
4755096e | 5739 | =item Starting Perl programs under AmigaOS |
cb1a09d0 | 5740 | |
4755096e | 5741 | =item Shortcomings of Perl under AmigaOS |
cb1a09d0 | 5742 | |
4755096e | 5743 | =back |
cb1a09d0 | 5744 | |
4755096e | 5745 | =item INSTALLATION |
cb1a09d0 | 5746 | |
4755096e | 5747 | =item Accessing documentation |
cb1a09d0 | 5748 | |
d420ca49 | 5749 | =over 4 |
cb1a09d0 | 5750 | |
a83b6f46 | 5751 | =item Manpages for Perl on AmigaOS |
cb1a09d0 | 5752 | |
a83b6f46 | 5753 | =item Perl HTML Documentation on AmigaOS |
cb1a09d0 | 5754 | |
a83b6f46 | 5755 | =item Perl GNU Info Files on AmigaOS |
4755096e | 5756 | |
a83b6f46 | 5757 | =item Perl LaTeX Documentation on AmigaOS |
cb1a09d0 | 5758 | |
8ebc5c01 | 5759 | =back |
cb1a09d0 | 5760 | |
a83b6f46 | 5761 | =item BUILDING PERL ON AMIGAOS |
3e3baf6d | 5762 | |
d420ca49 | 5763 | =over 4 |
4755096e | 5764 | |
a83b6f46 | 5765 | =item Build Prerequisites for Perl on AmigaOS |
4755096e | 5766 | |
a83b6f46 | 5767 | =item Getting the Perl Source for AmigaOS |
4755096e | 5768 | |
a83b6f46 | 5769 | =item Making Perl on AmigaOS |
4755096e | 5770 | |
a83b6f46 | 5771 | =item Testing Perl on AmigaOS |
4755096e | 5772 | |
a83b6f46 | 5773 | =item Installing the built Perl on AmigaOS |
4755096e GS |
5774 | |
5775 | =back | |
cb1a09d0 | 5776 | |
165c0277 | 5777 | =item AUTHORS |
cb1a09d0 | 5778 | |
4755096e | 5779 | =item SEE ALSO |
f86702cc | 5780 | |
a45bd81d GS |
5781 | =back |
5782 | ||
a83b6f46 JH |
5783 | =head2 perlbeos, README.beos - Perl version 5 on BeOS |
5784 | ||
5785 | =over 4 | |
5786 | ||
5787 | =item DESCRIPTION | |
5788 | ||
5789 | =over 4 | |
5790 | ||
5791 | =item General Issues with Perl on BeOS | |
5792 | ||
5793 | =item BeOS Release-specific Notes | |
5794 | ||
5795 | R4 x86, R4 PPC | |
5796 | ||
5797 | =item Contact Information | |
5798 | ||
5799 | =back | |
5800 | ||
5801 | =back | |
5802 | ||
2d967e39 | 5803 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. |
dc5c060f JH |
5804 | |
5805 | =over 4 | |
5806 | ||
5807 | =item SYNOPSIS | |
5808 | ||
5809 | =item DESCRIPTION | |
5810 | ||
5811 | =over 4 | |
5812 | ||
a83b6f46 | 5813 | =item gzip on BS2000 |
dc5c060f | 5814 | |
a83b6f46 | 5815 | =item bison on BS2000 |
dc5c060f | 5816 | |
a83b6f46 | 5817 | =item Unpacking Perl Distribution on BS2000 |
dc5c060f | 5818 | |
a83b6f46 | 5819 | =item Compiling Perl on BS2000 |
dc5c060f | 5820 | |
a83b6f46 | 5821 | =item Testing Perl on BS2000 |
dc5c060f | 5822 | |
a83b6f46 | 5823 | =item Installing Perl on BS2000 |
dc5c060f | 5824 | |
a83b6f46 | 5825 | =item Using Perl in the Posix-Shell of BS2000 |
2d967e39 JH |
5826 | |
5827 | =item Using Perl in "native" BS2000 | |
dc5c060f | 5828 | |
a83b6f46 | 5829 | =item Floating point anomalies on BS2000 |
dc5c060f JH |
5830 | |
5831 | =back | |
5832 | ||
5833 | =item AUTHORS | |
5834 | ||
5835 | =item SEE ALSO | |
5836 | ||
5837 | =over 4 | |
5838 | ||
5839 | =item Mailing list | |
5840 | ||
5841 | =back | |
5842 | ||
5843 | =item HISTORY | |
5844 | ||
5845 | =back | |
5846 | ||
4755096e | 5847 | =head2 perlcygwin, README.cygwin - Perl for Cygwin |
cb1a09d0 | 5848 | |
d420ca49 | 5849 | =over 4 |
a45bd81d | 5850 | |
8ebc5c01 | 5851 | =item SYNOPSIS |
cb1a09d0 | 5852 | |
a83b6f46 | 5853 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN |
cb1a09d0 | 5854 | |
d420ca49 | 5855 | =over 4 |
cb1a09d0 | 5856 | |
4755096e | 5857 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
cb1a09d0 | 5858 | |
4755096e | 5859 | =item Cygwin Configuration |
cb1a09d0 | 5860 | |
4755096e | 5861 | C<PATH>, I<nroff>, Permissions |
cb1a09d0 | 5862 | |
a45bd81d GS |
5863 | =back |
5864 | ||
a83b6f46 | 5865 | =item CONFIGURE PERL ON CYGWIN |
cb1a09d0 | 5866 | |
d420ca49 | 5867 | =over 4 |
a45bd81d | 5868 | |
a83b6f46 | 5869 | =item Stripping Perl Binaries on Cygwin |
cb1a09d0 | 5870 | |
a83b6f46 | 5871 | =item Optional Libraries for Perl on Cygwin |
cb1a09d0 | 5872 | |
4755096e GS |
5873 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), |
5874 | C<-lcygipc> (C<use IPC::SysV>) | |
cb1a09d0 | 5875 | |
a83b6f46 | 5876 | =item Configure-time Options for Perl on Cygwin |
cb1a09d0 | 5877 | |
4755096e GS |
5878 | C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>, |
5879 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles> | |
cb1a09d0 | 5880 | |
a83b6f46 | 5881 | =item Suspicious Warnings on Cygwin |
cb1a09d0 | 5882 | |
74cac757 | 5883 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines |
cb1a09d0 | 5884 | |
4755096e | 5885 | =back |
cb1a09d0 | 5886 | |
a83b6f46 | 5887 | =item MAKE ON CYGWIN |
cb1a09d0 | 5888 | |
d420ca49 | 5889 | =over 4 |
cb1a09d0 | 5890 | |
a83b6f46 | 5891 | =item Warnings on Cygwin |
cb1a09d0 | 5892 | |
a83b6f46 | 5893 | =item ld2 on Cygwin |
7d2bfb28 | 5894 | |
4755096e | 5895 | =back |
cb1a09d0 | 5896 | |
a83b6f46 | 5897 | =item TEST ON CYGWIN |
cb1a09d0 | 5898 | |
d420ca49 | 5899 | =over 4 |
cb1a09d0 | 5900 | |
a83b6f46 | 5901 | =item File Permissions on Cygwin |
7d2bfb28 | 5902 | |
a83b6f46 | 5903 | =item Hard Links on Cygwin |
7d2bfb28 | 5904 | |
a83b6f46 | 5905 | =item Filetime Granularity on Cygwin |
7d2bfb28 | 5906 | |
a83b6f46 | 5907 | =item Tainting Checks on Cygwin |
cb1a09d0 | 5908 | |
a83b6f46 | 5909 | =item /etc/group on Cygwin |
193fb0af | 5910 | |
a83b6f46 | 5911 | =item Script Portability on Cygwin |
cb1a09d0 | 5912 | |
4755096e | 5913 | Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous |
cb1a09d0 | 5914 | |
4755096e | 5915 | =back |
cb1a09d0 | 5916 | |
a83b6f46 | 5917 | =item INSTALL PERL ON CYGWIN |
cb1a09d0 | 5918 | |
a83b6f46 | 5919 | =item MANIFEST ON CYGWIN |
cb1a09d0 | 5920 | |
4755096e GS |
5921 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl |
5922 | Source, Compiled Module Source, Perl Modules/Scripts | |
7d2bfb28 | 5923 | |
a83b6f46 | 5924 | =item BUGS ON CYGWIN |
7d2bfb28 | 5925 | |
4755096e | 5926 | =item AUTHORS |
7d2bfb28 | 5927 | |
4755096e | 5928 | =item HISTORY |
7d2bfb28 | 5929 | |
4755096e | 5930 | =back |
193fb0af | 5931 | |
245d750e JH |
5932 | =head2 perldgux - Perl under DG/UX. |
5933 | ||
5934 | =over 4 | |
5935 | ||
5936 | =item SYNOPSIS | |
5937 | ||
5938 | =back | |
5939 | ||
5940 | =over 4 | |
5941 | ||
5942 | =item DESCRIPTION | |
5943 | ||
a83b6f46 | 5944 | =item BUILDING PERL ON DG/UX |
245d750e JH |
5945 | |
5946 | =over 4 | |
5947 | ||
a83b6f46 | 5948 | =item Non-threaded Perl on DG/UX |
245d750e | 5949 | |
a83b6f46 | 5950 | =item Threaded Perl on DG/UX |
245d750e | 5951 | |
a83b6f46 | 5952 | =item Testing Perl on DG/UX |
245d750e | 5953 | |
a83b6f46 | 5954 | =item Installing the built perl on DG/UX |
245d750e JH |
5955 | |
5956 | =back | |
5957 | ||
5958 | =item AUTHOR | |
5959 | ||
5960 | =item SEE ALSO | |
5961 | ||
5962 | =back | |
5963 | ||
9a997319 JH |
5964 | =head2 perlepoc, README.epoc - Perl for EPOC |
5965 | ||
d420ca49 | 5966 | =over 4 |
9a997319 JH |
5967 | |
5968 | =item SYNOPSIS | |
5969 | ||
5970 | =item INTRODUCTION | |
5971 | ||
5972 | =item INSTALLING PERL ON EPOC | |
5973 | ||
2d967e39 JH |
5974 | =item STARTING PERL ON EPOC |
5975 | ||
5976 | =item STOPPING PERL ON EPOC | |
5977 | ||
9a997319 JH |
5978 | =item USING PERL ON EPOC |
5979 | ||
d420ca49 | 5980 | =over 4 |
9a997319 | 5981 | |
a83b6f46 | 5982 | =item I/O Redirection on Epoc |
9a997319 | 5983 | |
a83b6f46 | 5984 | =item PATH Names on Epoc |
9a997319 | 5985 | |
a83b6f46 | 5986 | =item Editors on Epoc |
9a997319 | 5987 | |
a83b6f46 | 5988 | =item Features of Perl on Epoc |
9a997319 | 5989 | |
a83b6f46 | 5990 | =item Restrictions of Perl on Epoc |
9a997319 JH |
5991 | |
5992 | =item Compiling Perl 5 on the EPOC cross compiling environment | |
5993 | ||
5994 | =back | |
5995 | ||
a83b6f46 | 5996 | =item SUPPORT STATUS OF PERL ON EPOC |
9a997319 JH |
5997 | |
5998 | =item AUTHOR | |
5999 | ||
6000 | =item LAST UPDATE | |
6001 | ||
6002 | =back | |
6003 | ||
4755096e GS |
6004 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix |
6005 | (HP-UX) systems | |
cb1a09d0 | 6006 | |
d420ca49 | 6007 | =over 4 |
a45bd81d | 6008 | |
cb1a09d0 AD |
6009 | =item DESCRIPTION |
6010 | ||
d420ca49 | 6011 | =over 4 |
7d2bfb28 | 6012 | |
4755096e | 6013 | =item Compiling Perl 5 on HP-UX |
7d2bfb28 | 6014 | |
4755096e | 6015 | =item PA-RISC |
cb1a09d0 | 6016 | |
4755096e | 6017 | =item PA-RISC 1.0 |
cb1a09d0 | 6018 | |
4755096e | 6019 | =item PA-RISC 1.1 |
cb1a09d0 | 6020 | |
4755096e | 6021 | =item PA-RISC 2.0 |
cb1a09d0 | 6022 | |
4755096e | 6023 | =item Portability Between PA-RISC Versions |
cb1a09d0 | 6024 | |
a83b6f46 | 6025 | =item Itanium Processor Family and HP-UX |
772ff3b9 | 6026 | |
4755096e | 6027 | =item Building Dynamic Extensions on HP-UX |
cb1a09d0 | 6028 | |
4755096e | 6029 | =item The HP ANSI C Compiler |
cb1a09d0 | 6030 | |
a83b6f46 | 6031 | =item Using Large Files with Perl on HP-UX |
cb1a09d0 | 6032 | |
a83b6f46 | 6033 | =item Threaded Perl on HP-UX |
cb1a09d0 | 6034 | |
a83b6f46 | 6035 | =item 64-bit Perl on HP-UX |
cb1a09d0 | 6036 | |
a83b6f46 | 6037 | =item GDBM and Threads on HP-UX |
cb1a09d0 | 6038 | |
a83b6f46 | 6039 | =item NFS filesystems and utime(2) on HP-UX |
7d2bfb28 | 6040 | |
a83b6f46 | 6041 | =item perl -P and // and HP-UX |
7029d033 | 6042 | |
a83b6f46 | 6043 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl |
772ff3b9 | 6044 | |
4755096e | 6045 | =back |
a45bd81d | 6046 | |
4755096e | 6047 | =item AUTHOR |
a45bd81d | 6048 | |
4755096e | 6049 | =item DATE |
7d2bfb28 | 6050 | |
4755096e | 6051 | =back |
7d2bfb28 | 6052 | |
a83b6f46 JH |
6053 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd |
6054 | ||
6055 | =over 4 | |
6056 | ||
6057 | =item DESCRIPTION | |
6058 | ||
6059 | =over 4 | |
6060 | ||
6061 | =item Known Problems with Perl on Hurd | |
6062 | ||
6063 | =back | |
6064 | ||
6065 | =item AUTHOR | |
6066 | ||
6067 | =back | |
6068 | ||
4755096e GS |
6069 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen |
6070 | systems | |
7d2bfb28 | 6071 | |
d420ca49 | 6072 | =over 4 |
7d2bfb28 | 6073 | |
4755096e | 6074 | =item DESCRIPTION |
7d2bfb28 | 6075 | |
d420ca49 | 6076 | =over 4 |
c76ac1ee | 6077 | |
4755096e | 6078 | =item Compiling Perl 5 on MachTen |
c76ac1ee | 6079 | |
a83b6f46 | 6080 | =item Failures during C<make test> on MachTen |
2e1d04bc | 6081 | |
4755096e | 6082 | op/lexassign.t, pragma/warnings.t |
c76ac1ee | 6083 | |
a83b6f46 | 6084 | =item Building external modules on MachTen |
c76ac1ee | 6085 | |
4755096e | 6086 | =back |
c76ac1ee | 6087 | |
4755096e | 6088 | =item AUTHOR |
c76ac1ee | 6089 | |
4755096e | 6090 | =item DATE |
c76ac1ee GS |
6091 | |
6092 | =back | |
6093 | ||
e42c74e1 JH |
6094 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) |
6095 | ||
6096 | =over 4 | |
6097 | ||
6098 | =item SYNOPSIS | |
6099 | ||
6100 | =item DESCRIPTION | |
6101 | ||
6102 | =item AUTHOR | |
6103 | ||
6104 | =item DATE | |
6105 | ||
6106 | =back | |
6107 | ||
a83b6f46 JH |
6108 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT |
6109 | ||
6110 | =over 4 | |
6111 | ||
6112 | =item DESCRIPTION | |
6113 | ||
6114 | =item Known problems with Perl on MiNT | |
6115 | ||
6116 | =item AUTHOR | |
6117 | ||
6118 | =back | |
6119 | ||
ab648d5e JH |
6120 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE |
6121 | ||
ab648d5e JH |
6122 | =over 4 |
6123 | ||
772ff3b9 JH |
6124 | =item SYNOPSIS |
6125 | ||
6126 | =item NOTE | |
6127 | ||
a83b6f46 | 6128 | =item What's New in Perl ffor MPE/iX |
ab648d5e | 6129 | |
a83b6f46 | 6130 | =item Welcome to Perl/iX |
772ff3b9 | 6131 | |
a83b6f46 | 6132 | =item System Requirements for Perl/iX |
ab648d5e JH |
6133 | |
6134 | =item How to Obtain Perl/iX | |
6135 | ||
a83b6f46 | 6136 | =item Perl/iX Distribution Contents Highlights |
ab648d5e | 6137 | |
772ff3b9 JH |
6138 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, |
6139 | public_html/feedback.cgi, src/perl-5.6.0-mpe | |
6140 | ||
6141 | =item How to Compile Perl/iX | |
6142 | ||
6143 | 4, 6 | |
ab648d5e JH |
6144 | |
6145 | =item Getting Started with Perl/iX | |
6146 | ||
6147 | =item MPE/iX Implementation Considerations | |
6148 | ||
a83b6f46 | 6149 | =item Known Perl/iX Bugs Under Investigation |
772ff3b9 | 6150 | |
a83b6f46 | 6151 | =item Perl/iX To-Do List |
772ff3b9 | 6152 | |
a83b6f46 | 6153 | =item Perl/iX Change History |
ab648d5e | 6154 | |
a83b6f46 | 6155 | =item AUTHOR |
772ff3b9 | 6156 | |
9038e305 JH |
6157 | =item Name |
6158 | ||
6159 | =item Description | |
6160 | ||
6161 | =item Build | |
6162 | ||
6163 | =over 4 | |
6164 | ||
6165 | =item Tools & SDK | |
6166 | ||
6167 | =item Setup | |
6168 | ||
6169 | Buildtype.bat, SetNWBld.bat, MPKBuild.bat | |
6170 | ||
6171 | =item Make | |
6172 | ||
6173 | =item Interpreter | |
6174 | ||
6175 | =item Extensions | |
6176 | ||
6177 | =back | |
6178 | ||
6179 | =item Install | |
6180 | ||
6181 | =item Build new extensions | |
6182 | ||
6183 | =item Known Issues | |
6184 | ||
6185 | =item Acknowledgements | |
6186 | ||
6187 | =item Author | |
6188 | ||
6189 | =item Date | |
6190 | ||
ab648d5e JH |
6191 | =back |
6192 | ||
4755096e | 6193 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. |
cb1a09d0 | 6194 | |
d420ca49 | 6195 | =over 4 |
c76ac1ee | 6196 | |
4755096e | 6197 | =item SYNOPSIS |
7d2bfb28 | 6198 | |
a45bd81d GS |
6199 | =back |
6200 | ||
d420ca49 AD |
6201 | =over 4 |
6202 | ||
6203 | =item DESCRIPTION | |
6204 | ||
6205 | =over 4 | |
a45bd81d | 6206 | |
4755096e | 6207 | =item Target |
cb1a09d0 | 6208 | |
4755096e | 6209 | =item Other OSes |
0a753a76 | 6210 | |
4755096e | 6211 | =item Prerequisites |
cb1a09d0 | 6212 | |
4755096e | 6213 | EMX, RSX, HPFS, pdksh |
cb1a09d0 | 6214 | |
4755096e | 6215 | =item Starting Perl programs under OS/2 (and DOS and...) |
cb1a09d0 | 6216 | |
4755096e | 6217 | =item Starting OS/2 (and DOS) programs under Perl |
cb1a09d0 | 6218 | |
4755096e | 6219 | =back |
cb1a09d0 | 6220 | |
4755096e | 6221 | =item Frequently asked questions |
cb1a09d0 | 6222 | |
d420ca49 | 6223 | =over 4 |
1e422769 | 6224 | |
4d4e713d JH |
6225 | =item "It does not work" |
6226 | ||
4755096e | 6227 | =item I cannot run external programs |
cb1a09d0 | 6228 | |
4755096e GS |
6229 | =item I cannot embed perl into my program, or use F<perl.dll> from my |
6230 | program. | |
cb1a09d0 | 6231 | |
4755096e GS |
6232 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use |
6233 | L<ExtUtils::Embed>? | |
cb1a09d0 | 6234 | |
4755096e | 6235 | =item C<``> and pipe-C<open> do not work under DOS. |
cb1a09d0 | 6236 | |
4755096e | 6237 | =item Cannot start C<find.exe "pattern" file> |
cb1a09d0 | 6238 | |
4755096e | 6239 | =back |
0a753a76 | 6240 | |
4755096e | 6241 | =item INSTALLATION |
cb1a09d0 | 6242 | |
d420ca49 | 6243 | =over 4 |
cb1a09d0 | 6244 | |
4755096e | 6245 | =item Automatic binary installation |
cb1a09d0 | 6246 | |
4755096e | 6247 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> |
cb1a09d0 | 6248 | |
4755096e | 6249 | =item Manual binary installation |
3e3baf6d | 6250 | |
4755096e GS |
6251 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable |
6252 | (statically linked), Executables for Perl utilities, Main Perl library, | |
6253 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
6254 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
6255 | Perl manual in F<.INF> format, Pdksh | |
d516a115 | 6256 | |
4755096e | 6257 | =item B<Warning> |
d516a115 | 6258 | |
0a753a76 | 6259 | =back |
6260 | ||
4755096e | 6261 | =item Accessing documentation |
0a753a76 | 6262 | |
d420ca49 | 6263 | =over 4 |
cb1a09d0 | 6264 | |
4755096e | 6265 | =item OS/2 F<.INF> file |
cb1a09d0 | 6266 | |
4755096e | 6267 | =item Plain text |
cb1a09d0 | 6268 | |
4755096e | 6269 | =item Manpages |
cb1a09d0 | 6270 | |
4755096e | 6271 | =item HTML |
cb1a09d0 | 6272 | |
4755096e | 6273 | =item GNU C<info> files |
cb1a09d0 | 6274 | |
4755096e | 6275 | =item F<.PDF> files |
cb1a09d0 | 6276 | |
4755096e | 6277 | =item C<LaTeX> docs |
cb1a09d0 | 6278 | |
0a753a76 | 6279 | =back |
6280 | ||
4755096e | 6281 | =item BUILD |
0a753a76 | 6282 | |
d420ca49 | 6283 | =over 4 |
0a753a76 | 6284 | |
4d4e713d JH |
6285 | =item The short story |
6286 | ||
4755096e | 6287 | =item Prerequisites |
0a753a76 | 6288 | |
4755096e | 6289 | =item Getting perl source |
0a753a76 | 6290 | |
4755096e | 6291 | =item Application of the patches |
0a753a76 | 6292 | |
4755096e | 6293 | =item Hand-editing |
0a753a76 | 6294 | |
4755096e | 6295 | =item Making |
0a753a76 | 6296 | |
4755096e GS |
6297 | =item Testing |
6298 | ||
6299 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, | |
4d4e713d | 6300 | F<op/stat.t> |
4755096e GS |
6301 | |
6302 | =item Installing the built perl | |
6303 | ||
6304 | =item C<a.out>-style build | |
0a753a76 | 6305 | |
6306 | =back | |
6307 | ||
4755096e | 6308 | =item Build FAQ |
c76ac1ee | 6309 | |
d420ca49 | 6310 | =over 4 |
c76ac1ee | 6311 | |
4755096e | 6312 | =item Some C</> became C<\> in pdksh. |
c76ac1ee | 6313 | |
4755096e | 6314 | =item C<'errno'> - unresolved external |
c76ac1ee | 6315 | |
4755096e | 6316 | =item Problems with tr or sed |
c76ac1ee | 6317 | |
4755096e | 6318 | =item Some problem (forget which ;-) |
c76ac1ee | 6319 | |
4755096e | 6320 | =item Library ... not found |
cb1a09d0 | 6321 | |
4755096e | 6322 | =item Segfault in make |
954c1994 | 6323 | |
d396a558 JH |
6324 | =item op/sprintf test failure |
6325 | ||
a45bd81d GS |
6326 | =back |
6327 | ||
4755096e | 6328 | =item Specific (mis)features of OS/2 port |
cb1a09d0 | 6329 | |
d420ca49 | 6330 | =over 4 |
a45bd81d | 6331 | |
4755096e | 6332 | =item C<setpriority>, C<getpriority> |
cb1a09d0 | 6333 | |
4755096e | 6334 | =item C<system()> |
cb1a09d0 | 6335 | |
4755096e | 6336 | =item C<extproc> on the first line |
cb1a09d0 | 6337 | |
4755096e | 6338 | =item Additional modules: |
cb1a09d0 | 6339 | |
4755096e GS |
6340 | =item Prebuilt methods: |
6341 | ||
6342 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, | |
6343 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
6344 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
6345 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
6346 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
4d4e713d JH |
6347 | C<Cwd::extLibpath_set( path [, type ] )>, |
6348 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, | |
6349 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, | |
6350 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, | |
6351 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, | |
6352 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)> | |
6353 | ||
6354 | =item Prebuilt variables: | |
6355 | ||
6356 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver | |
4755096e GS |
6357 | |
6358 | =item Misfeatures | |
6359 | ||
6360 | =item Modifications | |
6361 | ||
4d4e713d JH |
6362 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, |
6363 | C<flock> | |
6364 | ||
6365 | =item Identifying DLLs | |
6366 | ||
6367 | =item Centralized management of resources | |
6368 | ||
6369 | C<HAB>, C<HMQ> | |
4755096e GS |
6370 | |
6371 | =back | |
6372 | ||
6373 | =item Perl flavors | |
cb1a09d0 | 6374 | |
d420ca49 | 6375 | =over 4 |
cb1a09d0 | 6376 | |
4755096e | 6377 | =item F<perl.exe> |
54310121 | 6378 | |
4755096e | 6379 | =item F<perl_.exe> |
cb1a09d0 | 6380 | |
4755096e | 6381 | =item F<perl__.exe> |
cb1a09d0 | 6382 | |
4755096e | 6383 | =item F<perl___.exe> |
cb1a09d0 | 6384 | |
4755096e | 6385 | =item Why strange names? |
cb1a09d0 | 6386 | |
4755096e | 6387 | =item Why dynamic linking? |
cb1a09d0 | 6388 | |
4755096e | 6389 | =item Why chimera build? |
7d2bfb28 | 6390 | |
cb1a09d0 AD |
6391 | =back |
6392 | ||
4755096e | 6393 | =item ENVIRONMENT |
cb1a09d0 | 6394 | |
d420ca49 | 6395 | =over 4 |
cb1a09d0 | 6396 | |
4755096e | 6397 | =item C<PERLLIB_PREFIX> |
cb1a09d0 | 6398 | |
4755096e | 6399 | =item C<PERL_BADLANG> |
cb1a09d0 | 6400 | |
4755096e | 6401 | =item C<PERL_BADFREE> |
cb1a09d0 | 6402 | |
4755096e | 6403 | =item C<PERL_SH_DIR> |
cb1a09d0 | 6404 | |
4755096e | 6405 | =item C<USE_PERL_FLOCK> |
cb1a09d0 | 6406 | |
4755096e | 6407 | =item C<TMP> or C<TEMP> |
cb1a09d0 | 6408 | |
4755096e | 6409 | =back |
cb1a09d0 | 6410 | |
4755096e | 6411 | =item Evolution |
7d2bfb28 | 6412 | |
d420ca49 | 6413 | =over 4 |
cb1a09d0 | 6414 | |
4755096e | 6415 | =item Priorities |
cb1a09d0 | 6416 | |
354a27bf JH |
6417 | =item DLL name mangling: pre 5.6.2 |
6418 | ||
6419 | =item DLL name mangling: 5.6.2 and beyond | |
6420 | ||
6421 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from | |
6422 | C<LIBPATH> | |
6423 | ||
6424 | =item DLL forwarder generation | |
cb1a09d0 | 6425 | |
4755096e | 6426 | =item Threading |
cb1a09d0 | 6427 | |
4755096e | 6428 | =item Calls to external programs |
cb1a09d0 | 6429 | |
4755096e | 6430 | =item Memory allocation |
cb1a09d0 | 6431 | |
4755096e | 6432 | =item Threads |
cb1a09d0 | 6433 | |
4755096e | 6434 | C<COND_WAIT>, F<os2.c> |
cb1a09d0 | 6435 | |
4755096e | 6436 | =back |
5cd24f17 | 6437 | |
354a27bf JH |
6438 | =item BUGS |
6439 | ||
cb1a09d0 AD |
6440 | =back |
6441 | ||
d420ca49 | 6442 | =over 4 |
cb1a09d0 | 6443 | |
cb1a09d0 AD |
6444 | =item AUTHOR |
6445 | ||
4755096e | 6446 | =item SEE ALSO |
cb1a09d0 | 6447 | |
a45bd81d GS |
6448 | =back |
6449 | ||
4755096e | 6450 | =head2 perlos390, README.os390 - building and installing Perl for OS/390. |
c76ac1ee | 6451 | |
d420ca49 | 6452 | =over 4 |
a45bd81d | 6453 | |
4755096e GS |
6454 | =item SYNOPSIS |
6455 | ||
c76ac1ee GS |
6456 | =item DESCRIPTION |
6457 | ||
d420ca49 | 6458 | =over 4 |
c76ac1ee | 6459 | |
a83b6f46 | 6460 | =item Unpacking Perl distribution on OS/390 |
c76ac1ee | 6461 | |
a83b6f46 | 6462 | =item Setup and utilities for Perl on OS/390 |
c76ac1ee | 6463 | |
a83b6f46 | 6464 | =item Configure Perl on OS/390 |
c76ac1ee | 6465 | |
a83b6f46 | 6466 | =item Build, Test, Install Perl on OS/390 |
c76ac1ee | 6467 | |
a83b6f46 | 6468 | =item Build Anomalies with Perl on OS/390 |
74cac757 | 6469 | |
a83b6f46 | 6470 | =item Testing Anomalies with Perl on OS/390 |
74cac757 | 6471 | |
a83b6f46 | 6472 | =item Installation Anomalies with Perl on OS/390 |
c2e66d9e | 6473 | |
a83b6f46 | 6474 | =item Usage Hints for Perl on OS/390 |
c2e66d9e | 6475 | |
a83b6f46 | 6476 | =item Floating Point Anomalies with Perl on OS/390 |
c2e66d9e | 6477 | |
a83b6f46 | 6478 | =item Modules and Extensions for Perl on OS/390 |
c2e66d9e GS |
6479 | |
6480 | =back | |
6481 | ||
6482 | =item AUTHORS | |
6483 | ||
6484 | =item SEE ALSO | |
6485 | ||
d420ca49 | 6486 | =over 4 |
c2e66d9e | 6487 | |
a83b6f46 | 6488 | =item Mailing list for Perl on OS/390 |
c2e66d9e GS |
6489 | |
6490 | =back | |
6491 | ||
6492 | =item HISTORY | |
6493 | ||
6494 | =back | |
6495 | ||
a83b6f46 JH |
6496 | =head2 perlqnx, README.qnx - Perl version 5 on QNX |
6497 | ||
6498 | =over 4 | |
6499 | ||
6500 | =item DESCRIPTION | |
6501 | ||
6502 | =over 4 | |
6503 | ||
6504 | =item Required Software for Compiling Perl on QNX | |
6505 | ||
6506 | /bin/sh, ar, nm, cpp, make | |
6507 | ||
6508 | =item Outstanding Issues with Perl on QNX | |
6509 | ||
6510 | =item QNX auxiliary files | |
6511 | ||
6512 | qnx/ar, qnx/cpp | |
6513 | ||
6514 | =back | |
6515 | ||
6516 | =item AUTHOR | |
6517 | ||
6518 | =back | |
6519 | ||
6520 | =head2 perlplan9 - Plan 9-specific documentation for Perl | |
6521 | ||
6522 | =over 4 | |
6523 | ||
6524 | =item DESCRIPTION | |
6525 | ||
6526 | =over 4 | |
6527 | ||
6528 | =item Invoking Perl | |
6529 | ||
6530 | =item What's in Plan 9 Perl | |
6531 | ||
6532 | =item What's not in Plan 9 Perl | |
6533 | ||
6534 | =item Perl5 Functions not currently supported in Plan 9 Perl | |
6535 | ||
6536 | =item Signals in Plan 9 Perl | |
6537 | ||
6538 | =back | |
6539 | ||
6540 | =item COMPILING AND INSTALLING PERL ON PLAN 9 | |
6541 | ||
6542 | =over 4 | |
6543 | ||
6544 | =item Installing Perl Documentation on Plan 9 | |
6545 | ||
6546 | =back | |
6547 | ||
6548 | =item BUGS | |
6549 | ||
6550 | =item Revision date | |
6551 | ||
6552 | =item AUTHOR | |
6553 | ||
6554 | =back | |
6555 | ||
d420ca49 AD |
6556 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems |
6557 | ||
6558 | =over 4 | |
6559 | ||
6560 | =item DESCRIPTION | |
6561 | ||
6562 | =over 4 | |
6563 | ||
6564 | =item Solaris Version Numbers. | |
6565 | ||
6566 | =back | |
6567 | ||
6568 | =item RESOURCES | |
6569 | ||
6570 | Solaris FAQ, Precompiled Binaries, Solaris Documentation | |
6571 | ||
6572 | =item SETTING UP | |
6573 | ||
6574 | =over 4 | |
6575 | ||
a83b6f46 | 6576 | =item File Extraction Problems on Solaris. |
d420ca49 | 6577 | |
a83b6f46 | 6578 | =item Compiler and Related Tools on Solaris. |
d420ca49 | 6579 | |
a83b6f46 | 6580 | =item Environment for Compiling Perl on Solaris |
d420ca49 AD |
6581 | |
6582 | =back | |
6583 | ||
6584 | =item RUN CONFIGURE. | |
6585 | ||
6586 | =over 4 | |
6587 | ||
a83b6f46 | 6588 | =item 64-bit Issues with Perl on Solaris. |
d420ca49 | 6589 | |
a83b6f46 | 6590 | =item Threads in Perl on Solaris. |
d420ca49 | 6591 | |
a83b6f46 | 6592 | =item Malloc Issues with Perl on Solaris. |
d420ca49 AD |
6593 | |
6594 | =back | |
6595 | ||
6596 | =item MAKE PROBLEMS. | |
6597 | ||
6598 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: | |
6599 | relocation error:, dlopen: stub interception failed, #error "No | |
6600 | DATAMODEL_NATIVE specified", sh: ar: not found | |
6601 | ||
6602 | =item MAKE TEST | |
6603 | ||
6604 | =over 4 | |
6605 | ||
a83b6f46 | 6606 | =item op/stat.t test 4 in Solaris |
d420ca49 AD |
6607 | |
6608 | =back | |
6609 | ||
a83b6f46 | 6610 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. |
d420ca49 | 6611 | |
a83b6f46 | 6612 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. |
d420ca49 AD |
6613 | |
6614 | =over 4 | |
6615 | ||
a83b6f46 | 6616 | =item Limits on Numbers of Open Files on Solaris. |
d420ca49 AD |
6617 | |
6618 | =back | |
6619 | ||
6620 | =item SOLARIS-SPECIFIC MODULES. | |
6621 | ||
6622 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. | |
6623 | ||
6624 | =over 4 | |
6625 | ||
a83b6f46 | 6626 | =item Proc::ProcessTable on Solaris |
d420ca49 | 6627 | |
354a27bf | 6628 | =item BSD::Resource on Solaris |
d420ca49 | 6629 | |
354a27bf | 6630 | =item Net::SSLeay on Solaris |
74cac757 | 6631 | |
d420ca49 AD |
6632 | =back |
6633 | ||
6634 | =item AUTHOR | |
6635 | ||
6636 | =item LAST MODIFIED | |
6637 | ||
6638 | =back | |
6639 | ||
772ff3b9 JH |
6640 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as |
6641 | Digital UNIX formerly known as DEC OSF/1) systems | |
6642 | ||
6643 | =over 4 | |
6644 | ||
6645 | =item DESCRIPTION | |
6646 | ||
6647 | =over 4 | |
6648 | ||
6649 | =item Compiling Perl 5 on Tru64 | |
6650 | ||
6651 | =item Using Large Files with Perl on Tru64 | |
6652 | ||
6653 | =item Threaded Perl on Tru64 | |
6654 | ||
a83b6f46 JH |
6655 | =item Long Doubles on Tru64 |
6656 | ||
772ff3b9 JH |
6657 | =item 64-bit Perl on Tru64 |
6658 | ||
6659 | =item Warnings about floating-point overflow when compiling Perl on Tru64 | |
6660 | ||
6661 | =back | |
6662 | ||
6663 | =item Testing Perl on Tru64 | |
6664 | ||
6665 | =item AUTHOR | |
6666 | ||
6667 | =back | |
6668 | ||
dc5c060f JH |
6669 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. |
6670 | ||
6671 | =over 4 | |
6672 | ||
6673 | =item SYNOPSIS | |
6674 | ||
6675 | =item DESCRIPTION | |
6676 | ||
6677 | =over 4 | |
6678 | ||
a83b6f46 | 6679 | =item Unpacking Perl Distribution on VM/ESA |
dc5c060f | 6680 | |
a83b6f46 | 6681 | =item Setup Perl and utilities on VM/ESA |
dc5c060f | 6682 | |
a83b6f46 | 6683 | =item Configure Perl on VM/ESA |
dc5c060f | 6684 | |
a83b6f46 | 6685 | =item Testing Anomalies of Perl on VM/ESA |
dc5c060f | 6686 | |
a83b6f46 | 6687 | =item Usage Hints for Perl on VM/ESA |
dc5c060f | 6688 | |
dc5c060f JH |
6689 | =back |
6690 | ||
6691 | =item AUTHORS | |
6692 | ||
6693 | =item SEE ALSO | |
6694 | ||
6695 | =over 4 | |
6696 | ||
a83b6f46 | 6697 | =item Mailing list for Perl on VM/ESA |
dc5c060f JH |
6698 | |
6699 | =back | |
6700 | ||
6701 | =back | |
6702 | ||
4755096e | 6703 | =head2 perlvms - VMS-specific documentation for Perl |
954c1994 | 6704 | |
d420ca49 | 6705 | =over 4 |
954c1994 | 6706 | |
4755096e | 6707 | =item DESCRIPTION |
a45bd81d | 6708 | |
4755096e GS |
6709 | =item Installation |
6710 | ||
6711 | =item Organization of Perl Images | |
954c1994 | 6712 | |
d420ca49 | 6713 | =over 4 |
a45bd81d | 6714 | |
4755096e | 6715 | =item Core Images |
c76ac1ee | 6716 | |
4755096e | 6717 | =item Perl Extensions |
954c1994 | 6718 | |
4755096e | 6719 | =item Installing static extensions |
954c1994 | 6720 | |
4755096e | 6721 | =item Installing dynamic extensions |
954c1994 GS |
6722 | |
6723 | =back | |
6724 | ||
4755096e | 6725 | =item File specifications |
954c1994 | 6726 | |
d420ca49 | 6727 | =over 4 |
954c1994 | 6728 | |
4755096e | 6729 | =item Syntax |
2e1d04bc | 6730 | |
4755096e | 6731 | =item Wildcard expansion |
954c1994 | 6732 | |
4755096e | 6733 | =item Pipes |
c76ac1ee | 6734 | |
a45bd81d GS |
6735 | =back |
6736 | ||
4755096e GS |
6737 | =item PERL5LIB and PERLLIB |
6738 | ||
6739 | =item Command line | |
d516a115 | 6740 | |
d420ca49 | 6741 | =over 4 |
a45bd81d | 6742 | |
4755096e | 6743 | =item I/O redirection and backgrounding |
d516a115 | 6744 | |
4755096e | 6745 | =item Command line switches |
d516a115 | 6746 | |
4755096e GS |
6747 | -i, -S, -u |
6748 | ||
6749 | =back | |
6750 | ||
6751 | =item Perl functions | |
6752 | ||
6753 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
6754 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
6755 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
6756 | LIST, waitpid PID,FLAGS | |
6757 | ||
6758 | =item Perl variables | |
6759 | ||
ac4dd294 | 6760 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| |
4755096e GS |
6761 | |
6762 | =item Standard modules with VMS-specific differences | |
d516a115 | 6763 | |
d420ca49 | 6764 | =over 4 |
d516a115 | 6765 | |
4755096e | 6766 | =item SDBM_File |
d516a115 JH |
6767 | |
6768 | =back | |
6769 | ||
4755096e GS |
6770 | =item Revision date |
6771 | ||
6772 | =item AUTHOR | |
6773 | ||
6774 | =back | |
6775 | ||
9a997319 JH |
6776 | =head2 perlvos, README.vos - Perl for Stratus VOS |
6777 | ||
d420ca49 | 6778 | =over 4 |
9a997319 JH |
6779 | |
6780 | =item SYNOPSIS | |
6781 | ||
d420ca49 | 6782 | =over 4 |
9a997319 JH |
6783 | |
6784 | =item Stratus POSIX Support | |
6785 | ||
6786 | =back | |
6787 | ||
6788 | =item INSTALLING PERL IN VOS | |
6789 | ||
d420ca49 | 6790 | =over 4 |
9a997319 JH |
6791 | |
6792 | =item Compiling Perl 5 on VOS | |
6793 | ||
6794 | =item Installing Perl 5 on VOS | |
6795 | ||
6796 | =back | |
6797 | ||
6798 | =item USING PERL IN VOS | |
6799 | ||
d420ca49 | 6800 | =over 4 |
9a997319 | 6801 | |
a83b6f46 | 6802 | =item Unimplemented Features of Perl on VOS |
9a997319 | 6803 | |
a83b6f46 | 6804 | =item Restrictions of Perl on VOS |
9a997319 JH |
6805 | |
6806 | =back | |
6807 | ||
6808 | =item SUPPORT STATUS | |
6809 | ||
6810 | =item AUTHOR | |
6811 | ||
6812 | =item LAST UPDATE | |
6813 | ||
6814 | =back | |
6815 | ||
8ebc5c01 | 6816 | =head1 PRAGMA DOCUMENTATION |
cb1a09d0 | 6817 | |
c76ac1ee | 6818 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
d516a115 | 6819 | |
d420ca49 | 6820 | =over 4 |
a45bd81d | 6821 | |
d516a115 JH |
6822 | =item SYNOPSIS |
6823 | ||
6824 | =item DESCRIPTION | |
6825 | ||
6826 | method, locked | |
6827 | ||
a45bd81d GS |
6828 | =back |
6829 | ||
fb9cefb4 GS |
6830 | =head2 re - Perl pragma to alter regular expression behaviour |
6831 | ||
d420ca49 | 6832 | =over 4 |
a45bd81d GS |
6833 | |
6834 | =item SYNOPSIS | |
fb9cefb4 GS |
6835 | |
6836 | =item DESCRIPTION | |
6837 | ||
a45bd81d GS |
6838 | =back |
6839 | ||
c76ac1ee GS |
6840 | =head2 attributes - get/set subroutine or variable attributes |
6841 | ||
d420ca49 | 6842 | =over 4 |
a45bd81d | 6843 | |
c76ac1ee GS |
6844 | =item SYNOPSIS |
6845 | ||
6846 | =item DESCRIPTION | |
6847 | ||
d420ca49 | 6848 | =over 4 |
c76ac1ee GS |
6849 | |
6850 | =item Built-in Attributes | |
6851 | ||
694468e3 | 6852 | locked, method, lvalue |
c76ac1ee GS |
6853 | |
6854 | =item Available Subroutines | |
6855 | ||
6856 | get, reftype | |
6857 | ||
6858 | =item Package-specific Attribute Handling | |
6859 | ||
6860 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
6861 | ||
6862 | =item Syntax of Attribute Lists | |
6863 | ||
6864 | =back | |
6865 | ||
a45bd81d GS |
6866 | =item EXPORTS |
6867 | ||
d420ca49 | 6868 | =over 4 |
a45bd81d GS |
6869 | |
6870 | =item Default exports | |
6871 | ||
6872 | =item Available exports | |
6873 | ||
6874 | =item Export tags defined | |
6875 | ||
6876 | =back | |
6877 | ||
c76ac1ee GS |
6878 | =item EXAMPLES |
6879 | ||
6880 | =item SEE ALSO | |
6881 | ||
a45bd81d GS |
6882 | =back |
6883 | ||
9038e305 JH |
6884 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
6885 | ||
6886 | =over 4 | |
6887 | ||
6888 | =item SYNOPSIS | |
6889 | ||
6890 | =item DESCRIPTION | |
6891 | ||
6892 | method, locked | |
6893 | ||
6894 | =back | |
6895 | ||
68dc0745 | 6896 | =head2 autouse - postpone load of modules until a function is used |
6897 | ||
d420ca49 | 6898 | =over 4 |
a45bd81d | 6899 | |
68dc0745 | 6900 | =item SYNOPSIS |
6901 | ||
6902 | =item DESCRIPTION | |
6903 | ||
6904 | =item WARNING | |
6905 | ||
68dc0745 | 6906 | =item AUTHOR |
6907 | ||
6908 | =item SEE ALSO | |
6909 | ||
a45bd81d GS |
6910 | =back |
6911 | ||
d516a115 JH |
6912 | =head2 base - Establish IS-A relationship with base class at compile time |
6913 | ||
d420ca49 | 6914 | =over 4 |
a45bd81d | 6915 | |
d516a115 JH |
6916 | =item SYNOPSIS |
6917 | ||
6918 | =item DESCRIPTION | |
6919 | ||
14218588 GS |
6920 | =item HISTORY |
6921 | ||
fb9cefb4 | 6922 | =item SEE ALSO |
d516a115 | 6923 | |
a45bd81d GS |
6924 | =back |
6925 | ||
8ebc5c01 | 6926 | =head2 blib - Use MakeMaker's uninstalled version of a package |
cb1a09d0 | 6927 | |
d420ca49 | 6928 | =over 4 |
a45bd81d | 6929 | |
8ebc5c01 | 6930 | =item SYNOPSIS |
cb1a09d0 | 6931 | |
8ebc5c01 | 6932 | =item DESCRIPTION |
cb1a09d0 | 6933 | |
8ebc5c01 | 6934 | =item BUGS |
cb1a09d0 | 6935 | |
8ebc5c01 | 6936 | =item AUTHOR |
cb1a09d0 | 6937 | |
a45bd81d GS |
6938 | =back |
6939 | ||
694468e3 GS |
6940 | =head2 bytes - Perl pragma to force byte semantics rather than character |
6941 | semantics | |
a45bd81d | 6942 | |
d420ca49 | 6943 | =over 4 |
a45bd81d GS |
6944 | |
6945 | =item SYNOPSIS | |
6946 | ||
6947 | =item DESCRIPTION | |
6948 | ||
694468e3 | 6949 | =item SEE ALSO |
a10cf691 | 6950 | |
a45bd81d GS |
6951 | =back |
6952 | ||
c76ac1ee GS |
6953 | =head2 charnames - define character names for C<\N{named}> string literal |
6954 | escape. | |
6955 | ||
d420ca49 | 6956 | =over 4 |
a45bd81d | 6957 | |
c76ac1ee GS |
6958 | =item SYNOPSIS |
6959 | ||
6960 | =item DESCRIPTION | |
6961 | ||
6962 | =item CUSTOM TRANSLATORS | |
6963 | ||
6964 | =item BUGS | |
6965 | ||
a45bd81d GS |
6966 | =back |
6967 | ||
54310121 | 6968 | =head2 constant - Perl pragma to declare constants |
6969 | ||
d420ca49 | 6970 | =over 4 |
a45bd81d | 6971 | |
54310121 | 6972 | =item SYNOPSIS |
6973 | ||
6974 | =item DESCRIPTION | |
6975 | ||
6976 | =item NOTES | |
6977 | ||
6978 | =item TECHNICAL NOTE | |
6979 | ||
6980 | =item BUGS | |
6981 | ||
6982 | =item AUTHOR | |
6983 | ||
6984 | =item COPYRIGHT | |
6985 | ||
a45bd81d GS |
6986 | =back |
6987 | ||
8ebc5c01 | 6988 | =head2 diagnostics - Perl compiler pragma to force verbose warning |
6989 | diagnostics | |
cb1a09d0 | 6990 | |
d420ca49 | 6991 | =over 4 |
a45bd81d | 6992 | |
8ebc5c01 | 6993 | =item SYNOPSIS |
cb1a09d0 | 6994 | |
8ebc5c01 | 6995 | =item DESCRIPTION |
cb1a09d0 | 6996 | |
d420ca49 | 6997 | =over 4 |
cb1a09d0 | 6998 | |
8ebc5c01 | 6999 | =item The C<diagnostics> Pragma |
cb1a09d0 | 7000 | |
8ebc5c01 | 7001 | =item The I<splain> Program |
cb1a09d0 | 7002 | |
8ebc5c01 | 7003 | =back |
cb1a09d0 | 7004 | |
8ebc5c01 | 7005 | =item EXAMPLES |
cb1a09d0 | 7006 | |
8ebc5c01 | 7007 | =item INTERNALS |
cb1a09d0 | 7008 | |
8ebc5c01 | 7009 | =item BUGS |
cb1a09d0 | 7010 | |
8ebc5c01 | 7011 | =item AUTHOR |
cb1a09d0 | 7012 | |
a45bd81d GS |
7013 | =back |
7014 | ||
d516a115 JH |
7015 | =head2 fields - compile-time class fields |
7016 | ||
d420ca49 | 7017 | =over 4 |
a45bd81d | 7018 | |
d516a115 JH |
7019 | =item SYNOPSIS |
7020 | ||
7021 | =item DESCRIPTION | |
7022 | ||
694468e3 GS |
7023 | new, phash |
7024 | ||
fb9cefb4 GS |
7025 | =item SEE ALSO |
7026 | ||
a45bd81d GS |
7027 | =back |
7028 | ||
14218588 GS |
7029 | =head2 filetest - Perl pragma to control the filetest permission operators |
7030 | ||
d420ca49 | 7031 | =over 4 |
a45bd81d | 7032 | |
14218588 GS |
7033 | =item SYNOPSIS |
7034 | ||
14218588 GS |
7035 | =item DESCRIPTION |
7036 | ||
d420ca49 | 7037 | =over 4 |
14218588 GS |
7038 | |
7039 | =item subpragma access | |
7040 | ||
7041 | =back | |
7042 | ||
a45bd81d GS |
7043 | =back |
7044 | ||
4d4e713d JH |
7045 | =head2 integer - Perl pragma to use integer arithmetic instead of floating |
7046 | point | |
cb1a09d0 | 7047 | |
d420ca49 | 7048 | =over 4 |
a45bd81d | 7049 | |
8ebc5c01 | 7050 | =item SYNOPSIS |
cb1a09d0 | 7051 | |
8ebc5c01 | 7052 | =item DESCRIPTION |
cb1a09d0 | 7053 | |
a45bd81d GS |
7054 | =back |
7055 | ||
8ebc5c01 | 7056 | =head2 less - perl pragma to request less of something from the compiler |
cb1a09d0 | 7057 | |
d420ca49 | 7058 | =over 4 |
a45bd81d | 7059 | |
8ebc5c01 | 7060 | =item SYNOPSIS |
cb1a09d0 | 7061 | |
8ebc5c01 | 7062 | =item DESCRIPTION |
cb1a09d0 | 7063 | |
a45bd81d GS |
7064 | =back |
7065 | ||
8ebc5c01 | 7066 | =head2 lib - manipulate @INC at compile time |
cb1a09d0 | 7067 | |
d420ca49 | 7068 | =over 4 |
a45bd81d | 7069 | |
8ebc5c01 | 7070 | =item SYNOPSIS |
cb1a09d0 | 7071 | |
8ebc5c01 | 7072 | =item DESCRIPTION |
cb1a09d0 | 7073 | |
d420ca49 | 7074 | =over 4 |
8ebc5c01 | 7075 | |
c76ac1ee | 7076 | =item Adding directories to @INC |
cb1a09d0 | 7077 | |
c76ac1ee | 7078 | =item Deleting directories from @INC |
cb1a09d0 | 7079 | |
c76ac1ee | 7080 | =item Restoring original @INC |
cb1a09d0 | 7081 | |
8ebc5c01 | 7082 | =back |
cb1a09d0 | 7083 | |
8ebc5c01 | 7084 | =item SEE ALSO |
cb1a09d0 | 7085 | |
8ebc5c01 | 7086 | =item AUTHOR |
cb1a09d0 | 7087 | |
a45bd81d GS |
7088 | =back |
7089 | ||
8ebc5c01 | 7090 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
7091 | operations | |
cb1a09d0 | 7092 | |
d420ca49 | 7093 | =over 4 |
a45bd81d | 7094 | |
8ebc5c01 | 7095 | =item SYNOPSIS |
cb1a09d0 AD |
7096 | |
7097 | =item DESCRIPTION | |
7098 | ||
a45bd81d GS |
7099 | =back |
7100 | ||
b38f6a39 GS |
7101 | =head2 open - perl pragma to set default disciplines for input and output |
7102 | ||
d420ca49 | 7103 | =over 4 |
b38f6a39 GS |
7104 | |
7105 | =item SYNOPSIS | |
7106 | ||
7107 | =item DESCRIPTION | |
7108 | ||
0d0e97a6 JH |
7109 | =item NONPERLIO FUNCTIONALITY |
7110 | ||
7111 | =item IMPLEMENTATION DETAILS | |
b38f6a39 GS |
7112 | |
7113 | =item SEE ALSO | |
7114 | ||
7115 | =back | |
7116 | ||
d46b76b3 JH |
7117 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
7118 | ||
d420ca49 | 7119 | =over 4 |
d46b76b3 JH |
7120 | |
7121 | =item SYNOPSIS | |
7122 | ||
7123 | =item DESCRIPTION | |
7124 | ||
7125 | =item SEE ALSO | |
7126 | ||
7127 | =back | |
7128 | ||
8ebc5c01 | 7129 | =head2 overload - Package for overloading perl operations |
cb1a09d0 | 7130 | |
d420ca49 | 7131 | =over 4 |
a45bd81d | 7132 | |
8ebc5c01 | 7133 | =item SYNOPSIS |
cb1a09d0 | 7134 | |
8ebc5c01 | 7135 | =item DESCRIPTION |
cb1a09d0 | 7136 | |
d420ca49 | 7137 | =over 4 |
cb1a09d0 | 7138 | |
8ebc5c01 | 7139 | =item Declaration of overloaded functions |
cb1a09d0 | 7140 | |
8ebc5c01 | 7141 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 7142 | |
8ebc5c01 | 7143 | FALSE, TRUE, C<undef> |
cb1a09d0 | 7144 | |
8ebc5c01 | 7145 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 7146 | |
14218588 GS |
7147 | =item Calling Conventions for Mutators |
7148 | ||
7149 | C<++> and C<-->, C<x=> and other assignment versions | |
7150 | ||
8ebc5c01 | 7151 | =item Overloadable Operations |
cb1a09d0 | 7152 | |
8ebc5c01 | 7153 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
7154 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
14218588 | 7155 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
cb1a09d0 | 7156 | |
774d564b | 7157 | =item Inheritance and overloading |
7158 | ||
7159 | Strings as values of C<use overload> directive, Overloading of an operation | |
7160 | is inherited by derived classes | |
7161 | ||
8ebc5c01 | 7162 | =back |
cb1a09d0 | 7163 | |
8ebc5c01 | 7164 | =item SPECIAL SYMBOLS FOR C<use overload> |
cb1a09d0 | 7165 | |
d420ca49 | 7166 | =over 4 |
cb1a09d0 | 7167 | |
774d564b | 7168 | =item Last Resort |
cb1a09d0 | 7169 | |
91331b4f | 7170 | =item Fallback |
cb1a09d0 | 7171 | |
8ebc5c01 | 7172 | C<undef>, TRUE, defined, but FALSE |
cb1a09d0 | 7173 | |
8ebc5c01 | 7174 | =item Copy Constructor |
cb1a09d0 | 7175 | |
8ebc5c01 | 7176 | B<Example> |
cb1a09d0 | 7177 | |
8ebc5c01 | 7178 | =back |
cb1a09d0 | 7179 | |
8ebc5c01 | 7180 | =item MAGIC AUTOGENERATION |
cb1a09d0 | 7181 | |
8ebc5c01 | 7182 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
7183 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
14218588 GS |
7184 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
7185 | I<Copy operator> | |
cb1a09d0 | 7186 | |
14218588 | 7187 | =item Losing overloading |
cb1a09d0 | 7188 | |
8ebc5c01 | 7189 | =item Run-time Overloading |
cb1a09d0 | 7190 | |
8ebc5c01 | 7191 | =item Public functions |
cb1a09d0 | 7192 | |
8ebc5c01 | 7193 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 7194 | |
fb9cefb4 GS |
7195 | =item Overloading constants |
7196 | ||
7197 | integer, float, binary, q, qr | |
7198 | ||
8ebc5c01 | 7199 | =item IMPLEMENTATION |
cb1a09d0 | 7200 | |
14218588 GS |
7201 | =item Metaphor clash |
7202 | ||
7203 | =item Cookbook | |
7204 | ||
d420ca49 | 7205 | =over 4 |
14218588 GS |
7206 | |
7207 | =item Two-face scalars | |
7208 | ||
7209 | =item Two-face references | |
7210 | ||
7211 | =item Symbolic calculator | |
7212 | ||
7213 | =item I<Really> symbolic calculator | |
7214 | ||
4755096e | 7215 | =back |
497711e7 | 7216 | |
4755096e | 7217 | =item AUTHOR |
497711e7 | 7218 | |
4755096e | 7219 | =item DIAGNOSTICS |
497711e7 | 7220 | |
93d73c42 JH |
7221 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
7222 | type, `%s' is not a code reference | |
7223 | ||
4755096e | 7224 | =item BUGS |
497711e7 GS |
7225 | |
7226 | =back | |
7227 | ||
14218588 GS |
7228 | =head2 re - Perl pragma to alter regular expression behaviour |
7229 | ||
d420ca49 | 7230 | =over 4 |
a45bd81d | 7231 | |
14218588 GS |
7232 | =item SYNOPSIS |
7233 | ||
7234 | =item DESCRIPTION | |
7235 | ||
a45bd81d GS |
7236 | =back |
7237 | ||
8ebc5c01 | 7238 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 7239 | |
d420ca49 | 7240 | =over 4 |
a45bd81d | 7241 | |
8ebc5c01 | 7242 | =item SYNOPSIS |
cb1a09d0 | 7243 | |
8ebc5c01 | 7244 | =item DESCRIPTION |
cb1a09d0 | 7245 | |
8ebc5c01 | 7246 | =item OPTIONS |
cb1a09d0 | 7247 | |
d420ca49 | 7248 | =over 4 |
cb1a09d0 | 7249 | |
8ebc5c01 | 7250 | =item SIGNAL HANDLERS |
cb1a09d0 | 7251 | |
8ebc5c01 | 7252 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
cb1a09d0 | 7253 | |
8ebc5c01 | 7254 | =item SIGNAL LISTS |
cb1a09d0 | 7255 | |
8ebc5c01 | 7256 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
cb1a09d0 | 7257 | |
8ebc5c01 | 7258 | =item OTHER |
cb1a09d0 | 7259 | |
8ebc5c01 | 7260 | B<untrapped>, B<any>, I<signal>, I<number> |
cb1a09d0 | 7261 | |
8ebc5c01 | 7262 | =back |
cb1a09d0 | 7263 | |
8ebc5c01 | 7264 | =item EXAMPLES |
cb1a09d0 | 7265 | |
a45bd81d GS |
7266 | =back |
7267 | ||
8ebc5c01 | 7268 | =head2 strict - Perl pragma to restrict unsafe constructs |
cb1a09d0 | 7269 | |
d420ca49 | 7270 | =over 4 |
a45bd81d | 7271 | |
8ebc5c01 | 7272 | =item SYNOPSIS |
cb1a09d0 | 7273 | |
8ebc5c01 | 7274 | =item DESCRIPTION |
cb1a09d0 | 7275 | |
8ebc5c01 | 7276 | C<strict refs>, C<strict vars>, C<strict subs> |
cb1a09d0 | 7277 | |
a45bd81d GS |
7278 | =back |
7279 | ||
8ebc5c01 | 7280 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 | 7281 | |
d420ca49 | 7282 | =over 4 |
a45bd81d | 7283 | |
cb1a09d0 AD |
7284 | =item SYNOPSIS |
7285 | ||
cb1a09d0 AD |
7286 | =item DESCRIPTION |
7287 | ||
a45bd81d GS |
7288 | =back |
7289 | ||
ab648d5e JH |
7290 | =head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data |
7291 | and non-UTF data. | |
7292 | ||
7293 | =over 4 | |
7294 | ||
7295 | =item SYNOPSIS | |
7296 | ||
7297 | =item DESCRIPTION | |
7298 | ||
7299 | =item SEE ALSO | |
7300 | ||
7301 | =back | |
7302 | ||
bd28ded5 JH |
7303 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source |
7304 | code | |
14218588 | 7305 | |
d420ca49 | 7306 | =over 4 |
a45bd81d | 7307 | |
14218588 GS |
7308 | =item SYNOPSIS |
7309 | ||
7310 | =item DESCRIPTION | |
7311 | ||
4d4e713d JH |
7312 | =over 4 |
7313 | ||
7314 | =item Utility functions | |
7315 | ||
7316 | $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), | |
7317 | utf8::encode($string), $flag = utf8::decode($string) | |
7318 | ||
7319 | =back | |
7320 | ||
694468e3 | 7321 | =item SEE ALSO |
14218588 | 7322 | |
a45bd81d GS |
7323 | =back |
7324 | ||
7325 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) | |
7326 | ||
d420ca49 | 7327 | =over 4 |
cb1a09d0 | 7328 | |
8ebc5c01 | 7329 | =item SYNOPSIS |
cb1a09d0 | 7330 | |
8ebc5c01 | 7331 | =item DESCRIPTION |
cb1a09d0 | 7332 | |
a45bd81d GS |
7333 | =back |
7334 | ||
4438c4b7 | 7335 | =head2 warnings - Perl pragma to control optional warnings |
14218588 | 7336 | |
d420ca49 | 7337 | =over 4 |
a45bd81d | 7338 | |
14218588 GS |
7339 | =item SYNOPSIS |
7340 | ||
7341 | =item DESCRIPTION | |
7342 | ||
a9ef4385 JH |
7343 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
7344 | warnings::enabled($object), warnings::warn($message), | |
7345 | warnings::warn($category, $message), warnings::warn($object, $message), | |
7346 | warnings::warnif($message), warnings::warnif($category, $message), | |
7347 | warnings::warnif($object, $message) | |
694468e3 | 7348 | |
a45bd81d GS |
7349 | =back |
7350 | ||
4755096e GS |
7351 | =head2 warnings::register - warnings import function |
7352 | ||
8ebc5c01 | 7353 | =head1 MODULE DOCUMENTATION |
cb1a09d0 | 7354 | |
8ebc5c01 | 7355 | =head2 AnyDBM_File - provide framework for multiple DBMs |
cb1a09d0 | 7356 | |
d420ca49 | 7357 | =over 4 |
a45bd81d | 7358 | |
cb1a09d0 AD |
7359 | =item SYNOPSIS |
7360 | ||
cb1a09d0 AD |
7361 | =item DESCRIPTION |
7362 | ||
d420ca49 | 7363 | =over 4 |
cb1a09d0 | 7364 | |
8ebc5c01 | 7365 | =item DBM Comparisons |
cb1a09d0 | 7366 | |
8ebc5c01 | 7367 | [0], [1], [2], [3] |
cb1a09d0 | 7368 | |
8ebc5c01 | 7369 | =back |
cb1a09d0 | 7370 | |
8ebc5c01 | 7371 | =item SEE ALSO |
cb1a09d0 | 7372 | |
a45bd81d GS |
7373 | =back |
7374 | ||
dc6b6eef JH |
7375 | =head2 Attribute::Handlers - Simpler definition of attribute handlers |
7376 | ||
7377 | =over 4 | |
7378 | ||
7379 | =item VERSION | |
7380 | ||
7381 | =item SYNOPSIS | |
7382 | ||
7383 | =item DESCRIPTION | |
7384 | ||
7a49b635 | 7385 | [0], [1], [2], [3], [4], [5] |
dc6b6eef JH |
7386 | |
7387 | =over 4 | |
7388 | ||
7389 | =item Typed lexicals | |
7390 | ||
7391 | =item Type-specific attribute handlers | |
7392 | ||
7393 | =item Non-interpretive attribute handlers | |
7394 | ||
7a49b635 JH |
7395 | =item Phase-specific attribute handlers |
7396 | ||
dc6b6eef JH |
7397 | =item Attributes as C<tie> interfaces |
7398 | ||
7399 | =back | |
7400 | ||
7401 | =item EXAMPLES | |
7402 | ||
7403 | =item DIAGNOSTICS | |
7404 | ||
7a49b635 JH |
7405 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s |
7406 | attributes>, C<Declaration of %s attribute in package %s may clash with | |
7407 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, | |
7408 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing> | |
7409 | ||
dc6b6eef JH |
7410 | =item AUTHOR |
7411 | ||
7412 | =item BUGS | |
7413 | ||
7414 | =item COPYRIGHT | |
7415 | ||
7416 | =back | |
7417 | ||
4a6725af | 7418 | =head2 AutoLoader - load subroutines only on demand |
cb1a09d0 | 7419 | |
d420ca49 | 7420 | =over 4 |
a45bd81d | 7421 | |
8ebc5c01 | 7422 | =item SYNOPSIS |
cb1a09d0 | 7423 | |
8ebc5c01 | 7424 | =item DESCRIPTION |
cb1a09d0 | 7425 | |
d420ca49 | 7426 | =over 4 |
cb1a09d0 | 7427 | |
4a6725af NT |
7428 | =item Subroutine Stubs |
7429 | ||
7430 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
cb1a09d0 | 7431 | |
4a6725af | 7432 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
cb1a09d0 | 7433 | |
8ebc5c01 | 7434 | =item Package Lexicals |
cb1a09d0 | 7435 | |
7029d033 JH |
7436 | =item Not Using AutoLoader |
7437 | ||
4a6725af | 7438 | =item B<AutoLoader> vs. B<SelfLoader> |
cb1a09d0 | 7439 | |
8ebc5c01 | 7440 | =back |
cb1a09d0 | 7441 | |
4a6725af NT |
7442 | =item CAVEATS |
7443 | ||
7444 | =item SEE ALSO | |
cb1a09d0 | 7445 | |
a45bd81d GS |
7446 | =back |
7447 | ||
8ebc5c01 | 7448 | =head2 AutoSplit - split a package for autoloading |
cb1a09d0 | 7449 | |
d420ca49 | 7450 | =over 4 |
a45bd81d | 7451 | |
8ebc5c01 | 7452 | =item SYNOPSIS |
cb1a09d0 | 7453 | |
8ebc5c01 | 7454 | =item DESCRIPTION |
cb1a09d0 | 7455 | |
193fb0af GS |
7456 | $keep, $check, $modtime |
7457 | ||
d420ca49 | 7458 | =over 4 |
193fb0af GS |
7459 | |
7460 | =item Multiple packages | |
7461 | ||
7462 | =back | |
cb1a09d0 | 7463 | |
8ebc5c01 | 7464 | =item DIAGNOSTICS |
cb1a09d0 | 7465 | |
a45bd81d GS |
7466 | =back |
7467 | ||
fb9cefb4 | 7468 | =head2 B - The Perl Compiler |
193fb0af | 7469 | |
d420ca49 | 7470 | =over 4 |
a45bd81d | 7471 | |
193fb0af GS |
7472 | =item SYNOPSIS |
7473 | ||
7474 | =item DESCRIPTION | |
7475 | ||
fb9cefb4 | 7476 | =item OVERVIEW OF CLASSES |
193fb0af | 7477 | |
d420ca49 | 7478 | =over 4 |
193fb0af | 7479 | |
fb9cefb4 | 7480 | =item SV-RELATED CLASSES |
193fb0af | 7481 | |
fb9cefb4 | 7482 | =item B::SV METHODS |
193fb0af | 7483 | |
fb9cefb4 | 7484 | REFCNT, FLAGS |
193fb0af | 7485 | |
fb9cefb4 | 7486 | =item B::IV METHODS |
193fb0af | 7487 | |
e42c74e1 | 7488 | IV, IVX, UVX, int_value, needs64bits, packiv |
193fb0af | 7489 | |
fb9cefb4 | 7490 | =item B::NV METHODS |
193fb0af | 7491 | |
fb9cefb4 | 7492 | NV, NVX |
193fb0af | 7493 | |
fb9cefb4 | 7494 | =item B::RV METHODS |
193fb0af | 7495 | |
fb9cefb4 | 7496 | RV |
193fb0af | 7497 | |
fb9cefb4 | 7498 | =item B::PV METHODS |
193fb0af | 7499 | |
0d0e97a6 | 7500 | PV, PVX |
193fb0af | 7501 | |
fb9cefb4 | 7502 | =item B::PVMG METHODS |
cb1a09d0 | 7503 | |
fb9cefb4 | 7504 | MAGIC, SvSTASH |
cb1a09d0 | 7505 | |
fb9cefb4 | 7506 | =item B::MAGIC METHODS |
cb1a09d0 | 7507 | |
fb9cefb4 | 7508 | MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR |
cb1a09d0 | 7509 | |
fb9cefb4 | 7510 | =item B::PVLV METHODS |
cb1a09d0 | 7511 | |
fb9cefb4 | 7512 | TARGOFF, TARGLEN, TYPE, TARG |
cb1a09d0 | 7513 | |
fb9cefb4 | 7514 | =item B::BM METHODS |
cb1a09d0 | 7515 | |
fb9cefb4 | 7516 | USEFUL, PREVIOUS, RARE, TABLE |
cb1a09d0 | 7517 | |
fb9cefb4 | 7518 | =item B::GV METHODS |
cb1a09d0 | 7519 | |
e42c74e1 JH |
7520 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, |
7521 | LINE, FILE, FILEGV, GvREFCNT, FLAGS | |
54310121 | 7522 | |
fb9cefb4 | 7523 | =item B::IO METHODS |
cb1a09d0 | 7524 | |
fb9cefb4 GS |
7525 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
7526 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS | |
cb1a09d0 | 7527 | |
fb9cefb4 | 7528 | =item B::AV METHODS |
cb1a09d0 | 7529 | |
fb9cefb4 | 7530 | FILL, MAX, OFF, ARRAY, AvFLAGS |
cb1a09d0 | 7531 | |
fb9cefb4 | 7532 | =item B::CV METHODS |
cb1a09d0 | 7533 | |
a45bd81d | 7534 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY, |
a7ffa9b9 | 7535 | CvFLAGS, const_sv |
cb1a09d0 | 7536 | |
fb9cefb4 | 7537 | =item B::HV METHODS |
f86702cc | 7538 | |
fb9cefb4 | 7539 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
f86702cc | 7540 | |
fb9cefb4 | 7541 | =item OP-RELATED CLASSES |
f86702cc | 7542 | |
fb9cefb4 | 7543 | =item B::OP METHODS |
f86702cc | 7544 | |
c76ac1ee | 7545 | next, sibling, name, ppaddr, desc, targ, type, seq, flags, private |
f86702cc | 7546 | |
fb9cefb4 | 7547 | =item B::UNOP METHOD |
54310121 | 7548 | |
fb9cefb4 | 7549 | first |
dc848c6f | 7550 | |
fb9cefb4 | 7551 | =item B::BINOP METHOD |
54310121 | 7552 | |
fb9cefb4 | 7553 | last |
54310121 | 7554 | |
fb9cefb4 | 7555 | =item B::LOGOP METHOD |
54310121 | 7556 | |
fb9cefb4 | 7557 | other |
54310121 | 7558 | |
fb9cefb4 | 7559 | =item B::LISTOP METHOD |
54310121 | 7560 | |
fb9cefb4 | 7561 | children |
54310121 | 7562 | |
fb9cefb4 | 7563 | =item B::PMOP METHODS |
54310121 | 7564 | |
fb9cefb4 | 7565 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp |
54310121 | 7566 | |
fb9cefb4 | 7567 | =item B::SVOP METHOD |
54310121 | 7568 | |
a45bd81d | 7569 | sv, gv |
54310121 | 7570 | |
a45bd81d | 7571 | =item B::PADOP METHOD |
54310121 | 7572 | |
a45bd81d | 7573 | padix |
54310121 | 7574 | |
fb9cefb4 | 7575 | =item B::PVOP METHOD |
54310121 | 7576 | |
fb9cefb4 | 7577 | pv |
54310121 | 7578 | |
fb9cefb4 | 7579 | =item B::LOOP METHODS |
54310121 | 7580 | |
fb9cefb4 | 7581 | redoop, nextop, lastop |
54310121 | 7582 | |
fb9cefb4 | 7583 | =item B::COP METHODS |
54310121 | 7584 | |
a45bd81d | 7585 | label, stash, file, cop_seq, arybase, line |
54310121 | 7586 | |
fb9cefb4 | 7587 | =back |
54310121 | 7588 | |
fb9cefb4 | 7589 | =item FUNCTIONS EXPORTED BY C<B> |
54310121 | 7590 | |
14218588 GS |
7591 | main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes, |
7592 | sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), | |
1fa7ca25 JH |
7593 | walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV), |
7594 | ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), | |
7595 | threadsv_names | |
54310121 | 7596 | |
fb9cefb4 | 7597 | =item AUTHOR |
54310121 | 7598 | |
a45bd81d GS |
7599 | =back |
7600 | ||
fb9cefb4 GS |
7601 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
7602 | bytecode | |
54310121 | 7603 | |
d420ca49 | 7604 | =over 4 |
a45bd81d | 7605 | |
fb9cefb4 | 7606 | =item SYNOPSIS |
54310121 | 7607 | |
fb9cefb4 | 7608 | =item DESCRIPTION |
54310121 | 7609 | |
fb9cefb4 | 7610 | =item AUTHOR |
54310121 | 7611 | |
a45bd81d GS |
7612 | =back |
7613 | ||
fb9cefb4 | 7614 | =head2 B::Assembler - Assemble Perl bytecode |
54310121 | 7615 | |
d420ca49 | 7616 | =over 4 |
a45bd81d | 7617 | |
fb9cefb4 | 7618 | =item SYNOPSIS |
54310121 | 7619 | |
fb9cefb4 | 7620 | =item DESCRIPTION |
54310121 | 7621 | |
a9ef4385 | 7622 | =item AUTHORS |
54310121 | 7623 | |
a45bd81d GS |
7624 | =back |
7625 | ||
fb9cefb4 | 7626 | =head2 B::Bblock - Walk basic blocks |
54310121 | 7627 | |
d420ca49 | 7628 | =over 4 |
a45bd81d | 7629 | |
fb9cefb4 | 7630 | =item SYNOPSIS |
54310121 | 7631 | |
fb9cefb4 | 7632 | =item DESCRIPTION |
54310121 | 7633 | |
fb9cefb4 | 7634 | =item AUTHOR |
54310121 | 7635 | |
a45bd81d GS |
7636 | =back |
7637 | ||
fb9cefb4 | 7638 | =head2 B::Bytecode - Perl compiler's bytecode backend |
54310121 | 7639 | |
d420ca49 | 7640 | =over 4 |
a45bd81d | 7641 | |
fb9cefb4 | 7642 | =item SYNOPSIS |
54310121 | 7643 | |
fb9cefb4 GS |
7644 | =item DESCRIPTION |
7645 | ||
7646 | =item OPTIONS | |
7647 | ||
a45bd81d | 7648 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, |
a9ef4385 | 7649 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, |
4d4e713d | 7650 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> |
fb9cefb4 | 7651 | |
14218588 GS |
7652 | =item EXAMPLES |
7653 | ||
fb9cefb4 GS |
7654 | =item BUGS |
7655 | ||
a9ef4385 | 7656 | =item AUTHORS |
fb9cefb4 | 7657 | |
a45bd81d GS |
7658 | =back |
7659 | ||
fb9cefb4 GS |
7660 | =head2 B::C - Perl compiler's C backend |
7661 | ||
d420ca49 | 7662 | =over 4 |
a45bd81d | 7663 | |
fb9cefb4 GS |
7664 | =item SYNOPSIS |
7665 | ||
7666 | =item DESCRIPTION | |
7667 | ||
7668 | =item OPTIONS | |
7669 | ||
7670 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
694468e3 | 7671 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit> |
fb9cefb4 GS |
7672 | |
7673 | =item EXAMPLES | |
7674 | ||
7675 | =item BUGS | |
7676 | ||
7677 | =item AUTHOR | |
7678 | ||
a45bd81d GS |
7679 | =back |
7680 | ||
fb9cefb4 GS |
7681 | =head2 B::CC - Perl compiler's optimized C translation backend |
7682 | ||
d420ca49 | 7683 | =over 4 |
a45bd81d | 7684 | |
fb9cefb4 GS |
7685 | =item SYNOPSIS |
7686 | ||
7687 | =item DESCRIPTION | |
7688 | ||
7689 | =item OPTIONS | |
7690 | ||
7691 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
7692 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
7693 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
7694 | ||
7695 | =item EXAMPLES | |
7696 | ||
7697 | =item BUGS | |
7698 | ||
7699 | =item DIFFERENCES | |
7700 | ||
d420ca49 | 7701 | =over 4 |
fb9cefb4 GS |
7702 | |
7703 | =item Loops | |
7704 | ||
7705 | =item Context of ".." | |
7706 | ||
7707 | =item Arithmetic | |
7708 | ||
7709 | =item Deprecated features | |
7710 | ||
7711 | =back | |
7712 | ||
7713 | =item AUTHOR | |
7714 | ||
a45bd81d GS |
7715 | =back |
7716 | ||
76d3c696 JH |
7717 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops |
7718 | ||
7719 | =over 4 | |
7720 | ||
7721 | =item SYNOPSIS | |
7722 | ||
7723 | =item DESCRIPTION | |
7724 | ||
7725 | =item OPTIONS | |
7726 | ||
7727 | B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, | |
7728 | B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>, | |
7729 | B<-terse>, B<-linenoise>, B<-debug>, B<-env> | |
7730 | ||
7731 | =item FORMATTING SPECIFICATIONS | |
7732 | ||
7733 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, | |
7734 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, | |
7735 | B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>, | |
7736 | B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, | |
7737 | B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>, | |
7738 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, | |
7739 | B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, | |
7740 | B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> | |
7741 | ||
7742 | =item ABBREVIATIONS | |
7743 | ||
7744 | =over 4 | |
7745 | ||
7746 | =item OP flags abbreviations | |
7747 | ||
7748 | =item OP class abbreviations | |
7749 | ||
7750 | =back | |
7751 | ||
1fa7ca25 JH |
7752 | =item Using B::Concise outside of the O framework |
7753 | ||
76d3c696 JH |
7754 | =item AUTHOR |
7755 | ||
7756 | =back | |
7757 | ||
fb9cefb4 GS |
7758 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops |
7759 | ||
d420ca49 | 7760 | =over 4 |
a45bd81d | 7761 | |
fb9cefb4 GS |
7762 | =item SYNOPSIS |
7763 | ||
7764 | =item DESCRIPTION | |
7765 | ||
7766 | =item AUTHOR | |
7767 | ||
a45bd81d GS |
7768 | =back |
7769 | ||
fb9cefb4 GS |
7770 | =head2 B::Deparse - Perl compiler backend to produce perl code |
7771 | ||
d420ca49 | 7772 | =over 4 |
a45bd81d | 7773 | |
fb9cefb4 GS |
7774 | =item SYNOPSIS |
7775 | ||
7776 | =item DESCRIPTION | |
7777 | ||
7778 | =item OPTIONS | |
7779 | ||
1fa7ca25 | 7780 | B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>, |
983dbef6 | 7781 | B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> |
c76ac1ee GS |
7782 | |
7783 | =item USING B::Deparse AS A MODULE | |
7784 | ||
d420ca49 | 7785 | =over 4 |
c76ac1ee GS |
7786 | |
7787 | =item Synopsis | |
7788 | ||
7789 | =item Description | |
7790 | ||
7791 | =item new | |
7792 | ||
d2f2ce36 JH |
7793 | =item ambient_pragmas |
7794 | ||
7795 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits | |
7796 | ||
c76ac1ee GS |
7797 | =item coderef2text |
7798 | ||
7799 | =back | |
fb9cefb4 GS |
7800 | |
7801 | =item BUGS | |
7802 | ||
7803 | =item AUTHOR | |
7804 | ||
a45bd81d GS |
7805 | =back |
7806 | ||
fb9cefb4 GS |
7807 | =head2 B::Disassembler - Disassemble Perl bytecode |
7808 | ||
d420ca49 | 7809 | =over 4 |
a45bd81d | 7810 | |
fb9cefb4 GS |
7811 | =item SYNOPSIS |
7812 | ||
7813 | =item DESCRIPTION | |
7814 | ||
7815 | =item AUTHOR | |
7816 | ||
a45bd81d GS |
7817 | =back |
7818 | ||
fb9cefb4 GS |
7819 | =head2 B::Lint - Perl lint |
7820 | ||
d420ca49 | 7821 | =over 4 |
a45bd81d | 7822 | |
fb9cefb4 GS |
7823 | =item SYNOPSIS |
7824 | ||
7825 | =item DESCRIPTION | |
7826 | ||
7827 | =item OPTIONS AND LINT CHECKS | |
7828 | ||
7829 | B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>, | |
7830 | B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> | |
7831 | ||
7832 | =item NON LINT-CHECK OPTIONS | |
7833 | ||
7834 | B<-u Package> | |
7835 | ||
7836 | =item BUGS | |
7837 | ||
7838 | =item AUTHOR | |
7839 | ||
a45bd81d GS |
7840 | =back |
7841 | ||
fb9cefb4 GS |
7842 | =head2 B::O, O - Generic interface to Perl Compiler backends |
7843 | ||
d420ca49 | 7844 | =over 4 |
a45bd81d | 7845 | |
fb9cefb4 GS |
7846 | =item SYNOPSIS |
7847 | ||
7848 | =item DESCRIPTION | |
7849 | ||
7850 | =item CONVENTIONS | |
7851 | ||
7852 | =item IMPLEMENTATION | |
7853 | ||
7854 | =item AUTHOR | |
7855 | ||
a45bd81d GS |
7856 | =back |
7857 | ||
fb9cefb4 GS |
7858 | =head2 B::Showlex - Show lexical variables used in functions or files |
7859 | ||
d420ca49 | 7860 | =over 4 |
a45bd81d | 7861 | |
fb9cefb4 GS |
7862 | =item SYNOPSIS |
7863 | ||
7864 | =item DESCRIPTION | |
7865 | ||
7866 | =item AUTHOR | |
7867 | ||
a45bd81d GS |
7868 | =back |
7869 | ||
fb9cefb4 GS |
7870 | =head2 B::Stackobj - Helper module for CC backend |
7871 | ||
d420ca49 | 7872 | =over 4 |
a45bd81d | 7873 | |
fb9cefb4 GS |
7874 | =item SYNOPSIS |
7875 | ||
7876 | =item DESCRIPTION | |
7877 | ||
7878 | =item AUTHOR | |
7879 | ||
a45bd81d GS |
7880 | =back |
7881 | ||
4755096e GS |
7882 | =head2 B::Stash - show what stashes are loaded |
7883 | ||
fb9cefb4 GS |
7884 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops |
7885 | ||
d420ca49 | 7886 | =over 4 |
a45bd81d | 7887 | |
fb9cefb4 GS |
7888 | =item SYNOPSIS |
7889 | ||
7890 | =item DESCRIPTION | |
7891 | ||
7892 | =item AUTHOR | |
7893 | ||
a45bd81d GS |
7894 | =back |
7895 | ||
fb9cefb4 GS |
7896 | =head2 B::Xref - Generates cross reference reports for Perl programs |
7897 | ||
d420ca49 | 7898 | =over 4 |
a45bd81d | 7899 | |
fb9cefb4 GS |
7900 | =item SYNOPSIS |
7901 | ||
7902 | =item DESCRIPTION | |
7903 | ||
7904 | =item OPTIONS | |
7905 | ||
7906 | C<-oFILENAME>, C<-r>, C<-D[tO]> | |
7907 | ||
7908 | =item BUGS | |
7909 | ||
7910 | =item AUTHOR | |
7911 | ||
a45bd81d GS |
7912 | =back |
7913 | ||
14218588 GS |
7914 | =head2 Bblock, B::Bblock - Walk basic blocks |
7915 | ||
d420ca49 | 7916 | =over 4 |
a45bd81d | 7917 | |
14218588 GS |
7918 | =item SYNOPSIS |
7919 | ||
7920 | =item DESCRIPTION | |
7921 | ||
7922 | =item AUTHOR | |
7923 | ||
a45bd81d GS |
7924 | =back |
7925 | ||
7926 | =head2 Benchmark - benchmark running times of Perl code | |
7927 | ||
d420ca49 | 7928 | =over 4 |
fb9cefb4 GS |
7929 | |
7930 | =item SYNOPSIS | |
7931 | ||
7932 | =item DESCRIPTION | |
7933 | ||
d420ca49 | 7934 | =over 4 |
fb9cefb4 GS |
7935 | |
7936 | =item Methods | |
7937 | ||
c76ac1ee | 7938 | new, debug, iters |
fb9cefb4 GS |
7939 | |
7940 | =item Standard Exports | |
7941 | ||
7942 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
c76ac1ee GS |
7943 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( |
7944 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
fb9cefb4 GS |
7945 | |
7946 | =item Optional Exports | |
7947 | ||
c76ac1ee GS |
7948 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [ |
7949 | STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( | |
7950 | ), enablecache ( ), timesum ( T1, T2 ) | |
fb9cefb4 GS |
7951 | |
7952 | =back | |
7953 | ||
7954 | =item NOTES | |
7955 | ||
a45bd81d GS |
7956 | =item EXAMPLES |
7957 | ||
fb9cefb4 GS |
7958 | =item INHERITANCE |
7959 | ||
7960 | =item CAVEATS | |
7961 | ||
a45bd81d GS |
7962 | =item SEE ALSO |
7963 | ||
fb9cefb4 GS |
7964 | =item AUTHORS |
7965 | ||
7966 | =item MODIFICATION HISTORY | |
7967 | ||
a45bd81d GS |
7968 | =back |
7969 | ||
14218588 GS |
7970 | =head2 ByteLoader - load byte compiled perl code |
7971 | ||
d420ca49 | 7972 | =over 4 |
a45bd81d | 7973 | |
14218588 GS |
7974 | =item SYNOPSIS |
7975 | ||
7976 | =item DESCRIPTION | |
7977 | ||
7978 | =item AUTHOR | |
7979 | ||
7980 | =item SEE ALSO | |
7981 | ||
a45bd81d GS |
7982 | =back |
7983 | ||
14218588 GS |
7984 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend |
7985 | ||
d420ca49 | 7986 | =over 4 |
a45bd81d | 7987 | |
14218588 GS |
7988 | =item SYNOPSIS |
7989 | ||
7990 | =item DESCRIPTION | |
7991 | ||
7992 | =item OPTIONS | |
7993 | ||
a45bd81d | 7994 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, |
a9ef4385 | 7995 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, |
4d4e713d | 7996 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> |
14218588 GS |
7997 | |
7998 | =item EXAMPLES | |
7999 | ||
8000 | =item BUGS | |
8001 | ||
a9ef4385 | 8002 | =item AUTHORS |
14218588 | 8003 | |
a45bd81d GS |
8004 | =back |
8005 | ||
fb9cefb4 GS |
8006 | =head2 CGI - Simple Common Gateway Interface Class |
8007 | ||
d420ca49 | 8008 | =over 4 |
a45bd81d | 8009 | |
fb9cefb4 GS |
8010 | =item SYNOPSIS |
8011 | ||
8012 | =item ABSTRACT | |
8013 | ||
8014 | =item DESCRIPTION | |
8015 | ||
d420ca49 | 8016 | =over 4 |
fb9cefb4 GS |
8017 | |
8018 | =item PROGRAMMING STYLE | |
8019 | ||
8020 | =item CALLING CGI.PM ROUTINES | |
8021 | ||
fb9cefb4 GS |
8022 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): |
8023 | ||
8024 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
8025 | ||
8026 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
8027 | ||
8028 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
8029 | ||
8030 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
8031 | ||
8032 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
8033 | ||
8034 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
8035 | ||
8036 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
8037 | ||
8038 | =item DELETING A PARAMETER COMPLETELY: | |
8039 | ||
8040 | =item DELETING ALL PARAMETERS: | |
8041 | ||
8042 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
8043 | ||
a10cf691 GS |
8044 | =item FETCHING THE PARAMETER LIST AS A HASH: |
8045 | ||
fb9cefb4 GS |
8046 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
8047 | ||
a10cf691 GS |
8048 | =item RETRIEVING CGI ERRORS |
8049 | ||
fb9cefb4 GS |
8050 | =item USING THE FUNCTION-ORIENTED INTERFACE |
8051 | ||
8052 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>, | |
8053 | B<:standard>, B<:all> | |
8054 | ||
8055 | =item PRAGMAS | |
8056 | ||
bd28ded5 JH |
8057 | -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, |
8058 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, | |
8059 | -private_tempfiles | |
fb9cefb4 | 8060 | |
14218588 GS |
8061 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
8062 | ||
8063 | 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a | |
8064 | </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates | |
8065 | a </UL> tag) | |
8066 | ||
8067 | =back | |
fb9cefb4 GS |
8068 | |
8069 | =item GENERATING DYNAMIC DOCUMENTS | |
8070 | ||
d420ca49 | 8071 | =over 4 |
fb9cefb4 GS |
8072 | |
8073 | =item CREATING A STANDARD HTTP HEADER: | |
8074 | ||
8075 | =item GENERATING A REDIRECTION HEADER | |
8076 | ||
8077 | =item CREATING THE HTML DOCUMENT HEADER | |
8078 | ||
8079 | B<Parameters:>, 4, 5, 6.. | |
8080 | ||
8081 | =item ENDING THE HTML DOCUMENT: | |
8082 | ||
8083 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
8084 | ||
8085 | =item OBTAINING THE SCRIPT'S URL | |
8086 | ||
8087 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
37d4d706 | 8088 | (B<-query_string>), B<-base> |
fb9cefb4 | 8089 | |
14218588 GS |
8090 | =item MIXING POST AND URL PARAMETERS |
8091 | ||
fb9cefb4 GS |
8092 | =back |
8093 | ||
8094 | =item CREATING STANDARD HTML ELEMENTS: | |
8095 | ||
d420ca49 | 8096 | =over 4 |
fb9cefb4 GS |
8097 | |
8098 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
8099 | ||
8100 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
8101 | ||
8102 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
8103 | ||
8104 | =item NON-STANDARD HTML SHORTCUTS | |
8105 | ||
d722968f JH |
8106 | =item AUTOESCAPING HTML |
8107 | ||
8108 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
8109 | charset([$charset]);, $flag = autoEscape([$flag]); | |
8110 | ||
14218588 GS |
8111 | =item PRETTY-PRINTING HTML |
8112 | ||
fb9cefb4 GS |
8113 | =back |
8114 | ||
8115 | =item CREATING FILL-OUT FORMS: | |
8116 | ||
d420ca49 | 8117 | =over 4 |
fb9cefb4 GS |
8118 | |
8119 | =item CREATING AN ISINDEX TAG | |
8120 | ||
8121 | =item STARTING AND ENDING A FORM | |
8122 | ||
8123 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
8124 | ||
8125 | =item CREATING A TEXT FIELD | |
8126 | ||
8127 | B<Parameters> | |
8128 | ||
8129 | =item CREATING A BIG TEXT FIELD | |
8130 | ||
8131 | =item CREATING A PASSWORD FIELD | |
8132 | ||
8133 | =item CREATING A FILE UPLOAD FIELD | |
8134 | ||
8135 | B<Parameters> | |
8136 | ||
8137 | =item CREATING A POPUP MENU | |
8138 | ||
8139 | =item CREATING A SCROLLING LIST | |
8140 | ||
8141 | B<Parameters:> | |
8142 | ||
8143 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
54310121 | 8144 | |
8145 | B<Parameters:> | |
8146 | ||
8147 | =item CREATING A STANDALONE CHECKBOX | |
8148 | ||
8149 | B<Parameters:> | |
8150 | ||
8151 | =item CREATING A RADIO BUTTON GROUP | |
8152 | ||
8153 | B<Parameters:> | |
8154 | ||
8155 | =item CREATING A SUBMIT BUTTON | |
8156 | ||
8157 | B<Parameters:> | |
8158 | ||
8159 | =item CREATING A RESET BUTTON | |
8160 | ||
8161 | =item CREATING A DEFAULT BUTTON | |
8162 | ||
8163 | =item CREATING A HIDDEN FIELD | |
8164 | ||
8165 | B<Parameters:> | |
8166 | ||
8167 | =item CREATING A CLICKABLE IMAGE BUTTON | |
8168 | ||
ab648d5e | 8169 | B<Parameters:> |
54310121 | 8170 | |
8171 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
8172 | ||
8173 | =back | |
8174 | ||
14218588 | 8175 | =item HTTP COOKIES |
54310121 | 8176 | |
8177 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
8178 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
8179 | ||
14218588 | 8180 | =item WORKING WITH FRAMES |
54310121 | 8181 | |
8182 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
8183 | document in the HTTP header, 3. Specify the destination for the document in | |
8184 | the <FORM> tag | |
8185 | ||
c90c0ff4 | 8186 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
8187 | ||
54310121 | 8188 | =item DEBUGGING |
8189 | ||
d420ca49 | 8190 | =over 4 |
54310121 | 8191 | |
8192 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
8193 | ||
8194 | =back | |
8195 | ||
8196 | =item FETCHING ENVIRONMENT VARIABLES | |
8197 | ||
14218588 | 8198 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
ab648d5e JH |
8199 | B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>, |
8200 | B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, | |
37d4d706 JH |
8201 | B<server_software ()>, B<remote_user ()>, B<user_name ()>, |
8202 | B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
54310121 | 8203 | |
fb9cefb4 | 8204 | =item USING NPH SCRIPTS |
54310121 | 8205 | |
fb9cefb4 | 8206 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
ab648d5e | 8207 | parameters |
54310121 | 8208 | |
fb9cefb4 | 8209 | =item Server Push |
54310121 | 8210 | |
2d967e39 | 8211 | multipart_init(), multipart_start(), multipart_end(), multipart_final() |
54310121 | 8212 | |
fb9cefb4 | 8213 | =item Avoiding Denial of Service Attacks |
54310121 | 8214 | |
fb9cefb4 GS |
8215 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
8216 | basis>, B<2. Globally for all scripts> | |
54310121 | 8217 | |
fb9cefb4 | 8218 | =item COMPATIBILITY WITH CGI-LIB.PL |
54310121 | 8219 | |
8220 | =item AUTHOR INFORMATION | |
8221 | ||
8222 | =item CREDITS | |
8223 | ||
8224 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
8225 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
8226 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
14218588 GS |
8227 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
8228 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
8229 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
8230 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
8231 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
8232 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
8233 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
8234 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
8235 | ...and many many more.. | |
54310121 | 8236 | |
8237 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
8238 | ||
8239 | =item BUGS | |
8240 | ||
8241 | =item SEE ALSO | |
8242 | ||
a45bd81d GS |
8243 | =back |
8244 | ||
8245 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
8246 | ||
d420ca49 | 8247 | =over 4 |
54310121 | 8248 | |
8249 | =item SYNOPSIS | |
8250 | ||
a45bd81d GS |
8251 | =item ABSTRACT |
8252 | ||
54310121 | 8253 | =item DESCRIPTION |
8254 | ||
a45bd81d | 8255 | =item AUTHOR INFORMATION |
137443ea | 8256 | |
a45bd81d | 8257 | =item BUGS |
54310121 | 8258 | |
8259 | =item SEE ALSO | |
8260 | ||
a45bd81d | 8261 | =back |
54310121 | 8262 | |
8263 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
8264 | other) error log | |
8265 | ||
d420ca49 | 8266 | =over 4 |
a45bd81d | 8267 | |
54310121 | 8268 | =item SYNOPSIS |
8269 | ||
8270 | =item DESCRIPTION | |
8271 | ||
8272 | =item REDIRECTING ERROR MESSAGES | |
8273 | ||
8274 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
8275 | ||
d420ca49 | 8276 | =over 4 |
fb9cefb4 GS |
8277 | |
8278 | =item Changing the default message | |
8279 | ||
8280 | =back | |
8281 | ||
10862624 RF |
8282 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS |
8283 | ||
54310121 | 8284 | =item CHANGE LOG |
8285 | ||
8286 | =item AUTHORS | |
8287 | ||
8288 | =item SEE ALSO | |
8289 | ||
a45bd81d GS |
8290 | =back |
8291 | ||
fb9cefb4 GS |
8292 | =head2 CGI::Cookie - Interface to Netscape Cookies |
8293 | ||
d420ca49 | 8294 | =over 4 |
a45bd81d | 8295 | |
fb9cefb4 GS |
8296 | =item SYNOPSIS |
8297 | ||
8298 | =item DESCRIPTION | |
8299 | ||
8300 | =item USING CGI::Cookie | |
8301 | ||
8302 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
8303 | ||
d420ca49 | 8304 | =over 4 |
fb9cefb4 GS |
8305 | |
8306 | =item Creating New Cookies | |
8307 | ||
8308 | =item Sending the Cookie to the Browser | |
8309 | ||
8310 | =item Recovering Previous Cookies | |
8311 | ||
8312 | =item Manipulating Cookies | |
8313 | ||
8314 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
8315 | ||
8316 | =back | |
8317 | ||
8318 | =item AUTHOR INFORMATION | |
8319 | ||
8320 | =item BUGS | |
8321 | ||
8322 | =item SEE ALSO | |
8323 | ||
a45bd81d GS |
8324 | =back |
8325 | ||
54310121 | 8326 | =head2 CGI::Fast - CGI Interface for Fast CGI |
8327 | ||
d420ca49 | 8328 | =over 4 |
a45bd81d | 8329 | |
54310121 | 8330 | =item SYNOPSIS |
8331 | ||
8332 | =item DESCRIPTION | |
8333 | ||
8334 | =item OTHER PIECES OF THE PUZZLE | |
8335 | ||
8336 | =item WRITING FASTCGI PERL SCRIPTS | |
8337 | ||
8338 | =item INSTALLING FASTCGI SCRIPTS | |
8339 | ||
8340 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
8341 | ||
8342 | =item CAVEATS | |
8343 | ||
8344 | =item AUTHOR INFORMATION | |
8345 | ||
8346 | =item BUGS | |
8347 | ||
8348 | =item SEE ALSO | |
8349 | ||
a45bd81d GS |
8350 | =back |
8351 | ||
c76ac1ee GS |
8352 | =head2 CGI::Pretty - module to produce nicely formatted HTML code |
8353 | ||
d420ca49 | 8354 | =over 4 |
a45bd81d | 8355 | |
c76ac1ee GS |
8356 | =item SYNOPSIS |
8357 | ||
8358 | =item DESCRIPTION | |
8359 | ||
d420ca49 | 8360 | =over 4 |
c76ac1ee GS |
8361 | |
8362 | =item Tags that won't be formatted | |
8363 | ||
a45bd81d GS |
8364 | =item Customizing the Indenting |
8365 | ||
c76ac1ee GS |
8366 | =back |
8367 | ||
8368 | =item BUGS | |
8369 | ||
8370 | =item AUTHOR | |
8371 | ||
8372 | =item SEE ALSO | |
8373 | ||
a45bd81d GS |
8374 | =back |
8375 | ||
54310121 | 8376 | =head2 CGI::Push - Simple Interface to Server Push |
8377 | ||
d420ca49 | 8378 | =over 4 |
a45bd81d | 8379 | |
54310121 | 8380 | =item SYNOPSIS |
8381 | ||
8382 | =item DESCRIPTION | |
8383 | ||
8384 | =item USING CGI::Push | |
8385 | ||
2d967e39 | 8386 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph |
54310121 | 8387 | |
d420ca49 | 8388 | =over 4 |
fb9cefb4 GS |
8389 | |
8390 | =item Heterogeneous Pages | |
8391 | ||
8392 | =item Changing the Page Delay on the Fly | |
8393 | ||
8394 | =back | |
8395 | ||
54310121 | 8396 | =item INSTALLING CGI::Push SCRIPTS |
8397 | ||
54310121 | 8398 | =item AUTHOR INFORMATION |
8399 | ||
8400 | =item BUGS | |
8401 | ||
8402 | =item SEE ALSO | |
8403 | ||
a45bd81d GS |
8404 | =back |
8405 | ||
8406 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
8407 | ||
d420ca49 | 8408 | =over 4 |
54310121 | 8409 | |
8410 | =item SYNOPSIS | |
8411 | ||
a45bd81d GS |
8412 | =item ABSTRACT |
8413 | ||
54310121 | 8414 | =item DESCRIPTION |
8415 | ||
a45bd81d | 8416 | =item AUTHOR INFORMATION |
54310121 | 8417 | |
a45bd81d GS |
8418 | =item BUGS |
8419 | ||
8420 | =item SEE ALSO | |
8421 | ||
8422 | =back | |
54310121 | 8423 | |
2d967e39 JH |
8424 | =head2 CGI::Util - Internal utilities used by CGI module |
8425 | ||
8426 | =over 4 | |
8427 | ||
8428 | =item SYNOPSIS | |
8429 | ||
8430 | =item DESCRIPTION | |
8431 | ||
8432 | =item AUTHOR INFORMATION | |
8433 | ||
8434 | =item SEE ALSO | |
8435 | ||
8436 | =back | |
8437 | ||
8ebc5c01 | 8438 | =head2 CPAN - query, download and build perl modules from CPAN sites |
cb1a09d0 | 8439 | |
d420ca49 | 8440 | =over 4 |
a45bd81d | 8441 | |
8ebc5c01 | 8442 | =item SYNOPSIS |
cb1a09d0 | 8443 | |
8ebc5c01 | 8444 | =item DESCRIPTION |
cb1a09d0 | 8445 | |
d420ca49 | 8446 | =over 4 |
cb1a09d0 | 8447 | |
8ebc5c01 | 8448 | =item Interactive Mode |
cb1a09d0 | 8449 | |
8ebc5c01 | 8450 | Searching for authors, bundles, distribution files and modules, make, test, |
694468e3 | 8451 | install, clean modules or distributions, get, readme, look module or |
f40a6c71 | 8452 | distribution, ls author, Signals |
cb1a09d0 | 8453 | |
8ebc5c01 | 8454 | =item CPAN::Shell |
cb1a09d0 | 8455 | |
774d564b | 8456 | =item autobundle |
8457 | ||
8458 | =item recompile | |
8459 | ||
d516a115 | 8460 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
dc848c6f | 8461 | |
10862624 | 8462 | =item Programmer's interface |
cb1a09d0 | 8463 | |
165c0277 JH |
8464 | expand($type,@things), expandany(@things), Programming Examples |
8465 | ||
8466 | =item Methods in the other Classes | |
8467 | ||
8468 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), | |
8469 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), | |
8470 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), | |
8471 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), | |
8472 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), | |
8473 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), | |
8474 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), | |
8475 | CPAN::Bundle::readme(), CPAN::Bundle::test(), | |
8476 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), | |
8477 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), | |
8478 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), | |
8479 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), | |
8480 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), | |
8481 | CPAN::Distribution::look(), CPAN::Distribution::make(), | |
8482 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), | |
8483 | CPAN::Distribution::test(), CPAN::Distribution::uptodate(), | |
8484 | CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), | |
8485 | CPAN::Module::as_glimpse(), CPAN::Module::as_string(), | |
8486 | CPAN::Module::clean(), CPAN::Module::cpan_file(), | |
8487 | CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), | |
8488 | CPAN::Module::description(), CPAN::Module::force($method,@args), | |
8489 | CPAN::Module::get(), CPAN::Module::inst_file(), | |
8490 | CPAN::Module::inst_version(), CPAN::Module::install(), | |
8491 | CPAN::Module::look(), CPAN::Module::make(), | |
8492 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), | |
8493 | CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() | |
d516a115 | 8494 | |
8ebc5c01 | 8495 | =item Cache Manager |
cb1a09d0 | 8496 | |
8ebc5c01 | 8497 | =item Bundles |
cb1a09d0 | 8498 | |
774d564b | 8499 | =item Prerequisites |
cb1a09d0 | 8500 | |
fb9cefb4 GS |
8501 | =item Finding packages and VERSION |
8502 | ||
774d564b | 8503 | =item Debugging |
8504 | ||
14218588 | 8505 | =item Floppy, Zip, Offline Mode |
cb1a09d0 AD |
8506 | |
8507 | =back | |
8508 | ||
8ebc5c01 | 8509 | =item CONFIGURATION |
cb1a09d0 | 8510 | |
694468e3 GS |
8511 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> |
8512 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
8513 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
8514 | [unshift|push|splice] E<lt>listE<gt>> | |
cb1a09d0 | 8515 | |
d420ca49 | 8516 | =over 4 |
d516a115 | 8517 | |
14218588 GS |
8518 | =item Note on urllist parameter's format |
8519 | ||
8520 | =item urllist parameter has CD-ROM support | |
d516a115 JH |
8521 | |
8522 | =back | |
8523 | ||
8ebc5c01 | 8524 | =item SECURITY |
cb1a09d0 | 8525 | |
8ebc5c01 | 8526 | =item EXPORT |
cb1a09d0 | 8527 | |
14218588 GS |
8528 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
8529 | ||
8530 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
8531 | ||
d420ca49 | 8532 | =over 4 |
10862624 RF |
8533 | |
8534 | =item Three basic types of firewalls | |
8535 | ||
14218588 GS |
8536 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade |
8537 | ||
93d73c42 | 8538 | =item Configuring lynx or ncftp for going through a firewall |
10862624 RF |
8539 | |
8540 | =back | |
8541 | ||
8542 | =item FAQ | |
8543 | ||
ab648d5e | 8544 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10) |
10862624 | 8545 | |
774d564b | 8546 | =item BUGS |
cb1a09d0 AD |
8547 | |
8548 | =item AUTHOR | |
8549 | ||
f40a6c71 SC |
8550 | =item TRANSLATIONS |
8551 | ||
8ebc5c01 | 8552 | =item SEE ALSO |
cb1a09d0 | 8553 | |
a45bd81d GS |
8554 | =back |
8555 | ||
8ebc5c01 | 8556 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
cb1a09d0 | 8557 | |
d420ca49 | 8558 | =over 4 |
a45bd81d | 8559 | |
cb1a09d0 AD |
8560 | =item SYNOPSIS |
8561 | ||
cb1a09d0 AD |
8562 | =item DESCRIPTION |
8563 | ||
a45bd81d GS |
8564 | =back |
8565 | ||
8ebc5c01 | 8566 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
8567 | module | |
cb1a09d0 | 8568 | |
d420ca49 | 8569 | =over 4 |
a45bd81d | 8570 | |
cb1a09d0 AD |
8571 | =item SYNOPSIS |
8572 | ||
cb1a09d0 AD |
8573 | =item DESCRIPTION |
8574 | ||
8ebc5c01 | 8575 | =item SEE ALSO |
cb1a09d0 | 8576 | |
a45bd81d GS |
8577 | =back |
8578 | ||
d516a115 | 8579 | =head2 Carp, carp - warn of errors (from perspective of caller) |
cb1a09d0 | 8580 | |
d420ca49 | 8581 | =over 4 |
a45bd81d | 8582 | |
8ebc5c01 | 8583 | =item SYNOPSIS |
cb1a09d0 | 8584 | |
8ebc5c01 | 8585 | =item DESCRIPTION |
cb1a09d0 | 8586 | |
d420ca49 | 8587 | =over 4 |
d516a115 JH |
8588 | |
8589 | =item Forcing a Stack Trace | |
8590 | ||
8591 | =back | |
8592 | ||
14218588 GS |
8593 | =item BUGS |
8594 | ||
a45bd81d GS |
8595 | =back |
8596 | ||
ab648d5e JH |
8597 | =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside |
8598 | ||
0d0e97a6 JH |
8599 | =head2 Class::ISA -- report the search path for a class's ISA tree |
8600 | ||
8601 | =over 4 | |
8602 | ||
8603 | =item SYNOPSIS | |
8604 | ||
8605 | =item DESCRIPTION | |
8606 | ||
8607 | =item FUNCTIONS | |
8608 | ||
8609 | the function Class::ISA::super_path($CLASS), the function | |
8610 | Class::ISA::self_and_super_path($CLASS), the function | |
8611 | Class::ISA::self_and_super_versions($CLASS) | |
8612 | ||
8613 | =item CAUTIONARY NOTES | |
8614 | ||
8615 | =item COPYRIGHT | |
8616 | ||
8617 | =item AUTHOR | |
8618 | ||
8619 | =back | |
8620 | ||
8cc95fdb | 8621 | =head2 Class::Struct - declare struct-like datatypes as Perl classes |
cb1a09d0 | 8622 | |
d420ca49 | 8623 | =over 4 |
a45bd81d | 8624 | |
cb1a09d0 AD |
8625 | =item SYNOPSIS |
8626 | ||
cb1a09d0 AD |
8627 | =item DESCRIPTION |
8628 | ||
d420ca49 | 8629 | =over 4 |
8cc95fdb | 8630 | |
8631 | =item The C<struct()> function | |
8632 | ||
d420ca49 AD |
8633 | =item Class Creation at Compile Time |
8634 | ||
8cc95fdb | 8635 | =item Element Types and Accessor Methods |
8636 | ||
8637 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
8638 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
8639 | ||
a10cf691 GS |
8640 | =item Initializing with C<new> |
8641 | ||
8cc95fdb | 8642 | =back |
8643 | ||
8ebc5c01 | 8644 | =item EXAMPLES |
cb1a09d0 | 8645 | |
a10cf691 | 8646 | Example 1, Example 2, Example 3 |
cb1a09d0 | 8647 | |
8cc95fdb | 8648 | =item Author and Modification History |
cb1a09d0 | 8649 | |
a45bd81d GS |
8650 | =back |
8651 | ||
14218588 GS |
8652 | =head2 Config - access Perl configuration information |
8653 | ||
d420ca49 | 8654 | =over 4 |
a45bd81d | 8655 | |
14218588 GS |
8656 | =item SYNOPSIS |
8657 | ||
8658 | =item DESCRIPTION | |
8659 | ||
8660 | myconfig(), config_sh(), config_vars(@names) | |
8661 | ||
8662 | =item EXAMPLE | |
8663 | ||
8664 | =item WARNING | |
8665 | ||
8666 | =item GLOSSARY | |
8667 | ||
d420ca49 | 8668 | =over 4 |
14218588 GS |
8669 | |
8670 | =item _ | |
8671 | ||
8672 | C<_a>, C<_exe>, C<_o> | |
8673 | ||
8674 | =item a | |
8675 | ||
640374d0 JH |
8676 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, |
8677 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, | |
8678 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, | |
8679 | C<awk> | |
14218588 GS |
8680 | |
8681 | =item b | |
8682 | ||
c76ac1ee GS |
8683 | C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>, |
8684 | C<byacc>, C<byteorder> | |
14218588 GS |
8685 | |
8686 | =item c | |
8687 | ||
8688 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
93d73c42 JH |
8689 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, |
8690 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
772ff3b9 JH |
8691 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, |
8692 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, | |
5440bc8e | 8693 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh> |
14218588 GS |
8694 | |
8695 | =item d | |
8696 | ||
2cc61e15 DD |
8697 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, |
8698 | C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>, | |
8699 | C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, | |
8700 | C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, | |
0d0e97a6 | 8701 | C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_crypt>, |
2ef53570 JH |
8702 | C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, |
8703 | C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, | |
8704 | C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>, | |
8705 | C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>, | |
4f233aa4 JH |
8706 | C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, |
8707 | C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>, | |
8708 | C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, | |
8709 | C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, | |
8710 | C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, | |
8711 | C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, | |
8712 | C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, | |
8713 | C<d_gethent>, C<d_gethname>, C<d_gethostprotos>, C<d_getitimer>, | |
8714 | C<d_getlogin>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, | |
8715 | C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpagsz>, | |
8716 | C<d_getpbyname>, C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, | |
8717 | C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, C<d_getprior>, | |
8718 | C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, C<d_getsbyname>, | |
8719 | C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, C<d_getspnam>, | |
8720 | C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, | |
8721 | C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, | |
8722 | C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, | |
8723 | C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, | |
8724 | C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, | |
8725 | C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, | |
8726 | C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, | |
8727 | C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, | |
8728 | C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, | |
8729 | C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, | |
8730 | C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, | |
354a27bf JH |
8731 | C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, |
8732 | C<d_nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>, | |
8733 | C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, | |
8734 | C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, | |
8735 | C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, | |
8736 | C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, | |
8737 | C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>, | |
8738 | C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, | |
8739 | C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>, | |
8740 | C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, | |
8741 | C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, | |
4f233aa4 JH |
8742 | C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, |
8743 | C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>, | |
0d0e97a6 JH |
8744 | C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>, |
8745 | C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>, | |
8746 | C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>, | |
8747 | C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, | |
8748 | C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>, | |
8749 | C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>, | |
8750 | C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, | |
8751 | C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, | |
2ef53570 JH |
8752 | C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, |
8753 | C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, | |
8754 | C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>, | |
8755 | C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, | |
8756 | C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>, | |
8757 | C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>, | |
8758 | C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strftime>, | |
8759 | C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>, | |
8760 | C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, | |
8761 | C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>, | |
d2f2ce36 JH |
8762 | C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, |
8763 | C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>, | |
8764 | C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>, | |
2ef53570 JH |
8765 | C<d_uname>, C<d_union_semun>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, |
8766 | C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, | |
8767 | C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>, | |
8768 | C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, | |
8769 | C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>, | |
8770 | C<db_version_major>, C<db_version_minor>, C<db_version_patch>, | |
8771 | C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>, | |
8772 | C<drand01>, C<dynamic_ext> | |
14218588 GS |
8773 | |
8774 | =item e | |
8775 | ||
8776 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>, | |
8777 | C<exe_ext>, C<expr>, C<extensions> | |
8778 | ||
8779 | =item f | |
8780 | ||
8781 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
5440bc8e JH |
8782 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, |
8783 | C<full_sed> | |
14218588 GS |
8784 | |
8785 | =item g | |
8786 | ||
d396a558 JH |
8787 | C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, |
8788 | C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> | |
14218588 GS |
8789 | |
8790 | =item h | |
8791 | ||
91331b4f | 8792 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat> |
14218588 GS |
8793 | |
8794 | =item i | |
8795 | ||
a45bd81d GS |
8796 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, |
8797 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>, | |
8798 | C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>, | |
354a27bf JH |
8799 | C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_langinfo>, |
8800 | C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, | |
8801 | C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>, | |
d396a558 JH |
8802 | C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>, |
8803 | C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>, | |
8804 | C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>, | |
8805 | C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>, | |
8806 | C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>, | |
8807 | C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>, | |
8808 | C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>, | |
8809 | C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>, | |
8810 | C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>, | |
8811 | C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>, | |
8812 | C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>, | |
8813 | C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>, | |
8814 | C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>, | |
8815 | C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>, | |
37d4d706 JH |
8816 | C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>, |
8817 | C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, | |
4b661809 JH |
8818 | C<installvendorlib>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, |
8819 | C<ivtype> | |
14218588 GS |
8820 | |
8821 | =item k | |
8822 | ||
8823 | C<known_extensions>, C<ksh> | |
8824 | ||
8825 | =item l | |
8826 | ||
91331b4f JH |
8827 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, |
8828 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
8829 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
8830 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
8831 | C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>, | |
8832 | C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype> | |
14218588 GS |
8833 | |
8834 | =item m | |
8835 | ||
8836 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
8837 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
8838 | C<man3direxp>, C<man3ext> | |
8839 | ||
8840 | =item M | |
8841 | ||
91331b4f JH |
8842 | C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>, |
8843 | C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname> | |
14218588 GS |
8844 | |
8845 | =item n | |
8846 | ||
165c0277 JH |
8847 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, |
8848 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, | |
8849 | C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>, | |
8850 | C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype> | |
14218588 GS |
8851 | |
8852 | =item o | |
8853 | ||
8854 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
d722968f | 8855 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> |
14218588 GS |
8856 | |
8857 | =item p | |
8858 | ||
694468e3 | 8859 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, |
640374d0 | 8860 | C<perl>, C<perl_patchlevel> |
a45bd81d GS |
8861 | |
8862 | =item P | |
8863 | ||
8864 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
91331b4f JH |
8865 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, |
8866 | C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, | |
8867 | C<privlibexp>, C<prototype>, C<ptrsize> | |
a45bd81d GS |
8868 | |
8869 | =item q | |
8870 | ||
8871 | C<quadkind>, C<quadtype> | |
14218588 GS |
8872 | |
8873 | =item r | |
8874 | ||
694468e3 | 8875 | C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, |
5440bc8e | 8876 | C<revision>, C<rm>, C<rmail>, C<run>, C<runnm> |
14218588 GS |
8877 | |
8878 | =item s | |
8879 | ||
8880 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
8881 | C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>, | |
8882 | C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>, | |
dc5c060f JH |
8883 | C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>, |
8884 | C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, | |
8885 | C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, | |
8886 | C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, | |
8887 | C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, | |
8888 | C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, | |
8889 | C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, | |
8890 | C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, | |
8891 | C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, | |
8892 | C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, | |
8893 | C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman> | |
14218588 GS |
8894 | |
8895 | =item t | |
8896 | ||
5440bc8e JH |
8897 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, |
8898 | C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff> | |
14218588 GS |
8899 | |
8900 | =item u | |
8901 | ||
a45bd81d GS |
8902 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, |
8903 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
694468e3 | 8904 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, |
5440bc8e JH |
8905 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>, |
8906 | C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, | |
8907 | C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, | |
8908 | C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, | |
8909 | C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, | |
8910 | C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat> | |
14218588 GS |
8911 | |
8912 | =item v | |
8913 | ||
b38f6a39 GS |
8914 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, |
8915 | C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>, | |
37d4d706 | 8916 | C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags> |
14218588 GS |
8917 | |
8918 | =item x | |
8919 | ||
694468e3 | 8920 | C<xlibpth>, C<xs_apiversion> |
14218588 | 8921 | |
fc6a272d JH |
8922 | =item y |
8923 | ||
8924 | C<yacc>, C<yaccflags> | |
8925 | ||
14218588 GS |
8926 | =item z |
8927 | ||
8928 | C<zcat>, C<zip> | |
8929 | ||
8930 | =back | |
8931 | ||
8932 | =item NOTE | |
8933 | ||
a45bd81d GS |
8934 | =back |
8935 | ||
ab1e085c | 8936 | =head2 Cwd - get pathname of current working directory |
cb1a09d0 | 8937 | |
d420ca49 | 8938 | =over 4 |
a45bd81d | 8939 | |
8ebc5c01 | 8940 | =item SYNOPSIS |
cb1a09d0 | 8941 | |
8ebc5c01 | 8942 | =item DESCRIPTION |
cb1a09d0 | 8943 | |
a45bd81d GS |
8944 | =back |
8945 | ||
14218588 GS |
8946 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
8947 | subject to | |
8948 | change) | |
8949 | ||
d420ca49 | 8950 | =over 4 |
a45bd81d | 8951 | |
14218588 GS |
8952 | =item SYNOPSIS |
8953 | ||
8954 | =item DESCRIPTION | |
8955 | ||
d420ca49 | 8956 | =over 4 |
14218588 GS |
8957 | |
8958 | =item Global Variables | |
8959 | ||
8960 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
8961 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
8962 | $DB::lineno | |
8963 | ||
8964 | =item API Methods | |
8965 | ||
8966 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
8967 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
8968 | ||
8969 | =item Client Callback Methods | |
8970 | ||
8971 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
8972 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
8973 | CLIENT->output(LIST) | |
8974 | ||
8975 | =back | |
8976 | ||
8977 | =item BUGS | |
8978 | ||
8979 | =item AUTHOR | |
8980 | ||
a45bd81d GS |
8981 | =back |
8982 | ||
d516a115 | 8983 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
cb1a09d0 | 8984 | |
d420ca49 | 8985 | =over 4 |
a45bd81d | 8986 | |
cb1a09d0 AD |
8987 | =item SYNOPSIS |
8988 | ||
cb1a09d0 AD |
8989 | =item DESCRIPTION |
8990 | ||
8ebc5c01 | 8991 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
cb1a09d0 | 8992 | |
d420ca49 | 8993 | =over 4 |
cb1a09d0 | 8994 | |
c76ac1ee | 8995 | =item Using DB_File with Berkeley DB version 2 or 3 |
d516a115 | 8996 | |
68dc0745 | 8997 | =item Interface to Berkeley DB |
cb1a09d0 | 8998 | |
8ebc5c01 | 8999 | =item Opening a Berkeley DB Database File |
cb1a09d0 | 9000 | |
8ebc5c01 | 9001 | =item Default Parameters |
cb1a09d0 | 9002 | |
8ebc5c01 | 9003 | =item In Memory Databases |
cb1a09d0 AD |
9004 | |
9005 | =back | |
9006 | ||
8ebc5c01 | 9007 | =item DB_HASH |
cb1a09d0 | 9008 | |
d420ca49 | 9009 | =over 4 |
cb1a09d0 | 9010 | |
68dc0745 | 9011 | =item A Simple Example |
cb1a09d0 | 9012 | |
8ebc5c01 | 9013 | =back |
cb1a09d0 | 9014 | |
8ebc5c01 | 9015 | =item DB_BTREE |
cb1a09d0 | 9016 | |
d420ca49 | 9017 | =over 4 |
cb1a09d0 | 9018 | |
8ebc5c01 | 9019 | =item Changing the BTREE sort order |
cb1a09d0 | 9020 | |
68dc0745 | 9021 | =item Handling Duplicate Keys |
cb1a09d0 | 9022 | |
68dc0745 | 9023 | =item The get_dup() Method |
cb1a09d0 | 9024 | |
14218588 GS |
9025 | =item The find_dup() Method |
9026 | ||
9027 | =item The del_dup() Method | |
9028 | ||
8ebc5c01 | 9029 | =item Matching Partial Keys |
cb1a09d0 | 9030 | |
8ebc5c01 | 9031 | =back |
cb1a09d0 | 9032 | |
8ebc5c01 | 9033 | =item DB_RECNO |
cb1a09d0 | 9034 | |
d420ca49 | 9035 | =over 4 |
cb1a09d0 | 9036 | |
68dc0745 | 9037 | =item The 'bval' Option |
cb1a09d0 | 9038 | |
8ebc5c01 | 9039 | =item A Simple Example |
cb1a09d0 | 9040 | |
14218588 | 9041 | =item Extra RECNO Methods |
cb1a09d0 | 9042 | |
8ebc5c01 | 9043 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
1fa7ca25 JH |
9044 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, |
9045 | length, elements);> | |
cb1a09d0 | 9046 | |
8ebc5c01 | 9047 | =item Another Example |
cb1a09d0 | 9048 | |
8ebc5c01 | 9049 | =back |
cb1a09d0 | 9050 | |
8ebc5c01 | 9051 | =item THE API INTERFACE |
cb1a09d0 | 9052 | |
8ebc5c01 | 9053 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
9054 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
9055 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
9056 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
cb1a09d0 | 9057 | |
c76ac1ee GS |
9058 | =item DBM FILTERS |
9059 | ||
9060 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
9061 | B<filter_fetch_value> | |
9062 | ||
d420ca49 | 9063 | =over 4 |
c76ac1ee GS |
9064 | |
9065 | =item The Filter | |
9066 | ||
9067 | =item An Example -- the NULL termination problem. | |
9068 | ||
9069 | =item Another Example -- Key is a C int. | |
9070 | ||
9071 | =back | |
9072 | ||
8ebc5c01 | 9073 | =item HINTS AND TIPS |
cb1a09d0 | 9074 | |
d420ca49 | 9075 | =over 4 |
8ebc5c01 | 9076 | |
a45bd81d GS |
9077 | =item Locking: The Trouble with fd |
9078 | ||
9079 | =item Safe ways to lock a database | |
9080 | ||
9081 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
cb1a09d0 | 9082 | |
68dc0745 | 9083 | =item Sharing Databases With C Applications |
cb1a09d0 | 9084 | |
68dc0745 | 9085 | =item The untie() Gotcha |
4fdae800 | 9086 | |
8ebc5c01 | 9087 | =back |
cb1a09d0 | 9088 | |
8ebc5c01 | 9089 | =item COMMON QUESTIONS |
cb1a09d0 | 9090 | |
d420ca49 | 9091 | =over 4 |
cb1a09d0 | 9092 | |
8ebc5c01 | 9093 | =item Why is there Perl source in my database? |
cb1a09d0 | 9094 | |
8ebc5c01 | 9095 | =item How do I store complex data structures with DB_File? |
cb1a09d0 | 9096 | |
8ebc5c01 | 9097 | =item What does "Invalid Argument" mean? |
cb1a09d0 | 9098 | |
8ebc5c01 | 9099 | =item What does "Bareword 'DB_File' not allowed" mean? |
cb1a09d0 | 9100 | |
8ebc5c01 | 9101 | =back |
cb1a09d0 | 9102 | |
c76ac1ee GS |
9103 | =item REFERENCES |
9104 | ||
8ebc5c01 | 9105 | =item HISTORY |
cb1a09d0 | 9106 | |
8ebc5c01 | 9107 | =item BUGS |
cb1a09d0 | 9108 | |
8ebc5c01 | 9109 | =item AVAILABILITY |
cb1a09d0 | 9110 | |
d516a115 JH |
9111 | =item COPYRIGHT |
9112 | ||
8ebc5c01 | 9113 | =item SEE ALSO |
cb1a09d0 | 9114 | |
8ebc5c01 | 9115 | =item AUTHOR |
cb1a09d0 | 9116 | |
a45bd81d GS |
9117 | =back |
9118 | ||
fb9cefb4 GS |
9119 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
9120 | printing and C<eval> | |
9121 | ||
d420ca49 | 9122 | =over 4 |
a45bd81d | 9123 | |
fb9cefb4 GS |
9124 | =item SYNOPSIS |
9125 | ||
9126 | =item DESCRIPTION | |
9127 | ||
d420ca49 | 9128 | =over 4 |
fb9cefb4 GS |
9129 | |
9130 | =item Methods | |
9131 | ||
14218588 | 9132 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
b38f6a39 GS |
9133 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), |
9134 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
9135 | I<$OBJ>->Reset | |
fb9cefb4 GS |
9136 | |
9137 | =item Functions | |
9138 | ||
b38f6a39 | 9139 | Dumper(I<LIST>) |
fb9cefb4 GS |
9140 | |
9141 | =item Configuration Variables or Methods | |
9142 | ||
9143 | $Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>), | |
9144 | $Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>), | |
9145 | $Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>), | |
9146 | $Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>), | |
9147 | $Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>), | |
9148 | $Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>), | |
9149 | $Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>), | |
9150 | $Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>), | |
9151 | $Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>), | |
9152 | $Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>), | |
c76ac1ee GS |
9153 | $Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>), |
9154 | $Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>) | |
fb9cefb4 GS |
9155 | |
9156 | =item Exports | |
9157 | ||
9158 | Dumper | |
9159 | ||
9160 | =back | |
9161 | ||
9162 | =item EXAMPLES | |
9163 | ||
9164 | =item BUGS | |
9165 | ||
9166 | =item AUTHOR | |
9167 | ||
9168 | =item VERSION | |
9169 | ||
9170 | =item SEE ALSO | |
9171 | ||
a45bd81d GS |
9172 | =back |
9173 | ||
c76ac1ee GS |
9174 | =head2 Devel::DProf - a Perl code profiler |
9175 | ||
d420ca49 | 9176 | =over 4 |
a45bd81d | 9177 | |
c76ac1ee GS |
9178 | =item SYNOPSIS |
9179 | ||
9180 | =item DESCRIPTION | |
9181 | ||
9182 | =item PROFILE FORMAT | |
9183 | ||
9184 | =item AUTOLOAD | |
9185 | ||
9186 | =item ENVIRONMENT | |
9187 | ||
9188 | =item BUGS | |
9189 | ||
9190 | =item SEE ALSO | |
9191 | ||
a45bd81d GS |
9192 | =back |
9193 | ||
14218588 GS |
9194 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
9195 | ||
d420ca49 | 9196 | =over 4 |
a45bd81d | 9197 | |
14218588 GS |
9198 | =item SYNOPSIS |
9199 | ||
9200 | =item DESCRIPTION | |
9201 | ||
d420ca49 | 9202 | =over 4 |
37d4d706 JH |
9203 | |
9204 | =item Memory footprint debugging | |
9205 | ||
9206 | =back | |
9207 | ||
14218588 GS |
9208 | =item EXAMPLES |
9209 | ||
d420ca49 | 9210 | =over 4 |
14218588 GS |
9211 | |
9212 | =item A simple scalar string | |
9213 | ||
9214 | =item A simple scalar number | |
9215 | ||
9216 | =item A simple scalar with an extra reference | |
9217 | ||
9218 | =item A reference to a simple scalar | |
9219 | ||
9220 | =item A reference to an array | |
9221 | ||
9222 | =item A reference to a hash | |
9223 | ||
9224 | =item Dumping a large array or hash | |
9225 | ||
9226 | =item A reference to an SV which holds a C pointer | |
9227 | ||
9228 | =item A reference to a subroutine | |
9229 | ||
9230 | =back | |
9231 | ||
9232 | =item EXPORTS | |
9233 | ||
9234 | =item BUGS | |
9235 | ||
9236 | =item AUTHOR | |
9237 | ||
9238 | =item SEE ALSO | |
9239 | ||
a45bd81d GS |
9240 | =back |
9241 | ||
8ebc5c01 | 9242 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
cb1a09d0 | 9243 | |
d420ca49 | 9244 | =over 4 |
a45bd81d | 9245 | |
8ebc5c01 | 9246 | =item SYNOPSIS |
cb1a09d0 | 9247 | |
8ebc5c01 | 9248 | =item DESCRIPTION |
cb1a09d0 | 9249 | |
a45bd81d GS |
9250 | =back |
9251 | ||
ab1e085c JH |
9252 | =head2 Digest:: - Modules that calculate message digests |
9253 | ||
9254 | =over 4 | |
9255 | ||
9256 | =item SYNOPSIS | |
9257 | ||
9258 | =item DESCRIPTION | |
9259 | ||
9260 | I<binary>, I<hex>, I<base64> | |
9261 | ||
9262 | =item OO INTERFACE | |
9263 | ||
9264 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = | |
9265 | Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), | |
9266 | $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest | |
9267 | ||
9268 | =item SEE ALSO | |
9269 | ||
9270 | =item AUTHOR | |
9271 | ||
9272 | =back | |
9273 | ||
9274 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm | |
9275 | ||
9276 | =over 4 | |
9277 | ||
9278 | =item SYNOPSIS | |
9279 | ||
9280 | =item DESCRIPTION | |
9281 | ||
9282 | =item FUNCTIONS | |
9283 | ||
9284 | md5($data,...), md5_hex($data,...), md5_base64($data,...) | |
9285 | ||
9286 | =item METHODS | |
9287 | ||
9288 | $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), | |
9289 | $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest | |
9290 | ||
9291 | =item EXAMPLES | |
9292 | ||
9293 | =item SEE ALSO | |
9294 | ||
9295 | =item COPYRIGHT | |
9296 | ||
9297 | =item AUTHORS | |
9298 | ||
9299 | =back | |
9300 | ||
8ebc5c01 | 9301 | =head2 DirHandle - supply object methods for directory handles |
cb1a09d0 | 9302 | |
d420ca49 | 9303 | =over 4 |
a45bd81d | 9304 | |
8ebc5c01 | 9305 | =item SYNOPSIS |
cb1a09d0 | 9306 | |
8ebc5c01 | 9307 | =item DESCRIPTION |
cb1a09d0 | 9308 | |
ac4dd294 JH |
9309 | =item NOTES |
9310 | ||
a45bd81d GS |
9311 | =back |
9312 | ||
14218588 GS |
9313 | =head2 Dumpvalue - provides screen dump of Perl data. |
9314 | ||
d420ca49 | 9315 | =over 4 |
a45bd81d | 9316 | |
c76ac1ee | 9317 | =item SYNOPSIS |
14218588 GS |
9318 | |
9319 | =item DESCRIPTION | |
9320 | ||
d420ca49 | 9321 | =over 4 |
14218588 GS |
9322 | |
9323 | =item Creation | |
9324 | ||
9325 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
9326 | C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>, | |
9327 | C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
9328 | stopDbSignal | |
9329 | ||
9330 | =item Methods | |
9331 | ||
9332 | dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump, | |
9333 | veryCompact, set, get | |
9334 | ||
9335 | =back | |
9336 | ||
a45bd81d GS |
9337 | =back |
9338 | ||
14218588 GS |
9339 | =head2 DynaLoader - Dynamically load C libraries into Perl code |
9340 | ||
d420ca49 | 9341 | =over 4 |
a45bd81d | 9342 | |
14218588 GS |
9343 | =item SYNOPSIS |
9344 | ||
9345 | =item DESCRIPTION | |
9346 | ||
9347 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
9348 | @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), | |
b38f6a39 | 9349 | dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(), |
14218588 GS |
9350 | dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), |
9351 | bootstrap() | |
9352 | ||
9353 | =item AUTHOR | |
9354 | ||
a45bd81d GS |
9355 | =back |
9356 | ||
9357 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
9358 | Perl code | |
9359 | ||
d420ca49 | 9360 | =over 4 |
a45bd81d GS |
9361 | |
9362 | =item SYNOPSIS | |
9363 | ||
9364 | =item DESCRIPTION | |
9365 | ||
9366 | =item AUTHOR | |
9367 | ||
9368 | =back | |
9369 | ||
91331b4f JH |
9370 | =head2 Encode - character encodings |
9371 | ||
d420ca49 | 9372 | =over 4 |
91331b4f | 9373 | |
2d967e39 JH |
9374 | =item SYNOPSIS |
9375 | ||
9376 | =item DESCRIPTION | |
9377 | ||
9378 | =over 4 | |
9379 | ||
91331b4f JH |
9380 | =item TERMINOLOGY |
9381 | ||
2d967e39 JH |
9382 | =back |
9383 | ||
9384 | =item ENCODINGS | |
9385 | ||
9386 | =over 4 | |
9387 | ||
9388 | =item Characteristics of an Encoding | |
91331b4f | 9389 | |
2d967e39 | 9390 | =item Types of Encodings |
91331b4f | 9391 | |
2d967e39 JH |
9392 | Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings, |
9393 | Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings | |
91331b4f | 9394 | |
2d967e39 | 9395 | =item Specifying Encodings |
91331b4f | 9396 | |
2d967e39 | 9397 | 1. By name, 2. As an object |
91331b4f | 9398 | |
2d967e39 JH |
9399 | =item Encoding Names |
9400 | ||
9401 | The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry, | |
9402 | The name used by the the organization that defined it | |
9403 | ||
9404 | =back | |
9405 | ||
9406 | =item PERL ENCODING API | |
9407 | ||
9408 | =over 4 | |
9409 | ||
9410 | =item Generic Encoding Interface | |
91331b4f JH |
9411 | |
9412 | =item Handling Malformed Data | |
9413 | ||
2d967e39 JH |
9414 | Scheme 1, Scheme 2, Other Schemes |
9415 | ||
9416 | =item UTF-8 / utf8 | |
9417 | ||
9418 | =item Other Encodings of Unicode | |
9419 | ||
fc6a272d JH |
9420 | =item Listing available encodings |
9421 | ||
9422 | =item Defining Aliases | |
9423 | ||
9424 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
9425 | reference, e.g.: | |
9426 | ||
9427 | =item Defining Encodings | |
9428 | ||
2d967e39 JH |
9429 | =back |
9430 | ||
9431 | =item Encoding and IO | |
9432 | ||
9433 | =item Encoding How to ... | |
9434 | ||
9435 | IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 | |
1fa7ca25 | 9436 | strings in binary data, Perl/Encode wrappers on non-Unicode XS modules |
2d967e39 JH |
9437 | |
9438 | =item Messing with Perl's Internals | |
9439 | ||
4d4e713d | 9440 | is_utf8(STRING [, CHECK]), valid_utf8(STRING) |
2d967e39 JH |
9441 | |
9442 | =item IMPLEMENTATION CLASSES | |
9443 | ||
9444 | -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check), | |
9445 | -E<gt>decode($octets,$check) | |
9446 | ||
9447 | =over 4 | |
9448 | ||
9449 | =item Compiled Encodings | |
9450 | ||
9451 | .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other | |
9452 | variants of EBCDIC, symbol and dingbats as used by Tk on X11 | |
9453 | ||
9454 | =back | |
9455 | ||
9456 | =item SEE ALSO | |
9457 | ||
91331b4f JH |
9458 | =back |
9459 | ||
165c0277 JH |
9460 | =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables |
9461 | of the Encode extension | |
9462 | ||
9463 | =over 4 | |
9464 | ||
9465 | =item DESCRIPTION | |
9466 | ||
9467 | [1] B<S>, [2] B<D>, [3] B<M>, [4] B<E> | |
9468 | ||
9469 | =item KEYWORDS | |
9470 | ||
9471 | =item COPYRIGHT | |
9472 | ||
9473 | =back | |
9474 | ||
fc6a272d JH |
9475 | =head2 Encode::Tcl - Tcl encodings |
9476 | ||
165c0277 JH |
9477 | =head2 EncodeFormat - the format of encoding tables of the Encode extension |
9478 | ||
9479 | =over 4 | |
9480 | ||
9481 | =item DESCRIPTION | |
9482 | ||
9483 | [1] B<S>, [2] B<D>, [3] B<M>, [4] B<E> | |
9484 | ||
9485 | =item KEYWORDS | |
9486 | ||
9487 | =item COPYRIGHT | |
9488 | ||
9489 | =back | |
9490 | ||
8ebc5c01 | 9491 | =head2 English - use nice English (or awk) names for ugly punctuation |
9492 | variables | |
cb1a09d0 | 9493 | |
d420ca49 | 9494 | =over 4 |
a45bd81d | 9495 | |
8ebc5c01 | 9496 | =item SYNOPSIS |
cb1a09d0 | 9497 | |
8ebc5c01 | 9498 | =item DESCRIPTION |
cb1a09d0 | 9499 | |
497711e7 | 9500 | =item PERFORMANCE |
694468e3 | 9501 | |
a45bd81d GS |
9502 | =back |
9503 | ||
b38f6a39 GS |
9504 | =head2 Env - perl module that imports environment variables as scalars or |
9505 | arrays | |
cb1a09d0 | 9506 | |
d420ca49 | 9507 | =over 4 |
a45bd81d | 9508 | |
cb1a09d0 AD |
9509 | =item SYNOPSIS |
9510 | ||
cb1a09d0 AD |
9511 | =item DESCRIPTION |
9512 | ||
b38f6a39 GS |
9513 | =item LIMITATIONS |
9514 | ||
8ebc5c01 | 9515 | =item AUTHOR |
cb1a09d0 | 9516 | |
a45bd81d GS |
9517 | =back |
9518 | ||
9038e305 JH |
9519 | =head2 Errno - System errno constants |
9520 | ||
9521 | =over 4 | |
9522 | ||
9523 | =item SYNOPSIS | |
9524 | ||
9525 | =item DESCRIPTION | |
9526 | ||
9527 | =item CAVEATS | |
9528 | ||
9529 | =item AUTHOR | |
9530 | ||
9531 | =item COPYRIGHT | |
9532 | ||
9533 | =back | |
9534 | ||
8ebc5c01 | 9535 | =head2 Exporter - Implements default import method for modules |
cb1a09d0 | 9536 | |
d420ca49 | 9537 | =over 4 |
a45bd81d | 9538 | |
8ebc5c01 | 9539 | =item SYNOPSIS |
cb1a09d0 | 9540 | |
8ebc5c01 | 9541 | =item DESCRIPTION |
cb1a09d0 | 9542 | |
d420ca49 | 9543 | =over 4 |
cb1a09d0 | 9544 | |
c76ac1ee GS |
9545 | =item How to Export |
9546 | ||
8ebc5c01 | 9547 | =item Selecting What To Export |
cb1a09d0 | 9548 | |
8ebc5c01 | 9549 | =item Specialised Import Lists |
cb1a09d0 | 9550 | |
d516a115 JH |
9551 | =item Exporting without using Export's import method |
9552 | ||
8ebc5c01 | 9553 | =item Module Version Checking |
cb1a09d0 | 9554 | |
8ebc5c01 | 9555 | =item Managing Unknown Symbols |
cb1a09d0 | 9556 | |
8ebc5c01 | 9557 | =item Tag Handling Utility Functions |
cb1a09d0 | 9558 | |
8ebc5c01 | 9559 | =back |
cb1a09d0 | 9560 | |
a45bd81d GS |
9561 | =back |
9562 | ||
c76ac1ee GS |
9563 | =head2 Exporter::Heavy - Exporter guts |
9564 | ||
d420ca49 | 9565 | =over 4 |
a45bd81d | 9566 | |
c76ac1ee GS |
9567 | =item SYNOPIS |
9568 | ||
9569 | =item DESCRIPTION | |
9570 | ||
a45bd81d GS |
9571 | =back |
9572 | ||
68dc0745 | 9573 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
9574 | Makefiles etc. | |
9575 | ||
d420ca49 | 9576 | =over 4 |
a45bd81d | 9577 | |
dc848c6f | 9578 | =item SYNOPSIS |
68dc0745 | 9579 | |
9580 | =item DESCRIPTION | |
9581 | ||
a45bd81d GS |
9582 | =back |
9583 | ||
9584 | cat | |
9585 | ||
9586 | eqtime src dst | |
9587 | ||
9588 | rm_f files... | |
9589 | ||
9590 | rm_f files... | |
9591 | ||
9592 | touch files .. | |
9593 | ||
9594 | mv source... destination | |
9595 | ||
9596 | cp source... destination | |
9597 | ||
9598 | chmod mode files.. | |
9599 | ||
9600 | mkpath directory.. | |
9601 | ||
9602 | test_f file | |
9603 | ||
d420ca49 | 9604 | =over 4 |
68dc0745 | 9605 | |
9606 | =item BUGS | |
9607 | ||
9608 | =item SEE ALSO | |
9609 | ||
9610 | =item AUTHOR | |
9611 | ||
a45bd81d GS |
9612 | =back |
9613 | ||
772ff3b9 JH |
9614 | =head2 ExtUtils::Constant - generate XS code to import C header constants |
9615 | ||
9616 | =over 4 | |
9617 | ||
9618 | =item SYNOPSIS | |
9619 | ||
9620 | =item DESCRIPTION | |
9621 | ||
9622 | =item USAGE | |
9623 | ||
9038e305 | 9624 | IV, UV, NV, PV, PVN, PVN, YES, NO, UNDEF |
772ff3b9 JH |
9625 | |
9626 | =item FUNCTIONS | |
9627 | ||
9628 | =back | |
9629 | ||
9630 | C_stringify NAME | |
9631 | ||
9632 | constant_types | |
9633 | ||
9634 | memEQ_clause NAME, CHECKED_AT, INDENT | |
9635 | ||
9038e305 | 9636 | assign INDENT, TYPE, PRE, POST, VALUE.. |
2ef53570 | 9637 | |
4f233aa4 | 9638 | return_clause |
772ff3b9 | 9639 | |
ac4dd294 JH |
9640 | switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. |
9641 | ||
772ff3b9 JH |
9642 | params WHAT |
9643 | ||
ac4dd294 | 9644 | dump_names |
2ef53570 | 9645 | |
9038e305 JH |
9646 | C_constant, name, type, value, macro, default, pre, post, def_pre =item |
9647 | def_post | |
772ff3b9 JH |
9648 | |
9649 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME | |
9650 | ||
2ef53570 | 9651 | autoload PACKAGE, VERSION, AUTOLOADER |
772ff3b9 | 9652 | |
9038e305 JH |
9653 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, |
9654 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME | |
9655 | ||
772ff3b9 JH |
9656 | =over 4 |
9657 | ||
9658 | =item AUTHOR | |
9659 | ||
9660 | =back | |
9661 | ||
8ebc5c01 | 9662 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
cb1a09d0 | 9663 | |
d420ca49 | 9664 | =over 4 |
a45bd81d | 9665 | |
cb1a09d0 AD |
9666 | =item SYNOPSIS |
9667 | ||
cb1a09d0 AD |
9668 | =item DESCRIPTION |
9669 | ||
8ebc5c01 | 9670 | =item @EXPORT |
cb1a09d0 | 9671 | |
8ebc5c01 | 9672 | =item FUNCTIONS |
cb1a09d0 | 9673 | |
8ebc5c01 | 9674 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
9675 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
cb1a09d0 | 9676 | |
8ebc5c01 | 9677 | =item EXAMPLES |
cb1a09d0 | 9678 | |
8ebc5c01 | 9679 | =item SEE ALSO |
cb1a09d0 | 9680 | |
8ebc5c01 | 9681 | =item AUTHOR |
cb1a09d0 | 9682 | |
a45bd81d GS |
9683 | =back |
9684 | ||
8ebc5c01 | 9685 | =head2 ExtUtils::Install - install files from here to there |
cb1a09d0 | 9686 | |
d420ca49 | 9687 | =over 4 |
a45bd81d | 9688 | |
8ebc5c01 | 9689 | =item SYNOPSIS |
cb1a09d0 | 9690 | |
8ebc5c01 | 9691 | =item DESCRIPTION |
cb1a09d0 | 9692 | |
a45bd81d GS |
9693 | =back |
9694 | ||
193fb0af GS |
9695 | =head2 ExtUtils::Installed - Inventory management of installed modules |
9696 | ||
d420ca49 | 9697 | =over 4 |
a45bd81d | 9698 | |
193fb0af GS |
9699 | =item SYNOPSIS |
9700 | ||
9701 | =item DESCRIPTION | |
9702 | ||
9703 | =item USAGE | |
9704 | ||
9705 | =item FUNCTIONS | |
9706 | ||
9707 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
9708 | packlist(), version() | |
9709 | ||
fb9cefb4 GS |
9710 | =item EXAMPLE |
9711 | ||
193fb0af GS |
9712 | =item AUTHOR |
9713 | ||
a45bd81d GS |
9714 | =back |
9715 | ||
8ebc5c01 | 9716 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
cb1a09d0 | 9717 | |
d420ca49 | 9718 | =over 4 |
a45bd81d | 9719 | |
8ebc5c01 | 9720 | =item SYNOPSIS |
cb1a09d0 | 9721 | |
8ebc5c01 | 9722 | =item DESCRIPTION |
cb1a09d0 | 9723 | |
8ebc5c01 | 9724 | For static extensions, For dynamic extensions, For dynamic extensions |
cb1a09d0 | 9725 | |
d420ca49 | 9726 | =over 4 |
cb1a09d0 | 9727 | |
8ebc5c01 | 9728 | =item EXTRALIBS |
cb1a09d0 | 9729 | |
8ebc5c01 | 9730 | =item LDLOADLIBS and LD_RUN_PATH |
cb1a09d0 | 9731 | |
8ebc5c01 | 9732 | =item BSLOADLIBS |
cb1a09d0 | 9733 | |
8ebc5c01 | 9734 | =back |
cb1a09d0 | 9735 | |
8ebc5c01 | 9736 | =item PORTABILITY |
cb1a09d0 | 9737 | |
d420ca49 | 9738 | =over 4 |
cb1a09d0 | 9739 | |
8ebc5c01 | 9740 | =item VMS implementation |
cb1a09d0 | 9741 | |
3e3baf6d TB |
9742 | =item Win32 implementation |
9743 | ||
8ebc5c01 | 9744 | =back |
cb1a09d0 | 9745 | |
8ebc5c01 | 9746 | =item SEE ALSO |
cb1a09d0 | 9747 | |
a45bd81d GS |
9748 | =back |
9749 | ||
14218588 GS |
9750 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
9751 | ExtUtils::MakeMaker | |
9752 | ||
d420ca49 | 9753 | =over 4 |
a45bd81d | 9754 | |
14218588 GS |
9755 | =item SYNOPSIS |
9756 | ||
9757 | =item DESCRIPTION | |
9758 | ||
9759 | canonpath, cflags, manifypods, perl_archive | |
9760 | ||
a45bd81d GS |
9761 | =back |
9762 | ||
9038e305 JH |
9763 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in |
9764 | ExtUtils::MakeMaker | |
9765 | ||
9766 | =over 4 | |
9767 | ||
9768 | =item SYNOPSIS | |
9769 | ||
9770 | =item DESCRIPTION | |
9771 | ||
9772 | =back | |
9773 | ||
9774 | catfile | |
9775 | ||
9776 | constants (o) | |
9777 | ||
9778 | static_lib (o) | |
9779 | ||
9780 | dynamic_bs (o) | |
9781 | ||
9782 | dynamic_lib (o) | |
9783 | ||
9784 | canonpath | |
9785 | ||
9786 | perl_script | |
9787 | ||
9788 | pm_to_blib | |
9789 | ||
9790 | test_via_harness (o) | |
9791 | ||
9792 | tool_autosplit (override) | |
9793 | ||
9794 | tools_other (o) | |
9795 | ||
9796 | xs_o (o) | |
9797 | ||
9798 | top_targets (o) | |
9799 | ||
9800 | htmlifypods (o) | |
9801 | ||
9802 | manifypods (o) | |
9803 | ||
9804 | dist_ci (o) | |
9805 | ||
9806 | dist_core (o) | |
9807 | ||
9808 | pasthru (o) | |
9809 | ||
8ebc5c01 | 9810 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
9811 | ExtUtils::MakeMaker | |
cb1a09d0 | 9812 | |
d420ca49 | 9813 | =over 4 |
a45bd81d | 9814 | |
8ebc5c01 | 9815 | =item SYNOPSIS |
cb1a09d0 | 9816 | |
8ebc5c01 | 9817 | =item DESCRIPTION |
cb1a09d0 | 9818 | |
4d4e713d JH |
9819 | =item METHODS |
9820 | ||
a45bd81d GS |
9821 | =back |
9822 | ||
4d4e713d JH |
9823 | perl_archive_after |
9824 | ||
8ebc5c01 | 9825 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
cb1a09d0 | 9826 | |
d420ca49 | 9827 | =over 4 |
a45bd81d | 9828 | |
8ebc5c01 | 9829 | =item SYNOPSIS |
cb1a09d0 | 9830 | |
8ebc5c01 | 9831 | =item DESCRIPTION |
cb1a09d0 | 9832 | |
8ebc5c01 | 9833 | =item METHODS |
cb1a09d0 | 9834 | |
d420ca49 | 9835 | =over 4 |
cb1a09d0 | 9836 | |
8ebc5c01 | 9837 | =item Preloaded methods |
cb1a09d0 | 9838 | |
a45bd81d | 9839 | canonpath |
cb1a09d0 | 9840 | |
8ebc5c01 | 9841 | =back |
cb1a09d0 | 9842 | |
a45bd81d | 9843 | =back |
cb1a09d0 | 9844 | |
a45bd81d | 9845 | catdir |
cb1a09d0 | 9846 | |
a45bd81d | 9847 | catfile |
cb1a09d0 | 9848 | |
a45bd81d | 9849 | curdir |
cb1a09d0 | 9850 | |
a45bd81d | 9851 | rootdir |
cb1a09d0 | 9852 | |
a45bd81d | 9853 | updir |
cb1a09d0 | 9854 | |
d420ca49 | 9855 | =over 4 |
cb1a09d0 | 9856 | |
8ebc5c01 | 9857 | =item SelfLoaded methods |
cb1a09d0 | 9858 | |
a45bd81d | 9859 | c_o (o) |
cb1a09d0 | 9860 | |
8ebc5c01 | 9861 | =back |
cb1a09d0 | 9862 | |
a45bd81d | 9863 | cflags (o) |
68dc0745 | 9864 | |
a45bd81d | 9865 | clean (o) |
68dc0745 | 9866 | |
a45bd81d | 9867 | const_cccmd (o) |
68dc0745 | 9868 | |
a45bd81d | 9869 | const_config (o) |
68dc0745 | 9870 | |
a45bd81d | 9871 | const_loadlibs (o) |
cb1a09d0 | 9872 | |
a45bd81d | 9873 | constants (o) |
cb1a09d0 | 9874 | |
a45bd81d | 9875 | depend (o) |
cb1a09d0 | 9876 | |
a45bd81d | 9877 | dir_target (o) |
cb1a09d0 | 9878 | |
a45bd81d | 9879 | dist (o) |
cb1a09d0 | 9880 | |
a45bd81d | 9881 | dist_basics (o) |
cb1a09d0 | 9882 | |
a45bd81d | 9883 | dist_ci (o) |
cb1a09d0 | 9884 | |
a45bd81d | 9885 | dist_core (o) |
7d2bfb28 | 9886 | |
a45bd81d | 9887 | dist_dir (o) |
7d2bfb28 | 9888 | |
a45bd81d | 9889 | dist_test (o) |
7d2bfb28 | 9890 | |
a45bd81d | 9891 | dlsyms (o) |
7d2bfb28 | 9892 | |
a45bd81d | 9893 | dynamic (o) |
7d2bfb28 | 9894 | |
a45bd81d | 9895 | dynamic_bs (o) |
7d2bfb28 | 9896 | |
a45bd81d | 9897 | dynamic_lib (o) |
7d2bfb28 | 9898 | |
a45bd81d | 9899 | exescan |
cb1a09d0 | 9900 | |
a45bd81d | 9901 | extliblist |
cb1a09d0 | 9902 | |
a45bd81d | 9903 | file_name_is_absolute |
cb1a09d0 | 9904 | |
a45bd81d | 9905 | find_perl |
cb1a09d0 | 9906 | |
d420ca49 | 9907 | =over 4 |
cb1a09d0 | 9908 | |
a45bd81d | 9909 | =item Methods to actually produce chunks of text for the Makefile |
cb1a09d0 | 9910 | |
a45bd81d | 9911 | fixin |
cb1a09d0 | 9912 | |
a45bd81d | 9913 | =back |
cb1a09d0 | 9914 | |
a45bd81d | 9915 | force (o) |
d516a115 | 9916 | |
a45bd81d | 9917 | guess_name |
cb1a09d0 | 9918 | |
a45bd81d | 9919 | has_link_code |
14218588 | 9920 | |
a45bd81d | 9921 | htmlifypods (o) |
14218588 | 9922 | |
a45bd81d | 9923 | init_dirscan |
cb1a09d0 | 9924 | |
a45bd81d | 9925 | init_main |
cb1a09d0 | 9926 | |
a45bd81d | 9927 | init_others |
cb1a09d0 | 9928 | |
a45bd81d | 9929 | install (o) |
cb1a09d0 | 9930 | |
a45bd81d | 9931 | installbin (o) |
cb1a09d0 | 9932 | |
a45bd81d | 9933 | libscan (o) |
cb1a09d0 | 9934 | |
a45bd81d | 9935 | linkext (o) |
cb1a09d0 | 9936 | |
a45bd81d | 9937 | lsdir |
cb1a09d0 | 9938 | |
a45bd81d | 9939 | macro (o) |
cb1a09d0 | 9940 | |
a45bd81d | 9941 | makeaperl (o) |
cb1a09d0 | 9942 | |
a45bd81d | 9943 | makefile (o) |
cb1a09d0 | 9944 | |
a45bd81d | 9945 | manifypods (o) |
cb1a09d0 | 9946 | |
a45bd81d | 9947 | maybe_command |
14218588 | 9948 | |
a45bd81d | 9949 | maybe_command_in_dirs |
14218588 | 9950 | |
a45bd81d | 9951 | needs_linking (o) |
14218588 | 9952 | |
a45bd81d | 9953 | nicetext |
14218588 | 9954 | |
a45bd81d | 9955 | parse_version |
cb1a09d0 | 9956 | |
a45bd81d | 9957 | parse_abstract |
cb1a09d0 | 9958 | |
a45bd81d | 9959 | pasthru (o) |
cb1a09d0 | 9960 | |
a45bd81d | 9961 | path |
cb1a09d0 | 9962 | |
a45bd81d | 9963 | perl_script |
cb1a09d0 | 9964 | |
a45bd81d | 9965 | perldepend (o) |
402d0d99 | 9966 | |
a45bd81d | 9967 | ppd |
402d0d99 | 9968 | |
a45bd81d | 9969 | perm_rw (o) |
402d0d99 | 9970 | |
a45bd81d | 9971 | perm_rwx (o) |
402d0d99 | 9972 | |
a45bd81d | 9973 | pm_to_blib |
193fb0af | 9974 | |
a45bd81d | 9975 | post_constants (o) |
193fb0af | 9976 | |
a45bd81d | 9977 | post_initialize (o) |
193fb0af | 9978 | |
a45bd81d | 9979 | postamble (o) |
193fb0af | 9980 | |
a45bd81d | 9981 | prefixify |
193fb0af | 9982 | |
a45bd81d | 9983 | processPL (o) |
193fb0af | 9984 | |
a45bd81d | 9985 | realclean (o) |
fb9cefb4 | 9986 | |
a45bd81d | 9987 | replace_manpage_separator |
193fb0af | 9988 | |
a45bd81d | 9989 | static (o) |
cb1a09d0 | 9990 | |
a45bd81d GS |
9991 | static_lib (o) |
9992 | ||
9993 | staticmake (o) | |
9994 | ||
9995 | subdir_x (o) | |
9996 | ||
9997 | subdirs (o) | |
9998 | ||
9999 | test (o) | |
10000 | ||
10001 | test_via_harness (o) | |
10002 | ||
10003 | test_via_script (o) | |
10004 | ||
10005 | tool_autosplit (o) | |
10006 | ||
10007 | tools_other (o) | |
10008 | ||
10009 | tool_xsubpp (o) | |
10010 | ||
10011 | top_targets (o) | |
10012 | ||
10013 | writedoc | |
10014 | ||
10015 | xs_c (o) | |
10016 | ||
10017 | xs_cpp (o) | |
10018 | ||
10019 | xs_o (o) | |
10020 | ||
10021 | perl_archive | |
10022 | ||
fc6a272d JH |
10023 | perl_archive_after |
10024 | ||
a45bd81d GS |
10025 | export_list |
10026 | ||
d420ca49 | 10027 | =over 4 |
a45bd81d GS |
10028 | |
10029 | =item SEE ALSO | |
10030 | ||
10031 | =back | |
10032 | ||
10033 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
10034 | ExtUtils::MakeMaker | |
10035 | ||
d420ca49 | 10036 | =over 4 |
a45bd81d GS |
10037 | |
10038 | =item SYNOPSIS | |
10039 | ||
10040 | =item DESCRIPTION | |
10041 | ||
d420ca49 | 10042 | =over 4 |
a45bd81d GS |
10043 | |
10044 | =item Methods always loaded | |
10045 | ||
10046 | wraplist | |
10047 | ||
10048 | =back | |
10049 | ||
10050 | =back | |
10051 | ||
10052 | rootdir (override) | |
10053 | ||
d420ca49 | 10054 | =over 4 |
a45bd81d GS |
10055 | |
10056 | =item SelfLoaded methods | |
10057 | ||
10058 | guess_name (override) | |
10059 | ||
10060 | =back | |
10061 | ||
10062 | find_perl (override) | |
10063 | ||
10064 | path (override) | |
10065 | ||
10066 | maybe_command (override) | |
10067 | ||
10068 | maybe_command_in_dirs (override) | |
10069 | ||
10070 | perl_script (override) | |
10071 | ||
10072 | file_name_is_absolute (override) | |
10073 | ||
10074 | replace_manpage_separator | |
10075 | ||
10076 | init_others (override) | |
10077 | ||
10078 | constants (override) | |
10079 | ||
10080 | cflags (override) | |
10081 | ||
10082 | const_cccmd (override) | |
10083 | ||
10084 | pm_to_blib (override) | |
10085 | ||
10086 | tool_autosplit (override) | |
10087 | ||
10088 | tool_sxubpp (override) | |
10089 | ||
10090 | xsubpp_version (override) | |
10091 | ||
10092 | tools_other (override) | |
10093 | ||
10094 | dist (override) | |
10095 | ||
10096 | c_o (override) | |
10097 | ||
10098 | xs_c (override) | |
10099 | ||
10100 | xs_o (override) | |
10101 | ||
10102 | top_targets (override) | |
10103 | ||
10104 | dlsyms (override) | |
10105 | ||
10106 | dynamic_lib (override) | |
10107 | ||
10108 | dynamic_bs (override) | |
10109 | ||
10110 | static_lib (override) | |
10111 | ||
10112 | manifypods (override) | |
10113 | ||
10114 | processPL (override) | |
10115 | ||
10116 | installbin (override) | |
10117 | ||
10118 | subdir_x (override) | |
10119 | ||
10120 | clean (override) | |
10121 | ||
10122 | realclean (override) | |
10123 | ||
10124 | dist_basics (override) | |
10125 | ||
10126 | dist_core (override) | |
10127 | ||
10128 | dist_dir (override) | |
10129 | ||
10130 | dist_test (override) | |
10131 | ||
10132 | install (override) | |
10133 | ||
10134 | perldepend (override) | |
10135 | ||
10136 | makefile (override) | |
10137 | ||
10138 | test (override) | |
10139 | ||
10140 | test_via_harness (override) | |
10141 | ||
10142 | test_via_script (override) | |
10143 | ||
10144 | makeaperl (override) | |
10145 | ||
10146 | nicetext (override) | |
10147 | ||
10148 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in | |
10149 | ExtUtils::MakeMaker | |
10150 | ||
d420ca49 | 10151 | =over 4 |
a45bd81d GS |
10152 | |
10153 | =item SYNOPSIS | |
10154 | ||
10155 | =item DESCRIPTION | |
10156 | ||
10157 | =back | |
10158 | ||
10159 | catfile | |
10160 | ||
10161 | constants (o) | |
10162 | ||
10163 | static_lib (o) | |
10164 | ||
10165 | dynamic_bs (o) | |
10166 | ||
10167 | dynamic_lib (o) | |
10168 | ||
10169 | canonpath | |
10170 | ||
10171 | perl_script | |
10172 | ||
10173 | pm_to_blib | |
10174 | ||
10175 | test_via_harness (o) | |
10176 | ||
10177 | tool_autosplit (override) | |
10178 | ||
10179 | tools_other (o) | |
10180 | ||
10181 | xs_o (o) | |
10182 | ||
10183 | top_targets (o) | |
10184 | ||
10185 | htmlifypods (o) | |
10186 | ||
10187 | manifypods (o) | |
10188 | ||
10189 | dist_ci (o) | |
10190 | ||
10191 | dist_core (o) | |
10192 | ||
10193 | pasthru (o) | |
10194 | ||
10195 | =head2 ExtUtils::MakeMaker - create an extension Makefile | |
10196 | ||
d420ca49 | 10197 | =over 4 |
a45bd81d GS |
10198 | |
10199 | =item SYNOPSIS | |
10200 | ||
10201 | =item DESCRIPTION | |
10202 | ||
d420ca49 | 10203 | =over 4 |
a45bd81d GS |
10204 | |
10205 | =item How To Write A Makefile.PL | |
10206 | ||
10207 | =item Default Makefile Behaviour | |
10208 | ||
10209 | =item make test | |
10210 | ||
10211 | =item make testdb | |
10212 | ||
10213 | =item make install | |
10214 | ||
10215 | =item PREFIX and LIB attribute | |
10216 | ||
10217 | =item AFS users | |
10218 | ||
10219 | =item Static Linking of a new Perl Binary | |
10220 | ||
10221 | =item Determination of Perl Library and Installation Locations | |
10222 | ||
10223 | =item Which architecture dependent directory? | |
10224 | ||
10225 | =item Using Attributes and Parameters | |
10226 | ||
a7ffa9b9 | 10227 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG, |
a45bd81d GS |
10228 | CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, |
10229 | EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS, | |
10230 | HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, | |
10231 | INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR, | |
10232 | INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, | |
10233 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, | |
a7ffa9b9 NC |
10234 | INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR, |
10235 | INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, | |
10236 | MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, | |
afd1eb53 NIS |
10237 | NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, |
10238 | PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW, | |
10239 | PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, | |
10240 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TEST_LIBS, VERSION, | |
983dbef6 | 10241 | VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION |
a45bd81d GS |
10242 | |
10243 | =item Additional lowercase attributes | |
10244 | ||
10245 | clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, | |
10246 | tool_autosplit | |
10247 | ||
10248 | =item Overriding MakeMaker Methods | |
10249 | ||
10250 | =item Hintsfile support | |
10251 | ||
10252 | =item Distribution Support | |
10253 | ||
10254 | make distcheck, make skipcheck, make distclean, make manifest, | |
10255 | make distdir, make tardist, make dist, make uutardist, make | |
10256 | shdist, make zipdist, make ci | |
10257 | ||
10258 | =item Disabling an extension | |
10259 | ||
10260 | =back | |
10261 | ||
10262 | =item ENVIRONMENT | |
10263 | ||
10264 | PERL_MM_OPT | |
10265 | ||
10266 | =item SEE ALSO | |
10267 | ||
10268 | =item AUTHORS | |
10269 | ||
10270 | =back | |
10271 | ||
10272 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file | |
10273 | ||
d420ca49 | 10274 | =over 4 |
a45bd81d GS |
10275 | |
10276 | =item SYNOPSIS | |
10277 | ||
10278 | =item DESCRIPTION | |
10279 | ||
10280 | =item MANIFEST.SKIP | |
10281 | ||
10282 | =item EXPORT_OK | |
10283 | ||
10284 | =item GLOBAL VARIABLES | |
10285 | ||
10286 | =item DIAGNOSTICS | |
10287 | ||
10288 | C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>, | |
10289 | C<Added to MANIFEST:> I<file> | |
10290 | ||
165c0277 JH |
10291 | =item ENVIRONMENT |
10292 | ||
10293 | B<PERL_MM_MANIFEST_DEBUG> | |
10294 | ||
a45bd81d GS |
10295 | =item SEE ALSO |
10296 | ||
10297 | =item AUTHOR | |
10298 | ||
10299 | =back | |
10300 | ||
10301 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c | |
10302 | ||
d420ca49 | 10303 | =over 4 |
a45bd81d GS |
10304 | |
10305 | =item SYNOPSIS | |
10306 | ||
10307 | =item DESCRIPTION | |
10308 | ||
10309 | =item SEE ALSO | |
10310 | ||
10311 | =back | |
10312 | ||
10313 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader | |
10314 | ||
d420ca49 | 10315 | =over 4 |
a45bd81d GS |
10316 | |
10317 | =item SYNOPSIS | |
cb1a09d0 | 10318 | |
8ebc5c01 | 10319 | =item DESCRIPTION |
402d0d99 | 10320 | |
a45bd81d GS |
10321 | =back |
10322 | ||
10323 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
10324 | extension | |
10325 | ||
d420ca49 | 10326 | =over 4 |
a45bd81d GS |
10327 | |
10328 | =item SYNOPSIS | |
10329 | ||
10330 | =item DESCRIPTION | |
10331 | ||
10332 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
10333 | ||
10334 | =item AUTHOR | |
10335 | ||
10336 | =item REVISION | |
10337 | ||
10338 | =back | |
10339 | ||
10340 | =head2 ExtUtils::Packlist - manage .packlist files | |
10341 | ||
d420ca49 | 10342 | =over 4 |
a45bd81d GS |
10343 | |
10344 | =item SYNOPSIS | |
10345 | ||
10346 | =item DESCRIPTION | |
10347 | ||
10348 | =item USAGE | |
10349 | ||
10350 | =item FUNCTIONS | |
10351 | ||
10352 | new(), read(), write(), validate(), packlist_file() | |
10353 | ||
10354 | =item EXAMPLE | |
10355 | ||
10356 | =item AUTHOR | |
10357 | ||
10358 | =back | |
10359 | ||
10360 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
10361 | ||
d420ca49 | 10362 | =over 4 |
a45bd81d GS |
10363 | |
10364 | =item SYNOPSIS | |
10365 | ||
10366 | =item DESCRIPTION | |
10367 | ||
10368 | =back | |
10369 | ||
d516a115 JH |
10370 | =head2 Fatal - replace functions with equivalents which succeed or die |
10371 | ||
d420ca49 | 10372 | =over 4 |
a45bd81d | 10373 | |
d516a115 JH |
10374 | =item SYNOPSIS |
10375 | ||
10376 | =item DESCRIPTION | |
10377 | ||
10378 | =item AUTHOR | |
10379 | ||
a45bd81d GS |
10380 | =back |
10381 | ||
8ebc5c01 | 10382 | =head2 Fcntl - load the C Fcntl.h defines |
cb1a09d0 | 10383 | |
d420ca49 | 10384 | =over 4 |
a45bd81d | 10385 | |
8ebc5c01 | 10386 | =item SYNOPSIS |
cb1a09d0 | 10387 | |
8ebc5c01 | 10388 | =item DESCRIPTION |
cb1a09d0 | 10389 | |
8ebc5c01 | 10390 | =item NOTE |
cb1a09d0 | 10391 | |
8ebc5c01 | 10392 | =item EXPORTED SYMBOLS |
cb1a09d0 | 10393 | |
a45bd81d GS |
10394 | =back |
10395 | ||
8ebc5c01 | 10396 | =head2 File::Basename, fileparse - split a pathname into pieces |
7d2bfb28 | 10397 | |
d420ca49 | 10398 | =over 4 |
a45bd81d | 10399 | |
7d2bfb28 | 10400 | =item SYNOPSIS |
10401 | ||
7d2bfb28 | 10402 | =item DESCRIPTION |
10403 | ||
8ebc5c01 | 10404 | fileparse_set_fstype, fileparse |
7d2bfb28 | 10405 | |
8ebc5c01 | 10406 | =item EXAMPLES |
7d2bfb28 | 10407 | |
8ebc5c01 | 10408 | C<basename>, C<dirname> |
7d2bfb28 | 10409 | |
a45bd81d GS |
10410 | =back |
10411 | ||
8ebc5c01 | 10412 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
cb1a09d0 | 10413 | |
d420ca49 | 10414 | =over 4 |
a45bd81d | 10415 | |
cb1a09d0 AD |
10416 | =item SYNOPSIS |
10417 | ||
cb1a09d0 AD |
10418 | =item DESCRIPTION |
10419 | ||
a45bd81d GS |
10420 | =back |
10421 | ||
8ebc5c01 | 10422 | =head2 File::Compare - Compare files or filehandles |
cb1a09d0 | 10423 | |
d420ca49 | 10424 | =over 4 |
a45bd81d | 10425 | |
8ebc5c01 | 10426 | =item SYNOPSIS |
cb1a09d0 | 10427 | |
8ebc5c01 | 10428 | =item DESCRIPTION |
cb1a09d0 | 10429 | |
8ebc5c01 | 10430 | =item RETURN |
cb1a09d0 | 10431 | |
8ebc5c01 | 10432 | =item AUTHOR |
cb1a09d0 | 10433 | |
a45bd81d GS |
10434 | =back |
10435 | ||
8ebc5c01 | 10436 | =head2 File::Copy - Copy files or filehandles |
cb1a09d0 | 10437 | |
d420ca49 | 10438 | =over 4 |
a45bd81d | 10439 | |
8ebc5c01 | 10440 | =item SYNOPSIS |
cb1a09d0 | 10441 | |
8ebc5c01 | 10442 | =item DESCRIPTION |
cb1a09d0 | 10443 | |
d420ca49 | 10444 | =over 4 |
cb1a09d0 | 10445 | |
14218588 | 10446 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
cb1a09d0 | 10447 | |
8ebc5c01 | 10448 | rmscopy($from,$to[,$date_flag]) |
cb1a09d0 AD |
10449 | |
10450 | =back | |
10451 | ||
8ebc5c01 | 10452 | =item RETURN |
cb1a09d0 | 10453 | |
ac4dd294 JH |
10454 | =item NOTES |
10455 | ||
8ebc5c01 | 10456 | =item AUTHOR |
cb1a09d0 | 10457 | |
a45bd81d GS |
10458 | =back |
10459 | ||
3e3baf6d TB |
10460 | =head2 File::DosGlob - DOS like globbing and then some |
10461 | ||
d420ca49 | 10462 | =over 4 |
a45bd81d | 10463 | |
3e3baf6d TB |
10464 | =item SYNOPSIS |
10465 | ||
10466 | =item DESCRIPTION | |
10467 | ||
10468 | =item EXPORTS (by request only) | |
10469 | ||
10470 | =item BUGS | |
10471 | ||
10472 | =item AUTHOR | |
10473 | ||
10474 | =item HISTORY | |
10475 | ||
10476 | =item SEE ALSO | |
10477 | ||
a45bd81d GS |
10478 | =back |
10479 | ||
8ebc5c01 | 10480 | =head2 File::Find, find - traverse a file tree |
cb1a09d0 | 10481 | |
d420ca49 | 10482 | =over 4 |
a45bd81d | 10483 | |
8ebc5c01 | 10484 | =item SYNOPSIS |
cb1a09d0 | 10485 | |
8ebc5c01 | 10486 | =item DESCRIPTION |
cb1a09d0 | 10487 | |
10862624 | 10488 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, |
5d80033a JH |
10489 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, |
10490 | C<untaint>, C<untaint_pattern>, C<untaint_skip> | |
a45bd81d GS |
10491 | |
10492 | =item CAVEAT | |
10493 | ||
ac4dd294 JH |
10494 | =item NOTES |
10495 | ||
9038e305 JH |
10496 | =item HISTORY |
10497 | ||
a45bd81d GS |
10498 | =back |
10499 | ||
10500 | =head2 File::Glob - Perl extension for BSD glob routine | |
d516a115 | 10501 | |
d420ca49 | 10502 | =over 4 |
a45bd81d GS |
10503 | |
10504 | =item SYNOPSIS | |
10505 | ||
10506 | =item DESCRIPTION | |
10507 | ||
41ca3a40 JH |
10508 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, |
10509 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, | |
10510 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> | |
a45bd81d GS |
10511 | |
10512 | =item DIAGNOSTICS | |
10513 | ||
10514 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
10515 | ||
10516 | =item NOTES | |
10517 | ||
10518 | =item AUTHOR | |
10519 | ||
10520 | =back | |
10521 | ||
10522 | =head2 File::Path - create or remove directory trees | |
10523 | ||
d420ca49 | 10524 | =over 4 |
cb1a09d0 | 10525 | |
8ebc5c01 | 10526 | =item SYNOPSIS |
7d2bfb28 | 10527 | |
10528 | =item DESCRIPTION | |
10529 | ||
8ebc5c01 | 10530 | =item AUTHORS |
7d2bfb28 | 10531 | |
a45bd81d GS |
10532 | =back |
10533 | ||
fb9cefb4 GS |
10534 | =head2 File::Spec - portably perform operations on file names |
10535 | ||
d420ca49 | 10536 | =over 4 |
a45bd81d | 10537 | |
fb9cefb4 GS |
10538 | =item SYNOPSIS |
10539 | ||
10540 | =item DESCRIPTION | |
10541 | ||
10542 | =item SEE ALSO | |
10543 | ||
10544 | =item AUTHORS | |
10545 | ||
a45bd81d GS |
10546 | =back |
10547 | ||
2cc61e15 DD |
10548 | =head2 File::Spec::Epoc - methods for Epoc file specs |
10549 | ||
10550 | =over 4 | |
10551 | ||
10552 | =item SYNOPSIS | |
10553 | ||
10554 | =item DESCRIPTION | |
10555 | ||
10556 | devnull | |
10557 | ||
10558 | =back | |
10559 | ||
10560 | tmpdir | |
10561 | ||
10562 | path | |
10563 | ||
10564 | canonpath | |
10565 | ||
10566 | splitpath | |
10567 | ||
10568 | splitdir | |
10569 | ||
10570 | catpath | |
10571 | ||
10572 | abs2rel | |
10573 | ||
10574 | rel2abs | |
10575 | ||
10576 | =over 4 | |
10577 | ||
10578 | =item SEE ALSO | |
10579 | ||
10580 | =back | |
10581 | ||
14218588 GS |
10582 | =head2 File::Spec::Functions - portably perform operations on file names |
10583 | ||
d420ca49 | 10584 | =over 4 |
a45bd81d | 10585 | |
14218588 GS |
10586 | =item SYNOPSIS |
10587 | ||
10588 | =item DESCRIPTION | |
10589 | ||
d420ca49 | 10590 | =over 4 |
14218588 GS |
10591 | |
10592 | =item Exports | |
10593 | ||
10594 | =back | |
10595 | ||
10596 | =item SEE ALSO | |
10597 | ||
a45bd81d GS |
10598 | =back |
10599 | ||
fb9cefb4 GS |
10600 | =head2 File::Spec::Mac - File::Spec for MacOS |
10601 | ||
d420ca49 | 10602 | =over 4 |
a45bd81d | 10603 | |
fb9cefb4 GS |
10604 | =item SYNOPSIS |
10605 | ||
10606 | =item DESCRIPTION | |
10607 | ||
10608 | =item METHODS | |
10609 | ||
a45bd81d GS |
10610 | canonpath |
10611 | ||
10612 | =back | |
10613 | ||
10614 | catdir | |
10615 | ||
10616 | catfile | |
10617 | ||
10618 | curdir | |
10619 | ||
10620 | devnull | |
10621 | ||
10622 | rootdir | |
10623 | ||
10624 | tmpdir | |
10625 | ||
10626 | updir | |
10627 | ||
10628 | file_name_is_absolute | |
10629 | ||
10630 | path | |
10631 | ||
694468e3 GS |
10632 | splitpath |
10633 | ||
10634 | splitdir | |
10635 | ||
10636 | catpath | |
10637 | ||
10638 | abs2rel | |
10639 | ||
10640 | rel2abs | |
10641 | ||
d420ca49 | 10642 | =over 4 |
fb9cefb4 GS |
10643 | |
10644 | =item SEE ALSO | |
10645 | ||
a45bd81d GS |
10646 | =back |
10647 | ||
fb9cefb4 GS |
10648 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
10649 | ||
d420ca49 | 10650 | =over 4 |
a45bd81d | 10651 | |
fb9cefb4 GS |
10652 | =item SYNOPSIS |
10653 | ||
10654 | =item DESCRIPTION | |
10655 | ||
a45bd81d GS |
10656 | =back |
10657 | ||
fb9cefb4 GS |
10658 | =head2 File::Spec::Unix - methods used by File::Spec |
10659 | ||
d420ca49 | 10660 | =over 4 |
a45bd81d | 10661 | |
fb9cefb4 GS |
10662 | =item SYNOPSIS |
10663 | ||
10664 | =item DESCRIPTION | |
10665 | ||
10666 | =item METHODS | |
10667 | ||
a45bd81d GS |
10668 | canonpath |
10669 | ||
10670 | =back | |
10671 | ||
10672 | catdir | |
10673 | ||
10674 | catfile | |
10675 | ||
10676 | curdir | |
10677 | ||
10678 | devnull | |
10679 | ||
10680 | rootdir | |
10681 | ||
10682 | tmpdir | |
10683 | ||
10684 | updir | |
10685 | ||
10686 | no_upwards | |
10687 | ||
694468e3 GS |
10688 | case_tolerant |
10689 | ||
a45bd81d GS |
10690 | file_name_is_absolute |
10691 | ||
10692 | path | |
10693 | ||
10694 | join | |
10695 | ||
10696 | splitpath | |
10697 | ||
10698 | splitdir | |
10699 | ||
10700 | catpath | |
10701 | ||
10702 | abs2rel | |
10703 | ||
10704 | rel2abs | |
10705 | ||
d420ca49 | 10706 | =over 4 |
fb9cefb4 GS |
10707 | |
10708 | =item SEE ALSO | |
10709 | ||
a45bd81d GS |
10710 | =back |
10711 | ||
fb9cefb4 GS |
10712 | =head2 File::Spec::VMS - methods for VMS file specs |
10713 | ||
d420ca49 | 10714 | =over 4 |
a45bd81d | 10715 | |
fb9cefb4 GS |
10716 | =item SYNOPSIS |
10717 | ||
10718 | =item DESCRIPTION | |
10719 | ||
a45bd81d GS |
10720 | eliminate_macros |
10721 | ||
10722 | =back | |
10723 | ||
10724 | fixpath | |
c76ac1ee | 10725 | |
d420ca49 | 10726 | =over 4 |
fb9cefb4 GS |
10727 | |
10728 | =item Methods always loaded | |
10729 | ||
694468e3 | 10730 | canonpath (override) |
fb9cefb4 GS |
10731 | |
10732 | =back | |
10733 | ||
694468e3 GS |
10734 | catdir |
10735 | ||
a45bd81d GS |
10736 | catfile |
10737 | ||
10738 | curdir (override) | |
10739 | ||
10740 | devnull (override) | |
10741 | ||
10742 | rootdir (override) | |
10743 | ||
10744 | tmpdir (override) | |
10745 | ||
10746 | updir (override) | |
10747 | ||
694468e3 GS |
10748 | case_tolerant (override) |
10749 | ||
a45bd81d GS |
10750 | path (override) |
10751 | ||
10752 | file_name_is_absolute (override) | |
10753 | ||
694468e3 GS |
10754 | splitpath (override) |
10755 | ||
10756 | splitdir (override) | |
10757 | ||
10758 | catpath (override) | |
10759 | ||
37590e52 GS |
10760 | abs2rel (override) |
10761 | ||
10762 | rel2abs (override) | |
10763 | ||
d420ca49 | 10764 | =over 4 |
a45bd81d | 10765 | |
14218588 GS |
10766 | =item SEE ALSO |
10767 | ||
a45bd81d GS |
10768 | =back |
10769 | ||
fb9cefb4 GS |
10770 | =head2 File::Spec::Win32 - methods for Win32 file specs |
10771 | ||
d420ca49 | 10772 | =over 4 |
a45bd81d | 10773 | |
fb9cefb4 GS |
10774 | =item SYNOPSIS |
10775 | ||
10776 | =item DESCRIPTION | |
10777 | ||
a45bd81d GS |
10778 | devnull |
10779 | ||
10780 | =back | |
10781 | ||
10782 | tmpdir | |
10783 | ||
10784 | catfile | |
10785 | ||
10786 | canonpath | |
10787 | ||
10788 | splitpath | |
10789 | ||
10790 | splitdir | |
10791 | ||
10792 | catpath | |
10793 | ||
d420ca49 | 10794 | =over 4 |
a45bd81d | 10795 | |
14218588 | 10796 | =item SEE ALSO |
fb9cefb4 | 10797 | |
a45bd81d GS |
10798 | =back |
10799 | ||
d722968f JH |
10800 | =head2 File::Temp - return name and handle of a temporary file safely |
10801 | ||
d420ca49 | 10802 | =over 4 |
d722968f | 10803 | |
a9ef4385 JH |
10804 | =item PORTABILITY |
10805 | ||
d722968f JH |
10806 | =item SYNOPSIS |
10807 | ||
10808 | =item DESCRIPTION | |
10809 | ||
10810 | =back | |
10811 | ||
d420ca49 | 10812 | =over 4 |
d722968f JH |
10813 | |
10814 | =item FUNCTIONS | |
10815 | ||
10816 | B<tempfile> | |
10817 | ||
10818 | =back | |
10819 | ||
10820 | B<tempdir> | |
10821 | ||
d420ca49 | 10822 | =over 4 |
d722968f JH |
10823 | |
10824 | =item MKTEMP FUNCTIONS | |
10825 | ||
10826 | B<mkstemp> | |
10827 | ||
10828 | =back | |
10829 | ||
10830 | B<mkstemps> | |
10831 | ||
10832 | B<mkdtemp> | |
10833 | ||
10834 | B<mktemp> | |
10835 | ||
d420ca49 | 10836 | =over 4 |
d722968f JH |
10837 | |
10838 | =item POSIX FUNCTIONS | |
10839 | ||
10840 | B<tmpnam> | |
10841 | ||
10842 | =back | |
10843 | ||
10844 | B<tmpfile> | |
10845 | ||
d420ca49 | 10846 | =over 4 |
d722968f JH |
10847 | |
10848 | =item ADDITIONAL FUNCTIONS | |
10849 | ||
10850 | B<tempnam> | |
10851 | ||
10852 | =back | |
10853 | ||
d420ca49 | 10854 | =over 4 |
d722968f JH |
10855 | |
10856 | =item UTILITY FUNCTIONS | |
10857 | ||
10858 | B<unlink0> | |
10859 | ||
10860 | =back | |
10861 | ||
d420ca49 | 10862 | =over 4 |
d722968f JH |
10863 | |
10864 | =item PACKAGE VARIABLES | |
10865 | ||
10866 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
10867 | ||
10868 | =back | |
10869 | ||
10870 | TopSystemUID | |
10871 | ||
d420ca49 | 10872 | =over 4 |
d722968f JH |
10873 | |
10874 | =item WARNING | |
10875 | ||
165c0277 JH |
10876 | =over 4 |
10877 | ||
10878 | =item Temporary files and NFS | |
10879 | ||
10880 | =back | |
10881 | ||
4755096e GS |
10882 | =item HISTORY |
10883 | ||
10884 | =item SEE ALSO | |
10885 | ||
10886 | =item AUTHOR | |
10887 | ||
10888 | =back | |
10889 | ||
10890 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
10891 | ||
d420ca49 | 10892 | =over 4 |
4755096e GS |
10893 | |
10894 | =item SYNOPSIS | |
10895 | ||
10896 | =item DESCRIPTION | |
10897 | ||
10898 | =item NOTE | |
10899 | ||
10900 | =item AUTHOR | |
10901 | ||
10902 | =back | |
10903 | ||
10904 | =head2 FileCache - keep more files open than the system permits | |
10905 | ||
d420ca49 | 10906 | =over 4 |
4755096e GS |
10907 | |
10908 | =item SYNOPSIS | |
10909 | ||
10910 | =item DESCRIPTION | |
10911 | ||
10912 | =item BUGS | |
10913 | ||
10914 | =back | |
10915 | ||
10916 | =head2 FileHandle - supply object methods for filehandles | |
10917 | ||
d420ca49 | 10918 | =over 4 |
4755096e GS |
10919 | |
10920 | =item SYNOPSIS | |
10921 | ||
10922 | =item DESCRIPTION | |
10923 | ||
10924 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
10925 | ||
10926 | =item SEE ALSO | |
10927 | ||
10928 | =back | |
10929 | ||
165c0277 JH |
10930 | =head2 Filter::Simple - Simplified source filtering |
10931 | ||
10932 | =over 4 | |
10933 | ||
10934 | =item SYNOPSIS | |
10935 | ||
10936 | =item DESCRIPTION | |
10937 | ||
10938 | =over 4 | |
10939 | ||
10940 | =item The Problem | |
10941 | ||
10942 | =item A Solution | |
10943 | ||
1fa7ca25 JH |
10944 | =item Disabling or changing <no> behaviour |
10945 | ||
10946 | =item All-in-one interface | |
10947 | ||
165c0277 JH |
10948 | =item How it works |
10949 | ||
10950 | =back | |
10951 | ||
10952 | =item AUTHOR | |
10953 | ||
10954 | =item COPYRIGHT | |
10955 | ||
10956 | =back | |
10957 | ||
10958 | =head2 Filter::Util::Call - Perl Source Filter Utility Module | |
10959 | ||
10960 | =over 4 | |
10961 | ||
ab648d5e JH |
10962 | =item SYNOPSIS |
10963 | ||
165c0277 JH |
10964 | =item DESCRIPTION |
10965 | ||
10966 | =over 4 | |
10967 | ||
10968 | =item B<use Filter::Util::Call> | |
10969 | ||
10970 | =item B<import()> | |
10971 | ||
10972 | =item B<filter() and anonymous sub> | |
10973 | ||
10974 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> | |
10975 | ||
10976 | =back | |
10977 | ||
10978 | =item EXAMPLES | |
10979 | ||
10980 | =over 4 | |
10981 | ||
10982 | =item Example 1: A simple filter. | |
10983 | ||
10984 | =item Example 2: Using the context | |
10985 | ||
10986 | =item Example 3: Using the context within the filter | |
10987 | ||
10988 | =item Example 4: Using filter_del | |
10989 | ||
10990 | =back | |
10991 | ||
4d4e713d JH |
10992 | =item Filter::Simple |
10993 | ||
165c0277 JH |
10994 | =item AUTHOR |
10995 | ||
10996 | =item DATE | |
10997 | ||
10998 | =back | |
10999 | ||
4755096e GS |
11000 | =head2 FindBin - Locate directory of original perl script |
11001 | ||
d420ca49 | 11002 | =over 4 |
4755096e GS |
11003 | |
11004 | =item SYNOPSIS | |
11005 | ||
11006 | =item DESCRIPTION | |
11007 | ||
11008 | =item EXPORTABLE VARIABLES | |
11009 | ||
11010 | =item KNOWN BUGS | |
11011 | ||
11012 | =item AUTHORS | |
11013 | ||
11014 | =item COPYRIGHT | |
11015 | ||
11016 | =back | |
11017 | ||
11018 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
11019 | ||
d420ca49 | 11020 | =over 4 |
4755096e GS |
11021 | |
11022 | =item SYNOPSIS | |
11023 | ||
11024 | =item DESCRIPTION | |
11025 | ||
11026 | =item AVAILABILITY | |
11027 | ||
11028 | =item BUGS | |
11029 | ||
11030 | =item SEE ALSO | |
11031 | ||
11032 | =back | |
11033 | ||
11034 | =head2 Getopt::Long - Extended processing of command line options | |
11035 | ||
d420ca49 | 11036 | =over 4 |
4755096e GS |
11037 | |
11038 | =item SYNOPSIS | |
11039 | ||
11040 | =item DESCRIPTION | |
11041 | ||
11042 | =item Command Line Options, an Introduction | |
11043 | ||
11044 | =item Getting Started with Getopt::Long | |
11045 | ||
d420ca49 | 11046 | =over 4 |
4755096e GS |
11047 | |
11048 | =item Simple options | |
11049 | ||
11050 | =item A little bit less simple options | |
11051 | ||
11052 | =item Mixing command line option with other arguments | |
11053 | ||
11054 | =item Options with values | |
11055 | ||
11056 | =item Options with multiple values | |
11057 | ||
11058 | =item Options with hash values | |
11059 | ||
11060 | =item User-defined subroutines to handle options | |
11061 | ||
11062 | =item Options with multiple names | |
11063 | ||
11064 | =item Case and abbreviations | |
11065 | ||
11066 | =item Summary of Option Specifications | |
11067 | ||
11068 | !, +, s, i, f, : I<type> [ I<desttype> ] | |
11069 | ||
11070 | =back | |
11071 | ||
11072 | =item Advanced Possibilities | |
11073 | ||
d420ca49 | 11074 | =over 4 |
4755096e | 11075 | |
10862624 RF |
11076 | =item Object oriented interface |
11077 | ||
4755096e GS |
11078 | =item Documentation and help texts |
11079 | ||
11080 | =item Storing options in a hash | |
11081 | ||
11082 | =item Bundling | |
11083 | ||
11084 | =item The lonesome dash | |
11085 | ||
11086 | =item Argument call-back | |
11087 | ||
11088 | =back | |
11089 | ||
11090 | =item Configuring Getopt::Long | |
11091 | ||
9fa7f388 JH |
11092 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, |
11093 | require_order, permute, bundling (default: disabled), bundling_override | |
11094 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
11095 | (default: disabled), pass_through (default: disabled), prefix, | |
11096 | prefix_pattern, debug (default: disabled) | |
4755096e GS |
11097 | |
11098 | =item Return values and Errors | |
11099 | ||
11100 | =item Legacy | |
11101 | ||
d420ca49 | 11102 | =over 4 |
4755096e GS |
11103 | |
11104 | =item Default destinations | |
11105 | ||
11106 | =item Alternative option starters | |
11107 | ||
11108 | =item Configuration variables | |
11109 | ||
11110 | =back | |
11111 | ||
10862624 RF |
11112 | =item Trouble Shooting |
11113 | ||
d420ca49 | 11114 | =over 4 |
10862624 RF |
11115 | |
11116 | =item Warning: Ignoring '!' modifier for short option | |
11117 | ||
11118 | =item GetOptions does not return a false result when an option is not | |
11119 | supplied | |
11120 | ||
11121 | =back | |
11122 | ||
4755096e GS |
11123 | =item AUTHOR |
11124 | ||
11125 | =item COPYRIGHT AND DISCLAIMER | |
11126 | ||
11127 | =back | |
11128 | ||
11129 | =head2 Getopt::Std, getopt - Process single-character switches with switch | |
11130 | clustering | |
11131 | ||
d420ca49 | 11132 | =over 4 |
4755096e GS |
11133 | |
11134 | =item SYNOPSIS | |
11135 | ||
11136 | =item DESCRIPTION | |
11137 | ||
11138 | =back | |
11139 | ||
11140 | =head2 I18N::Collate - compare 8-bit scalar data according to the current | |
11141 | locale | |
11142 | ||
d420ca49 | 11143 | =over 4 |
4755096e GS |
11144 | |
11145 | =item SYNOPSIS | |
11146 | ||
11147 | =item DESCRIPTION | |
11148 | ||
11149 | =back | |
11150 | ||
772ff3b9 JH |
11151 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language |
11152 | tags | |
11153 | ||
11154 | =over 4 | |
11155 | ||
11156 | =item SYNOPSIS | |
11157 | ||
11158 | =item DESCRIPTION | |
11159 | ||
11160 | =back | |
11161 | ||
11162 | the function is_language_tag($lang1) | |
11163 | ||
11164 | the function extract_language_tags($whatever) | |
11165 | ||
11166 | the function same_language_tag($lang1, $lang2) | |
11167 | ||
11168 | the function similarity_language_tag($lang1, $lang2) | |
11169 | ||
11170 | the function is_dialect_of($lang1, $lang2) | |
11171 | ||
11172 | the function super_languages($lang1) | |
11173 | ||
11174 | the function locale2language_tag($locale_identifier) | |
11175 | ||
11176 | the function encode_language_tag($lang1) | |
11177 | ||
11178 | the function alternate_language_tags($lang1) | |
11179 | ||
4f233aa4 JH |
11180 | the function @langs = panic_languages(@accept_languages) |
11181 | ||
772ff3b9 JH |
11182 | =over 4 |
11183 | ||
11184 | =item ABOUT LOWERCASING | |
11185 | ||
11186 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS | |
11187 | ||
11188 | =item SEE ALSO | |
11189 | ||
11190 | =item COPYRIGHT | |
11191 | ||
11192 | =item AUTHOR | |
11193 | ||
11194 | =back | |
11195 | ||
4f233aa4 | 11196 | =head2 I18N::LangTags::List -- tags and names for human languages |
2ca5449f JH |
11197 | |
11198 | =over 4 | |
11199 | ||
11200 | =item SYNOPSIS | |
11201 | ||
4f233aa4 JH |
11202 | =item DESCRIPTION |
11203 | ||
2ca5449f JH |
11204 | =item ABOUT LANGUAGE TAGS |
11205 | ||
11206 | =item LIST OF LANGUAGES | |
11207 | ||
4f233aa4 JH |
11208 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} : |
11209 | Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)], | |
11210 | {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} : | |
11211 | Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} : | |
11212 | Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} : | |
11213 | Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} : | |
11214 | Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages], | |
11215 | [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} : | |
11216 | Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, | |
11217 | {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} : | |
11218 | Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu | |
11219 | (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak | |
11220 | (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} : | |
11221 | Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : | |
11222 | Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : | |
11223 | Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : | |
11224 | Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, | |
11225 | [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], | |
11226 | [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} : | |
11227 | Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} | |
11228 | : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : | |
11229 | Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, | |
11230 | {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : | |
11231 | Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and | |
11232 | pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)], | |
11233 | [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles | |
11234 | and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} : | |
11235 | Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default | |
11236 | (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi} | |
11237 | : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : | |
11238 | Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, | |
11239 | {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, | |
11240 | {en} : English, {enm} : Old English (1100-1500), {ang} : Old English | |
11241 | (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} : | |
11242 | Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : | |
11243 | Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} | |
11244 | : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : | |
11245 | Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, | |
11246 | {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, | |
11247 | {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500), | |
11248 | {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : | |
11249 | Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : | |
11250 | Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : | |
11251 | Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian, | |
11252 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : | |
11253 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, | |
11254 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo, | |
11255 | {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)], | |
11256 | {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language | |
11257 | Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira} | |
11258 | : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} : | |
11259 | Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} : | |
11260 | Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian, | |
11261 | {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} : | |
11262 | Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} : | |
11263 | Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi} | |
11264 | : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu, | |
11265 | {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi, | |
11266 | {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} : | |
11267 | Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru} | |
11268 | : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba, | |
11269 | {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} : | |
11270 | Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} : | |
11271 | Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} : | |
11272 | Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian, | |
11273 | {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} : | |
11274 | Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu, | |
11275 | {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo | |
11276 | languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} : | |
11277 | Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men} | |
11278 | : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} : | |
11279 | Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} : | |
11280 | Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} | |
11281 | : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} : | |
11282 | Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} : | |
11283 | Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : | |
11284 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, | |
11285 | {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami, | |
11286 | {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} | |
11287 | : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, | |
11288 | {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya, | |
11289 | {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian | |
11290 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : | |
11291 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : | |
11292 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian | |
11293 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} | |
11294 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], | |
11295 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : | |
11296 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, | |
11297 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : | |
11298 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan | |
11299 | languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)], | |
11300 | {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} : | |
11301 | Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup, | |
11302 | [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan, | |
11303 | {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika, | |
11304 | {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} : | |
11305 | Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)], | |
11306 | {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} : | |
11307 | Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern | |
11308 | Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es} | |
11309 | : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} : | |
11310 | Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} : | |
11311 | Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} : | |
11312 | Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te} | |
11313 | : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig} | |
11314 | : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit, | |
11315 | {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga | |
11316 | (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} : | |
11317 | Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish | |
11318 | (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi, | |
11319 | {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} : | |
11320 | Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} : | |
11321 | Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages], | |
11322 | {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof, | |
11323 | {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut, | |
11324 | {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik | |
11325 | languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : | |
11326 | Zhuang, {zu} : Zulu, {zun} : Zuni | |
2ca5449f JH |
11327 | |
11328 | =item SEE ALSO | |
11329 | ||
11330 | =item COPYRIGHT AND DISCLAIMER | |
11331 | ||
11332 | =item AUTHOR | |
11333 | ||
11334 | =back | |
11335 | ||
4755096e GS |
11336 | =head2 IO - load various IO modules |
11337 | ||
d420ca49 | 11338 | =over 4 |
4755096e GS |
11339 | |
11340 | =item SYNOPSIS | |
11341 | ||
11342 | =item DESCRIPTION | |
11343 | ||
11344 | =back | |
11345 | ||
11346 | =head2 IO::Dir - supply object methods for directory handles | |
11347 | ||
d420ca49 | 11348 | =over 4 |
4755096e GS |
11349 | |
11350 | =item SYNOPSIS | |
11351 | ||
11352 | =item DESCRIPTION | |
11353 | ||
11354 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
11355 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
11356 | ||
11357 | =item SEE ALSO | |
11358 | ||
11359 | =item AUTHOR | |
11360 | ||
11361 | =item COPYRIGHT | |
11362 | ||
11363 | =back | |
11364 | ||
11365 | =head2 IO::File - supply object methods for filehandles | |
11366 | ||
d420ca49 | 11367 | =over 4 |
4755096e GS |
11368 | |
11369 | =item SYNOPSIS | |
11370 | ||
11371 | =item DESCRIPTION | |
11372 | ||
11373 | =item CONSTRUCTOR | |
11374 | ||
11375 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
11376 | ||
11377 | =item METHODS | |
11378 | ||
11379 | open( FILENAME [,MODE [,PERMS]] ) | |
d722968f JH |
11380 | |
11381 | =item SEE ALSO | |
11382 | ||
4755096e | 11383 | =item HISTORY |
d722968f JH |
11384 | |
11385 | =back | |
11386 | ||
4755096e | 11387 | =head2 IO::Handle - supply object methods for I/O handles |
7d2bfb28 | 11388 | |
d420ca49 | 11389 | =over 4 |
a45bd81d | 11390 | |
7d2bfb28 | 11391 | =item SYNOPSIS |
11392 | ||
7d2bfb28 | 11393 | =item DESCRIPTION |
11394 | ||
4755096e | 11395 | =item CONSTRUCTOR |
7d2bfb28 | 11396 | |
4755096e | 11397 | new (), new_from_fd ( FD, MODE ) |
a45bd81d | 11398 | |
4755096e | 11399 | =item METHODS |
7d2bfb28 | 11400 | |
4755096e GS |
11401 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, |
11402 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
11403 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
11404 | $io->blocking ( [ BOOL ] ), $io->untaint | |
a45bd81d | 11405 | |
4755096e | 11406 | =item NOTE |
7d2bfb28 | 11407 | |
4755096e | 11408 | =item SEE ALSO |
7d2bfb28 | 11409 | |
8ebc5c01 | 11410 | =item BUGS |
7d2bfb28 | 11411 | |
4755096e GS |
11412 | =item HISTORY |
11413 | ||
a45bd81d GS |
11414 | =back |
11415 | ||
4755096e | 11416 | =head2 IO::Pipe - supply object methods for pipes |
7d2bfb28 | 11417 | |
d420ca49 | 11418 | =over 4 |
a45bd81d | 11419 | |
8ebc5c01 | 11420 | =item SYNOPSIS |
7d2bfb28 | 11421 | |
8ebc5c01 | 11422 | =item DESCRIPTION |
7d2bfb28 | 11423 | |
4755096e GS |
11424 | =item CONSTRUCTOR |
11425 | ||
11426 | new ( [READER, WRITER] ) | |
11427 | ||
11428 | =item METHODS | |
11429 | ||
11430 | reader ([ARGS]), writer ([ARGS]), handles () | |
7d2bfb28 | 11431 | |
8ebc5c01 | 11432 | =item SEE ALSO |
7d2bfb28 | 11433 | |
4755096e GS |
11434 | =item AUTHOR |
11435 | ||
11436 | =item COPYRIGHT | |
11437 | ||
a45bd81d GS |
11438 | =back |
11439 | ||
4755096e | 11440 | =head2 IO::Poll - Object interface to system poll call |
7d2bfb28 | 11441 | |
d420ca49 | 11442 | =over 4 |
a45bd81d | 11443 | |
8ebc5c01 | 11444 | =item SYNOPSIS |
7d2bfb28 | 11445 | |
8ebc5c01 | 11446 | =item DESCRIPTION |
7d2bfb28 | 11447 | |
4755096e | 11448 | =item METHODS |
7d2bfb28 | 11449 | |
4755096e GS |
11450 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( |
11451 | IO ), handles( [ EVENT_MASK ] ) | |
7d2bfb28 | 11452 | |
4755096e GS |
11453 | =item SEE ALSO |
11454 | ||
11455 | =item AUTHOR | |
7d2bfb28 | 11456 | |
8ebc5c01 | 11457 | =item COPYRIGHT |
7d2bfb28 | 11458 | |
a45bd81d GS |
11459 | =back |
11460 | ||
4755096e | 11461 | =head2 IO::Seekable - supply seek based methods for I/O objects |
7d2bfb28 | 11462 | |
d420ca49 | 11463 | =over 4 |
a45bd81d | 11464 | |
8ebc5c01 | 11465 | =item SYNOPSIS |
7d2bfb28 | 11466 | |
11467 | =item DESCRIPTION | |
11468 | ||
1fa7ca25 JH |
11469 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
11470 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
74cac757 | 11471 | $io->tell |
7d2bfb28 | 11472 | |
4d4e713d JH |
11473 | =item SEE ALSO |
11474 | ||
4755096e GS |
11475 | =item HISTORY |
11476 | ||
a45bd81d GS |
11477 | =back |
11478 | ||
4755096e | 11479 | =head2 IO::Select - OO interface to the select system call |
cb1a09d0 | 11480 | |
d420ca49 | 11481 | =over 4 |
a45bd81d | 11482 | |
cb1a09d0 AD |
11483 | =item SYNOPSIS |
11484 | ||
cb1a09d0 AD |
11485 | =item DESCRIPTION |
11486 | ||
4755096e | 11487 | =item CONSTRUCTOR |
cb1a09d0 | 11488 | |
4755096e | 11489 | new ( [ HANDLES ] ) |
cb1a09d0 | 11490 | |
4755096e | 11491 | =item METHODS |
cb1a09d0 | 11492 | |
4755096e GS |
11493 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( |
11494 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
11495 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
cb1a09d0 | 11496 | |
4755096e | 11497 | =item EXAMPLE |
cb1a09d0 | 11498 | |
4755096e | 11499 | =item AUTHOR |
cb1a09d0 | 11500 | |
4755096e | 11501 | =item COPYRIGHT |
b38f6a39 | 11502 | |
4755096e | 11503 | =back |
b38f6a39 | 11504 | |
4755096e | 11505 | =head2 IO::Socket - Object interface to socket communications |
b38f6a39 | 11506 | |
d420ca49 | 11507 | =over 4 |
b38f6a39 | 11508 | |
4755096e | 11509 | =item SYNOPSIS |
b38f6a39 | 11510 | |
4755096e | 11511 | =item DESCRIPTION |
b38f6a39 | 11512 | |
4755096e | 11513 | =item CONSTRUCTOR |
cb1a09d0 | 11514 | |
4755096e | 11515 | new ( [ARGS] ) |
cb1a09d0 | 11516 | |
4755096e | 11517 | =item METHODS |
7d2bfb28 | 11518 | |
ab1e085c JH |
11519 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
11520 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
b38f6a39 | 11521 | |
4755096e | 11522 | =item SEE ALSO |
b38f6a39 | 11523 | |
4755096e | 11524 | =item AUTHOR |
b38f6a39 | 11525 | |
4755096e | 11526 | =item COPYRIGHT |
b38f6a39 | 11527 | |
4755096e | 11528 | =back |
b38f6a39 | 11529 | |
4755096e | 11530 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets |
b38f6a39 | 11531 | |
d420ca49 | 11532 | =over 4 |
7d2bfb28 | 11533 | |
4755096e | 11534 | =item SYNOPSIS |
9607fc9c | 11535 | |
4755096e | 11536 | =item DESCRIPTION |
9607fc9c | 11537 | |
4755096e | 11538 | =item CONSTRUCTOR |
b38f6a39 | 11539 | |
4755096e | 11540 | new ( [ARGS] ) |
b38f6a39 | 11541 | |
d420ca49 | 11542 | =over 4 |
cb1a09d0 | 11543 | |
4755096e | 11544 | =item METHODS |
b38f6a39 | 11545 | |
4755096e GS |
11546 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost |
11547 | () | |
b38f6a39 GS |
11548 | |
11549 | =back | |
cb1a09d0 | 11550 | |
4755096e GS |
11551 | =item SEE ALSO |
11552 | ||
d516a115 JH |
11553 | =item AUTHOR |
11554 | ||
4755096e | 11555 | =item COPYRIGHT |
d516a115 | 11556 | |
a45bd81d GS |
11557 | =back |
11558 | ||
4755096e | 11559 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets |
cb1a09d0 | 11560 | |
d420ca49 | 11561 | =over 4 |
a45bd81d | 11562 | |
8ebc5c01 | 11563 | =item SYNOPSIS |
cb1a09d0 | 11564 | |
8ebc5c01 | 11565 | =item DESCRIPTION |
cb1a09d0 | 11566 | |
4755096e | 11567 | =item CONSTRUCTOR |
cb1a09d0 | 11568 | |
4755096e | 11569 | new ( [ARGS] ) |
cb1a09d0 | 11570 | |
4755096e | 11571 | =item METHODS |
a45bd81d | 11572 | |
4755096e | 11573 | hostpath(), peerpath() |
cb1a09d0 | 11574 | |
4755096e | 11575 | =item SEE ALSO |
a45bd81d | 11576 | |
4755096e | 11577 | =item AUTHOR |
cb1a09d0 | 11578 | |
4755096e | 11579 | =item COPYRIGHT |
cb1a09d0 | 11580 | |
a45bd81d GS |
11581 | =back |
11582 | ||
14218588 GS |
11583 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory |
11584 | handles | |
fb9cefb4 | 11585 | |
d420ca49 | 11586 | =over 4 |
a45bd81d | 11587 | |
fb9cefb4 GS |
11588 | =item SYNOPSIS |
11589 | ||
11590 | =item DESCRIPTION | |
11591 | ||
14218588 GS |
11592 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
11593 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
fb9cefb4 GS |
11594 | |
11595 | =item SEE ALSO | |
11596 | ||
14218588 | 11597 | =item AUTHOR |
fb9cefb4 GS |
11598 | |
11599 | =item COPYRIGHT | |
11600 | ||
a45bd81d GS |
11601 | =back |
11602 | ||
14218588 | 11603 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
fb9cefb4 | 11604 | |
d420ca49 | 11605 | =over 4 |
a45bd81d | 11606 | |
fb9cefb4 GS |
11607 | =item SYNOPSIS |
11608 | ||
11609 | =item DESCRIPTION | |
11610 | ||
14218588 GS |
11611 | =item CONSTRUCTOR |
11612 | ||
11613 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
11614 | ||
fb9cefb4 GS |
11615 | =item METHODS |
11616 | ||
14218588 | 11617 | open( FILENAME [,MODE [,PERMS]] ) |
fb9cefb4 GS |
11618 | |
11619 | =item SEE ALSO | |
11620 | ||
14218588 | 11621 | =item HISTORY |
fb9cefb4 | 11622 | |
a45bd81d GS |
11623 | =back |
11624 | ||
14218588 GS |
11625 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
11626 | handles | |
11627 | ||
d420ca49 | 11628 | =over 4 |
a45bd81d | 11629 | |
14218588 GS |
11630 | =item SYNOPSIS |
11631 | ||
11632 | =item DESCRIPTION | |
11633 | ||
11634 | =item CONSTRUCTOR | |
11635 | ||
11636 | new (), new_from_fd ( FD, MODE ) | |
11637 | ||
11638 | =item METHODS | |
11639 | ||
11640 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
11641 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
11642 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
11643 | $io->blocking ( [ BOOL ] ), $io->untaint | |
11644 | ||
11645 | =item NOTE | |
11646 | ||
11647 | =item SEE ALSO | |
11648 | ||
11649 | =item BUGS | |
11650 | ||
11651 | =item HISTORY | |
11652 | ||
a45bd81d GS |
11653 | =back |
11654 | ||
14218588 GS |
11655 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes |
11656 | ||
d420ca49 | 11657 | =over 4 |
a45bd81d | 11658 | |
14218588 GS |
11659 | =item SYNOPSIS |
11660 | ||
11661 | =item DESCRIPTION | |
11662 | ||
11663 | =item CONSTRUCTOR | |
11664 | ||
11665 | new ( [READER, WRITER] ) | |
11666 | ||
11667 | =item METHODS | |
11668 | ||
11669 | reader ([ARGS]), writer ([ARGS]), handles () | |
11670 | ||
11671 | =item SEE ALSO | |
11672 | ||
11673 | =item AUTHOR | |
11674 | ||
11675 | =item COPYRIGHT | |
11676 | ||
a45bd81d GS |
11677 | =back |
11678 | ||
14218588 GS |
11679 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call |
11680 | ||
d420ca49 | 11681 | =over 4 |
a45bd81d | 11682 | |
14218588 GS |
11683 | =item SYNOPSIS |
11684 | ||
11685 | =item DESCRIPTION | |
11686 | ||
11687 | =item METHODS | |
11688 | ||
11689 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
11690 | IO ), handles( [ EVENT_MASK ] ) | |
11691 | ||
11692 | =item SEE ALSO | |
11693 | ||
11694 | =item AUTHOR | |
11695 | ||
11696 | =item COPYRIGHT | |
11697 | ||
a45bd81d GS |
11698 | =back |
11699 | ||
14218588 GS |
11700 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for |
11701 | I/O objects | |
11702 | ||
d420ca49 | 11703 | =over 4 |
a45bd81d | 11704 | |
14218588 GS |
11705 | =item SYNOPSIS |
11706 | ||
11707 | =item DESCRIPTION | |
11708 | ||
1fa7ca25 JH |
11709 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
11710 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
74cac757 | 11711 | $io->tell |
14218588 | 11712 | |
4d4e713d JH |
11713 | =item SEE ALSO |
11714 | ||
14218588 GS |
11715 | =item HISTORY |
11716 | ||
a45bd81d GS |
11717 | =back |
11718 | ||
14218588 GS |
11719 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system |
11720 | call | |
11721 | ||
d420ca49 | 11722 | =over 4 |
a45bd81d | 11723 | |
14218588 GS |
11724 | =item SYNOPSIS |
11725 | ||
11726 | =item DESCRIPTION | |
11727 | ||
11728 | =item CONSTRUCTOR | |
11729 | ||
11730 | new ( [ HANDLES ] ) | |
11731 | ||
11732 | =item METHODS | |
11733 | ||
11734 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
11735 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
11736 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
11737 | ||
11738 | =item EXAMPLE | |
11739 | ||
11740 | =item AUTHOR | |
11741 | ||
11742 | =item COPYRIGHT | |
11743 | ||
a45bd81d GS |
11744 | =back |
11745 | ||
14218588 GS |
11746 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket |
11747 | communications | |
11748 | ||
d420ca49 | 11749 | =over 4 |
a45bd81d | 11750 | |
14218588 GS |
11751 | =item SYNOPSIS |
11752 | ||
11753 | =item DESCRIPTION | |
11754 | ||
11755 | =item CONSTRUCTOR | |
11756 | ||
11757 | new ( [ARGS] ) | |
11758 | ||
11759 | =item METHODS | |
11760 | ||
ab1e085c JH |
11761 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
11762 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
14218588 GS |
11763 | |
11764 | =item SEE ALSO | |
11765 | ||
11766 | =item AUTHOR | |
11767 | ||
11768 | =item COPYRIGHT | |
11769 | ||
a45bd81d GS |
11770 | =back |
11771 | ||
14218588 GS |
11772 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for |
11773 | AF_INET domain sockets | |
11774 | ||
d420ca49 | 11775 | =over 4 |
a45bd81d | 11776 | |
14218588 GS |
11777 | =item SYNOPSIS |
11778 | ||
11779 | =item DESCRIPTION | |
11780 | ||
11781 | =item CONSTRUCTOR | |
11782 | ||
11783 | new ( [ARGS] ) | |
11784 | ||
d420ca49 | 11785 | =over 4 |
14218588 GS |
11786 | |
11787 | =item METHODS | |
11788 | ||
11789 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
11790 | () | |
11791 | ||
11792 | =back | |
11793 | ||
11794 | =item SEE ALSO | |
11795 | ||
11796 | =item AUTHOR | |
11797 | ||
11798 | =item COPYRIGHT | |
11799 | ||
a45bd81d GS |
11800 | =back |
11801 | ||
14218588 GS |
11802 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for |
11803 | AF_UNIX domain sockets | |
11804 | ||
d420ca49 | 11805 | =over 4 |
a45bd81d | 11806 | |
14218588 GS |
11807 | =item SYNOPSIS |
11808 | ||
11809 | =item DESCRIPTION | |
11810 | ||
11811 | =item CONSTRUCTOR | |
11812 | ||
11813 | new ( [ARGS] ) | |
11814 | ||
11815 | =item METHODS | |
11816 | ||
11817 | hostpath(), peerpath() | |
11818 | ||
11819 | =item SEE ALSO | |
11820 | ||
11821 | =item AUTHOR | |
11822 | ||
11823 | =item COPYRIGHT | |
11824 | ||
a45bd81d | 11825 | =back |
14218588 | 11826 | |
d46b76b3 JH |
11827 | =head2 IPC::Msg - SysV Msg IPC object class |
11828 | ||
d420ca49 | 11829 | =over 4 |
d46b76b3 JH |
11830 | |
11831 | =item SYNOPSIS | |
11832 | ||
11833 | =item DESCRIPTION | |
11834 | ||
11835 | =item METHODS | |
11836 | ||
11837 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
11838 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
11839 | FLAGS ] ), stat | |
11840 | ||
11841 | =item SEE ALSO | |
11842 | ||
11843 | =item AUTHOR | |
11844 | ||
11845 | =item COPYRIGHT | |
11846 | ||
11847 | =back | |
11848 | ||
14218588 GS |
11849 | =head2 IPC::Open2, open2 - open a process for both reading and writing |
11850 | ||
d420ca49 | 11851 | =over 4 |
a45bd81d | 11852 | |
14218588 GS |
11853 | =item SYNOPSIS |
11854 | ||
11855 | =item DESCRIPTION | |
11856 | ||
11857 | =item WARNING | |
11858 | ||
11859 | =item SEE ALSO | |
11860 | ||
a45bd81d GS |
11861 | =back |
11862 | ||
14218588 GS |
11863 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error |
11864 | handling | |
11865 | ||
d420ca49 | 11866 | =over 4 |
14218588 GS |
11867 | |
11868 | =item SYNOPSIS | |
11869 | ||
11870 | =item DESCRIPTION | |
11871 | ||
a45bd81d | 11872 | =item WARNING |
14218588 | 11873 | |
a45bd81d | 11874 | =back |
14218588 | 11875 | |
d46b76b3 JH |
11876 | =head2 IPC::Semaphore - SysV Semaphore IPC object class |
11877 | ||
d420ca49 | 11878 | =over 4 |
d46b76b3 JH |
11879 | |
11880 | =item SYNOPSIS | |
11881 | ||
11882 | =item DESCRIPTION | |
11883 | ||
11884 | =item METHODS | |
11885 | ||
11886 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
11887 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
11888 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
11889 | , VALUE ), stat | |
11890 | ||
11891 | =item SEE ALSO | |
11892 | ||
11893 | =item AUTHOR | |
11894 | ||
11895 | =item COPYRIGHT | |
11896 | ||
11897 | =back | |
11898 | ||
14218588 GS |
11899 | =head2 IPC::SysV - SysV IPC constants |
11900 | ||
d420ca49 | 11901 | =over 4 |
a45bd81d | 11902 | |
14218588 GS |
11903 | =item SYNOPSIS |
11904 | ||
11905 | =item DESCRIPTION | |
11906 | ||
11907 | ftok( PATH, ID ) | |
11908 | ||
11909 | =item SEE ALSO | |
11910 | ||
11911 | =item AUTHORS | |
11912 | ||
11913 | =item COPYRIGHT | |
11914 | ||
a45bd81d GS |
11915 | =back |
11916 | ||
14218588 GS |
11917 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class |
11918 | ||
d420ca49 | 11919 | =over 4 |
a45bd81d | 11920 | |
14218588 GS |
11921 | =item SYNOPSIS |
11922 | ||
11923 | =item DESCRIPTION | |
11924 | ||
11925 | =item METHODS | |
11926 | ||
11927 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
11928 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
11929 | FLAGS ] ), stat | |
11930 | ||
11931 | =item SEE ALSO | |
11932 | ||
11933 | =item AUTHOR | |
11934 | ||
11935 | =item COPYRIGHT | |
fb9cefb4 | 11936 | |
a45bd81d GS |
11937 | =back |
11938 | ||
fb9cefb4 GS |
11939 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object |
11940 | class | |
11941 | ||
d420ca49 | 11942 | =over 4 |
a45bd81d | 11943 | |
fb9cefb4 GS |
11944 | =item SYNOPSIS |
11945 | ||
11946 | =item DESCRIPTION | |
11947 | ||
11948 | =item METHODS | |
11949 | ||
11950 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
11951 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
11952 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
11953 | , VALUE ), stat | |
11954 | ||
11955 | =item SEE ALSO | |
11956 | ||
11957 | =item AUTHOR | |
11958 | ||
11959 | =item COPYRIGHT | |
11960 | ||
a45bd81d GS |
11961 | =back |
11962 | ||
41ca3a40 JH |
11963 | =head2 List::Util - A selection of general-utility list subroutines |
11964 | ||
11965 | =over 4 | |
11966 | ||
11967 | =item SYNOPSIS | |
11968 | ||
11969 | =item DESCRIPTION | |
11970 | ||
11971 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
11972 | BLOCK LIST, sum LIST | |
11973 | ||
11974 | =item SUGGESTED ADDITIONS | |
11975 | ||
11976 | =item COPYRIGHT | |
11977 | ||
11978 | =back | |
11979 | ||
11980 | =head2 List::Utilib::List::Util, List::Util - A selection of | |
11981 | general-utility list subroutines | |
11982 | ||
11983 | =over 4 | |
11984 | ||
11985 | =item SYNOPSIS | |
11986 | ||
11987 | =item DESCRIPTION | |
11988 | ||
11989 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
11990 | BLOCK LIST, sum LIST | |
11991 | ||
11992 | =item SUGGESTED ADDITIONS | |
11993 | ||
11994 | =item COPYRIGHT | |
11995 | ||
11996 | =back | |
11997 | ||
11998 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of | |
11999 | general-utility scalar subroutines | |
12000 | ||
12001 | =over 4 | |
12002 | ||
12003 | =item SYNOPSIS | |
12004 | ||
12005 | =item DESCRIPTION | |
12006 | ||
1fa7ca25 JH |
12007 | blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype |
12008 | EXPR, tainted EXPR, weaken REF | |
41ca3a40 JH |
12009 | |
12010 | =item COPYRIGHT | |
12011 | ||
12012 | =item BLATANT PLUG | |
12013 | ||
12014 | =back | |
12015 | ||
4d4e713d JH |
12016 | =head2 Locale::Constants - constants for Locale codes |
12017 | ||
12018 | =over 4 | |
12019 | ||
12020 | =item SYNOPSIS | |
12021 | ||
12022 | =item DESCRIPTION | |
12023 | ||
12024 | =item KNOWN BUGS AND LIMITATIONS | |
12025 | ||
12026 | =item SEE ALSO | |
12027 | ||
12028 | Locale::Language, Locale::Country, Locale::Currency | |
12029 | ||
12030 | =item AUTHOR | |
12031 | ||
12032 | =item COPYRIGHT | |
12033 | ||
12034 | =back | |
12035 | ||
12036 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) | |
12037 | ||
12038 | =over 4 | |
12039 | ||
12040 | =item SYNOPSIS | |
12041 | ||
12042 | =back | |
12043 | ||
12044 | =over 4 | |
12045 | ||
12046 | =item DESCRIPTION | |
12047 | ||
12048 | B<alpha-2>, B<alpha-3>, B<numeric> | |
12049 | ||
12050 | =back | |
12051 | ||
12052 | =over 4 | |
12053 | ||
12054 | =item CONVERSION ROUTINES | |
12055 | ||
12056 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), | |
12057 | country_code2code( CODE, CODESET, CODESET ) | |
12058 | ||
12059 | =back | |
12060 | ||
12061 | =over 4 | |
12062 | ||
12063 | =item QUERY ROUTINES | |
12064 | ||
12065 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> | |
12066 | ||
12067 | =back | |
12068 | ||
12069 | =over 4 | |
12070 | ||
12071 | =item CODE ALIASING | |
12072 | ||
12073 | =back | |
12074 | ||
12075 | =over 4 | |
12076 | ||
12077 | =item EXAMPLES | |
12078 | ||
12079 | =item DOMAIN NAMES | |
12080 | ||
12081 | =item KNOWN BUGS AND LIMITATIONS | |
12082 | ||
12083 | =item SEE ALSO | |
12084 | ||
12085 | Locale::Language, Locale::Currency, ISO 3166, | |
12086 | http://www.din.de/gremien/nas/nabd/iso3166ma/, | |
12087 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, | |
12088 | http://www.cia.gov/cia/publications/factbook/docs/app-f.html | |
12089 | ||
12090 | =item AUTHOR | |
12091 | ||
12092 | =item COPYRIGHT | |
12093 | ||
12094 | =back | |
12095 | ||
12096 | =head2 Locale::Currency - ISO three letter codes for currency | |
12097 | identification (ISO 4217) | |
12098 | ||
12099 | =over 4 | |
12100 | ||
12101 | =item SYNOPSIS | |
12102 | ||
12103 | =back | |
12104 | ||
12105 | =over 4 | |
12106 | ||
12107 | =item DESCRIPTION | |
12108 | ||
12109 | XTS, XXX | |
12110 | ||
12111 | =back | |
12112 | ||
12113 | =over 4 | |
12114 | ||
12115 | =item CONVERSION ROUTINES | |
12116 | ||
12117 | code2currency(), currency2code() | |
12118 | ||
12119 | =back | |
12120 | ||
12121 | =over 4 | |
12122 | ||
12123 | =item QUERY ROUTINES | |
12124 | ||
12125 | C<all_currency_codes()>, C<all_currency_names()> | |
12126 | ||
12127 | =back | |
12128 | ||
12129 | =over 4 | |
12130 | ||
12131 | =item EXAMPLES | |
12132 | ||
12133 | =item KNOWN BUGS AND LIMITATIONS | |
12134 | ||
12135 | =item SEE ALSO | |
12136 | ||
12137 | Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency | |
12138 | ||
12139 | =item AUTHOR | |
12140 | ||
12141 | =item COPYRIGHT | |
12142 | ||
12143 | =back | |
12144 | ||
12145 | =head2 Locale::Language - ISO two letter codes for language identification | |
12146 | (ISO 639) | |
12147 | ||
12148 | =over 4 | |
12149 | ||
12150 | =item SYNOPSIS | |
12151 | ||
12152 | =back | |
12153 | ||
12154 | =over 4 | |
12155 | ||
12156 | =item DESCRIPTION | |
12157 | ||
12158 | =back | |
12159 | ||
12160 | =over 4 | |
12161 | ||
12162 | =item CONVERSION ROUTINES | |
12163 | ||
12164 | code2language(), language2code() | |
12165 | ||
12166 | =back | |
12167 | ||
12168 | =over 4 | |
12169 | ||
12170 | =item QUERY ROUTINES | |
12171 | ||
12172 | C<all_language_codes()>, C<all_language_names()> | |
12173 | ||
12174 | =back | |
12175 | ||
12176 | =over 4 | |
12177 | ||
12178 | =item EXAMPLES | |
12179 | ||
12180 | =item KNOWN BUGS AND LIMITATIONS | |
12181 | ||
12182 | =item SEE ALSO | |
12183 | ||
12184 | Locale::Country, Locale::Currency, ISO 639:1988 (E/F), | |
12185 | http://lcweb.loc.gov/standards/iso639-2/langhome.html | |
12186 | ||
12187 | =item AUTHOR | |
12188 | ||
12189 | =item COPYRIGHT | |
12190 | ||
12191 | =back | |
12192 | ||
772ff3b9 JH |
12193 | =head2 Locale::Maketext -- framework for localization |
12194 | ||
12195 | =over 4 | |
12196 | ||
12197 | =item SYNOPSIS | |
12198 | ||
12199 | =item DESCRIPTION | |
12200 | ||
12201 | =item QUICK OVERVIEW | |
12202 | ||
12203 | =item METHODS | |
12204 | ||
12205 | =over 4 | |
12206 | ||
12207 | =item Construction Methods | |
12208 | ||
772ff3b9 JH |
12209 | =item The "maketext" Method |
12210 | ||
12211 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto | |
12212 | ||
12213 | =item Utility Methods | |
12214 | ||
12215 | $language->quant($number, $singular), $language->quant($number, $singular, | |
12216 | $plural), $language->quant($number, $singular, $plural, $negative), | |
12217 | $language->numf($number), $language->sprintf($format, @items), | |
12218 | $language->language_tag(), $language->encoding() | |
12219 | ||
12220 | =item Language Handle Attributes and Internals | |
12221 | ||
12222 | =back | |
12223 | ||
12224 | =item LANGUAGE CLASS HIERARCHIES | |
12225 | ||
12226 | =item ENTRIES IN EACH LEXICON | |
12227 | ||
12228 | =item BRACKET NOTATION | |
12229 | ||
12230 | =item AUTO LEXICONS | |
12231 | ||
12232 | =item CONTROLLING LOOKUP FAILURE | |
12233 | ||
12234 | =item HOW TO USE MAKETEXT | |
12235 | ||
12236 | =item SEE ALSO | |
12237 | ||
12238 | =item COPYRIGHT AND DISCLAIMER | |
12239 | ||
12240 | =item AUTHOR | |
12241 | ||
12242 | =back | |
12243 | ||
12244 | =head2 Locale::Maketext::TPJ13 -- article about software localization | |
12245 | ||
12246 | =over 4 | |
12247 | ||
12248 | =item SYNOPSIS | |
12249 | ||
12250 | =item DESCRIPTION | |
12251 | ||
12252 | =item Localization and Perl: gettext breaks, Maketext fixes | |
12253 | ||
12254 | =over 4 | |
12255 | ||
12256 | =item A Localization Horror Story: It Could Happen To You | |
12257 | ||
12258 | =item The Linguistic View | |
12259 | ||
12260 | =item Breaking gettext | |
12261 | ||
12262 | =item Replacing gettext | |
12263 | ||
12264 | =item Buzzwords: Abstraction and Encapsulation | |
12265 | ||
12266 | =item Buzzword: Isomorphism | |
12267 | ||
12268 | =item Buzzword: Inheritance | |
12269 | ||
12270 | =item Buzzword: Concision | |
12271 | ||
12272 | =item The Devil in the Details | |
12273 | ||
12274 | =item The Proof in the Pudding: Localizing Web Sites | |
12275 | ||
12276 | =item References | |
12277 | ||
12278 | =back | |
12279 | ||
12280 | =back | |
12281 | ||
ab1e085c JH |
12282 | =head2 MIME::Base64 - Encoding and decoding of base64 strings |
12283 | ||
12284 | =over 4 | |
12285 | ||
12286 | =item SYNOPSIS | |
12287 | ||
12288 | =item DESCRIPTION | |
12289 | ||
12290 | encode_base64($str, [$eol]), decode_base64($str) | |
12291 | ||
12292 | =item DIAGNOSTICS | |
12293 | ||
12294 | Premature end of base64 data, Premature padding of base64 data | |
12295 | ||
12296 | =item EXAMPLES | |
12297 | ||
12298 | =item COPYRIGHT | |
12299 | ||
12300 | =back | |
12301 | ||
12302 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding | |
12303 | of quoted-printable strings | |
12304 | ||
12305 | =over 4 | |
12306 | ||
12307 | =item SYNOPSIS | |
12308 | ||
12309 | =item DESCRIPTION | |
12310 | ||
12311 | encode_qp($str), decode_qp($str); | |
12312 | ||
12313 | =item COPYRIGHT | |
12314 | ||
12315 | =back | |
12316 | ||
12317 | =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable | |
12318 | strings | |
12319 | ||
12320 | =over 4 | |
12321 | ||
12322 | =item SYNOPSIS | |
12323 | ||
12324 | =item DESCRIPTION | |
12325 | ||
12326 | encode_qp($str), decode_qp($str); | |
12327 | ||
12328 | =item COPYRIGHT | |
12329 | ||
12330 | =back | |
12331 | ||
9038e305 | 12332 | =head2 Math::BigFloat - Arbitrary size floating point math package |
cb1a09d0 | 12333 | |
d420ca49 | 12334 | =over 4 |
a45bd81d | 12335 | |
8ebc5c01 | 12336 | =item SYNOPSIS |
cb1a09d0 AD |
12337 | |
12338 | =item DESCRIPTION | |
12339 | ||
9038e305 JH |
12340 | =over 4 |
12341 | ||
12342 | =item Canonical notation | |
12343 | ||
12344 | =item Output | |
12345 | ||
12346 | =item C<mantissa()>, C<exponent()> and C<parts()> | |
12347 | ||
12348 | =item Accuracy vs. Precision | |
12349 | ||
12350 | =item Rounding | |
12351 | ||
4f233aa4 JH |
12352 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale |
12353 | ), fround ( -$scale ) and fround ( 0 ) | |
9038e305 JH |
12354 | |
12355 | =back | |
12356 | ||
12357 | =item EXAMPLES | |
12358 | ||
12359 | use Math::BigFloat qw(bstr bint); | |
12360 | # not ready yet | |
12361 | $x = bstr("1234") # string "1234" | |
12362 | $x = "$x"; # same as bstr() | |
12363 | $x = bneg("1234") # BigFloat "-1234" | |
12364 | $x = Math::BigFloat->bneg("1234"); # BigFloat "1234" | |
12365 | $x = Math::BigFloat->babs("-12345"); # BigFloat "12345" | |
12366 | $x = Math::BigFloat->bnorm("-0 00"); # BigFloat "0" | |
12367 | $x = bint(1) + bint(2); # BigFloat "3" | |
12368 | $x = bint(1) + "2"; # ditto (auto-BigFloatify of "2") | |
12369 | $x = bint(1); # BigFloat "1" | |
12370 | $x = $x + 5 / 2; # BigFloat "3" | |
12371 | $x = $x ** 3; # BigFloat "27" | |
12372 | $x *= 2; # BigFloat "54" | |
12373 | $x = new Math::BigFloat; # BigFloat "0" | |
12374 | $x--; # BigFloat "-1" | |
12375 | ||
12376 | =item Autocreating constants | |
12377 | ||
12378 | =item PERFORMANCE | |
cb1a09d0 | 12379 | |
b38f6a39 | 12380 | =item BUGS |
7d2bfb28 | 12381 | |
9038e305 JH |
12382 | =item CAVEAT |
12383 | ||
12384 | stringify, bstr(), bdiv, Modifying and =, bpow | |
12385 | ||
12386 | =item LICENSE | |
12387 | ||
12388 | =item AUTHORS | |
7d2bfb28 | 12389 | |
b38f6a39 GS |
12390 | =back |
12391 | ||
12392 | =head2 Math::BigInt - Arbitrary size integer math package | |
12393 | ||
d420ca49 | 12394 | =over 4 |
8ebc5c01 | 12395 | |
b38f6a39 | 12396 | =item SYNOPSIS |
d516a115 | 12397 | |
b38f6a39 GS |
12398 | =item DESCRIPTION |
12399 | ||
12400 | Canonical notation, Input, Output | |
12401 | ||
9038e305 JH |
12402 | =over 4 |
12403 | ||
12404 | =item Rounding | |
12405 | ||
4f233aa4 | 12406 | bfround ( +$scale ), bround ( +$scale ), bround ( -$scale ) |
9038e305 JH |
12407 | |
12408 | =item Internals | |
12409 | ||
12410 | =item mantissa(), exponent() and parts() | |
12411 | ||
12412 | =back | |
b38f6a39 GS |
12413 | |
12414 | =item Autocreating constants | |
4a6725af | 12415 | |
9038e305 JH |
12416 | =item PERFORMANCE |
12417 | ||
8ebc5c01 | 12418 | =item BUGS |
7d2bfb28 | 12419 | |
9038e305 JH |
12420 | :constant and eval() |
12421 | ||
12422 | =item CAVEATS | |
12423 | ||
12424 | stringify, bstr(), bsstr() and 'cmp', int(), bdiv, Modifying and =, bpow, | |
12425 | Overloading -$x, Mixing different object types, bsqrt() | |
12426 | ||
12427 | =item LICENSE | |
12428 | ||
12429 | =item AUTHORS | |
7d2bfb28 | 12430 | |
a45bd81d GS |
12431 | =back |
12432 | ||
d722968f JH |
12433 | =head2 Math::Complex - complex numbers and associated mathematical |
12434 | functions | |
12435 | ||
d420ca49 | 12436 | =over 4 |
d722968f JH |
12437 | |
12438 | =item SYNOPSIS | |
12439 | ||
12440 | =item DESCRIPTION | |
12441 | ||
12442 | =item OPERATIONS | |
12443 | ||
12444 | =item CREATION | |
12445 | ||
12446 | =item STRINGIFICATION | |
12447 | ||
d420ca49 | 12448 | =over 4 |
d722968f JH |
12449 | |
12450 | =item CHANGED IN PERL 5.6 | |
12451 | ||
12452 | =back | |
12453 | ||
12454 | =item USAGE | |
12455 | ||
12456 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
12457 | ||
12458 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
12459 | ||
12460 | =item BUGS | |
12461 | ||
12462 | =item AUTHORS | |
12463 | ||
12464 | =back | |
12465 | ||
4a6725af NT |
12466 | =head2 Math::Trig - trigonometric functions |
12467 | ||
d420ca49 | 12468 | =over 4 |
a45bd81d | 12469 | |
4a6725af NT |
12470 | =item SYNOPSIS |
12471 | ||
12472 | =item DESCRIPTION | |
12473 | ||
12474 | =item TRIGONOMETRIC FUNCTIONS | |
12475 | ||
fb9cefb4 GS |
12476 | B<tan> |
12477 | ||
d420ca49 | 12478 | =over 4 |
4a6725af | 12479 | |
5cd24f17 | 12480 | =item ERRORS DUE TO DIVISION BY ZERO |
12481 | ||
12482 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
4a6725af NT |
12483 | |
12484 | =back | |
12485 | ||
fb9cefb4 GS |
12486 | =item PLANE ANGLE CONVERSIONS |
12487 | ||
12488 | =item RADIAL COORDINATE CONVERSIONS | |
12489 | ||
d420ca49 | 12490 | =over 4 |
fb9cefb4 GS |
12491 | |
12492 | =item COORDINATE SYSTEMS | |
12493 | ||
12494 | =item 3-D ANGLE CONVERSIONS | |
12495 | ||
12496 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
12497 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
12498 | ||
12499 | =back | |
12500 | ||
0d0e97a6 | 12501 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS |
fb9cefb4 GS |
12502 | |
12503 | =item EXAMPLES | |
4a6725af | 12504 | |
0d0e97a6 JH |
12505 | =over 4 |
12506 | ||
12507 | =item CAVEAT FOR GREAT CIRCLE FORMULAS | |
12508 | ||
12509 | =back | |
12510 | ||
5cd24f17 | 12511 | =item BUGS |
12512 | ||
12513 | =item AUTHORS | |
12514 | ||
a45bd81d GS |
12515 | =back |
12516 | ||
9038e305 JH |
12517 | =head2 Memoize - Make your functions faster by trading space for time |
12518 | ||
12519 | =over 4 | |
12520 | ||
12521 | =item SYNOPSIS | |
12522 | ||
12523 | =item DESCRIPTION | |
12524 | ||
12525 | =item DETAILS | |
12526 | ||
12527 | =item OPTIONS | |
12528 | ||
12529 | =over 4 | |
12530 | ||
12531 | =item INSTALL | |
12532 | ||
12533 | =item NORMALIZER | |
12534 | ||
12535 | =item C<SCALAR_CACHE>, C<LIST_CACHE> | |
12536 | ||
12537 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> | |
12538 | ||
12539 | =back | |
12540 | ||
12541 | =item OTHER FACILITIES | |
12542 | ||
12543 | =over 4 | |
12544 | ||
12545 | =item C<unmemoize> | |
12546 | ||
12547 | =item C<flush_cache> | |
12548 | ||
12549 | =back | |
12550 | ||
12551 | =item CAVEATS | |
12552 | ||
12553 | =item PERSISTENT CACHE SUPPORT | |
12554 | ||
12555 | =item EXPIRATION SUPPORT | |
12556 | ||
12557 | =item BUGS | |
12558 | ||
12559 | =item MAILING LIST | |
12560 | ||
12561 | =item AUTHOR | |
12562 | ||
7a49b635 JH |
12563 | =item COPYRIGHT AND LICENSE |
12564 | ||
9038e305 JH |
12565 | =item THANK YOU |
12566 | ||
12567 | =back | |
12568 | ||
12569 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for | |
12570 | Storable use | |
12571 | ||
12572 | =over 4 | |
12573 | ||
12574 | =item DESCRIPTION | |
12575 | ||
12576 | =back | |
12577 | ||
12578 | =head2 Memoize::Expire - Plug-in module for automatic expiration of | |
12579 | memoized values | |
12580 | ||
12581 | =over 4 | |
12582 | ||
12583 | =item SYNOPSIS | |
12584 | ||
12585 | =item DESCRIPTION | |
12586 | ||
12587 | =item INTERFACE | |
12588 | ||
12589 | TIEHASH, EXISTS, STORE | |
12590 | ||
12591 | =item ALTERNATIVES | |
12592 | ||
12593 | =item CAVEATS | |
12594 | ||
12595 | =item AUTHOR | |
12596 | ||
12597 | =item SEE ALSO | |
12598 | ||
12599 | =back | |
12600 | ||
12601 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics | |
12602 | ||
12603 | =over 4 | |
12604 | ||
12605 | =item DESCRIPTION | |
12606 | ||
12607 | =back | |
12608 | ||
12609 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics | |
12610 | ||
12611 | =over 4 | |
12612 | ||
12613 | =item DESCRIPTION | |
12614 | ||
12615 | =back | |
12616 | ||
12617 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for | |
12618 | Storable use | |
12619 | ||
12620 | =over 4 | |
12621 | ||
12622 | =item DESCRIPTION | |
12623 | ||
12624 | =back | |
12625 | ||
12626 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for | |
12627 | Storable use | |
12628 | ||
12629 | =over 4 | |
12630 | ||
12631 | =item DESCRIPTION | |
12632 | ||
12633 | =back | |
12634 | ||
12635 | =head2 Memoize::Saves - Plug-in module to specify which return values | |
12636 | should be memoized | |
12637 | ||
12638 | =over 4 | |
12639 | ||
12640 | =item SYNOPSIS | |
12641 | ||
12642 | =item DESCRIPTION | |
12643 | ||
12644 | =item CAVEATS | |
12645 | ||
12646 | =item AUTHOR | |
12647 | ||
12648 | =item SEE ALSO | |
12649 | ||
12650 | =back | |
12651 | ||
12652 | =head2 Memoize::Storable - store Memoized data in Storable database | |
12653 | ||
12654 | =over 4 | |
12655 | ||
12656 | =item DESCRIPTION | |
12657 | ||
12658 | =back | |
12659 | ||
8ebc5c01 | 12660 | =head2 NDBM_File - Tied access to ndbm files |
7d2bfb28 | 12661 | |
d420ca49 | 12662 | =over 4 |
a45bd81d | 12663 | |
8ebc5c01 | 12664 | =item SYNOPSIS |
7d2bfb28 | 12665 | |
4d4e713d JH |
12666 | =item DESCRIPTION |
12667 | ||
a9ef4385 JH |
12668 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
12669 | ||
12670 | =item DIAGNOSTICS | |
12671 | ||
d420ca49 | 12672 | =over 4 |
a9ef4385 JH |
12673 | |
12674 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
12675 | ||
12676 | =back | |
12677 | ||
12678 | =item BUGS AND WARNINGS | |
7d2bfb28 | 12679 | |
a45bd81d GS |
12680 | =back |
12681 | ||
1fa7ca25 JH |
12682 | =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch |
12683 | ||
12684 | =over 4 | |
12685 | ||
12686 | =item SYNOPSIS | |
12687 | ||
12688 | =item DESCRIPTION | |
12689 | ||
12690 | =item AUTHOR | |
12691 | ||
12692 | =item BUGS AND IRRITATIONS | |
12693 | ||
12694 | =item COPYRIGHT | |
12695 | ||
12696 | =back | |
12697 | ||
5d80033a JH |
12698 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) |
12699 | ||
12700 | =over 4 | |
12701 | ||
12702 | =item SYNOPSIS | |
12703 | ||
12704 | =item DESCRIPTION | |
12705 | ||
12706 | =item USER METHODS | |
12707 | ||
12708 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), | |
12709 | dataend () | |
12710 | ||
12711 | =item CLASS METHODS | |
12712 | ||
12713 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... | |
12714 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), | |
12715 | ungetline ( TEXT ), read_until_dot () | |
12716 | ||
12717 | =item EXPORTS | |
12718 | ||
12719 | =item AUTHOR | |
12720 | ||
12721 | =item COPYRIGHT | |
12722 | ||
12723 | =back | |
12724 | ||
12725 | =head2 Net::Config - Local configuration data for libnet | |
12726 | ||
12727 | =over 4 | |
12728 | ||
12729 | =item SYNOPSYS | |
12730 | ||
12731 | =item DESCRIPTION | |
12732 | ||
12733 | =item METHODS | |
12734 | ||
12735 | requires_firewall HOST | |
12736 | ||
12737 | =item NetConfig VALUES | |
12738 | ||
12739 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, | |
12740 | time_hosts, inet_domain, ftp_firewall, ftp_ext_passive, ftp_int_pasive, | |
12741 | local_netmask, test_hosts, test_exists | |
12742 | ||
12743 | =back | |
12744 | ||
12745 | =head2 Net::Domain - Attempt to evaluate the current host's internet name | |
12746 | and domain | |
12747 | ||
12748 | =over 4 | |
12749 | ||
12750 | =item SYNOPSIS | |
12751 | ||
12752 | =item DESCRIPTION | |
12753 | ||
12754 | hostfqdn (), hostname (), hostdomain () | |
12755 | ||
12756 | =item AUTHOR | |
12757 | ||
12758 | =item COPYRIGHT | |
12759 | ||
12760 | =back | |
12761 | ||
5d80033a JH |
12762 | =head2 Net::FTP - FTP Client class |
12763 | ||
12764 | =over 4 | |
12765 | ||
12766 | =item SYNOPSIS | |
12767 | ||
12768 | =item DESCRIPTION | |
12769 | ||
12770 | =item OVERVIEW | |
12771 | ||
12772 | =item CONSTRUCTOR | |
12773 | ||
12774 | new (HOST [,OPTIONS]) | |
12775 | ||
12776 | =item METHODS | |
12777 | ||
12778 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), | |
12779 | site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) | |
12780 | ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME | |
12781 | ), cwd ( [ DIR ] ), cdup (), pwd (), rmdir ( DIR ), mkdir ( DIR [, RECURSE | |
12782 | ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, | |
12783 | WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, | |
12784 | REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), | |
12785 | mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash ( | |
12786 | [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ | |
12787 | DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( | |
12788 | [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), | |
12789 | pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( | |
12790 | NON_PASV_SERVER ), abort (), quit () | |
12791 | ||
12792 | =over 4 | |
12793 | ||
12794 | =item Methods for the adventurous | |
12795 | ||
12796 | quot (CMD [,ARGS]) | |
12797 | ||
12798 | =back | |
12799 | ||
12800 | =item THE dataconn CLASS | |
12801 | ||
12802 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), | |
12803 | abort (), close () | |
12804 | ||
12805 | =item UNIMPLEMENTED | |
12806 | ||
12807 | B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> | |
12808 | ||
12809 | =item REPORTING BUGS | |
12810 | ||
12811 | =item AUTHOR | |
12812 | ||
12813 | =item SEE ALSO | |
12814 | ||
12815 | =item CREDITS | |
12816 | ||
12817 | =item COPYRIGHT | |
12818 | ||
12819 | =back | |
12820 | ||
12821 | =head2 Net::NNTP - NNTP Client class | |
12822 | ||
12823 | =over 4 | |
12824 | ||
12825 | =item SYNOPSIS | |
12826 | ||
12827 | =item DESCRIPTION | |
12828 | ||
12829 | =item CONSTRUCTOR | |
12830 | ||
12831 | new ( [ HOST ] [, OPTIONS ]) | |
12832 | ||
12833 | =item METHODS | |
12834 | ||
12835 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( | |
12836 | [ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ] | |
12837 | ), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo ( | |
12838 | USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews ( | |
12839 | SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave | |
12840 | (), quit () | |
12841 | ||
12842 | =over 4 | |
12843 | ||
12844 | =item Extension methods | |
12845 | ||
12846 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), | |
12847 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN | |
12848 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( | |
12849 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ | |
12850 | GROUP ] ), reader | |
12851 | ||
12852 | =back | |
12853 | ||
12854 | =item UNSUPPORTED | |
12855 | ||
12856 | =item DEFINITIONS | |
12857 | ||
12858 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> | |
12859 | ||
12860 | =item SEE ALSO | |
12861 | ||
12862 | =item AUTHOR | |
12863 | ||
12864 | =item COPYRIGHT | |
12865 | ||
12866 | =back | |
12867 | ||
5d80033a JH |
12868 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081) |
12869 | ||
12870 | =over 4 | |
12871 | ||
12872 | =item SYNOPSIS | |
12873 | ||
12874 | =item DESCRIPTION | |
12875 | ||
12876 | =item EXAMPLES | |
12877 | ||
12878 | =item CONSTRUCTOR | |
12879 | ||
12880 | new ( [ HOST, ] [ OPTIONS ] ) | |
12881 | ||
12882 | =item METHODS | |
12883 | ||
12884 | user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER, | |
12885 | PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, | |
12886 | FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete ( | |
12887 | MSGNUM ), reset (), quit () | |
12888 | ||
12889 | =item NOTES | |
12890 | ||
12891 | =item SEE ALSO | |
12892 | ||
12893 | =item AUTHOR | |
12894 | ||
12895 | =item COPYRIGHT | |
12896 | ||
12897 | =back | |
12898 | ||
8ebc5c01 | 12899 | =head2 Net::Ping - check a remote host for reachability |
7d2bfb28 | 12900 | |
d420ca49 | 12901 | =over 4 |
a45bd81d | 12902 | |
8ebc5c01 | 12903 | =item SYNOPSIS |
7d2bfb28 | 12904 | |
8ebc5c01 | 12905 | =item DESCRIPTION |
7d2bfb28 | 12906 | |
41ca3a40 JH |
12907 | icmp, udp, tcp, stream, external |
12908 | ||
d420ca49 | 12909 | =over 4 |
8ebc5c01 | 12910 | |
12911 | =item Functions | |
7d2bfb28 | 12912 | |
8ebc5c01 | 12913 | Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, |
41ca3a40 | 12914 | $timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]); |
7d2bfb28 | 12915 | |
8ebc5c01 | 12916 | =back |
12917 | ||
8ebc5c01 | 12918 | =item NOTES |
7d2bfb28 | 12919 | |
a45bd81d GS |
12920 | =back |
12921 | ||
5d80033a JH |
12922 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client |
12923 | ||
12924 | =over 4 | |
12925 | ||
12926 | =item SYNOPSIS | |
12927 | ||
12928 | =item DESCRIPTION | |
12929 | ||
12930 | =item EXAMPLES | |
12931 | ||
12932 | =item CONSTRUCTOR | |
12933 | ||
12934 | new Net::SMTP [ HOST, ] [ OPTIONS ] | |
12935 | ||
12936 | =item METHODS | |
12937 | ||
12938 | banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [, | |
12939 | OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail ( | |
12940 | ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ), | |
12941 | to ( ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), | |
12942 | verify ( ADDRESS ), help ( [ $subject ] ), quit () | |
12943 | ||
12944 | =item SEE ALSO | |
12945 | ||
12946 | =item AUTHOR | |
12947 | ||
12948 | =item COPYRIGHT | |
12949 | ||
12950 | =back | |
12951 | ||
5d80033a JH |
12952 | =head2 Net::Time - time and daytime network client interface |
12953 | ||
12954 | =over 4 | |
12955 | ||
12956 | =item SYNOPSIS | |
12957 | ||
12958 | =item DESCRIPTION | |
12959 | ||
12960 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, | |
12961 | PROTOCOL [, TIMEOUT]]]) | |
12962 | ||
12963 | =item AUTHOR | |
12964 | ||
12965 | =item COPYRIGHT | |
12966 | ||
12967 | =back | |
12968 | ||
8ebc5c01 | 12969 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
12970 | functions | |
7d2bfb28 | 12971 | |
d420ca49 | 12972 | =over 4 |
a45bd81d | 12973 | |
8ebc5c01 | 12974 | =item SYNOPSIS |
7d2bfb28 | 12975 | |
8ebc5c01 | 12976 | =item DESCRIPTION |
7d2bfb28 | 12977 | |
cb1a09d0 AD |
12978 | =item EXAMPLES |
12979 | ||
8ebc5c01 | 12980 | =item NOTE |
cb1a09d0 | 12981 | |
8ebc5c01 | 12982 | =item AUTHOR |
cb1a09d0 | 12983 | |
a45bd81d GS |
12984 | =back |
12985 | ||
5d80033a JH |
12986 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions |
12987 | ||
12988 | =over 4 | |
12989 | ||
12990 | =item DESCRIPTION | |
12991 | ||
12992 | =over 4 | |
12993 | ||
12994 | =item Where to get this document | |
12995 | ||
12996 | =item How to contribute to this document | |
12997 | ||
12998 | =back | |
12999 | ||
13000 | =item Author and Copyright Information | |
13001 | ||
13002 | =over 4 | |
13003 | ||
13004 | =item Disclaimer | |
13005 | ||
13006 | =back | |
13007 | ||
13008 | =item Obtaining and installing libnet | |
13009 | ||
13010 | =over 4 | |
13011 | ||
13012 | =item What is libnet ? | |
13013 | ||
13014 | =item Which version of perl do I need ? | |
13015 | ||
13016 | =item What other modules do I need ? | |
13017 | ||
13018 | =item What machines support libnet ? | |
13019 | ||
13020 | =item Where can I get the latest libnet release | |
13021 | ||
13022 | =back | |
13023 | ||
13024 | =item Using Net::FTP | |
13025 | ||
13026 | =over 4 | |
13027 | ||
13028 | =item How do I download files from a FTP server ? | |
13029 | ||
13030 | =item How do I transfer files in binary mode ? | |
13031 | ||
13032 | =item How can I get the size of a file on a remote FTP server ? | |
13033 | ||
13034 | =item How can I get the modification time of a file on a remote FTP server | |
13035 | ? | |
13036 | ||
13037 | =item How can I change the permissions of a file on a remote server ? | |
13038 | ||
13039 | =item Can I do a reget operation like the ftp command ? | |
13040 | ||
13041 | =item How do I get a directory listing from a FTP server ? | |
13042 | ||
13043 | =item Changeing directory to "" does not fail ? | |
13044 | ||
13045 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? | |
13046 | ||
13047 | =item I am behind a FTP proxy firewall, but cannot access machines outside | |
13048 | ? | |
13049 | ||
13050 | =item My ftp proxy firewall does not listen on port 21 | |
13051 | ||
13052 | =item Is it possible to change the file permissions of a file on an FTP | |
13053 | server ? | |
13054 | ||
13055 | =item I have seen scripts call a method message, but cannot find it | |
13056 | documented ? | |
13057 | ||
13058 | =item Why does Net::FTP not implement mput and mget methods | |
13059 | ||
13060 | =back | |
13061 | ||
13062 | =item Using Net::SMTP | |
13063 | ||
13064 | =over 4 | |
13065 | ||
13066 | =item Why can't the part of an Email address after the @ be used as the | |
13067 | hostname ? | |
13068 | ||
13069 | =item Why does Net::SMTP not do DNS MX lookups ? | |
13070 | ||
13071 | =item The verify method always returns true ? | |
13072 | ||
13073 | =back | |
13074 | ||
13075 | =item Debugging scripts | |
13076 | ||
13077 | =over 4 | |
13078 | ||
13079 | =item How can I debug my scripts that use Net::* modules ? | |
13080 | ||
13081 | =back | |
13082 | ||
13083 | =item AUTHOR AND COPYRIGHT | |
13084 | ||
13085 | =back | |
13086 | ||
8ebc5c01 | 13087 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
13088 | functions | |
cb1a09d0 | 13089 | |
d420ca49 | 13090 | =over 4 |
a45bd81d | 13091 | |
8ebc5c01 | 13092 | =item SYNOPSIS |
cb1a09d0 | 13093 | |
8ebc5c01 | 13094 | =item DESCRIPTION |
cb1a09d0 | 13095 | |
8ebc5c01 | 13096 | =item EXAMPLES |
cb1a09d0 | 13097 | |
8ebc5c01 | 13098 | =item NOTE |
cb1a09d0 | 13099 | |
8ebc5c01 | 13100 | =item AUTHOR |
cb1a09d0 | 13101 | |
a45bd81d GS |
13102 | =back |
13103 | ||
8ebc5c01 | 13104 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
13105 | functions | |
cb1a09d0 | 13106 | |
d420ca49 | 13107 | =over 4 |
a45bd81d | 13108 | |
8ebc5c01 | 13109 | =item SYNOPSIS |
cb1a09d0 AD |
13110 | |
13111 | =item DESCRIPTION | |
13112 | ||
8ebc5c01 | 13113 | =item NOTE |
cb1a09d0 | 13114 | |
8ebc5c01 | 13115 | =item AUTHOR |
cb1a09d0 | 13116 | |
a45bd81d GS |
13117 | =back |
13118 | ||
8ebc5c01 | 13119 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
13120 | functions | |
cb1a09d0 | 13121 | |
d420ca49 | 13122 | =over 4 |
a45bd81d | 13123 | |
cb1a09d0 AD |
13124 | =item SYNOPSIS |
13125 | ||
cb1a09d0 AD |
13126 | =item DESCRIPTION |
13127 | ||
8ebc5c01 | 13128 | =item EXAMPLES |
cb1a09d0 | 13129 | |
8ebc5c01 | 13130 | =item NOTE |
cb1a09d0 | 13131 | |
8ebc5c01 | 13132 | =item AUTHOR |
cb1a09d0 | 13133 | |
a45bd81d GS |
13134 | =back |
13135 | ||
5d80033a JH |
13136 | =head2 Netrc, Net::Netrc - OO interface to users netrc file |
13137 | ||
13138 | =over 4 | |
13139 | ||
13140 | =item SYNOPSIS | |
13141 | ||
13142 | =item DESCRIPTION | |
13143 | ||
13144 | =item THE .netrc FILE | |
13145 | ||
13146 | machine name, default, login name, password string, account string, macdef | |
13147 | name | |
13148 | ||
13149 | =item CONSTRUCTOR | |
13150 | ||
13151 | lookup ( MACHINE [, LOGIN ]) | |
13152 | ||
13153 | =item METHODS | |
13154 | ||
13155 | login (), password (), account (), lpa () | |
13156 | ||
13157 | =item AUTHOR | |
13158 | ||
13159 | =item SEE ALSO | |
13160 | ||
13161 | =item COPYRIGHT | |
13162 | ||
13163 | =back | |
13164 | ||
14218588 GS |
13165 | =head2 O - Generic interface to Perl Compiler backends |
13166 | ||
d420ca49 | 13167 | =over 4 |
a45bd81d | 13168 | |
14218588 GS |
13169 | =item SYNOPSIS |
13170 | ||
13171 | =item DESCRIPTION | |
13172 | ||
13173 | =item CONVENTIONS | |
13174 | ||
13175 | =item IMPLEMENTATION | |
13176 | ||
13177 | =item AUTHOR | |
13178 | ||
a45bd81d GS |
13179 | =back |
13180 | ||
8ebc5c01 | 13181 | =head2 ODBM_File - Tied access to odbm files |
cb1a09d0 | 13182 | |
d420ca49 | 13183 | =over 4 |
a45bd81d | 13184 | |
cb1a09d0 AD |
13185 | =item SYNOPSIS |
13186 | ||
4d4e713d JH |
13187 | =item DESCRIPTION |
13188 | ||
a9ef4385 JH |
13189 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
13190 | ||
13191 | =item DIAGNOSTICS | |
13192 | ||
d420ca49 | 13193 | =over 4 |
a9ef4385 JH |
13194 | |
13195 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
13196 | ||
13197 | =back | |
13198 | ||
13199 | =item BUGS AND WARNINGS | |
cb1a09d0 | 13200 | |
a45bd81d GS |
13201 | =back |
13202 | ||
8ebc5c01 | 13203 | =head2 Opcode - Disable named opcodes when compiling perl code |
cb1a09d0 | 13204 | |
d420ca49 | 13205 | =over 4 |
a45bd81d | 13206 | |
8ebc5c01 | 13207 | =item SYNOPSIS |
cb1a09d0 | 13208 | |
8ebc5c01 | 13209 | =item DESCRIPTION |
cb1a09d0 | 13210 | |
8ebc5c01 | 13211 | =item NOTE |
cb1a09d0 | 13212 | |
8ebc5c01 | 13213 | =item WARNING |
cb1a09d0 | 13214 | |
8ebc5c01 | 13215 | =item Operator Names and Operator Lists |
cb1a09d0 | 13216 | |
8ebc5c01 | 13217 | an operator name (opname), an operator tag name (optag), a negated opname |
13218 | or optag, an operator set (opset) | |
cb1a09d0 | 13219 | |
8ebc5c01 | 13220 | =item Opcode Functions |
cb1a09d0 | 13221 | |
8ebc5c01 | 13222 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
13223 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
13224 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
13225 | opdump (PAT) | |
cb1a09d0 | 13226 | |
8ebc5c01 | 13227 | =item Manipulating Opsets |
cb1a09d0 | 13228 | |
8ebc5c01 | 13229 | =item TO DO (maybe) |
cb1a09d0 | 13230 | |
a45bd81d GS |
13231 | =back |
13232 | ||
d420ca49 | 13233 | =over 4 |
a45bd81d | 13234 | |
8ebc5c01 | 13235 | =item Predefined Opcode Tags |
cb1a09d0 | 13236 | |
8ebc5c01 | 13237 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
d516a115 JH |
13238 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
13239 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
13240 | :dangerous | |
cb1a09d0 | 13241 | |
8ebc5c01 | 13242 | =item SEE ALSO |
cb1a09d0 | 13243 | |
8ebc5c01 | 13244 | =item AUTHORS |
cb1a09d0 | 13245 | |
a45bd81d GS |
13246 | =back |
13247 | ||
8ebc5c01 | 13248 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
13249 | compartments | |
cb1a09d0 | 13250 | |
d420ca49 | 13251 | =over 4 |
a45bd81d | 13252 | |
cb1a09d0 AD |
13253 | =item SYNOPSIS |
13254 | ||
cb1a09d0 AD |
13255 | =item DESCRIPTION |
13256 | ||
8ebc5c01 | 13257 | a new namespace, an operator mask |
13258 | ||
13259 | =item WARNING | |
cb1a09d0 | 13260 | |
d420ca49 | 13261 | =over 4 |
cb1a09d0 | 13262 | |
8ebc5c01 | 13263 | =item RECENT CHANGES |
cb1a09d0 | 13264 | |
8ebc5c01 | 13265 | =item Methods in class Safe |
cb1a09d0 | 13266 | |
8ebc5c01 | 13267 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
13268 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
13269 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
13270 | root (NAMESPACE), mask (MASK) | |
cb1a09d0 | 13271 | |
8ebc5c01 | 13272 | =item Some Safety Issues |
cb1a09d0 | 13273 | |
8ebc5c01 | 13274 | Memory, CPU, Snooping, Signals, State Changes |
cb1a09d0 | 13275 | |
8ebc5c01 | 13276 | =item AUTHOR |
cb1a09d0 | 13277 | |
8ebc5c01 | 13278 | =back |
cb1a09d0 | 13279 | |
a45bd81d GS |
13280 | =back |
13281 | ||
8ebc5c01 | 13282 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
13283 | compiling | |
cb1a09d0 | 13284 | |
d420ca49 | 13285 | =over 4 |
a45bd81d | 13286 | |
14218588 | 13287 | =item SYNOPSIS |
cb1a09d0 | 13288 | |
8ebc5c01 | 13289 | =item DESCRIPTION |
cb1a09d0 | 13290 | |
8ebc5c01 | 13291 | =item SEE ALSO |
cb1a09d0 | 13292 | |
a45bd81d GS |
13293 | =back |
13294 | ||
cb1a09d0 AD |
13295 | =head2 POSIX - Perl interface to IEEE Std 1003.1 |
13296 | ||
d420ca49 | 13297 | =over 4 |
a45bd81d | 13298 | |
cb1a09d0 AD |
13299 | =item SYNOPSIS |
13300 | ||
cb1a09d0 AD |
13301 | =item DESCRIPTION |
13302 | ||
cb1a09d0 AD |
13303 | =item NOTE |
13304 | ||
8ebc5c01 | 13305 | =item CAVEATS |
cb1a09d0 AD |
13306 | |
13307 | =item FUNCTIONS | |
13308 | ||
8ebc5c01 | 13309 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
13310 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
13311 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
13312 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
13313 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
13314 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
13315 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
13316 | fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, | |
13317 | getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, | |
13318 | getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, | |
13319 | iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, | |
13320 | isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, | |
13321 | longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, | |
13322 | memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, | |
13323 | opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, | |
13324 | qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, | |
13325 | rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, | |
13326 | setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
13327 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
13328 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
4755096e GS |
13329 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, |
13330 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
13331 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
13332 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
13333 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
13334 | wctomb, write | |
cb1a09d0 AD |
13335 | |
13336 | =item CLASSES | |
13337 | ||
d420ca49 | 13338 | =over 4 |
cb1a09d0 | 13339 | |
cb1a09d0 AD |
13340 | =item POSIX::SigAction |
13341 | ||
cb1a09d0 AD |
13342 | new |
13343 | ||
13344 | =item POSIX::SigSet | |
13345 | ||
cb1a09d0 AD |
13346 | new, addset, delset, emptyset, fillset, ismember |
13347 | ||
13348 | =item POSIX::Termios | |
13349 | ||
cb1a09d0 AD |
13350 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
13351 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
13352 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
13353 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
13354 | values, c_oflag field values | |
13355 | ||
cb1a09d0 AD |
13356 | =back |
13357 | ||
13358 | =item PATHNAME CONSTANTS | |
13359 | ||
cb1a09d0 AD |
13360 | Constants |
13361 | ||
13362 | =item POSIX CONSTANTS | |
13363 | ||
cb1a09d0 AD |
13364 | Constants |
13365 | ||
13366 | =item SYSTEM CONFIGURATION | |
13367 | ||
cb1a09d0 AD |
13368 | Constants |
13369 | ||
13370 | =item ERRNO | |
13371 | ||
cb1a09d0 AD |
13372 | Constants |
13373 | ||
13374 | =item FCNTL | |
13375 | ||
cb1a09d0 AD |
13376 | Constants |
13377 | ||
13378 | =item FLOAT | |
13379 | ||
cb1a09d0 AD |
13380 | Constants |
13381 | ||
13382 | =item LIMITS | |
13383 | ||
cb1a09d0 AD |
13384 | Constants |
13385 | ||
13386 | =item LOCALE | |
13387 | ||
cb1a09d0 AD |
13388 | Constants |
13389 | ||
13390 | =item MATH | |
13391 | ||
cb1a09d0 AD |
13392 | Constants |
13393 | ||
13394 | =item SIGNAL | |
13395 | ||
cb1a09d0 AD |
13396 | Constants |
13397 | ||
13398 | =item STAT | |
13399 | ||
cb1a09d0 AD |
13400 | Constants, Macros |
13401 | ||
13402 | =item STDLIB | |
13403 | ||
cb1a09d0 AD |
13404 | Constants |
13405 | ||
13406 | =item STDIO | |
13407 | ||
cb1a09d0 AD |
13408 | Constants |
13409 | ||
13410 | =item TIME | |
13411 | ||
cb1a09d0 AD |
13412 | Constants |
13413 | ||
13414 | =item UNISTD | |
13415 | ||
cb1a09d0 AD |
13416 | Constants |
13417 | ||
13418 | =item WAIT | |
13419 | ||
cb1a09d0 AD |
13420 | Constants, Macros |
13421 | ||
a45bd81d GS |
13422 | =back |
13423 | ||
0d0e97a6 JH |
13424 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* |
13425 | name space | |
13426 | ||
13427 | =over 4 | |
13428 | ||
13429 | =item SYNOPSIS | |
13430 | ||
13431 | =item DESCRIPTION | |
13432 | ||
13433 | unix, stdio, perlio, crlf, utf8, raw | |
13434 | ||
13435 | =over 4 | |
13436 | ||
13437 | =item Defaults and how to override them | |
13438 | ||
13439 | =back | |
13440 | ||
13441 | =item AUTHOR | |
13442 | ||
13443 | =item SEE ALSO | |
13444 | ||
13445 | =back | |
13446 | ||
13447 | =head2 PerlIO::Scalar - support module for in-memory IO. | |
13448 | ||
13449 | =over 4 | |
13450 | ||
13451 | =item SYNOPSIS | |
13452 | ||
13453 | =item DESCRIPTION | |
13454 | ||
13455 | =back | |
13456 | ||
13457 | =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl | |
13458 | ||
13459 | =over 4 | |
13460 | ||
13461 | =item SYNOPSIS | |
13462 | ||
13463 | =item DESCRIPTION | |
13464 | ||
13465 | $class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]), | |
13466 | $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd), | |
13467 | $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh), | |
13468 | $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), | |
13469 | $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), | |
13470 | $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), | |
13471 | $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) | |
13472 | ||
13473 | =back | |
13474 | ||
14218588 GS |
13475 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
13476 | ||
d420ca49 | 13477 | =over 4 |
a45bd81d | 13478 | |
14218588 GS |
13479 | =item SYNOPSIS |
13480 | ||
13481 | =item OPTIONS/ARGUMENTS | |
13482 | ||
d420ca49 | 13483 | =over 4 |
a45bd81d | 13484 | |
694468e3 | 13485 | =item podchecker() |
a45bd81d GS |
13486 | |
13487 | B<-warnings> =E<gt> I<val> | |
13488 | ||
13489 | =back | |
13490 | ||
14218588 GS |
13491 | =item DESCRIPTION |
13492 | ||
694468e3 GS |
13493 | =item DIAGNOSTICS |
13494 | ||
d420ca49 | 13495 | =over 4 |
a45bd81d | 13496 | |
694468e3 GS |
13497 | =item Errors |
13498 | ||
13499 | empty =headn, =over on line I<N> without closing =back, =item without | |
13500 | previous =over, =back without previous =over, No argument for =begin, =end | |
13501 | without =begin, Nested =begin's, =for without formatter specification, | |
13502 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
13503 | interior-sequence "I<SEQ>", nested commands | |
13504 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
13505 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
13506 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
13507 | after =back | |
13508 | ||
a45bd81d GS |
13509 | =item Warnings |
13510 | ||
93d73c42 | 13511 | multiple occurence of link target I<name>, line containing nothing but |
4d4e713d JH |
13512 | whitespace in paragraph, file does not start with =head, previous =item has |
13513 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> | |
13514 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No | |
13515 | items in =over, No argument for =item, empty section in previous paragraph, | |
13516 | Verbatim paragraph in NAME section | |
10862624 RF |
13517 | |
13518 | =item Hyperlinks | |
13519 | ||
4d4e713d JH |
13520 | ignoring leading/trailing whitespace in link, (section) in '$page' |
13521 | deprecated, alternative text/node '%s' contains non-escaped | or / | |
a45bd81d | 13522 | |
694468e3 | 13523 | =back |
a45bd81d GS |
13524 | |
13525 | =item RETURN VALUE | |
13526 | ||
14218588 GS |
13527 | =item EXAMPLES |
13528 | ||
694468e3 GS |
13529 | =item INTERFACE |
13530 | ||
13531 | =back | |
13532 | ||
10862624 RF |
13533 | C<Pod::Checker-E<gt>new( %options )> |
13534 | ||
694468e3 GS |
13535 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, |
13536 | @args )> | |
13537 | ||
13538 | C<$checker-E<gt>num_errors()> | |
13539 | ||
13540 | C<$checker-E<gt>name()> | |
13541 | ||
13542 | C<$checker-E<gt>node()> | |
13543 | ||
13544 | C<$checker-E<gt>idx()> | |
13545 | ||
13546 | C<$checker-E<gt>hyperlink()> | |
13547 | ||
d420ca49 | 13548 | =over 4 |
694468e3 | 13549 | |
14218588 GS |
13550 | =item AUTHOR |
13551 | ||
a45bd81d GS |
13552 | =back |
13553 | ||
694468e3 | 13554 | =head2 Pod::Find - find POD documents in directory trees |
a45bd81d | 13555 | |
d420ca49 | 13556 | =over 4 |
a45bd81d GS |
13557 | |
13558 | =item SYNOPSIS | |
13559 | ||
13560 | =item DESCRIPTION | |
13561 | ||
10862624 RF |
13562 | =back |
13563 | ||
d420ca49 | 13564 | =over 4 |
10862624 RF |
13565 | |
13566 | =item C<pod_find( { %opts } , @directories )> | |
a45bd81d | 13567 | |
10862624 RF |
13568 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> |
13569 | 1> | |
13570 | ||
13571 | =back | |
13572 | ||
d420ca49 | 13573 | =over 4 |
10862624 RF |
13574 | |
13575 | =item C<simplify_name( $str )> | |
13576 | ||
13577 | =back | |
13578 | ||
d420ca49 | 13579 | =over 4 |
10862624 RF |
13580 | |
13581 | =item C<pod_where( { %opts }, $pod )> | |
13582 | ||
13583 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
13584 | 1> | |
13585 | ||
13586 | =back | |
13587 | ||
d420ca49 | 13588 | =over 4 |
10862624 RF |
13589 | |
13590 | =item C<contains_pod( $file , $verbose )> | |
13591 | ||
13592 | =back | |
13593 | ||
d420ca49 | 13594 | =over 4 |
a45bd81d GS |
13595 | |
13596 | =item AUTHOR | |
13597 | ||
694468e3 GS |
13598 | =item SEE ALSO |
13599 | ||
a45bd81d GS |
13600 | =back |
13601 | ||
193fb0af | 13602 | =head2 Pod::Html - module to convert pod files to HTML |
54310121 | 13603 | |
d420ca49 | 13604 | =over 4 |
a45bd81d | 13605 | |
54310121 | 13606 | =item SYNOPSIS |
13607 | ||
13608 | =item DESCRIPTION | |
13609 | ||
13610 | =item ARGUMENTS | |
13611 | ||
d2f2ce36 JH |
13612 | backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, |
13613 | infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, | |
13614 | title, verbose | |
54310121 | 13615 | |
13616 | =item EXAMPLE | |
13617 | ||
c76ac1ee GS |
13618 | =item ENVIRONMENT |
13619 | ||
54310121 | 13620 | =item AUTHOR |
13621 | ||
54310121 | 13622 | =item SEE ALSO |
13623 | ||
13624 | =item COPYRIGHT | |
13625 | ||
a45bd81d GS |
13626 | =back |
13627 | ||
14218588 GS |
13628 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
13629 | commands, etc. | |
13630 | ||
d420ca49 | 13631 | =over 4 |
a45bd81d | 13632 | |
14218588 GS |
13633 | =item SYNOPSIS |
13634 | ||
13635 | =item REQUIRES | |
13636 | ||
13637 | =item EXPORTS | |
13638 | ||
13639 | =item DESCRIPTION | |
13640 | ||
10862624 RF |
13641 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package |
13642 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
14218588 | 13643 | |
a45bd81d GS |
13644 | =back |
13645 | ||
d420ca49 | 13646 | =over 4 |
a45bd81d | 13647 | |
14218588 GS |
13648 | =item B<Pod::InputSource> |
13649 | ||
a45bd81d GS |
13650 | =back |
13651 | ||
d420ca49 | 13652 | =over 4 |
14218588 GS |
13653 | |
13654 | =item B<new()> | |
13655 | ||
a45bd81d GS |
13656 | =back |
13657 | ||
d420ca49 | 13658 | =over 4 |
a45bd81d | 13659 | |
14218588 GS |
13660 | =item B<name()> |
13661 | ||
a45bd81d GS |
13662 | =back |
13663 | ||
d420ca49 | 13664 | =over 4 |
a45bd81d | 13665 | |
14218588 GS |
13666 | =item B<handle()> |
13667 | ||
a45bd81d GS |
13668 | =back |
13669 | ||
d420ca49 | 13670 | =over 4 |
a45bd81d | 13671 | |
14218588 GS |
13672 | =item B<was_cutting()> |
13673 | ||
13674 | =back | |
13675 | ||
d420ca49 | 13676 | =over 4 |
a45bd81d | 13677 | |
14218588 GS |
13678 | =item B<Pod::Paragraph> |
13679 | ||
a45bd81d GS |
13680 | =back |
13681 | ||
d420ca49 | 13682 | =over 4 |
14218588 | 13683 | |
10862624 | 13684 | =item Pod::Paragraph-E<gt>B<new()> |
14218588 | 13685 | |
a45bd81d GS |
13686 | =back |
13687 | ||
d420ca49 | 13688 | =over 4 |
a45bd81d | 13689 | |
10862624 | 13690 | =item $pod_para-E<gt>B<cmd_name()> |
14218588 | 13691 | |
a45bd81d GS |
13692 | =back |
13693 | ||
d420ca49 | 13694 | =over 4 |
a45bd81d | 13695 | |
10862624 | 13696 | =item $pod_para-E<gt>B<text()> |
14218588 | 13697 | |
a45bd81d GS |
13698 | =back |
13699 | ||
d420ca49 | 13700 | =over 4 |
a45bd81d | 13701 | |
10862624 | 13702 | =item $pod_para-E<gt>B<raw_text()> |
14218588 | 13703 | |
a45bd81d GS |
13704 | =back |
13705 | ||
d420ca49 | 13706 | =over 4 |
a45bd81d | 13707 | |
10862624 | 13708 | =item $pod_para-E<gt>B<cmd_prefix()> |
14218588 | 13709 | |
a45bd81d GS |
13710 | =back |
13711 | ||
d420ca49 | 13712 | =over 4 |
a45bd81d | 13713 | |
10862624 | 13714 | =item $pod_para-E<gt>B<cmd_separator()> |
14218588 | 13715 | |
a45bd81d GS |
13716 | =back |
13717 | ||
d420ca49 | 13718 | =over 4 |
a45bd81d | 13719 | |
10862624 | 13720 | =item $pod_para-E<gt>B<parse_tree()> |
14218588 | 13721 | |
a45bd81d GS |
13722 | =back |
13723 | ||
d420ca49 | 13724 | =over 4 |
a45bd81d | 13725 | |
10862624 | 13726 | =item $pod_para-E<gt>B<file_line()> |
14218588 GS |
13727 | |
13728 | =back | |
13729 | ||
d420ca49 | 13730 | =over 4 |
a45bd81d | 13731 | |
14218588 GS |
13732 | =item B<Pod::InteriorSequence> |
13733 | ||
a45bd81d GS |
13734 | =back |
13735 | ||
d420ca49 | 13736 | =over 4 |
14218588 | 13737 | |
10862624 | 13738 | =item Pod::InteriorSequence-E<gt>B<new()> |
14218588 | 13739 | |
a45bd81d GS |
13740 | =back |
13741 | ||
d420ca49 | 13742 | =over 4 |
a45bd81d | 13743 | |
10862624 | 13744 | =item $pod_seq-E<gt>B<cmd_name()> |
14218588 | 13745 | |
a45bd81d GS |
13746 | =back |
13747 | ||
d420ca49 | 13748 | =over 4 |
a45bd81d | 13749 | |
10862624 | 13750 | =item $pod_seq-E<gt>B<prepend()> |
14218588 | 13751 | |
a45bd81d GS |
13752 | =back |
13753 | ||
d420ca49 | 13754 | =over 4 |
a45bd81d | 13755 | |
10862624 | 13756 | =item $pod_seq-E<gt>B<append()> |
14218588 | 13757 | |
a45bd81d GS |
13758 | =back |
13759 | ||
d420ca49 | 13760 | =over 4 |
a45bd81d | 13761 | |
10862624 | 13762 | =item $pod_seq-E<gt>B<nested()> |
14218588 | 13763 | |
a45bd81d GS |
13764 | =back |
13765 | ||
d420ca49 | 13766 | =over 4 |
a45bd81d | 13767 | |
10862624 | 13768 | =item $pod_seq-E<gt>B<raw_text()> |
14218588 | 13769 | |
a45bd81d GS |
13770 | =back |
13771 | ||
d420ca49 | 13772 | =over 4 |
a45bd81d | 13773 | |
10862624 | 13774 | =item $pod_seq-E<gt>B<left_delimiter()> |
14218588 | 13775 | |
a45bd81d GS |
13776 | =back |
13777 | ||
d420ca49 | 13778 | =over 4 |
a45bd81d | 13779 | |
10862624 | 13780 | =item $pod_seq-E<gt>B<right_delimiter()> |
14218588 | 13781 | |
a45bd81d GS |
13782 | =back |
13783 | ||
d420ca49 | 13784 | =over 4 |
a45bd81d | 13785 | |
10862624 | 13786 | =item $pod_seq-E<gt>B<parse_tree()> |
14218588 | 13787 | |
a45bd81d GS |
13788 | =back |
13789 | ||
d420ca49 | 13790 | =over 4 |
a45bd81d | 13791 | |
10862624 | 13792 | =item $pod_seq-E<gt>B<file_line()> |
14218588 | 13793 | |
a45bd81d GS |
13794 | =back |
13795 | ||
d420ca49 | 13796 | =over 4 |
a45bd81d | 13797 | |
10862624 | 13798 | =item Pod::InteriorSequence::B<DESTROY()> |
14218588 GS |
13799 | |
13800 | =back | |
13801 | ||
d420ca49 | 13802 | =over 4 |
a45bd81d | 13803 | |
14218588 GS |
13804 | =item B<Pod::ParseTree> |
13805 | ||
a45bd81d GS |
13806 | =back |
13807 | ||
d420ca49 | 13808 | =over 4 |
14218588 | 13809 | |
10862624 | 13810 | =item Pod::ParseTree-E<gt>B<new()> |
14218588 | 13811 | |
a45bd81d GS |
13812 | =back |
13813 | ||
d420ca49 | 13814 | =over 4 |
a45bd81d | 13815 | |
10862624 | 13816 | =item $ptree-E<gt>B<top()> |
14218588 | 13817 | |
a45bd81d GS |
13818 | =back |
13819 | ||
d420ca49 | 13820 | =over 4 |
a45bd81d | 13821 | |
10862624 | 13822 | =item $ptree-E<gt>B<children()> |
14218588 | 13823 | |
a45bd81d GS |
13824 | =back |
13825 | ||
d420ca49 | 13826 | =over 4 |
a45bd81d | 13827 | |
10862624 | 13828 | =item $ptree-E<gt>B<prepend()> |
14218588 | 13829 | |
a45bd81d GS |
13830 | =back |
13831 | ||
d420ca49 | 13832 | =over 4 |
a45bd81d | 13833 | |
10862624 | 13834 | =item $ptree-E<gt>B<append()> |
14218588 | 13835 | |
a45bd81d GS |
13836 | =back |
13837 | ||
d420ca49 | 13838 | =over 4 |
a45bd81d | 13839 | |
10862624 | 13840 | =item $ptree-E<gt>B<raw_text()> |
14218588 | 13841 | |
a45bd81d GS |
13842 | =back |
13843 | ||
d420ca49 | 13844 | =over 4 |
a45bd81d | 13845 | |
10862624 | 13846 | =item Pod::ParseTree::B<DESTROY()> |
14218588 GS |
13847 | |
13848 | =back | |
13849 | ||
d420ca49 | 13850 | =over 4 |
a45bd81d | 13851 | |
14218588 GS |
13852 | =item SEE ALSO |
13853 | ||
13854 | =item AUTHOR | |
13855 | ||
a45bd81d GS |
13856 | =back |
13857 | ||
497711e7 GS |
13858 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex |
13859 | ||
d420ca49 | 13860 | =over 4 |
497711e7 GS |
13861 | |
13862 | =item SYNOPSIS | |
13863 | ||
13864 | =item DESCRIPTION | |
13865 | ||
13866 | =back | |
13867 | ||
d420ca49 | 13868 | =over 4 |
497711e7 GS |
13869 | |
13870 | =item OBJECT METHODS | |
13871 | ||
13872 | C<initialize> | |
13873 | ||
13874 | =back | |
13875 | ||
d420ca49 | 13876 | =over 4 |
497711e7 GS |
13877 | |
13878 | =item Data Accessors | |
13879 | ||
13880 | B<AddPreamble> | |
13881 | ||
13882 | =back | |
13883 | ||
13884 | B<AddPostamble> | |
13885 | ||
13886 | B<Head1Level> | |
13887 | ||
13888 | B<Label> | |
13889 | ||
13890 | B<LevelNoNum> | |
13891 | ||
13892 | B<MakeIndex> | |
13893 | ||
13894 | B<ReplaceNAMEwithSection> | |
13895 | ||
13896 | B<StartWithNewPage> | |
13897 | ||
13898 | B<TableOfContents> | |
13899 | ||
13900 | B<UniqueLabels> | |
13901 | ||
13902 | B<UserPreamble> | |
13903 | ||
13904 | B<UserPostamble> | |
13905 | ||
13906 | B<Lists> | |
13907 | ||
d420ca49 | 13908 | =over 4 |
497711e7 GS |
13909 | |
13910 | =item Subclassed methods | |
13911 | ||
13912 | =back | |
13913 | ||
13914 | B<begin_pod> | |
13915 | ||
13916 | B<end_pod> | |
13917 | ||
13918 | B<command> | |
13919 | ||
13920 | B<verbatim> | |
13921 | ||
13922 | B<textblock> | |
13923 | ||
13924 | B<interior_sequence> | |
13925 | ||
d420ca49 | 13926 | =over 4 |
497711e7 GS |
13927 | |
13928 | =item List Methods | |
13929 | ||
13930 | B<begin_list> | |
13931 | ||
13932 | =back | |
13933 | ||
13934 | B<end_list> | |
13935 | ||
13936 | B<add_item> | |
13937 | ||
d420ca49 | 13938 | =over 4 |
497711e7 GS |
13939 | |
13940 | =item Methods for headings | |
13941 | ||
13942 | B<head> | |
13943 | ||
13944 | =back | |
13945 | ||
d420ca49 | 13946 | =over 4 |
497711e7 GS |
13947 | |
13948 | =item Internal methods | |
13949 | ||
13950 | B<_output> | |
13951 | ||
13952 | =back | |
13953 | ||
13954 | B<_replace_special_chars> | |
13955 | ||
13956 | B<_create_label> | |
13957 | ||
13958 | B<_create_index> | |
13959 | ||
13960 | B<_clean_latex_commands> | |
13961 | ||
d420ca49 | 13962 | =over 4 |
497711e7 GS |
13963 | |
13964 | =item NOTES | |
13965 | ||
13966 | =item SEE ALSO | |
13967 | ||
13968 | =item AUTHORS | |
13969 | ||
13970 | =item COPYRIGHT | |
13971 | ||
13972 | =item REVISION | |
13973 | ||
13974 | =back | |
13975 | ||
c76ac1ee GS |
13976 | =head2 Pod::Man - Convert POD data to formatted *roff input |
13977 | ||
d420ca49 | 13978 | =over 4 |
a45bd81d | 13979 | |
c76ac1ee GS |
13980 | =item SYNOPSIS |
13981 | ||
13982 | =item DESCRIPTION | |
13983 | ||
91331b4f JH |
13984 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes, |
13985 | release, section | |
c76ac1ee GS |
13986 | |
13987 | =item DIAGNOSTICS | |
13988 | ||
91331b4f JH |
13989 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote |
13990 | specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape | |
9fa7f388 JH |
13991 | EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on |
13992 | line %d, Unmatched =back | |
c76ac1ee GS |
13993 | |
13994 | =item BUGS | |
13995 | ||
c76ac1ee GS |
13996 | =item SEE ALSO |
13997 | ||
13998 | =item AUTHOR | |
13999 | ||
a45bd81d GS |
14000 | =back |
14001 | ||
694468e3 GS |
14002 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion |
14003 | ||
d420ca49 | 14004 | =over 4 |
694468e3 GS |
14005 | |
14006 | =item SYNOPSIS | |
14007 | ||
14008 | =item DESCRIPTION | |
14009 | ||
14010 | =back | |
14011 | ||
d420ca49 | 14012 | =over 4 |
694468e3 GS |
14013 | |
14014 | =item Pod::List | |
14015 | ||
10862624 | 14016 | Pod::List-E<gt>new() |
694468e3 GS |
14017 | |
14018 | =back | |
14019 | ||
10862624 | 14020 | $list-E<gt>file() |
694468e3 | 14021 | |
10862624 | 14022 | $list-E<gt>start() |
694468e3 | 14023 | |
10862624 | 14024 | $list-E<gt>indent() |
694468e3 | 14025 | |
10862624 | 14026 | $list-E<gt>type() |
694468e3 | 14027 | |
10862624 | 14028 | $list-E<gt>rx() |
694468e3 | 14029 | |
10862624 | 14030 | $list-E<gt>item() |
694468e3 | 14031 | |
10862624 | 14032 | $list-E<gt>parent() |
694468e3 | 14033 | |
10862624 | 14034 | $list-E<gt>tag() |
694468e3 | 14035 | |
d420ca49 | 14036 | =over 4 |
694468e3 GS |
14037 | |
14038 | =item Pod::Hyperlink | |
14039 | ||
10862624 | 14040 | Pod::Hyperlink-E<gt>new() |
694468e3 GS |
14041 | |
14042 | =back | |
14043 | ||
10862624 | 14044 | $link-E<gt>parse($string) |
694468e3 | 14045 | |
10862624 | 14046 | $link-E<gt>markup($string) |
694468e3 | 14047 | |
10862624 | 14048 | $link-E<gt>text() |
694468e3 | 14049 | |
10862624 | 14050 | $link-E<gt>warning() |
694468e3 | 14051 | |
10862624 | 14052 | $link-E<gt>file(), $link-E<gt>line() |
694468e3 | 14053 | |
10862624 | 14054 | $link-E<gt>page() |
694468e3 | 14055 | |
10862624 | 14056 | $link-E<gt>node() |
694468e3 | 14057 | |
10862624 | 14058 | $link-E<gt>alttext() |
694468e3 | 14059 | |
10862624 | 14060 | $link-E<gt>type() |
694468e3 | 14061 | |
10862624 | 14062 | $link-E<gt>link() |
694468e3 | 14063 | |
d420ca49 | 14064 | =over 4 |
694468e3 GS |
14065 | |
14066 | =item Pod::Cache | |
14067 | ||
10862624 | 14068 | Pod::Cache-E<gt>new() |
694468e3 GS |
14069 | |
14070 | =back | |
14071 | ||
10862624 | 14072 | $cache-E<gt>item() |
694468e3 | 14073 | |
10862624 | 14074 | $cache-E<gt>find_page($name) |
694468e3 | 14075 | |
d420ca49 | 14076 | =over 4 |
694468e3 GS |
14077 | |
14078 | =item Pod::Cache::Item | |
14079 | ||
10862624 | 14080 | Pod::Cache::Item-E<gt>new() |
694468e3 GS |
14081 | |
14082 | =back | |
14083 | ||
10862624 | 14084 | $cacheitem-E<gt>page() |
694468e3 | 14085 | |
10862624 | 14086 | $cacheitem-E<gt>description() |
694468e3 | 14087 | |
10862624 | 14088 | $cacheitem-E<gt>path() |
694468e3 | 14089 | |
10862624 | 14090 | $cacheitem-E<gt>file() |
694468e3 | 14091 | |
10862624 | 14092 | $cacheitem-E<gt>nodes() |
694468e3 | 14093 | |
10862624 | 14094 | $cacheitem-E<gt>find_node($name) |
694468e3 | 14095 | |
10862624 | 14096 | $cacheitem-E<gt>idx() |
694468e3 | 14097 | |
d420ca49 | 14098 | =over 4 |
694468e3 GS |
14099 | |
14100 | =item AUTHOR | |
14101 | ||
14102 | =item SEE ALSO | |
14103 | ||
14104 | =back | |
14105 | ||
14218588 GS |
14106 | =head2 Pod::Parser - base class for creating POD filters and translators |
14107 | ||
d420ca49 | 14108 | =over 4 |
a45bd81d | 14109 | |
14218588 GS |
14110 | =item SYNOPSIS |
14111 | ||
14112 | =item REQUIRES | |
14113 | ||
14114 | =item EXPORTS | |
14115 | ||
14116 | =item DESCRIPTION | |
14117 | ||
14118 | =item QUICK OVERVIEW | |
14119 | ||
c76ac1ee GS |
14120 | =item PARSING OPTIONS |
14121 | ||
b38f6a39 GS |
14122 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), |
14123 | B<-warnings> (default: unset) | |
c76ac1ee | 14124 | |
a45bd81d GS |
14125 | =back |
14126 | ||
d420ca49 | 14127 | =over 4 |
a45bd81d | 14128 | |
14218588 GS |
14129 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES |
14130 | ||
a45bd81d GS |
14131 | =back |
14132 | ||
d420ca49 | 14133 | =over 4 |
a45bd81d | 14134 | |
14218588 GS |
14135 | =item B<command()> |
14136 | ||
14137 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
14138 | ||
a45bd81d GS |
14139 | =back |
14140 | ||
d420ca49 | 14141 | =over 4 |
a45bd81d | 14142 | |
14218588 GS |
14143 | =item B<verbatim()> |
14144 | ||
14145 | C<$text>, C<$line_num>, C<$pod_para> | |
14146 | ||
a45bd81d GS |
14147 | =back |
14148 | ||
d420ca49 | 14149 | =over 4 |
a45bd81d | 14150 | |
14218588 GS |
14151 | =item B<textblock()> |
14152 | ||
14153 | C<$text>, C<$line_num>, C<$pod_para> | |
14154 | ||
a45bd81d GS |
14155 | =back |
14156 | ||
d420ca49 | 14157 | =over 4 |
a45bd81d | 14158 | |
14218588 GS |
14159 | =item B<interior_sequence()> |
14160 | ||
a45bd81d GS |
14161 | =back |
14162 | ||
d420ca49 | 14163 | =over 4 |
a45bd81d | 14164 | |
14218588 GS |
14165 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES |
14166 | ||
a45bd81d GS |
14167 | =back |
14168 | ||
d420ca49 | 14169 | =over 4 |
a45bd81d | 14170 | |
14218588 GS |
14171 | =item B<new()> |
14172 | ||
a45bd81d GS |
14173 | =back |
14174 | ||
d420ca49 | 14175 | =over 4 |
a45bd81d | 14176 | |
14218588 GS |
14177 | =item B<initialize()> |
14178 | ||
a45bd81d GS |
14179 | =back |
14180 | ||
d420ca49 | 14181 | =over 4 |
a45bd81d | 14182 | |
14218588 GS |
14183 | =item B<begin_pod()> |
14184 | ||
a45bd81d GS |
14185 | =back |
14186 | ||
d420ca49 | 14187 | =over 4 |
a45bd81d | 14188 | |
14218588 GS |
14189 | =item B<begin_input()> |
14190 | ||
a45bd81d GS |
14191 | =back |
14192 | ||
d420ca49 | 14193 | =over 4 |
a45bd81d | 14194 | |
14218588 GS |
14195 | =item B<end_input()> |
14196 | ||
a45bd81d GS |
14197 | =back |
14198 | ||
d420ca49 | 14199 | =over 4 |
a45bd81d | 14200 | |
14218588 GS |
14201 | =item B<end_pod()> |
14202 | ||
a45bd81d GS |
14203 | =back |
14204 | ||
d420ca49 | 14205 | =over 4 |
a45bd81d | 14206 | |
14218588 GS |
14207 | =item B<preprocess_line()> |
14208 | ||
a45bd81d GS |
14209 | =back |
14210 | ||
d420ca49 | 14211 | =over 4 |
a45bd81d | 14212 | |
14218588 GS |
14213 | =item B<preprocess_paragraph()> |
14214 | ||
a45bd81d GS |
14215 | =back |
14216 | ||
d420ca49 | 14217 | =over 4 |
a45bd81d | 14218 | |
14218588 GS |
14219 | =item METHODS FOR PARSING AND PROCESSING |
14220 | ||
a45bd81d GS |
14221 | =back |
14222 | ||
d420ca49 | 14223 | =over 4 |
a45bd81d | 14224 | |
14218588 GS |
14225 | =item B<parse_text()> |
14226 | ||
c76ac1ee GS |
14227 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> |
14228 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
14218588 GS |
14229 | I<code-ref>|I<method-name> |
14230 | ||
a45bd81d GS |
14231 | =back |
14232 | ||
d420ca49 | 14233 | =over 4 |
a45bd81d | 14234 | |
14218588 GS |
14235 | =item B<interpolate()> |
14236 | ||
a45bd81d GS |
14237 | =back |
14238 | ||
d420ca49 | 14239 | =over 4 |
a45bd81d | 14240 | |
14218588 GS |
14241 | =item B<parse_paragraph()> |
14242 | ||
a45bd81d GS |
14243 | =back |
14244 | ||
d420ca49 | 14245 | =over 4 |
a45bd81d | 14246 | |
14218588 GS |
14247 | =item B<parse_from_filehandle()> |
14248 | ||
a45bd81d GS |
14249 | =back |
14250 | ||
d420ca49 | 14251 | =over 4 |
a45bd81d | 14252 | |
14218588 GS |
14253 | =item B<parse_from_file()> |
14254 | ||
a45bd81d GS |
14255 | =back |
14256 | ||
d420ca49 | 14257 | =over 4 |
a45bd81d | 14258 | |
14218588 GS |
14259 | =item ACCESSOR METHODS |
14260 | ||
a45bd81d GS |
14261 | =back |
14262 | ||
d420ca49 | 14263 | =over 4 |
a45bd81d | 14264 | |
c76ac1ee GS |
14265 | =item B<errorsub()> |
14266 | ||
a45bd81d GS |
14267 | =back |
14268 | ||
d420ca49 | 14269 | =over 4 |
a45bd81d | 14270 | |
14218588 GS |
14271 | =item B<cutting()> |
14272 | ||
a45bd81d GS |
14273 | =back |
14274 | ||
d420ca49 | 14275 | =over 4 |
a45bd81d | 14276 | |
c76ac1ee GS |
14277 | =item B<parseopts()> |
14278 | ||
a45bd81d GS |
14279 | =back |
14280 | ||
d420ca49 | 14281 | =over 4 |
a45bd81d | 14282 | |
14218588 GS |
14283 | =item B<output_file()> |
14284 | ||
a45bd81d GS |
14285 | =back |
14286 | ||
d420ca49 | 14287 | =over 4 |
a45bd81d | 14288 | |
14218588 GS |
14289 | =item B<output_handle()> |
14290 | ||
a45bd81d GS |
14291 | =back |
14292 | ||
d420ca49 | 14293 | =over 4 |
a45bd81d | 14294 | |
14218588 GS |
14295 | =item B<input_file()> |
14296 | ||
a45bd81d GS |
14297 | =back |
14298 | ||
d420ca49 | 14299 | =over 4 |
a45bd81d | 14300 | |
14218588 GS |
14301 | =item B<input_handle()> |
14302 | ||
a45bd81d GS |
14303 | =back |
14304 | ||
d420ca49 | 14305 | =over 4 |
a45bd81d | 14306 | |
14218588 GS |
14307 | =item B<input_streams()> |
14308 | ||
a45bd81d GS |
14309 | =back |
14310 | ||
d420ca49 | 14311 | =over 4 |
a45bd81d GS |
14312 | |
14313 | =item B<top_stream()> | |
14314 | ||
14315 | =back | |
14316 | ||
d420ca49 | 14317 | =over 4 |
14218588 GS |
14318 | |
14319 | =item PRIVATE METHODS AND DATA | |
14320 | ||
a45bd81d GS |
14321 | =back |
14322 | ||
d420ca49 | 14323 | =over 4 |
a45bd81d | 14324 | |
14218588 GS |
14325 | =item B<_push_input_stream()> |
14326 | ||
a45bd81d GS |
14327 | =back |
14328 | ||
d420ca49 | 14329 | =over 4 |
a45bd81d | 14330 | |
14218588 GS |
14331 | =item B<_pop_input_stream()> |
14332 | ||
a45bd81d GS |
14333 | =back |
14334 | ||
d420ca49 | 14335 | =over 4 |
a45bd81d | 14336 | |
c76ac1ee | 14337 | =item TREE-BASED PARSING |
14218588 GS |
14338 | |
14339 | =item SEE ALSO | |
14340 | ||
14341 | =item AUTHOR | |
14342 | ||
a45bd81d GS |
14343 | =back |
14344 | ||
b38f6a39 GS |
14345 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. |
14346 | ||
d420ca49 | 14347 | =over 4 |
b38f6a39 GS |
14348 | |
14349 | =item SYNOPSIS | |
14350 | ||
14351 | =item DESCRIPTION | |
14352 | ||
d420ca49 | 14353 | =over 4 |
b38f6a39 GS |
14354 | |
14355 | =item EXPORT | |
14356 | ||
14357 | =back | |
14358 | ||
14359 | =item AUTHOR | |
14360 | ||
14361 | =item SEE ALSO | |
14362 | ||
14363 | =back | |
14364 | ||
14218588 GS |
14365 | =head2 Pod::Select, podselect() - extract selected sections of POD from |
14366 | input | |
14367 | ||
d420ca49 | 14368 | =over 4 |
a45bd81d | 14369 | |
14218588 GS |
14370 | =item SYNOPSIS |
14371 | ||
14372 | =item REQUIRES | |
14373 | ||
14374 | =item EXPORTS | |
14375 | ||
14376 | =item DESCRIPTION | |
14377 | ||
14378 | =item SECTION SPECIFICATIONS | |
14379 | ||
14380 | =item RANGE SPECIFICATIONS | |
14381 | ||
a45bd81d GS |
14382 | =back |
14383 | ||
d420ca49 | 14384 | =over 4 |
a45bd81d | 14385 | |
14218588 GS |
14386 | =item OBJECT METHODS |
14387 | ||
a45bd81d GS |
14388 | =back |
14389 | ||
d420ca49 | 14390 | =over 4 |
a45bd81d | 14391 | |
14218588 GS |
14392 | =item B<curr_headings()> |
14393 | ||
a45bd81d GS |
14394 | =back |
14395 | ||
d420ca49 | 14396 | =over 4 |
a45bd81d | 14397 | |
14218588 GS |
14398 | =item B<select()> |
14399 | ||
a45bd81d GS |
14400 | =back |
14401 | ||
d420ca49 | 14402 | =over 4 |
a45bd81d | 14403 | |
14218588 GS |
14404 | =item B<add_selection()> |
14405 | ||
a45bd81d GS |
14406 | =back |
14407 | ||
d420ca49 | 14408 | =over 4 |
a45bd81d | 14409 | |
14218588 GS |
14410 | =item B<clear_selections()> |
14411 | ||
a45bd81d GS |
14412 | =back |
14413 | ||
d420ca49 | 14414 | =over 4 |
a45bd81d | 14415 | |
14218588 GS |
14416 | =item B<match_section()> |
14417 | ||
a45bd81d GS |
14418 | =back |
14419 | ||
d420ca49 | 14420 | =over 4 |
a45bd81d | 14421 | |
14218588 GS |
14422 | =item B<is_selected()> |
14423 | ||
a45bd81d GS |
14424 | =back |
14425 | ||
d420ca49 | 14426 | =over 4 |
a45bd81d | 14427 | |
14218588 GS |
14428 | =item EXPORTED FUNCTIONS |
14429 | ||
a45bd81d GS |
14430 | =back |
14431 | ||
d420ca49 | 14432 | =over 4 |
a45bd81d | 14433 | |
14218588 GS |
14434 | =item B<podselect()> |
14435 | ||
14436 | B<-output>, B<-sections>, B<-ranges> | |
14437 | ||
a45bd81d GS |
14438 | =back |
14439 | ||
d420ca49 | 14440 | =over 4 |
a45bd81d | 14441 | |
14218588 GS |
14442 | =item PRIVATE METHODS AND DATA |
14443 | ||
a45bd81d GS |
14444 | =back |
14445 | ||
d420ca49 | 14446 | =over 4 |
a45bd81d | 14447 | |
14218588 GS |
14448 | =item B<_compile_section_spec()> |
14449 | ||
a45bd81d GS |
14450 | =back |
14451 | ||
d420ca49 | 14452 | =over 4 |
14218588 GS |
14453 | |
14454 | =item $self->{_SECTION_HEADINGS} | |
14455 | ||
a45bd81d GS |
14456 | =back |
14457 | ||
d420ca49 | 14458 | =over 4 |
a45bd81d | 14459 | |
14218588 GS |
14460 | =item $self->{_SELECTED_SECTIONS} |
14461 | ||
14462 | =back | |
14463 | ||
d420ca49 | 14464 | =over 4 |
a45bd81d | 14465 | |
14218588 GS |
14466 | =item SEE ALSO |
14467 | ||
14468 | =item AUTHOR | |
14469 | ||
a45bd81d GS |
14470 | =back |
14471 | ||
c76ac1ee | 14472 | =head2 Pod::Text - Convert POD data to formatted ASCII text |
402d0d99 | 14473 | |
d420ca49 | 14474 | =over 4 |
a45bd81d | 14475 | |
402d0d99 | 14476 | =item SYNOPSIS |
14477 | ||
402d0d99 | 14478 | =item DESCRIPTION |
14479 | ||
91331b4f | 14480 | alt, indent, loose, quotes, sentence, width |
c76ac1ee GS |
14481 | |
14482 | =item DIAGNOSTICS | |
14483 | ||
91331b4f JH |
14484 | Bizarre space in item, Can't open %s for reading: %s, Invalid quote |
14485 | specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: | |
14486 | %s, Unknown sequence: %s, Unmatched =back | |
c76ac1ee GS |
14487 | |
14488 | =item RESTRICTIONS | |
14489 | ||
14490 | =item NOTES | |
14491 | ||
14492 | =item SEE ALSO | |
14493 | ||
402d0d99 | 14494 | =item AUTHOR |
14495 | ||
a45bd81d GS |
14496 | =back |
14497 | ||
c76ac1ee GS |
14498 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text |
14499 | ||
d420ca49 | 14500 | =over 4 |
a45bd81d | 14501 | |
c76ac1ee GS |
14502 | =item SYNOPSIS |
14503 | ||
14504 | =item DESCRIPTION | |
14505 | ||
14506 | =item BUGS | |
14507 | ||
14508 | =item SEE ALSO | |
14509 | ||
14510 | =item AUTHOR | |
14511 | ||
a45bd81d GS |
14512 | =back |
14513 | ||
ab648d5e JH |
14514 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike |
14515 | text | |
14516 | ||
14517 | =over 4 | |
14518 | ||
14519 | =item SYNOPSIS | |
14520 | ||
14521 | =item DESCRIPTION | |
14522 | ||
14523 | =item BUGS | |
14524 | ||
14525 | =item SEE ALSO | |
14526 | ||
14527 | =item AUTHOR | |
14528 | ||
14529 | =back | |
14530 | ||
c76ac1ee GS |
14531 | =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII |
14532 | text with format escapes | |
14533 | ||
d420ca49 | 14534 | =over 4 |
a45bd81d | 14535 | |
c76ac1ee GS |
14536 | =item SYNOPSIS |
14537 | ||
14538 | =item DESCRIPTION | |
14539 | ||
14540 | =item SEE ALSO | |
14541 | ||
14542 | =item AUTHOR | |
402d0d99 | 14543 | |
a45bd81d GS |
14544 | =back |
14545 | ||
14218588 GS |
14546 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
14547 | documentation | |
14548 | ||
d420ca49 | 14549 | =over 4 |
a45bd81d | 14550 | |
14218588 GS |
14551 | =item SYNOPSIS |
14552 | ||
14553 | =item ARGUMENTS | |
14554 | ||
14555 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
14556 | C<-pathlist> | |
14557 | ||
14558 | =item DESCRIPTION | |
14559 | ||
14560 | =item EXAMPLES | |
14561 | ||
d420ca49 | 14562 | =over 4 |
14218588 GS |
14563 | |
14564 | =item Recommended Use | |
14565 | ||
14566 | =back | |
14567 | ||
14568 | =item CAVEATS | |
14569 | ||
14570 | =item AUTHOR | |
14571 | ||
14572 | =item ACKNOWLEDGEMENTS | |
14573 | ||
a45bd81d GS |
14574 | =back |
14575 | ||
8ebc5c01 | 14576 | =head2 SDBM_File - Tied access to sdbm files |
402d0d99 | 14577 | |
d420ca49 | 14578 | =over 4 |
a45bd81d | 14579 | |
8ebc5c01 | 14580 | =item SYNOPSIS |
402d0d99 | 14581 | |
8ebc5c01 | 14582 | =item DESCRIPTION |
402d0d99 | 14583 | |
7029d033 JH |
14584 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
14585 | ||
14586 | =item DIAGNOSTICS | |
14587 | ||
d420ca49 | 14588 | =over 4 |
7029d033 JH |
14589 | |
14590 | =item C<sdbm store returned -1, errno 22, key "..." at ...> | |
14591 | ||
14592 | =back | |
14593 | ||
14594 | =item BUGS AND WARNINGS | |
14595 | ||
a45bd81d GS |
14596 | =back |
14597 | ||
d46b76b3 JH |
14598 | =head2 Safe - Compile and execute code in restricted compartments |
14599 | ||
d420ca49 | 14600 | =over 4 |
d46b76b3 JH |
14601 | |
14602 | =item SYNOPSIS | |
14603 | ||
14604 | =item DESCRIPTION | |
14605 | ||
14606 | a new namespace, an operator mask | |
14607 | ||
14608 | =item WARNING | |
14609 | ||
d420ca49 | 14610 | =over 4 |
d46b76b3 JH |
14611 | |
14612 | =item RECENT CHANGES | |
14613 | ||
14614 | =item Methods in class Safe | |
14615 | ||
14616 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
14617 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
14618 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
14619 | root (NAMESPACE), mask (MASK) | |
14620 | ||
14621 | =item Some Safety Issues | |
14622 | ||
14623 | Memory, CPU, Snooping, Signals, State Changes | |
14624 | ||
14625 | =item AUTHOR | |
14626 | ||
14627 | =back | |
14628 | ||
14629 | =back | |
14630 | ||
41ca3a40 JH |
14631 | =head2 Scalar::Util - A selection of general-utility scalar subroutines |
14632 | ||
14633 | =over 4 | |
14634 | ||
14635 | =item SYNOPSIS | |
14636 | ||
14637 | =item DESCRIPTION | |
14638 | ||
1fa7ca25 JH |
14639 | blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype |
14640 | EXPR, tainted EXPR, weaken REF | |
41ca3a40 JH |
14641 | |
14642 | =item COPYRIGHT | |
14643 | ||
14644 | =item BLATANT PLUG | |
14645 | ||
14646 | =back | |
14647 | ||
7d2bfb28 | 14648 | =head2 Search::Dict, look - search for key in dictionary file |
14649 | ||
d420ca49 | 14650 | =over 4 |
a45bd81d | 14651 | |
7d2bfb28 | 14652 | =item SYNOPSIS |
14653 | ||
7d2bfb28 | 14654 | =item DESCRIPTION |
14655 | ||
a45bd81d GS |
14656 | =back |
14657 | ||
7d2bfb28 | 14658 | =head2 SelectSaver - save and restore selected file handle |
14659 | ||
d420ca49 | 14660 | =over 4 |
a45bd81d | 14661 | |
7d2bfb28 | 14662 | =item SYNOPSIS |
14663 | ||
7d2bfb28 | 14664 | =item DESCRIPTION |
14665 | ||
a45bd81d GS |
14666 | =back |
14667 | ||
cb1a09d0 AD |
14668 | =head2 SelfLoader - load functions only on demand |
14669 | ||
d420ca49 | 14670 | =over 4 |
a45bd81d | 14671 | |
cb1a09d0 AD |
14672 | =item SYNOPSIS |
14673 | ||
cb1a09d0 AD |
14674 | =item DESCRIPTION |
14675 | ||
d420ca49 | 14676 | =over 4 |
cb1a09d0 AD |
14677 | |
14678 | =item The __DATA__ token | |
14679 | ||
cb1a09d0 AD |
14680 | =item SelfLoader autoloading |
14681 | ||
cb1a09d0 AD |
14682 | =item Autoloading and package lexicals |
14683 | ||
cb1a09d0 AD |
14684 | =item SelfLoader and AutoLoader |
14685 | ||
cb1a09d0 AD |
14686 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
14687 | ||
cb1a09d0 AD |
14688 | =item Classes and inherited methods. |
14689 | ||
cb1a09d0 AD |
14690 | =back |
14691 | ||
14692 | =item Multiple packages and fully qualified subroutine names | |
14693 | ||
a45bd81d GS |
14694 | =back |
14695 | ||
8ebc5c01 | 14696 | =head2 Shell - run shell commands transparently within perl |
cb1a09d0 | 14697 | |
d420ca49 | 14698 | =over 4 |
a45bd81d | 14699 | |
cb1a09d0 AD |
14700 | =item SYNOPSIS |
14701 | ||
cb1a09d0 AD |
14702 | =item DESCRIPTION |
14703 | ||
d420ca49 | 14704 | =over 4 |
d396a558 JH |
14705 | |
14706 | =item OBJECT ORIENTED SYNTAX | |
14707 | ||
14708 | =back | |
14709 | ||
8ebc5c01 | 14710 | =item AUTHOR |
cb1a09d0 | 14711 | |
a45bd81d GS |
14712 | =back |
14713 | ||
8ebc5c01 | 14714 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
14715 | socket.h defines and structure manipulators | |
cb1a09d0 | 14716 | |
d420ca49 | 14717 | =over 4 |
a45bd81d | 14718 | |
8ebc5c01 | 14719 | =item SYNOPSIS |
cb1a09d0 | 14720 | |
8ebc5c01 | 14721 | =item DESCRIPTION |
cb1a09d0 | 14722 | |
8ebc5c01 | 14723 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
14724 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in | |
14725 | SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in | |
14726 | SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN, | |
14727 | pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
cb1a09d0 | 14728 | |
a45bd81d GS |
14729 | =back |
14730 | ||
a9ef4385 JH |
14731 | =head2 Storable - persistency for perl data structures |
14732 | ||
d420ca49 | 14733 | =over 4 |
a9ef4385 JH |
14734 | |
14735 | =item SYNOPSIS | |
14736 | ||
14737 | =item DESCRIPTION | |
14738 | ||
14739 | =item MEMORY STORE | |
14740 | ||
91331b4f JH |
14741 | =item ADVISORY LOCKING |
14742 | ||
a9ef4385 JH |
14743 | =item SPEED |
14744 | ||
14745 | =item CANONICAL REPRESENTATION | |
14746 | ||
14747 | =item ERROR REPORTING | |
14748 | ||
14749 | =item WIZARDS ONLY | |
14750 | ||
d420ca49 | 14751 | =over 4 |
a9ef4385 JH |
14752 | |
14753 | =item Hooks | |
14754 | ||
14755 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
14756 | I<serialized>, .. | |
14757 | ||
14758 | =item Predicates | |
14759 | ||
14760 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
14761 | C<Storable::is_retrieving> | |
14762 | ||
14763 | =item Recursion | |
14764 | ||
14765 | =item Deep Cloning | |
14766 | ||
14767 | =back | |
14768 | ||
14769 | =item EXAMPLES | |
14770 | ||
14771 | =item WARNING | |
14772 | ||
14773 | =item BUGS | |
14774 | ||
14775 | =item CREDITS | |
14776 | ||
14777 | =item TRANSLATIONS | |
14778 | ||
14779 | =item AUTHOR | |
14780 | ||
14781 | =item SEE ALSO | |
14782 | ||
14783 | =back | |
14784 | ||
4d4e713d JH |
14785 | =head2 Switch - A switch statement for Perl |
14786 | ||
14787 | =over 4 | |
14788 | ||
14789 | =item VERSION | |
14790 | ||
14791 | =item SYNOPSIS | |
14792 | ||
14793 | =item BACKGROUND | |
14794 | ||
14795 | =item DESCRIPTION | |
14796 | ||
14797 | =over 4 | |
14798 | ||
14799 | =item Allowing fall-through | |
14800 | ||
14801 | =item Automating fall-through | |
14802 | ||
14803 | =item Higher-order Operations | |
14804 | ||
14805 | =back | |
14806 | ||
14807 | =item DEPENDENCIES | |
14808 | ||
14809 | =item AUTHOR | |
14810 | ||
14811 | =item BUGS | |
14812 | ||
14813 | =item COPYRIGHT | |
14814 | ||
14815 | =back | |
14816 | ||
7d2bfb28 | 14817 | =head2 Symbol - manipulate Perl symbols and their names |
14818 | ||
d420ca49 | 14819 | =over 4 |
a45bd81d | 14820 | |
7d2bfb28 | 14821 | =item SYNOPSIS |
14822 | ||
7d2bfb28 | 14823 | =item DESCRIPTION |
14824 | ||
a45bd81d GS |
14825 | =back |
14826 | ||
cb1a09d0 AD |
14827 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
14828 | ||
d420ca49 | 14829 | =over 4 |
a45bd81d | 14830 | |
cb1a09d0 AD |
14831 | =item SYNOPSIS |
14832 | ||
cb1a09d0 AD |
14833 | =item DESCRIPTION |
14834 | ||
cb1a09d0 AD |
14835 | =item AUTHOR |
14836 | ||
a45bd81d GS |
14837 | =back |
14838 | ||
9038e305 JH |
14839 | =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl |
14840 | interface to the UNIX syslog(3) calls | |
14841 | ||
14842 | =over 4 | |
14843 | ||
14844 | =item SYNOPSIS | |
14845 | ||
14846 | =item DESCRIPTION | |
14847 | ||
14848 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
14849 | setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), | |
14850 | closelog | |
14851 | ||
14852 | =item EXAMPLES | |
14853 | ||
14854 | =item SEE ALSO | |
14855 | ||
14856 | =item AUTHOR | |
14857 | ||
14858 | =back | |
14859 | ||
694468e3 GS |
14860 | =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - |
14861 | Perl interface to the UNIX syslog(3) calls | |
14862 | ||
d420ca49 | 14863 | =over 4 |
694468e3 GS |
14864 | |
14865 | =item SYNOPSIS | |
14866 | ||
14867 | =item DESCRIPTION | |
14868 | ||
14869 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
14870 | setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), | |
14871 | closelog | |
14872 | ||
14873 | =item EXAMPLES | |
7d2bfb28 | 14874 | |
7d2bfb28 | 14875 | =item SEE ALSO |
14876 | ||
7d2bfb28 | 14877 | =item AUTHOR |
14878 | ||
a45bd81d GS |
14879 | =back |
14880 | ||
b38f6a39 GS |
14881 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences |
14882 | ||
d420ca49 | 14883 | =over 4 |
b38f6a39 GS |
14884 | |
14885 | =item SYNOPSIS | |
14886 | ||
14887 | =item DESCRIPTION | |
14888 | ||
14889 | =item DIAGNOSTICS | |
14890 | ||
10862624 RF |
14891 | Invalid attribute name %s, Name "%s" used only once: possible typo, No |
14892 | comma allowed after filehandle, Bareword "%s" not allowed while "strict | |
14893 | subs" in use | |
b38f6a39 GS |
14894 | |
14895 | =item RESTRICTIONS | |
14896 | ||
10862624 RF |
14897 | =item NOTES |
14898 | ||
b38f6a39 GS |
14899 | =item AUTHORS |
14900 | ||
14901 | =back | |
14902 | ||
cb1a09d0 AD |
14903 | =head2 Term::Cap - Perl termcap interface |
14904 | ||
d420ca49 | 14905 | =over 4 |
a45bd81d | 14906 | |
cb1a09d0 AD |
14907 | =item SYNOPSIS |
14908 | ||
cb1a09d0 AD |
14909 | =item DESCRIPTION |
14910 | ||
cb1a09d0 AD |
14911 | =item EXAMPLES |
14912 | ||
a45bd81d GS |
14913 | =back |
14914 | ||
cb1a09d0 AD |
14915 | =head2 Term::Complete - Perl word completion module |
14916 | ||
d420ca49 | 14917 | =over 4 |
a45bd81d | 14918 | |
cb1a09d0 AD |
14919 | =item SYNOPSIS |
14920 | ||
cb1a09d0 AD |
14921 | =item DESCRIPTION |
14922 | ||
3fe9a6f1 | 14923 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
cb1a09d0 AD |
14924 | |
14925 | =item DIAGNOSTICS | |
14926 | ||
cb1a09d0 AD |
14927 | =item BUGS |
14928 | ||
cb1a09d0 AD |
14929 | =item AUTHOR |
14930 | ||
a45bd81d GS |
14931 | =back |
14932 | ||
8ebc5c01 | 14933 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. If |
14934 | no real package is found, substitutes stubs instead of basic functions. | |
7d2bfb28 | 14935 | |
d420ca49 | 14936 | =over 4 |
a45bd81d | 14937 | |
7d2bfb28 | 14938 | =item SYNOPSIS |
14939 | ||
7d2bfb28 | 14940 | =item DESCRIPTION |
14941 | ||
7d2bfb28 | 14942 | =item Minimal set of supported functions |
14943 | ||
7d2bfb28 | 14944 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>, |
9607fc9c | 14945 | C<MinLine>, C<findConsole>, Attribs, C<Features> |
14946 | ||
14947 | =item Additional supported functions | |
7d2bfb28 | 14948 | |
d516a115 JH |
14949 | C<tkRunning>, C<ornaments>, C<newTTY> |
14950 | ||
7d2bfb28 | 14951 | =item EXPORTS |
14952 | ||
9607fc9c | 14953 | =item ENVIRONMENT |
14954 | ||
ab1e085c JH |
14955 | =item CAVEATS |
14956 | ||
a45bd81d GS |
14957 | =back |
14958 | ||
4d4e713d | 14959 | =head2 Test - provides a simple framework for writing test scripts |
193fb0af | 14960 | |
d420ca49 | 14961 | =over 4 |
a45bd81d | 14962 | |
193fb0af GS |
14963 | =item SYNOPSIS |
14964 | ||
14965 | =item DESCRIPTION | |
14966 | ||
640374d0 JH |
14967 | =over 4 |
14968 | ||
14969 | =item Functions | |
14970 | ||
14971 | B<plan> | |
14972 | ||
14973 | =back | |
14974 | ||
14975 | =back | |
14976 | ||
14977 | B<_to_value> | |
14978 | ||
14979 | B<ok> | |
14980 | ||
14981 | =over 4 | |
14982 | ||
193fb0af GS |
14983 | =item TEST TYPES |
14984 | ||
14985 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
14986 | ||
14987 | =item ONFAIL | |
14988 | ||
640374d0 JH |
14989 | =item BUGS and CAVEATS |
14990 | ||
14991 | =item TODO | |
14992 | ||
193fb0af GS |
14993 | =item SEE ALSO |
14994 | ||
14995 | =item AUTHOR | |
14996 | ||
a45bd81d GS |
14997 | =back |
14998 | ||
cb1a09d0 AD |
14999 | =head2 Test::Harness - run perl standard test scripts with statistics |
15000 | ||
d420ca49 | 15001 | =over 4 |
a45bd81d | 15002 | |
cb1a09d0 AD |
15003 | =item SYNOPSIS |
15004 | ||
cb1a09d0 AD |
15005 | =item DESCRIPTION |
15006 | ||
d420ca49 | 15007 | =over 4 |
7d2bfb28 | 15008 | |
15009 | =item The test script output | |
15010 | ||
4d4e713d | 15011 | B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, |
dc5c060f | 15012 | B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>, |
640374d0 JH |
15013 | B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else> |
15014 | ||
15015 | =item Failure | |
15016 | ||
15017 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of | |
15018 | Failed> | |
15019 | ||
15020 | =item Functions | |
15021 | ||
15022 | B<runtests> | |
15023 | ||
15024 | =back | |
dc5c060f | 15025 | |
7d2bfb28 | 15026 | =back |
15027 | ||
640374d0 JH |
15028 | B<_globdir> |
15029 | ||
15030 | B<_run_all_tests> | |
15031 | ||
15032 | B<_mk_leader> | |
15033 | ||
15034 | =over 4 | |
15035 | ||
cb1a09d0 AD |
15036 | =item EXPORT |
15037 | ||
cb1a09d0 AD |
15038 | =item DIAGNOSTICS |
15039 | ||
7d2bfb28 | 15040 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
8ebc5c01 | 15041 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
15042 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
165c0277 | 15043 | %s>, C<FAILED--Further testing stopped%s> |
cb1a09d0 | 15044 | |
fb9cefb4 GS |
15045 | =item ENVIRONMENT |
15046 | ||
2d967e39 JH |
15047 | C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>, |
15048 | C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>, | |
15049 | C<HARNESS_ACTIVE> | |
15050 | ||
640374d0 JH |
15051 | =item EXAMPLE |
15052 | ||
cb1a09d0 AD |
15053 | =item SEE ALSO |
15054 | ||
7d2bfb28 | 15055 | =item AUTHORS |
15056 | ||
640374d0 JH |
15057 | =item TODO |
15058 | ||
cb1a09d0 AD |
15059 | =item BUGS |
15060 | ||
a45bd81d GS |
15061 | =back |
15062 | ||
7a49b635 JH |
15063 | =head2 Test::More - yet another framework for writing test scripts |
15064 | ||
15065 | =over 4 | |
15066 | ||
15067 | =item SYNOPSIS | |
15068 | ||
15069 | =item DESCRIPTION | |
15070 | ||
15071 | =over 4 | |
15072 | ||
15073 | =item I love it when a plan comes together | |
15074 | ||
15075 | =item Test names | |
15076 | ||
15077 | =item I'm ok, you're not ok. | |
15078 | ||
15079 | B<ok> | |
15080 | ||
15081 | =back | |
15082 | ||
15083 | =back | |
15084 | ||
15085 | B<is>, B<isnt> | |
15086 | ||
15087 | B<like> | |
15088 | ||
15089 | B<pass>, B<fail> | |
15090 | ||
15091 | =over 4 | |
15092 | ||
15093 | =item Module tests | |
15094 | ||
15095 | B<use_ok>, B<require_ok> | |
15096 | ||
15097 | =back | |
15098 | ||
15099 | =over 4 | |
15100 | ||
15101 | =item Conditional tests | |
15102 | ||
15103 | B<skip> * UNIMPLEMENTED * | |
15104 | ||
15105 | =back | |
15106 | ||
15107 | B<todo> * UNIMPLEMENTED * | |
15108 | ||
15109 | =over 4 | |
15110 | ||
15111 | =item Comparision functions | |
15112 | ||
15113 | B<eq_array> | |
15114 | ||
15115 | =back | |
15116 | ||
15117 | B<eq_hash> | |
15118 | ||
15119 | B<eq_set> | |
15120 | ||
15121 | =over 4 | |
15122 | ||
15123 | =item BUGS and CAVEATS | |
15124 | ||
15125 | =item AUTHOR | |
15126 | ||
15127 | =item HISTORY | |
15128 | ||
15129 | =item SEE ALSO | |
15130 | ||
15131 | =back | |
15132 | ||
15133 | =head2 Test::Simple - Basic utilities for writing tests. | |
15134 | ||
15135 | =over 4 | |
15136 | ||
15137 | =item SYNOPSIS | |
15138 | ||
15139 | =item DESCRIPTION | |
15140 | ||
15141 | B<ok> | |
15142 | ||
15143 | =back | |
15144 | ||
15145 | B<_sanity_check> | |
15146 | ||
15147 | B<_whoa> | |
15148 | ||
15149 | B<_my_exit> | |
15150 | ||
15151 | =over 4 | |
15152 | ||
15153 | =item EXAMPLE | |
15154 | ||
15155 | =item CAVEATS | |
15156 | ||
15157 | =item HISTORY | |
15158 | ||
15159 | =item AUTHOR | |
15160 | ||
15161 | =item SEE ALSO | |
15162 | ||
15163 | L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>, | |
15164 | L<Test::Harness> | |
15165 | ||
15166 | =back | |
15167 | ||
cb1a09d0 AD |
15168 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
15169 | ||
d420ca49 | 15170 | =over 4 |
a45bd81d | 15171 | |
cb1a09d0 AD |
15172 | =item SYNOPSIS |
15173 | ||
cb1a09d0 AD |
15174 | =item DESCRIPTION |
15175 | ||
cb1a09d0 AD |
15176 | =item EXAMPLE |
15177 | ||
a45bd81d GS |
15178 | =back |
15179 | ||
4d4e713d JH |
15180 | =head2 Text::Balanced - Extract delimited text sequences from strings. |
15181 | ||
15182 | =over 4 | |
15183 | ||
15184 | =item SYNOPSIS | |
15185 | ||
15186 | =item DESCRIPTION | |
15187 | ||
15188 | =over 4 | |
15189 | ||
15190 | =item General behaviour in list contexts | |
15191 | ||
15192 | [0], [1], [2] | |
15193 | ||
15194 | =item General behaviour in scalar and void contexts | |
15195 | ||
15196 | =item A note about prefixes | |
15197 | ||
15198 | =item C<extract_delimited> | |
15199 | ||
15200 | =item C<extract_bracketed> | |
15201 | ||
15202 | =item C<extract_tagged> | |
15203 | ||
15204 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, | |
15205 | [0], [1], [2], [3], [4], [5] | |
15206 | ||
15207 | =item C<gen_extract_tagged> | |
15208 | ||
15209 | =item C<extract_quotelike> | |
15210 | ||
15211 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] | |
15212 | ||
15213 | =item C<extract_quotelike> and "here documents" | |
15214 | ||
15215 | [0], [1], [2], [3], [4], [5], [6], [7..10] | |
15216 | ||
15217 | =item C<extract_codeblock> | |
15218 | ||
15219 | =item C<extract_multiple> | |
15220 | ||
15221 | =item C<gen_delimited_pat> | |
15222 | ||
15223 | =back | |
15224 | ||
15225 | =item DIAGNOSTICS | |
15226 | ||
15227 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, | |
15228 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike | |
15229 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, | |
15230 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, | |
15231 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing | |
15232 | bracket: expected "%c" but found "%s">, C<No block delimiter found after | |
15233 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier | |
15234 | after dereferencer>, C<Did not find expected opening bracket at %s>, | |
15235 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike | |
15236 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: | |
15237 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid | |
15238 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing | |
15239 | tag> | |
15240 | ||
15241 | =item AUTHOR | |
15242 | ||
15243 | =item BUGS AND IRRITATIONS | |
15244 | ||
15245 | =item COPYRIGHT | |
15246 | ||
15247 | =back | |
15248 | ||
193fb0af GS |
15249 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
15250 | arrays | |
cb1a09d0 | 15251 | |
d420ca49 | 15252 | =over 4 |
a45bd81d | 15253 | |
8ebc5c01 | 15254 | =item SYNOPSIS |
cb1a09d0 | 15255 | |
8ebc5c01 | 15256 | =item DESCRIPTION |
cb1a09d0 | 15257 | |
193fb0af GS |
15258 | =item EXAMPLES |
15259 | ||
8ebc5c01 | 15260 | =item AUTHORS |
cb1a09d0 | 15261 | |
a45bd81d GS |
15262 | =back |
15263 | ||
8ebc5c01 | 15264 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
15265 | by Knuth | |
cb1a09d0 | 15266 | |
d420ca49 | 15267 | =over 4 |
a45bd81d | 15268 | |
cb1a09d0 AD |
15269 | =item SYNOPSIS |
15270 | ||
cb1a09d0 AD |
15271 | =item DESCRIPTION |
15272 | ||
cb1a09d0 AD |
15273 | =item EXAMPLES |
15274 | ||
cb1a09d0 AD |
15275 | =item LIMITATIONS |
15276 | ||
cb1a09d0 AD |
15277 | =item AUTHOR |
15278 | ||
a45bd81d GS |
15279 | =back |
15280 | ||
8ebc5c01 | 15281 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
15282 | unexpand(1) | |
cb1a09d0 | 15283 | |
d420ca49 | 15284 | =over 4 |
a45bd81d | 15285 | |
8ebc5c01 | 15286 | =item SYNOPSIS |
cb1a09d0 | 15287 | |
8ebc5c01 | 15288 | =item DESCRIPTION |
cb1a09d0 | 15289 | |
8ebc5c01 | 15290 | =item BUGS |
cb1a09d0 | 15291 | |
8ebc5c01 | 15292 | =item AUTHOR |
cb1a09d0 | 15293 | |
a45bd81d GS |
15294 | =back |
15295 | ||
8ebc5c01 | 15296 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
cb1a09d0 | 15297 | |
d420ca49 | 15298 | =over 4 |
a45bd81d | 15299 | |
8ebc5c01 | 15300 | =item SYNOPSIS |
cb1a09d0 AD |
15301 | |
15302 | =item DESCRIPTION | |
15303 | ||
8ebc5c01 | 15304 | =item EXAMPLE |
cb1a09d0 AD |
15305 | |
15306 | =item AUTHOR | |
15307 | ||
a45bd81d GS |
15308 | =back |
15309 | ||
694468e3 GS |
15310 | =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to |
15311 | change) | |
d516a115 | 15312 | |
d420ca49 | 15313 | =over 4 |
a45bd81d | 15314 | |
bd28ded5 JH |
15315 | =item CAVEAT |
15316 | ||
d516a115 JH |
15317 | =item SYNOPSIS |
15318 | ||
15319 | =item DESCRIPTION | |
15320 | ||
193fb0af GS |
15321 | =item FUNCTIONS |
15322 | ||
15323 | new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;, | |
15324 | Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE, | |
14218588 | 15325 | cond_broadcast VARIABLE, yield |
193fb0af GS |
15326 | |
15327 | =item METHODS | |
15328 | ||
d420ca49 | 15329 | join, eval, detach, equal, tid, flags, done |
193fb0af GS |
15330 | |
15331 | =item LIMITATIONS | |
15332 | ||
d516a115 JH |
15333 | =item SEE ALSO |
15334 | ||
a45bd81d GS |
15335 | =back |
15336 | ||
d516a115 JH |
15337 | =head2 Thread::Queue - thread-safe queues |
15338 | ||
d420ca49 | 15339 | =over 4 |
a45bd81d | 15340 | |
d516a115 JH |
15341 | =item SYNOPSIS |
15342 | ||
193fb0af GS |
15343 | =item DESCRIPTION |
15344 | ||
15345 | =item FUNCTIONS AND METHODS | |
15346 | ||
15347 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
15348 | ||
15349 | =item SEE ALSO | |
15350 | ||
a45bd81d GS |
15351 | =back |
15352 | ||
d516a115 JH |
15353 | =head2 Thread::Semaphore - thread-safe semaphores |
15354 | ||
d420ca49 | 15355 | =over 4 |
a45bd81d | 15356 | |
d516a115 JH |
15357 | =item SYNOPSIS |
15358 | ||
193fb0af GS |
15359 | =item DESCRIPTION |
15360 | ||
15361 | =item FUNCTIONS AND METHODS | |
15362 | ||
15363 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
15364 | ||
a45bd81d GS |
15365 | =back |
15366 | ||
193fb0af GS |
15367 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
15368 | ||
d420ca49 | 15369 | =over 4 |
a45bd81d | 15370 | |
193fb0af GS |
15371 | =item SYNOPSIS |
15372 | ||
15373 | =item DESCRIPTION | |
15374 | ||
15375 | =item BUGS | |
15376 | ||
a45bd81d GS |
15377 | =back |
15378 | ||
d516a115 JH |
15379 | =head2 Thread::Specific - thread-specific keys |
15380 | ||
d420ca49 | 15381 | =over 4 |
a45bd81d | 15382 | |
d516a115 JH |
15383 | =item SYNOPSIS |
15384 | ||
14218588 GS |
15385 | =item DESCRIPTION |
15386 | ||
a45bd81d GS |
15387 | =back |
15388 | ||
d516a115 JH |
15389 | =head2 Tie::Array - base class for tied arrays |
15390 | ||
d420ca49 | 15391 | =over 4 |
a45bd81d | 15392 | |
37d4d706 | 15393 | =item SYNOPSIS |
d516a115 | 15394 | |
37d4d706 | 15395 | =item DESCRIPTION |
d516a115 JH |
15396 | |
15397 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
a45bd81d GS |
15398 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
15399 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
15400 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
d516a115 JH |
15401 | |
15402 | =item CAVEATS | |
15403 | ||
37d4d706 | 15404 | =item AUTHOR |
d516a115 | 15405 | |
a45bd81d GS |
15406 | =back |
15407 | ||
14218588 GS |
15408 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
15409 | handles | |
193fb0af | 15410 | |
d420ca49 | 15411 | =over 4 |
a45bd81d | 15412 | |
193fb0af GS |
15413 | =item SYNOPSIS |
15414 | ||
15415 | =item DESCRIPTION | |
15416 | ||
15417 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
15418 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
14218588 GS |
15419 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
15420 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
193fb0af GS |
15421 | |
15422 | =item MORE INFORMATION | |
15423 | ||
37d4d706 JH |
15424 | =item COMPATIBILITY |
15425 | ||
a45bd81d GS |
15426 | =back |
15427 | ||
8ebc5c01 | 15428 | =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes |
15429 | ||
d420ca49 | 15430 | =over 4 |
a45bd81d | 15431 | |
8ebc5c01 | 15432 | =item SYNOPSIS |
15433 | ||
15434 | =item DESCRIPTION | |
cb1a09d0 | 15435 | |
8ebc5c01 | 15436 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
15437 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this | |
cb1a09d0 | 15438 | |
8ebc5c01 | 15439 | =item CAVEATS |
cb1a09d0 | 15440 | |
8ebc5c01 | 15441 | =item MORE INFORMATION |
cb1a09d0 | 15442 | |
a45bd81d GS |
15443 | =back |
15444 | ||
8ebc5c01 | 15445 | =head2 Tie::RefHash - use references as hash keys |
cb1a09d0 | 15446 | |
d420ca49 | 15447 | =over 4 |
a45bd81d | 15448 | |
cb1a09d0 AD |
15449 | =item SYNOPSIS |
15450 | ||
cb1a09d0 AD |
15451 | =item DESCRIPTION |
15452 | ||
8ebc5c01 | 15453 | =item EXAMPLE |
cb1a09d0 AD |
15454 | |
15455 | =item AUTHOR | |
15456 | ||
8ebc5c01 | 15457 | =item VERSION |
cb1a09d0 | 15458 | |
8ebc5c01 | 15459 | =item SEE ALSO |
cb1a09d0 | 15460 | |
a45bd81d GS |
15461 | =back |
15462 | ||
8ebc5c01 | 15463 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
15464 | scalars | |
cb1a09d0 | 15465 | |
d420ca49 | 15466 | =over 4 |
a45bd81d | 15467 | |
cb1a09d0 AD |
15468 | =item SYNOPSIS |
15469 | ||
cb1a09d0 AD |
15470 | =item DESCRIPTION |
15471 | ||
8ebc5c01 | 15472 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
cb1a09d0 | 15473 | |
8ebc5c01 | 15474 | =item MORE INFORMATION |
cb1a09d0 | 15475 | |
a45bd81d GS |
15476 | =back |
15477 | ||
8ebc5c01 | 15478 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
cb1a09d0 | 15479 | |
d420ca49 | 15480 | =over 4 |
a45bd81d | 15481 | |
8ebc5c01 | 15482 | =item SYNOPSIS |
cb1a09d0 | 15483 | |
8ebc5c01 | 15484 | =item DESCRIPTION |
cb1a09d0 | 15485 | |
8ebc5c01 | 15486 | =item CAVEATS |
cb1a09d0 | 15487 | |
a45bd81d GS |
15488 | =back |
15489 | ||
41ca3a40 JH |
15490 | =head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday |
15491 | ||
15492 | =over 4 | |
15493 | ||
15494 | =item SYNOPSIS | |
15495 | ||
15496 | =item DESCRIPTION | |
15497 | ||
15498 | gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, | |
245d750e JH |
15499 | $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), |
15500 | alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer, | |
15501 | getitimer ( $which ) | |
41ca3a40 JH |
15502 | |
15503 | =item EXAMPLES | |
15504 | ||
15505 | =item C API | |
15506 | ||
245d750e JH |
15507 | =item CAVEATS |
15508 | ||
41ca3a40 JH |
15509 | =item AUTHORS |
15510 | ||
15511 | =item REVISION | |
15512 | ||
15513 | =item COPYRIGHT | |
15514 | ||
15515 | =back | |
15516 | ||
8ebc5c01 | 15517 | =head2 Time::Local - efficiently compute time from local and GMT time |
cb1a09d0 | 15518 | |
d420ca49 | 15519 | =over 4 |
a45bd81d | 15520 | |
8ebc5c01 | 15521 | =item SYNOPSIS |
cb1a09d0 | 15522 | |
8ebc5c01 | 15523 | =item DESCRIPTION |
cb1a09d0 | 15524 | |
14218588 GS |
15525 | =item IMPLEMENTATION |
15526 | ||
15527 | =item BUGS | |
15528 | ||
a45bd81d GS |
15529 | =back |
15530 | ||
41ca3a40 JH |
15531 | =head2 Time::Piece - Object Oriented time objects |
15532 | ||
15533 | =over 4 | |
15534 | ||
15535 | =item SYNOPSIS | |
15536 | ||
15537 | =item DESCRIPTION | |
15538 | ||
15539 | =item USAGE | |
15540 | ||
15541 | =over 4 | |
15542 | ||
15543 | =item Local Locales | |
15544 | ||
15545 | =item Date Calculations | |
15546 | ||
15547 | =item Date Comparisons | |
15548 | ||
1fa7ca25 JH |
15549 | =item YYYY-MM-DDThh:mm:ss |
15550 | ||
15551 | =item Week Number | |
15552 | ||
2ca5449f JH |
15553 | =item strftime method |
15554 | ||
15555 | %%, %a, %A, %b, %B, %c, %C, %d, %D, %e, %h, %H, %I, %j, %m, %M, %n, %p, %r, | |
15556 | %R, %S, %t, %T, %u, %U, %V, %w, %W, %x, %y, %Y, %Z | |
15557 | ||
15558 | =item strptime function | |
15559 | ||
41ca3a40 JH |
15560 | =item Global Overriding |
15561 | ||
15562 | =back | |
15563 | ||
1fa7ca25 JH |
15564 | =item SEE ALSO |
15565 | ||
41ca3a40 JH |
15566 | =item AUTHOR |
15567 | ||
15568 | =over 4 | |
15569 | ||
15570 | =item License | |
15571 | ||
15572 | =item Bugs | |
15573 | ||
15574 | =back | |
15575 | ||
15576 | =back | |
15577 | ||
15578 | =head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert | |
15579 | seconds to other date values | |
15580 | ||
15581 | =over 4 | |
15582 | ||
15583 | =item SYNOPSIS | |
15584 | ||
15585 | =item DESCRIPTION | |
15586 | ||
15587 | =item METHODS | |
15588 | ||
15589 | =item AUTHOR | |
15590 | ||
15591 | =item LICENSE | |
15592 | ||
15593 | =item Bugs | |
15594 | ||
15595 | =back | |
15596 | ||
9038e305 JH |
15597 | =head2 Time::Seconds - a simple API to convert seconds to other date values |
15598 | ||
15599 | =over 4 | |
15600 | ||
15601 | =item SYNOPSIS | |
15602 | ||
15603 | =item DESCRIPTION | |
15604 | ||
15605 | =item METHODS | |
15606 | ||
15607 | =item AUTHOR | |
15608 | ||
15609 | =item LICENSE | |
15610 | ||
15611 | =item Bugs | |
15612 | ||
15613 | =back | |
15614 | ||
8ebc5c01 | 15615 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
15616 | function | |
7d2bfb28 | 15617 | |
d420ca49 | 15618 | =over 4 |
a45bd81d | 15619 | |
7d2bfb28 | 15620 | =item SYNOPSIS |
15621 | ||
7d2bfb28 | 15622 | =item DESCRIPTION |
15623 | ||
8ebc5c01 | 15624 | =item NOTE |
7d2bfb28 | 15625 | |
8ebc5c01 | 15626 | =item AUTHOR |
7d2bfb28 | 15627 | |
a45bd81d GS |
15628 | =back |
15629 | ||
8ebc5c01 | 15630 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
15631 | function | |
7d2bfb28 | 15632 | |
d420ca49 | 15633 | =over 4 |
a45bd81d | 15634 | |
8ebc5c01 | 15635 | =item SYNOPSIS |
7d2bfb28 | 15636 | |
8ebc5c01 | 15637 | =item DESCRIPTION |
7d2bfb28 | 15638 | |
8ebc5c01 | 15639 | =item NOTE |
7d2bfb28 | 15640 | |
8ebc5c01 | 15641 | =item AUTHOR |
7d2bfb28 | 15642 | |
a45bd81d GS |
15643 | =back |
15644 | ||
8ebc5c01 | 15645 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 15646 | |
d420ca49 | 15647 | =over 4 |
a45bd81d | 15648 | |
7d2bfb28 | 15649 | =item SYNOPSIS |
15650 | ||
8ebc5c01 | 15651 | =item DESCRIPTION |
15652 | ||
15653 | =item AUTHOR | |
15654 | ||
a45bd81d GS |
15655 | =back |
15656 | ||
8ebc5c01 | 15657 | =head2 UNIVERSAL - base class for ALL classes (blessed references) |
15658 | ||
d420ca49 | 15659 | =over 4 |
a45bd81d | 15660 | |
8ebc5c01 | 15661 | =item SYNOPSIS |
7d2bfb28 | 15662 | |
15663 | =item DESCRIPTION | |
15664 | ||
d516a115 JH |
15665 | isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa ( |
15666 | VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) | |
7d2bfb28 | 15667 | |
a45bd81d GS |
15668 | =back |
15669 | ||
00f2772c | 15670 | =head2 Unicode::UCD - Unicode character database |
354a27bf JH |
15671 | |
15672 | =over 4 | |
15673 | ||
15674 | =item SYNOPSIS | |
15675 | ||
15676 | =item DESCRIPTION | |
15677 | ||
15678 | =back | |
15679 | ||
15680 | =over 4 | |
15681 | ||
15682 | =item charinfo | |
15683 | ||
15684 | =back | |
15685 | ||
15686 | =over 4 | |
15687 | ||
15688 | =item charblock | |
15689 | ||
15690 | =back | |
15691 | ||
15692 | =over 4 | |
15693 | ||
afd1eb53 NIS |
15694 | =item charscript |
15695 | ||
15696 | =back | |
15697 | ||
15698 | =over 4 | |
15699 | ||
15700 | =item charblocks | |
15701 | ||
15702 | =back | |
15703 | ||
15704 | =over 4 | |
15705 | ||
15706 | =item charscripts | |
15707 | ||
15708 | =back | |
15709 | ||
15710 | =over 4 | |
15711 | ||
15712 | =item Blocks versus Scripts | |
15713 | ||
15714 | =item Matching Scripts and Blocks | |
15715 | ||
15716 | =item charinrange | |
15717 | ||
15718 | =back | |
15719 | ||
15720 | =over 4 | |
15721 | ||
15722 | =item Unicode::UCD::UnicodeVersion | |
15723 | ||
15724 | =back | |
15725 | ||
15726 | =over 4 | |
15727 | ||
15728 | =item Implementation Note | |
15729 | ||
15730 | =back | |
15731 | ||
15732 | =over 4 | |
15733 | ||
354a27bf JH |
15734 | =item AUTHOR |
15735 | ||
15736 | =back | |
15737 | ||
8ebc5c01 | 15738 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
15739 | functions | |
7d2bfb28 | 15740 | |
d420ca49 | 15741 | =over 4 |
a45bd81d | 15742 | |
8ebc5c01 | 15743 | =item SYNOPSIS |
7d2bfb28 | 15744 | |
8ebc5c01 | 15745 | =item DESCRIPTION |
7d2bfb28 | 15746 | |
8ebc5c01 | 15747 | =item NOTE |
7d2bfb28 | 15748 | |
8ebc5c01 | 15749 | =item AUTHOR |
7d2bfb28 | 15750 | |
a45bd81d GS |
15751 | =back |
15752 | ||
8ebc5c01 | 15753 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
15754 | functions | |
cb1a09d0 | 15755 | |
d420ca49 | 15756 | =over 4 |
a45bd81d | 15757 | |
cb1a09d0 AD |
15758 | =item SYNOPSIS |
15759 | ||
cb1a09d0 AD |
15760 | =item DESCRIPTION |
15761 | ||
d420ca49 | 15762 | =over 4 |
b38f6a39 | 15763 | |
37590e52 | 15764 | =item System Specifics |
b38f6a39 GS |
15765 | |
15766 | =back | |
15767 | ||
37590e52 | 15768 | =item NOTE |
b38f6a39 GS |
15769 | |
15770 | =item AUTHOR | |
15771 | ||
37590e52 | 15772 | =item HISTORY |
b38f6a39 | 15773 | |
37590e52 | 15774 | March 18th, 2000 |
b38f6a39 GS |
15775 | |
15776 | =back | |
15777 | ||
4755096e GS |
15778 | =head2 Win32 - Interfaces to some Win32 API Functions |
15779 | ||
d420ca49 | 15780 | =over 4 |
4755096e GS |
15781 | |
15782 | =item DESCRIPTION | |
15783 | ||
d420ca49 | 15784 | =over 4 |
4755096e GS |
15785 | |
15786 | =item Alphabetical Listing of Win32 Functions | |
15787 | ||
15788 | Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), | |
15789 | Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), | |
15790 | Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), | |
15791 | Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), | |
15792 | Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), | |
15793 | Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), | |
15794 | Win32::GetNextAvailDrive(), Win32::GetOSVersion(), | |
15795 | Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, | |
983dbef6 JH |
15796 | PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, |
15797 | Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME), | |
15798 | Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, | |
15799 | SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), | |
4755096e GS |
15800 | Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), |
15801 | Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY), | |
15802 | Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, | |
15803 | PID), Win32::UnregisterServer(LIBRARYNAME) | |
15804 | ||
15805 | =back | |
15806 | ||
15807 | =back | |
15808 | ||
0d0e97a6 JH |
15809 | =head2 XS::Typemap - module to test the XS typemaps distributed with perl |
15810 | ||
15811 | =over 4 | |
15812 | ||
15813 | =item SYNOPSIS | |
15814 | ||
15815 | =item DESCRIPTION | |
15816 | ||
15817 | =back | |
15818 | ||
15819 | =over 4 | |
15820 | ||
15821 | =item NOTES | |
15822 | ||
15823 | =item AUTHOR | |
15824 | ||
15825 | =back | |
15826 | ||
a45bd81d GS |
15827 | =head2 XSLoader - Dynamically load C libraries into Perl code |
15828 | ||
d420ca49 | 15829 | =over 4 |
a45bd81d GS |
15830 | |
15831 | =item SYNOPSIS | |
15832 | ||
15833 | =item DESCRIPTION | |
15834 | ||
15835 | =item AUTHOR | |
15836 | ||
15837 | =back | |
15838 | ||
cb1a09d0 AD |
15839 | =head1 AUXILIARY DOCUMENTATION |
15840 | ||
8ebc5c01 | 15841 | Here should be listed all the extra programs' documentation, but they |
15842 | don't all have manual pages yet: | |
cb1a09d0 | 15843 | |
d420ca49 | 15844 | =over 4 |
a45bd81d | 15845 | |
cb1a09d0 AD |
15846 | =item a2p |
15847 | ||
15848 | =item s2p | |
15849 | ||
15850 | =item find2perl | |
15851 | ||
15852 | =item h2ph | |
15853 | ||
15854 | =item c2ph | |
15855 | ||
15856 | =item h2xs | |
15857 | ||
15858 | =item xsubpp | |
15859 | ||
15860 | =item pod2man | |
15861 | ||
15862 | =item wrapsuid | |
15863 | ||
a45bd81d GS |
15864 | =back |
15865 | ||
cb1a09d0 AD |
15866 | =head1 AUTHOR |
15867 | ||
2ae324a7 | 15868 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
8ebc5c01 | 15869 | of other folks. |
cb1a09d0 | 15870 |