pod/perltoc.pod

   1
   2 =head1 NAME
   3
   4 perltoc - perl documentation table of contents
   5
   6 =head1 DESCRIPTION
   7
   8 This page provides a brief table of contents for the rest of the Perl
   9 documentation set.  It is meant to be scanned quickly or grepped
  10 through to locate the proper section you're looking for.
  11
  12 =head1 BASIC DOCUMENTATION
  13
  14 =head2 perl - Practical Extraction and Report Language
  15
  16 =over 4
  17
  18 =item SYNOPSIS
  19
  20 =item DESCRIPTION
  21
  22 =item AVAILABILITY
  23
  24 =item ENVIRONMENT
  25
  26 =item AUTHOR
  27
  28 =item FILES
  29
  30 =item SEE ALSO
  31
  32 =item DIAGNOSTICS
  33
  34 =item BUGS
  35
  36 =item NOTES
  37
  38 =back
  39
  40 =head2 perlfaq - frequently asked questions about Perl ($Date: 2001/09/20
  41 03:03:00 $)
  42
  43 =over 4
  44
  45 =item DESCRIPTION
  46
  47 =over 4
  48
  49 =item perlfaq: Structural overview of the FAQ.
  50
  51 =item L<perlfaq1>: General Questions About Perl
  52
  53 =item L<perlfaq2>: Obtaining and Learning about Perl
  54
  55 =item L<perlfaq3>: Programming Tools
  56
  57 =item L<perlfaq4>: Data Manipulation
  58
  59 =item L<perlfaq5>: Files and Formats
  60
  61 =item L<perlfaq6>: Regexps
  62
  63 =item L<perlfaq7>: General Perl Language Issues
  64
  65 =item L<perlfaq8>: System Interaction
  66
  67 =item L<perlfaq9>: Networking
  68
  69 =back
  70
  71 =item About the perlfaq documents
  72
  73 =over 4
  74
  75 =item Where to get the perlfaq
  76
  77 =item How to contribute to the perlfaq
  78
  79 =item What will happen if you mail your Perl programming problems to the
  80 authors
  81
  82 =back
  83
  84 =item Credits
  85
  86 =item Author and Copyright Information
  87
  88 =over 4
  89
  90 =item Bundled Distributions
  91
  92 =item Disclaimer
  93
  94 =back
  95
  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
 102 =back
 103
 104 =head2 perlbook - Perl book information
 105
 106 =over 4
 107
 108 =item DESCRIPTION
 109
 110 =back
 111
 112 =head2 perlsyn - Perl syntax
 113
 114 =over 4
 115
 116 =item DESCRIPTION
 117
 118 =over 4
 119
 120 =item Declarations
 121
 122 =item Simple statements
 123
 124 =item Compound statements
 125
 126 =item Loop Control
 127
 128 =item For Loops
 129
 130 =item Foreach Loops
 131
 132 =item Basic BLOCKs and Switch Statements
 133
 134 =item Goto
 135
 136 =item PODs: Embedded Documentation
 137
 138 =item Plain Old Comments (Not!)
 139
 140 =back
 141
 142 =back
 143
 144 =head2 perldata - Perl data types
 145
 146 =over 4
 147
 148 =item DESCRIPTION
 149
 150 =over 4
 151
 152 =item Variable names
 153
 154 =item Context
 155
 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
 165
 166 =back
 167
 168 =item SEE ALSO
 169
 170 =back
 171
 172 =head2 perlop - Perl operators and precedence
 173
 174 =over 4
 175
 176 =item SYNOPSIS
 177
 178 =item DESCRIPTION
 179
 180 =over 4
 181
 182 =item Terms and List Operators (Leftward)
 183
 184 =item The Arrow Operator
 185
 186 =item Auto-increment and Auto-decrement
 187
 188 =item Exponentiation
 189
 190 =item Symbolic Unary Operators
 191
 192 =item Binding Operators
 193
 194 =item Multiplicative Operators
 195
 196 =item Additive Operators
 197
 198 =item Shift Operators
 199
 200 =item Named Unary Operators
 201
 202 =item Relational Operators
 203
 204 =item Equality Operators
 205
 206 =item Bitwise And
 207
 208 =item Bitwise Or and Exclusive Or
 209
 210 =item C-style Logical And
 211
 212 =item C-style Logical Or
 213
 214 =item Range Operators
 215
 216 =item Conditional Operator
 217
 218 =item Assignment Operators
 219
 220 =item Comma Operator
 221
 222 =item List Operators (Rightward)
 223
 224 =item Logical Not
 225
 226 =item Logical And
 227
 228 =item Logical or and Exclusive Or
 229
 230 =item C Operators Missing From Perl
 231
 232 unary &, unary *, (TYPE)
 233
 234 =item Quote and Quote-like Operators
 235
 236 =item Regexp Quote-Like Operators
 237
 238 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 239 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 240 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 241 y/SEARCHLIST/REPLACEMENTLIST/cds
 242
 243 =item Gory details of parsing quoted constructs
 244
 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
 250
 251 =item I/O Operators
 252
 253 =item Constant Folding
 254
 255 =item Bitwise String Operators
 256
 257 =item Integer Arithmetic
 258
 259 =item Floating-point Arithmetic
 260
 261 =item Bigger Numbers
 262
 263 =back
 264
 265 =back
 266
 267 =head2 perlsub - Perl subroutines
 268
 269 =over 4
 270
 271 =item SYNOPSIS
 272
 273 =item DESCRIPTION
 274
 275 =over 4
 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
 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
 309 =over 4
 310
 311 =item DESCRIPTION
 312
 313 =over 4
 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,
 339 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 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,
 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
 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
 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
 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
 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
 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
 410 =head2 perlreftut - Mark's very short tutorial about references
 411
 412 =over 4
 413
 414 =item DESCRIPTION
 415
 416 =item Who Needs Complicated Data Structures?
 417
 418 =item The Solution
 419
 420 =item Syntax
 421
 422 =over 4
 423
 424 =item Making References
 425
 426 =item Using References
 427
 428 =back
 429
 430 =item An Example
 431
 432 =item Arrow Rule
 433
 434 =item Solution
 435
 436 =item The Rest
 437
 438 =item Summary
 439
 440 =item Credits
 441
 442 =over 4
 443
 444 =item Distribution Conditions
 445
 446 =back
 447
 448 =back
 449
 450 =head2 perldsc - Perl Data Structures Cookbook
 451
 452 =over 4
 453
 454 =item DESCRIPTION
 455
 456 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 457 more elaborate constructs
 458
 459 =item REFERENCES
 460
 461 =item COMMON MISTAKES
 462
 463 =item CAVEAT ON PRECEDENCE
 464
 465 =item WHY YOU SHOULD ALWAYS C<use strict>
 466
 467 =item DEBUGGING
 468
 469 =item CODE EXAMPLES
 470
 471 =item ARRAYS OF ARRAYS
 472
 473 =over 4
 474
 475 =item Declaration of a ARRAY OF ARRAYS
 476
 477 =item Generation of a ARRAY OF ARRAYS
 478
 479 =item Access and Printing of a ARRAY OF ARRAYS
 480
 481 =back
 482
 483 =item HASHES OF ARRAYS
 484
 485 =over 4
 486
 487 =item Declaration of a HASH OF ARRAYS
 488
 489 =item Generation of a HASH OF ARRAYS
 490
 491 =item Access and Printing of a HASH OF ARRAYS
 492
 493 =back
 494
 495 =item ARRAYS OF HASHES
 496
 497 =over 4
 498
 499 =item Declaration of a ARRAY OF HASHES
 500
 501 =item Generation of a ARRAY OF HASHES
 502
 503 =item Access and Printing of a ARRAY OF HASHES
 504
 505 =back
 506
 507 =item HASHES OF HASHES
 508
 509 =over 4
 510
 511 =item Declaration of a HASH OF HASHES
 512
 513 =item Generation of a HASH OF HASHES
 514
 515 =item Access and Printing of a HASH OF HASHES
 516
 517 =back
 518
 519 =item MORE ELABORATE RECORDS
 520
 521 =over 4
 522
 523 =item Declaration of MORE ELABORATE RECORDS
 524
 525 =item Declaration of a HASH OF COMPLEX RECORDS
 526
 527 =item Generation of a HASH OF COMPLEX RECORDS
 528
 529 =back
 530
 531 =item Database Ties
 532
 533 =item SEE ALSO
 534
 535 =item AUTHOR
 536
 537 =back
 538
 539 =head2 perlrequick - Perl regular expressions quick start
 540
 541 =over 4
 542
 543 =item DESCRIPTION
 544
 545 =item The Guide
 546
 547 =over 4
 548
 549 =item Simple word matching
 550
 551 =item Using character classes
 552
 553 =item Matching this or that
 554
 555 =item Grouping things and hierarchical matching
 556
 557 =item Extracting matches
 558
 559 =item Matching repetitions
 560
 561 =item More matching
 562
 563 =item Search and replace
 564
 565 =item The split operator
 566
 567 =back
 568
 569 =item BUGS
 570
 571 =item SEE ALSO
 572
 573 =item AUTHOR AND COPYRIGHT
 574
 575 =over 4
 576
 577 =item Acknowledgments
 578
 579 =back
 580
 581 =back
 582
 583 =head2 perlpod - plain old documentation
 584
 585 =over 4
 586
 587 =item DESCRIPTION
 588
 589 =over 4
 590
 591 =item Verbatim Paragraph
 592
 593 =item Command Paragraph
 594
 595 =item Ordinary Block of Text
 596
 597 =item The Intent
 598
 599 =item Embedding Pods in Perl Modules
 600
 601 =item Common Pod Pitfalls
 602
 603 =back
 604
 605 =item SEE ALSO
 606
 607 =item AUTHOR
 608
 609 =back
 610
 611 =head2 perlstyle - Perl style guide
 612
 613 =over 4
 614
 615 =item DESCRIPTION
 616
 617 =back
 618
 619 =head2 perltrap - Perl traps for the unwary
 620
 621 =over 4
 622
 623 =item DESCRIPTION
 624
 625 =over 4
 626
 627 =item Awk Traps
 628
 629 =item C Traps
 630
 631 =item Sed Traps
 632
 633 =item Shell Traps
 634
 635 =item Perl Traps
 636
 637 =item Perl4 to Perl5 Traps
 638
 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
 699
 700 =back
 701
 702 =back
 703
 704 =head2 perlrun - how to execute the Perl interpreter
 705
 706 =over 4
 707
 708 =item SYNOPSIS
 709
 710 =item DESCRIPTION
 711
 712 =over 4
 713
 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
 722 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 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>
 729
 730 =back
 731
 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
 742 =over 4
 743
 744 =item DESCRIPTION
 745
 746 =back
 747
 748 =head2 perllexwarn - Perl Lexical Warnings
 749
 750 =over 4
 751
 752 =item DESCRIPTION
 753
 754 =over 4
 755
 756 =item Default Warnings and Optional Warnings
 757
 758 =item What's wrong with B<-w> and C<$^W>
 759
 760 =item Controlling Warnings from the Command Line
 761
 762 B<-w>, B<-W>, B<-X>
 763
 764 =item Backward Compatibility
 765
 766 =item Category Hierarchy
 767
 768 =item Fatal Warnings
 769
 770 =item Reporting Warnings from a Module
 771
 772 =back
 773
 774 =item TODO
 775
 776 =item SEE ALSO
 777
 778 =item AUTHOR
 779
 780 =back
 781
 782 =head2 perldebtut - Perl debugging tutorial
 783
 784 =over 4
 785
 786 =item DESCRIPTION
 787
 788 =item use strict
 789
 790 =item Looking at data and -w and w
 791
 792 =item help
 793
 794 =item Stepping through code
 795
 796 =item Placeholder for a, w, t, T
 797
 798 =item REGULAR EXPRESSIONS
 799
 800 =item OUTPUT TIPS
 801
 802 =item CGI
 803
 804 =item GUIs
 805
 806 =item SUMMARY
 807
 808 =item SEE ALSO
 809
 810 =item AUTHOR
 811
 812 =item CONTRIBUTORS
 813
 814 =back
 815
 816 =head2 perldebug - Perl debugging
 817
 818 =over 4
 819
 820 =item DESCRIPTION
 821
 822 =item The Perl Debugger
 823
 824 =over 4
 825
 826 =item Debugger Commands
 827
 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, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
 837 [manpage]
 838
 839 =item Configurable Options
 840
 841 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 842 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 843 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 844 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
 845 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
 846 C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
 847
 848 =item Debugger input/output
 849
 850 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 851 listing
 852
 853 =item Debugging compile-time statements
 854
 855 =item Debugger Customization
 856
 857 =item Readline Support
 858
 859 =item Editor Support for Debugging
 860
 861 =item The Perl Profiler
 862
 863 =back
 864
 865 =item Debugging regular expressions
 866
 867 =item Debugging memory usage
 868
 869 =item SEE ALSO
 870
 871 =item BUGS
 872
 873 =back
 874
 875 =head2 perlvar - Perl predefined variables
 876
 877 =over 4
 878
 879 =item DESCRIPTION
 880
 881 =over 4
 882
 883 =item Predefined Names
 884
 885 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 886 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
 887 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
 888 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
 889 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
 890 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
 891 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
 892 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
 893 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
 894 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
 895 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
 896 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
 897 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
 898 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
 899 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
 900 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
 901 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
 902 IO::Handle->format_line_break_characters EXPR,
 903 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
 904 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR,
 905 $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID,
 906 $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
 907 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
 908 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H,
 909 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04,
 910 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R,
 911 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, $PERL_VERSION, $^V,
 912 $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME,
 913 $^X, ARGV, $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
 914 $SIG{expr}
 915
 916 =item Error Indicators
 917
 918 =item Technical Note on the Syntax of Variable Names
 919
 920 =back
 921
 922 =item BUGS
 923
 924 =back
 925
 926 =head2 perllol - Manipulating Arrays of Arrays in Perl
 927
 928 =over 4
 929
 930 =item DESCRIPTION
 931
 932 =over 4
 933
 934 =item Declaration and Access of Arrays of Arrays
 935
 936 =item Growing Your Own
 937
 938 =item Access and Printing
 939
 940 =item Slices
 941
 942 =back
 943
 944 =item SEE ALSO
 945
 946 =item AUTHOR
 947
 948 =back
 949
 950 =head2 perlopentut - tutorial on opening things in Perl
 951
 952 =over 4
 953
 954 =item DESCRIPTION
 955
 956 =item Open E<agrave> la shell
 957
 958 =over 4
 959
 960 =item Simple Opens
 961
 962 =item Pipe Opens
 963
 964 =item The Minus File
 965
 966 =item Mixing Reads and Writes
 967
 968 =item Filters
 969
 970 =back
 971
 972 =item Open E<agrave> la C
 973
 974 =over 4
 975
 976 =item Permissions E<agrave> la mode
 977
 978 =back
 979
 980 =item Obscure Open Tricks
 981
 982 =over 4
 983
 984 =item Re-Opening Files (dups)
 985
 986 =item Dispelling the Dweomer
 987
 988 =item Paths as Opens
 989
 990 =item Single Argument Open
 991
 992 =item Playing with STDIN and STDOUT
 993
 994 =back
 995
 996 =item Other I/O Issues
 997
 998 =over 4
 999
1000 =item Opening Non-File Files
1001
1002 =item Binary Files
1003
1004 =item File Locking
1005
1006 =back
1007
1008 =item SEE ALSO
1009
1010 =item AUTHOR and COPYRIGHT
1011
1012 =item HISTORY
1013
1014 =back
1015
1016 =head2 perlretut - Perl regular expressions tutorial
1017
1018 =over 4
1019
1020 =item DESCRIPTION
1021
1022 =item Part 1: The basics
1023
1024 =over 4
1025
1026 =item Simple word matching
1027
1028 =item Using character classes
1029
1030 =item Matching this or that
1031
1032 =item Grouping things and hierarchical matching
1033
1034 =item Extracting matches
1035
1036 =item Matching repetitions
1037
1038 =item Building a regexp
1039
1040 =item Using regular expressions in Perl
1041
1042 =back
1043
1044 =item Part 2: Power tools
1045
1046 =over 4
1047
1048 =item More on characters, strings, and character classes
1049
1050 =item Compiling and saving regular expressions
1051
1052 =item Embedding comments and modifiers in a regular expression
1053
1054 =item Non-capturing groupings
1055
1056 =item Looking ahead and looking behind
1057
1058 =item Using independent subexpressions to prevent backtracking
1059
1060 =item Conditional expressions
1061
1062 =item A bit of magic: executing Perl code in a regular expression
1063
1064 =item Pragmas and debugging
1065
1066 =back
1067
1068 =item BUGS
1069
1070 =item SEE ALSO
1071
1072 =item AUTHOR AND COPYRIGHT
1073
1074 =over 4
1075
1076 =item Acknowledgments
1077
1078 =back
1079
1080 =back
1081
1082 =head2 perlre - Perl regular expressions
1083
1084 =over 4
1085
1086 =item DESCRIPTION
1087
1088 i, m, s, x
1089
1090 =over 4
1091
1092 =item Regular Expressions
1093
1094 cntrl, graph, print, punct, xdigit
1095
1096 =item Extended Patterns
1097
1098 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1099 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1100 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1101 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1102
1103 =item Backtracking
1104
1105 =item Version 8 Regular Expressions
1106
1107 =item Warning on \1 vs $1
1108
1109 =item Repeated patterns matching zero-length substring
1110
1111 =item Combining pieces together
1112
1113 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1114 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1115 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1116 C<(?(condition)yes-pattern|no-pattern)>
1117
1118 =item Creating custom RE engines
1119
1120 =back
1121
1122 =item BUGS
1123
1124 =item SEE ALSO
1125
1126 =back
1127
1128 =head2 perlref - Perl references and nested data structures
1129
1130 =over 4
1131
1132 =item NOTE
1133
1134 =item DESCRIPTION
1135
1136 =over 4
1137
1138 =item Making References
1139
1140 =item Using References
1141
1142 =item Symbolic references
1143
1144 =item Not-so-symbolic references
1145
1146 =item Pseudo-hashes: Using an array as a hash
1147
1148 =item Function Templates
1149
1150 =back
1151
1152 =item WARNING
1153
1154 =item SEE ALSO
1155
1156 =back
1157
1158 =head2 perlform - Perl formats
1159
1160 =over 4
1161
1162 =item DESCRIPTION
1163
1164 =over 4
1165
1166 =item Format Variables
1167
1168 =back
1169
1170 =item NOTES
1171
1172 =over 4
1173
1174 =item Footers
1175
1176 =item Accessing Formatting Internals
1177
1178 =back
1179
1180 =item WARNINGS
1181
1182 =back
1183
1184 =head2 perlboot - Beginner's Object-Oriented Tutorial
1185
1186 =over 4
1187
1188 =item DESCRIPTION
1189
1190 =over 4
1191
1192 =item If we could talk to the animals...
1193
1194 =item Introducing the method invocation arrow
1195
1196 =item Invoking a barnyard
1197
1198 =item The extra parameter of method invocation
1199
1200 =item Calling a second method to simplify things
1201
1202 =item Inheriting the windpipes
1203
1204 =item A few notes about @ISA
1205
1206 =item Overriding the methods
1207
1208 =item Starting the search from a different place
1209
1210 =item The SUPER way of doing things
1211
1212 =item Where we're at so far...
1213
1214 =item A horse is a horse, of course of course -- or is it?
1215
1216 =item Invoking an instance method
1217
1218 =item Accessing the instance data
1219
1220 =item How to build a horse
1221
1222 =item Inheriting the constructor
1223
1224 =item Making a method work with either classes or instances
1225
1226 =item Adding parameters to a method
1227
1228 =item More interesting instances
1229
1230 =item A horse of a different color
1231
1232 =item Summary
1233
1234 =back
1235
1236 =item SEE ALSO
1237
1238 =item COPYRIGHT
1239
1240 =back
1241
1242 =head2 perltoot - Tom's object-oriented tutorial for perl
1243
1244 =over 4
1245
1246 =item DESCRIPTION
1247
1248 =item Creating a Class
1249
1250 =over 4
1251
1252 =item Object Representation
1253
1254 =item Class Interface
1255
1256 =item Constructors and Instance Methods
1257
1258 =item Planning for the Future: Better Constructors
1259
1260 =item Destructors
1261
1262 =item Other Object Methods
1263
1264 =back
1265
1266 =item Class Data
1267
1268 =over 4
1269
1270 =item Accessing Class Data
1271
1272 =item Debugging Methods
1273
1274 =item Class Destructors
1275
1276 =item Documenting the Interface
1277
1278 =back
1279
1280 =item Aggregation
1281
1282 =item Inheritance
1283
1284 =over 4
1285
1286 =item Overridden Methods
1287
1288 =item Multiple Inheritance
1289
1290 =item UNIVERSAL: The Root of All Objects
1291
1292 =back
1293
1294 =item Alternate Object Representations
1295
1296 =over 4
1297
1298 =item Arrays as Objects
1299
1300 =item Closures as Objects
1301
1302 =back
1303
1304 =item AUTOLOAD: Proxy Methods
1305
1306 =over 4
1307
1308 =item Autoloaded Data Methods
1309
1310 =item Inherited Autoloaded Data Methods
1311
1312 =back
1313
1314 =item Metaclassical Tools
1315
1316 =over 4
1317
1318 =item Class::Struct
1319
1320 =item Data Members as Variables
1321
1322 =back
1323
1324 =item NOTES
1325
1326 =over 4
1327
1328 =item Object Terminology
1329
1330 =back
1331
1332 =item SEE ALSO
1333
1334 =item AUTHOR AND COPYRIGHT
1335
1336 =item COPYRIGHT
1337
1338 =over 4
1339
1340 =item Acknowledgments
1341
1342 =back
1343
1344 =back
1345
1346 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1347
1348 =over 4
1349
1350 =item DESCRIPTION
1351
1352 =item Class Data in a Can
1353
1354 =item Class Data as Package Variables
1355
1356 =over 4
1357
1358 =item Putting All Your Eggs in One Basket
1359
1360 =item Inheritance Concerns
1361
1362 =item The Eponymous Meta-Object
1363
1364 =item Indirect References to Class Data
1365
1366 =item Monadic Classes
1367
1368 =item Translucent Attributes
1369
1370 =back
1371
1372 =item Class Data as Lexical Variables
1373
1374 =over 4
1375
1376 =item Privacy and Responsibility
1377
1378 =item File-Scoped Lexicals
1379
1380 =item More Inheritance Concerns
1381
1382 =item Locking the Door and Throwing Away the Key
1383
1384 =item Translucency Revisited
1385
1386 =back
1387
1388 =item NOTES
1389
1390 =item SEE ALSO
1391
1392 =item AUTHOR AND COPYRIGHT
1393
1394 =item ACKNOWLEDGEMENTS
1395
1396 =item HISTORY
1397
1398 =back
1399
1400 =head2 perlobj - Perl objects
1401
1402 =over 4
1403
1404 =item DESCRIPTION
1405
1406 =over 4
1407
1408 =item An Object is Simply a Reference
1409
1410 =item A Class is Simply a Package
1411
1412 =item A Method is Simply a Subroutine
1413
1414 =item Method Invocation
1415
1416 =item Indirect Object Syntax
1417
1418 =item Default UNIVERSAL methods
1419
1420 isa(CLASS), can(METHOD), VERSION( [NEED] )
1421
1422 =item Destructors
1423
1424 =item Summary
1425
1426 =item Two-Phased Garbage Collection
1427
1428 =back
1429
1430 =item SEE ALSO
1431
1432 =back
1433
1434 =head2 perlbot - Bag'o Object Tricks (the BOT)
1435
1436 =over 4
1437
1438 =item DESCRIPTION
1439
1440 =item OO SCALING TIPS
1441
1442 =item INSTANCE VARIABLES
1443
1444 =item SCALAR INSTANCE VARIABLES
1445
1446 =item INSTANCE VARIABLE INHERITANCE
1447
1448 =item OBJECT RELATIONSHIPS
1449
1450 =item OVERRIDING SUPERCLASS METHODS
1451
1452 =item USING RELATIONSHIP WITH SDBM
1453
1454 =item THINKING OF CODE REUSE
1455
1456 =item CLASS CONTEXT AND THE OBJECT
1457
1458 =item INHERITING A CONSTRUCTOR
1459
1460 =item DELEGATION
1461
1462 =back
1463
1464 =head2 perltie - how to hide an object class in a simple variable
1465
1466 =over 4
1467
1468 =item SYNOPSIS
1469
1470 =item DESCRIPTION
1471
1472 =over 4
1473
1474 =item Tying Scalars
1475
1476 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1477 DESTROY this
1478
1479 =item Tying Arrays
1480
1481 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1482 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1483 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1484 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1485 this
1486
1487 =item Tying Hashes
1488
1489 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1490 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1491 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1492
1493 =item Tying FileHandles
1494
1495 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1496 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1497 DESTROY this
1498
1499 =item UNTIE this
1500
1501 =item The C<untie> Gotcha
1502
1503 =back
1504
1505 =item SEE ALSO
1506
1507 =item BUGS
1508
1509 =item AUTHOR
1510
1511 =back
1512
1513 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1514 safe subprocesses, sockets, and semaphores)
1515
1516 =over 4
1517
1518 =item DESCRIPTION
1519
1520 =item Signals
1521
1522 =item Named Pipes
1523
1524 =over 4
1525
1526 =item WARNING
1527
1528 =back
1529
1530 =item Using open() for IPC
1531
1532 =over 4
1533
1534 =item Filehandles
1535
1536 =item Background Processes
1537
1538 =item Complete Dissociation of Child from Parent
1539
1540 =item Safe Pipe Opens
1541
1542 =item Bidirectional Communication with Another Process
1543
1544 =item Bidirectional Communication with Yourself
1545
1546 =back
1547
1548 =item Sockets: Client/Server Communication
1549
1550 =over 4
1551
1552 =item Internet Line Terminators
1553
1554 =item Internet TCP Clients and Servers
1555
1556 =item Unix-Domain TCP Clients and Servers
1557
1558 =back
1559
1560 =item TCP Clients with IO::Socket
1561
1562 =over 4
1563
1564 =item A Simple Client
1565
1566 C<Proto>, C<PeerAddr>, C<PeerPort>
1567
1568 =item A Webget Client
1569
1570 =item Interactive Client with IO::Socket
1571
1572 =back
1573
1574 =item TCP Servers with IO::Socket
1575
1576 Proto, LocalPort, Listen, Reuse
1577
1578 =item UDP: Message Passing
1579
1580 =item SysV IPC
1581
1582 =item NOTES
1583
1584 =item BUGS
1585
1586 =item AUTHOR
1587
1588 =item SEE ALSO
1589
1590 =back
1591
1592 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1593
1594 =over 4
1595
1596 =item SYNOPSIS
1597
1598 =item DESCRIPTION
1599
1600 =over 4
1601
1602 =item Behavior of other Perl features in forked pseudo-processes
1603
1604 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1605 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1606 files, directories and network sockets
1607
1608 =item Resource limits
1609
1610 =item Killing the parent process
1611
1612 =item Lifetime of the parent process and pseudo-processes
1613
1614 =item CAVEATS AND LIMITATIONS
1615
1616 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1617 Global state maintained by XSUBs, Interpreter embedded in larger
1618 application, Thread-safety of extensions
1619
1620 =back
1621
1622 =item BUGS
1623
1624 =item AUTHOR
1625
1626 =item SEE ALSO
1627
1628 =back
1629
1630 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1631
1632 =over 4
1633
1634 =item SYNOPSIS
1635
1636 =item DESCRIPTION
1637
1638 =item Storing numbers
1639
1640 =item Numeric operators and numeric conversions
1641
1642 =item Flavors of Perl numeric operations
1643
1644 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1645 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1646 integer>, Operators which expect an integer, Operators which expect a
1647 string
1648
1649 =item AUTHOR
1650
1651 =item SEE ALSO
1652
1653 =back
1654
1655 =head2 perlthrtut - tutorial on threads in Perl
1656
1657 =over 4
1658
1659 =item DESCRIPTION
1660
1661 =back
1662
1663 =head2 perlothrtut - old tutorial on threads in Perl
1664
1665 =over 4
1666
1667 =item DESCRIPTION
1668
1669 =item What Is A Thread Anyway?
1670
1671 =item Threaded Program Models
1672
1673 =over 4
1674
1675 =item Boss/Worker
1676
1677 =item Work Crew
1678
1679 =item Pipeline
1680
1681 =back
1682
1683 =item Native threads
1684
1685 =item What kind of threads are perl threads?
1686
1687 =item Threadsafe Modules
1688
1689 =item Thread Basics
1690
1691 =over 4
1692
1693 =item Basic Thread Support
1694
1695 =item Creating Threads
1696
1697 =item Giving up control
1698
1699 =item Waiting For A Thread To Exit
1700
1701 =item Errors In Threads
1702
1703 =item Ignoring A Thread
1704
1705 =back
1706
1707 =item Threads And Data
1708
1709 =over 4
1710
1711 =item Shared And Unshared Data
1712
1713 =item Thread Pitfall: Races
1714
1715 =item Controlling access: lock()
1716
1717 =item Thread Pitfall: Deadlocks
1718
1719 =item Queues: Passing Data Around
1720
1721 =back
1722
1723 =item Threads And Code
1724
1725 =over 4
1726
1727 =item Semaphores: Synchronizing Data Access
1728
1729 Basic semaphores, Advanced Semaphores
1730
1731 =item Attributes: Restricting Access To Subroutines
1732
1733 =item Subroutine Locks
1734
1735 =item Methods
1736
1737 =item Locking A Subroutine
1738
1739 =back
1740
1741 =item General Thread Utility Routines
1742
1743 =over 4
1744
1745 =item What Thread Am I In?
1746
1747 =item Thread IDs
1748
1749 =item Are These Threads The Same?
1750
1751 =item What Threads Are Running?
1752
1753 =back
1754
1755 =item A Complete Example
1756
1757 =item Conclusion
1758
1759 =item Bibliography
1760
1761 =over 4
1762
1763 =item Introductory Texts
1764
1765 =item OS-Related References
1766
1767 =item Other References
1768
1769 =back
1770
1771 =item Acknowledgements
1772
1773 =item AUTHOR
1774
1775 =item Copyrights
1776
1777 =back
1778
1779 =head2 perlport - Writing portable Perl
1780
1781 =over 4
1782
1783 =item DESCRIPTION
1784
1785 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
1786 portable
1787
1788 =item ISSUES
1789
1790 =over 4
1791
1792 =item Newlines
1793
1794 =item Numbers endianness and Width
1795
1796 =item Files and Filesystems
1797
1798 =item System Interaction
1799
1800 =item Interprocess Communication (IPC)
1801
1802 =item External Subroutines (XS)
1803
1804 =item Standard Modules
1805
1806 =item Time and Date
1807
1808 =item Character sets and character encoding
1809
1810 =item Internationalisation
1811
1812 =item System Resources
1813
1814 =item Security
1815
1816 =item Style
1817
1818 =back
1819
1820 =item CPAN Testers
1821
1822 Mailing list: cpan-testers@perl.org, Testing results:
1823 http://testers.cpan.org/
1824
1825 =item PLATFORMS
1826
1827 =over 4
1828
1829 =item Unix
1830
1831 =item DOS and Derivatives
1832
1833 =item S<Mac OS>
1834
1835 =item VMS
1836
1837 =item VOS
1838
1839 =item EBCDIC Platforms
1840
1841 =item Acorn RISC OS
1842
1843 =item Other perls
1844
1845 =back
1846
1847 =item FUNCTION IMPLEMENTATIONS
1848
1849 =over 4
1850
1851 =item Alphabetical Listing of Perl Functions
1852
1853 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
1854 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
1855 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
1856 LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
1857 getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
1858 getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
1859 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
1860 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
1861 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
1862 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
1863 endprotoent, endservent, exit EXPR, exit, getsockopt SOCKET,LEVEL,OPTNAME,
1864 glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
1865 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
1866 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
1867 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
1868 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
1869 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
1870 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
1871 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
1872 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
1873 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
1874 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1875 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
1876 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
1877 wait, waitpid PID,FLAGS
1878
1879 =back
1880
1881 =item CHANGES
1882
1883 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
1884 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
1885 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
1886 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
1887 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
1888 v1.30, 03 August 1998, v1.23, 10 July 1998
1889
1890 =item Supported Platforms
1891
1892 =item SEE ALSO
1893
1894 =item AUTHORS / CONTRIBUTORS
1895
1896 =item VERSION
1897
1898 =back
1899
1900 =head2 perllocale - Perl locale handling (internationalization and
1901 localization)
1902
1903 =over 4
1904
1905 =item DESCRIPTION
1906
1907 =item PREPARING TO USE LOCALES
1908
1909 =item USING LOCALES
1910
1911 =over 4
1912
1913 =item The use locale pragma
1914
1915 =item The setlocale function
1916
1917 =item Finding locales
1918
1919 =item LOCALE PROBLEMS
1920
1921 =item Temporarily fixing locale problems
1922
1923 =item Permanently fixing locale problems
1924
1925 =item Permanently fixing your system's locale configuration
1926
1927 =item Fixing system locale configuration
1928
1929 =item The localeconv function
1930
1931 =item I18N::Langinfo
1932
1933 =back
1934
1935 =item LOCALE CATEGORIES
1936
1937 =over 4
1938
1939 =item Category LC_COLLATE: Collation
1940
1941 =item Category LC_CTYPE: Character Types
1942
1943 =item Category LC_NUMERIC: Numeric Formatting
1944
1945 =item Category LC_MONETARY: Formatting of monetary amounts
1946
1947 =item LC_TIME
1948
1949 =item Other categories
1950
1951 =back
1952
1953 =item SECURITY
1954
1955 =item ENVIRONMENT
1956
1957 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
1958 LC_NUMERIC, LC_TIME, LANG
1959
1960 =item NOTES
1961
1962 =over 4
1963
1964 =item Backward compatibility
1965
1966 =item I18N:Collate obsolete
1967
1968 =item Sort speed and memory use impacts
1969
1970 =item write() and LC_NUMERIC
1971
1972 =item Freely available locale definitions
1973
1974 =item I18n and l10n
1975
1976 =item An imperfect standard
1977
1978 =back
1979
1980 =item BUGS
1981
1982 =over 4
1983
1984 =item Broken systems
1985
1986 =back
1987
1988 =item SEE ALSO
1989
1990 =item HISTORY
1991
1992 =back
1993
1994 =head2 perlunicode - Unicode support in Perl
1995
1996 =over 4
1997
1998 =item DESCRIPTION
1999
2000 =over 4
2001
2002 =item Important Caveats
2003
2004 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2005 to enable UTF-8/UTF-EBCDIC in scripts
2006
2007 =item Byte and Character semantics
2008
2009 =item Effects of character semantics
2010
2011 =item Scripts
2012
2013 =item Blocks
2014
2015 =item Character encodings for input and output
2016
2017 =back
2018
2019 =item CAVEATS
2020
2021 =item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
2022
2023 =item SEE ALSO
2024
2025 =back
2026
2027 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2028
2029 =over 4
2030
2031 =item DESCRIPTION
2032
2033 =item COMMON CHARACTER CODE SETS
2034
2035 =over 4
2036
2037 =item ASCII
2038
2039 =item ISO 8859
2040
2041 =item Latin 1 (ISO 8859-1)
2042
2043 =item EBCDIC
2044
2045 =item 13 variant characters
2046
2047 =item 0037
2048
2049 =item 1047
2050
2051 =item POSIX-BC
2052
2053 =item Unicode and UTF
2054
2055 =back
2056
2057 =item SINGLE OCTET TABLES
2058
2059 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2060
2061 =item IDENTIFYING CHARACTER CODE SETS
2062
2063 =item CONVERSIONS
2064
2065 =over 4
2066
2067 =item tr///
2068
2069 =item iconv
2070
2071 =item C RTL
2072
2073 =back
2074
2075 =item OPERATOR DIFFERENCES
2076
2077 =item FUNCTION DIFFERENCES
2078
2079 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2080
2081 =item REGULAR EXPRESSION DIFFERENCES
2082
2083 =item SOCKETS
2084
2085 =item SORTING
2086
2087 =over 4
2088
2089 =item Ignore ASCII vs. EBCDIC sort differences.
2090
2091 =item MONO CASE then sort data.
2092
2093 =item Convert, sort data, then re convert.
2094
2095 =item Perform sorting on one type of machine only.
2096
2097 =back
2098
2099 =item TRANSFORMATION FORMATS
2100
2101 =over 4
2102
2103 =item URL decoding and encoding
2104
2105 =item uu encoding and decoding
2106
2107 =item Quoted-Printable encoding and decoding
2108
2109 =item Caesarian ciphers
2110
2111 =back
2112
2113 =item Hashing order and checksums
2114
2115 =item I18N AND L10N
2116
2117 =item MULTI OCTET CHARACTER SETS
2118
2119 =item OS ISSUES
2120
2121 =over 4
2122
2123 =item OS/400
2124
2125 IFS access
2126
2127 =item OS/390, z/OS
2128
2129 chcp, dataset access, OS/390, z/OS iconv, locales
2130
2131 =item VM/ESA?
2132
2133 =item POSIX-BC?
2134
2135 =back
2136
2137 =item BUGS
2138
2139 =item SEE ALSO
2140
2141 =item REFERENCES
2142
2143 =item HISTORY
2144
2145 =item AUTHOR
2146
2147 =back
2148
2149 =head2 perlsec - Perl security
2150
2151 =over 4
2152
2153 =item DESCRIPTION
2154
2155 =over 4
2156
2157 =item Laundering and Detecting Tainted Data
2158
2159 =item Switches On the "#!" Line
2160
2161 =item Cleaning Up Your Path
2162
2163 =item Security Bugs
2164
2165 =item Protecting Your Programs
2166
2167 =back
2168
2169 =item SEE ALSO
2170
2171 =back
2172
2173 =head2 perlmod - Perl modules (packages and symbol tables)
2174
2175 =over 4
2176
2177 =item DESCRIPTION
2178
2179 =over 4
2180
2181 =item Packages
2182
2183 =item Symbol Tables
2184
2185 =item Package Constructors and Destructors
2186
2187 =item Perl Classes
2188
2189 =item Perl Modules
2190
2191 =item Making your module threadsafe
2192
2193 =back
2194
2195 =item SEE ALSO
2196
2197 =back
2198
2199 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2200
2201 =over 4
2202
2203 =item DESCRIPTION
2204
2205 =item THE PERL MODULE LIBRARY
2206
2207 =over 4
2208
2209 =item Pragmatic Modules
2210
2211 attributes, attrs, autouse, base, blib, bytes, charnames, constant,
2212 diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
2213 re, sigtrap, strict, subs, threads, utf8, vars, warnings,
2214 warnings::register
2215
2216 =item Standard Modules
2217
2218 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2219 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2220 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2221 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2222 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2223 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2224 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2225 Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
2226 Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
2227 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2228 ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
2229 ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
2230 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2231 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2232 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2233 File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
2234 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2235 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2236 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
2237 I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
2238 Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country,
2239 Locale::Currency, Locale::Language, Locale::Maketext,
2240 Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2241 Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2242 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2243 Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
2244 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2245 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2246 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2247 PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
2248 Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
2249 Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
2250 Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
2251 Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap,
2252 Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
2253 Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2254 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array,
2255 Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
2256 Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
2257 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
2258 User::pwent, Win32
2259
2260 =item Extension Modules
2261
2262 =back
2263
2264 =item CPAN
2265
2266 =over 4
2267
2268 =item Africa
2269
2270 =item Asia
2271
2272 =item Central America
2273
2274 =item Europe
2275
2276 =item North America
2277
2278 =item Oceania
2279
2280 =item South America
2281
2282 =back
2283
2284 =item Modules: Creation, Use, and Abuse
2285
2286 =over 4
2287
2288 =item Guidelines for Module Creation
2289
2290 Adding a Copyright Notice
2291
2292 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2293
2294 =item Guidelines for Reusing Application Code
2295
2296 =back
2297
2298 =item NOTE
2299
2300 =back
2301
2302 =head2 perlmodinstall - Installing CPAN Modules
2303
2304 =over 4
2305
2306 =item DESCRIPTION
2307
2308 =over 4
2309
2310 =item PREAMBLE
2311
2312 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2313 module (sometimes unnecessary), B<INSTALL> the module
2314
2315 =back
2316
2317 =item PORTABILITY
2318
2319 =item HEY
2320
2321 =item AUTHOR
2322
2323 =item COPYRIGHT
2324
2325 =back
2326
2327 =head2 perlnewmod - preparing a new module for distribution
2328
2329 =over 4
2330
2331 =item DESCRIPTION
2332
2333 =over 4
2334
2335 =item Warning
2336
2337 =item What should I make into a module?
2338
2339 =item Step-by-step: Preparing the ground
2340
2341 Look around, Check it's new, Discuss the need, Choose a name, Check again
2342
2343 =item Step-by-step: Making the module
2344
2345 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2346 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2347 documentation|perlpod>, Write tests, Write the README
2348
2349 =item Step-by-step: Distributing your module
2350
2351 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2352 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2353
2354 =back
2355
2356 =item AUTHOR
2357
2358 =item SEE ALSO
2359
2360 =back
2361
2362 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.1 $, $Date:
2363 2001/09/20 03:03:00 $)
2364
2365 =over 4
2366
2367 =item DESCRIPTION
2368
2369 =over 4
2370
2371 =item What is Perl?
2372
2373 =item Who supports Perl?  Who develops it?  Why is it free?
2374
2375 =item Which version of Perl should I use?
2376
2377 =item What are perl4 and perl5?
2378
2379 =item What is perl6?
2380
2381 =item How stable is Perl?
2382
2383 =item Is Perl difficult to learn?
2384
2385 =item How does Perl compare with other languages like Java, Python, REXX,
2386 Scheme, or Tcl?
2387
2388 =item Can I do [task] in Perl?
2389
2390 =item When shouldn't I program in Perl?
2391
2392 =item What's the difference between "perl" and "Perl"?
2393
2394 =item Is it a Perl program or a Perl script?
2395
2396 =item What is a JAPH?
2397
2398 =item Where can I get a list of Larry Wall witticisms?
2399
2400 =item How can I convince my sysadmin/supervisor/employees to use version
2401 5/5.005/Perl instead of some other language?
2402
2403 =back
2404
2405 =item AUTHOR AND COPYRIGHT
2406
2407 =back
2408
2409 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.1 $,
2410 $Date: 2001/09/20 03:03:00 $)
2411
2412 =over 4
2413
2414 =item DESCRIPTION
2415
2416 =over 4
2417
2418 =item What machines support Perl?  Where do I get it?
2419
2420 =item How can I get a binary version of Perl?
2421
2422 =item I don't have a C compiler on my system.  How can I compile perl?
2423
2424 =item I copied the Perl binary from one machine to another, but scripts
2425 don't work.
2426
2427 =item I grabbed the sources and tried to compile but gdbm/dynamic
2428 loading/malloc/linking/... failed.  How do I make it work?
2429
2430 =item What modules and extensions are available for Perl?  What is CPAN?
2431 What does CPAN/src/... mean?
2432
2433 =item Is there an ISO or ANSI certified version of Perl?
2434
2435 =item Where can I get information on Perl?
2436
2437 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2438
2439 =item Where should I post source code?
2440
2441 =item Perl Books
2442
2443 References, Tutorials, Task-Oriented, Special Topics
2444
2445 =item Perl in Magazines
2446
2447 =item Perl on the Net: FTP and WWW Access
2448
2449 =item What mailing lists are there for Perl?
2450
2451 =item Archives of comp.lang.perl.misc
2452
2453 =item Where can I buy a commercial version of Perl?
2454
2455 =item Where do I send bug reports?
2456
2457 =item What is perl.com? Perl Mongers? pm.org? perl.org?
2458
2459 =back
2460
2461 =item AUTHOR AND COPYRIGHT
2462
2463 =back
2464
2465 =head2 perlfaq3 - Programming Tools ($Revision: 1.1 $, $Date: 2001/09/20
2466 03:03:00 $)
2467
2468 =over 4
2469
2470 =item DESCRIPTION
2471
2472 =over 4
2473
2474 =item How do I do (anything)?
2475
2476 =item How can I use Perl interactively?
2477
2478 =item Is there a Perl shell?
2479
2480 =item How do I debug my Perl programs?
2481
2482 =item How do I profile my Perl programs?
2483
2484 =item How do I cross-reference my Perl programs?
2485
2486 =item Is there a pretty-printer (formatter) for Perl?
2487
2488 =item Is there a ctags for Perl?
2489
2490 =item Is there an IDE or Windows Perl Editor?
2491
2492 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
2493 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2494 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2495
2496 =item Where can I get Perl macros for vi?
2497
2498 =item Where can I get perl-mode for emacs?
2499
2500 =item How can I use curses with Perl?
2501
2502 =item How can I use X or Tk with Perl?
2503
2504 =item How can I generate simple menus without using CGI or Tk?
2505
2506 =item What is undump?
2507
2508 =item How can I make my Perl program run faster?
2509
2510 =item How can I make my Perl program take less memory?
2511
2512 =item Is it unsafe to return a pointer to local data?
2513
2514 =item How can I free an array or hash so my program shrinks?
2515
2516 =item How can I make my CGI script more efficient?
2517
2518 =item How can I hide the source for my Perl program?
2519
2520 =item How can I compile my Perl program into byte code or C?
2521
2522 =item How can I compile Perl into Java?
2523
2524 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
2525
2526 =item Can I write useful Perl programs on the command line?
2527
2528 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
2529
2530 =item Where can I learn about CGI or Web programming in Perl?
2531
2532 =item Where can I learn about object-oriented Perl programming?
2533
2534 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
2535
2536 =item I've read perlembed, perlguts, etc., but I can't embed perl in
2537 my C program; what am I doing wrong?
2538
2539 =item When I tried to run my script, I got this message. What does it
2540 mean?
2541
2542 =item What's MakeMaker?
2543
2544 =back
2545
2546 =item AUTHOR AND COPYRIGHT
2547
2548 =back
2549
2550 =head2 perlfaq4 - Data Manipulation ($Revision: 1.1 $, $Date: 2001/09/20
2551 03:03:00 $)
2552
2553 =over 4
2554
2555 =item DESCRIPTION
2556
2557 =item Data: Numbers
2558
2559 =over 4
2560
2561 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
2562 numbers I should be getting (eg, 19.95)?
2563
2564 =item Why isn't my octal data interpreted correctly?
2565
2566 =item Does Perl have a round() function?  What about ceil() and floor()?
2567 Trig functions?
2568
2569 =item How do I convert bits into ints?
2570
2571 =item Why doesn't & work the way I want it to?
2572
2573 =item How do I multiply matrices?
2574
2575 =item How do I perform an operation on a series of integers?
2576
2577 =item How can I output Roman numerals?
2578
2579 =item Why aren't my random numbers random?
2580
2581 =back
2582
2583 =item Data: Dates
2584
2585 =over 4
2586
2587 =item How do I find the week-of-the-year/day-of-the-year?
2588
2589 =item How do I find the current century or millennium?
2590
2591 =item How can I compare two dates and find the difference?
2592
2593 =item How can I take a string and turn it into epoch seconds?
2594
2595 =item How can I find the Julian Day?
2596
2597 =item How do I find yesterday's date?
2598
2599 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
2600
2601 =back
2602
2603 =item Data: Strings
2604
2605 =over 4
2606
2607 =item How do I validate input?
2608
2609 =item How do I unescape a string?
2610
2611 =item How do I remove consecutive pairs of characters?
2612
2613 =item How do I expand function calls in a string?
2614
2615 =item How do I find matching/nesting anything?
2616
2617 =item How do I reverse a string?
2618
2619 =item How do I expand tabs in a string?
2620
2621 =item How do I reformat a paragraph?
2622
2623 =item How can I access/change the first N letters of a string?
2624
2625 =item How do I change the Nth occurrence of something?
2626
2627 =item How can I count the number of occurrences of a substring within a
2628 string?
2629
2630 =item How do I capitalize all the words on one line?
2631
2632 =item How can I split a [character] delimited string except when inside
2633 [character]? (Comma-separated files)
2634
2635 =item How do I strip blank space from the beginning/end of a string?
2636
2637 =item How do I pad a string with blanks or pad a number with zeroes?
2638
2639 =item How do I extract selected columns from a string?
2640
2641 =item How do I find the soundex value of a string?
2642
2643 =item How can I expand variables in text strings?
2644
2645 =item What's wrong with always quoting "$vars"?
2646
2647 =item Why don't my <<HERE documents work?
2648
2649 1. There must be no space after the << part, 2. There (probably) should be
2650 a semicolon at the end, 3. You can't (easily) have any space in front of
2651 the tag
2652
2653 =back
2654
2655 =item Data: Arrays
2656
2657 =over 4
2658
2659 =item What is the difference between a list and an array?
2660
2661 =item What is the difference between $array[1] and @array[1]?
2662
2663 =item How can I remove duplicate elements from a list or array?
2664
2665 a), b), c), d), e)
2666
2667 =item How can I tell whether a certain element is contained in a list or
2668 array?
2669
2670 =item How do I compute the difference of two arrays?  How do I compute the
2671 intersection of two arrays?
2672
2673 =item How do I test whether two arrays or hashes are equal?
2674
2675 =item How do I find the first array element for which a condition is true?
2676
2677 =item How do I handle linked lists?
2678
2679 =item How do I handle circular lists?
2680
2681 =item How do I shuffle an array randomly?
2682
2683 =item How do I process/modify each element of an array?
2684
2685 =item How do I select a random element from an array?
2686
2687 =item How do I permute N elements of a list?
2688
2689 =item How do I sort an array by (anything)?
2690
2691 =item How do I manipulate arrays of bits?
2692
2693 =item Why does defined() return true on empty arrays and hashes?
2694
2695 =back
2696
2697 =item Data: Hashes (Associative Arrays)
2698
2699 =over 4
2700
2701 =item How do I process an entire hash?
2702
2703 =item What happens if I add or remove keys from a hash while iterating over
2704 it?
2705
2706 =item How do I look up a hash element by value?
2707
2708 =item How can I know how many entries are in a hash?
2709
2710 =item How do I sort a hash (optionally by value instead of key)?
2711
2712 =item How can I always keep my hash sorted?
2713
2714 =item What's the difference between "delete" and "undef" with hashes?
2715
2716 =item Why don't my tied hashes make the defined/exists distinction?
2717
2718 =item How do I reset an each() operation part-way through?
2719
2720 =item How can I get the unique keys from two hashes?
2721
2722 =item How can I store a multidimensional array in a DBM file?
2723
2724 =item How can I make my hash remember the order I put elements into it?
2725
2726 =item Why does passing a subroutine an undefined element in a hash create
2727 it?
2728
2729 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
2730 array of hashes or arrays?
2731
2732 =item How can I use a reference as a hash key?
2733
2734 =back
2735
2736 =item Data: Misc
2737
2738 =over 4
2739
2740 =item How do I handle binary data correctly?
2741
2742 =item How do I determine whether a scalar is a number/whole/integer/float?
2743
2744 =item How do I keep persistent data across program calls?
2745
2746 =item How do I print out or copy a recursive data structure?
2747
2748 =item How do I define methods for every class/object?
2749
2750 =item How do I verify a credit card checksum?
2751
2752 =item How do I pack arrays of doubles or floats for XS code?
2753
2754 =back
2755
2756 =item AUTHOR AND COPYRIGHT
2757
2758 =back
2759
2760 =head2 perlfaq5 - Files and Formats ($Revision: 1.1 $, $Date: 2001/09/20
2761 03:03:00 $)
2762
2763 =over 4
2764
2765 =item DESCRIPTION
2766
2767 =over 4
2768
2769 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
2770
2771 =item How do I change one line in a file/delete a line in a file/insert a
2772 line in the middle of a file/append to the beginning of a file?
2773
2774 =item How do I count the number of lines in a file?
2775
2776 =item How do I make a temporary file name?
2777
2778 =item How can I manipulate fixed-record-length files?
2779
2780 =item How can I make a filehandle local to a subroutine?  How do I pass
2781 filehandles between subroutines?  How do I make an array of filehandles?
2782
2783 =item How can I use a filehandle indirectly?
2784
2785 =item How can I set up a footer format to be used with write()?
2786
2787 =item How can I write() into a string?
2788
2789 =item How can I output my numbers with commas added?
2790
2791 =item How can I translate tildes (~) in a filename?
2792
2793 =item How come when I open a file read-write it wipes it out?
2794
2795 =item Why do I sometimes get an "Argument list too long" when I use <*>?
2796
2797 =item Is there a leak/bug in glob()?
2798
2799 =item How can I open a file with a leading ">" or trailing blanks?
2800
2801 =item How can I reliably rename a file?
2802
2803 =item How can I lock a file?
2804
2805 =item Why can't I just open(FH, ">file.lock")?
2806
2807 =item I still don't get locking.  I just want to increment the number in
2808 the file.  How can I do this?
2809
2810 =item All I want to do is append a small amount of text to the end of a
2811 file.  Do I still have to use locking?
2812
2813 =item How do I randomly update a binary file?
2814
2815 =item How do I get a file's timestamp in perl?
2816
2817 =item How do I set a file's timestamp in perl?
2818
2819 =item How do I print to more than one file at once?
2820
2821 =item How can I read in an entire file all at once?
2822
2823 =item How can I read in a file by paragraphs?
2824
2825 =item How can I read a single character from a file?  From the keyboard?
2826
2827 =item How can I tell whether there's a character waiting on a filehandle?
2828
2829 =item How do I do a C<tail -f> in perl?
2830
2831 =item How do I dup() a filehandle in Perl?
2832
2833 =item How do I close a file descriptor by number?
2834
2835 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
2836 `C:\temp\foo.exe` work?
2837
2838 =item Why doesn't glob("*.*") get all the files?
2839
2840 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
2841 protected files?  Isn't this a bug in Perl?
2842
2843 =item How do I select a random line from a file?
2844
2845 =item Why do I get weird spaces when I print an array of lines?
2846
2847 =back
2848
2849 =item AUTHOR AND COPYRIGHT
2850
2851 =back
2852
2853 =head2 perlfaq6 - Regexes ($Revision: 1.1 $, $Date: 2001/09/20 03:03:00 $)
2854
2855 =over 4
2856
2857 =item DESCRIPTION
2858
2859 =over 4
2860
2861 =item How can I hope to use regular expressions without creating illegible
2862 and unmaintainable code?
2863
2864 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
2865
2866 =item I'm having trouble matching over more than one line.  What's wrong?
2867
2868 =item How can I pull out lines between two patterns that are themselves on
2869 different lines?
2870
2871 =item I put a regular expression into $/ but it didn't work. What's wrong?
2872
2873 =item How do I substitute case insensitively on the LHS while preserving
2874 case on the RHS?
2875
2876 =item How can I make C<\w> match national character sets?
2877
2878 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
2879
2880 =item How can I quote a variable to use in a regex?
2881
2882 =item What is C</o> really for?
2883
2884 =item How do I use a regular expression to strip C style comments from a
2885 file?
2886
2887 =item Can I use Perl regular expressions to match balanced text?
2888
2889 =item What does it mean that regexes are greedy?  How can I get around it?
2890
2891 =item How do I process each word on each line?
2892
2893 =item How can I print out a word-frequency or line-frequency summary?
2894
2895 =item How can I do approximate matching?
2896
2897 =item How do I efficiently match many regular expressions at once?
2898
2899 =item Why don't word-boundary searches with C<\b> work for me?
2900
2901 =item Why does using $&, $`, or $' slow my program down?
2902
2903 =item What good is C<\G> in a regular expression?
2904
2905 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
2906
2907 =item What's wrong with using grep or map in a void context?
2908
2909 =item How can I match strings with multibyte characters?
2910
2911 =item How do I match a pattern that is supplied by the user?
2912
2913 =back
2914
2915 =item AUTHOR AND COPYRIGHT
2916
2917 =back
2918
2919 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.1 $, $Date: 2001/09/20
2920 03:03:00 $)
2921
2922 =over 4
2923
2924 =item DESCRIPTION
2925
2926 =over 4
2927
2928 =item Can I get a BNF/yacc/RE for the Perl language?
2929
2930 =item What are all these $@%&* punctuation signs, and how do I know when to
2931 use them?
2932
2933 =item Do I always/never have to quote my strings or use semicolons and
2934 commas?
2935
2936 =item How do I skip some return values?
2937
2938 =item How do I temporarily block warnings?
2939
2940 =item What's an extension?
2941
2942 =item Why do Perl operators have different precedence than C operators?
2943
2944 =item How do I declare/create a structure?
2945
2946 =item How do I create a module?
2947
2948 =item How do I create a class?
2949
2950 =item How can I tell if a variable is tainted?
2951
2952 =item What's a closure?
2953
2954 =item What is variable suicide and how can I prevent it?
2955
2956 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
2957 Regex}?
2958
2959 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
2960 Passing Methods
2961
2962 =item How do I create a static variable?
2963
2964 =item What's the difference between dynamic and lexical (static) scoping?
2965 Between local() and my()?
2966
2967 =item How can I access a dynamic variable while a similarly named lexical
2968 is in scope?
2969
2970 =item What's the difference between deep and shallow binding?
2971
2972 =item Why doesn't "my($foo) = <FILE>;" work right?
2973
2974 =item How do I redefine a builtin function, operator, or method?
2975
2976 =item What's the difference between calling a function as &foo and foo()?
2977
2978 =item How do I create a switch or case statement?
2979
2980 =item How can I catch accesses to undefined variables/functions/methods?
2981
2982 =item Why can't a method included in this same file be found?
2983
2984 =item How can I find out my current package?
2985
2986 =item How can I comment out a large block of perl code?
2987
2988 =item How do I clear a package?
2989
2990 =item How can I use a variable as a variable name?
2991
2992 =back
2993
2994 =item AUTHOR AND COPYRIGHT
2995
2996 =back
2997
2998 =head2 perlfaq8 - System Interaction ($Revision: 1.1 $, $Date: 2001/09/20
2999 03:03:00 $)
3000
3001 =over 4
3002
3003 =item DESCRIPTION
3004
3005 =over 4
3006
3007 =item How do I find out which operating system I'm running under?
3008
3009 =item How come exec() doesn't return?
3010
3011 =item How do I do fancy stuff with the keyboard/screen/mouse?
3012
3013 Keyboard, Screen, Mouse
3014
3015 =item How do I print something out in color?
3016
3017 =item How do I read just one key without waiting for a return key?
3018
3019 =item How do I check whether input is ready on the keyboard?
3020
3021 =item How do I clear the screen?
3022
3023 =item How do I get the screen size?
3024
3025 =item How do I ask the user for a password?
3026
3027 =item How do I read and write the serial port?
3028
3029 lockfiles, open mode, end of line, flushing output, non-blocking input
3030
3031 =item How do I decode encrypted password files?
3032
3033 =item How do I start a process in the background?
3034
3035 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3036
3037 =item How do I trap control characters/signals?
3038
3039 =item How do I modify the shadow password file on a Unix system?
3040
3041 =item How do I set the time and date?
3042
3043 =item How can I sleep() or alarm() for under a second?
3044
3045 =item How can I measure time under a second?
3046
3047 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3048
3049 =item Why doesn't my sockets program work under System V (Solaris)?  What
3050 does the error message "Protocol not supported" mean?
3051
3052 =item How can I call my system's unique C functions from Perl?
3053
3054 =item Where do I get the include files to do ioctl() or syscall()?
3055
3056 =item Why do setuid perl scripts complain about kernel problems?
3057
3058 =item How can I open a pipe both to and from a command?
3059
3060 =item Why can't I get the output of a command with system()?
3061
3062 =item How can I capture STDERR from an external command?
3063
3064 =item Why doesn't open() return an error when a pipe open fails?
3065
3066 =item What's wrong with using backticks in a void context?
3067
3068 =item How can I call backticks without shell processing?
3069
3070 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3071 ^Z on MS-DOS)?
3072
3073 =item How can I convert my shell script to perl?
3074
3075 =item Can I use perl to run a telnet or ftp session?
3076
3077 =item How can I write expect in Perl?
3078
3079 =item Is there a way to hide perl's command line from programs such as
3080 "ps"?
3081
3082 =item I {changed directory, modified my environment} in a perl script.  How
3083 come the change disappeared when I exited the script?  How do I get my
3084 changes to be visible?
3085
3086 Unix
3087
3088 =item How do I close a process's filehandle without waiting for it to
3089 complete?
3090
3091 =item How do I fork a daemon process?
3092
3093 =item How do I find out if I'm running interactively or not?
3094
3095 =item How do I timeout a slow event?
3096
3097 =item How do I set CPU limits?
3098
3099 =item How do I avoid zombies on a Unix system?
3100
3101 =item How do I use an SQL database?
3102
3103 =item How do I make a system() exit on control-C?
3104
3105 =item How do I open a file without blocking?
3106
3107 =item How do I install a module from CPAN?
3108
3109 =item What's the difference between require and use?
3110
3111 =item How do I keep my own module/library directory?
3112
3113 =item How do I add the directory my program lives in to the module/library
3114 search path?
3115
3116 =item How do I add a directory to my include path at runtime?
3117
3118 =item What is socket.ph and where do I get it?
3119
3120 =back
3121
3122 =item AUTHOR AND COPYRIGHT
3123
3124 =back
3125
3126 =head2 perlfaq9 - Networking ($Revision: 1.1 $, $Date: 2001/09/20 03:03:00
3127 $)
3128
3129 =over 4
3130
3131 =item DESCRIPTION
3132
3133 =over 4
3134
3135 =item My CGI script runs from the command line but not the browser.  (500
3136 Server Error)
3137
3138 =item How can I get better error messages from a CGI program?
3139
3140 =item How do I remove HTML from a string?
3141
3142 =item How do I extract URLs?
3143
3144 =item How do I download a file from the user's machine?  How do I open a
3145 file on another machine?
3146
3147 =item How do I make a pop-up menu in HTML?
3148
3149 =item How do I fetch an HTML file?
3150
3151 =item How do I automate an HTML form submission?
3152
3153 =item How do I decode or create those %-encodings on the web?
3154
3155 =item How do I redirect to another page?
3156
3157 =item How do I put a password on my web pages?
3158
3159 =item How do I edit my .htpasswd and .htgroup files with Perl?
3160
3161 =item How do I make sure users can't enter values into a form that cause my
3162 CGI script to do bad things?
3163
3164 =item How do I parse a mail header?
3165
3166 =item How do I decode a CGI form?
3167
3168 =item How do I check a valid mail address?
3169
3170 =item How do I decode a MIME/BASE64 string?
3171
3172 =item How do I return the user's mail address?
3173
3174 =item How do I send mail?
3175
3176 =item How do I use MIME to make an attachment to a mail message?
3177
3178 =item How do I read mail?
3179
3180 =item How do I find out my hostname/domainname/IP address?
3181
3182 =item How do I fetch a news article or the active newsgroups?
3183
3184 =item How do I fetch/put an FTP file?
3185
3186 =item How can I do RPC in Perl?
3187
3188 =back
3189
3190 =item AUTHOR AND COPYRIGHT
3191
3192 =back
3193
3194 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3195
3196 =over 4
3197
3198 =item DESCRIPTION
3199
3200 =over 4
3201
3202 =item Layout
3203
3204 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3205
3206 =back
3207
3208 =item Using The Back Ends
3209
3210 =over 4
3211
3212 =item The Cross Referencing Back End
3213
3214 i, &, s, r
3215
3216 =item The Decompiling Back End
3217
3218 =item The Lint Back End
3219
3220 =item The Simple C Back End
3221
3222 =item The Bytecode Back End
3223
3224 =item The Optimized C Back End
3225
3226 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3227 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3228 B::Stash, B::Terse, B::Xref
3229
3230 =back
3231
3232 =item KNOWN PROBLEMS
3233
3234 =item AUTHOR
3235
3236 =back
3237
3238 =head2 perlembed - how to embed perl in your C program
3239
3240 =over 4
3241
3242 =item DESCRIPTION
3243
3244 =over 4
3245
3246 =item PREAMBLE
3247
3248 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3249 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3250
3251 =item ROADMAP
3252
3253 =item Compiling your C program
3254
3255 =item Adding a Perl interpreter to your C program
3256
3257 =item Calling a Perl subroutine from your C program
3258
3259 =item Evaluating a Perl statement from your C program
3260
3261 =item Performing Perl pattern matches and substitutions from your C program
3262
3263 =item Fiddling with the Perl stack from your C program
3264
3265 =item Maintaining a persistent interpreter
3266
3267 =item Execution of END blocks
3268
3269 =item Maintaining multiple interpreter instances
3270
3271 =item Using Perl modules, which themselves use C libraries, from your C
3272 program
3273
3274 =back
3275
3276 =item Embedding Perl under Win32
3277
3278 =item MORAL
3279
3280 =item AUTHOR
3281
3282 =item COPYRIGHT
3283
3284 =back
3285
3286 =head2 perldebguts - Guts of Perl debugging
3287
3288 =over 4
3289
3290 =item DESCRIPTION
3291
3292 =item Debugger Internals
3293
3294 =over 4
3295
3296 =item Writing Your Own Debugger
3297
3298 =back
3299
3300 =item Frame Listing Output Examples
3301
3302 =item Debugging regular expressions
3303
3304 =over 4
3305
3306 =item Compile-time output
3307
3308 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3309 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3310 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3311 C<anchored(TYPE)>
3312
3313 =item Types of nodes
3314
3315 =item Run-time output
3316
3317 =back
3318
3319 =item Debugging Perl memory usage
3320
3321 =over 4
3322
3323 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3324
3325 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3326 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3327 6144>
3328
3329 =item Example of using B<-DL> switch
3330
3331 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3332
3333 =item B<-DL> details
3334
3335 C<!!!>, C<!!>, C<!>
3336
3337 =item Limitations of B<-DL> statistics
3338
3339 =back
3340
3341 =item SEE ALSO
3342
3343 =back
3344
3345 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3346
3347 =over 4
3348
3349 =item DESCRIPTION
3350
3351 =item SPECIAL NOTES
3352
3353 =over 4
3354
3355 =item make
3356
3357 =item Version caveat
3358
3359 =item Dynamic Loading versus Static Loading
3360
3361 =back
3362
3363 =item TUTORIAL
3364
3365 =over 4
3366
3367 =item EXAMPLE 1
3368
3369 =item EXAMPLE 2
3370
3371 =item What has gone on?
3372
3373 =item Writing good test scripts
3374
3375 =item EXAMPLE 3
3376
3377 =item What's new here?
3378
3379 =item Input and Output Parameters
3380
3381 =item The XSUBPP Program
3382
3383 =item The TYPEMAP file
3384
3385 =item Warning about Output Arguments
3386
3387 =item EXAMPLE 4
3388
3389 =item What has happened here?
3390
3391 =item Anatomy of .xs file
3392
3393 =item Getting the fat out of XSUBs
3394
3395 =item More about XSUB arguments
3396
3397 =item The Argument Stack
3398
3399 =item Extending your Extension
3400
3401 =item Documenting your Extension
3402
3403 =item Installing your Extension
3404
3405 =item EXAMPLE 5
3406
3407 =item New Things in this Example
3408
3409 =item EXAMPLE 6
3410
3411 =item New Things in this Example
3412
3413 =item EXAMPLE 7 (Coming Soon)
3414
3415 =item EXAMPLE 8 (Coming Soon)
3416
3417 =item EXAMPLE 9 (Coming Soon)
3418
3419 =item Troubleshooting these Examples
3420
3421 =back
3422
3423 =item See also
3424
3425 =item Author
3426
3427 =over 4
3428
3429 =item Last Changed
3430
3431 =back
3432
3433 =back
3434
3435 =head2 perlxs - XS language reference manual
3436
3437 =over 4
3438
3439 =item DESCRIPTION
3440
3441 =over 4
3442
3443 =item Introduction
3444
3445 =item On The Road
3446
3447 =item The Anatomy of an XSUB
3448
3449 =item The Argument Stack
3450
3451 =item The RETVAL Variable
3452
3453 =item The MODULE Keyword
3454
3455 =item The PACKAGE Keyword
3456
3457 =item The PREFIX Keyword
3458
3459 =item The OUTPUT: Keyword
3460
3461 =item The NO_OUTPUT Keyword
3462
3463 =item The CODE: Keyword
3464
3465 =item The INIT: Keyword
3466
3467 =item The NO_INIT Keyword
3468
3469 =item Initializing Function Parameters
3470
3471 =item Default Parameter Values
3472
3473 =item The PREINIT: Keyword
3474
3475 =item The SCOPE: Keyword
3476
3477 =item The INPUT: Keyword
3478
3479 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3480
3481 =item Variable-length Parameter Lists
3482
3483 =item The C_ARGS: Keyword
3484
3485 =item The PPCODE: Keyword
3486
3487 =item Returning Undef And Empty Lists
3488
3489 =item The REQUIRE: Keyword
3490
3491 =item The CLEANUP: Keyword
3492
3493 =item The POSTCALL: Keyword
3494
3495 =item The BOOT: Keyword
3496
3497 =item The VERSIONCHECK: Keyword
3498
3499 =item The PROTOTYPES: Keyword
3500
3501 =item The PROTOTYPE: Keyword
3502
3503 =item The ALIAS: Keyword
3504
3505 =item The INTERFACE: Keyword
3506
3507 =item The INTERFACE_MACRO: Keyword
3508
3509 =item The INCLUDE: Keyword
3510
3511 =item The CASE: Keyword
3512
3513 =item The & Unary Operator
3514
3515 =item Inserting POD, Comments and C Preprocessor Directives
3516
3517 =item Using XS With C++
3518
3519 =item Interface Strategy
3520
3521 =item Perl Objects And C Structures
3522
3523 =item The Typemap
3524
3525 =back
3526
3527 =item EXAMPLES
3528
3529 =item XS VERSION
3530
3531 =item AUTHOR
3532
3533 =back
3534
3535 =head2 perlclib - Internal replacements for standard C library functions
3536
3537 =over 4
3538
3539 =item DESCRIPTION
3540
3541 =over 4
3542
3543 =item Conventions
3544
3545 C<t>, C<p>, C<n>, C<s>
3546
3547 =item File Operations
3548
3549 =item File Input and Output
3550
3551 =item File Positioning
3552
3553 =item Memory Management and String Handling
3554
3555 =item Character Class Tests
3556
3557 =item F<stdlib.h> functions
3558
3559 =item Miscellaneous functions
3560
3561 =back
3562
3563 =item SEE ALSO
3564
3565 =back
3566
3567 =head2 perlguts - Introduction to the Perl API
3568
3569 =over 4
3570
3571 =item DESCRIPTION
3572
3573 =item Variables
3574
3575 =over 4
3576
3577 =item Datatypes
3578
3579 =item What is an "IV"?
3580
3581 =item Working with SVs
3582
3583 =item Offsets
3584
3585 =item What's Really Stored in an SV?
3586
3587 =item Working with AVs
3588
3589 =item Working with HVs
3590
3591 =item Hash API Extensions
3592
3593 =item References
3594
3595 =item Blessed References and Class Objects
3596
3597 =item Creating New Variables
3598
3599 =item Reference Counts and Mortality
3600
3601 =item Stashes and Globs
3602
3603 =item Double-Typed SVs
3604
3605 =item Magic Variables
3606
3607 =item Assigning Magic
3608
3609 =item Magic Virtual Tables
3610
3611 =item Finding Magic
3612
3613 =item Understanding the Magic of Tied Hashes and Arrays
3614
3615 =item Localizing changes
3616
3617 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
3618 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
3619 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
3620 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
3621 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
3622 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
3623 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
3624 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
3625 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
3626 save_hptr(HV **hptr)>
3627
3628 =back
3629
3630 =item Subroutines
3631
3632 =over 4
3633
3634 =item XSUBs and the Argument Stack
3635
3636 =item Calling Perl Routines from within C Programs
3637
3638 =item Memory Allocation
3639
3640 =item PerlIO
3641
3642 =item Putting a C value on Perl stack
3643
3644 =item Scratchpads
3645
3646 =item Scratchpads and recursion
3647
3648 =back
3649
3650 =item Compiled code
3651
3652 =over 4
3653
3654 =item Code tree
3655
3656 =item Examining the tree
3657
3658 =item Compile pass 1: check routines
3659
3660 =item Compile pass 1a: constant folding
3661
3662 =item Compile pass 2: context propagation
3663
3664 =item Compile pass 3: peephole optimization
3665
3666 =item Pluggable runops
3667
3668 =back
3669
3670 =item Examining internal data structures with the C<dump> functions
3671
3672 =item How multiple interpreters and concurrency are supported
3673
3674 =over 4
3675
3676 =item Background and PERL_IMPLICIT_CONTEXT
3677
3678 =item So what happened to dTHR?
3679
3680 =item How do I use all this in extensions?
3681
3682 =item Should I do anything special if I call perl from multiple threads?
3683
3684 =item Future Plans and PERL_IMPLICIT_SYS
3685
3686 =back
3687
3688 =item Internal Functions
3689
3690 A, p, d, s, n, r, f, M, o, j, x
3691
3692 =over 4
3693
3694 =item Formatted Printing of IVs, UVs, and NVs
3695
3696 =item Pointer-To-Integer and Integer-To-Pointer
3697
3698 =item Source Documentation
3699
3700 =back
3701
3702 =item Unicode Support
3703
3704 =over 4
3705
3706 =item What B<is> Unicode, anyway?
3707
3708 =item How can I recognise a UTF8 string?
3709
3710 =item How does UTF8 represent Unicode characters?
3711
3712 =item How does Perl store UTF8 strings?
3713
3714 =item How do I convert a string to UTF8?
3715
3716 =item Is there anything else I need to know?
3717
3718 =back
3719
3720 =item Custom Operators
3721
3722 =item AUTHORS
3723
3724 =item SEE ALSO
3725
3726 =back
3727
3728 =head2 perlcall - Perl calling conventions from C
3729
3730 =over 4
3731
3732 =item DESCRIPTION
3733
3734 An Error Handler, An Event Driven Program
3735
3736 =item THE CALL_ FUNCTIONS
3737
3738 call_sv, call_pv, call_method, call_argv
3739
3740 =item FLAG VALUES
3741
3742 =over 4
3743
3744 =item  G_VOID
3745
3746 =item  G_SCALAR
3747
3748 =item G_ARRAY
3749
3750 =item G_DISCARD
3751
3752 =item G_NOARGS
3753
3754 =item G_EVAL
3755
3756 =item G_KEEPERR
3757
3758 =item Determining the Context
3759
3760 =back
3761
3762 =item KNOWN PROBLEMS
3763
3764 =item EXAMPLES
3765
3766 =over 4
3767
3768 =item No Parameters, Nothing returned
3769
3770 =item Passing Parameters
3771
3772 =item Returning a Scalar
3773
3774 =item Returning a list of values
3775
3776 =item Returning a list in a scalar context
3777
3778 =item Returning Data from Perl via the parameter list
3779
3780 =item Using G_EVAL
3781
3782 =item Using G_KEEPERR
3783
3784 =item Using call_sv
3785
3786 =item Using call_argv
3787
3788 =item Using call_method
3789
3790 =item Using GIMME_V
3791
3792 =item Using Perl to dispose of temporaries
3793
3794 =item Strategies for storing Callback Context Information
3795
3796 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3797 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3798 callback
3799
3800 =item Alternate Stack Manipulation
3801
3802 =item Creating and calling an anonymous subroutine in C
3803
3804 =back
3805
3806 =item SEE ALSO
3807
3808 =item AUTHOR
3809
3810 =item DATE
3811
3812 =back
3813
3814 =head2 perlutil - utilities packaged with the Perl distribution
3815
3816 =over 4
3817
3818 =item DESCRIPTION
3819
3820 =over 4
3821
3822 =item DOCUMENTATION
3823
3824 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3825 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3826 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3827 L<roffitall|roffitall>
3828
3829 =item CONVERTORS
3830
3831 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3832
3833 =item Administration
3834
3835 L<libnetcfg|libnetcfg>
3836
3837 =item Development
3838
3839 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3840 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3841
3842 =item SEE ALSO
3843
3844 =back
3845
3846 =back
3847
3848 =head2 perlfilter - Source Filters
3849
3850 =over 4
3851
3852 =item DESCRIPTION
3853
3854 =item CONCEPTS
3855
3856 =item USING FILTERS
3857
3858 =item WRITING A SOURCE FILTER
3859
3860 =item WRITING A SOURCE FILTER IN C
3861
3862 B<Decryption Filters>
3863
3864 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
3865
3866 =item WRITING A SOURCE FILTER IN PERL
3867
3868 =item USING CONTEXT: THE DEBUG FILTER
3869
3870 =item CONCLUSION
3871
3872 =item REQUIREMENTS
3873
3874 =item AUTHOR
3875
3876 =item Copyrights
3877
3878 =back
3879
3880 =head2 perldbmfilter - Perl DBM Filters
3881
3882 =over 4
3883
3884 =item SYNOPSIS
3885
3886 =item DESCRIPTION
3887
3888 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3889 B<filter_fetch_value>
3890
3891 =over 4
3892
3893 =item The Filter
3894
3895 =item An Example -- the NULL termination problem.
3896
3897 =item Another Example -- Key is a C int.
3898
3899 =back
3900
3901 =item SEE ALSO
3902
3903 =item AUTHOR
3904
3905 =back
3906
3907 =head2 perlapi - autogenerated documentation for the perl public API
3908
3909 =over 4
3910
3911 =item DESCRIPTION
3912
3913 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
3914 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
3915 ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
3916 call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
3917 dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
3918 fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
3919 get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
3920 grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
3921 gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
3922 G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
3923 HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
3924 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
3925 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
3926 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
3927 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
3928 ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
3929 mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
3930 Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, newSV, NEWSV, newSViv,
3931 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
3932 newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
3933 ORIGMARK, perl_alloc, perl_clone, perl_construct, perl_destruct, perl_free,
3934 perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef,
3935 PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK,
3936 PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL,
3937 Safefree, savepv, savepvn, SAVETMPS, scan_bin, scan_hex, scan_oct,
3938 sharedsv_find, sharedsv_init, sharedsv_lock, sharedsv_new,
3939 sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock, SP, SPAGAIN, ST,
3940 strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy,
3941 SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
3942 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVX,
3943 SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
3944 SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
3945 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
3946 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
3947 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx,
3948 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
3949 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetMagicSV,
3950 SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
3951 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV,
3952 SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
3953 SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, sv_2cv,
3954 sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
3955 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
3956 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
3957 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
3958 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
3959 sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
3960 sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
3961 sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
3962 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
3963 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
3964 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
3965 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
3966 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
3967 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
3968 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
3969 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
3970 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
3971 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
3972 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER,
3973 toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
3974 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
3975 uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN,
3976 XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV,
3977 XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV,
3978 XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
3979
3980 =item AUTHORS
3981
3982 =item SEE ALSO
3983
3984 =back
3985
3986 =head2 perlintern - autogenerated documentation of purely B<internal>
3987                  Perl functions
3988
3989 =over 4
3990
3991 =item DESCRIPTION
3992
3993 djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
3994 PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
3995 sv_clean_all, sv_clean_objs, sv_free_arenas
3996
3997 =item AUTHORS
3998
3999 =item SEE ALSO
4000
4001 =back
4002
4003 =head2 perliol - C API for Perl's implementation of IO in Layers.
4004
4005 =over 4
4006
4007 =item SYNOPSIS
4008
4009 =item DESCRIPTION
4010
4011 =over 4
4012
4013 =item History and Background
4014
4015 =item Layers vs Disciplines
4016
4017 =item Data Structures
4018
4019 1. The functions and attributes of the "layer class", 2. The per-instance
4020 data for a particular handle
4021
4022 =item Functions and Attributes
4023
4024 =item Per-instance Data
4025
4026 =item Layers in action.
4027
4028 =item Per-instance flag bits
4029
4030 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4031 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4032 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4033 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4034
4035 =item Methods in Detail
4036
4037  IV             (*Pushed)(PerlIO *f,const char *mode, SV *arg);,  IV
4038     (*Popped)(PerlIO *f);,  PerlIO *        (*Open)(...);, SV *
4039 (*Getarg)(PerlIO *f);, IV       (*Fileno)(PerlIO *f);,  SSize_t
4040 (*Read)(PerlIO *f, void *vbuf, Size_t count);,  SSize_t (*Unread)(PerlIO
4041 *f, const void *vbuf, Size_t count);,  SSize_t (*Write)(PerlIO *f, const
4042 void *vbuf, Size_t count);,  IV               (*Seek)(PerlIO *f, Off_t
4043 offset, int whence);,  Off_t           (*Tell)(PerlIO *f);,  IV
4044    (*Close)(PerlIO *f);,  IV               (*Flush)(PerlIO *f);,  IV
4045        (*Fill)(PerlIO *f);,  IV                (*Eof)(PerlIO *f);,  IV
4046    (*Error)(PerlIO *f);,  void             (*Clearerr)(PerlIO *f);,  void
4047        (*Setlinebuf)(PerlIO *f);,  STDCHAR *   (*Get_base)(PerlIO *f);,
4048 Size_t                (*Get_bufsiz)(PerlIO *f);,  STDCHAR *
4049 (*Get_ptr)(PerlIO *f);,  SSize_t        (*Get_cnt)(PerlIO *f);,  void
4050     (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
4051
4052 =item Core Layers
4053
4054 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4055
4056 =item Extension Layers
4057
4058 ":encoding", ":Scalar", ":Object" or ":Perl"
4059
4060 =back
4061
4062 =back
4063
4064 =head2 perlapio - perl's IO abstraction interface.
4065
4066 =over 4
4067
4068 =item SYNOPSIS
4069
4070 =item DESCRIPTION
4071
4072 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4073 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4074 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4075 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4076 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4077 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4078 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4079 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4080 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4081 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4082 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4083
4084 =over 4
4085
4086 =item Co-existence with stdio
4087
4088 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4089 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
4090
4091 =item "Fast gets" Functions
4092
4093 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4094 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4095 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4096 B<PerlIO_get_bufsiz(f)>
4097
4098 =item Other Functions
4099
4100 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4101 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4102
4103 =back
4104
4105 =back
4106
4107 =head2 perltodo - Perl TO-DO List
4108
4109 =over 4
4110
4111 =item DESCRIPTION
4112
4113 =item To do during 5.6.x
4114
4115 =over 4
4116
4117 =item Support for I/O disciplines
4118
4119 =item Autoload bytes.pm
4120
4121 =item Make "\u{XXXX}" et al work
4122
4123 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4124
4125 =item Overloadable regex assertions
4126
4127 =item Unicode
4128
4129 =item use Thread for iThreads
4130
4131 =item make perl_clone optionally clone ops
4132
4133 =item Work out exit/die semantics for threads
4134
4135 =item Typed lexicals for compiler
4136
4137 =item Compiler workarounds for Win32
4138
4139 =item AUTOLOADing in the compiler
4140
4141 =item Fixing comppadlist when compiling
4142
4143 =item Cleaning up exported namespace
4144
4145 =item Complete signal handling
4146
4147 =item Out-of-source builds
4148
4149 =item POSIX realtime support
4150
4151 =item UNIX98 support
4152
4153 =item IPv6 Support
4154
4155 =item Long double conversion
4156
4157 =item Locales
4158
4159 =item Thread-safe regexes
4160
4161 =item Arithmetic on non-Arabic numerals
4162
4163 =item POSIX Unicode character classes
4164
4165 =item Factoring out common suffices/prefices in regexps (trie optimization)
4166
4167 =item Security audit shipped utilities
4168
4169 =item Custom opcodes
4170
4171 =item spawnvp() on Win32
4172
4173 =item DLL Versioning
4174
4175 =item Introduce @( and @)
4176
4177 =item Floating point handling
4178
4179 =item IV/UV preservation
4180
4181 =item Replace pod2html with something using Pod::Parser
4182
4183 =item Automate module testing on CPAN
4184
4185 =item sendmsg and recvmsg
4186
4187 =item Rewrite perlre documentation
4188
4189 =item Convert example code to IO::Handle filehandles
4190
4191 =item Document Win32 choices
4192
4193 =item Check new modules
4194
4195 =item Make roffitall find pods and libs itself
4196
4197 =back
4198
4199 =item To do at some point
4200
4201 =over 4
4202
4203 =item Remove regular expression recursion
4204
4205 =item Memory leaks after failed eval
4206
4207 =item pack "(stuff)*"
4208
4209 =item bitfields in pack
4210
4211 =item Cross compilation
4212
4213 =item Perl preprocessor / macros
4214
4215 =item Perl lexer in Perl
4216
4217 =item Using POSIX calls internally
4218
4219 =item -i rename file when changed
4220
4221 =item All ARGV input should act like E<lt>E<gt>
4222
4223 =item Support for rerunning debugger
4224
4225 =item Test Suite for the Debugger
4226
4227 =item my sub foo { }
4228
4229 =item One-pass global destruction
4230
4231 =item Rewrite regexp parser
4232
4233 =item Cache recently used regexps
4234
4235 =item Re-entrant functions
4236
4237 =item Cross-compilation support
4238
4239 =item Bit-shifting bitvectors
4240
4241 =item debugger pragma
4242
4243 =item use less pragma
4244
4245 =item switch structures
4246
4247 =item Cache eval tree
4248
4249 =item rcatmaybe
4250
4251 =item Shrink opcode tables
4252
4253 =item Optimize away @_
4254
4255 =item Prototypes versus indirect objects
4256
4257 =item Install HMTL
4258
4259 =item Prototype method calls
4260
4261 =item Return context prototype declarations
4262
4263 =item magic_setisa
4264
4265 =item Garbage collection
4266
4267 =item IO tutorial
4268
4269 =item pack/unpack tutorial
4270
4271 =item Rewrite perldoc
4272
4273 =item Install .3p manpages
4274
4275 =item Unicode tutorial
4276
4277 =item Update POSIX.pm for 1003.1-2
4278
4279 =item Retargetable installation
4280
4281 =item POSIX emulation on non-POSIX systems
4282
4283 =item Rename Win32 headers
4284
4285 =item Finish off lvalue functions
4286
4287 =item Update sprintf documentation
4288
4289 =item Use fchown/fchmod internally
4290
4291 =back
4292
4293 =item Vague ideas
4294
4295 =over 4
4296
4297 =item ref() in list context
4298
4299 =item Make tr/// return histogram of characters in list context
4300
4301 =item Compile to real threaded code
4302
4303 =item Structured types
4304
4305 =item Modifiable $1 et al.
4306
4307 =item Procedural interfaces for IO::*, etc.
4308
4309 =item RPC modules
4310
4311 =item Attach/detach debugger from running program
4312
4313 =item Alternative RE syntax module
4314
4315 =item GUI::Native
4316
4317 =item foreach(reverse ...)
4318
4319 =item Constant function cache
4320
4321 =item Approximate regular expression matching
4322
4323 =back
4324
4325 =item Ongoing
4326
4327 =over 4
4328
4329 =item Update guts documentation
4330
4331 =item Add more tests
4332
4333 =item Update auxiliary tools
4334
4335 =back
4336
4337 =item Recently done things
4338
4339 =over 4
4340
4341 =item Safe signal handling
4342
4343 =item Tie Modules
4344
4345 =item gettimeofday
4346
4347 =item setitimer and getimiter
4348
4349 =item Testing __DIE__ hook
4350
4351 =item CPP equivalent in Perl
4352
4353 =item Explicit switch statements
4354
4355 =item autocroak
4356
4357 =item UTF/EBCDIC
4358
4359 =item UTF Regexes
4360
4361 =item perlcc to produce executable
4362
4363 =item END blocks saved in compiled output
4364
4365 =item Secure temporary file module
4366
4367 =item Integrate Time::HiRes
4368
4369 =item Turn Cwd into XS
4370
4371 =item Mmap for input
4372
4373 =item Byte to/from UTF8 and UTF8 to/from local conversion
4374
4375 =item Add sockatmark support
4376
4377 =item Mailing list archives
4378
4379 =item Bug tracking
4380
4381 =item Integrate MacPerl
4382
4383 =item Web "nerve center" for Perl
4384
4385 =item Regular expression tutorial
4386
4387 =item Debugging Tutorial
4388
4389 =item Integrate new modules
4390
4391 =item Integrate profiler
4392
4393 =item Y2K error detection
4394
4395 =item Regular expression debugger
4396
4397 =item POD checker
4398
4399 =item "Dynamic" lexicals
4400
4401 =item Cache precompiled modules
4402
4403 =back
4404
4405 =item Deprecated Wishes
4406
4407 =over 4
4408
4409 =item Loop control on do{}
4410
4411 =item Lexically scoped typeglobs
4412
4413 =item format BOTTOM
4414
4415 =item report HANDLE
4416
4417 =item Generalised want()/caller())
4418
4419 =item Named prototypes
4420
4421 =item Built-in globbing
4422
4423 =item Regression tests for suidperl
4424
4425 =item Cached hash values
4426
4427 =item Add compression modules
4428
4429 =item Reorganise documentation into tutorials/references
4430
4431 =item Remove distinction between functions and operators
4432
4433 =item Make XS easier to use
4434
4435 =item Make embedding easier to use
4436
4437 =item man for perl
4438
4439 =item my $Package::variable
4440
4441 =item "or" tests defined, not truth
4442
4443 =item "class"-based lexicals
4444
4445 =item byteperl
4446
4447 =item Lazy evaluation / tail recursion removal
4448
4449 =item Make "use utf8" the default
4450
4451 =item Unicode collation and normalization
4452
4453 =item Create debugging macros
4454
4455 =back
4456
4457 =back
4458
4459 =head2 perlhack - How to hack at the Perl internals
4460
4461 =over 4
4462
4463 =item DESCRIPTION
4464
4465 Does concept match the general goals of Perl?, Where is the
4466 implementation?, Backwards compatibility, Could it be a module instead?, Is
4467 the feature generic enough?, Does it potentially introduce new bugs?, Does
4468 it preclude other desirable features?, Is the implementation robust?, Is
4469 the implementation generic enough to be portable?, Is there enough
4470 documentation?, Is there another way to do it?, Does it create too much
4471 work?, Patches speak louder than words
4472
4473 =over 4
4474
4475 =item Keeping in sync
4476
4477 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4478 NFS, rsync'ing the patches
4479
4480 =item Why rsync the source tree
4481
4482 It's easier to rsync the source tree, It's more recent, It's more reliable
4483
4484 =item Why rsync the patches
4485
4486 It's easier to rsync the patches, It's a good reference, Finding a start
4487 point, Finding how to fix a bug, Finding the source of misbehaviour
4488
4489 =item Submitting patches
4490
4491 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4492 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4493
4494 =item Finding Your Way Around
4495
4496 Core modules, Tests, Documentation, Configure, Interpreter
4497
4498 =item Elements of the interpreter
4499
4500 Startup, Parsing, Optimization, Running
4501
4502 =item Internal Variable Types
4503
4504 =item Op Trees
4505
4506 =item Stacks
4507
4508 Argument stack, Mark stack, Save stack
4509
4510 =item Millions of Macros
4511
4512 =item Poking at Perl
4513
4514 =item Using a source-level debugger
4515
4516 run [args], break function_name, break source.c:xxx, step, next, continue,
4517 finish, 'enter', print
4518
4519 =item Dumping Perl Data Structures
4520
4521 =item Patching
4522
4523 =item Patching a core module
4524
4525 =item Adding a new function to the core
4526
4527 =item Writing a test
4528
4529 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
4530 F<t/pod/>, F<t/run/>
4531
4532 =back
4533
4534 =item EXTERNAL TOOLS FOR DEBUGGING PERL
4535
4536 =over 4
4537
4538 =item Rational Software's Purify
4539
4540 =item Purify on Unix
4541
4542 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
4543
4544 =item Purify on NT
4545
4546 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
4547
4548 =item Compaq's/Digital's Third Degree
4549
4550 =item PERL_DESTRUCT_LEVEL
4551
4552 =item Profiling
4553
4554 =item Gprof Profiling
4555
4556 -a, -b, -e routine, -f routine, -s, -z
4557
4558 =item GCC gcov Profiling
4559
4560 =item Pixie Profiling
4561
4562 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
4563 -z[ero]
4564
4565 =item CONCLUSION
4566
4567 I<The Road goes ever on and on, down from the door where it began.>
4568
4569 =back
4570
4571 =item AUTHOR
4572
4573 =back
4574
4575 =head2 perlhist - the Perl history records
4576
4577 =over 4
4578
4579 =item DESCRIPTION
4580
4581 =item INTRODUCTION
4582
4583 =item THE KEEPERS OF THE PUMPKIN
4584
4585 =over 4
4586
4587 =item PUMPKIN?
4588
4589 =back
4590
4591 =item THE RECORDS
4592
4593 =over 4
4594
4595 =item SELECTED RELEASE SIZES
4596
4597 =item SELECTED PATCH SIZES
4598
4599 =back
4600
4601 =item THE KEEPERS OF THE RECORDS
4602
4603 =back
4604
4605 =head2 perldelta - what will be new for perl v5.8.0
4606
4607 =over 4
4608
4609 =item DESCRIPTION
4610
4611 =item Reporting Bugs
4612
4613 =item SEE ALSO
4614
4615 =item HISTORY
4616
4617 =back
4618
4619 =head2 perl572delta - what's new for perl v5.7.2
4620
4621 =over 4
4622
4623 =item DESCRIPTION
4624
4625 =item Security Vulnerability Closed
4626
4627 =item Incompatible Changes
4628
4629 =over 4
4630
4631 =item 64-bit platforms and malloc
4632
4633 =item AIX Dynaloading
4634
4635 =item Socket Extension Dynamic in VMS
4636
4637 =item Different Definition of the Unicode Character Classes \p{In...}
4638
4639 =item Deprecations
4640
4641 =back
4642
4643 =item Core Enhancements
4644
4645 =item Modules and Pragmata
4646
4647 =over 4
4648
4649 =item New Modules and Distributions
4650
4651 =item Updated And Improved Modules and Pragmata
4652
4653 =back
4654
4655 =item Utility Changes
4656
4657 =item New Documentation
4658
4659 =item Installation and Configuration Improvements
4660
4661 =over 4
4662
4663 =item New Or Improved Platforms
4664
4665 =item Generic Improvements
4666
4667 =back
4668
4669 =item Selected Bug Fixes
4670
4671 =over 4
4672
4673 =item Platform Specific Changes and Fixes
4674
4675 =back
4676
4677 =item New or Changed Diagnostics
4678
4679 =item Source Code Enhancements
4680
4681 =over 4
4682
4683 =item MAGIC constants
4684
4685 =item Better commented code
4686
4687 =item Regex pre-/post-compilation items matched up
4688
4689 =item gcc -Wall
4690
4691 =back
4692
4693 =item New Tests
4694
4695 =item Known Problems
4696
4697 =over 4
4698
4699 =item AIX
4700
4701 =item Amiga Perl Invoking Mystery
4702
4703 =item lib/ftmp-security tests warn 'system possibly insecure'
4704
4705 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
4706
4707 =item HP-UX lib/io_multihomed Fails When LP64-Configur
4708
4709 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
4710
4711 =item Linux With Sfio Fails op/misc Test 48
4712
4713 =item OS/390
4714
4715 =item op/sprintf tests 129 and 130
4716
4717 =item  Failure of Thread tests
4718
4719 =item UNICOS
4720
4721 =item UTS
4722
4723 =item VMS
4724
4725 =item Win32
4726
4727 =item Localising a Tied Variable Leaks Memory
4728
4729 =item Self-tying of Arrays and Hashes Is Forbidden
4730
4731 =item Variable Attributes are not Currently Usable for Tieing
4732
4733 =item Building Extensions Can Fail Because Of Largefiles
4734
4735 =item The Compiler Suite Is Still Experimental
4736
4737 =item The Long Double Support is Still Experimental
4738
4739 =back
4740
4741 =item Reporting Bugs
4742
4743 =item SEE ALSO
4744
4745 =item HISTORY
4746
4747 =back
4748
4749 =head2 perl571delta - what's new for perl v5.7.1
4750
4751 =over 4
4752
4753 =item DESCRIPTION
4754
4755 =item Security Vulnerability Closed
4756
4757 =item Incompatible Changes
4758
4759 =item Core Enhancements
4760
4761 =over 4
4762
4763 =item AUTOLOAD Is Now Lvaluable
4764
4765 =item PerlIO is Now The Default
4766
4767 =item Signals Are Now Safe
4768
4769 =back
4770
4771 =item Modules and Pragmata
4772
4773 =over 4
4774
4775 =item New Modules
4776
4777 =item Updated And Improved Modules and Pragmata
4778
4779 =back
4780
4781 =item Performance Enhancements
4782
4783 =item Utility Changes
4784
4785 =item New Documentation
4786
4787 =over 4
4788
4789 =item perlclib
4790
4791 =item perliol
4792
4793 =item README.aix
4794
4795 =item README.bs2000
4796
4797 =item README.macos
4798
4799 =item README.mpeix
4800
4801 =item README.solaris
4802
4803 =item README.vos
4804
4805 =item Porting/repository.pod
4806
4807 =back
4808
4809 =item Installation and Configuration Improvements
4810
4811 =over 4
4812
4813 =item New Or Improved Platforms
4814
4815 =item Generic Improvements
4816
4817 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
4818 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
4819 d_strtoq, d_u32align, d_ualarm, d_usleep
4820
4821 =back
4822
4823 =item Selected Bug Fixes
4824
4825 =over 4
4826
4827 =item Platform Specific Changes and Fixes
4828
4829 =back
4830
4831 =item New or Changed Diagnostics
4832
4833 =item Changed Internals
4834
4835 =item New Tests
4836
4837 =item Known Problems
4838
4839 =over 4
4840
4841 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
4842
4843 =item lib/ftmp-security tests warn 'system possibly insecure'
4844
4845 =item lib/io_multihomed Fails In LP64-Configured HP-UX
4846
4847 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
4848
4849 =item lib/b test 19
4850
4851 =item Linux With Sfio Fails op/misc Test 48
4852
4853 =item sigaction test 13 in VMS
4854
4855 =item sprintf tests 129 and 130
4856
4857 =item  Failure of Thread tests
4858
4859 =item Localising a Tied Variable Leaks Memory
4860
4861 =item Self-tying of Arrays and Hashes Is Forbidden
4862
4863 =item Building Extensions Can Fail Because Of Largefiles
4864
4865 =item The Compiler Suite Is Still Experimental
4866
4867 =back
4868
4869 =item Reporting Bugs
4870
4871 =item SEE ALSO
4872
4873 =item HISTORY
4874
4875 =back
4876
4877 =head2 perl570delta - what's new for perl v5.7.0
4878
4879 =over 4
4880
4881 =item DESCRIPTION
4882
4883 =item Security Vulnerability Closed
4884
4885 =item Incompatible Changes
4886
4887 =item Core Enhancements
4888
4889 =item Modules and Pragmata
4890
4891 =over 4
4892
4893 =item New Modules
4894
4895 =item Updated And Improved Modules and Pragmata
4896
4897 =back
4898
4899 =item Utility Changes
4900
4901 =item New Documentation
4902
4903 =item Performance Enhancements
4904
4905 =item Installation and Configuration Improvements
4906
4907 =over 4
4908
4909 =item Generic Improvements
4910
4911 =back
4912
4913 =item Selected Bug Fixes
4914
4915 =over 4
4916
4917 =item Platform Specific Changes and Fixes
4918
4919 =back
4920
4921 =item New or Changed Diagnostics
4922
4923 =item Changed Internals
4924
4925 =item Known Problems
4926
4927 =over 4
4928
4929 =item Unicode Support Still Far From Perfect
4930
4931 =item EBCDIC Still A Lost Platform
4932
4933 =item Building Extensions Can Fail Because Of Largefiles
4934
4935 =item ftmp-security tests warn 'system possibly insecure'
4936
4937 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
4938
4939 =item Long Doubles Still Don't Work In Solaris
4940
4941 =item Linux With Sfio Fails op/misc Test 48
4942
4943 =item Storable tests fail in some platforms
4944
4945 =item Threads Are Still Experimental
4946
4947 =item The Compiler Suite Is Still Experimental
4948
4949 =back
4950
4951 =item Reporting Bugs
4952
4953 =item SEE ALSO
4954
4955 =item HISTORY
4956
4957 =back
4958
4959 =head2 perl56delta, perldelta - what's new for perl v5.6.0
4960
4961 =over 4
4962
4963 =item DESCRIPTION
4964
4965 =item Core Enhancements
4966
4967 =over 4
4968
4969 =item Interpreter cloning, threads, and concurrency
4970
4971 =item Lexically scoped warning categories
4972
4973 =item Unicode and UTF-8 support
4974
4975 =item Support for interpolating named characters
4976
4977 =item "our" declarations
4978
4979 =item Support for strings represented as a vector of ordinals
4980
4981 =item Improved Perl version numbering system
4982
4983 =item New syntax for declaring subroutine attributes
4984
4985 =item File and directory handles can be autovivified
4986
4987 =item open() with more than two arguments
4988
4989 =item 64-bit support
4990
4991 =item Large file support
4992
4993 =item Long doubles
4994
4995 =item "more bits"
4996
4997 =item Enhanced support for sort() subroutines
4998
4999 =item C<sort $coderef @foo> allowed
5000
5001 =item File globbing implemented internally
5002
5003 =item Support for CHECK blocks
5004
5005 =item POSIX character class syntax [: :] supported
5006
5007 =item Better pseudo-random number generator
5008
5009 =item Improved C<qw//> operator
5010
5011 =item Better worst-case behavior of hashes
5012
5013 =item pack() format 'Z' supported
5014
5015 =item pack() format modifier '!' supported
5016
5017 =item pack() and unpack() support counted strings
5018
5019 =item Comments in pack() templates
5020
5021 =item Weak references
5022
5023 =item Binary numbers supported
5024
5025 =item Lvalue subroutines
5026
5027 =item Some arrows may be omitted in calls through references
5028
5029 =item Boolean assignment operators are legal lvalues
5030
5031 =item exists() is supported on subroutine names
5032
5033 =item exists() and delete() are supported on array elements
5034
5035 =item Pseudo-hashes work better
5036
5037 =item Automatic flushing of output buffers
5038
5039 =item Better diagnostics on meaningless filehandle operations
5040
5041 =item Where possible, buffered data discarded from duped input filehandle
5042
5043 =item eof() has the same old magic as <>
5044
5045 =item binmode() can be used to set :crlf and :raw modes
5046
5047 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5048
5049 =item system(), backticks and pipe open now reflect exec() failure
5050
5051 =item Improved diagnostics
5052
5053 =item Diagnostics follow STDERR
5054
5055 =item More consistent close-on-exec behavior
5056
5057 =item syswrite() ease-of-use
5058
5059 =item Better syntax checks on parenthesized unary operators
5060
5061 =item Bit operators support full native integer width
5062
5063 =item Improved security features
5064
5065 =item More functional bareword prototype (*)
5066
5067 =item C<require> and C<do> may be overridden
5068
5069 =item $^X variables may now have names longer than one character
5070
5071 =item New variable $^C reflects C<-c> switch
5072
5073 =item New variable $^V contains Perl version as a string
5074
5075 =item Optional Y2K warnings
5076
5077 =item Arrays now always interpolate into double-quoted strings
5078
5079 =back
5080
5081 =item Modules and Pragmata
5082
5083 =over 4
5084
5085 =item Modules
5086
5087 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5088 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5089 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5090 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5091 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5092 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5093 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5094 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5095
5096 =item Pragmata
5097
5098 =back
5099
5100 =item Utility Changes
5101
5102 =over 4
5103
5104 =item dprofpp
5105
5106 =item find2perl
5107
5108 =item h2xs
5109
5110 =item perlcc
5111
5112 =item perldoc
5113
5114 =item The Perl Debugger
5115
5116 =back
5117
5118 =item Improved Documentation
5119
5120 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5121 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5122 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5123 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5124
5125 =item Performance enhancements
5126
5127 =over 4
5128
5129 =item Simple sort() using { $a <=> $b } and the like are optimized
5130
5131 =item Optimized assignments to lexical variables
5132
5133 =item Faster subroutine calls
5134
5135 =item delete(), each(), values() and hash iteration are faster
5136
5137 =back
5138
5139 =item Installation and Configuration Improvements
5140
5141 =over 4
5142
5143 =item -Dusethreads means something different
5144
5145 =item New Configure flags
5146
5147 =item Threadedness and 64-bitness now more daring
5148
5149 =item Long Doubles
5150
5151 =item -Dusemorebits
5152
5153 =item -Duselargefiles
5154
5155 =item installusrbinperl
5156
5157 =item SOCKS support
5158
5159 =item C<-A> flag
5160
5161 =item Enhanced Installation Directories
5162
5163 =back
5164
5165 =item Platform specific changes
5166
5167 =over 4
5168
5169 =item Supported platforms
5170
5171 =item DOS
5172
5173 =item OS390 (OpenEdition MVS)
5174
5175 =item VMS
5176
5177 =item Win32
5178
5179 =back
5180
5181 =item Significant bug fixes
5182
5183 =over 4
5184
5185 =item <HANDLE> on empty files
5186
5187 =item C<eval '...'> improvements
5188
5189 =item All compilation errors are true errors
5190
5191 =item Implicitly closed filehandles are safer
5192
5193 =item Behavior of list slices is more consistent
5194
5195 =item C<(\$)> prototype and C<$foo{a}>
5196
5197 =item C<goto &sub> and AUTOLOAD
5198
5199 =item C<-bareword> allowed under C<use integer>
5200
5201 =item Failures in DESTROY()
5202
5203 =item Locale bugs fixed
5204
5205 =item Memory leaks
5206
5207 =item Spurious subroutine stubs after failed subroutine calls
5208
5209 =item Taint failures under C<-U>
5210
5211 =item END blocks and the C<-c> switch
5212
5213 =item Potential to leak DATA filehandles
5214
5215 =back
5216
5217 =item New or Changed Diagnostics
5218
5219 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
5220 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
5221 / cannot take a count, / must be followed by a, A or Z, / must be followed
5222 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
5223 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
5224 passed through, /%s/ should probably be written as "%s", %s() called too
5225 early to check prototype, %s argument is not a HASH or ARRAY element, %s
5226 argument is not a HASH or ARRAY element or slice, %s argument is not a
5227 subroutine name, %s package attribute may clash with future reserved word:
5228 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
5229 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
5230 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
5231 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
5232 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
5233 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
5234 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
5235 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
5236 weaken a nonreference, Character class [:%s:] unknown, Character class
5237 syntax [%s] belongs inside character classes, Constant is not %s reference,
5238 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
5239 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
5240 "local" instead of "our"?), Document contains no data, entering effective
5241 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
5242 output, flock() on closed filehandle %s, Global symbol "%s" requires
5243 explicit package name, Hexadecimal number > 0xffffffff non-portable,
5244 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
5245 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
5246 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
5247 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
5248 separator character %s in attribute list, Invalid separator character %s in
5249 subroutine attribute list, leaving effective %s failed, Lvalue subs
5250 returning %s not implemented yet, Method %s not permitted, Missing
5251 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
5252 No %s specified for -%c, No package name allowed for variable %s in "our",
5253 No space allowed after -%c, no UTC offset information; assuming local time
5254 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
5255 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
5256 around "%s" list, Possible unintended interpolation of %s in string,
5257 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
5258 instead, Premature end of script headers, Repeat count in pack overflows,
5259 Repeat count in unpack overflows, realloc() of freed memory ignored,
5260 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
5261 zero-length expression, switching effective %s is not implemented, This
5262 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
5263 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
5264 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
5265 escape \\%c passed through, Unterminated attribute parameter in attribute
5266 list, Unterminated attribute list, Unterminated attribute parameter in
5267 subroutine attribute list, Unterminated subroutine attribute list, Value of
5268 CLI symbol "%s" too long, Version number must be a constant number
5269
5270 =item New tests
5271
5272 =item Incompatible Changes
5273
5274 =over 4
5275
5276 =item Perl Source Incompatibilities
5277
5278 CHECK is a new keyword, Treatment of list slices of undef has changed,
5279 Format of $English::PERL_VERSION is different, Literals of the form
5280 C<1.2.3> parse differently, Possibly changed pseudo-random number
5281 generator, Hashing function for hash keys has changed, C<undef> fails on
5282 read only values, Close-on-exec bit may be set on pipe and socket handles,
5283 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
5284 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
5285 Text of some diagnostic output has changed, C<%@> has been removed,
5286 Parenthesized not() behaves like a list operator, Semantics of bareword
5287 prototype C<(*)> have changed, Semantics of bit operators may have changed
5288 on 64-bit platforms, More builtins taint their results
5289
5290 =item C Source Incompatibilities
5291
5292 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
5293
5294 =item Compatible C Source API Changes
5295
5296 C<PATCHLEVEL> is now C<PERL_VERSION>
5297
5298 =item Binary Incompatibilities
5299
5300 =back
5301
5302 =item Known Problems
5303
5304 =over 4
5305
5306 =item Thread test failures
5307
5308 =item EBCDIC platforms not supported
5309
5310 =item In 64-bit HP-UX the lib/io_multihomed test may hang
5311
5312 =item NEXTSTEP 3.3 POSIX test failure
5313
5314 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
5315 gcc
5316
5317 =item UNICOS/mk CC failures during Configure run
5318
5319 =item Arrow operator and arrays
5320
5321 =item Experimental features
5322
5323 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
5324 pseudo-hash data type, The Compiler suite, Internal implementation of file
5325 globbing, The DB module, The regular expression code constructs:
5326
5327 =back
5328
5329 =item Obsolete Diagnostics
5330
5331 Character class syntax [: :] is reserved for future extensions, Ill-formed
5332 logical name |%s| in prime_env_iter, In string, @%s now must be written as
5333 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
5334 to mean "${$}<digit>" is deprecated
5335
5336 =item Reporting Bugs
5337
5338 =item SEE ALSO
5339
5340 =item HISTORY
5341
5342 =back
5343
5344 =head2 perl5005delta, perldelta - what's new for perl5.005
5345
5346 =over 4
5347
5348 =item DESCRIPTION
5349
5350 =item About the new versioning system
5351
5352 =item Incompatible Changes
5353
5354 =over 4
5355
5356 =item WARNING:  This version is not binary compatible with Perl 5.004.
5357
5358 =item Default installation structure has changed
5359
5360 =item Perl Source Compatibility
5361
5362 =item C Source Compatibility
5363
5364 =item Binary Compatibility
5365
5366 =item Security fixes may affect compatibility
5367
5368 =item Relaxed new mandatory warnings introduced in 5.004
5369
5370 =item Licensing
5371
5372 =back
5373
5374 =item Core Changes
5375
5376 =over 4
5377
5378 =item Threads
5379
5380 =item Compiler
5381
5382 =item Regular Expressions
5383
5384 Many new and improved optimizations, Many bug fixes, New regular expression
5385 constructs, New operator for precompiled regular expressions, Other
5386 improvements, Incompatible changes
5387
5388 =item   Improved malloc()
5389
5390 =item Quicksort is internally implemented
5391
5392 =item Reliable signals
5393
5394 =item Reliable stack pointers
5395
5396 =item More generous treatment of carriage returns
5397
5398 =item Memory leaks
5399
5400 =item Better support for multiple interpreters
5401
5402 =item Behavior of local() on array and hash elements is now well-defined
5403
5404 =item C<%!> is transparently tied to the L<Errno> module
5405
5406 =item Pseudo-hashes are supported
5407
5408 =item C<EXPR foreach EXPR> is supported
5409
5410 =item Keywords can be globally overridden
5411
5412 =item C<$^E> is meaningful on Win32
5413
5414 =item C<foreach (1..1000000)> optimized
5415
5416 =item C<Foo::> can be used as implicitly quoted package name
5417
5418 =item C<exists $Foo::{Bar::}> tests existence of a package
5419
5420 =item Better locale support
5421
5422 =item Experimental support for 64-bit platforms
5423
5424 =item prototype() returns useful results on builtins
5425
5426 =item Extended support for exception handling
5427
5428 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
5429
5430 =item All C<printf> format conversions are handled internally
5431
5432 =item New C<INIT> keyword
5433
5434 =item New C<lock> keyword
5435
5436 =item New C<qr//> operator
5437
5438 =item C<our> is now a reserved word
5439
5440 =item Tied arrays are now fully supported
5441
5442 =item Tied handles support is better
5443
5444 =item 4th argument to substr
5445
5446 =item Negative LENGTH argument to splice
5447
5448 =item Magic lvalues are now more magical
5449
5450 =item <> now reads in records
5451
5452 =back
5453
5454 =item Supported Platforms
5455
5456 =over 4
5457
5458 =item New Platforms
5459
5460 =item Changes in existing support
5461
5462 =back
5463
5464 =item Modules and Pragmata
5465
5466 =over 4
5467
5468 =item New Modules
5469
5470 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
5471 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
5472 Thread, attrs, fields, re
5473
5474 =item Changes in existing modules
5475
5476 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
5477 MakeMaker, CPAN, Cwd
5478
5479 =back
5480
5481 =item Utility Changes
5482
5483 =item Documentation Changes
5484
5485 =item New Diagnostics
5486
5487 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
5488 while coercing array into hash, Bareword "%s" refers to nonexistent
5489 package, Can't call method "%s" on an undefined value, Can't check
5490 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
5491 goto subroutine from an eval-string, Can't localize pseudo-hash element,
5492 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
5493 for "%s", Character class syntax [. .] is reserved for future extensions,
5494 Character class syntax [: :] is reserved for future extensions, Character
5495 class syntax [= =] is reserved for future extensions, %s: Eval-group in
5496 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
5497 Eval-group not allowed at run time, Explicit blessing to '' (assuming
5498 package main), Illegal hex digit ignored, No such array field, No such
5499 field "%s" in variable %s of type %s, Out of memory during ridiculously
5500 large request, Range iterator outside integer range, Recursive inheritance
5501 detected while looking for method '%s' %s, Reference found where even-sized
5502 list expected, Undefined value assigned to typeglob, Use of reserved word
5503 "%s" is deprecated, perl: warning: Setting locale failed
5504
5505 =item Obsolete Diagnostics
5506
5507 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
5508 temporary file, regexp too big
5509
5510 =item Configuration Changes
5511
5512 =item BUGS
5513
5514 =item SEE ALSO
5515
5516 =item HISTORY
5517
5518 =back
5519
5520 =head2 perl5004delta, perldelta - what's new for perl5.004
5521
5522 =over 4
5523
5524 =item DESCRIPTION
5525
5526 =item Supported Environments
5527
5528 =item Core Changes
5529
5530 =over 4
5531
5532 =item List assignment to %ENV works
5533
5534 =item Change to "Can't locate Foo.pm in @INC" error
5535
5536 =item Compilation option: Binary compatibility with 5.003
5537
5538 =item $PERL5OPT environment variable
5539
5540 =item Limitations on B<-M>, B<-m>, and B<-T> options
5541
5542 =item More precise warnings
5543
5544 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
5545
5546 =item Previously deprecated %OVERLOAD is no longer usable
5547
5548 =item Subroutine arguments created only when they're modified
5549
5550 =item Group vector changeable with C<$)>
5551
5552 =item Fixed parsing of $$<digit>, &$<digit>, etc.
5553
5554 =item Fixed localization of $<digit>, $&, etc.
5555
5556 =item No resetting of $. on implicit close
5557
5558 =item C<wantarray> may return undef
5559
5560 =item C<eval EXPR> determines value of EXPR in scalar context
5561
5562 =item Changes to tainting checks
5563
5564 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
5565 spawning if tainted $TERM doesn't look like a terminal name
5566
5567 =item New Opcode module and revised Safe module
5568
5569 =item Embedding improvements
5570
5571 =item Internal change: FileHandle class based on IO::* classes
5572
5573 =item Internal change: PerlIO abstraction interface
5574
5575 =item New and changed syntax
5576
5577 $coderef->(PARAMS)
5578
5579 =item New and changed builtin constants
5580
5581 __PACKAGE__
5582
5583 =item New and changed builtin variables
5584
5585 $^E, $^H, $^M
5586
5587 =item New and changed builtin functions
5588
5589 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
5590 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
5591 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
5592 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
5593 nested C<sub{}> closures work now, formats work right on changing lexicals
5594
5595 =item New builtin methods
5596
5597 isa(CLASS), can(METHOD), VERSION( [NEED] )
5598
5599 =item TIEHANDLE now supported
5600
5601 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
5602 LIST, READLINE this, GETC this, DESTROY this
5603
5604 =item Malloc enhancements
5605
5606 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
5607
5608 =item Miscellaneous efficiency enhancements
5609
5610 =back
5611
5612 =item Support for More Operating Systems
5613
5614 =over 4
5615
5616 =item Win32
5617
5618 =item Plan 9
5619
5620 =item QNX
5621
5622 =item AmigaOS
5623
5624 =back
5625
5626 =item Pragmata
5627
5628 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
5629 constant NAME => VALUE, use locale, use ops, use vmsish
5630
5631 =item Modules
5632
5633 =over 4
5634
5635 =item Required Updates
5636
5637 =item Installation directories
5638
5639 =item Module information summary
5640
5641 =item Fcntl
5642
5643 =item IO
5644
5645 =item Math::Complex
5646
5647 =item Math::Trig
5648
5649 =item DB_File
5650
5651 =item Net::Ping
5652
5653 =item Object-oriented overrides for builtin operators
5654
5655 =back
5656
5657 =item Utility Changes
5658
5659 =over 4
5660
5661 =item pod2html
5662
5663 Sends converted HTML to standard output
5664
5665 =item xsubpp
5666
5667 C<void> XSUBs now default to returning nothing
5668
5669 =back
5670
5671 =item C Language API Changes
5672
5673 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
5674 manipulating hashes
5675
5676 =item Documentation Changes
5677
5678 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
5679 L<perlmodlib>, L<perldebug>, L<perlsec>
5680
5681 =item New Diagnostics
5682
5683 "my" variable %s masks earlier declaration in same scope, %s argument is
5684 not a HASH element or slice, Allocation too large: %lx, Allocation too
5685 large, Applying %s to %s will act on scalar(%s), Attempt to free
5686 nonexistent shared string, Attempt to use reference as lvalue in substr,
5687 Bareword "%s" refers to nonexistent package, Can't redefine active sort
5688 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
5689 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
5690 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
5691 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
5692 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
5693 %s, Integer overflow in hex number, Integer overflow in octal number,
5694 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
5695 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
5696 possible typo, Null picture in formline, Offset outside string, Out of
5697 memory!, Out of memory during request for %s, panic: frexp, Possible
5698 attempt to put comments in qw() list, Possible attempt to separate words
5699 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
5700 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
5701 option, untie attempted while %d inner references still exist, Unrecognized
5702 character %s, Unsupported function fork, Use of "$$<digit>" to mean
5703 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
5704 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
5705 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
5706 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
5707 long, Process terminated by SIG%s
5708
5709 =item BUGS
5710
5711 =item SEE ALSO
5712
5713 =item HISTORY
5714
5715 =back
5716
5717 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
5718
5719 =over 4
5720
5721 =item DESCRIPTION
5722
5723 =over 4
5724
5725 =item Compiling Perl 5 on AIX
5726
5727 =item OS level
5728
5729 =item Building Dynamic Extensions on AIX
5730
5731 =item The IBM ANSI C Compiler
5732
5733 =item Using GNU's gcc for building perl
5734
5735 =item Using Large Files with Perl
5736
5737 =item Threaded Perl
5738
5739 =item 64-bit Perl
5740
5741 =item AIX 4.2 and extensions using C++ with statics
5742
5743 =back
5744
5745 =item AUTHOR
5746
5747 =item DATE
5748
5749 =back
5750
5751 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
5752
5753 =over 4
5754
5755 =item DESCRIPTION
5756
5757 =item AUTHOR
5758
5759 =back
5760
5761 =head2 perlamiga - Perl under Amiga OS
5762
5763 =over 4
5764
5765 =item SYNOPSIS
5766
5767 =back
5768
5769 =over 4
5770
5771 =item DESCRIPTION
5772
5773 =over 4
5774
5775 =item Prerequisites for Compiling Perl on AmigaOS
5776
5777 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
5778
5779 =item Starting Perl programs under AmigaOS
5780
5781 =item Shortcomings of Perl under AmigaOS
5782
5783 =back
5784
5785 =item INSTALLATION
5786
5787 =item Accessing documentation
5788
5789 =over 4
5790
5791 =item Manpages for Perl on AmigaOS
5792
5793 =item Perl HTML Documentation on AmigaOS
5794
5795 =item Perl GNU Info Files on AmigaOS
5796
5797 =item Perl LaTeX Documentation on AmigaOS
5798
5799 =back
5800
5801 =item BUILDING PERL ON AMIGAOS
5802
5803 =over 4
5804
5805 =item Build Prerequisites for Perl on AmigaOS
5806
5807 =item Getting the Perl Source for AmigaOS
5808
5809 =item Making Perl on AmigaOS
5810
5811 =item Testing Perl on AmigaOS
5812
5813 =item Installing the built Perl on AmigaOS
5814
5815 =back
5816
5817 =item AUTHORS
5818
5819 =item SEE ALSO
5820
5821 =back
5822
5823 =head2 perlbeos, README.beos - Perl version 5 on BeOS
5824
5825 =over 4
5826
5827 =item DESCRIPTION
5828
5829 =over 4
5830
5831 =item General Issues with Perl on BeOS
5832
5833 =item BeOS Release-specific Notes
5834
5835 R4 x86, R4 PPC
5836
5837 =item Contact Information
5838
5839 =back
5840
5841 =back
5842
5843 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
5844
5845 =over 4
5846
5847 =item SYNOPSIS
5848
5849 =item DESCRIPTION
5850
5851 =over 4
5852
5853 =item gzip on BS2000
5854
5855 =item bison on BS2000
5856
5857 =item Unpacking Perl Distribution on BS2000
5858
5859 =item Compiling Perl on BS2000
5860
5861 =item Testing Perl on BS2000
5862
5863 =item Installing Perl on BS2000
5864
5865 =item Using Perl in the Posix-Shell of BS2000
5866
5867 =item Using Perl in "native" BS2000
5868
5869 =item Floating point anomalies on BS2000
5870
5871 =back
5872
5873 =item AUTHORS
5874
5875 =item SEE ALSO
5876
5877 =over 4
5878
5879 =item Mailing list
5880
5881 =back
5882
5883 =item HISTORY
5884
5885 =back
5886
5887 =over 4
5888
5889 =item Name
5890
5891 =item Description
5892
5893 =item Build
5894
5895 =over 4
5896
5897 =item Tools & SDK
5898
5899 =item Make
5900
5901 =back
5902
5903 =item Acknowledgements
5904
5905 =item Author
5906
5907 =back
5908
5909 =head2 perlcygwin, README.cygwin - Perl for Cygwin
5910
5911 =over 4
5912
5913 =item SYNOPSIS
5914
5915 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
5916
5917 =over 4
5918
5919 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
5920
5921 =item Cygwin Configuration
5922
5923 C<PATH>, I<nroff>, Permissions
5924
5925 =back
5926
5927 =item CONFIGURE PERL ON CYGWIN
5928
5929 =over 4
5930
5931 =item Stripping Perl Binaries on Cygwin
5932
5933 =item Optional Libraries for Perl on Cygwin
5934
5935 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
5936 C<-lcygipc> (C<use IPC::SysV>)
5937
5938 =item Configure-time Options for Perl on Cygwin
5939
5940 C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
5941 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
5942
5943 =item Suspicious Warnings on Cygwin
5944
5945 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
5946
5947 =back
5948
5949 =item MAKE ON CYGWIN
5950
5951 =over 4
5952
5953 =item Warnings on Cygwin
5954
5955 =item ld2 on Cygwin
5956
5957 =back
5958
5959 =item TEST ON CYGWIN
5960
5961 =over 4
5962
5963 =item File Permissions on Cygwin
5964
5965 =item Hard Links on Cygwin
5966
5967 =item Filetime Granularity on Cygwin
5968
5969 =item Tainting Checks on Cygwin
5970
5971 =item /etc/group on Cygwin
5972
5973 =item Script Portability on Cygwin
5974
5975 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
5976
5977 =back
5978
5979 =item INSTALL PERL ON CYGWIN
5980
5981 =item MANIFEST ON CYGWIN
5982
5983 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
5984 Source, Compiled Module Source, Perl Modules/Scripts
5985
5986 =item BUGS ON CYGWIN
5987
5988 =item AUTHORS
5989
5990 =item HISTORY
5991
5992 =back
5993
5994 =head2 perldgux - Perl under DG/UX.
5995
5996 =over 4
5997
5998 =item SYNOPSIS
5999
6000 =back
6001
6002 =over 4
6003
6004 =item DESCRIPTION
6005
6006 =item BUILDING PERL ON DG/UX
6007
6008 =over 4
6009
6010 =item Non-threaded Perl on DG/UX
6011
6012 =item Threaded Perl on DG/UX
6013
6014 =item Testing Perl on DG/UX
6015
6016 =item Installing the built perl on DG/UX
6017
6018 =back
6019
6020 =item AUTHOR
6021
6022 =item SEE ALSO
6023
6024 =back
6025
6026 =head2 perlepoc, README.epoc - Perl for EPOC
6027
6028 =over 4
6029
6030 =item SYNOPSIS
6031
6032 =item INTRODUCTION
6033
6034 =item INSTALLING PERL ON EPOC
6035
6036 =item STARTING PERL ON EPOC
6037
6038 =item STOPPING PERL ON EPOC
6039
6040 =item USING PERL ON EPOC
6041
6042 =over 4
6043
6044 =item I/O Redirection on Epoc
6045
6046 =item PATH Names on Epoc
6047
6048 =item Editors on Epoc
6049
6050 =item Features of Perl on Epoc
6051
6052 =item Restrictions of Perl on Epoc
6053
6054 =item Compiling Perl 5 on the EPOC cross compiling environment
6055
6056 =back
6057
6058 =item SUPPORT STATUS OF PERL ON EPOC
6059
6060 =item AUTHOR
6061
6062 =item LAST UPDATE
6063
6064 =back
6065
6066 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
6067 (HP-UX) systems
6068
6069 =over 4
6070
6071 =item DESCRIPTION
6072
6073 =over 4
6074
6075 =item Compiling Perl 5 on HP-UX
6076
6077 =item PA-RISC
6078
6079 =item PA-RISC 1.0
6080
6081 =item PA-RISC 1.1
6082
6083 =item PA-RISC 2.0
6084
6085 =item Portability Between PA-RISC Versions
6086
6087 =item Itanium Processor Family and HP-UX
6088
6089 =item Building Dynamic Extensions on HP-UX
6090
6091 =item The HP ANSI C Compiler
6092
6093 =item Using Large Files with Perl on HP-UX
6094
6095 =item Threaded Perl on HP-UX
6096
6097 =item 64-bit Perl on HP-UX
6098
6099 =item GDBM and Threads on HP-UX
6100
6101 =item NFS filesystems and utime(2) on HP-UX
6102
6103 =item perl -P and // and HP-UX
6104
6105 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
6106
6107 =back
6108
6109 =item AUTHOR
6110
6111 =item DATE
6112
6113 =back
6114
6115 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
6116
6117 =over 4
6118
6119 =item DESCRIPTION
6120
6121 =over 4
6122
6123 =item Known Problems with Perl on Hurd
6124
6125 =back
6126
6127 =item AUTHOR
6128
6129 =back
6130
6131 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
6132 systems
6133
6134 =over 4
6135
6136 =item DESCRIPTION
6137
6138 =over 4
6139
6140 =item Compiling Perl 5 on MachTen
6141
6142 =item Failures during C<make test> on MachTen
6143
6144 op/lexassign.t, pragma/warnings.t
6145
6146 =item Building external modules on MachTen
6147
6148 =back
6149
6150 =item AUTHOR
6151
6152 =item DATE
6153
6154 =back
6155
6156 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
6157
6158 =over 4
6159
6160 =item SYNOPSIS
6161
6162 =item DESCRIPTION
6163
6164 =item AUTHOR
6165
6166 =item DATE
6167
6168 =back
6169
6170 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
6171
6172 =over 4
6173
6174 =item DESCRIPTION
6175
6176 =item Known problems with Perl on MiNT
6177
6178 =item AUTHOR
6179
6180 =back
6181
6182 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
6183
6184 =over 4
6185
6186 =item SYNOPSIS
6187
6188 =item NOTE
6189
6190 =item What's New in Perl ffor MPE/iX
6191
6192 =item Welcome to Perl/iX
6193
6194 =item System Requirements for Perl/iX
6195
6196 =item How to Obtain Perl/iX
6197
6198 =item Perl/iX Distribution Contents Highlights
6199
6200 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
6201 public_html/feedback.cgi, src/perl-5.6.0-mpe
6202
6203 =item How to Compile Perl/iX
6204
6205  4,  6
6206
6207 =item Getting Started with Perl/iX
6208
6209 =item MPE/iX Implementation Considerations
6210
6211 =item Known Perl/iX Bugs Under Investigation
6212
6213 =item Perl/iX To-Do List
6214
6215 =item Perl/iX Change History
6216
6217 =item AUTHOR
6218
6219 =item Name
6220
6221 =item Description
6222
6223 =item Build
6224
6225 =over 4
6226
6227 =item Tools & SDK
6228
6229 =item Setup
6230
6231 Buildtype.bat, SetNWBld.bat, MPKBuild.bat
6232
6233 =item Make
6234
6235 =item Interpreter
6236
6237 =item Extensions
6238
6239 =back
6240
6241 =item Install
6242
6243 =item Build new extensions
6244
6245 =item Known Issues
6246
6247 =item Acknowledgements
6248
6249 =item Authors
6250
6251 =item Date
6252
6253 =back
6254
6255 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
6256
6257 =over 4
6258
6259 =item SYNOPSIS
6260
6261 =back
6262
6263 =over 4
6264
6265 =item DESCRIPTION
6266
6267 =over 4
6268
6269 =item Target
6270
6271 =item Other OSes
6272
6273 =item Prerequisites
6274
6275 EMX, RSX, HPFS, pdksh
6276
6277 =item Starting Perl programs under OS/2 (and DOS and...)
6278
6279 =item Starting OS/2 (and DOS) programs under Perl
6280
6281 =back
6282
6283 =item Frequently asked questions
6284
6285 =over 4
6286
6287 =item "It does not work"
6288
6289 =item I cannot run external programs
6290
6291 =item I cannot embed perl into my program, or use F<perl.dll> from my
6292 program.
6293
6294 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
6295 L<ExtUtils::Embed>?
6296
6297 =item C<``> and pipe-C<open> do not work under DOS.
6298
6299 =item Cannot start C<find.exe "pattern" file>
6300
6301 =back
6302
6303 =item INSTALLATION
6304
6305 =over 4
6306
6307 =item Automatic binary installation
6308
6309 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
6310
6311 =item Manual binary installation
6312
6313 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
6314 (statically linked), Executables for Perl utilities, Main Perl library,
6315 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
6316 and utilities, Manpages for Perl modules, Source for Perl documentation,
6317 Perl manual in F<.INF> format, Pdksh
6318
6319 =item B<Warning>
6320
6321 =back
6322
6323 =item Accessing documentation
6324
6325 =over 4
6326
6327 =item OS/2 F<.INF> file
6328
6329 =item Plain text
6330
6331 =item Manpages
6332
6333 =item HTML
6334
6335 =item GNU C<info> files
6336
6337 =item F<.PDF> files
6338
6339 =item C<LaTeX> docs
6340
6341 =back
6342
6343 =item BUILD
6344
6345 =over 4
6346
6347 =item The short story
6348
6349 =item Prerequisites
6350
6351 =item Getting perl source
6352
6353 =item Application of the patches
6354
6355 =item Hand-editing
6356
6357 =item Making
6358
6359 =item Testing
6360
6361 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
6362 F<op/stat.t>
6363
6364 =item Installing the built perl
6365
6366 =item C<a.out>-style build
6367
6368 =back
6369
6370 =item Build FAQ
6371
6372 =over 4
6373
6374 =item Some C</> became C<\> in pdksh.
6375
6376 =item C<'errno'> - unresolved external
6377
6378 =item Problems with tr or sed
6379
6380 =item Some problem (forget which ;-)
6381
6382 =item Library ... not found
6383
6384 =item Segfault in make
6385
6386 =item op/sprintf test failure
6387
6388 =back
6389
6390 =item Specific (mis)features of OS/2 port
6391
6392 =over 4
6393
6394 =item C<setpriority>, C<getpriority>
6395
6396 =item C<system()>
6397
6398 =item C<extproc> on the first line
6399
6400 =item Additional modules:
6401
6402 =item Prebuilt methods:
6403
6404 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
6405  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
6406 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
6407 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
6408 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
6409 C<Cwd::extLibpath_set( path [, type ] )>,
6410 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
6411 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
6412 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
6413 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
6414 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
6415
6416 =item Prebuilt variables:
6417
6418 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
6419
6420 =item Misfeatures
6421
6422 =item Modifications
6423
6424 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
6425 C<flock>
6426
6427 =item Identifying DLLs
6428
6429 =item Centralized management of resources
6430
6431 C<HAB>, C<HMQ>
6432
6433 =back
6434
6435 =item Perl flavors
6436
6437 =over 4
6438
6439 =item F<perl.exe>
6440
6441 =item F<perl_.exe>
6442
6443 =item F<perl__.exe>
6444
6445 =item F<perl___.exe>
6446
6447 =item Why strange names?
6448
6449 =item Why dynamic linking?
6450
6451 =item Why chimera build?
6452
6453 =back
6454
6455 =item ENVIRONMENT
6456
6457 =over 4
6458
6459 =item C<PERLLIB_PREFIX>
6460
6461 =item C<PERL_BADLANG>
6462
6463 =item C<PERL_BADFREE>
6464
6465 =item C<PERL_SH_DIR>
6466
6467 =item C<USE_PERL_FLOCK>
6468
6469 =item C<TMP> or C<TEMP>
6470
6471 =back
6472
6473 =item Evolution
6474
6475 =over 4
6476
6477 =item Priorities
6478
6479 =item DLL name mangling: pre 5.6.2
6480
6481 =item DLL name mangling: 5.6.2 and beyond
6482
6483 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
6484 C<LIBPATH>
6485
6486 =item DLL forwarder generation
6487
6488 =item Threading
6489
6490 =item Calls to external programs
6491
6492 =item Memory allocation
6493
6494 =item Threads
6495
6496 C<COND_WAIT>, F<os2.c>
6497
6498 =back
6499
6500 =item BUGS
6501
6502 =back
6503
6504 =over 4
6505
6506 =item AUTHOR
6507
6508 =item SEE ALSO
6509
6510 =back
6511
6512 =head2 perlos390, README.os390 - building and installing Perl for OS/390.
6513
6514 =over 4
6515
6516 =item SYNOPSIS
6517
6518 =item DESCRIPTION
6519
6520 =over 4
6521
6522 =item Unpacking Perl distribution on OS/390
6523
6524 =item Setup and utilities for Perl on OS/390
6525
6526 =item Configure Perl on OS/390
6527
6528 =item Build, Test, Install Perl on OS/390
6529
6530 =item Build Anomalies with Perl on OS/390
6531
6532 =item Testing Anomalies with Perl on OS/390
6533
6534 =item Installation Anomalies with Perl on OS/390
6535
6536 =item Usage Hints for Perl on OS/390
6537
6538 =item Floating Point Anomalies with Perl on OS/390
6539
6540 =item Modules and Extensions for Perl on OS/390
6541
6542 =back
6543
6544 =item AUTHORS
6545
6546 =item SEE ALSO
6547
6548 =over 4
6549
6550 =item Mailing list for Perl on OS/390
6551
6552 =back
6553
6554 =item HISTORY
6555
6556 =back
6557
6558 =head2 perlqnx, README.qnx - Perl version 5 on QNX
6559
6560 =over 4
6561
6562 =item DESCRIPTION
6563
6564 =over 4
6565
6566 =item Required Software for Compiling Perl on QNX4
6567
6568 /bin/sh, ar, nm, cpp, make
6569
6570 =item Outstanding Issues with Perl on QNX4
6571
6572 =item QNX auxiliary files
6573
6574 qnx/ar, qnx/cpp
6575
6576 =item Outstanding issues with perl under QNX6
6577
6578 =back
6579
6580 =item AUTHOR
6581
6582 =back
6583
6584 =head2 perlplan9 - Plan 9-specific documentation for Perl
6585
6586 =over 4
6587
6588 =item DESCRIPTION
6589
6590 =over 4
6591
6592 =item Invoking Perl
6593
6594 =item What's in Plan 9 Perl
6595
6596 =item What's not in Plan 9 Perl
6597
6598 =item Perl5 Functions not currently supported in Plan 9 Perl
6599
6600 =item Signals in Plan 9 Perl
6601
6602 =back
6603
6604 =item COMPILING AND INSTALLING PERL ON PLAN 9
6605
6606 =over 4
6607
6608 =item Installing Perl Documentation on Plan 9
6609
6610 =back
6611
6612 =item BUGS
6613
6614 =item Revision date
6615
6616 =item AUTHOR
6617
6618 =back
6619
6620 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
6621
6622 =over 4
6623
6624 =item DESCRIPTION
6625
6626 =over 4
6627
6628 =item Solaris Version Numbers.
6629
6630 =back
6631
6632 =item RESOURCES
6633
6634 Solaris FAQ, Precompiled Binaries, Solaris Documentation
6635
6636 =item SETTING UP
6637
6638 =over 4
6639
6640 =item File Extraction Problems on Solaris.
6641
6642 =item Compiler and Related Tools on Solaris.
6643
6644 =item Environment for Compiling Perl on Solaris
6645
6646 =back
6647
6648 =item RUN CONFIGURE.
6649
6650 =over 4
6651
6652 =item 64-bit Issues with Perl on Solaris.
6653
6654 =item Threads in Perl on Solaris.
6655
6656 =item Malloc Issues with Perl on Solaris.
6657
6658 =back
6659
6660 =item MAKE PROBLEMS.
6661
6662 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
6663 relocation error:, dlopen: stub interception failed, #error "No
6664 DATAMODEL_NATIVE specified", sh: ar: not found
6665
6666 =item MAKE TEST
6667
6668 =over 4
6669
6670 =item op/stat.t test 4 in Solaris
6671
6672 =back
6673
6674 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
6675
6676 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
6677
6678 =over 4
6679
6680 =item Limits on Numbers of Open Files on Solaris.
6681
6682 =back
6683
6684 =item SOLARIS-SPECIFIC MODULES.
6685
6686 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
6687
6688 =over 4
6689
6690 =item Proc::ProcessTable on Solaris
6691
6692 =item BSD::Resource on Solaris
6693
6694 =item Net::SSLeay on Solaris
6695
6696 =back
6697
6698 =item AUTHOR
6699
6700 =item LAST MODIFIED
6701
6702 =back
6703
6704 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
6705 Digital UNIX formerly known as DEC OSF/1) systems
6706
6707 =over 4
6708
6709 =item DESCRIPTION
6710
6711 =over 4
6712
6713 =item Compiling Perl 5 on Tru64
6714
6715 =item Using Large Files with Perl on Tru64
6716
6717 =item Threaded Perl on Tru64
6718
6719 =item Long Doubles on Tru64
6720
6721 =item 64-bit Perl on Tru64
6722
6723 =item Warnings about floating-point overflow when compiling Perl on Tru64
6724
6725 =back
6726
6727 =item Testing Perl on Tru64
6728
6729 =item AUTHOR
6730
6731 =back
6732
6733 =head2 perluts - Perl under UTS
6734
6735 =over 4
6736
6737 =item SYNOPSIS
6738
6739 =item DESCRIPTION
6740
6741 =item BUILDING PERL ON UTS
6742
6743 =item Installing the built perl on UTS
6744
6745 =item AUTHOR
6746
6747 =back
6748
6749 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
6750
6751 =over 4
6752
6753 =item SYNOPSIS
6754
6755 =item DESCRIPTION
6756
6757 =over 4
6758
6759 =item Unpacking Perl Distribution on VM/ESA
6760
6761 =item Setup Perl and utilities on VM/ESA
6762
6763 =item Configure Perl on VM/ESA
6764
6765 =item Testing Anomalies of Perl on VM/ESA
6766
6767 =item Usage Hints for Perl on VM/ESA
6768
6769 =back
6770
6771 =item AUTHORS
6772
6773 =item SEE ALSO
6774
6775 =over 4
6776
6777 =item Mailing list for Perl on VM/ESA
6778
6779 =back
6780
6781 =back
6782
6783 =head2 perlvms - VMS-specific documentation for Perl
6784
6785 =over 4
6786
6787 =item DESCRIPTION
6788
6789 =item Installation
6790
6791 =item Organization of Perl Images
6792
6793 =over 4
6794
6795 =item Core Images
6796
6797 =item Perl Extensions
6798
6799 =item Installing static extensions
6800
6801 =item Installing dynamic extensions
6802
6803 =back
6804
6805 =item File specifications
6806
6807 =over 4
6808
6809 =item Syntax
6810
6811 =item Wildcard expansion
6812
6813 =item Pipes
6814
6815 =back
6816
6817 =item PERL5LIB and PERLLIB
6818
6819 =item Command line
6820
6821 =over 4
6822
6823 =item I/O redirection and backgrounding
6824
6825 =item Command line switches
6826
6827 -i, -S, -u
6828
6829 =back
6830
6831 =item Perl functions
6832
6833 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
6834 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
6835 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
6836 LIST, waitpid PID,FLAGS
6837
6838 =item Perl variables
6839
6840 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
6841
6842 =item Standard modules with VMS-specific differences
6843
6844 =over 4
6845
6846 =item SDBM_File
6847
6848 =back
6849
6850 =item Revision date
6851
6852 =item AUTHOR
6853
6854 =back
6855
6856 =head2 perlvos, README.vos - Perl for Stratus VOS
6857
6858 =over 4
6859
6860 =item SYNOPSIS
6861
6862 =over 4
6863
6864 =item Stratus POSIX Support
6865
6866 =back
6867
6868 =item INSTALLING PERL IN VOS
6869
6870 =over 4
6871
6872 =item Compiling Perl 5 on VOS
6873
6874 =item Installing Perl 5 on VOS
6875
6876 =back
6877
6878 =item USING PERL IN VOS
6879
6880 =over 4
6881
6882 =item Unimplemented Features of Perl on VOS
6883
6884 =item Restrictions of Perl on VOS
6885
6886 =back
6887
6888 =item SUPPORT STATUS
6889
6890 =item AUTHOR
6891
6892 =item LAST UPDATE
6893
6894 =back
6895
6896 =head1 PRAGMA DOCUMENTATION
6897
6898 =head2 attrs - set/get attributes of a subroutine (deprecated)
6899
6900 =over 4
6901
6902 =item SYNOPSIS
6903
6904 =item DESCRIPTION
6905
6906 method, locked
6907
6908 =back
6909
6910 =head2 re - Perl pragma to alter regular expression behaviour
6911
6912 =over 4
6913
6914 =item SYNOPSIS
6915
6916 =item DESCRIPTION
6917
6918 =back
6919
6920 =head2 threads - Perl extension allowing use of interpreter based threads
6921 from perl
6922
6923 =over 4
6924
6925 =item SYNOPSIS
6926
6927 =item DESCRIPTION
6928
6929 new, function, LIST, $threads->join, $threads->detach, threads->self,
6930 $threads->tid
6931
6932 =item TODO
6933
6934 Fix so the return value is returned when you join, Add join_all, Fix memory
6935 leaks!
6936
6937 =item AUTHOR and COPYRIGHT
6938
6939 =item BUGS
6940
6941 creating a thread from within a thread is unsafe under win32
6942
6943 =item SEE ALSO
6944
6945 =back
6946
6947 =head2 attributes - get/set subroutine or variable attributes
6948
6949 =over 4
6950
6951 =item SYNOPSIS
6952
6953 =item DESCRIPTION
6954
6955 =over 4
6956
6957 =item Built-in Attributes
6958
6959 locked, method, lvalue
6960
6961 =item Available Subroutines
6962
6963 get, reftype
6964
6965 =item Package-specific Attribute Handling
6966
6967 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
6968
6969 =item Syntax of Attribute Lists
6970
6971 =back
6972
6973 =item EXPORTS
6974
6975 =over 4
6976
6977 =item Default exports
6978
6979 =item Available exports
6980
6981 =item Export tags defined
6982
6983 =back
6984
6985 =item EXAMPLES
6986
6987 =item SEE ALSO
6988
6989 =back
6990
6991 =head2 attrs - set/get attributes of a subroutine (deprecated)
6992
6993 =over 4
6994
6995 =item SYNOPSIS
6996
6997 =item DESCRIPTION
6998
6999 method, locked
7000
7001 =back
7002
7003 =head2 autouse - postpone load of modules until a function is used
7004
7005 =over 4
7006
7007 =item SYNOPSIS
7008
7009 =item DESCRIPTION
7010
7011 =item WARNING
7012
7013 =item AUTHOR
7014
7015 =item SEE ALSO
7016
7017 =back
7018
7019 =head2 base - Establish IS-A relationship with base class at compile time
7020
7021 =over 4
7022
7023 =item SYNOPSIS
7024
7025 =item DESCRIPTION
7026
7027 =item HISTORY
7028
7029 =item SEE ALSO
7030
7031 =back
7032
7033 =head2 blib - Use MakeMaker's uninstalled version of a package
7034
7035 =over 4
7036
7037 =item SYNOPSIS
7038
7039 =item DESCRIPTION
7040
7041 =item BUGS
7042
7043 =item AUTHOR
7044
7045 =back
7046
7047 =head2 bytes - Perl pragma to force byte semantics rather than character
7048 semantics
7049
7050 =over 4
7051
7052 =item SYNOPSIS
7053
7054 =item DESCRIPTION
7055
7056 =item SEE ALSO
7057
7058 =back
7059
7060 =head2 charnames - define character names for C<\N{named}> string literal
7061 escape.
7062
7063 =over 4
7064
7065 =item SYNOPSIS
7066
7067 =item DESCRIPTION
7068
7069 =item CUSTOM TRANSLATORS
7070
7071 =item BUGS
7072
7073 =back
7074
7075 =head2 constant - Perl pragma to declare constants
7076
7077 =over 4
7078
7079 =item SYNOPSIS
7080
7081 =item DESCRIPTION
7082
7083 =item NOTES
7084
7085 =over 4
7086
7087 =item List constants
7088
7089 =item Defining multiple constants at once
7090
7091 =item Magic constants
7092
7093 =back
7094
7095 =item TECHNICAL NOTES
7096
7097 =item BUGS
7098
7099 =item AUTHOR
7100
7101 =item COPYRIGHT
7102
7103 =back
7104
7105 =head2 diagnostics - Perl compiler pragma to force verbose warning
7106 diagnostics
7107
7108 =over 4
7109
7110 =item SYNOPSIS
7111
7112 =item DESCRIPTION
7113
7114 =over 4
7115
7116 =item The C<diagnostics> Pragma
7117
7118 =item The I<splain> Program
7119
7120 =back
7121
7122 =item EXAMPLES
7123
7124 =item INTERNALS
7125
7126 =item BUGS
7127
7128 =item AUTHOR
7129
7130 =back
7131
7132 =head2 fields - compile-time class fields
7133
7134 =over 4
7135
7136 =item SYNOPSIS
7137
7138 =item DESCRIPTION
7139
7140 new, phash
7141
7142 =item SEE ALSO
7143
7144 =back
7145
7146 =head2 filetest - Perl pragma to control the filetest permission operators
7147
7148 =over 4
7149
7150 =item SYNOPSIS
7151
7152 =item DESCRIPTION
7153
7154 =over 4
7155
7156 =item subpragma access
7157
7158 =back
7159
7160 =back
7161
7162 =head2 integer - Perl pragma to use integer arithmetic instead of floating
7163 point
7164
7165 =over 4
7166
7167 =item SYNOPSIS
7168
7169 =item DESCRIPTION
7170
7171 =back
7172
7173 =head2 less - perl pragma to request less of something from the compiler
7174
7175 =over 4
7176
7177 =item SYNOPSIS
7178
7179 =item DESCRIPTION
7180
7181 =back
7182
7183 =head2 lib - manipulate @INC at compile time
7184
7185 =over 4
7186
7187 =item SYNOPSIS
7188
7189 =item DESCRIPTION
7190
7191 =over 4
7192
7193 =item Adding directories to @INC
7194
7195 =item Deleting directories from @INC
7196
7197 =item Restoring original @INC
7198
7199 =back
7200
7201 =item SEE ALSO
7202
7203 =item AUTHOR
7204
7205 =back
7206
7207 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
7208 operations
7209
7210 =over 4
7211
7212 =item SYNOPSIS
7213
7214 =item DESCRIPTION
7215
7216 =back
7217
7218 =head2 open - perl pragma to set default disciplines for input and output
7219
7220 =over 4
7221
7222 =item SYNOPSIS
7223
7224 =item DESCRIPTION
7225
7226 =item NONPERLIO FUNCTIONALITY
7227
7228 =item IMPLEMENTATION DETAILS
7229
7230 =item SEE ALSO
7231
7232 =back
7233
7234 =head2 ops - Perl pragma to restrict unsafe operations when compiling
7235
7236 =over 4
7237
7238 =item SYNOPSIS
7239
7240 =item DESCRIPTION
7241
7242 =item SEE ALSO
7243
7244 =back
7245
7246 =head2 overload - Package for overloading perl operations
7247
7248 =over 4
7249
7250 =item SYNOPSIS
7251
7252 =item DESCRIPTION
7253
7254 =over 4
7255
7256 =item Declaration of overloaded functions
7257
7258 =item Calling Conventions for Binary Operations
7259
7260 FALSE, TRUE, C<undef>
7261
7262 =item Calling Conventions for Unary Operations
7263
7264 =item Calling Conventions for Mutators
7265
7266 C<++> and C<-->, C<x=> and other assignment versions
7267
7268 =item Overloadable Operations
7269
7270 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
7271 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
7272 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
7273
7274 =item Inheritance and overloading
7275
7276 Strings as values of C<use overload> directive, Overloading of an operation
7277 is inherited by derived classes
7278
7279 =back
7280
7281 =item SPECIAL SYMBOLS FOR C<use overload>
7282
7283 =over 4
7284
7285 =item Last Resort
7286
7287 =item Fallback
7288
7289 C<undef>, TRUE, defined, but FALSE
7290
7291 =item Copy Constructor
7292
7293 B<Example>
7294
7295 =back
7296
7297 =item MAGIC AUTOGENERATION
7298
7299 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
7300 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
7301 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
7302 I<Copy operator>
7303
7304 =item Losing overloading
7305
7306 =item Run-time Overloading
7307
7308 =item Public functions
7309
7310 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
7311
7312 =item Overloading constants
7313
7314 integer, float, binary, q, qr
7315
7316 =item IMPLEMENTATION
7317
7318 =item Metaphor clash
7319
7320 =item Cookbook
7321
7322 =over 4
7323
7324 =item Two-face scalars
7325
7326 =item Two-face references
7327
7328 =item Symbolic calculator
7329
7330 =item I<Really> symbolic calculator
7331
7332 =back
7333
7334 =item AUTHOR
7335
7336 =item DIAGNOSTICS
7337
7338 Odd number of arguments for overload::constant, `%s' is not an overloadable
7339 type, `%s' is not a code reference
7340
7341 =item BUGS
7342
7343 =back
7344
7345 =head2 re - Perl pragma to alter regular expression behaviour
7346
7347 =over 4
7348
7349 =item SYNOPSIS
7350
7351 =item DESCRIPTION
7352
7353 =back
7354
7355 =head2 sigtrap - Perl pragma to enable simple signal handling
7356
7357 =over 4
7358
7359 =item SYNOPSIS
7360
7361 =item DESCRIPTION
7362
7363 =item OPTIONS
7364
7365 =over 4
7366
7367 =item SIGNAL HANDLERS
7368
7369 B<stack-trace>, B<die>, B<handler> I<your-handler>
7370
7371 =item SIGNAL LISTS
7372
7373 B<normal-signals>, B<error-signals>, B<old-interface-signals>
7374
7375 =item OTHER
7376
7377 B<untrapped>, B<any>, I<signal>, I<number>
7378
7379 =back
7380
7381 =item EXAMPLES
7382
7383 =back
7384
7385 =head2 strict - Perl pragma to restrict unsafe constructs
7386
7387 =over 4
7388
7389 =item SYNOPSIS
7390
7391 =item DESCRIPTION
7392
7393 C<strict refs>, C<strict vars>, C<strict subs>
7394
7395 =back
7396
7397 =head2 subs - Perl pragma to predeclare sub names
7398
7399 =over 4
7400
7401 =item SYNOPSIS
7402
7403 =item DESCRIPTION
7404
7405 =back
7406
7407 =head2 threads - Perl extension allowing use of interpreter based threads
7408 from perl
7409
7410 =over 4
7411
7412 =item SYNOPSIS
7413
7414 =item DESCRIPTION
7415
7416 new, function, LIST, $threads->join, $threads->detach, threads->self,
7417 $threads->tid
7418
7419 =item TODO
7420
7421 Fix so the return value is returned when you join, Add join_all, Fix memory
7422 leaks!
7423
7424 =item AUTHOR and COPYRIGHT
7425
7426 =item BUGS
7427
7428 creating a thread from within a thread is unsafe under win32
7429
7430 =item SEE ALSO
7431
7432 =back
7433
7434 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
7435 code
7436
7437 =over 4
7438
7439 =item SYNOPSIS
7440
7441 =item DESCRIPTION
7442
7443 =over 4
7444
7445 =item Utility functions
7446
7447 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
7448 utf8::encode($string), $flag = utf8::decode($string)
7449
7450 =back
7451
7452 =item SEE ALSO
7453
7454 =back
7455
7456 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
7457
7458 =over 4
7459
7460 =item SYNOPSIS
7461
7462 =item DESCRIPTION
7463
7464 =back
7465
7466 =head2 warnings - Perl pragma to control optional warnings
7467
7468 =over 4
7469
7470 =item SYNOPSIS
7471
7472 =item DESCRIPTION
7473
7474 use warnings::register, warnings::enabled(), warnings::enabled($category),
7475 warnings::enabled($object), warnings::warn($message),
7476 warnings::warn($category, $message), warnings::warn($object, $message),
7477 warnings::warnif($message), warnings::warnif($category, $message),
7478 warnings::warnif($object, $message)
7479
7480 =back
7481
7482 =head2 warnings::register - warnings import function
7483
7484 =over 4
7485
7486 =item SYNOPSIS
7487
7488 =item DESCRIPTION
7489
7490 =back
7491
7492 =head1 MODULE DOCUMENTATION
7493
7494 =head2 AnyDBM_File - provide framework for multiple DBMs
7495
7496 =over 4
7497
7498 =item SYNOPSIS
7499
7500 =item DESCRIPTION
7501
7502 =over 4
7503
7504 =item DBM Comparisons
7505
7506 [0], [1], [2], [3]
7507
7508 =back
7509
7510 =item SEE ALSO
7511
7512 =back
7513
7514 =head2 Attribute::Handlers - Simpler definition of attribute handlers
7515
7516 =over 4
7517
7518 =item VERSION
7519
7520 =item SYNOPSIS
7521
7522 =item DESCRIPTION
7523
7524 [0], [1], [2], [3], [4], [5]
7525
7526 =over 4
7527
7528 =item Typed lexicals
7529
7530 =item Type-specific attribute handlers
7531
7532 =item Non-interpretive attribute handlers
7533
7534 =item Phase-specific attribute handlers
7535
7536 =item Attributes as C<tie> interfaces
7537
7538 =back
7539
7540 =item EXAMPLES
7541
7542 =item DIAGNOSTICS
7543
7544 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
7545 attributes>, C<Declaration of %s attribute in package %s may clash with
7546 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
7547 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
7548
7549 =item AUTHOR
7550
7551 =item BUGS
7552
7553 =item COPYRIGHT
7554
7555 =back
7556
7557 =head2 AutoLoader - load subroutines only on demand
7558
7559 =over 4
7560
7561 =item SYNOPSIS
7562
7563 =item DESCRIPTION
7564
7565 =over 4
7566
7567 =item Subroutine Stubs
7568
7569 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
7570
7571 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
7572
7573 =item Package Lexicals
7574
7575 =item Not Using AutoLoader
7576
7577 =item B<AutoLoader> vs. B<SelfLoader>
7578
7579 =back
7580
7581 =item CAVEATS
7582
7583 =item SEE ALSO
7584
7585 =back
7586
7587 =head2 AutoSplit - split a package for autoloading
7588
7589 =over 4
7590
7591 =item SYNOPSIS
7592
7593 =item DESCRIPTION
7594
7595 $keep, $check, $modtime
7596
7597 =over 4
7598
7599 =item Multiple packages
7600
7601 =back
7602
7603 =item DIAGNOSTICS
7604
7605 =back
7606
7607 =head2 B - The Perl Compiler
7608
7609 =over 4
7610
7611 =item SYNOPSIS
7612
7613 =item DESCRIPTION
7614
7615 =item OVERVIEW OF CLASSES
7616
7617 =over 4
7618
7619 =item SV-RELATED CLASSES
7620
7621 =item B::SV METHODS
7622
7623 REFCNT, FLAGS
7624
7625 =item B::IV METHODS
7626
7627 IV, IVX, UVX, int_value, needs64bits, packiv
7628
7629 =item B::NV METHODS
7630
7631 NV, NVX
7632
7633 =item B::RV METHODS
7634
7635 RV
7636
7637 =item B::PV METHODS
7638
7639 PV, PVX
7640
7641 =item B::PVMG METHODS
7642
7643 MAGIC, SvSTASH
7644
7645 =item B::MAGIC METHODS
7646
7647 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
7648
7649 =item B::PVLV METHODS
7650
7651 TARGOFF, TARGLEN, TYPE, TARG
7652
7653 =item B::BM METHODS
7654
7655 USEFUL, PREVIOUS, RARE, TABLE
7656
7657 =item B::GV METHODS
7658
7659 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
7660 LINE, FILE, FILEGV, GvREFCNT, FLAGS
7661
7662 =item B::IO METHODS
7663
7664 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
7665 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
7666
7667 =item B::AV METHODS
7668
7669 FILL, MAX, OFF, ARRAY, AvFLAGS
7670
7671 =item B::CV METHODS
7672
7673 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
7674 CvFLAGS, const_sv
7675
7676 =item B::HV METHODS
7677
7678 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
7679
7680 =item OP-RELATED CLASSES
7681
7682 =item B::OP METHODS
7683
7684 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
7685
7686 =item B::UNOP METHOD
7687
7688 first
7689
7690 =item B::BINOP METHOD
7691
7692 last
7693
7694 =item B::LOGOP METHOD
7695
7696 other
7697
7698 =item B::LISTOP METHOD
7699
7700 children
7701
7702 =item B::PMOP METHODS
7703
7704 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
7705
7706 =item B::SVOP METHOD
7707
7708 sv, gv
7709
7710 =item B::PADOP METHOD
7711
7712 padix
7713
7714 =item B::PVOP METHOD
7715
7716 pv
7717
7718 =item B::LOOP METHODS
7719
7720 redoop, nextop, lastop
7721
7722 =item B::COP METHODS
7723
7724 label, stash, file, cop_seq, arybase, line
7725
7726 =back
7727
7728 =item FUNCTIONS EXPORTED BY C<B>
7729
7730 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
7731 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
7732 walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
7733 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
7734 threadsv_names
7735
7736 =item AUTHOR
7737
7738 =back
7739
7740 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
7741 bytecode
7742
7743 =over 4
7744
7745 =item SYNOPSIS
7746
7747 =item DESCRIPTION
7748
7749 =item AUTHOR
7750
7751 =back
7752
7753 =head2 B::Assembler - Assemble Perl bytecode
7754
7755 =over 4
7756
7757 =item SYNOPSIS
7758
7759 =item DESCRIPTION
7760
7761 =item AUTHORS
7762
7763 =back
7764
7765 =head2 B::Bblock - Walk basic blocks
7766
7767 =over 4
7768
7769 =item SYNOPSIS
7770
7771 =item DESCRIPTION
7772
7773 =item AUTHOR
7774
7775 =back
7776
7777 =head2 B::Bytecode - Perl compiler's bytecode backend
7778
7779 =over 4
7780
7781 =item SYNOPSIS
7782
7783 =item DESCRIPTION
7784
7785 =item OPTIONS
7786
7787 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7788 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7789 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
7790
7791 =item EXAMPLES
7792
7793 =item BUGS
7794
7795 =item AUTHORS
7796
7797 =back
7798
7799 =head2 B::C - Perl compiler's C backend
7800
7801 =over 4
7802
7803 =item SYNOPSIS
7804
7805 =item DESCRIPTION
7806
7807 =item OPTIONS
7808
7809 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
7810 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
7811
7812 =item EXAMPLES
7813
7814 =item BUGS
7815
7816 =item AUTHOR
7817
7818 =back
7819
7820 =head2 B::CC - Perl compiler's optimized C translation backend
7821
7822 =over 4
7823
7824 =item SYNOPSIS
7825
7826 =item DESCRIPTION
7827
7828 =item OPTIONS
7829
7830 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
7831 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
7832 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
7833
7834 =item EXAMPLES
7835
7836 =item BUGS
7837
7838 =item DIFFERENCES
7839
7840 =over 4
7841
7842 =item Loops
7843
7844 =item Context of ".."
7845
7846 =item Arithmetic
7847
7848 =item Deprecated features
7849
7850 =back
7851
7852 =item AUTHOR
7853
7854 =back
7855
7856 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
7857
7858 =over 4
7859
7860 =item SYNOPSIS
7861
7862 =item DESCRIPTION
7863
7864 =item OPTIONS
7865
7866 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
7867 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
7868 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
7869
7870 =item FORMATTING SPECIFICATIONS
7871
7872 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
7873 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
7874 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
7875 B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
7876 B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
7877 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
7878 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
7879 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
7880
7881 =item ABBREVIATIONS
7882
7883 =over 4
7884
7885 =item OP flags abbreviations
7886
7887 =item OP class abbreviations
7888
7889 =back
7890
7891 =item Using B::Concise outside of the O framework
7892
7893 =item AUTHOR
7894
7895 =back
7896
7897 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
7898
7899 =over 4
7900
7901 =item SYNOPSIS
7902
7903 =item DESCRIPTION
7904
7905 =item AUTHOR
7906
7907 =back
7908
7909 =head2 B::Deparse - Perl compiler backend to produce perl code
7910
7911 =over 4
7912
7913 =item SYNOPSIS
7914
7915 =item DESCRIPTION
7916
7917 =item OPTIONS
7918
7919 B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
7920 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
7921
7922 =item USING B::Deparse AS A MODULE
7923
7924 =over 4
7925
7926 =item Synopsis
7927
7928 =item Description
7929
7930 =item new
7931
7932 =item ambient_pragmas
7933
7934 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
7935
7936 =item coderef2text
7937
7938 =back
7939
7940 =item BUGS
7941
7942 =item AUTHOR
7943
7944 =back
7945
7946 =head2 B::Disassembler - Disassemble Perl bytecode
7947
7948 =over 4
7949
7950 =item SYNOPSIS
7951
7952 =item DESCRIPTION
7953
7954 =item AUTHOR
7955
7956 =back
7957
7958 =head2 B::Lint - Perl lint
7959
7960 =over 4
7961
7962 =item SYNOPSIS
7963
7964 =item DESCRIPTION
7965
7966 =item OPTIONS AND LINT CHECKS
7967
7968 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
7969 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
7970
7971 =item NON LINT-CHECK OPTIONS
7972
7973 B<-u Package>
7974
7975 =item BUGS
7976
7977 =item AUTHOR
7978
7979 =back
7980
7981 =head2 B::O, O - Generic interface to Perl Compiler backends
7982
7983 =over 4
7984
7985 =item SYNOPSIS
7986
7987 =item DESCRIPTION
7988
7989 =item CONVENTIONS
7990
7991 =item IMPLEMENTATION
7992
7993 =item AUTHOR
7994
7995 =back
7996
7997 =head2 B::Showlex - Show lexical variables used in functions or files
7998
7999 =over 4
8000
8001 =item SYNOPSIS
8002
8003 =item DESCRIPTION
8004
8005 =item AUTHOR
8006
8007 =back
8008
8009 =head2 B::Stackobj - Helper module for CC backend
8010
8011 =over 4
8012
8013 =item SYNOPSIS
8014
8015 =item DESCRIPTION
8016
8017 =item AUTHOR
8018
8019 =back
8020
8021 =head2 B::Stash - show what stashes are loaded
8022
8023 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
8024
8025 =over 4
8026
8027 =item SYNOPSIS
8028
8029 =item DESCRIPTION
8030
8031 =item AUTHOR
8032
8033 =back
8034
8035 =head2 B::Xref - Generates cross reference reports for Perl programs
8036
8037 =over 4
8038
8039 =item SYNOPSIS
8040
8041 =item DESCRIPTION
8042
8043 =item OPTIONS
8044
8045 C<-oFILENAME>, C<-r>, C<-D[tO]>
8046
8047 =item BUGS
8048
8049 =item AUTHOR
8050
8051 =back
8052
8053 =head2 Bblock, B::Bblock - Walk basic blocks
8054
8055 =over 4
8056
8057 =item SYNOPSIS
8058
8059 =item DESCRIPTION
8060
8061 =item AUTHOR
8062
8063 =back
8064
8065 =head2 Benchmark - benchmark running times of Perl code
8066
8067 =over 4
8068
8069 =item SYNOPSIS
8070
8071 =item DESCRIPTION
8072
8073 =over 4
8074
8075 =item Methods
8076
8077 new, debug, iters
8078
8079 =item Standard Exports
8080
8081 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
8082 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
8083 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
8084
8085 =item Optional Exports
8086
8087 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
8088 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
8089 ), enablecache ( ), timesum ( T1, T2 )
8090
8091 =back
8092
8093 =item NOTES
8094
8095 =item EXAMPLES
8096
8097 =item INHERITANCE
8098
8099 =item CAVEATS
8100
8101 =item SEE ALSO
8102
8103 =item AUTHORS
8104
8105 =item MODIFICATION HISTORY
8106
8107 =back
8108
8109 =head2 ByteLoader - load byte compiled perl code
8110
8111 =over 4
8112
8113 =item SYNOPSIS
8114
8115 =item DESCRIPTION
8116
8117 =item AUTHOR
8118
8119 =item SEE ALSO
8120
8121 =back
8122
8123 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
8124
8125 =over 4
8126
8127 =item SYNOPSIS
8128
8129 =item DESCRIPTION
8130
8131 =item OPTIONS
8132
8133 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
8134 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
8135 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
8136
8137 =item EXAMPLES
8138
8139 =item BUGS
8140
8141 =item AUTHORS
8142
8143 =back
8144
8145 =head2 CGI - Simple Common Gateway Interface Class
8146
8147 =over 4
8148
8149 =item SYNOPSIS
8150
8151 =item ABSTRACT
8152
8153 =item DESCRIPTION
8154
8155 =over 4
8156
8157 =item PROGRAMMING STYLE
8158
8159 =item CALLING CGI.PM ROUTINES
8160
8161 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
8162
8163 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
8164
8165 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
8166
8167 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
8168
8169 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
8170
8171 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
8172
8173 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
8174
8175 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
8176
8177 =item DELETING A PARAMETER COMPLETELY:
8178
8179 =item DELETING ALL PARAMETERS:
8180
8181 =item DIRECT ACCESS TO THE PARAMETER LIST:
8182
8183 =item FETCHING THE PARAMETER LIST AS A HASH:
8184
8185 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
8186
8187 =item RETRIEVING CGI ERRORS
8188
8189 =item USING THE FUNCTION-ORIENTED INTERFACE
8190
8191 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
8192 B<:standard>, B<:all>
8193
8194 =item PRAGMAS
8195
8196 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
8197 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
8198 -private_tempfiles
8199
8200 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
8201
8202 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
8203 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
8204 a </UL> tag)
8205
8206 =back
8207
8208 =item GENERATING DYNAMIC DOCUMENTS
8209
8210 =over 4
8211
8212 =item CREATING A STANDARD HTTP HEADER:
8213
8214 =item GENERATING A REDIRECTION HEADER
8215
8216 =item CREATING THE HTML DOCUMENT HEADER
8217
8218 B<Parameters:>, 4, 5, 6..
8219
8220 =item ENDING THE HTML DOCUMENT:
8221
8222 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
8223
8224 =item OBTAINING THE SCRIPT'S URL
8225
8226 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
8227 (B<-query_string>), B<-base>
8228
8229 =item MIXING POST AND URL PARAMETERS
8230
8231 =back
8232
8233 =item CREATING STANDARD HTML ELEMENTS:
8234
8235 =over 4
8236
8237 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
8238
8239 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
8240
8241 =item HTML SHORTCUTS AND LIST INTERPOLATION
8242
8243 =item NON-STANDARD HTML SHORTCUTS
8244
8245 =item AUTOESCAPING HTML
8246
8247 $escaped_string = escapeHTML("unescaped string");, $charset =
8248 charset([$charset]);, $flag = autoEscape([$flag]);
8249
8250 =item PRETTY-PRINTING HTML
8251
8252 =back
8253
8254 =item CREATING FILL-OUT FORMS:
8255
8256 =over 4
8257
8258 =item CREATING AN ISINDEX TAG
8259
8260 =item STARTING AND ENDING A FORM
8261
8262 B<application/x-www-form-urlencoded>, B<multipart/form-data>
8263
8264 =item CREATING A TEXT FIELD
8265
8266 B<Parameters>
8267
8268 =item CREATING A BIG TEXT FIELD
8269
8270 =item CREATING A PASSWORD FIELD
8271
8272 =item CREATING A FILE UPLOAD FIELD
8273
8274 B<Parameters>
8275
8276 =item CREATING A POPUP MENU
8277
8278 =item CREATING A SCROLLING LIST
8279
8280 B<Parameters:>
8281
8282 =item CREATING A GROUP OF RELATED CHECKBOXES
8283
8284 B<Parameters:>
8285
8286 =item CREATING A STANDALONE CHECKBOX
8287
8288 B<Parameters:>
8289
8290 =item CREATING A RADIO BUTTON GROUP
8291
8292 B<Parameters:>
8293
8294 =item CREATING A SUBMIT BUTTON
8295
8296 B<Parameters:>
8297
8298 =item CREATING A RESET BUTTON
8299
8300 =item CREATING A DEFAULT BUTTON
8301
8302 =item CREATING A HIDDEN FIELD
8303
8304 B<Parameters:>
8305
8306 =item CREATING A CLICKABLE IMAGE BUTTON
8307
8308 B<Parameters:>
8309
8310 =item CREATING A JAVASCRIPT ACTION BUTTON
8311
8312 =back
8313
8314 =item HTTP COOKIES
8315
8316 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
8317 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
8318
8319 =item WORKING WITH FRAMES
8320
8321 1. Create a <Frameset> document, 2. Specify the destination for the
8322 document in the HTTP header, 3. Specify the destination for the document in
8323 the <FORM> tag
8324
8325 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
8326
8327 =item DEBUGGING
8328
8329 =over 4
8330
8331 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
8332
8333 =back
8334
8335 =item FETCHING ENVIRONMENT VARIABLES
8336
8337 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
8338 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
8339 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
8340 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
8341 B<request_method()>, B<content_type()>, B<http()>, B<https()>
8342
8343 =item USING NPH SCRIPTS
8344
8345 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
8346 parameters
8347
8348 =item Server Push
8349
8350 multipart_init(), multipart_start(), multipart_end(), multipart_final()
8351
8352 =item Avoiding Denial of Service Attacks
8353
8354 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
8355 basis>, B<2. Globally for all scripts>
8356
8357 =item COMPATIBILITY WITH CGI-LIB.PL
8358
8359 =item AUTHOR INFORMATION
8360
8361 =item CREDITS
8362
8363 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
8364 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
8365 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
8366 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
8367 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
8368 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
8369 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
8370 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
8371 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
8372 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
8373 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
8374 ...and many many more..
8375
8376 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
8377
8378 =item BUGS
8379
8380 =item SEE ALSO
8381
8382 =back
8383
8384 =head2 CGI::Apache - Backward compatibility module for CGI.pm
8385
8386 =over 4
8387
8388 =item SYNOPSIS
8389
8390 =item ABSTRACT
8391
8392 =item DESCRIPTION
8393
8394 =item AUTHOR INFORMATION
8395
8396 =item BUGS
8397
8398 =item SEE ALSO
8399
8400 =back
8401
8402 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
8403 other) error log
8404
8405 =over 4
8406
8407 =item SYNOPSIS
8408
8409 =item DESCRIPTION
8410
8411 =item REDIRECTING ERROR MESSAGES
8412
8413 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
8414
8415 =over 4
8416
8417 =item Changing the default message
8418
8419 =back
8420
8421 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
8422
8423 =item CHANGE LOG
8424
8425 =item AUTHORS
8426
8427 =item SEE ALSO
8428
8429 =back
8430
8431 =head2 CGI::Cookie - Interface to Netscape Cookies
8432
8433 =over 4
8434
8435 =item SYNOPSIS
8436
8437 =item DESCRIPTION
8438
8439 =item USING CGI::Cookie
8440
8441 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
8442
8443 =over 4
8444
8445 =item Creating New Cookies
8446
8447 =item Sending the Cookie to the Browser
8448
8449 =item Recovering Previous Cookies
8450
8451 =item Manipulating Cookies
8452
8453 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
8454
8455 =back
8456
8457 =item AUTHOR INFORMATION
8458
8459 =item BUGS
8460
8461 =item SEE ALSO
8462
8463 =back
8464
8465 =head2 CGI::Fast - CGI Interface for Fast CGI
8466
8467 =over 4
8468
8469 =item SYNOPSIS
8470
8471 =item DESCRIPTION
8472
8473 =item OTHER PIECES OF THE PUZZLE
8474
8475 =item WRITING FASTCGI PERL SCRIPTS
8476
8477 =item INSTALLING FASTCGI SCRIPTS
8478
8479 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
8480
8481 =item EXTERNAL FASTCGI SERVER INVOCATION
8482
8483 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
8484
8485 =item CAVEATS
8486
8487 =item AUTHOR INFORMATION
8488
8489 =item BUGS
8490
8491 =item SEE ALSO
8492
8493 =back
8494
8495 =head2 CGI::Pretty - module to produce nicely formatted HTML code
8496
8497 =over 4
8498
8499 =item SYNOPSIS
8500
8501 =item DESCRIPTION
8502
8503 =over 4
8504
8505 =item Tags that won't be formatted
8506
8507 =item Customizing the Indenting
8508
8509 =back
8510
8511 =item BUGS
8512
8513 =item AUTHOR
8514
8515 =item SEE ALSO
8516
8517 =back
8518
8519 =head2 CGI::Push - Simple Interface to Server Push
8520
8521 =over 4
8522
8523 =item SYNOPSIS
8524
8525 =item DESCRIPTION
8526
8527 =item USING CGI::Push
8528
8529 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
8530
8531 =over 4
8532
8533 =item Heterogeneous Pages
8534
8535 =item Changing the Page Delay on the Fly
8536
8537 =back
8538
8539 =item INSTALLING CGI::Push SCRIPTS
8540
8541 =item AUTHOR INFORMATION
8542
8543 =item BUGS
8544
8545 =item SEE ALSO
8546
8547 =back
8548
8549 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
8550
8551 =over 4
8552
8553 =item SYNOPSIS
8554
8555 =item ABSTRACT
8556
8557 =item DESCRIPTION
8558
8559 =item AUTHOR INFORMATION
8560
8561 =item BUGS
8562
8563 =item SEE ALSO
8564
8565 =back
8566
8567 =head2 CGI::Util - Internal utilities used by CGI module
8568
8569 =over 4
8570
8571 =item SYNOPSIS
8572
8573 =item DESCRIPTION
8574
8575 =item AUTHOR INFORMATION
8576
8577 =item SEE ALSO
8578
8579 =back
8580
8581 =head2 CPAN - query, download and build perl modules from CPAN sites
8582
8583 =over 4
8584
8585 =item SYNOPSIS
8586
8587 =item DESCRIPTION
8588
8589 =over 4
8590
8591 =item Interactive Mode
8592
8593 Searching for authors, bundles, distribution files and modules, make, test,
8594 install, clean  modules or distributions, get, readme, look module or
8595 distribution, ls author, Signals
8596
8597 =item CPAN::Shell
8598
8599 =item autobundle
8600
8601 =item recompile
8602
8603 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
8604
8605 =item Programmer's interface
8606
8607 expand($type,@things), expandany(@things), Programming Examples
8608
8609 =item Methods in the other Classes
8610
8611 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
8612 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
8613 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
8614 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
8615 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
8616 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
8617 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
8618 CPAN::Bundle::readme(), CPAN::Bundle::test(),
8619 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
8620 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
8621 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
8622 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
8623 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
8624 CPAN::Distribution::look(), CPAN::Distribution::make(),
8625 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
8626 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
8627 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
8628 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
8629 CPAN::Module::clean(), CPAN::Module::cpan_file(),
8630 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
8631 CPAN::Module::description(), CPAN::Module::force($method,@args),
8632 CPAN::Module::get(), CPAN::Module::inst_file(),
8633 CPAN::Module::inst_version(), CPAN::Module::install(),
8634 CPAN::Module::look(), CPAN::Module::make(),
8635 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
8636 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
8637
8638 =item Cache Manager
8639
8640 =item Bundles
8641
8642 =item Prerequisites
8643
8644 =item Finding packages and VERSION
8645
8646 =item Debugging
8647
8648 =item Floppy, Zip, Offline Mode
8649
8650 =back
8651
8652 =item CONFIGURATION
8653
8654 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
8655 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
8656 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
8657 [unshift|push|splice] E<lt>listE<gt>>
8658
8659 =over 4
8660
8661 =item Note on urllist parameter's format
8662
8663 =item urllist parameter has CD-ROM support
8664
8665 =back
8666
8667 =item SECURITY
8668
8669 =item EXPORT
8670
8671 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
8672
8673 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
8674
8675 =over 4
8676
8677 =item Three basic types of firewalls
8678
8679 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
8680
8681 =item Configuring lynx or ncftp for going through a firewall
8682
8683 =back
8684
8685 =item FAQ
8686
8687 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
8688
8689 =item BUGS
8690
8691 =item AUTHOR
8692
8693 =item TRANSLATIONS
8694
8695 =item SEE ALSO
8696
8697 =back
8698
8699 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
8700
8701 =over 4
8702
8703 =item SYNOPSIS
8704
8705 =item DESCRIPTION
8706
8707 =back
8708
8709 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
8710 module
8711
8712 =over 4
8713
8714 =item SYNOPSIS
8715
8716 =item DESCRIPTION
8717
8718 =item  SEE ALSO
8719
8720 =back
8721
8722 =head2 Carp, carp    - warn of errors (from perspective of caller)
8723
8724 =over 4
8725
8726 =item SYNOPSIS
8727
8728 =item DESCRIPTION
8729
8730 =over 4
8731
8732 =item Forcing a Stack Trace
8733
8734 =back
8735
8736 =item BUGS
8737
8738 =back
8739
8740 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
8741
8742 =head2 Class::ISA -- report the search path for a class's ISA tree
8743
8744 =over 4
8745
8746 =item SYNOPSIS
8747
8748 =item DESCRIPTION
8749
8750 =item FUNCTIONS
8751
8752 the function Class::ISA::super_path($CLASS), the function
8753 Class::ISA::self_and_super_path($CLASS), the function
8754 Class::ISA::self_and_super_versions($CLASS)
8755
8756 =item CAUTIONARY NOTES
8757
8758 =item COPYRIGHT
8759
8760 =item AUTHOR
8761
8762 =back
8763
8764 =head2 Class::Struct - declare struct-like datatypes as Perl classes
8765
8766 =over 4
8767
8768 =item SYNOPSIS
8769
8770 =item DESCRIPTION
8771
8772 =over 4
8773
8774 =item The C<struct()> function
8775
8776 =item Class Creation at Compile Time
8777
8778 =item Element Types and Accessor Methods
8779
8780 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
8781 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
8782
8783 =item Initializing with C<new>
8784
8785 =back
8786
8787 =item EXAMPLES
8788
8789 Example 1, Example 2, Example 3
8790
8791 =item Author and Modification History
8792
8793 =back
8794
8795 =head2 Config - access Perl configuration information
8796
8797 =over 4
8798
8799 =item SYNOPSIS
8800
8801 =item DESCRIPTION
8802
8803 myconfig(), config_sh(), config_vars(@names)
8804
8805 =item EXAMPLE
8806
8807 =item WARNING
8808
8809 =item GLOSSARY
8810
8811 =over 4
8812
8813 =item _
8814
8815 C<_a>, C<_exe>, C<_o>
8816
8817 =item a
8818
8819 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
8820 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
8821 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
8822 C<awk>
8823
8824 =item b
8825
8826 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
8827 C<byacc>, C<byteorder>
8828
8829 =item c
8830
8831 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
8832 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
8833 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
8834 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
8835 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
8836 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
8837
8838 =item d
8839
8840 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
8841 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
8842 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
8843 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
8844 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
8845 C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
8846 C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
8847 C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
8848 C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>,
8849 C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
8850 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
8851 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
8852 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
8853 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
8854 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
8855 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
8856 C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
8857 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
8858 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
8859 C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
8860 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
8861 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
8862 C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
8863 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
8864 C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
8865 C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
8866 C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
8867 C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>,
8868 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
8869 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
8870 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
8871 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
8872 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
8873 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
8874 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
8875 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
8876 C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
8877 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
8878 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
8879 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
8880 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
8881 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
8882 C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_atfork>, C<d_pthread_yield>,
8883 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
8884 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
8885 C<d_readdir>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
8886 C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
8887 C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
8888 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
8889 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
8890 C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
8891 C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>,
8892 C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>,
8893 C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
8894 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
8895 C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
8896 C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>,
8897 C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
8898 C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
8899 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
8900 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
8901 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
8902 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
8903 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strftime>,
8904 C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
8905 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
8906 C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
8907 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
8908 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
8909 C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
8910 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
8911 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
8912 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
8913 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
8914 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
8915 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
8916 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
8917 C<doublesize>, C<drand01>, C<dynamic_ext>
8918
8919 =item e
8920
8921 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
8922 C<exe_ext>, C<expr>, C<extensions>, C<extras>
8923
8924 =item f
8925
8926 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
8927 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
8928 C<full_sed>
8929
8930 =item g
8931
8932 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
8933 C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
8934
8935 =item h
8936
8937 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
8938
8939 =item i
8940
8941 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
8942 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
8943 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_fp>,
8944 C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
8945 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
8946 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
8947 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
8948 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
8949 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
8950 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
8951 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
8952 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
8953 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
8954 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
8955 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
8956 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
8957 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
8958 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
8959 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
8960 C<installman3dir>, C<installprefix>, C<installprefixexp>,
8961 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
8962 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
8963 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
8964 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
8965
8966 =item k
8967
8968 C<known_extensions>, C<ksh>
8969
8970 =item l
8971
8972 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
8973 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
8974 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
8975 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
8976 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
8977 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
8978
8979 =item m
8980
8981 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
8982 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
8983 C<man3direxp>, C<man3ext>
8984
8985 =item M
8986
8987 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
8988 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
8989
8990 =item n
8991
8992 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
8993 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
8994 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
8995 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
8996
8997 =item o
8998
8999 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
9000 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
9001
9002 =item p
9003
9004 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
9005 C<perl>, C<perl_patchlevel>
9006
9007 =item P
9008
9009 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
9010 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
9011 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
9012 C<privlibexp>, C<prototype>, C<ptrsize>
9013
9014 =item q
9015
9016 C<quadkind>, C<quadtype>
9017
9018 =item r
9019
9020 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
9021 C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
9022
9023 =item s
9024
9025 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
9026 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
9027 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
9028 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
9029 C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
9030 C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
9031 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
9032 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
9033 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
9034 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
9035 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
9036 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
9037 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
9038 C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
9039
9040 =item t
9041
9042 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
9043 C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
9044
9045 =item u
9046
9047 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
9048 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
9049 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
9050 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
9051 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
9052 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
9053 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
9054 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
9055 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
9056
9057 =item v
9058
9059 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
9060 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
9061 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
9062 C<versiononly>, C<vi>, C<voidflags>
9063
9064 =item x
9065
9066 C<xlibpth>, C<xs_apiversion>
9067
9068 =item y
9069
9070 C<yacc>, C<yaccflags>
9071
9072 =item z
9073
9074 C<zcat>, C<zip>
9075
9076 =back
9077
9078 =item NOTE
9079
9080 =back
9081
9082 =head2 Cwd - get pathname of current working directory
9083
9084 =over 4
9085
9086 =item SYNOPSIS
9087
9088 =item DESCRIPTION
9089
9090 =over 4
9091
9092 =item getcwd and friends
9093
9094 getcwd, cwd, fastcwd, fastgetcwd
9095
9096 =item abs_path and friends
9097
9098 abs_path, realpath, fast_abs_path
9099
9100 =item $ENV{PWD}
9101
9102 =back
9103
9104 =item NOTES
9105
9106 =item SEE ALSO
9107
9108 =back
9109
9110 =head2 DB - programmatic interface to the Perl debugging API (draft,
9111 subject to
9112 change)
9113
9114 =over 4
9115
9116 =item SYNOPSIS
9117
9118 =item DESCRIPTION
9119
9120 =over 4
9121
9122 =item Global Variables
9123
9124  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
9125 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
9126 $DB::lineno
9127
9128 =item API Methods
9129
9130 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
9131 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
9132
9133 =item Client Callback Methods
9134
9135 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
9136 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
9137 CLIENT->output(LIST)
9138
9139 =back
9140
9141 =item BUGS
9142
9143 =item AUTHOR
9144
9145 =back
9146
9147 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
9148
9149 =over 4
9150
9151 =item SYNOPSIS
9152
9153 =item DESCRIPTION
9154
9155 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
9156
9157 =over 4
9158
9159 =item Using DB_File with Berkeley DB version 2 or 3
9160
9161 =item Interface to Berkeley DB
9162
9163 =item Opening a Berkeley DB Database File
9164
9165 =item Default Parameters
9166
9167 =item In Memory Databases
9168
9169 =back
9170
9171 =item DB_HASH
9172
9173 =over 4
9174
9175 =item A Simple Example
9176
9177 =back
9178
9179 =item DB_BTREE
9180
9181 =over 4
9182
9183 =item Changing the BTREE sort order
9184
9185 =item Handling Duplicate Keys
9186
9187 =item The get_dup() Method
9188
9189 =item The find_dup() Method
9190
9191 =item The del_dup() Method
9192
9193 =item Matching Partial Keys
9194
9195 =back
9196
9197 =item DB_RECNO
9198
9199 =over 4
9200
9201 =item The 'bval' Option
9202
9203 =item A Simple Example
9204
9205 =item Extra RECNO Methods
9206
9207 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
9208 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
9209 length, elements);>
9210
9211 =item Another Example
9212
9213 =back
9214
9215 =item THE API INTERFACE
9216
9217 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
9218 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
9219 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
9220 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
9221
9222 =item DBM FILTERS
9223
9224 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
9225 B<filter_fetch_value>
9226
9227 =over 4
9228
9229 =item The Filter
9230
9231 =item An Example -- the NULL termination problem.
9232
9233 =item Another Example -- Key is a C int.
9234
9235 =back
9236
9237 =item HINTS AND TIPS
9238
9239 =over 4
9240
9241 =item Locking: The Trouble with fd
9242
9243 =item Safe ways to lock a database
9244
9245 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
9246
9247 =item Sharing Databases With C Applications
9248
9249 =item The untie() Gotcha
9250
9251 =back
9252
9253 =item COMMON QUESTIONS
9254
9255 =over 4
9256
9257 =item Why is there Perl source in my database?
9258
9259 =item How do I store complex data structures with DB_File?
9260
9261 =item What does "Invalid Argument" mean?
9262
9263 =item What does "Bareword 'DB_File' not allowed" mean?
9264
9265 =back
9266
9267 =item REFERENCES
9268
9269 =item HISTORY
9270
9271 =item BUGS
9272
9273 =item AVAILABILITY
9274
9275 =item COPYRIGHT
9276
9277 =item SEE ALSO
9278
9279 =item AUTHOR
9280
9281 =back
9282
9283 =head2 Data::Dumper - stringified perl data structures, suitable for both
9284 printing and C<eval>
9285
9286 =over 4
9287
9288 =item SYNOPSIS
9289
9290 =item DESCRIPTION
9291
9292 =over 4
9293
9294 =item Methods
9295
9296 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
9297 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
9298 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
9299 I<$OBJ>->Reset
9300
9301 =item Functions
9302
9303 Dumper(I<LIST>)
9304
9305 =item Configuration Variables or Methods
9306
9307 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
9308 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
9309 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
9310 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
9311 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
9312 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
9313 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
9314 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
9315 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
9316 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
9317 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
9318 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
9319
9320 =item Exports
9321
9322 Dumper
9323
9324 =back
9325
9326 =item EXAMPLES
9327
9328 =item BUGS
9329
9330 =item AUTHOR
9331
9332 =item VERSION
9333
9334 =item SEE ALSO
9335
9336 =back
9337
9338 =head2 Devel::DProf - a Perl code profiler
9339
9340 =over 4
9341
9342 =item SYNOPSIS
9343
9344 =item DESCRIPTION
9345
9346 =item PROFILE FORMAT
9347
9348 =item AUTOLOAD
9349
9350 =item ENVIRONMENT
9351
9352 =item BUGS
9353
9354 =item SEE ALSO
9355
9356 =back
9357
9358 =head2 Devel::Peek - A data debugging tool for the XS programmer
9359
9360 =over 4
9361
9362 =item SYNOPSIS
9363
9364 =item DESCRIPTION
9365
9366 =over 4
9367
9368 =item Memory footprint debugging
9369
9370 =back
9371
9372 =item EXAMPLES
9373
9374 =over 4
9375
9376 =item A simple scalar string
9377
9378 =item A simple scalar number
9379
9380 =item A simple scalar with an extra reference
9381
9382 =item A reference to a simple scalar
9383
9384 =item A reference to an array
9385
9386 =item A reference to a hash
9387
9388 =item Dumping a large array or hash
9389
9390 =item A reference to an SV which holds a C pointer
9391
9392 =item A reference to a subroutine
9393
9394 =back
9395
9396 =item EXPORTS
9397
9398 =item BUGS
9399
9400 =item AUTHOR
9401
9402 =item SEE ALSO
9403
9404 =back
9405
9406 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
9407
9408 =over 4
9409
9410 =item SYNOPSIS
9411
9412 =item DESCRIPTION
9413
9414 =back
9415
9416 =head2 Digest:: - Modules that calculate message digests
9417
9418 =over 4
9419
9420 =item SYNOPSIS
9421
9422 =item DESCRIPTION
9423
9424 I<binary>, I<hex>, I<base64>
9425
9426 =item OO INTERFACE
9427
9428 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
9429 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
9430 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
9431
9432 =item SEE ALSO
9433
9434 =item AUTHOR
9435
9436 =back
9437
9438 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
9439
9440 =over 4
9441
9442 =item SYNOPSIS
9443
9444 =item DESCRIPTION
9445
9446 =item FUNCTIONS
9447
9448 md5($data,...), md5_hex($data,...), md5_base64($data,...)
9449
9450 =item METHODS
9451
9452 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
9453 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
9454
9455 =item EXAMPLES
9456
9457 =item SEE ALSO
9458
9459 =item COPYRIGHT
9460
9461 =item AUTHORS
9462
9463 =back
9464
9465 =head2 DirHandle - supply object methods for directory handles
9466
9467 =over 4
9468
9469 =item SYNOPSIS
9470
9471 =item DESCRIPTION
9472
9473 =item NOTES
9474
9475 =back
9476
9477 =head2 Dumpvalue - provides screen dump of Perl data.
9478
9479 =over 4
9480
9481 =item SYNOPSIS
9482
9483 =item DESCRIPTION
9484
9485 =over 4
9486
9487 =item Creation
9488
9489 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
9490 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
9491 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
9492 stopDbSignal
9493
9494 =item Methods
9495
9496 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
9497 veryCompact, set, get
9498
9499 =back
9500
9501 =back
9502
9503 =head2 DynaLoader - Dynamically load C libraries into Perl code
9504
9505 =over 4
9506
9507 =item SYNOPSIS
9508
9509 =item DESCRIPTION
9510
9511 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
9512 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
9513 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
9514 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
9515 bootstrap()
9516
9517 =item AUTHOR
9518
9519 =back
9520
9521 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
9522 Perl code
9523
9524 =over 4
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 =item AUTHOR
9531
9532 =back
9533
9534 =head2 Encode - character encodings
9535
9536 =over 4
9537
9538 =item SYNOPSIS
9539
9540 =item DESCRIPTION
9541
9542 =over 4
9543
9544 =item TERMINOLOGY
9545
9546 =back
9547
9548 =item ENCODINGS
9549
9550 =over 4
9551
9552 =item Characteristics of an Encoding
9553
9554 =item Types of Encodings
9555
9556 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
9557 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
9558
9559 =item Specifying Encodings
9560
9561 1. By name, 2. As an object
9562
9563 =item Encoding Names
9564
9565 The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
9566 The name used by the the organization that defined it
9567
9568 =back
9569
9570 =item PERL ENCODING API
9571
9572 =over 4
9573
9574 =item Generic Encoding Interface
9575
9576 =item Handling Malformed Data
9577
9578 Scheme 1, Scheme 2, Other Schemes
9579
9580 =item UTF-8 / utf8
9581
9582 =item Other Encodings of Unicode
9583
9584 =item Listing available encodings
9585
9586 =item Defining Aliases
9587
9588 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
9589 reference, e.g.:
9590
9591 =item Defining Encodings
9592
9593 =back
9594
9595 =item Encoding and IO
9596
9597 =item Encoding How to ...
9598
9599 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
9600 strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
9601
9602 =item Messing with Perl's Internals
9603
9604 is_utf8(STRING [, CHECK]), valid_utf8(STRING)
9605
9606 =item IMPLEMENTATION CLASSES
9607
9608 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
9609 -E<gt>decode($octets,$check)
9610
9611 =over 4
9612
9613 =item Compiled Encodings
9614
9615 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
9616 variants of EBCDIC, symbol and dingbats as used by Tk on X11
9617
9618 =back
9619
9620 =item SEE ALSO
9621
9622 =back
9623
9624 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
9625 of the Encode extension
9626
9627 =over 4
9628
9629 =item DESCRIPTION
9630
9631 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9632
9633 =item KEYWORDS
9634
9635 =item COPYRIGHT
9636
9637 =back
9638
9639 =head2 Encode::Tcl - Tcl encodings
9640
9641 =head2 EncodeFormat - the format of encoding tables of the Encode extension
9642
9643 =over 4
9644
9645 =item DESCRIPTION
9646
9647 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9648
9649 =item KEYWORDS
9650
9651 =item COPYRIGHT
9652
9653 =back
9654
9655 =head2 English - use nice English (or awk) names for ugly punctuation
9656 variables
9657
9658 =over 4
9659
9660 =item SYNOPSIS
9661
9662 =item DESCRIPTION
9663
9664 =item PERFORMANCE
9665
9666 =back
9667
9668 =head2 Env - perl module that imports environment variables as scalars or
9669 arrays
9670
9671 =over 4
9672
9673 =item SYNOPSIS
9674
9675 =item DESCRIPTION
9676
9677 =item LIMITATIONS
9678
9679 =item AUTHOR
9680
9681 =back
9682
9683 =head2 Errno - System errno constants
9684
9685 =over 4
9686
9687 =item SYNOPSIS
9688
9689 =item DESCRIPTION
9690
9691 =item CAVEATS
9692
9693 =item AUTHOR
9694
9695 =item COPYRIGHT
9696
9697 =back
9698
9699 =head2 Exporter - Implements default import method for modules
9700
9701 =over 4
9702
9703 =item SYNOPSIS
9704
9705 =item DESCRIPTION
9706
9707 =over 4
9708
9709 =item How to Export
9710
9711 =item Selecting What To Export
9712
9713 =item Specialised Import Lists
9714
9715 =item Exporting without using Export's import method
9716
9717 =item Module Version Checking
9718
9719 =item Managing Unknown Symbols
9720
9721 =item Tag Handling Utility Functions
9722
9723 =back
9724
9725 =back
9726
9727 =head2 Exporter::Heavy - Exporter guts
9728
9729 =over 4
9730
9731 =item SYNOPIS
9732
9733 =item DESCRIPTION
9734
9735 =back
9736
9737 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
9738 Makefiles etc.
9739
9740 =over 4
9741
9742 =item SYNOPSIS
9743
9744 =item DESCRIPTION
9745
9746 =back
9747
9748 cat
9749
9750 eqtime src dst
9751
9752 rm_rf files...
9753
9754 rm_f files...
9755
9756 touch files ..
9757
9758 mv source... destination
9759
9760 cp source... destination
9761
9762 chmod mode files..
9763
9764 mkpath directory..
9765
9766 test_f file
9767
9768 =over 4
9769
9770 =item BUGS
9771
9772 =item SEE ALSO
9773
9774 =item AUTHOR
9775
9776 =back
9777
9778 =head2 ExtUtils::Constant - generate XS code to import C header constants
9779
9780 =over 4
9781
9782 =item SYNOPSIS
9783
9784 =item DESCRIPTION
9785
9786 =item USAGE
9787
9788 IV, UV, NV, PV, PVN, PVN, YES, NO, UNDEF
9789
9790 =item FUNCTIONS
9791
9792 =back
9793
9794 C_stringify NAME
9795
9796 constant_types
9797
9798 memEQ_clause NAME, CHECKED_AT, INDENT
9799
9800 assign INDENT, TYPE, PRE, POST, VALUE..
9801
9802 return_clause
9803
9804 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
9805
9806 params WHAT
9807
9808 dump_names
9809
9810 C_constant, name, type, value, macro, default, pre, post, def_pre =item
9811 def_post
9812
9813 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
9814
9815 autoload PACKAGE, VERSION, AUTOLOADER
9816
9817 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
9818 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
9819
9820 =over 4
9821
9822 =item AUTHOR
9823
9824 =back
9825
9826 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
9827
9828 =over 4
9829
9830 =item SYNOPSIS
9831
9832 =item DESCRIPTION
9833
9834 =item @EXPORT
9835
9836 =item FUNCTIONS
9837
9838 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
9839 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
9840
9841 =item EXAMPLES
9842
9843 =item SEE ALSO
9844
9845 =item AUTHOR
9846
9847 =back
9848
9849 =head2 ExtUtils::Install - install files from here to there
9850
9851 =over 4
9852
9853 =item SYNOPSIS
9854
9855 =item DESCRIPTION
9856
9857 =back
9858
9859 =head2 ExtUtils::Installed - Inventory management of installed modules
9860
9861 =over 4
9862
9863 =item SYNOPSIS
9864
9865 =item DESCRIPTION
9866
9867 =item USAGE
9868
9869 =item FUNCTIONS
9870
9871 new(), modules(), files(), directories(), directory_tree(), validate(),
9872 packlist(), version()
9873
9874 =item EXAMPLE
9875
9876 =item AUTHOR
9877
9878 =back
9879
9880 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
9881
9882 =over 4
9883
9884 =item SYNOPSIS
9885
9886 =item DESCRIPTION
9887
9888 For static extensions, For dynamic extensions, For dynamic extensions
9889
9890 =over 4
9891
9892 =item EXTRALIBS
9893
9894 =item LDLOADLIBS and LD_RUN_PATH
9895
9896 =item BSLOADLIBS
9897
9898 =back
9899
9900 =item PORTABILITY
9901
9902 =over 4
9903
9904 =item VMS implementation
9905
9906 =item Win32 implementation
9907
9908 =back
9909
9910 =item SEE ALSO
9911
9912 =back
9913
9914 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
9915 ExtUtils::MakeMaker
9916
9917 =over 4
9918
9919 =item SYNOPSIS
9920
9921 =item DESCRIPTION
9922
9923 canonpath, cflags, manifypods, perl_archive
9924
9925 =back
9926
9927 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
9928 ExtUtils::MakeMaker
9929
9930 =over 4
9931
9932 =item SYNOPSIS
9933
9934 =item DESCRIPTION
9935
9936 =back
9937
9938 catfile
9939
9940 constants (o)
9941
9942 static_lib (o)
9943
9944 dynamic_bs (o)
9945
9946 dynamic_lib (o)
9947
9948 canonpath
9949
9950 perl_script
9951
9952 pm_to_blib
9953
9954 test_via_harness (o)
9955
9956 tool_autosplit (override)
9957
9958 tools_other (o)
9959
9960 xs_o (o)
9961
9962 top_targets (o)
9963
9964 htmlifypods (o)
9965
9966 manifypods (o)
9967
9968 dist_ci (o)
9969
9970 dist_core (o)
9971
9972 pasthru (o)
9973
9974 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
9975 ExtUtils::MakeMaker
9976
9977 =over 4
9978
9979 =item SYNOPSIS
9980
9981 =item DESCRIPTION
9982
9983 =item METHODS
9984
9985 =back
9986
9987 perl_archive_after
9988
9989 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
9990
9991 =over 4
9992
9993 =item SYNOPSIS
9994
9995 =item DESCRIPTION
9996
9997 =item METHODS
9998
9999 =over 4
10000
10001 =item Preloaded methods
10002
10003 canonpath
10004
10005 =back
10006
10007 =back
10008
10009 catdir
10010
10011 catfile
10012
10013 curdir
10014
10015 rootdir
10016
10017 updir
10018
10019 =over 4
10020
10021 =item SelfLoaded methods
10022
10023 c_o (o)
10024
10025 =back
10026
10027 cflags (o)
10028
10029 clean (o)
10030
10031 const_cccmd (o)
10032
10033 const_config (o)
10034
10035 const_loadlibs (o)
10036
10037 constants (o)
10038
10039 depend (o)
10040
10041 dir_target (o)
10042
10043 dist (o)
10044
10045 dist_basics (o)
10046
10047 dist_ci (o)
10048
10049 dist_core (o)
10050
10051 dist_dir (o)
10052
10053 dist_test (o)
10054
10055 dlsyms (o)
10056
10057 dynamic (o)
10058
10059 dynamic_bs (o)
10060
10061 dynamic_lib (o)
10062
10063 exescan
10064
10065 extliblist
10066
10067 file_name_is_absolute
10068
10069 find_perl
10070
10071 =over 4
10072
10073 =item Methods to actually produce chunks of text for the Makefile
10074
10075 fixin
10076
10077 =back
10078
10079 force (o)
10080
10081 guess_name
10082
10083 has_link_code
10084
10085 htmlifypods (o)
10086
10087 init_dirscan
10088
10089 init_main
10090
10091 init_others
10092
10093 install (o)
10094
10095 installbin (o)
10096
10097 libscan (o)
10098
10099 linkext (o)
10100
10101 lsdir
10102
10103 macro (o)
10104
10105 makeaperl (o)
10106
10107 makefile (o)
10108
10109 manifypods (o)
10110
10111 maybe_command
10112
10113 maybe_command_in_dirs
10114
10115 needs_linking (o)
10116
10117 nicetext
10118
10119 parse_version
10120
10121 parse_abstract
10122
10123 pasthru (o)
10124
10125 path
10126
10127 perl_script
10128
10129 perldepend (o)
10130
10131 ppd
10132
10133 perm_rw (o)
10134
10135 perm_rwx (o)
10136
10137 pm_to_blib
10138
10139 post_constants (o)
10140
10141 post_initialize (o)
10142
10143 postamble (o)
10144
10145 prefixify
10146
10147 processPL (o)
10148
10149 realclean (o)
10150
10151 replace_manpage_separator
10152
10153 static (o)
10154
10155 static_lib (o)
10156
10157 staticmake (o)
10158
10159 subdir_x (o)
10160
10161 subdirs (o)
10162
10163 test (o)
10164
10165 test_via_harness (o)
10166
10167 test_via_script (o)
10168
10169 tool_autosplit (o)
10170
10171 tools_other (o)
10172
10173 tool_xsubpp (o)
10174
10175 top_targets (o)
10176
10177 writedoc
10178
10179 xs_c (o)
10180
10181 xs_cpp (o)
10182
10183 xs_o (o)
10184
10185 perl_archive
10186
10187 perl_archive_after
10188
10189 export_list
10190
10191 =over 4
10192
10193 =item SEE ALSO
10194
10195 =back
10196
10197 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
10198 ExtUtils::MakeMaker
10199
10200 =over 4
10201
10202 =item SYNOPSIS
10203
10204 =item DESCRIPTION
10205
10206 =over 4
10207
10208 =item Methods always loaded
10209
10210 wraplist
10211
10212 =back
10213
10214 =back
10215
10216 rootdir (override)
10217
10218 =over 4
10219
10220 =item SelfLoaded methods
10221
10222 guess_name (override)
10223
10224 =back
10225
10226 find_perl (override)
10227
10228 path (override)
10229
10230 maybe_command (override)
10231
10232 maybe_command_in_dirs (override)
10233
10234 perl_script (override)
10235
10236 file_name_is_absolute (override)
10237
10238 replace_manpage_separator
10239
10240 init_others (override)
10241
10242 constants (override)
10243
10244 cflags (override)
10245
10246 const_cccmd (override)
10247
10248 pm_to_blib (override)
10249
10250 tool_autosplit (override)
10251
10252 tool_sxubpp (override)
10253
10254 xsubpp_version (override)
10255
10256 tools_other (override)
10257
10258 dist (override)
10259
10260 c_o (override)
10261
10262 xs_c (override)
10263
10264 xs_o (override)
10265
10266 top_targets (override)
10267
10268 dlsyms (override)
10269
10270 dynamic_lib (override)
10271
10272 dynamic_bs (override)
10273
10274 static_lib (override)
10275
10276 manifypods (override)
10277
10278 processPL (override)
10279
10280 installbin (override)
10281
10282 subdir_x (override)
10283
10284 clean (override)
10285
10286 realclean (override)
10287
10288 dist_basics (override)
10289
10290 dist_core (override)
10291
10292 dist_dir (override)
10293
10294 dist_test (override)
10295
10296 install (override)
10297
10298 perldepend (override)
10299
10300 makefile (override)
10301
10302 test (override)
10303
10304 test_via_harness (override)
10305
10306 test_via_script (override)
10307
10308 makeaperl (override)
10309
10310 nicetext (override)
10311
10312 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
10313 ExtUtils::MakeMaker
10314
10315 =over 4
10316
10317 =item SYNOPSIS
10318
10319 =item DESCRIPTION
10320
10321 =back
10322
10323 catfile
10324
10325 constants (o)
10326
10327 static_lib (o)
10328
10329 dynamic_bs (o)
10330
10331 dynamic_lib (o)
10332
10333 canonpath
10334
10335 perl_script
10336
10337 pm_to_blib
10338
10339 test_via_harness (o)
10340
10341 tool_autosplit (override)
10342
10343 tools_other (o)
10344
10345 xs_o (o)
10346
10347 top_targets (o)
10348
10349 htmlifypods (o)
10350
10351 manifypods (o)
10352
10353 dist_ci (o)
10354
10355 dist_core (o)
10356
10357 pasthru (o)
10358
10359 =head2 ExtUtils::MakeMaker - create an extension Makefile
10360
10361 =over 4
10362
10363 =item SYNOPSIS
10364
10365 =item DESCRIPTION
10366
10367 =over 4
10368
10369 =item How To Write A Makefile.PL
10370
10371 =item Default Makefile Behaviour
10372
10373 =item make test
10374
10375 =item make testdb
10376
10377 =item make install
10378
10379 =item PREFIX and LIB attribute
10380
10381 =item AFS users
10382
10383 =item Static Linking of a new Perl Binary
10384
10385 =item Determination of Perl Library and Installation Locations
10386
10387 =item Which architecture dependent directory?
10388
10389 =item Using Attributes and Parameters
10390
10391 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
10392 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
10393 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
10394 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
10395 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
10396 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
10397 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
10398 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
10399 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
10400 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
10401 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
10402 PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
10403 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
10404 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TEST_LIBS, VERSION,
10405 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
10406
10407 =item Additional lowercase attributes
10408
10409 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
10410 tool_autosplit
10411
10412 =item Overriding MakeMaker Methods
10413
10414 =item Hintsfile support
10415
10416 =item Distribution Support
10417
10418    make distcheck,    make skipcheck,    make distclean,    make manifest,
10419   make distdir,    make tardist,    make dist,    make uutardist,    make
10420 shdist,    make zipdist,    make ci
10421
10422 =item Disabling an extension
10423
10424 =back
10425
10426 =item ENVIRONMENT
10427
10428 PERL_MM_OPT
10429
10430 =item SEE ALSO
10431
10432 =item AUTHORS
10433
10434 =back
10435
10436 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
10437
10438 =over 4
10439
10440 =item SYNOPSIS
10441
10442 =item DESCRIPTION
10443
10444 =item MANIFEST.SKIP
10445
10446 =item EXPORT_OK
10447
10448 =item GLOBAL VARIABLES
10449
10450 =item DIAGNOSTICS
10451
10452 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
10453 C<Added to MANIFEST:> I<file>
10454
10455 =item ENVIRONMENT
10456
10457 B<PERL_MM_MANIFEST_DEBUG>
10458
10459 =item SEE ALSO
10460
10461 =item AUTHOR
10462
10463 =back
10464
10465 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
10466
10467 =over 4
10468
10469 =item SYNOPSIS
10470
10471 =item DESCRIPTION
10472
10473 =item SEE ALSO
10474
10475 =back
10476
10477 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
10478
10479 =over 4
10480
10481 =item SYNOPSIS
10482
10483 =item DESCRIPTION
10484
10485 =back
10486
10487 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
10488 extension
10489
10490 =over 4
10491
10492 =item SYNOPSIS
10493
10494 =item DESCRIPTION
10495
10496 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
10497
10498 =item AUTHOR
10499
10500 =item REVISION
10501
10502 =back
10503
10504 =head2 ExtUtils::Packlist - manage .packlist files
10505
10506 =over 4
10507
10508 =item SYNOPSIS
10509
10510 =item DESCRIPTION
10511
10512 =item USAGE
10513
10514 =item FUNCTIONS
10515
10516 new(), read(), write(), validate(), packlist_file()
10517
10518 =item EXAMPLE
10519
10520 =item AUTHOR
10521
10522 =back
10523
10524 =head2 ExtUtils::testlib - add blib/* directories to @INC
10525
10526 =over 4
10527
10528 =item SYNOPSIS
10529
10530 =item DESCRIPTION
10531
10532 =back
10533
10534 =head2 Fatal - replace functions with equivalents which succeed or die
10535
10536 =over 4
10537
10538 =item SYNOPSIS
10539
10540 =item DESCRIPTION
10541
10542 =item AUTHOR
10543
10544 =back
10545
10546 =head2 Fcntl - load the C Fcntl.h defines
10547
10548 =over 4
10549
10550 =item SYNOPSIS
10551
10552 =item DESCRIPTION
10553
10554 =item NOTE
10555
10556 =item EXPORTED SYMBOLS
10557
10558 =back
10559
10560 =head2 File::Basename, fileparse - split a pathname into pieces
10561
10562 =over 4
10563
10564 =item SYNOPSIS
10565
10566 =item DESCRIPTION
10567
10568 fileparse_set_fstype, fileparse
10569
10570 =item EXAMPLES
10571
10572 C<basename>, C<dirname>
10573
10574 =back
10575
10576 =head2 File::CheckTree, validate - run many filetest checks on a tree
10577
10578 =over 4
10579
10580 =item SYNOPSIS
10581
10582 =item DESCRIPTION
10583
10584 =back
10585
10586 =head2 File::Compare - Compare files or filehandles
10587
10588 =over 4
10589
10590 =item SYNOPSIS
10591
10592 =item DESCRIPTION
10593
10594 =item RETURN
10595
10596 =item AUTHOR
10597
10598 =back
10599
10600 =head2 File::Copy - Copy files or filehandles
10601
10602 =over 4
10603
10604 =item SYNOPSIS
10605
10606 =item DESCRIPTION
10607
10608 =over 4
10609
10610 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
10611
10612 rmscopy($from,$to[,$date_flag])
10613
10614 =back
10615
10616 =item RETURN
10617
10618 =item NOTES
10619
10620 =item AUTHOR
10621
10622 =back
10623
10624 =head2 File::DosGlob - DOS like globbing and then some
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 =item EXPORTS (by request only)
10633
10634 =item BUGS
10635
10636 =item AUTHOR
10637
10638 =item HISTORY
10639
10640 =item SEE ALSO
10641
10642 =back
10643
10644 =head2 File::Find, find - traverse a file tree
10645
10646 =over 4
10647
10648 =item SYNOPSIS
10649
10650 =item DESCRIPTION
10651
10652 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
10653 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
10654 C<untaint>, C<untaint_pattern>, C<untaint_skip>
10655
10656 =item CAVEAT
10657
10658 =item NOTES
10659
10660 =item HISTORY
10661
10662 =back
10663
10664 =head2 File::Glob - Perl extension for BSD glob routine
10665
10666 =over 4
10667
10668 =item SYNOPSIS
10669
10670 =item DESCRIPTION
10671
10672 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
10673 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
10674 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
10675
10676 =item DIAGNOSTICS
10677
10678 C<GLOB_NOSPACE>, C<GLOB_ABEND>
10679
10680 =item NOTES
10681
10682 =item AUTHOR
10683
10684 =back
10685
10686 =head2 File::Path - create or remove directory trees
10687
10688 =over 4
10689
10690 =item SYNOPSIS
10691
10692 =item DESCRIPTION
10693
10694 =item AUTHORS
10695
10696 =back
10697
10698 =head2 File::Spec - portably perform operations on file names
10699
10700 =over 4
10701
10702 =item SYNOPSIS
10703
10704 =item DESCRIPTION
10705
10706 =item METHODS
10707
10708 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
10709 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
10710 splitdir, catpath, abs2rel, rel2abs
10711
10712 =item SEE ALSO
10713
10714 =item AUTHORS
10715
10716 =back
10717
10718 =head2 File::Spec::Epoc - methods for Epoc file specs
10719
10720 =over 4
10721
10722 =item SYNOPSIS
10723
10724 =item DESCRIPTION
10725
10726 devnull
10727
10728 =back
10729
10730 tmpdir
10731
10732 path
10733
10734 canonpath
10735
10736 splitpath
10737
10738 splitdir
10739
10740 catpath
10741
10742 abs2rel
10743
10744 rel2abs
10745
10746 =over 4
10747
10748 =item SEE ALSO
10749
10750 =back
10751
10752 =head2 File::Spec::Functions - portably perform operations on file names
10753
10754 =over 4
10755
10756 =item SYNOPSIS
10757
10758 =item DESCRIPTION
10759
10760 =over 4
10761
10762 =item Exports
10763
10764 =back
10765
10766 =item SEE ALSO
10767
10768 =back
10769
10770 =head2 File::Spec::Mac - File::Spec for MacOS
10771
10772 =over 4
10773
10774 =item SYNOPSIS
10775
10776 =item DESCRIPTION
10777
10778 =item METHODS
10779
10780 canonpath
10781
10782 =back
10783
10784 catdir
10785
10786 catfile
10787
10788 curdir
10789
10790 devnull
10791
10792 rootdir
10793
10794 tmpdir
10795
10796 updir
10797
10798 file_name_is_absolute
10799
10800 path
10801
10802 splitpath
10803
10804 splitdir
10805
10806 catpath
10807
10808 abs2rel
10809
10810 rel2abs
10811
10812 =over 4
10813
10814 =item SEE ALSO
10815
10816 =back
10817
10818 =head2 File::Spec::OS2 - methods for OS/2 file specs
10819
10820 =over 4
10821
10822 =item SYNOPSIS
10823
10824 =item DESCRIPTION
10825
10826 =back
10827
10828 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
10829 modules
10830
10831 =over 4
10832
10833 =item SYNOPSIS
10834
10835 =item DESCRIPTION
10836
10837 =item METHODS
10838
10839 canonpath
10840
10841 =back
10842
10843 catdir
10844
10845 catfile
10846
10847 curdir
10848
10849 devnull
10850
10851 rootdir
10852
10853 tmpdir
10854
10855 updir
10856
10857 no_upwards
10858
10859 case_tolerant
10860
10861 file_name_is_absolute
10862
10863 path
10864
10865 join
10866
10867 splitpath
10868
10869 splitdir
10870
10871 catpath
10872
10873 abs2rel
10874
10875 rel2abs
10876
10877 =over 4
10878
10879 =item SEE ALSO
10880
10881 =back
10882
10883 =head2 File::Spec::VMS - methods for VMS file specs
10884
10885 =over 4
10886
10887 =item SYNOPSIS
10888
10889 =item DESCRIPTION
10890
10891 eliminate_macros
10892
10893 =back
10894
10895 fixpath
10896
10897 =over 4
10898
10899 =item Methods always loaded
10900
10901 canonpath (override)
10902
10903 =back
10904
10905 catdir
10906
10907 catfile
10908
10909 curdir (override)
10910
10911 devnull (override)
10912
10913 rootdir (override)
10914
10915 tmpdir (override)
10916
10917 updir (override)
10918
10919 case_tolerant (override)
10920
10921 path (override)
10922
10923 file_name_is_absolute (override)
10924
10925 splitpath (override)
10926
10927 splitdir (override)
10928
10929 catpath (override)
10930
10931 abs2rel (override)
10932
10933 rel2abs (override)
10934
10935 =over 4
10936
10937 =item SEE ALSO
10938
10939 =back
10940
10941 =head2 File::Spec::Win32 - methods for Win32 file specs
10942
10943 =over 4
10944
10945 =item SYNOPSIS
10946
10947 =item DESCRIPTION
10948
10949 devnull
10950
10951 =back
10952
10953 tmpdir
10954
10955 catfile
10956
10957 canonpath
10958
10959 splitpath
10960
10961 splitdir
10962
10963 catpath
10964
10965 =over 4
10966
10967 =item SEE ALSO
10968
10969 =back
10970
10971 =head2 File::Temp - return name and handle of a temporary file safely
10972
10973 =over 4
10974
10975 =item PORTABILITY
10976
10977 =item SYNOPSIS
10978
10979 =item DESCRIPTION
10980
10981 =back
10982
10983 =over 4
10984
10985 =item FUNCTIONS
10986
10987 B<tempfile>
10988
10989 =back
10990
10991 B<tempdir>
10992
10993 =over 4
10994
10995 =item MKTEMP FUNCTIONS
10996
10997 B<mkstemp>
10998
10999 =back
11000
11001 B<mkstemps>
11002
11003 B<mkdtemp>
11004
11005 B<mktemp>
11006
11007 =over 4
11008
11009 =item POSIX FUNCTIONS
11010
11011 B<tmpnam>
11012
11013 =back
11014
11015 B<tmpfile>
11016
11017 =over 4
11018
11019 =item ADDITIONAL FUNCTIONS
11020
11021 B<tempnam>
11022
11023 =back
11024
11025 =over 4
11026
11027 =item UTILITY FUNCTIONS
11028
11029 B<unlink0>
11030
11031 =back
11032
11033 =over 4
11034
11035 =item PACKAGE VARIABLES
11036
11037 B<safe_level>, STANDARD, MEDIUM, HIGH
11038
11039 =back
11040
11041 TopSystemUID
11042
11043 =over 4
11044
11045 =item WARNING
11046
11047 =over 4
11048
11049 =item Temporary files and NFS
11050
11051 =back
11052
11053 =item HISTORY
11054
11055 =item SEE ALSO
11056
11057 =item AUTHOR
11058
11059 =back
11060
11061 =head2 File::stat - by-name interface to Perl's built-in stat() functions
11062
11063 =over 4
11064
11065 =item SYNOPSIS
11066
11067 =item DESCRIPTION
11068
11069 =item NOTE
11070
11071 =item AUTHOR
11072
11073 =back
11074
11075 =head2 FileCache - keep more files open than the system permits
11076
11077 =over 4
11078
11079 =item SYNOPSIS
11080
11081 =item DESCRIPTION
11082
11083 =item BUGS
11084
11085 =back
11086
11087 =head2 FileHandle - supply object methods for filehandles
11088
11089 =over 4
11090
11091 =item SYNOPSIS
11092
11093 =item DESCRIPTION
11094
11095 $fh->print, $fh->printf, $fh->getline, $fh->getlines
11096
11097 =item SEE ALSO
11098
11099 =back
11100
11101 =head2 Filter::Simple - Simplified source filtering
11102
11103 =over 4
11104
11105 =item SYNOPSIS
11106
11107 =item DESCRIPTION
11108
11109 =over 4
11110
11111 =item The Problem
11112
11113 =item A Solution
11114
11115 =item Disabling or changing <no> behaviour
11116
11117 =item All-in-one interface
11118
11119 =item Using Filter::Simple and Exporter together
11120
11121 =item How it works
11122
11123 =back
11124
11125 =item AUTHOR
11126
11127 =item COPYRIGHT
11128
11129 =back
11130
11131 =head2 Filter::Util::Call - Perl Source Filter Utility Module
11132
11133 =over 4
11134
11135 =item SYNOPSIS
11136
11137 =item DESCRIPTION
11138
11139 =over 4
11140
11141 =item B<use Filter::Util::Call>
11142
11143 =item B<import()>
11144
11145 =item B<filter() and anonymous sub>
11146
11147 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
11148
11149 =back
11150
11151 =item EXAMPLES
11152
11153 =over 4
11154
11155 =item Example 1: A simple filter.
11156
11157 =item Example 2: Using the context
11158
11159 =item Example 3: Using the context within the filter
11160
11161 =item Example 4: Using filter_del
11162
11163 =back
11164
11165 =item Filter::Simple
11166
11167 =item AUTHOR
11168
11169 =item DATE
11170
11171 =back
11172
11173 =head2 FindBin - Locate directory of original perl script
11174
11175 =over 4
11176
11177 =item SYNOPSIS
11178
11179 =item DESCRIPTION
11180
11181 =item EXPORTABLE VARIABLES
11182
11183 =item KNOWN BUGS
11184
11185 =item AUTHORS
11186
11187 =item COPYRIGHT
11188
11189 =back
11190
11191 =head2 GDBM_File - Perl5 access to the gdbm library.
11192
11193 =over 4
11194
11195 =item SYNOPSIS
11196
11197 =item DESCRIPTION
11198
11199 =item AVAILABILITY
11200
11201 =item BUGS
11202
11203 =item SEE ALSO
11204
11205 =back
11206
11207 =head2 Getopt::Long - Extended processing of command line options
11208
11209 =over 4
11210
11211 =item SYNOPSIS
11212
11213 =item DESCRIPTION
11214
11215 =item Command Line Options, an Introduction
11216
11217 =item Getting Started with Getopt::Long
11218
11219 =over 4
11220
11221 =item Simple options
11222
11223 =item A little bit less simple options
11224
11225 =item Mixing command line option with other arguments
11226
11227 =item Options with values
11228
11229 =item Options with multiple values
11230
11231 =item Options with hash values
11232
11233 =item User-defined subroutines to handle options
11234
11235 =item Options with multiple names
11236
11237 =item Case and abbreviations
11238
11239 =item Summary of Option Specifications
11240
11241 !, +, s, i, o, f, : I<type> [ I<desttype> ]
11242
11243 =back
11244
11245 =item Advanced Possibilities
11246
11247 =over 4
11248
11249 =item Object oriented interface
11250
11251 =item Documentation and help texts
11252
11253 =item Storing options in a hash
11254
11255 =item Bundling
11256
11257 =item The lonesome dash
11258
11259 =item Argument call-back
11260
11261 =back
11262
11263 =item Configuring Getopt::Long
11264
11265 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
11266 require_order, permute, bundling (default: disabled), bundling_override
11267 (default: disabled), ignore_case  (default: enabled), ignore_case_always
11268 (default: disabled), pass_through (default: disabled), prefix,
11269 prefix_pattern, debug (default: disabled)
11270
11271 =item Return values and Errors
11272
11273 =item Legacy
11274
11275 =over 4
11276
11277 =item Default destinations
11278
11279 =item Alternative option starters
11280
11281 =item Configuration variables
11282
11283 =back
11284
11285 =item Trouble Shooting
11286
11287 =over 4
11288
11289 =item Warning: Ignoring '!' modifier for short option
11290
11291 =item GetOptions does not return a false result when an option is not
11292 supplied
11293
11294 =back
11295
11296 =item AUTHOR
11297
11298 =item COPYRIGHT AND DISCLAIMER
11299
11300 =back
11301
11302 =head2 Getopt::Std, getopt - Process single-character switches with switch
11303 clustering
11304
11305 =over 4
11306
11307 =item SYNOPSIS
11308
11309 =item DESCRIPTION
11310
11311 =back
11312
11313 =head2 I18N::Collate - compare 8-bit scalar data according to the current
11314 locale
11315
11316 =over 4
11317
11318 =item SYNOPSIS
11319
11320 =item DESCRIPTION
11321
11322 =back
11323
11324 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
11325 tags
11326
11327 =over 4
11328
11329 =item SYNOPSIS
11330
11331 =item DESCRIPTION
11332
11333 =back
11334
11335 the function is_language_tag($lang1)
11336
11337 the function extract_language_tags($whatever)
11338
11339 the function same_language_tag($lang1, $lang2)
11340
11341 the function similarity_language_tag($lang1, $lang2)
11342
11343 the function is_dialect_of($lang1, $lang2)
11344
11345 the function super_languages($lang1)
11346
11347 the function locale2language_tag($locale_identifier)
11348
11349 the function encode_language_tag($lang1)
11350
11351 the function alternate_language_tags($lang1)
11352
11353 the function @langs = panic_languages(@accept_languages)
11354
11355 =over 4
11356
11357 =item ABOUT LOWERCASING
11358
11359 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
11360
11361 =item SEE ALSO
11362
11363 =item COPYRIGHT
11364
11365 =item AUTHOR
11366
11367 =back
11368
11369 =head2 I18N::LangTags::List -- tags and names for human languages
11370
11371 =over 4
11372
11373 =item SYNOPSIS
11374
11375 =item DESCRIPTION
11376
11377 =item ABOUT LANGUAGE TAGS
11378
11379 =item LIST OF LANGUAGES
11380
11381 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
11382 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
11383 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
11384 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
11385 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
11386 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
11387 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
11388 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
11389 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
11390 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
11391 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
11392 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
11393 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
11394 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
11395 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
11396 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
11397 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
11398 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
11399 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
11400 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
11401 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
11402 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
11403 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
11404 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
11405 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
11406 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
11407 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
11408 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
11409 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
11410 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
11411 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
11412 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
11413 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
11414 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
11415 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
11416 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
11417 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
11418 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
11419 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
11420 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
11421 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
11422 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
11423 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
11424 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
11425 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
11426 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
11427 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
11428 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
11429 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
11430 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
11431 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
11432 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
11433 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
11434 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
11435 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
11436 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
11437 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
11438 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
11439 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
11440 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
11441 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
11442 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
11443 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
11444 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
11445 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
11446 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
11447 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
11448 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
11449 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
11450 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
11451 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
11452 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
11453 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
11454 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
11455 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
11456 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
11457 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
11458 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
11459 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
11460 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
11461 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
11462 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
11463 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
11464 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
11465 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
11466 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
11467 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
11468 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
11469 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
11470 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
11471 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
11472 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
11473 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
11474 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
11475 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
11476 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
11477 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
11478 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
11479 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
11480 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
11481 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
11482 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
11483 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
11484 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
11485 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
11486 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
11487 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
11488 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
11489 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
11490 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
11491 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
11492 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
11493 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
11494 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
11495 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
11496 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
11497 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
11498 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
11499 Zhuang, {zu} : Zulu, {zun} : Zuni
11500
11501 =item SEE ALSO
11502
11503 =item COPYRIGHT AND DISCLAIMER
11504
11505 =item AUTHOR
11506
11507 =back
11508
11509 =head2 I18N::Langinfo - query locale information
11510
11511 =over 4
11512
11513 =item SYNOPSIS
11514
11515 =item DESCRIPTION
11516
11517 =over 4
11518
11519 =item EXPORT
11520
11521 =back
11522
11523 =item SEE ALSO
11524
11525 =item AUTHOR
11526
11527 =item COPYRIGHT AND LICENSE
11528
11529 =back
11530
11531 =head2 IO - load various IO modules
11532
11533 =over 4
11534
11535 =item SYNOPSIS
11536
11537 =item DESCRIPTION
11538
11539 =back
11540
11541 =head2 IO::Dir - supply object methods for directory handles
11542
11543 =over 4
11544
11545 =item SYNOPSIS
11546
11547 =item DESCRIPTION
11548
11549 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11550 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11551
11552 =item SEE ALSO
11553
11554 =item AUTHOR
11555
11556 =item COPYRIGHT
11557
11558 =back
11559
11560 =head2 IO::File - supply object methods for filehandles
11561
11562 =over 4
11563
11564 =item SYNOPSIS
11565
11566 =item DESCRIPTION
11567
11568 =item CONSTRUCTOR
11569
11570 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11571
11572 =item METHODS
11573
11574 open( FILENAME [,MODE [,PERMS]] )
11575
11576 =item SEE ALSO
11577
11578 =item HISTORY
11579
11580 =back
11581
11582 =head2 IO::Handle - supply object methods for I/O handles
11583
11584 =over 4
11585
11586 =item SYNOPSIS
11587
11588 =item DESCRIPTION
11589
11590 =item CONSTRUCTOR
11591
11592 new (), new_from_fd ( FD, MODE )
11593
11594 =item METHODS
11595
11596 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
11597 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
11598 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
11599 $io->blocking ( [ BOOL ] ), $io->untaint
11600
11601 =item NOTE
11602
11603 =item SEE ALSO
11604
11605 =item BUGS
11606
11607 =item HISTORY
11608
11609 =back
11610
11611 =head2 IO::Pipe - supply object methods for pipes
11612
11613 =over 4
11614
11615 =item SYNOPSIS
11616
11617 =item DESCRIPTION
11618
11619 =item CONSTRUCTOR
11620
11621 new ( [READER, WRITER] )
11622
11623 =item METHODS
11624
11625 reader ([ARGS]), writer ([ARGS]), handles ()
11626
11627 =item SEE ALSO
11628
11629 =item AUTHOR
11630
11631 =item COPYRIGHT
11632
11633 =back
11634
11635 =head2 IO::Poll - Object interface to system poll call
11636
11637 =over 4
11638
11639 =item SYNOPSIS
11640
11641 =item DESCRIPTION
11642
11643 =item METHODS
11644
11645 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
11646 IO ), handles( [ EVENT_MASK ] )
11647
11648 =item SEE ALSO
11649
11650 =item AUTHOR
11651
11652 =item COPYRIGHT
11653
11654 =back
11655
11656 =head2 IO::Seekable - supply seek based methods for I/O objects
11657
11658 =over 4
11659
11660 =item SYNOPSIS
11661
11662 =item DESCRIPTION
11663
11664 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
11665 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
11666 $io->tell
11667
11668 =item SEE ALSO
11669
11670 =item HISTORY
11671
11672 =back
11673
11674 =head2 IO::Select - OO interface to the select system call
11675
11676 =over 4
11677
11678 =item SYNOPSIS
11679
11680 =item DESCRIPTION
11681
11682 =item CONSTRUCTOR
11683
11684 new ( [ HANDLES ] )
11685
11686 =item METHODS
11687
11688 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11689 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11690 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11691
11692 =item EXAMPLE
11693
11694 =item AUTHOR
11695
11696 =item COPYRIGHT
11697
11698 =back
11699
11700 =head2 IO::Socket - Object interface to socket communications
11701
11702 =over 4
11703
11704 =item SYNOPSIS
11705
11706 =item DESCRIPTION
11707
11708 =item CONSTRUCTOR
11709
11710 new ( [ARGS] )
11711
11712 =item METHODS
11713
11714 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11715 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11716
11717 =item SEE ALSO
11718
11719 =item AUTHOR
11720
11721 =item COPYRIGHT
11722
11723 =back
11724
11725 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
11726
11727 =over 4
11728
11729 =item SYNOPSIS
11730
11731 =item DESCRIPTION
11732
11733 =item CONSTRUCTOR
11734
11735 new ( [ARGS] )
11736
11737 =over 4
11738
11739 =item METHODS
11740
11741 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11742 ()
11743
11744 =back
11745
11746 =item SEE ALSO
11747
11748 =item AUTHOR
11749
11750 =item COPYRIGHT
11751
11752 =back
11753
11754 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
11755
11756 =over 4
11757
11758 =item SYNOPSIS
11759
11760 =item DESCRIPTION
11761
11762 =item CONSTRUCTOR
11763
11764 new ( [ARGS] )
11765
11766 =item METHODS
11767
11768 hostpath(), peerpath()
11769
11770 =item SEE ALSO
11771
11772 =item AUTHOR
11773
11774 =item COPYRIGHT
11775
11776 =back
11777
11778 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
11779 handles
11780
11781 =over 4
11782
11783 =item SYNOPSIS
11784
11785 =item DESCRIPTION
11786
11787 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11788 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11789
11790 =item SEE ALSO
11791
11792 =item AUTHOR
11793
11794 =item COPYRIGHT
11795
11796 =back
11797
11798 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
11799
11800 =over 4
11801
11802 =item SYNOPSIS
11803
11804 =item DESCRIPTION
11805
11806 =item CONSTRUCTOR
11807
11808 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11809
11810 =item METHODS
11811
11812 open( FILENAME [,MODE [,PERMS]] )
11813
11814 =item SEE ALSO
11815
11816 =item HISTORY
11817
11818 =back
11819
11820 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
11821 handles
11822
11823 =over 4
11824
11825 =item SYNOPSIS
11826
11827 =item DESCRIPTION
11828
11829 =item CONSTRUCTOR
11830
11831 new (), new_from_fd ( FD, MODE )
11832
11833 =item METHODS
11834
11835 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
11836 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
11837 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
11838 $io->blocking ( [ BOOL ] ), $io->untaint
11839
11840 =item NOTE
11841
11842 =item SEE ALSO
11843
11844 =item BUGS
11845
11846 =item HISTORY
11847
11848 =back
11849
11850 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
11851
11852 =over 4
11853
11854 =item SYNOPSIS
11855
11856 =item DESCRIPTION
11857
11858 =item CONSTRUCTOR
11859
11860 new ( [READER, WRITER] )
11861
11862 =item METHODS
11863
11864 reader ([ARGS]), writer ([ARGS]), handles ()
11865
11866 =item SEE ALSO
11867
11868 =item AUTHOR
11869
11870 =item COPYRIGHT
11871
11872 =back
11873
11874 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
11875
11876 =over 4
11877
11878 =item SYNOPSIS
11879
11880 =item DESCRIPTION
11881
11882 =item METHODS
11883
11884 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
11885 IO ), handles( [ EVENT_MASK ] )
11886
11887 =item SEE ALSO
11888
11889 =item AUTHOR
11890
11891 =item COPYRIGHT
11892
11893 =back
11894
11895 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
11896 I/O objects
11897
11898 =over 4
11899
11900 =item SYNOPSIS
11901
11902 =item DESCRIPTION
11903
11904 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
11905 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
11906 $io->tell
11907
11908 =item SEE ALSO
11909
11910 =item HISTORY
11911
11912 =back
11913
11914 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
11915 call
11916
11917 =over 4
11918
11919 =item SYNOPSIS
11920
11921 =item DESCRIPTION
11922
11923 =item CONSTRUCTOR
11924
11925 new ( [ HANDLES ] )
11926
11927 =item METHODS
11928
11929 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11930 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11931 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11932
11933 =item EXAMPLE
11934
11935 =item AUTHOR
11936
11937 =item COPYRIGHT
11938
11939 =back
11940
11941 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
11942 communications
11943
11944 =over 4
11945
11946 =item SYNOPSIS
11947
11948 =item DESCRIPTION
11949
11950 =item CONSTRUCTOR
11951
11952 new ( [ARGS] )
11953
11954 =item METHODS
11955
11956 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11957 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11958
11959 =item SEE ALSO
11960
11961 =item AUTHOR
11962
11963 =item COPYRIGHT
11964
11965 =back
11966
11967 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
11968 AF_INET domain sockets
11969
11970 =over 4
11971
11972 =item SYNOPSIS
11973
11974 =item DESCRIPTION
11975
11976 =item CONSTRUCTOR
11977
11978 new ( [ARGS] )
11979
11980 =over 4
11981
11982 =item METHODS
11983
11984 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11985 ()
11986
11987 =back
11988
11989 =item SEE ALSO
11990
11991 =item AUTHOR
11992
11993 =item COPYRIGHT
11994
11995 =back
11996
11997 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
11998 AF_UNIX domain sockets
11999
12000 =over 4
12001
12002 =item SYNOPSIS
12003
12004 =item DESCRIPTION
12005
12006 =item CONSTRUCTOR
12007
12008 new ( [ARGS] )
12009
12010 =item METHODS
12011
12012 hostpath(), peerpath()
12013
12014 =item SEE ALSO
12015
12016 =item AUTHOR
12017
12018 =item COPYRIGHT
12019
12020 =back
12021
12022 =head2 IPC::Msg - SysV Msg IPC object class
12023
12024 =over 4
12025
12026 =item SYNOPSIS
12027
12028 =item DESCRIPTION
12029
12030 =item METHODS
12031
12032 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12033 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12034 FLAGS ] ), stat
12035
12036 =item SEE ALSO
12037
12038 =item AUTHOR
12039
12040 =item COPYRIGHT
12041
12042 =back
12043
12044 =head2 IPC::Open2, open2 - open a process for both reading and writing
12045
12046 =over 4
12047
12048 =item SYNOPSIS
12049
12050 =item DESCRIPTION
12051
12052 =item WARNING
12053
12054 =item SEE ALSO
12055
12056 =back
12057
12058 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
12059 handling
12060
12061 =over 4
12062
12063 =item SYNOPSIS
12064
12065 =item DESCRIPTION
12066
12067 =item WARNING
12068
12069 =back
12070
12071 =head2 IPC::Semaphore - SysV Semaphore IPC object class
12072
12073 =over 4
12074
12075 =item SYNOPSIS
12076
12077 =item DESCRIPTION
12078
12079 =item METHODS
12080
12081 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12082 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12083 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12084 , VALUE ), stat
12085
12086 =item SEE ALSO
12087
12088 =item AUTHOR
12089
12090 =item COPYRIGHT
12091
12092 =back
12093
12094 =head2 IPC::SysV - SysV IPC constants
12095
12096 =over 4
12097
12098 =item SYNOPSIS
12099
12100 =item DESCRIPTION
12101
12102 ftok( PATH, ID )
12103
12104 =item SEE ALSO
12105
12106 =item AUTHORS
12107
12108 =item COPYRIGHT
12109
12110 =back
12111
12112 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
12113
12114 =over 4
12115
12116 =item SYNOPSIS
12117
12118 =item DESCRIPTION
12119
12120 =item METHODS
12121
12122 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12123 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12124 FLAGS ] ), stat
12125
12126 =item SEE ALSO
12127
12128 =item AUTHOR
12129
12130 =item COPYRIGHT
12131
12132 =back
12133
12134 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
12135 class
12136
12137 =over 4
12138
12139 =item SYNOPSIS
12140
12141 =item DESCRIPTION
12142
12143 =item METHODS
12144
12145 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12146 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12147 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12148 , VALUE ), stat
12149
12150 =item SEE ALSO
12151
12152 =item AUTHOR
12153
12154 =item COPYRIGHT
12155
12156 =back
12157
12158 =head2 Lingua::KO::Hangul::Util - utility functions for Hangul Syllables
12159
12160 =over 4
12161
12162 =item SYNOPSIS
12163
12164 =item DESCRIPTION
12165
12166 =over 4
12167
12168 =item Composition and Decomposition
12169
12170 C<$string_decomposed = decomposeHangul($codepoint)>, C<@codepoints =
12171 decomposeHangul($codepoint)>, C<$string_composed =
12172 composeHangul($src_string)>, C<@codepoints_composed =
12173 composeHangul($src_string)>
12174
12175 =item Hangul Syllable Name
12176
12177 C<$name = getHangulName($codepoint)>, C<$codepoint =
12178 parseHangulName($name)>
12179
12180 =item EXPORT
12181
12182 =back
12183
12184 =item AUTHOR
12185
12186 =item SEE ALSO
12187
12188 http://www.unicode.org/unicode/reports/tr15
12189
12190 =back
12191
12192 =head2 List::Util - A selection of general-utility list subroutines
12193
12194 =over 4
12195
12196 =item SYNOPSIS
12197
12198 =item DESCRIPTION
12199
12200 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12201 BLOCK LIST, shuffle LIST, sum LIST
12202
12203 =item SUGGESTED ADDITIONS
12204
12205 =item COPYRIGHT
12206
12207 =back
12208
12209 =head2 List::Utilib::List::Util, List::Util - A selection of
12210 general-utility list subroutines
12211
12212 =over 4
12213
12214 =item SYNOPSIS
12215
12216 =item DESCRIPTION
12217
12218 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12219 BLOCK LIST, shuffle LIST, sum LIST
12220
12221 =item SUGGESTED ADDITIONS
12222
12223 =item COPYRIGHT
12224
12225 =back
12226
12227 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
12228 general-utility scalar subroutines
12229
12230 =over 4
12231
12232 =item SYNOPSIS
12233
12234 =item DESCRIPTION
12235
12236 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
12237 EXPR, tainted EXPR, weaken REF
12238
12239 =item COPYRIGHT
12240
12241 =item BLATANT PLUG
12242
12243 =back
12244
12245 =head2 Locale::Constants - constants for Locale codes
12246
12247 =over 4
12248
12249 =item SYNOPSIS
12250
12251 =item DESCRIPTION
12252
12253 =item KNOWN BUGS AND LIMITATIONS
12254
12255 =item SEE ALSO
12256
12257 Locale::Language, Locale::Country, Locale::Currency
12258
12259 =item AUTHOR
12260
12261 =item COPYRIGHT
12262
12263 =back
12264
12265 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
12266
12267 =over 4
12268
12269 =item SYNOPSIS
12270
12271 =back
12272
12273 =over 4
12274
12275 =item DESCRIPTION
12276
12277 B<alpha-2>, B<alpha-3>, B<numeric>
12278
12279 =back
12280
12281 =over 4
12282
12283 =item CONVERSION ROUTINES
12284
12285 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
12286 country_code2code( CODE, CODESET, CODESET )
12287
12288 =back
12289
12290 =over 4
12291
12292 =item QUERY ROUTINES
12293
12294 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
12295
12296 =back
12297
12298 =over 4
12299
12300 =item CODE ALIASING
12301
12302 =back
12303
12304 =over 4
12305
12306 =item EXAMPLES
12307
12308 =item DOMAIN NAMES
12309
12310 =item KNOWN BUGS AND LIMITATIONS
12311
12312 =item SEE ALSO
12313
12314 Locale::Language, Locale::Currency, ISO 3166,
12315 http://www.din.de/gremien/nas/nabd/iso3166ma/,
12316 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
12317 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
12318
12319 =item AUTHOR
12320
12321 =item COPYRIGHT
12322
12323 =back
12324
12325 =head2 Locale::Currency - ISO three letter codes for currency
12326 identification (ISO 4217)
12327
12328 =over 4
12329
12330 =item SYNOPSIS
12331
12332 =back
12333
12334 =over 4
12335
12336 =item DESCRIPTION
12337
12338 XTS, XXX
12339
12340 =back
12341
12342 =over 4
12343
12344 =item CONVERSION ROUTINES
12345
12346 code2currency(), currency2code()
12347
12348 =back
12349
12350 =over 4
12351
12352 =item QUERY ROUTINES
12353
12354 C<all_currency_codes()>, C<all_currency_names()>
12355
12356 =back
12357
12358 =over 4
12359
12360 =item EXAMPLES
12361
12362 =item KNOWN BUGS AND LIMITATIONS
12363
12364 =item SEE ALSO
12365
12366 Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
12367
12368 =item AUTHOR
12369
12370 =item COPYRIGHT
12371
12372 =back
12373
12374 =head2 Locale::Language - ISO two letter codes for language identification
12375 (ISO 639)
12376
12377 =over 4
12378
12379 =item SYNOPSIS
12380
12381 =back
12382
12383 =over 4
12384
12385 =item DESCRIPTION
12386
12387 =back
12388
12389 =over 4
12390
12391 =item CONVERSION ROUTINES
12392
12393 code2language(), language2code()
12394
12395 =back
12396
12397 =over 4
12398
12399 =item QUERY ROUTINES
12400
12401 C<all_language_codes()>, C<all_language_names()>
12402
12403 =back
12404
12405 =over 4
12406
12407 =item EXAMPLES
12408
12409 =item KNOWN BUGS AND LIMITATIONS
12410
12411 =item SEE ALSO
12412
12413 Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
12414 http://lcweb.loc.gov/standards/iso639-2/langhome.html
12415
12416 =item AUTHOR
12417
12418 =item COPYRIGHT
12419
12420 =back
12421
12422 =head2 Locale::Maketext -- framework for localization
12423
12424 =over 4
12425
12426 =item SYNOPSIS
12427
12428 =item DESCRIPTION
12429
12430 =item QUICK OVERVIEW
12431
12432 =item METHODS
12433
12434 =over 4
12435
12436 =item Construction Methods
12437
12438 =item The "maketext" Method
12439
12440 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
12441
12442 =item Utility Methods
12443
12444 $language->quant($number, $singular), $language->quant($number, $singular,
12445 $plural), $language->quant($number, $singular, $plural, $negative),
12446 $language->numf($number), $language->sprintf($format, @items),
12447 $language->language_tag(), $language->encoding()
12448
12449 =item Language Handle Attributes and Internals
12450
12451 =back
12452
12453 =item LANGUAGE CLASS HIERARCHIES
12454
12455 =item ENTRIES IN EACH LEXICON
12456
12457 =item BRACKET NOTATION
12458
12459 =item AUTO LEXICONS
12460
12461 =item CONTROLLING LOOKUP FAILURE
12462
12463 =item HOW TO USE MAKETEXT
12464
12465 =item SEE ALSO
12466
12467 =item COPYRIGHT AND DISCLAIMER
12468
12469 =item AUTHOR
12470
12471 =back
12472
12473 =head2 Locale::Maketext::TPJ13 -- article about software localization
12474
12475 =over 4
12476
12477 =item SYNOPSIS
12478
12479 =item DESCRIPTION
12480
12481 =item Localization and Perl: gettext breaks, Maketext fixes
12482
12483 =over 4
12484
12485 =item A Localization Horror Story: It Could Happen To You
12486
12487 =item The Linguistic View
12488
12489 =item Breaking gettext
12490
12491 =item Replacing gettext
12492
12493 =item Buzzwords: Abstraction and Encapsulation
12494
12495 =item Buzzword: Isomorphism
12496
12497 =item Buzzword: Inheritance
12498
12499 =item Buzzword: Concision
12500
12501 =item The Devil in the Details
12502
12503 =item The Proof in the Pudding: Localizing Web Sites
12504
12505 =item References
12506
12507 =back
12508
12509 =back
12510
12511 =head2 MIME::Base64 - Encoding and decoding of base64 strings
12512
12513 =over 4
12514
12515 =item SYNOPSIS
12516
12517 =item DESCRIPTION
12518
12519 encode_base64($str, [$eol]), decode_base64($str)
12520
12521 =item DIAGNOSTICS
12522
12523 Premature end of base64 data, Premature padding of base64 data
12524
12525 =item EXAMPLES
12526
12527 =item COPYRIGHT
12528
12529 =back
12530
12531 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
12532 of quoted-printable strings
12533
12534 =over 4
12535
12536 =item SYNOPSIS
12537
12538 =item DESCRIPTION
12539
12540 encode_qp($str), decode_qp($str);
12541
12542 =item COPYRIGHT
12543
12544 =back
12545
12546 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
12547 strings
12548
12549 =over 4
12550
12551 =item SYNOPSIS
12552
12553 =item DESCRIPTION
12554
12555 encode_qp($str), decode_qp($str);
12556
12557 =item COPYRIGHT
12558
12559 =back
12560
12561 =head2 Math::BigFloat - Arbitrary size floating point math package
12562
12563 =over 4
12564
12565 =item SYNOPSIS
12566
12567 =item DESCRIPTION
12568
12569 =over 4
12570
12571 =item Canonical notation
12572
12573 =item Output
12574
12575 =item C<mantissa()>, C<exponent()> and C<parts()>
12576
12577 =item Accuracy vs. Precision
12578
12579 =item Rounding
12580
12581 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
12582 ), fround  ( -$scale ) and fround ( 0 )
12583
12584 =back
12585
12586 =item EXAMPLES
12587
12588   # not ready yet
12589
12590 =item Autocreating constants
12591
12592 =item BUGS
12593
12594 =item CAVEAT
12595
12596 stringify, bstr(), bdiv, Modifying and =, bpow
12597
12598 =item LICENSE
12599
12600 =item AUTHORS
12601
12602 =back
12603
12604 =head2 Math::BigInt - Arbitrary size integer math package
12605
12606 =over 4
12607
12608 =item SYNOPSIS
12609
12610 =item DESCRIPTION
12611
12612 Canonical notation, Input, Output
12613
12614 =item ACCURACY and PRECISION
12615
12616 =over 4
12617
12618 =item Precision P
12619
12620 =item Accuracy A
12621
12622 =item Fallback F
12623
12624 =item Rounding mode R
12625
12626 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
12627 (significant digits), Setting/Accessing, Creating numbers, Usage,
12628 Precedence, Overriding globals, Local settings, Rounding, Default values,
12629 Remarks
12630
12631 =back
12632
12633 =item INTERNALS
12634
12635 =over 4
12636
12637 =item MATH LIBRARY
12638
12639 =item SIGN
12640
12641 =item mantissa(), exponent() and parts()
12642
12643 =back
12644
12645 =item EXAMPLES
12646
12647   use Math::BigInt qw(bstr);
12648
12649 =item Autocreating constants
12650
12651 =item PERFORMANCE
12652
12653 =over 4
12654
12655 =item Alternative math libraries
12656
12657 =back
12658
12659 =item BUGS
12660
12661 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
12662
12663 =item CAVEATS
12664
12665 stringify, bstr(), bsstr() and 'cmp', int(), bdiv, bdiv, Modifying and =,
12666 bpow, Overloading -$x, Mixing different object types, bsqrt()
12667
12668 =item LICENSE
12669
12670 =item SEE ALSO
12671
12672 =item AUTHORS
12673
12674 =back
12675
12676 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
12677
12678 =over 4
12679
12680 =item SYNOPSIS
12681
12682 =item DESCRIPTION
12683
12684 =item EXPORT
12685
12686 =item WRAP YOUR OWN
12687
12688 =item LICENSE
12689
12690 This program is free software; you may redistribute it and/or modify it
12691 under
12692 the same terms as Perl itself.
12693
12694 =item AUTHORS
12695
12696 =item SEE ALSO
12697
12698 =back
12699
12700 =head2 Math::Complex - complex numbers and associated mathematical
12701 functions
12702
12703 =over 4
12704
12705 =item SYNOPSIS
12706
12707 =item DESCRIPTION
12708
12709 =item OPERATIONS
12710
12711 =item CREATION
12712
12713 =item STRINGIFICATION
12714
12715 =over 4
12716
12717 =item CHANGED IN PERL 5.6
12718
12719 =back
12720
12721 =item USAGE
12722
12723 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
12724
12725 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
12726
12727 =item BUGS
12728
12729 =item AUTHORS
12730
12731 =back
12732
12733 =head2 Math::Trig - trigonometric functions
12734
12735 =over 4
12736
12737 =item SYNOPSIS
12738
12739 =item DESCRIPTION
12740
12741 =item TRIGONOMETRIC FUNCTIONS
12742
12743 B<tan>
12744
12745 =over 4
12746
12747 =item ERRORS DUE TO DIVISION BY ZERO
12748
12749 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
12750
12751 =back
12752
12753 =item PLANE ANGLE CONVERSIONS
12754
12755 =item RADIAL COORDINATE CONVERSIONS
12756
12757 =over 4
12758
12759 =item COORDINATE SYSTEMS
12760
12761 =item 3-D ANGLE CONVERSIONS
12762
12763 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
12764 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
12765
12766 =back
12767
12768 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
12769
12770 =item EXAMPLES
12771
12772 =over 4
12773
12774 =item CAVEAT FOR GREAT CIRCLE FORMULAS
12775
12776 =back
12777
12778 =item BUGS
12779
12780 =item AUTHORS
12781
12782 =back
12783
12784 =head2 Memoize - Make your functions faster by trading space for time
12785
12786 =over 4
12787
12788 =item SYNOPSIS
12789
12790 =item DESCRIPTION
12791
12792 =item DETAILS
12793
12794 =item OPTIONS
12795
12796 =over 4
12797
12798 =item INSTALL
12799
12800 =item NORMALIZER
12801
12802 =item C<SCALAR_CACHE>, C<LIST_CACHE>
12803
12804 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
12805
12806 =back
12807
12808 =item OTHER FACILITIES
12809
12810 =over 4
12811
12812 =item C<unmemoize>
12813
12814 =item C<flush_cache>
12815
12816 =back
12817
12818 =item CAVEATS
12819
12820 =item PERSISTENT CACHE SUPPORT
12821
12822 =item EXPIRATION SUPPORT
12823
12824 =item BUGS
12825
12826 =item MAILING LIST
12827
12828 =item AUTHOR
12829
12830 =item COPYRIGHT AND LICENSE
12831
12832 =item THANK YOU
12833
12834 =back
12835
12836 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
12837 Storable use
12838
12839 =over 4
12840
12841 =item DESCRIPTION
12842
12843 =back
12844
12845 =head2 Memoize::Expire - Plug-in module for automatic expiration of
12846 memoized values
12847
12848 =over 4
12849
12850 =item SYNOPSIS
12851
12852 =item DESCRIPTION
12853
12854 =item INTERFACE
12855
12856  TIEHASH,  EXISTS,  STORE
12857
12858 =item ALTERNATIVES
12859
12860 =item CAVEATS
12861
12862 =item AUTHOR
12863
12864 =item SEE ALSO
12865
12866 =back
12867
12868 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
12869
12870 =over 4
12871
12872 =item DESCRIPTION
12873
12874 =back
12875
12876 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
12877
12878 =over 4
12879
12880 =item DESCRIPTION
12881
12882 =back
12883
12884 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
12885 Storable use
12886
12887 =over 4
12888
12889 =item DESCRIPTION
12890
12891 =back
12892
12893 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
12894 Storable use
12895
12896 =over 4
12897
12898 =item DESCRIPTION
12899
12900 =back
12901
12902 =head2 Memoize::Saves - Plug-in module to specify which return values
12903 should be memoized
12904
12905 =over 4
12906
12907 =item SYNOPSIS
12908
12909 =item DESCRIPTION
12910
12911 =item CAVEATS
12912
12913 =item AUTHOR
12914
12915 =item SEE ALSO
12916
12917 =back
12918
12919 =head2 Memoize::Storable - store Memoized data in Storable database
12920
12921 =over 4
12922
12923 =item DESCRIPTION
12924
12925 =back
12926
12927 =head2 NDBM_File - Tied access to ndbm files
12928
12929 =over 4
12930
12931 =item SYNOPSIS
12932
12933 =item DESCRIPTION
12934
12935 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
12936
12937 =item DIAGNOSTICS
12938
12939 =over 4
12940
12941 =item C<ndbm store returned -1, errno 22, key "..." at ...>
12942
12943 =back
12944
12945 =item BUGS AND WARNINGS
12946
12947 =back
12948
12949 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
12950
12951 =over 4
12952
12953 =item SYNOPSIS
12954
12955 =item DESCRIPTION
12956
12957 =item AUTHOR
12958
12959 =item BUGS AND IRRITATIONS
12960
12961 =item COPYRIGHT
12962
12963 =back
12964
12965 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
12966
12967 =over 4
12968
12969 =item SYNOPSIS
12970
12971 =item DESCRIPTION
12972
12973 =item USER METHODS
12974
12975 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
12976 dataend ()
12977
12978 =item CLASS METHODS
12979
12980 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
12981 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
12982 ungetline ( TEXT ), read_until_dot ()
12983
12984 =item EXPORTS
12985
12986 =item AUTHOR
12987
12988 =item COPYRIGHT
12989
12990 =back
12991
12992 =head2 Net::Config - Local configuration data for libnet
12993
12994 =over 4
12995
12996 =item SYNOPSYS
12997
12998 =item DESCRIPTION
12999
13000 =item METHODS
13001
13002 requires_firewall HOST
13003
13004 =item NetConfig VALUES
13005
13006 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
13007 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
13008 ftp_int_pasive, local_netmask, test_hosts, test_exists
13009
13010 =back
13011
13012 =head2 Net::Domain - Attempt to evaluate the current host's internet name
13013 and domain
13014
13015 =over 4
13016
13017 =item SYNOPSIS
13018
13019 =item DESCRIPTION
13020
13021 hostfqdn (), hostname (), hostdomain ()
13022
13023 =item AUTHOR
13024
13025 =item COPYRIGHT
13026
13027 =back
13028
13029 =head2 Net::FTP - FTP Client class
13030
13031 =over 4
13032
13033 =item SYNOPSIS
13034
13035 =item DESCRIPTION
13036
13037 =item OVERVIEW
13038
13039 =item CONSTRUCTOR
13040
13041 new (HOST [,OPTIONS])
13042
13043 =item METHODS
13044
13045 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
13046 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
13047 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
13048 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
13049 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
13050 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
13051 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
13052 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
13053 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
13054 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
13055 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
13056 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
13057 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
13058
13059 =over 4
13060
13061 =item Methods for the adventurous
13062
13063 quot (CMD [,ARGS])
13064
13065 =back
13066
13067 =item THE dataconn CLASS
13068
13069 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
13070 bytes_read (), abort (), close ()
13071
13072 =item UNIMPLEMENTED
13073
13074 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
13075
13076 =item REPORTING BUGS
13077
13078 =item AUTHOR
13079
13080 =item SEE ALSO
13081
13082 =item USE EXAMPLES
13083
13084 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
13085
13086 =item CREDITS
13087
13088 =item COPYRIGHT
13089
13090 =back
13091
13092 =head2 Net::NNTP - NNTP Client class
13093
13094 =over 4
13095
13096 =item SYNOPSIS
13097
13098 =item DESCRIPTION
13099
13100 =item CONSTRUCTOR
13101
13102 new ( [ HOST ] [, OPTIONS ])
13103
13104 =item METHODS
13105
13106 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
13107 [ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
13108 ), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
13109 USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
13110 SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
13111 (), quit ()
13112
13113 =over 4
13114
13115 =item Extension methods
13116
13117 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
13118 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
13119 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
13120 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
13121 GROUP ] ), reader
13122
13123 =back
13124
13125 =item UNSUPPORTED
13126
13127 =item DEFINITIONS
13128
13129 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
13130
13131 =item SEE ALSO
13132
13133 =item AUTHOR
13134
13135 =item COPYRIGHT
13136
13137 =back
13138
13139 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
13140
13141 =over 4
13142
13143 =item SYNOPSIS
13144
13145 =item DESCRIPTION
13146
13147 =item EXAMPLES
13148
13149 =item CONSTRUCTOR
13150
13151 new ( [ HOST, ] [ OPTIONS ] )
13152
13153 =item METHODS
13154
13155 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
13156 PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
13157 FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
13158 MSGNUM ), reset (), quit ()
13159
13160 =item NOTES
13161
13162 =item SEE ALSO
13163
13164 =item AUTHOR
13165
13166 =item COPYRIGHT
13167
13168 =back
13169
13170 =head2 Net::Ping - check a remote host for reachability
13171
13172 =over 4
13173
13174 =item SYNOPSIS
13175
13176 =item DESCRIPTION
13177
13178 icmp, udp, tcp, stream, external
13179
13180 =over 4
13181
13182 =item Functions
13183
13184 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
13185 $timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
13186
13187 =back
13188
13189 =item NOTES
13190
13191 =back
13192
13193 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
13194
13195 =over 4
13196
13197 =item SYNOPSIS
13198
13199 =item DESCRIPTION
13200
13201 =item EXAMPLES
13202
13203 =item CONSTRUCTOR
13204
13205 new Net::SMTP [ HOST, ] [ OPTIONS ]
13206
13207 =item METHODS
13208
13209 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [,
13210 OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail (
13211 ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ),
13212 to ( ADDRESS [, ADDRESS [...]] ), cc ( ADDRESS [, ADDRESS [...]] ), bcc (
13213 ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify
13214 ( ADDRESS ), help ( [ $subject ] ), quit ()
13215
13216 =item SEE ALSO
13217
13218 =item AUTHOR
13219
13220 =item COPYRIGHT
13221
13222 =back
13223
13224 =head2 Net::Time - time and daytime network client interface
13225
13226 =over 4
13227
13228 =item SYNOPSIS
13229
13230 =item DESCRIPTION
13231
13232 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
13233 PROTOCOL [, TIMEOUT]]])
13234
13235 =item AUTHOR
13236
13237 =item COPYRIGHT
13238
13239 =back
13240
13241 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
13242 functions
13243
13244 =over 4
13245
13246 =item SYNOPSIS
13247
13248 =item DESCRIPTION
13249
13250 =item EXAMPLES
13251
13252 =item NOTE
13253
13254 =item AUTHOR
13255
13256 =back
13257
13258 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
13259
13260 =over 4
13261
13262 =item DESCRIPTION
13263
13264 =over 4
13265
13266 =item Where to get this document
13267
13268 =item How to contribute to this document
13269
13270 =back
13271
13272 =item Author and Copyright Information
13273
13274 =over 4
13275
13276 =item Disclaimer
13277
13278 =back
13279
13280 =item Obtaining and installing libnet
13281
13282 =over 4
13283
13284 =item What is libnet ?
13285
13286 =item Which version of perl do I need ?
13287
13288 =item What other modules do I need ?
13289
13290 =item What machines support libnet ?
13291
13292 =item Where can I get the latest libnet release
13293
13294 =back
13295
13296 =item Using Net::FTP
13297
13298 =over 4
13299
13300 =item How do I download files from a FTP server ?
13301
13302 =item How do I transfer files in binary mode ?
13303
13304 =item How can I get the size of a file on a remote FTP server ?
13305
13306 =item How can I get the modification time of a file on a remote FTP server
13307 ?
13308
13309 =item How can I change the permissions of a file on a remote server ?
13310
13311 =item Can I do a reget operation like the ftp command ?
13312
13313 =item How do I get a directory listing from a FTP server ?
13314
13315 =item Changeing directory to "" does not fail ?
13316
13317 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
13318
13319 =item I am behind a FTP proxy firewall, but cannot access machines outside
13320 ?
13321
13322 =item My ftp proxy firewall does not listen on port 21
13323
13324 =item Is it possible to change the file permissions of a file on an FTP
13325 server ?
13326
13327 =item I have seen scripts call a method message, but cannot find it
13328 documented ?
13329
13330 =item Why does Net::FTP not implement mput and mget methods
13331
13332 =back
13333
13334 =item Using Net::SMTP
13335
13336 =over 4
13337
13338 =item Why can't the part of an Email address after the @ be used as the
13339 hostname ?
13340
13341 =item Why does Net::SMTP not do DNS MX lookups ?
13342
13343 =item The verify method always returns true ?
13344
13345 =back
13346
13347 =item Debugging scripts
13348
13349 =over 4
13350
13351 =item How can I debug my scripts that use Net::* modules ?
13352
13353 =back
13354
13355 =item AUTHOR AND COPYRIGHT
13356
13357 =back
13358
13359 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
13360 functions
13361
13362 =over 4
13363
13364 =item SYNOPSIS
13365
13366 =item DESCRIPTION
13367
13368 =item EXAMPLES
13369
13370 =item NOTE
13371
13372 =item AUTHOR
13373
13374 =back
13375
13376 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
13377 functions
13378
13379 =over 4
13380
13381 =item SYNOPSIS
13382
13383 =item DESCRIPTION
13384
13385 =item NOTE
13386
13387 =item AUTHOR
13388
13389 =back
13390
13391 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
13392 functions
13393
13394 =over 4
13395
13396 =item SYNOPSIS
13397
13398 =item DESCRIPTION
13399
13400 =item EXAMPLES
13401
13402 =item NOTE
13403
13404 =item AUTHOR
13405
13406 =back
13407
13408 =head2 Netrc, Net::Netrc - OO interface to users netrc file
13409
13410 =over 4
13411
13412 =item SYNOPSIS
13413
13414 =item DESCRIPTION
13415
13416 =item THE .netrc FILE
13417
13418 machine name, default, login name, password string, account string, macdef
13419 name
13420
13421 =item CONSTRUCTOR
13422
13423 lookup ( MACHINE [, LOGIN ])
13424
13425 =item METHODS
13426
13427 login (), password (), account (), lpa ()
13428
13429 =item AUTHOR
13430
13431 =item SEE ALSO
13432
13433 =item COPYRIGHT
13434
13435 =back
13436
13437 =head2 O - Generic interface to Perl Compiler backends
13438
13439 =over 4
13440
13441 =item SYNOPSIS
13442
13443 =item DESCRIPTION
13444
13445 =item CONVENTIONS
13446
13447 =item IMPLEMENTATION
13448
13449 =item AUTHOR
13450
13451 =back
13452
13453 =head2 ODBM_File - Tied access to odbm files
13454
13455 =over 4
13456
13457 =item SYNOPSIS
13458
13459 =item DESCRIPTION
13460
13461 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
13462
13463 =item DIAGNOSTICS
13464
13465 =over 4
13466
13467 =item C<odbm store returned -1, errno 22, key "..." at ...>
13468
13469 =back
13470
13471 =item BUGS AND WARNINGS
13472
13473 =back
13474
13475 =head2 Opcode - Disable named opcodes when compiling perl code
13476
13477 =over 4
13478
13479 =item SYNOPSIS
13480
13481 =item DESCRIPTION
13482
13483 =item NOTE
13484
13485 =item WARNING
13486
13487 =item Operator Names and Operator Lists
13488
13489 an operator name (opname), an operator tag name (optag), a negated opname
13490 or optag, an operator set (opset)
13491
13492 =item Opcode Functions
13493
13494 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
13495 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
13496 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
13497 opdump (PAT)
13498
13499 =item Manipulating Opsets
13500
13501 =item TO DO (maybe)
13502
13503 =back
13504
13505 =over 4
13506
13507 =item Predefined Opcode Tags
13508
13509 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
13510 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
13511 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
13512 :dangerous
13513
13514 =item SEE ALSO
13515
13516 =item AUTHORS
13517
13518 =back
13519
13520 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
13521 compartments
13522
13523 =over 4
13524
13525 =item SYNOPSIS
13526
13527 =item DESCRIPTION
13528
13529 a new namespace, an operator mask
13530
13531 =item WARNING
13532
13533 =over 4
13534
13535 =item RECENT CHANGES
13536
13537 =item Methods in class Safe
13538
13539 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
13540 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
13541 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
13542 root (NAMESPACE), mask (MASK)
13543
13544 =item Some Safety Issues
13545
13546 Memory, CPU, Snooping, Signals, State Changes
13547
13548 =item AUTHOR
13549
13550 =back
13551
13552 =back
13553
13554 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
13555 compiling
13556
13557 =over 4
13558
13559 =item SYNOPSIS
13560
13561 =item DESCRIPTION
13562
13563 =item SEE ALSO
13564
13565 =back
13566
13567 =head2 POSIX - Perl interface to IEEE Std 1003.1
13568
13569 =over 4
13570
13571 =item SYNOPSIS
13572
13573 =item DESCRIPTION
13574
13575 =item NOTE
13576
13577 =item CAVEATS
13578
13579 =item FUNCTIONS
13580
13581 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
13582 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
13583 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
13584 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
13585 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
13586 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
13587 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
13588 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
13589 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
13590 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
13591 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
13592 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
13593 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
13594 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
13595 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
13596 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
13597 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
13598 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
13599 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
13600 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
13601 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
13602 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
13603 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
13604 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
13605 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
13606 wctomb, write
13607
13608 =item CLASSES
13609
13610 =over 4
13611
13612 =item POSIX::SigAction
13613
13614 new
13615
13616 =item POSIX::SigSet
13617
13618 new, addset, delset, emptyset, fillset, ismember
13619
13620 =item POSIX::Termios
13621
13622 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
13623 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
13624 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
13625 field values, c_cflag field values, c_iflag field values, c_lflag field
13626 values, c_oflag field values
13627
13628 =back
13629
13630 =item PATHNAME CONSTANTS
13631
13632 Constants
13633
13634 =item POSIX CONSTANTS
13635
13636 Constants
13637
13638 =item SYSTEM CONFIGURATION
13639
13640 Constants
13641
13642 =item ERRNO
13643
13644 Constants
13645
13646 =item FCNTL
13647
13648 Constants
13649
13650 =item FLOAT
13651
13652 Constants
13653
13654 =item LIMITS
13655
13656 Constants
13657
13658 =item LOCALE
13659
13660 Constants
13661
13662 =item MATH
13663
13664 Constants
13665
13666 =item SIGNAL
13667
13668 Constants
13669
13670 =item STAT
13671
13672 Constants, Macros
13673
13674 =item STDLIB
13675
13676 Constants
13677
13678 =item STDIO
13679
13680 Constants
13681
13682 =item TIME
13683
13684 Constants
13685
13686 =item UNISTD
13687
13688 Constants
13689
13690 =item WAIT
13691
13692 Constants, Macros
13693
13694 =back
13695
13696 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
13697 name space
13698
13699 =over 4
13700
13701 =item SYNOPSIS
13702
13703 =item DESCRIPTION
13704
13705 unix, stdio, perlio, crlf, utf8, raw
13706
13707 =over 4
13708
13709 =item Defaults and how to override them
13710
13711 =back
13712
13713 =item AUTHOR
13714
13715 =item SEE ALSO
13716
13717 =back
13718
13719 =head2 PerlIO::Scalar - support module for in-memory IO.
13720
13721 =over 4
13722
13723 =item SYNOPSIS
13724
13725 =item DESCRIPTION
13726
13727 =back
13728
13729 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
13730
13731 =over 4
13732
13733 =item SYNOPSIS
13734
13735 =item DESCRIPTION
13736
13737 $class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
13738 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
13739 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
13740 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
13741 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
13742 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
13743 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
13744
13745 =back
13746
13747 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
13748
13749 =over 4
13750
13751 =item SYNOPSIS
13752
13753 =item OPTIONS/ARGUMENTS
13754
13755 =over 4
13756
13757 =item podchecker()
13758
13759 B<-warnings> =E<gt> I<val>
13760
13761 =back
13762
13763 =item DESCRIPTION
13764
13765 =item DIAGNOSTICS
13766
13767 =over 4
13768
13769 =item Errors
13770
13771 empty =headn, =over on line I<N> without closing =back, =item without
13772 previous =over, =back without previous =over, No argument for =begin, =end
13773 without =begin, Nested =begin's, =for without formatter specification,
13774 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
13775 interior-sequence "I<SEQ>", nested commands
13776 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
13777 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
13778 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
13779 after =back
13780
13781 =item Warnings
13782
13783 multiple occurence of link target I<name>, line containing nothing but
13784 whitespace in paragraph, file does not start with =head, previous =item has
13785 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
13786 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
13787 items in =over, No argument for =item, empty section in previous paragraph,
13788 Verbatim paragraph in NAME section
13789
13790 =item Hyperlinks
13791
13792 ignoring leading/trailing whitespace in link, (section) in '$page'
13793 deprecated, alternative text/node '%s' contains non-escaped | or /
13794
13795 =back
13796
13797 =item RETURN VALUE
13798
13799 =item EXAMPLES
13800
13801 =item INTERFACE
13802
13803 =back
13804
13805 C<Pod::Checker-E<gt>new( %options )>
13806
13807 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
13808 @args )>
13809
13810 C<$checker-E<gt>num_errors()>
13811
13812 C<$checker-E<gt>name()>
13813
13814 C<$checker-E<gt>node()>
13815
13816 C<$checker-E<gt>idx()>
13817
13818 C<$checker-E<gt>hyperlink()>
13819
13820 =over 4
13821
13822 =item AUTHOR
13823
13824 =back
13825
13826 =head2 Pod::Find - find POD documents in directory trees
13827
13828 =over 4
13829
13830 =item SYNOPSIS
13831
13832 =item DESCRIPTION
13833
13834 =back
13835
13836 =over 4
13837
13838 =item C<pod_find( { %opts } , @directories )>
13839
13840 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
13841 1>
13842
13843 =back
13844
13845 =over 4
13846
13847 =item C<simplify_name( $str )>
13848
13849 =back
13850
13851 =over 4
13852
13853 =item C<pod_where( { %opts }, $pod )>
13854
13855 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
13856 1>
13857
13858 =back
13859
13860 =over 4
13861
13862 =item C<contains_pod( $file , $verbose )>
13863
13864 =back
13865
13866 =over 4
13867
13868 =item AUTHOR
13869
13870 =item SEE ALSO
13871
13872 =back
13873
13874 =head2 Pod::Html - module to convert pod files to HTML
13875
13876 =over 4
13877
13878 =item SYNOPSIS
13879
13880 =item DESCRIPTION
13881
13882 =item ARGUMENTS
13883
13884 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
13885 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
13886 title, verbose
13887
13888 =item EXAMPLE
13889
13890 =item ENVIRONMENT
13891
13892 =item AUTHOR
13893
13894 =item SEE ALSO
13895
13896 =item COPYRIGHT
13897
13898 =back
13899
13900 =head2 Pod::InputObjects - objects representing POD input paragraphs,
13901 commands, etc.
13902
13903 =over 4
13904
13905 =item SYNOPSIS
13906
13907 =item REQUIRES
13908
13909 =item EXPORTS
13910
13911 =item DESCRIPTION
13912
13913 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
13914 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
13915
13916 =back
13917
13918 =over 4
13919
13920 =item B<Pod::InputSource>
13921
13922 =back
13923
13924 =over 4
13925
13926 =item B<new()>
13927
13928 =back
13929
13930 =over 4
13931
13932 =item B<name()>
13933
13934 =back
13935
13936 =over 4
13937
13938 =item B<handle()>
13939
13940 =back
13941
13942 =over 4
13943
13944 =item B<was_cutting()>
13945
13946 =back
13947
13948 =over 4
13949
13950 =item B<Pod::Paragraph>
13951
13952 =back
13953
13954 =over 4
13955
13956 =item Pod::Paragraph-E<gt>B<new()>
13957
13958 =back
13959
13960 =over 4
13961
13962 =item $pod_para-E<gt>B<cmd_name()>
13963
13964 =back
13965
13966 =over 4
13967
13968 =item $pod_para-E<gt>B<text()>
13969
13970 =back
13971
13972 =over 4
13973
13974 =item $pod_para-E<gt>B<raw_text()>
13975
13976 =back
13977
13978 =over 4
13979
13980 =item $pod_para-E<gt>B<cmd_prefix()>
13981
13982 =back
13983
13984 =over 4
13985
13986 =item $pod_para-E<gt>B<cmd_separator()>
13987
13988 =back
13989
13990 =over 4
13991
13992 =item $pod_para-E<gt>B<parse_tree()>
13993
13994 =back
13995
13996 =over 4
13997
13998 =item $pod_para-E<gt>B<file_line()>
13999
14000 =back
14001
14002 =over 4
14003
14004 =item B<Pod::InteriorSequence>
14005
14006 =back
14007
14008 =over 4
14009
14010 =item Pod::InteriorSequence-E<gt>B<new()>
14011
14012 =back
14013
14014 =over 4
14015
14016 =item $pod_seq-E<gt>B<cmd_name()>
14017
14018 =back
14019
14020 =over 4
14021
14022 =item $pod_seq-E<gt>B<prepend()>
14023
14024 =back
14025
14026 =over 4
14027
14028 =item $pod_seq-E<gt>B<append()>
14029
14030 =back
14031
14032 =over 4
14033
14034 =item $pod_seq-E<gt>B<nested()>
14035
14036 =back
14037
14038 =over 4
14039
14040 =item $pod_seq-E<gt>B<raw_text()>
14041
14042 =back
14043
14044 =over 4
14045
14046 =item $pod_seq-E<gt>B<left_delimiter()>
14047
14048 =back
14049
14050 =over 4
14051
14052 =item $pod_seq-E<gt>B<right_delimiter()>
14053
14054 =back
14055
14056 =over 4
14057
14058 =item $pod_seq-E<gt>B<parse_tree()>
14059
14060 =back
14061
14062 =over 4
14063
14064 =item $pod_seq-E<gt>B<file_line()>
14065
14066 =back
14067
14068 =over 4
14069
14070 =item Pod::InteriorSequence::B<DESTROY()>
14071
14072 =back
14073
14074 =over 4
14075
14076 =item B<Pod::ParseTree>
14077
14078 =back
14079
14080 =over 4
14081
14082 =item Pod::ParseTree-E<gt>B<new()>
14083
14084 =back
14085
14086 =over 4
14087
14088 =item $ptree-E<gt>B<top()>
14089
14090 =back
14091
14092 =over 4
14093
14094 =item $ptree-E<gt>B<children()>
14095
14096 =back
14097
14098 =over 4
14099
14100 =item $ptree-E<gt>B<prepend()>
14101
14102 =back
14103
14104 =over 4
14105
14106 =item $ptree-E<gt>B<append()>
14107
14108 =back
14109
14110 =over 4
14111
14112 =item $ptree-E<gt>B<raw_text()>
14113
14114 =back
14115
14116 =over 4
14117
14118 =item Pod::ParseTree::B<DESTROY()>
14119
14120 =back
14121
14122 =over 4
14123
14124 =item SEE ALSO
14125
14126 =item AUTHOR
14127
14128 =back
14129
14130 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
14131
14132 =over 4
14133
14134 =item SYNOPSIS
14135
14136 =item DESCRIPTION
14137
14138 =back
14139
14140 =over 4
14141
14142 =item OBJECT METHODS
14143
14144 C<initialize>
14145
14146 =back
14147
14148 =over 4
14149
14150 =item Data Accessors
14151
14152 B<AddPreamble>
14153
14154 =back
14155
14156 B<AddPostamble>
14157
14158 B<Head1Level>
14159
14160 B<Label>
14161
14162 B<LevelNoNum>
14163
14164 B<MakeIndex>
14165
14166 B<ReplaceNAMEwithSection>
14167
14168 B<StartWithNewPage>
14169
14170 B<TableOfContents>
14171
14172 B<UniqueLabels>
14173
14174 B<UserPreamble>
14175
14176 B<UserPostamble>
14177
14178 B<Lists>
14179
14180 =over 4
14181
14182 =item Subclassed methods
14183
14184 =back
14185
14186 B<begin_pod>
14187
14188 B<end_pod>
14189
14190 B<command>
14191
14192 B<verbatim>
14193
14194 B<textblock>
14195
14196 B<interior_sequence>
14197
14198 =over 4
14199
14200 =item List Methods
14201
14202 B<begin_list>
14203
14204 =back
14205
14206 B<end_list>
14207
14208 B<add_item>
14209
14210 =over 4
14211
14212 =item Methods for headings
14213
14214 B<head>
14215
14216 =back
14217
14218 =over 4
14219
14220 =item Internal methods
14221
14222 B<_output>
14223
14224 =back
14225
14226 B<_replace_special_chars>
14227
14228 B<_create_label>
14229
14230 B<_create_index>
14231
14232 B<_clean_latex_commands>
14233
14234 =over 4
14235
14236 =item NOTES
14237
14238 =item SEE ALSO
14239
14240 =item AUTHORS
14241
14242 =item COPYRIGHT
14243
14244 =item REVISION
14245
14246 =back
14247
14248 =head2 Pod::Man - Convert POD data to formatted *roff input
14249
14250 =over 4
14251
14252 =item SYNOPSIS
14253
14254 =item DESCRIPTION
14255
14256 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
14257 release, section
14258
14259 =item DIAGNOSTICS
14260
14261 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
14262 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
14263 escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
14264
14265 =item BUGS
14266
14267 =item SEE ALSO
14268
14269 =item AUTHOR
14270
14271 =item COPYRIGHT AND LICENSE
14272
14273 =back
14274
14275 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
14276
14277 =over 4
14278
14279 =item SYNOPSIS
14280
14281 =item DESCRIPTION
14282
14283 =back
14284
14285 =over 4
14286
14287 =item Pod::List
14288
14289 Pod::List-E<gt>new()
14290
14291 =back
14292
14293 $list-E<gt>file()
14294
14295 $list-E<gt>start()
14296
14297 $list-E<gt>indent()
14298
14299 $list-E<gt>type()
14300
14301 $list-E<gt>rx()
14302
14303 $list-E<gt>item()
14304
14305 $list-E<gt>parent()
14306
14307 $list-E<gt>tag()
14308
14309 =over 4
14310
14311 =item Pod::Hyperlink
14312
14313 Pod::Hyperlink-E<gt>new()
14314
14315 =back
14316
14317 $link-E<gt>parse($string)
14318
14319 $link-E<gt>markup($string)
14320
14321 $link-E<gt>text()
14322
14323 $link-E<gt>warning()
14324
14325 $link-E<gt>file(), $link-E<gt>line()
14326
14327 $link-E<gt>page()
14328
14329 $link-E<gt>node()
14330
14331 $link-E<gt>alttext()
14332
14333 $link-E<gt>type()
14334
14335 $link-E<gt>link()
14336
14337 =over 4
14338
14339 =item Pod::Cache
14340
14341 Pod::Cache-E<gt>new()
14342
14343 =back
14344
14345 $cache-E<gt>item()
14346
14347 $cache-E<gt>find_page($name)
14348
14349 =over 4
14350
14351 =item Pod::Cache::Item
14352
14353 Pod::Cache::Item-E<gt>new()
14354
14355 =back
14356
14357 $cacheitem-E<gt>page()
14358
14359 $cacheitem-E<gt>description()
14360
14361 $cacheitem-E<gt>path()
14362
14363 $cacheitem-E<gt>file()
14364
14365 $cacheitem-E<gt>nodes()
14366
14367 $cacheitem-E<gt>find_node($name)
14368
14369 $cacheitem-E<gt>idx()
14370
14371 =over 4
14372
14373 =item AUTHOR
14374
14375 =item SEE ALSO
14376
14377 =back
14378
14379 =head2 Pod::Parser - base class for creating POD filters and translators
14380
14381 =over 4
14382
14383 =item SYNOPSIS
14384
14385 =item REQUIRES
14386
14387 =item EXPORTS
14388
14389 =item DESCRIPTION
14390
14391 =item QUICK OVERVIEW
14392
14393 =item PARSING OPTIONS
14394
14395 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
14396 B<-warnings> (default: unset)
14397
14398 =back
14399
14400 =over 4
14401
14402 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
14403
14404 =back
14405
14406 =over 4
14407
14408 =item B<command()>
14409
14410 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
14411
14412 =back
14413
14414 =over 4
14415
14416 =item B<verbatim()>
14417
14418 C<$text>, C<$line_num>, C<$pod_para>
14419
14420 =back
14421
14422 =over 4
14423
14424 =item B<textblock()>
14425
14426 C<$text>, C<$line_num>, C<$pod_para>
14427
14428 =back
14429
14430 =over 4
14431
14432 =item B<interior_sequence()>
14433
14434 =back
14435
14436 =over 4
14437
14438 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
14439
14440 =back
14441
14442 =over 4
14443
14444 =item B<new()>
14445
14446 =back
14447
14448 =over 4
14449
14450 =item B<initialize()>
14451
14452 =back
14453
14454 =over 4
14455
14456 =item B<begin_pod()>
14457
14458 =back
14459
14460 =over 4
14461
14462 =item B<begin_input()>
14463
14464 =back
14465
14466 =over 4
14467
14468 =item B<end_input()>
14469
14470 =back
14471
14472 =over 4
14473
14474 =item B<end_pod()>
14475
14476 =back
14477
14478 =over 4
14479
14480 =item B<preprocess_line()>
14481
14482 =back
14483
14484 =over 4
14485
14486 =item B<preprocess_paragraph()>
14487
14488 =back
14489
14490 =over 4
14491
14492 =item METHODS FOR PARSING AND PROCESSING
14493
14494 =back
14495
14496 =over 4
14497
14498 =item B<parse_text()>
14499
14500 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
14501 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
14502 I<code-ref>|I<method-name>
14503
14504 =back
14505
14506 =over 4
14507
14508 =item B<interpolate()>
14509
14510 =back
14511
14512 =over 4
14513
14514 =item B<parse_paragraph()>
14515
14516 =back
14517
14518 =over 4
14519
14520 =item B<parse_from_filehandle()>
14521
14522 =back
14523
14524 =over 4
14525
14526 =item B<parse_from_file()>
14527
14528 =back
14529
14530 =over 4
14531
14532 =item ACCESSOR METHODS
14533
14534 =back
14535
14536 =over 4
14537
14538 =item B<errorsub()>
14539
14540 =back
14541
14542 =over 4
14543
14544 =item B<cutting()>
14545
14546 =back
14547
14548 =over 4
14549
14550 =item B<parseopts()>
14551
14552 =back
14553
14554 =over 4
14555
14556 =item B<output_file()>
14557
14558 =back
14559
14560 =over 4
14561
14562 =item B<output_handle()>
14563
14564 =back
14565
14566 =over 4
14567
14568 =item B<input_file()>
14569
14570 =back
14571
14572 =over 4
14573
14574 =item B<input_handle()>
14575
14576 =back
14577
14578 =over 4
14579
14580 =item B<input_streams()>
14581
14582 =back
14583
14584 =over 4
14585
14586 =item B<top_stream()>
14587
14588 =back
14589
14590 =over 4
14591
14592 =item PRIVATE METHODS AND DATA
14593
14594 =back
14595
14596 =over 4
14597
14598 =item B<_push_input_stream()>
14599
14600 =back
14601
14602 =over 4
14603
14604 =item B<_pop_input_stream()>
14605
14606 =back
14607
14608 =over 4
14609
14610 =item TREE-BASED PARSING
14611
14612 =item SEE ALSO
14613
14614 =item AUTHOR
14615
14616 =back
14617
14618 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
14619
14620 =over 4
14621
14622 =item SYNOPSIS
14623
14624 =item DESCRIPTION
14625
14626 =over 4
14627
14628 =item EXPORT
14629
14630 =back
14631
14632 =item AUTHOR
14633
14634 =item SEE ALSO
14635
14636 =back
14637
14638 =head2 Pod::Select, podselect() - extract selected sections of POD from
14639 input
14640
14641 =over 4
14642
14643 =item SYNOPSIS
14644
14645 =item REQUIRES
14646
14647 =item EXPORTS
14648
14649 =item DESCRIPTION
14650
14651 =item SECTION SPECIFICATIONS
14652
14653 =item RANGE SPECIFICATIONS
14654
14655 =back
14656
14657 =over 4
14658
14659 =item OBJECT METHODS
14660
14661 =back
14662
14663 =over 4
14664
14665 =item B<curr_headings()>
14666
14667 =back
14668
14669 =over 4
14670
14671 =item B<select()>
14672
14673 =back
14674
14675 =over 4
14676
14677 =item B<add_selection()>
14678
14679 =back
14680
14681 =over 4
14682
14683 =item B<clear_selections()>
14684
14685 =back
14686
14687 =over 4
14688
14689 =item B<match_section()>
14690
14691 =back
14692
14693 =over 4
14694
14695 =item B<is_selected()>
14696
14697 =back
14698
14699 =over 4
14700
14701 =item EXPORTED FUNCTIONS
14702
14703 =back
14704
14705 =over 4
14706
14707 =item B<podselect()>
14708
14709 B<-output>, B<-sections>, B<-ranges>
14710
14711 =back
14712
14713 =over 4
14714
14715 =item PRIVATE METHODS AND DATA
14716
14717 =back
14718
14719 =over 4
14720
14721 =item B<_compile_section_spec()>
14722
14723 =back
14724
14725 =over 4
14726
14727 =item $self->{_SECTION_HEADINGS}
14728
14729 =back
14730
14731 =over 4
14732
14733 =item $self->{_SELECTED_SECTIONS}
14734
14735 =back
14736
14737 =over 4
14738
14739 =item SEE ALSO
14740
14741 =item AUTHOR
14742
14743 =back
14744
14745 =head2 Pod::Text - Convert POD data to formatted ASCII text
14746
14747 =over 4
14748
14749 =item SYNOPSIS
14750
14751 =item DESCRIPTION
14752
14753 alt, indent, loose, quotes, sentence, width
14754
14755 =item DIAGNOSTICS
14756
14757 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
14758 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
14759 %s, Unknown sequence: %s, Unmatched =back
14760
14761 =item RESTRICTIONS
14762
14763 =item NOTES
14764
14765 =item SEE ALSO
14766
14767 =item AUTHOR
14768
14769 =item COPYRIGHT AND LICENSE
14770
14771 =back
14772
14773 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
14774
14775 =over 4
14776
14777 =item SYNOPSIS
14778
14779 =item DESCRIPTION
14780
14781 =item BUGS
14782
14783 =item SEE ALSO
14784
14785 =item AUTHOR
14786
14787 =item COPYRIGHT AND LICENSE
14788
14789 =back
14790
14791 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
14792 text
14793
14794 =over 4
14795
14796 =item SYNOPSIS
14797
14798 =item DESCRIPTION
14799
14800 =item BUGS
14801
14802 =item SEE ALSO
14803
14804 =item AUTHOR
14805
14806 =item COPYRIGHT AND LICENSE
14807
14808 =back
14809
14810 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
14811 text with format escapes
14812
14813 =over 4
14814
14815 =item SYNOPSIS
14816
14817 =item DESCRIPTION
14818
14819 =item SEE ALSO
14820
14821 =item AUTHOR
14822
14823 =item COPYRIGHT AND LICENSE
14824
14825 =back
14826
14827 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
14828 documentation
14829
14830 =over 4
14831
14832 =item SYNOPSIS
14833
14834 =item ARGUMENTS
14835
14836 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
14837 C<-pathlist>
14838
14839 =item DESCRIPTION
14840
14841 =item EXAMPLES
14842
14843 =over 4
14844
14845 =item Recommended Use
14846
14847 =back
14848
14849 =item CAVEATS
14850
14851 =item AUTHOR
14852
14853 =item ACKNOWLEDGEMENTS
14854
14855 =back
14856
14857 =head2 SDBM_File - Tied access to sdbm files
14858
14859 =over 4
14860
14861 =item SYNOPSIS
14862
14863 =item DESCRIPTION
14864
14865 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
14866
14867 =item DIAGNOSTICS
14868
14869 =over 4
14870
14871 =item C<sdbm store returned -1, errno 22, key "..." at ...>
14872
14873 =back
14874
14875 =item BUGS AND WARNINGS
14876
14877 =back
14878
14879 =head2 Safe - Compile and execute code in restricted compartments
14880
14881 =over 4
14882
14883 =item SYNOPSIS
14884
14885 =item DESCRIPTION
14886
14887 a new namespace, an operator mask
14888
14889 =item WARNING
14890
14891 =over 4
14892
14893 =item RECENT CHANGES
14894
14895 =item Methods in class Safe
14896
14897 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
14898 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
14899 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
14900 root (NAMESPACE), mask (MASK)
14901
14902 =item Some Safety Issues
14903
14904 Memory, CPU, Snooping, Signals, State Changes
14905
14906 =item AUTHOR
14907
14908 =back
14909
14910 =back
14911
14912 =head2 Scalar::Util - A selection of general-utility scalar subroutines
14913
14914 =over 4
14915
14916 =item SYNOPSIS
14917
14918 =item DESCRIPTION
14919
14920 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
14921 EXPR, tainted EXPR, weaken REF
14922
14923 =item COPYRIGHT
14924
14925 =item BLATANT PLUG
14926
14927 =back
14928
14929 =head2 Search::Dict, look - search for key in dictionary file
14930
14931 =over 4
14932
14933 =item SYNOPSIS
14934
14935 =item DESCRIPTION
14936
14937 =back
14938
14939 =head2 SelectSaver - save and restore selected file handle
14940
14941 =over 4
14942
14943 =item SYNOPSIS
14944
14945 =item DESCRIPTION
14946
14947 =back
14948
14949 =head2 SelfLoader - load functions only on demand
14950
14951 =over 4
14952
14953 =item SYNOPSIS
14954
14955 =item DESCRIPTION
14956
14957 =over 4
14958
14959 =item The __DATA__ token
14960
14961 =item SelfLoader autoloading
14962
14963 =item Autoloading and package lexicals
14964
14965 =item SelfLoader and AutoLoader
14966
14967 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
14968
14969 =item Classes and inherited methods.
14970
14971 =back
14972
14973 =item Multiple packages and fully qualified subroutine names
14974
14975 =back
14976
14977 =head2 Shell - run shell commands transparently within perl
14978
14979 =over 4
14980
14981 =item SYNOPSIS
14982
14983 =item DESCRIPTION
14984
14985 =over 4
14986
14987 =item OBJECT ORIENTED SYNTAX
14988
14989 =back
14990
14991 =item AUTHOR
14992
14993 =back
14994
14995 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
14996 socket.h defines and structure manipulators
14997
14998 =over 4
14999
15000 =item SYNOPSIS
15001
15002 =item DESCRIPTION
15003
15004 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
15005 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
15006 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
15007 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
15008 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
15009
15010 =back
15011
15012 =head2 Storable - persistency for perl data structures
15013
15014 =over 4
15015
15016 =item SYNOPSIS
15017
15018 =item DESCRIPTION
15019
15020 =item MEMORY STORE
15021
15022 =item ADVISORY LOCKING
15023
15024 =item SPEED
15025
15026 =item CANONICAL REPRESENTATION
15027
15028 =item ERROR REPORTING
15029
15030 =item WIZARDS ONLY
15031
15032 =over 4
15033
15034 =item Hooks
15035
15036 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
15037 I<serialized>, ..
15038
15039 =item Predicates
15040
15041 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
15042 C<Storable::is_retrieving>
15043
15044 =item Recursion
15045
15046 =item Deep Cloning
15047
15048 =back
15049
15050 =item EXAMPLES
15051
15052 =item WARNING
15053
15054 =item BUGS
15055
15056 =item CREDITS
15057
15058 =item TRANSLATIONS
15059
15060 =item AUTHOR
15061
15062 =item SEE ALSO
15063
15064 =back
15065
15066 =head2 Switch - A switch statement for Perl
15067
15068 =over 4
15069
15070 =item VERSION
15071
15072 =item SYNOPSIS
15073
15074 =item BACKGROUND
15075
15076 =item DESCRIPTION
15077
15078 =over 4
15079
15080 =item Allowing fall-through
15081
15082 =item Automating fall-through
15083
15084 =item Alternative syntax
15085
15086 =item Higher-order Operations
15087
15088 =back
15089
15090 =item DEPENDENCIES
15091
15092 =item AUTHOR
15093
15094 =item BUGS
15095
15096 =item COPYRIGHT
15097
15098 =back
15099
15100 =head2 Symbol - manipulate Perl symbols and their names
15101
15102 =over 4
15103
15104 =item SYNOPSIS
15105
15106 =item DESCRIPTION
15107
15108 =back
15109
15110 =head2 Sys::Hostname - Try every conceivable way to get hostname
15111
15112 =over 4
15113
15114 =item SYNOPSIS
15115
15116 =item DESCRIPTION
15117
15118 =item AUTHOR
15119
15120 =back
15121
15122 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
15123 interface to the UNIX syslog(3) calls
15124
15125 =over 4
15126
15127 =item SYNOPSIS
15128
15129 =item DESCRIPTION
15130
15131 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15132 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15133 closelog
15134
15135 =item EXAMPLES
15136
15137 =item SEE ALSO
15138
15139 =item AUTHOR
15140
15141 =back
15142
15143 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
15144 Perl interface to the UNIX syslog(3) calls
15145
15146 =over 4
15147
15148 =item SYNOPSIS
15149
15150 =item DESCRIPTION
15151
15152 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15153 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15154 closelog
15155
15156 =item EXAMPLES
15157
15158 =item SEE ALSO
15159
15160 =item AUTHOR
15161
15162 =back
15163
15164 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
15165
15166 =over 4
15167
15168 =item SYNOPSIS
15169
15170 =item DESCRIPTION
15171
15172 =item DIAGNOSTICS
15173
15174 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
15175 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
15176 comma allowed after filehandle, No name for escape sequence %s
15177
15178 =item ENVIRONMENT
15179
15180 ANSI_COLORS_DISABLED
15181
15182 =item RESTRICTIONS
15183
15184 =item NOTES
15185
15186 =item SEE ALSO
15187
15188 =item AUTHORS
15189
15190 =item LICENSE
15191
15192 =back
15193
15194 =head2 Term::Cap - Perl termcap interface
15195
15196 =over 4
15197
15198 =item SYNOPSIS
15199
15200 =item DESCRIPTION
15201
15202 =item EXAMPLES
15203
15204 =back
15205
15206 =head2 Term::Complete - Perl word completion module
15207
15208 =over 4
15209
15210 =item SYNOPSIS
15211
15212 =item DESCRIPTION
15213
15214 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
15215
15216 =item DIAGNOSTICS
15217
15218 =item BUGS
15219
15220 =item AUTHOR
15221
15222 =back
15223
15224 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
15225 no real package is found, substitutes stubs instead of basic functions.
15226
15227 =over 4
15228
15229 =item SYNOPSIS
15230
15231 =item DESCRIPTION
15232
15233 =item Minimal set of supported functions
15234
15235 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
15236 C<MinLine>, C<findConsole>, Attribs, C<Features>
15237
15238 =item Additional supported functions
15239
15240 C<tkRunning>, C<ornaments>, C<newTTY>
15241
15242 =item EXPORTS
15243
15244 =item ENVIRONMENT
15245
15246 =item CAVEATS
15247
15248 =back
15249
15250 =head2 Test - provides a simple framework for writing test scripts
15251
15252 =over 4
15253
15254 =item SYNOPSIS
15255
15256 =item DESCRIPTION
15257
15258 =over 4
15259
15260 =item Functions
15261
15262 B<plan>
15263
15264 =back
15265
15266 =back
15267
15268 B<_to_value>
15269
15270 B<ok>
15271
15272 =over 4
15273
15274 =item TEST TYPES
15275
15276 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
15277
15278 =item ONFAIL
15279
15280 =item BUGS and CAVEATS
15281
15282 =item TODO
15283
15284 =item SEE ALSO
15285
15286 =item AUTHOR
15287
15288 =back
15289
15290 =head2 Test::Harness - run perl standard test scripts with statistics
15291
15292 =over 4
15293
15294 =item SYNOPSIS
15295
15296 =item DESCRIPTION
15297
15298 =over 4
15299
15300 =item The test script output
15301
15302 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
15303 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
15304 B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
15305
15306 =item Failure
15307
15308 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
15309 Failed>
15310
15311 =item Functions
15312
15313 B<runtests>
15314
15315 =back
15316
15317 =back
15318
15319 B<_all_ok>
15320
15321 B<_globdir>
15322
15323 B<_run_all_tests>
15324
15325 B<_mk_leader>
15326
15327 =over 4
15328
15329 =item EXPORT
15330
15331 =item DIAGNOSTICS
15332
15333 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
15334 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
15335 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
15336 %s>, C<FAILED--Further testing stopped%s>
15337
15338 =item ENVIRONMENT
15339
15340 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
15341 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
15342 C<HARNESS_ACTIVE>
15343
15344 =item EXAMPLE
15345
15346 =item SEE ALSO
15347
15348 =item AUTHORS
15349
15350 =item TODO
15351
15352 =item BUGS
15353
15354 =back
15355
15356 =head2 Test::More - yet another framework for writing test scripts
15357
15358 =over 4
15359
15360 =item SYNOPSIS
15361
15362 =item DESCRIPTION
15363
15364 =over 4
15365
15366 =item I love it when a plan comes together
15367
15368 =item Test names
15369
15370 =item I'm ok, you're not ok.
15371
15372 B<ok>
15373
15374 =back
15375
15376 =back
15377
15378 B<is>, B<isnt>
15379
15380 B<like>
15381
15382 B<can_ok>
15383
15384 B<isa_ok>
15385
15386 B<pass>, B<fail>
15387
15388 =over 4
15389
15390 =item Module tests
15391
15392 B<use_ok>
15393
15394 =back
15395
15396 B<require_ok>
15397
15398 =over 4
15399
15400 =item Conditional tests
15401
15402 B<SKIP: BLOCK>
15403
15404 =back
15405
15406 B<TODO: BLOCK>
15407
15408 =over 4
15409
15410 =item Comparision functions
15411
15412 B<eq_array>
15413
15414 =back
15415
15416 B<eq_hash>
15417
15418 B<eq_set>
15419
15420 =over 4
15421
15422 =item NOTES
15423
15424 =item BUGS and CAVEATS
15425
15426 Making your own ok(), The eq_* family have some caveats, Test::Harness
15427 upgrades
15428
15429 =item AUTHOR
15430
15431 =item HISTORY
15432
15433 =item SEE ALSO
15434
15435 =back
15436
15437 =head2 Test::Simple - Basic utilities for writing tests.
15438
15439 =over 4
15440
15441 =item SYNOPSIS
15442
15443 =item DESCRIPTION
15444
15445 B<ok>
15446
15447 =back
15448
15449 B<_sanity_check>
15450
15451 B<_whoa>
15452
15453 B<_my_exit>
15454
15455 =over 4
15456
15457 =item EXAMPLE
15458
15459 =item CAVEATS
15460
15461 =item NOTES
15462
15463 =item HISTORY
15464
15465 =item AUTHOR
15466
15467 =item SEE ALSO
15468
15469 L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
15470 L<Test::Harness>
15471
15472 =back
15473
15474 =head2 Test::Tutorial - A tutorial about writing really basic tests
15475
15476 =over 4
15477
15478 =item DESCRIPTION
15479
15480 =over 4
15481
15482 =item Nuts and bolts of testing.
15483
15484 =item Where to start?
15485
15486 =item Names
15487
15488 =item Test the manual
15489
15490 =item Sometimes the tests are wrong
15491
15492 =item Testing lots of values
15493
15494 =item Informative names
15495
15496 =item Skipping tests
15497
15498 =item Todo tests
15499
15500 =item Testing with taint mode.
15501
15502 =back
15503
15504 =item FOOTNOTES
15505
15506 =back
15507
15508 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
15509
15510 =over 4
15511
15512 =item SYNOPSIS
15513
15514 =item DESCRIPTION
15515
15516 =item EXAMPLE
15517
15518 =back
15519
15520 =head2 Text::Balanced - Extract delimited text sequences from strings.
15521
15522 =over 4
15523
15524 =item SYNOPSIS
15525
15526 =item DESCRIPTION
15527
15528 =over 4
15529
15530 =item General behaviour in list contexts
15531
15532 [0], [1], [2]
15533
15534 =item General behaviour in scalar and void contexts
15535
15536 =item A note about prefixes
15537
15538 =item C<extract_delimited>
15539
15540 =item C<extract_bracketed>
15541
15542 =item C<extract_tagged>
15543
15544 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
15545 [0], [1], [2], [3], [4], [5]
15546
15547 =item C<gen_extract_tagged>
15548
15549 =item C<extract_quotelike>
15550
15551 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
15552
15553 =item C<extract_quotelike> and "here documents"
15554
15555 [0], [1], [2], [3], [4], [5], [6], [7..10]
15556
15557 =item C<extract_codeblock>
15558
15559 =item C<extract_multiple>
15560
15561 =item C<gen_delimited_pat>
15562
15563 =back
15564
15565 =item DIAGNOSTICS
15566
15567  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
15568 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
15569 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
15570 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
15571 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
15572 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
15573 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
15574 after dereferencer>, C<Did not find expected opening bracket at %s>,
15575 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
15576 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
15577 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
15578 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
15579 tag>
15580
15581 =item AUTHOR
15582
15583 =item BUGS AND IRRITATIONS
15584
15585 =item COPYRIGHT
15586
15587 =back
15588
15589 =head2 Text::ParseWords - parse text into an array of tokens or array of
15590 arrays
15591
15592 =over 4
15593
15594 =item SYNOPSIS
15595
15596 =item DESCRIPTION
15597
15598 =item EXAMPLES
15599
15600 =item AUTHORS
15601
15602 =back
15603
15604 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
15605 by Knuth
15606
15607 =over 4
15608
15609 =item SYNOPSIS
15610
15611 =item DESCRIPTION
15612
15613 =item EXAMPLES
15614
15615 =item LIMITATIONS
15616
15617 =item AUTHOR
15618
15619 =back
15620
15621 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
15622 unexpand(1)
15623
15624 =over 4
15625
15626 =item SYNOPSIS
15627
15628 =item DESCRIPTION
15629
15630 =item BUGS
15631
15632 =item AUTHOR
15633
15634 =back
15635
15636 =head2 Text::Wrap - line wrapping to form simple paragraphs
15637
15638 =over 4
15639
15640 =item SYNOPSIS
15641
15642 =item DESCRIPTION
15643
15644 =item EXAMPLE
15645
15646 =item AUTHOR
15647
15648 =back
15649
15650 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
15651 change)
15652
15653 =over 4
15654
15655 =item CAVEAT
15656
15657 =item SYNOPSIS
15658
15659 =item DESCRIPTION
15660
15661 =item FUNCTIONS
15662
15663 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
15664 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
15665 cond_broadcast VARIABLE, yield
15666
15667 =item METHODS
15668
15669 join, eval, detach, equal, tid, flags, done
15670
15671 =item LIMITATIONS
15672
15673 =item SEE ALSO
15674
15675 =back
15676
15677 =head2 Thread::Queue - thread-safe queues
15678
15679 =over 4
15680
15681 =item SYNOPSIS
15682
15683 =item DESCRIPTION
15684
15685 =item FUNCTIONS AND METHODS
15686
15687 new, enqueue LIST, dequeue, dequeue_nb, pending
15688
15689 =item SEE ALSO
15690
15691 =back
15692
15693 =head2 Thread::Semaphore - thread-safe semaphores
15694
15695 =over 4
15696
15697 =item SYNOPSIS
15698
15699 =item DESCRIPTION
15700
15701 =item FUNCTIONS AND METHODS
15702
15703 new, new NUMBER, down, down NUMBER, up, up NUMBER
15704
15705 =back
15706
15707 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
15708
15709 =over 4
15710
15711 =item SYNOPSIS
15712
15713 =item DESCRIPTION
15714
15715 =item BUGS
15716
15717 =back
15718
15719 =head2 Thread::Specific - thread-specific keys
15720
15721 =over 4
15722
15723 =item SYNOPSIS
15724
15725 =item DESCRIPTION
15726
15727 =back
15728
15729 =head2 Tie::Array - base class for tied arrays
15730
15731 =over 4
15732
15733 =item SYNOPSIS
15734
15735 =item DESCRIPTION
15736
15737 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
15738 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
15739 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
15740 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
15741
15742 =item CAVEATS
15743
15744 =item AUTHOR
15745
15746 =back
15747
15748 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
15749 handles
15750
15751 =over 4
15752
15753 =item SYNOPSIS
15754
15755 =item DESCRIPTION
15756
15757 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
15758 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
15759 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
15760 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
15761
15762 =item MORE INFORMATION
15763
15764 =item COMPATIBILITY
15765
15766 =back
15767
15768 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
15769
15770 =over 4
15771
15772 =item SYNOPSIS
15773
15774 =item DESCRIPTION
15775
15776 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
15777 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
15778
15779 =item CAVEATS
15780
15781 =item MORE INFORMATION
15782
15783 =back
15784
15785 =head2 Tie::RefHash - use references as hash keys
15786
15787 =over 4
15788
15789 =item SYNOPSIS
15790
15791 =item DESCRIPTION
15792
15793 =item EXAMPLE
15794
15795 =item AUTHOR
15796
15797 =item VERSION
15798
15799 =item SEE ALSO
15800
15801 =back
15802
15803 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
15804 scalars
15805
15806 =over 4
15807
15808 =item SYNOPSIS
15809
15810 =item DESCRIPTION
15811
15812 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
15813
15814 =item MORE INFORMATION
15815
15816 =back
15817
15818 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
15819
15820 =over 4
15821
15822 =item SYNOPSIS
15823
15824 =item DESCRIPTION
15825
15826 =item CAVEATS
15827
15828 =back
15829
15830 =head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
15831
15832 =over 4
15833
15834 =item SYNOPSIS
15835
15836 =item DESCRIPTION
15837
15838 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
15839 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
15840 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
15841 getitimer ( $which )
15842
15843 =item EXAMPLES
15844
15845 =item C API
15846
15847 =item CAVEATS
15848
15849 =item AUTHORS
15850
15851 =item REVISION
15852
15853 =item COPYRIGHT
15854
15855 =back
15856
15857 =head2 Time::Local - efficiently compute time from local and GMT time
15858
15859 =over 4
15860
15861 =item SYNOPSIS
15862
15863 =item DESCRIPTION
15864
15865 =item IMPLEMENTATION
15866
15867 =item BUGS
15868
15869 =back
15870
15871 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
15872 function
15873
15874 =over 4
15875
15876 =item SYNOPSIS
15877
15878 =item DESCRIPTION
15879
15880 =item NOTE
15881
15882 =item AUTHOR
15883
15884 =back
15885
15886 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
15887 function
15888
15889 =over 4
15890
15891 =item SYNOPSIS
15892
15893 =item DESCRIPTION
15894
15895 =item NOTE
15896
15897 =item AUTHOR
15898
15899 =back
15900
15901 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
15902
15903 =over 4
15904
15905 =item SYNOPSIS
15906
15907 =item DESCRIPTION
15908
15909 =item AUTHOR
15910
15911 =back
15912
15913 =head2 UNIVERSAL - base class for ALL classes (blessed references)
15914
15915 =over 4
15916
15917 =item SYNOPSIS
15918
15919 =item DESCRIPTION
15920
15921 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
15922 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
15923
15924 =back
15925
15926 =head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
15927
15928 =over 4
15929
15930 =item SYNOPSIS
15931
15932 =item DESCRIPTION
15933
15934 =over 4
15935
15936 =item Constructor and Tailoring
15937
15938 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
15939 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
15940 undefChar, katakana_before_hiragana, upper_before_lower
15941
15942 =item Other methods
15943
15944 C<@sorted = $UCA-E<gt>sort(@not_sorted)>, C<$result = $UCA-E<gt>cmp($a,
15945 $b)>, C<$sortKey = $UCA-E<gt>getSortKey($string)>, C<$position =
15946 $UCA-E<gt>index($string, $substring)>, C<($position, $length) =
15947 $UCA-E<gt>index($string, $substring)>
15948
15949 =item EXPORT
15950
15951 =item CAVEAT
15952
15953 =back
15954
15955 =item AUTHOR
15956
15957 =item SEE ALSO
15958
15959 L<Lingua::KO::Hangul::Util>, L<Unicode::Normalize>, Unicode Collation
15960 Algorithm - Unicode TR #10
15961
15962 =back
15963
15964 =head2 Unicode::Normalize - normalized forms of Unicode text
15965
15966 =over 4
15967
15968 =item SYNOPSIS
15969
15970 =item DESCRIPTION
15971
15972 C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
15973 C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
15974 C<$normalized_string = normalize($form_name, $raw_string)>
15975
15976 =over 4
15977
15978 =item EXPORT
15979
15980 =back
15981
15982 =item AUTHOR
15983
15984 =item SEE ALSO
15985
15986 L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
15987
15988 =back
15989
15990 =head2 Unicode::UCD - Unicode character database
15991
15992 =over 4
15993
15994 =item SYNOPSIS
15995
15996 =item DESCRIPTION
15997
15998 =back
15999
16000 =over 4
16001
16002 =item charinfo
16003
16004 =back
16005
16006 =over 4
16007
16008 =item charblock
16009
16010 =back
16011
16012 =over 4
16013
16014 =item charscript
16015
16016 =back
16017
16018 =over 4
16019
16020 =item charblocks
16021
16022 =back
16023
16024 =over 4
16025
16026 =item charscripts
16027
16028 =back
16029
16030 =over 4
16031
16032 =item Blocks versus Scripts
16033
16034 =item Matching Scripts and Blocks
16035
16036 =item Code Point Arguments
16037
16038 =item charinrange
16039
16040 =back
16041
16042 =over 4
16043
16044 =item compexcl
16045
16046 =back
16047
16048 =over 4
16049
16050 =item casefold
16051
16052 =back
16053
16054 =over 4
16055
16056 =item casespec
16057
16058 =back
16059
16060 =over 4
16061
16062 =item Unicode::UCD::UnicodeVersion
16063
16064 =back
16065
16066 =over 4
16067
16068 =item Implementation Note
16069
16070 =back
16071
16072 =over 4
16073
16074 =item AUTHOR
16075
16076 =back
16077
16078 =head2 User::grent - by-name interface to Perl's built-in getgr*()
16079 functions
16080
16081 =over 4
16082
16083 =item SYNOPSIS
16084
16085 =item DESCRIPTION
16086
16087 =item NOTE
16088
16089 =item AUTHOR
16090
16091 =back
16092
16093 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
16094 functions
16095
16096 =over 4
16097
16098 =item SYNOPSIS
16099
16100 =item DESCRIPTION
16101
16102 =over 4
16103
16104 =item System Specifics
16105
16106 =back
16107
16108 =item NOTE
16109
16110 =item AUTHOR
16111
16112 =item HISTORY
16113
16114 March 18th, 2000
16115
16116 =back
16117
16118 =head2 Win32 - Interfaces to some Win32 API Functions
16119
16120 =over 4
16121
16122 =item DESCRIPTION
16123
16124 =over 4
16125
16126 =item Alphabetical Listing of Win32 Functions
16127
16128 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
16129 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
16130 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
16131 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
16132 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
16133 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
16134 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
16135 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
16136 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
16137 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
16138 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
16139 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
16140 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
16141 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
16142 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
16143 PID), Win32::UnregisterServer(LIBRARYNAME)
16144
16145 =back
16146
16147 =back
16148
16149 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
16150
16151 =over 4
16152
16153 =item SYNOPSIS
16154
16155 =item DESCRIPTION
16156
16157 =back
16158
16159 =over 4
16160
16161 =item NOTES
16162
16163 =item AUTHOR
16164
16165 =back
16166
16167 =head2 XSLoader - Dynamically load C libraries into Perl code
16168
16169 =over 4
16170
16171 =item SYNOPSIS
16172
16173 =item DESCRIPTION
16174
16175 =item AUTHOR
16176
16177 =back
16178
16179 =head1 AUXILIARY DOCUMENTATION
16180
16181 Here should be listed all the extra programs' documentation, but they
16182 don't all have manual pages yet:
16183
16184 =over 4
16185
16186 =item a2p
16187
16188 =item s2p
16189
16190 =item find2perl
16191
16192 =item h2ph
16193
16194 =item c2ph
16195
16196 =item h2xs
16197
16198 =item xsubpp
16199
16200 =item pod2man
16201
16202 =item wrapsuid
16203
16204 =back
16205
16206 =head1 AUTHOR
16207
16208 Larry Wall <F<larry@wall.org>>, with the help of oodles
16209 of other folks.
16210