[Summary view] [Print] [Text view]

   1  
   2  # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
   3  # This file is autogenerated by buildtoc from all the other pods.
   4  # Edit those files and run buildtoc --build-toc to effect changes.
   5  
   6  =head1 NAME
   7  
   8  perltoc - perl documentation table of contents
   9  
  10  =head1 DESCRIPTION
  11  
  12  This page provides a brief table of contents for the rest of the Perl
  13  documentation set.  It is meant to be scanned quickly or grepped
  14  through to locate the proper section you're looking for.
  15  
  16  =head1 BASIC DOCUMENTATION
  17  
  18  =head2 perl - Practical Extraction and Report Language
  19  
  20  =over 4
  21  
  22  =item SYNOPSIS
  23  
  24  =over 4
  25  
  26  =item Overview
  27  
  28  =item Tutorials
  29  
  30  =item Reference Manual
  31  
  32  =item Internals and C Language Interface
  33  
  34  =item Miscellaneous
  35  
  36  =item Language-Specific
  37  
  38  =item Platform-Specific
  39  
  40  =back
  41  
  42  =item DESCRIPTION
  43  
  44  =item AVAILABILITY
  45  
  46  =item ENVIRONMENT
  47  
  48  =item AUTHOR
  49  
  50  =item FILES
  51  
  52  =item SEE ALSO
  53  
  54  =item DIAGNOSTICS
  55  
  56  =item BUGS
  57  
  58  =item NOTES
  59  
  60  =back
  61  
  62  =head2 perlintro -- a brief introduction and overview of Perl
  63  
  64  =over 4
  65  
  66  =item DESCRIPTION
  67  
  68  =over 4
  69  
  70  =item What is Perl?
  71  
  72  =item Running Perl programs
  73  
  74  =item Safety net
  75  
  76  =item Basic syntax overview
  77  
  78  =item Perl variable types
  79  
  80  Scalars, Arrays, Hashes
  81  
  82  =item Variable scoping
  83  
  84  =item Conditional and looping constructs
  85  
  86  if, while, for, foreach
  87  
  88  =item Builtin operators and functions
  89  
  90  Arithmetic, Numeric comparison, String comparison, Boolean logic,
  91  Miscellaneous
  92  
  93  =item Files and I/O
  94  
  95  =item Regular expressions
  96  
  97  Simple matching, Simple substitution, More complex regular expressions,
  98  Parentheses for capturing, Other regexp features
  99  
 100  =item Writing subroutines
 101  
 102  =item OO Perl
 103  
 104  =item Using Perl modules
 105  
 106  =back
 107  
 108  =item AUTHOR
 109  
 110  =back
 111  
 112  =head2 perlreftut - Mark's very short tutorial about references
 113  
 114  =over 4
 115  
 116  =item DESCRIPTION
 117  
 118  =item Who Needs Complicated Data Structures?
 119  
 120  =item The Solution
 121  
 122  =item Syntax
 123  
 124  =over 4
 125  
 126  =item Making References
 127  
 128  =item Using References
 129  
 130  =item An Example
 131  
 132  =item Arrow Rule
 133  
 134  =back
 135  
 136  =item Solution
 137  
 138  =item The Rest
 139  
 140  =item Summary
 141  
 142  =item Credits
 143  
 144  =over 4
 145  
 146  =item Distribution Conditions
 147  
 148  =back
 149  
 150  =back
 151  
 152  =head2 perldsc - Perl Data Structures Cookbook
 153  
 154  =over 4
 155  
 156  =item DESCRIPTION
 157  
 158  arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 159  more elaborate constructs
 160  
 161  =item REFERENCES
 162  X<reference> X<dereference> X<dereferencing> X<pointer>
 163  
 164  =item COMMON MISTAKES
 165  
 166  =item CAVEAT ON PRECEDENCE
 167  X<dereference, precedence> X<dereferencing, precedence>
 168  
 169  =item WHY YOU SHOULD ALWAYS C<use strict>
 170  
 171  =item DEBUGGING
 172  X<data structure, debugging> X<complex data structure, debugging>
 173  X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging>
 174  X<array of arrays, debugging> X<hash of arrays, debugging>
 175  X<array of hashes, debugging> X<hash of hashes, debugging>
 176  
 177  =item CODE EXAMPLES
 178  
 179  =item ARRAYS OF ARRAYS
 180  X<array of arrays> X<AoA>
 181  
 182  =over 4
 183  
 184  =item Declaration of an ARRAY OF ARRAYS
 185  
 186  =item Generation of an ARRAY OF ARRAYS
 187  
 188  =item Access and Printing of an ARRAY OF ARRAYS
 189  
 190  =back
 191  
 192  =item HASHES OF ARRAYS
 193  X<hash of arrays> X<HoA>
 194  
 195  =over 4
 196  
 197  =item Declaration of a HASH OF ARRAYS
 198  
 199  =item Generation of a HASH OF ARRAYS
 200  
 201  =item Access and Printing of a HASH OF ARRAYS
 202  
 203  =back
 204  
 205  =item ARRAYS OF HASHES
 206  X<array of hashes> X<AoH>
 207  
 208  =over 4
 209  
 210  =item Declaration of an ARRAY OF HASHES
 211  
 212  =item Generation of an ARRAY OF HASHES
 213  
 214  =item Access and Printing of an ARRAY OF HASHES
 215  
 216  =back
 217  
 218  =item HASHES OF HASHES
 219  X<hass of hashes> X<HoH>
 220  
 221  =over 4
 222  
 223  =item Declaration of a HASH OF HASHES
 224  
 225  =item Generation of a HASH OF HASHES
 226  
 227  =item Access and Printing of a HASH OF HASHES
 228  
 229  =back
 230  
 231  =item MORE ELABORATE RECORDS
 232  X<record> X<structure> X<struct>
 233  
 234  =over 4
 235  
 236  =item Declaration of MORE ELABORATE RECORDS
 237  
 238  =item Declaration of a HASH OF COMPLEX RECORDS
 239  
 240  =item Generation of a HASH OF COMPLEX RECORDS
 241  
 242  =back
 243  
 244  =item Database Ties
 245  
 246  =item SEE ALSO
 247  
 248  =item AUTHOR
 249  
 250  =back
 251  
 252  =head2 perllol - Manipulating Arrays of Arrays in Perl
 253  
 254  =over 4
 255  
 256  =item DESCRIPTION
 257  
 258  =over 4
 259  
 260  =item Declaration and Access of Arrays of Arrays
 261  
 262  =item Growing Your Own
 263  
 264  =item Access and Printing
 265  
 266  =item Slices
 267  
 268  =back
 269  
 270  =item SEE ALSO
 271  
 272  =item AUTHOR
 273  
 274  =back
 275  
 276  =head2 perlrequick - Perl regular expressions quick start
 277  
 278  =over 4
 279  
 280  =item DESCRIPTION
 281  
 282  =item The Guide
 283  
 284  =over 4
 285  
 286  =item Simple word matching
 287  
 288  =item Using character classes
 289  
 290  =item Matching this or that
 291  
 292  =item Grouping things and hierarchical matching
 293  
 294  =item Extracting matches
 295  
 296  =item Matching repetitions
 297  
 298  =item More matching
 299  
 300  =item Search and replace
 301  
 302  =item The split operator
 303  
 304  =back
 305  
 306  =item BUGS
 307  
 308  =item SEE ALSO
 309  
 310  =item AUTHOR AND COPYRIGHT
 311  
 312  =over 4
 313  
 314  =item Acknowledgments
 315  
 316  =back
 317  
 318  =back
 319  
 320  =head2 perlretut - Perl regular expressions tutorial
 321  
 322  =over 4
 323  
 324  =item DESCRIPTION
 325  
 326  =item Part 1: The basics
 327  
 328  =over 4
 329  
 330  =item Simple word matching
 331  
 332  =item Using character classes
 333  
 334  =item Matching this or that
 335  
 336  =item Grouping things and hierarchical matching
 337  
 338  =item Extracting matches
 339  
 340  =item Backreferences
 341  
 342  =item Relative backreferences
 343  
 344  =item Named backreferences
 345  
 346  =item Alternative capture group numbering
 347  
 348  =item Position information
 349  
 350  =item Non-capturing groupings
 351  
 352  =item Matching repetitions
 353  
 354  =item Possessive quantifiers
 355  
 356  =item Building a regexp
 357  
 358  =item Using regular expressions in Perl
 359  
 360  =back
 361  
 362  =item Part 2: Power tools
 363  
 364  =over 4
 365  
 366  =item More on characters, strings, and character classes
 367  
 368  =item Compiling and saving regular expressions
 369  
 370  =item Composing regular expressions at runtime
 371  
 372  =item Embedding comments and modifiers in a regular expression
 373  
 374  =item Looking ahead and looking behind
 375  
 376  =item Using independent subexpressions to prevent backtracking
 377  
 378  =item Conditional expressions
 379  
 380  =item Defining named patterns
 381  
 382  =item Recursive patterns
 383  
 384  =item A bit of magic: executing Perl code in a regular expression
 385  
 386  =item Backtracking control verbs
 387  
 388  =item Pragmas and debugging
 389  
 390  =back
 391  
 392  =item BUGS
 393  
 394  =item SEE ALSO
 395  
 396  =item AUTHOR AND COPYRIGHT
 397  
 398  =over 4
 399  
 400  =item Acknowledgments
 401  
 402  =back
 403  
 404  =back
 405  
 406  =head2 perlboot - Beginner's Object-Oriented Tutorial
 407  
 408  =over 4
 409  
 410  =item DESCRIPTION
 411  
 412  =over 4
 413  
 414  =item If we could talk to the animals...
 415  
 416  =item Introducing the method invocation arrow
 417  
 418  =item Invoking a barnyard
 419  
 420  =item The extra parameter of method invocation
 421  
 422  =item Calling a second method to simplify things
 423  
 424  =item Inheriting the windpipes
 425  
 426  =item A few notes about @ISA
 427  
 428  =item Overriding the methods
 429  
 430  =item Starting the search from a different place
 431  
 432  =item The SUPER way of doing things
 433  
 434  =item Where we're at so far...
 435  
 436  =item A horse is a horse, of course of course -- or is it?
 437  
 438  =item Invoking an instance method
 439  
 440  =item Accessing the instance data
 441  
 442  =item How to build a horse
 443  
 444  =item Inheriting the constructor
 445  
 446  =item Making a method work with either classes or instances
 447  
 448  =item Adding parameters to a method
 449  
 450  =item More interesting instances
 451  
 452  =item A horse of a different color
 453  
 454  =item Summary
 455  
 456  =back
 457  
 458  =item SEE ALSO
 459  
 460  =item COPYRIGHT
 461  
 462  =back
 463  
 464  =head2 perltoot - Tom's object-oriented tutorial for perl
 465  
 466  =over 4
 467  
 468  =item DESCRIPTION
 469  
 470  =item Creating a Class
 471  
 472  =over 4
 473  
 474  =item Object Representation
 475  
 476  =item Class Interface
 477  
 478  =item Constructors and Instance Methods
 479  
 480  =item Planning for the Future: Better Constructors
 481  
 482  =item Destructors
 483  
 484  =item Other Object Methods
 485  
 486  =back
 487  
 488  =item Class Data
 489  
 490  =over 4
 491  
 492  =item Accessing Class Data
 493  
 494  =item Debugging Methods
 495  
 496  =item Class Destructors
 497  
 498  =item Documenting the Interface
 499  
 500  =back
 501  
 502  =item Aggregation
 503  
 504  =item Inheritance
 505  
 506  =over 4
 507  
 508  =item Overridden Methods
 509  
 510  =item Multiple Inheritance
 511  
 512  =item UNIVERSAL: The Root of All Objects
 513  
 514  =item Deeper UNIVERSAL details
 515  
 516  =back
 517  
 518  =item Alternate Object Representations
 519  
 520  =over 4
 521  
 522  =item Arrays as Objects
 523  
 524  =item Closures as Objects
 525  
 526  =back
 527  
 528  =item AUTOLOAD: Proxy Methods
 529  
 530  =over 4
 531  
 532  =item Autoloaded Data Methods
 533  
 534  =item Inherited Autoloaded Data Methods
 535  
 536  =back
 537  
 538  =item Metaclassical Tools
 539  
 540  =over 4
 541  
 542  =item Class::Struct
 543  
 544  =item Data Members as Variables
 545  
 546  =back
 547  
 548  =item NOTES
 549  
 550  =over 4
 551  
 552  =item Object Terminology
 553  
 554  =back
 555  
 556  =item SEE ALSO
 557  
 558  =item AUTHOR AND COPYRIGHT
 559  
 560  =item COPYRIGHT
 561  
 562  =over 4
 563  
 564  =item Acknowledgments
 565  
 566  =back
 567  
 568  =back
 569  
 570  =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
 571  
 572  =over 4
 573  
 574  =item DESCRIPTION
 575  
 576  =item Class Data in a Can
 577  
 578  =item Class Data as Package Variables
 579  
 580  =over 4
 581  
 582  =item Putting All Your Eggs in One Basket
 583  
 584  =item Inheritance Concerns
 585  
 586  =item The Eponymous Meta-Object
 587  
 588  =item Indirect References to Class Data
 589  
 590  =item Monadic Classes
 591  
 592  =item Translucent Attributes
 593  
 594  =back
 595  
 596  =item Class Data as Lexical Variables
 597  
 598  =over 4
 599  
 600  =item Privacy and Responsibility 
 601  
 602  =item File-Scoped Lexicals
 603  
 604  =item More Inheritance Concerns
 605  
 606  =item Locking the Door and Throwing Away the Key
 607  
 608  =item Translucency Revisited
 609  
 610  =back
 611  
 612  =item NOTES
 613  
 614  =item SEE ALSO
 615  
 616  =item AUTHOR AND COPYRIGHT
 617  
 618  =item ACKNOWLEDGEMENTS
 619  
 620  =item HISTORY
 621  
 622  =back
 623  
 624  =head2 perlbot - Bag'o Object Tricks (the BOT)
 625  
 626  =over 4
 627  
 628  =item DESCRIPTION
 629  
 630  =item OO SCALING TIPS
 631  
 632  =item INSTANCE VARIABLES
 633  
 634  =item SCALAR INSTANCE VARIABLES
 635  
 636  =item INSTANCE VARIABLE INHERITANCE
 637  
 638  =item OBJECT RELATIONSHIPS
 639  
 640  =item OVERRIDING SUPERCLASS METHODS
 641  
 642  =item USING RELATIONSHIP WITH SDBM
 643  
 644  =item THINKING OF CODE REUSE
 645  
 646  =item CLASS CONTEXT AND THE OBJECT
 647  
 648  =item INHERITING A CONSTRUCTOR
 649  
 650  =item DELEGATION
 651  
 652  =item SEE ALSO
 653  
 654  =back
 655  
 656  =head2 perlstyle - Perl style guide
 657  
 658  =over 4
 659  
 660  =item DESCRIPTION
 661  
 662  =back
 663  
 664  =head2 perlcheat - Perl 5 Cheat Sheet
 665  
 666  =over 4
 667  
 668  =item DESCRIPTION
 669  
 670  =over 4
 671  
 672  =item The sheet
 673  
 674  =back
 675  
 676  =item ACKNOWLEDGEMENTS
 677  
 678  =item AUTHOR
 679  
 680  =item SEE ALSO
 681  
 682  =back
 683  
 684  =head2 perltrap - Perl traps for the unwary
 685  
 686  =over 4
 687  
 688  =item DESCRIPTION
 689  
 690  =over 4
 691  
 692  =item Awk Traps
 693  
 694  =item C/C++ Traps
 695  
 696  =item Sed Traps
 697  
 698  =item Shell Traps
 699  
 700  =item Perl Traps
 701  
 702  =item Perl4 to Perl5 Traps
 703  
 704  Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 705  Traps, General data type traps, Context Traps - scalar, list contexts,
 706  Precedence Traps, General Regular Expression Traps using s///, etc,
 707  Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 708  
 709  =item Discontinuance, Deprecation, and BugFix traps
 710  
 711  Symbols starting with "_" no longer forced into main, Double-colon valid
 712  package separator in variable name, 2nd and 3rd args to C<splice()> are now
 713  in scalar context, Can't do C<goto> into a block that is optimized away,
 714  Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
 715  BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
 716  iterating over a list, C<split> with no args behavior changed, B<-e>
 717  behavior fixed, C<push> returns number of elements in resulting list, Some
 718  error messages differ, C<split()> honors subroutine args, Bugs removed
 719  
 720  =item Parsing Traps
 721  
 722  Space between . and = triggers syntax error, Better parsing in perl 5,
 723  Function parsing, String interpolation of C<$#array> differs, Perl guesses
 724  on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
 725  
 726  =item Numerical Traps
 727  
 728  Formatted output and significant digits, Auto-increment operator over
 729  signed int limit deleted, Assignment of return values from numeric equality
 730  tests doesn't work, Bitwise string ops
 731  
 732  =item General data type traps
 733  
 734  Negative array subscripts now count from the end of array, Setting
 735  C<$#array> lower now discards array elements, Hashes get defined before
 736  use, Glob assignment from localized variable to variable, Assigning
 737  C<undef> to glob, Changes in unary negation (of strings), Modifying of
 738  constants prohibited, C<defined $var> behavior changed, Variable Suicide
 739  
 740  =item Context Traps - scalar, list contexts
 741  
 742  Elements of argument lists for formats evaluated in list context,
 743  C<caller()> returns false value in scalar context if no caller present,
 744  Comma operator in scalar context gives scalar context to args, C<sprintf()>
 745  prototyped as C<($;@)>
 746  
 747  =item Precedence Traps
 748  
 749  LHS vs. RHS of any assignment operator, Semantic errors introduced due to
 750  precedence, Precedence of assignment operators same as the precedence of
 751  assignment, C<open> requires parentheses around filehandle, C<$:>
 752  precedence over C<$::> gone, Precedence of file test operators documented,
 753  C<keys>, C<each>, C<values> are regular named unary operators
 754  
 755  =item General Regular Expression Traps using s///, etc.
 756  
 757  C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
 758  the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
 759  to whole match, Substitution now returns null string if it fails,
 760  C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
 761  in regular expressions, C<m?x?> matches only once, Failed matches don't
 762  reset the match variables
 763  
 764  =item Subroutine, Signal, Sorting Traps
 765  
 766  Barewords that used to look like strings look like subroutine calls,
 767  Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
 768  won't let you specify a filehandle
 769  
 770  =item OS Traps
 771  
 772  SysV resets signal handler correctly, SysV C<seek()> appends correctly
 773  
 774  =item Interpolation Traps
 775  
 776  C<@> always interpolates an array in double-quotish strings, Double-quoted
 777  strings may no longer end with an unescaped $, Arbitrary expressions are
 778  evaluated inside braces within double quotes, C<$$x> now tries to
 779  dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
 780  protection, Bugs in earlier perl versions, Array and hash brackets during
 781  interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
 782  C<eval> will not find string terminator
 783  
 784  =item DBM Traps
 785  
 786  Perl5 must have been linked with same dbm/ndbm as the default for
 787  C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
 788  exit immediately
 789  
 790  =item Unclassified Traps
 791  
 792  C<require>/C<do> trap using returned value, C<split> on empty string with
 793  LIMIT specified
 794  
 795  =back
 796  
 797  =back
 798  
 799  =head2 perldebtut - Perl debugging tutorial
 800  
 801  =over 4
 802  
 803  =item DESCRIPTION
 804  
 805  =item use strict
 806  
 807  =item Looking at data and -w and v
 808  
 809  =item help
 810  
 811  =item Stepping through code
 812  
 813  =item Placeholder for a, w, t, T
 814  
 815  =item REGULAR EXPRESSIONS
 816  
 817  =item OUTPUT TIPS
 818  
 819  =item CGI
 820  
 821  =item GUIs
 822  
 823  =item SUMMARY
 824  
 825  =item SEE ALSO
 826  
 827  =item AUTHOR
 828  
 829  =item CONTRIBUTORS
 830  
 831  =back
 832  
 833  =head2 perlfaq - frequently asked questions about Perl
 834  
 835  =over 4
 836  
 837  =item DESCRIPTION
 838  
 839  =over 4
 840  
 841  =item Where to get the perlfaq
 842  
 843  =item How to contribute to the perlfaq
 844  
 845  =item What will happen if you mail your Perl programming problems to the
 846  authors?
 847  
 848  =back
 849  
 850  =item CREDITS
 851  
 852  =item AUTHOR AND COPYRIGHT
 853  
 854  =item Table of Contents
 855  
 856  perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
 857  - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
 858  - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
 859  Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
 860  Interaction, perlfaq9 - Networking
 861  
 862  =item The Questions
 863  
 864  =over 4
 865  
 866  =item L<perlfaq1>: General Questions About Perl
 867  
 868  =item L<perlfaq2>: Obtaining and Learning about Perl
 869  
 870  =item L<perlfaq3>: Programming Tools
 871  
 872  =item L<perlfaq4>: Data Manipulation
 873  
 874  =item L<perlfaq5>: Files and Formats
 875  
 876  =item L<perlfaq6>: Regular Expressions
 877  
 878  =item L<perlfaq7>: General Perl Language Issues
 879  
 880  =item L<perlfaq8>: System Interaction
 881  
 882  =item L<perlfaq9>: Networking
 883  
 884  =back
 885  
 886  =back
 887  
 888  =head2 perlfaq1 - General Questions About Perl
 889  
 890  =over 4
 891  
 892  =item DESCRIPTION
 893  
 894  =over 4
 895  
 896  =item What is Perl?
 897  
 898  =item Who supports Perl?  Who develops it?  Why is it free?
 899  
 900  =item Which version of Perl should I use?
 901  
 902  =item What are Perl 4, Perl 5, or Perl 6?
 903  
 904  =item What was Ponie?
 905  
 906  =item What is Perl 6?
 907  
 908  =item How stable is Perl?
 909  
 910  =item Is Perl difficult to learn?
 911  
 912  =item How does Perl compare with other languages like Java, Python, REXX,
 913  Scheme, or Tcl?
 914  
 915  =item Can I do [task] in Perl?
 916  
 917  =item When shouldn't I program in Perl?
 918  
 919  =item What's the difference between "perl" and "Perl"?
 920  
 921  =item Is it a Perl program or a Perl script?
 922  
 923  =item What is a JAPH?
 924  
 925  =item Where can I get a list of Larry Wall witticisms?
 926  
 927  =item How can I convince others to use Perl?
 928  
 929  http://perltraining.com.au/whyperl.html,
 930  http://www.perl.org/advocacy/whyperl.html
 931  
 932  =back
 933  
 934  =item REVISION
 935  
 936  =item AUTHOR AND COPYRIGHT
 937  
 938  =back
 939  
 940  =head2 perlfaq2 - Obtaining and Learning about Perl
 941  
 942  =over 4
 943  
 944  =item DESCRIPTION
 945  
 946  =over 4
 947  
 948  =item What machines support perl?  Where do I get it?
 949  
 950  =item How can I get a binary version of perl?
 951  
 952  =item I don't have a C compiler. How can I build my own Perl interpreter?
 953  
 954  =item I copied the perl binary from one machine to another, but scripts
 955  don't work.
 956  
 957  =item I grabbed the sources and tried to compile but gdbm/dynamic
 958  loading/malloc/linking/... failed.  How do I make it work?
 959  
 960  =item What modules and extensions are available for Perl?  What is CPAN? 
 961  What does CPAN/src/... mean?
 962  
 963  =item Is there an ISO or ANSI certified version of Perl?
 964  
 965  =item Where can I get information on Perl?
 966  
 967  =item What are the Perl newsgroups on Usenet?  Where do I post questions?
 968  
 969  =item Where should I post source code?
 970  
 971  =item Perl Books
 972  
 973  References, Tutorials, Task-Oriented, Special Topics
 974  
 975  =item Which magazines have Perl content?
 976  
 977  =item What mailing lists are there for Perl?
 978  
 979  =item Where are the archives for comp.lang.perl.misc?
 980  
 981  =item Where can I buy a commercial version of perl?
 982  
 983  =item Where do I send bug reports?
 984  
 985  =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
 986  
 987  =back
 988  
 989  =item REVISION
 990  
 991  =item AUTHOR AND COPYRIGHT
 992  
 993  =back
 994  
 995  =head2 perlfaq3 - Programming Tools
 996  
 997  =over 4
 998  
 999  =item DESCRIPTION
1000  
1001  =over 4
1002  
1003  =item How do I do (anything)?
1004  
1005  =item How can I use Perl interactively?
1006  
1007  =item Is there a Perl shell?
1008  
1009  =item How do I find which modules are installed on my system?
1010  
1011  =item How do I debug my Perl programs?
1012  
1013  =item How do I profile my Perl programs?
1014  
1015  =item How do I cross-reference my Perl programs?
1016  
1017  =item Is there a pretty-printer (formatter) for Perl?
1018  
1019  =item Is there a ctags for Perl?
1020  
1021  =item Is there an IDE or Windows Perl Editor?
1022  
1023  Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1024  visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1025  Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1026  Alpha, BBEdit and BBEdit Lite
1027  
1028  =item Where can I get Perl macros for vi?
1029  
1030  =item Where can I get perl-mode for emacs?
1031  
1032  =item How can I use curses with Perl?
1033  
1034  =item How can I write a GUI (X, Tk, Gtk, etc.) in Perl?
1035  X<GUI> X<Tk> X<Wx> X<WxWidgets> X<Gtk> X<Gtk2> X<CamelBones> X<Qt>
1036  
1037  Tk, Wx, Gtk and Gtk2, Win32::GUI, CamelBones, Qt, Athena
1038  
1039  =item How can I make my Perl program run faster?
1040  
1041  =item How can I make my Perl program take less memory?
1042  
1043  Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1044  stringification, Pass by reference, Tie large variables to disk
1045  
1046  =item Is it safe to return a reference to local or lexical data?
1047  
1048  =item How can I free an array or hash so my program shrinks?
1049  
1050  =item How can I make my CGI script more efficient?
1051  
1052  =item How can I hide the source for my Perl program?
1053  
1054  =item How can I compile my Perl program into byte code or C?
1055  
1056  =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1057  
1058  =item Can I write useful Perl programs on the command line?
1059  
1060  =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1061  
1062  =item Where can I learn about CGI or Web programming in Perl?
1063  
1064  =item Where can I learn about object-oriented Perl programming?
1065  
1066  =item Where can I learn about linking C with Perl?
1067  
1068  =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1069  program; what am I doing wrong?
1070  
1071  =item When I tried to run my script, I got this message. What does it mean?
1072  
1073  =item What's MakeMaker?
1074  
1075  =back
1076  
1077  =item REVISION
1078  
1079  =item AUTHOR AND COPYRIGHT
1080  
1081  =back
1082  
1083  =head2 perlfaq4 - Data Manipulation
1084  
1085  =over 4
1086  
1087  =item DESCRIPTION
1088  
1089  =item Data: Numbers
1090  
1091  =over 4
1092  
1093  =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1094  numbers I should be getting (eg, 19.95)?
1095  
1096  =item Why is int() broken?
1097  
1098  =item Why isn't my octal data interpreted correctly?
1099  
1100  =item Does Perl have a round() function?  What about ceil() and floor()? 
1101  Trig functions?
1102  
1103  =item How do I convert between numeric representations/bases/radixes?
1104  
1105  How do I convert hexadecimal into decimal, How do I convert from decimal to
1106  hexadecimal, How do I convert from octal to decimal, How do I convert from
1107  decimal to octal, How do I convert from binary to decimal, How do I convert
1108  from decimal to binary
1109  
1110  =item Why doesn't & work the way I want it to?
1111  
1112  =item How do I multiply matrices?
1113  
1114  =item How do I perform an operation on a series of integers?
1115  
1116  =item How can I output Roman numerals?
1117  
1118  =item Why aren't my random numbers random?
1119  
1120  =item How do I get a random number between X and Y?
1121  
1122  =back
1123  
1124  =item Data: Dates
1125  
1126  =over 4
1127  
1128  =item How do I find the day or week of the year?
1129  
1130  =item How do I find the current century or millennium?
1131  
1132  =item How can I compare two dates and find the difference?
1133  
1134  =item How can I take a string and turn it into epoch seconds?
1135  
1136  =item How can I find the Julian Day?
1137  
1138  =item How do I find yesterday's date?
1139  
1140  =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
1141  
1142  =back
1143  
1144  =item Data: Strings
1145  
1146  =over 4
1147  
1148  =item How do I validate input?
1149  
1150  =item How do I unescape a string?
1151  
1152  =item How do I remove consecutive pairs of characters?
1153  
1154  =item How do I expand function calls in a string?
1155  
1156  =item How do I find matching/nesting anything?
1157  
1158  =item How do I reverse a string?
1159  
1160  =item How do I expand tabs in a string?
1161  
1162  =item How do I reformat a paragraph?
1163  
1164  =item How can I access or change N characters of a string?
1165  
1166  =item How do I change the Nth occurrence of something?
1167  
1168  =item How can I count the number of occurrences of a substring within a
1169  string?
1170  
1171  =item How do I capitalize all the words on one line?
1172  
1173  =item How can I split a [character] delimited string except when inside
1174  [character]?
1175  
1176  =item How do I strip blank space from the beginning/end of a string?
1177  
1178  =item How do I pad a string with blanks or pad a number with zeroes?
1179  
1180  =item How do I extract selected columns from a string?
1181  
1182  =item How do I find the soundex value of a string?
1183  
1184  =item How can I expand variables in text strings?
1185  
1186  =item What's wrong with always quoting "$vars"?
1187  
1188  =item Why don't my E<lt>E<lt>HERE documents work?
1189  
1190  There must be no space after the E<lt>E<lt> part, There (probably) should
1191  be a semicolon at the end, You can't (easily) have any space in front of
1192  the tag
1193  
1194  =back
1195  
1196  =item Data: Arrays
1197  
1198  =over 4
1199  
1200  =item What is the difference between a list and an array?
1201  
1202  =item What is the difference between $array[1] and @array[1]?
1203  
1204  =item How can I remove duplicate elements from a list or array?
1205  
1206  =item How can I tell whether a certain element is contained in a list or
1207  array?
1208  
1209  =item How do I compute the difference of two arrays?  How do I compute the
1210  intersection of two arrays?
1211  
1212  =item How do I test whether two arrays or hashes are equal?
1213  
1214  =item How do I find the first array element for which a condition is true?
1215  
1216  =item How do I handle linked lists?
1217  
1218  =item How do I handle circular lists?
1219  
1220  =item How do I shuffle an array randomly?
1221  
1222  =item How do I process/modify each element of an array?
1223  
1224  =item How do I select a random element from an array?
1225  
1226  =item How do I permute N elements of a list?
1227  X<List::Permuter> X<permute> X<Algorithm::Loops> X<Knuth>
1228  X<The Art of Computer Programming> X<Fischer-Krause>
1229  
1230  =item How do I sort an array by (anything)?
1231  
1232  =item How do I manipulate arrays of bits?
1233  
1234  =item Why does defined() return true on empty arrays and hashes?
1235  
1236  =back
1237  
1238  =item Data: Hashes (Associative Arrays)
1239  
1240  =over 4
1241  
1242  =item How do I process an entire hash?
1243  
1244  =item What happens if I add or remove keys from a hash while iterating over
1245  it?
1246  
1247  =item How do I look up a hash element by value?
1248  
1249  =item How can I know how many entries are in a hash?
1250  
1251  =item How do I sort a hash (optionally by value instead of key)?
1252  
1253  =item How can I always keep my hash sorted?
1254  X<hash tie sort DB_File Tie::IxHash>
1255  
1256  =item What's the difference between "delete" and "undef" with hashes?
1257  
1258  =item Why don't my tied hashes make the defined/exists distinction?
1259  
1260  =item How do I reset an each() operation part-way through?
1261  
1262  =item How can I get the unique keys from two hashes?
1263  
1264  =item How can I store a multidimensional array in a DBM file?
1265  
1266  =item How can I make my hash remember the order I put elements into it?
1267  
1268  =item Why does passing a subroutine an undefined element in a hash create
1269  it?
1270  
1271  =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1272  array of hashes or arrays?
1273  
1274  =item How can I use a reference as a hash key?
1275  
1276  =back
1277  
1278  =item Data: Misc
1279  
1280  =over 4
1281  
1282  =item How do I handle binary data correctly?
1283  
1284  =item How do I determine whether a scalar is a number/whole/integer/float?
1285  
1286  =item How do I keep persistent data across program calls?
1287  
1288  =item How do I print out or copy a recursive data structure?
1289  
1290  =item How do I define methods for every class/object?
1291  
1292  =item How do I verify a credit card checksum?
1293  
1294  =item How do I pack arrays of doubles or floats for XS code?
1295  
1296  =back
1297  
1298  =item REVISION
1299  
1300  =item AUTHOR AND COPYRIGHT
1301  
1302  =back
1303  
1304  =head2 perlfaq5 - Files and Formats
1305  
1306  =over 4
1307  
1308  =item DESCRIPTION
1309  
1310  =over 4
1311  
1312  =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1313  X<flush> X<buffer> X<unbuffer> X<autoflush>
1314  
1315  =item How do I count the number of lines in a file?
1316  X<file, counting lines> X<lines> X<line>
1317  
1318  =item How can I use Perl's C<-i> option from within a program?
1319  X<-i> X<in-place>
1320  
1321  =item How can I copy a file?
1322  X<copy> X<file, copy>
1323  
1324  =item How do I make a temporary file name?
1325  X<file, temporary>
1326  
1327  =item How can I manipulate fixed-record-length files?
1328  X<fixed-length> X<file, fixed-length records>
1329  
1330  =item How can I make a filehandle local to a subroutine?  How do I pass
1331  filehandles between subroutines?  How do I make an array of filehandles?
1332  X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1333  
1334  =item How can I use a filehandle indirectly?
1335  X<filehandle, indirect>
1336  
1337  =item How can I set up a footer format to be used with write()?
1338  X<footer>
1339  
1340  =item How can I write() into a string?
1341  X<write, into a string>
1342  
1343  =item How can I open a filehandle to a string?
1344  X<string>, X<open>, X<IO::Scalar>, X<filehandle>
1345  
1346  =item How can I translate tildes (~) in a filename?
1347  X<tilde> X<tilde expansion>
1348  
1349  =item How come when I open a file read-write it wipes it out?
1350  X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1351  
1352  =item Why do I sometimes get an "Argument list too long" when I use
1353  E<lt>*E<gt>?
1354  X<argument list too long>
1355  
1356  =item Is there a leak/bug in glob()?
1357  X<glob>
1358  
1359  =item How can I open a file with a leading ">" or trailing blanks?
1360  X<filename, special characters>
1361  
1362  =item How can I reliably rename a file?
1363  X<rename> X<mv> X<move> X<file, rename> X<ren>
1364  
1365  =item How can I lock a file?
1366  X<lock> X<file, lock> X<flock>
1367  
1368  =item Why can't I just open(FH, "E<gt>file.lock")?
1369  X<lock, lockfile race condition>
1370  
1371  =item I still don't get locking.  I just want to increment the number in
1372  the file.  How can I do this?
1373  X<counter> X<file, counter>
1374  
1375  =item All I want to do is append a small amount of text to the end of a
1376  file.  Do I still have to use locking?
1377  X<append> X<file, append>
1378  
1379  =item How do I randomly update a binary file?
1380  X<file, binary patch>
1381  
1382  =item How do I get a file's timestamp in perl?
1383  X<timestamp> X<file, timestamp>
1384  
1385  =item How do I set a file's timestamp in perl?
1386  X<timestamp> X<file, timestamp>
1387  
1388  =item How do I print to more than one file at once?
1389  X<print, to multiple files>
1390  
1391  =item How can I read in an entire file all at once?
1392  X<slurp> X<file, slurping>
1393  
1394  =item How can I read in a file by paragraphs?
1395  X<file, reading by paragraphs>
1396  
1397  =item How can I read a single character from a file?  From the keyboard?
1398  X<getc> X<file, reading one character at a time>
1399  
1400  =item How can I tell whether there's a character waiting on a filehandle?
1401  
1402  =item How do I do a C<tail -f> in perl?
1403  X<tail> X<IO::Handle> X<File::Tail> X<clearerr>
1404  
1405  =item How do I dup() a filehandle in Perl?
1406  X<dup>
1407  
1408  =item How do I close a file descriptor by number?
1409  X<file, closing file descriptors> X<POSIX> X<close>
1410  
1411  =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1412  `C:\temp\foo.exe` work?
1413  X<filename, DOS issues>
1414  
1415  =item Why doesn't glob("*.*") get all the files?
1416  X<glob>
1417  
1418  =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1419  protected files?  Isn't this a bug in Perl?
1420  
1421  =item How do I select a random line from a file?
1422  X<file, selecting a random line>
1423  
1424  =item Why do I get weird spaces when I print an array of lines?
1425  
1426  =back
1427  
1428  =item REVISION
1429  
1430  =item AUTHOR AND COPYRIGHT
1431  
1432  =back
1433  
1434  =head2 perlfaq6 - Regular Expressions
1435  
1436  =over 4
1437  
1438  =item DESCRIPTION
1439  
1440  =over 4
1441  
1442  =item How can I hope to use regular expressions without creating illegible
1443  and unmaintainable code?
1444  X<regex, legibility> X<regexp, legibility>
1445  X<regular expression, legibility> X</x>
1446  
1447  Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1448  
1449  =item I'm having trouble matching over more than one line.  What's wrong?
1450  X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1451  
1452  =item How can I pull out lines between two patterns that are themselves on
1453  different lines?
1454  X<..>
1455  
1456  =item I put a regular expression into $/ but it didn't work. What's wrong?
1457  X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1458  X<$RS, regexes in>
1459  
1460  =item How do I substitute case insensitively on the LHS while preserving
1461  case on the RHS?
1462  X<replace, case preserving> X<substitute, case preserving>
1463  X<substitution, case preserving> X<s, case preserving>
1464  
1465  =item How can I make C<\w> match national character sets?
1466  X<\w>
1467  
1468  =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1469  X<alpha>
1470  
1471  =item How can I quote a variable to use in a regex?
1472  X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1473  
1474  =item What is C</o> really for?
1475  X</o, regular expressions> X<compile, regular expressions>
1476  
1477  =item How do I use a regular expression to strip C style comments from a
1478  file?
1479  
1480  =item Can I use Perl regular expressions to match balanced text?
1481  X<regex, matching balanced test> X<regexp, matching balanced test>
1482  X<regular expression, matching balanced test>
1483  
1484  =item What does it mean that regexes are greedy?  How can I get around it?
1485  X<greedy> X<greediness>
1486  
1487  =item How do I process each word on each line?
1488  X<word>
1489  
1490  =item How can I print out a word-frequency or line-frequency summary?
1491  
1492  =item How can I do approximate matching?
1493  X<match, approximate> X<matching, approximate>
1494  
1495  =item How do I efficiently match many regular expressions at once?
1496  X<regex, efficiency> X<regexp, efficiency>
1497  X<regular expression, efficiency>
1498  
1499  =item Why don't word-boundary searches with C<\b> work for me?
1500  X<\b>
1501  
1502  =item Why does using $&, $`, or $' slow my program down?
1503  X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1504  
1505  =item What good is C<\G> in a regular expression?
1506  X<\G>
1507  
1508  =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1509  X<DFA> X<NFA> X<POSIX>
1510  
1511  =item What's wrong with using grep in a void context?
1512  X<grep>
1513  
1514  =item How can I match strings with multibyte characters?
1515  X<regex, and multibyte characters> X<regexp, and multibyte characters>
1516  X<regular expression, and multibyte characters> X<martian> X<encoding,
1517  Martian>
1518  
1519  =item How do I match a regular expression that's in a variable?
1520  X<regex, in variable> X<eval> X<regex> X<quotemeta> X<\Q, regex>
1521  X<\E, regex>, X<qr//>
1522  
1523  =back
1524  
1525  =item REVISION
1526  
1527  =item AUTHOR AND COPYRIGHT
1528  
1529  =back
1530  
1531  =head2 perlfaq7 - General Perl Language Issues
1532  
1533  =over 4
1534  
1535  =item DESCRIPTION
1536  
1537  =over 4
1538  
1539  =item Can I get a BNF/yacc/RE for the Perl language?
1540  
1541  =item What are all these $@%&* punctuation signs, and how do I know when to
1542  use them?
1543  
1544  =item Do I always/never have to quote my strings or use semicolons and
1545  commas?
1546  
1547  =item How do I skip some return values?
1548  
1549  =item How do I temporarily block warnings?
1550  
1551  =item What's an extension?
1552  
1553  =item Why do Perl operators have different precedence than C operators?
1554  
1555  =item How do I declare/create a structure?
1556  
1557  =item How do I create a module?
1558  
1559  =item How do I adopt or take over a module already on CPAN?
1560  
1561  =item How do I create a class?
1562  
1563  =item How can I tell if a variable is tainted?
1564  
1565  =item What's a closure?
1566  
1567  =item What is variable suicide and how can I prevent it?
1568  
1569  =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1570  Regex}?
1571  
1572  Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1573  Passing Methods
1574  
1575  =item How do I create a static variable?
1576  
1577  =item What's the difference between dynamic and lexical (static) scoping? 
1578  Between local() and my()?
1579  
1580  =item How can I access a dynamic variable while a similarly named lexical
1581  is in scope?
1582  
1583  =item What's the difference between deep and shallow binding?
1584  
1585  =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1586  
1587  =item How do I redefine a builtin function, operator, or method?
1588  
1589  =item What's the difference between calling a function as &foo and foo()?
1590  
1591  =item How do I create a switch or case statement?
1592  
1593  =item How can I catch accesses to undefined variables, functions, or
1594  methods?
1595  
1596  =item Why can't a method included in this same file be found?
1597  
1598  =item How can I find out my current package?
1599  
1600  =item How can I comment out a large block of perl code?
1601  
1602  =item How do I clear a package?
1603  
1604  =item How can I use a variable as a variable name?
1605  
1606  =item What does "bad interpreter" mean?
1607  
1608  =back
1609  
1610  =item REVISION
1611  
1612  =item AUTHOR AND COPYRIGHT
1613  
1614  =back
1615  
1616  =head2 perlfaq8 - System Interaction
1617  
1618  =over 4
1619  
1620  =item DESCRIPTION
1621  
1622  =over 4
1623  
1624  =item How do I find out which operating system I'm running under?
1625  
1626  =item How come exec() doesn't return?
1627  
1628  =item How do I do fancy stuff with the keyboard/screen/mouse?
1629  
1630  Keyboard, Screen, Mouse
1631  
1632  =item How do I print something out in color?
1633  
1634  =item How do I read just one key without waiting for a return key?
1635  
1636  =item How do I check whether input is ready on the keyboard?
1637  
1638  =item How do I clear the screen?
1639  
1640  =item How do I get the screen size?
1641  
1642  =item How do I ask the user for a password?
1643  
1644  =item How do I read and write the serial port?
1645  
1646  lockfiles, open mode, end of line, flushing output, non-blocking input
1647  
1648  =item How do I decode encrypted password files?
1649  
1650  =item How do I start a process in the background?
1651  
1652  STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1653  
1654  =item How do I trap control characters/signals?
1655  
1656  =item How do I modify the shadow password file on a Unix system?
1657  
1658  =item How do I set the time and date?
1659  
1660  =item How can I sleep() or alarm() for under a second?
1661  X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
1662  
1663  =item How can I measure time under a second?
1664  X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
1665  
1666  =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1667  
1668  =item Why doesn't my sockets program work under System V (Solaris)?  What
1669  does the error message "Protocol not supported" mean?
1670  
1671  =item How can I call my system's unique C functions from Perl?
1672  
1673  =item Where do I get the include files to do ioctl() or syscall()?
1674  
1675  =item Why do setuid perl scripts complain about kernel problems?
1676  
1677  =item How can I open a pipe both to and from a command?
1678  
1679  =item Why can't I get the output of a command with system()?
1680  
1681  =item How can I capture STDERR from an external command?
1682  
1683  =item Why doesn't open() return an error when a pipe open fails?
1684  
1685  =item What's wrong with using backticks in a void context?
1686  
1687  =item How can I call backticks without shell processing?
1688  
1689  =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1690  ^Z on MS-DOS)?
1691  
1692  =item How can I convert my shell script to perl?
1693  
1694  =item Can I use perl to run a telnet or ftp session?
1695  
1696  =item How can I write expect in Perl?
1697  
1698  =item Is there a way to hide perl's command line from programs such as
1699  "ps"?
1700  
1701  =item I {changed directory, modified my environment} in a perl script.    How
1702  come the change disappeared when I exited the script?  How do I get my
1703  changes to be visible?
1704  
1705  Unix
1706  
1707  =item How do I close a process's filehandle without waiting for it to
1708  complete?
1709  
1710  =item How do I fork a daemon process?
1711  
1712  =item How do I find out if I'm running interactively or not?
1713  
1714  =item How do I timeout a slow event?
1715  
1716  =item How do I set CPU limits?
1717  X<BSD::Resource> X<limit> X<CPU>
1718  
1719  =item How do I avoid zombies on a Unix system?
1720  
1721  =item How do I use an SQL database?
1722  
1723  =item How do I make a system() exit on control-C?
1724  
1725  =item How do I open a file without blocking?
1726  
1727  =item How do I tell the difference between errors from the shell and perl?
1728  
1729  =item How do I install a module from CPAN?
1730  
1731  =item What's the difference between require and use?
1732  
1733  =item How do I keep my own module/library directory?
1734  
1735  =item How do I add the directory my program lives in to the module/library
1736  search path?
1737  
1738  =item How do I add a directory to my include path (@INC) at runtime?
1739  
1740  the PERLLIB environment variable, the PERL5LIB environment variable, the
1741  perl -Idir command line flag, the use lib pragma:
1742  
1743  =item What is socket.ph and where do I get it?
1744  
1745  =back
1746  
1747  =item REVISION
1748  
1749  =item AUTHOR AND COPYRIGHT
1750  
1751  =back
1752  
1753  =head2 perlfaq9 - Networking
1754  
1755  =over 4
1756  
1757  =item DESCRIPTION
1758  
1759  =over 4
1760  
1761  =item What is the correct form of response from a CGI script?
1762  
1763  =item My CGI script runs from the command line but not the browser.  (500
1764  Server Error)
1765  
1766  =item How can I get better error messages from a CGI program?
1767  
1768  =item How do I remove HTML from a string?
1769  
1770  =item How do I extract URLs?
1771  
1772  =item How do I download a file from the user's machine?  How do I open a
1773  file on another machine?
1774  
1775  =item How do I make an HTML pop-up menu with Perl?
1776  
1777  =item How do I fetch an HTML file?
1778  
1779  =item How do I automate an HTML form submission?
1780  
1781  =item How do I decode or create those %-encodings on the web?
1782  
1783  =item How do I redirect to another page?
1784  
1785  =item How do I put a password on my web pages?
1786  
1787  =item How do I edit my .htpasswd and .htgroup files with Perl?
1788  
1789  =item How do I make sure users can't enter values into a form that cause my
1790  CGI script to do bad things?
1791  
1792  =item How do I parse a mail header?
1793  
1794  =item How do I decode a CGI form?
1795  
1796  =item How do I check a valid mail address?
1797  
1798  =item How do I decode a MIME/BASE64 string?
1799  
1800  =item How do I return the user's mail address?
1801  
1802  =item How do I send mail?
1803  
1804  =item How do I use MIME to make an attachment to a mail message?
1805  
1806  =item How do I read mail?
1807  
1808  =item How do I find out my hostname, domainname, or IP address?
1809  X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1810  gethostbyname, Socket, Net::Domain, Sys::Hostname>
1811  
1812  =item How do I fetch a news article or the active newsgroups?
1813  
1814  =item How do I fetch/put an FTP file?
1815  
1816  =item How can I do RPC in Perl?
1817  
1818  =back
1819  
1820  =item REVISION
1821  
1822  =item AUTHOR AND COPYRIGHT
1823  
1824  =back
1825  
1826  =head2 perlsyn - Perl syntax
1827  
1828  =over 4
1829  
1830  =item DESCRIPTION
1831  
1832  =over 4
1833  
1834  =item Declarations
1835  X<declaration> X<undef> X<undefined> X<uninitialized>
1836  
1837  =item Comments
1838  X<comment> X<#>
1839  
1840  =item Simple Statements
1841  X<statement> X<semicolon> X<expression> X<;>
1842  
1843  =item Truth and Falsehood
1844  X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
1845  
1846  =item Statement Modifiers
1847  X<statement modifier> X<modifier> X<if> X<unless> X<while>
1848  X<until> X<foreach> X<for>
1849  
1850  =item Compound Statements
1851  X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
1852  X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue>
1853  
1854  =item Loop Control
1855  X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1856  
1857  =item For Loops
1858  X<for> X<foreach>
1859  
1860  =item Foreach Loops
1861  X<for> X<foreach>
1862  
1863  =item Basic BLOCKs
1864  X<block>
1865  
1866  =item Switch statements
1867  X<switch> X<case> X<given> X<when> X<default>
1868  
1869  o, o, o, o, o, o, o
1870  
1871  =item Goto
1872  X<goto>
1873  
1874  =item PODs: Embedded Documentation
1875  X<POD> X<documentation>
1876  
1877  =item Plain Old Comments (Not!)
1878  X<comment> X<line> X<#> X<preprocessor> X<eval>
1879  
1880  =back
1881  
1882  =back
1883  
1884  =head2 perldata - Perl data types
1885  
1886  =over 4
1887  
1888  =item DESCRIPTION
1889  
1890  =over 4
1891  
1892  =item Variable names
1893  X<variable, name> X<variable name> X<data type> X<type>
1894  
1895  =item Context
1896  X<context> X<scalar context> X<list context>
1897  
1898  =item Scalar values
1899  X<scalar> X<number> X<string> X<reference>
1900  
1901  =item Scalar value constructors
1902  X<scalar, literal> X<scalar, constant>
1903  
1904  =item List value constructors
1905  X<list>
1906  
1907  =item Subscripts
1908  
1909  =item Slices
1910  X<slice> X<array, slice> X<hash, slice>
1911  
1912  =item Typeglobs and Filehandles
1913  X<typeglob> X<filehandle> X<*>
1914  
1915  =back
1916  
1917  =item SEE ALSO
1918  
1919  =back
1920  
1921  =head2 perlop - Perl operators and precedence
1922  
1923  =over 4
1924  
1925  =item DESCRIPTION
1926  
1927  =over 4
1928  
1929  =item Operator Precedence and Associativity
1930  X<operator, precedence> X<precedence> X<associativity>
1931  
1932  =item Terms and List Operators (Leftward)
1933  X<list operator> X<operator, list> X<term>
1934  
1935  =item The Arrow Operator
1936  X<arrow> X<dereference> X<< -> >>
1937  
1938  =item Auto-increment and Auto-decrement
1939  X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
1940  
1941  =item Exponentiation
1942  X<**> X<exponentiation> X<power>
1943  
1944  =item Symbolic Unary Operators
1945  X<unary operator> X<operator, unary>
1946  
1947  =item Binding Operators
1948  X<binding> X<operator, binding> X<=~> X<!~>
1949  
1950  =item Multiplicative Operators
1951  X<operator, multiplicative>
1952  
1953  =item Additive Operators
1954  X<operator, additive>
1955  
1956  =item Shift Operators
1957  X<shift operator> X<operator, shift> X<<< << >>>
1958  X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
1959  X<shl> X<shr> X<shift, right> X<shift, left>
1960  
1961  =item Named Unary Operators
1962  X<operator, named unary>
1963  
1964  =item Relational Operators
1965  X<relational operator> X<operator, relational>
1966  
1967  =item Equality Operators
1968  X<equality> X<equal> X<equals> X<operator, equality>
1969  
1970  =item Bitwise And
1971  X<operator, bitwise, and> X<bitwise and> X<&>
1972  
1973  =item Bitwise Or and Exclusive Or
1974  X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
1975  X<bitwise xor> X<^>
1976  
1977  =item C-style Logical And
1978  X<&&> X<logical and> X<operator, logical, and>
1979  
1980  =item C-style Logical Or
1981  X<||> X<operator, logical, or>
1982  
1983  =item C-style Logical Defined-Or
1984  X<//> X<operator, logical, defined-or>
1985  
1986  =item Range Operators
1987  X<operator, range> X<range> X<..> X<...>
1988  
1989  =item Conditional Operator
1990  X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
1991  
1992  =item Assignment Operators
1993  X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
1994  X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<//=> X<.=>
1995  X<%=> X<^=> X<x=>
1996  
1997  =item Comma Operator
1998  X<comma> X<operator, comma> X<,>
1999  
2000  =item List Operators (Rightward)
2001  X<operator, list, rightward> X<list operator>
2002  
2003  =item Logical Not
2004  X<operator, logical, not> X<not>
2005  
2006  =item Logical And
2007  X<operator, logical, and> X<and>
2008  
2009  =item Logical or, Defined or, and Exclusive Or
2010  X<operator, logical, or> X<operator, logical, xor>
2011  X<operator, logical, defined or> X<operator, logical, exclusive or>
2012  X<or> X<xor>
2013  
2014  =item C Operators Missing From Perl
2015  X<operator, missing from perl> X<&> X<*>
2016  X<typecasting> X<(TYPE)>
2017  
2018  unary &, unary *, (TYPE)
2019  
2020  =item Quote and Quote-like Operators
2021  X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m>
2022  X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
2023  X<escape sequence> X<escape>
2024  
2025  =item Regexp Quote-Like Operators
2026  X<operator, regexp>
2027  
2028  qr/STRING/msixpo X<qr> X</i> X</m> X</o> X</s> X</x> X</p>,
2029  m/PATTERN/msixpogc X<m> X<operator, match> X<regexp, options> X<regexp>
2030  X<regex, options> X<regex> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c>,
2031  /PATTERN/msixpogc, ?PATTERN? X<?>, s/PATTERN/REPLACEMENT/msixpogce
2032  X<substitute> X<substitution> X<replace> X<regexp, replace> X<regexp,
2033  substitute> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c> X</e>
2034  
2035  =item Quote-Like Operators
2036  X<operator, quote-like>
2037  
2038  q/STRING/ X<q> X<quote, single> X<'> X<''>, 'STRING', qq/STRING/ X<qq>
2039  X<quote, double> X<"> X<"">, "STRING", qx/STRING/ X<qx> X<`> X<``>
2040  X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote, words>,
2041  tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y> X<transliterate> X</c> X</d>
2042  X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF X<here-doc> X<heredoc>
2043  X<here-document> X<<< << >>>, Double Quotes, Single Quotes, Backticks
2044  
2045  =item Gory details of parsing quoted constructs
2046  X<quote, gory details>
2047  
2048  Finding the end, Interpolation X<interpolation>, C<<<'EOF'>,  C<m''>, the
2049  pattern of C<s'''>, C<''>, C<q//>, C<tr'''>, C<y'''>, the replacement of
2050  C<s'''>, C<tr///>, C<y///>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob>
2051  >>, C<<<"EOF">, the replacement of C<s///>, C<RE> in C<?RE?>, C</RE/>,
2052  C<m/RE/>, C<s/RE/foo/>,, parsing regular expressions X<regexp, parse>,
2053  Optimization of regular expressions X<regexp, optimization>
2054  
2055  =item I/O Operators
2056  X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2057  X<< <> >> X<@ARGV>
2058  
2059  =item Constant Folding
2060  X<constant folding> X<folding>
2061  
2062  =item No-ops
2063  X<no-op> X<nop>
2064  
2065  =item Bitwise String Operators
2066  X<operator, bitwise, string>
2067  
2068  =item Integer Arithmetic
2069  X<integer>
2070  
2071  =item Floating-point Arithmetic
2072  X<floating-point> X<floating point> X<float> X<real>
2073  
2074  =item Bigger Numbers
2075  X<number, arbitrary precision>
2076  
2077  =back
2078  
2079  =back
2080  
2081  =head2 perlsub - Perl subroutines
2082  
2083  =over 4
2084  
2085  =item SYNOPSIS
2086  
2087  =item DESCRIPTION
2088  
2089  =over 4
2090  
2091  =item Private Variables via my()
2092  X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2093  X<lexical scope> X<attributes, my>
2094  
2095  =item Persistent Private Variables
2096  X<state> X<state variable> X<static> X<variable, persistent> X<variable,
2097  static> X<closure>
2098  
2099  =item Temporary Values via local()
2100  X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2101  X<variable, temporary>
2102  
2103  =item Lvalue subroutines
2104  X<lvalue> X<subroutine, lvalue>
2105  
2106  Lvalue subroutines are EXPERIMENTAL
2107  
2108  =item Passing Symbol Table Entries (typeglobs)
2109  X<typeglob> X<*>
2110  
2111  =item When to Still Use local()
2112  X<local> X<variable, local>
2113  
2114  =item Pass by Reference
2115  X<pass by reference> X<pass-by-reference> X<reference>
2116  
2117  =item Prototypes
2118  X<prototype> X<subroutine, prototype>
2119  
2120  =item Constant Functions
2121  X<constant>
2122  
2123  =item Overriding Built-in Functions
2124  X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2125  
2126  =item Autoloading
2127  X<autoloading> X<AUTOLOAD>
2128  
2129  =item Subroutine Attributes
2130  X<attribute> X<subroutine, attribute> X<attrs>
2131  
2132  =back
2133  
2134  =item SEE ALSO
2135  
2136  =back
2137  
2138  =head2 perlfunc - Perl builtin functions
2139  
2140  =over 4
2141  
2142  =item DESCRIPTION
2143  
2144  =over 4
2145  
2146  =item Perl Functions by Category
2147  X<function>
2148  
2149  Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2150  expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2151  Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2152  Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2153  Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2154  X<input> X<output> X<dbm>, Functions for fixed length data or records,
2155  Functions for filehandles, files, or directories X<file> X<filehandle>
2156  X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2157  flow of your Perl program X<control flow>, Keywords related to switch,
2158  Keywords related to scoping, Miscellaneous functions, Functions for
2159  processes and process groups X<process> X<pid> X<process id>, Keywords
2160  related to perl modules X<module>, Keywords related to classes and
2161  object-orientation X<object> X<class> X<package>, Low-level socket
2162  functions X<socket> X<sock>, System V interprocess communication functions
2163  X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
2164  Fetching user and group info X<user> X<group> X<password> X<uid> X<gid> 
2165  X<passwd> X</etc/passwd>, Fetching network info X<network> X<protocol>
2166  X<host> X<hostname> X<IP> X<address> X<service>, Time-related functions
2167  X<time> X<date>, Functions new in perl5 X<perl5>, Functions obsoleted in
2168  perl5
2169  
2170  =item Portability
2171  X<portability> X<Unix> X<portable>
2172  
2173  =item Alphabetical Listing of Perl Functions
2174  
2175  -I<X> FILEHANDLE
2176  X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p>
2177  X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I<X> EXPR,
2178  -I<X> DIRHANDLE, -I<X>, abs VALUE X<abs> X<absolute>, abs, accept
2179  NEWSOCKET,GENERICSOCKET X<accept>, alarm SECONDS X<alarm> X<SIGALRM>
2180  X<timer>, alarm, atan2 Y,X X<atan2> X<arctangent> X<tan> X<tangent>, bind
2181  SOCKET,NAME X<bind>, binmode FILEHANDLE, LAYER X<binmode> X<binary> X<text>
2182  X<DOS> X<Windows>, binmode FILEHANDLE, bless REF,CLASSNAME X<bless>, bless
2183  REF, break, caller EXPR X<caller> X<call stack> X<stack> X<stack trace>,
2184  caller, chdir EXPR X<chdir> X<cd> X<directory, change>, chdir FILEHANDLE,
2185  chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> X<mode>, chomp
2186  VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp(
2187  LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST
2188  X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII>
2189  X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, chroot, close
2190  FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, connect
2191  SOCKET,NAME X<connect>, continue BLOCK X<continue>, continue, cos EXPR
2192  X<cos> X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt>
2193  X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt>
2194  X<cryptography> X<passwd> X<encrypt>, dbmclose HASH X<dbmclose>, dbmopen
2195  HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR
2196  X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST
2197  X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do>
2198  X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump>
2199  X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof
2200  FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR
2201  X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute> X<error, handling>
2202  X<exception, handling>, eval BLOCK, eval, exec LIST X<exec> X<execute>,
2203  exec PROGRAM LIST, exists EXPR X<exists> X<autovivification>, exit EXPR
2204  X<exit> X<terminate> X<abort>, exit, exp EXPR X<exp> X<exponential>
2205  X<antilog> X<antilogarithm> X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR
2206  X<fcntl>, fileno FILEHANDLE X<fileno>, flock FILEHANDLE,OPERATION X<flock>
2207  X<lock> X<locking>, fork X<fork> X<child> X<parent>, format X<format>,
2208  formline PICTURE,LIST X<formline>, getc FILEHANDLE X<getc> X<getchar>
2209  X<character> X<file, read>, getc, getlogin X<getlogin> X<login>,
2210  getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>,
2211  getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority>
2212  X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname>
2213  X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname>
2214  X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport>
2215  X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent>
2216  X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent>
2217  X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent>
2218  X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME, gethostbyname
2219  NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID,
2220  getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr
2221  ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
2222  getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
2223  setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
2224  setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
2225  endprotoent, endservent, getsockname SOCKET X<getsockname>, getsockopt
2226  SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard>
2227  X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC>
2228  X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto
2229  &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex>
2230  X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION
2231  X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer>
2232  X<truncate> X<trunc> X<floor>, int, ioctl FILEHANDLE,FUNCTION,SCALAR
2233  X<ioctl>, join EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL,
2234  LIST X<kill> X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc>
2235  X<lowercase>, lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length
2236  EXPR X<length> X<size>, length, link OLDFILE,NEWFILE X<link>, listen
2237  SOCKET,QUEUESIZE X<listen>, local EXPR X<local>, localtime EXPR
2238  X<localtime> X<ctime>, localtime, lock THING X<lock>, log EXPR X<log>
2239  X<logarithm> X<e> X<ln> X<base>, log, lstat EXPR X<lstat>, lstat, m//, map
2240  BLOCK LIST X<map>, map EXPR,LIST, mkdir FILENAME,MASK X<mkdir> X<md>
2241  X<directory, create>, mkdir FILENAME, mkdir, msgctl ID,CMD,ARG X<msgctl>,
2242  msgget KEY,FLAGS X<msgget>, msgrcv ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd
2243  ID,MSG,FLAGS X<msgsnd>, my EXPR X<my>, my TYPE EXPR, my EXPR : ATTRS, my
2244  TYPE EXPR : ATTRS, next LABEL X<next> X<continue>, next, no Module VERSION
2245  LIST X<no>, no Module VERSION, no Module LIST, no Module, no VERSION, oct
2246  EXPR X<oct> X<octal> X<hex> X<hexadecimal> X<binary> X<bin>, oct, open
2247  FILEHANDLE,EXPR X<open> X<pipe> X<file, open> X<fopen>, open
2248  FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
2249  FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR
2250  X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>,
2251  our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST
2252  X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe
2253  READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR
2254  X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST,
2255  print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST,
2256  prototype FUNCTION X<prototype>, push ARRAY,LIST X<push> X<stack>,
2257  q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR
2258  X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>,
2259  rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read> X<file, read>, read
2260  FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR,
2261  readline X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink,
2262  readpipe EXPR, readpipe X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS
2263  X<recv>, redo LABEL X<redo>, redo, ref EXPR X<ref> X<reference>, ref,
2264  rename OLDNAME,NEWNAME X<rename> X<move> X<mv> X<ren>, require VERSION
2265  X<require>, require EXPR, require, reset EXPR X<reset>, reset, return EXPR
2266  X<return>, return, reverse LIST X<reverse> X<rev> X<invert>, rewinddir
2267  DIRHANDLE X<rewinddir>, rindex STR,SUBSTR,POSITION X<rindex>, rindex
2268  STR,SUBSTR, rmdir FILENAME X<rmdir> X<rd> X<directory, remove>, rmdir,
2269  s///, say FILEHANDLE LIST X<say>, say LIST, say, scalar EXPR X<scalar>
2270  X<context>, seek FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle,
2271  position>, seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select>
2272  X<filehandle, default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>,
2273  semctl ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2274  KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2275  SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2276  WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2277  SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2278  shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2279  ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2280  shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2281  X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2282  SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2283  SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2284  X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2285  splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2286  splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2287  split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2288  X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2289  precision, or maximum width X<precision>, size, order of arguments, sqrt
2290  EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2291  X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status> X<ctime>, stat
2292  EXPR, stat DIRHANDLE, stat, state EXPR X<state>, state TYPE EXPR, state
2293  EXPR : ATTRS, state TYPE EXPR : ATTRS, study SCALAR X<study>, study, sub
2294  NAME BLOCK X<sub>, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME
2295  (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT X<substr>
2296  X<substring> X<mid> X<left> X<right>, substr EXPR,OFFSET,LENGTH, substr
2297  EXPR,OFFSET, symlink OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link>
2298  X<link, symbolic>, syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2299  FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2300  FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2301  X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2302  FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2303  X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2304  X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2305  tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2306  VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2307  X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2308  truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2309  EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2310  EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2311  X<rm> X<del>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE,
2312  untie VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION
2313  LIST X<use> X<module> X<import>, use Module VERSION, use Module LIST, use
2314  Module, use VERSION, utime LIST X<utime>, values HASH X<values>, vec
2315  EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>, waitpid
2316  PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST X<warn>
2317  X<warning> X<STDERR>, write FILEHANDLE X<write>, write EXPR, write, y///
2318  
2319  =back
2320  
2321  =back
2322  
2323  =head2 perlopentut - tutorial on opening things in Perl
2324  
2325  =over 4
2326  
2327  =item DESCRIPTION
2328  
2329  =item Open E<agrave> la shell
2330  
2331  =over 4
2332  
2333  =item Simple Opens
2334  
2335  =item Indirect Filehandles
2336  
2337  =item Pipe Opens
2338  
2339  =item The Minus File
2340  
2341  =item Mixing Reads and Writes
2342  
2343  =item Filters 
2344  
2345  =back
2346  
2347  =item Open E<agrave> la C
2348  
2349  =over 4
2350  
2351  =item Permissions E<agrave> la mode
2352  
2353  =back
2354  
2355  =item Obscure Open Tricks
2356  
2357  =over 4
2358  
2359  =item Re-Opening Files (dups)
2360  
2361  =item Dispelling the Dweomer
2362  
2363  =item Paths as Opens
2364  
2365  =item Single Argument Open
2366  
2367  =item Playing with STDIN and STDOUT
2368  
2369  =back
2370  
2371  =item Other I/O Issues
2372  
2373  =over 4
2374  
2375  =item Opening Non-File Files
2376  
2377  =item Opening Named Pipes
2378  
2379  =item Opening Sockets
2380  
2381  =item Binary Files
2382  
2383  =item File Locking
2384  
2385  =item IO Layers
2386  
2387  =back
2388  
2389  =item SEE ALSO 
2390  
2391  =item AUTHOR and COPYRIGHT
2392  
2393  =item HISTORY
2394  
2395  =back
2396  
2397  =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2398  
2399  =over 4
2400  
2401  =item DESCRIPTION
2402  
2403  =item The Basic Principle
2404  
2405  =item Packing Text
2406  
2407  =item Packing Numbers
2408  
2409  =over 4
2410  
2411  =item Integers
2412  
2413  =item Unpacking a Stack Frame
2414  
2415  =item How to Eat an Egg on a Net
2416  
2417  =item Byte-order modifiers
2418  
2419  =item Floating point Numbers
2420  
2421  =back
2422  
2423  =item Exotic Templates
2424  
2425  =over 4
2426  
2427  =item Bit Strings
2428  
2429  =item Uuencoding
2430  
2431  =item Doing Sums
2432  
2433  =item  Unicode
2434  
2435  =item Another Portable Binary Encoding
2436  
2437  =back
2438  
2439  =item Template Grouping
2440  
2441  =item Lengths and Widths
2442  
2443  =over 4
2444  
2445  =item String Lengths
2446  
2447  =item Dynamic Templates
2448  
2449  =item Counting Repetitions
2450  
2451  =back
2452  
2453  =item Packing and Unpacking C Structures
2454  
2455  =over 4
2456  
2457  =item The Alignment Pit
2458  
2459  =item Dealing with Endian-ness
2460  
2461  =item Alignment, Take 2
2462  
2463  =item Alignment, Take 3
2464  
2465  =item Pointers for How to Use Them
2466  
2467  =back
2468  
2469  =item Pack Recipes
2470  
2471  =item Funnies Section
2472  
2473  =item Authors
2474  
2475  =back
2476  
2477  =head2 perlpod - the Plain Old Documentation format
2478  
2479  =over 4
2480  
2481  =item DESCRIPTION
2482  
2483  =over 4
2484  
2485  =item Ordinary Paragraph
2486  X<POD, ordinary paragraph>
2487  
2488  =item Verbatim Paragraph
2489  X<POD, verbatim paragraph> X<verbatim>
2490  
2491  =item Command Paragraph
2492  X<POD, command>
2493  
2494  C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2495  X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2496  Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2497  X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2498  C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2499  X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2500  C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2501  X<encoding>
2502  
2503  =item Formatting Codes
2504  X<POD, formatting code> X<formatting code>
2505  X<POD, interior sequence> X<interior sequence>
2506  
2507  C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2508  code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2509  X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2510  X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2511  a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2512  X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2513  X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2514  for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2515  X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2516  X<< SZ<><> >> X<POD, formatting code, non-breaking space>  X<non-breaking
2517  space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2518  X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2519  null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2520  code, null> X<null>
2521  
2522  =item The Intent
2523  X<POD, intent of>
2524  
2525  =item Embedding Pods in Perl Modules
2526  X<POD, embedding>
2527  
2528  =item Hints for Writing Pod
2529  
2530  X<podchecker> X<POD, validating>
2531  
2532  =back
2533  
2534  =item SEE ALSO
2535  
2536  =item AUTHOR
2537  
2538  =back
2539  
2540  =head2 perlpodspec - Plain Old Documentation: format specification and
2541  notes
2542  
2543  =over 4
2544  
2545  =item DESCRIPTION
2546  
2547  =item Pod Definitions
2548  
2549  =item Pod Commands
2550  
2551  "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2552  "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2553  "=encoding encodingname"
2554  
2555  =item Pod Formatting Codes
2556  
2557  C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2558  C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2559  filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2560  null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2561  C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2562  contains non-breaking spaces
2563  
2564  =item Notes on Implementing Pod Processors
2565  
2566  =item About LE<lt>...E<gt> Codes
2567  
2568  First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2569  
2570  =item About =over...=back Regions
2571  
2572  =item About Data Paragraphs and "=begin/=end" Regions
2573  
2574  =item SEE ALSO
2575  
2576  =item AUTHOR
2577  
2578  =back
2579  
2580  =head2 perlrun - how to execute the Perl interpreter
2581  
2582  =over 4
2583  
2584  =item SYNOPSIS
2585  
2586  =item DESCRIPTION
2587  
2588  =over 4
2589  
2590  =item #! and quoting on non-Unix systems
2591  X<hashbang> X<#!>
2592  
2593  OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2594  
2595  =item Location of Perl
2596  X<perl, location of interpreter>
2597  
2598  =item Command Switches
2599  X<perl, command switches> X<command switches>
2600  
2601  B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C
2602  [I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>,
2603  B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>,
2604  B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e>
2605  I<commandline> X<-e>, B<-E> I<commandline> X<-E>, B<-f> X<-f>,
2606  B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i> X<in-place>,
2607  B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/> X<$\>,
2608  B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>,
2609  B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
2610  X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>,
2611  B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>,
2612  B<-V:>I<configvar>, B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>,
2613  B<-x>I<directory>
2614  
2615  =back
2616  
2617  =item ENVIRONMENT
2618  X<perl, environment variables>
2619  
2620  HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2621  PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2622  :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2623  X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2624  X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2625  X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2626  PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2627  X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2628  PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2629  X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2630  X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2631  (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2632  PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2633  X<SYS$LOGIN>
2634  
2635  =back
2636  
2637  =head2 perldiag - various Perl diagnostics
2638  
2639  =over 4
2640  
2641  =item DESCRIPTION
2642  
2643  =item SEE ALSO
2644  
2645  =back
2646  
2647  =head2 perllexwarn - Perl Lexical Warnings
2648  
2649  =over 4
2650  
2651  =item DESCRIPTION
2652  
2653  =over 4
2654  
2655  =item Default Warnings and Optional Warnings
2656  
2657  =item What's wrong with B<-w> and C<$^W>
2658  
2659  =item Controlling Warnings from the Command Line
2660  
2661  B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2662  
2663  =item Backward Compatibility
2664  
2665  =item Category Hierarchy
2666  X<warning, categories>
2667  
2668  =item Fatal Warnings
2669  X<warning, fatal>
2670  
2671  =item Reporting Warnings from a Module
2672  X<warning, reporting> X<warning, registering>
2673  
2674  =back
2675  
2676  =item SEE ALSO
2677  
2678  =item AUTHOR
2679  
2680  =back
2681  
2682  =head2 perldebug - Perl debugging
2683  
2684  =over 4
2685  
2686  =item DESCRIPTION
2687  
2688  =item The Perl Debugger
2689  
2690  =over 4
2691  
2692  =item Calling the debugger
2693  
2694  perl -d program_name, perl -d -e 0, perl -d:Ptkdb program_name, perl -dt
2695  threaded_program_name
2696  
2697  =item Debugger Commands
2698  
2699  h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2700  x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2701  command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2702  command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2703  [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2704  X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2705  X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2706  X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2707  command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2708  [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2709  X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2710  X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2711  command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2712  postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2713  filename X<breakpoint> X<debugger command, b>, b compile subname
2714  X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2715  command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2716  X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2717  command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2718  W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2719  X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2720  option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2721  [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2722  command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2723  command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2724  command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2725  command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2726  ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2727  pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2728  X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2729  X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2730  |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2731  expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2732  X<debugger command, man>
2733  
2734  =item Configurable Options
2735  
2736  C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2737  option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2738  X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2739  X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2740  option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2741  X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2742  inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2743  X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2744  C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2745  option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2746  arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2747  dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2748  X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2749  globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2750  X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2751  DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2752  X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2753  X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2754  X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2755  C<NonStop> X<debugger option, NonStop>
2756  
2757  =item Debugger input/output
2758  
2759  Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2760  backtrace>, Line Listing Format, Frame listing
2761  
2762  =item Debugging compile-time statements
2763  
2764  =item Debugger Customization
2765  
2766  =item Readline Support
2767  
2768  =item Editor Support for Debugging
2769  
2770  =item The Perl Profiler
2771  X<profile> X<profiling> X<profiler>
2772  
2773  =back
2774  
2775  =item Debugging regular expressions
2776  X<regular expression, debugging>
2777  X<regex, debugging> X<regexp, debugging>
2778  
2779  =item Debugging memory usage
2780  X<memory usage>
2781  
2782  =item SEE ALSO
2783  
2784  =item BUGS
2785  
2786  =back
2787  
2788  =head2 perlvar - Perl predefined variables
2789  
2790  =over 4
2791  
2792  =item DESCRIPTION
2793  
2794  =over 4
2795  
2796  =item Predefined Names
2797  
2798  $ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $<I<digits>> X<$1> X<$2> X<$3>,
2799  $MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`>
2800  X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'>
2801  X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+>
2802  X<$LAST_PAREN_MATCH>, $LAST_SUBMATCH_RESULT, $^N X<$^N>, @LAST_MATCH_END,
2803  @+ X<@+> X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR),
2804  $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X<line
2805  number>, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR,
2806  $RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR),
2807  $OUTPUT_AUTOFLUSH, $| X<$|> X<autoflush> X<flush> X<$OUTPUT_AUTOFLUSH>,
2808  IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,
2809  X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>,
2810  IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2811  $\ X<$\> X<$ORS> X<$OUTPUT_RECORD_SEPARATOR>, $LIST_SEPARATOR, $" X<$">
2812  X<$LIST_SEPARATOR>, $SUBSCRIPT_SEPARATOR, $SUBSEP, $; X<$;> X<$SUBSEP>
2813  X<SUBSCRIPT_SEPARATOR>, HANDLE->format_page_number(EXPR),
2814  $FORMAT_PAGE_NUMBER, $% X<$%> X<$FORMAT_PAGE_NUMBER>,
2815  HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $= X<$=>
2816  X<$FORMAT_LINES_PER_PAGE>, HANDLE->format_lines_left(EXPR),
2817  $FORMAT_LINES_LEFT, $- X<$-> X<$FORMAT_LINES_LEFT>, @LAST_MATCH_START, @-
2818  X<@-> X<@LAST_MATCH_START>, C<$`> is the same as C<substr($var, 0, $-[0])>,
2819  C<$&> is the same as C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the
2820  same as C<substr($var, $+[0])>, C<$1> is the same as C<substr($var, $-[1],
2821  $+[1] - $-[1])>, C<$2> is the same as C<substr($var, $-[2], $+[2] -
2822  $-[2])>, C<$3> is the same as C<substr($var, $-[3], $+[3] - $-[3])>, %-
2823  X<%->, HANDLE->format_name(EXPR), $FORMAT_NAME, $~ X<$~> X<$FORMAT_NAME>,
2824  HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^ X<$^>
2825  X<$FORMAT_TOP_NAME>, IO::Handle->format_line_break_characters EXPR,
2826  $FORMAT_LINE_BREAK_CHARACTERS, $: X<$:> X<FORMAT_LINE_BREAK_CHARACTERS>,
2827  IO::Handle->format_formfeed EXPR, $FORMAT_FORMFEED, $^L X<$^L>
2828  X<$FORMAT_FORMFEED>, $ACCUMULATOR, $^A X<$^A> X<$ACCUMULATOR>,
2829  $CHILD_ERROR, $? X<$?> X<$CHILD_ERROR>, ${^CHILD_ERROR_NATIVE}
2830  X<$^CHILD_ERROR_NATIVE>, ${^ENCODING} X<$^ENCODING>, $OS_ERROR, $ERRNO, $!
2831  X<$!> X<$ERRNO> X<$OS_ERROR>, %OS_ERROR, %ERRNO, %! X<%!>,
2832  $EXTENDED_OS_ERROR, $^E X<$^E> X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@>
2833  X<$EVAL_ERROR>, $PROCESS_ID, $PID, $$ X<$$> X<$PID> X<$PROCESS_ID>,
2834  $REAL_USER_ID, $UID, $< X<< $< >> X<$UID> X<$REAL_USER_ID>,
2835  $EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID> X<$EFFECTIVE_USER_ID>,
2836  $REAL_GROUP_ID, $GID, $( X<$(> X<$GID> X<$REAL_GROUP_ID>,
2837  $EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID> X<$EFFECTIVE_GROUP_ID>,
2838  $PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>, $] X<$]>, $COMPILING,
2839  $^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D> X<$DEBUGGING>,
2840  ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F X<$^F>
2841  X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I> X<$INPLACE_EDIT>,
2842  $^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN}, $PERLDB, $^P X<$^P>
2843  X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200,
2844  0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R> X<$LAST_REGEXP_CODE_RESULT>,
2845  $EXCEPTIONS_BEING_CAUGHT, $^S X<$^S> X<$EXCEPTIONS_BEING_CAUGHT>,
2846  $BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT}, ${^UNICODE}, ${^UTF8CACHE},
2847  ${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V> X<$PERL_VERSION>, $WARNING, $^W
2848  X<$^W> X<$WARNING>, ${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT},
2849  $EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>, ARGV X<ARGV>, $ARGV
2850  X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>, @INC X<@INC>, @ARG,
2851  @_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr} X<%ENV>, %SIG, $SIG{expr}
2852  X<%SIG>
2853  
2854  =item Error Indicators
2855  X<error> X<exception>
2856  
2857  =item Technical Note on the Syntax of Variable Names
2858  
2859  =back
2860  
2861  =item BUGS
2862  
2863  =back
2864  
2865  =head2 perlre - Perl regular expressions
2866  
2867  =over 4
2868  
2869  =item DESCRIPTION
2870  
2871  =over 4
2872  
2873  =item Modifiers
2874  
2875  m X</m> X<regex, multiline> X<regexp, multiline> X<regular expression,
2876  multiline>, s X</s> X<regex, single-line> X<regexp, single-line> X<regular
2877  expression, single-line>, i X</i> X<regex, case-insensitive> X<regexp,
2878  case-insensitive> X<regular expression, case-insensitive>, x X</x>, p X</p>
2879  X<regex, preserve> X<regexp, preserve>, g and c X</g> X</c>
2880  
2881  =item Regular Expressions
2882  
2883  [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct
2884  X<punct>, xdigit X<xdigit>
2885  
2886  =item Extended Patterns
2887  
2888  C<(?#text)> X<(?#)>, C<(?pimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2889  C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X<Branch reset>,
2890  Look-Around Assertions X<look-around assertion> X<lookaround assertion>
2891  X<look-around> X<lookaround>, C<(?=pattern)> X<(?=)> X<look-ahead,
2892  positive> X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead,
2893  negative> X<lookahead, negative>, C<(?<=pattern)> C<\K> X<(?<=)>
2894  X<look-behind, positive> X<lookbehind, positive> X<\K>, C<(?<!pattern)>
2895  X<(?<!)> X<look-behind, negative> X<lookbehind, negative>,
2896  C<(?'NAME'pattern)>, C<< (?<NAME>pattern) >> X<< (?<NAME>) >> X<(?'NAME')>
2897  X<named capture> X<capture>, C<< \k<NAME> >>, C<< \k'NAME' >>, C<(?{ code
2898  })> X<(?{})> X<regex, code in> X<regexp, code in> X<regular expression,
2899  code in>, C<(??{ code })> X<(??{})> X<regex, postponed> X<regexp,
2900  postponed> X<regular expression, postponed>, C<(?PARNO)> C<(?-PARNO)>
2901  C<(?+PARNO)> C<(?R)> C<(?0)> X<(?PARNO)> X<(?1)> X<(?R)> X<(?0)> X<(?-1)>
2902  X<(?+1)> X<(?-PARNO)> X<(?+PARNO)> X<regex, recursive> X<regexp, recursive>
2903  X<regular expression, recursive> X<regex, relative recursion>, C<(?&NAME)>
2904  X<(?&NAME)>, C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2905  C<(?(condition)yes-pattern)>, (1) (2) .., (<NAME>) ('NAME'), (?{ CODE }),
2906  (R), (R1) (R2) .., (R&NAME), (DEFINE), C<< (?>pattern) >> X<backtrack>
2907  X<backtracking> X<atomic> X<possessive>
2908  
2909  =item Special Backtracking Control Verbs
2910  
2911  Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)>
2912  X<(*PRUNE:NAME)>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>, C<(*MARK:NAME)>
2913  C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>, C<(*THEN)>
2914  C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an argument,
2915  C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
2916  
2917  =item Backtracking
2918  X<backtrack> X<backtracking>
2919  
2920  =item Version 8 Regular Expressions
2921  X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
2922  
2923  =item Warning on \1 Instead of $1
2924  
2925  =item Repeated Patterns Matching a Zero-length Substring
2926  
2927  =item Combining RE Pieces
2928  
2929  C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2930  C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2931  C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, C<(?PARNO)>,
2932  C<(?(condition)yes-pattern|no-pattern)>
2933  
2934  =item Creating Custom RE Engines
2935  
2936  =back
2937  
2938  =item PCRE/Python Support
2939  
2940  C<< (?PE<lt>NAMEE<gt>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
2941  
2942  =item BUGS
2943  
2944  =item SEE ALSO
2945  
2946  =back
2947  
2948  =head2 perlrebackslash - Perl Regular Expression Backslash Sequences and
2949  Escapes
2950  
2951  =over 4
2952  
2953  =item DESCRIPTION
2954  
2955  =over 4
2956  
2957  =item The backslash
2958  
2959  [1]
2960  
2961  =item All the sequences and escapes
2962  
2963  =item Character Escapes
2964  
2965  [1], [2]
2966  
2967  =item Modifiers
2968  
2969  =item Character classes
2970  
2971  =item Referencing
2972  
2973  =item Assertions
2974  
2975  \A, \z, \Z, \G, \b, \B
2976  
2977  =item Misc
2978  
2979  \C, \K, \R, \X
2980  
2981  =back
2982  
2983  =back
2984  
2985  =head2 perlrecharclass - Perl Regular Expression Character Classes
2986  
2987  =over 4
2988  
2989  =item DESCRIPTION
2990  
2991  =over 4
2992  
2993  =item The dot
2994  
2995  =item Backslashed sequences
2996  
2997  [1]
2998  
2999  =item Bracketed Character Classes
3000  
3001  cntrl, graph, print, punct
3002  
3003  =item Locale, Unicode and UTF-8
3004  
3005  =back
3006  
3007  =back
3008  
3009  =head2 perlreref - Perl Regular Expressions Reference
3010  
3011  =over 4
3012  
3013  =item DESCRIPTION
3014  
3015  =over 4
3016  
3017  =item OPERATORS
3018  
3019  =item SYNTAX
3020  
3021  =item ESCAPE SEQUENCES
3022  
3023  =item CHARACTER CLASSES
3024  
3025  =item ANCHORS
3026  
3027  =item QUANTIFIERS
3028  
3029  =item EXTENDED CONSTRUCTS
3030  
3031  =item VARIABLES
3032  
3033  =item FUNCTIONS
3034  
3035  =item TERMINOLOGY
3036  
3037  =back
3038  
3039  =item AUTHOR
3040  
3041  =item SEE ALSO
3042  
3043  =item THANKS
3044  
3045  =back
3046  
3047  =head2 perlref - Perl references and nested data structures
3048  
3049  =over 4
3050  
3051  =item NOTE
3052  
3053  =item DESCRIPTION
3054  
3055  =over 4
3056  
3057  =item Making References
3058  X<reference, creation> X<referencing>
3059  
3060  1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
3061  X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
3062  X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
3063  X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
3064  anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
3065  lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
3066  6. X<autovivification>, 7. X<*foo{THING}> X<*>
3067  
3068  =item Using References
3069  X<reference, use> X<dereferencing> X<dereference>
3070  
3071  =item Symbolic references
3072  X<reference, symbolic> X<reference, soft>
3073  X<symbolic reference> X<soft reference>
3074  
3075  =item Not-so-symbolic references
3076  
3077  =item Pseudo-hashes: Using an array as a hash
3078  X<pseudo-hash> X<pseudo hash> X<pseudohash>
3079  
3080  =item Function Templates
3081  X<scope, lexical> X<closure> X<lexical> X<lexical scope>
3082  X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
3083  
3084  =back
3085  
3086  =item WARNING
3087  X<reference, string context> X<reference, use as hash key>
3088  
3089  =item SEE ALSO
3090  
3091  =back
3092  
3093  =head2 perlform - Perl formats
3094  
3095  =over 4
3096  
3097  =item DESCRIPTION
3098  
3099  =over 4
3100  
3101  =item Text Fields
3102  X<format, text field>
3103  
3104  =item Numeric Fields
3105  X<#> X<format, numeric field>
3106  
3107  =item The Field @* for Variable Width Multi-Line Text
3108  X<@*>
3109  
3110  =item The Field ^* for Variable Width One-line-at-a-time Text
3111  X<^*>
3112  
3113  =item Specifying Values
3114  X<format, specifying values>
3115  
3116  =item Using Fill Mode
3117  X<format, fill mode>
3118  
3119  =item Suppressing Lines Where All Fields Are Void
3120  X<format, suppressing lines>
3121  
3122  =item Repeating Format Lines
3123  X<format, repeating lines>
3124  
3125  =item Top of Form Processing
3126  X<format, top of form> X<top> X<header>
3127  
3128  =item Format Variables
3129  X<format variables>
3130  X<format, variables>
3131  
3132  =back
3133  
3134  =item NOTES
3135  
3136  =over 4
3137  
3138  =item Footers
3139  X<format, footer> X<footer>
3140  
3141  =item Accessing Formatting Internals
3142  X<format, internals>
3143  
3144  =back
3145  
3146  =item WARNINGS
3147  
3148  =back
3149  
3150  =head2 perlobj - Perl objects
3151  
3152  =over 4
3153  
3154  =item DESCRIPTION
3155  
3156  =over 4
3157  
3158  =item An Object is Simply a Reference
3159  X<object> X<bless> X<constructor> X<new>
3160  
3161  =item A Class is Simply a Package
3162  X<class> X<package> X<@ISA> X<inheritance>
3163  
3164  =item A Method is Simply a Subroutine
3165  X<method>
3166  
3167  =item Method Invocation
3168  X<invocation> X<method> X<arrow> X<< -> >>
3169  
3170  =item Indirect Object Syntax
3171  X<indirect object syntax> X<invocation, indirect> X<indirect>
3172  
3173  =item Default UNIVERSAL methods
3174  X<UNIVERSAL>
3175  
3176  isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION>
3177  
3178  =item Destructors
3179  X<destructor> X<DESTROY>
3180  
3181  =item Summary
3182  
3183  =item Two-Phased Garbage Collection
3184  X<garbage collection> X<GC> X<circular reference>
3185  X<reference, circular> X<DESTROY> X<destructor>
3186  
3187  =back
3188  
3189  =item SEE ALSO
3190  
3191  =back
3192  
3193  =head2 perltie - how to hide an object class in a simple variable
3194  
3195  =over 4
3196  
3197  =item SYNOPSIS
3198  
3199  =item DESCRIPTION
3200  
3201  =over 4
3202  
3203  =item Tying Scalars
3204  X<scalar, tying>
3205  
3206  TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3207  value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3208  
3209  =item Tying Arrays
3210  X<array, tying>
3211  
3212  TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3213  this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3214  count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3215  X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3216   X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST 
3217  X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3218  X<UNTIE>, DESTROY this X<DESTROY>
3219  
3220  =item Tying Hashes
3221  X<hash, tying>
3222  
3223  USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3224  key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3225  CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3226  NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3227  X<UNTIE>, DESTROY this X<DESTROY>
3228  
3229  =item Tying FileHandles
3230  X<filehandle, tying>
3231  
3232  TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3233  this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3234  READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE
3235  this X<UNTIE>, DESTROY this X<DESTROY>
3236  
3237  =item UNTIE this
3238  X<UNTIE>
3239  
3240  =item The C<untie> Gotcha
3241  X<untie>
3242  
3243  =back
3244  
3245  =item SEE ALSO
3246  
3247  =item BUGS
3248  
3249  =item AUTHOR
3250  
3251  =back
3252  
3253  =head2 perldbmfilter - Perl DBM Filters
3254  
3255  =over 4
3256  
3257  =item SYNOPSIS
3258  
3259  =item DESCRIPTION
3260  
3261  B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3262  B<filter_fetch_value>
3263  
3264  =over 4
3265  
3266  =item The Filter
3267  
3268  =item An Example -- the NULL termination problem.
3269  
3270  =item Another Example -- Key is a C int.
3271  
3272  =back
3273  
3274  =item SEE ALSO
3275  
3276  =item AUTHOR
3277  
3278  =back
3279  
3280  =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3281  safe subprocesses, sockets, and semaphores)
3282  
3283  =over 4
3284  
3285  =item DESCRIPTION
3286  
3287  =item Signals
3288  
3289  =over 4
3290  
3291  =item Handling the SIGHUP Signal in Daemons
3292  
3293  =back
3294  
3295  =item Named Pipes
3296  
3297  =over 4
3298  
3299  =item Deferred Signals (Safe Signals)
3300  
3301  Long-running opcodes, Interrupting IO, Restartable system calls, Signals as
3302  "faults", Signals triggered by operating system state
3303  
3304  =back
3305  
3306  =item Using open() for IPC
3307  
3308  =over 4
3309  
3310  =item Filehandles
3311  
3312  =item Background Processes
3313  
3314  =item Complete Dissociation of Child from Parent
3315  
3316  =item Safe Pipe Opens
3317  
3318  =item Bidirectional Communication with Another Process
3319  
3320  =item Bidirectional Communication with Yourself
3321  
3322  =back
3323  
3324  =item Sockets: Client/Server Communication
3325  
3326  =over 4
3327  
3328  =item Internet Line Terminators
3329  
3330  =item Internet TCP Clients and Servers
3331  
3332  =item Unix-Domain TCP Clients and Servers
3333  
3334  =back
3335  
3336  =item TCP Clients with IO::Socket
3337  
3338  =over 4
3339  
3340  =item A Simple Client
3341  
3342  C<Proto>, C<PeerAddr>, C<PeerPort>
3343  
3344  =item A Webget Client
3345  
3346  =item Interactive Client with IO::Socket
3347  
3348  =back
3349  
3350  =item TCP Servers with IO::Socket
3351  
3352  Proto, LocalPort, Listen, Reuse
3353  
3354  =item UDP: Message Passing
3355  
3356  =item SysV IPC
3357  
3358  =item NOTES
3359  
3360  =item BUGS
3361  
3362  =item AUTHOR
3363  
3364  =item SEE ALSO
3365  
3366  =back
3367  
3368  =head2 perlfork - Perl's fork() emulation
3369  
3370  =over 4
3371  
3372  =item SYNOPSIS
3373  
3374  =item DESCRIPTION
3375  
3376  =over 4
3377  
3378  =item Behavior of other Perl features in forked pseudo-processes
3379  
3380  $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3381  filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3382  files, directories and network sockets
3383  
3384  =item Resource limits
3385  
3386  =item Killing the parent process
3387  
3388  =item Lifetime of the parent process and pseudo-processes
3389  
3390  =item CAVEATS AND LIMITATIONS
3391  
3392  BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3393  Global state maintained by XSUBs, Interpreter embedded in larger
3394  application, Thread-safety of extensions
3395  
3396  =back
3397  
3398  =item BUGS
3399  
3400  =item AUTHOR
3401  
3402  =item SEE ALSO
3403  
3404  =back
3405  
3406  =head2 perlnumber - semantics of numbers and numeric operations in Perl
3407  
3408  =over 4
3409  
3410  =item SYNOPSIS
3411  
3412  =item DESCRIPTION
3413  
3414  =item Storing numbers
3415  
3416  =item Numeric operators and numeric conversions
3417  
3418  =item Flavors of Perl numeric operations
3419  
3420  Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3421  mathematical operators, Bitwise operators, Bitwise operators during C<use
3422  integer>, Operators which expect an integer, Operators which expect a
3423  string
3424  
3425  =item AUTHOR
3426  
3427  =item SEE ALSO
3428  
3429  =back
3430  
3431  =head2 perlthrtut - Tutorial on threads in Perl
3432  
3433  =over 4
3434  
3435  =item DESCRIPTION
3436  
3437  =item What Is A Thread Anyway?
3438  
3439  =item Threaded Program Models
3440  
3441  =over 4
3442  
3443  =item Boss/Worker
3444  
3445  =item Work Crew
3446  
3447  =item Pipeline
3448  
3449  =back
3450  
3451  =item What kind of threads are Perl threads?
3452  
3453  =item Thread-Safe Modules
3454  
3455  =item Thread Basics
3456  
3457  =over 4
3458  
3459  =item Basic Thread Support
3460  
3461  =item A Note about the Examples
3462  
3463  =item Creating Threads
3464  
3465  =item Waiting For A Thread To Exit
3466  
3467  =item Ignoring A Thread
3468  
3469  =item Process and Thread Termination
3470  
3471  =back
3472  
3473  =item Threads And Data
3474  
3475  =over 4
3476  
3477  =item Shared And Unshared Data
3478  
3479  =item Thread Pitfalls: Races
3480  
3481  =back
3482  
3483  =item Synchronization and control
3484  
3485  =over 4
3486  
3487  =item Controlling access: lock()
3488  
3489  =item A Thread Pitfall: Deadlocks
3490  
3491  =item Queues: Passing Data Around
3492  
3493  =item Semaphores: Synchronizing Data Access
3494  
3495  =item Basic semaphores
3496  
3497  =item Advanced Semaphores
3498  
3499  =item Waiting for a Condition
3500  
3501  =item Giving up control
3502  
3503  =back
3504  
3505  =item General Thread Utility Routines
3506  
3507  =over 4
3508  
3509  =item What Thread Am I In?
3510  
3511  =item Thread IDs
3512  
3513  =item Are These Threads The Same?
3514  
3515  =item What Threads Are Running?
3516  
3517  =back
3518  
3519  =item A Complete Example
3520  
3521  =item Different implementations of threads
3522  
3523  =item Performance considerations
3524  
3525  =item Process-scope Changes
3526  
3527  =item Thread-Safety of System Libraries
3528  
3529  =item Conclusion
3530  
3531  =item SEE ALSO
3532  
3533  =item Bibliography
3534  
3535  =over 4
3536  
3537  =item Introductory Texts
3538  
3539  =item OS-Related References
3540  
3541  =item Other References
3542  
3543  =back
3544  
3545  =item Acknowledgements
3546  
3547  =item AUTHOR
3548  
3549  =item Copyrights
3550  
3551  =back
3552  
3553  =head2 perlothrtut - old tutorial on threads in Perl
3554  
3555  =over 4
3556  
3557  =item DESCRIPTION
3558  
3559  =item What Is A Thread Anyway?
3560  
3561  =item Threaded Program Models
3562  
3563  =over 4
3564  
3565  =item Boss/Worker
3566  
3567  =item Work Crew
3568  
3569  =item Pipeline
3570  
3571  =back
3572  
3573  =item Native threads
3574  
3575  =item What kind of threads are perl threads?
3576  
3577  =item Threadsafe Modules
3578  
3579  =item Thread Basics
3580  
3581  =over 4
3582  
3583  =item Basic Thread Support
3584  
3585  =item Creating Threads
3586  
3587  =item Giving up control
3588  
3589  =item Waiting For A Thread To Exit
3590  
3591  =item Errors In Threads
3592  
3593  =item Ignoring A Thread
3594  
3595  =back
3596  
3597  =item Threads And Data
3598  
3599  =over 4
3600  
3601  =item Shared And Unshared Data
3602  
3603  =item Thread Pitfall: Races
3604  
3605  =item Controlling access: lock()
3606  
3607  =item Thread Pitfall: Deadlocks
3608  
3609  =item Queues: Passing Data Around
3610  
3611  =back
3612  
3613  =item Threads And Code
3614  
3615  =over 4
3616  
3617  =item Semaphores: Synchronizing Data Access
3618  
3619  Basic semaphores, Advanced Semaphores
3620  
3621  =item Attributes: Restricting Access To Subroutines
3622  
3623  =item Subroutine Locks
3624  
3625  =item Methods
3626  
3627  =item Locking A Subroutine
3628  
3629  =back
3630  
3631  =item General Thread Utility Routines
3632  
3633  =over 4
3634  
3635  =item What Thread Am I In?
3636  
3637  =item Thread IDs
3638  
3639  =item Are These Threads The Same?
3640  
3641  =item What Threads Are Running?
3642  
3643  =back
3644  
3645  =item A Complete Example
3646  
3647  =item Conclusion
3648  
3649  =item Bibliography
3650  
3651  =over 4
3652  
3653  =item Introductory Texts
3654  
3655  =item OS-Related References
3656  
3657  =item Other References
3658  
3659  =back
3660  
3661  =item Acknowledgements
3662  
3663  =item AUTHOR
3664  
3665  =item Copyrights
3666  
3667  =back
3668  
3669  =head2 perlport - Writing portable Perl
3670  
3671  =over 4
3672  
3673  =item DESCRIPTION
3674  
3675  Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3676  portable
3677  
3678  =item ISSUES
3679  
3680  =over 4
3681  
3682  =item Newlines
3683  
3684  =item Numbers endianness and Width
3685  
3686  =item Files and Filesystems
3687  
3688  =item System Interaction
3689  
3690  =item Command names versus file pathnames
3691  
3692  =item Networking
3693  
3694  =item Interprocess Communication (IPC)
3695  
3696  =item External Subroutines (XS)
3697  
3698  =item Standard Modules
3699  
3700  =item Time and Date
3701  
3702  =item Character sets and character encoding
3703  
3704  =item Internationalisation
3705  
3706  =item System Resources
3707  
3708  =item Security
3709  
3710  =item Style
3711  
3712  =back
3713  
3714  =item CPAN Testers
3715  
3716  =item PLATFORMS
3717  
3718  =over 4
3719  
3720  =item Unix
3721  
3722  =item DOS and Derivatives
3723  
3724  =item S<Mac OS>
3725  
3726  =item VMS
3727  
3728  =item VOS
3729  
3730  =item EBCDIC Platforms
3731  
3732  =item Acorn RISC OS
3733  
3734  =item Other perls
3735  
3736  =back
3737  
3738  =item FUNCTION IMPLEMENTATIONS
3739  
3740  =over 4
3741  
3742  =item Alphabetical Listing of Perl Functions
3743  
3744  -I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
3745  dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3746  getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3747  getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3748  gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3749  setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3750  endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3751  gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3752  msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3753  semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3754  setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3755  stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3756  wait, waitpid
3757  
3758  =back
3759  
3760  =item Supported Platforms
3761  
3762  =item SEE ALSO
3763  
3764  =item AUTHORS / CONTRIBUTORS
3765  
3766  =back
3767  
3768  =head2 perllocale - Perl locale handling (internationalization and
3769  localization)
3770  
3771  =over 4
3772  
3773  =item DESCRIPTION
3774  
3775  =item PREPARING TO USE LOCALES
3776  
3777  =item USING LOCALES
3778  
3779  =over 4
3780  
3781  =item The use locale pragma
3782  
3783  =item The setlocale function
3784  
3785  =item Finding locales
3786  
3787  =item LOCALE PROBLEMS
3788  
3789  =item Temporarily fixing locale problems
3790  
3791  =item Permanently fixing locale problems
3792  
3793  =item Permanently fixing your system's locale configuration
3794  
3795  =item Fixing system locale configuration
3796  
3797  =item The localeconv function
3798  
3799  =item I18N::Langinfo
3800  
3801  =back
3802  
3803  =item LOCALE CATEGORIES
3804  
3805  =over 4
3806  
3807  =item Category LC_COLLATE: Collation
3808  
3809  =item Category LC_CTYPE: Character Types
3810  
3811  =item Category LC_NUMERIC: Numeric Formatting
3812  
3813  =item Category LC_MONETARY: Formatting of monetary amounts
3814  
3815  =item LC_TIME
3816  
3817  =item Other categories
3818  
3819  =back
3820  
3821  =item SECURITY
3822  
3823  =item ENVIRONMENT
3824  
3825  PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3826  LC_NUMERIC, LC_TIME, LANG
3827  
3828  =over 4
3829  
3830  =item Examples
3831  
3832  =back
3833  
3834  =item NOTES
3835  
3836  =over 4
3837  
3838  =item Backward compatibility
3839  
3840  =item I18N:Collate obsolete
3841  
3842  =item Sort speed and memory use impacts
3843  
3844  =item write() and LC_NUMERIC
3845  
3846  =item Freely available locale definitions
3847  
3848  =item I18n and l10n
3849  
3850  =item An imperfect standard
3851  
3852  =back
3853  
3854  =item Unicode and UTF-8
3855  
3856  =item BUGS
3857  
3858  =over 4
3859  
3860  =item Broken systems
3861  
3862  =back
3863  
3864  =item SEE ALSO
3865  
3866  =item HISTORY
3867  
3868  =back
3869  
3870  =head2 perluniintro - Perl Unicode introduction
3871  
3872  =over 4
3873  
3874  =item DESCRIPTION
3875  
3876  =over 4
3877  
3878  =item Unicode
3879  
3880  =item Perl's Unicode Support
3881  
3882  =item Perl's Unicode Model
3883  
3884  =item Unicode and EBCDIC
3885  
3886  =item Creating Unicode
3887  
3888  =item Handling Unicode
3889  
3890  =item Legacy Encodings
3891  
3892  =item Unicode I/O
3893  
3894  =item Displaying Unicode As Text
3895  
3896  =item Special Cases
3897  
3898  =item Advanced Topics
3899  
3900  =item Miscellaneous
3901  
3902  =item Questions With Answers
3903  
3904  =item Hexadecimal Notation
3905  
3906  =item Further Resources
3907  
3908  =back
3909  
3910  =item UNICODE IN OLDER PERLS
3911  
3912  =item SEE ALSO
3913  
3914  =item ACKNOWLEDGMENTS
3915  
3916  =item AUTHOR, COPYRIGHT, AND LICENSE
3917  
3918  =back
3919  
3920  =head2 perlunicode - Unicode support in Perl
3921  
3922  =over 4
3923  
3924  =item DESCRIPTION
3925  
3926  =over 4
3927  
3928  =item Important Caveats
3929  
3930  Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3931  enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3932  autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3933  
3934  =item Byte and Character Semantics
3935  
3936  =item Effects of Character Semantics
3937  
3938  =item Unicode Character Properties
3939  
3940  General Category, Bidirectional Character Types, Scripts, Extended property
3941  classes, Use of "Is" Prefix, Blocks
3942  
3943  =item User-Defined Character Properties
3944  
3945  =item User-Defined Case Mappings
3946  
3947  =item Character Encodings for Input and Output
3948  
3949  =item Unicode Regular Expression Support Level
3950  
3951  =item Unicode Encodings
3952  
3953  =item Security Implications of Unicode
3954  
3955  =item Unicode in Perl on EBCDIC
3956  
3957  =item Locales
3958  
3959  =item When Unicode Does Not Happen
3960  
3961  =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3962  
3963  =item Using Unicode in XS
3964  
3965  =back
3966  
3967  =item BUGS
3968  
3969  =over 4
3970  
3971  =item Interaction with Locales
3972  
3973  =item Interaction with Extensions
3974  
3975  =item Speed
3976  
3977  =item Porting code from perl-5.6.X
3978  
3979  =back
3980  
3981  =item SEE ALSO
3982  
3983  =back
3984  
3985  =head2 perlunifaq - Perl Unicode FAQ
3986  
3987  =over 4
3988  
3989  =item Q and A
3990  
3991  =over 4
3992  
3993  =item perlunitut isn't really a Unicode tutorial, is it?
3994  
3995  =item What character encodings does Perl support?
3996  
3997  =item Which version of perl should I use?
3998  
3999  =item What about binary data, like images?
4000  
4001  =item When should I decode or encode?
4002  
4003  =item What if I don't decode?
4004  
4005  =item What if I don't encode?
4006  
4007  =item Is there a way to automatically decode or encode?
4008  
4009  =item What if I don't know which encoding was used?
4010  
4011  =item Can I use Unicode in my Perl sources?
4012  
4013  =item Data::Dumper doesn't restore the UTF8 flag; is it broken?
4014  
4015  =item Why do regex character classes sometimes match only in the ASCII
4016  range?
4017  
4018  =item Why do some characters not uppercase or lowercase correctly?
4019  
4020  =item How can I determine if a string is a text string or a binary string?
4021  
4022  =item How do I convert from encoding FOO to encoding BAR?
4023  
4024  =item What are C<decode_utf8> and C<encode_utf8>?
4025  
4026  =item What is a "wide character"?
4027  
4028  =back
4029  
4030  =item INTERNALS
4031  
4032  =over 4
4033  
4034  =item What is "the UTF8 flag"?
4035  
4036  =item What about the C<use bytes> pragma?
4037  
4038  =item What about the C<use encoding> pragma?
4039  
4040  =item What is the difference between C<:encoding> and C<:utf8>?
4041  
4042  =item What's the difference between C<UTF-8> and C<utf8>?
4043  
4044  =item I lost track; what encoding is the internal format really?
4045  
4046  =back
4047  
4048  =item AUTHOR
4049  
4050  =item SEE ALSO
4051  
4052  =back
4053  
4054  =head2 perlunitut - Perl Unicode Tutorial
4055  
4056  =over 4
4057  
4058  =item DESCRIPTION
4059  
4060  =over 4
4061  
4062  =item Definitions
4063  
4064  =item Your new toolkit
4065  
4066  =item I/O flow (the actual 5 minute tutorial)
4067  
4068  =back
4069  
4070  =item SUMMARY
4071  
4072  =item Q and A (or FAQ)
4073  
4074  =item ACKNOWLEDGEMENTS
4075  
4076  =item AUTHOR
4077  
4078  =item SEE ALSO
4079  
4080  =back
4081  
4082  =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
4083  
4084  =over 4
4085  
4086  =item DESCRIPTION
4087  
4088  =item COMMON CHARACTER CODE SETS
4089  
4090  =over 4
4091  
4092  =item ASCII
4093  
4094  =item ISO 8859
4095  
4096  =item Latin 1 (ISO 8859-1)
4097  
4098  =item EBCDIC
4099  
4100  =item 13 variant characters
4101  
4102  =item 0037
4103  
4104  =item 1047
4105  
4106  =item POSIX-BC
4107  
4108  =item Unicode code points versus EBCDIC code points
4109  
4110  =item Remaining Perl Unicode problems in EBCDIC
4111  
4112  =item Unicode and UTF
4113  
4114  =item Using Encode
4115  
4116  =back
4117  
4118  =item SINGLE OCTET TABLES
4119  
4120  recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
4121  
4122  =item IDENTIFYING CHARACTER CODE SETS
4123  
4124  =item CONVERSIONS
4125  
4126  =over 4
4127  
4128  =item tr///
4129  
4130  =item iconv
4131  
4132  =item C RTL
4133  
4134  =back
4135  
4136  =item OPERATOR DIFFERENCES
4137  
4138  =item FUNCTION DIFFERENCES
4139  
4140  chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
4141  
4142  =item REGULAR EXPRESSION DIFFERENCES
4143  
4144  =item SOCKETS
4145  
4146  =item SORTING
4147  
4148  =over 4
4149  
4150  =item Ignore ASCII vs. EBCDIC sort differences.
4151  
4152  =item MONO CASE then sort data.
4153  
4154  =item Convert, sort data, then re convert.
4155  
4156  =item Perform sorting on one type of machine only.
4157  
4158  =back
4159  
4160  =item TRANSFORMATION FORMATS
4161  
4162  =over 4
4163  
4164  =item URL decoding and encoding
4165  
4166  =item uu encoding and decoding
4167  
4168  =item Quoted-Printable encoding and decoding
4169  
4170  =item Caesarian ciphers
4171  
4172  =back
4173  
4174  =item Hashing order and checksums
4175  
4176  =item I18N AND L10N
4177  
4178  =item MULTI OCTET CHARACTER SETS
4179  
4180  =item OS ISSUES
4181  
4182  =over 4
4183  
4184  =item OS/400
4185  
4186  PASE, IFS access
4187  
4188  =item OS/390, z/OS
4189  
4190  chcp, dataset access, OS/390, z/OS iconv, locales
4191  
4192  =item VM/ESA?
4193  
4194  =item POSIX-BC?
4195  
4196  =back
4197  
4198  =item BUGS
4199  
4200  =item SEE ALSO
4201  
4202  =item REFERENCES
4203  
4204  =item HISTORY
4205  
4206  =item AUTHOR
4207  
4208  =back
4209  
4210  =head2 perlsec - Perl security
4211  
4212  =over 4
4213  
4214  =item DESCRIPTION
4215  
4216  =over 4
4217  
4218  =item Laundering and Detecting Tainted Data
4219  
4220  =item Switches On the "#!" Line
4221  
4222  =item Taint mode and @INC
4223  
4224  =item Cleaning Up Your Path
4225  
4226  =item Security Bugs
4227  
4228  =item Protecting Your Programs
4229  
4230  =item Unicode
4231  
4232  =item Algorithmic Complexity Attacks
4233  
4234  =back
4235  
4236  =item SEE ALSO
4237  
4238  =back
4239  
4240  =head2 perlmod - Perl modules (packages and symbol tables)
4241  
4242  =over 4
4243  
4244  =item DESCRIPTION
4245  
4246  =over 4
4247  
4248  =item Packages
4249  X<package> X<namespace> X<variable, global> X<global variable> X<global>
4250  
4251  =item Symbol Tables
4252  X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
4253  
4254  =item BEGIN, UNITCHECK, CHECK, INIT and END
4255  X<BEGIN> X<UNITCHECK> X<CHECK> X<INIT> X<END>
4256  
4257  =item Perl Classes
4258  X<class> X<@ISA>
4259  
4260  =item Perl Modules
4261  X<module>
4262  
4263  =item Making your module threadsafe
4264  X<threadsafe> X<thread safe>
4265  X<module, threadsafe> X<module, thread safe>
4266  X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
4267  
4268  =back
4269  
4270  =item SEE ALSO
4271  
4272  =back
4273  
4274  =head2 perlmodlib - constructing new Perl modules and finding existing ones
4275  
4276  =over 4
4277  
4278  =item THE PERL MODULE LIBRARY
4279  
4280  =over 4
4281  
4282  =item Pragmatic Modules
4283  
4284  attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
4285  charnames, constant, diagnostics, encoding, encoding::warnings, feature,
4286  fields, filetest, if, integer, less, lib, locale, mro, open, ops, overload,
4287  re, sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars,
4288  version, vmsish, warnings, warnings::register
4289  
4290  =item Standard Modules
4291  
4292  AnyDBM_File, Archive::Extract, Archive::Tar, Archive::Tar::File,
4293  Attribute::Handlers, AutoLoader, AutoSplit, B, B::Concise, B::Debug,
4294  B::Deparse, B::Lint, B::Showlex, B::Terse, B::Xref, Benchmark, CGI,
4295  CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
4296  CGI::Switch, CGI::Util, CORE, CPAN, CPAN::API::HOWTO, CPAN::FirstTime,
4297  CPAN::Kwalify, CPAN::Nox, CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base,
4298  CPANPLUS::Dist::Sample, CPANPLUS::Shell::Classic,
4299  CPANPLUS::Shell::Default::Plugins::HOWTO, Carp, Carp::Heavy, Class::ISA,
4300  Class::Struct, Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB,
4301  DBM_Filter, DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32,
4302  DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf,
4303  Devel::InnerPackage, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
4304  Digest::SHA, Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader,
4305  Encode, Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
4306  Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
4307  Encode::Encoding, Encode::GSM0338, Encode::Guess, Encode::JP,
4308  Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR,
4309  Encode::MIME::Header, Encode::MIME::Name, Encode::PerlIO,
4310  Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
4311  Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
4312  ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
4313  ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
4314  ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
4315  ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
4316  ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
4317  ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
4318  ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
4319  ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
4320  ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4321  ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4322  ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4323  ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4324  ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4325  ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4326  File::Compare, File::Copy, File::DosGlob, File::Fetch, File::Find,
4327  File::Glob, File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin,
4328  File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2,
4329  File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp,
4330  File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call,
4331  FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util,
4332  Hash::Util::FieldHash, I18N::Collate, I18N::LangTags,
4333  I18N::LangTags::Detect, I18N::LangTags::List, I18N::Langinfo, IO,
4334  IO::Compress::Base, IO::Compress::Deflate, IO::Compress::Gzip,
4335  IO::Compress::RawDeflate, IO::Compress::Zip, IO::Dir, IO::File, IO::Handle,
4336  IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4337  IO::Socket::UNIX, IO::Uncompress::AnyInflate,
4338  IO::Uncompress::AnyUncompress, IO::Uncompress::Base,
4339  IO::Uncompress::Gunzip, IO::Uncompress::Inflate,
4340  IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Cmd,
4341  IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore,
4342  List::Util, Locale::Constants, Locale::Country, Locale::Currency,
4343  Locale::Language, Locale::Maketext, Locale::Maketext::Simple,
4344  Locale::Maketext::TPJ13, Locale::Script, Log::Message,
4345  Log::Message::Config, Log::Message::Handlers, Log::Message::Item,
4346  MIME::Base64, MIME::QuotedPrint, Math::BigFloat, Math::BigInt,
4347  Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc,
4348  Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
4349  Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
4350  Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, Module::Build,
4351  Module::Build::API, Module::Build::Authoring, Module::Build::Base,
4352  Module::Build::Compat, Module::Build::ConfigData, Module::Build::Cookbook,
4353  Module::Build::ModuleInfo, Module::Build::Notes, Module::Build::PPMMaker,
4354  Module::Build::Platform::Amiga, Module::Build::Platform::Default,
4355  Module::Build::Platform::EBCDIC, Module::Build::Platform::MPEiX,
4356  Module::Build::Platform::MacOS, Module::Build::Platform::RiscOS,
4357  Module::Build::Platform::Unix, Module::Build::Platform::VMS,
4358  Module::Build::Platform::VOS, Module::Build::Platform::Windows,
4359  Module::Build::Platform::aix, Module::Build::Platform::cygwin,
4360  Module::Build::Platform::darwin, Module::Build::Platform::os2,
4361  Module::Build::YAML, Module::CoreList, Module::Load,
4362  Module::Load::Conditional, Module::Loaded, Module::Pluggable,
4363  Module::Pluggable::Object, NDBM_File, NEXT, Net::Cmd, Net::Config,
4364  Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping,
4365  Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
4366  Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
4367  Package::Constants, Params::Check, PerlIO, PerlIO::encoding,
4368  PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
4369  Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4370  Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4371  Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4372  Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4373  Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4374  Pod::Select, Pod::Simple, Pod::Simple::Checker, Pod::Simple::Debug,
4375  Pod::Simple::DumpAsText, Pod::Simple::DumpAsXML, Pod::Simple::HTML,
4376  Pod::Simple::HTMLBatch, Pod::Simple::LinkSection, Pod::Simple::Methody,
4377  Pod::Simple::PullParser, Pod::Simple::PullParserEndToken,
4378  Pod::Simple::PullParserStartToken, Pod::Simple::PullParserTextToken,
4379  Pod::Simple::PullParserToken, Pod::Simple::RTF, Pod::Simple::Search,
4380  Pod::Simple::SimpleTree, Pod::Simple::Subclassing, Pod::Simple::Text,
4381  Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
4382  Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
4383  SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
4384  Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
4385  Sys::Syslog::win32::Win32, Term::ANSIColor, Term::Cap, Term::Complete,
4386  Term::ReadLine, Term::UI, Test, Test::Builder, Test::Builder::Module,
4387  Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness,
4388  Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point,
4389  Test::Harness::Results, Test::Harness::Straps, Test::Harness::TAP,
4390  Test::Harness::Util, Test::More, Test::Simple, Test::Tutorial,
4391  Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
4392  Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Tie::Array,
4393  Tie::File, Tie::Handle, Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize,
4394  Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local,
4395  Time::Piece, Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm,
4396  UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
4397  User::pwent, Win32, Win32API::File, Win32CORE, XS::APItest, XS::Typemap,
4398  XSLoader
4399  
4400  =item Extension Modules
4401  
4402  =back
4403  
4404  =item CPAN
4405  
4406  =over 4
4407  
4408  =item Africa
4409  
4410  South Africa
4411  
4412  =item Asia
4413  
4414  China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4415  Arabia, Singapore, South Korea, Taiwan, Thailand
4416  
4417  =item Central America
4418  
4419  Costa Rica
4420  
4421  =item Europe
4422  
4423  Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4424  Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4425  Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4426  Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4427  Turkey, Ukraine, United Kingdom
4428  
4429  =item North America
4430  
4431  Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4432  Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4433  Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4434  North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4435  Virginia, Washington, Wisconsin
4436  
4437  =item Oceania
4438  
4439  Australia, New Zealand, United States
4440  
4441  =item South America
4442  
4443  Argentina, Brazil, Chile
4444  
4445  =item RSYNC Mirrors
4446  
4447  =back
4448  
4449  =item Modules: Creation, Use, and Abuse
4450  
4451  =over 4
4452  
4453  =item Guidelines for Module Creation
4454  
4455  =item Guidelines for Converting Perl 4 Library Scripts into Modules
4456  
4457  =item Guidelines for Reusing Application Code
4458  
4459  =back
4460  
4461  =item NOTE
4462  
4463  =back
4464  
4465  =head2 perlmodstyle - Perl module style guide
4466  
4467  =over 4
4468  
4469  =item INTRODUCTION
4470  
4471  =item QUICK CHECKLIST
4472  
4473  =over 4
4474  
4475  =item Before you start
4476  
4477  =item The API
4478  
4479  =item Stability
4480  
4481  =item Documentation
4482  
4483  =item Release considerations
4484  
4485  =back
4486  
4487  =item BEFORE YOU START WRITING A MODULE
4488  
4489  =over 4
4490  
4491  =item Has it been done before?
4492  
4493  =item Do one thing and do it well
4494  
4495  =item What's in a name?
4496  
4497  =back
4498  
4499  =item DESIGNING AND WRITING YOUR MODULE
4500  
4501  =over 4
4502  
4503  =item To OO or not to OO?
4504  
4505  =item Designing your API
4506  
4507  Write simple routines to do simple things, Separate functionality from
4508  output, Provide sensible shortcuts and defaults, Naming conventions,
4509  Parameter passing
4510  
4511  =item Strictness and warnings
4512  
4513  =item Backwards compatibility
4514  
4515  =item Error handling and messages
4516  
4517  =back
4518  
4519  =item DOCUMENTING YOUR MODULE
4520  
4521  =over 4
4522  
4523  =item POD
4524  
4525  =item README, INSTALL, release notes, changelogs
4526  
4527  perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4528  perl Build test, perl Build install
4529  
4530  =back
4531  
4532  =item RELEASE CONSIDERATIONS
4533  
4534  =over 4
4535  
4536  =item Version numbering
4537  
4538  =item Pre-requisites
4539  
4540  =item Testing
4541  
4542  =item Packaging
4543  
4544  =item Licensing
4545  
4546  =back
4547  
4548  =item COMMON PITFALLS
4549  
4550  =over 4
4551  
4552  =item Reinventing the wheel
4553  
4554  =item Trying to do too much
4555  
4556  =item Inappropriate documentation
4557  
4558  =back
4559  
4560  =item SEE ALSO
4561  
4562  L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4563  Testing tools, http://pause.perl.org/, Any good book on software
4564  engineering
4565  
4566  =item AUTHOR
4567  
4568  =back
4569  
4570  =head2 perlmodinstall - Installing CPAN Modules
4571  
4572  =over 4
4573  
4574  =item DESCRIPTION
4575  
4576  =over 4
4577  
4578  =item PREAMBLE
4579  
4580  B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4581  module (sometimes unnecessary), B<INSTALL> the module
4582  
4583  =back
4584  
4585  =item PORTABILITY
4586  
4587  =item HEY
4588  
4589  =item AUTHOR
4590  
4591  =item COPYRIGHT
4592  
4593  =back
4594  
4595  =head2 perlnewmod - preparing a new module for distribution
4596  
4597  =over 4
4598  
4599  =item DESCRIPTION
4600  
4601  =over 4
4602  
4603  =item Warning
4604  
4605  =item What should I make into a module?
4606  
4607  =item Step-by-step: Preparing the ground
4608  
4609  Look around, Check it's new, Discuss the need, Choose a name, Check again
4610  
4611  =item Step-by-step: Making the module
4612  
4613  Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4614  L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4615  Use L<plain old documentation|perlpod>, Write tests, Write the README
4616  
4617  =item Step-by-step: Distributing your module
4618  
4619  Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4620  tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4621  
4622  =back
4623  
4624  =item AUTHOR
4625  
4626  =item SEE ALSO
4627  
4628  =back
4629  
4630  =head2 perlpragma - how to write a user pragma
4631  
4632  =over 4
4633  
4634  =item DESCRIPTION
4635  
4636  =item A basic example
4637  
4638  =item Implementation details
4639  
4640  =back
4641  
4642  =head2 perlutil - utilities packaged with the Perl distribution
4643  
4644  =over 4
4645  
4646  =item DESCRIPTION
4647  
4648  =item LIST OF UTILITIES
4649  
4650  =over 4
4651  
4652  =item Documentation
4653  
4654  L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4655  L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4656  L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4657  L<roffitall|roffitall>
4658  
4659  =item Convertors
4660  
4661  L<a2p|a2p>, L<s2p|s2p> and L<psed>, L<find2perl|find2perl>
4662  
4663  =item Administration
4664  
4665  L<config_data|config_data>, L<libnetcfg|libnetcfg>, L<perlivp>
4666  
4667  =item Development
4668  
4669  L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4670  L<h2xs|h2xs>, L<enc2xs>, L<xsubpp>, L<dprofpp|dprofpp>, L<prove>,
4671  L<corelist>
4672  
4673  =item General tools
4674  
4675  L<piconv>, L<ptar>, L<ptardiff>, L<shasum>
4676  
4677  =item Installation
4678  
4679  L<cpan>, L<cpanp>, L<cpan2dist>, L<instmodsh>
4680  
4681  =back
4682  
4683  =item SEE ALSO
4684  
4685  =back
4686  
4687  =head2 perlcompile - Introduction to the Perl Compiler-Translator 
4688  
4689  =over 4
4690  
4691  =item DESCRIPTION
4692  
4693  =over 4
4694  
4695  =item Layout
4696  
4697  B::Lint, B::Deparse, B::Xref
4698  
4699  =back
4700  
4701  =item Using The Back Ends
4702  
4703  =over 4
4704  
4705  =item The Cross Referencing Back End
4706  
4707  i, &, s, r
4708  
4709  =item The Decompiling Back End
4710  
4711  =item The Lint Back End
4712  
4713  =back
4714  
4715  =item Module List for the Compiler Suite
4716  
4717  B, O, B::Concise, B::Debug, B::Deparse, B::Lint, B::Showlex, B::Terse,
4718  B::Xref
4719  
4720  =item KNOWN PROBLEMS
4721  
4722  =item AUTHOR
4723  
4724  =back
4725  
4726  =head2 perlfilter - Source Filters
4727  
4728  =over 4
4729  
4730  =item DESCRIPTION
4731  
4732  =item CONCEPTS
4733  
4734  =item USING FILTERS
4735  
4736  =item WRITING A SOURCE FILTER
4737  
4738  =item WRITING A SOURCE FILTER IN C
4739  
4740  B<Decryption Filters>
4741  
4742  =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4743  
4744  =item WRITING A SOURCE FILTER IN PERL
4745  
4746  =item USING CONTEXT: THE DEBUG FILTER
4747  
4748  =item CONCLUSION
4749  
4750  =item THINGS TO LOOK OUT FOR
4751  
4752  Some Filters Clobber the C<DATA> Handle
4753  
4754  =item REQUIREMENTS
4755  
4756  =item AUTHOR
4757  
4758  =item Copyrights
4759  
4760  =back
4761  
4762  =head2 perlglossary - Perl Glossary
4763  
4764  =over 4
4765  
4766  =item DESCRIPTION
4767  
4768  =over 4
4769  
4770  =item A
4771  
4772  accessor methods, actual arguments, address operator, algorithm, alias,
4773  alternatives, anonymous, architecture, argument, ARGV, arithmetical
4774  operator, array, array context, ASCII, assertion, assignment, assignment
4775  operator, associative array, associativity, asynchronous, atom, atomic
4776  operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4777  autovivification, AV, awk
4778  
4779  =item B
4780  
4781  backreference, backtracking, backward compatibility, bareword, base class,
4782  big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4783  bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4784  broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4785  
4786  =item C
4787  
4788  C, C preprocessor, call by reference, call by value, callback, canonical,
4789  capturing, character, character class, character property, circumfix
4790  operator, class, class method, client, cloister, closure, cluster, CODE,
4791  code generator, code subpattern, collating sequence, command, command
4792  buffering, command name, command-line arguments, comment, compilation unit,
4793  compile phase, compile time, compiler, composer, concatenation,
4794  conditional, connection, construct, constructor, context, continuation,
4795  core dump, CPAN, cracker, current package, current working directory,
4796  currently selected output channel, CV
4797  
4798  =item D
4799  
4800  dangling statement, data structure, data type, datagram, DBM, declaration,
4801  decrement, default, defined, delimiter, deprecated modules and features,
4802  dereference, derived class, descriptor, destroy, destructor, device,
4803  directive, directory, directory handle, dispatch, distribution, (to be)
4804  dropped modules, dweomer, dwimmer, dynamic scoping
4805  
4806  =item E
4807  
4808  eclectic, element, embedding, empty subclass test, en passant,
4809  encapsulation, endian, environment, environment variable, EOF, errno,
4810  error, escape sequence, exception, exception handling, exec, executable
4811  file, execute, execute bit, exit status, export, expression, extension
4812  
4813  =item F
4814  
4815  false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4816  operator, fileglob, filehandle, filename, filesystem, filter, flag,
4817  floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4818  available, freely redistributable, freeware, function, funny character,
4819  garbage collection
4820  
4821  =item G
4822  
4823  GID, glob, global, global destruction, glue language, granularity, greedy,
4824  grep, group, GV
4825  
4826  =item H
4827  
4828  hacker, handler, hard reference, hash, hash table, header file, here
4829  document, hexadecimal, home directory, host, hubris, HV
4830  
4831  =item I
4832  
4833  identifier, impatience, implementation, import, increment, indexing,
4834  indirect filehandle, indirect object, indirect object slot, indirection,
4835  infix, inheritance, instance, instance variable, integer, interface,
4836  interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4837  iteration, iterator, IV
4838  
4839  =item J
4840  
4841  JAPH
4842  
4843  =item K
4844  
4845  key, keyword
4846  
4847  =item L
4848  
4849  label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4850  analysis, lexical scoping, lexical variable, library, LIFO, line, line
4851  buffering, line number, link, LIST, list, list context, list operator, list
4852  value, literal, little-endian, local, logical operator, lookahead,
4853  lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4854  lvalue modifier
4855  
4856  =item M
4857  
4858  magic, magical increment, magical variables, Makefile, man, manpage,
4859  matching, member data, memory, metacharacter, metasymbol, method,
4860  minimalism, mode, modifier, module, modulus, monger, mortal,
4861  multidimensional array, multiple inheritance
4862  
4863  =item N
4864  
4865  named pipe, namespace, network address, newline, NFS, null character, null
4866  list, null string, numeric context, NV, nybble
4867  
4868  =item O
4869  
4870  object, octal, offset, one-liner, open source software, operand, operating
4871  system, operator, operator overloading, options, overloading, overriding,
4872  owner
4873  
4874  =item P
4875  
4876  package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4877  pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4878  platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4879  postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4880  program generator, progressive matching, property, protocol, prototype,
4881  pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4882  pumpking, PV
4883  
4884  =item Q
4885  
4886  qualified, quantifier
4887  
4888  =item R
4889  
4890  readable, reaping, record, recursion, reference, referent, regex, regular
4891  expression, regular expression modifier, regular file, relational operator,
4892  reserved words, return value, RFC, right shift, root, RTFM, run phase, run
4893  time, run-time pattern, RV, rvalue
4894  
4895  =item S
4896  
4897  scalar, scalar context, scalar literal, scalar value, scalar variable,
4898  scope, scratchpad, script, script kiddie, sed, semaphore, separator,
4899  serialization, server, service, setgid, setuid, shared memory, shebang,
4900  shell, side effects, signal, signal handler, single inheritance, slice,
4901  slurp, socket, soft reference, source filter, stack, standard, standard
4902  error, standard I/O, standard input, standard output, stat structure,
4903  statement, statement modifier, static, static method, static scoping,
4904  static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
4905  string context, stringification, struct, structure, subclass, subpattern,
4906  subroutine, subscript, substitution, substring, superclass, superuser, SV,
4907  switch, switch cluster, switch statement, symbol, symbol table, symbolic
4908  debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
4909  syntax, syntax tree, syscall
4910  
4911  =item T
4912  
4913  tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
4914  token, tokener, tokenizing, toolbox approach, transliterate, trigger,
4915  trinary, troff, true, truncating, type, type casting, typed lexical,
4916  typedef, typeglob, typemap
4917  
4918  =item U
4919  
4920  UDP, UID, umask, unary operator, Unicode, Unix
4921  
4922  =item V
4923  
4924  value, variable, variable interpolation, variadic, vector, virtual, void
4925  context, v-string
4926  
4927  =item W
4928  
4929  warning, watch expression, whitespace, word, working directory, wrapper,
4930  WYSIWYG
4931  
4932  =item X
4933  
4934  XS, XSUB
4935  
4936  =item Y
4937  
4938  yacc
4939  
4940  =item Z
4941  
4942  zero width, zombie
4943  
4944  =back
4945  
4946  =item AUTHOR AND COPYRIGHT
4947  
4948  =back
4949  
4950  =head2 perlembed - how to embed perl in your C program
4951  
4952  =over 4
4953  
4954  =item DESCRIPTION
4955  
4956  =over 4
4957  
4958  =item PREAMBLE
4959  
4960  B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4961  Perl?>, B<Use C from C?>, B<Use Perl from C?>
4962  
4963  =item ROADMAP
4964  
4965  =item Compiling your C program
4966  
4967  =item Adding a Perl interpreter to your C program
4968  
4969  =item Calling a Perl subroutine from your C program
4970  
4971  =item Evaluating a Perl statement from your C program
4972  
4973  =item Performing Perl pattern matches and substitutions from your C program
4974  
4975  =item Fiddling with the Perl stack from your C program
4976  
4977  =item Maintaining a persistent interpreter
4978  
4979  =item Execution of END blocks
4980  
4981  =item $0 assignments
4982  
4983  =item Maintaining multiple interpreter instances
4984  
4985  =item Using Perl modules, which themselves use C libraries, from your C
4986  program
4987  
4988  =back
4989  
4990  =item Embedding Perl under Win32
4991  
4992  =item Hiding Perl_
4993  
4994  =item MORAL
4995  
4996  =item AUTHOR
4997  
4998  =item COPYRIGHT
4999  
5000  =back
5001  
5002  =head2 perldebguts - Guts of Perl debugging 
5003  
5004  =over 4
5005  
5006  =item DESCRIPTION
5007  
5008  =item Debugger Internals
5009  
5010  =over 4
5011  
5012  =item Writing Your Own Debugger
5013  
5014  =back
5015  
5016  =item Frame Listing Output Examples
5017  
5018  =item Debugging regular expressions
5019  
5020  =over 4
5021  
5022  =item Compile-time output
5023  
5024  C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
5025  I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
5026  I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
5027  C<anchored(TYPE)>
5028  
5029  =item Types of nodes
5030  
5031  =item Run-time output
5032  
5033  =back
5034  
5035  =item Debugging Perl memory usage
5036  
5037  =over 4
5038  
5039  =item Using C<$ENV{PERL_DEBUG_MSTATS}>
5040  
5041  C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
5042  SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
5043  6144>
5044  
5045  =back
5046  
5047  =item SEE ALSO
5048  
5049  =back
5050  
5051  =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
5052  
5053  =over 4
5054  
5055  =item DESCRIPTION
5056  
5057  =item SPECIAL NOTES
5058  
5059  =over 4
5060  
5061  =item make
5062  
5063  =item Version caveat
5064  
5065  =item Dynamic Loading versus Static Loading
5066  
5067  =back
5068  
5069  =item TUTORIAL
5070  
5071  =over 4
5072  
5073  =item EXAMPLE 1
5074  
5075  =item EXAMPLE 2
5076  
5077  =item What has gone on?
5078  
5079  =item Writing good test scripts
5080  
5081  =item EXAMPLE 3
5082  
5083  =item What's new here?
5084  
5085  =item Input and Output Parameters
5086  
5087  =item The XSUBPP Program
5088  
5089  =item The TYPEMAP file
5090  
5091  =item Warning about Output Arguments
5092  
5093  =item EXAMPLE 4
5094  
5095  =item What has happened here?
5096  
5097  =item Anatomy of .xs file
5098  
5099  =item Getting the fat out of XSUBs
5100  
5101  =item More about XSUB arguments
5102  
5103  =item The Argument Stack
5104  
5105  =item Extending your Extension
5106  
5107  =item Documenting your Extension
5108  
5109  =item Installing your Extension
5110  
5111  =item EXAMPLE 5
5112  
5113  =item New Things in this Example
5114  
5115  =item EXAMPLE 6
5116  
5117  =item New Things in this Example
5118  
5119  =item EXAMPLE 7 (Coming Soon)
5120  
5121  =item EXAMPLE 8 (Coming Soon)
5122  
5123  =item EXAMPLE 9 Passing open files to XSes
5124  
5125  =item Troubleshooting these Examples
5126  
5127  =back
5128  
5129  =item See also
5130  
5131  =item Author
5132  
5133  =over 4
5134  
5135  =item Last Changed
5136  
5137  =back
5138  
5139  =back
5140  
5141  =head2 perlxs - XS language reference manual
5142  
5143  =over 4
5144  
5145  =item DESCRIPTION
5146  
5147  =over 4
5148  
5149  =item Introduction
5150  
5151  =item On The Road
5152  
5153  =item The Anatomy of an XSUB
5154  
5155  =item The Argument Stack
5156  
5157  =item The RETVAL Variable
5158  
5159  =item Returning SVs, AVs and HVs through RETVAL
5160  
5161  =item The MODULE Keyword
5162  
5163  =item The PACKAGE Keyword
5164  
5165  =item The PREFIX Keyword
5166  
5167  =item The OUTPUT: Keyword
5168  
5169  =item The NO_OUTPUT Keyword
5170  
5171  =item The CODE: Keyword
5172  
5173  =item The INIT: Keyword
5174  
5175  =item The NO_INIT Keyword
5176  
5177  =item Initializing Function Parameters
5178  
5179  =item Default Parameter Values
5180  
5181  =item The PREINIT: Keyword
5182  
5183  =item The SCOPE: Keyword
5184  
5185  =item The INPUT: Keyword
5186  
5187  =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
5188  
5189  =item The C<length(NAME)> Keyword
5190  
5191  =item Variable-length Parameter Lists
5192  
5193  =item The C_ARGS: Keyword
5194  
5195  =item The PPCODE: Keyword
5196  
5197  =item Returning Undef And Empty Lists
5198  
5199  =item The REQUIRE: Keyword
5200  
5201  =item The CLEANUP: Keyword
5202  
5203  =item The POSTCALL: Keyword
5204  
5205  =item The BOOT: Keyword
5206  
5207  =item The VERSIONCHECK: Keyword
5208  
5209  =item The PROTOTYPES: Keyword
5210  
5211  =item The PROTOTYPE: Keyword
5212  
5213  =item The ALIAS: Keyword
5214  
5215  =item The OVERLOAD: Keyword
5216  
5217  =item The FALLBACK: Keyword
5218  
5219  =item The INTERFACE: Keyword
5220  
5221  =item The INTERFACE_MACRO: Keyword
5222  
5223  =item The INCLUDE: Keyword
5224  
5225  =item The CASE: Keyword
5226  
5227  =item The & Unary Operator
5228  
5229  =item Inserting POD, Comments and C Preprocessor Directives
5230  
5231  =item Using XS With C++
5232  
5233  =item Interface Strategy
5234  
5235  =item Perl Objects And C Structures
5236  
5237  =item The Typemap
5238  
5239  =item Safely Storing Static Data in XS
5240  
5241  MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT,
5242  aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl),
5243  dMY_CXT_INTERP(my_perl)
5244  
5245  =item Thread-aware system interfaces
5246  
5247  =back
5248  
5249  =item EXAMPLES
5250  
5251  =item XS VERSION
5252  
5253  =item AUTHOR
5254  
5255  =back
5256  
5257  =head2 perlclib - Internal replacements for standard C library functions
5258  
5259  =over 4
5260  
5261  =item DESCRIPTION
5262  
5263  =over 4
5264  
5265  =item Conventions
5266  
5267  C<t>, C<p>, C<n>, C<s>
5268  
5269  =item File Operations
5270  
5271  =item File Input and Output
5272  
5273  =item File Positioning
5274  
5275  =item Memory Management and String Handling
5276  
5277  =item Character Class Tests
5278  
5279  =item F<stdlib.h> functions
5280  
5281  =item Miscellaneous functions
5282  
5283  =back
5284  
5285  =item SEE ALSO
5286  
5287  =back
5288  
5289  =head2 perlguts - Introduction to the Perl API
5290  
5291  =over 4
5292  
5293  =item DESCRIPTION
5294  
5295  =item Variables
5296  
5297  =over 4
5298  
5299  =item Datatypes
5300  
5301  =item What is an "IV"?
5302  
5303  =item Working with SVs
5304  
5305  =item Offsets
5306  
5307  =item What's Really Stored in an SV?
5308  
5309  =item Working with AVs
5310  
5311  =item Working with HVs
5312  
5313  =item Hash API Extensions
5314  
5315  =item AVs, HVs and undefined values
5316  
5317  =item References
5318  
5319  =item Blessed References and Class Objects
5320  
5321  =item Creating New Variables
5322  
5323  GV_ADDMULTI, GV_ADDWARN
5324  
5325  =item Reference Counts and Mortality
5326  
5327  =item Stashes and Globs
5328  
5329  =item Double-Typed SVs
5330  
5331  =item Magic Variables
5332  
5333  =item Assigning Magic
5334  
5335  =item Magic Virtual Tables
5336  
5337  =item Finding Magic
5338  
5339  =item Understanding the Magic of Tied Hashes and Arrays
5340  
5341  =item Localizing changes
5342  
5343  C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5344  C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5345  *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5346  C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5347  C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5348  C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5349  save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5350  C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5351  C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5352  save_hptr(HV **hptr)>
5353  
5354  =back
5355  
5356  =item Subroutines
5357  
5358  =over 4
5359  
5360  =item XSUBs and the Argument Stack
5361  
5362  =item Calling Perl Routines from within C Programs
5363  
5364  =item Memory Allocation
5365  
5366  =item PerlIO
5367  
5368  =item Putting a C value on Perl stack
5369  
5370  =item Scratchpads
5371  
5372  =item Scratchpads and recursion
5373  
5374  =back
5375  
5376  =item Compiled code
5377  
5378  =over 4
5379  
5380  =item Code tree
5381  
5382  =item Examining the tree
5383  
5384  =item Compile pass 1: check routines
5385  
5386  =item Compile pass 1a: constant folding
5387  
5388  =item Compile pass 2: context propagation
5389  
5390  =item Compile pass 3: peephole optimization
5391  
5392  =item Pluggable runops
5393  
5394  =back
5395  
5396  =item Examining internal data structures with the C<dump> functions
5397  
5398  =item How multiple interpreters and concurrency are supported
5399  
5400  =over 4
5401  
5402  =item Background and PERL_IMPLICIT_CONTEXT
5403  
5404  =item So what happened to dTHR?
5405  
5406  =item How do I use all this in extensions?
5407  
5408  =item Should I do anything special if I call perl from multiple threads?
5409  
5410  =item Future Plans and PERL_IMPLICIT_SYS
5411  
5412  =back
5413  
5414  =item Internal Functions
5415  
5416  A, p, d, s, n, r, f, M, o, x, m, X, E, b, others
5417  
5418  =over 4
5419  
5420  =item Formatted Printing of IVs, UVs, and NVs
5421  
5422  =item Pointer-To-Integer and Integer-To-Pointer
5423  
5424  =item Exception Handling
5425  
5426  =item Source Documentation
5427  
5428  =item Backwards compatibility
5429  
5430  =back
5431  
5432  =item Unicode Support
5433  
5434  =over 4
5435  
5436  =item What B<is> Unicode, anyway?
5437  
5438  =item How can I recognise a UTF-8 string?
5439  
5440  =item How does UTF-8 represent Unicode characters?
5441  
5442  =item How does Perl store UTF-8 strings?
5443  
5444  =item How do I convert a string to UTF-8?
5445  
5446  =item Is there anything else I need to know?
5447  
5448  =back
5449  
5450  =item Custom Operators
5451  
5452  =item AUTHORS
5453  
5454  =item SEE ALSO
5455  
5456  =back
5457  
5458  =head2 perlcall - Perl calling conventions from C
5459  
5460  =over 4
5461  
5462  =item DESCRIPTION
5463  
5464  An Error Handler, An Event Driven Program
5465  
5466  =item THE CALL_ FUNCTIONS
5467  
5468  call_sv, call_pv, call_method, call_argv
5469  
5470  =item FLAG VALUES
5471  
5472  =over 4
5473  
5474  =item  G_VOID
5475  
5476  =item  G_SCALAR
5477  
5478  =item G_ARRAY
5479  
5480  =item G_DISCARD
5481  
5482  =item G_NOARGS
5483  
5484  =item G_EVAL
5485  
5486  =item G_KEEPERR
5487  
5488  =item Determining the Context
5489  
5490  =back
5491  
5492  =item EXAMPLES
5493  
5494  =over 4
5495  
5496  =item No Parameters, Nothing returned
5497  
5498  =item Passing Parameters
5499  
5500  =item Returning a Scalar
5501  
5502  =item Returning a list of values
5503  
5504  =item Returning a list in a scalar context
5505  
5506  =item Returning Data from Perl via the parameter list
5507  
5508  =item Using G_EVAL
5509  
5510  =item Using G_KEEPERR
5511  
5512  =item Using call_sv
5513  
5514  =item Using call_argv
5515  
5516  =item Using call_method
5517  
5518  =item Using GIMME_V
5519  
5520  =item Using Perl to dispose of temporaries
5521  
5522  =item Strategies for storing Callback Context Information
5523  
5524  1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5525  callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5526  callback
5527  
5528  =item Alternate Stack Manipulation
5529  
5530  =item Creating and calling an anonymous subroutine in C
5531  
5532  =back
5533  
5534  =item LIGHTWEIGHT CALLBACKS
5535  
5536  =item SEE ALSO
5537  
5538  =item AUTHOR
5539  
5540  =item DATE
5541  
5542  =back
5543  
5544  =head2 perlreapi - perl regular expression plugin interface
5545  
5546  =over 4
5547  
5548  =item DESCRIPTION
5549  
5550  =item Callbacks
5551  
5552  =over 4
5553  
5554  =item comp
5555  
5556  C</m> - RXf_PMf_MULTILINE, C</s> - RXf_PMf_SINGLELINE, C</i> -
5557  RXf_PMf_FOLD, C</x> - RXf_PMf_EXTENDED, C</p> - RXf_PMf_KEEPCOPY,
5558  RXf_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
5559  RXf_WHITE, RXf_NULL
5560  
5561  =item exec
5562  
5563  =item intuit
5564  
5565  =item checkstr
5566  
5567  =item free
5568  
5569  =item Numbered capture callbacks
5570  
5571  =item Named capture callbacks
5572  
5573  =item qr_package
5574  
5575  =item dupe
5576  
5577  =back
5578  
5579  =item The REGEXP structure
5580  
5581  =over 4
5582  
5583  =item C<engine>
5584  
5585  =item C<mother_re>
5586  
5587  =item C<extflags>
5588  
5589  =item C<minlen> C<minlenret>
5590  
5591  =item C<gofs>
5592  
5593  =item C<substrs>
5594  
5595  =item C<nparens>, C<lasparen>, and C<lastcloseparen>
5596  
5597  =item C<intflags>
5598  
5599  =item C<pprivate>
5600  
5601  =item C<swap>
5602  
5603  =item C<offs>
5604  
5605  =item C<precomp> C<prelen>
5606  
5607  =item C<paren_names>
5608  
5609  =item C<substrs>
5610  
5611  =item C<subbeg> C<sublen> C<saved_copy>
5612  
5613  =item C<wrapped> C<wraplen>
5614  
5615  =item C<seen_evals>
5616  
5617  =item C<refcnt>
5618  
5619  =back
5620  
5621  =item HISTORY
5622  
5623  =item AUTHORS
5624  
5625  =item LICENSE
5626  
5627  =back
5628  
5629  =head2 perlreguts - Description of the Perl regular expression engine.
5630  
5631  =over 4
5632  
5633  =item DESCRIPTION
5634  
5635  =item OVERVIEW
5636  
5637  =over 4
5638  
5639  =item A quick note on terms
5640  
5641  =item What is a regular expression engine?
5642  
5643  =item Structure of a Regexp Program
5644  
5645  C<regnode_1>, C<regnode_2>, C<regnode_string>, C<regnode_charclass>,
5646  C<regnode_charclass_class>
5647  
5648  =back
5649  
5650  =item Process Overview
5651  
5652  A. Compilation, 1. Parsing for size, 2. Parsing for construction, 3.
5653  Peep-hole optimisation and analysis, B. Execution, 4. Start position and
5654  no-match optimisations, 5. Program execution
5655  
5656  =over 4
5657  
5658  =item Compilation
5659  
5660  anchored fixed strings, floating fixed strings, minimum and maximum length
5661  requirements, start class, Beginning/End of line positions
5662  
5663  =item Execution
5664  
5665  =back
5666  
5667  =item MISCELLANEOUS
5668  
5669  =over 4
5670  
5671  =item Unicode and Localisation Support
5672  
5673  =item Base Structures
5674  
5675  C<swap>, C<offsets>, C<regstclass>, C<data>, C<program>
5676  
5677  =back
5678  
5679  =item SEE ALSO
5680  
5681  =item AUTHOR
5682  
5683  =item LICENCE
5684  
5685  =item REFERENCES
5686  
5687  =back
5688  
5689  =head2 perlapi - autogenerated documentation for the perl public API
5690  
5691  =over 4
5692  
5693  =item DESCRIPTION
5694  X<Perl API> X<API> X<api>
5695  
5696  =item "Gimme" Values
5697  
5698  GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5699  X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5700  G_VOID X<G_VOID>
5701  
5702  =item Array Manipulation Functions
5703  
5704  AvFILL X<AvFILL>, av_clear X<av_clear>, av_create_and_push
5705  X<av_create_and_push>, av_create_and_unshift_one
5706  X<av_create_and_unshift_one>, av_delete X<av_delete>, av_exists
5707  X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5708  X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5709  X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5710  X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5711  sortsv X<sortsv>, sortsv_flags X<sortsv_flags>
5712  
5713  =item Callback Functions
5714  
5715  call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5716  call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5717  FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5718  
5719  =item Character classes
5720  
5721  isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5722  X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5723  toUPPER X<toUPPER>
5724  
5725  =item Cloning an interpreter
5726  
5727  perl_clone X<perl_clone>
5728  
5729  =item CV Manipulation Functions
5730  
5731  CvSTASH X<CvSTASH>, get_cv X<get_cv>, get_cvn_flags X<get_cvn_flags>
5732  
5733  =item Embedding Functions
5734  
5735  cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5736  X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5737  X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5738  perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5739  
5740  =item Functions in file dump.c
5741  
5742  pv_display X<pv_display>, pv_escape X<pv_escape>, pv_pretty X<pv_pretty>
5743  
5744  =item Functions in file mathoms.c
5745  
5746  gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen
5747  X<sv_2pvbyte_nolen>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen
5748  X<sv_2pv_nolen>, sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>,
5749  sv_force_normal X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking
5750  X<sv_nolocking>, sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv
5751  X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn
5752  X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
5753  X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
5754  X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
5755  
5756  =item Functions in file pp_ctl.c
5757  
5758  find_runcv X<find_runcv>
5759  
5760  =item Functions in file pp_pack.c
5761  
5762  packlist X<packlist>, unpackstring X<unpackstring>
5763  
5764  =item GV Functions
5765  
5766  GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>,
5767  gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload
5768  X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn
5769  X<gv_stashpvn>, gv_stashpvs X<gv_stashpvs>, gv_stashsv X<gv_stashsv>
5770  
5771  =item Handy Values
5772  
5773  Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5774  Nullsv X<Nullsv>
5775  
5776  =item Hash Manipulation Functions
5777  
5778  get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5779  HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5780  X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME
5781  X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>,
5782  hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>,
5783  hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent
5784  X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetchs X<hv_fetchs>,
5785  hv_fetch_ent X<hv_fetch_ent>, hv_iterinit X<hv_iterinit>, hv_iterkey
5786  X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, hv_iternext X<hv_iternext>,
5787  hv_iternextsv X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>,
5788  hv_iterval X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>,
5789  hv_store X<hv_store>, hv_stores X<hv_stores>, hv_store_ent X<hv_store_ent>,
5790  hv_undef X<hv_undef>, newHV X<newHV>
5791  
5792  =item Magical Functions
5793  
5794  mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5795  X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5796  X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5797  X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5798  SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5799  SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5800  X<SvUNLOCK>
5801  
5802  =item Memory Management
5803  
5804  Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5805  Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, PoisonFree X<PoisonFree>,
5806  PoisonNew X<PoisonNew>, PoisonWith X<PoisonWith>, Renew X<Renew>, Renewc
5807  X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>,
5808  savepvs X<savepvs>, savesharedpv X<savesharedpv>, savesharedpvn
5809  X<savesharedpvn>, savesvpv X<savesvpv>, StructCopy X<StructCopy>, Zero
5810  X<Zero>, ZeroD X<ZeroD>
5811  
5812  =item Miscellaneous Functions
5813  
5814  fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5815  X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>,
5816  my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version
5817  X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
5818  X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
5819  X<strnNE>, sv_destroyable X<sv_destroyable>, sv_nosharing X<sv_nosharing>,
5820  upg_version X<upg_version>, vcmp X<vcmp>, vnormal X<vnormal>, vnumify
5821  X<vnumify>, vstringify X<vstringify>, vverify X<vverify>
5822  
5823  =item MRO Functions
5824  
5825  mro_get_linear_isa X<mro_get_linear_isa>, mro_method_changed_in
5826  X<mro_method_changed_in>
5827  
5828  =item Multicall Functions
5829  
5830  dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL
5831  X<POP_MULTICALL>, PUSH_MULTICALL X<PUSH_MULTICALL>
5832  
5833  =item Numeric functions
5834  
5835  grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5836  grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>,
5837  Perl_signbit X<Perl_signbit>, scan_bin X<scan_bin>, scan_hex X<scan_hex>,
5838  scan_oct X<scan_oct>
5839  
5840  =item Optree Manipulation Functions
5841  
5842  cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5843  
5844  =item Pad Data Structures
5845  
5846  pad_sv X<pad_sv>
5847  
5848  =item Per-Interpreter Variables
5849  
5850  PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5851  PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5852  
5853  =item REGEXP Functions
5854  
5855  SvRX X<SvRX>, SvRXOK X<SvRXOK>
5856  
5857  =item Simple Exception Handling Macros
5858  
5859  dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>,
5860  XCPT_TRY_END X<XCPT_TRY_END>, XCPT_TRY_START X<XCPT_TRY_START>
5861  
5862  =item Stack Manipulation Macros
5863  
5864  dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5865  X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu
5866  X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>,
5867  mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn
5868  X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs
5869  X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>,
5870  PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK
5871  X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal
5872  X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>,
5873  XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>,
5874  XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV
5875  X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF
5876  X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES
5877  X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV
5878  X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES
5879  X<XST_mYES>
5880  
5881  =item SV Flags
5882  
5883  svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5884  SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5885  X<SVt_PVMG>
5886  
5887  =item SV Manipulation Functions
5888  
5889  get_sv X<get_sv>, newRV_inc X<newRV_inc>, SvCUR X<SvCUR>, SvCUR_set
5890  X<SvCUR_set>, SvEND X<SvEND>, SvGAMAGIC X<SvGAMAGIC>, SvGROW X<SvGROW>,
5891  SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, SvIOK_off
5892  X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, SvIOK_only_UV
5893  X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
5894  SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
5895  SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN
5896  X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK
5897  X<SvNIOK>, SvNIOKp X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>,
5898  SvNOKp X<SvNOKp>, SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only
5899  X<SvNOK_only>, SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set
5900  X<SvNV_set>, SvOK X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp
5901  X<SvPOKp>, SvPOK_off X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only
5902  X<SvPOK_only>, SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte
5903  X<SvPVbyte>, SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>,
5904  SvPVbyte_force X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>,
5905  SvPVutf8 X<SvPVutf8>, SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force
5906  X<SvPVutf8x_force>, SvPVutf8_force X<SvPVutf8_force>, SvPVutf8_nolen
5907  X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>, SvPV_force
5908  X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen
5909  X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT
5910  X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>,
5911  SvREFCNT_inc_NN X<SvREFCNT_inc_NN>, SvREFCNT_inc_simple
5912  X<SvREFCNT_inc_simple>, SvREFCNT_inc_simple_NN X<SvREFCNT_inc_simple_NN>,
5913  SvREFCNT_inc_simple_void X<SvREFCNT_inc_simple_void>,
5914  SvREFCNT_inc_simple_void_NN X<SvREFCNT_inc_simple_void_NN>,
5915  SvREFCNT_inc_void X<SvREFCNT_inc_void>, SvREFCNT_inc_void_NN
5916  X<SvREFCNT_inc_void_NN>, SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on
5917  X<SvROK_on>, SvRV X<SvRV>, SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>,
5918  SvSTASH_set X<SvSTASH_set>, SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>,
5919  SvTAINTED_off X<SvTAINTED_off>, SvTAINTED_on X<SvTAINTED_on>, SvTRUE
5920  X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8
5921  X<SvUTF8>, SvUTF8_off X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>,
5922  SvUVX X<SvUVX>, SvUVx X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set
5923  X<SvUV_set>, SvVOK X<SvVOK>, sv_catpvn_nomg X<sv_catpvn_nomg>,
5924  sv_catsv_nomg X<sv_catsv_nomg>, sv_derived_from X<sv_derived_from>, sv_does
5925  X<sv_does>, sv_report_used X<sv_report_used>, sv_setsv_nomg
5926  X<sv_setsv_nomg>
5927  
5928  =item SV-Body Allocation
5929  
5930  looks_like_number X<looks_like_number>, newRV_noinc X<newRV_noinc>, newSV
5931  X<newSV>, newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>,
5932  newSVpv X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>,
5933  newSVpvn_share X<newSVpvn_share>, newSVpvs X<newSVpvs>, newSVpvs_share
5934  X<newSVpvs_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv
5935  X<newSVuv>, newSV_type X<newSV_type>, sv_2bool X<sv_2bool>, sv_2cv
5936  X<sv_2cv>, sv_2io X<sv_2io>, sv_2iv_flags X<sv_2iv_flags>, sv_2mortal
5937  X<sv_2mortal>, sv_2nv X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvutf8
5938  X<sv_2pvutf8>, sv_2pv_flags X<sv_2pv_flags>, sv_2uv_flags X<sv_2uv_flags>,
5939  sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv X<sv_catpv>,
5940  sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>, sv_catpvn
5941  X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvs X<sv_catpvs>,
5942  sv_catpv_mg X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags
5943  X<sv_catsv_flags>, sv_chop X<sv_chop>, sv_clear X<sv_clear>, sv_cmp
5944  X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>,
5945  sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_eq X<sv_eq>,
5946  sv_force_normal_flags X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets
5947  X<sv_gets>, sv_grow X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>,
5948  sv_isa X<sv_isa>, sv_isobject X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8
5949  X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>,
5950  sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref
5951  X<sv_newref>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>,
5952  sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>,
5953  sv_pvn_force_flags X<sv_pvn_force_flags>, sv_pvutf8n_force
5954  X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>,
5955  sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv X<sv_setiv>,
5956  sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg
5957  X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf X<sv_setpvf>, sv_setpvf_mg
5958  X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, sv_setpviv_mg X<sv_setpviv_mg>,
5959  sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpvs
5960  X<sv_setpvs>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>,
5961  sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn
5962  X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>,
5963  sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setuv
5964  X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true
5965  X<sv_true>, sv_unmagic X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>,
5966  sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn_flags
5967  X<sv_usepvn_flags>, sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade
5968  X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade
5969  X<sv_utf8_upgrade>, sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>,
5970  sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg
5971  X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>,
5972  sv_vsetpvf_mg X<sv_vsetpvf_mg>
5973  
5974  =item Unicode Support
5975  
5976  bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
5977  ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
5978  X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
5979  is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
5980  X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
5981  X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
5982  X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
5983  X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
5984  X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
5985  X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
5986  utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
5987  X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
5988  X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
5989  
5990  =item Variables created by C<xsubpp> and C<xsubpp> internal functions
5991  
5992  ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
5993  dUNDERBAR X<dUNDERBAR>, dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items
5994  X<items>, ix X<ix>, newXSproto X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>,
5995  THIS X<THIS>, UNDERBAR X<UNDERBAR>, XS X<XS>, XS_VERSION X<XS_VERSION>,
5996  XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
5997  
5998  =item Warning and Dieing
5999  
6000  croak X<croak>, warn X<warn>
6001  
6002  =item AUTHORS
6003  
6004  =item SEE ALSO
6005  
6006  =back
6007  
6008  =head2 perlintern - autogenerated documentation of purely B<internal>
6009           Perl functions
6010  
6011  =over 4
6012  
6013  =item DESCRIPTION
6014  X<internal Perl functions> X<interpreter functions>
6015  
6016  =item CV reference counts and CvOUTSIDE
6017  
6018  CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
6019  
6020  =item Functions in file pad.h
6021  
6022  CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
6023  X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
6024  X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
6025  PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
6026  X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
6027  PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
6028  PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
6029  PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
6030  PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
6031  PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
6032  SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
6033  
6034  =item GV Functions
6035  
6036  is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
6037  
6038  =item Hash Manipulation Functions
6039  
6040  refcounted_he_chain_2hv X<refcounted_he_chain_2hv>, refcounted_he_free
6041  X<refcounted_he_free>, refcounted_he_new X<refcounted_he_new>
6042  
6043  =item IO Functions
6044  
6045  start_glob X<start_glob>
6046  
6047  =item Magical Functions
6048  
6049  magic_sethint X<magic_sethint>, mg_localize X<mg_localize>
6050  
6051  =item MRO Functions
6052  
6053  mro_get_linear_isa_c3 X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs
6054  X<mro_get_linear_isa_dfs>, mro_isa_changed_in X<mro_isa_changed_in>
6055  
6056  =item Pad Data Structures
6057  
6058  CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
6059  do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
6060  X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
6061  pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
6062  pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
6063  X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
6064  pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
6065  X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
6066  X<pad_undef>
6067  
6068  =item Per-Interpreter Variables
6069  
6070  PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
6071  PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv
6072  X<PL_ofs_sv>, PL_rs X<PL_rs>
6073  
6074  =item Stack Manipulation Macros
6075  
6076  djSP X<djSP>, LVRET X<LVRET>
6077  
6078  =item SV Manipulation Functions
6079  
6080  sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
6081  X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
6082  
6083  =item SV-Body Allocation
6084  
6085  sv_2num X<sv_2num>
6086  
6087  =item Unicode Support
6088  
6089  find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
6090  
6091  =item AUTHORS
6092  
6093  =item SEE ALSO
6094  
6095  =back
6096  
6097  =head2 perliol - C API for Perl's implementation of IO in Layers.
6098  
6099  =over 4
6100  
6101  =item SYNOPSIS
6102  
6103  =item DESCRIPTION
6104  
6105  =over 4
6106  
6107  =item History and Background
6108  
6109  =item Basic Structure
6110  
6111  =item Layers vs Disciplines
6112  
6113  =item Data Structures
6114  
6115  =item Functions and Attributes
6116  
6117  =item Per-instance Data
6118  
6119  =item Layers in action.
6120  
6121  =item Per-instance flag bits
6122  
6123  PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
6124  PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
6125  PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
6126  PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
6127  
6128  =item Methods in Detail
6129  
6130  fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
6131  PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
6132  Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
6133  Error,    Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
6134  Set_ptrcnt
6135  
6136  =item Utilities
6137  
6138  =item Implementing PerlIO Layers
6139  
6140  C implementations, Perl implementations
6141  
6142  =item Core Layers
6143  
6144  "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
6145  
6146  =item Extension Layers
6147  
6148  ":encoding", ":scalar", ":via"
6149  
6150  =back
6151  
6152  =item TODO
6153  
6154  =back
6155  
6156  =head2 perlapio - perl's IO abstraction interface.
6157  
6158  =over 4
6159  
6160  =item SYNOPSIS
6161  
6162  =item DESCRIPTION
6163  
6164  1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
6165  B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
6166  B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
6167  B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
6168  B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
6169  B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
6170  B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
6171  B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
6172  B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
6173  B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
6174  B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
6175  
6176  =over 4
6177  
6178  =item Co-existence with stdio
6179  
6180  B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
6181  B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
6182  
6183  =item "Fast gets" Functions
6184  
6185  B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
6186  B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
6187  B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
6188  B<PerlIO_get_bufsiz(f)>
6189  
6190  =item Other Functions
6191  
6192  PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
6193  'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
6194  
6195  =back
6196  
6197  =back
6198  
6199  =head2 perlhack - How to hack at the Perl internals
6200  
6201  =over 4
6202  
6203  =item DESCRIPTION
6204  
6205  Does concept match the general goals of Perl?, Where is the
6206  implementation?, Backwards compatibility, Could it be a module instead?, Is
6207  the feature generic enough?, Does it potentially introduce new bugs?, Does
6208  it preclude other desirable features?, Is the implementation robust?, Is
6209  the implementation generic enough to be portable?, Is the implementation
6210  tested?, Is there enough documentation?, Is there another way to do it?,
6211  Does it create too much work?, Patches speak louder than words
6212  
6213  =over 4
6214  
6215  =item Keeping in sync
6216  
6217  rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
6218  NFS, rsync'ing the patches
6219  
6220  =item Why rsync the source tree
6221  
6222  It's easier to rsync the source tree, It's more reliable
6223  
6224  =item Why rsync the patches
6225  
6226  It's easier to rsync the patches, It's a good reference, Finding a start
6227  point, Finding how to fix a bug, Finding the source of misbehaviour
6228  
6229  =item Working with the source
6230  
6231  =item Perlbug administration
6232  
6233  =item Submitting patches
6234  
6235  L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
6236  F<Porting/pumpkin.pod>, The perl5-porters FAQ
6237  
6238  =item Finding Your Way Around
6239  
6240  Core modules, Tests, Documentation, Configure, Interpreter
6241  
6242  =item Elements of the interpreter
6243  
6244  Startup, Parsing, Optimization, Running, Exception handing
6245  
6246  =item Internal Variable Types
6247  
6248  =item Op Trees
6249  
6250  =item Stacks
6251  
6252  Argument stack, Mark stack, Save stack
6253  
6254  =item Millions of Macros
6255  
6256  =item The .i Targets
6257  
6258  =back
6259  
6260  =item SOURCE CODE STATIC ANALYSIS
6261  
6262  =over 4
6263  
6264  =item lint, splint
6265  
6266  =item Coverity
6267  
6268  =item cpd (cut-and-paste detector)
6269  
6270  =item gcc warnings
6271  
6272  =item Warnings of other C compilers
6273  
6274  =item DEBUGGING
6275  
6276  =item Poking at Perl
6277  
6278  =item Using a source-level debugger
6279  
6280  run [args], break function_name, break source.c:xxx, step, next, continue,
6281  finish, 'enter', print
6282  
6283  =item gdb macro support
6284  
6285  =item Dumping Perl Data Structures
6286  
6287  =item Patching
6288  
6289  =item Patching a core module
6290  
6291  =item Adding a new function to the core
6292  
6293  =item Writing a test
6294  
6295  F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/mro/>,
6296  F<t/op/>, F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base
6297  t/comp, t/cmd t/run t/io t/op, t/lib ext lib
6298  
6299  =item Special Make Test Targets
6300  
6301  coretest, test.deparse, test.taintwarn, minitest, test.valgrind
6302  check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
6303  utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
6304  check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
6305  
6306  =item Running tests by hand
6307  
6308  -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
6309  PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST, PERL_TEST_Net_Ping,
6310  PERL_TEST_NOVREXX, PERL_TEST_NUMCONVERTS
6311  
6312  =item Common problems when patching Perl source code
6313  
6314  =item Perl environment problems
6315  
6316  =item Portability problems
6317  
6318  =item Problematic System Interfaces
6319  
6320  =item Security problems
6321  
6322  =back
6323  
6324  =item EXTERNAL TOOLS FOR DEBUGGING PERL
6325  
6326  =over 4
6327  
6328  =item Rational Software's Purify
6329  
6330  =item Purify on Unix
6331  
6332  -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
6333  
6334  =item Purify on NT
6335  
6336  DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
6337  
6338  =item valgrind
6339  
6340  =item Compaq's/Digital's/HP's Third Degree
6341  
6342  =item PERL_DESTRUCT_LEVEL
6343  
6344  =item PERL_MEM_LOG
6345  
6346  =item Profiling
6347  
6348  =item Gprof Profiling
6349  
6350  -a, -b, -e routine, -f routine, -s, -z
6351  
6352  =item GCC gcov Profiling
6353  
6354  =item Pixie Profiling
6355  
6356  -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
6357  -z[ero]
6358  
6359  =item Miscellaneous tricks
6360  
6361  =back
6362  
6363  =item CONCLUSION
6364  
6365  I<The Road goes ever on and on, down from the door where it began.>
6366  
6367  =item AUTHOR
6368  
6369  =back
6370  
6371  =head2 perlbook - Perl book information
6372  
6373  =over 4
6374  
6375  =item DESCRIPTION
6376  
6377  =back
6378  
6379  =head2 perlcommunity - a brief overview of the Perl community
6380  
6381  =over 4
6382  
6383  =item DESCRIPTION
6384  
6385  =over 4
6386  
6387  =item Where to find the community
6388  
6389  =item Mailing lists and Newsgroups
6390  
6391  =item IRC
6392  
6393  =item Websites
6394  
6395  L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
6396  
6397  =item User Groups
6398  
6399  =item Workshops
6400  
6401  =item Hackathons
6402  
6403  =item Conventions
6404  
6405  =item Calendar of Perl Events
6406  
6407  =back
6408  
6409  =item AUTHOR
6410  
6411  =back
6412  
6413  =head2 perltodo - Perl TO-DO List
6414  
6415  =over 4
6416  
6417  =item DESCRIPTION
6418  
6419  =item Tasks that only need Perl knowledge
6420  
6421  =over 4
6422  
6423  =item Remove duplication of test setup.
6424  
6425  =item merge common code in installperl and installman
6426  
6427  =item common test code for timed bail out
6428  
6429  =item POD -E<gt> HTML conversion in the core still sucks
6430  
6431  =item merge checkpods and podchecker
6432  
6433  =item perlmodlib.PL rewrite
6434  
6435  =item Parallel testing
6436  
6437  =item Make Schwern poorer
6438  
6439  =item Improve the coverage of the core tests
6440  
6441  =item test B
6442  
6443  =item Deparse inlined constants
6444  
6445  =item A decent benchmark
6446  
6447  =item fix tainting bugs
6448  
6449  =item Dual life everything
6450  
6451  =item Improving C<threads::shared>
6452  
6453  =item POSIX memory footprint
6454  
6455  =item embed.pl/makedef.pl
6456  
6457  =item use strict; and AutoLoad
6458  
6459  =back
6460  
6461  =item Tasks that need a little sysadmin-type knowledge
6462  
6463  =over 4
6464  
6465  =item make HTML install work
6466  
6467  =item compressed man pages
6468  
6469  =item Add a code coverage target to the Makefile
6470  
6471  =item Make Config.pm cope with differences between built and installed perl
6472  
6473  =item linker specification files
6474  
6475  =item Cross-compile support
6476  
6477  =item roffitall
6478  
6479  =back
6480  
6481  =item Tasks that need a little C knowledge
6482  
6483  =over 4
6484  
6485  =item Exterminate PL_na!
6486  
6487  =item Modernize the order of directories in @INC
6488  
6489  =item -Duse32bit*
6490  
6491  =item Make it clear from -v if this is the exact official release
6492  
6493  =item Profile Perl - am I hot or not?
6494  
6495  =item Allocate OPs from arenas
6496  
6497  =item Improve win32/wince.c
6498  
6499  =item Use secure CRT functions when building with VC8 on Win32
6500  
6501  =item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
6502  
6503  =item -D_FORTIFY_SOURCE=2, -fstack-protector
6504  
6505  =back
6506  
6507  =item Tasks that need a knowledge of XS
6508  
6509  =over 4
6510  
6511  =item autovivification
6512  
6513  =item Unicode in Filenames
6514  
6515  =item Unicode in %ENV
6516  
6517  =item Unicode and glob()
6518  
6519  =item Unicode and lc/uc operators
6520  
6521  =item use less 'memory'
6522  
6523  =item Re-implement C<:unique> in a way that is actually thread-safe
6524  
6525  =item Make tainting consistent
6526  
6527  =item readpipe(LIST)
6528  
6529  =item Audit the code for destruction ordering assumptions
6530  
6531  =item Extend PerlIO and PerlIO::Scalar
6532  
6533  =item -C on the #! line
6534  
6535  =item Propagate const outwards from Perl_moreswitches()
6536  
6537  =item Duplicate logic in S_method_common() and
6538  Perl_gv_fetchmethod_autoload()
6539  
6540  =item Organize error messages
6541  
6542  =back
6543  
6544  =item Tasks that need a knowledge of the interpreter
6545  
6546  =over 4
6547  
6548  =item state variable initialization in list context
6549  
6550  =item Implement $value ~~ 0 .. $range
6551  
6552  =item A does() built-in
6553  
6554  =item Tied filehandles and write() don't mix
6555  
6556  =item Attach/detach debugger from running program
6557  
6558  =item Optimize away empty destructors
6559  
6560  =item LVALUE functions for lists
6561  
6562  =item LVALUE functions in the debugger
6563  
6564  =item regexp optimiser optional
6565  
6566  =item delete &function
6567  
6568  =item C</w> regex modifier
6569  
6570  =item optional optimizer
6571  
6572  =item You WANT *how* many
6573  
6574  =item lexical aliases
6575  
6576  =item entersub XS vs Perl
6577  
6578  =item Self-ties
6579  
6580  =item Optimize away @_
6581  
6582  =item Properly Unicode safe tokeniser and pads.
6583  
6584  =item The yada yada yada operators
6585  
6586  =item Virtualize operating system access
6587  
6588  =item Investigate PADTMP hash pessimisation
6589  
6590  =back
6591  
6592  =item Big projects
6593  
6594  =over 4
6595  
6596  =item make ithreads more robust
6597  
6598  =item iCOW
6599  
6600  =item (?{...}) closures in regexps
6601  
6602  =item A re-entrant regexp engine
6603  
6604  =item Add class set operations to regexp engine
6605  
6606  =back
6607  
6608  =back
6609  
6610  =head2 perldoc - Look up Perl documentation in Pod format.
6611  
6612  =over 4
6613  
6614  =item SYNOPSIS
6615  
6616  =item DESCRIPTION
6617  
6618  =item OPTIONS
6619  
6620  B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
6621  I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
6622  I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
6623  B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
6624  B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
6625  B<-V>
6626  
6627  =item SECURITY
6628  
6629  =item ENVIRONMENT
6630  
6631  =item AUTHOR
6632  
6633  =back
6634  
6635  =head2 perlhist - the Perl history records
6636  
6637  =over 4
6638  
6639  =item DESCRIPTION
6640  
6641  =item INTRODUCTION
6642  
6643  =item THE KEEPERS OF THE PUMPKIN
6644  
6645  =over 4
6646  
6647  =item PUMPKIN?
6648  
6649  =back
6650  
6651  =item THE RECORDS
6652  
6653  =over 4
6654  
6655  =item SELECTED RELEASE SIZES
6656  
6657  =item SELECTED PATCH SIZES
6658  
6659  =back
6660  
6661  =item THE KEEPERS OF THE RECORDS
6662  
6663  =back
6664  
6665  =head2 perldelta - what is new for perl 5.10.0
6666  
6667  =over 4
6668  
6669  =item DESCRIPTION
6670  
6671  =item Core Enhancements
6672  
6673  =over 4
6674  
6675  =item The C<feature> pragma
6676  
6677  =item New B<-E> command-line switch
6678  
6679  =item Defined-or operator
6680  
6681  =item Switch and Smart Match operator
6682  
6683  =item Regular expressions
6684  
6685  Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
6686  Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
6687  and horizontal whitespace, and linebreak
6688  
6689  =item C<say()>
6690  
6691  =item Lexical C<$_>
6692  
6693  =item The C<_> prototype
6694  
6695  =item UNITCHECK blocks
6696  
6697  =item New Pragma, C<mro>
6698  
6699  =item readdir() may return a "short filename" on Windows
6700  
6701  =item readpipe() is now overridable
6702  
6703  =item Default argument for readline()
6704  
6705  =item state() variables
6706  
6707  =item Stacked filetest operators
6708  
6709  =item UNIVERSAL::DOES()
6710  
6711  =item Formats
6712  
6713  =item Byte-order modifiers for pack() and unpack()
6714  
6715  =item C<no VERSION>
6716  
6717  =item C<chdir>, C<chmod> and C<chown> on filehandles
6718  
6719  =item OS groups
6720  
6721  =item Recursive sort subs
6722  
6723  =item Exceptions in constant folding
6724  
6725  =item Source filters in @INC
6726  
6727  =item New internal variables
6728  
6729  C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>, C<${^RE_TRIE_MAXBUF}>,
6730  C<${^WIN32_SLOPPY_STAT}>
6731  
6732  =item Miscellaneous
6733  
6734  =item UCD 5.0.0
6735  
6736  =item MAD
6737  
6738  =item kill() on Windows
6739  
6740  =back
6741  
6742  =item Incompatible Changes
6743  
6744  =over 4
6745  
6746  =item Packing and UTF-8 strings
6747  
6748  =item Byte/character count feature in unpack()
6749  
6750  =item The C<$*> and C<$#> variables have been removed
6751  
6752  =item substr() lvalues are no longer fixed-length
6753  
6754  =item Parsing of C<-f _>
6755  
6756  =item C<:unique>
6757  
6758  =item Effect of pragmas in eval
6759  
6760  =item chdir FOO
6761  
6762  =item Handling of .pmc files
6763  
6764  =item $^V is now a C<version> object instead of a v-string
6765  
6766  =item @- and @+ in patterns
6767  
6768  =item $AUTOLOAD can now be tainted
6769  
6770  =item Tainting and printf
6771  
6772  =item undef and signal handlers
6773  
6774  =item strictures and dereferencing in defined()
6775  
6776  =item C<(?p{})> has been removed
6777  
6778  =item Pseudo-hashes have been removed
6779  
6780  =item Removal of the bytecode compiler and of perlcc
6781  
6782  =item Removal of the JPL
6783  
6784  =item Recursive inheritance detected earlier
6785  
6786  =back
6787  
6788  =item Modules and Pragmata
6789  
6790  =over 4
6791  
6792  =item Upgrading individual core modules
6793  
6794  =item Pragmata Changes
6795  
6796  C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
6797  C<bigint>, C<bigrat>, C<base>, C<strict> and C<warnings>, C<version>,
6798  C<warnings>, C<less>
6799  
6800  =item New modules
6801  
6802  =item Selected Changes to Core Modules
6803  
6804  C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
6805  
6806  =back
6807  
6808  =item Utility Changes
6809  
6810  perl -d, ptar, ptardiff, shasum, corelist, h2ph and h2xs, perlivp,
6811  find2perl, config_data, cpanp, cpan2dist, pod2html
6812  
6813  =item New Documentation
6814  
6815  =item Performance Enhancements
6816  
6817  =over 4
6818  
6819  =item In-place sorting
6820  
6821  =item Lexical array access
6822  
6823  =item XS-assisted SWASHGET
6824  
6825  =item Constant subroutines
6826  
6827  =item C<PERL_DONT_CREATE_GVSV>
6828  
6829  =item Weak references are cheaper
6830  
6831  =item sort() enhancements
6832  
6833  =item Memory optimisations
6834  
6835  =item UTF-8 cache optimisation
6836  
6837  =item Sloppy stat on Windows
6838  
6839  =item Regular expressions optimisations
6840  
6841  Engine de-recursivised, Single char char-classes treated as literals, Trie
6842  optimisation of literal string alternations, Aho-Corasick start-point
6843  optimisation
6844  
6845  =back
6846  
6847  =item Installation and Configuration Improvements
6848  
6849  =over 4
6850  
6851  =item Configuration improvements
6852  
6853  C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
6854  C<d_pseudofork> and C<d_printf_format_null>, Configure help
6855  
6856  =item Compilation improvements
6857  
6858  Parallel build, Borland's compilers support, Static build on Windows,
6859  ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
6860  Visual C++, Win32 builds
6861  
6862  =item Installation improvements
6863  
6864  Module auxiliary files
6865  
6866  =item New Or Improved Platforms
6867  
6868  =back
6869  
6870  =item Selected Bug Fixes
6871  
6872  strictures in regexp-eval blocks, Calling CORE::require(), Subscripts of
6873  slices, C<no warnings 'category'> works correctly with -w, threads
6874  improvements, chr() and negative values, PERL5SHELL and tainting, Using
6875  *FILE{IO}, Overloading and reblessing, Overloading and UTF-8, eval memory
6876  leaks fixed, Random device on Windows, PERLIO_DEBUG, PerlIO::scalar and
6877  read-only scalars, study() and UTF-8, Critical signals, @INC-hook fix,
6878  C<-t> switch fix, Duping UTF-8 filehandles, Localisation of hash elements
6879  
6880  =item New or Changed Diagnostics
6881  
6882  Use of uninitialized value, Deprecated use of my() in false conditional,
6883  !=~ should be !~, Newline in left-justified string, Too late for "-T"
6884  option, "%s" variable %s masks earlier declaration,
6885  readdir()/closedir()/etc. attempted on invalid dirhandle, Opening
6886  dirhandle/filehandle %s also as a file/directory, Use of -P is deprecated,
6887  v-string in use/require is non-portable, perl -V
6888  
6889  =item Changed Internals
6890  
6891  =over 4
6892  
6893  =item Reordering of SVt_* constants
6894  
6895  =item Elimination of SVt_PVBM
6896  
6897  =item New type SVt_BIND
6898  
6899  =item Removal of CPP symbols
6900  
6901  =item Less space is used by ops
6902  
6903  =item New parser
6904  
6905  =item Use of C<const>
6906  
6907  =item Mathoms
6908  
6909  =item C<AvFLAGS> has been removed
6910  
6911  =item C<av_*> changes
6912  
6913  =item $^H and %^H
6914  
6915  =item B:: modules inheritance changed
6916  
6917  =item Anonymous hash and array constructors
6918  
6919  =back
6920  
6921  =item Known Problems
6922  
6923  =item Platform Specific Problems
6924  
6925  =item Reporting Bugs
6926  
6927  =item SEE ALSO
6928  
6929  =back
6930  
6931  =head2 perl5100delta, perldelta - what is new for perl 5.10.0
6932  
6933  =over 4
6934  
6935  =item DESCRIPTION
6936  
6937  =item Core Enhancements
6938  
6939  =over 4
6940  
6941  =item The C<feature> pragma
6942  
6943  =item New B<-E> command-line switch
6944  
6945  =item Defined-or operator
6946  
6947  =item Switch and Smart Match operator
6948  
6949  =item Regular expressions
6950  
6951  Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
6952  Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
6953  and horizontal whitespace, and linebreak
6954  
6955  =item C<say()>
6956  
6957  =item Lexical C<$_>
6958  
6959  =item The C<_> prototype
6960  
6961  =item UNITCHECK blocks
6962  
6963  =item New Pragma, C<mro>
6964  
6965  =item readdir() may return a "short filename" on Windows
6966  
6967  =item readpipe() is now overridable
6968  
6969  =item Default argument for readline()
6970  
6971  =item state() variables
6972  
6973  =item Stacked filetest operators
6974  
6975  =item UNIVERSAL::DOES()
6976  
6977  =item Formats
6978  
6979  =item Byte-order modifiers for pack() and unpack()
6980  
6981  =item C<no VERSION>
6982  
6983  =item C<chdir>, C<chmod> and C<chown> on filehandles
6984  
6985  =item OS groups
6986  
6987  =item Recursive sort subs
6988  
6989  =item Exceptions in constant folding
6990  
6991  =item Source filters in @INC
6992  
6993  =item New internal variables
6994  
6995  C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>, C<${^RE_TRIE_MAXBUF}>,
6996  C<${^WIN32_SLOPPY_STAT}>
6997  
6998  =item Miscellaneous
6999  
7000  =item UCD 5.0.0
7001  
7002  =item MAD
7003  
7004  =item kill() on Windows
7005  
7006  =back
7007  
7008  =item Incompatible Changes
7009  
7010  =over 4
7011  
7012  =item Packing and UTF-8 strings
7013  
7014  =item Byte/character count feature in unpack()
7015  
7016  =item The C<$*> and C<$#> variables have been removed
7017  
7018  =item substr() lvalues are no longer fixed-length
7019  
7020  =item Parsing of C<-f _>
7021  
7022  =item C<:unique>
7023  
7024  =item Effect of pragmas in eval
7025  
7026  =item chdir FOO
7027  
7028  =item Handling of .pmc files
7029  
7030  =item $^V is now a C<version> object instead of a v-string
7031  
7032  =item @- and @+ in patterns
7033  
7034  =item $AUTOLOAD can now be tainted
7035  
7036  =item Tainting and printf
7037  
7038  =item undef and signal handlers
7039  
7040  =item strictures and dereferencing in defined()
7041  
7042  =item C<(?p{})> has been removed
7043  
7044  =item Pseudo-hashes have been removed
7045  
7046  =item Removal of the bytecode compiler and of perlcc
7047  
7048  =item Removal of the JPL
7049  
7050  =item Recursive inheritance detected earlier
7051  
7052  =back
7053  
7054  =item Modules and Pragmata
7055  
7056  =over 4
7057  
7058  =item Upgrading individual core modules
7059  
7060  =item Pragmata Changes
7061  
7062  C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
7063  C<bigint>, C<bigrat>, C<base>, C<strict> and C<warnings>, C<version>,
7064  C<warnings>, C<less>
7065  
7066  =item New modules
7067  
7068  =item Selected Changes to Core Modules
7069  
7070  C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
7071  
7072  =back
7073  
7074  =item Utility Changes
7075  
7076  perl -d, ptar, ptardiff, shasum, corelist, h2ph and h2xs, perlivp,
7077  find2perl, config_data, cpanp, cpan2dist, pod2html
7078  
7079  =item New Documentation
7080  
7081  =item Performance Enhancements
7082  
7083  =over 4
7084  
7085  =item In-place sorting
7086  
7087  =item Lexical array access
7088  
7089  =item XS-assisted SWASHGET
7090  
7091  =item Constant subroutines
7092  
7093  =item C<PERL_DONT_CREATE_GVSV>
7094  
7095  =item Weak references are cheaper
7096  
7097  =item sort() enhancements
7098  
7099  =item Memory optimisations
7100  
7101  =item UTF-8 cache optimisation
7102  
7103  =item Sloppy stat on Windows
7104  
7105  =item Regular expressions optimisations
7106  
7107  Engine de-recursivised, Single char char-classes treated as literals, Trie
7108  optimisation of literal string alternations, Aho-Corasick start-point
7109  optimisation
7110  
7111  =back
7112  
7113  =item Installation and Configuration Improvements
7114  
7115  =over 4
7116  
7117  =item Configuration improvements
7118  
7119  C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
7120  C<d_pseudofork> and C<d_printf_format_null>, Configure help
7121  
7122  =item Compilation improvements
7123  
7124  Parallel build, Borland's compilers support, Static build on Windows,
7125  ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
7126  Visual C++, Win32 builds
7127  
7128  =item Installation improvements
7129  
7130  Module auxiliary files
7131  
7132  =item New Or Improved Platforms
7133  
7134  =back
7135  
7136  =item Selected Bug Fixes
7137  
7138  strictures in regexp-eval blocks, Calling CORE::require(), Subscripts of
7139  slices, C<no warnings 'category'> works correctly with -w, threads
7140  improvements, chr() and negative values, PERL5SHELL and tainting, Using
7141  *FILE{IO}, Overloading and reblessing, Overloading and UTF-8, eval memory
7142  leaks fixed, Random device on Windows, PERLIO_DEBUG, PerlIO::scalar and
7143  read-only scalars, study() and UTF-8, Critical signals, @INC-hook fix,
7144  C<-t> switch fix, Duping UTF-8 filehandles, Localisation of hash elements
7145  
7146  =item New or Changed Diagnostics
7147  
7148  Use of uninitialized value, Deprecated use of my() in false conditional,
7149  !=~ should be !~, Newline in left-justified string, Too late for "-T"
7150  option, "%s" variable %s masks earlier declaration,
7151  readdir()/closedir()/etc. attempted on invalid dirhandle, Opening
7152  dirhandle/filehandle %s also as a file/directory, Use of -P is deprecated,
7153  v-string in use/require is non-portable, perl -V
7154  
7155  =item Changed Internals
7156  
7157  =over 4
7158  
7159  =item Reordering of SVt_* constants
7160  
7161  =item Elimination of SVt_PVBM
7162  
7163  =item New type SVt_BIND
7164  
7165  =item Removal of CPP symbols
7166  
7167  =item Less space is used by ops
7168  
7169  =item New parser
7170  
7171  =item Use of C<const>
7172  
7173  =item Mathoms
7174  
7175  =item C<AvFLAGS> has been removed
7176  
7177  =item C<av_*> changes
7178  
7179  =item $^H and %^H
7180  
7181  =item B:: modules inheritance changed
7182  
7183  =item Anonymous hash and array constructors
7184  
7185  =back
7186  
7187  =item Known Problems
7188  
7189  =item Platform Specific Problems
7190  
7191  =item Reporting Bugs
7192  
7193  =item SEE ALSO
7194  
7195  =back
7196  
7197  =head2 perl595delta - what is new for perl v5.9.5
7198  
7199  =over 4
7200  
7201  =item DESCRIPTION
7202  
7203  =item Incompatible Changes
7204  
7205  =over 4
7206  
7207  =item Tainting and printf
7208  
7209  =item undef and signal handlers
7210  
7211  =item strictures and array/hash dereferencing in defined()
7212  
7213  =item C<(?p{})> has been removed
7214  
7215  =item Pseudo-hashes have been removed
7216  
7217  =item Removal of the bytecode compiler and of perlcc
7218  
7219  =item Removal of the JPL
7220  
7221  =item Recursive inheritance detected earlier
7222  
7223  =back
7224  
7225  =item Core Enhancements
7226  
7227  =over 4
7228  
7229  =item Regular expressions
7230  
7231  Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
7232  Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
7233  and horizontal whitespace, and linebreak
7234  
7235  =item The C<_> prototype
7236  
7237  =item UNITCHECK blocks
7238  
7239  =item readpipe() is now overridable
7240  
7241  =item default argument for readline()
7242  
7243  =item UCD 5.0.0
7244  
7245  =item Smart match
7246  
7247  =item Implicit loading of C<feature>
7248  
7249  =back
7250  
7251  =item Modules and Pragmas
7252  
7253  =over 4
7254  
7255  =item New Pragma, C<mro>
7256  
7257  =item bignum, bigint, bigrat
7258  
7259  =item Math::BigInt/Math::BigFloat
7260  
7261  config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
7262  batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
7263  from_bin(), as_oct()
7264  
7265  =item New Core Modules
7266  
7267  =item Module changes
7268  
7269  C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>,
7270  C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
7271  
7272  =back
7273  
7274  =item Utility Changes
7275  
7276  =over 4
7277  
7278  =item C<cpanp>
7279  
7280  =item C<cpan2dist>
7281  
7282  =item C<pod2html>
7283  
7284  =back
7285  
7286  =item Documentation
7287  
7288  =over 4
7289  
7290  =item New manpage, perlunifaq
7291  
7292  =back
7293  
7294  =item Performance Enhancements
7295  
7296  =item Installation and Configuration Improvements
7297  
7298  =over 4
7299  
7300  =item C++ compatibility
7301  
7302  =item Visual C++
7303  
7304  =item Static build on Win32
7305  
7306  =item win32 builds
7307  
7308  =item C<d_pseudofork> and C<d_printf_format_null>
7309  
7310  =item Help
7311  
7312  =item 64bit systems
7313  
7314  =item Ports
7315  
7316  =back
7317  
7318  =item Selected Bug Fixes
7319  
7320  =item New or Changed Diagnostics
7321  
7322  =over 4
7323  
7324  =item Deprecations
7325  
7326  =back
7327  
7328  =item Changed Internals
7329  
7330  =item Known Problems
7331  
7332  =over 4
7333  
7334  =item Platform Specific Problems
7335  
7336  =back
7337  
7338  =item Reporting Bugs
7339  
7340  =item SEE ALSO
7341  
7342  =back
7343  
7344  =head2 perl594delta - what is new for perl v5.9.4
7345  
7346  =over 4
7347  
7348  =item DESCRIPTION
7349  
7350  =item Incompatible Changes
7351  
7352  =over 4
7353  
7354  =item chdir FOO
7355  
7356  =item Handling of pmc files
7357  
7358  =item @- and @+ in patterns
7359  
7360  =item $AUTOLOAD can now be tainted
7361  
7362  =back
7363  
7364  =item Core Enhancements
7365  
7366  =over 4
7367  
7368  =item state() variables
7369  
7370  =item UNIVERSAL::DOES()
7371  
7372  =item Exceptions in constant folding
7373  
7374  =item Source filters in @INC
7375  
7376  =item MAD
7377  
7378  =back
7379  
7380  =item Modules and Pragmas
7381  
7382  =over 4
7383  
7384  =item New Core Modules
7385  
7386  =back
7387  
7388  =item Utility Changes
7389  
7390  =over 4
7391  
7392  =item config_data
7393  
7394  =back
7395  
7396  =item Documentation
7397  
7398  =over 4
7399  
7400  =item New manpage, perlpragma
7401  
7402  =item New manpage, perlreguts
7403  
7404  =item New manpage, perlunitut
7405  
7406  =back
7407  
7408  =item Performance Enhancements
7409  
7410  =over 4
7411  
7412  =item Memory optimisations
7413  
7414  =item UTF-8 cache optimisation
7415  
7416  =item Regular expressions
7417  
7418  Engine de-recursivised, Single char char-classes treated as literals, Trie
7419  optimisation of literal string alternations, Aho-Corasick start-point
7420  optimisation
7421  
7422  =item Sloppy stat on Windows
7423  
7424  =back
7425  
7426  =item Installation and Configuration Improvements
7427  
7428  =over 4
7429  
7430  =item Relocatable installations
7431  
7432  =item Ports
7433  
7434  =item Compilation improvements
7435  
7436  =item New probes
7437  
7438  =item Windows build improvements
7439  
7440  Building XS extensions, Support for 64-bit compiler
7441  
7442  =back
7443  
7444  =item Selected Bug Fixes
7445  
7446  =over 4
7447  
7448  =item PERL5SHELL and tainting
7449  
7450  =item Using *FILE{IO}
7451  
7452  =item Overloading and reblessing
7453  
7454  =item Overloading and UTF-8
7455  
7456  =item eval memory leaks fixed
7457  
7458  =item Random device on Windows
7459  
7460  =back
7461  
7462  =item New or Changed Diagnostics
7463  
7464  State variable %s will be reinitialized
7465  
7466  =item Changed Internals
7467  
7468  =item Known Problems
7469  
7470  =item Reporting Bugs
7471  
7472  =item SEE ALSO
7473  
7474  =back
7475  
7476  =head2 perl593delta - what is new for perl v5.9.3
7477  
7478  =over 4
7479  
7480  =item DESCRIPTION
7481  
7482  =item Incompatible Changes
7483  
7484  =over 4
7485  
7486  =item Parsing of C<-f _>
7487  
7488  =item C<mkdir()>
7489  
7490  =item Magic goto and eval
7491  
7492  =item C<$#> has been removed
7493  
7494  =item C<:unique>
7495  
7496  =item Scoping of the C<sort> pragma
7497  
7498  =back
7499  
7500  =item Core Enhancements
7501  
7502  =over 4
7503  
7504  =item The C<feature> pragma
7505  
7506  =item Switch and Smart Match operator
7507  
7508  =item C<say()>
7509  
7510  =item C<CLONE_SKIP()>
7511  
7512  =item C<${^CHILD_ERROR_NATIVE}>
7513  
7514  =item Assertions
7515  
7516  =item Unicode Character Database 4.1.0
7517  
7518  =item C<no VERSION>
7519  
7520  =item Recursive sort subs
7521  
7522  =item Effect of pragmas in eval
7523  
7524  =item New B<-E> command-line switch
7525  
7526  =item C<chdir>, C<chmod> and C<chown> on filehandles
7527  
7528  =item OS groups
7529  
7530  =back
7531  
7532  =item Modules and Pragmata
7533  
7534  =over 4
7535  
7536  =item New Core Modules
7537  
7538  =back
7539  
7540  =item Utility Changes
7541  
7542  =over 4
7543  
7544  =item C<ptar>
7545  
7546  =item C<ptardiff>
7547  
7548  =item C<shasum>
7549  
7550  =item C<h2xs> enhancements
7551  
7552  =item C<perlivp> enhancements
7553  
7554  =back
7555  
7556  =item Documentation
7557  
7558  =over 4
7559  
7560  =item Perl Glossary
7561  
7562  =back
7563  
7564  =item Performance Enhancements
7565  
7566  =over 4
7567  
7568  =item XS-assisted SWASHGET
7569  
7570  =item Constant subroutines
7571  
7572  =item C<PERL_DONT_CREATE_GVSV>
7573  
7574  =item Weak references are cheaper
7575  
7576  =item sort() enhancements
7577  
7578  =back
7579  
7580  =item Installation and Configuration Improvements
7581  
7582  =over 4
7583  
7584  =item Compilation improvements
7585  
7586  =item New Or Improved Platforms
7587  
7588  =item New probes
7589  
7590  =item Module auxiliary files
7591  
7592  =back
7593  
7594  =item Selected Bug Fixes
7595  
7596  =over 4
7597  
7598  =item C<defined $$x>
7599  
7600  =item Calling CORE::require()
7601  
7602  =item Subscripts of slices
7603  
7604  =item Remove over-optimisation
7605  
7606  =item sprintf() fixes
7607  
7608  =item no warnings 'category' works correctly with -w
7609  
7610  =item Smaller fixes
7611  
7612  =item More Unicode Fixes
7613  
7614  =back
7615  
7616  =item New or Changed Diagnostics
7617  
7618  =over 4
7619  
7620  =item Attempt to set length of freed array
7621  
7622  =item Non-string passed as bitmask
7623  
7624  =item Search pattern not terminated or ternary operator parsed as search
7625  pattern
7626  
7627  =item "%s" variable %s masks earlier declaration
7628  
7629  =item readdir()/closedir()/etc. attempted on invalid dirhandle
7630  
7631  =back
7632  
7633  =item Changed Internals
7634  
7635  =over 4
7636  
7637  =item B:: modules inheritance changed
7638  
7639  =back
7640  
7641  =item Reporting Bugs
7642  
7643  =item SEE ALSO
7644  
7645  =back
7646  
7647  =head2 perl592delta - what is new for perl v5.9.2
7648  
7649  =over 4
7650  
7651  =item DESCRIPTION
7652  
7653  =item Incompatible Changes
7654  
7655  =over 4
7656  
7657  =item Packing and UTF-8 strings
7658  
7659  =item Miscellaneous
7660  
7661  =back
7662  
7663  =item Core Enhancements
7664  
7665  =over 4
7666  
7667  =item Malloc wrapping
7668  
7669  =item Unicode Character Database 4.0.1
7670  
7671  =item suidperl less insecure
7672  
7673  =item PERLIO_DEBUG
7674  
7675  =item Formats
7676  
7677  =item Unicode Character Classes
7678  
7679  =item Byte-order modifiers for pack() and unpack()
7680  
7681  =item Byte count feature in pack()
7682  
7683  =item New variables
7684  
7685  =back
7686  
7687  =item Modules and Pragmata
7688  
7689  =over 4
7690  
7691  =item New modules
7692  
7693  =item Updated And Improved Modules and Pragmata
7694  
7695  B::Concise, Socket, Sys::Syslog, threads
7696  
7697  =back
7698  
7699  =item Utility Changes
7700  
7701  =item Performance Enhancements
7702  
7703  =item Installation and Configuration Improvements
7704  
7705  =item Selected Bug Fixes
7706  
7707  =item New or Changed Diagnostics
7708  
7709  =item Changed Internals
7710  
7711  =item Known Problems
7712  
7713  =item Plans for the next release
7714  
7715  =item Reporting Bugs
7716  
7717  =item SEE ALSO
7718  
7719  =back
7720  
7721  =head2 perl591delta - what is new for perl v5.9.1
7722  
7723  =over 4
7724  
7725  =item DESCRIPTION
7726  
7727  =item Incompatible Changes
7728  
7729  =over 4
7730  
7731  =item substr() lvalues are no longer fixed-length
7732  
7733  =item The C<:unique> attribute is only meaningful for globals
7734  
7735  =back
7736  
7737  =item Core Enhancements
7738  
7739  =over 4
7740  
7741  =item Lexical C<$_>
7742  
7743  =item Tied hashes in scalar context
7744  
7745  =item Formats
7746  
7747  =item Stacked filetest operators
7748  
7749  =back
7750  
7751  =item Modules and Pragmata
7752  
7753  Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
7754  
7755  =item Utility Changes
7756  
7757  =item Documentation
7758  
7759  =item Performance Enhancements
7760  
7761  =item Selected Bug Fixes
7762  
7763  =over 4
7764  
7765  =item UTF-8 bugs
7766  
7767  =item Threading bugs
7768  
7769  =item More bugs
7770  
7771  =back
7772  
7773  =item New or Changed Diagnostics
7774  
7775  =item Changed Internals
7776  
7777  =over 4
7778  
7779  =item Reordering of SVt_* constants
7780  
7781  =item Removal of CPP symbols
7782  
7783  =item Less space is used by ops
7784  
7785  =item New parser
7786  
7787  =back
7788  
7789  =item Configuration and Building
7790  
7791  =item Known Problems
7792  
7793  =over 4
7794  
7795  =item Platform Specific Problems
7796  
7797  =back
7798  
7799  =item To-do for perl 5.10.0
7800  
7801  =item Reporting Bugs
7802  
7803  =item SEE ALSO
7804  
7805  =back
7806  
7807  =head2 perl590delta - what is new for perl v5.9.0
7808  
7809  =over 4
7810  
7811  =item DESCRIPTION
7812  
7813  =item Incompatible Changes
7814  
7815  =over 4
7816  
7817  =item Hash Randomisation
7818  
7819  =item UTF-8 On Filehandles No Longer Activated By Locale
7820  
7821  =item Single-number v-strings are no longer v-strings before "=>"
7822  
7823  =item (Win32) The -C Switch Has Been Repurposed
7824  
7825  =item (Win32) The /d Switch Of cmd.exe
7826  
7827  =item The C<$*> variable has been removed
7828  
7829  =back
7830  
7831  =item Core Enhancements
7832  
7833  =over 4
7834  
7835  =item Assertions
7836  
7837  =item Defined-or operators
7838  
7839  =item UTF-8 no longer default under UTF-8 locales
7840  
7841  =item Unsafe signals again available
7842  
7843  =item Tied Arrays with Negative Array Indices
7844  
7845  =item local ${$x}
7846  
7847  =item Unicode Character Database 4.0.0
7848  
7849  =item Miscellaneous Enhancements
7850  
7851  =back
7852  
7853  =item Modules and Pragmata
7854  
7855  =over 4
7856  
7857  =item Updated Modules And Pragmata
7858  
7859  base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
7860  CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
7861  Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
7862  PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
7863  Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
7864  Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
7865  Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
7866  Win32::GetOSVersion
7867  
7868  =back
7869  
7870  =item Utility Changes
7871  
7872  =item New Documentation
7873  
7874  =item Performance Enhancements
7875  
7876  =item Installation and Configuration Improvements
7877  
7878  =over 4
7879  
7880  =item Platform-specific enhancements
7881  
7882  =back
7883  
7884  =item Selected Bug Fixes
7885  
7886  =over 4
7887  
7888  =item Closures, eval and lexicals
7889  
7890  =item Generic fixes
7891  
7892  =item Platform-specific fixes
7893  
7894  =back
7895  
7896  =item New or Changed Diagnostics
7897  
7898  =over 4
7899  
7900  =item Changed "A thread exited while %d threads were running"
7901  
7902  =item Removed "Attempt to clear a restricted hash"
7903  
7904  =item New "Illegal declaration of anonymous subroutine"
7905  
7906  =item Changed "Invalid range "%s" in transliteration operator"
7907  
7908  =item New "Missing control char name in \c"
7909  
7910  =item New "Newline in left-justified string for %s"
7911  
7912  =item New "Possible precedence problem on bitwise %c operator"
7913  
7914  =item New "read() on %s filehandle %s"
7915  
7916  =item New "Tied variable freed while still in use"
7917  
7918  =item New "To%s: illegal mapping '%s'"
7919  
7920  =item New "Use of freed value in iteration"
7921  
7922  =back
7923  
7924  =item Changed Internals
7925  
7926  =item New Tests
7927  
7928  =item Known Problems
7929  
7930  =over 4
7931  
7932  =item Tied hashes in scalar context
7933  
7934  =item Net::Ping 450_service and 510_ping_udp failures
7935  
7936  =item B::C
7937  
7938  =back
7939  
7940  =item Platform Specific Problems
7941  
7942  =over 4
7943  
7944  =item EBCDIC Platforms
7945  
7946  =item Cygwin 1.5 problems
7947  
7948  =item HP-UX: HP cc warnings about sendfile and sendpath
7949  
7950  =item IRIX: t/uni/tr_7jis.t falsely failing
7951  
7952  =item Mac OS X: no usemymalloc
7953  
7954  =item Tru64: No threaded builds with GNU cc (gcc)
7955  
7956  =item Win32: sysopen, sysread, syswrite
7957  
7958  =back
7959  
7960  =item TODO
7961  
7962  =item Reporting Bugs
7963  
7964  =item SEE ALSO
7965  
7966  =back
7967  
7968  =head2 perl588delta - what is new for perl v5.8.8
7969  
7970  =over 4
7971  
7972  =item DESCRIPTION
7973  
7974  =item Incompatible Changes
7975  
7976  =item Core Enhancements
7977  
7978  =item Modules and Pragmata
7979  
7980  =item Utility Changes
7981  
7982  =over 4
7983  
7984  =item C<h2xs> enhancements
7985  
7986  =item C<perlivp> enhancements
7987  
7988  =back
7989  
7990  =item New Documentation
7991  
7992  =item Performance Enhancements
7993  
7994  =item Installation and Configuration Improvements
7995  
7996  =item Selected Bug Fixes
7997  
7998  =over 4
7999  
8000  =item no warnings 'category' works correctly with -w
8001  
8002  =item Remove over-optimisation
8003  
8004  =item sprintf() fixes
8005  
8006  =item Debugger and Unicode slowdown
8007  
8008  =item Smaller fixes
8009  
8010  =back
8011  
8012  =item New or Changed Diagnostics
8013  
8014  =over 4
8015  
8016  =item Attempt to set length of freed array
8017  
8018  =item Non-string passed as bitmask
8019  
8020  =item Search pattern not terminated or ternary operator parsed as search
8021  pattern
8022  
8023  =back
8024  
8025  =item Changed Internals
8026  
8027  =item Platform Specific Problems
8028  
8029  =item Reporting Bugs
8030  
8031  =item SEE ALSO
8032  
8033  =back
8034  
8035  =head2 perl587delta - what is new for perl v5.8.7
8036  
8037  =over 4
8038  
8039  =item DESCRIPTION
8040  
8041  =item Incompatible Changes
8042  
8043  =item Core Enhancements
8044  
8045  =over 4
8046  
8047  =item Unicode Character Database 4.1.0
8048  
8049  =item suidperl less insecure
8050  
8051  =item Optional site customization script
8052  
8053  =item C<Config.pm> is now much smaller.
8054  
8055  =back
8056  
8057  =item Modules and Pragmata
8058  
8059  =item Utility Changes
8060  
8061  =over 4
8062  
8063  =item find2perl enhancements
8064  
8065  =back
8066  
8067  =item Performance Enhancements
8068  
8069  =item Installation and Configuration Improvements
8070  
8071  =item Selected Bug Fixes
8072  
8073  =item New or Changed Diagnostics
8074  
8075  =item Changed Internals
8076  
8077  =item Known Problems
8078  
8079  =item Platform Specific Problems
8080  
8081  =item Reporting Bugs
8082  
8083  =item SEE ALSO
8084  
8085  =back
8086  
8087  =head2 perl586delta - what is new for perl v5.8.6
8088  
8089  =over 4
8090  
8091  =item DESCRIPTION
8092  
8093  =item Incompatible Changes
8094  
8095  =item Core Enhancements
8096  
8097  =item Modules and Pragmata
8098  
8099  =item Utility Changes
8100  
8101  =item Performance Enhancements
8102  
8103  =item Selected Bug Fixes
8104  
8105  =item New or Changed Diagnostics
8106  
8107  =item Changed Internals
8108  
8109  =item New Tests
8110  
8111  =item Reporting Bugs
8112  
8113  =item SEE ALSO
8114  
8115  =back
8116  
8117  =head2 perl585delta - what is new for perl v5.8.5
8118  
8119  =over 4
8120  
8121  =item DESCRIPTION
8122  
8123  =item Incompatible Changes
8124  
8125  =item Core Enhancements
8126  
8127  =item Modules and Pragmata
8128  
8129  =item Utility Changes
8130  
8131  =over 4
8132  
8133  =item Perl's debugger
8134  
8135  =item h2ph
8136  
8137  =back
8138  
8139  =item Installation and Configuration Improvements
8140  
8141  =item Selected Bug Fixes
8142  
8143  =item New or Changed Diagnostics
8144  
8145  =item Changed Internals
8146  
8147  =item Known Problems
8148  
8149  =item Platform Specific Problems
8150  
8151  =item Reporting Bugs
8152  
8153  =item SEE ALSO
8154  
8155  =back
8156  
8157  =head2 perl584delta - what is new for perl v5.8.4
8158  
8159  =over 4
8160  
8161  =item DESCRIPTION
8162  
8163  =item Incompatible Changes
8164  
8165  =item Core Enhancements
8166  
8167  =over 4
8168  
8169  =item Malloc wrapping
8170  
8171  =item Unicode Character Database 4.0.1
8172  
8173  =item suidperl less insecure
8174  
8175  =item format
8176  
8177  =back
8178  
8179  =item Modules and Pragmata
8180  
8181  =over 4
8182  
8183  =item Updated modules
8184  
8185  Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
8186  IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
8187  Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
8188  Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
8189  base, open, threads, utf8
8190  
8191  =back
8192  
8193  =item Performance Enhancements
8194  
8195  =item Utility Changes
8196  
8197  =item Installation and Configuration Improvements
8198  
8199  =item Selected Bug Fixes
8200  
8201  =item New or Changed Diagnostics
8202  
8203  =item Changed Internals
8204  
8205  =item Future Directions
8206  
8207  =item Platform Specific Problems
8208  
8209  =item Reporting Bugs
8210  
8211  =item SEE ALSO
8212  
8213  =back
8214  
8215  =head2 perl583delta - what is new for perl v5.8.3
8216  
8217  =over 4
8218  
8219  =item DESCRIPTION
8220  
8221  =item Incompatible Changes
8222  
8223  =item Core Enhancements
8224  
8225  =item Modules and Pragmata
8226  
8227  CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
8228  Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
8229  Unicode::Normalize, Test::Harness, threads::shared
8230  
8231  =item Utility Changes
8232  
8233  =item New Documentation
8234  
8235  =item Installation and Configuration Improvements
8236  
8237  =item Selected Bug Fixes
8238  
8239  =item New or Changed Diagnostics
8240  
8241  =item Changed Internals
8242  
8243  =item Configuration and Building
8244  
8245  =item Platform Specific Problems
8246  
8247  =item Known Problems
8248  
8249  =item Future Directions
8250  
8251  =item Obituary
8252  
8253  =item Reporting Bugs
8254  
8255  =item SEE ALSO
8256  
8257  =back
8258  
8259  =head2 perl582delta - what is new for perl v5.8.2
8260  
8261  =over 4
8262  
8263  =item DESCRIPTION
8264  
8265  =item Incompatible Changes
8266  
8267  =item Core Enhancements
8268  
8269  =over 4
8270  
8271  =item Hash Randomisation
8272  
8273  =item Threading
8274  
8275  =back
8276  
8277  =item Modules and Pragmata
8278  
8279  =over 4
8280  
8281  =item Updated Modules And Pragmata
8282  
8283  Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
8284  Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
8285  Unicode::Normalize, UNIVERSAL
8286  
8287  =back
8288  
8289  =item Selected Bug Fixes
8290  
8291  =item Changed Internals
8292  
8293  =item Platform Specific Problems
8294  
8295  =item Future Directions
8296  
8297  =item Reporting Bugs
8298  
8299  =item SEE ALSO
8300  
8301  =back
8302  
8303  =head2 perl581delta - what is new for perl v5.8.1
8304  
8305  =over 4
8306  
8307  =item DESCRIPTION
8308  
8309  =item Incompatible Changes
8310  
8311  =over 4
8312  
8313  =item Hash Randomisation
8314  
8315  =item UTF-8 On Filehandles No Longer Activated By Locale
8316  
8317  =item Single-number v-strings are no longer v-strings before "=>"
8318  
8319  =item (Win32) The -C Switch Has Been Repurposed
8320  
8321  =item (Win32) The /d Switch Of cmd.exe
8322  
8323  =back
8324  
8325  =item Core Enhancements
8326  
8327  =over 4
8328  
8329  =item UTF-8 no longer default under UTF-8 locales
8330  
8331  =item Unsafe signals again available
8332  
8333  =item Tied Arrays with Negative Array Indices
8334  
8335  =item local ${$x}
8336  
8337  =item Unicode Character Database 4.0.0
8338  
8339  =item Deprecation Warnings
8340  
8341  =item Miscellaneous Enhancements
8342  
8343  =back
8344  
8345  =item Modules and Pragmata
8346  
8347  =over 4
8348  
8349  =item Updated Modules And Pragmata
8350  
8351  base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
8352  CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
8353  Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
8354  PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
8355  Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
8356  Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
8357  Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
8358  Win32::GetOSVersion
8359  
8360  =back
8361  
8362  =item Utility Changes
8363  
8364  =item New Documentation
8365  
8366  =item Installation and Configuration Improvements
8367  
8368  =over 4
8369  
8370  =item Platform-specific enhancements
8371  
8372  =back
8373  
8374  =item Selected Bug Fixes
8375  
8376  =over 4
8377  
8378  =item Closures, eval and lexicals
8379  
8380  =item Generic fixes
8381  
8382  =item Platform-specific fixes
8383  
8384  =back
8385  
8386  =item New or Changed Diagnostics
8387  
8388  =over 4
8389  
8390  =item Changed "A thread exited while %d threads were running"
8391  
8392  =item Removed "Attempt to clear a restricted hash"
8393  
8394  =item New "Illegal declaration of anonymous subroutine"
8395  
8396  =item Changed "Invalid range "%s" in transliteration operator"
8397  
8398  =item New "Missing control char name in \c"
8399  
8400  =item New "Newline in left-justified string for %s"
8401  
8402  =item New "Possible precedence problem on bitwise %c operator"
8403  
8404  =item New "Pseudo-hashes are deprecated"
8405  
8406  =item New "read() on %s filehandle %s"
8407  
8408  =item New "5.005 threads are deprecated"
8409  
8410  =item New "Tied variable freed while still in use"
8411  
8412  =item New "To%s: illegal mapping '%s'"
8413  
8414  =item New "Use of freed value in iteration"
8415  
8416  =back
8417  
8418  =item Changed Internals
8419  
8420  =item New Tests
8421  
8422  =item Known Problems
8423  
8424  =over 4
8425  
8426  =item Tied hashes in scalar context
8427  
8428  =item Net::Ping 450_service and 510_ping_udp failures
8429  
8430  =item B::C
8431  
8432  =back
8433  
8434  =item Platform Specific Problems
8435  
8436  =over 4
8437  
8438  =item EBCDIC Platforms
8439  
8440  =item Cygwin 1.5 problems
8441  
8442  =item HP-UX: HP cc warnings about sendfile and sendpath
8443  
8444  =item IRIX: t/uni/tr_7jis.t falsely failing
8445  
8446  =item Mac OS X: no usemymalloc
8447  
8448  =item Tru64: No threaded builds with GNU cc (gcc)
8449  
8450  =item Win32: sysopen, sysread, syswrite
8451  
8452  =back
8453  
8454  =item Future Directions
8455  
8456  =item Reporting Bugs
8457  
8458  =item SEE ALSO
8459  
8460  =back
8461  
8462  =head2 perl58delta - what is new for perl v5.8.0
8463  
8464  =over 4
8465  
8466  =item DESCRIPTION
8467  
8468  =item Highlights In 5.8.0
8469  
8470  =item Incompatible Changes
8471  
8472  =over 4
8473  
8474  =item Binary Incompatibility
8475  
8476  =item 64-bit platforms and malloc
8477  
8478  =item AIX Dynaloading
8479  
8480  =item Attributes for C<my> variables now handled at run-time
8481  
8482  =item Socket Extension Dynamic in VMS
8483  
8484  =item IEEE-format Floating Point Default on OpenVMS Alpha
8485  
8486  =item New Unicode Semantics (no more C<use utf8>, almost)
8487  
8488  =item New Unicode Properties
8489  
8490  =item REF(...) Instead Of SCALAR(...)
8491  
8492  =item pack/unpack D/F recycled
8493  
8494  =item glob() now returns filenames in alphabetical order
8495  
8496  =item Deprecations
8497  
8498  =back
8499  
8500  =item Core Enhancements
8501  
8502  =over 4
8503  
8504  =item Unicode Overhaul
8505  
8506  =item PerlIO is Now The Default
8507  
8508  =item ithreads
8509  
8510  =item Restricted Hashes
8511  
8512  =item Safe Signals
8513  
8514  =item Understanding of Numbers
8515  
8516  =item Arrays now always interpolate into double-quoted strings [561]
8517  
8518  =item Miscellaneous Changes
8519  
8520  =back
8521  
8522  =item Modules and Pragmata
8523  
8524  =over 4
8525  
8526  =item New Modules and Pragmata
8527  
8528  =item Updated And Improved Modules and Pragmata
8529  
8530  =back
8531  
8532  =item Utility Changes
8533  
8534  =item New Documentation
8535  
8536  =item Performance Enhancements
8537  
8538  =item Installation and Configuration Improvements
8539  
8540  =over 4
8541  
8542  =item Generic Improvements
8543  
8544  =item New Or Improved Platforms
8545  
8546  =back
8547  
8548  =item Selected Bug Fixes
8549  
8550  =over 4
8551  
8552  =item Platform Specific Changes and Fixes
8553  
8554  =back
8555  
8556  =item New or Changed Diagnostics
8557  
8558  =item Changed Internals
8559  
8560  =item Security Vulnerability Closed [561]
8561  
8562  =item New Tests
8563  
8564  =item Known Problems
8565  
8566  =over 4
8567  
8568  =item The Compiler Suite Is Still Very Experimental
8569  
8570  =item Localising Tied Arrays and Hashes Is Broken
8571  
8572  =item Building Extensions Can Fail Because Of Largefiles
8573  
8574  =item Modifying $_ Inside for(..)
8575  
8576  =item mod_perl 1.26 Doesn't Build With Threaded Perl
8577  
8578  =item lib/ftmp-security tests warn 'system possibly insecure'
8579  
8580  =item libwww-perl (LWP) fails base/date #51
8581  
8582  =item PDL failing some tests
8583  
8584  =item Perl_get_sv
8585  
8586  =item Self-tying Problems
8587  
8588  =item ext/threads/t/libc
8589  
8590  =item Failure of Thread (5.005-style) tests
8591  
8592  =item Timing problems
8593  
8594  =item Tied/Magical Array/Hash Elements Do Not Autovivify
8595  
8596  =item Unicode in package/class and subroutine names does not work
8597  
8598  =back
8599  
8600  =item Platform Specific Problems
8601  
8602  =over 4
8603  
8604  =item AIX
8605  
8606  =item Alpha systems with old gccs fail several tests
8607  
8608  =item AmigaOS
8609  
8610  =item BeOS
8611  
8612  =item Cygwin "unable to remap"
8613  
8614  =item Cygwin ndbm tests fail on FAT
8615  
8616  =item DJGPP Failures
8617  
8618  =item FreeBSD built with ithreads coredumps reading large directories
8619  
8620  =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
8621  
8622  =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
8623  
8624  =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
8625  
8626  =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
8627  
8628  =item Linux With Sfio Fails op/misc Test 48
8629  
8630  =item Mac OS X
8631  
8632  =item Mac OS X dyld undefined symbols
8633  
8634  =item OS/2 Test Failures
8635  
8636  =item op/sprintf tests 91, 129, and 130
8637  
8638  =item SCO
8639  
8640  =item Solaris 2.5
8641  
8642  =item Solaris x86 Fails Tests With -Duse64bitint
8643  
8644  =item SUPER-UX (NEC SX)
8645  
8646  =item Term::ReadKey not working on Win32
8647  
8648  =item UNICOS/mk
8649  
8650  =item UTS
8651  
8652  =item VOS (Stratus)
8653  
8654  =item VMS
8655  
8656  =item Win32
8657  
8658  =item XML::Parser not working
8659  
8660  =item z/OS (OS/390)
8661  
8662  =item Unicode Support on EBCDIC Still Spotty
8663  
8664  =item Seen In Perl 5.7 But Gone Now
8665  
8666  =back
8667  
8668  =item Reporting Bugs
8669  
8670  =item SEE ALSO
8671  
8672  =item HISTORY
8673  
8674  =back
8675  
8676  =head2 perl573delta - what's new for perl v5.7.3
8677  
8678  =over 4
8679  
8680  =item DESCRIPTION
8681  
8682  =item Changes
8683  
8684  =item Reporting Bugs
8685  
8686  =item SEE ALSO
8687  
8688  =item HISTORY
8689  
8690  =back
8691  
8692  =head2 perl572delta - what's new for perl v5.7.2
8693  
8694  =over 4
8695  
8696  =item DESCRIPTION
8697  
8698  =item Security Vulnerability Closed
8699  
8700  =item Incompatible Changes
8701  
8702  =over 4
8703  
8704  =item 64-bit platforms and malloc
8705  
8706  =item AIX Dynaloading
8707  
8708  =item Socket Extension Dynamic in VMS
8709  
8710  =item Different Definition of the Unicode Character Classes \p{In...}
8711  
8712  =item Deprecations
8713  
8714  =back
8715  
8716  =item Core Enhancements
8717  
8718  =item Modules and Pragmata
8719  
8720  =over 4
8721  
8722  =item New Modules and Distributions
8723  
8724  =item Updated And Improved Modules and Pragmata
8725  
8726  =back
8727  
8728  =item Utility Changes
8729  
8730  =item New Documentation
8731  
8732  =item Installation and Configuration Improvements
8733  
8734  =over 4
8735  
8736  =item New Or Improved Platforms
8737  
8738  =item Generic Improvements
8739  
8740  =back
8741  
8742  =item Selected Bug Fixes
8743  
8744  =over 4
8745  
8746  =item Platform Specific Changes and Fixes
8747  
8748  =back
8749  
8750  =item New or Changed Diagnostics
8751  
8752  =item Source Code Enhancements
8753  
8754  =over 4
8755  
8756  =item MAGIC constants
8757  
8758  =item Better commented code
8759  
8760  =item Regex pre-/post-compilation items matched up
8761  
8762  =item gcc -Wall
8763  
8764  =back
8765  
8766  =item New Tests
8767  
8768  =item Known Problems
8769  
8770  =over 4
8771  
8772  =item AIX
8773  
8774  =item Amiga Perl Invoking Mystery
8775  
8776  =item lib/ftmp-security tests warn 'system possibly insecure'
8777  
8778  =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
8779  
8780  =item HP-UX lib/io_multihomed Fails When LP64-Configured
8781  
8782  =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
8783  
8784  =item Linux With Sfio Fails op/misc Test 48
8785  
8786  =item OS/390
8787  
8788  =item op/sprintf tests 129 and 130
8789  
8790  =item  Failure of Thread tests
8791  
8792  =item UNICOS
8793  
8794  =item UTS
8795  
8796  =item VMS
8797  
8798  =item Win32
8799  
8800  =item Localising a Tied Variable Leaks Memory
8801  
8802  =item Self-tying of Arrays and Hashes Is Forbidden
8803  
8804  =item Variable Attributes are not Currently Usable for Tieing
8805  
8806  =item Building Extensions Can Fail Because Of Largefiles
8807  
8808  =item The Compiler Suite Is Still Experimental
8809  
8810  =item The Long Double Support is Still Experimental
8811  
8812  =back
8813  
8814  =item Reporting Bugs
8815  
8816  =item SEE ALSO
8817  
8818  =item HISTORY
8819  
8820  =back
8821  
8822  =head2 perl571delta - what's new for perl v5.7.1
8823  
8824  =over 4
8825  
8826  =item DESCRIPTION
8827  
8828  =item Security Vulnerability Closed
8829  
8830  =item Incompatible Changes
8831  
8832  =item Core Enhancements
8833  
8834  =over 4
8835  
8836  =item AUTOLOAD Is Now Lvaluable
8837  
8838  =item PerlIO is Now The Default
8839  
8840  =item Signals Are Now Safe
8841  
8842  =back
8843  
8844  =item Modules and Pragmata
8845  
8846  =over 4
8847  
8848  =item New Modules
8849  
8850  =item Updated And Improved Modules and Pragmata
8851  
8852  =back
8853  
8854  =item Performance Enhancements
8855  
8856  =item Utility Changes
8857  
8858  =item New Documentation
8859  
8860  =over 4
8861  
8862  =item perlclib
8863  
8864  =item perliol
8865  
8866  =item README.aix
8867  
8868  =item README.bs2000
8869  
8870  =item README.macos
8871  
8872  =item README.mpeix
8873  
8874  =item README.solaris
8875  
8876  =item README.vos
8877  
8878  =item Porting/repository.pod
8879  
8880  =back
8881  
8882  =item Installation and Configuration Improvements
8883  
8884  =over 4
8885  
8886  =item New Or Improved Platforms
8887  
8888  =item Generic Improvements
8889  
8890  d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
8891  need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
8892  d_strtoq, d_u32align, d_ualarm, d_usleep
8893  
8894  =back
8895  
8896  =item Selected Bug Fixes
8897  
8898  =over 4
8899  
8900  =item Platform Specific Changes and Fixes
8901  
8902  =back
8903  
8904  =item New or Changed Diagnostics
8905  
8906  =item Changed Internals
8907  
8908  =item New Tests
8909  
8910  =item Known Problems
8911  
8912  =over 4
8913  
8914  =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
8915  
8916  =item lib/ftmp-security tests warn 'system possibly insecure'
8917  
8918  =item lib/io_multihomed Fails In LP64-Configured HP-UX
8919  
8920  =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
8921  
8922  =item lib/b test 19
8923  
8924  =item Linux With Sfio Fails op/misc Test 48
8925  
8926  =item sigaction test 13 in VMS
8927  
8928  =item sprintf tests 129 and 130
8929  
8930  =item  Failure of Thread tests
8931  
8932  =item Localising a Tied Variable Leaks Memory
8933  
8934  =item Self-tying of Arrays and Hashes Is Forbidden
8935  
8936  =item Building Extensions Can Fail Because Of Largefiles
8937  
8938  =item The Compiler Suite Is Still Experimental
8939  
8940  =back
8941  
8942  =item Reporting Bugs
8943  
8944  =item SEE ALSO
8945  
8946  =item HISTORY
8947  
8948  =back
8949  
8950  =head2 perl570delta - what's new for perl v5.7.0
8951  
8952  =over 4
8953  
8954  =item DESCRIPTION
8955  
8956  =item Security Vulnerability Closed
8957  
8958  =item Incompatible Changes
8959  
8960  =item Core Enhancements
8961  
8962  =item Modules and Pragmata
8963  
8964  =over 4
8965  
8966  =item New Modules
8967  
8968  =item Updated And Improved Modules and Pragmata
8969  
8970  =back
8971  
8972  =item Utility Changes
8973  
8974  =item New Documentation
8975  
8976  =item Performance Enhancements
8977  
8978  =item Installation and Configuration Improvements
8979  
8980  =over 4
8981  
8982  =item Generic Improvements
8983  
8984  =back
8985  
8986  =item Selected Bug Fixes
8987  
8988  =over 4
8989  
8990  =item Platform Specific Changes and Fixes
8991  
8992  =back
8993  
8994  =item New or Changed Diagnostics
8995  
8996  =item Changed Internals
8997  
8998  =item Known Problems
8999  
9000  =over 4
9001  
9002  =item Unicode Support Still Far From Perfect
9003  
9004  =item EBCDIC Still A Lost Platform
9005  
9006  =item Building Extensions Can Fail Because Of Largefiles
9007  
9008  =item ftmp-security tests warn 'system possibly insecure'
9009  
9010  =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
9011  
9012  =item Long Doubles Still Don't Work In Solaris
9013  
9014  =item Linux With Sfio Fails op/misc Test 48
9015  
9016  =item Storable tests fail in some platforms
9017  
9018  =item Threads Are Still Experimental
9019  
9020  =item The Compiler Suite Is Still Experimental
9021  
9022  =back
9023  
9024  =item Reporting Bugs
9025  
9026  =item SEE ALSO
9027  
9028  =item HISTORY
9029  
9030  =back
9031  
9032  =head2 perl561delta - what's new for perl v5.6.x
9033  
9034  =over 4
9035  
9036  =item DESCRIPTION
9037  
9038  =item Summary of changes between 5.6.0 and 5.6.1
9039  
9040  =over 4
9041  
9042  =item Security Issues
9043  
9044  =item Core bug fixes
9045  
9046  C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
9047  Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
9048  references to special variables, Lexical warnings, Spurious warnings and
9049  errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
9050  map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
9051  Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
9052  Module;>, Tests
9053  
9054  =item Core features
9055  
9056  =item Configuration issues
9057  
9058  =item Documentation
9059  
9060  =item Bundled modules
9061  
9062  B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
9063  Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
9064  IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
9065  Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
9066  
9067  =item Platform-specific improvements
9068  
9069  NCR MP-RAS, NonStop-UX
9070  
9071  =back
9072  
9073  =item Core Enhancements
9074  
9075  =over 4
9076  
9077  =item Interpreter cloning, threads, and concurrency
9078  
9079  =item Lexically scoped warning categories
9080  
9081  =item Unicode and UTF-8 support
9082  
9083  =item Support for interpolating named characters
9084  
9085  =item "our" declarations
9086  
9087  =item Support for strings represented as a vector of ordinals
9088  
9089  =item Improved Perl version numbering system
9090  
9091  =item New syntax for declaring subroutine attributes
9092  
9093  =item File and directory handles can be autovivified
9094  
9095  =item open() with more than two arguments
9096  
9097  =item 64-bit support
9098  
9099  =item Large file support
9100  
9101  =item Long doubles
9102  
9103  =item "more bits"
9104  
9105  =item Enhanced support for sort() subroutines
9106  
9107  =item C<sort $coderef @foo> allowed
9108  
9109  =item File globbing implemented internally
9110  
9111  =item Support for CHECK blocks
9112  
9113  =item POSIX character class syntax [: :] supported
9114  
9115  =item Better pseudo-random number generator
9116  
9117  =item Improved C<qw//> operator
9118  
9119  =item Better worst-case behavior of hashes
9120  
9121  =item pack() format 'Z' supported
9122  
9123  =item pack() format modifier '!' supported
9124  
9125  =item pack() and unpack() support counted strings
9126  
9127  =item Comments in pack() templates
9128  
9129  =item Weak references
9130  
9131  =item Binary numbers supported
9132  
9133  =item Lvalue subroutines
9134  
9135  =item Some arrows may be omitted in calls through references
9136  
9137  =item Boolean assignment operators are legal lvalues
9138  
9139  =item exists() is supported on subroutine names
9140  
9141  =item exists() and delete() are supported on array elements
9142  
9143  =item Pseudo-hashes work better
9144  
9145  =item Automatic flushing of output buffers
9146  
9147  =item Better diagnostics on meaningless filehandle operations
9148  
9149  =item Where possible, buffered data discarded from duped input filehandle
9150  
9151  =item eof() has the same old magic as <>
9152  
9153  =item binmode() can be used to set :crlf and :raw modes
9154  
9155  =item C<-T> filetest recognizes UTF-8 encoded files as "text"
9156  
9157  =item system(), backticks and pipe open now reflect exec() failure
9158  
9159  =item Improved diagnostics
9160  
9161  =item Diagnostics follow STDERR
9162  
9163  =item More consistent close-on-exec behavior
9164  
9165  =item syswrite() ease-of-use
9166  
9167  =item Better syntax checks on parenthesized unary operators
9168  
9169  =item Bit operators support full native integer width
9170  
9171  =item Improved security features
9172  
9173  =item More functional bareword prototype (*)
9174  
9175  =item C<require> and C<do> may be overridden
9176  
9177  =item $^X variables may now have names longer than one character
9178  
9179  =item New variable $^C reflects C<-c> switch
9180  
9181  =item New variable $^V contains Perl version as a string
9182  
9183  =item Optional Y2K warnings
9184  
9185  =item Arrays now always interpolate into double-quoted strings
9186  
9187  =item @- and @+ provide starting/ending offsets of regex submatches
9188  
9189  =back
9190  
9191  =item Modules and Pragmata
9192  
9193  =over 4
9194  
9195  =item Modules
9196  
9197  attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
9198  DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
9199  Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
9200  File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
9201  Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
9202  podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
9203  pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
9204  Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
9205  
9206  =item Pragmata
9207  
9208  =back
9209  
9210  =item Utility Changes
9211  
9212  =over 4
9213  
9214  =item dprofpp
9215  
9216  =item find2perl
9217  
9218  =item h2xs
9219  
9220  =item perlcc
9221  
9222  =item perldoc
9223  
9224  =item The Perl Debugger
9225  
9226  =back
9227  
9228  =item Improved Documentation
9229  
9230  perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
9231  perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
9232  perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
9233  perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
9234  
9235  =item Performance enhancements
9236  
9237  =over 4
9238  
9239  =item Simple sort() using { $a <=> $b } and the like are optimized
9240  
9241  =item Optimized assignments to lexical variables
9242  
9243  =item Faster subroutine calls
9244  
9245  =item delete(), each(), values() and hash iteration are faster
9246  
9247  =back
9248  
9249  =item Installation and Configuration Improvements
9250  
9251  =over 4
9252  
9253  =item -Dusethreads means something different
9254  
9255  =item New Configure flags
9256  
9257  =item Threadedness and 64-bitness now more daring
9258  
9259  =item Long Doubles
9260  
9261  =item -Dusemorebits
9262  
9263  =item -Duselargefiles
9264  
9265  =item installusrbinperl
9266  
9267  =item SOCKS support
9268  
9269  =item C<-A> flag
9270  
9271  =item Enhanced Installation Directories
9272  
9273  =item gcc automatically tried if 'cc' does not seem to be working
9274  
9275  =back
9276  
9277  =item Platform specific changes
9278  
9279  =over 4
9280  
9281  =item Supported platforms
9282  
9283  =item DOS
9284  
9285  =item OS390 (OpenEdition MVS)
9286  
9287  =item VMS
9288  
9289  =item Win32
9290  
9291  =back
9292  
9293  =item Significant bug fixes
9294  
9295  =over 4
9296  
9297  =item <HANDLE> on empty files
9298  
9299  =item C<eval '...'> improvements
9300  
9301  =item All compilation errors are true errors
9302  
9303  =item Implicitly closed filehandles are safer
9304  
9305  =item Behavior of list slices is more consistent
9306  
9307  =item C<(\$)> prototype and C<$foo{a}>
9308  
9309  =item C<goto &sub> and AUTOLOAD
9310  
9311  =item C<-bareword> allowed under C<use integer>
9312  
9313  =item Failures in DESTROY()
9314  
9315  =item Locale bugs fixed
9316  
9317  =item Memory leaks
9318  
9319  =item Spurious subroutine stubs after failed subroutine calls
9320  
9321  =item Taint failures under C<-U>
9322  
9323  =item END blocks and the C<-c> switch
9324  
9325  =item Potential to leak DATA filehandles
9326  
9327  =back
9328  
9329  =item New or Changed Diagnostics
9330  
9331  "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
9332  implemented, "our" variable %s redeclared, '!' allowed only after types %s,
9333  / cannot take a count, / must be followed by a, A or Z, / must be followed
9334  by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
9335  \\%c passed through, /%s/: Unrecognized escape \\%c in character class
9336  passed through, /%s/ should probably be written as "%s", %s() called too
9337  early to check prototype, %s argument is not a HASH or ARRAY element, %s
9338  argument is not a HASH or ARRAY element or slice, %s argument is not a
9339  subroutine name, %s package attribute may clash with future reserved word:
9340  %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
9341  substitution pattern, Bad realloc() ignored, Bareword found in conditional,
9342  Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
9343  size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
9344  filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
9345  Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
9346  Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
9347  remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
9348  weaken a nonreference, Character class [:%s:] unknown, Character class
9349  syntax [%s] belongs inside character classes, Constant is not %s reference,
9350  constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
9351  defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
9352  "local" instead of "our"?), Document contains no data, entering effective
9353  %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
9354  output, flock() on closed filehandle %s, Global symbol "%s" requires
9355  explicit package name, Hexadecimal number > 0xffffffff non-portable,
9356  Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
9357  |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
9358  number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
9359  %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
9360  separator character %s in attribute list, Invalid separator character %s in
9361  subroutine attribute list, leaving effective %s failed, Lvalue subs
9362  returning %s not implemented yet, Method %s not permitted, Missing
9363  %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
9364  No %s specified for -%c, No package name allowed for variable %s in "our",
9365  No space allowed after -%c, no UTC offset information; assuming local time
9366  is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
9367  panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
9368  around "%s" list, Possible unintended interpolation of %s in string,
9369  Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
9370  instead, Premature end of script headers, Repeat count in pack overflows,
9371  Repeat count in unpack overflows, realloc() of freed memory ignored,
9372  Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
9373  zero-length expression, switching effective %s is not implemented, This
9374  Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
9375  environ elements (%s=%s), Too late to run %s block, Unknown open() mode
9376  '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
9377  escape \\%c passed through, Unterminated attribute parameter in attribute
9378  list, Unterminated attribute list, Unterminated attribute parameter in
9379  subroutine attribute list, Unterminated subroutine attribute list, Value of
9380  CLI symbol "%s" too long, Version number must be a constant number
9381  
9382  =item New tests
9383  
9384  =item Incompatible Changes
9385  
9386  =over 4
9387  
9388  =item Perl Source Incompatibilities
9389  
9390  CHECK is a new keyword, Treatment of list slices of undef has changed,
9391  Format of $English::PERL_VERSION is different, Literals of the form
9392  C<1.2.3> parse differently, Possibly changed pseudo-random number
9393  generator, Hashing function for hash keys has changed, C<undef> fails on
9394  read only values, Close-on-exec bit may be set on pipe and socket handles,
9395  Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
9396  values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
9397  Text of some diagnostic output has changed, C<%@> has been removed,
9398  Parenthesized not() behaves like a list operator, Semantics of bareword
9399  prototype C<(*)> have changed, Semantics of bit operators may have changed
9400  on 64-bit platforms, More builtins taint their results
9401  
9402  =item C Source Incompatibilities
9403  
9404  C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
9405  
9406  =item Compatible C Source API Changes
9407  
9408  C<PATCHLEVEL> is now C<PERL_VERSION>
9409  
9410  =item Binary Incompatibilities
9411  
9412  =back
9413  
9414  =item Known Problems
9415  
9416  =over 4
9417  
9418  =item Localizing a tied hash element may leak memory
9419  
9420  =item Known test failures
9421  
9422  =item EBCDIC platforms not fully supported
9423  
9424  =item UNICOS/mk CC failures during Configure run
9425  
9426  =item Arrow operator and arrays
9427  
9428  =item Experimental features
9429  
9430  Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
9431  pseudo-hash data type, The Compiler suite, Internal implementation of file
9432  globbing, The DB module, The regular expression code constructs:
9433  
9434  =back
9435  
9436  =item Obsolete Diagnostics
9437  
9438  Character class syntax [: :] is reserved for future extensions, Ill-formed
9439  logical name |%s| in prime_env_iter, In string, @%s now must be written as
9440  \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
9441  to mean "${$}<digit>" is deprecated
9442  
9443  =item Reporting Bugs
9444  
9445  =item SEE ALSO
9446  
9447  =item HISTORY
9448  
9449  =back
9450  
9451  =head2 perl56delta - what's new for perl v5.6.0
9452  
9453  =over 4
9454  
9455  =item DESCRIPTION
9456  
9457  =item Core Enhancements
9458  
9459  =over 4
9460  
9461  =item Interpreter cloning, threads, and concurrency
9462  
9463  =item Lexically scoped warning categories
9464  
9465  =item Unicode and UTF-8 support
9466  
9467  =item Support for interpolating named characters
9468  
9469  =item "our" declarations
9470  
9471  =item Support for strings represented as a vector of ordinals
9472  
9473  =item Improved Perl version numbering system
9474  
9475  =item New syntax for declaring subroutine attributes
9476  
9477  =item File and directory handles can be autovivified
9478  
9479  =item open() with more than two arguments
9480  
9481  =item 64-bit support
9482  
9483  =item Large file support
9484  
9485  =item Long doubles
9486  
9487  =item "more bits"
9488  
9489  =item Enhanced support for sort() subroutines
9490  
9491  =item C<sort $coderef @foo> allowed
9492  
9493  =item File globbing implemented internally
9494  
9495  =item Support for CHECK blocks
9496  
9497  =item POSIX character class syntax [: :] supported
9498  
9499  =item Better pseudo-random number generator
9500  
9501  =item Improved C<qw//> operator
9502  
9503  =item Better worst-case behavior of hashes
9504  
9505  =item pack() format 'Z' supported
9506  
9507  =item pack() format modifier '!' supported
9508  
9509  =item pack() and unpack() support counted strings
9510  
9511  =item Comments in pack() templates
9512  
9513  =item Weak references
9514  
9515  =item Binary numbers supported
9516  
9517  =item Lvalue subroutines
9518  
9519  =item Some arrows may be omitted in calls through references
9520  
9521  =item Boolean assignment operators are legal lvalues
9522  
9523  =item exists() is supported on subroutine names
9524  
9525  =item exists() and delete() are supported on array elements
9526  
9527  =item Pseudo-hashes work better
9528  
9529  =item Automatic flushing of output buffers
9530  
9531  =item Better diagnostics on meaningless filehandle operations
9532  
9533  =item Where possible, buffered data discarded from duped input filehandle
9534  
9535  =item eof() has the same old magic as <>
9536  
9537  =item binmode() can be used to set :crlf and :raw modes
9538  
9539  =item C<-T> filetest recognizes UTF-8 encoded files as "text"
9540  
9541  =item system(), backticks and pipe open now reflect exec() failure
9542  
9543  =item Improved diagnostics
9544  
9545  =item Diagnostics follow STDERR
9546  
9547  =item More consistent close-on-exec behavior
9548  
9549  =item syswrite() ease-of-use
9550  
9551  =item Better syntax checks on parenthesized unary operators
9552  
9553  =item Bit operators support full native integer width
9554  
9555  =item Improved security features
9556  
9557  =item More functional bareword prototype (*)
9558  
9559  =item C<require> and C<do> may be overridden
9560  
9561  =item $^X variables may now have names longer than one character
9562  
9563  =item New variable $^C reflects C<-c> switch
9564  
9565  =item New variable $^V contains Perl version as a string
9566  
9567  =item Optional Y2K warnings
9568  
9569  =item Arrays now always interpolate into double-quoted strings
9570  
9571  =item @- and @+ provide starting/ending offsets of regex matches
9572  
9573  =back
9574  
9575  =item Modules and Pragmata
9576  
9577  =over 4
9578  
9579  =item Modules
9580  
9581  attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
9582  DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
9583  Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
9584  File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
9585  Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
9586  podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
9587  pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
9588  Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
9589  
9590  =item Pragmata
9591  
9592  =back
9593  
9594  =item Utility Changes
9595  
9596  =over 4
9597  
9598  =item dprofpp
9599  
9600  =item find2perl
9601  
9602  =item h2xs
9603  
9604  =item perlcc
9605  
9606  =item perldoc
9607  
9608  =item The Perl Debugger
9609  
9610  =back
9611  
9612  =item Improved Documentation
9613  
9614  perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
9615  perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
9616  perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
9617  perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
9618  
9619  =item Performance enhancements
9620  
9621  =over 4
9622  
9623  =item Simple sort() using { $a <=> $b } and the like are optimized
9624  
9625  =item Optimized assignments to lexical variables
9626  
9627  =item Faster subroutine calls
9628  
9629  =item delete(), each(), values() and hash iteration are faster
9630  
9631  =back
9632  
9633  =item Installation and Configuration Improvements
9634  
9635  =over 4
9636  
9637  =item -Dusethreads means something different
9638  
9639  =item New Configure flags
9640  
9641  =item Threadedness and 64-bitness now more daring
9642  
9643  =item Long Doubles
9644  
9645  =item -Dusemorebits
9646  
9647  =item -Duselargefiles
9648  
9649  =item installusrbinperl
9650  
9651  =item SOCKS support
9652  
9653  =item C<-A> flag
9654  
9655  =item Enhanced Installation Directories
9656  
9657  =back
9658  
9659  =item Platform specific changes
9660  
9661  =over 4
9662  
9663  =item Supported platforms
9664  
9665  =item DOS
9666  
9667  =item OS390 (OpenEdition MVS)
9668  
9669  =item VMS
9670  
9671  =item Win32
9672  
9673  =back
9674  
9675  =item Significant bug fixes
9676  
9677  =over 4
9678  
9679  =item <HANDLE> on empty files
9680  
9681  =item C<eval '...'> improvements
9682  
9683  =item All compilation errors are true errors
9684  
9685  =item Implicitly closed filehandles are safer
9686  
9687  =item Behavior of list slices is more consistent
9688  
9689  =item C<(\$)> prototype and C<$foo{a}>
9690  
9691  =item C<goto &sub> and AUTOLOAD
9692  
9693  =item C<-bareword> allowed under C<use integer>
9694  
9695  =item Failures in DESTROY()
9696  
9697  =item Locale bugs fixed
9698  
9699  =item Memory leaks
9700  
9701  =item Spurious subroutine stubs after failed subroutine calls
9702  
9703  =item Taint failures under C<-U>
9704  
9705  =item END blocks and the C<-c> switch
9706  
9707  =item Potential to leak DATA filehandles
9708  
9709  =back
9710  
9711  =item New or Changed Diagnostics
9712  
9713  "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
9714  implemented, "our" variable %s redeclared, '!' allowed only after types %s,
9715  / cannot take a count, / must be followed by a, A or Z, / must be followed
9716  by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
9717  \\%c passed through, /%s/: Unrecognized escape \\%c in character class
9718  passed through, /%s/ should probably be written as "%s", %s() called too
9719  early to check prototype, %s argument is not a HASH or ARRAY element, %s
9720  argument is not a HASH or ARRAY element or slice, %s argument is not a
9721  subroutine name, %s package attribute may clash with future reserved word:
9722  %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
9723  substitution pattern, Bad realloc() ignored, Bareword found in conditional,
9724  Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
9725  size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
9726  filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
9727  Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
9728  Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
9729  remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
9730  weaken a nonreference, Character class [:%s:] unknown, Character class
9731  syntax [%s] belongs inside character classes, Constant is not %s reference,
9732  constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
9733  defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
9734  "local" instead of "our"?), Document contains no data, entering effective
9735  %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
9736  output, flock() on closed filehandle %s, Global symbol "%s" requires
9737  explicit package name, Hexadecimal number > 0xffffffff non-portable,
9738  Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
9739  |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
9740  number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
9741  %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
9742  separator character %s in attribute list, Invalid separator character %s in
9743  subroutine attribute list, leaving effective %s failed, Lvalue subs
9744  returning %s not implemented yet, Method %s not permitted, Missing
9745  %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
9746  No %s specified for -%c, No package name allowed for variable %s in "our",
9747  No space allowed after -%c, no UTC offset information; assuming local time
9748  is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
9749  panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
9750  around "%s" list, Possible unintended interpolation of %s in string,
9751  Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
9752  instead, Premature end of script headers, Repeat count in pack overflows,
9753  Repeat count in unpack overflows, realloc() of freed memory ignored,
9754  Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
9755  zero-length expression, switching effective %s is not implemented, This
9756  Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
9757  environ elements (%s=%s), Too late to run %s block, Unknown open() mode
9758  '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
9759  escape \\%c passed through, Unterminated attribute parameter in attribute
9760  list, Unterminated attribute list, Unterminated attribute parameter in
9761  subroutine attribute list, Unterminated subroutine attribute list, Value of
9762  CLI symbol "%s" too long, Version number must be a constant number
9763  
9764  =item New tests
9765  
9766  =item Incompatible Changes
9767  
9768  =over 4
9769  
9770  =item Perl Source Incompatibilities
9771  
9772  CHECK is a new keyword, Treatment of list slices of undef has changed,
9773  Format of $English::PERL_VERSION is different, Literals of the form
9774  C<1.2.3> parse differently, Possibly changed pseudo-random number
9775  generator, Hashing function for hash keys has changed, C<undef> fails on
9776  read only values, Close-on-exec bit may be set on pipe and socket handles,
9777  Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
9778  values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
9779  Text of some diagnostic output has changed, C<%@> has been removed,
9780  Parenthesized not() behaves like a list operator, Semantics of bareword
9781  prototype C<(*)> have changed, Semantics of bit operators may have changed
9782  on 64-bit platforms, More builtins taint their results
9783  
9784  =item C Source Incompatibilities
9785  
9786  C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
9787  
9788  =item Compatible C Source API Changes
9789  
9790  C<PATCHLEVEL> is now C<PERL_VERSION>
9791  
9792  =item Binary Incompatibilities
9793  
9794  =back
9795  
9796  =item Known Problems
9797  
9798  =over 4
9799  
9800  =item Thread test failures
9801  
9802  =item EBCDIC platforms not supported
9803  
9804  =item In 64-bit HP-UX the lib/io_multihomed test may hang
9805  
9806  =item NEXTSTEP 3.3 POSIX test failure
9807  
9808  =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
9809  gcc
9810  
9811  =item UNICOS/mk CC failures during Configure run
9812  
9813  =item Arrow operator and arrays
9814  
9815  =item Experimental features
9816  
9817  Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
9818  pseudo-hash data type, The Compiler suite, Internal implementation of file
9819  globbing, The DB module, The regular expression code constructs:
9820  
9821  =back
9822  
9823  =item Obsolete Diagnostics
9824  
9825  Character class syntax [: :] is reserved for future extensions, Ill-formed
9826  logical name |%s| in prime_env_iter, In string, @%s now must be written as
9827  \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
9828  to mean "${$}<digit>" is deprecated
9829  
9830  =item Reporting Bugs
9831  
9832  =item SEE ALSO
9833  
9834  =item HISTORY
9835  
9836  =back
9837  
9838  =head2 perl5005delta - what's new for perl5.005
9839  
9840  =over 4
9841  
9842  =item DESCRIPTION
9843  
9844  =item About the new versioning system
9845  
9846  =item Incompatible Changes
9847  
9848  =over 4
9849  
9850  =item WARNING:    This version is not binary compatible with Perl 5.004.
9851  
9852  =item Default installation structure has changed
9853  
9854  =item Perl Source Compatibility
9855  
9856  =item C Source Compatibility
9857  
9858  =item Binary Compatibility
9859  
9860  =item Security fixes may affect compatibility
9861  
9862  =item Relaxed new mandatory warnings introduced in 5.004
9863  
9864  =item Licensing
9865  
9866  =back
9867  
9868  =item Core Changes
9869  
9870  =over 4
9871  
9872  =item Threads
9873  
9874  =item Compiler
9875  
9876  =item Regular Expressions
9877  
9878  Many new and improved optimizations, Many bug fixes, New regular expression
9879  constructs, New operator for precompiled regular expressions, Other
9880  improvements, Incompatible changes
9881  
9882  =item    Improved malloc()
9883  
9884  =item Quicksort is internally implemented
9885  
9886  =item Reliable signals
9887  
9888  =item Reliable stack pointers
9889  
9890  =item More generous treatment of carriage returns
9891  
9892  =item Memory leaks
9893  
9894  =item Better support for multiple interpreters
9895  
9896  =item Behavior of local() on array and hash elements is now well-defined
9897  
9898  =item C<%!> is transparently tied to the L<Errno> module
9899  
9900  =item Pseudo-hashes are supported
9901  
9902  =item C<EXPR foreach EXPR> is supported
9903  
9904  =item Keywords can be globally overridden
9905  
9906  =item C<$^E> is meaningful on Win32
9907  
9908  =item C<foreach (1..1000000)> optimized
9909  
9910  =item C<Foo::> can be used as implicitly quoted package name
9911  
9912  =item C<exists $Foo::{Bar::}> tests existence of a package
9913  
9914  =item Better locale support
9915  
9916  =item Experimental support for 64-bit platforms
9917  
9918  =item prototype() returns useful results on builtins
9919  
9920  =item Extended support for exception handling
9921  
9922  =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
9923  
9924  =item All C<printf> format conversions are handled internally
9925  
9926  =item New C<INIT> keyword
9927  
9928  =item New C<lock> keyword
9929  
9930  =item New C<qr//> operator
9931  
9932  =item C<our> is now a reserved word
9933  
9934  =item Tied arrays are now fully supported
9935  
9936  =item Tied handles support is better
9937  
9938  =item 4th argument to substr
9939  
9940  =item Negative LENGTH argument to splice
9941  
9942  =item Magic lvalues are now more magical
9943  
9944  =item <> now reads in records
9945  
9946  =back
9947  
9948  =item Supported Platforms
9949  
9950  =over 4
9951  
9952  =item New Platforms
9953  
9954  =item Changes in existing support
9955  
9956  =back
9957  
9958  =item Modules and Pragmata
9959  
9960  =over 4
9961  
9962  =item New Modules
9963  
9964  B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
9965  ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
9966  Thread, attrs, fields, re
9967  
9968  =item Changes in existing modules
9969  
9970  Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
9971  MakeMaker, CPAN, Cwd
9972  
9973  =back
9974  
9975  =item Utility Changes
9976  
9977  =item Documentation Changes
9978  
9979  =item New Diagnostics
9980  
9981  Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
9982  while coercing array into hash, Bareword "%s" refers to nonexistent
9983  package, Can't call method "%s" on an undefined value, Can't check
9984  filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
9985  goto subroutine from an eval-string, Can't localize pseudo-hash element,
9986  Can't use %%! because Errno.pm is not available, Cannot find an opnumber
9987  for "%s", Character class syntax [. .] is reserved for future extensions,
9988  Character class syntax [: :] is reserved for future extensions, Character
9989  class syntax [= =] is reserved for future extensions, %s: Eval-group in
9990  insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
9991  Eval-group not allowed at run time, Explicit blessing to '' (assuming
9992  package main), Illegal hex digit ignored, No such array field, No such
9993  field "%s" in variable %s of type %s, Out of memory during ridiculously
9994  large request, Range iterator outside integer range, Recursive inheritance
9995  detected while looking for method '%s' %s, Reference found where even-sized
9996  list expected, Undefined value assigned to typeglob, Use of reserved word
9997  "%s" is deprecated, perl: warning: Setting locale failed
9998  
9999  =item Obsolete Diagnostics
10000  
10001  Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
10002  temporary file, regexp too big
10003  
10004  =item Configuration Changes
10005  
10006  =item BUGS
10007  
10008  =item SEE ALSO
10009  
10010  =item HISTORY
10011  
10012  =back
10013  
10014  =head2 perl5004delta - what's new for perl5.004
10015  
10016  =over 4
10017  
10018  =item DESCRIPTION
10019  
10020  =item Supported Environments
10021  
10022  =item Core Changes
10023  
10024  =over 4
10025  
10026  =item List assignment to %ENV works
10027  
10028  =item Change to "Can't locate Foo.pm in @INC" error
10029  
10030  =item Compilation option: Binary compatibility with 5.003
10031  
10032  =item $PERL5OPT environment variable
10033  
10034  =item Limitations on B<-M>, B<-m>, and B<-T> options
10035  
10036  =item More precise warnings
10037  
10038  =item Deprecated: Inherited C<AUTOLOAD> for non-methods
10039  
10040  =item Previously deprecated %OVERLOAD is no longer usable
10041  
10042  =item Subroutine arguments created only when they're modified
10043  
10044  =item Group vector changeable with C<$)>
10045  
10046  =item Fixed parsing of $$<digit>, &$<digit>, etc.
10047  
10048  =item Fixed localization of $<digit>, $&, etc.
10049  
10050  =item No resetting of $. on implicit close
10051  
10052  =item C<wantarray> may return undef
10053  
10054  =item C<eval EXPR> determines value of EXPR in scalar context
10055  
10056  =item Changes to tainting checks
10057  
10058  No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
10059  spawning if tainted $TERM doesn't look like a terminal name
10060  
10061  =item New Opcode module and revised Safe module
10062  
10063  =item Embedding improvements
10064  
10065  =item Internal change: FileHandle class based on IO::* classes
10066  
10067  =item Internal change: PerlIO abstraction interface
10068  
10069  =item New and changed syntax
10070  
10071  $coderef->(PARAMS)
10072  
10073  =item New and changed builtin constants
10074  
10075  __PACKAGE__
10076  
10077  =item New and changed builtin variables
10078  
10079  $^E, $^H, $^M
10080  
10081  =item New and changed builtin functions
10082  
10083  delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
10084  Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
10085  VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
10086  reset search position on failure, C<m//x> ignores whitespace before ?*+{},
10087  nested C<sub{}> closures work now, formats work right on changing lexicals
10088  
10089  =item New builtin methods
10090  
10091  isa(CLASS), can(METHOD), VERSION( [NEED] )
10092  
10093  =item TIEHANDLE now supported
10094  
10095  TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
10096  LIST, READLINE this, GETC this, DESTROY this
10097  
10098  =item Malloc enhancements
10099  
10100  -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
10101  
10102  =item Miscellaneous efficiency enhancements
10103  
10104  =back
10105  
10106  =item Support for More Operating Systems
10107  
10108  =over 4
10109  
10110  =item Win32
10111  
10112  =item Plan 9
10113  
10114  =item QNX
10115  
10116  =item AmigaOS
10117  
10118  =back
10119  
10120  =item Pragmata
10121  
10122  use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
10123  constant NAME => VALUE, use locale, use ops, use vmsish
10124  
10125  =item Modules
10126  
10127  =over 4
10128  
10129  =item Required Updates
10130  
10131  =item Installation directories
10132  
10133  =item Module information summary
10134  
10135  =item Fcntl
10136  
10137  =item IO
10138  
10139  =item Math::Complex
10140  
10141  =item Math::Trig
10142  
10143  =item DB_File
10144  
10145  =item Net::Ping
10146  
10147  =item Object-oriented overrides for builtin operators
10148  
10149  =back
10150  
10151  =item Utility Changes
10152  
10153  =over 4
10154  
10155  =item pod2html
10156  
10157  Sends converted HTML to standard output
10158  
10159  =item xsubpp
10160  
10161  C<void> XSUBs now default to returning nothing
10162  
10163  =back
10164  
10165  =item C Language API Changes
10166  
10167  C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
10168  manipulating hashes
10169  
10170  =item Documentation Changes
10171  
10172  L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
10173  L<perlmodlib>, L<perldebug>, L<perlsec>
10174  
10175  =item New Diagnostics
10176  
10177  "my" variable %s masks earlier declaration in same scope, %s argument is
10178  not a HASH element or slice, Allocation too large: %lx, Allocation too
10179  large, Applying %s to %s will act on scalar(%s), Attempt to free
10180  nonexistent shared string, Attempt to use reference as lvalue in substr,
10181  Bareword "%s" refers to nonexistent package, Can't redefine active sort
10182  subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
10183  use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
10184  subroutine %s redefined, Constant subroutine %s undefined, Copy method did
10185  not return a reference, Died, Exiting pseudo-block via %s, Identifier too
10186  long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
10187  %s, Integer overflow in hex number, Integer overflow in octal number,
10188  internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
10189  in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
10190  possible typo, Null picture in formline, Offset outside string, Out of
10191  memory!, Out of memory during request for %s, panic: frexp, Possible
10192  attempt to put comments in qw() list, Possible attempt to separate words
10193  with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
10194  while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
10195  option, untie attempted while %d inner references still exist, Unrecognized
10196  character %s, Unsupported function fork, Use of "$$<digit>" to mean
10197  "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
10198  Variable "%s" may be unavailable, Variable "%s" will not stay shared,
10199  Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
10200  Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
10201  long, Process terminated by SIG%s
10202  
10203  =item BUGS
10204  
10205  =item SEE ALSO
10206  
10207  =item HISTORY
10208  
10209  =back
10210  
10211  =head2 perlartistic - the Perl Artistic License
10212  
10213  =over 4
10214  
10215  =item SYNOPSIS
10216  
10217  =item DESCRIPTION
10218  
10219  =item The "Artistic License"
10220  
10221  =over 4
10222  
10223  =item Preamble
10224  
10225  =item Definitions
10226  
10227  "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
10228  copying fee", "Freely Available"
10229  
10230  =item Conditions
10231  
10232  a), b), c), d), a), b), c), d)
10233  
10234  =back
10235  
10236  =back
10237  
10238  =head2 perlgpl - the GNU General Public License, version 2
10239  
10240  =over 4
10241  
10242  =item SYNOPSIS
10243  
10244  =back
10245  
10246  =over 4
10247  
10248  =item DESCRIPTION
10249  
10250  =item GNU GENERAL PUBLIC LICENSE
10251  
10252  =back
10253  
10254  =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
10255  
10256  =over 4
10257  
10258  =item DESCRIPTION
10259  
10260  =over 4
10261  
10262  =item Compiling Perl 5 on AIX
10263  
10264  =item OS level
10265  
10266  =item Building Dynamic Extensions on AIX
10267  
10268  =item The IBM ANSI C Compiler
10269  
10270  =item The usenm option
10271  
10272  =item Using GNU's gcc for building perl
10273  
10274  =item Using Large Files with Perl
10275  
10276  =item Threaded Perl
10277  
10278  =item 64-bit Perl
10279  
10280  =item AIX 4.2 and extensions using C++ with statics
10281  
10282  =back
10283  
10284  =item AUTHOR
10285  
10286  =item DATE
10287  
10288  =back
10289  
10290  =head2 perlamiga - Perl under Amiga OS
10291  
10292  =over 4
10293  
10294  =item NOTE
10295  
10296  =item SYNOPSIS
10297  
10298  =back
10299  
10300  =over 4
10301  
10302  =item DESCRIPTION
10303  
10304  =over 4
10305  
10306  =item Prerequisites for Compiling Perl on AmigaOS
10307  
10308  B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
10309  
10310  =item Starting Perl programs under AmigaOS
10311  
10312  =item Shortcomings of Perl under AmigaOS
10313  
10314  =back
10315  
10316  =item INSTALLATION
10317  
10318  =item Accessing documentation
10319  
10320  =over 4
10321  
10322  =item Manpages for Perl on AmigaOS
10323  
10324  =item Perl HTML Documentation on AmigaOS
10325  
10326  =item Perl GNU Info Files on AmigaOS
10327  
10328  =item Perl LaTeX Documentation on AmigaOS
10329  
10330  =back
10331  
10332  =item BUILDING PERL ON AMIGAOS
10333  
10334  =over 4
10335  
10336  =item Build Prerequisites for Perl on AmigaOS
10337  
10338  =item Getting the Perl Source for AmigaOS
10339  
10340  =item Making Perl on AmigaOS
10341  
10342  =item Testing Perl on AmigaOS
10343  
10344  =item Installing the built Perl on AmigaOS
10345  
10346  =back
10347  
10348  =item PERL 5.8.0 BROKEN IN AMIGAOS
10349  
10350  =item AUTHORS
10351  
10352  =item SEE ALSO
10353  
10354  =back
10355  
10356  =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
10357  
10358  =over 4
10359  
10360  =item DESCRIPTION
10361  
10362  =item AUTHOR
10363  
10364  =back
10365  
10366  =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
10367  
10368  =over 4
10369  
10370  =item DESCRIPTION
10371  
10372  =item BUILD AND INSTALL
10373  
10374  =over 4
10375  
10376  =item Requirements
10377  
10378  =item Configure
10379  
10380  =item Build
10381  
10382  =item Install
10383  
10384  =back
10385  
10386  =item KNOWN PROBLEMS
10387  
10388  =item CONTACT
10389  
10390  =back
10391  
10392  =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
10393  
10394  =over 4
10395  
10396  =item SYNOPSIS
10397  
10398  =item DESCRIPTION
10399  
10400  =over 4
10401  
10402  =item gzip on BS2000
10403  
10404  =item bison on BS2000
10405  
10406  =item Unpacking Perl Distribution on BS2000
10407  
10408  =item Compiling Perl on BS2000
10409  
10410  =item Testing Perl on BS2000
10411  
10412  =item Installing Perl on BS2000
10413  
10414  =item Using Perl in the Posix-Shell of BS2000
10415  
10416  =item Using Perl in "native" BS2000
10417  
10418  =item Floating point anomalies on BS2000
10419  
10420  =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
10421  
10422  =back
10423  
10424  =item AUTHORS
10425  
10426  =item SEE ALSO
10427  
10428  =over 4
10429  
10430  =item Mailing list
10431  
10432  =back
10433  
10434  =item HISTORY
10435  
10436  =back
10437  
10438  =head2 perlce - Perl for WinCE
10439  
10440  =over 4
10441  
10442  =item Building Perl for WinCE
10443  
10444  =over 4
10445  
10446  =item DESCRIPTION
10447  
10448  =item General explanations on cross-compiling WinCE
10449  
10450  =item BUILD
10451  
10452  Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
10453  celib-sources, Rainer Keuchel's console-sources, go to C<./win32>
10454  subdirectory, edit file C<./win32/ce-helpers/compile.bat>, run     
10455  compile.bat, run    compile.bat dist
10456  
10457  =back
10458  
10459  =item Using Perl on WinCE
10460  
10461  =over 4
10462  
10463  =item DESCRIPTION
10464  
10465  =item LIMITATIONS
10466  
10467  =item ENVIRONMENT
10468  
10469  PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE
10470  
10471  =item REGISTRY
10472  
10473  =item XS
10474  
10475  =item BUGS
10476  
10477  =item INSTALLATION
10478  
10479  =back
10480  
10481  =item ACKNOWLEDGEMENTS
10482  
10483  =item History of WinCE port
10484  
10485  =item AUTHORS
10486  
10487  Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov
10488  
10489  =back
10490  
10491  =head2 perlcygwin, README.cygwin - Perl for Cygwin
10492  
10493  =over 4
10494  
10495  =item SYNOPSIS
10496  
10497  =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
10498  
10499  =over 4
10500  
10501  =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
10502  
10503  =item Cygwin Configuration
10504  
10505  C<PATH>, I<nroff>, Permissions
10506  
10507  =back
10508  
10509  =item CONFIGURE PERL ON CYGWIN
10510  
10511  =over 4
10512  
10513  =item Stripping Perl Binaries on Cygwin
10514  
10515  =item Optional Libraries for Perl on Cygwin
10516  
10517  C<-lcrypt>, C<-lgdbm_compat> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
10518  C<cygserver> (C<use IPC::SysV>), C<-lutil>
10519  
10520  =item Configure-time Options for Perl on Cygwin
10521  
10522  C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
10523  C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
10524  C<-Dmksymlinks>
10525  
10526  =item Suspicious Warnings on Cygwin
10527  
10528  Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
10529  
10530  =back
10531  
10532  =item MAKE ON CYGWIN
10533  
10534  =item TEST ON CYGWIN
10535  
10536  =over 4
10537  
10538  =item File Permissions on Cygwin
10539  
10540  =item NDBM_File and ODBM_File do not work on FAT filesystems
10541  
10542  =item C<fork()> failures in io_* tests
10543  
10544  =back
10545  
10546  =item Specific features of the Cygwin port
10547  
10548  =over 4
10549  
10550  =item Script Portability on Cygwin
10551  
10552  Pathnames, Text/Binary, PerlIO, F<.exe>, Cygwin vs. Windows process ids,
10553  Cygwin vs. Windows errors, C<chown()>, Miscellaneous
10554  
10555  =item Prebuilt methods:
10556  
10557  C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>,
10558  C<Cygwin::win_to_posix_path>, C<Cygwin::posix_to_win_path>,
10559  C<Cygwin::mount_table()>, C<Cygwin::mount_flags>, C<Cygwin::is_binmount>
10560  
10561  =back
10562  
10563  =item INSTALL PERL ON CYGWIN
10564  
10565  =item MANIFEST ON CYGWIN
10566  
10567  Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
10568  Source, Compiled Module Source, Perl Modules/Scripts, Perl Module Tests
10569  
10570  =item BUGS ON CYGWIN
10571  
10572  =item AUTHORS
10573  
10574  =item HISTORY
10575  
10576  =back
10577  
10578  =head2 perldgux - Perl under DG/UX.
10579  
10580  =over 4
10581  
10582  =item SYNOPSIS
10583  
10584  =back
10585  
10586  =over 4
10587  
10588  =item DESCRIPTION
10589  
10590  =item BUILDING PERL ON DG/UX
10591  
10592  =over 4
10593  
10594  =item Non-threaded Perl on DG/UX
10595  
10596  =item Threaded Perl on DG/UX
10597  
10598  =item Testing Perl on DG/UX
10599  
10600  =item Installing the built perl on DG/UX
10601  
10602  =back
10603  
10604  =item AUTHOR
10605  
10606  =item SEE ALSO
10607  
10608  =back
10609  
10610  =head2 perldos - Perl under DOS, W31, W95.
10611  
10612  =over 4
10613  
10614  =item SYNOPSIS
10615  
10616  =item DESCRIPTION
10617  
10618  =over 4
10619  
10620  =item Prerequisites for Compiling Perl on DOS
10621  
10622  DJGPP, Pthreads
10623  
10624  =item Shortcomings of Perl under DOS
10625  
10626  =item Building Perl on DOS
10627  
10628  =item Testing Perl on DOS
10629  
10630  =item Installation of Perl on DOS
10631  
10632  =back
10633  
10634  =item BUILDING AND INSTALLING MODULES ON DOS
10635  
10636  =over 4
10637  
10638  =item Building Prerequisites for Perl on DOS
10639  
10640  =item Unpacking CPAN Modules on DOS
10641  
10642  =item Building Non-XS Modules on DOS
10643  
10644  =item Building XS Modules on DOS
10645  
10646  =back
10647  
10648  =item AUTHOR
10649  
10650  =item SEE ALSO
10651  
10652  =back
10653  
10654  =head2 perlepoc, README.epoc - Perl for EPOC
10655  
10656  =over 4
10657  
10658  =item SYNOPSIS
10659  
10660  =item INTRODUCTION
10661  
10662  =item INSTALLING PERL ON EPOC
10663  
10664  =item STARTING PERL ON EPOC
10665  
10666  =over 4
10667  
10668  =item Editors on Epoc
10669  
10670  =item Features of Perl on Epoc
10671  
10672  =item Restrictions of Perl on Epoc
10673  
10674  =item Compiling Perl 5 on the EPOC cross compiling environment
10675  
10676  =back
10677  
10678  =item SUPPORT STATUS OF PERL ON EPOC
10679  
10680  =item AUTHOR
10681  
10682  =item LAST UPDATE
10683  
10684  =back
10685  
10686  =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
10687  
10688  =over 4
10689  
10690  =item DESCRIPTION
10691  
10692  =over 4
10693  
10694  =item FreeBSD core dumps from readdir_r with ithreads
10695  
10696  =item $^X doesn't always contain a full path in FreeBSD
10697  
10698  =item Perl will no longer be part of "base FreeBSD"
10699  
10700  =back
10701  
10702  =item AUTHOR
10703  
10704  =back
10705  
10706  =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
10707  (HP-UX) systems
10708  
10709  =over 4
10710  
10711  =item DESCRIPTION
10712  
10713  =over 4
10714  
10715  =item Using perl as shipped with HP-UX
10716  
10717  =item Using perl from HP's porting centre
10718  
10719  =item Compiling Perl 5 on HP-UX
10720  
10721  =item PA-RISC
10722  
10723  =item Portability Between PA-RISC Versions
10724  
10725  =item PA-RISC 1.0
10726  
10727  =item PA-RISC 1.1
10728  
10729  =item PA-RISC 2.0
10730  
10731  =item Itanium Processor Family (IPF) and HP-UX
10732  
10733  =item Itanium, Itanium 2 & Madison 6
10734  
10735  =item Building Dynamic Extensions on HP-UX
10736  
10737  =item The HP ANSI C Compiler
10738  
10739  =item The GNU C Compiler
10740  
10741  =item Using Large Files with Perl on HP-UX
10742  
10743  =item Threaded Perl on HP-UX
10744  
10745  =item 64-bit Perl on HP-UX
10746  
10747  =item Oracle on HP-UX
10748  
10749  =item GDBM and Threads on HP-UX
10750  
10751  =item NFS filesystems and utime(2) on HP-UX
10752  
10753  =item perl -P and // and HP-UX
10754  
10755  =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
10756  
10757  =back
10758  
10759  =item nss_delete core dump from op/pwent or op/grent
10760  
10761  =item Miscellaneous
10762  
10763  =item AUTHOR
10764  
10765  =item DATE
10766  
10767  =back
10768  
10769  =head2 perlhurd, README.hurd - Perl version 5 on Hurd
10770  
10771  =over 4
10772  
10773  =item DESCRIPTION
10774  
10775  =over 4
10776  
10777  =item Known Problems with Perl on Hurd 
10778  
10779  =back
10780  
10781  =item AUTHOR
10782  
10783  =back
10784  
10785  =head2 perlirix, README.irix - Perl version 5 on Irix systems
10786  
10787  =over 4
10788  
10789  =item DESCRIPTION
10790  
10791  =over 4
10792  
10793  =item Building 32-bit Perl in Irix
10794  
10795  =item Building 64-bit Perl in Irix
10796  
10797  =item About Compiler Versions of Irix
10798  
10799  =item Linker Problems in Irix
10800  
10801  =item Malloc in Irix
10802  
10803  =item Building with threads in Irix
10804  
10805  =item Irix 5.3
10806  
10807  =back
10808  
10809  =item AUTHOR
10810  
10811  =back
10812  
10813  =head2 perllinux, README.linux - Perl version 5 on Linux systems
10814  
10815  =over 4
10816  
10817  =item DESCRIPTION
10818  
10819  =over 4
10820  
10821  =item Experimental Support for Sun Studio Compilers for Linux OS
10822  
10823  =back
10824  
10825  =item AUTHOR
10826  
10827  =back
10828  
10829  =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
10830  systems
10831  
10832  =over 4
10833  
10834  =item DESCRIPTION
10835  
10836  =over 4
10837  
10838  =item Perl version 5.8.x and greater not supported
10839  
10840  =item Compiling Perl 5.6.x on MachTen
10841  
10842  =item Failures during C<make test> on MachTen
10843  
10844  op/lexassign.t, pragma/warnings.t
10845  
10846  =item Building external modules on MachTen
10847  
10848  =back
10849  
10850  =item AUTHOR
10851  
10852  =item DATE
10853  
10854  =back
10855  
10856  =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
10857  
10858  =over 4
10859  
10860  =item SYNOPSIS
10861  
10862  =item DESCRIPTION
10863  
10864  =item AUTHOR
10865  
10866  =item DATE
10867  
10868  =back
10869  
10870  =head2 perlmacosx, README.macosx - Perl under Mac OS X
10871  
10872  =over 4
10873  
10874  =item SYNOPSIS
10875  
10876  =item DESCRIPTION
10877  
10878  =over 4
10879  
10880  =item Installation Prefix
10881  
10882  =item SDK support
10883  
10884  =item Universal Binary support
10885  
10886  =item 64-bit PPC support
10887  
10888  =item libperl and Prebinding
10889  
10890  =item Updating Apple's Perl
10891  
10892  =item Known problems
10893  
10894  =item MacPerl
10895  
10896  =item Carbon
10897  
10898  =item Cocoa
10899  
10900  =back
10901  
10902  =item Starting From Scratch
10903  
10904  =item AUTHOR
10905  
10906  =item DATE
10907  
10908  =back
10909  
10910  =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
10911  
10912  =over 4
10913  
10914  =item DESCRIPTION
10915  
10916  =item Known problems with Perl on MiNT
10917  
10918  =item AUTHOR
10919  
10920  =back
10921  
10922  =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
10923  
10924  =over 4
10925  
10926  =item SYNOPSIS
10927  
10928  =item NOTE
10929  
10930  =item Binary distribution from HP
10931  
10932  =item What's New in Perl for MPE/iX
10933  
10934  =item Welcome to Perl/iX
10935  
10936  =item System Requirements for Perl/iX
10937  
10938  =item How to Obtain Perl/iX
10939  
10940  =item Perl/iX Distribution Contents Highlights
10941  
10942  README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
10943  public_html/feedback.cgi, src/perl-5.6.0-mpe
10944  
10945  =item How to Compile Perl/iX
10946  
10947   4,  6
10948  
10949  =item Getting Started with Perl/iX
10950  
10951  =item MPE/iX Implementation Considerations
10952  
10953  =item Known Perl/iX Bugs Under Investigation
10954  
10955  =item Perl/iX To-Do List
10956  
10957  =item Perl/iX Change History
10958  
10959  =item AUTHOR
10960  
10961  =back
10962  
10963  =head2 perlnetware - Perl for NetWare
10964  
10965  =over 4
10966  
10967  =item DESCRIPTION
10968  
10969  =item BUILD
10970  
10971  =over 4
10972  
10973  =item Tools & SDK
10974  
10975  =item Setup
10976  
10977  SetNWBld.bat, Buildtype.bat
10978  
10979  =item Make
10980  
10981  =item Interpreter
10982  
10983  =item Extensions
10984  
10985  =back
10986  
10987  =item INSTALL
10988  
10989  =item BUILD NEW EXTENSIONS
10990  
10991  =item ACKNOWLEDGEMENTS
10992  
10993  =item AUTHORS
10994  
10995  =item DATE
10996  
10997  =back
10998  
10999  =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
11000  
11001  =over 4
11002  
11003  =item DESCRIPTION
11004  
11005  =over 4
11006  
11007  =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
11008  ithreads
11009  
11010  =back
11011  
11012  =item AUTHOR
11013  
11014  =back
11015  
11016  =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
11017  
11018  =over 4
11019  
11020  =item SYNOPSIS
11021  
11022  =back
11023  
11024  =over 4
11025  
11026  =item DESCRIPTION
11027  
11028  =over 4
11029  
11030  =item Target
11031  
11032  =item Other OSes
11033  
11034  =item Prerequisites
11035  
11036  EMX, RSX, HPFS, pdksh
11037  
11038  =item Starting Perl programs under OS/2 (and DOS and...)
11039  
11040  =item Starting OS/2 (and DOS) programs under Perl
11041  
11042  =back
11043  
11044  =item Frequently asked questions
11045  
11046  =over 4
11047  
11048  =item "It does not work"
11049  
11050  =item I cannot run external programs
11051  
11052  =item I cannot embed perl into my program, or use F<perl.dll> from my
11053  program. 
11054  
11055  Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
11056  L<ExtUtils::Embed>?
11057  
11058  =item C<``> and pipe-C<open> do not work under DOS.
11059  
11060  =item Cannot start C<find.exe "pattern" file>
11061  
11062  =back
11063  
11064  =item INSTALLATION
11065  
11066  =over 4
11067  
11068  =item Automatic binary installation
11069  
11070  C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
11071  
11072  =item Manual binary installation
11073  
11074  Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
11075  (statically linked), Executables for Perl utilities, Main Perl library,
11076  Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
11077  and utilities, Manpages for Perl modules, Source for Perl documentation,
11078  Perl manual in F<.INF> format, Pdksh
11079  
11080  =item B<Warning>
11081  
11082  =back
11083  
11084  =item Accessing documentation
11085  
11086  =over 4
11087  
11088  =item OS/2 F<.INF> file
11089  
11090  =item Plain text
11091  
11092  =item Manpages
11093  
11094  =item HTML
11095  
11096  =item GNU C<info> files
11097  
11098  =item F<PDF> files
11099  
11100  =item C<LaTeX> docs
11101  
11102  =back
11103  
11104  =item BUILD
11105  
11106  =over 4
11107  
11108  =item The short story
11109  
11110  =item Prerequisites
11111  
11112  =item Getting perl source
11113  
11114  =item Application of the patches
11115  
11116  =item Hand-editing
11117  
11118  =item Making
11119  
11120  =item Testing
11121  
11122  A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
11123  F<op/stat.t>
11124  
11125  =item Installing the built perl
11126  
11127  =item C<a.out>-style build
11128  
11129  =back
11130  
11131  =item Building a binary distribution
11132  
11133  =item Building custom F<.EXE> files
11134  
11135  =over 4
11136  
11137  =item Making executables with a custom collection of statically loaded
11138  extensions
11139  
11140  =item Making executables with a custom search-paths
11141  
11142  =back
11143  
11144  =item Build FAQ
11145  
11146  =over 4
11147  
11148  =item Some C</> became C<\> in pdksh.
11149  
11150  =item C<'errno'> - unresolved external
11151  
11152  =item Problems with tr or sed
11153  
11154  =item Some problem (forget which ;-)
11155  
11156  =item Library ... not found
11157  
11158  =item Segfault in make
11159  
11160  =item op/sprintf test failure
11161  
11162  =back
11163  
11164  =item Specific (mis)features of OS/2 port
11165  
11166  =over 4
11167  
11168  =item C<setpriority>, C<getpriority>
11169  
11170  =item C<system()>
11171  
11172  =item C<extproc> on the first line
11173  
11174  =item Additional modules:
11175  
11176  =item Prebuilt methods:
11177  
11178  C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
11179   C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
11180  C<Cwd::sys_is_absolute(name)>,    C<Cwd::sys_is_rooted(name)>, 
11181  C<Cwd::sys_is_relative(name)>,    C<Cwd::sys_cwd(name)>, 
11182  C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
11183  C<Cwd::extLibpath_set( path [, type ] )>,
11184  C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
11185  OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
11186  C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
11187  C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
11188  OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
11189  C<OS2::DLLname([how [, \&xsub]])>
11190  
11191  =item Prebuilt variables:
11192  
11193  $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
11194  $OS2::nsyserror
11195  
11196  =item Misfeatures
11197  
11198  =item Modifications
11199  
11200  C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
11201  C<flock>
11202  
11203  =item Identifying DLLs
11204  
11205  =item Centralized management of resources
11206  
11207  C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
11208  C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
11209  C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
11210  C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
11211  
11212  =back
11213  
11214  =item Perl flavors
11215  
11216  =over 4
11217  
11218  =item F<perl.exe>
11219  
11220  =item F<perl_.exe>
11221  
11222  =item F<perl__.exe>
11223  
11224  =item F<perl___.exe>
11225  
11226  =item Why strange names?
11227  
11228  =item Why dynamic linking?
11229  
11230  =item Why chimera build?
11231  
11232  =back
11233  
11234  =item ENVIRONMENT
11235  
11236  =over 4
11237  
11238  =item C<PERLLIB_PREFIX>
11239  
11240  =item C<PERL_BADLANG>
11241  
11242  =item C<PERL_BADFREE>
11243  
11244  =item C<PERL_SH_DIR>
11245  
11246  =item C<USE_PERL_FLOCK>
11247  
11248  =item C<TMP> or C<TEMP>
11249  
11250  =back
11251  
11252  =item Evolution
11253  
11254  =over 4
11255  
11256  =item Text-mode filehandles
11257  
11258  =item Priorities
11259  
11260  =item DLL name mangling: pre 5.6.2
11261  
11262  =item DLL name mangling: 5.6.2 and beyond
11263  
11264  Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
11265  C<LIBPATH>
11266  
11267  =item DLL forwarder generation
11268  
11269  =item Threading
11270  
11271  =item Calls to external programs
11272  
11273  =item Memory allocation
11274  
11275  =item Threads
11276  
11277  C<COND_WAIT>, F<os2.c>
11278  
11279  =back
11280  
11281  =item BUGS
11282  
11283  =back
11284  
11285  =over 4
11286  
11287  =item AUTHOR
11288  
11289  =item SEE ALSO
11290  
11291  =back
11292  
11293  =head2 perlos390, README.os390 - building and installing Perl for OS/390
11294  and z/OS
11295  
11296  =over 4
11297  
11298  =item SYNOPSIS
11299  
11300  =item DESCRIPTION
11301  
11302  =over 4
11303  
11304  =item Tools
11305  
11306  =item Unpacking Perl distribution on OS/390
11307  
11308  =item Setup and utilities for Perl on OS/390
11309  
11310  =item Configure Perl on OS/390
11311  
11312  =item Build, Test, Install Perl on OS/390
11313  
11314  =item Build Anomalies with Perl on OS/390
11315  
11316  =item Testing Anomalies with Perl on OS/390
11317  
11318  =item Installation Anomalies with Perl on OS/390
11319  
11320  =item Usage Hints for Perl on OS/390
11321  
11322  =item Floating Point Anomalies with Perl on OS/390
11323  
11324  =item Modules and Extensions for Perl on OS/390
11325  
11326  =back
11327  
11328  =item AUTHORS
11329  
11330  =item SEE ALSO
11331  
11332  =over 4
11333  
11334  =item Mailing list for Perl on OS/390
11335  
11336  =back
11337  
11338  =item HISTORY
11339  
11340  =back
11341  
11342  =head2 perlos400, README.os400 - Perl version 5 on OS/400
11343  
11344  =over 4
11345  
11346  =item DESCRIPTION
11347  
11348  =over 4
11349  
11350  =item Compiling Perl for OS/400 PASE
11351  
11352  =item Installing Perl in OS/400 PASE
11353  
11354  =item Using Perl in OS/400 PASE
11355  
11356  =item Known Problems
11357  
11358  =item Perl on ILE
11359  
11360  =back
11361  
11362  =item AUTHORS
11363  
11364  =back
11365  
11366  =head2 perlplan9 - Plan 9-specific documentation for Perl
11367  
11368  =over 4
11369  
11370  =item DESCRIPTION
11371  
11372  =over 4
11373  
11374  =item Invoking Perl
11375  
11376  =item What's in Plan 9 Perl
11377  
11378  =item What's not in Plan 9 Perl
11379  
11380  =item Perl5 Functions not currently supported in Plan 9 Perl
11381  
11382  =item Signals in Plan 9 Perl
11383  
11384  =back
11385  
11386  =item COMPILING AND INSTALLING PERL ON PLAN 9
11387  
11388  =over 4
11389  
11390  =item Installing Perl Documentation on Plan 9
11391  
11392  =back
11393  
11394  =item BUGS
11395  
11396  =item Revision date
11397  
11398  =item AUTHOR
11399  
11400  =back
11401  
11402  =head2 perlqnx, README.qnx - Perl version 5 on QNX
11403  
11404  =over 4
11405  
11406  =item DESCRIPTION
11407  
11408  =over 4
11409  
11410  =item Required Software for Compiling Perl on QNX4
11411  
11412  /bin/sh, ar, nm, cpp, make
11413  
11414  =item Outstanding Issues with Perl on QNX4
11415  
11416  =item QNX auxiliary files
11417  
11418  qnx/ar, qnx/cpp
11419  
11420  =item Outstanding issues with perl under QNX6
11421  
11422  =back
11423  
11424  =item AUTHOR
11425  
11426  =back
11427  
11428  =head2 perlriscos, README.riscos - Perl version 5 for RISC OS
11429  
11430  =over 4
11431  
11432  =item DESCRIPTION
11433  
11434  =item BUILD
11435  
11436  =item AUTHOR
11437  
11438  =back
11439  
11440  =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
11441  
11442  =over 4
11443  
11444  =item DESCRIPTION
11445  
11446  =over 4
11447  
11448  =item Solaris Version Numbers.
11449  
11450  =back
11451  
11452  =item RESOURCES
11453  
11454  Solaris FAQ, Precompiled Binaries, Solaris Documentation
11455  
11456  =item SETTING UP
11457  
11458  =over 4
11459  
11460  =item File Extraction Problems on Solaris.
11461  
11462  =item Compiler and Related Tools on Solaris.
11463  
11464  =item Environment for Compiling perl on Solaris
11465  
11466  =back
11467  
11468  =item RUN CONFIGURE.
11469  
11470  =over 4
11471  
11472  =item 64-bit perl on Solaris.
11473  
11474  =item Threads in perl on Solaris.
11475  
11476  =item Malloc Issues with perl on Solaris.
11477  
11478  =back
11479  
11480  =item MAKE PROBLEMS.
11481  
11482  Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
11483  relocation error:, dlopen: stub interception failed, #error "No
11484  DATAMODEL_NATIVE specified", sh: ar: not found
11485  
11486  =item MAKE TEST
11487  
11488  =over 4
11489  
11490  =item op/stat.t test 4 in Solaris
11491  
11492  =item nss_delete core dump from op/pwent or op/grent
11493  
11494  =back
11495  
11496  =item PREBUILT BINARIES OF PERL FOR SOLARIS.
11497  
11498  =item RUNTIME ISSUES FOR PERL ON SOLARIS.
11499  
11500  =over 4
11501  
11502  =item Limits on Numbers of Open Files on Solaris.
11503  
11504  =back
11505  
11506  =item SOLARIS-SPECIFIC MODULES.
11507  
11508  =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
11509  
11510  =over 4
11511  
11512  =item Proc::ProcessTable on Solaris
11513  
11514  =item BSD::Resource on Solaris
11515  
11516  =item Net::SSLeay on Solaris
11517  
11518  =back
11519  
11520  =item SunOS 4.x
11521  
11522  =item AUTHOR
11523  
11524  =back
11525  
11526  =head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
11527  
11528  =over 4
11529  
11530  =item DESCRIPTION
11531  
11532  =over 4
11533  
11534  =item Compiling Perl on Symbian
11535  
11536  =item Compilation problems
11537  
11538  =item PerlApp
11539  
11540  =item sisify.pl
11541  
11542  =item Using Perl in Symbian
11543  
11544  =back
11545  
11546  =item TO DO
11547  
11548  =item WARNING
11549  
11550  =item NOTE
11551  
11552  =item AUTHOR
11553  
11554  =item COPYRIGHT
11555  
11556  =item LICENSE
11557  
11558  =item HISTORY
11559  
11560  =back
11561  
11562  =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
11563  Digital UNIX formerly known as DEC OSF/1) systems
11564  
11565  =over 4
11566  
11567  =item DESCRIPTION
11568  
11569  =over 4
11570  
11571  =item Compiling Perl 5 on Tru64
11572  
11573  =item Using Large Files with Perl on Tru64
11574  
11575  =item Threaded Perl on Tru64
11576  
11577  =item Long Doubles on Tru64
11578  
11579  =item DB_File tests failing on Tru64
11580  
11581  =item 64-bit Perl on Tru64
11582  
11583  =item Warnings about floating-point overflow when compiling Perl on Tru64
11584  
11585  =back
11586  
11587  =item Testing Perl on Tru64
11588  
11589  =item ext/ODBM_File/odbm Test Failing With Static Builds
11590  
11591  =item Perl Fails Because Of Unresolved Symbol sockatmark
11592  
11593  =item AUTHOR
11594  
11595  =back
11596  
11597  =head2 perluts - Perl under UTS
11598  
11599  =over 4
11600  
11601  =item SYNOPSIS
11602  
11603  =item DESCRIPTION
11604  
11605  =item BUILDING PERL ON UTS
11606  
11607  =item Installing the built perl on UTS
11608  
11609  =item AUTHOR
11610  
11611  =back
11612  
11613  =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
11614  
11615  =over 4
11616  
11617  =item SYNOPSIS
11618  
11619  =item DESCRIPTION
11620  
11621  =over 4
11622  
11623  =item Unpacking Perl Distribution on VM/ESA
11624  
11625  =item Setup Perl and utilities on VM/ESA
11626  
11627  =item Configure Perl on VM/ESA
11628  
11629  =item Testing Anomalies of Perl on VM/ESA
11630  
11631  =item Usage Hints for Perl on VM/ESA
11632  
11633  =back
11634  
11635  =item AUTHORS
11636  
11637  =item SEE ALSO
11638  
11639  =over 4
11640  
11641  =item Mailing list for Perl on VM/ESA
11642  
11643  =back
11644  
11645  =back
11646  
11647  =head2 perlvms - VMS-specific documentation for Perl
11648  
11649  =over 4
11650  
11651  =item DESCRIPTION
11652  
11653  =item Installation
11654  
11655  =item Organization of Perl Images
11656  
11657  =over 4
11658  
11659  =item Core Images
11660  
11661  =item Perl Extensions
11662  
11663  =item Installing static extensions
11664  
11665  =item Installing dynamic extensions
11666  
11667  =back
11668  
11669  =item File specifications
11670  
11671  =over 4
11672  
11673  =item Syntax
11674  
11675  =item Filename Case
11676  
11677  =item Symbolic Links
11678  
11679  =item Wildcard expansion
11680  
11681  =item Pipes
11682  
11683  =back
11684  
11685  =item PERL5LIB and PERLLIB
11686  
11687  =item The Perl Forked Debugger
11688  
11689  =item PERL_VMS_EXCEPTION_DEBUG
11690  
11691  =item Command line
11692  
11693  =over 4
11694  
11695  =item I/O redirection and backgrounding
11696  
11697  =item Command line switches
11698  
11699  -i, -S, -u
11700  
11701  =back
11702  
11703  =item Perl functions
11704  
11705  File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, die,
11706  dump, exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//,
11707  select (system call), stat EXPR, system LIST, time, times, unlink LIST,
11708  utime LIST, waitpid PID,FLAGS
11709  
11710  =item Perl variables
11711  
11712  %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
11713  
11714  =item Standard modules with VMS-specific differences
11715  
11716  =over 4
11717  
11718  =item SDBM_File
11719  
11720  =back
11721  
11722  =item Revision date
11723  
11724  =item AUTHOR
11725  
11726  =back
11727  
11728  =head2 perlvos, README.vos - Perl for Stratus VOS
11729  
11730  =over 4
11731  
11732  =item SYNOPSIS
11733  
11734  =item BUILDING PERL FOR VOS
11735  
11736  =item INSTALLING PERL IN VOS
11737  
11738  =item USING PERL IN VOS
11739  
11740  =over 4
11741  
11742  =item Restrictions of Perl on VOS
11743  
11744  =item Handling of underflow and overflow
11745  
11746  =back
11747  
11748  =item TEST STATUS
11749  
11750  =item SUPPORT STATUS
11751  
11752  =item AUTHOR
11753  
11754  =item LAST UPDATE
11755  
11756  =back
11757  
11758  =head2 perlwin32 - Perl under Windows
11759  
11760  =over 4
11761  
11762  =item SYNOPSIS
11763  
11764  =item DESCRIPTION
11765  
11766  =over 4
11767  
11768  =item Setting Up Perl on Win32
11769  
11770  Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
11771  C++ 2008 Express Edition Beta 2, Microsoft Visual C++ 2005 Express Edition,
11772  Microsoft Visual C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler,
11773  MinGW release 3 with gcc, MinGW release 1 with gcc
11774  
11775  =item Building
11776  
11777  =item Testing Perl on Win32
11778  
11779  =item Installation of Perl on Win32
11780  
11781  =item Usage Hints for Perl on Win32
11782  
11783  Environment Variables, File Globbing, Using perl from the command line,
11784  Building Extensions, Command-line Wildcard Expansion, Win32 Specific
11785  Extensions, Notes on 64-bit Windows
11786  
11787  =item Running Perl Scripts
11788  
11789  =item Miscellaneous Things
11790  
11791  =back
11792  
11793  =item BUGS AND CAVEATS
11794  
11795  =item ACKNOWLEDGEMENTS
11796  
11797  =item AUTHORS
11798  
11799  Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
11800  E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
11801  E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
11802  Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
11803  
11804  =item SEE ALSO
11805  
11806  =item HISTORY
11807  
11808  =back
11809  
11810  =head1 PRAGMA DOCUMENTATION
11811  
11812  =head2 attrs - set/get attributes of a subroutine (deprecated)
11813  
11814  =over 4
11815  
11816  =item SYNOPSIS
11817  
11818  =item DESCRIPTION
11819  
11820  method, locked
11821  
11822  =back
11823  
11824  =head2 re - Perl pragma to alter regular expression behaviour
11825  
11826  =over 4
11827  
11828  =item SYNOPSIS
11829  
11830  =item DESCRIPTION
11831  
11832  =over 4
11833  
11834  =item 'taint' mode
11835  
11836  =item 'eval' mode
11837  
11838  =item 'debug' mode
11839  
11840  =item 'Debug' mode
11841  
11842  Compile related options, COMPILE, PARSE, OPTIMISE, TRIEC, DUMP, Execute
11843  related options, EXECUTE, MATCH, TRIEE, INTUIT, Extra debugging options,
11844  EXTRA, BUFFERS, TRIEM, STATE, STACK, OPTIMISEM, OFFSETS, OFFSETSDBG, Other
11845  useful flags, ALL, All, MORE, More
11846  
11847  =item Exportable Functions
11848  
11849  is_regexp($ref), regexp_pattern($ref), regmust($ref), regname($name,$all),
11850  regnames($all), regnames_count()
11851  
11852  =back
11853  
11854  =item SEE ALSO
11855  
11856  =back
11857  
11858  =head2 threadshared::shared, threads::shared - Perl extension for sharing
11859  data structures between threads
11860  
11861  =over 4
11862  
11863  =item VERSION
11864  
11865  =item SYNOPSIS
11866  
11867  =item DESCRIPTION
11868  
11869  =item EXPORT
11870  
11871  =item FUNCTIONS
11872  
11873  share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE,
11874  cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT,
11875  cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE,
11876  cond_broadcast VARIABLE
11877  
11878  =item OBJECTS
11879  
11880  =item NOTES
11881  
11882  =item BUGS AND LIMITATIONS
11883  
11884  =item SEE ALSO
11885  
11886  =item AUTHOR
11887  
11888  =back
11889  
11890  =head2 threads - Perl interpreter-based threads
11891  
11892  =over 4
11893  
11894  =item VERSION
11895  
11896  =item SYNOPSIS
11897  
11898  =item DESCRIPTION
11899  
11900  $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(),
11901  threads->detach(), threads->self(), $thr->tid(), threads->tid(), "$thr",
11902  threads->object($tid), threads->yield(), threads->list(),
11903  threads->list(threads::all), threads->list(threads::running),
11904  threads->list(threads::joinable), $thr1->equal($thr2), async BLOCK;,
11905  $thr->error(), $thr->_handle(), threads->_handle()
11906  
11907  =item EXITING A THREAD
11908  
11909  threads->exit(), threads->exit(status), die(), exit(status), use threads
11910  'exit' => 'threads_only', threads->create({'exit' => 'thread_only'}, ...),
11911  $thr->set_thread_exit_only(boolean), threads->set_thread_exit_only(boolean)
11912  
11913  =item THREAD STATE
11914  
11915  $thr->is_running(), $thr->is_joinable(), $thr->is_detached(),
11916  threads->is_detached()
11917  
11918  =item THREAD CONTEXT
11919  
11920  =over 4
11921  
11922  =item Explicit context
11923  
11924  =item Implicit context
11925  
11926  =item $thr->wantarray()
11927  
11928  =item threads->wantarray()
11929  
11930  =back
11931  
11932  =item THREAD STACK SIZE
11933  
11934  threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size =
11935  threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);,
11936  $ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE},
11937  FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS)
11938  
11939  =item THREAD SIGNALLING
11940  
11941  $thr->kill('SIG...');
11942  
11943  =item WARNINGS
11944  
11945  Perl exited with active threads:, Thread creation failed: pthread_create
11946  returned #, Thread # terminated abnormally: .., Using minimum thread stack
11947  size of #, Thread creation failed: pthread_attr_setstacksize(I<SIZE>)
11948  returned 22
11949  
11950  =item ERRORS
11951  
11952  This Perl not built to support threads, Cannot change stack size of an
11953  existing thread, Cannot signal threads without safe signals, Unrecognized
11954  signal name: ..
11955  
11956  =item BUGS AND LIMITATIONS
11957  
11958  Thread-safe modules, Using non-thread-safe modules, Current working
11959  directory, Environment variables, Parent-child threads, Creating threads
11960  inside special blocks, Unsafe signals, Perl has been built with
11961  C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
11962  C<PERL_SIGNALS> is set to C<unsafe> (see L<perlrun/"PERL_SIGNALS">), The
11963  module L<Perl::Unsafe::Signals> is used, Returning closures from threads,
11964  Returning objects from threads, Perl Bugs and the CPAN Version of
11965  L<threads>
11966  
11967  =item REQUIREMENTS
11968  
11969  =item SEE ALSO
11970  
11971  =item AUTHOR
11972  
11973  =item ACKNOWLEDGEMENTS
11974  
11975  =back
11976  
11977  =head2 attributes - get/set subroutine or variable attributes
11978  
11979  =over 4
11980  
11981  =item SYNOPSIS
11982  
11983  =item DESCRIPTION
11984  
11985  =over 4
11986  
11987  =item Built-in Attributes
11988  
11989  locked, method, lvalue
11990  
11991  =item Available Subroutines
11992  
11993  get, reftype
11994  
11995  =item Package-specific Attribute Handling
11996  
11997  FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
11998  
11999  =item Syntax of Attribute Lists
12000  
12001  =back
12002  
12003  =item EXPORTS
12004  
12005  =over 4
12006  
12007  =item Default exports
12008  
12009  =item Available exports
12010  
12011  =item Export tags defined
12012  
12013  =back
12014  
12015  =item EXAMPLES
12016  
12017  =item SEE ALSO
12018  
12019  =back
12020  
12021  =head2 autouse - postpone load of modules until a function is used
12022  
12023  =over 4
12024  
12025  =item SYNOPSIS
12026  
12027  =item DESCRIPTION
12028  
12029  =item WARNING
12030  
12031  =item AUTHOR
12032  
12033  =item SEE ALSO
12034  
12035  =back
12036  
12037  =head2 base - Establish an ISA relationship with base classes at compile
12038  time
12039  
12040  =over 4
12041  
12042  =item SYNOPSIS
12043  
12044  =item DESCRIPTION
12045  
12046  =item DIAGNOSTICS
12047  
12048  Base class package "%s" is empty, Class 'Foo' tried to inherit from itself
12049  
12050  =item HISTORY
12051  
12052  =item CAVEATS
12053  
12054  =item SEE ALSO
12055  
12056  =back
12057  
12058  =head2 bigint - Transparent BigInteger support for Perl
12059  
12060  =over 4
12061  
12062  =item SYNOPSIS
12063  
12064  =item DESCRIPTION
12065  
12066  =over 4
12067  
12068  =item use integer vs. use bigint
12069  
12070  =item Options
12071  
12072  a or accuracy, p or precision, t or trace, hex, oct, l, lib, try or only, v
12073  or version
12074  
12075  =item Math Library
12076  
12077  =item Internal Format
12078  
12079  =item Sign
12080  
12081  =item Methods
12082  
12083  inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
12084  
12085  =item MATH LIBRARY
12086  
12087  =item Caveat
12088  
12089  =back
12090  
12091  =item CAVAETS
12092  
12093  in_effect(), hex()/oct()
12094  
12095  =item MODULES USED
12096  
12097  =item EXAMPLES
12098  
12099  =item LICENSE
12100  
12101  =item SEE ALSO
12102  
12103  =item AUTHORS
12104  
12105  =back
12106  
12107  =head2 bignum - Transparent BigNumber support for Perl
12108  
12109  =over 4
12110  
12111  =item SYNOPSIS
12112  
12113  =item DESCRIPTION
12114  
12115  =over 4
12116  
12117  =item Options
12118  
12119  a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
12120  
12121  =item Methods
12122  
12123  =item Caveats
12124  
12125  inf(), NaN(), e, PI(), bexp(), bpi(), upgrade(), in_effect()
12126  
12127  =item Math Library
12128  
12129  =item INTERNAL FORMAT
12130  
12131  =item SIGN
12132  
12133  =back
12134  
12135  =item CAVAETS
12136  
12137  in_effect(), hex()/oct()
12138  
12139  =item MODULES USED
12140  
12141  =item EXAMPLES
12142  
12143  =item LICENSE
12144  
12145  =item SEE ALSO
12146  
12147  =item AUTHORS
12148  
12149  =back
12150  
12151  =head2 bigrat - Transparent BigNumber/BigRational support for Perl
12152  
12153  =over 4
12154  
12155  =item SYNOPSIS
12156  
12157  =item DESCRIPTION
12158  
12159  =over 4
12160  
12161  =item Modules Used
12162  
12163  =item Math Library
12164  
12165  =item Sign
12166  
12167  =item Methods
12168  
12169  inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
12170  
12171  =item MATH LIBRARY
12172  
12173  =item Cavaet
12174  
12175  =item Options
12176  
12177  a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
12178  
12179  =back
12180  
12181  =item CAVAETS
12182  
12183  in_effect(), hex()/oct()
12184  
12185  =item EXAMPLES
12186  
12187      perl -Mbigrat -le 'print sqrt(33)'
12188      perl -Mbigrat -le 'print 2*255'
12189      perl -Mbigrat -le 'print 4.5+2*255'
12190      perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'    
12191      perl -Mbigrat -le 'print 12->is_odd()';
12192      perl -Mbignum=l,GMP -le 'print 7 ** 7777'
12193  
12194  =item LICENSE
12195  
12196  =item SEE ALSO
12197  
12198  =item AUTHORS
12199  
12200  =back
12201  
12202  =head2 blib - Use MakeMaker's uninstalled version of a package
12203  
12204  =over 4
12205  
12206  =item SYNOPSIS
12207  
12208  =item DESCRIPTION
12209  
12210  =item BUGS
12211  
12212  =item AUTHOR
12213  
12214  =back
12215  
12216  =head2 bytes - Perl pragma to force byte semantics rather than character
12217  semantics
12218  
12219  =over 4
12220  
12221  =item SYNOPSIS
12222  
12223  =item DESCRIPTION
12224  
12225  =item LIMITATIONS
12226  
12227  =item SEE ALSO
12228  
12229  =back
12230  
12231  =head2 charnames - define character names for C<\N{named}> string literal
12232  escapes
12233  
12234  =over 4
12235  
12236  =item SYNOPSIS
12237  
12238  =item DESCRIPTION
12239  
12240  =item ALIASES
12241  
12242  =item CUSTOM ALIASES
12243  
12244  =over 4
12245  
12246  =item Anonymous hashes
12247  
12248  =item Alias file
12249  
12250  =item Alias shortcut
12251  
12252  =back
12253  
12254  =item charnames::viacode(code)
12255  
12256  =item charnames::vianame(name)
12257  
12258  =item CUSTOM TRANSLATORS
12259  
12260  =item ILLEGAL CHARACTERS
12261  
12262  =item BUGS
12263  
12264  =back
12265  
12266  =head2 constant - Perl pragma to declare constants
12267  
12268  =over 4
12269  
12270  =item SYNOPSIS
12271  
12272  =item DESCRIPTION
12273  
12274  =item NOTES
12275  
12276  =over 4
12277  
12278  =item List constants
12279  
12280  =item Defining multiple constants at once
12281  
12282  =item Magic constants
12283  
12284  =back
12285  
12286  =item TECHNICAL NOTES
12287  
12288  =item CAVEATS
12289  
12290  =item BUGS
12291  
12292  =item AUTHORS
12293  
12294  =item COPYRIGHT
12295  
12296  =back
12297  
12298  =head2 diagnostics, splain - produce verbose warning diagnostics
12299  
12300  =over 4
12301  
12302  =item SYNOPSIS
12303  
12304  =item DESCRIPTION
12305  
12306  =over 4
12307  
12308  =item The C<diagnostics> Pragma
12309  
12310  =item The I<splain> Program
12311  
12312  =back
12313  
12314  =item EXAMPLES
12315  
12316  =item INTERNALS
12317  
12318  =item BUGS
12319  
12320  =item AUTHOR
12321  
12322  =back
12323  
12324  =head2 encoding - allows you to write your script in non-ascii or non-utf8
12325  
12326  =over 4
12327  
12328  =item SYNOPSIS
12329  
12330  =item ABSTRACT
12331  
12332  =over 4
12333  
12334  =item Literal Conversions
12335  
12336  =item PerlIO layers for C<STD(IN|OUT)>
12337  
12338  =item Implicit upgrading for byte strings
12339  
12340  =item Side effects
12341  
12342  =item Side effects
12343  
12344  =item Side effects
12345  
12346  =back
12347  
12348  =item FEATURES THAT REQUIRE 5.8.1
12349  
12350  "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12351  
12352  =item USAGE
12353  
12354  use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12355  I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12356  
12357  =item The Filter Option
12358  
12359  =over 4
12360  
12361  =item Filter-related changes at Encode version 1.87
12362  
12363  =back
12364  
12365  =item CAVEATS
12366  
12367  =over 4
12368  
12369  =item NOT SCOPED
12370  
12371  =item DO NOT MIX MULTIPLE ENCODINGS
12372  
12373  =item tr/// with ranges
12374  
12375  Legend of characters above
12376  
12377  =back
12378  
12379  =item EXAMPLE - Greekperl
12380  
12381  =item KNOWN PROBLEMS
12382  
12383  literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
12384  safety
12385  
12386  =over 4
12387  
12388  =item The Logic of :locale
12389  
12390  =back
12391  
12392  =item HISTORY
12393  
12394  =item SEE ALSO
12395  
12396  =back
12397  
12398  =head2 encoding::warnings - Warn on implicit encoding conversions
12399  
12400  =over 4
12401  
12402  =item VERSION
12403  
12404  =item SYNOPSIS
12405  
12406  =item DESCRIPTION
12407  
12408  =over 4
12409  
12410  =item Overview of the problem
12411  
12412  =item Detecting the problem
12413  
12414  =item Solving the problem
12415  
12416  Upgrade both sides to unicode-strings, Downgrade both sides to
12417  byte-strings, Specify the encoding for implicit byte-string upgrading,
12418  PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
12419  upgrading for byte-strings
12420  
12421  =back
12422  
12423  =item CAVEATS
12424  
12425  =back
12426  
12427  =over 4
12428  
12429  =item SEE ALSO
12430  
12431  =item AUTHORS
12432  
12433  =item COPYRIGHT
12434  
12435  =back
12436  
12437  =head2 feature - Perl pragma to enable new syntactic features
12438  
12439  =over 4
12440  
12441  =item SYNOPSIS
12442  
12443  =item DESCRIPTION
12444  
12445  =over 4
12446  
12447  =item Lexical effect
12448  
12449  =item C<no feature>
12450  
12451  =item The 'switch' feature
12452  
12453  =item The 'say' feature
12454  
12455  =item the 'state' feature
12456  
12457  =back
12458  
12459  =item FEATURE BUNDLES
12460  
12461  =item IMPLICIT LOADING
12462  
12463  =back
12464  
12465  =head2 fields - compile-time class fields
12466  
12467  =over 4
12468  
12469  =item SYNOPSIS
12470  
12471  =item DESCRIPTION
12472  
12473  new, phash
12474  
12475  =item SEE ALSO
12476  
12477  =back
12478  
12479  =head2 filetest - Perl pragma to control the filetest permission operators
12480  
12481  =over 4
12482  
12483  =item SYNOPSIS
12484  
12485  =item DESCRIPTION
12486  
12487  =over 4
12488  
12489  =item Consider this carefully
12490  
12491  =item The "access" sub-pragma
12492  
12493  =item Limitation with regard to C<_>
12494  
12495  =back
12496  
12497  =back
12498  
12499  =head2 if - C<use> a Perl module if a condition holds
12500  
12501  =over 4
12502  
12503  =item SYNOPSIS
12504  
12505  =item DESCRIPTION
12506  
12507  =item BUGS
12508  
12509  =item AUTHOR
12510  
12511  =back
12512  
12513  =head2 integer - Perl pragma to use integer arithmetic instead of floating
12514  point
12515  
12516  =over 4
12517  
12518  =item SYNOPSIS
12519  
12520  =item DESCRIPTION
12521  
12522  =back
12523  
12524  =head2 less - perl pragma to request less of something
12525  
12526  =over 4
12527  
12528  =item SYNOPSIS
12529  
12530  =item DESCRIPTION
12531  
12532  =item FOR MODULE AUTHORS
12533  
12534  =over 4
12535  
12536  =item C<< BOOLEAN = less->of( FEATURE ) >>
12537  
12538  =item C<< FEATURES = less->of() >>
12539  
12540  =back
12541  
12542  =item CAVEATS
12543  
12544  This probably does nothing, This works only on 5.10+
12545  
12546  =back
12547  
12548  =head2 lib - manipulate @INC at compile time
12549  
12550  =over 4
12551  
12552  =item SYNOPSIS
12553  
12554  =item DESCRIPTION
12555  
12556  =over 4
12557  
12558  =item Adding directories to @INC
12559  
12560  =item Deleting directories from @INC
12561  
12562  =item Restoring original @INC
12563  
12564  =back
12565  
12566  =item CAVEATS
12567  
12568  =item NOTES
12569  
12570  =item SEE ALSO
12571  
12572  =item AUTHOR
12573  
12574  =back
12575  
12576  =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
12577  operations
12578  
12579  =over 4
12580  
12581  =item SYNOPSIS
12582  
12583  =item DESCRIPTION
12584  
12585  =back
12586  
12587  =head2 mro - Method Resolution Order
12588  
12589  =over 4
12590  
12591  =item SYNOPSIS
12592  
12593  =item DESCRIPTION
12594  
12595  =item OVERVIEW
12596  
12597  =item The C3 MRO
12598  
12599  =over 4
12600  
12601  =item What is C3?
12602  
12603  =item How does C3 work
12604  
12605  =back
12606  
12607  =item Functions
12608  
12609  =over 4
12610  
12611  =item mro::get_linear_isa($classname[, $type])
12612  
12613  =item mro::set_mro($classname, $type)
12614  
12615  =item mro::get_mro($classname)
12616  
12617  =item mro::get_isarev($classname)
12618  
12619  =item mro::is_universal($classname)
12620  
12621  =item mro::invalidate_all_method_caches()
12622  
12623  =item mro::method_changed_in($classname)
12624  
12625  =item mro::get_pkg_gen($classname)
12626  
12627  =item next::method
12628  
12629  =item next::can
12630  
12631  =item maybe::next::method
12632  
12633  =back
12634  
12635  =item SEE ALSO
12636  
12637  =over 4
12638  
12639  =item The original Dylan paper
12640  
12641  L<http://www.webcom.com/haahr/dylan/linearization-oopsla96.html>
12642  
12643  =item The prototype Perl 6 Object Model uses C3
12644  
12645  L<http://svn.openfoundry.org/pugs/perl5/Perl6-MetaModel/>
12646  
12647  =item Parrot now uses C3
12648  
12649  L<http://aspn.activestate.com/ASPN/Mail/Message/perl6-internals/2746631>,
12650  L<http://use.perl.org/~autrijus/journal/25768>
12651  
12652  =item Python 2.3 MRO related links
12653  
12654  L<http://www.python.org/2.3/mro.html>,
12655  L<http://www.python.org/2.2.2/descrintro.html#mro>
12656  
12657  =item C3 for TinyCLOS
12658  
12659  L<http://www.call-with-current-continuation.org/eggs/c3.html>
12660  
12661  =item Class::C3
12662  
12663  L<Class::C3>
12664  
12665  =back
12666  
12667  =item AUTHOR
12668  
12669  =back
12670  
12671  =head2 open - perl pragma to set default PerlIO layers for input and output
12672  
12673  =over 4
12674  
12675  =item SYNOPSIS
12676  
12677  =item DESCRIPTION
12678  
12679  =item NONPERLIO FUNCTIONALITY
12680  
12681  =item IMPLEMENTATION DETAILS
12682  
12683  =item SEE ALSO
12684  
12685  =back
12686  
12687  =head2 ops - Perl pragma to restrict unsafe operations when compiling
12688  
12689  =over 4
12690  
12691  =item SYNOPSIS    
12692  
12693  =item DESCRIPTION
12694  
12695  =item SEE ALSO
12696  
12697  =back
12698  
12699  =head2 overload - Package for overloading Perl operations
12700  
12701  =over 4
12702  
12703  =item SYNOPSIS
12704  
12705  =item DESCRIPTION
12706  
12707  =over 4
12708  
12709  =item Declaration of overloaded functions
12710  
12711  =item Calling Conventions for Binary Operations
12712  
12713  FALSE, TRUE, C<undef>
12714  
12715  =item Calling Conventions for Unary Operations
12716  
12717  =item Calling Conventions for Mutators
12718  
12719  C<++> and C<-->, C<x=> and other assignment versions
12720  
12721  =item Overloadable Operations
12722  
12723  I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
12724  I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
12725  and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
12726  
12727  =item Inheritance and overloading
12728  
12729  Strings as values of C<use overload> directive, Overloading of an operation
12730  is inherited by derived classes
12731  
12732  =back
12733  
12734  =item SPECIAL SYMBOLS FOR C<use overload>
12735  
12736  =over 4
12737  
12738  =item Last Resort
12739  
12740  =item Fallback
12741  
12742  C<undef>, TRUE, defined, but FALSE
12743  
12744  =item Smart Match
12745  
12746  =item Copy Constructor
12747  
12748  B<Example>
12749  
12750  =back
12751  
12752  =item MAGIC AUTOGENERATION
12753  
12754  I<Assignment forms of arithmetic operations>, I<Conversion operations>,
12755  I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
12756  I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
12757  I<Copy operator>
12758  
12759  =item Minimal set of overloaded operations
12760  
12761  =item Losing overloading
12762  
12763  =item Run-time Overloading
12764  
12765  =item Public functions
12766  
12767  overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
12768  
12769  =item Overloading constants
12770  
12771  integer, float, binary, q, qr
12772  
12773  =item IMPLEMENTATION
12774  
12775  =item Metaphor clash
12776  
12777  =item Cookbook
12778  
12779  =over 4
12780  
12781  =item Two-face scalars
12782  
12783  =item Two-face references
12784  
12785  =item Symbolic calculator
12786  
12787  =item I<Really> symbolic calculator
12788  
12789  =back
12790  
12791  =item AUTHOR
12792  
12793  =item DIAGNOSTICS
12794  
12795  Odd number of arguments for overload::constant, `%s' is not an overloadable
12796  type, `%s' is not a code reference
12797  
12798  =item BUGS
12799  
12800  =back
12801  
12802  =head2 sigtrap - Perl pragma to enable simple signal handling
12803  
12804  =over 4
12805  
12806  =item SYNOPSIS
12807  
12808  =item DESCRIPTION
12809  
12810  =item OPTIONS
12811  
12812  =over 4
12813  
12814  =item SIGNAL HANDLERS
12815  
12816  B<stack-trace>, B<die>, B<handler> I<your-handler>
12817  
12818  =item SIGNAL LISTS
12819  
12820  B<normal-signals>, B<error-signals>, B<old-interface-signals>
12821  
12822  =item OTHER
12823  
12824  B<untrapped>, B<any>, I<signal>, I<number>
12825  
12826  =back
12827  
12828  =item EXAMPLES
12829  
12830  =back
12831  
12832  =head2 sort - perl pragma to control sort() behaviour
12833  
12834  =over 4
12835  
12836  =item SYNOPSIS
12837  
12838  =item DESCRIPTION
12839  
12840  =item CAVEATS
12841  
12842  =back
12843  
12844  =head2 strict - Perl pragma to restrict unsafe constructs
12845  
12846  =over 4
12847  
12848  =item SYNOPSIS
12849  
12850  =item DESCRIPTION
12851  
12852  C<strict refs>, C<strict vars>, C<strict subs>
12853  
12854  =item HISTORY
12855  
12856  =back
12857  
12858  =head2 subs - Perl pragma to predeclare sub names
12859  
12860  =over 4
12861  
12862  =item SYNOPSIS
12863  
12864  =item DESCRIPTION
12865  
12866  =back
12867  
12868  =head2 threadshared, threads::shared - Perl extension for sharing data
12869  structures between threads
12870  
12871  =over 4
12872  
12873  =item VERSION
12874  
12875  =item SYNOPSIS
12876  
12877  =item DESCRIPTION
12878  
12879  =item EXPORT
12880  
12881  =item FUNCTIONS
12882  
12883  share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE,
12884  cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT,
12885  cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE,
12886  cond_broadcast VARIABLE
12887  
12888  =item OBJECTS
12889  
12890  =item NOTES
12891  
12892  =item BUGS AND LIMITATIONS
12893  
12894  =item SEE ALSO
12895  
12896  =item AUTHOR
12897  
12898  =back
12899  
12900  =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
12901  code
12902  
12903  =over 4
12904  
12905  =item SYNOPSIS
12906  
12907  =item DESCRIPTION
12908  
12909  =over 4
12910  
12911  =item Utility functions
12912  
12913  $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
12914  FAIL_OK]), utf8::encode($string), $success = utf8::decode($string), $flag =
12915  utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
12916  
12917  =back
12918  
12919  =item BUGS
12920  
12921  =item SEE ALSO
12922  
12923  =back
12924  
12925  =head2 vars - Perl pragma to predeclare global variable names (obsolete)
12926  
12927  =over 4
12928  
12929  =item SYNOPSIS
12930  
12931  =item DESCRIPTION
12932  
12933  =back
12934  
12935  =head2 version - Perl extension for Version Objects
12936  
12937  =over 4
12938  
12939  =item SYNOPSIS
12940  
12941  =item DESCRIPTION
12942  
12943  =over 4
12944  
12945  =item BEST PRACTICES
12946  
12947  Be consistent, Be careful
12948  
12949  =item Using modules that use version.pm
12950  
12951  Numeric versions always work, Extended version work sometimes
12952  
12953  =item What IS a version
12954  
12955  Numeric Versions, Extended Versions
12956  
12957  =item Numeric Versions
12958  
12959  =item Extended Versions
12960  
12961  =item Numeric Alpha Versions
12962  
12963  =item Object Methods
12964  
12965  New Operator, qv(), Normal Form, Numification, Stringification, Comparison
12966  operators, Logical Operators
12967  
12968  =item Quoting
12969  
12970  =item What about v-strings?
12971  
12972  =item Types of Versions Objects
12973  
12974  Ordinary versions, Alpha Versions
12975  
12976  =item Replacement UNIVERSAL::VERSION
12977  
12978  =back
12979  
12980  =item SUBCLASSING
12981  
12982  =item EXPORT
12983  
12984  =item AUTHOR
12985  
12986  =item SEE ALSO
12987  
12988  =back
12989  
12990  =head2 vmsish - Perl pragma to control VMS-specific language features
12991  
12992  =over 4
12993  
12994  =item SYNOPSIS
12995  
12996  =item DESCRIPTION
12997  
12998  C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
12999  
13000  =back
13001  
13002  =head2 warnings - Perl pragma to control optional warnings
13003  
13004  =over 4
13005  
13006  =item SYNOPSIS
13007  
13008  =item DESCRIPTION
13009  
13010  use warnings::register, warnings::enabled(), warnings::enabled($category),
13011  warnings::enabled($object), warnings::warn($message),
13012  warnings::warn($category, $message), warnings::warn($object, $message),
13013  warnings::warnif($message), warnings::warnif($category, $message),
13014  warnings::warnif($object, $message)
13015  
13016  =back
13017  
13018  =head2 warnings::register - warnings import function
13019  
13020  =over 4
13021  
13022  =item SYNOPSIS
13023  
13024  =item DESCRIPTION
13025  
13026  =back
13027  
13028  =head1 MODULE DOCUMENTATION
13029  
13030  =head2 AnyDBM_File - provide framework for multiple DBMs
13031  
13032  =over 4
13033  
13034  =item SYNOPSIS
13035  
13036  =item DESCRIPTION
13037  
13038  =over 4
13039  
13040  =item DBM Comparisons
13041  
13042  [0], [1], [2], [3]
13043  
13044  =back
13045  
13046  =item SEE ALSO
13047  
13048  =back
13049  
13050  =head2 Archive::Extract - A generic archive extracting mechanism
13051  
13052  =over 4
13053  
13054  =item SYNOPSIS
13055  
13056  =item DESCRIPTION
13057  
13058  =back
13059  
13060  =over 4
13061  
13062  =item METHODS
13063  
13064  =over 4
13065  
13066  =item $ae = Archive::Extract->new(archive => '/path/to/archive',[type =>
13067  TYPE])
13068  
13069  tar, tgz, gz, Z, zip, bz2, tbz
13070  
13071  =back
13072  
13073  =back
13074  
13075  =over 4
13076  
13077  =item $ae->extract( [to => '/output/path'] )
13078  
13079  $ae->extract_path, $ae->files
13080  
13081  =back
13082  
13083  =over 4
13084  
13085  =item ACCESSORS
13086  
13087  =over 4
13088  
13089  =item $ae->error([BOOL])
13090  
13091  =item $ae->extract_path
13092  
13093  =item $ae->files
13094  
13095  =item $ae->archive
13096  
13097  =item $ae->type
13098  
13099  =item $ae->types
13100  
13101  =back
13102  
13103  =back
13104  
13105  =over 4
13106  
13107  =item $ae->is_tgz
13108  
13109  =item $ae->is_tar
13110  
13111  =item $ae->is_gz
13112  
13113  =item $ae->is_Z
13114  
13115  =item $ae->is_zip
13116  
13117  =back
13118  
13119  =over 4
13120  
13121  =item $ae->bin_tar
13122  
13123  =item $ae->bin_gzip
13124  
13125  =item $ae->bin_unzip
13126  
13127  =back
13128  
13129  =over 4
13130  
13131  =item HOW IT WORKS
13132  
13133  =item CAVEATS
13134  
13135  =over 4
13136  
13137  =item File Extensions
13138  
13139  =item Supporting Very Large Files
13140  
13141  =item Bunzip2 support of arbitrary extensions.
13142  
13143  =back
13144  
13145  =item GLOBAL VARIABLES
13146  
13147  =over 4
13148  
13149  =item $Archive::Extract::DEBUG
13150  
13151  =item $Archive::Extract::WARN
13152  
13153  =item $Archive::Extract::PREFER_BIN
13154  
13155  =back
13156  
13157  =item TODO
13158  
13159  Mime magic support
13160  
13161  =item BUG REPORTS
13162  
13163  =item AUTHOR
13164  
13165  =item COPYRIGHT
13166  
13167  =back
13168  
13169  =head2 Archive::Tar - module for manipulations of tar archives
13170  
13171  =over 4
13172  
13173  =item SYNOPSIS
13174  
13175  =item DESCRIPTION
13176  
13177  =item Object Methods
13178  
13179  =over 4
13180  
13181  =item Archive::Tar->new( [$file, $compressed] )
13182  
13183  =back
13184  
13185  =back
13186  
13187  =over 4
13188  
13189  =item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
13190  
13191  limit, extract
13192  
13193  =back
13194  
13195  =over 4
13196  
13197  =item $tar->contains_file( $filename )
13198  
13199  =back
13200  
13201  =over 4
13202  
13203  =item $tar->extract( [@filenames] )
13204  
13205  =back
13206  
13207  =over 4
13208  
13209  =item $tar->extract_file( $file, [$extract_path] )
13210  
13211  =back
13212  
13213  =over 4
13214  
13215  =item $tar->list_files( [\@properties] )
13216  
13217  =back
13218  
13219  =over 4
13220  
13221  =item $tar->get_files( [@filenames] )
13222  
13223  =back
13224  
13225  =over 4
13226  
13227  =item $tar->get_content( $file )
13228  
13229  =back
13230  
13231  =over 4
13232  
13233  =item $tar->replace_content( $file, $content )
13234  
13235  =back
13236  
13237  =over 4
13238  
13239  =item $tar->rename( $file, $new_name )
13240  
13241  =back
13242  
13243  =over 4
13244  
13245  =item $tar->remove (@filenamelist)
13246  
13247  =back
13248  
13249  =over 4
13250  
13251  =item $tar->clear
13252  
13253  =back
13254  
13255  =over 4
13256  
13257  =item $tar->write ( [$file, $compressed, $prefix] )
13258  
13259  =back
13260  
13261  =over 4
13262  
13263  =item $tar->add_files( @filenamelist )
13264  
13265  =back
13266  
13267  =over 4
13268  
13269  =item $tar->add_data ( $filename, $data, [$opthashref] )
13270  
13271  FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET
13272  
13273  =back
13274  
13275  =over 4
13276  
13277  =item $tar->error( [$BOOL] )
13278  
13279  =back
13280  
13281  =over 4
13282  
13283  =item $tar->setcwd( $cwd );
13284  
13285  =back
13286  
13287  =over 4
13288  
13289  =item $bool = $tar->has_io_string
13290  
13291  =back
13292  
13293  =over 4
13294  
13295  =item $bool = $tar->has_perlio
13296  
13297  =back
13298  
13299  =over 4
13300  
13301  =item Class Methods
13302  
13303  =over 4
13304  
13305  =item Archive::Tar->create_archive($file, $compression, @filelist)
13306  
13307  =back
13308  
13309  =back
13310  
13311  =over 4
13312  
13313  =item Archive::Tar->list_archive ($file, $compressed, [\@properties])
13314  
13315  =back
13316  
13317  =over 4
13318  
13319  =item Archive::Tar->extract_archive ($file, $gzip)
13320  
13321  =back
13322  
13323  =over 4
13324  
13325  =item Archive::Tar->can_handle_compressed_files
13326  
13327  =back
13328  
13329  =over 4
13330  
13331  =item GLOBAL VARIABLES
13332  
13333  =over 4
13334  
13335  =item $Archive::Tar::FOLLOW_SYMLINK
13336  
13337  =item $Archive::Tar::CHOWN
13338  
13339  =item $Archive::Tar::CHMOD
13340  
13341  =item $Archive::Tar::DO_NOT_USE_PREFIX
13342  
13343  =item $Archive::Tar::DEBUG
13344  
13345  =item $Archive::Tar::WARN
13346  
13347  =item $Archive::Tar::error
13348  
13349  =item $Archive::Tar::INSECURE_EXTRACT_MODE
13350  
13351  =item $Archive::Tar::HAS_PERLIO
13352  
13353  =item $Archive::Tar::HAS_IO_STRING
13354  
13355  =back
13356  
13357  =item FAQ
13358  
13359  What's the minimum perl version required to run Archive::Tar?, Isn't
13360  Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
13361  Can't you lazy-load data instead?, How much memory will an X kb tar file
13362  need?, What do you do with unsupported filetypes in an archive?, I'm using
13363  WinZip, or some other non-POSIX client, and files are not being extracted
13364  properly!, How do I extract only files that have property X from an
13365  archive?, How do I access .tar.Z files?, How do I handle Unicode strings?
13366  
13367  =item TODO
13368  
13369  Check if passed in handles are open for read/write, Allow archives to be
13370  passed in as string, Facilitate processing an opened filehandle of a
13371  compressed archive
13372  
13373  =item SEE ALSO
13374  
13375  The GNU tar specification, The PAX format specication, A comparison of GNU
13376  and POSIX tar standards;
13377  C<http://www.delorie.com/gnu/docs/tar/tar_114.html>, GNU tar intends to
13378  switch to POSIX compatibility, A Comparison between various tar
13379  implementations
13380  
13381  =item AUTHOR
13382  
13383  =item ACKNOWLEDGEMENTS
13384  
13385  =item COPYRIGHT
13386  
13387  =back
13388  
13389  =head2 Archive::Tar::File - a subclass for in-memory extracted file from
13390  Archive::Tar
13391  
13392  =over 4
13393  
13394  =item SYNOPSIS
13395  
13396  =item DESCRIPTION
13397  
13398  =over 4
13399  
13400  =item Accessors
13401  
13402  name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
13403  uname, gname, devmajor, devminor, prefix, raw
13404  
13405  =back
13406  
13407  =item Methods
13408  
13409  =over 4
13410  
13411  =item new( file => $path )
13412  
13413  =item new( data => $path, $data, $opt )
13414  
13415  =item new( chunk => $chunk )
13416  
13417  =back
13418  
13419  =back
13420  
13421  =over 4
13422  
13423  =item full_path
13424  
13425  =back
13426  
13427  =over 4
13428  
13429  =item validate
13430  
13431  =back
13432  
13433  =over 4
13434  
13435  =item has_content
13436  
13437  =back
13438  
13439  =over 4
13440  
13441  =item get_content
13442  
13443  =back
13444  
13445  =over 4
13446  
13447  =item get_content_by_ref
13448  
13449  =back
13450  
13451  =over 4
13452  
13453  =item replace_content( $content )
13454  
13455  =back
13456  
13457  =over 4
13458  
13459  =item rename( $new_name )
13460  
13461  =back
13462  
13463  =over 4
13464  
13465  =item Convenience methods
13466  
13467  is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
13468  is_socket, is_longlink, is_label, is_unknown
13469  
13470  =back
13471  
13472  =head2 Attribute::Handlers - Simpler definition of attribute handlers
13473  
13474  =over 4
13475  
13476  =item VERSION
13477  
13478  =item SYNOPSIS
13479  
13480  =item DESCRIPTION
13481  
13482  [0], [1], [2], [3], [4], [5], [6], [7]
13483  
13484  =over 4
13485  
13486  =item Typed lexicals
13487  
13488  =item Type-specific attribute handlers
13489  
13490  =item Non-interpretive attribute handlers
13491  
13492  =item Phase-specific attribute handlers
13493  
13494  =item Attributes as C<tie> interfaces
13495  
13496  =back
13497  
13498  =item EXAMPLES
13499  
13500  =item DIAGNOSTICS
13501  
13502  C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
13503  attributes>, C<Declaration of %s attribute in package %s may clash with
13504  future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
13505  C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
13506  be able to apply END handler>
13507  
13508  =item AUTHOR
13509  
13510  =item BUGS
13511  
13512  =item COPYRIGHT
13513  
13514  =back
13515  
13516  =head2 AutoLoader - load subroutines only on demand
13517  
13518  =over 4
13519  
13520  =item SYNOPSIS
13521  
13522  =item DESCRIPTION
13523  
13524  =over 4
13525  
13526  =item Subroutine Stubs
13527  
13528  =item Using B<AutoLoader>'s AUTOLOAD Subroutine
13529  
13530  =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
13531  
13532  =item Package Lexicals
13533  
13534  =item Not Using AutoLoader
13535  
13536  =item B<AutoLoader> vs. B<SelfLoader>
13537  
13538  =back
13539  
13540  =item CAVEATS
13541  
13542  =item SEE ALSO
13543  
13544  =back
13545  
13546  =head2 AutoSplit - split a package for autoloading
13547  
13548  =over 4
13549  
13550  =item SYNOPSIS
13551  
13552  =item DESCRIPTION
13553  
13554  $keep, $check, $modtime
13555  
13556  =over 4
13557  
13558  =item Multiple packages
13559  
13560  =back
13561  
13562  =item DIAGNOSTICS
13563  
13564  =back
13565  
13566  =head2 B - The Perl Compiler
13567  
13568  =over 4
13569  
13570  =item SYNOPSIS
13571  
13572  =item DESCRIPTION
13573  
13574  =item OVERVIEW
13575  
13576  =item Utility Functions
13577  
13578  =over 4
13579  
13580  =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
13581  objects
13582  
13583  sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
13584  check_av, unitcheck_av, begin_av, end_av, comppadlist, regex_padav, main_cv
13585  
13586  =item Functions for Examining the Symbol Table
13587  
13588  walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
13589  
13590  =item Functions Returning C<B::OP> objects or for walking op trees
13591  
13592  main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
13593  
13594  =item Miscellaneous Utility Functions
13595  
13596  ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
13597  perlstring(STR), class(OBJ), threadsv_names
13598  
13599  =item Exported utility variabiles
13600  
13601  @optype, @specialsv_name
13602  
13603  =back
13604  
13605  =item OVERVIEW OF CLASSES
13606  
13607  =over 4
13608  
13609  =item SV-RELATED CLASSES
13610  
13611  =item B::SV Methods
13612  
13613  REFCNT, FLAGS, object_2svref
13614  
13615  =item B::IV Methods
13616  
13617  IV, IVX, UVX, int_value, needs64bits, packiv
13618  
13619  =item B::NV Methods
13620  
13621  NV, NVX
13622  
13623  =item B::RV Methods
13624  
13625  RV
13626  
13627  =item B::PV Methods
13628  
13629  PV, RV, PVX
13630  
13631  =item B::PVMG Methods
13632  
13633  MAGIC, SvSTASH
13634  
13635  =item B::MAGIC Methods
13636  
13637  MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
13638  
13639  =item B::PVLV Methods
13640  
13641  TARGOFF, TARGLEN, TYPE, TARG
13642  
13643  =item B::BM Methods
13644  
13645  USEFUL, PREVIOUS, RARE, TABLE
13646  
13647  =item B::GV Methods
13648  
13649  is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
13650  LINE, FILE, FILEGV, GvREFCNT, FLAGS
13651  
13652  =item B::IO Methods
13653  
13654  LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
13655  BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
13656  
13657  =item B::AV Methods
13658  
13659  FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
13660  
13661  =item B::CV Methods
13662  
13663  STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
13664  XSUBANY, CvFLAGS, const_sv
13665  
13666  =item B::HV Methods
13667  
13668  FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
13669  
13670  =item OP-RELATED CLASSES
13671  
13672  =item B::OP Methods
13673  
13674  next, sibling, name, ppaddr, desc, targ, type, opt, flags, private, spare
13675  
13676  =item B::UNOP METHOD
13677  
13678  first
13679  
13680  =item B::BINOP METHOD
13681  
13682  last
13683  
13684  =item B::LOGOP METHOD
13685  
13686  other
13687  
13688  =item B::LISTOP METHOD
13689  
13690  children
13691  
13692  =item B::PMOP Methods
13693  
13694  pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, extflags, precomp,
13695  pmoffset
13696  
13697  =item B::SVOP METHOD
13698  
13699  sv, gv
13700  
13701  =item B::PADOP METHOD
13702  
13703  padix
13704  
13705  =item B::PVOP METHOD
13706  
13707  pv
13708  
13709  =item B::LOOP Methods
13710  
13711  redoop, nextop, lastop
13712  
13713  =item B::COP Methods
13714  
13715  label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints,
13716  hints_hash
13717  
13718  =back
13719  
13720  =item AUTHOR
13721  
13722  =back
13723  
13724  =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
13725  
13726  =over 4
13727  
13728  =item SYNOPSIS
13729  
13730  =item DESCRIPTION
13731  
13732  =item EXAMPLE
13733  
13734  =item OPTIONS
13735  
13736  =over 4
13737  
13738  =item Options for Opcode Ordering
13739  
13740  B<-basic>, B<-exec>, B<-tree>
13741  
13742  =item Options for Line-Style
13743  
13744  B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
13745  
13746  =item Options for tree-specific formatting
13747  
13748  B<-compact>, B<-loose>, B<-vt>, B<-ascii>
13749  
13750  =item Options controlling sequence numbering
13751  
13752  B<-base>I<n>, B<-bigendian>, B<-littleendian>
13753  
13754  =item Other options
13755  
13756  B<-src>, B<-stash="somepackage">, B<-main>, B<-nomain>, B<-nobanner>,
13757  B<-banner>, B<-banneris> => subref
13758  
13759  =item Option Stickiness
13760  
13761  =back
13762  
13763  =item ABBREVIATIONS
13764  
13765  =over 4
13766  
13767  =item OP class abbreviations
13768  
13769  =item OP flags abbreviations
13770  
13771  =back
13772  
13773  =item FORMATTING SPECIFICATIONS
13774  
13775  =over 4
13776  
13777  =item Special Patterns
13778  
13779  B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
13780  B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
13781  B<~>
13782  
13783  =item # Variables
13784  
13785  B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
13786  B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
13787  B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>,
13788  B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>,
13789  B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#sibaddr>,
13790  B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>,
13791  B<#typenum>
13792  
13793  =back
13794  
13795  =item One-Liner Command tips
13796  
13797  perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
13798  perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
13799  'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
13800  a{_POSIX_SAVED_IDS}', perl -MB::Concise -e
13801  'B::Concise::compile("-exec","-src", \%B::Concise::)->()'
13802  
13803  =item Using B::Concise outside of the O framework
13804  
13805  =over 4
13806  
13807  =item Example: Altering Concise Renderings
13808  
13809  =item set_style()
13810  
13811  =item set_style_standard($name)
13812  
13813  =item add_style()
13814  
13815  =item add_callback()
13816  
13817  =item Running B::Concise::compile()
13818  
13819  =item B::Concise::reset_sequence()
13820  
13821  =item Errors
13822  
13823  =back
13824  
13825  =item AUTHOR
13826  
13827  =back
13828  
13829  =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
13830  
13831  =over 4
13832  
13833  =item SYNOPSIS
13834  
13835  =item DESCRIPTION
13836  
13837  =item AUTHOR
13838  
13839  =back
13840  
13841  =head2 B::Deparse - Perl compiler backend to produce perl code
13842  
13843  =over 4
13844  
13845  =item SYNOPSIS
13846  
13847  =item DESCRIPTION
13848  
13849  =item OPTIONS
13850  
13851  B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
13852  B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
13853  
13854  =item USING B::Deparse AS A MODULE
13855  
13856  =over 4
13857  
13858  =item Synopsis
13859  
13860  =item Description
13861  
13862  =item new
13863  
13864  =item ambient_pragmas
13865  
13866  strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits,
13867  %^H
13868  
13869  =item coderef2text
13870  
13871  =back
13872  
13873  =item BUGS
13874  
13875  =item AUTHOR
13876  
13877  =back
13878  
13879  =head2 B::Lint - Perl lint
13880  
13881  =over 4
13882  
13883  =item SYNOPSIS
13884  
13885  =item DESCRIPTION
13886  
13887  =item OPTIONS AND LINT CHECKS
13888  
13889  B<magic-diamond>, B<context>, B<implicit-read> and B<implicit-write>,
13890  B<bare-subs>, B<dollar-underscore>, B<private-names>, B<undefined-subs>,
13891  B<regexp-variables>, B<all>, B<none>
13892  
13893  =item NON LINT-CHECK OPTIONS
13894  
13895  B<-u Package>
13896  
13897  =item EXTENDING LINT
13898  
13899  =item TODO
13900  
13901  while(<FH>) stomps $_, strict oo, unchecked system calls, more tests,
13902  validate against older perls
13903  
13904  =item BUGS
13905  
13906  =item AUTHOR
13907  
13908  =back
13909  
13910  =head2 B::O, O - Generic interface to Perl Compiler backends
13911  
13912  =over 4
13913  
13914  =item SYNOPSIS
13915  
13916  =item DESCRIPTION
13917  
13918  =item CONVENTIONS
13919  
13920  =item IMPLEMENTATION
13921  
13922  =item BUGS
13923  
13924  =item AUTHOR
13925  
13926  =back
13927  
13928  =head2 B::Showlex - Show lexical variables used in functions or files
13929  
13930  =over 4
13931  
13932  =item SYNOPSIS
13933  
13934  =item DESCRIPTION
13935  
13936  =item EXAMPLES
13937  
13938  =over 4
13939  
13940  =item OPTIONS
13941  
13942  =back
13943  
13944  =item SEE ALSO
13945  
13946  =item TODO
13947  
13948  =item AUTHOR
13949  
13950  =back
13951  
13952  =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
13953  
13954  =over 4
13955  
13956  =item SYNOPSIS
13957  
13958  =item DESCRIPTION
13959  
13960  =item AUTHOR
13961  
13962  =back
13963  
13964  =head2 B::Xref - Generates cross reference reports for Perl programs
13965  
13966  =over 4
13967  
13968  =item SYNOPSIS
13969  
13970  =item DESCRIPTION
13971  
13972  =item OPTIONS
13973  
13974  C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
13975  
13976  =item BUGS
13977  
13978  =item AUTHOR
13979  
13980  =back
13981  
13982  =head2 Benchmark - benchmark running times of Perl code
13983  
13984  =over 4
13985  
13986  =item SYNOPSIS
13987  
13988  =item DESCRIPTION
13989  
13990  =over 4
13991  
13992  =item Methods
13993  
13994  new, debug, iters
13995  
13996  =item Standard Exports
13997  
13998  timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
13999  timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
14000  TIMEDIFF, [ STYLE, [ FORMAT ] ] )
14001  
14002  =item Optional Exports
14003  
14004  clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
14005  STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
14006  disablecache ( ), enablecache ( ), timesum ( T1, T2 )
14007  
14008  =item :hireswallclock
14009  
14010  =back
14011  
14012  =item NOTES
14013  
14014  =item EXAMPLES
14015  
14016  =item INHERITANCE
14017  
14018  =item CAVEATS
14019  
14020  =item SEE ALSO
14021  
14022  =item AUTHORS
14023  
14024  =item MODIFICATION HISTORY
14025  
14026  =back
14027  
14028  =head2 CGI - Simple Common Gateway Interface Class
14029  
14030  =over 4
14031  
14032  =item SYNOPSIS
14033  
14034  =item ABSTRACT
14035  
14036  =item DESCRIPTION
14037  
14038  =over 4
14039  
14040  =item PROGRAMMING STYLE
14041  
14042  =item CALLING CGI.PM ROUTINES
14043  
14044  =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
14045  
14046  =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
14047  
14048  =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
14049  
14050  =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
14051  
14052  =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
14053  
14054  =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
14055  
14056  =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
14057  
14058  =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
14059  
14060  =item DELETING A PARAMETER COMPLETELY:
14061  
14062  =item DELETING ALL PARAMETERS:
14063  
14064  =item HANDLING NON-URLENCODED ARGUMENTS
14065  
14066  =item DIRECT ACCESS TO THE PARAMETER LIST:
14067  
14068  =item FETCHING THE PARAMETER LIST AS A HASH:
14069  
14070  =item SAVING THE STATE OF THE SCRIPT TO A FILE:
14071  
14072  =item RETRIEVING CGI ERRORS
14073  
14074  =item USING THE FUNCTION-ORIENTED INTERFACE
14075  
14076  B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
14077  B<:standard>, B<:all>
14078  
14079  =item PRAGMAS
14080  
14081  -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
14082  -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
14083  -private_tempfiles
14084  
14085  =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
14086  
14087  1. start_table() (generates a <table> tag), 2. end_table() (generates a
14088  </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
14089  a </ul> tag)
14090  
14091  =back
14092  
14093  =item GENERATING DYNAMIC DOCUMENTS
14094  
14095  =over 4
14096  
14097  =item CREATING A STANDARD HTTP HEADER:
14098  
14099  =item GENERATING A REDIRECTION HEADER
14100  
14101  =item CREATING THE HTML DOCUMENT HEADER
14102  
14103  B<Parameters:>, 4, 5, 6..
14104  
14105  =item ENDING THE HTML DOCUMENT:
14106  
14107  =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
14108  
14109  =item OBTAINING THE SCRIPT'S URL
14110  
14111  B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
14112  (B<-query_string>), B<-base>, B<-rewrite>
14113  
14114  =item MIXING POST AND URL PARAMETERS
14115  
14116  =back
14117  
14118  =item CREATING STANDARD HTML ELEMENTS:
14119  
14120  =over 4
14121  
14122  =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
14123  
14124  =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
14125  
14126  =item HTML SHORTCUTS AND LIST INTERPOLATION
14127  
14128  =item NON-STANDARD HTML SHORTCUTS
14129  
14130  =item AUTOESCAPING HTML
14131  
14132  $escaped_string = escapeHTML("unescaped string");, $charset =
14133  charset([$charset]);, $flag = autoEscape([$flag]);
14134  
14135  =item PRETTY-PRINTING HTML
14136  
14137  =back
14138  
14139  =item CREATING FILL-OUT FORMS:
14140  
14141  =over 4
14142  
14143  =item CREATING AN ISINDEX TAG
14144  
14145  =item STARTING AND ENDING A FORM
14146  
14147  B<application/x-www-form-urlencoded>, B<multipart/form-data>
14148  
14149  =item FORM ELEMENTS
14150  
14151  B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
14152  B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
14153  B<-onSelect>
14154  
14155  =item CREATING A TEXT FIELD
14156  
14157  B<Parameters>
14158  
14159  =item CREATING A BIG TEXT FIELD
14160  
14161  =item CREATING A PASSWORD FIELD
14162  
14163  =item CREATING A FILE UPLOAD FIELD
14164  
14165  B<Parameters>
14166  
14167  =item CREATING A POPUP MENU
14168  
14169  =item CREATING AN OPTION GROUP
14170  
14171  =item CREATING A SCROLLING LIST
14172  
14173  B<Parameters:>
14174  
14175  =item CREATING A GROUP OF RELATED CHECKBOXES
14176  
14177  B<Parameters:>
14178  
14179  =item CREATING A STANDALONE CHECKBOX
14180  
14181  B<Parameters:>
14182  
14183  =item CREATING A RADIO BUTTON GROUP
14184  
14185  B<Parameters:>
14186  
14187  =item CREATING A SUBMIT BUTTON 
14188  
14189  B<Parameters:>
14190  
14191  =item CREATING A RESET BUTTON
14192  
14193  =item CREATING A DEFAULT BUTTON
14194  
14195  =item CREATING A HIDDEN FIELD
14196  
14197  B<Parameters:>
14198  
14199  =item CREATING A CLICKABLE IMAGE BUTTON
14200  
14201  B<Parameters:>, 3. The third option (-align, optional) is an alignment
14202  type, and may be TOP, BOTTOM or MIDDLE
14203  
14204  =item CREATING A JAVASCRIPT ACTION BUTTON
14205  
14206  =back
14207  
14208  =item HTTP COOKIES
14209  
14210  1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
14211  B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
14212  
14213  =item WORKING WITH FRAMES
14214  
14215  1. Create a <Frameset> document, 2. Specify the destination for the
14216  document in the HTTP header, 3. Specify the destination for the document in
14217  the <form> tag
14218  
14219  =item SUPPORT FOR JAVASCRIPT
14220  
14221  B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
14222  B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
14223  
14224  =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
14225  
14226  =item DEBUGGING
14227  
14228  =over 4
14229  
14230  =item DUMPING OUT ALL THE NAME/VALUE PAIRS
14231  
14232  =back
14233  
14234  =item FETCHING ENVIRONMENT VARIABLES
14235  
14236  B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
14237  B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
14238  name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
14239  ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
14240  B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
14241  ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
14242  
14243  =item USING NPH SCRIPTS
14244  
14245  In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
14246  parameters
14247  
14248  =item Server Push
14249  
14250  multipart_init(), multipart_start(), multipart_end(), multipart_final()
14251  
14252  =item Avoiding Denial of Service Attacks
14253  
14254  B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
14255  basis>, B<2. Globally for all scripts>
14256  
14257  =item COMPATIBILITY WITH CGI-LIB.PL
14258  
14259  =item AUTHOR INFORMATION
14260  
14261  =item CREDITS
14262  
14263  Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
14264  (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
14265  (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
14266  (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
14267  (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
14268  (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
14269  (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
14270  MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
14271  (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
14272  Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
14273  MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
14274  ...and many many more..
14275  
14276  =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
14277  
14278  =item BUGS
14279  
14280  =item SEE ALSO
14281  
14282  =back
14283  
14284  =head2 CGI::Apache - Backward compatibility module for CGI.pm
14285  
14286  =over 4
14287  
14288  =item SYNOPSIS
14289  
14290  =item ABSTRACT
14291  
14292  =item DESCRIPTION
14293  
14294  =item AUTHOR INFORMATION
14295  
14296  =item BUGS
14297  
14298  =item SEE ALSO
14299  
14300  =back
14301  
14302  =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
14303  other) error log
14304  
14305  =over 4
14306  
14307  =item SYNOPSIS
14308  
14309  =item DESCRIPTION
14310  
14311  =item REDIRECTING ERROR MESSAGES
14312  
14313  =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
14314  
14315  =over 4
14316  
14317  =item Changing the default message
14318  
14319  =back
14320  
14321  =item DOING MORE THAN PRINTING A MESSAGE IN THE EVENT OF PERL ERRORS
14322  
14323  =item MAKING WARNINGS APPEAR AS HTML COMMENTS
14324  
14325  =item OVERRIDING THE NAME OF THE PROGRAM
14326  
14327  =item AUTHORS
14328  
14329  =item SEE ALSO
14330  
14331  =back
14332  
14333  =head2 CGI::Cookie - Interface to Netscape Cookies
14334  
14335  =over 4
14336  
14337  =item SYNOPSIS
14338  
14339  =item DESCRIPTION
14340  
14341  =item USING CGI::Cookie
14342  
14343  B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>, B<4.
14344  httponly flag>
14345  
14346  =over 4
14347  
14348  =item Creating New Cookies
14349  
14350  =item Sending the Cookie to the Browser
14351  
14352  =item Recovering Previous Cookies
14353  
14354  =item Manipulating Cookies
14355  
14356  B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
14357  
14358  =back
14359  
14360  =item AUTHOR INFORMATION
14361  
14362  =item BUGS
14363  
14364  =item SEE ALSO
14365  
14366  =back
14367  
14368  =head2 CGI::Fast - CGI Interface for Fast CGI
14369  
14370  =over 4
14371  
14372  =item SYNOPSIS
14373  
14374  =item DESCRIPTION
14375  
14376  =item OTHER PIECES OF THE PUZZLE
14377  
14378  =item WRITING FASTCGI PERL SCRIPTS
14379  
14380  =item INSTALLING FASTCGI SCRIPTS
14381  
14382  =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
14383  
14384  =item EXTERNAL FASTCGI SERVER INVOCATION
14385  
14386  FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
14387  
14388  =item CAVEATS
14389  
14390  =item AUTHOR INFORMATION
14391  
14392  =item BUGS
14393  
14394  =item SEE ALSO
14395  
14396  =back
14397  
14398  =head2 CGI::Pretty - module to produce nicely formatted HTML code
14399  
14400  =over 4
14401  
14402  =item SYNOPSIS
14403  
14404  =item DESCRIPTION
14405  
14406  =over 4
14407  
14408  =item Tags that won't be formatted
14409  
14410  =item Customizing the Indenting
14411  
14412  =back
14413  
14414  =item BUGS
14415  
14416  =item AUTHOR
14417  
14418  =item SEE ALSO
14419  
14420  =back
14421  
14422  =head2 CGI::Push - Simple Interface to Server Push
14423  
14424  =over 4
14425  
14426  =item SYNOPSIS
14427  
14428  =item DESCRIPTION
14429  
14430  =item USING CGI::Push
14431  
14432  -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
14433  
14434  =over 4
14435  
14436  =item Heterogeneous Pages
14437  
14438  =item Changing the Page Delay on the Fly
14439  
14440  =back
14441  
14442  =item INSTALLING CGI::Push SCRIPTS
14443  
14444  =item AUTHOR INFORMATION
14445  
14446  =item BUGS
14447  
14448  =item SEE ALSO
14449  
14450  =back
14451  
14452  =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
14453  
14454  =over 4
14455  
14456  =item SYNOPSIS
14457  
14458  =item ABSTRACT
14459  
14460  =item DESCRIPTION
14461  
14462  =item AUTHOR INFORMATION
14463  
14464  =item BUGS
14465  
14466  =item SEE ALSO
14467  
14468  =back
14469  
14470  =head2 CGI::Util - Internal utilities used by CGI module
14471  
14472  =over 4
14473  
14474  =item SYNOPSIS
14475  
14476  =item DESCRIPTION
14477  
14478  =item AUTHOR INFORMATION
14479  
14480  =item SEE ALSO
14481  
14482  =back
14483  
14484  =head2 CORE - Pseudo-namespace for Perl's core routines
14485  
14486  =over 4
14487  
14488  =item SYNOPSIS
14489  
14490  =item DESCRIPTION
14491  
14492  =item OVERRIDING CORE FUNCTIONS
14493  
14494  =item AUTHOR
14495  
14496  =item SEE ALSO
14497  
14498  =back
14499  
14500  =head2 CPAN - query, download and build perl modules from CPAN sites
14501  
14502  =over 4
14503  
14504  =item SYNOPSIS
14505  
14506  =item DESCRIPTION
14507  
14508  =over 4
14509  
14510  =item CPAN::shell([$prompt, $command]) Starting Interactive Mode
14511  
14512  Searching for authors, bundles, distribution files and modules, C<get>,
14513  C<make>, C<test>, C<install>, C<clean> modules or distributions, C<readme>,
14514  C<perldoc>, C<look> module or distribution, C<ls> author, C<ls>
14515  globbing_expression, C<failed>, Persistence between sessions, The C<force>
14516  and the C<fforce> pragma, Lockfile, Signals
14517  
14518  =item CPAN::Shell
14519  
14520  =item autobundle
14521  
14522  =item hosts
14523  
14524  =item mkmyconfig
14525  
14526  =item recent ***EXPERIMENTAL COMMAND***
14527  
14528  =item recompile
14529  
14530  =item report Bundle|Distribution|Module
14531  
14532  =item smoke ***EXPERIMENTAL COMMAND***
14533  
14534  =item upgrade [Module|/Regex/]...
14535  
14536  =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
14537  
14538  =item Integrating local directories
14539  
14540  =back
14541  
14542  =item CONFIGURATION
14543  
14544  completion support, displaying some help: o conf help, displaying current
14545  values: o conf [KEY], changing of scalar values: o conf KEY VALUE, changing
14546  of list values: o conf KEY SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST, reverting to
14547  saved: o conf defaults, saving the config: o conf commit
14548  
14549  =over 4
14550  
14551  =item Config Variables
14552  
14553  C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
14554  E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
14555  optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
14556  [unshift|push|splice] E<lt>listE<gt>>, interactive editing: o conf init
14557  [MATCH|LIST]
14558  
14559  =item CPAN::anycwd($path): Note on config variable getcwd
14560  
14561  cwd, getcwd, fastcwd, backtickcwd
14562  
14563  =item Note on the format of the urllist parameter
14564  
14565  =item The urllist parameter has CD-ROM support
14566  
14567  =item Maintaining the urllist parameter
14568  
14569  =item The C<requires> and C<build_requires> dependency declarations
14570  
14571  =item Configuration for individual distributions (I<Distroprefs>)
14572  
14573  =item Filenames
14574  
14575  =item Fallback Data::Dumper and Storable
14576  
14577  =item Blueprint
14578  
14579  =item Language Specs
14580  
14581  comment [scalar], cpanconfig [hash], depends [hash] *** EXPERIMENTAL
14582  FEATURE ***, disabled [boolean], goto [string], install [hash], make
14583  [hash], match [hash], patches [array], pl [hash], test [hash]
14584  
14585  =item Processing Instructions
14586  
14587  args [array], commandline, eexpect [hash], env [hash], expect [array]
14588  
14589  =item Schema verification with C<Kwalify>
14590  
14591  =item Example Distroprefs Files
14592  
14593  =back
14594  
14595  =item PROGRAMMER'S INTERFACE
14596  
14597  expand($type,@things), expandany(@things), Programming Examples
14598  
14599  =over 4
14600  
14601  =item Methods in the other Classes
14602  
14603  CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
14604  CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
14605  CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
14606  CPAN::Bundle::clean(), CPAN::Bundle::contains(),
14607  CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
14608  CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
14609  CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
14610  CPAN::Bundle::readme(), CPAN::Bundle::test(),
14611  CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
14612  CPAN::Distribution::author, CPAN::Distribution::pretty_id(),
14613  CPAN::Distribution::base_id(), CPAN::Distribution::clean(),
14614  CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
14615  CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
14616  CPAN::Distribution::get(), CPAN::Distribution::install(),
14617  CPAN::Distribution::install_tested(), CPAN::Distribution::isa_perl(),
14618  CPAN::Distribution::is_tested(), CPAN::Distribution::look(),
14619  CPAN::Distribution::make(), CPAN::Distribution::perldoc(),
14620  CPAN::Distribution::prefs(), CPAN::Distribution::prereq_pm(),
14621  CPAN::Distribution::readme(), CPAN::Distribution::reports(),
14622  CPAN::Distribution::read_yaml(), CPAN::Distribution::test(),
14623  CPAN::Distribution::uptodate(), CPAN::Index::force_reload(),
14624  CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(),
14625  CPAN::Module::as_string(), CPAN::Module::clean(),
14626  CPAN::Module::cpan_file(), CPAN::Module::cpan_version(),
14627  CPAN::Module::cvs_import(), CPAN::Module::description(),
14628  CPAN::Module::distribution(), CPAN::Module::dslip_status(),
14629  CPAN::Module::force($method,@args), CPAN::Module::get(),
14630  CPAN::Module::inst_file(), CPAN::Module::available_file(),
14631  CPAN::Module::inst_version(), CPAN::Module::available_version(),
14632  CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(),
14633  CPAN::Module::manpage_headline(), CPAN::Module::perldoc(),
14634  CPAN::Module::readme(), CPAN::Module::reports(), CPAN::Module::test(),
14635  CPAN::Module::uptodate(), CPAN::Module::userid()
14636  
14637  =item Cache Manager
14638  
14639  =item Bundles
14640  
14641  =back
14642  
14643  =item PREREQUISITES
14644  
14645  =item UTILITIES
14646  
14647  =over 4
14648  
14649  =item Finding packages and VERSION
14650  
14651  =item Debugging
14652  
14653  o debug package.., o debug -package.., o debug all, o debug number
14654  
14655  =item Floppy, Zip, Offline Mode
14656  
14657  =item Basic Utilities for Programmers
14658  
14659  has_inst($module), has_usable($module), instance($module)
14660  
14661  =back
14662  
14663  =item SECURITY
14664  
14665  =over 4
14666  
14667  =item Cryptographically signed modules
14668  
14669  =back
14670  
14671  =item EXPORT
14672  
14673  =item ENVIRONMENT
14674  
14675  =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
14676  
14677  =item WORKING WITH CPAN.pm BEHIND FIREWALLS
14678  
14679  =over 4
14680  
14681  =item Three basic types of firewalls
14682  
14683  http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
14684  
14685  =item Configuring lynx or ncftp for going through a firewall
14686  
14687  =back
14688  
14689  =item FAQ
14690  
14691  1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15), 16)
14692  
14693  =item COMPATIBILITY
14694  
14695  =over 4
14696  
14697  =item OLD PERL VERSIONS
14698  
14699  =item CPANPLUS
14700  
14701  =back
14702  
14703  =item SECURITY ADVICE
14704  
14705  =item BUGS
14706  
14707  =item AUTHOR
14708  
14709  =item LICENSE
14710  
14711  =item TRANSLATIONS
14712  
14713  =item SEE ALSO
14714  
14715  =back
14716  
14717  =head2 CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
14718  
14719  =over 4
14720  
14721  =item RECIPES
14722  
14723  =over 4
14724  
14725  =item What distribution contains a particular module?
14726  
14727  =item What modules does a particular distribution contain?
14728  
14729  =back
14730  
14731  =item SEE ALSO
14732  
14733  =item LICENSE
14734  
14735  =item AUTHOR
14736  
14737  =back
14738  
14739  =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
14740  
14741  =over 4
14742  
14743  =item SYNOPSIS
14744  
14745  =item DESCRIPTION
14746  
14747  =back
14748  
14749  auto_commit, build_cache, build_dir, build_dir_reuse,
14750  build_requires_install_policy, cache_metadata, check_sigs, colorize_output,
14751  colorize_print, colorize_warn, colorize_debug, commandnumber_in_prompt,
14752  ftp_passive, getcwd, histfile, histsize, inactivity_timeout, index_expire,
14753  inhibit_startup_message, keep_source_where, load_module_verbosity,
14754  makepl_arg, make_arg, make_install_arg, make_install_make_command,
14755  mbuildpl_arg, mbuild_arg, mbuild_install_arg, mbuild_install_build_command,
14756  pager, prefer_installer, prefs_dir, prerequisites_policy,
14757  randomize_urllist, scan_cache, shell, show_unparsable_versions,
14758  show_upload_date, show_zero_versions, tar_verbosity, term_is_latin,
14759  term_ornaments, test_report, use_sqlite, yaml_load_code, yaml_module
14760  
14761  =over 4
14762  
14763  =item LICENSE
14764  
14765  =back
14766  
14767  =head2 CPAN::Kwalify - Interface between CPAN.pm and Kwalify.pm
14768  
14769  =over 4
14770  
14771  =item SYNOPSIS
14772  
14773  =item DESCRIPTION
14774  
14775  _validate($schema_name, $data, $file, $doc), yaml($schema_name)
14776  
14777  =item AUTHOR
14778  
14779  =item LICENSE
14780  
14781  =back
14782  
14783  =head2 CPAN::Version - utility functions to compare CPAN versions
14784  
14785  =over 4
14786  
14787  =item SYNOPSIS
14788  
14789  =item DESCRIPTION
14790  
14791  =item LICENSE
14792  
14793  =back
14794  
14795  =head2 CPANPLUS - API & CLI access to the CPAN mirrors
14796  
14797  =over 4
14798  
14799  =item SYNOPSIS
14800  
14801  =item GUIDE TO DOCUMENTATION
14802  
14803  =over 4
14804  
14805  =item GENERAL USAGE
14806  
14807  =item API REFERENCE
14808  
14809  =back
14810  
14811  =back
14812  
14813  =over 4
14814  
14815  =item COMMANDLINE TOOLS
14816  
14817  =over 4
14818  
14819  =item STARTING AN INTERACTIVE SHELL
14820  
14821  =item BUILDING PACKAGES
14822  
14823  =item $bool = install( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14824  
14825  =item $where = fetch( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14826  
14827  =item $where = get( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14828  
14829  =item shell()
14830  
14831  =back
14832  
14833  =item FAQ
14834  
14835  =item BUG REPORTS
14836  
14837  =item AUTHOR
14838  
14839  =item COPYRIGHT
14840  
14841  =item SEE ALSO
14842  
14843  =item CONTACT INFORMATION
14844  
14845  Bug reporting: I<bug-cpanplus@rt.cpan.org>, Questions & suggestions:
14846  I<cpanplus-devel@lists.sourceforge.net>
14847  
14848  =back
14849  
14850  =head2 CPANPLUS::Backend
14851  
14852  =over 4
14853  
14854  =item SYNOPSIS
14855  
14856  =item DESCRIPTION
14857  
14858  =item ENVIRONMENT
14859  
14860  =item METHODS
14861  
14862  =over 4
14863  
14864  =item $cb = CPANPLUS::Backend->new( [CONFIGURE_OBJ] )
14865  
14866  Provide a valid C<CPANPLUS::Configure> object, No arguments
14867  
14868  =back
14869  
14870  =back
14871  
14872  =over 4
14873  
14874  =item $href = $cb->module_tree( [@modules_names_list] )
14875  
14876  =back
14877  
14878  =over 4
14879  
14880  =item $href = $cb->author_tree( [@author_names_list] )
14881  
14882  =back
14883  
14884  =over 4
14885  
14886  =item $conf = $cb->configure_object;
14887  
14888  =back
14889  
14890  =over 4
14891  
14892  =item $su = $cb->selfupdate_object;
14893  
14894  =back
14895  
14896  =over 4
14897  
14898  =item @mods = $cb->search( type => TYPE, allow => AREF, [data => AREF,
14899  verbose => BOOL] )
14900  
14901  =back
14902  
14903  =over 4
14904  
14905  =item $backend_rv = $cb->fetch( modules => \@mods )
14906  
14907  =item $backend_rv = $cb->extract( modules => \@mods )
14908  
14909  =item $backend_rv = $cb->install( modules => \@mods )
14910  
14911  =item $backend_rv = $cb->readme( modules => \@mods )
14912  
14913  =item $backend_rv = $cb->files( modules => \@mods )
14914  
14915  =item $backend_rv = $cb->distributions( modules => \@mods )
14916  
14917  =back
14918  
14919  =over 4
14920  
14921  =item $mod_obj = $cb->parse_module( module =>
14922  $modname|$distname|$modobj|URI )
14923  
14924  Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
14925  AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
14926  AYRNIEU/Text-Bastardize-1.06.tar.gz,
14927  http://example.com/Text-Bastardize-1.06.tar.gz,
14928  file:///tmp/Text-Bastardize-1.06.tar.gz
14929  
14930  =back
14931  
14932  =over 4
14933  
14934  =item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL]
14935  );
14936  
14937  =back
14938  
14939  =over 4
14940  
14941  =item $bool = $cb->flush(CACHE_NAME)
14942  
14943  C<methods>, C<hosts>, C<modules>, C<lib>, C<load>, C<all>
14944  
14945  =back
14946  
14947  =over 4
14948  
14949  =item @mods = $cb->installed()
14950  
14951  =back
14952  
14953  =over 4
14954  
14955  =item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files =>
14956  BOOL, force => BOOL, verbose => BOOL] )
14957  
14958  path, index_files, force, verbose
14959  
14960  =back
14961  
14962  =over 4
14963  
14964  =item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose
14965  => BOOL])
14966  
14967  =back
14968  
14969  =over 4
14970  
14971  =item CUSTOM MODULE SOURCES
14972  
14973  =over 4
14974  
14975  =item %files = $cb->list_custom_sources
14976  
14977  =back
14978  
14979  =back
14980  
14981  =over 4
14982  
14983  =item $local_index = $cb->add_custom_source( uri => URI, [verbose => BOOL]
14984  );
14985  
14986  =back
14987  
14988  =over 4
14989  
14990  =item $local_index = $cb->remove_custom_source( uri => URI, [verbose =>
14991  BOOL] );
14992  
14993  =back
14994  
14995  =over 4
14996  
14997  =item $bool = $cb->update_custom_source( [remote => URI] );
14998  
14999  =back
15000  
15001  =over 4
15002  
15003  =item $file = $cb->write_custom_source_index( path =>
15004  /path/to/package/root, [to => /path/to/index/file, verbose => BOOL] );
15005  
15006  =back
15007  
15008  =over 4
15009  
15010  =item BUG REPORTS
15011  
15012  =item AUTHOR
15013  
15014  =item COPYRIGHT
15015  
15016  =item SEE ALSO
15017  
15018  =back
15019  
15020  =head2 CPANPLUS::Backend::RV
15021  
15022  =over 4
15023  
15024  =item SYNOPSIS
15025  
15026  =item DESCRIPTION
15027  
15028  =item METHODS
15029  
15030  =over 4
15031  
15032  =item new( ok => BOOL, args => DATA, rv => DATA, [function => $method_name]
15033  )
15034  
15035  ok, args, rv, function
15036  
15037  =back
15038  
15039  =back
15040  
15041  =over 4
15042  
15043  =item BUG REPORTS
15044  
15045  =item AUTHOR
15046  
15047  =item COPYRIGHT
15048  
15049  =back
15050  
15051  =head2 CPANPLUS::Config
15052  
15053  =over 4
15054  
15055  =item DESCRIPTION
15056  
15057  =item CONFIGURATION
15058  
15059  =back
15060  
15061  =over 4
15062  
15063  =item Section 'conf'
15064  
15065  hosts
15066  
15067  =back
15068  
15069  base
15070  
15071  buildflags
15072  
15073  cpantest
15074  
15075  cpantest_mx
15076  
15077  debug
15078  
15079  dist_type
15080  
15081  email
15082  
15083  extractdir
15084  
15085  fetchdir
15086  
15087  flush
15088  
15089  force
15090  
15091  lib
15092  
15093  makeflags
15094  
15095  makemakerflags
15096  
15097  md5
15098  
15099  no_update
15100  
15101  passive
15102  
15103  prefer_bin
15104  
15105  prefer_makefile
15106  
15107  prereqs
15108  
15109  shell
15110  
15111  show_startup_tip
15112  
15113  signature
15114  
15115  skiptest
15116  
15117  storable
15118  
15119  timeout
15120  
15121  verbose
15122  
15123  write_install_log
15124  
15125  editor
15126  
15127  make
15128  
15129  pager
15130  
15131  shell
15132  
15133  sudo
15134  
15135  perlwrapper
15136  
15137  =over 4
15138  
15139  =item BUG REPORTS
15140  
15141  =item AUTHOR
15142  
15143  =item COPYRIGHT
15144  
15145  =item SEE ALSO
15146  
15147  =back
15148  
15149  =head2 CPANPLUS::Configure
15150  
15151  =over 4
15152  
15153  =item SYNOPSIS
15154  
15155  =item DESCRIPTION
15156  
15157  =item METHODS
15158  
15159  =over 4
15160  
15161  =item $Configure = CPANPLUS::Configure->new( load_configs => BOOL )
15162  
15163  =back
15164  
15165  =back
15166  
15167  =over 4
15168  
15169  =item $bool = $Configure->init( [rescan => BOOL])
15170  
15171  =back
15172  
15173  =over 4
15174  
15175  =item can_save( [$config_location] )
15176  
15177  =back
15178  
15179  =over 4
15180  
15181  =item $file = $conf->save( [$package_name] )
15182  
15183  =back
15184  
15185  =over 4
15186  
15187  =item options( type => TYPE )
15188  
15189  =back
15190  
15191  =over 4
15192  
15193  =item ACCESSORS
15194  
15195  =over 4
15196  
15197  =item get_SOMETHING( ITEM, [ITEM, ITEM, ... ] );
15198  
15199  =item set_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
15200  
15201  =item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
15202  
15203  set|get_conf, set|get_program, _set|_get_build, _set|_get_source,
15204  _set|_get_mirror, _set|_get_fetch
15205  
15206  =back
15207  
15208  =back
15209  
15210  =over 4
15211  
15212  =item BUG REPORTS
15213  
15214  =item AUTHOR
15215  
15216  =item COPYRIGHT
15217  
15218  =item SEE ALSO
15219  
15220  =back
15221  
15222  =head2 CPANPLUS::Dist
15223  
15224  =over 4
15225  
15226  =item SYNOPSIS
15227  
15228  =item DESCRIPTION
15229  
15230  =item ACCESSORS
15231  
15232  parent(), status()
15233  
15234  =item STATUS ACCESSORS
15235  
15236  created(), installed(), uninstalled(), dist()
15237  
15238  =back
15239  
15240  =over 4
15241  
15242  =item $dist = CPANPLUS::Dist->new( module => MODOBJ, [format => DIST_TYPE]
15243  );
15244  
15245  =back
15246  
15247  =over 4
15248  
15249  =item @dists = CPANPLUS::Dist->dist_types;
15250  
15251  =back
15252  
15253  =over 4
15254  
15255  =item prereq_satisfied( modobj => $modobj, version => $version_spec )
15256  
15257  =back
15258  
15259  =over 4
15260  
15261  =item _resolve_prereqs
15262  
15263  =back
15264  
15265  =head2 CPANPLUS::Dist::Base - Base class for custom distribution classes
15266  
15267  =over 4
15268  
15269  =item SYNOPSIS
15270  
15271  =item DESCRIPTION
15272  
15273  =item FLOW
15274  
15275  =item METHODS
15276  
15277  =back
15278  
15279  =over 4
15280  
15281  =item $bool = $Class->format_available
15282  
15283  =back
15284  
15285  =over 4
15286  
15287  =item $bool = $dist->init
15288  
15289  =back
15290  
15291  =over 4
15292  
15293  =item $bool = $dist->prepare
15294  
15295  =back
15296  
15297  =over 4
15298  
15299  =item $bool = $dist->create
15300  
15301  =back
15302  
15303  =over 4
15304  
15305  =item $bool = $dist->install
15306  
15307  =back
15308  
15309  =over 4
15310  
15311  =item $bool = $dist->uninstall
15312  
15313  =back
15314  
15315  =head2 CPANPLUS::Dist::Build
15316  
15317  =over 4
15318  
15319  =item SYNOPSIS
15320  
15321  =item DESCRIPTION
15322  
15323  =item ACCESSORS
15324  
15325  parent(), status()
15326  
15327  =item STATUS ACCESSORS
15328  
15329  build_pl (), build (), test (), prepared (), distdir (), created (),
15330  installed (), uninstalled (), _create_args (), _install_args (), _mb_object
15331  ()
15332  
15333  =back
15334  
15335  =over 4
15336  
15337  =item METHODS
15338  
15339  =over 4
15340  
15341  =item $bool = CPANPLUS::Dist::Build->format_available();
15342  
15343  =back
15344  
15345  =back
15346  
15347  =over 4
15348  
15349  =item $bool = $dist->init();
15350  
15351  =back
15352  
15353  =over 4
15354  
15355  =item $bool = $dist->prepare([perl => '/path/to/perl', buildflags =>
15356  'EXTRA=FLAGS', force => BOOL, verbose => BOOL])
15357  
15358  =back
15359  
15360  =over 4
15361  
15362  =item $dist->create([perl => '/path/to/perl', buildflags => 'EXTRA=FLAGS',
15363  prereq_target => TARGET, force => BOOL, verbose => BOOL, skiptest => BOOL])
15364  
15365  =back
15366  
15367  =over 4
15368  
15369  =item $dist->install([verbose => BOOL, perl => /path/to/perl])
15370  
15371  =back
15372  
15373  =over 4
15374  
15375  =item KNOWN ISSUES
15376  
15377  Module::Build can not be upgraded using its own API (#13169), Module::Build
15378  does not provide access to install history (#9793)
15379  
15380  =item AUTHOR
15381  
15382  =item COPYRIGHT
15383  
15384  =back
15385  
15386  =head2 CPANPLUS::Dist::MM
15387  
15388  =over 4
15389  
15390  =item SYNOPSIS
15391  
15392  =item ACCESSORS
15393  
15394  parent(), status()
15395  
15396  =item STATUS ACCESSORS 
15397  
15398  makefile (), make (), test (), prepared (), distdir (), created (),
15399  installed (), uninstalled (), _create_args (), _install_args ()
15400  
15401  =back
15402  
15403  =over 4
15404  
15405  =item METHODS
15406  
15407  =over 4
15408  
15409  =item $bool = $dist->format_available();
15410  
15411  =back
15412  
15413  =back
15414  
15415  =over 4
15416  
15417  =item $href = $dist->_find_prereqs( file => '/path/to/Makefile', [verbose
15418  => BOOL])
15419  
15420  =back
15421  
15422  =over 4
15423  
15424  =item $bool = $dist->create([perl => '/path/to/perl', make =>
15425  '/path/to/make', makeflags => 'EXTRA=FLAGS', prereq_target => TARGET,
15426  skiptest => BOOL, force => BOOL, verbose => BOOL])
15427  
15428  =back
15429  
15430  =over 4
15431  
15432  =item $bool = $dist->install([make => '/path/to/make',    makemakerflags =>
15433  'EXTRA=FLAGS', force => BOOL, verbose => BOOL])
15434  
15435  =back
15436  
15437  =over 4
15438  
15439  =item $bool = $dist->write_makefile_pl([force => BOOL, verbose => BOOL])
15440  
15441  =back
15442  
15443  =head2 CPANPLUS::Dist::Sample -- Sample code to create your own Dist::*
15444  plugin
15445  
15446  =over 4
15447  
15448  =item Description.
15449  
15450  =back
15451  
15452  =head2 CPANPLUS::Error
15453  
15454  =over 4
15455  
15456  =item SYNOPSIS
15457  
15458  =item DESCRIPTION
15459  
15460  =item FUNCTIONS
15461  
15462  =over 4
15463  
15464  =item cp_msg("message string" [,VERBOSE])
15465  
15466  =item msg()
15467  
15468  =item cp_error("error string" [,VERBOSE])
15469  
15470  =item error()
15471  
15472  =back
15473  
15474  =item CLASS METHODS
15475  
15476  =over 4
15477  
15478  =item CPANPLUS::Error->stack()
15479  
15480  =item CPANPLUS::Error->stack_as_string([TRACE])
15481  
15482  =item CPANPLUS::Error->flush()
15483  
15484  =back
15485  
15486  =back
15487  
15488  =over 4
15489  
15490  =item GLOBAL VARIABLES
15491  
15492  $ERROR_FH, $MSG_FH
15493  
15494  =back
15495  
15496  =head2 CPANPLUS::FAQ
15497  
15498  =over 4
15499  
15500  =item DESCRIPTION
15501  
15502  =item BUG REPORTS
15503  
15504  =item AUTHOR
15505  
15506  =item COPYRIGHT
15507  
15508  =back
15509  
15510  =head2 CPANPLUS::Hacking
15511  
15512  =over 4
15513  
15514  =item DESCRIPTION
15515  
15516  =item OBTAINING CPANPLUS
15517  
15518  =item INSTALLING CPANPLUS
15519  
15520  =item CONFIGURING CPANPLUS
15521  
15522  =item RUNNING CPANPLUS FROM DEVELOPMENT ENVIRONMENT
15523  
15524  =item RUNNING CPANPLUS TESTS
15525  
15526  =item FINDING BUGS
15527  
15528  Problem description, Program demonstrating the bug, [OPTIONAL] A patch to
15529  the test suite to test for the bug, [OPTIONAL] A patch to the code + tests
15530  + documentation
15531  
15532  =item SUPPLYING PATCHES
15533  
15534  In C<diff -u> or C<diff -c> format, From the root of the snapshot,
15535  Including patches for code + tests + docs, Sent per mail to
15536  cpanplus-devel@lists.sourceforge.net, With subject containing C<[PATCH]> +
15537  description of the patch
15538  
15539  =back
15540  
15541  =head2 CPANPLUS::Internals
15542  
15543  =over 4
15544  
15545  =item SYNOPSIS
15546  
15547  =item DESCRIPTION
15548  
15549  =item ACCESSORS
15550  
15551  _conf, _id, _lib, _perl5lib
15552  
15553  =back
15554  
15555  =over 4
15556  
15557  =item METHODS
15558  
15559  =over 4
15560  
15561  =item $internals = CPANPLUS::Internals->_init( _conf => CONFIG_OBJ )
15562  
15563  =back
15564  
15565  =back
15566  
15567  =over 4
15568  
15569  =item $bool = $internals->_flush( list => \@caches )
15570  
15571  =back
15572  
15573  =over 4
15574  
15575  =item $bool = $internals->_register_callback( name => CALLBACK_NAME, code
15576  => CODEREF );
15577  
15578  install_prerequisite, send_test_report, munge_test_report,
15579  edit_test_report, proceed_on_test_failure, munge_dist_metafile
15580  
15581  =back
15582  
15583  =over 4
15584  
15585  =item $bool = $internals->_add_to_includepath( directories => \@dirs )
15586  
15587  =back
15588  
15589  =over 4
15590  
15591  =item $id = CPANPLUS::Internals->_last_id
15592  
15593  =item $id = CPANPLUS::Internals->_store_id( $internals )
15594  
15595  =item $obj = CPANPLUS::Internals->_retrieve_id( $ID )
15596  
15597  =item CPANPLUS::Internals->_remove_id( $ID )
15598  
15599  =item @objs = CPANPLUS::Internals->_return_all_objects
15600  
15601  =back
15602  
15603  =head2 CPANPLUS::Internals::Extract
15604  
15605  =over 4
15606  
15607  =item SYNOPSIS
15608  
15609  =item DESCRIPTION
15610  
15611  =over 4
15612  
15613  =item $dir = _extract( module => $modobj, [perl => '/path/to/perl',
15614  extractdir => '/path/to/extract/to', prefer_bin => BOOL, verbose => BOOL,
15615  force => BOOL] )
15616  
15617  module, extractdir, prefer_bin, perl, verbose, force
15618  
15619  =back
15620  
15621  =back
15622  
15623  =head2 CPANPLUS::Internals::Fetch
15624  
15625  =over 4
15626  
15627  =item SYNOPSIS
15628  
15629  =item DESCRIPTION
15630  
15631  =item METHODS
15632  
15633  =back
15634  
15635  =over 4
15636  
15637  =item $path = _fetch( module => $modobj, [fetchdir => '/path/to/save/to',
15638  fetch_from => 'scheme://path/to/fetch/from', verbose => BOOL, force =>
15639  BOOL, prefer_bin => BOOL] )
15640  
15641  =back
15642  
15643  =over 4
15644  
15645  =item _add_fail_host( host => $host_hashref )
15646  
15647  =item _host_ok( host => $host_hashref )
15648  
15649  =back
15650  
15651  =head2 CPANPLUS::Internals::Report
15652  
15653  =over 4
15654  
15655  =item SYNOPSIS
15656  
15657  =item DESCRIPTION
15658  
15659  =item METHODS
15660  
15661  =over 4
15662  
15663  =item $bool = $cb->_have_query_report_modules
15664  
15665  =item $bool = $cb->_have_send_report_modules
15666  
15667  =back
15668  
15669  =back
15670  
15671  =over 4
15672  
15673  =item @list = $cb->_query_report( module => $modobj, [all_versions => BOOL,
15674  verbose => BOOL] )
15675  
15676  =back
15677  
15678  =over 4
15679  
15680  =item $bool = $cb->_send_report( module => $modobj, buffer => $make_output,
15681  failed => BOOL, [save => BOOL, address => $email_to, dontcc => BOOL,
15682  verbose => BOOL, force => BOOL]);
15683  
15684  module, buffer, failed, save, address, dontcc, verbose, force
15685  
15686  =back
15687  
15688  =head2 CPANPLUS::Internals::Search
15689  
15690  =over 4
15691  
15692  =item SYNOPSIS
15693  
15694  =item DESCRIPTION
15695  
15696  =item METHODS
15697  
15698  =over 4
15699  
15700  =item _search_module_tree( type => TYPE, allow => \@regexex, [data =>
15701  \@previous_results ] )
15702  
15703  type, allow, data
15704  
15705  =back
15706  
15707  =back
15708  
15709  =over 4
15710  
15711  =item _search_author_tree( type => TYPE, allow => \@regexex, [data =>
15712  \@previous_results ] )
15713  
15714  type, allow, data
15715  
15716  =back
15717  
15718  =over 4
15719  
15720  =item _all_installed()
15721  
15722  =back
15723  
15724  =head2 CPANPLUS::Internals::Source
15725  
15726  =over 4
15727  
15728  =item SYNOPSIS
15729  
15730  =item DESCRIPTION
15731  
15732  =item METHODS
15733  
15734  =back
15735  
15736  =over 4
15737  
15738  =item $cb->_check_trees( [update_source => BOOL, path => PATH, verbose =>
15739  BOOL] )
15740  
15741  update_source, path, verbose
15742  
15743  =back
15744  
15745  =over 4
15746  
15747  =item $cb->__check_uptodate( file => $file, name => $name, [update_source
15748  => BOOL, verbose => BOOL] )
15749  
15750  file, name, update_source, verbose
15751  
15752  =back
15753  
15754  =over 4
15755  
15756  =item $cb->_update_source( name => $name, [path => $path, verbose => BOOL]
15757  )
15758  
15759  name, path, verbose
15760  
15761  =back
15762  
15763  =over 4
15764  
15765  =item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path =>
15766  $path, verbose => BOOL] )
15767  
15768  uptodate, path, verbose, use_stored
15769  
15770  =back
15771  
15772  =over 4
15773  
15774  =item $cb->__retrieve_source(name => $name, [path => $path, uptodate =>
15775  BOOL, verbose => BOOL])
15776  
15777  name, uptodate, path, verbose
15778  
15779  =back
15780  
15781  =over 4
15782  
15783  =item $cb->_save_source([verbose => BOOL, path => $path])
15784  
15785  path, verbose
15786  
15787  =back
15788  
15789  =over 4
15790  
15791  =item $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose
15792  => BOOL])
15793  
15794  uptodate, path, verbose
15795  
15796  =back
15797  
15798  =over 4
15799  
15800  =item $cb->_create_mod_tree([path => $path, uptodate => BOOL, verbose =>
15801  BOOL])
15802  
15803  uptodate, path, verbose
15804  
15805  =back
15806  
15807  =over 4
15808  
15809  =item $cb->__create_dslip_tree([path => $path, uptodate => BOOL, verbose =>
15810  BOOL])
15811  
15812  uptodate, path, verbose
15813  
15814  =back
15815  
15816  =over 4
15817  
15818  =item $cb->_dslip_defs ()
15819  
15820  =back
15821  
15822  =over 4
15823  
15824  =item $file = $cb->_add_custom_module_source( uri => URI, [verbose => BOOL]
15825  ); 
15826  
15827  =back
15828  
15829  =over 4
15830  
15831  =item $index = $cb->__custom_module_source_index_file( uri => $uri );
15832  
15833  =back
15834  
15835  =over 4
15836  
15837  =item $file = $cb->_remove_custom_module_source( uri => URI, [verbose =>
15838  BOOL] ); 
15839  
15840  =back
15841  
15842  =over 4
15843  
15844  =item %files = $cb->__list_custom_module_sources
15845  
15846  =back
15847  
15848  =over 4
15849  
15850  =item $bool = $cb->__update_custom_module_sources( [verbose => BOOL] );
15851  
15852  =back
15853  
15854  =over 4
15855  
15856  =item $ok = $cb->__update_custom_module_source 
15857  
15858  =back
15859  
15860  =over 4
15861  
15862  =item $bool = $cb->__write_custom_module_index( path => /path/to/packages,
15863  [to => /path/to/index/file, verbose => BOOL] )
15864  
15865  =back
15866  
15867  =over 4
15868  
15869  =item $bool = $cb->__create_custom_module_entries( [verbose => BOOL] ) 
15870  
15871  =back
15872  
15873  =head2 CPANPLUS::Internals::Utils
15874  
15875  =over 4
15876  
15877  =item SYNOPSIS
15878  
15879  =item DESCRIPTION
15880  
15881  =item METHODS
15882  
15883  =over 4
15884  
15885  =item $cb->_mkdir( dir => '/some/dir' )
15886  
15887  =back
15888  
15889  =back
15890  
15891  =over 4
15892  
15893  =item $cb->_chdir( dir => '/some/dir' )
15894  
15895  =back
15896  
15897  =over 4
15898  
15899  =item $cb->_rmdir( dir => '/some/dir' );
15900  
15901  =back
15902  
15903  =over 4
15904  
15905  =item $cb->_perl_version ( perl => 'some/perl/binary' );
15906  
15907  =back
15908  
15909  =over 4
15910  
15911  =item $cb->_version_to_number( version => $version );
15912  
15913  =back
15914  
15915  =over 4
15916  
15917  =item $cb->_whoami
15918  
15919  =back
15920  
15921  =over 4
15922  
15923  =item _get_file_contents( file => $file );
15924  
15925  =back
15926  
15927  =over 4
15928  
15929  =item $cb->_mode_plus_w( file => '/path/to/file' );
15930  
15931  =back
15932  
15933  =over 4
15934  
15935  =item $uri = $cb->_host_to_uri( scheme => SCHEME, host => HOST, path =>
15936  PATH );
15937  
15938  =back
15939  
15940  =over 4
15941  
15942  =item $cb->_vcmp( VERSION, VERSION );
15943  
15944  =back
15945  
15946  =over 4
15947  
15948  =item $cb->_home_dir
15949  
15950  =back
15951  
15952  =over 4
15953  
15954  =item $path = $cb->_safe_path( path => $path );
15955  
15956  =back
15957  
15958  =over 4
15959  
15960  =item ($pkg, $version, $ext) = $cb->_split_package_string( package =>
15961  PACKAGE_STRING );
15962  
15963  =back
15964  
15965  =head2 CPANPLUS::Module
15966  
15967  =over 4
15968  
15969  =item SYNOPSIS
15970  
15971  =item DESCRIPTION
15972  
15973  =back
15974  
15975  =over 4
15976  
15977  =item CLASS METHODS
15978  
15979  =over 4
15980  
15981  =item accessors ()
15982  
15983  =back
15984  
15985  =back
15986  
15987  =over 4
15988  
15989  =item ACCESSORS
15990  
15991  name, module, version, path, comment, package, description, dslip
15992  
15993  =back
15994  
15995  status, author, parent
15996  
15997  =over 4
15998  
15999  =item STATUS ACCESSORS
16000  
16001  installer_type, dist_cpan, dist, prereqs, signature, extract, fetch,
16002  readme, uninstall, created, installed, checksums, checksum_ok,
16003  checksum_value
16004  
16005  =item METHODS
16006  
16007  =over 4
16008  
16009  =item $self = CPANPLUS::Module::new( OPTIONS )
16010  
16011  =back
16012  
16013  =back
16014  
16015  =over 4
16016  
16017  =item $mod->package_name
16018  
16019  =item $mod->package_version
16020  
16021  =item $mod->package_extension
16022  
16023  =item $mod->package_is_perl_core
16024  
16025  =item $mod->module_is_supplied_with_perl_core( [version => $]] )
16026  
16027  =item $mod->is_bundle
16028  
16029  =item $mod->is_third_party
16030  
16031  =item $mod->third_party_information
16032  
16033  =back
16034  
16035  =over 4
16036  
16037  =item $clone = $self->clone
16038  
16039  =back
16040  
16041  =over 4
16042  
16043  =item $where = $self->fetch
16044  
16045  =back
16046  
16047  =over 4
16048  
16049  =item $path = $self->extract
16050  
16051  =back
16052  
16053  =over 4
16054  
16055  =item $type = $self->get_installer_type([prefer_makefile => BOOL])
16056  
16057  =back
16058  
16059  =over 4
16060  
16061  =item $dist = $self->dist([target => 'prepare|create', format =>
16062  DISTRIBUTION_TYPE, args => {key => val}]);
16063  
16064  =back
16065  
16066  =over 4
16067  
16068  =item $bool = $mod->prepare( )
16069  
16070  Convenience method around C<install()> that prepares a module 
16071  without actually building it. This is equivalent to invoking C<install>
16072  with C<target> set to C<prepare>
16073  
16074  =back
16075  
16076  =over 4
16077  
16078  =item $bool = $mod->create( )
16079  
16080  =back
16081  
16082  =over 4
16083  
16084  =item $bool = $mod->test( )
16085  
16086  =back
16087  
16088  =over 4
16089  
16090  =item $bool = $self->install([ target => 'prepare|create|install', format
16091  => FORMAT_TYPE, extractdir => DIRECTORY, fetchdir => DIRECTORY, prefer_bin
16092  => BOOL, force => BOOL, verbose => BOOL, ..... ]);
16093  
16094  =back
16095  
16096  =over 4
16097  
16098  =item $text = $self->readme
16099  
16100  =back
16101  
16102  =over 4
16103  
16104  =item $version = $self->installed_version()
16105  
16106  =item $where = $self->installed_file()
16107  
16108  =item $bool = $self->is_uptodate([version => VERSION_NUMBER])
16109  
16110  =back
16111  
16112  =over 4
16113  
16114  =item $href = $self->details()
16115  
16116  =back
16117  
16118  =over 4
16119  
16120  =item @list = $self->contains()
16121  
16122  =back
16123  
16124  =over 4
16125  
16126  =item @list_of_hrefs = $self->fetch_report()
16127  
16128  =back
16129  
16130  =over 4
16131  
16132  =item $bool = $self->uninstall([type => [all|man|prog])
16133  
16134  =back
16135  
16136  =over 4
16137  
16138  =item @modobj = $self->distributions()
16139  
16140  =back
16141  
16142  =over 4
16143  
16144  =item @list = $self->files ()
16145  
16146  =back
16147  
16148  =over 4
16149  
16150  =item @list = $self->directory_tree ()
16151  
16152  =back
16153  
16154  =over 4
16155  
16156  =item @list = $self->packlist ()
16157  
16158  =back
16159  
16160  =over 4
16161  
16162  =item @list = $self->validate ()
16163  
16164  =back
16165  
16166  =over 4
16167  
16168  =item $bool = $self->add_to_includepath;
16169  
16170  =item $path = $self->best_path_to_module_build();
16171  
16172  =back
16173  
16174  =over 4
16175  
16176  =item BUG REPORTS
16177  
16178  =item AUTHOR
16179  
16180  =item COPYRIGHT
16181  
16182  =back
16183  
16184  =head2 CPANPLUS::Module::Author
16185  
16186  =over 4
16187  
16188  =item SYNOPSIS
16189  
16190  =item DESCRIPTION
16191  
16192  =item ACCESSORS
16193  
16194  author, cpanid, email, parent
16195  
16196  =back
16197  
16198  =over 4
16199  
16200  =item METHODS
16201  
16202  =over 4
16203  
16204  =item $auth = CPANPLUS::Module::Author->new( author => AUTHOR_NAME, cpanid
16205  => CPAN_ID, _id => INTERNALS_ID [, email => AUTHOR_EMAIL] )
16206  
16207  =back
16208  
16209  =back
16210  
16211  =over 4
16212  
16213  =item @mod_objs = $auth->modules()
16214  
16215  =back
16216  
16217  =over 4
16218  
16219  =item @dists = $auth->distributions()
16220  
16221  =back
16222  
16223  =over 4
16224  
16225  =item CLASS METHODS
16226  
16227  =over 4
16228  
16229  =item accessors ()
16230  
16231  =back
16232  
16233  =back
16234  
16235  =head2 CPANPLUS::Module::Author::Fake
16236  
16237  =over 4
16238  
16239  =item SYNOPSIS
16240  
16241  =item DESCRIPTION
16242  
16243  =item METHODS
16244  
16245  =over 4
16246  
16247  =item new( _id => DIGIT )
16248  
16249  =back
16250  
16251  =back
16252  
16253  =head2 CPANPLUS::Module::Checksums
16254  
16255  =over 4
16256  
16257  =item SYNOPSIS
16258  
16259  =item DESCRIPTION
16260  
16261  =item METHODS
16262  
16263  =over 4
16264  
16265  =item $mod->checksums
16266  
16267  =back
16268  
16269  =back
16270  
16271  =head2 CPANPLUS::Module::Fake
16272  
16273  =over 4
16274  
16275  =item SYNOPSIS
16276  
16277  =item DESCRIPTION
16278  
16279  =item METHODS
16280  
16281  =over 4
16282  
16283  =item new( module => $mod, path => $path, package => $pkg, [_id => DIGIT] )
16284  
16285  =back
16286  
16287  =back
16288  
16289  =head2 CPANPLUS::inc
16290  
16291  =over 4
16292  
16293  =item DESCRIPTION
16294  
16295  =back
16296  
16297  =head2 CPANPLUS::inc - runtime inclusion of privately bundled modules
16298  
16299  =over 4
16300  
16301  =item SYNOPSIS
16302  
16303  =item DESCRIPTION
16304  
16305  Put a coderef at the beginning of C<@INC>, Add the full path to the
16306  C<CPANPLUS/inc> directory to C<$ENV{PERL5LIB>
16307  
16308  =item METHODS
16309  
16310  =over 4
16311  
16312  =item CPANPLUS::inc->inc_path()
16313  
16314  =item CPANPLUS::inc->my_path()
16315  
16316  =item CPANPLUS::inc->installer_path()
16317  
16318  =back
16319  
16320  =back
16321  
16322  =over 4
16323  
16324  =item CPANPLUS::inc->original_perl5lib
16325  
16326  =item CPANPLUS::inc->original_perl5opt
16327  
16328  =item CPANPLUS::inc->original_inc
16329  
16330  =item CPANPLUS::inc->limited_perl5opt(@modules);
16331  
16332  =back
16333  
16334  =over 4
16335  
16336  =item CPANPLUS::inc->interesting_modules()
16337  
16338  =back
16339  
16340  =over 4
16341  
16342  =item INTERESTING MODULES
16343  
16344  Loop over your @INC, Check the version on every suitable module found in
16345  @INC
16346  
16347  =back
16348  
16349  =over 4
16350  
16351  =item DEBUG
16352  
16353  =item CAVEATS
16354  
16355  On multiple C<use lib> calls, our coderef may not be the first in @INC,
16356  Non-directories in @INC
16357  
16358  =back
16359  
16360  =head2 CPANPLUSelfupdate, CPANPLUS::Selfupdate
16361  
16362  =over 4
16363  
16364  =item SYNOPSIS
16365  
16366  =back
16367  
16368  =over 4
16369  
16370  =item METHODS
16371  
16372  =over 4
16373  
16374  =item $self = CPANPLUS::Selfupdate->new( $backend_object );
16375  
16376  =back
16377  
16378  =back
16379  
16380  =over 4
16381  
16382  =item %list = $self->list_modules_to_update( update =>
16383  "core|dependencies|enabled_features|features|all", [latest => BOOL] )
16384  
16385  List which modules C<selfupdate> would upgrade. You can update either 
16386  the core (CPANPLUS itself), the core dependencies, all features you have
16387  currently turned on, or all features available, or everything.
16388  
16389  =back
16390  
16391  =over 4
16392  
16393  =item @features = $self->list_features
16394  
16395  =back
16396  
16397  =over 4
16398  
16399  =item @features = $self->list_enabled_features
16400  
16401  =back
16402  
16403  =over 4
16404  
16405  =item @mods = $self->modules_for_feature( FEATURE [,AS_HASH] )
16406  
16407  =back
16408  
16409  =over 4
16410  
16411  =item @mods = $self->list_core_dependencies( [AS_HASH] )
16412  
16413  =back
16414  
16415  =over 4
16416  
16417  =item @mods = $self->list_core_modules( [AS_HASH] )
16418  
16419  =back
16420  
16421  =over 4
16422  
16423  =item CPANPLUS::Selfupdate::Module
16424  
16425  =back
16426  
16427  =over 4
16428  
16429  =item $version = $mod->version_required
16430  
16431  =back
16432  
16433  =over 4
16434  
16435  =item $bool = $mod->is_installed_version_sufficient
16436  
16437  =back
16438  
16439  =over 4
16440  
16441  =item BUG REPORTS
16442  
16443  =item AUTHOR
16444  
16445  =item COPYRIGHT
16446  
16447  =back
16448  
16449  =head2 CPANPLUShell, CPANPLUS::Shell
16450  
16451  =over 4
16452  
16453  =item SYNOPSIS
16454  
16455  =item DESCRIPTION
16456  
16457  =back
16458  
16459  =over 4
16460  
16461  =item BUG REPORTS
16462  
16463  =item AUTHOR
16464  
16465  =item COPYRIGHT
16466  
16467  =item SEE ALSO
16468  
16469  =back
16470  
16471  =head2 CPANPLUShell::Classic, CPANPLUS::Shell::Classic - CPAN.pm emulation
16472  for CPANPLUS
16473  
16474  =over 4
16475  
16476  =item DESCRIPTION
16477  
16478  =item BUG REPORTS
16479  
16480  =item AUTHOR
16481  
16482  =item COPYRIGHT
16483  
16484  =item SEE ALSO
16485  
16486  =back
16487  
16488  =over 4
16489  
16490  =item SEE ALSO
16491  
16492  =back
16493  
16494  =head2 CPANPLUShell::Default, CPANPLUS::Shell::Default
16495  
16496  =over 4
16497  
16498  =item SYNOPSIS
16499  
16500  =item DESCRIPTION
16501  
16502  =back
16503  
16504  =over 4
16505  
16506  =item BUG REPORTS
16507  
16508  =item AUTHOR
16509  
16510  =item COPYRIGHT
16511  
16512  =item SEE ALSO
16513  
16514  =back
16515  
16516  =head2 CPANPLUShell::Default::Plugins::CustomSource,
16517  CPANPLUS::Shell::Default::Plugins::CustomSource 
16518  
16519  =over 4
16520  
16521  =item SYNOPSIS
16522  
16523      ### elaborate help text
16524      CPAN Terminal> /? cs
16525  
16526  =item DESCRIPTION
16527  
16528  =back
16529  
16530  =head2 CPANPLUShell::Default::Plugins::HOWTO,
16531  CPANPLUS::Shell::Default::Plugins::HOWTO -- documentation on how to write
16532  your own plugins
16533  
16534  =over 4
16535  
16536  =item SYNOPSIS
16537  
16538  =item HOWTO
16539  
16540  =over 4
16541  
16542  =item Registering Plugin Modules
16543  
16544  =item Registering Plugin Commands
16545  
16546  =item Registering Plugin Help
16547  
16548  =item Arguments to Plugin Commands
16549  
16550  Classname -- The name of your plugin class, Shell     -- The
16551  CPANPLUS::Shell::Default object, Backend   -- The CPANPLUS::Backend object,
16552  Command   -- The command issued by the user, Input     -- The input string
16553  from the user, Options     -- A hashref of options provided by the user
16554  
16555  =back
16556  
16557  =item BUG REPORTS
16558  
16559  =item AUTHOR
16560  
16561  =item COPYRIGHT
16562  
16563  =item SEE ALSO
16564  
16565  =back
16566  
16567  =head2 CPANPLUShell::Default::Plugins::Remote,
16568  CPANPLUS::Shell::Default::Plugins::Remote
16569  
16570  =over 4
16571  
16572  =item SYNOPSIS
16573  
16574  =item DESCRIPTION
16575  
16576  =back
16577  
16578  =over 4
16579  
16580  =item BUG REPORTS
16581  
16582  =item AUTHOR
16583  
16584  =item COPYRIGHT
16585  
16586  =item SEE ALSO
16587  
16588  =back
16589  
16590  =head2 CPANPLUShell::Default::Plugins::Source,
16591  CPANPLUS::Shell::Default::Plugins::Source 
16592  
16593  =over 4
16594  
16595  =item SYNOPSIS
16596  
16597  =item DESCRIPTION
16598  
16599  =back
16600  
16601  =over 4
16602  
16603  =item BUG REPORTS
16604  
16605  =item AUTHOR
16606  
16607  =item COPYRIGHT
16608  
16609  =item SEE ALSO
16610  
16611  =back
16612  
16613  =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
16614  module
16615  
16616  =over 4
16617  
16618  =item SYNOPSIS
16619  
16620  =item DESCRIPTION
16621  
16622  =item LICENSE
16623  
16624  =item  SEE ALSO
16625  
16626  =back
16627  
16628  =head2 Carp, carp    - warn of errors (from perspective of caller)
16629  
16630  =over 4
16631  
16632  =item SYNOPSIS
16633  
16634  =item DESCRIPTION
16635  
16636  =over 4
16637  
16638  =item Forcing a Stack Trace
16639  
16640  =back
16641  
16642  =item GLOBAL VARIABLES
16643  
16644  =over 4
16645  
16646  =item $Carp::MaxEvalLen
16647  
16648  =item $Carp::MaxArgLen
16649  
16650  =item $Carp::MaxArgNums
16651  
16652  =item $Carp::Verbose
16653  
16654  =item %Carp::Internal
16655  
16656  =item %Carp::CarpInternal
16657  
16658  =item $Carp::CarpLevel
16659  
16660  =back
16661  
16662  =item BUGS
16663  
16664  =back
16665  
16666  =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
16667  
16668  =head2 Class::ISA -- report the search path for a class's ISA tree
16669  
16670  =over 4
16671  
16672  =item SYNOPSIS
16673  
16674  =item DESCRIPTION
16675  
16676  =item FUNCTIONS
16677  
16678  the function Class::ISA::super_path($CLASS), the function
16679  Class::ISA::self_and_super_path($CLASS), the function
16680  Class::ISA::self_and_super_versions($CLASS)
16681  
16682  =item CAUTIONARY NOTES
16683  
16684  =item COPYRIGHT
16685  
16686  =item AUTHOR
16687  
16688  =back
16689  
16690  =head2 Class::Struct - declare struct-like datatypes as Perl classes
16691  
16692  =over 4
16693  
16694  =item SYNOPSIS
16695  
16696  =item DESCRIPTION
16697  
16698  =over 4
16699  
16700  =item The C<struct()> function
16701  
16702  =item Class Creation at Compile Time
16703  
16704  =item Element Types and Accessor Methods
16705  
16706  Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
16707  C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
16708  
16709  =item Initializing with C<new>
16710  
16711  =back
16712  
16713  =item EXAMPLES
16714  
16715  Example 1, Example 2, Example 3
16716  
16717  =item Author and Modification History
16718  
16719  =back
16720  
16721  =head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression
16722  library
16723  
16724  =over 4
16725  
16726  =item SYNOPSIS
16727  
16728  =item DESCRIPTION
16729  
16730  =item Compress::Raw::Zlib::Deflate
16731  
16732  =over 4
16733  
16734  =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
16735  
16736  B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
16737  B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
16738  
16739  =item B<$status = $d-E<gt>deflate($input, $output)>
16740  
16741  =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
16742  
16743  =item B<$status = $d-E<gt>deflateParams([OPT])>
16744  
16745  B<-Level>, B<-Strategy>, B<-BufSize>
16746  
16747  =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
16748  $nice_length, $max_chain)>
16749  
16750  =item B<$d-E<gt>dict_adler()>
16751  
16752  =item B<$d-E<gt>crc32()>
16753  
16754  =item B<$d-E<gt>adler32()>
16755  
16756  =item B<$d-E<gt>msg()>
16757  
16758  =item B<$d-E<gt>total_in()>
16759  
16760  =item B<$d-E<gt>total_out()>
16761  
16762  =item B<$d-E<gt>get_Strategy()>
16763  
16764  =item B<$d-E<gt>get_Level()>
16765  
16766  =item B<$d-E<gt>get_BufSize()>
16767  
16768  =item Example
16769  
16770  =back
16771  
16772  =item Compress::Raw::Zlib::Inflate
16773  
16774  =over 4
16775  
16776  =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
16777  
16778  B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
16779  B<-ADLER32>, B<-ConsumeInput>
16780  
16781  =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
16782  
16783  =item B<$status = $i-E<gt>inflateSync($input)>
16784  
16785  =item B<$i-E<gt>dict_adler()>
16786  
16787  =item B<$i-E<gt>crc32()>
16788  
16789  =item B<$i-E<gt>adler32()>
16790  
16791  =item B<$i-E<gt>msg()>
16792  
16793  =item B<$i-E<gt>total_in()>
16794  
16795  =item B<$i-E<gt>total_out()>
16796  
16797  =item B<$d-E<gt>get_BufSize()>
16798  
16799  =item Example
16800  
16801  =back
16802  
16803  =item CHECKSUM FUNCTIONS
16804  
16805  =item ACCESSING ZIP FILES
16806  
16807  =item CONSTANTS
16808  
16809  =item SEE ALSO
16810  
16811  =item AUTHOR
16812  
16813  =item MODIFICATION HISTORY
16814  
16815  =item COPYRIGHT AND LICENSE
16816  
16817  =back
16818  
16819  =head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib -
16820  Low-Level Interface to zlib compression library
16821  
16822  =over 4
16823  
16824  =item SYNOPSIS
16825  
16826  =item DESCRIPTION
16827  
16828  =item Compress::Raw::Zlib::Deflate
16829  
16830  =over 4
16831  
16832  =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
16833  
16834  B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
16835  B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
16836  
16837  =item B<$status = $d-E<gt>deflate($input, $output)>
16838  
16839  =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
16840  
16841  =item B<$status = $d-E<gt>deflateParams([OPT])>
16842  
16843  B<-Level>, B<-Strategy>, B<-BufSize>
16844  
16845  =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
16846  $nice_length, $max_chain)>
16847  
16848  =item B<$d-E<gt>dict_adler()>
16849  
16850  =item B<$d-E<gt>crc32()>
16851  
16852  =item B<$d-E<gt>adler32()>
16853  
16854  =item B<$d-E<gt>msg()>
16855  
16856  =item B<$d-E<gt>total_in()>
16857  
16858  =item B<$d-E<gt>total_out()>
16859  
16860  =item B<$d-E<gt>get_Strategy()>
16861  
16862  =item B<$d-E<gt>get_Level()>
16863  
16864  =item B<$d-E<gt>get_BufSize()>
16865  
16866  =item Example
16867  
16868  =back
16869  
16870  =item Compress::Raw::Zlib::Inflate
16871  
16872  =over 4
16873  
16874  =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
16875  
16876  B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
16877  B<-ADLER32>, B<-ConsumeInput>
16878  
16879  =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
16880  
16881  =item B<$status = $i-E<gt>inflateSync($input)>
16882  
16883  =item B<$i-E<gt>dict_adler()>
16884  
16885  =item B<$i-E<gt>crc32()>
16886  
16887  =item B<$i-E<gt>adler32()>
16888  
16889  =item B<$i-E<gt>msg()>
16890  
16891  =item B<$i-E<gt>total_in()>
16892  
16893  =item B<$i-E<gt>total_out()>
16894  
16895  =item B<$d-E<gt>get_BufSize()>
16896  
16897  =item Example
16898  
16899  =back
16900  
16901  =item CHECKSUM FUNCTIONS
16902  
16903  =item ACCESSING ZIP FILES
16904  
16905  =item CONSTANTS
16906  
16907  =item SEE ALSO
16908  
16909  =item AUTHOR
16910  
16911  =item MODIFICATION HISTORY
16912  
16913  =item COPYRIGHT AND LICENSE
16914  
16915  =back
16916  
16917  =head2 Compress::Zlib - Interface to zlib compression library
16918  
16919  =over 4
16920  
16921  =item SYNOPSIS
16922  
16923  =item DESCRIPTION
16924  
16925  =over 4
16926  
16927  =item Notes for users of Compress::Zlib version 1
16928  
16929  =back
16930  
16931  =item GZIP INTERFACE
16932  
16933  B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
16934  B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
16935  $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
16936  ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
16937  $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
16938  B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
16939  B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
16940  
16941  =over 4
16942  
16943  =item Examples
16944  
16945  =item Compress::Zlib::memGzip
16946  
16947  =item Compress::Zlib::memGunzip
16948  
16949  =back
16950  
16951  =item COMPRESS/UNCOMPRESS
16952  
16953  B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
16954  ;>
16955  
16956  =item Deflate Interface
16957  
16958  =over 4
16959  
16960  =item B<($d, $status) = deflateInit( [OPT] )>
16961  
16962  B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
16963  B<-Dictionary>, B<-Bufsize>
16964  
16965  =item B<($out, $status) = $d-E<gt>deflate($buffer)>
16966  
16967  =item B<($out, $status) = $d-E<gt>flush([flush_type])>
16968  
16969  =item B<$status = $d-E<gt>deflateParams([OPT])>
16970  
16971  B<-Level>, B<-Strategy>
16972  
16973  =item B<$d-E<gt>dict_adler()>
16974  
16975  =item B<$d-E<gt>msg()>
16976  
16977  =item B<$d-E<gt>total_in()>
16978  
16979  =item B<$d-E<gt>total_out()>
16980  
16981  =item Example
16982  
16983  =back
16984  
16985  =item Inflate Interface
16986  
16987  =over 4
16988  
16989  =item B<($i, $status) = inflateInit()>
16990  
16991  B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
16992  
16993  =item B<($out, $status) = $i-E<gt>inflate($buffer)>
16994  
16995  =item B<$status = $i-E<gt>inflateSync($buffer)>
16996  
16997  =item B<$i-E<gt>dict_adler()>
16998  
16999  =item B<$i-E<gt>msg()>
17000  
17001  =item B<$i-E<gt>total_in()>
17002  
17003  =item B<$i-E<gt>total_out()>
17004  
17005  =item Example
17006  
17007  =back
17008  
17009  =item CHECKSUM FUNCTIONS
17010  
17011  =item CONSTANTS
17012  
17013  =item SEE ALSO
17014  
17015  =item AUTHOR
17016  
17017  =item MODIFICATION HISTORY
17018  
17019  =item COPYRIGHT AND LICENSE
17020  
17021  =back
17022  
17023  =head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib
17024  compression library
17025  
17026  =over 4
17027  
17028  =item SYNOPSIS
17029  
17030  =item DESCRIPTION
17031  
17032  =over 4
17033  
17034  =item Notes for users of Compress::Zlib version 1
17035  
17036  =back
17037  
17038  =item GZIP INTERFACE
17039  
17040  B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
17041  B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
17042  $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
17043  ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
17044  $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
17045  B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
17046  B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
17047  
17048  =over 4
17049  
17050  =item Examples
17051  
17052  =item Compress::Zlib::memGzip
17053  
17054  =item Compress::Zlib::memGunzip
17055  
17056  =back
17057  
17058  =item COMPRESS/UNCOMPRESS
17059  
17060  B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
17061  ;>
17062  
17063  =item Deflate Interface
17064  
17065  =over 4
17066  
17067  =item B<($d, $status) = deflateInit( [OPT] )>
17068  
17069  B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
17070  B<-Dictionary>, B<-Bufsize>
17071  
17072  =item B<($out, $status) = $d-E<gt>deflate($buffer)>
17073  
17074  =item B<($out, $status) = $d-E<gt>flush([flush_type])>
17075  
17076  =item B<$status = $d-E<gt>deflateParams([OPT])>
17077  
17078  B<-Level>, B<-Strategy>
17079  
17080  =item B<$d-E<gt>dict_adler()>
17081  
17082  =item B<$d-E<gt>msg()>
17083  
17084  =item B<$d-E<gt>total_in()>
17085  
17086  =item B<$d-E<gt>total_out()>
17087  
17088  =item Example
17089  
17090  =back
17091  
17092  =item Inflate Interface
17093  
17094  =over 4
17095  
17096  =item B<($i, $status) = inflateInit()>
17097  
17098  B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
17099  
17100  =item B<($out, $status) = $i-E<gt>inflate($buffer)>
17101  
17102  =item B<$status = $i-E<gt>inflateSync($buffer)>
17103  
17104  =item B<$i-E<gt>dict_adler()>
17105  
17106  =item B<$i-E<gt>msg()>
17107  
17108  =item B<$i-E<gt>total_in()>
17109  
17110  =item B<$i-E<gt>total_out()>
17111  
17112  =item Example
17113  
17114  =back
17115  
17116  =item CHECKSUM FUNCTIONS
17117  
17118  =item CONSTANTS
17119  
17120  =item SEE ALSO
17121  
17122  =item AUTHOR
17123  
17124  =item MODIFICATION HISTORY
17125  
17126  =item COPYRIGHT AND LICENSE
17127  
17128  =back
17129  
17130  =head2 Config - access Perl configuration information
17131  
17132  =over 4
17133  
17134  =item SYNOPSIS
17135  
17136  =item DESCRIPTION
17137  
17138  myconfig(), config_sh(), config_re($regex), config_vars(@names)
17139  
17140  =item EXAMPLE
17141  
17142  =item WARNING
17143  
17144  =item GLOSSARY
17145  
17146  =over 4
17147  
17148  =item _
17149  
17150  C<_a>, C<_exe>, C<_o>
17151  
17152  =item a
17153  
17154  C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
17155  C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
17156  C<ar>, C<archlib>, C<archlibexp>, C<archname>, C<archname64>, C<archobjs>,
17157  C<asctime_r_proto>, C<awk>
17158  
17159  =item b
17160  
17161  C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
17162  
17163  =item c
17164  
17165  C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
17166  C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
17167  C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>, C<chown>, C<clocktype>,
17168  C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
17169  C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
17170  C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, C<csh>,
17171  C<ctermid_r_proto>, C<ctime_r_proto>
17172  
17173  =item d
17174  
17175  C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
17176  C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
17177  C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
17178  C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
17179  C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
17180  C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_builtin_choose_expr>,
17181  C<d_builtin_expect>, C<d_bzero>, C<d_c99_variadic_macros>, C<d_casti32>,
17182  C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>,
17183  C<d_class>, C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
17184  C<d_copysignl>, C<d_cplusplus>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
17185  C<d_ctermid>, C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
17186  C<d_dbminitproto>, C<d_difftime>, C<d_dir_dd_fd>, C<d_dirfd>,
17187  C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
17188  C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
17189  C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
17190  C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
17191  C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
17192  C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
17193  C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
17194  C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
17195  C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
17196  C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
17197  C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
17198  C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>,
17199  C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
17200  C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
17201  C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
17202  C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
17203  C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
17204  C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
17205  C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
17206  C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
17207  C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, C<d_getppid>,
17208  C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
17209  C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
17210  C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
17211  C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
17212  C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
17213  C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
17214  C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>,
17215  C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>,
17216  C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
17217  C<d_libm_lib_version>, C<d_link>, C<d_localtime_r>,
17218  C<d_localtime_r_needs_tzset>, C<d_locconv>, C<d_lockf>, C<d_longdbl>,
17219  C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
17220  C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>, C<d_mbstowcs>,
17221  C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
17222  C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
17223  C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>,
17224  C<d_modflproto>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
17225  C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
17226  C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
17227  C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
17228  C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, C<d_off64_t>,
17229  C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
17230  C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
17231  C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
17232  C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
17233  C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_printf_format_null>,
17234  C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
17235  C<d_pseudofork>, C<d_pthread_atfork>, C<d_pthread_attr_setscope>,
17236  C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
17237  C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
17238  C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir>, C<d_readdir64_r>,
17239  C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
17240  C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
17241  C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>,
17242  C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
17243  C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
17244  C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
17245  C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
17246  C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
17247  C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp>, C<d_setpgrp2>,
17248  C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
17249  C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
17250  C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
17251  C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
17252  C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
17253  C<d_signbit>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sitearch>,
17254  C<d_snprintf>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
17255  C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>,
17256  C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
17257  C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
17258  C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
17259  C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
17260  C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
17261  C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
17262  C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
17263  C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
17264  C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
17265  C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
17266  C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
17267  C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
17268  C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
17269  C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
17270  C<d_unordered>, C<d_unsetenv>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>,
17271  C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>,
17272  C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
17273  C<d_vprintf>, C<d_vsnprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
17274  C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
17275  C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
17276  C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
17277  C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
17278  
17279  =item e
17280  
17281  C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
17282  C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
17283  C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
17284  C<expr>, C<extensions>, C<extras>
17285  
17286  =item f
17287  
17288  C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
17289  C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
17290  C<full_sed>
17291  
17292  =item g
17293  
17294  C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
17295  C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
17296  C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
17297  C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
17298  C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
17299  C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
17300  C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
17301  C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
17302  C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
17303  C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
17304  
17305  =item h
17306  
17307  C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
17308  C<html3dir>, C<html3direxp>
17309  
17310  =item i
17311  
17312  C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
17313  C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
17314  C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
17315  C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
17316  C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
17317  C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
17318  C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
17319  C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
17320  C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
17321  C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
17322  C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
17323  C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
17324  C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
17325  C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
17326  C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
17327  C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
17328  C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
17329  C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
17330  C<incpath>, C<inews>, C<initialinstalllocation>, C<installarchlib>,
17331  C<installbin>, C<installhtml1dir>, C<installhtml3dir>, C<installman1dir>,
17332  C<installman3dir>, C<installprefix>, C<installprefixexp>,
17333  C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
17334  C<installsitehtml1dir>, C<installsitehtml3dir>, C<installsitelib>,
17335  C<installsiteman1dir>, C<installsiteman3dir>, C<installsitescript>,
17336  C<installstyle>, C<installusrbinperl>, C<installvendorarch>,
17337  C<installvendorbin>, C<installvendorhtml1dir>, C<installvendorhtml3dir>,
17338  C<installvendorlib>, C<installvendorman1dir>, C<installvendorman3dir>,
17339  C<installvendorscript>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
17340  C<ivtype>
17341  
17342  =item k
17343  
17344  C<known_extensions>, C<ksh>
17345  
17346  =item l
17347  
17348  C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
17349  C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
17350  C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
17351  C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
17352  C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
17353  C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
17354  C<lseektype>
17355  
17356  =item m
17357  
17358  C<mad>, C<madlyh>, C<madlyobj>, C<madlysrc>, C<mail>, C<mailx>, C<make>,
17359  C<make_set_make>, C<mallocobj>, C<mallocsrc>, C<malloctype>, C<man1dir>,
17360  C<man1direxp>, C<man1ext>, C<man3dir>, C<man3direxp>, C<man3ext>
17361  
17362  =item M
17363  
17364  C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
17365  C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
17366  C<myuname>
17367  
17368  =item n
17369  
17370  C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
17371  C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
17372  C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
17373  C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
17374  C<nvsize>, C<nvtype>
17375  
17376  =item o
17377  
17378  C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
17379  C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
17380  
17381  =item p
17382  
17383  C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
17384  C<perl5>
17385  
17386  =item P
17387  
17388  C<PERL_API_REVISION>, C<PERL_API_SUBVERSION>, C<PERL_API_VERSION>,
17389  C<PERL_CONFIG_SH>, C<PERL_PATCHLEVEL>, C<perl_patchlevel>,
17390  C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
17391  C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
17392  C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
17393  C<procselfexe>, C<prototype>, C<ptrsize>
17394  
17395  =item q
17396  
17397  C<quadkind>, C<quadtype>
17398  
17399  =item r
17400  
17401  C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
17402  C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
17403  C<rm_try>, C<rmail>, C<run>, C<runnm>
17404  
17405  =item s
17406  
17407  C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
17408  C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
17409  C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
17410  C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
17411  C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
17412  C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
17413  C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
17414  C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
17415  C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
17416  C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
17417  C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
17418  C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
17419  C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
17420  C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
17421  C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
17422  C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
17423  C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
17424  C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
17425  C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
17426  C<submit>, C<subversion>, C<sysman>
17427  
17428  =item t
17429  
17430  C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
17431  C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
17432  C<ttyname_r_proto>
17433  
17434  =item u
17435  
17436  C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
17437  C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
17438  C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
17439  C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
17440  C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
17441  C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
17442  C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
17443  C<usesfio>, C<useshrplib>, C<usesitecustomize>, C<usesocks>, C<usethreads>,
17444  C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
17445  C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
17446  
17447  =item v
17448  
17449  C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
17450  C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
17451  C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
17452  C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
17453  C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
17454  C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
17455  C<versiononly>, C<vi>, C<voidflags>
17456  
17457  =item x
17458  
17459  C<xlibpth>
17460  
17461  =item y
17462  
17463  C<yacc>, C<yaccflags>
17464  
17465  =item z
17466  
17467  C<zcat>, C<zip>
17468  
17469  =back
17470  
17471  =item NOTE
17472  
17473  =back
17474  
17475  =over 4
17476  
17477  =item SYNOPSIS
17478  
17479  =item DESCRIPTION
17480  
17481  dynamic, nonxs, static
17482  
17483  =item AUTHOR
17484  
17485  =back
17486  
17487  =head2 Cwd - get pathname of current working directory
17488  
17489  =over 4
17490  
17491  =item SYNOPSIS
17492  
17493  =item DESCRIPTION
17494  
17495  =over 4
17496  
17497  =item getcwd and friends
17498  
17499  getcwd, cwd, fastcwd, fastgetcwd, getdcwd
17500  
17501  =item abs_path and friends
17502  
17503  abs_path, realpath, fast_abs_path
17504  
17505  =item $ENV{PWD}
17506  
17507  =back
17508  
17509  =item NOTES
17510  
17511  =item AUTHOR
17512  
17513  =item COPYRIGHT
17514  
17515  =item SEE ALSO
17516  
17517  =back
17518  
17519  =head2 DB - programmatic interface to the Perl debugging API
17520  
17521  =over 4
17522  
17523  =item SYNOPSIS
17524  
17525  =item DESCRIPTION
17526  
17527  =over 4
17528  
17529  =item Global Variables
17530  
17531   $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,    @DB::args, 
17532  @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
17533  $DB::lineno
17534  
17535  =item API Methods
17536  
17537  CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
17538  CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
17539  
17540  =item Client Callback Methods
17541  
17542  CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
17543  CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
17544  CLIENT->output(LIST)
17545  
17546  =back
17547  
17548  =item BUGS
17549  
17550  =item AUTHOR
17551  
17552  =back
17553  
17554  =head2 DBM_Filter -- Filter DBM keys/values 
17555  
17556  =over 4
17557  
17558  =item SYNOPSIS
17559  
17560  =item DESCRIPTION
17561  
17562  =item What is a DBM Filter?
17563  
17564  =over 4
17565  
17566  =item So what's new?
17567  
17568  =back
17569  
17570  =item METHODS
17571  
17572  =over 4
17573  
17574  =item $db->Filter_Push()
17575  
17576  =item $db->Filter_Key_Push()
17577  
17578  =item $db->Filter_Value_Push()
17579  
17580  Filter_Push, Filter_Key_Push, Filter_Value_Push
17581  
17582  =item $db->Filter_Pop()
17583  
17584  =item $db->Filtered()
17585  
17586  =back
17587  
17588  =item Writing a Filter
17589  
17590  =over 4
17591  
17592  =item Immediate Filters
17593  
17594  =item Canned Filters
17595  
17596  "name", params
17597  
17598  =back
17599  
17600  =item Filters Included
17601  
17602  utf8, encode, compress, int32, null
17603  
17604  =item NOTES
17605  
17606  =over 4
17607  
17608  =item Maintain Round Trip Integrity
17609  
17610  =item Don't mix filtered & non-filtered data in the same database file. 
17611  
17612  =back
17613  
17614  =item EXAMPLE
17615  
17616  =item SEE ALSO
17617  
17618  =item AUTHOR
17619  
17620  =back
17621  
17622  =head2 DBM_Filter::compress - filter for DBM_Filter
17623  
17624  =over 4
17625  
17626  =item SYNOPSIS
17627  
17628  =item DESCRIPTION
17629  
17630  =item SEE ALSO
17631  
17632  =item AUTHOR
17633  
17634  =back
17635  
17636  =head2 DBM_Filter::encode - filter for DBM_Filter
17637  
17638  =over 4
17639  
17640  =item SYNOPSIS
17641  
17642  =item DESCRIPTION
17643  
17644  =item SEE ALSO
17645  
17646  =item AUTHOR
17647  
17648  =back
17649  
17650  =head2 DBM_Filter::int32 - filter for DBM_Filter
17651  
17652  =over 4
17653  
17654  =item SYNOPSIS
17655  
17656  =item DESCRIPTION
17657  
17658  =item SEE ALSO
17659  
17660  =item AUTHOR
17661  
17662  =back
17663  
17664  =head2 DBM_Filter::null - filter for DBM_Filter
17665  
17666  =over 4
17667  
17668  =item SYNOPSIS
17669  
17670  =item DESCRIPTION
17671  
17672  =item SEE ALSO
17673  
17674  =item AUTHOR
17675  
17676  =back
17677  
17678  =head2 DBM_Filter::utf8 - filter for DBM_Filter
17679  
17680  =over 4
17681  
17682  =item SYNOPSIS
17683  
17684  =item DESCRIPTION
17685  
17686  =item SEE ALSO
17687  
17688  =item AUTHOR
17689  
17690  =back
17691  
17692  =head2 DB_File - Perl5 access to Berkeley DB version 1.x
17693  
17694  =over 4
17695  
17696  =item SYNOPSIS
17697  
17698  =item DESCRIPTION
17699  
17700  B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
17701  
17702  =over 4
17703  
17704  =item Using DB_File with Berkeley DB version 2 or greater
17705  
17706  =item Interface to Berkeley DB
17707  
17708  =item Opening a Berkeley DB Database File
17709  
17710  =item Default Parameters
17711  
17712  =item In Memory Databases
17713  
17714  =back
17715  
17716  =item DB_HASH
17717  
17718  =over 4
17719  
17720  =item A Simple Example
17721  
17722  =back
17723  
17724  =item DB_BTREE
17725  
17726  =over 4
17727  
17728  =item Changing the BTREE sort order
17729  
17730  =item Handling Duplicate Keys 
17731  
17732  =item The get_dup() Method
17733  
17734  =item The find_dup() Method
17735  
17736  =item The del_dup() Method
17737  
17738  =item Matching Partial Keys 
17739  
17740  =back
17741  
17742  =item DB_RECNO
17743  
17744  =over 4
17745  
17746  =item The 'bval' Option
17747  
17748  =item A Simple Example
17749  
17750  =item Extra RECNO Methods
17751  
17752  B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
17753  B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
17754  length, elements);>
17755  
17756  =item Another Example
17757  
17758  =back
17759  
17760  =item THE API INTERFACE
17761  
17762  B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
17763  $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
17764  $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
17765  $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
17766  
17767  =item DBM FILTERS
17768  
17769  B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
17770  B<filter_fetch_value>
17771  
17772  =over 4
17773  
17774  =item The Filter
17775  
17776  =item An Example -- the NULL termination problem.
17777  
17778  =item Another Example -- Key is a C int.
17779  
17780  =back
17781  
17782  =item HINTS AND TIPS 
17783  
17784  =over 4
17785  
17786  =item Locking: The Trouble with fd
17787  
17788  =item Safe ways to lock a database
17789  
17790  B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
17791  
17792  =item Sharing Databases With C Applications
17793  
17794  =item The untie() Gotcha
17795  
17796  =back
17797  
17798  =item COMMON QUESTIONS
17799  
17800  =over 4
17801  
17802  =item Why is there Perl source in my database?
17803  
17804  =item How do I store complex data structures with DB_File?
17805  
17806  =item What does "Invalid Argument" mean?
17807  
17808  =item What does "Bareword 'DB_File' not allowed" mean? 
17809  
17810  =back
17811  
17812  =item REFERENCES
17813  
17814  =item HISTORY
17815  
17816  =item BUGS
17817  
17818  =item AVAILABILITY
17819  
17820  =item COPYRIGHT
17821  
17822  =item SEE ALSO
17823  
17824  =item AUTHOR
17825  
17826  =back
17827  
17828  =head2 Data::Dumper - stringified perl data structures, suitable for both
17829  printing and C<eval>
17830  
17831  =over 4
17832  
17833  =item SYNOPSIS
17834  
17835  =item DESCRIPTION
17836  
17837  =over 4
17838  
17839  =item Methods
17840  
17841  I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
17842  I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
17843  I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
17844  I<$OBJ>->Reset
17845  
17846  =item Functions
17847  
17848  Dumper(I<LIST>)
17849  
17850  =item Configuration Variables or Methods
17851  
17852  =item Exports
17853  
17854  Dumper
17855  
17856  =back
17857  
17858  =item EXAMPLES
17859  
17860  =item BUGS
17861  
17862  =over 4
17863  
17864  =item NOTE
17865  
17866  =back
17867  
17868  =item AUTHOR
17869  
17870  =item VERSION
17871  
17872  =item SEE ALSO
17873  
17874  =back
17875  
17876  =head2 Devel::DProf - a Perl code profiler
17877  
17878  =over 4
17879  
17880  =item SYNOPSIS
17881  
17882  =item DESCRIPTION
17883  
17884  =item PROFILE FORMAT
17885  
17886  =item AUTOLOAD
17887  
17888  =item ENVIRONMENT
17889  
17890  =item BUGS
17891  
17892  =item SEE ALSO
17893  
17894  =back
17895  
17896  =head2 Devel::InnerPackage - find all the inner packages of a package
17897  
17898  =over 4
17899  
17900  =item SYNOPSIS
17901  
17902  =item DESCRIPTION
17903  
17904  =item METHODS
17905  
17906  =over 4
17907  
17908  =item list_packages <package name>
17909  
17910  =back
17911  
17912  =back
17913  
17914  =over 4
17915  
17916  =item AUTHOR
17917  
17918  =item COPYING
17919  
17920  =item BUGS
17921  
17922  =back
17923  
17924  =head2 Devel::PPPort - Perl/Pollution/Portability
17925  
17926  =over 4
17927  
17928  =item SYNOPSIS
17929  
17930  =item DESCRIPTION
17931  
17932  =over 4
17933  
17934  =item Why use ppport.h?
17935  
17936  =item How to use ppport.h
17937  
17938  =item Running ppport.h
17939  
17940  =back
17941  
17942  =item FUNCTIONS
17943  
17944  =over 4
17945  
17946  =item WriteFile
17947  
17948  =back
17949  
17950  =item COMPATIBILITY
17951  
17952  =over 4
17953  
17954  =item Provided Perl compatibility API
17955  
17956  =item Perl API not supported by ppport.h
17957  
17958  perl 5.9.5, perl 5.9.4, perl 5.9.3, perl 5.9.2, perl 5.9.1, perl 5.9.0,
17959  perl 5.8.3, perl 5.8.1, perl 5.8.0, perl 5.7.3, perl 5.7.2, perl 5.7.1,
17960  perl 5.6.1, perl 5.6.0, perl 5.005_03, perl 5.005, perl 5.004_05, perl
17961  5.004
17962  
17963  =back
17964  
17965  =item BUGS
17966  
17967  =item AUTHORS
17968  
17969  =item COPYRIGHT
17970  
17971  =item SEE ALSO
17972  
17973  =back
17974  
17975  =head2 Devel::Peek - A data debugging tool for the XS programmer
17976  
17977  =over 4
17978  
17979  =item SYNOPSIS
17980  
17981  =item DESCRIPTION
17982  
17983  =over 4
17984  
17985  =item Runtime debugging
17986  
17987  =item Memory footprint debugging
17988  
17989  =back
17990  
17991  =item EXAMPLES
17992  
17993  =over 4
17994  
17995  =item A simple scalar string
17996  
17997  =item A simple scalar number
17998  
17999  =item A simple scalar with an extra reference
18000  
18001  =item A reference to a simple scalar
18002  
18003  =item A reference to an array
18004  
18005  =item A reference to a hash
18006  
18007  =item Dumping a large array or hash
18008  
18009  =item A reference to an SV which holds a C pointer
18010  
18011  =item A reference to a subroutine
18012  
18013  =back
18014  
18015  =item EXPORTS
18016  
18017  =item BUGS
18018  
18019  =item AUTHOR
18020  
18021  =item SEE ALSO
18022  
18023  =back
18024  
18025  =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
18026  
18027  =over 4
18028  
18029  =item SYNOPSIS
18030  
18031  =item DESCRIPTION
18032  
18033  =back
18034  
18035  =head2 Digest - Modules that calculate message digests
18036  
18037  =over 4
18038  
18039  =item SYNOPSIS
18040  
18041  =item DESCRIPTION
18042  
18043  I<binary>, I<hex>, I<base64>
18044  
18045  =item OO INTERFACE
18046  
18047  $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
18048  Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
18049  $ctx->add( $data ), $ctx->add( $chunk1, $chunk2, ... ), $ctx->addfile(
18050  $io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring
18051  ), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
18052  
18053  =item Digest speed
18054  
18055  =item SEE ALSO
18056  
18057  =item AUTHOR
18058  
18059  =back
18060  
18061  =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
18062  
18063  =over 4
18064  
18065  =item SYNOPSIS
18066  
18067  =item DESCRIPTION
18068  
18069  =item FUNCTIONS
18070  
18071  md5($data,...), md5_hex($data,...), md5_base64($data,...)
18072  
18073  =item METHODS
18074  
18075  $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
18076  $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
18077  $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
18078  
18079  =item EXAMPLES
18080  
18081  =item SEE ALSO
18082  
18083  =item COPYRIGHT
18084  
18085  =item AUTHORS
18086  
18087  =back
18088  
18089  =head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512
18090  
18091  =over 4
18092  
18093  =item SYNOPSIS
18094  
18095  =item SYNOPSIS (HMAC-SHA)
18096  
18097  =item ABSTRACT
18098  
18099  =item DESCRIPTION
18100  
18101  =item NIST STATEMENT ON SHA-1
18102  
18103  =item PADDING OF BASE64 DIGESTS
18104  
18105  =item EXPORT
18106  
18107  =item EXPORTABLE FUNCTIONS
18108  
18109  B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
18110  B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
18111  B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
18112  ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
18113  B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
18114  B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
18115  B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
18116  B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
18117  B<addfile($filename [, $mode])>, B<dump($filename)>, B<load($filename)>,
18118  B<digest>, B<hexdigest>, B<b64digest>, B<hmac_sha1($data, $key)>,
18119  B<hmac_sha224($data, $key)>, B<hmac_sha256($data, $key)>,
18120  B<hmac_sha384($data, $key)>, B<hmac_sha512($data, $key)>,
18121  B<hmac_sha1_hex($data, $key)>, B<hmac_sha224_hex($data, $key)>,
18122  B<hmac_sha256_hex($data, $key)>, B<hmac_sha384_hex($data, $key)>,
18123  B<hmac_sha512_hex($data, $key)>, B<hmac_sha1_base64($data, $key)>,
18124  B<hmac_sha224_base64($data, $key)>, B<hmac_sha256_base64($data, $key)>,
18125  B<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)>
18126  
18127  =item SEE ALSO
18128  
18129  =item AUTHOR
18130  
18131  =item ACKNOWLEDGMENTS
18132  
18133  =item COPYRIGHT AND LICENSE
18134  
18135  =back
18136  
18137  =head2 Digest::base - Digest base class
18138  
18139  =over 4
18140  
18141  =item SYNOPSIS
18142  
18143  =item DESCRIPTION
18144  
18145  =item SEE ALSO
18146  
18147  =back
18148  
18149  =head2 Digest::file - Calculate digests of files
18150  
18151  =over 4
18152  
18153  =item SYNOPSIS
18154  
18155  =item DESCRIPTION
18156  
18157  digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
18158  $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
18159  )
18160  
18161  =item SEE ALSO
18162  
18163  =back
18164  
18165  =head2 DirHandle - supply object methods for directory handles
18166  
18167  =over 4
18168  
18169  =item SYNOPSIS
18170  
18171  =item DESCRIPTION
18172  
18173  =item NOTES
18174  
18175  =back
18176  
18177  =head2 Dumpvalue - provides screen dump of Perl data.
18178  
18179  =over 4
18180  
18181  =item SYNOPSIS
18182  
18183  =item DESCRIPTION
18184  
18185  =over 4
18186  
18187  =item Creation
18188  
18189  C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
18190  C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
18191  C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
18192  stopDbSignal
18193  
18194  =item Methods
18195  
18196  dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
18197  compactDump, veryCompact, set, get
18198  
18199  =back
18200  
18201  =back
18202  
18203  =head2 DynaLoader - Dynamically load C libraries into Perl code
18204  
18205  =over 4
18206  
18207  =item SYNOPSIS
18208  
18209  =item DESCRIPTION
18210  
18211  @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
18212  @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
18213  dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
18214  dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
18215  dl_install_xsub(), bootstrap()
18216  
18217  =item AUTHOR
18218  
18219  =back
18220  
18221  =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
18222  Perl code
18223  
18224  =over 4
18225  
18226  =item VERSION
18227  
18228  =item SYNOPSIS
18229  
18230  =item DESCRIPTION
18231  
18232  =over 4
18233  
18234  =item Migration from C<DynaLoader>
18235  
18236  =item Backward compatible boilerplate
18237  
18238  =back
18239  
18240  =item Order of initialization: early load()
18241  
18242  =over 4
18243  
18244  =item The most hairy case
18245  
18246  =back
18247  
18248  =item DIAGNOSTICS
18249  
18250  C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
18251  C<Undefined symbols present after loading %s: %s>,
18252  C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
18253  
18254  =item LIMITATIONS
18255  
18256  =item BUGS
18257  
18258  =item SEE ALSO
18259  
18260  =item AUTHORS
18261  
18262  =item COPYRIGHT
18263  
18264  =back
18265  
18266  =head2 Encode - character encodings
18267  
18268  =over 4
18269  
18270  =item SYNOPSIS
18271  
18272  =over 4
18273  
18274  =item Table of Contents
18275  
18276  =back
18277  
18278  =item DESCRIPTION
18279  
18280  =over 4
18281  
18282  =item TERMINOLOGY
18283  
18284  =back
18285  
18286  =item PERL ENCODING API
18287  
18288  $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
18289  $octets [, CHECK]), [$obj =] find_encoding(ENCODING), [$length =]
18290  from_to($octets, FROM_ENC, TO_ENC [, CHECK]), $octets =
18291  encode_utf8($string);, $string = decode_utf8($octets [, CHECK]);
18292  
18293  =over 4
18294  
18295  =item Listing available encodings
18296  
18297  =item Defining Aliases
18298  
18299  =item Finding IANA Character Set Registry names
18300  
18301  =back
18302  
18303  =item Encoding via PerlIO
18304  
18305  =item Handling Malformed Data
18306  
18307  B<NOTE:> Not all encoding support this feature, I<CHECK> =
18308  Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
18309  Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
18310  Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
18311  charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask,
18312  Encode::LEAVE_SRC
18313  
18314  =item Defining Encodings
18315  
18316  =item The UTF8 flag
18317  
18318  Goal #1:, Goal #2:, Goal #3:, Goal #4:
18319  
18320  =over 4
18321  
18322  =item Messing with Perl's Internals
18323  
18324  is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
18325  
18326  =back
18327  
18328  =item UTF-8 vs. utf8 vs. UTF8
18329  
18330  =item SEE ALSO
18331  
18332  =item MAINTAINER
18333  
18334  =item COPYRIGHT
18335  
18336  =back
18337  
18338  =head2 Encode::Alias - alias definitions to encodings
18339  
18340  =over 4
18341  
18342  =item SYNOPSIS
18343  
18344  =item DESCRIPTION
18345  
18346  As a simple string, As a qr// compiled regular expression, e.g.:, As a code
18347  reference, e.g.:
18348  
18349  =over 4
18350  
18351  =item Alias overloading
18352  
18353  =back
18354  
18355  =item SEE ALSO
18356  
18357  =back
18358  
18359  =head2 Encode::Byte - Single Byte Encodings
18360  
18361  =over 4
18362  
18363  =item SYNOPSIS
18364  
18365  =item ABSTRACT
18366  
18367  =item DESCRIPTION
18368  
18369  =item SEE ALSO
18370  
18371  =back
18372  
18373  =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
18374  
18375  =head2 Encode::CN - China-based Chinese Encodings
18376  
18377  =over 4
18378  
18379  =item SYNOPSIS
18380  
18381  =item DESCRIPTION
18382  
18383  =item NOTES
18384  
18385  =item BUGS
18386  
18387  =item SEE ALSO
18388  
18389  =back
18390  
18391  =head2 Encode::CN::HZ -- internally used by Encode::CN
18392  
18393  =head2 Encode::Config -- internally used by Encode
18394  
18395  =head2 Encode::EBCDIC - EBCDIC Encodings
18396  
18397  =over 4
18398  
18399  =item SYNOPSIS
18400  
18401  =item ABSTRACT
18402  
18403  =item DESCRIPTION
18404  
18405  =item SEE ALSO
18406  
18407  =back
18408  
18409  =head2 Encode::Encoding - Encode Implementation Base Class
18410  
18411  =over 4
18412  
18413  =item SYNOPSIS
18414  
18415  =item DESCRIPTION
18416  
18417  =over 4
18418  
18419  =item Methods you should implement
18420  
18421  -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
18422  -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
18423  
18424  =item Other methods defined in Encode::Encodings
18425  
18426  -E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
18427  -E<gt>needs_lines()
18428  
18429  =item Example: Encode::ROT13
18430  
18431  =back
18432  
18433  =item Why the heck Encode API is different?
18434  
18435  =over 4
18436  
18437  =item Compiled Encodings
18438  
18439  =back
18440  
18441  =item SEE ALSO
18442  
18443  Scheme 1, Scheme 2, Other Schemes
18444  
18445  =back
18446  
18447  =head2 Encode::GSM0338 -- ESTI GSM 03.38 Encoding
18448  
18449  =over 4
18450  
18451  =item SYNOPSIS
18452  
18453  =item DESCRIPTION
18454  
18455  =item NOTES
18456  
18457  =item BUGS
18458  
18459  =item SEE ALSO
18460  
18461  =back
18462  
18463  =head2 Encode::Guess -- Guesses encoding from data
18464  
18465  =over 4
18466  
18467  =item SYNOPSIS
18468  
18469  =item ABSTRACT
18470  
18471  =item DESCRIPTION
18472  
18473  Encode::Guess->set_suspects, Encode::Guess->add_suspects,
18474  Encode::decode("Guess" ...), Encode::Guess->guess($data),
18475  guess_encoding($data, [, I<list of suspects>])
18476  
18477  =item CAVEATS
18478  
18479  =item TO DO
18480  
18481  =item SEE ALSO
18482  
18483  =back
18484  
18485  =head2 Encode::JP - Japanese Encodings
18486  
18487  =over 4
18488  
18489  =item SYNOPSIS
18490  
18491  =item ABSTRACT
18492  
18493  =item DESCRIPTION
18494  
18495  =item Note on ISO-2022-JP(-1)?
18496  
18497  =item BUGS
18498  
18499  =item SEE ALSO
18500  
18501  =back
18502  
18503  =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
18504  
18505  =head2 Encode::JP::JIS7 -- internally used by Encode::JP
18506  
18507  =head2 Encode::KR - Korean Encodings
18508  
18509  =over 4
18510  
18511  =item SYNOPSIS
18512  
18513  =item DESCRIPTION
18514  
18515  =item BUGS
18516  
18517  =item SEE ALSO
18518  
18519  =back
18520  
18521  =head2 Encode::KR::2022_KR -- internally used by Encode::KR
18522  
18523  =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
18524  
18525  =over 4
18526  
18527  =item SYNOPSIS
18528  
18529  =item ABSTRACT
18530  
18531  =item DESCRIPTION
18532  
18533  =item BUGS
18534  
18535  =item SEE ALSO
18536  
18537  =back
18538  
18539  =head2 Encode::MIME::Name, Encode::MIME::NAME -- internally used by Encode
18540  
18541  =over 4
18542  
18543  =item SEE ALSO
18544  
18545  =back
18546  
18547  =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
18548  
18549  =over 4
18550  
18551  =item Overview
18552  
18553  =item How does it work?
18554  
18555  =item Line Buffering
18556  
18557  =over 4
18558  
18559  =item How can I tell whether my encoding fully supports PerlIO ?
18560  
18561  =back
18562  
18563  =item SEE ALSO
18564  
18565  =back
18566  
18567  =head2 Encode::Supported -- Encodings supported by Encode
18568  
18569  =over 4
18570  
18571  =item DESCRIPTION
18572  
18573  =over 4
18574  
18575  =item Encoding Names
18576  
18577  =back
18578  
18579  =item Supported Encodings
18580  
18581  =over 4
18582  
18583  =item Built-in Encodings
18584  
18585  =item Encode::Unicode -- other Unicode encodings
18586  
18587  =item Encode::Byte -- Extended ASCII
18588  
18589  ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
18590  the Cyrillic world
18591  
18592  =item gsm0338 - Hentai Latin 1
18593  
18594  gsm0338 support before 2.19
18595  
18596  =item CJK: Chinese, Japanese, Korean (Multibyte)
18597  
18598  Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
18599  Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
18600  Encode::JIS2K -- JIS X 0213 encodings via CPAN
18601  
18602  =item Miscellaneous encodings
18603  
18604  Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
18605  
18606  =back
18607  
18608  =item Unsupported encodings
18609  
18610    ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
18611  Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
18612  System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
18613  Various Mac encodings, (Mac) Indic encodings
18614  
18615  =item Encoding vs. Charset -- terminology
18616  
18617  =item Encoding Classification (by Anton Tagunov and Dan Kogai)
18618  
18619  =over 4
18620  
18621  =item Microsoft-related naming mess
18622  
18623  KS_C_5601-1987, GB2312, Big5, Shift_JIS
18624  
18625  =back
18626  
18627  =item Glossary
18628  
18629  character repertoire, coded character set (CCS), character encoding scheme
18630  (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
18631  UTF-16
18632  
18633  =item See Also
18634  
18635  =item References
18636  
18637  ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
18638  RFC, UC, Unicode Glossary
18639  
18640  =over 4
18641  
18642  =item Other Notable Sites
18643  
18644  czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
18645  "Introduction to i18n"
18646  
18647  =item Offline sources
18648  
18649  C<CJKV Information Processing> by Ken Lunde
18650  
18651  =back
18652  
18653  =back
18654  
18655  =head2 Encode::Symbol - Symbol Encodings
18656  
18657  =over 4
18658  
18659  =item SYNOPSIS
18660  
18661  =item ABSTRACT
18662  
18663  =item DESCRIPTION
18664  
18665  =item SEE ALSO
18666  
18667  =back
18668  
18669  =head2 Encode::TW - Taiwan-based Chinese Encodings
18670  
18671  =over 4
18672  
18673  =item SYNOPSIS
18674  
18675  =item DESCRIPTION
18676  
18677  =item NOTES
18678  
18679  =item BUGS
18680  
18681  =item SEE ALSO
18682  
18683  =back
18684  
18685  =head2 Encode::Unicode -- Various Unicode Transformation Formats
18686  
18687  =over 4
18688  
18689  =item SYNOPSIS
18690  
18691  =item ABSTRACT
18692  
18693  L<http://www.unicode.org/glossary/> says:, Quick Reference
18694  
18695  =item Size, Endianness, and BOM
18696  
18697  =over 4
18698  
18699  =item by size
18700  
18701  =item by endianness
18702  
18703  BOM as integer when fetched in network byte order
18704  
18705  =back
18706  
18707  =item Surrogate Pairs
18708  
18709  =item Error Checking
18710  
18711  =item SEE ALSO
18712  
18713  =back
18714  
18715  =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
18716  
18717  =over 4
18718  
18719  =item SYNOPSIS
18720  
18721  =item ABSTRACT
18722  
18723  =item In Practice
18724  
18725  =item SEE ALSO
18726  
18727  =back
18728  
18729  =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
18730  encodings
18731  
18732  =over 4
18733  
18734  =item SYNOPSIS
18735  
18736  =item DESCRIPTION
18737  
18738  As a simple string, As a qr// compiled regular expression, e.g.:, As a code
18739  reference, e.g.:
18740  
18741  =over 4
18742  
18743  =item Alias overloading
18744  
18745  =back
18746  
18747  =item SEE ALSO
18748  
18749  =back
18750  
18751  =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
18752  Internally used by Encode::??::ISO_2022_*
18753  
18754  =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
18755  Encode::CN
18756  
18757  =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
18758  Encode
18759  
18760  =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
18761  Implementation Base Class
18762  
18763  =over 4
18764  
18765  =item SYNOPSIS
18766  
18767  =item DESCRIPTION
18768  
18769  =over 4
18770  
18771  =item Methods you should implement
18772  
18773  -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
18774  -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
18775  
18776  =item Other methods defined in Encode::Encodings
18777  
18778  -E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
18779  -E<gt>needs_lines()
18780  
18781  =item Example: Encode::ROT13
18782  
18783  =back
18784  
18785  =item Why the heck Encode API is different?
18786  
18787  =over 4
18788  
18789  =item Compiled Encodings
18790  
18791  =back
18792  
18793  =item SEE ALSO
18794  
18795  Scheme 1, Scheme 2, Other Schemes
18796  
18797  =back
18798  
18799  =head2 Encode::lib::Encode::GSM0338, Encode::GSM0338 -- ESTI GSM 03.38
18800  Encoding
18801  
18802  =over 4
18803  
18804  =item SYNOPSIS
18805  
18806  =item DESCRIPTION
18807  
18808  =item NOTES
18809  
18810  =item BUGS
18811  
18812  =item SEE ALSO
18813  
18814  =back
18815  
18816  =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
18817  data
18818  
18819  =over 4
18820  
18821  =item SYNOPSIS
18822  
18823  =item ABSTRACT
18824  
18825  =item DESCRIPTION
18826  
18827  Encode::Guess->set_suspects, Encode::Guess->add_suspects,
18828  Encode::decode("Guess" ...), Encode::Guess->guess($data),
18829  guess_encoding($data, [, I<list of suspects>])
18830  
18831  =item CAVEATS
18832  
18833  =item TO DO
18834  
18835  =item SEE ALSO
18836  
18837  =back
18838  
18839  =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
18840  Encode::JP::2022_JP*
18841  
18842  =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
18843  by Encode::JP
18844  
18845  =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
18846  used by Encode::KR
18847  
18848  =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
18849  and 'Q' header encoding
18850  
18851  =over 4
18852  
18853  =item SYNOPSIS
18854  
18855  =item ABSTRACT
18856  
18857  =item DESCRIPTION
18858  
18859  =item BUGS
18860  
18861  =item SEE ALSO
18862  
18863  =back
18864  
18865  =head2 Encode::lib::Encode::MIME::Name, Encode::MIME::NAME -- internally
18866  used by Encode
18867  
18868  =over 4
18869  
18870  =item SEE ALSO
18871  
18872  =back
18873  
18874  =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
18875  on Encode and PerlIO
18876  
18877  =over 4
18878  
18879  =item Overview
18880  
18881  =item How does it work?
18882  
18883  =item Line Buffering
18884  
18885  =over 4
18886  
18887  =item How can I tell whether my encoding fully supports PerlIO ?
18888  
18889  =back
18890  
18891  =item SEE ALSO
18892  
18893  =back
18894  
18895  =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
18896  supported by Encode
18897  
18898  =over 4
18899  
18900  =item DESCRIPTION
18901  
18902  =over 4
18903  
18904  =item Encoding Names
18905  
18906  =back
18907  
18908  =item Supported Encodings
18909  
18910  =over 4
18911  
18912  =item Built-in Encodings
18913  
18914  =item Encode::Unicode -- other Unicode encodings
18915  
18916  =item Encode::Byte -- Extended ASCII
18917  
18918  ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
18919  the Cyrillic world
18920  
18921  =item gsm0338 - Hentai Latin 1
18922  
18923  gsm0338 support before 2.19
18924  
18925  =item CJK: Chinese, Japanese, Korean (Multibyte)
18926  
18927  Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
18928  Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
18929  Encode::JIS2K -- JIS X 0213 encodings via CPAN
18930  
18931  =item Miscellaneous encodings
18932  
18933  Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
18934  
18935  =back
18936  
18937  =item Unsupported encodings
18938  
18939    ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
18940  Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
18941  System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
18942  Various Mac encodings, (Mac) Indic encodings
18943  
18944  =item Encoding vs. Charset -- terminology
18945  
18946  =item Encoding Classification (by Anton Tagunov and Dan Kogai)
18947  
18948  =over 4
18949  
18950  =item Microsoft-related naming mess
18951  
18952  KS_C_5601-1987, GB2312, Big5, Shift_JIS
18953  
18954  =back
18955  
18956  =item Glossary
18957  
18958  character repertoire, coded character set (CCS), character encoding scheme
18959  (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
18960  UTF-16
18961  
18962  =item See Also
18963  
18964  =item References
18965  
18966  ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
18967  RFC, UC, Unicode Glossary
18968  
18969  =over 4
18970  
18971  =item Other Notable Sites
18972  
18973  czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
18974  "Introduction to i18n"
18975  
18976  =item Offline sources
18977  
18978  C<CJKV Information Processing> by Ken Lunde
18979  
18980  =back
18981  
18982  =back
18983  
18984  =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
18985  encoding
18986  
18987  =over 4
18988  
18989  =item SYNOPSIS
18990  
18991  =item ABSTRACT
18992  
18993  =item In Practice
18994  
18995  =item SEE ALSO
18996  
18997  =back
18998  
18999  =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
19000  
19001  =over 4
19002  
19003  =item SYNOPSIS
19004  
19005  =item ABSTRACT
19006  
19007  =item Description
19008  
19009  =over 4
19010  
19011  =item Predefined Methods
19012  
19013  $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
19014  $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
19015  $e-E<gt>bytes([$encoding])
19016  
19017  =item Example: base64 transcoder
19018  
19019  =item Operator Overloading
19020  
19021  =back
19022  
19023  =item SEE ALSO
19024  
19025  =back
19026  
19027  =head2 Encodencoding, encoding - allows you to write your script in
19028  non-ascii or non-utf8
19029  
19030  =over 4
19031  
19032  =item SYNOPSIS
19033  
19034  =item ABSTRACT
19035  
19036  =over 4
19037  
19038  =item Literal Conversions
19039  
19040  =item PerlIO layers for C<STD(IN|OUT)>
19041  
19042  =item Implicit upgrading for byte strings
19043  
19044  =item Side effects
19045  
19046  =item Side effects
19047  
19048  =item Side effects
19049  
19050  =back
19051  
19052  =item FEATURES THAT REQUIRE 5.8.1
19053  
19054  "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
19055  
19056  =item USAGE
19057  
19058  use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
19059  I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
19060  
19061  =item The Filter Option
19062  
19063  =over 4
19064  
19065  =item Filter-related changes at Encode version 1.87
19066  
19067  =back
19068  
19069  =item CAVEATS
19070  
19071  =over 4
19072  
19073  =item NOT SCOPED
19074  
19075  =item DO NOT MIX MULTIPLE ENCODINGS
19076  
19077  =item tr/// with ranges
19078  
19079  Legend of characters above
19080  
19081  =back
19082  
19083  =item EXAMPLE - Greekperl
19084  
19085  =item KNOWN PROBLEMS
19086  
19087  literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
19088  safety
19089  
19090  =over 4
19091  
19092  =item The Logic of :locale
19093  
19094  =back
19095  
19096  =item HISTORY
19097  
19098  =item SEE ALSO
19099  
19100  =back
19101  
19102  =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
19103  
19104  =over 4
19105  
19106  =item SYNOPSIS
19107  
19108  =item ABSTRACT
19109  
19110  =item Description
19111  
19112  =over 4
19113  
19114  =item Predefined Methods
19115  
19116  $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
19117  $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
19118  $e-E<gt>bytes([$encoding])
19119  
19120  =item Example: base64 transcoder
19121  
19122  =item Operator Overloading
19123  
19124  =back
19125  
19126  =item SEE ALSO
19127  
19128  =back
19129  
19130  =head2 English - use nice English (or awk) names for ugly punctuation
19131  variables
19132  
19133  =over 4
19134  
19135  =item SYNOPSIS
19136  
19137  =item DESCRIPTION
19138  
19139  =item PERFORMANCE
19140  
19141  =back
19142  
19143  =head2 Env - perl module that imports environment variables as scalars or
19144  arrays
19145  
19146  =over 4
19147  
19148  =item SYNOPSIS
19149  
19150  =item DESCRIPTION
19151  
19152  =item LIMITATIONS
19153  
19154  =item AUTHOR
19155  
19156  =back
19157  
19158  =head2 Errno - System errno constants
19159  
19160  =over 4
19161  
19162  =item SYNOPSIS
19163  
19164  =item DESCRIPTION
19165  
19166  =item CAVEATS
19167  
19168  =item AUTHOR
19169  
19170  =item COPYRIGHT
19171  
19172  =back
19173  
19174  =head2 Exporter - Implements default import method for modules
19175  
19176  =over 4
19177  
19178  =item SYNOPSIS
19179  
19180  =item DESCRIPTION
19181  
19182  =over 4
19183  
19184  =item How to Export
19185  
19186  =item Selecting What To Export
19187  
19188  =item How to Import
19189  
19190  C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
19191  
19192  =back
19193  
19194  =item Advanced features
19195  
19196  =over 4
19197  
19198  =item Specialised Import Lists
19199  
19200  =item Exporting without using Exporter's import method
19201  
19202  =item Exporting without inheriting from Exporter
19203  
19204  =item Module Version Checking
19205  
19206  =item Managing Unknown Symbols
19207  
19208  =item Tag Handling Utility Functions
19209  
19210  =item Generating combined tags
19211  
19212  =item C<AUTOLOAD>ed Constants
19213  
19214  =back
19215  
19216  =item Good Practices
19217  
19218  =over 4
19219  
19220  =item Declaring C<@EXPORT_OK> and Friends
19221  
19222  =item Playing Safe
19223  
19224  =item What not to Export
19225  
19226  =back
19227  
19228  =item SEE ALSO
19229  
19230  =item LICENSE
19231  
19232  =back
19233  
19234  =head2 Exporter::Heavy - Exporter guts
19235  
19236  =over 4
19237  
19238  =item SYNOPSIS
19239  
19240  =item DESCRIPTION
19241  
19242  =back
19243  
19244  =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
19245  
19246  =over 4
19247  
19248  =item SYNOPSIS
19249  
19250  =item DESCRIPTION
19251  
19252  =item METHODS
19253  
19254  new, have_compiler, compile, C<object_file>, C<include_dirs>,
19255  C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
19256  link_executable, exe_file, object_file, lib_file, exe_file, prelink,
19257  need_prelink, extra_link_args_after_prelink
19258  
19259  =item TO DO
19260  
19261  =item HISTORY
19262  
19263  =item AUTHOR
19264  
19265  =item COPYRIGHT
19266  
19267  =item SEE ALSO
19268  
19269  =back
19270  
19271  =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
19272  platforms
19273  
19274  =over 4
19275  
19276  =item DESCRIPTION
19277  
19278  =item AUTHOR
19279  
19280  =item SEE ALSO
19281  
19282  =back
19283  
19284  =head2 ExtUtils::Command - utilities to replace common UNIX commands in
19285  Makefiles etc.
19286  
19287  =over 4
19288  
19289  =item SYNOPSIS
19290  
19291  =item DESCRIPTION
19292  
19293  =over 4
19294  
19295  =item FUNCTIONS
19296  
19297  =back
19298  
19299  =back
19300  
19301  cat
19302  
19303  eqtime
19304  
19305  rm_rf
19306  
19307  rm_f
19308  
19309  touch
19310  
19311  mv
19312  
19313  cp
19314  
19315  chmod
19316  
19317  mkpath
19318  
19319  test_f
19320  
19321  test_d
19322  
19323  dos2unix
19324  
19325  =over 4
19326  
19327  =item SEE ALSO
19328  
19329  =item AUTHOR
19330  
19331  =back
19332  
19333  =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
19334  
19335  =over 4
19336  
19337  =item SYNOPSIS
19338  
19339  =item DESCRIPTION
19340  
19341  B<test_harness>
19342  
19343  =back
19344  
19345  B<pod2man>
19346  
19347  B<warn_if_old_packlist>
19348  
19349  B<perllocal_install>
19350  
19351  B<uninstall>
19352  
19353  =head2 ExtUtils::Constant - generate XS code to import C header constants
19354  
19355  =over 4
19356  
19357  =item SYNOPSIS
19358  
19359  =item DESCRIPTION
19360  
19361  =item USAGE
19362  
19363  IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
19364  
19365  =item FUNCTIONS
19366  
19367  =back
19368  
19369  constant_types
19370  
19371  XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
19372  
19373  autoload PACKAGE, VERSION, AUTOLOADER
19374  
19375  WriteMakefileSnippet
19376  
19377  WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
19378  BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME
19379  
19380  =over 4
19381  
19382  =item AUTHOR
19383  
19384  =back
19385  
19386  =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
19387  
19388  =over 4
19389  
19390  =item SYNOPSIS
19391  
19392  =item DESCRIPTION
19393  
19394  =item USAGE
19395  
19396  =back
19397  
19398  header
19399  
19400  memEQ_clause args_hashref
19401  
19402  dump_names arg_hashref, ITEM..
19403  
19404  assign arg_hashref, VALUE..
19405  
19406  return_clause arg_hashref, ITEM
19407  
19408  switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
19409  
19410  params WHAT
19411  
19412  dogfood arg_hashref, ITEM..
19413  
19414  normalise_items args, default_type, seen_types, seen_items, ITEM..
19415  
19416  C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
19417  post, def_pre, def_post, utf8, weight
19418  
19419  =over 4
19420  
19421  =item BUGS
19422  
19423  =item AUTHOR
19424  
19425  =back
19426  
19427  =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
19428  
19429  =over 4
19430  
19431  =item SYNOPSIS
19432  
19433  =item DESCRIPTION
19434  
19435  =item USAGE
19436  
19437  C_stringify NAME
19438  
19439  =back
19440  
19441  perl_stringify NAME
19442  
19443  =over 4
19444  
19445  =item AUTHOR
19446  
19447  =back
19448  
19449  =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
19450  ExtUtils::Constant objects
19451  
19452  =over 4
19453  
19454  =item SYNOPSIS
19455  
19456  =item DESCRIPTION
19457  
19458  =item BUGS
19459  
19460  =item AUTHOR
19461  
19462  =back
19463  
19464  =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
19465  
19466  =over 4
19467  
19468  =item SYNOPSIS
19469  
19470  =item DESCRIPTION
19471  
19472  =item @EXPORT
19473  
19474  =item FUNCTIONS
19475  
19476  xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
19477  ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
19478  
19479  =item EXAMPLES
19480  
19481  =item SEE ALSO
19482  
19483  =item AUTHOR
19484  
19485  =back
19486  
19487  =head2 ExtUtils::Install - install files from here to there
19488  
19489  =over 4
19490  
19491  =item SYNOPSIS
19492  
19493  =item DESCRIPTION
19494  
19495  _chmod($$;$), _warnonce(@), _choke(@)
19496  
19497  =back
19498  
19499  _move_file_at_boot( $file, $target, $moan  )
19500  
19501  _unlink_or_rename( $file, $tryhard, $installing )
19502  
19503  =over 4
19504  
19505  =item Functions
19506  
19507  B<install>
19508  
19509  =back
19510  
19511  _get_install_skip
19512  
19513  _have_write_access
19514  
19515  _can_write_dir(C<$dir>)
19516  
19517  _mkpath($dir,$show,$mode,$verbose,$fake)
19518  
19519  _copy($from,$to,$verbose,$fake)
19520  
19521  _chdir($from)
19522  
19523  _do_cleanup
19524  
19525  install_rooted_file( $file ), install_rooted_dir( $dir )
19526  
19527  forceunlink( $file, $tryhard )
19528  
19529  directory_not_empty( $dir )
19530  
19531  B<install_default> I<DISCOURAGED>
19532  
19533  B<uninstall>
19534  
19535  inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore)
19536  
19537  run_filter($cmd,$src,$dest)
19538  
19539  B<pm_to_blib>
19540  
19541  _autosplit
19542  
19543  _invokant
19544  
19545  =over 4
19546  
19547  =item ENVIRONMENT
19548  
19549  B<PERL_INSTALL_ROOT>, B<EU_INSTALL_IGNORE_SKIP>,
19550  B<EU_INSTALL_SITE_SKIPFILE>
19551  
19552  =item AUTHOR
19553  
19554  =item LICENSE
19555  
19556  =back
19557  
19558  =head2 ExtUtils::Installed - Inventory management of installed modules
19559  
19560  =over 4
19561  
19562  =item SYNOPSIS
19563  
19564  =item DESCRIPTION
19565  
19566  =item USAGE
19567  
19568  =item FUNCTIONS
19569  
19570  new(), modules(), files(), directories(), directory_tree(), validate(),
19571  packlist(), version()
19572  
19573  =item EXAMPLE
19574  
19575  =item AUTHOR
19576  
19577  =back
19578  
19579  =head2 ExtUtils::Liblist - determine libraries to use and how to use them
19580  
19581  =over 4
19582  
19583  =item SYNOPSIS
19584  
19585  =item DESCRIPTION
19586  
19587  For static extensions, For dynamic extensions at build/link time, For
19588  dynamic extensions at load time
19589  
19590  =over 4
19591  
19592  =item EXTRALIBS
19593  
19594  =item LDLOADLIBS and LD_RUN_PATH
19595  
19596  =item BSLOADLIBS
19597  
19598  =back
19599  
19600  =item PORTABILITY
19601  
19602  =over 4
19603  
19604  =item VMS implementation
19605  
19606  =item Win32 implementation
19607  
19608  =back
19609  
19610  =item SEE ALSO
19611  
19612  =back
19613  
19614  =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
19615  
19616  =over 4
19617  
19618  =item SYNOPSIS
19619  
19620  =item DESCRIPTION
19621  
19622  =back
19623  
19624  =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
19625  
19626  =over 4
19627  
19628  =item SYNOPSIS
19629  
19630  =item DESCRIPTION
19631  
19632  =over 4
19633  
19634  =item Overridden methods
19635  
19636  =back
19637  
19638  =back
19639  
19640  =over 4
19641  
19642  =item AUTHOR
19643  
19644  =item SEE ALSO
19645  
19646  =back
19647  
19648  =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
19649  
19650  =over 4
19651  
19652  =item SYNOPSIS
19653  
19654  =item DESCRIPTION
19655  
19656  =item METHODS
19657  
19658  =over 4
19659  
19660  =item Cross-platform helper methods
19661  
19662  =back
19663  
19664  =back
19665  
19666  =over 4
19667  
19668  =item Targets
19669  
19670  =back
19671  
19672  =over 4
19673  
19674  =item Init methods
19675  
19676  =back
19677  
19678  =over 4
19679  
19680  =item Tools
19681  
19682  =back
19683  
19684  =over 4
19685  
19686  =item File::Spec wrappers
19687  
19688  =back
19689  
19690  =over 4
19691  
19692  =item Misc
19693  
19694  =back
19695  
19696  =over 4
19697  
19698  =item AUTHOR
19699  
19700  =back
19701  
19702  =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
19703  ExtUtils::MakeMaker
19704  
19705  =over 4
19706  
19707  =item SYNOPSIS
19708  
19709  =item DESCRIPTION
19710  
19711  =back
19712  
19713  os_flavor
19714  
19715  init_linker
19716  
19717  =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
19718  ExtUtils::MakeMaker
19719  
19720  =over 4
19721  
19722  =item SYNOPSIS
19723  
19724  =item DESCRIPTION
19725  
19726  os_flavor
19727  
19728  =back
19729  
19730  cflags
19731  
19732  replace_manpage_separator
19733  
19734  init_linker
19735  
19736  =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
19737  
19738  =over 4
19739  
19740  =item SYNOPSIS
19741  
19742  =item DESCRIPTION
19743  
19744  =over 4
19745  
19746  =item Overridden methods
19747  
19748  os_flavor
19749  
19750  =back
19751  
19752  =back
19753  
19754  B<replace_manpage_separator>
19755  
19756  =over 4
19757  
19758  =item AUTHOR
19759  
19760  =item SEE ALSO
19761  
19762  =back
19763  
19764  =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
19765  
19766  =over 4
19767  
19768  =item SYNOPSIS
19769  
19770  =item DESCRIPTION
19771  
19772  =back
19773  
19774  =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
19775  ExtUtils::MakeMaker
19776  
19777  =over 4
19778  
19779  =item SYNOPSIS
19780  
19781  =item DESCRIPTION
19782  
19783  =back
19784  
19785  os_flavor
19786  
19787  init_platform, platform_constants
19788  
19789  const_cccmd
19790  
19791  static_lib
19792  
19793  dynamic_lib
19794  
19795  =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
19796  ExtUtils::MakeMaker
19797  
19798  =over 4
19799  
19800  =item SYNOPSIS
19801  
19802  =item DESCRIPTION
19803  
19804  =item METHODS
19805  
19806  init_dist
19807  
19808  =back
19809  
19810  init_linker
19811  
19812  os_flavor
19813  
19814  =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
19815  
19816  =over 4
19817  
19818  =item SYNOPSIS
19819  
19820  =item DESCRIPTION
19821  
19822  =over 4
19823  
19824  =item Overridden methods
19825  
19826  =back
19827  
19828  =back
19829  
19830  =over 4
19831  
19832  =item AUTHOR
19833  
19834  =item SEE ALSO
19835  
19836  =back
19837  
19838  =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
19839  
19840  =over 4
19841  
19842  =item SYNOPSIS
19843  
19844  =item DESCRIPTION
19845  
19846  =over 4
19847  
19848  =item Overridden methods
19849  
19850  os_flavor
19851  
19852  =back
19853  
19854  =back
19855  
19856  B<replace_manpage_separator>
19857  
19858  =over 4
19859  
19860  =item AUTHOR
19861  
19862  =item SEE ALSO
19863  
19864  =back
19865  
19866  =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
19867  
19868  =over 4
19869  
19870  =item SYNOPSIS
19871  
19872  =item DESCRIPTION
19873  
19874  =item METHODS
19875  
19876  =back
19877  
19878  =over 4
19879  
19880  =item Methods
19881  
19882  os_flavor
19883  
19884  =back
19885  
19886  c_o (o)
19887  
19888  cflags (o)
19889  
19890  const_cccmd (o)
19891  
19892  const_config (o)
19893  
19894  const_loadlibs (o)
19895  
19896  constants (o)
19897  
19898  depend (o)
19899  
19900  init_DEST
19901  
19902  init_dist
19903  
19904  dist (o)
19905  
19906  dist_basics (o)
19907  
19908  dist_ci (o)
19909  
19910  dist_core (o)
19911  
19912  B<dist_target>
19913  
19914  B<tardist_target>
19915  
19916  B<zipdist_target>
19917  
19918  B<tarfile_target>
19919  
19920  zipfile_target
19921  
19922  uutardist_target
19923  
19924  shdist_target
19925  
19926  dlsyms (o)
19927  
19928  dynamic_bs (o)
19929  
19930  dynamic_lib (o)
19931  
19932  exescan
19933  
19934  extliblist
19935  
19936  find_perl
19937  
19938  fixin
19939  
19940  force (o)
19941  
19942  guess_name
19943  
19944  has_link_code
19945  
19946  init_dirscan
19947  
19948  init_MANPODS
19949  
19950  init_MAN1PODS
19951  
19952  init_MAN3PODS
19953  
19954  init_PM
19955  
19956  init_DIRFILESEP
19957  
19958  init_main
19959  
19960  init_others
19961  
19962  init_linker
19963  
19964  init_lib2arch
19965  
19966  init_PERL
19967  
19968  init_platform, platform_constants
19969  
19970  init_PERM
19971  
19972  init_xs
19973  
19974  install (o)
19975  
19976  installbin (o)
19977  
19978  linkext (o)
19979  
19980  lsdir
19981  
19982  macro (o)
19983  
19984  makeaperl (o)
19985  
19986  makefile (o)
19987  
19988  maybe_command
19989  
19990  needs_linking (o)
19991  
19992  parse_abstract
19993  
19994  parse_version
19995  
19996  pasthru (o)
19997  
19998  perl_script
19999  
20000  perldepend (o)
20001  
20002  perm_rw (o)
20003  
20004  perm_rwx (o)
20005  
20006  pm_to_blib
20007  
20008  post_constants (o)
20009  
20010  post_initialize (o)
20011  
20012  postamble (o)
20013  
20014  ppd
20015  
20016  prefixify
20017  
20018  processPL (o)
20019  
20020  quote_paren
20021  
20022  replace_manpage_separator
20023  
20024  cd
20025  
20026  oneliner
20027  
20028  quote_literal
20029  
20030  escape_newlines
20031  
20032  max_exec_len
20033  
20034  static (o)
20035  
20036  static_lib (o)
20037  
20038  staticmake (o)
20039  
20040  subdir_x (o)
20041  
20042  subdirs (o)
20043  
20044  test (o)
20045  
20046  test_via_harness (override)
20047  
20048  test_via_script (override)
20049  
20050  tools_other (o)
20051  
20052  tool_xsubpp (o)
20053  
20054  all_target
20055  
20056  top_targets (o)
20057  
20058  writedoc
20059  
20060  xs_c (o)
20061  
20062  xs_cpp (o)
20063  
20064  xs_o (o)
20065  
20066  =over 4
20067  
20068  =item SEE ALSO
20069  
20070  =back
20071  
20072  =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
20073  ExtUtils::MakeMaker
20074  
20075  =over 4
20076  
20077  =item SYNOPSIS
20078  
20079  =item DESCRIPTION
20080  
20081  =over 4
20082  
20083  =item Methods always loaded
20084  
20085  wraplist
20086  
20087  =back
20088  
20089  =back
20090  
20091  =over 4
20092  
20093  =item Methods
20094  
20095  guess_name (override)
20096  
20097  =back
20098  
20099  find_perl (override)
20100  
20101  maybe_command (override)
20102  
20103  pasthru (override)
20104  
20105  pm_to_blib (override)
20106  
20107  perl_script (override)
20108  
20109  replace_manpage_separator
20110  
20111  init_DEST
20112  
20113  init_DIRFILESEP
20114  
20115  init_main (override)
20116  
20117  init_others (override)
20118  
20119  init_platform (override)
20120  
20121  platform_constants
20122  
20123  init_VERSION (override)
20124  
20125  constants (override)
20126  
20127  special_targets
20128  
20129  cflags (override)
20130  
20131  const_cccmd (override)
20132  
20133  tools_other (override)
20134  
20135  init_dist (override)
20136  
20137  c_o (override)
20138  
20139  xs_c (override)
20140  
20141  xs_o (override)
20142  
20143  dlsyms (override)
20144  
20145  dynamic_lib (override)
20146  
20147  static_lib (override)
20148  
20149  extra_clean_files
20150  
20151  zipfile_target, tarfile_target, shdist_target
20152  
20153  install (override)
20154  
20155  perldepend (override)
20156  
20157  makeaperl (override)
20158  
20159  maketext_filter (override)
20160  
20161  prefixify (override)
20162  
20163  cd
20164  
20165  oneliner
20166  
20167  B<echo>
20168  
20169  quote_literal
20170  
20171  escape_newlines
20172  
20173  max_exec_len
20174  
20175  init_linker
20176  
20177  eliminate_macros
20178  
20179  fixpath
20180  
20181  os_flavor
20182  
20183  =over 4
20184  
20185  =item AUTHOR
20186  
20187  =back
20188  
20189  =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
20190  
20191  =over 4
20192  
20193  =item SYNOPSIS
20194  
20195  =item DESCRIPTION
20196  
20197  =over 4
20198  
20199  =item Overridden methods
20200  
20201  =back
20202  
20203  =back
20204  
20205  =over 4
20206  
20207  =item AUTHOR
20208  
20209  =item SEE ALSO
20210  
20211  =back
20212  
20213  =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
20214  ExtUtils::MakeMaker
20215  
20216  =over 4
20217  
20218  =item SYNOPSIS
20219  
20220  =item DESCRIPTION
20221  
20222  =back
20223  
20224  =over 4
20225  
20226  =item Overridden methods
20227  
20228  B<dlsyms>
20229  
20230  =back
20231  
20232  replace_manpage_separator
20233  
20234  B<maybe_command>
20235  
20236  B<init_DIRFILESEP>
20237  
20238  B<init_others>
20239  
20240  init_platform, platform_constants
20241  
20242  special_targets
20243  
20244  static_lib
20245  
20246  dynamic_lib
20247  
20248  extra_clean_files
20249  
20250  init_linker
20251  
20252  perl_script
20253  
20254  xs_o
20255  
20256  pasthru
20257  
20258  oneliner
20259  
20260  cd
20261  
20262  max_exec_len
20263  
20264  os_flavor
20265  
20266  cflags
20267  
20268  =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
20269  
20270  =over 4
20271  
20272  =item SYNOPSIS
20273  
20274  =item DESCRIPTION
20275  
20276  =over 4
20277  
20278  =item Overridden methods
20279  
20280  xs_c
20281  
20282  =back
20283  
20284  =back
20285  
20286  xs_cpp
20287  
20288  xs_o
20289  
20290  max_exec_len
20291  
20292  os_flavor
20293  
20294  =over 4
20295  
20296  =item AUTHOR
20297  
20298  =back
20299  
20300  =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
20301  
20302  =over 4
20303  
20304  =item SYNOPSIS
20305  
20306  =item DESCRIPTION
20307  
20308  =back
20309  
20310  =head2 ExtUtils::MakeMaker - Create a module Makefile
20311  
20312  =over 4
20313  
20314  =item SYNOPSIS
20315  
20316  =item DESCRIPTION
20317  
20318  =over 4
20319  
20320  =item How To Write A Makefile.PL
20321  
20322  =item Default Makefile Behaviour
20323  
20324  =item make test
20325  
20326  =item make testdb
20327  
20328  =item make install
20329  
20330  =item INSTALL_BASE
20331  
20332  =item PREFIX and LIB attribute
20333  
20334  =item AFS users
20335  
20336  =item Static Linking of a new Perl Binary
20337  
20338  =item Determination of Perl Library and Installation Locations
20339  
20340  =item Which architecture dependent directory?
20341  
20342  =item Using Attributes and Parameters
20343  
20344  ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
20345  CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
20346  EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
20347  FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
20348  INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
20349  INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
20350  INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
20351  INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
20352  INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
20353  INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
20354  LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LICENSE, LINKTYPE, MAKE,
20355  MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
20356  NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL,
20357  PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX,
20358  PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
20359  PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
20360  PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN,
20361  SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
20362  XS, XSOPT, XSPROTOARG, XS_VERSION
20363  
20364  =item Additional lowercase attributes
20365  
20366  clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
20367  test, tool_autosplit
20368  
20369  =item Overriding MakeMaker Methods
20370  
20371  =item The End Of Cargo Cult Programming
20372  
20373  C<< MAN3PODS => ' ' >>
20374  
20375  =item Hintsfile support
20376  
20377  =item Distribution Support
20378  
20379     make distcheck,    make skipcheck,     make distclean,    make manifest, 
20380    make distdir,   make disttest,    make tardist,    make dist,    make
20381  uutardist,    make shdist,    make zipdist,    make ci
20382  
20383  =item Module Meta-Data
20384  
20385  =item Disabling an extension
20386  
20387  =item Other Handy Functions
20388  
20389  prompt
20390  
20391  =back
20392  
20393  =item ENVIRONMENT
20394  
20395  PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
20396  
20397  =item SEE ALSO
20398  
20399  =item AUTHORS
20400  
20401  =item LICENSE
20402  
20403  =back
20404  
20405  =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
20406  
20407  =over 4
20408  
20409  =item SYNOPSIS
20410  
20411  =item DESCRIPTION
20412  
20413  =back
20414  
20415  =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
20416  MakeMaker
20417  
20418  =over 4
20419  
20420  =item DESCRIPTION
20421  
20422  =over 4
20423  
20424  =item Module Installation
20425  
20426  How do I install a module into my home directory?, How do I get MakeMaker
20427  and Module::Build to install to the same place?, How do I keep from
20428  installing man pages?, How do I use a module without installing it?, PREFIX
20429  vs INSTALL_BASE from Module::Build::Cookbook
20430  
20431  =item Philosophy and History
20432  
20433  Why not just use <insert other build config tool here>?, What is
20434  Module::Build and how does it relate to MakeMaker?, pure perl.    no make, no
20435  shell commands, easier to customize, cleaner internals, less cruft
20436  
20437  =item Module Writing
20438  
20439  How do I keep my $VERSION up to date without resetting it manually?, What's
20440  this F<META.yml> thing and how did it get in my F<MANIFEST>?!, How do I
20441  delete everything not in my F<MANIFEST>?
20442  
20443  =item XS
20444  
20445  How to I prevent "object version X.XX does not match bootstrap parameter
20446  Y.YY" errors?, How do I make two or more XS files coexist in the same
20447  directory?
20448  
20449  =back
20450  
20451  =item PATCHING
20452  
20453  =item AUTHOR
20454  
20455  =item SEE ALSO
20456  
20457  =back
20458  
20459  =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
20460  
20461  =over 4
20462  
20463  =item SYNOPSIS
20464  
20465  =item DESCRIPTION
20466  
20467  =over 4
20468  
20469  =item The Mantra
20470  
20471  =item The Layout
20472  
20473  Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
20474  bin/
20475  
20476  =back
20477  
20478  =item SEE ALSO
20479  
20480  =back
20481  
20482  =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
20483  
20484  =over 4
20485  
20486  =item SYNOPSIS
20487  
20488  =item DESCRIPTION
20489  
20490  =back
20491  
20492  =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
20493  
20494  =over 4
20495  
20496  =item SYNOPSIS
20497  
20498  =item DESCRIPTION
20499  
20500  =back
20501  
20502  =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
20503  
20504  =over 4
20505  
20506  =item SYNOPSIS
20507  
20508  =item DESCRIPTION
20509  
20510  =over 4
20511  
20512  =item Functions
20513  
20514  mkmanifest
20515  
20516  =back
20517  
20518  =back
20519  
20520  manifind
20521  
20522  manicheck
20523  
20524  filecheck
20525  
20526  fullcheck
20527  
20528  skipcheck
20529  
20530  maniread
20531  
20532  manicopy
20533  
20534  maniadd
20535  
20536  =over 4
20537  
20538  =item MANIFEST
20539  
20540  =item MANIFEST.SKIP
20541  
20542  #!include_default, #!include /Path/to/another/manifest.skip
20543  
20544  =item EXPORT_OK
20545  
20546  =item GLOBAL VARIABLES
20547  
20548  =back
20549  
20550  =over 4
20551  
20552  =item DIAGNOSTICS
20553  
20554  C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
20555  C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
20556  
20557  =item ENVIRONMENT
20558  
20559  B<PERL_MM_MANIFEST_DEBUG>
20560  
20561  =item SEE ALSO
20562  
20563  =item AUTHOR
20564  
20565  =back
20566  
20567  =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
20568  
20569  =over 4
20570  
20571  =item SYNOPSIS
20572  
20573  =item DESCRIPTION
20574  
20575  =item SEE ALSO
20576  
20577  =back
20578  
20579  =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
20580  
20581  =over 4
20582  
20583  =item SYNOPSIS
20584  
20585  =item DESCRIPTION
20586  
20587  =back
20588  
20589  =head2 ExtUtils::Mksymlists - write linker options files for dynamic
20590  extension
20591  
20592  =over 4
20593  
20594  =item SYNOPSIS
20595  
20596  =item DESCRIPTION
20597  
20598  DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
20599  
20600  =item AUTHOR
20601  
20602  =item REVISION
20603  
20604  mkfh()
20605  
20606  =back
20607  
20608  __find_relocations
20609  
20610  =head2 ExtUtils::Packlist - manage .packlist files
20611  
20612  =over 4
20613  
20614  =item SYNOPSIS
20615  
20616  =item DESCRIPTION
20617  
20618  =item USAGE
20619  
20620  =item FUNCTIONS
20621  
20622  new(), read(), write(), validate(), packlist_file()
20623  
20624  =item EXAMPLE
20625  
20626  =item AUTHOR
20627  
20628  =back
20629  
20630  =head2 ExtUtils::ParseXS - converts Perl XS code into C code
20631  
20632  =over 4
20633  
20634  =item SYNOPSIS
20635  
20636  =item EXPORT
20637  
20638  =item FUNCTIONS
20639  
20640  process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
20641  B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
20642  errors()
20643  
20644  =item AUTHOR
20645  
20646  =item COPYRIGHT
20647  
20648  =item SEE ALSO
20649  
20650  =back
20651  
20652  =head2 ExtUtils::testlib - add blib/* directories to @INC
20653  
20654  =over 4
20655  
20656  =item SYNOPSIS
20657  
20658  =item DESCRIPTION
20659  
20660  =back
20661  
20662  =head2 Fatal - replace functions with equivalents which succeed or die
20663  
20664  =over 4
20665  
20666  =item SYNOPSIS
20667  
20668  =item DESCRIPTION
20669  
20670  =item BUGS
20671  
20672  =item AUTHOR
20673  
20674  =back
20675  
20676  =head2 Fcntl - load the C Fcntl.h defines
20677  
20678  =over 4
20679  
20680  =item SYNOPSIS
20681  
20682  =item DESCRIPTION
20683  
20684  =item NOTE
20685  
20686  =item EXPORTED SYMBOLS
20687  
20688  =back
20689  
20690  =head2 File::Basename - Parse file paths into directory, filename and
20691  suffix.
20692  
20693  =over 4
20694  
20695  =item SYNOPSIS
20696  
20697  =item DESCRIPTION
20698  
20699  =back
20700  
20701  C<fileparse> X<fileparse>
20702  
20703  C<basename> X<basename> X<filename>
20704  
20705  C<dirname> X<dirname>
20706  
20707  C<fileparse_set_fstype> X<filesystem>
20708  
20709  =over 4
20710  
20711  =item SEE ALSO
20712  
20713  =back
20714  
20715  =head2 File::CheckTree - run many filetest checks on a tree
20716  
20717  =over 4
20718  
20719  =item SYNOPSIS
20720  
20721  =item DESCRIPTION
20722  
20723  =item AUTHOR
20724  
20725  =item HISTORY
20726  
20727  =back
20728  
20729  =head2 File::Compare - Compare files or filehandles
20730  
20731  =over 4
20732  
20733  =item SYNOPSIS
20734  
20735  =item DESCRIPTION
20736  
20737  =item RETURN
20738  
20739  =item AUTHOR
20740  
20741  =back
20742  
20743  =head2 File::Copy - Copy files or filehandles
20744  
20745  =over 4
20746  
20747  =item SYNOPSIS
20748  
20749  =item DESCRIPTION
20750  
20751  copy X<copy> X<cp>, move X<move> X<mv> X<rename>, syscopy X<syscopy>,
20752  rmscopy($from,$to[,$date_flag]) X<rmscopy>
20753  
20754  =item RETURN
20755  
20756  =item NOTES
20757  
20758  =item AUTHOR
20759  
20760  =back
20761  
20762  =head2 File::DosGlob - DOS like globbing and then some
20763  
20764  =over 4
20765  
20766  =item SYNOPSIS
20767  
20768  =item DESCRIPTION
20769  
20770  =item NOTES
20771  
20772  =item EXPORTS (by request only)
20773  
20774  =item BUGS
20775  
20776  =item AUTHOR
20777  
20778  =item HISTORY
20779  
20780  =item SEE ALSO
20781  
20782  =back
20783  
20784  =head2 File::Fetch - A generic file fetching mechanism
20785  
20786  =over 4
20787  
20788  =item SYNOPSIS
20789  
20790  =item DESCRIPTION
20791  
20792  =item ACCESSORS
20793  
20794  $ff->uri, $ff->scheme, $ff->host, $ff->vol, $ff->share, $ff->path,
20795  $ff->file
20796  
20797  =back
20798  
20799  $ff->output_file
20800  
20801  =over 4
20802  
20803  =item METHODS
20804  
20805  =over 4
20806  
20807  =item $ff = File::Fetch->new( uri => 'http://some.where.com/dir/file.txt'
20808  );
20809  
20810  =back
20811  
20812  =back
20813  
20814  =over 4
20815  
20816  =item $ff->fetch( [to => /my/output/dir/] )
20817  
20818  =back
20819  
20820  =over 4
20821  
20822  =item $ff->error([BOOL])
20823  
20824  =back
20825  
20826  =over 4
20827  
20828  =item HOW IT WORKS
20829  
20830  =item GLOBAL VARIABLES
20831  
20832  =over 4
20833  
20834  =item $File::Fetch::FROM_EMAIL
20835  
20836  =item $File::Fetch::USER_AGENT
20837  
20838  =item $File::Fetch::FTP_PASSIVE
20839  
20840  =item $File::Fetch::TIMEOUT
20841  
20842  =item $File::Fetch::WARN
20843  
20844  =item $File::Fetch::DEBUG
20845  
20846  =item $File::Fetch::BLACKLIST
20847  
20848  =item $File::Fetch::METHOD_FAIL
20849  
20850  =back
20851  
20852  =item MAPPING
20853  
20854  =item FREQUENTLY ASKED QUESTIONS
20855  
20856  =over 4
20857  
20858  =item So how do I use a proxy with File::Fetch?
20859  
20860  =item I used 'lynx' to fetch a file, but its contents is all wrong!
20861  
20862  =item Files I'm trying to fetch have reserved characters or non-ASCII
20863  characters in them. What do I do?
20864  
20865  =back
20866  
20867  =item TODO
20868  
20869  Implement $PREFER_BIN
20870  
20871  =item BUG REPORTS
20872  
20873  =item AUTHOR
20874  
20875  =item COPYRIGHT
20876  
20877  =back
20878  
20879  =head2 File::Find - Traverse a directory tree.
20880  
20881  =over 4
20882  
20883  =item SYNOPSIS
20884  
20885  =item DESCRIPTION
20886  
20887  B<find>, B<finddepth>
20888  
20889  =over 4
20890  
20891  =item %options
20892  
20893  C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
20894  C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
20895  C<untaint>, C<untaint_pattern>, C<untaint_skip>
20896  
20897  =item The wanted function
20898  
20899  C<$File::Find::dir> is the current directory name,, C<$_> is the current
20900  filename within that directory, C<$File::Find::name> is the complete
20901  pathname to the file
20902  
20903  =back
20904  
20905  =item WARNINGS
20906  
20907  =item CAVEAT
20908  
20909  $dont_use_nlink, symlinks
20910  
20911  =item NOTES
20912  
20913  =item BUGS AND CAVEATS
20914  
20915  =item HISTORY
20916  
20917  =back
20918  
20919  =head2 File::Glob - Perl extension for BSD glob routine
20920  
20921  =over 4
20922  
20923  =item SYNOPSIS
20924  
20925  =item DESCRIPTION
20926  
20927  =over 4
20928  
20929  =item META CHARACTERS
20930  
20931  =item POSIX FLAGS
20932  
20933  C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
20934  C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
20935  C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
20936  
20937  =back
20938  
20939  =item DIAGNOSTICS
20940  
20941  C<GLOB_NOSPACE>, C<GLOB_ABEND>
20942  
20943  =item NOTES
20944  
20945  =item SEE ALSO
20946  
20947  =item AUTHOR
20948  
20949  =back
20950  
20951  =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
20952  
20953  =over 4
20954  
20955  =item SYNOPSIS
20956  
20957  =item DESCRIPTION
20958  
20959  This code is a work in progress, There are known bugs, The interface
20960  defined here is tentative, There are portability issues, Do not use in
20961  production code, Consider yourself warned!
20962  
20963  =over 4
20964  
20965  =item Behind The Scenes
20966  
20967  =item Limitations
20968  
20969  =item Input File Glob
20970  
20971  B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
20972  
20973  =item Output File Glob
20974  
20975  "*", #1
20976  
20977  =item Returned Data
20978  
20979  =back
20980  
20981  =item EXAMPLES
20982  
20983  =over 4
20984  
20985  =item A Rename script
20986  
20987  =item A few example globmaps
20988  
20989  =back
20990  
20991  =item SEE ALSO
20992  
20993  =item AUTHOR
20994  
20995  =item COPYRIGHT AND LICENSE
20996  
20997  =back
20998  
20999  =head2 File::Path - Create or remove directory trees
21000  
21001  =over 4
21002  
21003  =item VERSION
21004  
21005  =item SYNOPSIS
21006  
21007  =item DESCRIPTION
21008  
21009  =over 4
21010  
21011  =item FUNCTIONS
21012  
21013  mode, verbose, error, verbose, safe, keep_root, result, error
21014  
21015  =item TRADITIONAL INTERFACE
21016  
21017  =item ERROR HANDLING
21018  
21019  =item NOTES
21020  
21021  =back
21022  
21023  =item DIAGNOSTICS
21024  
21025  mkdir [path]: [errmsg] (SEVERE), No root path(s) specified, No such file or
21026  directory, cannot fetch initial working directory: [errmsg], cannot stat
21027  initial working directory: [errmsg], cannot chdir to [dir]: [errmsg],
21028  directory [dir] changed before chdir, expected dev=[n] inode=[n], actual
21029  dev=[n] ino=[n], aborting. (FATAL), cannot make directory [dir]
21030  read+writeable: [errmsg], cannot read [dir]: [errmsg], cannot reset chmod
21031  [dir]: [errmsg], cannot chdir to [parent-dir] from [child-dir]: [errmsg],
21032  aborting. (FATAL), cannot stat prior working directory [dir]: [errmsg],
21033  aborting. (FATAL), previous directory [parent-dir] changed before entering
21034  [child-dir], expected dev=[n] inode=[n], actual dev=[n] ino=[n], aborting.
21035  (FATAL), cannot make directory [dir] writeable: [errmsg], cannot remove
21036  directory [dir]: [errmsg], cannot restore permissions of [dir] to [0nnn]:
21037  [errmsg], cannot make file [file] writeable: [errmsg], cannot unlink file
21038  [file]: [errmsg], cannot restore permissions of [file] to [0nnn]: [errmsg]
21039  
21040  =item SEE ALSO
21041  
21042  =item BUGS
21043  
21044  =item ACKNOWLEDGEMENTS
21045  
21046  =item AUTHORS
21047  
21048  =item COPYRIGHT
21049  
21050  =item LICENSE
21051  
21052  =back
21053  
21054  =head2 File::Spec - portably perform operations on file names
21055  
21056  =over 4
21057  
21058  =item SYNOPSIS
21059  
21060  =item DESCRIPTION
21061  
21062  =item METHODS
21063  
21064  canonpath X<canonpath>, catdir X<catdir>, catfile X<catfile>, curdir
21065  X<curdir>, devnull X<devnull>, rootdir X<rootdir>, tmpdir X<tmpdir>, updir
21066  X<updir>, no_upwards, case_tolerant, file_name_is_absolute, path X<path>,
21067  join X<join, path>, splitpath X<splitpath> X<split, path>, splitdir
21068  X<splitdir> X<split, dir>, catpath(), abs2rel X<abs2rel> X<absolute, path>
21069  X<relative, path>, rel2abs() X<rel2abs> X<absolute, path> X<relative, path>
21070  
21071  =item SEE ALSO
21072  
21073  =item AUTHOR
21074  
21075  =item COPYRIGHT
21076  
21077  =back
21078  
21079  =head2 File::Spec::Cygwin - methods for Cygwin file specs
21080  
21081  =over 4
21082  
21083  =item SYNOPSIS
21084  
21085  =item DESCRIPTION
21086  
21087  =back
21088  
21089  canonpath
21090  
21091  file_name_is_absolute
21092  
21093  tmpdir (override)
21094  
21095  case_tolerant
21096  
21097  =over 4
21098  
21099  =item COPYRIGHT
21100  
21101  =back
21102  
21103  =head2 File::Spec::Epoc - methods for Epoc file specs
21104  
21105  =over 4
21106  
21107  =item SYNOPSIS
21108  
21109  =item DESCRIPTION
21110  
21111  =back
21112  
21113  canonpath()
21114  
21115  =over 4
21116  
21117  =item AUTHOR
21118  
21119  =item COPYRIGHT
21120  
21121  =item SEE ALSO
21122  
21123  =back
21124  
21125  =head2 File::Spec::Functions - portably perform operations on file names
21126  
21127  =over 4
21128  
21129  =item SYNOPSIS
21130  
21131  =item DESCRIPTION
21132  
21133  =over 4
21134  
21135  =item Exports
21136  
21137  =back
21138  
21139  =item COPYRIGHT
21140  
21141  =item SEE ALSO
21142  
21143  =back
21144  
21145  =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
21146  
21147  =over 4
21148  
21149  =item SYNOPSIS
21150  
21151  =item DESCRIPTION
21152  
21153  =item METHODS
21154  
21155  canonpath
21156  
21157  =back
21158  
21159  catdir()
21160  
21161  catfile
21162  
21163  curdir
21164  
21165  devnull
21166  
21167  rootdir
21168  
21169  tmpdir
21170  
21171  updir
21172  
21173  file_name_is_absolute
21174  
21175  path
21176  
21177  splitpath
21178  
21179  splitdir
21180  
21181  catpath
21182  
21183  abs2rel
21184  
21185  rel2abs
21186  
21187  =over 4
21188  
21189  =item AUTHORS
21190  
21191  =item COPYRIGHT
21192  
21193  =item SEE ALSO
21194  
21195  =back
21196  
21197  =head2 File::Spec::OS2 - methods for OS/2 file specs
21198  
21199  =over 4
21200  
21201  =item SYNOPSIS
21202  
21203  =item DESCRIPTION
21204  
21205  tmpdir, splitpath
21206  
21207  =item COPYRIGHT
21208  
21209  =back
21210  
21211  =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
21212  modules
21213  
21214  =over 4
21215  
21216  =item SYNOPSIS
21217  
21218  =item DESCRIPTION
21219  
21220  =item METHODS
21221  
21222  canonpath()
21223  
21224  =back
21225  
21226  catdir()
21227  
21228  catfile
21229  
21230  curdir
21231  
21232  devnull
21233  
21234  rootdir
21235  
21236  tmpdir
21237  
21238  updir
21239  
21240  no_upwards
21241  
21242  case_tolerant
21243  
21244  file_name_is_absolute
21245  
21246  path
21247  
21248  join
21249  
21250  splitpath
21251  
21252  splitdir
21253  
21254  catpath()
21255  
21256  abs2rel
21257  
21258  rel2abs()
21259  
21260  =over 4
21261  
21262  =item COPYRIGHT
21263  
21264  =item SEE ALSO
21265  
21266  =back
21267  
21268  =head2 File::Spec::VMS - methods for VMS file specs
21269  
21270  =over 4
21271  
21272  =item SYNOPSIS
21273  
21274  =item DESCRIPTION
21275  
21276  canonpath (override)
21277  
21278  =back
21279  
21280  catdir (override)
21281  
21282  catfile (override)
21283  
21284  curdir (override)
21285  
21286  devnull (override)
21287  
21288  rootdir (override)
21289  
21290  tmpdir (override)
21291  
21292  updir (override)
21293  
21294  case_tolerant (override)
21295  
21296  path (override)
21297  
21298  file_name_is_absolute (override)
21299  
21300  splitpath (override)
21301  
21302  splitdir (override)
21303  
21304  catpath (override)
21305  
21306  abs2rel (override)
21307  
21308  rel2abs (override)
21309  
21310  =over 4
21311  
21312  =item COPYRIGHT
21313  
21314  =item SEE ALSO
21315  
21316  =back
21317  
21318  =head2 File::Spec::Win32 - methods for Win32 file specs
21319  
21320  =over 4
21321  
21322  =item SYNOPSIS
21323  
21324  =item DESCRIPTION
21325  
21326  devnull
21327  
21328  =back
21329  
21330  tmpdir
21331  
21332  case_tolerant
21333  
21334  file_name_is_absolute
21335  
21336  catfile
21337  
21338  canonpath
21339  
21340  splitpath
21341  
21342  splitdir
21343  
21344  catpath
21345  
21346  =over 4
21347  
21348  =item Note For File::Spec::Win32 Maintainers
21349  
21350  =back
21351  
21352  =over 4
21353  
21354  =item COPYRIGHT
21355  
21356  =item SEE ALSO
21357  
21358  =back
21359  
21360  =head2 File::Temp - return name and handle of a temporary file safely
21361  
21362  =over 4
21363  
21364  =item PORTABILITY
21365  
21366  =item SYNOPSIS
21367  
21368  =item DESCRIPTION
21369  
21370  =back
21371  
21372  =over 4
21373  
21374  =item OBJECT-ORIENTED INTERFACE
21375  
21376  B<new>
21377  
21378  =back
21379  
21380  B<filename>
21381  
21382  B<unlink_on_destroy>
21383  
21384  B<DESTROY>
21385  
21386  =over 4
21387  
21388  =item FUNCTIONS
21389  
21390  B<tempfile>
21391  
21392  =back
21393  
21394  B<tempdir>
21395  
21396  =over 4
21397  
21398  =item MKTEMP FUNCTIONS
21399  
21400  B<mkstemp>
21401  
21402  =back
21403  
21404  B<mkstemps>
21405  
21406  B<mkdtemp>
21407  
21408  B<mktemp>
21409  
21410  =over 4
21411  
21412  =item POSIX FUNCTIONS
21413  
21414  B<tmpnam>
21415  
21416  =back
21417  
21418  B<tmpfile>
21419  
21420  =over 4
21421  
21422  =item ADDITIONAL FUNCTIONS
21423  
21424  B<tempnam>
21425  
21426  =back
21427  
21428  =over 4
21429  
21430  =item UTILITY FUNCTIONS
21431  
21432  B<unlink0>
21433  
21434  =back
21435  
21436  B<cmpstat>
21437  
21438  B<unlink1>
21439  
21440  B<cleanup>
21441  
21442  =over 4
21443  
21444  =item PACKAGE VARIABLES
21445  
21446  B<safe_level>, STANDARD, MEDIUM, HIGH
21447  
21448  =back
21449  
21450  TopSystemUID
21451  
21452  B<$KEEP_ALL>, B<$DEBUG>
21453  
21454  =over 4
21455  
21456  =item WARNING
21457  
21458  =over 4
21459  
21460  =item Temporary files and NFS
21461  
21462  =item Forking
21463  
21464  =item BINMODE
21465  
21466  =back
21467  
21468  =item HISTORY
21469  
21470  =item SEE ALSO
21471  
21472  =item AUTHOR
21473  
21474  =back
21475  
21476  =head2 File::stat - by-name interface to Perl's built-in stat() functions
21477  
21478  =over 4
21479  
21480  =item SYNOPSIS
21481  
21482  =item DESCRIPTION
21483  
21484  =item BUGS
21485  
21486  =item NOTE
21487  
21488  =item AUTHOR
21489  
21490  =back
21491  
21492  =head2 FileCache - keep more files open than the system permits
21493  
21494  =over 4
21495  
21496  =item SYNOPSIS
21497  
21498  =item DESCRIPTION
21499  
21500  cacheout EXPR, cacheout MODE, EXPR
21501  
21502  =item CAVEATS
21503  
21504  =item BUGS
21505  
21506  =back
21507  
21508  =head2 FileHandle - supply object methods for filehandles
21509  
21510  =over 4
21511  
21512  =item SYNOPSIS
21513  
21514  =item DESCRIPTION
21515  
21516  $fh->print, $fh->printf, $fh->getline, $fh->getlines
21517  
21518  =item SEE ALSO
21519  
21520  =back
21521  
21522  =head2 Filter::Simple - Simplified source filtering
21523  
21524  =over 4
21525  
21526  =item SYNOPSIS
21527  
21528  =item DESCRIPTION
21529  
21530  =over 4
21531  
21532  =item The Problem
21533  
21534  =item A Solution
21535  
21536  =item Disabling or changing <no> behaviour
21537  
21538  =item All-in-one interface
21539  
21540  =item Filtering only specific components of source code
21541  
21542  C<"code">, C<"code_no_comments">, C<"executable">,
21543  C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
21544  C<"all">
21545  
21546  =item Filtering only the code parts of source code
21547  
21548  Most source code ceases to be grammatically correct when it is broken up
21549  into the pieces between string literals and regexes. So the C<'code'>
21550  and C<'code_no_comments'> component filter behave slightly differently
21551  from the other partial filters described in the previous section.
21552  
21553  =item Using Filter::Simple with an explicit C<import> subroutine
21554  
21555  =item Using Filter::Simple and Exporter together
21556  
21557  =item How it works
21558  
21559  =back
21560  
21561  =item AUTHOR
21562  
21563  =item COPYRIGHT
21564  
21565  =back
21566  
21567  =head2 Filter::Util::Call - Perl Source Filter Utility Module
21568  
21569  =over 4
21570  
21571  =item SYNOPSIS
21572  
21573  =item DESCRIPTION
21574  
21575  =over 4
21576  
21577  =item B<use Filter::Util::Call>
21578  
21579  =item B<import()>
21580  
21581  =item B<filter() and anonymous sub>
21582  
21583  B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
21584  
21585  =back
21586  
21587  =item EXAMPLES
21588  
21589  =over 4
21590  
21591  =item Example 1: A simple filter.
21592  
21593  =item Example 2: Using the context
21594  
21595  =item Example 3: Using the context within the filter
21596  
21597  =item Example 4: Using filter_del
21598  
21599  =back
21600  
21601  =item Filter::Simple
21602  
21603  =item AUTHOR
21604  
21605  =item DATE
21606  
21607  =back
21608  
21609  =head2 FindBin - Locate directory of original perl script
21610  
21611  =over 4
21612  
21613  =item SYNOPSIS
21614  
21615  =item DESCRIPTION
21616  
21617  =item EXPORTABLE VARIABLES
21618  
21619  =item KNOWN ISSUES
21620  
21621  =item KNOWN BUGS
21622  
21623  =item AUTHORS
21624  
21625  =item COPYRIGHT
21626  
21627  =back
21628  
21629  =head2 GDBM_File - Perl5 access to the gdbm library.
21630  
21631  =over 4
21632  
21633  =item SYNOPSIS
21634  
21635  =item DESCRIPTION
21636  
21637  =item AVAILABILITY
21638  
21639  =item BUGS
21640  
21641  =item SEE ALSO
21642  
21643  =back
21644  
21645  =head2 Getopt::Long - Extended processing of command line options
21646  
21647  =over 4
21648  
21649  =item SYNOPSIS
21650  
21651  =item DESCRIPTION
21652  
21653  =item Command Line Options, an Introduction
21654  
21655  =item Getting Started with Getopt::Long
21656  
21657  =over 4
21658  
21659  =item Simple options
21660  
21661  =item A little bit less simple options
21662  
21663  =item Mixing command line option with other arguments
21664  
21665  =item Options with values
21666  
21667  =item Options with multiple values
21668  
21669  =item Options with hash values
21670  
21671  =item User-defined subroutines to handle options
21672  
21673  =item Options with multiple names
21674  
21675  =item Case and abbreviations
21676  
21677  =item Summary of Option Specifications
21678  
21679  !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
21680  + [ I<desttype> ]
21681  
21682  =back
21683  
21684  =item Advanced Possibilities
21685  
21686  =over 4
21687  
21688  =item Object oriented interface
21689  
21690  =item Thread Safety
21691  
21692  =item Documentation and help texts
21693  
21694  =item Parsing options from an arbitrary array
21695  
21696  =item Parsing options from an arbitrary string
21697  
21698  =item Storing options values in a hash
21699  
21700  =item Bundling
21701  
21702  =item The lonesome dash
21703  
21704  =item Argument callback
21705  
21706  =back
21707  
21708  =item Configuring Getopt::Long
21709  
21710  default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
21711  require_order, permute, bundling (default: disabled), bundling_override
21712  (default: disabled), ignore_case  (default: enabled), ignore_case_always
21713  (default: disabled), auto_version (default:disabled), auto_help
21714  (default:disabled), pass_through (default: disabled), prefix,
21715  prefix_pattern, long_prefix_pattern, debug (default: disabled)
21716  
21717  =item Exportable Methods
21718  
21719  VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
21720  
21721  =item Return values and Errors
21722  
21723  =item Legacy
21724  
21725  =over 4
21726  
21727  =item Default destinations
21728  
21729  =item Alternative option starters
21730  
21731  =item Configuration variables
21732  
21733  =back
21734  
21735  =item Tips and Techniques
21736  
21737  =over 4
21738  
21739  =item Pushing multiple values in a hash option
21740  
21741  =back
21742  
21743  =item Trouble Shooting
21744  
21745  =over 4
21746  
21747  =item GetOptions does not return a false result when an option is not
21748  supplied
21749  
21750  =item GetOptions does not split the command line correctly
21751  
21752  =item Undefined subroutine &main::GetOptions called
21753  
21754  =item How do I put a "-?" option into a Getopt::Long?
21755  
21756  =back
21757  
21758  =item AUTHOR
21759  
21760  =item COPYRIGHT AND DISCLAIMER
21761  
21762  =back
21763  
21764  =head2 Getopt::Std, getopt, getopts - Process single-character switches
21765  with switch clustering
21766  
21767  =over 4
21768  
21769  =item SYNOPSIS
21770  
21771  =item DESCRIPTION
21772  
21773  =item C<--help> and C<--version>
21774  
21775  =back
21776  
21777  =head2 Hash::Util - A selection of general-utility hash subroutines
21778  
21779  =over 4
21780  
21781  =item SYNOPSIS
21782  
21783  =item DESCRIPTION
21784  
21785  =over 4
21786  
21787  =item Restricted hashes
21788  
21789  B<lock_keys>, B<unlock_keys>
21790  
21791  =back
21792  
21793  =back
21794  
21795  B<lock_keys_plus>
21796  
21797  B<lock_value>, B<unlock_value>
21798  
21799  B<lock_hash>, B<unlock_hash>
21800  
21801  B<lock_hash_recurse>, B<unlock_hash_recurse>
21802  
21803  B<hash_unlocked>
21804  
21805  B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
21806  
21807  B<hv_store>
21808  
21809  =over 4
21810  
21811  =item Operating on references to hashes.
21812  
21813  lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
21814  unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
21815  unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
21816  
21817  =back
21818  
21819  =over 4
21820  
21821  =item CAVEATS
21822  
21823  =item BUGS
21824  
21825  =item AUTHOR
21826  
21827  =item SEE ALSO
21828  
21829  =back
21830  
21831  =head2 Hash::Util::FieldHash - Support for Inside-Out Classes
21832  
21833  =over 4
21834  
21835  =item SYNOPSIS
21836  
21837  =item FUNCTIONS
21838  
21839  id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes
21840  
21841  =item DESCRIPTION
21842  
21843  =over 4
21844  
21845  =item The Inside-out Technique
21846  
21847  =item Problems of Inside-out
21848  
21849  =item Solutions
21850  
21851  =item More Problems
21852  
21853  =item The Generic Object
21854  
21855  =item How to use Field Hashes
21856  
21857  =item Garbage-Collected Hashes
21858  
21859  =back
21860  
21861  =item EXAMPLES
21862  
21863  C<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>,
21864  C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash>
21865  
21866  =over 4
21867  
21868  =item Example 1
21869  
21870  =item Example 2
21871  
21872  =back
21873  
21874  =item GUTS
21875  
21876  =over 4
21877  
21878  =item The C<PERL_MAGIC_uvar> interface for hashes
21879  
21880  =item Weakrefs call uvar magic
21881  
21882  =item How field hashes work
21883  
21884  =item Internal function Hash::Util::FieldHash::_fieldhash
21885  
21886  =back
21887  
21888  =item AUTHOR
21889  
21890  =item COPYRIGHT AND LICENSE
21891  
21892  =back
21893  
21894  =head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash,
21895  Hash::Util::FieldHash - Support for Inside-Out Classes
21896  
21897  =over 4
21898  
21899  =item SYNOPSIS
21900  
21901  =item FUNCTIONS
21902  
21903  id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes
21904  
21905  =item DESCRIPTION
21906  
21907  =over 4
21908  
21909  =item The Inside-out Technique
21910  
21911  =item Problems of Inside-out
21912  
21913  =item Solutions
21914  
21915  =item More Problems
21916  
21917  =item The Generic Object
21918  
21919  =item How to use Field Hashes
21920  
21921  =item Garbage-Collected Hashes
21922  
21923  =back
21924  
21925  =item EXAMPLES
21926  
21927  C<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>,
21928  C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash>
21929  
21930  =over 4
21931  
21932  =item Example 1
21933  
21934  =item Example 2
21935  
21936  =back
21937  
21938  =item GUTS
21939  
21940  =over 4
21941  
21942  =item The C<PERL_MAGIC_uvar> interface for hashes
21943  
21944  =item Weakrefs call uvar magic
21945  
21946  =item How field hashes work
21947  
21948  =item Internal function Hash::Util::FieldHash::_fieldhash
21949  
21950  =back
21951  
21952  =item AUTHOR
21953  
21954  =item COPYRIGHT AND LICENSE
21955  
21956  =back
21957  
21958  =head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of
21959  general-utility hash subroutines
21960  
21961  =over 4
21962  
21963  =item SYNOPSIS
21964  
21965  =item DESCRIPTION
21966  
21967  =over 4
21968  
21969  =item Restricted hashes
21970  
21971  B<lock_keys>, B<unlock_keys>
21972  
21973  =back
21974  
21975  =back
21976  
21977  B<lock_keys_plus>
21978  
21979  B<lock_value>, B<unlock_value>
21980  
21981  B<lock_hash>, B<unlock_hash>
21982  
21983  B<lock_hash_recurse>, B<unlock_hash_recurse>
21984  
21985  B<hash_unlocked>
21986  
21987  B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
21988  
21989  B<hv_store>
21990  
21991  =over 4
21992  
21993  =item Operating on references to hashes.
21994  
21995  lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
21996  unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
21997  unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
21998  
21999  =back
22000  
22001  =over 4
22002  
22003  =item CAVEATS
22004  
22005  =item BUGS
22006  
22007  =item AUTHOR
22008  
22009  =item SEE ALSO
22010  
22011  =back
22012  
22013  =head2 I18N::Collate - compare 8-bit scalar data according to the current
22014  locale
22015  
22016  =over 4
22017  
22018  =item SYNOPSIS
22019  
22020  =item DESCRIPTION
22021  
22022  =back
22023  
22024  =head2 I18N::LangTags - functions for dealing with RFC3066-style language
22025  tags
22026  
22027  =over 4
22028  
22029  =item SYNOPSIS
22030  
22031  =item DESCRIPTION
22032  
22033  =back
22034  
22035  the function is_language_tag($lang1)
22036  
22037  the function extract_language_tags($whatever)
22038  
22039  the function same_language_tag($lang1, $lang2)
22040  
22041  the function similarity_language_tag($lang1, $lang2)
22042  
22043  the function is_dialect_of($lang1, $lang2)
22044  
22045  the function super_languages($lang1)
22046  
22047  the function locale2language_tag($locale_identifier)
22048  
22049  the function encode_language_tag($lang1)
22050  
22051  the function alternate_language_tags($lang1)
22052  
22053  the function @langs = panic_languages(@accept_languages)
22054  
22055  the function implicate_supers( ...languages... ), the function
22056  implicate_supers_strictly( ...languages... )
22057  
22058  =over 4
22059  
22060  =item ABOUT LOWERCASING
22061  
22062  =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
22063  
22064  =item SEE ALSO
22065  
22066  =item COPYRIGHT
22067  
22068  =item AUTHOR
22069  
22070  =back
22071  
22072  =head2 I18N::LangTags::Detect - detect the user's language preferences
22073  
22074  =over 4
22075  
22076  =item SYNOPSIS
22077  
22078  =item DESCRIPTION
22079  
22080  =item FUNCTIONS
22081  
22082  =item ENVIRONMENT
22083  
22084  =item SEE ALSO
22085  
22086  =item COPYRIGHT
22087  
22088  =item AUTHOR
22089  
22090  =back
22091  
22092  =head2 I18N::LangTags::List -- tags and names for human languages
22093  
22094  =over 4
22095  
22096  =item SYNOPSIS
22097  
22098  =item DESCRIPTION
22099  
22100  =item ABOUT LANGUAGE TAGS
22101  
22102  =item LIST OF LANGUAGES
22103  
22104  {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
22105  Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
22106  Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
22107  {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
22108  {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
22109  {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
22110  : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
22111  Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
22112  Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
22113  : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
22114  Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
22115  : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
22116  Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
22117  Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
22118  (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
22119  {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
22120  Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
22121  Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
22122  (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
22123  American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
22124  {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
22125  : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
22126  Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
22127  Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
22128  {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
22129  : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
22130  Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
22131  Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
22132  Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
22133  Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
22134  {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
22135  {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
22136  : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
22137  English, {enm} : Old English (1100-1500), {ang} : Old English
22138  (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
22139  Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
22140  : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
22141  Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
22142  (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
22143  Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
22144  {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
22145  {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
22146  German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
22147  : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
22148  Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
22149  Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
22150  {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
22151  Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
22152  {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
22153  {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
22154  (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
22155  (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
22156  Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
22157  Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
22158  languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
22159  Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
22160  {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
22161  Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
22162  : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
22163  {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
22164  {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
22165  {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
22166  Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
22167  {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
22168  Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
22169  Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
22170  Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
22171  (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
22172  : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
22173  {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
22174  {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
22175  Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
22176  Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
22177  Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
22178  [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
22179  Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
22180  Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
22181  {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
22182  languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
22183  {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
22184  {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
22185  Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
22186  {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
22187  Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
22188  Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
22189  : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
22190  Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
22191  languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
22192  Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
22193  Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
22194  (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
22195  : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
22196  {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
22197  Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
22198  [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
22199  Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
22200  languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
22201  Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
22202  [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
22203  Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
22204  {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
22205  {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
22206  Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
22207  Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
22208  (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
22209  {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
22210  Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
22211  South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
22212  Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
22213  {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
22214  Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
22215  {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
22216  Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
22217  Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
22218  {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
22219  {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
22220  Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
22221  : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
22222  Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
22223  {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
22224  Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
22225  : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
22226  : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
22227  Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
22228  Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
22229  : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
22230  {zun} : Zuni
22231  
22232  =item SEE ALSO
22233  
22234  =item COPYRIGHT AND DISCLAIMER
22235  
22236  =item AUTHOR
22237  
22238  =back
22239  
22240  =head2 I18N::Langinfo - query locale information
22241  
22242  =over 4
22243  
22244  =item SYNOPSIS
22245  
22246  =item DESCRIPTION
22247  
22248  =over 4
22249  
22250  =item EXPORT
22251  
22252  =back
22253  
22254  =item SEE ALSO
22255  
22256  =item AUTHOR
22257  
22258  =item COPYRIGHT AND LICENSE
22259  
22260  =back
22261  
22262  =head2 IO - load various IO modules
22263  
22264  =over 4
22265  
22266  =item SYNOPSIS
22267  
22268  =item DESCRIPTION
22269  
22270  =item DEPRECATED
22271  
22272  =back
22273  
22274  =head2 IO::Compress::Base - Base Class for IO::Compress modules 
22275  
22276  =over 4
22277  
22278  =item SYNOPSIS
22279  
22280  =item DESCRIPTION
22281  
22282  =item SEE ALSO
22283  
22284  =item AUTHOR
22285  
22286  =item MODIFICATION HISTORY
22287  
22288  =item COPYRIGHT AND LICENSE
22289  
22290  =back
22291  
22292  =head2 IO::Compress::Deflate - Write RFC 1950 files/buffers
22293  
22294  =over 4
22295  
22296  =item SYNOPSIS
22297  
22298  =item DESCRIPTION
22299  
22300  =item Functional Interface
22301  
22302  =over 4
22303  
22304  =item deflate $input => $output [, OPTS]
22305  
22306  A filename, A filehandle, A scalar reference, An array reference, An Input
22307  FileGlob string, A filename, A filehandle, A scalar reference, An Array
22308  Reference, An Output FileGlob
22309  
22310  =item Notes
22311  
22312  =item Optional Parameters
22313  
22314  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
22315  
22316  =item Examples
22317  
22318  =back
22319  
22320  =item OO Interface
22321  
22322  =over 4
22323  
22324  =item Constructor
22325  
22326  A filename, A filehandle, A scalar reference
22327  
22328  =item Constructor Options
22329  
22330  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
22331  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
22332  
22333  =item Examples
22334  
22335  =back
22336  
22337  =item Methods 
22338  
22339  =over 4
22340  
22341  =item print
22342  
22343  =item printf
22344  
22345  =item syswrite
22346  
22347  =item write
22348  
22349  =item flush
22350  
22351  =item tell
22352  
22353  =item eof
22354  
22355  =item seek
22356  
22357  =item binmode
22358  
22359  =item opened
22360  
22361  =item autoflush
22362  
22363  =item input_line_number
22364  
22365  =item fileno
22366  
22367  =item close
22368  
22369  =item newStream([OPTS])
22370  
22371  =item deflateParams
22372  
22373  =back
22374  
22375  =item Importing 
22376  
22377  :all, :constants, :flush, :level, :strategy
22378  
22379  =item EXAMPLES
22380  
22381  =item SEE ALSO
22382  
22383  =item AUTHOR
22384  
22385  =item MODIFICATION HISTORY
22386  
22387  =item COPYRIGHT AND LICENSE
22388  
22389  =back
22390  
22391  =head2 IO::Compress::Gzip - Write RFC 1952 files/buffers
22392  
22393  =over 4
22394  
22395  =item SYNOPSIS
22396  
22397  =item DESCRIPTION
22398  
22399  =item Functional Interface
22400  
22401  =over 4
22402  
22403  =item gzip $input => $output [, OPTS]
22404  
22405  A filename, A filehandle, A scalar reference, An array reference, An Input
22406  FileGlob string, A filename, A filehandle, A scalar reference, An Array
22407  Reference, An Output FileGlob
22408  
22409  =item Notes
22410  
22411  =item Optional Parameters
22412  
22413  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
22414  
22415  =item Examples
22416  
22417  =back
22418  
22419  =item OO Interface
22420  
22421  =over 4
22422  
22423  =item Constructor
22424  
22425  A filename, A filehandle, A scalar reference
22426  
22427  =item Constructor Options
22428  
22429  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
22430  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
22431  C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
22432  C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
22433  C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
22434  >>
22435  
22436  =item Examples
22437  
22438  =back
22439  
22440  =item Methods 
22441  
22442  =over 4
22443  
22444  =item print
22445  
22446  =item printf
22447  
22448  =item syswrite
22449  
22450  =item write
22451  
22452  =item flush
22453  
22454  =item tell
22455  
22456  =item eof
22457  
22458  =item seek
22459  
22460  =item binmode
22461  
22462  =item opened
22463  
22464  =item autoflush
22465  
22466  =item input_line_number
22467  
22468  =item fileno
22469  
22470  =item close
22471  
22472  =item newStream([OPTS])
22473  
22474  =item deflateParams
22475  
22476  =back
22477  
22478  =item Importing 
22479  
22480  :all, :constants, :flush, :level, :strategy
22481  
22482  =item EXAMPLES
22483  
22484  =item SEE ALSO
22485  
22486  =item AUTHOR
22487  
22488  =item MODIFICATION HISTORY
22489  
22490  =item COPYRIGHT AND LICENSE
22491  
22492  =back
22493  
22494  =head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
22495  
22496  =over 4
22497  
22498  =item SYNOPSIS
22499  
22500  =item DESCRIPTION
22501  
22502  =item Functional Interface
22503  
22504  =over 4
22505  
22506  =item rawdeflate $input => $output [, OPTS]
22507  
22508  A filename, A filehandle, A scalar reference, An array reference, An Input
22509  FileGlob string, A filename, A filehandle, A scalar reference, An Array
22510  Reference, An Output FileGlob
22511  
22512  =item Notes
22513  
22514  =item Optional Parameters
22515  
22516  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
22517  
22518  =item Examples
22519  
22520  =back
22521  
22522  =item OO Interface
22523  
22524  =over 4
22525  
22526  =item Constructor
22527  
22528  A filename, A filehandle, A scalar reference
22529  
22530  =item Constructor Options
22531  
22532  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
22533  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
22534  
22535  =item Examples
22536  
22537  =back
22538  
22539  =item Methods 
22540  
22541  =over 4
22542  
22543  =item print
22544  
22545  =item printf
22546  
22547  =item syswrite
22548  
22549  =item write
22550  
22551  =item flush
22552  
22553  =item tell
22554  
22555  =item eof
22556  
22557  =item seek
22558  
22559  =item binmode
22560  
22561  =item opened
22562  
22563  =item autoflush
22564  
22565  =item input_line_number
22566  
22567  =item fileno
22568  
22569  =item close
22570  
22571  =item newStream([OPTS])
22572  
22573  =item deflateParams
22574  
22575  =back
22576  
22577  =item Importing 
22578  
22579  :all, :constants, :flush, :level, :strategy
22580  
22581  =item EXAMPLES
22582  
22583  =item SEE ALSO
22584  
22585  =item AUTHOR
22586  
22587  =item MODIFICATION HISTORY
22588  
22589  =item COPYRIGHT AND LICENSE
22590  
22591  =back
22592  
22593  =head2 IO::Compress::Zip - Write zip files/buffers
22594  
22595  =over 4
22596  
22597  =item SYNOPSIS
22598  
22599  =item DESCRIPTION
22600  
22601  =item Functional Interface
22602  
22603  =over 4
22604  
22605  =item zip $input => $output [, OPTS]
22606  
22607  A filename, A filehandle, A scalar reference, An array reference, An Input
22608  FileGlob string, A filename, A filehandle, A scalar reference, An Array
22609  Reference, An Output FileGlob
22610  
22611  =item Notes
22612  
22613  =item Optional Parameters
22614  
22615  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
22616  
22617  =item Examples
22618  
22619  =back
22620  
22621  =item OO Interface
22622  
22623  =over 4
22624  
22625  =item Constructor
22626  
22627  A filename, A filehandle, A scalar reference
22628  
22629  =item Constructor Options
22630  
22631  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
22632  Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
22633  $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment =>
22634  $comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<<
22635  Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<<
22636  ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<<
22637  Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number
22638  >>, -Level, -Strategy, C<< Strict => 0|1 >>
22639  
22640  =item Examples
22641  
22642  =back
22643  
22644  =item Methods 
22645  
22646  =over 4
22647  
22648  =item print
22649  
22650  =item printf
22651  
22652  =item syswrite
22653  
22654  =item write
22655  
22656  =item flush
22657  
22658  =item tell
22659  
22660  =item eof
22661  
22662  =item seek
22663  
22664  =item binmode
22665  
22666  =item opened
22667  
22668  =item autoflush
22669  
22670  =item input_line_number
22671  
22672  =item fileno
22673  
22674  =item close
22675  
22676  =item newStream([OPTS])
22677  
22678  =item deflateParams
22679  
22680  =back
22681  
22682  =item Importing 
22683  
22684  :all, :constants, :flush, :level, :strategy, :zip_method
22685  
22686  =item EXAMPLES
22687  
22688  =item SEE ALSO
22689  
22690  =item AUTHOR
22691  
22692  =item MODIFICATION HISTORY
22693  
22694  =item COPYRIGHT AND LICENSE
22695  
22696  =back
22697  
22698  =head2 IO::Dir - supply object methods for directory handles
22699  
22700  =over 4
22701  
22702  =item SYNOPSIS
22703  
22704  =item DESCRIPTION
22705  
22706  new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
22707  rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
22708  
22709  =item SEE ALSO
22710  
22711  =item AUTHOR
22712  
22713  =item COPYRIGHT
22714  
22715  =back
22716  
22717  =head2 IO::File - supply object methods for filehandles
22718  
22719  =over 4
22720  
22721  =item SYNOPSIS
22722  
22723  =item DESCRIPTION
22724  
22725  =item CONSTRUCTOR
22726  
22727  new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
22728  
22729  =item METHODS
22730  
22731  open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
22732  [LAYER] )
22733  
22734  =item NOTE
22735  
22736  =item SEE ALSO
22737  
22738  =item HISTORY
22739  
22740  =back
22741  
22742  =head2 IO::Handle - supply object methods for I/O handles
22743  
22744  =over 4
22745  
22746  =item SYNOPSIS
22747  
22748  =item DESCRIPTION
22749  
22750  =item CONSTRUCTOR
22751  
22752  new (), new_from_fd ( FD, MODE )
22753  
22754  =item METHODS
22755  
22756  $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
22757  $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
22758  $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
22759  $io->blocking ( [ BOOL ] ), $io->untaint
22760  
22761  =item NOTE
22762  
22763  =item SEE ALSO
22764  
22765  =item BUGS
22766  
22767  =item HISTORY
22768  
22769  =back
22770  
22771  =head2 IO::Pipe - supply object methods for pipes
22772  
22773  =over 4
22774  
22775  =item SYNOPSIS
22776  
22777  =item DESCRIPTION
22778  
22779  =item CONSTRUCTOR
22780  
22781  new ( [READER, WRITER] )
22782  
22783  =item METHODS
22784  
22785  reader ([ARGS]), writer ([ARGS]), handles ()
22786  
22787  =item SEE ALSO
22788  
22789  =item AUTHOR
22790  
22791  =item COPYRIGHT
22792  
22793  =back
22794  
22795  =head2 IO::Poll - Object interface to system poll call
22796  
22797  =over 4
22798  
22799  =item SYNOPSIS
22800  
22801  =item DESCRIPTION
22802  
22803  =item METHODS
22804  
22805  mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
22806  IO ), handles( [ EVENT_MASK ] )
22807  
22808  =item SEE ALSO
22809  
22810  =item AUTHOR
22811  
22812  =item COPYRIGHT
22813  
22814  =back
22815  
22816  =head2 IO::Seekable - supply seek based methods for I/O objects
22817  
22818  =over 4
22819  
22820  =item SYNOPSIS
22821  
22822  =item DESCRIPTION
22823  
22824  $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
22825  WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
22826  $io->tell
22827  
22828  =item SEE ALSO
22829  
22830  =item HISTORY
22831  
22832  =back
22833  
22834  =head2 IO::Select - OO interface to the select system call
22835  
22836  =over 4
22837  
22838  =item SYNOPSIS
22839  
22840  =item DESCRIPTION
22841  
22842  =item CONSTRUCTOR
22843  
22844  new ( [ HANDLES ] )
22845  
22846  =item METHODS
22847  
22848  add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
22849  [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
22850  count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
22851  
22852  =item EXAMPLE
22853  
22854  =item AUTHOR
22855  
22856  =item COPYRIGHT
22857  
22858  =back
22859  
22860  =head2 IO::Socket - Object interface to socket communications
22861  
22862  =over 4
22863  
22864  =item SYNOPSIS
22865  
22866  =item DESCRIPTION
22867  
22868  =item CONSTRUCTOR
22869  
22870  new ( [ARGS] )
22871  
22872  =item METHODS
22873  
22874  accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
22875  protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
22876  
22877  =item SEE ALSO
22878  
22879  =item AUTHOR
22880  
22881  =item COPYRIGHT
22882  
22883  =back
22884  
22885  =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
22886  
22887  =over 4
22888  
22889  =item SYNOPSIS
22890  
22891  =item DESCRIPTION
22892  
22893  =item CONSTRUCTOR
22894  
22895  new ( [ARGS] )
22896  
22897  =over 4
22898  
22899  =item METHODS
22900  
22901  sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
22902  ()
22903  
22904  =back
22905  
22906  =item SEE ALSO
22907  
22908  =item AUTHOR
22909  
22910  =item COPYRIGHT
22911  
22912  =back
22913  
22914  =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
22915  
22916  =over 4
22917  
22918  =item SYNOPSIS
22919  
22920  =item DESCRIPTION
22921  
22922  =item CONSTRUCTOR
22923  
22924  new ( [ARGS] )
22925  
22926  =item METHODS
22927  
22928  hostpath(), peerpath()
22929  
22930  =item SEE ALSO
22931  
22932  =item AUTHOR
22933  
22934  =item COPYRIGHT
22935  
22936  =back
22937  
22938  =head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip)
22939  file/buffer
22940  
22941  =over 4
22942  
22943  =item SYNOPSIS
22944  
22945  =item DESCRIPTION
22946  
22947  RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
22948  
22949  =item Functional Interface
22950  
22951  =over 4
22952  
22953  =item anyinflate $input => $output [, OPTS]
22954  
22955  A filename, A filehandle, A scalar reference, An array reference, An Input
22956  FileGlob string, A filename, A filehandle, A scalar reference, An Array
22957  Reference, An Output FileGlob
22958  
22959  =item Notes
22960  
22961  =item Optional Parameters
22962  
22963  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22964  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22965  
22966  =item Examples
22967  
22968  =back
22969  
22970  =item OO Interface
22971  
22972  =over 4
22973  
22974  =item Constructor
22975  
22976  A filename, A filehandle, A scalar reference
22977  
22978  =item Constructor Options
22979  
22980  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22981  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22982  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
22983  >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
22984  this option is set, it will force the module to check that it conforms to
22985  the sub-field structure as defined in RFC 1952
22986  
22987  =item Examples
22988  
22989  =back
22990  
22991  =item Methods 
22992  
22993  =over 4
22994  
22995  =item read
22996  
22997  =item read
22998  
22999  =item getline
23000  
23001  =item getc
23002  
23003  =item ungetc
23004  
23005  =item inflateSync
23006  
23007  =item getHeaderInfo
23008  
23009  =item tell
23010  
23011  =item eof
23012  
23013  =item seek
23014  
23015  =item binmode
23016  
23017  =item opened
23018  
23019  =item autoflush
23020  
23021  =item input_line_number
23022  
23023  =item fileno
23024  
23025  =item close
23026  
23027  =item nextStream
23028  
23029  =item trailingData
23030  
23031  =back
23032  
23033  =item Importing 
23034  
23035  :all
23036  
23037  =item EXAMPLES
23038  
23039  =item SEE ALSO
23040  
23041  =item AUTHOR
23042  
23043  =item MODIFICATION HISTORY
23044  
23045  =item COPYRIGHT AND LICENSE
23046  
23047  =back
23048  
23049  =head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
23050  file/buffer
23051  
23052  =over 4
23053  
23054  =item SYNOPSIS
23055  
23056  =item DESCRIPTION
23057  
23058  RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
23059  
23060  =item Functional Interface
23061  
23062  =over 4
23063  
23064  =item anyuncompress $input => $output [, OPTS]
23065  
23066  A filename, A filehandle, A scalar reference, An array reference, An Input
23067  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23068  Reference, An Output FileGlob
23069  
23070  =item Notes
23071  
23072  =item Optional Parameters
23073  
23074  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23075  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23076  
23077  =item Examples
23078  
23079  =back
23080  
23081  =item OO Interface
23082  
23083  =over 4
23084  
23085  =item Constructor
23086  
23087  A filename, A filehandle, A scalar reference
23088  
23089  =item Constructor Options
23090  
23091  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23092  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23093  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
23094  >>
23095  
23096  =item Examples
23097  
23098  =back
23099  
23100  =item Methods 
23101  
23102  =over 4
23103  
23104  =item read
23105  
23106  =item read
23107  
23108  =item getline
23109  
23110  =item getc
23111  
23112  =item ungetc
23113  
23114  =item getHeaderInfo
23115  
23116  =item tell
23117  
23118  =item eof
23119  
23120  =item seek
23121  
23122  =item binmode
23123  
23124  =item opened
23125  
23126  =item autoflush
23127  
23128  =item input_line_number
23129  
23130  =item fileno
23131  
23132  =item close
23133  
23134  =item nextStream
23135  
23136  =item trailingData
23137  
23138  =back
23139  
23140  =item Importing 
23141  
23142  :all
23143  
23144  =item EXAMPLES
23145  
23146  =item SEE ALSO
23147  
23148  =item AUTHOR
23149  
23150  =item MODIFICATION HISTORY
23151  
23152  =item COPYRIGHT AND LICENSE
23153  
23154  =back
23155  
23156  =head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules 
23157  
23158  =over 4
23159  
23160  =item SYNOPSIS
23161  
23162  =item DESCRIPTION
23163  
23164  =item SEE ALSO
23165  
23166  =item AUTHOR
23167  
23168  =item MODIFICATION HISTORY
23169  
23170  =item COPYRIGHT AND LICENSE
23171  
23172  =back
23173  
23174  =head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers
23175  
23176  =over 4
23177  
23178  =item SYNOPSIS
23179  
23180  =item DESCRIPTION
23181  
23182  =item Functional Interface
23183  
23184  =over 4
23185  
23186  =item gunzip $input => $output [, OPTS]
23187  
23188  A filename, A filehandle, A scalar reference, An array reference, An Input
23189  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23190  Reference, An Output FileGlob
23191  
23192  =item Notes
23193  
23194  =item Optional Parameters
23195  
23196  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23197  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23198  
23199  =item Examples
23200  
23201  =back
23202  
23203  =item OO Interface
23204  
23205  =over 4
23206  
23207  =item Constructor
23208  
23209  A filename, A filehandle, A scalar reference
23210  
23211  =item Constructor Options
23212  
23213  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23214  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23215  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
23216  >> If the gzip FEXTRA header field is present and this option is set, it
23217  will force the module to check that it conforms to the sub-field structure
23218  as defined in RFC 1952
23219  
23220  =item Examples
23221  
23222  =back
23223  
23224  =item Methods 
23225  
23226  =over 4
23227  
23228  =item read
23229  
23230  =item read
23231  
23232  =item getline
23233  
23234  =item getc
23235  
23236  =item ungetc
23237  
23238  =item inflateSync
23239  
23240  =item getHeaderInfo
23241  
23242  Name, Comment
23243  
23244  =item tell
23245  
23246  =item eof
23247  
23248  =item seek
23249  
23250  =item binmode
23251  
23252  =item opened
23253  
23254  =item autoflush
23255  
23256  =item input_line_number
23257  
23258  =item fileno
23259  
23260  =item close
23261  
23262  =item nextStream
23263  
23264  =item trailingData
23265  
23266  =back
23267  
23268  =item Importing 
23269  
23270  :all
23271  
23272  =item EXAMPLES
23273  
23274  =item SEE ALSO
23275  
23276  =item AUTHOR
23277  
23278  =item MODIFICATION HISTORY
23279  
23280  =item COPYRIGHT AND LICENSE
23281  
23282  =back
23283  
23284  =head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers
23285  
23286  =over 4
23287  
23288  =item SYNOPSIS
23289  
23290  =item DESCRIPTION
23291  
23292  =item Functional Interface
23293  
23294  =over 4
23295  
23296  =item inflate $input => $output [, OPTS]
23297  
23298  A filename, A filehandle, A scalar reference, An array reference, An Input
23299  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23300  Reference, An Output FileGlob
23301  
23302  =item Notes
23303  
23304  =item Optional Parameters
23305  
23306  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23307  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23308  
23309  =item Examples
23310  
23311  =back
23312  
23313  =item OO Interface
23314  
23315  =over 4
23316  
23317  =item Constructor
23318  
23319  A filename, A filehandle, A scalar reference
23320  
23321  =item Constructor Options
23322  
23323  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23324  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23325  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23326  
23327  =item Examples
23328  
23329  =back
23330  
23331  =item Methods 
23332  
23333  =over 4
23334  
23335  =item read
23336  
23337  =item read
23338  
23339  =item getline
23340  
23341  =item getc
23342  
23343  =item ungetc
23344  
23345  =item inflateSync
23346  
23347  =item getHeaderInfo
23348  
23349  =item tell
23350  
23351  =item eof
23352  
23353  =item seek
23354  
23355  =item binmode
23356  
23357  =item opened
23358  
23359  =item autoflush
23360  
23361  =item input_line_number
23362  
23363  =item fileno
23364  
23365  =item close
23366  
23367  =item nextStream
23368  
23369  =item trailingData
23370  
23371  =back
23372  
23373  =item Importing 
23374  
23375  :all
23376  
23377  =item EXAMPLES
23378  
23379  =item SEE ALSO
23380  
23381  =item AUTHOR
23382  
23383  =item MODIFICATION HISTORY
23384  
23385  =item COPYRIGHT AND LICENSE
23386  
23387  =back
23388  
23389  =head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
23390  
23391  =over 4
23392  
23393  =item SYNOPSIS
23394  
23395  =item DESCRIPTION
23396  
23397  =item Functional Interface
23398  
23399  =over 4
23400  
23401  =item rawinflate $input => $output [, OPTS]
23402  
23403  A filename, A filehandle, A scalar reference, An array reference, An Input
23404  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23405  Reference, An Output FileGlob
23406  
23407  =item Notes
23408  
23409  =item Optional Parameters
23410  
23411  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23412  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23413  
23414  =item Examples
23415  
23416  =back
23417  
23418  =item OO Interface
23419  
23420  =over 4
23421  
23422  =item Constructor
23423  
23424  A filename, A filehandle, A scalar reference
23425  
23426  =item Constructor Options
23427  
23428  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23429  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23430  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23431  
23432  =item Examples
23433  
23434  =back
23435  
23436  =item Methods 
23437  
23438  =over 4
23439  
23440  =item read
23441  
23442  =item read
23443  
23444  =item getline
23445  
23446  =item getc
23447  
23448  =item ungetc
23449  
23450  =item inflateSync
23451  
23452  =item getHeaderInfo
23453  
23454  =item tell
23455  
23456  =item eof
23457  
23458  =item seek
23459  
23460  =item binmode
23461  
23462  =item opened
23463  
23464  =item autoflush
23465  
23466  =item input_line_number
23467  
23468  =item fileno
23469  
23470  =item close
23471  
23472  =item nextStream
23473  
23474  =item trailingData
23475  
23476  =back
23477  
23478  =item Importing 
23479  
23480  :all
23481  
23482  =item EXAMPLES
23483  
23484  =item SEE ALSO
23485  
23486  =item AUTHOR
23487  
23488  =item MODIFICATION HISTORY
23489  
23490  =item COPYRIGHT AND LICENSE
23491  
23492  =back
23493  
23494  =head2 IO::Uncompress::Unzip - Read zip files/buffers
23495  
23496  =over 4
23497  
23498  =item SYNOPSIS
23499  
23500  =item DESCRIPTION
23501  
23502  =item Functional Interface
23503  
23504  =over 4
23505  
23506  =item unzip $input => $output [, OPTS]
23507  
23508  A filename, A filehandle, A scalar reference, An array reference, An Input
23509  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23510  Reference, An Output FileGlob
23511  
23512  =item Notes
23513  
23514  =item Optional Parameters
23515  
23516  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23517  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23518  
23519  =item Examples
23520  
23521  =back
23522  
23523  =item OO Interface
23524  
23525  =over 4
23526  
23527  =item Constructor
23528  
23529  A filename, A filehandle, A scalar reference
23530  
23531  =item Constructor Options
23532  
23533  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23534  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23535  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23536  
23537  =item Examples
23538  
23539  =back
23540  
23541  =item Methods 
23542  
23543  =over 4
23544  
23545  =item read
23546  
23547  =item read
23548  
23549  =item getline
23550  
23551  =item getc
23552  
23553  =item ungetc
23554  
23555  =item inflateSync
23556  
23557  =item getHeaderInfo
23558  
23559  =item tell
23560  
23561  =item eof
23562  
23563  =item seek
23564  
23565  =item binmode
23566  
23567  =item opened
23568  
23569  =item autoflush
23570  
23571  =item input_line_number
23572  
23573  =item fileno
23574  
23575  =item close
23576  
23577  =item nextStream
23578  
23579  =item trailingData
23580  
23581  =back
23582  
23583  =item Importing 
23584  
23585  :all
23586  
23587  =item EXAMPLES
23588  
23589  =item SEE ALSO
23590  
23591  =item AUTHOR
23592  
23593  =item MODIFICATION HISTORY
23594  
23595  =item COPYRIGHT AND LICENSE
23596  
23597  =back
23598  
23599  =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
23600  
23601  =over 4
23602  
23603  =item SYNOPSIS
23604  
23605  =item DESCRIPTION
23606  
23607  =item CONSTRUCTOR
23608  
23609  new ( [ARGS] )
23610  
23611  =item OBJECT METHODS
23612  
23613  open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
23614  ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
23615  tell, setpos ( POS ), getpos ( POS )
23616  
23617  =item USING THE EXTERNAL GZIP
23618  
23619  =item CLASS METHODS
23620  
23621  has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
23622  gzip_write_open
23623  
23624  =item DIAGNOSTICS
23625  
23626  IO::Zlib::getlines: must be called in list context,
23627  IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
23628  is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
23629  IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
23630  'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
23631  an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
23632  IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
23633  needs a filename, IO::Zlib::READ: NBYTES must be specified,
23634  IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: OFFSET is not supported
23635  
23636  =item SEE ALSO
23637  
23638  =item HISTORY
23639  
23640  =item COPYRIGHT
23641  
23642  =back
23643  
23644  =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
23645  handles
23646  
23647  =over 4
23648  
23649  =item SYNOPSIS
23650  
23651  =item DESCRIPTION
23652  
23653  new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
23654  rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
23655  
23656  =item SEE ALSO
23657  
23658  =item AUTHOR
23659  
23660  =item COPYRIGHT
23661  
23662  =back
23663  
23664  =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
23665  
23666  =over 4
23667  
23668  =item SYNOPSIS
23669  
23670  =item DESCRIPTION
23671  
23672  =item CONSTRUCTOR
23673  
23674  new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
23675  
23676  =item METHODS
23677  
23678  open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
23679  [LAYER] )
23680  
23681  =item NOTE
23682  
23683  =item SEE ALSO
23684  
23685  =item HISTORY
23686  
23687  =back
23688  
23689  =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
23690  handles
23691  
23692  =over 4
23693  
23694  =item SYNOPSIS
23695  
23696  =item DESCRIPTION
23697  
23698  =item CONSTRUCTOR
23699  
23700  new (), new_from_fd ( FD, MODE )
23701  
23702  =item METHODS
23703  
23704  $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
23705  $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
23706  $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
23707  $io->blocking ( [ BOOL ] ), $io->untaint
23708  
23709  =item NOTE
23710  
23711  =item SEE ALSO
23712  
23713  =item BUGS
23714  
23715  =item HISTORY
23716  
23717  =back
23718  
23719  =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
23720  
23721  =over 4
23722  
23723  =item SYNOPSIS
23724  
23725  =item DESCRIPTION
23726  
23727  =item CONSTRUCTOR
23728  
23729  new ( [READER, WRITER] )
23730  
23731  =item METHODS
23732  
23733  reader ([ARGS]), writer ([ARGS]), handles ()
23734  
23735  =item SEE ALSO
23736  
23737  =item AUTHOR
23738  
23739  =item COPYRIGHT
23740  
23741  =back
23742  
23743  =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
23744  
23745  =over 4
23746  
23747  =item SYNOPSIS
23748  
23749  =item DESCRIPTION
23750  
23751  =item METHODS
23752  
23753  mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
23754  IO ), handles( [ EVENT_MASK ] )
23755  
23756  =item SEE ALSO
23757  
23758  =item AUTHOR
23759  
23760  =item COPYRIGHT
23761  
23762  =back
23763  
23764  =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
23765  I/O objects
23766  
23767  =over 4
23768  
23769  =item SYNOPSIS
23770  
23771  =item DESCRIPTION
23772  
23773  $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
23774  WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
23775  $io->tell
23776  
23777  =item SEE ALSO
23778  
23779  =item HISTORY
23780  
23781  =back
23782  
23783  =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
23784  call
23785  
23786  =over 4
23787  
23788  =item SYNOPSIS
23789  
23790  =item DESCRIPTION
23791  
23792  =item CONSTRUCTOR
23793  
23794  new ( [ HANDLES ] )
23795  
23796  =item METHODS
23797  
23798  add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
23799  [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
23800  count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
23801  
23802  =item EXAMPLE
23803  
23804  =item AUTHOR
23805  
23806  =item COPYRIGHT
23807  
23808  =back
23809  
23810  =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
23811  communications
23812  
23813  =over 4
23814  
23815  =item SYNOPSIS
23816  
23817  =item DESCRIPTION
23818  
23819  =item CONSTRUCTOR
23820  
23821  new ( [ARGS] )
23822  
23823  =item METHODS
23824  
23825  accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
23826  protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
23827  
23828  =item SEE ALSO
23829  
23830  =item AUTHOR
23831  
23832  =item COPYRIGHT
23833  
23834  =back
23835  
23836  =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
23837  AF_INET domain sockets
23838  
23839  =over 4
23840  
23841  =item SYNOPSIS
23842  
23843  =item DESCRIPTION
23844  
23845  =item CONSTRUCTOR
23846  
23847  new ( [ARGS] )
23848  
23849  =over 4
23850  
23851  =item METHODS
23852  
23853  sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
23854  ()
23855  
23856  =back
23857  
23858  =item SEE ALSO
23859  
23860  =item AUTHOR
23861  
23862  =item COPYRIGHT
23863  
23864  =back
23865  
23866  =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
23867  AF_UNIX domain sockets
23868  
23869  =over 4
23870  
23871  =item SYNOPSIS
23872  
23873  =item DESCRIPTION
23874  
23875  =item CONSTRUCTOR
23876  
23877  new ( [ARGS] )
23878  
23879  =item METHODS
23880  
23881  hostpath(), peerpath()
23882  
23883  =item SEE ALSO
23884  
23885  =item AUTHOR
23886  
23887  =item COPYRIGHT
23888  
23889  =back
23890  
23891  =head2 IO_Compress_Base::lib::File::GlobMapper, File::GlobMapper - Extend
23892  File Glob to Allow Input and Output Files
23893  
23894  =over 4
23895  
23896  =item SYNOPSIS
23897  
23898  =item DESCRIPTION
23899  
23900  This code is a work in progress, There are known bugs, The interface
23901  defined here is tentative, There are portability issues, Do not use in
23902  production code, Consider yourself warned!
23903  
23904  =over 4
23905  
23906  =item Behind The Scenes
23907  
23908  =item Limitations
23909  
23910  =item Input File Glob
23911  
23912  B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
23913  
23914  =item Output File Glob
23915  
23916  "*", #1
23917  
23918  =item Returned Data
23919  
23920  =back
23921  
23922  =item EXAMPLES
23923  
23924  =over 4
23925  
23926  =item A Rename script
23927  
23928  =item A few example globmaps
23929  
23930  =back
23931  
23932  =item SEE ALSO
23933  
23934  =item AUTHOR
23935  
23936  =item COPYRIGHT AND LICENSE
23937  
23938  =back
23939  
23940  =head2 IO_Compress_Base::lib::IO::Compress::Base, IO::Compress::Base - Base
23941  Class for IO::Compress modules 
23942  
23943  =over 4
23944  
23945  =item SYNOPSIS
23946  
23947  =item DESCRIPTION
23948  
23949  =item SEE ALSO
23950  
23951  =item AUTHOR
23952  
23953  =item MODIFICATION HISTORY
23954  
23955  =item COPYRIGHT AND LICENSE
23956  
23957  =back
23958  
23959  =head2 IO_Compress_Base::lib::IO::Uncompress::AnyUncompress,
23960  IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
23961  file/buffer
23962  
23963  =over 4
23964  
23965  =item SYNOPSIS
23966  
23967  =item DESCRIPTION
23968  
23969  RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
23970  
23971  =item Functional Interface
23972  
23973  =over 4
23974  
23975  =item anyuncompress $input => $output [, OPTS]
23976  
23977  A filename, A filehandle, A scalar reference, An array reference, An Input
23978  FileGlob string, A filename, A filehandle, A scalar reference, An Array
23979  Reference, An Output FileGlob
23980  
23981  =item Notes
23982  
23983  =item Optional Parameters
23984  
23985  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23986  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23987  
23988  =item Examples
23989  
23990  =back
23991  
23992  =item OO Interface
23993  
23994  =over 4
23995  
23996  =item Constructor
23997  
23998  A filename, A filehandle, A scalar reference
23999  
24000  =item Constructor Options
24001  
24002  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24003  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24004  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
24005  >>
24006  
24007  =item Examples
24008  
24009  =back
24010  
24011  =item Methods 
24012  
24013  =over 4
24014  
24015  =item read
24016  
24017  =item read
24018  
24019  =item getline
24020  
24021  =item getc
24022  
24023  =item ungetc
24024  
24025  =item getHeaderInfo
24026  
24027  =item tell
24028  
24029  =item eof
24030  
24031  =item seek
24032  
24033  =item binmode
24034  
24035  =item opened
24036  
24037  =item autoflush
24038  
24039  =item input_line_number
24040  
24041  =item fileno
24042  
24043  =item close
24044  
24045  =item nextStream
24046  
24047  =item trailingData
24048  
24049  =back
24050  
24051  =item Importing 
24052  
24053  :all
24054  
24055  =item EXAMPLES
24056  
24057  =item SEE ALSO
24058  
24059  =item AUTHOR
24060  
24061  =item MODIFICATION HISTORY
24062  
24063  =item COPYRIGHT AND LICENSE
24064  
24065  =back
24066  
24067  =head2 IO_Compress_Base::lib::IO::Uncompress::Base, IO::Uncompress::Base -
24068  Base Class for IO::Uncompress modules 
24069  
24070  =over 4
24071  
24072  =item SYNOPSIS
24073  
24074  =item DESCRIPTION
24075  
24076  =item SEE ALSO
24077  
24078  =item AUTHOR
24079  
24080  =item MODIFICATION HISTORY
24081  
24082  =item COPYRIGHT AND LICENSE
24083  
24084  =back
24085  
24086  =head2 IO_Compress_Zlib::IO::Compress::Deflate, IO::Compress::Deflate -
24087  Write RFC 1950 files/buffers
24088  
24089  =over 4
24090  
24091  =item SYNOPSIS
24092  
24093  =item DESCRIPTION
24094  
24095  =item Functional Interface
24096  
24097  =over 4
24098  
24099  =item deflate $input => $output [, OPTS]
24100  
24101  A filename, A filehandle, A scalar reference, An array reference, An Input
24102  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24103  Reference, An Output FileGlob
24104  
24105  =item Notes
24106  
24107  =item Optional Parameters
24108  
24109  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
24110  
24111  =item Examples
24112  
24113  =back
24114  
24115  =item OO Interface
24116  
24117  =over 4
24118  
24119  =item Constructor
24120  
24121  A filename, A filehandle, A scalar reference
24122  
24123  =item Constructor Options
24124  
24125  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
24126  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
24127  
24128  =item Examples
24129  
24130  =back
24131  
24132  =item Methods 
24133  
24134  =over 4
24135  
24136  =item print
24137  
24138  =item printf
24139  
24140  =item syswrite
24141  
24142  =item write
24143  
24144  =item flush
24145  
24146  =item tell
24147  
24148  =item eof
24149  
24150  =item seek
24151  
24152  =item binmode
24153  
24154  =item opened
24155  
24156  =item autoflush
24157  
24158  =item input_line_number
24159  
24160  =item fileno
24161  
24162  =item close
24163  
24164  =item newStream([OPTS])
24165  
24166  =item deflateParams
24167  
24168  =back
24169  
24170  =item Importing 
24171  
24172  :all, :constants, :flush, :level, :strategy
24173  
24174  =item EXAMPLES
24175  
24176  =item SEE ALSO
24177  
24178  =item AUTHOR
24179  
24180  =item MODIFICATION HISTORY
24181  
24182  =item COPYRIGHT AND LICENSE
24183  
24184  =back
24185  
24186  =head2 IO_Compress_Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write RFC
24187  1952 files/buffers
24188  
24189  =over 4
24190  
24191  =item SYNOPSIS
24192  
24193  =item DESCRIPTION
24194  
24195  =item Functional Interface
24196  
24197  =over 4
24198  
24199  =item gzip $input => $output [, OPTS]
24200  
24201  A filename, A filehandle, A scalar reference, An array reference, An Input
24202  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24203  Reference, An Output FileGlob
24204  
24205  =item Notes
24206  
24207  =item Optional Parameters
24208  
24209  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
24210  
24211  =item Examples
24212  
24213  =back
24214  
24215  =item OO Interface
24216  
24217  =over 4
24218  
24219  =item Constructor
24220  
24221  A filename, A filehandle, A scalar reference
24222  
24223  =item Constructor Options
24224  
24225  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
24226  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
24227  C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
24228  C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
24229  C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
24230  >>
24231  
24232  =item Examples
24233  
24234  =back
24235  
24236  =item Methods 
24237  
24238  =over 4
24239  
24240  =item print
24241  
24242  =item printf
24243  
24244  =item syswrite
24245  
24246  =item write
24247  
24248  =item flush
24249  
24250  =item tell
24251  
24252  =item eof
24253  
24254  =item seek
24255  
24256  =item binmode
24257  
24258  =item opened
24259  
24260  =item autoflush
24261  
24262  =item input_line_number
24263  
24264  =item fileno
24265  
24266  =item close
24267  
24268  =item newStream([OPTS])
24269  
24270  =item deflateParams
24271  
24272  =back
24273  
24274  =item Importing 
24275  
24276  :all, :constants, :flush, :level, :strategy
24277  
24278  =item EXAMPLES
24279  
24280  =item SEE ALSO
24281  
24282  =item AUTHOR
24283  
24284  =item MODIFICATION HISTORY
24285  
24286  =item COPYRIGHT AND LICENSE
24287  
24288  =back
24289  
24290  =head2 IO_Compress_Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate
24291  - Write RFC 1951 files/buffers
24292  
24293  =over 4
24294  
24295  =item SYNOPSIS
24296  
24297  =item DESCRIPTION
24298  
24299  =item Functional Interface
24300  
24301  =over 4
24302  
24303  =item rawdeflate $input => $output [, OPTS]
24304  
24305  A filename, A filehandle, A scalar reference, An array reference, An Input
24306  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24307  Reference, An Output FileGlob
24308  
24309  =item Notes
24310  
24311  =item Optional Parameters
24312  
24313  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
24314  
24315  =item Examples
24316  
24317  =back
24318  
24319  =item OO Interface
24320  
24321  =over 4
24322  
24323  =item Constructor
24324  
24325  A filename, A filehandle, A scalar reference
24326  
24327  =item Constructor Options
24328  
24329  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
24330  Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
24331  
24332  =item Examples
24333  
24334  =back
24335  
24336  =item Methods 
24337  
24338  =over 4
24339  
24340  =item print
24341  
24342  =item printf
24343  
24344  =item syswrite
24345  
24346  =item write
24347  
24348  =item flush
24349  
24350  =item tell
24351  
24352  =item eof
24353  
24354  =item seek
24355  
24356  =item binmode
24357  
24358  =item opened
24359  
24360  =item autoflush
24361  
24362  =item input_line_number
24363  
24364  =item fileno
24365  
24366  =item close
24367  
24368  =item newStream([OPTS])
24369  
24370  =item deflateParams
24371  
24372  =back
24373  
24374  =item Importing 
24375  
24376  :all, :constants, :flush, :level, :strategy
24377  
24378  =item EXAMPLES
24379  
24380  =item SEE ALSO
24381  
24382  =item AUTHOR
24383  
24384  =item MODIFICATION HISTORY
24385  
24386  =item COPYRIGHT AND LICENSE
24387  
24388  =back
24389  
24390  =head2 IO_Compress_Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip
24391  files/buffers
24392  
24393  =over 4
24394  
24395  =item SYNOPSIS
24396  
24397  =item DESCRIPTION
24398  
24399  =item Functional Interface
24400  
24401  =over 4
24402  
24403  =item zip $input => $output [, OPTS]
24404  
24405  A filename, A filehandle, A scalar reference, An array reference, An Input
24406  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24407  Reference, An Output FileGlob
24408  
24409  =item Notes
24410  
24411  =item Optional Parameters
24412  
24413  C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
24414  
24415  =item Examples
24416  
24417  =back
24418  
24419  =item OO Interface
24420  
24421  =over 4
24422  
24423  =item Constructor
24424  
24425  A filename, A filehandle, A scalar reference
24426  
24427  =item Constructor Options
24428  
24429  C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
24430  Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
24431  $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment =>
24432  $comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<<
24433  Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<<
24434  ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<<
24435  Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number
24436  >>, -Level, -Strategy, C<< Strict => 0|1 >>
24437  
24438  =item Examples
24439  
24440  =back
24441  
24442  =item Methods 
24443  
24444  =over 4
24445  
24446  =item print
24447  
24448  =item printf
24449  
24450  =item syswrite
24451  
24452  =item write
24453  
24454  =item flush
24455  
24456  =item tell
24457  
24458  =item eof
24459  
24460  =item seek
24461  
24462  =item binmode
24463  
24464  =item opened
24465  
24466  =item autoflush
24467  
24468  =item input_line_number
24469  
24470  =item fileno
24471  
24472  =item close
24473  
24474  =item newStream([OPTS])
24475  
24476  =item deflateParams
24477  
24478  =back
24479  
24480  =item Importing 
24481  
24482  :all, :constants, :flush, :level, :strategy, :zip_method
24483  
24484  =item EXAMPLES
24485  
24486  =item SEE ALSO
24487  
24488  =item AUTHOR
24489  
24490  =item MODIFICATION HISTORY
24491  
24492  =item COPYRIGHT AND LICENSE
24493  
24494  =back
24495  
24496  =head2 IO_Compress_Zlib::IO::Uncompress::AnyInflate,
24497  IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer
24498  
24499  =over 4
24500  
24501  =item SYNOPSIS
24502  
24503  =item DESCRIPTION
24504  
24505  RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
24506  
24507  =item Functional Interface
24508  
24509  =over 4
24510  
24511  =item anyinflate $input => $output [, OPTS]
24512  
24513  A filename, A filehandle, A scalar reference, An array reference, An Input
24514  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24515  Reference, An Output FileGlob
24516  
24517  =item Notes
24518  
24519  =item Optional Parameters
24520  
24521  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24522  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24523  
24524  =item Examples
24525  
24526  =back
24527  
24528  =item OO Interface
24529  
24530  =over 4
24531  
24532  =item Constructor
24533  
24534  A filename, A filehandle, A scalar reference
24535  
24536  =item Constructor Options
24537  
24538  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24539  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24540  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
24541  >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
24542  this option is set, it will force the module to check that it conforms to
24543  the sub-field structure as defined in RFC 1952
24544  
24545  =item Examples
24546  
24547  =back
24548  
24549  =item Methods 
24550  
24551  =over 4
24552  
24553  =item read
24554  
24555  =item read
24556  
24557  =item getline
24558  
24559  =item getc
24560  
24561  =item ungetc
24562  
24563  =item inflateSync
24564  
24565  =item getHeaderInfo
24566  
24567  =item tell
24568  
24569  =item eof
24570  
24571  =item seek
24572  
24573  =item binmode
24574  
24575  =item opened
24576  
24577  =item autoflush
24578  
24579  =item input_line_number
24580  
24581  =item fileno
24582  
24583  =item close
24584  
24585  =item nextStream
24586  
24587  =item trailingData
24588  
24589  =back
24590  
24591  =item Importing 
24592  
24593  :all
24594  
24595  =item EXAMPLES
24596  
24597  =item SEE ALSO
24598  
24599  =item AUTHOR
24600  
24601  =item MODIFICATION HISTORY
24602  
24603  =item COPYRIGHT AND LICENSE
24604  
24605  =back
24606  
24607  =head2 IO_Compress_Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
24608  Read RFC 1952 files/buffers
24609  
24610  =over 4
24611  
24612  =item SYNOPSIS
24613  
24614  =item DESCRIPTION
24615  
24616  =item Functional Interface
24617  
24618  =over 4
24619  
24620  =item gunzip $input => $output [, OPTS]
24621  
24622  A filename, A filehandle, A scalar reference, An array reference, An Input
24623  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24624  Reference, An Output FileGlob
24625  
24626  =item Notes
24627  
24628  =item Optional Parameters
24629  
24630  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24631  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24632  
24633  =item Examples
24634  
24635  =back
24636  
24637  =item OO Interface
24638  
24639  =over 4
24640  
24641  =item Constructor
24642  
24643  A filename, A filehandle, A scalar reference
24644  
24645  =item Constructor Options
24646  
24647  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24648  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24649  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
24650  >> If the gzip FEXTRA header field is present and this option is set, it
24651  will force the module to check that it conforms to the sub-field structure
24652  as defined in RFC 1952
24653  
24654  =item Examples
24655  
24656  =back
24657  
24658  =item Methods 
24659  
24660  =over 4
24661  
24662  =item read
24663  
24664  =item read
24665  
24666  =item getline
24667  
24668  =item getc
24669  
24670  =item ungetc
24671  
24672  =item inflateSync
24673  
24674  =item getHeaderInfo
24675  
24676  Name, Comment
24677  
24678  =item tell
24679  
24680  =item eof
24681  
24682  =item seek
24683  
24684  =item binmode
24685  
24686  =item opened
24687  
24688  =item autoflush
24689  
24690  =item input_line_number
24691  
24692  =item fileno
24693  
24694  =item close
24695  
24696  =item nextStream
24697  
24698  =item trailingData
24699  
24700  =back
24701  
24702  =item Importing 
24703  
24704  :all
24705  
24706  =item EXAMPLES
24707  
24708  =item SEE ALSO
24709  
24710  =item AUTHOR
24711  
24712  =item MODIFICATION HISTORY
24713  
24714  =item COPYRIGHT AND LICENSE
24715  
24716  =back
24717  
24718  =head2 IO_Compress_Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate -
24719  Read RFC 1950 files/buffers
24720  
24721  =over 4
24722  
24723  =item SYNOPSIS
24724  
24725  =item DESCRIPTION
24726  
24727  =item Functional Interface
24728  
24729  =over 4
24730  
24731  =item inflate $input => $output [, OPTS]
24732  
24733  A filename, A filehandle, A scalar reference, An array reference, An Input
24734  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24735  Reference, An Output FileGlob
24736  
24737  =item Notes
24738  
24739  =item Optional Parameters
24740  
24741  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24742  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24743  
24744  =item Examples
24745  
24746  =back
24747  
24748  =item OO Interface
24749  
24750  =over 4
24751  
24752  =item Constructor
24753  
24754  A filename, A filehandle, A scalar reference
24755  
24756  =item Constructor Options
24757  
24758  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24759  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24760  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24761  
24762  =item Examples
24763  
24764  =back
24765  
24766  =item Methods 
24767  
24768  =over 4
24769  
24770  =item read
24771  
24772  =item read
24773  
24774  =item getline
24775  
24776  =item getc
24777  
24778  =item ungetc
24779  
24780  =item inflateSync
24781  
24782  =item getHeaderInfo
24783  
24784  =item tell
24785  
24786  =item eof
24787  
24788  =item seek
24789  
24790  =item binmode
24791  
24792  =item opened
24793  
24794  =item autoflush
24795  
24796  =item input_line_number
24797  
24798  =item fileno
24799  
24800  =item close
24801  
24802  =item nextStream
24803  
24804  =item trailingData
24805  
24806  =back
24807  
24808  =item Importing 
24809  
24810  :all
24811  
24812  =item EXAMPLES
24813  
24814  =item SEE ALSO
24815  
24816  =item AUTHOR
24817  
24818  =item MODIFICATION HISTORY
24819  
24820  =item COPYRIGHT AND LICENSE
24821  
24822  =back
24823  
24824  =head2 IO_Compress_Zlib::IO::Uncompress::RawInflate,
24825  IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
24826  
24827  =over 4
24828  
24829  =item SYNOPSIS
24830  
24831  =item DESCRIPTION
24832  
24833  =item Functional Interface
24834  
24835  =over 4
24836  
24837  =item rawinflate $input => $output [, OPTS]
24838  
24839  A filename, A filehandle, A scalar reference, An array reference, An Input
24840  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24841  Reference, An Output FileGlob
24842  
24843  =item Notes
24844  
24845  =item Optional Parameters
24846  
24847  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24848  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24849  
24850  =item Examples
24851  
24852  =back
24853  
24854  =item OO Interface
24855  
24856  =over 4
24857  
24858  =item Constructor
24859  
24860  A filename, A filehandle, A scalar reference
24861  
24862  =item Constructor Options
24863  
24864  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24865  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24866  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24867  
24868  =item Examples
24869  
24870  =back
24871  
24872  =item Methods 
24873  
24874  =over 4
24875  
24876  =item read
24877  
24878  =item read
24879  
24880  =item getline
24881  
24882  =item getc
24883  
24884  =item ungetc
24885  
24886  =item inflateSync
24887  
24888  =item getHeaderInfo
24889  
24890  =item tell
24891  
24892  =item eof
24893  
24894  =item seek
24895  
24896  =item binmode
24897  
24898  =item opened
24899  
24900  =item autoflush
24901  
24902  =item input_line_number
24903  
24904  =item fileno
24905  
24906  =item close
24907  
24908  =item nextStream
24909  
24910  =item trailingData
24911  
24912  =back
24913  
24914  =item Importing 
24915  
24916  :all
24917  
24918  =item EXAMPLES
24919  
24920  =item SEE ALSO
24921  
24922  =item AUTHOR
24923  
24924  =item MODIFICATION HISTORY
24925  
24926  =item COPYRIGHT AND LICENSE
24927  
24928  =back
24929  
24930  =head2 IO_Compress_Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip -
24931  Read zip files/buffers
24932  
24933  =over 4
24934  
24935  =item SYNOPSIS
24936  
24937  =item DESCRIPTION
24938  
24939  =item Functional Interface
24940  
24941  =over 4
24942  
24943  =item unzip $input => $output [, OPTS]
24944  
24945  A filename, A filehandle, A scalar reference, An array reference, An Input
24946  FileGlob string, A filename, A filehandle, A scalar reference, An Array
24947  Reference, An Output FileGlob
24948  
24949  =item Notes
24950  
24951  =item Optional Parameters
24952  
24953  C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24954  C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24955  
24956  =item Examples
24957  
24958  =back
24959  
24960  =item OO Interface
24961  
24962  =over 4
24963  
24964  =item Constructor
24965  
24966  A filename, A filehandle, A scalar reference
24967  
24968  =item Constructor Options
24969  
24970  C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24971  >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24972  $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24973  
24974  =item Examples
24975  
24976  =back
24977  
24978  =item Methods 
24979  
24980  =over 4
24981  
24982  =item read
24983  
24984  =item read
24985  
24986  =item getline
24987  
24988  =item getc
24989  
24990  =item ungetc
24991  
24992  =item inflateSync
24993  
24994  =item getHeaderInfo
24995  
24996  =item tell
24997  
24998  =item eof
24999  
25000  =item seek
25001  
25002  =item binmode
25003  
25004  =item opened
25005  
25006  =item autoflush
25007  
25008  =item input_line_number
25009  
25010  =item fileno
25011  
25012  =item close
25013  
25014  =item nextStream
25015  
25016  =item trailingData
25017  
25018  =back
25019  
25020  =item Importing 
25021  
25022  :all
25023  
25024  =item EXAMPLES
25025  
25026  =item SEE ALSO
25027  
25028  =item AUTHOR
25029  
25030  =item MODIFICATION HISTORY
25031  
25032  =item COPYRIGHT AND LICENSE
25033  
25034  =back
25035  
25036  =head2 IPC::Msg - SysV Msg IPC object class
25037  
25038  =over 4
25039  
25040  =item SYNOPSIS
25041  
25042  =item DESCRIPTION
25043  
25044  =item METHODS
25045  
25046  new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
25047  ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
25048  FLAGS ] ), stat
25049  
25050  =item SEE ALSO
25051  
25052  =item AUTHOR
25053  
25054  =item COPYRIGHT
25055  
25056  =back
25057  
25058  =head2 IPC::Open2, open2 - open a process for both reading and writing
25059  
25060  =over 4
25061  
25062  =item SYNOPSIS
25063  
25064  =item DESCRIPTION
25065  
25066  =item WARNING 
25067  
25068  =item SEE ALSO
25069  
25070  =back
25071  
25072  =head2 IPC::Open3, open3 - open a process for reading, writing, and error
25073  handling
25074  
25075  =over 4
25076  
25077  =item SYNOPSIS
25078  
25079  =item DESCRIPTION
25080  
25081  =item See Also
25082  
25083  L<IPC::Open2>, L<IPC::Run>
25084  
25085  =item WARNING
25086  
25087  =back
25088  
25089  =head2 IPC::Semaphore - SysV Semaphore IPC object class
25090  
25091  =over 4
25092  
25093  =item SYNOPSIS
25094  
25095  =item DESCRIPTION
25096  
25097  =item METHODS
25098  
25099  new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
25100  getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
25101  set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
25102  , VALUE ), stat
25103  
25104  =item SEE ALSO
25105  
25106  =item AUTHOR
25107  
25108  =item COPYRIGHT
25109  
25110  =back
25111  
25112  =head2 IPC::SysV - SysV IPC constants
25113  
25114  =over 4
25115  
25116  =item SYNOPSIS
25117  
25118  =item DESCRIPTION
25119  
25120  ftok( PATH, ID )
25121  
25122  =item SEE ALSO
25123  
25124  =item AUTHORS
25125  
25126  =item COPYRIGHT
25127  
25128  =back
25129  
25130  =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
25131  
25132  =over 4
25133  
25134  =item SYNOPSIS
25135  
25136  =item DESCRIPTION
25137  
25138  =item METHODS
25139  
25140  new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
25141  ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
25142  FLAGS ] ), stat
25143  
25144  =item SEE ALSO
25145  
25146  =item AUTHOR
25147  
25148  =item COPYRIGHT
25149  
25150  =back
25151  
25152  =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
25153  class
25154  
25155  =over 4
25156  
25157  =item SYNOPSIS
25158  
25159  =item DESCRIPTION
25160  
25161  =item METHODS
25162  
25163  new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
25164  getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
25165  set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
25166  , VALUE ), stat
25167  
25168  =item SEE ALSO
25169  
25170  =item AUTHOR
25171  
25172  =item COPYRIGHT
25173  
25174  =back
25175  
25176  =head2 IPCmd, IPC::Cmd - finding and running system commands made easy
25177  
25178  =over 4
25179  
25180  =item SYNOPSIS
25181  
25182  =item DESCRIPTION
25183  
25184  =item CLASS METHODS 
25185  
25186  =over 4
25187  
25188  =item $bool = IPC::Cmd->can_use_ipc_run( [VERBOSE] )
25189  
25190  =back
25191  
25192  =back
25193  
25194  =over 4
25195  
25196  =item $bool = IPC::Cmd->can_use_ipc_open3( [VERBOSE] )
25197  
25198  =back
25199  
25200  =over 4
25201  
25202  =item $bool = IPC::Cmd->can_capture_buffer
25203  
25204  =back
25205  
25206  =over 4
25207  
25208  =item FUNCTIONS
25209  
25210  =over 4
25211  
25212  =item $path = can_run( PROGRAM );
25213  
25214  =back
25215  
25216  =back
25217  
25218  =over 4
25219  
25220  =item $ok | ($ok, $err, $full_buf, $stdout_buff, $stderr_buff) = run(
25221  command => COMMAND, [verbose => BOOL, buffer => \$SCALAR] );
25222  
25223  command, verbose, buffer, success, errorcode, full_buffer, out_buffer,
25224  error_buffer
25225  
25226  =back
25227  
25228  =over 4
25229  
25230  =item HOW IT WORKS
25231  
25232  =item Global Variables
25233  
25234  =over 4
25235  
25236  =item $IPC::Cmd::VERBOSE
25237  
25238  =item $IPC::Cmd::USE_IPC_RUN
25239  
25240  =item $IPC::Cmd::USE_IPC_OPEN3
25241  
25242  =item $IPC::Cmd::WARN
25243  
25244  =back
25245  
25246  =item Caveats
25247  
25248  Whitespace, IO Redirect
25249  
25250  =item See Also
25251  
25252  =item ACKNOWLEDGEMENTS
25253  
25254  =item BUG REPORTS
25255  
25256  =item AUTHOR
25257  
25258  =item COPYRIGHT
25259  
25260  =back
25261  
25262  =head2 List::Util - A selection of general-utility list subroutines
25263  
25264  =over 4
25265  
25266  =item SYNOPSIS
25267  
25268  =item DESCRIPTION
25269  
25270  first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
25271  BLOCK LIST, shuffle LIST, sum LIST
25272  
25273  =item KNOWN BUGS
25274  
25275  =item SUGGESTED ADDITIONS
25276  
25277  =item SEE ALSO
25278  
25279  =item COPYRIGHT
25280  
25281  =back
25282  
25283  =head2 List::Utilib::List::Util, List::Util - A selection of
25284  general-utility list subroutines
25285  
25286  =over 4
25287  
25288  =item SYNOPSIS
25289  
25290  =item DESCRIPTION
25291  
25292  first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
25293  BLOCK LIST, shuffle LIST, sum LIST
25294  
25295  =item KNOWN BUGS
25296  
25297  =item SUGGESTED ADDITIONS
25298  
25299  =item SEE ALSO
25300  
25301  =item COPYRIGHT
25302  
25303  =back
25304  
25305  =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
25306  general-utility scalar subroutines
25307  
25308  =over 4
25309  
25310  =item SYNOPSIS
25311  
25312  =item DESCRIPTION
25313  
25314  blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
25315  looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
25316  set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
25317  
25318  =item KNOWN BUGS
25319  
25320  =item SEE ALSO
25321  
25322  =item COPYRIGHT
25323  
25324  =item BLATANT PLUG
25325  
25326  =back
25327  
25328  =head2 Locale::Constants - constants for Locale codes
25329  
25330  =over 4
25331  
25332  =item SYNOPSIS
25333  
25334  =item DESCRIPTION
25335  
25336  =item KNOWN BUGS AND LIMITATIONS
25337  
25338  =item SEE ALSO
25339  
25340  Locale::Language, Locale::Country, Locale::Script, Locale::Currency
25341  
25342  =item AUTHOR
25343  
25344  =item COPYRIGHT
25345  
25346  =back
25347  
25348  =head2 Locale::Country - ISO codes for country identification (ISO 3166)
25349  
25350  =over 4
25351  
25352  =item SYNOPSIS
25353  
25354  =item DESCRIPTION
25355  
25356  B<alpha-2>, B<alpha-3>, B<numeric>
25357  
25358  =item CONVERSION ROUTINES
25359  
25360  code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
25361  country_code2code( CODE, CODESET, CODESET )
25362  
25363  =item QUERY ROUTINES
25364  
25365  C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
25366  
25367  =item SEMI-PRIVATE ROUTINES
25368  
25369  =over 4
25370  
25371  =item alias_code
25372  
25373  =item rename_country
25374  
25375  =back
25376  
25377  =item EXAMPLES
25378  
25379  =item DOMAIN NAMES
25380  
25381  =item KNOWN BUGS AND LIMITATIONS
25382  
25383  =item SEE ALSO
25384  
25385  Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
25386  3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
25387  http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
25388  http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
25389  
25390  =item AUTHOR
25391  
25392  =item COPYRIGHT
25393  
25394  =back
25395  
25396  =head2 Locale::Currency - ISO three letter codes for currency
25397  identification (ISO 4217)
25398  
25399  =over 4
25400  
25401  =item SYNOPSIS
25402  
25403  =item DESCRIPTION
25404  
25405  XTS, XXX
25406  
25407  =item CONVERSION ROUTINES
25408  
25409  code2currency(), currency2code()
25410  
25411  =item QUERY ROUTINES
25412  
25413  C<all_currency_codes()>, C<all_currency_names()>
25414  
25415  =item EXAMPLES
25416  
25417  =item KNOWN BUGS AND LIMITATIONS
25418  
25419  =item SEE ALSO
25420  
25421  Locale::Country, Locale::Script, ISO 4217:1995,
25422  http://www.bsi-global.com/iso4217currency
25423  
25424  =item AUTHOR
25425  
25426  =item COPYRIGHT
25427  
25428  =back
25429  
25430  =head2 Locale::Language - ISO two letter codes for language identification
25431  (ISO 639)
25432  
25433  =over 4
25434  
25435  =item SYNOPSIS
25436  
25437  =item DESCRIPTION
25438  
25439  =item CONVERSION ROUTINES
25440  
25441  code2language(), language2code()
25442  
25443  =item QUERY ROUTINES
25444  
25445  C<all_language_codes()>, C<all_language_names()>
25446  
25447  =item EXAMPLES
25448  
25449  =item KNOWN BUGS AND LIMITATIONS
25450  
25451  =item SEE ALSO
25452  
25453  Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
25454  http://lcweb.loc.gov/standards/iso639-2/langhome.html
25455  
25456  =item AUTHOR
25457  
25458  =item COPYRIGHT
25459  
25460  =back
25461  
25462  =head2 Locale::Maketext - framework for localization
25463  
25464  =over 4
25465  
25466  =item SYNOPSIS
25467  
25468  =item DESCRIPTION
25469  
25470  =item QUICK OVERVIEW
25471  
25472  =item METHODS
25473  
25474  =over 4
25475  
25476  =item Construction Methods
25477  
25478  =item The "maketext" Method
25479  
25480  $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
25481  
25482  =item Utility Methods
25483  
25484  $language->quant($number, $singular), $language->quant($number, $singular,
25485  $plural), $language->quant($number, $singular, $plural, $negative),
25486  $language->numf($number), $language->sprintf($format, @items),
25487  $language->language_tag(), $language->encoding()
25488  
25489  =item Language Handle Attributes and Internals
25490  
25491  =back
25492  
25493  =item LANGUAGE CLASS HIERARCHIES
25494  
25495  =item ENTRIES IN EACH LEXICON
25496  
25497  =item BRACKET NOTATION
25498  
25499  =item AUTO LEXICONS
25500  
25501  =item CONTROLLING LOOKUP FAILURE
25502  
25503  =item HOW TO USE MAKETEXT
25504  
25505  =item SEE ALSO
25506  
25507  =item COPYRIGHT AND DISCLAIMER
25508  
25509  =item AUTHOR
25510  
25511  =back
25512  
25513  =head2 Locale::Maketext::Simple - Simple interface to
25514  Locale::Maketext::Lexicon
25515  
25516  =over 4
25517  
25518  =item VERSION
25519  
25520  =item SYNOPSIS
25521  
25522  =item DESCRIPTION
25523  
25524  =item OPTIONS
25525  
25526  =over 4
25527  
25528  =item Class
25529  
25530  =item Path
25531  
25532  =item Style
25533  
25534  =item Export
25535  
25536  =item Subclass
25537  
25538  =item Decode
25539  
25540  =item Encoding
25541  
25542  =back
25543  
25544  =back
25545  
25546  =over 4
25547  
25548  =item ACKNOWLEDGMENTS
25549  
25550  =item SEE ALSO
25551  
25552  =item AUTHORS
25553  
25554  =item COPYRIGHT
25555  
25556  =over 4
25557  
25558  =item The "MIT" License
25559  
25560  =back
25561  
25562  =back
25563  
25564  =head2 Locale::Maketext::TPJ13 -- article about software localization
25565  
25566  =over 4
25567  
25568  =item SYNOPSIS
25569  
25570  =item DESCRIPTION
25571  
25572  =item Localization and Perl: gettext breaks, Maketext fixes
25573  
25574  =over 4
25575  
25576  =item A Localization Horror Story: It Could Happen To You
25577  
25578  =item The Linguistic View
25579  
25580  =item Breaking gettext
25581  
25582  =item Replacing gettext
25583  
25584  =item Buzzwords: Abstraction and Encapsulation
25585  
25586  =item Buzzword: Isomorphism
25587  
25588  =item Buzzword: Inheritance
25589  
25590  =item Buzzword: Concision
25591  
25592  =item The Devil in the Details
25593  
25594  =item The Proof in the Pudding: Localizing Web Sites
25595  
25596  =item References
25597  
25598  =back
25599  
25600  =back
25601  
25602  =head2 Locale::Script - ISO codes for script identification (ISO 15924)
25603  
25604  =over 4
25605  
25606  =item SYNOPSIS
25607  
25608  =item DESCRIPTION
25609  
25610  B<alpha-2>, B<alpha-3>, B<numeric>
25611  
25612  =over 4
25613  
25614  =item SPECIAL CODES
25615  
25616  =back
25617  
25618  =item CONVERSION ROUTINES
25619  
25620  code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
25621  script_code2code( CODE, CODESET, CODESET )
25622  
25623  =item QUERY ROUTINES
25624  
25625  C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
25626  
25627  =item EXAMPLES
25628  
25629  =item KNOWN BUGS AND LIMITATIONS
25630  
25631  =item SEE ALSO
25632  
25633  Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
25634  http://www.evertype.com/standards/iso15924/
25635  
25636  =item AUTHOR
25637  
25638  =item COPYRIGHT
25639  
25640  =back
25641  
25642  =head2 Log::Message - A generic message storing mechanism;
25643  
25644  =over 4
25645  
25646  =item SYNOPSIS
25647  
25648  =item DESCRIPTION
25649  
25650  =item Hierarchy
25651  
25652  Log::Message, Log::Message::Item, Log::Message::Handlers,
25653  Log::Message::Config
25654  
25655  =item Options
25656  
25657  config, private, verbose, tag, level, remove, chrono
25658  
25659  =back
25660  
25661  =over 4
25662  
25663  =item Methods
25664  
25665  =over 4
25666  
25667  =item new
25668  
25669  =back
25670  
25671  =back
25672  
25673  =over 4
25674  
25675  =item store
25676  
25677  message, tag, level, extra
25678  
25679  =back
25680  
25681  =over 4
25682  
25683  =item retrieve
25684  
25685  tag, level, message, amount, chrono, remove
25686  
25687  =back
25688  
25689  =over 4
25690  
25691  =item first
25692  
25693  =back
25694  
25695  =over 4
25696  
25697  =item last
25698  
25699  =back
25700  
25701  =over 4
25702  
25703  =item flush
25704  
25705  =back
25706  
25707  =over 4
25708  
25709  =item SEE ALSO
25710  
25711  =item AUTHOR
25712  
25713  =item Acknowledgements
25714  
25715  =item COPYRIGHT
25716  
25717  =back
25718  
25719  =head2 Log::Message::Config - Configuration options for Log::Message
25720  
25721  =over 4
25722  
25723  =item SYNOPSIS
25724  
25725  =item DESCRIPTION
25726  
25727  =item SEE ALSO
25728  
25729  =item AUTHOR
25730  
25731  =item Acknowledgements
25732  
25733  =item COPYRIGHT
25734  
25735  =back
25736  
25737  =head2 Log::Message::Handlers - Message handlers for Log::Message
25738  
25739  =over 4
25740  
25741  =item SYNOPSIS
25742  
25743  =item DESCRIPTION
25744  
25745  =item Default Handlers
25746  
25747  =over 4
25748  
25749  =item log
25750  
25751  =back
25752  
25753  =back
25754  
25755  =over 4
25756  
25757  =item carp
25758  
25759  =back
25760  
25761  =over 4
25762  
25763  =item croak
25764  
25765  =back
25766  
25767  =over 4
25768  
25769  =item cluck
25770  
25771  =back
25772  
25773  =over 4
25774  
25775  =item confess
25776  
25777  =back
25778  
25779  =over 4
25780  
25781  =item die
25782  
25783  =back
25784  
25785  =over 4
25786  
25787  =item warn
25788  
25789  =back
25790  
25791  =over 4
25792  
25793  =item trace
25794  
25795  =back
25796  
25797  =over 4
25798  
25799  =item Custom Handlers
25800  
25801  =item SEE ALSO
25802  
25803  =item AUTHOR
25804  
25805  =item Acknowledgements
25806  
25807  =item COPYRIGHT
25808  
25809  =back
25810  
25811  =head2 Log::Message::Item  - Message objects for Log::Message
25812  
25813  =over 4
25814  
25815  =item SYNOPSIS
25816  
25817  =item DESCRIPTION
25818  
25819  =item Methods and Accessors
25820  
25821  =over 4
25822  
25823  =item remove
25824  
25825  =item id
25826  
25827  =item when
25828  
25829  =item message
25830  
25831  =item level
25832  
25833  =item tag
25834  
25835  =item shortmess
25836  
25837  =item longmess
25838  
25839  =item parent
25840  
25841  =back
25842  
25843  =item SEE ALSO
25844  
25845  =item AUTHOR
25846  
25847  =item Acknowledgements
25848  
25849  =item COPYRIGHT
25850  
25851  =back
25852  
25853  =head2 Log::Message::Simple
25854  
25855  =over 4
25856  
25857  =item SYNOPSIS
25858  
25859  =item DESCRIPTION
25860  
25861  =item FUNCTIONS
25862  
25863  =over 4
25864  
25865  =item msg("message string" [,VERBOSE])
25866  
25867  =item debug("message string" [,VERBOSE])
25868  
25869  =item error("error string" [,VERBOSE])
25870  
25871  =back
25872  
25873  =back
25874  
25875  =over 4
25876  
25877  =item carp();
25878  
25879  =item croak();
25880  
25881  =item confess();
25882  
25883  =item cluck();
25884  
25885  =back
25886  
25887  =over 4
25888  
25889  =item CLASS METHODS
25890  
25891  =over 4
25892  
25893  =item Log::Message::Simple->stack()
25894  
25895  =item Log::Message::Simple->stack_as_string([TRACE])
25896  
25897  =item Log::Message::Simple->flush()
25898  
25899  =back
25900  
25901  =back
25902  
25903  =over 4
25904  
25905  =item GLOBAL VARIABLES
25906  
25907  $ERROR_FH, $MSG_FH, $DEBUG_FH, $STACKTRACE_ON_ERROR
25908  
25909  =back
25910  
25911  =head2 MIME::Base64 - Encoding and decoding of base64 strings
25912  
25913  =over 4
25914  
25915  =item SYNOPSIS
25916  
25917  =item DESCRIPTION
25918  
25919  encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
25920  
25921  =item DIAGNOSTICS
25922  
25923  Premature end of base64 data, Premature padding of base64 data, Wide
25924  character in subroutine entry
25925  
25926  =item EXAMPLES
25927  
25928  =item COPYRIGHT
25929  
25930  =item SEE ALSO
25931  
25932  =back
25933  
25934  =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
25935  of quoted-printable strings
25936  
25937  =over 4
25938  
25939  =item SYNOPSIS
25940  
25941  =item DESCRIPTION
25942  
25943  encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
25944  decode_qp($str);
25945  
25946  =item COPYRIGHT
25947  
25948  =item SEE ALSO
25949  
25950  =back
25951  
25952  =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
25953  strings
25954  
25955  =over 4
25956  
25957  =item SYNOPSIS
25958  
25959  =item DESCRIPTION
25960  
25961  encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
25962  decode_qp($str);
25963  
25964  =item COPYRIGHT
25965  
25966  =item SEE ALSO
25967  
25968  =back
25969  
25970  =head2 Math::BigFloat - Arbitrary size floating point math package
25971  
25972  =over 4
25973  
25974  =item SYNOPSIS
25975  
25976  =item DESCRIPTION
25977  
25978  =over 4
25979  
25980  =item Canonical notation
25981  
25982  =item Output
25983  
25984  =item C<mantissa()>, C<exponent()> and C<parts()>
25985  
25986  =item Accuracy vs. Precision
25987  
25988  =item Rounding
25989  
25990  ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
25991  ), fround  ( -$scale ) and fround ( 0 )
25992  
25993  =back
25994  
25995  =item METHODS
25996  
25997  =over 4
25998  
25999  =item accuracy
26000  
26001  =item precision()
26002  
26003  =item bexp()
26004  
26005  =item bnok()
26006  
26007  =item bpi()
26008  
26009  =item bcos()
26010  
26011  =item bsin()
26012  
26013  =item batan2()
26014  
26015  =item batan()
26016  
26017  =item bmuladd()
26018  
26019  =back
26020  
26021  =item Autocreating constants
26022  
26023  =over 4
26024  
26025  =item Math library
26026  
26027  =item Using Math::BigInt::Lite
26028  
26029  =back
26030  
26031  =item EXPORTS
26032  
26033  =item BUGS
26034  
26035  =item CAVEATS
26036  
26037  stringify, bstr(), bdiv, brsft, Modifying and =, bpow, precision() vs.
26038  accuracy()
26039  
26040  =item SEE ALSO
26041  
26042  =item LICENSE
26043  
26044  =item AUTHORS
26045  
26046  =back
26047  
26048  =head2 Math::BigInt - Arbitrary size integer/float math package
26049  
26050  =over 4
26051  
26052  =item SYNOPSIS
26053  
26054  =item DESCRIPTION
26055  
26056  Input, Output
26057  
26058  =item METHODS
26059  
26060  =over 4
26061  
26062  =item config()
26063  
26064  =item accuracy()
26065  
26066  =item precision()
26067  
26068  =item brsft()
26069  
26070  =item new()
26071  
26072  =item from_oct()
26073  
26074  =item from_hex()
26075  
26076  =item from_bin()
26077  
26078  =item bnan()
26079  
26080  =item bzero()
26081  
26082  =item binf()
26083  
26084  =item bone()
26085  
26086  =item is_one()/is_zero()/is_nan()/is_inf()
26087  
26088  =item is_pos()/is_neg()/is_positive()/is_negative()
26089  
26090      $x->is_pos();            # true if > 0
26091      $x->is_neg();            # true if < 0
26092  
26093  =item is_odd()/is_even()/is_int()
26094  
26095  =item bcmp()
26096  
26097  =item bacmp()
26098  
26099  =item sign()
26100  
26101  =item digit()
26102  
26103  =item bneg()
26104  
26105  =item babs()
26106  
26107  =item bnorm()
26108  
26109  =item bnot()
26110  
26111  =item binc()
26112  
26113  =item bdec()
26114  
26115  =item badd()
26116  
26117  =item bsub()
26118  
26119  =item bmul()
26120  
26121  =item bmuladd()
26122  
26123  =item bdiv()
26124  
26125  =item bmod()
26126  
26127  =item bmodinv()
26128  
26129  =item bmodpow()
26130  
26131  =item bpow()
26132  
26133  =item blog()
26134  
26135  =item bexp()
26136  
26137  =item bnok()
26138  
26139  =item bpi()
26140  
26141  =item bcos()
26142  
26143  =item bsin()
26144  
26145  =item batan2()
26146  
26147  =item batan()
26148  
26149  =item blsft()
26150  
26151  =item brsft()
26152  
26153  =item band()
26154  
26155  =item bior()
26156  
26157  =item bxor()
26158  
26159  =item bnot()
26160  
26161  =item bsqrt()
26162  
26163  =item broot()
26164  
26165  =item bfac()
26166  
26167  =item round()
26168  
26169  =item bround()
26170  
26171  =item bfround()
26172  
26173  =item bfloor()
26174  
26175  =item bceil()
26176  
26177  =item bgcd()
26178  
26179  =item blcm()
26180  
26181  =item exponent()
26182  
26183  =item mantissa()
26184  
26185  =item parts()
26186  
26187  =item copy()
26188  
26189  =item as_int()/as_number()
26190  
26191  =item bsstr()
26192  
26193  =item as_hex()
26194  
26195  =item as_bin()
26196  
26197  =item as_oct()
26198  
26199  =item numify()
26200  
26201  =item modify()
26202  
26203  =item upgrade()/downgrade()
26204  
26205  =item div_scale()
26206  
26207  =item round_mode()
26208  
26209  =back
26210  
26211  =item ACCURACY and PRECISION
26212  
26213  =over 4
26214  
26215  =item Precision P
26216  
26217  =item Accuracy A
26218  
26219  =item Fallback F
26220  
26221  =item Rounding mode R
26222  
26223  'trunc', 'even', 'odd', '+inf', '-inf', 'zero', 'common', Precision,
26224  Accuracy (significant digits), Setting/Accessing, Creating numbers, Usage,
26225  Precedence, Overriding globals, Local settings, Rounding, Default values,
26226  Remarks
26227  
26228  =back
26229  
26230  =item Infinity and Not a Number
26231  
26232  oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
26233  
26234  =item INTERNALS
26235  
26236  =over 4
26237  
26238  =item MATH LIBRARY
26239  
26240  =item SIGN
26241  
26242  =item mantissa(), exponent() and parts()
26243  
26244  =back
26245  
26246  =item EXAMPLES
26247  
26248    use Math::BigInt;
26249  
26250  =item Autocreating constants
26251  
26252  =item PERFORMANCE
26253  
26254  =over 4
26255  
26256  =item Alternative math libraries
26257  
26258  =item SUBCLASSING
26259  
26260  =back
26261  
26262  =item Subclassing Math::BigInt
26263  
26264  =item UPGRADING
26265  
26266  =over 4
26267  
26268  =item Auto-upgrade
26269  
26270  bsqrt(), div(), blog(), bexp()
26271  
26272  =back
26273  
26274  =item EXPORTS
26275  
26276  =item CAVEATS
26277  
26278  bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
26279  Modifying and =, bpow, Overloading -$x, Mixing different object types,
26280  bsqrt(), brsft()
26281  
26282  =item LICENSE
26283  
26284  =item SEE ALSO
26285  
26286  =item AUTHORS
26287  
26288  =back
26289  
26290  =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
26291  
26292  =over 4
26293  
26294  =item SYNOPSIS
26295  
26296  =item DESCRIPTION
26297  
26298  =item STORAGE
26299  
26300  =item METHODS
26301  
26302  =item WRAP YOUR OWN
26303  
26304  =item LICENSE
26305  
26306  This program is free software; you may redistribute it and/or modify it
26307  under
26308  the same terms as Perl itself. 
26309  
26310  =item AUTHORS
26311  
26312  =item SEE ALSO
26313  
26314  =back
26315  
26316  =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
26317  
26318  =over 4
26319  
26320  =item SYNOPSIS
26321  
26322  =item DESCRIPTION
26323  
26324  =item METHODS
26325  
26326  =over 4
26327  
26328  =item __emu_bxor
26329  
26330  =item __emu_band
26331  
26332  =item __emu_bior
26333  
26334  =back
26335  
26336  =item LICENSE
26337  
26338  This program is free software; you may redistribute it and/or modify it
26339  under
26340  the same terms as Perl itself. 
26341  
26342  =item AUTHORS
26343  
26344  =item SEE ALSO
26345  
26346  =back
26347  
26348  =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
26349  speed
26350  
26351  =over 4
26352  
26353  =item SYNOPSIS
26354  
26355  =item DESCRIPTION
26356  
26357  =item STORAGE
26358  
26359  =item METHODS
26360  
26361  =item LICENSE
26362  
26363  This program is free software; you may redistribute it and/or modify it
26364  under
26365  the same terms as Perl itself. 
26366  
26367  =item AUTHORS
26368  
26369  =item SEE ALSO
26370  
26371  =back
26372  
26373  =head2 Math::BigRat - Arbitrary big rational numbers
26374  
26375  =over 4
26376  
26377  =item SYNOPSIS
26378  
26379  =item DESCRIPTION
26380  
26381  =over 4
26382  
26383  =item MATH LIBRARY
26384  
26385  =back
26386  
26387  =item METHODS
26388  
26389  =over 4
26390  
26391  =item new()
26392  
26393  =item numerator()
26394  
26395  =item denominator()
26396  
26397      $d = $x->denominator();
26398  
26399  =item parts()
26400  
26401  =item numify()
26402  
26403  =item as_int()/as_number()
26404  
26405  =item as_hex()
26406  
26407  =item as_bin()
26408  
26409  =item as_oct()
26410  
26411  =item from_hex()/from_bin()/from_oct()
26412  
26413  =item length()
26414  
26415  =item digit()
26416  
26417  =item bnorm()
26418  
26419  =item bfac()
26420  
26421  =item bround()/round()/bfround()
26422  
26423  =item bmod()
26424  
26425  =item bneg()
26426  
26427  =item is_one()
26428  
26429  =item is_zero()
26430  
26431  =item is_pos()/is_positive()
26432  
26433  =item is_neg()/is_negative()
26434  
26435  =item is_int()
26436  
26437  =item is_odd()
26438  
26439  =item is_even()
26440  
26441  =item bceil()
26442  
26443  =item bfloor()
26444  
26445      $x->bfloor();
26446  
26447  =item bsqrt()
26448  
26449      $x->bsqrt();
26450  
26451  =item broot()
26452  
26453      $x->broot($n);
26454  
26455  =item badd()/bmul()/bsub()/bdiv()/bdec()/binc()
26456  
26457  =item copy()
26458  
26459  =item bstr()/bsstr()
26460  
26461  =item bacmp()/bcmp()
26462  
26463  =item blsft()/brsft()
26464  
26465  =item bpow()
26466  
26467  =item bexp()
26468  
26469  =item bnok()
26470  
26471  =item config()
26472  
26473  =back
26474  
26475  =item BUGS
26476  
26477  inf handling (partial), NaN handling (partial), rounding (not implemented
26478  except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
26479  blog(), bmodinv() and bmodpow() (partial)
26480  
26481  =item LICENSE
26482  
26483  =item SEE ALSO
26484  
26485  =item AUTHORS
26486  
26487  =back
26488  
26489  =head2 Math::Complex - complex numbers and associated mathematical
26490  functions
26491  
26492  =over 4
26493  
26494  =item SYNOPSIS
26495  
26496  =item DESCRIPTION
26497  
26498  =item OPERATIONS
26499  
26500  =item CREATION
26501  
26502  =item DISPLAYING
26503  
26504  =over 4
26505  
26506  =item CHANGED IN PERL 5.6
26507  
26508  =back
26509  
26510  =item USAGE
26511  
26512  =over 4
26513  
26514  =item PI
26515  
26516  =back
26517  
26518  =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
26519  
26520  =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
26521  
26522  =item BUGS
26523  
26524  =item AUTHORS
26525  
26526  =back
26527  
26528  =head2 Math::Trig - trigonometric functions
26529  
26530  =over 4
26531  
26532  =item SYNOPSIS
26533  
26534  =item DESCRIPTION
26535  
26536  =item TRIGONOMETRIC FUNCTIONS
26537  
26538  B<tan>
26539  
26540  =over 4
26541  
26542  =item ERRORS DUE TO DIVISION BY ZERO
26543  
26544  =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
26545  
26546  =back
26547  
26548  =item PLANE ANGLE CONVERSIONS
26549  
26550  deg2rad, grad2rad, rad2deg, grad2deg, deg2grad, rad2grad, rad2rad, deg2deg,
26551  grad2grad
26552  
26553  =item RADIAL COORDINATE CONVERSIONS
26554  
26555  =over 4
26556  
26557  =item COORDINATE SYSTEMS
26558  
26559  =item 3-D ANGLE CONVERSIONS
26560  
26561  cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
26562  cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
26563  
26564  =back
26565  
26566  =item GREAT CIRCLE DISTANCES AND DIRECTIONS
26567  
26568  =over 4
26569  
26570  =item great_circle_distance
26571  
26572  =item great_circle_direction
26573  
26574  =item great_circle_bearing
26575  
26576  =item great_circle_destination
26577  
26578  =item great_circle_midpoint
26579  
26580  =item great_circle_waypoint
26581  
26582  =back
26583  
26584  =item EXAMPLES
26585  
26586  =over 4
26587  
26588  =item CAVEAT FOR GREAT CIRCLE FORMULAS
26589  
26590  =back
26591  
26592  =item BUGS
26593  
26594  =item AUTHORS
26595  
26596  =back
26597  
26598  =head2 Memoize - Make functions faster by trading space for time
26599  
26600  =over 4
26601  
26602  =item SYNOPSIS
26603  
26604  =item DESCRIPTION
26605  
26606  =item DETAILS
26607  
26608  =item OPTIONS
26609  
26610  =over 4
26611  
26612  =item INSTALL
26613  
26614  =item NORMALIZER
26615  
26616  =item C<SCALAR_CACHE>, C<LIST_CACHE>
26617  
26618  C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
26619  
26620  =back
26621  
26622  =item OTHER FACILITIES
26623  
26624  =over 4
26625  
26626  =item C<unmemoize>
26627  
26628  =item C<flush_cache>
26629  
26630  =back
26631  
26632  =item CAVEATS
26633  
26634  =item PERSISTENT CACHE SUPPORT
26635  
26636  =item EXPIRATION SUPPORT
26637  
26638  =item BUGS
26639  
26640  =item MAILING LIST
26641  
26642  =item AUTHOR
26643  
26644  =item COPYRIGHT AND LICENSE
26645  
26646  =item THANK YOU
26647  
26648  =back
26649  
26650  =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
26651  Storable use
26652  
26653  =over 4
26654  
26655  =item DESCRIPTION
26656  
26657  =back
26658  
26659  =head2 Memoize::Expire - Plug-in module for automatic expiration of
26660  memoized values
26661  
26662  =over 4
26663  
26664  =item SYNOPSIS
26665  
26666  =item DESCRIPTION
26667  
26668  =item INTERFACE
26669  
26670   TIEHASH,  EXISTS,  STORE
26671  
26672  =item ALTERNATIVES
26673  
26674  =item CAVEATS
26675  
26676  =item AUTHOR
26677  
26678  =item SEE ALSO
26679  
26680  =back
26681  
26682  =head2 Memoize::ExpireFile - test for Memoize expiration semantics
26683  
26684  =over 4
26685  
26686  =item DESCRIPTION
26687  
26688  =back
26689  
26690  =head2 Memoize::ExpireTest - test for Memoize expiration semantics
26691  
26692  =over 4
26693  
26694  =item DESCRIPTION
26695  
26696  =back
26697  
26698  =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
26699  Storable use
26700  
26701  =over 4
26702  
26703  =item DESCRIPTION
26704  
26705  =back
26706  
26707  =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
26708  Storable use
26709  
26710  =over 4
26711  
26712  =item DESCRIPTION
26713  
26714  =back
26715  
26716  =head2 Memoize::Storable - store Memoized data in Storable database
26717  
26718  =over 4
26719  
26720  =item DESCRIPTION
26721  
26722  =back
26723  
26724  =head2 Module::Build - Build and install Perl modules
26725  
26726  =over 4
26727  
26728  =item SYNOPSIS
26729  
26730  =item DESCRIPTION
26731  
26732  =item GUIDE TO DOCUMENTATION
26733  
26734  General Usage (L<Module::Build>), Authoring Reference
26735  (L<Module::Build::Authoring>), API Reference (L<Module::Build::API>),
26736  Cookbook (L<Module::Build::Cookbook>)
26737  
26738  =item ACTIONS
26739  
26740  build, clean, code, config_data, diff, dist, distcheck, distclean, distdir,
26741  distmeta, distsign, disttest, docs, fakeinstall, help, html, install,
26742  manifest, manpages, pardist, ppd, ppmdist, prereq_report, pure_install,
26743  realclean, retest, skipcheck, test, testall, testcover, testdb, testpod,
26744  testpodcoverage, versioninstall
26745  
26746  =item OPTIONS
26747  
26748  =over 4
26749  
26750  =item Command Line Options
26751  
26752  quiet, use_rcfile, verbose, allow_mb_mismatch
26753  
26754  =item Default Options File (F<.modulebuildrc>)
26755  
26756  =back
26757  
26758  =item INSTALL PATHS
26759  
26760  lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs,
26761  install_path, install_base, destdir, prefix
26762  
26763  =item MOTIVATIONS
26764  
26765  +, +
26766  
26767  =item TO DO
26768  
26769  =item AUTHOR
26770  
26771  =item COPYRIGHT
26772  
26773  =item SEE ALSO
26774  
26775  =back
26776  
26777  =head2 Module::Build::API - API Reference for Module Authors
26778  
26779  =over 4
26780  
26781  =item DESCRIPTION
26782  
26783  =over 4
26784  
26785  =item CONSTRUCTORS
26786  
26787  current(), new(), add_to_cleanup, auto_features, autosplit, build_class,
26788  build_requires, create_packlist, c_source, conflicts, create_makefile_pl,
26789  create_readme, dist_abstract, dist_author, dist_name, dist_version,
26790  dist_version_from, dynamic_config, extra_compiler_flags,
26791  extra_linker_flags, get_options, type, store, default, include_dirs,
26792  install_path, installdirs, license, apache, artistic, artistic_2, bsd, gpl,
26793  lgpl, mit, mozilla, open_source, perl, restrictive, unrestricted, meta_add,
26794  meta_merge, module_name, PL_files, pm_files, pod_files, recommends,
26795  recursive_test_files, requires, script_files, sign, test_files, xs_files,
26796  new_from_context(%args), resume(), subclass()
26797  
26798  =item METHODS
26799  
26800  add_build_element($type), add_to_cleanup(@files), args(),
26801  autosplit_file($from, $to), base_dir(), build_requires(),
26802  check_installed_status($module, $version), check_installed_version($module,
26803  $version), compare_versions($v1, $op, $v2), config($key), config($key,
26804  $value), config() [deprecated], config_data($name), config_data($name =>
26805  $value), conflicts(), contains_pod($file), copy_if_modified(%parameters),
26806  create_build_script(), current_action(), depends_on(@actions),
26807  dir_contains($first_dir, $second_dir), dispatch($action, %args),
26808  dist_dir(), dist_name(), dist_version(), do_system($cmd, @args),
26809  feature($name), feature($name => $value), have_c_compiler(),
26810  install_base_relpaths(), install_base_relpaths($type),
26811  install_base_relpaths($type => $path), install_destination($type),
26812  install_path(), install_path($type), install_path($type => $path),
26813  install_types(), invoked_action(), notes(), notes($key), notes($key =>
26814  $value), orig_dir(), os_type(), is_vmsish(), is_windowsish(), is_unixish(),
26815  prefix_relpaths(), prefix_relpaths($installdirs),
26816  prefix_relpaths($installdirs, $type), prefix_relpaths($installdirs, $type
26817  => $path), prepare_metadata(), prereq_failures(), prereq_report(),
26818  prompt($message, $default), recommends(), requires(), rscan_dir($dir,
26819  $pattern), runtime_params(), runtime_params($key), script_files(),
26820  up_to_date($source_file, $derived_file), up_to_date(\@source_files,
26821  \@derived_files), y_n($message, $default)
26822  
26823  =item Autogenerated Accessors
26824  
26825  PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(),
26826  blib(), build_bat(), build_class(), build_elements(), build_requires(),
26827  build_script(), c_source(), config_dir(), configure_requires(),
26828  conflicts(), create_makefile_pl(), create_packlist(), create_readme(),
26829  debugger(), destdir(), get_options(), html_css(), include_dirs(),
26830  install_base(), install_sets(), installdirs(), libdoc_dirs(), license(),
26831  magic_number(), mb_version(), meta_add(), meta_merge(), metafile(),
26832  module_name(), orig_dir(), original_prefix(), perl(), pm_files(),
26833  pod_files(), pollute(), prefix(), prereq_action_types(), quiet(),
26834  recommends(), recurse_into(), recursive_test_files(), requires(),
26835  scripts(), use_rcfile(), verbose(), xs_files()
26836  
26837  =back
26838  
26839  =item MODULE METADATA
26840  
26841  keywords, resources
26842  
26843  =item AUTHOR
26844  
26845  =item COPYRIGHT
26846  
26847  =item SEE ALSO
26848  
26849  =back
26850  
26851  =head2 Module::Build::Authoring - Authoring Module::Build modules
26852  
26853  =over 4
26854  
26855  =item DESCRIPTION
26856  
26857  =item STRUCTURE
26858  
26859  =item SUBCLASSING
26860  
26861  =item PREREQUISITES
26862  
26863  =over 4
26864  
26865  =item Types of prerequisites
26866  
26867  configure_requires, build_requires, requires, recommends, conflicts
26868  
26869  =item Format of prerequisites
26870  
26871  =item XS Extensions
26872  
26873  =back
26874  
26875  =item SAVING CONFIGURATION INFORMATION
26876  
26877  =item STARTING MODULE DEVELOPMENT
26878  
26879  =item AUTOMATION
26880  
26881  =item MIGRATION
26882  
26883  =item AUTHOR
26884  
26885  =item SEE ALSO
26886  
26887  =back
26888  
26889  =head2 Module::Build::Base - Default methods for Module::Build
26890  
26891  =over 4
26892  
26893  =item SYNOPSIS
26894  
26895  =item DESCRIPTION
26896  
26897  =item AUTHOR
26898  
26899  =item COPYRIGHT
26900  
26901  =item SEE ALSO
26902  
26903  =back
26904  
26905  =head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker
26906  
26907  =over 4
26908  
26909  =item SYNOPSIS
26910  
26911  =item DESCRIPTION
26912  
26913  =item METHODS
26914  
26915  create_makefile_pl($style, $build), small, passthrough, traditional,
26916  run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile
26917  
26918  =item SCENARIOS
26919  
26920  =item AUTHOR
26921  
26922  =item COPYRIGHT
26923  
26924  =item SEE ALSO
26925  
26926  =back
26927  
26928  =head2 Module::Build::ConfigData - Configuration for Module::Build
26929  
26930  =over 4
26931  
26932  =item SYNOPSIS
26933  
26934  =item DESCRIPTION
26935  
26936  =item METHODS
26937  
26938  config($name), feature($name), set_config($name, $value),
26939  set_feature($name, $value), config_names(), feature_names(),
26940  auto_feature_names(), write()
26941  
26942  =item AUTHOR
26943  
26944  =back
26945  
26946  =head2 Module::Build::Cookbook - Examples of Module::Build Usage
26947  
26948  =over 4
26949  
26950  =item DESCRIPTION
26951  
26952  =item BASIC RECIPES
26953  
26954  =over 4
26955  
26956  =item Installing modules that use Module::Build
26957  
26958  =item Modifying Config.pm values
26959  
26960  =item Installing modules using the programmatic interface
26961  
26962  =item Installing to a temporary directory
26963  
26964  =item Installing to a non-standard directory
26965  
26966  =item Installing in the same location as ExtUtils::MakeMaker
26967  
26968  =item Running a single test file
26969  
26970  =back
26971  
26972  =item ADVANCED RECIPES
26973  
26974  =over 4
26975  
26976  =item Making a CPAN.pm-compatible distribution
26977  
26978  =item Changing the order of the build process
26979  
26980  =item Adding new file types to the build process
26981  
26982  =item Adding new elements to the install process
26983  
26984  =back
26985  
26986  =item EXAMPLES ON CPAN
26987  
26988  =over 4
26989  
26990  =item SVN-Notify-Mirror
26991  
26992  1. Using C<auto_features>, I check to see whether two optional modules are
26993  available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config
26994  module is loaded, I automatically generate testfiles for it during Build
26995  (using the C<PL_files> property), 3. If the C<ssh_feature> is available, I
26996  ask if the user wishes to perform the ssh tests (since it requires a little
26997  preliminary setup);, 4. Only if the user has C<ssh_feature> and answers yes
26998  to the testing, do I generate a test file
26999  
27000  =item Modifying an action
27001  
27002  =back
27003  
27004  =item AUTHOR
27005  
27006  =item COPYRIGHT
27007  
27008  =item SEE ALSO
27009  
27010  =back
27011  
27012  =head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD
27013  information from a perl module files
27014  
27015  =over 4
27016  
27017  =item DESCRIPTION
27018  
27019  new_from_file($filename, collect_pod => 1), new_from_module($module,
27020  collect_pod => 1, inc => \@dirs), name(), version($package), filename(),
27021  packages_inside(), pod_inside(), contains_pod(), pod($section),
27022  find_module_by_name($module, \@dirs), find_module_dir_by_name($module,
27023  \@dirs)
27024  
27025  =item AUTHOR
27026  
27027  =item COPYRIGHT
27028  
27029  =item SEE ALSO
27030  
27031  =back
27032  
27033  =head2 Module::Build::Notes, $notes_name - Configuration for $module_name
27034  
27035  =over 4
27036  
27037  =item SYNOPSIS
27038  
27039  =item DESCRIPTION
27040  
27041  =item METHODS
27042  
27043  config(\$name), feature(\$name), set_config(\$name, \$value),
27044  set_feature(\$name, \$value), config_names(), feature_names(),
27045  auto_feature_names(), write()
27046  
27047  =item AUTHOR
27048  
27049  =back
27050  
27051  =head2 Module::Build::PPMMaker - Perl Package Manager file creation
27052  
27053  =over 4
27054  
27055  =item SYNOPSIS
27056  
27057  =item DESCRIPTION
27058  
27059  =item AUTHOR
27060  
27061  =item COPYRIGHT
27062  
27063  =item SEE ALSO
27064  
27065  =back
27066  
27067  =head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms
27068  
27069  =over 4
27070  
27071  =item DESCRIPTION
27072  
27073  =item AUTHOR
27074  
27075  =item SEE ALSO
27076  
27077  =back
27078  
27079  =head2 Module::Build::Platform::Default - Stub class for unknown platforms
27080  
27081  =over 4
27082  
27083  =item DESCRIPTION
27084  
27085  =item AUTHOR
27086  
27087  =item SEE ALSO
27088  
27089  =back
27090  
27091  =head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms
27092  
27093  =over 4
27094  
27095  =item DESCRIPTION
27096  
27097  =item AUTHOR
27098  
27099  =item SEE ALSO
27100  
27101  =back
27102  
27103  =head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms
27104  
27105  =over 4
27106  
27107  =item DESCRIPTION
27108  
27109  =item AUTHOR
27110  
27111  =item SEE ALSO
27112  
27113  =back
27114  
27115  =head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms
27116  
27117  =over 4
27118  
27119  =item DESCRIPTION
27120  
27121  =over 4
27122  
27123  =item Overriden Methods
27124  
27125  new(), make_executable(), dispatch(), ACTION_realclean()
27126  
27127  =back
27128  
27129  =item AUTHOR
27130  
27131  =item SEE ALSO
27132  
27133  =back
27134  
27135  =head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms
27136  
27137  =over 4
27138  
27139  =item DESCRIPTION
27140  
27141  =item AUTHOR
27142  
27143  =item SEE ALSO
27144  
27145  =back
27146  
27147  =head2 Module::Build::Platform::Unix - Builder class for Unix platforms
27148  
27149  =over 4
27150  
27151  =item DESCRIPTION
27152  
27153  =item AUTHOR
27154  
27155  =item SEE ALSO
27156  
27157  =back
27158  
27159  =head2 Module::Build::Platform::VMS - Builder class for VMS platforms
27160  
27161  =over 4
27162  
27163  =item DESCRIPTION
27164  
27165  =over 4
27166  
27167  =item Overridden Methods
27168  
27169  _set_defaults
27170  
27171  =back
27172  
27173  =back
27174  
27175  cull_args
27176  
27177  manpage_separator
27178  
27179  prefixify
27180  
27181  _quote_args
27182  
27183  have_forkpipe
27184  
27185  _backticks
27186  
27187  do_system
27188  
27189  _infer_xs_spec
27190  
27191  rscan_dir
27192  
27193  dist_dir
27194  
27195  man3page_name
27196  
27197  expand_test_dir
27198  
27199  _detildefy
27200  
27201  find_perl_interpreter
27202  
27203  =over 4
27204  
27205  =item AUTHOR
27206  
27207  =item SEE ALSO
27208  
27209  =back
27210  
27211  =head2 Module::Build::Platform::VOS - Builder class for VOS platforms
27212  
27213  =over 4
27214  
27215  =item DESCRIPTION
27216  
27217  =item AUTHOR
27218  
27219  =item SEE ALSO
27220  
27221  =back
27222  
27223  =head2 Module::Build::Platform::Windows - Builder class for Windows
27224  platforms
27225  
27226  =over 4
27227  
27228  =item DESCRIPTION
27229  
27230  =item AUTHOR
27231  
27232  =item SEE ALSO
27233  
27234  =back
27235  
27236  =head2 Module::Build::Platform::aix - Builder class for AIX platform
27237  
27238  =over 4
27239  
27240  =item DESCRIPTION
27241  
27242  =item AUTHOR
27243  
27244  =item SEE ALSO
27245  
27246  =back
27247  
27248  =head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform
27249  
27250  =over 4
27251  
27252  =item DESCRIPTION
27253  
27254  =item AUTHOR
27255  
27256  =item SEE ALSO
27257  
27258  =back
27259  
27260  =head2 Module::Build::Platform::darwin - Builder class for Mac OS X
27261  platform
27262  
27263  =over 4
27264  
27265  =item DESCRIPTION
27266  
27267  =item AUTHOR
27268  
27269  =item SEE ALSO
27270  
27271  =back
27272  
27273  =head2 Module::Build::Platform::os2 - Builder class for OS/2 platform
27274  
27275  =over 4
27276  
27277  =item DESCRIPTION
27278  
27279  =item AUTHOR
27280  
27281  =item SEE ALSO
27282  
27283  =back
27284  
27285  =head2 Module::Build::YAML - Provides just enough YAML support so that
27286  Module::Build works even if YAML.pm is not installed
27287  
27288  =over 4
27289  
27290  =item SYNOPSIS
27291  
27292  =item DESCRIPTION
27293  
27294  =item AUTHOR
27295  
27296  =item COPYRIGHT
27297  
27298  =back
27299  
27300  =head2 Module::CoreList - what modules shipped with versions of perl
27301  
27302  =over 4
27303  
27304  =item SYNOPSIS
27305  
27306  =item DESCRIPTION
27307  
27308  =item CAVEATS
27309  
27310  =item HISTORY
27311  
27312  =item AUTHOR
27313  
27314  =item COPYRIGHT
27315  
27316  =item SEE ALSO
27317  
27318  =back
27319  
27320  =head2 Module::Load - runtime require of both modules and files
27321  
27322  =over 4
27323  
27324  =item SYNOPSIS
27325  
27326  =item DESCRIPTION
27327  
27328  =item Rules
27329  
27330  =item Caveats
27331  
27332  =item ACKNOWLEDGEMENTS
27333  
27334  =item BUG REPORTS
27335  
27336  =item AUTHOR
27337  
27338  =item COPYRIGHT
27339  
27340  =back
27341  
27342  =head2 Module::Load::Conditional - Looking up module information / loading
27343  at runtime
27344  
27345  =over 4
27346  
27347  =item SYNOPSIS
27348  
27349  =item DESCRIPTION
27350  
27351  =item Methods
27352  
27353  =item $href = check_install( module => NAME [, version => VERSION, verbose
27354  => BOOL ] );
27355  
27356  module, version, verbose, file, version, uptodate
27357  
27358  =back
27359  
27360  =over 4
27361  
27362  =item $bool = can_load( modules => { NAME => VERSION [,NAME => VERSION] },
27363  [verbose => BOOL, nocache => BOOL] )
27364  
27365  modules, verbose, nocache
27366  
27367  =back
27368  
27369  =over 4
27370  
27371  =item @list = requires( MODULE );
27372  
27373  =back
27374  
27375  =over 4
27376  
27377  =item Global Variables
27378  
27379  =over 4
27380  
27381  =item $Module::Load::Conditional::VERBOSE
27382  
27383  =item $Module::Load::Conditional::FIND_VERSION
27384  
27385  =item $Module::Load::Conditional::CHECK_INC_HASH
27386  
27387  =item $Module::Load::Conditional::CACHE
27388  
27389  =item $Module::Load::Conditional::ERROR
27390  
27391  =back
27392  
27393  =item See Also
27394  
27395  =item BUG REPORTS
27396  
27397  =item AUTHOR
27398  
27399  =item COPYRIGHT
27400  
27401  =back
27402  
27403  =head2 Module::Loaded - mark modules as loaded or unloaded
27404  
27405  =over 4
27406  
27407  =item SYNOPSIS
27408  
27409  =item DESCRIPTION
27410  
27411  =item FUNCTIONS
27412  
27413  =over 4
27414  
27415  =item $bool = mark_as_loaded( PACKAGE );
27416  
27417  =back
27418  
27419  =back
27420  
27421  =over 4
27422  
27423  =item $bool = mark_as_unloaded( PACKAGE );
27424  
27425  =back
27426  
27427  =over 4
27428  
27429  =item $loc = is_loaded( PACKAGE );
27430  
27431  =back
27432  
27433  =over 4
27434  
27435  =item AUTHOR
27436  
27437  =item COPYRIGHT
27438  
27439  =back
27440  
27441  =head2 Module::Pluggable - automatically give your module the ability to
27442  have plugins
27443  
27444  =over 4
27445  
27446  =item SYNOPSIS
27447  
27448  =item EXAMPLE
27449  
27450  =item DESCRIPTION
27451  
27452  =item ADVANCED USAGE
27453  
27454  =item INNER PACKAGES
27455  
27456  =item OPTIONS
27457  
27458  =over 4
27459  
27460  =item sub_name
27461  
27462  =item search_path
27463  
27464  =item search_dirs 
27465  
27466  =item instantiate
27467  
27468  =item require
27469  
27470  =item inner
27471  
27472  =item only
27473  
27474  =item except
27475  
27476  =item package
27477  
27478  =item file_regex
27479  
27480  =back
27481  
27482  =item METHODs
27483  
27484  =over 4
27485  
27486  =item search_path
27487  
27488  =back
27489  
27490  =item FUTURE PLANS
27491  
27492  =item AUTHOR
27493  
27494  =item COPYING
27495  
27496  =item BUGS
27497  
27498  =item SEE ALSO
27499  
27500  =back
27501  
27502  =head2 Module::Pluggable::Object - automatically give your module the
27503  ability to have plugins
27504  
27505  =over 4
27506  
27507  =item SYNOPSIS
27508  
27509  =item DESCRIPTION
27510  
27511  =item AUTHOR
27512  
27513  =item COPYING
27514  
27515  =item BUGS
27516  
27517  =item SEE ALSO
27518  
27519  =back
27520  
27521  =head2 NDBM_File - Tied access to ndbm files
27522  
27523  =over 4
27524  
27525  =item SYNOPSIS
27526  
27527  =item DESCRIPTION
27528  
27529  C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
27530  
27531  =item DIAGNOSTICS
27532  
27533  =over 4
27534  
27535  =item C<ndbm store returned -1, errno 22, key "..." at ...>
27536  
27537  =back
27538  
27539  =item BUGS AND WARNINGS
27540  
27541  =back
27542  
27543  =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
27544  redispatch
27545  
27546  =over 4
27547  
27548  =item SYNOPSIS
27549  
27550  =item DESCRIPTION
27551  
27552  =over 4
27553  
27554  =item Enforcing redispatch
27555  
27556  =item Avoiding repetitions
27557  
27558  =item Invoking all versions of a method with a single call
27559  
27560  =item Using C<EVERY> methods
27561  
27562  =back
27563  
27564  =item AUTHOR
27565  
27566  =item BUGS AND IRRITATIONS
27567  
27568  =item COPYRIGHT
27569  
27570  =back
27571  
27572  =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
27573  
27574  =over 4
27575  
27576  =item SYNOPSIS
27577  
27578  =item DESCRIPTION
27579  
27580  =item USER METHODS
27581  
27582  debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
27583  dataend ()
27584  
27585  =item CLASS METHODS
27586  
27587  debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
27588  ]), unsupported (), response (), parse_response ( TEXT ), getline (),
27589  ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
27590  
27591  =item EXPORTS
27592  
27593  =item AUTHOR
27594  
27595  =item COPYRIGHT
27596  
27597  =back
27598  
27599  =head2 Net::Config - Local configuration data for libnet
27600  
27601  =over 4
27602  
27603  =item SYNOPSYS
27604  
27605  =item DESCRIPTION
27606  
27607  =item METHODS
27608  
27609  requires_firewall HOST
27610  
27611  =item NetConfig VALUES
27612  
27613  nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
27614  time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
27615  ftp_int_passive, local_netmask, test_hosts, test_exists
27616  
27617  =back
27618  
27619  =head2 Net::Domain - Attempt to evaluate the current host's internet name
27620  and domain
27621  
27622  =over 4
27623  
27624  =item SYNOPSIS
27625  
27626  =item DESCRIPTION
27627  
27628  hostfqdn (), domainname (), hostname (), hostdomain ()
27629  
27630  =item AUTHOR
27631  
27632  =item COPYRIGHT
27633  
27634  =back
27635  
27636  =head2 Net::FTP - FTP Client class
27637  
27638  =over 4
27639  
27640  =item SYNOPSIS
27641  
27642  =item DESCRIPTION
27643  
27644  =item OVERVIEW
27645  
27646  =item CONSTRUCTOR
27647  
27648  new ([ HOST ] [, OPTIONS ])
27649  
27650  =item METHODS
27651  
27652  login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
27653  site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
27654  ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
27655  RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
27656  [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
27657  put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
27658  ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
27659  size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
27660  BYTES_PER_HASH_MARK] ), feature ( NAME ), nlst ( [ DIR ] ), list ( [ DIR ]
27661  ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [
27662  PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
27663  pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
27664  NON_PASV_SERVER ), abort (), quit ()
27665  
27666  =over 4
27667  
27668  =item Methods for the adventurous
27669  
27670  quot (CMD [,ARGS])
27671  
27672  =back
27673  
27674  =item THE dataconn CLASS
27675  
27676  read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
27677  bytes_read (), abort (), close ()
27678  
27679  =item UNIMPLEMENTED
27680  
27681  B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
27682  
27683  =item REPORTING BUGS
27684  
27685  =item AUTHOR
27686  
27687  =item SEE ALSO
27688  
27689  =item USE EXAMPLES
27690  
27691  http://www.csh.rit.edu/~adam/Progs/
27692  
27693  =item CREDITS
27694  
27695  =item COPYRIGHT
27696  
27697  =back
27698  
27699  =head2 Net::NNTP - NNTP Client class
27700  
27701  =over 4
27702  
27703  =item SYNOPSIS
27704  
27705  =item DESCRIPTION
27706  
27707  =item CONSTRUCTOR
27708  
27709  new ( [ HOST ] [, OPTIONS ])
27710  
27711  =item METHODS
27712  
27713  article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
27714  [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
27715  MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
27716  ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
27717  postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
27718  DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
27719  post ( [ MESSAGE ] ), postfh (), slave (), quit ()
27720  
27721  =over 4
27722  
27723  =item Extension methods
27724  
27725  newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
27726  overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
27727  ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
27728  MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
27729  GROUP ] ), reader
27730  
27731  =back
27732  
27733  =item UNSUPPORTED
27734  
27735  =item DEFINITIONS
27736  
27737  MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
27738  
27739  =item SEE ALSO
27740  
27741  =item AUTHOR
27742  
27743  =item COPYRIGHT
27744  
27745  =back
27746  
27747  =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
27748  
27749  =over 4
27750  
27751  =item SYNOPSIS
27752  
27753  =item DESCRIPTION
27754  
27755  =item CONSTRUCTOR
27756  
27757  new ( [ HOST ] [, OPTIONS ] 0
27758  
27759  =item METHODS
27760  
27761  auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
27762  [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
27763  (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
27764  ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
27765  ), delete ( MSGNUM ), reset (), quit ()
27766  
27767  =item NOTES
27768  
27769  =item SEE ALSO
27770  
27771  =item AUTHOR
27772  
27773  =item COPYRIGHT
27774  
27775  =back
27776  
27777  =head2 Net::Ping - check a remote host for reachability
27778  
27779  =over 4
27780  
27781  =item SYNOPSIS
27782  
27783  =item DESCRIPTION
27784  
27785  =over 4
27786  
27787  =item Functions
27788  
27789  Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
27790  ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
27791  $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
27792  $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
27793  [ $host ] );, $p->nack( $failed_ack_host );, $p->close();,
27794  $p->port_number([$port_number]), pingecho($host [, $timeout]);
27795  
27796  =back
27797  
27798  =item NOTES
27799  
27800  =item INSTALL
27801  
27802  =item BUGS
27803  
27804  =item AUTHORS
27805  
27806  =item COPYRIGHT
27807  
27808  =back
27809  
27810  =head2 Net::SMTP - Simple Mail Transfer Protocol Client
27811  
27812  =over 4
27813  
27814  =item SYNOPSIS
27815  
27816  =item DESCRIPTION
27817  
27818  =item EXAMPLES
27819  
27820  =item CONSTRUCTOR
27821  
27822  new ( [ HOST ] [, OPTIONS ] )
27823  
27824  =item METHODS
27825  
27826  banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
27827  USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
27828  send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
27829  ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
27830  ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
27831  data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
27832  $subject ] ), quit ()
27833  
27834  =item ADDRESSES
27835  
27836  =item SEE ALSO
27837  
27838  =item AUTHOR
27839  
27840  =item COPYRIGHT
27841  
27842  =back
27843  
27844  =head2 Net::Time - time and daytime network client interface
27845  
27846  =over 4
27847  
27848  =item SYNOPSIS
27849  
27850  =item DESCRIPTION
27851  
27852  inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
27853  PROTOCOL [, TIMEOUT]]])
27854  
27855  =item AUTHOR
27856  
27857  =item COPYRIGHT
27858  
27859  =back
27860  
27861  =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
27862  functions
27863  
27864  =over 4
27865  
27866  =item SYNOPSIS
27867  
27868  =item DESCRIPTION
27869  
27870  =item EXAMPLES
27871  
27872  =item NOTE
27873  
27874  =item AUTHOR
27875  
27876  =back
27877  
27878  =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
27879  
27880  =over 4
27881  
27882  =item DESCRIPTION
27883  
27884  =over 4
27885  
27886  =item Where to get this document
27887  
27888  =item How to contribute to this document
27889  
27890  =back
27891  
27892  =item Author and Copyright Information
27893  
27894  =over 4
27895  
27896  =item Disclaimer
27897  
27898  =back
27899  
27900  =item Obtaining and installing libnet
27901  
27902  =over 4
27903  
27904  =item What is libnet ?
27905  
27906  =item Which version of perl do I need ?
27907  
27908  =item What other modules do I need ?
27909  
27910  =item What machines support libnet ?
27911  
27912  =item Where can I get the latest libnet release
27913  
27914  =back
27915  
27916  =item Using Net::FTP
27917  
27918  =over 4
27919  
27920  =item How do I download files from an FTP server ?
27921  
27922  =item How do I transfer files in binary mode ?
27923  
27924  =item How can I get the size of a file on a remote FTP server ?
27925  
27926  =item How can I get the modification time of a file on a remote FTP server
27927  ?
27928  
27929  =item How can I change the permissions of a file on a remote server ?
27930  
27931  =item Can I do a reget operation like the ftp command ?
27932  
27933  =item How do I get a directory listing from an FTP server ?
27934  
27935  =item Changing directory to "" does not fail ?
27936  
27937  =item I am behind a SOCKS firewall, but the Firewall option does not work ?
27938  
27939  =item I am behind an FTP proxy firewall, but cannot access machines outside
27940  ?
27941  
27942  =item My ftp proxy firewall does not listen on port 21
27943  
27944  =item Is it possible to change the file permissions of a file on an FTP
27945  server ?
27946  
27947  =item I have seen scripts call a method message, but cannot find it
27948  documented ?
27949  
27950  =item Why does Net::FTP not implement mput and mget methods
27951  
27952  =back
27953  
27954  =item Using Net::SMTP
27955  
27956  =over 4
27957  
27958  =item Why can't the part of an Email address after the @ be used as the
27959  hostname ?
27960  
27961  =item Why does Net::SMTP not do DNS MX lookups ?
27962  
27963  =item The verify method always returns true ?
27964  
27965  =back
27966  
27967  =item Debugging scripts
27968  
27969  =over 4
27970  
27971  =item How can I debug my scripts that use Net::* modules ?
27972  
27973  =back
27974  
27975  =item AUTHOR AND COPYRIGHT
27976  
27977  =back
27978  
27979  =head2 Net::netent - by-name interface to Perl's built-in getnet*()
27980  functions
27981  
27982  =over 4
27983  
27984  =item SYNOPSIS
27985  
27986  =item DESCRIPTION
27987  
27988  =item EXAMPLES
27989  
27990  =item NOTE
27991  
27992  =item AUTHOR
27993  
27994  =back
27995  
27996  =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
27997  functions
27998  
27999  =over 4
28000  
28001  =item SYNOPSIS
28002  
28003  =item DESCRIPTION
28004  
28005  =item NOTE
28006  
28007  =item AUTHOR
28008  
28009  =back
28010  
28011  =head2 Net::servent - by-name interface to Perl's built-in getserv*()
28012  functions
28013  
28014  =over 4
28015  
28016  =item SYNOPSIS
28017  
28018  =item DESCRIPTION
28019  
28020  =item EXAMPLES
28021  
28022  =item NOTE
28023  
28024  =item AUTHOR
28025  
28026  =back
28027  
28028  =head2 Netrc, Net::Netrc - OO interface to users netrc file
28029  
28030  =over 4
28031  
28032  =item SYNOPSIS
28033  
28034  =item DESCRIPTION
28035  
28036  =item THE .netrc FILE
28037  
28038  machine name, default, login name, password string, account string, macdef
28039  name
28040  
28041  =item CONSTRUCTOR
28042  
28043  lookup ( MACHINE [, LOGIN ])
28044  
28045  =item METHODS
28046  
28047  login (), password (), account (), lpa ()
28048  
28049  =item AUTHOR
28050  
28051  =item SEE ALSO
28052  
28053  =item COPYRIGHT
28054  
28055  =back
28056  
28057  =head2 O - Generic interface to Perl Compiler backends
28058  
28059  =over 4
28060  
28061  =item SYNOPSIS
28062  
28063  =item DESCRIPTION
28064  
28065  =item CONVENTIONS
28066  
28067  =item IMPLEMENTATION
28068  
28069  =item BUGS
28070  
28071  =item AUTHOR
28072  
28073  =back
28074  
28075  =head2 ODBM_File - Tied access to odbm files
28076  
28077  =over 4
28078  
28079  =item SYNOPSIS
28080  
28081  =item DESCRIPTION
28082  
28083  C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
28084  
28085  =item DIAGNOSTICS
28086  
28087  =over 4
28088  
28089  =item C<odbm store returned -1, errno 22, key "..." at ...>
28090  
28091  =back
28092  
28093  =item BUGS AND WARNINGS
28094  
28095  =back
28096  
28097  =head2 Object::Accessor
28098  
28099  =over 4
28100  
28101  =item SYNOPSIS
28102  
28103  =item DESCRIPTION
28104  
28105  =item METHODS
28106  
28107  =over 4
28108  
28109  =item $object = Object::Accessor->new( [ARGS] );
28110  
28111  =back
28112  
28113  =back
28114  
28115  =over 4
28116  
28117  =item $bool = $object->mk_accessors( @ACCESSORS | \%ACCESSOR_MAP );
28118  
28119  =back
28120  
28121  =over 4
28122  
28123  =item @list = $self->ls_accessors;
28124  
28125  =back
28126  
28127  =over 4
28128  
28129  =item $ref = $self->ls_allow(KEY)
28130  
28131  =back
28132  
28133  =over 4
28134  
28135  =item $clone = $self->mk_clone;
28136  
28137  =back
28138  
28139  =over 4
28140  
28141  =item $bool = $self->mk_flush;
28142  
28143  =back
28144  
28145  =over 4
28146  
28147  =item $bool = $self->mk_verify;
28148  
28149  =back
28150  
28151  =over 4
28152  
28153  =item $bool = $self->register_callback( sub { ... } );
28154  
28155  =back
28156  
28157  =over 4
28158  
28159  =item $bool = $self->can( METHOD_NAME )
28160  
28161  =back
28162  
28163  =over 4
28164  
28165  =item $val = $self->___get( METHOD_NAME );
28166  
28167  =back
28168  
28169  =over 4
28170  
28171  =item $bool = $self->___set( METHOD_NAME => VALUE );
28172  
28173  =back
28174  
28175  =over 4
28176  
28177  =item LVALUE ACCESSORS
28178  
28179  =over 4
28180  
28181  =item CAVEATS
28182  
28183  Allow handlers, Callbacks
28184  
28185  =back
28186  
28187  =back
28188  
28189  =over 4
28190  
28191  =item GLOBAL VARIABLES
28192  
28193  =over 4
28194  
28195  =item $Object::Accessor::FATAL
28196  
28197  =item $Object::Accessor::DEBUG
28198  
28199  =back
28200  
28201  =item TODO
28202  
28203  =over 4
28204  
28205  =item Create read-only accessors
28206  
28207  =back
28208  
28209  =item CAVEATS
28210  
28211  =item AUTHOR
28212  
28213  =item COPYRIGHT
28214  
28215  =back
28216  
28217  =head2 Opcode - Disable named opcodes when compiling perl code
28218  
28219  =over 4
28220  
28221  =item SYNOPSIS
28222  
28223  =item DESCRIPTION
28224  
28225  =item NOTE
28226  
28227  =item WARNING
28228  
28229  =item Operator Names and Operator Lists
28230  
28231  an operator name (opname), an operator tag name (optag), a negated opname
28232  or optag, an operator set (opset)
28233  
28234  =item Opcode Functions
28235  
28236  opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
28237  full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
28238  define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
28239  opdump (PAT)
28240  
28241  =item Manipulating Opsets
28242  
28243  =item TO DO (maybe)
28244  
28245  =back
28246  
28247  =over 4
28248  
28249  =item Predefined Opcode Tags
28250  
28251  :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
28252  :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
28253  :filesys_write, :subprocess, :ownprocess, :others, :load,
28254  :still_to_be_decided, :dangerous
28255  
28256  =item SEE ALSO
28257  
28258  =item AUTHORS
28259  
28260  =back
28261  
28262  =head2 Opcode::Safe, Safe - Compile and execute code in restricted
28263  compartments
28264  
28265  =over 4
28266  
28267  =item SYNOPSIS
28268  
28269  =item DESCRIPTION
28270  
28271  a new namespace, an operator mask
28272  
28273  =item WARNING
28274  
28275  =over 4
28276  
28277  =item RECENT CHANGES
28278  
28279  =item Methods in class Safe
28280  
28281  permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
28282  ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
28283  (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
28284  root (NAMESPACE), mask (MASK)
28285  
28286  =item Some Safety Issues
28287  
28288  Memory, CPU, Snooping, Signals, State Changes
28289  
28290  =item AUTHOR
28291  
28292  =back
28293  
28294  =back
28295  
28296  =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
28297  compiling
28298  
28299  =over 4
28300  
28301  =item SYNOPSIS    
28302  
28303  =item DESCRIPTION
28304  
28305  =item SEE ALSO
28306  
28307  =back
28308  
28309  =head2 POSIX - Perl interface to IEEE Std 1003.1
28310  
28311  =over 4
28312  
28313  =item SYNOPSIS
28314  
28315  =item DESCRIPTION
28316  
28317  =item NOTE
28318  
28319  =item CAVEATS
28320  
28321  =item FUNCTIONS
28322  
28323  _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
28324  atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
28325  clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
28326  cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
28327  execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
28328  fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
28329  fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
28330  fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
28331  geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
28332  getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
28333  isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
28334  isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
28335  log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
28336  memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
28337  offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
28338  putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
28339  rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
28340  setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
28341  sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
28342  strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
28343  strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
28344  strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
28345  tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
28346  tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
28347  unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
28348  wctomb, write
28349  
28350  =item CLASSES
28351  
28352  =over 4
28353  
28354  =item POSIX::SigAction
28355  
28356  new, handler, mask, flags, safe
28357  
28358  =item POSIX::SigRt
28359  
28360  %SIGRT, SIGRTMIN, SIGRTMAX
28361  
28362  =item POSIX::SigSet
28363  
28364  new, addset, delset, emptyset, fillset, ismember
28365  
28366  =item POSIX::Termios
28367  
28368  new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
28369  getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
28370  setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
28371  field values, c_cflag field values, c_iflag field values, c_lflag field
28372  values, c_oflag field values
28373  
28374  =back
28375  
28376  =item PATHNAME CONSTANTS
28377  
28378  Constants
28379  
28380  =item POSIX CONSTANTS
28381  
28382  Constants
28383  
28384  =item SYSTEM CONFIGURATION
28385  
28386  Constants
28387  
28388  =item ERRNO
28389  
28390  Constants
28391  
28392  =item FCNTL
28393  
28394  Constants
28395  
28396  =item FLOAT
28397  
28398  Constants
28399  
28400  =item LIMITS
28401  
28402  Constants
28403  
28404  =item LOCALE
28405  
28406  Constants
28407  
28408  =item MATH
28409  
28410  Constants
28411  
28412  =item SIGNAL
28413  
28414  Constants
28415  
28416  =item STAT
28417  
28418  Constants, Macros
28419  
28420  =item STDLIB
28421  
28422  Constants
28423  
28424  =item STDIO
28425  
28426  Constants
28427  
28428  =item TIME
28429  
28430  Constants
28431  
28432  =item UNISTD
28433  
28434  Constants
28435  
28436  =item WAIT
28437  
28438  Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
28439  WTERMSIG, WIFSTOPPED, WSTOPSIG
28440  
28441  =back
28442  
28443  =head2 Package::Constants - List all constants declared in a package
28444  
28445  =over 4
28446  
28447  =item SYNOPSIS
28448  
28449  =item DESCRIPTION
28450  
28451  =item CLASS METHODS
28452  
28453  =over 4
28454  
28455  =item @const = Package::Constants->list( PACKAGE_NAME );
28456  
28457  =back
28458  
28459  =back
28460  
28461  =over 4
28462  
28463  =item GLOBAL VARIABLES
28464  
28465  =over 4
28466  
28467  =item $Package::Constants::DEBUG
28468  
28469  =back
28470  
28471  =back
28472  
28473  =over 4
28474  
28475  =item AUTHOR
28476  
28477  =item COPYRIGHT
28478  
28479  =back
28480  
28481  =head2 Params::Check - A generic input parsing/checking mechanism.
28482  
28483  =over 4
28484  
28485  =item SYNOPSIS
28486  
28487  =item DESCRIPTION
28488  
28489  =item Template
28490  
28491  default, required, strict_type, defined, no_override, store, allow
28492  
28493  =item Functions
28494  
28495  =over 4
28496  
28497  =item check( \%tmpl, \%args, [$verbose] );
28498  
28499  Template, Arguments, Verbose
28500  
28501  =back
28502  
28503  =back
28504  
28505  =over 4
28506  
28507  =item allow( $test_me, \@criteria );
28508  
28509  string, regexp, subroutine, array ref
28510  
28511  =back
28512  
28513  =over 4
28514  
28515  =item last_error()
28516  
28517  =back
28518  
28519  =over 4
28520  
28521  =item Global Variables
28522  
28523  =over 4
28524  
28525  =item $Params::Check::VERBOSE
28526  
28527  =item $Params::Check::STRICT_TYPE
28528  
28529  =item $Params::Check::ALLOW_UNKNOWN
28530  
28531  =item $Params::Check::STRIP_LEADING_DASHES
28532  
28533  =item $Params::Check::NO_DUPLICATES
28534  
28535  =item $Params::Check::PRESERVE_CASE
28536  
28537  =item $Params::Check::ONLY_ALLOW_DEFINED
28538  
28539  =item $Params::Check::SANITY_CHECK_TEMPLATE
28540  
28541  =item $Params::Check::WARNINGS_FATAL
28542  
28543  =item $Params::Check::CALLER_DEPTH
28544  
28545  =back
28546  
28547  =item AUTHOR
28548  
28549  =item Acknowledgements
28550  
28551  =item COPYRIGHT
28552  
28553  =back
28554  
28555  =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
28556  name space
28557  
28558  =over 4
28559  
28560  =item SYNOPSIS
28561  
28562  =item DESCRIPTION
28563  
28564  :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
28565  
28566  =over 4
28567  
28568  =item Custom Layers
28569  
28570  :encoding, :via
28571  
28572  =item Alternatives to raw
28573  
28574  =item Defaults and how to override them
28575  
28576  =item Querying the layers of filehandles
28577  
28578  =back
28579  
28580  =item AUTHOR
28581  
28582  =item SEE ALSO
28583  
28584  =back
28585  
28586  =head2 PerlIO::encoding - encoding layer
28587  
28588  =over 4
28589  
28590  =item SYNOPSIS
28591  
28592  =item DESCRIPTION
28593  
28594  =item SEE ALSO
28595  
28596  =back
28597  
28598  =head2 PerlIO::scalar - in-memory IO, scalar IO
28599  
28600  =over 4
28601  
28602  =item SYNOPSIS
28603  
28604  =item DESCRIPTION
28605  
28606  =item IMPLEMENTATION NOTE
28607  
28608  =back
28609  
28610  =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
28611  
28612  =over 4
28613  
28614  =item SYNOPSIS
28615  
28616  =item DESCRIPTION
28617  
28618  =item EXPECTED METHODS
28619  
28620  $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
28621  $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
28622  $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
28623  $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
28624  $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
28625  $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
28626  $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
28627  $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
28628  
28629  =item EXAMPLES
28630  
28631  =over 4
28632  
28633  =item Example - a Hexadecimal Handle
28634  
28635  =back
28636  
28637  =back
28638  
28639  =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
28640  
28641  =over 4
28642  
28643  =item SYNOPSIS
28644  
28645  =item DESCRIPTION
28646  
28647  =item REQUIRED MODULES
28648  
28649  =item SEE ALSO
28650  
28651  =item ACKNOWLEDGEMENTS
28652  
28653  =item COPYRIGHT
28654  
28655  =back
28656  
28657  =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
28658  
28659  =over 4
28660  
28661  =item SYNOPSIS
28662  
28663  =item OPTIONS/ARGUMENTS
28664  
28665  =over 4
28666  
28667  =item podchecker()
28668  
28669  B<-warnings> =E<gt> I<val>
28670  
28671  =back
28672  
28673  =item DESCRIPTION
28674  
28675  =item DIAGNOSTICS
28676  
28677  =over 4
28678  
28679  =item Errors
28680  
28681  empty =headn, =over on line I<N> without closing =back, =item without
28682  previous =over, =back without previous =over, No argument for =begin, =end
28683  without =begin, Nested =begin's, =for without formatter specification,
28684  unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
28685  interior-sequence "I<SEQ>", nested commands
28686  I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
28687  number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
28688  empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
28689  after =back
28690  
28691  =item Warnings
28692  
28693  multiple occurrence of link target I<name>, line containing nothing but
28694  whitespace in paragraph, file does not start with =head, previous =item has
28695  no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
28696  vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
28697  items in =over, No argument for =item, empty section in previous paragraph,
28698  Verbatim paragraph in NAME section, =headI<n> without preceding higher
28699  level
28700  
28701  =item Hyperlinks
28702  
28703  ignoring leading/trailing whitespace in link, (section) in '$page'
28704  deprecated, alternative text/node '%s' contains non-escaped | or /
28705  
28706  =back
28707  
28708  =item RETURN VALUE
28709  
28710  =item EXAMPLES
28711  
28712  =item INTERFACE
28713  
28714  =back
28715  
28716  C<Pod::Checker-E<gt>new( %options )>
28717  
28718  C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
28719  @args )>
28720  
28721  C<$checker-E<gt>num_errors()>
28722  
28723  C<$checker-E<gt>num_warnings()>
28724  
28725  C<$checker-E<gt>name()>
28726  
28727  C<$checker-E<gt>node()>
28728  
28729  C<$checker-E<gt>idx()>
28730  
28731  C<$checker-E<gt>hyperlink()>
28732  
28733  =over 4
28734  
28735  =item AUTHOR
28736  
28737  =back
28738  
28739  =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
28740  
28741  =over 4
28742  
28743  =item SYNOPSIS
28744  
28745  =item DESCRIPTION
28746  
28747  =item GOODIES
28748  
28749  e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
28750  $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
28751  $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
28752  
28753  =item CAVEATS
28754  
28755  =item SEE ALSO
28756  
28757  =item COPYRIGHT AND DISCLAIMERS
28758  
28759  =item AUTHOR
28760  
28761  =back
28762  
28763  =head2 Pod::Find - find POD documents in directory trees
28764  
28765  =over 4
28766  
28767  =item SYNOPSIS
28768  
28769  =item DESCRIPTION
28770  
28771  =back
28772  
28773  =over 4
28774  
28775  =item C<pod_find( { %opts } , @directories )>
28776  
28777  C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
28778  1>
28779  
28780  =back
28781  
28782  =over 4
28783  
28784  =item C<simplify_name( $str )>
28785  
28786  =back
28787  
28788  =over 4
28789  
28790  =item C<pod_where( { %opts }, $pod )>
28791  
28792  C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
28793  1>
28794  
28795  =back
28796  
28797  =over 4
28798  
28799  =item C<contains_pod( $file , $verbose )>
28800  
28801  =back
28802  
28803  =over 4
28804  
28805  =item AUTHOR
28806  
28807  =item SEE ALSO
28808  
28809  =back
28810  
28811  =head2 Pod::Html - module to convert pod files to HTML
28812  
28813  =over 4
28814  
28815  =item SYNOPSIS
28816  
28817  =item DESCRIPTION
28818  
28819  =item FUNCTIONS
28820  
28821  =over 4
28822  
28823  =item pod2html
28824  
28825  backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
28826  htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
28827  quiet, recurse, title, verbose
28828  
28829  =item htmlify
28830  
28831  =item anchorify
28832  
28833  =back
28834  
28835  =item ENVIRONMENT
28836  
28837  =item AUTHOR
28838  
28839  =item SEE ALSO
28840  
28841  =item COPYRIGHT
28842  
28843  =back
28844  
28845  =head2 Pod::InputObjects - objects representing POD input paragraphs,
28846  commands, etc.
28847  
28848  =over 4
28849  
28850  =item SYNOPSIS
28851  
28852  =item REQUIRES
28853  
28854  =item EXPORTS
28855  
28856  =item DESCRIPTION
28857  
28858  package B<Pod::InputSource>, package B<Pod::Paragraph>, package
28859  B<Pod::InteriorSequence>, package B<Pod::ParseTree>
28860  
28861  =back
28862  
28863  =over 4
28864  
28865  =item B<Pod::InputSource>
28866  
28867  =back
28868  
28869  =over 4
28870  
28871  =item B<new()>
28872  
28873  =back
28874  
28875  =over 4
28876  
28877  =item B<name()>
28878  
28879  =back
28880  
28881  =over 4
28882  
28883  =item B<handle()>
28884  
28885  =back
28886  
28887  =over 4
28888  
28889  =item B<was_cutting()>
28890  
28891  =back
28892  
28893  =over 4
28894  
28895  =item B<Pod::Paragraph>
28896  
28897  =back
28898  
28899  =over 4
28900  
28901  =item Pod::Paragraph-E<gt>B<new()>
28902  
28903  =back
28904  
28905  =over 4
28906  
28907  =item $pod_para-E<gt>B<cmd_name()>
28908  
28909  =back
28910  
28911  =over 4
28912  
28913  =item $pod_para-E<gt>B<text()>
28914  
28915  =back
28916  
28917  =over 4
28918  
28919  =item $pod_para-E<gt>B<raw_text()>
28920  
28921  =back
28922  
28923  =over 4
28924  
28925  =item $pod_para-E<gt>B<cmd_prefix()>
28926  
28927  =back
28928  
28929  =over 4
28930  
28931  =item $pod_para-E<gt>B<cmd_separator()>
28932  
28933  =back
28934  
28935  =over 4
28936  
28937  =item $pod_para-E<gt>B<parse_tree()>
28938  
28939  =back
28940  
28941  =over 4
28942  
28943  =item $pod_para-E<gt>B<file_line()>
28944  
28945  =back
28946  
28947  =over 4
28948  
28949  =item B<Pod::InteriorSequence>
28950  
28951  =back
28952  
28953  =over 4
28954  
28955  =item Pod::InteriorSequence-E<gt>B<new()>
28956  
28957  =back
28958  
28959  =over 4
28960  
28961  =item $pod_seq-E<gt>B<cmd_name()>
28962  
28963  =back
28964  
28965  =over 4
28966  
28967  =item $pod_seq-E<gt>B<prepend()>
28968  
28969  =back
28970  
28971  =over 4
28972  
28973  =item $pod_seq-E<gt>B<append()>
28974  
28975  =back
28976  
28977  =over 4
28978  
28979  =item $pod_seq-E<gt>B<nested()>
28980  
28981  =back
28982  
28983  =over 4
28984  
28985  =item $pod_seq-E<gt>B<raw_text()>
28986  
28987  =back
28988  
28989  =over 4
28990  
28991  =item $pod_seq-E<gt>B<left_delimiter()>
28992  
28993  =back
28994  
28995  =over 4
28996  
28997  =item $pod_seq-E<gt>B<right_delimiter()>
28998  
28999  =back
29000  
29001  =over 4
29002  
29003  =item $pod_seq-E<gt>B<parse_tree()>
29004  
29005  =back
29006  
29007  =over 4
29008  
29009  =item $pod_seq-E<gt>B<file_line()>
29010  
29011  =back
29012  
29013  =over 4
29014  
29015  =item Pod::InteriorSequence::B<DESTROY()>
29016  
29017  =back
29018  
29019  =over 4
29020  
29021  =item B<Pod::ParseTree>
29022  
29023  =back
29024  
29025  =over 4
29026  
29027  =item Pod::ParseTree-E<gt>B<new()>
29028  
29029  =back
29030  
29031  =over 4
29032  
29033  =item $ptree-E<gt>B<top()>
29034  
29035  =back
29036  
29037  =over 4
29038  
29039  =item $ptree-E<gt>B<children()>
29040  
29041  =back
29042  
29043  =over 4
29044  
29045  =item $ptree-E<gt>B<prepend()>
29046  
29047  =back
29048  
29049  =over 4
29050  
29051  =item $ptree-E<gt>B<append()>
29052  
29053  =back
29054  
29055  =over 4
29056  
29057  =item $ptree-E<gt>B<raw_text()>
29058  
29059  =back
29060  
29061  =over 4
29062  
29063  =item Pod::ParseTree::B<DESTROY()>
29064  
29065  =back
29066  
29067  =over 4
29068  
29069  =item SEE ALSO
29070  
29071  =item AUTHOR
29072  
29073  =back
29074  
29075  =head2 Pod::LaTeX - Convert Pod data to formatted Latex
29076  
29077  =over 4
29078  
29079  =item SYNOPSIS
29080  
29081  =item DESCRIPTION
29082  
29083  =back
29084  
29085  =over 4
29086  
29087  =item OBJECT METHODS
29088  
29089  C<initialize>
29090  
29091  =back
29092  
29093  =over 4
29094  
29095  =item Data Accessors
29096  
29097  B<AddPreamble>
29098  
29099  =back
29100  
29101  B<AddPostamble>
29102  
29103  B<Head1Level>
29104  
29105  B<Label>
29106  
29107  B<LevelNoNum>
29108  
29109  B<MakeIndex>
29110  
29111  B<ReplaceNAMEwithSection>
29112  
29113  B<StartWithNewPage>
29114  
29115  B<TableOfContents>
29116  
29117  B<UniqueLabels>
29118  
29119  B<UserPreamble>
29120  
29121  B<UserPostamble>
29122  
29123  B<Lists>
29124  
29125  =over 4
29126  
29127  =item Subclassed methods
29128  
29129  =back
29130  
29131  B<begin_pod>
29132  
29133  B<end_pod>
29134  
29135  B<command>
29136  
29137  B<verbatim>
29138  
29139  B<textblock>
29140  
29141  B<interior_sequence>
29142  
29143  =over 4
29144  
29145  =item List Methods
29146  
29147  B<begin_list>
29148  
29149  =back
29150  
29151  B<end_list>
29152  
29153  B<add_item>
29154  
29155  =over 4
29156  
29157  =item Methods for headings
29158  
29159  B<head>
29160  
29161  =back
29162  
29163  =over 4
29164  
29165  =item Internal methods
29166  
29167  B<_output>
29168  
29169  =back
29170  
29171  B<_replace_special_chars>
29172  
29173  B<_replace_special_chars_late>
29174  
29175  B<_create_label>
29176  
29177  B<_create_index>
29178  
29179  B<_clean_latex_commands>
29180  
29181  B<_split_delimited>
29182  
29183  =over 4
29184  
29185  =item NOTES
29186  
29187  =item SEE ALSO
29188  
29189  =item AUTHORS
29190  
29191  =item COPYRIGHT
29192  
29193  =item REVISION
29194  
29195  =back
29196  
29197  =head2 Pod::Man - Convert POD data to formatted *roff input
29198  
29199  =over 4
29200  
29201  =item SYNOPSIS
29202  
29203  =item DESCRIPTION
29204  
29205  center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
29206  release, section
29207  
29208  =item DIAGNOSTICS
29209  
29210  roff font should be 1 or 2 chars, not "%s", Invalid quote specification
29211  "%s"
29212  
29213  =item BUGS
29214  
29215  =item CAVEATS
29216  
29217  =item AUTHOR
29218  
29219  =item COPYRIGHT AND LICENSE
29220  
29221  =item SEE ALSO
29222  
29223  =back
29224  
29225  =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
29226  
29227  =over 4
29228  
29229  =item SYNOPSIS
29230  
29231  =item DESCRIPTION
29232  
29233  =item SEE ALSO
29234  
29235  =item AUTHOR
29236  
29237  =item COPYRIGHT AND LICENSE
29238  
29239  =back
29240  
29241  =head2 Pod::ParseUtils - helpers for POD parsing and conversion
29242  
29243  =over 4
29244  
29245  =item SYNOPSIS
29246  
29247  =item DESCRIPTION
29248  
29249  =back
29250  
29251  =over 4
29252  
29253  =item Pod::List
29254  
29255  Pod::List-E<gt>new()
29256  
29257  =back
29258  
29259  $list-E<gt>file()
29260  
29261  $list-E<gt>start()
29262  
29263  $list-E<gt>indent()
29264  
29265  $list-E<gt>type()
29266  
29267  $list-E<gt>rx()
29268  
29269  $list-E<gt>item()
29270  
29271  $list-E<gt>parent()
29272  
29273  $list-E<gt>tag()
29274  
29275  =over 4
29276  
29277  =item Pod::Hyperlink
29278  
29279  Pod::Hyperlink-E<gt>new()
29280  
29281  =back
29282  
29283  $link-E<gt>parse($string)
29284  
29285  $link-E<gt>markup($string)
29286  
29287  $link-E<gt>text()
29288  
29289  $link-E<gt>warning()
29290  
29291  $link-E<gt>file(), $link-E<gt>line()
29292  
29293  $link-E<gt>page()
29294  
29295  $link-E<gt>node()
29296  
29297  $link-E<gt>alttext()
29298  
29299  $link-E<gt>type()
29300  
29301  $link-E<gt>link()
29302  
29303  =over 4
29304  
29305  =item Pod::Cache
29306  
29307  Pod::Cache-E<gt>new()
29308  
29309  =back
29310  
29311  $cache-E<gt>item()
29312  
29313  $cache-E<gt>find_page($name)
29314  
29315  =over 4
29316  
29317  =item Pod::Cache::Item
29318  
29319  Pod::Cache::Item-E<gt>new()
29320  
29321  =back
29322  
29323  $cacheitem-E<gt>page()
29324  
29325  $cacheitem-E<gt>description()
29326  
29327  $cacheitem-E<gt>path()
29328  
29329  $cacheitem-E<gt>file()
29330  
29331  $cacheitem-E<gt>nodes()
29332  
29333  $cacheitem-E<gt>find_node($name)
29334  
29335  $cacheitem-E<gt>idx()
29336  
29337  =over 4
29338  
29339  =item AUTHOR
29340  
29341  =item SEE ALSO
29342  
29343  =back
29344  
29345  =head2 Pod::Parser - base class for creating POD filters and translators
29346  
29347  =over 4
29348  
29349  =item SYNOPSIS
29350  
29351  =item REQUIRES
29352  
29353  =item EXPORTS
29354  
29355  =item DESCRIPTION
29356  
29357  =item QUICK OVERVIEW
29358  
29359  =item PARSING OPTIONS
29360  
29361  B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
29362  B<-warnings> (default: unset)
29363  
29364  =back
29365  
29366  =over 4
29367  
29368  =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
29369  
29370  =back
29371  
29372  =over 4
29373  
29374  =item B<command()>
29375  
29376  C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
29377  
29378  =back
29379  
29380  =over 4
29381  
29382  =item B<verbatim()>
29383  
29384  C<$text>, C<$line_num>, C<$pod_para>
29385  
29386  =back
29387  
29388  =over 4
29389  
29390  =item B<textblock()>
29391  
29392  C<$text>, C<$line_num>, C<$pod_para>
29393  
29394  =back
29395  
29396  =over 4
29397  
29398  =item B<interior_sequence()>
29399  
29400  =back
29401  
29402  =over 4
29403  
29404  =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
29405  
29406  =back
29407  
29408  =over 4
29409  
29410  =item B<new()>
29411  
29412  =back
29413  
29414  =over 4
29415  
29416  =item B<initialize()>
29417  
29418  =back
29419  
29420  =over 4
29421  
29422  =item B<begin_pod()>
29423  
29424  =back
29425  
29426  =over 4
29427  
29428  =item B<begin_input()>
29429  
29430  =back
29431  
29432  =over 4
29433  
29434  =item B<end_input()>
29435  
29436  =back
29437  
29438  =over 4
29439  
29440  =item B<end_pod()>
29441  
29442  =back
29443  
29444  =over 4
29445  
29446  =item B<preprocess_line()>
29447  
29448  =back
29449  
29450  =over 4
29451  
29452  =item B<preprocess_paragraph()>
29453  
29454  =back
29455  
29456  =over 4
29457  
29458  =item METHODS FOR PARSING AND PROCESSING
29459  
29460  =back
29461  
29462  =over 4
29463  
29464  =item B<parse_text()>
29465  
29466  B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
29467  I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
29468  I<code-ref>|I<method-name>
29469  
29470  =back
29471  
29472  =over 4
29473  
29474  =item B<interpolate()>
29475  
29476  =back
29477  
29478  =over 4
29479  
29480  =item B<parse_paragraph()>
29481  
29482  =back
29483  
29484  =over 4
29485  
29486  =item B<parse_from_filehandle()>
29487  
29488  =back
29489  
29490  =over 4
29491  
29492  =item B<parse_from_file()>
29493  
29494  =back
29495  
29496  =over 4
29497  
29498  =item ACCESSOR METHODS
29499  
29500  =back
29501  
29502  =over 4
29503  
29504  =item B<errorsub()>
29505  
29506  =back
29507  
29508  =over 4
29509  
29510  =item B<cutting()>
29511  
29512  =back
29513  
29514  =over 4
29515  
29516  =item B<parseopts()>
29517  
29518  =back
29519  
29520  =over 4
29521  
29522  =item B<output_file()>
29523  
29524  =back
29525  
29526  =over 4
29527  
29528  =item B<output_handle()>
29529  
29530  =back
29531  
29532  =over 4
29533  
29534  =item B<input_file()>
29535  
29536  =back
29537  
29538  =over 4
29539  
29540  =item B<input_handle()>
29541  
29542  =back
29543  
29544  =over 4
29545  
29546  =item B<input_streams()>
29547  
29548  =back
29549  
29550  =over 4
29551  
29552  =item B<top_stream()>
29553  
29554  =back
29555  
29556  =over 4
29557  
29558  =item PRIVATE METHODS AND DATA
29559  
29560  =back
29561  
29562  =over 4
29563  
29564  =item B<_push_input_stream()>
29565  
29566  =back
29567  
29568  =over 4
29569  
29570  =item B<_pop_input_stream()>
29571  
29572  =back
29573  
29574  =over 4
29575  
29576  =item TREE-BASED PARSING
29577  
29578  =item CAVEATS
29579  
29580  =item SEE ALSO
29581  
29582  =item AUTHOR
29583  
29584  =back
29585  
29586  =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
29587  
29588  =over 4
29589  
29590  =item SYNOPSIS
29591  
29592  =item DESCRIPTION
29593  
29594  =item SEE ALSO
29595  
29596  =item COPYRIGHT AND DISCLAIMERS
29597  
29598  =item AUTHOR
29599  
29600  =back
29601  
29602  =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
29603  
29604  =over 4
29605  
29606  =item SYNOPSIS
29607  
29608  =item DESCRIPTION
29609  
29610  =item CAVEAT
29611  
29612  =item SEE ALSO
29613  
29614  =item COPYRIGHT AND DISCLAIMERS
29615  
29616  =item AUTHOR
29617  
29618  =back
29619  
29620  =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
29621  
29622  =over 4
29623  
29624  =item SYNOPSIS
29625  
29626  =item DESCRIPTION
29627  
29628  =item CAVEAT
29629  
29630  =item SEE ALSO
29631  
29632  =item COPYRIGHT AND DISCLAIMERS
29633  
29634  =item AUTHOR
29635  
29636  =back
29637  
29638  =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
29639  
29640  =over 4
29641  
29642  =item SYNOPSIS
29643  
29644  =item DESCRIPTION
29645  
29646  =item SEE ALSO
29647  
29648  =item COPYRIGHT AND DISCLAIMERS
29649  
29650  =item AUTHOR
29651  
29652  =back
29653  
29654  =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
29655  
29656  =over 4
29657  
29658  =item SYNOPSIS
29659  
29660  =item DESCRIPTION
29661  
29662  =item SEE ALSO
29663  
29664  =item COPYRIGHT AND DISCLAIMERS
29665  
29666  =item AUTHOR
29667  
29668  =back
29669  
29670  =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
29671  
29672  =over 4
29673  
29674  =item SYNOPSIS
29675  
29676  =item DESCRIPTION
29677  
29678  =item CAVEAT
29679  
29680  =item SEE ALSO
29681  
29682  =item COPYRIGHT AND DISCLAIMERS
29683  
29684  =item AUTHOR
29685  
29686  =back
29687  
29688  =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
29689  
29690  =over 4
29691  
29692  =item SYNOPSIS
29693  
29694  =item DESCRIPTION
29695  
29696  =item SEE ALSO
29697  
29698  =item AUTHOR
29699  
29700  =back
29701  
29702  =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
29703  
29704  =over 4
29705  
29706  =item SYNOPSIS
29707  
29708  =item DESCRIPTION
29709  
29710  =item SEE ALSO
29711  
29712  =item COPYRIGHT AND DISCLAIMERS
29713  
29714  =item AUTHOR
29715  
29716  =back
29717  
29718  =head2 Pod::PlainText - Convert POD data to formatted ASCII text
29719  
29720  =over 4
29721  
29722  =item SYNOPSIS
29723  
29724  =item DESCRIPTION
29725  
29726  alt, indent, loose, sentence, width
29727  
29728  =item DIAGNOSTICS
29729  
29730  Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
29731  Unknown sequence: %s, Unmatched =back
29732  
29733  =item RESTRICTIONS
29734  
29735  =item NOTES
29736  
29737  =item SEE ALSO
29738  
29739  =item AUTHOR
29740  
29741  =back
29742  
29743  =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
29744  
29745  =over 4
29746  
29747  =item SYNOPSIS
29748  
29749  =item DESCRIPTION
29750  
29751  =over 4
29752  
29753  =item EXPORT
29754  
29755  =back
29756  
29757  =item AUTHOR
29758  
29759  =item SEE ALSO
29760  
29761  =back
29762  
29763  =head2 Pod::Select, podselect() - extract selected sections of POD from
29764  input
29765  
29766  =over 4
29767  
29768  =item SYNOPSIS
29769  
29770  =item REQUIRES
29771  
29772  =item EXPORTS
29773  
29774  =item DESCRIPTION
29775  
29776  =item SECTION SPECIFICATIONS
29777  
29778  =item RANGE SPECIFICATIONS
29779  
29780  =back
29781  
29782  =over 4
29783  
29784  =item OBJECT METHODS
29785  
29786  =back
29787  
29788  =over 4
29789  
29790  =item B<curr_headings()>
29791  
29792  =back
29793  
29794  =over 4
29795  
29796  =item B<select()>
29797  
29798  =back
29799  
29800  =over 4
29801  
29802  =item B<add_selection()>
29803  
29804  =back
29805  
29806  =over 4
29807  
29808  =item B<clear_selections()>
29809  
29810  =back
29811  
29812  =over 4
29813  
29814  =item B<match_section()>
29815  
29816  =back
29817  
29818  =over 4
29819  
29820  =item B<is_selected()>
29821  
29822  =back
29823  
29824  =over 4
29825  
29826  =item EXPORTED FUNCTIONS
29827  
29828  =back
29829  
29830  =over 4
29831  
29832  =item B<podselect()>
29833  
29834  B<-output>, B<-sections>, B<-ranges>
29835  
29836  =back
29837  
29838  =over 4
29839  
29840  =item PRIVATE METHODS AND DATA
29841  
29842  =back
29843  
29844  =over 4
29845  
29846  =item B<_compile_section_spec()>
29847  
29848  =back
29849  
29850  =over 4
29851  
29852  =item $self->{_SECTION_HEADINGS}
29853  
29854  =back
29855  
29856  =over 4
29857  
29858  =item $self->{_SELECTED_SECTIONS}
29859  
29860  =back
29861  
29862  =over 4
29863  
29864  =item SEE ALSO
29865  
29866  =item AUTHOR
29867  
29868  =back
29869  
29870  =head2 Pod::Simple - framework for parsing Pod
29871  
29872  =over 4
29873  
29874  =item SYNOPSIS
29875  
29876  =item DESCRIPTION
29877  
29878  =item MAIN METHODS
29879  
29880  C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
29881  C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
29882  I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
29883  $parser->parse_string_document( I<$all_content> ); >>, C<<
29884  $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
29885  $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
29886  I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
29887  I<\$document_content> ); >>
29888  
29889  =item SECONDARY METHODS
29890  
29891  C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
29892  I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
29893  $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
29894  $parser->source_dead >>
29895  
29896  =item CAVEATS
29897  
29898  =item SEE ALSO
29899  
29900  =item COPYRIGHT AND DISCLAIMERS
29901  
29902  =item AUTHOR
29903  
29904  =back
29905  
29906  =head2 Pod::Simple::Checker -- check the Pod syntax of a document
29907  
29908  =over 4
29909  
29910  =item SYNOPSIS
29911  
29912  =item DESCRIPTION
29913  
29914  =item SEE ALSO
29915  
29916  =item COPYRIGHT AND DISCLAIMERS
29917  
29918  =item AUTHOR
29919  
29920  =back
29921  
29922  =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
29923  
29924  =over 4
29925  
29926  =item SYNOPSIS
29927  
29928  =item DESCRIPTION
29929  
29930  =item CAVEATS
29931  
29932  =item GUTS
29933  
29934  =item SEE ALSO
29935  
29936  =item COPYRIGHT AND DISCLAIMERS
29937  
29938  =item AUTHOR
29939  
29940  =back
29941  
29942  =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
29943  
29944  =over 4
29945  
29946  =item SYNOPSIS
29947  
29948  =item DESCRIPTION
29949  
29950  =item SEE ALSO
29951  
29952  =item COPYRIGHT AND DISCLAIMERS
29953  
29954  =item AUTHOR
29955  
29956  =back
29957  
29958  =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
29959  
29960  =over 4
29961  
29962  =item SYNOPSIS
29963  
29964  =item DESCRIPTION
29965  
29966  =item SEE ALSO
29967  
29968  =item COPYRIGHT AND DISCLAIMERS
29969  
29970  =item AUTHOR
29971  
29972  =back
29973  
29974  =head2 Pod::Simple::HTML - convert Pod to HTML
29975  
29976  =over 4
29977  
29978  =item SYNOPSIS
29979  
29980  =item DESCRIPTION
29981  
29982  =item CALLING FROM THE COMMAND LINE
29983  
29984  =item CALLING FROM PERL
29985  
29986  =item METHODS
29987  
29988  =item SUBCLASSING
29989  
29990  =item SEE ALSO
29991  
29992  =item COPYRIGHT AND DISCLAIMERS
29993  
29994  =item AUTHOR
29995  
29996  =back
29997  
29998  =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
29999  files
30000  
30001  =over 4
30002  
30003  =item SYNOPSIS
30004  
30005  =item DESCRIPTION
30006  
30007  =over 4
30008  
30009  =item FROM THE COMMAND LINE
30010  
30011  =back
30012  
30013  =item MAIN METHODS
30014  
30015  $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
30016  I<indirs>, I<outdir> );, $batchconv->batch_convert( undef    , ...);,
30017  $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
30018  \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
30019  $batchconv->batch_convert( 'somedir:someother:also' , ...);,
30020  $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
30021  'somedir' );
30022  
30023  =over 4
30024  
30025  =item ACCESSOR METHODS
30026  
30027  $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
30028  I<true-or-false> );, $batchconv->contents_file( I<filename> );,
30029  $batchconv->contents_page_start( I<HTML_string> );,
30030  $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
30031  );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
30032  I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
30033  $batchconv->no_contents_links( I<true-or-false> );,
30034  $batchconv->html_render_class( I<classname> );
30035  
30036  =back
30037  
30038  =item NOTES ON CUSTOMIZATION
30039  
30040  =item ASK ME!
30041  
30042  =item SEE ALSO
30043  
30044  =item COPYRIGHT AND DISCLAIMERS
30045  
30046  =item AUTHOR
30047  
30048  =back
30049  
30050  =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
30051  codes
30052  
30053  =over 4
30054  
30055  =item SYNOPSIS
30056  
30057  =item DESCRIPTION
30058  
30059  =item SEE ALSO
30060  
30061  =item COPYRIGHT AND DISCLAIMERS
30062  
30063  =item AUTHOR
30064  
30065  =back
30066  
30067  =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
30068  
30069  =over 4
30070  
30071  =item SYNOPSIS
30072  
30073  =item DESCRIPTION
30074  
30075  =item METHOD CALLING
30076  
30077  =item SEE ALSO
30078  
30079  =item COPYRIGHT AND DISCLAIMERS
30080  
30081  =item AUTHOR
30082  
30083  =back
30084  
30085  =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
30086  
30087  =over 4
30088  
30089  =item SYNOPSIS
30090  
30091  =item DESCRIPTION
30092  
30093  =item METHODS
30094  
30095  my $token = $parser->get_token, $parser->unget_token( $token ),
30096  $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
30097  $filename ), $parser->set_source( $filehandle_object ),
30098  $parser->set_source( \$document_source ), $parser->set_source(
30099  \@document_lines ), $parser->parse_file(...),
30100  $parser->parse_string_document(...), $parser->filter(...),
30101  $parser->parse_from_file(...), my $title_string = $parser->get_title, my
30102  $title_string = $parser->get_short_title, $author_name     =
30103  $parser->get_author, $description_name = $parser->get_description,
30104  $version_block = $parser->get_version
30105  
30106  =item NOTE
30107  
30108  =item SEE ALSO
30109  
30110  =item COPYRIGHT AND DISCLAIMERS
30111  
30112  =item AUTHOR
30113  
30114  =back
30115  
30116  =head2 Pod::Simple::PullParserEndToken -- end-tokens from
30117  Pod::Simple::PullParser
30118  
30119  =over 4
30120  
30121  =item SYNOPSIS
30122  
30123  =item DESCRIPTION
30124  
30125  $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
30126  $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
30127  
30128  =item SEE ALSO
30129  
30130  =item COPYRIGHT AND DISCLAIMERS
30131  
30132  =item AUTHOR
30133  
30134  =back
30135  
30136  =head2 Pod::Simple::PullParserStartToken -- start-tokens from
30137  Pod::Simple::PullParser
30138  
30139  =over 4
30140  
30141  =item SYNOPSIS
30142  
30143  =item DESCRIPTION
30144  
30145  $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
30146  $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
30147  $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
30148  $token->attr_hash
30149  
30150  =item SEE ALSO
30151  
30152  =item COPYRIGHT AND DISCLAIMERS
30153  
30154  =item AUTHOR
30155  
30156  =back
30157  
30158  =head2 Pod::Simple::PullParserTextToken -- text-tokens from
30159  Pod::Simple::PullParser
30160  
30161  =over 4
30162  
30163  =item SYNOPSIS
30164  
30165  =item DESCRIPTION
30166  
30167  $token->text, $token->text(I<somestring>), $token->text_r()
30168  
30169  =item SEE ALSO
30170  
30171  =item COPYRIGHT AND DISCLAIMERS
30172  
30173  =item AUTHOR
30174  
30175  =back
30176  
30177  =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
30178  
30179  =over 4
30180  
30181  =item SYNOPSIS
30182  
30183  =item DESCRIPTION
30184  
30185  $token->type, $token->is_start, $token->is_text, $token->is_end,
30186  $token->dump
30187  
30188  =item SEE ALSO
30189  
30190  =item COPYRIGHT AND DISCLAIMERS
30191  
30192  =item AUTHOR
30193  
30194  =back
30195  
30196  =head2 Pod::Simple::RTF -- format Pod as RTF
30197  
30198  =over 4
30199  
30200  =item SYNOPSIS
30201  
30202  =item DESCRIPTION
30203  
30204  =item FORMAT CONTROL ATTRIBUTES
30205  
30206  $parser->head1_halfpoint_size( I<halfpoint_integer> );,
30207  $parser->head2_halfpoint_size( I<halfpoint_integer> );,
30208  $parser->head3_halfpoint_size( I<halfpoint_integer> );,
30209  $parser->head4_halfpoint_size( I<halfpoint_integer> );,
30210  $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
30211  $parser->header_halfpoint_size( I<halfpoint_integer> );,
30212  $parser->normal_halfpoint_size( I<halfpoint_integer> );,
30213  $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
30214  I<microsoft_decimal_language_code> )
30215  
30216  =item SEE ALSO
30217  
30218  =item COPYRIGHT AND DISCLAIMERS
30219  
30220  =item AUTHOR
30221  
30222  =back
30223  
30224  =head2 Pod::Simple::Search - find POD documents in directory trees
30225  
30226  =over 4
30227  
30228  =item SYNOPSIS
30229  
30230  =item DESCRIPTION
30231  
30232  =item CONSTRUCTOR
30233  
30234  =item ACCESSORS
30235  
30236  $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
30237  );, $search->limit_glob( I<some-glob-string> );, $search->callback(
30238  I<\&some_routine> );, $search->laborious( I<true-or-false> );,
30239  $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
30240  $search->dir_prefix( I<some-string-value> );, $search->progress(
30241  I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
30242  $self->path2name;
30243  
30244  =item MAIN SEARCH METHODS
30245  
30246  =over 4
30247  
30248  =item C<< $search->survey( @directories ) >>
30249  
30250  C<name2path>, C<path2name>
30251  
30252  =item C<< $search->simplify_name( $str ) >>
30253  
30254  =item C<< $search->find( $pod ) >>
30255  
30256  =item C<< $search->find( $pod, @search_dirs ) >>
30257  
30258  =item C<< $self->contains_pod( $file ) >>
30259  
30260  =back
30261  
30262  =item AUTHOR
30263  
30264  =item SEE ALSO
30265  
30266  =back
30267  
30268  =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
30269  subclass
30270  
30271  =over 4
30272  
30273  =item SYNOPSIS
30274  
30275  =item DESCRIPTION
30276  
30277  =item Events
30278  
30279  C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
30280  C<< $parser->_handle_element_end( I<element_name>  ) >>, C<<
30281  $parser->_handle_text(    I<text_string>    ) >>, events with an element_name
30282  of Document, events with an element_name of Para, events with an
30283  element_name of B, C, F, or I, events with an element_name of S, events
30284  with an element_name of X, events with an element_name of L, events with an
30285  element_name of E or Z, events with an element_name of Verbatim, events
30286  with an element_name of head1 .. head4, events with an element_name of
30287  over-bullet, events with an element_name of over-number, events with an
30288  element_name of over-text, events with an element_name of over-block,
30289  events with an element_name of item-bullet, events with an element_name of
30290  item-number, events with an element_name of item-text, events with an
30291  element_name of for, events with an element_name of Data
30292  
30293  =item More Pod::Simple Methods
30294  
30295  C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
30296  $parser->accept_targets_as_text(  I<SOMEVALUE>    ) >>, C<<
30297  $parser->accept_codes( I<Codename>, I<Codename>...  ) >>, C<<
30298  $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
30299  $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
30300  $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
30301  $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
30302  C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
30303  $parser->nix_X_codes(  I<SOMEVALUE>  ) >>, C<< $parser->merge_text( 
30304  I<SOMEVALUE>  ) >>, C<< $parser->code_handler(    I<CODE_REF>  ) >>, C<<
30305  $parser->cut_handler(  I<CODE_REF>  ) >>, C<< $parser->whine(
30306  I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
30307  I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
30308  C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
30309  I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
30310  $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
30311  I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
30312  
30313  =item SEE ALSO
30314  
30315  =item COPYRIGHT AND DISCLAIMERS
30316  
30317  =item AUTHOR
30318  
30319  =back
30320  
30321  =head2 Pod::Simple::Text -- format Pod as plaintext
30322  
30323  =over 4
30324  
30325  =item SYNOPSIS
30326  
30327  =item DESCRIPTION
30328  
30329  =item SEE ALSO
30330  
30331  =item COPYRIGHT AND DISCLAIMERS
30332  
30333  =item AUTHOR
30334  
30335  =back
30336  
30337  =head2 Pod::Simple::TextContent -- get the text content of Pod
30338  
30339  =over 4
30340  
30341  =item SYNOPSIS
30342  
30343  =item DESCRIPTION
30344  
30345  =item SEE ALSO
30346  
30347  =item COPYRIGHT AND DISCLAIMERS
30348  
30349  =item AUTHOR
30350  
30351  =back
30352  
30353  =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
30354  
30355  =over 4
30356  
30357  =item SYNOPSIS
30358  
30359  =item DESCRIPTION
30360  
30361  =item SEE ALSO
30362  
30363  =item ABOUT EXTENDING POD
30364  
30365  =item ASK ME!
30366  
30367  =item COPYRIGHT AND DISCLAIMERS
30368  
30369  =item AUTHOR
30370  
30371  =back
30372  
30373  =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
30374  parse tree 
30375  
30376  =over 4
30377  
30378  =item SYNOPSIS
30379  
30380  =item DESCRIPTION
30381  
30382  =item METHODS
30383  
30384  =item Tree Contents
30385  
30386  =item SEE ALSO
30387  
30388  =item COPYRIGHT AND DISCLAIMERS
30389  
30390  =item AUTHOR
30391  
30392  =back
30393  
30394  =head2 Pod::Text - Convert POD data to formatted ASCII text
30395  
30396  =over 4
30397  
30398  =item SYNOPSIS
30399  
30400  =item DESCRIPTION
30401  
30402  alt, code, indent, loose, margin, quotes, sentence, width
30403  
30404  =item DIAGNOSTICS
30405  
30406  Bizarre space in item, Item called without tag, Can't open %s for reading:
30407  %s, Invalid quote specification "%s"
30408  
30409  =item NOTES
30410  
30411  =item SEE ALSO
30412  
30413  =item AUTHOR
30414  
30415  =item COPYRIGHT AND LICENSE
30416  
30417  =back
30418  
30419  =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
30420  
30421  =over 4
30422  
30423  =item SYNOPSIS
30424  
30425  =item DESCRIPTION
30426  
30427  =item BUGS
30428  
30429  =item SEE ALSO
30430  
30431  =item AUTHOR
30432  
30433  =item COPYRIGHT AND LICENSE
30434  
30435  =back
30436  
30437  =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
30438  text
30439  
30440  =over 4
30441  
30442  =item SYNOPSIS
30443  
30444  =item DESCRIPTION
30445  
30446  =item BUGS
30447  
30448  =item SEE ALSO
30449  
30450  =item AUTHOR
30451  
30452  =item COPYRIGHT AND LICENSE
30453  
30454  =back
30455  
30456  =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
30457  escapes
30458  
30459  =over 4
30460  
30461  =item SYNOPSIS
30462  
30463  =item DESCRIPTION
30464  
30465  =item NOTES
30466  
30467  =item SEE ALSO
30468  
30469  =item AUTHOR
30470  
30471  =item COPYRIGHT AND LICENSE
30472  
30473  =back
30474  
30475  =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
30476  documentation
30477  
30478  =over 4
30479  
30480  =item SYNOPSIS
30481  
30482  =item ARGUMENTS
30483  
30484  C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
30485  C<-input>, C<-pathlist>, C<-noperldoc>
30486  
30487  =item DESCRIPTION
30488  
30489  =item EXAMPLES
30490  
30491  =over 4
30492  
30493  =item Recommended Use
30494  
30495  =back
30496  
30497  =item CAVEATS
30498  
30499  =item AUTHOR
30500  
30501  =item ACKNOWLEDGMENTS
30502  
30503  =back
30504  
30505  =head2 SDBM_File - Tied access to sdbm files
30506  
30507  =over 4
30508  
30509  =item SYNOPSIS
30510  
30511  =item DESCRIPTION
30512  
30513  C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
30514  
30515  =item DIAGNOSTICS
30516  
30517  =over 4
30518  
30519  =item C<sdbm store returned -1, errno 22, key "..." at ...>
30520  
30521  =back
30522  
30523  =item BUGS AND WARNINGS
30524  
30525  =back
30526  
30527  =head2 Safe - Compile and execute code in restricted compartments
30528  
30529  =over 4
30530  
30531  =item SYNOPSIS
30532  
30533  =item DESCRIPTION
30534  
30535  a new namespace, an operator mask
30536  
30537  =item WARNING
30538  
30539  =over 4
30540  
30541  =item RECENT CHANGES
30542  
30543  =item Methods in class Safe
30544  
30545  permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
30546  ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
30547  (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
30548  root (NAMESPACE), mask (MASK)
30549  
30550  =item Some Safety Issues
30551  
30552  Memory, CPU, Snooping, Signals, State Changes
30553  
30554  =item AUTHOR
30555  
30556  =back
30557  
30558  =back
30559  
30560  =head2 Scalar::Util - A selection of general-utility scalar subroutines
30561  
30562  =over 4
30563  
30564  =item SYNOPSIS
30565  
30566  =item DESCRIPTION
30567  
30568  blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
30569  looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
30570  set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
30571  
30572  =item KNOWN BUGS
30573  
30574  =item SEE ALSO
30575  
30576  =item COPYRIGHT
30577  
30578  =item BLATANT PLUG
30579  
30580  =back
30581  
30582  =head2 Search::Dict, look - search for key in dictionary file
30583  
30584  =over 4
30585  
30586  =item SYNOPSIS
30587  
30588  =item DESCRIPTION
30589  
30590  =back
30591  
30592  =head2 SelectSaver - save and restore selected file handle
30593  
30594  =over 4
30595  
30596  =item SYNOPSIS
30597  
30598  =item DESCRIPTION
30599  
30600  =back
30601  
30602  =head2 SelfLoader - load functions only on demand
30603  
30604  =over 4
30605  
30606  =item SYNOPSIS
30607  
30608  =item DESCRIPTION
30609  
30610  =over 4
30611  
30612  =item The __DATA__ token
30613  
30614  =item SelfLoader autoloading
30615  
30616  =item Autoloading and package lexicals
30617  
30618  =item SelfLoader and AutoLoader
30619  
30620  =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
30621  
30622  =item Classes and inherited methods.
30623  
30624  =back
30625  
30626  =item Multiple packages and fully qualified subroutine names
30627  
30628  =back
30629  
30630  B<_make_cmd>
30631  
30632  =head2 Shell - run shell commands transparently within perl
30633  
30634  =over 4
30635  
30636  =item SYNOPSIS
30637  
30638  =item DESCRIPTION
30639  
30640  =over 4
30641  
30642  =item Caveats
30643  
30644  =item Escaping Magic Characters
30645  
30646  =item Configuration
30647  
30648  =back
30649  
30650  =item BUGS
30651  
30652  =item AUTHOR
30653  
30654  =back
30655  
30656  =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
30657  socket.h defines and structure manipulators 
30658  
30659  =over 4
30660  
30661  =item SYNOPSIS
30662  
30663  =item DESCRIPTION
30664  
30665  inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
30666  INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
30667  ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
30668  unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
30669  SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
30670  
30671  =back
30672  
30673  =head2 Storable - persistence for Perl data structures
30674  
30675  =over 4
30676  
30677  =item SYNOPSIS
30678  
30679  =item DESCRIPTION
30680  
30681  =item MEMORY STORE
30682  
30683  =item ADVISORY LOCKING
30684  
30685  =item SPEED
30686  
30687  =item CANONICAL REPRESENTATION
30688  
30689  =item CODE REFERENCES
30690  
30691  =item FORWARD COMPATIBILITY
30692  
30693  utf8 data, restricted hashes, files from future versions of Storable
30694  
30695  =item ERROR REPORTING
30696  
30697  =item WIZARDS ONLY
30698  
30699  =over 4
30700  
30701  =item Hooks
30702  
30703  C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
30704  I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
30705  
30706  =item Predicates
30707  
30708  C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
30709  C<Storable::is_retrieving>
30710  
30711  =item Recursion
30712  
30713  =item Deep Cloning
30714  
30715  =back
30716  
30717  =item Storable magic
30718  
30719  $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
30720  C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
30721  C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
30722  $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
30723  
30724  =item EXAMPLES
30725  
30726  =item WARNING
30727  
30728  =item BUGS
30729  
30730  =over 4
30731  
30732  =item 64 bit data in perl 5.6.0 and 5.6.1
30733  
30734  =back
30735  
30736  =item CREDITS
30737  
30738  =item AUTHOR
30739  
30740  =item SEE ALSO
30741  
30742  =back
30743  
30744  =head2 Switch - A switch statement for Perl
30745  
30746  =over 4
30747  
30748  =item VERSION
30749  
30750  =item SYNOPSIS
30751  
30752  =item BACKGROUND
30753  
30754  =item DESCRIPTION
30755  
30756  =over 4
30757  
30758  =item Allowing fall-through
30759  
30760  =item Automating fall-through
30761  
30762  =item Alternative syntax
30763  
30764  =item Higher-order Operations
30765  
30766  =back
30767  
30768  =item DEPENDENCIES
30769  
30770  =item AUTHOR
30771  
30772  =item BUGS
30773  
30774  =item LIMITATIONS
30775  
30776  =item COPYRIGHT
30777  
30778  =back
30779  
30780  =head2 Symbol - manipulate Perl symbols and their names
30781  
30782  =over 4
30783  
30784  =item SYNOPSIS
30785  
30786  =item DESCRIPTION
30787  
30788  =item BUGS
30789  
30790  =back
30791  
30792  =head2 Sys::Hostname - Try every conceivable way to get hostname
30793  
30794  =over 4
30795  
30796  =item SYNOPSIS
30797  
30798  =item DESCRIPTION
30799  
30800  =item AUTHOR
30801  
30802  =back
30803  
30804  =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
30805  
30806  =over 4
30807  
30808  =item VERSION
30809  
30810  =item SYNOPSIS
30811  
30812  =item DESCRIPTION
30813  
30814  =item EXPORTS
30815  
30816  =item FUNCTIONS
30817  
30818  B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
30819  B<syslog($priority, $format, @args)>, B<Note>,
30820  B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
30821  B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
30822  B<Note>, B<closelog()>
30823  
30824  =item THE RULES OF SYS::SYSLOG
30825  
30826  =item EXAMPLES
30827  
30828  =item CONSTANTS
30829  
30830  =over 4
30831  
30832  =item Facilities
30833  
30834  =item Levels
30835  
30836  =back
30837  
30838  =item DIAGNOSTICS
30839  
30840  C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
30841  but no Win32 API available>, C<no connection to syslog available>, C<stream
30842  passed to setlogsock, but %s is not writable>, C<stream passed to
30843  setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
30844  tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
30845  invalid level/facility: %s>, C<syslog: too many levels given: %s>,
30846  C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
30847  C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
30848  setlogsock, but path not available>
30849  
30850  =item SEE ALSO
30851  
30852  =over 4
30853  
30854  =item Manual Pages
30855  
30856  =item RFCs
30857  
30858  =item Articles
30859  
30860  =item Event Log
30861  
30862  =back
30863  
30864  =item AUTHORS & ACKNOWLEDGEMENTS
30865  
30866  =item BUGS
30867  
30868  =item SUPPORT
30869  
30870  AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
30871  tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
30872  
30873  =item COPYRIGHT
30874  
30875  =item LICENSE
30876  
30877  =back
30878  
30879  =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
30880  calls
30881  
30882  =over 4
30883  
30884  =item VERSION
30885  
30886  =item SYNOPSIS
30887  
30888  =item DESCRIPTION
30889  
30890  =item EXPORTS
30891  
30892  =item FUNCTIONS
30893  
30894  B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
30895  B<syslog($priority, $format, @args)>, B<Note>,
30896  B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
30897  B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
30898  B<Note>, B<closelog()>
30899  
30900  =item THE RULES OF SYS::SYSLOG
30901  
30902  =item EXAMPLES
30903  
30904  =item CONSTANTS
30905  
30906  =over 4
30907  
30908  =item Facilities
30909  
30910  =item Levels
30911  
30912  =back
30913  
30914  =item DIAGNOSTICS
30915  
30916  C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
30917  but no Win32 API available>, C<no connection to syslog available>, C<stream
30918  passed to setlogsock, but %s is not writable>, C<stream passed to
30919  setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
30920  tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
30921  invalid level/facility: %s>, C<syslog: too many levels given: %s>,
30922  C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
30923  C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
30924  setlogsock, but path not available>
30925  
30926  =item SEE ALSO
30927  
30928  =over 4
30929  
30930  =item Manual Pages
30931  
30932  =item RFCs
30933  
30934  =item Articles
30935  
30936  =item Event Log
30937  
30938  =back
30939  
30940  =item AUTHORS & ACKNOWLEDGEMENTS
30941  
30942  =item BUGS
30943  
30944  =item SUPPORT
30945  
30946  AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
30947  tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
30948  
30949  =item COPYRIGHT
30950  
30951  =item LICENSE
30952  
30953  =back
30954  
30955  =head2 Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for
30956  Sys::Syslog
30957  
30958  =over 4
30959  
30960  =item DESCRIPTION
30961  
30962  =item SEE ALSO
30963  
30964  =item AUTHORS
30965  
30966  =item LICENSE
30967  
30968  =back
30969  
30970  =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
30971  
30972  =over 4
30973  
30974  =item SYNOPSIS
30975  
30976  =item DESCRIPTION
30977  
30978  =item DIAGNOSTICS
30979  
30980  Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
30981  use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
30982  comma allowed after filehandle, No name for escape sequence %s
30983  
30984  =item ENVIRONMENT
30985  
30986  ANSI_COLORS_DISABLED
30987  
30988  =item RESTRICTIONS
30989  
30990  =item NOTES
30991  
30992  =item SEE ALSO
30993  
30994  =item AUTHORS
30995  
30996  =item COPYRIGHT AND LICENSE
30997  
30998  =back
30999  
31000  =head2 Term::Cap - Perl termcap interface
31001  
31002  =over 4
31003  
31004  =item SYNOPSIS
31005  
31006  =item DESCRIPTION
31007  
31008  =over 4
31009  
31010  =item METHODS
31011  
31012  =back
31013  
31014  =back
31015  
31016  B<Tgetent>, OSPEED, TERM
31017  
31018  B<Tpad>, B<$string>, B<$cnt>, B<$FH>
31019  
31020  B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
31021  
31022  B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
31023  
31024  B<Trequire>
31025  
31026  =over 4
31027  
31028  =item EXAMPLES
31029  
31030  =item COPYRIGHT AND LICENSE
31031  
31032  =item AUTHOR
31033  
31034  =item SEE ALSO
31035  
31036  =back
31037  
31038  =head2 Term::Complete - Perl word completion module
31039  
31040  =over 4
31041  
31042  =item SYNOPSIS
31043  
31044  =item DESCRIPTION
31045  
31046  E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
31047  
31048  =item DIAGNOSTICS
31049  
31050  =item BUGS
31051  
31052  =item AUTHOR
31053  
31054  =back
31055  
31056  =head2 Term::ReadLine - Perl interface to various C<readline> packages.
31057  If no real package is found, substitutes stubs instead of basic functions.
31058  
31059  =over 4
31060  
31061  =item SYNOPSIS
31062  
31063  =item DESCRIPTION
31064  
31065  =item Minimal set of supported functions
31066  
31067  C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
31068  C<findConsole>, Attribs, C<Features>
31069  
31070  =item Additional supported functions
31071  
31072  C<tkRunning>, C<ornaments>, C<newTTY>
31073  
31074  =item EXPORTS
31075  
31076  =item ENVIRONMENT
31077  
31078  =item CAVEATS
31079  
31080  =back
31081  
31082  =head2 Term::UI - Term::ReadLine UI made easy
31083  
31084  =over 4
31085  
31086  =item SYNOPSIS
31087  
31088  =item DESCRIPTION
31089  
31090  =item HOW IT WORKS
31091  
31092  =item METHODS
31093  
31094  =over 4
31095  
31096  =item $reply = $term->get_reply( prompt => 'question?', [choices => \@list,
31097  default => $list[0], multi => BOOL, print_me => "extra text to print &
31098  record", allow => $ref] );
31099  
31100  =back
31101  
31102  =back
31103  
31104  =over 4
31105  
31106  =item $bool = $term->ask_yn( prompt => "your question", [default =>
31107  (y|1,n|0), print_me => "extra text to print & record"] )
31108  
31109  =back
31110  
31111  =over 4
31112  
31113  =item ($opts, $munged) = $term->parse_options( STRING );
31114  
31115  =back
31116  
31117  =over 4
31118  
31119  =item $str = $term->history_as_string
31120  
31121  =back
31122  
31123  =over 4
31124  
31125  =item GLOBAL VARIABLES
31126  
31127  =over 4
31128  
31129  =item $Term::UI::VERBOSE
31130  
31131  =item $Term::UI::AUTOREPLY
31132  
31133  =item $Term::UI::INVALID
31134  
31135  =item $Term::UI::History::HISTORY_FH
31136  
31137  =back
31138  
31139  =item EXAMPLES
31140  
31141  =over 4
31142  
31143  =item Basic get_reply sample
31144  
31145  =item get_reply with choices
31146  
31147  =item get_reply with choices and default
31148  
31149  =item get_reply using print_me & multi
31150  
31151  =item get_reply & allow
31152  
31153  =item an elaborate ask_yn sample
31154  
31155  =back
31156  
31157  =item See Also
31158  
31159  =item BUG REPORTS
31160  
31161  =item AUTHOR
31162  
31163  =item COPYRIGHT
31164  
31165  =back
31166  
31167  =head2 Term::UI::History
31168  
31169  =over 4
31170  
31171  =item SYNOPSIS
31172  
31173  =item DESCRIPTION
31174  
31175  =item FUNCTIONS
31176  
31177  =over 4
31178  
31179  =item history("message string" [,VERBOSE])
31180  
31181  =back
31182  
31183  =back
31184  
31185  =over 4
31186  
31187  =item GLOBAL VARIABLES
31188  
31189  $HISTORY_FH
31190  
31191  =item See Also
31192  
31193  =item AUTHOR
31194  
31195  =item COPYRIGHT
31196  
31197  =back
31198  
31199  =head2 Test - provides a simple framework for writing test scripts
31200  
31201  =over 4
31202  
31203  =item SYNOPSIS
31204  
31205  =item DESCRIPTION
31206  
31207  =item QUICK START GUIDE
31208  
31209  =over 4
31210  
31211  =item Functions
31212  
31213  C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
31214  C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
31215  
31216  =back
31217  
31218  =back
31219  
31220  B<_to_value>
31221  
31222  C<ok(...)>
31223  
31224  C<skip(I<skip_if_true>, I<args...>)>
31225  
31226  =over 4
31227  
31228  =item TEST TYPES
31229  
31230  NORMAL TESTS, SKIPPED TESTS, TODO TESTS
31231  
31232  =item ONFAIL
31233  
31234  =item BUGS and CAVEATS
31235  
31236  =item ENVIRONMENT
31237  
31238  =item NOTE
31239  
31240  =item SEE ALSO
31241  
31242  =item AUTHOR
31243  
31244  =back
31245  
31246  =head2 Test::Builder - Backend for building test libraries
31247  
31248  =over 4
31249  
31250  =item SYNOPSIS
31251  
31252  =item DESCRIPTION
31253  
31254  =over 4
31255  
31256  =item Construction
31257  
31258  B<new>
31259  
31260  =back
31261  
31262  =back
31263  
31264  B<create>
31265  
31266  B<reset>
31267  
31268  =over 4
31269  
31270  =item Setting up tests
31271  
31272  B<exported_to>
31273  
31274  =back
31275  
31276  B<plan>
31277  
31278  B<expected_tests>
31279  
31280  B<no_plan>
31281  
31282  B<has_plan>
31283  
31284  B<skip_all>
31285  
31286  =over 4
31287  
31288  =item Running tests
31289  
31290  B<ok>
31291  
31292  =back
31293  
31294  B<is_eq>, B<is_num>
31295  
31296  B<isnt_eq>, B<isnt_num>
31297  
31298  B<like>, B<unlike>
31299  
31300  B<cmp_ok>
31301  
31302  =over 4
31303  
31304  =item Other Testing Methods
31305  
31306  B<BAIL_OUT>
31307  
31308  =back
31309  
31310  B<skip>
31311  
31312  B<todo_skip>
31313  
31314  B<skip_rest>
31315  
31316  =over 4
31317  
31318  =item Test building utility methods
31319  
31320  B<maybe_regex>
31321  
31322  =back
31323  
31324  B<_try>
31325  
31326  B<is_fh>
31327  
31328  =over 4
31329  
31330  =item Test style
31331  
31332  B<level>
31333  
31334  =back
31335  
31336  B<use_numbers>
31337  
31338  B<no_diag>, B<no_ending>, B<no_header>
31339  
31340  =over 4
31341  
31342  =item Output
31343  
31344  B<diag>
31345  
31346  =back
31347  
31348  B<_print>
31349  
31350  B<_print_diag>
31351  
31352  B<output>, B<failure_output>, B<todo_output>
31353  
31354  carp, croak
31355  
31356  =over 4
31357  
31358  =item Test Status and Info
31359  
31360  B<current_test>
31361  
31362  =back
31363  
31364  B<summary>
31365  
31366  B<details>
31367  
31368  B<todo>
31369  
31370  B<caller>
31371  
31372  B<_sanity_check>
31373  
31374  B<_whoa>
31375  
31376  B<_my_exit>
31377  
31378  =over 4
31379  
31380  =item EXIT CODES
31381  
31382  =item THREADS
31383  
31384  =item EXAMPLES
31385  
31386  =item SEE ALSO
31387  
31388  =item AUTHORS
31389  
31390  =item COPYRIGHT
31391  
31392  =back
31393  
31394  =head2 Test::Builder::Module - Base class for test modules
31395  
31396  =over 4
31397  
31398  =item SYNOPSIS
31399  
31400  =item DESCRIPTION
31401  
31402  =over 4
31403  
31404  =item Importing
31405  
31406  =back
31407  
31408  =back
31409  
31410  =over 4
31411  
31412  =item Builder
31413  
31414  =back
31415  
31416  =head2 Test::Builder::Tester - test testsuites that have been built with
31417  Test::Builder
31418  
31419  =over 4
31420  
31421  =item SYNOPSIS
31422  
31423  =item DESCRIPTION
31424  
31425  =back
31426  
31427  =over 4
31428  
31429  =item Functions
31430  
31431  test_out, test_err
31432  
31433  =back
31434  
31435  test_fail
31436  
31437  test_diag
31438  
31439  test_test, title (synonym 'name', 'label'), skip_out, skip_err
31440  
31441  line_num
31442  
31443  color
31444  
31445  =over 4
31446  
31447  =item BUGS
31448  
31449  =item AUTHOR
31450  
31451  =item NOTES
31452  
31453  =item SEE ALSO
31454  
31455  =back
31456  
31457  =head2 Test::Builder::Tester::Color - turn on colour in
31458  Test::Builder::Tester
31459  
31460  =over 4
31461  
31462  =item SYNOPSIS
31463  
31464  =item DESCRIPTION
31465  
31466  =back
31467  
31468  =over 4
31469  
31470  =item AUTHOR
31471  
31472  =item BUGS
31473  
31474  =item SEE ALSO
31475  
31476  =back
31477  
31478  =head2 Test::Harness - Run Perl standard test scripts with statistics
31479  
31480  =over 4
31481  
31482  =item VERSION
31483  
31484  =back
31485  
31486  =over 4
31487  
31488  =item SYNOPSIS
31489  
31490  =item DESCRIPTION
31491  
31492  =over 4
31493  
31494  =item Taint mode
31495  
31496  =item Configuration variables.
31497  
31498  C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
31499  C<$Test::Harness::Timer>
31500  
31501  =item Failure
31502  
31503  B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<List of Failed>
31504  
31505  =back
31506  
31507  =item FUNCTIONS
31508  
31509  =over 4
31510  
31511  =item runtests( @test_files )
31512  
31513  =back
31514  
31515  =back
31516  
31517  =over 4
31518  
31519  =item execute_tests( tests => \@test_files, out => \*FH )
31520  
31521  =back
31522  
31523  =over 4
31524  
31525  =item EXPORT
31526  
31527  =item DIAGNOSTICS
31528  
31529  C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
31530  %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
31531  %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
31532  %s>, C<FAILED--Further testing stopped: %s>
31533  
31534  =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
31535  
31536  C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
31537  
31538  =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
31539  
31540  C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
31541  C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_NOTTY>, C<HARNESS_PERL>,
31542  C<HARNESS_PERL_SWITCHES>, C<HARNESS_TIMER>, C<HARNESS_VERBOSE>,
31543  C<HARNESS_STRAP_CLASS>
31544  
31545  =item EXAMPLE
31546  
31547  =item SEE ALSO
31548  
31549  =item TODO
31550  
31551  =item BUGS
31552  
31553  =item SUPPORT
31554  
31555  AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
31556  tracker, Search CPAN
31557  
31558  =item SOURCE CODE
31559  
31560  =item AUTHORS
31561  
31562  =item COPYRIGHT
31563  
31564  =back
31565  
31566  =head2 Test::Harness::Assert - simple assert
31567  
31568  =over 4
31569  
31570  =item SYNOPSIS
31571  
31572  =item DESCRIPTION
31573  
31574  =item FUNCTIONS
31575  
31576  =over 4
31577  
31578  =item C<assert()>
31579  
31580  =back
31581  
31582  =back
31583  
31584  =over 4
31585  
31586  =item AUTHOR
31587  
31588  =item SEE ALSO
31589  
31590  =back
31591  
31592  =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
31593  
31594  =over 4
31595  
31596  =item SYNOPSIS
31597  
31598  =item DESCRIPTION
31599  
31600  =over 4
31601  
31602  =item new()
31603  
31604  =item next()
31605  
31606  =back
31607  
31608  =back
31609  
31610  =head2 Test::Harness::Point - object for tracking a single test point
31611  
31612  =over 4
31613  
31614  =item SYNOPSIS
31615  
31616  =item CONSTRUCTION
31617  
31618  =over 4
31619  
31620  =item new()
31621  
31622  =back
31623  
31624  =back
31625  
31626  =over 4
31627  
31628  =item from_test_line( $line )
31629  
31630  =back
31631  
31632  =over 4
31633  
31634  =item ACCESSORS
31635  
31636  ok, number
31637  
31638  =back
31639  
31640  =head2 Test::Harness::Results - object for tracking results from a single
31641  test file
31642  
31643  =over 4
31644  
31645  =item SYNOPSIS
31646  
31647  =item CONSTRUCTION
31648  
31649  =over 4
31650  
31651  =item new()
31652  
31653  =back
31654  
31655  =back
31656  
31657  =over 4
31658  
31659  =item ACCESSORS
31660  
31661  wait, exit
31662  
31663  =back
31664  
31665  =head2 Test::Harness::Straps - detailed analysis of test results
31666  
31667  =over 4
31668  
31669  =item SYNOPSIS
31670  
31671  =item DESCRIPTION
31672  
31673  =item CONSTRUCTION
31674  
31675  =over 4
31676  
31677  =item new()
31678  
31679  =back
31680  
31681  =back
31682  
31683  =over 4
31684  
31685  =item ANALYSIS
31686  
31687  =over 4
31688  
31689  =item $strap->analyze( $name, \@output_lines )
31690  
31691  =back
31692  
31693  =back
31694  
31695  =over 4
31696  
31697  =item $strap->analyze_file( $test_file )
31698  
31699  =back
31700  
31701  =over 4
31702  
31703  =item Parsing
31704  
31705  =back
31706  
31707  =over 4
31708  
31709  =item EXAMPLES
31710  
31711  =item AUTHOR
31712  
31713  =item SEE ALSO
31714  
31715  =back
31716  
31717  =head2 Test::Harness::TAP - Documentation for the TAP format
31718  
31719  =over 4
31720  
31721  =item SYNOPSIS
31722  
31723  =item TODO
31724  
31725  =item THE TAP FORMAT
31726  
31727  =item HARNESS BEHAVIOR
31728  
31729  =item TESTS LINES AND THE PLAN
31730  
31731  =over 4
31732  
31733  =item The plan
31734  
31735  =item The test line
31736  
31737  C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
31738  (required), Test number (recommended), Description (recommended), Directive
31739  (only when necessary)
31740  
31741  =back
31742  
31743  =item DIRECTIVES
31744  
31745  =over 4
31746  
31747  =item TODO tests
31748  
31749  =item Skipping tests
31750  
31751  =back
31752  
31753  =item OTHER LINES
31754  
31755  =over 4
31756  
31757  =item Bail out!
31758  
31759  =item Diagnostics
31760  
31761  =item Anything else
31762  
31763  =back
31764  
31765  =item EXAMPLES
31766  
31767  =over 4
31768  
31769  =item Common with explanation
31770  
31771  =item Unknown amount and failures
31772  
31773  =item Giving up
31774  
31775  =item Skipping a few
31776  
31777  =item Skipping everything
31778  
31779  =item Got spare tuits?
31780  
31781  =item Creative liberties
31782  
31783  =back
31784  
31785  =item Non-Perl TAP
31786  
31787  =over 4
31788  
31789  =item C/C++
31790  
31791  Specify a test plan, Run tests, Skip tests in certain situations, Have TODO
31792  tests, Produce TAP compatible diagnostics
31793  
31794  =item Python
31795  
31796  =item JavaScript
31797  
31798  =item PHP
31799  
31800  phpt, PHPUnit, SimpleTest, Apache-Test
31801  
31802  =back
31803  
31804  =item AUTHORS
31805  
31806  =item ACKNOWLEDGEMENTS
31807  
31808  =item COPYRIGHT
31809  
31810  =back
31811  
31812  =head2 Test::Harness::Util - Utility functions for Test::Harness::*
31813  
31814  =over 4
31815  
31816  =item SYNOPSIS
31817  
31818  =item PUBLIC FUNCTIONS
31819  
31820  =over 4
31821  
31822  =item all_in( {parm => value, parm => value} )
31823  
31824  start, recurse
31825  
31826  =back
31827  
31828  =back
31829  
31830  =over 4
31831  
31832  =item shuffle( @list )
31833  
31834  =back
31835  
31836  =over 4
31837  
31838  =item blibdir()
31839  
31840  =back
31841  
31842  =head2 Test::More - yet another framework for writing test scripts
31843  
31844  =over 4
31845  
31846  =item SYNOPSIS
31847  
31848  =item DESCRIPTION
31849  
31850  =over 4
31851  
31852  =item I love it when a plan comes together
31853  
31854  =back
31855  
31856  =back
31857  
31858  =over 4
31859  
31860  =item Test names
31861  
31862  =item I'm ok, you're not ok.
31863  
31864  B<ok>
31865  
31866  =back
31867  
31868  B<is>, B<isnt>
31869  
31870  B<like>
31871  
31872  B<unlike>
31873  
31874  B<cmp_ok>
31875  
31876  B<can_ok>
31877  
31878  B<isa_ok>
31879  
31880  B<pass>, B<fail>
31881  
31882  =over 4
31883  
31884  =item Module tests
31885  
31886  B<use_ok>
31887  
31888  =back
31889  
31890  B<require_ok>
31891  
31892  =over 4
31893  
31894  =item Complex data structures
31895  
31896  B<is_deeply>
31897  
31898  =back
31899  
31900  =over 4
31901  
31902  =item Diagnostics
31903  
31904  B<diag>
31905  
31906  =back
31907  
31908  =over 4
31909  
31910  =item Conditional tests
31911  
31912  B<SKIP: BLOCK>
31913  
31914  =back
31915  
31916  B<TODO: BLOCK>, B<todo_skip>
31917  
31918  When do I use SKIP vs. TODO?
31919  
31920  =over 4
31921  
31922  =item Test control
31923  
31924  B<BAIL_OUT>
31925  
31926  =back
31927  
31928  =over 4
31929  
31930  =item Discouraged comparison functions
31931  
31932  B<eq_array>
31933  
31934  =back
31935  
31936  B<eq_hash>
31937  
31938  B<eq_set>
31939  
31940  =over 4
31941  
31942  =item Extending and Embedding Test::More
31943  
31944  B<builder>
31945  
31946  =back
31947  
31948  =over 4
31949  
31950  =item EXIT CODES
31951  
31952  =item CAVEATS and NOTES
31953  
31954  Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
31955  
31956  =item HISTORY
31957  
31958  =item SEE ALSO
31959  
31960  =item AUTHORS
31961  
31962  =item BUGS
31963  
31964  =item COPYRIGHT
31965  
31966  =back
31967  
31968  =head2 Test::Simple - Basic utilities for writing tests.
31969  
31970  =over 4
31971  
31972  =item SYNOPSIS
31973  
31974  =item DESCRIPTION
31975  
31976  B<ok>
31977  
31978  =back
31979  
31980  =over 4
31981  
31982  =item EXAMPLE
31983  
31984  =item CAVEATS
31985  
31986  =item NOTES
31987  
31988  =item HISTORY
31989  
31990  =item SEE ALSO
31991  
31992  L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
31993  L<Test::Harness>
31994  
31995  =item AUTHORS
31996  
31997  =item COPYRIGHT
31998  
31999  =back
32000  
32001  =head2 Test::Tutorial - A tutorial about writing really basic tests
32002  
32003  =over 4
32004  
32005  =item DESCRIPTION
32006  
32007  =over 4
32008  
32009  =item Nuts and bolts of testing.
32010  
32011  =item Where to start?
32012  
32013  =item Names
32014  
32015  =item Test the manual
32016  
32017  =item Sometimes the tests are wrong
32018  
32019  =item Testing lots of values
32020  
32021  =item Informative names
32022  
32023  =item Skipping tests
32024  
32025  =item Todo tests
32026  
32027  =item Testing with taint mode.
32028  
32029  =back
32030  
32031  =item FOOTNOTES
32032  
32033  =item AUTHORS
32034  
32035  =item COPYRIGHT
32036  
32037  =back
32038  
32039  =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
32040  
32041  =over 4
32042  
32043  =item SYNOPSIS
32044  
32045  =item DESCRIPTION
32046  
32047  =item EXAMPLE
32048  
32049  =back
32050  
32051  =head2 Text::Balanced - Extract delimited text sequences from strings.
32052  
32053  =over 4
32054  
32055  =item SYNOPSIS
32056  
32057  =item DESCRIPTION
32058  
32059  =over 4
32060  
32061  =item General behaviour in list contexts
32062  
32063  [0], [1], [2]
32064  
32065  =item General behaviour in scalar and void contexts
32066  
32067  =item A note about prefixes
32068  
32069  =item C<extract_delimited>
32070  
32071  =item C<extract_bracketed>
32072  
32073  =item C<extract_variable>
32074  
32075  [0], [1], [2]
32076  
32077  =item C<extract_tagged>
32078  
32079  C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
32080  [0], [1], [2], [3], [4], [5]
32081  
32082  =item C<gen_extract_tagged>
32083  
32084  =item C<extract_quotelike>
32085  
32086  [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
32087  
32088  =item C<extract_quotelike> and "here documents"
32089  
32090  [0], [1], [2], [3], [4], [5], [6], [7..10]
32091  
32092  =item C<extract_codeblock>
32093  
32094  =item C<extract_multiple>
32095  
32096  =item C<gen_delimited_pat>
32097  
32098  =item C<delimited_pat>
32099  
32100  =back
32101  
32102  =item DIAGNOSTICS
32103  
32104   C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
32105  C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
32106  operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
32107  C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
32108  C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
32109  bracket: expected "%c" but found "%s">,  C<No block delimiter found after
32110  quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
32111  after dereferencer>, C<Did not find expected opening bracket at %s>,
32112  C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
32113  "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
32114  /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
32115  nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
32116  tag>
32117  
32118  =item AUTHOR
32119  
32120  =item BUGS AND IRRITATIONS
32121  
32122  =item COPYRIGHT
32123  
32124  =back
32125  
32126  =head2 Text::ParseWords - parse text into an array of tokens or array of
32127  arrays
32128  
32129  =over 4
32130  
32131  =item SYNOPSIS
32132  
32133  =item DESCRIPTION
32134  
32135  =item EXAMPLES
32136  
32137  =item AUTHORS
32138  
32139  =back
32140  
32141  =head2 Text::Soundex - Implementation of the soundex algorithm.
32142  
32143  =over 4
32144  
32145  =item SYNOPSIS
32146  
32147  =item DESCRIPTION
32148  
32149  =item EXAMPLES
32150  
32151  =item LIMITATIONS
32152  
32153  =item MAINTAINER
32154  
32155  =item HISTORY
32156  
32157  =back
32158  
32159  =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
32160  unexpand(1)
32161  
32162  =over 4
32163  
32164  =item SYNOPSIS
32165  
32166  =item DESCRIPTION
32167  
32168  =item EXAMPLE
32169  
32170  =item LICENSE
32171  
32172  =back
32173  
32174  =head2 Text::Wrap - line wrapping to form simple paragraphs
32175  
32176  =over 4
32177  
32178  =item SYNOPSIS 
32179  
32180  =item DESCRIPTION
32181  
32182  =item OVERRIDES
32183  
32184  =item EXAMPLES
32185  
32186  =item LICENSE
32187  
32188  =back
32189  
32190  =head2 Thread - Manipulate threads in Perl (for old code only)
32191  
32192  =over 4
32193  
32194  =item DEPRECATED
32195  
32196  =item HISTORY
32197  
32198  =item SYNOPSIS
32199  
32200  =item DESCRIPTION
32201  
32202  =item FUNCTIONS
32203  
32204  $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
32205  LIST), lock VARIABLE, async BLOCK;, Thread->self, Thread->list, cond_wait
32206  VARIABLE, cond_signal VARIABLE, cond_broadcast VARIABLE, yield
32207  
32208  =item METHODS
32209  
32210  join, detach, equal, tid, done
32211  
32212  =item DEFUNCT
32213  
32214  lock(\&sub), eval, flags
32215  
32216  =item SEE ALSO
32217  
32218  =back
32219  
32220  =head2 Thread::Queue - thread-safe queues
32221  
32222  =over 4
32223  
32224  =item SYNOPSIS
32225  
32226  =item DESCRIPTION
32227  
32228  =item FUNCTIONS AND METHODS
32229  
32230  new, enqueue LIST, dequeue, dequeue_nb, pending
32231  
32232  =item SEE ALSO
32233  
32234  =back
32235  
32236  =head2 Thread::Semaphore - thread-safe semaphores
32237  
32238  =over 4
32239  
32240  =item SYNOPSIS
32241  
32242  =item DESCRIPTION
32243  
32244  =item FUNCTIONS AND METHODS
32245  
32246  new, new NUMBER, down, down NUMBER, up, up NUMBER
32247  
32248  =back
32249  
32250  =head2 Tie::Array - base class for tied arrays
32251  
32252  =over 4
32253  
32254  =item SYNOPSIS
32255  
32256  =item DESCRIPTION
32257  
32258  TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
32259  FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
32260  key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
32261  SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
32262  
32263  =item CAVEATS
32264  
32265  =item AUTHOR
32266  
32267  =back
32268  
32269  =head2 Tie::File - Access the lines of a disk file via a Perl array
32270  
32271  =over 4
32272  
32273  =item SYNOPSIS
32274  
32275  =item DESCRIPTION
32276  
32277  =over 4
32278  
32279  =item C<recsep>
32280  
32281  =item C<autochomp>
32282  
32283  =item C<mode>
32284  
32285  =item C<memory>
32286  
32287  =item C<dw_size>
32288  
32289  =item Option Format
32290  
32291  =back
32292  
32293  =item Public Methods
32294  
32295  =over 4
32296  
32297  =item C<flock>
32298  
32299  =item C<autochomp>
32300  
32301  =item C<defer>, C<flush>, C<discard>, and C<autodefer>
32302  
32303  =item C<offset>
32304  
32305  =back
32306  
32307  =item Tying to an already-opened filehandle
32308  
32309  =item Deferred Writing
32310  
32311  =over 4
32312  
32313  =item Autodeferring
32314  
32315  =back
32316  
32317  =item CONCURRENT ACCESS TO FILES
32318  
32319  =item CAVEATS
32320  
32321  =item SUBCLASSING
32322  
32323  =item WHAT ABOUT C<DB_File>?
32324  
32325  =item AUTHOR
32326  
32327  =item LICENSE
32328  
32329  =item WARRANTY
32330  
32331  =item THANKS
32332  
32333  =item TODO
32334  
32335  =back
32336  
32337  =head2 Tie::Handle - base class definitions for tied handles
32338  
32339  =over 4
32340  
32341  =item SYNOPSIS
32342  
32343  =item DESCRIPTION
32344  
32345  TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
32346  LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
32347  READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
32348  EOF this, TELL this, SEEK this, offset, whence, DESTROY this
32349  
32350  =item MORE INFORMATION
32351  
32352  =item COMPATIBILITY
32353  
32354  =back
32355  
32356  =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
32357  tied hashes
32358  
32359  =over 4
32360  
32361  =item SYNOPSIS
32362  
32363  =item DESCRIPTION
32364  
32365  TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
32366  this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
32367  this, SCALAR this
32368  
32369  =item Inheriting from B<Tie::StdHash>
32370  
32371  =item Inheriting from B<Tie::ExtraHash>
32372  
32373  =item C<SCALAR>, C<UNTIE> and C<DESTROY>
32374  
32375  =item MORE INFORMATION
32376  
32377  =back
32378  
32379  =head2 Tie::Hash::NamedCapture - Named regexp capture buffers
32380  
32381  =over 4
32382  
32383  =item SYNOPSIS
32384  
32385  =item DESCRIPTION
32386  
32387  =item SEE ALSO
32388  
32389  =back
32390  
32391  =head2 Tie::Memoize - add data to hash when needed
32392  
32393  =over 4
32394  
32395  =item SYNOPSIS
32396  
32397  =item DESCRIPTION
32398  
32399  =item Inheriting from B<Tie::Memoize>
32400  
32401  =item EXAMPLE
32402  
32403  =item BUGS
32404  
32405  =item AUTHOR
32406  
32407  =back
32408  
32409  =head2 Tie::RefHash - use references as hash keys
32410  
32411  =over 4
32412  
32413  =item SYNOPSIS
32414  
32415  =item DESCRIPTION
32416  
32417  =item EXAMPLE
32418  
32419  =item THREAD SUPPORT
32420  
32421  =item STORABLE SUPPORT
32422  
32423  =item RELIC SUPPORT
32424  
32425  =item MAINTAINER
32426  
32427  =item AUTHOR
32428  
32429  =item SEE ALSO
32430  
32431  =back
32432  
32433  =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
32434  scalars
32435  
32436  =over 4
32437  
32438  =item SYNOPSIS
32439  
32440  =item DESCRIPTION
32441  
32442  TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
32443  
32444  =item MORE INFORMATION
32445  
32446  =back
32447  
32448  =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
32449  
32450  =over 4
32451  
32452  =item SYNOPSIS
32453  
32454  =item DESCRIPTION
32455  
32456  =item CAVEATS
32457  
32458  =back
32459  
32460  =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
32461  timers
32462  
32463  =over 4
32464  
32465  =item SYNOPSIS
32466  
32467  =item DESCRIPTION
32468  
32469  gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
32470  $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
32471  $floating_seconds ), alarm ( $floating_seconds [,
32472  $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
32473  $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
32474  $which ), clock_getres ( $which ), clock_nanosleep ( $which, $nanoseconds,
32475  $flags = 0), clock(), stat, stat FH, stat EXPR
32476  
32477  =item EXAMPLES
32478  
32479  =item C API
32480  
32481  =item DIAGNOSTICS
32482  
32483  =over 4
32484  
32485  =item useconds or interval more than ...
32486  
32487  =item negative time not invented yet
32488  
32489  =item internal error: useconds < 0 (unsigned ... signed ...)
32490  
32491  =back
32492  
32493  =item CAVEATS
32494  
32495  =item SEE ALSO
32496  
32497  =item AUTHORS
32498  
32499  =item COPYRIGHT AND LICENSE
32500  
32501  =back
32502  
32503  =head2 Time::Local - efficiently compute time from local and GMT time
32504  
32505  =over 4
32506  
32507  =item SYNOPSIS
32508  
32509  =item DESCRIPTION
32510  
32511  =item FUNCTIONS
32512  
32513  =over 4
32514  
32515  =item C<timelocal()> and C<timegm()>
32516  
32517  =item C<timelocal_nocheck()> and C<timegm_nocheck()>
32518  
32519  =item Year Value Interpretation
32520  
32521  =item Limits of time_t
32522  
32523  =item Ambiguous Local Times (DST)
32524  
32525  =item Non-Existent Local Times (DST)
32526  
32527  =item Negative Epoch Values
32528  
32529  =back
32530  
32531  =item IMPLEMENTATION
32532  
32533  =item BUGS
32534  
32535  =item SUPPORT
32536  
32537  =item COPYRIGHT
32538  
32539  =item AUTHOR
32540  
32541  =back
32542  
32543  =head2 Time::Piece - Object Oriented time objects
32544  
32545  =over 4
32546  
32547  =item SYNOPSIS
32548  
32549  =item DESCRIPTION
32550  
32551  =item USAGE
32552  
32553  =over 4
32554  
32555  =item Local Locales
32556  
32557  =item Date Calculations
32558  
32559  =item Date Comparisons
32560  
32561  =item Date Parsing
32562  
32563  =item YYYY-MM-DDThh:mm:ss
32564  
32565  =item Week Number
32566  
32567  =item Global Overriding
32568  
32569  =back
32570  
32571  =item AUTHOR
32572  
32573  =item License
32574  
32575  =item SEE ALSO
32576  
32577  =item BUGS
32578  
32579  =back
32580  
32581  =head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert
32582  seconds to other date values
32583  
32584  =over 4
32585  
32586  =item SYNOPSIS
32587  
32588  =item DESCRIPTION
32589  
32590  =item METHODS
32591  
32592  =item AUTHOR
32593  
32594  =item LICENSE
32595  
32596  =item Bugs
32597  
32598  =back
32599  
32600  =head2 Time::Seconds - a simple API to convert seconds to other date values
32601  
32602  =over 4
32603  
32604  =item SYNOPSIS
32605  
32606  =item DESCRIPTION
32607  
32608  =item METHODS
32609  
32610  =item AUTHOR
32611  
32612  =item LICENSE
32613  
32614  =item Bugs
32615  
32616  =back
32617  
32618  =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
32619  function
32620  
32621  =over 4
32622  
32623  =item SYNOPSIS
32624  
32625  =item DESCRIPTION
32626  
32627  =item NOTE
32628  
32629  =item AUTHOR
32630  
32631  =back
32632  
32633  =head2 Time::localtime - by-name interface to Perl's built-in localtime()
32634  function
32635  
32636  =over 4
32637  
32638  =item SYNOPSIS
32639  
32640  =item DESCRIPTION
32641  
32642  =item NOTE
32643  
32644  =item AUTHOR
32645  
32646  =back
32647  
32648  =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
32649  
32650  =over 4
32651  
32652  =item SYNOPSIS
32653  
32654  =item DESCRIPTION
32655  
32656  =item AUTHOR
32657  
32658  =back
32659  
32660  =head2 UNIVERSAL - base class for ALL classes (blessed references)
32661  
32662  =over 4
32663  
32664  =item SYNOPSIS
32665  
32666  =item DESCRIPTION
32667  
32668  C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
32669  TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->DOES( ROLE ) >>,
32670  C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can(
32671  METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C<VERSION ( [ REQUIRE ] )>
32672  
32673  =item EXPORTS
32674  
32675  =back
32676  
32677  =head2 Unicode::Collate - Unicode Collation Algorithm
32678  
32679  =over 4
32680  
32681  =item SYNOPSIS
32682  
32683  =item DESCRIPTION
32684  
32685  =over 4
32686  
32687  =item Constructor and Tailoring
32688  
32689  UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
32690  ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
32691  overrideHangul, preprocess, rearrange, table, undefChar, undefName,
32692  upper_before_lower, variable
32693  
32694  =item Methods for Collation
32695  
32696  C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
32697  $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
32698  C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
32699  $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
32700  $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
32701  C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
32702  $Collator-E<gt>viewSortKey($string)>
32703  
32704  =item Methods for Searching
32705  
32706  C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
32707  C<($position, $length) = $Collator-E<gt>index($string, $substring[,
32708  $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
32709  C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
32710  $Collator-E<gt>gmatch($string, $substring)>, C<$count =
32711  $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
32712  $Collator-E<gt>gsubst($string, $substring, $replacement)>
32713  
32714  =item Other Methods
32715  
32716  C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
32717  $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
32718  
32719  =back
32720  
32721  =item EXPORT
32722  
32723  =item INSTALL
32724  
32725  =item CAVEATS
32726  
32727  Normalization, Conformance Test
32728  
32729  =item AUTHOR, COPYRIGHT AND LICENSE
32730  
32731  =item SEE ALSO
32732  
32733  Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
32734  Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
32735  Type, Unicode Normalization Forms - UAX #15
32736  
32737  =back
32738  
32739  =head2 Unicode::Normalize - Unicode Normalization Forms
32740  
32741  =over 4
32742  
32743  =item SYNOPSIS
32744  
32745  =item DESCRIPTION
32746  
32747  =over 4
32748  
32749  =item Normalization Forms
32750  
32751  C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
32752  C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
32753  C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
32754  C<$normalized_string = normalize($form_name, $string)>
32755  
32756  =item Decomposition and Composition
32757  
32758  C<$decomposed_string = decompose($string [, $useCompatMapping])>,
32759  C<$reordered_string = reorder($string)>, C<$composed_string =
32760  compose($string)>
32761  
32762  =item Quick Check
32763  
32764  C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
32765  checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
32766  checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
32767  check($form_name, $string)>
32768  
32769  =item Character Data
32770  
32771  C<$canonical_decomposition = getCanon($code_point)>,
32772  C<$compatibility_decomposition = getCompat($code_point)>,
32773  C<$code_point_composite = getComposite($code_point_here,
32774  $code_point_next)>, C<$combining_class = getCombinClass($code_point)>,
32775  C<$may_be_composed_with_prev_char = isComp2nd($code_point)>,
32776  C<$is_exclusion = isExclusion($code_point)>, C<$is_singleton =
32777  isSingleton($code_point)>, C<$is_non_starter_decomposition =
32778  isNonStDecomp($code_point)>, C<$is_Full_Composition_Exclusion =
32779  isComp_Ex($code_point)>, C<$NFD_is_NO = isNFD_NO($code_point)>,
32780  C<$NFC_is_NO = isNFC_NO($code_point)>, C<$NFC_is_MAYBE =
32781  isNFC_MAYBE($code_point)>, C<$NFKD_is_NO = isNFKD_NO($code_point)>,
32782  C<$NFKC_is_NO = isNFKC_NO($code_point)>, C<$NFKC_is_MAYBE =
32783  isNFKC_MAYBE($code_point)>
32784  
32785  =back
32786  
32787  =item EXPORT
32788  
32789  =item CAVEATS
32790  
32791  Perl's version vs. Unicode version, Correction of decomposition mapping,
32792  Revised definition of canonical composition
32793  
32794  =item AUTHOR
32795  
32796  =item SEE ALSO
32797  
32798  http://www.unicode.org/reports/tr15/,
32799  http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt,
32800  http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
32801  http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
32802  http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
32803  
32804  =back
32805  
32806  =head2 Unicode::UCD - Unicode character database
32807  
32808  =over 4
32809  
32810  =item SYNOPSIS
32811  
32812  =item DESCRIPTION
32813  
32814  =back
32815  
32816  =over 4
32817  
32818  =item charinfo
32819  
32820  =back
32821  
32822  =over 4
32823  
32824  =item charblock
32825  
32826  =back
32827  
32828  =over 4
32829  
32830  =item charscript
32831  
32832  =back
32833  
32834  =over 4
32835  
32836  =item charblocks
32837  
32838  =back
32839  
32840  =over 4
32841  
32842  =item charscripts
32843  
32844  =back
32845  
32846  =over 4
32847  
32848  =item Blocks versus Scripts
32849  
32850  =item Matching Scripts and Blocks
32851  
32852  =item Code Point Arguments
32853  
32854  =item charinrange
32855  
32856  =back
32857  
32858  =over 4
32859  
32860  =item general_categories
32861  
32862  =back
32863  
32864  =over 4
32865  
32866  =item bidi_types
32867  
32868  =back
32869  
32870  =over 4
32871  
32872  =item compexcl
32873  
32874  =back
32875  
32876  =over 4
32877  
32878  =item casefold
32879  
32880  =back
32881  
32882  =over 4
32883  
32884  =item casespec
32885  
32886  =back
32887  
32888  =over 4
32889  
32890  =item namedseq()
32891  
32892  =back
32893  
32894  =over 4
32895  
32896  =item Unicode::UCD::UnicodeVersion
32897  
32898  =back
32899  
32900  =over 4
32901  
32902  =item Implementation Note
32903  
32904  =back
32905  
32906  =over 4
32907  
32908  =item BUGS
32909  
32910  =item AUTHOR
32911  
32912  =back
32913  
32914  =head2 User::grent - by-name interface to Perl's built-in getgr*()
32915  functions
32916  
32917  =over 4
32918  
32919  =item SYNOPSIS
32920  
32921  =item DESCRIPTION
32922  
32923  =item NOTE
32924  
32925  =item AUTHOR
32926  
32927  =back
32928  
32929  =head2 User::pwent - by-name interface to Perl's built-in getpw*()
32930  functions
32931  
32932  =over 4
32933  
32934  =item SYNOPSIS
32935  
32936  =item DESCRIPTION
32937  
32938  =over 4
32939  
32940  =item System Specifics
32941  
32942  =back
32943  
32944  =item NOTE
32945  
32946  =item AUTHOR
32947  
32948  =item HISTORY
32949  
32950  March 18th, 2000
32951  
32952  =back
32953  
32954  =head2 Win32 - Interfaces to some Win32 API Functions
32955  
32956  =over 4
32957  
32958  =item DESCRIPTION
32959  
32960  =over 4
32961  
32962  =item Alphabetical Listing of Win32 Functions
32963  
32964  Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
32965  Win32::CopyFile(FROM, TO, OVERWRITE), Win32::CreateDirectory(DIRECTORY),
32966  Win32::CreateFile(FILE), Win32::DomainName(),
32967  Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
32968  Win32::FsType(), Win32::FreeLibrary(HANDLE),
32969  Win32::GetANSIPathName(FILENAME), Win32::GetArchName(),
32970  Win32::GetChipName(), Win32::GetCwd(), Win32::GetCurrentThreadId(),
32971  Win32::GetFileVersion(FILENAME), Win32::GetFolderPath(FOLDER [, CREATE]),
32972  Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
32973  Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
32974  Win32::GetOSVersion(), Win32::GetOSName(),
32975  Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
32976  PROCNAME), Win32::GetTickCount(), Win32::GuidGen(), Win32::IsAdminUser(),
32977  Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
32978  Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
32979  SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
32980  Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
32981  Win32::OutputDebugString(STRING), Win32::RegisterServer(LIBRARYNAME),
32982  Win32::SetChildShowWindow(SHOWWINDOW), Win32::SetCwd(NEWDIRECTORY),
32983  Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
32984  PID), Win32::UnregisterServer(LIBRARYNAME)
32985  
32986  =back
32987  
32988  =back
32989  
32990  =head2 Win32API::File - Low-level access to Win32 system API calls for
32991  files/dirs.
32992  
32993  =over 4
32994  
32995  =item SYNOPSIS
32996  
32997  =item DESCRIPTION
32998  
32999  =over 4
33000  
33001  =item Object Oriented/Tied Handle Interface
33002  
33003  =item Exports
33004  
33005  C<":Func">, attrLetsToBits, C<$uBits= attrLetsToBits( $sAttributeLetters
33006  )>, C<"a">, C<"c">, C<"h">, C<"o">, C<"r">, C<"s">, C<"t">, createFile,
33007  C<$hObject= createFile( $sPath )>, C<$hObject= createFile( $sPath,
33008  $rvhvOptions )>, C<$hObject= createFile( $sPath, $svAccess )>, C<$hObject=
33009  createFile( $sPath, $svAccess, $rvhvOptions )>, C<$hObject= createFile(
33010  $sPath, $svAccess, $svShare )>, C<$hObject= createFile( $sPath, $svAccess,
33011  $svShare, $rvhvOptions )>, C<"q">, C<"r">, C<"w">, C<"k">, C<"t">, C<"n">,
33012  C<"c">, C<"e">, C<"kc">, C<"ke">, C<"tc">, C<"te">, C<"nc">, C<"ne">, Flags
33013  => $uFlags, Attributes => $sAttributes, Security => $pSecurityAttributes,
33014  Model => $hModelFile, Access => $sAccess, Access => $uAccess, Create =>
33015  $sCreate, Create => $uCreate, Share => $sShare, Share => $uShare,
33016  getLogicalDrives, C<@roots= getLogicalDrives()>, CloseHandle,
33017  C<CloseHandle( $hObject )>, CopyFile, C<CopyFile( $sOldFileName,
33018  $sNewFileName, $bFailIfExists )>, CreateFile, C<$hObject= CreateFile(
33019  $sPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
33020  C<"//./PhysicalDrive0">, C<"//./C:">, C<"//./A:">, C<"//./PIPE/PipeName">,
33021  DefineDosDevice, C<DefineDosDevice( $uFlags, $sDosDeviceName, $sTargetPath
33022  )>, C<DDD_RAW_TARGET_PATH>, C<DDD_REMOVE_DEFINITION>,
33023  C<DDD_EXACT_MATCH_ON_REMOVE>, DeleteFile, C<DeleteFile( $sFileName )>,
33024  DeviceIoControl, C<DeviceIoControl( $hDevice, $uIoControlCode, $pInBuf,
33025  $lInBuf, $opOutBuf, $lOutBuf, $olRetBytes, $pOverlapped )>, FdGetOsFHandle,
33026  C<$hNativeHandle= FdGetOsFHandle( $ivFd )>, fileConstant, C<$value=
33027  fileConstant( $sConstantName )>, fileLastError, C<$svError=
33028  fileLastError();>, C<fileLastError( $uError );>, GetDriveType,
33029  C<$uDriveType= GetDriveType( $sRootPath )>, C<DRIVE_UNKNOWN>,
33030  C<DRIVE_NO_ROOT_DIR>, C<DRIVE_REMOVABLE>, C<DRIVE_FIXED>, C<DRIVE_REMOTE>,
33031  C<DRIVE_CDROM>, C<DRIVE_RAMDISK>, GetFileAttributes, C<$uAttrs =
33032  GetFileAttributes( $sPath )>, C<FILE_ATTRIBUTE_ARCHIVE>,
33033  C<FILE_ATTRIBUTE_COMPRESSED>, C<FILE_ATTRIBUTE_DEVICE>,
33034  C<FILE_ATTRIBUTE_DIRECTORY>, C<FILE_ATTRIBUTE_ENCRYPTED>,
33035  C<FILE_ATTRIBUTE_HIDDEN>, C<FILE_ATTRIBUTE_NORMAL>,
33036  C<FILE_ATTRIBUTE_NOT_CONTENT_INDEXED>, C<FILE_ATTRIBUTE_OFFLINE>,
33037  C<FILE_ATTRIBUTE_READONLY>, C<FILE_ATTRIBUTE_REPARSE_POINT>,
33038  C<FILE_ATTRIBUTE_SPARSE_FILE>, C<FILE_ATTRIBUTE_SYSTEM>,
33039  C<FILE_ATTRIBUTE_TEMPORARY>, GetFileType, C<$uFileType= GetFileType( $hFile
33040  )>, C<FILE_TYPE_UNKNOWN>, C<FILE_TYPE_DISK>, C<FILE_TYPE_CHAR>,
33041  C<FILE_TYPE_PIPE>, getFileSize, C<$size= getFileSize( $hFile )>,
33042  GetFileSize, C<$iSizeLow= GetFileSize($win32Handle, $iSizeHigh)>,
33043  GetOverlappedResult, C<$bRetval= GetOverlappedResult( $win32Handle,
33044  $pOverlapped,  $numBytesTransferred, $bWait )>, GetLogicalDrives,
33045  C<$uDriveBits= GetLogicalDrives()>, GetLogicalDriveStrings, C<$olOutLength=
33046  GetLogicalDriveStrings( $lBufSize, $osBuffer )>, GetHandleInformation,
33047  C<GetHandleInformation( $hObject, $ouFlags )>, GetOsFHandle,
33048  C<$hNativeHandle= GetOsFHandle( FILE )>, GetVolumeInformation,
33049  C<GetVolumeInformation( $sRootPath, $osVolName, $lVolName, $ouSerialNum,
33050  $ouMaxNameLen, $ouFsFlags, $osFsType, $lFsType )>, C<FS_CASE_IS_PRESERVED>,
33051  C<FS_CASE_SENSITIVE>, C<FS_UNICODE_STORED_ON_DISK>, C<FS_PERSISTENT_ACLS>,
33052  C<FS_FILE_COMPRESSION>, C<FS_VOL_IS_COMPRESSED>, IsRecognizedPartition,
33053  C<IsRecognizedPartition( $ivPartitionType )>, IsContainerPartition,
33054  C<IsContainerPartition( $ivPartitionType )>, MoveFile, C<MoveFile(
33055  $sOldName, $sNewName )>, MoveFileEx, C<MoveFileEx( $sOldName, $sNewName,
33056  $uFlags )>, C<MOVEFILE_REPLACE_EXISTING>, C<MOVEFILE_COPY_ALLOWED>,
33057  C<MOVEFILE_DELAY_UNTIL_REBOOT>, C<MOVEFILE_WRITE_THROUGH>, OsFHandleOpen,
33058  C<OsFHandleOpen( FILE, $hNativeHandle, $sMode )>, OsFHandleOpenFd, C<$ivFD=
33059  OsFHandleOpenFd( $hNativeHandle, $uMode )>, QueryDosDevice, C<$olTargetLen=
33060  QueryDosDevice( $sDosDeviceName, $osTargetPath, $lTargetBuf )>, ReadFile,
33061  C<ReadFile( $hFile, $opBuffer, $lBytes, $olBytesRead, $pOverlapped )>,
33062  SetErrorMode, C<$uOldMode= SetErrorMode( $uNewMode )>,
33063  C<SEM_FAILCRITICALERRORS>, C<SEM_NOALIGNMENTFAULTEXCEPT>,
33064  C<SEM_NOGPFAULTERRORBOX>, C<SEM_NOOPENFILEERRORBOX>, setFilePointer,
33065  C<$uNewPos = setFilePointer( $hFile, $ivOffset, $uFromWhere )>,
33066  SetFilePointer, C<$uNewPos = SetFilePointer( $hFile, $ivOffset,
33067  $ioivOffsetHigh, $uFromWhere )>, SetHandleInformation,
33068  C<SetHandleInformation( $hObject, $uMask, $uFlags )>, WriteFile,
33069  C<WriteFile( $hFile, $pBuffer, $lBytes, $ouBytesWritten, $pOverlapped )>,
33070  C<":FuncA">, C<":FuncW">, CopyFileW, C<CopyFileW( $swOldFileName,
33071  $swNewFileName, $bFailIfExists )>, CreateFileW, C<$hObject= CreateFileW(
33072  $swPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
33073  DefineDosDeviceW, C<DefineDosDeviceW( $uFlags, $swDosDeviceName,
33074  $swTargetPath )>, DeleteFileW, C<DeleteFileW( $swFileName )>,
33075  GetDriveTypeW, C<$uDriveType= GetDriveTypeW( $swRootPath )>,
33076  GetFileAttributesW, C<$uAttrs= GetFileAttributesW( $swPath )>,
33077  GetLogicalDriveStringsW, C<$olwOutLength= GetLogicalDriveStringsW(
33078  $lwBufSize, $oswBuffer )>, GetVolumeInformationW, C<GetVolumeInformationW(
33079  $swRootPath, $oswVolName, $lwVolName, $ouSerialNum, $ouMaxNameLen,
33080  $ouFsFlags, $oswFsType, $lwFsType )>, MoveFileW, C<MoveFileW( $swOldName,
33081  $swNewName )>, MoveFileExW, C<MoveFileExW( $swOldName, $swNewName, $uFlags
33082  )>, QueryDosDeviceW, C<$olwTargetLen= QueryDosDeviceW( $swDeviceName,
33083  $oswTargetPath, $lwTargetBuf )>, C<":Misc">, C<":DDD_">, C<":DRIVE_">,
33084  C<":FILE_">, C<":FILE_ATTRIBUTE_">, C<":FILE_FLAG_">, C<":FILE_SHARE_">,
33085  C<":FILE_TYPE_">, C<":FS_">, C<":HANDLE_FLAG_">, HANDLE_FLAG_INHERIT,
33086  HANDLE_FLAG_PROTECT_FROM_CLOSE, C<":IOCTL_STORAGE_">,
33087  C<IOCTL_STORAGE_CHECK_VERIFY>, C<IOCTL_STORAGE_MEDIA_REMOVAL>,
33088  C<IOCTL_STORAGE_EJECT_MEDIA>, C<IOCTL_STORAGE_LOAD_MEDIA>,
33089  C<IOCTL_STORAGE_RESERVE>, C<IOCTL_STORAGE_RELEASE>,
33090  C<IOCTL_STORAGE_FIND_NEW_DEVICES>, C<IOCTL_STORAGE_GET_MEDIA_TYPES>,
33091  C<$ucCylsLow[$i]>, C<$ivcCylsHigh[$i]>, C<$uMediaType[$i]>,
33092  C<$uTracksPerCyl[$i]>, C<$uSectsPerTrack[$i]>, C<$uBytesPerSect[$i]>,
33093  C<":IOCTL_DISK_">, C<IOCTL_DISK_GET_DRIVE_GEOMETRY>, C<$ucCylsLow>,
33094  C<$ivcCylsHigh>, C<$uMediaType>, C<$uTracksPerCyl>, C<$uSectsPerTrack>,
33095  C<$uBytesPerSect>, C<IOCTL_DISK_GET_PARTITION_INFO>, C<$uStartLow> and
33096  C<$ivStartHigh>, C<$ucHiddenSects>, C<$uPartitionSeqNumber>,
33097  C<$uPartitionType>, C<$bActive>, C<$bRecognized>, C<$bToRewrite>,
33098  C<IOCTL_DISK_SET_PARTITION_INFO>, C<IOCTL_DISK_GET_DRIVE_LAYOUT>,
33099  C<$cPartitions>, C<$uDiskSignature>, C<IOCTL_DISK_GET_MEDIA_TYPES>,
33100  C<IOCTL_DISK_SET_DRIVE_LAYOUT>, C<IOCTL_DISK_VERIFY>, C<$uStartOffsetLow>
33101  and C<$ivStartOffsetHigh>, C<$uLength>, C<IOCTL_DISK_FORMAT_TRACKS>,
33102  C<IOCTL_DISK_REASSIGN_BLOCKS>, C<IOCTL_DISK_PERFORMANCE>,
33103  C<IOCTL_DISK_IS_WRITABLE>, C<IOCTL_DISK_LOGGING>, DISK_LOGGING_START,
33104  DISK_LOGGING_STOP, DISK_LOGGING_DUMP, DISK_LOGGING_BINNING,
33105  C<IOCTL_DISK_FORMAT_TRACKS_EX>, C<IOCTL_DISK_HISTOGRAM_STRUCTURE>,
33106  C<IOCTL_DISK_HISTOGRAM_DATA>, C<IOCTL_DISK_HISTOGRAM_RESET>,
33107  C<IOCTL_DISK_REQUEST_STRUCTURE>, C<IOCTL_DISK_REQUEST_DATA>, C<":FSCTL_">,
33108  C<FSCTL_SET_REPARSE_POINT>, C<FSCTL_GET_REPARSE_POINT>,
33109  C<FSCTL_DELETE_REPARSE_POINT>, C<":GENERIC_">, C<":MEDIA_TYPE">,
33110  C<Unknown>, C<F5_1Pt2_512>, C<F3_1Pt44_512>, C<F3_2Pt88_512>,
33111  C<F3_20Pt8_512>, C<F3_720_512>, C<F5_360_512>, C<F5_320_512>,
33112  C<F5_320_1024>, C<F5_180_512>, C<F5_160_512>, C<RemovableMedia>,
33113  C<FixedMedia>, C<F3_120M_512>, C<":MOVEFILE_">, C<":SECURITY_">,
33114  C<":SEM_">, C<":PARTITION_">, C<":ALL">
33115  
33116  =back
33117  
33118  =item BUGS
33119  
33120  =item AUTHOR
33121  
33122  =item SEE ALSO
33123  
33124  =back
33125  
33126  =head2 Win32CORE - Win32 CORE function stubs
33127  
33128  =over 4
33129  
33130  =item DESCRIPTION
33131  
33132  =item HISTORY
33133  
33134  =back
33135  
33136  =head2 XSLoader - Dynamically load C libraries into Perl code
33137  
33138  =over 4
33139  
33140  =item VERSION
33141  
33142  =item SYNOPSIS
33143  
33144  =item DESCRIPTION
33145  
33146  =over 4
33147  
33148  =item Migration from C<DynaLoader>
33149  
33150  =item Backward compatible boilerplate
33151  
33152  =back
33153  
33154  =item Order of initialization: early load()
33155  
33156  =over 4
33157  
33158  =item The most hairy case
33159  
33160  =back
33161  
33162  =item DIAGNOSTICS
33163  
33164  C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
33165  C<Undefined symbols present after loading %s: %s>,
33166  C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
33167  
33168  =item LIMITATIONS
33169  
33170  =item BUGS
33171  
33172  =item SEE ALSO
33173  
33174  =item AUTHORS
33175  
33176  =item COPYRIGHT
33177  
33178  =back
33179  
33180  =head1 AUXILIARY DOCUMENTATION
33181  
33182  Here should be listed all the extra programs' documentation, but they
33183  don't all have manual pages yet:
33184  
33185  =over 4
33186  
33187  =item a2p
33188  
33189  =item c2ph
33190  
33191  =item dprofpp
33192  
33193  =item h2ph
33194  
33195  =item h2xs
33196  
33197  =item perlbug
33198  
33199  =item perldoc
33200  
33201  =item pl2pm
33202  
33203  =item pod2html
33204  
33205  =item pod2man
33206  
33207  =item s2p
33208  
33209  =item splain
33210  
33211  =item xsubpp
33212  
33213  =back
33214  
33215  =head1 AUTHOR
33216  
33217  Larry Wall <F<larry@wall.org>>, with the help of oodles
33218  of other folks.
33219