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 8perltoc - perl documentation table of contents 9 10=head1 DESCRIPTION 11 12This page provides a brief table of contents for the rest of the Perl 13documentation set. It is meant to be scanned quickly or grepped 14through 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 Basic syntax overview 75 76=item Perl variable types 77 78Scalars, Arrays, Hashes 79 80=item Variable scoping 81 82=item Conditional and looping constructs 83 84if, while, for, foreach 85 86=item Builtin operators and functions 87 88Arithmetic, Numeric comparison, String comparison, Boolean logic, 89Miscellaneous 90 91=item Files and I/O 92 93=item Regular expressions 94 95Simple matching, Simple substitution, More complex regular expressions, 96Parentheses for capturing, Other regexp features 97 98=item Writing subroutines 99 100=item OO Perl 101 102=item Using Perl modules 103 104=back 105 106=item AUTHOR 107 108=back 109 110=head2 perlreftut - Mark's very short tutorial about references 111 112=over 4 113 114=item DESCRIPTION 115 116=item Who Needs Complicated Data Structures? 117 118=item The Solution 119 120=item Syntax 121 122=over 4 123 124=item Making References 125 126=item Using References 127 128=item An Example 129 130=item Arrow Rule 131 132=back 133 134=item Solution 135 136=item The Rest 137 138=item Summary 139 140=item Credits 141 142=over 4 143 144=item Distribution Conditions 145 146=back 147 148=back 149 150=head2 perldsc - Perl Data Structures Cookbook 151 152=over 4 153 154=item DESCRIPTION 155 156arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, 157more elaborate constructs 158 159=item REFERENCES 160 161=item COMMON MISTAKES 162 163=item CAVEAT ON PRECEDENCE 164 165=item WHY YOU SHOULD ALWAYS C<use strict> 166 167=item DEBUGGING 168 169=item CODE EXAMPLES 170 171=item ARRAYS OF ARRAYS 172 173=over 4 174 175=item Declaration of an ARRAY OF ARRAYS 176 177=item Generation of an ARRAY OF ARRAYS 178 179=item Access and Printing of an ARRAY OF ARRAYS 180 181=back 182 183=item HASHES OF ARRAYS 184 185=over 4 186 187=item Declaration of a HASH OF ARRAYS 188 189=item Generation of a HASH OF ARRAYS 190 191=item Access and Printing of a HASH OF ARRAYS 192 193=back 194 195=item ARRAYS OF HASHES 196 197=over 4 198 199=item Declaration of an ARRAY OF HASHES 200 201=item Generation of an ARRAY OF HASHES 202 203=item Access and Printing of an ARRAY OF HASHES 204 205=back 206 207=item HASHES OF HASHES 208 209=over 4 210 211=item Declaration of a HASH OF HASHES 212 213=item Generation of a HASH OF HASHES 214 215=item Access and Printing of a HASH OF HASHES 216 217=back 218 219=item MORE ELABORATE RECORDS 220 221=over 4 222 223=item Declaration of MORE ELABORATE RECORDS 224 225=item Declaration of a HASH OF COMPLEX RECORDS 226 227=item Generation of a HASH OF COMPLEX RECORDS 228 229=back 230 231=item Database Ties 232 233=item SEE ALSO 234 235=item AUTHOR 236 237=back 238 239=head2 perllol - Manipulating Arrays of Arrays in Perl 240 241=over 4 242 243=item DESCRIPTION 244 245=over 4 246 247=item Declaration and Access of Arrays of Arrays 248 249=item Growing Your Own 250 251=item Access and Printing 252 253=item Slices 254 255=back 256 257=item SEE ALSO 258 259=item AUTHOR 260 261=back 262 263=head2 perlrequick - Perl regular expressions quick start 264 265=over 4 266 267=item DESCRIPTION 268 269=item The Guide 270 271=over 4 272 273=item Simple word matching 274 275=item Using character classes 276 277=item Matching this or that 278 279=item Grouping things and hierarchical matching 280 281=item Extracting matches 282 283=item Matching repetitions 284 285=item More matching 286 287=item Search and replace 288 289=item The split operator 290 291=back 292 293=item BUGS 294 295=item SEE ALSO 296 297=item AUTHOR AND COPYRIGHT 298 299=over 4 300 301=item Acknowledgments 302 303=back 304 305=back 306 307=head2 perlretut - Perl regular expressions tutorial 308 309=over 4 310 311=item DESCRIPTION 312 313=item Part 1: The basics 314 315=over 4 316 317=item Simple word matching 318 319=item Using character classes 320 321=item Matching this or that 322 323=item Grouping things and hierarchical matching 324 325=item Extracting matches 326 327=item Matching repetitions 328 329=item Building a regexp 330 331=item Using regular expressions in Perl 332 333=back 334 335=item Part 2: Power tools 336 337=over 4 338 339=item More on characters, strings, and character classes 340 341=item Compiling and saving regular expressions 342 343=item Embedding comments and modifiers in a regular expression 344 345=item Non-capturing groupings 346 347=item Looking ahead and looking behind 348 349=item Using independent subexpressions to prevent backtracking 350 351=item Conditional expressions 352 353=item A bit of magic: executing Perl code in a regular expression 354 355=item Pragmas and debugging 356 357=back 358 359=item BUGS 360 361=item SEE ALSO 362 363=item AUTHOR AND COPYRIGHT 364 365=over 4 366 367=item Acknowledgments 368 369=back 370 371=back 372 373=head2 perlboot - Beginner's Object-Oriented Tutorial 374 375=over 4 376 377=item DESCRIPTION 378 379=over 4 380 381=item If we could talk to the animals... 382 383=item Introducing the method invocation arrow 384 385=item Invoking a barnyard 386 387=item The extra parameter of method invocation 388 389=item Calling a second method to simplify things 390 391=item Inheriting the windpipes 392 393=item A few notes about @ISA 394 395=item Overriding the methods 396 397=item Starting the search from a different place 398 399=item The SUPER way of doing things 400 401=item Where we're at so far... 402 403=item A horse is a horse, of course of course -- or is it? 404 405=item Invoking an instance method 406 407=item Accessing the instance data 408 409=item How to build a horse 410 411=item Inheriting the constructor 412 413=item Making a method work with either classes or instances 414 415=item Adding parameters to a method 416 417=item More interesting instances 418 419=item A horse of a different color 420 421=item Summary 422 423=back 424 425=item SEE ALSO 426 427=item COPYRIGHT 428 429=back 430 431=head2 perltoot - Tom's object-oriented tutorial for perl 432 433=over 4 434 435=item DESCRIPTION 436 437=item Creating a Class 438 439=over 4 440 441=item Object Representation 442 443=item Class Interface 444 445=item Constructors and Instance Methods 446 447=item Planning for the Future: Better Constructors 448 449=item Destructors 450 451=item Other Object Methods 452 453=back 454 455=item Class Data 456 457=over 4 458 459=item Accessing Class Data 460 461=item Debugging Methods 462 463=item Class Destructors 464 465=item Documenting the Interface 466 467=back 468 469=item Aggregation 470 471=item Inheritance 472 473=over 4 474 475=item Overridden Methods 476 477=item Multiple Inheritance 478 479=item UNIVERSAL: The Root of All Objects 480 481=back 482 483=item Alternate Object Representations 484 485=over 4 486 487=item Arrays as Objects 488 489=item Closures as Objects 490 491=back 492 493=item AUTOLOAD: Proxy Methods 494 495=over 4 496 497=item Autoloaded Data Methods 498 499=item Inherited Autoloaded Data Methods 500 501=back 502 503=item Metaclassical Tools 504 505=over 4 506 507=item Class::Struct 508 509=item Data Members as Variables 510 511=back 512 513=item NOTES 514 515=over 4 516 517=item Object Terminology 518 519=back 520 521=item SEE ALSO 522 523=item AUTHOR AND COPYRIGHT 524 525=item COPYRIGHT 526 527=over 4 528 529=item Acknowledgments 530 531=back 532 533=back 534 535=head2 perltooc - Tom's OO Tutorial for Class Data in Perl 536 537=over 4 538 539=item DESCRIPTION 540 541=item Class Data in a Can 542 543=item Class Data as Package Variables 544 545=over 4 546 547=item Putting All Your Eggs in One Basket 548 549=item Inheritance Concerns 550 551=item The Eponymous Meta-Object 552 553=item Indirect References to Class Data 554 555=item Monadic Classes 556 557=item Translucent Attributes 558 559=back 560 561=item Class Data as Lexical Variables 562 563=over 4 564 565=item Privacy and Responsibility 566 567=item File-Scoped Lexicals 568 569=item More Inheritance Concerns 570 571=item Locking the Door and Throwing Away the Key 572 573=item Translucency Revisited 574 575=back 576 577=item NOTES 578 579=item SEE ALSO 580 581=item AUTHOR AND COPYRIGHT 582 583=item ACKNOWLEDGEMENTS 584 585=item HISTORY 586 587=back 588 589=head2 perlbot - Bag'o Object Tricks (the BOT) 590 591=over 4 592 593=item DESCRIPTION 594 595=item OO SCALING TIPS 596 597=item INSTANCE VARIABLES 598 599=item SCALAR INSTANCE VARIABLES 600 601=item INSTANCE VARIABLE INHERITANCE 602 603=item OBJECT RELATIONSHIPS 604 605=item OVERRIDING SUPERCLASS METHODS 606 607=item USING RELATIONSHIP WITH SDBM 608 609=item THINKING OF CODE REUSE 610 611=item CLASS CONTEXT AND THE OBJECT 612 613=item INHERITING A CONSTRUCTOR 614 615=item DELEGATION 616 617=item SEE ALSO 618 619=back 620 621=head2 perlstyle - Perl style guide 622 623=over 4 624 625=item DESCRIPTION 626 627=back 628 629=head2 perlcheat - Perl 5 Cheat Sheet 630 631=over 4 632 633=item DESCRIPTION 634 635=over 4 636 637=item The sheet 638 639=back 640 641=item ACKNOWLEDGEMENTS 642 643=item AUTHOR 644 645=item SEE ALSO 646 647=back 648 649=head2 perltrap - Perl traps for the unwary 650 651=over 4 652 653=item DESCRIPTION 654 655=over 4 656 657=item Awk Traps 658 659=item C/C++ Traps 660 661=item Sed Traps 662 663=item Shell Traps 664 665=item Perl Traps 666 667=item Perl4 to Perl5 Traps 668 669Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical 670Traps, General data type traps, Context Traps - scalar, list contexts, 671Precedence Traps, General Regular Expression Traps using s///, etc, 672Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps 673 674=item Discontinuance, Deprecation, and BugFix traps 675 676Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, 677Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, 678Discontinuance, Deprecation, Discontinuance, Discontinuance 679 680=item Parsing Traps 681 682Parsing, Parsing, Parsing, Parsing, Parsing 683 684=item Numerical Traps 685 686Numerical, Numerical, Numerical, Bitwise string ops 687 688=item General data type traps 689 690(Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), 691(Constants), (Scalars), (Variable Suicide) 692 693=item Context Traps - scalar, list contexts 694 695(list context), (scalar context), (scalar context), (list, builtin) 696 697=item Precedence Traps 698 699Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, 700Precedence 701 702=item General Regular Expression Traps using s///, etc. 703 704Regular Expression, Regular Expression, Regular Expression, Regular 705Expression, Regular Expression, Regular Expression, Regular Expression, 706Regular Expression, Regular Expression 707 708=item Subroutine, Signal, Sorting Traps 709 710(Signals), (Sort Subroutine), warn() won't let you specify a filehandle 711 712=item OS Traps 713 714(SysV), (SysV) 715 716=item Interpolation Traps 717 718Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, 719Interpolation, Interpolation, Interpolation, Interpolation 720 721=item DBM Traps 722 723DBM, DBM 724 725=item Unclassified Traps 726 727C<require>/C<do> trap using returned value, C<split> on empty string with 728LIMIT specified 729 730=back 731 732=back 733 734=head2 perldebtut - Perl debugging tutorial 735 736=over 4 737 738=item DESCRIPTION 739 740=item use strict 741 742=item Looking at data and -w and v 743 744=item help 745 746=item Stepping through code 747 748=item Placeholder for a, w, t, T 749 750=item REGULAR EXPRESSIONS 751 752=item OUTPUT TIPS 753 754=item CGI 755 756=item GUIs 757 758=item SUMMARY 759 760=item SEE ALSO 761 762=item AUTHOR 763 764=item CONTRIBUTORS 765 766=back 767 768=head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31 76917:37:17 $) 770 771=over 4 772 773=item DESCRIPTION 774 775=over 4 776 777=item Where to get the perlfaq 778 779=item How to contribute to the perlfaq 780 781=item What will happen if you mail your Perl programming problems to the 782authors 783 784=back 785 786=item Credits 787 788=item Author and Copyright Information 789 790=over 4 791 792=item Bundled Distributions 793 794=item Disclaimer 795 796=back 797 798=item Table of Contents 799 800perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2 801- Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4 802- Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular 803Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System 804Interaction, perlfaq9 - Networking 805 806=item The Questions 807 808=over 4 809 810=item L<perlfaq1>: General Questions About Perl 811 812=item L<perlfaq2>: Obtaining and Learning about Perl 813 814=item L<perlfaq3>: Programming Tools 815 816=item L<perlfaq4>: Data Manipulation 817 818=item L<perlfaq5>: Files and Formats 819 820=item L<perlfaq6>: Regular Expressions 821 822=item L<perlfaq7>: General Perl Language Issues 823 824=item L<perlfaq8>: System Interaction 825 826=item L<perlfaq9>: Networking 827 828=back 829 830=back 831 832=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date: 8332003/11/23 08:02:29 $) 834 835=over 4 836 837=item DESCRIPTION 838 839=over 4 840 841=item What is Perl? 842 843=item Who supports Perl? Who develops it? Why is it free? 844 845=item Which version of Perl should I use? 846 847=item What are perl4 and perl5? 848 849=item What is Ponie? 850 851=item What is perl6? 852 853=item How stable is Perl? 854 855=item Is Perl difficult to learn? 856 857=item How does Perl compare with other languages like Java, Python, REXX, 858Scheme, or Tcl? 859 860=item Can I do [task] in Perl? 861 862=item When shouldn't I program in Perl? 863 864=item What's the difference between "perl" and "Perl"? 865 866=item Is it a Perl program or a Perl script? 867 868=item What is a JAPH? 869 870=item Where can I get a list of Larry Wall witticisms? 871 872=item How can I convince my sysadmin/supervisor/employees to use version 8735/5.6.1/Perl instead of some other language? 874 875=back 876 877=item AUTHOR AND COPYRIGHT 878 879=back 880 881=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $, 882$Date: 2003/10/16 04:57:38 $) 883 884=over 4 885 886=item DESCRIPTION 887 888=over 4 889 890=item What machines support Perl? Where do I get it? 891 892=item How can I get a binary version of Perl? 893 894=item I don't have a C compiler on my system. How can I compile perl? 895 896=item I copied the Perl binary from one machine to another, but scripts 897don't work. 898 899=item I grabbed the sources and tried to compile but gdbm/dynamic 900loading/malloc/linking/... failed. How do I make it work? 901 902=item What modules and extensions are available for Perl? What is CPAN? 903What does CPAN/src/... mean? 904 905=item Is there an ISO or ANSI certified version of Perl? 906 907=item Where can I get information on Perl? 908 909=item What are the Perl newsgroups on Usenet? Where do I post questions? 910 911=item Where should I post source code? 912 913=item Perl Books 914 915References, Tutorials, Task-Oriented, Special Topics 916 917=item Perl in Magazines 918 919=item Perl on the Net: FTP and WWW Access 920 921=item What mailing lists are there for Perl? 922 923=item Archives of comp.lang.perl.misc 924 925=item Where can I buy a commercial version of Perl? 926 927=item Where do I send bug reports? 928 929=item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? 930 931=back 932 933=item AUTHOR AND COPYRIGHT 934 935=back 936 937=head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24 93819:55:50 $) 939 940=over 4 941 942=item DESCRIPTION 943 944=over 4 945 946=item How do I do (anything)? 947 948=item How can I use Perl interactively? 949 950=item Is there a Perl shell? 951 952=item How do I find which modules are installed on my system? 953 954=item How do I debug my Perl programs? 955 956=item How do I profile my Perl programs? 957 958=item How do I cross-reference my Perl programs? 959 960=item Is there a pretty-printer (formatter) for Perl? 961 962=item Is there a ctags for Perl? 963 964=item Is there an IDE or Windows Perl Editor? 965 966Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl, 967GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, 968MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha 969 970=item Where can I get Perl macros for vi? 971 972=item Where can I get perl-mode for emacs? 973 974=item How can I use curses with Perl? 975 976=item How can I use X or Tk with Perl? 977 978=item How can I generate simple menus without using CGI or Tk? 979 980=item How can I make my Perl program run faster? 981 982=item How can I make my Perl program take less memory? 983 984Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and 985stringification, Pass by reference, Tie large variables to disk 986 987=item Is it safe to return a reference to local or lexical data? 988 989=item How can I free an array or hash so my program shrinks? 990 991=item How can I make my CGI script more efficient? 992 993=item How can I hide the source for my Perl program? 994 995=item How can I compile my Perl program into byte code or C? 996 997=item How can I compile Perl into Java? 998 999=item How can I get C<#!perl> to work on [MS-DOS,NT,...]? 1000 1001=item Can I write useful Perl programs on the command line? 1002 1003=item Why don't Perl one-liners work on my DOS/Mac/VMS system? 1004 1005=item Where can I learn about CGI or Web programming in Perl? 1006 1007=item Where can I learn about object-oriented Perl programming? 1008 1009=item Where can I learn about linking C with Perl? [h2xs, xsubpp] 1010 1011=item I've read perlembed, perlguts, etc., but I can't embed perl in 1012my C program; what am I doing wrong? 1013 1014=item When I tried to run my script, I got this message. What does it mean? 1015 1016=item What's MakeMaker? 1017 1018=back 1019 1020=item AUTHOR AND COPYRIGHT 1021 1022=back 1023 1024=head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30 102500:50:08 $) 1026 1027=over 4 1028 1029=item DESCRIPTION 1030 1031=item Data: Numbers 1032 1033=over 4 1034 1035=item Why am I getting long decimals (eg, 19.9499999999999) instead of the 1036numbers I should be getting (eg, 19.95)? 1037 1038=item Why is int() broken? 1039 1040=item Why isn't my octal data interpreted correctly? 1041 1042=item Does Perl have a round() function? What about ceil() and floor()? 1043Trig functions? 1044 1045=item How do I convert between numeric representations/bases/radixes? 1046 1047How do I convert hexadecimal into decimal, How do I convert from decimal to 1048hexadecimal, How do I convert from octal to decimal, How do I convert from 1049decimal to octal, How do I convert from binary to decimal, How do I convert 1050from decimal to binary 1051 1052=item Why doesn't & work the way I want it to? 1053 1054=item How do I multiply matrices? 1055 1056=item How do I perform an operation on a series of integers? 1057 1058=item How can I output Roman numerals? 1059 1060=item Why aren't my random numbers random? 1061 1062=item How do I get a random number between X and Y? 1063 1064=back 1065 1066=item Data: Dates 1067 1068=over 4 1069 1070=item How do I find the day or week of the year? 1071 1072=item How do I find the current century or millennium? 1073 1074=item How can I compare two dates and find the difference? 1075 1076=item How can I take a string and turn it into epoch seconds? 1077 1078=item How can I find the Julian Day? 1079 1080=item How do I find yesterday's date? 1081 1082=item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? 1083 1084=back 1085 1086=item Data: Strings 1087 1088=over 4 1089 1090=item How do I validate input? 1091 1092=item How do I unescape a string? 1093 1094=item How do I remove consecutive pairs of characters? 1095 1096=item How do I expand function calls in a string? 1097 1098=item How do I find matching/nesting anything? 1099 1100=item How do I reverse a string? 1101 1102=item How do I expand tabs in a string? 1103 1104=item How do I reformat a paragraph? 1105 1106=item How can I access or change N characters of a string? 1107 1108=item How do I change the Nth occurrence of something? 1109 1110=item How can I count the number of occurrences of a substring within a 1111string? 1112 1113=item How do I capitalize all the words on one line? 1114 1115=item How can I split a [character] delimited string except when inside 1116[character]? 1117 1118=item How do I strip blank space from the beginning/end of a string? 1119 1120=item How do I pad a string with blanks or pad a number with zeroes? 1121 1122=item How do I extract selected columns from a string? 1123 1124=item How do I find the soundex value of a string? 1125 1126=item How can I expand variables in text strings? 1127 1128=item What's wrong with always quoting "$vars"? 1129 1130=item Why don't my E<lt>E<lt>HERE documents work? 1131 1132There must be no space after the E<lt>E<lt> part, There (probably) should 1133be a semicolon at the end, You can't (easily) have any space in front of 1134the tag 1135 1136=back 1137 1138=item Data: Arrays 1139 1140=over 4 1141 1142=item What is the difference between a list and an array? 1143 1144=item What is the difference between $array[1] and @array[1]? 1145 1146=item How can I remove duplicate elements from a list or array? 1147 1148a), b), c), d), e) 1149 1150=item How can I tell whether a certain element is contained in a list or 1151array? 1152 1153=item How do I compute the difference of two arrays? How do I compute the 1154intersection of two arrays? 1155 1156=item How do I test whether two arrays or hashes are equal? 1157 1158=item How do I find the first array element for which a condition is true? 1159 1160=item How do I handle linked lists? 1161 1162=item How do I handle circular lists? 1163 1164=item How do I shuffle an array randomly? 1165 1166=item How do I process/modify each element of an array? 1167 1168=item How do I select a random element from an array? 1169 1170=item How do I permute N elements of a list? 1171 1172=item How do I sort an array by (anything)? 1173 1174=item How do I manipulate arrays of bits? 1175 1176=item Why does defined() return true on empty arrays and hashes? 1177 1178=back 1179 1180=item Data: Hashes (Associative Arrays) 1181 1182=over 4 1183 1184=item How do I process an entire hash? 1185 1186=item What happens if I add or remove keys from a hash while iterating over 1187it? 1188 1189=item How do I look up a hash element by value? 1190 1191=item How can I know how many entries are in a hash? 1192 1193=item How do I sort a hash (optionally by value instead of key)? 1194 1195=item How can I always keep my hash sorted? 1196 1197=item What's the difference between "delete" and "undef" with hashes? 1198 1199=item Why don't my tied hashes make the defined/exists distinction? 1200 1201=item How do I reset an each() operation part-way through? 1202 1203=item How can I get the unique keys from two hashes? 1204 1205=item How can I store a multidimensional array in a DBM file? 1206 1207=item How can I make my hash remember the order I put elements into it? 1208 1209=item Why does passing a subroutine an undefined element in a hash create 1210it? 1211 1212=item How can I make the Perl equivalent of a C structure/C++ class/hash or 1213array of hashes or arrays? 1214 1215=item How can I use a reference as a hash key? 1216 1217=back 1218 1219=item Data: Misc 1220 1221=over 4 1222 1223=item How do I handle binary data correctly? 1224 1225=item How do I determine whether a scalar is a number/whole/integer/float? 1226 1227=item How do I keep persistent data across program calls? 1228 1229=item How do I print out or copy a recursive data structure? 1230 1231=item How do I define methods for every class/object? 1232 1233=item How do I verify a credit card checksum? 1234 1235=item How do I pack arrays of doubles or floats for XS code? 1236 1237=back 1238 1239=item AUTHOR AND COPYRIGHT 1240 1241=back 1242 1243=head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23 124408:07:46 $) 1245 1246=over 4 1247 1248=item DESCRIPTION 1249 1250=over 4 1251 1252=item How do I flush/unbuffer an output filehandle? Why must I do this? 1253 1254=item How do I change one line in a file/delete a line in a file/insert a 1255line in the middle of a file/append to the beginning of a file? 1256 1257=item How do I count the number of lines in a file? 1258 1259=item How can I use Perl's C<-i> option from within a program? 1260 1261=item How do I make a temporary file name? 1262 1263=item How can I manipulate fixed-record-length files? 1264 1265=item How can I make a filehandle local to a subroutine? How do I pass 1266filehandles between subroutines? How do I make an array of filehandles? 1267 1268=item How can I use a filehandle indirectly? 1269 1270=item How can I set up a footer format to be used with write()? 1271 1272=item How can I write() into a string? 1273 1274=item How can I output my numbers with commas added? 1275 1276=item How can I translate tildes (~) in a filename? 1277 1278=item How come when I open a file read-write it wipes it out? 1279 1280=item Why do I sometimes get an "Argument list too long" when I use 1281E<lt>*E<gt>? 1282 1283=item Is there a leak/bug in glob()? 1284 1285=item How can I open a file with a leading ">" or trailing blanks? 1286 1287=item How can I reliably rename a file? 1288 1289=item How can I lock a file? 1290 1291=item Why can't I just open(FH, "E<gt>file.lock")? 1292 1293=item I still don't get locking. I just want to increment the number in 1294the file. How can I do this? 1295 1296=item All I want to do is append a small amount of text to the end of a 1297file. Do I still have to use locking? 1298 1299=item How do I randomly update a binary file? 1300 1301=item How do I get a file's timestamp in perl? 1302 1303=item How do I set a file's timestamp in perl? 1304 1305=item How do I print to more than one file at once? 1306 1307=item How can I read in an entire file all at once? 1308 1309=item How can I read in a file by paragraphs? 1310 1311=item How can I read a single character from a file? From the keyboard? 1312 1313=item How can I tell whether there's a character waiting on a filehandle? 1314 1315=item How do I do a C<tail -f> in perl? 1316 1317=item How do I dup() a filehandle in Perl? 1318 1319=item How do I close a file descriptor by number? 1320 1321=item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't 1322`C:\temp\foo.exe` work? 1323 1324=item Why doesn't glob("*.*") get all the files? 1325 1326=item Why does Perl let me delete read-only files? Why does C<-i> clobber 1327protected files? Isn't this a bug in Perl? 1328 1329=item How do I select a random line from a file? 1330 1331=item Why do I get weird spaces when I print an array of lines? 1332 1333=back 1334 1335=item AUTHOR AND COPYRIGHT 1336 1337=back 1338 1339=head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03 134020:05:28 $) 1341 1342=over 4 1343 1344=item DESCRIPTION 1345 1346=over 4 1347 1348=item How can I hope to use regular expressions without creating illegible 1349and unmaintainable code? 1350 1351Comments Outside the Regex, Comments Inside the Regex, Different Delimiters 1352 1353=item I'm having trouble matching over more than one line. What's wrong? 1354 1355=item How can I pull out lines between two patterns that are themselves on 1356different lines? 1357 1358=item I put a regular expression into $/ but it didn't work. What's wrong? 1359 1360=item How do I substitute case insensitively on the LHS while preserving 1361case on the RHS? 1362 1363=item How can I make C<\w> match national character sets? 1364 1365=item How can I match a locale-smart version of C</[a-zA-Z]/>? 1366 1367=item How can I quote a variable to use in a regex? 1368 1369=item What is C</o> really for? 1370 1371=item How do I use a regular expression to strip C style comments from a 1372file? 1373 1374=item Can I use Perl regular expressions to match balanced text? 1375 1376=item What does it mean that regexes are greedy? How can I get around it? 1377 1378=item How do I process each word on each line? 1379 1380=item How can I print out a word-frequency or line-frequency summary? 1381 1382=item How can I do approximate matching? 1383 1384=item How do I efficiently match many regular expressions at once? 1385 1386=item Why don't word-boundary searches with C<\b> work for me? 1387 1388=item Why does using $&, $`, or $' slow my program down? 1389 1390=item What good is C<\G> in a regular expression? 1391 1392=item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? 1393 1394=item What's wrong with using grep in a void context? 1395 1396=item How can I match strings with multibyte characters? 1397 1398=item How do I match a pattern that is supplied by the user? 1399 1400=back 1401 1402=item AUTHOR AND COPYRIGHT 1403 1404=back 1405 1406=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date: 14072003/07/24 02:17:21 $) 1408 1409=over 4 1410 1411=item DESCRIPTION 1412 1413=over 4 1414 1415=item Can I get a BNF/yacc/RE for the Perl language? 1416 1417=item What are all these $@%&* punctuation signs, and how do I know when to 1418use them? 1419 1420=item Do I always/never have to quote my strings or use semicolons and 1421commas? 1422 1423=item How do I skip some return values? 1424 1425=item How do I temporarily block warnings? 1426 1427=item What's an extension? 1428 1429=item Why do Perl operators have different precedence than C operators? 1430 1431=item How do I declare/create a structure? 1432 1433=item How do I create a module? 1434 1435=item How do I create a class? 1436 1437=item How can I tell if a variable is tainted? 1438 1439=item What's a closure? 1440 1441=item What is variable suicide and how can I prevent it? 1442 1443=item How can I pass/return a {Function, FileHandle, Array, Hash, Method, 1444Regex}? 1445 1446Passing Variables and Functions, Passing Filehandles, Passing Regexes, 1447Passing Methods 1448 1449=item How do I create a static variable? 1450 1451=item What's the difference between dynamic and lexical (static) scoping? 1452Between local() and my()? 1453 1454=item How can I access a dynamic variable while a similarly named lexical 1455is in scope? 1456 1457=item What's the difference between deep and shallow binding? 1458 1459=item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right? 1460 1461=item How do I redefine a builtin function, operator, or method? 1462 1463=item What's the difference between calling a function as &foo and foo()? 1464 1465=item How do I create a switch or case statement? 1466 1467=item How can I catch accesses to undefined variables, functions, or 1468methods? 1469 1470=item Why can't a method included in this same file be found? 1471 1472=item How can I find out my current package? 1473 1474=item How can I comment out a large block of perl code? 1475 1476=item How do I clear a package? 1477 1478=item How can I use a variable as a variable name? 1479 1480=item What does "bad interpreter" mean? 1481 1482=back 1483 1484=item AUTHOR AND COPYRIGHT 1485 1486=back 1487 1488=head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26 148917:44:04 $) 1490 1491=over 4 1492 1493=item DESCRIPTION 1494 1495=over 4 1496 1497=item How do I find out which operating system I'm running under? 1498 1499=item How come exec() doesn't return? 1500 1501=item How do I do fancy stuff with the keyboard/screen/mouse? 1502 1503Keyboard, Screen, Mouse 1504 1505=item How do I print something out in color? 1506 1507=item How do I read just one key without waiting for a return key? 1508 1509=item How do I check whether input is ready on the keyboard? 1510 1511=item How do I clear the screen? 1512 1513=item How do I get the screen size? 1514 1515=item How do I ask the user for a password? 1516 1517=item How do I read and write the serial port? 1518 1519lockfiles, open mode, end of line, flushing output, non-blocking input 1520 1521=item How do I decode encrypted password files? 1522 1523=item How do I start a process in the background? 1524 1525STDIN, STDOUT, and STDERR are shared, Signals, Zombies 1526 1527=item How do I trap control characters/signals? 1528 1529=item How do I modify the shadow password file on a Unix system? 1530 1531=item How do I set the time and date? 1532 1533=item How can I sleep() or alarm() for under a second? 1534 1535=item How can I measure time under a second? 1536 1537=item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) 1538 1539=item Why doesn't my sockets program work under System V (Solaris)? What 1540does the error message "Protocol not supported" mean? 1541 1542=item How can I call my system's unique C functions from Perl? 1543 1544=item Where do I get the include files to do ioctl() or syscall()? 1545 1546=item Why do setuid perl scripts complain about kernel problems? 1547 1548=item How can I open a pipe both to and from a command? 1549 1550=item Why can't I get the output of a command with system()? 1551 1552=item How can I capture STDERR from an external command? 1553 1554=item Why doesn't open() return an error when a pipe open fails? 1555 1556=item What's wrong with using backticks in a void context? 1557 1558=item How can I call backticks without shell processing? 1559 1560=item Why can't my script read from STDIN after I gave it EOF (^D on Unix, 1561^Z on MS-DOS)? 1562 1563=item How can I convert my shell script to perl? 1564 1565=item Can I use perl to run a telnet or ftp session? 1566 1567=item How can I write expect in Perl? 1568 1569=item Is there a way to hide perl's command line from programs such as 1570"ps"? 1571 1572=item I {changed directory, modified my environment} in a perl script. How 1573come the change disappeared when I exited the script? How do I get my 1574changes to be visible? 1575 1576Unix 1577 1578=item How do I close a process's filehandle without waiting for it to 1579complete? 1580 1581=item How do I fork a daemon process? 1582 1583=item How do I find out if I'm running interactively or not? 1584 1585=item How do I timeout a slow event? 1586 1587=item How do I set CPU limits? 1588 1589=item How do I avoid zombies on a Unix system? 1590 1591=item How do I use an SQL database? 1592 1593=item How do I make a system() exit on control-C? 1594 1595=item How do I open a file without blocking? 1596 1597=item How do I install a module from CPAN? 1598 1599=item What's the difference between require and use? 1600 1601=item How do I keep my own module/library directory? 1602 1603=item How do I add the directory my program lives in to the module/library 1604search path? 1605 1606=item How do I add a directory to my include path (@INC) at runtime? 1607 1608=item What is socket.ph and where do I get it? 1609 1610=back 1611 1612=item AUTHOR AND COPYRIGHT 1613 1614=back 1615 1616=head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57 1617$) 1618 1619=over 4 1620 1621=item DESCRIPTION 1622 1623=over 4 1624 1625=item What is the correct form of response from a CGI script? 1626 1627=item My CGI script runs from the command line but not the browser. (500 1628Server Error) 1629 1630=item How can I get better error messages from a CGI program? 1631 1632=item How do I remove HTML from a string? 1633 1634=item How do I extract URLs? 1635 1636=item How do I download a file from the user's machine? How do I open a 1637file on another machine? 1638 1639=item How do I make a pop-up menu in HTML? 1640 1641=item How do I fetch an HTML file? 1642 1643=item How do I automate an HTML form submission? 1644 1645=item How do I decode or create those %-encodings on the web? 1646 1647=item How do I redirect to another page? 1648 1649=item How do I put a password on my web pages? 1650 1651=item How do I edit my .htpasswd and .htgroup files with Perl? 1652 1653=item How do I make sure users can't enter values into a form that cause my 1654CGI script to do bad things? 1655 1656=item How do I parse a mail header? 1657 1658=item How do I decode a CGI form? 1659 1660=item How do I check a valid mail address? 1661 1662=item How do I decode a MIME/BASE64 string? 1663 1664=item How do I return the user's mail address? 1665 1666=item How do I send mail? 1667 1668=item How do I use MIME to make an attachment to a mail message? 1669 1670=item How do I read mail? 1671 1672=item How do I find out my hostname/domainname/IP address? 1673 1674=item How do I fetch a news article or the active newsgroups? 1675 1676=item How do I fetch/put an FTP file? 1677 1678=item How can I do RPC in Perl? 1679 1680=back 1681 1682=item AUTHOR AND COPYRIGHT 1683 1684=back 1685 1686=head2 perlsyn - Perl syntax 1687 1688=over 4 1689 1690=item DESCRIPTION 1691 1692=over 4 1693 1694=item Declarations 1695 1696=item Comments 1697 1698=item Simple Statements 1699 1700=item Truth and Falsehood 1701 1702=item Statement Modifiers 1703 1704=item Compound Statements 1705 1706=item Loop Control 1707 1708=item For Loops 1709 1710=item Foreach Loops 1711 1712=item Basic BLOCKs and Switch Statements 1713 1714=item Goto 1715 1716=item PODs: Embedded Documentation 1717 1718=item Plain Old Comments (Not!) 1719 1720=back 1721 1722=back 1723 1724=head2 perldata - Perl data types 1725 1726=over 4 1727 1728=item DESCRIPTION 1729 1730=over 4 1731 1732=item Variable names 1733 1734=item Context 1735 1736=item Scalar values 1737 1738=item Scalar value constructors 1739 1740=item List value constructors 1741 1742=item Subscripts 1743 1744=item Slices 1745 1746=item Typeglobs and Filehandles 1747 1748=back 1749 1750=item SEE ALSO 1751 1752=back 1753 1754=head2 perlop - Perl operators and precedence 1755 1756=over 4 1757 1758=item DESCRIPTION 1759 1760=over 4 1761 1762=item Operator Precedence and Associativity 1763 1764=item Terms and List Operators (Leftward) 1765 1766=item The Arrow Operator 1767 1768=item Auto-increment and Auto-decrement 1769 1770=item Exponentiation 1771 1772=item Symbolic Unary Operators 1773 1774=item Binding Operators 1775 1776=item Multiplicative Operators 1777 1778=item Additive Operators 1779 1780=item Shift Operators 1781 1782=item Named Unary Operators 1783 1784=item Relational Operators 1785 1786=item Equality Operators 1787 1788=item Bitwise And 1789 1790=item Bitwise Or and Exclusive Or 1791 1792=item C-style Logical And 1793 1794=item C-style Logical Or 1795 1796=item Range Operators 1797 1798=item Conditional Operator 1799 1800=item Assignment Operators 1801 1802=item Comma Operator 1803 1804=item List Operators (Rightward) 1805 1806=item Logical Not 1807 1808=item Logical And 1809 1810=item Logical or and Exclusive Or 1811 1812=item C Operators Missing From Perl 1813 1814unary &, unary *, (TYPE) 1815 1816=item Quote and Quote-like Operators 1817 1818=item Regexp Quote-Like Operators 1819 1820?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, 1821qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, 1822s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, 1823y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF 1824 1825=item Gory details of parsing quoted constructs 1826 1827Finding the end, Removal of backslashes before delimiters, Interpolation, 1828C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, 1829C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, 1830C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of 1831regular expressions 1832 1833=item I/O Operators 1834 1835=item Constant Folding 1836 1837=item Bitwise String Operators 1838 1839=item Integer Arithmetic 1840 1841=item Floating-point Arithmetic 1842 1843=item Bigger Numbers 1844 1845=back 1846 1847=back 1848 1849=head2 perlsub - Perl subroutines 1850 1851=over 4 1852 1853=item SYNOPSIS 1854 1855=item DESCRIPTION 1856 1857=over 4 1858 1859=item Private Variables via my() 1860 1861=item Persistent Private Variables 1862 1863=item Temporary Values via local() 1864 1865=item Lvalue subroutines 1866 1867Lvalue subroutines are EXPERIMENTAL 1868 1869=item Passing Symbol Table Entries (typeglobs) 1870 1871=item When to Still Use local() 1872 1873=item Pass by Reference 1874 1875=item Prototypes 1876 1877=item Constant Functions 1878 1879=item Overriding Built-in Functions 1880 1881=item Autoloading 1882 1883=item Subroutine Attributes 1884 1885=back 1886 1887=item SEE ALSO 1888 1889=back 1890 1891=head2 perlfunc - Perl builtin functions 1892 1893=over 4 1894 1895=item DESCRIPTION 1896 1897=over 4 1898 1899=item Perl Functions by Category 1900 1901Functions for SCALARs or strings, Regular expressions and pattern matching, 1902Numeric functions, Functions for real @ARRAYs, Functions for list data, 1903Functions for real %HASHes, Input and output functions, Functions for fixed 1904length data or records, Functions for filehandles, files, or directories, 1905Keywords related to the control flow of your perl program, Keywords related 1906to scoping, Miscellaneous functions, Functions for processes and process 1907groups, Keywords related to perl modules, Keywords related to classes and 1908object-orientedness, Low-level socket functions, System V interprocess 1909communication functions, Fetching user and group info, Fetching network 1910info, Time-related functions, Functions new in perl5, Functions obsoleted 1911in perl5 1912 1913=item Portability 1914 1915=item Alphabetical Listing of Perl Functions 1916 1917-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept 1918NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, 1919binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless 1920REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp( 1921LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER, 1922chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, 1923connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, 1924dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete 1925EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, 1926each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, 1927exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl 1928FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, 1929fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, 1930getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam 1931NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname 1932NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr 1933ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, 1934getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, 1935getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent 1936STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, 1937endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, 1938getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, 1939goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, 1940import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl 1941FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, 1942last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, 1943link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, 1944lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map 1945EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget 1946KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my 1947TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no 1948Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct 1949EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open 1950FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, 1951opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : 1952ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE, 1953package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, 1954print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, 1955printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, 1956qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, 1957rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read 1958FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, 1959readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, 1960ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, 1961require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir 1962DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, 1963rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir 1964DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, 1965semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send 1966SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority 1967WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, 1968shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, 1969shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep 1970EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair 1971SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, 1972sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, 1973splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split 1974/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format 1975parameter index, flags, vector flag, (minimum) width, precision, or maximum 1976width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat 1977FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME 1978(PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, 1979substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr 1980EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen 1981FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread 1982FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek 1983FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite 1984FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, 1985syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie 1986VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate 1987FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, 1988ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack 1989TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST, 1990use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST, 1991values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn 1992LIST, write FILEHANDLE, write EXPR, write, y/// 1993 1994=back 1995 1996=back 1997 1998=head2 perlopentut - tutorial on opening things in Perl 1999 2000=over 4 2001 2002=item DESCRIPTION 2003 2004=item Open E<agrave> la shell 2005 2006=over 4 2007 2008=item Simple Opens 2009 2010=item Indirect Filehandles 2011 2012=item Pipe Opens 2013 2014=item The Minus File 2015 2016=item Mixing Reads and Writes 2017 2018=item Filters 2019 2020=back 2021 2022=item Open E<agrave> la C 2023 2024=over 4 2025 2026=item Permissions E<agrave> la mode 2027 2028=back 2029 2030=item Obscure Open Tricks 2031 2032=over 4 2033 2034=item Re-Opening Files (dups) 2035 2036=item Dispelling the Dweomer 2037 2038=item Paths as Opens 2039 2040=item Single Argument Open 2041 2042=item Playing with STDIN and STDOUT 2043 2044=back 2045 2046=item Other I/O Issues 2047 2048=over 4 2049 2050=item Opening Non-File Files 2051 2052=item Opening Named Pipes 2053 2054=item Opening Sockets 2055 2056=item Binary Files 2057 2058=item File Locking 2059 2060=item IO Layers 2061 2062=back 2063 2064=item SEE ALSO 2065 2066=item AUTHOR and COPYRIGHT 2067 2068=item HISTORY 2069 2070=back 2071 2072=head2 perlpacktut - tutorial on C<pack> and C<unpack> 2073 2074=over 4 2075 2076=item DESCRIPTION 2077 2078=item The Basic Principle 2079 2080=item Packing Text 2081 2082=item Packing Numbers 2083 2084=over 4 2085 2086=item Integers 2087 2088=item Unpacking a Stack Frame 2089 2090=item How to Eat an Egg on a Net 2091 2092=item Floating point Numbers 2093 2094=back 2095 2096=item Exotic Templates 2097 2098=over 4 2099 2100=item Bit Strings 2101 2102=item Uuencoding 2103 2104=item Doing Sums 2105 2106=item Unicode 2107 2108=item Another Portable Binary Encoding 2109 2110=back 2111 2112=item Template Grouping 2113 2114=item Lengths and Widths 2115 2116=over 4 2117 2118=item String Lengths 2119 2120=item Dynamic Templates 2121 2122=item Counting Repetitions 2123 2124=back 2125 2126=item Packing and Unpacking C Structures 2127 2128=over 4 2129 2130=item The Alignment Pit 2131 2132=item Alignment, Take 2 2133 2134=item Alignment, Take 3 2135 2136=item Pointers for How to Use Them 2137 2138=back 2139 2140=item Pack Recipes 2141 2142=item Funnies Section 2143 2144=item Authors 2145 2146=back 2147 2148=head2 perlpod - the Plain Old Documentation format 2149 2150=over 4 2151 2152=item DESCRIPTION 2153 2154=over 4 2155 2156=item Ordinary Paragraph 2157 2158=item Verbatim Paragraph 2159 2160=item Command Paragraph 2161 2162C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading 2163Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item 2164I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end 2165I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding 2166I<encodingname>> 2167 2168=item Formatting Codes 2169 2170C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, 2171C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink, 2172C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used 2173for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces, 2174C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null 2175(zero-effect) formatting code 2176 2177=item The Intent 2178 2179=item Embedding Pods in Perl Modules 2180 2181=item Hints for Writing Pod 2182 2183=back 2184 2185=item SEE ALSO 2186 2187=item AUTHOR 2188 2189=back 2190 2191=head2 perlpodspec - Plain Old Documentation: format specification and 2192notes 2193 2194=over 4 2195 2196=item DESCRIPTION 2197 2198=item Pod Definitions 2199 2200=item Pod Commands 2201 2202"=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", 2203"=back", "=begin formatname", "=end formatname", "=for formatname text...", 2204"=encoding encodingname" 2205 2206=item Pod Formatting Codes 2207 2208C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, 2209C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for 2210filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a 2211null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, 2212C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text 2213contains non-breaking spaces 2214 2215=item Notes on Implementing Pod Processors 2216 2217=item About LE<lt>...E<gt> Codes 2218 2219First:, Second:, Third:, Fourth:, Fifth:, Sixth: 2220 2221=item About =over...=back Regions 2222 2223=item About Data Paragraphs and "=begin/=end" Regions 2224 2225=item SEE ALSO 2226 2227=item AUTHOR 2228 2229=back 2230 2231=head2 perlrun - how to execute the Perl interpreter 2232 2233=over 4 2234 2235=item SYNOPSIS 2236 2237=item DESCRIPTION 2238 2239=over 4 2240 2241=item #! and quoting on non-Unix systems 2242 2243OS/2, MS-DOS, Win95/NT, Macintosh, VMS 2244 2245=item Location of Perl 2246 2247=item Command Switches 2248 2249B<-0>[I<octal/hexadecimal>], B<-a>, B<-C [I<number/list>]>, B<-c>, B<-d>, 2250B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e> 2251I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>], 2252B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>, 2253B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, 2254B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, 2255B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, 2256B<-X>, B<-x> I<directory> 2257 2258=back 2259 2260=item ENVIRONMENT 2261 2262HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, 2263:perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, 2264PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS, 2265PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED, 2266PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS, 2267PERL_UNICODE, SYS$LOGIN (specific to the VMS port) 2268 2269=back 2270 2271=head2 perldiag - various Perl diagnostics 2272 2273=over 4 2274 2275=item DESCRIPTION 2276 2277=back 2278 2279=head2 perllexwarn - Perl Lexical Warnings 2280 2281=over 4 2282 2283=item DESCRIPTION 2284 2285=over 4 2286 2287=item Default Warnings and Optional Warnings 2288 2289=item What's wrong with B<-w> and C<$^W> 2290 2291=item Controlling Warnings from the Command Line 2292 2293B<-w>, B<-W>, B<-X> 2294 2295=item Backward Compatibility 2296 2297=item Category Hierarchy 2298 2299=item Fatal Warnings 2300 2301=item Reporting Warnings from a Module 2302 2303=back 2304 2305=item TODO 2306 2307=item SEE ALSO 2308 2309=item AUTHOR 2310 2311=back 2312 2313=head2 perldebug - Perl debugging 2314 2315=over 4 2316 2317=item DESCRIPTION 2318 2319=item The Perl Debugger 2320 2321=over 4 2322 2323=item Debugger Commands 2324 2325h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y 2326[level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l 2327min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, 2328?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b 2329subname [condition], b postpone subname [condition], b load filename, b 2330compile subname, B line, B *, a [line] command, A line, A *, w expr, W 2331expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ 2332command ], < *, << command, > ?, > command, > *, >> command, { ?, { [ 2333command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source 2334file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man 2335[manpage] 2336 2337=item Configurable Options 2338 2339C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, 2340C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, 2341C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>, 2342C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>, 2343C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, 2344C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, 2345C<NonStop> 2346 2347=item Debugger input/output 2348 2349Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame 2350listing 2351 2352=item Debugging compile-time statements 2353 2354=item Debugger Customization 2355 2356=item Readline Support 2357 2358=item Editor Support for Debugging 2359 2360=item The Perl Profiler 2361 2362=back 2363 2364=item Debugging regular expressions 2365 2366=item Debugging memory usage 2367 2368=item SEE ALSO 2369 2370=item BUGS 2371 2372=back 2373 2374=head2 perlvar - Perl predefined variables 2375 2376=over 4 2377 2378=item DESCRIPTION 2379 2380=over 4 2381 2382=item Predefined Names 2383 2384$ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', 2385$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $*, 2386HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, 2387IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, 2388HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, 2389IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, 2390IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, 2391$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#, 2392HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, 2393HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, 2394HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, 2395@-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as 2396C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, 2397$+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> 2398is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as 2399C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), 2400$FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, 2401IO::Handle->format_line_break_characters EXPR, 2402$FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, 2403$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, 2404$OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, 2405$PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, 2406$>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), 2407$PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, 2408$SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, 2409${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 24100x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, 2411$EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, 2412$PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, 2413ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, 2414$SIG{expr} 2415 2416=item Error Indicators 2417 2418=item Technical Note on the Syntax of Variable Names 2419 2420=back 2421 2422=item BUGS 2423 2424=back 2425 2426=head2 perlre - Perl regular expressions 2427 2428=over 4 2429 2430=item DESCRIPTION 2431 2432i, m, s, x 2433 2434=over 4 2435 2436=item Regular Expressions 2437 2438[1], [2], [3], cntrl, graph, print, punct, xdigit 2439 2440=item Extended Patterns 2441 2442C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, 2443C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ 2444code })>, C<(??{ code })>, C<< (?>pattern) >>, 2445C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> 2446 2447=item Backtracking 2448 2449=item Version 8 Regular Expressions 2450 2451=item Warning on \1 vs $1 2452 2453=item Repeated patterns matching zero-length substring 2454 2455=item Combining pieces together 2456 2457C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, 2458C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, 2459C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, 2460C<(?(condition)yes-pattern|no-pattern)> 2461 2462=item Creating custom RE engines 2463 2464=back 2465 2466=item BUGS 2467 2468=item SEE ALSO 2469 2470=back 2471 2472=head2 perlreref - Perl Regular Expressions Reference 2473 2474=over 4 2475 2476=item DESCRIPTION 2477 2478=over 4 2479 2480=item OPERATORS 2481 2482=item SYNTAX 2483 2484=item ESCAPE SEQUENCES 2485 2486=item CHARACTER CLASSES 2487 2488=item ANCHORS 2489 2490=item QUANTIFIERS 2491 2492=item EXTENDED CONSTRUCTS 2493 2494=item VARIABLES 2495 2496=item FUNCTIONS 2497 2498=item TERMINOLOGY 2499 2500=back 2501 2502=item AUTHOR 2503 2504=item SEE ALSO 2505 2506=item THANKS 2507 2508=back 2509 2510=head2 perlref - Perl references and nested data structures 2511 2512=over 4 2513 2514=item NOTE 2515 2516=item DESCRIPTION 2517 2518=over 4 2519 2520=item Making References 2521 2522=item Using References 2523 2524=item Symbolic references 2525 2526=item Not-so-symbolic references 2527 2528=item Pseudo-hashes: Using an array as a hash 2529 2530=item Function Templates 2531 2532=back 2533 2534=item WARNING 2535 2536=item SEE ALSO 2537 2538=back 2539 2540=head2 perlform - Perl formats 2541 2542=over 4 2543 2544=item DESCRIPTION 2545 2546=over 4 2547 2548=item Text Fields 2549 2550=item Numeric Fields 2551 2552=item The Field @* for Variable Width Multi-Line Text 2553 2554=item The Field ^* for Variable Width One-line-at-a-time Text 2555 2556=item Specifying Values 2557 2558=item Using Fill Mode 2559 2560=item Suppressing Lines Where All Fields Are Void 2561 2562=item Repeating Format Lines 2563 2564=item Top of Form Processing 2565 2566=item Format Variables 2567 2568=back 2569 2570=item NOTES 2571 2572=over 4 2573 2574=item Footers 2575 2576=item Accessing Formatting Internals 2577 2578=back 2579 2580=item WARNINGS 2581 2582=back 2583 2584=head2 perlobj - Perl objects 2585 2586=over 4 2587 2588=item DESCRIPTION 2589 2590=over 4 2591 2592=item An Object is Simply a Reference 2593 2594=item A Class is Simply a Package 2595 2596=item A Method is Simply a Subroutine 2597 2598=item Method Invocation 2599 2600=item Indirect Object Syntax 2601 2602=item Default UNIVERSAL methods 2603 2604isa(CLASS), can(METHOD), VERSION( [NEED] ) 2605 2606=item Destructors 2607 2608=item Summary 2609 2610=item Two-Phased Garbage Collection 2611 2612=back 2613 2614=item SEE ALSO 2615 2616=back 2617 2618=head2 perltie - how to hide an object class in a simple variable 2619 2620=over 4 2621 2622=item SYNOPSIS 2623 2624=item DESCRIPTION 2625 2626=over 4 2627 2628=item Tying Scalars 2629 2630TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, 2631DESTROY this 2632 2633=item Tying Arrays 2634 2635TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, 2636FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, 2637key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this, 2638UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY 2639this 2640 2641=item Tying Hashes 2642 2643USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE 2644this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY 2645this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this 2646 2647=item Tying FileHandles 2648 2649TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, 2650LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, 2651DESTROY this 2652 2653=item UNTIE this 2654 2655=item The C<untie> Gotcha 2656 2657=back 2658 2659=item SEE ALSO 2660 2661=item BUGS 2662 2663=item AUTHOR 2664 2665=back 2666 2667=head2 perldbmfilter - Perl DBM Filters 2668 2669=over 4 2670 2671=item SYNOPSIS 2672 2673=item DESCRIPTION 2674 2675B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, 2676B<filter_fetch_value> 2677 2678=over 4 2679 2680=item The Filter 2681 2682=item An Example -- the NULL termination problem. 2683 2684=item Another Example -- Key is a C int. 2685 2686=back 2687 2688=item SEE ALSO 2689 2690=item AUTHOR 2691 2692=back 2693 2694=head2 perlipc - Perl interprocess communication (signals, fifos, pipes, 2695safe subprocesses, sockets, and semaphores) 2696 2697=over 4 2698 2699=item DESCRIPTION 2700 2701=item Signals 2702 2703=over 4 2704 2705=item Handling the SIGHUP Signal in Daemons 2706 2707=back 2708 2709=item Named Pipes 2710 2711=over 4 2712 2713=item Deferred Signals (Safe Signals) 2714 2715Long running opcodes, Interrupting IO, Restartable system calls, Signals as 2716"faults", Signals triggered by operating system state 2717 2718=back 2719 2720=item Using open() for IPC 2721 2722=over 4 2723 2724=item Filehandles 2725 2726=item Background Processes 2727 2728=item Complete Dissociation of Child from Parent 2729 2730=item Safe Pipe Opens 2731 2732=item Bidirectional Communication with Another Process 2733 2734=item Bidirectional Communication with Yourself 2735 2736=back 2737 2738=item Sockets: Client/Server Communication 2739 2740=over 4 2741 2742=item Internet Line Terminators 2743 2744=item Internet TCP Clients and Servers 2745 2746=item Unix-Domain TCP Clients and Servers 2747 2748=back 2749 2750=item TCP Clients with IO::Socket 2751 2752=over 4 2753 2754=item A Simple Client 2755 2756C<Proto>, C<PeerAddr>, C<PeerPort> 2757 2758=item A Webget Client 2759 2760=item Interactive Client with IO::Socket 2761 2762=back 2763 2764=item TCP Servers with IO::Socket 2765 2766Proto, LocalPort, Listen, Reuse 2767 2768=item UDP: Message Passing 2769 2770=item SysV IPC 2771 2772=item NOTES 2773 2774=item BUGS 2775 2776=item AUTHOR 2777 2778=item SEE ALSO 2779 2780=back 2781 2782=head2 perlfork - Perl's fork() emulation 2783 2784=over 4 2785 2786=item SYNOPSIS 2787 2788=item DESCRIPTION 2789 2790=over 4 2791 2792=item Behavior of other Perl features in forked pseudo-processes 2793 2794$$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept 2795filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to 2796files, directories and network sockets 2797 2798=item Resource limits 2799 2800=item Killing the parent process 2801 2802=item Lifetime of the parent process and pseudo-processes 2803 2804=item CAVEATS AND LIMITATIONS 2805 2806BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, 2807Global state maintained by XSUBs, Interpreter embedded in larger 2808application, Thread-safety of extensions 2809 2810=back 2811 2812=item BUGS 2813 2814=item AUTHOR 2815 2816=item SEE ALSO 2817 2818=back 2819 2820=head2 perlnumber - semantics of numbers and numeric operations in Perl 2821 2822=over 4 2823 2824=item SYNOPSIS 2825 2826=item DESCRIPTION 2827 2828=item Storing numbers 2829 2830=item Numeric operators and numeric conversions 2831 2832=item Flavors of Perl numeric operations 2833 2834Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other 2835mathematical operators, Bitwise operators, Bitwise operators during C<use 2836integer>, Operators which expect an integer, Operators which expect a 2837string 2838 2839=item AUTHOR 2840 2841=item SEE ALSO 2842 2843=back 2844 2845=head2 perlthrtut - tutorial on threads in Perl 2846 2847=over 4 2848 2849=item DESCRIPTION 2850 2851=item Status 2852 2853=item What Is A Thread Anyway? 2854 2855=item Threaded Program Models 2856 2857=over 4 2858 2859=item Boss/Worker 2860 2861=item Work Crew 2862 2863=item Pipeline 2864 2865=back 2866 2867=item What kind of threads are Perl threads? 2868 2869=item Thread-Safe Modules 2870 2871=item Thread Basics 2872 2873=over 4 2874 2875=item Basic Thread Support 2876 2877=item A Note about the Examples 2878 2879=item Creating Threads 2880 2881=item Waiting For A Thread To Exit 2882 2883=item Ignoring A Thread 2884 2885=back 2886 2887=item Threads And Data 2888 2889=over 4 2890 2891=item Shared And Unshared Data 2892 2893=item Thread Pitfalls: Races 2894 2895=back 2896 2897=item Synchronization and control 2898 2899=over 4 2900 2901=item Controlling access: lock() 2902 2903=item A Thread Pitfall: Deadlocks 2904 2905=item Queues: Passing Data Around 2906 2907=item Semaphores: Synchronizing Data Access 2908 2909=item Basic semaphores 2910 2911=item Advanced Semaphores 2912 2913=item cond_wait() and cond_signal() 2914 2915=item Giving up control 2916 2917=back 2918 2919=item General Thread Utility Routines 2920 2921=over 4 2922 2923=item What Thread Am I In? 2924 2925=item Thread IDs 2926 2927=item Are These Threads The Same? 2928 2929=item What Threads Are Running? 2930 2931=back 2932 2933=item A Complete Example 2934 2935=item Different implementations of threads 2936 2937=item Performance considerations 2938 2939=item Process-scope Changes 2940 2941=item Thread-Safety of System Libraries 2942 2943=item Conclusion 2944 2945=item Bibliography 2946 2947=over 4 2948 2949=item Introductory Texts 2950 2951=item OS-Related References 2952 2953=item Other References 2954 2955=back 2956 2957=item Acknowledgements 2958 2959=item AUTHOR 2960 2961=item Copyrights 2962 2963=back 2964 2965=head2 perlothrtut - old tutorial on threads in Perl 2966 2967=over 4 2968 2969=item DESCRIPTION 2970 2971=item What Is A Thread Anyway? 2972 2973=item Threaded Program Models 2974 2975=over 4 2976 2977=item Boss/Worker 2978 2979=item Work Crew 2980 2981=item Pipeline 2982 2983=back 2984 2985=item Native threads 2986 2987=item What kind of threads are perl threads? 2988 2989=item Threadsafe Modules 2990 2991=item Thread Basics 2992 2993=over 4 2994 2995=item Basic Thread Support 2996 2997=item Creating Threads 2998 2999=item Giving up control 3000 3001=item Waiting For A Thread To Exit 3002 3003=item Errors In Threads 3004 3005=item Ignoring A Thread 3006 3007=back 3008 3009=item Threads And Data 3010 3011=over 4 3012 3013=item Shared And Unshared Data 3014 3015=item Thread Pitfall: Races 3016 3017=item Controlling access: lock() 3018 3019=item Thread Pitfall: Deadlocks 3020 3021=item Queues: Passing Data Around 3022 3023=back 3024 3025=item Threads And Code 3026 3027=over 4 3028 3029=item Semaphores: Synchronizing Data Access 3030 3031Basic semaphores, Advanced Semaphores 3032 3033=item Attributes: Restricting Access To Subroutines 3034 3035=item Subroutine Locks 3036 3037=item Methods 3038 3039=item Locking A Subroutine 3040 3041=back 3042 3043=item General Thread Utility Routines 3044 3045=over 4 3046 3047=item What Thread Am I In? 3048 3049=item Thread IDs 3050 3051=item Are These Threads The Same? 3052 3053=item What Threads Are Running? 3054 3055=back 3056 3057=item A Complete Example 3058 3059=item Conclusion 3060 3061=item Bibliography 3062 3063=over 4 3064 3065=item Introductory Texts 3066 3067=item OS-Related References 3068 3069=item Other References 3070 3071=back 3072 3073=item Acknowledgements 3074 3075=item AUTHOR 3076 3077=item Copyrights 3078 3079=back 3080 3081=head2 perlport - Writing portable Perl 3082 3083=over 4 3084 3085=item DESCRIPTION 3086 3087Not all Perl programs have to be portable, Nearly all of Perl already I<is> 3088portable 3089 3090=item ISSUES 3091 3092=over 4 3093 3094=item Newlines 3095 3096=item Numbers endianness and Width 3097 3098=item Files and Filesystems 3099 3100=item System Interaction 3101 3102=item Command names versus file pathnames 3103 3104=item Networking 3105 3106=item Interprocess Communication (IPC) 3107 3108=item External Subroutines (XS) 3109 3110=item Standard Modules 3111 3112=item Time and Date 3113 3114=item Character sets and character encoding 3115 3116=item Internationalisation 3117 3118=item System Resources 3119 3120=item Security 3121 3122=item Style 3123 3124=back 3125 3126=item CPAN Testers 3127 3128Mailing list: cpan-testers@perl.org, Testing results: 3129http://testers.cpan.org/ 3130 3131=item PLATFORMS 3132 3133=over 4 3134 3135=item Unix 3136 3137=item DOS and Derivatives 3138 3139=item S<Mac OS> 3140 3141=item VMS 3142 3143=item VOS 3144 3145=item EBCDIC Platforms 3146 3147=item Acorn RISC OS 3148 3149=item Other perls 3150 3151=back 3152 3153=item FUNCTION IMPLEMENTATIONS 3154 3155=over 4 3156 3157=item Alphabetical Listing of Perl Functions 3158 3159-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown 3160LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen 3161HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl 3162FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin, 3163getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, 3164getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, 3165getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, 3166gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent 3167STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, 3168endpwent, endgrent, endhostent, endnetent, endprotoent, endservent, 3169getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl 3170FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat 3171FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd 3172ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open 3173FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select 3174RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget 3175KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, 3176setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt 3177SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, 3178shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, 3179socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat 3180EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen 3181FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate 3182FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, 3183wait, waitpid PID,FLAGS 3184 3185=back 3186 3187=item CHANGES 3188 3189v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, 3190v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 3191May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February 31921999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September 31931998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, 3194v1.30, 03 August 1998, v1.23, 10 July 1998 3195 3196=item Supported Platforms 3197 3198=item SEE ALSO 3199 3200=item AUTHORS / CONTRIBUTORS 3201 3202=back 3203 3204=head2 perllocale - Perl locale handling (internationalization and 3205localization) 3206 3207=over 4 3208 3209=item DESCRIPTION 3210 3211=item PREPARING TO USE LOCALES 3212 3213=item USING LOCALES 3214 3215=over 4 3216 3217=item The use locale pragma 3218 3219=item The setlocale function 3220 3221=item Finding locales 3222 3223=item LOCALE PROBLEMS 3224 3225=item Temporarily fixing locale problems 3226 3227=item Permanently fixing locale problems 3228 3229=item Permanently fixing your system's locale configuration 3230 3231=item Fixing system locale configuration 3232 3233=item The localeconv function 3234 3235=item I18N::Langinfo 3236 3237=back 3238 3239=item LOCALE CATEGORIES 3240 3241=over 4 3242 3243=item Category LC_COLLATE: Collation 3244 3245=item Category LC_CTYPE: Character Types 3246 3247=item Category LC_NUMERIC: Numeric Formatting 3248 3249=item Category LC_MONETARY: Formatting of monetary amounts 3250 3251=item LC_TIME 3252 3253=item Other categories 3254 3255=back 3256 3257=item SECURITY 3258 3259=item ENVIRONMENT 3260 3261PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, 3262LC_NUMERIC, LC_TIME, LANG 3263 3264=item NOTES 3265 3266=over 4 3267 3268=item Backward compatibility 3269 3270=item I18N:Collate obsolete 3271 3272=item Sort speed and memory use impacts 3273 3274=item write() and LC_NUMERIC 3275 3276=item Freely available locale definitions 3277 3278=item I18n and l10n 3279 3280=item An imperfect standard 3281 3282=back 3283 3284=item Unicode and UTF-8 3285 3286=item BUGS 3287 3288=over 4 3289 3290=item Broken systems 3291 3292=back 3293 3294=item SEE ALSO 3295 3296=item HISTORY 3297 3298=back 3299 3300=head2 perluniintro - Perl Unicode introduction 3301 3302=over 4 3303 3304=item DESCRIPTION 3305 3306=over 4 3307 3308=item Unicode 3309 3310=item Perl's Unicode Support 3311 3312=item Perl's Unicode Model 3313 3314=item Unicode and EBCDIC 3315 3316=item Creating Unicode 3317 3318=item Handling Unicode 3319 3320=item Legacy Encodings 3321 3322=item Unicode I/O 3323 3324=item Displaying Unicode As Text 3325 3326=item Special Cases 3327 3328=item Advanced Topics 3329 3330=item Miscellaneous 3331 3332=item Questions With Answers 3333 3334=item Hexadecimal Notation 3335 3336=item Further Resources 3337 3338=back 3339 3340=item UNICODE IN OLDER PERLS 3341 3342=item SEE ALSO 3343 3344=item ACKNOWLEDGMENTS 3345 3346=item AUTHOR, COPYRIGHT, AND LICENSE 3347 3348=back 3349 3350=head2 perlunicode - Unicode support in Perl 3351 3352=over 4 3353 3354=item DESCRIPTION 3355 3356=over 4 3357 3358=item Important Caveats 3359 3360Input and Output Layers, Regular Expressions, C<use utf8> still needed to 3361enable UTF-8/UTF-EBCDIC in scripts, C<use encoding> needed to upgrade 3362non-Latin-1 byte strings 3363 3364=item Byte and Character Semantics 3365 3366=item Effects of Character Semantics 3367 3368=item Scripts 3369 3370=item Blocks 3371 3372=item User-Defined Character Properties 3373 3374=item Character Encodings for Input and Output 3375 3376=item Unicode Regular Expression Support Level 3377 3378=item Unicode Encodings 3379 3380=item Security Implications of Unicode 3381 3382=item Unicode in Perl on EBCDIC 3383 3384=item Locales 3385 3386=item When Unicode Does Not Happen 3387 3388=item Forcing Unicode in Perl (Or Unforcing Unicode in Perl) 3389 3390=item Using Unicode in XS 3391 3392=back 3393 3394=item BUGS 3395 3396=over 4 3397 3398=item Interaction with Locales 3399 3400=item Interaction with Extensions 3401 3402=item Speed 3403 3404=item Porting code from perl-5.6.X 3405 3406=back 3407 3408=item SEE ALSO 3409 3410=back 3411 3412=head2 perlebcdic - Considerations for running Perl on EBCDIC platforms 3413 3414=over 4 3415 3416=item DESCRIPTION 3417 3418=item COMMON CHARACTER CODE SETS 3419 3420=over 4 3421 3422=item ASCII 3423 3424=item ISO 8859 3425 3426=item Latin 1 (ISO 8859-1) 3427 3428=item EBCDIC 3429 3430=item 13 variant characters 3431 3432=item 0037 3433 3434=item 1047 3435 3436=item POSIX-BC 3437 3438=item Unicode code points versus EBCDIC code points 3439 3440=item Remaining Perl Unicode problems in EBCDIC 3441 3442=item Unicode and UTF 3443 3444=item Using Encode 3445 3446=back 3447 3448=item SINGLE OCTET TABLES 3449 3450recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 3451 3452=item IDENTIFYING CHARACTER CODE SETS 3453 3454=item CONVERSIONS 3455 3456=over 4 3457 3458=item tr/// 3459 3460=item iconv 3461 3462=item C RTL 3463 3464=back 3465 3466=item OPERATOR DIFFERENCES 3467 3468=item FUNCTION DIFFERENCES 3469 3470chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() 3471 3472=item REGULAR EXPRESSION DIFFERENCES 3473 3474=item SOCKETS 3475 3476=item SORTING 3477 3478=over 4 3479 3480=item Ignore ASCII vs. EBCDIC sort differences. 3481 3482=item MONO CASE then sort data. 3483 3484=item Convert, sort data, then re convert. 3485 3486=item Perform sorting on one type of machine only. 3487 3488=back 3489 3490=item TRANSFORMATION FORMATS 3491 3492=over 4 3493 3494=item URL decoding and encoding 3495 3496=item uu encoding and decoding 3497 3498=item Quoted-Printable encoding and decoding 3499 3500=item Caesarian ciphers 3501 3502=back 3503 3504=item Hashing order and checksums 3505 3506=item I18N AND L10N 3507 3508=item MULTI OCTET CHARACTER SETS 3509 3510=item OS ISSUES 3511 3512=over 4 3513 3514=item OS/400 3515 3516PASE, IFS access 3517 3518=item OS/390, z/OS 3519 3520chcp, dataset access, OS/390, z/OS iconv, locales 3521 3522=item VM/ESA? 3523 3524=item POSIX-BC? 3525 3526=back 3527 3528=item BUGS 3529 3530=item SEE ALSO 3531 3532=item REFERENCES 3533 3534=item HISTORY 3535 3536=item AUTHOR 3537 3538=back 3539 3540=head2 perlsec - Perl security 3541 3542=over 4 3543 3544=item DESCRIPTION 3545 3546=over 4 3547 3548=item Laundering and Detecting Tainted Data 3549 3550=item Switches On the "#!" Line 3551 3552=item Taint mode and @INC 3553 3554=item Cleaning Up Your Path 3555 3556=item Security Bugs 3557 3558=item Protecting Your Programs 3559 3560=item Unicode 3561 3562=item Algorithmic Complexity Attacks 3563 3564=back 3565 3566=item SEE ALSO 3567 3568=back 3569 3570=head2 perlmod - Perl modules (packages and symbol tables) 3571 3572=over 4 3573 3574=item DESCRIPTION 3575 3576=over 4 3577 3578=item Packages 3579 3580=item Symbol Tables 3581 3582=item BEGIN, CHECK, INIT and END 3583 3584=item Perl Classes 3585 3586=item Perl Modules 3587 3588=item Making your module threadsafe 3589 3590=back 3591 3592=item SEE ALSO 3593 3594=back 3595 3596=head2 perlmodlib - constructing new Perl modules and finding existing ones 3597 3598=over 4 3599 3600=item THE PERL MODULE LIBRARY 3601 3602=over 4 3603 3604=item Pragmatic Modules 3605 3606attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes, 3607charnames, constant, diagnostics, encoding, fields, filetest, if, integer, 3608less, lib, locale, open, ops, overload, re, sigtrap, sort, strict, subs, 3609threads, threads::shared, utf8, vars, vmsish, warnings, warnings::register 3610 3611=item Standard Modules 3612 3613AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, 3614B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, 3615B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, 3616B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, 3617CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, 3618CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, 3619Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, 3620Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, 3621Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, 3622Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ, 3623Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding, 3624Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, 3625Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO, 3626Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode, 3627Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy, 3628ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, 3629ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, 3630ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, 3631ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, 3632ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, 3633ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, 3634ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial, 3635ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish, 3636ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, 3637ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, 3638File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find, 3639File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, 3640File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, 3641File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, 3642FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File, 3643Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags, 3644I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle, 3645IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, 3646IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, 3647IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, 3648Locale::Currency, Locale::Language, Locale::Maketext, 3649Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, 3650MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, 3651Math::BigInt::Calc, Math::BigRat, Math::Complex, Math::Trig, Memoize, 3652Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, 3653Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File, 3654Memoize::Storable, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain, 3655Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP, 3656Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent, 3657Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding, 3658PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker, 3659Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, 3660Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, 3661Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, 3662Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, 3663Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, 3664Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, 3665Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, 3666Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, 3667Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap, 3668Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness, 3669Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps, 3670Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced, 3671Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread, 3672Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific, 3673Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, 3674Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, 3675Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, 3676Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap, 3677XSLoader 3678 3679=item Extension Modules 3680 3681=back 3682 3683=item CPAN 3684 3685=over 4 3686 3687=item Africa 3688 3689South Africa 3690 3691=item Asia 3692 3693China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi 3694Arabia, Singapore, South Korea, Taiwan, Thailand 3695 3696=item Central America 3697 3698Costa Rica 3699 3700=item Europe 3701 3702Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech 3703Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, 3704Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland, 3705Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland, 3706Turkey, Ukraine, United Kingdom 3707 3708=item North America 3709 3710Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, 3711Alabama, California, Colorado, Delaware, District of Columbia, Florida, 3712Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York, 3713North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah, 3714Virginia, Washington, Wisconsin 3715 3716=item Oceania 3717 3718Australia, New Zealand, United States 3719 3720=item South America 3721 3722Argentina, Brazil, Chile 3723 3724=item RSYNC Mirrors 3725 3726=back 3727 3728=item Modules: Creation, Use, and Abuse 3729 3730=over 4 3731 3732=item Guidelines for Module Creation 3733 3734=item Guidelines for Converting Perl 4 Library Scripts into Modules 3735 3736=item Guidelines for Reusing Application Code 3737 3738=back 3739 3740=item NOTE 3741 3742=back 3743 3744=head2 perlmodstyle - Perl module style guide 3745 3746=over 4 3747 3748=item INTRODUCTION 3749 3750=item QUICK CHECKLIST 3751 3752=over 4 3753 3754=item Before you start 3755 3756=item The API 3757 3758=item Stability 3759 3760=item Documentation 3761 3762=item Release considerations 3763 3764=back 3765 3766=item BEFORE YOU START WRITING A MODULE 3767 3768=over 4 3769 3770=item Has it been done before? 3771 3772=item Do one thing and do it well 3773 3774=item What's in a name? 3775 3776=back 3777 3778=item DESIGNING AND WRITING YOUR MODULE 3779 3780=over 4 3781 3782=item To OO or not to OO? 3783 3784=item Designing your API 3785 3786Write simple routines to do simple things, Separate functionality from 3787output, Provide sensible shortcuts and defaults, Naming conventions, 3788Parameter passing 3789 3790=item Strictness and warnings 3791 3792=item Backwards compatibility 3793 3794=item Error handling and messages 3795 3796=back 3797 3798=item DOCUMENTING YOUR MODULE 3799 3800=over 4 3801 3802=item POD 3803 3804=item README, INSTALL, release notes, changelogs 3805 3806perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build, 3807perl Build test, perl Build install 3808 3809=back 3810 3811=item RELEASE CONSIDERATIONS 3812 3813=over 4 3814 3815=item Version numbering 3816 3817=item Pre-requisites 3818 3819=item Testing 3820 3821=item Packaging 3822 3823=item Licensing 3824 3825=back 3826 3827=item COMMON PITFALLS 3828 3829=over 4 3830 3831=item Reinventing the wheel 3832 3833=item Trying to do too much 3834 3835=item Inappropriate documentation 3836 3837=back 3838 3839=item SEE ALSO 3840 3841L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools, 3842Testing tools, http://pause.perl.org/, Any good book on software 3843engineering 3844 3845=item AUTHOR 3846 3847=back 3848 3849=head2 perlmodinstall - Installing CPAN Modules 3850 3851=over 4 3852 3853=item DESCRIPTION 3854 3855=over 4 3856 3857=item PREAMBLE 3858 3859B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the 3860module (sometimes unnecessary), B<INSTALL> the module 3861 3862=back 3863 3864=item PORTABILITY 3865 3866=item HEY 3867 3868=item AUTHOR 3869 3870=item COPYRIGHT 3871 3872=back 3873 3874=head2 perlnewmod - preparing a new module for distribution 3875 3876=over 4 3877 3878=item DESCRIPTION 3879 3880=over 4 3881 3882=item Warning 3883 3884=item What should I make into a module? 3885 3886=item Step-by-step: Preparing the ground 3887 3888Look around, Check it's new, Discuss the need, Choose a name, Check again 3889 3890=item Step-by-step: Making the module 3891 3892Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use 3893L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old 3894documentation|perlpod>, Write tests, Write the README 3895 3896=item Step-by-step: Distributing your module 3897 3898Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the 3899tarball, Announce to the modules list, Announce to clpa, Fix bugs! 3900 3901=back 3902 3903=item AUTHOR 3904 3905=item SEE ALSO 3906 3907=back 3908 3909=head2 perlutil - utilities packaged with the Perl distribution 3910 3911=over 4 3912 3913=item DESCRIPTION 3914 3915=over 4 3916 3917=item DOCUMENTATION 3918 3919L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, 3920L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, 3921L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, 3922L<roffitall|roffitall> 3923 3924=item CONVERTORS 3925 3926L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> 3927 3928=item Administration 3929 3930L<libnetcfg|libnetcfg> 3931 3932=item Development 3933 3934L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, 3935L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> 3936 3937=item SEE ALSO 3938 3939=back 3940 3941=back 3942 3943=head2 perlcompile - Introduction to the Perl Compiler-Translator 3944 3945=over 4 3946 3947=item DESCRIPTION 3948 3949=over 4 3950 3951=item Layout 3952 3953B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref 3954 3955=back 3956 3957=item Using The Back Ends 3958 3959=over 4 3960 3961=item The Cross Referencing Back End 3962 3963i, &, s, r 3964 3965=item The Decompiling Back End 3966 3967=item The Lint Back End 3968 3969=item The Simple C Back End 3970 3971=item The Bytecode Back End 3972 3973=item The Optimized C Back End 3974 3975=back 3976 3977=item Module List for the Compiler Suite 3978 3979B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, 3980B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, 3981B::Stackobj, B::Stash, B::Terse, B::Xref 3982 3983=item KNOWN PROBLEMS 3984 3985=item AUTHOR 3986 3987=back 3988 3989=head2 perlfilter - Source Filters 3990 3991=over 4 3992 3993=item DESCRIPTION 3994 3995=item CONCEPTS 3996 3997=item USING FILTERS 3998 3999=item WRITING A SOURCE FILTER 4000 4001=item WRITING A SOURCE FILTER IN C 4002 4003B<Decryption Filters> 4004 4005=item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE 4006 4007=item WRITING A SOURCE FILTER IN PERL 4008 4009=item USING CONTEXT: THE DEBUG FILTER 4010 4011=item CONCLUSION 4012 4013=item THINGS TO LOOK OUT FOR 4014 4015Some Filters Clobber the C<DATA> Handle 4016 4017=item REQUIREMENTS 4018 4019=item AUTHOR 4020 4021=item Copyrights 4022 4023=back 4024 4025=head2 perlembed - how to embed perl in your C program 4026 4027=over 4 4028 4029=item DESCRIPTION 4030 4031=over 4 4032 4033=item PREAMBLE 4034 4035B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from 4036Perl?>, B<Use C from C?>, B<Use Perl from C?> 4037 4038=item ROADMAP 4039 4040=item Compiling your C program 4041 4042=item Adding a Perl interpreter to your C program 4043 4044=item Calling a Perl subroutine from your C program 4045 4046=item Evaluating a Perl statement from your C program 4047 4048=item Performing Perl pattern matches and substitutions from your C program 4049 4050=item Fiddling with the Perl stack from your C program 4051 4052=item Maintaining a persistent interpreter 4053 4054=item Execution of END blocks 4055 4056=item Maintaining multiple interpreter instances 4057 4058=item Using Perl modules, which themselves use C libraries, from your C 4059program 4060 4061=back 4062 4063=item Embedding Perl under Win32 4064 4065=item Hiding Perl_ 4066 4067=item MORAL 4068 4069=item AUTHOR 4070 4071=item COPYRIGHT 4072 4073=back 4074 4075=head2 perldebguts - Guts of Perl debugging 4076 4077=over 4 4078 4079=item DESCRIPTION 4080 4081=item Debugger Internals 4082 4083=over 4 4084 4085=item Writing Your Own Debugger 4086 4087=back 4088 4089=item Frame Listing Output Examples 4090 4091=item Debugging regular expressions 4092 4093=over 4 4094 4095=item Compile-time output 4096 4097C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> 4098I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> 4099I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, 4100C<anchored(TYPE)> 4101 4102=item Types of nodes 4103 4104=item Run-time output 4105 4106=back 4107 4108=item Debugging Perl memory usage 4109 4110=over 4 4111 4112=item Using C<$ENV{PERL_DEBUG_MSTATS}> 4113 4114C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): 4115SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: 41166144> 4117 4118=item Example of using B<-DL> switch 4119 4120C<717>, C<002>, C<054>, C<602>, C<702>, C<704> 4121 4122=item B<-DL> details 4123 4124C<!!!>, C<!!>, C<!> 4125 4126=item Limitations of B<-DL> statistics 4127 4128=back 4129 4130=item SEE ALSO 4131 4132=back 4133 4134=head2 perlxstut, perlXStut - Tutorial for writing XSUBs 4135 4136=over 4 4137 4138=item DESCRIPTION 4139 4140=item SPECIAL NOTES 4141 4142=over 4 4143 4144=item make 4145 4146=item Version caveat 4147 4148=item Dynamic Loading versus Static Loading 4149 4150=back 4151 4152=item TUTORIAL 4153 4154=over 4 4155 4156=item EXAMPLE 1 4157 4158=item EXAMPLE 2 4159 4160=item What has gone on? 4161 4162=item Writing good test scripts 4163 4164=item EXAMPLE 3 4165 4166=item What's new here? 4167 4168=item Input and Output Parameters 4169 4170=item The XSUBPP Program 4171 4172=item The TYPEMAP file 4173 4174=item Warning about Output Arguments 4175 4176=item EXAMPLE 4 4177 4178=item What has happened here? 4179 4180=item Anatomy of .xs file 4181 4182=item Getting the fat out of XSUBs 4183 4184=item More about XSUB arguments 4185 4186=item The Argument Stack 4187 4188=item Extending your Extension 4189 4190=item Documenting your Extension 4191 4192=item Installing your Extension 4193 4194=item EXAMPLE 5 4195 4196=item New Things in this Example 4197 4198=item EXAMPLE 6 4199 4200=item New Things in this Example 4201 4202=item EXAMPLE 7 (Coming Soon) 4203 4204=item EXAMPLE 8 (Coming Soon) 4205 4206=item EXAMPLE 9 Passing open files to XSes 4207 4208=item Troubleshooting these Examples 4209 4210=back 4211 4212=item See also 4213 4214=item Author 4215 4216=over 4 4217 4218=item Last Changed 4219 4220=back 4221 4222=back 4223 4224=head2 perlxs - XS language reference manual 4225 4226=over 4 4227 4228=item DESCRIPTION 4229 4230=over 4 4231 4232=item Introduction 4233 4234=item On The Road 4235 4236=item The Anatomy of an XSUB 4237 4238=item The Argument Stack 4239 4240=item The RETVAL Variable 4241 4242=item Returning SVs, AVs and HVs through RETVAL 4243 4244=item The MODULE Keyword 4245 4246=item The PACKAGE Keyword 4247 4248=item The PREFIX Keyword 4249 4250=item The OUTPUT: Keyword 4251 4252=item The NO_OUTPUT Keyword 4253 4254=item The CODE: Keyword 4255 4256=item The INIT: Keyword 4257 4258=item The NO_INIT Keyword 4259 4260=item Initializing Function Parameters 4261 4262=item Default Parameter Values 4263 4264=item The PREINIT: Keyword 4265 4266=item The SCOPE: Keyword 4267 4268=item The INPUT: Keyword 4269 4270=item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords 4271 4272=item The C<length(NAME)> Keyword 4273 4274=item Variable-length Parameter Lists 4275 4276=item The C_ARGS: Keyword 4277 4278=item The PPCODE: Keyword 4279 4280=item Returning Undef And Empty Lists 4281 4282=item The REQUIRE: Keyword 4283 4284=item The CLEANUP: Keyword 4285 4286=item The POSTCALL: Keyword 4287 4288=item The BOOT: Keyword 4289 4290=item The VERSIONCHECK: Keyword 4291 4292=item The PROTOTYPES: Keyword 4293 4294=item The PROTOTYPE: Keyword 4295 4296=item The ALIAS: Keyword 4297 4298=item The OVERLOAD: Keyword 4299 4300=item The FALLBACK: Keyword 4301 4302=item The INTERFACE: Keyword 4303 4304=item The INTERFACE_MACRO: Keyword 4305 4306=item The INCLUDE: Keyword 4307 4308=item The CASE: Keyword 4309 4310=item The & Unary Operator 4311 4312=item Inserting POD, Comments and C Preprocessor Directives 4313 4314=item Using XS With C++ 4315 4316=item Interface Strategy 4317 4318=item Perl Objects And C Structures 4319 4320=item The Typemap 4321 4322=item Safely Storing Static Data in XS 4323 4324MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT 4325 4326=back 4327 4328=item EXAMPLES 4329 4330=item XS VERSION 4331 4332=item AUTHOR 4333 4334=back 4335 4336=head2 perlclib - Internal replacements for standard C library functions 4337 4338=over 4 4339 4340=item DESCRIPTION 4341 4342=over 4 4343 4344=item Conventions 4345 4346C<t>, C<p>, C<n>, C<s> 4347 4348=item File Operations 4349 4350=item File Input and Output 4351 4352=item File Positioning 4353 4354=item Memory Management and String Handling 4355 4356=item Character Class Tests 4357 4358=item F<stdlib.h> functions 4359 4360=item Miscellaneous functions 4361 4362=back 4363 4364=item SEE ALSO 4365 4366=back 4367 4368=head2 perlguts - Introduction to the Perl API 4369 4370=over 4 4371 4372=item DESCRIPTION 4373 4374=item Variables 4375 4376=over 4 4377 4378=item Datatypes 4379 4380=item What is an "IV"? 4381 4382=item Working with SVs 4383 4384=item Offsets 4385 4386=item What's Really Stored in an SV? 4387 4388=item Working with AVs 4389 4390=item Working with HVs 4391 4392=item Hash API Extensions 4393 4394=item AVs, HVs and undefined values 4395 4396=item References 4397 4398=item Blessed References and Class Objects 4399 4400=item Creating New Variables 4401 4402GV_ADDMULTI, GV_ADDWARN 4403 4404=item Reference Counts and Mortality 4405 4406=item Stashes and Globs 4407 4408=item Double-Typed SVs 4409 4410=item Magic Variables 4411 4412=item Assigning Magic 4413 4414=item Magic Virtual Tables 4415 4416=item Finding Magic 4417 4418=item Understanding the Magic of Tied Hashes and Arrays 4419 4420=item Localizing changes 4421 4422C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, 4423C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV 4424*sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, 4425C<SAVEDELETE(HV *hv, char *key, I32 length)>, 4426C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, 4427C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* 4428save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, 4429C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, 4430C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void 4431save_hptr(HV **hptr)> 4432 4433=back 4434 4435=item Subroutines 4436 4437=over 4 4438 4439=item XSUBs and the Argument Stack 4440 4441=item Calling Perl Routines from within C Programs 4442 4443=item Memory Allocation 4444 4445=item PerlIO 4446 4447=item Putting a C value on Perl stack 4448 4449=item Scratchpads 4450 4451=item Scratchpads and recursion 4452 4453=back 4454 4455=item Compiled code 4456 4457=over 4 4458 4459=item Code tree 4460 4461=item Examining the tree 4462 4463=item Compile pass 1: check routines 4464 4465=item Compile pass 1a: constant folding 4466 4467=item Compile pass 2: context propagation 4468 4469=item Compile pass 3: peephole optimization 4470 4471=item Pluggable runops 4472 4473=back 4474 4475=item Examining internal data structures with the C<dump> functions 4476 4477=item How multiple interpreters and concurrency are supported 4478 4479=over 4 4480 4481=item Background and PERL_IMPLICIT_CONTEXT 4482 4483=item So what happened to dTHR? 4484 4485=item How do I use all this in extensions? 4486 4487=item Should I do anything special if I call perl from multiple threads? 4488 4489=item Future Plans and PERL_IMPLICIT_SYS 4490 4491=back 4492 4493=item Internal Functions 4494 4495A, p, d, s, n, r, f, M, o, x, m, X, E, b 4496 4497=over 4 4498 4499=item Formatted Printing of IVs, UVs, and NVs 4500 4501=item Pointer-To-Integer and Integer-To-Pointer 4502 4503=item Source Documentation 4504 4505=back 4506 4507=item Unicode Support 4508 4509=over 4 4510 4511=item What B<is> Unicode, anyway? 4512 4513=item How can I recognise a UTF-8 string? 4514 4515=item How does UTF-8 represent Unicode characters? 4516 4517=item How does Perl store UTF-8 strings? 4518 4519=item How do I convert a string to UTF-8? 4520 4521=item Is there anything else I need to know? 4522 4523=back 4524 4525=item Custom Operators 4526 4527=item AUTHORS 4528 4529=item SEE ALSO 4530 4531=back 4532 4533=head2 perlcall - Perl calling conventions from C 4534 4535=over 4 4536 4537=item DESCRIPTION 4538 4539An Error Handler, An Event Driven Program 4540 4541=item THE CALL_ FUNCTIONS 4542 4543call_sv, call_pv, call_method, call_argv 4544 4545=item FLAG VALUES 4546 4547=over 4 4548 4549=item G_VOID 4550 4551=item G_SCALAR 4552 4553=item G_ARRAY 4554 4555=item G_DISCARD 4556 4557=item G_NOARGS 4558 4559=item G_EVAL 4560 4561=item G_KEEPERR 4562 4563=item Determining the Context 4564 4565=back 4566 4567=item KNOWN PROBLEMS 4568 4569=item EXAMPLES 4570 4571=over 4 4572 4573=item No Parameters, Nothing returned 4574 4575=item Passing Parameters 4576 4577=item Returning a Scalar 4578 4579=item Returning a list of values 4580 4581=item Returning a list in a scalar context 4582 4583=item Returning Data from Perl via the parameter list 4584 4585=item Using G_EVAL 4586 4587=item Using G_KEEPERR 4588 4589=item Using call_sv 4590 4591=item Using call_argv 4592 4593=item Using call_method 4594 4595=item Using GIMME_V 4596 4597=item Using Perl to dispose of temporaries 4598 4599=item Strategies for storing Callback Context Information 4600 46011. Ignore the problem - Allow only 1 callback, 2. Create a sequence of 4602callbacks - hard wired limit, 3. Use a parameter to map to the Perl 4603callback 4604 4605=item Alternate Stack Manipulation 4606 4607=item Creating and calling an anonymous subroutine in C 4608 4609=back 4610 4611=item SEE ALSO 4612 4613=item AUTHOR 4614 4615=item DATE 4616 4617=back 4618 4619=head2 perlapi - autogenerated documentation for the perl public API 4620 4621=over 4 4622 4623=item DESCRIPTION 4624 4625=item "Gimme" Values 4626 4627GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID 4628 4629=item Array Manipulation Functions 4630 4631AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, 4632av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, 4633get_av, newAV, Nullav, sortsv 4634 4635=item Callback Functions 4636 4637call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv, 4638FREETMPS, LEAVE, SAVETMPS 4639 4640=item Character classes 4641 4642isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER 4643 4644=item Cloning an interpreter 4645 4646perl_clone 4647 4648=item CV Manipulation Functions 4649 4650CvSTASH, get_cv, Nullcv 4651 4652=item Embedding Functions 4653 4654cv_undef, load_module, nothreadhook, perl_alloc, perl_construct, 4655perl_destruct, perl_free, perl_parse, perl_run, require_pv 4656 4657=item Functions in file pp_pack.c 4658 4659packlist, pack_cat, unpackstring, unpack_str 4660 4661=item Global Variables 4662 4663PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes 4664 4665=item GV Functions 4666 4667GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, 4668gv_fetchmeth_autoload, gv_stashpv, gv_stashsv 4669 4670=item Handy Values 4671 4672HEf_SVKEY, Nullch, Nullsv 4673 4674=item Hash Manipulation Functions 4675 4676get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, 4677HeVAL, HvNAME, hv_clear, hv_clear_placeholders, hv_delete, hv_delete_ent, 4678hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, 4679hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval, 4680hv_magic, hv_scalar, hv_store, hv_store_ent, hv_undef, newHV, Nullhv 4681 4682=item Magical Functions 4683 4684mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, 4685SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, 4686SvSetSV, SvSetSV_nosteal, SvSHARE 4687 4688=item Memory Management 4689 4690Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree, 4691savepv, savepvn, savesharedpv, StructCopy, Zero 4692 4693=item Miscellaneous Functions 4694 4695fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT, 4696strNE, strnEQ, strnNE, sv_nolocking, sv_nosharing, sv_nounlocking 4697 4698=item Numeric functions 4699 4700grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin, 4701scan_hex, scan_oct 4702 4703=item Optree Manipulation Functions 4704 4705cv_const_sv, newCONSTSUB, newXS 4706 4707=item Pad Data Structures 4708 4709pad_sv 4710 4711=item Stack Manipulation Macros 4712 4713dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp, 4714POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, 4715PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN, 4716XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, 4717XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, 4718XST_mYES 4719 4720=item SV Flags 4721 4722svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG 4723 4724=item SV Manipulation Functions 4725 4726get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, 4727newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, 4728SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, 4729SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW, 4730SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp, 4731SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, 4732SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, 4733SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force, 4734SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force, 4735SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, 4736SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, 4737SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, 4738SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, 4739SvUV, SvUVx, SvUVX, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, 4740sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, 4741sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv, sv_catpvf, 4742sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, 4743sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, 4744sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, 4745sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, 4746sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, 4747sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, 4748sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, 4749sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, 4750sv_reftype, sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, 4751sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, 4752sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, 4753sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, 4754sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, 4755sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, 4756sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, 4757sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, 4758sv_vsetpvfn 4759 4760=item Unicode Support 4761 4762bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, 4763is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8, 4764sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, 4765to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, 4766utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, 4767uvuni_to_utf8_flags 4768 4769=item Variables created by C<xsubpp> and C<xsubpp> internal functions 4770 4771ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST, 4772THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK 4773 4774=item Warning and Dieing 4775 4776croak, warn 4777 4778=item AUTHORS 4779 4780=item SEE ALSO 4781 4782=back 4783 4784=head2 perlintern - autogenerated documentation of purely B<internal> 4785 Perl functions 4786 4787=over 4 4788 4789=item DESCRIPTION 4790 4791=item CV reference counts and CvOUTSIDE 4792 4793CvWEAKOUTSIDE 4794 4795=item Functions in file pad.h 4796 4797CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS, 4798PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH, 4799PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL, 4800PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, 4801PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV 4802 4803=item Functions in file pp_ctl.c 4804 4805find_runcv 4806 4807=item Global Variables 4808 4809PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv, 4810PL_rs 4811 4812=item GV Functions 4813 4814is_gv_magical 4815 4816=item IO Functions 4817 4818start_glob 4819 4820=item Pad Data Structures 4821 4822CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon, 4823pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex, 4824pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new, 4825pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef 4826 4827=item Stack Manipulation Macros 4828 4829djSP, LVRET 4830 4831=item SV Manipulation Functions 4832 4833report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas 4834 4835=item AUTHORS 4836 4837=item SEE ALSO 4838 4839=back 4840 4841=head2 perliol - C API for Perl's implementation of IO in Layers. 4842 4843=over 4 4844 4845=item SYNOPSIS 4846 4847=item DESCRIPTION 4848 4849=over 4 4850 4851=item History and Background 4852 4853=item Basic Structure 4854 4855=item Layers vs Disciplines 4856 4857=item Data Structures 4858 4859=item Functions and Attributes 4860 4861=item Per-instance Data 4862 4863=item Layers in action. 4864 4865=item Per-instance flag bits 4866 4867PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, 4868PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, 4869PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, 4870PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS 4871 4872=item Methods in Detail 4873 4874fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, 4875PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, 4876Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, 4877Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, 4878Set_ptrcnt 4879 4880=item Utilities 4881 4882=item Implementing PerlIO Layers 4883 4884C implementations, Perl implementations 4885 4886=item Core Layers 4887 4888"unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" 4889 4890=item Extension Layers 4891 4892":encoding", ":scalar", ":via" 4893 4894=back 4895 4896=item TODO 4897 4898=back 4899 4900=head2 perlapio - perl's IO abstraction interface. 4901 4902=over 4 4903 4904=item SYNOPSIS 4905 4906=item DESCRIPTION 4907 49081. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, 4909B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, 4910B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, 4911B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, 4912B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, 4913B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, 4914B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, 4915B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, 4916B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, 4917B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, 4918B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> 4919 4920=over 4 4921 4922=item Co-existence with stdio 4923 4924B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>, 4925B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)> 4926 4927=item "Fast gets" Functions 4928 4929B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, 4930B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, 4931B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, 4932B<PerlIO_get_bufsiz(f)> 4933 4934=item Other Functions 4935 4936PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), 4937'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) 4938 4939=back 4940 4941=back 4942 4943=head2 perlhack - How to hack at the Perl internals 4944 4945=over 4 4946 4947=item DESCRIPTION 4948 4949Does concept match the general goals of Perl?, Where is the 4950implementation?, Backwards compatibility, Could it be a module instead?, Is 4951the feature generic enough?, Does it potentially introduce new bugs?, Does 4952it preclude other desirable features?, Is the implementation robust?, Is 4953the implementation generic enough to be portable?, Is the implementation 4954tested?, Is there enough documentation?, Is there another way to do it?, 4955Does it create too much work?, Patches speak louder than words 4956 4957=over 4 4958 4959=item Keeping in sync 4960 4961rsync'ing the source tree, Using rsync over the LAN, Using pushing over the 4962NFS, rsync'ing the patches 4963 4964=item Why rsync the source tree 4965 4966It's easier to rsync the source tree, It's more reliable 4967 4968=item Why rsync the patches 4969 4970It's easier to rsync the patches, It's a good reference, Finding a start 4971point, Finding how to fix a bug, Finding the source of misbehaviour 4972 4973=item Perlbug administration 4974 4975=item Submitting patches 4976 4977L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, 4978F<Porting/pumpkin.pod>, The perl5-porters FAQ 4979 4980=item Finding Your Way Around 4981 4982Core modules, Tests, Documentation, Configure, Interpreter 4983 4984=item Elements of the interpreter 4985 4986Startup, Parsing, Optimization, Running 4987 4988=item Internal Variable Types 4989 4990=item Op Trees 4991 4992=item Stacks 4993 4994Argument stack, Mark stack, Save stack 4995 4996=item Millions of Macros 4997 4998=item The .i Targets 4999 5000=item Poking at Perl 5001 5002=item Using a source-level debugger 5003 5004run [args], break function_name, break source.c:xxx, step, next, continue, 5005finish, 'enter', print 5006 5007=item gdb macro support 5008 5009=item Dumping Perl Data Structures 5010 5011=item Patching 5012 5013=item Patching a core module 5014 5015=item Adding a new function to the core 5016 5017=item Writing a test 5018 5019F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, 5020F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp, 5021t/cmd t/run t/io t/op, t/lib ext lib 5022 5023=item Special Make Test Targets 5024 5025coretest, test.deparse, test.taintwarn, minitest, test.valgrind 5026check.valgrind utest.valgrind ucheck.valgrind, test.third check.third 5027utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 5028check.utf8, test_harness 5029 5030=item Running tests by hand 5031 5032PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST 5033 5034=back 5035 5036=item EXTERNAL TOOLS FOR DEBUGGING PERL 5037 5038=over 4 5039 5040=item Rational Software's Purify 5041 5042=item Purify on Unix 5043 5044-Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity 5045 5046=item Purify on NT 5047 5048DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug 5049 5050=item valgrind 5051 5052=item Compaq's/Digital's/HP's Third Degree 5053 5054=item PERL_DESTRUCT_LEVEL 5055 5056=item Profiling 5057 5058=item Gprof Profiling 5059 5060-a, -b, -e routine, -f routine, -s, -z 5061 5062=item GCC gcov Profiling 5063 5064=item Pixie Profiling 5065 5066-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, 5067-z[ero] 5068 5069=item Miscellaneous tricks 5070 5071=item CONCLUSION 5072 5073I<The Road goes ever on and on, down from the door where it began.> 5074 5075=back 5076 5077=item AUTHOR 5078 5079=back 5080 5081=head2 perlbook - Perl book information 5082 5083=over 4 5084 5085=item DESCRIPTION 5086 5087=back 5088 5089=head2 perltodo - Perl TO-DO List 5090 5091=over 4 5092 5093=item DESCRIPTION 5094 5095=item To do during 5.6.x 5096 5097=over 4 5098 5099=item Support for I/O disciplines 5100 5101=item Autoload bytes.pm 5102 5103=item Make "\u{XXXX}" et al work 5104 5105=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) 5106 5107=item Overloadable regex assertions 5108 5109=item Unicode 5110 5111=item Work out exit/die semantics for threads 5112 5113=item Better support for nonpreemptive threading systems like GNU pth 5114 5115=item Typed lexicals for compiler 5116 5117=item Compiler workarounds for Win32 5118 5119=item AUTOLOADing in the compiler 5120 5121=item Fixing comppadlist when compiling 5122 5123=item Cleaning up exported namespace 5124 5125=item Complete signal handling 5126 5127=item Out-of-source builds 5128 5129=item POSIX realtime support 5130 5131=item UNIX98 support 5132 5133=item IPv6 Support 5134 5135=item Long double conversion 5136 5137=item Locales 5138 5139=item Arithmetic on non-Arabic numerals 5140 5141=item POSIX Unicode character classes 5142 5143=item Factoring out common suffices/prefices in regexps (trie optimization) 5144 5145=item Security audit shipped utilities 5146 5147=item Sort out the uid-setting mess 5148 5149=item Custom opcodes 5150 5151=item DLL Versioning 5152 5153=item Introduce @( and @) 5154 5155=item Floating point handling 5156 5157=item IV/UV preservation 5158 5159=item Replace pod2html with something using Pod::Parser 5160 5161=item Automate module testing on CPAN 5162 5163=item sendmsg and recvmsg 5164 5165=item Rewrite perlre documentation 5166 5167=item Convert example code to IO::Handle filehandles 5168 5169=item Document Win32 choices 5170 5171=item Check new modules 5172 5173=item Make roffitall find pods and libs itself 5174 5175=back 5176 5177=item To do at some point 5178 5179=over 4 5180 5181=item Remove regular expression recursion 5182 5183=item Memory leaks after failed eval 5184 5185=item bitfields in pack 5186 5187=item Cross compilation 5188 5189=item Perl preprocessor / macros 5190 5191=item Perl lexer in Perl 5192 5193=item Using POSIX calls internally 5194 5195=item -i rename file when changed 5196 5197=item All ARGV input should act like E<lt>E<gt> 5198 5199=item Support for rerunning debugger 5200 5201=item Test Suite for the Debugger 5202 5203=item my sub foo { } 5204 5205=item One-pass global destruction 5206 5207=item Rewrite regexp parser 5208 5209=item Cache recently used regexps 5210 5211=item Cross-compilation support 5212 5213=item Bit-shifting bitvectors 5214 5215=item debugger pragma 5216 5217=item use less pragma 5218 5219=item switch structures 5220 5221=item Cache eval tree 5222 5223=item rcatmaybe 5224 5225=item Shrink opcode tables 5226 5227=item Optimize away @_ 5228 5229=item Prototypes versus indirect objects 5230 5231=item Install HTML 5232 5233=item Prototype method calls 5234 5235=item Return context prototype declarations 5236 5237=item magic_setisa 5238 5239=item Garbage collection 5240 5241=item IO tutorial 5242 5243=item Rewrite perldoc 5244 5245=item Install .3p manpages 5246 5247=item Unicode tutorial 5248 5249=item Update POSIX.pm for 1003.1-2 5250 5251=item Retargetable installation 5252 5253=item POSIX emulation on non-POSIX systems 5254 5255=item Rename Win32 headers 5256 5257=item Finish off lvalue functions 5258 5259=item Update sprintf documentation 5260 5261=item Use fchown/fchmod internally 5262 5263=item Make v-strings overloaded objects 5264 5265=item Allow restricted hash assignment 5266 5267=item Should overload be inheritable? 5268 5269=item Taint rethink 5270 5271=item Perform correctly when XSUBs call subroutines that exit via 5272goto(LABEL) and friends 5273 5274=back 5275 5276=item Vague ideas 5277 5278=over 4 5279 5280=item ref() in list context 5281 5282=item Make tr/// return histogram of characters in list context 5283 5284=item Compile to real threaded code 5285 5286=item Structured types 5287 5288=item Modifiable $1 et al. 5289 5290=item Procedural interfaces for IO::*, etc. 5291 5292=item RPC modules 5293 5294=item Attach/detach debugger from running program 5295 5296=item GUI::Native 5297 5298=item foreach(reverse ...) 5299 5300=item Constant function cache 5301 5302=item Approximate regular expression matching 5303 5304=back 5305 5306=item Ongoing 5307 5308=over 4 5309 5310=item Update guts documentation 5311 5312=item Add more tests 5313 5314=item Update auxiliary tools 5315 5316=item Create debugging macros 5317 5318=item truncate to the people 5319 5320=item Unicode in Filenames 5321 5322=back 5323 5324=item Unicode in %ENV 5325 5326=item Recently done things 5327 5328=over 4 5329 5330=item Alternative RE syntax module 5331 5332=item Safe signal handling 5333 5334=item Tie Modules 5335 5336=item gettimeofday 5337 5338=item setitimer and getimiter 5339 5340=item Testing __DIE__ hook 5341 5342=item CPP equivalent in Perl 5343 5344=item Explicit switch statements 5345 5346=item autocroak 5347 5348=item UTF/EBCDIC 5349 5350=item UTF Regexes 5351 5352=item perlcc to produce executable 5353 5354=item END blocks saved in compiled output 5355 5356=item Secure temporary file module 5357 5358=item Integrate Time::HiRes 5359 5360=item Turn Cwd into XS 5361 5362=item Mmap for input 5363 5364=item Byte to/from UTF-8 and UTF-8 to/from local conversion 5365 5366=item Add sockatmark support 5367 5368=item Mailing list archives 5369 5370=item Bug tracking 5371 5372=item Integrate MacPerl 5373 5374=item Web "nerve center" for Perl 5375 5376=item Regular expression tutorial 5377 5378=item Debugging Tutorial 5379 5380=item Integrate new modules 5381 5382=item Integrate profiler 5383 5384=item Y2K error detection 5385 5386=item Regular expression debugger 5387 5388=item POD checker 5389 5390=item "Dynamic" lexicals 5391 5392=item Cache precompiled modules 5393 5394=back 5395 5396=item Deprecated Wishes 5397 5398=over 4 5399 5400=item Loop control on do{} 5401 5402=item Lexically scoped typeglobs 5403 5404=item format BOTTOM 5405 5406=item report HANDLE 5407 5408=item Generalised want()/caller()) 5409 5410=item Named prototypes 5411 5412=item Built-in globbing 5413 5414=item Regression tests for suidperl 5415 5416=item Cached hash values 5417 5418=item Add compression modules 5419 5420=item Reorganise documentation into tutorials/references 5421 5422=item Remove distinction between functions and operators 5423 5424=item Make XS easier to use 5425 5426=item Make embedding easier to use 5427 5428=item man for perl 5429 5430=item my $Package::variable 5431 5432=item "or" tests defined, not truth 5433 5434=item "class"-based lexicals 5435 5436=item byteperl 5437 5438=item Lazy evaluation / tail recursion removal 5439 5440=item Make "use utf8" the default 5441 5442=item Unicode collation and normalization 5443 5444=item pack/unpack tutorial 5445 5446=back 5447 5448=back 5449 5450=head2 perldoc - Look up Perl documentation in Pod format. 5451 5452=over 4 5453 5454=item SYNOPSIS 5455 5456=item DESCRIPTION 5457 5458=item OPTIONS 5459 5460B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f> 5461I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d> 5462I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>, 5463B<-w> I<option:value> or B<-w> I<option>, B<-X>, 5464B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>, 5465B<-V> 5466 5467=item SECURITY 5468 5469=item ENVIRONMENT 5470 5471=item AUTHOR 5472 5473=back 5474 5475=head2 perlhist - the Perl history records 5476 5477=over 4 5478 5479=item DESCRIPTION 5480 5481=item INTRODUCTION 5482 5483=item THE KEEPERS OF THE PUMPKIN 5484 5485=over 4 5486 5487=item PUMPKIN? 5488 5489=back 5490 5491=item THE RECORDS 5492 5493=over 4 5494 5495=item SELECTED RELEASE SIZES 5496 5497=item SELECTED PATCH SIZES 5498 5499=back 5500 5501=item THE KEEPERS OF THE RECORDS 5502 5503=back 5504 5505=head2 perldelta - what is new for perl v5.8.4 5506 5507=over 4 5508 5509=item DESCRIPTION 5510 5511=item Incompatible Changes 5512 5513=item Core Enhancements 5514 5515=over 4 5516 5517=item Malloc wrapping 5518 5519=item Unicode Character Database 4.0.1 5520 5521=item suidperl less insecure 5522 5523=item format 5524 5525=back 5526 5527=item Modules and Pragmata 5528 5529=over 4 5530 5531=item Updated modules 5532 5533Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, 5534IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, 5535Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, 5536Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, 5537base, open, threads, utf8 5538 5539=back 5540 5541=item Performance Enhancements 5542 5543=item Utility Changes 5544 5545=item Installation and Configuration Improvements 5546 5547=item Selected Bug Fixes 5548 5549=item New or Changed Diagnostics 5550 5551=item Changed Internals 5552 5553=item Future Directions 5554 5555=item Platform Specific Problems 5556 5557=item Reporting Bugs 5558 5559=item SEE ALSO 5560 5561=back 5562 5563=head2 perl584delta, perldelta - what is new for perl v5.8.4 5564 5565=over 4 5566 5567=item DESCRIPTION 5568 5569=item Incompatible Changes 5570 5571=item Core Enhancements 5572 5573=over 4 5574 5575=item Malloc wrapping 5576 5577=item Unicode Character Database 4.0.1 5578 5579=item suidperl less insecure 5580 5581=item format 5582 5583=back 5584 5585=item Modules and Pragmata 5586 5587=over 4 5588 5589=item Updated modules 5590 5591Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, 5592IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, 5593Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, 5594Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, 5595base, open, threads, utf8 5596 5597=back 5598 5599=item Performance Enhancements 5600 5601=item Utility Changes 5602 5603=item Installation and Configuration Improvements 5604 5605=item Selected Bug Fixes 5606 5607=item New or Changed Diagnostics 5608 5609=item Changed Internals 5610 5611=item Future Directions 5612 5613=item Platform Specific Problems 5614 5615=item Reporting Bugs 5616 5617=item SEE ALSO 5618 5619=back 5620 5621=head2 perl583delta - what is new for perl v5.8.3 5622 5623=over 4 5624 5625=item DESCRIPTION 5626 5627=item Incompatible Changes 5628 5629=item Core Enhancements 5630 5631=item Modules and Pragmata 5632 5633CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util, 5634Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate, 5635Unicode::Normalize, Test::Harness, threads::shared 5636 5637=item Utility Changes 5638 5639=item New Documentation 5640 5641=item Installation and Configuration Improvements 5642 5643=item Selected Bug Fixes 5644 5645=item New or Changed Diagnostics 5646 5647=item Changed Internals 5648 5649=item Configuration and Building 5650 5651=item Platform Specific Problems 5652 5653=item Known Problems 5654 5655=item Future Directions 5656 5657=item Obituary 5658 5659=item Reporting Bugs 5660 5661=item SEE ALSO 5662 5663=back 5664 5665=head2 perl582delta - what is new for perl v5.8.2 5666 5667=over 4 5668 5669=item DESCRIPTION 5670 5671=item Incompatible Changes 5672 5673=item Core Enhancements 5674 5675=over 4 5676 5677=item Hash Randomisation 5678 5679=item Threading 5680 5681=back 5682 5683=item Modules and Pragmata 5684 5685=over 4 5686 5687=item Updated Modules And Pragmata 5688 5689Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64, 5690Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate, 5691Unicode::Normalize, UNIVERSAL 5692 5693=back 5694 5695=item Selected Bug Fixes 5696 5697=item Changed Internals 5698 5699=item Platform Specific Problems 5700 5701=item Future Directions 5702 5703=item Reporting Bugs 5704 5705=item SEE ALSO 5706 5707=back 5708 5709=head2 perl581delta - what is new for perl v5.8.1 5710 5711=over 4 5712 5713=item DESCRIPTION 5714 5715=item Incompatible Changes 5716 5717=over 4 5718 5719=item Hash Randomisation 5720 5721=item UTF-8 On Filehandles No Longer Activated By Locale 5722 5723=item Single-number v-strings are no longer v-strings before "=>" 5724 5725=item (Win32) The -C Switch Has Been Repurposed 5726 5727=item (Win32) The /d Switch Of cmd.exe 5728 5729=back 5730 5731=item Core Enhancements 5732 5733=over 4 5734 5735=item UTF-8 no longer default under UTF-8 locales 5736 5737=item Unsafe signals again available 5738 5739=item Tied Arrays with Negative Array Indices 5740 5741=item local ${$x} 5742 5743=item Unicode Character Database 4.0.0 5744 5745=item Deprecation Warnings 5746 5747=item Miscellaneous Enhancements 5748 5749=back 5750 5751=item Modules and Pragmata 5752 5753=over 4 5754 5755=item Updated Modules And Pragmata 5756 5757base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, 5758CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, 5759Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, 5760PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, 5761Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, 5762Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, 5763Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, 5764Win32::GetOSVersion 5765 5766=back 5767 5768=item Utility Changes 5769 5770=item New Documentation 5771 5772=item Installation and Configuration Improvements 5773 5774=over 4 5775 5776=item Platform-specific enhancements 5777 5778=back 5779 5780=item Selected Bug Fixes 5781 5782=over 4 5783 5784=item Closures, eval and lexicals 5785 5786=item Generic fixes 5787 5788=item Platform-specific fixes 5789 5790=back 5791 5792=item New or Changed Diagnostics 5793 5794=over 4 5795 5796=item Changed "A thread exited while %d threads were running" 5797 5798=item Removed "Attempt to clear a restricted hash" 5799 5800=item New "Illegal declaration of anonymous subroutine" 5801 5802=item Changed "Invalid range "%s" in transliteration operator" 5803 5804=item New "Missing control char name in \c" 5805 5806=item New "Newline in left-justified string for %s" 5807 5808=item New "Possible precedence problem on bitwise %c operator" 5809 5810=item New "Pseudo-hashes are deprecated" 5811 5812=item New "read() on %s filehandle %s" 5813 5814=item New "5.005 threads are deprecated" 5815 5816=item New "Tied variable freed while still in use" 5817 5818=item New "To%s: illegal mapping '%s'" 5819 5820=item New "Use of freed value in iteration" 5821 5822=back 5823 5824=item Changed Internals 5825 5826=item New Tests 5827 5828=item Known Problems 5829 5830=over 4 5831 5832=item Tied hashes in scalar context 5833 5834=item Net::Ping 450_service and 510_ping_udp failures 5835 5836=item B::C 5837 5838=back 5839 5840=item Platform Specific Problems 5841 5842=over 4 5843 5844=item EBCDIC Platforms 5845 5846=item Cygwin 1.5 problems 5847 5848=item HP-UX: HP cc warnings about sendfile and sendpath 5849 5850=item IRIX: t/uni/tr_7jis.t falsely failing 5851 5852=item Mac OS X: no usemymalloc 5853 5854=item Tru64: No threaded builds with GNU cc (gcc) 5855 5856=item Win32: sysopen, sysread, syswrite 5857 5858=back 5859 5860=item Future Directions 5861 5862=item Reporting Bugs 5863 5864=item SEE ALSO 5865 5866=back 5867 5868=head2 perl58delta - what is new for perl v5.8.0 5869 5870=over 4 5871 5872=item DESCRIPTION 5873 5874=item Highlights In 5.8.0 5875 5876=item Incompatible Changes 5877 5878=over 4 5879 5880=item Binary Incompatibility 5881 5882=item 64-bit platforms and malloc 5883 5884=item AIX Dynaloading 5885 5886=item Attributes for C<my> variables now handled at run-time 5887 5888=item Socket Extension Dynamic in VMS 5889 5890=item IEEE-format Floating Point Default on OpenVMS Alpha 5891 5892=item New Unicode Semantics (no more C<use utf8>, almost) 5893 5894=item New Unicode Properties 5895 5896=item REF(...) Instead Of SCALAR(...) 5897 5898=item pack/unpack D/F recycled 5899 5900=item glob() now returns filenames in alphabetical order 5901 5902=item Deprecations 5903 5904=back 5905 5906=item Core Enhancements 5907 5908=over 4 5909 5910=item Unicode Overhaul 5911 5912=item PerlIO is Now The Default 5913 5914=item ithreads 5915 5916=item Restricted Hashes 5917 5918=item Safe Signals 5919 5920=item Understanding of Numbers 5921 5922=item Arrays now always interpolate into double-quoted strings [561] 5923 5924=item Miscellaneous Changes 5925 5926=back 5927 5928=item Modules and Pragmata 5929 5930=over 4 5931 5932=item New Modules and Pragmata 5933 5934=item Updated And Improved Modules and Pragmata 5935 5936=back 5937 5938=item Utility Changes 5939 5940=item New Documentation 5941 5942=item Performance Enhancements 5943 5944=item Installation and Configuration Improvements 5945 5946=over 4 5947 5948=item Generic Improvements 5949 5950=item New Or Improved Platforms 5951 5952=back 5953 5954=item Selected Bug Fixes 5955 5956=over 4 5957 5958=item Platform Specific Changes and Fixes 5959 5960=back 5961 5962=item New or Changed Diagnostics 5963 5964=item Changed Internals 5965 5966=item Security Vulnerability Closed [561] 5967 5968=item New Tests 5969 5970=item Known Problems 5971 5972=over 4 5973 5974=item The Compiler Suite Is Still Very Experimental 5975 5976=item Localising Tied Arrays and Hashes Is Broken 5977 5978=item Building Extensions Can Fail Because Of Largefiles 5979 5980=item Modifying $_ Inside for(..) 5981 5982=item mod_perl 1.26 Doesn't Build With Threaded Perl 5983 5984=item lib/ftmp-security tests warn 'system possibly insecure' 5985 5986=item libwww-perl (LWP) fails base/date #51 5987 5988=item PDL failing some tests 5989 5990=item Perl_get_sv 5991 5992=item Self-tying Problems 5993 5994=item ext/threads/t/libc 5995 5996=item Failure of Thread (5.005-style) tests 5997 5998=item Timing problems 5999 6000=item Tied/Magical Array/Hash Elements Do Not Autovivify 6001 6002=item Unicode in package/class and subroutine names does not work 6003 6004=back 6005 6006=item Platform Specific Problems 6007 6008=over 4 6009 6010=item AIX 6011 6012=item Alpha systems with old gccs fail several tests 6013 6014=item AmigaOS 6015 6016=item BeOS 6017 6018=item Cygwin "unable to remap" 6019 6020=item Cygwin ndbm tests fail on FAT 6021 6022=item DJGPP Failures 6023 6024=item FreeBSD built with ithreads coredumps reading large directories 6025 6026=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales 6027 6028=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 6029 6030=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured 6031 6032=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint 6033 6034=item Linux With Sfio Fails op/misc Test 48 6035 6036=item Mac OS X 6037 6038=item Mac OS X dyld undefined symbols 6039 6040=item OS/2 Test Failures 6041 6042=item op/sprintf tests 91, 129, and 130 6043 6044=item SCO 6045 6046=item Solaris 2.5 6047 6048=item Solaris x86 Fails Tests With -Duse64bitint 6049 6050=item SUPER-UX (NEC SX) 6051 6052=item Term::ReadKey not working on Win32 6053 6054=item UNICOS/mk 6055 6056=item UTS 6057 6058=item VOS (Stratus) 6059 6060=item VMS 6061 6062=item Win32 6063 6064=item XML::Parser not working 6065 6066=item z/OS (OS/390) 6067 6068=item Unicode Support on EBCDIC Still Spotty 6069 6070=item Seen In Perl 5.7 But Gone Now 6071 6072=back 6073 6074=item Reporting Bugs 6075 6076=item SEE ALSO 6077 6078=item HISTORY 6079 6080=back 6081 6082=head2 perl573delta - what's new for perl v5.7.3 6083 6084=over 4 6085 6086=item DESCRIPTION 6087 6088=item Changes 6089 6090=item Reporting Bugs 6091 6092=item SEE ALSO 6093 6094=item HISTORY 6095 6096=back 6097 6098=head2 perl572delta - what's new for perl v5.7.2 6099 6100=over 4 6101 6102=item DESCRIPTION 6103 6104=item Security Vulnerability Closed 6105 6106=item Incompatible Changes 6107 6108=over 4 6109 6110=item 64-bit platforms and malloc 6111 6112=item AIX Dynaloading 6113 6114=item Socket Extension Dynamic in VMS 6115 6116=item Different Definition of the Unicode Character Classes \p{In...} 6117 6118=item Deprecations 6119 6120=back 6121 6122=item Core Enhancements 6123 6124=item Modules and Pragmata 6125 6126=over 4 6127 6128=item New Modules and Distributions 6129 6130=item Updated And Improved Modules and Pragmata 6131 6132=back 6133 6134=item Utility Changes 6135 6136=item New Documentation 6137 6138=item Installation and Configuration Improvements 6139 6140=over 4 6141 6142=item New Or Improved Platforms 6143 6144=item Generic Improvements 6145 6146=back 6147 6148=item Selected Bug Fixes 6149 6150=over 4 6151 6152=item Platform Specific Changes and Fixes 6153 6154=back 6155 6156=item New or Changed Diagnostics 6157 6158=item Source Code Enhancements 6159 6160=over 4 6161 6162=item MAGIC constants 6163 6164=item Better commented code 6165 6166=item Regex pre-/post-compilation items matched up 6167 6168=item gcc -Wall 6169 6170=back 6171 6172=item New Tests 6173 6174=item Known Problems 6175 6176=over 4 6177 6178=item AIX 6179 6180=item Amiga Perl Invoking Mystery 6181 6182=item lib/ftmp-security tests warn 'system possibly insecure' 6183 6184=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 6185 6186=item HP-UX lib/io_multihomed Fails When LP64-Configured 6187 6188=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured 6189 6190=item Linux With Sfio Fails op/misc Test 48 6191 6192=item OS/390 6193 6194=item op/sprintf tests 129 and 130 6195 6196=item Failure of Thread tests 6197 6198=item UNICOS 6199 6200=item UTS 6201 6202=item VMS 6203 6204=item Win32 6205 6206=item Localising a Tied Variable Leaks Memory 6207 6208=item Self-tying of Arrays and Hashes Is Forbidden 6209 6210=item Variable Attributes are not Currently Usable for Tieing 6211 6212=item Building Extensions Can Fail Because Of Largefiles 6213 6214=item The Compiler Suite Is Still Experimental 6215 6216=item The Long Double Support is Still Experimental 6217 6218=back 6219 6220=item Reporting Bugs 6221 6222=item SEE ALSO 6223 6224=item HISTORY 6225 6226=back 6227 6228=head2 perl571delta - what's new for perl v5.7.1 6229 6230=over 4 6231 6232=item DESCRIPTION 6233 6234=item Security Vulnerability Closed 6235 6236=item Incompatible Changes 6237 6238=item Core Enhancements 6239 6240=over 4 6241 6242=item AUTOLOAD Is Now Lvaluable 6243 6244=item PerlIO is Now The Default 6245 6246=item Signals Are Now Safe 6247 6248=back 6249 6250=item Modules and Pragmata 6251 6252=over 4 6253 6254=item New Modules 6255 6256=item Updated And Improved Modules and Pragmata 6257 6258=back 6259 6260=item Performance Enhancements 6261 6262=item Utility Changes 6263 6264=item New Documentation 6265 6266=over 4 6267 6268=item perlclib 6269 6270=item perliol 6271 6272=item README.aix 6273 6274=item README.bs2000 6275 6276=item README.macos 6277 6278=item README.mpeix 6279 6280=item README.solaris 6281 6282=item README.vos 6283 6284=item Porting/repository.pod 6285 6286=back 6287 6288=item Installation and Configuration Improvements 6289 6290=over 4 6291 6292=item New Or Improved Platforms 6293 6294=item Generic Improvements 6295 6296d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, 6297need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, 6298d_strtoq, d_u32align, d_ualarm, d_usleep 6299 6300=back 6301 6302=item Selected Bug Fixes 6303 6304=over 4 6305 6306=item Platform Specific Changes and Fixes 6307 6308=back 6309 6310=item New or Changed Diagnostics 6311 6312=item Changed Internals 6313 6314=item New Tests 6315 6316=item Known Problems 6317 6318=over 4 6319 6320=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl 6321 6322=item lib/ftmp-security tests warn 'system possibly insecure' 6323 6324=item lib/io_multihomed Fails In LP64-Configured HP-UX 6325 6326=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX 6327 6328=item lib/b test 19 6329 6330=item Linux With Sfio Fails op/misc Test 48 6331 6332=item sigaction test 13 in VMS 6333 6334=item sprintf tests 129 and 130 6335 6336=item Failure of Thread tests 6337 6338=item Localising a Tied Variable Leaks Memory 6339 6340=item Self-tying of Arrays and Hashes Is Forbidden 6341 6342=item Building Extensions Can Fail Because Of Largefiles 6343 6344=item The Compiler Suite Is Still Experimental 6345 6346=back 6347 6348=item Reporting Bugs 6349 6350=item SEE ALSO 6351 6352=item HISTORY 6353 6354=back 6355 6356=head2 perl570delta - what's new for perl v5.7.0 6357 6358=over 4 6359 6360=item DESCRIPTION 6361 6362=item Security Vulnerability Closed 6363 6364=item Incompatible Changes 6365 6366=item Core Enhancements 6367 6368=item Modules and Pragmata 6369 6370=over 4 6371 6372=item New Modules 6373 6374=item Updated And Improved Modules and Pragmata 6375 6376=back 6377 6378=item Utility Changes 6379 6380=item New Documentation 6381 6382=item Performance Enhancements 6383 6384=item Installation and Configuration Improvements 6385 6386=over 4 6387 6388=item Generic Improvements 6389 6390=back 6391 6392=item Selected Bug Fixes 6393 6394=over 4 6395 6396=item Platform Specific Changes and Fixes 6397 6398=back 6399 6400=item New or Changed Diagnostics 6401 6402=item Changed Internals 6403 6404=item Known Problems 6405 6406=over 4 6407 6408=item Unicode Support Still Far From Perfect 6409 6410=item EBCDIC Still A Lost Platform 6411 6412=item Building Extensions Can Fail Because Of Largefiles 6413 6414=item ftmp-security tests warn 'system possibly insecure' 6415 6416=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX 6417 6418=item Long Doubles Still Don't Work In Solaris 6419 6420=item Linux With Sfio Fails op/misc Test 48 6421 6422=item Storable tests fail in some platforms 6423 6424=item Threads Are Still Experimental 6425 6426=item The Compiler Suite Is Still Experimental 6427 6428=back 6429 6430=item Reporting Bugs 6431 6432=item SEE ALSO 6433 6434=item HISTORY 6435 6436=back 6437 6438=head2 perl561delta - what's new for perl v5.6.x 6439 6440=over 4 6441 6442=item DESCRIPTION 6443 6444=item Summary of changes between 5.6.0 and 5.6.1 6445 6446=over 4 6447 6448=item Security Issues 6449 6450=item Core bug fixes 6451 6452C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), 6453Bugs in regular expressions, "slurp" mode, Autovivification of symbolic 6454references to special variables, Lexical warnings, Spurious warnings and 6455errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, 6456map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, 6457Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no 6458Module;>, Tests 6459 6460=item Core features 6461 6462=item Configuration issues 6463 6464=item Documentation 6465 6466=item Bundled modules 6467 6468B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, 6469Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, 6470IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, 6471Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash 6472 6473=item Platform-specific improvements 6474 6475NCR MP-RAS, NonStop-UX 6476 6477=back 6478 6479=item Core Enhancements 6480 6481=over 4 6482 6483=item Interpreter cloning, threads, and concurrency 6484 6485=item Lexically scoped warning categories 6486 6487=item Unicode and UTF-8 support 6488 6489=item Support for interpolating named characters 6490 6491=item "our" declarations 6492 6493=item Support for strings represented as a vector of ordinals 6494 6495=item Improved Perl version numbering system 6496 6497=item New syntax for declaring subroutine attributes 6498 6499=item File and directory handles can be autovivified 6500 6501=item open() with more than two arguments 6502 6503=item 64-bit support 6504 6505=item Large file support 6506 6507=item Long doubles 6508 6509=item "more bits" 6510 6511=item Enhanced support for sort() subroutines 6512 6513=item C<sort $coderef @foo> allowed 6514 6515=item File globbing implemented internally 6516 6517=item Support for CHECK blocks 6518 6519=item POSIX character class syntax [: :] supported 6520 6521=item Better pseudo-random number generator 6522 6523=item Improved C<qw//> operator 6524 6525=item Better worst-case behavior of hashes 6526 6527=item pack() format 'Z' supported 6528 6529=item pack() format modifier '!' supported 6530 6531=item pack() and unpack() support counted strings 6532 6533=item Comments in pack() templates 6534 6535=item Weak references 6536 6537=item Binary numbers supported 6538 6539=item Lvalue subroutines 6540 6541=item Some arrows may be omitted in calls through references 6542 6543=item Boolean assignment operators are legal lvalues 6544 6545=item exists() is supported on subroutine names 6546 6547=item exists() and delete() are supported on array elements 6548 6549=item Pseudo-hashes work better 6550 6551=item Automatic flushing of output buffers 6552 6553=item Better diagnostics on meaningless filehandle operations 6554 6555=item Where possible, buffered data discarded from duped input filehandle 6556 6557=item eof() has the same old magic as <> 6558 6559=item binmode() can be used to set :crlf and :raw modes 6560 6561=item C<-T> filetest recognizes UTF-8 encoded files as "text" 6562 6563=item system(), backticks and pipe open now reflect exec() failure 6564 6565=item Improved diagnostics 6566 6567=item Diagnostics follow STDERR 6568 6569=item More consistent close-on-exec behavior 6570 6571=item syswrite() ease-of-use 6572 6573=item Better syntax checks on parenthesized unary operators 6574 6575=item Bit operators support full native integer width 6576 6577=item Improved security features 6578 6579=item More functional bareword prototype (*) 6580 6581=item C<require> and C<do> may be overridden 6582 6583=item $^X variables may now have names longer than one character 6584 6585=item New variable $^C reflects C<-c> switch 6586 6587=item New variable $^V contains Perl version as a string 6588 6589=item Optional Y2K warnings 6590 6591=item Arrays now always interpolate into double-quoted strings 6592 6593=back 6594 6595=item Modules and Pragmata 6596 6597=over 4 6598 6599=item Modules 6600 6601attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, 6602DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, 6603Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, 6604File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, 6605Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, 6606podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, 6607pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, 6608Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters 6609 6610=item Pragmata 6611 6612=back 6613 6614=item Utility Changes 6615 6616=over 4 6617 6618=item dprofpp 6619 6620=item find2perl 6621 6622=item h2xs 6623 6624=item perlcc 6625 6626=item perldoc 6627 6628=item The Perl Debugger 6629 6630=back 6631 6632=item Improved Documentation 6633 6634perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, 6635perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, 6636perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, 6637perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod 6638 6639=item Performance enhancements 6640 6641=over 4 6642 6643=item Simple sort() using { $a <=> $b } and the like are optimized 6644 6645=item Optimized assignments to lexical variables 6646 6647=item Faster subroutine calls 6648 6649=item delete(), each(), values() and hash iteration are faster 6650 6651=back 6652 6653=item Installation and Configuration Improvements 6654 6655=over 4 6656 6657=item -Dusethreads means something different 6658 6659=item New Configure flags 6660 6661=item Threadedness and 64-bitness now more daring 6662 6663=item Long Doubles 6664 6665=item -Dusemorebits 6666 6667=item -Duselargefiles 6668 6669=item installusrbinperl 6670 6671=item SOCKS support 6672 6673=item C<-A> flag 6674 6675=item Enhanced Installation Directories 6676 6677=item gcc automatically tried if 'cc' does not seem to be working 6678 6679=back 6680 6681=item Platform specific changes 6682 6683=over 4 6684 6685=item Supported platforms 6686 6687=item DOS 6688 6689=item OS390 (OpenEdition MVS) 6690 6691=item VMS 6692 6693=item Win32 6694 6695=back 6696 6697=item Significant bug fixes 6698 6699=over 4 6700 6701=item <HANDLE> on empty files 6702 6703=item C<eval '...'> improvements 6704 6705=item All compilation errors are true errors 6706 6707=item Implicitly closed filehandles are safer 6708 6709=item Behavior of list slices is more consistent 6710 6711=item C<(\$)> prototype and C<$foo{a}> 6712 6713=item C<goto &sub> and AUTOLOAD 6714 6715=item C<-bareword> allowed under C<use integer> 6716 6717=item Failures in DESTROY() 6718 6719=item Locale bugs fixed 6720 6721=item Memory leaks 6722 6723=item Spurious subroutine stubs after failed subroutine calls 6724 6725=item Taint failures under C<-U> 6726 6727=item END blocks and the C<-c> switch 6728 6729=item Potential to leak DATA filehandles 6730 6731=back 6732 6733=item New or Changed Diagnostics 6734 6735"%s" variable %s masks earlier declaration in same %s, "my sub" not yet 6736implemented, "our" variable %s redeclared, '!' allowed only after types %s, 6737/ cannot take a count, / must be followed by a, A or Z, / must be followed 6738by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape 6739\\%c passed through, /%s/: Unrecognized escape \\%c in character class 6740passed through, /%s/ should probably be written as "%s", %s() called too 6741early to check prototype, %s argument is not a HASH or ARRAY element, %s 6742argument is not a HASH or ARRAY element or slice, %s argument is not a 6743subroutine name, %s package attribute may clash with future reserved word: 6744%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled 6745substitution pattern, Bad realloc() ignored, Bareword found in conditional, 6746Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector 6747size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check 6748filesystem of script "%s", Can't declare class for non-scalar %s in "%s", 6749Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, 6750Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't 6751remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't 6752weaken a nonreference, Character class [:%s:] unknown, Character class 6753syntax [%s] belongs inside character classes, Constant is not %s reference, 6754constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, 6755defined(%hash) is deprecated, Did not produce a valid header, (Did you mean 6756"local" instead of "our"?), Document contains no data, entering effective 6757%s failed, false [] range "%s" in regexp, Filehandle %s opened only for 6758output, flock() on closed filehandle %s, Global symbol "%s" requires 6759explicit package name, Hexadecimal number > 0xffffffff non-portable, 6760Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: 6761|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal 6762number of bits in vec, Integer overflow in %s number, Invalid %s attribute: 6763%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid 6764separator character %s in attribute list, Invalid separator character %s in 6765subroutine attribute list, leaving effective %s failed, Lvalue subs 6766returning %s not implemented yet, Method %s not permitted, Missing 6767%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", 6768No %s specified for -%c, No package name allowed for variable %s in "our", 6769No space allowed after -%c, no UTC offset information; assuming local time 6770is UTC, Octal number > 037777777777 non-portable, panic: del_backref, 6771panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing 6772around "%s" list, Possible unintended interpolation of %s in string, 6773Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" 6774instead, Premature end of script headers, Repeat count in pack overflows, 6775Repeat count in unpack overflows, realloc() of freed memory ignored, 6776Reference is already weak, setpgrp can't take arguments, Strange *+?{} on 6777zero-length expression, switching effective %s is not implemented, This 6778Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL 6779environ elements (%s=%s), Too late to run %s block, Unknown open() mode 6780'%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized 6781escape \\%c passed through, Unterminated attribute parameter in attribute 6782list, Unterminated attribute list, Unterminated attribute parameter in 6783subroutine attribute list, Unterminated subroutine attribute list, Value of 6784CLI symbol "%s" too long, Version number must be a constant number 6785 6786=item New tests 6787 6788=item Incompatible Changes 6789 6790=over 4 6791 6792=item Perl Source Incompatibilities 6793 6794CHECK is a new keyword, Treatment of list slices of undef has changed, 6795Format of $English::PERL_VERSION is different, Literals of the form 6796C<1.2.3> parse differently, Possibly changed pseudo-random number 6797generator, Hashing function for hash keys has changed, C<undef> fails on 6798read only values, Close-on-exec bit may be set on pipe and socket handles, 6799Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), 6800values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, 6801Text of some diagnostic output has changed, C<%@> has been removed, 6802Parenthesized not() behaves like a list operator, Semantics of bareword 6803prototype C<(*)> have changed, Semantics of bit operators may have changed 6804on 64-bit platforms, More builtins taint their results 6805 6806=item C Source Incompatibilities 6807 6808C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> 6809 6810=item Compatible C Source API Changes 6811 6812C<PATCHLEVEL> is now C<PERL_VERSION> 6813 6814=item Binary Incompatibilities 6815 6816=back 6817 6818=item Known Problems 6819 6820=over 4 6821 6822=item Localizing a tied hash element may leak memory 6823 6824=item Known test failures 6825 6826=item EBCDIC platforms not fully supported 6827 6828=item UNICOS/mk CC failures during Configure run 6829 6830=item Arrow operator and arrays 6831 6832=item Experimental features 6833 6834Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The 6835pseudo-hash data type, The Compiler suite, Internal implementation of file 6836globbing, The DB module, The regular expression code constructs: 6837 6838=back 6839 6840=item Obsolete Diagnostics 6841 6842Character class syntax [: :] is reserved for future extensions, Ill-formed 6843logical name |%s| in prime_env_iter, In string, @%s now must be written as 6844\@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" 6845to mean "${$}<digit>" is deprecated 6846 6847=item Reporting Bugs 6848 6849=item SEE ALSO 6850 6851=item HISTORY 6852 6853=back 6854 6855=head2 perl56delta - what's new for perl v5.6.0 6856 6857=over 4 6858 6859=item DESCRIPTION 6860 6861=item Core Enhancements 6862 6863=over 4 6864 6865=item Interpreter cloning, threads, and concurrency 6866 6867=item Lexically scoped warning categories 6868 6869=item Unicode and UTF-8 support 6870 6871=item Support for interpolating named characters 6872 6873=item "our" declarations 6874 6875=item Support for strings represented as a vector of ordinals 6876 6877=item Improved Perl version numbering system 6878 6879=item New syntax for declaring subroutine attributes 6880 6881=item File and directory handles can be autovivified 6882 6883=item open() with more than two arguments 6884 6885=item 64-bit support 6886 6887=item Large file support 6888 6889=item Long doubles 6890 6891=item "more bits" 6892 6893=item Enhanced support for sort() subroutines 6894 6895=item C<sort $coderef @foo> allowed 6896 6897=item File globbing implemented internally 6898 6899=item Support for CHECK blocks 6900 6901=item POSIX character class syntax [: :] supported 6902 6903=item Better pseudo-random number generator 6904 6905=item Improved C<qw//> operator 6906 6907=item Better worst-case behavior of hashes 6908 6909=item pack() format 'Z' supported 6910 6911=item pack() format modifier '!' supported 6912 6913=item pack() and unpack() support counted strings 6914 6915=item Comments in pack() templates 6916 6917=item Weak references 6918 6919=item Binary numbers supported 6920 6921=item Lvalue subroutines 6922 6923=item Some arrows may be omitted in calls through references 6924 6925=item Boolean assignment operators are legal lvalues 6926 6927=item exists() is supported on subroutine names 6928 6929=item exists() and delete() are supported on array elements 6930 6931=item Pseudo-hashes work better 6932 6933=item Automatic flushing of output buffers 6934 6935=item Better diagnostics on meaningless filehandle operations 6936 6937=item Where possible, buffered data discarded from duped input filehandle 6938 6939=item eof() has the same old magic as <> 6940 6941=item binmode() can be used to set :crlf and :raw modes 6942 6943=item C<-T> filetest recognizes UTF-8 encoded files as "text" 6944 6945=item system(), backticks and pipe open now reflect exec() failure 6946 6947=item Improved diagnostics 6948 6949=item Diagnostics follow STDERR 6950 6951=item More consistent close-on-exec behavior 6952 6953=item syswrite() ease-of-use 6954 6955=item Better syntax checks on parenthesized unary operators 6956 6957=item Bit operators support full native integer width 6958 6959=item Improved security features 6960 6961=item More functional bareword prototype (*) 6962 6963=item C<require> and C<do> may be overridden 6964 6965=item $^X variables may now have names longer than one character 6966 6967=item New variable $^C reflects C<-c> switch 6968 6969=item New variable $^V contains Perl version as a string 6970 6971=item Optional Y2K warnings 6972 6973=item Arrays now always interpolate into double-quoted strings 6974 6975=back 6976 6977=item Modules and Pragmata 6978 6979=over 4 6980 6981=item Modules 6982 6983attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, 6984DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, 6985Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, 6986File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, 6987Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, 6988podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, 6989pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, 6990Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters 6991 6992=item Pragmata 6993 6994=back 6995 6996=item Utility Changes 6997 6998=over 4 6999 7000=item dprofpp 7001 7002=item find2perl 7003 7004=item h2xs 7005 7006=item perlcc 7007 7008=item perldoc 7009 7010=item The Perl Debugger 7011 7012=back 7013 7014=item Improved Documentation 7015 7016perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, 7017perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, 7018perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, 7019perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod 7020 7021=item Performance enhancements 7022 7023=over 4 7024 7025=item Simple sort() using { $a <=> $b } and the like are optimized 7026 7027=item Optimized assignments to lexical variables 7028 7029=item Faster subroutine calls 7030 7031=item delete(), each(), values() and hash iteration are faster 7032 7033=back 7034 7035=item Installation and Configuration Improvements 7036 7037=over 4 7038 7039=item -Dusethreads means something different 7040 7041=item New Configure flags 7042 7043=item Threadedness and 64-bitness now more daring 7044 7045=item Long Doubles 7046 7047=item -Dusemorebits 7048 7049=item -Duselargefiles 7050 7051=item installusrbinperl 7052 7053=item SOCKS support 7054 7055=item C<-A> flag 7056 7057=item Enhanced Installation Directories 7058 7059=back 7060 7061=item Platform specific changes 7062 7063=over 4 7064 7065=item Supported platforms 7066 7067=item DOS 7068 7069=item OS390 (OpenEdition MVS) 7070 7071=item VMS 7072 7073=item Win32 7074 7075=back 7076 7077=item Significant bug fixes 7078 7079=over 4 7080 7081=item <HANDLE> on empty files 7082 7083=item C<eval '...'> improvements 7084 7085=item All compilation errors are true errors 7086 7087=item Implicitly closed filehandles are safer 7088 7089=item Behavior of list slices is more consistent 7090 7091=item C<(\$)> prototype and C<$foo{a}> 7092 7093=item C<goto &sub> and AUTOLOAD 7094 7095=item C<-bareword> allowed under C<use integer> 7096 7097=item Failures in DESTROY() 7098 7099=item Locale bugs fixed 7100 7101=item Memory leaks 7102 7103=item Spurious subroutine stubs after failed subroutine calls 7104 7105=item Taint failures under C<-U> 7106 7107=item END blocks and the C<-c> switch 7108 7109=item Potential to leak DATA filehandles 7110 7111=back 7112 7113=item New or Changed Diagnostics 7114 7115"%s" variable %s masks earlier declaration in same %s, "my sub" not yet 7116implemented, "our" variable %s redeclared, '!' allowed only after types %s, 7117/ cannot take a count, / must be followed by a, A or Z, / must be followed 7118by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape 7119\\%c passed through, /%s/: Unrecognized escape \\%c in character class 7120passed through, /%s/ should probably be written as "%s", %s() called too 7121early to check prototype, %s argument is not a HASH or ARRAY element, %s 7122argument is not a HASH or ARRAY element or slice, %s argument is not a 7123subroutine name, %s package attribute may clash with future reserved word: 7124%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled 7125substitution pattern, Bad realloc() ignored, Bareword found in conditional, 7126Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector 7127size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check 7128filesystem of script "%s", Can't declare class for non-scalar %s in "%s", 7129Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, 7130Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't 7131remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't 7132weaken a nonreference, Character class [:%s:] unknown, Character class 7133syntax [%s] belongs inside character classes, Constant is not %s reference, 7134constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, 7135defined(%hash) is deprecated, Did not produce a valid header, (Did you mean 7136"local" instead of "our"?), Document contains no data, entering effective 7137%s failed, false [] range "%s" in regexp, Filehandle %s opened only for 7138output, flock() on closed filehandle %s, Global symbol "%s" requires 7139explicit package name, Hexadecimal number > 0xffffffff non-portable, 7140Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: 7141|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal 7142number of bits in vec, Integer overflow in %s number, Invalid %s attribute: 7143%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid 7144separator character %s in attribute list, Invalid separator character %s in 7145subroutine attribute list, leaving effective %s failed, Lvalue subs 7146returning %s not implemented yet, Method %s not permitted, Missing 7147%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", 7148No %s specified for -%c, No package name allowed for variable %s in "our", 7149No space allowed after -%c, no UTC offset information; assuming local time 7150is UTC, Octal number > 037777777777 non-portable, panic: del_backref, 7151panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing 7152around "%s" list, Possible unintended interpolation of %s in string, 7153Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" 7154instead, Premature end of script headers, Repeat count in pack overflows, 7155Repeat count in unpack overflows, realloc() of freed memory ignored, 7156Reference is already weak, setpgrp can't take arguments, Strange *+?{} on 7157zero-length expression, switching effective %s is not implemented, This 7158Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL 7159environ elements (%s=%s), Too late to run %s block, Unknown open() mode 7160'%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized 7161escape \\%c passed through, Unterminated attribute parameter in attribute 7162list, Unterminated attribute list, Unterminated attribute parameter in 7163subroutine attribute list, Unterminated subroutine attribute list, Value of 7164CLI symbol "%s" too long, Version number must be a constant number 7165 7166=item New tests 7167 7168=item Incompatible Changes 7169 7170=over 4 7171 7172=item Perl Source Incompatibilities 7173 7174CHECK is a new keyword, Treatment of list slices of undef has changed, 7175Format of $English::PERL_VERSION is different, Literals of the form 7176C<1.2.3> parse differently, Possibly changed pseudo-random number 7177generator, Hashing function for hash keys has changed, C<undef> fails on 7178read only values, Close-on-exec bit may be set on pipe and socket handles, 7179Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), 7180values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, 7181Text of some diagnostic output has changed, C<%@> has been removed, 7182Parenthesized not() behaves like a list operator, Semantics of bareword 7183prototype C<(*)> have changed, Semantics of bit operators may have changed 7184on 64-bit platforms, More builtins taint their results 7185 7186=item C Source Incompatibilities 7187 7188C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> 7189 7190=item Compatible C Source API Changes 7191 7192C<PATCHLEVEL> is now C<PERL_VERSION> 7193 7194=item Binary Incompatibilities 7195 7196=back 7197 7198=item Known Problems 7199 7200=over 4 7201 7202=item Thread test failures 7203 7204=item EBCDIC platforms not supported 7205 7206=item In 64-bit HP-UX the lib/io_multihomed test may hang 7207 7208=item NEXTSTEP 3.3 POSIX test failure 7209 7210=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with 7211gcc 7212 7213=item UNICOS/mk CC failures during Configure run 7214 7215=item Arrow operator and arrays 7216 7217=item Experimental features 7218 7219Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The 7220pseudo-hash data type, The Compiler suite, Internal implementation of file 7221globbing, The DB module, The regular expression code constructs: 7222 7223=back 7224 7225=item Obsolete Diagnostics 7226 7227Character class syntax [: :] is reserved for future extensions, Ill-formed 7228logical name |%s| in prime_env_iter, In string, @%s now must be written as 7229\@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" 7230to mean "${$}<digit>" is deprecated 7231 7232=item Reporting Bugs 7233 7234=item SEE ALSO 7235 7236=item HISTORY 7237 7238=back 7239 7240=head2 perl5005delta - what's new for perl5.005 7241 7242=over 4 7243 7244=item DESCRIPTION 7245 7246=item About the new versioning system 7247 7248=item Incompatible Changes 7249 7250=over 4 7251 7252=item WARNING: This version is not binary compatible with Perl 5.004. 7253 7254=item Default installation structure has changed 7255 7256=item Perl Source Compatibility 7257 7258=item C Source Compatibility 7259 7260=item Binary Compatibility 7261 7262=item Security fixes may affect compatibility 7263 7264=item Relaxed new mandatory warnings introduced in 5.004 7265 7266=item Licensing 7267 7268=back 7269 7270=item Core Changes 7271 7272=over 4 7273 7274=item Threads 7275 7276=item Compiler 7277 7278=item Regular Expressions 7279 7280Many new and improved optimizations, Many bug fixes, New regular expression 7281constructs, New operator for precompiled regular expressions, Other 7282improvements, Incompatible changes 7283 7284=item Improved malloc() 7285 7286=item Quicksort is internally implemented 7287 7288=item Reliable signals 7289 7290=item Reliable stack pointers 7291 7292=item More generous treatment of carriage returns 7293 7294=item Memory leaks 7295 7296=item Better support for multiple interpreters 7297 7298=item Behavior of local() on array and hash elements is now well-defined 7299 7300=item C<%!> is transparently tied to the L<Errno> module 7301 7302=item Pseudo-hashes are supported 7303 7304=item C<EXPR foreach EXPR> is supported 7305 7306=item Keywords can be globally overridden 7307 7308=item C<$^E> is meaningful on Win32 7309 7310=item C<foreach (1..1000000)> optimized 7311 7312=item C<Foo::> can be used as implicitly quoted package name 7313 7314=item C<exists $Foo::{Bar::}> tests existence of a package 7315 7316=item Better locale support 7317 7318=item Experimental support for 64-bit platforms 7319 7320=item prototype() returns useful results on builtins 7321 7322=item Extended support for exception handling 7323 7324=item Re-blessing in DESTROY() supported for chaining DESTROY() methods 7325 7326=item All C<printf> format conversions are handled internally 7327 7328=item New C<INIT> keyword 7329 7330=item New C<lock> keyword 7331 7332=item New C<qr//> operator 7333 7334=item C<our> is now a reserved word 7335 7336=item Tied arrays are now fully supported 7337 7338=item Tied handles support is better 7339 7340=item 4th argument to substr 7341 7342=item Negative LENGTH argument to splice 7343 7344=item Magic lvalues are now more magical 7345 7346=item <> now reads in records 7347 7348=back 7349 7350=item Supported Platforms 7351 7352=over 4 7353 7354=item New Platforms 7355 7356=item Changes in existing support 7357 7358=back 7359 7360=item Modules and Pragmata 7361 7362=over 4 7363 7364=item New Modules 7365 7366B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, 7367ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, 7368Thread, attrs, fields, re 7369 7370=item Changes in existing modules 7371 7372Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, 7373MakeMaker, CPAN, Cwd 7374 7375=back 7376 7377=item Utility Changes 7378 7379=item Documentation Changes 7380 7381=item New Diagnostics 7382 7383Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index 7384while coercing array into hash, Bareword "%s" refers to nonexistent 7385package, Can't call method "%s" on an undefined value, Can't check 7386filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't 7387goto subroutine from an eval-string, Can't localize pseudo-hash element, 7388Can't use %%! because Errno.pm is not available, Cannot find an opnumber 7389for "%s", Character class syntax [. .] is reserved for future extensions, 7390Character class syntax [: :] is reserved for future extensions, Character 7391class syntax [= =] is reserved for future extensions, %s: Eval-group in 7392insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: 7393Eval-group not allowed at run time, Explicit blessing to '' (assuming 7394package main), Illegal hex digit ignored, No such array field, No such 7395field "%s" in variable %s of type %s, Out of memory during ridiculously 7396large request, Range iterator outside integer range, Recursive inheritance 7397detected while looking for method '%s' %s, Reference found where even-sized 7398list expected, Undefined value assigned to typeglob, Use of reserved word 7399"%s" is deprecated, perl: warning: Setting locale failed 7400 7401=item Obsolete Diagnostics 7402 7403Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open 7404temporary file, regexp too big 7405 7406=item Configuration Changes 7407 7408=item BUGS 7409 7410=item SEE ALSO 7411 7412=item HISTORY 7413 7414=back 7415 7416=head2 perl5004delta - what's new for perl5.004 7417 7418=over 4 7419 7420=item DESCRIPTION 7421 7422=item Supported Environments 7423 7424=item Core Changes 7425 7426=over 4 7427 7428=item List assignment to %ENV works 7429 7430=item Change to "Can't locate Foo.pm in @INC" error 7431 7432=item Compilation option: Binary compatibility with 5.003 7433 7434=item $PERL5OPT environment variable 7435 7436=item Limitations on B<-M>, B<-m>, and B<-T> options 7437 7438=item More precise warnings 7439 7440=item Deprecated: Inherited C<AUTOLOAD> for non-methods 7441 7442=item Previously deprecated %OVERLOAD is no longer usable 7443 7444=item Subroutine arguments created only when they're modified 7445 7446=item Group vector changeable with C<$)> 7447 7448=item Fixed parsing of $$<digit>, &$<digit>, etc. 7449 7450=item Fixed localization of $<digit>, $&, etc. 7451 7452=item No resetting of $. on implicit close 7453 7454=item C<wantarray> may return undef 7455 7456=item C<eval EXPR> determines value of EXPR in scalar context 7457 7458=item Changes to tainting checks 7459 7460No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No 7461spawning if tainted $TERM doesn't look like a terminal name 7462 7463=item New Opcode module and revised Safe module 7464 7465=item Embedding improvements 7466 7467=item Internal change: FileHandle class based on IO::* classes 7468 7469=item Internal change: PerlIO abstraction interface 7470 7471=item New and changed syntax 7472 7473$coderef->(PARAMS) 7474 7475=item New and changed builtin constants 7476 7477__PACKAGE__ 7478 7479=item New and changed builtin variables 7480 7481$^E, $^H, $^M 7482 7483=item New and changed builtin functions 7484 7485delete on slices, flock, printf and sprintf, keys as an lvalue, my() in 7486Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module 7487VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not 7488reset search position on failure, C<m//x> ignores whitespace before ?*+{}, 7489nested C<sub{}> closures work now, formats work right on changing lexicals 7490 7491=item New builtin methods 7492 7493isa(CLASS), can(METHOD), VERSION( [NEED] ) 7494 7495=item TIEHANDLE now supported 7496 7497TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this 7498LIST, READLINE this, GETC this, DESTROY this 7499 7500=item Malloc enhancements 7501 7502-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE 7503 7504=item Miscellaneous efficiency enhancements 7505 7506=back 7507 7508=item Support for More Operating Systems 7509 7510=over 4 7511 7512=item Win32 7513 7514=item Plan 9 7515 7516=item QNX 7517 7518=item AmigaOS 7519 7520=back 7521 7522=item Pragmata 7523 7524use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use 7525constant NAME => VALUE, use locale, use ops, use vmsish 7526 7527=item Modules 7528 7529=over 4 7530 7531=item Required Updates 7532 7533=item Installation directories 7534 7535=item Module information summary 7536 7537=item Fcntl 7538 7539=item IO 7540 7541=item Math::Complex 7542 7543=item Math::Trig 7544 7545=item DB_File 7546 7547=item Net::Ping 7548 7549=item Object-oriented overrides for builtin operators 7550 7551=back 7552 7553=item Utility Changes 7554 7555=over 4 7556 7557=item pod2html 7558 7559Sends converted HTML to standard output 7560 7561=item xsubpp 7562 7563C<void> XSUBs now default to returning nothing 7564 7565=back 7566 7567=item C Language API Changes 7568 7569C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for 7570manipulating hashes 7571 7572=item Documentation Changes 7573 7574L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, 7575L<perlmodlib>, L<perldebug>, L<perlsec> 7576 7577=item New Diagnostics 7578 7579"my" variable %s masks earlier declaration in same scope, %s argument is 7580not a HASH element or slice, Allocation too large: %lx, Allocation too 7581large, Applying %s to %s will act on scalar(%s), Attempt to free 7582nonexistent shared string, Attempt to use reference as lvalue in substr, 7583Bareword "%s" refers to nonexistent package, Can't redefine active sort 7584subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in 7585use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant 7586subroutine %s redefined, Constant subroutine %s undefined, Copy method did 7587not return a reference, Died, Exiting pseudo-block via %s, Identifier too 7588long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: 7589%s, Integer overflow in hex number, Integer overflow in octal number, 7590internal error: glob failed, Invalid conversion in %s: "%s", Invalid type 7591in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: 7592possible typo, Null picture in formline, Offset outside string, Out of 7593memory!, Out of memory during request for %s, panic: frexp, Possible 7594attempt to put comments in qw() list, Possible attempt to separate words 7595with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found 7596while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" 7597option, untie attempted while %d inner references still exist, Unrecognized 7598character %s, Unsupported function fork, Use of "$$<digit>" to mean 7599"${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), 7600Variable "%s" may be unavailable, Variable "%s" will not stay shared, 7601Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, 7602Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too 7603long, Process terminated by SIG%s 7604 7605=item BUGS 7606 7607=item SEE ALSO 7608 7609=item HISTORY 7610 7611=back 7612 7613=head2 perlartistic - the Perl Artistic License 7614 7615=over 4 7616 7617=item SYNOPSIS 7618 7619=item DESCRIPTION 7620 7621=item The "Artistic License" 7622 7623=over 4 7624 7625=item Preamble 7626 7627=item Definitions 7628 7629"Package", "Standard Version", "Copyright Holder", "You", "Reasonable 7630copying fee", "Freely Available" 7631 7632=item Conditions 7633 7634a), b), c), d), a), b), c), d) 7635 7636=back 7637 7638=back 7639 7640=head2 perlgpl - the GNU General Public License, version 2 7641 7642=over 4 7643 7644=item SYNOPSIS 7645 7646=back 7647 7648=over 4 7649 7650=item DESCRIPTION 7651 7652=item GNU GENERAL PUBLIC LICENSE 7653 7654=back 7655 7656=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems 7657 7658=over 4 7659 7660=item DESCRIPTION 7661 7662=over 4 7663 7664=item Compiling Perl 5 on AIX 7665 7666=item OS level 7667 7668=item Building Dynamic Extensions on AIX 7669 7670=item The IBM ANSI C Compiler 7671 7672=item The usenm option 7673 7674=item Using GNU's gcc for building perl 7675 7676=item Using Large Files with Perl 7677 7678=item Threaded Perl 7679 7680=item 64-bit Perl 7681 7682=item AIX 4.2 and extensions using C++ with statics 7683 7684=back 7685 7686=item AUTHOR 7687 7688=item DATE 7689 7690=back 7691 7692=head2 perlamiga - Perl under Amiga OS 7693 7694=over 4 7695 7696=item NOTE 7697 7698=item SYNOPSIS 7699 7700=back 7701 7702=over 4 7703 7704=item DESCRIPTION 7705 7706=over 4 7707 7708=item Prerequisites for Compiling Perl on AmigaOS 7709 7710B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> 7711 7712=item Starting Perl programs under AmigaOS 7713 7714=item Shortcomings of Perl under AmigaOS 7715 7716=back 7717 7718=item INSTALLATION 7719 7720=item Accessing documentation 7721 7722=over 4 7723 7724=item Manpages for Perl on AmigaOS 7725 7726=item Perl HTML Documentation on AmigaOS 7727 7728=item Perl GNU Info Files on AmigaOS 7729 7730=item Perl LaTeX Documentation on AmigaOS 7731 7732=back 7733 7734=item BUILDING PERL ON AMIGAOS 7735 7736=over 4 7737 7738=item Build Prerequisites for Perl on AmigaOS 7739 7740=item Getting the Perl Source for AmigaOS 7741 7742=item Making Perl on AmigaOS 7743 7744=item Testing Perl on AmigaOS 7745 7746=item Installing the built Perl on AmigaOS 7747 7748=back 7749 7750=item PERL 5.8.0 BROKEN IN AMIGAOS 7751 7752=item AUTHORS 7753 7754=item SEE ALSO 7755 7756=back 7757 7758=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS 7759 7760=over 4 7761 7762=item DESCRIPTION 7763 7764=item AUTHOR 7765 7766=back 7767 7768=head2 perlbeos, README.beos - Perl version 5 on BeOS 7769 7770=over 4 7771 7772=item DESCRIPTION 7773 7774=over 4 7775 7776=item General Issues with Perl on BeOS 7777 7778=item BeOS Release-specific Notes 7779 7780R4 x86, R4 PPC 7781 7782=item Contact Information 7783 7784=item Update 2002-05-30 7785 7786=back 7787 7788=back 7789 7790=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. 7791 7792=over 4 7793 7794=item SYNOPSIS 7795 7796=item DESCRIPTION 7797 7798=over 4 7799 7800=item gzip on BS2000 7801 7802=item bison on BS2000 7803 7804=item Unpacking Perl Distribution on BS2000 7805 7806=item Compiling Perl on BS2000 7807 7808=item Testing Perl on BS2000 7809 7810=item Installing Perl on BS2000 7811 7812=item Using Perl in the Posix-Shell of BS2000 7813 7814=item Using Perl in "native" BS2000 7815 7816=item Floating point anomalies on BS2000 7817 7818=item Using PerlIO and different encodings on ASCII and EBCDIC partitions 7819 7820=back 7821 7822=item AUTHORS 7823 7824=item SEE ALSO 7825 7826=over 4 7827 7828=item Mailing list 7829 7830=back 7831 7832=item HISTORY 7833 7834=back 7835 7836=head2 perlce - Perl for WinCE 7837 7838=over 4 7839 7840=item DESCRIPTION 7841 7842=item BUILD 7843 7844=over 4 7845 7846=item Tools & SDK 7847 7848Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's 7849celib-sources, Rainer Keuchel's console-sources 7850 7851=item Make 7852 7853go to ./wince subdirectory, edit file compile.bat, run compile.bat, run 7854 compile.bat dist 7855 7856=back 7857 7858=item ACKNOWLEDGEMENTS 7859 7860=item AUTHORS 7861 7862=back 7863 7864=head2 perlcygwin, README.cygwin - Perl for Cygwin 7865 7866=over 4 7867 7868=item SYNOPSIS 7869 7870=item PREREQUISITES FOR COMPILING PERL ON CYGWIN 7871 7872=over 4 7873 7874=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) 7875 7876=item Cygwin Configuration 7877 7878C<PATH>, I<nroff>, Permissions 7879 7880=back 7881 7882=item CONFIGURE PERL ON CYGWIN 7883 7884=over 4 7885 7886=item Stripping Perl Binaries on Cygwin 7887 7888=item Optional Libraries for Perl on Cygwin 7889 7890C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), 7891C<-lcygipc> (C<use IPC::SysV>), C<-lutil> 7892 7893=item Configure-time Options for Perl on Cygwin 7894 7895C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, 7896C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, 7897C<-Dmksymlinks> 7898 7899=item Suspicious Warnings on Cygwin 7900 7901I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines 7902 7903=back 7904 7905=item MAKE ON CYGWIN 7906 7907=over 4 7908 7909=item Errors on Cygwin 7910 7911=item ld2 on Cygwin 7912 7913=back 7914 7915=item TEST ON CYGWIN 7916 7917=over 4 7918 7919=item File Permissions on Cygwin 7920 7921=item NDBM_File and ODBM_File do not work on FAT filesystems 7922 7923=item C<fork()> failures in io_* tests 7924 7925=item Script Portability on Cygwin 7926 7927Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous 7928 7929=back 7930 7931=item INSTALL PERL ON CYGWIN 7932 7933=item MANIFEST ON CYGWIN 7934 7935Documentation, Build, Configure, Make, Install, Tests, Compiled Perl 7936Source, Compiled Module Source, Perl Modules/Scripts 7937 7938=item BUGS ON CYGWIN 7939 7940=item AUTHORS 7941 7942=item HISTORY 7943 7944=back 7945 7946=head2 perldgux - Perl under DG/UX. 7947 7948=over 4 7949 7950=item SYNOPSIS 7951 7952=back 7953 7954=over 4 7955 7956=item DESCRIPTION 7957 7958=item BUILDING PERL ON DG/UX 7959 7960=over 4 7961 7962=item Non-threaded Perl on DG/UX 7963 7964=item Threaded Perl on DG/UX 7965 7966=item Testing Perl on DG/UX 7967 7968=item Installing the built perl on DG/UX 7969 7970=back 7971 7972=item AUTHOR 7973 7974=item SEE ALSO 7975 7976=back 7977 7978=head2 perldos - Perl under DOS, W31, W95. 7979 7980=over 4 7981 7982=item SYNOPSIS 7983 7984=item DESCRIPTION 7985 7986=over 4 7987 7988=item Prerequisites for Compiling Perl on DOS 7989 7990DJGPP, Pthreads 7991 7992=item Shortcomings of Perl under DOS 7993 7994=item Building Perl on DOS 7995 7996=item Testing Perl on DOS 7997 7998=item Installation of Perl on DOS 7999 8000=back 8001 8002=item BUILDING AND INSTALLING MODULES ON DOS 8003 8004=over 4 8005 8006=item Building Prerequisites for Perl on DOS 8007 8008=item Unpacking CPAN Modules on DOS 8009 8010=item Building Non-XS Modules on DOS 8011 8012=item Building XS Modules on DOS 8013 8014=back 8015 8016=item AUTHOR 8017 8018=item SEE ALSO 8019 8020=back 8021 8022=head2 perlepoc, README.epoc - Perl for EPOC 8023 8024=over 4 8025 8026=item SYNOPSIS 8027 8028=item INTRODUCTION 8029 8030=item INSTALLING PERL ON EPOC 8031 8032=item STARTING PERL ON EPOC 8033 8034=over 4 8035 8036=item Editors on Epoc 8037 8038=item Features of Perl on Epoc 8039 8040=item Restrictions of Perl on Epoc 8041 8042=item Compiling Perl 5 on the EPOC cross compiling environment 8043 8044=back 8045 8046=item SUPPORT STATUS OF PERL ON EPOC 8047 8048=item AUTHOR 8049 8050=item LAST UPDATE 8051 8052=back 8053 8054=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems 8055 8056=over 4 8057 8058=item DESCRIPTION 8059 8060=over 4 8061 8062=item FreeBSD core dumps from readdir_r with ithreads 8063 8064=item $^X doesn't always contain a full path in FreeBSD 8065 8066=item Perl will no longer be part of "base FreeBSD" 8067 8068=back 8069 8070=item AUTHOR 8071 8072=back 8073 8074=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix 8075(HP-UX) systems 8076 8077=over 4 8078 8079=item DESCRIPTION 8080 8081=over 4 8082 8083=item Using perl as shipped with HP-UX 8084 8085=item Using perl from HP's porting centre 8086 8087=item Compiling Perl 5 on HP-UX 8088 8089=item PA-RISC 8090 8091=item PA-RISC 1.0 8092 8093=item PA-RISC 1.1 8094 8095=item PA-RISC 2.0 8096 8097=item Itanium 8098 8099=item Portability Between PA-RISC Versions 8100 8101=item Itanium Processor Family and HP-UX 8102 8103=item Building Dynamic Extensions on HP-UX 8104 8105=item The HP ANSI C Compiler 8106 8107=item The GNU C Compiler 8108 8109=item Using Large Files with Perl on HP-UX 8110 8111=item Threaded Perl on HP-UX 8112 8113=item 64-bit Perl on HP-UX 8114 8115=item Oracle on HP-UX 8116 8117=item GDBM and Threads on HP-UX 8118 8119=item NFS filesystems and utime(2) on HP-UX 8120 8121=item perl -P and // and HP-UX 8122 8123=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl 8124 8125=back 8126 8127=item nss_delete core dump from op/pwent or op/grent 8128 8129=item AUTHOR 8130 8131=item DATE 8132 8133=back 8134 8135=head2 perlhurd, README.hurd - Perl version 5 on Hurd 8136 8137=over 4 8138 8139=item DESCRIPTION 8140 8141=over 4 8142 8143=item Known Problems with Perl on Hurd 8144 8145=back 8146 8147=item AUTHOR 8148 8149=back 8150 8151=head2 perlirix, README.irix - Perl version 5 on Irix systems 8152 8153=over 4 8154 8155=item DESCRIPTION 8156 8157=over 4 8158 8159=item Building 32-bit Perl in Irix 8160 8161=item Building 64-bit Perl in Irix 8162 8163=item About Compiler Versions of Irix 8164 8165=item Linker Problems in Irix 8166 8167=item Malloc in Irix 8168 8169=item Building with threads in Irix 8170 8171=item Irix 5.3 8172 8173=back 8174 8175=item AUTHOR 8176 8177=back 8178 8179=head2 perlmachten, README.machten - Perl version 5 on Power MachTen 8180systems 8181 8182=over 4 8183 8184=item DESCRIPTION 8185 8186=over 4 8187 8188=item Perl version 5.8.x and greater not supported 8189 8190=item Compiling Perl 5.6.x on MachTen 8191 8192=item Failures during C<make test> on MachTen 8193 8194op/lexassign.t, pragma/warnings.t 8195 8196=item Building external modules on MachTen 8197 8198=back 8199 8200=item AUTHOR 8201 8202=item DATE 8203 8204=back 8205 8206=head2 perlmacos, README.macos - Perl under Mac OS (Classic) 8207 8208=over 4 8209 8210=item SYNOPSIS 8211 8212=item DESCRIPTION 8213 8214=item AUTHOR 8215 8216=item DATE 8217 8218=back 8219 8220=head2 perlmacosx, README.macosx - Perl under Mac OS X 8221 8222=over 4 8223 8224=item SYNOPSIS 8225 8226=item DESCRIPTION 8227 8228=over 4 8229 8230=item Installation Prefix 8231 8232=item libperl and Prebinding 8233 8234=item Updating Panther 8235 8236=item Known problems 8237 8238=item MacPerl 8239 8240=item Carbon 8241 8242=item Cocoa 8243 8244=back 8245 8246=item Starting From Scratch 8247 8248=item AUTHOR 8249 8250=item DATE 8251 8252=back 8253 8254=head2 perlmint, README.mint - Perl version 5 on Atari MiNT 8255 8256=over 4 8257 8258=item DESCRIPTION 8259 8260=item Known problems with Perl on MiNT 8261 8262=item AUTHOR 8263 8264=back 8265 8266=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE 8267 8268=over 4 8269 8270=item SYNOPSIS 8271 8272=item NOTE 8273 8274=item Binary distribution from HP 8275 8276=item What's New in Perl for MPE/iX 8277 8278=item Welcome to Perl/iX 8279 8280=item System Requirements for Perl/iX 8281 8282=item How to Obtain Perl/iX 8283 8284=item Perl/iX Distribution Contents Highlights 8285 8286README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, 8287public_html/feedback.cgi, src/perl-5.6.0-mpe 8288 8289=item How to Compile Perl/iX 8290 8291 4, 6 8292 8293=item Getting Started with Perl/iX 8294 8295=item MPE/iX Implementation Considerations 8296 8297=item Known Perl/iX Bugs Under Investigation 8298 8299=item Perl/iX To-Do List 8300 8301=item Perl/iX Change History 8302 8303=item AUTHOR 8304 8305=back 8306 8307=head2 perlnetware - Perl for NetWare 8308 8309=over 4 8310 8311=item DESCRIPTION 8312 8313=item BUILD 8314 8315=over 4 8316 8317=item Tools & SDK 8318 8319=item Setup 8320 8321SetNWBld.bat, Buildtype.bat 8322 8323=item Make 8324 8325=item Interpreter 8326 8327=item Extensions 8328 8329=back 8330 8331=item INSTALL 8332 8333=item BUILD NEW EXTENSIONS 8334 8335=item ACKNOWLEDGEMENTS 8336 8337=item AUTHORS 8338 8339=item DATE 8340 8341=back 8342 8343=head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. 8344 8345=over 4 8346 8347=item SYNOPSIS 8348 8349=back 8350 8351=over 4 8352 8353=item DESCRIPTION 8354 8355=over 4 8356 8357=item Target 8358 8359=item Other OSes 8360 8361=item Prerequisites 8362 8363EMX, RSX, HPFS, pdksh 8364 8365=item Starting Perl programs under OS/2 (and DOS and...) 8366 8367=item Starting OS/2 (and DOS) programs under Perl 8368 8369=back 8370 8371=item Frequently asked questions 8372 8373=over 4 8374 8375=item "It does not work" 8376 8377=item I cannot run external programs 8378 8379=item I cannot embed perl into my program, or use F<perl.dll> from my 8380program. 8381 8382Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use 8383L<ExtUtils::Embed>? 8384 8385=item C<``> and pipe-C<open> do not work under DOS. 8386 8387=item Cannot start C<find.exe "pattern" file> 8388 8389=back 8390 8391=item INSTALLATION 8392 8393=over 4 8394 8395=item Automatic binary installation 8396 8397C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> 8398 8399=item Manual binary installation 8400 8401Perl VIO and PM executables (dynamically linked), Perl_ VIO executable 8402(statically linked), Executables for Perl utilities, Main Perl library, 8403Additional Perl modules, Tools to compile Perl modules, Manpages for Perl 8404and utilities, Manpages for Perl modules, Source for Perl documentation, 8405Perl manual in F<.INF> format, Pdksh 8406 8407=item B<Warning> 8408 8409=back 8410 8411=item Accessing documentation 8412 8413=over 4 8414 8415=item OS/2 F<.INF> file 8416 8417=item Plain text 8418 8419=item Manpages 8420 8421=item HTML 8422 8423=item GNU C<info> files 8424 8425=item F<PDF> files 8426 8427=item C<LaTeX> docs 8428 8429=back 8430 8431=item BUILD 8432 8433=over 4 8434 8435=item The short story 8436 8437=item Prerequisites 8438 8439=item Getting perl source 8440 8441=item Application of the patches 8442 8443=item Hand-editing 8444 8445=item Making 8446 8447=item Testing 8448 8449A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, 8450F<op/stat.t> 8451 8452=item Installing the built perl 8453 8454=item C<a.out>-style build 8455 8456=back 8457 8458=item Building a binary distribution 8459 8460=item Building custom F<.EXE> files 8461 8462=over 4 8463 8464=item Making executables with a custom collection of statically loaded 8465extensions 8466 8467=item Making executables with a custom search-paths 8468 8469=back 8470 8471=item Build FAQ 8472 8473=over 4 8474 8475=item Some C</> became C<\> in pdksh. 8476 8477=item C<'errno'> - unresolved external 8478 8479=item Problems with tr or sed 8480 8481=item Some problem (forget which ;-) 8482 8483=item Library ... not found 8484 8485=item Segfault in make 8486 8487=item op/sprintf test failure 8488 8489=back 8490 8491=item Specific (mis)features of OS/2 port 8492 8493=over 4 8494 8495=item C<setpriority>, C<getpriority> 8496 8497=item C<system()> 8498 8499=item C<extproc> on the first line 8500 8501=item Additional modules: 8502 8503=item Prebuilt methods: 8504 8505C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, 8506 C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, 8507C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, 8508C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, 8509C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, 8510C<Cwd::extLibpath_set( path [, type ] )>, 8511C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, 8512OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, 8513C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, 8514C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, 8515OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>, 8516C<OS2::DLLname([how [, \&xsub]])> 8517 8518=item Prebuilt variables: 8519 8520$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, 8521$OS2::nsyserror 8522 8523=item Misfeatures 8524 8525=item Modifications 8526 8527C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, 8528C<flock> 8529 8530=item Identifying DLLs 8531 8532=item Centralized management of resources 8533 8534C<HAB>, C<HMQ>, Treating errors reported by OS/2 API, 8535C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>, 8536C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>, 8537C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs 8538 8539=back 8540 8541=item Perl flavors 8542 8543=over 4 8544 8545=item F<perl.exe> 8546 8547=item F<perl_.exe> 8548 8549=item F<perl__.exe> 8550 8551=item F<perl___.exe> 8552 8553=item Why strange names? 8554 8555=item Why dynamic linking? 8556 8557=item Why chimera build? 8558 8559=back 8560 8561=item ENVIRONMENT 8562 8563=over 4 8564 8565=item C<PERLLIB_PREFIX> 8566 8567=item C<PERL_BADLANG> 8568 8569=item C<PERL_BADFREE> 8570 8571=item C<PERL_SH_DIR> 8572 8573=item C<USE_PERL_FLOCK> 8574 8575=item C<TMP> or C<TEMP> 8576 8577=back 8578 8579=item Evolution 8580 8581=over 4 8582 8583=item Text-mode filehandles 8584 8585=item Priorities 8586 8587=item DLL name mangling: pre 5.6.2 8588 8589=item DLL name mangling: 5.6.2 and beyond 8590 8591Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from 8592C<LIBPATH> 8593 8594=item DLL forwarder generation 8595 8596=item Threading 8597 8598=item Calls to external programs 8599 8600=item Memory allocation 8601 8602=item Threads 8603 8604C<COND_WAIT>, F<os2.c> 8605 8606=back 8607 8608=item BUGS 8609 8610=back 8611 8612=over 4 8613 8614=item AUTHOR 8615 8616=item SEE ALSO 8617 8618=back 8619 8620=head2 perlos390, README.os390 - building and installing Perl for OS/390 8621and z/OS 8622 8623=over 4 8624 8625=item SYNOPSIS 8626 8627=item DESCRIPTION 8628 8629=over 4 8630 8631=item Tools 8632 8633=item Unpacking Perl distribution on OS/390 8634 8635=item Setup and utilities for Perl on OS/390 8636 8637=item Configure Perl on OS/390 8638 8639=item Build, Test, Install Perl on OS/390 8640 8641=item Build Anomalies with Perl on OS/390 8642 8643=item Testing Anomalies with Perl on OS/390 8644 8645=item Installation Anomalies with Perl on OS/390 8646 8647=item Usage Hints for Perl on OS/390 8648 8649=item Floating Point Anomalies with Perl on OS/390 8650 8651=item Modules and Extensions for Perl on OS/390 8652 8653=back 8654 8655=item AUTHORS 8656 8657=item SEE ALSO 8658 8659=over 4 8660 8661=item Mailing list for Perl on OS/390 8662 8663=back 8664 8665=item HISTORY 8666 8667=back 8668 8669=head2 perlos400, README.os400 - Perl version 5 on OS/400 8670 8671=over 4 8672 8673=item DESCRIPTION 8674 8675=over 4 8676 8677=item Compiling Perl for OS/400 PASE 8678 8679=item Installing Perl in OS/400 PASE 8680 8681=item Using Perl in OS/400 PASE 8682 8683=item Known Problems 8684 8685=item Perl on ILE 8686 8687=back 8688 8689=item AUTHORS 8690 8691=back 8692 8693=head2 perlplan9 - Plan 9-specific documentation for Perl 8694 8695=over 4 8696 8697=item DESCRIPTION 8698 8699=over 4 8700 8701=item Invoking Perl 8702 8703=item What's in Plan 9 Perl 8704 8705=item What's not in Plan 9 Perl 8706 8707=item Perl5 Functions not currently supported in Plan 9 Perl 8708 8709=item Signals in Plan 9 Perl 8710 8711=back 8712 8713=item COMPILING AND INSTALLING PERL ON PLAN 9 8714 8715=over 4 8716 8717=item Installing Perl Documentation on Plan 9 8718 8719=back 8720 8721=item BUGS 8722 8723=item Revision date 8724 8725=item AUTHOR 8726 8727=back 8728 8729=head2 perlqnx, README.qnx - Perl version 5 on QNX 8730 8731=over 4 8732 8733=item DESCRIPTION 8734 8735=over 4 8736 8737=item Required Software for Compiling Perl on QNX4 8738 8739/bin/sh, ar, nm, cpp, make 8740 8741=item Outstanding Issues with Perl on QNX4 8742 8743=item QNX auxiliary files 8744 8745qnx/ar, qnx/cpp 8746 8747=item Outstanding issues with perl under QNX6 8748 8749=back 8750 8751=item AUTHOR 8752 8753=back 8754 8755=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems 8756 8757=over 4 8758 8759=item DESCRIPTION 8760 8761=over 4 8762 8763=item Solaris Version Numbers. 8764 8765=back 8766 8767=item RESOURCES 8768 8769Solaris FAQ, Precompiled Binaries, Solaris Documentation 8770 8771=item SETTING UP 8772 8773=over 4 8774 8775=item File Extraction Problems on Solaris. 8776 8777=item Compiler and Related Tools on Solaris. 8778 8779=item Environment for Compiling perl on Solaris 8780 8781=back 8782 8783=item RUN CONFIGURE. 8784 8785=over 4 8786 8787=item 64-bit perl on Solaris. 8788 8789=item Threads in perl on Solaris. 8790 8791=item Malloc Issues with perl on Solaris. 8792 8793=back 8794 8795=item MAKE PROBLEMS. 8796 8797Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: 8798relocation error:, dlopen: stub interception failed, #error "No 8799DATAMODEL_NATIVE specified", sh: ar: not found 8800 8801=item MAKE TEST 8802 8803=over 4 8804 8805=item op/stat.t test 4 in Solaris 8806 8807=item nss_delete core dump from op/pwent or op/grent 8808 8809=back 8810 8811=item PREBUILT BINARIES OF PERL FOR SOLARIS. 8812 8813=item RUNTIME ISSUES FOR PERL ON SOLARIS. 8814 8815=over 4 8816 8817=item Limits on Numbers of Open Files on Solaris. 8818 8819=back 8820 8821=item SOLARIS-SPECIFIC MODULES. 8822 8823=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. 8824 8825=over 4 8826 8827=item Proc::ProcessTable on Solaris 8828 8829=item BSD::Resource on Solaris 8830 8831=item Net::SSLeay on Solaris 8832 8833=back 8834 8835=item SunOS 4.x 8836 8837=item AUTHOR 8838 8839=item LAST MODIFIED 8840 8841=back 8842 8843=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as 8844Digital UNIX formerly known as DEC OSF/1) systems 8845 8846=over 4 8847 8848=item DESCRIPTION 8849 8850=over 4 8851 8852=item Compiling Perl 5 on Tru64 8853 8854=item Using Large Files with Perl on Tru64 8855 8856=item Threaded Perl on Tru64 8857 8858=item Long Doubles on Tru64 8859 8860=item DB_File tests failing on Tru64 8861 8862=item 64-bit Perl on Tru64 8863 8864=item Warnings about floating-point overflow when compiling Perl on Tru64 8865 8866=back 8867 8868=item Testing Perl on Tru64 8869 8870=item ext/ODBM_File/odbm Test Failing With Static Builds 8871 8872=item Perl Fails Because Of Unresolved Symbol sockatmark 8873 8874=item AUTHOR 8875 8876=back 8877 8878=head2 perluts - Perl under UTS 8879 8880=over 4 8881 8882=item SYNOPSIS 8883 8884=item DESCRIPTION 8885 8886=item BUILDING PERL ON UTS 8887 8888=item Installing the built perl on UTS 8889 8890=item AUTHOR 8891 8892=back 8893 8894=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. 8895 8896=over 4 8897 8898=item SYNOPSIS 8899 8900=item DESCRIPTION 8901 8902=over 4 8903 8904=item Unpacking Perl Distribution on VM/ESA 8905 8906=item Setup Perl and utilities on VM/ESA 8907 8908=item Configure Perl on VM/ESA 8909 8910=item Testing Anomalies of Perl on VM/ESA 8911 8912=item Usage Hints for Perl on VM/ESA 8913 8914=back 8915 8916=item AUTHORS 8917 8918=item SEE ALSO 8919 8920=over 4 8921 8922=item Mailing list for Perl on VM/ESA 8923 8924=back 8925 8926=back 8927 8928=head2 perlvms - VMS-specific documentation for Perl 8929 8930=over 4 8931 8932=item DESCRIPTION 8933 8934=item Installation 8935 8936=item Organization of Perl Images 8937 8938=over 4 8939 8940=item Core Images 8941 8942=item Perl Extensions 8943 8944=item Installing static extensions 8945 8946=item Installing dynamic extensions 8947 8948=back 8949 8950=item File specifications 8951 8952=over 4 8953 8954=item Syntax 8955 8956=item Wildcard expansion 8957 8958=item Pipes 8959 8960=back 8961 8962=item PERL5LIB and PERLLIB 8963 8964=item Command line 8965 8966=over 4 8967 8968=item I/O redirection and backgrounding 8969 8970=item Command line switches 8971 8972-i, -S, -u 8973 8974=back 8975 8976=item Perl functions 8977 8978File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, 8979exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select 8980(system call), stat EXPR, system LIST, time, times, unlink LIST, utime 8981LIST, waitpid PID,FLAGS 8982 8983=item Perl variables 8984 8985%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| 8986 8987=item Standard modules with VMS-specific differences 8988 8989=over 4 8990 8991=item SDBM_File 8992 8993=back 8994 8995=item Revision date 8996 8997=item AUTHOR 8998 8999=back 9000 9001=head2 perlvos, README.vos - Perl for Stratus VOS 9002 9003=over 4 9004 9005=item SYNOPSIS 9006 9007=over 4 9008 9009=item Multiple methods to build perl for VOS 9010 9011=item Stratus POSIX Support 9012 9013=back 9014 9015=item INSTALLING PERL IN VOS 9016 9017=over 4 9018 9019=item Compiling Perl 5 on VOS 9020 9021=item Installing Perl 5 on VOS 9022 9023=back 9024 9025=item USING PERL IN VOS 9026 9027=over 4 9028 9029=item Unimplemented Features of Perl on VOS 9030 9031=item Restrictions of Perl on VOS 9032 9033=item Handling of underflow and overflow 9034 9035=back 9036 9037=item TEST STATUS 9038 9039=item SUPPORT STATUS 9040 9041=item AUTHOR 9042 9043=item LAST UPDATE 9044 9045=back 9046 9047=head2 perlwin32 - Perl under Windows 9048 9049=over 4 9050 9051=item SYNOPSIS 9052 9053=item DESCRIPTION 9054 9055=over 4 9056 9057=item Setting Up Perl on Win32 9058 9059Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform 9060SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1 9061 9062=item Building 9063 9064=item Testing Perl on Win32 9065 9066=item Installation of Perl on Win32 9067 9068=item Usage Hints for Perl on Win32 9069 9070Environment Variables, File Globbing, Using perl from the command line, 9071Building Extensions, Command-line Wildcard Expansion, Win32 Specific 9072Extensions, Notes on 64-bit Windows 9073 9074=item Running Perl Scripts 9075 9076Miscellaneous Things 9077 9078=back 9079 9080=item BUGS AND CAVEATS 9081 9082=item ACKNOWLEDGEMENTS 9083 9084=item AUTHORS 9085 9086Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy 9087E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons 9088E<lt>nick@ing-simmons.netE<gt> 9089 9090=item SEE ALSO 9091 9092=item HISTORY 9093 9094=back 9095 9096=head1 PRAGMA DOCUMENTATION 9097 9098=head2 attrs - set/get attributes of a subroutine (deprecated) 9099 9100=over 4 9101 9102=item SYNOPSIS 9103 9104=item DESCRIPTION 9105 9106method, locked 9107 9108=back 9109 9110=head2 re - Perl pragma to alter regular expression behaviour 9111 9112=over 4 9113 9114=item SYNOPSIS 9115 9116=item DESCRIPTION 9117 9118=back 9119 9120=head2 threadshared::shared, threads::shared - Perl extension for sharing 9121data structures between threads 9122 9123=over 4 9124 9125=item SYNOPSIS 9126 9127=item DESCRIPTION 9128 9129=item EXPORT 9130 9131=item FUNCTIONS 9132 9133share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, 9134LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, 9135ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE 9136 9137=item NOTES 9138 9139=item BUGS 9140 9141=item AUTHOR 9142 9143=item SEE ALSO 9144 9145=back 9146 9147=head2 threads - Perl extension allowing use of interpreter based threads 9148from perl 9149 9150=over 4 9151 9152=item SYNOPSIS 9153 9154=item DESCRIPTION 9155 9156$thread = threads->create(function, LIST), $thread->join, $thread->detach, 9157threads->self, $thread->tid, threads->object( tid ), threads->yield();, 9158threads->list();, async BLOCK; 9159 9160=item WARNINGS 9161 9162A thread exited while %d other threads were still running 9163 9164=item TODO 9165 9166=item BUGS 9167 9168Parent-Child threads, Returning objects, Creating threads inside BEGIN 9169blocks, PERL_OLD_SIGNALS are not threadsafe, will not be 9170 9171=item AUTHOR and COPYRIGHT 9172 9173=item SEE ALSO 9174 9175=back 9176 9177=head2 attributes - get/set subroutine or variable attributes 9178 9179=over 4 9180 9181=item SYNOPSIS 9182 9183=item DESCRIPTION 9184 9185=over 4 9186 9187=item Built-in Attributes 9188 9189locked, method, lvalue 9190 9191=item Available Subroutines 9192 9193get, reftype 9194 9195=item Package-specific Attribute Handling 9196 9197FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES 9198 9199=item Syntax of Attribute Lists 9200 9201=back 9202 9203=item EXPORTS 9204 9205=over 4 9206 9207=item Default exports 9208 9209=item Available exports 9210 9211=item Export tags defined 9212 9213=back 9214 9215=item EXAMPLES 9216 9217=item SEE ALSO 9218 9219=back 9220 9221=head2 autouse - postpone load of modules until a function is used 9222 9223=over 4 9224 9225=item SYNOPSIS 9226 9227=item DESCRIPTION 9228 9229=item WARNING 9230 9231=item AUTHOR 9232 9233=item SEE ALSO 9234 9235=back 9236 9237=head2 base - Establish IS-A relationship with base classes at compile time 9238 9239=over 4 9240 9241=item SYNOPSIS 9242 9243=item DESCRIPTION 9244 9245=item HISTORY 9246 9247=item CAVEATS 9248 9249=item SEE ALSO 9250 9251=back 9252 9253=head2 bigint - Transparent BigInteger support for Perl 9254 9255=over 4 9256 9257=item SYNOPSIS 9258 9259=item DESCRIPTION 9260 9261=over 4 9262 9263=item OPTIONS 9264 9265a or accuracy, p or precision, t or trace, l or lib, v or version 9266 9267=item MATH LIBRARY 9268 9269=item INTERNAL FORMAT 9270 9271=item SIGN 9272 9273=item METHODS 9274 9275=item CAVEAT 9276 9277=back 9278 9279=item MODULES USED 9280 9281=item EXAMPLES 9282 9283=item LICENSE 9284 9285=item SEE ALSO 9286 9287=item AUTHORS 9288 9289=back 9290 9291=head2 bignum - Transparent BigNumber support for Perl 9292 9293=over 4 9294 9295=item SYNOPSIS 9296 9297=item DESCRIPTION 9298 9299=over 4 9300 9301=item OPTIONS 9302 9303a or accuracy, p or precision, t or trace, l or lib, v or version 9304 9305=item METHODS 9306 9307=item CAVEAT 9308 9309inf(), NaN(), upgrade() 9310 9311=item MATH LIBRARY 9312 9313=item INTERNAL FORMAT 9314 9315=item SIGN 9316 9317=back 9318 9319=item MODULES USED 9320 9321=item EXAMPLES 9322 9323=item LICENSE 9324 9325=item SEE ALSO 9326 9327=item AUTHORS 9328 9329=back 9330 9331=head2 bigrat - Transparent BigNumber/BigRational support for Perl 9332 9333=over 4 9334 9335=item SYNOPSIS 9336 9337=item DESCRIPTION 9338 9339=over 4 9340 9341=item MODULES USED 9342 9343=item MATH LIBRARY 9344 9345=item SIGN 9346 9347=item METHODS 9348 9349=item CAVEAT 9350 9351=back 9352 9353=item EXAMPLES 9354 9355 perl -Mbigrat -le 'print sqrt(33)' 9356 perl -Mbigrat -le 'print 2*255' 9357 perl -Mbigrat -le 'print 4.5+2*255' 9358 perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' 9359 perl -Mbigrat -le 'print 12->is_odd()'; 9360 9361=item LICENSE 9362 9363=item SEE ALSO 9364 9365=item AUTHORS 9366 9367=back 9368 9369=head2 blib - Use MakeMaker's uninstalled version of a package 9370 9371=over 4 9372 9373=item SYNOPSIS 9374 9375=item DESCRIPTION 9376 9377=item BUGS 9378 9379=item AUTHOR 9380 9381=back 9382 9383=head2 bytes - Perl pragma to force byte semantics rather than character 9384semantics 9385 9386=over 4 9387 9388=item SYNOPSIS 9389 9390=item DESCRIPTION 9391 9392=item LIMITATIONS 9393 9394=item SEE ALSO 9395 9396=back 9397 9398=head2 charnames - define character names for C<\N{named}> string literal 9399escapes 9400 9401=over 4 9402 9403=item SYNOPSIS 9404 9405=item DESCRIPTION 9406 9407=item CUSTOM TRANSLATORS 9408 9409=item CUSTOM ALIASES 9410 9411=over 4 9412 9413=item Anonymous hashes 9414 9415=item Alias file 9416 9417=item Alias shortcut 9418 9419=back 9420 9421=item charnames::viacode(code) 9422 9423=item charnames::vianame(name) 9424 9425=item ALIASES 9426 9427=item ILLEGAL CHARACTERS 9428 9429=item BUGS 9430 9431=back 9432 9433=head2 constant - Perl pragma to declare constants 9434 9435=over 4 9436 9437=item SYNOPSIS 9438 9439=item DESCRIPTION 9440 9441=item NOTES 9442 9443=over 4 9444 9445=item List constants 9446 9447=item Defining multiple constants at once 9448 9449=item Magic constants 9450 9451=back 9452 9453=item TECHNICAL NOTES 9454 9455=item BUGS 9456 9457=item AUTHOR 9458 9459=item COPYRIGHT 9460 9461=back 9462 9463=head2 diagnostics, splain - produce verbose warning diagnostics 9464 9465=over 4 9466 9467=item SYNOPSIS 9468 9469=item DESCRIPTION 9470 9471=over 4 9472 9473=item The C<diagnostics> Pragma 9474 9475=item The I<splain> Program 9476 9477=back 9478 9479=item EXAMPLES 9480 9481=item INTERNALS 9482 9483=item BUGS 9484 9485=item AUTHOR 9486 9487=back 9488 9489=head2 encoding - allows you to write your script in non-ascii or non-utf8 9490 9491=over 4 9492 9493=item SYNOPSIS 9494 9495=item ABSTRACT 9496 9497=over 4 9498 9499=item Literal Conversions 9500 9501=item PerlIO layers for C<STD(IN|OUT)> 9502 9503=item Implicit upgrading for byte strings 9504 9505=back 9506 9507=item FEATURES THAT REQUIRE 5.8.1 9508 9509"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle 9510 9511=item USAGE 9512 9513use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> 9514I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; 9515 9516=item The Filter Option 9517 9518=over 4 9519 9520=item Filter-related changes at Encode version 1.87 9521 9522=back 9523 9524=item CAVEATS 9525 9526=over 4 9527 9528=item NOT SCOPED 9529 9530=item DO NOT MIX MULTIPLE ENCODINGS 9531 9532=item tr/// with ranges 9533 9534Legend of characters above 9535 9536=back 9537 9538=item EXAMPLE - Greekperl 9539 9540=item KNOWN PROBLEMS 9541 9542literals in regex that are longer than 127 bytes, EBCDIC, format 9543 9544=item HISTORY 9545 9546=item SEE ALSO 9547 9548=back 9549 9550=head2 fields - compile-time class fields 9551 9552=over 4 9553 9554=item SYNOPSIS 9555 9556=item DESCRIPTION 9557 9558new, phash 9559 9560=item SEE ALSO 9561 9562=back 9563 9564=head2 filetest - Perl pragma to control the filetest permission operators 9565 9566=over 4 9567 9568=item SYNOPSIS 9569 9570=item DESCRIPTION 9571 9572=over 4 9573 9574=item subpragma access 9575 9576=back 9577 9578=back 9579 9580=head2 if - C<use> a Perl module if a condition holds 9581 9582=over 4 9583 9584=item SYNOPSIS 9585 9586=item DESCRIPTION 9587 9588=item BUGS 9589 9590=item AUTHOR 9591 9592=back 9593 9594=head2 integer - Perl pragma to use integer arithmetic instead of floating 9595point 9596 9597=over 4 9598 9599=item SYNOPSIS 9600 9601=item DESCRIPTION 9602 9603=back 9604 9605=head2 less - perl pragma to request less of something from the compiler 9606 9607=over 4 9608 9609=item SYNOPSIS 9610 9611=item DESCRIPTION 9612 9613=back 9614 9615=head2 lib - manipulate @INC at compile time 9616 9617=over 4 9618 9619=item SYNOPSIS 9620 9621=item DESCRIPTION 9622 9623=over 4 9624 9625=item Adding directories to @INC 9626 9627=item Deleting directories from @INC 9628 9629=item Restoring original @INC 9630 9631=back 9632 9633=item CAVEATS 9634 9635=item NOTES 9636 9637=item SEE ALSO 9638 9639=item AUTHOR 9640 9641=back 9642 9643=head2 locale - Perl pragma to use and avoid POSIX locales for built-in 9644operations 9645 9646=over 4 9647 9648=item SYNOPSIS 9649 9650=item DESCRIPTION 9651 9652=back 9653 9654=head2 open - perl pragma to set default PerlIO layers for input and output 9655 9656=over 4 9657 9658=item SYNOPSIS 9659 9660=item DESCRIPTION 9661 9662=item NONPERLIO FUNCTIONALITY 9663 9664=item IMPLEMENTATION DETAILS 9665 9666=item SEE ALSO 9667 9668=back 9669 9670=head2 ops - Perl pragma to restrict unsafe operations when compiling 9671 9672=over 4 9673 9674=item SYNOPSIS 9675 9676=item DESCRIPTION 9677 9678=item SEE ALSO 9679 9680=back 9681 9682=head2 overload - Package for overloading perl operations 9683 9684=over 4 9685 9686=item SYNOPSIS 9687 9688=item DESCRIPTION 9689 9690=over 4 9691 9692=item Declaration of overloaded functions 9693 9694=item Calling Conventions for Binary Operations 9695 9696FALSE, TRUE, C<undef> 9697 9698=item Calling Conventions for Unary Operations 9699 9700=item Calling Conventions for Mutators 9701 9702C<++> and C<-->, C<x=> and other assignment versions 9703 9704=item Overloadable Operations 9705 9706I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, 9707I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string 9708and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> 9709 9710=item Inheritance and overloading 9711 9712Strings as values of C<use overload> directive, Overloading of an operation 9713is inherited by derived classes 9714 9715=back 9716 9717=item SPECIAL SYMBOLS FOR C<use overload> 9718 9719=over 4 9720 9721=item Last Resort 9722 9723=item Fallback 9724 9725C<undef>, TRUE, defined, but FALSE 9726 9727=item Copy Constructor 9728 9729B<Example> 9730 9731=back 9732 9733=item MAGIC AUTOGENERATION 9734 9735I<Assignment forms of arithmetic operations>, I<Conversion operations>, 9736I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, 9737I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, 9738I<Copy operator> 9739 9740=item Losing overloading 9741 9742=item Run-time Overloading 9743 9744=item Public functions 9745 9746overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) 9747 9748=item Overloading constants 9749 9750integer, float, binary, q, qr 9751 9752=item IMPLEMENTATION 9753 9754=item Metaphor clash 9755 9756=item Cookbook 9757 9758=over 4 9759 9760=item Two-face scalars 9761 9762=item Two-face references 9763 9764=item Symbolic calculator 9765 9766=item I<Really> symbolic calculator 9767 9768=back 9769 9770=item AUTHOR 9771 9772=item DIAGNOSTICS 9773 9774Odd number of arguments for overload::constant, `%s' is not an overloadable 9775type, `%s' is not a code reference 9776 9777=item BUGS 9778 9779=back 9780 9781=head2 sigtrap - Perl pragma to enable simple signal handling 9782 9783=over 4 9784 9785=item SYNOPSIS 9786 9787=item DESCRIPTION 9788 9789=item OPTIONS 9790 9791=over 4 9792 9793=item SIGNAL HANDLERS 9794 9795B<stack-trace>, B<die>, B<handler> I<your-handler> 9796 9797=item SIGNAL LISTS 9798 9799B<normal-signals>, B<error-signals>, B<old-interface-signals> 9800 9801=item OTHER 9802 9803B<untrapped>, B<any>, I<signal>, I<number> 9804 9805=back 9806 9807=item EXAMPLES 9808 9809=back 9810 9811=head2 sort - perl pragma to control sort() behaviour 9812 9813=over 4 9814 9815=item SYNOPSIS 9816 9817=item DESCRIPTION 9818 9819=item CAVEATS 9820 9821=back 9822 9823=head2 strict - Perl pragma to restrict unsafe constructs 9824 9825=over 4 9826 9827=item SYNOPSIS 9828 9829=item DESCRIPTION 9830 9831C<strict refs>, C<strict vars>, C<strict subs> 9832 9833=item HISTORY 9834 9835=back 9836 9837=head2 subs - Perl pragma to predeclare sub names 9838 9839=over 4 9840 9841=item SYNOPSIS 9842 9843=item DESCRIPTION 9844 9845=back 9846 9847=head2 threadshared, threads::shared - Perl extension for sharing data 9848structures between threads 9849 9850=over 4 9851 9852=item SYNOPSIS 9853 9854=item DESCRIPTION 9855 9856=item EXPORT 9857 9858=item FUNCTIONS 9859 9860share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, 9861LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, 9862ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE 9863 9864=item NOTES 9865 9866=item BUGS 9867 9868=item AUTHOR 9869 9870=item SEE ALSO 9871 9872=back 9873 9874=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source 9875code 9876 9877=over 4 9878 9879=item SYNOPSIS 9880 9881=item DESCRIPTION 9882 9883=over 4 9884 9885=item Utility functions 9886 9887$num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[, 9888FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag = 9889utf8::is_utf8(STRING), $flag = utf8::valid(STRING) 9890 9891=back 9892 9893=item BUGS 9894 9895=item SEE ALSO 9896 9897=back 9898 9899=head2 vars - Perl pragma to predeclare global variable names (obsolete) 9900 9901=over 4 9902 9903=item SYNOPSIS 9904 9905=item DESCRIPTION 9906 9907=back 9908 9909=head2 vmsish - Perl pragma to control VMS-specific language features 9910 9911=over 4 9912 9913=item SYNOPSIS 9914 9915=item DESCRIPTION 9916 9917C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> 9918 9919=back 9920 9921=head2 warnings - Perl pragma to control optional warnings 9922 9923=over 4 9924 9925=item SYNOPSIS 9926 9927=item DESCRIPTION 9928 9929use warnings::register, warnings::enabled(), warnings::enabled($category), 9930warnings::enabled($object), warnings::warn($message), 9931warnings::warn($category, $message), warnings::warn($object, $message), 9932warnings::warnif($message), warnings::warnif($category, $message), 9933warnings::warnif($object, $message) 9934 9935=back 9936 9937=head2 warnings::register - warnings import function 9938 9939=over 4 9940 9941=item SYNOPSIS 9942 9943=item DESCRIPTION 9944 9945=back 9946 9947=head1 MODULE DOCUMENTATION 9948 9949=head2 AnyDBM_File - provide framework for multiple DBMs 9950 9951=over 4 9952 9953=item SYNOPSIS 9954 9955=item DESCRIPTION 9956 9957=over 4 9958 9959=item DBM Comparisons 9960 9961[0], [1], [2], [3] 9962 9963=back 9964 9965=item SEE ALSO 9966 9967=back 9968 9969=head2 Attribute::Handlers - Simpler definition of attribute handlers 9970 9971=over 4 9972 9973=item VERSION 9974 9975=item SYNOPSIS 9976 9977=item DESCRIPTION 9978 9979[0], [1], [2], [3], [4], [5] 9980 9981=over 4 9982 9983=item Typed lexicals 9984 9985=item Type-specific attribute handlers 9986 9987=item Non-interpretive attribute handlers 9988 9989=item Phase-specific attribute handlers 9990 9991=item Attributes as C<tie> interfaces 9992 9993=back 9994 9995=item EXAMPLES 9996 9997=item DIAGNOSTICS 9998 9999C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s 10000attributes>, C<Declaration of %s attribute in package %s may clash with 10001future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, 10002C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't 10003be able to apply END handler> 10004 10005=item AUTHOR 10006 10007=item BUGS 10008 10009=item COPYRIGHT 10010 10011=back 10012 10013=head2 AutoLoader - load subroutines only on demand 10014 10015=over 4 10016 10017=item SYNOPSIS 10018 10019=item DESCRIPTION 10020 10021=over 4 10022 10023=item Subroutine Stubs 10024 10025=item Using B<AutoLoader>'s AUTOLOAD Subroutine 10026 10027=item Overriding B<AutoLoader>'s AUTOLOAD Subroutine 10028 10029=item Package Lexicals 10030 10031=item Not Using AutoLoader 10032 10033=item B<AutoLoader> vs. B<SelfLoader> 10034 10035=back 10036 10037=item CAVEATS 10038 10039=item SEE ALSO 10040 10041=back 10042 10043=head2 AutoSplit - split a package for autoloading 10044 10045=over 4 10046 10047=item SYNOPSIS 10048 10049=item DESCRIPTION 10050 10051$keep, $check, $modtime 10052 10053=over 4 10054 10055=item Multiple packages 10056 10057=back 10058 10059=item DIAGNOSTICS 10060 10061=back 10062 10063=head2 B - The Perl Compiler 10064 10065=over 4 10066 10067=item SYNOPSIS 10068 10069=item DESCRIPTION 10070 10071=item OVERVIEW 10072 10073=item Utility Functions 10074 10075=over 4 10076 10077=item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV> 10078objects 10079 10080sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av, 10081check_av, begin_av, end_av, comppadlist, regex_padav, main_cv 10082 10083=item Functions for Examining the Symbol Table 10084 10085walksymtable(SYMREF, METHOD, RECURSE, PREFIX) 10086 10087=item Functions Returning C<B::OP> objects or for walking op trees 10088 10089main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG) 10090 10091=item Miscellaneous Utility Functions 10092 10093ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), 10094perlstring(STR), class(OBJ), threadsv_names 10095 10096=back 10097 10098=item OVERVIEW OF CLASSES 10099 10100=over 4 10101 10102=item SV-RELATED CLASSES 10103 10104=item B::SV Methods 10105 10106REFCNT, FLAGS, object_2svref 10107 10108=item B::IV Methods 10109 10110IV, IVX, UVX, int_value, needs64bits, packiv 10111 10112=item B::NV Methods 10113 10114NV, NVX 10115 10116=item B::RV Methods 10117 10118RV 10119 10120=item B::PV Methods 10121 10122PV, RV, PVX 10123 10124=item B::PVMG Methods 10125 10126MAGIC, SvSTASH 10127 10128=item B::MAGIC Methods 10129 10130MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX 10131 10132=item B::PVLV Methods 10133 10134TARGOFF, TARGLEN, TYPE, TARG 10135 10136=item B::BM Methods 10137 10138USEFUL, PREVIOUS, RARE, TABLE 10139 10140=item B::GV Methods 10141 10142is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, 10143LINE, FILE, FILEGV, GvREFCNT, FLAGS 10144 10145=item B::IO Methods 10146 10147LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, 10148BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD 10149 10150=item B::AV Methods 10151 10152FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS 10153 10154=item B::CV Methods 10155 10156STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB, 10157XSUBANY, CvFLAGS, const_sv 10158 10159=item B::HV Methods 10160 10161FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY 10162 10163=item OP-RELATED CLASSES 10164 10165=item B::OP Methods 10166 10167next, sibling, name, ppaddr, desc, targ, type, seq, flags, private 10168 10169=item B::UNOP METHOD 10170 10171first 10172 10173=item B::BINOP METHOD 10174 10175last 10176 10177=item B::LOGOP METHOD 10178 10179other 10180 10181=item B::LISTOP METHOD 10182 10183children 10184 10185=item B::PMOP Methods 10186 10187pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, 10188pmpermflags, precomp, pmoffset 10189 10190=item B::SVOP METHOD 10191 10192sv, gv 10193 10194=item B::PADOP METHOD 10195 10196padix 10197 10198=item B::PVOP METHOD 10199 10200pv 10201 10202=item B::LOOP Methods 10203 10204redoop, nextop, lastop 10205 10206=item B::COP Methods 10207 10208label, stash, stashpv, file, cop_seq, arybase, line, warnings, io 10209 10210=back 10211 10212=item AUTHOR 10213 10214=back 10215 10216=head2 B::Asmdata - Autogenerated data about Perl ops, used to generate 10217bytecode 10218 10219=over 4 10220 10221=item SYNOPSIS 10222 10223=item DESCRIPTION 10224 10225%insn_data, @insn_name, @optype, @specialsv_name 10226 10227=item AUTHOR 10228 10229=back 10230 10231=head2 B::Assembler - Assemble Perl bytecode 10232 10233=over 4 10234 10235=item SYNOPSIS 10236 10237=item DESCRIPTION 10238 10239=item AUTHORS 10240 10241=back 10242 10243=head2 B::Bblock - Walk basic blocks 10244 10245=over 4 10246 10247=item SYNOPSIS 10248 10249=item DESCRIPTION 10250 10251=over 4 10252 10253=item Functions 10254 10255B<find_leaders> 10256 10257=back 10258 10259=item AUTHOR 10260 10261=back 10262 10263=head2 B::Bytecode - Perl compiler's bytecode backend 10264 10265=over 4 10266 10267=item SYNOPSIS 10268 10269=item DESCRIPTION 10270 10271=item EXAMPLE 10272 10273=item OPTIONS 10274 10275B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> 10276 10277=item KNOWN BUGS 10278 10279=item NOTICE 10280 10281=item AUTHORS 10282 10283=back 10284 10285=head2 B::C - Perl compiler's C backend 10286 10287=over 4 10288 10289=item SYNOPSIS 10290 10291=item DESCRIPTION 10292 10293=item OPTIONS 10294 10295B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, 10296B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, 10297B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, 10298B<-llimit> 10299 10300=item EXAMPLES 10301 10302=item BUGS 10303 10304=item AUTHOR 10305 10306=back 10307 10308=head2 B::CC - Perl compiler's optimized C translation backend 10309 10310=over 4 10311 10312=item SYNOPSIS 10313 10314=item DESCRIPTION 10315 10316=item OPTIONS 10317 10318B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, 10319B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, 10320B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> 10321 10322=item EXAMPLES 10323 10324=item BUGS 10325 10326=item DIFFERENCES 10327 10328=over 4 10329 10330=item Loops 10331 10332=item Context of ".." 10333 10334=item Arithmetic 10335 10336=item Deprecated features 10337 10338=back 10339 10340=item AUTHOR 10341 10342=back 10343 10344=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops 10345 10346=over 4 10347 10348=item SYNOPSIS 10349 10350=item DESCRIPTION 10351 10352=item EXAMPLE 10353 10354=item OPTIONS 10355 10356B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>, 10357B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>, 10358B<-terse>, B<-linenoise>, B<-debug>, B<-env> 10359 10360=item FORMATTING SPECIFICATIONS 10361 10362B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, 10363B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, 10364B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>, 10365B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, 10366B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, 10367B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, 10368B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, 10369B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> 10370 10371=item ABBREVIATIONS 10372 10373=over 4 10374 10375=item OP flags abbreviations 10376 10377=item OP class abbreviations 10378 10379=back 10380 10381=item Using B::Concise outside of the O framework 10382 10383=over 4 10384 10385=item example: Altering Concise Output 10386 10387=item set_style() 10388 10389=item add_style() 10390 10391=item set_style_standard($name) 10392 10393=item add_callback() 10394 10395=item running B::Concise::compile() 10396 10397=item B::Concise::reset_sequence() 10398 10399=item Errors 10400 10401=back 10402 10403=item AUTHOR 10404 10405=back 10406 10407=head2 B::Debug - Walk Perl syntax tree, printing debug info about ops 10408 10409=over 4 10410 10411=item SYNOPSIS 10412 10413=item DESCRIPTION 10414 10415=item AUTHOR 10416 10417=back 10418 10419=head2 B::Deparse - Perl compiler backend to produce perl code 10420 10421=over 4 10422 10423=item SYNOPSIS 10424 10425=item DESCRIPTION 10426 10427=item OPTIONS 10428 10429B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>, 10430B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> 10431 10432=item USING B::Deparse AS A MODULE 10433 10434=over 4 10435 10436=item Synopsis 10437 10438=item Description 10439 10440=item new 10441 10442=item ambient_pragmas 10443 10444strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits 10445 10446=item coderef2text 10447 10448=back 10449 10450=item BUGS 10451 10452=item AUTHOR 10453 10454=back 10455 10456=head2 B::Disassembler - Disassemble Perl bytecode 10457 10458=over 4 10459 10460=item SYNOPSIS 10461 10462=item DESCRIPTION 10463 10464=item AUTHOR 10465 10466=back 10467 10468=head2 B::Lint - Perl lint 10469 10470=over 4 10471 10472=item SYNOPSIS 10473 10474=item DESCRIPTION 10475 10476=item OPTIONS AND LINT CHECKS 10477 10478B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>, 10479B<dollar-underscore>, B<private-names>, B<undefined-subs>, 10480B<regexp-variables>, B<all>, B<none> 10481 10482=item NON LINT-CHECK OPTIONS 10483 10484B<-u Package> 10485 10486=item BUGS 10487 10488=item AUTHOR 10489 10490=back 10491 10492=head2 B::O, O - Generic interface to Perl Compiler backends 10493 10494=over 4 10495 10496=item SYNOPSIS 10497 10498=item DESCRIPTION 10499 10500=item CONVENTIONS 10501 10502=item IMPLEMENTATION 10503 10504=item BUGS 10505 10506=item AUTHOR 10507 10508=back 10509 10510=head2 B::Showlex - Show lexical variables used in functions or files 10511 10512=over 4 10513 10514=item SYNOPSIS 10515 10516=item DESCRIPTION 10517 10518=item AUTHOR 10519 10520=back 10521 10522=head2 B::Stackobj - Helper module for CC backend 10523 10524=over 4 10525 10526=item SYNOPSIS 10527 10528=item DESCRIPTION 10529 10530=item AUTHOR 10531 10532=back 10533 10534=head2 B::Stash - show what stashes are loaded 10535 10536=head2 B::Terse - Walk Perl syntax tree, printing terse info about ops 10537 10538=over 4 10539 10540=item SYNOPSIS 10541 10542=item DESCRIPTION 10543 10544=item AUTHOR 10545 10546=back 10547 10548=head2 B::Xref - Generates cross reference reports for Perl programs 10549 10550=over 4 10551 10552=item SYNOPSIS 10553 10554=item DESCRIPTION 10555 10556=item OPTIONS 10557 10558C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> 10559 10560=item BUGS 10561 10562=item AUTHOR 10563 10564=back 10565 10566=head2 Bblock, B::Bblock - Walk basic blocks 10567 10568=over 4 10569 10570=item SYNOPSIS 10571 10572=item DESCRIPTION 10573 10574=over 4 10575 10576=item Functions 10577 10578B<find_leaders> 10579 10580=back 10581 10582=item AUTHOR 10583 10584=back 10585 10586=head2 Benchmark - benchmark running times of Perl code 10587 10588=over 4 10589 10590=item SYNOPSIS 10591 10592=item DESCRIPTION 10593 10594=over 4 10595 10596=item Methods 10597 10598new, debug, iters 10599 10600=item Standard Exports 10601 10602timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), 10603timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( 10604TIMEDIFF, [ STYLE, [ FORMAT ] ] ) 10605 10606=item Optional Exports 10607 10608clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [ 10609STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), 10610disablecache ( ), enablecache ( ), timesum ( T1, T2 ) 10611 10612=item :hireswallclock 10613 10614=back 10615 10616=item NOTES 10617 10618=item EXAMPLES 10619 10620=item INHERITANCE 10621 10622=item CAVEATS 10623 10624=item SEE ALSO 10625 10626=item AUTHORS 10627 10628=item MODIFICATION HISTORY 10629 10630=back 10631 10632=head2 ByteLoader - load byte compiled perl code 10633 10634=over 4 10635 10636=item SYNOPSIS 10637 10638=item DESCRIPTION 10639 10640=item AUTHOR 10641 10642=item SEE ALSO 10643 10644=back 10645 10646=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend 10647 10648=over 4 10649 10650=item SYNOPSIS 10651 10652=item DESCRIPTION 10653 10654=item EXAMPLE 10655 10656=item OPTIONS 10657 10658B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> 10659 10660=item KNOWN BUGS 10661 10662=item NOTICE 10663 10664=item AUTHORS 10665 10666=back 10667 10668=head2 CGI - Simple Common Gateway Interface Class 10669 10670=over 4 10671 10672=item SYNOPSIS 10673 10674=item ABSTRACT 10675 10676=item DESCRIPTION 10677 10678=over 4 10679 10680=item PROGRAMMING STYLE 10681 10682=item CALLING CGI.PM ROUTINES 10683 10684=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): 10685 10686=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE 10687 10688=item FETCHING A LIST OF KEYWORDS FROM THE QUERY: 10689 10690=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: 10691 10692=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: 10693 10694=item SETTING THE VALUE(S) OF A NAMED PARAMETER: 10695 10696=item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: 10697 10698=item IMPORTING ALL PARAMETERS INTO A NAMESPACE: 10699 10700=item DELETING A PARAMETER COMPLETELY: 10701 10702=item DELETING ALL PARAMETERS: 10703 10704=item DIRECT ACCESS TO THE PARAMETER LIST: 10705 10706=item FETCHING THE PARAMETER LIST AS A HASH: 10707 10708=item SAVING THE STATE OF THE SCRIPT TO A FILE: 10709 10710=item RETRIEVING CGI ERRORS 10711 10712=item USING THE FUNCTION-ORIENTED INTERFACE 10713 10714B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, 10715B<:standard>, B<:all> 10716 10717=item PRAGMAS 10718 10719-any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, 10720-newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, 10721-private_tempfiles 10722 10723=item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS 10724 107251. start_table() (generates a <table> tag), 2. end_table() (generates a 10726</table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates 10727a </ul> tag) 10728 10729=back 10730 10731=item GENERATING DYNAMIC DOCUMENTS 10732 10733=over 4 10734 10735=item CREATING A STANDARD HTTP HEADER: 10736 10737=item GENERATING A REDIRECTION HEADER 10738 10739=item CREATING THE HTML DOCUMENT HEADER 10740 10741B<Parameters:>, 4, 5, 6.. 10742 10743=item ENDING THE HTML DOCUMENT: 10744 10745=item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: 10746 10747=item OBTAINING THE SCRIPT'S URL 10748 10749B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> 10750(B<-query_string>), B<-base> 10751 10752=item MIXING POST AND URL PARAMETERS 10753 10754=back 10755 10756=item CREATING STANDARD HTML ELEMENTS: 10757 10758=over 4 10759 10760=item PROVIDING ARGUMENTS TO HTML SHORTCUTS 10761 10762=item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS 10763 10764=item HTML SHORTCUTS AND LIST INTERPOLATION 10765 10766=item NON-STANDARD HTML SHORTCUTS 10767 10768=item AUTOESCAPING HTML 10769 10770$escaped_string = escapeHTML("unescaped string");, $charset = 10771charset([$charset]);, $flag = autoEscape([$flag]); 10772 10773=item PRETTY-PRINTING HTML 10774 10775=back 10776 10777=item CREATING FILL-OUT FORMS: 10778 10779=over 4 10780 10781=item CREATING AN ISINDEX TAG 10782 10783=item STARTING AND ENDING A FORM 10784 10785B<application/x-www-form-urlencoded>, B<multipart/form-data> 10786 10787=item CREATING A TEXT FIELD 10788 10789B<Parameters> 10790 10791=item CREATING A BIG TEXT FIELD 10792 10793=item CREATING A PASSWORD FIELD 10794 10795=item CREATING A FILE UPLOAD FIELD 10796 10797B<Parameters> 10798 10799=item CREATING A POPUP MENU 10800 10801=item CREATING AN OPTION GROUP 10802 10803=item CREATING A SCROLLING LIST 10804 10805B<Parameters:> 10806 10807=item CREATING A GROUP OF RELATED CHECKBOXES 10808 10809B<Parameters:> 10810 10811=item CREATING A STANDALONE CHECKBOX 10812 10813B<Parameters:> 10814 10815=item CREATING A RADIO BUTTON GROUP 10816 10817B<Parameters:> 10818 10819=item CREATING A SUBMIT BUTTON 10820 10821B<Parameters:> 10822 10823=item CREATING A RESET BUTTON 10824 10825=item CREATING A DEFAULT BUTTON 10826 10827=item CREATING A HIDDEN FIELD 10828 10829B<Parameters:> 10830 10831=item CREATING A CLICKABLE IMAGE BUTTON 10832 10833B<Parameters:>, 3. The third option (-align, optional) is an alignment 10834type, and may be TOP, BOTTOM or MIDDLE 10835 10836=item CREATING A JAVASCRIPT ACTION BUTTON 10837 10838=back 10839 10840=item HTTP COOKIES 10841 108421. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, 10843B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> 10844 10845=item WORKING WITH FRAMES 10846 108471. Create a <Frameset> document, 2. Specify the destination for the 10848document in the HTTP header, 3. Specify the destination for the document in 10849the <form> tag 10850 10851=item LIMITED SUPPORT FOR CASCADING STYLE SHEETS 10852 10853=item DEBUGGING 10854 10855=over 4 10856 10857=item DUMPING OUT ALL THE NAME/VALUE PAIRS 10858 10859=back 10860 10861=item FETCHING ENVIRONMENT VARIABLES 10862 10863B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, 10864B<path_translated()>, B<remote_host()>, B<script_name()> Return the script 10865name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type 10866()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, 10867B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name 10868()>, B<request_method()>, B<content_type()>, B<http()>, B<https()> 10869 10870=item USING NPH SCRIPTS 10871 10872In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> 10873parameters 10874 10875=item Server Push 10876 10877multipart_init(), multipart_start(), multipart_end(), multipart_final() 10878 10879=item Avoiding Denial of Service Attacks 10880 10881B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script 10882basis>, B<2. Globally for all scripts> 10883 10884=item COMPATIBILITY WITH CGI-LIB.PL 10885 10886=item AUTHOR INFORMATION 10887 10888=item CREDITS 10889 10890Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor 10891(james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell 10892(mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg 10893(jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick 10894(applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis 10895(tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen 10896(tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim 10897MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks 10898(kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed 10899Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug 10900MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), 10901...and many many more.. 10902 10903=item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT 10904 10905=item BUGS 10906 10907=item SEE ALSO 10908 10909=back 10910 10911=head2 CGI::Apache - Backward compatibility module for CGI.pm 10912 10913=over 4 10914 10915=item SYNOPSIS 10916 10917=item ABSTRACT 10918 10919=item DESCRIPTION 10920 10921=item AUTHOR INFORMATION 10922 10923=item BUGS 10924 10925=item SEE ALSO 10926 10927=back 10928 10929=head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or 10930other) error log 10931 10932=over 4 10933 10934=item SYNOPSIS 10935 10936=item DESCRIPTION 10937 10938=item REDIRECTING ERROR MESSAGES 10939 10940=item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW 10941 10942=over 4 10943 10944=item Changing the default message 10945 10946=back 10947 10948=item MAKING WARNINGS APPEAR AS HTML COMMENTS 10949 10950=item OVERRIDING THE NAME OF THE PROGRAM 10951 10952=item AUTHORS 10953 10954=item SEE ALSO 10955 10956=back 10957 10958=head2 CGI::Cookie - Interface to Netscape Cookies 10959 10960=over 4 10961 10962=item SYNOPSIS 10963 10964=item DESCRIPTION 10965 10966=item USING CGI::Cookie 10967 10968B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> 10969 10970=over 4 10971 10972=item Creating New Cookies 10973 10974=item Sending the Cookie to the Browser 10975 10976=item Recovering Previous Cookies 10977 10978=item Manipulating Cookies 10979 10980B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> 10981 10982=back 10983 10984=item AUTHOR INFORMATION 10985 10986=item BUGS 10987 10988=item SEE ALSO 10989 10990=back 10991 10992=head2 CGI::Fast - CGI Interface for Fast CGI 10993 10994=over 4 10995 10996=item SYNOPSIS 10997 10998=item DESCRIPTION 10999 11000=item OTHER PIECES OF THE PUZZLE 11001 11002=item WRITING FASTCGI PERL SCRIPTS 11003 11004=item INSTALLING FASTCGI SCRIPTS 11005 11006=item USING FASTCGI SCRIPTS AS CGI SCRIPTS 11007 11008=item EXTERNAL FASTCGI SERVER INVOCATION 11009 11010FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE 11011 11012=item CAVEATS 11013 11014=item AUTHOR INFORMATION 11015 11016=item BUGS 11017 11018=item SEE ALSO 11019 11020=back 11021 11022=head2 CGI::Pretty - module to produce nicely formatted HTML code 11023 11024=over 4 11025 11026=item SYNOPSIS 11027 11028=item DESCRIPTION 11029 11030=over 4 11031 11032=item Tags that won't be formatted 11033 11034=item Customizing the Indenting 11035 11036=back 11037 11038=item BUGS 11039 11040=item AUTHOR 11041 11042=item SEE ALSO 11043 11044=back 11045 11046=head2 CGI::Push - Simple Interface to Server Push 11047 11048=over 4 11049 11050=item SYNOPSIS 11051 11052=item DESCRIPTION 11053 11054=item USING CGI::Push 11055 11056-next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph 11057 11058=over 4 11059 11060=item Heterogeneous Pages 11061 11062=item Changing the Page Delay on the Fly 11063 11064=back 11065 11066=item INSTALLING CGI::Push SCRIPTS 11067 11068=item AUTHOR INFORMATION 11069 11070=item BUGS 11071 11072=item SEE ALSO 11073 11074=back 11075 11076=head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch 11077 11078=over 4 11079 11080=item SYNOPSIS 11081 11082=item ABSTRACT 11083 11084=item DESCRIPTION 11085 11086=item AUTHOR INFORMATION 11087 11088=item BUGS 11089 11090=item SEE ALSO 11091 11092=back 11093 11094=head2 CGI::Util - Internal utilities used by CGI module 11095 11096=over 4 11097 11098=item SYNOPSIS 11099 11100=item DESCRIPTION 11101 11102=item AUTHOR INFORMATION 11103 11104=item SEE ALSO 11105 11106=back 11107 11108=head2 CPAN - query, download and build perl modules from CPAN sites 11109 11110=over 4 11111 11112=item SYNOPSIS 11113 11114=item STATUS 11115 11116=item DESCRIPTION 11117 11118=over 4 11119 11120=item Interactive Mode 11121 11122Searching for authors, bundles, distribution files and modules, make, test, 11123install, clean modules or distributions, get, readme, look module or 11124distribution, ls author, Signals 11125 11126=item CPAN::Shell 11127 11128=item autobundle 11129 11130=item recompile 11131 11132=item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution 11133 11134=item Programmer's interface 11135 11136expand($type,@things), expandany(@things), Programming Examples 11137 11138=item Methods in the other Classes 11139 11140CPAN::Author::as_glimpse(), CPAN::Author::as_string(), 11141CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), 11142CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), 11143CPAN::Bundle::clean(), CPAN::Bundle::contains(), 11144CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), 11145CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), 11146CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), 11147CPAN::Bundle::readme(), CPAN::Bundle::test(), 11148CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), 11149CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), 11150CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), 11151CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), 11152CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), 11153CPAN::Distribution::look(), CPAN::Distribution::make(), 11154CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), 11155CPAN::Distribution::test(), CPAN::Distribution::uptodate(), 11156CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), 11157CPAN::Module::as_glimpse(), CPAN::Module::as_string(), 11158CPAN::Module::clean(), CPAN::Module::cpan_file(), 11159CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), 11160CPAN::Module::description(), CPAN::Module::force($method,@args), 11161CPAN::Module::get(), CPAN::Module::inst_file(), 11162CPAN::Module::inst_version(), CPAN::Module::install(), 11163CPAN::Module::look(), CPAN::Module::make(), 11164CPAN::Module::manpage_headline(), CPAN::Module::readme(), 11165CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() 11166 11167=item Cache Manager 11168 11169=item Bundles 11170 11171=item Prerequisites 11172 11173=item Finding packages and VERSION 11174 11175=item Debugging 11176 11177=item Floppy, Zip, Offline Mode 11178 11179=back 11180 11181=item CONFIGURATION 11182 11183C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> 11184E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list 11185optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> 11186[unshift|push|splice] E<lt>listE<gt>> 11187 11188=over 4 11189 11190=item Note on urllist parameter's format 11191 11192=item urllist parameter has CD-ROM support 11193 11194=back 11195 11196=item SECURITY 11197 11198=item EXPORT 11199 11200=item POPULATE AN INSTALLATION WITH LOTS OF MODULES 11201 11202=item WORKING WITH CPAN.pm BEHIND FIREWALLS 11203 11204=over 4 11205 11206=item Three basic types of firewalls 11207 11208http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade 11209 11210=item Configuring lynx or ncftp for going through a firewall 11211 11212=back 11213 11214=item FAQ 11215 112161), 2), 3), 4), 5), 6), 7), 8), 9), 10) 11217 11218=item BUGS 11219 11220=item AUTHOR 11221 11222=item TRANSLATIONS 11223 11224=item SEE ALSO 11225 11226=back 11227 11228=head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization 11229 11230=over 4 11231 11232=item SYNOPSIS 11233 11234=item DESCRIPTION 11235 11236=back 11237 11238=head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS 11239module 11240 11241=over 4 11242 11243=item SYNOPSIS 11244 11245=item DESCRIPTION 11246 11247=item SEE ALSO 11248 11249=back 11250 11251=head2 Carp, carp - warn of errors (from perspective of caller) 11252 11253=over 4 11254 11255=item SYNOPSIS 11256 11257=item DESCRIPTION 11258 11259=over 4 11260 11261=item Forcing a Stack Trace 11262 11263=back 11264 11265=item BUGS 11266 11267=back 11268 11269=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside 11270 11271=head2 Class::ISA -- report the search path for a class's ISA tree 11272 11273=over 4 11274 11275=item SYNOPSIS 11276 11277=item DESCRIPTION 11278 11279=item FUNCTIONS 11280 11281the function Class::ISA::super_path($CLASS), the function 11282Class::ISA::self_and_super_path($CLASS), the function 11283Class::ISA::self_and_super_versions($CLASS) 11284 11285=item CAUTIONARY NOTES 11286 11287=item COPYRIGHT 11288 11289=item AUTHOR 11290 11291=back 11292 11293=head2 Class::Struct - declare struct-like datatypes as Perl classes 11294 11295=over 4 11296 11297=item SYNOPSIS 11298 11299=item DESCRIPTION 11300 11301=over 4 11302 11303=item The C<struct()> function 11304 11305=item Class Creation at Compile Time 11306 11307=item Element Types and Accessor Methods 11308 11309Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or 11310C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) 11311 11312=item Initializing with C<new> 11313 11314=back 11315 11316=item EXAMPLES 11317 11318Example 1, Example 2, Example 3 11319 11320=item Author and Modification History 11321 11322=back 11323 11324=head2 Config - access Perl configuration information 11325 11326=over 4 11327 11328=item SYNOPSIS 11329 11330=item DESCRIPTION 11331 11332myconfig(), config_sh(), config_re($regex), config_vars(@names) 11333 11334=item EXAMPLE 11335 11336=item WARNING 11337 11338=item GLOSSARY 11339 11340=over 4 11341 11342=item _ 11343 11344C<_a>, C<_exe>, C<_o> 11345 11346=item a 11347 11348C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, 11349C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, 11350C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, 11351C<asctime_r_proto>, C<awk> 11352 11353=item b 11354 11355C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> 11356 11357=item c 11358 11359C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, 11360C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, 11361C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, 11362C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, 11363C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, 11364C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, 11365C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> 11366 11367=item d 11368 11369C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, 11370C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, 11371C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, 11372C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, 11373C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, 11374C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, 11375C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, 11376C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, 11377C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, 11378C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, 11379C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, 11380C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, 11381C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>, 11382C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, 11383C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, 11384C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, 11385C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, 11386C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, 11387C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>, 11388C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, 11389C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, 11390C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, 11391C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>, 11392C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, 11393C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, 11394C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, 11395C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, 11396C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, 11397C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, 11398C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, 11399C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, 11400C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, 11401C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, 11402C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, 11403C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, 11404C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, 11405C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, 11406C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, 11407C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, 11408C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, 11409C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, 11410C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, 11411C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, 11412C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, 11413C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, 11414C<d_nanosleep>, C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, 11415C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>, 11416C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, 11417C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, 11418C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, 11419C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, 11420C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, 11421C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>, 11422C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, 11423C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, 11424C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>, 11425C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, 11426C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, 11427C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, 11428C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>, 11429C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>, 11430C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, 11431C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, 11432C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, 11433C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, 11434C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>, 11435C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, 11436C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, 11437C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, 11438C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, 11439C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, 11440C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, 11441C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, 11442C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, 11443C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, 11444C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, 11445C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, 11446C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>, 11447C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, 11448C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, 11449C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, 11450C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, 11451C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>, 11452C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>, 11453C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>, 11454C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, 11455C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, 11456C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>, 11457C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, 11458C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>, 11459C<db_version_major>, C<db_version_minor>, C<db_version_patch>, 11460C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>, 11461C<drand01>, C<drand48_r_proto>, C<dynamic_ext> 11462 11463=item e 11464 11465C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, 11466C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, 11467C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, 11468C<expr>, C<extensions>, C<extras> 11469 11470=item f 11471 11472C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, 11473C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, 11474C<full_sed> 11475 11476=item g 11477 11478C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, 11479C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, 11480C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, 11481C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, 11482C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, 11483C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, 11484C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, 11485C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, 11486C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, 11487C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> 11488 11489=item h 11490 11491C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, 11492C<html3dir>, C<html3direxp> 11493 11494=item i 11495 11496C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, 11497C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, 11498C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, 11499C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, 11500C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, 11501C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, 11502C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, 11503C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, 11504C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, 11505C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, 11506C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, 11507C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, 11508C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, 11509C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, 11510C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, 11511C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, 11512C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, 11513C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, 11514C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>, 11515C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>, 11516C<installprefixexp>, C<installprivlib>, C<installscript>, 11517C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>, 11518C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>, 11519C<installsiteman3dir>, C<installsitescript>, C<installstyle>, 11520C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, 11521C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>, 11522C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>, 11523C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> 11524 11525=item k 11526 11527C<known_extensions>, C<ksh> 11528 11529=item l 11530 11531C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, 11532C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, 11533C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, 11534C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, 11535C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, 11536C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, 11537C<lseektype> 11538 11539=item m 11540 11541C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, 11542C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, 11543C<man3direxp>, C<man3ext> 11544 11545=item M 11546 11547C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, 11548C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, 11549C<myuname> 11550 11551=item n 11552 11553C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, 11554C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, 11555C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, 11556C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, 11557C<nvsize>, C<nvtype> 11558 11559=item o 11560 11561C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, 11562C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> 11563 11564=item p 11565 11566C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, 11567C<perl>, C<perl_patchlevel> 11568 11569=item P 11570 11571C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, 11572C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, 11573C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, 11574C<procselfexe>, C<prototype>, C<ptrsize> 11575 11576=item q 11577 11578C<quadkind>, C<quadtype> 11579 11580=item r 11581 11582C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, 11583C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, 11584C<rmail>, C<run>, C<runnm> 11585 11586=item s 11587 11588C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, 11589C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, 11590C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, 11591C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, 11592C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, 11593C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, 11594C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, 11595C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, 11596C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, 11597C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, 11598C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, 11599C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, 11600C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, 11601C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, 11602C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, 11603C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, 11604C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, 11605C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, 11606C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, 11607C<submit>, C<subversion>, C<sysman> 11608 11609=item t 11610 11611C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, 11612C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, 11613C<ttyname_r_proto> 11614 11615=item u 11616 11617C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, 11618C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, 11619C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, 11620C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, 11621C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>, 11622C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, 11623C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, 11624C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, 11625C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, 11626C<uvXUformat> 11627 11628=item v 11629 11630C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, 11631C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, 11632C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, 11633C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, 11634C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, 11635C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, 11636C<versiononly>, C<vi>, C<voidflags> 11637 11638=item x 11639 11640C<xlibpth> 11641 11642=item y 11643 11644C<yacc>, C<yaccflags> 11645 11646=item z 11647 11648C<zcat>, C<zip> 11649 11650=back 11651 11652=item NOTE 11653 11654=back 11655 11656=head2 Cwd - get pathname of current working directory 11657 11658=over 4 11659 11660=item SYNOPSIS 11661 11662=item DESCRIPTION 11663 11664=over 4 11665 11666=item getcwd and friends 11667 11668getcwd, cwd, fastcwd, fastgetcwd 11669 11670=item abs_path and friends 11671 11672abs_path, realpath, fast_abs_path 11673 11674=item $ENV{PWD} 11675 11676=back 11677 11678=item NOTES 11679 11680=item AUTHOR 11681 11682=item SEE ALSO 11683 11684=back 11685 11686=head2 DB - programmatic interface to the Perl debugging API (draft, 11687subject to 11688change) 11689 11690=over 4 11691 11692=item SYNOPSIS 11693 11694=item DESCRIPTION 11695 11696=over 4 11697 11698=item Global Variables 11699 11700 $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, 11701@DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, 11702$DB::lineno 11703 11704=item API Methods 11705 11706CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), 11707CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() 11708 11709=item Client Callback Methods 11710 11711CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), 11712CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), 11713CLIENT->output(LIST) 11714 11715=back 11716 11717=item BUGS 11718 11719=item AUTHOR 11720 11721=back 11722 11723=head2 DBM_Filter -- Filter DBM keys/values 11724 11725=over 4 11726 11727=item SYNOPSIS 11728 11729=item DESCRIPTION 11730 11731=item What is a DBM Filter? 11732 11733=over 4 11734 11735=item So what's new? 11736 11737=back 11738 11739=item METHODS 11740 11741=over 4 11742 11743=item $db->Filter_Push() 11744 11745=item $db->Filter_Key_Push() 11746 11747=item $db->Filter_Value_Push() 11748 11749Filter_Push, Filter_Key_Push, Filter_Value_Push 11750 11751=item $db->Filter_Pop() 11752 11753=item $db->Filtered() 11754 11755=back 11756 11757=item Writing a Filter 11758 11759=over 4 11760 11761=item Immediate Filters 11762 11763=item Canned Filters 11764 11765"name", params 11766 11767=back 11768 11769=item Filters Included 11770 11771utf8, encode, compress, int32, null 11772 11773=item NOTES 11774 11775=over 4 11776 11777=item Maintain Round Trip Integrity 11778 11779=item Don't mix filtered & non-filtered data in the same database file. 11780 11781=back 11782 11783=item EXAMPLE 11784 11785=item SEE ALSO 11786 11787=item AUTHOR 11788 11789=back 11790 11791=head2 DB_File - Perl5 access to Berkeley DB version 1.x 11792 11793=over 4 11794 11795=item SYNOPSIS 11796 11797=item DESCRIPTION 11798 11799B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> 11800 11801=over 4 11802 11803=item Using DB_File with Berkeley DB version 2 or greater 11804 11805=item Interface to Berkeley DB 11806 11807=item Opening a Berkeley DB Database File 11808 11809=item Default Parameters 11810 11811=item In Memory Databases 11812 11813=back 11814 11815=item DB_HASH 11816 11817=over 4 11818 11819=item A Simple Example 11820 11821=back 11822 11823=item DB_BTREE 11824 11825=over 4 11826 11827=item Changing the BTREE sort order 11828 11829=item Handling Duplicate Keys 11830 11831=item The get_dup() Method 11832 11833=item The find_dup() Method 11834 11835=item The del_dup() Method 11836 11837=item Matching Partial Keys 11838 11839=back 11840 11841=item DB_RECNO 11842 11843=over 4 11844 11845=item The 'bval' Option 11846 11847=item A Simple Example 11848 11849=item Extra RECNO Methods 11850 11851B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, 11852B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, 11853length, elements);> 11854 11855=item Another Example 11856 11857=back 11858 11859=item THE API INTERFACE 11860 11861B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = 11862$X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, 11863$flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, 11864$value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> 11865 11866=item DBM FILTERS 11867 11868B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, 11869B<filter_fetch_value> 11870 11871=over 4 11872 11873=item The Filter 11874 11875=item An Example -- the NULL termination problem. 11876 11877=item Another Example -- Key is a C int. 11878 11879=back 11880 11881=item HINTS AND TIPS 11882 11883=over 4 11884 11885=item Locking: The Trouble with fd 11886 11887=item Safe ways to lock a database 11888 11889B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> 11890 11891=item Sharing Databases With C Applications 11892 11893=item The untie() Gotcha 11894 11895=back 11896 11897=item COMMON QUESTIONS 11898 11899=over 4 11900 11901=item Why is there Perl source in my database? 11902 11903=item How do I store complex data structures with DB_File? 11904 11905=item What does "Invalid Argument" mean? 11906 11907=item What does "Bareword 'DB_File' not allowed" mean? 11908 11909=back 11910 11911=item REFERENCES 11912 11913=item HISTORY 11914 11915=item BUGS 11916 11917=item AVAILABILITY 11918 11919=item COPYRIGHT 11920 11921=item SEE ALSO 11922 11923=item AUTHOR 11924 11925=back 11926 11927=head2 Data::Dumper - stringified perl data structures, suitable for both 11928printing and C<eval> 11929 11930=over 4 11931 11932=item SYNOPSIS 11933 11934=item DESCRIPTION 11935 11936=over 4 11937 11938=item Methods 11939 11940I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> 11941I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), 11942I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), 11943I<$OBJ>->Reset 11944 11945=item Functions 11946 11947Dumper(I<LIST>) 11948 11949=item Configuration Variables or Methods 11950 11951=item Exports 11952 11953Dumper 11954 11955=back 11956 11957=item EXAMPLES 11958 11959=item BUGS 11960 11961=over 4 11962 11963=item NOTE 11964 11965=back 11966 11967=item AUTHOR 11968 11969=item VERSION 11970 11971=item SEE ALSO 11972 11973=back 11974 11975=head2 Devel::DProf - a Perl code profiler 11976 11977=over 4 11978 11979=item SYNOPSIS 11980 11981=item DESCRIPTION 11982 11983=item PROFILE FORMAT 11984 11985=item AUTOLOAD 11986 11987=item ENVIRONMENT 11988 11989=item BUGS 11990 11991=item SEE ALSO 11992 11993=back 11994 11995=head2 Devel::PPPort - Perl/Pollution/Portability 11996 11997=over 4 11998 11999=item SYNOPSIS 12000 12001=item DESCRIPTION 12002 12003=over 4 12004 12005=item WriteFile 12006 12007=back 12008 12009=item ppport.h 12010 12011=item AUTHOR 12012 12013=item SEE ALSO 12014 12015=back 12016 12017=head2 Devel::Peek - A data debugging tool for the XS programmer 12018 12019=over 4 12020 12021=item SYNOPSIS 12022 12023=item DESCRIPTION 12024 12025=over 4 12026 12027=item Runtime debugging 12028 12029=item Memory footprint debugging 12030 12031=back 12032 12033=item EXAMPLES 12034 12035=over 4 12036 12037=item A simple scalar string 12038 12039=item A simple scalar number 12040 12041=item A simple scalar with an extra reference 12042 12043=item A reference to a simple scalar 12044 12045=item A reference to an array 12046 12047=item A reference to a hash 12048 12049=item Dumping a large array or hash 12050 12051=item A reference to an SV which holds a C pointer 12052 12053=item A reference to a subroutine 12054 12055=back 12056 12057=item EXPORTS 12058 12059=item BUGS 12060 12061=item AUTHOR 12062 12063=item SEE ALSO 12064 12065=back 12066 12067=head2 Devel::SelfStubber - generate stubs for a SelfLoading module 12068 12069=over 4 12070 12071=item SYNOPSIS 12072 12073=item DESCRIPTION 12074 12075=back 12076 12077=head2 Digest - Modules that calculate message digests 12078 12079=over 4 12080 12081=item SYNOPSIS 12082 12083=item DESCRIPTION 12084 12085I<binary>, I<hex>, I<base64> 12086 12087=item OO INTERFACE 12088 12089$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = 12090Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, 12091$ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( 12092$data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, 12093$ctx->hexdigest, $ctx->b64digest 12094 12095=item Digest speed 12096 12097=item SEE ALSO 12098 12099=item AUTHOR 12100 12101=back 12102 12103=head2 Digest::MD5 - Perl interface to the MD5 Algorithm 12104 12105=over 4 12106 12107=item SYNOPSIS 12108 12109=item DESCRIPTION 12110 12111=item FUNCTIONS 12112 12113md5($data,...), md5_hex($data,...), md5_base64($data,...) 12114 12115=item METHODS 12116 12117$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), 12118$md5->addfile($io_handle), $md5->add_bits($data, $nbits), 12119$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest 12120 12121=item EXAMPLES 12122 12123=item SEE ALSO 12124 12125=item COPYRIGHT 12126 12127=item AUTHORS 12128 12129=back 12130 12131=head2 Digest::base - Digest base class 12132 12133=over 4 12134 12135=item SYNPOSIS 12136 12137=item DESCRIPTION 12138 12139=item SEE ALSO 12140 12141=back 12142 12143=head2 DirHandle - supply object methods for directory handles 12144 12145=over 4 12146 12147=item SYNOPSIS 12148 12149=item DESCRIPTION 12150 12151=item NOTES 12152 12153=back 12154 12155=head2 Dumpvalue - provides screen dump of Perl data. 12156 12157=over 4 12158 12159=item SYNOPSIS 12160 12161=item DESCRIPTION 12162 12163=over 4 12164 12165=item Creation 12166 12167C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, 12168C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, 12169C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, 12170stopDbSignal 12171 12172=item Methods 12173 12174dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, 12175compactDump, veryCompact, set, get 12176 12177=back 12178 12179=back 12180 12181=head2 DynaLoader - Dynamically load C libraries into Perl code 12182 12183=over 4 12184 12185=item SYNOPSIS 12186 12187=item DESCRIPTION 12188 12189@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, 12190@dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), 12191dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), 12192dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), 12193dl_install_xsub(), bootstrap() 12194 12195=item AUTHOR 12196 12197=back 12198 12199=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into 12200Perl code 12201 12202=over 4 12203 12204=item SYNOPSIS 12205 12206=item DESCRIPTION 12207 12208=over 4 12209 12210=item Migration from C<DynaLoader> 12211 12212=item Backward compatible boilerplate 12213 12214=back 12215 12216=item Order of initialization: early load() 12217 12218=over 4 12219 12220=item The most hairy case 12221 12222=back 12223 12224=item LIMITATIONS 12225 12226=item AUTHOR 12227 12228=back 12229 12230=head2 Encode - character encodings 12231 12232=over 4 12233 12234=item SYNOPSIS 12235 12236=over 4 12237 12238=item Table of Contents 12239 12240=back 12241 12242=item DESCRIPTION 12243 12244=over 4 12245 12246=item TERMINOLOGY 12247 12248=back 12249 12250=item PERL ENCODING API 12251 12252$octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, 12253$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, 12254CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, 12255CHECK]); 12256 12257=over 4 12258 12259=item Listing available encodings 12260 12261=item Defining Aliases 12262 12263=back 12264 12265=item Encoding via PerlIO 12266 12267=item Handling Malformed Data 12268 12269I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), 12270I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode 12271(I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = 12272Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The 12273bitmask 12274 12275=over 4 12276 12277=item Unimplemented fallback schemes 12278 12279=back 12280 12281=item Defining Encodings 12282 12283=item The UTF-8 flag 12284 12285Goal #1:, Goal #2:, Goal #3:, Goal #4: 12286 12287=over 4 12288 12289=item Messing with Perl's Internals 12290 12291is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) 12292 12293=back 12294 12295=item SEE ALSO 12296 12297=item MAINTAINER 12298 12299=back 12300 12301=head2 Encode::Alias - alias definitions to encodings 12302 12303=over 4 12304 12305=item SYNOPSIS 12306 12307=item DESCRIPTION 12308 12309As a simple string, As a qr// compiled regular expression, e.g.:, As a code 12310reference, e.g.: 12311 12312=over 4 12313 12314=item Alias overloading 12315 12316=back 12317 12318=item SEE ALSO 12319 12320=back 12321 12322=head2 Encode::Byte - Single Byte Encodings 12323 12324=over 4 12325 12326=item SYNOPSIS 12327 12328=item ABSTRACT 12329 12330=item DESCRIPTION 12331 12332=item SEE ALSO 12333 12334=back 12335 12336=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* 12337 12338=head2 Encode::CN - China-based Chinese Encodings 12339 12340=over 4 12341 12342=item SYNOPSIS 12343 12344=item DESCRIPTION 12345 12346=item NOTES 12347 12348=item BUGS 12349 12350=item SEE ALSO 12351 12352=back 12353 12354=head2 Encode::CN::HZ -- internally used by Encode::CN 12355 12356=head2 Encode::Config -- internally used by Encode 12357 12358=head2 Encode::EBCDIC - EBCDIC Encodings 12359 12360=over 4 12361 12362=item SYNOPSIS 12363 12364=item ABSTRACT 12365 12366=item DESCRIPTION 12367 12368=item SEE ALSO 12369 12370=back 12371 12372=head2 Encode::Encoding - Encode Implementation Base Class 12373 12374=over 4 12375 12376=item SYNOPSIS 12377 12378=item DESCRIPTION 12379 12380=over 4 12381 12382=item Methods you should implement 12383 12384-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), 12385-E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) 12386 12387=item Other methods defined in Encode::Encodings 12388 12389-E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines() 12390 12391=item Example: Encode::ROT13 12392 12393=back 12394 12395=item Why the heck Encode API is different? 12396 12397=over 4 12398 12399=item Compiled Encodings 12400 12401=back 12402 12403=item SEE ALSO 12404 12405Scheme 1, Scheme 2, Other Schemes 12406 12407=back 12408 12409=head2 Encode::Guess -- Guesses encoding from data 12410 12411=over 4 12412 12413=item SYNOPSIS 12414 12415=item ABSTRACT 12416 12417=item DESCRIPTION 12418 12419Encode::Guess->set_suspects, Encode::Guess->add_suspects, 12420Encode::decode("Guess" ...), Encode::Guess->guess($data), 12421guess_encoding($data, [, I<list of suspects>]) 12422 12423=item CAVEATS 12424 12425=item TO DO 12426 12427=item SEE ALSO 12428 12429=back 12430 12431=head2 Encode::JP - Japanese Encodings 12432 12433=over 4 12434 12435=item SYNOPSIS 12436 12437=item ABSTRACT 12438 12439=item DESCRIPTION 12440 12441=item Note on ISO-2022-JP(-1)? 12442 12443=item BUGS 12444 12445=item SEE ALSO 12446 12447=back 12448 12449=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* 12450 12451=head2 Encode::JP::JIS7 -- internally used by Encode::JP 12452 12453=head2 Encode::KR - Korean Encodings 12454 12455=over 4 12456 12457=item SYNOPSIS 12458 12459=item DESCRIPTION 12460 12461=item BUGS 12462 12463=item SEE ALSO 12464 12465=back 12466 12467=head2 Encode::KR::2022_KR -- internally used by Encode::KR 12468 12469=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding 12470 12471=over 4 12472 12473=item SYNOPSIS 12474 12475=item ABSTRACT 12476 12477=item DESCRIPTION 12478 12479=item BUGS 12480 12481=item SEE ALSO 12482 12483=back 12484 12485=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO 12486 12487=over 4 12488 12489=item Overview 12490 12491=item How does it work? 12492 12493=item Line Buffering 12494 12495=over 4 12496 12497=item How can I tell whether my encoding fully supports PerlIO ? 12498 12499=back 12500 12501=item SEE ALSO 12502 12503=back 12504 12505=head2 Encode::Supported -- Encodings supported by Encode 12506 12507=over 4 12508 12509=item DESCRIPTION 12510 12511=over 4 12512 12513=item Encoding Names 12514 12515=back 12516 12517=item Supported Encodings 12518 12519=over 4 12520 12521=item Built-in Encodings 12522 12523=item Encode::Unicode -- other Unicode encodings 12524 12525=item Encode::Byte -- Extended ASCII 12526 12527ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for 12528the Cyrillic world, gsm0338 - Hentai Latin 1 12529 12530=item CJK: Chinese, Japanese, Korean (Multibyte) 12531 12532Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, 12533Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, 12534Encode::JIS2K -- JIS X 0213 encodings via CPAN 12535 12536=item Miscellaneous encodings 12537 12538Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess 12539 12540=back 12541 12542=item Unsupported encodings 12543 12544 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, 12545Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran 12546System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, 12547Various Mac encodings, (Mac) Indic encodings 12548 12549=item Encoding vs. Charset -- terminology 12550 12551=item Encoding Classification (by Anton Tagunov and Dan Kogai) 12552 12553=over 4 12554 12555=item Microsoft-related naming mess 12556 12557KS_C_5601-1987, GB2312, Big5, Shift_JIS 12558 12559=back 12560 12561=item Glossary 12562 12563character repertoire, coded character set (CCS), character encoding scheme 12564(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, 12565UTF-16 12566 12567=item See Also 12568 12569=item References 12570 12571ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, 12572RFC, UC, Unicode Glossary 12573 12574=over 4 12575 12576=item Other Notable Sites 12577 12578czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: 12579"Introduction to i18n" 12580 12581=item Offline sources 12582 12583C<CJKV Information Processing> by Ken Lunde 12584 12585=back 12586 12587=back 12588 12589=head2 Encode::Symbol - Symbol Encodings 12590 12591=over 4 12592 12593=item SYNOPSIS 12594 12595=item ABSTRACT 12596 12597=item DESCRIPTION 12598 12599=item SEE ALSO 12600 12601=back 12602 12603=head2 Encode::TW - Taiwan-based Chinese Encodings 12604 12605=over 4 12606 12607=item SYNOPSIS 12608 12609=item DESCRIPTION 12610 12611=item NOTES 12612 12613=item BUGS 12614 12615=item SEE ALSO 12616 12617=back 12618 12619=head2 Encode::Unicode -- Various Unicode Transformation Formats 12620 12621=over 4 12622 12623=item SYNOPSIS 12624 12625=item ABSTRACT 12626 12627L<http://www.unicode.org/glossary/> says:, Quick Reference 12628 12629=item Size, Endianness, and BOM 12630 12631=over 4 12632 12633=item by size 12634 12635=item by endianness 12636 12637BOM as integer when fetched in network byte order 12638 12639=back 12640 12641=item Surrogate Pairs 12642 12643=item SEE ALSO 12644 12645=back 12646 12647=head2 Encode::Unicode::UTF7 -- UTF-7 encoding 12648 12649=over 4 12650 12651=item SYNOPSIS 12652 12653=item ABSTRACT 12654 12655=item In Practice 12656 12657=item SEE ALSO 12658 12659=back 12660 12661=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to 12662encodings 12663 12664=over 4 12665 12666=item SYNOPSIS 12667 12668=item DESCRIPTION 12669 12670As a simple string, As a qr// compiled regular expression, e.g.:, As a code 12671reference, e.g.: 12672 12673=over 4 12674 12675=item Alias overloading 12676 12677=back 12678 12679=item SEE ALSO 12680 12681=back 12682 12683=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- 12684Internally used by Encode::??::ISO_2022_* 12685 12686=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by 12687Encode::CN 12688 12689=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by 12690Encode 12691 12692=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode 12693Implementation Base Class 12694 12695=over 4 12696 12697=item SYNOPSIS 12698 12699=item DESCRIPTION 12700 12701=over 4 12702 12703=item Methods you should implement 12704 12705-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), 12706-E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) 12707 12708=item Other methods defined in Encode::Encodings 12709 12710-E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines() 12711 12712=item Example: Encode::ROT13 12713 12714=back 12715 12716=item Why the heck Encode API is different? 12717 12718=over 4 12719 12720=item Compiled Encodings 12721 12722=back 12723 12724=item SEE ALSO 12725 12726Scheme 1, Scheme 2, Other Schemes 12727 12728=back 12729 12730=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from 12731data 12732 12733=over 4 12734 12735=item SYNOPSIS 12736 12737=item ABSTRACT 12738 12739=item DESCRIPTION 12740 12741Encode::Guess->set_suspects, Encode::Guess->add_suspects, 12742Encode::decode("Guess" ...), Encode::Guess->guess($data), 12743guess_encoding($data, [, I<list of suspects>]) 12744 12745=item CAVEATS 12746 12747=item TO DO 12748 12749=item SEE ALSO 12750 12751=back 12752 12753=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by 12754Encode::JP::2022_JP* 12755 12756=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used 12757by Encode::JP 12758 12759=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally 12760used by Encode::KR 12761 12762=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' 12763and 'Q' header encoding 12764 12765=over 4 12766 12767=item SYNOPSIS 12768 12769=item ABSTRACT 12770 12771=item DESCRIPTION 12772 12773=item BUGS 12774 12775=item SEE ALSO 12776 12777=back 12778 12779=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document 12780on Encode and PerlIO 12781 12782=over 4 12783 12784=item Overview 12785 12786=item How does it work? 12787 12788=item Line Buffering 12789 12790=over 4 12791 12792=item How can I tell whether my encoding fully supports PerlIO ? 12793 12794=back 12795 12796=item SEE ALSO 12797 12798=back 12799 12800=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings 12801supported by Encode 12802 12803=over 4 12804 12805=item DESCRIPTION 12806 12807=over 4 12808 12809=item Encoding Names 12810 12811=back 12812 12813=item Supported Encodings 12814 12815=over 4 12816 12817=item Built-in Encodings 12818 12819=item Encode::Unicode -- other Unicode encodings 12820 12821=item Encode::Byte -- Extended ASCII 12822 12823ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for 12824the Cyrillic world, gsm0338 - Hentai Latin 1 12825 12826=item CJK: Chinese, Japanese, Korean (Multibyte) 12827 12828Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, 12829Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, 12830Encode::JIS2K -- JIS X 0213 encodings via CPAN 12831 12832=item Miscellaneous encodings 12833 12834Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess 12835 12836=back 12837 12838=item Unsupported encodings 12839 12840 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, 12841Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran 12842System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, 12843Various Mac encodings, (Mac) Indic encodings 12844 12845=item Encoding vs. Charset -- terminology 12846 12847=item Encoding Classification (by Anton Tagunov and Dan Kogai) 12848 12849=over 4 12850 12851=item Microsoft-related naming mess 12852 12853KS_C_5601-1987, GB2312, Big5, Shift_JIS 12854 12855=back 12856 12857=item Glossary 12858 12859character repertoire, coded character set (CCS), character encoding scheme 12860(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, 12861UTF-16 12862 12863=item See Also 12864 12865=item References 12866 12867ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, 12868RFC, UC, Unicode Glossary 12869 12870=over 4 12871 12872=item Other Notable Sites 12873 12874czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: 12875"Introduction to i18n" 12876 12877=item Offline sources 12878 12879C<CJKV Information Processing> by Ken Lunde 12880 12881=back 12882 12883=back 12884 12885=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 12886encoding 12887 12888=over 4 12889 12890=item SYNOPSIS 12891 12892=item ABSTRACT 12893 12894=item In Practice 12895 12896=item SEE ALSO 12897 12898=back 12899 12900=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder 12901 12902=over 4 12903 12904=item SYNOPSIS 12905 12906=item ABSTRACT 12907 12908=item Description 12909 12910=over 4 12911 12912=item Predefined Methods 12913 12914$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), 12915$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), 12916$e-E<gt>bytes([$encoding]) 12917 12918=item Example: base64 transcoder 12919 12920=item Operator Overloading 12921 12922=back 12923 12924=item SEE ALSO 12925 12926=back 12927 12928=head2 Encodencoding, encoding - allows you to write your script in 12929non-ascii or non-utf8 12930 12931=over 4 12932 12933=item SYNOPSIS 12934 12935=item ABSTRACT 12936 12937=over 4 12938 12939=item Literal Conversions 12940 12941=item PerlIO layers for C<STD(IN|OUT)> 12942 12943=item Implicit upgrading for byte strings 12944 12945=back 12946 12947=item FEATURES THAT REQUIRE 5.8.1 12948 12949"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle 12950 12951=item USAGE 12952 12953use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> 12954I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; 12955 12956=item The Filter Option 12957 12958=over 4 12959 12960=item Filter-related changes at Encode version 1.87 12961 12962=back 12963 12964=item CAVEATS 12965 12966=over 4 12967 12968=item NOT SCOPED 12969 12970=item DO NOT MIX MULTIPLE ENCODINGS 12971 12972=item tr/// with ranges 12973 12974Legend of characters above 12975 12976=back 12977 12978=item EXAMPLE - Greekperl 12979 12980=item KNOWN PROBLEMS 12981 12982literals in regex that are longer than 127 bytes, EBCDIC, format 12983 12984=item HISTORY 12985 12986=item SEE ALSO 12987 12988=back 12989 12990=head2 Encoder, Encode::Encoder -- Object Oriented Encoder 12991 12992=over 4 12993 12994=item SYNOPSIS 12995 12996=item ABSTRACT 12997 12998=item Description 12999 13000=over 4 13001 13002=item Predefined Methods 13003 13004$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), 13005$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), 13006$e-E<gt>bytes([$encoding]) 13007 13008=item Example: base64 transcoder 13009 13010=item Operator Overloading 13011 13012=back 13013 13014=item SEE ALSO 13015 13016=back 13017 13018=head2 English - use nice English (or awk) names for ugly punctuation 13019variables 13020 13021=over 4 13022 13023=item SYNOPSIS 13024 13025=item DESCRIPTION 13026 13027=item PERFORMANCE 13028 13029=back 13030 13031=head2 Env - perl module that imports environment variables as scalars or 13032arrays 13033 13034=over 4 13035 13036=item SYNOPSIS 13037 13038=item DESCRIPTION 13039 13040=item LIMITATIONS 13041 13042=item AUTHOR 13043 13044=back 13045 13046=head2 Errno - System errno constants 13047 13048=over 4 13049 13050=item SYNOPSIS 13051 13052=item DESCRIPTION 13053 13054=item CAVEATS 13055 13056=item AUTHOR 13057 13058=item COPYRIGHT 13059 13060=back 13061 13062=head2 Exporter - Implements default import method for modules 13063 13064=over 4 13065 13066=item SYNOPSIS 13067 13068=item DESCRIPTION 13069 13070=over 4 13071 13072=item How to Export 13073 13074=item Selecting What To Export 13075 13076=item How to Import 13077 13078C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> 13079 13080=back 13081 13082=item Advanced features 13083 13084=over 4 13085 13086=item Specialised Import Lists 13087 13088=item Exporting without using Exporter's import method 13089 13090=item Exporting without inheriting from Exporter 13091 13092=item Module Version Checking 13093 13094=item Managing Unknown Symbols 13095 13096=item Tag Handling Utility Functions 13097 13098=item Generating combined tags 13099 13100=item C<AUTOLOAD>ed Constants 13101 13102=back 13103 13104=back 13105 13106=head2 Exporter::Heavy - Exporter guts 13107 13108=over 4 13109 13110=item SYNOPSIS 13111 13112=item DESCRIPTION 13113 13114=back 13115 13116=head2 ExtUtils::Command - utilities to replace common UNIX commands in 13117Makefiles etc. 13118 13119=over 4 13120 13121=item SYNOPSIS 13122 13123=item DESCRIPTION 13124 13125=back 13126 13127cat 13128 13129eqtime src dst 13130 13131rm_rf files... 13132 13133rm_f files... 13134 13135touch files .. 13136 13137mv source... destination 13138 13139cp source... destination 13140 13141chmod mode files.. 13142 13143mkpath directory.. 13144 13145test_f file 13146 13147=over 4 13148 13149=item BUGS 13150 13151=item SEE ALSO 13152 13153=item AUTHOR 13154 13155=back 13156 13157=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles 13158 13159=over 4 13160 13161=item SYNOPSIS 13162 13163=item DESCRIPTION 13164 13165B<test_harness> 13166 13167=back 13168 13169B<pod2man> 13170 13171B<warn_if_old_packlist> 13172 13173B<perllocal_install> 13174 13175B<uninstall> 13176 13177=head2 ExtUtils::Constant - generate XS code to import C header constants 13178 13179=over 4 13180 13181=item SYNOPSIS 13182 13183=item DESCRIPTION 13184 13185=item USAGE 13186 13187IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF 13188 13189=item FUNCTIONS 13190 13191=back 13192 13193C_stringify NAME 13194 13195perl_stringify NAME 13196 13197constant_types 13198 13199memEQ_clause NAME, CHECKED_AT, INDENT 13200 13201assign INDENT, TYPE, PRE, POST, VALUE.. 13202 13203return_clause 13204 13205switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. 13206 13207params WHAT 13208 13209dump_names 13210 13211dogfood 13212 13213C_constant, name, type, value, macro, default, pre, post, def_pre =item 13214def_post, utf8 13215 13216XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME 13217 13218autoload PACKAGE, VERSION, AUTOLOADER 13219 13220WriteMakefileSnippet 13221 13222WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, 13223BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME 13224 13225=over 4 13226 13227=item AUTHOR 13228 13229=back 13230 13231=head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications 13232 13233=over 4 13234 13235=item SYNOPSIS 13236 13237=item DESCRIPTION 13238 13239=item @EXPORT 13240 13241=item FUNCTIONS 13242 13243xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), 13244ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) 13245 13246=item EXAMPLES 13247 13248=item SEE ALSO 13249 13250=item AUTHOR 13251 13252=back 13253 13254=head2 ExtUtils::Install - install files from here to there 13255 13256=over 4 13257 13258=item SYNOPSIS 13259 13260=item DESCRIPTION 13261 13262=over 4 13263 13264=item Functions 13265 13266B<install> 13267 13268=back 13269 13270=back 13271 13272B<install_default> I<DISCOURAGED> 13273 13274B<uninstall> 13275 13276B<pm_to_blib> 13277 13278_autosplit 13279 13280=over 4 13281 13282=item ENVIRONMENT 13283 13284B<PERL_INSTALL_ROOT> 13285 13286=item AUTHOR 13287 13288=item LICENSE 13289 13290=back 13291 13292=head2 ExtUtils::Installed - Inventory management of installed modules 13293 13294=over 4 13295 13296=item SYNOPSIS 13297 13298=item DESCRIPTION 13299 13300=item USAGE 13301 13302=item FUNCTIONS 13303 13304new(), modules(), files(), directories(), directory_tree(), validate(), 13305packlist(), version() 13306 13307=item EXAMPLE 13308 13309=item AUTHOR 13310 13311=back 13312 13313=head2 ExtUtils::Liblist - determine libraries to use and how to use them 13314 13315=over 4 13316 13317=item SYNOPSIS 13318 13319=item DESCRIPTION 13320 13321For static extensions, For dynamic extensions at build/link time, For 13322dynamic extensions at load time 13323 13324=over 4 13325 13326=item EXTRALIBS 13327 13328=item LDLOADLIBS and LD_RUN_PATH 13329 13330=item BSLOADLIBS 13331 13332=back 13333 13334=item PORTABILITY 13335 13336=over 4 13337 13338=item VMS implementation 13339 13340=item Win32 implementation 13341 13342=back 13343 13344=item SEE ALSO 13345 13346=back 13347 13348=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass 13349 13350=over 4 13351 13352=item SYNOPSIS 13353 13354=item DESCRIPTION 13355 13356=back 13357 13358=head2 ExtUtils::MM_Any - Platform-agnostic MM methods 13359 13360=over 4 13361 13362=item SYNOPSIS 13363 13364=item DESCRIPTION 13365 13366=item Inherently Cross-Platform Methods 13367 13368installvars 13369 13370=back 13371 13372os_flavor_is 13373 13374=over 4 13375 13376=item File::Spec wrappers 13377 13378catfile 13379 13380=back 13381 13382=over 4 13383 13384=item Thought To Be Cross-Platform Methods 13385 13386B<split_command> 13387 13388=back 13389 13390B<echo> 13391 13392init_VERSION 13393 13394wraplist 13395 13396manifypods 13397 13398manifypods_target 13399 13400makemakerdflt_target 13401 13402special_targets 13403 13404POD2MAN_macro 13405 13406test_via_harness 13407 13408test_via_script 13409 13410libscan 13411 13412tool_autosplit 13413 13414all_target 13415 13416metafile_target 13417 13418metafile_addtomanifest_target 13419 13420=over 4 13421 13422=item Abstract methods 13423 13424oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len, 13425B<init_others>, init_DIRFILESEP, init_linker, init_platform, 13426platform_constants 13427 13428=back 13429 13430os_flavor 13431 13432=over 4 13433 13434=item AUTHOR 13435 13436=back 13437 13438=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in 13439ExtUtils::MakeMaker 13440 13441=over 4 13442 13443=item SYNOPSIS 13444 13445=item DESCRIPTION 13446 13447=back 13448 13449os_flavor (o) 13450 13451init_linker 13452 13453=head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in 13454ExtUtils::MakeMaker 13455 13456=over 4 13457 13458=item SYNOPSIS 13459 13460=item DESCRIPTION 13461 13462os_flavor (o) 13463 13464=back 13465 13466cflags (o) 13467 13468replace_manpage_separator (o) 13469 13470init_linker 13471 13472=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix 13473 13474=over 4 13475 13476=item SYNOPSIS 13477 13478=item DESCRIPTION 13479 13480=over 4 13481 13482=item Overridden methods 13483 13484os_flavor 13485 13486=back 13487 13488=back 13489 13490B<replace_manpage_separator> 13491 13492=over 4 13493 13494=item AUTHOR 13495 13496=item SEE ALSO 13497 13498=back 13499 13500=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in 13501ExtUtils::MakeMaker 13502 13503=over 4 13504 13505=item SYNOPSIS 13506 13507=item DESCRIPTION 13508 13509=back 13510 13511maybe_command 13512 13513guess_name 13514 13515macify 13516 13517patternify 13518 13519init_main 13520 13521init_others 13522 13523init_platform, platform_constants 13524 13525init_dirscan 13526 13527init_VERSION (o) 13528 13529special_targets (o) 13530 13531static (o) 13532 13533dlsyms (o) 13534 13535dynamic (o) 13536 13537clean (o) 13538 13539clean_subdirs_target 13540 13541realclean (o) 13542 13543realclean_subdirs_target 13544 13545rulez (o) 13546 13547processPL (o) 13548 13549os_flavor 13550 13551=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in 13552ExtUtils::MakeMaker 13553 13554=over 4 13555 13556=item SYNOPSIS 13557 13558=item DESCRIPTION 13559 13560=back 13561 13562os_flavor 13563 13564init_platform (o), platform_constants 13565 13566const_cccmd (o) 13567 13568static_lib (o) 13569 13570dynamic_lib (o) 13571 13572=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in 13573ExtUtils::MakeMaker 13574 13575=over 4 13576 13577=item SYNOPSIS 13578 13579=item DESCRIPTION 13580 13581=item METHODS 13582 13583init_dist (o) 13584 13585=back 13586 13587init_linker 13588 13589os_flavor 13590 13591=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix 13592 13593=over 4 13594 13595=item SYNOPSIS 13596 13597=item DESCRIPTION 13598 13599=over 4 13600 13601=item Overridden methods 13602 13603os_flavor 13604 13605=back 13606 13607=back 13608 13609B<replace_manpage_separator> 13610 13611=over 4 13612 13613=item AUTHOR 13614 13615=item SEE ALSO 13616 13617=back 13618 13619=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker 13620 13621=over 4 13622 13623=item SYNOPSIS 13624 13625=item DESCRIPTION 13626 13627=item METHODS 13628 13629=back 13630 13631=over 4 13632 13633=item Methods 13634 13635os_flavor (o) 13636 13637=back 13638 13639c_o (o) 13640 13641cflags (o) 13642 13643clean (o) 13644 13645clean_subdirs_target 13646 13647const_cccmd (o) 13648 13649const_config (o) 13650 13651const_loadlibs (o) 13652 13653constants (o) 13654 13655depend (o) 13656 13657dir_target (o) 13658 13659init_DEST 13660 13661init_dist 13662 13663dist (o) 13664 13665dist_basics (o) 13666 13667dist_ci (o) 13668 13669dist_core (o) 13670 13671B<dist_target> 13672 13673B<tardist_target> 13674 13675B<zipdist_target> 13676 13677B<tarfile_target> 13678 13679zipfile_target 13680 13681uutardist_target 13682 13683shdist_target 13684 13685distdir 13686 13687dist_test 13688 13689dlsyms (o) 13690 13691dynamic (o) 13692 13693dynamic_bs (o) 13694 13695dynamic_lib (o) 13696 13697exescan 13698 13699extliblist 13700 13701find_perl 13702 13703find_tests 13704 13705=over 4 13706 13707=item Methods to actually produce chunks of text for the Makefile 13708 13709fixin 13710 13711=back 13712 13713force (o) 13714 13715guess_name 13716 13717has_link_code 13718 13719init_dirscan 13720 13721init_DIRFILESEP 13722 13723init_main 13724 13725init_others 13726 13727init_INST 13728 13729init_INSTALL 13730 13731init_linker 13732 13733init_lib2arch 13734 13735init_PERL 13736 13737init_platform (o), platform_constants (o) 13738 13739init_PERM 13740 13741init_xs 13742 13743install (o) 13744 13745installbin (o) 13746 13747linkext (o) 13748 13749lsdir 13750 13751macro (o) 13752 13753makeaperl (o) 13754 13755makefile (o) 13756 13757maybe_command 13758 13759needs_linking (o) 13760 13761nicetext 13762 13763parse_abstract 13764 13765parse_version 13766 13767pasthru (o) 13768 13769perl_script 13770 13771perldepend (o) 13772 13773perm_rw (o) 13774 13775perm_rwx (o) 13776 13777pm_to_blib 13778 13779post_constants (o) 13780 13781post_initialize (o) 13782 13783postamble (o) 13784 13785ppd 13786 13787prefixify 13788 13789processPL (o) 13790 13791quote_paren 13792 13793realclean (o) 13794 13795realclean_subdirs_target 13796 13797replace_manpage_separator 13798 13799oneliner (o) 13800 13801quote_literal 13802 13803escape_newlines 13804 13805max_exec_len 13806 13807static (o) 13808 13809static_lib (o) 13810 13811staticmake (o) 13812 13813subdir_x (o) 13814 13815subdirs (o) 13816 13817test (o) 13818 13819test_via_harness (override) 13820 13821test_via_script (override) 13822 13823tools_other (o) 13824 13825tool_xsubpp (o) 13826 13827all_target 13828 13829top_targets (o) 13830 13831writedoc 13832 13833xs_c (o) 13834 13835xs_cpp (o) 13836 13837xs_o (o) 13838 13839=over 4 13840 13841=item SEE ALSO 13842 13843=back 13844 13845=head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in 13846ExtUtils::MakeMaker 13847 13848=over 4 13849 13850=item SYNOPSIS 13851 13852=item DESCRIPTION 13853 13854=over 4 13855 13856=item Methods always loaded 13857 13858wraplist 13859 13860=back 13861 13862=back 13863 13864=over 4 13865 13866=item Methods 13867 13868guess_name (override) 13869 13870=back 13871 13872find_perl (override) 13873 13874maybe_command (override) 13875 13876perl_script (override) 13877 13878replace_manpage_separator 13879 13880init_DEST 13881 13882init_DIRFILESEP 13883 13884init_main (override) 13885 13886init_others (override) 13887 13888init_platform (override) 13889 13890platform_constants 13891 13892init_VERSION (override) 13893 13894constants (override) 13895 13896special_targets 13897 13898cflags (override) 13899 13900const_cccmd (override) 13901 13902tool_sxubpp (override) 13903 13904tools_other (override) 13905 13906init_dist (override) 13907 13908c_o (override) 13909 13910xs_c (override) 13911 13912xs_o (override) 13913 13914dlsyms (override) 13915 13916dynamic_lib (override) 13917 13918dynamic_bs (override) 13919 13920static_lib (override) 13921 13922processPL (override) 13923 13924installbin (override) 13925 13926subdir_x (override) 13927 13928clean (override) 13929 13930clean_subdirs_target 13931 13932realclean (override) 13933 13934zipfile_target (o), tarfile_target (o), shdist_target (o) 13935 13936dist_test (override) 13937 13938install (override) 13939 13940perldepend (override) 13941 13942makefile (override) 13943 13944find_tests (override) 13945 13946test (override) 13947 13948makeaperl (override) 13949 13950nicetext (override) 13951 13952prefixify (override) 13953 13954oneliner (o) 13955 13956B<echo> (o) 13957 13958quote_literal 13959 13960escape_newlines 13961 13962max_exec_len 13963 13964init_linker (o) 13965 13966eliminate_macros 13967 13968fixpath 13969 13970os_flavor 13971 13972=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in 13973ExtUtils::MakeMaker 13974 13975=over 4 13976 13977=item SYNOPSIS 13978 13979=item DESCRIPTION 13980 13981=back 13982 13983=over 4 13984 13985=item Overridden methods 13986 13987B<dlsyms> 13988 13989=back 13990 13991replace_manpage_separator 13992 13993B<maybe_command> 13994 13995B<find_tests> 13996 13997B<init_DIRFILESEP> 13998 13999B<init_others> 14000 14001init_platform (o), platform_constants (o) 14002 14003special_targets (o) 14004 14005static_lib (o) 14006 14007dynamic_lib (o) 14008 14009clean 14010 14011init_linker 14012 14013perl_script 14014 14015xs_o (o) 14016 14017pasthru (o) 14018 14019oneliner (o) 14020 14021max_exec_len 14022 14023os_flavor 14024 14025=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X 14026 14027=over 4 14028 14029=item SYNOPSIS 14030 14031=item DESCRIPTION 14032 14033=over 4 14034 14035=item Overriden methods 14036 14037dist_test 14038 14039=back 14040 14041=back 14042 14043subdir_x 14044 14045xs_c 14046 14047xs_cpp 14048 14049xs_o 14050 14051clean_subdirs_target 14052 14053realclean_subdirs_target 14054 14055os_flavor 14056 14057=over 4 14058 14059=item AUTHOR 14060 14061=back 14062 14063=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization 14064 14065=over 4 14066 14067=item SYNOPSIS 14068 14069=item DESCRIPTION 14070 14071=back 14072 14073=head2 ExtUtils::MakeMaker - Create a module Makefile 14074 14075=over 4 14076 14077=item SYNOPSIS 14078 14079=item DESCRIPTION 14080 14081=over 4 14082 14083=item How To Write A Makefile.PL 14084 14085=item Default Makefile Behaviour 14086 14087=item make test 14088 14089=item make testdb 14090 14091=item make install 14092 14093=item PREFIX and LIB attribute 14094 14095=item AFS users 14096 14097=item Static Linking of a new Perl Binary 14098 14099=item Determination of Perl Library and Installation Locations 14100 14101=item Which architecture dependent directory? 14102 14103=item Using Attributes and Parameters 14104 14105ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, 14106CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, 14107EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, 14108FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, 14109INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, 14110INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, 14111INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, 14112INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, 14113INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, 14114INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, 14115LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, 14116MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, 14117OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, 14118PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, 14119PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, 14120PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, 14121PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, 14122VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION 14123 14124=item Additional lowercase attributes 14125 14126clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, 14127test, tool_autosplit 14128 14129=item Overriding MakeMaker Methods 14130 14131=item The End Of Cargo Cult Programming 14132 14133C<<MAN3PODS => ' '>> 14134 14135=item Hintsfile support 14136 14137=item Distribution Support 14138 14139 make distcheck, make skipcheck, make distclean, make manifest, 14140 make distdir, make disttest, make tardist, make dist, make 14141uutardist, make shdist, make zipdist, make ci 14142 14143=item Module Meta-Data 14144 14145=item Disabling an extension 14146 14147=item Other Handy Functions 14148 14149prompt 14150 14151=back 14152 14153=item ENVIRONMENT 14154 14155PERL_MM_OPT, PERL_MM_USE_DEFAULT 14156 14157=item SEE ALSO 14158 14159=item AUTHORS 14160 14161=item LICENSE 14162 14163=back 14164 14165=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About 14166MakeMaker 14167 14168=over 4 14169 14170=item DESCRIPTION 14171 14172=over 4 14173 14174=item Philosophy and History 14175 14176Why not just use <insert other build config tool here>?, What's 14177Module::Build and how does it relate to MakeMaker?, pure perl. no make, no 14178shell commands, easier to customize, cleaner internals, less cruft 14179 14180=item Module Writing 14181 14182How do I keep my $VERSION up to date without resetting it manually?, What's 14183this F<META.yml> thing and how did it get in my F<MANIFEST>?! 14184 14185=item XS 14186 14187How to I prevent "object version X.XX does not match bootstrap parameter 14188Y.YY" errors?, How do I make two or more XS files coexist in the same 14189directory? 14190 14191=back 14192 14193=item PATCHING 14194 14195=item AUTHOR 14196 14197=item SEE ALSO 14198 14199=back 14200 14201=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker 14202 14203=over 4 14204 14205=item SYNOPSIS 14206 14207=item DESCRIPTION 14208 14209=over 4 14210 14211=item The Mantra 14212 14213=item The Layout 14214 14215Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, 14216bin/ 14217 14218=back 14219 14220=item SEE ALSO 14221 14222=back 14223 14224=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm 14225 14226=over 4 14227 14228=item SYNOPSIS 14229 14230=item DESCRIPTION 14231 14232=back 14233 14234=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm 14235 14236=over 4 14237 14238=item SYNOPSIS 14239 14240=item DESCRIPTION 14241 14242=back 14243 14244=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file 14245 14246=over 4 14247 14248=item SYNOPSIS 14249 14250=item DESCRIPTION 14251 14252=over 4 14253 14254=item Functions 14255 14256mkmanifest 14257 14258=back 14259 14260=back 14261 14262manifind 14263 14264manicheck 14265 14266filecheck 14267 14268fullcheck 14269 14270skipcheck 14271 14272maniread 14273 14274manicopy 14275 14276maniadd 14277 14278=over 4 14279 14280=item MANIFEST 14281 14282=item MANIFEST.SKIP 14283 14284=item EXPORT_OK 14285 14286=item GLOBAL VARIABLES 14287 14288=back 14289 14290=over 4 14291 14292=item DIAGNOSTICS 14293 14294C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, 14295C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> 14296 14297=item ENVIRONMENT 14298 14299B<PERL_MM_MANIFEST_DEBUG> 14300 14301=item SEE ALSO 14302 14303=item AUTHOR 14304 14305=back 14306 14307=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c 14308 14309=over 4 14310 14311=item SYNOPSIS 14312 14313=item DESCRIPTION 14314 14315=item SEE ALSO 14316 14317=back 14318 14319=head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader 14320 14321=over 4 14322 14323=item SYNOPSIS 14324 14325=item DESCRIPTION 14326 14327=back 14328 14329=head2 ExtUtils::Mksymlists - write linker options files for dynamic 14330extension 14331 14332=over 4 14333 14334=item SYNOPSIS 14335 14336=item DESCRIPTION 14337 14338DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME 14339 14340=item AUTHOR 14341 14342=item REVISION 14343 14344=back 14345 14346=head2 ExtUtils::Packlist - manage .packlist files 14347 14348=over 4 14349 14350=item SYNOPSIS 14351 14352=item DESCRIPTION 14353 14354=item USAGE 14355 14356=item FUNCTIONS 14357 14358new(), read(), write(), validate(), packlist_file() 14359 14360=item EXAMPLE 14361 14362=item AUTHOR 14363 14364=back 14365 14366=head2 ExtUtils::testlib - add blib/* directories to @INC 14367 14368=over 4 14369 14370=item SYNOPSIS 14371 14372=item DESCRIPTION 14373 14374=back 14375 14376=head2 Fatal - replace functions with equivalents which succeed or die 14377 14378=over 4 14379 14380=item SYNOPSIS 14381 14382=item DESCRIPTION 14383 14384=item AUTHOR 14385 14386=back 14387 14388=head2 Fcntl - load the C Fcntl.h defines 14389 14390=over 4 14391 14392=item SYNOPSIS 14393 14394=item DESCRIPTION 14395 14396=item NOTE 14397 14398=item EXPORTED SYMBOLS 14399 14400=back 14401 14402=head2 File::Basename, fileparse - split a pathname into pieces 14403 14404=over 4 14405 14406=item SYNOPSIS 14407 14408=item DESCRIPTION 14409 14410fileparse_set_fstype, fileparse 14411 14412=item EXAMPLES 14413 14414C<basename>, C<dirname> 14415 14416=back 14417 14418=head2 File::CheckTree, validate - run many filetest checks on a tree 14419 14420=over 4 14421 14422=item SYNOPSIS 14423 14424=item DESCRIPTION 14425 14426=item AUTHOR 14427 14428=item HISTORY 14429 14430=back 14431 14432=head2 File::Compare - Compare files or filehandles 14433 14434=over 4 14435 14436=item SYNOPSIS 14437 14438=item DESCRIPTION 14439 14440=item RETURN 14441 14442=item AUTHOR 14443 14444=back 14445 14446=head2 File::Copy - Copy files or filehandles 14447 14448=over 4 14449 14450=item SYNOPSIS 14451 14452=item DESCRIPTION 14453 14454=over 4 14455 14456=item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) 14457 14458rmscopy($from,$to[,$date_flag]) 14459 14460=back 14461 14462=item RETURN 14463 14464=item NOTES 14465 14466=item AUTHOR 14467 14468=back 14469 14470=head2 File::DosGlob - DOS like globbing and then some 14471 14472=over 4 14473 14474=item SYNOPSIS 14475 14476=item DESCRIPTION 14477 14478=item NOTES 14479 14480=item EXPORTS (by request only) 14481 14482=item BUGS 14483 14484=item AUTHOR 14485 14486=item HISTORY 14487 14488=item SEE ALSO 14489 14490=back 14491 14492=head2 File::Find - Traverse a directory tree. 14493 14494=over 4 14495 14496=item SYNOPSIS 14497 14498=item DESCRIPTION 14499 14500B<find>, B<finddepth> 14501 14502=over 4 14503 14504=item %options 14505 14506C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, 14507C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, 14508C<untaint>, C<untaint_pattern>, C<untaint_skip> 14509 14510=item The wanted function 14511 14512C<$File::Find::dir> is the current directory name,, C<$_> is the current 14513filename within that directory, C<$File::Find::name> is the complete 14514pathname to the file 14515 14516=back 14517 14518=item WARNINGS 14519 14520=item CAVEAT 14521 14522$dont_use_nlink, symlinks 14523 14524=item NOTES 14525 14526=item BUGS AND CAVEATS 14527 14528=item HISTORY 14529 14530=back 14531 14532=head2 File::Glob - Perl extension for BSD glob routine 14533 14534=over 4 14535 14536=item SYNOPSIS 14537 14538=item DESCRIPTION 14539 14540C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, 14541C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, 14542C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> 14543 14544=item DIAGNOSTICS 14545 14546C<GLOB_NOSPACE>, C<GLOB_ABEND> 14547 14548=item NOTES 14549 14550=item AUTHOR 14551 14552=back 14553 14554=head2 File::Path - create or remove directory trees 14555 14556=over 4 14557 14558=item SYNOPSIS 14559 14560=item DESCRIPTION 14561 14562=item DIAGNOSTICS 14563 14564=item AUTHORS 14565 14566=back 14567 14568=head2 File::Spec - portably perform operations on file names 14569 14570=over 4 14571 14572=item SYNOPSIS 14573 14574=item DESCRIPTION 14575 14576=item METHODS 14577 14578canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, 14579no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, 14580splitdir, catpath(), abs2rel, rel2abs() 14581 14582=item SEE ALSO 14583 14584=item AUTHORS 14585 14586=back 14587 14588=head2 File::Spec::Cygwin - methods for Cygwin file specs 14589 14590=over 4 14591 14592=item SYNOPSIS 14593 14594=item DESCRIPTION 14595 14596=back 14597 14598canonpath 14599 14600file_name_is_absolute 14601 14602tmpdir (override) 14603 14604=head2 File::Spec::Epoc - methods for Epoc file specs 14605 14606=over 4 14607 14608=item SYNOPSIS 14609 14610=item DESCRIPTION 14611 14612=item AUTHORS 14613 14614=back 14615 14616canonpath() 14617 14618=over 4 14619 14620=item SEE ALSO 14621 14622=back 14623 14624=head2 File::Spec::Functions - portably perform operations on file names 14625 14626=over 4 14627 14628=item SYNOPSIS 14629 14630=item DESCRIPTION 14631 14632=over 4 14633 14634=item Exports 14635 14636=back 14637 14638=item SEE ALSO 14639 14640=back 14641 14642=head2 File::Spec::Mac - File::Spec for Mac OS (Classic) 14643 14644=over 4 14645 14646=item SYNOPSIS 14647 14648=item DESCRIPTION 14649 14650=item METHODS 14651 14652canonpath 14653 14654=back 14655 14656catdir() 14657 14658catfile 14659 14660curdir 14661 14662devnull 14663 14664rootdir 14665 14666tmpdir 14667 14668updir 14669 14670file_name_is_absolute 14671 14672path 14673 14674splitpath 14675 14676splitdir 14677 14678catpath 14679 14680abs2rel 14681 14682rel2abs 14683 14684=over 4 14685 14686=item AUTHORS 14687 14688=item SEE ALSO 14689 14690=back 14691 14692=head2 File::Spec::OS2 - methods for OS/2 file specs 14693 14694=over 4 14695 14696=item SYNOPSIS 14697 14698=item DESCRIPTION 14699 14700tmpdir, splitpath 14701 14702=back 14703 14704=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec 14705modules 14706 14707=over 4 14708 14709=item SYNOPSIS 14710 14711=item DESCRIPTION 14712 14713=item METHODS 14714 14715canonpath() 14716 14717=back 14718 14719catdir() 14720 14721catfile 14722 14723curdir 14724 14725devnull 14726 14727rootdir 14728 14729tmpdir 14730 14731updir 14732 14733no_upwards 14734 14735case_tolerant 14736 14737file_name_is_absolute 14738 14739path 14740 14741join 14742 14743splitpath 14744 14745splitdir 14746 14747catpath() 14748 14749abs2rel 14750 14751rel2abs() 14752 14753=over 4 14754 14755=item SEE ALSO 14756 14757=back 14758 14759=head2 File::Spec::VMS - methods for VMS file specs 14760 14761=over 4 14762 14763=item SYNOPSIS 14764 14765=item DESCRIPTION 14766 14767eliminate_macros 14768 14769=back 14770 14771fixpath 14772 14773=over 4 14774 14775=item Methods always loaded 14776 14777canonpath (override) 14778 14779=back 14780 14781catdir 14782 14783catfile 14784 14785curdir (override) 14786 14787devnull (override) 14788 14789rootdir (override) 14790 14791tmpdir (override) 14792 14793updir (override) 14794 14795case_tolerant (override) 14796 14797path (override) 14798 14799file_name_is_absolute (override) 14800 14801splitpath (override) 14802 14803splitdir (override) 14804 14805catpath (override) 14806 14807abs2rel (override) 14808 14809rel2abs (override) 14810 14811=over 4 14812 14813=item SEE ALSO 14814 14815=back 14816 14817=head2 File::Spec::Win32 - methods for Win32 file specs 14818 14819=over 4 14820 14821=item SYNOPSIS 14822 14823=item DESCRIPTION 14824 14825devnull 14826 14827=back 14828 14829tmpdir 14830 14831catfile 14832 14833canonpath 14834 14835splitpath 14836 14837splitdir 14838 14839catpath 14840 14841=over 4 14842 14843=item Note For File::Spec::Win32 Maintainers 14844 14845=back 14846 14847=over 4 14848 14849=item SEE ALSO 14850 14851=back 14852 14853=head2 File::Temp - return name and handle of a temporary file safely 14854 14855=over 4 14856 14857=item PORTABILITY 14858 14859=item SYNOPSIS 14860 14861=item DESCRIPTION 14862 14863=back 14864 14865=over 4 14866 14867=item OO INTERFACE 14868 14869B<new> 14870 14871=back 14872 14873B<filename> 14874 14875B<DESTROY> 14876 14877=over 4 14878 14879=item FUNCTIONS 14880 14881B<tempfile> 14882 14883=back 14884 14885B<tempdir> 14886 14887=over 4 14888 14889=item MKTEMP FUNCTIONS 14890 14891B<mkstemp> 14892 14893=back 14894 14895B<mkstemps> 14896 14897B<mkdtemp> 14898 14899B<mktemp> 14900 14901=over 4 14902 14903=item POSIX FUNCTIONS 14904 14905B<tmpnam> 14906 14907=back 14908 14909B<tmpfile> 14910 14911=over 4 14912 14913=item ADDITIONAL FUNCTIONS 14914 14915B<tempnam> 14916 14917=back 14918 14919=over 4 14920 14921=item UTILITY FUNCTIONS 14922 14923B<unlink0> 14924 14925=back 14926 14927B<cmpstat> 14928 14929B<unlink1> 14930 14931=over 4 14932 14933=item PACKAGE VARIABLES 14934 14935B<safe_level>, STANDARD, MEDIUM, HIGH 14936 14937=back 14938 14939TopSystemUID 14940 14941=over 4 14942 14943=item WARNING 14944 14945=over 4 14946 14947=item Temporary files and NFS 14948 14949=back 14950 14951=item HISTORY 14952 14953=item SEE ALSO 14954 14955=item AUTHOR 14956 14957=back 14958 14959=head2 File::stat - by-name interface to Perl's built-in stat() functions 14960 14961=over 4 14962 14963=item SYNOPSIS 14964 14965=item DESCRIPTION 14966 14967=item BUGS 14968 14969=item NOTE 14970 14971=item AUTHOR 14972 14973=back 14974 14975=head2 FileCache - keep more files open than the system permits 14976 14977=over 4 14978 14979=item SYNOPSIS 14980 14981=item DESCRIPTION 14982 14983cacheout EXPR, cacheout MODE, EXPR 14984 14985=item CAVEATS 14986 14987=item BUGS 14988 14989=item NOTES 14990 14991=back 14992 14993=head2 FileHandle - supply object methods for filehandles 14994 14995=over 4 14996 14997=item SYNOPSIS 14998 14999=item DESCRIPTION 15000 15001$fh->print, $fh->printf, $fh->getline, $fh->getlines 15002 15003=item SEE ALSO 15004 15005=back 15006 15007=head2 Filter::Simple - Simplified source filtering 15008 15009=over 4 15010 15011=item SYNOPSIS 15012 15013=item DESCRIPTION 15014 15015=over 4 15016 15017=item The Problem 15018 15019=item A Solution 15020 15021=item Disabling or changing <no> behaviour 15022 15023=item All-in-one interface 15024 15025=item Filtering only specific components of source code 15026 15027C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">, 15028C<"all"> 15029 15030=item Filtering only the code parts of source code 15031 15032Most source code ceases to be grammatically correct when it is broken up 15033into the pieces between string literals and regexes. So the C<'code'> 15034component filter behaves slightly differently from the other partial 15035filters 15036described in the previous section. 15037 15038=item Using Filter::Simple with an explicit C<import> subroutine 15039 15040=item Using Filter::Simple and Exporter together 15041 15042=item How it works 15043 15044=back 15045 15046=item AUTHOR 15047 15048=item COPYRIGHT 15049 15050=back 15051 15052=head2 Filter::Util::Call - Perl Source Filter Utility Module 15053 15054=over 4 15055 15056=item SYNOPSIS 15057 15058=item DESCRIPTION 15059 15060=over 4 15061 15062=item B<use Filter::Util::Call> 15063 15064=item B<import()> 15065 15066=item B<filter() and anonymous sub> 15067 15068B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> 15069 15070=back 15071 15072=item EXAMPLES 15073 15074=over 4 15075 15076=item Example 1: A simple filter. 15077 15078=item Example 2: Using the context 15079 15080=item Example 3: Using the context within the filter 15081 15082=item Example 4: Using filter_del 15083 15084=back 15085 15086=item Filter::Simple 15087 15088=item AUTHOR 15089 15090=item DATE 15091 15092=back 15093 15094=head2 FindBin - Locate directory of original perl script 15095 15096=over 4 15097 15098=item SYNOPSIS 15099 15100=item DESCRIPTION 15101 15102=item EXPORTABLE VARIABLES 15103 15104=item KNOWN ISSUES 15105 15106=item KNOWN BUGS 15107 15108=item AUTHORS 15109 15110=item COPYRIGHT 15111 15112=back 15113 15114=head2 GDBM_File - Perl5 access to the gdbm library. 15115 15116=over 4 15117 15118=item SYNOPSIS 15119 15120=item DESCRIPTION 15121 15122=item AVAILABILITY 15123 15124=item BUGS 15125 15126=item SEE ALSO 15127 15128=back 15129 15130=head2 Getopt::Long - Extended processing of command line options 15131 15132=over 4 15133 15134=item SYNOPSIS 15135 15136=item DESCRIPTION 15137 15138=item Command Line Options, an Introduction 15139 15140=item Getting Started with Getopt::Long 15141 15142=over 4 15143 15144=item Simple options 15145 15146=item A little bit less simple options 15147 15148=item Mixing command line option with other arguments 15149 15150=item Options with values 15151 15152=item Options with multiple values 15153 15154=item Options with hash values 15155 15156=item User-defined subroutines to handle options 15157 15158=item Options with multiple names 15159 15160=item Case and abbreviations 15161 15162=item Summary of Option Specifications 15163 15164!, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : 15165+ [ I<desttype> ] 15166 15167=back 15168 15169=item Advanced Possibilities 15170 15171=over 4 15172 15173=item Object oriented interface 15174 15175=item Thread Safety 15176 15177=item Documentation and help texts 15178 15179=item Storing options in a hash 15180 15181=item Bundling 15182 15183=item The lonesome dash 15184 15185=item Argument callback 15186 15187=back 15188 15189=item Configuring Getopt::Long 15190 15191default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, 15192require_order, permute, bundling (default: disabled), bundling_override 15193(default: disabled), ignore_case (default: enabled), ignore_case_always 15194(default: disabled), auto_version (default:disabled), auto_help 15195(default:disabled), pass_through (default: disabled), prefix, 15196prefix_pattern, debug (default: disabled) 15197 15198=item Exportable Methods 15199 15200VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage 15201 15202=item Return values and Errors 15203 15204=item Legacy 15205 15206=over 4 15207 15208=item Default destinations 15209 15210=item Alternative option starters 15211 15212=item Configuration variables 15213 15214=back 15215 15216=item Trouble Shooting 15217 15218=over 4 15219 15220=item GetOptions does not return a false result when an option is not 15221supplied 15222 15223=item GetOptions does not split the command line correctly 15224 15225=item Undefined subroutine &main::GetOptions called 15226 15227=item How do I put a "-?" option into a Getopt::Long? 15228 15229=back 15230 15231=item AUTHOR 15232 15233=item COPYRIGHT AND DISCLAIMER 15234 15235=back 15236 15237=head2 Getopt::Std, getopt, getopts - Process single-character switches 15238with switch clustering 15239 15240=over 4 15241 15242=item SYNOPSIS 15243 15244=item DESCRIPTION 15245 15246=item C<--help> and C<--version> 15247 15248=back 15249 15250=head2 Hash::Util - A selection of general-utility hash subroutines 15251 15252=over 4 15253 15254=item SYNOPSIS 15255 15256=item DESCRIPTION 15257 15258=over 4 15259 15260=item Restricted hashes 15261 15262lock_keys, unlock_keys 15263 15264=back 15265 15266=back 15267 15268lock_value, unlock_value 15269 15270B<lock_hash>, B<unlock_hash> 15271 15272B<hash_seed> 15273 15274=over 4 15275 15276=item CAVEATS 15277 15278=item AUTHOR 15279 15280=item SEE ALSO 15281 15282=back 15283 15284=head2 I18N::Collate - compare 8-bit scalar data according to the current 15285locale 15286 15287=over 4 15288 15289=item SYNOPSIS 15290 15291=item DESCRIPTION 15292 15293=back 15294 15295=head2 I18N::LangTags - functions for dealing with RFC3066-style language 15296tags 15297 15298=over 4 15299 15300=item SYNOPSIS 15301 15302=item DESCRIPTION 15303 15304=back 15305 15306the function is_language_tag($lang1) 15307 15308the function extract_language_tags($whatever) 15309 15310the function same_language_tag($lang1, $lang2) 15311 15312the function similarity_language_tag($lang1, $lang2) 15313 15314the function is_dialect_of($lang1, $lang2) 15315 15316the function super_languages($lang1) 15317 15318the function locale2language_tag($locale_identifier) 15319 15320the function encode_language_tag($lang1) 15321 15322the function alternate_language_tags($lang1) 15323 15324the function @langs = panic_languages(@accept_languages) 15325 15326=over 4 15327 15328=item ABOUT LOWERCASING 15329 15330=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS 15331 15332=item SEE ALSO 15333 15334=item COPYRIGHT 15335 15336=item AUTHOR 15337 15338=back 15339 15340=head2 I18N::LangTags::List -- tags and names for human languages 15341 15342=over 4 15343 15344=item SYNOPSIS 15345 15346=item DESCRIPTION 15347 15348=item ABOUT LANGUAGE TAGS 15349 15350=item LIST OF LANGUAGES 15351 15352{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : 15353Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : 15354Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, 15355{ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], 15356{am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, 15357{arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} 15358: Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : 15359Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : 15360Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} 15361: Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : 15362Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} 15363: Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : 15364Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : 15365Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber 15366(Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, 15367{bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : 15368Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : 15369Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian 15370(Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central 15371American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], 15372{ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} 15373: Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : 15374Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : 15375Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, 15376{mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} 15377: French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based 15378Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : 15379Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : 15380Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) 15381Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, 15382{dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, 15383{dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} 15384: Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : 15385English, {enm} : Old English (1100-1500), {ang} : Old English 15386(ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : 15387Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} 15388: Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : 15389Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French 15390(ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : 15391Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, 15392{lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, 15393{de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High 15394German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} 15395: Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient 15396Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : 15397Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, 15398{he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : 15399Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, 15400{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, 15401{ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European 15402(Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua 15403(International Auxiliary Language Association), {ie} : Interlingue, {iu} : 15404Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : 15405Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian 15406languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : 15407Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, 15408{kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : 15409Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} 15410: Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, 15411{kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, 15412{ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, 15413{i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : 15414Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, 15415{kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : 15416Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : 15417Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : 15418Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban 15419(Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} 15420: Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, 15421{mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, 15422{mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : 15423Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : 15424Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : 15425Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, 15426[{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : 15427Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : 15428Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], 15429{lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple 15430languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, 15431{na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, 15432{ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : 15433Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, 15434{nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : 15435Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : 15436Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} 15437: Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : 15438Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian 15439languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : 15440Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : 15441Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian 15442(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} 15443: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], 15444{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : 15445Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, 15446[{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : 15447Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan 15448languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : 15449Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, 15450[{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : 15451Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, 15452{sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, 15453{srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign 15454Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : 15455Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave 15456(Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, 15457{sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : 15458Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : 15459South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : 15460Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, 15461{sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : 15462Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, 15463{tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : 15464Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : 15465Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, 15466{tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, 15467{ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : 15468Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} 15469: Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : 15470Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, 15471{umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : 15472Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} 15473: Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} 15474: Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private 15475Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : 15476Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} 15477: Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, 15478{zun} : Zuni 15479 15480=item SEE ALSO 15481 15482=item COPYRIGHT AND DISCLAIMER 15483 15484=item AUTHOR 15485 15486=back 15487 15488=head2 I18N::Langinfo - query locale information 15489 15490=over 4 15491 15492=item SYNOPSIS 15493 15494=item DESCRIPTION 15495 15496=over 4 15497 15498=item EXPORT 15499 15500=back 15501 15502=item SEE ALSO 15503 15504=item AUTHOR 15505 15506=item COPYRIGHT AND LICENSE 15507 15508=back 15509 15510=head2 IO - load various IO modules 15511 15512=over 4 15513 15514=item SYNOPSIS 15515 15516=item DESCRIPTION 15517 15518=item DEPRECATED 15519 15520=back 15521 15522=head2 IO::Dir - supply object methods for directory handles 15523 15524=over 4 15525 15526=item SYNOPSIS 15527 15528=item DESCRIPTION 15529 15530new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), 15531rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] 15532 15533=item SEE ALSO 15534 15535=item AUTHOR 15536 15537=item COPYRIGHT 15538 15539=back 15540 15541=head2 IO::File - supply object methods for filehandles 15542 15543=over 4 15544 15545=item SYNOPSIS 15546 15547=item DESCRIPTION 15548 15549=item CONSTRUCTOR 15550 15551new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile 15552 15553=item METHODS 15554 15555open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) 15556 15557=item SEE ALSO 15558 15559=item HISTORY 15560 15561=back 15562 15563=head2 IO::Handle - supply object methods for I/O handles 15564 15565=over 4 15566 15567=item SYNOPSIS 15568 15569=item DESCRIPTION 15570 15571=item CONSTRUCTOR 15572 15573new (), new_from_fd ( FD, MODE ) 15574 15575=item METHODS 15576 15577$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, 15578$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, 15579$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), 15580$io->blocking ( [ BOOL ] ), $io->untaint 15581 15582=item NOTE 15583 15584=item SEE ALSO 15585 15586=item BUGS 15587 15588=item HISTORY 15589 15590=back 15591 15592=head2 IO::Pipe - supply object methods for pipes 15593 15594=over 4 15595 15596=item SYNOPSIS 15597 15598=item DESCRIPTION 15599 15600=item CONSTRUCTOR 15601 15602new ( [READER, WRITER] ) 15603 15604=item METHODS 15605 15606reader ([ARGS]), writer ([ARGS]), handles () 15607 15608=item SEE ALSO 15609 15610=item AUTHOR 15611 15612=item COPYRIGHT 15613 15614=back 15615 15616=head2 IO::Poll - Object interface to system poll call 15617 15618=over 4 15619 15620=item SYNOPSIS 15621 15622=item DESCRIPTION 15623 15624=item METHODS 15625 15626mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( 15627IO ), handles( [ EVENT_MASK ] ) 15628 15629=item SEE ALSO 15630 15631=item AUTHOR 15632 15633=item COPYRIGHT 15634 15635=back 15636 15637=head2 IO::Seekable - supply seek based methods for I/O objects 15638 15639=over 4 15640 15641=item SYNOPSIS 15642 15643=item DESCRIPTION 15644 15645$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), 15646WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), 15647$io->tell 15648 15649=item SEE ALSO 15650 15651=item HISTORY 15652 15653=back 15654 15655=head2 IO::Select - OO interface to the select system call 15656 15657=over 4 15658 15659=item SYNOPSIS 15660 15661=item DESCRIPTION 15662 15663=item CONSTRUCTOR 15664 15665new ( [ HANDLES ] ) 15666 15667=item METHODS 15668 15669add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( 15670[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), 15671count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) 15672 15673=item EXAMPLE 15674 15675=item AUTHOR 15676 15677=item COPYRIGHT 15678 15679=back 15680 15681=head2 IO::Socket - Object interface to socket communications 15682 15683=over 4 15684 15685=item SYNOPSIS 15686 15687=item DESCRIPTION 15688 15689=item CONSTRUCTOR 15690 15691new ( [ARGS] ) 15692 15693=item METHODS 15694 15695accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, 15696protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) 15697 15698=item SEE ALSO 15699 15700=item AUTHOR 15701 15702=item COPYRIGHT 15703 15704=back 15705 15706=head2 IO::Socket::INET - Object interface for AF_INET domain sockets 15707 15708=over 4 15709 15710=item SYNOPSIS 15711 15712=item DESCRIPTION 15713 15714=item CONSTRUCTOR 15715 15716new ( [ARGS] ) 15717 15718=over 4 15719 15720=item METHODS 15721 15722sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost 15723() 15724 15725=back 15726 15727=item SEE ALSO 15728 15729=item AUTHOR 15730 15731=item COPYRIGHT 15732 15733=back 15734 15735=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets 15736 15737=over 4 15738 15739=item SYNOPSIS 15740 15741=item DESCRIPTION 15742 15743=item CONSTRUCTOR 15744 15745new ( [ARGS] ) 15746 15747=item METHODS 15748 15749hostpath(), peerpath() 15750 15751=item SEE ALSO 15752 15753=item AUTHOR 15754 15755=item COPYRIGHT 15756 15757=back 15758 15759=head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory 15760handles 15761 15762=over 4 15763 15764=item SYNOPSIS 15765 15766=item DESCRIPTION 15767 15768new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), 15769rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] 15770 15771=item SEE ALSO 15772 15773=item AUTHOR 15774 15775=item COPYRIGHT 15776 15777=back 15778 15779=head2 IO::lib::IO::File, IO::File - supply object methods for filehandles 15780 15781=over 4 15782 15783=item SYNOPSIS 15784 15785=item DESCRIPTION 15786 15787=item CONSTRUCTOR 15788 15789new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile 15790 15791=item METHODS 15792 15793open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) 15794 15795=item SEE ALSO 15796 15797=item HISTORY 15798 15799=back 15800 15801=head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O 15802handles 15803 15804=over 4 15805 15806=item SYNOPSIS 15807 15808=item DESCRIPTION 15809 15810=item CONSTRUCTOR 15811 15812new (), new_from_fd ( FD, MODE ) 15813 15814=item METHODS 15815 15816$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, 15817$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, 15818$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), 15819$io->blocking ( [ BOOL ] ), $io->untaint 15820 15821=item NOTE 15822 15823=item SEE ALSO 15824 15825=item BUGS 15826 15827=item HISTORY 15828 15829=back 15830 15831=head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes 15832 15833=over 4 15834 15835=item SYNOPSIS 15836 15837=item DESCRIPTION 15838 15839=item CONSTRUCTOR 15840 15841new ( [READER, WRITER] ) 15842 15843=item METHODS 15844 15845reader ([ARGS]), writer ([ARGS]), handles () 15846 15847=item SEE ALSO 15848 15849=item AUTHOR 15850 15851=item COPYRIGHT 15852 15853=back 15854 15855=head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call 15856 15857=over 4 15858 15859=item SYNOPSIS 15860 15861=item DESCRIPTION 15862 15863=item METHODS 15864 15865mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( 15866IO ), handles( [ EVENT_MASK ] ) 15867 15868=item SEE ALSO 15869 15870=item AUTHOR 15871 15872=item COPYRIGHT 15873 15874=back 15875 15876=head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for 15877I/O objects 15878 15879=over 4 15880 15881=item SYNOPSIS 15882 15883=item DESCRIPTION 15884 15885$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), 15886WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), 15887$io->tell 15888 15889=item SEE ALSO 15890 15891=item HISTORY 15892 15893=back 15894 15895=head2 IO::lib::IO::Select, IO::Select - OO interface to the select system 15896call 15897 15898=over 4 15899 15900=item SYNOPSIS 15901 15902=item DESCRIPTION 15903 15904=item CONSTRUCTOR 15905 15906new ( [ HANDLES ] ) 15907 15908=item METHODS 15909 15910add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( 15911[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), 15912count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) 15913 15914=item EXAMPLE 15915 15916=item AUTHOR 15917 15918=item COPYRIGHT 15919 15920=back 15921 15922=head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket 15923communications 15924 15925=over 4 15926 15927=item SYNOPSIS 15928 15929=item DESCRIPTION 15930 15931=item CONSTRUCTOR 15932 15933new ( [ARGS] ) 15934 15935=item METHODS 15936 15937accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, 15938protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) 15939 15940=item SEE ALSO 15941 15942=item AUTHOR 15943 15944=item COPYRIGHT 15945 15946=back 15947 15948=head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for 15949AF_INET domain sockets 15950 15951=over 4 15952 15953=item SYNOPSIS 15954 15955=item DESCRIPTION 15956 15957=item CONSTRUCTOR 15958 15959new ( [ARGS] ) 15960 15961=over 4 15962 15963=item METHODS 15964 15965sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost 15966() 15967 15968=back 15969 15970=item SEE ALSO 15971 15972=item AUTHOR 15973 15974=item COPYRIGHT 15975 15976=back 15977 15978=head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for 15979AF_UNIX domain sockets 15980 15981=over 4 15982 15983=item SYNOPSIS 15984 15985=item DESCRIPTION 15986 15987=item CONSTRUCTOR 15988 15989new ( [ARGS] ) 15990 15991=item METHODS 15992 15993hostpath(), peerpath() 15994 15995=item SEE ALSO 15996 15997=item AUTHOR 15998 15999=item COPYRIGHT 16000 16001=back 16002 16003=head2 IPC::Msg - SysV Msg IPC object class 16004 16005=over 4 16006 16007=item SYNOPSIS 16008 16009=item DESCRIPTION 16010 16011=item METHODS 16012 16013new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set 16014( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, 16015FLAGS ] ), stat 16016 16017=item SEE ALSO 16018 16019=item AUTHOR 16020 16021=item COPYRIGHT 16022 16023=back 16024 16025=head2 IPC::Open2, open2 - open a process for both reading and writing 16026 16027=over 4 16028 16029=item SYNOPSIS 16030 16031=item DESCRIPTION 16032 16033=item WARNING 16034 16035=item SEE ALSO 16036 16037=back 16038 16039=head2 IPC::Open3, open3 - open a process for reading, writing, and error 16040handling 16041 16042=over 4 16043 16044=item SYNOPSIS 16045 16046=item DESCRIPTION 16047 16048=item WARNING 16049 16050=back 16051 16052=head2 IPC::Semaphore - SysV Semaphore IPC object class 16053 16054=over 4 16055 16056=item SYNOPSIS 16057 16058=item DESCRIPTION 16059 16060=item METHODS 16061 16062new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), 16063getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), 16064set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N 16065, VALUE ), stat 16066 16067=item SEE ALSO 16068 16069=item AUTHOR 16070 16071=item COPYRIGHT 16072 16073=back 16074 16075=head2 IPC::SysV - SysV IPC constants 16076 16077=over 4 16078 16079=item SYNOPSIS 16080 16081=item DESCRIPTION 16082 16083ftok( PATH, ID ) 16084 16085=item SEE ALSO 16086 16087=item AUTHORS 16088 16089=item COPYRIGHT 16090 16091=back 16092 16093=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class 16094 16095=over 4 16096 16097=item SYNOPSIS 16098 16099=item DESCRIPTION 16100 16101=item METHODS 16102 16103new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set 16104( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, 16105FLAGS ] ), stat 16106 16107=item SEE ALSO 16108 16109=item AUTHOR 16110 16111=item COPYRIGHT 16112 16113=back 16114 16115=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object 16116class 16117 16118=over 4 16119 16120=item SYNOPSIS 16121 16122=item DESCRIPTION 16123 16124=item METHODS 16125 16126new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), 16127getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), 16128set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N 16129, VALUE ), stat 16130 16131=item SEE ALSO 16132 16133=item AUTHOR 16134 16135=item COPYRIGHT 16136 16137=back 16138 16139=head2 List::Util - A selection of general-utility list subroutines 16140 16141=over 4 16142 16143=item SYNOPSIS 16144 16145=item DESCRIPTION 16146 16147first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce 16148BLOCK LIST, shuffle LIST, sum LIST 16149 16150=item KNOWN BUGS 16151 16152=item SUGGESTED ADDITIONS 16153 16154=item COPYRIGHT 16155 16156=back 16157 16158=head2 List::Utilib::List::Util, List::Util - A selection of 16159general-utility list subroutines 16160 16161=over 4 16162 16163=item SYNOPSIS 16164 16165=item DESCRIPTION 16166 16167first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce 16168BLOCK LIST, shuffle LIST, sum LIST 16169 16170=item KNOWN BUGS 16171 16172=item SUGGESTED ADDITIONS 16173 16174=item COPYRIGHT 16175 16176=back 16177 16178=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of 16179general-utility scalar subroutines 16180 16181=over 4 16182 16183=item SYNOPSIS 16184 16185=item DESCRIPTION 16186 16187blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, 16188looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, 16189set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF 16190 16191=item KNOWN BUGS 16192 16193=item COPYRIGHT 16194 16195=item BLATANT PLUG 16196 16197=back 16198 16199=head2 Locale::Constants - constants for Locale codes 16200 16201=over 4 16202 16203=item SYNOPSIS 16204 16205=item DESCRIPTION 16206 16207=item KNOWN BUGS AND LIMITATIONS 16208 16209=item SEE ALSO 16210 16211Locale::Language, Locale::Country, Locale::Script, Locale::Currency 16212 16213=item AUTHOR 16214 16215=item COPYRIGHT 16216 16217=back 16218 16219=head2 Locale::Country - ISO codes for country identification (ISO 3166) 16220 16221=over 4 16222 16223=item SYNOPSIS 16224 16225=item DESCRIPTION 16226 16227B<alpha-2>, B<alpha-3>, B<numeric> 16228 16229=item CONVERSION ROUTINES 16230 16231code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), 16232country_code2code( CODE, CODESET, CODESET ) 16233 16234=item QUERY ROUTINES 16235 16236C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> 16237 16238=item SEMI-PRIVATE ROUTINES 16239 16240=over 4 16241 16242=item alias_code 16243 16244=item rename_country 16245 16246=back 16247 16248=item EXAMPLES 16249 16250=item DOMAIN NAMES 16251 16252=item KNOWN BUGS AND LIMITATIONS 16253 16254=item SEE ALSO 16255 16256Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO 162573166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, 16258http://www.egt.ie/standards/iso3166/iso3166-1-en.html, 16259http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html 16260 16261=item AUTHOR 16262 16263=item COPYRIGHT 16264 16265=back 16266 16267=head2 Locale::Currency - ISO three letter codes for currency 16268identification (ISO 4217) 16269 16270=over 4 16271 16272=item SYNOPSIS 16273 16274=item DESCRIPTION 16275 16276XTS, XXX 16277 16278=item CONVERSION ROUTINES 16279 16280code2currency(), currency2code() 16281 16282=item QUERY ROUTINES 16283 16284C<all_currency_codes()>, C<all_currency_names()> 16285 16286=item EXAMPLES 16287 16288=item KNOWN BUGS AND LIMITATIONS 16289 16290=item SEE ALSO 16291 16292Locale::Country, Locale::Script, ISO 4217:1995, 16293http://www.bsi-global.com/iso4217currency 16294 16295=item AUTHOR 16296 16297=item COPYRIGHT 16298 16299=back 16300 16301=head2 Locale::Language - ISO two letter codes for language identification 16302(ISO 639) 16303 16304=over 4 16305 16306=item SYNOPSIS 16307 16308=item DESCRIPTION 16309 16310=item CONVERSION ROUTINES 16311 16312code2language(), language2code() 16313 16314=item QUERY ROUTINES 16315 16316C<all_language_codes()>, C<all_language_names()> 16317 16318=item EXAMPLES 16319 16320=item KNOWN BUGS AND LIMITATIONS 16321 16322=item SEE ALSO 16323 16324Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), 16325http://lcweb.loc.gov/standards/iso639-2/langhome.html 16326 16327=item AUTHOR 16328 16329=item COPYRIGHT 16330 16331=back 16332 16333=head2 Locale::Maketext - framework for localization 16334 16335=over 4 16336 16337=item SYNOPSIS 16338 16339=item DESCRIPTION 16340 16341=item QUICK OVERVIEW 16342 16343=item METHODS 16344 16345=over 4 16346 16347=item Construction Methods 16348 16349=item The "maketext" Method 16350 16351$lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto 16352 16353=item Utility Methods 16354 16355$language->quant($number, $singular), $language->quant($number, $singular, 16356$plural), $language->quant($number, $singular, $plural, $negative), 16357$language->numf($number), $language->sprintf($format, @items), 16358$language->language_tag(), $language->encoding() 16359 16360=item Language Handle Attributes and Internals 16361 16362=back 16363 16364=item LANGUAGE CLASS HIERARCHIES 16365 16366=item ENTRIES IN EACH LEXICON 16367 16368=item BRACKET NOTATION 16369 16370=item AUTO LEXICONS 16371 16372=item CONTROLLING LOOKUP FAILURE 16373 16374=item HOW TO USE MAKETEXT 16375 16376=item SEE ALSO 16377 16378=item COPYRIGHT AND DISCLAIMER 16379 16380=item AUTHOR 16381 16382=back 16383 16384=head2 Locale::Maketext::TPJ13 -- article about software localization 16385 16386=over 4 16387 16388=item SYNOPSIS 16389 16390=item DESCRIPTION 16391 16392=item Localization and Perl: gettext breaks, Maketext fixes 16393 16394=over 4 16395 16396=item A Localization Horror Story: It Could Happen To You 16397 16398=item The Linguistic View 16399 16400=item Breaking gettext 16401 16402=item Replacing gettext 16403 16404=item Buzzwords: Abstraction and Encapsulation 16405 16406=item Buzzword: Isomorphism 16407 16408=item Buzzword: Inheritance 16409 16410=item Buzzword: Concision 16411 16412=item The Devil in the Details 16413 16414=item The Proof in the Pudding: Localizing Web Sites 16415 16416=item References 16417 16418=back 16419 16420=back 16421 16422=head2 Locale::Script - ISO codes for script identification (ISO 15924) 16423 16424=over 4 16425 16426=item SYNOPSIS 16427 16428=item DESCRIPTION 16429 16430B<alpha-2>, B<alpha-3>, B<numeric> 16431 16432=over 4 16433 16434=item SPECIAL CODES 16435 16436=back 16437 16438=item CONVERSION ROUTINES 16439 16440code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), 16441script_code2code( CODE, CODESET, CODESET ) 16442 16443=item QUERY ROUTINES 16444 16445C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> 16446 16447=item EXAMPLES 16448 16449=item KNOWN BUGS AND LIMITATIONS 16450 16451=item SEE ALSO 16452 16453Locale::Language, Locale::Currency, Locale::Country, ISO 15924, 16454http://www.evertype.com/standards/iso15924/ 16455 16456=item AUTHOR 16457 16458=item COPYRIGHT 16459 16460=back 16461 16462=head2 MIME::Base64 - Encoding and decoding of base64 strings 16463 16464=over 4 16465 16466=item SYNOPSIS 16467 16468=item DESCRIPTION 16469 16470encode_base64($str), encode_base64($str, $eol);, decode_base64($str) 16471 16472=item DIAGNOSTICS 16473 16474Premature end of base64 data, Premature padding of base64 data 16475 16476=item EXAMPLES 16477 16478=item COPYRIGHT 16479 16480=item SEE ALSO 16481 16482=back 16483 16484=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding 16485of quoted-printable strings 16486 16487=over 4 16488 16489=item SYNOPSIS 16490 16491=item DESCRIPTION 16492 16493encode_qp($str), encode_qp($str, $eol), decode_qp($str); 16494 16495=item COPYRIGHT 16496 16497=item SEE ALSO 16498 16499=back 16500 16501=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable 16502strings 16503 16504=over 4 16505 16506=item SYNOPSIS 16507 16508=item DESCRIPTION 16509 16510encode_qp($str), encode_qp($str, $eol), decode_qp($str); 16511 16512=item COPYRIGHT 16513 16514=item SEE ALSO 16515 16516=back 16517 16518=head2 Math::BigFloat - Arbitrary size floating point math package 16519 16520=over 4 16521 16522=item SYNOPSIS 16523 16524=item DESCRIPTION 16525 16526=over 4 16527 16528=item Canonical notation 16529 16530=item Output 16531 16532=item C<mantissa()>, C<exponent()> and C<parts()> 16533 16534=item Accuracy vs. Precision 16535 16536=item Rounding 16537 16538ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale 16539), fround ( -$scale ) and fround ( 0 ) 16540 16541=back 16542 16543=item EXAMPLES 16544 16545 # not ready yet 16546 16547=item Autocreating constants 16548 16549=over 4 16550 16551=item Math library 16552 16553=item Using Math::BigInt::Lite 16554 16555=back 16556 16557=item BUGS 16558 16559=item CAVEATS 16560 16561stringify, bstr(), bdiv, Modifying and =, bpow 16562 16563=item SEE ALSO 16564 16565=item LICENSE 16566 16567=item AUTHORS 16568 16569=back 16570 16571=head2 Math::BigInt - Arbitrary size integer math package 16572 16573=over 4 16574 16575=item SYNOPSIS 16576 16577=item DESCRIPTION 16578 16579Input, Output 16580 16581=item METHODS 16582 16583=over 4 16584 16585=item config 16586 16587=item accuracy 16588 16589=item precision 16590 16591=item brsft 16592 16593=item new 16594 16595=item bnan 16596 16597=item bzero 16598 16599=item binf 16600 16601=item bone 16602 16603=item is_one()/is_zero()/is_nan()/is_inf() 16604 16605=item is_pos()/is_neg() 16606 16607 $x->is_pos(); # true if >= 0 16608 $x->is_neg(); # true if < 0 16609 16610=item is_odd()/is_even()/is_int() 16611 16612=item bcmp 16613 16614=item bacmp 16615 16616=item sign 16617 16618=item digit 16619 16620=item bneg 16621 16622=item babs 16623 16624=item bnorm 16625 16626=item bnot 16627 16628=item binc 16629 16630=item bdec 16631 16632=item badd 16633 16634=item bsub 16635 16636=item bmul 16637 16638=item bdiv 16639 16640=item bmod 16641 16642=item bmodinv 16643 16644=item bmodpow 16645 16646=item bpow 16647 16648=item blsft 16649 16650=item brsft 16651 16652=item band 16653 16654=item bior 16655 16656=item bxor 16657 16658=item bnot 16659 16660=item bsqrt 16661 16662=item bfac 16663 16664=item round 16665 16666=item bround 16667 16668=item bfround 16669 16670=item bfloor 16671 16672=item bceil 16673 16674=item bgcd 16675 16676=item blcm 16677 16678=item exponent 16679 16680=item mantissa 16681 16682=item parts 16683 16684=item copy 16685 16686=item as_int 16687 16688=item bsstr 16689 16690=item as_hex 16691 16692=item as_bin 16693 16694=back 16695 16696=item ACCURACY and PRECISION 16697 16698=over 4 16699 16700=item Precision P 16701 16702=item Accuracy A 16703 16704=item Fallback F 16705 16706=item Rounding mode R 16707 16708'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy 16709(significant digits), Setting/Accessing, Creating numbers, Usage, 16710Precedence, Overriding globals, Local settings, Rounding, Default values, 16711Remarks 16712 16713=back 16714 16715=item INTERNALS 16716 16717=over 4 16718 16719=item MATH LIBRARY 16720 16721=item SIGN 16722 16723=item mantissa(), exponent() and parts() 16724 16725=back 16726 16727=item EXAMPLES 16728 16729 use Math::BigInt; 16730 16731=item Autocreating constants 16732 16733=item PERFORMANCE 16734 16735=over 4 16736 16737=item Alternative math libraries 16738 16739=item SUBCLASSING 16740 16741=back 16742 16743=item Subclassing Math::BigInt 16744 16745=item UPGRADING 16746 16747=over 4 16748 16749=item Auto-upgrade 16750 16751bsqrt(), div(), blog() 16752 16753=back 16754 16755=item BUGS 16756 16757broot() does not work, Out of Memory!, Fails to load Calc on Perl prior 167585.6.0 16759 16760=item CAVEATS 16761 16762bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, 16763Modifying and =, bpow, Overloading -$x, Mixing different object types, 16764bsqrt(), brsft() 16765 16766=item LICENSE 16767 16768=item SEE ALSO 16769 16770=item AUTHORS 16771 16772=back 16773 16774=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt 16775 16776=over 4 16777 16778=item SYNOPSIS 16779 16780=item DESCRIPTION 16781 16782=item STORAGE 16783 16784=item METHODS 16785 16786=item WRAP YOUR OWN 16787 16788=item LICENSE 16789 16790This program is free software; you may redistribute it and/or modify it 16791under 16792the same terms as Perl itself. 16793 16794=item AUTHORS 16795 16796=item SEE ALSO 16797 16798=back 16799 16800=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code 16801 16802=over 4 16803 16804=item SYNOPSIS 16805 16806=item DESCRIPTION 16807 16808=item METHODS 16809 16810=item LICENSE 16811 16812This program is free software; you may redistribute it and/or modify it 16813under 16814the same terms as Perl itself. 16815 16816=item AUTHORS 16817 16818=item SEE ALSO 16819 16820=back 16821 16822=head2 Math::BigRat - arbitrarily big rational numbers 16823 16824=over 4 16825 16826=item SYNOPSIS 16827 16828=item DESCRIPTION 16829 16830=over 4 16831 16832=item MATH LIBRARY 16833 16834=back 16835 16836=item METHODS 16837 16838=over 4 16839 16840=item new() 16841 16842=item numerator() 16843 16844=item denominator() 16845 16846 $d = $x->denominator(); 16847 16848=item parts() 16849 16850=item as_number() 16851 16852=item bfac() 16853 16854=item blog() 16855 16856=item bround()/round()/bfround() 16857 16858=item bmod() 16859 16860=item is_one() 16861 16862=item is_zero() 16863 16864=item is_positive() 16865 16866=item is_negative() 16867 16868=item is_int() 16869 16870=item is_odd() 16871 16872=item is_even() 16873 16874=item bceil() 16875 16876=item bfloor() 16877 16878 $x->bfloor(); 16879 16880=item bsqrt() 16881 16882 $x->bsqrt(); 16883 16884=item config 16885 16886=back 16887 16888=item BUGS 16889 16890inf handling (partial), NaN handling (partial), rounding (not implemented 16891except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), 16892blog(), bmodinv() and bmodpow() (partial) 16893 16894=item LICENSE 16895 16896=item SEE ALSO 16897 16898=item AUTHORS 16899 16900=back 16901 16902=head2 Math::Complex - complex numbers and associated mathematical 16903functions 16904 16905=over 4 16906 16907=item SYNOPSIS 16908 16909=item DESCRIPTION 16910 16911=item OPERATIONS 16912 16913=item CREATION 16914 16915=item STRINGIFICATION 16916 16917=over 4 16918 16919=item CHANGED IN PERL 5.6 16920 16921=back 16922 16923=item USAGE 16924 16925=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO 16926 16927=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS 16928 16929=item BUGS 16930 16931=item AUTHORS 16932 16933=back 16934 16935=head2 Math::Trig - trigonometric functions 16936 16937=over 4 16938 16939=item SYNOPSIS 16940 16941=item DESCRIPTION 16942 16943=item TRIGONOMETRIC FUNCTIONS 16944 16945B<tan> 16946 16947=over 4 16948 16949=item ERRORS DUE TO DIVISION BY ZERO 16950 16951=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS 16952 16953=back 16954 16955=item PLANE ANGLE CONVERSIONS 16956 16957=item RADIAL COORDINATE CONVERSIONS 16958 16959=over 4 16960 16961=item COORDINATE SYSTEMS 16962 16963=item 3-D ANGLE CONVERSIONS 16964 16965cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, 16966cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical 16967 16968=back 16969 16970=item GREAT CIRCLE DISTANCES AND DIRECTIONS 16971 16972=item EXAMPLES 16973 16974=over 4 16975 16976=item CAVEAT FOR GREAT CIRCLE FORMULAS 16977 16978=back 16979 16980=item BUGS 16981 16982=item AUTHORS 16983 16984=back 16985 16986=head2 Memoize - Make functions faster by trading space for time 16987 16988=over 4 16989 16990=item SYNOPSIS 16991 16992=item DESCRIPTION 16993 16994=item DETAILS 16995 16996=item OPTIONS 16997 16998=over 4 16999 17000=item INSTALL 17001 17002=item NORMALIZER 17003 17004=item C<SCALAR_CACHE>, C<LIST_CACHE> 17005 17006C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> 17007 17008=back 17009 17010=item OTHER FACILITIES 17011 17012=over 4 17013 17014=item C<unmemoize> 17015 17016=item C<flush_cache> 17017 17018=back 17019 17020=item CAVEATS 17021 17022=item PERSISTENT CACHE SUPPORT 17023 17024=item EXPIRATION SUPPORT 17025 17026=item BUGS 17027 17028=item MAILING LIST 17029 17030=item AUTHOR 17031 17032=item COPYRIGHT AND LICENSE 17033 17034=item THANK YOU 17035 17036=back 17037 17038=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for 17039Storable use 17040 17041=over 4 17042 17043=item DESCRIPTION 17044 17045=back 17046 17047=head2 Memoize::Expire - Plug-in module for automatic expiration of 17048memoized values 17049 17050=over 4 17051 17052=item SYNOPSIS 17053 17054=item DESCRIPTION 17055 17056=item INTERFACE 17057 17058 TIEHASH, EXISTS, STORE 17059 17060=item ALTERNATIVES 17061 17062=item CAVEATS 17063 17064=item AUTHOR 17065 17066=item SEE ALSO 17067 17068=back 17069 17070=head2 Memoize::ExpireFile - test for Memoize expiration semantics 17071 17072=over 4 17073 17074=item DESCRIPTION 17075 17076=back 17077 17078=head2 Memoize::ExpireTest - test for Memoize expiration semantics 17079 17080=over 4 17081 17082=item DESCRIPTION 17083 17084=back 17085 17086=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for 17087Storable use 17088 17089=over 4 17090 17091=item DESCRIPTION 17092 17093=back 17094 17095=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for 17096Storable use 17097 17098=over 4 17099 17100=item DESCRIPTION 17101 17102=back 17103 17104=head2 Memoize::Storable - store Memoized data in Storable database 17105 17106=over 4 17107 17108=item DESCRIPTION 17109 17110=back 17111 17112=head2 NDBM_File - Tied access to ndbm files 17113 17114=over 4 17115 17116=item SYNOPSIS 17117 17118=item DESCRIPTION 17119 17120C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> 17121 17122=item DIAGNOSTICS 17123 17124=over 4 17125 17126=item C<ndbm store returned -1, errno 22, key "..." at ...> 17127 17128=back 17129 17130=item BUGS AND WARNINGS 17131 17132=back 17133 17134=head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method 17135redispatch 17136 17137=over 4 17138 17139=item SYNOPSIS 17140 17141=item DESCRIPTION 17142 17143=over 4 17144 17145=item Enforcing redispatch 17146 17147=item Avoiding repetitions 17148 17149=item Invoking all versions of a method with a single call 17150 17151=item Using C<EVERY> methods 17152 17153=back 17154 17155=item AUTHOR 17156 17157=item BUGS AND IRRITATIONS 17158 17159=item COPYRIGHT 17160 17161=back 17162 17163=head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) 17164 17165=over 4 17166 17167=item SYNOPSIS 17168 17169=item DESCRIPTION 17170 17171=item USER METHODS 17172 17173debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), 17174dataend () 17175 17176=item CLASS METHODS 17177 17178debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... 17179]), unsupported (), response (), parse_response ( TEXT ), getline (), 17180ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh () 17181 17182=item EXPORTS 17183 17184=item AUTHOR 17185 17186=item COPYRIGHT 17187 17188=back 17189 17190=head2 Net::Config - Local configuration data for libnet 17191 17192=over 4 17193 17194=item SYNOPSYS 17195 17196=item DESCRIPTION 17197 17198=item METHODS 17199 17200requires_firewall HOST 17201 17202=item NetConfig VALUES 17203 17204nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, 17205time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, 17206ftp_int_pasive, local_netmask, test_hosts, test_exists 17207 17208=back 17209 17210=head2 Net::Domain - Attempt to evaluate the current host's internet name 17211and domain 17212 17213=over 4 17214 17215=item SYNOPSIS 17216 17217=item DESCRIPTION 17218 17219hostfqdn (), hostname (), hostdomain () 17220 17221=item AUTHOR 17222 17223=item COPYRIGHT 17224 17225=back 17226 17227=head2 Net::FTP - FTP Client class 17228 17229=over 4 17230 17231=item SYNOPSIS 17232 17233=item DESCRIPTION 17234 17235=item OVERVIEW 17236 17237=item CONSTRUCTOR 17238 17239new (HOST [,OPTIONS]) 17240 17241=item METHODS 17242 17243login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), 17244site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME 17245), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [, 17246RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, 17247RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] 17248), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, 17249REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), 17250mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash ( 17251[FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ 17252DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( 17253[ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), 17254pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( 17255NON_PASV_SERVER ), abort (), quit () 17256 17257=over 4 17258 17259=item Methods for the adventurous 17260 17261quot (CMD [,ARGS]) 17262 17263=back 17264 17265=item THE dataconn CLASS 17266 17267read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), 17268bytes_read (), abort (), close () 17269 17270=item UNIMPLEMENTED 17271 17272B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> 17273 17274=item REPORTING BUGS 17275 17276=item AUTHOR 17277 17278=item SEE ALSO 17279 17280=item USE EXAMPLES 17281 17282http://www.csh.rit.edu/~adam/Progs/ 17283 17284=item CREDITS 17285 17286=item COPYRIGHT 17287 17288=back 17289 17290=head2 Net::NNTP - NNTP Client class 17291 17292=over 4 17293 17294=item SYNOPSIS 17295 17296=item DESCRIPTION 17297 17298=item CONSTRUCTOR 17299 17300new ( [ HOST ] [, OPTIONS ]) 17301 17302=item METHODS 17303 17304article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( 17305[ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ 17306MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] 17307), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), 17308postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, 17309DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), 17310post ( [ MESSAGE ] ), postfh (), slave (), quit () 17311 17312=over 4 17313 17314=item Extension methods 17315 17316newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), 17317overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN 17318), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( 17319MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ 17320GROUP ] ), reader 17321 17322=back 17323 17324=item UNSUPPORTED 17325 17326=item DEFINITIONS 17327 17328MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> 17329 17330=item SEE ALSO 17331 17332=item AUTHOR 17333 17334=item COPYRIGHT 17335 17336=back 17337 17338=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) 17339 17340=over 4 17341 17342=item SYNOPSIS 17343 17344=item DESCRIPTION 17345 17346=item CONSTRUCTOR 17347 17348new ( [ HOST, ] [ OPTIONS ] ) 17349 17350=item METHODS 17351 17352user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [, 17353PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM 17354[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ 17355MSGNUM ] ), delete ( MSGNUM ), reset (), quit () 17356 17357=item NOTES 17358 17359=item SEE ALSO 17360 17361=item AUTHOR 17362 17363=item COPYRIGHT 17364 17365=back 17366 17367=head2 Net::Ping - check a remote host for reachability 17368 17369=over 4 17370 17371=item SYNOPSIS 17372 17373=item DESCRIPTION 17374 17375=over 4 17376 17377=item Functions 17378 17379Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos 17380]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );, 17381$p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );, 17382$p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( 17383[ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host 17384[, $timeout]); 17385 17386=back 17387 17388=item NOTES 17389 17390=item INSTALL 17391 17392=item BUGS 17393 17394=item AUTHORS 17395 17396=item COPYRIGHT 17397 17398=back 17399 17400=head2 Net::SMTP - Simple Mail Transfer Protocol Client 17401 17402=over 4 17403 17404=item SYNOPSIS 17405 17406=item DESCRIPTION 17407 17408=item EXAMPLES 17409 17410=item CONSTRUCTOR 17411 17412new Net::SMTP [ HOST, ] [ OPTIONS ] 17413 17414=item METHODS 17415 17416banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME, 17417PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail ( 17418ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [, 17419ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc ( 17420ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [ 17421DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ), 17422quit () 17423 17424=item ADDRESSES 17425 17426=item SEE ALSO 17427 17428=item AUTHOR 17429 17430=item COPYRIGHT 17431 17432=back 17433 17434=head2 Net::Time - time and daytime network client interface 17435 17436=over 4 17437 17438=item SYNOPSIS 17439 17440=item DESCRIPTION 17441 17442inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, 17443PROTOCOL [, TIMEOUT]]]) 17444 17445=item AUTHOR 17446 17447=item COPYRIGHT 17448 17449=back 17450 17451=head2 Net::hostent - by-name interface to Perl's built-in gethost*() 17452functions 17453 17454=over 4 17455 17456=item SYNOPSIS 17457 17458=item DESCRIPTION 17459 17460=item EXAMPLES 17461 17462=item NOTE 17463 17464=item AUTHOR 17465 17466=back 17467 17468=head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions 17469 17470=over 4 17471 17472=item DESCRIPTION 17473 17474=over 4 17475 17476=item Where to get this document 17477 17478=item How to contribute to this document 17479 17480=back 17481 17482=item Author and Copyright Information 17483 17484=over 4 17485 17486=item Disclaimer 17487 17488=back 17489 17490=item Obtaining and installing libnet 17491 17492=over 4 17493 17494=item What is libnet ? 17495 17496=item Which version of perl do I need ? 17497 17498=item What other modules do I need ? 17499 17500=item What machines support libnet ? 17501 17502=item Where can I get the latest libnet release 17503 17504=back 17505 17506=item Using Net::FTP 17507 17508=over 4 17509 17510=item How do I download files from an FTP server ? 17511 17512=item How do I transfer files in binary mode ? 17513 17514=item How can I get the size of a file on a remote FTP server ? 17515 17516=item How can I get the modification time of a file on a remote FTP server 17517? 17518 17519=item How can I change the permissions of a file on a remote server ? 17520 17521=item Can I do a reget operation like the ftp command ? 17522 17523=item How do I get a directory listing from an FTP server ? 17524 17525=item Changing directory to "" does not fail ? 17526 17527=item I am behind a SOCKS firewall, but the Firewall option does not work ? 17528 17529=item I am behind an FTP proxy firewall, but cannot access machines outside 17530? 17531 17532=item My ftp proxy firewall does not listen on port 21 17533 17534=item Is it possible to change the file permissions of a file on an FTP 17535server ? 17536 17537=item I have seen scripts call a method message, but cannot find it 17538documented ? 17539 17540=item Why does Net::FTP not implement mput and mget methods 17541 17542=back 17543 17544=item Using Net::SMTP 17545 17546=over 4 17547 17548=item Why can't the part of an Email address after the @ be used as the 17549hostname ? 17550 17551=item Why does Net::SMTP not do DNS MX lookups ? 17552 17553=item The verify method always returns true ? 17554 17555=back 17556 17557=item Debugging scripts 17558 17559=over 4 17560 17561=item How can I debug my scripts that use Net::* modules ? 17562 17563=back 17564 17565=item AUTHOR AND COPYRIGHT 17566 17567=back 17568 17569=head2 Net::netent - by-name interface to Perl's built-in getnet*() 17570functions 17571 17572=over 4 17573 17574=item SYNOPSIS 17575 17576=item DESCRIPTION 17577 17578=item EXAMPLES 17579 17580=item NOTE 17581 17582=item AUTHOR 17583 17584=back 17585 17586=head2 Net::protoent - by-name interface to Perl's built-in getproto*() 17587functions 17588 17589=over 4 17590 17591=item SYNOPSIS 17592 17593=item DESCRIPTION 17594 17595=item NOTE 17596 17597=item AUTHOR 17598 17599=back 17600 17601=head2 Net::servent - by-name interface to Perl's built-in getserv*() 17602functions 17603 17604=over 4 17605 17606=item SYNOPSIS 17607 17608=item DESCRIPTION 17609 17610=item EXAMPLES 17611 17612=item NOTE 17613 17614=item AUTHOR 17615 17616=back 17617 17618=head2 Netrc, Net::Netrc - OO interface to users netrc file 17619 17620=over 4 17621 17622=item SYNOPSIS 17623 17624=item DESCRIPTION 17625 17626=item THE .netrc FILE 17627 17628machine name, default, login name, password string, account string, macdef 17629name 17630 17631=item CONSTRUCTOR 17632 17633lookup ( MACHINE [, LOGIN ]) 17634 17635=item METHODS 17636 17637login (), password (), account (), lpa () 17638 17639=item AUTHOR 17640 17641=item SEE ALSO 17642 17643=item COPYRIGHT 17644 17645=back 17646 17647=head2 O - Generic interface to Perl Compiler backends 17648 17649=over 4 17650 17651=item SYNOPSIS 17652 17653=item DESCRIPTION 17654 17655=item CONVENTIONS 17656 17657=item IMPLEMENTATION 17658 17659=item BUGS 17660 17661=item AUTHOR 17662 17663=back 17664 17665=head2 ODBM_File - Tied access to odbm files 17666 17667=over 4 17668 17669=item SYNOPSIS 17670 17671=item DESCRIPTION 17672 17673C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> 17674 17675=item DIAGNOSTICS 17676 17677=over 4 17678 17679=item C<odbm store returned -1, errno 22, key "..." at ...> 17680 17681=back 17682 17683=item BUGS AND WARNINGS 17684 17685=back 17686 17687=head2 Opcode - Disable named opcodes when compiling perl code 17688 17689=over 4 17690 17691=item SYNOPSIS 17692 17693=item DESCRIPTION 17694 17695=item NOTE 17696 17697=item WARNING 17698 17699=item Operator Names and Operator Lists 17700 17701an operator name (opname), an operator tag name (optag), a negated opname 17702or optag, an operator set (opset) 17703 17704=item Opcode Functions 17705 17706opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), 17707full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), 17708define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), 17709opdump (PAT) 17710 17711=item Manipulating Opsets 17712 17713=item TO DO (maybe) 17714 17715=back 17716 17717=over 4 17718 17719=item Predefined Opcode Tags 17720 17721:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, 17722:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, 17723:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, 17724:dangerous 17725 17726=item SEE ALSO 17727 17728=item AUTHORS 17729 17730=back 17731 17732=head2 Opcode::Safe, Safe - Compile and execute code in restricted 17733compartments 17734 17735=over 4 17736 17737=item SYNOPSIS 17738 17739=item DESCRIPTION 17740 17741a new namespace, an operator mask 17742 17743=item WARNING 17744 17745=over 4 17746 17747=item RECENT CHANGES 17748 17749=item Methods in class Safe 17750 17751permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, 17752...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from 17753(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), 17754root (NAMESPACE), mask (MASK) 17755 17756=item Some Safety Issues 17757 17758Memory, CPU, Snooping, Signals, State Changes 17759 17760=item AUTHOR 17761 17762=back 17763 17764=back 17765 17766=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when 17767compiling 17768 17769=over 4 17770 17771=item SYNOPSIS 17772 17773=item DESCRIPTION 17774 17775=item SEE ALSO 17776 17777=back 17778 17779=head2 POSIX - Perl interface to IEEE Std 1003.1 17780 17781=over 4 17782 17783=item SYNOPSIS 17784 17785=item DESCRIPTION 17786 17787=item NOTE 17788 17789=item CAVEATS 17790 17791=item FUNCTIONS 17792 17793_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, 17794atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, 17795clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, 17796cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, 17797execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, 17798fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, 17799fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, 17800fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, 17801geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, 17802getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, 17803isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, 17804isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, 17805log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, 17806memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, 17807offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, 17808putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, 17809rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, 17810setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, 17811sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, 17812strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, 17813strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, 17814strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, 17815tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, 17816tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, 17817unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, 17818wctomb, write 17819 17820=item CLASSES 17821 17822=over 4 17823 17824=item POSIX::SigAction 17825 17826new, handler, mask, flags, safe 17827 17828=item POSIX::SigSet 17829 17830new, addset, delset, emptyset, fillset, ismember 17831 17832=item POSIX::Termios 17833 17834new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, 17835getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, 17836setoflag, setospeed, Baud rate values, Terminal interface values, c_cc 17837field values, c_cflag field values, c_iflag field values, c_lflag field 17838values, c_oflag field values 17839 17840=back 17841 17842=item PATHNAME CONSTANTS 17843 17844Constants 17845 17846=item POSIX CONSTANTS 17847 17848Constants 17849 17850=item SYSTEM CONFIGURATION 17851 17852Constants 17853 17854=item ERRNO 17855 17856Constants 17857 17858=item FCNTL 17859 17860Constants 17861 17862=item FLOAT 17863 17864Constants 17865 17866=item LIMITS 17867 17868Constants 17869 17870=item LOCALE 17871 17872Constants 17873 17874=item MATH 17875 17876Constants 17877 17878=item SIGNAL 17879 17880Constants 17881 17882=item STAT 17883 17884Constants, Macros 17885 17886=item STDLIB 17887 17888Constants 17889 17890=item STDIO 17891 17892Constants 17893 17894=item TIME 17895 17896Constants 17897 17898=item UNISTD 17899 17900Constants 17901 17902=item WAIT 17903 17904Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, 17905WTERMSIG, WIFSTOPPED, WSTOPSIG 17906 17907=back 17908 17909=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* 17910name space 17911 17912=over 4 17913 17914=item SYNOPSIS 17915 17916=item DESCRIPTION 17917 17918:unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32 17919 17920=over 4 17921 17922=item Custom Layers 17923 17924:encoding, :via 17925 17926=item Alternatives to raw 17927 17928=item Defaults and how to override them 17929 17930=item Querying the layers of filehandles 17931 17932=back 17933 17934=item AUTHOR 17935 17936=item SEE ALSO 17937 17938=back 17939 17940=head2 PerlIO::encoding - encoding layer 17941 17942=over 4 17943 17944=item SYNOPSIS 17945 17946=item DESCRIPTION 17947 17948=item SEE ALSO 17949 17950=back 17951 17952=head2 PerlIO::scalar - in-memory IO, scalar IO 17953 17954=over 4 17955 17956=item SYNOPSIS 17957 17958=item DESCRIPTION 17959 17960=item IMPLEMENTATION NOTE 17961 17962=back 17963 17964=head2 PerlIO::via - Helper class for PerlIO layers implemented in perl 17965 17966=over 4 17967 17968=item SYNOPSIS 17969 17970=item DESCRIPTION 17971 17972=item EXPECTED METHODS 17973 17974$class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), 17975$obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]), 17976$obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]), 17977$obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh), 17978$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), 17979$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), 17980$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), 17981$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) 17982 17983=item EXAMPLES 17984 17985=over 4 17986 17987=item Example - a Hexadecimal Handle 17988 17989=back 17990 17991=back 17992 17993=head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings 17994 17995=over 4 17996 17997=item SYNOPSIS 17998 17999=item DESCRIPTION 18000 18001=item REQUIRED MODULES 18002 18003=item SEE ALSO 18004 18005=item ACKNOWLEDGEMENTS 18006 18007=item COPYRIGHT 18008 18009=back 18010 18011=head2 Pod::Checker, podchecker() - check pod documents for syntax errors 18012 18013=over 4 18014 18015=item SYNOPSIS 18016 18017=item OPTIONS/ARGUMENTS 18018 18019=over 4 18020 18021=item podchecker() 18022 18023B<-warnings> =E<gt> I<val> 18024 18025=back 18026 18027=item DESCRIPTION 18028 18029=item DIAGNOSTICS 18030 18031=over 4 18032 18033=item Errors 18034 18035empty =headn, =over on line I<N> without closing =back, =item without 18036previous =over, =back without previous =over, No argument for =begin, =end 18037without =begin, Nested =begin's, =for without formatter specification, 18038unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown 18039interior-sequence "I<SEQ>", nested commands 18040I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity 18041number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, 18042empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) 18043after =back 18044 18045=item Warnings 18046 18047multiple occurrence of link target I<name>, line containing nothing but 18048whitespace in paragraph, file does not start with =head, previous =item has 18049no contents, preceding non-item paragraph(s), =item type mismatch (I<one> 18050vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No 18051items in =over, No argument for =item, empty section in previous paragraph, 18052Verbatim paragraph in NAME section, =headI<n> without preceding higher 18053level 18054 18055=item Hyperlinks 18056 18057ignoring leading/trailing whitespace in link, (section) in '$page' 18058deprecated, alternative text/node '%s' contains non-escaped | or / 18059 18060=back 18061 18062=item RETURN VALUE 18063 18064=item EXAMPLES 18065 18066=item INTERFACE 18067 18068=back 18069 18070C<Pod::Checker-E<gt>new( %options )> 18071 18072C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, 18073@args )> 18074 18075C<$checker-E<gt>num_errors()> 18076 18077C<$checker-E<gt>num_warnings()> 18078 18079C<$checker-E<gt>name()> 18080 18081C<$checker-E<gt>node()> 18082 18083C<$checker-E<gt>idx()> 18084 18085C<$checker-E<gt>hyperlink()> 18086 18087=over 4 18088 18089=item AUTHOR 18090 18091=back 18092 18093=head2 Pod::Find - find POD documents in directory trees 18094 18095=over 4 18096 18097=item SYNOPSIS 18098 18099=item DESCRIPTION 18100 18101=back 18102 18103=over 4 18104 18105=item C<pod_find( { %opts } , @directories )> 18106 18107C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> 181081> 18109 18110=back 18111 18112=over 4 18113 18114=item C<simplify_name( $str )> 18115 18116=back 18117 18118=over 4 18119 18120=item C<pod_where( { %opts }, $pod )> 18121 18122C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> 181231> 18124 18125=back 18126 18127=over 4 18128 18129=item C<contains_pod( $file , $verbose )> 18130 18131=back 18132 18133=over 4 18134 18135=item AUTHOR 18136 18137=item SEE ALSO 18138 18139=back 18140 18141=head2 Pod::Html - module to convert pod files to HTML 18142 18143=over 4 18144 18145=item SYNOPSIS 18146 18147=item DESCRIPTION 18148 18149=item ARGUMENTS 18150 18151backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, 18152htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, 18153quiet, recurse, title, verbose 18154 18155=item EXAMPLE 18156 18157=item ENVIRONMENT 18158 18159=item AUTHOR 18160 18161=item SEE ALSO 18162 18163=item COPYRIGHT 18164 18165=back 18166 18167=head2 Pod::InputObjects - objects representing POD input paragraphs, 18168commands, etc. 18169 18170=over 4 18171 18172=item SYNOPSIS 18173 18174=item REQUIRES 18175 18176=item EXPORTS 18177 18178=item DESCRIPTION 18179 18180package B<Pod::InputSource>, package B<Pod::Paragraph>, package 18181B<Pod::InteriorSequence>, package B<Pod::ParseTree> 18182 18183=back 18184 18185=over 4 18186 18187=item B<Pod::InputSource> 18188 18189=back 18190 18191=over 4 18192 18193=item B<new()> 18194 18195=back 18196 18197=over 4 18198 18199=item B<name()> 18200 18201=back 18202 18203=over 4 18204 18205=item B<handle()> 18206 18207=back 18208 18209=over 4 18210 18211=item B<was_cutting()> 18212 18213=back 18214 18215=over 4 18216 18217=item B<Pod::Paragraph> 18218 18219=back 18220 18221=over 4 18222 18223=item Pod::Paragraph-E<gt>B<new()> 18224 18225=back 18226 18227=over 4 18228 18229=item $pod_para-E<gt>B<cmd_name()> 18230 18231=back 18232 18233=over 4 18234 18235=item $pod_para-E<gt>B<text()> 18236 18237=back 18238 18239=over 4 18240 18241=item $pod_para-E<gt>B<raw_text()> 18242 18243=back 18244 18245=over 4 18246 18247=item $pod_para-E<gt>B<cmd_prefix()> 18248 18249=back 18250 18251=over 4 18252 18253=item $pod_para-E<gt>B<cmd_separator()> 18254 18255=back 18256 18257=over 4 18258 18259=item $pod_para-E<gt>B<parse_tree()> 18260 18261=back 18262 18263=over 4 18264 18265=item $pod_para-E<gt>B<file_line()> 18266 18267=back 18268 18269=over 4 18270 18271=item B<Pod::InteriorSequence> 18272 18273=back 18274 18275=over 4 18276 18277=item Pod::InteriorSequence-E<gt>B<new()> 18278 18279=back 18280 18281=over 4 18282 18283=item $pod_seq-E<gt>B<cmd_name()> 18284 18285=back 18286 18287=over 4 18288 18289=item $pod_seq-E<gt>B<prepend()> 18290 18291=back 18292 18293=over 4 18294 18295=item $pod_seq-E<gt>B<append()> 18296 18297=back 18298 18299=over 4 18300 18301=item $pod_seq-E<gt>B<nested()> 18302 18303=back 18304 18305=over 4 18306 18307=item $pod_seq-E<gt>B<raw_text()> 18308 18309=back 18310 18311=over 4 18312 18313=item $pod_seq-E<gt>B<left_delimiter()> 18314 18315=back 18316 18317=over 4 18318 18319=item $pod_seq-E<gt>B<right_delimiter()> 18320 18321=back 18322 18323=over 4 18324 18325=item $pod_seq-E<gt>B<parse_tree()> 18326 18327=back 18328 18329=over 4 18330 18331=item $pod_seq-E<gt>B<file_line()> 18332 18333=back 18334 18335=over 4 18336 18337=item Pod::InteriorSequence::B<DESTROY()> 18338 18339=back 18340 18341=over 4 18342 18343=item B<Pod::ParseTree> 18344 18345=back 18346 18347=over 4 18348 18349=item Pod::ParseTree-E<gt>B<new()> 18350 18351=back 18352 18353=over 4 18354 18355=item $ptree-E<gt>B<top()> 18356 18357=back 18358 18359=over 4 18360 18361=item $ptree-E<gt>B<children()> 18362 18363=back 18364 18365=over 4 18366 18367=item $ptree-E<gt>B<prepend()> 18368 18369=back 18370 18371=over 4 18372 18373=item $ptree-E<gt>B<append()> 18374 18375=back 18376 18377=over 4 18378 18379=item $ptree-E<gt>B<raw_text()> 18380 18381=back 18382 18383=over 4 18384 18385=item Pod::ParseTree::B<DESTROY()> 18386 18387=back 18388 18389=over 4 18390 18391=item SEE ALSO 18392 18393=item AUTHOR 18394 18395=back 18396 18397=head2 Pod::LaTeX - Convert Pod data to formatted Latex 18398 18399=over 4 18400 18401=item SYNOPSIS 18402 18403=item DESCRIPTION 18404 18405=back 18406 18407=over 4 18408 18409=item OBJECT METHODS 18410 18411C<initialize> 18412 18413=back 18414 18415=over 4 18416 18417=item Data Accessors 18418 18419B<AddPreamble> 18420 18421=back 18422 18423B<AddPostamble> 18424 18425B<Head1Level> 18426 18427B<Label> 18428 18429B<LevelNoNum> 18430 18431B<MakeIndex> 18432 18433B<ReplaceNAMEwithSection> 18434 18435B<StartWithNewPage> 18436 18437B<TableOfContents> 18438 18439B<UniqueLabels> 18440 18441B<UserPreamble> 18442 18443B<UserPostamble> 18444 18445B<Lists> 18446 18447=over 4 18448 18449=item Subclassed methods 18450 18451=back 18452 18453B<begin_pod> 18454 18455B<end_pod> 18456 18457B<command> 18458 18459B<verbatim> 18460 18461B<textblock> 18462 18463B<interior_sequence> 18464 18465=over 4 18466 18467=item List Methods 18468 18469B<begin_list> 18470 18471=back 18472 18473B<end_list> 18474 18475B<add_item> 18476 18477=over 4 18478 18479=item Methods for headings 18480 18481B<head> 18482 18483=back 18484 18485=over 4 18486 18487=item Internal methods 18488 18489B<_output> 18490 18491=back 18492 18493B<_replace_special_chars> 18494 18495B<_replace_special_chars_late> 18496 18497B<_create_label> 18498 18499B<_create_index> 18500 18501B<_clean_latex_commands> 18502 18503B<_split_delimited> 18504 18505=over 4 18506 18507=item NOTES 18508 18509=item SEE ALSO 18510 18511=item AUTHORS 18512 18513=item COPYRIGHT 18514 18515=item REVISION 18516 18517=back 18518 18519=head2 Pod::Man - Convert POD data to formatted *roff input 18520 18521=over 4 18522 18523=item SYNOPSIS 18524 18525=item DESCRIPTION 18526 18527center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, 18528release, section 18529 18530=item DIAGNOSTICS 18531 18532roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote 18533specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown 18534escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched 18535=back 18536 18537=item BUGS 18538 18539=item CAVEATS 18540 18541=item SEE ALSO 18542 18543=item AUTHOR 18544 18545=item COPYRIGHT AND LICENSE 18546 18547=back 18548 18549=head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text 18550 18551=over 4 18552 18553=item SYNOPSIS 18554 18555=item DESCRIPTION 18556 18557=item SEE ALSO 18558 18559=item AUTHOR 18560 18561=item COPYRIGHT AND LICENSE 18562 18563=back 18564 18565=head2 Pod::ParseUtils - helpers for POD parsing and conversion 18566 18567=over 4 18568 18569=item SYNOPSIS 18570 18571=item DESCRIPTION 18572 18573=back 18574 18575=over 4 18576 18577=item Pod::List 18578 18579Pod::List-E<gt>new() 18580 18581=back 18582 18583$list-E<gt>file() 18584 18585$list-E<gt>start() 18586 18587$list-E<gt>indent() 18588 18589$list-E<gt>type() 18590 18591$list-E<gt>rx() 18592 18593$list-E<gt>item() 18594 18595$list-E<gt>parent() 18596 18597$list-E<gt>tag() 18598 18599=over 4 18600 18601=item Pod::Hyperlink 18602 18603Pod::Hyperlink-E<gt>new() 18604 18605=back 18606 18607$link-E<gt>parse($string) 18608 18609$link-E<gt>markup($string) 18610 18611$link-E<gt>text() 18612 18613$link-E<gt>warning() 18614 18615$link-E<gt>file(), $link-E<gt>line() 18616 18617$link-E<gt>page() 18618 18619$link-E<gt>node() 18620 18621$link-E<gt>alttext() 18622 18623$link-E<gt>type() 18624 18625$link-E<gt>link() 18626 18627=over 4 18628 18629=item Pod::Cache 18630 18631Pod::Cache-E<gt>new() 18632 18633=back 18634 18635$cache-E<gt>item() 18636 18637$cache-E<gt>find_page($name) 18638 18639=over 4 18640 18641=item Pod::Cache::Item 18642 18643Pod::Cache::Item-E<gt>new() 18644 18645=back 18646 18647$cacheitem-E<gt>page() 18648 18649$cacheitem-E<gt>description() 18650 18651$cacheitem-E<gt>path() 18652 18653$cacheitem-E<gt>file() 18654 18655$cacheitem-E<gt>nodes() 18656 18657$cacheitem-E<gt>find_node($name) 18658 18659$cacheitem-E<gt>idx() 18660 18661=over 4 18662 18663=item AUTHOR 18664 18665=item SEE ALSO 18666 18667=back 18668 18669=head2 Pod::Parser - base class for creating POD filters and translators 18670 18671=over 4 18672 18673=item SYNOPSIS 18674 18675=item REQUIRES 18676 18677=item EXPORTS 18678 18679=item DESCRIPTION 18680 18681=item QUICK OVERVIEW 18682 18683=item PARSING OPTIONS 18684 18685B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), 18686B<-warnings> (default: unset) 18687 18688=back 18689 18690=over 4 18691 18692=item RECOMMENDED SUBROUTINE/METHOD OVERRIDES 18693 18694=back 18695 18696=over 4 18697 18698=item B<command()> 18699 18700C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> 18701 18702=back 18703 18704=over 4 18705 18706=item B<verbatim()> 18707 18708C<$text>, C<$line_num>, C<$pod_para> 18709 18710=back 18711 18712=over 4 18713 18714=item B<textblock()> 18715 18716C<$text>, C<$line_num>, C<$pod_para> 18717 18718=back 18719 18720=over 4 18721 18722=item B<interior_sequence()> 18723 18724=back 18725 18726=over 4 18727 18728=item OPTIONAL SUBROUTINE/METHOD OVERRIDES 18729 18730=back 18731 18732=over 4 18733 18734=item B<new()> 18735 18736=back 18737 18738=over 4 18739 18740=item B<initialize()> 18741 18742=back 18743 18744=over 4 18745 18746=item B<begin_pod()> 18747 18748=back 18749 18750=over 4 18751 18752=item B<begin_input()> 18753 18754=back 18755 18756=over 4 18757 18758=item B<end_input()> 18759 18760=back 18761 18762=over 4 18763 18764=item B<end_pod()> 18765 18766=back 18767 18768=over 4 18769 18770=item B<preprocess_line()> 18771 18772=back 18773 18774=over 4 18775 18776=item B<preprocess_paragraph()> 18777 18778=back 18779 18780=over 4 18781 18782=item METHODS FOR PARSING AND PROCESSING 18783 18784=back 18785 18786=over 4 18787 18788=item B<parse_text()> 18789 18790B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> 18791I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> 18792I<code-ref>|I<method-name> 18793 18794=back 18795 18796=over 4 18797 18798=item B<interpolate()> 18799 18800=back 18801 18802=over 4 18803 18804=item B<parse_paragraph()> 18805 18806=back 18807 18808=over 4 18809 18810=item B<parse_from_filehandle()> 18811 18812=back 18813 18814=over 4 18815 18816=item B<parse_from_file()> 18817 18818=back 18819 18820=over 4 18821 18822=item ACCESSOR METHODS 18823 18824=back 18825 18826=over 4 18827 18828=item B<errorsub()> 18829 18830=back 18831 18832=over 4 18833 18834=item B<cutting()> 18835 18836=back 18837 18838=over 4 18839 18840=item B<parseopts()> 18841 18842=back 18843 18844=over 4 18845 18846=item B<output_file()> 18847 18848=back 18849 18850=over 4 18851 18852=item B<output_handle()> 18853 18854=back 18855 18856=over 4 18857 18858=item B<input_file()> 18859 18860=back 18861 18862=over 4 18863 18864=item B<input_handle()> 18865 18866=back 18867 18868=over 4 18869 18870=item B<input_streams()> 18871 18872=back 18873 18874=over 4 18875 18876=item B<top_stream()> 18877 18878=back 18879 18880=over 4 18881 18882=item PRIVATE METHODS AND DATA 18883 18884=back 18885 18886=over 4 18887 18888=item B<_push_input_stream()> 18889 18890=back 18891 18892=over 4 18893 18894=item B<_pop_input_stream()> 18895 18896=back 18897 18898=over 4 18899 18900=item TREE-BASED PARSING 18901 18902=item SEE ALSO 18903 18904=item AUTHOR 18905 18906=back 18907 18908=head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors 18909 18910=over 4 18911 18912=item SYNOPSIS 18913 18914=item DESCRIPTION 18915 18916=item SEE ALSO 18917 18918=item COPYRIGHT AND DISCLAIMERS 18919 18920=item AUTHOR 18921 18922=back 18923 18924=head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages 18925 18926=over 4 18927 18928=item SYNOPSIS 18929 18930=item DESCRIPTION 18931 18932=item CAVEAT 18933 18934=item SEE ALSO 18935 18936=item COPYRIGHT AND DISCLAIMERS 18937 18938=item AUTHOR 18939 18940=back 18941 18942=head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff 18943 18944=over 4 18945 18946=item SYNOPSIS 18947 18948=item DESCRIPTION 18949 18950=item CAVEAT 18951 18952=item SEE ALSO 18953 18954=item COPYRIGHT AND DISCLAIMERS 18955 18956=item AUTHOR 18957 18958=back 18959 18960=head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod! 18961 18962=over 4 18963 18964=item SYNOPSIS 18965 18966=item DESCRIPTION 18967 18968=item SEE ALSO 18969 18970=item COPYRIGHT AND DISCLAIMERS 18971 18972=item AUTHOR 18973 18974=back 18975 18976=head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF 18977 18978=over 4 18979 18980=item SYNOPSIS 18981 18982=item DESCRIPTION 18983 18984=item SEE ALSO 18985 18986=item COPYRIGHT AND DISCLAIMERS 18987 18988=item AUTHOR 18989 18990=back 18991 18992=head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext 18993 18994=over 4 18995 18996=item SYNOPSIS 18997 18998=item DESCRIPTION 18999 19000=item CAVEAT 19001 19002=item SEE ALSO 19003 19004=item COPYRIGHT AND DISCLAIMERS 19005 19006=item AUTHOR 19007 19008=back 19009 19010=head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod 19011 19012=over 4 19013 19014=item SYNOPSIS 19015 19016=item DESCRIPTION 19017 19018=item SEE ALSO 19019 19020=item AUTHOR 19021 19022=back 19023 19024=head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML 19025 19026=over 4 19027 19028=item SYNOPSIS 19029 19030=item DESCRIPTION 19031 19032=item SEE ALSO 19033 19034=item COPYRIGHT AND DISCLAIMERS 19035 19036=item AUTHOR 19037 19038=back 19039 19040=head2 Pod::PlainText - Convert POD data to formatted ASCII text 19041 19042=over 4 19043 19044=item SYNOPSIS 19045 19046=item DESCRIPTION 19047 19048alt, indent, loose, sentence, width 19049 19050=item DIAGNOSTICS 19051 19052Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s, 19053Unknown sequence: %s, Unmatched =back 19054 19055=item RESTRICTIONS 19056 19057=item NOTES 19058 19059=item SEE ALSO 19060 19061=item AUTHOR 19062 19063=back 19064 19065=head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. 19066 19067=over 4 19068 19069=item SYNOPSIS 19070 19071=item DESCRIPTION 19072 19073=over 4 19074 19075=item EXPORT 19076 19077=back 19078 19079=item AUTHOR 19080 19081=item SEE ALSO 19082 19083=back 19084 19085=head2 Pod::Select, podselect() - extract selected sections of POD from 19086input 19087 19088=over 4 19089 19090=item SYNOPSIS 19091 19092=item REQUIRES 19093 19094=item EXPORTS 19095 19096=item DESCRIPTION 19097 19098=item SECTION SPECIFICATIONS 19099 19100=item RANGE SPECIFICATIONS 19101 19102=back 19103 19104=over 4 19105 19106=item OBJECT METHODS 19107 19108=back 19109 19110=over 4 19111 19112=item B<curr_headings()> 19113 19114=back 19115 19116=over 4 19117 19118=item B<select()> 19119 19120=back 19121 19122=over 4 19123 19124=item B<add_selection()> 19125 19126=back 19127 19128=over 4 19129 19130=item B<clear_selections()> 19131 19132=back 19133 19134=over 4 19135 19136=item B<match_section()> 19137 19138=back 19139 19140=over 4 19141 19142=item B<is_selected()> 19143 19144=back 19145 19146=over 4 19147 19148=item EXPORTED FUNCTIONS 19149 19150=back 19151 19152=over 4 19153 19154=item B<podselect()> 19155 19156B<-output>, B<-sections>, B<-ranges> 19157 19158=back 19159 19160=over 4 19161 19162=item PRIVATE METHODS AND DATA 19163 19164=back 19165 19166=over 4 19167 19168=item B<_compile_section_spec()> 19169 19170=back 19171 19172=over 4 19173 19174=item $self->{_SECTION_HEADINGS} 19175 19176=back 19177 19178=over 4 19179 19180=item $self->{_SELECTED_SECTIONS} 19181 19182=back 19183 19184=over 4 19185 19186=item SEE ALSO 19187 19188=item AUTHOR 19189 19190=back 19191 19192=head2 Pod::Text - Convert POD data to formatted ASCII text 19193 19194=over 4 19195 19196=item SYNOPSIS 19197 19198=item DESCRIPTION 19199 19200alt, code, indent, loose, margin, quotes, sentence, width 19201 19202=item DIAGNOSTICS 19203 19204Bizarre space in item, Item called without tag, Can't open %s for reading: 19205%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, 19206%s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: 19207Unmatched =back 19208 19209=item RESTRICTIONS 19210 19211=item NOTES 19212 19213=item SEE ALSO 19214 19215=item AUTHOR 19216 19217=item COPYRIGHT AND LICENSE 19218 19219=back 19220 19221=head2 Pod::Text::Color - Convert POD data to formatted color ASCII text 19222 19223=over 4 19224 19225=item SYNOPSIS 19226 19227=item DESCRIPTION 19228 19229=item BUGS 19230 19231=item SEE ALSO 19232 19233=item AUTHOR 19234 19235=item COPYRIGHT AND LICENSE 19236 19237=back 19238 19239=head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike 19240text 19241 19242=over 4 19243 19244=item SYNOPSIS 19245 19246=item DESCRIPTION 19247 19248=item BUGS 19249 19250=item SEE ALSO 19251 19252=item AUTHOR 19253 19254=item COPYRIGHT AND LICENSE 19255 19256=back 19257 19258=head2 Pod::Text::Termcap - Convert POD data to ASCII text with format 19259escapes 19260 19261=over 4 19262 19263=item SYNOPSIS 19264 19265=item DESCRIPTION 19266 19267=item NOTES 19268 19269=item SEE ALSO 19270 19271=item AUTHOR 19272 19273=item COPYRIGHT AND LICENSE 19274 19275=back 19276 19277=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod 19278documentation 19279 19280=over 4 19281 19282=item SYNOPSIS 19283 19284=item ARGUMENTS 19285 19286C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, 19287C<-pathlist> 19288 19289=item DESCRIPTION 19290 19291=item EXAMPLES 19292 19293=over 4 19294 19295=item Recommended Use 19296 19297=back 19298 19299=item CAVEATS 19300 19301=item AUTHOR 19302 19303=item ACKNOWLEDGEMENTS 19304 19305=back 19306 19307=head2 SDBM_File - Tied access to sdbm files 19308 19309=over 4 19310 19311=item SYNOPSIS 19312 19313=item DESCRIPTION 19314 19315C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> 19316 19317=item DIAGNOSTICS 19318 19319=over 4 19320 19321=item C<sdbm store returned -1, errno 22, key "..." at ...> 19322 19323=back 19324 19325=item BUGS AND WARNINGS 19326 19327=back 19328 19329=head2 Safe - Compile and execute code in restricted compartments 19330 19331=over 4 19332 19333=item SYNOPSIS 19334 19335=item DESCRIPTION 19336 19337a new namespace, an operator mask 19338 19339=item WARNING 19340 19341=over 4 19342 19343=item RECENT CHANGES 19344 19345=item Methods in class Safe 19346 19347permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, 19348...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from 19349(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), 19350root (NAMESPACE), mask (MASK) 19351 19352=item Some Safety Issues 19353 19354Memory, CPU, Snooping, Signals, State Changes 19355 19356=item AUTHOR 19357 19358=back 19359 19360=back 19361 19362=head2 Scalar::Util - A selection of general-utility scalar subroutines 19363 19364=over 4 19365 19366=item SYNOPSIS 19367 19368=item DESCRIPTION 19369 19370blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, 19371looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, 19372set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF 19373 19374=item KNOWN BUGS 19375 19376=item COPYRIGHT 19377 19378=item BLATANT PLUG 19379 19380=back 19381 19382=head2 Search::Dict, look - search for key in dictionary file 19383 19384=over 4 19385 19386=item SYNOPSIS 19387 19388=item DESCRIPTION 19389 19390=back 19391 19392=head2 SelectSaver - save and restore selected file handle 19393 19394=over 4 19395 19396=item SYNOPSIS 19397 19398=item DESCRIPTION 19399 19400=back 19401 19402=head2 SelfLoader - load functions only on demand 19403 19404=over 4 19405 19406=item SYNOPSIS 19407 19408=item DESCRIPTION 19409 19410=over 4 19411 19412=item The __DATA__ token 19413 19414=item SelfLoader autoloading 19415 19416=item Autoloading and package lexicals 19417 19418=item SelfLoader and AutoLoader 19419 19420=item __DATA__, __END__, and the FOOBAR::DATA filehandle. 19421 19422=item Classes and inherited methods. 19423 19424=back 19425 19426=item Multiple packages and fully qualified subroutine names 19427 19428=back 19429 19430=head2 Shell - run shell commands transparently within perl 19431 19432=over 4 19433 19434=item SYNOPSIS 19435 19436=item DESCRIPTION 19437 19438=over 4 19439 19440=item OBJECT ORIENTED SYNTAX 19441 19442=back 19443 19444=item AUTHOR 19445 19446=back 19447 19448=head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C 19449socket.h defines and structure manipulators 19450 19451=over 4 19452 19453=item SYNOPSIS 19454 19455=item DESCRIPTION 19456 19457inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, 19458INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, 19459ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, 19460unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un 19461SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN 19462 19463=back 19464 19465=head2 Storable - persistence for Perl data structures 19466 19467=over 4 19468 19469=item SYNOPSIS 19470 19471=item DESCRIPTION 19472 19473=item MEMORY STORE 19474 19475=item ADVISORY LOCKING 19476 19477=item SPEED 19478 19479=item CANONICAL REPRESENTATION 19480 19481=item CODE REFERENCES 19482 19483=item FORWARD COMPATIBILITY 19484 19485utf8 data, restricted hashes, files from future versions of Storable 19486 19487=item ERROR REPORTING 19488 19489=item WIZARDS ONLY 19490 19491=over 4 19492 19493=item Hooks 19494 19495C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, 19496I<serialized>, .. 19497 19498=item Predicates 19499 19500C<Storable::last_op_in_netorder>, C<Storable::is_storing>, 19501C<Storable::is_retrieving> 19502 19503=item Recursion 19504 19505=item Deep Cloning 19506 19507=back 19508 19509=item Storable magic 19510 19511=item EXAMPLES 19512 19513=item WARNING 19514 19515=item BUGS 19516 19517=over 4 19518 19519=item 64 bit data in perl 5.6.0 and 5.6.1 19520 19521=back 19522 19523=item CREDITS 19524 19525=item AUTHOR 19526 19527=item SEE ALSO 19528 19529=back 19530 19531=head2 Switch - A switch statement for Perl 19532 19533=over 4 19534 19535=item VERSION 19536 19537=item SYNOPSIS 19538 19539=item BACKGROUND 19540 19541=item DESCRIPTION 19542 19543=over 4 19544 19545=item Allowing fall-through 19546 19547=item Automating fall-through 19548 19549=item Alternative syntax 19550 19551=item Higher-order Operations 19552 19553=back 19554 19555=item DEPENDENCIES 19556 19557=item AUTHOR 19558 19559=item BUGS 19560 19561=item LIMITATIONS 19562 19563=item COPYRIGHT 19564 19565=back 19566 19567=head2 Symbol - manipulate Perl symbols and their names 19568 19569=over 4 19570 19571=item SYNOPSIS 19572 19573=item DESCRIPTION 19574 19575=item BUGS 19576 19577=back 19578 19579=head2 Sys::Hostname - Try every conceivable way to get hostname 19580 19581=over 4 19582 19583=item SYNOPSIS 19584 19585=item DESCRIPTION 19586 19587=item AUTHOR 19588 19589=back 19590 19591=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl 19592interface to the UNIX syslog(3) calls 19593 19594=over 4 19595 19596=item SYNOPSIS 19597 19598=item DESCRIPTION 19599 19600openlog $ident, $logopt, $facility, syslog $priority, $format, @args, 19601setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added 19602in 5.004_02), closelog 19603 19604=item EXAMPLES 19605 19606=item SEE ALSO 19607 19608=item AUTHOR 19609 19610=back 19611 19612=head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - 19613Perl interface to the UNIX syslog(3) calls 19614 19615=over 4 19616 19617=item SYNOPSIS 19618 19619=item DESCRIPTION 19620 19621openlog $ident, $logopt, $facility, syslog $priority, $format, @args, 19622setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added 19623in 5.004_02), closelog 19624 19625=item EXAMPLES 19626 19627=item SEE ALSO 19628 19629=item AUTHOR 19630 19631=back 19632 19633=head2 Term::ANSIColor - Color screen output using ANSI escape sequences 19634 19635=over 4 19636 19637=item SYNOPSIS 19638 19639=item DESCRIPTION 19640 19641=item DIAGNOSTICS 19642 19643Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in 19644use, Invalid attribute name %s, Name "%s" used only once: possible typo, No 19645comma allowed after filehandle, No name for escape sequence %s 19646 19647=item ENVIRONMENT 19648 19649ANSI_COLORS_DISABLED 19650 19651=item RESTRICTIONS 19652 19653=item NOTES 19654 19655=item SEE ALSO 19656 19657=item AUTHORS 19658 19659=item COPYRIGHT AND LICENSE 19660 19661=back 19662 19663=head2 Term::Cap - Perl termcap interface 19664 19665=over 4 19666 19667=item SYNOPSIS 19668 19669=item DESCRIPTION 19670 19671=over 4 19672 19673=item METHODS 19674 19675=back 19676 19677=back 19678 19679B<Tgetent>, OSPEED, TERM 19680 19681B<Tpad>, B<$string>, B<$cnt>, B<$FH> 19682 19683B<Tputs>, B<$cap>, B<$cnt>, B<$FH> 19684 19685B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> 19686 19687B<Trequire> 19688 19689=over 4 19690 19691=item EXAMPLES 19692 19693=item COPYRIGHT AND LICENSE 19694 19695=item AUTHOR 19696 19697=item SEE ALSO 19698 19699=back 19700 19701=head2 Term::Complete - Perl word completion module 19702 19703=over 4 19704 19705=item SYNOPSIS 19706 19707=item DESCRIPTION 19708 19709E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> 19710 19711=item DIAGNOSTICS 19712 19713=item BUGS 19714 19715=item AUTHOR 19716 19717=back 19718 19719=head2 Term::ReadLine - Perl interface to various C<readline> packages. 19720If no real package is found, substitutes stubs instead of basic functions. 19721 19722=over 4 19723 19724=item SYNOPSIS 19725 19726=item DESCRIPTION 19727 19728=item Minimal set of supported functions 19729 19730C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>, 19731C<findConsole>, Attribs, C<Features> 19732 19733=item Additional supported functions 19734 19735C<tkRunning>, C<ornaments>, C<newTTY> 19736 19737=item EXPORTS 19738 19739=item ENVIRONMENT 19740 19741=item CAVEATS 19742 19743=back 19744 19745=head2 Test - provides a simple framework for writing test scripts 19746 19747=over 4 19748 19749=item SYNOPSIS 19750 19751=item DESCRIPTION 19752 19753=item QUICK START GUIDE 19754 19755=over 4 19756 19757=item Functions 19758 19759C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>, 19760C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub> 19761 19762=back 19763 19764=back 19765 19766B<_to_value> 19767 19768C<ok(...)> 19769 19770C<skip(I<skip_if_true>, I<args...>)> 19771 19772=over 4 19773 19774=item TEST TYPES 19775 19776NORMAL TESTS, SKIPPED TESTS, TODO TESTS 19777 19778=item ONFAIL 19779 19780=item BUGS and CAVEATS 19781 19782=item NOTE 19783 19784=item SEE ALSO 19785 19786=item AUTHOR 19787 19788=back 19789 19790=head2 Test::Builder - Backend for building test libraries 19791 19792=over 4 19793 19794=item SYNOPSIS 19795 19796=item DESCRIPTION 19797 19798=over 4 19799 19800=item Construction 19801 19802B<new> 19803 19804=back 19805 19806=back 19807 19808=over 4 19809 19810=item Setting up tests 19811 19812B<exported_to> 19813 19814=back 19815 19816B<plan> 19817 19818B<expected_tests> 19819 19820B<no_plan> 19821 19822B<has_plan> 19823 19824B<skip_all> 19825 19826=over 4 19827 19828=item Running tests 19829 19830B<ok> 19831 19832=back 19833 19834B<is_eq>, B<is_num> 19835 19836B<isnt_eq>, B<isnt_num> 19837 19838B<like>, B<unlike> 19839 19840B<maybe_regex> 19841 19842B<cmp_ok> 19843 19844B<BAILOUT> 19845 19846B<skip> 19847 19848B<todo_skip> 19849 19850B<skip_rest> 19851 19852=over 4 19853 19854=item Test style 19855 19856B<level> 19857 19858=back 19859 19860B<use_numbers> 19861 19862B<no_header>, B<no_ending> 19863 19864=over 4 19865 19866=item Output 19867 19868B<diag> 19869 19870=back 19871 19872B<_print> 19873 19874B<output>, B<failure_output>, B<todo_output> 19875 19876=over 4 19877 19878=item Test Status and Info 19879 19880B<current_test> 19881 19882=back 19883 19884B<summary> 19885 19886B<details> 19887 19888B<todo> 19889 19890B<caller> 19891 19892B<_sanity_check> 19893 19894B<_whoa> 19895 19896B<_my_exit> 19897 19898=over 4 19899 19900=item THREADS 19901 19902=item EXAMPLES 19903 19904=item SEE ALSO 19905 19906=item AUTHORS 19907 19908=item COPYRIGHT 19909 19910=back 19911 19912=head2 Test::Harness - Run Perl standard test scripts with statistics 19913 19914=over 4 19915 19916=item VERSION 19917 19918=back 19919 19920=over 4 19921 19922=item SYNOPSIS 19923 19924=item DESCRIPTION 19925 19926=over 4 19927 19928=item The test script output 19929 19930B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>, 19931B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything 19932else> 19933 19934=item Taint mode 19935 19936=item Configuration variables. 19937 19938B<$Test::Harness::Verbose>, B<$Test::Harness::switches> 19939 19940=item Failure 19941 19942B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of 19943Failed> 19944 19945=item Functions 19946 19947B<runtests> 19948 19949=back 19950 19951=back 19952 19953B<_all_ok> 19954 19955B<_globdir> 19956 19957B<_run_all_tests> 19958 19959B<_mk_leader> 19960 19961B<_leader_width> 19962 19963=over 4 19964 19965=item EXPORT 19966 19967=item DIAGNOSTICS 19968 19969C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests 19970%s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat 19971%d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. 19972%s>, C<FAILED--Further testing stopped: %s> 19973 19974=item ENVIRONMENT 19975 19976C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, 19977C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, 19978C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>, 19979C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> 19980 19981=item EXAMPLE 19982 19983=item SEE ALSO 19984 19985=item AUTHORS 19986 19987=item LICENSE 19988 19989=item TODO 19990 19991=item BUGS 19992 19993=item AUTHORS 19994 19995=item COPYRIGHT 19996 19997=back 19998 19999=head2 Test::Harness::Assert - simple assert 20000 20001=over 4 20002 20003=item SYNOPSIS 20004 20005=item DESCRIPTION 20006 20007=item FUNCTIONS 20008 20009=over 4 20010 20011=item C<assert()> 20012 20013=back 20014 20015=back 20016 20017=over 4 20018 20019=item AUTHOR 20020 20021=item SEE ALSO 20022 20023=back 20024 20025=head2 Test::Harness::Iterator - Internal Test::Harness Iterator 20026 20027=over 4 20028 20029=item SYNOPSIS 20030 20031=item DESCRIPTION 20032 20033=over 4 20034 20035=item new() 20036 20037=item next() 20038 20039=back 20040 20041=back 20042 20043=head2 Test::Harness::Straps - detailed analysis of test results 20044 20045=over 4 20046 20047=item SYNOPSIS 20048 20049=item DESCRIPTION 20050 20051=item Construction 20052 20053=over 4 20054 20055=item C<new> 20056 20057=back 20058 20059=back 20060 20061=over 4 20062 20063=item C<_init> 20064 20065=back 20066 20067=over 4 20068 20069=item Analysis 20070 20071=over 4 20072 20073=item C<analyze> 20074 20075=back 20076 20077=back 20078 20079=over 4 20080 20081=item C<analyze_fh> 20082 20083=back 20084 20085=over 4 20086 20087=item C<analyze_file> 20088 20089=back 20090 20091=over 4 20092 20093=item C<_command_line( $file )> 20094 20095=back 20096 20097=over 4 20098 20099=item C<_command> 20100 20101=back 20102 20103=over 4 20104 20105=item C<_switches> 20106 20107=back 20108 20109=over 4 20110 20111=item C<_cleaned_switches> 20112 20113=back 20114 20115=over 4 20116 20117=item C<_INC2PERL5LIB> 20118 20119=back 20120 20121=over 4 20122 20123=item C<_filtered_INC> 20124 20125=back 20126 20127=over 4 20128 20129=item C<_restore_PERL5LIB> 20130 20131=back 20132 20133=over 4 20134 20135=item Parsing 20136 20137=over 4 20138 20139=item C<_is_comment> 20140 20141=back 20142 20143=back 20144 20145=over 4 20146 20147=item C<_is_header> 20148 20149=back 20150 20151=over 4 20152 20153=item C<_is_test> 20154 20155=back 20156 20157=over 4 20158 20159=item C<_is_bail_out> 20160 20161=back 20162 20163=over 4 20164 20165=item C<_reset_file_state> 20166 20167=back 20168 20169=over 4 20170 20171=item Results 20172 20173=over 4 20174 20175=item C<_detailize> 20176 20177=back 20178 20179=back 20180 20181=over 4 20182 20183=item EXAMPLES 20184 20185=item AUTHOR 20186 20187=item SEE ALSO 20188 20189=back 20190 20191=head2 Test::More - yet another framework for writing test scripts 20192 20193=over 4 20194 20195=item SYNOPSIS 20196 20197=item DESCRIPTION 20198 20199=over 4 20200 20201=item I love it when a plan comes together 20202 20203=back 20204 20205=back 20206 20207=over 4 20208 20209=item Test names 20210 20211=item I'm ok, you're not ok. 20212 20213B<ok> 20214 20215=back 20216 20217B<is>, B<isnt> 20218 20219B<like> 20220 20221B<unlike> 20222 20223B<cmp_ok> 20224 20225B<can_ok> 20226 20227B<isa_ok> 20228 20229B<pass>, B<fail> 20230 20231=over 4 20232 20233=item Diagnostics 20234 20235B<diag> 20236 20237=back 20238 20239=over 4 20240 20241=item Module tests 20242 20243B<use_ok> 20244 20245=back 20246 20247B<require_ok> 20248 20249=over 4 20250 20251=item Conditional tests 20252 20253B<SKIP: BLOCK> 20254 20255=back 20256 20257B<TODO: BLOCK>, B<todo_skip> 20258 20259When do I use SKIP vs. TODO? 20260 20261=over 4 20262 20263=item Comparison functions 20264 20265B<is_deeply> 20266 20267=back 20268 20269B<eq_array> 20270 20271B<eq_hash> 20272 20273B<eq_set> 20274 20275=over 4 20276 20277=item Extending and Embedding Test::More 20278 20279B<builder> 20280 20281=back 20282 20283=over 4 20284 20285=item NOTES 20286 20287=item BUGS and CAVEATS 20288 20289Making your own ok(), The eq_* family has some caveats, Test::Harness 20290upgrades 20291 20292=item HISTORY 20293 20294=item SEE ALSO 20295 20296=item AUTHORS 20297 20298=item COPYRIGHT 20299 20300=back 20301 20302=head2 Test::Simple - Basic utilities for writing tests. 20303 20304=over 4 20305 20306=item SYNOPSIS 20307 20308=item DESCRIPTION 20309 20310B<ok> 20311 20312=back 20313 20314=over 4 20315 20316=item EXAMPLE 20317 20318=item CAVEATS 20319 20320=item NOTES 20321 20322=item HISTORY 20323 20324=item SEE ALSO 20325 20326L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, 20327L<Test::Harness> 20328 20329=item AUTHORS 20330 20331=item COPYRIGHT 20332 20333=back 20334 20335=head2 Test::Tutorial - A tutorial about writing really basic tests 20336 20337=over 4 20338 20339=item DESCRIPTION 20340 20341=over 4 20342 20343=item Nuts and bolts of testing. 20344 20345=item Where to start? 20346 20347=item Names 20348 20349=item Test the manual 20350 20351=item Sometimes the tests are wrong 20352 20353=item Testing lots of values 20354 20355=item Informative names 20356 20357=item Skipping tests 20358 20359=item Todo tests 20360 20361=item Testing with taint mode. 20362 20363=back 20364 20365=item FOOTNOTES 20366 20367=item AUTHORS 20368 20369=item COPYRIGHT 20370 20371=back 20372 20373=head2 Text::Abbrev, abbrev - create an abbreviation table from a list 20374 20375=over 4 20376 20377=item SYNOPSIS 20378 20379=item DESCRIPTION 20380 20381=item EXAMPLE 20382 20383=back 20384 20385=head2 Text::Balanced - Extract delimited text sequences from strings. 20386 20387=over 4 20388 20389=item SYNOPSIS 20390 20391=item DESCRIPTION 20392 20393=over 4 20394 20395=item General behaviour in list contexts 20396 20397[0], [1], [2] 20398 20399=item General behaviour in scalar and void contexts 20400 20401=item A note about prefixes 20402 20403=item C<extract_delimited> 20404 20405=item C<extract_bracketed> 20406 20407=item C<extract_variable> 20408 20409[0], [1], [2] 20410 20411=item C<extract_tagged> 20412 20413C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, 20414[0], [1], [2], [3], [4], [5] 20415 20416=item C<gen_extract_tagged> 20417 20418=item C<extract_quotelike> 20419 20420[0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] 20421 20422=item C<extract_quotelike> and "here documents" 20423 20424[0], [1], [2], [3], [4], [5], [6], [7..10] 20425 20426=item C<extract_codeblock> 20427 20428=item C<extract_multiple> 20429 20430=item C<gen_delimited_pat> 20431 20432=back 20433 20434=item DIAGNOSTICS 20435 20436 C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, 20437C<Did not find opening bracket after prefix: "%s">, C<No quotelike 20438operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, 20439C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, 20440C<Did not find closing delimiter to match '%s'>, C<Mismatched closing 20441bracket: expected "%c" but found "%s">, C<No block delimiter found after 20442quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier 20443after dereferencer>, C<Did not find expected opening bracket at %s>, 20444C<Improperly nested codeblock at %s>, C<Missing second block for quotelike 20445"%s">, C<No match found for opening bracket>, C<Did not find opening tag: 20446/%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid 20447nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing 20448tag> 20449 20450=item AUTHOR 20451 20452=item BUGS AND IRRITATIONS 20453 20454=item COPYRIGHT 20455 20456=back 20457 20458=head2 Text::ParseWords - parse text into an array of tokens or array of 20459arrays 20460 20461=over 4 20462 20463=item SYNOPSIS 20464 20465=item DESCRIPTION 20466 20467=item EXAMPLES 20468 20469=item AUTHORS 20470 20471=back 20472 20473=head2 Text::Soundex - Implementation of the Soundex Algorithm as Described 20474by Knuth 20475 20476=over 4 20477 20478=item SYNOPSIS 20479 20480=item DESCRIPTION 20481 20482=item EXAMPLES 20483 20484=item LIMITATIONS 20485 20486=item AUTHOR 20487 20488=back 20489 20490=head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and 20491unexpand(1) 20492 20493=over 4 20494 20495=item SYNOPSIS 20496 20497=item DESCRIPTION 20498 20499=item BUGS 20500 20501=item AUTHOR 20502 20503=back 20504 20505=head2 Text::Wrap - line wrapping to form simple paragraphs 20506 20507=over 4 20508 20509=item SYNOPSIS 20510 20511=item DESCRIPTION 20512 20513=item OVERRIDES 20514 20515=item EXAMPLE 20516 20517=item AUTHOR 20518 20519=back 20520 20521=head2 Thread - manipulate threads in Perl (for old code only) 20522 20523=over 4 20524 20525=item CAVEAT 20526 20527=item SYNOPSIS 20528 20529=item DESCRIPTION 20530 20531=item FUNCTIONS 20532 20533$thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, 20534LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, 20535cond_signal VARIABLE, cond_broadcast VARIABLE, yield 20536 20537=item METHODS 20538 20539join, eval, detach, equal, tid, flags, done 20540 20541=item LIMITATIONS 20542 20543=item SEE ALSO 20544 20545=back 20546 20547=head2 Thread::Queue - thread-safe queues 20548 20549=over 4 20550 20551=item SYNOPSIS 20552 20553=item DESCRIPTION 20554 20555=item FUNCTIONS AND METHODS 20556 20557new, enqueue LIST, dequeue, dequeue_nb, pending 20558 20559=item SEE ALSO 20560 20561=back 20562 20563=head2 Thread::Semaphore - thread-safe semaphores 20564 20565=over 4 20566 20567=item SYNOPSIS 20568 20569=item DESCRIPTION 20570 20571=item FUNCTIONS AND METHODS 20572 20573new, new NUMBER, down, down NUMBER, up, up NUMBER 20574 20575=back 20576 20577=head2 Thread::Signal - Start a thread which runs signal handlers reliably 20578(for old code) 20579 20580=over 4 20581 20582=item CAVEAT 20583 20584=item SYNOPSIS 20585 20586=item DESCRIPTION 20587 20588=item BUGS 20589 20590=back 20591 20592=head2 Thread::Specific - thread-specific keys 20593 20594=over 4 20595 20596=item SYNOPSIS 20597 20598=item DESCRIPTION 20599 20600=back 20601 20602=head2 Tie::Array - base class for tied arrays 20603 20604=over 4 20605 20606=item SYNOPSIS 20607 20608=item DESCRIPTION 20609 20610TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, 20611FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, 20612key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, 20613SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST 20614 20615=item CAVEATS 20616 20617=item AUTHOR 20618 20619=back 20620 20621=head2 Tie::File - Access the lines of a disk file via a Perl array 20622 20623=over 4 20624 20625=item SYNOPSIS 20626 20627=item DESCRIPTION 20628 20629=over 4 20630 20631=item C<recsep> 20632 20633=item C<autochomp> 20634 20635=item C<mode> 20636 20637=item C<memory> 20638 20639=item C<dw_size> 20640 20641=item Option Format 20642 20643=back 20644 20645=item Public Methods 20646 20647=over 4 20648 20649=item C<flock> 20650 20651=item C<autochomp> 20652 20653=item C<defer>, C<flush>, C<discard>, and C<autodefer> 20654 20655=item C<offset> 20656 20657=back 20658 20659=item Tying to an already-opened filehandle 20660 20661=item Deferred Writing 20662 20663=over 4 20664 20665=item Autodeferring 20666 20667=back 20668 20669=item CONCURRENT ACCESS TO FILES 20670 20671=item CAVEATS 20672 20673=item SUBCLASSING 20674 20675=item WHAT ABOUT C<DB_File>? 20676 20677=item AUTHOR 20678 20679=item LICENSE 20680 20681=item WARRANTY 20682 20683=item THANKS 20684 20685=item TODO 20686 20687=back 20688 20689=head2 Tie::Handle, Tie::StdHandle - base class definitions for tied 20690handles 20691 20692=over 4 20693 20694=item SYNOPSIS 20695 20696=item DESCRIPTION 20697 20698TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, 20699LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, 20700READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, 20701EOF this, TELL this, SEEK this, offset, whence, DESTROY this 20702 20703=item MORE INFORMATION 20704 20705=item COMPATIBILITY 20706 20707=back 20708 20709=head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for 20710tied hashes 20711 20712=over 4 20713 20714=item SYNOPSIS 20715 20716=item DESCRIPTION 20717 20718TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY 20719this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR 20720this, SCALAR this 20721 20722=item Inheriting from B<Tie::StdHash> 20723 20724=item Inheriting from B<Tie::ExtraHash> 20725 20726=item C<SCALAR>, C<UNTIE> and C<DESTROY> 20727 20728=item MORE INFORMATION 20729 20730=back 20731 20732=head2 Tie::Memoize - add data to hash when needed 20733 20734=over 4 20735 20736=item SYNOPSIS 20737 20738=item DESCRIPTION 20739 20740=item Inheriting from B<Tie::Memoize> 20741 20742=item EXAMPLE 20743 20744=item BUGS 20745 20746=item AUTHOR 20747 20748=back 20749 20750=head2 Tie::RefHash - use references as hash keys 20751 20752=over 4 20753 20754=item SYNOPSIS 20755 20756=item DESCRIPTION 20757 20758=item EXAMPLE 20759 20760=item AUTHOR 20761 20762=item VERSION 20763 20764=item SEE ALSO 20765 20766=back 20767 20768=head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied 20769scalars 20770 20771=over 4 20772 20773=item SYNOPSIS 20774 20775=item DESCRIPTION 20776 20777TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this 20778 20779=item MORE INFORMATION 20780 20781=back 20782 20783=head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing 20784 20785=over 4 20786 20787=item SYNOPSIS 20788 20789=item DESCRIPTION 20790 20791=item CAVEATS 20792 20793=back 20794 20795=head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval 20796timers 20797 20798=over 4 20799 20800=item SYNOPSIS 20801 20802=item DESCRIPTION 20803 20804gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, 20805$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), 20806alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( 20807$which, $floating_seconds [, $interval_floating_seconds ] ), getitimer ( 20808$which ) 20809 20810=item EXAMPLES 20811 20812=item C API 20813 20814=item DIAGNOSTICS 20815 20816=over 4 20817 20818=item negative time not invented yet 20819 20820=item internal error: useconds < 0 (unsigned ... signed ...) 20821 20822=back 20823 20824=item CAVEATS 20825 20826=item AUTHORS 20827 20828=item COPYRIGHT AND LICENSE 20829 20830=back 20831 20832=head2 Time::Local - efficiently compute time from local and GMT time 20833 20834=over 4 20835 20836=item SYNOPSIS 20837 20838=item DESCRIPTION 20839 20840=item IMPLEMENTATION 20841 20842=item BUGS 20843 20844=item SUPPORT 20845 20846=item AUTHOR 20847 20848=back 20849 20850=head2 Time::gmtime - by-name interface to Perl's built-in gmtime() 20851function 20852 20853=over 4 20854 20855=item SYNOPSIS 20856 20857=item DESCRIPTION 20858 20859=item NOTE 20860 20861=item AUTHOR 20862 20863=back 20864 20865=head2 Time::localtime - by-name interface to Perl's built-in localtime() 20866function 20867 20868=over 4 20869 20870=item SYNOPSIS 20871 20872=item DESCRIPTION 20873 20874=item NOTE 20875 20876=item AUTHOR 20877 20878=back 20879 20880=head2 Time::tm - internal object used by Time::gmtime and Time::localtime 20881 20882=over 4 20883 20884=item SYNOPSIS 20885 20886=item DESCRIPTION 20887 20888=item AUTHOR 20889 20890=back 20891 20892=head2 UNIVERSAL - base class for ALL classes (blessed references) 20893 20894=over 4 20895 20896=item SYNOPSIS 20897 20898=item DESCRIPTION 20899 20900C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>, 20901C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<< 20902CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )> 20903 20904=item EXPORTS 20905 20906=back 20907 20908=head2 Unicode::Collate - Unicode Collation Algorithm 20909 20910=over 4 20911 20912=item SYNOPSIS 20913 20914=item DESCRIPTION 20915 20916=over 4 20917 20918=item Constructor and Tailoring 20919 20920UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar, 20921level, normalization, overrideCJK, overrideHangul, preprocess, rearrange, 20922table, undefName, undefChar, katakana_before_hiragana, upper_before_lower, 20923variable, alternate 20924 20925=item Methods for Collation 20926 20927C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = 20928$Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, 20929C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, 20930$b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = 20931$Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, 20932C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm = 20933$Collator-E<gt>viewSortKey($string)> 20934 20935=item Methods for Searching 20936 20937C<$position = $Collator-E<gt>index($string, $substring[, $position])>, 20938C<($position, $length) = $Collator-E<gt>index($string, $substring[, 20939$position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>, 20940C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match = 20941$Collator-E<gt>gmatch($string, $substring)>, C<$count = 20942$Collator-E<gt>subst($string, $substring, $replacement)>, C<$count = 20943$Collator-E<gt>gsubst($string, $substring, $replacement)> 20944 20945=item Other Methods 20946 20947C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version = 20948$Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()> 20949 20950=item EXPORT 20951 20952=item CAVEAT 20953 20954=item Conformance Test 20955 20956=back 20957 20958=item AUTHOR 20959 20960=item SEE ALSO 20961 20962Unicode Collation Algorithm - UTS #10, The Default Unicode Collation 20963Element Table (DUCET), The conformance test for the UCA, Hangul Syllable 20964Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize> 20965 20966=back 20967 20968=head2 Unicode::Normalize - Unicode Normalization Forms 20969 20970=over 4 20971 20972=item SYNOPSIS 20973 20974=item DESCRIPTION 20975 20976=over 4 20977 20978=item Normalization Forms 20979 20980C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, 20981C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, 20982C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>, 20983C<$normalized_string = normalize($form_name, $string)> 20984 20985=item Decomposition and Composition 20986 20987C<$decomposed_string = decompose($string)>, C<$decomposed_string = 20988decompose($string, $useCompatMapping)>, C<$reordered_string = 20989reorder($string)>, C<$composed_string = compose($string)> 20990 20991=item Quick Check 20992 20993C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = 20994checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = 20995checkFCD($string)>, C<$result = checkFCC($string)>, C<$result = 20996check($form_name, $string)> 20997 20998=item Character Data 20999 21000C<$canonical_decomposed = getCanon($codepoint)>, 21001C<$compatibility_decomposed = getCompat($codepoint)>, 21002C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, 21003C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = 21004isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, 21005C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, 21006C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> 21007 21008=item EXPORT 21009 21010=back 21011 21012=item AUTHOR 21013 21014=item SEE ALSO 21015 21016http://www.unicode.org/reports/tr15/, 21017http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, 21018http://www.unicode.org/notes/tn5/ 21019 21020=back 21021 21022=head2 Unicode::UCD - Unicode character database 21023 21024=over 4 21025 21026=item SYNOPSIS 21027 21028=item DESCRIPTION 21029 21030=back 21031 21032=over 4 21033 21034=item charinfo 21035 21036=back 21037 21038=over 4 21039 21040=item charblock 21041 21042=back 21043 21044=over 4 21045 21046=item charscript 21047 21048=back 21049 21050=over 4 21051 21052=item charblocks 21053 21054=back 21055 21056=over 4 21057 21058=item charscripts 21059 21060=back 21061 21062=over 4 21063 21064=item Blocks versus Scripts 21065 21066=item Matching Scripts and Blocks 21067 21068=item Code Point Arguments 21069 21070=item charinrange 21071 21072=back 21073 21074=over 4 21075 21076=item compexcl 21077 21078=back 21079 21080=over 4 21081 21082=item casefold 21083 21084=back 21085 21086=over 4 21087 21088=item casespec 21089 21090=back 21091 21092=over 4 21093 21094=item Unicode::UCD::UnicodeVersion 21095 21096=back 21097 21098=over 4 21099 21100=item Implementation Note 21101 21102=back 21103 21104=over 4 21105 21106=item BUGS 21107 21108=item AUTHOR 21109 21110=back 21111 21112=head2 User::grent - by-name interface to Perl's built-in getgr*() 21113functions 21114 21115=over 4 21116 21117=item SYNOPSIS 21118 21119=item DESCRIPTION 21120 21121=item NOTE 21122 21123=item AUTHOR 21124 21125=back 21126 21127=head2 User::pwent - by-name interface to Perl's built-in getpw*() 21128functions 21129 21130=over 4 21131 21132=item SYNOPSIS 21133 21134=item DESCRIPTION 21135 21136=over 4 21137 21138=item System Specifics 21139 21140=back 21141 21142=item NOTE 21143 21144=item AUTHOR 21145 21146=item HISTORY 21147 21148March 18th, 2000 21149 21150=back 21151 21152=head2 XSLoader - Dynamically load C libraries into Perl code 21153 21154=over 4 21155 21156=item SYNOPSIS 21157 21158=item DESCRIPTION 21159 21160=over 4 21161 21162=item Migration from C<DynaLoader> 21163 21164=item Backward compatible boilerplate 21165 21166=back 21167 21168=item Order of initialization: early load() 21169 21170=over 4 21171 21172=item The most hairy case 21173 21174=back 21175 21176=item LIMITATIONS 21177 21178=item AUTHOR 21179 21180=back 21181 21182=head1 AUXILIARY DOCUMENTATION 21183 21184Here should be listed all the extra programs' documentation, but they 21185don't all have manual pages yet: 21186 21187=over 4 21188 21189=item a2p 21190 21191=item c2ph 21192 21193=item dprofpp 21194 21195=item h2ph 21196 21197=item h2xs 21198 21199=item perlbug 21200 21201=item perldoc 21202 21203=item pl2pm 21204 21205=item pod2html 21206 21207=item pod2man 21208 21209=item s2p 21210 21211=item splain 21212 21213=item xsubpp 21214 21215=back 21216 21217=head1 AUTHOR 21218 21219Larry Wall <F<larry@wall.org>>, with the help of oodles 21220of other folks. 21221 21222