| 1 | |
| 2 | # !!!!!!! DO NOT EDIT THIS FILE !!!!!!! |
| 3 | # This file is autogenerated by buildtoc from all the other pods. |
| 4 | # Edit those files and run buildtoc --build-toc to effect changes. |
| 5 | |
| 6 | =head1 NAME |
| 7 | |
| 8 | perltoc - perl documentation table of contents |
| 9 | |
| 10 | =head1 DESCRIPTION |
| 11 | |
| 12 | This page provides a brief table of contents for the rest of the Perl |
| 13 | documentation set. It is meant to be scanned quickly or grepped |
| 14 | through to locate the proper section you're looking for. |
| 15 | |
| 16 | =head1 BASIC DOCUMENTATION |
| 17 | |
| 18 | =head2 perl - Practical Extraction and Report Language |
| 19 | |
| 20 | =over 4 |
| 21 | |
| 22 | =item SYNOPSIS |
| 23 | |
| 24 | =over 4 |
| 25 | |
| 26 | =item Overview |
| 27 | |
| 28 | =item Tutorials |
| 29 | |
| 30 | =item Reference Manual |
| 31 | |
| 32 | =item Internals and C Language Interface |
| 33 | |
| 34 | =item Miscellaneous |
| 35 | |
| 36 | =item Language-Specific |
| 37 | |
| 38 | =item Platform-Specific |
| 39 | |
| 40 | =back |
| 41 | |
| 42 | =item DESCRIPTION |
| 43 | |
| 44 | =item AVAILABILITY |
| 45 | |
| 46 | =item ENVIRONMENT |
| 47 | |
| 48 | =item AUTHOR |
| 49 | |
| 50 | =item FILES |
| 51 | |
| 52 | =item SEE ALSO |
| 53 | |
| 54 | =item DIAGNOSTICS |
| 55 | |
| 56 | =item BUGS |
| 57 | |
| 58 | =item NOTES |
| 59 | |
| 60 | =back |
| 61 | |
| 62 | =head2 perlintro -- a brief introduction and overview of Perl |
| 63 | |
| 64 | =over 4 |
| 65 | |
| 66 | =item DESCRIPTION |
| 67 | |
| 68 | =over 4 |
| 69 | |
| 70 | =item What is Perl? |
| 71 | |
| 72 | =item Running Perl programs |
| 73 | |
| 74 | =item Basic syntax overview |
| 75 | |
| 76 | =item Perl variable types |
| 77 | |
| 78 | Scalars, Arrays, Hashes |
| 79 | |
| 80 | =item Variable scoping |
| 81 | |
| 82 | =item Conditional and looping constructs |
| 83 | |
| 84 | if, while, for, foreach |
| 85 | |
| 86 | =item Builtin operators and functions |
| 87 | |
| 88 | Arithmetic, Numeric comparison, String comparison, Boolean logic, |
| 89 | Miscellaneous |
| 90 | |
| 91 | =item Files and I/O |
| 92 | |
| 93 | =item Regular expressions |
| 94 | |
| 95 | Simple matching, Simple substitution, More complex regular expressions, |
| 96 | Parentheses 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 | |
| 156 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
| 157 | more elaborate constructs |
| 158 | |
| 159 | =item REFERENCES |
| 160 | X<reference> X<dereference> X<dereferencing> X<pointer> |
| 161 | |
| 162 | =item COMMON MISTAKES |
| 163 | |
| 164 | =item CAVEAT ON PRECEDENCE |
| 165 | X<dereference, precedence> X<dereferencing, precedence> |
| 166 | |
| 167 | =item WHY YOU SHOULD ALWAYS C<use strict> |
| 168 | |
| 169 | =item DEBUGGING |
| 170 | X<data structure, debugging> X<complex data structure, debugging> |
| 171 | X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging> |
| 172 | X<array of arrays, debugging> X<hash of arrays, debugging> |
| 173 | X<array of hashes, debugging> X<hash of hashes, debugging> |
| 174 | |
| 175 | =item CODE EXAMPLES |
| 176 | |
| 177 | =item ARRAYS OF ARRAYS |
| 178 | X<array of arrays> X<AoA> |
| 179 | |
| 180 | =over 4 |
| 181 | |
| 182 | =item Declaration of an ARRAY OF ARRAYS |
| 183 | |
| 184 | =item Generation of an ARRAY OF ARRAYS |
| 185 | |
| 186 | =item Access and Printing of an ARRAY OF ARRAYS |
| 187 | |
| 188 | =back |
| 189 | |
| 190 | =item HASHES OF ARRAYS |
| 191 | X<hash of arrays> X<HoA> |
| 192 | |
| 193 | =over 4 |
| 194 | |
| 195 | =item Declaration of a HASH OF ARRAYS |
| 196 | |
| 197 | =item Generation of a HASH OF ARRAYS |
| 198 | |
| 199 | =item Access and Printing of a HASH OF ARRAYS |
| 200 | |
| 201 | =back |
| 202 | |
| 203 | =item ARRAYS OF HASHES |
| 204 | X<array of hashes> X<AoH> |
| 205 | |
| 206 | =over 4 |
| 207 | |
| 208 | =item Declaration of an ARRAY OF HASHES |
| 209 | |
| 210 | =item Generation of an ARRAY OF HASHES |
| 211 | |
| 212 | =item Access and Printing of an ARRAY OF HASHES |
| 213 | |
| 214 | =back |
| 215 | |
| 216 | =item HASHES OF HASHES |
| 217 | X<hass of hashes> X<HoH> |
| 218 | |
| 219 | =over 4 |
| 220 | |
| 221 | =item Declaration of a HASH OF HASHES |
| 222 | |
| 223 | =item Generation of a HASH OF HASHES |
| 224 | |
| 225 | =item Access and Printing of a HASH OF HASHES |
| 226 | |
| 227 | =back |
| 228 | |
| 229 | =item MORE ELABORATE RECORDS |
| 230 | X<record> X<structure> X<struct> |
| 231 | |
| 232 | =over 4 |
| 233 | |
| 234 | =item Declaration of MORE ELABORATE RECORDS |
| 235 | |
| 236 | =item Declaration of a HASH OF COMPLEX RECORDS |
| 237 | |
| 238 | =item Generation of a HASH OF COMPLEX RECORDS |
| 239 | |
| 240 | =back |
| 241 | |
| 242 | =item Database Ties |
| 243 | |
| 244 | =item SEE ALSO |
| 245 | |
| 246 | =item AUTHOR |
| 247 | |
| 248 | =back |
| 249 | |
| 250 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
| 251 | |
| 252 | =over 4 |
| 253 | |
| 254 | =item DESCRIPTION |
| 255 | |
| 256 | =over 4 |
| 257 | |
| 258 | =item Declaration and Access of Arrays of Arrays |
| 259 | |
| 260 | =item Growing Your Own |
| 261 | |
| 262 | =item Access and Printing |
| 263 | |
| 264 | =item Slices |
| 265 | |
| 266 | =back |
| 267 | |
| 268 | =item SEE ALSO |
| 269 | |
| 270 | =item AUTHOR |
| 271 | |
| 272 | =back |
| 273 | |
| 274 | =head2 perlrequick - Perl regular expressions quick start |
| 275 | |
| 276 | =over 4 |
| 277 | |
| 278 | =item DESCRIPTION |
| 279 | |
| 280 | =item The Guide |
| 281 | |
| 282 | =over 4 |
| 283 | |
| 284 | =item Simple word matching |
| 285 | |
| 286 | =item Using character classes |
| 287 | |
| 288 | =item Matching this or that |
| 289 | |
| 290 | =item Grouping things and hierarchical matching |
| 291 | |
| 292 | =item Extracting matches |
| 293 | |
| 294 | =item Matching repetitions |
| 295 | |
| 296 | =item More matching |
| 297 | |
| 298 | =item Search and replace |
| 299 | |
| 300 | =item The split operator |
| 301 | |
| 302 | =back |
| 303 | |
| 304 | =item BUGS |
| 305 | |
| 306 | =item SEE ALSO |
| 307 | |
| 308 | =item AUTHOR AND COPYRIGHT |
| 309 | |
| 310 | =over 4 |
| 311 | |
| 312 | =item Acknowledgments |
| 313 | |
| 314 | =back |
| 315 | |
| 316 | =back |
| 317 | |
| 318 | =head2 perlretut - Perl regular expressions tutorial |
| 319 | |
| 320 | =over 4 |
| 321 | |
| 322 | =item DESCRIPTION |
| 323 | |
| 324 | =item Part 1: The basics |
| 325 | |
| 326 | =over 4 |
| 327 | |
| 328 | =item Simple word matching |
| 329 | |
| 330 | =item Using character classes |
| 331 | |
| 332 | =item Matching this or that |
| 333 | |
| 334 | =item Grouping things and hierarchical matching |
| 335 | |
| 336 | =item Extracting matches |
| 337 | |
| 338 | =item Matching repetitions |
| 339 | |
| 340 | =item Building a regexp |
| 341 | |
| 342 | =item Using regular expressions in Perl |
| 343 | |
| 344 | =back |
| 345 | |
| 346 | =item Part 2: Power tools |
| 347 | |
| 348 | =over 4 |
| 349 | |
| 350 | =item More on characters, strings, and character classes |
| 351 | |
| 352 | =item Compiling and saving regular expressions |
| 353 | |
| 354 | =item Embedding comments and modifiers in a regular expression |
| 355 | |
| 356 | =item Non-capturing groupings |
| 357 | |
| 358 | =item Looking ahead and looking behind |
| 359 | |
| 360 | =item Using independent subexpressions to prevent backtracking |
| 361 | |
| 362 | =item Conditional expressions |
| 363 | |
| 364 | =item A bit of magic: executing Perl code in a regular expression |
| 365 | |
| 366 | =item Pragmas and debugging |
| 367 | |
| 368 | =back |
| 369 | |
| 370 | =item BUGS |
| 371 | |
| 372 | =item SEE ALSO |
| 373 | |
| 374 | =item AUTHOR AND COPYRIGHT |
| 375 | |
| 376 | =over 4 |
| 377 | |
| 378 | =item Acknowledgments |
| 379 | |
| 380 | =back |
| 381 | |
| 382 | =back |
| 383 | |
| 384 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
| 385 | |
| 386 | =over 4 |
| 387 | |
| 388 | =item DESCRIPTION |
| 389 | |
| 390 | =over 4 |
| 391 | |
| 392 | =item If we could talk to the animals... |
| 393 | |
| 394 | =item Introducing the method invocation arrow |
| 395 | |
| 396 | =item Invoking a barnyard |
| 397 | |
| 398 | =item The extra parameter of method invocation |
| 399 | |
| 400 | =item Calling a second method to simplify things |
| 401 | |
| 402 | =item Inheriting the windpipes |
| 403 | |
| 404 | =item A few notes about @ISA |
| 405 | |
| 406 | =item Overriding the methods |
| 407 | |
| 408 | =item Starting the search from a different place |
| 409 | |
| 410 | =item The SUPER way of doing things |
| 411 | |
| 412 | =item Where we're at so far... |
| 413 | |
| 414 | =item A horse is a horse, of course of course -- or is it? |
| 415 | |
| 416 | =item Invoking an instance method |
| 417 | |
| 418 | =item Accessing the instance data |
| 419 | |
| 420 | =item How to build a horse |
| 421 | |
| 422 | =item Inheriting the constructor |
| 423 | |
| 424 | =item Making a method work with either classes or instances |
| 425 | |
| 426 | =item Adding parameters to a method |
| 427 | |
| 428 | =item More interesting instances |
| 429 | |
| 430 | =item A horse of a different color |
| 431 | |
| 432 | =item Summary |
| 433 | |
| 434 | =back |
| 435 | |
| 436 | =item SEE ALSO |
| 437 | |
| 438 | =item COPYRIGHT |
| 439 | |
| 440 | =back |
| 441 | |
| 442 | =head2 perltoot - Tom's object-oriented tutorial for perl |
| 443 | |
| 444 | =over 4 |
| 445 | |
| 446 | =item DESCRIPTION |
| 447 | |
| 448 | =item Creating a Class |
| 449 | |
| 450 | =over 4 |
| 451 | |
| 452 | =item Object Representation |
| 453 | |
| 454 | =item Class Interface |
| 455 | |
| 456 | =item Constructors and Instance Methods |
| 457 | |
| 458 | =item Planning for the Future: Better Constructors |
| 459 | |
| 460 | =item Destructors |
| 461 | |
| 462 | =item Other Object Methods |
| 463 | |
| 464 | =back |
| 465 | |
| 466 | =item Class Data |
| 467 | |
| 468 | =over 4 |
| 469 | |
| 470 | =item Accessing Class Data |
| 471 | |
| 472 | =item Debugging Methods |
| 473 | |
| 474 | =item Class Destructors |
| 475 | |
| 476 | =item Documenting the Interface |
| 477 | |
| 478 | =back |
| 479 | |
| 480 | =item Aggregation |
| 481 | |
| 482 | =item Inheritance |
| 483 | |
| 484 | =over 4 |
| 485 | |
| 486 | =item Overridden Methods |
| 487 | |
| 488 | =item Multiple Inheritance |
| 489 | |
| 490 | =item UNIVERSAL: The Root of All Objects |
| 491 | |
| 492 | =back |
| 493 | |
| 494 | =item Alternate Object Representations |
| 495 | |
| 496 | =over 4 |
| 497 | |
| 498 | =item Arrays as Objects |
| 499 | |
| 500 | =item Closures as Objects |
| 501 | |
| 502 | =back |
| 503 | |
| 504 | =item AUTOLOAD: Proxy Methods |
| 505 | |
| 506 | =over 4 |
| 507 | |
| 508 | =item Autoloaded Data Methods |
| 509 | |
| 510 | =item Inherited Autoloaded Data Methods |
| 511 | |
| 512 | =back |
| 513 | |
| 514 | =item Metaclassical Tools |
| 515 | |
| 516 | =over 4 |
| 517 | |
| 518 | =item Class::Struct |
| 519 | |
| 520 | =item Data Members as Variables |
| 521 | |
| 522 | =back |
| 523 | |
| 524 | =item NOTES |
| 525 | |
| 526 | =over 4 |
| 527 | |
| 528 | =item Object Terminology |
| 529 | |
| 530 | =back |
| 531 | |
| 532 | =item SEE ALSO |
| 533 | |
| 534 | =item AUTHOR AND COPYRIGHT |
| 535 | |
| 536 | =item COPYRIGHT |
| 537 | |
| 538 | =over 4 |
| 539 | |
| 540 | =item Acknowledgments |
| 541 | |
| 542 | =back |
| 543 | |
| 544 | =back |
| 545 | |
| 546 | =head2 perltooc - Tom's OO Tutorial for Class Data in Perl |
| 547 | |
| 548 | =over 4 |
| 549 | |
| 550 | =item DESCRIPTION |
| 551 | |
| 552 | =item Class Data in a Can |
| 553 | |
| 554 | =item Class Data as Package Variables |
| 555 | |
| 556 | =over 4 |
| 557 | |
| 558 | =item Putting All Your Eggs in One Basket |
| 559 | |
| 560 | =item Inheritance Concerns |
| 561 | |
| 562 | =item The Eponymous Meta-Object |
| 563 | |
| 564 | =item Indirect References to Class Data |
| 565 | |
| 566 | =item Monadic Classes |
| 567 | |
| 568 | =item Translucent Attributes |
| 569 | |
| 570 | =back |
| 571 | |
| 572 | =item Class Data as Lexical Variables |
| 573 | |
| 574 | =over 4 |
| 575 | |
| 576 | =item Privacy and Responsibility |
| 577 | |
| 578 | =item File-Scoped Lexicals |
| 579 | |
| 580 | =item More Inheritance Concerns |
| 581 | |
| 582 | =item Locking the Door and Throwing Away the Key |
| 583 | |
| 584 | =item Translucency Revisited |
| 585 | |
| 586 | =back |
| 587 | |
| 588 | =item NOTES |
| 589 | |
| 590 | =item SEE ALSO |
| 591 | |
| 592 | =item AUTHOR AND COPYRIGHT |
| 593 | |
| 594 | =item ACKNOWLEDGEMENTS |
| 595 | |
| 596 | =item HISTORY |
| 597 | |
| 598 | =back |
| 599 | |
| 600 | =head2 perlbot - Bag'o Object Tricks (the BOT) |
| 601 | |
| 602 | =over 4 |
| 603 | |
| 604 | =item DESCRIPTION |
| 605 | |
| 606 | =item OO SCALING TIPS |
| 607 | |
| 608 | =item INSTANCE VARIABLES |
| 609 | |
| 610 | =item SCALAR INSTANCE VARIABLES |
| 611 | |
| 612 | =item INSTANCE VARIABLE INHERITANCE |
| 613 | |
| 614 | =item OBJECT RELATIONSHIPS |
| 615 | |
| 616 | =item OVERRIDING SUPERCLASS METHODS |
| 617 | |
| 618 | =item USING RELATIONSHIP WITH SDBM |
| 619 | |
| 620 | =item THINKING OF CODE REUSE |
| 621 | |
| 622 | =item CLASS CONTEXT AND THE OBJECT |
| 623 | |
| 624 | =item INHERITING A CONSTRUCTOR |
| 625 | |
| 626 | =item DELEGATION |
| 627 | |
| 628 | =item SEE ALSO |
| 629 | |
| 630 | =back |
| 631 | |
| 632 | =head2 perlstyle - Perl style guide |
| 633 | |
| 634 | =over 4 |
| 635 | |
| 636 | =item DESCRIPTION |
| 637 | |
| 638 | =back |
| 639 | |
| 640 | =head2 perlcheat - Perl 5 Cheat Sheet |
| 641 | |
| 642 | =over 4 |
| 643 | |
| 644 | =item DESCRIPTION |
| 645 | |
| 646 | =over 4 |
| 647 | |
| 648 | =item The sheet |
| 649 | |
| 650 | =back |
| 651 | |
| 652 | =item ACKNOWLEDGEMENTS |
| 653 | |
| 654 | =item AUTHOR |
| 655 | |
| 656 | =item SEE ALSO |
| 657 | |
| 658 | =back |
| 659 | |
| 660 | =head2 perltrap - Perl traps for the unwary |
| 661 | |
| 662 | =over 4 |
| 663 | |
| 664 | =item DESCRIPTION |
| 665 | |
| 666 | =over 4 |
| 667 | |
| 668 | =item Awk Traps |
| 669 | |
| 670 | =item C/C++ Traps |
| 671 | |
| 672 | =item Sed Traps |
| 673 | |
| 674 | =item Shell Traps |
| 675 | |
| 676 | =item Perl Traps |
| 677 | |
| 678 | =item Perl4 to Perl5 Traps |
| 679 | |
| 680 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
| 681 | Traps, General data type traps, Context Traps - scalar, list contexts, |
| 682 | Precedence Traps, General Regular Expression Traps using s///, etc, |
| 683 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps |
| 684 | |
| 685 | =item Discontinuance, Deprecation, and BugFix traps |
| 686 | |
| 687 | Symbols starting with "_" no longer forced into main, Double-colon valid |
| 688 | package separator in variable name, 2nd and 3rd args to C<splice()> are now |
| 689 | in scalar context, Can't do C<goto> into a block that is optimized away, |
| 690 | Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK |
| 691 | BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when |
| 692 | iterating over a list, C<split> with no args behavior changed, B<-e> |
| 693 | behavior fixed, C<push> returns number of elements in resulting list, Some |
| 694 | error messages differ, C<split()> honors subroutine args, Bugs removed |
| 695 | |
| 696 | =item Parsing Traps |
| 697 | |
| 698 | Space between . and = triggers syntax error, Better parsing in perl 5, |
| 699 | Function parsing, String interpolation of C<$#array> differs, Perl guesses |
| 700 | on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref |
| 701 | |
| 702 | =item Numerical Traps |
| 703 | |
| 704 | Formatted output and significant digits, Auto-increment operator over |
| 705 | signed int limit deleted, Assignment of return values from numeric equality |
| 706 | tests doesn't work, Bitwise string ops |
| 707 | |
| 708 | =item General data type traps |
| 709 | |
| 710 | Negative array subscripts now count from the end of array, Setting |
| 711 | C<$#array> lower now discards array elements, Hashes get defined before |
| 712 | use, Glob assignment from localized variable to variable, Assigning |
| 713 | C<undef> to glob, Changes in unary negation (of strings), Modifying of |
| 714 | constants prohibited, C<defined $var> behavior changed, Variable Suicide |
| 715 | |
| 716 | =item Context Traps - scalar, list contexts |
| 717 | |
| 718 | Elements of argument lists for formats evaluated in list context, |
| 719 | C<caller()> returns false value in scalar context if no caller present, |
| 720 | Comma operator in scalar context gives scalar context to args, C<sprintf()> |
| 721 | prototyped as C<($;@)> |
| 722 | |
| 723 | =item Precedence Traps |
| 724 | |
| 725 | LHS vs. RHS of any assignment operator, Semantic errors introduced due to |
| 726 | precedence, Precedence of assignment operators same as the precedence of |
| 727 | assignment, C<open> requires parentheses around filehandle, C<$:> |
| 728 | precedence over C<$::> gone, Precedence of file test operators documented, |
| 729 | C<keys>, C<each>, C<values> are regular named unary operators |
| 730 | |
| 731 | =item General Regular Expression Traps using s///, etc. |
| 732 | |
| 733 | C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to |
| 734 | the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set |
| 735 | to whole match, Substitution now returns null string if it fails, |
| 736 | C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables |
| 737 | in regular expressions, C<m?x?> matches only once, Failed matches don't |
| 738 | reset the match variables |
| 739 | |
| 740 | =item Subroutine, Signal, Sorting Traps |
| 741 | |
| 742 | Barewords that used to look like strings look like subroutine calls, |
| 743 | Reverse is no longer allowed as the name of a sort subroutine, C<warn()> |
| 744 | won't let you specify a filehandle |
| 745 | |
| 746 | =item OS Traps |
| 747 | |
| 748 | SysV resets signal handler correctly, SysV C<seek()> appends correctly |
| 749 | |
| 750 | =item Interpolation Traps |
| 751 | |
| 752 | C<@> always interpolates an array in double-quotish strings, Double-quoted |
| 753 | strings may no longer end with an unescaped $, Arbitrary expressions are |
| 754 | evaluated inside braces within double quotes, C<$$x> now tries to |
| 755 | dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires |
| 756 | protection, Bugs in earlier perl versions, Array and hash brackets during |
| 757 | interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to |
| 758 | C<eval> will not find string terminator |
| 759 | |
| 760 | =item DBM Traps |
| 761 | |
| 762 | Perl5 must have been linked with same dbm/ndbm as the default for |
| 763 | C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to |
| 764 | exit immediately |
| 765 | |
| 766 | =item Unclassified Traps |
| 767 | |
| 768 | C<require>/C<do> trap using returned value, C<split> on empty string with |
| 769 | LIMIT specified |
| 770 | |
| 771 | =back |
| 772 | |
| 773 | =back |
| 774 | |
| 775 | =head2 perldebtut - Perl debugging tutorial |
| 776 | |
| 777 | =over 4 |
| 778 | |
| 779 | =item DESCRIPTION |
| 780 | |
| 781 | =item use strict |
| 782 | |
| 783 | =item Looking at data and -w and v |
| 784 | |
| 785 | =item help |
| 786 | |
| 787 | =item Stepping through code |
| 788 | |
| 789 | =item Placeholder for a, w, t, T |
| 790 | |
| 791 | =item REGULAR EXPRESSIONS |
| 792 | |
| 793 | =item OUTPUT TIPS |
| 794 | |
| 795 | =item CGI |
| 796 | |
| 797 | =item GUIs |
| 798 | |
| 799 | =item SUMMARY |
| 800 | |
| 801 | =item SEE ALSO |
| 802 | |
| 803 | =item AUTHOR |
| 804 | |
| 805 | =item CONTRIBUTORS |
| 806 | |
| 807 | =back |
| 808 | |
| 809 | =head2 perlfaq - frequently asked questions about Perl ($Date: 2005/12/30 |
| 810 | 15:04:07 $) |
| 811 | |
| 812 | =over 4 |
| 813 | |
| 814 | =item DESCRIPTION |
| 815 | |
| 816 | =over 4 |
| 817 | |
| 818 | =item Where to get the perlfaq |
| 819 | |
| 820 | =item How to contribute to the perlfaq |
| 821 | |
| 822 | =item What will happen if you mail your Perl programming problems to the |
| 823 | authors |
| 824 | |
| 825 | =back |
| 826 | |
| 827 | =item Credits |
| 828 | |
| 829 | =item Author and Copyright Information |
| 830 | |
| 831 | =over 4 |
| 832 | |
| 833 | =item Bundled Distributions |
| 834 | |
| 835 | =item Disclaimer |
| 836 | |
| 837 | =back |
| 838 | |
| 839 | =item Table of Contents |
| 840 | |
| 841 | perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2 |
| 842 | - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4 |
| 843 | - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular |
| 844 | Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System |
| 845 | Interaction, perlfaq9 - Networking |
| 846 | |
| 847 | =item The Questions |
| 848 | |
| 849 | =over 4 |
| 850 | |
| 851 | =item L<perlfaq1>: General Questions About Perl |
| 852 | |
| 853 | =item L<perlfaq2>: Obtaining and Learning about Perl |
| 854 | |
| 855 | =item L<perlfaq3>: Programming Tools |
| 856 | |
| 857 | =item L<perlfaq4>: Data Manipulation |
| 858 | |
| 859 | =item L<perlfaq5>: Files and Formats |
| 860 | |
| 861 | =item L<perlfaq6>: Regular Expressions |
| 862 | |
| 863 | =item L<perlfaq7>: General Perl Language Issues |
| 864 | |
| 865 | =item L<perlfaq8>: System Interaction |
| 866 | |
| 867 | =item L<perlfaq9>: Networking |
| 868 | |
| 869 | =back |
| 870 | |
| 871 | =back |
| 872 | |
| 873 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date: |
| 874 | 2005/12/31 00:54:37 $) |
| 875 | |
| 876 | =over 4 |
| 877 | |
| 878 | =item DESCRIPTION |
| 879 | |
| 880 | =over 4 |
| 881 | |
| 882 | =item What is Perl? |
| 883 | |
| 884 | =item Who supports Perl? Who develops it? Why is it free? |
| 885 | |
| 886 | =item Which version of Perl should I use? |
| 887 | |
| 888 | =item What are perl4, perl5, or perl6? |
| 889 | |
| 890 | =item What is Ponie? |
| 891 | |
| 892 | =item What is perl6? |
| 893 | |
| 894 | =item How stable is Perl? |
| 895 | |
| 896 | =item Is Perl difficult to learn? |
| 897 | |
| 898 | =item How does Perl compare with other languages like Java, Python, REXX, |
| 899 | Scheme, or Tcl? |
| 900 | |
| 901 | =item Can I do [task] in Perl? |
| 902 | |
| 903 | =item When shouldn't I program in Perl? |
| 904 | |
| 905 | =item What's the difference between "perl" and "Perl"? |
| 906 | |
| 907 | =item Is it a Perl program or a Perl script? |
| 908 | |
| 909 | =item What is a JAPH? |
| 910 | |
| 911 | =item Where can I get a list of Larry Wall witticisms? |
| 912 | |
| 913 | =item How can I convince my sysadmin/supervisor/employees to use version |
| 914 | 5/5.6.1/Perl instead of some other language? |
| 915 | |
| 916 | =back |
| 917 | |
| 918 | =item AUTHOR AND COPYRIGHT |
| 919 | |
| 920 | =back |
| 921 | |
| 922 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.38 $, |
| 923 | $Date: 2005/12/31 00:54:37 $) |
| 924 | |
| 925 | =over 4 |
| 926 | |
| 927 | =item DESCRIPTION |
| 928 | |
| 929 | =over 4 |
| 930 | |
| 931 | =item What machines support perl? Where do I get it? |
| 932 | |
| 933 | =item How can I get a binary version of perl? |
| 934 | |
| 935 | =item I don't have a C compiler. How can I build my own Perl interpreter? |
| 936 | |
| 937 | =item I copied the perl binary from one machine to another, but scripts |
| 938 | don't work. |
| 939 | |
| 940 | =item I grabbed the sources and tried to compile but gdbm/dynamic |
| 941 | loading/malloc/linking/... failed. How do I make it work? |
| 942 | |
| 943 | =item What modules and extensions are available for Perl? What is CPAN? |
| 944 | What does CPAN/src/... mean? |
| 945 | |
| 946 | =item Is there an ISO or ANSI certified version of Perl? |
| 947 | |
| 948 | =item Where can I get information on Perl? |
| 949 | |
| 950 | =item What are the Perl newsgroups on Usenet? Where do I post questions? |
| 951 | |
| 952 | =item Where should I post source code? |
| 953 | |
| 954 | =item Perl Books |
| 955 | |
| 956 | References, Tutorials, Task-Oriented, Special Topics |
| 957 | |
| 958 | =item Perl in Magazines |
| 959 | |
| 960 | =item Perl on the Net: FTP and WWW Access |
| 961 | |
| 962 | =item What mailing lists are there for Perl? |
| 963 | |
| 964 | =item Archives of comp.lang.perl.misc |
| 965 | |
| 966 | =item Where can I buy a commercial version of perl? |
| 967 | |
| 968 | =item Where do I send bug reports? |
| 969 | |
| 970 | =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? |
| 971 | |
| 972 | =back |
| 973 | |
| 974 | =item AUTHOR AND COPYRIGHT |
| 975 | |
| 976 | =back |
| 977 | |
| 978 | =head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31 |
| 979 | 00:54:37 $) |
| 980 | |
| 981 | =over 4 |
| 982 | |
| 983 | =item DESCRIPTION |
| 984 | |
| 985 | =over 4 |
| 986 | |
| 987 | =item How do I do (anything)? |
| 988 | |
| 989 | =item How can I use Perl interactively? |
| 990 | |
| 991 | =item Is there a Perl shell? |
| 992 | |
| 993 | =item How do I find which modules are installed on my system? |
| 994 | |
| 995 | =item How do I debug my Perl programs? |
| 996 | |
| 997 | =item How do I profile my Perl programs? |
| 998 | |
| 999 | =item How do I cross-reference my Perl programs? |
| 1000 | |
| 1001 | =item Is there a pretty-printer (formatter) for Perl? |
| 1002 | |
| 1003 | =item Is there a ctags for Perl? |
| 1004 | |
| 1005 | =item Is there an IDE or Windows Perl Editor? |
| 1006 | |
| 1007 | Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, |
| 1008 | visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, |
| 1009 | Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, |
| 1010 | Alpha, BBEdit and BBEdit Lite |
| 1011 | |
| 1012 | =item Where can I get Perl macros for vi? |
| 1013 | |
| 1014 | =item Where can I get perl-mode for emacs? |
| 1015 | |
| 1016 | =item How can I use curses with Perl? |
| 1017 | |
| 1018 | =item How can I use X or Tk with Perl? |
| 1019 | |
| 1020 | =item How can I make my Perl program run faster? |
| 1021 | |
| 1022 | =item How can I make my Perl program take less memory? |
| 1023 | |
| 1024 | Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and |
| 1025 | stringification, Pass by reference, Tie large variables to disk |
| 1026 | |
| 1027 | =item Is it safe to return a reference to local or lexical data? |
| 1028 | |
| 1029 | =item How can I free an array or hash so my program shrinks? |
| 1030 | |
| 1031 | =item How can I make my CGI script more efficient? |
| 1032 | |
| 1033 | =item How can I hide the source for my Perl program? |
| 1034 | |
| 1035 | =item How can I compile my Perl program into byte code or C? |
| 1036 | |
| 1037 | =item How can I compile Perl into Java? |
| 1038 | |
| 1039 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? |
| 1040 | |
| 1041 | =item Can I write useful Perl programs on the command line? |
| 1042 | |
| 1043 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? |
| 1044 | |
| 1045 | =item Where can I learn about CGI or Web programming in Perl? |
| 1046 | |
| 1047 | =item Where can I learn about object-oriented Perl programming? |
| 1048 | |
| 1049 | =item Where can I learn about linking C with Perl? |
| 1050 | |
| 1051 | =item I've read perlembed, perlguts, etc., but I can't embed perl in my C |
| 1052 | program; what am I doing wrong? |
| 1053 | |
| 1054 | =item When I tried to run my script, I got this message. What does it mean? |
| 1055 | |
| 1056 | =item What's MakeMaker? |
| 1057 | |
| 1058 | =back |
| 1059 | |
| 1060 | =item AUTHOR AND COPYRIGHT |
| 1061 | |
| 1062 | =back |
| 1063 | |
| 1064 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31 |
| 1065 | 00:54:37 $) |
| 1066 | |
| 1067 | =over 4 |
| 1068 | |
| 1069 | =item DESCRIPTION |
| 1070 | |
| 1071 | =item Data: Numbers |
| 1072 | |
| 1073 | =over 4 |
| 1074 | |
| 1075 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the |
| 1076 | numbers I should be getting (eg, 19.95)? |
| 1077 | |
| 1078 | =item Why is int() broken? |
| 1079 | |
| 1080 | =item Why isn't my octal data interpreted correctly? |
| 1081 | |
| 1082 | =item Does Perl have a round() function? What about ceil() and floor()? |
| 1083 | Trig functions? |
| 1084 | |
| 1085 | =item How do I convert between numeric representations/bases/radixes? |
| 1086 | |
| 1087 | How do I convert hexadecimal into decimal, How do I convert from decimal to |
| 1088 | hexadecimal, How do I convert from octal to decimal, How do I convert from |
| 1089 | decimal to octal, How do I convert from binary to decimal, How do I convert |
| 1090 | from decimal to binary |
| 1091 | |
| 1092 | =item Why doesn't & work the way I want it to? |
| 1093 | |
| 1094 | =item How do I multiply matrices? |
| 1095 | |
| 1096 | =item How do I perform an operation on a series of integers? |
| 1097 | |
| 1098 | =item How can I output Roman numerals? |
| 1099 | |
| 1100 | =item Why aren't my random numbers random? |
| 1101 | |
| 1102 | =item How do I get a random number between X and Y? |
| 1103 | |
| 1104 | =back |
| 1105 | |
| 1106 | =item Data: Dates |
| 1107 | |
| 1108 | =over 4 |
| 1109 | |
| 1110 | =item How do I find the day or week of the year? |
| 1111 | |
| 1112 | =item How do I find the current century or millennium? |
| 1113 | |
| 1114 | =item How can I compare two dates and find the difference? |
| 1115 | |
| 1116 | =item How can I take a string and turn it into epoch seconds? |
| 1117 | |
| 1118 | =item How can I find the Julian Day? |
| 1119 | |
| 1120 | =item How do I find yesterday's date? |
| 1121 | |
| 1122 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? |
| 1123 | |
| 1124 | =back |
| 1125 | |
| 1126 | =item Data: Strings |
| 1127 | |
| 1128 | =over 4 |
| 1129 | |
| 1130 | =item How do I validate input? |
| 1131 | |
| 1132 | =item How do I unescape a string? |
| 1133 | |
| 1134 | =item How do I remove consecutive pairs of characters? |
| 1135 | |
| 1136 | =item How do I expand function calls in a string? |
| 1137 | |
| 1138 | =item How do I find matching/nesting anything? |
| 1139 | |
| 1140 | =item How do I reverse a string? |
| 1141 | |
| 1142 | =item How do I expand tabs in a string? |
| 1143 | |
| 1144 | =item How do I reformat a paragraph? |
| 1145 | |
| 1146 | =item How can I access or change N characters of a string? |
| 1147 | |
| 1148 | =item How do I change the Nth occurrence of something? |
| 1149 | |
| 1150 | =item How can I count the number of occurrences of a substring within a |
| 1151 | string? |
| 1152 | |
| 1153 | =item How do I capitalize all the words on one line? |
| 1154 | |
| 1155 | =item How can I split a [character] delimited string except when inside |
| 1156 | [character]? |
| 1157 | |
| 1158 | =item How do I strip blank space from the beginning/end of a string? |
| 1159 | |
| 1160 | =item How do I pad a string with blanks or pad a number with zeroes? |
| 1161 | |
| 1162 | =item How do I extract selected columns from a string? |
| 1163 | |
| 1164 | =item How do I find the soundex value of a string? |
| 1165 | |
| 1166 | =item How can I expand variables in text strings? |
| 1167 | |
| 1168 | =item What's wrong with always quoting "$vars"? |
| 1169 | |
| 1170 | =item Why don't my E<lt>E<lt>HERE documents work? |
| 1171 | |
| 1172 | There must be no space after the E<lt>E<lt> part, There (probably) should |
| 1173 | be a semicolon at the end, You can't (easily) have any space in front of |
| 1174 | the tag |
| 1175 | |
| 1176 | =back |
| 1177 | |
| 1178 | =item Data: Arrays |
| 1179 | |
| 1180 | =over 4 |
| 1181 | |
| 1182 | =item What is the difference between a list and an array? |
| 1183 | |
| 1184 | =item What is the difference between $array[1] and @array[1]? |
| 1185 | |
| 1186 | =item How can I remove duplicate elements from a list or array? |
| 1187 | |
| 1188 | =item How can I tell whether a certain element is contained in a list or |
| 1189 | array? |
| 1190 | |
| 1191 | =item How do I compute the difference of two arrays? How do I compute the |
| 1192 | intersection of two arrays? |
| 1193 | |
| 1194 | =item How do I test whether two arrays or hashes are equal? |
| 1195 | |
| 1196 | =item How do I find the first array element for which a condition is true? |
| 1197 | |
| 1198 | =item How do I handle linked lists? |
| 1199 | |
| 1200 | =item How do I handle circular lists? |
| 1201 | |
| 1202 | =item How do I shuffle an array randomly? |
| 1203 | |
| 1204 | =item How do I process/modify each element of an array? |
| 1205 | |
| 1206 | =item How do I select a random element from an array? |
| 1207 | |
| 1208 | =item How do I permute N elements of a list? |
| 1209 | |
| 1210 | =item How do I sort an array by (anything)? |
| 1211 | |
| 1212 | =item How do I manipulate arrays of bits? |
| 1213 | |
| 1214 | =item Why does defined() return true on empty arrays and hashes? |
| 1215 | |
| 1216 | =back |
| 1217 | |
| 1218 | =item Data: Hashes (Associative Arrays) |
| 1219 | |
| 1220 | =over 4 |
| 1221 | |
| 1222 | =item How do I process an entire hash? |
| 1223 | |
| 1224 | =item What happens if I add or remove keys from a hash while iterating over |
| 1225 | it? |
| 1226 | |
| 1227 | =item How do I look up a hash element by value? |
| 1228 | |
| 1229 | =item How can I know how many entries are in a hash? |
| 1230 | |
| 1231 | =item How do I sort a hash (optionally by value instead of key)? |
| 1232 | |
| 1233 | =item How can I always keep my hash sorted? |
| 1234 | |
| 1235 | =item What's the difference between "delete" and "undef" with hashes? |
| 1236 | |
| 1237 | =item Why don't my tied hashes make the defined/exists distinction? |
| 1238 | |
| 1239 | =item How do I reset an each() operation part-way through? |
| 1240 | |
| 1241 | =item How can I get the unique keys from two hashes? |
| 1242 | |
| 1243 | =item How can I store a multidimensional array in a DBM file? |
| 1244 | |
| 1245 | =item How can I make my hash remember the order I put elements into it? |
| 1246 | |
| 1247 | =item Why does passing a subroutine an undefined element in a hash create |
| 1248 | it? |
| 1249 | |
| 1250 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or |
| 1251 | array of hashes or arrays? |
| 1252 | |
| 1253 | =item How can I use a reference as a hash key? |
| 1254 | |
| 1255 | =back |
| 1256 | |
| 1257 | =item Data: Misc |
| 1258 | |
| 1259 | =over 4 |
| 1260 | |
| 1261 | =item How do I handle binary data correctly? |
| 1262 | |
| 1263 | =item How do I determine whether a scalar is a number/whole/integer/float? |
| 1264 | |
| 1265 | =item How do I keep persistent data across program calls? |
| 1266 | |
| 1267 | =item How do I print out or copy a recursive data structure? |
| 1268 | |
| 1269 | =item How do I define methods for every class/object? |
| 1270 | |
| 1271 | =item How do I verify a credit card checksum? |
| 1272 | |
| 1273 | =item How do I pack arrays of doubles or floats for XS code? |
| 1274 | |
| 1275 | =back |
| 1276 | |
| 1277 | =item AUTHOR AND COPYRIGHT |
| 1278 | |
| 1279 | =back |
| 1280 | |
| 1281 | =head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31 |
| 1282 | 00:54:37 $) |
| 1283 | |
| 1284 | =over 4 |
| 1285 | |
| 1286 | =item DESCRIPTION |
| 1287 | |
| 1288 | =over 4 |
| 1289 | |
| 1290 | =item How do I flush/unbuffer an output filehandle? Why must I do this? |
| 1291 | X<flush> X<buffer> X<unbuffer> X<autoflush> |
| 1292 | |
| 1293 | =item How do I change one line in a file/delete a line in a file/insert a |
| 1294 | line in the middle of a file/append to the beginning of a file? |
| 1295 | X<file, editing> |
| 1296 | |
| 1297 | =item How do I count the number of lines in a file? |
| 1298 | X<file, counting lines> X<lines> X<line> |
| 1299 | |
| 1300 | =item How can I use Perl's C<-i> option from within a program? |
| 1301 | X<-i> X<in-place> |
| 1302 | |
| 1303 | =item How can I copy a file? |
| 1304 | X<copy> X<file, copy> |
| 1305 | |
| 1306 | =item How do I make a temporary file name? |
| 1307 | X<file, temporary> |
| 1308 | |
| 1309 | =item How can I manipulate fixed-record-length files? |
| 1310 | X<fixed-length> X<file, fixed-length records> |
| 1311 | |
| 1312 | =item How can I make a filehandle local to a subroutine? How do I pass |
| 1313 | filehandles between subroutines? How do I make an array of filehandles? |
| 1314 | X<filehandle, local> X<filehandle, passing> X<filehandle, reference> |
| 1315 | |
| 1316 | =item How can I use a filehandle indirectly? |
| 1317 | X<filehandle, indirect> |
| 1318 | |
| 1319 | =item How can I set up a footer format to be used with write()? |
| 1320 | X<footer> |
| 1321 | |
| 1322 | =item How can I write() into a string? |
| 1323 | X<write, into a string> |
| 1324 | |
| 1325 | =item How can I output my numbers with commas added? |
| 1326 | X<number, commify> |
| 1327 | |
| 1328 | =item How can I translate tildes (~) in a filename? |
| 1329 | X<tilde> X<tilde expansion> |
| 1330 | |
| 1331 | =item How come when I open a file read-write it wipes it out? |
| 1332 | X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating> |
| 1333 | |
| 1334 | =item Why do I sometimes get an "Argument list too long" when I use |
| 1335 | E<lt>*E<gt>? |
| 1336 | X<argument list too long> |
| 1337 | |
| 1338 | =item Is there a leak/bug in glob()? |
| 1339 | X<glob> |
| 1340 | |
| 1341 | =item How can I open a file with a leading ">" or trailing blanks? |
| 1342 | X<filename, special characters> |
| 1343 | |
| 1344 | =item How can I reliably rename a file? |
| 1345 | X<rename> X<mv> X<move> X<file, rename> X<ren> |
| 1346 | |
| 1347 | =item How can I lock a file? |
| 1348 | X<lock> X<file, lock> X<flock> |
| 1349 | |
| 1350 | =item Why can't I just open(FH, "E<gt>file.lock")? |
| 1351 | X<lock, lockfile race condition> |
| 1352 | |
| 1353 | =item I still don't get locking. I just want to increment the number in |
| 1354 | the file. How can I do this? |
| 1355 | X<counter> X<file, counter> |
| 1356 | |
| 1357 | =item All I want to do is append a small amount of text to the end of a |
| 1358 | file. Do I still have to use locking? |
| 1359 | X<append> X<file, append> |
| 1360 | |
| 1361 | =item How do I randomly update a binary file? |
| 1362 | X<file, binary patch> |
| 1363 | |
| 1364 | =item How do I get a file's timestamp in perl? |
| 1365 | X<timestamp> X<file, timestamp> |
| 1366 | |
| 1367 | =item How do I set a file's timestamp in perl? |
| 1368 | X<timestamp> X<file, timestamp> |
| 1369 | |
| 1370 | =item How do I print to more than one file at once? |
| 1371 | X<print, to multiple files> |
| 1372 | |
| 1373 | =item How can I read in an entire file all at once? |
| 1374 | X<slurp> X<file, slurping> |
| 1375 | |
| 1376 | =item How can I read in a file by paragraphs? |
| 1377 | X<file, reading by paragraphs> |
| 1378 | |
| 1379 | =item How can I read a single character from a file? From the keyboard? |
| 1380 | X<getc> X<file, reading one character at a time> |
| 1381 | |
| 1382 | =item How can I tell whether there's a character waiting on a filehandle? |
| 1383 | |
| 1384 | =item How do I do a C<tail -f> in perl? |
| 1385 | X<tail> |
| 1386 | |
| 1387 | =item How do I dup() a filehandle in Perl? |
| 1388 | X<dup> |
| 1389 | |
| 1390 | =item How do I close a file descriptor by number? |
| 1391 | X<file, closing file descriptors> |
| 1392 | |
| 1393 | =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't |
| 1394 | `C:\temp\foo.exe` work? |
| 1395 | X<filename, DOS issues> |
| 1396 | |
| 1397 | =item Why doesn't glob("*.*") get all the files? |
| 1398 | X<glob> |
| 1399 | |
| 1400 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber |
| 1401 | protected files? Isn't this a bug in Perl? |
| 1402 | |
| 1403 | =item How do I select a random line from a file? |
| 1404 | X<file, selecting a random line> |
| 1405 | |
| 1406 | =item Why do I get weird spaces when I print an array of lines? |
| 1407 | |
| 1408 | =back |
| 1409 | |
| 1410 | =item AUTHOR AND COPYRIGHT |
| 1411 | |
| 1412 | =back |
| 1413 | |
| 1414 | =head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31 |
| 1415 | 00:54:37 $) |
| 1416 | |
| 1417 | =over 4 |
| 1418 | |
| 1419 | =item DESCRIPTION |
| 1420 | |
| 1421 | =over 4 |
| 1422 | |
| 1423 | =item How can I hope to use regular expressions without creating illegible |
| 1424 | and unmaintainable code? |
| 1425 | X<regex, legibility> X<regexp, legibility> |
| 1426 | X<regular expression, legibility> X</x> |
| 1427 | |
| 1428 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters |
| 1429 | |
| 1430 | =item I'm having trouble matching over more than one line. What's wrong? |
| 1431 | X<regex, multiline> X<regexp, multiline> X<regular expression, multiline> |
| 1432 | |
| 1433 | =item How can I pull out lines between two patterns that are themselves on |
| 1434 | different lines? |
| 1435 | X<..> |
| 1436 | |
| 1437 | =item I put a regular expression into $/ but it didn't work. What's wrong? |
| 1438 | X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in> |
| 1439 | X<$RS, regexes in> |
| 1440 | |
| 1441 | =item How do I substitute case insensitively on the LHS while preserving |
| 1442 | case on the RHS? |
| 1443 | X<replace, case preserving> X<substitute, case preserving> |
| 1444 | X<substitution, case preserving> X<s, case preserving> |
| 1445 | |
| 1446 | =item How can I make C<\w> match national character sets? |
| 1447 | X<\w> |
| 1448 | |
| 1449 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? |
| 1450 | X<alpha> |
| 1451 | |
| 1452 | =item How can I quote a variable to use in a regex? |
| 1453 | X<regex, escaping> X<regexp, escaping> X<regular expression, escaping> |
| 1454 | |
| 1455 | =item What is C</o> really for? |
| 1456 | X</o> |
| 1457 | |
| 1458 | =item How do I use a regular expression to strip C style comments from a |
| 1459 | file? |
| 1460 | |
| 1461 | =item Can I use Perl regular expressions to match balanced text? |
| 1462 | X<regex, matching balanced test> X<regexp, matching balanced test> |
| 1463 | X<regular expression, matching balanced test> |
| 1464 | |
| 1465 | =item What does it mean that regexes are greedy? How can I get around it? |
| 1466 | X<greedy> X<greediness> |
| 1467 | |
| 1468 | =item How do I process each word on each line? |
| 1469 | X<word> |
| 1470 | |
| 1471 | =item How can I print out a word-frequency or line-frequency summary? |
| 1472 | |
| 1473 | =item How can I do approximate matching? |
| 1474 | X<match, approximate> X<matching, approximate> |
| 1475 | |
| 1476 | =item How do I efficiently match many regular expressions at once? |
| 1477 | X<regex, efficiency> X<regexp, efficiency> |
| 1478 | X<regular expression, efficiency> |
| 1479 | |
| 1480 | =item Why don't word-boundary searches with C<\b> work for me? |
| 1481 | X<\b> |
| 1482 | |
| 1483 | =item Why does using $&, $`, or $' slow my program down? |
| 1484 | X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`> |
| 1485 | |
| 1486 | =item What good is C<\G> in a regular expression? |
| 1487 | X<\G> |
| 1488 | |
| 1489 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? |
| 1490 | X<DFA> X<NFA> X<POSIX> |
| 1491 | |
| 1492 | =item What's wrong with using grep in a void context? |
| 1493 | X<grep> |
| 1494 | |
| 1495 | =item How can I match strings with multibyte characters? |
| 1496 | X<regex, and multibyte characters> X<regexp, and multibyte characters> |
| 1497 | X<regular expression, and multibyte characters> |
| 1498 | |
| 1499 | =item How do I match a pattern that is supplied by the user? |
| 1500 | |
| 1501 | =back |
| 1502 | |
| 1503 | =item AUTHOR AND COPYRIGHT |
| 1504 | |
| 1505 | =back |
| 1506 | |
| 1507 | =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date: |
| 1508 | 2005/12/31 00:54:37 $) |
| 1509 | |
| 1510 | =over 4 |
| 1511 | |
| 1512 | =item DESCRIPTION |
| 1513 | |
| 1514 | =over 4 |
| 1515 | |
| 1516 | =item Can I get a BNF/yacc/RE for the Perl language? |
| 1517 | |
| 1518 | =item What are all these $@%&* punctuation signs, and how do I know when to |
| 1519 | use them? |
| 1520 | |
| 1521 | =item Do I always/never have to quote my strings or use semicolons and |
| 1522 | commas? |
| 1523 | |
| 1524 | =item How do I skip some return values? |
| 1525 | |
| 1526 | =item How do I temporarily block warnings? |
| 1527 | |
| 1528 | =item What's an extension? |
| 1529 | |
| 1530 | =item Why do Perl operators have different precedence than C operators? |
| 1531 | |
| 1532 | =item How do I declare/create a structure? |
| 1533 | |
| 1534 | =item How do I create a module? |
| 1535 | |
| 1536 | =item How do I create a class? |
| 1537 | |
| 1538 | =item How can I tell if a variable is tainted? |
| 1539 | |
| 1540 | =item What's a closure? |
| 1541 | |
| 1542 | =item What is variable suicide and how can I prevent it? |
| 1543 | |
| 1544 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
| 1545 | Regex}? |
| 1546 | |
| 1547 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
| 1548 | Passing Methods |
| 1549 | |
| 1550 | =item How do I create a static variable? |
| 1551 | |
| 1552 | =item What's the difference between dynamic and lexical (static) scoping? |
| 1553 | Between local() and my()? |
| 1554 | |
| 1555 | =item How can I access a dynamic variable while a similarly named lexical |
| 1556 | is in scope? |
| 1557 | |
| 1558 | =item What's the difference between deep and shallow binding? |
| 1559 | |
| 1560 | =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right? |
| 1561 | |
| 1562 | =item How do I redefine a builtin function, operator, or method? |
| 1563 | |
| 1564 | =item What's the difference between calling a function as &foo and foo()? |
| 1565 | |
| 1566 | =item How do I create a switch or case statement? |
| 1567 | |
| 1568 | =item How can I catch accesses to undefined variables, functions, or |
| 1569 | methods? |
| 1570 | |
| 1571 | =item Why can't a method included in this same file be found? |
| 1572 | |
| 1573 | =item How can I find out my current package? |
| 1574 | |
| 1575 | =item How can I comment out a large block of perl code? |
| 1576 | |
| 1577 | =item How do I clear a package? |
| 1578 | |
| 1579 | =item How can I use a variable as a variable name? |
| 1580 | |
| 1581 | =item What does "bad interpreter" mean? |
| 1582 | |
| 1583 | =back |
| 1584 | |
| 1585 | =item AUTHOR AND COPYRIGHT |
| 1586 | |
| 1587 | =back |
| 1588 | |
| 1589 | =head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31 |
| 1590 | 00:54:37 $) |
| 1591 | |
| 1592 | =over 4 |
| 1593 | |
| 1594 | =item DESCRIPTION |
| 1595 | |
| 1596 | =over 4 |
| 1597 | |
| 1598 | =item How do I find out which operating system I'm running under? |
| 1599 | |
| 1600 | =item How come exec() doesn't return? |
| 1601 | |
| 1602 | =item How do I do fancy stuff with the keyboard/screen/mouse? |
| 1603 | |
| 1604 | Keyboard, Screen, Mouse |
| 1605 | |
| 1606 | =item How do I print something out in color? |
| 1607 | |
| 1608 | =item How do I read just one key without waiting for a return key? |
| 1609 | |
| 1610 | =item How do I check whether input is ready on the keyboard? |
| 1611 | |
| 1612 | =item How do I clear the screen? |
| 1613 | |
| 1614 | =item How do I get the screen size? |
| 1615 | |
| 1616 | =item How do I ask the user for a password? |
| 1617 | |
| 1618 | =item How do I read and write the serial port? |
| 1619 | |
| 1620 | lockfiles, open mode, end of line, flushing output, non-blocking input |
| 1621 | |
| 1622 | =item How do I decode encrypted password files? |
| 1623 | |
| 1624 | =item How do I start a process in the background? |
| 1625 | |
| 1626 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
| 1627 | |
| 1628 | =item How do I trap control characters/signals? |
| 1629 | |
| 1630 | =item How do I modify the shadow password file on a Unix system? |
| 1631 | |
| 1632 | =item How do I set the time and date? |
| 1633 | |
| 1634 | =item How can I sleep() or alarm() for under a second? |
| 1635 | |
| 1636 | =item How can I measure time under a second? |
| 1637 | |
| 1638 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) |
| 1639 | |
| 1640 | =item Why doesn't my sockets program work under System V (Solaris)? What |
| 1641 | does the error message "Protocol not supported" mean? |
| 1642 | |
| 1643 | =item How can I call my system's unique C functions from Perl? |
| 1644 | |
| 1645 | =item Where do I get the include files to do ioctl() or syscall()? |
| 1646 | |
| 1647 | =item Why do setuid perl scripts complain about kernel problems? |
| 1648 | |
| 1649 | =item How can I open a pipe both to and from a command? |
| 1650 | |
| 1651 | =item Why can't I get the output of a command with system()? |
| 1652 | |
| 1653 | =item How can I capture STDERR from an external command? |
| 1654 | |
| 1655 | =item Why doesn't open() return an error when a pipe open fails? |
| 1656 | |
| 1657 | =item What's wrong with using backticks in a void context? |
| 1658 | |
| 1659 | =item How can I call backticks without shell processing? |
| 1660 | |
| 1661 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, |
| 1662 | ^Z on MS-DOS)? |
| 1663 | |
| 1664 | =item How can I convert my shell script to perl? |
| 1665 | |
| 1666 | =item Can I use perl to run a telnet or ftp session? |
| 1667 | |
| 1668 | =item How can I write expect in Perl? |
| 1669 | |
| 1670 | =item Is there a way to hide perl's command line from programs such as |
| 1671 | "ps"? |
| 1672 | |
| 1673 | =item I {changed directory, modified my environment} in a perl script. How |
| 1674 | come the change disappeared when I exited the script? How do I get my |
| 1675 | changes to be visible? |
| 1676 | |
| 1677 | Unix |
| 1678 | |
| 1679 | =item How do I close a process's filehandle without waiting for it to |
| 1680 | complete? |
| 1681 | |
| 1682 | =item How do I fork a daemon process? |
| 1683 | |
| 1684 | =item How do I find out if I'm running interactively or not? |
| 1685 | |
| 1686 | =item How do I timeout a slow event? |
| 1687 | |
| 1688 | =item How do I set CPU limits? |
| 1689 | |
| 1690 | =item How do I avoid zombies on a Unix system? |
| 1691 | |
| 1692 | =item How do I use an SQL database? |
| 1693 | |
| 1694 | =item How do I make a system() exit on control-C? |
| 1695 | |
| 1696 | =item How do I open a file without blocking? |
| 1697 | |
| 1698 | =item How do I tell the difference between errors from the shell and perl? |
| 1699 | |
| 1700 | =item How do I install a module from CPAN? |
| 1701 | |
| 1702 | =item What's the difference between require and use? |
| 1703 | |
| 1704 | =item How do I keep my own module/library directory? |
| 1705 | |
| 1706 | =item How do I add the directory my program lives in to the module/library |
| 1707 | search path? |
| 1708 | |
| 1709 | =item How do I add a directory to my include path (@INC) at runtime? |
| 1710 | |
| 1711 | =item What is socket.ph and where do I get it? |
| 1712 | |
| 1713 | =back |
| 1714 | |
| 1715 | =item AUTHOR AND COPYRIGHT |
| 1716 | |
| 1717 | =back |
| 1718 | |
| 1719 | =head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37 |
| 1720 | $) |
| 1721 | |
| 1722 | =over 4 |
| 1723 | |
| 1724 | =item DESCRIPTION |
| 1725 | |
| 1726 | =over 4 |
| 1727 | |
| 1728 | =item What is the correct form of response from a CGI script? |
| 1729 | |
| 1730 | =item My CGI script runs from the command line but not the browser. (500 |
| 1731 | Server Error) |
| 1732 | |
| 1733 | =item How can I get better error messages from a CGI program? |
| 1734 | |
| 1735 | =item How do I remove HTML from a string? |
| 1736 | |
| 1737 | =item How do I extract URLs? |
| 1738 | |
| 1739 | =item How do I download a file from the user's machine? How do I open a |
| 1740 | file on another machine? |
| 1741 | |
| 1742 | =item How do I make a pop-up menu in HTML? |
| 1743 | |
| 1744 | =item How do I fetch an HTML file? |
| 1745 | |
| 1746 | =item How do I automate an HTML form submission? |
| 1747 | |
| 1748 | =item How do I decode or create those %-encodings on the web? |
| 1749 | |
| 1750 | =item How do I redirect to another page? |
| 1751 | |
| 1752 | =item How do I put a password on my web pages? |
| 1753 | |
| 1754 | =item How do I edit my .htpasswd and .htgroup files with Perl? |
| 1755 | |
| 1756 | =item How do I make sure users can't enter values into a form that cause my |
| 1757 | CGI script to do bad things? |
| 1758 | |
| 1759 | =item How do I parse a mail header? |
| 1760 | |
| 1761 | =item How do I decode a CGI form? |
| 1762 | |
| 1763 | =item How do I check a valid mail address? |
| 1764 | |
| 1765 | =item How do I decode a MIME/BASE64 string? |
| 1766 | |
| 1767 | =item How do I return the user's mail address? |
| 1768 | |
| 1769 | =item How do I send mail? |
| 1770 | |
| 1771 | =item How do I use MIME to make an attachment to a mail message? |
| 1772 | |
| 1773 | =item How do I read mail? |
| 1774 | |
| 1775 | =item How do I find out my hostname, domainname, or IP address? |
| 1776 | X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa, |
| 1777 | gethostbyname, Socket, Net::Domain, Sys::Hostname> |
| 1778 | |
| 1779 | =item How do I fetch a news article or the active newsgroups? |
| 1780 | |
| 1781 | =item How do I fetch/put an FTP file? |
| 1782 | |
| 1783 | =item How can I do RPC in Perl? |
| 1784 | |
| 1785 | =back |
| 1786 | |
| 1787 | =item AUTHOR AND COPYRIGHT |
| 1788 | |
| 1789 | =back |
| 1790 | |
| 1791 | =head2 perlsyn - Perl syntax |
| 1792 | |
| 1793 | =over 4 |
| 1794 | |
| 1795 | =item DESCRIPTION |
| 1796 | |
| 1797 | =over 4 |
| 1798 | |
| 1799 | =item Declarations |
| 1800 | X<declaration> X<undef> X<undefined> X<uninitialized> |
| 1801 | |
| 1802 | =item Comments |
| 1803 | X<comment> X<#> |
| 1804 | |
| 1805 | =item Simple Statements |
| 1806 | X<statement> X<semicolon> X<expression> X<;> |
| 1807 | |
| 1808 | =item Truth and Falsehood |
| 1809 | X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0> |
| 1810 | |
| 1811 | =item Statement Modifiers |
| 1812 | X<statement modifier> X<modifier> X<if> X<unless> X<while> |
| 1813 | X<until> X<foreach> X<for> |
| 1814 | |
| 1815 | =item Compound Statements |
| 1816 | X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace> |
| 1817 | X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue> |
| 1818 | |
| 1819 | =item Loop Control |
| 1820 | X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue> |
| 1821 | |
| 1822 | =item For Loops |
| 1823 | X<for> X<foreach> |
| 1824 | |
| 1825 | =item Foreach Loops |
| 1826 | X<for> X<foreach> |
| 1827 | |
| 1828 | =item Basic BLOCKs and Switch Statements |
| 1829 | X<switch> X<block> X<case> |
| 1830 | |
| 1831 | =item Goto |
| 1832 | X<goto> |
| 1833 | |
| 1834 | =item PODs: Embedded Documentation |
| 1835 | X<POD> X<documentation> |
| 1836 | |
| 1837 | =item Plain Old Comments (Not!) |
| 1838 | X<comment> X<line> X<#> X<preprocessor> X<eval> |
| 1839 | |
| 1840 | =back |
| 1841 | |
| 1842 | =back |
| 1843 | |
| 1844 | =head2 perldata - Perl data types |
| 1845 | |
| 1846 | =over 4 |
| 1847 | |
| 1848 | =item DESCRIPTION |
| 1849 | |
| 1850 | =over 4 |
| 1851 | |
| 1852 | =item Variable names |
| 1853 | X<variable, name> X<variable name> X<data type> X<type> |
| 1854 | |
| 1855 | =item Context |
| 1856 | X<context> X<scalar context> X<list context> |
| 1857 | |
| 1858 | =item Scalar values |
| 1859 | X<scalar> X<number> X<string> X<reference> |
| 1860 | |
| 1861 | =item Scalar value constructors |
| 1862 | X<scalar, literal> X<scalar, constant> |
| 1863 | |
| 1864 | =item List value constructors |
| 1865 | X<list> |
| 1866 | |
| 1867 | =item Subscripts |
| 1868 | |
| 1869 | =item Slices |
| 1870 | X<slice> X<array, slice> X<hash, slice> |
| 1871 | |
| 1872 | =item Typeglobs and Filehandles |
| 1873 | X<typeglob> X<filehandle> X<*> |
| 1874 | |
| 1875 | =back |
| 1876 | |
| 1877 | =item SEE ALSO |
| 1878 | |
| 1879 | =back |
| 1880 | |
| 1881 | =head2 perlop - Perl operators and precedence |
| 1882 | |
| 1883 | =over 4 |
| 1884 | |
| 1885 | =item DESCRIPTION |
| 1886 | |
| 1887 | =over 4 |
| 1888 | |
| 1889 | =item Operator Precedence and Associativity |
| 1890 | X<operator, precedence> X<precedence> X<associativity> |
| 1891 | |
| 1892 | =item Terms and List Operators (Leftward) |
| 1893 | X<list operator> X<operator, list> X<term> |
| 1894 | |
| 1895 | =item The Arrow Operator |
| 1896 | X<arrow> X<dereference> X<< -> >> |
| 1897 | |
| 1898 | =item Auto-increment and Auto-decrement |
| 1899 | X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<--> |
| 1900 | |
| 1901 | =item Exponentiation |
| 1902 | X<**> X<exponentiation> X<power> |
| 1903 | |
| 1904 | =item Symbolic Unary Operators |
| 1905 | X<unary operator> X<operator, unary> |
| 1906 | |
| 1907 | =item Binding Operators |
| 1908 | X<binding> X<operator, binding> X<=~> X<!~> |
| 1909 | |
| 1910 | =item Multiplicative Operators |
| 1911 | X<operator, multiplicative> |
| 1912 | |
| 1913 | =item Additive Operators |
| 1914 | X<operator, additive> |
| 1915 | |
| 1916 | =item Shift Operators |
| 1917 | X<shift operator> X<operator, shift> X<<< << >>> |
| 1918 | X<<< >> >>> X<right shift> X<left shift> X<bitwise shift> |
| 1919 | X<shl> X<shr> X<shift, right> X<shift, left> |
| 1920 | |
| 1921 | =item Named Unary Operators |
| 1922 | X<operator, named unary> |
| 1923 | |
| 1924 | =item Relational Operators |
| 1925 | X<relational operator> X<operator, relational> |
| 1926 | |
| 1927 | =item Equality Operators |
| 1928 | X<equality> X<equal> X<equals> X<operator, equality> |
| 1929 | |
| 1930 | =item Bitwise And |
| 1931 | X<operator, bitwise, and> X<bitwise and> X<&> |
| 1932 | |
| 1933 | =item Bitwise Or and Exclusive Or |
| 1934 | X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor> |
| 1935 | X<bitwise xor> X<^> |
| 1936 | |
| 1937 | =item C-style Logical And |
| 1938 | X<&&> X<logical and> X<operator, logical, and> |
| 1939 | |
| 1940 | =item C-style Logical Or |
| 1941 | X<||> X<operator, logical, or> |
| 1942 | |
| 1943 | =item Range Operators |
| 1944 | X<operator, range> X<range> X<..> X<...> |
| 1945 | |
| 1946 | =item Conditional Operator |
| 1947 | X<operator, conditional> X<operator, ternary> X<ternary> X<?:> |
| 1948 | |
| 1949 | =item Assignment Operators |
| 1950 | X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=> |
| 1951 | X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<.=> |
| 1952 | X<%=> X<^=> X<x=> |
| 1953 | |
| 1954 | =item Comma Operator |
| 1955 | X<comma> X<operator, comma> X<,> |
| 1956 | |
| 1957 | =item List Operators (Rightward) |
| 1958 | X<operator, list, rightward> X<list operator> |
| 1959 | |
| 1960 | =item Logical Not |
| 1961 | X<operator, logical, not> X<not> |
| 1962 | |
| 1963 | =item Logical And |
| 1964 | X<operator, logical, and> X<and> |
| 1965 | |
| 1966 | =item Logical or and Exclusive Or |
| 1967 | X<operator, logical, or> X<operator, logical, xor> X<operator, logical, |
| 1968 | err> |
| 1969 | X<operator, logical, defined or> X<operator, logical, exclusive or> |
| 1970 | X<or> X<xor> X<err> |
| 1971 | |
| 1972 | =item C Operators Missing From Perl |
| 1973 | X<operator, missing from perl> X<&> X<*> |
| 1974 | X<typecasting> X<(TYPE)> |
| 1975 | |
| 1976 | unary &, unary *, (TYPE) |
| 1977 | |
| 1978 | =item Quote and Quote-like Operators |
| 1979 | X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> |
| 1980 | X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>> |
| 1981 | X<escape sequence> X<escape> |
| 1982 | |
| 1983 | =item Regexp Quote-Like Operators |
| 1984 | X<operator, regexp> |
| 1985 | |
| 1986 | ?PATTERN? X<?>, m/PATTERN/cgimosx X<m> X<operator, match> X<regexp, |
| 1987 | options> X<regexp> X<regex, options> X<regex> X</c> X</i> X</m> X</o> |
| 1988 | X</s> X</x>, /PATTERN/cgimosx, q/STRING/ X<q> X<quote, double> X<'> X<''>, |
| 1989 | C<'STRING'>, qq/STRING/ X<qq> X<quote, double> X<"> X<"">, "STRING", |
| 1990 | qr/STRING/imosx X<qr> X</i> X</m> X</o> X</s> X</x>, qx/STRING/ X<qx> X<`> |
| 1991 | X<``> X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote, |
| 1992 | words>, s/PATTERN/REPLACEMENT/egimosx X<substitute> X<substitution> |
| 1993 | X<replace> X<regexp, replace> X<regexp, substitute> X</e> X</g> X</i> X</m> |
| 1994 | X</o> X</s> X</x>, tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y> |
| 1995 | X<transliterate> X</c> X</d> X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF |
| 1996 | X<here-doc> X<heredoc> X<here-document> X<<< << >>> |
| 1997 | |
| 1998 | =item Gory details of parsing quoted constructs |
| 1999 | X<quote, gory details> |
| 2000 | |
| 2001 | Finding the end, Removal of backslashes before delimiters, Interpolation |
| 2002 | X<interpolation>, C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, |
| 2003 | C<q//>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, |
| 2004 | C</RE/>, C<m/RE/>, C<s/RE/foo/>,, Interpolation of regular expressions |
| 2005 | X<regexp, interpolation>, Optimization of regular expressions X<regexp, |
| 2006 | optimization> |
| 2007 | |
| 2008 | =item I/O Operators |
| 2009 | X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle> |
| 2010 | X<< <> >> X<@ARGV> |
| 2011 | |
| 2012 | =item Constant Folding |
| 2013 | X<constant folding> X<folding> |
| 2014 | |
| 2015 | =item No-ops |
| 2016 | X<no-op> X<nop> |
| 2017 | |
| 2018 | =item Bitwise String Operators |
| 2019 | X<operator, bitwise, string> |
| 2020 | |
| 2021 | =item Integer Arithmetic |
| 2022 | X<integer> |
| 2023 | |
| 2024 | =item Floating-point Arithmetic |
| 2025 | X<floating-point> X<floating point> X<float> X<real> |
| 2026 | |
| 2027 | =item Bigger Numbers |
| 2028 | X<number, arbitrary precision> |
| 2029 | |
| 2030 | =back |
| 2031 | |
| 2032 | =back |
| 2033 | |
| 2034 | =head2 perlsub - Perl subroutines |
| 2035 | |
| 2036 | =over 4 |
| 2037 | |
| 2038 | =item SYNOPSIS |
| 2039 | |
| 2040 | =item DESCRIPTION |
| 2041 | |
| 2042 | =over 4 |
| 2043 | |
| 2044 | =item Private Variables via my() |
| 2045 | X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical> |
| 2046 | X<lexical scope> X<attributes, my> |
| 2047 | |
| 2048 | =item Persistent Private Variables |
| 2049 | X<static> X<variable, persistent> X<variable, static> X<closure> |
| 2050 | |
| 2051 | =item Temporary Values via local() |
| 2052 | X<local> X<scope, dynamic> X<dynamic scope> X<variable, local> |
| 2053 | X<variable, temporary> |
| 2054 | |
| 2055 | =item Lvalue subroutines |
| 2056 | X<lvalue> X<subroutine, lvalue> |
| 2057 | |
| 2058 | Lvalue subroutines are EXPERIMENTAL |
| 2059 | |
| 2060 | =item Passing Symbol Table Entries (typeglobs) |
| 2061 | X<typeglob> X<*> |
| 2062 | |
| 2063 | =item When to Still Use local() |
| 2064 | X<local> X<variable, local> |
| 2065 | |
| 2066 | =item Pass by Reference |
| 2067 | X<pass by reference> X<pass-by-reference> X<reference> |
| 2068 | |
| 2069 | =item Prototypes |
| 2070 | X<prototype> X<subroutine, prototype> |
| 2071 | |
| 2072 | =item Constant Functions |
| 2073 | X<constant> |
| 2074 | |
| 2075 | =item Overriding Built-in Functions |
| 2076 | X<built-in> X<override> X<CORE> X<CORE::GLOBAL> |
| 2077 | |
| 2078 | =item Autoloading |
| 2079 | X<autoloading> X<AUTOLOAD> |
| 2080 | |
| 2081 | =item Subroutine Attributes |
| 2082 | X<attribute> X<subroutine, attribute> X<attrs> |
| 2083 | |
| 2084 | =back |
| 2085 | |
| 2086 | =item SEE ALSO |
| 2087 | |
| 2088 | =back |
| 2089 | |
| 2090 | =head2 perlfunc - Perl builtin functions |
| 2091 | |
| 2092 | =over 4 |
| 2093 | |
| 2094 | =item DESCRIPTION |
| 2095 | |
| 2096 | =over 4 |
| 2097 | |
| 2098 | =item Perl Functions by Category |
| 2099 | X<function> |
| 2100 | |
| 2101 | Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular |
| 2102 | expressions and pattern matching X<regular expression> X<regex> X<regexp>, |
| 2103 | Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>, |
| 2104 | Functions for real @ARRAYs X<array>, Functions for list data X<list>, |
| 2105 | Functions for real %HASHes X<hash>, Input and output functions X<I/O> |
| 2106 | X<input> X<output> X<dbm>, Functions for fixed length data or records, |
| 2107 | Functions for filehandles, files, or directories X<file> X<filehandle> |
| 2108 | X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control |
| 2109 | flow of your Perl program X<control flow>, Keywords related to scoping, |
| 2110 | Miscellaneous functions, Functions for processes and process groups |
| 2111 | X<process> X<pid> X<process id>, Keywords related to perl modules |
| 2112 | X<module>, Keywords related to classes and object-orientedness X<object> |
| 2113 | X<class> X<package>, Low-level socket functions X<socket> X<sock>, System V |
| 2114 | interprocess communication functions X<IPC> X<System V> X<semaphore> |
| 2115 | X<shared memory> X<memory> X<message>, Fetching user and group info X<user> |
| 2116 | X<group> X<password> X<uid> X<gid> X<passwd> X</etc/passwd>, Fetching |
| 2117 | network info X<network> X<protocol> X<host> X<hostname> X<IP> X<address> |
| 2118 | X<service>, Time-related functions X<time> X<date>, Functions new in perl5 |
| 2119 | X<perl5>, Functions obsoleted in perl5 |
| 2120 | |
| 2121 | =item Portability |
| 2122 | X<portability> X<Unix> X<portable> |
| 2123 | |
| 2124 | =item Alphabetical Listing of Perl Functions |
| 2125 | |
| 2126 | -I<X> FILEHANDLE |
| 2127 | X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p> |
| 2128 | X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I<X> EXPR, |
| 2129 | -I<X>, abs VALUE X<abs> X<absolute>, abs, accept NEWSOCKET,GENERICSOCKET |
| 2130 | X<accept>, alarm SECONDS X<alarm> X<SIGALRM> X<timer>, alarm, atan2 Y,X |
| 2131 | X<atan2> X<arctangent> X<tan> X<tangent>, bind SOCKET,NAME X<bind>, binmode |
| 2132 | FILEHANDLE, LAYER X<binmode> X<binary> X<text> X<DOS> X<Windows>, binmode |
| 2133 | FILEHANDLE, bless REF,CLASSNAME X<bless>, bless REF, caller EXPR X<caller> |
| 2134 | X<call stack> X<stack> X<stack trace>, caller, chdir EXPR X<chdir> X<cd>, |
| 2135 | chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> |
| 2136 | X<mode>, chomp VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> |
| 2137 | X<eol>, chomp( LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, |
| 2138 | chown LIST X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> |
| 2139 | X<character> X<ASCII> X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, |
| 2140 | chroot, close FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, |
| 2141 | connect SOCKET,NAME X<connect>, continue BLOCK X<continue>, cos EXPR X<cos> |
| 2142 | X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt> |
| 2143 | X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt> |
| 2144 | X<cryptography> X<passwd>, dbmclose HASH X<dbmclose>, dbmopen |
| 2145 | HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR |
| 2146 | X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST |
| 2147 | X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do> |
| 2148 | X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump> |
| 2149 | X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof |
| 2150 | FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR |
| 2151 | X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>, eval BLOCK, eval, |
| 2152 | exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists EXPR X<exists> |
| 2153 | X<autovivification>, exit EXPR X<exit> X<terminate> X<abort>, exit, exp |
| 2154 | EXPR X<exp> X<exponential> X<antilog> X<antilogarithm> X<e>, exp, fcntl |
| 2155 | FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE X<fileno>, flock |
| 2156 | FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork X<fork> X<child> |
| 2157 | X<parent>, format X<format>, formline PICTURE,LIST X<formline>, getc |
| 2158 | FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin> X<login>, |
| 2159 | getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>, |
| 2160 | getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority> |
| 2161 | X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname> |
| 2162 | X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname> |
| 2163 | X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport> |
| 2164 | X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent> |
| 2165 | X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent> |
| 2166 | X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent> |
| 2167 | X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME, gethostbyname |
| 2168 | NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, |
| 2169 | getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr |
| 2170 | ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, |
| 2171 | getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, |
| 2172 | setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, |
| 2173 | setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, |
| 2174 | endprotoent, endservent, getsockname SOCKET X<getsockname>, getsockopt |
| 2175 | SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard> |
| 2176 | X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC> |
| 2177 | X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto |
| 2178 | &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex> |
| 2179 | X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION |
| 2180 | X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer> |
| 2181 | X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join |
| 2182 | EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill> |
| 2183 | X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>, |
| 2184 | lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length> |
| 2185 | X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE |
| 2186 | X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime, |
| 2187 | lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log, |
| 2188 | lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST, |
| 2189 | mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME, |
| 2190 | msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv |
| 2191 | ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR |
| 2192 | X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL |
| 2193 | X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION, |
| 2194 | no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal> |
| 2195 | X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open> |
| 2196 | X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open |
| 2197 | FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR |
| 2198 | X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>, |
| 2199 | our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST |
| 2200 | X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe |
| 2201 | READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR |
| 2202 | X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST, |
| 2203 | print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST, |
| 2204 | prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>, |
| 2205 | q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR |
| 2206 | X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>, |
| 2207 | rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read |
| 2208 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR |
| 2209 | X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe |
| 2210 | EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL |
| 2211 | X<redo>, redo, ref EXPR X<ref> X<reference>, ref, rename OLDNAME,NEWNAME |
| 2212 | X<rename> X<move> X<mv> X<ren>, require VERSION X<require>, require EXPR, |
| 2213 | require, reset EXPR X<reset>, reset, return EXPR X<return>, return, reverse |
| 2214 | LIST X<reverse> X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex |
| 2215 | STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir> |
| 2216 | X<rd> X<directory, remove>, rmdir, s///, scalar EXPR X<scalar> X<context>, |
| 2217 | seek FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>, |
| 2218 | seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle, |
| 2219 | default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl |
| 2220 | ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop |
| 2221 | KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send |
| 2222 | SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority |
| 2223 | WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt |
| 2224 | SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift, |
| 2225 | shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread |
| 2226 | ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE, |
| 2227 | shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin> |
| 2228 | X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket |
| 2229 | SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair |
| 2230 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST |
| 2231 | X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST, |
| 2232 | splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH, |
| 2233 | splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>, |
| 2234 | split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST |
| 2235 | X<sprintf>, format parameter index, flags, vector flag, (minimum) width, |
| 2236 | precision, or maximum width X<precision>, size, order of arguments, sqrt |
| 2237 | EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed> |
| 2238 | X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR, |
| 2239 | stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO) |
| 2240 | BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr |
| 2241 | EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left> |
| 2242 | X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink |
| 2243 | OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>, |
| 2244 | syscall NUMBER, LIST X<syscall> X<system call>, sysopen |
| 2245 | FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen |
| 2246 | FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET |
| 2247 | X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek |
| 2248 | FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system> |
| 2249 | X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET |
| 2250 | X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, |
| 2251 | tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie |
| 2252 | VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time> |
| 2253 | X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>, |
| 2254 | truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst |
| 2255 | EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef |
| 2256 | EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove> |
| 2257 | X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, untie VARIABLE X<untie>, |
| 2258 | unshift ARRAY,LIST X<unshift>, use Module VERSION LIST X<use> X<module> |
| 2259 | X<import>, use Module VERSION, use Module LIST, use Module, use VERSION, |
| 2260 | utime LIST X<utime>, values HASH X<values>, vec EXPR,OFFSET,BITS X<vec> |
| 2261 | X<bit> X<bit vector>, wait X<wait>, waitpid PID,FLAGS X<waitpid>, wantarray |
| 2262 | X<wantarray> X<context>, warn LIST X<warn> X<warning> X<STDERR>, write |
| 2263 | FILEHANDLE X<write>, write EXPR, write, y/// |
| 2264 | |
| 2265 | =back |
| 2266 | |
| 2267 | =back |
| 2268 | |
| 2269 | =head2 perlopentut - tutorial on opening things in Perl |
| 2270 | |
| 2271 | =over 4 |
| 2272 | |
| 2273 | =item DESCRIPTION |
| 2274 | |
| 2275 | =item Open E<agrave> la shell |
| 2276 | |
| 2277 | =over 4 |
| 2278 | |
| 2279 | =item Simple Opens |
| 2280 | |
| 2281 | =item Indirect Filehandles |
| 2282 | |
| 2283 | =item Pipe Opens |
| 2284 | |
| 2285 | =item The Minus File |
| 2286 | |
| 2287 | =item Mixing Reads and Writes |
| 2288 | |
| 2289 | =item Filters |
| 2290 | |
| 2291 | =back |
| 2292 | |
| 2293 | =item Open E<agrave> la C |
| 2294 | |
| 2295 | =over 4 |
| 2296 | |
| 2297 | =item Permissions E<agrave> la mode |
| 2298 | |
| 2299 | =back |
| 2300 | |
| 2301 | =item Obscure Open Tricks |
| 2302 | |
| 2303 | =over 4 |
| 2304 | |
| 2305 | =item Re-Opening Files (dups) |
| 2306 | |
| 2307 | =item Dispelling the Dweomer |
| 2308 | |
| 2309 | =item Paths as Opens |
| 2310 | |
| 2311 | =item Single Argument Open |
| 2312 | |
| 2313 | =item Playing with STDIN and STDOUT |
| 2314 | |
| 2315 | =back |
| 2316 | |
| 2317 | =item Other I/O Issues |
| 2318 | |
| 2319 | =over 4 |
| 2320 | |
| 2321 | =item Opening Non-File Files |
| 2322 | |
| 2323 | =item Opening Named Pipes |
| 2324 | |
| 2325 | =item Opening Sockets |
| 2326 | |
| 2327 | =item Binary Files |
| 2328 | |
| 2329 | =item File Locking |
| 2330 | |
| 2331 | =item IO Layers |
| 2332 | |
| 2333 | =back |
| 2334 | |
| 2335 | =item SEE ALSO |
| 2336 | |
| 2337 | =item AUTHOR and COPYRIGHT |
| 2338 | |
| 2339 | =item HISTORY |
| 2340 | |
| 2341 | =back |
| 2342 | |
| 2343 | =head2 perlpacktut - tutorial on C<pack> and C<unpack> |
| 2344 | |
| 2345 | =over 4 |
| 2346 | |
| 2347 | =item DESCRIPTION |
| 2348 | |
| 2349 | =item The Basic Principle |
| 2350 | |
| 2351 | =item Packing Text |
| 2352 | |
| 2353 | =item Packing Numbers |
| 2354 | |
| 2355 | =over 4 |
| 2356 | |
| 2357 | =item Integers |
| 2358 | |
| 2359 | =item Unpacking a Stack Frame |
| 2360 | |
| 2361 | =item How to Eat an Egg on a Net |
| 2362 | |
| 2363 | =item Floating point Numbers |
| 2364 | |
| 2365 | =back |
| 2366 | |
| 2367 | =item Exotic Templates |
| 2368 | |
| 2369 | =over 4 |
| 2370 | |
| 2371 | =item Bit Strings |
| 2372 | |
| 2373 | =item Uuencoding |
| 2374 | |
| 2375 | =item Doing Sums |
| 2376 | |
| 2377 | =item Unicode |
| 2378 | |
| 2379 | =item Another Portable Binary Encoding |
| 2380 | |
| 2381 | =back |
| 2382 | |
| 2383 | =item Template Grouping |
| 2384 | |
| 2385 | =item Lengths and Widths |
| 2386 | |
| 2387 | =over 4 |
| 2388 | |
| 2389 | =item String Lengths |
| 2390 | |
| 2391 | =item Dynamic Templates |
| 2392 | |
| 2393 | =item Counting Repetitions |
| 2394 | |
| 2395 | =back |
| 2396 | |
| 2397 | =item Packing and Unpacking C Structures |
| 2398 | |
| 2399 | =over 4 |
| 2400 | |
| 2401 | =item The Alignment Pit |
| 2402 | |
| 2403 | =item Alignment, Take 2 |
| 2404 | |
| 2405 | =item Alignment, Take 3 |
| 2406 | |
| 2407 | =item Pointers for How to Use Them |
| 2408 | |
| 2409 | =back |
| 2410 | |
| 2411 | =item Pack Recipes |
| 2412 | |
| 2413 | =item Funnies Section |
| 2414 | |
| 2415 | =item Authors |
| 2416 | |
| 2417 | =back |
| 2418 | |
| 2419 | =head2 perlpod - the Plain Old Documentation format |
| 2420 | |
| 2421 | =over 4 |
| 2422 | |
| 2423 | =item DESCRIPTION |
| 2424 | |
| 2425 | =over 4 |
| 2426 | |
| 2427 | =item Ordinary Paragraph |
| 2428 | X<POD, ordinary paragraph> |
| 2429 | |
| 2430 | =item Verbatim Paragraph |
| 2431 | X<POD, verbatim paragraph> X<verbatim> |
| 2432 | |
| 2433 | =item Command Paragraph |
| 2434 | X<POD, command> |
| 2435 | |
| 2436 | C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1> |
| 2437 | X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading |
| 2438 | Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over> |
| 2439 | X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>, |
| 2440 | C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>> |
| 2441 | X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>, |
| 2442 | C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding> |
| 2443 | X<encoding> |
| 2444 | |
| 2445 | =item Formatting Codes |
| 2446 | X<POD, formatting code> X<formatting code> |
| 2447 | X<POD, interior sequence> X<interior sequence> |
| 2448 | |
| 2449 | C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting |
| 2450 | code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >> |
| 2451 | X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C> |
| 2452 | X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> -- |
| 2453 | a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink> |
| 2454 | X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >> |
| 2455 | X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used |
| 2456 | for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename> |
| 2457 | X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S> |
| 2458 | X<< SZ<><> >> X<POD, formatting code, non-breaking space> X<non-breaking |
| 2459 | space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >> |
| 2460 | X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a |
| 2461 | null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting |
| 2462 | code, null> X<null> |
| 2463 | |
| 2464 | =item The Intent |
| 2465 | X<POD, intent of> |
| 2466 | |
| 2467 | =item Embedding Pods in Perl Modules |
| 2468 | X<POD, embedding> |
| 2469 | |
| 2470 | =item Hints for Writing Pod |
| 2471 | |
| 2472 | X<podchecker> X<POD, validating> |
| 2473 | |
| 2474 | =back |
| 2475 | |
| 2476 | =item SEE ALSO |
| 2477 | |
| 2478 | =item AUTHOR |
| 2479 | |
| 2480 | =back |
| 2481 | |
| 2482 | =head2 perlpodspec - Plain Old Documentation: format specification and |
| 2483 | notes |
| 2484 | |
| 2485 | =over 4 |
| 2486 | |
| 2487 | =item DESCRIPTION |
| 2488 | |
| 2489 | =item Pod Definitions |
| 2490 | |
| 2491 | =item Pod Commands |
| 2492 | |
| 2493 | "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", |
| 2494 | "=back", "=begin formatname", "=end formatname", "=for formatname text...", |
| 2495 | "=encoding encodingname" |
| 2496 | |
| 2497 | =item Pod Formatting Codes |
| 2498 | |
| 2499 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, |
| 2500 | C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for |
| 2501 | filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a |
| 2502 | null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, |
| 2503 | C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text |
| 2504 | contains non-breaking spaces |
| 2505 | |
| 2506 | =item Notes on Implementing Pod Processors |
| 2507 | |
| 2508 | =item About LE<lt>...E<gt> Codes |
| 2509 | |
| 2510 | First:, Second:, Third:, Fourth:, Fifth:, Sixth: |
| 2511 | |
| 2512 | =item About =over...=back Regions |
| 2513 | |
| 2514 | =item About Data Paragraphs and "=begin/=end" Regions |
| 2515 | |
| 2516 | =item SEE ALSO |
| 2517 | |
| 2518 | =item AUTHOR |
| 2519 | |
| 2520 | =back |
| 2521 | |
| 2522 | =head2 perlrun - how to execute the Perl interpreter |
| 2523 | |
| 2524 | =over 4 |
| 2525 | |
| 2526 | =item SYNOPSIS |
| 2527 | |
| 2528 | =item DESCRIPTION |
| 2529 | |
| 2530 | =over 4 |
| 2531 | |
| 2532 | =item #! and quoting on non-Unix systems |
| 2533 | X<hashbang> X<#!> |
| 2534 | |
| 2535 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS |
| 2536 | |
| 2537 | =item Location of Perl |
| 2538 | X<perl, location of interpreter> |
| 2539 | |
| 2540 | =item Command Switches |
| 2541 | X<perl, command switches> X<command switches> |
| 2542 | |
| 2543 | B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C |
| 2544 | [I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>, |
| 2545 | B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>, |
| 2546 | B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e> |
| 2547 | I<commandline> X<-e>, B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, |
| 2548 | B<-i>[I<extension>] X<-i> X<in-place>, B<-I>I<directory> X<-I> X<@INC>, |
| 2549 | B<-l>[I<octnum>] X<-l> X<$/> X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, |
| 2550 | B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, |
| 2551 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n> X<-n>, B<-p> X<-p>, B<-P> |
| 2552 | X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>, B<-T> X<-T>, B<-u> X<-u>, |
| 2553 | B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>, B<-V:>I<configvar>, B<-w> X<-w>, |
| 2554 | B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>, B<-x> I<directory> |
| 2555 | |
| 2556 | =back |
| 2557 | |
| 2558 | =item ENVIRONMENT |
| 2559 | X<perl, environment variables> |
| 2560 | |
| 2561 | HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>, |
| 2562 | PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>, |
| 2563 | :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio |
| 2564 | X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG |
| 2565 | X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED |
| 2566 | X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>, |
| 2567 | PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port) |
| 2568 | X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>, |
| 2569 | PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY |
| 2570 | X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED |
| 2571 | X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT |
| 2572 | (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>, |
| 2573 | PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port) |
| 2574 | X<SYS$LOGIN> |
| 2575 | |
| 2576 | =back |
| 2577 | |
| 2578 | =head2 perldiag - various Perl diagnostics |
| 2579 | |
| 2580 | =over 4 |
| 2581 | |
| 2582 | =item DESCRIPTION |
| 2583 | |
| 2584 | =back |
| 2585 | |
| 2586 | =head2 perllexwarn - Perl Lexical Warnings |
| 2587 | |
| 2588 | =over 4 |
| 2589 | |
| 2590 | =item DESCRIPTION |
| 2591 | |
| 2592 | =over 4 |
| 2593 | |
| 2594 | =item Default Warnings and Optional Warnings |
| 2595 | |
| 2596 | =item What's wrong with B<-w> and C<$^W> |
| 2597 | |
| 2598 | =item Controlling Warnings from the Command Line |
| 2599 | |
| 2600 | B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X> |
| 2601 | |
| 2602 | =item Backward Compatibility |
| 2603 | |
| 2604 | =item Category Hierarchy |
| 2605 | X<warning, categories> |
| 2606 | |
| 2607 | =item Fatal Warnings |
| 2608 | X<warning, fatal> |
| 2609 | |
| 2610 | =item Reporting Warnings from a Module |
| 2611 | X<warning, reporting> X<warning, registering> |
| 2612 | |
| 2613 | =back |
| 2614 | |
| 2615 | =item TODO |
| 2616 | |
| 2617 | =item SEE ALSO |
| 2618 | |
| 2619 | =item AUTHOR |
| 2620 | |
| 2621 | =back |
| 2622 | |
| 2623 | =head2 perldebug - Perl debugging |
| 2624 | |
| 2625 | =over 4 |
| 2626 | |
| 2627 | =item DESCRIPTION |
| 2628 | |
| 2629 | =item The Perl Debugger |
| 2630 | |
| 2631 | =over 4 |
| 2632 | |
| 2633 | =item Debugger Commands |
| 2634 | |
| 2635 | h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>, |
| 2636 | x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger |
| 2637 | command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger |
| 2638 | command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s |
| 2639 | [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r |
| 2640 | X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l |
| 2641 | X<debugger command, l>, l min+incr, l min-max, l line, l subname, - |
| 2642 | X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger |
| 2643 | command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L |
| 2644 | [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t |
| 2645 | X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint> |
| 2646 | X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger |
| 2647 | command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b |
| 2648 | postpone subname [condition] X<breakpoint> X<debugger command, b>, b load |
| 2649 | filename X<breakpoint> X<debugger command, b>, b compile subname |
| 2650 | X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger |
| 2651 | command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command |
| 2652 | X<debugger command, a>, A line X<debugger command, A>, A * X<debugger |
| 2653 | command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>, |
| 2654 | W * X<debugger command, W>, o X<debugger command, o>, o booloption ... |
| 2655 | X<debugger command, o>, o anyoption? ... X<debugger command, o>, o |
| 2656 | option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, < |
| 2657 | [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, << |
| 2658 | command X<< debugger command, << >>, > ? X<< debugger command, > >>, > |
| 2659 | command X<< debugger command, > >>, > * X<< debugger command, > >>, >> |
| 2660 | command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [ |
| 2661 | command ], { * X<debugger command, {>, {{ command X<debugger command, {{>, |
| 2662 | ! number X<debugger command, !>, ! -number X<debugger command, !>, ! |
| 2663 | pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file |
| 2664 | X<debugger command, source>, H -number X<debugger command, H>, q or ^D |
| 2665 | X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>, |
| 2666 | |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m |
| 2667 | expr X<debugger command, m>, M X<debugger command, M>, man [manpage] |
| 2668 | X<debugger command, man> |
| 2669 | |
| 2670 | =item Configurable Options |
| 2671 | |
| 2672 | C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger |
| 2673 | option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning> |
| 2674 | X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel> |
| 2675 | X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger |
| 2676 | option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo> |
| 2677 | X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option, |
| 2678 | inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments> |
| 2679 | X<debugger option, ornaments>, C<frame> X<debugger option, frame>, |
| 2680 | C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger |
| 2681 | option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option, |
| 2682 | arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option, |
| 2683 | dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump> |
| 2684 | X<debugger option, veryCompact>, C<globPrint> X<debugger option, |
| 2685 | globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages> |
| 2686 | X<debugger option, DumpPackages>, C<DumpReused> X<debugger option, |
| 2687 | DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote> |
| 2688 | X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly> |
| 2689 | X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY> |
| 2690 | X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>, |
| 2691 | C<NonStop> X<debugger option, NonStop> |
| 2692 | |
| 2693 | =item Debugger input/output |
| 2694 | |
| 2695 | Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack, |
| 2696 | backtrace>, Line Listing Format, Frame listing |
| 2697 | |
| 2698 | =item Debugging compile-time statements |
| 2699 | |
| 2700 | =item Debugger Customization |
| 2701 | |
| 2702 | =item Readline Support |
| 2703 | |
| 2704 | =item Editor Support for Debugging |
| 2705 | |
| 2706 | =item The Perl Profiler |
| 2707 | X<profile> X<profiling> X<profiler> |
| 2708 | |
| 2709 | =back |
| 2710 | |
| 2711 | =item Debugging regular expressions |
| 2712 | X<regular expression, debugging> |
| 2713 | X<regex, debugging> X<regexp, debugging> |
| 2714 | |
| 2715 | =item Debugging memory usage |
| 2716 | X<memory usage> |
| 2717 | |
| 2718 | =item SEE ALSO |
| 2719 | |
| 2720 | =item BUGS |
| 2721 | |
| 2722 | =back |
| 2723 | |
| 2724 | =head2 perlvar - Perl predefined variables |
| 2725 | |
| 2726 | =over 4 |
| 2727 | |
| 2728 | =item DESCRIPTION |
| 2729 | |
| 2730 | =over 4 |
| 2731 | |
| 2732 | =item Predefined Names |
| 2733 | |
| 2734 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
| 2735 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $*, |
| 2736 | HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, |
| 2737 | IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, |
| 2738 | HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, |
| 2739 | IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, |
| 2740 | IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, |
| 2741 | $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#, |
| 2742 | HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, |
| 2743 | HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, |
| 2744 | HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, |
| 2745 | @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as |
| 2746 | C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, |
| 2747 | $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> |
| 2748 | is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as |
| 2749 | C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), |
| 2750 | $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, |
| 2751 | IO::Handle->format_line_break_characters EXPR, |
| 2752 | $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, |
| 2753 | $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, |
| 2754 | $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, |
| 2755 | $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, |
| 2756 | $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), |
| 2757 | $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, |
| 2758 | $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, |
| 2759 | ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, |
| 2760 | 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, |
| 2761 | $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, |
| 2762 | ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, |
| 2763 | $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, |
| 2764 | %ENV, $ENV{expr}, %SIG, $SIG{expr} |
| 2765 | |
| 2766 | =item Error Indicators |
| 2767 | |
| 2768 | =item Technical Note on the Syntax of Variable Names |
| 2769 | |
| 2770 | =back |
| 2771 | |
| 2772 | =item BUGS |
| 2773 | |
| 2774 | =back |
| 2775 | |
| 2776 | =head2 perlre - Perl regular expressions |
| 2777 | |
| 2778 | =over 4 |
| 2779 | |
| 2780 | =item DESCRIPTION |
| 2781 | |
| 2782 | i X</i> X<regex, case-insensitive> X<regexp, case-insensitive> X<regular |
| 2783 | expression, case-insensitive>, m X</m> X<regex, multiline> X<regexp, |
| 2784 | multiline> X<regular expression, multiline>, s X</s> X<regex, single-line> |
| 2785 | X<regexp, single-line> X<regular expression, single-line>, x X</x> |
| 2786 | |
| 2787 | =over 4 |
| 2788 | |
| 2789 | =item Regular Expressions |
| 2790 | |
| 2791 | [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct |
| 2792 | X<punct>, xdigit X<xdigit> |
| 2793 | |
| 2794 | =item Extended Patterns |
| 2795 | |
| 2796 | C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>, |
| 2797 | C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X<look-ahead, positive> |
| 2798 | X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead, negative> |
| 2799 | X<lookahead, negative>, C<(?<=pattern)> X<(?<=)> X<look-behind, positive> |
| 2800 | X<lookbehind, positive>, C<(?<!pattern)> X<(?<!)> X<look-behind, negative> |
| 2801 | X<lookbehind, negative>, C<(?{ code })> X<(?{})> X<regex, code in> |
| 2802 | X<regexp, code in> X<regular expression, code in>, C<(??{ code })> |
| 2803 | X<(??{})> X<regex, postponed> X<regexp, postponed> X<regular expression, |
| 2804 | postponed> X<regex, recursive> X<regexp, recursive> X<regular expression, |
| 2805 | recursive>, C<< (?>pattern) >> X<backtrack> X<backtracking>, |
| 2806 | C<(?(condition)yes-pattern|no-pattern)> X<(?()>, |
| 2807 | C<(?(condition)yes-pattern)> |
| 2808 | |
| 2809 | =item Backtracking |
| 2810 | X<backtrack> X<backtracking> |
| 2811 | |
| 2812 | =item Version 8 Regular Expressions |
| 2813 | X<regular expression, version 8> X<regex, version 8> X<regexp, version 8> |
| 2814 | |
| 2815 | =item Warning on \1 vs $1 |
| 2816 | |
| 2817 | =item Repeated patterns matching zero-length substring |
| 2818 | |
| 2819 | =item Combining pieces together |
| 2820 | |
| 2821 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, |
| 2822 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, |
| 2823 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, |
| 2824 | C<(?(condition)yes-pattern|no-pattern)> |
| 2825 | |
| 2826 | =item Creating custom RE engines |
| 2827 | |
| 2828 | =back |
| 2829 | |
| 2830 | =item BUGS |
| 2831 | |
| 2832 | =item SEE ALSO |
| 2833 | |
| 2834 | =back |
| 2835 | |
| 2836 | =head2 perlreref - Perl Regular Expressions Reference |
| 2837 | |
| 2838 | =over 4 |
| 2839 | |
| 2840 | =item DESCRIPTION |
| 2841 | |
| 2842 | =over 4 |
| 2843 | |
| 2844 | =item OPERATORS |
| 2845 | |
| 2846 | =item SYNTAX |
| 2847 | |
| 2848 | =item ESCAPE SEQUENCES |
| 2849 | |
| 2850 | =item CHARACTER CLASSES |
| 2851 | |
| 2852 | =item ANCHORS |
| 2853 | |
| 2854 | =item QUANTIFIERS |
| 2855 | |
| 2856 | =item EXTENDED CONSTRUCTS |
| 2857 | |
| 2858 | =item VARIABLES |
| 2859 | |
| 2860 | =item FUNCTIONS |
| 2861 | |
| 2862 | =item TERMINOLOGY |
| 2863 | |
| 2864 | =back |
| 2865 | |
| 2866 | =item AUTHOR |
| 2867 | |
| 2868 | =item SEE ALSO |
| 2869 | |
| 2870 | =item THANKS |
| 2871 | |
| 2872 | =back |
| 2873 | |
| 2874 | =head2 perlref - Perl references and nested data structures |
| 2875 | |
| 2876 | =over 4 |
| 2877 | |
| 2878 | =item NOTE |
| 2879 | |
| 2880 | =item DESCRIPTION |
| 2881 | |
| 2882 | =over 4 |
| 2883 | |
| 2884 | =item Making References |
| 2885 | X<reference, creation> X<referencing> |
| 2886 | |
| 2887 | 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket> |
| 2888 | X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3. |
| 2889 | X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace> |
| 2890 | X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine, |
| 2891 | anonymous> X<subroutine, reference> X<reference, subroutine> X<scope, |
| 2892 | lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>, |
| 2893 | 6. X<autovivification>, 7. X<*foo{THING}> X<*> |
| 2894 | |
| 2895 | =item Using References |
| 2896 | X<reference, use> X<dereferencing> X<dereference> |
| 2897 | |
| 2898 | 2. X<${}> X<@{}> X<%{}>, 3. X<autovivification> X<< -> >> X<arrow>, 4. |
| 2899 | X<encapsulation> |
| 2900 | |
| 2901 | =item Symbolic references |
| 2902 | X<reference, symbolic> X<reference, soft> |
| 2903 | X<symbolic reference> X<soft reference> |
| 2904 | |
| 2905 | =item Not-so-symbolic references |
| 2906 | |
| 2907 | =item Pseudo-hashes: Using an array as a hash |
| 2908 | X<pseudo-hash> X<pseudo hash> X<pseudohash> |
| 2909 | |
| 2910 | =item Function Templates |
| 2911 | X<scope, lexical> X<closure> X<lexical> X<lexical scope> |
| 2912 | X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local> |
| 2913 | |
| 2914 | =back |
| 2915 | |
| 2916 | =item WARNING |
| 2917 | X<reference, string context> X<reference, use as hash key> |
| 2918 | |
| 2919 | =item SEE ALSO |
| 2920 | |
| 2921 | =back |
| 2922 | |
| 2923 | =head2 perlform - Perl formats |
| 2924 | |
| 2925 | =over 4 |
| 2926 | |
| 2927 | =item DESCRIPTION |
| 2928 | |
| 2929 | =over 4 |
| 2930 | |
| 2931 | =item Text Fields |
| 2932 | X<format, text field> |
| 2933 | |
| 2934 | =item Numeric Fields |
| 2935 | X<#> X<format, numeric field> |
| 2936 | |
| 2937 | =item The Field @* for Variable Width Multi-Line Text |
| 2938 | X<@*> |
| 2939 | |
| 2940 | =item The Field ^* for Variable Width One-line-at-a-time Text |
| 2941 | X<^*> |
| 2942 | |
| 2943 | =item Specifying Values |
| 2944 | X<format, specifying values> |
| 2945 | |
| 2946 | =item Using Fill Mode |
| 2947 | X<format, fill mode> |
| 2948 | |
| 2949 | =item Suppressing Lines Where All Fields Are Void |
| 2950 | X<format, suppressing lines> |
| 2951 | |
| 2952 | =item Repeating Format Lines |
| 2953 | X<format, repeating lines> |
| 2954 | |
| 2955 | =item Top of Form Processing |
| 2956 | X<format, top of form> X<top> X<header> |
| 2957 | |
| 2958 | =item Format Variables |
| 2959 | X<format variables> |
| 2960 | X<format, variables> |
| 2961 | |
| 2962 | =back |
| 2963 | |
| 2964 | =item NOTES |
| 2965 | |
| 2966 | =over 4 |
| 2967 | |
| 2968 | =item Footers |
| 2969 | X<format, footer> X<footer> |
| 2970 | |
| 2971 | =item Accessing Formatting Internals |
| 2972 | X<format, internals> |
| 2973 | |
| 2974 | =back |
| 2975 | |
| 2976 | =item WARNINGS |
| 2977 | |
| 2978 | =back |
| 2979 | |
| 2980 | =head2 perlobj - Perl objects |
| 2981 | |
| 2982 | =over 4 |
| 2983 | |
| 2984 | =item DESCRIPTION |
| 2985 | |
| 2986 | =over 4 |
| 2987 | |
| 2988 | =item An Object is Simply a Reference |
| 2989 | X<object> X<bless> X<constructor> X<new> |
| 2990 | |
| 2991 | =item A Class is Simply a Package |
| 2992 | X<class> X<package> X<@ISA> X<inheritance> |
| 2993 | |
| 2994 | =item A Method is Simply a Subroutine |
| 2995 | X<method> |
| 2996 | |
| 2997 | =item Method Invocation |
| 2998 | X<invocation> X<method> X<arrow> X<< -> >> |
| 2999 | |
| 3000 | =item Indirect Object Syntax |
| 3001 | X<indirect object syntax> X<invocation, indirect> X<indirect> |
| 3002 | |
| 3003 | =item Default UNIVERSAL methods |
| 3004 | X<UNIVERSAL> |
| 3005 | |
| 3006 | isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION> |
| 3007 | |
| 3008 | =item Destructors |
| 3009 | X<destructor> X<DESTROY> |
| 3010 | |
| 3011 | =item Summary |
| 3012 | |
| 3013 | =item Two-Phased Garbage Collection |
| 3014 | X<garbage collection> X<GC> X<circular reference> |
| 3015 | X<reference, circular> X<DESTROY> X<destructor> |
| 3016 | |
| 3017 | =back |
| 3018 | |
| 3019 | =item SEE ALSO |
| 3020 | |
| 3021 | =back |
| 3022 | |
| 3023 | =head2 perltie - how to hide an object class in a simple variable |
| 3024 | |
| 3025 | =over 4 |
| 3026 | |
| 3027 | =item SYNOPSIS |
| 3028 | |
| 3029 | =item DESCRIPTION |
| 3030 | |
| 3031 | =over 4 |
| 3032 | |
| 3033 | =item Tying Scalars |
| 3034 | X<scalar, tying> |
| 3035 | |
| 3036 | TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this, |
| 3037 | value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY> |
| 3038 | |
| 3039 | =item Tying Arrays |
| 3040 | X<array, tying> |
| 3041 | |
| 3042 | TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE |
| 3043 | this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this, |
| 3044 | count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key |
| 3045 | X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST |
| 3046 | X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST |
| 3047 | X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this |
| 3048 | X<UNTIE>, DESTROY this X<DESTROY> |
| 3049 | |
| 3050 | =item Tying Hashes |
| 3051 | X<hash, tying> |
| 3052 | |
| 3053 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this, |
| 3054 | key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>, |
| 3055 | CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>, |
| 3056 | NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this |
| 3057 | X<UNTIE>, DESTROY this X<DESTROY> |
| 3058 | |
| 3059 | =item Tying FileHandles |
| 3060 | X<filehandle, tying> |
| 3061 | |
| 3062 | TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT |
| 3063 | this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>, |
| 3064 | READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE |
| 3065 | this X<UNTIE>, DESTROY this X<DESTROY> |
| 3066 | |
| 3067 | =item UNTIE this |
| 3068 | X<UNTIE> |
| 3069 | |
| 3070 | =item The C<untie> Gotcha |
| 3071 | X<untie> |
| 3072 | |
| 3073 | =back |
| 3074 | |
| 3075 | =item SEE ALSO |
| 3076 | |
| 3077 | =item BUGS |
| 3078 | |
| 3079 | =item AUTHOR |
| 3080 | |
| 3081 | =back |
| 3082 | |
| 3083 | =head2 perldbmfilter - Perl DBM Filters |
| 3084 | |
| 3085 | =over 4 |
| 3086 | |
| 3087 | =item SYNOPSIS |
| 3088 | |
| 3089 | =item DESCRIPTION |
| 3090 | |
| 3091 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
| 3092 | B<filter_fetch_value> |
| 3093 | |
| 3094 | =over 4 |
| 3095 | |
| 3096 | =item The Filter |
| 3097 | |
| 3098 | =item An Example -- the NULL termination problem. |
| 3099 | |
| 3100 | =item Another Example -- Key is a C int. |
| 3101 | |
| 3102 | =back |
| 3103 | |
| 3104 | =item SEE ALSO |
| 3105 | |
| 3106 | =item AUTHOR |
| 3107 | |
| 3108 | =back |
| 3109 | |
| 3110 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
| 3111 | safe subprocesses, sockets, and semaphores) |
| 3112 | |
| 3113 | =over 4 |
| 3114 | |
| 3115 | =item DESCRIPTION |
| 3116 | |
| 3117 | =item Signals |
| 3118 | |
| 3119 | =over 4 |
| 3120 | |
| 3121 | =item Handling the SIGHUP Signal in Daemons |
| 3122 | |
| 3123 | =back |
| 3124 | |
| 3125 | =item Named Pipes |
| 3126 | |
| 3127 | =over 4 |
| 3128 | |
| 3129 | =item Deferred Signals (Safe Signals) |
| 3130 | |
| 3131 | Long running opcodes, Interrupting IO, Restartable system calls, Signals as |
| 3132 | "faults", Signals triggered by operating system state |
| 3133 | |
| 3134 | =back |
| 3135 | |
| 3136 | =item Using open() for IPC |
| 3137 | |
| 3138 | =over 4 |
| 3139 | |
| 3140 | =item Filehandles |
| 3141 | |
| 3142 | =item Background Processes |
| 3143 | |
| 3144 | =item Complete Dissociation of Child from Parent |
| 3145 | |
| 3146 | =item Safe Pipe Opens |
| 3147 | |
| 3148 | =item Bidirectional Communication with Another Process |
| 3149 | |
| 3150 | =item Bidirectional Communication with Yourself |
| 3151 | |
| 3152 | =back |
| 3153 | |
| 3154 | =item Sockets: Client/Server Communication |
| 3155 | |
| 3156 | =over 4 |
| 3157 | |
| 3158 | =item Internet Line Terminators |
| 3159 | |
| 3160 | =item Internet TCP Clients and Servers |
| 3161 | |
| 3162 | =item Unix-Domain TCP Clients and Servers |
| 3163 | |
| 3164 | =back |
| 3165 | |
| 3166 | =item TCP Clients with IO::Socket |
| 3167 | |
| 3168 | =over 4 |
| 3169 | |
| 3170 | =item A Simple Client |
| 3171 | |
| 3172 | C<Proto>, C<PeerAddr>, C<PeerPort> |
| 3173 | |
| 3174 | =item A Webget Client |
| 3175 | |
| 3176 | =item Interactive Client with IO::Socket |
| 3177 | |
| 3178 | =back |
| 3179 | |
| 3180 | =item TCP Servers with IO::Socket |
| 3181 | |
| 3182 | Proto, LocalPort, Listen, Reuse |
| 3183 | |
| 3184 | =item UDP: Message Passing |
| 3185 | |
| 3186 | =item SysV IPC |
| 3187 | |
| 3188 | =item NOTES |
| 3189 | |
| 3190 | =item BUGS |
| 3191 | |
| 3192 | =item AUTHOR |
| 3193 | |
| 3194 | =item SEE ALSO |
| 3195 | |
| 3196 | =back |
| 3197 | |
| 3198 | =head2 perlfork - Perl's fork() emulation |
| 3199 | |
| 3200 | =over 4 |
| 3201 | |
| 3202 | =item SYNOPSIS |
| 3203 | |
| 3204 | =item DESCRIPTION |
| 3205 | |
| 3206 | =over 4 |
| 3207 | |
| 3208 | =item Behavior of other Perl features in forked pseudo-processes |
| 3209 | |
| 3210 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
| 3211 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to |
| 3212 | files, directories and network sockets |
| 3213 | |
| 3214 | =item Resource limits |
| 3215 | |
| 3216 | =item Killing the parent process |
| 3217 | |
| 3218 | =item Lifetime of the parent process and pseudo-processes |
| 3219 | |
| 3220 | =item CAVEATS AND LIMITATIONS |
| 3221 | |
| 3222 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
| 3223 | Global state maintained by XSUBs, Interpreter embedded in larger |
| 3224 | application, Thread-safety of extensions |
| 3225 | |
| 3226 | =back |
| 3227 | |
| 3228 | =item BUGS |
| 3229 | |
| 3230 | =item AUTHOR |
| 3231 | |
| 3232 | =item SEE ALSO |
| 3233 | |
| 3234 | =back |
| 3235 | |
| 3236 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
| 3237 | |
| 3238 | =over 4 |
| 3239 | |
| 3240 | =item SYNOPSIS |
| 3241 | |
| 3242 | =item DESCRIPTION |
| 3243 | |
| 3244 | =item Storing numbers |
| 3245 | |
| 3246 | =item Numeric operators and numeric conversions |
| 3247 | |
| 3248 | =item Flavors of Perl numeric operations |
| 3249 | |
| 3250 | Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other |
| 3251 | mathematical operators, Bitwise operators, Bitwise operators during C<use |
| 3252 | integer>, Operators which expect an integer, Operators which expect a |
| 3253 | string |
| 3254 | |
| 3255 | =item AUTHOR |
| 3256 | |
| 3257 | =item SEE ALSO |
| 3258 | |
| 3259 | =back |
| 3260 | |
| 3261 | =head2 perlthrtut - tutorial on threads in Perl |
| 3262 | |
| 3263 | =over 4 |
| 3264 | |
| 3265 | =item DESCRIPTION |
| 3266 | |
| 3267 | =item Status |
| 3268 | |
| 3269 | =item What Is A Thread Anyway? |
| 3270 | |
| 3271 | =item Threaded Program Models |
| 3272 | |
| 3273 | =over 4 |
| 3274 | |
| 3275 | =item Boss/Worker |
| 3276 | |
| 3277 | =item Work Crew |
| 3278 | |
| 3279 | =item Pipeline |
| 3280 | |
| 3281 | =back |
| 3282 | |
| 3283 | =item What kind of threads are Perl threads? |
| 3284 | |
| 3285 | =item Thread-Safe Modules |
| 3286 | |
| 3287 | =item Thread Basics |
| 3288 | |
| 3289 | =over 4 |
| 3290 | |
| 3291 | =item Basic Thread Support |
| 3292 | |
| 3293 | =item A Note about the Examples |
| 3294 | |
| 3295 | =item Creating Threads |
| 3296 | |
| 3297 | =item Waiting For A Thread To Exit |
| 3298 | |
| 3299 | =item Ignoring A Thread |
| 3300 | |
| 3301 | =back |
| 3302 | |
| 3303 | =item Threads And Data |
| 3304 | |
| 3305 | =over 4 |
| 3306 | |
| 3307 | =item Shared And Unshared Data |
| 3308 | |
| 3309 | =item Thread Pitfalls: Races |
| 3310 | |
| 3311 | =back |
| 3312 | |
| 3313 | =item Synchronization and control |
| 3314 | |
| 3315 | =over 4 |
| 3316 | |
| 3317 | =item Controlling access: lock() |
| 3318 | |
| 3319 | =item A Thread Pitfall: Deadlocks |
| 3320 | |
| 3321 | =item Queues: Passing Data Around |
| 3322 | |
| 3323 | =item Semaphores: Synchronizing Data Access |
| 3324 | |
| 3325 | =item Basic semaphores |
| 3326 | |
| 3327 | =item Advanced Semaphores |
| 3328 | |
| 3329 | =item cond_wait() and cond_signal() |
| 3330 | |
| 3331 | =item Giving up control |
| 3332 | |
| 3333 | =back |
| 3334 | |
| 3335 | =item General Thread Utility Routines |
| 3336 | |
| 3337 | =over 4 |
| 3338 | |
| 3339 | =item What Thread Am I In? |
| 3340 | |
| 3341 | =item Thread IDs |
| 3342 | |
| 3343 | =item Are These Threads The Same? |
| 3344 | |
| 3345 | =item What Threads Are Running? |
| 3346 | |
| 3347 | =back |
| 3348 | |
| 3349 | =item A Complete Example |
| 3350 | |
| 3351 | =item Different implementations of threads |
| 3352 | |
| 3353 | =item Performance considerations |
| 3354 | |
| 3355 | =item Process-scope Changes |
| 3356 | |
| 3357 | =item Thread-Safety of System Libraries |
| 3358 | |
| 3359 | =item Conclusion |
| 3360 | |
| 3361 | =item Bibliography |
| 3362 | |
| 3363 | =over 4 |
| 3364 | |
| 3365 | =item Introductory Texts |
| 3366 | |
| 3367 | =item OS-Related References |
| 3368 | |
| 3369 | =item Other References |
| 3370 | |
| 3371 | =back |
| 3372 | |
| 3373 | =item Acknowledgements |
| 3374 | |
| 3375 | =item AUTHOR |
| 3376 | |
| 3377 | =item Copyrights |
| 3378 | |
| 3379 | =back |
| 3380 | |
| 3381 | =head2 perlothrtut - old tutorial on threads in Perl |
| 3382 | |
| 3383 | =over 4 |
| 3384 | |
| 3385 | =item DESCRIPTION |
| 3386 | |
| 3387 | =item What Is A Thread Anyway? |
| 3388 | |
| 3389 | =item Threaded Program Models |
| 3390 | |
| 3391 | =over 4 |
| 3392 | |
| 3393 | =item Boss/Worker |
| 3394 | |
| 3395 | =item Work Crew |
| 3396 | |
| 3397 | =item Pipeline |
| 3398 | |
| 3399 | =back |
| 3400 | |
| 3401 | =item Native threads |
| 3402 | |
| 3403 | =item What kind of threads are perl threads? |
| 3404 | |
| 3405 | =item Threadsafe Modules |
| 3406 | |
| 3407 | =item Thread Basics |
| 3408 | |
| 3409 | =over 4 |
| 3410 | |
| 3411 | =item Basic Thread Support |
| 3412 | |
| 3413 | =item Creating Threads |
| 3414 | |
| 3415 | =item Giving up control |
| 3416 | |
| 3417 | =item Waiting For A Thread To Exit |
| 3418 | |
| 3419 | =item Errors In Threads |
| 3420 | |
| 3421 | =item Ignoring A Thread |
| 3422 | |
| 3423 | =back |
| 3424 | |
| 3425 | =item Threads And Data |
| 3426 | |
| 3427 | =over 4 |
| 3428 | |
| 3429 | =item Shared And Unshared Data |
| 3430 | |
| 3431 | =item Thread Pitfall: Races |
| 3432 | |
| 3433 | =item Controlling access: lock() |
| 3434 | |
| 3435 | =item Thread Pitfall: Deadlocks |
| 3436 | |
| 3437 | =item Queues: Passing Data Around |
| 3438 | |
| 3439 | =back |
| 3440 | |
| 3441 | =item Threads And Code |
| 3442 | |
| 3443 | =over 4 |
| 3444 | |
| 3445 | =item Semaphores: Synchronizing Data Access |
| 3446 | |
| 3447 | Basic semaphores, Advanced Semaphores |
| 3448 | |
| 3449 | =item Attributes: Restricting Access To Subroutines |
| 3450 | |
| 3451 | =item Subroutine Locks |
| 3452 | |
| 3453 | =item Methods |
| 3454 | |
| 3455 | =item Locking A Subroutine |
| 3456 | |
| 3457 | =back |
| 3458 | |
| 3459 | =item General Thread Utility Routines |
| 3460 | |
| 3461 | =over 4 |
| 3462 | |
| 3463 | =item What Thread Am I In? |
| 3464 | |
| 3465 | =item Thread IDs |
| 3466 | |
| 3467 | =item Are These Threads The Same? |
| 3468 | |
| 3469 | =item What Threads Are Running? |
| 3470 | |
| 3471 | =back |
| 3472 | |
| 3473 | =item A Complete Example |
| 3474 | |
| 3475 | =item Conclusion |
| 3476 | |
| 3477 | =item Bibliography |
| 3478 | |
| 3479 | =over 4 |
| 3480 | |
| 3481 | =item Introductory Texts |
| 3482 | |
| 3483 | =item OS-Related References |
| 3484 | |
| 3485 | =item Other References |
| 3486 | |
| 3487 | =back |
| 3488 | |
| 3489 | =item Acknowledgements |
| 3490 | |
| 3491 | =item AUTHOR |
| 3492 | |
| 3493 | =item Copyrights |
| 3494 | |
| 3495 | =back |
| 3496 | |
| 3497 | =head2 perlport - Writing portable Perl |
| 3498 | |
| 3499 | =over 4 |
| 3500 | |
| 3501 | =item DESCRIPTION |
| 3502 | |
| 3503 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
| 3504 | portable |
| 3505 | |
| 3506 | =item ISSUES |
| 3507 | |
| 3508 | =over 4 |
| 3509 | |
| 3510 | =item Newlines |
| 3511 | |
| 3512 | =item Numbers endianness and Width |
| 3513 | |
| 3514 | =item Files and Filesystems |
| 3515 | |
| 3516 | =item System Interaction |
| 3517 | |
| 3518 | =item Command names versus file pathnames |
| 3519 | |
| 3520 | =item Networking |
| 3521 | |
| 3522 | =item Interprocess Communication (IPC) |
| 3523 | |
| 3524 | =item External Subroutines (XS) |
| 3525 | |
| 3526 | =item Standard Modules |
| 3527 | |
| 3528 | =item Time and Date |
| 3529 | |
| 3530 | =item Character sets and character encoding |
| 3531 | |
| 3532 | =item Internationalisation |
| 3533 | |
| 3534 | =item System Resources |
| 3535 | |
| 3536 | =item Security |
| 3537 | |
| 3538 | =item Style |
| 3539 | |
| 3540 | =back |
| 3541 | |
| 3542 | =item CPAN Testers |
| 3543 | |
| 3544 | =item PLATFORMS |
| 3545 | |
| 3546 | =over 4 |
| 3547 | |
| 3548 | =item Unix |
| 3549 | |
| 3550 | =item DOS and Derivatives |
| 3551 | |
| 3552 | =item S<Mac OS> |
| 3553 | |
| 3554 | =item VMS |
| 3555 | |
| 3556 | =item VOS |
| 3557 | |
| 3558 | =item EBCDIC Platforms |
| 3559 | |
| 3560 | =item Acorn RISC OS |
| 3561 | |
| 3562 | =item Other perls |
| 3563 | |
| 3564 | =back |
| 3565 | |
| 3566 | =item FUNCTION IMPLEMENTATIONS |
| 3567 | |
| 3568 | =over 4 |
| 3569 | |
| 3570 | =item Alphabetical Listing of Perl Functions |
| 3571 | |
| 3572 | -I<X>, atan2 Y,X, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, |
| 3573 | dbmopen, dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid, |
| 3574 | getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid, |
| 3575 | getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent, |
| 3576 | gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent, |
| 3577 | setnetent, setprotoent, setservent, endpwent, endgrent, endhostent, |
| 3578 | endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob, |
| 3579 | gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat, |
| 3580 | msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select, |
| 3581 | semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent, |
| 3582 | setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair, |
| 3583 | stat, symlink, syscall, sysopen, system, times, truncate, umask, utime, |
| 3584 | wait, waitpid |
| 3585 | |
| 3586 | =back |
| 3587 | |
| 3588 | =item Supported Platforms |
| 3589 | |
| 3590 | =item SEE ALSO |
| 3591 | |
| 3592 | =item AUTHORS / CONTRIBUTORS |
| 3593 | |
| 3594 | =back |
| 3595 | |
| 3596 | =head2 perllocale - Perl locale handling (internationalization and |
| 3597 | localization) |
| 3598 | |
| 3599 | =over 4 |
| 3600 | |
| 3601 | =item DESCRIPTION |
| 3602 | |
| 3603 | =item PREPARING TO USE LOCALES |
| 3604 | |
| 3605 | =item USING LOCALES |
| 3606 | |
| 3607 | =over 4 |
| 3608 | |
| 3609 | =item The use locale pragma |
| 3610 | |
| 3611 | =item The setlocale function |
| 3612 | |
| 3613 | =item Finding locales |
| 3614 | |
| 3615 | =item LOCALE PROBLEMS |
| 3616 | |
| 3617 | =item Temporarily fixing locale problems |
| 3618 | |
| 3619 | =item Permanently fixing locale problems |
| 3620 | |
| 3621 | =item Permanently fixing your system's locale configuration |
| 3622 | |
| 3623 | =item Fixing system locale configuration |
| 3624 | |
| 3625 | =item The localeconv function |
| 3626 | |
| 3627 | =item I18N::Langinfo |
| 3628 | |
| 3629 | =back |
| 3630 | |
| 3631 | =item LOCALE CATEGORIES |
| 3632 | |
| 3633 | =over 4 |
| 3634 | |
| 3635 | =item Category LC_COLLATE: Collation |
| 3636 | |
| 3637 | =item Category LC_CTYPE: Character Types |
| 3638 | |
| 3639 | =item Category LC_NUMERIC: Numeric Formatting |
| 3640 | |
| 3641 | =item Category LC_MONETARY: Formatting of monetary amounts |
| 3642 | |
| 3643 | =item LC_TIME |
| 3644 | |
| 3645 | =item Other categories |
| 3646 | |
| 3647 | =back |
| 3648 | |
| 3649 | =item SECURITY |
| 3650 | |
| 3651 | =item ENVIRONMENT |
| 3652 | |
| 3653 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
| 3654 | LC_NUMERIC, LC_TIME, LANG |
| 3655 | |
| 3656 | =item NOTES |
| 3657 | |
| 3658 | =over 4 |
| 3659 | |
| 3660 | =item Backward compatibility |
| 3661 | |
| 3662 | =item I18N:Collate obsolete |
| 3663 | |
| 3664 | =item Sort speed and memory use impacts |
| 3665 | |
| 3666 | =item write() and LC_NUMERIC |
| 3667 | |
| 3668 | =item Freely available locale definitions |
| 3669 | |
| 3670 | =item I18n and l10n |
| 3671 | |
| 3672 | =item An imperfect standard |
| 3673 | |
| 3674 | =back |
| 3675 | |
| 3676 | =item Unicode and UTF-8 |
| 3677 | |
| 3678 | =item BUGS |
| 3679 | |
| 3680 | =over 4 |
| 3681 | |
| 3682 | =item Broken systems |
| 3683 | |
| 3684 | =back |
| 3685 | |
| 3686 | =item SEE ALSO |
| 3687 | |
| 3688 | =item HISTORY |
| 3689 | |
| 3690 | =back |
| 3691 | |
| 3692 | =head2 perluniintro - Perl Unicode introduction |
| 3693 | |
| 3694 | =over 4 |
| 3695 | |
| 3696 | =item DESCRIPTION |
| 3697 | |
| 3698 | =over 4 |
| 3699 | |
| 3700 | =item Unicode |
| 3701 | |
| 3702 | =item Perl's Unicode Support |
| 3703 | |
| 3704 | =item Perl's Unicode Model |
| 3705 | |
| 3706 | =item Unicode and EBCDIC |
| 3707 | |
| 3708 | =item Creating Unicode |
| 3709 | |
| 3710 | =item Handling Unicode |
| 3711 | |
| 3712 | =item Legacy Encodings |
| 3713 | |
| 3714 | =item Unicode I/O |
| 3715 | |
| 3716 | =item Displaying Unicode As Text |
| 3717 | |
| 3718 | =item Special Cases |
| 3719 | |
| 3720 | =item Advanced Topics |
| 3721 | |
| 3722 | =item Miscellaneous |
| 3723 | |
| 3724 | =item Questions With Answers |
| 3725 | |
| 3726 | =item Hexadecimal Notation |
| 3727 | |
| 3728 | =item Further Resources |
| 3729 | |
| 3730 | =back |
| 3731 | |
| 3732 | =item UNICODE IN OLDER PERLS |
| 3733 | |
| 3734 | =item SEE ALSO |
| 3735 | |
| 3736 | =item ACKNOWLEDGMENTS |
| 3737 | |
| 3738 | =item AUTHOR, COPYRIGHT, AND LICENSE |
| 3739 | |
| 3740 | =back |
| 3741 | |
| 3742 | =head2 perlunicode - Unicode support in Perl |
| 3743 | |
| 3744 | =over 4 |
| 3745 | |
| 3746 | =item DESCRIPTION |
| 3747 | |
| 3748 | =over 4 |
| 3749 | |
| 3750 | =item Important Caveats |
| 3751 | |
| 3752 | Input and Output Layers, Regular Expressions, C<use utf8> still needed to |
| 3753 | enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts |
| 3754 | autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings |
| 3755 | |
| 3756 | =item Byte and Character Semantics |
| 3757 | |
| 3758 | =item Effects of Character Semantics |
| 3759 | |
| 3760 | =item Scripts |
| 3761 | |
| 3762 | =item Blocks |
| 3763 | |
| 3764 | =item User-Defined Character Properties |
| 3765 | |
| 3766 | =item Character Encodings for Input and Output |
| 3767 | |
| 3768 | =item Unicode Regular Expression Support Level |
| 3769 | |
| 3770 | =item Unicode Encodings |
| 3771 | |
| 3772 | =item Security Implications of Unicode |
| 3773 | |
| 3774 | =item Unicode in Perl on EBCDIC |
| 3775 | |
| 3776 | =item Locales |
| 3777 | |
| 3778 | =item When Unicode Does Not Happen |
| 3779 | |
| 3780 | =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl) |
| 3781 | |
| 3782 | =item Using Unicode in XS |
| 3783 | |
| 3784 | =back |
| 3785 | |
| 3786 | =item BUGS |
| 3787 | |
| 3788 | =over 4 |
| 3789 | |
| 3790 | =item Interaction with Locales |
| 3791 | |
| 3792 | =item Interaction with Extensions |
| 3793 | |
| 3794 | =item Speed |
| 3795 | |
| 3796 | =item Porting code from perl-5.6.X |
| 3797 | |
| 3798 | =back |
| 3799 | |
| 3800 | =item SEE ALSO |
| 3801 | |
| 3802 | =back |
| 3803 | |
| 3804 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms |
| 3805 | |
| 3806 | =over 4 |
| 3807 | |
| 3808 | =item DESCRIPTION |
| 3809 | |
| 3810 | =item COMMON CHARACTER CODE SETS |
| 3811 | |
| 3812 | =over 4 |
| 3813 | |
| 3814 | =item ASCII |
| 3815 | |
| 3816 | =item ISO 8859 |
| 3817 | |
| 3818 | =item Latin 1 (ISO 8859-1) |
| 3819 | |
| 3820 | =item EBCDIC |
| 3821 | |
| 3822 | =item 13 variant characters |
| 3823 | |
| 3824 | =item 0037 |
| 3825 | |
| 3826 | =item 1047 |
| 3827 | |
| 3828 | =item POSIX-BC |
| 3829 | |
| 3830 | =item Unicode code points versus EBCDIC code points |
| 3831 | |
| 3832 | =item Remaining Perl Unicode problems in EBCDIC |
| 3833 | |
| 3834 | =item Unicode and UTF |
| 3835 | |
| 3836 | =item Using Encode |
| 3837 | |
| 3838 | =back |
| 3839 | |
| 3840 | =item SINGLE OCTET TABLES |
| 3841 | |
| 3842 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 |
| 3843 | |
| 3844 | =item IDENTIFYING CHARACTER CODE SETS |
| 3845 | |
| 3846 | =item CONVERSIONS |
| 3847 | |
| 3848 | =over 4 |
| 3849 | |
| 3850 | =item tr/// |
| 3851 | |
| 3852 | =item iconv |
| 3853 | |
| 3854 | =item C RTL |
| 3855 | |
| 3856 | =back |
| 3857 | |
| 3858 | =item OPERATOR DIFFERENCES |
| 3859 | |
| 3860 | =item FUNCTION DIFFERENCES |
| 3861 | |
| 3862 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() |
| 3863 | |
| 3864 | =item REGULAR EXPRESSION DIFFERENCES |
| 3865 | |
| 3866 | =item SOCKETS |
| 3867 | |
| 3868 | =item SORTING |
| 3869 | |
| 3870 | =over 4 |
| 3871 | |
| 3872 | =item Ignore ASCII vs. EBCDIC sort differences. |
| 3873 | |
| 3874 | =item MONO CASE then sort data. |
| 3875 | |
| 3876 | =item Convert, sort data, then re convert. |
| 3877 | |
| 3878 | =item Perform sorting on one type of machine only. |
| 3879 | |
| 3880 | =back |
| 3881 | |
| 3882 | =item TRANSFORMATION FORMATS |
| 3883 | |
| 3884 | =over 4 |
| 3885 | |
| 3886 | =item URL decoding and encoding |
| 3887 | |
| 3888 | =item uu encoding and decoding |
| 3889 | |
| 3890 | =item Quoted-Printable encoding and decoding |
| 3891 | |
| 3892 | =item Caesarian ciphers |
| 3893 | |
| 3894 | =back |
| 3895 | |
| 3896 | =item Hashing order and checksums |
| 3897 | |
| 3898 | =item I18N AND L10N |
| 3899 | |
| 3900 | =item MULTI OCTET CHARACTER SETS |
| 3901 | |
| 3902 | =item OS ISSUES |
| 3903 | |
| 3904 | =over 4 |
| 3905 | |
| 3906 | =item OS/400 |
| 3907 | |
| 3908 | PASE, IFS access |
| 3909 | |
| 3910 | =item OS/390, z/OS |
| 3911 | |
| 3912 | chcp, dataset access, OS/390, z/OS iconv, locales |
| 3913 | |
| 3914 | =item VM/ESA? |
| 3915 | |
| 3916 | =item POSIX-BC? |
| 3917 | |
| 3918 | =back |
| 3919 | |
| 3920 | =item BUGS |
| 3921 | |
| 3922 | =item SEE ALSO |
| 3923 | |
| 3924 | =item REFERENCES |
| 3925 | |
| 3926 | =item HISTORY |
| 3927 | |
| 3928 | =item AUTHOR |
| 3929 | |
| 3930 | =back |
| 3931 | |
| 3932 | =head2 perlsec - Perl security |
| 3933 | |
| 3934 | =over 4 |
| 3935 | |
| 3936 | =item DESCRIPTION |
| 3937 | |
| 3938 | =over 4 |
| 3939 | |
| 3940 | =item Laundering and Detecting Tainted Data |
| 3941 | |
| 3942 | =item Switches On the "#!" Line |
| 3943 | |
| 3944 | =item Taint mode and @INC |
| 3945 | |
| 3946 | =item Cleaning Up Your Path |
| 3947 | |
| 3948 | =item Security Bugs |
| 3949 | |
| 3950 | =item Protecting Your Programs |
| 3951 | |
| 3952 | =item Unicode |
| 3953 | |
| 3954 | =item Algorithmic Complexity Attacks |
| 3955 | |
| 3956 | =back |
| 3957 | |
| 3958 | =item SEE ALSO |
| 3959 | |
| 3960 | =back |
| 3961 | |
| 3962 | =head2 perlmod - Perl modules (packages and symbol tables) |
| 3963 | |
| 3964 | =over 4 |
| 3965 | |
| 3966 | =item DESCRIPTION |
| 3967 | |
| 3968 | =over 4 |
| 3969 | |
| 3970 | =item Packages |
| 3971 | X<package> X<namespace> X<variable, global> X<global variable> X<global> |
| 3972 | |
| 3973 | =item Symbol Tables |
| 3974 | X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias> |
| 3975 | |
| 3976 | =item BEGIN, CHECK, INIT and END |
| 3977 | X<BEGIN> X<CHECK> X<INIT> X<END> |
| 3978 | |
| 3979 | =item Perl Classes |
| 3980 | X<class> X<@ISA> |
| 3981 | |
| 3982 | =item Perl Modules |
| 3983 | X<module> |
| 3984 | |
| 3985 | =item Making your module threadsafe |
| 3986 | X<threadsafe> X<thread safe> |
| 3987 | X<module, threadsafe> X<module, thread safe> |
| 3988 | X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread> |
| 3989 | |
| 3990 | =back |
| 3991 | |
| 3992 | =item SEE ALSO |
| 3993 | |
| 3994 | =back |
| 3995 | |
| 3996 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
| 3997 | |
| 3998 | =over 4 |
| 3999 | |
| 4000 | =item THE PERL MODULE LIBRARY |
| 4001 | |
| 4002 | =over 4 |
| 4003 | |
| 4004 | =item Pragmatic Modules |
| 4005 | |
| 4006 | assertions::compat, attributes, attrs, autouse, base, bigint, bignum, |
| 4007 | bigrat, blib, bytes, charnames, constant, diagnostics, encoding, fields, |
| 4008 | filetest, if, integer, less, lib, locale, open, ops, overload, re, sigtrap, |
| 4009 | sort, strict, subs, threads, threads::shared, utf8, vars, vmsish, warnings, |
| 4010 | warnings::register |
| 4011 | |
| 4012 | =item Standard Modules |
| 4013 | |
| 4014 | AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers, |
| 4015 | AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, |
| 4016 | B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, |
| 4017 | B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, |
| 4018 | ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, |
| 4019 | CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, |
| 4020 | CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct, Compress::Zlib, |
| 4021 | Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, |
| 4022 | Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::base, |
| 4023 | DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte, |
| 4024 | Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config, |
| 4025 | Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess, |
| 4026 | Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, |
| 4027 | Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO, |
| 4028 | Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode, |
| 4029 | Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy, |
| 4030 | ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows, |
| 4031 | ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, |
| 4032 | ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, |
| 4033 | ExtUtils::MM, ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, |
| 4034 | ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, ExtUtils::MM_MacOS, |
| 4035 | ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX, ExtUtils::MM_UWIN, |
| 4036 | ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS, ExtUtils::MM_Win32, |
| 4037 | ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, |
| 4038 | ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ, |
| 4039 | ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes, |
| 4040 | ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap, |
| 4041 | ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS, |
| 4042 | ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, |
| 4043 | File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob, |
| 4044 | File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, |
| 4045 | File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, |
| 4046 | File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, |
| 4047 | FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File, |
| 4048 | Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags, |
| 4049 | I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle, |
| 4050 | IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, |
| 4051 | IO::Socket::UNIX, IO::Zlib, IPC::Open2, IPC::Open3, IPC::SysV, |
| 4052 | IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util, Locale::Constants, |
| 4053 | Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, |
| 4054 | Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, |
| 4055 | MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, |
| 4056 | Math::BigInt::Calc, Math::BigInt::FastCalc, Math::BigRat, Math::Complex, |
| 4057 | Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, |
| 4058 | Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, |
| 4059 | Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd, |
| 4060 | Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, |
| 4061 | Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, |
| 4062 | Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, |
| 4063 | PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, |
| 4064 | Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, |
| 4065 | Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, |
| 4066 | Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, |
| 4067 | Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, |
| 4068 | Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, |
| 4069 | Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, |
| 4070 | Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, |
| 4071 | Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, |
| 4072 | Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap, |
| 4073 | Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness, |
| 4074 | Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point, |
| 4075 | Test::Harness::Straps, Test::More, Test::Simple, Test::Tutorial, |
| 4076 | Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, |
| 4077 | Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, |
| 4078 | Thread::Specific, Tie::Array, Tie::File, Tie::Handle, Tie::Hash, |
| 4079 | Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes, |
| 4080 | Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, |
| 4081 | Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent, |
| 4082 | User::pwent, Win32, XS::APItest, XS::Typemap, XSLoader |
| 4083 | |
| 4084 | =item Extension Modules |
| 4085 | |
| 4086 | =back |
| 4087 | |
| 4088 | =item CPAN |
| 4089 | |
| 4090 | =over 4 |
| 4091 | |
| 4092 | =item Africa |
| 4093 | |
| 4094 | South Africa |
| 4095 | |
| 4096 | =item Asia |
| 4097 | |
| 4098 | China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi |
| 4099 | Arabia, Singapore, South Korea, Taiwan, Thailand |
| 4100 | |
| 4101 | =item Central America |
| 4102 | |
| 4103 | Costa Rica |
| 4104 | |
| 4105 | =item Europe |
| 4106 | |
| 4107 | Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech |
| 4108 | Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, |
| 4109 | Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland, |
| 4110 | Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland, |
| 4111 | Turkey, Ukraine, United Kingdom |
| 4112 | |
| 4113 | =item North America |
| 4114 | |
| 4115 | Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, |
| 4116 | Alabama, California, Colorado, Delaware, District of Columbia, Florida, |
| 4117 | Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York, |
| 4118 | North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah, |
| 4119 | Virginia, Washington, Wisconsin |
| 4120 | |
| 4121 | =item Oceania |
| 4122 | |
| 4123 | Australia, New Zealand, United States |
| 4124 | |
| 4125 | =item South America |
| 4126 | |
| 4127 | Argentina, Brazil, Chile |
| 4128 | |
| 4129 | =item RSYNC Mirrors |
| 4130 | |
| 4131 | =back |
| 4132 | |
| 4133 | =item Modules: Creation, Use, and Abuse |
| 4134 | |
| 4135 | =over 4 |
| 4136 | |
| 4137 | =item Guidelines for Module Creation |
| 4138 | |
| 4139 | =item Guidelines for Converting Perl 4 Library Scripts into Modules |
| 4140 | |
| 4141 | =item Guidelines for Reusing Application Code |
| 4142 | |
| 4143 | =back |
| 4144 | |
| 4145 | =item NOTE |
| 4146 | |
| 4147 | =back |
| 4148 | |
| 4149 | =head2 perlmodstyle - Perl module style guide |
| 4150 | |
| 4151 | =over 4 |
| 4152 | |
| 4153 | =item INTRODUCTION |
| 4154 | |
| 4155 | =item QUICK CHECKLIST |
| 4156 | |
| 4157 | =over 4 |
| 4158 | |
| 4159 | =item Before you start |
| 4160 | |
| 4161 | =item The API |
| 4162 | |
| 4163 | =item Stability |
| 4164 | |
| 4165 | =item Documentation |
| 4166 | |
| 4167 | =item Release considerations |
| 4168 | |
| 4169 | =back |
| 4170 | |
| 4171 | =item BEFORE YOU START WRITING A MODULE |
| 4172 | |
| 4173 | =over 4 |
| 4174 | |
| 4175 | =item Has it been done before? |
| 4176 | |
| 4177 | =item Do one thing and do it well |
| 4178 | |
| 4179 | =item What's in a name? |
| 4180 | |
| 4181 | =back |
| 4182 | |
| 4183 | =item DESIGNING AND WRITING YOUR MODULE |
| 4184 | |
| 4185 | =over 4 |
| 4186 | |
| 4187 | =item To OO or not to OO? |
| 4188 | |
| 4189 | =item Designing your API |
| 4190 | |
| 4191 | Write simple routines to do simple things, Separate functionality from |
| 4192 | output, Provide sensible shortcuts and defaults, Naming conventions, |
| 4193 | Parameter passing |
| 4194 | |
| 4195 | =item Strictness and warnings |
| 4196 | |
| 4197 | =item Backwards compatibility |
| 4198 | |
| 4199 | =item Error handling and messages |
| 4200 | |
| 4201 | =back |
| 4202 | |
| 4203 | =item DOCUMENTING YOUR MODULE |
| 4204 | |
| 4205 | =over 4 |
| 4206 | |
| 4207 | =item POD |
| 4208 | |
| 4209 | =item README, INSTALL, release notes, changelogs |
| 4210 | |
| 4211 | perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build, |
| 4212 | perl Build test, perl Build install |
| 4213 | |
| 4214 | =back |
| 4215 | |
| 4216 | =item RELEASE CONSIDERATIONS |
| 4217 | |
| 4218 | =over 4 |
| 4219 | |
| 4220 | =item Version numbering |
| 4221 | |
| 4222 | =item Pre-requisites |
| 4223 | |
| 4224 | =item Testing |
| 4225 | |
| 4226 | =item Packaging |
| 4227 | |
| 4228 | =item Licensing |
| 4229 | |
| 4230 | =back |
| 4231 | |
| 4232 | =item COMMON PITFALLS |
| 4233 | |
| 4234 | =over 4 |
| 4235 | |
| 4236 | =item Reinventing the wheel |
| 4237 | |
| 4238 | =item Trying to do too much |
| 4239 | |
| 4240 | =item Inappropriate documentation |
| 4241 | |
| 4242 | =back |
| 4243 | |
| 4244 | =item SEE ALSO |
| 4245 | |
| 4246 | L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools, |
| 4247 | Testing tools, http://pause.perl.org/, Any good book on software |
| 4248 | engineering |
| 4249 | |
| 4250 | =item AUTHOR |
| 4251 | |
| 4252 | =back |
| 4253 | |
| 4254 | =head2 perlmodinstall - Installing CPAN Modules |
| 4255 | |
| 4256 | =over 4 |
| 4257 | |
| 4258 | =item DESCRIPTION |
| 4259 | |
| 4260 | =over 4 |
| 4261 | |
| 4262 | =item PREAMBLE |
| 4263 | |
| 4264 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
| 4265 | module (sometimes unnecessary), B<INSTALL> the module |
| 4266 | |
| 4267 | =back |
| 4268 | |
| 4269 | =item PORTABILITY |
| 4270 | |
| 4271 | =item HEY |
| 4272 | |
| 4273 | =item AUTHOR |
| 4274 | |
| 4275 | =item COPYRIGHT |
| 4276 | |
| 4277 | =back |
| 4278 | |
| 4279 | =head2 perlnewmod - preparing a new module for distribution |
| 4280 | |
| 4281 | =over 4 |
| 4282 | |
| 4283 | =item DESCRIPTION |
| 4284 | |
| 4285 | =over 4 |
| 4286 | |
| 4287 | =item Warning |
| 4288 | |
| 4289 | =item What should I make into a module? |
| 4290 | |
| 4291 | =item Step-by-step: Preparing the ground |
| 4292 | |
| 4293 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
| 4294 | |
| 4295 | =item Step-by-step: Making the module |
| 4296 | |
| 4297 | Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and |
| 4298 | L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, |
| 4299 | Use L<plain old documentation|perlpod>, Write tests, Write the README |
| 4300 | |
| 4301 | =item Step-by-step: Distributing your module |
| 4302 | |
| 4303 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
| 4304 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! |
| 4305 | |
| 4306 | =back |
| 4307 | |
| 4308 | =item AUTHOR |
| 4309 | |
| 4310 | =item SEE ALSO |
| 4311 | |
| 4312 | =back |
| 4313 | |
| 4314 | =head2 perlutil - utilities packaged with the Perl distribution |
| 4315 | |
| 4316 | =over 4 |
| 4317 | |
| 4318 | =item DESCRIPTION |
| 4319 | |
| 4320 | =over 4 |
| 4321 | |
| 4322 | =item DOCUMENTATION |
| 4323 | |
| 4324 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, |
| 4325 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, |
| 4326 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, |
| 4327 | L<roffitall|roffitall> |
| 4328 | |
| 4329 | =item CONVERTORS |
| 4330 | |
| 4331 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
| 4332 | |
| 4333 | =item Administration |
| 4334 | |
| 4335 | L<libnetcfg|libnetcfg> |
| 4336 | |
| 4337 | =item Development |
| 4338 | |
| 4339 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
| 4340 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> |
| 4341 | |
| 4342 | =item SEE ALSO |
| 4343 | |
| 4344 | =back |
| 4345 | |
| 4346 | =back |
| 4347 | |
| 4348 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
| 4349 | |
| 4350 | =over 4 |
| 4351 | |
| 4352 | =item DESCRIPTION |
| 4353 | |
| 4354 | =over 4 |
| 4355 | |
| 4356 | =item Layout |
| 4357 | |
| 4358 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
| 4359 | |
| 4360 | =back |
| 4361 | |
| 4362 | =item Using The Back Ends |
| 4363 | |
| 4364 | =over 4 |
| 4365 | |
| 4366 | =item The Cross Referencing Back End |
| 4367 | |
| 4368 | i, &, s, r |
| 4369 | |
| 4370 | =item The Decompiling Back End |
| 4371 | |
| 4372 | =item The Lint Back End |
| 4373 | |
| 4374 | =item The Simple C Back End |
| 4375 | |
| 4376 | =item The Bytecode Back End |
| 4377 | |
| 4378 | =item The Optimized C Back End |
| 4379 | |
| 4380 | =back |
| 4381 | |
| 4382 | =item Module List for the Compiler Suite |
| 4383 | |
| 4384 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, |
| 4385 | B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, |
| 4386 | B::Stackobj, B::Stash, B::Terse, B::Xref |
| 4387 | |
| 4388 | =item KNOWN PROBLEMS |
| 4389 | |
| 4390 | =item AUTHOR |
| 4391 | |
| 4392 | =back |
| 4393 | |
| 4394 | =head2 perlfilter - Source Filters |
| 4395 | |
| 4396 | =over 4 |
| 4397 | |
| 4398 | =item DESCRIPTION |
| 4399 | |
| 4400 | =item CONCEPTS |
| 4401 | |
| 4402 | =item USING FILTERS |
| 4403 | |
| 4404 | =item WRITING A SOURCE FILTER |
| 4405 | |
| 4406 | =item WRITING A SOURCE FILTER IN C |
| 4407 | |
| 4408 | B<Decryption Filters> |
| 4409 | |
| 4410 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE |
| 4411 | |
| 4412 | =item WRITING A SOURCE FILTER IN PERL |
| 4413 | |
| 4414 | =item USING CONTEXT: THE DEBUG FILTER |
| 4415 | |
| 4416 | =item CONCLUSION |
| 4417 | |
| 4418 | =item THINGS TO LOOK OUT FOR |
| 4419 | |
| 4420 | Some Filters Clobber the C<DATA> Handle |
| 4421 | |
| 4422 | =item REQUIREMENTS |
| 4423 | |
| 4424 | =item AUTHOR |
| 4425 | |
| 4426 | =item Copyrights |
| 4427 | |
| 4428 | =back |
| 4429 | |
| 4430 | =head2 perlglossary - Perl Glossary |
| 4431 | |
| 4432 | =over 4 |
| 4433 | |
| 4434 | =item DESCRIPTION |
| 4435 | |
| 4436 | =over 4 |
| 4437 | |
| 4438 | =item A |
| 4439 | |
| 4440 | accessor methods, actual arguments, address operator, algorithm, alias, |
| 4441 | alternatives, anonymous, architecture, argument, ARGV, arithmetical |
| 4442 | operator, array, array context, ASCII, assertion, assignment, assignment |
| 4443 | operator, associative array, associativity, asynchronous, atom, atomic |
| 4444 | operation, attribute, autogeneration, autoincrement, autoload, autosplit, |
| 4445 | autovivification, AV, awk |
| 4446 | |
| 4447 | =item B |
| 4448 | |
| 4449 | backreference, backtracking, backward compatibility, bareword, base class, |
| 4450 | big-endian, binary, binary operator, bind, bit, bit shift, bit string, |
| 4451 | bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint, |
| 4452 | broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode |
| 4453 | |
| 4454 | =item C |
| 4455 | |
| 4456 | C, C preprocessor, call by reference, call by value, callback, canonical, |
| 4457 | capturing, character, character class, character property, circumfix |
| 4458 | operator, class, class method, client, cloister, closure, cluster, CODE, |
| 4459 | code generator, code subpattern, collating sequence, command, command |
| 4460 | buffering, command name, command-line arguments, comment, compilation unit, |
| 4461 | compile phase, compile time, compiler, composer, concatenation, |
| 4462 | conditional, connection, construct, constructor, context, continuation, |
| 4463 | core dump, CPAN, cracker, current package, current working directory, |
| 4464 | currently selected output channel, CV |
| 4465 | |
| 4466 | =item D |
| 4467 | |
| 4468 | dangling statement, data structure, data type, datagram, DBM, declaration, |
| 4469 | decrement, default, defined, delimiter, dereference, derived class, |
| 4470 | descriptor, destroy, destructor, device, directive, directory, directory |
| 4471 | handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping |
| 4472 | |
| 4473 | =item E |
| 4474 | |
| 4475 | eclectic, element, embedding, empty subclass test, en passant, |
| 4476 | encapsulation, endian, environment, environment variable, EOF, errno, |
| 4477 | error, escape sequence, exception, exception handling, exec, executable |
| 4478 | file, execute, execute bit, exit status, export, expression, extension |
| 4479 | |
| 4480 | =item F |
| 4481 | |
| 4482 | false, FAQ, fatal error, field, FIFO, file, file descriptor, file test |
| 4483 | operator, fileglob, filehandle, filename, filesystem, filter, flag, |
| 4484 | floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely |
| 4485 | available, freely redistributable, freeware, function, funny character, |
| 4486 | garbage collection |
| 4487 | |
| 4488 | =item G |
| 4489 | |
| 4490 | GID, glob, global, global destruction, glue language, granularity, greedy, |
| 4491 | grep, group, GV |
| 4492 | |
| 4493 | =item H |
| 4494 | |
| 4495 | hacker, handler, hard reference, hash, hash table, header file, here |
| 4496 | document, hexadecimal, home directory, host, hubris, HV |
| 4497 | |
| 4498 | =item I |
| 4499 | |
| 4500 | identifier, impatience, implementation, import, increment, indexing, |
| 4501 | indirect filehandle, indirect object, indirect object slot, indirection, |
| 4502 | infix, inheritance, instance, instance variable, integer, interface, |
| 4503 | interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a, |
| 4504 | iteration, iterator, IV |
| 4505 | |
| 4506 | =item J |
| 4507 | |
| 4508 | JAPH |
| 4509 | |
| 4510 | =item K |
| 4511 | |
| 4512 | key, keyword |
| 4513 | |
| 4514 | =item L |
| 4515 | |
| 4516 | label, laziness, left shift, leftmost longest, lexeme, lexer, lexical |
| 4517 | analysis, lexical scoping, lexical variable, library, LIFO, line, line |
| 4518 | buffering, line number, link, LIST, list, list context, list operator, list |
| 4519 | value, literal, little-endian, local, logical operator, lookahead, |
| 4520 | lookbehind, loop, loop control statement, loop label, lvaluable, lvalue, |
| 4521 | lvalue modifier |
| 4522 | |
| 4523 | =item M |
| 4524 | |
| 4525 | magic, magical increment, magical variables, Makefile, man, manpage, |
| 4526 | matching, member data, memory, metacharacter, metasymbol, method, |
| 4527 | minimalism, mode, modifier, module, modulus, monger, mortal, |
| 4528 | multidimensional array, multiple inheritance |
| 4529 | |
| 4530 | =item N |
| 4531 | |
| 4532 | named pipe, namespace, network address, newline, NFS, null character, null |
| 4533 | list, null string, numeric context, NV, nybble |
| 4534 | |
| 4535 | =item O |
| 4536 | |
| 4537 | object, octal, offset, one-liner, open source software, operand, operating |
| 4538 | system, operator, operator overloading, options, overloading, overriding, |
| 4539 | owner |
| 4540 | |
| 4541 | =item P |
| 4542 | |
| 4543 | package, pad, parameter, parent class, parse tree, parsing, patch, PATH, |
| 4544 | pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline, |
| 4545 | platform, pod, pointer, polymorphism, port, portable, porter, POSIX, |
| 4546 | postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process, |
| 4547 | program generator, progressive matching, property, protocol, prototype, |
| 4548 | pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin, |
| 4549 | pumpking, PV |
| 4550 | |
| 4551 | =item Q |
| 4552 | |
| 4553 | qualified, quantifier |
| 4554 | |
| 4555 | =item R |
| 4556 | |
| 4557 | readable, reaping, record, recursion, reference, referent, regex, regular |
| 4558 | expression, regular expression modifier, regular file, relational operator, |
| 4559 | reserved words, return value, RFC, right shift, root, RTFM, run phase, run |
| 4560 | time, run-time pattern, RV, rvalue |
| 4561 | |
| 4562 | =item S |
| 4563 | |
| 4564 | scalar, scalar context, scalar literal, scalar value, scalar variable, |
| 4565 | scope, scratchpad, script, script kiddie, sed, semaphore, separator, |
| 4566 | serialization, server, service, setgid, setuid, shared memory, shebang, |
| 4567 | shell, side effects, signal, signal handler, single inheritance, slice, |
| 4568 | slurp, socket, soft reference, source filter, stack, standard, standard |
| 4569 | error, standard I/O, standard input, standard output, stat structure, |
| 4570 | statement, statement modifier, static, static method, static scoping, |
| 4571 | static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string, |
| 4572 | string context, stringification, struct, structure, subclass, subpattern, |
| 4573 | subroutine, subscript, substitution, substring, superclass, superuser, SV, |
| 4574 | switch, switch cluster, switch statement, symbol, symbol table, symbolic |
| 4575 | debugger, symbolic link, symbolic reference, synchronous, syntactic sugar, |
| 4576 | syntax, syntax tree, syscall |
| 4577 | |
| 4578 | =item T |
| 4579 | |
| 4580 | tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI, |
| 4581 | token, tokener, tokenizing, toolbox approach, transliterate, trigger, |
| 4582 | trinary, troff, true, truncating, type, type casting, typed lexical, |
| 4583 | typedef, typeglob, typemap |
| 4584 | |
| 4585 | =item U |
| 4586 | |
| 4587 | UDP, UID, umask, unary operator, Unicode, Unix |
| 4588 | |
| 4589 | =item V |
| 4590 | |
| 4591 | value, variable, variable interpolation, variadic, vector, virtual, void |
| 4592 | context, v-string |
| 4593 | |
| 4594 | =item W |
| 4595 | |
| 4596 | warning, watch expression, whitespace, word, working directory, wrapper, |
| 4597 | WYSIWYG |
| 4598 | |
| 4599 | =item X |
| 4600 | |
| 4601 | XS, XSUB |
| 4602 | |
| 4603 | =item Y |
| 4604 | |
| 4605 | yacc |
| 4606 | |
| 4607 | =item Z |
| 4608 | |
| 4609 | zero width, zombie |
| 4610 | |
| 4611 | =back |
| 4612 | |
| 4613 | =item AUTHOR AND COPYRIGHT |
| 4614 | |
| 4615 | =back |
| 4616 | |
| 4617 | =head2 perlembed - how to embed perl in your C program |
| 4618 | |
| 4619 | =over 4 |
| 4620 | |
| 4621 | =item DESCRIPTION |
| 4622 | |
| 4623 | =over 4 |
| 4624 | |
| 4625 | =item PREAMBLE |
| 4626 | |
| 4627 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
| 4628 | Perl?>, B<Use C from C?>, B<Use Perl from C?> |
| 4629 | |
| 4630 | =item ROADMAP |
| 4631 | |
| 4632 | =item Compiling your C program |
| 4633 | |
| 4634 | =item Adding a Perl interpreter to your C program |
| 4635 | |
| 4636 | =item Calling a Perl subroutine from your C program |
| 4637 | |
| 4638 | =item Evaluating a Perl statement from your C program |
| 4639 | |
| 4640 | =item Performing Perl pattern matches and substitutions from your C program |
| 4641 | |
| 4642 | =item Fiddling with the Perl stack from your C program |
| 4643 | |
| 4644 | =item Maintaining a persistent interpreter |
| 4645 | |
| 4646 | =item Execution of END blocks |
| 4647 | |
| 4648 | =item Maintaining multiple interpreter instances |
| 4649 | |
| 4650 | =item Using Perl modules, which themselves use C libraries, from your C |
| 4651 | program |
| 4652 | |
| 4653 | =back |
| 4654 | |
| 4655 | =item Embedding Perl under Win32 |
| 4656 | |
| 4657 | =item Hiding Perl_ |
| 4658 | |
| 4659 | =item MORAL |
| 4660 | |
| 4661 | =item AUTHOR |
| 4662 | |
| 4663 | =item COPYRIGHT |
| 4664 | |
| 4665 | =back |
| 4666 | |
| 4667 | =head2 perldebguts - Guts of Perl debugging |
| 4668 | |
| 4669 | =over 4 |
| 4670 | |
| 4671 | =item DESCRIPTION |
| 4672 | |
| 4673 | =item Debugger Internals |
| 4674 | |
| 4675 | =over 4 |
| 4676 | |
| 4677 | =item Writing Your Own Debugger |
| 4678 | |
| 4679 | =back |
| 4680 | |
| 4681 | =item Frame Listing Output Examples |
| 4682 | |
| 4683 | =item Debugging regular expressions |
| 4684 | |
| 4685 | =over 4 |
| 4686 | |
| 4687 | =item Compile-time output |
| 4688 | |
| 4689 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
| 4690 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> |
| 4691 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, |
| 4692 | C<anchored(TYPE)> |
| 4693 | |
| 4694 | =item Types of nodes |
| 4695 | |
| 4696 | =item Run-time output |
| 4697 | |
| 4698 | =back |
| 4699 | |
| 4700 | =item Debugging Perl memory usage |
| 4701 | |
| 4702 | =over 4 |
| 4703 | |
| 4704 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
| 4705 | |
| 4706 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
| 4707 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: |
| 4708 | 6144> |
| 4709 | |
| 4710 | =back |
| 4711 | |
| 4712 | =item SEE ALSO |
| 4713 | |
| 4714 | =back |
| 4715 | |
| 4716 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
| 4717 | |
| 4718 | =over 4 |
| 4719 | |
| 4720 | =item DESCRIPTION |
| 4721 | |
| 4722 | =item SPECIAL NOTES |
| 4723 | |
| 4724 | =over 4 |
| 4725 | |
| 4726 | =item make |
| 4727 | |
| 4728 | =item Version caveat |
| 4729 | |
| 4730 | =item Dynamic Loading versus Static Loading |
| 4731 | |
| 4732 | =back |
| 4733 | |
| 4734 | =item TUTORIAL |
| 4735 | |
| 4736 | =over 4 |
| 4737 | |
| 4738 | =item EXAMPLE 1 |
| 4739 | |
| 4740 | =item EXAMPLE 2 |
| 4741 | |
| 4742 | =item What has gone on? |
| 4743 | |
| 4744 | =item Writing good test scripts |
| 4745 | |
| 4746 | =item EXAMPLE 3 |
| 4747 | |
| 4748 | =item What's new here? |
| 4749 | |
| 4750 | =item Input and Output Parameters |
| 4751 | |
| 4752 | =item The XSUBPP Program |
| 4753 | |
| 4754 | =item The TYPEMAP file |
| 4755 | |
| 4756 | =item Warning about Output Arguments |
| 4757 | |
| 4758 | =item EXAMPLE 4 |
| 4759 | |
| 4760 | =item What has happened here? |
| 4761 | |
| 4762 | =item Anatomy of .xs file |
| 4763 | |
| 4764 | =item Getting the fat out of XSUBs |
| 4765 | |
| 4766 | =item More about XSUB arguments |
| 4767 | |
| 4768 | =item The Argument Stack |
| 4769 | |
| 4770 | =item Extending your Extension |
| 4771 | |
| 4772 | =item Documenting your Extension |
| 4773 | |
| 4774 | =item Installing your Extension |
| 4775 | |
| 4776 | =item EXAMPLE 5 |
| 4777 | |
| 4778 | =item New Things in this Example |
| 4779 | |
| 4780 | =item EXAMPLE 6 |
| 4781 | |
| 4782 | =item New Things in this Example |
| 4783 | |
| 4784 | =item EXAMPLE 7 (Coming Soon) |
| 4785 | |
| 4786 | =item EXAMPLE 8 (Coming Soon) |
| 4787 | |
| 4788 | =item EXAMPLE 9 Passing open files to XSes |
| 4789 | |
| 4790 | =item Troubleshooting these Examples |
| 4791 | |
| 4792 | =back |
| 4793 | |
| 4794 | =item See also |
| 4795 | |
| 4796 | =item Author |
| 4797 | |
| 4798 | =over 4 |
| 4799 | |
| 4800 | =item Last Changed |
| 4801 | |
| 4802 | =back |
| 4803 | |
| 4804 | =back |
| 4805 | |
| 4806 | =head2 perlxs - XS language reference manual |
| 4807 | |
| 4808 | =over 4 |
| 4809 | |
| 4810 | =item DESCRIPTION |
| 4811 | |
| 4812 | =over 4 |
| 4813 | |
| 4814 | =item Introduction |
| 4815 | |
| 4816 | =item On The Road |
| 4817 | |
| 4818 | =item The Anatomy of an XSUB |
| 4819 | |
| 4820 | =item The Argument Stack |
| 4821 | |
| 4822 | =item The RETVAL Variable |
| 4823 | |
| 4824 | =item Returning SVs, AVs and HVs through RETVAL |
| 4825 | |
| 4826 | =item The MODULE Keyword |
| 4827 | |
| 4828 | =item The PACKAGE Keyword |
| 4829 | |
| 4830 | =item The PREFIX Keyword |
| 4831 | |
| 4832 | =item The OUTPUT: Keyword |
| 4833 | |
| 4834 | =item The NO_OUTPUT Keyword |
| 4835 | |
| 4836 | =item The CODE: Keyword |
| 4837 | |
| 4838 | =item The INIT: Keyword |
| 4839 | |
| 4840 | =item The NO_INIT Keyword |
| 4841 | |
| 4842 | =item Initializing Function Parameters |
| 4843 | |
| 4844 | =item Default Parameter Values |
| 4845 | |
| 4846 | =item The PREINIT: Keyword |
| 4847 | |
| 4848 | =item The SCOPE: Keyword |
| 4849 | |
| 4850 | =item The INPUT: Keyword |
| 4851 | |
| 4852 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords |
| 4853 | |
| 4854 | =item The C<length(NAME)> Keyword |
| 4855 | |
| 4856 | =item Variable-length Parameter Lists |
| 4857 | |
| 4858 | =item The C_ARGS: Keyword |
| 4859 | |
| 4860 | =item The PPCODE: Keyword |
| 4861 | |
| 4862 | =item Returning Undef And Empty Lists |
| 4863 | |
| 4864 | =item The REQUIRE: Keyword |
| 4865 | |
| 4866 | =item The CLEANUP: Keyword |
| 4867 | |
| 4868 | =item The POSTCALL: Keyword |
| 4869 | |
| 4870 | =item The BOOT: Keyword |
| 4871 | |
| 4872 | =item The VERSIONCHECK: Keyword |
| 4873 | |
| 4874 | =item The PROTOTYPES: Keyword |
| 4875 | |
| 4876 | =item The PROTOTYPE: Keyword |
| 4877 | |
| 4878 | =item The ALIAS: Keyword |
| 4879 | |
| 4880 | =item The OVERLOAD: Keyword |
| 4881 | |
| 4882 | =item The FALLBACK: Keyword |
| 4883 | |
| 4884 | =item The INTERFACE: Keyword |
| 4885 | |
| 4886 | =item The INTERFACE_MACRO: Keyword |
| 4887 | |
| 4888 | =item The INCLUDE: Keyword |
| 4889 | |
| 4890 | =item The CASE: Keyword |
| 4891 | |
| 4892 | =item The & Unary Operator |
| 4893 | |
| 4894 | =item Inserting POD, Comments and C Preprocessor Directives |
| 4895 | |
| 4896 | =item Using XS With C++ |
| 4897 | |
| 4898 | =item Interface Strategy |
| 4899 | |
| 4900 | =item Perl Objects And C Structures |
| 4901 | |
| 4902 | =item The Typemap |
| 4903 | |
| 4904 | =item Safely Storing Static Data in XS |
| 4905 | |
| 4906 | MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT |
| 4907 | |
| 4908 | =back |
| 4909 | |
| 4910 | =item EXAMPLES |
| 4911 | |
| 4912 | =item XS VERSION |
| 4913 | |
| 4914 | =item AUTHOR |
| 4915 | |
| 4916 | =back |
| 4917 | |
| 4918 | =head2 perlclib - Internal replacements for standard C library functions |
| 4919 | |
| 4920 | =over 4 |
| 4921 | |
| 4922 | =item DESCRIPTION |
| 4923 | |
| 4924 | =over 4 |
| 4925 | |
| 4926 | =item Conventions |
| 4927 | |
| 4928 | C<t>, C<p>, C<n>, C<s> |
| 4929 | |
| 4930 | =item File Operations |
| 4931 | |
| 4932 | =item File Input and Output |
| 4933 | |
| 4934 | =item File Positioning |
| 4935 | |
| 4936 | =item Memory Management and String Handling |
| 4937 | |
| 4938 | =item Character Class Tests |
| 4939 | |
| 4940 | =item F<stdlib.h> functions |
| 4941 | |
| 4942 | =item Miscellaneous functions |
| 4943 | |
| 4944 | =back |
| 4945 | |
| 4946 | =item SEE ALSO |
| 4947 | |
| 4948 | =back |
| 4949 | |
| 4950 | =head2 perlguts - Introduction to the Perl API |
| 4951 | |
| 4952 | =over 4 |
| 4953 | |
| 4954 | =item DESCRIPTION |
| 4955 | |
| 4956 | =item Variables |
| 4957 | |
| 4958 | =over 4 |
| 4959 | |
| 4960 | =item Datatypes |
| 4961 | |
| 4962 | =item What is an "IV"? |
| 4963 | |
| 4964 | =item Working with SVs |
| 4965 | |
| 4966 | =item Offsets |
| 4967 | |
| 4968 | =item What's Really Stored in an SV? |
| 4969 | |
| 4970 | =item Working with AVs |
| 4971 | |
| 4972 | =item Working with HVs |
| 4973 | |
| 4974 | =item Hash API Extensions |
| 4975 | |
| 4976 | =item AVs, HVs and undefined values |
| 4977 | |
| 4978 | =item References |
| 4979 | |
| 4980 | =item Blessed References and Class Objects |
| 4981 | |
| 4982 | =item Creating New Variables |
| 4983 | |
| 4984 | GV_ADDMULTI, GV_ADDWARN |
| 4985 | |
| 4986 | =item Reference Counts and Mortality |
| 4987 | |
| 4988 | =item Stashes and Globs |
| 4989 | |
| 4990 | =item Double-Typed SVs |
| 4991 | |
| 4992 | =item Magic Variables |
| 4993 | |
| 4994 | =item Assigning Magic |
| 4995 | |
| 4996 | =item Magic Virtual Tables |
| 4997 | |
| 4998 | =item Finding Magic |
| 4999 | |
| 5000 | =item Understanding the Magic of Tied Hashes and Arrays |
| 5001 | |
| 5002 | =item Localizing changes |
| 5003 | |
| 5004 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
| 5005 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV |
| 5006 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, |
| 5007 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, |
| 5008 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, |
| 5009 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* |
| 5010 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, |
| 5011 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, |
| 5012 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void |
| 5013 | save_hptr(HV **hptr)> |
| 5014 | |
| 5015 | =back |
| 5016 | |
| 5017 | =item Subroutines |
| 5018 | |
| 5019 | =over 4 |
| 5020 | |
| 5021 | =item XSUBs and the Argument Stack |
| 5022 | |
| 5023 | =item Calling Perl Routines from within C Programs |
| 5024 | |
| 5025 | =item Memory Allocation |
| 5026 | |
| 5027 | =item PerlIO |
| 5028 | |
| 5029 | =item Putting a C value on Perl stack |
| 5030 | |
| 5031 | =item Scratchpads |
| 5032 | |
| 5033 | =item Scratchpads and recursion |
| 5034 | |
| 5035 | =back |
| 5036 | |
| 5037 | =item Compiled code |
| 5038 | |
| 5039 | =over 4 |
| 5040 | |
| 5041 | =item Code tree |
| 5042 | |
| 5043 | =item Examining the tree |
| 5044 | |
| 5045 | =item Compile pass 1: check routines |
| 5046 | |
| 5047 | =item Compile pass 1a: constant folding |
| 5048 | |
| 5049 | =item Compile pass 2: context propagation |
| 5050 | |
| 5051 | =item Compile pass 3: peephole optimization |
| 5052 | |
| 5053 | =item Pluggable runops |
| 5054 | |
| 5055 | =back |
| 5056 | |
| 5057 | =item Examining internal data structures with the C<dump> functions |
| 5058 | |
| 5059 | =item How multiple interpreters and concurrency are supported |
| 5060 | |
| 5061 | =over 4 |
| 5062 | |
| 5063 | =item Background and PERL_IMPLICIT_CONTEXT |
| 5064 | |
| 5065 | =item So what happened to dTHR? |
| 5066 | |
| 5067 | =item How do I use all this in extensions? |
| 5068 | |
| 5069 | =item Should I do anything special if I call perl from multiple threads? |
| 5070 | |
| 5071 | =item Future Plans and PERL_IMPLICIT_SYS |
| 5072 | |
| 5073 | =back |
| 5074 | |
| 5075 | =item Internal Functions |
| 5076 | |
| 5077 | A, p, d, s, n, r, f, M, o, x, m, X, E, b |
| 5078 | |
| 5079 | =over 4 |
| 5080 | |
| 5081 | =item Formatted Printing of IVs, UVs, and NVs |
| 5082 | |
| 5083 | =item Pointer-To-Integer and Integer-To-Pointer |
| 5084 | |
| 5085 | =item Source Documentation |
| 5086 | |
| 5087 | =item Backwards compatibility |
| 5088 | |
| 5089 | =back |
| 5090 | |
| 5091 | =item Unicode Support |
| 5092 | |
| 5093 | =over 4 |
| 5094 | |
| 5095 | =item What B<is> Unicode, anyway? |
| 5096 | |
| 5097 | =item How can I recognise a UTF-8 string? |
| 5098 | |
| 5099 | =item How does UTF-8 represent Unicode characters? |
| 5100 | |
| 5101 | =item How does Perl store UTF-8 strings? |
| 5102 | |
| 5103 | =item How do I convert a string to UTF-8? |
| 5104 | |
| 5105 | =item Is there anything else I need to know? |
| 5106 | |
| 5107 | =back |
| 5108 | |
| 5109 | =item Custom Operators |
| 5110 | |
| 5111 | =item AUTHORS |
| 5112 | |
| 5113 | =item SEE ALSO |
| 5114 | |
| 5115 | =back |
| 5116 | |
| 5117 | =head2 perlcall - Perl calling conventions from C |
| 5118 | |
| 5119 | =over 4 |
| 5120 | |
| 5121 | =item DESCRIPTION |
| 5122 | |
| 5123 | An Error Handler, An Event Driven Program |
| 5124 | |
| 5125 | =item THE CALL_ FUNCTIONS |
| 5126 | |
| 5127 | call_sv, call_pv, call_method, call_argv |
| 5128 | |
| 5129 | =item FLAG VALUES |
| 5130 | |
| 5131 | =over 4 |
| 5132 | |
| 5133 | =item G_VOID |
| 5134 | |
| 5135 | =item G_SCALAR |
| 5136 | |
| 5137 | =item G_ARRAY |
| 5138 | |
| 5139 | =item G_DISCARD |
| 5140 | |
| 5141 | =item G_NOARGS |
| 5142 | |
| 5143 | =item G_EVAL |
| 5144 | |
| 5145 | =item G_KEEPERR |
| 5146 | |
| 5147 | =item Determining the Context |
| 5148 | |
| 5149 | =back |
| 5150 | |
| 5151 | =item EXAMPLES |
| 5152 | |
| 5153 | =over 4 |
| 5154 | |
| 5155 | =item No Parameters, Nothing returned |
| 5156 | |
| 5157 | =item Passing Parameters |
| 5158 | |
| 5159 | =item Returning a Scalar |
| 5160 | |
| 5161 | =item Returning a list of values |
| 5162 | |
| 5163 | =item Returning a list in a scalar context |
| 5164 | |
| 5165 | =item Returning Data from Perl via the parameter list |
| 5166 | |
| 5167 | =item Using G_EVAL |
| 5168 | |
| 5169 | =item Using G_KEEPERR |
| 5170 | |
| 5171 | =item Using call_sv |
| 5172 | |
| 5173 | =item Using call_argv |
| 5174 | |
| 5175 | =item Using call_method |
| 5176 | |
| 5177 | =item Using GIMME_V |
| 5178 | |
| 5179 | =item Using Perl to dispose of temporaries |
| 5180 | |
| 5181 | =item Strategies for storing Callback Context Information |
| 5182 | |
| 5183 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
| 5184 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl |
| 5185 | callback |
| 5186 | |
| 5187 | =item Alternate Stack Manipulation |
| 5188 | |
| 5189 | =item Creating and calling an anonymous subroutine in C |
| 5190 | |
| 5191 | =back |
| 5192 | |
| 5193 | =item SEE ALSO |
| 5194 | |
| 5195 | =item AUTHOR |
| 5196 | |
| 5197 | =item DATE |
| 5198 | |
| 5199 | =back |
| 5200 | |
| 5201 | =head2 perlapi - autogenerated documentation for the perl public API |
| 5202 | |
| 5203 | =over 4 |
| 5204 | |
| 5205 | =item DESCRIPTION |
| 5206 | X<Perl API> X<API> X<api> |
| 5207 | |
| 5208 | =item "Gimme" Values |
| 5209 | |
| 5210 | GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD |
| 5211 | X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>, |
| 5212 | G_VOID X<G_VOID> |
| 5213 | |
| 5214 | =item Array Manipulation Functions |
| 5215 | |
| 5216 | AvFILL X<AvFILL>, av_clear X<av_clear>, av_delete X<av_delete>, av_exists |
| 5217 | X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill |
| 5218 | X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push |
| 5219 | X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef |
| 5220 | X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>, |
| 5221 | sortsv X<sortsv> |
| 5222 | |
| 5223 | =item Callback Functions |
| 5224 | |
| 5225 | call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>, |
| 5226 | call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>, |
| 5227 | FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS> |
| 5228 | |
| 5229 | =item Character classes |
| 5230 | |
| 5231 | isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER |
| 5232 | X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>, |
| 5233 | toUPPER X<toUPPER> |
| 5234 | |
| 5235 | =item Cloning an interpreter |
| 5236 | |
| 5237 | perl_clone X<perl_clone> |
| 5238 | |
| 5239 | =item CV Manipulation Functions |
| 5240 | |
| 5241 | CvSTASH X<CvSTASH>, get_cv X<get_cv> |
| 5242 | |
| 5243 | =item Embedding Functions |
| 5244 | |
| 5245 | cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook |
| 5246 | X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct |
| 5247 | X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>, |
| 5248 | perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv> |
| 5249 | |
| 5250 | =item Functions in file pp_pack.c |
| 5251 | |
| 5252 | packlist X<packlist>, pack_cat X<pack_cat>, unpackstring X<unpackstring>, |
| 5253 | unpack_str X<unpack_str> |
| 5254 | |
| 5255 | =item Global Variables |
| 5256 | |
| 5257 | PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>, |
| 5258 | PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes> |
| 5259 | |
| 5260 | =item GV Functions |
| 5261 | |
| 5262 | GvSV X<GvSV>, gv_fetchmeth X<gv_fetchmeth>, gv_fetchmethod |
| 5263 | X<gv_fetchmethod>, gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, |
| 5264 | gv_fetchmeth_autoload X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, |
| 5265 | gv_stashpvn X<gv_stashpvn>, gv_stashsv X<gv_stashsv> |
| 5266 | |
| 5267 | =item Handy Values |
| 5268 | |
| 5269 | Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>, |
| 5270 | Nullsv X<Nullsv> |
| 5271 | |
| 5272 | =item Hash Manipulation Functions |
| 5273 | |
| 5274 | get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>, |
| 5275 | HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force |
| 5276 | X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME |
| 5277 | X<HvNAME>, hv_clear X<hv_clear>, hv_clear_placeholders |
| 5278 | X<hv_clear_placeholders>, hv_delete X<hv_delete>, hv_delete_ent |
| 5279 | X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent X<hv_exists_ent>, |
| 5280 | hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>, hv_iterinit |
| 5281 | X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, |
| 5282 | hv_iternext X<hv_iternext>, hv_iternextsv X<hv_iternextsv>, |
| 5283 | hv_iternext_flags X<hv_iternext_flags>, hv_iterval X<hv_iterval>, hv_magic |
| 5284 | X<hv_magic>, hv_scalar X<hv_scalar>, hv_store X<hv_store>, hv_store_ent |
| 5285 | X<hv_store_ent>, hv_undef X<hv_undef>, newHV X<newHV> |
| 5286 | |
| 5287 | =item Magical Functions |
| 5288 | |
| 5289 | mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free |
| 5290 | X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical |
| 5291 | X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK |
| 5292 | X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>, |
| 5293 | SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>, |
| 5294 | SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK |
| 5295 | X<SvUNLOCK> |
| 5296 | |
| 5297 | =item Memory Management |
| 5298 | |
| 5299 | Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>, |
| 5300 | Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, Renew X<Renew>, Renewc |
| 5301 | X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>, |
| 5302 | savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, StructCopy |
| 5303 | X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD> |
| 5304 | |
| 5305 | =item Miscellaneous Functions |
| 5306 | |
| 5307 | fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv |
| 5308 | X<getcwd_sv>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE |
| 5309 | X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE |
| 5310 | X<strnNE>, sv_nolocking X<sv_nolocking>, sv_nosharing X<sv_nosharing>, |
| 5311 | sv_nounlocking X<sv_nounlocking> |
| 5312 | |
| 5313 | =item Numeric functions |
| 5314 | |
| 5315 | grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>, |
| 5316 | grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>, scan_bin |
| 5317 | X<scan_bin>, scan_hex X<scan_hex>, scan_oct X<scan_oct> |
| 5318 | |
| 5319 | =item Optree Manipulation Functions |
| 5320 | |
| 5321 | cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS> |
| 5322 | |
| 5323 | =item Pad Data Structures |
| 5324 | |
| 5325 | pad_sv X<pad_sv> |
| 5326 | |
| 5327 | =item Stack Manipulation Macros |
| 5328 | |
| 5329 | dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK |
| 5330 | X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu |
| 5331 | X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>, |
| 5332 | mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn |
| 5333 | X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs |
| 5334 | X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>, |
| 5335 | PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK |
| 5336 | X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal |
| 5337 | X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>, |
| 5338 | XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>, |
| 5339 | XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV |
| 5340 | X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF |
| 5341 | X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES |
| 5342 | X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV |
| 5343 | X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES |
| 5344 | X<XST_mYES> |
| 5345 | |
| 5346 | =item SV Flags |
| 5347 | |
| 5348 | svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>, |
| 5349 | SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG |
| 5350 | X<SVt_PVMG> |
| 5351 | |
| 5352 | =item SV Manipulation Functions |
| 5353 | |
| 5354 | get_sv X<get_sv>, looks_like_number X<looks_like_number>, newRV_inc |
| 5355 | X<newRV_inc>, newRV_noinc X<newRV_noinc>, NEWSV X<NEWSV>, newSV X<newSV>, |
| 5356 | newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, newSVpv |
| 5357 | X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, newSVpvn_share |
| 5358 | X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv |
| 5359 | X<newSVuv>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>, SvEND X<SvEND>, SvGROW |
| 5360 | X<SvGROW>, SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, |
| 5361 | SvIOK_off X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, |
| 5362 | SvIOK_only_UV X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>, |
| 5363 | SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>, |
| 5364 | SvIVx X<SvIVx>, SvIV_set X<SvIV_set>, SvLEN X<SvLEN>, SvLEN_set |
| 5365 | X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK X<SvNIOK>, SvNIOKp |
| 5366 | X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>, SvNOKp X<SvNOKp>, |
| 5367 | SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only X<SvNOK_only>, |
| 5368 | SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set X<SvNV_set>, SvOK |
| 5369 | X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp X<SvPOKp>, SvPOK_off |
| 5370 | X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only X<SvPOK_only>, |
| 5371 | SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte X<SvPVbyte>, |
| 5372 | SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>, SvPVbyte_force |
| 5373 | X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>, SvPVutf8 X<SvPVutf8>, |
| 5374 | SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force X<SvPVutf8x_force>, SvPVutf8_force |
| 5375 | X<SvPVutf8_force>, SvPVutf8_nolen X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx |
| 5376 | X<SvPVx>, SvPV_force X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, |
| 5377 | SvPV_nolen X<SvPV_nolen>, SvPV_set X<SvPV_set>, SvREFCNT X<SvREFCNT>, |
| 5378 | SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>, SvROK X<SvROK>, |
| 5379 | SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>, SvRV_set |
| 5380 | X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>, SvTAINT |
| 5381 | X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>, |
| 5382 | SvTAINTED_on X<SvTAINTED_on>, SvTRUE X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK |
| 5383 | X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off |
| 5384 | X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx |
| 5385 | X<SvUVx>, SvUV_set X<SvUV_set>, sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, |
| 5386 | sv_2io X<sv_2io>, sv_2iv X<sv_2iv>, sv_2mortal X<sv_2mortal>, sv_2nv |
| 5387 | X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvbyte_nolen X<sv_2pvbyte_nolen>, |
| 5388 | sv_2pvutf8 X<sv_2pvutf8>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, |
| 5389 | sv_2pv_flags X<sv_2pv_flags>, sv_2pv_nolen X<sv_2pv_nolen>, sv_2uv |
| 5390 | X<sv_2uv>, sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv |
| 5391 | X<sv_catpv>, sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>, |
| 5392 | sv_catpvn X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvn_mg |
| 5393 | X<sv_catpvn_mg>, sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catpv_mg |
| 5394 | X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>, |
| 5395 | sv_catsv_mg X<sv_catsv_mg>, sv_catsv_nomg X<sv_catsv_nomg>, sv_chop |
| 5396 | X<sv_chop>, sv_clear X<sv_clear>, sv_cmp X<sv_cmp>, sv_cmp_locale |
| 5397 | X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>, sv_copypv X<sv_copypv>, |
| 5398 | sv_dec X<sv_dec>, sv_derived_from X<sv_derived_from>, sv_eq X<sv_eq>, |
| 5399 | sv_force_normal X<sv_force_normal>, sv_force_normal_flags |
| 5400 | X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets X<sv_gets>, sv_grow |
| 5401 | X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>, sv_isa X<sv_isa>, |
| 5402 | sv_isobject X<sv_isobject>, sv_iv X<sv_iv>, sv_len X<sv_len>, sv_len_utf8 |
| 5403 | X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>, |
| 5404 | sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref |
| 5405 | X<sv_newref>, sv_nv X<sv_nv>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b |
| 5406 | X<sv_pos_u2b>, sv_pv X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten |
| 5407 | X<sv_pvbyten>, sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn X<sv_pvn>, |
| 5408 | sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags X<sv_pvn_force_flags>, |
| 5409 | sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_pvutf8n_force |
| 5410 | X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>, |
| 5411 | sv_report_used X<sv_report_used>, sv_reset X<sv_reset>, sv_rvweaken |
| 5412 | X<sv_rvweaken>, sv_setiv X<sv_setiv>, sv_setiv_mg X<sv_setiv_mg>, sv_setnv |
| 5413 | X<sv_setnv>, sv_setnv_mg X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf |
| 5414 | X<sv_setpvf>, sv_setpvf_mg X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, |
| 5415 | sv_setpviv_mg X<sv_setpviv_mg>, sv_setpvn X<sv_setpvn>, sv_setpvn_mg |
| 5416 | X<sv_setpvn_mg>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, |
| 5417 | sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn |
| 5418 | X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>, |
| 5419 | sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setsv_nomg |
| 5420 | X<sv_setsv_nomg>, sv_setuv X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, |
| 5421 | sv_taint X<sv_taint>, sv_tainted X<sv_tainted>, sv_true X<sv_true>, |
| 5422 | sv_unmagic X<sv_unmagic>, sv_unref X<sv_unref>, sv_unref_flags |
| 5423 | X<sv_unref_flags>, sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, |
| 5424 | sv_usepvn X<sv_usepvn>, sv_usepvn_mg X<sv_usepvn_mg>, sv_utf8_decode |
| 5425 | X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode |
| 5426 | X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>, |
| 5427 | sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_uv X<sv_uv>, sv_vcatpvf |
| 5428 | X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, |
| 5429 | sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg |
| 5430 | X<sv_vsetpvf_mg> |
| 5431 | |
| 5432 | =item Unicode Support |
| 5433 | |
| 5434 | bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>, |
| 5435 | ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string |
| 5436 | X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>, |
| 5437 | is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display |
| 5438 | X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8 |
| 5439 | X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case |
| 5440 | X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower |
| 5441 | X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper |
| 5442 | X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni |
| 5443 | X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>, |
| 5444 | utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr |
| 5445 | X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8 |
| 5446 | X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags> |
| 5447 | |
| 5448 | =item Variables created by C<xsubpp> and C<xsubpp> internal functions |
| 5449 | |
| 5450 | ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>, |
| 5451 | dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items X<items>, ix X<ix>, newXSproto |
| 5452 | X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>, THIS X<THIS>, XS X<XS>, |
| 5453 | XS_VERSION X<XS_VERSION>, XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK> |
| 5454 | |
| 5455 | =item Warning and Dieing |
| 5456 | |
| 5457 | croak X<croak>, warn X<warn> |
| 5458 | |
| 5459 | =item AUTHORS |
| 5460 | |
| 5461 | =item SEE ALSO |
| 5462 | |
| 5463 | =back |
| 5464 | |
| 5465 | =head2 perlintern - autogenerated documentation of purely B<internal> |
| 5466 | Perl functions |
| 5467 | |
| 5468 | =over 4 |
| 5469 | |
| 5470 | =item DESCRIPTION |
| 5471 | X<internal Perl functions> X<interpreter functions> |
| 5472 | |
| 5473 | =item CV reference counts and CvOUTSIDE |
| 5474 | |
| 5475 | CvWEAKOUTSIDE X<CvWEAKOUTSIDE> |
| 5476 | |
| 5477 | =item Functions in file pad.h |
| 5478 | |
| 5479 | CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV |
| 5480 | X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS |
| 5481 | X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>, |
| 5482 | PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH |
| 5483 | X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>, |
| 5484 | PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>, |
| 5485 | PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>, |
| 5486 | PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>, |
| 5487 | PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>, |
| 5488 | PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>, |
| 5489 | SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV> |
| 5490 | |
| 5491 | =item Functions in file pp_ctl.c |
| 5492 | |
| 5493 | find_runcv X<find_runcv> |
| 5494 | |
| 5495 | =item Global Variables |
| 5496 | |
| 5497 | PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>, |
| 5498 | PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv |
| 5499 | X<PL_ofs_sv>, PL_rs X<PL_rs> |
| 5500 | |
| 5501 | =item GV Functions |
| 5502 | |
| 5503 | is_gv_magical X<is_gv_magical> |
| 5504 | |
| 5505 | =item IO Functions |
| 5506 | |
| 5507 | start_glob X<start_glob> |
| 5508 | |
| 5509 | =item Pad Data Structures |
| 5510 | |
| 5511 | CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>, |
| 5512 | do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon |
| 5513 | X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>, |
| 5514 | pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>, |
| 5515 | pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons |
| 5516 | X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>, |
| 5517 | pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv |
| 5518 | X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef |
| 5519 | X<pad_undef> |
| 5520 | |
| 5521 | =item Stack Manipulation Macros |
| 5522 | |
| 5523 | djSP X<djSP>, LVRET X<LVRET> |
| 5524 | |
| 5525 | =item SV Manipulation Functions |
| 5526 | |
| 5527 | report_uninit X<report_uninit>, sv_add_arena X<sv_add_arena>, sv_clean_all |
| 5528 | X<sv_clean_all>, sv_clean_objs X<sv_clean_objs>, sv_free_arenas |
| 5529 | X<sv_free_arenas> |
| 5530 | |
| 5531 | =item AUTHORS |
| 5532 | |
| 5533 | =item SEE ALSO |
| 5534 | |
| 5535 | =back |
| 5536 | |
| 5537 | =head2 perliol - C API for Perl's implementation of IO in Layers. |
| 5538 | |
| 5539 | =over 4 |
| 5540 | |
| 5541 | =item SYNOPSIS |
| 5542 | |
| 5543 | =item DESCRIPTION |
| 5544 | |
| 5545 | =over 4 |
| 5546 | |
| 5547 | =item History and Background |
| 5548 | |
| 5549 | =item Basic Structure |
| 5550 | |
| 5551 | =item Layers vs Disciplines |
| 5552 | |
| 5553 | =item Data Structures |
| 5554 | |
| 5555 | =item Functions and Attributes |
| 5556 | |
| 5557 | =item Per-instance Data |
| 5558 | |
| 5559 | =item Layers in action. |
| 5560 | |
| 5561 | =item Per-instance flag bits |
| 5562 | |
| 5563 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, |
| 5564 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, |
| 5565 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, |
| 5566 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS |
| 5567 | |
| 5568 | =item Methods in Detail |
| 5569 | |
| 5570 | fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, |
| 5571 | PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, |
| 5572 | Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, |
| 5573 | Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, |
| 5574 | Set_ptrcnt |
| 5575 | |
| 5576 | =item Utilities |
| 5577 | |
| 5578 | =item Implementing PerlIO Layers |
| 5579 | |
| 5580 | C implementations, Perl implementations |
| 5581 | |
| 5582 | =item Core Layers |
| 5583 | |
| 5584 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" |
| 5585 | |
| 5586 | =item Extension Layers |
| 5587 | |
| 5588 | ":encoding", ":scalar", ":via" |
| 5589 | |
| 5590 | =back |
| 5591 | |
| 5592 | =item TODO |
| 5593 | |
| 5594 | =back |
| 5595 | |
| 5596 | =head2 perlapio - perl's IO abstraction interface. |
| 5597 | |
| 5598 | =over 4 |
| 5599 | |
| 5600 | =item SYNOPSIS |
| 5601 | |
| 5602 | =item DESCRIPTION |
| 5603 | |
| 5604 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, |
| 5605 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, |
| 5606 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, |
| 5607 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, |
| 5608 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, |
| 5609 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, |
| 5610 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, |
| 5611 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, |
| 5612 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, |
| 5613 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, |
| 5614 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> |
| 5615 | |
| 5616 | =over 4 |
| 5617 | |
| 5618 | =item Co-existence with stdio |
| 5619 | |
| 5620 | B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>, |
| 5621 | B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)> |
| 5622 | |
| 5623 | =item "Fast gets" Functions |
| 5624 | |
| 5625 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, |
| 5626 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, |
| 5627 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, |
| 5628 | B<PerlIO_get_bufsiz(f)> |
| 5629 | |
| 5630 | =item Other Functions |
| 5631 | |
| 5632 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), |
| 5633 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) |
| 5634 | |
| 5635 | =back |
| 5636 | |
| 5637 | =back |
| 5638 | |
| 5639 | =head2 perlhack - How to hack at the Perl internals |
| 5640 | |
| 5641 | =over 4 |
| 5642 | |
| 5643 | =item DESCRIPTION |
| 5644 | |
| 5645 | Does concept match the general goals of Perl?, Where is the |
| 5646 | implementation?, Backwards compatibility, Could it be a module instead?, Is |
| 5647 | the feature generic enough?, Does it potentially introduce new bugs?, Does |
| 5648 | it preclude other desirable features?, Is the implementation robust?, Is |
| 5649 | the implementation generic enough to be portable?, Is the implementation |
| 5650 | tested?, Is there enough documentation?, Is there another way to do it?, |
| 5651 | Does it create too much work?, Patches speak louder than words |
| 5652 | |
| 5653 | =over 4 |
| 5654 | |
| 5655 | =item Keeping in sync |
| 5656 | |
| 5657 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the |
| 5658 | NFS, rsync'ing the patches |
| 5659 | |
| 5660 | =item Why rsync the source tree |
| 5661 | |
| 5662 | It's easier to rsync the source tree, It's more reliable |
| 5663 | |
| 5664 | =item Why rsync the patches |
| 5665 | |
| 5666 | It's easier to rsync the patches, It's a good reference, Finding a start |
| 5667 | point, Finding how to fix a bug, Finding the source of misbehaviour |
| 5668 | |
| 5669 | =item Working with the source |
| 5670 | |
| 5671 | =item Perlbug administration |
| 5672 | |
| 5673 | =item Submitting patches |
| 5674 | |
| 5675 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, |
| 5676 | F<Porting/pumpkin.pod>, The perl5-porters FAQ |
| 5677 | |
| 5678 | =item Finding Your Way Around |
| 5679 | |
| 5680 | Core modules, Tests, Documentation, Configure, Interpreter |
| 5681 | |
| 5682 | =item Elements of the interpreter |
| 5683 | |
| 5684 | Startup, Parsing, Optimization, Running, Exception handing |
| 5685 | |
| 5686 | =item Internal Variable Types |
| 5687 | |
| 5688 | =item Op Trees |
| 5689 | |
| 5690 | =item Stacks |
| 5691 | |
| 5692 | Argument stack, Mark stack, Save stack |
| 5693 | |
| 5694 | =item Millions of Macros |
| 5695 | |
| 5696 | =item The .i Targets |
| 5697 | |
| 5698 | =item Poking at Perl |
| 5699 | |
| 5700 | =item Using a source-level debugger |
| 5701 | |
| 5702 | run [args], break function_name, break source.c:xxx, step, next, continue, |
| 5703 | finish, 'enter', print |
| 5704 | |
| 5705 | =item gdb macro support |
| 5706 | |
| 5707 | =item Dumping Perl Data Structures |
| 5708 | |
| 5709 | =item Patching |
| 5710 | |
| 5711 | =item Patching a core module |
| 5712 | |
| 5713 | =item Adding a new function to the core |
| 5714 | |
| 5715 | =item Writing a test |
| 5716 | |
| 5717 | F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, |
| 5718 | F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp, |
| 5719 | t/cmd t/run t/io t/op, t/lib ext lib |
| 5720 | |
| 5721 | =item Special Make Test Targets |
| 5722 | |
| 5723 | coretest, test.deparse, test.taintwarn, minitest, test.valgrind |
| 5724 | check.valgrind utest.valgrind ucheck.valgrind, test.third check.third |
| 5725 | utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 |
| 5726 | check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty |
| 5727 | |
| 5728 | =item Running tests by hand |
| 5729 | |
| 5730 | -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1, |
| 5731 | PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST |
| 5732 | |
| 5733 | =back |
| 5734 | |
| 5735 | =item EXTERNAL TOOLS FOR DEBUGGING PERL |
| 5736 | |
| 5737 | =over 4 |
| 5738 | |
| 5739 | =item Rational Software's Purify |
| 5740 | |
| 5741 | =item Purify on Unix |
| 5742 | |
| 5743 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity |
| 5744 | |
| 5745 | =item Purify on NT |
| 5746 | |
| 5747 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug |
| 5748 | |
| 5749 | =item valgrind |
| 5750 | |
| 5751 | =item Compaq's/Digital's/HP's Third Degree |
| 5752 | |
| 5753 | =item PERL_DESTRUCT_LEVEL |
| 5754 | |
| 5755 | =item Profiling |
| 5756 | |
| 5757 | =item Gprof Profiling |
| 5758 | |
| 5759 | -a, -b, -e routine, -f routine, -s, -z |
| 5760 | |
| 5761 | =item GCC gcov Profiling |
| 5762 | |
| 5763 | =item Pixie Profiling |
| 5764 | |
| 5765 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, |
| 5766 | -z[ero] |
| 5767 | |
| 5768 | =item Miscellaneous tricks |
| 5769 | |
| 5770 | =item CONCLUSION |
| 5771 | |
| 5772 | I<The Road goes ever on and on, down from the door where it began.> |
| 5773 | |
| 5774 | =back |
| 5775 | |
| 5776 | =item AUTHOR |
| 5777 | |
| 5778 | =back |
| 5779 | |
| 5780 | =head2 perlbook - Perl book information |
| 5781 | |
| 5782 | =over 4 |
| 5783 | |
| 5784 | =item DESCRIPTION |
| 5785 | |
| 5786 | =back |
| 5787 | |
| 5788 | =head2 perltodo - Perl TO-DO List |
| 5789 | |
| 5790 | =over 4 |
| 5791 | |
| 5792 | =item DESCRIPTION |
| 5793 | |
| 5794 | =item The roadmap to 5.10 |
| 5795 | |
| 5796 | =over 4 |
| 5797 | |
| 5798 | =item Needed for a 5.9.4 release |
| 5799 | |
| 5800 | =item Needed for a 5.9.5 release |
| 5801 | |
| 5802 | Implement L</_ prototype character>, Implement L</state variables> |
| 5803 | |
| 5804 | =item Needed for a 5.9.6 release |
| 5805 | |
| 5806 | =back |
| 5807 | |
| 5808 | =item Tasks that only need Perl knowledge |
| 5809 | |
| 5810 | =over 4 |
| 5811 | |
| 5812 | =item common test code for timed bail out |
| 5813 | |
| 5814 | =item POD -> HTML conversion in the core still sucks |
| 5815 | |
| 5816 | =item Parallel testing |
| 5817 | |
| 5818 | =item Make Schwern poorer |
| 5819 | |
| 5820 | =item Improve the coverage of the core tests |
| 5821 | |
| 5822 | =item test B |
| 5823 | |
| 5824 | =item A decent benchmark |
| 5825 | |
| 5826 | =item fix tainting bugs |
| 5827 | |
| 5828 | =item Dual life everything |
| 5829 | |
| 5830 | =item Improving C<threads::shared> |
| 5831 | |
| 5832 | =item POSIX memory footprint |
| 5833 | |
| 5834 | =back |
| 5835 | |
| 5836 | =item Tasks that need a little sysadmin-type knowledge |
| 5837 | |
| 5838 | =over 4 |
| 5839 | |
| 5840 | =item Relocatable perl |
| 5841 | |
| 5842 | =item make HTML install work |
| 5843 | |
| 5844 | =item compressed man pages |
| 5845 | |
| 5846 | =item Add a code coverage target to the Makefile |
| 5847 | |
| 5848 | =item Make Config.pm cope with differences between build and installed perl |
| 5849 | |
| 5850 | =item make parallel builds work |
| 5851 | |
| 5852 | =item linker specification files |
| 5853 | |
| 5854 | =back |
| 5855 | |
| 5856 | =item Tasks that need a little C knowledge |
| 5857 | |
| 5858 | =over 4 |
| 5859 | |
| 5860 | =item Make it clear from -v if this is the exact official release |
| 5861 | |
| 5862 | =item Tidy up global variables |
| 5863 | |
| 5864 | =item Ordering of "global" variables. |
| 5865 | |
| 5866 | =item bincompat functions |
| 5867 | |
| 5868 | =item am I hot or not? |
| 5869 | |
| 5870 | =item emulate the per-thread memory pool on Unix |
| 5871 | |
| 5872 | =item reduce duplication in sv_setsv_flags |
| 5873 | |
| 5874 | =back |
| 5875 | |
| 5876 | =item Tasks that need a knowledge of XS |
| 5877 | |
| 5878 | =over 4 |
| 5879 | |
| 5880 | =item IPv6 |
| 5881 | |
| 5882 | =item shrink C<GV>s, C<CV>s |
| 5883 | |
| 5884 | =item merge Perl_sv_2[inpu]v |
| 5885 | |
| 5886 | =item UTF8 caching code |
| 5887 | |
| 5888 | =item Implicit Latin 1 => Unicode translation |
| 5889 | |
| 5890 | =item autovivification |
| 5891 | |
| 5892 | =item Unicode in Filenames |
| 5893 | |
| 5894 | =item Unicode in %ENV |
| 5895 | |
| 5896 | =item use less 'memory' |
| 5897 | |
| 5898 | =item Re-implement C<:unique> in a way that is actually thread-safe |
| 5899 | |
| 5900 | =item Make tainting consistent |
| 5901 | |
| 5902 | =item readpipe(LIST) |
| 5903 | |
| 5904 | =back |
| 5905 | |
| 5906 | =item Tasks that need a knowledge of the interpreter |
| 5907 | |
| 5908 | =over 4 |
| 5909 | |
| 5910 | =item lexical pragmas |
| 5911 | |
| 5912 | =item Attach/detach debugger from running program |
| 5913 | |
| 5914 | =item Constant folding |
| 5915 | |
| 5916 | =item LVALUE functions for lists |
| 5917 | |
| 5918 | =item LVALUE functions in the debugger |
| 5919 | |
| 5920 | =item _ prototype character |
| 5921 | |
| 5922 | =item state variables |
| 5923 | |
| 5924 | =item @INC source filter to Filter::Simple |
| 5925 | |
| 5926 | =item regexp optimiser optional |
| 5927 | |
| 5928 | =item UNITCHECK |
| 5929 | |
| 5930 | =item optional optimizer |
| 5931 | |
| 5932 | =item You WANT *how* many |
| 5933 | |
| 5934 | =item lexical aliases |
| 5935 | |
| 5936 | =item entersub XS vs Perl |
| 5937 | |
| 5938 | =item Self ties |
| 5939 | |
| 5940 | =item Optimize away @_ |
| 5941 | |
| 5942 | =item What hooks would assertions need? |
| 5943 | |
| 5944 | =back |
| 5945 | |
| 5946 | =item Big projects |
| 5947 | |
| 5948 | =over 4 |
| 5949 | |
| 5950 | =item make ithreads more robust |
| 5951 | |
| 5952 | =item iCOW |
| 5953 | |
| 5954 | =item (?{...}) closures in regexps |
| 5955 | |
| 5956 | =item A re-entrant regexp engine |
| 5957 | |
| 5958 | =back |
| 5959 | |
| 5960 | =back |
| 5961 | |
| 5962 | =head2 perldoc - Look up Perl documentation in Pod format. |
| 5963 | |
| 5964 | =over 4 |
| 5965 | |
| 5966 | =item SYNOPSIS |
| 5967 | |
| 5968 | =item DESCRIPTION |
| 5969 | |
| 5970 | =item OPTIONS |
| 5971 | |
| 5972 | B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f> |
| 5973 | I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d> |
| 5974 | I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>, |
| 5975 | B<-w> I<option:value> or B<-w> I<option>, B<-X>, |
| 5976 | B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>, |
| 5977 | B<-V> |
| 5978 | |
| 5979 | =item SECURITY |
| 5980 | |
| 5981 | =item ENVIRONMENT |
| 5982 | |
| 5983 | =item AUTHOR |
| 5984 | |
| 5985 | =back |
| 5986 | |
| 5987 | =head2 perlhist - the Perl history records |
| 5988 | |
| 5989 | =over 4 |
| 5990 | |
| 5991 | =item DESCRIPTION |
| 5992 | |
| 5993 | =item INTRODUCTION |
| 5994 | |
| 5995 | =item THE KEEPERS OF THE PUMPKIN |
| 5996 | |
| 5997 | =over 4 |
| 5998 | |
| 5999 | =item PUMPKIN? |
| 6000 | |
| 6001 | =back |
| 6002 | |
| 6003 | =item THE RECORDS |
| 6004 | |
| 6005 | =over 4 |
| 6006 | |
| 6007 | =item SELECTED RELEASE SIZES |
| 6008 | |
| 6009 | =item SELECTED PATCH SIZES |
| 6010 | |
| 6011 | =back |
| 6012 | |
| 6013 | =item THE KEEPERS OF THE RECORDS |
| 6014 | |
| 6015 | =back |
| 6016 | |
| 6017 | =head2 perldelta - what is new for perl v5.8.8 |
| 6018 | |
| 6019 | =over 4 |
| 6020 | |
| 6021 | =item DESCRIPTION |
| 6022 | |
| 6023 | =item Incompatible Changes |
| 6024 | |
| 6025 | =item Core Enhancements |
| 6026 | |
| 6027 | =item Modules and Pragmata |
| 6028 | |
| 6029 | =item Utility Changes |
| 6030 | |
| 6031 | =item New Documentation |
| 6032 | |
| 6033 | =item Performance Enhancements |
| 6034 | |
| 6035 | =item Installation and Configuration Improvements |
| 6036 | |
| 6037 | =item Selected Bug Fixes |
| 6038 | |
| 6039 | =item New or Changed Diagnostics |
| 6040 | |
| 6041 | =item Changed Internals |
| 6042 | |
| 6043 | =item New Tests |
| 6044 | |
| 6045 | =item Known Problems |
| 6046 | |
| 6047 | =item Platform Specific Problems |
| 6048 | |
| 6049 | =item Reporting Bugs |
| 6050 | |
| 6051 | =item SEE ALSO |
| 6052 | |
| 6053 | =back |
| 6054 | |
| 6055 | =head2 perl588delta, perldelta - what is new for perl v5.8.8 |
| 6056 | |
| 6057 | =over 4 |
| 6058 | |
| 6059 | =item DESCRIPTION |
| 6060 | |
| 6061 | =item Incompatible Changes |
| 6062 | |
| 6063 | =item Core Enhancements |
| 6064 | |
| 6065 | =item Modules and Pragmata |
| 6066 | |
| 6067 | =item Utility Changes |
| 6068 | |
| 6069 | =item New Documentation |
| 6070 | |
| 6071 | =item Performance Enhancements |
| 6072 | |
| 6073 | =item Installation and Configuration Improvements |
| 6074 | |
| 6075 | =item Selected Bug Fixes |
| 6076 | |
| 6077 | =item New or Changed Diagnostics |
| 6078 | |
| 6079 | =item Changed Internals |
| 6080 | |
| 6081 | =item New Tests |
| 6082 | |
| 6083 | =item Known Problems |
| 6084 | |
| 6085 | =item Platform Specific Problems |
| 6086 | |
| 6087 | =item Reporting Bugs |
| 6088 | |
| 6089 | =item SEE ALSO |
| 6090 | |
| 6091 | =back |
| 6092 | |
| 6093 | =head2 perl587delta, perldelta - what is new for perl v5.8.7 |
| 6094 | |
| 6095 | =over 4 |
| 6096 | |
| 6097 | =item DESCRIPTION |
| 6098 | |
| 6099 | =item Incompatible Changes |
| 6100 | |
| 6101 | =item Core Enhancements |
| 6102 | |
| 6103 | =over 4 |
| 6104 | |
| 6105 | =item Unicode Character Database 4.1.0 |
| 6106 | |
| 6107 | =item suidperl less insecure |
| 6108 | |
| 6109 | =item Optional site customization script |
| 6110 | |
| 6111 | =item C<Config.pm> is now much smaller. |
| 6112 | |
| 6113 | =back |
| 6114 | |
| 6115 | =item Modules and Pragmata |
| 6116 | |
| 6117 | =item Utility Changes |
| 6118 | |
| 6119 | =over 4 |
| 6120 | |
| 6121 | =item find2perl enhancements |
| 6122 | |
| 6123 | =back |
| 6124 | |
| 6125 | =item Performance Enhancements |
| 6126 | |
| 6127 | =item Installation and Configuration Improvements |
| 6128 | |
| 6129 | =item Selected Bug Fixes |
| 6130 | |
| 6131 | =item New or Changed Diagnostics |
| 6132 | |
| 6133 | =item Changed Internals |
| 6134 | |
| 6135 | =item Known Problems |
| 6136 | |
| 6137 | =item Platform Specific Problems |
| 6138 | |
| 6139 | =item Reporting Bugs |
| 6140 | |
| 6141 | =item SEE ALSO |
| 6142 | |
| 6143 | =back |
| 6144 | |
| 6145 | =head2 perl586delta - what is new for perl v5.8.6 |
| 6146 | |
| 6147 | =over 4 |
| 6148 | |
| 6149 | =item DESCRIPTION |
| 6150 | |
| 6151 | =item Incompatible Changes |
| 6152 | |
| 6153 | =item Core Enhancements |
| 6154 | |
| 6155 | =item Modules and Pragmata |
| 6156 | |
| 6157 | =item Utility Changes |
| 6158 | |
| 6159 | =item Performance Enhancements |
| 6160 | |
| 6161 | =item Selected Bug Fixes |
| 6162 | |
| 6163 | =item New or Changed Diagnostics |
| 6164 | |
| 6165 | =item Changed Internals |
| 6166 | |
| 6167 | =item New Tests |
| 6168 | |
| 6169 | =item Reporting Bugs |
| 6170 | |
| 6171 | =item SEE ALSO |
| 6172 | |
| 6173 | =back |
| 6174 | |
| 6175 | =head2 perl585delta - what is new for perl v5.8.5 |
| 6176 | |
| 6177 | =over 4 |
| 6178 | |
| 6179 | =item DESCRIPTION |
| 6180 | |
| 6181 | =item Incompatible Changes |
| 6182 | |
| 6183 | =item Core Enhancements |
| 6184 | |
| 6185 | =item Modules and Pragmata |
| 6186 | |
| 6187 | =item Utility Changes |
| 6188 | |
| 6189 | =over 4 |
| 6190 | |
| 6191 | =item Perl's debugger |
| 6192 | |
| 6193 | =item h2ph |
| 6194 | |
| 6195 | =back |
| 6196 | |
| 6197 | =item Installation and Configuration Improvements |
| 6198 | |
| 6199 | =item Selected Bug Fixes |
| 6200 | |
| 6201 | =item New or Changed Diagnostics |
| 6202 | |
| 6203 | =item Changed Internals |
| 6204 | |
| 6205 | =item Known Problems |
| 6206 | |
| 6207 | =item Platform Specific Problems |
| 6208 | |
| 6209 | =item Reporting Bugs |
| 6210 | |
| 6211 | =item SEE ALSO |
| 6212 | |
| 6213 | =back |
| 6214 | |
| 6215 | =head2 perl584delta - what is new for perl v5.8.4 |
| 6216 | |
| 6217 | =over 4 |
| 6218 | |
| 6219 | =item DESCRIPTION |
| 6220 | |
| 6221 | =item Incompatible Changes |
| 6222 | |
| 6223 | =item Core Enhancements |
| 6224 | |
| 6225 | =over 4 |
| 6226 | |
| 6227 | =item Malloc wrapping |
| 6228 | |
| 6229 | =item Unicode Character Database 4.0.1 |
| 6230 | |
| 6231 | =item suidperl less insecure |
| 6232 | |
| 6233 | =item format |
| 6234 | |
| 6235 | =back |
| 6236 | |
| 6237 | =item Modules and Pragmata |
| 6238 | |
| 6239 | =over 4 |
| 6240 | |
| 6241 | =item Updated modules |
| 6242 | |
| 6243 | Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, |
| 6244 | IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, |
| 6245 | Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, |
| 6246 | Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, |
| 6247 | base, open, threads, utf8 |
| 6248 | |
| 6249 | =back |
| 6250 | |
| 6251 | =item Performance Enhancements |
| 6252 | |
| 6253 | =item Utility Changes |
| 6254 | |
| 6255 | =item Installation and Configuration Improvements |
| 6256 | |
| 6257 | =item Selected Bug Fixes |
| 6258 | |
| 6259 | =item New or Changed Diagnostics |
| 6260 | |
| 6261 | =item Changed Internals |
| 6262 | |
| 6263 | =item Future Directions |
| 6264 | |
| 6265 | =item Platform Specific Problems |
| 6266 | |
| 6267 | =item Reporting Bugs |
| 6268 | |
| 6269 | =item SEE ALSO |
| 6270 | |
| 6271 | =back |
| 6272 | |
| 6273 | =head2 perl583delta - what is new for perl v5.8.3 |
| 6274 | |
| 6275 | =over 4 |
| 6276 | |
| 6277 | =item DESCRIPTION |
| 6278 | |
| 6279 | =item Incompatible Changes |
| 6280 | |
| 6281 | =item Core Enhancements |
| 6282 | |
| 6283 | =item Modules and Pragmata |
| 6284 | |
| 6285 | CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util, |
| 6286 | Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate, |
| 6287 | Unicode::Normalize, Test::Harness, threads::shared |
| 6288 | |
| 6289 | =item Utility Changes |
| 6290 | |
| 6291 | =item New Documentation |
| 6292 | |
| 6293 | =item Installation and Configuration Improvements |
| 6294 | |
| 6295 | =item Selected Bug Fixes |
| 6296 | |
| 6297 | =item New or Changed Diagnostics |
| 6298 | |
| 6299 | =item Changed Internals |
| 6300 | |
| 6301 | =item Configuration and Building |
| 6302 | |
| 6303 | =item Platform Specific Problems |
| 6304 | |
| 6305 | =item Known Problems |
| 6306 | |
| 6307 | =item Future Directions |
| 6308 | |
| 6309 | =item Obituary |
| 6310 | |
| 6311 | =item Reporting Bugs |
| 6312 | |
| 6313 | =item SEE ALSO |
| 6314 | |
| 6315 | =back |
| 6316 | |
| 6317 | =head2 perl582delta - what is new for perl v5.8.2 |
| 6318 | |
| 6319 | =over 4 |
| 6320 | |
| 6321 | =item DESCRIPTION |
| 6322 | |
| 6323 | =item Incompatible Changes |
| 6324 | |
| 6325 | =item Core Enhancements |
| 6326 | |
| 6327 | =over 4 |
| 6328 | |
| 6329 | =item Hash Randomisation |
| 6330 | |
| 6331 | =item Threading |
| 6332 | |
| 6333 | =back |
| 6334 | |
| 6335 | =item Modules and Pragmata |
| 6336 | |
| 6337 | =over 4 |
| 6338 | |
| 6339 | =item Updated Modules And Pragmata |
| 6340 | |
| 6341 | Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64, |
| 6342 | Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate, |
| 6343 | Unicode::Normalize, UNIVERSAL |
| 6344 | |
| 6345 | =back |
| 6346 | |
| 6347 | =item Selected Bug Fixes |
| 6348 | |
| 6349 | =item Changed Internals |
| 6350 | |
| 6351 | =item Platform Specific Problems |
| 6352 | |
| 6353 | =item Future Directions |
| 6354 | |
| 6355 | =item Reporting Bugs |
| 6356 | |
| 6357 | =item SEE ALSO |
| 6358 | |
| 6359 | =back |
| 6360 | |
| 6361 | =head2 perl581delta - what is new for perl v5.8.1 |
| 6362 | |
| 6363 | =over 4 |
| 6364 | |
| 6365 | =item DESCRIPTION |
| 6366 | |
| 6367 | =item Incompatible Changes |
| 6368 | |
| 6369 | =over 4 |
| 6370 | |
| 6371 | =item Hash Randomisation |
| 6372 | |
| 6373 | =item UTF-8 On Filehandles No Longer Activated By Locale |
| 6374 | |
| 6375 | =item Single-number v-strings are no longer v-strings before "=>" |
| 6376 | |
| 6377 | =item (Win32) The -C Switch Has Been Repurposed |
| 6378 | |
| 6379 | =item (Win32) The /d Switch Of cmd.exe |
| 6380 | |
| 6381 | =back |
| 6382 | |
| 6383 | =item Core Enhancements |
| 6384 | |
| 6385 | =over 4 |
| 6386 | |
| 6387 | =item UTF-8 no longer default under UTF-8 locales |
| 6388 | |
| 6389 | =item Unsafe signals again available |
| 6390 | |
| 6391 | =item Tied Arrays with Negative Array Indices |
| 6392 | |
| 6393 | =item local ${$x} |
| 6394 | |
| 6395 | =item Unicode Character Database 4.0.0 |
| 6396 | |
| 6397 | =item Deprecation Warnings |
| 6398 | |
| 6399 | =item Miscellaneous Enhancements |
| 6400 | |
| 6401 | =back |
| 6402 | |
| 6403 | =item Modules and Pragmata |
| 6404 | |
| 6405 | =over 4 |
| 6406 | |
| 6407 | =item Updated Modules And Pragmata |
| 6408 | |
| 6409 | base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, |
| 6410 | CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, |
| 6411 | Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, |
| 6412 | PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, |
| 6413 | Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, |
| 6414 | Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, |
| 6415 | Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, |
| 6416 | Win32::GetOSVersion |
| 6417 | |
| 6418 | =back |
| 6419 | |
| 6420 | =item Utility Changes |
| 6421 | |
| 6422 | =item New Documentation |
| 6423 | |
| 6424 | =item Installation and Configuration Improvements |
| 6425 | |
| 6426 | =over 4 |
| 6427 | |
| 6428 | =item Platform-specific enhancements |
| 6429 | |
| 6430 | =back |
| 6431 | |
| 6432 | =item Selected Bug Fixes |
| 6433 | |
| 6434 | =over 4 |
| 6435 | |
| 6436 | =item Closures, eval and lexicals |
| 6437 | |
| 6438 | =item Generic fixes |
| 6439 | |
| 6440 | =item Platform-specific fixes |
| 6441 | |
| 6442 | =back |
| 6443 | |
| 6444 | =item New or Changed Diagnostics |
| 6445 | |
| 6446 | =over 4 |
| 6447 | |
| 6448 | =item Changed "A thread exited while %d threads were running" |
| 6449 | |
| 6450 | =item Removed "Attempt to clear a restricted hash" |
| 6451 | |
| 6452 | =item New "Illegal declaration of anonymous subroutine" |
| 6453 | |
| 6454 | =item Changed "Invalid range "%s" in transliteration operator" |
| 6455 | |
| 6456 | =item New "Missing control char name in \c" |
| 6457 | |
| 6458 | =item New "Newline in left-justified string for %s" |
| 6459 | |
| 6460 | =item New "Possible precedence problem on bitwise %c operator" |
| 6461 | |
| 6462 | =item New "Pseudo-hashes are deprecated" |
| 6463 | |
| 6464 | =item New "read() on %s filehandle %s" |
| 6465 | |
| 6466 | =item New "5.005 threads are deprecated" |
| 6467 | |
| 6468 | =item New "Tied variable freed while still in use" |
| 6469 | |
| 6470 | =item New "To%s: illegal mapping '%s'" |
| 6471 | |
| 6472 | =item New "Use of freed value in iteration" |
| 6473 | |
| 6474 | =back |
| 6475 | |
| 6476 | =item Changed Internals |
| 6477 | |
| 6478 | =item New Tests |
| 6479 | |
| 6480 | =item Known Problems |
| 6481 | |
| 6482 | =over 4 |
| 6483 | |
| 6484 | =item Tied hashes in scalar context |
| 6485 | |
| 6486 | =item Net::Ping 450_service and 510_ping_udp failures |
| 6487 | |
| 6488 | =item B::C |
| 6489 | |
| 6490 | =back |
| 6491 | |
| 6492 | =item Platform Specific Problems |
| 6493 | |
| 6494 | =over 4 |
| 6495 | |
| 6496 | =item EBCDIC Platforms |
| 6497 | |
| 6498 | =item Cygwin 1.5 problems |
| 6499 | |
| 6500 | =item HP-UX: HP cc warnings about sendfile and sendpath |
| 6501 | |
| 6502 | =item IRIX: t/uni/tr_7jis.t falsely failing |
| 6503 | |
| 6504 | =item Mac OS X: no usemymalloc |
| 6505 | |
| 6506 | =item Tru64: No threaded builds with GNU cc (gcc) |
| 6507 | |
| 6508 | =item Win32: sysopen, sysread, syswrite |
| 6509 | |
| 6510 | =back |
| 6511 | |
| 6512 | =item Future Directions |
| 6513 | |
| 6514 | =item Reporting Bugs |
| 6515 | |
| 6516 | =item SEE ALSO |
| 6517 | |
| 6518 | =back |
| 6519 | |
| 6520 | =head2 perl58delta - what is new for perl v5.8.0 |
| 6521 | |
| 6522 | =over 4 |
| 6523 | |
| 6524 | =item DESCRIPTION |
| 6525 | |
| 6526 | =item Highlights In 5.8.0 |
| 6527 | |
| 6528 | =item Incompatible Changes |
| 6529 | |
| 6530 | =over 4 |
| 6531 | |
| 6532 | =item Binary Incompatibility |
| 6533 | |
| 6534 | =item 64-bit platforms and malloc |
| 6535 | |
| 6536 | =item AIX Dynaloading |
| 6537 | |
| 6538 | =item Attributes for C<my> variables now handled at run-time |
| 6539 | |
| 6540 | =item Socket Extension Dynamic in VMS |
| 6541 | |
| 6542 | =item IEEE-format Floating Point Default on OpenVMS Alpha |
| 6543 | |
| 6544 | =item New Unicode Semantics (no more C<use utf8>, almost) |
| 6545 | |
| 6546 | =item New Unicode Properties |
| 6547 | |
| 6548 | =item REF(...) Instead Of SCALAR(...) |
| 6549 | |
| 6550 | =item pack/unpack D/F recycled |
| 6551 | |
| 6552 | =item glob() now returns filenames in alphabetical order |
| 6553 | |
| 6554 | =item Deprecations |
| 6555 | |
| 6556 | =back |
| 6557 | |
| 6558 | =item Core Enhancements |
| 6559 | |
| 6560 | =over 4 |
| 6561 | |
| 6562 | =item Unicode Overhaul |
| 6563 | |
| 6564 | =item PerlIO is Now The Default |
| 6565 | |
| 6566 | =item ithreads |
| 6567 | |
| 6568 | =item Restricted Hashes |
| 6569 | |
| 6570 | =item Safe Signals |
| 6571 | |
| 6572 | =item Understanding of Numbers |
| 6573 | |
| 6574 | =item Arrays now always interpolate into double-quoted strings [561] |
| 6575 | |
| 6576 | =item Miscellaneous Changes |
| 6577 | |
| 6578 | =back |
| 6579 | |
| 6580 | =item Modules and Pragmata |
| 6581 | |
| 6582 | =over 4 |
| 6583 | |
| 6584 | =item New Modules and Pragmata |
| 6585 | |
| 6586 | =item Updated And Improved Modules and Pragmata |
| 6587 | |
| 6588 | =back |
| 6589 | |
| 6590 | =item Utility Changes |
| 6591 | |
| 6592 | =item New Documentation |
| 6593 | |
| 6594 | =item Performance Enhancements |
| 6595 | |
| 6596 | =item Installation and Configuration Improvements |
| 6597 | |
| 6598 | =over 4 |
| 6599 | |
| 6600 | =item Generic Improvements |
| 6601 | |
| 6602 | =item New Or Improved Platforms |
| 6603 | |
| 6604 | =back |
| 6605 | |
| 6606 | =item Selected Bug Fixes |
| 6607 | |
| 6608 | =over 4 |
| 6609 | |
| 6610 | =item Platform Specific Changes and Fixes |
| 6611 | |
| 6612 | =back |
| 6613 | |
| 6614 | =item New or Changed Diagnostics |
| 6615 | |
| 6616 | =item Changed Internals |
| 6617 | |
| 6618 | =item Security Vulnerability Closed [561] |
| 6619 | |
| 6620 | =item New Tests |
| 6621 | |
| 6622 | =item Known Problems |
| 6623 | |
| 6624 | =over 4 |
| 6625 | |
| 6626 | =item The Compiler Suite Is Still Very Experimental |
| 6627 | |
| 6628 | =item Localising Tied Arrays and Hashes Is Broken |
| 6629 | |
| 6630 | =item Building Extensions Can Fail Because Of Largefiles |
| 6631 | |
| 6632 | =item Modifying $_ Inside for(..) |
| 6633 | |
| 6634 | =item mod_perl 1.26 Doesn't Build With Threaded Perl |
| 6635 | |
| 6636 | =item lib/ftmp-security tests warn 'system possibly insecure' |
| 6637 | |
| 6638 | =item libwww-perl (LWP) fails base/date #51 |
| 6639 | |
| 6640 | =item PDL failing some tests |
| 6641 | |
| 6642 | =item Perl_get_sv |
| 6643 | |
| 6644 | =item Self-tying Problems |
| 6645 | |
| 6646 | =item ext/threads/t/libc |
| 6647 | |
| 6648 | =item Failure of Thread (5.005-style) tests |
| 6649 | |
| 6650 | =item Timing problems |
| 6651 | |
| 6652 | =item Tied/Magical Array/Hash Elements Do Not Autovivify |
| 6653 | |
| 6654 | =item Unicode in package/class and subroutine names does not work |
| 6655 | |
| 6656 | =back |
| 6657 | |
| 6658 | =item Platform Specific Problems |
| 6659 | |
| 6660 | =over 4 |
| 6661 | |
| 6662 | =item AIX |
| 6663 | |
| 6664 | =item Alpha systems with old gccs fail several tests |
| 6665 | |
| 6666 | =item AmigaOS |
| 6667 | |
| 6668 | =item BeOS |
| 6669 | |
| 6670 | =item Cygwin "unable to remap" |
| 6671 | |
| 6672 | =item Cygwin ndbm tests fail on FAT |
| 6673 | |
| 6674 | =item DJGPP Failures |
| 6675 | |
| 6676 | =item FreeBSD built with ithreads coredumps reading large directories |
| 6677 | |
| 6678 | =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales |
| 6679 | |
| 6680 | =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 |
| 6681 | |
| 6682 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
| 6683 | |
| 6684 | =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint |
| 6685 | |
| 6686 | =item Linux With Sfio Fails op/misc Test 48 |
| 6687 | |
| 6688 | =item Mac OS X |
| 6689 | |
| 6690 | =item Mac OS X dyld undefined symbols |
| 6691 | |
| 6692 | =item OS/2 Test Failures |
| 6693 | |
| 6694 | =item op/sprintf tests 91, 129, and 130 |
| 6695 | |
| 6696 | =item SCO |
| 6697 | |
| 6698 | =item Solaris 2.5 |
| 6699 | |
| 6700 | =item Solaris x86 Fails Tests With -Duse64bitint |
| 6701 | |
| 6702 | =item SUPER-UX (NEC SX) |
| 6703 | |
| 6704 | =item Term::ReadKey not working on Win32 |
| 6705 | |
| 6706 | =item UNICOS/mk |
| 6707 | |
| 6708 | =item UTS |
| 6709 | |
| 6710 | =item VOS (Stratus) |
| 6711 | |
| 6712 | =item VMS |
| 6713 | |
| 6714 | =item Win32 |
| 6715 | |
| 6716 | =item XML::Parser not working |
| 6717 | |
| 6718 | =item z/OS (OS/390) |
| 6719 | |
| 6720 | =item Unicode Support on EBCDIC Still Spotty |
| 6721 | |
| 6722 | =item Seen In Perl 5.7 But Gone Now |
| 6723 | |
| 6724 | =back |
| 6725 | |
| 6726 | =item Reporting Bugs |
| 6727 | |
| 6728 | =item SEE ALSO |
| 6729 | |
| 6730 | =item HISTORY |
| 6731 | |
| 6732 | =back |
| 6733 | |
| 6734 | =head2 perl573delta - what's new for perl v5.7.3 |
| 6735 | |
| 6736 | =over 4 |
| 6737 | |
| 6738 | =item DESCRIPTION |
| 6739 | |
| 6740 | =item Changes |
| 6741 | |
| 6742 | =item Reporting Bugs |
| 6743 | |
| 6744 | =item SEE ALSO |
| 6745 | |
| 6746 | =item HISTORY |
| 6747 | |
| 6748 | =back |
| 6749 | |
| 6750 | =head2 perl572delta - what's new for perl v5.7.2 |
| 6751 | |
| 6752 | =over 4 |
| 6753 | |
| 6754 | =item DESCRIPTION |
| 6755 | |
| 6756 | =item Security Vulnerability Closed |
| 6757 | |
| 6758 | =item Incompatible Changes |
| 6759 | |
| 6760 | =over 4 |
| 6761 | |
| 6762 | =item 64-bit platforms and malloc |
| 6763 | |
| 6764 | =item AIX Dynaloading |
| 6765 | |
| 6766 | =item Socket Extension Dynamic in VMS |
| 6767 | |
| 6768 | =item Different Definition of the Unicode Character Classes \p{In...} |
| 6769 | |
| 6770 | =item Deprecations |
| 6771 | |
| 6772 | =back |
| 6773 | |
| 6774 | =item Core Enhancements |
| 6775 | |
| 6776 | =item Modules and Pragmata |
| 6777 | |
| 6778 | =over 4 |
| 6779 | |
| 6780 | =item New Modules and Distributions |
| 6781 | |
| 6782 | =item Updated And Improved Modules and Pragmata |
| 6783 | |
| 6784 | =back |
| 6785 | |
| 6786 | =item Utility Changes |
| 6787 | |
| 6788 | =item New Documentation |
| 6789 | |
| 6790 | =item Installation and Configuration Improvements |
| 6791 | |
| 6792 | =over 4 |
| 6793 | |
| 6794 | =item New Or Improved Platforms |
| 6795 | |
| 6796 | =item Generic Improvements |
| 6797 | |
| 6798 | =back |
| 6799 | |
| 6800 | =item Selected Bug Fixes |
| 6801 | |
| 6802 | =over 4 |
| 6803 | |
| 6804 | =item Platform Specific Changes and Fixes |
| 6805 | |
| 6806 | =back |
| 6807 | |
| 6808 | =item New or Changed Diagnostics |
| 6809 | |
| 6810 | =item Source Code Enhancements |
| 6811 | |
| 6812 | =over 4 |
| 6813 | |
| 6814 | =item MAGIC constants |
| 6815 | |
| 6816 | =item Better commented code |
| 6817 | |
| 6818 | =item Regex pre-/post-compilation items matched up |
| 6819 | |
| 6820 | =item gcc -Wall |
| 6821 | |
| 6822 | =back |
| 6823 | |
| 6824 | =item New Tests |
| 6825 | |
| 6826 | =item Known Problems |
| 6827 | |
| 6828 | =over 4 |
| 6829 | |
| 6830 | =item AIX |
| 6831 | |
| 6832 | =item Amiga Perl Invoking Mystery |
| 6833 | |
| 6834 | =item lib/ftmp-security tests warn 'system possibly insecure' |
| 6835 | |
| 6836 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 |
| 6837 | |
| 6838 | =item HP-UX lib/io_multihomed Fails When LP64-Configured |
| 6839 | |
| 6840 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
| 6841 | |
| 6842 | =item Linux With Sfio Fails op/misc Test 48 |
| 6843 | |
| 6844 | =item OS/390 |
| 6845 | |
| 6846 | =item op/sprintf tests 129 and 130 |
| 6847 | |
| 6848 | =item Failure of Thread tests |
| 6849 | |
| 6850 | =item UNICOS |
| 6851 | |
| 6852 | =item UTS |
| 6853 | |
| 6854 | =item VMS |
| 6855 | |
| 6856 | =item Win32 |
| 6857 | |
| 6858 | =item Localising a Tied Variable Leaks Memory |
| 6859 | |
| 6860 | =item Self-tying of Arrays and Hashes Is Forbidden |
| 6861 | |
| 6862 | =item Variable Attributes are not Currently Usable for Tieing |
| 6863 | |
| 6864 | =item Building Extensions Can Fail Because Of Largefiles |
| 6865 | |
| 6866 | =item The Compiler Suite Is Still Experimental |
| 6867 | |
| 6868 | =item The Long Double Support is Still Experimental |
| 6869 | |
| 6870 | =back |
| 6871 | |
| 6872 | =item Reporting Bugs |
| 6873 | |
| 6874 | =item SEE ALSO |
| 6875 | |
| 6876 | =item HISTORY |
| 6877 | |
| 6878 | =back |
| 6879 | |
| 6880 | =head2 perl571delta - what's new for perl v5.7.1 |
| 6881 | |
| 6882 | =over 4 |
| 6883 | |
| 6884 | =item DESCRIPTION |
| 6885 | |
| 6886 | =item Security Vulnerability Closed |
| 6887 | |
| 6888 | =item Incompatible Changes |
| 6889 | |
| 6890 | =item Core Enhancements |
| 6891 | |
| 6892 | =over 4 |
| 6893 | |
| 6894 | =item AUTOLOAD Is Now Lvaluable |
| 6895 | |
| 6896 | =item PerlIO is Now The Default |
| 6897 | |
| 6898 | =item Signals Are Now Safe |
| 6899 | |
| 6900 | =back |
| 6901 | |
| 6902 | =item Modules and Pragmata |
| 6903 | |
| 6904 | =over 4 |
| 6905 | |
| 6906 | =item New Modules |
| 6907 | |
| 6908 | =item Updated And Improved Modules and Pragmata |
| 6909 | |
| 6910 | =back |
| 6911 | |
| 6912 | =item Performance Enhancements |
| 6913 | |
| 6914 | =item Utility Changes |
| 6915 | |
| 6916 | =item New Documentation |
| 6917 | |
| 6918 | =over 4 |
| 6919 | |
| 6920 | =item perlclib |
| 6921 | |
| 6922 | =item perliol |
| 6923 | |
| 6924 | =item README.aix |
| 6925 | |
| 6926 | =item README.bs2000 |
| 6927 | |
| 6928 | =item README.macos |
| 6929 | |
| 6930 | =item README.mpeix |
| 6931 | |
| 6932 | =item README.solaris |
| 6933 | |
| 6934 | =item README.vos |
| 6935 | |
| 6936 | =item Porting/repository.pod |
| 6937 | |
| 6938 | =back |
| 6939 | |
| 6940 | =item Installation and Configuration Improvements |
| 6941 | |
| 6942 | =over 4 |
| 6943 | |
| 6944 | =item New Or Improved Platforms |
| 6945 | |
| 6946 | =item Generic Improvements |
| 6947 | |
| 6948 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, |
| 6949 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, |
| 6950 | d_strtoq, d_u32align, d_ualarm, d_usleep |
| 6951 | |
| 6952 | =back |
| 6953 | |
| 6954 | =item Selected Bug Fixes |
| 6955 | |
| 6956 | =over 4 |
| 6957 | |
| 6958 | =item Platform Specific Changes and Fixes |
| 6959 | |
| 6960 | =back |
| 6961 | |
| 6962 | =item New or Changed Diagnostics |
| 6963 | |
| 6964 | =item Changed Internals |
| 6965 | |
| 6966 | =item New Tests |
| 6967 | |
| 6968 | =item Known Problems |
| 6969 | |
| 6970 | =over 4 |
| 6971 | |
| 6972 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl |
| 6973 | |
| 6974 | =item lib/ftmp-security tests warn 'system possibly insecure' |
| 6975 | |
| 6976 | =item lib/io_multihomed Fails In LP64-Configured HP-UX |
| 6977 | |
| 6978 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
| 6979 | |
| 6980 | =item lib/b test 19 |
| 6981 | |
| 6982 | =item Linux With Sfio Fails op/misc Test 48 |
| 6983 | |
| 6984 | =item sigaction test 13 in VMS |
| 6985 | |
| 6986 | =item sprintf tests 129 and 130 |
| 6987 | |
| 6988 | =item Failure of Thread tests |
| 6989 | |
| 6990 | =item Localising a Tied Variable Leaks Memory |
| 6991 | |
| 6992 | =item Self-tying of Arrays and Hashes Is Forbidden |
| 6993 | |
| 6994 | =item Building Extensions Can Fail Because Of Largefiles |
| 6995 | |
| 6996 | =item The Compiler Suite Is Still Experimental |
| 6997 | |
| 6998 | =back |
| 6999 | |
| 7000 | =item Reporting Bugs |
| 7001 | |
| 7002 | =item SEE ALSO |
| 7003 | |
| 7004 | =item HISTORY |
| 7005 | |
| 7006 | =back |
| 7007 | |
| 7008 | =head2 perl570delta - what's new for perl v5.7.0 |
| 7009 | |
| 7010 | =over 4 |
| 7011 | |
| 7012 | =item DESCRIPTION |
| 7013 | |
| 7014 | =item Security Vulnerability Closed |
| 7015 | |
| 7016 | =item Incompatible Changes |
| 7017 | |
| 7018 | =item Core Enhancements |
| 7019 | |
| 7020 | =item Modules and Pragmata |
| 7021 | |
| 7022 | =over 4 |
| 7023 | |
| 7024 | =item New Modules |
| 7025 | |
| 7026 | =item Updated And Improved Modules and Pragmata |
| 7027 | |
| 7028 | =back |
| 7029 | |
| 7030 | =item Utility Changes |
| 7031 | |
| 7032 | =item New Documentation |
| 7033 | |
| 7034 | =item Performance Enhancements |
| 7035 | |
| 7036 | =item Installation and Configuration Improvements |
| 7037 | |
| 7038 | =over 4 |
| 7039 | |
| 7040 | =item Generic Improvements |
| 7041 | |
| 7042 | =back |
| 7043 | |
| 7044 | =item Selected Bug Fixes |
| 7045 | |
| 7046 | =over 4 |
| 7047 | |
| 7048 | =item Platform Specific Changes and Fixes |
| 7049 | |
| 7050 | =back |
| 7051 | |
| 7052 | =item New or Changed Diagnostics |
| 7053 | |
| 7054 | =item Changed Internals |
| 7055 | |
| 7056 | =item Known Problems |
| 7057 | |
| 7058 | =over 4 |
| 7059 | |
| 7060 | =item Unicode Support Still Far From Perfect |
| 7061 | |
| 7062 | =item EBCDIC Still A Lost Platform |
| 7063 | |
| 7064 | =item Building Extensions Can Fail Because Of Largefiles |
| 7065 | |
| 7066 | =item ftmp-security tests warn 'system possibly insecure' |
| 7067 | |
| 7068 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
| 7069 | |
| 7070 | =item Long Doubles Still Don't Work In Solaris |
| 7071 | |
| 7072 | =item Linux With Sfio Fails op/misc Test 48 |
| 7073 | |
| 7074 | =item Storable tests fail in some platforms |
| 7075 | |
| 7076 | =item Threads Are Still Experimental |
| 7077 | |
| 7078 | =item The Compiler Suite Is Still Experimental |
| 7079 | |
| 7080 | =back |
| 7081 | |
| 7082 | =item Reporting Bugs |
| 7083 | |
| 7084 | =item SEE ALSO |
| 7085 | |
| 7086 | =item HISTORY |
| 7087 | |
| 7088 | =back |
| 7089 | |
| 7090 | =head2 perl561delta - what's new for perl v5.6.x |
| 7091 | |
| 7092 | =over 4 |
| 7093 | |
| 7094 | =item DESCRIPTION |
| 7095 | |
| 7096 | =item Summary of changes between 5.6.0 and 5.6.1 |
| 7097 | |
| 7098 | =over 4 |
| 7099 | |
| 7100 | =item Security Issues |
| 7101 | |
| 7102 | =item Core bug fixes |
| 7103 | |
| 7104 | C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), |
| 7105 | Bugs in regular expressions, "slurp" mode, Autovivification of symbolic |
| 7106 | references to special variables, Lexical warnings, Spurious warnings and |
| 7107 | errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, |
| 7108 | map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, |
| 7109 | Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no |
| 7110 | Module;>, Tests |
| 7111 | |
| 7112 | =item Core features |
| 7113 | |
| 7114 | =item Configuration issues |
| 7115 | |
| 7116 | =item Documentation |
| 7117 | |
| 7118 | =item Bundled modules |
| 7119 | |
| 7120 | B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, |
| 7121 | Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, |
| 7122 | IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, |
| 7123 | Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash |
| 7124 | |
| 7125 | =item Platform-specific improvements |
| 7126 | |
| 7127 | NCR MP-RAS, NonStop-UX |
| 7128 | |
| 7129 | =back |
| 7130 | |
| 7131 | =item Core Enhancements |
| 7132 | |
| 7133 | =over 4 |
| 7134 | |
| 7135 | =item Interpreter cloning, threads, and concurrency |
| 7136 | |
| 7137 | =item Lexically scoped warning categories |
| 7138 | |
| 7139 | =item Unicode and UTF-8 support |
| 7140 | |
| 7141 | =item Support for interpolating named characters |
| 7142 | |
| 7143 | =item "our" declarations |
| 7144 | |
| 7145 | =item Support for strings represented as a vector of ordinals |
| 7146 | |
| 7147 | =item Improved Perl version numbering system |
| 7148 | |
| 7149 | =item New syntax for declaring subroutine attributes |
| 7150 | |
| 7151 | =item File and directory handles can be autovivified |
| 7152 | |
| 7153 | =item open() with more than two arguments |
| 7154 | |
| 7155 | =item 64-bit support |
| 7156 | |
| 7157 | =item Large file support |
| 7158 | |
| 7159 | =item Long doubles |
| 7160 | |
| 7161 | =item "more bits" |
| 7162 | |
| 7163 | =item Enhanced support for sort() subroutines |
| 7164 | |
| 7165 | =item C<sort $coderef @foo> allowed |
| 7166 | |
| 7167 | =item File globbing implemented internally |
| 7168 | |
| 7169 | =item Support for CHECK blocks |
| 7170 | |
| 7171 | =item POSIX character class syntax [: :] supported |
| 7172 | |
| 7173 | =item Better pseudo-random number generator |
| 7174 | |
| 7175 | =item Improved C<qw//> operator |
| 7176 | |
| 7177 | =item Better worst-case behavior of hashes |
| 7178 | |
| 7179 | =item pack() format 'Z' supported |
| 7180 | |
| 7181 | =item pack() format modifier '!' supported |
| 7182 | |
| 7183 | =item pack() and unpack() support counted strings |
| 7184 | |
| 7185 | =item Comments in pack() templates |
| 7186 | |
| 7187 | =item Weak references |
| 7188 | |
| 7189 | =item Binary numbers supported |
| 7190 | |
| 7191 | =item Lvalue subroutines |
| 7192 | |
| 7193 | =item Some arrows may be omitted in calls through references |
| 7194 | |
| 7195 | =item Boolean assignment operators are legal lvalues |
| 7196 | |
| 7197 | =item exists() is supported on subroutine names |
| 7198 | |
| 7199 | =item exists() and delete() are supported on array elements |
| 7200 | |
| 7201 | =item Pseudo-hashes work better |
| 7202 | |
| 7203 | =item Automatic flushing of output buffers |
| 7204 | |
| 7205 | =item Better diagnostics on meaningless filehandle operations |
| 7206 | |
| 7207 | =item Where possible, buffered data discarded from duped input filehandle |
| 7208 | |
| 7209 | =item eof() has the same old magic as <> |
| 7210 | |
| 7211 | =item binmode() can be used to set :crlf and :raw modes |
| 7212 | |
| 7213 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
| 7214 | |
| 7215 | =item system(), backticks and pipe open now reflect exec() failure |
| 7216 | |
| 7217 | =item Improved diagnostics |
| 7218 | |
| 7219 | =item Diagnostics follow STDERR |
| 7220 | |
| 7221 | =item More consistent close-on-exec behavior |
| 7222 | |
| 7223 | =item syswrite() ease-of-use |
| 7224 | |
| 7225 | =item Better syntax checks on parenthesized unary operators |
| 7226 | |
| 7227 | =item Bit operators support full native integer width |
| 7228 | |
| 7229 | =item Improved security features |
| 7230 | |
| 7231 | =item More functional bareword prototype (*) |
| 7232 | |
| 7233 | =item C<require> and C<do> may be overridden |
| 7234 | |
| 7235 | =item $^X variables may now have names longer than one character |
| 7236 | |
| 7237 | =item New variable $^C reflects C<-c> switch |
| 7238 | |
| 7239 | =item New variable $^V contains Perl version as a string |
| 7240 | |
| 7241 | =item Optional Y2K warnings |
| 7242 | |
| 7243 | =item Arrays now always interpolate into double-quoted strings |
| 7244 | |
| 7245 | =item @- and @+ provide starting/ending offsets of regex submatches |
| 7246 | |
| 7247 | =back |
| 7248 | |
| 7249 | =item Modules and Pragmata |
| 7250 | |
| 7251 | =over 4 |
| 7252 | |
| 7253 | =item Modules |
| 7254 | |
| 7255 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
| 7256 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, |
| 7257 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, |
| 7258 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, |
| 7259 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, |
| 7260 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, |
| 7261 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, |
| 7262 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters |
| 7263 | |
| 7264 | =item Pragmata |
| 7265 | |
| 7266 | =back |
| 7267 | |
| 7268 | =item Utility Changes |
| 7269 | |
| 7270 | =over 4 |
| 7271 | |
| 7272 | =item dprofpp |
| 7273 | |
| 7274 | =item find2perl |
| 7275 | |
| 7276 | =item h2xs |
| 7277 | |
| 7278 | =item perlcc |
| 7279 | |
| 7280 | =item perldoc |
| 7281 | |
| 7282 | =item The Perl Debugger |
| 7283 | |
| 7284 | =back |
| 7285 | |
| 7286 | =item Improved Documentation |
| 7287 | |
| 7288 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
| 7289 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, |
| 7290 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, |
| 7291 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod |
| 7292 | |
| 7293 | =item Performance enhancements |
| 7294 | |
| 7295 | =over 4 |
| 7296 | |
| 7297 | =item Simple sort() using { $a <=> $b } and the like are optimized |
| 7298 | |
| 7299 | =item Optimized assignments to lexical variables |
| 7300 | |
| 7301 | =item Faster subroutine calls |
| 7302 | |
| 7303 | =item delete(), each(), values() and hash iteration are faster |
| 7304 | |
| 7305 | =back |
| 7306 | |
| 7307 | =item Installation and Configuration Improvements |
| 7308 | |
| 7309 | =over 4 |
| 7310 | |
| 7311 | =item -Dusethreads means something different |
| 7312 | |
| 7313 | =item New Configure flags |
| 7314 | |
| 7315 | =item Threadedness and 64-bitness now more daring |
| 7316 | |
| 7317 | =item Long Doubles |
| 7318 | |
| 7319 | =item -Dusemorebits |
| 7320 | |
| 7321 | =item -Duselargefiles |
| 7322 | |
| 7323 | =item installusrbinperl |
| 7324 | |
| 7325 | =item SOCKS support |
| 7326 | |
| 7327 | =item C<-A> flag |
| 7328 | |
| 7329 | =item Enhanced Installation Directories |
| 7330 | |
| 7331 | =item gcc automatically tried if 'cc' does not seem to be working |
| 7332 | |
| 7333 | =back |
| 7334 | |
| 7335 | =item Platform specific changes |
| 7336 | |
| 7337 | =over 4 |
| 7338 | |
| 7339 | =item Supported platforms |
| 7340 | |
| 7341 | =item DOS |
| 7342 | |
| 7343 | =item OS390 (OpenEdition MVS) |
| 7344 | |
| 7345 | =item VMS |
| 7346 | |
| 7347 | =item Win32 |
| 7348 | |
| 7349 | =back |
| 7350 | |
| 7351 | =item Significant bug fixes |
| 7352 | |
| 7353 | =over 4 |
| 7354 | |
| 7355 | =item <HANDLE> on empty files |
| 7356 | |
| 7357 | =item C<eval '...'> improvements |
| 7358 | |
| 7359 | =item All compilation errors are true errors |
| 7360 | |
| 7361 | =item Implicitly closed filehandles are safer |
| 7362 | |
| 7363 | =item Behavior of list slices is more consistent |
| 7364 | |
| 7365 | =item C<(\$)> prototype and C<$foo{a}> |
| 7366 | |
| 7367 | =item C<goto &sub> and AUTOLOAD |
| 7368 | |
| 7369 | =item C<-bareword> allowed under C<use integer> |
| 7370 | |
| 7371 | =item Failures in DESTROY() |
| 7372 | |
| 7373 | =item Locale bugs fixed |
| 7374 | |
| 7375 | =item Memory leaks |
| 7376 | |
| 7377 | =item Spurious subroutine stubs after failed subroutine calls |
| 7378 | |
| 7379 | =item Taint failures under C<-U> |
| 7380 | |
| 7381 | =item END blocks and the C<-c> switch |
| 7382 | |
| 7383 | =item Potential to leak DATA filehandles |
| 7384 | |
| 7385 | =back |
| 7386 | |
| 7387 | =item New or Changed Diagnostics |
| 7388 | |
| 7389 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
| 7390 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, |
| 7391 | / cannot take a count, / must be followed by a, A or Z, / must be followed |
| 7392 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape |
| 7393 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class |
| 7394 | passed through, /%s/ should probably be written as "%s", %s() called too |
| 7395 | early to check prototype, %s argument is not a HASH or ARRAY element, %s |
| 7396 | argument is not a HASH or ARRAY element or slice, %s argument is not a |
| 7397 | subroutine name, %s package attribute may clash with future reserved word: |
| 7398 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled |
| 7399 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, |
| 7400 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector |
| 7401 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check |
| 7402 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", |
| 7403 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, |
| 7404 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't |
| 7405 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't |
| 7406 | weaken a nonreference, Character class [:%s:] unknown, Character class |
| 7407 | syntax [%s] belongs inside character classes, Constant is not %s reference, |
| 7408 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, |
| 7409 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean |
| 7410 | "local" instead of "our"?), Document contains no data, entering effective |
| 7411 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for |
| 7412 | output, flock() on closed filehandle %s, Global symbol "%s" requires |
| 7413 | explicit package name, Hexadecimal number > 0xffffffff non-portable, |
| 7414 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: |
| 7415 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal |
| 7416 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: |
| 7417 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid |
| 7418 | separator character %s in attribute list, Invalid separator character %s in |
| 7419 | subroutine attribute list, leaving effective %s failed, Lvalue subs |
| 7420 | returning %s not implemented yet, Method %s not permitted, Missing |
| 7421 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", |
| 7422 | No %s specified for -%c, No package name allowed for variable %s in "our", |
| 7423 | No space allowed after -%c, no UTC offset information; assuming local time |
| 7424 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, |
| 7425 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing |
| 7426 | around "%s" list, Possible unintended interpolation of %s in string, |
| 7427 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" |
| 7428 | instead, Premature end of script headers, Repeat count in pack overflows, |
| 7429 | Repeat count in unpack overflows, realloc() of freed memory ignored, |
| 7430 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on |
| 7431 | zero-length expression, switching effective %s is not implemented, This |
| 7432 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL |
| 7433 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode |
| 7434 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized |
| 7435 | escape \\%c passed through, Unterminated attribute parameter in attribute |
| 7436 | list, Unterminated attribute list, Unterminated attribute parameter in |
| 7437 | subroutine attribute list, Unterminated subroutine attribute list, Value of |
| 7438 | CLI symbol "%s" too long, Version number must be a constant number |
| 7439 | |
| 7440 | =item New tests |
| 7441 | |
| 7442 | =item Incompatible Changes |
| 7443 | |
| 7444 | =over 4 |
| 7445 | |
| 7446 | =item Perl Source Incompatibilities |
| 7447 | |
| 7448 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
| 7449 | Format of $English::PERL_VERSION is different, Literals of the form |
| 7450 | C<1.2.3> parse differently, Possibly changed pseudo-random number |
| 7451 | generator, Hashing function for hash keys has changed, C<undef> fails on |
| 7452 | read only values, Close-on-exec bit may be set on pipe and socket handles, |
| 7453 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
| 7454 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, |
| 7455 | Text of some diagnostic output has changed, C<%@> has been removed, |
| 7456 | Parenthesized not() behaves like a list operator, Semantics of bareword |
| 7457 | prototype C<(*)> have changed, Semantics of bit operators may have changed |
| 7458 | on 64-bit platforms, More builtins taint their results |
| 7459 | |
| 7460 | =item C Source Incompatibilities |
| 7461 | |
| 7462 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
| 7463 | |
| 7464 | =item Compatible C Source API Changes |
| 7465 | |
| 7466 | C<PATCHLEVEL> is now C<PERL_VERSION> |
| 7467 | |
| 7468 | =item Binary Incompatibilities |
| 7469 | |
| 7470 | =back |
| 7471 | |
| 7472 | =item Known Problems |
| 7473 | |
| 7474 | =over 4 |
| 7475 | |
| 7476 | =item Localizing a tied hash element may leak memory |
| 7477 | |
| 7478 | =item Known test failures |
| 7479 | |
| 7480 | =item EBCDIC platforms not fully supported |
| 7481 | |
| 7482 | =item UNICOS/mk CC failures during Configure run |
| 7483 | |
| 7484 | =item Arrow operator and arrays |
| 7485 | |
| 7486 | =item Experimental features |
| 7487 | |
| 7488 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
| 7489 | pseudo-hash data type, The Compiler suite, Internal implementation of file |
| 7490 | globbing, The DB module, The regular expression code constructs: |
| 7491 | |
| 7492 | =back |
| 7493 | |
| 7494 | =item Obsolete Diagnostics |
| 7495 | |
| 7496 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
| 7497 | logical name |%s| in prime_env_iter, In string, @%s now must be written as |
| 7498 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" |
| 7499 | to mean "${$}<digit>" is deprecated |
| 7500 | |
| 7501 | =item Reporting Bugs |
| 7502 | |
| 7503 | =item SEE ALSO |
| 7504 | |
| 7505 | =item HISTORY |
| 7506 | |
| 7507 | =back |
| 7508 | |
| 7509 | =head2 perl56delta - what's new for perl v5.6.0 |
| 7510 | |
| 7511 | =over 4 |
| 7512 | |
| 7513 | =item DESCRIPTION |
| 7514 | |
| 7515 | =item Core Enhancements |
| 7516 | |
| 7517 | =over 4 |
| 7518 | |
| 7519 | =item Interpreter cloning, threads, and concurrency |
| 7520 | |
| 7521 | =item Lexically scoped warning categories |
| 7522 | |
| 7523 | =item Unicode and UTF-8 support |
| 7524 | |
| 7525 | =item Support for interpolating named characters |
| 7526 | |
| 7527 | =item "our" declarations |
| 7528 | |
| 7529 | =item Support for strings represented as a vector of ordinals |
| 7530 | |
| 7531 | =item Improved Perl version numbering system |
| 7532 | |
| 7533 | =item New syntax for declaring subroutine attributes |
| 7534 | |
| 7535 | =item File and directory handles can be autovivified |
| 7536 | |
| 7537 | =item open() with more than two arguments |
| 7538 | |
| 7539 | =item 64-bit support |
| 7540 | |
| 7541 | =item Large file support |
| 7542 | |
| 7543 | =item Long doubles |
| 7544 | |
| 7545 | =item "more bits" |
| 7546 | |
| 7547 | =item Enhanced support for sort() subroutines |
| 7548 | |
| 7549 | =item C<sort $coderef @foo> allowed |
| 7550 | |
| 7551 | =item File globbing implemented internally |
| 7552 | |
| 7553 | =item Support for CHECK blocks |
| 7554 | |
| 7555 | =item POSIX character class syntax [: :] supported |
| 7556 | |
| 7557 | =item Better pseudo-random number generator |
| 7558 | |
| 7559 | =item Improved C<qw//> operator |
| 7560 | |
| 7561 | =item Better worst-case behavior of hashes |
| 7562 | |
| 7563 | =item pack() format 'Z' supported |
| 7564 | |
| 7565 | =item pack() format modifier '!' supported |
| 7566 | |
| 7567 | =item pack() and unpack() support counted strings |
| 7568 | |
| 7569 | =item Comments in pack() templates |
| 7570 | |
| 7571 | =item Weak references |
| 7572 | |
| 7573 | =item Binary numbers supported |
| 7574 | |
| 7575 | =item Lvalue subroutines |
| 7576 | |
| 7577 | =item Some arrows may be omitted in calls through references |
| 7578 | |
| 7579 | =item Boolean assignment operators are legal lvalues |
| 7580 | |
| 7581 | =item exists() is supported on subroutine names |
| 7582 | |
| 7583 | =item exists() and delete() are supported on array elements |
| 7584 | |
| 7585 | =item Pseudo-hashes work better |
| 7586 | |
| 7587 | =item Automatic flushing of output buffers |
| 7588 | |
| 7589 | =item Better diagnostics on meaningless filehandle operations |
| 7590 | |
| 7591 | =item Where possible, buffered data discarded from duped input filehandle |
| 7592 | |
| 7593 | =item eof() has the same old magic as <> |
| 7594 | |
| 7595 | =item binmode() can be used to set :crlf and :raw modes |
| 7596 | |
| 7597 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
| 7598 | |
| 7599 | =item system(), backticks and pipe open now reflect exec() failure |
| 7600 | |
| 7601 | =item Improved diagnostics |
| 7602 | |
| 7603 | =item Diagnostics follow STDERR |
| 7604 | |
| 7605 | =item More consistent close-on-exec behavior |
| 7606 | |
| 7607 | =item syswrite() ease-of-use |
| 7608 | |
| 7609 | =item Better syntax checks on parenthesized unary operators |
| 7610 | |
| 7611 | =item Bit operators support full native integer width |
| 7612 | |
| 7613 | =item Improved security features |
| 7614 | |
| 7615 | =item More functional bareword prototype (*) |
| 7616 | |
| 7617 | =item C<require> and C<do> may be overridden |
| 7618 | |
| 7619 | =item $^X variables may now have names longer than one character |
| 7620 | |
| 7621 | =item New variable $^C reflects C<-c> switch |
| 7622 | |
| 7623 | =item New variable $^V contains Perl version as a string |
| 7624 | |
| 7625 | =item Optional Y2K warnings |
| 7626 | |
| 7627 | =item Arrays now always interpolate into double-quoted strings |
| 7628 | |
| 7629 | =item @- and @+ provide starting/ending offsets of regex matches |
| 7630 | |
| 7631 | =back |
| 7632 | |
| 7633 | =item Modules and Pragmata |
| 7634 | |
| 7635 | =over 4 |
| 7636 | |
| 7637 | =item Modules |
| 7638 | |
| 7639 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
| 7640 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, |
| 7641 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, |
| 7642 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, |
| 7643 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, |
| 7644 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, |
| 7645 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, |
| 7646 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters |
| 7647 | |
| 7648 | =item Pragmata |
| 7649 | |
| 7650 | =back |
| 7651 | |
| 7652 | =item Utility Changes |
| 7653 | |
| 7654 | =over 4 |
| 7655 | |
| 7656 | =item dprofpp |
| 7657 | |
| 7658 | =item find2perl |
| 7659 | |
| 7660 | =item h2xs |
| 7661 | |
| 7662 | =item perlcc |
| 7663 | |
| 7664 | =item perldoc |
| 7665 | |
| 7666 | =item The Perl Debugger |
| 7667 | |
| 7668 | =back |
| 7669 | |
| 7670 | =item Improved Documentation |
| 7671 | |
| 7672 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
| 7673 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, |
| 7674 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, |
| 7675 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod |
| 7676 | |
| 7677 | =item Performance enhancements |
| 7678 | |
| 7679 | =over 4 |
| 7680 | |
| 7681 | =item Simple sort() using { $a <=> $b } and the like are optimized |
| 7682 | |
| 7683 | =item Optimized assignments to lexical variables |
| 7684 | |
| 7685 | =item Faster subroutine calls |
| 7686 | |
| 7687 | =item delete(), each(), values() and hash iteration are faster |
| 7688 | |
| 7689 | =back |
| 7690 | |
| 7691 | =item Installation and Configuration Improvements |
| 7692 | |
| 7693 | =over 4 |
| 7694 | |
| 7695 | =item -Dusethreads means something different |
| 7696 | |
| 7697 | =item New Configure flags |
| 7698 | |
| 7699 | =item Threadedness and 64-bitness now more daring |
| 7700 | |
| 7701 | =item Long Doubles |
| 7702 | |
| 7703 | =item -Dusemorebits |
| 7704 | |
| 7705 | =item -Duselargefiles |
| 7706 | |
| 7707 | =item installusrbinperl |
| 7708 | |
| 7709 | =item SOCKS support |
| 7710 | |
| 7711 | =item C<-A> flag |
| 7712 | |
| 7713 | =item Enhanced Installation Directories |
| 7714 | |
| 7715 | =back |
| 7716 | |
| 7717 | =item Platform specific changes |
| 7718 | |
| 7719 | =over 4 |
| 7720 | |
| 7721 | =item Supported platforms |
| 7722 | |
| 7723 | =item DOS |
| 7724 | |
| 7725 | =item OS390 (OpenEdition MVS) |
| 7726 | |
| 7727 | =item VMS |
| 7728 | |
| 7729 | =item Win32 |
| 7730 | |
| 7731 | =back |
| 7732 | |
| 7733 | =item Significant bug fixes |
| 7734 | |
| 7735 | =over 4 |
| 7736 | |
| 7737 | =item <HANDLE> on empty files |
| 7738 | |
| 7739 | =item C<eval '...'> improvements |
| 7740 | |
| 7741 | =item All compilation errors are true errors |
| 7742 | |
| 7743 | =item Implicitly closed filehandles are safer |
| 7744 | |
| 7745 | =item Behavior of list slices is more consistent |
| 7746 | |
| 7747 | =item C<(\$)> prototype and C<$foo{a}> |
| 7748 | |
| 7749 | =item C<goto &sub> and AUTOLOAD |
| 7750 | |
| 7751 | =item C<-bareword> allowed under C<use integer> |
| 7752 | |
| 7753 | =item Failures in DESTROY() |
| 7754 | |
| 7755 | =item Locale bugs fixed |
| 7756 | |
| 7757 | =item Memory leaks |
| 7758 | |
| 7759 | =item Spurious subroutine stubs after failed subroutine calls |
| 7760 | |
| 7761 | =item Taint failures under C<-U> |
| 7762 | |
| 7763 | =item END blocks and the C<-c> switch |
| 7764 | |
| 7765 | =item Potential to leak DATA filehandles |
| 7766 | |
| 7767 | =back |
| 7768 | |
| 7769 | =item New or Changed Diagnostics |
| 7770 | |
| 7771 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
| 7772 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, |
| 7773 | / cannot take a count, / must be followed by a, A or Z, / must be followed |
| 7774 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape |
| 7775 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class |
| 7776 | passed through, /%s/ should probably be written as "%s", %s() called too |
| 7777 | early to check prototype, %s argument is not a HASH or ARRAY element, %s |
| 7778 | argument is not a HASH or ARRAY element or slice, %s argument is not a |
| 7779 | subroutine name, %s package attribute may clash with future reserved word: |
| 7780 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled |
| 7781 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, |
| 7782 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector |
| 7783 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check |
| 7784 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", |
| 7785 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, |
| 7786 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't |
| 7787 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't |
| 7788 | weaken a nonreference, Character class [:%s:] unknown, Character class |
| 7789 | syntax [%s] belongs inside character classes, Constant is not %s reference, |
| 7790 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, |
| 7791 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean |
| 7792 | "local" instead of "our"?), Document contains no data, entering effective |
| 7793 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for |
| 7794 | output, flock() on closed filehandle %s, Global symbol "%s" requires |
| 7795 | explicit package name, Hexadecimal number > 0xffffffff non-portable, |
| 7796 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: |
| 7797 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal |
| 7798 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: |
| 7799 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid |
| 7800 | separator character %s in attribute list, Invalid separator character %s in |
| 7801 | subroutine attribute list, leaving effective %s failed, Lvalue subs |
| 7802 | returning %s not implemented yet, Method %s not permitted, Missing |
| 7803 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", |
| 7804 | No %s specified for -%c, No package name allowed for variable %s in "our", |
| 7805 | No space allowed after -%c, no UTC offset information; assuming local time |
| 7806 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, |
| 7807 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing |
| 7808 | around "%s" list, Possible unintended interpolation of %s in string, |
| 7809 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" |
| 7810 | instead, Premature end of script headers, Repeat count in pack overflows, |
| 7811 | Repeat count in unpack overflows, realloc() of freed memory ignored, |
| 7812 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on |
| 7813 | zero-length expression, switching effective %s is not implemented, This |
| 7814 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL |
| 7815 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode |
| 7816 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized |
| 7817 | escape \\%c passed through, Unterminated attribute parameter in attribute |
| 7818 | list, Unterminated attribute list, Unterminated attribute parameter in |
| 7819 | subroutine attribute list, Unterminated subroutine attribute list, Value of |
| 7820 | CLI symbol "%s" too long, Version number must be a constant number |
| 7821 | |
| 7822 | =item New tests |
| 7823 | |
| 7824 | =item Incompatible Changes |
| 7825 | |
| 7826 | =over 4 |
| 7827 | |
| 7828 | =item Perl Source Incompatibilities |
| 7829 | |
| 7830 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
| 7831 | Format of $English::PERL_VERSION is different, Literals of the form |
| 7832 | C<1.2.3> parse differently, Possibly changed pseudo-random number |
| 7833 | generator, Hashing function for hash keys has changed, C<undef> fails on |
| 7834 | read only values, Close-on-exec bit may be set on pipe and socket handles, |
| 7835 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
| 7836 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, |
| 7837 | Text of some diagnostic output has changed, C<%@> has been removed, |
| 7838 | Parenthesized not() behaves like a list operator, Semantics of bareword |
| 7839 | prototype C<(*)> have changed, Semantics of bit operators may have changed |
| 7840 | on 64-bit platforms, More builtins taint their results |
| 7841 | |
| 7842 | =item C Source Incompatibilities |
| 7843 | |
| 7844 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
| 7845 | |
| 7846 | =item Compatible C Source API Changes |
| 7847 | |
| 7848 | C<PATCHLEVEL> is now C<PERL_VERSION> |
| 7849 | |
| 7850 | =item Binary Incompatibilities |
| 7851 | |
| 7852 | =back |
| 7853 | |
| 7854 | =item Known Problems |
| 7855 | |
| 7856 | =over 4 |
| 7857 | |
| 7858 | =item Thread test failures |
| 7859 | |
| 7860 | =item EBCDIC platforms not supported |
| 7861 | |
| 7862 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
| 7863 | |
| 7864 | =item NEXTSTEP 3.3 POSIX test failure |
| 7865 | |
| 7866 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
| 7867 | gcc |
| 7868 | |
| 7869 | =item UNICOS/mk CC failures during Configure run |
| 7870 | |
| 7871 | =item Arrow operator and arrays |
| 7872 | |
| 7873 | =item Experimental features |
| 7874 | |
| 7875 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
| 7876 | pseudo-hash data type, The Compiler suite, Internal implementation of file |
| 7877 | globbing, The DB module, The regular expression code constructs: |
| 7878 | |
| 7879 | =back |
| 7880 | |
| 7881 | =item Obsolete Diagnostics |
| 7882 | |
| 7883 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
| 7884 | logical name |%s| in prime_env_iter, In string, @%s now must be written as |
| 7885 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" |
| 7886 | to mean "${$}<digit>" is deprecated |
| 7887 | |
| 7888 | =item Reporting Bugs |
| 7889 | |
| 7890 | =item SEE ALSO |
| 7891 | |
| 7892 | =item HISTORY |
| 7893 | |
| 7894 | =back |
| 7895 | |
| 7896 | =head2 perl5005delta - what's new for perl5.005 |
| 7897 | |
| 7898 | =over 4 |
| 7899 | |
| 7900 | =item DESCRIPTION |
| 7901 | |
| 7902 | =item About the new versioning system |
| 7903 | |
| 7904 | =item Incompatible Changes |
| 7905 | |
| 7906 | =over 4 |
| 7907 | |
| 7908 | =item WARNING: This version is not binary compatible with Perl 5.004. |
| 7909 | |
| 7910 | =item Default installation structure has changed |
| 7911 | |
| 7912 | =item Perl Source Compatibility |
| 7913 | |
| 7914 | =item C Source Compatibility |
| 7915 | |
| 7916 | =item Binary Compatibility |
| 7917 | |
| 7918 | =item Security fixes may affect compatibility |
| 7919 | |
| 7920 | =item Relaxed new mandatory warnings introduced in 5.004 |
| 7921 | |
| 7922 | =item Licensing |
| 7923 | |
| 7924 | =back |
| 7925 | |
| 7926 | =item Core Changes |
| 7927 | |
| 7928 | =over 4 |
| 7929 | |
| 7930 | =item Threads |
| 7931 | |
| 7932 | =item Compiler |
| 7933 | |
| 7934 | =item Regular Expressions |
| 7935 | |
| 7936 | Many new and improved optimizations, Many bug fixes, New regular expression |
| 7937 | constructs, New operator for precompiled regular expressions, Other |
| 7938 | improvements, Incompatible changes |
| 7939 | |
| 7940 | =item Improved malloc() |
| 7941 | |
| 7942 | =item Quicksort is internally implemented |
| 7943 | |
| 7944 | =item Reliable signals |
| 7945 | |
| 7946 | =item Reliable stack pointers |
| 7947 | |
| 7948 | =item More generous treatment of carriage returns |
| 7949 | |
| 7950 | =item Memory leaks |
| 7951 | |
| 7952 | =item Better support for multiple interpreters |
| 7953 | |
| 7954 | =item Behavior of local() on array and hash elements is now well-defined |
| 7955 | |
| 7956 | =item C<%!> is transparently tied to the L<Errno> module |
| 7957 | |
| 7958 | =item Pseudo-hashes are supported |
| 7959 | |
| 7960 | =item C<EXPR foreach EXPR> is supported |
| 7961 | |
| 7962 | =item Keywords can be globally overridden |
| 7963 | |
| 7964 | =item C<$^E> is meaningful on Win32 |
| 7965 | |
| 7966 | =item C<foreach (1..1000000)> optimized |
| 7967 | |
| 7968 | =item C<Foo::> can be used as implicitly quoted package name |
| 7969 | |
| 7970 | =item C<exists $Foo::{Bar::}> tests existence of a package |
| 7971 | |
| 7972 | =item Better locale support |
| 7973 | |
| 7974 | =item Experimental support for 64-bit platforms |
| 7975 | |
| 7976 | =item prototype() returns useful results on builtins |
| 7977 | |
| 7978 | =item Extended support for exception handling |
| 7979 | |
| 7980 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods |
| 7981 | |
| 7982 | =item All C<printf> format conversions are handled internally |
| 7983 | |
| 7984 | =item New C<INIT> keyword |
| 7985 | |
| 7986 | =item New C<lock> keyword |
| 7987 | |
| 7988 | =item New C<qr//> operator |
| 7989 | |
| 7990 | =item C<our> is now a reserved word |
| 7991 | |
| 7992 | =item Tied arrays are now fully supported |
| 7993 | |
| 7994 | =item Tied handles support is better |
| 7995 | |
| 7996 | =item 4th argument to substr |
| 7997 | |
| 7998 | =item Negative LENGTH argument to splice |
| 7999 | |
| 8000 | =item Magic lvalues are now more magical |
| 8001 | |
| 8002 | =item <> now reads in records |
| 8003 | |
| 8004 | =back |
| 8005 | |
| 8006 | =item Supported Platforms |
| 8007 | |
| 8008 | =over 4 |
| 8009 | |
| 8010 | =item New Platforms |
| 8011 | |
| 8012 | =item Changes in existing support |
| 8013 | |
| 8014 | =back |
| 8015 | |
| 8016 | =item Modules and Pragmata |
| 8017 | |
| 8018 | =over 4 |
| 8019 | |
| 8020 | =item New Modules |
| 8021 | |
| 8022 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, |
| 8023 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, |
| 8024 | Thread, attrs, fields, re |
| 8025 | |
| 8026 | =item Changes in existing modules |
| 8027 | |
| 8028 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, |
| 8029 | MakeMaker, CPAN, Cwd |
| 8030 | |
| 8031 | =back |
| 8032 | |
| 8033 | =item Utility Changes |
| 8034 | |
| 8035 | =item Documentation Changes |
| 8036 | |
| 8037 | =item New Diagnostics |
| 8038 | |
| 8039 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index |
| 8040 | while coercing array into hash, Bareword "%s" refers to nonexistent |
| 8041 | package, Can't call method "%s" on an undefined value, Can't check |
| 8042 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't |
| 8043 | goto subroutine from an eval-string, Can't localize pseudo-hash element, |
| 8044 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber |
| 8045 | for "%s", Character class syntax [. .] is reserved for future extensions, |
| 8046 | Character class syntax [: :] is reserved for future extensions, Character |
| 8047 | class syntax [= =] is reserved for future extensions, %s: Eval-group in |
| 8048 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: |
| 8049 | Eval-group not allowed at run time, Explicit blessing to '' (assuming |
| 8050 | package main), Illegal hex digit ignored, No such array field, No such |
| 8051 | field "%s" in variable %s of type %s, Out of memory during ridiculously |
| 8052 | large request, Range iterator outside integer range, Recursive inheritance |
| 8053 | detected while looking for method '%s' %s, Reference found where even-sized |
| 8054 | list expected, Undefined value assigned to typeglob, Use of reserved word |
| 8055 | "%s" is deprecated, perl: warning: Setting locale failed |
| 8056 | |
| 8057 | =item Obsolete Diagnostics |
| 8058 | |
| 8059 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open |
| 8060 | temporary file, regexp too big |
| 8061 | |
| 8062 | =item Configuration Changes |
| 8063 | |
| 8064 | =item BUGS |
| 8065 | |
| 8066 | =item SEE ALSO |
| 8067 | |
| 8068 | =item HISTORY |
| 8069 | |
| 8070 | =back |
| 8071 | |
| 8072 | =head2 perl5004delta - what's new for perl5.004 |
| 8073 | |
| 8074 | =over 4 |
| 8075 | |
| 8076 | =item DESCRIPTION |
| 8077 | |
| 8078 | =item Supported Environments |
| 8079 | |
| 8080 | =item Core Changes |
| 8081 | |
| 8082 | =over 4 |
| 8083 | |
| 8084 | =item List assignment to %ENV works |
| 8085 | |
| 8086 | =item Change to "Can't locate Foo.pm in @INC" error |
| 8087 | |
| 8088 | =item Compilation option: Binary compatibility with 5.003 |
| 8089 | |
| 8090 | =item $PERL5OPT environment variable |
| 8091 | |
| 8092 | =item Limitations on B<-M>, B<-m>, and B<-T> options |
| 8093 | |
| 8094 | =item More precise warnings |
| 8095 | |
| 8096 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods |
| 8097 | |
| 8098 | =item Previously deprecated %OVERLOAD is no longer usable |
| 8099 | |
| 8100 | =item Subroutine arguments created only when they're modified |
| 8101 | |
| 8102 | =item Group vector changeable with C<$)> |
| 8103 | |
| 8104 | =item Fixed parsing of $$<digit>, &$<digit>, etc. |
| 8105 | |
| 8106 | =item Fixed localization of $<digit>, $&, etc. |
| 8107 | |
| 8108 | =item No resetting of $. on implicit close |
| 8109 | |
| 8110 | =item C<wantarray> may return undef |
| 8111 | |
| 8112 | =item C<eval EXPR> determines value of EXPR in scalar context |
| 8113 | |
| 8114 | =item Changes to tainting checks |
| 8115 | |
| 8116 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No |
| 8117 | spawning if tainted $TERM doesn't look like a terminal name |
| 8118 | |
| 8119 | =item New Opcode module and revised Safe module |
| 8120 | |
| 8121 | =item Embedding improvements |
| 8122 | |
| 8123 | =item Internal change: FileHandle class based on IO::* classes |
| 8124 | |
| 8125 | =item Internal change: PerlIO abstraction interface |
| 8126 | |
| 8127 | =item New and changed syntax |
| 8128 | |
| 8129 | $coderef->(PARAMS) |
| 8130 | |
| 8131 | =item New and changed builtin constants |
| 8132 | |
| 8133 | __PACKAGE__ |
| 8134 | |
| 8135 | =item New and changed builtin variables |
| 8136 | |
| 8137 | $^E, $^H, $^M |
| 8138 | |
| 8139 | =item New and changed builtin functions |
| 8140 | |
| 8141 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in |
| 8142 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module |
| 8143 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not |
| 8144 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, |
| 8145 | nested C<sub{}> closures work now, formats work right on changing lexicals |
| 8146 | |
| 8147 | =item New builtin methods |
| 8148 | |
| 8149 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
| 8150 | |
| 8151 | =item TIEHANDLE now supported |
| 8152 | |
| 8153 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this |
| 8154 | LIST, READLINE this, GETC this, DESTROY this |
| 8155 | |
| 8156 | =item Malloc enhancements |
| 8157 | |
| 8158 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE |
| 8159 | |
| 8160 | =item Miscellaneous efficiency enhancements |
| 8161 | |
| 8162 | =back |
| 8163 | |
| 8164 | =item Support for More Operating Systems |
| 8165 | |
| 8166 | =over 4 |
| 8167 | |
| 8168 | =item Win32 |
| 8169 | |
| 8170 | =item Plan 9 |
| 8171 | |
| 8172 | =item QNX |
| 8173 | |
| 8174 | =item AmigaOS |
| 8175 | |
| 8176 | =back |
| 8177 | |
| 8178 | =item Pragmata |
| 8179 | |
| 8180 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use |
| 8181 | constant NAME => VALUE, use locale, use ops, use vmsish |
| 8182 | |
| 8183 | =item Modules |
| 8184 | |
| 8185 | =over 4 |
| 8186 | |
| 8187 | =item Required Updates |
| 8188 | |
| 8189 | =item Installation directories |
| 8190 | |
| 8191 | =item Module information summary |
| 8192 | |
| 8193 | =item Fcntl |
| 8194 | |
| 8195 | =item IO |
| 8196 | |
| 8197 | =item Math::Complex |
| 8198 | |
| 8199 | =item Math::Trig |
| 8200 | |
| 8201 | =item DB_File |
| 8202 | |
| 8203 | =item Net::Ping |
| 8204 | |
| 8205 | =item Object-oriented overrides for builtin operators |
| 8206 | |
| 8207 | =back |
| 8208 | |
| 8209 | =item Utility Changes |
| 8210 | |
| 8211 | =over 4 |
| 8212 | |
| 8213 | =item pod2html |
| 8214 | |
| 8215 | Sends converted HTML to standard output |
| 8216 | |
| 8217 | =item xsubpp |
| 8218 | |
| 8219 | C<void> XSUBs now default to returning nothing |
| 8220 | |
| 8221 | =back |
| 8222 | |
| 8223 | =item C Language API Changes |
| 8224 | |
| 8225 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for |
| 8226 | manipulating hashes |
| 8227 | |
| 8228 | =item Documentation Changes |
| 8229 | |
| 8230 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, |
| 8231 | L<perlmodlib>, L<perldebug>, L<perlsec> |
| 8232 | |
| 8233 | =item New Diagnostics |
| 8234 | |
| 8235 | "my" variable %s masks earlier declaration in same scope, %s argument is |
| 8236 | not a HASH element or slice, Allocation too large: %lx, Allocation too |
| 8237 | large, Applying %s to %s will act on scalar(%s), Attempt to free |
| 8238 | nonexistent shared string, Attempt to use reference as lvalue in substr, |
| 8239 | Bareword "%s" refers to nonexistent package, Can't redefine active sort |
| 8240 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in |
| 8241 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant |
| 8242 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did |
| 8243 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too |
| 8244 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: |
| 8245 | %s, Integer overflow in hex number, Integer overflow in octal number, |
| 8246 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type |
| 8247 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: |
| 8248 | possible typo, Null picture in formline, Offset outside string, Out of |
| 8249 | memory!, Out of memory during request for %s, panic: frexp, Possible |
| 8250 | attempt to put comments in qw() list, Possible attempt to separate words |
| 8251 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found |
| 8252 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" |
| 8253 | option, untie attempted while %d inner references still exist, Unrecognized |
| 8254 | character %s, Unsupported function fork, Use of "$$<digit>" to mean |
| 8255 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), |
| 8256 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, |
| 8257 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, |
| 8258 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too |
| 8259 | long, Process terminated by SIG%s |
| 8260 | |
| 8261 | =item BUGS |
| 8262 | |
| 8263 | =item SEE ALSO |
| 8264 | |
| 8265 | =item HISTORY |
| 8266 | |
| 8267 | =back |
| 8268 | |
| 8269 | =head2 perlartistic - the Perl Artistic License |
| 8270 | |
| 8271 | =over 4 |
| 8272 | |
| 8273 | =item SYNOPSIS |
| 8274 | |
| 8275 | =item DESCRIPTION |
| 8276 | |
| 8277 | =item The "Artistic License" |
| 8278 | |
| 8279 | =over 4 |
| 8280 | |
| 8281 | =item Preamble |
| 8282 | |
| 8283 | =item Definitions |
| 8284 | |
| 8285 | "Package", "Standard Version", "Copyright Holder", "You", "Reasonable |
| 8286 | copying fee", "Freely Available" |
| 8287 | |
| 8288 | =item Conditions |
| 8289 | |
| 8290 | a), b), c), d), a), b), c), d) |
| 8291 | |
| 8292 | =back |
| 8293 | |
| 8294 | =back |
| 8295 | |
| 8296 | =head2 perlgpl - the GNU General Public License, version 2 |
| 8297 | |
| 8298 | =over 4 |
| 8299 | |
| 8300 | =item SYNOPSIS |
| 8301 | |
| 8302 | =back |
| 8303 | |
| 8304 | =over 4 |
| 8305 | |
| 8306 | =item DESCRIPTION |
| 8307 | |
| 8308 | =item GNU GENERAL PUBLIC LICENSE |
| 8309 | |
| 8310 | =back |
| 8311 | |
| 8312 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems |
| 8313 | |
| 8314 | =over 4 |
| 8315 | |
| 8316 | =item DESCRIPTION |
| 8317 | |
| 8318 | =over 4 |
| 8319 | |
| 8320 | =item Compiling Perl 5 on AIX |
| 8321 | |
| 8322 | =item OS level |
| 8323 | |
| 8324 | =item Building Dynamic Extensions on AIX |
| 8325 | |
| 8326 | =item The IBM ANSI C Compiler |
| 8327 | |
| 8328 | =item The usenm option |
| 8329 | |
| 8330 | =item Using GNU's gcc for building perl |
| 8331 | |
| 8332 | =item Using Large Files with Perl |
| 8333 | |
| 8334 | =item Threaded Perl |
| 8335 | |
| 8336 | =item 64-bit Perl |
| 8337 | |
| 8338 | =item AIX 4.2 and extensions using C++ with statics |
| 8339 | |
| 8340 | =back |
| 8341 | |
| 8342 | =item AUTHOR |
| 8343 | |
| 8344 | =item DATE |
| 8345 | |
| 8346 | =back |
| 8347 | |
| 8348 | =head2 perlamiga - Perl under Amiga OS |
| 8349 | |
| 8350 | =over 4 |
| 8351 | |
| 8352 | =item NOTE |
| 8353 | |
| 8354 | =item SYNOPSIS |
| 8355 | |
| 8356 | =back |
| 8357 | |
| 8358 | =over 4 |
| 8359 | |
| 8360 | =item DESCRIPTION |
| 8361 | |
| 8362 | =over 4 |
| 8363 | |
| 8364 | =item Prerequisites for Compiling Perl on AmigaOS |
| 8365 | |
| 8366 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> |
| 8367 | |
| 8368 | =item Starting Perl programs under AmigaOS |
| 8369 | |
| 8370 | =item Shortcomings of Perl under AmigaOS |
| 8371 | |
| 8372 | =back |
| 8373 | |
| 8374 | =item INSTALLATION |
| 8375 | |
| 8376 | =item Accessing documentation |
| 8377 | |
| 8378 | =over 4 |
| 8379 | |
| 8380 | =item Manpages for Perl on AmigaOS |
| 8381 | |
| 8382 | =item Perl HTML Documentation on AmigaOS |
| 8383 | |
| 8384 | =item Perl GNU Info Files on AmigaOS |
| 8385 | |
| 8386 | =item Perl LaTeX Documentation on AmigaOS |
| 8387 | |
| 8388 | =back |
| 8389 | |
| 8390 | =item BUILDING PERL ON AMIGAOS |
| 8391 | |
| 8392 | =over 4 |
| 8393 | |
| 8394 | =item Build Prerequisites for Perl on AmigaOS |
| 8395 | |
| 8396 | =item Getting the Perl Source for AmigaOS |
| 8397 | |
| 8398 | =item Making Perl on AmigaOS |
| 8399 | |
| 8400 | =item Testing Perl on AmigaOS |
| 8401 | |
| 8402 | =item Installing the built Perl on AmigaOS |
| 8403 | |
| 8404 | =back |
| 8405 | |
| 8406 | =item PERL 5.8.0 BROKEN IN AMIGAOS |
| 8407 | |
| 8408 | =item AUTHORS |
| 8409 | |
| 8410 | =item SEE ALSO |
| 8411 | |
| 8412 | =back |
| 8413 | |
| 8414 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS |
| 8415 | |
| 8416 | =over 4 |
| 8417 | |
| 8418 | =item DESCRIPTION |
| 8419 | |
| 8420 | =item AUTHOR |
| 8421 | |
| 8422 | =back |
| 8423 | |
| 8424 | =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS |
| 8425 | |
| 8426 | =over 4 |
| 8427 | |
| 8428 | =item DESCRIPTION |
| 8429 | |
| 8430 | =item BUILD AND INSTALL |
| 8431 | |
| 8432 | =over 4 |
| 8433 | |
| 8434 | =item Requirements |
| 8435 | |
| 8436 | =item Configure |
| 8437 | |
| 8438 | =item Build |
| 8439 | |
| 8440 | =item Install |
| 8441 | |
| 8442 | =back |
| 8443 | |
| 8444 | =item KNOWN PROBLEMS |
| 8445 | |
| 8446 | =item CONTACT |
| 8447 | |
| 8448 | =back |
| 8449 | |
| 8450 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. |
| 8451 | |
| 8452 | =over 4 |
| 8453 | |
| 8454 | =item SYNOPSIS |
| 8455 | |
| 8456 | =item DESCRIPTION |
| 8457 | |
| 8458 | =over 4 |
| 8459 | |
| 8460 | =item gzip on BS2000 |
| 8461 | |
| 8462 | =item bison on BS2000 |
| 8463 | |
| 8464 | =item Unpacking Perl Distribution on BS2000 |
| 8465 | |
| 8466 | =item Compiling Perl on BS2000 |
| 8467 | |
| 8468 | =item Testing Perl on BS2000 |
| 8469 | |
| 8470 | =item Installing Perl on BS2000 |
| 8471 | |
| 8472 | =item Using Perl in the Posix-Shell of BS2000 |
| 8473 | |
| 8474 | =item Using Perl in "native" BS2000 |
| 8475 | |
| 8476 | =item Floating point anomalies on BS2000 |
| 8477 | |
| 8478 | =item Using PerlIO and different encodings on ASCII and EBCDIC partitions |
| 8479 | |
| 8480 | =back |
| 8481 | |
| 8482 | =item AUTHORS |
| 8483 | |
| 8484 | =item SEE ALSO |
| 8485 | |
| 8486 | =over 4 |
| 8487 | |
| 8488 | =item Mailing list |
| 8489 | |
| 8490 | =back |
| 8491 | |
| 8492 | =item HISTORY |
| 8493 | |
| 8494 | =back |
| 8495 | |
| 8496 | =head2 perlce - Perl for WinCE |
| 8497 | |
| 8498 | =over 4 |
| 8499 | |
| 8500 | =item DESCRIPTION |
| 8501 | |
| 8502 | =item BUILD |
| 8503 | |
| 8504 | =over 4 |
| 8505 | |
| 8506 | =item Tools & SDK |
| 8507 | |
| 8508 | Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's |
| 8509 | celib-sources, Rainer Keuchel's console-sources |
| 8510 | |
| 8511 | =item Make |
| 8512 | |
| 8513 | go to ./wince subdirectory, edit file compile.bat, run compile.bat, run |
| 8514 | compile.bat dist |
| 8515 | |
| 8516 | =back |
| 8517 | |
| 8518 | =item ACKNOWLEDGEMENTS |
| 8519 | |
| 8520 | =item AUTHORS |
| 8521 | |
| 8522 | =back |
| 8523 | |
| 8524 | =head2 perlcygwin, README.cygwin - Perl for Cygwin |
| 8525 | |
| 8526 | =over 4 |
| 8527 | |
| 8528 | =item SYNOPSIS |
| 8529 | |
| 8530 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN |
| 8531 | |
| 8532 | =over 4 |
| 8533 | |
| 8534 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
| 8535 | |
| 8536 | =item Cygwin Configuration |
| 8537 | |
| 8538 | C<PATH>, I<nroff>, Permissions |
| 8539 | |
| 8540 | =back |
| 8541 | |
| 8542 | =item CONFIGURE PERL ON CYGWIN |
| 8543 | |
| 8544 | =over 4 |
| 8545 | |
| 8546 | =item Stripping Perl Binaries on Cygwin |
| 8547 | |
| 8548 | =item Optional Libraries for Perl on Cygwin |
| 8549 | |
| 8550 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), |
| 8551 | C<-lcygipc> (C<use IPC::SysV>), C<-lutil> |
| 8552 | |
| 8553 | =item Configure-time Options for Perl on Cygwin |
| 8554 | |
| 8555 | C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, |
| 8556 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, |
| 8557 | C<-Dmksymlinks> |
| 8558 | |
| 8559 | =item Suspicious Warnings on Cygwin |
| 8560 | |
| 8561 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines |
| 8562 | |
| 8563 | =back |
| 8564 | |
| 8565 | =item MAKE ON CYGWIN |
| 8566 | |
| 8567 | =over 4 |
| 8568 | |
| 8569 | =item Errors on Cygwin |
| 8570 | |
| 8571 | =item ld2 on Cygwin |
| 8572 | |
| 8573 | =back |
| 8574 | |
| 8575 | =item TEST ON CYGWIN |
| 8576 | |
| 8577 | =over 4 |
| 8578 | |
| 8579 | =item File Permissions on Cygwin |
| 8580 | |
| 8581 | =item NDBM_File and ODBM_File do not work on FAT filesystems |
| 8582 | |
| 8583 | =item C<fork()> failures in io_* tests |
| 8584 | |
| 8585 | =back |
| 8586 | |
| 8587 | =item Specific features of the Cygwin port |
| 8588 | |
| 8589 | =over 4 |
| 8590 | |
| 8591 | =item Script Portability on Cygwin |
| 8592 | |
| 8593 | Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids, |
| 8594 | C<chown()>, Miscellaneous |
| 8595 | |
| 8596 | =item Prebuilt methods: |
| 8597 | |
| 8598 | C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid> |
| 8599 | |
| 8600 | =back |
| 8601 | |
| 8602 | =item INSTALL PERL ON CYGWIN |
| 8603 | |
| 8604 | =item MANIFEST ON CYGWIN |
| 8605 | |
| 8606 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl |
| 8607 | Source, Compiled Module Source, Perl Modules/Scripts |
| 8608 | |
| 8609 | =item BUGS ON CYGWIN |
| 8610 | |
| 8611 | =item AUTHORS |
| 8612 | |
| 8613 | =item HISTORY |
| 8614 | |
| 8615 | =back |
| 8616 | |
| 8617 | =head2 perldgux - Perl under DG/UX. |
| 8618 | |
| 8619 | =over 4 |
| 8620 | |
| 8621 | =item SYNOPSIS |
| 8622 | |
| 8623 | =back |
| 8624 | |
| 8625 | =over 4 |
| 8626 | |
| 8627 | =item DESCRIPTION |
| 8628 | |
| 8629 | =item BUILDING PERL ON DG/UX |
| 8630 | |
| 8631 | =over 4 |
| 8632 | |
| 8633 | =item Non-threaded Perl on DG/UX |
| 8634 | |
| 8635 | =item Threaded Perl on DG/UX |
| 8636 | |
| 8637 | =item Testing Perl on DG/UX |
| 8638 | |
| 8639 | =item Installing the built perl on DG/UX |
| 8640 | |
| 8641 | =back |
| 8642 | |
| 8643 | =item AUTHOR |
| 8644 | |
| 8645 | =item SEE ALSO |
| 8646 | |
| 8647 | =back |
| 8648 | |
| 8649 | =head2 perldos - Perl under DOS, W31, W95. |
| 8650 | |
| 8651 | =over 4 |
| 8652 | |
| 8653 | =item SYNOPSIS |
| 8654 | |
| 8655 | =item DESCRIPTION |
| 8656 | |
| 8657 | =over 4 |
| 8658 | |
| 8659 | =item Prerequisites for Compiling Perl on DOS |
| 8660 | |
| 8661 | DJGPP, Pthreads |
| 8662 | |
| 8663 | =item Shortcomings of Perl under DOS |
| 8664 | |
| 8665 | =item Building Perl on DOS |
| 8666 | |
| 8667 | =item Testing Perl on DOS |
| 8668 | |
| 8669 | =item Installation of Perl on DOS |
| 8670 | |
| 8671 | =back |
| 8672 | |
| 8673 | =item BUILDING AND INSTALLING MODULES ON DOS |
| 8674 | |
| 8675 | =over 4 |
| 8676 | |
| 8677 | =item Building Prerequisites for Perl on DOS |
| 8678 | |
| 8679 | =item Unpacking CPAN Modules on DOS |
| 8680 | |
| 8681 | =item Building Non-XS Modules on DOS |
| 8682 | |
| 8683 | =item Building XS Modules on DOS |
| 8684 | |
| 8685 | =back |
| 8686 | |
| 8687 | =item AUTHOR |
| 8688 | |
| 8689 | =item SEE ALSO |
| 8690 | |
| 8691 | =back |
| 8692 | |
| 8693 | =head2 perlepoc, README.epoc - Perl for EPOC |
| 8694 | |
| 8695 | =over 4 |
| 8696 | |
| 8697 | =item SYNOPSIS |
| 8698 | |
| 8699 | =item INTRODUCTION |
| 8700 | |
| 8701 | =item INSTALLING PERL ON EPOC |
| 8702 | |
| 8703 | =item STARTING PERL ON EPOC |
| 8704 | |
| 8705 | =over 4 |
| 8706 | |
| 8707 | =item Editors on Epoc |
| 8708 | |
| 8709 | =item Features of Perl on Epoc |
| 8710 | |
| 8711 | =item Restrictions of Perl on Epoc |
| 8712 | |
| 8713 | =item Compiling Perl 5 on the EPOC cross compiling environment |
| 8714 | |
| 8715 | =back |
| 8716 | |
| 8717 | =item SUPPORT STATUS OF PERL ON EPOC |
| 8718 | |
| 8719 | =item AUTHOR |
| 8720 | |
| 8721 | =item LAST UPDATE |
| 8722 | |
| 8723 | =back |
| 8724 | |
| 8725 | =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems |
| 8726 | |
| 8727 | =over 4 |
| 8728 | |
| 8729 | =item DESCRIPTION |
| 8730 | |
| 8731 | =over 4 |
| 8732 | |
| 8733 | =item FreeBSD core dumps from readdir_r with ithreads |
| 8734 | |
| 8735 | =item $^X doesn't always contain a full path in FreeBSD |
| 8736 | |
| 8737 | =item Perl will no longer be part of "base FreeBSD" |
| 8738 | |
| 8739 | =back |
| 8740 | |
| 8741 | =item AUTHOR |
| 8742 | |
| 8743 | =back |
| 8744 | |
| 8745 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix |
| 8746 | (HP-UX) systems |
| 8747 | |
| 8748 | =over 4 |
| 8749 | |
| 8750 | =item DESCRIPTION |
| 8751 | |
| 8752 | =over 4 |
| 8753 | |
| 8754 | =item Using perl as shipped with HP-UX |
| 8755 | |
| 8756 | =item Using perl from HP's porting centre |
| 8757 | |
| 8758 | =item Compiling Perl 5 on HP-UX |
| 8759 | |
| 8760 | =item PA-RISC |
| 8761 | |
| 8762 | =item Portability Between PA-RISC Versions |
| 8763 | |
| 8764 | =item PA-RISC 1.0 |
| 8765 | |
| 8766 | =item PA-RISC 1.1 |
| 8767 | |
| 8768 | =item PA-RISC 2.0 |
| 8769 | |
| 8770 | =item Itanium Processor Family and HP-UX |
| 8771 | |
| 8772 | =item Itanium & Itanium 2 |
| 8773 | |
| 8774 | =item Building Dynamic Extensions on HP-UX |
| 8775 | |
| 8776 | =item The HP ANSI C Compiler |
| 8777 | |
| 8778 | =item The GNU C Compiler |
| 8779 | |
| 8780 | =item Using Large Files with Perl on HP-UX |
| 8781 | |
| 8782 | =item Threaded Perl on HP-UX |
| 8783 | |
| 8784 | =item 64-bit Perl on HP-UX |
| 8785 | |
| 8786 | =item Oracle on HP-UX |
| 8787 | |
| 8788 | =item GDBM and Threads on HP-UX |
| 8789 | |
| 8790 | =item NFS filesystems and utime(2) on HP-UX |
| 8791 | |
| 8792 | =item perl -P and // and HP-UX |
| 8793 | |
| 8794 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl |
| 8795 | |
| 8796 | =back |
| 8797 | |
| 8798 | =item nss_delete core dump from op/pwent or op/grent |
| 8799 | |
| 8800 | =item AUTHOR |
| 8801 | |
| 8802 | =item DATE |
| 8803 | |
| 8804 | =back |
| 8805 | |
| 8806 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd |
| 8807 | |
| 8808 | =over 4 |
| 8809 | |
| 8810 | =item DESCRIPTION |
| 8811 | |
| 8812 | =over 4 |
| 8813 | |
| 8814 | =item Known Problems with Perl on Hurd |
| 8815 | |
| 8816 | =back |
| 8817 | |
| 8818 | =item AUTHOR |
| 8819 | |
| 8820 | =back |
| 8821 | |
| 8822 | =head2 perlirix, README.irix - Perl version 5 on Irix systems |
| 8823 | |
| 8824 | =over 4 |
| 8825 | |
| 8826 | =item DESCRIPTION |
| 8827 | |
| 8828 | =over 4 |
| 8829 | |
| 8830 | =item Building 32-bit Perl in Irix |
| 8831 | |
| 8832 | =item Building 64-bit Perl in Irix |
| 8833 | |
| 8834 | =item About Compiler Versions of Irix |
| 8835 | |
| 8836 | =item Linker Problems in Irix |
| 8837 | |
| 8838 | =item Malloc in Irix |
| 8839 | |
| 8840 | =item Building with threads in Irix |
| 8841 | |
| 8842 | =item Irix 5.3 |
| 8843 | |
| 8844 | =back |
| 8845 | |
| 8846 | =item AUTHOR |
| 8847 | |
| 8848 | =back |
| 8849 | |
| 8850 | =head2 perllinux, README.linux - Perl version 5 on Linux systems |
| 8851 | |
| 8852 | =over 4 |
| 8853 | |
| 8854 | =item DESCRIPTION |
| 8855 | |
| 8856 | =over 4 |
| 8857 | |
| 8858 | =item Experimental Support for Sun Studio Compilers for Linux OS |
| 8859 | |
| 8860 | =back |
| 8861 | |
| 8862 | =item AUTHOR |
| 8863 | |
| 8864 | =back |
| 8865 | |
| 8866 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen |
| 8867 | systems |
| 8868 | |
| 8869 | =over 4 |
| 8870 | |
| 8871 | =item DESCRIPTION |
| 8872 | |
| 8873 | =over 4 |
| 8874 | |
| 8875 | =item Perl version 5.8.x and greater not supported |
| 8876 | |
| 8877 | =item Compiling Perl 5.6.x on MachTen |
| 8878 | |
| 8879 | =item Failures during C<make test> on MachTen |
| 8880 | |
| 8881 | op/lexassign.t, pragma/warnings.t |
| 8882 | |
| 8883 | =item Building external modules on MachTen |
| 8884 | |
| 8885 | =back |
| 8886 | |
| 8887 | =item AUTHOR |
| 8888 | |
| 8889 | =item DATE |
| 8890 | |
| 8891 | =back |
| 8892 | |
| 8893 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) |
| 8894 | |
| 8895 | =over 4 |
| 8896 | |
| 8897 | =item SYNOPSIS |
| 8898 | |
| 8899 | =item DESCRIPTION |
| 8900 | |
| 8901 | =item AUTHOR |
| 8902 | |
| 8903 | =item DATE |
| 8904 | |
| 8905 | =back |
| 8906 | |
| 8907 | =head2 perlmacosx, README.macosx - Perl under Mac OS X |
| 8908 | |
| 8909 | =over 4 |
| 8910 | |
| 8911 | =item SYNOPSIS |
| 8912 | |
| 8913 | =item DESCRIPTION |
| 8914 | |
| 8915 | =over 4 |
| 8916 | |
| 8917 | =item Installation Prefix |
| 8918 | |
| 8919 | =item libperl and Prebinding |
| 8920 | |
| 8921 | =item Updating Apple-supplied Perl |
| 8922 | |
| 8923 | =item 64-bit Perl |
| 8924 | |
| 8925 | =item Intel processor support |
| 8926 | |
| 8927 | =item Universal binaries |
| 8928 | |
| 8929 | =item Known problems |
| 8930 | |
| 8931 | =item MacPerl |
| 8932 | |
| 8933 | =item Carbon |
| 8934 | |
| 8935 | =item Cocoa |
| 8936 | |
| 8937 | =back |
| 8938 | |
| 8939 | =item Starting From Scratch |
| 8940 | |
| 8941 | =item AUTHOR |
| 8942 | |
| 8943 | =item DATE |
| 8944 | |
| 8945 | =back |
| 8946 | |
| 8947 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT |
| 8948 | |
| 8949 | =over 4 |
| 8950 | |
| 8951 | =item DESCRIPTION |
| 8952 | |
| 8953 | =item Known problems with Perl on MiNT |
| 8954 | |
| 8955 | =item AUTHOR |
| 8956 | |
| 8957 | =back |
| 8958 | |
| 8959 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE |
| 8960 | |
| 8961 | =over 4 |
| 8962 | |
| 8963 | =item SYNOPSIS |
| 8964 | |
| 8965 | =item NOTE |
| 8966 | |
| 8967 | =item Binary distribution from HP |
| 8968 | |
| 8969 | =item What's New in Perl for MPE/iX |
| 8970 | |
| 8971 | =item Welcome to Perl/iX |
| 8972 | |
| 8973 | =item System Requirements for Perl/iX |
| 8974 | |
| 8975 | =item How to Obtain Perl/iX |
| 8976 | |
| 8977 | =item Perl/iX Distribution Contents Highlights |
| 8978 | |
| 8979 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, |
| 8980 | public_html/feedback.cgi, src/perl-5.6.0-mpe |
| 8981 | |
| 8982 | =item How to Compile Perl/iX |
| 8983 | |
| 8984 | 4, 6 |
| 8985 | |
| 8986 | =item Getting Started with Perl/iX |
| 8987 | |
| 8988 | =item MPE/iX Implementation Considerations |
| 8989 | |
| 8990 | =item Known Perl/iX Bugs Under Investigation |
| 8991 | |
| 8992 | =item Perl/iX To-Do List |
| 8993 | |
| 8994 | =item Perl/iX Change History |
| 8995 | |
| 8996 | =item AUTHOR |
| 8997 | |
| 8998 | =back |
| 8999 | |
| 9000 | =head2 perlnetware - Perl for NetWare |
| 9001 | |
| 9002 | =over 4 |
| 9003 | |
| 9004 | =item DESCRIPTION |
| 9005 | |
| 9006 | =item BUILD |
| 9007 | |
| 9008 | =over 4 |
| 9009 | |
| 9010 | =item Tools & SDK |
| 9011 | |
| 9012 | =item Setup |
| 9013 | |
| 9014 | SetNWBld.bat, Buildtype.bat |
| 9015 | |
| 9016 | =item Make |
| 9017 | |
| 9018 | =item Interpreter |
| 9019 | |
| 9020 | =item Extensions |
| 9021 | |
| 9022 | =back |
| 9023 | |
| 9024 | =item INSTALL |
| 9025 | |
| 9026 | =item BUILD NEW EXTENSIONS |
| 9027 | |
| 9028 | =item ACKNOWLEDGEMENTS |
| 9029 | |
| 9030 | =item AUTHORS |
| 9031 | |
| 9032 | =item DATE |
| 9033 | |
| 9034 | =back |
| 9035 | |
| 9036 | =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems |
| 9037 | |
| 9038 | =over 4 |
| 9039 | |
| 9040 | =item DESCRIPTION |
| 9041 | |
| 9042 | =over 4 |
| 9043 | |
| 9044 | =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with |
| 9045 | ithreads |
| 9046 | |
| 9047 | =back |
| 9048 | |
| 9049 | =item AUTHOR |
| 9050 | |
| 9051 | =back |
| 9052 | |
| 9053 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. |
| 9054 | |
| 9055 | =over 4 |
| 9056 | |
| 9057 | =item SYNOPSIS |
| 9058 | |
| 9059 | =back |
| 9060 | |
| 9061 | =over 4 |
| 9062 | |
| 9063 | =item DESCRIPTION |
| 9064 | |
| 9065 | =over 4 |
| 9066 | |
| 9067 | =item Target |
| 9068 | |
| 9069 | =item Other OSes |
| 9070 | |
| 9071 | =item Prerequisites |
| 9072 | |
| 9073 | EMX, RSX, HPFS, pdksh |
| 9074 | |
| 9075 | =item Starting Perl programs under OS/2 (and DOS and...) |
| 9076 | |
| 9077 | =item Starting OS/2 (and DOS) programs under Perl |
| 9078 | |
| 9079 | =back |
| 9080 | |
| 9081 | =item Frequently asked questions |
| 9082 | |
| 9083 | =over 4 |
| 9084 | |
| 9085 | =item "It does not work" |
| 9086 | |
| 9087 | =item I cannot run external programs |
| 9088 | |
| 9089 | =item I cannot embed perl into my program, or use F<perl.dll> from my |
| 9090 | program. |
| 9091 | |
| 9092 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use |
| 9093 | L<ExtUtils::Embed>? |
| 9094 | |
| 9095 | =item C<``> and pipe-C<open> do not work under DOS. |
| 9096 | |
| 9097 | =item Cannot start C<find.exe "pattern" file> |
| 9098 | |
| 9099 | =back |
| 9100 | |
| 9101 | =item INSTALLATION |
| 9102 | |
| 9103 | =over 4 |
| 9104 | |
| 9105 | =item Automatic binary installation |
| 9106 | |
| 9107 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> |
| 9108 | |
| 9109 | =item Manual binary installation |
| 9110 | |
| 9111 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable |
| 9112 | (statically linked), Executables for Perl utilities, Main Perl library, |
| 9113 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl |
| 9114 | and utilities, Manpages for Perl modules, Source for Perl documentation, |
| 9115 | Perl manual in F<.INF> format, Pdksh |
| 9116 | |
| 9117 | =item B<Warning> |
| 9118 | |
| 9119 | =back |
| 9120 | |
| 9121 | =item Accessing documentation |
| 9122 | |
| 9123 | =over 4 |
| 9124 | |
| 9125 | =item OS/2 F<.INF> file |
| 9126 | |
| 9127 | =item Plain text |
| 9128 | |
| 9129 | =item Manpages |
| 9130 | |
| 9131 | =item HTML |
| 9132 | |
| 9133 | =item GNU C<info> files |
| 9134 | |
| 9135 | =item F<PDF> files |
| 9136 | |
| 9137 | =item C<LaTeX> docs |
| 9138 | |
| 9139 | =back |
| 9140 | |
| 9141 | =item BUILD |
| 9142 | |
| 9143 | =over 4 |
| 9144 | |
| 9145 | =item The short story |
| 9146 | |
| 9147 | =item Prerequisites |
| 9148 | |
| 9149 | =item Getting perl source |
| 9150 | |
| 9151 | =item Application of the patches |
| 9152 | |
| 9153 | =item Hand-editing |
| 9154 | |
| 9155 | =item Making |
| 9156 | |
| 9157 | =item Testing |
| 9158 | |
| 9159 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, |
| 9160 | F<op/stat.t> |
| 9161 | |
| 9162 | =item Installing the built perl |
| 9163 | |
| 9164 | =item C<a.out>-style build |
| 9165 | |
| 9166 | =back |
| 9167 | |
| 9168 | =item Building a binary distribution |
| 9169 | |
| 9170 | =item Building custom F<.EXE> files |
| 9171 | |
| 9172 | =over 4 |
| 9173 | |
| 9174 | =item Making executables with a custom collection of statically loaded |
| 9175 | extensions |
| 9176 | |
| 9177 | =item Making executables with a custom search-paths |
| 9178 | |
| 9179 | =back |
| 9180 | |
| 9181 | =item Build FAQ |
| 9182 | |
| 9183 | =over 4 |
| 9184 | |
| 9185 | =item Some C</> became C<\> in pdksh. |
| 9186 | |
| 9187 | =item C<'errno'> - unresolved external |
| 9188 | |
| 9189 | =item Problems with tr or sed |
| 9190 | |
| 9191 | =item Some problem (forget which ;-) |
| 9192 | |
| 9193 | =item Library ... not found |
| 9194 | |
| 9195 | =item Segfault in make |
| 9196 | |
| 9197 | =item op/sprintf test failure |
| 9198 | |
| 9199 | =back |
| 9200 | |
| 9201 | =item Specific (mis)features of OS/2 port |
| 9202 | |
| 9203 | =over 4 |
| 9204 | |
| 9205 | =item C<setpriority>, C<getpriority> |
| 9206 | |
| 9207 | =item C<system()> |
| 9208 | |
| 9209 | =item C<extproc> on the first line |
| 9210 | |
| 9211 | =item Additional modules: |
| 9212 | |
| 9213 | =item Prebuilt methods: |
| 9214 | |
| 9215 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, |
| 9216 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, |
| 9217 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, |
| 9218 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, |
| 9219 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, |
| 9220 | C<Cwd::extLibpath_set( path [, type ] )>, |
| 9221 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, |
| 9222 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, |
| 9223 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, |
| 9224 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, |
| 9225 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>, |
| 9226 | C<OS2::DLLname([how [, \&xsub]])> |
| 9227 | |
| 9228 | =item Prebuilt variables: |
| 9229 | |
| 9230 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, |
| 9231 | $OS2::nsyserror |
| 9232 | |
| 9233 | =item Misfeatures |
| 9234 | |
| 9235 | =item Modifications |
| 9236 | |
| 9237 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, |
| 9238 | C<flock> |
| 9239 | |
| 9240 | =item Identifying DLLs |
| 9241 | |
| 9242 | =item Centralized management of resources |
| 9243 | |
| 9244 | C<HAB>, C<HMQ>, Treating errors reported by OS/2 API, |
| 9245 | C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>, |
| 9246 | C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>, |
| 9247 | C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs |
| 9248 | |
| 9249 | =back |
| 9250 | |
| 9251 | =item Perl flavors |
| 9252 | |
| 9253 | =over 4 |
| 9254 | |
| 9255 | =item F<perl.exe> |
| 9256 | |
| 9257 | =item F<perl_.exe> |
| 9258 | |
| 9259 | =item F<perl__.exe> |
| 9260 | |
| 9261 | =item F<perl___.exe> |
| 9262 | |
| 9263 | =item Why strange names? |
| 9264 | |
| 9265 | =item Why dynamic linking? |
| 9266 | |
| 9267 | =item Why chimera build? |
| 9268 | |
| 9269 | =back |
| 9270 | |
| 9271 | =item ENVIRONMENT |
| 9272 | |
| 9273 | =over 4 |
| 9274 | |
| 9275 | =item C<PERLLIB_PREFIX> |
| 9276 | |
| 9277 | =item C<PERL_BADLANG> |
| 9278 | |
| 9279 | =item C<PERL_BADFREE> |
| 9280 | |
| 9281 | =item C<PERL_SH_DIR> |
| 9282 | |
| 9283 | =item C<USE_PERL_FLOCK> |
| 9284 | |
| 9285 | =item C<TMP> or C<TEMP> |
| 9286 | |
| 9287 | =back |
| 9288 | |
| 9289 | =item Evolution |
| 9290 | |
| 9291 | =over 4 |
| 9292 | |
| 9293 | =item Text-mode filehandles |
| 9294 | |
| 9295 | =item Priorities |
| 9296 | |
| 9297 | =item DLL name mangling: pre 5.6.2 |
| 9298 | |
| 9299 | =item DLL name mangling: 5.6.2 and beyond |
| 9300 | |
| 9301 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from |
| 9302 | C<LIBPATH> |
| 9303 | |
| 9304 | =item DLL forwarder generation |
| 9305 | |
| 9306 | =item Threading |
| 9307 | |
| 9308 | =item Calls to external programs |
| 9309 | |
| 9310 | =item Memory allocation |
| 9311 | |
| 9312 | =item Threads |
| 9313 | |
| 9314 | C<COND_WAIT>, F<os2.c> |
| 9315 | |
| 9316 | =back |
| 9317 | |
| 9318 | =item BUGS |
| 9319 | |
| 9320 | =back |
| 9321 | |
| 9322 | =over 4 |
| 9323 | |
| 9324 | =item AUTHOR |
| 9325 | |
| 9326 | =item SEE ALSO |
| 9327 | |
| 9328 | =back |
| 9329 | |
| 9330 | =head2 perlos390, README.os390 - building and installing Perl for OS/390 |
| 9331 | and z/OS |
| 9332 | |
| 9333 | =over 4 |
| 9334 | |
| 9335 | =item SYNOPSIS |
| 9336 | |
| 9337 | =item DESCRIPTION |
| 9338 | |
| 9339 | =over 4 |
| 9340 | |
| 9341 | =item Tools |
| 9342 | |
| 9343 | =item Unpacking Perl distribution on OS/390 |
| 9344 | |
| 9345 | =item Setup and utilities for Perl on OS/390 |
| 9346 | |
| 9347 | =item Configure Perl on OS/390 |
| 9348 | |
| 9349 | =item Build, Test, Install Perl on OS/390 |
| 9350 | |
| 9351 | =item Build Anomalies with Perl on OS/390 |
| 9352 | |
| 9353 | =item Testing Anomalies with Perl on OS/390 |
| 9354 | |
| 9355 | =item Installation Anomalies with Perl on OS/390 |
| 9356 | |
| 9357 | =item Usage Hints for Perl on OS/390 |
| 9358 | |
| 9359 | =item Floating Point Anomalies with Perl on OS/390 |
| 9360 | |
| 9361 | =item Modules and Extensions for Perl on OS/390 |
| 9362 | |
| 9363 | =back |
| 9364 | |
| 9365 | =item AUTHORS |
| 9366 | |
| 9367 | =item SEE ALSO |
| 9368 | |
| 9369 | =over 4 |
| 9370 | |
| 9371 | =item Mailing list for Perl on OS/390 |
| 9372 | |
| 9373 | =back |
| 9374 | |
| 9375 | =item HISTORY |
| 9376 | |
| 9377 | =back |
| 9378 | |
| 9379 | =head2 perlos400, README.os400 - Perl version 5 on OS/400 |
| 9380 | |
| 9381 | =over 4 |
| 9382 | |
| 9383 | =item DESCRIPTION |
| 9384 | |
| 9385 | =over 4 |
| 9386 | |
| 9387 | =item Compiling Perl for OS/400 PASE |
| 9388 | |
| 9389 | =item Installing Perl in OS/400 PASE |
| 9390 | |
| 9391 | =item Using Perl in OS/400 PASE |
| 9392 | |
| 9393 | =item Known Problems |
| 9394 | |
| 9395 | =item Perl on ILE |
| 9396 | |
| 9397 | =back |
| 9398 | |
| 9399 | =item AUTHORS |
| 9400 | |
| 9401 | =back |
| 9402 | |
| 9403 | =head2 perlplan9 - Plan 9-specific documentation for Perl |
| 9404 | |
| 9405 | =over 4 |
| 9406 | |
| 9407 | =item DESCRIPTION |
| 9408 | |
| 9409 | =over 4 |
| 9410 | |
| 9411 | =item Invoking Perl |
| 9412 | |
| 9413 | =item What's in Plan 9 Perl |
| 9414 | |
| 9415 | =item What's not in Plan 9 Perl |
| 9416 | |
| 9417 | =item Perl5 Functions not currently supported in Plan 9 Perl |
| 9418 | |
| 9419 | =item Signals in Plan 9 Perl |
| 9420 | |
| 9421 | =back |
| 9422 | |
| 9423 | =item COMPILING AND INSTALLING PERL ON PLAN 9 |
| 9424 | |
| 9425 | =over 4 |
| 9426 | |
| 9427 | =item Installing Perl Documentation on Plan 9 |
| 9428 | |
| 9429 | =back |
| 9430 | |
| 9431 | =item BUGS |
| 9432 | |
| 9433 | =item Revision date |
| 9434 | |
| 9435 | =item AUTHOR |
| 9436 | |
| 9437 | =back |
| 9438 | |
| 9439 | =head2 perlqnx, README.qnx - Perl version 5 on QNX |
| 9440 | |
| 9441 | =over 4 |
| 9442 | |
| 9443 | =item DESCRIPTION |
| 9444 | |
| 9445 | =over 4 |
| 9446 | |
| 9447 | =item Required Software for Compiling Perl on QNX4 |
| 9448 | |
| 9449 | /bin/sh, ar, nm, cpp, make |
| 9450 | |
| 9451 | =item Outstanding Issues with Perl on QNX4 |
| 9452 | |
| 9453 | =item QNX auxiliary files |
| 9454 | |
| 9455 | qnx/ar, qnx/cpp |
| 9456 | |
| 9457 | =item Outstanding issues with perl under QNX6 |
| 9458 | |
| 9459 | =back |
| 9460 | |
| 9461 | =item AUTHOR |
| 9462 | |
| 9463 | =back |
| 9464 | |
| 9465 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems |
| 9466 | |
| 9467 | =over 4 |
| 9468 | |
| 9469 | =item DESCRIPTION |
| 9470 | |
| 9471 | =over 4 |
| 9472 | |
| 9473 | =item Solaris Version Numbers. |
| 9474 | |
| 9475 | =back |
| 9476 | |
| 9477 | =item RESOURCES |
| 9478 | |
| 9479 | Solaris FAQ, Precompiled Binaries, Solaris Documentation |
| 9480 | |
| 9481 | =item SETTING UP |
| 9482 | |
| 9483 | =over 4 |
| 9484 | |
| 9485 | =item File Extraction Problems on Solaris. |
| 9486 | |
| 9487 | =item Compiler and Related Tools on Solaris. |
| 9488 | |
| 9489 | =item Environment for Compiling perl on Solaris |
| 9490 | |
| 9491 | =back |
| 9492 | |
| 9493 | =item RUN CONFIGURE. |
| 9494 | |
| 9495 | =over 4 |
| 9496 | |
| 9497 | =item 64-bit perl on Solaris. |
| 9498 | |
| 9499 | =item Threads in perl on Solaris. |
| 9500 | |
| 9501 | =item Malloc Issues with perl on Solaris. |
| 9502 | |
| 9503 | =back |
| 9504 | |
| 9505 | =item MAKE PROBLEMS. |
| 9506 | |
| 9507 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: |
| 9508 | relocation error:, dlopen: stub interception failed, #error "No |
| 9509 | DATAMODEL_NATIVE specified", sh: ar: not found, warning: dead part of |
| 9510 | constant expression is nonconstant |
| 9511 | |
| 9512 | =item MAKE TEST |
| 9513 | |
| 9514 | =over 4 |
| 9515 | |
| 9516 | =item op/stat.t test 4 in Solaris |
| 9517 | |
| 9518 | =item nss_delete core dump from op/pwent or op/grent |
| 9519 | |
| 9520 | =back |
| 9521 | |
| 9522 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. |
| 9523 | |
| 9524 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. |
| 9525 | |
| 9526 | =over 4 |
| 9527 | |
| 9528 | =item Limits on Numbers of Open Files on Solaris. |
| 9529 | |
| 9530 | =back |
| 9531 | |
| 9532 | =item SOLARIS-SPECIFIC MODULES. |
| 9533 | |
| 9534 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. |
| 9535 | |
| 9536 | =over 4 |
| 9537 | |
| 9538 | =item Proc::ProcessTable on Solaris |
| 9539 | |
| 9540 | =item BSD::Resource on Solaris |
| 9541 | |
| 9542 | =item Net::SSLeay on Solaris |
| 9543 | |
| 9544 | =back |
| 9545 | |
| 9546 | =item SunOS 4.x |
| 9547 | |
| 9548 | =item AUTHOR |
| 9549 | |
| 9550 | =back |
| 9551 | |
| 9552 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as |
| 9553 | Digital UNIX formerly known as DEC OSF/1) systems |
| 9554 | |
| 9555 | =over 4 |
| 9556 | |
| 9557 | =item DESCRIPTION |
| 9558 | |
| 9559 | =over 4 |
| 9560 | |
| 9561 | =item Compiling Perl 5 on Tru64 |
| 9562 | |
| 9563 | =item Using Large Files with Perl on Tru64 |
| 9564 | |
| 9565 | =item Threaded Perl on Tru64 |
| 9566 | |
| 9567 | =item Long Doubles on Tru64 |
| 9568 | |
| 9569 | =item DB_File tests failing on Tru64 |
| 9570 | |
| 9571 | =item 64-bit Perl on Tru64 |
| 9572 | |
| 9573 | =item Warnings about floating-point overflow when compiling Perl on Tru64 |
| 9574 | |
| 9575 | =back |
| 9576 | |
| 9577 | =item Testing Perl on Tru64 |
| 9578 | |
| 9579 | =item ext/ODBM_File/odbm Test Failing With Static Builds |
| 9580 | |
| 9581 | =item Perl Fails Because Of Unresolved Symbol sockatmark |
| 9582 | |
| 9583 | =item AUTHOR |
| 9584 | |
| 9585 | =back |
| 9586 | |
| 9587 | =head2 perluts - Perl under UTS |
| 9588 | |
| 9589 | =over 4 |
| 9590 | |
| 9591 | =item SYNOPSIS |
| 9592 | |
| 9593 | =item DESCRIPTION |
| 9594 | |
| 9595 | =item BUILDING PERL ON UTS |
| 9596 | |
| 9597 | =item Installing the built perl on UTS |
| 9598 | |
| 9599 | =item AUTHOR |
| 9600 | |
| 9601 | =back |
| 9602 | |
| 9603 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. |
| 9604 | |
| 9605 | =over 4 |
| 9606 | |
| 9607 | =item SYNOPSIS |
| 9608 | |
| 9609 | =item DESCRIPTION |
| 9610 | |
| 9611 | =over 4 |
| 9612 | |
| 9613 | =item Unpacking Perl Distribution on VM/ESA |
| 9614 | |
| 9615 | =item Setup Perl and utilities on VM/ESA |
| 9616 | |
| 9617 | =item Configure Perl on VM/ESA |
| 9618 | |
| 9619 | =item Testing Anomalies of Perl on VM/ESA |
| 9620 | |
| 9621 | =item Usage Hints for Perl on VM/ESA |
| 9622 | |
| 9623 | =back |
| 9624 | |
| 9625 | =item AUTHORS |
| 9626 | |
| 9627 | =item SEE ALSO |
| 9628 | |
| 9629 | =over 4 |
| 9630 | |
| 9631 | =item Mailing list for Perl on VM/ESA |
| 9632 | |
| 9633 | =back |
| 9634 | |
| 9635 | =back |
| 9636 | |
| 9637 | =head2 perlvms - VMS-specific documentation for Perl |
| 9638 | |
| 9639 | =over 4 |
| 9640 | |
| 9641 | =item DESCRIPTION |
| 9642 | |
| 9643 | =item Installation |
| 9644 | |
| 9645 | =item Organization of Perl Images |
| 9646 | |
| 9647 | =over 4 |
| 9648 | |
| 9649 | =item Core Images |
| 9650 | |
| 9651 | =item Perl Extensions |
| 9652 | |
| 9653 | =item Installing static extensions |
| 9654 | |
| 9655 | =item Installing dynamic extensions |
| 9656 | |
| 9657 | =back |
| 9658 | |
| 9659 | =item File specifications |
| 9660 | |
| 9661 | =over 4 |
| 9662 | |
| 9663 | =item Syntax |
| 9664 | |
| 9665 | =item Wildcard expansion |
| 9666 | |
| 9667 | =item Pipes |
| 9668 | |
| 9669 | =back |
| 9670 | |
| 9671 | =item PERL5LIB and PERLLIB |
| 9672 | |
| 9673 | =item Command line |
| 9674 | |
| 9675 | =over 4 |
| 9676 | |
| 9677 | =item I/O redirection and backgrounding |
| 9678 | |
| 9679 | =item Command line switches |
| 9680 | |
| 9681 | -i, -S, -u |
| 9682 | |
| 9683 | =back |
| 9684 | |
| 9685 | =item Perl functions |
| 9686 | |
| 9687 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, |
| 9688 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select |
| 9689 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime |
| 9690 | LIST, waitpid PID,FLAGS |
| 9691 | |
| 9692 | =item Perl variables |
| 9693 | |
| 9694 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| |
| 9695 | |
| 9696 | =item Standard modules with VMS-specific differences |
| 9697 | |
| 9698 | =over 4 |
| 9699 | |
| 9700 | =item SDBM_File |
| 9701 | |
| 9702 | =back |
| 9703 | |
| 9704 | =item Revision date |
| 9705 | |
| 9706 | =item AUTHOR |
| 9707 | |
| 9708 | =back |
| 9709 | |
| 9710 | =head2 perlvos, README.vos - Perl for Stratus VOS |
| 9711 | |
| 9712 | =over 4 |
| 9713 | |
| 9714 | =item SYNOPSIS |
| 9715 | |
| 9716 | =over 4 |
| 9717 | |
| 9718 | =item Multiple methods to build perl for VOS |
| 9719 | |
| 9720 | =item Stratus POSIX Support |
| 9721 | |
| 9722 | =back |
| 9723 | |
| 9724 | =item INSTALLING PERL IN VOS |
| 9725 | |
| 9726 | =over 4 |
| 9727 | |
| 9728 | =item Compiling Perl 5 on VOS |
| 9729 | |
| 9730 | =item Installing Perl 5 on VOS |
| 9731 | |
| 9732 | =back |
| 9733 | |
| 9734 | =item USING PERL IN VOS |
| 9735 | |
| 9736 | =over 4 |
| 9737 | |
| 9738 | =item Unimplemented Features of Perl on VOS |
| 9739 | |
| 9740 | =item Restrictions of Perl on VOS |
| 9741 | |
| 9742 | =item Handling of underflow and overflow |
| 9743 | |
| 9744 | =back |
| 9745 | |
| 9746 | =item TEST STATUS |
| 9747 | |
| 9748 | =item SUPPORT STATUS |
| 9749 | |
| 9750 | =item AUTHOR |
| 9751 | |
| 9752 | =item LAST UPDATE |
| 9753 | |
| 9754 | =back |
| 9755 | |
| 9756 | =head2 perlwin32 - Perl under Windows |
| 9757 | |
| 9758 | =over 4 |
| 9759 | |
| 9760 | =item SYNOPSIS |
| 9761 | |
| 9762 | =item DESCRIPTION |
| 9763 | |
| 9764 | =over 4 |
| 9765 | |
| 9766 | =item Setting Up Perl on Win32 |
| 9767 | |
| 9768 | Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual |
| 9769 | C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3 |
| 9770 | with gcc, MinGW release 1 with gcc |
| 9771 | |
| 9772 | =item Building |
| 9773 | |
| 9774 | =item Testing Perl on Win32 |
| 9775 | |
| 9776 | =item Installation of Perl on Win32 |
| 9777 | |
| 9778 | =item Usage Hints for Perl on Win32 |
| 9779 | |
| 9780 | Environment Variables, File Globbing, Using perl from the command line, |
| 9781 | Building Extensions, Command-line Wildcard Expansion, Win32 Specific |
| 9782 | Extensions, Notes on 64-bit Windows |
| 9783 | |
| 9784 | =item Running Perl Scripts |
| 9785 | |
| 9786 | =item Miscellaneous Things |
| 9787 | |
| 9788 | =back |
| 9789 | |
| 9790 | =item BUGS AND CAVEATS |
| 9791 | |
| 9792 | =item ACKNOWLEDGEMENTS |
| 9793 | |
| 9794 | =item AUTHORS |
| 9795 | |
| 9796 | Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy |
| 9797 | E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons |
| 9798 | E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>, |
| 9799 | Steve Hay E<lt>steve.hay@uk.radan.comE<gt> |
| 9800 | |
| 9801 | =item SEE ALSO |
| 9802 | |
| 9803 | =item HISTORY |
| 9804 | |
| 9805 | =back |
| 9806 | |
| 9807 | =head1 PRAGMA DOCUMENTATION |
| 9808 | |
| 9809 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
| 9810 | |
| 9811 | =over 4 |
| 9812 | |
| 9813 | =item SYNOPSIS |
| 9814 | |
| 9815 | =item DESCRIPTION |
| 9816 | |
| 9817 | method, locked |
| 9818 | |
| 9819 | =back |
| 9820 | |
| 9821 | =head2 re - Perl pragma to alter regular expression behaviour |
| 9822 | |
| 9823 | =over 4 |
| 9824 | |
| 9825 | =item SYNOPSIS |
| 9826 | |
| 9827 | =item DESCRIPTION |
| 9828 | |
| 9829 | =back |
| 9830 | |
| 9831 | =head2 threadshared::shared, threads::shared - Perl extension for sharing |
| 9832 | data structures between threads |
| 9833 | |
| 9834 | =over 4 |
| 9835 | |
| 9836 | =item SYNOPSIS |
| 9837 | |
| 9838 | =item DESCRIPTION |
| 9839 | |
| 9840 | =item EXPORT |
| 9841 | |
| 9842 | =item FUNCTIONS |
| 9843 | |
| 9844 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, |
| 9845 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, |
| 9846 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE |
| 9847 | |
| 9848 | =item NOTES |
| 9849 | |
| 9850 | =item BUGS |
| 9851 | |
| 9852 | =item AUTHOR |
| 9853 | |
| 9854 | =item SEE ALSO |
| 9855 | |
| 9856 | =back |
| 9857 | |
| 9858 | =head2 threads - Perl extension allowing use of interpreter based threads |
| 9859 | from perl |
| 9860 | |
| 9861 | =over 4 |
| 9862 | |
| 9863 | =item SYNOPSIS |
| 9864 | |
| 9865 | =item DESCRIPTION |
| 9866 | |
| 9867 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, |
| 9868 | threads->self, $thread->tid, threads->object( tid ), threads->yield();, |
| 9869 | threads->list();, async BLOCK; |
| 9870 | |
| 9871 | =item WARNINGS |
| 9872 | |
| 9873 | A thread exited while %d other threads were still running |
| 9874 | |
| 9875 | =item TODO |
| 9876 | |
| 9877 | =item BUGS |
| 9878 | |
| 9879 | Parent-Child threads, tid is I32, Returning objects, Creating threads |
| 9880 | inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be |
| 9881 | |
| 9882 | =item AUTHOR and COPYRIGHT |
| 9883 | |
| 9884 | =item SEE ALSO |
| 9885 | |
| 9886 | =back |
| 9887 | |
| 9888 | =head2 attributes - get/set subroutine or variable attributes |
| 9889 | |
| 9890 | =over 4 |
| 9891 | |
| 9892 | =item SYNOPSIS |
| 9893 | |
| 9894 | =item DESCRIPTION |
| 9895 | |
| 9896 | =over 4 |
| 9897 | |
| 9898 | =item Built-in Attributes |
| 9899 | |
| 9900 | locked, method, lvalue |
| 9901 | |
| 9902 | =item Available Subroutines |
| 9903 | |
| 9904 | get, reftype |
| 9905 | |
| 9906 | =item Package-specific Attribute Handling |
| 9907 | |
| 9908 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES |
| 9909 | |
| 9910 | =item Syntax of Attribute Lists |
| 9911 | |
| 9912 | =back |
| 9913 | |
| 9914 | =item EXPORTS |
| 9915 | |
| 9916 | =over 4 |
| 9917 | |
| 9918 | =item Default exports |
| 9919 | |
| 9920 | =item Available exports |
| 9921 | |
| 9922 | =item Export tags defined |
| 9923 | |
| 9924 | =back |
| 9925 | |
| 9926 | =item EXAMPLES |
| 9927 | |
| 9928 | =item SEE ALSO |
| 9929 | |
| 9930 | =back |
| 9931 | |
| 9932 | =head2 autouse - postpone load of modules until a function is used |
| 9933 | |
| 9934 | =over 4 |
| 9935 | |
| 9936 | =item SYNOPSIS |
| 9937 | |
| 9938 | =item DESCRIPTION |
| 9939 | |
| 9940 | =item WARNING |
| 9941 | |
| 9942 | =item AUTHOR |
| 9943 | |
| 9944 | =item SEE ALSO |
| 9945 | |
| 9946 | =back |
| 9947 | |
| 9948 | =head2 base - Establish IS-A relationship with base classes at compile time |
| 9949 | |
| 9950 | =over 4 |
| 9951 | |
| 9952 | =item SYNOPSIS |
| 9953 | |
| 9954 | =item DESCRIPTION |
| 9955 | |
| 9956 | =item DIAGNOSTICS |
| 9957 | |
| 9958 | Base class package "%s" is empty |
| 9959 | |
| 9960 | =item HISTORY |
| 9961 | |
| 9962 | =item CAVEATS |
| 9963 | |
| 9964 | =item SEE ALSO |
| 9965 | |
| 9966 | =back |
| 9967 | |
| 9968 | =head2 bigint - Transparent BigInteger support for Perl |
| 9969 | |
| 9970 | =over 4 |
| 9971 | |
| 9972 | =item SYNOPSIS |
| 9973 | |
| 9974 | =item DESCRIPTION |
| 9975 | |
| 9976 | =over 4 |
| 9977 | |
| 9978 | =item Options |
| 9979 | |
| 9980 | a or accuracy, p or precision, t or trace, l or lib, v or version |
| 9981 | |
| 9982 | =item Math Library |
| 9983 | |
| 9984 | =item Internal Format |
| 9985 | |
| 9986 | =item Sign |
| 9987 | |
| 9988 | =item Methods |
| 9989 | |
| 9990 | =item Caveat |
| 9991 | |
| 9992 | =back |
| 9993 | |
| 9994 | =item MODULES USED |
| 9995 | |
| 9996 | =item EXAMPLES |
| 9997 | |
| 9998 | =item LICENSE |
| 9999 | |
| 10000 | =item SEE ALSO |
| 10001 | |
| 10002 | =item AUTHORS |
| 10003 | |
| 10004 | =back |
| 10005 | |
| 10006 | =head2 bignum - Transparent BigNumber support for Perl |
| 10007 | |
| 10008 | =over 4 |
| 10009 | |
| 10010 | =item SYNOPSIS |
| 10011 | |
| 10012 | =item DESCRIPTION |
| 10013 | |
| 10014 | =over 4 |
| 10015 | |
| 10016 | =item Options |
| 10017 | |
| 10018 | a or accuracy, p or precision, t or trace, l or lib, v or version |
| 10019 | |
| 10020 | =item Methods |
| 10021 | |
| 10022 | =item Caveat |
| 10023 | |
| 10024 | inf(), NaN(), upgrade() |
| 10025 | |
| 10026 | =item MATH LIBRARY |
| 10027 | |
| 10028 | =item INTERNAL FORMAT |
| 10029 | |
| 10030 | =item SIGN |
| 10031 | |
| 10032 | =back |
| 10033 | |
| 10034 | =item MODULES USED |
| 10035 | |
| 10036 | =item EXAMPLES |
| 10037 | |
| 10038 | =item LICENSE |
| 10039 | |
| 10040 | =item SEE ALSO |
| 10041 | |
| 10042 | =item AUTHORS |
| 10043 | |
| 10044 | =back |
| 10045 | |
| 10046 | =head2 bigrat - Transparent BigNumber/BigRational support for Perl |
| 10047 | |
| 10048 | =over 4 |
| 10049 | |
| 10050 | =item SYNOPSIS |
| 10051 | |
| 10052 | =item DESCRIPTION |
| 10053 | |
| 10054 | =over 4 |
| 10055 | |
| 10056 | =item Modules Used |
| 10057 | |
| 10058 | =item Math Library |
| 10059 | |
| 10060 | =item Sign |
| 10061 | |
| 10062 | =item Methods |
| 10063 | |
| 10064 | =item Cavaet |
| 10065 | |
| 10066 | =item Options |
| 10067 | |
| 10068 | a or accuracy, p or precision, t or trace, l or lib, v or version |
| 10069 | |
| 10070 | =back |
| 10071 | |
| 10072 | =item EXAMPLES |
| 10073 | |
| 10074 | perl -Mbigrat -le 'print sqrt(33)' |
| 10075 | perl -Mbigrat -le 'print 2*255' |
| 10076 | perl -Mbigrat -le 'print 4.5+2*255' |
| 10077 | perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' |
| 10078 | perl -Mbigrat -le 'print 12->is_odd()'; |
| 10079 | |
| 10080 | =item LICENSE |
| 10081 | |
| 10082 | =item SEE ALSO |
| 10083 | |
| 10084 | =item AUTHORS |
| 10085 | |
| 10086 | =back |
| 10087 | |
| 10088 | =head2 blib - Use MakeMaker's uninstalled version of a package |
| 10089 | |
| 10090 | =over 4 |
| 10091 | |
| 10092 | =item SYNOPSIS |
| 10093 | |
| 10094 | =item DESCRIPTION |
| 10095 | |
| 10096 | =item BUGS |
| 10097 | |
| 10098 | =item AUTHOR |
| 10099 | |
| 10100 | =back |
| 10101 | |
| 10102 | =head2 bytes - Perl pragma to force byte semantics rather than character |
| 10103 | semantics |
| 10104 | |
| 10105 | =over 4 |
| 10106 | |
| 10107 | =item SYNOPSIS |
| 10108 | |
| 10109 | =item DESCRIPTION |
| 10110 | |
| 10111 | =item LIMITATIONS |
| 10112 | |
| 10113 | =item SEE ALSO |
| 10114 | |
| 10115 | =back |
| 10116 | |
| 10117 | =head2 charnames - define character names for C<\N{named}> string literal |
| 10118 | escapes |
| 10119 | |
| 10120 | =over 4 |
| 10121 | |
| 10122 | =item SYNOPSIS |
| 10123 | |
| 10124 | =item DESCRIPTION |
| 10125 | |
| 10126 | =item CUSTOM TRANSLATORS |
| 10127 | |
| 10128 | =item CUSTOM ALIASES |
| 10129 | |
| 10130 | =over 4 |
| 10131 | |
| 10132 | =item Anonymous hashes |
| 10133 | |
| 10134 | =item Alias file |
| 10135 | |
| 10136 | =item Alias shortcut |
| 10137 | |
| 10138 | =back |
| 10139 | |
| 10140 | =item charnames::viacode(code) |
| 10141 | |
| 10142 | =item charnames::vianame(name) |
| 10143 | |
| 10144 | =item ALIASES |
| 10145 | |
| 10146 | =item ILLEGAL CHARACTERS |
| 10147 | |
| 10148 | =item BUGS |
| 10149 | |
| 10150 | =back |
| 10151 | |
| 10152 | =head2 constant - Perl pragma to declare constants |
| 10153 | |
| 10154 | =over 4 |
| 10155 | |
| 10156 | =item SYNOPSIS |
| 10157 | |
| 10158 | =item DESCRIPTION |
| 10159 | |
| 10160 | =item NOTES |
| 10161 | |
| 10162 | =over 4 |
| 10163 | |
| 10164 | =item List constants |
| 10165 | |
| 10166 | =item Defining multiple constants at once |
| 10167 | |
| 10168 | =item Magic constants |
| 10169 | |
| 10170 | =back |
| 10171 | |
| 10172 | =item TECHNICAL NOTES |
| 10173 | |
| 10174 | =item BUGS |
| 10175 | |
| 10176 | =item AUTHOR |
| 10177 | |
| 10178 | =item COPYRIGHT |
| 10179 | |
| 10180 | =back |
| 10181 | |
| 10182 | =head2 diagnostics, splain - produce verbose warning diagnostics |
| 10183 | |
| 10184 | =over 4 |
| 10185 | |
| 10186 | =item SYNOPSIS |
| 10187 | |
| 10188 | =item DESCRIPTION |
| 10189 | |
| 10190 | =over 4 |
| 10191 | |
| 10192 | =item The C<diagnostics> Pragma |
| 10193 | |
| 10194 | =item The I<splain> Program |
| 10195 | |
| 10196 | =back |
| 10197 | |
| 10198 | =item EXAMPLES |
| 10199 | |
| 10200 | =item INTERNALS |
| 10201 | |
| 10202 | =item BUGS |
| 10203 | |
| 10204 | =item AUTHOR |
| 10205 | |
| 10206 | =back |
| 10207 | |
| 10208 | =head2 encoding - allows you to write your script in non-ascii or non-utf8 |
| 10209 | |
| 10210 | =over 4 |
| 10211 | |
| 10212 | =item SYNOPSIS |
| 10213 | |
| 10214 | =item ABSTRACT |
| 10215 | |
| 10216 | =over 4 |
| 10217 | |
| 10218 | =item Literal Conversions |
| 10219 | |
| 10220 | =item PerlIO layers for C<STD(IN|OUT)> |
| 10221 | |
| 10222 | =item Implicit upgrading for byte strings |
| 10223 | |
| 10224 | =back |
| 10225 | |
| 10226 | =item FEATURES THAT REQUIRE 5.8.1 |
| 10227 | |
| 10228 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle |
| 10229 | |
| 10230 | =item USAGE |
| 10231 | |
| 10232 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> |
| 10233 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; |
| 10234 | |
| 10235 | =item The Filter Option |
| 10236 | |
| 10237 | =over 4 |
| 10238 | |
| 10239 | =item Filter-related changes at Encode version 1.87 |
| 10240 | |
| 10241 | =back |
| 10242 | |
| 10243 | =item CAVEATS |
| 10244 | |
| 10245 | =over 4 |
| 10246 | |
| 10247 | =item NOT SCOPED |
| 10248 | |
| 10249 | =item DO NOT MIX MULTIPLE ENCODINGS |
| 10250 | |
| 10251 | =item tr/// with ranges |
| 10252 | |
| 10253 | Legend of characters above |
| 10254 | |
| 10255 | =back |
| 10256 | |
| 10257 | =item EXAMPLE - Greekperl |
| 10258 | |
| 10259 | =item KNOWN PROBLEMS |
| 10260 | |
| 10261 | literals in regex that are longer than 127 bytes, EBCDIC, format |
| 10262 | |
| 10263 | =over 4 |
| 10264 | |
| 10265 | =item The Logic of :locale |
| 10266 | |
| 10267 | =back |
| 10268 | |
| 10269 | =item HISTORY |
| 10270 | |
| 10271 | =item SEE ALSO |
| 10272 | |
| 10273 | =back |
| 10274 | |
| 10275 | =head2 fields - compile-time class fields |
| 10276 | |
| 10277 | =over 4 |
| 10278 | |
| 10279 | =item SYNOPSIS |
| 10280 | |
| 10281 | =item DESCRIPTION |
| 10282 | |
| 10283 | new, phash |
| 10284 | |
| 10285 | =item SEE ALSO |
| 10286 | |
| 10287 | =back |
| 10288 | |
| 10289 | =head2 filetest - Perl pragma to control the filetest permission operators |
| 10290 | |
| 10291 | =over 4 |
| 10292 | |
| 10293 | =item SYNOPSIS |
| 10294 | |
| 10295 | =item DESCRIPTION |
| 10296 | |
| 10297 | =over 4 |
| 10298 | |
| 10299 | =item subpragma access |
| 10300 | |
| 10301 | =back |
| 10302 | |
| 10303 | =back |
| 10304 | |
| 10305 | =head2 if - C<use> a Perl module if a condition holds |
| 10306 | |
| 10307 | =over 4 |
| 10308 | |
| 10309 | =item SYNOPSIS |
| 10310 | |
| 10311 | =item DESCRIPTION |
| 10312 | |
| 10313 | =item BUGS |
| 10314 | |
| 10315 | =item AUTHOR |
| 10316 | |
| 10317 | =back |
| 10318 | |
| 10319 | =head2 integer - Perl pragma to use integer arithmetic instead of floating |
| 10320 | point |
| 10321 | |
| 10322 | =over 4 |
| 10323 | |
| 10324 | =item SYNOPSIS |
| 10325 | |
| 10326 | =item DESCRIPTION |
| 10327 | |
| 10328 | =back |
| 10329 | |
| 10330 | =head2 less - perl pragma to request less of something from the compiler |
| 10331 | |
| 10332 | =over 4 |
| 10333 | |
| 10334 | =item SYNOPSIS |
| 10335 | |
| 10336 | =item DESCRIPTION |
| 10337 | |
| 10338 | =back |
| 10339 | |
| 10340 | =head2 lib - manipulate @INC at compile time |
| 10341 | |
| 10342 | =over 4 |
| 10343 | |
| 10344 | =item SYNOPSIS |
| 10345 | |
| 10346 | =item DESCRIPTION |
| 10347 | |
| 10348 | =over 4 |
| 10349 | |
| 10350 | =item Adding directories to @INC |
| 10351 | |
| 10352 | =item Deleting directories from @INC |
| 10353 | |
| 10354 | =item Restoring original @INC |
| 10355 | |
| 10356 | =back |
| 10357 | |
| 10358 | =item CAVEATS |
| 10359 | |
| 10360 | =item NOTES |
| 10361 | |
| 10362 | =item SEE ALSO |
| 10363 | |
| 10364 | =item AUTHOR |
| 10365 | |
| 10366 | =back |
| 10367 | |
| 10368 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
| 10369 | operations |
| 10370 | |
| 10371 | =over 4 |
| 10372 | |
| 10373 | =item SYNOPSIS |
| 10374 | |
| 10375 | =item DESCRIPTION |
| 10376 | |
| 10377 | =back |
| 10378 | |
| 10379 | =head2 open - perl pragma to set default PerlIO layers for input and output |
| 10380 | |
| 10381 | =over 4 |
| 10382 | |
| 10383 | =item SYNOPSIS |
| 10384 | |
| 10385 | =item DESCRIPTION |
| 10386 | |
| 10387 | =item NONPERLIO FUNCTIONALITY |
| 10388 | |
| 10389 | =item IMPLEMENTATION DETAILS |
| 10390 | |
| 10391 | =item SEE ALSO |
| 10392 | |
| 10393 | =back |
| 10394 | |
| 10395 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
| 10396 | |
| 10397 | =over 4 |
| 10398 | |
| 10399 | =item SYNOPSIS |
| 10400 | |
| 10401 | =item DESCRIPTION |
| 10402 | |
| 10403 | =item SEE ALSO |
| 10404 | |
| 10405 | =back |
| 10406 | |
| 10407 | =head2 overload - Package for overloading Perl operations |
| 10408 | |
| 10409 | =over 4 |
| 10410 | |
| 10411 | =item SYNOPSIS |
| 10412 | |
| 10413 | =item DESCRIPTION |
| 10414 | |
| 10415 | =over 4 |
| 10416 | |
| 10417 | =item Declaration of overloaded functions |
| 10418 | |
| 10419 | =item Calling Conventions for Binary Operations |
| 10420 | |
| 10421 | FALSE, TRUE, C<undef> |
| 10422 | |
| 10423 | =item Calling Conventions for Unary Operations |
| 10424 | |
| 10425 | =item Calling Conventions for Mutators |
| 10426 | |
| 10427 | C<++> and C<-->, C<x=> and other assignment versions |
| 10428 | |
| 10429 | =item Overloadable Operations |
| 10430 | |
| 10431 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
| 10432 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string |
| 10433 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
| 10434 | |
| 10435 | =item Inheritance and overloading |
| 10436 | |
| 10437 | Strings as values of C<use overload> directive, Overloading of an operation |
| 10438 | is inherited by derived classes |
| 10439 | |
| 10440 | =back |
| 10441 | |
| 10442 | =item SPECIAL SYMBOLS FOR C<use overload> |
| 10443 | |
| 10444 | =over 4 |
| 10445 | |
| 10446 | =item Last Resort |
| 10447 | |
| 10448 | =item Fallback |
| 10449 | |
| 10450 | C<undef>, TRUE, defined, but FALSE |
| 10451 | |
| 10452 | =item Copy Constructor |
| 10453 | |
| 10454 | B<Example> |
| 10455 | |
| 10456 | =back |
| 10457 | |
| 10458 | =item MAGIC AUTOGENERATION |
| 10459 | |
| 10460 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
| 10461 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, |
| 10462 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
| 10463 | I<Copy operator> |
| 10464 | |
| 10465 | =item Losing overloading |
| 10466 | |
| 10467 | =item Run-time Overloading |
| 10468 | |
| 10469 | =item Public functions |
| 10470 | |
| 10471 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
| 10472 | |
| 10473 | =item Overloading constants |
| 10474 | |
| 10475 | integer, float, binary, q, qr |
| 10476 | |
| 10477 | =item IMPLEMENTATION |
| 10478 | |
| 10479 | =item Metaphor clash |
| 10480 | |
| 10481 | =item Cookbook |
| 10482 | |
| 10483 | =over 4 |
| 10484 | |
| 10485 | =item Two-face scalars |
| 10486 | |
| 10487 | =item Two-face references |
| 10488 | |
| 10489 | =item Symbolic calculator |
| 10490 | |
| 10491 | =item I<Really> symbolic calculator |
| 10492 | |
| 10493 | =back |
| 10494 | |
| 10495 | =item AUTHOR |
| 10496 | |
| 10497 | =item DIAGNOSTICS |
| 10498 | |
| 10499 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
| 10500 | type, `%s' is not a code reference |
| 10501 | |
| 10502 | =item BUGS |
| 10503 | |
| 10504 | =back |
| 10505 | |
| 10506 | =head2 sigtrap - Perl pragma to enable simple signal handling |
| 10507 | |
| 10508 | =over 4 |
| 10509 | |
| 10510 | =item SYNOPSIS |
| 10511 | |
| 10512 | =item DESCRIPTION |
| 10513 | |
| 10514 | =item OPTIONS |
| 10515 | |
| 10516 | =over 4 |
| 10517 | |
| 10518 | =item SIGNAL HANDLERS |
| 10519 | |
| 10520 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
| 10521 | |
| 10522 | =item SIGNAL LISTS |
| 10523 | |
| 10524 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
| 10525 | |
| 10526 | =item OTHER |
| 10527 | |
| 10528 | B<untrapped>, B<any>, I<signal>, I<number> |
| 10529 | |
| 10530 | =back |
| 10531 | |
| 10532 | =item EXAMPLES |
| 10533 | |
| 10534 | =back |
| 10535 | |
| 10536 | =head2 sort - perl pragma to control sort() behaviour |
| 10537 | |
| 10538 | =over 4 |
| 10539 | |
| 10540 | =item SYNOPSIS |
| 10541 | |
| 10542 | =item DESCRIPTION |
| 10543 | |
| 10544 | =item CAVEATS |
| 10545 | |
| 10546 | =back |
| 10547 | |
| 10548 | =head2 strict - Perl pragma to restrict unsafe constructs |
| 10549 | |
| 10550 | =over 4 |
| 10551 | |
| 10552 | =item SYNOPSIS |
| 10553 | |
| 10554 | =item DESCRIPTION |
| 10555 | |
| 10556 | C<strict refs>, C<strict vars>, C<strict subs> |
| 10557 | |
| 10558 | =item HISTORY |
| 10559 | |
| 10560 | =back |
| 10561 | |
| 10562 | =head2 subs - Perl pragma to predeclare sub names |
| 10563 | |
| 10564 | =over 4 |
| 10565 | |
| 10566 | =item SYNOPSIS |
| 10567 | |
| 10568 | =item DESCRIPTION |
| 10569 | |
| 10570 | =back |
| 10571 | |
| 10572 | =head2 threadshared, threads::shared - Perl extension for sharing data |
| 10573 | structures between threads |
| 10574 | |
| 10575 | =over 4 |
| 10576 | |
| 10577 | =item SYNOPSIS |
| 10578 | |
| 10579 | =item DESCRIPTION |
| 10580 | |
| 10581 | =item EXPORT |
| 10582 | |
| 10583 | =item FUNCTIONS |
| 10584 | |
| 10585 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, |
| 10586 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, |
| 10587 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE |
| 10588 | |
| 10589 | =item NOTES |
| 10590 | |
| 10591 | =item BUGS |
| 10592 | |
| 10593 | =item AUTHOR |
| 10594 | |
| 10595 | =item SEE ALSO |
| 10596 | |
| 10597 | =back |
| 10598 | |
| 10599 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source |
| 10600 | code |
| 10601 | |
| 10602 | =over 4 |
| 10603 | |
| 10604 | =item SYNOPSIS |
| 10605 | |
| 10606 | =item DESCRIPTION |
| 10607 | |
| 10608 | =over 4 |
| 10609 | |
| 10610 | =item Utility functions |
| 10611 | |
| 10612 | $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[, |
| 10613 | FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag = |
| 10614 | utf8::is_utf8(STRING), $flag = utf8::valid(STRING) |
| 10615 | |
| 10616 | =back |
| 10617 | |
| 10618 | =item BUGS |
| 10619 | |
| 10620 | =item SEE ALSO |
| 10621 | |
| 10622 | =back |
| 10623 | |
| 10624 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) |
| 10625 | |
| 10626 | =over 4 |
| 10627 | |
| 10628 | =item SYNOPSIS |
| 10629 | |
| 10630 | =item DESCRIPTION |
| 10631 | |
| 10632 | =back |
| 10633 | |
| 10634 | =head2 vmsish - Perl pragma to control VMS-specific language features |
| 10635 | |
| 10636 | =over 4 |
| 10637 | |
| 10638 | =item SYNOPSIS |
| 10639 | |
| 10640 | =item DESCRIPTION |
| 10641 | |
| 10642 | C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> |
| 10643 | |
| 10644 | =back |
| 10645 | |
| 10646 | =head2 warnings - Perl pragma to control optional warnings |
| 10647 | |
| 10648 | =over 4 |
| 10649 | |
| 10650 | =item SYNOPSIS |
| 10651 | |
| 10652 | =item DESCRIPTION |
| 10653 | |
| 10654 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
| 10655 | warnings::enabled($object), warnings::warn($message), |
| 10656 | warnings::warn($category, $message), warnings::warn($object, $message), |
| 10657 | warnings::warnif($message), warnings::warnif($category, $message), |
| 10658 | warnings::warnif($object, $message) |
| 10659 | |
| 10660 | =back |
| 10661 | |
| 10662 | =head2 warnings::register - warnings import function |
| 10663 | |
| 10664 | =over 4 |
| 10665 | |
| 10666 | =item SYNOPSIS |
| 10667 | |
| 10668 | =item DESCRIPTION |
| 10669 | |
| 10670 | =back |
| 10671 | |
| 10672 | =head1 MODULE DOCUMENTATION |
| 10673 | |
| 10674 | =head2 AnyDBM_File - provide framework for multiple DBMs |
| 10675 | |
| 10676 | =over 4 |
| 10677 | |
| 10678 | =item SYNOPSIS |
| 10679 | |
| 10680 | =item DESCRIPTION |
| 10681 | |
| 10682 | =over 4 |
| 10683 | |
| 10684 | =item DBM Comparisons |
| 10685 | |
| 10686 | [0], [1], [2], [3] |
| 10687 | |
| 10688 | =back |
| 10689 | |
| 10690 | =item SEE ALSO |
| 10691 | |
| 10692 | =back |
| 10693 | |
| 10694 | =head2 Attribute::Handlers - Simpler definition of attribute handlers |
| 10695 | |
| 10696 | =over 4 |
| 10697 | |
| 10698 | =item VERSION |
| 10699 | |
| 10700 | =item SYNOPSIS |
| 10701 | |
| 10702 | =item DESCRIPTION |
| 10703 | |
| 10704 | [0], [1], [2], [3], [4], [5] |
| 10705 | |
| 10706 | =over 4 |
| 10707 | |
| 10708 | =item Typed lexicals |
| 10709 | |
| 10710 | =item Type-specific attribute handlers |
| 10711 | |
| 10712 | =item Non-interpretive attribute handlers |
| 10713 | |
| 10714 | =item Phase-specific attribute handlers |
| 10715 | |
| 10716 | =item Attributes as C<tie> interfaces |
| 10717 | |
| 10718 | =back |
| 10719 | |
| 10720 | =item EXAMPLES |
| 10721 | |
| 10722 | =item DIAGNOSTICS |
| 10723 | |
| 10724 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s |
| 10725 | attributes>, C<Declaration of %s attribute in package %s may clash with |
| 10726 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, |
| 10727 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't |
| 10728 | be able to apply END handler> |
| 10729 | |
| 10730 | =item AUTHOR |
| 10731 | |
| 10732 | =item BUGS |
| 10733 | |
| 10734 | =item COPYRIGHT |
| 10735 | |
| 10736 | =back |
| 10737 | |
| 10738 | =head2 AutoLoader - load subroutines only on demand |
| 10739 | |
| 10740 | =over 4 |
| 10741 | |
| 10742 | =item SYNOPSIS |
| 10743 | |
| 10744 | =item DESCRIPTION |
| 10745 | |
| 10746 | =over 4 |
| 10747 | |
| 10748 | =item Subroutine Stubs |
| 10749 | |
| 10750 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine |
| 10751 | |
| 10752 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
| 10753 | |
| 10754 | =item Package Lexicals |
| 10755 | |
| 10756 | =item Not Using AutoLoader |
| 10757 | |
| 10758 | =item B<AutoLoader> vs. B<SelfLoader> |
| 10759 | |
| 10760 | =back |
| 10761 | |
| 10762 | =item CAVEATS |
| 10763 | |
| 10764 | =item SEE ALSO |
| 10765 | |
| 10766 | =back |
| 10767 | |
| 10768 | =head2 AutoSplit - split a package for autoloading |
| 10769 | |
| 10770 | =over 4 |
| 10771 | |
| 10772 | =item SYNOPSIS |
| 10773 | |
| 10774 | =item DESCRIPTION |
| 10775 | |
| 10776 | $keep, $check, $modtime |
| 10777 | |
| 10778 | =over 4 |
| 10779 | |
| 10780 | =item Multiple packages |
| 10781 | |
| 10782 | =back |
| 10783 | |
| 10784 | =item DIAGNOSTICS |
| 10785 | |
| 10786 | =back |
| 10787 | |
| 10788 | =head2 B - The Perl Compiler |
| 10789 | |
| 10790 | =over 4 |
| 10791 | |
| 10792 | =item SYNOPSIS |
| 10793 | |
| 10794 | =item DESCRIPTION |
| 10795 | |
| 10796 | =item OVERVIEW |
| 10797 | |
| 10798 | =item Utility Functions |
| 10799 | |
| 10800 | =over 4 |
| 10801 | |
| 10802 | =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV> |
| 10803 | objects |
| 10804 | |
| 10805 | sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av, |
| 10806 | check_av, begin_av, end_av, comppadlist, regex_padav, main_cv |
| 10807 | |
| 10808 | =item Functions for Examining the Symbol Table |
| 10809 | |
| 10810 | walksymtable(SYMREF, METHOD, RECURSE, PREFIX) |
| 10811 | |
| 10812 | =item Functions Returning C<B::OP> objects or for walking op trees |
| 10813 | |
| 10814 | main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG) |
| 10815 | |
| 10816 | =item Miscellaneous Utility Functions |
| 10817 | |
| 10818 | ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), |
| 10819 | perlstring(STR), class(OBJ), threadsv_names |
| 10820 | |
| 10821 | =back |
| 10822 | |
| 10823 | =item OVERVIEW OF CLASSES |
| 10824 | |
| 10825 | =over 4 |
| 10826 | |
| 10827 | =item SV-RELATED CLASSES |
| 10828 | |
| 10829 | =item B::SV Methods |
| 10830 | |
| 10831 | REFCNT, FLAGS, object_2svref |
| 10832 | |
| 10833 | =item B::IV Methods |
| 10834 | |
| 10835 | IV, IVX, UVX, int_value, needs64bits, packiv |
| 10836 | |
| 10837 | =item B::NV Methods |
| 10838 | |
| 10839 | NV, NVX |
| 10840 | |
| 10841 | =item B::RV Methods |
| 10842 | |
| 10843 | RV |
| 10844 | |
| 10845 | =item B::PV Methods |
| 10846 | |
| 10847 | PV, RV, PVX |
| 10848 | |
| 10849 | =item B::PVMG Methods |
| 10850 | |
| 10851 | MAGIC, SvSTASH |
| 10852 | |
| 10853 | =item B::MAGIC Methods |
| 10854 | |
| 10855 | MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX |
| 10856 | |
| 10857 | =item B::PVLV Methods |
| 10858 | |
| 10859 | TARGOFF, TARGLEN, TYPE, TARG |
| 10860 | |
| 10861 | =item B::BM Methods |
| 10862 | |
| 10863 | USEFUL, PREVIOUS, RARE, TABLE |
| 10864 | |
| 10865 | =item B::GV Methods |
| 10866 | |
| 10867 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, |
| 10868 | LINE, FILE, FILEGV, GvREFCNT, FLAGS |
| 10869 | |
| 10870 | =item B::IO Methods |
| 10871 | |
| 10872 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
| 10873 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD |
| 10874 | |
| 10875 | =item B::AV Methods |
| 10876 | |
| 10877 | FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS |
| 10878 | |
| 10879 | =item B::CV Methods |
| 10880 | |
| 10881 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB, |
| 10882 | XSUBANY, CvFLAGS, const_sv |
| 10883 | |
| 10884 | =item B::HV Methods |
| 10885 | |
| 10886 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
| 10887 | |
| 10888 | =item OP-RELATED CLASSES |
| 10889 | |
| 10890 | =item B::OP Methods |
| 10891 | |
| 10892 | next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private, |
| 10893 | spare |
| 10894 | |
| 10895 | =item B::UNOP METHOD |
| 10896 | |
| 10897 | first |
| 10898 | |
| 10899 | =item B::BINOP METHOD |
| 10900 | |
| 10901 | last |
| 10902 | |
| 10903 | =item B::LOGOP METHOD |
| 10904 | |
| 10905 | other |
| 10906 | |
| 10907 | =item B::LISTOP METHOD |
| 10908 | |
| 10909 | children |
| 10910 | |
| 10911 | =item B::PMOP Methods |
| 10912 | |
| 10913 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, |
| 10914 | pmpermflags, precomp, pmoffset |
| 10915 | |
| 10916 | =item B::SVOP METHOD |
| 10917 | |
| 10918 | sv, gv |
| 10919 | |
| 10920 | =item B::PADOP METHOD |
| 10921 | |
| 10922 | padix |
| 10923 | |
| 10924 | =item B::PVOP METHOD |
| 10925 | |
| 10926 | pv |
| 10927 | |
| 10928 | =item B::LOOP Methods |
| 10929 | |
| 10930 | redoop, nextop, lastop |
| 10931 | |
| 10932 | =item B::COP Methods |
| 10933 | |
| 10934 | label, stash, stashpv, file, cop_seq, arybase, line, warnings, io |
| 10935 | |
| 10936 | =back |
| 10937 | |
| 10938 | =item AUTHOR |
| 10939 | |
| 10940 | =back |
| 10941 | |
| 10942 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
| 10943 | bytecode |
| 10944 | |
| 10945 | =over 4 |
| 10946 | |
| 10947 | =item SYNOPSIS |
| 10948 | |
| 10949 | =item DESCRIPTION |
| 10950 | |
| 10951 | %insn_data, @insn_name, @optype, @specialsv_name |
| 10952 | |
| 10953 | =item AUTHOR |
| 10954 | |
| 10955 | =back |
| 10956 | |
| 10957 | =head2 B::Assembler - Assemble Perl bytecode |
| 10958 | |
| 10959 | =over 4 |
| 10960 | |
| 10961 | =item SYNOPSIS |
| 10962 | |
| 10963 | =item DESCRIPTION |
| 10964 | |
| 10965 | =item AUTHORS |
| 10966 | |
| 10967 | =back |
| 10968 | |
| 10969 | =head2 B::Bblock - Walk basic blocks |
| 10970 | |
| 10971 | =over 4 |
| 10972 | |
| 10973 | =item SYNOPSIS |
| 10974 | |
| 10975 | =item DESCRIPTION |
| 10976 | |
| 10977 | =over 4 |
| 10978 | |
| 10979 | =item Functions |
| 10980 | |
| 10981 | B<find_leaders> |
| 10982 | |
| 10983 | =back |
| 10984 | |
| 10985 | =item AUTHOR |
| 10986 | |
| 10987 | =back |
| 10988 | |
| 10989 | =head2 B::Bytecode - Perl compiler's bytecode backend |
| 10990 | |
| 10991 | =over 4 |
| 10992 | |
| 10993 | =item SYNOPSIS |
| 10994 | |
| 10995 | =item DESCRIPTION |
| 10996 | |
| 10997 | =item EXAMPLE |
| 10998 | |
| 10999 | =item OPTIONS |
| 11000 | |
| 11001 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> |
| 11002 | |
| 11003 | =item KNOWN BUGS |
| 11004 | |
| 11005 | =item NOTICE |
| 11006 | |
| 11007 | =item AUTHORS |
| 11008 | |
| 11009 | =back |
| 11010 | |
| 11011 | =head2 B::C - Perl compiler's C backend |
| 11012 | |
| 11013 | =over 4 |
| 11014 | |
| 11015 | =item SYNOPSIS |
| 11016 | |
| 11017 | =item DESCRIPTION |
| 11018 | |
| 11019 | =item OPTIONS |
| 11020 | |
| 11021 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, |
| 11022 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, |
| 11023 | B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, |
| 11024 | B<-llimit> |
| 11025 | |
| 11026 | =item EXAMPLES |
| 11027 | |
| 11028 | =item BUGS |
| 11029 | |
| 11030 | =item AUTHOR |
| 11031 | |
| 11032 | =back |
| 11033 | |
| 11034 | =head2 B::CC - Perl compiler's optimized C translation backend |
| 11035 | |
| 11036 | =over 4 |
| 11037 | |
| 11038 | =item SYNOPSIS |
| 11039 | |
| 11040 | =item DESCRIPTION |
| 11041 | |
| 11042 | =item OPTIONS |
| 11043 | |
| 11044 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, |
| 11045 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, |
| 11046 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> |
| 11047 | |
| 11048 | =item EXAMPLES |
| 11049 | |
| 11050 | =item BUGS |
| 11051 | |
| 11052 | =item DIFFERENCES |
| 11053 | |
| 11054 | =over 4 |
| 11055 | |
| 11056 | =item Loops |
| 11057 | |
| 11058 | =item Context of ".." |
| 11059 | |
| 11060 | =item Arithmetic |
| 11061 | |
| 11062 | =item Deprecated features |
| 11063 | |
| 11064 | =back |
| 11065 | |
| 11066 | =item AUTHOR |
| 11067 | |
| 11068 | =back |
| 11069 | |
| 11070 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops |
| 11071 | |
| 11072 | =over 4 |
| 11073 | |
| 11074 | =item SYNOPSIS |
| 11075 | |
| 11076 | =item DESCRIPTION |
| 11077 | |
| 11078 | =item EXAMPLE |
| 11079 | |
| 11080 | =item OPTIONS |
| 11081 | |
| 11082 | =over 4 |
| 11083 | |
| 11084 | =item Options for Opcode Ordering |
| 11085 | |
| 11086 | B<-basic>, B<-exec>, B<-tree> |
| 11087 | |
| 11088 | =item Options for Line-Style |
| 11089 | |
| 11090 | B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env> |
| 11091 | |
| 11092 | =item Options for tree-specific formatting |
| 11093 | |
| 11094 | B<-compact>, B<-loose>, B<-vt>, B<-ascii> |
| 11095 | |
| 11096 | =item Options controlling sequence numbering |
| 11097 | |
| 11098 | B<-base>I<n>, B<-bigendian>, B<-littleendian> |
| 11099 | |
| 11100 | =item Other options |
| 11101 | |
| 11102 | B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref |
| 11103 | |
| 11104 | =item Option Stickiness |
| 11105 | |
| 11106 | =back |
| 11107 | |
| 11108 | =item ABBREVIATIONS |
| 11109 | |
| 11110 | =over 4 |
| 11111 | |
| 11112 | =item OP class abbreviations |
| 11113 | |
| 11114 | =item OP flags abbreviations |
| 11115 | |
| 11116 | =back |
| 11117 | |
| 11118 | =item FORMATTING SPECIFICATIONS |
| 11119 | |
| 11120 | =over 4 |
| 11121 | |
| 11122 | =item Special Patterns |
| 11123 | |
| 11124 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, |
| 11125 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, |
| 11126 | B<~> |
| 11127 | |
| 11128 | =item # Variables |
| 11129 | |
| 11130 | B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>, |
| 11131 | B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, |
| 11132 | B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, |
| 11133 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, |
| 11134 | B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, |
| 11135 | B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> |
| 11136 | |
| 11137 | =back |
| 11138 | |
| 11139 | =item Using B::Concise outside of the O framework |
| 11140 | |
| 11141 | =over 4 |
| 11142 | |
| 11143 | =item Example: Altering Concise Renderings |
| 11144 | |
| 11145 | =item set_style() |
| 11146 | |
| 11147 | =item set_style_standard($name) |
| 11148 | |
| 11149 | =item add_style() |
| 11150 | |
| 11151 | =item add_callback() |
| 11152 | |
| 11153 | =item Running B::Concise::compile() |
| 11154 | |
| 11155 | =item B::Concise::reset_sequence() |
| 11156 | |
| 11157 | =item Errors |
| 11158 | |
| 11159 | =back |
| 11160 | |
| 11161 | =item AUTHOR |
| 11162 | |
| 11163 | =back |
| 11164 | |
| 11165 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops |
| 11166 | |
| 11167 | =over 4 |
| 11168 | |
| 11169 | =item SYNOPSIS |
| 11170 | |
| 11171 | =item DESCRIPTION |
| 11172 | |
| 11173 | =item AUTHOR |
| 11174 | |
| 11175 | =back |
| 11176 | |
| 11177 | =head2 B::Deparse - Perl compiler backend to produce perl code |
| 11178 | |
| 11179 | =over 4 |
| 11180 | |
| 11181 | =item SYNOPSIS |
| 11182 | |
| 11183 | =item DESCRIPTION |
| 11184 | |
| 11185 | =item OPTIONS |
| 11186 | |
| 11187 | B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>, |
| 11188 | B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> |
| 11189 | |
| 11190 | =item USING B::Deparse AS A MODULE |
| 11191 | |
| 11192 | =over 4 |
| 11193 | |
| 11194 | =item Synopsis |
| 11195 | |
| 11196 | =item Description |
| 11197 | |
| 11198 | =item new |
| 11199 | |
| 11200 | =item ambient_pragmas |
| 11201 | |
| 11202 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits |
| 11203 | |
| 11204 | =item coderef2text |
| 11205 | |
| 11206 | =back |
| 11207 | |
| 11208 | =item BUGS |
| 11209 | |
| 11210 | =item AUTHOR |
| 11211 | |
| 11212 | =back |
| 11213 | |
| 11214 | =head2 B::Disassembler - Disassemble Perl bytecode |
| 11215 | |
| 11216 | =over 4 |
| 11217 | |
| 11218 | =item SYNOPSIS |
| 11219 | |
| 11220 | =item DESCRIPTION |
| 11221 | |
| 11222 | =item AUTHOR |
| 11223 | |
| 11224 | =back |
| 11225 | |
| 11226 | =head2 B::Lint - Perl lint |
| 11227 | |
| 11228 | =over 4 |
| 11229 | |
| 11230 | =item SYNOPSIS |
| 11231 | |
| 11232 | =item DESCRIPTION |
| 11233 | |
| 11234 | =item OPTIONS AND LINT CHECKS |
| 11235 | |
| 11236 | B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>, |
| 11237 | B<dollar-underscore>, B<private-names>, B<undefined-subs>, |
| 11238 | B<regexp-variables>, B<all>, B<none> |
| 11239 | |
| 11240 | =item NON LINT-CHECK OPTIONS |
| 11241 | |
| 11242 | B<-u Package> |
| 11243 | |
| 11244 | =item BUGS |
| 11245 | |
| 11246 | =item AUTHOR |
| 11247 | |
| 11248 | =back |
| 11249 | |
| 11250 | =head2 B::O, O - Generic interface to Perl Compiler backends |
| 11251 | |
| 11252 | =over 4 |
| 11253 | |
| 11254 | =item SYNOPSIS |
| 11255 | |
| 11256 | =item DESCRIPTION |
| 11257 | |
| 11258 | =item CONVENTIONS |
| 11259 | |
| 11260 | =item IMPLEMENTATION |
| 11261 | |
| 11262 | =item BUGS |
| 11263 | |
| 11264 | =item AUTHOR |
| 11265 | |
| 11266 | =back |
| 11267 | |
| 11268 | =head2 B::Showlex - Show lexical variables used in functions or files |
| 11269 | |
| 11270 | =over 4 |
| 11271 | |
| 11272 | =item SYNOPSIS |
| 11273 | |
| 11274 | =item DESCRIPTION |
| 11275 | |
| 11276 | =item EXAMPLES |
| 11277 | |
| 11278 | =over 4 |
| 11279 | |
| 11280 | =item OPTIONS |
| 11281 | |
| 11282 | =back |
| 11283 | |
| 11284 | =item SEE ALSO |
| 11285 | |
| 11286 | =item TODO |
| 11287 | |
| 11288 | =item AUTHOR |
| 11289 | |
| 11290 | =back |
| 11291 | |
| 11292 | =head2 B::Stackobj - Helper module for CC backend |
| 11293 | |
| 11294 | =over 4 |
| 11295 | |
| 11296 | =item SYNOPSIS |
| 11297 | |
| 11298 | =item DESCRIPTION |
| 11299 | |
| 11300 | =item AUTHOR |
| 11301 | |
| 11302 | =back |
| 11303 | |
| 11304 | =head2 B::Stash - show what stashes are loaded |
| 11305 | |
| 11306 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops |
| 11307 | |
| 11308 | =over 4 |
| 11309 | |
| 11310 | =item SYNOPSIS |
| 11311 | |
| 11312 | =item DESCRIPTION |
| 11313 | |
| 11314 | =item AUTHOR |
| 11315 | |
| 11316 | =back |
| 11317 | |
| 11318 | =head2 B::Xref - Generates cross reference reports for Perl programs |
| 11319 | |
| 11320 | =over 4 |
| 11321 | |
| 11322 | =item SYNOPSIS |
| 11323 | |
| 11324 | =item DESCRIPTION |
| 11325 | |
| 11326 | =item OPTIONS |
| 11327 | |
| 11328 | C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> |
| 11329 | |
| 11330 | =item BUGS |
| 11331 | |
| 11332 | =item AUTHOR |
| 11333 | |
| 11334 | =back |
| 11335 | |
| 11336 | =head2 Bblock, B::Bblock - Walk basic blocks |
| 11337 | |
| 11338 | =over 4 |
| 11339 | |
| 11340 | =item SYNOPSIS |
| 11341 | |
| 11342 | =item DESCRIPTION |
| 11343 | |
| 11344 | =over 4 |
| 11345 | |
| 11346 | =item Functions |
| 11347 | |
| 11348 | B<find_leaders> |
| 11349 | |
| 11350 | =back |
| 11351 | |
| 11352 | =item AUTHOR |
| 11353 | |
| 11354 | =back |
| 11355 | |
| 11356 | =head2 Benchmark - benchmark running times of Perl code |
| 11357 | |
| 11358 | =over 4 |
| 11359 | |
| 11360 | =item SYNOPSIS |
| 11361 | |
| 11362 | =item DESCRIPTION |
| 11363 | |
| 11364 | =over 4 |
| 11365 | |
| 11366 | =item Methods |
| 11367 | |
| 11368 | new, debug, iters |
| 11369 | |
| 11370 | =item Standard Exports |
| 11371 | |
| 11372 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), |
| 11373 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( |
| 11374 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) |
| 11375 | |
| 11376 | =item Optional Exports |
| 11377 | |
| 11378 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [ |
| 11379 | STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), |
| 11380 | disablecache ( ), enablecache ( ), timesum ( T1, T2 ) |
| 11381 | |
| 11382 | =item :hireswallclock |
| 11383 | |
| 11384 | =back |
| 11385 | |
| 11386 | =item NOTES |
| 11387 | |
| 11388 | =item EXAMPLES |
| 11389 | |
| 11390 | =item INHERITANCE |
| 11391 | |
| 11392 | =item CAVEATS |
| 11393 | |
| 11394 | =item SEE ALSO |
| 11395 | |
| 11396 | =item AUTHORS |
| 11397 | |
| 11398 | =item MODIFICATION HISTORY |
| 11399 | |
| 11400 | =back |
| 11401 | |
| 11402 | =head2 ByteLoader - load byte compiled perl code |
| 11403 | |
| 11404 | =over 4 |
| 11405 | |
| 11406 | =item SYNOPSIS |
| 11407 | |
| 11408 | =item DESCRIPTION |
| 11409 | |
| 11410 | =item AUTHOR |
| 11411 | |
| 11412 | =item SEE ALSO |
| 11413 | |
| 11414 | =back |
| 11415 | |
| 11416 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend |
| 11417 | |
| 11418 | =over 4 |
| 11419 | |
| 11420 | =item SYNOPSIS |
| 11421 | |
| 11422 | =item DESCRIPTION |
| 11423 | |
| 11424 | =item EXAMPLE |
| 11425 | |
| 11426 | =item OPTIONS |
| 11427 | |
| 11428 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> |
| 11429 | |
| 11430 | =item KNOWN BUGS |
| 11431 | |
| 11432 | =item NOTICE |
| 11433 | |
| 11434 | =item AUTHORS |
| 11435 | |
| 11436 | =back |
| 11437 | |
| 11438 | =head2 CGI - Simple Common Gateway Interface Class |
| 11439 | |
| 11440 | =over 4 |
| 11441 | |
| 11442 | =item SYNOPSIS |
| 11443 | |
| 11444 | =item ABSTRACT |
| 11445 | |
| 11446 | =item DESCRIPTION |
| 11447 | |
| 11448 | =over 4 |
| 11449 | |
| 11450 | =item PROGRAMMING STYLE |
| 11451 | |
| 11452 | =item CALLING CGI.PM ROUTINES |
| 11453 | |
| 11454 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): |
| 11455 | |
| 11456 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE |
| 11457 | |
| 11458 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: |
| 11459 | |
| 11460 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: |
| 11461 | |
| 11462 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: |
| 11463 | |
| 11464 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: |
| 11465 | |
| 11466 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: |
| 11467 | |
| 11468 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: |
| 11469 | |
| 11470 | =item DELETING A PARAMETER COMPLETELY: |
| 11471 | |
| 11472 | =item DELETING ALL PARAMETERS: |
| 11473 | |
| 11474 | =item HANDLING NON-URLENCODED ARGUMENTS |
| 11475 | |
| 11476 | =item DIRECT ACCESS TO THE PARAMETER LIST: |
| 11477 | |
| 11478 | =item FETCHING THE PARAMETER LIST AS A HASH: |
| 11479 | |
| 11480 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
| 11481 | |
| 11482 | =item RETRIEVING CGI ERRORS |
| 11483 | |
| 11484 | =item USING THE FUNCTION-ORIENTED INTERFACE |
| 11485 | |
| 11486 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, |
| 11487 | B<:standard>, B<:all> |
| 11488 | |
| 11489 | =item PRAGMAS |
| 11490 | |
| 11491 | -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph, |
| 11492 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, |
| 11493 | -private_tempfiles |
| 11494 | |
| 11495 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
| 11496 | |
| 11497 | 1. start_table() (generates a <table> tag), 2. end_table() (generates a |
| 11498 | </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates |
| 11499 | a </ul> tag) |
| 11500 | |
| 11501 | =back |
| 11502 | |
| 11503 | =item GENERATING DYNAMIC DOCUMENTS |
| 11504 | |
| 11505 | =over 4 |
| 11506 | |
| 11507 | =item CREATING A STANDARD HTTP HEADER: |
| 11508 | |
| 11509 | =item GENERATING A REDIRECTION HEADER |
| 11510 | |
| 11511 | =item CREATING THE HTML DOCUMENT HEADER |
| 11512 | |
| 11513 | B<Parameters:>, 4, 5, 6.. |
| 11514 | |
| 11515 | =item ENDING THE HTML DOCUMENT: |
| 11516 | |
| 11517 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: |
| 11518 | |
| 11519 | =item OBTAINING THE SCRIPT'S URL |
| 11520 | |
| 11521 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> |
| 11522 | (B<-query_string>), B<-base>, B<-rewrite> |
| 11523 | |
| 11524 | =item MIXING POST AND URL PARAMETERS |
| 11525 | |
| 11526 | =back |
| 11527 | |
| 11528 | =item CREATING STANDARD HTML ELEMENTS: |
| 11529 | |
| 11530 | =over 4 |
| 11531 | |
| 11532 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS |
| 11533 | |
| 11534 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS |
| 11535 | |
| 11536 | =item HTML SHORTCUTS AND LIST INTERPOLATION |
| 11537 | |
| 11538 | =item NON-STANDARD HTML SHORTCUTS |
| 11539 | |
| 11540 | =item AUTOESCAPING HTML |
| 11541 | |
| 11542 | $escaped_string = escapeHTML("unescaped string");, $charset = |
| 11543 | charset([$charset]);, $flag = autoEscape([$flag]); |
| 11544 | |
| 11545 | =item PRETTY-PRINTING HTML |
| 11546 | |
| 11547 | =back |
| 11548 | |
| 11549 | =item CREATING FILL-OUT FORMS: |
| 11550 | |
| 11551 | =over 4 |
| 11552 | |
| 11553 | =item CREATING AN ISINDEX TAG |
| 11554 | |
| 11555 | =item STARTING AND ENDING A FORM |
| 11556 | |
| 11557 | B<application/x-www-form-urlencoded>, B<multipart/form-data> |
| 11558 | |
| 11559 | =item FORM ELEMENTS |
| 11560 | |
| 11561 | B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>, |
| 11562 | B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>, |
| 11563 | B<-onSelect> |
| 11564 | |
| 11565 | =item CREATING A TEXT FIELD |
| 11566 | |
| 11567 | B<Parameters> |
| 11568 | |
| 11569 | =item CREATING A BIG TEXT FIELD |
| 11570 | |
| 11571 | =item CREATING A PASSWORD FIELD |
| 11572 | |
| 11573 | =item CREATING A FILE UPLOAD FIELD |
| 11574 | |
| 11575 | B<Parameters> |
| 11576 | |
| 11577 | =item CREATING A POPUP MENU |
| 11578 | |
| 11579 | =item CREATING AN OPTION GROUP |
| 11580 | |
| 11581 | =item CREATING A SCROLLING LIST |
| 11582 | |
| 11583 | B<Parameters:> |
| 11584 | |
| 11585 | =item CREATING A GROUP OF RELATED CHECKBOXES |
| 11586 | |
| 11587 | B<Parameters:> |
| 11588 | |
| 11589 | =item CREATING A STANDALONE CHECKBOX |
| 11590 | |
| 11591 | B<Parameters:> |
| 11592 | |
| 11593 | =item CREATING A RADIO BUTTON GROUP |
| 11594 | |
| 11595 | B<Parameters:> |
| 11596 | |
| 11597 | =item CREATING A SUBMIT BUTTON |
| 11598 | |
| 11599 | B<Parameters:> |
| 11600 | |
| 11601 | =item CREATING A RESET BUTTON |
| 11602 | |
| 11603 | =item CREATING A DEFAULT BUTTON |
| 11604 | |
| 11605 | =item CREATING A HIDDEN FIELD |
| 11606 | |
| 11607 | B<Parameters:> |
| 11608 | |
| 11609 | =item CREATING A CLICKABLE IMAGE BUTTON |
| 11610 | |
| 11611 | B<Parameters:>, 3. The third option (-align, optional) is an alignment |
| 11612 | type, and may be TOP, BOTTOM or MIDDLE |
| 11613 | |
| 11614 | =item CREATING A JAVASCRIPT ACTION BUTTON |
| 11615 | |
| 11616 | =back |
| 11617 | |
| 11618 | =item HTTP COOKIES |
| 11619 | |
| 11620 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, |
| 11621 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> |
| 11622 | |
| 11623 | =item WORKING WITH FRAMES |
| 11624 | |
| 11625 | 1. Create a <Frameset> document, 2. Specify the destination for the |
| 11626 | document in the HTTP header, 3. Specify the destination for the document in |
| 11627 | the <form> tag |
| 11628 | |
| 11629 | =item SUPPORT FOR JAVASCRIPT |
| 11630 | |
| 11631 | B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>, |
| 11632 | B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut> |
| 11633 | |
| 11634 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
| 11635 | |
| 11636 | =item DEBUGGING |
| 11637 | |
| 11638 | =over 4 |
| 11639 | |
| 11640 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS |
| 11641 | |
| 11642 | =back |
| 11643 | |
| 11644 | =item FETCHING ENVIRONMENT VARIABLES |
| 11645 | |
| 11646 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
| 11647 | B<path_translated()>, B<remote_host()>, B<script_name()> Return the script |
| 11648 | name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type |
| 11649 | ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, |
| 11650 | B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name |
| 11651 | ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()> |
| 11652 | |
| 11653 | =item USING NPH SCRIPTS |
| 11654 | |
| 11655 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
| 11656 | parameters |
| 11657 | |
| 11658 | =item Server Push |
| 11659 | |
| 11660 | multipart_init(), multipart_start(), multipart_end(), multipart_final() |
| 11661 | |
| 11662 | =item Avoiding Denial of Service Attacks |
| 11663 | |
| 11664 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
| 11665 | basis>, B<2. Globally for all scripts> |
| 11666 | |
| 11667 | =item COMPATIBILITY WITH CGI-LIB.PL |
| 11668 | |
| 11669 | =item AUTHOR INFORMATION |
| 11670 | |
| 11671 | =item CREDITS |
| 11672 | |
| 11673 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor |
| 11674 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell |
| 11675 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg |
| 11676 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
| 11677 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis |
| 11678 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen |
| 11679 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim |
| 11680 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks |
| 11681 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed |
| 11682 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug |
| 11683 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), |
| 11684 | ...and many many more.. |
| 11685 | |
| 11686 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT |
| 11687 | |
| 11688 | =item BUGS |
| 11689 | |
| 11690 | =item SEE ALSO |
| 11691 | |
| 11692 | =back |
| 11693 | |
| 11694 | =head2 CGI::Apache - Backward compatibility module for CGI.pm |
| 11695 | |
| 11696 | =over 4 |
| 11697 | |
| 11698 | =item SYNOPSIS |
| 11699 | |
| 11700 | =item ABSTRACT |
| 11701 | |
| 11702 | =item DESCRIPTION |
| 11703 | |
| 11704 | =item AUTHOR INFORMATION |
| 11705 | |
| 11706 | =item BUGS |
| 11707 | |
| 11708 | =item SEE ALSO |
| 11709 | |
| 11710 | =back |
| 11711 | |
| 11712 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or |
| 11713 | other) error log |
| 11714 | |
| 11715 | =over 4 |
| 11716 | |
| 11717 | =item SYNOPSIS |
| 11718 | |
| 11719 | =item DESCRIPTION |
| 11720 | |
| 11721 | =item REDIRECTING ERROR MESSAGES |
| 11722 | |
| 11723 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW |
| 11724 | |
| 11725 | =over 4 |
| 11726 | |
| 11727 | =item Changing the default message |
| 11728 | |
| 11729 | =back |
| 11730 | |
| 11731 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS |
| 11732 | |
| 11733 | =item OVERRIDING THE NAME OF THE PROGRAM |
| 11734 | |
| 11735 | =item AUTHORS |
| 11736 | |
| 11737 | =item SEE ALSO |
| 11738 | |
| 11739 | =back |
| 11740 | |
| 11741 | =head2 CGI::Cookie - Interface to Netscape Cookies |
| 11742 | |
| 11743 | =over 4 |
| 11744 | |
| 11745 | =item SYNOPSIS |
| 11746 | |
| 11747 | =item DESCRIPTION |
| 11748 | |
| 11749 | =item USING CGI::Cookie |
| 11750 | |
| 11751 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> |
| 11752 | |
| 11753 | =over 4 |
| 11754 | |
| 11755 | =item Creating New Cookies |
| 11756 | |
| 11757 | =item Sending the Cookie to the Browser |
| 11758 | |
| 11759 | =item Recovering Previous Cookies |
| 11760 | |
| 11761 | =item Manipulating Cookies |
| 11762 | |
| 11763 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> |
| 11764 | |
| 11765 | =back |
| 11766 | |
| 11767 | =item AUTHOR INFORMATION |
| 11768 | |
| 11769 | =item BUGS |
| 11770 | |
| 11771 | =item SEE ALSO |
| 11772 | |
| 11773 | =back |
| 11774 | |
| 11775 | =head2 CGI::Fast - CGI Interface for Fast CGI |
| 11776 | |
| 11777 | =over 4 |
| 11778 | |
| 11779 | =item SYNOPSIS |
| 11780 | |
| 11781 | =item DESCRIPTION |
| 11782 | |
| 11783 | =item OTHER PIECES OF THE PUZZLE |
| 11784 | |
| 11785 | =item WRITING FASTCGI PERL SCRIPTS |
| 11786 | |
| 11787 | =item INSTALLING FASTCGI SCRIPTS |
| 11788 | |
| 11789 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS |
| 11790 | |
| 11791 | =item EXTERNAL FASTCGI SERVER INVOCATION |
| 11792 | |
| 11793 | FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE |
| 11794 | |
| 11795 | =item CAVEATS |
| 11796 | |
| 11797 | =item AUTHOR INFORMATION |
| 11798 | |
| 11799 | =item BUGS |
| 11800 | |
| 11801 | =item SEE ALSO |
| 11802 | |
| 11803 | =back |
| 11804 | |
| 11805 | =head2 CGI::Pretty - module to produce nicely formatted HTML code |
| 11806 | |
| 11807 | =over 4 |
| 11808 | |
| 11809 | =item SYNOPSIS |
| 11810 | |
| 11811 | =item DESCRIPTION |
| 11812 | |
| 11813 | =over 4 |
| 11814 | |
| 11815 | =item Tags that won't be formatted |
| 11816 | |
| 11817 | =item Customizing the Indenting |
| 11818 | |
| 11819 | =back |
| 11820 | |
| 11821 | =item BUGS |
| 11822 | |
| 11823 | =item AUTHOR |
| 11824 | |
| 11825 | =item SEE ALSO |
| 11826 | |
| 11827 | =back |
| 11828 | |
| 11829 | =head2 CGI::Push - Simple Interface to Server Push |
| 11830 | |
| 11831 | =over 4 |
| 11832 | |
| 11833 | =item SYNOPSIS |
| 11834 | |
| 11835 | =item DESCRIPTION |
| 11836 | |
| 11837 | =item USING CGI::Push |
| 11838 | |
| 11839 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph |
| 11840 | |
| 11841 | =over 4 |
| 11842 | |
| 11843 | =item Heterogeneous Pages |
| 11844 | |
| 11845 | =item Changing the Page Delay on the Fly |
| 11846 | |
| 11847 | =back |
| 11848 | |
| 11849 | =item INSTALLING CGI::Push SCRIPTS |
| 11850 | |
| 11851 | =item AUTHOR INFORMATION |
| 11852 | |
| 11853 | =item BUGS |
| 11854 | |
| 11855 | =item SEE ALSO |
| 11856 | |
| 11857 | =back |
| 11858 | |
| 11859 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch |
| 11860 | |
| 11861 | =over 4 |
| 11862 | |
| 11863 | =item SYNOPSIS |
| 11864 | |
| 11865 | =item ABSTRACT |
| 11866 | |
| 11867 | =item DESCRIPTION |
| 11868 | |
| 11869 | =item AUTHOR INFORMATION |
| 11870 | |
| 11871 | =item BUGS |
| 11872 | |
| 11873 | =item SEE ALSO |
| 11874 | |
| 11875 | =back |
| 11876 | |
| 11877 | =head2 CGI::Util - Internal utilities used by CGI module |
| 11878 | |
| 11879 | =over 4 |
| 11880 | |
| 11881 | =item SYNOPSIS |
| 11882 | |
| 11883 | =item DESCRIPTION |
| 11884 | |
| 11885 | =item AUTHOR INFORMATION |
| 11886 | |
| 11887 | =item SEE ALSO |
| 11888 | |
| 11889 | =back |
| 11890 | |
| 11891 | =head2 CPAN - query, download and build perl modules from CPAN sites |
| 11892 | |
| 11893 | =over 4 |
| 11894 | |
| 11895 | =item SYNOPSIS |
| 11896 | |
| 11897 | =item STATUS |
| 11898 | |
| 11899 | =item DESCRIPTION |
| 11900 | |
| 11901 | =over 4 |
| 11902 | |
| 11903 | =item Interactive Mode |
| 11904 | |
| 11905 | Searching for authors, bundles, distribution files and modules, make, test, |
| 11906 | install, clean modules or distributions, get, readme, perldoc, look module |
| 11907 | or distribution, ls author, ls globbing_expresion, Signals |
| 11908 | |
| 11909 | =item CPAN::Shell |
| 11910 | |
| 11911 | =item autobundle |
| 11912 | |
| 11913 | =item recompile |
| 11914 | |
| 11915 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
| 11916 | |
| 11917 | =item Programmer's interface |
| 11918 | |
| 11919 | expand($type,@things), expandany(@things), Programming Examples |
| 11920 | |
| 11921 | =item Methods in the other Classes |
| 11922 | |
| 11923 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), |
| 11924 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), |
| 11925 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), |
| 11926 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), |
| 11927 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), |
| 11928 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), |
| 11929 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), |
| 11930 | CPAN::Bundle::readme(), CPAN::Bundle::test(), |
| 11931 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), |
| 11932 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), |
| 11933 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), |
| 11934 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), |
| 11935 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), |
| 11936 | CPAN::Distribution::look(), CPAN::Distribution::make(), |
| 11937 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), |
| 11938 | CPAN::Distribution::perldoc(), CPAN::Distribution::test(), |
| 11939 | CPAN::Distribution::uptodate(), CPAN::Index::force_reload(), |
| 11940 | CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(), |
| 11941 | CPAN::Module::as_string(), CPAN::Module::clean(), |
| 11942 | CPAN::Module::cpan_file(), CPAN::Module::cpan_version(), |
| 11943 | CPAN::Module::cvs_import(), CPAN::Module::description(), |
| 11944 | CPAN::Module::force($method,@args), CPAN::Module::get(), |
| 11945 | CPAN::Module::inst_file(), CPAN::Module::inst_version(), |
| 11946 | CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(), |
| 11947 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), |
| 11948 | CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(), |
| 11949 | CPAN::Module::userid() |
| 11950 | |
| 11951 | =item Cache Manager |
| 11952 | |
| 11953 | =item Bundles |
| 11954 | |
| 11955 | =item Prerequisites |
| 11956 | |
| 11957 | =item Finding packages and VERSION |
| 11958 | |
| 11959 | =item Debugging |
| 11960 | |
| 11961 | =item Floppy, Zip, Offline Mode |
| 11962 | |
| 11963 | =back |
| 11964 | |
| 11965 | =item CONFIGURATION |
| 11966 | |
| 11967 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> |
| 11968 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list |
| 11969 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> |
| 11970 | [unshift|push|splice] E<lt>listE<gt>> |
| 11971 | |
| 11972 | =over 4 |
| 11973 | |
| 11974 | =item Note on urllist parameter's format |
| 11975 | |
| 11976 | =item urllist parameter has CD-ROM support |
| 11977 | |
| 11978 | =back |
| 11979 | |
| 11980 | =item SECURITY |
| 11981 | |
| 11982 | =over 4 |
| 11983 | |
| 11984 | =item Cryptographically signed modules |
| 11985 | |
| 11986 | =back |
| 11987 | |
| 11988 | =item EXPORT |
| 11989 | |
| 11990 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
| 11991 | |
| 11992 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS |
| 11993 | |
| 11994 | =over 4 |
| 11995 | |
| 11996 | =item Three basic types of firewalls |
| 11997 | |
| 11998 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade |
| 11999 | |
| 12000 | =item Configuring lynx or ncftp for going through a firewall |
| 12001 | |
| 12002 | =back |
| 12003 | |
| 12004 | =item FAQ |
| 12005 | |
| 12006 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11) |
| 12007 | |
| 12008 | =item BUGS |
| 12009 | |
| 12010 | =item AUTHOR |
| 12011 | |
| 12012 | =item TRANSLATIONS |
| 12013 | |
| 12014 | =item SEE ALSO |
| 12015 | |
| 12016 | =back |
| 12017 | |
| 12018 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
| 12019 | |
| 12020 | =over 4 |
| 12021 | |
| 12022 | =item SYNOPSIS |
| 12023 | |
| 12024 | =item DESCRIPTION |
| 12025 | |
| 12026 | =back |
| 12027 | |
| 12028 | =head2 CPAN::Version - utility functions to compare CPAN versions |
| 12029 | |
| 12030 | =over 4 |
| 12031 | |
| 12032 | =item SYNOPSIS |
| 12033 | |
| 12034 | =item DESCRIPTION |
| 12035 | |
| 12036 | =back |
| 12037 | |
| 12038 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
| 12039 | module |
| 12040 | |
| 12041 | =over 4 |
| 12042 | |
| 12043 | =item SYNOPSIS |
| 12044 | |
| 12045 | =item DESCRIPTION |
| 12046 | |
| 12047 | =item SEE ALSO |
| 12048 | |
| 12049 | =back |
| 12050 | |
| 12051 | =head2 Carp, carp - warn of errors (from perspective of caller) |
| 12052 | |
| 12053 | =over 4 |
| 12054 | |
| 12055 | =item SYNOPSIS |
| 12056 | |
| 12057 | =item DESCRIPTION |
| 12058 | |
| 12059 | =over 4 |
| 12060 | |
| 12061 | =item Forcing a Stack Trace |
| 12062 | |
| 12063 | =back |
| 12064 | |
| 12065 | =back |
| 12066 | |
| 12067 | =over 4 |
| 12068 | |
| 12069 | =item GLOBAL VARIABLES |
| 12070 | |
| 12071 | =over 4 |
| 12072 | |
| 12073 | =item $Carp::CarpLevel |
| 12074 | |
| 12075 | =item $Carp::MaxEvalLen |
| 12076 | |
| 12077 | =item $Carp::MaxArgLen |
| 12078 | |
| 12079 | =item $Carp::MaxArgNums |
| 12080 | |
| 12081 | =item $Carp::Verbose |
| 12082 | |
| 12083 | =back |
| 12084 | |
| 12085 | =back |
| 12086 | |
| 12087 | =over 4 |
| 12088 | |
| 12089 | =item BUGS |
| 12090 | |
| 12091 | =back |
| 12092 | |
| 12093 | =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside |
| 12094 | |
| 12095 | =head2 Class::ISA -- report the search path for a class's ISA tree |
| 12096 | |
| 12097 | =over 4 |
| 12098 | |
| 12099 | =item SYNOPSIS |
| 12100 | |
| 12101 | =item DESCRIPTION |
| 12102 | |
| 12103 | =item FUNCTIONS |
| 12104 | |
| 12105 | the function Class::ISA::super_path($CLASS), the function |
| 12106 | Class::ISA::self_and_super_path($CLASS), the function |
| 12107 | Class::ISA::self_and_super_versions($CLASS) |
| 12108 | |
| 12109 | =item CAUTIONARY NOTES |
| 12110 | |
| 12111 | =item COPYRIGHT |
| 12112 | |
| 12113 | =item AUTHOR |
| 12114 | |
| 12115 | =back |
| 12116 | |
| 12117 | =head2 Class::Struct - declare struct-like datatypes as Perl classes |
| 12118 | |
| 12119 | =over 4 |
| 12120 | |
| 12121 | =item SYNOPSIS |
| 12122 | |
| 12123 | =item DESCRIPTION |
| 12124 | |
| 12125 | =over 4 |
| 12126 | |
| 12127 | =item The C<struct()> function |
| 12128 | |
| 12129 | =item Class Creation at Compile Time |
| 12130 | |
| 12131 | =item Element Types and Accessor Methods |
| 12132 | |
| 12133 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or |
| 12134 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) |
| 12135 | |
| 12136 | =item Initializing with C<new> |
| 12137 | |
| 12138 | =back |
| 12139 | |
| 12140 | =item EXAMPLES |
| 12141 | |
| 12142 | Example 1, Example 2, Example 3 |
| 12143 | |
| 12144 | =item Author and Modification History |
| 12145 | |
| 12146 | =back |
| 12147 | |
| 12148 | =head2 Config - access Perl configuration information |
| 12149 | |
| 12150 | =over 4 |
| 12151 | |
| 12152 | =item SYNOPSIS |
| 12153 | |
| 12154 | =item DESCRIPTION |
| 12155 | |
| 12156 | myconfig(), config_sh(), config_re($regex), config_vars(@names) |
| 12157 | |
| 12158 | =item EXAMPLE |
| 12159 | |
| 12160 | =item WARNING |
| 12161 | |
| 12162 | =item GLOSSARY |
| 12163 | |
| 12164 | =over 4 |
| 12165 | |
| 12166 | =item _ |
| 12167 | |
| 12168 | C<_a>, C<_exe>, C<_o> |
| 12169 | |
| 12170 | =item a |
| 12171 | |
| 12172 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, |
| 12173 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, |
| 12174 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, |
| 12175 | C<asctime_r_proto>, C<awk> |
| 12176 | |
| 12177 | =item b |
| 12178 | |
| 12179 | C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> |
| 12180 | |
| 12181 | =item c |
| 12182 | |
| 12183 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, |
| 12184 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, |
| 12185 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, |
| 12186 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, |
| 12187 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, |
| 12188 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, |
| 12189 | C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> |
| 12190 | |
| 12191 | =item d |
| 12192 | |
| 12193 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, |
| 12194 | C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, |
| 12195 | C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>, |
| 12196 | C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>, |
| 12197 | C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>, |
| 12198 | C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>, |
| 12199 | C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>, |
| 12200 | C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>, |
| 12201 | C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>, |
| 12202 | C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, |
| 12203 | C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, |
| 12204 | C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, |
| 12205 | C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>, |
| 12206 | C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>, |
| 12207 | C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>, |
| 12208 | C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, |
| 12209 | C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, |
| 12210 | C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, |
| 12211 | C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, |
| 12212 | C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, |
| 12213 | C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, |
| 12214 | C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>, |
| 12215 | C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, |
| 12216 | C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, |
| 12217 | C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, |
| 12218 | C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>, |
| 12219 | C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, |
| 12220 | C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, |
| 12221 | C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, |
| 12222 | C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, |
| 12223 | C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, |
| 12224 | C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, |
| 12225 | C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, |
| 12226 | C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, |
| 12227 | C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, |
| 12228 | C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, |
| 12229 | C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, |
| 12230 | C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, |
| 12231 | C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, |
| 12232 | C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, |
| 12233 | C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, |
| 12234 | C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>, |
| 12235 | C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, |
| 12236 | C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, |
| 12237 | C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, |
| 12238 | C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>, |
| 12239 | C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, |
| 12240 | C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, |
| 12241 | C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nanosleep>, |
| 12242 | C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, |
| 12243 | C<d_nv_zero_is_allbits_zero>, C<d_off64_t>, |
| 12244 | C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>, |
| 12245 | C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>, |
| 12246 | C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>, |
| 12247 | C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>, |
| 12248 | C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, |
| 12249 | C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>, |
| 12250 | C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, |
| 12251 | C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, |
| 12252 | C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, |
| 12253 | C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, |
| 12254 | C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, |
| 12255 | C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, |
| 12256 | C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, |
| 12257 | C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, |
| 12258 | C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, |
| 12259 | C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, |
| 12260 | C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, |
| 12261 | C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, |
| 12262 | C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, |
| 12263 | C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, |
| 12264 | C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, |
| 12265 | C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, |
| 12266 | C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, |
| 12267 | C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, |
| 12268 | C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, |
| 12269 | C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, |
| 12270 | C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, |
| 12271 | C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, |
| 12272 | C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, |
| 12273 | C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, |
| 12274 | C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, |
| 12275 | C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, |
| 12276 | C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>, |
| 12277 | C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, |
| 12278 | C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>, |
| 12279 | C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, |
| 12280 | C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>, |
| 12281 | C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, |
| 12282 | C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>, |
| 12283 | C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>, |
| 12284 | C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, |
| 12285 | C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>, |
| 12286 | C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, |
| 12287 | C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, |
| 12288 | C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, |
| 12289 | C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, |
| 12290 | C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> |
| 12291 | |
| 12292 | =item e |
| 12293 | |
| 12294 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, |
| 12295 | C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, |
| 12296 | C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, |
| 12297 | C<expr>, C<extensions>, C<extras> |
| 12298 | |
| 12299 | =item f |
| 12300 | |
| 12301 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, |
| 12302 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, |
| 12303 | C<full_sed> |
| 12304 | |
| 12305 | =item g |
| 12306 | |
| 12307 | C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, |
| 12308 | C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, |
| 12309 | C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, |
| 12310 | C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, |
| 12311 | C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, |
| 12312 | C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, |
| 12313 | C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, |
| 12314 | C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, |
| 12315 | C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, |
| 12316 | C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> |
| 12317 | |
| 12318 | =item h |
| 12319 | |
| 12320 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, |
| 12321 | C<html3dir>, C<html3direxp> |
| 12322 | |
| 12323 | =item i |
| 12324 | |
| 12325 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, |
| 12326 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, |
| 12327 | C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, |
| 12328 | C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, |
| 12329 | C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, |
| 12330 | C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, |
| 12331 | C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, |
| 12332 | C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, |
| 12333 | C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, |
| 12334 | C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, |
| 12335 | C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, |
| 12336 | C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, |
| 12337 | C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, |
| 12338 | C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, |
| 12339 | C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, |
| 12340 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, |
| 12341 | C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, |
| 12342 | C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, |
| 12343 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>, |
| 12344 | C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>, |
| 12345 | C<installprefixexp>, C<installprivlib>, C<installscript>, |
| 12346 | C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>, |
| 12347 | C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>, |
| 12348 | C<installsiteman3dir>, C<installsitescript>, C<installstyle>, |
| 12349 | C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, |
| 12350 | C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>, |
| 12351 | C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>, |
| 12352 | C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> |
| 12353 | |
| 12354 | =item k |
| 12355 | |
| 12356 | C<known_extensions>, C<ksh> |
| 12357 | |
| 12358 | =item l |
| 12359 | |
| 12360 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, |
| 12361 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, |
| 12362 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, |
| 12363 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, |
| 12364 | C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, |
| 12365 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, |
| 12366 | C<lseektype> |
| 12367 | |
| 12368 | =item m |
| 12369 | |
| 12370 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, |
| 12371 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, |
| 12372 | C<man3direxp>, C<man3ext> |
| 12373 | |
| 12374 | =item M |
| 12375 | |
| 12376 | C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, |
| 12377 | C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, |
| 12378 | C<myuname> |
| 12379 | |
| 12380 | =item n |
| 12381 | |
| 12382 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, |
| 12383 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, |
| 12384 | C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, |
| 12385 | C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, |
| 12386 | C<nvsize>, C<nvtype> |
| 12387 | |
| 12388 | =item o |
| 12389 | |
| 12390 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, |
| 12391 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> |
| 12392 | |
| 12393 | =item p |
| 12394 | |
| 12395 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, |
| 12396 | C<perl>, C<perl_patchlevel> |
| 12397 | |
| 12398 | =item P |
| 12399 | |
| 12400 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, |
| 12401 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, |
| 12402 | C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, |
| 12403 | C<procselfexe>, C<prototype>, C<ptrsize> |
| 12404 | |
| 12405 | =item q |
| 12406 | |
| 12407 | C<quadkind>, C<quadtype> |
| 12408 | |
| 12409 | =item r |
| 12410 | |
| 12411 | C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, |
| 12412 | C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, |
| 12413 | C<rmail>, C<run>, C<runnm> |
| 12414 | |
| 12415 | =item s |
| 12416 | |
| 12417 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, |
| 12418 | C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, |
| 12419 | C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, |
| 12420 | C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, |
| 12421 | C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, |
| 12422 | C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, |
| 12423 | C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, |
| 12424 | C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, |
| 12425 | C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, |
| 12426 | C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, |
| 12427 | C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, |
| 12428 | C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, |
| 12429 | C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, |
| 12430 | C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, |
| 12431 | C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, |
| 12432 | C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, |
| 12433 | C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, |
| 12434 | C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, |
| 12435 | C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, |
| 12436 | C<submit>, C<subversion>, C<sysman> |
| 12437 | |
| 12438 | =item t |
| 12439 | |
| 12440 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, |
| 12441 | C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, |
| 12442 | C<ttyname_r_proto> |
| 12443 | |
| 12444 | =item u |
| 12445 | |
| 12446 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, |
| 12447 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, |
| 12448 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, |
| 12449 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, |
| 12450 | C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>, |
| 12451 | C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, |
| 12452 | C<useperlio>, C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, |
| 12453 | C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, |
| 12454 | C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, |
| 12455 | C<uvXUformat> |
| 12456 | |
| 12457 | =item v |
| 12458 | |
| 12459 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, |
| 12460 | C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, |
| 12461 | C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, |
| 12462 | C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, |
| 12463 | C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, |
| 12464 | C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, |
| 12465 | C<versiononly>, C<vi>, C<voidflags> |
| 12466 | |
| 12467 | =item x |
| 12468 | |
| 12469 | C<xlibpth> |
| 12470 | |
| 12471 | =item y |
| 12472 | |
| 12473 | C<yacc>, C<yaccflags> |
| 12474 | |
| 12475 | =item z |
| 12476 | |
| 12477 | C<zcat>, C<zip> |
| 12478 | |
| 12479 | =back |
| 12480 | |
| 12481 | =item NOTE |
| 12482 | |
| 12483 | =back |
| 12484 | |
| 12485 | =head2 Cwd - get pathname of current working directory |
| 12486 | |
| 12487 | =over 4 |
| 12488 | |
| 12489 | =item SYNOPSIS |
| 12490 | |
| 12491 | =item DESCRIPTION |
| 12492 | |
| 12493 | =over 4 |
| 12494 | |
| 12495 | =item getcwd and friends |
| 12496 | |
| 12497 | getcwd, cwd, fastcwd, fastgetcwd, getdcwd |
| 12498 | |
| 12499 | =item abs_path and friends |
| 12500 | |
| 12501 | abs_path, realpath, fast_abs_path |
| 12502 | |
| 12503 | =item $ENV{PWD} |
| 12504 | |
| 12505 | =back |
| 12506 | |
| 12507 | =item NOTES |
| 12508 | |
| 12509 | =item AUTHOR |
| 12510 | |
| 12511 | =item COPYRIGHT |
| 12512 | |
| 12513 | =item SEE ALSO |
| 12514 | |
| 12515 | =back |
| 12516 | |
| 12517 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
| 12518 | subject to |
| 12519 | change) |
| 12520 | |
| 12521 | =over 4 |
| 12522 | |
| 12523 | =item SYNOPSIS |
| 12524 | |
| 12525 | =item DESCRIPTION |
| 12526 | |
| 12527 | =over 4 |
| 12528 | |
| 12529 | =item Global Variables |
| 12530 | |
| 12531 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, |
| 12532 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, |
| 12533 | $DB::lineno |
| 12534 | |
| 12535 | =item API Methods |
| 12536 | |
| 12537 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), |
| 12538 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() |
| 12539 | |
| 12540 | =item Client Callback Methods |
| 12541 | |
| 12542 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), |
| 12543 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), |
| 12544 | CLIENT->output(LIST) |
| 12545 | |
| 12546 | =back |
| 12547 | |
| 12548 | =item BUGS |
| 12549 | |
| 12550 | =item AUTHOR |
| 12551 | |
| 12552 | =back |
| 12553 | |
| 12554 | =head2 DBM_Filter -- Filter DBM keys/values |
| 12555 | |
| 12556 | =over 4 |
| 12557 | |
| 12558 | =item SYNOPSIS |
| 12559 | |
| 12560 | =item DESCRIPTION |
| 12561 | |
| 12562 | =item What is a DBM Filter? |
| 12563 | |
| 12564 | =over 4 |
| 12565 | |
| 12566 | =item So what's new? |
| 12567 | |
| 12568 | =back |
| 12569 | |
| 12570 | =item METHODS |
| 12571 | |
| 12572 | =over 4 |
| 12573 | |
| 12574 | =item $db->Filter_Push() |
| 12575 | |
| 12576 | =item $db->Filter_Key_Push() |
| 12577 | |
| 12578 | =item $db->Filter_Value_Push() |
| 12579 | |
| 12580 | Filter_Push, Filter_Key_Push, Filter_Value_Push |
| 12581 | |
| 12582 | =item $db->Filter_Pop() |
| 12583 | |
| 12584 | =item $db->Filtered() |
| 12585 | |
| 12586 | =back |
| 12587 | |
| 12588 | =item Writing a Filter |
| 12589 | |
| 12590 | =over 4 |
| 12591 | |
| 12592 | =item Immediate Filters |
| 12593 | |
| 12594 | =item Canned Filters |
| 12595 | |
| 12596 | "name", params |
| 12597 | |
| 12598 | =back |
| 12599 | |
| 12600 | =item Filters Included |
| 12601 | |
| 12602 | utf8, encode, compress, int32, null |
| 12603 | |
| 12604 | =item NOTES |
| 12605 | |
| 12606 | =over 4 |
| 12607 | |
| 12608 | =item Maintain Round Trip Integrity |
| 12609 | |
| 12610 | =item Don't mix filtered & non-filtered data in the same database file. |
| 12611 | |
| 12612 | =back |
| 12613 | |
| 12614 | =item EXAMPLE |
| 12615 | |
| 12616 | =item SEE ALSO |
| 12617 | |
| 12618 | =item AUTHOR |
| 12619 | |
| 12620 | =back |
| 12621 | |
| 12622 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
| 12623 | |
| 12624 | =over 4 |
| 12625 | |
| 12626 | =item SYNOPSIS |
| 12627 | |
| 12628 | =item DESCRIPTION |
| 12629 | |
| 12630 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
| 12631 | |
| 12632 | =over 4 |
| 12633 | |
| 12634 | =item Using DB_File with Berkeley DB version 2 or greater |
| 12635 | |
| 12636 | =item Interface to Berkeley DB |
| 12637 | |
| 12638 | =item Opening a Berkeley DB Database File |
| 12639 | |
| 12640 | =item Default Parameters |
| 12641 | |
| 12642 | =item In Memory Databases |
| 12643 | |
| 12644 | =back |
| 12645 | |
| 12646 | =item DB_HASH |
| 12647 | |
| 12648 | =over 4 |
| 12649 | |
| 12650 | =item A Simple Example |
| 12651 | |
| 12652 | =back |
| 12653 | |
| 12654 | =item DB_BTREE |
| 12655 | |
| 12656 | =over 4 |
| 12657 | |
| 12658 | =item Changing the BTREE sort order |
| 12659 | |
| 12660 | =item Handling Duplicate Keys |
| 12661 | |
| 12662 | =item The get_dup() Method |
| 12663 | |
| 12664 | =item The find_dup() Method |
| 12665 | |
| 12666 | =item The del_dup() Method |
| 12667 | |
| 12668 | =item Matching Partial Keys |
| 12669 | |
| 12670 | =back |
| 12671 | |
| 12672 | =item DB_RECNO |
| 12673 | |
| 12674 | =over 4 |
| 12675 | |
| 12676 | =item The 'bval' Option |
| 12677 | |
| 12678 | =item A Simple Example |
| 12679 | |
| 12680 | =item Extra RECNO Methods |
| 12681 | |
| 12682 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
| 12683 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, |
| 12684 | length, elements);> |
| 12685 | |
| 12686 | =item Another Example |
| 12687 | |
| 12688 | =back |
| 12689 | |
| 12690 | =item THE API INTERFACE |
| 12691 | |
| 12692 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
| 12693 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, |
| 12694 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, |
| 12695 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> |
| 12696 | |
| 12697 | =item DBM FILTERS |
| 12698 | |
| 12699 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
| 12700 | B<filter_fetch_value> |
| 12701 | |
| 12702 | =over 4 |
| 12703 | |
| 12704 | =item The Filter |
| 12705 | |
| 12706 | =item An Example -- the NULL termination problem. |
| 12707 | |
| 12708 | =item Another Example -- Key is a C int. |
| 12709 | |
| 12710 | =back |
| 12711 | |
| 12712 | =item HINTS AND TIPS |
| 12713 | |
| 12714 | =over 4 |
| 12715 | |
| 12716 | =item Locking: The Trouble with fd |
| 12717 | |
| 12718 | =item Safe ways to lock a database |
| 12719 | |
| 12720 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> |
| 12721 | |
| 12722 | =item Sharing Databases With C Applications |
| 12723 | |
| 12724 | =item The untie() Gotcha |
| 12725 | |
| 12726 | =back |
| 12727 | |
| 12728 | =item COMMON QUESTIONS |
| 12729 | |
| 12730 | =over 4 |
| 12731 | |
| 12732 | =item Why is there Perl source in my database? |
| 12733 | |
| 12734 | =item How do I store complex data structures with DB_File? |
| 12735 | |
| 12736 | =item What does "Invalid Argument" mean? |
| 12737 | |
| 12738 | =item What does "Bareword 'DB_File' not allowed" mean? |
| 12739 | |
| 12740 | =back |
| 12741 | |
| 12742 | =item REFERENCES |
| 12743 | |
| 12744 | =item HISTORY |
| 12745 | |
| 12746 | =item BUGS |
| 12747 | |
| 12748 | =item AVAILABILITY |
| 12749 | |
| 12750 | =item COPYRIGHT |
| 12751 | |
| 12752 | =item SEE ALSO |
| 12753 | |
| 12754 | =item AUTHOR |
| 12755 | |
| 12756 | =back |
| 12757 | |
| 12758 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
| 12759 | printing and C<eval> |
| 12760 | |
| 12761 | =over 4 |
| 12762 | |
| 12763 | =item SYNOPSIS |
| 12764 | |
| 12765 | =item DESCRIPTION |
| 12766 | |
| 12767 | =over 4 |
| 12768 | |
| 12769 | =item Methods |
| 12770 | |
| 12771 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
| 12772 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), |
| 12773 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), |
| 12774 | I<$OBJ>->Reset |
| 12775 | |
| 12776 | =item Functions |
| 12777 | |
| 12778 | Dumper(I<LIST>) |
| 12779 | |
| 12780 | =item Configuration Variables or Methods |
| 12781 | |
| 12782 | =item Exports |
| 12783 | |
| 12784 | Dumper |
| 12785 | |
| 12786 | =back |
| 12787 | |
| 12788 | =item EXAMPLES |
| 12789 | |
| 12790 | =item BUGS |
| 12791 | |
| 12792 | =over 4 |
| 12793 | |
| 12794 | =item NOTE |
| 12795 | |
| 12796 | =back |
| 12797 | |
| 12798 | =item AUTHOR |
| 12799 | |
| 12800 | =item VERSION |
| 12801 | |
| 12802 | =item SEE ALSO |
| 12803 | |
| 12804 | =back |
| 12805 | |
| 12806 | =head2 Devel::DProf - a Perl code profiler |
| 12807 | |
| 12808 | =over 4 |
| 12809 | |
| 12810 | =item SYNOPSIS |
| 12811 | |
| 12812 | =item DESCRIPTION |
| 12813 | |
| 12814 | =item PROFILE FORMAT |
| 12815 | |
| 12816 | =item AUTOLOAD |
| 12817 | |
| 12818 | =item ENVIRONMENT |
| 12819 | |
| 12820 | =item BUGS |
| 12821 | |
| 12822 | =item SEE ALSO |
| 12823 | |
| 12824 | =back |
| 12825 | |
| 12826 | =head2 Devel::PPPort - Perl/Pollution/Portability |
| 12827 | |
| 12828 | =over 4 |
| 12829 | |
| 12830 | =item SYNOPSIS |
| 12831 | |
| 12832 | =item DESCRIPTION |
| 12833 | |
| 12834 | =over 4 |
| 12835 | |
| 12836 | =item Why use ppport.h? |
| 12837 | |
| 12838 | You should use F<ppport.h> in modern code so that your code will work |
| 12839 | with the widest range of Perl interpreters possible, without significant |
| 12840 | additional work. |
| 12841 | |
| 12842 | =item How to use ppport.h |
| 12843 | |
| 12844 | =item Running ppport.h |
| 12845 | |
| 12846 | =back |
| 12847 | |
| 12848 | =item FUNCTIONS |
| 12849 | |
| 12850 | =over 4 |
| 12851 | |
| 12852 | =item WriteFile |
| 12853 | |
| 12854 | =back |
| 12855 | |
| 12856 | =item COMPATIBILITY |
| 12857 | |
| 12858 | =over 4 |
| 12859 | |
| 12860 | =item Provided Perl compatibility API |
| 12861 | |
| 12862 | =item Perl API not supported by ppport.h |
| 12863 | |
| 12864 | perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, |
| 12865 | perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, |
| 12866 | perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 |
| 12867 | |
| 12868 | =back |
| 12869 | |
| 12870 | =item BUGS |
| 12871 | |
| 12872 | =item AUTHORS |
| 12873 | |
| 12874 | =item COPYRIGHT |
| 12875 | |
| 12876 | =item SEE ALSO |
| 12877 | |
| 12878 | =back |
| 12879 | |
| 12880 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
| 12881 | |
| 12882 | =over 4 |
| 12883 | |
| 12884 | =item SYNOPSIS |
| 12885 | |
| 12886 | =item DESCRIPTION |
| 12887 | |
| 12888 | =over 4 |
| 12889 | |
| 12890 | =item Runtime debugging |
| 12891 | |
| 12892 | =item Memory footprint debugging |
| 12893 | |
| 12894 | =back |
| 12895 | |
| 12896 | =item EXAMPLES |
| 12897 | |
| 12898 | =over 4 |
| 12899 | |
| 12900 | =item A simple scalar string |
| 12901 | |
| 12902 | =item A simple scalar number |
| 12903 | |
| 12904 | =item A simple scalar with an extra reference |
| 12905 | |
| 12906 | =item A reference to a simple scalar |
| 12907 | |
| 12908 | =item A reference to an array |
| 12909 | |
| 12910 | =item A reference to a hash |
| 12911 | |
| 12912 | =item Dumping a large array or hash |
| 12913 | |
| 12914 | =item A reference to an SV which holds a C pointer |
| 12915 | |
| 12916 | =item A reference to a subroutine |
| 12917 | |
| 12918 | =back |
| 12919 | |
| 12920 | =item EXPORTS |
| 12921 | |
| 12922 | =item BUGS |
| 12923 | |
| 12924 | =item AUTHOR |
| 12925 | |
| 12926 | =item SEE ALSO |
| 12927 | |
| 12928 | =back |
| 12929 | |
| 12930 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
| 12931 | |
| 12932 | =over 4 |
| 12933 | |
| 12934 | =item SYNOPSIS |
| 12935 | |
| 12936 | =item DESCRIPTION |
| 12937 | |
| 12938 | =back |
| 12939 | |
| 12940 | =head2 Devel::Size - Perl extension for finding the memory usage of Perl |
| 12941 | variables |
| 12942 | |
| 12943 | =over 4 |
| 12944 | |
| 12945 | =item SYNOPSIS |
| 12946 | |
| 12947 | =item DESCRIPTION |
| 12948 | |
| 12949 | =item FUNCTIONS |
| 12950 | |
| 12951 | =over 4 |
| 12952 | |
| 12953 | =item size($ref) |
| 12954 | |
| 12955 | =item total_size($ref) |
| 12956 | |
| 12957 | =back |
| 12958 | |
| 12959 | =item EXPORT |
| 12960 | |
| 12961 | =item UNDERSTANDING MEMORY ALLOCATION |
| 12962 | |
| 12963 | =over 4 |
| 12964 | |
| 12965 | =item The C library |
| 12966 | |
| 12967 | =item Perl |
| 12968 | |
| 12969 | =back |
| 12970 | |
| 12971 | =item DANGERS |
| 12972 | |
| 12973 | =item Messages: texts originating from this module. |
| 12974 | |
| 12975 | =over 4 |
| 12976 | |
| 12977 | =item Errors |
| 12978 | |
| 12979 | =item warnings |
| 12980 | |
| 12981 | =back |
| 12982 | |
| 12983 | =item BUGS |
| 12984 | |
| 12985 | =item AUTHOR |
| 12986 | |
| 12987 | =item COPYRIGHT |
| 12988 | |
| 12989 | =item SEE ALSO |
| 12990 | |
| 12991 | =back |
| 12992 | |
| 12993 | =head2 Digest - Modules that calculate message digests |
| 12994 | |
| 12995 | =over 4 |
| 12996 | |
| 12997 | =item SYNOPSIS |
| 12998 | |
| 12999 | =item DESCRIPTION |
| 13000 | |
| 13001 | I<binary>, I<hex>, I<base64> |
| 13002 | |
| 13003 | =item OO INTERFACE |
| 13004 | |
| 13005 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = |
| 13006 | Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, |
| 13007 | $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( |
| 13008 | $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, |
| 13009 | $ctx->hexdigest, $ctx->b64digest |
| 13010 | |
| 13011 | =item Digest speed |
| 13012 | |
| 13013 | =item SEE ALSO |
| 13014 | |
| 13015 | =item AUTHOR |
| 13016 | |
| 13017 | =back |
| 13018 | |
| 13019 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm |
| 13020 | |
| 13021 | =over 4 |
| 13022 | |
| 13023 | =item SYNOPSIS |
| 13024 | |
| 13025 | =item DESCRIPTION |
| 13026 | |
| 13027 | =item FUNCTIONS |
| 13028 | |
| 13029 | md5($data,...), md5_hex($data,...), md5_base64($data,...) |
| 13030 | |
| 13031 | =item METHODS |
| 13032 | |
| 13033 | $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), |
| 13034 | $md5->addfile($io_handle), $md5->add_bits($data, $nbits), |
| 13035 | $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest |
| 13036 | |
| 13037 | =item EXAMPLES |
| 13038 | |
| 13039 | =item SEE ALSO |
| 13040 | |
| 13041 | =item COPYRIGHT |
| 13042 | |
| 13043 | =item AUTHORS |
| 13044 | |
| 13045 | =back |
| 13046 | |
| 13047 | =head2 Digest::base - Digest base class |
| 13048 | |
| 13049 | =over 4 |
| 13050 | |
| 13051 | =item SYNOPSIS |
| 13052 | |
| 13053 | =item DESCRIPTION |
| 13054 | |
| 13055 | =item SEE ALSO |
| 13056 | |
| 13057 | =back |
| 13058 | |
| 13059 | =head2 Digest::file - Calculate digests of files |
| 13060 | |
| 13061 | =over 4 |
| 13062 | |
| 13063 | =item SYNOPSIS |
| 13064 | |
| 13065 | =item DESCRIPTION |
| 13066 | |
| 13067 | digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, |
| 13068 | $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] |
| 13069 | ) |
| 13070 | |
| 13071 | =item SEE ALSO |
| 13072 | |
| 13073 | =back |
| 13074 | |
| 13075 | =head2 DirHandle - supply object methods for directory handles |
| 13076 | |
| 13077 | =over 4 |
| 13078 | |
| 13079 | =item SYNOPSIS |
| 13080 | |
| 13081 | =item DESCRIPTION |
| 13082 | |
| 13083 | =item NOTES |
| 13084 | |
| 13085 | =back |
| 13086 | |
| 13087 | =head2 Dumpvalue - provides screen dump of Perl data. |
| 13088 | |
| 13089 | =over 4 |
| 13090 | |
| 13091 | =item SYNOPSIS |
| 13092 | |
| 13093 | =item DESCRIPTION |
| 13094 | |
| 13095 | =over 4 |
| 13096 | |
| 13097 | =item Creation |
| 13098 | |
| 13099 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, |
| 13100 | C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, |
| 13101 | C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, |
| 13102 | stopDbSignal |
| 13103 | |
| 13104 | =item Methods |
| 13105 | |
| 13106 | dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, |
| 13107 | compactDump, veryCompact, set, get |
| 13108 | |
| 13109 | =back |
| 13110 | |
| 13111 | =back |
| 13112 | |
| 13113 | =head2 DynaLoader - Dynamically load C libraries into Perl code |
| 13114 | |
| 13115 | =over 4 |
| 13116 | |
| 13117 | =item SYNOPSIS |
| 13118 | |
| 13119 | =item DESCRIPTION |
| 13120 | |
| 13121 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, |
| 13122 | @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), |
| 13123 | dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), |
| 13124 | dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), |
| 13125 | dl_install_xsub(), bootstrap() |
| 13126 | |
| 13127 | =item AUTHOR |
| 13128 | |
| 13129 | =back |
| 13130 | |
| 13131 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into |
| 13132 | Perl code |
| 13133 | |
| 13134 | =over 4 |
| 13135 | |
| 13136 | =item VERSION |
| 13137 | |
| 13138 | =item SYNOPSIS |
| 13139 | |
| 13140 | =item DESCRIPTION |
| 13141 | |
| 13142 | =over 4 |
| 13143 | |
| 13144 | =item Migration from C<DynaLoader> |
| 13145 | |
| 13146 | =item Backward compatible boilerplate |
| 13147 | |
| 13148 | =back |
| 13149 | |
| 13150 | =item Order of initialization: early load() |
| 13151 | |
| 13152 | =over 4 |
| 13153 | |
| 13154 | =item The most hairy case |
| 13155 | |
| 13156 | =back |
| 13157 | |
| 13158 | =item DIAGNOSTICS |
| 13159 | |
| 13160 | Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined |
| 13161 | symbols present after loading %s: %s, XSLoader::load('Your::Module', |
| 13162 | $Your::Module::VERSION) |
| 13163 | |
| 13164 | =item LIMITATIONS |
| 13165 | |
| 13166 | =item BUGS |
| 13167 | |
| 13168 | =item SEE ALSO |
| 13169 | |
| 13170 | =item AUTHORS |
| 13171 | |
| 13172 | =item COPYRIGHT |
| 13173 | |
| 13174 | =back |
| 13175 | |
| 13176 | =head2 Encode - character encodings |
| 13177 | |
| 13178 | =over 4 |
| 13179 | |
| 13180 | =item SYNOPSIS |
| 13181 | |
| 13182 | =over 4 |
| 13183 | |
| 13184 | =item Table of Contents |
| 13185 | |
| 13186 | =back |
| 13187 | |
| 13188 | =item DESCRIPTION |
| 13189 | |
| 13190 | =over 4 |
| 13191 | |
| 13192 | =item TERMINOLOGY |
| 13193 | |
| 13194 | =back |
| 13195 | |
| 13196 | =item PERL ENCODING API |
| 13197 | |
| 13198 | $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, |
| 13199 | $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, |
| 13200 | CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, |
| 13201 | CHECK]); |
| 13202 | |
| 13203 | =over 4 |
| 13204 | |
| 13205 | =item Listing available encodings |
| 13206 | |
| 13207 | =item Defining Aliases |
| 13208 | |
| 13209 | =back |
| 13210 | |
| 13211 | =item Encoding via PerlIO |
| 13212 | |
| 13213 | =item Handling Malformed Data |
| 13214 | |
| 13215 | B<NOTE:> Not all encoding support this feature, I<CHECK> = |
| 13216 | Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> = |
| 13217 | Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> = |
| 13218 | Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML |
| 13219 | charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask |
| 13220 | |
| 13221 | =over 4 |
| 13222 | |
| 13223 | =item coderef for CHECK |
| 13224 | |
| 13225 | =back |
| 13226 | |
| 13227 | =item Defining Encodings |
| 13228 | |
| 13229 | =item The UTF-8 flag |
| 13230 | |
| 13231 | Goal #1:, Goal #2:, Goal #3:, Goal #4: |
| 13232 | |
| 13233 | =over 4 |
| 13234 | |
| 13235 | =item Messing with Perl's Internals |
| 13236 | |
| 13237 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) |
| 13238 | |
| 13239 | =back |
| 13240 | |
| 13241 | =item UTF-8 vs. utf8 |
| 13242 | |
| 13243 | =item SEE ALSO |
| 13244 | |
| 13245 | =item MAINTAINER |
| 13246 | |
| 13247 | =back |
| 13248 | |
| 13249 | =head2 Encode::Alias - alias definitions to encodings |
| 13250 | |
| 13251 | =over 4 |
| 13252 | |
| 13253 | =item SYNOPSIS |
| 13254 | |
| 13255 | =item DESCRIPTION |
| 13256 | |
| 13257 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code |
| 13258 | reference, e.g.: |
| 13259 | |
| 13260 | =over 4 |
| 13261 | |
| 13262 | =item Alias overloading |
| 13263 | |
| 13264 | =back |
| 13265 | |
| 13266 | =item SEE ALSO |
| 13267 | |
| 13268 | =back |
| 13269 | |
| 13270 | =head2 Encode::Byte - Single Byte Encodings |
| 13271 | |
| 13272 | =over 4 |
| 13273 | |
| 13274 | =item SYNOPSIS |
| 13275 | |
| 13276 | =item ABSTRACT |
| 13277 | |
| 13278 | =item DESCRIPTION |
| 13279 | |
| 13280 | =item SEE ALSO |
| 13281 | |
| 13282 | =back |
| 13283 | |
| 13284 | =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* |
| 13285 | |
| 13286 | =head2 Encode::CN - China-based Chinese Encodings |
| 13287 | |
| 13288 | =over 4 |
| 13289 | |
| 13290 | =item SYNOPSIS |
| 13291 | |
| 13292 | =item DESCRIPTION |
| 13293 | |
| 13294 | =item NOTES |
| 13295 | |
| 13296 | =item BUGS |
| 13297 | |
| 13298 | =item SEE ALSO |
| 13299 | |
| 13300 | =back |
| 13301 | |
| 13302 | =head2 Encode::CN::HZ -- internally used by Encode::CN |
| 13303 | |
| 13304 | =head2 Encode::Config -- internally used by Encode |
| 13305 | |
| 13306 | =head2 Encode::EBCDIC - EBCDIC Encodings |
| 13307 | |
| 13308 | =over 4 |
| 13309 | |
| 13310 | =item SYNOPSIS |
| 13311 | |
| 13312 | =item ABSTRACT |
| 13313 | |
| 13314 | =item DESCRIPTION |
| 13315 | |
| 13316 | =item SEE ALSO |
| 13317 | |
| 13318 | =back |
| 13319 | |
| 13320 | =head2 Encode::Encoding - Encode Implementation Base Class |
| 13321 | |
| 13322 | =over 4 |
| 13323 | |
| 13324 | =item SYNOPSIS |
| 13325 | |
| 13326 | =item DESCRIPTION |
| 13327 | |
| 13328 | =over 4 |
| 13329 | |
| 13330 | =item Methods you should implement |
| 13331 | |
| 13332 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), |
| 13333 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) |
| 13334 | |
| 13335 | =item Other methods defined in Encode::Encodings |
| 13336 | |
| 13337 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
| 13338 | -E<gt>needs_lines() |
| 13339 | |
| 13340 | =item Example: Encode::ROT13 |
| 13341 | |
| 13342 | =back |
| 13343 | |
| 13344 | =item Why the heck Encode API is different? |
| 13345 | |
| 13346 | =over 4 |
| 13347 | |
| 13348 | =item Compiled Encodings |
| 13349 | |
| 13350 | =back |
| 13351 | |
| 13352 | =item SEE ALSO |
| 13353 | |
| 13354 | Scheme 1, Scheme 2, Other Schemes |
| 13355 | |
| 13356 | =back |
| 13357 | |
| 13358 | =head2 Encode::Guess -- Guesses encoding from data |
| 13359 | |
| 13360 | =over 4 |
| 13361 | |
| 13362 | =item SYNOPSIS |
| 13363 | |
| 13364 | =item ABSTRACT |
| 13365 | |
| 13366 | =item DESCRIPTION |
| 13367 | |
| 13368 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, |
| 13369 | Encode::decode("Guess" ...), Encode::Guess->guess($data), |
| 13370 | guess_encoding($data, [, I<list of suspects>]) |
| 13371 | |
| 13372 | =item CAVEATS |
| 13373 | |
| 13374 | =item TO DO |
| 13375 | |
| 13376 | =item SEE ALSO |
| 13377 | |
| 13378 | =back |
| 13379 | |
| 13380 | =head2 Encode::JP - Japanese Encodings |
| 13381 | |
| 13382 | =over 4 |
| 13383 | |
| 13384 | =item SYNOPSIS |
| 13385 | |
| 13386 | =item ABSTRACT |
| 13387 | |
| 13388 | =item DESCRIPTION |
| 13389 | |
| 13390 | =item Note on ISO-2022-JP(-1)? |
| 13391 | |
| 13392 | =item BUGS |
| 13393 | |
| 13394 | =item SEE ALSO |
| 13395 | |
| 13396 | =back |
| 13397 | |
| 13398 | =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* |
| 13399 | |
| 13400 | =head2 Encode::JP::JIS7 -- internally used by Encode::JP |
| 13401 | |
| 13402 | =head2 Encode::KR - Korean Encodings |
| 13403 | |
| 13404 | =over 4 |
| 13405 | |
| 13406 | =item SYNOPSIS |
| 13407 | |
| 13408 | =item DESCRIPTION |
| 13409 | |
| 13410 | =item BUGS |
| 13411 | |
| 13412 | =item SEE ALSO |
| 13413 | |
| 13414 | =back |
| 13415 | |
| 13416 | =head2 Encode::KR::2022_KR -- internally used by Encode::KR |
| 13417 | |
| 13418 | =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding |
| 13419 | |
| 13420 | =over 4 |
| 13421 | |
| 13422 | =item SYNOPSIS |
| 13423 | |
| 13424 | =item ABSTRACT |
| 13425 | |
| 13426 | =item DESCRIPTION |
| 13427 | |
| 13428 | =item BUGS |
| 13429 | |
| 13430 | =item SEE ALSO |
| 13431 | |
| 13432 | =back |
| 13433 | |
| 13434 | =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO |
| 13435 | |
| 13436 | =over 4 |
| 13437 | |
| 13438 | =item Overview |
| 13439 | |
| 13440 | =item How does it work? |
| 13441 | |
| 13442 | =item Line Buffering |
| 13443 | |
| 13444 | =over 4 |
| 13445 | |
| 13446 | =item How can I tell whether my encoding fully supports PerlIO ? |
| 13447 | |
| 13448 | =back |
| 13449 | |
| 13450 | =item SEE ALSO |
| 13451 | |
| 13452 | =back |
| 13453 | |
| 13454 | =head2 Encode::Supported -- Encodings supported by Encode |
| 13455 | |
| 13456 | =over 4 |
| 13457 | |
| 13458 | =item DESCRIPTION |
| 13459 | |
| 13460 | =over 4 |
| 13461 | |
| 13462 | =item Encoding Names |
| 13463 | |
| 13464 | =back |
| 13465 | |
| 13466 | =item Supported Encodings |
| 13467 | |
| 13468 | =over 4 |
| 13469 | |
| 13470 | =item Built-in Encodings |
| 13471 | |
| 13472 | =item Encode::Unicode -- other Unicode encodings |
| 13473 | |
| 13474 | =item Encode::Byte -- Extended ASCII |
| 13475 | |
| 13476 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for |
| 13477 | the Cyrillic world, gsm0338 - Hentai Latin 1 |
| 13478 | |
| 13479 | =item CJK: Chinese, Japanese, Korean (Multibyte) |
| 13480 | |
| 13481 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, |
| 13482 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, |
| 13483 | Encode::JIS2K -- JIS X 0213 encodings via CPAN |
| 13484 | |
| 13485 | =item Miscellaneous encodings |
| 13486 | |
| 13487 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess |
| 13488 | |
| 13489 | =back |
| 13490 | |
| 13491 | =item Unsupported encodings |
| 13492 | |
| 13493 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, |
| 13494 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran |
| 13495 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, |
| 13496 | Various Mac encodings, (Mac) Indic encodings |
| 13497 | |
| 13498 | =item Encoding vs. Charset -- terminology |
| 13499 | |
| 13500 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) |
| 13501 | |
| 13502 | =over 4 |
| 13503 | |
| 13504 | =item Microsoft-related naming mess |
| 13505 | |
| 13506 | KS_C_5601-1987, GB2312, Big5, Shift_JIS |
| 13507 | |
| 13508 | =back |
| 13509 | |
| 13510 | =item Glossary |
| 13511 | |
| 13512 | character repertoire, coded character set (CCS), character encoding scheme |
| 13513 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, |
| 13514 | UTF-16 |
| 13515 | |
| 13516 | =item See Also |
| 13517 | |
| 13518 | =item References |
| 13519 | |
| 13520 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, |
| 13521 | RFC, UC, Unicode Glossary |
| 13522 | |
| 13523 | =over 4 |
| 13524 | |
| 13525 | =item Other Notable Sites |
| 13526 | |
| 13527 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: |
| 13528 | "Introduction to i18n" |
| 13529 | |
| 13530 | =item Offline sources |
| 13531 | |
| 13532 | C<CJKV Information Processing> by Ken Lunde |
| 13533 | |
| 13534 | =back |
| 13535 | |
| 13536 | =back |
| 13537 | |
| 13538 | =head2 Encode::Symbol - Symbol Encodings |
| 13539 | |
| 13540 | =over 4 |
| 13541 | |
| 13542 | =item SYNOPSIS |
| 13543 | |
| 13544 | =item ABSTRACT |
| 13545 | |
| 13546 | =item DESCRIPTION |
| 13547 | |
| 13548 | =item SEE ALSO |
| 13549 | |
| 13550 | =back |
| 13551 | |
| 13552 | =head2 Encode::TW - Taiwan-based Chinese Encodings |
| 13553 | |
| 13554 | =over 4 |
| 13555 | |
| 13556 | =item SYNOPSIS |
| 13557 | |
| 13558 | =item DESCRIPTION |
| 13559 | |
| 13560 | =item NOTES |
| 13561 | |
| 13562 | =item BUGS |
| 13563 | |
| 13564 | =item SEE ALSO |
| 13565 | |
| 13566 | =back |
| 13567 | |
| 13568 | =head2 Encode::Unicode -- Various Unicode Transformation Formats |
| 13569 | |
| 13570 | =over 4 |
| 13571 | |
| 13572 | =item SYNOPSIS |
| 13573 | |
| 13574 | =item ABSTRACT |
| 13575 | |
| 13576 | L<http://www.unicode.org/glossary/> says:, Quick Reference |
| 13577 | |
| 13578 | =item Size, Endianness, and BOM |
| 13579 | |
| 13580 | =over 4 |
| 13581 | |
| 13582 | =item by size |
| 13583 | |
| 13584 | =item by endianness |
| 13585 | |
| 13586 | BOM as integer when fetched in network byte order |
| 13587 | |
| 13588 | =back |
| 13589 | |
| 13590 | =item Surrogate Pairs |
| 13591 | |
| 13592 | =item Error Checking |
| 13593 | |
| 13594 | =item SEE ALSO |
| 13595 | |
| 13596 | =back |
| 13597 | |
| 13598 | =head2 Encode::Unicode::UTF7 -- UTF-7 encoding |
| 13599 | |
| 13600 | =over 4 |
| 13601 | |
| 13602 | =item SYNOPSIS |
| 13603 | |
| 13604 | =item ABSTRACT |
| 13605 | |
| 13606 | =item In Practice |
| 13607 | |
| 13608 | =item SEE ALSO |
| 13609 | |
| 13610 | =back |
| 13611 | |
| 13612 | =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to |
| 13613 | encodings |
| 13614 | |
| 13615 | =over 4 |
| 13616 | |
| 13617 | =item SYNOPSIS |
| 13618 | |
| 13619 | =item DESCRIPTION |
| 13620 | |
| 13621 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code |
| 13622 | reference, e.g.: |
| 13623 | |
| 13624 | =over 4 |
| 13625 | |
| 13626 | =item Alias overloading |
| 13627 | |
| 13628 | =back |
| 13629 | |
| 13630 | =item SEE ALSO |
| 13631 | |
| 13632 | =back |
| 13633 | |
| 13634 | =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- |
| 13635 | Internally used by Encode::??::ISO_2022_* |
| 13636 | |
| 13637 | =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by |
| 13638 | Encode::CN |
| 13639 | |
| 13640 | =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by |
| 13641 | Encode |
| 13642 | |
| 13643 | =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode |
| 13644 | Implementation Base Class |
| 13645 | |
| 13646 | =over 4 |
| 13647 | |
| 13648 | =item SYNOPSIS |
| 13649 | |
| 13650 | =item DESCRIPTION |
| 13651 | |
| 13652 | =over 4 |
| 13653 | |
| 13654 | =item Methods you should implement |
| 13655 | |
| 13656 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), |
| 13657 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) |
| 13658 | |
| 13659 | =item Other methods defined in Encode::Encodings |
| 13660 | |
| 13661 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
| 13662 | -E<gt>needs_lines() |
| 13663 | |
| 13664 | =item Example: Encode::ROT13 |
| 13665 | |
| 13666 | =back |
| 13667 | |
| 13668 | =item Why the heck Encode API is different? |
| 13669 | |
| 13670 | =over 4 |
| 13671 | |
| 13672 | =item Compiled Encodings |
| 13673 | |
| 13674 | =back |
| 13675 | |
| 13676 | =item SEE ALSO |
| 13677 | |
| 13678 | Scheme 1, Scheme 2, Other Schemes |
| 13679 | |
| 13680 | =back |
| 13681 | |
| 13682 | =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from |
| 13683 | data |
| 13684 | |
| 13685 | =over 4 |
| 13686 | |
| 13687 | =item SYNOPSIS |
| 13688 | |
| 13689 | =item ABSTRACT |
| 13690 | |
| 13691 | =item DESCRIPTION |
| 13692 | |
| 13693 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, |
| 13694 | Encode::decode("Guess" ...), Encode::Guess->guess($data), |
| 13695 | guess_encoding($data, [, I<list of suspects>]) |
| 13696 | |
| 13697 | =item CAVEATS |
| 13698 | |
| 13699 | =item TO DO |
| 13700 | |
| 13701 | =item SEE ALSO |
| 13702 | |
| 13703 | =back |
| 13704 | |
| 13705 | =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by |
| 13706 | Encode::JP::2022_JP* |
| 13707 | |
| 13708 | =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used |
| 13709 | by Encode::JP |
| 13710 | |
| 13711 | =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally |
| 13712 | used by Encode::KR |
| 13713 | |
| 13714 | =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' |
| 13715 | and 'Q' header encoding |
| 13716 | |
| 13717 | =over 4 |
| 13718 | |
| 13719 | =item SYNOPSIS |
| 13720 | |
| 13721 | =item ABSTRACT |
| 13722 | |
| 13723 | =item DESCRIPTION |
| 13724 | |
| 13725 | =item BUGS |
| 13726 | |
| 13727 | =item SEE ALSO |
| 13728 | |
| 13729 | =back |
| 13730 | |
| 13731 | =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document |
| 13732 | on Encode and PerlIO |
| 13733 | |
| 13734 | =over 4 |
| 13735 | |
| 13736 | =item Overview |
| 13737 | |
| 13738 | =item How does it work? |
| 13739 | |
| 13740 | =item Line Buffering |
| 13741 | |
| 13742 | =over 4 |
| 13743 | |
| 13744 | =item How can I tell whether my encoding fully supports PerlIO ? |
| 13745 | |
| 13746 | =back |
| 13747 | |
| 13748 | =item SEE ALSO |
| 13749 | |
| 13750 | =back |
| 13751 | |
| 13752 | =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings |
| 13753 | supported by Encode |
| 13754 | |
| 13755 | =over 4 |
| 13756 | |
| 13757 | =item DESCRIPTION |
| 13758 | |
| 13759 | =over 4 |
| 13760 | |
| 13761 | =item Encoding Names |
| 13762 | |
| 13763 | =back |
| 13764 | |
| 13765 | =item Supported Encodings |
| 13766 | |
| 13767 | =over 4 |
| 13768 | |
| 13769 | =item Built-in Encodings |
| 13770 | |
| 13771 | =item Encode::Unicode -- other Unicode encodings |
| 13772 | |
| 13773 | =item Encode::Byte -- Extended ASCII |
| 13774 | |
| 13775 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for |
| 13776 | the Cyrillic world, gsm0338 - Hentai Latin 1 |
| 13777 | |
| 13778 | =item CJK: Chinese, Japanese, Korean (Multibyte) |
| 13779 | |
| 13780 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, |
| 13781 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, |
| 13782 | Encode::JIS2K -- JIS X 0213 encodings via CPAN |
| 13783 | |
| 13784 | =item Miscellaneous encodings |
| 13785 | |
| 13786 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess |
| 13787 | |
| 13788 | =back |
| 13789 | |
| 13790 | =item Unsupported encodings |
| 13791 | |
| 13792 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, |
| 13793 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran |
| 13794 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, |
| 13795 | Various Mac encodings, (Mac) Indic encodings |
| 13796 | |
| 13797 | =item Encoding vs. Charset -- terminology |
| 13798 | |
| 13799 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) |
| 13800 | |
| 13801 | =over 4 |
| 13802 | |
| 13803 | =item Microsoft-related naming mess |
| 13804 | |
| 13805 | KS_C_5601-1987, GB2312, Big5, Shift_JIS |
| 13806 | |
| 13807 | =back |
| 13808 | |
| 13809 | =item Glossary |
| 13810 | |
| 13811 | character repertoire, coded character set (CCS), character encoding scheme |
| 13812 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, |
| 13813 | UTF-16 |
| 13814 | |
| 13815 | =item See Also |
| 13816 | |
| 13817 | =item References |
| 13818 | |
| 13819 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, |
| 13820 | RFC, UC, Unicode Glossary |
| 13821 | |
| 13822 | =over 4 |
| 13823 | |
| 13824 | =item Other Notable Sites |
| 13825 | |
| 13826 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: |
| 13827 | "Introduction to i18n" |
| 13828 | |
| 13829 | =item Offline sources |
| 13830 | |
| 13831 | C<CJKV Information Processing> by Ken Lunde |
| 13832 | |
| 13833 | =back |
| 13834 | |
| 13835 | =back |
| 13836 | |
| 13837 | =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 |
| 13838 | encoding |
| 13839 | |
| 13840 | =over 4 |
| 13841 | |
| 13842 | =item SYNOPSIS |
| 13843 | |
| 13844 | =item ABSTRACT |
| 13845 | |
| 13846 | =item In Practice |
| 13847 | |
| 13848 | =item SEE ALSO |
| 13849 | |
| 13850 | =back |
| 13851 | |
| 13852 | =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder |
| 13853 | |
| 13854 | =over 4 |
| 13855 | |
| 13856 | =item SYNOPSIS |
| 13857 | |
| 13858 | =item ABSTRACT |
| 13859 | |
| 13860 | =item Description |
| 13861 | |
| 13862 | =over 4 |
| 13863 | |
| 13864 | =item Predefined Methods |
| 13865 | |
| 13866 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), |
| 13867 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), |
| 13868 | $e-E<gt>bytes([$encoding]) |
| 13869 | |
| 13870 | =item Example: base64 transcoder |
| 13871 | |
| 13872 | =item Operator Overloading |
| 13873 | |
| 13874 | =back |
| 13875 | |
| 13876 | =item SEE ALSO |
| 13877 | |
| 13878 | =back |
| 13879 | |
| 13880 | =head2 Encodencoding, encoding - allows you to write your script in |
| 13881 | non-ascii or non-utf8 |
| 13882 | |
| 13883 | =over 4 |
| 13884 | |
| 13885 | =item SYNOPSIS |
| 13886 | |
| 13887 | =item ABSTRACT |
| 13888 | |
| 13889 | =over 4 |
| 13890 | |
| 13891 | =item Literal Conversions |
| 13892 | |
| 13893 | =item PerlIO layers for C<STD(IN|OUT)> |
| 13894 | |
| 13895 | =item Implicit upgrading for byte strings |
| 13896 | |
| 13897 | =back |
| 13898 | |
| 13899 | =item FEATURES THAT REQUIRE 5.8.1 |
| 13900 | |
| 13901 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle |
| 13902 | |
| 13903 | =item USAGE |
| 13904 | |
| 13905 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> |
| 13906 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; |
| 13907 | |
| 13908 | =item The Filter Option |
| 13909 | |
| 13910 | =over 4 |
| 13911 | |
| 13912 | =item Filter-related changes at Encode version 1.87 |
| 13913 | |
| 13914 | =back |
| 13915 | |
| 13916 | =item CAVEATS |
| 13917 | |
| 13918 | =over 4 |
| 13919 | |
| 13920 | =item NOT SCOPED |
| 13921 | |
| 13922 | =item DO NOT MIX MULTIPLE ENCODINGS |
| 13923 | |
| 13924 | =item tr/// with ranges |
| 13925 | |
| 13926 | Legend of characters above |
| 13927 | |
| 13928 | =back |
| 13929 | |
| 13930 | =item EXAMPLE - Greekperl |
| 13931 | |
| 13932 | =item KNOWN PROBLEMS |
| 13933 | |
| 13934 | literals in regex that are longer than 127 bytes, EBCDIC, format |
| 13935 | |
| 13936 | =over 4 |
| 13937 | |
| 13938 | =item The Logic of :locale |
| 13939 | |
| 13940 | =back |
| 13941 | |
| 13942 | =item HISTORY |
| 13943 | |
| 13944 | =item SEE ALSO |
| 13945 | |
| 13946 | =back |
| 13947 | |
| 13948 | =head2 Encoder, Encode::Encoder -- Object Oriented Encoder |
| 13949 | |
| 13950 | =over 4 |
| 13951 | |
| 13952 | =item SYNOPSIS |
| 13953 | |
| 13954 | =item ABSTRACT |
| 13955 | |
| 13956 | =item Description |
| 13957 | |
| 13958 | =over 4 |
| 13959 | |
| 13960 | =item Predefined Methods |
| 13961 | |
| 13962 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), |
| 13963 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), |
| 13964 | $e-E<gt>bytes([$encoding]) |
| 13965 | |
| 13966 | =item Example: base64 transcoder |
| 13967 | |
| 13968 | =item Operator Overloading |
| 13969 | |
| 13970 | =back |
| 13971 | |
| 13972 | =item SEE ALSO |
| 13973 | |
| 13974 | =back |
| 13975 | |
| 13976 | =head2 English - use nice English (or awk) names for ugly punctuation |
| 13977 | variables |
| 13978 | |
| 13979 | =over 4 |
| 13980 | |
| 13981 | =item SYNOPSIS |
| 13982 | |
| 13983 | =item DESCRIPTION |
| 13984 | |
| 13985 | =item PERFORMANCE |
| 13986 | |
| 13987 | =back |
| 13988 | |
| 13989 | =head2 Env - perl module that imports environment variables as scalars or |
| 13990 | arrays |
| 13991 | |
| 13992 | =over 4 |
| 13993 | |
| 13994 | =item SYNOPSIS |
| 13995 | |
| 13996 | =item DESCRIPTION |
| 13997 | |
| 13998 | =item LIMITATIONS |
| 13999 | |
| 14000 | =item AUTHOR |
| 14001 | |
| 14002 | =back |
| 14003 | |
| 14004 | =head2 Errno - System errno constants |
| 14005 | |
| 14006 | =over 4 |
| 14007 | |
| 14008 | =item SYNOPSIS |
| 14009 | |
| 14010 | =item DESCRIPTION |
| 14011 | |
| 14012 | =item CAVEATS |
| 14013 | |
| 14014 | =item AUTHOR |
| 14015 | |
| 14016 | =item COPYRIGHT |
| 14017 | |
| 14018 | =back |
| 14019 | |
| 14020 | =head2 Exporter - Implements default import method for modules |
| 14021 | |
| 14022 | =over 4 |
| 14023 | |
| 14024 | =item SYNOPSIS |
| 14025 | |
| 14026 | =item DESCRIPTION |
| 14027 | |
| 14028 | =over 4 |
| 14029 | |
| 14030 | =item How to Export |
| 14031 | |
| 14032 | =item Selecting What To Export |
| 14033 | |
| 14034 | =item How to Import |
| 14035 | |
| 14036 | C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> |
| 14037 | |
| 14038 | =back |
| 14039 | |
| 14040 | =item Advanced features |
| 14041 | |
| 14042 | =over 4 |
| 14043 | |
| 14044 | =item Specialised Import Lists |
| 14045 | |
| 14046 | =item Exporting without using Exporter's import method |
| 14047 | |
| 14048 | =item Exporting without inheriting from Exporter |
| 14049 | |
| 14050 | =item Module Version Checking |
| 14051 | |
| 14052 | =item Managing Unknown Symbols |
| 14053 | |
| 14054 | =item Tag Handling Utility Functions |
| 14055 | |
| 14056 | =item Generating combined tags |
| 14057 | |
| 14058 | =item C<AUTOLOAD>ed Constants |
| 14059 | |
| 14060 | =back |
| 14061 | |
| 14062 | =back |
| 14063 | |
| 14064 | =head2 Exporter::Heavy - Exporter guts |
| 14065 | |
| 14066 | =over 4 |
| 14067 | |
| 14068 | =item SYNOPSIS |
| 14069 | |
| 14070 | =item DESCRIPTION |
| 14071 | |
| 14072 | =back |
| 14073 | |
| 14074 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
| 14075 | Makefiles etc. |
| 14076 | |
| 14077 | =over 4 |
| 14078 | |
| 14079 | =item SYNOPSIS |
| 14080 | |
| 14081 | =item DESCRIPTION |
| 14082 | |
| 14083 | =back |
| 14084 | |
| 14085 | cat |
| 14086 | |
| 14087 | eqtime |
| 14088 | |
| 14089 | rm_rf |
| 14090 | |
| 14091 | rm_f |
| 14092 | |
| 14093 | touch |
| 14094 | |
| 14095 | mv |
| 14096 | |
| 14097 | cp |
| 14098 | |
| 14099 | chmod |
| 14100 | |
| 14101 | mkpath |
| 14102 | |
| 14103 | test_f |
| 14104 | |
| 14105 | dos2unix |
| 14106 | |
| 14107 | =over 4 |
| 14108 | |
| 14109 | =item SEE ALSO |
| 14110 | |
| 14111 | =item AUTHOR |
| 14112 | |
| 14113 | =back |
| 14114 | |
| 14115 | =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles |
| 14116 | |
| 14117 | =over 4 |
| 14118 | |
| 14119 | =item SYNOPSIS |
| 14120 | |
| 14121 | =item DESCRIPTION |
| 14122 | |
| 14123 | B<test_harness> |
| 14124 | |
| 14125 | =back |
| 14126 | |
| 14127 | B<pod2man> |
| 14128 | |
| 14129 | B<warn_if_old_packlist> |
| 14130 | |
| 14131 | B<perllocal_install> |
| 14132 | |
| 14133 | B<uninstall> |
| 14134 | |
| 14135 | =head2 ExtUtils::Constant - generate XS code to import C header constants |
| 14136 | |
| 14137 | =over 4 |
| 14138 | |
| 14139 | =item SYNOPSIS |
| 14140 | |
| 14141 | =item DESCRIPTION |
| 14142 | |
| 14143 | =item USAGE |
| 14144 | |
| 14145 | IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF |
| 14146 | |
| 14147 | =item FUNCTIONS |
| 14148 | |
| 14149 | =back |
| 14150 | |
| 14151 | constant_types |
| 14152 | |
| 14153 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME |
| 14154 | |
| 14155 | autoload PACKAGE, VERSION, AUTOLOADER |
| 14156 | |
| 14157 | WriteMakefileSnippet |
| 14158 | |
| 14159 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, |
| 14160 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME |
| 14161 | |
| 14162 | =over 4 |
| 14163 | |
| 14164 | =item AUTHOR |
| 14165 | |
| 14166 | =back |
| 14167 | |
| 14168 | =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects |
| 14169 | |
| 14170 | =over 4 |
| 14171 | |
| 14172 | =item SYNOPSIS |
| 14173 | |
| 14174 | =item DESCRIPTION |
| 14175 | |
| 14176 | =item USAGE |
| 14177 | |
| 14178 | =back |
| 14179 | |
| 14180 | header |
| 14181 | |
| 14182 | memEQ_clause args_hashref |
| 14183 | |
| 14184 | dump_names arg_hashref, ITEM.. |
| 14185 | |
| 14186 | assign arg_hashref, VALUE.. |
| 14187 | |
| 14188 | return_clause arg_hashref, ITEM |
| 14189 | |
| 14190 | switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. |
| 14191 | |
| 14192 | params WHAT |
| 14193 | |
| 14194 | dogfood arg_hashref, ITEM.. |
| 14195 | |
| 14196 | C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, |
| 14197 | post, def_pre, def_post, utf8, weight |
| 14198 | |
| 14199 | =over 4 |
| 14200 | |
| 14201 | =item BUGS |
| 14202 | |
| 14203 | =item AUTHOR |
| 14204 | |
| 14205 | =back |
| 14206 | |
| 14207 | =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant |
| 14208 | |
| 14209 | =over 4 |
| 14210 | |
| 14211 | =item SYNOPSIS |
| 14212 | |
| 14213 | =item DESCRIPTION |
| 14214 | |
| 14215 | =item USAGE |
| 14216 | |
| 14217 | C_stringify NAME |
| 14218 | |
| 14219 | =back |
| 14220 | |
| 14221 | perl_stringify NAME |
| 14222 | |
| 14223 | =over 4 |
| 14224 | |
| 14225 | =item AUTHOR |
| 14226 | |
| 14227 | =back |
| 14228 | |
| 14229 | =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for |
| 14230 | ExtUtils::Constant objects |
| 14231 | |
| 14232 | =over 4 |
| 14233 | |
| 14234 | =item SYNOPSIS |
| 14235 | |
| 14236 | =item DESCRIPTION |
| 14237 | |
| 14238 | =item BUGS |
| 14239 | |
| 14240 | =item AUTHOR |
| 14241 | |
| 14242 | =back |
| 14243 | |
| 14244 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
| 14245 | |
| 14246 | =over 4 |
| 14247 | |
| 14248 | =item SYNOPSIS |
| 14249 | |
| 14250 | =item DESCRIPTION |
| 14251 | |
| 14252 | =item @EXPORT |
| 14253 | |
| 14254 | =item FUNCTIONS |
| 14255 | |
| 14256 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
| 14257 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) |
| 14258 | |
| 14259 | =item EXAMPLES |
| 14260 | |
| 14261 | =item SEE ALSO |
| 14262 | |
| 14263 | =item AUTHOR |
| 14264 | |
| 14265 | =back |
| 14266 | |
| 14267 | =head2 ExtUtils::Install - install files from here to there |
| 14268 | |
| 14269 | =over 4 |
| 14270 | |
| 14271 | =item SYNOPSIS |
| 14272 | |
| 14273 | =item DESCRIPTION |
| 14274 | |
| 14275 | =over 4 |
| 14276 | |
| 14277 | =item Functions |
| 14278 | |
| 14279 | B<install> |
| 14280 | |
| 14281 | =back |
| 14282 | |
| 14283 | =back |
| 14284 | |
| 14285 | B<install_default> I<DISCOURAGED> |
| 14286 | |
| 14287 | B<uninstall> |
| 14288 | |
| 14289 | B<pm_to_blib> |
| 14290 | |
| 14291 | _autosplit |
| 14292 | |
| 14293 | =over 4 |
| 14294 | |
| 14295 | =item ENVIRONMENT |
| 14296 | |
| 14297 | B<PERL_INSTALL_ROOT> |
| 14298 | |
| 14299 | =item AUTHOR |
| 14300 | |
| 14301 | =item LICENSE |
| 14302 | |
| 14303 | =back |
| 14304 | |
| 14305 | =head2 ExtUtils::Installed - Inventory management of installed modules |
| 14306 | |
| 14307 | =over 4 |
| 14308 | |
| 14309 | =item SYNOPSIS |
| 14310 | |
| 14311 | =item DESCRIPTION |
| 14312 | |
| 14313 | =item USAGE |
| 14314 | |
| 14315 | =item FUNCTIONS |
| 14316 | |
| 14317 | new(), modules(), files(), directories(), directory_tree(), validate(), |
| 14318 | packlist(), version() |
| 14319 | |
| 14320 | =item EXAMPLE |
| 14321 | |
| 14322 | =item AUTHOR |
| 14323 | |
| 14324 | =back |
| 14325 | |
| 14326 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
| 14327 | |
| 14328 | =over 4 |
| 14329 | |
| 14330 | =item SYNOPSIS |
| 14331 | |
| 14332 | =item DESCRIPTION |
| 14333 | |
| 14334 | For static extensions, For dynamic extensions at build/link time, For |
| 14335 | dynamic extensions at load time |
| 14336 | |
| 14337 | =over 4 |
| 14338 | |
| 14339 | =item EXTRALIBS |
| 14340 | |
| 14341 | =item LDLOADLIBS and LD_RUN_PATH |
| 14342 | |
| 14343 | =item BSLOADLIBS |
| 14344 | |
| 14345 | =back |
| 14346 | |
| 14347 | =item PORTABILITY |
| 14348 | |
| 14349 | =over 4 |
| 14350 | |
| 14351 | =item VMS implementation |
| 14352 | |
| 14353 | =item Win32 implementation |
| 14354 | |
| 14355 | =back |
| 14356 | |
| 14357 | =item SEE ALSO |
| 14358 | |
| 14359 | =back |
| 14360 | |
| 14361 | =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass |
| 14362 | |
| 14363 | =over 4 |
| 14364 | |
| 14365 | =item SYNOPSIS |
| 14366 | |
| 14367 | =item DESCRIPTION |
| 14368 | |
| 14369 | =back |
| 14370 | |
| 14371 | =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix |
| 14372 | |
| 14373 | =over 4 |
| 14374 | |
| 14375 | =item SYNOPSIS |
| 14376 | |
| 14377 | =item DESCRIPTION |
| 14378 | |
| 14379 | =over 4 |
| 14380 | |
| 14381 | =item Overridden methods |
| 14382 | |
| 14383 | =back |
| 14384 | |
| 14385 | =back |
| 14386 | |
| 14387 | =over 4 |
| 14388 | |
| 14389 | =item AUTHOR |
| 14390 | |
| 14391 | =item SEE ALSO |
| 14392 | |
| 14393 | =back |
| 14394 | |
| 14395 | =head2 ExtUtils::MM_Any - Platform-agnostic MM methods |
| 14396 | |
| 14397 | =over 4 |
| 14398 | |
| 14399 | =item SYNOPSIS |
| 14400 | |
| 14401 | =item DESCRIPTION |
| 14402 | |
| 14403 | =item METHODS |
| 14404 | |
| 14405 | =over 4 |
| 14406 | |
| 14407 | =item Cross-platform helper methods |
| 14408 | |
| 14409 | =back |
| 14410 | |
| 14411 | =back |
| 14412 | |
| 14413 | =over 4 |
| 14414 | |
| 14415 | =item Targets |
| 14416 | |
| 14417 | =back |
| 14418 | |
| 14419 | =over 4 |
| 14420 | |
| 14421 | =item Init methods |
| 14422 | |
| 14423 | =back |
| 14424 | |
| 14425 | =over 4 |
| 14426 | |
| 14427 | =item Tools |
| 14428 | |
| 14429 | =back |
| 14430 | |
| 14431 | =over 4 |
| 14432 | |
| 14433 | =item File::Spec wrappers |
| 14434 | |
| 14435 | =back |
| 14436 | |
| 14437 | =over 4 |
| 14438 | |
| 14439 | =item Misc |
| 14440 | |
| 14441 | =back |
| 14442 | |
| 14443 | =over 4 |
| 14444 | |
| 14445 | =item AUTHOR |
| 14446 | |
| 14447 | =back |
| 14448 | |
| 14449 | =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in |
| 14450 | ExtUtils::MakeMaker |
| 14451 | |
| 14452 | =over 4 |
| 14453 | |
| 14454 | =item SYNOPSIS |
| 14455 | |
| 14456 | =item DESCRIPTION |
| 14457 | |
| 14458 | =back |
| 14459 | |
| 14460 | os_flavor |
| 14461 | |
| 14462 | init_linker |
| 14463 | |
| 14464 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
| 14465 | ExtUtils::MakeMaker |
| 14466 | |
| 14467 | =over 4 |
| 14468 | |
| 14469 | =item SYNOPSIS |
| 14470 | |
| 14471 | =item DESCRIPTION |
| 14472 | |
| 14473 | os_flavor |
| 14474 | |
| 14475 | =back |
| 14476 | |
| 14477 | cflags |
| 14478 | |
| 14479 | replace_manpage_separator |
| 14480 | |
| 14481 | init_linker |
| 14482 | |
| 14483 | =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix |
| 14484 | |
| 14485 | =over 4 |
| 14486 | |
| 14487 | =item SYNOPSIS |
| 14488 | |
| 14489 | =item DESCRIPTION |
| 14490 | |
| 14491 | =over 4 |
| 14492 | |
| 14493 | =item Overridden methods |
| 14494 | |
| 14495 | os_flavor |
| 14496 | |
| 14497 | =back |
| 14498 | |
| 14499 | =back |
| 14500 | |
| 14501 | B<replace_manpage_separator> |
| 14502 | |
| 14503 | =over 4 |
| 14504 | |
| 14505 | =item AUTHOR |
| 14506 | |
| 14507 | =item SEE ALSO |
| 14508 | |
| 14509 | =back |
| 14510 | |
| 14511 | =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic |
| 14512 | |
| 14513 | =over 4 |
| 14514 | |
| 14515 | =item SYNOPSIS |
| 14516 | |
| 14517 | =item DESCRIPTION |
| 14518 | |
| 14519 | =back |
| 14520 | |
| 14521 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in |
| 14522 | ExtUtils::MakeMaker |
| 14523 | |
| 14524 | =over 4 |
| 14525 | |
| 14526 | =item SYNOPSIS |
| 14527 | |
| 14528 | =item DESCRIPTION |
| 14529 | |
| 14530 | =back |
| 14531 | |
| 14532 | os_flavor |
| 14533 | |
| 14534 | init_platform, platform_constants |
| 14535 | |
| 14536 | const_cccmd |
| 14537 | |
| 14538 | static_lib |
| 14539 | |
| 14540 | dynamic_lib |
| 14541 | |
| 14542 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
| 14543 | ExtUtils::MakeMaker |
| 14544 | |
| 14545 | =over 4 |
| 14546 | |
| 14547 | =item SYNOPSIS |
| 14548 | |
| 14549 | =item DESCRIPTION |
| 14550 | |
| 14551 | =item METHODS |
| 14552 | |
| 14553 | init_dist |
| 14554 | |
| 14555 | =back |
| 14556 | |
| 14557 | init_linker |
| 14558 | |
| 14559 | os_flavor |
| 14560 | |
| 14561 | =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix |
| 14562 | |
| 14563 | =over 4 |
| 14564 | |
| 14565 | =item SYNOPSIS |
| 14566 | |
| 14567 | =item DESCRIPTION |
| 14568 | |
| 14569 | =over 4 |
| 14570 | |
| 14571 | =item Overridden methods |
| 14572 | |
| 14573 | =back |
| 14574 | |
| 14575 | =back |
| 14576 | |
| 14577 | =over 4 |
| 14578 | |
| 14579 | =item AUTHOR |
| 14580 | |
| 14581 | =item SEE ALSO |
| 14582 | |
| 14583 | =back |
| 14584 | |
| 14585 | =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix |
| 14586 | |
| 14587 | =over 4 |
| 14588 | |
| 14589 | =item SYNOPSIS |
| 14590 | |
| 14591 | =item DESCRIPTION |
| 14592 | |
| 14593 | =over 4 |
| 14594 | |
| 14595 | =item Overridden methods |
| 14596 | |
| 14597 | os_flavor |
| 14598 | |
| 14599 | =back |
| 14600 | |
| 14601 | =back |
| 14602 | |
| 14603 | B<replace_manpage_separator> |
| 14604 | |
| 14605 | =over 4 |
| 14606 | |
| 14607 | =item AUTHOR |
| 14608 | |
| 14609 | =item SEE ALSO |
| 14610 | |
| 14611 | =back |
| 14612 | |
| 14613 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
| 14614 | |
| 14615 | =over 4 |
| 14616 | |
| 14617 | =item SYNOPSIS |
| 14618 | |
| 14619 | =item DESCRIPTION |
| 14620 | |
| 14621 | =item METHODS |
| 14622 | |
| 14623 | =back |
| 14624 | |
| 14625 | =over 4 |
| 14626 | |
| 14627 | =item Methods |
| 14628 | |
| 14629 | os_flavor |
| 14630 | |
| 14631 | =back |
| 14632 | |
| 14633 | c_o (o) |
| 14634 | |
| 14635 | cflags (o) |
| 14636 | |
| 14637 | const_cccmd (o) |
| 14638 | |
| 14639 | const_config (o) |
| 14640 | |
| 14641 | const_loadlibs (o) |
| 14642 | |
| 14643 | constants (o) |
| 14644 | |
| 14645 | depend (o) |
| 14646 | |
| 14647 | init_DEST |
| 14648 | |
| 14649 | init_dist |
| 14650 | |
| 14651 | dist (o) |
| 14652 | |
| 14653 | dist_basics (o) |
| 14654 | |
| 14655 | dist_ci (o) |
| 14656 | |
| 14657 | dist_core (o) |
| 14658 | |
| 14659 | B<dist_target> |
| 14660 | |
| 14661 | B<tardist_target> |
| 14662 | |
| 14663 | B<zipdist_target> |
| 14664 | |
| 14665 | B<tarfile_target> |
| 14666 | |
| 14667 | zipfile_target |
| 14668 | |
| 14669 | uutardist_target |
| 14670 | |
| 14671 | shdist_target |
| 14672 | |
| 14673 | dlsyms (o) |
| 14674 | |
| 14675 | dynamic_bs (o) |
| 14676 | |
| 14677 | dynamic_lib (o) |
| 14678 | |
| 14679 | exescan |
| 14680 | |
| 14681 | extliblist |
| 14682 | |
| 14683 | find_perl |
| 14684 | |
| 14685 | fixin |
| 14686 | |
| 14687 | force (o) |
| 14688 | |
| 14689 | guess_name |
| 14690 | |
| 14691 | has_link_code |
| 14692 | |
| 14693 | init_dirscan |
| 14694 | |
| 14695 | init_DIRFILESEP |
| 14696 | |
| 14697 | init_main |
| 14698 | |
| 14699 | init_others |
| 14700 | |
| 14701 | init_linker |
| 14702 | |
| 14703 | init_lib2arch |
| 14704 | |
| 14705 | init_PERL |
| 14706 | |
| 14707 | init_platform, platform_constants |
| 14708 | |
| 14709 | init_PERM |
| 14710 | |
| 14711 | init_xs |
| 14712 | |
| 14713 | install (o) |
| 14714 | |
| 14715 | installbin (o) |
| 14716 | |
| 14717 | linkext (o) |
| 14718 | |
| 14719 | lsdir |
| 14720 | |
| 14721 | macro (o) |
| 14722 | |
| 14723 | makeaperl (o) |
| 14724 | |
| 14725 | makefile (o) |
| 14726 | |
| 14727 | maybe_command |
| 14728 | |
| 14729 | needs_linking (o) |
| 14730 | |
| 14731 | nicetext |
| 14732 | |
| 14733 | parse_abstract |
| 14734 | |
| 14735 | parse_version |
| 14736 | |
| 14737 | pasthru (o) |
| 14738 | |
| 14739 | perl_script |
| 14740 | |
| 14741 | perldepend (o) |
| 14742 | |
| 14743 | perm_rw (o) |
| 14744 | |
| 14745 | perm_rwx (o) |
| 14746 | |
| 14747 | pm_to_blib |
| 14748 | |
| 14749 | post_constants (o) |
| 14750 | |
| 14751 | post_initialize (o) |
| 14752 | |
| 14753 | postamble (o) |
| 14754 | |
| 14755 | ppd |
| 14756 | |
| 14757 | prefixify |
| 14758 | |
| 14759 | processPL (o) |
| 14760 | |
| 14761 | quote_paren |
| 14762 | |
| 14763 | replace_manpage_separator |
| 14764 | |
| 14765 | cd |
| 14766 | |
| 14767 | oneliner |
| 14768 | |
| 14769 | quote_literal |
| 14770 | |
| 14771 | escape_newlines |
| 14772 | |
| 14773 | max_exec_len |
| 14774 | |
| 14775 | static (o) |
| 14776 | |
| 14777 | static_lib (o) |
| 14778 | |
| 14779 | staticmake (o) |
| 14780 | |
| 14781 | subdir_x (o) |
| 14782 | |
| 14783 | subdirs (o) |
| 14784 | |
| 14785 | test (o) |
| 14786 | |
| 14787 | test_via_harness (override) |
| 14788 | |
| 14789 | test_via_script (override) |
| 14790 | |
| 14791 | tools_other (o) |
| 14792 | |
| 14793 | tool_xsubpp (o) |
| 14794 | |
| 14795 | all_target |
| 14796 | |
| 14797 | top_targets (o) |
| 14798 | |
| 14799 | writedoc |
| 14800 | |
| 14801 | xs_c (o) |
| 14802 | |
| 14803 | xs_cpp (o) |
| 14804 | |
| 14805 | xs_o (o) |
| 14806 | |
| 14807 | =over 4 |
| 14808 | |
| 14809 | =item SEE ALSO |
| 14810 | |
| 14811 | =back |
| 14812 | |
| 14813 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in |
| 14814 | ExtUtils::MakeMaker |
| 14815 | |
| 14816 | =over 4 |
| 14817 | |
| 14818 | =item SYNOPSIS |
| 14819 | |
| 14820 | =item DESCRIPTION |
| 14821 | |
| 14822 | =over 4 |
| 14823 | |
| 14824 | =item Methods always loaded |
| 14825 | |
| 14826 | wraplist |
| 14827 | |
| 14828 | =back |
| 14829 | |
| 14830 | =back |
| 14831 | |
| 14832 | =over 4 |
| 14833 | |
| 14834 | =item Methods |
| 14835 | |
| 14836 | guess_name (override) |
| 14837 | |
| 14838 | =back |
| 14839 | |
| 14840 | find_perl (override) |
| 14841 | |
| 14842 | maybe_command (override) |
| 14843 | |
| 14844 | pasthru (override) |
| 14845 | |
| 14846 | pm_to_blib (override) |
| 14847 | |
| 14848 | perl_script (override) |
| 14849 | |
| 14850 | replace_manpage_separator |
| 14851 | |
| 14852 | init_DEST |
| 14853 | |
| 14854 | init_DIRFILESEP |
| 14855 | |
| 14856 | init_main (override) |
| 14857 | |
| 14858 | init_others (override) |
| 14859 | |
| 14860 | init_platform (override) |
| 14861 | |
| 14862 | platform_constants |
| 14863 | |
| 14864 | init_VERSION (override) |
| 14865 | |
| 14866 | constants (override) |
| 14867 | |
| 14868 | special_targets |
| 14869 | |
| 14870 | cflags (override) |
| 14871 | |
| 14872 | const_cccmd (override) |
| 14873 | |
| 14874 | tools_other (override) |
| 14875 | |
| 14876 | init_dist (override) |
| 14877 | |
| 14878 | c_o (override) |
| 14879 | |
| 14880 | xs_c (override) |
| 14881 | |
| 14882 | xs_o (override) |
| 14883 | |
| 14884 | dlsyms (override) |
| 14885 | |
| 14886 | dynamic_lib (override) |
| 14887 | |
| 14888 | static_lib (override) |
| 14889 | |
| 14890 | extra_clean_files |
| 14891 | |
| 14892 | zipfile_target, tarfile_target, shdist_target |
| 14893 | |
| 14894 | install (override) |
| 14895 | |
| 14896 | perldepend (override) |
| 14897 | |
| 14898 | makeaperl (override) |
| 14899 | |
| 14900 | nicetext (override) |
| 14901 | |
| 14902 | prefixify (override) |
| 14903 | |
| 14904 | cd |
| 14905 | |
| 14906 | oneliner |
| 14907 | |
| 14908 | B<echo> |
| 14909 | |
| 14910 | quote_literal |
| 14911 | |
| 14912 | escape_newlines |
| 14913 | |
| 14914 | max_exec_len |
| 14915 | |
| 14916 | init_linker |
| 14917 | |
| 14918 | eliminate_macros |
| 14919 | |
| 14920 | fixpath |
| 14921 | |
| 14922 | os_flavor |
| 14923 | |
| 14924 | =over 4 |
| 14925 | |
| 14926 | =item AUTHOR |
| 14927 | |
| 14928 | =back |
| 14929 | |
| 14930 | =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix |
| 14931 | |
| 14932 | =over 4 |
| 14933 | |
| 14934 | =item SYNOPSIS |
| 14935 | |
| 14936 | =item DESCRIPTION |
| 14937 | |
| 14938 | =over 4 |
| 14939 | |
| 14940 | =item Overridden methods |
| 14941 | |
| 14942 | =back |
| 14943 | |
| 14944 | =back |
| 14945 | |
| 14946 | =over 4 |
| 14947 | |
| 14948 | =item AUTHOR |
| 14949 | |
| 14950 | =item SEE ALSO |
| 14951 | |
| 14952 | =back |
| 14953 | |
| 14954 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in |
| 14955 | ExtUtils::MakeMaker |
| 14956 | |
| 14957 | =over 4 |
| 14958 | |
| 14959 | =item SYNOPSIS |
| 14960 | |
| 14961 | =item DESCRIPTION |
| 14962 | |
| 14963 | =back |
| 14964 | |
| 14965 | =over 4 |
| 14966 | |
| 14967 | =item Overridden methods |
| 14968 | |
| 14969 | B<dlsyms> |
| 14970 | |
| 14971 | =back |
| 14972 | |
| 14973 | replace_manpage_separator |
| 14974 | |
| 14975 | B<maybe_command> |
| 14976 | |
| 14977 | B<init_DIRFILESEP> |
| 14978 | |
| 14979 | B<init_others> |
| 14980 | |
| 14981 | init_platform, platform_constants |
| 14982 | |
| 14983 | special_targets |
| 14984 | |
| 14985 | static_lib |
| 14986 | |
| 14987 | dynamic_lib |
| 14988 | |
| 14989 | extra_clean_files |
| 14990 | |
| 14991 | init_linker |
| 14992 | |
| 14993 | perl_script |
| 14994 | |
| 14995 | xs_o |
| 14996 | |
| 14997 | pasthru |
| 14998 | |
| 14999 | oneliner |
| 15000 | |
| 15001 | cd |
| 15002 | |
| 15003 | max_exec_len |
| 15004 | |
| 15005 | os_flavor |
| 15006 | |
| 15007 | =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X |
| 15008 | |
| 15009 | =over 4 |
| 15010 | |
| 15011 | =item SYNOPSIS |
| 15012 | |
| 15013 | =item DESCRIPTION |
| 15014 | |
| 15015 | =over 4 |
| 15016 | |
| 15017 | =item Overriden methods |
| 15018 | |
| 15019 | xs_c |
| 15020 | |
| 15021 | =back |
| 15022 | |
| 15023 | =back |
| 15024 | |
| 15025 | xs_cpp |
| 15026 | |
| 15027 | xs_o |
| 15028 | |
| 15029 | max_exec_len |
| 15030 | |
| 15031 | os_flavor |
| 15032 | |
| 15033 | =over 4 |
| 15034 | |
| 15035 | =item AUTHOR |
| 15036 | |
| 15037 | =back |
| 15038 | |
| 15039 | =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization |
| 15040 | |
| 15041 | =over 4 |
| 15042 | |
| 15043 | =item SYNOPSIS |
| 15044 | |
| 15045 | =item DESCRIPTION |
| 15046 | |
| 15047 | =back |
| 15048 | |
| 15049 | =head2 ExtUtils::MakeMaker - Create a module Makefile |
| 15050 | |
| 15051 | =over 4 |
| 15052 | |
| 15053 | =item SYNOPSIS |
| 15054 | |
| 15055 | =item DESCRIPTION |
| 15056 | |
| 15057 | =over 4 |
| 15058 | |
| 15059 | =item How To Write A Makefile.PL |
| 15060 | |
| 15061 | =item Default Makefile Behaviour |
| 15062 | |
| 15063 | =item make test |
| 15064 | |
| 15065 | =item make testdb |
| 15066 | |
| 15067 | =item make install |
| 15068 | |
| 15069 | =item PREFIX and LIB attribute |
| 15070 | |
| 15071 | =item AFS users |
| 15072 | |
| 15073 | =item Static Linking of a new Perl Binary |
| 15074 | |
| 15075 | =item Determination of Perl Library and Installation Locations |
| 15076 | |
| 15077 | =item Which architecture dependent directory? |
| 15078 | |
| 15079 | =item Using Attributes and Parameters |
| 15080 | |
| 15081 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, |
| 15082 | CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, |
| 15083 | EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, |
| 15084 | FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, |
| 15085 | INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, |
| 15086 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, |
| 15087 | INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, |
| 15088 | INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, |
| 15089 | INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, |
| 15090 | INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, |
| 15091 | LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, |
| 15092 | MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, |
| 15093 | OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, |
| 15094 | PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, |
| 15095 | PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, |
| 15096 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, |
| 15097 | PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, |
| 15098 | VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION |
| 15099 | |
| 15100 | =item Additional lowercase attributes |
| 15101 | |
| 15102 | clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, |
| 15103 | test, tool_autosplit |
| 15104 | |
| 15105 | =item Overriding MakeMaker Methods |
| 15106 | |
| 15107 | =item The End Of Cargo Cult Programming |
| 15108 | |
| 15109 | C<< MAN3PODS => ' ' >> |
| 15110 | |
| 15111 | =item Hintsfile support |
| 15112 | |
| 15113 | =item Distribution Support |
| 15114 | |
| 15115 | make distcheck, make skipcheck, make distclean, make manifest, |
| 15116 | make distdir, make disttest, make tardist, make dist, make |
| 15117 | uutardist, make shdist, make zipdist, make ci |
| 15118 | |
| 15119 | =item Module Meta-Data |
| 15120 | |
| 15121 | =item Disabling an extension |
| 15122 | |
| 15123 | =item Other Handy Functions |
| 15124 | |
| 15125 | prompt |
| 15126 | |
| 15127 | =back |
| 15128 | |
| 15129 | =item ENVIRONMENT |
| 15130 | |
| 15131 | PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE |
| 15132 | |
| 15133 | =item SEE ALSO |
| 15134 | |
| 15135 | =item AUTHORS |
| 15136 | |
| 15137 | =item LICENSE |
| 15138 | |
| 15139 | =back |
| 15140 | |
| 15141 | =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm |
| 15142 | |
| 15143 | =over 4 |
| 15144 | |
| 15145 | =item SYNOPSIS |
| 15146 | |
| 15147 | =item DESCRIPTION |
| 15148 | |
| 15149 | =back |
| 15150 | |
| 15151 | =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About |
| 15152 | MakeMaker |
| 15153 | |
| 15154 | =over 4 |
| 15155 | |
| 15156 | =item DESCRIPTION |
| 15157 | |
| 15158 | =over 4 |
| 15159 | |
| 15160 | =item Module Installation |
| 15161 | |
| 15162 | How do I keep from installing man pages?, How do I use a module without |
| 15163 | installing it? |
| 15164 | |
| 15165 | =item Philosophy and History |
| 15166 | |
| 15167 | Why not just use <insert other build config tool here>?, What is |
| 15168 | Module::Build and how does it relate to MakeMaker?, pure perl. no make, no |
| 15169 | shell commands, easier to customize, cleaner internals, less cruft |
| 15170 | |
| 15171 | =item Module Writing |
| 15172 | |
| 15173 | How do I keep my $VERSION up to date without resetting it manually?, What's |
| 15174 | this F<META.yml> thing and how did it get in my F<MANIFEST>?! |
| 15175 | |
| 15176 | =item XS |
| 15177 | |
| 15178 | How to I prevent "object version X.XX does not match bootstrap parameter |
| 15179 | Y.YY" errors?, How do I make two or more XS files coexist in the same |
| 15180 | directory? |
| 15181 | |
| 15182 | =back |
| 15183 | |
| 15184 | =item PATCHING |
| 15185 | |
| 15186 | =item AUTHOR |
| 15187 | |
| 15188 | =item SEE ALSO |
| 15189 | |
| 15190 | =back |
| 15191 | |
| 15192 | =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker |
| 15193 | |
| 15194 | =over 4 |
| 15195 | |
| 15196 | =item SYNOPSIS |
| 15197 | |
| 15198 | =item DESCRIPTION |
| 15199 | |
| 15200 | =over 4 |
| 15201 | |
| 15202 | =item The Mantra |
| 15203 | |
| 15204 | =item The Layout |
| 15205 | |
| 15206 | Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, |
| 15207 | bin/ |
| 15208 | |
| 15209 | =back |
| 15210 | |
| 15211 | =item SEE ALSO |
| 15212 | |
| 15213 | =back |
| 15214 | |
| 15215 | =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm |
| 15216 | |
| 15217 | =over 4 |
| 15218 | |
| 15219 | =item SYNOPSIS |
| 15220 | |
| 15221 | =item DESCRIPTION |
| 15222 | |
| 15223 | =back |
| 15224 | |
| 15225 | =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm |
| 15226 | |
| 15227 | =over 4 |
| 15228 | |
| 15229 | =item SYNOPSIS |
| 15230 | |
| 15231 | =item DESCRIPTION |
| 15232 | |
| 15233 | =back |
| 15234 | |
| 15235 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file |
| 15236 | |
| 15237 | =over 4 |
| 15238 | |
| 15239 | =item SYNOPSIS |
| 15240 | |
| 15241 | =item DESCRIPTION |
| 15242 | |
| 15243 | =over 4 |
| 15244 | |
| 15245 | =item Functions |
| 15246 | |
| 15247 | mkmanifest |
| 15248 | |
| 15249 | =back |
| 15250 | |
| 15251 | =back |
| 15252 | |
| 15253 | manifind |
| 15254 | |
| 15255 | manicheck |
| 15256 | |
| 15257 | filecheck |
| 15258 | |
| 15259 | fullcheck |
| 15260 | |
| 15261 | skipcheck |
| 15262 | |
| 15263 | maniread |
| 15264 | |
| 15265 | manicopy |
| 15266 | |
| 15267 | maniadd |
| 15268 | |
| 15269 | =over 4 |
| 15270 | |
| 15271 | =item MANIFEST |
| 15272 | |
| 15273 | =item MANIFEST.SKIP |
| 15274 | |
| 15275 | =item EXPORT_OK |
| 15276 | |
| 15277 | =item GLOBAL VARIABLES |
| 15278 | |
| 15279 | =back |
| 15280 | |
| 15281 | =over 4 |
| 15282 | |
| 15283 | =item DIAGNOSTICS |
| 15284 | |
| 15285 | C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, |
| 15286 | C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> |
| 15287 | |
| 15288 | =item ENVIRONMENT |
| 15289 | |
| 15290 | B<PERL_MM_MANIFEST_DEBUG> |
| 15291 | |
| 15292 | =item SEE ALSO |
| 15293 | |
| 15294 | =item AUTHOR |
| 15295 | |
| 15296 | =back |
| 15297 | |
| 15298 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c |
| 15299 | |
| 15300 | =over 4 |
| 15301 | |
| 15302 | =item SYNOPSIS |
| 15303 | |
| 15304 | =item DESCRIPTION |
| 15305 | |
| 15306 | =item SEE ALSO |
| 15307 | |
| 15308 | =back |
| 15309 | |
| 15310 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader |
| 15311 | |
| 15312 | =over 4 |
| 15313 | |
| 15314 | =item SYNOPSIS |
| 15315 | |
| 15316 | =item DESCRIPTION |
| 15317 | |
| 15318 | =back |
| 15319 | |
| 15320 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic |
| 15321 | extension |
| 15322 | |
| 15323 | =over 4 |
| 15324 | |
| 15325 | =item SYNOPSIS |
| 15326 | |
| 15327 | =item DESCRIPTION |
| 15328 | |
| 15329 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME |
| 15330 | |
| 15331 | =item AUTHOR |
| 15332 | |
| 15333 | =item REVISION |
| 15334 | |
| 15335 | =back |
| 15336 | |
| 15337 | =head2 ExtUtils::Packlist - manage .packlist files |
| 15338 | |
| 15339 | =over 4 |
| 15340 | |
| 15341 | =item SYNOPSIS |
| 15342 | |
| 15343 | =item DESCRIPTION |
| 15344 | |
| 15345 | =item USAGE |
| 15346 | |
| 15347 | =item FUNCTIONS |
| 15348 | |
| 15349 | new(), read(), write(), validate(), packlist_file() |
| 15350 | |
| 15351 | =item EXAMPLE |
| 15352 | |
| 15353 | =item AUTHOR |
| 15354 | |
| 15355 | =back |
| 15356 | |
| 15357 | =head2 ExtUtils::testlib - add blib/* directories to @INC |
| 15358 | |
| 15359 | =over 4 |
| 15360 | |
| 15361 | =item SYNOPSIS |
| 15362 | |
| 15363 | =item DESCRIPTION |
| 15364 | |
| 15365 | =back |
| 15366 | |
| 15367 | =head2 Fatal - replace functions with equivalents which succeed or die |
| 15368 | |
| 15369 | =over 4 |
| 15370 | |
| 15371 | =item SYNOPSIS |
| 15372 | |
| 15373 | =item DESCRIPTION |
| 15374 | |
| 15375 | =item AUTHOR |
| 15376 | |
| 15377 | =back |
| 15378 | |
| 15379 | =head2 Fcntl - load the C Fcntl.h defines |
| 15380 | |
| 15381 | =over 4 |
| 15382 | |
| 15383 | =item SYNOPSIS |
| 15384 | |
| 15385 | =item DESCRIPTION |
| 15386 | |
| 15387 | =item NOTE |
| 15388 | |
| 15389 | =item EXPORTED SYMBOLS |
| 15390 | |
| 15391 | =back |
| 15392 | |
| 15393 | =head2 File::Basename - Parse file paths into directory, filename and |
| 15394 | suffix. |
| 15395 | |
| 15396 | =over 4 |
| 15397 | |
| 15398 | =item SYNOPSIS |
| 15399 | |
| 15400 | =item DESCRIPTION |
| 15401 | |
| 15402 | =back |
| 15403 | |
| 15404 | C<fileparse> |
| 15405 | |
| 15406 | C<basename> |
| 15407 | |
| 15408 | C<dirname> |
| 15409 | |
| 15410 | C<fileparse_set_fstype> |
| 15411 | |
| 15412 | =over 4 |
| 15413 | |
| 15414 | =item SEE ALSO |
| 15415 | |
| 15416 | =back |
| 15417 | |
| 15418 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
| 15419 | |
| 15420 | =over 4 |
| 15421 | |
| 15422 | =item SYNOPSIS |
| 15423 | |
| 15424 | =item DESCRIPTION |
| 15425 | |
| 15426 | =item AUTHOR |
| 15427 | |
| 15428 | =item HISTORY |
| 15429 | |
| 15430 | =back |
| 15431 | |
| 15432 | =head2 File::Compare - Compare files or filehandles |
| 15433 | |
| 15434 | =over 4 |
| 15435 | |
| 15436 | =item SYNOPSIS |
| 15437 | |
| 15438 | =item DESCRIPTION |
| 15439 | |
| 15440 | =item RETURN |
| 15441 | |
| 15442 | =item AUTHOR |
| 15443 | |
| 15444 | =back |
| 15445 | |
| 15446 | =head2 File::Copy - Copy files or filehandles |
| 15447 | |
| 15448 | =over 4 |
| 15449 | |
| 15450 | =item SYNOPSIS |
| 15451 | |
| 15452 | =item DESCRIPTION |
| 15453 | |
| 15454 | =over 4 |
| 15455 | |
| 15456 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
| 15457 | |
| 15458 | rmscopy($from,$to[,$date_flag]) |
| 15459 | |
| 15460 | =back |
| 15461 | |
| 15462 | =item RETURN |
| 15463 | |
| 15464 | =item NOTES |
| 15465 | |
| 15466 | =item AUTHOR |
| 15467 | |
| 15468 | =back |
| 15469 | |
| 15470 | =head2 File::DosGlob - DOS like globbing and then some |
| 15471 | |
| 15472 | =over 4 |
| 15473 | |
| 15474 | =item SYNOPSIS |
| 15475 | |
| 15476 | =item DESCRIPTION |
| 15477 | |
| 15478 | =item NOTES |
| 15479 | |
| 15480 | =item EXPORTS (by request only) |
| 15481 | |
| 15482 | =item BUGS |
| 15483 | |
| 15484 | =item AUTHOR |
| 15485 | |
| 15486 | =item HISTORY |
| 15487 | |
| 15488 | =item SEE ALSO |
| 15489 | |
| 15490 | =back |
| 15491 | |
| 15492 | =head2 File::Find - Traverse a directory tree. |
| 15493 | |
| 15494 | =over 4 |
| 15495 | |
| 15496 | =item SYNOPSIS |
| 15497 | |
| 15498 | =item DESCRIPTION |
| 15499 | |
| 15500 | B<find>, B<finddepth> |
| 15501 | |
| 15502 | =over 4 |
| 15503 | |
| 15504 | =item %options |
| 15505 | |
| 15506 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, |
| 15507 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, |
| 15508 | C<untaint>, C<untaint_pattern>, C<untaint_skip> |
| 15509 | |
| 15510 | =item The wanted function |
| 15511 | |
| 15512 | C<$File::Find::dir> is the current directory name,, C<$_> is the current |
| 15513 | filename within that directory, C<$File::Find::name> is the complete |
| 15514 | pathname to the file |
| 15515 | |
| 15516 | =back |
| 15517 | |
| 15518 | =item WARNINGS |
| 15519 | |
| 15520 | =item CAVEAT |
| 15521 | |
| 15522 | $dont_use_nlink, symlinks |
| 15523 | |
| 15524 | =item NOTES |
| 15525 | |
| 15526 | =item BUGS AND CAVEATS |
| 15527 | |
| 15528 | =item HISTORY |
| 15529 | |
| 15530 | =back |
| 15531 | |
| 15532 | =head2 File::Glob - Perl extension for BSD glob routine |
| 15533 | |
| 15534 | =over 4 |
| 15535 | |
| 15536 | =item SYNOPSIS |
| 15537 | |
| 15538 | =item DESCRIPTION |
| 15539 | |
| 15540 | =over 4 |
| 15541 | |
| 15542 | =item META CHARACTERS |
| 15543 | |
| 15544 | =item POSIX FLAGS |
| 15545 | |
| 15546 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, |
| 15547 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, |
| 15548 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> |
| 15549 | |
| 15550 | =back |
| 15551 | |
| 15552 | =item DIAGNOSTICS |
| 15553 | |
| 15554 | C<GLOB_NOSPACE>, C<GLOB_ABEND> |
| 15555 | |
| 15556 | =item NOTES |
| 15557 | |
| 15558 | =item SEE ALSO |
| 15559 | |
| 15560 | =item AUTHOR |
| 15561 | |
| 15562 | =back |
| 15563 | |
| 15564 | =head2 File::Path - create or remove directory trees |
| 15565 | |
| 15566 | =over 4 |
| 15567 | |
| 15568 | =item SYNOPSIS |
| 15569 | |
| 15570 | =item DESCRIPTION |
| 15571 | |
| 15572 | =item DIAGNOSTICS |
| 15573 | |
| 15574 | =item AUTHORS |
| 15575 | |
| 15576 | =back |
| 15577 | |
| 15578 | =head2 File::Spec - portably perform operations on file names |
| 15579 | |
| 15580 | =over 4 |
| 15581 | |
| 15582 | =item SYNOPSIS |
| 15583 | |
| 15584 | =item DESCRIPTION |
| 15585 | |
| 15586 | =item METHODS |
| 15587 | |
| 15588 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, |
| 15589 | no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, |
| 15590 | splitdir, catpath(), abs2rel, rel2abs() |
| 15591 | |
| 15592 | =item SEE ALSO |
| 15593 | |
| 15594 | =item AUTHOR |
| 15595 | |
| 15596 | =item COPYRIGHT |
| 15597 | |
| 15598 | =back |
| 15599 | |
| 15600 | =head2 File::Spec::Cygwin - methods for Cygwin file specs |
| 15601 | |
| 15602 | =over 4 |
| 15603 | |
| 15604 | =item SYNOPSIS |
| 15605 | |
| 15606 | =item DESCRIPTION |
| 15607 | |
| 15608 | =back |
| 15609 | |
| 15610 | canonpath |
| 15611 | |
| 15612 | file_name_is_absolute |
| 15613 | |
| 15614 | tmpdir (override) |
| 15615 | |
| 15616 | =over 4 |
| 15617 | |
| 15618 | =item COPYRIGHT |
| 15619 | |
| 15620 | =back |
| 15621 | |
| 15622 | =head2 File::Spec::Epoc - methods for Epoc file specs |
| 15623 | |
| 15624 | =over 4 |
| 15625 | |
| 15626 | =item SYNOPSIS |
| 15627 | |
| 15628 | =item DESCRIPTION |
| 15629 | |
| 15630 | =back |
| 15631 | |
| 15632 | canonpath() |
| 15633 | |
| 15634 | =over 4 |
| 15635 | |
| 15636 | =item AUTHOR |
| 15637 | |
| 15638 | =item COPYRIGHT |
| 15639 | |
| 15640 | =item SEE ALSO |
| 15641 | |
| 15642 | =back |
| 15643 | |
| 15644 | =head2 File::Spec::Functions - portably perform operations on file names |
| 15645 | |
| 15646 | =over 4 |
| 15647 | |
| 15648 | =item SYNOPSIS |
| 15649 | |
| 15650 | =item DESCRIPTION |
| 15651 | |
| 15652 | =over 4 |
| 15653 | |
| 15654 | =item Exports |
| 15655 | |
| 15656 | =back |
| 15657 | |
| 15658 | =item COPYRIGHT |
| 15659 | |
| 15660 | =item SEE ALSO |
| 15661 | |
| 15662 | =back |
| 15663 | |
| 15664 | =head2 File::Spec::Mac - File::Spec for Mac OS (Classic) |
| 15665 | |
| 15666 | =over 4 |
| 15667 | |
| 15668 | =item SYNOPSIS |
| 15669 | |
| 15670 | =item DESCRIPTION |
| 15671 | |
| 15672 | =item METHODS |
| 15673 | |
| 15674 | canonpath |
| 15675 | |
| 15676 | =back |
| 15677 | |
| 15678 | catdir() |
| 15679 | |
| 15680 | catfile |
| 15681 | |
| 15682 | curdir |
| 15683 | |
| 15684 | devnull |
| 15685 | |
| 15686 | rootdir |
| 15687 | |
| 15688 | tmpdir |
| 15689 | |
| 15690 | updir |
| 15691 | |
| 15692 | file_name_is_absolute |
| 15693 | |
| 15694 | path |
| 15695 | |
| 15696 | splitpath |
| 15697 | |
| 15698 | splitdir |
| 15699 | |
| 15700 | catpath |
| 15701 | |
| 15702 | abs2rel |
| 15703 | |
| 15704 | rel2abs |
| 15705 | |
| 15706 | =over 4 |
| 15707 | |
| 15708 | =item AUTHORS |
| 15709 | |
| 15710 | =item COPYRIGHT |
| 15711 | |
| 15712 | =item SEE ALSO |
| 15713 | |
| 15714 | =back |
| 15715 | |
| 15716 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
| 15717 | |
| 15718 | =over 4 |
| 15719 | |
| 15720 | =item SYNOPSIS |
| 15721 | |
| 15722 | =item DESCRIPTION |
| 15723 | |
| 15724 | tmpdir, splitpath |
| 15725 | |
| 15726 | =item COPYRIGHT |
| 15727 | |
| 15728 | =back |
| 15729 | |
| 15730 | =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec |
| 15731 | modules |
| 15732 | |
| 15733 | =over 4 |
| 15734 | |
| 15735 | =item SYNOPSIS |
| 15736 | |
| 15737 | =item DESCRIPTION |
| 15738 | |
| 15739 | =item METHODS |
| 15740 | |
| 15741 | canonpath() |
| 15742 | |
| 15743 | =back |
| 15744 | |
| 15745 | catdir() |
| 15746 | |
| 15747 | catfile |
| 15748 | |
| 15749 | curdir |
| 15750 | |
| 15751 | devnull |
| 15752 | |
| 15753 | rootdir |
| 15754 | |
| 15755 | tmpdir |
| 15756 | |
| 15757 | updir |
| 15758 | |
| 15759 | no_upwards |
| 15760 | |
| 15761 | case_tolerant |
| 15762 | |
| 15763 | file_name_is_absolute |
| 15764 | |
| 15765 | path |
| 15766 | |
| 15767 | join |
| 15768 | |
| 15769 | splitpath |
| 15770 | |
| 15771 | splitdir |
| 15772 | |
| 15773 | catpath() |
| 15774 | |
| 15775 | abs2rel |
| 15776 | |
| 15777 | rel2abs() |
| 15778 | |
| 15779 | =over 4 |
| 15780 | |
| 15781 | =item COPYRIGHT |
| 15782 | |
| 15783 | =item SEE ALSO |
| 15784 | |
| 15785 | =back |
| 15786 | |
| 15787 | =head2 File::Spec::VMS - methods for VMS file specs |
| 15788 | |
| 15789 | =over 4 |
| 15790 | |
| 15791 | =item SYNOPSIS |
| 15792 | |
| 15793 | =item DESCRIPTION |
| 15794 | |
| 15795 | canonpath (override) |
| 15796 | |
| 15797 | =back |
| 15798 | |
| 15799 | catdir (override) |
| 15800 | |
| 15801 | catfile (override) |
| 15802 | |
| 15803 | curdir (override) |
| 15804 | |
| 15805 | devnull (override) |
| 15806 | |
| 15807 | rootdir (override) |
| 15808 | |
| 15809 | tmpdir (override) |
| 15810 | |
| 15811 | updir (override) |
| 15812 | |
| 15813 | case_tolerant (override) |
| 15814 | |
| 15815 | path (override) |
| 15816 | |
| 15817 | file_name_is_absolute (override) |
| 15818 | |
| 15819 | splitpath (override) |
| 15820 | |
| 15821 | splitdir (override) |
| 15822 | |
| 15823 | catpath (override) |
| 15824 | |
| 15825 | abs2rel (override) |
| 15826 | |
| 15827 | rel2abs (override) |
| 15828 | |
| 15829 | =over 4 |
| 15830 | |
| 15831 | =item COPYRIGHT |
| 15832 | |
| 15833 | =item SEE ALSO |
| 15834 | |
| 15835 | =back |
| 15836 | |
| 15837 | =head2 File::Spec::Win32 - methods for Win32 file specs |
| 15838 | |
| 15839 | =over 4 |
| 15840 | |
| 15841 | =item SYNOPSIS |
| 15842 | |
| 15843 | =item DESCRIPTION |
| 15844 | |
| 15845 | devnull |
| 15846 | |
| 15847 | =back |
| 15848 | |
| 15849 | tmpdir |
| 15850 | |
| 15851 | catfile |
| 15852 | |
| 15853 | canonpath |
| 15854 | |
| 15855 | splitpath |
| 15856 | |
| 15857 | splitdir |
| 15858 | |
| 15859 | catpath |
| 15860 | |
| 15861 | =over 4 |
| 15862 | |
| 15863 | =item Note For File::Spec::Win32 Maintainers |
| 15864 | |
| 15865 | =back |
| 15866 | |
| 15867 | =over 4 |
| 15868 | |
| 15869 | =item COPYRIGHT |
| 15870 | |
| 15871 | =item SEE ALSO |
| 15872 | |
| 15873 | =back |
| 15874 | |
| 15875 | =head2 File::Temp - return name and handle of a temporary file safely |
| 15876 | |
| 15877 | =over 4 |
| 15878 | |
| 15879 | =item PORTABILITY |
| 15880 | |
| 15881 | =item SYNOPSIS |
| 15882 | |
| 15883 | =item DESCRIPTION |
| 15884 | |
| 15885 | =back |
| 15886 | |
| 15887 | =over 4 |
| 15888 | |
| 15889 | =item OBJECT-ORIENTED INTERFACE |
| 15890 | |
| 15891 | B<new> |
| 15892 | |
| 15893 | =back |
| 15894 | |
| 15895 | B<filename> |
| 15896 | |
| 15897 | B<unlink_on_destroy> |
| 15898 | |
| 15899 | B<DESTROY> |
| 15900 | |
| 15901 | =over 4 |
| 15902 | |
| 15903 | =item FUNCTIONS |
| 15904 | |
| 15905 | B<tempfile> |
| 15906 | |
| 15907 | =back |
| 15908 | |
| 15909 | B<tempdir> |
| 15910 | |
| 15911 | =over 4 |
| 15912 | |
| 15913 | =item MKTEMP FUNCTIONS |
| 15914 | |
| 15915 | B<mkstemp> |
| 15916 | |
| 15917 | =back |
| 15918 | |
| 15919 | B<mkstemps> |
| 15920 | |
| 15921 | B<mkdtemp> |
| 15922 | |
| 15923 | B<mktemp> |
| 15924 | |
| 15925 | =over 4 |
| 15926 | |
| 15927 | =item POSIX FUNCTIONS |
| 15928 | |
| 15929 | B<tmpnam> |
| 15930 | |
| 15931 | =back |
| 15932 | |
| 15933 | B<tmpfile> |
| 15934 | |
| 15935 | =over 4 |
| 15936 | |
| 15937 | =item ADDITIONAL FUNCTIONS |
| 15938 | |
| 15939 | B<tempnam> |
| 15940 | |
| 15941 | =back |
| 15942 | |
| 15943 | =over 4 |
| 15944 | |
| 15945 | =item UTILITY FUNCTIONS |
| 15946 | |
| 15947 | B<unlink0> |
| 15948 | |
| 15949 | =back |
| 15950 | |
| 15951 | B<cmpstat> |
| 15952 | |
| 15953 | B<unlink1> |
| 15954 | |
| 15955 | B<cleanup> |
| 15956 | |
| 15957 | =over 4 |
| 15958 | |
| 15959 | =item PACKAGE VARIABLES |
| 15960 | |
| 15961 | B<safe_level>, STANDARD, MEDIUM, HIGH |
| 15962 | |
| 15963 | =back |
| 15964 | |
| 15965 | TopSystemUID |
| 15966 | |
| 15967 | B<$KEEP_ALL>, B<$DEBUG> |
| 15968 | |
| 15969 | =over 4 |
| 15970 | |
| 15971 | =item WARNING |
| 15972 | |
| 15973 | =over 4 |
| 15974 | |
| 15975 | =item Temporary files and NFS |
| 15976 | |
| 15977 | =item Forking |
| 15978 | |
| 15979 | =item BINMODE |
| 15980 | |
| 15981 | =back |
| 15982 | |
| 15983 | =item HISTORY |
| 15984 | |
| 15985 | =item SEE ALSO |
| 15986 | |
| 15987 | =item AUTHOR |
| 15988 | |
| 15989 | =back |
| 15990 | |
| 15991 | =head2 File::stat - by-name interface to Perl's built-in stat() functions |
| 15992 | |
| 15993 | =over 4 |
| 15994 | |
| 15995 | =item SYNOPSIS |
| 15996 | |
| 15997 | =item DESCRIPTION |
| 15998 | |
| 15999 | =item BUGS |
| 16000 | |
| 16001 | =item NOTE |
| 16002 | |
| 16003 | =item AUTHOR |
| 16004 | |
| 16005 | =back |
| 16006 | |
| 16007 | =head2 FileCache - keep more files open than the system permits |
| 16008 | |
| 16009 | =over 4 |
| 16010 | |
| 16011 | =item SYNOPSIS |
| 16012 | |
| 16013 | =item DESCRIPTION |
| 16014 | |
| 16015 | cacheout EXPR, cacheout MODE, EXPR |
| 16016 | |
| 16017 | =item CAVEATS |
| 16018 | |
| 16019 | =item BUGS |
| 16020 | |
| 16021 | =back |
| 16022 | |
| 16023 | =head2 FileHandle - supply object methods for filehandles |
| 16024 | |
| 16025 | =over 4 |
| 16026 | |
| 16027 | =item SYNOPSIS |
| 16028 | |
| 16029 | =item DESCRIPTION |
| 16030 | |
| 16031 | $fh->print, $fh->printf, $fh->getline, $fh->getlines |
| 16032 | |
| 16033 | =item SEE ALSO |
| 16034 | |
| 16035 | =back |
| 16036 | |
| 16037 | =head2 Filter::Simple - Simplified source filtering |
| 16038 | |
| 16039 | =over 4 |
| 16040 | |
| 16041 | =item SYNOPSIS |
| 16042 | |
| 16043 | =item DESCRIPTION |
| 16044 | |
| 16045 | =over 4 |
| 16046 | |
| 16047 | =item The Problem |
| 16048 | |
| 16049 | =item A Solution |
| 16050 | |
| 16051 | =item Disabling or changing <no> behaviour |
| 16052 | |
| 16053 | =item All-in-one interface |
| 16054 | |
| 16055 | =item Filtering only specific components of source code |
| 16056 | |
| 16057 | C<"code">, C<"code_no_comments">, C<"executable">, |
| 16058 | C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, |
| 16059 | C<"all"> |
| 16060 | |
| 16061 | =item Filtering only the code parts of source code |
| 16062 | |
| 16063 | Most source code ceases to be grammatically correct when it is broken up |
| 16064 | into the pieces between string literals and regexes. So the C<'code'> |
| 16065 | and C<'code_no_comments'> component filter behave slightly differently |
| 16066 | from the other partial filters described in the previous section. |
| 16067 | |
| 16068 | =item Using Filter::Simple with an explicit C<import> subroutine |
| 16069 | |
| 16070 | =item Using Filter::Simple and Exporter together |
| 16071 | |
| 16072 | =item How it works |
| 16073 | |
| 16074 | =back |
| 16075 | |
| 16076 | =item AUTHOR |
| 16077 | |
| 16078 | =item COPYRIGHT |
| 16079 | |
| 16080 | =back |
| 16081 | |
| 16082 | =head2 Filter::Util::Call - Perl Source Filter Utility Module |
| 16083 | |
| 16084 | =over 4 |
| 16085 | |
| 16086 | =item SYNOPSIS |
| 16087 | |
| 16088 | =item DESCRIPTION |
| 16089 | |
| 16090 | =over 4 |
| 16091 | |
| 16092 | =item B<use Filter::Util::Call> |
| 16093 | |
| 16094 | =item B<import()> |
| 16095 | |
| 16096 | =item B<filter() and anonymous sub> |
| 16097 | |
| 16098 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> |
| 16099 | |
| 16100 | =back |
| 16101 | |
| 16102 | =item EXAMPLES |
| 16103 | |
| 16104 | =over 4 |
| 16105 | |
| 16106 | =item Example 1: A simple filter. |
| 16107 | |
| 16108 | =item Example 2: Using the context |
| 16109 | |
| 16110 | =item Example 3: Using the context within the filter |
| 16111 | |
| 16112 | =item Example 4: Using filter_del |
| 16113 | |
| 16114 | =back |
| 16115 | |
| 16116 | =item Filter::Simple |
| 16117 | |
| 16118 | =item AUTHOR |
| 16119 | |
| 16120 | =item DATE |
| 16121 | |
| 16122 | =back |
| 16123 | |
| 16124 | =head2 FindBin - Locate directory of original perl script |
| 16125 | |
| 16126 | =over 4 |
| 16127 | |
| 16128 | =item SYNOPSIS |
| 16129 | |
| 16130 | =item DESCRIPTION |
| 16131 | |
| 16132 | =item EXPORTABLE VARIABLES |
| 16133 | |
| 16134 | =item KNOWN ISSUES |
| 16135 | |
| 16136 | =item KNOWN BUGS |
| 16137 | |
| 16138 | =item AUTHORS |
| 16139 | |
| 16140 | =item COPYRIGHT |
| 16141 | |
| 16142 | =back |
| 16143 | |
| 16144 | =head2 GDBM_File - Perl5 access to the gdbm library. |
| 16145 | |
| 16146 | =over 4 |
| 16147 | |
| 16148 | =item SYNOPSIS |
| 16149 | |
| 16150 | =item DESCRIPTION |
| 16151 | |
| 16152 | =item AVAILABILITY |
| 16153 | |
| 16154 | =item BUGS |
| 16155 | |
| 16156 | =item SEE ALSO |
| 16157 | |
| 16158 | =back |
| 16159 | |
| 16160 | =head2 Getopt::Long - Extended processing of command line options |
| 16161 | |
| 16162 | =over 4 |
| 16163 | |
| 16164 | =item SYNOPSIS |
| 16165 | |
| 16166 | =item DESCRIPTION |
| 16167 | |
| 16168 | =item Command Line Options, an Introduction |
| 16169 | |
| 16170 | =item Getting Started with Getopt::Long |
| 16171 | |
| 16172 | =over 4 |
| 16173 | |
| 16174 | =item Simple options |
| 16175 | |
| 16176 | =item A little bit less simple options |
| 16177 | |
| 16178 | =item Mixing command line option with other arguments |
| 16179 | |
| 16180 | =item Options with values |
| 16181 | |
| 16182 | =item Options with multiple values |
| 16183 | |
| 16184 | =item Options with hash values |
| 16185 | |
| 16186 | =item User-defined subroutines to handle options |
| 16187 | |
| 16188 | =item Options with multiple names |
| 16189 | |
| 16190 | =item Case and abbreviations |
| 16191 | |
| 16192 | =item Summary of Option Specifications |
| 16193 | |
| 16194 | !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : |
| 16195 | + [ I<desttype> ] |
| 16196 | |
| 16197 | =back |
| 16198 | |
| 16199 | =item Advanced Possibilities |
| 16200 | |
| 16201 | =over 4 |
| 16202 | |
| 16203 | =item Object oriented interface |
| 16204 | |
| 16205 | =item Thread Safety |
| 16206 | |
| 16207 | =item Documentation and help texts |
| 16208 | |
| 16209 | =item Storing option values in a hash |
| 16210 | |
| 16211 | =item Bundling |
| 16212 | |
| 16213 | =item The lonesome dash |
| 16214 | |
| 16215 | =item Argument callback |
| 16216 | |
| 16217 | =back |
| 16218 | |
| 16219 | =item Configuring Getopt::Long |
| 16220 | |
| 16221 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, |
| 16222 | require_order, permute, bundling (default: disabled), bundling_override |
| 16223 | (default: disabled), ignore_case (default: enabled), ignore_case_always |
| 16224 | (default: disabled), auto_version (default:disabled), auto_help |
| 16225 | (default:disabled), pass_through (default: disabled), prefix, |
| 16226 | prefix_pattern, long_prefix_pattern, debug (default: disabled) |
| 16227 | |
| 16228 | =item Exportable Methods |
| 16229 | |
| 16230 | VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage |
| 16231 | |
| 16232 | =item Return values and Errors |
| 16233 | |
| 16234 | =item Legacy |
| 16235 | |
| 16236 | =over 4 |
| 16237 | |
| 16238 | =item Default destinations |
| 16239 | |
| 16240 | =item Alternative option starters |
| 16241 | |
| 16242 | =item Configuration variables |
| 16243 | |
| 16244 | =back |
| 16245 | |
| 16246 | =item Trouble Shooting |
| 16247 | |
| 16248 | =over 4 |
| 16249 | |
| 16250 | =item GetOptions does not return a false result when an option is not |
| 16251 | supplied |
| 16252 | |
| 16253 | =item GetOptions does not split the command line correctly |
| 16254 | |
| 16255 | =item Undefined subroutine &main::GetOptions called |
| 16256 | |
| 16257 | =item How do I put a "-?" option into a Getopt::Long? |
| 16258 | |
| 16259 | =back |
| 16260 | |
| 16261 | =item AUTHOR |
| 16262 | |
| 16263 | =item COPYRIGHT AND DISCLAIMER |
| 16264 | |
| 16265 | =back |
| 16266 | |
| 16267 | =head2 Getopt::Std, getopt, getopts - Process single-character switches |
| 16268 | with switch clustering |
| 16269 | |
| 16270 | =over 4 |
| 16271 | |
| 16272 | =item SYNOPSIS |
| 16273 | |
| 16274 | =item DESCRIPTION |
| 16275 | |
| 16276 | =item C<--help> and C<--version> |
| 16277 | |
| 16278 | =back |
| 16279 | |
| 16280 | =head2 Hash::Util - A selection of general-utility hash subroutines |
| 16281 | |
| 16282 | =over 4 |
| 16283 | |
| 16284 | =item SYNOPSIS |
| 16285 | |
| 16286 | =item DESCRIPTION |
| 16287 | |
| 16288 | =over 4 |
| 16289 | |
| 16290 | =item Restricted hashes |
| 16291 | |
| 16292 | lock_keys, unlock_keys |
| 16293 | |
| 16294 | =back |
| 16295 | |
| 16296 | =back |
| 16297 | |
| 16298 | lock_value, unlock_value |
| 16299 | |
| 16300 | B<lock_hash>, B<unlock_hash> |
| 16301 | |
| 16302 | B<hash_seed> |
| 16303 | |
| 16304 | =over 4 |
| 16305 | |
| 16306 | =item CAVEATS |
| 16307 | |
| 16308 | =item AUTHOR |
| 16309 | |
| 16310 | =item SEE ALSO |
| 16311 | |
| 16312 | =back |
| 16313 | |
| 16314 | =head2 I18N::Collate - compare 8-bit scalar data according to the current |
| 16315 | locale |
| 16316 | |
| 16317 | =over 4 |
| 16318 | |
| 16319 | =item SYNOPSIS |
| 16320 | |
| 16321 | =item DESCRIPTION |
| 16322 | |
| 16323 | =back |
| 16324 | |
| 16325 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language |
| 16326 | tags |
| 16327 | |
| 16328 | =over 4 |
| 16329 | |
| 16330 | =item SYNOPSIS |
| 16331 | |
| 16332 | =item DESCRIPTION |
| 16333 | |
| 16334 | =back |
| 16335 | |
| 16336 | the function is_language_tag($lang1) |
| 16337 | |
| 16338 | the function extract_language_tags($whatever) |
| 16339 | |
| 16340 | the function same_language_tag($lang1, $lang2) |
| 16341 | |
| 16342 | the function similarity_language_tag($lang1, $lang2) |
| 16343 | |
| 16344 | the function is_dialect_of($lang1, $lang2) |
| 16345 | |
| 16346 | the function super_languages($lang1) |
| 16347 | |
| 16348 | the function locale2language_tag($locale_identifier) |
| 16349 | |
| 16350 | the function encode_language_tag($lang1) |
| 16351 | |
| 16352 | the function alternate_language_tags($lang1) |
| 16353 | |
| 16354 | the function @langs = panic_languages(@accept_languages) |
| 16355 | |
| 16356 | the function implicate_supers( ...languages... ), the function |
| 16357 | implicate_supers_strictly( ...languages... ) |
| 16358 | |
| 16359 | =over 4 |
| 16360 | |
| 16361 | =item ABOUT LOWERCASING |
| 16362 | |
| 16363 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS |
| 16364 | |
| 16365 | =item SEE ALSO |
| 16366 | |
| 16367 | =item COPYRIGHT |
| 16368 | |
| 16369 | =item AUTHOR |
| 16370 | |
| 16371 | =back |
| 16372 | |
| 16373 | =head2 I18N::LangTags::Detect - detect the user's language preferences |
| 16374 | |
| 16375 | =over 4 |
| 16376 | |
| 16377 | =item SYNOPSIS |
| 16378 | |
| 16379 | =item DESCRIPTION |
| 16380 | |
| 16381 | =item FUNCTIONS |
| 16382 | |
| 16383 | =item ENVIRONMENT |
| 16384 | |
| 16385 | =item SEE ALSO |
| 16386 | |
| 16387 | =item COPYRIGHT |
| 16388 | |
| 16389 | =item AUTHOR |
| 16390 | |
| 16391 | =back |
| 16392 | |
| 16393 | =head2 I18N::LangTags::List -- tags and names for human languages |
| 16394 | |
| 16395 | =over 4 |
| 16396 | |
| 16397 | =item SYNOPSIS |
| 16398 | |
| 16399 | =item DESCRIPTION |
| 16400 | |
| 16401 | =item ABOUT LANGUAGE TAGS |
| 16402 | |
| 16403 | =item LIST OF LANGUAGES |
| 16404 | |
| 16405 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : |
| 16406 | Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : |
| 16407 | Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, |
| 16408 | {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], |
| 16409 | {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, |
| 16410 | {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} |
| 16411 | : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : |
| 16412 | Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : |
| 16413 | Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} |
| 16414 | : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : |
| 16415 | Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} |
| 16416 | : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : |
| 16417 | Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : |
| 16418 | Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber |
| 16419 | (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, |
| 16420 | {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : |
| 16421 | Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : |
| 16422 | Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian |
| 16423 | (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central |
| 16424 | American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], |
| 16425 | {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} |
| 16426 | : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : |
| 16427 | Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : |
| 16428 | Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, |
| 16429 | {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} |
| 16430 | : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based |
| 16431 | Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : |
| 16432 | Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : |
| 16433 | Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) |
| 16434 | Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, |
| 16435 | {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, |
| 16436 | {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} |
| 16437 | : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : |
| 16438 | English, {enm} : Old English (1100-1500), {ang} : Old English |
| 16439 | (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : |
| 16440 | Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} |
| 16441 | : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : |
| 16442 | Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French |
| 16443 | (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : |
| 16444 | Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, |
| 16445 | {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, |
| 16446 | {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High |
| 16447 | German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} |
| 16448 | : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient |
| 16449 | Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : |
| 16450 | Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, |
| 16451 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : |
| 16452 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, |
| 16453 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, |
| 16454 | {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European |
| 16455 | (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua |
| 16456 | (International Auxiliary Language Association), {ie} : Interlingue, {iu} : |
| 16457 | Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : |
| 16458 | Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian |
| 16459 | languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : |
| 16460 | Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, |
| 16461 | {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : |
| 16462 | Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} |
| 16463 | : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, |
| 16464 | {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, |
| 16465 | {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, |
| 16466 | {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : |
| 16467 | Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, |
| 16468 | {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : |
| 16469 | Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : |
| 16470 | Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : |
| 16471 | Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban |
| 16472 | (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} |
| 16473 | : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, |
| 16474 | {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, |
| 16475 | {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : |
| 16476 | Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : |
| 16477 | Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : |
| 16478 | Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, |
| 16479 | [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : |
| 16480 | Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : |
| 16481 | Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], |
| 16482 | {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple |
| 16483 | languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, |
| 16484 | {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, |
| 16485 | {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : |
| 16486 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, |
| 16487 | {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : |
| 16488 | Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : |
| 16489 | Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} |
| 16490 | : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : |
| 16491 | Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian |
| 16492 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : |
| 16493 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : |
| 16494 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian |
| 16495 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} |
| 16496 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], |
| 16497 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : |
| 16498 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, |
| 16499 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : |
| 16500 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan |
| 16501 | languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : |
| 16502 | Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, |
| 16503 | [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : |
| 16504 | Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, |
| 16505 | {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, |
| 16506 | {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign |
| 16507 | Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : |
| 16508 | Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave |
| 16509 | (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, |
| 16510 | {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : |
| 16511 | Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : |
| 16512 | South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : |
| 16513 | Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, |
| 16514 | {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : |
| 16515 | Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, |
| 16516 | {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : |
| 16517 | Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : |
| 16518 | Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, |
| 16519 | {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, |
| 16520 | {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : |
| 16521 | Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} |
| 16522 | : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : |
| 16523 | Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, |
| 16524 | {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : |
| 16525 | Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} |
| 16526 | : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} |
| 16527 | : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private |
| 16528 | Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : |
| 16529 | Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} |
| 16530 | : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, |
| 16531 | {zun} : Zuni |
| 16532 | |
| 16533 | =item SEE ALSO |
| 16534 | |
| 16535 | =item COPYRIGHT AND DISCLAIMER |
| 16536 | |
| 16537 | =item AUTHOR |
| 16538 | |
| 16539 | =back |
| 16540 | |
| 16541 | =head2 I18N::Langinfo - query locale information |
| 16542 | |
| 16543 | =over 4 |
| 16544 | |
| 16545 | =item SYNOPSIS |
| 16546 | |
| 16547 | =item DESCRIPTION |
| 16548 | |
| 16549 | =over 4 |
| 16550 | |
| 16551 | =item EXPORT |
| 16552 | |
| 16553 | =back |
| 16554 | |
| 16555 | =item SEE ALSO |
| 16556 | |
| 16557 | =item AUTHOR |
| 16558 | |
| 16559 | =item COPYRIGHT AND LICENSE |
| 16560 | |
| 16561 | =back |
| 16562 | |
| 16563 | =head2 IO - load various IO modules |
| 16564 | |
| 16565 | =over 4 |
| 16566 | |
| 16567 | =item SYNOPSIS |
| 16568 | |
| 16569 | =item DESCRIPTION |
| 16570 | |
| 16571 | =item DEPRECATED |
| 16572 | |
| 16573 | =back |
| 16574 | |
| 16575 | =head2 IO::Dir - supply object methods for directory handles |
| 16576 | |
| 16577 | =over 4 |
| 16578 | |
| 16579 | =item SYNOPSIS |
| 16580 | |
| 16581 | =item DESCRIPTION |
| 16582 | |
| 16583 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
| 16584 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] |
| 16585 | |
| 16586 | =item SEE ALSO |
| 16587 | |
| 16588 | =item AUTHOR |
| 16589 | |
| 16590 | =item COPYRIGHT |
| 16591 | |
| 16592 | =back |
| 16593 | |
| 16594 | =head2 IO::File - supply object methods for filehandles |
| 16595 | |
| 16596 | =over 4 |
| 16597 | |
| 16598 | =item SYNOPSIS |
| 16599 | |
| 16600 | =item DESCRIPTION |
| 16601 | |
| 16602 | =item CONSTRUCTOR |
| 16603 | |
| 16604 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile |
| 16605 | |
| 16606 | =item METHODS |
| 16607 | |
| 16608 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
| 16609 | [LAYER] ) |
| 16610 | |
| 16611 | =item NOTE |
| 16612 | |
| 16613 | =item SEE ALSO |
| 16614 | |
| 16615 | =item HISTORY |
| 16616 | |
| 16617 | =back |
| 16618 | |
| 16619 | =head2 IO::Handle - supply object methods for I/O handles |
| 16620 | |
| 16621 | =over 4 |
| 16622 | |
| 16623 | =item SYNOPSIS |
| 16624 | |
| 16625 | =item DESCRIPTION |
| 16626 | |
| 16627 | =item CONSTRUCTOR |
| 16628 | |
| 16629 | new (), new_from_fd ( FD, MODE ) |
| 16630 | |
| 16631 | =item METHODS |
| 16632 | |
| 16633 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, |
| 16634 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, |
| 16635 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), |
| 16636 | $io->blocking ( [ BOOL ] ), $io->untaint |
| 16637 | |
| 16638 | =item NOTE |
| 16639 | |
| 16640 | =item SEE ALSO |
| 16641 | |
| 16642 | =item BUGS |
| 16643 | |
| 16644 | =item HISTORY |
| 16645 | |
| 16646 | =back |
| 16647 | |
| 16648 | =head2 IO::Pipe - supply object methods for pipes |
| 16649 | |
| 16650 | =over 4 |
| 16651 | |
| 16652 | =item SYNOPSIS |
| 16653 | |
| 16654 | =item DESCRIPTION |
| 16655 | |
| 16656 | =item CONSTRUCTOR |
| 16657 | |
| 16658 | new ( [READER, WRITER] ) |
| 16659 | |
| 16660 | =item METHODS |
| 16661 | |
| 16662 | reader ([ARGS]), writer ([ARGS]), handles () |
| 16663 | |
| 16664 | =item SEE ALSO |
| 16665 | |
| 16666 | =item AUTHOR |
| 16667 | |
| 16668 | =item COPYRIGHT |
| 16669 | |
| 16670 | =back |
| 16671 | |
| 16672 | =head2 IO::Poll - Object interface to system poll call |
| 16673 | |
| 16674 | =over 4 |
| 16675 | |
| 16676 | =item SYNOPSIS |
| 16677 | |
| 16678 | =item DESCRIPTION |
| 16679 | |
| 16680 | =item METHODS |
| 16681 | |
| 16682 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( |
| 16683 | IO ), handles( [ EVENT_MASK ] ) |
| 16684 | |
| 16685 | =item SEE ALSO |
| 16686 | |
| 16687 | =item AUTHOR |
| 16688 | |
| 16689 | =item COPYRIGHT |
| 16690 | |
| 16691 | =back |
| 16692 | |
| 16693 | =head2 IO::Seekable - supply seek based methods for I/O objects |
| 16694 | |
| 16695 | =over 4 |
| 16696 | |
| 16697 | =item SYNOPSIS |
| 16698 | |
| 16699 | =item DESCRIPTION |
| 16700 | |
| 16701 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
| 16702 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), |
| 16703 | $io->tell |
| 16704 | |
| 16705 | =item SEE ALSO |
| 16706 | |
| 16707 | =item HISTORY |
| 16708 | |
| 16709 | =back |
| 16710 | |
| 16711 | =head2 IO::Select - OO interface to the select system call |
| 16712 | |
| 16713 | =over 4 |
| 16714 | |
| 16715 | =item SYNOPSIS |
| 16716 | |
| 16717 | =item DESCRIPTION |
| 16718 | |
| 16719 | =item CONSTRUCTOR |
| 16720 | |
| 16721 | new ( [ HANDLES ] ) |
| 16722 | |
| 16723 | =item METHODS |
| 16724 | |
| 16725 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( |
| 16726 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), |
| 16727 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) |
| 16728 | |
| 16729 | =item EXAMPLE |
| 16730 | |
| 16731 | =item AUTHOR |
| 16732 | |
| 16733 | =item COPYRIGHT |
| 16734 | |
| 16735 | =back |
| 16736 | |
| 16737 | =head2 IO::Socket - Object interface to socket communications |
| 16738 | |
| 16739 | =over 4 |
| 16740 | |
| 16741 | =item SYNOPSIS |
| 16742 | |
| 16743 | =item DESCRIPTION |
| 16744 | |
| 16745 | =item CONSTRUCTOR |
| 16746 | |
| 16747 | new ( [ARGS] ) |
| 16748 | |
| 16749 | =item METHODS |
| 16750 | |
| 16751 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
| 16752 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) |
| 16753 | |
| 16754 | =item SEE ALSO |
| 16755 | |
| 16756 | =item AUTHOR |
| 16757 | |
| 16758 | =item COPYRIGHT |
| 16759 | |
| 16760 | =back |
| 16761 | |
| 16762 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets |
| 16763 | |
| 16764 | =over 4 |
| 16765 | |
| 16766 | =item SYNOPSIS |
| 16767 | |
| 16768 | =item DESCRIPTION |
| 16769 | |
| 16770 | =item CONSTRUCTOR |
| 16771 | |
| 16772 | new ( [ARGS] ) |
| 16773 | |
| 16774 | =over 4 |
| 16775 | |
| 16776 | =item METHODS |
| 16777 | |
| 16778 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost |
| 16779 | () |
| 16780 | |
| 16781 | =back |
| 16782 | |
| 16783 | =item SEE ALSO |
| 16784 | |
| 16785 | =item AUTHOR |
| 16786 | |
| 16787 | =item COPYRIGHT |
| 16788 | |
| 16789 | =back |
| 16790 | |
| 16791 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets |
| 16792 | |
| 16793 | =over 4 |
| 16794 | |
| 16795 | =item SYNOPSIS |
| 16796 | |
| 16797 | =item DESCRIPTION |
| 16798 | |
| 16799 | =item CONSTRUCTOR |
| 16800 | |
| 16801 | new ( [ARGS] ) |
| 16802 | |
| 16803 | =item METHODS |
| 16804 | |
| 16805 | hostpath(), peerpath() |
| 16806 | |
| 16807 | =item SEE ALSO |
| 16808 | |
| 16809 | =item AUTHOR |
| 16810 | |
| 16811 | =item COPYRIGHT |
| 16812 | |
| 16813 | =back |
| 16814 | |
| 16815 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory |
| 16816 | handles |
| 16817 | |
| 16818 | =over 4 |
| 16819 | |
| 16820 | =item SYNOPSIS |
| 16821 | |
| 16822 | =item DESCRIPTION |
| 16823 | |
| 16824 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
| 16825 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] |
| 16826 | |
| 16827 | =item SEE ALSO |
| 16828 | |
| 16829 | =item AUTHOR |
| 16830 | |
| 16831 | =item COPYRIGHT |
| 16832 | |
| 16833 | =back |
| 16834 | |
| 16835 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
| 16836 | |
| 16837 | =over 4 |
| 16838 | |
| 16839 | =item SYNOPSIS |
| 16840 | |
| 16841 | =item DESCRIPTION |
| 16842 | |
| 16843 | =item CONSTRUCTOR |
| 16844 | |
| 16845 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile |
| 16846 | |
| 16847 | =item METHODS |
| 16848 | |
| 16849 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
| 16850 | [LAYER] ) |
| 16851 | |
| 16852 | =item NOTE |
| 16853 | |
| 16854 | =item SEE ALSO |
| 16855 | |
| 16856 | =item HISTORY |
| 16857 | |
| 16858 | =back |
| 16859 | |
| 16860 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
| 16861 | handles |
| 16862 | |
| 16863 | =over 4 |
| 16864 | |
| 16865 | =item SYNOPSIS |
| 16866 | |
| 16867 | =item DESCRIPTION |
| 16868 | |
| 16869 | =item CONSTRUCTOR |
| 16870 | |
| 16871 | new (), new_from_fd ( FD, MODE ) |
| 16872 | |
| 16873 | =item METHODS |
| 16874 | |
| 16875 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, |
| 16876 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, |
| 16877 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), |
| 16878 | $io->blocking ( [ BOOL ] ), $io->untaint |
| 16879 | |
| 16880 | =item NOTE |
| 16881 | |
| 16882 | =item SEE ALSO |
| 16883 | |
| 16884 | =item BUGS |
| 16885 | |
| 16886 | =item HISTORY |
| 16887 | |
| 16888 | =back |
| 16889 | |
| 16890 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes |
| 16891 | |
| 16892 | =over 4 |
| 16893 | |
| 16894 | =item SYNOPSIS |
| 16895 | |
| 16896 | =item DESCRIPTION |
| 16897 | |
| 16898 | =item CONSTRUCTOR |
| 16899 | |
| 16900 | new ( [READER, WRITER] ) |
| 16901 | |
| 16902 | =item METHODS |
| 16903 | |
| 16904 | reader ([ARGS]), writer ([ARGS]), handles () |
| 16905 | |
| 16906 | =item SEE ALSO |
| 16907 | |
| 16908 | =item AUTHOR |
| 16909 | |
| 16910 | =item COPYRIGHT |
| 16911 | |
| 16912 | =back |
| 16913 | |
| 16914 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call |
| 16915 | |
| 16916 | =over 4 |
| 16917 | |
| 16918 | =item SYNOPSIS |
| 16919 | |
| 16920 | =item DESCRIPTION |
| 16921 | |
| 16922 | =item METHODS |
| 16923 | |
| 16924 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( |
| 16925 | IO ), handles( [ EVENT_MASK ] ) |
| 16926 | |
| 16927 | =item SEE ALSO |
| 16928 | |
| 16929 | =item AUTHOR |
| 16930 | |
| 16931 | =item COPYRIGHT |
| 16932 | |
| 16933 | =back |
| 16934 | |
| 16935 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for |
| 16936 | I/O objects |
| 16937 | |
| 16938 | =over 4 |
| 16939 | |
| 16940 | =item SYNOPSIS |
| 16941 | |
| 16942 | =item DESCRIPTION |
| 16943 | |
| 16944 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
| 16945 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), |
| 16946 | $io->tell |
| 16947 | |
| 16948 | =item SEE ALSO |
| 16949 | |
| 16950 | =item HISTORY |
| 16951 | |
| 16952 | =back |
| 16953 | |
| 16954 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system |
| 16955 | call |
| 16956 | |
| 16957 | =over 4 |
| 16958 | |
| 16959 | =item SYNOPSIS |
| 16960 | |
| 16961 | =item DESCRIPTION |
| 16962 | |
| 16963 | =item CONSTRUCTOR |
| 16964 | |
| 16965 | new ( [ HANDLES ] ) |
| 16966 | |
| 16967 | =item METHODS |
| 16968 | |
| 16969 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( |
| 16970 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), |
| 16971 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) |
| 16972 | |
| 16973 | =item EXAMPLE |
| 16974 | |
| 16975 | =item AUTHOR |
| 16976 | |
| 16977 | =item COPYRIGHT |
| 16978 | |
| 16979 | =back |
| 16980 | |
| 16981 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket |
| 16982 | communications |
| 16983 | |
| 16984 | =over 4 |
| 16985 | |
| 16986 | =item SYNOPSIS |
| 16987 | |
| 16988 | =item DESCRIPTION |
| 16989 | |
| 16990 | =item CONSTRUCTOR |
| 16991 | |
| 16992 | new ( [ARGS] ) |
| 16993 | |
| 16994 | =item METHODS |
| 16995 | |
| 16996 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
| 16997 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) |
| 16998 | |
| 16999 | =item SEE ALSO |
| 17000 | |
| 17001 | =item AUTHOR |
| 17002 | |
| 17003 | =item COPYRIGHT |
| 17004 | |
| 17005 | =back |
| 17006 | |
| 17007 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for |
| 17008 | AF_INET domain sockets |
| 17009 | |
| 17010 | =over 4 |
| 17011 | |
| 17012 | =item SYNOPSIS |
| 17013 | |
| 17014 | =item DESCRIPTION |
| 17015 | |
| 17016 | =item CONSTRUCTOR |
| 17017 | |
| 17018 | new ( [ARGS] ) |
| 17019 | |
| 17020 | =over 4 |
| 17021 | |
| 17022 | =item METHODS |
| 17023 | |
| 17024 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost |
| 17025 | () |
| 17026 | |
| 17027 | =back |
| 17028 | |
| 17029 | =item SEE ALSO |
| 17030 | |
| 17031 | =item AUTHOR |
| 17032 | |
| 17033 | =item COPYRIGHT |
| 17034 | |
| 17035 | =back |
| 17036 | |
| 17037 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for |
| 17038 | AF_UNIX domain sockets |
| 17039 | |
| 17040 | =over 4 |
| 17041 | |
| 17042 | =item SYNOPSIS |
| 17043 | |
| 17044 | =item DESCRIPTION |
| 17045 | |
| 17046 | =item CONSTRUCTOR |
| 17047 | |
| 17048 | new ( [ARGS] ) |
| 17049 | |
| 17050 | =item METHODS |
| 17051 | |
| 17052 | hostpath(), peerpath() |
| 17053 | |
| 17054 | =item SEE ALSO |
| 17055 | |
| 17056 | =item AUTHOR |
| 17057 | |
| 17058 | =item COPYRIGHT |
| 17059 | |
| 17060 | =back |
| 17061 | |
| 17062 | =head2 IPC::Msg - SysV Msg IPC object class |
| 17063 | |
| 17064 | =over 4 |
| 17065 | |
| 17066 | =item SYNOPSIS |
| 17067 | |
| 17068 | =item DESCRIPTION |
| 17069 | |
| 17070 | =item METHODS |
| 17071 | |
| 17072 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set |
| 17073 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, |
| 17074 | FLAGS ] ), stat |
| 17075 | |
| 17076 | =item SEE ALSO |
| 17077 | |
| 17078 | =item AUTHOR |
| 17079 | |
| 17080 | =item COPYRIGHT |
| 17081 | |
| 17082 | =back |
| 17083 | |
| 17084 | =head2 IPC::Open2, open2 - open a process for both reading and writing |
| 17085 | |
| 17086 | =over 4 |
| 17087 | |
| 17088 | =item SYNOPSIS |
| 17089 | |
| 17090 | =item DESCRIPTION |
| 17091 | |
| 17092 | =item WARNING |
| 17093 | |
| 17094 | =item SEE ALSO |
| 17095 | |
| 17096 | =back |
| 17097 | |
| 17098 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error |
| 17099 | handling |
| 17100 | |
| 17101 | =over 4 |
| 17102 | |
| 17103 | =item SYNOPSIS |
| 17104 | |
| 17105 | =item DESCRIPTION |
| 17106 | |
| 17107 | =item WARNING |
| 17108 | |
| 17109 | =back |
| 17110 | |
| 17111 | =head2 IPC::Semaphore - SysV Semaphore IPC object class |
| 17112 | |
| 17113 | =over 4 |
| 17114 | |
| 17115 | =item SYNOPSIS |
| 17116 | |
| 17117 | =item DESCRIPTION |
| 17118 | |
| 17119 | =item METHODS |
| 17120 | |
| 17121 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), |
| 17122 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), |
| 17123 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N |
| 17124 | , VALUE ), stat |
| 17125 | |
| 17126 | =item SEE ALSO |
| 17127 | |
| 17128 | =item AUTHOR |
| 17129 | |
| 17130 | =item COPYRIGHT |
| 17131 | |
| 17132 | =back |
| 17133 | |
| 17134 | =head2 IPC::SysV - SysV IPC constants |
| 17135 | |
| 17136 | =over 4 |
| 17137 | |
| 17138 | =item SYNOPSIS |
| 17139 | |
| 17140 | =item DESCRIPTION |
| 17141 | |
| 17142 | ftok( PATH, ID ) |
| 17143 | |
| 17144 | =item SEE ALSO |
| 17145 | |
| 17146 | =item AUTHORS |
| 17147 | |
| 17148 | =item COPYRIGHT |
| 17149 | |
| 17150 | =back |
| 17151 | |
| 17152 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class |
| 17153 | |
| 17154 | =over 4 |
| 17155 | |
| 17156 | =item SYNOPSIS |
| 17157 | |
| 17158 | =item DESCRIPTION |
| 17159 | |
| 17160 | =item METHODS |
| 17161 | |
| 17162 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set |
| 17163 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, |
| 17164 | FLAGS ] ), stat |
| 17165 | |
| 17166 | =item SEE ALSO |
| 17167 | |
| 17168 | =item AUTHOR |
| 17169 | |
| 17170 | =item COPYRIGHT |
| 17171 | |
| 17172 | =back |
| 17173 | |
| 17174 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object |
| 17175 | class |
| 17176 | |
| 17177 | =over 4 |
| 17178 | |
| 17179 | =item SYNOPSIS |
| 17180 | |
| 17181 | =item DESCRIPTION |
| 17182 | |
| 17183 | =item METHODS |
| 17184 | |
| 17185 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), |
| 17186 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), |
| 17187 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N |
| 17188 | , VALUE ), stat |
| 17189 | |
| 17190 | =item SEE ALSO |
| 17191 | |
| 17192 | =item AUTHOR |
| 17193 | |
| 17194 | =item COPYRIGHT |
| 17195 | |
| 17196 | =back |
| 17197 | |
| 17198 | =head2 List::Util - A selection of general-utility list subroutines |
| 17199 | |
| 17200 | =over 4 |
| 17201 | |
| 17202 | =item SYNOPSIS |
| 17203 | |
| 17204 | =item DESCRIPTION |
| 17205 | |
| 17206 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce |
| 17207 | BLOCK LIST, shuffle LIST, sum LIST |
| 17208 | |
| 17209 | =item KNOWN BUGS |
| 17210 | |
| 17211 | =item SUGGESTED ADDITIONS |
| 17212 | |
| 17213 | =item COPYRIGHT |
| 17214 | |
| 17215 | =back |
| 17216 | |
| 17217 | =head2 List::Utilib::List::Util, List::Util - A selection of |
| 17218 | general-utility list subroutines |
| 17219 | |
| 17220 | =over 4 |
| 17221 | |
| 17222 | =item SYNOPSIS |
| 17223 | |
| 17224 | =item DESCRIPTION |
| 17225 | |
| 17226 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce |
| 17227 | BLOCK LIST, shuffle LIST, sum LIST |
| 17228 | |
| 17229 | =item KNOWN BUGS |
| 17230 | |
| 17231 | =item SUGGESTED ADDITIONS |
| 17232 | |
| 17233 | =item COPYRIGHT |
| 17234 | |
| 17235 | =back |
| 17236 | |
| 17237 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of |
| 17238 | general-utility scalar subroutines |
| 17239 | |
| 17240 | =over 4 |
| 17241 | |
| 17242 | =item SYNOPSIS |
| 17243 | |
| 17244 | =item DESCRIPTION |
| 17245 | |
| 17246 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, |
| 17247 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, |
| 17248 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF |
| 17249 | |
| 17250 | =item KNOWN BUGS |
| 17251 | |
| 17252 | =item COPYRIGHT |
| 17253 | |
| 17254 | =item BLATANT PLUG |
| 17255 | |
| 17256 | =back |
| 17257 | |
| 17258 | =head2 Locale::Constants - constants for Locale codes |
| 17259 | |
| 17260 | =over 4 |
| 17261 | |
| 17262 | =item SYNOPSIS |
| 17263 | |
| 17264 | =item DESCRIPTION |
| 17265 | |
| 17266 | =item KNOWN BUGS AND LIMITATIONS |
| 17267 | |
| 17268 | =item SEE ALSO |
| 17269 | |
| 17270 | Locale::Language, Locale::Country, Locale::Script, Locale::Currency |
| 17271 | |
| 17272 | =item AUTHOR |
| 17273 | |
| 17274 | =item COPYRIGHT |
| 17275 | |
| 17276 | =back |
| 17277 | |
| 17278 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) |
| 17279 | |
| 17280 | =over 4 |
| 17281 | |
| 17282 | =item SYNOPSIS |
| 17283 | |
| 17284 | =item DESCRIPTION |
| 17285 | |
| 17286 | B<alpha-2>, B<alpha-3>, B<numeric> |
| 17287 | |
| 17288 | =item CONVERSION ROUTINES |
| 17289 | |
| 17290 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), |
| 17291 | country_code2code( CODE, CODESET, CODESET ) |
| 17292 | |
| 17293 | =item QUERY ROUTINES |
| 17294 | |
| 17295 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> |
| 17296 | |
| 17297 | =item SEMI-PRIVATE ROUTINES |
| 17298 | |
| 17299 | =over 4 |
| 17300 | |
| 17301 | =item alias_code |
| 17302 | |
| 17303 | =item rename_country |
| 17304 | |
| 17305 | =back |
| 17306 | |
| 17307 | =item EXAMPLES |
| 17308 | |
| 17309 | =item DOMAIN NAMES |
| 17310 | |
| 17311 | =item KNOWN BUGS AND LIMITATIONS |
| 17312 | |
| 17313 | =item SEE ALSO |
| 17314 | |
| 17315 | Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO |
| 17316 | 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, |
| 17317 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, |
| 17318 | http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html |
| 17319 | |
| 17320 | =item AUTHOR |
| 17321 | |
| 17322 | =item COPYRIGHT |
| 17323 | |
| 17324 | =back |
| 17325 | |
| 17326 | =head2 Locale::Currency - ISO three letter codes for currency |
| 17327 | identification (ISO 4217) |
| 17328 | |
| 17329 | =over 4 |
| 17330 | |
| 17331 | =item SYNOPSIS |
| 17332 | |
| 17333 | =item DESCRIPTION |
| 17334 | |
| 17335 | XTS, XXX |
| 17336 | |
| 17337 | =item CONVERSION ROUTINES |
| 17338 | |
| 17339 | code2currency(), currency2code() |
| 17340 | |
| 17341 | =item QUERY ROUTINES |
| 17342 | |
| 17343 | C<all_currency_codes()>, C<all_currency_names()> |
| 17344 | |
| 17345 | =item EXAMPLES |
| 17346 | |
| 17347 | =item KNOWN BUGS AND LIMITATIONS |
| 17348 | |
| 17349 | =item SEE ALSO |
| 17350 | |
| 17351 | Locale::Country, Locale::Script, ISO 4217:1995, |
| 17352 | http://www.bsi-global.com/iso4217currency |
| 17353 | |
| 17354 | =item AUTHOR |
| 17355 | |
| 17356 | =item COPYRIGHT |
| 17357 | |
| 17358 | =back |
| 17359 | |
| 17360 | =head2 Locale::Language - ISO two letter codes for language identification |
| 17361 | (ISO 639) |
| 17362 | |
| 17363 | =over 4 |
| 17364 | |
| 17365 | =item SYNOPSIS |
| 17366 | |
| 17367 | =item DESCRIPTION |
| 17368 | |
| 17369 | =item CONVERSION ROUTINES |
| 17370 | |
| 17371 | code2language(), language2code() |
| 17372 | |
| 17373 | =item QUERY ROUTINES |
| 17374 | |
| 17375 | C<all_language_codes()>, C<all_language_names()> |
| 17376 | |
| 17377 | =item EXAMPLES |
| 17378 | |
| 17379 | =item KNOWN BUGS AND LIMITATIONS |
| 17380 | |
| 17381 | =item SEE ALSO |
| 17382 | |
| 17383 | Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), |
| 17384 | http://lcweb.loc.gov/standards/iso639-2/langhome.html |
| 17385 | |
| 17386 | =item AUTHOR |
| 17387 | |
| 17388 | =item COPYRIGHT |
| 17389 | |
| 17390 | =back |
| 17391 | |
| 17392 | =head2 Locale::Maketext - framework for localization |
| 17393 | |
| 17394 | =over 4 |
| 17395 | |
| 17396 | =item SYNOPSIS |
| 17397 | |
| 17398 | =item DESCRIPTION |
| 17399 | |
| 17400 | =item QUICK OVERVIEW |
| 17401 | |
| 17402 | =item METHODS |
| 17403 | |
| 17404 | =over 4 |
| 17405 | |
| 17406 | =item Construction Methods |
| 17407 | |
| 17408 | =item The "maketext" Method |
| 17409 | |
| 17410 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto |
| 17411 | |
| 17412 | =item Utility Methods |
| 17413 | |
| 17414 | $language->quant($number, $singular), $language->quant($number, $singular, |
| 17415 | $plural), $language->quant($number, $singular, $plural, $negative), |
| 17416 | $language->numf($number), $language->sprintf($format, @items), |
| 17417 | $language->language_tag(), $language->encoding() |
| 17418 | |
| 17419 | =item Language Handle Attributes and Internals |
| 17420 | |
| 17421 | =back |
| 17422 | |
| 17423 | =item LANGUAGE CLASS HIERARCHIES |
| 17424 | |
| 17425 | =item ENTRIES IN EACH LEXICON |
| 17426 | |
| 17427 | =item BRACKET NOTATION |
| 17428 | |
| 17429 | =item AUTO LEXICONS |
| 17430 | |
| 17431 | =item CONTROLLING LOOKUP FAILURE |
| 17432 | |
| 17433 | =item HOW TO USE MAKETEXT |
| 17434 | |
| 17435 | =item SEE ALSO |
| 17436 | |
| 17437 | =item COPYRIGHT AND DISCLAIMER |
| 17438 | |
| 17439 | =item AUTHOR |
| 17440 | |
| 17441 | =back |
| 17442 | |
| 17443 | =head2 Locale::Maketext::TPJ13 -- article about software localization |
| 17444 | |
| 17445 | =over 4 |
| 17446 | |
| 17447 | =item SYNOPSIS |
| 17448 | |
| 17449 | =item DESCRIPTION |
| 17450 | |
| 17451 | =item Localization and Perl: gettext breaks, Maketext fixes |
| 17452 | |
| 17453 | =over 4 |
| 17454 | |
| 17455 | =item A Localization Horror Story: It Could Happen To You |
| 17456 | |
| 17457 | =item The Linguistic View |
| 17458 | |
| 17459 | =item Breaking gettext |
| 17460 | |
| 17461 | =item Replacing gettext |
| 17462 | |
| 17463 | =item Buzzwords: Abstraction and Encapsulation |
| 17464 | |
| 17465 | =item Buzzword: Isomorphism |
| 17466 | |
| 17467 | =item Buzzword: Inheritance |
| 17468 | |
| 17469 | =item Buzzword: Concision |
| 17470 | |
| 17471 | =item The Devil in the Details |
| 17472 | |
| 17473 | =item The Proof in the Pudding: Localizing Web Sites |
| 17474 | |
| 17475 | =item References |
| 17476 | |
| 17477 | =back |
| 17478 | |
| 17479 | =back |
| 17480 | |
| 17481 | =head2 Locale::Script - ISO codes for script identification (ISO 15924) |
| 17482 | |
| 17483 | =over 4 |
| 17484 | |
| 17485 | =item SYNOPSIS |
| 17486 | |
| 17487 | =item DESCRIPTION |
| 17488 | |
| 17489 | B<alpha-2>, B<alpha-3>, B<numeric> |
| 17490 | |
| 17491 | =over 4 |
| 17492 | |
| 17493 | =item SPECIAL CODES |
| 17494 | |
| 17495 | =back |
| 17496 | |
| 17497 | =item CONVERSION ROUTINES |
| 17498 | |
| 17499 | code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), |
| 17500 | script_code2code( CODE, CODESET, CODESET ) |
| 17501 | |
| 17502 | =item QUERY ROUTINES |
| 17503 | |
| 17504 | C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> |
| 17505 | |
| 17506 | =item EXAMPLES |
| 17507 | |
| 17508 | =item KNOWN BUGS AND LIMITATIONS |
| 17509 | |
| 17510 | =item SEE ALSO |
| 17511 | |
| 17512 | Locale::Language, Locale::Currency, Locale::Country, ISO 15924, |
| 17513 | http://www.evertype.com/standards/iso15924/ |
| 17514 | |
| 17515 | =item AUTHOR |
| 17516 | |
| 17517 | =item COPYRIGHT |
| 17518 | |
| 17519 | =back |
| 17520 | |
| 17521 | =head2 MIME::Base64 - Encoding and decoding of base64 strings |
| 17522 | |
| 17523 | =over 4 |
| 17524 | |
| 17525 | =item SYNOPSIS |
| 17526 | |
| 17527 | =item DESCRIPTION |
| 17528 | |
| 17529 | encode_base64($str), encode_base64($str, $eol);, decode_base64($str) |
| 17530 | |
| 17531 | =item DIAGNOSTICS |
| 17532 | |
| 17533 | Premature end of base64 data, Premature padding of base64 data, Wide |
| 17534 | character in subroutine entry |
| 17535 | |
| 17536 | =item EXAMPLES |
| 17537 | |
| 17538 | =item COPYRIGHT |
| 17539 | |
| 17540 | =item SEE ALSO |
| 17541 | |
| 17542 | =back |
| 17543 | |
| 17544 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding |
| 17545 | of quoted-printable strings |
| 17546 | |
| 17547 | =over 4 |
| 17548 | |
| 17549 | =item SYNOPSIS |
| 17550 | |
| 17551 | =item DESCRIPTION |
| 17552 | |
| 17553 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
| 17554 | decode_qp($str); |
| 17555 | |
| 17556 | =item COPYRIGHT |
| 17557 | |
| 17558 | =item SEE ALSO |
| 17559 | |
| 17560 | =back |
| 17561 | |
| 17562 | =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable |
| 17563 | strings |
| 17564 | |
| 17565 | =over 4 |
| 17566 | |
| 17567 | =item SYNOPSIS |
| 17568 | |
| 17569 | =item DESCRIPTION |
| 17570 | |
| 17571 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
| 17572 | decode_qp($str); |
| 17573 | |
| 17574 | =item COPYRIGHT |
| 17575 | |
| 17576 | =item SEE ALSO |
| 17577 | |
| 17578 | =back |
| 17579 | |
| 17580 | =head2 Math::BigFloat - Arbitrary size floating point math package |
| 17581 | |
| 17582 | =over 4 |
| 17583 | |
| 17584 | =item SYNOPSIS |
| 17585 | |
| 17586 | =item DESCRIPTION |
| 17587 | |
| 17588 | =over 4 |
| 17589 | |
| 17590 | =item Canonical notation |
| 17591 | |
| 17592 | =item Output |
| 17593 | |
| 17594 | =item C<mantissa()>, C<exponent()> and C<parts()> |
| 17595 | |
| 17596 | =item Accuracy vs. Precision |
| 17597 | |
| 17598 | =item Rounding |
| 17599 | |
| 17600 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale |
| 17601 | ), fround ( -$scale ) and fround ( 0 ) |
| 17602 | |
| 17603 | =back |
| 17604 | |
| 17605 | =item METHODS |
| 17606 | |
| 17607 | =over 4 |
| 17608 | |
| 17609 | =item accuracy |
| 17610 | |
| 17611 | =item precision() |
| 17612 | |
| 17613 | =back |
| 17614 | |
| 17615 | =item Autocreating constants |
| 17616 | |
| 17617 | =over 4 |
| 17618 | |
| 17619 | =item Math library |
| 17620 | |
| 17621 | =item Using Math::BigInt::Lite |
| 17622 | |
| 17623 | =back |
| 17624 | |
| 17625 | =item BUGS |
| 17626 | |
| 17627 | =item CAVEATS |
| 17628 | |
| 17629 | stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() |
| 17630 | |
| 17631 | =item SEE ALSO |
| 17632 | |
| 17633 | =item LICENSE |
| 17634 | |
| 17635 | =item AUTHORS |
| 17636 | |
| 17637 | =back |
| 17638 | |
| 17639 | =head2 Math::BigInt - Arbitrary size integer/float math package |
| 17640 | |
| 17641 | =over 4 |
| 17642 | |
| 17643 | =item SYNOPSIS |
| 17644 | |
| 17645 | =item DESCRIPTION |
| 17646 | |
| 17647 | Input, Output |
| 17648 | |
| 17649 | =item METHODS |
| 17650 | |
| 17651 | =over 4 |
| 17652 | |
| 17653 | =item config |
| 17654 | |
| 17655 | =item accuracy |
| 17656 | |
| 17657 | =item precision |
| 17658 | |
| 17659 | =item brsft |
| 17660 | |
| 17661 | =item new |
| 17662 | |
| 17663 | =item bnan |
| 17664 | |
| 17665 | =item bzero |
| 17666 | |
| 17667 | =item binf |
| 17668 | |
| 17669 | =item bone |
| 17670 | |
| 17671 | =item is_one()/is_zero()/is_nan()/is_inf() |
| 17672 | |
| 17673 | =item is_pos()/is_neg() |
| 17674 | |
| 17675 | $x->is_pos(); # true if > 0 |
| 17676 | $x->is_neg(); # true if < 0 |
| 17677 | |
| 17678 | =item is_odd()/is_even()/is_int() |
| 17679 | |
| 17680 | =item bcmp |
| 17681 | |
| 17682 | =item bacmp |
| 17683 | |
| 17684 | =item sign |
| 17685 | |
| 17686 | =item digit |
| 17687 | |
| 17688 | =item bneg |
| 17689 | |
| 17690 | =item babs |
| 17691 | |
| 17692 | =item bnorm |
| 17693 | |
| 17694 | =item bnot |
| 17695 | |
| 17696 | =item binc |
| 17697 | |
| 17698 | =item bdec |
| 17699 | |
| 17700 | =item badd |
| 17701 | |
| 17702 | =item bsub |
| 17703 | |
| 17704 | =item bmul |
| 17705 | |
| 17706 | =item bdiv |
| 17707 | |
| 17708 | =item bmod |
| 17709 | |
| 17710 | =item bmodinv |
| 17711 | |
| 17712 | =item bmodpow |
| 17713 | |
| 17714 | =item bpow |
| 17715 | |
| 17716 | =item blsft |
| 17717 | |
| 17718 | =item brsft |
| 17719 | |
| 17720 | =item band |
| 17721 | |
| 17722 | =item bior |
| 17723 | |
| 17724 | =item bxor |
| 17725 | |
| 17726 | =item bnot |
| 17727 | |
| 17728 | =item bsqrt |
| 17729 | |
| 17730 | =item bfac |
| 17731 | |
| 17732 | =item round |
| 17733 | |
| 17734 | =item bround |
| 17735 | |
| 17736 | =item bfround |
| 17737 | |
| 17738 | =item bfloor |
| 17739 | |
| 17740 | =item bceil |
| 17741 | |
| 17742 | =item bgcd |
| 17743 | |
| 17744 | =item blcm |
| 17745 | |
| 17746 | =item exponent |
| 17747 | |
| 17748 | =item mantissa |
| 17749 | |
| 17750 | =item parts |
| 17751 | |
| 17752 | =item copy |
| 17753 | |
| 17754 | =item as_int |
| 17755 | |
| 17756 | =item bsstr |
| 17757 | |
| 17758 | =item as_hex |
| 17759 | |
| 17760 | =item as_bin |
| 17761 | |
| 17762 | =back |
| 17763 | |
| 17764 | =item ACCURACY and PRECISION |
| 17765 | |
| 17766 | =over 4 |
| 17767 | |
| 17768 | =item Precision P |
| 17769 | |
| 17770 | =item Accuracy A |
| 17771 | |
| 17772 | =item Fallback F |
| 17773 | |
| 17774 | =item Rounding mode R |
| 17775 | |
| 17776 | 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy |
| 17777 | (significant digits), Setting/Accessing, Creating numbers, Usage, |
| 17778 | Precedence, Overriding globals, Local settings, Rounding, Default values, |
| 17779 | Remarks |
| 17780 | |
| 17781 | =back |
| 17782 | |
| 17783 | =item Infinity and Not a Number |
| 17784 | |
| 17785 | oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() |
| 17786 | |
| 17787 | =item INTERNALS |
| 17788 | |
| 17789 | =over 4 |
| 17790 | |
| 17791 | =item MATH LIBRARY |
| 17792 | |
| 17793 | =item SIGN |
| 17794 | |
| 17795 | =item mantissa(), exponent() and parts() |
| 17796 | |
| 17797 | =back |
| 17798 | |
| 17799 | =item EXAMPLES |
| 17800 | |
| 17801 | use Math::BigInt; |
| 17802 | |
| 17803 | =item Autocreating constants |
| 17804 | |
| 17805 | =item PERFORMANCE |
| 17806 | |
| 17807 | =over 4 |
| 17808 | |
| 17809 | =item Alternative math libraries |
| 17810 | |
| 17811 | =item SUBCLASSING |
| 17812 | |
| 17813 | =back |
| 17814 | |
| 17815 | =item Subclassing Math::BigInt |
| 17816 | |
| 17817 | =item UPGRADING |
| 17818 | |
| 17819 | =over 4 |
| 17820 | |
| 17821 | =item Auto-upgrade |
| 17822 | |
| 17823 | bsqrt(), div(), blog() |
| 17824 | |
| 17825 | =back |
| 17826 | |
| 17827 | =item BUGS |
| 17828 | |
| 17829 | broot() does not work, Out of Memory!, Fails to load Calc on Perl prior |
| 17830 | 5.6.0 |
| 17831 | |
| 17832 | =item CAVEATS |
| 17833 | |
| 17834 | bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, |
| 17835 | Modifying and =, bpow, Overloading -$x, Mixing different object types, |
| 17836 | bsqrt(), brsft() |
| 17837 | |
| 17838 | =item LICENSE |
| 17839 | |
| 17840 | =item SEE ALSO |
| 17841 | |
| 17842 | =item AUTHORS |
| 17843 | |
| 17844 | =back |
| 17845 | |
| 17846 | =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt |
| 17847 | |
| 17848 | =over 4 |
| 17849 | |
| 17850 | =item SYNOPSIS |
| 17851 | |
| 17852 | =item DESCRIPTION |
| 17853 | |
| 17854 | =item STORAGE |
| 17855 | |
| 17856 | =item METHODS |
| 17857 | |
| 17858 | =item WRAP YOUR OWN |
| 17859 | |
| 17860 | =item LICENSE |
| 17861 | |
| 17862 | This program is free software; you may redistribute it and/or modify it |
| 17863 | under |
| 17864 | the same terms as Perl itself. |
| 17865 | |
| 17866 | =item AUTHORS |
| 17867 | |
| 17868 | =item SEE ALSO |
| 17869 | |
| 17870 | =back |
| 17871 | |
| 17872 | =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code |
| 17873 | |
| 17874 | =over 4 |
| 17875 | |
| 17876 | =item SYNOPSIS |
| 17877 | |
| 17878 | =item DESCRIPTION |
| 17879 | |
| 17880 | =item METHODS |
| 17881 | |
| 17882 | =over 4 |
| 17883 | |
| 17884 | =item __emu_bxor |
| 17885 | |
| 17886 | =item __emu_band |
| 17887 | |
| 17888 | =item __emu_bior |
| 17889 | |
| 17890 | =back |
| 17891 | |
| 17892 | =item LICENSE |
| 17893 | |
| 17894 | This program is free software; you may redistribute it and/or modify it |
| 17895 | under |
| 17896 | the same terms as Perl itself. |
| 17897 | |
| 17898 | =item AUTHORS |
| 17899 | |
| 17900 | =item SEE ALSO |
| 17901 | |
| 17902 | =back |
| 17903 | |
| 17904 | =head2 Math::BigRat - Arbitrary big rational numbers |
| 17905 | |
| 17906 | =over 4 |
| 17907 | |
| 17908 | =item SYNOPSIS |
| 17909 | |
| 17910 | =item DESCRIPTION |
| 17911 | |
| 17912 | =over 4 |
| 17913 | |
| 17914 | =item MATH LIBRARY |
| 17915 | |
| 17916 | =back |
| 17917 | |
| 17918 | =item METHODS |
| 17919 | |
| 17920 | =over 4 |
| 17921 | |
| 17922 | =item new() |
| 17923 | |
| 17924 | =item numerator() |
| 17925 | |
| 17926 | =item denominator() |
| 17927 | |
| 17928 | $d = $x->denominator(); |
| 17929 | |
| 17930 | =item parts() |
| 17931 | |
| 17932 | =item as_int() |
| 17933 | |
| 17934 | =item as_hex() |
| 17935 | |
| 17936 | =item as_bin() |
| 17937 | |
| 17938 | =item bfac() |
| 17939 | |
| 17940 | =item blog() |
| 17941 | |
| 17942 | =item bround()/round()/bfround() |
| 17943 | |
| 17944 | =item bmod() |
| 17945 | |
| 17946 | =item is_one() |
| 17947 | |
| 17948 | =item is_zero() |
| 17949 | |
| 17950 | =item is_pos() |
| 17951 | |
| 17952 | =item is_neg() |
| 17953 | |
| 17954 | =item is_int() |
| 17955 | |
| 17956 | =item is_odd() |
| 17957 | |
| 17958 | =item is_even() |
| 17959 | |
| 17960 | =item bceil() |
| 17961 | |
| 17962 | =item bfloor() |
| 17963 | |
| 17964 | $x->bfloor(); |
| 17965 | |
| 17966 | =item bsqrt() |
| 17967 | |
| 17968 | $x->bsqrt(); |
| 17969 | |
| 17970 | =item config |
| 17971 | |
| 17972 | =back |
| 17973 | |
| 17974 | =item BUGS |
| 17975 | |
| 17976 | inf handling (partial), NaN handling (partial), rounding (not implemented |
| 17977 | except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), |
| 17978 | blog(), bmodinv() and bmodpow() (partial) |
| 17979 | |
| 17980 | =item LICENSE |
| 17981 | |
| 17982 | =item SEE ALSO |
| 17983 | |
| 17984 | =item AUTHORS |
| 17985 | |
| 17986 | =back |
| 17987 | |
| 17988 | =head2 Math::Complex - complex numbers and associated mathematical |
| 17989 | functions |
| 17990 | |
| 17991 | =over 4 |
| 17992 | |
| 17993 | =item SYNOPSIS |
| 17994 | |
| 17995 | =item DESCRIPTION |
| 17996 | |
| 17997 | =item OPERATIONS |
| 17998 | |
| 17999 | =item CREATION |
| 18000 | |
| 18001 | =item DISPLAYING |
| 18002 | |
| 18003 | =over 4 |
| 18004 | |
| 18005 | =item CHANGED IN PERL 5.6 |
| 18006 | |
| 18007 | =back |
| 18008 | |
| 18009 | =item USAGE |
| 18010 | |
| 18011 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO |
| 18012 | |
| 18013 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS |
| 18014 | |
| 18015 | =item BUGS |
| 18016 | |
| 18017 | =item AUTHORS |
| 18018 | |
| 18019 | =back |
| 18020 | |
| 18021 | =head2 Math::Trig - trigonometric functions |
| 18022 | |
| 18023 | =over 4 |
| 18024 | |
| 18025 | =item SYNOPSIS |
| 18026 | |
| 18027 | =item DESCRIPTION |
| 18028 | |
| 18029 | =item TRIGONOMETRIC FUNCTIONS |
| 18030 | |
| 18031 | B<tan> |
| 18032 | |
| 18033 | =over 4 |
| 18034 | |
| 18035 | =item ERRORS DUE TO DIVISION BY ZERO |
| 18036 | |
| 18037 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS |
| 18038 | |
| 18039 | =back |
| 18040 | |
| 18041 | =item PLANE ANGLE CONVERSIONS |
| 18042 | |
| 18043 | =item RADIAL COORDINATE CONVERSIONS |
| 18044 | |
| 18045 | =over 4 |
| 18046 | |
| 18047 | =item COORDINATE SYSTEMS |
| 18048 | |
| 18049 | =item 3-D ANGLE CONVERSIONS |
| 18050 | |
| 18051 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, |
| 18052 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical |
| 18053 | |
| 18054 | =back |
| 18055 | |
| 18056 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS |
| 18057 | |
| 18058 | =item EXAMPLES |
| 18059 | |
| 18060 | =over 4 |
| 18061 | |
| 18062 | =item CAVEAT FOR GREAT CIRCLE FORMULAS |
| 18063 | |
| 18064 | =back |
| 18065 | |
| 18066 | =item BUGS |
| 18067 | |
| 18068 | =item AUTHORS |
| 18069 | |
| 18070 | =back |
| 18071 | |
| 18072 | =head2 Memoize - Make functions faster by trading space for time |
| 18073 | |
| 18074 | =over 4 |
| 18075 | |
| 18076 | =item SYNOPSIS |
| 18077 | |
| 18078 | =item DESCRIPTION |
| 18079 | |
| 18080 | =item DETAILS |
| 18081 | |
| 18082 | =item OPTIONS |
| 18083 | |
| 18084 | =over 4 |
| 18085 | |
| 18086 | =item INSTALL |
| 18087 | |
| 18088 | =item NORMALIZER |
| 18089 | |
| 18090 | =item C<SCALAR_CACHE>, C<LIST_CACHE> |
| 18091 | |
| 18092 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> |
| 18093 | |
| 18094 | =back |
| 18095 | |
| 18096 | =item OTHER FACILITIES |
| 18097 | |
| 18098 | =over 4 |
| 18099 | |
| 18100 | =item C<unmemoize> |
| 18101 | |
| 18102 | =item C<flush_cache> |
| 18103 | |
| 18104 | =back |
| 18105 | |
| 18106 | =item CAVEATS |
| 18107 | |
| 18108 | =item PERSISTENT CACHE SUPPORT |
| 18109 | |
| 18110 | =item EXPIRATION SUPPORT |
| 18111 | |
| 18112 | =item BUGS |
| 18113 | |
| 18114 | =item MAILING LIST |
| 18115 | |
| 18116 | =item AUTHOR |
| 18117 | |
| 18118 | =item COPYRIGHT AND LICENSE |
| 18119 | |
| 18120 | =item THANK YOU |
| 18121 | |
| 18122 | =back |
| 18123 | |
| 18124 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for |
| 18125 | Storable use |
| 18126 | |
| 18127 | =over 4 |
| 18128 | |
| 18129 | =item DESCRIPTION |
| 18130 | |
| 18131 | =back |
| 18132 | |
| 18133 | =head2 Memoize::Expire - Plug-in module for automatic expiration of |
| 18134 | memoized values |
| 18135 | |
| 18136 | =over 4 |
| 18137 | |
| 18138 | =item SYNOPSIS |
| 18139 | |
| 18140 | =item DESCRIPTION |
| 18141 | |
| 18142 | =item INTERFACE |
| 18143 | |
| 18144 | TIEHASH, EXISTS, STORE |
| 18145 | |
| 18146 | =item ALTERNATIVES |
| 18147 | |
| 18148 | =item CAVEATS |
| 18149 | |
| 18150 | =item AUTHOR |
| 18151 | |
| 18152 | =item SEE ALSO |
| 18153 | |
| 18154 | =back |
| 18155 | |
| 18156 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics |
| 18157 | |
| 18158 | =over 4 |
| 18159 | |
| 18160 | =item DESCRIPTION |
| 18161 | |
| 18162 | =back |
| 18163 | |
| 18164 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics |
| 18165 | |
| 18166 | =over 4 |
| 18167 | |
| 18168 | =item DESCRIPTION |
| 18169 | |
| 18170 | =back |
| 18171 | |
| 18172 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for |
| 18173 | Storable use |
| 18174 | |
| 18175 | =over 4 |
| 18176 | |
| 18177 | =item DESCRIPTION |
| 18178 | |
| 18179 | =back |
| 18180 | |
| 18181 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for |
| 18182 | Storable use |
| 18183 | |
| 18184 | =over 4 |
| 18185 | |
| 18186 | =item DESCRIPTION |
| 18187 | |
| 18188 | =back |
| 18189 | |
| 18190 | =head2 Memoize::Storable - store Memoized data in Storable database |
| 18191 | |
| 18192 | =over 4 |
| 18193 | |
| 18194 | =item DESCRIPTION |
| 18195 | |
| 18196 | =back |
| 18197 | |
| 18198 | =head2 NDBM_File - Tied access to ndbm files |
| 18199 | |
| 18200 | =over 4 |
| 18201 | |
| 18202 | =item SYNOPSIS |
| 18203 | |
| 18204 | =item DESCRIPTION |
| 18205 | |
| 18206 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
| 18207 | |
| 18208 | =item DIAGNOSTICS |
| 18209 | |
| 18210 | =over 4 |
| 18211 | |
| 18212 | =item C<ndbm store returned -1, errno 22, key "..." at ...> |
| 18213 | |
| 18214 | =back |
| 18215 | |
| 18216 | =item BUGS AND WARNINGS |
| 18217 | |
| 18218 | =back |
| 18219 | |
| 18220 | =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method |
| 18221 | redispatch |
| 18222 | |
| 18223 | =over 4 |
| 18224 | |
| 18225 | =item SYNOPSIS |
| 18226 | |
| 18227 | =item DESCRIPTION |
| 18228 | |
| 18229 | =over 4 |
| 18230 | |
| 18231 | =item Enforcing redispatch |
| 18232 | |
| 18233 | =item Avoiding repetitions |
| 18234 | |
| 18235 | =item Invoking all versions of a method with a single call |
| 18236 | |
| 18237 | =item Using C<EVERY> methods |
| 18238 | |
| 18239 | =back |
| 18240 | |
| 18241 | =item AUTHOR |
| 18242 | |
| 18243 | =item BUGS AND IRRITATIONS |
| 18244 | |
| 18245 | =item COPYRIGHT |
| 18246 | |
| 18247 | =back |
| 18248 | |
| 18249 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) |
| 18250 | |
| 18251 | =over 4 |
| 18252 | |
| 18253 | =item SYNOPSIS |
| 18254 | |
| 18255 | =item DESCRIPTION |
| 18256 | |
| 18257 | =item USER METHODS |
| 18258 | |
| 18259 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), |
| 18260 | dataend () |
| 18261 | |
| 18262 | =item CLASS METHODS |
| 18263 | |
| 18264 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... |
| 18265 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), |
| 18266 | ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh () |
| 18267 | |
| 18268 | =item EXPORTS |
| 18269 | |
| 18270 | =item AUTHOR |
| 18271 | |
| 18272 | =item COPYRIGHT |
| 18273 | |
| 18274 | =back |
| 18275 | |
| 18276 | =head2 Net::Config - Local configuration data for libnet |
| 18277 | |
| 18278 | =over 4 |
| 18279 | |
| 18280 | =item SYNOPSYS |
| 18281 | |
| 18282 | =item DESCRIPTION |
| 18283 | |
| 18284 | =item METHODS |
| 18285 | |
| 18286 | requires_firewall HOST |
| 18287 | |
| 18288 | =item NetConfig VALUES |
| 18289 | |
| 18290 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, |
| 18291 | time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, |
| 18292 | ftp_int_pasive, local_netmask, test_hosts, test_exists |
| 18293 | |
| 18294 | =back |
| 18295 | |
| 18296 | =head2 Net::Domain - Attempt to evaluate the current host's internet name |
| 18297 | and domain |
| 18298 | |
| 18299 | =over 4 |
| 18300 | |
| 18301 | =item SYNOPSIS |
| 18302 | |
| 18303 | =item DESCRIPTION |
| 18304 | |
| 18305 | hostfqdn (), hostname (), hostdomain () |
| 18306 | |
| 18307 | =item AUTHOR |
| 18308 | |
| 18309 | =item COPYRIGHT |
| 18310 | |
| 18311 | =back |
| 18312 | |
| 18313 | =head2 Net::FTP - FTP Client class |
| 18314 | |
| 18315 | =over 4 |
| 18316 | |
| 18317 | =item SYNOPSIS |
| 18318 | |
| 18319 | =item DESCRIPTION |
| 18320 | |
| 18321 | =item OVERVIEW |
| 18322 | |
| 18323 | =item CONSTRUCTOR |
| 18324 | |
| 18325 | new ([ HOST ] [, OPTIONS ]) |
| 18326 | |
| 18327 | =item METHODS |
| 18328 | |
| 18329 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), |
| 18330 | site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME |
| 18331 | ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [, |
| 18332 | RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls ( |
| 18333 | [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), |
| 18334 | put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE |
| 18335 | ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), |
| 18336 | size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[ |
| 18337 | BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ), |
| 18338 | stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (), |
| 18339 | pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique ( |
| 18340 | SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ), |
| 18341 | abort (), quit () |
| 18342 | |
| 18343 | =over 4 |
| 18344 | |
| 18345 | =item Methods for the adventurous |
| 18346 | |
| 18347 | quot (CMD [,ARGS]) |
| 18348 | |
| 18349 | =back |
| 18350 | |
| 18351 | =item THE dataconn CLASS |
| 18352 | |
| 18353 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), |
| 18354 | bytes_read (), abort (), close () |
| 18355 | |
| 18356 | =item UNIMPLEMENTED |
| 18357 | |
| 18358 | B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> |
| 18359 | |
| 18360 | =item REPORTING BUGS |
| 18361 | |
| 18362 | =item AUTHOR |
| 18363 | |
| 18364 | =item SEE ALSO |
| 18365 | |
| 18366 | =item USE EXAMPLES |
| 18367 | |
| 18368 | http://www.csh.rit.edu/~adam/Progs/ |
| 18369 | |
| 18370 | =item CREDITS |
| 18371 | |
| 18372 | =item COPYRIGHT |
| 18373 | |
| 18374 | =back |
| 18375 | |
| 18376 | =head2 Net::NNTP - NNTP Client class |
| 18377 | |
| 18378 | =over 4 |
| 18379 | |
| 18380 | =item SYNOPSIS |
| 18381 | |
| 18382 | =item DESCRIPTION |
| 18383 | |
| 18384 | =item CONSTRUCTOR |
| 18385 | |
| 18386 | new ( [ HOST ] [, OPTIONS ]) |
| 18387 | |
| 18388 | =item METHODS |
| 18389 | |
| 18390 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( |
| 18391 | [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ |
| 18392 | MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] |
| 18393 | ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), |
| 18394 | postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, |
| 18395 | DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), |
| 18396 | post ( [ MESSAGE ] ), postfh (), slave (), quit () |
| 18397 | |
| 18398 | =over 4 |
| 18399 | |
| 18400 | =item Extension methods |
| 18401 | |
| 18402 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), |
| 18403 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN |
| 18404 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( |
| 18405 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ |
| 18406 | GROUP ] ), reader |
| 18407 | |
| 18408 | =back |
| 18409 | |
| 18410 | =item UNSUPPORTED |
| 18411 | |
| 18412 | =item DEFINITIONS |
| 18413 | |
| 18414 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> |
| 18415 | |
| 18416 | =item SEE ALSO |
| 18417 | |
| 18418 | =item AUTHOR |
| 18419 | |
| 18420 | =item COPYRIGHT |
| 18421 | |
| 18422 | =back |
| 18423 | |
| 18424 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) |
| 18425 | |
| 18426 | =over 4 |
| 18427 | |
| 18428 | =item SYNOPSIS |
| 18429 | |
| 18430 | =item DESCRIPTION |
| 18431 | |
| 18432 | =item CONSTRUCTOR |
| 18433 | |
| 18434 | new ( [ HOST ] [, OPTIONS ] 0 |
| 18435 | |
| 18436 | =item METHODS |
| 18437 | |
| 18438 | auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER |
| 18439 | [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities |
| 18440 | (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ] |
| 18441 | ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] |
| 18442 | ), delete ( MSGNUM ), reset (), quit () |
| 18443 | |
| 18444 | =item NOTES |
| 18445 | |
| 18446 | =item SEE ALSO |
| 18447 | |
| 18448 | =item AUTHOR |
| 18449 | |
| 18450 | =item COPYRIGHT |
| 18451 | |
| 18452 | =back |
| 18453 | |
| 18454 | =head2 Net::Ping - check a remote host for reachability |
| 18455 | |
| 18456 | =over 4 |
| 18457 | |
| 18458 | =item SYNOPSIS |
| 18459 | |
| 18460 | =item DESCRIPTION |
| 18461 | |
| 18462 | =over 4 |
| 18463 | |
| 18464 | =item Functions |
| 18465 | |
| 18466 | Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos |
| 18467 | ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );, |
| 18468 | $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );, |
| 18469 | $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( |
| 18470 | [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host |
| 18471 | [, $timeout]); |
| 18472 | |
| 18473 | =back |
| 18474 | |
| 18475 | =item NOTES |
| 18476 | |
| 18477 | =item INSTALL |
| 18478 | |
| 18479 | =item BUGS |
| 18480 | |
| 18481 | =item AUTHORS |
| 18482 | |
| 18483 | =item COPYRIGHT |
| 18484 | |
| 18485 | =back |
| 18486 | |
| 18487 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client |
| 18488 | |
| 18489 | =over 4 |
| 18490 | |
| 18491 | =item SYNOPSIS |
| 18492 | |
| 18493 | =item DESCRIPTION |
| 18494 | |
| 18495 | =item EXAMPLES |
| 18496 | |
| 18497 | =item CONSTRUCTOR |
| 18498 | |
| 18499 | new ( [ HOST ] [, OPTIONS ] ) |
| 18500 | |
| 18501 | =item METHODS |
| 18502 | |
| 18503 | banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth ( |
| 18504 | USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), |
| 18505 | send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( |
| 18506 | ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] |
| 18507 | ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), |
| 18508 | data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ |
| 18509 | $subject ] ), quit () |
| 18510 | |
| 18511 | =item ADDRESSES |
| 18512 | |
| 18513 | =item SEE ALSO |
| 18514 | |
| 18515 | =item AUTHOR |
| 18516 | |
| 18517 | =item COPYRIGHT |
| 18518 | |
| 18519 | =back |
| 18520 | |
| 18521 | =head2 Net::Time - time and daytime network client interface |
| 18522 | |
| 18523 | =over 4 |
| 18524 | |
| 18525 | =item SYNOPSIS |
| 18526 | |
| 18527 | =item DESCRIPTION |
| 18528 | |
| 18529 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, |
| 18530 | PROTOCOL [, TIMEOUT]]]) |
| 18531 | |
| 18532 | =item AUTHOR |
| 18533 | |
| 18534 | =item COPYRIGHT |
| 18535 | |
| 18536 | =back |
| 18537 | |
| 18538 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
| 18539 | functions |
| 18540 | |
| 18541 | =over 4 |
| 18542 | |
| 18543 | =item SYNOPSIS |
| 18544 | |
| 18545 | =item DESCRIPTION |
| 18546 | |
| 18547 | =item EXAMPLES |
| 18548 | |
| 18549 | =item NOTE |
| 18550 | |
| 18551 | =item AUTHOR |
| 18552 | |
| 18553 | =back |
| 18554 | |
| 18555 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions |
| 18556 | |
| 18557 | =over 4 |
| 18558 | |
| 18559 | =item DESCRIPTION |
| 18560 | |
| 18561 | =over 4 |
| 18562 | |
| 18563 | =item Where to get this document |
| 18564 | |
| 18565 | =item How to contribute to this document |
| 18566 | |
| 18567 | =back |
| 18568 | |
| 18569 | =item Author and Copyright Information |
| 18570 | |
| 18571 | =over 4 |
| 18572 | |
| 18573 | =item Disclaimer |
| 18574 | |
| 18575 | =back |
| 18576 | |
| 18577 | =item Obtaining and installing libnet |
| 18578 | |
| 18579 | =over 4 |
| 18580 | |
| 18581 | =item What is libnet ? |
| 18582 | |
| 18583 | =item Which version of perl do I need ? |
| 18584 | |
| 18585 | =item What other modules do I need ? |
| 18586 | |
| 18587 | =item What machines support libnet ? |
| 18588 | |
| 18589 | =item Where can I get the latest libnet release |
| 18590 | |
| 18591 | =back |
| 18592 | |
| 18593 | =item Using Net::FTP |
| 18594 | |
| 18595 | =over 4 |
| 18596 | |
| 18597 | =item How do I download files from an FTP server ? |
| 18598 | |
| 18599 | =item How do I transfer files in binary mode ? |
| 18600 | |
| 18601 | =item How can I get the size of a file on a remote FTP server ? |
| 18602 | |
| 18603 | =item How can I get the modification time of a file on a remote FTP server |
| 18604 | ? |
| 18605 | |
| 18606 | =item How can I change the permissions of a file on a remote server ? |
| 18607 | |
| 18608 | =item Can I do a reget operation like the ftp command ? |
| 18609 | |
| 18610 | =item How do I get a directory listing from an FTP server ? |
| 18611 | |
| 18612 | =item Changing directory to "" does not fail ? |
| 18613 | |
| 18614 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? |
| 18615 | |
| 18616 | =item I am behind an FTP proxy firewall, but cannot access machines outside |
| 18617 | ? |
| 18618 | |
| 18619 | =item My ftp proxy firewall does not listen on port 21 |
| 18620 | |
| 18621 | =item Is it possible to change the file permissions of a file on an FTP |
| 18622 | server ? |
| 18623 | |
| 18624 | =item I have seen scripts call a method message, but cannot find it |
| 18625 | documented ? |
| 18626 | |
| 18627 | =item Why does Net::FTP not implement mput and mget methods |
| 18628 | |
| 18629 | =back |
| 18630 | |
| 18631 | =item Using Net::SMTP |
| 18632 | |
| 18633 | =over 4 |
| 18634 | |
| 18635 | =item Why can't the part of an Email address after the @ be used as the |
| 18636 | hostname ? |
| 18637 | |
| 18638 | =item Why does Net::SMTP not do DNS MX lookups ? |
| 18639 | |
| 18640 | =item The verify method always returns true ? |
| 18641 | |
| 18642 | =back |
| 18643 | |
| 18644 | =item Debugging scripts |
| 18645 | |
| 18646 | =over 4 |
| 18647 | |
| 18648 | =item How can I debug my scripts that use Net::* modules ? |
| 18649 | |
| 18650 | =back |
| 18651 | |
| 18652 | =item AUTHOR AND COPYRIGHT |
| 18653 | |
| 18654 | =back |
| 18655 | |
| 18656 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
| 18657 | functions |
| 18658 | |
| 18659 | =over 4 |
| 18660 | |
| 18661 | =item SYNOPSIS |
| 18662 | |
| 18663 | =item DESCRIPTION |
| 18664 | |
| 18665 | =item EXAMPLES |
| 18666 | |
| 18667 | =item NOTE |
| 18668 | |
| 18669 | =item AUTHOR |
| 18670 | |
| 18671 | =back |
| 18672 | |
| 18673 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
| 18674 | functions |
| 18675 | |
| 18676 | =over 4 |
| 18677 | |
| 18678 | =item SYNOPSIS |
| 18679 | |
| 18680 | =item DESCRIPTION |
| 18681 | |
| 18682 | =item NOTE |
| 18683 | |
| 18684 | =item AUTHOR |
| 18685 | |
| 18686 | =back |
| 18687 | |
| 18688 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
| 18689 | functions |
| 18690 | |
| 18691 | =over 4 |
| 18692 | |
| 18693 | =item SYNOPSIS |
| 18694 | |
| 18695 | =item DESCRIPTION |
| 18696 | |
| 18697 | =item EXAMPLES |
| 18698 | |
| 18699 | =item NOTE |
| 18700 | |
| 18701 | =item AUTHOR |
| 18702 | |
| 18703 | =back |
| 18704 | |
| 18705 | =head2 Netrc, Net::Netrc - OO interface to users netrc file |
| 18706 | |
| 18707 | =over 4 |
| 18708 | |
| 18709 | =item SYNOPSIS |
| 18710 | |
| 18711 | =item DESCRIPTION |
| 18712 | |
| 18713 | =item THE .netrc FILE |
| 18714 | |
| 18715 | machine name, default, login name, password string, account string, macdef |
| 18716 | name |
| 18717 | |
| 18718 | =item CONSTRUCTOR |
| 18719 | |
| 18720 | lookup ( MACHINE [, LOGIN ]) |
| 18721 | |
| 18722 | =item METHODS |
| 18723 | |
| 18724 | login (), password (), account (), lpa () |
| 18725 | |
| 18726 | =item AUTHOR |
| 18727 | |
| 18728 | =item SEE ALSO |
| 18729 | |
| 18730 | =item COPYRIGHT |
| 18731 | |
| 18732 | =back |
| 18733 | |
| 18734 | =head2 O - Generic interface to Perl Compiler backends |
| 18735 | |
| 18736 | =over 4 |
| 18737 | |
| 18738 | =item SYNOPSIS |
| 18739 | |
| 18740 | =item DESCRIPTION |
| 18741 | |
| 18742 | =item CONVENTIONS |
| 18743 | |
| 18744 | =item IMPLEMENTATION |
| 18745 | |
| 18746 | =item BUGS |
| 18747 | |
| 18748 | =item AUTHOR |
| 18749 | |
| 18750 | =back |
| 18751 | |
| 18752 | =head2 ODBM_File - Tied access to odbm files |
| 18753 | |
| 18754 | =over 4 |
| 18755 | |
| 18756 | =item SYNOPSIS |
| 18757 | |
| 18758 | =item DESCRIPTION |
| 18759 | |
| 18760 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
| 18761 | |
| 18762 | =item DIAGNOSTICS |
| 18763 | |
| 18764 | =over 4 |
| 18765 | |
| 18766 | =item C<odbm store returned -1, errno 22, key "..." at ...> |
| 18767 | |
| 18768 | =back |
| 18769 | |
| 18770 | =item BUGS AND WARNINGS |
| 18771 | |
| 18772 | =back |
| 18773 | |
| 18774 | =head2 Opcode - Disable named opcodes when compiling perl code |
| 18775 | |
| 18776 | =over 4 |
| 18777 | |
| 18778 | =item SYNOPSIS |
| 18779 | |
| 18780 | =item DESCRIPTION |
| 18781 | |
| 18782 | =item NOTE |
| 18783 | |
| 18784 | =item WARNING |
| 18785 | |
| 18786 | =item Operator Names and Operator Lists |
| 18787 | |
| 18788 | an operator name (opname), an operator tag name (optag), a negated opname |
| 18789 | or optag, an operator set (opset) |
| 18790 | |
| 18791 | =item Opcode Functions |
| 18792 | |
| 18793 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
| 18794 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), |
| 18795 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), |
| 18796 | opdump (PAT) |
| 18797 | |
| 18798 | =item Manipulating Opsets |
| 18799 | |
| 18800 | =item TO DO (maybe) |
| 18801 | |
| 18802 | =back |
| 18803 | |
| 18804 | =over 4 |
| 18805 | |
| 18806 | =item Predefined Opcode Tags |
| 18807 | |
| 18808 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
| 18809 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
| 18810 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, |
| 18811 | :dangerous |
| 18812 | |
| 18813 | =item SEE ALSO |
| 18814 | |
| 18815 | =item AUTHORS |
| 18816 | |
| 18817 | =back |
| 18818 | |
| 18819 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
| 18820 | compartments |
| 18821 | |
| 18822 | =over 4 |
| 18823 | |
| 18824 | =item SYNOPSIS |
| 18825 | |
| 18826 | =item DESCRIPTION |
| 18827 | |
| 18828 | a new namespace, an operator mask |
| 18829 | |
| 18830 | =item WARNING |
| 18831 | |
| 18832 | =over 4 |
| 18833 | |
| 18834 | =item RECENT CHANGES |
| 18835 | |
| 18836 | =item Methods in class Safe |
| 18837 | |
| 18838 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
| 18839 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from |
| 18840 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), |
| 18841 | root (NAMESPACE), mask (MASK) |
| 18842 | |
| 18843 | =item Some Safety Issues |
| 18844 | |
| 18845 | Memory, CPU, Snooping, Signals, State Changes |
| 18846 | |
| 18847 | =item AUTHOR |
| 18848 | |
| 18849 | =back |
| 18850 | |
| 18851 | =back |
| 18852 | |
| 18853 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
| 18854 | compiling |
| 18855 | |
| 18856 | =over 4 |
| 18857 | |
| 18858 | =item SYNOPSIS |
| 18859 | |
| 18860 | =item DESCRIPTION |
| 18861 | |
| 18862 | =item SEE ALSO |
| 18863 | |
| 18864 | =back |
| 18865 | |
| 18866 | =head2 POSIX - Perl interface to IEEE Std 1003.1 |
| 18867 | |
| 18868 | =over 4 |
| 18869 | |
| 18870 | =item SYNOPSIS |
| 18871 | |
| 18872 | =item DESCRIPTION |
| 18873 | |
| 18874 | =item NOTE |
| 18875 | |
| 18876 | =item CAVEATS |
| 18877 | |
| 18878 | =item FUNCTIONS |
| 18879 | |
| 18880 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
| 18881 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, |
| 18882 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, |
| 18883 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, |
| 18884 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, |
| 18885 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, |
| 18886 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, |
| 18887 | fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, |
| 18888 | geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, |
| 18889 | getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, |
| 18890 | isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, |
| 18891 | isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, |
| 18892 | log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, |
| 18893 | memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, |
| 18894 | offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, |
| 18895 | putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, |
| 18896 | rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, |
| 18897 | setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, |
| 18898 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, |
| 18899 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, |
| 18900 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, |
| 18901 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, |
| 18902 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, |
| 18903 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, |
| 18904 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, |
| 18905 | wctomb, write |
| 18906 | |
| 18907 | =item CLASSES |
| 18908 | |
| 18909 | =over 4 |
| 18910 | |
| 18911 | =item POSIX::SigAction |
| 18912 | |
| 18913 | new, handler, mask, flags, safe |
| 18914 | |
| 18915 | =item POSIX::SigSet |
| 18916 | |
| 18917 | new, addset, delset, emptyset, fillset, ismember |
| 18918 | |
| 18919 | =item POSIX::Termios |
| 18920 | |
| 18921 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
| 18922 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, |
| 18923 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc |
| 18924 | field values, c_cflag field values, c_iflag field values, c_lflag field |
| 18925 | values, c_oflag field values |
| 18926 | |
| 18927 | =back |
| 18928 | |
| 18929 | =item PATHNAME CONSTANTS |
| 18930 | |
| 18931 | Constants |
| 18932 | |
| 18933 | =item POSIX CONSTANTS |
| 18934 | |
| 18935 | Constants |
| 18936 | |
| 18937 | =item SYSTEM CONFIGURATION |
| 18938 | |
| 18939 | Constants |
| 18940 | |
| 18941 | =item ERRNO |
| 18942 | |
| 18943 | Constants |
| 18944 | |
| 18945 | =item FCNTL |
| 18946 | |
| 18947 | Constants |
| 18948 | |
| 18949 | =item FLOAT |
| 18950 | |
| 18951 | Constants |
| 18952 | |
| 18953 | =item LIMITS |
| 18954 | |
| 18955 | Constants |
| 18956 | |
| 18957 | =item LOCALE |
| 18958 | |
| 18959 | Constants |
| 18960 | |
| 18961 | =item MATH |
| 18962 | |
| 18963 | Constants |
| 18964 | |
| 18965 | =item SIGNAL |
| 18966 | |
| 18967 | Constants |
| 18968 | |
| 18969 | =item STAT |
| 18970 | |
| 18971 | Constants, Macros |
| 18972 | |
| 18973 | =item STDLIB |
| 18974 | |
| 18975 | Constants |
| 18976 | |
| 18977 | =item STDIO |
| 18978 | |
| 18979 | Constants |
| 18980 | |
| 18981 | =item TIME |
| 18982 | |
| 18983 | Constants |
| 18984 | |
| 18985 | =item UNISTD |
| 18986 | |
| 18987 | Constants |
| 18988 | |
| 18989 | =item WAIT |
| 18990 | |
| 18991 | Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, |
| 18992 | WTERMSIG, WIFSTOPPED, WSTOPSIG |
| 18993 | |
| 18994 | =back |
| 18995 | |
| 18996 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* |
| 18997 | name space |
| 18998 | |
| 18999 | =over 4 |
| 19000 | |
| 19001 | =item SYNOPSIS |
| 19002 | |
| 19003 | =item DESCRIPTION |
| 19004 | |
| 19005 | :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32 |
| 19006 | |
| 19007 | =over 4 |
| 19008 | |
| 19009 | =item Custom Layers |
| 19010 | |
| 19011 | :encoding, :via |
| 19012 | |
| 19013 | =item Alternatives to raw |
| 19014 | |
| 19015 | =item Defaults and how to override them |
| 19016 | |
| 19017 | =item Querying the layers of filehandles |
| 19018 | |
| 19019 | =back |
| 19020 | |
| 19021 | =item AUTHOR |
| 19022 | |
| 19023 | =item SEE ALSO |
| 19024 | |
| 19025 | =back |
| 19026 | |
| 19027 | =head2 PerlIO::encoding - encoding layer |
| 19028 | |
| 19029 | =over 4 |
| 19030 | |
| 19031 | =item SYNOPSIS |
| 19032 | |
| 19033 | =item DESCRIPTION |
| 19034 | |
| 19035 | =item SEE ALSO |
| 19036 | |
| 19037 | =back |
| 19038 | |
| 19039 | =head2 PerlIO::scalar - in-memory IO, scalar IO |
| 19040 | |
| 19041 | =over 4 |
| 19042 | |
| 19043 | =item SYNOPSIS |
| 19044 | |
| 19045 | =item DESCRIPTION |
| 19046 | |
| 19047 | =item IMPLEMENTATION NOTE |
| 19048 | |
| 19049 | =back |
| 19050 | |
| 19051 | =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl |
| 19052 | |
| 19053 | =over 4 |
| 19054 | |
| 19055 | =item SYNOPSIS |
| 19056 | |
| 19057 | =item DESCRIPTION |
| 19058 | |
| 19059 | =item EXPECTED METHODS |
| 19060 | |
| 19061 | $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), |
| 19062 | $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]), |
| 19063 | $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]), |
| 19064 | $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh), |
| 19065 | $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), |
| 19066 | $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), |
| 19067 | $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), |
| 19068 | $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) |
| 19069 | |
| 19070 | =item EXAMPLES |
| 19071 | |
| 19072 | =over 4 |
| 19073 | |
| 19074 | =item Example - a Hexadecimal Handle |
| 19075 | |
| 19076 | =back |
| 19077 | |
| 19078 | =back |
| 19079 | |
| 19080 | =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings |
| 19081 | |
| 19082 | =over 4 |
| 19083 | |
| 19084 | =item SYNOPSIS |
| 19085 | |
| 19086 | =item DESCRIPTION |
| 19087 | |
| 19088 | =item REQUIRED MODULES |
| 19089 | |
| 19090 | =item SEE ALSO |
| 19091 | |
| 19092 | =item ACKNOWLEDGEMENTS |
| 19093 | |
| 19094 | =item COPYRIGHT |
| 19095 | |
| 19096 | =back |
| 19097 | |
| 19098 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
| 19099 | |
| 19100 | =over 4 |
| 19101 | |
| 19102 | =item SYNOPSIS |
| 19103 | |
| 19104 | =item OPTIONS/ARGUMENTS |
| 19105 | |
| 19106 | =over 4 |
| 19107 | |
| 19108 | =item podchecker() |
| 19109 | |
| 19110 | B<-warnings> =E<gt> I<val> |
| 19111 | |
| 19112 | =back |
| 19113 | |
| 19114 | =item DESCRIPTION |
| 19115 | |
| 19116 | =item DIAGNOSTICS |
| 19117 | |
| 19118 | =over 4 |
| 19119 | |
| 19120 | =item Errors |
| 19121 | |
| 19122 | empty =headn, =over on line I<N> without closing =back, =item without |
| 19123 | previous =over, =back without previous =over, No argument for =begin, =end |
| 19124 | without =begin, Nested =begin's, =for without formatter specification, |
| 19125 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown |
| 19126 | interior-sequence "I<SEQ>", nested commands |
| 19127 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity |
| 19128 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, |
| 19129 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) |
| 19130 | after =back |
| 19131 | |
| 19132 | =item Warnings |
| 19133 | |
| 19134 | multiple occurrence of link target I<name>, line containing nothing but |
| 19135 | whitespace in paragraph, file does not start with =head, previous =item has |
| 19136 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> |
| 19137 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No |
| 19138 | items in =over, No argument for =item, empty section in previous paragraph, |
| 19139 | Verbatim paragraph in NAME section, =headI<n> without preceding higher |
| 19140 | level |
| 19141 | |
| 19142 | =item Hyperlinks |
| 19143 | |
| 19144 | ignoring leading/trailing whitespace in link, (section) in '$page' |
| 19145 | deprecated, alternative text/node '%s' contains non-escaped | or / |
| 19146 | |
| 19147 | =back |
| 19148 | |
| 19149 | =item RETURN VALUE |
| 19150 | |
| 19151 | =item EXAMPLES |
| 19152 | |
| 19153 | =item INTERFACE |
| 19154 | |
| 19155 | =back |
| 19156 | |
| 19157 | C<Pod::Checker-E<gt>new( %options )> |
| 19158 | |
| 19159 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, |
| 19160 | @args )> |
| 19161 | |
| 19162 | C<$checker-E<gt>num_errors()> |
| 19163 | |
| 19164 | C<$checker-E<gt>num_warnings()> |
| 19165 | |
| 19166 | C<$checker-E<gt>name()> |
| 19167 | |
| 19168 | C<$checker-E<gt>node()> |
| 19169 | |
| 19170 | C<$checker-E<gt>idx()> |
| 19171 | |
| 19172 | C<$checker-E<gt>hyperlink()> |
| 19173 | |
| 19174 | =over 4 |
| 19175 | |
| 19176 | =item AUTHOR |
| 19177 | |
| 19178 | =back |
| 19179 | |
| 19180 | =head2 Pod::Find - find POD documents in directory trees |
| 19181 | |
| 19182 | =over 4 |
| 19183 | |
| 19184 | =item SYNOPSIS |
| 19185 | |
| 19186 | =item DESCRIPTION |
| 19187 | |
| 19188 | =back |
| 19189 | |
| 19190 | =over 4 |
| 19191 | |
| 19192 | =item C<pod_find( { %opts } , @directories )> |
| 19193 | |
| 19194 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> |
| 19195 | 1> |
| 19196 | |
| 19197 | =back |
| 19198 | |
| 19199 | =over 4 |
| 19200 | |
| 19201 | =item C<simplify_name( $str )> |
| 19202 | |
| 19203 | =back |
| 19204 | |
| 19205 | =over 4 |
| 19206 | |
| 19207 | =item C<pod_where( { %opts }, $pod )> |
| 19208 | |
| 19209 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> |
| 19210 | 1> |
| 19211 | |
| 19212 | =back |
| 19213 | |
| 19214 | =over 4 |
| 19215 | |
| 19216 | =item C<contains_pod( $file , $verbose )> |
| 19217 | |
| 19218 | =back |
| 19219 | |
| 19220 | =over 4 |
| 19221 | |
| 19222 | =item AUTHOR |
| 19223 | |
| 19224 | =item SEE ALSO |
| 19225 | |
| 19226 | =back |
| 19227 | |
| 19228 | =head2 Pod::Html - module to convert pod files to HTML |
| 19229 | |
| 19230 | =over 4 |
| 19231 | |
| 19232 | =item SYNOPSIS |
| 19233 | |
| 19234 | =item DESCRIPTION |
| 19235 | |
| 19236 | =item ARGUMENTS |
| 19237 | |
| 19238 | backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, |
| 19239 | htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, |
| 19240 | quiet, recurse, title, verbose |
| 19241 | |
| 19242 | =item EXAMPLE |
| 19243 | |
| 19244 | =item ENVIRONMENT |
| 19245 | |
| 19246 | =item AUTHOR |
| 19247 | |
| 19248 | =item SEE ALSO |
| 19249 | |
| 19250 | =item COPYRIGHT |
| 19251 | |
| 19252 | =back |
| 19253 | |
| 19254 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
| 19255 | commands, etc. |
| 19256 | |
| 19257 | =over 4 |
| 19258 | |
| 19259 | =item SYNOPSIS |
| 19260 | |
| 19261 | =item REQUIRES |
| 19262 | |
| 19263 | =item EXPORTS |
| 19264 | |
| 19265 | =item DESCRIPTION |
| 19266 | |
| 19267 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package |
| 19268 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> |
| 19269 | |
| 19270 | =back |
| 19271 | |
| 19272 | =over 4 |
| 19273 | |
| 19274 | =item B<Pod::InputSource> |
| 19275 | |
| 19276 | =back |
| 19277 | |
| 19278 | =over 4 |
| 19279 | |
| 19280 | =item B<new()> |
| 19281 | |
| 19282 | =back |
| 19283 | |
| 19284 | =over 4 |
| 19285 | |
| 19286 | =item B<name()> |
| 19287 | |
| 19288 | =back |
| 19289 | |
| 19290 | =over 4 |
| 19291 | |
| 19292 | =item B<handle()> |
| 19293 | |
| 19294 | =back |
| 19295 | |
| 19296 | =over 4 |
| 19297 | |
| 19298 | =item B<was_cutting()> |
| 19299 | |
| 19300 | =back |
| 19301 | |
| 19302 | =over 4 |
| 19303 | |
| 19304 | =item B<Pod::Paragraph> |
| 19305 | |
| 19306 | =back |
| 19307 | |
| 19308 | =over 4 |
| 19309 | |
| 19310 | =item Pod::Paragraph-E<gt>B<new()> |
| 19311 | |
| 19312 | =back |
| 19313 | |
| 19314 | =over 4 |
| 19315 | |
| 19316 | =item $pod_para-E<gt>B<cmd_name()> |
| 19317 | |
| 19318 | =back |
| 19319 | |
| 19320 | =over 4 |
| 19321 | |
| 19322 | =item $pod_para-E<gt>B<text()> |
| 19323 | |
| 19324 | =back |
| 19325 | |
| 19326 | =over 4 |
| 19327 | |
| 19328 | =item $pod_para-E<gt>B<raw_text()> |
| 19329 | |
| 19330 | =back |
| 19331 | |
| 19332 | =over 4 |
| 19333 | |
| 19334 | =item $pod_para-E<gt>B<cmd_prefix()> |
| 19335 | |
| 19336 | =back |
| 19337 | |
| 19338 | =over 4 |
| 19339 | |
| 19340 | =item $pod_para-E<gt>B<cmd_separator()> |
| 19341 | |
| 19342 | =back |
| 19343 | |
| 19344 | =over 4 |
| 19345 | |
| 19346 | =item $pod_para-E<gt>B<parse_tree()> |
| 19347 | |
| 19348 | =back |
| 19349 | |
| 19350 | =over 4 |
| 19351 | |
| 19352 | =item $pod_para-E<gt>B<file_line()> |
| 19353 | |
| 19354 | =back |
| 19355 | |
| 19356 | =over 4 |
| 19357 | |
| 19358 | =item B<Pod::InteriorSequence> |
| 19359 | |
| 19360 | =back |
| 19361 | |
| 19362 | =over 4 |
| 19363 | |
| 19364 | =item Pod::InteriorSequence-E<gt>B<new()> |
| 19365 | |
| 19366 | =back |
| 19367 | |
| 19368 | =over 4 |
| 19369 | |
| 19370 | =item $pod_seq-E<gt>B<cmd_name()> |
| 19371 | |
| 19372 | =back |
| 19373 | |
| 19374 | =over 4 |
| 19375 | |
| 19376 | =item $pod_seq-E<gt>B<prepend()> |
| 19377 | |
| 19378 | =back |
| 19379 | |
| 19380 | =over 4 |
| 19381 | |
| 19382 | =item $pod_seq-E<gt>B<append()> |
| 19383 | |
| 19384 | =back |
| 19385 | |
| 19386 | =over 4 |
| 19387 | |
| 19388 | =item $pod_seq-E<gt>B<nested()> |
| 19389 | |
| 19390 | =back |
| 19391 | |
| 19392 | =over 4 |
| 19393 | |
| 19394 | =item $pod_seq-E<gt>B<raw_text()> |
| 19395 | |
| 19396 | =back |
| 19397 | |
| 19398 | =over 4 |
| 19399 | |
| 19400 | =item $pod_seq-E<gt>B<left_delimiter()> |
| 19401 | |
| 19402 | =back |
| 19403 | |
| 19404 | =over 4 |
| 19405 | |
| 19406 | =item $pod_seq-E<gt>B<right_delimiter()> |
| 19407 | |
| 19408 | =back |
| 19409 | |
| 19410 | =over 4 |
| 19411 | |
| 19412 | =item $pod_seq-E<gt>B<parse_tree()> |
| 19413 | |
| 19414 | =back |
| 19415 | |
| 19416 | =over 4 |
| 19417 | |
| 19418 | =item $pod_seq-E<gt>B<file_line()> |
| 19419 | |
| 19420 | =back |
| 19421 | |
| 19422 | =over 4 |
| 19423 | |
| 19424 | =item Pod::InteriorSequence::B<DESTROY()> |
| 19425 | |
| 19426 | =back |
| 19427 | |
| 19428 | =over 4 |
| 19429 | |
| 19430 | =item B<Pod::ParseTree> |
| 19431 | |
| 19432 | =back |
| 19433 | |
| 19434 | =over 4 |
| 19435 | |
| 19436 | =item Pod::ParseTree-E<gt>B<new()> |
| 19437 | |
| 19438 | =back |
| 19439 | |
| 19440 | =over 4 |
| 19441 | |
| 19442 | =item $ptree-E<gt>B<top()> |
| 19443 | |
| 19444 | =back |
| 19445 | |
| 19446 | =over 4 |
| 19447 | |
| 19448 | =item $ptree-E<gt>B<children()> |
| 19449 | |
| 19450 | =back |
| 19451 | |
| 19452 | =over 4 |
| 19453 | |
| 19454 | =item $ptree-E<gt>B<prepend()> |
| 19455 | |
| 19456 | =back |
| 19457 | |
| 19458 | =over 4 |
| 19459 | |
| 19460 | =item $ptree-E<gt>B<append()> |
| 19461 | |
| 19462 | =back |
| 19463 | |
| 19464 | =over 4 |
| 19465 | |
| 19466 | =item $ptree-E<gt>B<raw_text()> |
| 19467 | |
| 19468 | =back |
| 19469 | |
| 19470 | =over 4 |
| 19471 | |
| 19472 | =item Pod::ParseTree::B<DESTROY()> |
| 19473 | |
| 19474 | =back |
| 19475 | |
| 19476 | =over 4 |
| 19477 | |
| 19478 | =item SEE ALSO |
| 19479 | |
| 19480 | =item AUTHOR |
| 19481 | |
| 19482 | =back |
| 19483 | |
| 19484 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex |
| 19485 | |
| 19486 | =over 4 |
| 19487 | |
| 19488 | =item SYNOPSIS |
| 19489 | |
| 19490 | =item DESCRIPTION |
| 19491 | |
| 19492 | =back |
| 19493 | |
| 19494 | =over 4 |
| 19495 | |
| 19496 | =item OBJECT METHODS |
| 19497 | |
| 19498 | C<initialize> |
| 19499 | |
| 19500 | =back |
| 19501 | |
| 19502 | =over 4 |
| 19503 | |
| 19504 | =item Data Accessors |
| 19505 | |
| 19506 | B<AddPreamble> |
| 19507 | |
| 19508 | =back |
| 19509 | |
| 19510 | B<AddPostamble> |
| 19511 | |
| 19512 | B<Head1Level> |
| 19513 | |
| 19514 | B<Label> |
| 19515 | |
| 19516 | B<LevelNoNum> |
| 19517 | |
| 19518 | B<MakeIndex> |
| 19519 | |
| 19520 | B<ReplaceNAMEwithSection> |
| 19521 | |
| 19522 | B<StartWithNewPage> |
| 19523 | |
| 19524 | B<TableOfContents> |
| 19525 | |
| 19526 | B<UniqueLabels> |
| 19527 | |
| 19528 | B<UserPreamble> |
| 19529 | |
| 19530 | B<UserPostamble> |
| 19531 | |
| 19532 | B<Lists> |
| 19533 | |
| 19534 | =over 4 |
| 19535 | |
| 19536 | =item Subclassed methods |
| 19537 | |
| 19538 | =back |
| 19539 | |
| 19540 | B<begin_pod> |
| 19541 | |
| 19542 | B<end_pod> |
| 19543 | |
| 19544 | B<command> |
| 19545 | |
| 19546 | B<verbatim> |
| 19547 | |
| 19548 | B<textblock> |
| 19549 | |
| 19550 | B<interior_sequence> |
| 19551 | |
| 19552 | =over 4 |
| 19553 | |
| 19554 | =item List Methods |
| 19555 | |
| 19556 | B<begin_list> |
| 19557 | |
| 19558 | =back |
| 19559 | |
| 19560 | B<end_list> |
| 19561 | |
| 19562 | B<add_item> |
| 19563 | |
| 19564 | =over 4 |
| 19565 | |
| 19566 | =item Methods for headings |
| 19567 | |
| 19568 | B<head> |
| 19569 | |
| 19570 | =back |
| 19571 | |
| 19572 | =over 4 |
| 19573 | |
| 19574 | =item Internal methods |
| 19575 | |
| 19576 | B<_output> |
| 19577 | |
| 19578 | =back |
| 19579 | |
| 19580 | B<_replace_special_chars> |
| 19581 | |
| 19582 | B<_replace_special_chars_late> |
| 19583 | |
| 19584 | B<_create_label> |
| 19585 | |
| 19586 | B<_create_index> |
| 19587 | |
| 19588 | B<_clean_latex_commands> |
| 19589 | |
| 19590 | B<_split_delimited> |
| 19591 | |
| 19592 | =over 4 |
| 19593 | |
| 19594 | =item NOTES |
| 19595 | |
| 19596 | =item SEE ALSO |
| 19597 | |
| 19598 | =item AUTHORS |
| 19599 | |
| 19600 | =item COPYRIGHT |
| 19601 | |
| 19602 | =item REVISION |
| 19603 | |
| 19604 | =back |
| 19605 | |
| 19606 | =head2 Pod::Man - Convert POD data to formatted *roff input |
| 19607 | |
| 19608 | =over 4 |
| 19609 | |
| 19610 | =item SYNOPSIS |
| 19611 | |
| 19612 | =item DESCRIPTION |
| 19613 | |
| 19614 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, |
| 19615 | release, section |
| 19616 | |
| 19617 | =item DIAGNOSTICS |
| 19618 | |
| 19619 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote |
| 19620 | specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown |
| 19621 | escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched |
| 19622 | =back |
| 19623 | |
| 19624 | =item BUGS |
| 19625 | |
| 19626 | =item CAVEATS |
| 19627 | |
| 19628 | =item SEE ALSO |
| 19629 | |
| 19630 | =item AUTHOR |
| 19631 | |
| 19632 | =item COPYRIGHT AND LICENSE |
| 19633 | |
| 19634 | =back |
| 19635 | |
| 19636 | =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text |
| 19637 | |
| 19638 | =over 4 |
| 19639 | |
| 19640 | =item SYNOPSIS |
| 19641 | |
| 19642 | =item DESCRIPTION |
| 19643 | |
| 19644 | =item SEE ALSO |
| 19645 | |
| 19646 | =item AUTHOR |
| 19647 | |
| 19648 | =item COPYRIGHT AND LICENSE |
| 19649 | |
| 19650 | =back |
| 19651 | |
| 19652 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion |
| 19653 | |
| 19654 | =over 4 |
| 19655 | |
| 19656 | =item SYNOPSIS |
| 19657 | |
| 19658 | =item DESCRIPTION |
| 19659 | |
| 19660 | =back |
| 19661 | |
| 19662 | =over 4 |
| 19663 | |
| 19664 | =item Pod::List |
| 19665 | |
| 19666 | Pod::List-E<gt>new() |
| 19667 | |
| 19668 | =back |
| 19669 | |
| 19670 | $list-E<gt>file() |
| 19671 | |
| 19672 | $list-E<gt>start() |
| 19673 | |
| 19674 | $list-E<gt>indent() |
| 19675 | |
| 19676 | $list-E<gt>type() |
| 19677 | |
| 19678 | $list-E<gt>rx() |
| 19679 | |
| 19680 | $list-E<gt>item() |
| 19681 | |
| 19682 | $list-E<gt>parent() |
| 19683 | |
| 19684 | $list-E<gt>tag() |
| 19685 | |
| 19686 | =over 4 |
| 19687 | |
| 19688 | =item Pod::Hyperlink |
| 19689 | |
| 19690 | Pod::Hyperlink-E<gt>new() |
| 19691 | |
| 19692 | =back |
| 19693 | |
| 19694 | $link-E<gt>parse($string) |
| 19695 | |
| 19696 | $link-E<gt>markup($string) |
| 19697 | |
| 19698 | $link-E<gt>text() |
| 19699 | |
| 19700 | $link-E<gt>warning() |
| 19701 | |
| 19702 | $link-E<gt>file(), $link-E<gt>line() |
| 19703 | |
| 19704 | $link-E<gt>page() |
| 19705 | |
| 19706 | $link-E<gt>node() |
| 19707 | |
| 19708 | $link-E<gt>alttext() |
| 19709 | |
| 19710 | $link-E<gt>type() |
| 19711 | |
| 19712 | $link-E<gt>link() |
| 19713 | |
| 19714 | =over 4 |
| 19715 | |
| 19716 | =item Pod::Cache |
| 19717 | |
| 19718 | Pod::Cache-E<gt>new() |
| 19719 | |
| 19720 | =back |
| 19721 | |
| 19722 | $cache-E<gt>item() |
| 19723 | |
| 19724 | $cache-E<gt>find_page($name) |
| 19725 | |
| 19726 | =over 4 |
| 19727 | |
| 19728 | =item Pod::Cache::Item |
| 19729 | |
| 19730 | Pod::Cache::Item-E<gt>new() |
| 19731 | |
| 19732 | =back |
| 19733 | |
| 19734 | $cacheitem-E<gt>page() |
| 19735 | |
| 19736 | $cacheitem-E<gt>description() |
| 19737 | |
| 19738 | $cacheitem-E<gt>path() |
| 19739 | |
| 19740 | $cacheitem-E<gt>file() |
| 19741 | |
| 19742 | $cacheitem-E<gt>nodes() |
| 19743 | |
| 19744 | $cacheitem-E<gt>find_node($name) |
| 19745 | |
| 19746 | $cacheitem-E<gt>idx() |
| 19747 | |
| 19748 | =over 4 |
| 19749 | |
| 19750 | =item AUTHOR |
| 19751 | |
| 19752 | =item SEE ALSO |
| 19753 | |
| 19754 | =back |
| 19755 | |
| 19756 | =head2 Pod::Parser - base class for creating POD filters and translators |
| 19757 | |
| 19758 | =over 4 |
| 19759 | |
| 19760 | =item SYNOPSIS |
| 19761 | |
| 19762 | =item REQUIRES |
| 19763 | |
| 19764 | =item EXPORTS |
| 19765 | |
| 19766 | =item DESCRIPTION |
| 19767 | |
| 19768 | =item QUICK OVERVIEW |
| 19769 | |
| 19770 | =item PARSING OPTIONS |
| 19771 | |
| 19772 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), |
| 19773 | B<-warnings> (default: unset) |
| 19774 | |
| 19775 | =back |
| 19776 | |
| 19777 | =over 4 |
| 19778 | |
| 19779 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES |
| 19780 | |
| 19781 | =back |
| 19782 | |
| 19783 | =over 4 |
| 19784 | |
| 19785 | =item B<command()> |
| 19786 | |
| 19787 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> |
| 19788 | |
| 19789 | =back |
| 19790 | |
| 19791 | =over 4 |
| 19792 | |
| 19793 | =item B<verbatim()> |
| 19794 | |
| 19795 | C<$text>, C<$line_num>, C<$pod_para> |
| 19796 | |
| 19797 | =back |
| 19798 | |
| 19799 | =over 4 |
| 19800 | |
| 19801 | =item B<textblock()> |
| 19802 | |
| 19803 | C<$text>, C<$line_num>, C<$pod_para> |
| 19804 | |
| 19805 | =back |
| 19806 | |
| 19807 | =over 4 |
| 19808 | |
| 19809 | =item B<interior_sequence()> |
| 19810 | |
| 19811 | =back |
| 19812 | |
| 19813 | =over 4 |
| 19814 | |
| 19815 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES |
| 19816 | |
| 19817 | =back |
| 19818 | |
| 19819 | =over 4 |
| 19820 | |
| 19821 | =item B<new()> |
| 19822 | |
| 19823 | =back |
| 19824 | |
| 19825 | =over 4 |
| 19826 | |
| 19827 | =item B<initialize()> |
| 19828 | |
| 19829 | =back |
| 19830 | |
| 19831 | =over 4 |
| 19832 | |
| 19833 | =item B<begin_pod()> |
| 19834 | |
| 19835 | =back |
| 19836 | |
| 19837 | =over 4 |
| 19838 | |
| 19839 | =item B<begin_input()> |
| 19840 | |
| 19841 | =back |
| 19842 | |
| 19843 | =over 4 |
| 19844 | |
| 19845 | =item B<end_input()> |
| 19846 | |
| 19847 | =back |
| 19848 | |
| 19849 | =over 4 |
| 19850 | |
| 19851 | =item B<end_pod()> |
| 19852 | |
| 19853 | =back |
| 19854 | |
| 19855 | =over 4 |
| 19856 | |
| 19857 | =item B<preprocess_line()> |
| 19858 | |
| 19859 | =back |
| 19860 | |
| 19861 | =over 4 |
| 19862 | |
| 19863 | =item B<preprocess_paragraph()> |
| 19864 | |
| 19865 | =back |
| 19866 | |
| 19867 | =over 4 |
| 19868 | |
| 19869 | =item METHODS FOR PARSING AND PROCESSING |
| 19870 | |
| 19871 | =back |
| 19872 | |
| 19873 | =over 4 |
| 19874 | |
| 19875 | =item B<parse_text()> |
| 19876 | |
| 19877 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> |
| 19878 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> |
| 19879 | I<code-ref>|I<method-name> |
| 19880 | |
| 19881 | =back |
| 19882 | |
| 19883 | =over 4 |
| 19884 | |
| 19885 | =item B<interpolate()> |
| 19886 | |
| 19887 | =back |
| 19888 | |
| 19889 | =over 4 |
| 19890 | |
| 19891 | =item B<parse_paragraph()> |
| 19892 | |
| 19893 | =back |
| 19894 | |
| 19895 | =over 4 |
| 19896 | |
| 19897 | =item B<parse_from_filehandle()> |
| 19898 | |
| 19899 | =back |
| 19900 | |
| 19901 | =over 4 |
| 19902 | |
| 19903 | =item B<parse_from_file()> |
| 19904 | |
| 19905 | =back |
| 19906 | |
| 19907 | =over 4 |
| 19908 | |
| 19909 | =item ACCESSOR METHODS |
| 19910 | |
| 19911 | =back |
| 19912 | |
| 19913 | =over 4 |
| 19914 | |
| 19915 | =item B<errorsub()> |
| 19916 | |
| 19917 | =back |
| 19918 | |
| 19919 | =over 4 |
| 19920 | |
| 19921 | =item B<cutting()> |
| 19922 | |
| 19923 | =back |
| 19924 | |
| 19925 | =over 4 |
| 19926 | |
| 19927 | =item B<parseopts()> |
| 19928 | |
| 19929 | =back |
| 19930 | |
| 19931 | =over 4 |
| 19932 | |
| 19933 | =item B<output_file()> |
| 19934 | |
| 19935 | =back |
| 19936 | |
| 19937 | =over 4 |
| 19938 | |
| 19939 | =item B<output_handle()> |
| 19940 | |
| 19941 | =back |
| 19942 | |
| 19943 | =over 4 |
| 19944 | |
| 19945 | =item B<input_file()> |
| 19946 | |
| 19947 | =back |
| 19948 | |
| 19949 | =over 4 |
| 19950 | |
| 19951 | =item B<input_handle()> |
| 19952 | |
| 19953 | =back |
| 19954 | |
| 19955 | =over 4 |
| 19956 | |
| 19957 | =item B<input_streams()> |
| 19958 | |
| 19959 | =back |
| 19960 | |
| 19961 | =over 4 |
| 19962 | |
| 19963 | =item B<top_stream()> |
| 19964 | |
| 19965 | =back |
| 19966 | |
| 19967 | =over 4 |
| 19968 | |
| 19969 | =item PRIVATE METHODS AND DATA |
| 19970 | |
| 19971 | =back |
| 19972 | |
| 19973 | =over 4 |
| 19974 | |
| 19975 | =item B<_push_input_stream()> |
| 19976 | |
| 19977 | =back |
| 19978 | |
| 19979 | =over 4 |
| 19980 | |
| 19981 | =item B<_pop_input_stream()> |
| 19982 | |
| 19983 | =back |
| 19984 | |
| 19985 | =over 4 |
| 19986 | |
| 19987 | =item TREE-BASED PARSING |
| 19988 | |
| 19989 | =item SEE ALSO |
| 19990 | |
| 19991 | =item AUTHOR |
| 19992 | |
| 19993 | =back |
| 19994 | |
| 19995 | =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors |
| 19996 | |
| 19997 | =over 4 |
| 19998 | |
| 19999 | =item SYNOPSIS |
| 20000 | |
| 20001 | =item DESCRIPTION |
| 20002 | |
| 20003 | =item SEE ALSO |
| 20004 | |
| 20005 | =item COPYRIGHT AND DISCLAIMERS |
| 20006 | |
| 20007 | =item AUTHOR |
| 20008 | |
| 20009 | =back |
| 20010 | |
| 20011 | =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages |
| 20012 | |
| 20013 | =over 4 |
| 20014 | |
| 20015 | =item SYNOPSIS |
| 20016 | |
| 20017 | =item DESCRIPTION |
| 20018 | |
| 20019 | =item CAVEAT |
| 20020 | |
| 20021 | =item SEE ALSO |
| 20022 | |
| 20023 | =item COPYRIGHT AND DISCLAIMERS |
| 20024 | |
| 20025 | =item AUTHOR |
| 20026 | |
| 20027 | =back |
| 20028 | |
| 20029 | =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff |
| 20030 | |
| 20031 | =over 4 |
| 20032 | |
| 20033 | =item SYNOPSIS |
| 20034 | |
| 20035 | =item DESCRIPTION |
| 20036 | |
| 20037 | =item CAVEAT |
| 20038 | |
| 20039 | =item SEE ALSO |
| 20040 | |
| 20041 | =item COPYRIGHT AND DISCLAIMERS |
| 20042 | |
| 20043 | =item AUTHOR |
| 20044 | |
| 20045 | =back |
| 20046 | |
| 20047 | =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod! |
| 20048 | |
| 20049 | =over 4 |
| 20050 | |
| 20051 | =item SYNOPSIS |
| 20052 | |
| 20053 | =item DESCRIPTION |
| 20054 | |
| 20055 | =item SEE ALSO |
| 20056 | |
| 20057 | =item COPYRIGHT AND DISCLAIMERS |
| 20058 | |
| 20059 | =item AUTHOR |
| 20060 | |
| 20061 | =back |
| 20062 | |
| 20063 | =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF |
| 20064 | |
| 20065 | =over 4 |
| 20066 | |
| 20067 | =item SYNOPSIS |
| 20068 | |
| 20069 | =item DESCRIPTION |
| 20070 | |
| 20071 | =item SEE ALSO |
| 20072 | |
| 20073 | =item COPYRIGHT AND DISCLAIMERS |
| 20074 | |
| 20075 | =item AUTHOR |
| 20076 | |
| 20077 | =back |
| 20078 | |
| 20079 | =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext |
| 20080 | |
| 20081 | =over 4 |
| 20082 | |
| 20083 | =item SYNOPSIS |
| 20084 | |
| 20085 | =item DESCRIPTION |
| 20086 | |
| 20087 | =item CAVEAT |
| 20088 | |
| 20089 | =item SEE ALSO |
| 20090 | |
| 20091 | =item COPYRIGHT AND DISCLAIMERS |
| 20092 | |
| 20093 | =item AUTHOR |
| 20094 | |
| 20095 | =back |
| 20096 | |
| 20097 | =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod |
| 20098 | |
| 20099 | =over 4 |
| 20100 | |
| 20101 | =item SYNOPSIS |
| 20102 | |
| 20103 | =item DESCRIPTION |
| 20104 | |
| 20105 | =item SEE ALSO |
| 20106 | |
| 20107 | =item AUTHOR |
| 20108 | |
| 20109 | =back |
| 20110 | |
| 20111 | =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML |
| 20112 | |
| 20113 | =over 4 |
| 20114 | |
| 20115 | =item SYNOPSIS |
| 20116 | |
| 20117 | =item DESCRIPTION |
| 20118 | |
| 20119 | =item SEE ALSO |
| 20120 | |
| 20121 | =item COPYRIGHT AND DISCLAIMERS |
| 20122 | |
| 20123 | =item AUTHOR |
| 20124 | |
| 20125 | =back |
| 20126 | |
| 20127 | =head2 Pod::PlainText - Convert POD data to formatted ASCII text |
| 20128 | |
| 20129 | =over 4 |
| 20130 | |
| 20131 | =item SYNOPSIS |
| 20132 | |
| 20133 | =item DESCRIPTION |
| 20134 | |
| 20135 | alt, indent, loose, sentence, width |
| 20136 | |
| 20137 | =item DIAGNOSTICS |
| 20138 | |
| 20139 | Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s, |
| 20140 | Unknown sequence: %s, Unmatched =back |
| 20141 | |
| 20142 | =item RESTRICTIONS |
| 20143 | |
| 20144 | =item NOTES |
| 20145 | |
| 20146 | =item SEE ALSO |
| 20147 | |
| 20148 | =item AUTHOR |
| 20149 | |
| 20150 | =back |
| 20151 | |
| 20152 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. |
| 20153 | |
| 20154 | =over 4 |
| 20155 | |
| 20156 | =item SYNOPSIS |
| 20157 | |
| 20158 | =item DESCRIPTION |
| 20159 | |
| 20160 | =over 4 |
| 20161 | |
| 20162 | =item EXPORT |
| 20163 | |
| 20164 | =back |
| 20165 | |
| 20166 | =item AUTHOR |
| 20167 | |
| 20168 | =item SEE ALSO |
| 20169 | |
| 20170 | =back |
| 20171 | |
| 20172 | =head2 Pod::Select, podselect() - extract selected sections of POD from |
| 20173 | input |
| 20174 | |
| 20175 | =over 4 |
| 20176 | |
| 20177 | =item SYNOPSIS |
| 20178 | |
| 20179 | =item REQUIRES |
| 20180 | |
| 20181 | =item EXPORTS |
| 20182 | |
| 20183 | =item DESCRIPTION |
| 20184 | |
| 20185 | =item SECTION SPECIFICATIONS |
| 20186 | |
| 20187 | =item RANGE SPECIFICATIONS |
| 20188 | |
| 20189 | =back |
| 20190 | |
| 20191 | =over 4 |
| 20192 | |
| 20193 | =item OBJECT METHODS |
| 20194 | |
| 20195 | =back |
| 20196 | |
| 20197 | =over 4 |
| 20198 | |
| 20199 | =item B<curr_headings()> |
| 20200 | |
| 20201 | =back |
| 20202 | |
| 20203 | =over 4 |
| 20204 | |
| 20205 | =item B<select()> |
| 20206 | |
| 20207 | =back |
| 20208 | |
| 20209 | =over 4 |
| 20210 | |
| 20211 | =item B<add_selection()> |
| 20212 | |
| 20213 | =back |
| 20214 | |
| 20215 | =over 4 |
| 20216 | |
| 20217 | =item B<clear_selections()> |
| 20218 | |
| 20219 | =back |
| 20220 | |
| 20221 | =over 4 |
| 20222 | |
| 20223 | =item B<match_section()> |
| 20224 | |
| 20225 | =back |
| 20226 | |
| 20227 | =over 4 |
| 20228 | |
| 20229 | =item B<is_selected()> |
| 20230 | |
| 20231 | =back |
| 20232 | |
| 20233 | =over 4 |
| 20234 | |
| 20235 | =item EXPORTED FUNCTIONS |
| 20236 | |
| 20237 | =back |
| 20238 | |
| 20239 | =over 4 |
| 20240 | |
| 20241 | =item B<podselect()> |
| 20242 | |
| 20243 | B<-output>, B<-sections>, B<-ranges> |
| 20244 | |
| 20245 | =back |
| 20246 | |
| 20247 | =over 4 |
| 20248 | |
| 20249 | =item PRIVATE METHODS AND DATA |
| 20250 | |
| 20251 | =back |
| 20252 | |
| 20253 | =over 4 |
| 20254 | |
| 20255 | =item B<_compile_section_spec()> |
| 20256 | |
| 20257 | =back |
| 20258 | |
| 20259 | =over 4 |
| 20260 | |
| 20261 | =item $self->{_SECTION_HEADINGS} |
| 20262 | |
| 20263 | =back |
| 20264 | |
| 20265 | =over 4 |
| 20266 | |
| 20267 | =item $self->{_SELECTED_SECTIONS} |
| 20268 | |
| 20269 | =back |
| 20270 | |
| 20271 | =over 4 |
| 20272 | |
| 20273 | =item SEE ALSO |
| 20274 | |
| 20275 | =item AUTHOR |
| 20276 | |
| 20277 | =back |
| 20278 | |
| 20279 | =head2 Pod::Text - Convert POD data to formatted ASCII text |
| 20280 | |
| 20281 | =over 4 |
| 20282 | |
| 20283 | =item SYNOPSIS |
| 20284 | |
| 20285 | =item DESCRIPTION |
| 20286 | |
| 20287 | alt, code, indent, loose, margin, quotes, sentence, width |
| 20288 | |
| 20289 | =item DIAGNOSTICS |
| 20290 | |
| 20291 | Bizarre space in item, Item called without tag, Can't open %s for reading: |
| 20292 | %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, |
| 20293 | %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: |
| 20294 | Unmatched =back |
| 20295 | |
| 20296 | =item RESTRICTIONS |
| 20297 | |
| 20298 | =item NOTES |
| 20299 | |
| 20300 | =item SEE ALSO |
| 20301 | |
| 20302 | =item AUTHOR |
| 20303 | |
| 20304 | =item COPYRIGHT AND LICENSE |
| 20305 | |
| 20306 | =back |
| 20307 | |
| 20308 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text |
| 20309 | |
| 20310 | =over 4 |
| 20311 | |
| 20312 | =item SYNOPSIS |
| 20313 | |
| 20314 | =item DESCRIPTION |
| 20315 | |
| 20316 | =item BUGS |
| 20317 | |
| 20318 | =item SEE ALSO |
| 20319 | |
| 20320 | =item AUTHOR |
| 20321 | |
| 20322 | =item COPYRIGHT AND LICENSE |
| 20323 | |
| 20324 | =back |
| 20325 | |
| 20326 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike |
| 20327 | text |
| 20328 | |
| 20329 | =over 4 |
| 20330 | |
| 20331 | =item SYNOPSIS |
| 20332 | |
| 20333 | =item DESCRIPTION |
| 20334 | |
| 20335 | =item BUGS |
| 20336 | |
| 20337 | =item SEE ALSO |
| 20338 | |
| 20339 | =item AUTHOR |
| 20340 | |
| 20341 | =item COPYRIGHT AND LICENSE |
| 20342 | |
| 20343 | =back |
| 20344 | |
| 20345 | =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format |
| 20346 | escapes |
| 20347 | |
| 20348 | =over 4 |
| 20349 | |
| 20350 | =item SYNOPSIS |
| 20351 | |
| 20352 | =item DESCRIPTION |
| 20353 | |
| 20354 | =item NOTES |
| 20355 | |
| 20356 | =item SEE ALSO |
| 20357 | |
| 20358 | =item AUTHOR |
| 20359 | |
| 20360 | =item COPYRIGHT AND LICENSE |
| 20361 | |
| 20362 | =back |
| 20363 | |
| 20364 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
| 20365 | documentation |
| 20366 | |
| 20367 | =over 4 |
| 20368 | |
| 20369 | =item SYNOPSIS |
| 20370 | |
| 20371 | =item ARGUMENTS |
| 20372 | |
| 20373 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-section>, C<-output>, |
| 20374 | C<-input>, C<-pathlist>, C<-noperldoc> |
| 20375 | |
| 20376 | =item DESCRIPTION |
| 20377 | |
| 20378 | =item EXAMPLES |
| 20379 | |
| 20380 | =over 4 |
| 20381 | |
| 20382 | =item Recommended Use |
| 20383 | |
| 20384 | =back |
| 20385 | |
| 20386 | =item CAVEATS |
| 20387 | |
| 20388 | =item AUTHOR |
| 20389 | |
| 20390 | =item ACKNOWLEDGEMENTS |
| 20391 | |
| 20392 | =back |
| 20393 | |
| 20394 | =head2 SDBM_File - Tied access to sdbm files |
| 20395 | |
| 20396 | =over 4 |
| 20397 | |
| 20398 | =item SYNOPSIS |
| 20399 | |
| 20400 | =item DESCRIPTION |
| 20401 | |
| 20402 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
| 20403 | |
| 20404 | =item DIAGNOSTICS |
| 20405 | |
| 20406 | =over 4 |
| 20407 | |
| 20408 | =item C<sdbm store returned -1, errno 22, key "..." at ...> |
| 20409 | |
| 20410 | =back |
| 20411 | |
| 20412 | =item BUGS AND WARNINGS |
| 20413 | |
| 20414 | =back |
| 20415 | |
| 20416 | =head2 Safe - Compile and execute code in restricted compartments |
| 20417 | |
| 20418 | =over 4 |
| 20419 | |
| 20420 | =item SYNOPSIS |
| 20421 | |
| 20422 | =item DESCRIPTION |
| 20423 | |
| 20424 | a new namespace, an operator mask |
| 20425 | |
| 20426 | =item WARNING |
| 20427 | |
| 20428 | =over 4 |
| 20429 | |
| 20430 | =item RECENT CHANGES |
| 20431 | |
| 20432 | =item Methods in class Safe |
| 20433 | |
| 20434 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
| 20435 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from |
| 20436 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), |
| 20437 | root (NAMESPACE), mask (MASK) |
| 20438 | |
| 20439 | =item Some Safety Issues |
| 20440 | |
| 20441 | Memory, CPU, Snooping, Signals, State Changes |
| 20442 | |
| 20443 | =item AUTHOR |
| 20444 | |
| 20445 | =back |
| 20446 | |
| 20447 | =back |
| 20448 | |
| 20449 | =head2 Scalar::Util - A selection of general-utility scalar subroutines |
| 20450 | |
| 20451 | =over 4 |
| 20452 | |
| 20453 | =item SYNOPSIS |
| 20454 | |
| 20455 | =item DESCRIPTION |
| 20456 | |
| 20457 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, |
| 20458 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, |
| 20459 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF |
| 20460 | |
| 20461 | =item KNOWN BUGS |
| 20462 | |
| 20463 | =item COPYRIGHT |
| 20464 | |
| 20465 | =item BLATANT PLUG |
| 20466 | |
| 20467 | =back |
| 20468 | |
| 20469 | =head2 Search::Dict, look - search for key in dictionary file |
| 20470 | |
| 20471 | =over 4 |
| 20472 | |
| 20473 | =item SYNOPSIS |
| 20474 | |
| 20475 | =item DESCRIPTION |
| 20476 | |
| 20477 | =back |
| 20478 | |
| 20479 | =head2 SelectSaver - save and restore selected file handle |
| 20480 | |
| 20481 | =over 4 |
| 20482 | |
| 20483 | =item SYNOPSIS |
| 20484 | |
| 20485 | =item DESCRIPTION |
| 20486 | |
| 20487 | =back |
| 20488 | |
| 20489 | =head2 SelfLoader - load functions only on demand |
| 20490 | |
| 20491 | =over 4 |
| 20492 | |
| 20493 | =item SYNOPSIS |
| 20494 | |
| 20495 | =item DESCRIPTION |
| 20496 | |
| 20497 | =over 4 |
| 20498 | |
| 20499 | =item The __DATA__ token |
| 20500 | |
| 20501 | =item SelfLoader autoloading |
| 20502 | |
| 20503 | =item Autoloading and package lexicals |
| 20504 | |
| 20505 | =item SelfLoader and AutoLoader |
| 20506 | |
| 20507 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
| 20508 | |
| 20509 | =item Classes and inherited methods. |
| 20510 | |
| 20511 | =back |
| 20512 | |
| 20513 | =item Multiple packages and fully qualified subroutine names |
| 20514 | |
| 20515 | =back |
| 20516 | |
| 20517 | =head2 Shell - run shell commands transparently within perl |
| 20518 | |
| 20519 | =over 4 |
| 20520 | |
| 20521 | =item SYNOPSIS |
| 20522 | |
| 20523 | =item DESCRIPTION |
| 20524 | |
| 20525 | =over 4 |
| 20526 | |
| 20527 | =item Caveats |
| 20528 | |
| 20529 | =item Escaping Magic Characters |
| 20530 | |
| 20531 | =item Configuration |
| 20532 | |
| 20533 | =back |
| 20534 | |
| 20535 | =item BUGS |
| 20536 | |
| 20537 | =item AUTHOR |
| 20538 | |
| 20539 | =back |
| 20540 | |
| 20541 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
| 20542 | socket.h defines and structure manipulators |
| 20543 | |
| 20544 | =over 4 |
| 20545 | |
| 20546 | =item SYNOPSIS |
| 20547 | |
| 20548 | =item DESCRIPTION |
| 20549 | |
| 20550 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
| 20551 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, |
| 20552 | ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, |
| 20553 | unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un |
| 20554 | SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN |
| 20555 | |
| 20556 | =back |
| 20557 | |
| 20558 | =head2 Storable - persistence for Perl data structures |
| 20559 | |
| 20560 | =over 4 |
| 20561 | |
| 20562 | =item SYNOPSIS |
| 20563 | |
| 20564 | =item DESCRIPTION |
| 20565 | |
| 20566 | =item MEMORY STORE |
| 20567 | |
| 20568 | =item ADVISORY LOCKING |
| 20569 | |
| 20570 | =item SPEED |
| 20571 | |
| 20572 | =item CANONICAL REPRESENTATION |
| 20573 | |
| 20574 | =item CODE REFERENCES |
| 20575 | |
| 20576 | =item FORWARD COMPATIBILITY |
| 20577 | |
| 20578 | utf8 data, restricted hashes, files from future versions of Storable |
| 20579 | |
| 20580 | =item ERROR REPORTING |
| 20581 | |
| 20582 | =item WIZARDS ONLY |
| 20583 | |
| 20584 | =over 4 |
| 20585 | |
| 20586 | =item Hooks |
| 20587 | |
| 20588 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, |
| 20589 | I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized> |
| 20590 | |
| 20591 | =item Predicates |
| 20592 | |
| 20593 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, |
| 20594 | C<Storable::is_retrieving> |
| 20595 | |
| 20596 | =item Recursion |
| 20597 | |
| 20598 | =item Deep Cloning |
| 20599 | |
| 20600 | =back |
| 20601 | |
| 20602 | =item Storable magic |
| 20603 | |
| 20604 | =item EXAMPLES |
| 20605 | |
| 20606 | =item WARNING |
| 20607 | |
| 20608 | =item BUGS |
| 20609 | |
| 20610 | =over 4 |
| 20611 | |
| 20612 | =item 64 bit data in perl 5.6.0 and 5.6.1 |
| 20613 | |
| 20614 | =back |
| 20615 | |
| 20616 | =item CREDITS |
| 20617 | |
| 20618 | =item AUTHOR |
| 20619 | |
| 20620 | =item SEE ALSO |
| 20621 | |
| 20622 | =back |
| 20623 | |
| 20624 | =head2 Switch - A switch statement for Perl |
| 20625 | |
| 20626 | =over 4 |
| 20627 | |
| 20628 | =item VERSION |
| 20629 | |
| 20630 | =item SYNOPSIS |
| 20631 | |
| 20632 | =item BACKGROUND |
| 20633 | |
| 20634 | =item DESCRIPTION |
| 20635 | |
| 20636 | =over 4 |
| 20637 | |
| 20638 | =item Allowing fall-through |
| 20639 | |
| 20640 | =item Automating fall-through |
| 20641 | |
| 20642 | =item Alternative syntax |
| 20643 | |
| 20644 | =item Higher-order Operations |
| 20645 | |
| 20646 | =back |
| 20647 | |
| 20648 | =item DEPENDENCIES |
| 20649 | |
| 20650 | =item AUTHOR |
| 20651 | |
| 20652 | =item BUGS |
| 20653 | |
| 20654 | =item LIMITATIONS |
| 20655 | |
| 20656 | =item COPYRIGHT |
| 20657 | |
| 20658 | =back |
| 20659 | |
| 20660 | =head2 Symbol - manipulate Perl symbols and their names |
| 20661 | |
| 20662 | =over 4 |
| 20663 | |
| 20664 | =item SYNOPSIS |
| 20665 | |
| 20666 | =item DESCRIPTION |
| 20667 | |
| 20668 | =item BUGS |
| 20669 | |
| 20670 | =back |
| 20671 | |
| 20672 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
| 20673 | |
| 20674 | =over 4 |
| 20675 | |
| 20676 | =item SYNOPSIS |
| 20677 | |
| 20678 | =item DESCRIPTION |
| 20679 | |
| 20680 | =item AUTHOR |
| 20681 | |
| 20682 | =back |
| 20683 | |
| 20684 | =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls |
| 20685 | |
| 20686 | =over 4 |
| 20687 | |
| 20688 | =item VERSION |
| 20689 | |
| 20690 | =item SYNOPSIS |
| 20691 | |
| 20692 | =item DESCRIPTION |
| 20693 | |
| 20694 | =item EXPORTS |
| 20695 | |
| 20696 | =item FUNCTIONS |
| 20697 | |
| 20698 | B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>, |
| 20699 | B<syslog($priority, $format, @args)>, B<Note>, |
| 20700 | B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>, |
| 20701 | B<setlogsock($sock_type, $stream_location)> (added in 5.004_02), |
| 20702 | B<closelog()> |
| 20703 | |
| 20704 | =item EXAMPLES |
| 20705 | |
| 20706 | =item CONSTANTS |
| 20707 | |
| 20708 | =over 4 |
| 20709 | |
| 20710 | =item Facilities |
| 20711 | |
| 20712 | =item Levels |
| 20713 | |
| 20714 | =back |
| 20715 | |
| 20716 | =item DIAGNOSTICS |
| 20717 | |
| 20718 | Invalid argument passed to setlogsock, no connection to syslog available, |
| 20719 | stream passed to setlogsock, but %s is not writable, stream passed to |
| 20720 | setlogsock, but could not find any device, tcp passed to setlogsock, but |
| 20721 | tcp service unavailable, syslog: expecting argument %s, syslog: invalid |
| 20722 | level/facility: %s, syslog: too many levels given: %s, syslog: too many |
| 20723 | facilities given: %s, syslog: level must be given, udp passed to |
| 20724 | setlogsock, but udp service unavailable, unix passed to setlogsock, but |
| 20725 | path not available |
| 20726 | |
| 20727 | =item SEE ALSO |
| 20728 | |
| 20729 | =item AUTHOR |
| 20730 | |
| 20731 | =item BUGS |
| 20732 | |
| 20733 | =item SUPPORT |
| 20734 | |
| 20735 | AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request |
| 20736 | tracker, Search CPAN |
| 20737 | |
| 20738 | =item LICENSE |
| 20739 | |
| 20740 | =back |
| 20741 | |
| 20742 | =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) |
| 20743 | calls |
| 20744 | |
| 20745 | =over 4 |
| 20746 | |
| 20747 | =item VERSION |
| 20748 | |
| 20749 | =item SYNOPSIS |
| 20750 | |
| 20751 | =item DESCRIPTION |
| 20752 | |
| 20753 | =item EXPORTS |
| 20754 | |
| 20755 | =item FUNCTIONS |
| 20756 | |
| 20757 | B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>, |
| 20758 | B<syslog($priority, $format, @args)>, B<Note>, |
| 20759 | B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>, |
| 20760 | B<setlogsock($sock_type, $stream_location)> (added in 5.004_02), |
| 20761 | B<closelog()> |
| 20762 | |
| 20763 | =item EXAMPLES |
| 20764 | |
| 20765 | =item CONSTANTS |
| 20766 | |
| 20767 | =over 4 |
| 20768 | |
| 20769 | =item Facilities |
| 20770 | |
| 20771 | =item Levels |
| 20772 | |
| 20773 | =back |
| 20774 | |
| 20775 | =item DIAGNOSTICS |
| 20776 | |
| 20777 | Invalid argument passed to setlogsock, no connection to syslog available, |
| 20778 | stream passed to setlogsock, but %s is not writable, stream passed to |
| 20779 | setlogsock, but could not find any device, tcp passed to setlogsock, but |
| 20780 | tcp service unavailable, syslog: expecting argument %s, syslog: invalid |
| 20781 | level/facility: %s, syslog: too many levels given: %s, syslog: too many |
| 20782 | facilities given: %s, syslog: level must be given, udp passed to |
| 20783 | setlogsock, but udp service unavailable, unix passed to setlogsock, but |
| 20784 | path not available |
| 20785 | |
| 20786 | =item SEE ALSO |
| 20787 | |
| 20788 | =item AUTHOR |
| 20789 | |
| 20790 | =item BUGS |
| 20791 | |
| 20792 | =item SUPPORT |
| 20793 | |
| 20794 | AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request |
| 20795 | tracker, Search CPAN |
| 20796 | |
| 20797 | =item LICENSE |
| 20798 | |
| 20799 | =back |
| 20800 | |
| 20801 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences |
| 20802 | |
| 20803 | =over 4 |
| 20804 | |
| 20805 | =item SYNOPSIS |
| 20806 | |
| 20807 | =item DESCRIPTION |
| 20808 | |
| 20809 | =item DIAGNOSTICS |
| 20810 | |
| 20811 | Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in |
| 20812 | use, Invalid attribute name %s, Name "%s" used only once: possible typo, No |
| 20813 | comma allowed after filehandle, No name for escape sequence %s |
| 20814 | |
| 20815 | =item ENVIRONMENT |
| 20816 | |
| 20817 | ANSI_COLORS_DISABLED |
| 20818 | |
| 20819 | =item RESTRICTIONS |
| 20820 | |
| 20821 | =item NOTES |
| 20822 | |
| 20823 | =item SEE ALSO |
| 20824 | |
| 20825 | =item AUTHORS |
| 20826 | |
| 20827 | =item COPYRIGHT AND LICENSE |
| 20828 | |
| 20829 | =back |
| 20830 | |
| 20831 | =head2 Term::Cap - Perl termcap interface |
| 20832 | |
| 20833 | =over 4 |
| 20834 | |
| 20835 | =item SYNOPSIS |
| 20836 | |
| 20837 | =item DESCRIPTION |
| 20838 | |
| 20839 | =over 4 |
| 20840 | |
| 20841 | =item METHODS |
| 20842 | |
| 20843 | =back |
| 20844 | |
| 20845 | =back |
| 20846 | |
| 20847 | B<Tgetent>, OSPEED, TERM |
| 20848 | |
| 20849 | B<Tpad>, B<$string>, B<$cnt>, B<$FH> |
| 20850 | |
| 20851 | B<Tputs>, B<$cap>, B<$cnt>, B<$FH> |
| 20852 | |
| 20853 | B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> |
| 20854 | |
| 20855 | B<Trequire> |
| 20856 | |
| 20857 | =over 4 |
| 20858 | |
| 20859 | =item EXAMPLES |
| 20860 | |
| 20861 | =item COPYRIGHT AND LICENSE |
| 20862 | |
| 20863 | =item AUTHOR |
| 20864 | |
| 20865 | =item SEE ALSO |
| 20866 | |
| 20867 | =back |
| 20868 | |
| 20869 | =head2 Term::Complete - Perl word completion module |
| 20870 | |
| 20871 | =over 4 |
| 20872 | |
| 20873 | =item SYNOPSIS |
| 20874 | |
| 20875 | =item DESCRIPTION |
| 20876 | |
| 20877 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
| 20878 | |
| 20879 | =item DIAGNOSTICS |
| 20880 | |
| 20881 | =item BUGS |
| 20882 | |
| 20883 | =item AUTHOR |
| 20884 | |
| 20885 | =back |
| 20886 | |
| 20887 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. |
| 20888 | If no real package is found, substitutes stubs instead of basic functions. |
| 20889 | |
| 20890 | =over 4 |
| 20891 | |
| 20892 | =item SYNOPSIS |
| 20893 | |
| 20894 | =item DESCRIPTION |
| 20895 | |
| 20896 | =item Minimal set of supported functions |
| 20897 | |
| 20898 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>, |
| 20899 | C<findConsole>, Attribs, C<Features> |
| 20900 | |
| 20901 | =item Additional supported functions |
| 20902 | |
| 20903 | C<tkRunning>, C<ornaments>, C<newTTY> |
| 20904 | |
| 20905 | =item EXPORTS |
| 20906 | |
| 20907 | =item ENVIRONMENT |
| 20908 | |
| 20909 | =item CAVEATS |
| 20910 | |
| 20911 | =back |
| 20912 | |
| 20913 | =head2 Test - provides a simple framework for writing test scripts |
| 20914 | |
| 20915 | =over 4 |
| 20916 | |
| 20917 | =item SYNOPSIS |
| 20918 | |
| 20919 | =item DESCRIPTION |
| 20920 | |
| 20921 | =item QUICK START GUIDE |
| 20922 | |
| 20923 | =over 4 |
| 20924 | |
| 20925 | =item Functions |
| 20926 | |
| 20927 | C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>, |
| 20928 | C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub> |
| 20929 | |
| 20930 | =back |
| 20931 | |
| 20932 | =back |
| 20933 | |
| 20934 | B<_to_value> |
| 20935 | |
| 20936 | C<ok(...)> |
| 20937 | |
| 20938 | C<skip(I<skip_if_true>, I<args...>)> |
| 20939 | |
| 20940 | =over 4 |
| 20941 | |
| 20942 | =item TEST TYPES |
| 20943 | |
| 20944 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS |
| 20945 | |
| 20946 | =item ONFAIL |
| 20947 | |
| 20948 | =item BUGS and CAVEATS |
| 20949 | |
| 20950 | =item ENVIRONMENT |
| 20951 | |
| 20952 | =item NOTE |
| 20953 | |
| 20954 | =item SEE ALSO |
| 20955 | |
| 20956 | =item AUTHOR |
| 20957 | |
| 20958 | =back |
| 20959 | |
| 20960 | =head2 Test::Builder - Backend for building test libraries |
| 20961 | |
| 20962 | =over 4 |
| 20963 | |
| 20964 | =item SYNOPSIS |
| 20965 | |
| 20966 | =item DESCRIPTION |
| 20967 | |
| 20968 | =over 4 |
| 20969 | |
| 20970 | =item Construction |
| 20971 | |
| 20972 | B<new> |
| 20973 | |
| 20974 | =back |
| 20975 | |
| 20976 | =back |
| 20977 | |
| 20978 | B<create> |
| 20979 | |
| 20980 | B<reset> |
| 20981 | |
| 20982 | =over 4 |
| 20983 | |
| 20984 | =item Setting up tests |
| 20985 | |
| 20986 | B<exported_to> |
| 20987 | |
| 20988 | =back |
| 20989 | |
| 20990 | B<plan> |
| 20991 | |
| 20992 | B<expected_tests> |
| 20993 | |
| 20994 | B<no_plan> |
| 20995 | |
| 20996 | B<has_plan> |
| 20997 | |
| 20998 | B<skip_all> |
| 20999 | |
| 21000 | =over 4 |
| 21001 | |
| 21002 | =item Running tests |
| 21003 | |
| 21004 | B<ok> |
| 21005 | |
| 21006 | =back |
| 21007 | |
| 21008 | B<is_eq>, B<is_num> |
| 21009 | |
| 21010 | B<isnt_eq>, B<isnt_num> |
| 21011 | |
| 21012 | B<like>, B<unlike> |
| 21013 | |
| 21014 | B<maybe_regex> |
| 21015 | |
| 21016 | B<cmp_ok> |
| 21017 | |
| 21018 | B<BAIL_OUT> |
| 21019 | |
| 21020 | B<skip> |
| 21021 | |
| 21022 | B<todo_skip> |
| 21023 | |
| 21024 | B<skip_rest> |
| 21025 | |
| 21026 | =over 4 |
| 21027 | |
| 21028 | =item Test style |
| 21029 | |
| 21030 | B<level> |
| 21031 | |
| 21032 | =back |
| 21033 | |
| 21034 | B<use_numbers> |
| 21035 | |
| 21036 | B<no_diag>, B<no_ending>, B<no_header> |
| 21037 | |
| 21038 | =over 4 |
| 21039 | |
| 21040 | =item Output |
| 21041 | |
| 21042 | B<diag> |
| 21043 | |
| 21044 | =back |
| 21045 | |
| 21046 | B<_print> |
| 21047 | |
| 21048 | B<_print_diag> |
| 21049 | |
| 21050 | B<output>, B<failure_output>, B<todo_output> |
| 21051 | |
| 21052 | =over 4 |
| 21053 | |
| 21054 | =item Test Status and Info |
| 21055 | |
| 21056 | B<current_test> |
| 21057 | |
| 21058 | =back |
| 21059 | |
| 21060 | B<summary> |
| 21061 | |
| 21062 | B<details> |
| 21063 | |
| 21064 | B<todo> |
| 21065 | |
| 21066 | B<caller> |
| 21067 | |
| 21068 | B<_sanity_check> |
| 21069 | |
| 21070 | B<_whoa> |
| 21071 | |
| 21072 | B<_my_exit> |
| 21073 | |
| 21074 | =over 4 |
| 21075 | |
| 21076 | =item EXIT CODES |
| 21077 | |
| 21078 | =item THREADS |
| 21079 | |
| 21080 | =item EXAMPLES |
| 21081 | |
| 21082 | =item SEE ALSO |
| 21083 | |
| 21084 | =item AUTHORS |
| 21085 | |
| 21086 | =item COPYRIGHT |
| 21087 | |
| 21088 | =back |
| 21089 | |
| 21090 | =head2 Test::Builder::Module - Base class for test modules |
| 21091 | |
| 21092 | =over 4 |
| 21093 | |
| 21094 | =item SYNOPSIS |
| 21095 | |
| 21096 | =item DESCRIPTION |
| 21097 | |
| 21098 | =over 4 |
| 21099 | |
| 21100 | =item Importing |
| 21101 | |
| 21102 | =back |
| 21103 | |
| 21104 | =back |
| 21105 | |
| 21106 | =over 4 |
| 21107 | |
| 21108 | =item Builder |
| 21109 | |
| 21110 | =back |
| 21111 | |
| 21112 | =head2 Test::Builder::Tester - test testsuites that have been built with |
| 21113 | Test::Builder |
| 21114 | |
| 21115 | =over 4 |
| 21116 | |
| 21117 | =item SYNOPSIS |
| 21118 | |
| 21119 | =item DESCRIPTION |
| 21120 | |
| 21121 | =back |
| 21122 | |
| 21123 | =over 4 |
| 21124 | |
| 21125 | =item Methods |
| 21126 | |
| 21127 | test_out, test_err |
| 21128 | |
| 21129 | =back |
| 21130 | |
| 21131 | test_fail |
| 21132 | |
| 21133 | test_diag |
| 21134 | |
| 21135 | test_test, title (synonym 'name', 'label'), skip_out, skip_err |
| 21136 | |
| 21137 | line_num |
| 21138 | |
| 21139 | color |
| 21140 | |
| 21141 | =over 4 |
| 21142 | |
| 21143 | =item BUGS |
| 21144 | |
| 21145 | =item AUTHOR |
| 21146 | |
| 21147 | =item NOTES |
| 21148 | |
| 21149 | =item SEE ALSO |
| 21150 | |
| 21151 | =back |
| 21152 | |
| 21153 | =head2 Test::Builder::Tester::Color - turn on colour in |
| 21154 | Test::Builder::Tester |
| 21155 | |
| 21156 | =over 4 |
| 21157 | |
| 21158 | =item SYNOPSIS |
| 21159 | |
| 21160 | =item DESCRIPTION |
| 21161 | |
| 21162 | =back |
| 21163 | |
| 21164 | =over 4 |
| 21165 | |
| 21166 | =item AUTHOR |
| 21167 | |
| 21168 | =item BUGS |
| 21169 | |
| 21170 | =item SEE ALSO |
| 21171 | |
| 21172 | =back |
| 21173 | |
| 21174 | =head2 Test::Harness - Run Perl standard test scripts with statistics |
| 21175 | |
| 21176 | =over 4 |
| 21177 | |
| 21178 | =item VERSION |
| 21179 | |
| 21180 | =back |
| 21181 | |
| 21182 | =over 4 |
| 21183 | |
| 21184 | =item SYNOPSIS |
| 21185 | |
| 21186 | =item DESCRIPTION |
| 21187 | |
| 21188 | =over 4 |
| 21189 | |
| 21190 | =item Taint mode |
| 21191 | |
| 21192 | =item Configuration variables. |
| 21193 | |
| 21194 | C<$Test::Harness::Verbose>, C<$Test::Harness::switches>, |
| 21195 | C<$Test::Harness::Timer> |
| 21196 | |
| 21197 | =item Failure |
| 21198 | |
| 21199 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of |
| 21200 | Failed> |
| 21201 | |
| 21202 | =item Functions |
| 21203 | |
| 21204 | B<runtests> |
| 21205 | |
| 21206 | =back |
| 21207 | |
| 21208 | =back |
| 21209 | |
| 21210 | B<_all_ok> |
| 21211 | |
| 21212 | B<_globdir> |
| 21213 | |
| 21214 | B<_run_all_tests> |
| 21215 | |
| 21216 | B<_mk_leader> |
| 21217 | |
| 21218 | B<_leader_width> |
| 21219 | |
| 21220 | =over 4 |
| 21221 | |
| 21222 | =item EXPORT |
| 21223 | |
| 21224 | =item DIAGNOSTICS |
| 21225 | |
| 21226 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
| 21227 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
| 21228 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. |
| 21229 | %s>, C<FAILED--Further testing stopped: %s> |
| 21230 | |
| 21231 | =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS |
| 21232 | |
| 21233 | C<HARNESS_ACTIVE>, C<HARNESS_VERSION> |
| 21234 | |
| 21235 | =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS |
| 21236 | |
| 21237 | C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>, |
| 21238 | C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, |
| 21239 | C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> |
| 21240 | |
| 21241 | =item EXAMPLE |
| 21242 | |
| 21243 | =item SEE ALSO |
| 21244 | |
| 21245 | =item TODO |
| 21246 | |
| 21247 | =item BUGS |
| 21248 | |
| 21249 | =item AUTHORS |
| 21250 | |
| 21251 | =item COPYRIGHT |
| 21252 | |
| 21253 | =back |
| 21254 | |
| 21255 | =head2 Test::Harness::Assert - simple assert |
| 21256 | |
| 21257 | =over 4 |
| 21258 | |
| 21259 | =item SYNOPSIS |
| 21260 | |
| 21261 | =item DESCRIPTION |
| 21262 | |
| 21263 | =item FUNCTIONS |
| 21264 | |
| 21265 | =over 4 |
| 21266 | |
| 21267 | =item C<assert()> |
| 21268 | |
| 21269 | =back |
| 21270 | |
| 21271 | =back |
| 21272 | |
| 21273 | =over 4 |
| 21274 | |
| 21275 | =item AUTHOR |
| 21276 | |
| 21277 | =item SEE ALSO |
| 21278 | |
| 21279 | =back |
| 21280 | |
| 21281 | =head2 Test::Harness::Iterator - Internal Test::Harness Iterator |
| 21282 | |
| 21283 | =over 4 |
| 21284 | |
| 21285 | =item SYNOPSIS |
| 21286 | |
| 21287 | =item DESCRIPTION |
| 21288 | |
| 21289 | =over 4 |
| 21290 | |
| 21291 | =item new() |
| 21292 | |
| 21293 | =item next() |
| 21294 | |
| 21295 | =back |
| 21296 | |
| 21297 | =back |
| 21298 | |
| 21299 | =head2 Test::Harness::Point - object for tracking a single test point |
| 21300 | |
| 21301 | =over 4 |
| 21302 | |
| 21303 | =item SYNOPSIS |
| 21304 | |
| 21305 | =item CONSTRUCTION |
| 21306 | |
| 21307 | =over 4 |
| 21308 | |
| 21309 | =item new() |
| 21310 | |
| 21311 | =back |
| 21312 | |
| 21313 | =back |
| 21314 | |
| 21315 | =over 4 |
| 21316 | |
| 21317 | =item from_test_line( $line ) |
| 21318 | |
| 21319 | =back |
| 21320 | |
| 21321 | =over 4 |
| 21322 | |
| 21323 | =item ACCESSORS |
| 21324 | |
| 21325 | ok, number |
| 21326 | |
| 21327 | =back |
| 21328 | |
| 21329 | =head2 Test::Harness::Straps - detailed analysis of test results |
| 21330 | |
| 21331 | =over 4 |
| 21332 | |
| 21333 | =item SYNOPSIS |
| 21334 | |
| 21335 | =item DESCRIPTION |
| 21336 | |
| 21337 | =item CONSTRUCTION |
| 21338 | |
| 21339 | =over 4 |
| 21340 | |
| 21341 | =item new() |
| 21342 | |
| 21343 | =back |
| 21344 | |
| 21345 | =back |
| 21346 | |
| 21347 | =over 4 |
| 21348 | |
| 21349 | =item $strap->_init |
| 21350 | |
| 21351 | =back |
| 21352 | |
| 21353 | =over 4 |
| 21354 | |
| 21355 | =item ANALYSIS |
| 21356 | |
| 21357 | =over 4 |
| 21358 | |
| 21359 | =item $strap->analyze( $name, \@output_lines ) |
| 21360 | |
| 21361 | =back |
| 21362 | |
| 21363 | =back |
| 21364 | |
| 21365 | =over 4 |
| 21366 | |
| 21367 | =item $strap->analyze_fh( $name, $test_filehandle ) |
| 21368 | |
| 21369 | =back |
| 21370 | |
| 21371 | =over 4 |
| 21372 | |
| 21373 | =item $strap->analyze_file( $test_file ) |
| 21374 | |
| 21375 | =back |
| 21376 | |
| 21377 | =over 4 |
| 21378 | |
| 21379 | =item $strap->_command_line( $file ) |
| 21380 | |
| 21381 | =back |
| 21382 | |
| 21383 | =over 4 |
| 21384 | |
| 21385 | =item $strap->_command() |
| 21386 | |
| 21387 | =back |
| 21388 | |
| 21389 | =over 4 |
| 21390 | |
| 21391 | =item $strap->_switches( $file ) |
| 21392 | |
| 21393 | =back |
| 21394 | |
| 21395 | =over 4 |
| 21396 | |
| 21397 | =item $strap->_cleaned_switches( @switches_from_user ) |
| 21398 | |
| 21399 | =back |
| 21400 | |
| 21401 | =over 4 |
| 21402 | |
| 21403 | =item $strap->_INC2PERL5LIB |
| 21404 | |
| 21405 | =back |
| 21406 | |
| 21407 | =over 4 |
| 21408 | |
| 21409 | =item $strap->_filtered_INC() |
| 21410 | |
| 21411 | =back |
| 21412 | |
| 21413 | =over 4 |
| 21414 | |
| 21415 | =item $strap->_restore_PERL5LIB() |
| 21416 | |
| 21417 | =back |
| 21418 | |
| 21419 | =over 4 |
| 21420 | |
| 21421 | =item Parsing |
| 21422 | |
| 21423 | =over 4 |
| 21424 | |
| 21425 | =item C<_is_diagnostic> |
| 21426 | |
| 21427 | =back |
| 21428 | |
| 21429 | =back |
| 21430 | |
| 21431 | =over 4 |
| 21432 | |
| 21433 | =item C<_is_header> |
| 21434 | |
| 21435 | =back |
| 21436 | |
| 21437 | =over 4 |
| 21438 | |
| 21439 | =item C<_is_bail_out> |
| 21440 | |
| 21441 | =back |
| 21442 | |
| 21443 | =over 4 |
| 21444 | |
| 21445 | =item C<_reset_file_state> |
| 21446 | |
| 21447 | =back |
| 21448 | |
| 21449 | =over 4 |
| 21450 | |
| 21451 | =item Results |
| 21452 | |
| 21453 | =item EXAMPLES |
| 21454 | |
| 21455 | =item AUTHOR |
| 21456 | |
| 21457 | =item SEE ALSO |
| 21458 | |
| 21459 | =back |
| 21460 | |
| 21461 | =head2 Test::Harness::TAP - Documentation for the TAP format |
| 21462 | |
| 21463 | =over 4 |
| 21464 | |
| 21465 | =item SYNOPSIS |
| 21466 | |
| 21467 | =item TODO |
| 21468 | |
| 21469 | =item THE TAP FORMAT |
| 21470 | |
| 21471 | =item HARNESS BEHAVIOR |
| 21472 | |
| 21473 | =item TESTS LINES AND THE PLAN |
| 21474 | |
| 21475 | =over 4 |
| 21476 | |
| 21477 | =item The plan |
| 21478 | |
| 21479 | =item The test line |
| 21480 | |
| 21481 | C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok |
| 21482 | (required), Test number (recommended), Description (recommended), Directive |
| 21483 | (only when necessary) |
| 21484 | |
| 21485 | =back |
| 21486 | |
| 21487 | =item DIRECTIVES |
| 21488 | |
| 21489 | =over 4 |
| 21490 | |
| 21491 | =item TODO tests |
| 21492 | |
| 21493 | =item Skipping tests |
| 21494 | |
| 21495 | =back |
| 21496 | |
| 21497 | =item OTHER LINES |
| 21498 | |
| 21499 | =over 4 |
| 21500 | |
| 21501 | =item Bail out! |
| 21502 | |
| 21503 | =item Diagnostics |
| 21504 | |
| 21505 | =item Anything else |
| 21506 | |
| 21507 | =back |
| 21508 | |
| 21509 | =item EXAMPLES |
| 21510 | |
| 21511 | =over 4 |
| 21512 | |
| 21513 | =item Common with explanation |
| 21514 | |
| 21515 | =item Unknown amount and failures |
| 21516 | |
| 21517 | =item Giving up |
| 21518 | |
| 21519 | =item Skipping a few |
| 21520 | |
| 21521 | =item Skipping everything |
| 21522 | |
| 21523 | =item Got spare tuits? |
| 21524 | |
| 21525 | =item Creative liberties |
| 21526 | |
| 21527 | =back |
| 21528 | |
| 21529 | =item AUTHORS |
| 21530 | |
| 21531 | =item ACKNOWLEDGEMENTS |
| 21532 | |
| 21533 | =item COPYRIGHT |
| 21534 | |
| 21535 | =back |
| 21536 | |
| 21537 | =head2 Test::More - yet another framework for writing test scripts |
| 21538 | |
| 21539 | =over 4 |
| 21540 | |
| 21541 | =item SYNOPSIS |
| 21542 | |
| 21543 | =item DESCRIPTION |
| 21544 | |
| 21545 | =over 4 |
| 21546 | |
| 21547 | =item I love it when a plan comes together |
| 21548 | |
| 21549 | =back |
| 21550 | |
| 21551 | =back |
| 21552 | |
| 21553 | =over 4 |
| 21554 | |
| 21555 | =item Test names |
| 21556 | |
| 21557 | =item I'm ok, you're not ok. |
| 21558 | |
| 21559 | B<ok> |
| 21560 | |
| 21561 | =back |
| 21562 | |
| 21563 | B<is>, B<isnt> |
| 21564 | |
| 21565 | B<like> |
| 21566 | |
| 21567 | B<unlike> |
| 21568 | |
| 21569 | B<cmp_ok> |
| 21570 | |
| 21571 | B<can_ok> |
| 21572 | |
| 21573 | B<isa_ok> |
| 21574 | |
| 21575 | B<pass>, B<fail> |
| 21576 | |
| 21577 | =over 4 |
| 21578 | |
| 21579 | =item Module tests |
| 21580 | |
| 21581 | B<use_ok> |
| 21582 | |
| 21583 | =back |
| 21584 | |
| 21585 | B<require_ok> |
| 21586 | |
| 21587 | =over 4 |
| 21588 | |
| 21589 | =item Complex data structures |
| 21590 | |
| 21591 | B<is_deeply> |
| 21592 | |
| 21593 | =back |
| 21594 | |
| 21595 | =over 4 |
| 21596 | |
| 21597 | =item Diagnostics |
| 21598 | |
| 21599 | B<diag> |
| 21600 | |
| 21601 | =back |
| 21602 | |
| 21603 | =over 4 |
| 21604 | |
| 21605 | =item Conditional tests |
| 21606 | |
| 21607 | B<SKIP: BLOCK> |
| 21608 | |
| 21609 | =back |
| 21610 | |
| 21611 | B<TODO: BLOCK>, B<todo_skip> |
| 21612 | |
| 21613 | When do I use SKIP vs. TODO? |
| 21614 | |
| 21615 | =over 4 |
| 21616 | |
| 21617 | =item Test control |
| 21618 | |
| 21619 | B<BAIL_OUT> |
| 21620 | |
| 21621 | =back |
| 21622 | |
| 21623 | =over 4 |
| 21624 | |
| 21625 | =item Discouraged comparison functions |
| 21626 | |
| 21627 | B<eq_array> |
| 21628 | |
| 21629 | =back |
| 21630 | |
| 21631 | B<eq_hash> |
| 21632 | |
| 21633 | B<eq_set> |
| 21634 | |
| 21635 | =over 4 |
| 21636 | |
| 21637 | =item Extending and Embedding Test::More |
| 21638 | |
| 21639 | B<builder> |
| 21640 | |
| 21641 | =back |
| 21642 | |
| 21643 | =over 4 |
| 21644 | |
| 21645 | =item EXIT CODES |
| 21646 | |
| 21647 | =item CAVEATS and NOTES |
| 21648 | |
| 21649 | Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade |
| 21650 | |
| 21651 | =item HISTORY |
| 21652 | |
| 21653 | =item SEE ALSO |
| 21654 | |
| 21655 | =item AUTHORS |
| 21656 | |
| 21657 | =item BUGS |
| 21658 | |
| 21659 | =item COPYRIGHT |
| 21660 | |
| 21661 | =back |
| 21662 | |
| 21663 | =head2 Test::Simple - Basic utilities for writing tests. |
| 21664 | |
| 21665 | =over 4 |
| 21666 | |
| 21667 | =item SYNOPSIS |
| 21668 | |
| 21669 | =item DESCRIPTION |
| 21670 | |
| 21671 | B<ok> |
| 21672 | |
| 21673 | =back |
| 21674 | |
| 21675 | =over 4 |
| 21676 | |
| 21677 | =item EXAMPLE |
| 21678 | |
| 21679 | =item CAVEATS |
| 21680 | |
| 21681 | =item NOTES |
| 21682 | |
| 21683 | =item HISTORY |
| 21684 | |
| 21685 | =item SEE ALSO |
| 21686 | |
| 21687 | L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, |
| 21688 | L<Test::Harness> |
| 21689 | |
| 21690 | =item AUTHORS |
| 21691 | |
| 21692 | =item COPYRIGHT |
| 21693 | |
| 21694 | =back |
| 21695 | |
| 21696 | =head2 Test::Tutorial - A tutorial about writing really basic tests |
| 21697 | |
| 21698 | =over 4 |
| 21699 | |
| 21700 | =item DESCRIPTION |
| 21701 | |
| 21702 | =over 4 |
| 21703 | |
| 21704 | =item Nuts and bolts of testing. |
| 21705 | |
| 21706 | =item Where to start? |
| 21707 | |
| 21708 | =item Names |
| 21709 | |
| 21710 | =item Test the manual |
| 21711 | |
| 21712 | =item Sometimes the tests are wrong |
| 21713 | |
| 21714 | =item Testing lots of values |
| 21715 | |
| 21716 | =item Informative names |
| 21717 | |
| 21718 | =item Skipping tests |
| 21719 | |
| 21720 | =item Todo tests |
| 21721 | |
| 21722 | =item Testing with taint mode. |
| 21723 | |
| 21724 | =back |
| 21725 | |
| 21726 | =item FOOTNOTES |
| 21727 | |
| 21728 | =item AUTHORS |
| 21729 | |
| 21730 | =item COPYRIGHT |
| 21731 | |
| 21732 | =back |
| 21733 | |
| 21734 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
| 21735 | |
| 21736 | =over 4 |
| 21737 | |
| 21738 | =item SYNOPSIS |
| 21739 | |
| 21740 | =item DESCRIPTION |
| 21741 | |
| 21742 | =item EXAMPLE |
| 21743 | |
| 21744 | =back |
| 21745 | |
| 21746 | =head2 Text::Balanced - Extract delimited text sequences from strings. |
| 21747 | |
| 21748 | =over 4 |
| 21749 | |
| 21750 | =item SYNOPSIS |
| 21751 | |
| 21752 | =item DESCRIPTION |
| 21753 | |
| 21754 | =over 4 |
| 21755 | |
| 21756 | =item General behaviour in list contexts |
| 21757 | |
| 21758 | [0], [1], [2] |
| 21759 | |
| 21760 | =item General behaviour in scalar and void contexts |
| 21761 | |
| 21762 | =item A note about prefixes |
| 21763 | |
| 21764 | =item C<extract_delimited> |
| 21765 | |
| 21766 | =item C<extract_bracketed> |
| 21767 | |
| 21768 | =item C<extract_variable> |
| 21769 | |
| 21770 | [0], [1], [2] |
| 21771 | |
| 21772 | =item C<extract_tagged> |
| 21773 | |
| 21774 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, |
| 21775 | [0], [1], [2], [3], [4], [5] |
| 21776 | |
| 21777 | =item C<gen_extract_tagged> |
| 21778 | |
| 21779 | =item C<extract_quotelike> |
| 21780 | |
| 21781 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] |
| 21782 | |
| 21783 | =item C<extract_quotelike> and "here documents" |
| 21784 | |
| 21785 | [0], [1], [2], [3], [4], [5], [6], [7..10] |
| 21786 | |
| 21787 | =item C<extract_codeblock> |
| 21788 | |
| 21789 | =item C<extract_multiple> |
| 21790 | |
| 21791 | =item C<gen_delimited_pat> |
| 21792 | |
| 21793 | =back |
| 21794 | |
| 21795 | =item DIAGNOSTICS |
| 21796 | |
| 21797 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, |
| 21798 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike |
| 21799 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, |
| 21800 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, |
| 21801 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing |
| 21802 | bracket: expected "%c" but found "%s">, C<No block delimiter found after |
| 21803 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier |
| 21804 | after dereferencer>, C<Did not find expected opening bracket at %s>, |
| 21805 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike |
| 21806 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: |
| 21807 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid |
| 21808 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing |
| 21809 | tag> |
| 21810 | |
| 21811 | =item AUTHOR |
| 21812 | |
| 21813 | =item BUGS AND IRRITATIONS |
| 21814 | |
| 21815 | =item COPYRIGHT |
| 21816 | |
| 21817 | =back |
| 21818 | |
| 21819 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
| 21820 | arrays |
| 21821 | |
| 21822 | =over 4 |
| 21823 | |
| 21824 | =item SYNOPSIS |
| 21825 | |
| 21826 | =item DESCRIPTION |
| 21827 | |
| 21828 | =item EXAMPLES |
| 21829 | |
| 21830 | =item AUTHORS |
| 21831 | |
| 21832 | =back |
| 21833 | |
| 21834 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
| 21835 | by Knuth |
| 21836 | |
| 21837 | =over 4 |
| 21838 | |
| 21839 | =item SYNOPSIS |
| 21840 | |
| 21841 | =item DESCRIPTION |
| 21842 | |
| 21843 | =item EXAMPLES |
| 21844 | |
| 21845 | =item LIMITATIONS |
| 21846 | |
| 21847 | =item AUTHOR |
| 21848 | |
| 21849 | =back |
| 21850 | |
| 21851 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
| 21852 | unexpand(1) |
| 21853 | |
| 21854 | =over 4 |
| 21855 | |
| 21856 | =item SYNOPSIS |
| 21857 | |
| 21858 | =item DESCRIPTION |
| 21859 | |
| 21860 | =item BUGS |
| 21861 | |
| 21862 | =item LICENSE |
| 21863 | |
| 21864 | =back |
| 21865 | |
| 21866 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
| 21867 | |
| 21868 | =over 4 |
| 21869 | |
| 21870 | =item SYNOPSIS |
| 21871 | |
| 21872 | =item DESCRIPTION |
| 21873 | |
| 21874 | =item OVERRIDES |
| 21875 | |
| 21876 | =item EXAMPLE |
| 21877 | |
| 21878 | =item LICENSE |
| 21879 | |
| 21880 | =back |
| 21881 | |
| 21882 | =head2 Thread - manipulate threads in Perl (for old code only) |
| 21883 | |
| 21884 | =over 4 |
| 21885 | |
| 21886 | =item CAVEAT |
| 21887 | |
| 21888 | =item SYNOPSIS |
| 21889 | |
| 21890 | =item DESCRIPTION |
| 21891 | |
| 21892 | =item FUNCTIONS |
| 21893 | |
| 21894 | $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, |
| 21895 | LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, |
| 21896 | cond_signal VARIABLE, cond_broadcast VARIABLE, yield |
| 21897 | |
| 21898 | =item METHODS |
| 21899 | |
| 21900 | join, eval, detach, equal, tid, flags, done |
| 21901 | |
| 21902 | =item LIMITATIONS |
| 21903 | |
| 21904 | =item SEE ALSO |
| 21905 | |
| 21906 | =back |
| 21907 | |
| 21908 | =head2 Thread::Queue - thread-safe queues |
| 21909 | |
| 21910 | =over 4 |
| 21911 | |
| 21912 | =item SYNOPSIS |
| 21913 | |
| 21914 | =item DESCRIPTION |
| 21915 | |
| 21916 | =item FUNCTIONS AND METHODS |
| 21917 | |
| 21918 | new, enqueue LIST, dequeue, dequeue_nb, pending |
| 21919 | |
| 21920 | =item SEE ALSO |
| 21921 | |
| 21922 | =back |
| 21923 | |
| 21924 | =head2 Thread::Semaphore - thread-safe semaphores |
| 21925 | |
| 21926 | =over 4 |
| 21927 | |
| 21928 | =item SYNOPSIS |
| 21929 | |
| 21930 | =item DESCRIPTION |
| 21931 | |
| 21932 | =item FUNCTIONS AND METHODS |
| 21933 | |
| 21934 | new, new NUMBER, down, down NUMBER, up, up NUMBER |
| 21935 | |
| 21936 | =back |
| 21937 | |
| 21938 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
| 21939 | (for old code) |
| 21940 | |
| 21941 | =over 4 |
| 21942 | |
| 21943 | =item CAVEAT |
| 21944 | |
| 21945 | =item SYNOPSIS |
| 21946 | |
| 21947 | =item DESCRIPTION |
| 21948 | |
| 21949 | =item BUGS |
| 21950 | |
| 21951 | =back |
| 21952 | |
| 21953 | =head2 Thread::Specific - thread-specific keys |
| 21954 | |
| 21955 | =over 4 |
| 21956 | |
| 21957 | =item SYNOPSIS |
| 21958 | |
| 21959 | =item DESCRIPTION |
| 21960 | |
| 21961 | =back |
| 21962 | |
| 21963 | =head2 Tie::Array - base class for tied arrays |
| 21964 | |
| 21965 | =over 4 |
| 21966 | |
| 21967 | =item SYNOPSIS |
| 21968 | |
| 21969 | =item DESCRIPTION |
| 21970 | |
| 21971 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, |
| 21972 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
| 21973 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, |
| 21974 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST |
| 21975 | |
| 21976 | =item CAVEATS |
| 21977 | |
| 21978 | =item AUTHOR |
| 21979 | |
| 21980 | =back |
| 21981 | |
| 21982 | =head2 Tie::File - Access the lines of a disk file via a Perl array |
| 21983 | |
| 21984 | =over 4 |
| 21985 | |
| 21986 | =item SYNOPSIS |
| 21987 | |
| 21988 | =item DESCRIPTION |
| 21989 | |
| 21990 | =over 4 |
| 21991 | |
| 21992 | =item C<recsep> |
| 21993 | |
| 21994 | =item C<autochomp> |
| 21995 | |
| 21996 | =item C<mode> |
| 21997 | |
| 21998 | =item C<memory> |
| 21999 | |
| 22000 | =item C<dw_size> |
| 22001 | |
| 22002 | =item Option Format |
| 22003 | |
| 22004 | =back |
| 22005 | |
| 22006 | =item Public Methods |
| 22007 | |
| 22008 | =over 4 |
| 22009 | |
| 22010 | =item C<flock> |
| 22011 | |
| 22012 | =item C<autochomp> |
| 22013 | |
| 22014 | =item C<defer>, C<flush>, C<discard>, and C<autodefer> |
| 22015 | |
| 22016 | =item C<offset> |
| 22017 | |
| 22018 | =back |
| 22019 | |
| 22020 | =item Tying to an already-opened filehandle |
| 22021 | |
| 22022 | =item Deferred Writing |
| 22023 | |
| 22024 | =over 4 |
| 22025 | |
| 22026 | =item Autodeferring |
| 22027 | |
| 22028 | =back |
| 22029 | |
| 22030 | =item CONCURRENT ACCESS TO FILES |
| 22031 | |
| 22032 | =item CAVEATS |
| 22033 | |
| 22034 | =item SUBCLASSING |
| 22035 | |
| 22036 | =item WHAT ABOUT C<DB_File>? |
| 22037 | |
| 22038 | =item AUTHOR |
| 22039 | |
| 22040 | =item LICENSE |
| 22041 | |
| 22042 | =item WARRANTY |
| 22043 | |
| 22044 | =item THANKS |
| 22045 | |
| 22046 | =item TODO |
| 22047 | |
| 22048 | =back |
| 22049 | |
| 22050 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
| 22051 | handles |
| 22052 | |
| 22053 | =over 4 |
| 22054 | |
| 22055 | =item SYNOPSIS |
| 22056 | |
| 22057 | =item DESCRIPTION |
| 22058 | |
| 22059 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, |
| 22060 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, |
| 22061 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
| 22062 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this |
| 22063 | |
| 22064 | =item MORE INFORMATION |
| 22065 | |
| 22066 | =item COMPATIBILITY |
| 22067 | |
| 22068 | =back |
| 22069 | |
| 22070 | =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for |
| 22071 | tied hashes |
| 22072 | |
| 22073 | =over 4 |
| 22074 | |
| 22075 | =item SYNOPSIS |
| 22076 | |
| 22077 | =item DESCRIPTION |
| 22078 | |
| 22079 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
| 22080 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR |
| 22081 | this, SCALAR this |
| 22082 | |
| 22083 | =item Inheriting from B<Tie::StdHash> |
| 22084 | |
| 22085 | =item Inheriting from B<Tie::ExtraHash> |
| 22086 | |
| 22087 | =item C<SCALAR>, C<UNTIE> and C<DESTROY> |
| 22088 | |
| 22089 | =item MORE INFORMATION |
| 22090 | |
| 22091 | =back |
| 22092 | |
| 22093 | =head2 Tie::Memoize - add data to hash when needed |
| 22094 | |
| 22095 | =over 4 |
| 22096 | |
| 22097 | =item SYNOPSIS |
| 22098 | |
| 22099 | =item DESCRIPTION |
| 22100 | |
| 22101 | =item Inheriting from B<Tie::Memoize> |
| 22102 | |
| 22103 | =item EXAMPLE |
| 22104 | |
| 22105 | =item BUGS |
| 22106 | |
| 22107 | =item AUTHOR |
| 22108 | |
| 22109 | =back |
| 22110 | |
| 22111 | =head2 Tie::RefHash - use references as hash keys |
| 22112 | |
| 22113 | =over 4 |
| 22114 | |
| 22115 | =item SYNOPSIS |
| 22116 | |
| 22117 | =item DESCRIPTION |
| 22118 | |
| 22119 | =item EXAMPLE |
| 22120 | |
| 22121 | =item AUTHOR |
| 22122 | |
| 22123 | =item VERSION |
| 22124 | |
| 22125 | =item SEE ALSO |
| 22126 | |
| 22127 | =back |
| 22128 | |
| 22129 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
| 22130 | scalars |
| 22131 | |
| 22132 | =over 4 |
| 22133 | |
| 22134 | =item SYNOPSIS |
| 22135 | |
| 22136 | =item DESCRIPTION |
| 22137 | |
| 22138 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
| 22139 | |
| 22140 | =item MORE INFORMATION |
| 22141 | |
| 22142 | =back |
| 22143 | |
| 22144 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
| 22145 | |
| 22146 | =over 4 |
| 22147 | |
| 22148 | =item SYNOPSIS |
| 22149 | |
| 22150 | =item DESCRIPTION |
| 22151 | |
| 22152 | =item CAVEATS |
| 22153 | |
| 22154 | =back |
| 22155 | |
| 22156 | =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval |
| 22157 | timers |
| 22158 | |
| 22159 | =over 4 |
| 22160 | |
| 22161 | =item SYNOPSIS |
| 22162 | |
| 22163 | =item DESCRIPTION |
| 22164 | |
| 22165 | gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm ( |
| 22166 | $useconds [, $interval_useconds ] ), tv_interval, time (), sleep ( |
| 22167 | $floating_seconds ), alarm ( $floating_seconds [, |
| 22168 | $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [, |
| 22169 | $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime ( |
| 22170 | $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds, |
| 22171 | $flags = 0), clock() |
| 22172 | |
| 22173 | =item EXAMPLES |
| 22174 | |
| 22175 | =item C API |
| 22176 | |
| 22177 | =item DIAGNOSTICS |
| 22178 | |
| 22179 | =over 4 |
| 22180 | |
| 22181 | =item negative time not invented yet |
| 22182 | |
| 22183 | =item internal error: useconds < 0 (unsigned ... signed ...) |
| 22184 | |
| 22185 | =back |
| 22186 | |
| 22187 | =item CAVEATS |
| 22188 | |
| 22189 | =item SEE ALSO |
| 22190 | |
| 22191 | =item AUTHORS |
| 22192 | |
| 22193 | =item COPYRIGHT AND LICENSE |
| 22194 | |
| 22195 | =back |
| 22196 | |
| 22197 | =head2 Time::Local - efficiently compute time from local and GMT time |
| 22198 | |
| 22199 | =over 4 |
| 22200 | |
| 22201 | =item SYNOPSIS |
| 22202 | |
| 22203 | =item DESCRIPTION |
| 22204 | |
| 22205 | =over 4 |
| 22206 | |
| 22207 | =item Ambiguous Local Times (DST) |
| 22208 | |
| 22209 | =item Non-Existent Local Times (DST) |
| 22210 | |
| 22211 | =item Negative Epoch Values |
| 22212 | |
| 22213 | =back |
| 22214 | |
| 22215 | =item IMPLEMENTATION |
| 22216 | |
| 22217 | =item BUGS |
| 22218 | |
| 22219 | =item SUPPORT |
| 22220 | |
| 22221 | =item AUTHOR |
| 22222 | |
| 22223 | =back |
| 22224 | |
| 22225 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
| 22226 | function |
| 22227 | |
| 22228 | =over 4 |
| 22229 | |
| 22230 | =item SYNOPSIS |
| 22231 | |
| 22232 | =item DESCRIPTION |
| 22233 | |
| 22234 | =item NOTE |
| 22235 | |
| 22236 | =item AUTHOR |
| 22237 | |
| 22238 | =back |
| 22239 | |
| 22240 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
| 22241 | function |
| 22242 | |
| 22243 | =over 4 |
| 22244 | |
| 22245 | =item SYNOPSIS |
| 22246 | |
| 22247 | =item DESCRIPTION |
| 22248 | |
| 22249 | =item NOTE |
| 22250 | |
| 22251 | =item AUTHOR |
| 22252 | |
| 22253 | =back |
| 22254 | |
| 22255 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
| 22256 | |
| 22257 | =over 4 |
| 22258 | |
| 22259 | =item SYNOPSIS |
| 22260 | |
| 22261 | =item DESCRIPTION |
| 22262 | |
| 22263 | =item AUTHOR |
| 22264 | |
| 22265 | =back |
| 22266 | |
| 22267 | =head2 UNIVERSAL - base class for ALL classes (blessed references) |
| 22268 | |
| 22269 | =over 4 |
| 22270 | |
| 22271 | =item SYNOPSIS |
| 22272 | |
| 22273 | =item DESCRIPTION |
| 22274 | |
| 22275 | C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>, |
| 22276 | C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<< |
| 22277 | CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )> |
| 22278 | |
| 22279 | =item EXPORTS |
| 22280 | |
| 22281 | =back |
| 22282 | |
| 22283 | =head2 Unicode::Collate - Unicode Collation Algorithm |
| 22284 | |
| 22285 | =over 4 |
| 22286 | |
| 22287 | =item SYNOPSIS |
| 22288 | |
| 22289 | =item DESCRIPTION |
| 22290 | |
| 22291 | =over 4 |
| 22292 | |
| 22293 | =item Constructor and Tailoring |
| 22294 | |
| 22295 | UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar, |
| 22296 | ignoreName, katakana_before_hiragana, level, normalization, overrideCJK, |
| 22297 | overrideHangul, preprocess, rearrange, table, undefChar, undefName, |
| 22298 | upper_before_lower, variable |
| 22299 | |
| 22300 | =item Methods for Collation |
| 22301 | |
| 22302 | C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = |
| 22303 | $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, |
| 22304 | C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, |
| 22305 | $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = |
| 22306 | $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, |
| 22307 | C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm = |
| 22308 | $Collator-E<gt>viewSortKey($string)> |
| 22309 | |
| 22310 | =item Methods for Searching |
| 22311 | |
| 22312 | C<$position = $Collator-E<gt>index($string, $substring[, $position])>, |
| 22313 | C<($position, $length) = $Collator-E<gt>index($string, $substring[, |
| 22314 | $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>, |
| 22315 | C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match = |
| 22316 | $Collator-E<gt>gmatch($string, $substring)>, C<$count = |
| 22317 | $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count = |
| 22318 | $Collator-E<gt>gsubst($string, $substring, $replacement)> |
| 22319 | |
| 22320 | =item Other Methods |
| 22321 | |
| 22322 | C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version = |
| 22323 | $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()> |
| 22324 | |
| 22325 | =back |
| 22326 | |
| 22327 | =item EXPORT |
| 22328 | |
| 22329 | =item INSTALL |
| 22330 | |
| 22331 | =item CAVEATS |
| 22332 | |
| 22333 | Normalization, Conformance Test |
| 22334 | |
| 22335 | =item AUTHOR, COPYRIGHT AND LICENSE |
| 22336 | |
| 22337 | =item SEE ALSO |
| 22338 | |
| 22339 | Unicode Collation Algorithm - UTS #10, The Default Unicode Collation |
| 22340 | Element Table (DUCET), The conformance test for the UCA, Hangul Syllable |
| 22341 | Type, Unicode Normalization Forms - UAX #15 |
| 22342 | |
| 22343 | =back |
| 22344 | |
| 22345 | =head2 Unicode::Normalize - Unicode Normalization Forms |
| 22346 | |
| 22347 | =over 4 |
| 22348 | |
| 22349 | =item SYNOPSIS |
| 22350 | |
| 22351 | =item DESCRIPTION |
| 22352 | |
| 22353 | =over 4 |
| 22354 | |
| 22355 | =item Normalization Forms |
| 22356 | |
| 22357 | C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, |
| 22358 | C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, |
| 22359 | C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>, |
| 22360 | C<$normalized_string = normalize($form_name, $string)> |
| 22361 | |
| 22362 | =item Decomposition and Composition |
| 22363 | |
| 22364 | C<$decomposed_string = decompose($string)>, C<$decomposed_string = |
| 22365 | decompose($string, $useCompatMapping)>, C<$reordered_string = |
| 22366 | reorder($string)>, C<$composed_string = compose($string)> |
| 22367 | |
| 22368 | =item Quick Check |
| 22369 | |
| 22370 | C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = |
| 22371 | checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = |
| 22372 | checkFCD($string)>, C<$result = checkFCC($string)>, C<$result = |
| 22373 | check($form_name, $string)> |
| 22374 | |
| 22375 | =item Character Data |
| 22376 | |
| 22377 | C<$canonical_decomposed = getCanon($codepoint)>, |
| 22378 | C<$compatibility_decomposed = getCompat($codepoint)>, |
| 22379 | C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, |
| 22380 | C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = |
| 22381 | isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, |
| 22382 | C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, |
| 22383 | C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> |
| 22384 | |
| 22385 | =back |
| 22386 | |
| 22387 | =item EXPORT |
| 22388 | |
| 22389 | =item CAVEATS |
| 22390 | |
| 22391 | Perl's version vs. Unicode version, Correction of decomposition mapping, |
| 22392 | Revised definition of canonical composition |
| 22393 | |
| 22394 | =item AUTHOR |
| 22395 | |
| 22396 | =item SEE ALSO |
| 22397 | |
| 22398 | http://www.unicode.org/reports/tr15/, |
| 22399 | http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, |
| 22400 | http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt, |
| 22401 | http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/ |
| 22402 | |
| 22403 | =back |
| 22404 | |
| 22405 | =head2 Unicode::UCD - Unicode character database |
| 22406 | |
| 22407 | =over 4 |
| 22408 | |
| 22409 | =item SYNOPSIS |
| 22410 | |
| 22411 | =item DESCRIPTION |
| 22412 | |
| 22413 | =back |
| 22414 | |
| 22415 | =over 4 |
| 22416 | |
| 22417 | =item charinfo |
| 22418 | |
| 22419 | =back |
| 22420 | |
| 22421 | =over 4 |
| 22422 | |
| 22423 | =item charblock |
| 22424 | |
| 22425 | =back |
| 22426 | |
| 22427 | =over 4 |
| 22428 | |
| 22429 | =item charscript |
| 22430 | |
| 22431 | =back |
| 22432 | |
| 22433 | =over 4 |
| 22434 | |
| 22435 | =item charblocks |
| 22436 | |
| 22437 | =back |
| 22438 | |
| 22439 | =over 4 |
| 22440 | |
| 22441 | =item charscripts |
| 22442 | |
| 22443 | =back |
| 22444 | |
| 22445 | =over 4 |
| 22446 | |
| 22447 | =item Blocks versus Scripts |
| 22448 | |
| 22449 | =item Matching Scripts and Blocks |
| 22450 | |
| 22451 | =item Code Point Arguments |
| 22452 | |
| 22453 | =item charinrange |
| 22454 | |
| 22455 | =back |
| 22456 | |
| 22457 | =over 4 |
| 22458 | |
| 22459 | =item compexcl |
| 22460 | |
| 22461 | =back |
| 22462 | |
| 22463 | =over 4 |
| 22464 | |
| 22465 | =item casefold |
| 22466 | |
| 22467 | =back |
| 22468 | |
| 22469 | =over 4 |
| 22470 | |
| 22471 | =item casespec |
| 22472 | |
| 22473 | =back |
| 22474 | |
| 22475 | =over 4 |
| 22476 | |
| 22477 | =item namedseq() |
| 22478 | |
| 22479 | =back |
| 22480 | |
| 22481 | =over 4 |
| 22482 | |
| 22483 | =item Unicode::UCD::UnicodeVersion |
| 22484 | |
| 22485 | =back |
| 22486 | |
| 22487 | =over 4 |
| 22488 | |
| 22489 | =item Implementation Note |
| 22490 | |
| 22491 | =back |
| 22492 | |
| 22493 | =over 4 |
| 22494 | |
| 22495 | =item BUGS |
| 22496 | |
| 22497 | =item AUTHOR |
| 22498 | |
| 22499 | =back |
| 22500 | |
| 22501 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
| 22502 | functions |
| 22503 | |
| 22504 | =over 4 |
| 22505 | |
| 22506 | =item SYNOPSIS |
| 22507 | |
| 22508 | =item DESCRIPTION |
| 22509 | |
| 22510 | =item NOTE |
| 22511 | |
| 22512 | =item AUTHOR |
| 22513 | |
| 22514 | =back |
| 22515 | |
| 22516 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
| 22517 | functions |
| 22518 | |
| 22519 | =over 4 |
| 22520 | |
| 22521 | =item SYNOPSIS |
| 22522 | |
| 22523 | =item DESCRIPTION |
| 22524 | |
| 22525 | =over 4 |
| 22526 | |
| 22527 | =item System Specifics |
| 22528 | |
| 22529 | =back |
| 22530 | |
| 22531 | =item NOTE |
| 22532 | |
| 22533 | =item AUTHOR |
| 22534 | |
| 22535 | =item HISTORY |
| 22536 | |
| 22537 | March 18th, 2000 |
| 22538 | |
| 22539 | =back |
| 22540 | |
| 22541 | =head2 XSLoader - Dynamically load C libraries into Perl code |
| 22542 | |
| 22543 | =over 4 |
| 22544 | |
| 22545 | =item VERSION |
| 22546 | |
| 22547 | =item SYNOPSIS |
| 22548 | |
| 22549 | =item DESCRIPTION |
| 22550 | |
| 22551 | =over 4 |
| 22552 | |
| 22553 | =item Migration from C<DynaLoader> |
| 22554 | |
| 22555 | =item Backward compatible boilerplate |
| 22556 | |
| 22557 | =back |
| 22558 | |
| 22559 | =item Order of initialization: early load() |
| 22560 | |
| 22561 | =over 4 |
| 22562 | |
| 22563 | =item The most hairy case |
| 22564 | |
| 22565 | =back |
| 22566 | |
| 22567 | =item DIAGNOSTICS |
| 22568 | |
| 22569 | Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined |
| 22570 | symbols present after loading %s: %s, XSLoader::load('Your::Module', |
| 22571 | $Your::Module::VERSION) |
| 22572 | |
| 22573 | =item LIMITATIONS |
| 22574 | |
| 22575 | =item BUGS |
| 22576 | |
| 22577 | =item SEE ALSO |
| 22578 | |
| 22579 | =item AUTHORS |
| 22580 | |
| 22581 | =item COPYRIGHT |
| 22582 | |
| 22583 | =back |
| 22584 | |
| 22585 | =head1 AUXILIARY DOCUMENTATION |
| 22586 | |
| 22587 | Here should be listed all the extra programs' documentation, but they |
| 22588 | don't all have manual pages yet: |
| 22589 | |
| 22590 | =over 4 |
| 22591 | |
| 22592 | =item a2p |
| 22593 | |
| 22594 | =item c2ph |
| 22595 | |
| 22596 | =item dprofpp |
| 22597 | |
| 22598 | =item h2ph |
| 22599 | |
| 22600 | =item h2xs |
| 22601 | |
| 22602 | =item perlbug |
| 22603 | |
| 22604 | =item perldoc |
| 22605 | |
| 22606 | =item pl2pm |
| 22607 | |
| 22608 | =item pod2html |
| 22609 | |
| 22610 | =item pod2man |
| 22611 | |
| 22612 | =item s2p |
| 22613 | |
| 22614 | =item splain |
| 22615 | |
| 22616 | =item xsubpp |
| 22617 | |
| 22618 | =back |
| 22619 | |
| 22620 | =head1 AUTHOR |
| 22621 | |
| 22622 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
| 22623 | of other folks. |
| 22624 | |