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