Commit | Line | Data |
---|---|---|
cb1a09d0 | 1 | |
d53e588d JH |
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. | |
d53e588d | 5 | |
cb1a09d0 AD |
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 | |
28757baa | 13 | documentation set. It is meant to be scanned quickly or grepped |
402d0d99 | 14 | through to locate the proper section you're looking for. |
cb1a09d0 AD |
15 | |
16 | =head1 BASIC DOCUMENTATION | |
17 | ||
cb1a09d0 AD |
18 | =head2 perl - Practical Extraction and Report Language |
19 | ||
d420ca49 | 20 | =over 4 |
a45bd81d | 21 | |
cb1a09d0 AD |
22 | =item SYNOPSIS |
23 | ||
69fba242 JH |
24 | =over 4 |
25 | ||
26 | =item Overview | |
27 | ||
28 | =item Tutorials | |
29 | ||
cb52f95f JH |
30 | =item Reference Manual |
31 | ||
69fba242 JH |
32 | =item Internals and C Language Interface |
33 | ||
34 | =item Miscellaneous | |
35 | ||
d8416318 JH |
36 | =item Language-Specific |
37 | ||
69fba242 JH |
38 | =item Platform-Specific |
39 | ||
40 | =back | |
41 | ||
cb1a09d0 AD |
42 | =item DESCRIPTION |
43 | ||
14218588 | 44 | =item AVAILABILITY |
cb1a09d0 AD |
45 | |
46 | =item ENVIRONMENT | |
47 | ||
cb1a09d0 AD |
48 | =item AUTHOR |
49 | ||
cb1a09d0 AD |
50 | =item FILES |
51 | ||
cb1a09d0 AD |
52 | =item SEE ALSO |
53 | ||
cb1a09d0 AD |
54 | =item DIAGNOSTICS |
55 | ||
cb1a09d0 AD |
56 | =item BUGS |
57 | ||
cb1a09d0 AD |
58 | =item NOTES |
59 | ||
a45bd81d GS |
60 | =back |
61 | ||
10151d09 JH |
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 | ||
41630250 | 110 | =head2 perlreftut - Mark's very short tutorial about references |
68dc0745 | 111 | |
d420ca49 | 112 | =over 4 |
a45bd81d | 113 | |
68dc0745 | 114 | =item DESCRIPTION |
115 | ||
41630250 JH |
116 | =item Who Needs Complicated Data Structures? |
117 | ||
118 | =item The Solution | |
119 | ||
120 | =item Syntax | |
121 | ||
983dbef6 | 122 | =over 4 |
68dc0745 | 123 | |
41630250 | 124 | =item Making References |
68dc0745 | 125 | |
41630250 | 126 | =item Using References |
68dc0745 | 127 | |
41630250 JH |
128 | =item An Example |
129 | ||
130 | =item Arrow Rule | |
68dc0745 | 131 | |
2a551100 | 132 | =back |
68dc0745 | 133 | |
41630250 | 134 | =item Solution |
68dc0745 | 135 | |
41630250 JH |
136 | =item The Rest |
137 | ||
138 | =item Summary | |
139 | ||
140 | =item Credits | |
68dc0745 | 141 | |
2a551100 | 142 | =over 4 |
68dc0745 | 143 | |
41630250 | 144 | =item Distribution Conditions |
68dc0745 | 145 | |
41630250 | 146 | =back |
68dc0745 | 147 | |
a45bd81d GS |
148 | =back |
149 | ||
41630250 | 150 | =head2 perldsc - Perl Data Structures Cookbook |
68dc0745 | 151 | |
41630250 | 152 | =over 4 |
a45bd81d | 153 | |
41630250 | 154 | =item DESCRIPTION |
68dc0745 | 155 | |
41630250 JH |
156 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
157 | more elaborate constructs | |
68dc0745 | 158 | |
41630250 | 159 | =item REFERENCES |
68dc0745 | 160 | |
41630250 | 161 | =item COMMON MISTAKES |
68dc0745 | 162 | |
41630250 | 163 | =item CAVEAT ON PRECEDENCE |
68dc0745 | 164 | |
41630250 | 165 | =item WHY YOU SHOULD ALWAYS C<use strict> |
68dc0745 | 166 | |
41630250 | 167 | =item DEBUGGING |
983dbef6 | 168 | |
41630250 | 169 | =item CODE EXAMPLES |
983dbef6 | 170 | |
41630250 | 171 | =item ARRAYS OF ARRAYS |
68dc0745 | 172 | |
41630250 | 173 | =over 4 |
68dc0745 | 174 | |
41630250 | 175 | =item Declaration of an ARRAY OF ARRAYS |
983dbef6 | 176 | |
41630250 JH |
177 | =item Generation of an ARRAY OF ARRAYS |
178 | ||
179 | =item Access and Printing of an ARRAY OF ARRAYS | |
983dbef6 | 180 | |
4755096e | 181 | =back |
68dc0745 | 182 | |
41630250 | 183 | =item HASHES OF ARRAYS |
68dc0745 | 184 | |
d420ca49 | 185 | =over 4 |
68dc0745 | 186 | |
41630250 JH |
187 | =item Declaration of a HASH OF ARRAYS |
188 | ||
189 | =item Generation of a HASH OF ARRAYS | |
190 | ||
191 | =item Access and Printing of a HASH OF ARRAYS | |
68dc0745 | 192 | |
a45bd81d GS |
193 | =back |
194 | ||
41630250 | 195 | =item ARRAYS OF HASHES |
a45bd81d | 196 | |
d420ca49 | 197 | =over 4 |
68dc0745 | 198 | |
41630250 | 199 | =item Declaration of an ARRAY OF HASHES |
68dc0745 | 200 | |
41630250 | 201 | =item Generation of an ARRAY OF HASHES |
68dc0745 | 202 | |
41630250 | 203 | =item Access and Printing of an ARRAY OF HASHES |
68dc0745 | 204 | |
41630250 | 205 | =back |
0d53b15f | 206 | |
41630250 | 207 | =item HASHES OF HASHES |
68dc0745 | 208 | |
41630250 | 209 | =over 4 |
3fe9a6f1 | 210 | |
41630250 | 211 | =item Declaration of a HASH OF HASHES |
68dc0745 | 212 | |
41630250 | 213 | =item Generation of a HASH OF HASHES |
68dc0745 | 214 | |
41630250 | 215 | =item Access and Printing of a HASH OF HASHES |
68dc0745 | 216 | |
41630250 | 217 | =back |
68dc0745 | 218 | |
41630250 | 219 | =item MORE ELABORATE RECORDS |
68dc0745 | 220 | |
41630250 | 221 | =over 4 |
68dc0745 | 222 | |
41630250 JH |
223 | =item Declaration of MORE ELABORATE RECORDS |
224 | ||
225 | =item Declaration of a HASH OF COMPLEX RECORDS | |
226 | ||
227 | =item Generation of a HASH OF COMPLEX RECORDS | |
68dc0745 | 228 | |
4755096e | 229 | =back |
68dc0745 | 230 | |
41630250 JH |
231 | =item Database Ties |
232 | ||
233 | =item SEE ALSO | |
234 | ||
235 | =item AUTHOR | |
236 | ||
4755096e | 237 | =back |
193fb0af | 238 | |
41630250 | 239 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
68dc0745 | 240 | |
d420ca49 | 241 | =over 4 |
68dc0745 | 242 | |
4755096e | 243 | =item DESCRIPTION |
68dc0745 | 244 | |
d420ca49 | 245 | =over 4 |
68dc0745 | 246 | |
41630250 | 247 | =item Declaration and Access of Arrays of Arrays |
4755096e | 248 | |
41630250 | 249 | =item Growing Your Own |
4755096e | 250 | |
41630250 | 251 | =item Access and Printing |
8b9c797b | 252 | |
4755096e GS |
253 | =item Slices |
254 | ||
68dc0745 | 255 | =back |
256 | ||
4755096e | 257 | =item SEE ALSO |
68dc0745 | 258 | |
41630250 JH |
259 | =item AUTHOR |
260 | ||
a45bd81d GS |
261 | =back |
262 | ||
41630250 | 263 | =head2 perlrequick - Perl regular expressions quick start |
68dc0745 | 264 | |
d420ca49 | 265 | =over 4 |
a45bd81d | 266 | |
68dc0745 | 267 | =item DESCRIPTION |
268 | ||
41630250 JH |
269 | =item The Guide |
270 | ||
d420ca49 | 271 | =over 4 |
68dc0745 | 272 | |
41630250 | 273 | =item Simple word matching |
68dc0745 | 274 | |
41630250 | 275 | =item Using character classes |
68dc0745 | 276 | |
41630250 | 277 | =item Matching this or that |
68dc0745 | 278 | |
41630250 | 279 | =item Grouping things and hierarchical matching |
68dc0745 | 280 | |
41630250 | 281 | =item Extracting matches |
68dc0745 | 282 | |
41630250 | 283 | =item Matching repetitions |
68dc0745 | 284 | |
41630250 | 285 | =item More matching |
68dc0745 | 286 | |
41630250 | 287 | =item Search and replace |
68dc0745 | 288 | |
41630250 | 289 | =item The split operator |
14218588 | 290 | |
41630250 | 291 | =back |
68dc0745 | 292 | |
41630250 | 293 | =item BUGS |
68dc0745 | 294 | |
41630250 | 295 | =item SEE ALSO |
68dc0745 | 296 | |
41630250 | 297 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 298 | |
41630250 | 299 | =over 4 |
68dc0745 | 300 | |
41630250 | 301 | =item Acknowledgments |
68dc0745 | 302 | |
41630250 | 303 | =back |
68dc0745 | 304 | |
41630250 | 305 | =back |
2a551100 | 306 | |
41630250 | 307 | =head2 perlretut - Perl regular expressions tutorial |
68dc0745 | 308 | |
41630250 | 309 | =over 4 |
68dc0745 | 310 | |
41630250 | 311 | =item DESCRIPTION |
68dc0745 | 312 | |
41630250 | 313 | =item Part 1: The basics |
68dc0745 | 314 | |
41630250 | 315 | =over 4 |
68dc0745 | 316 | |
41630250 | 317 | =item Simple word matching |
68dc0745 | 318 | |
41630250 | 319 | =item Using character classes |
14218588 | 320 | |
41630250 | 321 | =item Matching this or that |
68dc0745 | 322 | |
41630250 | 323 | =item Grouping things and hierarchical matching |
68dc0745 | 324 | |
41630250 | 325 | =item Extracting matches |
68dc0745 | 326 | |
41630250 | 327 | =item Matching repetitions |
68dc0745 | 328 | |
41630250 | 329 | =item Building a regexp |
68dc0745 | 330 | |
41630250 | 331 | =item Using regular expressions in Perl |
68dc0745 | 332 | |
41630250 | 333 | =back |
68dc0745 | 334 | |
41630250 | 335 | =item Part 2: Power tools |
68dc0745 | 336 | |
41630250 | 337 | =over 4 |
68dc0745 | 338 | |
41630250 | 339 | =item More on characters, strings, and character classes |
68dc0745 | 340 | |
41630250 | 341 | =item Compiling and saving regular expressions |
4755096e | 342 | |
41630250 | 343 | =item Embedding comments and modifiers in a regular expression |
4755096e | 344 | |
41630250 | 345 | =item Non-capturing groupings |
4755096e | 346 | |
41630250 | 347 | =item Looking ahead and looking behind |
68dc0745 | 348 | |
41630250 | 349 | =item Using independent subexpressions to prevent backtracking |
a45bd81d | 350 | |
41630250 | 351 | =item Conditional expressions |
4755096e | 352 | |
41630250 | 353 | =item A bit of magic: executing Perl code in a regular expression |
c2e66d9e | 354 | |
41630250 | 355 | =item Pragmas and debugging |
c2e66d9e | 356 | |
41630250 | 357 | =back |
c2e66d9e | 358 | |
41630250 | 359 | =item BUGS |
c2e66d9e | 360 | |
41630250 | 361 | =item SEE ALSO |
c2e66d9e | 362 | |
41630250 | 363 | =item AUTHOR AND COPYRIGHT |
c2e66d9e | 364 | |
41630250 | 365 | =over 4 |
c2e66d9e | 366 | |
41630250 | 367 | =item Acknowledgments |
c2e66d9e | 368 | |
41630250 | 369 | =back |
c2e66d9e | 370 | |
41630250 | 371 | =back |
23be5fc4 | 372 | |
41630250 | 373 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
c2e66d9e | 374 | |
41630250 | 375 | =over 4 |
c2e66d9e | 376 | |
41630250 | 377 | =item DESCRIPTION |
c2e66d9e | 378 | |
41630250 | 379 | =over 4 |
c2e66d9e | 380 | |
41630250 | 381 | =item If we could talk to the animals... |
c2e66d9e | 382 | |
41630250 | 383 | =item Introducing the method invocation arrow |
c2e66d9e | 384 | |
41630250 | 385 | =item Invoking a barnyard |
c2e66d9e | 386 | |
41630250 | 387 | =item The extra parameter of method invocation |
c2e66d9e | 388 | |
41630250 | 389 | =item Calling a second method to simplify things |
c2e66d9e | 390 | |
41630250 | 391 | =item Inheriting the windpipes |
c2e66d9e | 392 | |
41630250 | 393 | =item A few notes about @ISA |
c2e66d9e | 394 | |
41630250 | 395 | =item Overriding the methods |
c2e66d9e | 396 | |
41630250 | 397 | =item Starting the search from a different place |
c2e66d9e | 398 | |
41630250 | 399 | =item The SUPER way of doing things |
c2e66d9e | 400 | |
41630250 | 401 | =item Where we're at so far... |
c2e66d9e | 402 | |
41630250 | 403 | =item A horse is a horse, of course of course -- or is it? |
c2e66d9e | 404 | |
41630250 | 405 | =item Invoking an instance method |
c2e66d9e | 406 | |
41630250 | 407 | =item Accessing the instance data |
c2e66d9e | 408 | |
41630250 | 409 | =item How to build a horse |
c2e66d9e | 410 | |
41630250 | 411 | =item Inheriting the constructor |
c2e66d9e | 412 | |
41630250 | 413 | =item Making a method work with either classes or instances |
c2e66d9e | 414 | |
41630250 | 415 | =item Adding parameters to a method |
68dc0745 | 416 | |
41630250 | 417 | =item More interesting instances |
a45bd81d | 418 | |
41630250 | 419 | =item A horse of a different color |
68dc0745 | 420 | |
41630250 | 421 | =item Summary |
4755096e | 422 | |
41630250 | 423 | =back |
4755096e | 424 | |
41630250 | 425 | =item SEE ALSO |
68dc0745 | 426 | |
41630250 | 427 | =item COPYRIGHT |
68dc0745 | 428 | |
41630250 | 429 | =back |
46fc3d4c | 430 | |
41630250 | 431 | =head2 perltoot - Tom's object-oriented tutorial for perl |
68dc0745 | 432 | |
41630250 | 433 | =over 4 |
68dc0745 | 434 | |
41630250 | 435 | =item DESCRIPTION |
14218588 | 436 | |
41630250 | 437 | =item Creating a Class |
2a551100 | 438 | |
41630250 | 439 | =over 4 |
68dc0745 | 440 | |
41630250 | 441 | =item Object Representation |
68dc0745 | 442 | |
41630250 | 443 | =item Class Interface |
68dc0745 | 444 | |
41630250 | 445 | =item Constructors and Instance Methods |
4755096e | 446 | |
41630250 | 447 | =item Planning for the Future: Better Constructors |
4755096e | 448 | |
41630250 | 449 | =item Destructors |
68dc0745 | 450 | |
41630250 | 451 | =item Other Object Methods |
68dc0745 | 452 | |
4755096e GS |
453 | =back |
454 | ||
41630250 | 455 | =item Class Data |
68dc0745 | 456 | |
d420ca49 | 457 | =over 4 |
68dc0745 | 458 | |
41630250 | 459 | =item Accessing Class Data |
68dc0745 | 460 | |
41630250 | 461 | =item Debugging Methods |
68dc0745 | 462 | |
41630250 | 463 | =item Class Destructors |
68dc0745 | 464 | |
41630250 | 465 | =item Documenting the Interface |
14218588 | 466 | |
41630250 | 467 | =back |
68dc0745 | 468 | |
41630250 | 469 | =item Aggregation |
68dc0745 | 470 | |
41630250 | 471 | =item Inheritance |
68dc0745 | 472 | |
d420ca49 | 473 | =over 4 |
68dc0745 | 474 | |
41630250 | 475 | =item Overridden Methods |
68dc0745 | 476 | |
41630250 | 477 | =item Multiple Inheritance |
68dc0745 | 478 | |
41630250 | 479 | =item UNIVERSAL: The Root of All Objects |
68dc0745 | 480 | |
4755096e | 481 | =back |
68dc0745 | 482 | |
41630250 | 483 | =item Alternate Object Representations |
68dc0745 | 484 | |
d420ca49 | 485 | =over 4 |
68dc0745 | 486 | |
41630250 | 487 | =item Arrays as Objects |
68dc0745 | 488 | |
41630250 | 489 | =item Closures as Objects |
68dc0745 | 490 | |
4755096e | 491 | =back |
68dc0745 | 492 | |
41630250 | 493 | =item AUTOLOAD: Proxy Methods |
68dc0745 | 494 | |
d420ca49 | 495 | =over 4 |
68dc0745 | 496 | |
41630250 | 497 | =item Autoloaded Data Methods |
68dc0745 | 498 | |
41630250 | 499 | =item Inherited Autoloaded Data Methods |
14218588 | 500 | |
4755096e | 501 | =back |
68dc0745 | 502 | |
41630250 | 503 | =item Metaclassical Tools |
68dc0745 | 504 | |
d420ca49 | 505 | =over 4 |
68dc0745 | 506 | |
41630250 | 507 | =item Class::Struct |
68dc0745 | 508 | |
41630250 | 509 | =item Data Members as Variables |
68dc0745 | 510 | |
511 | =back | |
512 | ||
41630250 | 513 | =item NOTES |
68dc0745 | 514 | |
d420ca49 | 515 | =over 4 |
68dc0745 | 516 | |
41630250 | 517 | =item Object Terminology |
14218588 | 518 | |
41630250 | 519 | =back |
68dc0745 | 520 | |
41630250 | 521 | =item SEE ALSO |
68dc0745 | 522 | |
41630250 | 523 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 524 | |
41630250 | 525 | =item COPYRIGHT |
68dc0745 | 526 | |
41630250 | 527 | =over 4 |
68dc0745 | 528 | |
41630250 | 529 | =item Acknowledgments |
14218588 | 530 | |
4755096e | 531 | =back |
68dc0745 | 532 | |
41630250 JH |
533 | =back |
534 | ||
535 | =head2 perltooc - Tom's OO Tutorial for Class Data in Perl | |
68dc0745 | 536 | |
d420ca49 | 537 | =over 4 |
68dc0745 | 538 | |
4755096e | 539 | =item DESCRIPTION |
68dc0745 | 540 | |
41630250 JH |
541 | =item Class Data in a Can |
542 | ||
543 | =item Class Data as Package Variables | |
68dc0745 | 544 | |
d420ca49 | 545 | =over 4 |
68dc0745 | 546 | |
41630250 | 547 | =item Putting All Your Eggs in One Basket |
68dc0745 | 548 | |
41630250 | 549 | =item Inheritance Concerns |
68dc0745 | 550 | |
41630250 | 551 | =item The Eponymous Meta-Object |
68dc0745 | 552 | |
41630250 | 553 | =item Indirect References to Class Data |
68dc0745 | 554 | |
41630250 | 555 | =item Monadic Classes |
68dc0745 | 556 | |
41630250 | 557 | =item Translucent Attributes |
68dc0745 | 558 | |
41630250 | 559 | =back |
68dc0745 | 560 | |
41630250 | 561 | =item Class Data as Lexical Variables |
68dc0745 | 562 | |
41630250 | 563 | =over 4 |
68dc0745 | 564 | |
41630250 | 565 | =item Privacy and Responsibility |
68dc0745 | 566 | |
41630250 | 567 | =item File-Scoped Lexicals |
68dc0745 | 568 | |
41630250 | 569 | =item More Inheritance Concerns |
68dc0745 | 570 | |
41630250 | 571 | =item Locking the Door and Throwing Away the Key |
68dc0745 | 572 | |
41630250 | 573 | =item Translucency Revisited |
14218588 | 574 | |
68dc0745 | 575 | =back |
576 | ||
41630250 JH |
577 | =item NOTES |
578 | ||
579 | =item SEE ALSO | |
580 | ||
581 | =item AUTHOR AND COPYRIGHT | |
582 | ||
583 | =item ACKNOWLEDGEMENTS | |
584 | ||
585 | =item HISTORY | |
586 | ||
a45bd81d GS |
587 | =back |
588 | ||
41630250 | 589 | =head2 perlbot - Bag'o Object Tricks (the BOT) |
68dc0745 | 590 | |
d420ca49 | 591 | =over 4 |
a45bd81d | 592 | |
68dc0745 | 593 | =item DESCRIPTION |
594 | ||
41630250 | 595 | =item OO SCALING TIPS |
68dc0745 | 596 | |
41630250 | 597 | =item INSTANCE VARIABLES |
8a93676d | 598 | |
41630250 | 599 | =item SCALAR INSTANCE VARIABLES |
68dc0745 | 600 | |
41630250 | 601 | =item INSTANCE VARIABLE INHERITANCE |
68dc0745 | 602 | |
41630250 | 603 | =item OBJECT RELATIONSHIPS |
8a93676d | 604 | |
41630250 | 605 | =item OVERRIDING SUPERCLASS METHODS |
8a93676d | 606 | |
41630250 | 607 | =item USING RELATIONSHIP WITH SDBM |
68dc0745 | 608 | |
41630250 | 609 | =item THINKING OF CODE REUSE |
68dc0745 | 610 | |
41630250 | 611 | =item CLASS CONTEXT AND THE OBJECT |
68dc0745 | 612 | |
41630250 | 613 | =item INHERITING A CONSTRUCTOR |
8a93676d | 614 | |
41630250 | 615 | =item DELEGATION |
8a93676d SB |
616 | |
617 | =item SEE ALSO | |
618 | ||
c2e66d9e | 619 | =back |
68dc0745 | 620 | |
41630250 | 621 | =head2 perlstyle - Perl style guide |
8a93676d SB |
622 | |
623 | =over 4 | |
624 | ||
625 | =item DESCRIPTION | |
626 | ||
41630250 | 627 | =back |
8a93676d | 628 | |
41630250 | 629 | =head2 perlcheat - Perl 5 Cheat Sheet |
8a93676d | 630 | |
41630250 | 631 | =over 4 |
8a93676d | 632 | |
41630250 | 633 | =item DESCRIPTION |
8a93676d | 634 | |
41630250 | 635 | =over 4 |
68dc0745 | 636 | |
41630250 | 637 | =item The sheet |
68dc0745 | 638 | |
c2e66d9e | 639 | =back |
68dc0745 | 640 | |
41630250 | 641 | =item ACKNOWLEDGEMENTS |
68dc0745 | 642 | |
41630250 | 643 | =item AUTHOR |
c2e66d9e | 644 | |
41630250 | 645 | =item SEE ALSO |
68dc0745 | 646 | |
4755096e | 647 | =back |
68dc0745 | 648 | |
c2e66d9e | 649 | =head2 perltrap - Perl traps for the unwary |
68dc0745 | 650 | |
d420ca49 | 651 | =over 4 |
68dc0745 | 652 | |
c2e66d9e | 653 | =item DESCRIPTION |
68dc0745 | 654 | |
d420ca49 | 655 | =over 4 |
68dc0745 | 656 | |
c2e66d9e | 657 | =item Awk Traps |
68dc0745 | 658 | |
8b9c797b | 659 | =item C/C++ Traps |
4755096e | 660 | |
c2e66d9e | 661 | =item Sed Traps |
4755096e | 662 | |
c2e66d9e | 663 | =item Shell Traps |
4755096e | 664 | |
c2e66d9e | 665 | =item Perl Traps |
68dc0745 | 666 | |
c2e66d9e | 667 | =item Perl4 to Perl5 Traps |
68dc0745 | 668 | |
c2e66d9e GS |
669 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
670 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
671 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
672 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
673 | ||
674 | =item Discontinuance, Deprecation, and BugFix traps | |
675 | ||
676 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, | |
677 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
678 | Discontinuance, Deprecation, Discontinuance, Discontinuance | |
679 | ||
680 | =item Parsing Traps | |
681 | ||
07fcf8ff | 682 | Parsing, Parsing, Parsing, Parsing, Parsing |
c2e66d9e GS |
683 | |
684 | =item Numerical Traps | |
685 | ||
686 | Numerical, Numerical, Numerical, Bitwise string ops | |
687 | ||
688 | =item General data type traps | |
689 | ||
690 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), | |
691 | (Constants), (Scalars), (Variable Suicide) | |
692 | ||
693 | =item Context Traps - scalar, list contexts | |
694 | ||
695 | (list context), (scalar context), (scalar context), (list, builtin) | |
696 | ||
697 | =item Precedence Traps | |
698 | ||
699 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, | |
700 | Precedence | |
701 | ||
702 | =item General Regular Expression Traps using s///, etc. | |
703 | ||
704 | Regular Expression, Regular Expression, Regular Expression, Regular | |
705 | Expression, Regular Expression, Regular Expression, Regular Expression, | |
0d53b15f | 706 | Regular Expression, Regular Expression |
c2e66d9e GS |
707 | |
708 | =item Subroutine, Signal, Sorting Traps | |
709 | ||
710 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle | |
711 | ||
712 | =item OS Traps | |
713 | ||
714 | (SysV), (SysV) | |
715 | ||
716 | =item Interpolation Traps | |
717 | ||
718 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, | |
719 | Interpolation, Interpolation, Interpolation, Interpolation | |
720 | ||
721 | =item DBM Traps | |
722 | ||
723 | DBM, DBM | |
724 | ||
725 | =item Unclassified Traps | |
726 | ||
727 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
728 | LIMIT specified | |
68dc0745 | 729 | |
4755096e | 730 | =back |
68dc0745 | 731 | |
c2e66d9e | 732 | =back |
14218588 | 733 | |
41630250 | 734 | =head2 perldebtut - Perl debugging tutorial |
e969ef56 JH |
735 | |
736 | =over 4 | |
737 | ||
738 | =item DESCRIPTION | |
739 | ||
41630250 | 740 | =item use strict |
e969ef56 | 741 | |
41630250 | 742 | =item Looking at data and -w and v |
e969ef56 | 743 | |
41630250 | 744 | =item help |
e969ef56 | 745 | |
41630250 | 746 | =item Stepping through code |
e969ef56 | 747 | |
41630250 | 748 | =item Placeholder for a, w, t, T |
e969ef56 | 749 | |
41630250 | 750 | =item REGULAR EXPRESSIONS |
e969ef56 | 751 | |
41630250 | 752 | =item OUTPUT TIPS |
e969ef56 | 753 | |
41630250 | 754 | =item CGI |
68dc0745 | 755 | |
41630250 | 756 | =item GUIs |
c2e66d9e | 757 | |
41630250 | 758 | =item SUMMARY |
c2e66d9e | 759 | |
41630250 | 760 | =item SEE ALSO |
68dc0745 | 761 | |
41630250 | 762 | =item AUTHOR |
68dc0745 | 763 | |
41630250 | 764 | =item CONTRIBUTORS |
c2e66d9e | 765 | |
41630250 | 766 | =back |
c2e66d9e | 767 | |
e4bb216d NC |
768 | =head2 perlfaq - frequently asked questions about Perl ($Date: 2004/10/05 |
769 | 22:15:44 $) | |
c2e66d9e | 770 | |
41630250 | 771 | =over 4 |
c2e66d9e | 772 | |
41630250 | 773 | =item DESCRIPTION |
68dc0745 | 774 | |
41630250 | 775 | =over 4 |
68dc0745 | 776 | |
41630250 | 777 | =item Where to get the perlfaq |
c2e66d9e | 778 | |
41630250 JH |
779 | =item How to contribute to the perlfaq |
780 | ||
781 | =item What will happen if you mail your Perl programming problems to the | |
782 | authors | |
c2e66d9e | 783 | |
e993db8c JH |
784 | =back |
785 | ||
41630250 JH |
786 | =item Credits |
787 | ||
788 | =item Author and Copyright Information | |
e993db8c JH |
789 | |
790 | =over 4 | |
c2e66d9e | 791 | |
41630250 JH |
792 | =item Bundled Distributions |
793 | ||
794 | =item Disclaimer | |
ff426ff2 | 795 | |
4755096e | 796 | =back |
68dc0745 | 797 | |
41630250 | 798 | =item Table of Contents |
68dc0745 | 799 | |
41630250 JH |
800 | perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2 |
801 | - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4 | |
802 | - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular | |
803 | Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System | |
804 | Interaction, perlfaq9 - Networking | |
68dc0745 | 805 | |
41630250 | 806 | =item The Questions |
68dc0745 | 807 | |
d420ca49 | 808 | =over 4 |
68dc0745 | 809 | |
41630250 | 810 | =item L<perlfaq1>: General Questions About Perl |
68dc0745 | 811 | |
41630250 | 812 | =item L<perlfaq2>: Obtaining and Learning about Perl |
a45bd81d | 813 | |
41630250 | 814 | =item L<perlfaq3>: Programming Tools |
68dc0745 | 815 | |
41630250 | 816 | =item L<perlfaq4>: Data Manipulation |
a45bd81d | 817 | |
41630250 | 818 | =item L<perlfaq5>: Files and Formats |
68dc0745 | 819 | |
41630250 | 820 | =item L<perlfaq6>: Regular Expressions |
68dc0745 | 821 | |
41630250 | 822 | =item L<perlfaq7>: General Perl Language Issues |
68dc0745 | 823 | |
41630250 | 824 | =item L<perlfaq8>: System Interaction |
68dc0745 | 825 | |
41630250 | 826 | =item L<perlfaq9>: Networking |
68dc0745 | 827 | |
41630250 | 828 | =back |
68dc0745 | 829 | |
4755096e | 830 | =back |
68dc0745 | 831 | |
e4bb216d NC |
832 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.15 $, $Date: |
833 | 2004/10/11 05:06:29 $) | |
10862624 | 834 | |
d420ca49 | 835 | =over 4 |
10862624 RF |
836 | |
837 | =item DESCRIPTION | |
838 | ||
41630250 | 839 | =over 4 |
10862624 | 840 | |
41630250 | 841 | =item What is Perl? |
d396a558 | 842 | |
41630250 | 843 | =item Who supports Perl? Who develops it? Why is it free? |
10862624 | 844 | |
41630250 | 845 | =item Which version of Perl should I use? |
10862624 | 846 | |
41630250 | 847 | =item What are perl4 and perl5? |
10862624 | 848 | |
41630250 | 849 | =item What is Ponie? |
10862624 | 850 | |
41630250 | 851 | =item What is perl6? |
10862624 | 852 | |
41630250 | 853 | =item How stable is Perl? |
10862624 | 854 | |
41630250 | 855 | =item Is Perl difficult to learn? |
10862624 | 856 | |
41630250 JH |
857 | =item How does Perl compare with other languages like Java, Python, REXX, |
858 | Scheme, or Tcl? | |
10862624 | 859 | |
41630250 | 860 | =item Can I do [task] in Perl? |
10862624 | 861 | |
41630250 | 862 | =item When shouldn't I program in Perl? |
10862624 | 863 | |
41630250 JH |
864 | =item What's the difference between "perl" and "Perl"? |
865 | ||
866 | =item Is it a Perl program or a Perl script? | |
867 | ||
868 | =item What is a JAPH? | |
869 | ||
870 | =item Where can I get a list of Larry Wall witticisms? | |
871 | ||
872 | =item How can I convince my sysadmin/supervisor/employees to use version | |
873 | 5/5.6.1/Perl instead of some other language? | |
10862624 RF |
874 | |
875 | =back | |
876 | ||
41630250 JH |
877 | =item AUTHOR AND COPYRIGHT |
878 | ||
879 | =back | |
880 | ||
e4bb216d NC |
881 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.29 $, |
882 | $Date: 2004/10/25 18:37:23 $) | |
68dc0745 | 883 | |
d420ca49 | 884 | =over 4 |
68dc0745 | 885 | |
4755096e | 886 | =item DESCRIPTION |
68dc0745 | 887 | |
d420ca49 | 888 | =over 4 |
68dc0745 | 889 | |
41630250 | 890 | =item What machines support Perl? Where do I get it? |
68dc0745 | 891 | |
41630250 | 892 | =item How can I get a binary version of Perl? |
68dc0745 | 893 | |
41630250 | 894 | =item I don't have a C compiler on my system. How can I compile perl? |
68dc0745 | 895 | |
41630250 JH |
896 | =item I copied the Perl binary from one machine to another, but scripts |
897 | don't work. | |
68dc0745 | 898 | |
41630250 JH |
899 | =item I grabbed the sources and tried to compile but gdbm/dynamic |
900 | loading/malloc/linking/... failed. How do I make it work? | |
68dc0745 | 901 | |
41630250 JH |
902 | =item What modules and extensions are available for Perl? What is CPAN? |
903 | What does CPAN/src/... mean? | |
68dc0745 | 904 | |
41630250 | 905 | =item Is there an ISO or ANSI certified version of Perl? |
68dc0745 | 906 | |
41630250 | 907 | =item Where can I get information on Perl? |
68dc0745 | 908 | |
41630250 | 909 | =item What are the Perl newsgroups on Usenet? Where do I post questions? |
68dc0745 | 910 | |
41630250 | 911 | =item Where should I post source code? |
68dc0745 | 912 | |
41630250 | 913 | =item Perl Books |
68dc0745 | 914 | |
41630250 | 915 | References, Tutorials, Task-Oriented, Special Topics |
68dc0745 | 916 | |
41630250 | 917 | =item Perl in Magazines |
68dc0745 | 918 | |
41630250 | 919 | =item Perl on the Net: FTP and WWW Access |
14218588 | 920 | |
41630250 | 921 | =item What mailing lists are there for Perl? |
68dc0745 | 922 | |
41630250 JH |
923 | =item Archives of comp.lang.perl.misc |
924 | ||
925 | =item Where can I buy a commercial version of Perl? | |
926 | ||
927 | =item Where do I send bug reports? | |
928 | ||
929 | =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? | |
68dc0745 | 930 | |
a45bd81d GS |
931 | =back |
932 | ||
41630250 JH |
933 | =item AUTHOR AND COPYRIGHT |
934 | ||
935 | =back | |
936 | ||
e4bb216d NC |
937 | =head2 perlfaq3 - Programming Tools ($Revision: 1.41 $, $Date: 2004/11/03 |
938 | 22:45:32 $) | |
68dc0745 | 939 | |
d420ca49 | 940 | =over 4 |
a45bd81d | 941 | |
68dc0745 | 942 | =item DESCRIPTION |
943 | ||
d420ca49 | 944 | =over 4 |
68dc0745 | 945 | |
41630250 | 946 | =item How do I do (anything)? |
68dc0745 | 947 | |
41630250 | 948 | =item How can I use Perl interactively? |
68dc0745 | 949 | |
41630250 | 950 | =item Is there a Perl shell? |
68dc0745 | 951 | |
41630250 | 952 | =item How do I find which modules are installed on my system? |
4755096e | 953 | |
41630250 | 954 | =item How do I debug my Perl programs? |
c2e66d9e | 955 | |
41630250 | 956 | =item How do I profile my Perl programs? |
4755096e | 957 | |
41630250 | 958 | =item How do I cross-reference my Perl programs? |
4755096e | 959 | |
41630250 | 960 | =item Is there a pretty-printer (formatter) for Perl? |
4755096e | 961 | |
41630250 | 962 | =item Is there a ctags for Perl? |
c2e66d9e | 963 | |
41630250 | 964 | =item Is there an IDE or Windows Perl Editor? |
c2e66d9e | 965 | |
e4bb216d NC |
966 | Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual |
967 | Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, | |
968 | MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and | |
969 | BBEdit Lite | |
4d4e713d | 970 | |
41630250 | 971 | =item Where can I get Perl macros for vi? |
c2e66d9e | 972 | |
41630250 | 973 | =item Where can I get perl-mode for emacs? |
c2e66d9e | 974 | |
41630250 | 975 | =item How can I use curses with Perl? |
c2e66d9e | 976 | |
41630250 | 977 | =item How can I use X or Tk with Perl? |
c2e66d9e | 978 | |
41630250 | 979 | =item How can I generate simple menus without using CGI or Tk? |
4d4e713d | 980 | |
41630250 | 981 | =item How can I make my Perl program run faster? |
c2e66d9e | 982 | |
41630250 | 983 | =item How can I make my Perl program take less memory? |
4755096e | 984 | |
41630250 JH |
985 | Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and |
986 | stringification, Pass by reference, Tie large variables to disk | |
4755096e | 987 | |
41630250 | 988 | =item Is it safe to return a reference to local or lexical data? |
4755096e | 989 | |
41630250 | 990 | =item How can I free an array or hash so my program shrinks? |
4755096e | 991 | |
41630250 | 992 | =item How can I make my CGI script more efficient? |
4755096e | 993 | |
41630250 | 994 | =item How can I hide the source for my Perl program? |
c2e66d9e | 995 | |
41630250 | 996 | =item How can I compile my Perl program into byte code or C? |
4755096e | 997 | |
41630250 | 998 | =item How can I compile Perl into Java? |
4755096e | 999 | |
41630250 | 1000 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? |
2a551100 | 1001 | |
41630250 | 1002 | =item Can I write useful Perl programs on the command line? |
4755096e | 1003 | |
41630250 | 1004 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? |
4755096e | 1005 | |
41630250 | 1006 | =item Where can I learn about CGI or Web programming in Perl? |
4755096e | 1007 | |
41630250 | 1008 | =item Where can I learn about object-oriented Perl programming? |
4755096e | 1009 | |
41630250 | 1010 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] |
4755096e | 1011 | |
41630250 JH |
1012 | =item I've read perlembed, perlguts, etc., but I can't embed perl in |
1013 | my C program; what am I doing wrong? | |
4755096e | 1014 | |
41630250 | 1015 | =item When I tried to run my script, I got this message. What does it mean? |
4755096e | 1016 | |
41630250 | 1017 | =item What's MakeMaker? |
4755096e GS |
1018 | |
1019 | =back | |
1020 | ||
41630250 JH |
1021 | =item AUTHOR AND COPYRIGHT |
1022 | ||
1023 | =back | |
1024 | ||
e4bb216d NC |
1025 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.56 $, $Date: 2004/11/03 |
1026 | 22:47:56 $) | |
4755096e | 1027 | |
d420ca49 | 1028 | =over 4 |
4755096e | 1029 | |
41630250 | 1030 | =item DESCRIPTION |
4755096e | 1031 | |
41630250 | 1032 | =item Data: Numbers |
4755096e | 1033 | |
41630250 | 1034 | =over 4 |
4755096e | 1035 | |
41630250 JH |
1036 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the |
1037 | numbers I should be getting (eg, 19.95)? | |
4755096e | 1038 | |
5538b230 JH |
1039 | =item Why is int() broken? |
1040 | ||
41630250 | 1041 | =item Why isn't my octal data interpreted correctly? |
4755096e | 1042 | |
41630250 JH |
1043 | =item Does Perl have a round() function? What about ceil() and floor()? |
1044 | Trig functions? | |
4755096e | 1045 | |
5538b230 | 1046 | =item How do I convert between numeric representations/bases/radixes? |
4755096e | 1047 | |
41630250 JH |
1048 | How do I convert hexadecimal into decimal, How do I convert from decimal to |
1049 | hexadecimal, How do I convert from octal to decimal, How do I convert from | |
1050 | decimal to octal, How do I convert from binary to decimal, How do I convert | |
1051 | from decimal to binary | |
4755096e | 1052 | |
41630250 | 1053 | =item Why doesn't & work the way I want it to? |
4755096e | 1054 | |
41630250 | 1055 | =item How do I multiply matrices? |
2a551100 | 1056 | |
41630250 | 1057 | =item How do I perform an operation on a series of integers? |
2a551100 | 1058 | |
41630250 | 1059 | =item How can I output Roman numerals? |
4755096e | 1060 | |
41630250 | 1061 | =item Why aren't my random numbers random? |
4755096e | 1062 | |
41630250 | 1063 | =item How do I get a random number between X and Y? |
a9d2c496 | 1064 | |
4755096e GS |
1065 | =back |
1066 | ||
41630250 | 1067 | =item Data: Dates |
4755096e | 1068 | |
41630250 | 1069 | =over 4 |
4755096e | 1070 | |
41630250 | 1071 | =item How do I find the day or week of the year? |
4755096e | 1072 | |
d53e588d JH |
1073 | =item How do I find the current century or millennium? |
1074 | ||
41630250 | 1075 | =item How can I compare two dates and find the difference? |
4755096e | 1076 | |
41630250 | 1077 | =item How can I take a string and turn it into epoch seconds? |
34babc16 | 1078 | |
41630250 | 1079 | =item How can I find the Julian Day? |
34babc16 | 1080 | |
41630250 | 1081 | =item How do I find yesterday's date? |
34babc16 | 1082 | |
41630250 | 1083 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? |
34babc16 | 1084 | |
41630250 | 1085 | =back |
34babc16 | 1086 | |
41630250 | 1087 | =item Data: Strings |
34babc16 JH |
1088 | |
1089 | =over 4 | |
1090 | ||
41630250 | 1091 | =item How do I validate input? |
34babc16 | 1092 | |
41630250 | 1093 | =item How do I unescape a string? |
34babc16 | 1094 | |
41630250 | 1095 | =item How do I remove consecutive pairs of characters? |
34babc16 | 1096 | |
41630250 | 1097 | =item How do I expand function calls in a string? |
34babc16 | 1098 | |
41630250 | 1099 | =item How do I find matching/nesting anything? |
34babc16 | 1100 | |
41630250 | 1101 | =item How do I reverse a string? |
34babc16 | 1102 | |
41630250 | 1103 | =item How do I expand tabs in a string? |
34babc16 | 1104 | |
41630250 | 1105 | =item How do I reformat a paragraph? |
34babc16 | 1106 | |
41630250 | 1107 | =item How can I access or change N characters of a string? |
34babc16 | 1108 | |
41630250 | 1109 | =item How do I change the Nth occurrence of something? |
34babc16 | 1110 | |
41630250 JH |
1111 | =item How can I count the number of occurrences of a substring within a |
1112 | string? | |
34babc16 | 1113 | |
41630250 | 1114 | =item How do I capitalize all the words on one line? |
493a87da | 1115 | |
41630250 JH |
1116 | =item How can I split a [character] delimited string except when inside |
1117 | [character]? | |
34babc16 | 1118 | |
41630250 | 1119 | =item How do I strip blank space from the beginning/end of a string? |
2a551100 | 1120 | |
41630250 | 1121 | =item How do I pad a string with blanks or pad a number with zeroes? |
34babc16 | 1122 | |
41630250 | 1123 | =item How do I extract selected columns from a string? |
34babc16 | 1124 | |
41630250 | 1125 | =item How do I find the soundex value of a string? |
34babc16 | 1126 | |
41630250 | 1127 | =item How can I expand variables in text strings? |
34babc16 | 1128 | |
41630250 JH |
1129 | =item What's wrong with always quoting "$vars"? |
1130 | ||
1131 | =item Why don't my E<lt>E<lt>HERE documents work? | |
1132 | ||
1133 | There must be no space after the E<lt>E<lt> part, There (probably) should | |
1134 | be a semicolon at the end, You can't (easily) have any space in front of | |
1135 | the tag | |
2a551100 | 1136 | |
34babc16 JH |
1137 | =back |
1138 | ||
41630250 | 1139 | =item Data: Arrays |
34babc16 JH |
1140 | |
1141 | =over 4 | |
1142 | ||
41630250 | 1143 | =item What is the difference between a list and an array? |
34babc16 | 1144 | |
41630250 | 1145 | =item What is the difference between $array[1] and @array[1]? |
34babc16 | 1146 | |
41630250 | 1147 | =item How can I remove duplicate elements from a list or array? |
34babc16 | 1148 | |
41630250 | 1149 | a), b), c), d), e) |
34babc16 | 1150 | |
41630250 JH |
1151 | =item How can I tell whether a certain element is contained in a list or |
1152 | array? | |
4755096e | 1153 | |
41630250 JH |
1154 | =item How do I compute the difference of two arrays? How do I compute the |
1155 | intersection of two arrays? | |
4755096e | 1156 | |
41630250 | 1157 | =item How do I test whether two arrays or hashes are equal? |
4755096e | 1158 | |
41630250 | 1159 | =item How do I find the first array element for which a condition is true? |
4755096e | 1160 | |
41630250 | 1161 | =item How do I handle linked lists? |
4755096e | 1162 | |
41630250 | 1163 | =item How do I handle circular lists? |
4755096e | 1164 | |
41630250 | 1165 | =item How do I shuffle an array randomly? |
4755096e | 1166 | |
41630250 | 1167 | =item How do I process/modify each element of an array? |
4755096e | 1168 | |
41630250 | 1169 | =item How do I select a random element from an array? |
4755096e | 1170 | |
41630250 | 1171 | =item How do I permute N elements of a list? |
4755096e | 1172 | |
41630250 | 1173 | =item How do I sort an array by (anything)? |
4755096e | 1174 | |
41630250 | 1175 | =item How do I manipulate arrays of bits? |
4755096e | 1176 | |
41630250 | 1177 | =item Why does defined() return true on empty arrays and hashes? |
4755096e | 1178 | |
c2e66d9e | 1179 | =back |
4755096e | 1180 | |
41630250 | 1181 | =item Data: Hashes (Associative Arrays) |
4755096e | 1182 | |
d420ca49 | 1183 | =over 4 |
4755096e | 1184 | |
41630250 | 1185 | =item How do I process an entire hash? |
4755096e | 1186 | |
41630250 JH |
1187 | =item What happens if I add or remove keys from a hash while iterating over |
1188 | it? | |
4755096e | 1189 | |
41630250 | 1190 | =item How do I look up a hash element by value? |
4755096e | 1191 | |
41630250 | 1192 | =item How can I know how many entries are in a hash? |
4755096e | 1193 | |
41630250 | 1194 | =item How do I sort a hash (optionally by value instead of key)? |
4755096e | 1195 | |
41630250 | 1196 | =item How can I always keep my hash sorted? |
4755096e | 1197 | |
41630250 | 1198 | =item What's the difference between "delete" and "undef" with hashes? |
4755096e | 1199 | |
41630250 | 1200 | =item Why don't my tied hashes make the defined/exists distinction? |
4755096e | 1201 | |
41630250 | 1202 | =item How do I reset an each() operation part-way through? |
4755096e | 1203 | |
41630250 | 1204 | =item How can I get the unique keys from two hashes? |
4755096e | 1205 | |
41630250 | 1206 | =item How can I store a multidimensional array in a DBM file? |
4755096e | 1207 | |
41630250 | 1208 | =item How can I make my hash remember the order I put elements into it? |
4755096e | 1209 | |
41630250 JH |
1210 | =item Why does passing a subroutine an undefined element in a hash create |
1211 | it? | |
4755096e | 1212 | |
41630250 JH |
1213 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or |
1214 | array of hashes or arrays? | |
4755096e | 1215 | |
41630250 | 1216 | =item How can I use a reference as a hash key? |
4755096e | 1217 | |
4755096e GS |
1218 | =back |
1219 | ||
41630250 | 1220 | =item Data: Misc |
4755096e | 1221 | |
d420ca49 | 1222 | =over 4 |
4755096e | 1223 | |
41630250 | 1224 | =item How do I handle binary data correctly? |
4755096e | 1225 | |
41630250 | 1226 | =item How do I determine whether a scalar is a number/whole/integer/float? |
4755096e | 1227 | |
41630250 | 1228 | =item How do I keep persistent data across program calls? |
4755096e | 1229 | |
41630250 | 1230 | =item How do I print out or copy a recursive data structure? |
c2e66d9e | 1231 | |
41630250 | 1232 | =item How do I define methods for every class/object? |
c2e66d9e | 1233 | |
41630250 | 1234 | =item How do I verify a credit card checksum? |
c2e66d9e | 1235 | |
41630250 | 1236 | =item How do I pack arrays of doubles or floats for XS code? |
4755096e GS |
1237 | |
1238 | =back | |
1239 | ||
41630250 | 1240 | =item AUTHOR AND COPYRIGHT |
4755096e | 1241 | |
c2e66d9e GS |
1242 | =back |
1243 | ||
e4bb216d NC |
1244 | =head2 perlfaq5 - Files and Formats ($Revision: 1.31 $, $Date: 2004/02/07 |
1245 | 04:29:50 $) | |
30487ceb RGS |
1246 | |
1247 | =over 4 | |
1248 | ||
1249 | =item DESCRIPTION | |
1250 | ||
e969ef56 JH |
1251 | =over 4 |
1252 | ||
41630250 | 1253 | =item How do I flush/unbuffer an output filehandle? Why must I do this? |
30487ceb | 1254 | |
41630250 JH |
1255 | =item How do I change one line in a file/delete a line in a file/insert a |
1256 | line in the middle of a file/append to the beginning of a file? | |
30487ceb | 1257 | |
41630250 | 1258 | =item How do I count the number of lines in a file? |
30487ceb | 1259 | |
41630250 | 1260 | =item How can I use Perl's C<-i> option from within a program? |
30487ceb | 1261 | |
41630250 | 1262 | =item How do I make a temporary file name? |
30487ceb | 1263 | |
41630250 | 1264 | =item How can I manipulate fixed-record-length files? |
30487ceb | 1265 | |
41630250 JH |
1266 | =item How can I make a filehandle local to a subroutine? How do I pass |
1267 | filehandles between subroutines? How do I make an array of filehandles? | |
e969ef56 | 1268 | |
41630250 | 1269 | =item How can I use a filehandle indirectly? |
e969ef56 | 1270 | |
41630250 | 1271 | =item How can I set up a footer format to be used with write()? |
30487ceb | 1272 | |
41630250 | 1273 | =item How can I write() into a string? |
30487ceb | 1274 | |
41630250 | 1275 | =item How can I output my numbers with commas added? |
30487ceb | 1276 | |
41630250 | 1277 | =item How can I translate tildes (~) in a filename? |
30487ceb | 1278 | |
41630250 | 1279 | =item How come when I open a file read-write it wipes it out? |
d396a558 | 1280 | |
41630250 JH |
1281 | =item Why do I sometimes get an "Argument list too long" when I use |
1282 | E<lt>*E<gt>? | |
d396a558 | 1283 | |
41630250 | 1284 | =item Is there a leak/bug in glob()? |
d396a558 | 1285 | |
41630250 | 1286 | =item How can I open a file with a leading ">" or trailing blanks? |
d396a558 | 1287 | |
41630250 | 1288 | =item How can I reliably rename a file? |
d396a558 | 1289 | |
41630250 | 1290 | =item How can I lock a file? |
d396a558 | 1291 | |
41630250 | 1292 | =item Why can't I just open(FH, "E<gt>file.lock")? |
d396a558 | 1293 | |
41630250 JH |
1294 | =item I still don't get locking. I just want to increment the number in |
1295 | the file. How can I do this? | |
d396a558 | 1296 | |
41630250 JH |
1297 | =item All I want to do is append a small amount of text to the end of a |
1298 | file. Do I still have to use locking? | |
d396a558 | 1299 | |
41630250 | 1300 | =item How do I randomly update a binary file? |
d396a558 | 1301 | |
41630250 | 1302 | =item How do I get a file's timestamp in perl? |
d396a558 | 1303 | |
41630250 | 1304 | =item How do I set a file's timestamp in perl? |
d396a558 | 1305 | |
41630250 | 1306 | =item How do I print to more than one file at once? |
d396a558 | 1307 | |
41630250 | 1308 | =item How can I read in an entire file all at once? |
d396a558 | 1309 | |
41630250 | 1310 | =item How can I read in a file by paragraphs? |
d396a558 | 1311 | |
41630250 | 1312 | =item How can I read a single character from a file? From the keyboard? |
4755096e | 1313 | |
41630250 | 1314 | =item How can I tell whether there's a character waiting on a filehandle? |
4755096e | 1315 | |
41630250 | 1316 | =item How do I do a C<tail -f> in perl? |
4755096e | 1317 | |
41630250 | 1318 | =item How do I dup() a filehandle in Perl? |
4755096e | 1319 | |
41630250 | 1320 | =item How do I close a file descriptor by number? |
4755096e | 1321 | |
41630250 JH |
1322 | =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't |
1323 | `C:\temp\foo.exe` work? | |
4755096e | 1324 | |
41630250 | 1325 | =item Why doesn't glob("*.*") get all the files? |
4755096e | 1326 | |
41630250 JH |
1327 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber |
1328 | protected files? Isn't this a bug in Perl? | |
c2e66d9e | 1329 | |
41630250 | 1330 | =item How do I select a random line from a file? |
c2e66d9e | 1331 | |
41630250 | 1332 | =item Why do I get weird spaces when I print an array of lines? |
4755096e GS |
1333 | |
1334 | =back | |
1335 | ||
41630250 | 1336 | =item AUTHOR AND COPYRIGHT |
4755096e GS |
1337 | |
1338 | =back | |
1339 | ||
e4bb216d NC |
1340 | =head2 perlfaq6 - Regular Expressions ($Revision: 1.27 $, $Date: 2004/11/03 |
1341 | 22:52:16 $) | |
4755096e | 1342 | |
d420ca49 | 1343 | =over 4 |
4755096e GS |
1344 | |
1345 | =item DESCRIPTION | |
1346 | ||
d420ca49 | 1347 | =over 4 |
c2e66d9e | 1348 | |
41630250 JH |
1349 | =item How can I hope to use regular expressions without creating illegible |
1350 | and unmaintainable code? | |
d396a558 | 1351 | |
41630250 | 1352 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters |
d396a558 | 1353 | |
41630250 | 1354 | =item I'm having trouble matching over more than one line. What's wrong? |
d396a558 | 1355 | |
41630250 JH |
1356 | =item How can I pull out lines between two patterns that are themselves on |
1357 | different lines? | |
d396a558 | 1358 | |
41630250 | 1359 | =item I put a regular expression into $/ but it didn't work. What's wrong? |
d396a558 | 1360 | |
41630250 JH |
1361 | =item How do I substitute case insensitively on the LHS while preserving |
1362 | case on the RHS? | |
d396a558 | 1363 | |
41630250 | 1364 | =item How can I make C<\w> match national character sets? |
d396a558 | 1365 | |
41630250 | 1366 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? |
d396a558 | 1367 | |
41630250 | 1368 | =item How can I quote a variable to use in a regex? |
d396a558 | 1369 | |
41630250 | 1370 | =item What is C</o> really for? |
d396a558 | 1371 | |
41630250 JH |
1372 | =item How do I use a regular expression to strip C style comments from a |
1373 | file? | |
d396a558 | 1374 | |
41630250 | 1375 | =item Can I use Perl regular expressions to match balanced text? |
d396a558 | 1376 | |
41630250 | 1377 | =item What does it mean that regexes are greedy? How can I get around it? |
d396a558 | 1378 | |
41630250 | 1379 | =item How do I process each word on each line? |
d396a558 | 1380 | |
41630250 | 1381 | =item How can I print out a word-frequency or line-frequency summary? |
d396a558 | 1382 | |
41630250 | 1383 | =item How can I do approximate matching? |
d396a558 | 1384 | |
41630250 | 1385 | =item How do I efficiently match many regular expressions at once? |
d396a558 | 1386 | |
41630250 | 1387 | =item Why don't word-boundary searches with C<\b> work for me? |
d396a558 | 1388 | |
41630250 | 1389 | =item Why does using $&, $`, or $' slow my program down? |
d396a558 | 1390 | |
41630250 | 1391 | =item What good is C<\G> in a regular expression? |
d396a558 | 1392 | |
41630250 | 1393 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? |
d396a558 | 1394 | |
1e54db1a | 1395 | =item What's wrong with using grep in a void context? |
d396a558 | 1396 | |
41630250 | 1397 | =item How can I match strings with multibyte characters? |
d396a558 | 1398 | |
41630250 | 1399 | =item How do I match a pattern that is supplied by the user? |
d396a558 JH |
1400 | |
1401 | =back | |
1402 | ||
41630250 JH |
1403 | =item AUTHOR AND COPYRIGHT |
1404 | ||
1405 | =back | |
1406 | ||
e4bb216d NC |
1407 | =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.18 $, $Date: |
1408 | 2004/11/03 22:54:08 $) | |
c2e66d9e | 1409 | |
d420ca49 | 1410 | =over 4 |
4755096e | 1411 | |
d396a558 | 1412 | =item DESCRIPTION |
4755096e | 1413 | |
d420ca49 | 1414 | =over 4 |
4755096e | 1415 | |
41630250 | 1416 | =item Can I get a BNF/yacc/RE for the Perl language? |
4755096e | 1417 | |
41630250 JH |
1418 | =item What are all these $@%&* punctuation signs, and how do I know when to |
1419 | use them? | |
4755096e | 1420 | |
41630250 JH |
1421 | =item Do I always/never have to quote my strings or use semicolons and |
1422 | commas? | |
c2e66d9e | 1423 | |
41630250 | 1424 | =item How do I skip some return values? |
c2e66d9e | 1425 | |
41630250 | 1426 | =item How do I temporarily block warnings? |
c2e66d9e | 1427 | |
41630250 | 1428 | =item What's an extension? |
4755096e | 1429 | |
41630250 | 1430 | =item Why do Perl operators have different precedence than C operators? |
4755096e | 1431 | |
41630250 | 1432 | =item How do I declare/create a structure? |
4755096e | 1433 | |
41630250 | 1434 | =item How do I create a module? |
4755096e | 1435 | |
41630250 | 1436 | =item How do I create a class? |
4755096e | 1437 | |
41630250 | 1438 | =item How can I tell if a variable is tainted? |
4755096e | 1439 | |
41630250 | 1440 | =item What's a closure? |
4755096e | 1441 | |
41630250 | 1442 | =item What is variable suicide and how can I prevent it? |
4755096e | 1443 | |
41630250 JH |
1444 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
1445 | Regex}? | |
4755096e | 1446 | |
41630250 JH |
1447 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
1448 | Passing Methods | |
d396a558 | 1449 | |
41630250 | 1450 | =item How do I create a static variable? |
d396a558 | 1451 | |
41630250 JH |
1452 | =item What's the difference between dynamic and lexical (static) scoping? |
1453 | Between local() and my()? | |
d396a558 | 1454 | |
41630250 JH |
1455 | =item How can I access a dynamic variable while a similarly named lexical |
1456 | is in scope? | |
d396a558 | 1457 | |
41630250 | 1458 | =item What's the difference between deep and shallow binding? |
d396a558 | 1459 | |
41630250 | 1460 | =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right? |
4755096e | 1461 | |
41630250 | 1462 | =item How do I redefine a builtin function, operator, or method? |
4755096e | 1463 | |
41630250 | 1464 | =item What's the difference between calling a function as &foo and foo()? |
4755096e | 1465 | |
41630250 | 1466 | =item How do I create a switch or case statement? |
4755096e | 1467 | |
41630250 JH |
1468 | =item How can I catch accesses to undefined variables, functions, or |
1469 | methods? | |
4755096e | 1470 | |
41630250 | 1471 | =item Why can't a method included in this same file be found? |
d396a558 | 1472 | |
41630250 | 1473 | =item How can I find out my current package? |
d396a558 | 1474 | |
41630250 | 1475 | =item How can I comment out a large block of perl code? |
d396a558 | 1476 | |
41630250 | 1477 | =item How do I clear a package? |
d396a558 | 1478 | |
41630250 | 1479 | =item How can I use a variable as a variable name? |
d396a558 | 1480 | |
41630250 | 1481 | =item What does "bad interpreter" mean? |
d396a558 JH |
1482 | |
1483 | =back | |
1484 | ||
41630250 JH |
1485 | =item AUTHOR AND COPYRIGHT |
1486 | ||
1487 | =back | |
1488 | ||
e4bb216d NC |
1489 | =head2 perlfaq8 - System Interaction ($Revision: 1.22 $, $Date: 2004/10/05 |
1490 | 22:13:49 $) | |
d396a558 | 1491 | |
d420ca49 | 1492 | =over 4 |
d396a558 | 1493 | |
41630250 | 1494 | =item DESCRIPTION |
d396a558 | 1495 | |
41630250 | 1496 | =over 4 |
4755096e | 1497 | |
41630250 | 1498 | =item How do I find out which operating system I'm running under? |
d420ca49 | 1499 | |
41630250 | 1500 | =item How come exec() doesn't return? |
4755096e | 1501 | |
41630250 | 1502 | =item How do I do fancy stuff with the keyboard/screen/mouse? |
d420ca49 | 1503 | |
41630250 | 1504 | Keyboard, Screen, Mouse |
d396a558 | 1505 | |
41630250 | 1506 | =item How do I print something out in color? |
d396a558 | 1507 | |
41630250 | 1508 | =item How do I read just one key without waiting for a return key? |
d396a558 | 1509 | |
41630250 | 1510 | =item How do I check whether input is ready on the keyboard? |
d396a558 | 1511 | |
41630250 | 1512 | =item How do I clear the screen? |
d396a558 | 1513 | |
41630250 | 1514 | =item How do I get the screen size? |
c2e66d9e | 1515 | |
41630250 | 1516 | =item How do I ask the user for a password? |
c2e66d9e | 1517 | |
41630250 | 1518 | =item How do I read and write the serial port? |
c2e66d9e | 1519 | |
41630250 | 1520 | lockfiles, open mode, end of line, flushing output, non-blocking input |
c2e66d9e | 1521 | |
41630250 | 1522 | =item How do I decode encrypted password files? |
c2e66d9e | 1523 | |
41630250 | 1524 | =item How do I start a process in the background? |
c2e66d9e | 1525 | |
41630250 | 1526 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
c2e66d9e | 1527 | |
41630250 | 1528 | =item How do I trap control characters/signals? |
dc5c060f | 1529 | |
41630250 | 1530 | =item How do I modify the shadow password file on a Unix system? |
d396a558 | 1531 | |
41630250 | 1532 | =item How do I set the time and date? |
d396a558 | 1533 | |
41630250 | 1534 | =item How can I sleep() or alarm() for under a second? |
d396a558 | 1535 | |
41630250 | 1536 | =item How can I measure time under a second? |
d396a558 | 1537 | |
41630250 | 1538 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) |
d396a558 | 1539 | |
41630250 JH |
1540 | =item Why doesn't my sockets program work under System V (Solaris)? What |
1541 | does the error message "Protocol not supported" mean? | |
d396a558 | 1542 | |
41630250 | 1543 | =item How can I call my system's unique C functions from Perl? |
d396a558 | 1544 | |
41630250 | 1545 | =item Where do I get the include files to do ioctl() or syscall()? |
4755096e | 1546 | |
41630250 | 1547 | =item Why do setuid perl scripts complain about kernel problems? |
4755096e | 1548 | |
41630250 | 1549 | =item How can I open a pipe both to and from a command? |
4755096e | 1550 | |
41630250 | 1551 | =item Why can't I get the output of a command with system()? |
4755096e | 1552 | |
41630250 | 1553 | =item How can I capture STDERR from an external command? |
d396a558 | 1554 | |
41630250 | 1555 | =item Why doesn't open() return an error when a pipe open fails? |
d396a558 | 1556 | |
41630250 | 1557 | =item What's wrong with using backticks in a void context? |
d396a558 | 1558 | |
41630250 | 1559 | =item How can I call backticks without shell processing? |
d396a558 | 1560 | |
41630250 JH |
1561 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, |
1562 | ^Z on MS-DOS)? | |
4755096e | 1563 | |
41630250 | 1564 | =item How can I convert my shell script to perl? |
4755096e | 1565 | |
41630250 | 1566 | =item Can I use perl to run a telnet or ftp session? |
d396a558 | 1567 | |
41630250 | 1568 | =item How can I write expect in Perl? |
4755096e | 1569 | |
41630250 JH |
1570 | =item Is there a way to hide perl's command line from programs such as |
1571 | "ps"? | |
d396a558 | 1572 | |
41630250 JH |
1573 | =item I {changed directory, modified my environment} in a perl script. How |
1574 | come the change disappeared when I exited the script? How do I get my | |
1575 | changes to be visible? | |
d396a558 | 1576 | |
41630250 | 1577 | Unix |
4755096e | 1578 | |
41630250 JH |
1579 | =item How do I close a process's filehandle without waiting for it to |
1580 | complete? | |
4755096e | 1581 | |
41630250 | 1582 | =item How do I fork a daemon process? |
4755096e | 1583 | |
41630250 | 1584 | =item How do I find out if I'm running interactively or not? |
4755096e | 1585 | |
41630250 | 1586 | =item How do I timeout a slow event? |
4755096e | 1587 | |
41630250 | 1588 | =item How do I set CPU limits? |
4755096e | 1589 | |
41630250 | 1590 | =item How do I avoid zombies on a Unix system? |
4755096e | 1591 | |
41630250 | 1592 | =item How do I use an SQL database? |
4755096e | 1593 | |
41630250 | 1594 | =item How do I make a system() exit on control-C? |
4755096e | 1595 | |
41630250 | 1596 | =item How do I open a file without blocking? |
4755096e | 1597 | |
e4bb216d NC |
1598 | =item How do I tell the difference between errors from the shell and perl? |
1599 | ||
41630250 | 1600 | =item How do I install a module from CPAN? |
d396a558 | 1601 | |
41630250 | 1602 | =item What's the difference between require and use? |
d396a558 | 1603 | |
41630250 | 1604 | =item How do I keep my own module/library directory? |
d396a558 | 1605 | |
41630250 JH |
1606 | =item How do I add the directory my program lives in to the module/library |
1607 | search path? | |
d396a558 | 1608 | |
5538b230 | 1609 | =item How do I add a directory to my include path (@INC) at runtime? |
d396a558 | 1610 | |
41630250 | 1611 | =item What is socket.ph and where do I get it? |
4755096e | 1612 | |
c2e66d9e | 1613 | =back |
4755096e | 1614 | |
41630250 | 1615 | =item AUTHOR AND COPYRIGHT |
d396a558 JH |
1616 | |
1617 | =back | |
1618 | ||
e4bb216d | 1619 | =head2 perlfaq9 - Networking ($Revision: 1.16 $, $Date: 2004/10/30 12:20:59 |
41630250 | 1620 | $) |
d396a558 | 1621 | |
d420ca49 | 1622 | =over 4 |
d396a558 JH |
1623 | |
1624 | =item DESCRIPTION | |
1625 | ||
41630250 | 1626 | =over 4 |
d396a558 | 1627 | |
41630250 | 1628 | =item What is the correct form of response from a CGI script? |
d396a558 | 1629 | |
41630250 JH |
1630 | =item My CGI script runs from the command line but not the browser. (500 |
1631 | Server Error) | |
d396a558 | 1632 | |
41630250 | 1633 | =item How can I get better error messages from a CGI program? |
d396a558 | 1634 | |
41630250 | 1635 | =item How do I remove HTML from a string? |
d396a558 | 1636 | |
41630250 | 1637 | =item How do I extract URLs? |
d396a558 | 1638 | |
41630250 JH |
1639 | =item How do I download a file from the user's machine? How do I open a |
1640 | file on another machine? | |
d396a558 | 1641 | |
41630250 | 1642 | =item How do I make a pop-up menu in HTML? |
d396a558 | 1643 | |
41630250 | 1644 | =item How do I fetch an HTML file? |
d396a558 | 1645 | |
41630250 | 1646 | =item How do I automate an HTML form submission? |
d396a558 | 1647 | |
41630250 | 1648 | =item How do I decode or create those %-encodings on the web? |
d396a558 | 1649 | |
41630250 | 1650 | =item How do I redirect to another page? |
2a551100 | 1651 | |
41630250 | 1652 | =item How do I put a password on my web pages? |
d396a558 | 1653 | |
41630250 | 1654 | =item How do I edit my .htpasswd and .htgroup files with Perl? |
d396a558 | 1655 | |
41630250 JH |
1656 | =item How do I make sure users can't enter values into a form that cause my |
1657 | CGI script to do bad things? | |
d396a558 | 1658 | |
41630250 | 1659 | =item How do I parse a mail header? |
d396a558 | 1660 | |
41630250 | 1661 | =item How do I decode a CGI form? |
d396a558 | 1662 | |
41630250 | 1663 | =item How do I check a valid mail address? |
d396a558 | 1664 | |
41630250 | 1665 | =item How do I decode a MIME/BASE64 string? |
d396a558 | 1666 | |
41630250 | 1667 | =item How do I return the user's mail address? |
d396a558 | 1668 | |
41630250 | 1669 | =item How do I send mail? |
d396a558 | 1670 | |
41630250 | 1671 | =item How do I use MIME to make an attachment to a mail message? |
d396a558 | 1672 | |
41630250 | 1673 | =item How do I read mail? |
d396a558 | 1674 | |
41630250 | 1675 | =item How do I find out my hostname/domainname/IP address? |
d396a558 | 1676 | |
41630250 | 1677 | =item How do I fetch a news article or the active newsgroups? |
d396a558 | 1678 | |
41630250 | 1679 | =item How do I fetch/put an FTP file? |
9fa7f388 | 1680 | |
41630250 | 1681 | =item How can I do RPC in Perl? |
d396a558 JH |
1682 | |
1683 | =back | |
4755096e | 1684 | |
41630250 | 1685 | =item AUTHOR AND COPYRIGHT |
d396a558 | 1686 | |
c2e66d9e | 1687 | =back |
4755096e | 1688 | |
41630250 | 1689 | =head2 perlsyn - Perl syntax |
4755096e | 1690 | |
d420ca49 | 1691 | =over 4 |
4755096e | 1692 | |
c2e66d9e | 1693 | =item DESCRIPTION |
4755096e | 1694 | |
d420ca49 | 1695 | =over 4 |
4755096e | 1696 | |
41630250 | 1697 | =item Declarations |
23be5fc4 | 1698 | |
41630250 | 1699 | =item Comments |
4755096e | 1700 | |
41630250 | 1701 | =item Simple Statements |
4755096e | 1702 | |
639f8edf HS |
1703 | =item Truth and Falsehood |
1704 | ||
1705 | =item Statement Modifiers | |
1706 | ||
41630250 | 1707 | =item Compound Statements |
4755096e | 1708 | |
41630250 | 1709 | =item Loop Control |
4755096e | 1710 | |
41630250 | 1711 | =item For Loops |
4755096e | 1712 | |
41630250 | 1713 | =item Foreach Loops |
4755096e | 1714 | |
41630250 | 1715 | =item Basic BLOCKs and Switch Statements |
4755096e | 1716 | |
41630250 | 1717 | =item Goto |
4755096e | 1718 | |
41630250 | 1719 | =item PODs: Embedded Documentation |
4755096e | 1720 | |
41630250 | 1721 | =item Plain Old Comments (Not!) |
4755096e GS |
1722 | |
1723 | =back | |
1724 | ||
c2e66d9e GS |
1725 | =back |
1726 | ||
41630250 | 1727 | =head2 perldata - Perl data types |
4755096e | 1728 | |
d420ca49 | 1729 | =over 4 |
4755096e | 1730 | |
41630250 | 1731 | =item DESCRIPTION |
4755096e | 1732 | |
41630250 | 1733 | =over 4 |
4755096e | 1734 | |
41630250 | 1735 | =item Variable names |
4755096e | 1736 | |
41630250 | 1737 | =item Context |
4755096e | 1738 | |
41630250 | 1739 | =item Scalar values |
4755096e | 1740 | |
41630250 | 1741 | =item Scalar value constructors |
4755096e | 1742 | |
41630250 | 1743 | =item List value constructors |
4755096e | 1744 | |
41630250 | 1745 | =item Subscripts |
4755096e | 1746 | |
41630250 | 1747 | =item Slices |
4755096e | 1748 | |
41630250 | 1749 | =item Typeglobs and Filehandles |
4755096e | 1750 | |
41630250 | 1751 | =back |
4755096e | 1752 | |
c2e66d9e | 1753 | =item SEE ALSO |
4755096e GS |
1754 | |
1755 | =back | |
1756 | ||
41630250 | 1757 | =head2 perlop - Perl operators and precedence |
4755096e | 1758 | |
d420ca49 | 1759 | =over 4 |
4755096e | 1760 | |
c2e66d9e | 1761 | =item DESCRIPTION |
4755096e | 1762 | |
d420ca49 | 1763 | =over 4 |
4755096e | 1764 | |
639f8edf HS |
1765 | =item Operator Precedence and Associativity |
1766 | ||
41630250 | 1767 | =item Terms and List Operators (Leftward) |
4755096e | 1768 | |
41630250 | 1769 | =item The Arrow Operator |
4755096e | 1770 | |
41630250 | 1771 | =item Auto-increment and Auto-decrement |
4755096e | 1772 | |
41630250 | 1773 | =item Exponentiation |
4755096e | 1774 | |
41630250 | 1775 | =item Symbolic Unary Operators |
c2e66d9e | 1776 | |
41630250 | 1777 | =item Binding Operators |
c2e66d9e | 1778 | |
41630250 | 1779 | =item Multiplicative Operators |
4755096e | 1780 | |
41630250 | 1781 | =item Additive Operators |
4755096e | 1782 | |
41630250 | 1783 | =item Shift Operators |
4755096e | 1784 | |
41630250 | 1785 | =item Named Unary Operators |
4755096e | 1786 | |
41630250 | 1787 | =item Relational Operators |
4755096e | 1788 | |
41630250 | 1789 | =item Equality Operators |
4755096e | 1790 | |
41630250 | 1791 | =item Bitwise And |
4755096e | 1792 | |
41630250 | 1793 | =item Bitwise Or and Exclusive Or |
4755096e | 1794 | |
41630250 | 1795 | =item C-style Logical And |
4755096e | 1796 | |
41630250 | 1797 | =item C-style Logical Or |
4755096e | 1798 | |
41630250 | 1799 | =item C-style Logical Defined-Or |
4755096e | 1800 | |
41630250 | 1801 | =item Range Operators |
4755096e | 1802 | |
41630250 | 1803 | =item Conditional Operator |
4755096e | 1804 | |
41630250 | 1805 | =item Assignment Operators |
4755096e | 1806 | |
41630250 | 1807 | =item Comma Operator |
4755096e | 1808 | |
41630250 | 1809 | =item List Operators (Rightward) |
4755096e | 1810 | |
41630250 | 1811 | =item Logical Not |
c133c03f | 1812 | |
41630250 | 1813 | =item Logical And |
849d92fd | 1814 | |
41630250 | 1815 | =item Logical or, Defined or, and Exclusive Or |
849d92fd | 1816 | |
41630250 | 1817 | =item C Operators Missing From Perl |
849d92fd | 1818 | |
41630250 | 1819 | unary &, unary *, (TYPE) |
849d92fd | 1820 | |
41630250 | 1821 | =item Quote and Quote-like Operators |
849d92fd | 1822 | |
41630250 | 1823 | =item Regexp Quote-Like Operators |
849d92fd | 1824 | |
41630250 JH |
1825 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, |
1826 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, | |
1827 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, | |
1828 | y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF | |
849d92fd | 1829 | |
41630250 | 1830 | =item Gory details of parsing quoted constructs |
849d92fd | 1831 | |
41630250 JH |
1832 | Finding the end, Removal of backslashes before delimiters, Interpolation, |
1833 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
1834 | C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, | |
1835 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
1836 | regular expressions | |
849d92fd | 1837 | |
41630250 | 1838 | =item I/O Operators |
849d92fd | 1839 | |
41630250 | 1840 | =item Constant Folding |
849d92fd | 1841 | |
e4bb216d NC |
1842 | =item No-ops |
1843 | ||
41630250 | 1844 | =item Bitwise String Operators |
849d92fd | 1845 | |
41630250 | 1846 | =item Integer Arithmetic |
97f7c9df | 1847 | |
41630250 | 1848 | =item Floating-point Arithmetic |
849d92fd | 1849 | |
41630250 | 1850 | =item Bigger Numbers |
849d92fd | 1851 | |
41630250 | 1852 | =back |
849d92fd JH |
1853 | |
1854 | =back | |
1855 | ||
41630250 | 1856 | =head2 perlsub - Perl subroutines |
849d92fd JH |
1857 | |
1858 | =over 4 | |
1859 | ||
41630250 | 1860 | =item SYNOPSIS |
849d92fd | 1861 | |
41630250 | 1862 | =item DESCRIPTION |
849d92fd | 1863 | |
c133c03f | 1864 | =over 4 |
849d92fd | 1865 | |
41630250 | 1866 | =item Private Variables via my() |
849d92fd | 1867 | |
41630250 | 1868 | =item Persistent Private Variables |
849d92fd | 1869 | |
41630250 | 1870 | =item Temporary Values via local() |
849d92fd | 1871 | |
41630250 | 1872 | =item Lvalue subroutines |
849d92fd | 1873 | |
41630250 | 1874 | Lvalue subroutines are EXPERIMENTAL |
c133c03f | 1875 | |
41630250 | 1876 | =item Passing Symbol Table Entries (typeglobs) |
c133c03f | 1877 | |
41630250 | 1878 | =item When to Still Use local() |
849d92fd | 1879 | |
41630250 | 1880 | =item Pass by Reference |
30487ceb | 1881 | |
41630250 | 1882 | =item Prototypes |
849d92fd | 1883 | |
41630250 | 1884 | =item Constant Functions |
849d92fd | 1885 | |
41630250 | 1886 | =item Overriding Built-in Functions |
849d92fd | 1887 | |
41630250 | 1888 | =item Autoloading |
849d92fd | 1889 | |
41630250 | 1890 | =item Subroutine Attributes |
849d92fd | 1891 | |
41630250 | 1892 | =back |
849d92fd | 1893 | |
41630250 | 1894 | =item SEE ALSO |
849d92fd JH |
1895 | |
1896 | =back | |
1897 | ||
41630250 | 1898 | =head2 perlfunc - Perl builtin functions |
849d92fd | 1899 | |
41630250 | 1900 | =over 4 |
30487ceb | 1901 | |
41630250 | 1902 | =item DESCRIPTION |
c133c03f | 1903 | |
41630250 | 1904 | =over 4 |
a44e0ddd | 1905 | |
41630250 | 1906 | =item Perl Functions by Category |
849d92fd | 1907 | |
41630250 JH |
1908 | Functions for SCALARs or strings, Regular expressions and pattern matching, |
1909 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
1910 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
1911 | length data or records, Functions for filehandles, files, or directories, | |
1912 | Keywords related to the control flow of your perl program, Keywords related | |
1913 | to scoping, Miscellaneous functions, Functions for processes and process | |
1914 | groups, Keywords related to perl modules, Keywords related to classes and | |
1915 | object-orientedness, Low-level socket functions, System V interprocess | |
1916 | communication functions, Fetching user and group info, Fetching network | |
1917 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
1918 | in perl5 | |
849d92fd | 1919 | |
41630250 | 1920 | =item Portability |
849d92fd | 1921 | |
41630250 | 1922 | =item Alphabetical Listing of Perl Functions |
849d92fd | 1923 | |
41630250 JH |
1924 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept |
1925 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, | |
1926 | binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless | |
1927 | REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp( | |
1928 | LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER, | |
1929 | chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, | |
1930 | connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, | |
1931 | dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete | |
1932 | EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, | |
1933 | each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, | |
1934 | exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl | |
1935 | FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, | |
1936 | fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, | |
1937 | getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam | |
1938 | NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname | |
1939 | NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr | |
1940 | ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
1941 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
1942 | getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent | |
1943 | STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, | |
1944 | endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, | |
1945 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, | |
1946 | goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, | |
1947 | import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl | |
1948 | FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, | |
1949 | last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, | |
1950 | link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, | |
1951 | lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map | |
1952 | EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget | |
1953 | KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my | |
1954 | TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no | |
1955 | Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct | |
1956 | EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open | |
1957 | FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, | |
1958 | opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : | |
1959 | ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE, | |
1960 | package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, | |
1961 | print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, | |
1962 | printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, | |
1963 | qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, | |
1964 | rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read | |
1965 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, | |
1966 | readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, | |
1967 | ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, | |
1968 | require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir | |
1969 | DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, | |
1970 | rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir | |
1971 | DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, | |
1972 | semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
1973 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority | |
1974 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
1975 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
1976 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
1977 | EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair | |
1978 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, | |
1979 | sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, | |
1980 | splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split | |
1981 | /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format | |
1982 | parameter index, flags, vector flag, (minimum) width, precision, or maximum | |
1983 | width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat | |
1984 | FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME | |
1985 | (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, | |
1986 | substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr | |
1e54db1a | 1987 | EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen |
41630250 JH |
1988 | FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread |
1989 | FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
1990 | FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite | |
1991 | FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, | |
1992 | syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie | |
1993 | VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate | |
1994 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, | |
1995 | ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack | |
1996 | TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use | |
1997 | Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use | |
1998 | VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid | |
1999 | PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// | |
849d92fd JH |
2000 | |
2001 | =back | |
2002 | ||
53d7eaa8 JH |
2003 | =back |
2004 | ||
41630250 | 2005 | =head2 perlopentut - tutorial on opening things in Perl |
53d7eaa8 JH |
2006 | |
2007 | =over 4 | |
2008 | ||
2009 | =item DESCRIPTION | |
2010 | ||
41630250 | 2011 | =item Open E<agrave> la shell |
4755096e | 2012 | |
d420ca49 | 2013 | =over 4 |
4755096e | 2014 | |
41630250 | 2015 | =item Simple Opens |
4755096e | 2016 | |
41630250 | 2017 | =item Indirect Filehandles |
4755096e | 2018 | |
41630250 | 2019 | =item Pipe Opens |
4755096e | 2020 | |
41630250 | 2021 | =item The Minus File |
4755096e | 2022 | |
41630250 | 2023 | =item Mixing Reads and Writes |
4755096e | 2024 | |
41630250 | 2025 | =item Filters |
4755096e | 2026 | |
41630250 | 2027 | =back |
4755096e | 2028 | |
41630250 | 2029 | =item Open E<agrave> la C |
4755096e | 2030 | |
d420ca49 | 2031 | =over 4 |
4755096e | 2032 | |
41630250 | 2033 | =item Permissions E<agrave> la mode |
4755096e GS |
2034 | |
2035 | =back | |
2036 | ||
41630250 | 2037 | =item Obscure Open Tricks |
4755096e | 2038 | |
d420ca49 | 2039 | =over 4 |
4755096e | 2040 | |
41630250 | 2041 | =item Re-Opening Files (dups) |
4755096e | 2042 | |
41630250 | 2043 | =item Dispelling the Dweomer |
4755096e | 2044 | |
41630250 | 2045 | =item Paths as Opens |
4755096e | 2046 | |
41630250 | 2047 | =item Single Argument Open |
4755096e | 2048 | |
41630250 | 2049 | =item Playing with STDIN and STDOUT |
4755096e | 2050 | |
c2e66d9e | 2051 | =back |
4755096e | 2052 | |
41630250 | 2053 | =item Other I/O Issues |
4755096e | 2054 | |
d420ca49 | 2055 | =over 4 |
4755096e | 2056 | |
41630250 | 2057 | =item Opening Non-File Files |
4755096e | 2058 | |
41630250 | 2059 | =item Opening Named Pipes |
4755096e | 2060 | |
41630250 | 2061 | =item Opening Sockets |
4755096e | 2062 | |
41630250 | 2063 | =item Binary Files |
4755096e | 2064 | |
41630250 | 2065 | =item File Locking |
4755096e | 2066 | |
41630250 | 2067 | =item IO Layers |
4755096e GS |
2068 | |
2069 | =back | |
2070 | ||
41630250 | 2071 | =item SEE ALSO |
4755096e | 2072 | |
41630250 | 2073 | =item AUTHOR and COPYRIGHT |
4755096e | 2074 | |
41630250 | 2075 | =item HISTORY |
4755096e | 2076 | |
41630250 | 2077 | =back |
4755096e | 2078 | |
41630250 | 2079 | =head2 perlpacktut - tutorial on C<pack> and C<unpack> |
4755096e | 2080 | |
41630250 | 2081 | =over 4 |
4755096e | 2082 | |
41630250 | 2083 | =item DESCRIPTION |
4755096e | 2084 | |
41630250 | 2085 | =item The Basic Principle |
4755096e | 2086 | |
41630250 | 2087 | =item Packing Text |
4755096e | 2088 | |
41630250 | 2089 | =item Packing Numbers |
4755096e | 2090 | |
d420ca49 | 2091 | =over 4 |
4755096e | 2092 | |
41630250 | 2093 | =item Integers |
4755096e | 2094 | |
41630250 | 2095 | =item Unpacking a Stack Frame |
4755096e | 2096 | |
41630250 JH |
2097 | =item How to Eat an Egg on a Net |
2098 | ||
07e9b5fe NC |
2099 | =item Byte-order modifiers |
2100 | ||
41630250 | 2101 | =item Floating point Numbers |
4755096e GS |
2102 | |
2103 | =back | |
2104 | ||
41630250 | 2105 | =item Exotic Templates |
4755096e | 2106 | |
41630250 | 2107 | =over 4 |
4755096e | 2108 | |
41630250 | 2109 | =item Bit Strings |
4755096e | 2110 | |
41630250 | 2111 | =item Uuencoding |
4755096e | 2112 | |
41630250 | 2113 | =item Doing Sums |
4755096e | 2114 | |
41630250 | 2115 | =item Unicode |
4755096e | 2116 | |
41630250 | 2117 | =item Another Portable Binary Encoding |
4755096e | 2118 | |
41630250 | 2119 | =back |
4755096e | 2120 | |
41630250 | 2121 | =item Template Grouping |
4755096e | 2122 | |
41630250 | 2123 | =item Lengths and Widths |
4755096e | 2124 | |
41630250 | 2125 | =over 4 |
4755096e | 2126 | |
41630250 | 2127 | =item String Lengths |
4755096e | 2128 | |
41630250 | 2129 | =item Dynamic Templates |
4755096e | 2130 | |
41630250 | 2131 | =item Counting Repetitions |
4755096e | 2132 | |
41630250 | 2133 | =back |
a6812a52 | 2134 | |
41630250 | 2135 | =item Packing and Unpacking C Structures |
0d53b15f | 2136 | |
41630250 | 2137 | =over 4 |
4755096e | 2138 | |
41630250 | 2139 | =item The Alignment Pit |
4755096e | 2140 | |
07e9b5fe NC |
2141 | =item Dealing with Endian-ness |
2142 | ||
41630250 | 2143 | =item Alignment, Take 2 |
4755096e | 2144 | |
41630250 | 2145 | =item Alignment, Take 3 |
4755096e | 2146 | |
41630250 | 2147 | =item Pointers for How to Use Them |
4755096e | 2148 | |
41630250 | 2149 | =back |
4755096e | 2150 | |
41630250 | 2151 | =item Pack Recipes |
4755096e | 2152 | |
41630250 | 2153 | =item Funnies Section |
4755096e | 2154 | |
41630250 | 2155 | =item Authors |
4755096e GS |
2156 | |
2157 | =back | |
2158 | ||
41630250 | 2159 | =head2 perlpod - the Plain Old Documentation format |
4755096e | 2160 | |
41630250 | 2161 | =over 4 |
4755096e | 2162 | |
41630250 | 2163 | =item DESCRIPTION |
4755096e | 2164 | |
d420ca49 | 2165 | =over 4 |
4755096e | 2166 | |
41630250 | 2167 | =item Ordinary Paragraph |
4755096e | 2168 | |
41630250 | 2169 | =item Verbatim Paragraph |
4755096e | 2170 | |
41630250 | 2171 | =item Command Paragraph |
4755096e | 2172 | |
41630250 JH |
2173 | C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading |
2174 | Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item | |
2175 | I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end | |
1e54db1a JH |
2176 | I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding |
2177 | I<encodingname>> | |
4755096e | 2178 | |
41630250 | 2179 | =item Formatting Codes |
4755096e | 2180 | |
41630250 JH |
2181 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, |
2182 | C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink, | |
2183 | C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used | |
2184 | for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces, | |
2185 | C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null | |
2186 | (zero-effect) formatting code | |
4755096e | 2187 | |
41630250 | 2188 | =item The Intent |
4755096e | 2189 | |
41630250 | 2190 | =item Embedding Pods in Perl Modules |
c2e66d9e | 2191 | |
41630250 | 2192 | =item Hints for Writing Pod |
4755096e | 2193 | |
d396a558 | 2194 | =back |
4755096e | 2195 | |
d396a558 | 2196 | =item SEE ALSO |
4755096e | 2197 | |
41630250 | 2198 | =item AUTHOR |
4755096e | 2199 | |
4755096e GS |
2200 | =back |
2201 | ||
41630250 JH |
2202 | =head2 perlpodspec - Plain Old Documentation: format specification and |
2203 | notes | |
4755096e | 2204 | |
d420ca49 | 2205 | =over 4 |
4755096e | 2206 | |
d396a558 | 2207 | =item DESCRIPTION |
4755096e | 2208 | |
41630250 | 2209 | =item Pod Definitions |
4755096e | 2210 | |
41630250 | 2211 | =item Pod Commands |
4755096e | 2212 | |
41630250 | 2213 | "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", |
1e54db1a JH |
2214 | "=back", "=begin formatname", "=end formatname", "=for formatname text...", |
2215 | "=encoding encodingname" | |
4755096e | 2216 | |
41630250 | 2217 | =item Pod Formatting Codes |
4755096e | 2218 | |
41630250 JH |
2219 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, |
2220 | C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for | |
2221 | filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a | |
2222 | null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, | |
2223 | C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text | |
2224 | contains non-breaking spaces | |
4755096e | 2225 | |
41630250 | 2226 | =item Notes on Implementing Pod Processors |
4755096e | 2227 | |
41630250 | 2228 | =item About LE<lt>...E<gt> Codes |
4755096e | 2229 | |
41630250 | 2230 | First:, Second:, Third:, Fourth:, Fifth:, Sixth: |
4755096e | 2231 | |
41630250 | 2232 | =item About =over...=back Regions |
4755096e | 2233 | |
41630250 | 2234 | =item About Data Paragraphs and "=begin/=end" Regions |
4755096e | 2235 | |
41630250 | 2236 | =item SEE ALSO |
4755096e | 2237 | |
41630250 | 2238 | =item AUTHOR |
d0363f02 | 2239 | |
4755096e GS |
2240 | =back |
2241 | ||
41630250 | 2242 | =head2 perlrun - how to execute the Perl interpreter |
4755096e | 2243 | |
d420ca49 | 2244 | =over 4 |
4755096e | 2245 | |
41630250 | 2246 | =item SYNOPSIS |
4755096e | 2247 | |
41630250 | 2248 | =item DESCRIPTION |
4755096e | 2249 | |
41630250 | 2250 | =over 4 |
4755096e | 2251 | |
41630250 | 2252 | =item #! and quoting on non-Unix systems |
4755096e | 2253 | |
41630250 | 2254 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS |
4755096e | 2255 | |
41630250 | 2256 | =item Location of Perl |
4755096e | 2257 | |
41630250 | 2258 | =item Command Switches |
4755096e | 2259 | |
41630250 | 2260 | B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C |
e4bb216d NC |
2261 | [I<number/list>]>, B<-c>, B<-d>, B<-dt>, B<-d:>I<foo[=bar,baz]>, |
2262 | B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e> | |
2263 | I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>], | |
2264 | B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>, | |
2265 | B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
41630250 | 2266 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, |
e4bb216d | 2267 | B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<configvar>, B<-w>, B<-W>, |
07e9b5fe | 2268 | B<-X>, B<-x>, B<-x> I<directory> |
41630250 JH |
2269 | |
2270 | =back | |
4755096e | 2271 | |
d396a558 | 2272 | =item ENVIRONMENT |
4755096e | 2273 | |
41630250 JH |
2274 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, |
2275 | :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, | |
e4bb216d NC |
2276 | PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port), |
2277 | PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS, | |
2baadb76 RGS |
2278 | PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED, |
2279 | PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS, | |
2280 | PERL_UNICODE, SYS$LOGIN (specific to the VMS port) | |
4755096e | 2281 | |
41630250 JH |
2282 | =back |
2283 | ||
2284 | =head2 perldiag - various Perl diagnostics | |
4755096e | 2285 | |
d420ca49 | 2286 | =over 4 |
4755096e | 2287 | |
41630250 | 2288 | =item DESCRIPTION |
4755096e | 2289 | |
41630250 | 2290 | =back |
4755096e | 2291 | |
41630250 | 2292 | =head2 perllexwarn - Perl Lexical Warnings |
4755096e | 2293 | |
41630250 | 2294 | =over 4 |
4755096e | 2295 | |
41630250 | 2296 | =item DESCRIPTION |
4755096e | 2297 | |
41630250 | 2298 | =over 4 |
4755096e | 2299 | |
41630250 | 2300 | =item Default Warnings and Optional Warnings |
4755096e | 2301 | |
41630250 | 2302 | =item What's wrong with B<-w> and C<$^W> |
4755096e | 2303 | |
41630250 | 2304 | =item Controlling Warnings from the Command Line |
b2deec1d | 2305 | |
41630250 | 2306 | B<-w>, B<-W>, B<-X> |
4755096e | 2307 | |
41630250 | 2308 | =item Backward Compatibility |
4755096e | 2309 | |
41630250 JH |
2310 | =item Category Hierarchy |
2311 | ||
2312 | =item Fatal Warnings | |
2313 | ||
2314 | =item Reporting Warnings from a Module | |
4755096e GS |
2315 | |
2316 | =back | |
2317 | ||
41630250 JH |
2318 | =item TODO |
2319 | ||
4755096e GS |
2320 | =item SEE ALSO |
2321 | ||
41630250 | 2322 | =item AUTHOR |
4755096e GS |
2323 | |
2324 | =back | |
2325 | ||
41630250 | 2326 | =head2 perldebug - Perl debugging |
ba62762e JH |
2327 | |
2328 | =over 4 | |
2329 | ||
2330 | =item DESCRIPTION | |
2331 | ||
41630250 | 2332 | =item The Perl Debugger |
ba62762e | 2333 | |
41630250 | 2334 | =over 4 |
b2deec1d | 2335 | |
41630250 | 2336 | =item Debugger Commands |
ba62762e | 2337 | |
41630250 JH |
2338 | h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y |
2339 | [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l | |
2340 | min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, | |
2341 | ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b | |
2342 | subname [condition], b postpone subname [condition], b load filename, b | |
2343 | compile subname, B line, B *, a [line] command, A line, A *, w expr, W | |
2344 | expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ | |
2345 | command ], < *, << command, > ?, > command, > *, >> command, { ?, { [ | |
2346 | command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source | |
2347 | file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man | |
2348 | [manpage] | |
ba62762e | 2349 | |
41630250 | 2350 | =item Configurable Options |
ba62762e | 2351 | |
41630250 JH |
2352 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, |
2353 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
2354 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>, | |
2355 | C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>, | |
2356 | C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, | |
2357 | C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, | |
2358 | C<NonStop> | |
ba62762e | 2359 | |
41630250 | 2360 | =item Debugger input/output |
3ecb3787 | 2361 | |
41630250 JH |
2362 | Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame |
2363 | listing | |
ba62762e | 2364 | |
41630250 | 2365 | =item Debugging compile-time statements |
ba62762e | 2366 | |
41630250 | 2367 | =item Debugger Customization |
ba62762e | 2368 | |
41630250 | 2369 | =item Readline Support |
ba62762e | 2370 | |
41630250 | 2371 | =item Editor Support for Debugging |
ba62762e | 2372 | |
41630250 | 2373 | =item The Perl Profiler |
ba62762e JH |
2374 | |
2375 | =back | |
2376 | ||
41630250 | 2377 | =item Debugging regular expressions |
34babc16 | 2378 | |
41630250 | 2379 | =item Debugging memory usage |
ba62762e | 2380 | |
41630250 | 2381 | =item SEE ALSO |
ba62762e | 2382 | |
41630250 | 2383 | =item BUGS |
ba62762e JH |
2384 | |
2385 | =back | |
2386 | ||
41630250 | 2387 | =head2 perlvar - Perl predefined variables |
4755096e | 2388 | |
d420ca49 | 2389 | =over 4 |
4755096e GS |
2390 | |
2391 | =item DESCRIPTION | |
2392 | ||
d420ca49 | 2393 | =over 4 |
4755096e | 2394 | |
41630250 | 2395 | =item Predefined Names |
ba62762e | 2396 | |
41630250 JH |
2397 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
2398 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, | |
2399 | HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, | |
2400 | IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, | |
2401 | HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, | |
2402 | IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, | |
2403 | IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, | |
1e54db1a | 2404 | $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#, |
41630250 JH |
2405 | HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, |
2406 | HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, | |
2407 | HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, | |
2408 | @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as | |
2409 | C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, | |
2410 | $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> | |
2411 | is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as | |
2412 | C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), | |
2413 | $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, | |
2414 | IO::Handle->format_line_break_characters EXPR, | |
2415 | $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, | |
2416 | $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, | |
2417 | $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, | |
2418 | $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, | |
2419 | $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), | |
2420 | $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, | |
2421 | $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, | |
2422 | ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, | |
2423 | 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, | |
2424 | $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, | |
2425 | $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, | |
2426 | ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, | |
2427 | $SIG{expr} | |
ba62762e | 2428 | |
41630250 | 2429 | =item Error Indicators |
b2deec1d | 2430 | |
41630250 | 2431 | =item Technical Note on the Syntax of Variable Names |
8b9c797b | 2432 | |
41630250 | 2433 | =back |
8b9c797b | 2434 | |
41630250 | 2435 | =item BUGS |
37b1fd75 | 2436 | |
ba62762e JH |
2437 | =back |
2438 | ||
41630250 | 2439 | =head2 perlre - Perl regular expressions |
4755096e | 2440 | |
d8416318 JH |
2441 | =over 4 |
2442 | ||
41630250 | 2443 | =item DESCRIPTION |
d8416318 | 2444 | |
41630250 | 2445 | i, m, s, x |
d8416318 | 2446 | |
41630250 | 2447 | =over 4 |
d8416318 | 2448 | |
41630250 JH |
2449 | =item Regular Expressions |
2450 | ||
2451 | [1], [2], [3], cntrl, graph, print, punct, xdigit | |
2452 | ||
2453 | =item Extended Patterns | |
2454 | ||
2455 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, | |
2456 | C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ | |
2457 | code })>, C<(??{ code })>, C<< (?>pattern) >>, | |
2458 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
2459 | ||
2460 | =item Backtracking | |
2461 | ||
2462 | =item Version 8 Regular Expressions | |
2463 | ||
2464 | =item Warning on \1 vs $1 | |
2465 | ||
2466 | =item Repeated patterns matching zero-length substring | |
2467 | ||
2468 | =item Combining pieces together | |
2469 | ||
2470 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, | |
2471 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
2472 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
2473 | C<(?(condition)yes-pattern|no-pattern)> | |
2474 | ||
2475 | =item Creating custom RE engines | |
2a551100 | 2476 | |
d8416318 JH |
2477 | =back |
2478 | ||
41630250 JH |
2479 | =item BUGS |
2480 | ||
b2deec1d JH |
2481 | =item SEE ALSO |
2482 | ||
4755096e GS |
2483 | =back |
2484 | ||
41630250 | 2485 | =head2 perlreref - Perl Regular Expressions Reference |
4755096e | 2486 | |
d420ca49 | 2487 | =over 4 |
4755096e | 2488 | |
d396a558 | 2489 | =item DESCRIPTION |
4755096e | 2490 | |
d420ca49 | 2491 | =over 4 |
4755096e | 2492 | |
41630250 | 2493 | =item OPERATORS |
4755096e | 2494 | |
41630250 | 2495 | =item SYNTAX |
4755096e | 2496 | |
41630250 | 2497 | =item ESCAPE SEQUENCES |
4755096e | 2498 | |
41630250 | 2499 | =item CHARACTER CLASSES |
4755096e | 2500 | |
41630250 | 2501 | =item ANCHORS |
4755096e | 2502 | |
41630250 | 2503 | =item QUANTIFIERS |
4755096e | 2504 | |
41630250 | 2505 | =item EXTENDED CONSTRUCTS |
4755096e | 2506 | |
41630250 | 2507 | =item VARIABLES |
4755096e | 2508 | |
41630250 | 2509 | =item FUNCTIONS |
b2deec1d | 2510 | |
41630250 | 2511 | =item TERMINOLOGY |
b2deec1d | 2512 | |
41630250 | 2513 | =back |
41ca3a40 | 2514 | |
41630250 JH |
2515 | =item AUTHOR |
2516 | ||
2517 | =item SEE ALSO | |
2518 | ||
2519 | =item THANKS | |
ff426ff2 | 2520 | |
4755096e GS |
2521 | =back |
2522 | ||
41630250 | 2523 | =head2 perlref - Perl references and nested data structures |
4755096e | 2524 | |
41630250 | 2525 | =over 4 |
4755096e | 2526 | |
41630250 | 2527 | =item NOTE |
4755096e | 2528 | |
41630250 | 2529 | =item DESCRIPTION |
4755096e | 2530 | |
d420ca49 | 2531 | =over 4 |
37d4d706 | 2532 | |
41630250 | 2533 | =item Making References |
37d4d706 | 2534 | |
41630250 | 2535 | =item Using References |
37d4d706 | 2536 | |
41630250 | 2537 | =item Symbolic references |
37d4d706 | 2538 | |
41630250 | 2539 | =item Not-so-symbolic references |
37d4d706 | 2540 | |
41630250 | 2541 | =item Pseudo-hashes: Using an array as a hash |
4755096e | 2542 | |
41630250 | 2543 | =item Function Templates |
4755096e | 2544 | |
41630250 | 2545 | =back |
4755096e | 2546 | |
41630250 | 2547 | =item WARNING |
4755096e | 2548 | |
41630250 | 2549 | =item SEE ALSO |
4755096e | 2550 | |
41630250 | 2551 | =back |
4755096e | 2552 | |
41630250 | 2553 | =head2 perlform - Perl formats |
4755096e | 2554 | |
41630250 | 2555 | =over 4 |
4755096e | 2556 | |
41630250 | 2557 | =item DESCRIPTION |
4755096e | 2558 | |
41630250 | 2559 | =over 4 |
4755096e | 2560 | |
1400179b NC |
2561 | =item Text Fields |
2562 | ||
2563 | =item Numeric Fields | |
2564 | ||
2565 | =item The Field @* for Variable Width Multi-Line Text | |
2566 | ||
2567 | =item The Field ^* for Variable Width One-line-at-a-time Text | |
2568 | ||
2569 | =item Specifying Values | |
2570 | ||
2571 | =item Using Fill Mode | |
2572 | ||
2573 | =item Suppressing Lines Where All Fields Are Void | |
2574 | ||
2575 | =item Repeating Format Lines | |
2576 | ||
2577 | =item Top of Form Processing | |
2578 | ||
41630250 | 2579 | =item Format Variables |
4755096e GS |
2580 | |
2581 | =back | |
2582 | ||
41630250 | 2583 | =item NOTES |
37d4d706 | 2584 | |
d420ca49 | 2585 | =over 4 |
37d4d706 | 2586 | |
41630250 | 2587 | =item Footers |
37d4d706 | 2588 | |
41630250 | 2589 | =item Accessing Formatting Internals |
37d4d706 | 2590 | |
41630250 | 2591 | =back |
37d4d706 | 2592 | |
41630250 | 2593 | =item WARNINGS |
37d4d706 JH |
2594 | |
2595 | =back | |
2596 | ||
41630250 | 2597 | =head2 perlobj - Perl objects |
4755096e | 2598 | |
41630250 | 2599 | =over 4 |
4755096e | 2600 | |
41630250 | 2601 | =item DESCRIPTION |
4755096e | 2602 | |
d420ca49 | 2603 | =over 4 |
4755096e | 2604 | |
41630250 | 2605 | =item An Object is Simply a Reference |
7029d033 | 2606 | |
41630250 | 2607 | =item A Class is Simply a Package |
4755096e | 2608 | |
41630250 | 2609 | =item A Method is Simply a Subroutine |
4755096e | 2610 | |
41630250 | 2611 | =item Method Invocation |
4755096e | 2612 | |
41630250 | 2613 | =item Indirect Object Syntax |
4755096e | 2614 | |
41630250 | 2615 | =item Default UNIVERSAL methods |
4755096e | 2616 | |
41630250 | 2617 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
4755096e | 2618 | |
41630250 | 2619 | =item Destructors |
9fa7f388 | 2620 | |
41630250 | 2621 | =item Summary |
b3b6085d | 2622 | |
41630250 | 2623 | =item Two-Phased Garbage Collection |
c2e66d9e | 2624 | |
41630250 | 2625 | =back |
41ca3a40 | 2626 | |
41630250 | 2627 | =item SEE ALSO |
4755096e GS |
2628 | |
2629 | =back | |
2630 | ||
41630250 | 2631 | =head2 perltie - how to hide an object class in a simple variable |
4755096e | 2632 | |
d420ca49 | 2633 | =over 4 |
4755096e | 2634 | |
41630250 JH |
2635 | =item SYNOPSIS |
2636 | ||
4755096e GS |
2637 | =item DESCRIPTION |
2638 | ||
d420ca49 | 2639 | =over 4 |
4755096e | 2640 | |
41630250 | 2641 | =item Tying Scalars |
4755096e | 2642 | |
41630250 JH |
2643 | TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, |
2644 | DESTROY this | |
4755096e | 2645 | |
41630250 | 2646 | =item Tying Arrays |
c2e66d9e | 2647 | |
41630250 JH |
2648 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, |
2649 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, | |
2650 | key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this, | |
2651 | UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY | |
2652 | this | |
c2e66d9e | 2653 | |
41630250 | 2654 | =item Tying Hashes |
4755096e | 2655 | |
41630250 JH |
2656 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE |
2657 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
f262848d | 2658 | this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this |
d8416318 | 2659 | |
41630250 JH |
2660 | =item Tying FileHandles |
2661 | ||
2662 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, | |
2663 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, | |
2664 | DESTROY this | |
2665 | ||
2666 | =item UNTIE this | |
2667 | ||
2668 | =item The C<untie> Gotcha | |
0d53b15f | 2669 | |
4755096e GS |
2670 | =back |
2671 | ||
c2e66d9e GS |
2672 | =item SEE ALSO |
2673 | ||
41630250 | 2674 | =item BUGS |
4755096e | 2675 | |
41630250 | 2676 | =item AUTHOR |
4755096e | 2677 | |
41630250 | 2678 | =back |
4755096e | 2679 | |
41630250 | 2680 | =head2 perldbmfilter - Perl DBM Filters |
4755096e | 2681 | |
d420ca49 | 2682 | =over 4 |
4755096e | 2683 | |
41630250 | 2684 | =item SYNOPSIS |
4755096e | 2685 | |
41630250 | 2686 | =item DESCRIPTION |
4755096e | 2687 | |
41630250 JH |
2688 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
2689 | B<filter_fetch_value> | |
4755096e | 2690 | |
41630250 | 2691 | =over 4 |
4755096e | 2692 | |
41630250 | 2693 | =item The Filter |
4755096e | 2694 | |
41630250 JH |
2695 | =item An Example -- the NULL termination problem. |
2696 | ||
2697 | =item Another Example -- Key is a C int. | |
a6fb92f1 | 2698 | |
4755096e GS |
2699 | =back |
2700 | ||
c2e66d9e | 2701 | =item SEE ALSO |
4755096e | 2702 | |
41630250 JH |
2703 | =item AUTHOR |
2704 | ||
c2e66d9e | 2705 | =back |
4755096e | 2706 | |
41630250 JH |
2707 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
2708 | safe subprocesses, sockets, and semaphores) | |
35bf961c JH |
2709 | |
2710 | =over 4 | |
2711 | ||
2712 | =item DESCRIPTION | |
2713 | ||
41630250 JH |
2714 | =item Signals |
2715 | ||
35bf961c JH |
2716 | =over 4 |
2717 | ||
41630250 | 2718 | =item Handling the SIGHUP Signal in Daemons |
35bf961c JH |
2719 | |
2720 | =back | |
2721 | ||
41630250 | 2722 | =item Named Pipes |
35bf961c | 2723 | |
41630250 | 2724 | =over 4 |
35bf961c | 2725 | |
d53e588d | 2726 | =item Deferred Signals (Safe Signals) |
35bf961c | 2727 | |
41630250 JH |
2728 | Long running opcodes, Interrupting IO, Restartable system calls, Signals as |
2729 | "faults", Signals triggered by operating system state | |
35bf961c JH |
2730 | |
2731 | =back | |
2732 | ||
41630250 | 2733 | =item Using open() for IPC |
4755096e | 2734 | |
d420ca49 | 2735 | =over 4 |
4755096e | 2736 | |
41630250 | 2737 | =item Filehandles |
4755096e | 2738 | |
41630250 | 2739 | =item Background Processes |
4755096e | 2740 | |
41630250 | 2741 | =item Complete Dissociation of Child from Parent |
4755096e | 2742 | |
41630250 | 2743 | =item Safe Pipe Opens |
4755096e | 2744 | |
41630250 | 2745 | =item Bidirectional Communication with Another Process |
4755096e | 2746 | |
41630250 | 2747 | =item Bidirectional Communication with Yourself |
4755096e | 2748 | |
c2e66d9e | 2749 | =back |
4755096e | 2750 | |
41630250 | 2751 | =item Sockets: Client/Server Communication |
4755096e | 2752 | |
603b90a8 JH |
2753 | =over 4 |
2754 | ||
41630250 | 2755 | =item Internet Line Terminators |
5df44211 | 2756 | |
41630250 | 2757 | =item Internet TCP Clients and Servers |
603b90a8 | 2758 | |
41630250 | 2759 | =item Unix-Domain TCP Clients and Servers |
5df44211 | 2760 | |
41630250 | 2761 | =back |
603b90a8 | 2762 | |
41630250 | 2763 | =item TCP Clients with IO::Socket |
5df44211 | 2764 | |
41630250 | 2765 | =over 4 |
603b90a8 | 2766 | |
41630250 | 2767 | =item A Simple Client |
5df44211 | 2768 | |
41630250 | 2769 | C<Proto>, C<PeerAddr>, C<PeerPort> |
603b90a8 | 2770 | |
41630250 | 2771 | =item A Webget Client |
5df44211 | 2772 | |
41630250 | 2773 | =item Interactive Client with IO::Socket |
5df44211 | 2774 | |
603b90a8 | 2775 | =back |
4755096e | 2776 | |
41630250 | 2777 | =item TCP Servers with IO::Socket |
4755096e | 2778 | |
41630250 | 2779 | Proto, LocalPort, Listen, Reuse |
4755096e | 2780 | |
41630250 | 2781 | =item UDP: Message Passing |
4755096e | 2782 | |
41630250 | 2783 | =item SysV IPC |
4755096e | 2784 | |
41630250 | 2785 | =item NOTES |
4755096e | 2786 | |
41630250 | 2787 | =item BUGS |
4755096e | 2788 | |
41630250 JH |
2789 | =item AUTHOR |
2790 | ||
2791 | =item SEE ALSO | |
4755096e | 2792 | |
c2e66d9e | 2793 | =back |
4755096e | 2794 | |
41630250 | 2795 | =head2 perlfork - Perl's fork() emulation |
4755096e | 2796 | |
d420ca49 | 2797 | =over 4 |
4755096e | 2798 | |
41630250 | 2799 | =item SYNOPSIS |
35bf961c | 2800 | |
41630250 | 2801 | =item DESCRIPTION |
4755096e | 2802 | |
d420ca49 | 2803 | =over 4 |
4755096e | 2804 | |
41630250 | 2805 | =item Behavior of other Perl features in forked pseudo-processes |
4755096e | 2806 | |
41630250 JH |
2807 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
2808 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
2809 | files, directories and network sockets | |
35bf961c | 2810 | |
41630250 | 2811 | =item Resource limits |
35bf961c | 2812 | |
41630250 | 2813 | =item Killing the parent process |
35bf961c | 2814 | |
41630250 | 2815 | =item Lifetime of the parent process and pseudo-processes |
4755096e | 2816 | |
41630250 | 2817 | =item CAVEATS AND LIMITATIONS |
4755096e | 2818 | |
41630250 JH |
2819 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
2820 | Global state maintained by XSUBs, Interpreter embedded in larger | |
2821 | application, Thread-safety of extensions | |
a9ef4385 | 2822 | |
41630250 | 2823 | =back |
c2e66d9e | 2824 | |
41630250 | 2825 | =item BUGS |
c2e66d9e | 2826 | |
41630250 | 2827 | =item AUTHOR |
35bf961c | 2828 | |
41630250 | 2829 | =item SEE ALSO |
35bf961c JH |
2830 | |
2831 | =back | |
2832 | ||
41630250 | 2833 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
35bf961c JH |
2834 | |
2835 | =over 4 | |
2836 | ||
41630250 | 2837 | =item SYNOPSIS |
35bf961c | 2838 | |
41630250 | 2839 | =item DESCRIPTION |
35bf961c | 2840 | |
41630250 | 2841 | =item Storing numbers |
35bf961c | 2842 | |
41630250 | 2843 | =item Numeric operators and numeric conversions |
35bf961c | 2844 | |
41630250 | 2845 | =item Flavors of Perl numeric operations |
35bf961c | 2846 | |
41630250 JH |
2847 | Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other |
2848 | mathematical operators, Bitwise operators, Bitwise operators during C<use | |
2849 | integer>, Operators which expect an integer, Operators which expect a | |
2850 | string | |
2851 | ||
2852 | =item AUTHOR | |
2853 | ||
2854 | =item SEE ALSO | |
35bf961c JH |
2855 | |
2856 | =back | |
2857 | ||
41630250 | 2858 | =head2 perlthrtut - tutorial on threads in Perl |
35bf961c JH |
2859 | |
2860 | =over 4 | |
2861 | ||
41630250 | 2862 | =item DESCRIPTION |
35bf961c | 2863 | |
41630250 | 2864 | =item Status |
2a551100 | 2865 | |
41630250 | 2866 | =item What Is A Thread Anyway? |
35bf961c | 2867 | |
41630250 | 2868 | =item Threaded Program Models |
35bf961c JH |
2869 | |
2870 | =over 4 | |
2871 | ||
41630250 | 2872 | =item Boss/Worker |
35bf961c | 2873 | |
41630250 | 2874 | =item Work Crew |
35bf961c | 2875 | |
41630250 | 2876 | =item Pipeline |
35bf961c JH |
2877 | |
2878 | =back | |
2879 | ||
41630250 | 2880 | =item What kind of threads are Perl threads? |
35bf961c | 2881 | |
41630250 | 2882 | =item Thread-Safe Modules |
35bf961c | 2883 | |
41630250 | 2884 | =item Thread Basics |
35bf961c | 2885 | |
41630250 | 2886 | =over 4 |
35bf961c | 2887 | |
41630250 | 2888 | =item Basic Thread Support |
35bf961c | 2889 | |
41630250 | 2890 | =item A Note about the Examples |
35bf961c | 2891 | |
41630250 | 2892 | =item Creating Threads |
35bf961c | 2893 | |
41630250 | 2894 | =item Waiting For A Thread To Exit |
35bf961c | 2895 | |
41630250 | 2896 | =item Ignoring A Thread |
4755096e GS |
2897 | |
2898 | =back | |
2899 | ||
41630250 | 2900 | =item Threads And Data |
4755096e | 2901 | |
d420ca49 | 2902 | =over 4 |
4755096e | 2903 | |
41630250 | 2904 | =item Shared And Unshared Data |
4755096e | 2905 | |
41630250 | 2906 | =item Thread Pitfalls: Races |
4755096e | 2907 | |
41630250 | 2908 | =back |
4755096e | 2909 | |
41630250 | 2910 | =item Synchronization and control |
4755096e | 2911 | |
41630250 | 2912 | =over 4 |
4755096e | 2913 | |
41630250 | 2914 | =item Controlling access: lock() |
4755096e | 2915 | |
41630250 | 2916 | =item A Thread Pitfall: Deadlocks |
4755096e | 2917 | |
41630250 | 2918 | =item Queues: Passing Data Around |
4755096e | 2919 | |
41630250 | 2920 | =item Semaphores: Synchronizing Data Access |
4755096e | 2921 | |
41630250 | 2922 | =item Basic semaphores |
4755096e | 2923 | |
41630250 | 2924 | =item Advanced Semaphores |
4755096e | 2925 | |
41630250 | 2926 | =item cond_wait() and cond_signal() |
4755096e | 2927 | |
41630250 | 2928 | =item Giving up control |
4755096e GS |
2929 | |
2930 | =back | |
2931 | ||
41630250 | 2932 | =item General Thread Utility Routines |
4755096e | 2933 | |
d420ca49 | 2934 | =over 4 |
4755096e | 2935 | |
41630250 | 2936 | =item What Thread Am I In? |
4755096e | 2937 | |
41630250 | 2938 | =item Thread IDs |
4755096e | 2939 | |
41630250 | 2940 | =item Are These Threads The Same? |
4755096e | 2941 | |
41630250 | 2942 | =item What Threads Are Running? |
4755096e | 2943 | |
41630250 | 2944 | =back |
4755096e | 2945 | |
41630250 | 2946 | =item A Complete Example |
4755096e | 2947 | |
41630250 | 2948 | =item Different implementations of threads |
0d53b15f | 2949 | |
41630250 | 2950 | =item Performance considerations |
4755096e | 2951 | |
41630250 | 2952 | =item Process-scope Changes |
4755096e | 2953 | |
41630250 | 2954 | =item Thread-Safety of System Libraries |
4755096e | 2955 | |
41630250 | 2956 | =item Conclusion |
4755096e | 2957 | |
41630250 | 2958 | =item Bibliography |
4755096e | 2959 | |
41630250 | 2960 | =over 4 |
4755096e | 2961 | |
41630250 | 2962 | =item Introductory Texts |
4755096e | 2963 | |
41630250 | 2964 | =item OS-Related References |
4755096e | 2965 | |
41630250 | 2966 | =item Other References |
4755096e | 2967 | |
41630250 | 2968 | =back |
4755096e | 2969 | |
41630250 | 2970 | =item Acknowledgements |
4755096e | 2971 | |
41630250 | 2972 | =item AUTHOR |
4755096e | 2973 | |
41630250 | 2974 | =item Copyrights |
4755096e GS |
2975 | |
2976 | =back | |
2977 | ||
41630250 | 2978 | =head2 perlothrtut - old tutorial on threads in Perl |
4755096e | 2979 | |
d420ca49 | 2980 | =over 4 |
4755096e GS |
2981 | |
2982 | =item DESCRIPTION | |
2983 | ||
41630250 | 2984 | =item What Is A Thread Anyway? |
4755096e | 2985 | |
41630250 | 2986 | =item Threaded Program Models |
4755096e | 2987 | |
41630250 | 2988 | =over 4 |
4755096e | 2989 | |
41630250 | 2990 | =item Boss/Worker |
4755096e | 2991 | |
41630250 | 2992 | =item Work Crew |
4755096e | 2993 | |
41630250 | 2994 | =item Pipeline |
4755096e | 2995 | |
41630250 | 2996 | =back |
4755096e | 2997 | |
41630250 | 2998 | =item Native threads |
4755096e | 2999 | |
41630250 | 3000 | =item What kind of threads are perl threads? |
4755096e | 3001 | |
41630250 | 3002 | =item Threadsafe Modules |
4755096e | 3003 | |
41630250 | 3004 | =item Thread Basics |
4755096e | 3005 | |
41630250 | 3006 | =over 4 |
4755096e | 3007 | |
41630250 | 3008 | =item Basic Thread Support |
4755096e | 3009 | |
41630250 | 3010 | =item Creating Threads |
4755096e | 3011 | |
41630250 | 3012 | =item Giving up control |
4755096e | 3013 | |
41630250 | 3014 | =item Waiting For A Thread To Exit |
4755096e | 3015 | |
41630250 | 3016 | =item Errors In Threads |
4755096e | 3017 | |
41630250 | 3018 | =item Ignoring A Thread |
4755096e GS |
3019 | |
3020 | =back | |
3021 | ||
41630250 | 3022 | =item Threads And Data |
4755096e | 3023 | |
d420ca49 | 3024 | =over 4 |
4755096e | 3025 | |
41630250 | 3026 | =item Shared And Unshared Data |
2a551100 | 3027 | |
41630250 | 3028 | =item Thread Pitfall: Races |
4755096e | 3029 | |
41630250 | 3030 | =item Controlling access: lock() |
4755096e | 3031 | |
41630250 | 3032 | =item Thread Pitfall: Deadlocks |
4755096e | 3033 | |
41630250 | 3034 | =item Queues: Passing Data Around |
4755096e | 3035 | |
41630250 | 3036 | =back |
4755096e | 3037 | |
41630250 | 3038 | =item Threads And Code |
4755096e | 3039 | |
41630250 | 3040 | =over 4 |
603b90a8 | 3041 | |
41630250 | 3042 | =item Semaphores: Synchronizing Data Access |
4755096e | 3043 | |
41630250 | 3044 | Basic semaphores, Advanced Semaphores |
4755096e | 3045 | |
41630250 | 3046 | =item Attributes: Restricting Access To Subroutines |
4755096e | 3047 | |
41630250 | 3048 | =item Subroutine Locks |
4755096e | 3049 | |
41630250 | 3050 | =item Methods |
4755096e | 3051 | |
41630250 | 3052 | =item Locking A Subroutine |
4755096e | 3053 | |
41630250 | 3054 | =back |
4755096e | 3055 | |
41630250 | 3056 | =item General Thread Utility Routines |
35bf961c | 3057 | |
41630250 | 3058 | =over 4 |
4755096e | 3059 | |
41630250 | 3060 | =item What Thread Am I In? |
4755096e | 3061 | |
41630250 | 3062 | =item Thread IDs |
4755096e | 3063 | |
41630250 | 3064 | =item Are These Threads The Same? |
4755096e | 3065 | |
41630250 | 3066 | =item What Threads Are Running? |
4755096e | 3067 | |
41630250 | 3068 | =back |
4755096e | 3069 | |
41630250 | 3070 | =item A Complete Example |
4755096e | 3071 | |
41630250 | 3072 | =item Conclusion |
4755096e | 3073 | |
41630250 | 3074 | =item Bibliography |
4755096e | 3075 | |
41630250 | 3076 | =over 4 |
4755096e | 3077 | |
41630250 | 3078 | =item Introductory Texts |
cb52f95f | 3079 | |
41630250 | 3080 | =item OS-Related References |
4755096e | 3081 | |
41630250 | 3082 | =item Other References |
4755096e | 3083 | |
41630250 | 3084 | =back |
4755096e | 3085 | |
41630250 | 3086 | =item Acknowledgements |
4755096e | 3087 | |
41630250 | 3088 | =item AUTHOR |
4755096e | 3089 | |
41630250 | 3090 | =item Copyrights |
4755096e GS |
3091 | |
3092 | =back | |
3093 | ||
41630250 | 3094 | =head2 perlport - Writing portable Perl |
4755096e | 3095 | |
d420ca49 | 3096 | =over 4 |
4755096e GS |
3097 | |
3098 | =item DESCRIPTION | |
3099 | ||
41630250 JH |
3100 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
3101 | portable | |
3102 | ||
3103 | =item ISSUES | |
4755096e | 3104 | |
d420ca49 | 3105 | =over 4 |
4755096e | 3106 | |
41630250 | 3107 | =item Newlines |
4755096e | 3108 | |
41630250 | 3109 | =item Numbers endianness and Width |
4755096e | 3110 | |
41630250 | 3111 | =item Files and Filesystems |
4755096e | 3112 | |
41630250 | 3113 | =item System Interaction |
1fdc5aa6 | 3114 | |
41630250 | 3115 | =item Command names versus file pathnames |
4755096e | 3116 | |
41630250 | 3117 | =item Networking |
4755096e | 3118 | |
41630250 | 3119 | =item Interprocess Communication (IPC) |
4755096e | 3120 | |
41630250 | 3121 | =item External Subroutines (XS) |
4755096e | 3122 | |
41630250 | 3123 | =item Standard Modules |
4755096e | 3124 | |
41630250 | 3125 | =item Time and Date |
4755096e | 3126 | |
41630250 | 3127 | =item Character sets and character encoding |
fa17183e | 3128 | |
41630250 | 3129 | =item Internationalisation |
4755096e | 3130 | |
41630250 | 3131 | =item System Resources |
4755096e | 3132 | |
41630250 | 3133 | =item Security |
4755096e | 3134 | |
41630250 | 3135 | =item Style |
4755096e | 3136 | |
41630250 | 3137 | =back |
4755096e | 3138 | |
41630250 | 3139 | =item CPAN Testers |
4755096e | 3140 | |
41630250 JH |
3141 | Mailing list: cpan-testers@perl.org, Testing results: |
3142 | http://testers.cpan.org/ | |
4755096e | 3143 | |
41630250 | 3144 | =item PLATFORMS |
4755096e | 3145 | |
d420ca49 | 3146 | =over 4 |
4755096e | 3147 | |
41630250 | 3148 | =item Unix |
4755096e | 3149 | |
41630250 | 3150 | =item DOS and Derivatives |
4755096e | 3151 | |
41630250 | 3152 | =item S<Mac OS> |
4755096e | 3153 | |
41630250 | 3154 | =item VMS |
4755096e | 3155 | |
41630250 | 3156 | =item VOS |
4755096e | 3157 | |
41630250 | 3158 | =item EBCDIC Platforms |
4755096e | 3159 | |
41630250 | 3160 | =item Acorn RISC OS |
4755096e | 3161 | |
41630250 | 3162 | =item Other perls |
4755096e | 3163 | |
41630250 | 3164 | =back |
4755096e | 3165 | |
41630250 | 3166 | =item FUNCTION IMPLEMENTATIONS |
4755096e | 3167 | |
41630250 | 3168 | =over 4 |
4755096e | 3169 | |
41630250 | 3170 | =item Alphabetical Listing of Perl Functions |
4755096e | 3171 | |
2e038148 NC |
3172 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown |
3173 | LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen | |
3174 | HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl | |
3175 | FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin, | |
3176 | getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, | |
3177 | getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, | |
3178 | getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, | |
3179 | gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent | |
3180 | STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, | |
3181 | endpwent, endgrent, endhostent, endnetent, endprotoent, endservent, | |
3182 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl | |
3183 | FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat | |
3184 | FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd | |
3185 | ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open | |
3186 | FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select | |
41630250 JH |
3187 | RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget |
3188 | KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, | |
3189 | setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt | |
3190 | SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, | |
3191 | shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, | |
3192 | socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat | |
3193 | EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
3194 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate | |
3195 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
3196 | wait, waitpid PID,FLAGS | |
4755096e | 3197 | |
41630250 | 3198 | =back |
4755096e | 3199 | |
41630250 | 3200 | =item CHANGES |
4755096e | 3201 | |
41630250 JH |
3202 | v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000, |
3203 | v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999, | |
3204 | v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April | |
3205 | 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December | |
3206 | 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August | |
3207 | 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998 | |
4755096e | 3208 | |
41630250 | 3209 | =item Supported Platforms |
4755096e | 3210 | |
41630250 | 3211 | =item SEE ALSO |
4755096e | 3212 | |
41630250 | 3213 | =item AUTHORS / CONTRIBUTORS |
4755096e GS |
3214 | |
3215 | =back | |
3216 | ||
41630250 JH |
3217 | =head2 perllocale - Perl locale handling (internationalization and |
3218 | localization) | |
4755096e | 3219 | |
d420ca49 | 3220 | =over 4 |
4755096e | 3221 | |
41630250 | 3222 | =item DESCRIPTION |
4755096e | 3223 | |
41630250 | 3224 | =item PREPARING TO USE LOCALES |
4755096e | 3225 | |
41630250 | 3226 | =item USING LOCALES |
4755096e | 3227 | |
41630250 | 3228 | =over 4 |
4755096e | 3229 | |
41630250 | 3230 | =item The use locale pragma |
4755096e | 3231 | |
41630250 | 3232 | =item The setlocale function |
4755096e | 3233 | |
41630250 | 3234 | =item Finding locales |
4755096e | 3235 | |
41630250 | 3236 | =item LOCALE PROBLEMS |
4755096e | 3237 | |
41630250 | 3238 | =item Temporarily fixing locale problems |
4755096e | 3239 | |
41630250 | 3240 | =item Permanently fixing locale problems |
a6812a52 | 3241 | |
41630250 | 3242 | =item Permanently fixing your system's locale configuration |
4755096e | 3243 | |
41630250 | 3244 | =item Fixing system locale configuration |
4755096e | 3245 | |
41630250 | 3246 | =item The localeconv function |
4755096e | 3247 | |
41630250 | 3248 | =item I18N::Langinfo |
4755096e GS |
3249 | |
3250 | =back | |
3251 | ||
41630250 | 3252 | =item LOCALE CATEGORIES |
4755096e | 3253 | |
d420ca49 | 3254 | =over 4 |
4755096e | 3255 | |
41630250 | 3256 | =item Category LC_COLLATE: Collation |
4755096e | 3257 | |
41630250 | 3258 | =item Category LC_CTYPE: Character Types |
4755096e | 3259 | |
41630250 | 3260 | =item Category LC_NUMERIC: Numeric Formatting |
4755096e | 3261 | |
41630250 | 3262 | =item Category LC_MONETARY: Formatting of monetary amounts |
4755096e | 3263 | |
41630250 | 3264 | =item LC_TIME |
4755096e | 3265 | |
41630250 | 3266 | =item Other categories |
4755096e | 3267 | |
41630250 | 3268 | =back |
4755096e | 3269 | |
41630250 | 3270 | =item SECURITY |
4755096e | 3271 | |
41630250 | 3272 | =item ENVIRONMENT |
4755096e | 3273 | |
41630250 JH |
3274 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
3275 | LC_NUMERIC, LC_TIME, LANG | |
4755096e | 3276 | |
41630250 | 3277 | =item NOTES |
4755096e | 3278 | |
41630250 | 3279 | =over 4 |
4755096e | 3280 | |
41630250 | 3281 | =item Backward compatibility |
4755096e | 3282 | |
41630250 | 3283 | =item I18N:Collate obsolete |
4755096e | 3284 | |
41630250 | 3285 | =item Sort speed and memory use impacts |
4755096e | 3286 | |
41630250 | 3287 | =item write() and LC_NUMERIC |
4755096e | 3288 | |
41630250 | 3289 | =item Freely available locale definitions |
4755096e | 3290 | |
41630250 | 3291 | =item I18n and l10n |
4755096e | 3292 | |
41630250 | 3293 | =item An imperfect standard |
4755096e | 3294 | |
41630250 | 3295 | =back |
4755096e | 3296 | |
41630250 | 3297 | =item Unicode and UTF-8 |
4755096e | 3298 | |
41630250 | 3299 | =item BUGS |
4755096e | 3300 | |
41630250 | 3301 | =over 4 |
4755096e | 3302 | |
41630250 | 3303 | =item Broken systems |
4755096e GS |
3304 | |
3305 | =back | |
3306 | ||
41630250 JH |
3307 | =item SEE ALSO |
3308 | ||
3309 | =item HISTORY | |
4755096e GS |
3310 | |
3311 | =back | |
3312 | ||
41630250 | 3313 | =head2 perluniintro - Perl Unicode introduction |
4755096e | 3314 | |
d420ca49 | 3315 | =over 4 |
4755096e GS |
3316 | |
3317 | =item DESCRIPTION | |
3318 | ||
d420ca49 | 3319 | =over 4 |
4755096e | 3320 | |
41630250 | 3321 | =item Unicode |
4755096e | 3322 | |
41630250 | 3323 | =item Perl's Unicode Support |
4755096e | 3324 | |
41630250 | 3325 | =item Perl's Unicode Model |
4755096e | 3326 | |
41630250 | 3327 | =item Unicode and EBCDIC |
2a551100 | 3328 | |
41630250 | 3329 | =item Creating Unicode |
4755096e | 3330 | |
41630250 | 3331 | =item Handling Unicode |
4755096e | 3332 | |
41630250 | 3333 | =item Legacy Encodings |
4755096e | 3334 | |
41630250 | 3335 | =item Unicode I/O |
4755096e | 3336 | |
41630250 | 3337 | =item Displaying Unicode As Text |
4755096e | 3338 | |
41630250 | 3339 | =item Special Cases |
4755096e | 3340 | |
41630250 | 3341 | =item Advanced Topics |
4755096e | 3342 | |
41630250 | 3343 | =item Miscellaneous |
4755096e | 3344 | |
41630250 | 3345 | =item Questions With Answers |
4755096e | 3346 | |
41630250 | 3347 | =item Hexadecimal Notation |
4755096e | 3348 | |
41630250 | 3349 | =item Further Resources |
4755096e | 3350 | |
41630250 | 3351 | =back |
4755096e | 3352 | |
41630250 | 3353 | =item UNICODE IN OLDER PERLS |
4755096e | 3354 | |
41630250 | 3355 | =item SEE ALSO |
4755096e | 3356 | |
41630250 | 3357 | =item ACKNOWLEDGMENTS |
4755096e | 3358 | |
41630250 | 3359 | =item AUTHOR, COPYRIGHT, AND LICENSE |
4755096e | 3360 | |
41630250 | 3361 | =back |
1fa7ca25 | 3362 | |
41630250 | 3363 | =head2 perlunicode - Unicode support in Perl |
4755096e | 3364 | |
41630250 | 3365 | =over 4 |
4755096e | 3366 | |
41630250 | 3367 | =item DESCRIPTION |
4755096e | 3368 | |
41630250 | 3369 | =over 4 |
4755096e | 3370 | |
41630250 | 3371 | =item Important Caveats |
4755096e | 3372 | |
41630250 | 3373 | Input and Output Layers, Regular Expressions, C<use utf8> still needed to |
07e9b5fe NC |
3374 | enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts |
3375 | autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings | |
4755096e | 3376 | |
41630250 | 3377 | =item Byte and Character Semantics |
4755096e | 3378 | |
41630250 | 3379 | =item Effects of Character Semantics |
4755096e | 3380 | |
41630250 | 3381 | =item Scripts |
4755096e | 3382 | |
41630250 | 3383 | =item Blocks |
4755096e | 3384 | |
41630250 | 3385 | =item User-Defined Character Properties |
4755096e | 3386 | |
41630250 | 3387 | =item Character Encodings for Input and Output |
4755096e | 3388 | |
41630250 | 3389 | =item Unicode Regular Expression Support Level |
4755096e | 3390 | |
41630250 | 3391 | =item Unicode Encodings |
4755096e | 3392 | |
41630250 | 3393 | =item Security Implications of Unicode |
4755096e | 3394 | |
41630250 JH |
3395 | =item Unicode in Perl on EBCDIC |
3396 | ||
3397 | =item Locales | |
3398 | ||
3399 | =item When Unicode Does Not Happen | |
3400 | ||
3401 | =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl) | |
3402 | ||
3403 | =item Using Unicode in XS | |
4755096e GS |
3404 | |
3405 | =back | |
3406 | ||
41630250 JH |
3407 | =item BUGS |
3408 | ||
3409 | =over 4 | |
3410 | ||
3411 | =item Interaction with Locales | |
3412 | ||
3413 | =item Interaction with Extensions | |
3414 | ||
3415 | =item Speed | |
3416 | ||
3417 | =item Porting code from perl-5.6.X | |
4755096e GS |
3418 | |
3419 | =back | |
3420 | ||
41630250 JH |
3421 | =item SEE ALSO |
3422 | ||
3423 | =back | |
3424 | ||
3425 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms | |
4755096e | 3426 | |
d420ca49 | 3427 | =over 4 |
4755096e GS |
3428 | |
3429 | =item DESCRIPTION | |
3430 | ||
41630250 JH |
3431 | =item COMMON CHARACTER CODE SETS |
3432 | ||
d420ca49 | 3433 | =over 4 |
4755096e | 3434 | |
41630250 | 3435 | =item ASCII |
4755096e | 3436 | |
41630250 | 3437 | =item ISO 8859 |
4755096e | 3438 | |
41630250 | 3439 | =item Latin 1 (ISO 8859-1) |
4755096e | 3440 | |
41630250 | 3441 | =item EBCDIC |
4755096e | 3442 | |
41630250 | 3443 | =item 13 variant characters |
4755096e | 3444 | |
41630250 | 3445 | =item 0037 |
4755096e | 3446 | |
41630250 | 3447 | =item 1047 |
4755096e | 3448 | |
41630250 | 3449 | =item POSIX-BC |
4755096e | 3450 | |
41630250 | 3451 | =item Unicode code points versus EBCDIC code points |
4755096e | 3452 | |
41630250 | 3453 | =item Remaining Perl Unicode problems in EBCDIC |
4755096e | 3454 | |
41630250 | 3455 | =item Unicode and UTF |
4755096e | 3456 | |
41630250 | 3457 | =item Using Encode |
4755096e | 3458 | |
41630250 | 3459 | =back |
4755096e | 3460 | |
41630250 | 3461 | =item SINGLE OCTET TABLES |
4755096e | 3462 | |
41630250 | 3463 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 |
4755096e | 3464 | |
41630250 | 3465 | =item IDENTIFYING CHARACTER CODE SETS |
4755096e | 3466 | |
41630250 | 3467 | =item CONVERSIONS |
4755096e | 3468 | |
41630250 | 3469 | =over 4 |
4755096e | 3470 | |
41630250 | 3471 | =item tr/// |
4755096e | 3472 | |
41630250 | 3473 | =item iconv |
4755096e | 3474 | |
41630250 | 3475 | =item C RTL |
4755096e | 3476 | |
41630250 | 3477 | =back |
4755096e | 3478 | |
41630250 | 3479 | =item OPERATOR DIFFERENCES |
4755096e | 3480 | |
41630250 JH |
3481 | =item FUNCTION DIFFERENCES |
3482 | ||
3483 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() | |
3484 | ||
3485 | =item REGULAR EXPRESSION DIFFERENCES | |
3486 | ||
3487 | =item SOCKETS | |
3488 | ||
3489 | =item SORTING | |
3490 | ||
3491 | =over 4 | |
3492 | ||
3493 | =item Ignore ASCII vs. EBCDIC sort differences. | |
3494 | ||
3495 | =item MONO CASE then sort data. | |
3496 | ||
3497 | =item Convert, sort data, then re convert. | |
3498 | ||
3499 | =item Perform sorting on one type of machine only. | |
4755096e GS |
3500 | |
3501 | =back | |
3502 | ||
41630250 JH |
3503 | =item TRANSFORMATION FORMATS |
3504 | ||
3505 | =over 4 | |
3506 | ||
3507 | =item URL decoding and encoding | |
3508 | ||
3509 | =item uu encoding and decoding | |
3510 | ||
3511 | =item Quoted-Printable encoding and decoding | |
3512 | ||
3513 | =item Caesarian ciphers | |
4755096e GS |
3514 | |
3515 | =back | |
3516 | ||
41630250 JH |
3517 | =item Hashing order and checksums |
3518 | ||
3519 | =item I18N AND L10N | |
3520 | ||
3521 | =item MULTI OCTET CHARACTER SETS | |
3522 | ||
3523 | =item OS ISSUES | |
3524 | ||
3525 | =over 4 | |
3526 | ||
3527 | =item OS/400 | |
3528 | ||
3529 | PASE, IFS access | |
3530 | ||
3531 | =item OS/390, z/OS | |
3532 | ||
3533 | chcp, dataset access, OS/390, z/OS iconv, locales | |
3534 | ||
3535 | =item VM/ESA? | |
3536 | ||
3537 | =item POSIX-BC? | |
3538 | ||
3539 | =back | |
3540 | ||
3541 | =item BUGS | |
3542 | ||
3543 | =item SEE ALSO | |
3544 | ||
3545 | =item REFERENCES | |
3546 | ||
3547 | =item HISTORY | |
3548 | ||
3549 | =item AUTHOR | |
3550 | ||
3551 | =back | |
3552 | ||
3553 | =head2 perlsec - Perl security | |
4755096e | 3554 | |
d420ca49 | 3555 | =over 4 |
4755096e GS |
3556 | |
3557 | =item DESCRIPTION | |
3558 | ||
d420ca49 | 3559 | =over 4 |
4755096e | 3560 | |
41630250 | 3561 | =item Laundering and Detecting Tainted Data |
4755096e | 3562 | |
41630250 | 3563 | =item Switches On the "#!" Line |
4755096e | 3564 | |
f262848d RGS |
3565 | =item Taint mode and @INC |
3566 | ||
41630250 | 3567 | =item Cleaning Up Your Path |
4755096e | 3568 | |
41630250 | 3569 | =item Security Bugs |
68dc0745 | 3570 | |
41630250 | 3571 | =item Protecting Your Programs |
68dc0745 | 3572 | |
41630250 | 3573 | =item Unicode |
68dc0745 | 3574 | |
41630250 | 3575 | =item Algorithmic Complexity Attacks |
68dc0745 | 3576 | |
41630250 | 3577 | =back |
68dc0745 | 3578 | |
41630250 | 3579 | =item SEE ALSO |
68dc0745 | 3580 | |
41630250 | 3581 | =back |
68dc0745 | 3582 | |
41630250 | 3583 | =head2 perlmod - Perl modules (packages and symbol tables) |
68dc0745 | 3584 | |
41630250 | 3585 | =over 4 |
68dc0745 | 3586 | |
41630250 | 3587 | =item DESCRIPTION |
46fc3d4c | 3588 | |
41630250 | 3589 | =over 4 |
68dc0745 | 3590 | |
41630250 | 3591 | =item Packages |
68dc0745 | 3592 | |
41630250 | 3593 | =item Symbol Tables |
68dc0745 | 3594 | |
f262848d | 3595 | =item BEGIN, CHECK, INIT and END |
68dc0745 | 3596 | |
41630250 | 3597 | =item Perl Classes |
68dc0745 | 3598 | |
41630250 | 3599 | =item Perl Modules |
68dc0745 | 3600 | |
41630250 | 3601 | =item Making your module threadsafe |
68dc0745 | 3602 | |
41630250 | 3603 | =back |
68dc0745 | 3604 | |
41630250 | 3605 | =item SEE ALSO |
68dc0745 | 3606 | |
41630250 | 3607 | =back |
68dc0745 | 3608 | |
41630250 | 3609 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
68dc0745 | 3610 | |
41630250 | 3611 | =over 4 |
68dc0745 | 3612 | |
41630250 | 3613 | =item THE PERL MODULE LIBRARY |
68dc0745 | 3614 | |
41630250 | 3615 | =over 4 |
46fc3d4c | 3616 | |
41630250 | 3617 | =item Pragmatic Modules |
14218588 | 3618 | |
41630250 JH |
3619 | assertions, assertions::activate, attributes, attrs, autouse, base, bigint, |
3620 | bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding, | |
3621 | fields, filetest, if, integer, less, lib, locale, open, ops, overload, re, | |
3622 | sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version, | |
3623 | vmsish, warnings, warnings::register | |
14218588 | 3624 | |
41630250 JH |
3625 | =item Standard Modules |
3626 | ||
3627 | AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, | |
3628 | B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, | |
3629 | B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, | |
3630 | B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, | |
3631 | CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, | |
3632 | CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, | |
f99d9048 RGS |
3633 | Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper, |
3634 | Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, | |
3635 | Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, | |
3636 | Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN, | |
3637 | Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder, | |
3638 | Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z, | |
3639 | Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header, | |
3640 | Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW, | |
3641 | Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter, | |
3642 | Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, | |
3643 | ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, | |
3644 | ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any, | |
3645 | ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, | |
3646 | ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN, | |
3647 | ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, | |
41630250 JH |
3648 | ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, |
3649 | ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial, | |
3650 | ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish, | |
3651 | ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, | |
3652 | ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, | |
3653 | File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find, | |
3654 | File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, | |
3655 | File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, | |
3656 | File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, | |
3657 | FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File, | |
3658 | Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags, | |
3659 | I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle, | |
3660 | IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, | |
3661 | IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, | |
3662 | IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, | |
3663 | Locale::Currency, Locale::Language, Locale::Maketext, | |
3664 | Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, | |
3665 | MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, | |
f99d9048 RGS |
3666 | Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex, |
3667 | Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, | |
3668 | Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, | |
3669 | Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd, | |
3670 | Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, | |
3671 | Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, | |
3672 | Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, | |
3673 | PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, | |
3674 | Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, | |
3675 | Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, | |
41630250 JH |
3676 | Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, |
3677 | Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, | |
3678 | Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, | |
3679 | Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, | |
3680 | Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, | |
3681 | Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, | |
3682 | Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap, | |
3683 | Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness, | |
3684 | Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps, | |
3685 | Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced, | |
3686 | Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread, | |
3687 | Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific, | |
3688 | Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, | |
3689 | Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, | |
3690 | Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, | |
3691 | Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap, | |
3692 | XSLoader | |
3693 | ||
3694 | =item Extension Modules | |
2a551100 | 3695 | |
68dc0745 | 3696 | =back |
3697 | ||
41630250 JH |
3698 | =item CPAN |
3699 | ||
3700 | =over 4 | |
3701 | ||
3702 | =item Africa | |
3703 | ||
3704 | South Africa | |
3705 | ||
3706 | =item Asia | |
3707 | ||
3708 | China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi | |
82eec310 | 3709 | Arabia, Singapore, South Korea, Taiwan, Thailand |
41630250 JH |
3710 | |
3711 | =item Central America | |
3712 | ||
3713 | Costa Rica | |
3714 | ||
3715 | =item Europe | |
3716 | ||
82eec310 JH |
3717 | Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech |
3718 | Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, | |
3719 | Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland, | |
3720 | Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland, | |
3721 | Turkey, Ukraine, United Kingdom | |
41630250 JH |
3722 | |
3723 | =item North America | |
3724 | ||
3725 | Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, | |
3726 | Alabama, California, Colorado, Delaware, District of Columbia, Florida, | |
82eec310 JH |
3727 | Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York, |
3728 | North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah, | |
3729 | Virginia, Washington, Wisconsin | |
41630250 JH |
3730 | |
3731 | =item Oceania | |
3732 | ||
3733 | Australia, New Zealand, United States | |
3734 | ||
3735 | =item South America | |
3736 | ||
3737 | Argentina, Brazil, Chile | |
3738 | ||
3739 | =item RSYNC Mirrors | |
68dc0745 | 3740 | |
a45bd81d GS |
3741 | =back |
3742 | ||
41630250 | 3743 | =item Modules: Creation, Use, and Abuse |
68dc0745 | 3744 | |
d420ca49 | 3745 | =over 4 |
a45bd81d | 3746 | |
41630250 JH |
3747 | =item Guidelines for Module Creation |
3748 | ||
3749 | =item Guidelines for Converting Perl 4 Library Scripts into Modules | |
3750 | ||
3751 | =item Guidelines for Reusing Application Code | |
3752 | ||
3753 | =back | |
3754 | ||
3755 | =item NOTE | |
3756 | ||
3757 | =back | |
3758 | ||
3759 | =head2 perlmodstyle - Perl module style guide | |
68dc0745 | 3760 | |
d420ca49 | 3761 | =over 4 |
68dc0745 | 3762 | |
41630250 | 3763 | =item INTRODUCTION |
68dc0745 | 3764 | |
41630250 | 3765 | =item QUICK CHECKLIST |
68dc0745 | 3766 | |
41630250 | 3767 | =over 4 |
68dc0745 | 3768 | |
41630250 | 3769 | =item Before you start |
68dc0745 | 3770 | |
41630250 | 3771 | =item The API |
fb9cefb4 | 3772 | |
41630250 | 3773 | =item Stability |
fb9cefb4 | 3774 | |
41630250 | 3775 | =item Documentation |
fb9cefb4 | 3776 | |
41630250 | 3777 | =item Release considerations |
fb9cefb4 | 3778 | |
41630250 | 3779 | =back |
fb9cefb4 | 3780 | |
41630250 | 3781 | =item BEFORE YOU START WRITING A MODULE |
68dc0745 | 3782 | |
41630250 | 3783 | =over 4 |
68dc0745 | 3784 | |
41630250 | 3785 | =item Has it been done before? |
68dc0745 | 3786 | |
41630250 | 3787 | =item Do one thing and do it well |
68dc0745 | 3788 | |
41630250 | 3789 | =item What's in a name? |
68dc0745 | 3790 | |
41630250 | 3791 | =back |
68dc0745 | 3792 | |
41630250 | 3793 | =item DESIGNING AND WRITING YOUR MODULE |
68dc0745 | 3794 | |
41630250 | 3795 | =over 4 |
68dc0745 | 3796 | |
41630250 | 3797 | =item To OO or not to OO? |
68dc0745 | 3798 | |
41630250 | 3799 | =item Designing your API |
68dc0745 | 3800 | |
41630250 JH |
3801 | Write simple routines to do simple things, Separate functionality from |
3802 | output, Provide sensible shortcuts and defaults, Naming conventions, | |
3803 | Parameter passing | |
68dc0745 | 3804 | |
41630250 | 3805 | =item Strictness and warnings |
68dc0745 | 3806 | |
41630250 | 3807 | =item Backwards compatibility |
68dc0745 | 3808 | |
41630250 | 3809 | =item Error handling and messages |
68dc0745 | 3810 | |
41630250 | 3811 | =back |
68dc0745 | 3812 | |
41630250 | 3813 | =item DOCUMENTING YOUR MODULE |
68dc0745 | 3814 | |
41630250 | 3815 | =over 4 |
68dc0745 | 3816 | |
41630250 JH |
3817 | =item POD |
3818 | ||
3819 | =item README, INSTALL, release notes, changelogs | |
3820 | ||
3821 | perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build, | |
3822 | perl Build test, perl Build install | |
3823 | ||
3824 | =back | |
3825 | ||
3826 | =item RELEASE CONSIDERATIONS | |
3fe9a6f1 | 3827 | |
41630250 | 3828 | =over 4 |
68dc0745 | 3829 | |
41630250 | 3830 | =item Version numbering |
68dc0745 | 3831 | |
41630250 | 3832 | =item Pre-requisites |
68dc0745 | 3833 | |
41630250 | 3834 | =item Testing |
68dc0745 | 3835 | |
41630250 | 3836 | =item Packaging |
68dc0745 | 3837 | |
41630250 | 3838 | =item Licensing |
68dc0745 | 3839 | |
41630250 | 3840 | =back |
68dc0745 | 3841 | |
41630250 | 3842 | =item COMMON PITFALLS |
68dc0745 | 3843 | |
41630250 | 3844 | =over 4 |
68dc0745 | 3845 | |
41630250 | 3846 | =item Reinventing the wheel |
68dc0745 | 3847 | |
41630250 | 3848 | =item Trying to do too much |
68dc0745 | 3849 | |
41630250 | 3850 | =item Inappropriate documentation |
68dc0745 | 3851 | |
41630250 | 3852 | =back |
68dc0745 | 3853 | |
41630250 | 3854 | =item SEE ALSO |
68dc0745 | 3855 | |
41630250 JH |
3856 | L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools, |
3857 | Testing tools, http://pause.perl.org/, Any good book on software | |
3858 | engineering | |
68dc0745 | 3859 | |
41630250 | 3860 | =item AUTHOR |
68dc0745 | 3861 | |
41630250 | 3862 | =back |
68dc0745 | 3863 | |
41630250 | 3864 | =head2 perlmodinstall - Installing CPAN Modules |
68dc0745 | 3865 | |
41630250 | 3866 | =over 4 |
68dc0745 | 3867 | |
41630250 | 3868 | =item DESCRIPTION |
68dc0745 | 3869 | |
41630250 | 3870 | =over 4 |
68dc0745 | 3871 | |
41630250 | 3872 | =item PREAMBLE |
fb9cefb4 | 3873 | |
41630250 JH |
3874 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
3875 | module (sometimes unnecessary), B<INSTALL> the module | |
46fc3d4c | 3876 | |
41630250 | 3877 | =back |
46fc3d4c | 3878 | |
41630250 | 3879 | =item PORTABILITY |
46fc3d4c | 3880 | |
41630250 | 3881 | =item HEY |
14218588 | 3882 | |
41630250 | 3883 | =item AUTHOR |
68dc0745 | 3884 | |
41630250 | 3885 | =item COPYRIGHT |
fc36a67e | 3886 | |
a45bd81d GS |
3887 | =back |
3888 | ||
41630250 | 3889 | =head2 perlnewmod - preparing a new module for distribution |
68dc0745 | 3890 | |
d420ca49 | 3891 | =over 4 |
a45bd81d | 3892 | |
68dc0745 | 3893 | =item DESCRIPTION |
3894 | ||
d420ca49 | 3895 | =over 4 |
68dc0745 | 3896 | |
41630250 | 3897 | =item Warning |
fb9cefb4 | 3898 | |
41630250 | 3899 | =item What should I make into a module? |
68dc0745 | 3900 | |
41630250 | 3901 | =item Step-by-step: Preparing the ground |
68dc0745 | 3902 | |
41630250 | 3903 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
68dc0745 | 3904 | |
41630250 | 3905 | =item Step-by-step: Making the module |
68dc0745 | 3906 | |
e4bb216d NC |
3907 | Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and |
3908 | L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, | |
3909 | Use L<plain old documentation|perlpod>, Write tests, Write the README | |
68dc0745 | 3910 | |
41630250 | 3911 | =item Step-by-step: Distributing your module |
68dc0745 | 3912 | |
41630250 JH |
3913 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
3914 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
fb9cefb4 | 3915 | |
41630250 | 3916 | =back |
68dc0745 | 3917 | |
41630250 | 3918 | =item AUTHOR |
68dc0745 | 3919 | |
41630250 | 3920 | =item SEE ALSO |
68dc0745 | 3921 | |
41630250 | 3922 | =back |
68dc0745 | 3923 | |
41630250 | 3924 | =head2 perlutil - utilities packaged with the Perl distribution |
46fc3d4c | 3925 | |
41630250 | 3926 | =over 4 |
68dc0745 | 3927 | |
41630250 | 3928 | =item DESCRIPTION |
68dc0745 | 3929 | |
41630250 | 3930 | =over 4 |
68dc0745 | 3931 | |
41630250 | 3932 | =item DOCUMENTATION |
68dc0745 | 3933 | |
41630250 JH |
3934 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, |
3935 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
3936 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
3937 | L<roffitall|roffitall> | |
68dc0745 | 3938 | |
41630250 | 3939 | =item CONVERTORS |
fb9cefb4 | 3940 | |
41630250 | 3941 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
2d967e39 | 3942 | |
41630250 | 3943 | =item Administration |
68dc0745 | 3944 | |
41630250 | 3945 | L<libnetcfg|libnetcfg> |
68dc0745 | 3946 | |
41630250 | 3947 | =item Development |
68dc0745 | 3948 | |
41630250 JH |
3949 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
3950 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
68dc0745 | 3951 | |
41630250 | 3952 | =item SEE ALSO |
68dc0745 | 3953 | |
3954 | =back | |
3955 | ||
a45bd81d GS |
3956 | =back |
3957 | ||
4755096e | 3958 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
a45bd81d | 3959 | |
d420ca49 | 3960 | =over 4 |
cb1a09d0 | 3961 | |
8ebc5c01 | 3962 | =item DESCRIPTION |
cb1a09d0 | 3963 | |
d420ca49 | 3964 | =over 4 |
fb9cefb4 | 3965 | |
4755096e | 3966 | =item Layout |
a45bd81d | 3967 | |
4755096e | 3968 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
637e9122 | 3969 | |
4755096e | 3970 | =back |
c76ac1ee | 3971 | |
4755096e | 3972 | =item Using The Back Ends |
c76ac1ee | 3973 | |
d420ca49 | 3974 | =over 4 |
694468e3 | 3975 | |
4755096e | 3976 | =item The Cross Referencing Back End |
c76ac1ee | 3977 | |
4755096e | 3978 | i, &, s, r |
637e9122 | 3979 | |
4755096e | 3980 | =item The Decompiling Back End |
37590e52 | 3981 | |
4755096e | 3982 | =item The Lint Back End |
c76ac1ee | 3983 | |
4755096e | 3984 | =item The Simple C Back End |
37590e52 | 3985 | |
4755096e | 3986 | =item The Bytecode Back End |
a45bd81d | 3987 | |
4755096e | 3988 | =item The Optimized C Back End |
a45bd81d | 3989 | |
4755096e | 3990 | =back |
b38f6a39 | 3991 | |
e993db8c JH |
3992 | =item Module List for the Compiler Suite |
3993 | ||
3994 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, | |
3995 | B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, | |
3996 | B::Stackobj, B::Stash, B::Terse, B::Xref | |
3997 | ||
4755096e | 3998 | =item KNOWN PROBLEMS |
fb9cefb4 | 3999 | |
4755096e | 4000 | =item AUTHOR |
c76ac1ee | 4001 | |
4755096e | 4002 | =back |
a45bd81d | 4003 | |
41630250 JH |
4004 | =head2 perlfilter - Source Filters |
4005 | ||
4006 | =over 4 | |
4007 | ||
4008 | =item DESCRIPTION | |
4009 | ||
4010 | =item CONCEPTS | |
4011 | ||
4012 | =item USING FILTERS | |
4013 | ||
4014 | =item WRITING A SOURCE FILTER | |
4015 | ||
4016 | =item WRITING A SOURCE FILTER IN C | |
4017 | ||
4018 | B<Decryption Filters> | |
4019 | ||
4020 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE | |
4021 | ||
4022 | =item WRITING A SOURCE FILTER IN PERL | |
4023 | ||
4024 | =item USING CONTEXT: THE DEBUG FILTER | |
4025 | ||
4026 | =item CONCLUSION | |
4027 | ||
4028 | =item THINGS TO LOOK OUT FOR | |
4029 | ||
4030 | Some Filters Clobber the C<DATA> Handle | |
4031 | ||
4032 | =item REQUIREMENTS | |
4033 | ||
4034 | =item AUTHOR | |
4035 | ||
4036 | =item Copyrights | |
4037 | ||
4038 | =back | |
4039 | ||
4755096e | 4040 | =head2 perlembed - how to embed perl in your C program |
c76ac1ee | 4041 | |
d420ca49 | 4042 | =over 4 |
a45bd81d | 4043 | |
4755096e | 4044 | =item DESCRIPTION |
fb9cefb4 | 4045 | |
d420ca49 | 4046 | =over 4 |
c76ac1ee | 4047 | |
4755096e | 4048 | =item PREAMBLE |
fb9cefb4 | 4049 | |
4755096e GS |
4050 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
4051 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
fb9cefb4 | 4052 | |
4755096e | 4053 | =item ROADMAP |
fb9cefb4 | 4054 | |
4755096e | 4055 | =item Compiling your C program |
c76ac1ee | 4056 | |
4755096e | 4057 | =item Adding a Perl interpreter to your C program |
c76ac1ee | 4058 | |
4755096e | 4059 | =item Calling a Perl subroutine from your C program |
fb9cefb4 | 4060 | |
4755096e | 4061 | =item Evaluating a Perl statement from your C program |
c76ac1ee | 4062 | |
4755096e | 4063 | =item Performing Perl pattern matches and substitutions from your C program |
c76ac1ee | 4064 | |
4755096e | 4065 | =item Fiddling with the Perl stack from your C program |
37590e52 | 4066 | |
4755096e | 4067 | =item Maintaining a persistent interpreter |
c76ac1ee | 4068 | |
53d7eaa8 JH |
4069 | =item Execution of END blocks |
4070 | ||
4755096e | 4071 | =item Maintaining multiple interpreter instances |
694468e3 | 4072 | |
4755096e GS |
4073 | =item Using Perl modules, which themselves use C libraries, from your C |
4074 | program | |
c76ac1ee | 4075 | |
14218588 | 4076 | =back |
fb9cefb4 | 4077 | |
d420ca49 | 4078 | =item Embedding Perl under Win32 |
fb9cefb4 | 4079 | |
2a551100 JH |
4080 | =item Hiding Perl_ |
4081 | ||
4755096e | 4082 | =item MORAL |
c76ac1ee | 4083 | |
4755096e | 4084 | =item AUTHOR |
fb9cefb4 | 4085 | |
4755096e | 4086 | =item COPYRIGHT |
c76ac1ee | 4087 | |
4755096e | 4088 | =back |
c76ac1ee | 4089 | |
4755096e | 4090 | =head2 perldebguts - Guts of Perl debugging |
a45bd81d | 4091 | |
d420ca49 | 4092 | =over 4 |
c76ac1ee | 4093 | |
4755096e | 4094 | =item DESCRIPTION |
c76ac1ee | 4095 | |
4755096e | 4096 | =item Debugger Internals |
c76ac1ee | 4097 | |
d420ca49 | 4098 | =over 4 |
c76ac1ee | 4099 | |
4755096e | 4100 | =item Writing Your Own Debugger |
c76ac1ee | 4101 | |
37590e52 | 4102 | =back |
c76ac1ee | 4103 | |
4755096e | 4104 | =item Frame Listing Output Examples |
c76ac1ee | 4105 | |
4755096e | 4106 | =item Debugging regular expressions |
c76ac1ee | 4107 | |
d420ca49 | 4108 | =over 4 |
c76ac1ee | 4109 | |
4755096e | 4110 | =item Compile-time output |
c76ac1ee | 4111 | |
4755096e GS |
4112 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
4113 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
4114 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
4115 | C<anchored(TYPE)> | |
c76ac1ee | 4116 | |
4755096e | 4117 | =item Types of nodes |
c76ac1ee | 4118 | |
4755096e | 4119 | =item Run-time output |
c76ac1ee | 4120 | |
37590e52 | 4121 | =back |
c76ac1ee | 4122 | |
4755096e | 4123 | =item Debugging Perl memory usage |
c76ac1ee | 4124 | |
d420ca49 | 4125 | =over 4 |
c76ac1ee | 4126 | |
4755096e | 4127 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
c76ac1ee | 4128 | |
4755096e GS |
4129 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
4130 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
4131 | 6144> | |
c76ac1ee | 4132 | |
4755096e | 4133 | =item Example of using B<-DL> switch |
c76ac1ee | 4134 | |
4755096e | 4135 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> |
c76ac1ee | 4136 | |
4755096e | 4137 | =item B<-DL> details |
37590e52 | 4138 | |
4755096e | 4139 | C<!!!>, C<!!>, C<!> |
37590e52 | 4140 | |
4755096e | 4141 | =item Limitations of B<-DL> statistics |
37590e52 | 4142 | |
4755096e | 4143 | =back |
37590e52 | 4144 | |
4755096e | 4145 | =item SEE ALSO |
c76ac1ee GS |
4146 | |
4147 | =back | |
4148 | ||
4755096e | 4149 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
c76ac1ee | 4150 | |
d420ca49 | 4151 | =over 4 |
c76ac1ee | 4152 | |
4755096e | 4153 | =item DESCRIPTION |
c76ac1ee | 4154 | |
4755096e | 4155 | =item SPECIAL NOTES |
c76ac1ee | 4156 | |
d420ca49 | 4157 | =over 4 |
c76ac1ee | 4158 | |
4755096e | 4159 | =item make |
c76ac1ee | 4160 | |
4755096e GS |
4161 | =item Version caveat |
4162 | ||
4163 | =item Dynamic Loading versus Static Loading | |
c76ac1ee GS |
4164 | |
4165 | =back | |
fb9cefb4 | 4166 | |
4755096e | 4167 | =item TUTORIAL |
cb1a09d0 | 4168 | |
d420ca49 | 4169 | =over 4 |
8ebc5c01 | 4170 | |
4755096e | 4171 | =item EXAMPLE 1 |
fb9cefb4 | 4172 | |
4755096e | 4173 | =item EXAMPLE 2 |
fb9cefb4 | 4174 | |
4755096e | 4175 | =item What has gone on? |
5cd24f17 | 4176 | |
4755096e | 4177 | =item Writing good test scripts |
cb1a09d0 | 4178 | |
4755096e | 4179 | =item EXAMPLE 3 |
774d564b | 4180 | |
4755096e | 4181 | =item What's new here? |
c76ac1ee | 4182 | |
4755096e | 4183 | =item Input and Output Parameters |
c76ac1ee | 4184 | |
4755096e | 4185 | =item The XSUBPP Program |
b38f6a39 | 4186 | |
4755096e | 4187 | =item The TYPEMAP file |
c76ac1ee | 4188 | |
4755096e | 4189 | =item Warning about Output Arguments |
37590e52 | 4190 | |
4755096e | 4191 | =item EXAMPLE 4 |
37590e52 | 4192 | |
4755096e | 4193 | =item What has happened here? |
c76ac1ee | 4194 | |
4755096e | 4195 | =item Anatomy of .xs file |
37590e52 | 4196 | |
4755096e | 4197 | =item Getting the fat out of XSUBs |
cb1a09d0 | 4198 | |
4755096e | 4199 | =item More about XSUB arguments |
37590e52 | 4200 | |
4755096e | 4201 | =item The Argument Stack |
a45bd81d | 4202 | |
4755096e | 4203 | =item Extending your Extension |
a45bd81d | 4204 | |
4755096e | 4205 | =item Documenting your Extension |
37590e52 | 4206 | |
4755096e | 4207 | =item Installing your Extension |
37590e52 | 4208 | |
4755096e | 4209 | =item EXAMPLE 5 |
37590e52 | 4210 | |
4755096e | 4211 | =item New Things in this Example |
37590e52 | 4212 | |
4755096e | 4213 | =item EXAMPLE 6 |
37590e52 | 4214 | |
4755096e | 4215 | =item New Things in this Example |
37590e52 | 4216 | |
4755096e | 4217 | =item EXAMPLE 7 (Coming Soon) |
37590e52 | 4218 | |
4755096e | 4219 | =item EXAMPLE 8 (Coming Soon) |
37590e52 | 4220 | |
849d92fd | 4221 | =item EXAMPLE 9 Passing open files to XSes |
37590e52 | 4222 | |
4755096e | 4223 | =item Troubleshooting these Examples |
37590e52 | 4224 | |
4755096e | 4225 | =back |
37590e52 | 4226 | |
4755096e | 4227 | =item See also |
37590e52 | 4228 | |
4755096e | 4229 | =item Author |
37590e52 | 4230 | |
d420ca49 | 4231 | =over 4 |
37590e52 | 4232 | |
4755096e | 4233 | =item Last Changed |
37590e52 GS |
4234 | |
4235 | =back | |
4236 | ||
4755096e GS |
4237 | =back |
4238 | ||
4239 | =head2 perlxs - XS language reference manual | |
37590e52 | 4240 | |
d420ca49 | 4241 | =over 4 |
37590e52 | 4242 | |
4755096e | 4243 | =item DESCRIPTION |
37590e52 | 4244 | |
d420ca49 | 4245 | =over 4 |
37590e52 | 4246 | |
4755096e | 4247 | =item Introduction |
37590e52 | 4248 | |
4755096e | 4249 | =item On The Road |
37590e52 | 4250 | |
4755096e | 4251 | =item The Anatomy of an XSUB |
37590e52 | 4252 | |
4755096e | 4253 | =item The Argument Stack |
37590e52 | 4254 | |
4755096e | 4255 | =item The RETVAL Variable |
37590e52 | 4256 | |
f99d9048 RGS |
4257 | =item Returning SVs, AVs and HVs through RETVAL |
4258 | ||
4755096e | 4259 | =item The MODULE Keyword |
37590e52 | 4260 | |
4755096e | 4261 | =item The PACKAGE Keyword |
37590e52 | 4262 | |
4755096e | 4263 | =item The PREFIX Keyword |
37590e52 | 4264 | |
4755096e | 4265 | =item The OUTPUT: Keyword |
fb9cefb4 | 4266 | |
91331b4f JH |
4267 | =item The NO_OUTPUT Keyword |
4268 | ||
4755096e GS |
4269 | =item The CODE: Keyword |
4270 | ||
4271 | =item The INIT: Keyword | |
4272 | ||
4273 | =item The NO_INIT Keyword | |
4274 | ||
4275 | =item Initializing Function Parameters | |
4276 | ||
4277 | =item Default Parameter Values | |
4278 | ||
4279 | =item The PREINIT: Keyword | |
4280 | ||
4281 | =item The SCOPE: Keyword | |
4282 | ||
4283 | =item The INPUT: Keyword | |
4284 | ||
165c0277 | 4285 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords |
91331b4f | 4286 | |
ff426ff2 JH |
4287 | =item The C<length(NAME)> Keyword |
4288 | ||
4755096e GS |
4289 | =item Variable-length Parameter Lists |
4290 | ||
4291 | =item The C_ARGS: Keyword | |
4292 | ||
4293 | =item The PPCODE: Keyword | |
4294 | ||
4295 | =item Returning Undef And Empty Lists | |
4296 | ||
4297 | =item The REQUIRE: Keyword | |
fb9cefb4 | 4298 | |
4755096e | 4299 | =item The CLEANUP: Keyword |
fb9cefb4 | 4300 | |
354a27bf | 4301 | =item The POSTCALL: Keyword |
91331b4f | 4302 | |
4755096e | 4303 | =item The BOOT: Keyword |
cb1a09d0 | 4304 | |
4755096e | 4305 | =item The VERSIONCHECK: Keyword |
cb1a09d0 | 4306 | |
4755096e | 4307 | =item The PROTOTYPES: Keyword |
cb1a09d0 | 4308 | |
4755096e | 4309 | =item The PROTOTYPE: Keyword |
a45bd81d | 4310 | |
4755096e | 4311 | =item The ALIAS: Keyword |
cb1a09d0 | 4312 | |
940adb21 JH |
4313 | =item The OVERLOAD: Keyword |
4314 | ||
2a551100 JH |
4315 | =item The FALLBACK: Keyword |
4316 | ||
4755096e | 4317 | =item The INTERFACE: Keyword |
a45bd81d | 4318 | |
4755096e | 4319 | =item The INTERFACE_MACRO: Keyword |
cb1a09d0 | 4320 | |
4755096e | 4321 | =item The INCLUDE: Keyword |
cb1a09d0 | 4322 | |
4755096e | 4323 | =item The CASE: Keyword |
cb1a09d0 | 4324 | |
4755096e | 4325 | =item The & Unary Operator |
cb1a09d0 | 4326 | |
2cc61e15 | 4327 | =item Inserting POD, Comments and C Preprocessor Directives |
cb1a09d0 | 4328 | |
4755096e | 4329 | =item Using XS With C++ |
cb1a09d0 | 4330 | |
4755096e | 4331 | =item Interface Strategy |
cb1a09d0 | 4332 | |
4755096e | 4333 | =item Perl Objects And C Structures |
14218588 | 4334 | |
4755096e | 4335 | =item The Typemap |
cb1a09d0 | 4336 | |
07fcf8ff JH |
4337 | =item Safely Storing Static Data in XS |
4338 | ||
4339 | MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT | |
4340 | ||
8ebc5c01 | 4341 | =back |
cb1a09d0 | 4342 | |
4755096e GS |
4343 | =item EXAMPLES |
4344 | ||
4345 | =item XS VERSION | |
4346 | ||
4347 | =item AUTHOR | |
14218588 | 4348 | |
a45bd81d GS |
4349 | =back |
4350 | ||
f40a6c71 SC |
4351 | =head2 perlclib - Internal replacements for standard C library functions |
4352 | ||
4353 | =over 4 | |
4354 | ||
4355 | =item DESCRIPTION | |
4356 | ||
4357 | =over 4 | |
4358 | ||
4359 | =item Conventions | |
4360 | ||
4361 | C<t>, C<p>, C<n>, C<s> | |
4362 | ||
4363 | =item File Operations | |
4364 | ||
4365 | =item File Input and Output | |
4366 | ||
4367 | =item File Positioning | |
4368 | ||
4369 | =item Memory Management and String Handling | |
4370 | ||
4371 | =item Character Class Tests | |
4372 | ||
4373 | =item F<stdlib.h> functions | |
4374 | ||
4375 | =item Miscellaneous functions | |
4376 | ||
4377 | =back | |
4378 | ||
4379 | =item SEE ALSO | |
4380 | ||
4381 | =back | |
4382 | ||
4755096e | 4383 | =head2 perlguts - Introduction to the Perl API |
cb1a09d0 | 4384 | |
d420ca49 | 4385 | =over 4 |
a45bd81d | 4386 | |
8ebc5c01 | 4387 | =item DESCRIPTION |
cb1a09d0 | 4388 | |
4755096e | 4389 | =item Variables |
cb1a09d0 | 4390 | |
d420ca49 | 4391 | =over 4 |
cb1a09d0 | 4392 | |
4755096e | 4393 | =item Datatypes |
cb1a09d0 | 4394 | |
4755096e | 4395 | =item What is an "IV"? |
cb1a09d0 | 4396 | |
4755096e | 4397 | =item Working with SVs |
cb1a09d0 | 4398 | |
37d4d706 JH |
4399 | =item Offsets |
4400 | ||
4755096e | 4401 | =item What's Really Stored in an SV? |
cb1a09d0 | 4402 | |
4755096e | 4403 | =item Working with AVs |
cb1a09d0 | 4404 | |
4755096e | 4405 | =item Working with HVs |
cb1a09d0 | 4406 | |
4755096e | 4407 | =item Hash API Extensions |
cb1a09d0 | 4408 | |
0d53b15f JH |
4409 | =item AVs, HVs and undefined values |
4410 | ||
4755096e | 4411 | =item References |
cb1a09d0 | 4412 | |
4755096e | 4413 | =item Blessed References and Class Objects |
774d564b | 4414 | |
4755096e | 4415 | =item Creating New Variables |
cb1a09d0 | 4416 | |
d8416318 JH |
4417 | GV_ADDMULTI, GV_ADDWARN |
4418 | ||
4755096e | 4419 | =item Reference Counts and Mortality |
a45bd81d | 4420 | |
4755096e | 4421 | =item Stashes and Globs |
cb1a09d0 | 4422 | |
4755096e | 4423 | =item Double-Typed SVs |
a45bd81d | 4424 | |
4755096e | 4425 | =item Magic Variables |
cb1a09d0 | 4426 | |
4755096e | 4427 | =item Assigning Magic |
cb1a09d0 | 4428 | |
4755096e | 4429 | =item Magic Virtual Tables |
cb1a09d0 | 4430 | |
4755096e | 4431 | =item Finding Magic |
cb1a09d0 | 4432 | |
4755096e | 4433 | =item Understanding the Magic of Tied Hashes and Arrays |
cb1a09d0 | 4434 | |
4755096e | 4435 | =item Localizing changes |
cb1a09d0 | 4436 | |
4755096e | 4437 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
e42c74e1 JH |
4438 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV |
4439 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, | |
4440 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, | |
4441 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, | |
4442 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* | |
4443 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
4444 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
4445 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
4446 | save_hptr(HV **hptr)> | |
cb1a09d0 | 4447 | |
4755096e | 4448 | =back |
cb1a09d0 | 4449 | |
4755096e | 4450 | =item Subroutines |
cb1a09d0 | 4451 | |
d420ca49 | 4452 | =over 4 |
cb1a09d0 | 4453 | |
4755096e | 4454 | =item XSUBs and the Argument Stack |
cb1a09d0 | 4455 | |
4755096e | 4456 | =item Calling Perl Routines from within C Programs |
cb1a09d0 | 4457 | |
4755096e | 4458 | =item Memory Allocation |
cb1a09d0 | 4459 | |
4755096e | 4460 | =item PerlIO |
cb1a09d0 | 4461 | |
4755096e | 4462 | =item Putting a C value on Perl stack |
cb1a09d0 | 4463 | |
4755096e | 4464 | =item Scratchpads |
cb1a09d0 | 4465 | |
4755096e | 4466 | =item Scratchpads and recursion |
cb1a09d0 | 4467 | |
4755096e | 4468 | =back |
cb1a09d0 | 4469 | |
4755096e | 4470 | =item Compiled code |
cb1a09d0 | 4471 | |
d420ca49 | 4472 | =over 4 |
cb1a09d0 | 4473 | |
4755096e | 4474 | =item Code tree |
cb1a09d0 | 4475 | |
4755096e | 4476 | =item Examining the tree |
cb1a09d0 | 4477 | |
4755096e | 4478 | =item Compile pass 1: check routines |
cb1a09d0 | 4479 | |
4755096e | 4480 | =item Compile pass 1a: constant folding |
cb1a09d0 | 4481 | |
4755096e | 4482 | =item Compile pass 2: context propagation |
cb1a09d0 | 4483 | |
4755096e | 4484 | =item Compile pass 3: peephole optimization |
cb1a09d0 | 4485 | |
27713a04 JH |
4486 | =item Pluggable runops |
4487 | ||
4755096e | 4488 | =back |
cb1a09d0 | 4489 | |
165c0277 JH |
4490 | =item Examining internal data structures with the C<dump> functions |
4491 | ||
4755096e | 4492 | =item How multiple interpreters and concurrency are supported |
cb1a09d0 | 4493 | |
d420ca49 | 4494 | =over 4 |
cb1a09d0 | 4495 | |
4755096e | 4496 | =item Background and PERL_IMPLICIT_CONTEXT |
cb1a09d0 | 4497 | |
0d0e97a6 JH |
4498 | =item So what happened to dTHR? |
4499 | ||
4755096e | 4500 | =item How do I use all this in extensions? |
cb1a09d0 | 4501 | |
0d0e97a6 JH |
4502 | =item Should I do anything special if I call perl from multiple threads? |
4503 | ||
4755096e | 4504 | =item Future Plans and PERL_IMPLICIT_SYS |
cb1a09d0 | 4505 | |
4755096e | 4506 | =back |
fb9cefb4 | 4507 | |
7029d033 JH |
4508 | =item Internal Functions |
4509 | ||
2baadb76 | 4510 | A, p, d, s, n, r, f, M, o, x, m, X, E, b |
7029d033 | 4511 | |
d420ca49 | 4512 | =over 4 |
7029d033 | 4513 | |
a9ef4385 | 4514 | =item Formatted Printing of IVs, UVs, and NVs |
91e74348 | 4515 | |
9fa7f388 JH |
4516 | =item Pointer-To-Integer and Integer-To-Pointer |
4517 | ||
7029d033 JH |
4518 | =item Source Documentation |
4519 | ||
df344c0f NC |
4520 | =item Backwards compatibility |
4521 | ||
7029d033 JH |
4522 | =back |
4523 | ||
4524 | =item Unicode Support | |
4525 | ||
d420ca49 | 4526 | =over 4 |
7029d033 JH |
4527 | |
4528 | =item What B<is> Unicode, anyway? | |
4529 | ||
1e54db1a | 4530 | =item How can I recognise a UTF-8 string? |
7029d033 | 4531 | |
1e54db1a | 4532 | =item How does UTF-8 represent Unicode characters? |
7029d033 | 4533 | |
1e54db1a | 4534 | =item How does Perl store UTF-8 strings? |
7029d033 | 4535 | |
1e54db1a | 4536 | =item How do I convert a string to UTF-8? |
7029d033 JH |
4537 | |
4538 | =item Is there anything else I need to know? | |
4539 | ||
4540 | =back | |
4541 | ||
53d7eaa8 JH |
4542 | =item Custom Operators |
4543 | ||
41630250 | 4544 | =item AUTHORS |
4755096e | 4545 | |
41630250 | 4546 | =item SEE ALSO |
1e422769 | 4547 | |
a45bd81d GS |
4548 | =back |
4549 | ||
41630250 | 4550 | =head2 perlcall - Perl calling conventions from C |
cb1a09d0 | 4551 | |
d420ca49 | 4552 | =over 4 |
a45bd81d | 4553 | |
cb1a09d0 AD |
4554 | =item DESCRIPTION |
4555 | ||
41630250 | 4556 | An Error Handler, An Event Driven Program |
a6fb92f1 | 4557 | |
41630250 | 4558 | =item THE CALL_ FUNCTIONS |
a6fb92f1 | 4559 | |
41630250 | 4560 | call_sv, call_pv, call_method, call_argv |
14218588 | 4561 | |
41630250 | 4562 | =item FLAG VALUES |
cb1a09d0 | 4563 | |
41630250 | 4564 | =over 4 |
cb1a09d0 | 4565 | |
41630250 | 4566 | =item G_VOID |
cb1a09d0 | 4567 | |
41630250 | 4568 | =item G_SCALAR |
a45bd81d | 4569 | |
41630250 | 4570 | =item G_ARRAY |
cb1a09d0 | 4571 | |
41630250 | 4572 | =item G_DISCARD |
a45bd81d | 4573 | |
41630250 | 4574 | =item G_NOARGS |
cb1a09d0 | 4575 | |
41630250 | 4576 | =item G_EVAL |
cb1a09d0 | 4577 | |
41630250 | 4578 | =item G_KEEPERR |
cb1a09d0 | 4579 | |
41630250 | 4580 | =item Determining the Context |
cb1a09d0 | 4581 | |
41630250 | 4582 | =back |
fb9cefb4 | 4583 | |
41630250 | 4584 | =item KNOWN PROBLEMS |
14218588 | 4585 | |
41630250 | 4586 | =item EXAMPLES |
cb1a09d0 | 4587 | |
41630250 | 4588 | =over 4 |
4755096e | 4589 | |
41630250 | 4590 | =item No Parameters, Nothing returned |
4755096e | 4591 | |
41630250 | 4592 | =item Passing Parameters |
4755096e | 4593 | |
41630250 | 4594 | =item Returning a Scalar |
8b9c797b | 4595 | |
41630250 | 4596 | =item Returning a list of values |
8b9c797b | 4597 | |
41630250 | 4598 | =item Returning a list in a scalar context |
4755096e | 4599 | |
41630250 | 4600 | =item Returning Data from Perl via the parameter list |
4755096e | 4601 | |
41630250 | 4602 | =item Using G_EVAL |
14218588 | 4603 | |
41630250 | 4604 | =item Using G_KEEPERR |
a45bd81d | 4605 | |
41630250 | 4606 | =item Using call_sv |
cb1a09d0 | 4607 | |
41630250 | 4608 | =item Using call_argv |
a45bd81d | 4609 | |
41630250 | 4610 | =item Using call_method |
cb1a09d0 | 4611 | |
41630250 | 4612 | =item Using GIMME_V |
cb1a09d0 | 4613 | |
41630250 | 4614 | =item Using Perl to dispose of temporaries |
cb1a09d0 | 4615 | |
41630250 | 4616 | =item Strategies for storing Callback Context Information |
193fb0af | 4617 | |
41630250 JH |
4618 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
4619 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
4620 | callback | |
cb1a09d0 | 4621 | |
41630250 | 4622 | =item Alternate Stack Manipulation |
c76ac1ee | 4623 | |
41630250 | 4624 | =item Creating and calling an anonymous subroutine in C |
cb1a09d0 | 4625 | |
4755096e | 4626 | =back |
193fb0af | 4627 | |
4755096e | 4628 | =item SEE ALSO |
193fb0af | 4629 | |
4755096e | 4630 | =item AUTHOR |
cb1a09d0 | 4631 | |
41630250 JH |
4632 | =item DATE |
4633 | ||
4755096e | 4634 | =back |
cb1a09d0 | 4635 | |
4755096e | 4636 | =head2 perlapi - autogenerated documentation for the perl public API |
44a8e56a | 4637 | |
d420ca49 | 4638 | =over 4 |
cb1a09d0 | 4639 | |
4755096e | 4640 | =item DESCRIPTION |
cb1a09d0 | 4641 | |
04b01f78 JH |
4642 | =item "Gimme" Values |
4643 | ||
4644 | GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID | |
4645 | ||
4646 | =item Array Manipulation Functions | |
4647 | ||
7029d033 JH |
4648 | AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, |
4649 | av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, | |
07e9b5fe | 4650 | get_av, newAV, sortsv |
04b01f78 JH |
4651 | |
4652 | =item Callback Functions | |
4653 | ||
4654 | call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv, | |
4655 | FREETMPS, LEAVE, SAVETMPS | |
4656 | ||
4657 | =item Character classes | |
4658 | ||
4659 | isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER | |
4660 | ||
4661 | =item Cloning an interpreter | |
4662 | ||
4663 | perl_clone | |
4664 | ||
4665 | =item CV Manipulation Functions | |
4666 | ||
07e9b5fe | 4667 | CvSTASH, get_cv |
04b01f78 JH |
4668 | |
4669 | =item Embedding Functions | |
4670 | ||
2a551100 JH |
4671 | cv_undef, load_module, nothreadhook, perl_alloc, perl_construct, |
4672 | perl_destruct, perl_free, perl_parse, perl_run, require_pv | |
04b01f78 | 4673 | |
ff426ff2 JH |
4674 | =item Functions in file pp_pack.c |
4675 | ||
8b9c797b | 4676 | packlist, pack_cat, unpackstring, unpack_str |
ff426ff2 | 4677 | |
04b01f78 JH |
4678 | =item Global Variables |
4679 | ||
4680 | PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes | |
4681 | ||
4682 | =item GV Functions | |
4683 | ||
80327a3d | 4684 | GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, |
df344c0f | 4685 | gv_fetchmeth_autoload, gv_stashpv, gv_stashpvn, gv_stashsv |
04b01f78 JH |
4686 | |
4687 | =item Handy Values | |
4688 | ||
07e9b5fe | 4689 | Nullav, Nullch, Nullcv, Nullhv, Nullsv |
04b01f78 JH |
4690 | |
4691 | =item Hash Manipulation Functions | |
4692 | ||
07e9b5fe NC |
4693 | get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, |
4694 | HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, | |
4695 | hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, | |
f262848d RGS |
4696 | hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, |
4697 | hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent, | |
07e9b5fe | 4698 | hv_undef, newHV |
04b01f78 JH |
4699 | |
4700 | =item Magical Functions | |
4701 | ||
37b1fd75 | 4702 | mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, |
fe9287c4 | 4703 | SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal, |
07e9b5fe | 4704 | SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK |
04b01f78 JH |
4705 | |
4706 | =item Memory Management | |
4707 | ||
07e9b5fe | 4708 | Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree, |
df344c0f | 4709 | savepv, savepvn, savesharedpv, savesvpv, StructCopy, Zero, ZeroD |
04b01f78 JH |
4710 | |
4711 | =item Miscellaneous Functions | |
4712 | ||
0d53b15f JH |
4713 | fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ, |
4714 | strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking, | |
5f15c94e NC |
4715 | sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify, |
4716 | vstringify | |
04b01f78 JH |
4717 | |
4718 | =item Numeric functions | |
4719 | ||
4720 | grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin, | |
4721 | scan_hex, scan_oct | |
4722 | ||
4723 | =item Optree Manipulation Functions | |
4724 | ||
4725 | cv_const_sv, newCONSTSUB, newXS | |
4726 | ||
2a551100 JH |
4727 | =item Pad Data Structures |
4728 | ||
4729 | pad_sv | |
4730 | ||
04b01f78 JH |
4731 | =item Stack Manipulation Macros |
4732 | ||
07e9b5fe NC |
4733 | dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu, |
4734 | mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp, | |
4735 | POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs, | |
4736 | PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs, | |
4737 | XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, | |
4738 | XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, | |
4739 | XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES | |
04b01f78 JH |
4740 | |
4741 | =item SV Flags | |
4742 | ||
4743 | svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG | |
4744 | ||
4745 | =item SV Manipulation Functions | |
4746 | ||
df344c0f | 4747 | get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, NEWSV, newSViv, |
07e9b5fe NC |
4748 | newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, |
4749 | newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, | |
4750 | SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW, | |
df344c0f NC |
4751 | SvIsCOW_shared_hash, SvIV, SvIVX, SvIVx, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp, |
4752 | SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, | |
4753 | SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, | |
2a551100 JH |
4754 | SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force, |
4755 | SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force, | |
df344c0f | 4756 | SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, |
1400179b NC |
4757 | SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, |
4758 | SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, | |
07e9b5fe | 4759 | SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, |
df344c0f | 4760 | SvUTF8_on, SvUV, SvUVx, SvUVX, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io, |
07e9b5fe NC |
4761 | sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, |
4762 | sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff, | |
4763 | sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, | |
e4bb216d NC |
4764 | sv_catpvn_mg, sv_catpvn_nomg, sv_catpv_mg, sv_catsv, sv_catsv_flags, |
4765 | sv_catsv_mg, sv_catsv_nomg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, | |
4766 | sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, | |
4767 | sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, | |
4768 | sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext, | |
4769 | sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b, | |
4770 | sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, | |
4771 | sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, | |
4772 | sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, | |
4773 | sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, | |
4774 | sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, | |
4775 | sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, | |
4776 | sv_setsv_flags, sv_setsv_mg, sv_setsv_nomg, sv_setuv, sv_setuv_mg, | |
4777 | sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, | |
4778 | sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, | |
4779 | sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, | |
4780 | sv_uv, sv_vcatpvf, sv_vcatpvfn, sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn, | |
4781 | sv_vsetpvf_mg | |
04b01f78 JH |
4782 | |
4783 | =item Unicode Support | |
4784 | ||
4785 | bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, | |
1e54db1a JH |
4786 | is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8, |
4787 | sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, | |
4788 | to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, | |
4789 | utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, | |
2a551100 | 4790 | uvuni_to_utf8_flags |
04b01f78 JH |
4791 | |
4792 | =item Variables created by C<xsubpp> and C<xsubpp> internal functions | |
4793 | ||
07e9b5fe NC |
4794 | ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto, |
4795 | RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK | |
04b01f78 JH |
4796 | |
4797 | =item Warning and Dieing | |
4798 | ||
4799 | croak, warn | |
c76ac1ee | 4800 | |
4755096e | 4801 | =item AUTHORS |
cb1a09d0 AD |
4802 | |
4803 | =item SEE ALSO | |
4804 | ||
a45bd81d GS |
4805 | =back |
4806 | ||
91331b4f | 4807 | =head2 perlintern - autogenerated documentation of purely B<internal> |
4755096e | 4808 | Perl functions |
cb1a09d0 | 4809 | |
d420ca49 | 4810 | =over 4 |
a45bd81d | 4811 | |
cb1a09d0 AD |
4812 | =item DESCRIPTION |
4813 | ||
2a551100 JH |
4814 | =item CV reference counts and CvOUTSIDE |
4815 | ||
4816 | CvWEAKOUTSIDE | |
4817 | ||
4818 | =item Functions in file pad.h | |
4819 | ||
4820 | CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS, | |
4821 | PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH, | |
4822 | PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL, | |
639f8edf HS |
4823 | PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, |
4824 | PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV | |
2a551100 JH |
4825 | |
4826 | =item Functions in file pp_ctl.c | |
4827 | ||
4828 | find_runcv | |
4829 | ||
fe9287c4 JH |
4830 | =item Global Variables |
4831 | ||
4832 | PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv, | |
4833 | PL_rs | |
4834 | ||
4835 | =item GV Functions | |
4836 | ||
4837 | is_gv_magical | |
4838 | ||
41630250 JH |
4839 | =item IO Functions |
4840 | ||
4841 | start_glob | |
4842 | ||
4843 | =item Pad Data Structures | |
4844 | ||
4845 | CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon, | |
4846 | pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex, | |
4847 | pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new, | |
4848 | pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef | |
4849 | ||
4850 | =item Stack Manipulation Macros | |
4851 | ||
4852 | djSP, LVRET | |
4853 | ||
4854 | =item SV Manipulation Functions | |
4855 | ||
07e9b5fe NC |
4856 | find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, |
4857 | sv_free_arenas | |
41630250 JH |
4858 | |
4859 | =item AUTHORS | |
4860 | ||
4861 | =item SEE ALSO | |
4862 | ||
4863 | =back | |
4864 | ||
4865 | =head2 perliol - C API for Perl's implementation of IO in Layers. | |
4866 | ||
4867 | =over 4 | |
4868 | ||
4869 | =item SYNOPSIS | |
4870 | ||
4871 | =item DESCRIPTION | |
4872 | ||
4873 | =over 4 | |
4874 | ||
4875 | =item History and Background | |
4876 | ||
5538b230 JH |
4877 | =item Basic Structure |
4878 | ||
41630250 JH |
4879 | =item Layers vs Disciplines |
4880 | ||
4881 | =item Data Structures | |
4882 | ||
4883 | =item Functions and Attributes | |
4884 | ||
4885 | =item Per-instance Data | |
4886 | ||
4887 | =item Layers in action. | |
4888 | ||
4889 | =item Per-instance flag bits | |
4890 | ||
4891 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, | |
4892 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, | |
4893 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, | |
4894 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS | |
4895 | ||
4896 | =item Methods in Detail | |
4897 | ||
4898 | fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, | |
4899 | PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, | |
4900 | Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, | |
4901 | Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, | |
4902 | Set_ptrcnt | |
4903 | ||
b6235c4f RGS |
4904 | =item Utilities |
4905 | ||
41630250 JH |
4906 | =item Implementing PerlIO Layers |
4907 | ||
4908 | C implementations, Perl implementations | |
4909 | ||
4910 | =item Core Layers | |
4911 | ||
4912 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" | |
4913 | ||
4914 | =item Extension Layers | |
4915 | ||
4916 | ":encoding", ":scalar", ":via" | |
4917 | ||
4918 | =back | |
4919 | ||
4920 | =item TODO | |
4921 | ||
4922 | =back | |
4923 | ||
4924 | =head2 perlapio - perl's IO abstraction interface. | |
4925 | ||
4926 | =over 4 | |
4927 | ||
4928 | =item SYNOPSIS | |
4929 | ||
4930 | =item DESCRIPTION | |
4931 | ||
4932 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, | |
4933 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, | |
4934 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, | |
4935 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, | |
4936 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
4937 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
4938 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
4939 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
4940 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, | |
4941 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
4942 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> | |
4943 | ||
4944 | =over 4 | |
4945 | ||
4946 | =item Co-existence with stdio | |
4947 | ||
4948 | B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>, | |
4949 | B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)> | |
4950 | ||
4951 | =item "Fast gets" Functions | |
4952 | ||
4953 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, | |
4954 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, | |
4955 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, | |
4956 | B<PerlIO_get_bufsiz(f)> | |
4957 | ||
4958 | =item Other Functions | |
4959 | ||
4960 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), | |
4961 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) | |
4962 | ||
4963 | =back | |
4964 | ||
4965 | =back | |
4966 | ||
4967 | =head2 perlhack - How to hack at the Perl internals | |
4968 | ||
4969 | =over 4 | |
4970 | ||
4971 | =item DESCRIPTION | |
4972 | ||
4973 | Does concept match the general goals of Perl?, Where is the | |
4974 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
4975 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
4976 | it preclude other desirable features?, Is the implementation robust?, Is | |
4977 | the implementation generic enough to be portable?, Is the implementation | |
4978 | tested?, Is there enough documentation?, Is there another way to do it?, | |
4979 | Does it create too much work?, Patches speak louder than words | |
4980 | ||
4981 | =over 4 | |
4982 | ||
4983 | =item Keeping in sync | |
4984 | ||
4985 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
4986 | NFS, rsync'ing the patches | |
4987 | ||
4988 | =item Why rsync the source tree | |
4989 | ||
4990 | It's easier to rsync the source tree, It's more reliable | |
4991 | ||
4992 | =item Why rsync the patches | |
4993 | ||
4994 | It's easier to rsync the patches, It's a good reference, Finding a start | |
4995 | point, Finding how to fix a bug, Finding the source of misbehaviour | |
4996 | ||
07e9b5fe NC |
4997 | =item Working with the source |
4998 | ||
41630250 JH |
4999 | =item Perlbug administration |
5000 | ||
5001 | =item Submitting patches | |
5002 | ||
5003 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
5004 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
5005 | ||
5006 | =item Finding Your Way Around | |
5007 | ||
5008 | Core modules, Tests, Documentation, Configure, Interpreter | |
5009 | ||
5010 | =item Elements of the interpreter | |
fe9287c4 | 5011 | |
41630250 | 5012 | Startup, Parsing, Optimization, Running |
fe9287c4 | 5013 | |
41630250 | 5014 | =item Internal Variable Types |
fe9287c4 | 5015 | |
41630250 | 5016 | =item Op Trees |
fe9287c4 | 5017 | |
41630250 | 5018 | =item Stacks |
fe9287c4 | 5019 | |
41630250 | 5020 | Argument stack, Mark stack, Save stack |
fe9287c4 | 5021 | |
41630250 | 5022 | =item Millions of Macros |
fe9287c4 | 5023 | |
41630250 | 5024 | =item The .i Targets |
4755096e | 5025 | |
41630250 | 5026 | =item Poking at Perl |
4755096e | 5027 | |
41630250 | 5028 | =item Using a source-level debugger |
4755096e | 5029 | |
41630250 JH |
5030 | run [args], break function_name, break source.c:xxx, step, next, continue, |
5031 | finish, 'enter', print | |
4755096e | 5032 | |
41630250 | 5033 | =item gdb macro support |
dc5c060f | 5034 | |
41630250 | 5035 | =item Dumping Perl Data Structures |
dc5c060f | 5036 | |
41630250 | 5037 | =item Patching |
dc5c060f | 5038 | |
41630250 | 5039 | =item Patching a core module |
dc5c060f | 5040 | |
41630250 | 5041 | =item Adding a new function to the core |
dc5c060f | 5042 | |
41630250 | 5043 | =item Writing a test |
dc5c060f | 5044 | |
41630250 JH |
5045 | F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, |
5046 | F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp, | |
5047 | t/cmd t/run t/io t/op, t/lib ext lib | |
dc5c060f | 5048 | |
41630250 | 5049 | =item Special Make Test Targets |
dc5c060f | 5050 | |
639f8edf HS |
5051 | coretest, test.deparse, test.taintwarn, minitest, test.valgrind |
5052 | check.valgrind utest.valgrind ucheck.valgrind, test.third check.third | |
5053 | utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 | |
e4bb216d | 5054 | check.utf8, minitest.utf16 test.utf16, test_harness |
dc5c060f | 5055 | |
41630250 | 5056 | =item Running tests by hand |
dc5c060f | 5057 | |
41630250 | 5058 | PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST |
dc5c060f | 5059 | |
41630250 | 5060 | =back |
dc5c060f | 5061 | |
41630250 | 5062 | =item EXTERNAL TOOLS FOR DEBUGGING PERL |
dc5c060f | 5063 | |
41630250 | 5064 | =over 4 |
dc5c060f | 5065 | |
41630250 | 5066 | =item Rational Software's Purify |
dc5c060f | 5067 | |
41630250 | 5068 | =item Purify on Unix |
8b9c797b | 5069 | |
41630250 | 5070 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity |
30487ceb | 5071 | |
41630250 | 5072 | =item Purify on NT |
dc5c060f | 5073 | |
41630250 | 5074 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug |
dc5c060f | 5075 | |
41630250 | 5076 | =item valgrind |
dc5c060f | 5077 | |
41630250 | 5078 | =item Compaq's/Digital's/HP's Third Degree |
dc5c060f | 5079 | |
41630250 | 5080 | =item PERL_DESTRUCT_LEVEL |
dc5c060f | 5081 | |
41630250 | 5082 | =item Profiling |
04b01f78 | 5083 | |
41630250 | 5084 | =item Gprof Profiling |
dc5c060f | 5085 | |
41630250 | 5086 | -a, -b, -e routine, -f routine, -s, -z |
4755096e | 5087 | |
41630250 | 5088 | =item GCC gcov Profiling |
cb1a09d0 | 5089 | |
41630250 | 5090 | =item Pixie Profiling |
cb1a09d0 | 5091 | |
41630250 JH |
5092 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, |
5093 | -z[ero] | |
cb1a09d0 | 5094 | |
41630250 | 5095 | =item Miscellaneous tricks |
cb1a09d0 | 5096 | |
41630250 | 5097 | =item CONCLUSION |
cb1a09d0 | 5098 | |
41630250 | 5099 | I<The Road goes ever on and on, down from the door where it began.> |
cb1a09d0 | 5100 | |
41630250 | 5101 | =back |
dc5c060f | 5102 | |
41630250 | 5103 | =item AUTHOR |
dc5c060f | 5104 | |
41630250 | 5105 | =back |
dc5c060f | 5106 | |
41630250 | 5107 | =head2 perlbook - Perl book information |
dc5c060f | 5108 | |
41630250 | 5109 | =over 4 |
cb1a09d0 | 5110 | |
41630250 | 5111 | =item DESCRIPTION |
c635e13b | 5112 | |
a45bd81d GS |
5113 | =back |
5114 | ||
4755096e | 5115 | =head2 perltodo - Perl TO-DO List |
c635e13b | 5116 | |
d420ca49 | 5117 | =over 4 |
a45bd81d | 5118 | |
c635e13b | 5119 | =item DESCRIPTION |
cb1a09d0 | 5120 | |
07e9b5fe | 5121 | =item assertions |
245d750e | 5122 | |
07e9b5fe | 5123 | =item iCOW |
245d750e | 5124 | |
07e9b5fe | 5125 | =item (?{...}) closures in regexps |
245d750e | 5126 | |
07e9b5fe | 5127 | =item A re-entrant regexp engine |
245d750e | 5128 | |
07e9b5fe | 5129 | =item pragmata |
245d750e | 5130 | |
07e9b5fe | 5131 | =over 4 |
4755096e | 5132 | |
07e9b5fe | 5133 | =item lexical pragmas |
4755096e | 5134 | |
07e9b5fe | 5135 | =item use less 'memory' |
c635e13b | 5136 | |
a45bd81d GS |
5137 | =back |
5138 | ||
07e9b5fe | 5139 | =item prototypes and functions |
fb9cefb4 | 5140 | |
d420ca49 | 5141 | =over 4 |
a45bd81d | 5142 | |
07e9b5fe | 5143 | =item _ prototype character |
a45bd81d | 5144 | |
07e9b5fe | 5145 | =item inlining autoloaded constants |
245d750e JH |
5146 | |
5147 | =item Finish off lvalue functions | |
5148 | ||
a45bd81d GS |
5149 | =back |
5150 | ||
07e9b5fe | 5151 | =item Unicode and UTF8 |
cb1a09d0 | 5152 | |
d420ca49 | 5153 | =over 4 |
a45bd81d | 5154 | |
07e9b5fe | 5155 | =item Implicit Latin 1 => Unicode translation |
cb1a09d0 | 5156 | |
07e9b5fe | 5157 | =item UTF8 caching code |
cb1a09d0 | 5158 | |
07e9b5fe | 5159 | =item Unicode in Filenames |
cb1a09d0 | 5160 | |
07e9b5fe | 5161 | =item Unicode in %ENV |
cb1a09d0 | 5162 | |
a45bd81d GS |
5163 | =back |
5164 | ||
07e9b5fe | 5165 | =item Regexps |
4755096e | 5166 | |
245d750e | 5167 | =over 4 |
4755096e | 5168 | |
07e9b5fe | 5169 | =item regexp optimiser optional |
cb1a09d0 | 5170 | |
07e9b5fe | 5171 | =item common suffices/prefices in regexps (trie optimization) |
d8416318 | 5172 | |
4755096e | 5173 | =back |
cb1a09d0 | 5174 | |
07e9b5fe | 5175 | =item POD |
cb1a09d0 | 5176 | |
d420ca49 | 5177 | =over 4 |
cb1a09d0 | 5178 | |
07e9b5fe | 5179 | =item POD -> HTML conversion still sucks |
193fb0af | 5180 | |
07e9b5fe | 5181 | =back |
cb1a09d0 | 5182 | |
07e9b5fe | 5183 | =item Misc medium sized projects |
cb1a09d0 | 5184 | |
07e9b5fe | 5185 | =over 4 |
cb1a09d0 | 5186 | |
07e9b5fe | 5187 | =item UNITCHECK |
cb1a09d0 | 5188 | |
07e9b5fe | 5189 | =item optional optimizer |
cb1a09d0 | 5190 | |
07e9b5fe | 5191 | =item You WANT *how* many |
cb1a09d0 | 5192 | |
07e9b5fe | 5193 | =item lexical aliases |
cb1a09d0 | 5194 | |
07e9b5fe | 5195 | =item no 6 |
cb1a09d0 | 5196 | |
07e9b5fe | 5197 | =item IPv6 |
cb1a09d0 | 5198 | |
07e9b5fe | 5199 | =item entersub XS vs Perl |
cb1a09d0 | 5200 | |
07e9b5fe | 5201 | =item @INC source filter to Filter::Simple |
cb1a09d0 | 5202 | |
07e9b5fe | 5203 | =item bincompat functions |
cb1a09d0 | 5204 | |
07e9b5fe | 5205 | =item Use fchown/fchmod internally |
4755096e | 5206 | |
df344c0f NC |
5207 | =item Constant folding |
5208 | ||
07e9b5fe | 5209 | =back |
4755096e | 5210 | |
07e9b5fe | 5211 | =item Tests |
4755096e | 5212 | |
07e9b5fe | 5213 | =over 4 |
4755096e | 5214 | |
07e9b5fe | 5215 | =item Make Schwern poorer |
4755096e | 5216 | |
07e9b5fe | 5217 | =item test B |
4755096e | 5218 | |
07e9b5fe | 5219 | =item common test code for timed bailout |
cb1a09d0 | 5220 | |
245d750e | 5221 | =back |
cb1a09d0 | 5222 | |
07e9b5fe | 5223 | =item Installation |
cb1a09d0 | 5224 | |
245d750e | 5225 | =over 4 |
cb1a09d0 | 5226 | |
07e9b5fe | 5227 | =item compressed man pages |
cb1a09d0 | 5228 | |
07e9b5fe | 5229 | =item Make Config.pm cope with differences between build and installed perl |
3958b146 | 5230 | |
07e9b5fe | 5231 | =item Relocatable perl |
cb1a09d0 | 5232 | |
07e9b5fe | 5233 | =item make HTML install work |
3958b146 | 5234 | |
07e9b5fe | 5235 | =item put patchlevel in -v |
cb1a09d0 | 5236 | |
07e9b5fe | 5237 | =back |
4755096e | 5238 | |
07e9b5fe | 5239 | =item Incremental things |
4755096e | 5240 | |
07e9b5fe | 5241 | =over 4 |
cb1a09d0 | 5242 | |
07e9b5fe | 5243 | =item autovivification |
cb1a09d0 | 5244 | |
07e9b5fe | 5245 | =item fix tainting bugs |
cb1a09d0 | 5246 | |
07e9b5fe | 5247 | =item Make tainting consistent |
ab1e085c | 5248 | |
07e9b5fe | 5249 | =item Dual life everything |
ab1e085c | 5250 | |
07e9b5fe | 5251 | =back |
51a35ef1 | 5252 | |
07e9b5fe | 5253 | =item Vague things |
772ff3b9 | 5254 | |
07e9b5fe | 5255 | =over 4 |
772ff3b9 | 5256 | |
07e9b5fe | 5257 | =item threads |
51a35ef1 | 5258 | |
07e9b5fe | 5259 | =item POSIX memory footprint |
ab1e085c | 5260 | |
07e9b5fe | 5261 | =item Optimize away @_ |
ab1e085c | 5262 | |
07e9b5fe | 5263 | =item switch ops |
b2deec1d | 5264 | |
07e9b5fe | 5265 | =item Attach/detach debugger from running program |
cb1a09d0 | 5266 | |
07e9b5fe | 5267 | =item A decent benchmark |
cb1a09d0 | 5268 | |
e4bb216d NC |
5269 | =item readpipe(LIST) |
5270 | ||
df344c0f NC |
5271 | =item Self ties |
5272 | ||
8ebc5c01 | 5273 | =back |
cb1a09d0 | 5274 | |
cb1a09d0 AD |
5275 | =back |
5276 | ||
2a551100 JH |
5277 | =head2 perldoc - Look up Perl documentation in Pod format. |
5278 | ||
5279 | =over 4 | |
5280 | ||
5281 | =item SYNOPSIS | |
5282 | ||
5283 | =item DESCRIPTION | |
5284 | ||
5285 | =item OPTIONS | |
5286 | ||
5287 | B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f> | |
5288 | I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d> | |
5289 | I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>, | |
5290 | B<-w> I<option:value> or B<-w> I<option>, B<-X>, | |
5291 | B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>, | |
5292 | B<-V> | |
5293 | ||
5294 | =item SECURITY | |
5295 | ||
5296 | =item ENVIRONMENT | |
5297 | ||
5298 | =item AUTHOR | |
5299 | ||
5300 | =back | |
5301 | ||
7029d033 | 5302 | =head2 perlhist - the Perl history records |
7d2bfb28 | 5303 | |
d420ca49 | 5304 | =over 4 |
7d2bfb28 | 5305 | |
7029d033 | 5306 | =item DESCRIPTION |
cb1a09d0 | 5307 | |
7029d033 | 5308 | =item INTRODUCTION |
cb1a09d0 | 5309 | |
7029d033 | 5310 | =item THE KEEPERS OF THE PUMPKIN |
cb1a09d0 | 5311 | |
d420ca49 | 5312 | =over 4 |
cb1a09d0 | 5313 | |
7029d033 | 5314 | =item PUMPKIN? |
cb1a09d0 | 5315 | |
a45bd81d GS |
5316 | =back |
5317 | ||
7029d033 | 5318 | =item THE RECORDS |
cb1a09d0 | 5319 | |
d420ca49 | 5320 | =over 4 |
cb1a09d0 | 5321 | |
7029d033 | 5322 | =item SELECTED RELEASE SIZES |
cb1a09d0 | 5323 | |
7029d033 | 5324 | =item SELECTED PATCH SIZES |
cb1a09d0 | 5325 | |
7029d033 | 5326 | =back |
cb1a09d0 | 5327 | |
7029d033 | 5328 | =item THE KEEPERS OF THE RECORDS |
cb1a09d0 | 5329 | |
a45bd81d GS |
5330 | =back |
5331 | ||
5f15c94e | 5332 | =head2 perldelta - what is new for perl v5.9.2 |
1400179b NC |
5333 | |
5334 | =over 4 | |
5335 | ||
5336 | =item DESCRIPTION | |
5337 | ||
5338 | =item Incompatible Changes | |
5339 | ||
5340 | =item Core Enhancements | |
5341 | ||
f99d9048 RGS |
5342 | =item Modules and Pragmata |
5343 | ||
f99d9048 RGS |
5344 | =item Utility Changes |
5345 | ||
5346 | =item Documentation | |
5347 | ||
5348 | =item Performance Enhancements | |
5349 | ||
5f15c94e | 5350 | =item Installation and Configuration Improvements |
f99d9048 | 5351 | |
5f15c94e | 5352 | =item Selected Bug Fixes |
f99d9048 RGS |
5353 | |
5354 | =item New or Changed Diagnostics | |
5355 | ||
5356 | =item Changed Internals | |
5357 | ||
f99d9048 RGS |
5358 | =item Known Problems |
5359 | ||
5360 | =over 4 | |
5361 | ||
5362 | =item Platform Specific Problems | |
5363 | ||
5364 | =back | |
5365 | ||
f99d9048 RGS |
5366 | =item Reporting Bugs |
5367 | ||
5368 | =item SEE ALSO | |
5369 | ||
5370 | =back | |
5371 | ||
e0eb806d RGS |
5372 | =head2 perl592delta, perldelta - what is new for perl v5.9.2 |
5373 | ||
5374 | =over 4 | |
5375 | ||
5376 | =item DESCRIPTION | |
5377 | ||
5378 | =item Incompatible Changes | |
5379 | ||
5380 | =item Core Enhancements | |
5381 | ||
5382 | =item Modules and Pragmata | |
5383 | ||
5384 | =item Utility Changes | |
5385 | ||
5386 | =item Documentation | |
5387 | ||
5388 | =item Performance Enhancements | |
5389 | ||
5390 | =item Installation and Configuration Improvements | |
5391 | ||
5392 | =item Selected Bug Fixes | |
5393 | ||
5394 | =item New or Changed Diagnostics | |
5395 | ||
5396 | =item Changed Internals | |
5397 | ||
5398 | =item Known Problems | |
5399 | ||
5400 | =over 4 | |
5401 | ||
5402 | =item Platform Specific Problems | |
5403 | ||
5404 | =back | |
5405 | ||
5406 | =item Reporting Bugs | |
5407 | ||
5408 | =item SEE ALSO | |
5409 | ||
5410 | =back | |
5411 | ||
f99d9048 RGS |
5412 | =head2 perl591delta, perldelta - what is new for perl v5.9.1 |
5413 | ||
5414 | =over 4 | |
5415 | ||
5416 | =item DESCRIPTION | |
5417 | ||
5418 | =item Incompatible Changes | |
5419 | ||
5420 | =over 4 | |
5421 | ||
5422 | =item substr() lvalues are no longer fixed-length | |
5423 | ||
d61fd583 RGS |
5424 | =item The C<:unique> attribute is only meaningful for globals |
5425 | ||
f99d9048 RGS |
5426 | =back |
5427 | ||
5428 | =item Core Enhancements | |
5429 | ||
5430 | =over 4 | |
5431 | ||
5432 | =item Lexical C<$_> | |
5433 | ||
5434 | =item Tied hashes in scalar context | |
5435 | ||
5436 | =item Formats | |
5437 | ||
d61fd583 RGS |
5438 | =item Stacked filetest operators |
5439 | ||
1400179b NC |
5440 | =back |
5441 | ||
5442 | =item Modules and Pragmata | |
5443 | ||
f99d9048 | 5444 | Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared |
d61fd583 | 5445 | |
1400179b NC |
5446 | =item Utility Changes |
5447 | ||
d61fd583 | 5448 | =item Documentation |
1400179b NC |
5449 | |
5450 | =item Performance Enhancements | |
5451 | ||
1400179b NC |
5452 | =item Selected Bug Fixes |
5453 | ||
d61fd583 RGS |
5454 | =over 4 |
5455 | ||
f99d9048 | 5456 | =item UTF-8 bugs |
d61fd583 RGS |
5457 | |
5458 | =item Threading bugs | |
5459 | ||
5460 | =item More bugs | |
5461 | ||
5462 | =back | |
5463 | ||
1400179b NC |
5464 | =item New or Changed Diagnostics |
5465 | ||
5466 | =item Changed Internals | |
5467 | ||
f99d9048 | 5468 | =over 4 |
d61fd583 | 5469 | |
f99d9048 RGS |
5470 | =item Reordering of SVt_* constants |
5471 | ||
5472 | =item Removal of CPP symbols | |
5473 | ||
5474 | =item Less space is used by ops | |
5475 | ||
5476 | =item New parser | |
5477 | ||
5478 | =back | |
5479 | ||
5480 | =item Configuration and Building | |
1400179b NC |
5481 | |
5482 | =item Known Problems | |
5483 | ||
f99d9048 RGS |
5484 | =over 4 |
5485 | ||
1400179b NC |
5486 | =item Platform Specific Problems |
5487 | ||
f99d9048 RGS |
5488 | =back |
5489 | ||
5490 | =item To-do for perl 5.10.0 | |
5491 | ||
1400179b NC |
5492 | =item Reporting Bugs |
5493 | ||
5494 | =item SEE ALSO | |
5495 | ||
5496 | =back | |
5497 | ||
5498 | =head2 perl590delta, perldelta - what is new for perl v5.9.0 | |
2a551100 JH |
5499 | |
5500 | =over 4 | |
5501 | ||
5502 | =item DESCRIPTION | |
5503 | ||
5504 | =item Incompatible Changes | |
5505 | ||
0d53b15f JH |
5506 | =over 4 |
5507 | ||
639f8edf HS |
5508 | =item Hash Randomisation |
5509 | ||
5510 | =item UTF-8 On Filehandles No Longer Activated By Locale | |
5511 | ||
5512 | =item Single-number v-strings are no longer v-strings before "=>" | |
5513 | ||
5514 | =item (Win32) The -C Switch Has Been Repurposed | |
5515 | ||
5516 | =item (Win32) The /d Switch Of cmd.exe | |
5517 | ||
0d53b15f JH |
5518 | =item The C<$*> variable has been removed |
5519 | ||
5520 | =back | |
5521 | ||
2a551100 JH |
5522 | =item Core Enhancements |
5523 | ||
5524 | =over 4 | |
5525 | ||
639f8edf HS |
5526 | =item Assertions |
5527 | ||
5528 | =item Defined-or operators | |
5529 | ||
5530 | =item UTF-8 no longer default under UTF-8 locales | |
5531 | ||
5532 | =item Unsafe signals again available | |
5533 | ||
2a551100 JH |
5534 | =item Tied Arrays with Negative Array Indices |
5535 | ||
639f8edf HS |
5536 | =item local ${$x} |
5537 | ||
5538 | =item Unicode Character Database 4.0.0 | |
5539 | ||
5540 | =item Miscellaneous Enhancements | |
5541 | ||
2a551100 JH |
5542 | =back |
5543 | ||
5544 | =item Modules and Pragmata | |
5545 | ||
639f8edf HS |
5546 | =over 4 |
5547 | ||
5548 | =item Updated Modules And Pragmata | |
5549 | ||
5550 | base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, | |
5551 | CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, | |
5552 | Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, | |
5553 | PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, | |
5554 | Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, | |
5555 | Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, | |
5556 | Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, | |
5557 | Win32::GetOSVersion | |
5558 | ||
5559 | =back | |
5560 | ||
2a551100 JH |
5561 | =item Utility Changes |
5562 | ||
5563 | =item New Documentation | |
5564 | ||
5565 | =item Performance Enhancements | |
5566 | ||
5567 | =item Installation and Configuration Improvements | |
5568 | ||
639f8edf HS |
5569 | =over 4 |
5570 | ||
5571 | =item Platform-specific enhancements | |
5572 | ||
5573 | =back | |
5574 | ||
2a551100 JH |
5575 | =item Selected Bug Fixes |
5576 | ||
639f8edf HS |
5577 | =over 4 |
5578 | ||
5579 | =item Closures, eval and lexicals | |
5580 | ||
5581 | =item Generic fixes | |
5582 | ||
5583 | =item Platform-specific fixes | |
5584 | ||
5585 | =back | |
5586 | ||
2a551100 JH |
5587 | =item New or Changed Diagnostics |
5588 | ||
639f8edf HS |
5589 | =over 4 |
5590 | ||
5591 | =item Changed "A thread exited while %d threads were running" | |
5592 | ||
5593 | =item Removed "Attempt to clear a restricted hash" | |
5594 | ||
5595 | =item New "Illegal declaration of anonymous subroutine" | |
5596 | ||
5597 | =item Changed "Invalid range "%s" in transliteration operator" | |
5598 | ||
5599 | =item New "Missing control char name in \c" | |
5600 | ||
5601 | =item New "Newline in left-justified string for %s" | |
5602 | ||
5603 | =item New "Possible precedence problem on bitwise %c operator" | |
5604 | ||
5605 | =item New "read() on %s filehandle %s" | |
5606 | ||
5607 | =item New "Tied variable freed while still in use" | |
5608 | ||
5609 | =item New "To%s: illegal mapping '%s'" | |
5610 | ||
5611 | =item New "Use of freed value in iteration" | |
5612 | ||
5613 | =back | |
5614 | ||
2a551100 JH |
5615 | =item Changed Internals |
5616 | ||
5617 | =item New Tests | |
5618 | ||
5619 | =item Known Problems | |
5620 | ||
639f8edf HS |
5621 | =over 4 |
5622 | ||
1400179b NC |
5623 | =item Tied hashes in scalar context |
5624 | ||
639f8edf HS |
5625 | =item Net::Ping 450_service and 510_ping_udp failures |
5626 | ||
5627 | =item B::C | |
5628 | ||
5629 | =back | |
5630 | ||
2a551100 JH |
5631 | =item Platform Specific Problems |
5632 | ||
639f8edf HS |
5633 | =over 4 |
5634 | ||
5635 | =item EBCDIC Platforms | |
5636 | ||
5637 | =item Cygwin 1.5 problems | |
5638 | ||
5639 | =item HP-UX: HP cc warnings about sendfile and sendpath | |
5640 | ||
5641 | =item IRIX: t/uni/tr_7jis.t falsely failing | |
5642 | ||
5643 | =item Mac OS X: no usemymalloc | |
5644 | ||
5645 | =item Tru64: No threaded builds with GNU cc (gcc) | |
5646 | ||
5647 | =item Win32: sysopen, sysread, syswrite | |
5648 | ||
5649 | =back | |
5650 | ||
5651 | =item TODO | |
5652 | ||
2a551100 JH |
5653 | =item Reporting Bugs |
5654 | ||
5655 | =item SEE ALSO | |
5656 | ||
5657 | =back | |
5658 | ||
e4bb216d NC |
5659 | =head2 perl586delta - what is new for perl v5.8.6 |
5660 | ||
5661 | =over 4 | |
5662 | ||
5663 | =item DESCRIPTION | |
5664 | ||
5665 | =item Incompatible Changes | |
5666 | ||
5667 | =item Core Enhancements | |
5668 | ||
5669 | =item Modules and Pragmata | |
5670 | ||
5671 | =item Utility Changes | |
5672 | ||
5673 | =item Performance Enhancements | |
5674 | ||
5675 | =item Selected Bug Fixes | |
5676 | ||
5677 | =item New or Changed Diagnostics | |
5678 | ||
5679 | =item Changed Internals | |
5680 | ||
5681 | =item New Tests | |
5682 | ||
5683 | =item Reporting Bugs | |
5684 | ||
5685 | =item SEE ALSO | |
5686 | ||
5687 | =back | |
5688 | ||
07e9b5fe NC |
5689 | =head2 perl585delta - what is new for perl v5.8.5 |
5690 | ||
5691 | =over 4 | |
5692 | ||
5693 | =item DESCRIPTION | |
5694 | ||
5695 | =item Incompatible Changes | |
5696 | ||
5697 | =item Core Enhancements | |
5698 | ||
5699 | =item Modules and Pragmata | |
5700 | ||
5701 | =item Utility Changes | |
5702 | ||
5703 | =over 4 | |
5704 | ||
5705 | =item Perl's debugger | |
5706 | ||
5707 | =item h2ph | |
5708 | ||
5709 | =back | |
5710 | ||
5711 | =item Installation and Configuration Improvements | |
5712 | ||
5713 | =item Selected Bug Fixes | |
5714 | ||
5715 | =item New or Changed Diagnostics | |
5716 | ||
5717 | =item Changed Internals | |
5718 | ||
5719 | =item Known Problems | |
5720 | ||
5721 | =item Platform Specific Problems | |
5722 | ||
5723 | =item Reporting Bugs | |
5724 | ||
5725 | =item SEE ALSO | |
5726 | ||
5727 | =back | |
5728 | ||
5729 | =head2 perl584delta - what is new for perl v5.8.4 | |
5f15c94e NC |
5730 | |
5731 | =over 4 | |
5732 | ||
5733 | =item DESCRIPTION | |
5734 | ||
5735 | =item Incompatible Changes | |
5736 | ||
5737 | =item Core Enhancements | |
5738 | ||
5739 | =over 4 | |
5740 | ||
5741 | =item Malloc wrapping | |
5742 | ||
5743 | =item Unicode Character Database 4.0.1 | |
5744 | ||
5745 | =item suidperl less insecure | |
5746 | ||
5747 | =item format | |
5748 | ||
5749 | =back | |
5750 | ||
5751 | =item Modules and Pragmata | |
5752 | ||
5753 | =over 4 | |
5754 | ||
5755 | =item Updated modules | |
5756 | ||
5757 | Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, | |
5758 | IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, | |
5759 | Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, | |
5760 | Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, | |
5761 | base, open, threads, utf8 | |
5762 | ||
5763 | =back | |
5764 | ||
5765 | =item Performance Enhancements | |
5766 | ||
5767 | =item Utility Changes | |
5768 | ||
5769 | =item Installation and Configuration Improvements | |
5770 | ||
5771 | =item Selected Bug Fixes | |
5772 | ||
5773 | =item New or Changed Diagnostics | |
5774 | ||
5775 | =item Changed Internals | |
5776 | ||
5777 | =item Future Directions | |
5778 | ||
5779 | =item Platform Specific Problems | |
5780 | ||
5781 | =item Reporting Bugs | |
5782 | ||
5783 | =item SEE ALSO | |
5784 | ||
5785 | =back | |
5786 | ||
1400179b | 5787 | =head2 perl583delta - what is new for perl v5.8.3 |
d4432bb5 | 5788 | |
603b90a8 JH |
5789 | =over 4 |
5790 | ||
5791 | =item DESCRIPTION | |
5792 | ||
428dc699 JH |
5793 | =item Incompatible Changes |
5794 | ||
2e038148 | 5795 | =item Core Enhancements |
428dc699 | 5796 | |
2e038148 | 5797 | =item Modules and Pragmata |
95fb7f7f | 5798 | |
2e038148 NC |
5799 | CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util, |
5800 | Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate, | |
5801 | Unicode::Normalize, Test::Harness, threads::shared | |
428dc699 | 5802 | |
2e038148 | 5803 | =item Utility Changes |
428dc699 | 5804 | |
2e038148 | 5805 | =item New Documentation |
95f0a2f1 | 5806 | |
2e038148 | 5807 | =item Installation and Configuration Improvements |
428dc699 | 5808 | |
2e038148 | 5809 | =item Selected Bug Fixes |
493a87da | 5810 | |
2e038148 | 5811 | =item New or Changed Diagnostics |
ea9fba97 | 5812 | |
2e038148 | 5813 | =item Changed Internals |
428dc699 | 5814 | |
2e038148 | 5815 | =item Configuration and Building |
34babc16 | 5816 | |
2e038148 | 5817 | =item Platform Specific Problems |
ff426ff2 | 5818 | |
2e038148 | 5819 | =item Known Problems |
69dc652e | 5820 | |
2e038148 | 5821 | =item Future Directions |
428dc699 | 5822 | |
2e038148 | 5823 | =item Obituary |
428dc699 | 5824 | |
2e038148 | 5825 | =item Reporting Bugs |
428dc699 | 5826 | |
2e038148 | 5827 | =item SEE ALSO |
428dc699 | 5828 | |
2e038148 | 5829 | =back |
69dc652e | 5830 | |
2e038148 | 5831 | =head2 perl582delta - what is new for perl v5.8.2 |
428dc699 | 5832 | |
2e038148 | 5833 | =over 4 |
69dc652e | 5834 | |
2e038148 | 5835 | =item DESCRIPTION |
d8416318 | 5836 | |
2e038148 | 5837 | =item Incompatible Changes |
428dc699 | 5838 | |
2e038148 | 5839 | =item Core Enhancements |
428dc699 | 5840 | |
2e038148 | 5841 | =over 4 |
97f7c9df | 5842 | |
2e038148 NC |
5843 | =item Hash Randomisation |
5844 | ||
5845 | =item Threading | |
34babc16 | 5846 | |
428dc699 JH |
5847 | =back |
5848 | ||
5849 | =item Modules and Pragmata | |
5850 | ||
5851 | =over 4 | |
5852 | ||
2e038148 | 5853 | =item Updated Modules And Pragmata |
428dc699 | 5854 | |
2e038148 NC |
5855 | Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64, |
5856 | Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate, | |
5857 | Unicode::Normalize, UNIVERSAL | |
428dc699 JH |
5858 | |
5859 | =back | |
5860 | ||
2e038148 | 5861 | =item Selected Bug Fixes |
428dc699 | 5862 | |
2e038148 | 5863 | =item Changed Internals |
428dc699 | 5864 | |
2e038148 | 5865 | =item Platform Specific Problems |
428dc699 | 5866 | |
2e038148 NC |
5867 | =item Future Directions |
5868 | ||
5869 | =item Reporting Bugs | |
5870 | ||
5871 | =item SEE ALSO | |
5872 | ||
5873 | =back | |
5874 | ||
5875 | =head2 perl581delta - what is new for perl v5.8.1 | |
428dc699 JH |
5876 | |
5877 | =over 4 | |
5878 | ||
2e038148 | 5879 | =item DESCRIPTION |
428dc699 | 5880 | |
2e038148 NC |
5881 | =item Incompatible Changes |
5882 | ||
5883 | =over 4 | |
5884 | ||
5885 | =item Hash Randomisation | |
5886 | ||
5887 | =item UTF-8 On Filehandles No Longer Activated By Locale | |
5888 | ||
5889 | =item Single-number v-strings are no longer v-strings before "=>" | |
5890 | ||
5891 | =item (Win32) The -C Switch Has Been Repurposed | |
5892 | ||
5893 | =item (Win32) The /d Switch Of cmd.exe | |
428dc699 JH |
5894 | |
5895 | =back | |
5896 | ||
2e038148 | 5897 | =item Core Enhancements |
428dc699 JH |
5898 | |
5899 | =over 4 | |
5900 | ||
2e038148 | 5901 | =item UTF-8 no longer default under UTF-8 locales |
428dc699 | 5902 | |
2e038148 | 5903 | =item Unsafe signals again available |
428dc699 | 5904 | |
2e038148 | 5905 | =item Tied Arrays with Negative Array Indices |
428dc699 | 5906 | |
2e038148 | 5907 | =item local ${$x} |
428dc699 | 5908 | |
2e038148 | 5909 | =item Unicode Character Database 4.0.0 |
428dc699 | 5910 | |
2e038148 | 5911 | =item Deprecation Warnings |
428dc699 | 5912 | |
2e038148 | 5913 | =item Miscellaneous Enhancements |
428dc699 | 5914 | |
2e038148 | 5915 | =back |
428dc699 | 5916 | |
2e038148 | 5917 | =item Modules and Pragmata |
28a2f804 | 5918 | |
2e038148 | 5919 | =over 4 |
28a2f804 | 5920 | |
2e038148 | 5921 | =item Updated Modules And Pragmata |
28a2f804 | 5922 | |
2e038148 NC |
5923 | base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, |
5924 | CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, | |
5925 | Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, | |
5926 | PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, | |
5927 | Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, | |
5928 | Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, | |
5929 | Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, | |
5930 | Win32::GetOSVersion | |
28a2f804 | 5931 | |
2e038148 | 5932 | =back |
28a2f804 | 5933 | |
2e038148 | 5934 | =item Utility Changes |
28a2f804 | 5935 | |
2e038148 | 5936 | =item New Documentation |
28a2f804 | 5937 | |
2e038148 | 5938 | =item Installation and Configuration Improvements |
28a2f804 | 5939 | |
2e038148 | 5940 | =over 4 |
28a2f804 | 5941 | |
2e038148 | 5942 | =item Platform-specific enhancements |
28a2f804 | 5943 | |
2e038148 | 5944 | =back |
28a2f804 | 5945 | |
2e038148 | 5946 | =item Selected Bug Fixes |
28a2f804 | 5947 | |
2e038148 | 5948 | =over 4 |
28a2f804 | 5949 | |
2e038148 | 5950 | =item Closures, eval and lexicals |
28a2f804 | 5951 | |
2e038148 NC |
5952 | =item Generic fixes |
5953 | ||
5954 | =item Platform-specific fixes | |
28a2f804 JH |
5955 | |
5956 | =back | |
5957 | ||
2e038148 | 5958 | =item New or Changed Diagnostics |
28a2f804 JH |
5959 | |
5960 | =over 4 | |
5961 | ||
2e038148 | 5962 | =item Changed "A thread exited while %d threads were running" |
428dc699 | 5963 | |
2e038148 | 5964 | =item Removed "Attempt to clear a restricted hash" |
0d6290d3 | 5965 | |
2e038148 | 5966 | =item New "Illegal declaration of anonymous subroutine" |
d4432bb5 | 5967 | |
2e038148 | 5968 | =item Changed "Invalid range "%s" in transliteration operator" |
23be5fc4 | 5969 | |
2e038148 | 5970 | =item New "Missing control char name in \c" |
d4432bb5 | 5971 | |
2e038148 | 5972 | =item New "Newline in left-justified string for %s" |
c40f6c4a | 5973 | |
2e038148 | 5974 | =item New "Possible precedence problem on bitwise %c operator" |
69dc652e | 5975 | |
2e038148 | 5976 | =item New "Pseudo-hashes are deprecated" |
97f7c9df | 5977 | |
2e038148 | 5978 | =item New "read() on %s filehandle %s" |
e993db8c | 5979 | |
2e038148 | 5980 | =item New "5.005 threads are deprecated" |
428dc699 | 5981 | |
2e038148 | 5982 | =item New "Tied variable freed while still in use" |
428dc699 | 5983 | |
2e038148 | 5984 | =item New "To%s: illegal mapping '%s'" |
a6812a52 | 5985 | |
2e038148 | 5986 | =item New "Use of freed value in iteration" |
428dc699 | 5987 | |
2e038148 | 5988 | =back |
493a87da | 5989 | |
2e038148 | 5990 | =item Changed Internals |
28a2f804 | 5991 | |
2e038148 | 5992 | =item New Tests |
4b069b44 | 5993 | |
2e038148 | 5994 | =item Known Problems |
428dc699 | 5995 | |
2e038148 | 5996 | =over 4 |
2a551100 | 5997 | |
2e038148 | 5998 | =item Tied hashes in scalar context |
95fb7f7f | 5999 | |
2e038148 | 6000 | =item Net::Ping 450_service and 510_ping_udp failures |
a9d2c496 | 6001 | |
2e038148 | 6002 | =item B::C |
23be5fc4 | 6003 | |
2e038148 | 6004 | =back |
23be5fc4 | 6005 | |
2e038148 | 6006 | =item Platform Specific Problems |
fa1c7b03 | 6007 | |
2e038148 | 6008 | =over 4 |
428dc699 | 6009 | |
2e038148 | 6010 | =item EBCDIC Platforms |
97f7c9df | 6011 | |
2e038148 | 6012 | =item Cygwin 1.5 problems |
428dc699 | 6013 | |
2e038148 | 6014 | =item HP-UX: HP cc warnings about sendfile and sendpath |
04b01f78 | 6015 | |
2e038148 | 6016 | =item IRIX: t/uni/tr_7jis.t falsely failing |
e993db8c | 6017 | |
2e038148 | 6018 | =item Mac OS X: no usemymalloc |
fa1c7b03 | 6019 | |
2e038148 | 6020 | =item Tru64: No threaded builds with GNU cc (gcc) |
34babc16 | 6021 | |
2e038148 | 6022 | =item Win32: sysopen, sysread, syswrite |
428dc699 JH |
6023 | |
6024 | =back | |
6025 | ||
2e038148 NC |
6026 | =item Future Directions |
6027 | ||
603b90a8 JH |
6028 | =item Reporting Bugs |
6029 | ||
6030 | =item SEE ALSO | |
6031 | ||
603b90a8 JH |
6032 | =back |
6033 | ||
2e038148 | 6034 | =head2 perl58delta - what is new for perl v5.8.0 |
b6235c4f RGS |
6035 | |
6036 | =over 4 | |
6037 | ||
6038 | =item DESCRIPTION | |
6039 | ||
2e038148 NC |
6040 | =item Highlights In 5.8.0 |
6041 | ||
b6235c4f RGS |
6042 | =item Incompatible Changes |
6043 | ||
6044 | =over 4 | |
6045 | ||
2e038148 | 6046 | =item Binary Incompatibility |
b6235c4f | 6047 | |
2e038148 | 6048 | =item 64-bit platforms and malloc |
b6235c4f | 6049 | |
2e038148 | 6050 | =item AIX Dynaloading |
b6235c4f | 6051 | |
2e038148 | 6052 | =item Attributes for C<my> variables now handled at run-time |
b6235c4f | 6053 | |
2e038148 NC |
6054 | =item Socket Extension Dynamic in VMS |
6055 | ||
6056 | =item IEEE-format Floating Point Default on OpenVMS Alpha | |
6057 | ||
6058 | =item New Unicode Semantics (no more C<use utf8>, almost) | |
6059 | ||
6060 | =item New Unicode Properties | |
6061 | ||
6062 | =item REF(...) Instead Of SCALAR(...) | |
6063 | ||
6064 | =item pack/unpack D/F recycled | |
6065 | ||
6066 | =item glob() now returns filenames in alphabetical order | |
6067 | ||
6068 | =item Deprecations | |
b6235c4f RGS |
6069 | |
6070 | =back | |
6071 | ||
6072 | =item Core Enhancements | |
6073 | ||
6074 | =over 4 | |
6075 | ||
2e038148 | 6076 | =item Unicode Overhaul |
b6235c4f | 6077 | |
2e038148 | 6078 | =item PerlIO is Now The Default |
b6235c4f | 6079 | |
2e038148 | 6080 | =item ithreads |
b6235c4f | 6081 | |
2e038148 | 6082 | =item Restricted Hashes |
b6235c4f | 6083 | |
2e038148 | 6084 | =item Safe Signals |
b6235c4f | 6085 | |
2e038148 | 6086 | =item Understanding of Numbers |
b6235c4f | 6087 | |
2e038148 NC |
6088 | =item Arrays now always interpolate into double-quoted strings [561] |
6089 | ||
6090 | =item Miscellaneous Changes | |
b6235c4f RGS |
6091 | |
6092 | =back | |
6093 | ||
6094 | =item Modules and Pragmata | |
6095 | ||
6096 | =over 4 | |
6097 | ||
2e038148 | 6098 | =item New Modules and Pragmata |
b6235c4f | 6099 | |
2e038148 | 6100 | =item Updated And Improved Modules and Pragmata |
b6235c4f RGS |
6101 | |
6102 | =back | |
6103 | ||
6104 | =item Utility Changes | |
6105 | ||
6106 | =item New Documentation | |
6107 | ||
2e038148 NC |
6108 | =item Performance Enhancements |
6109 | ||
b6235c4f RGS |
6110 | =item Installation and Configuration Improvements |
6111 | ||
6112 | =over 4 | |
6113 | ||
2e038148 NC |
6114 | =item Generic Improvements |
6115 | ||
6116 | =item New Or Improved Platforms | |
b6235c4f RGS |
6117 | |
6118 | =back | |
6119 | ||
6120 | =item Selected Bug Fixes | |
6121 | ||
6122 | =over 4 | |
6123 | ||
2e038148 | 6124 | =item Platform Specific Changes and Fixes |
b6235c4f RGS |
6125 | |
6126 | =back | |
6127 | ||
6128 | =item New or Changed Diagnostics | |
6129 | ||
2e038148 NC |
6130 | =item Changed Internals |
6131 | ||
6132 | =item Security Vulnerability Closed [561] | |
6133 | ||
6134 | =item New Tests | |
6135 | ||
6136 | =item Known Problems | |
6137 | ||
b6235c4f RGS |
6138 | =over 4 |
6139 | ||
2e038148 | 6140 | =item The Compiler Suite Is Still Very Experimental |
b6235c4f | 6141 | |
2e038148 | 6142 | =item Localising Tied Arrays and Hashes Is Broken |
b6235c4f | 6143 | |
2e038148 | 6144 | =item Building Extensions Can Fail Because Of Largefiles |
b6235c4f | 6145 | |
2e038148 | 6146 | =item Modifying $_ Inside for(..) |
b6235c4f | 6147 | |
2e038148 | 6148 | =item mod_perl 1.26 Doesn't Build With Threaded Perl |
b6235c4f | 6149 | |
2e038148 | 6150 | =item lib/ftmp-security tests warn 'system possibly insecure' |
b6235c4f | 6151 | |
2e038148 | 6152 | =item libwww-perl (LWP) fails base/date #51 |
b6235c4f | 6153 | |
2e038148 | 6154 | =item PDL failing some tests |
b6235c4f | 6155 | |
2e038148 | 6156 | =item Perl_get_sv |
b6235c4f | 6157 | |
2e038148 | 6158 | =item Self-tying Problems |
b6235c4f | 6159 | |
2e038148 | 6160 | =item ext/threads/t/libc |
b6235c4f | 6161 | |
2e038148 | 6162 | =item Failure of Thread (5.005-style) tests |
b6235c4f | 6163 | |
2e038148 | 6164 | =item Timing problems |
b6235c4f | 6165 | |
2e038148 | 6166 | =item Tied/Magical Array/Hash Elements Do Not Autovivify |
b6235c4f | 6167 | |
2e038148 | 6168 | =item Unicode in package/class and subroutine names does not work |
b6235c4f | 6169 | |
2e038148 | 6170 | =back |
b6235c4f | 6171 | |
2e038148 | 6172 | =item Platform Specific Problems |
b6235c4f RGS |
6173 | |
6174 | =over 4 | |
6175 | ||
2e038148 | 6176 | =item AIX |
b6235c4f | 6177 | |
2e038148 | 6178 | =item Alpha systems with old gccs fail several tests |
b6235c4f | 6179 | |
2e038148 | 6180 | =item AmigaOS |
b6235c4f | 6181 | |
2e038148 | 6182 | =item BeOS |
b6235c4f | 6183 | |
2e038148 | 6184 | =item Cygwin "unable to remap" |
b6235c4f | 6185 | |
2e038148 | 6186 | =item Cygwin ndbm tests fail on FAT |
b6235c4f | 6187 | |
2e038148 | 6188 | =item DJGPP Failures |
b6235c4f | 6189 | |
2e038148 | 6190 | =item FreeBSD built with ithreads coredumps reading large directories |
b6235c4f | 6191 | |
2e038148 | 6192 | =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales |
b6235c4f | 6193 | |
2e038148 | 6194 | =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 |
b6235c4f | 6195 | |
2e038148 | 6196 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
b6235c4f | 6197 | |
2e038148 | 6198 | =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint |
b6235c4f | 6199 | |
2e038148 | 6200 | =item Linux With Sfio Fails op/misc Test 48 |
b6235c4f | 6201 | |
2e038148 | 6202 | =item Mac OS X |
b6235c4f | 6203 | |
2e038148 NC |
6204 | =item Mac OS X dyld undefined symbols |
6205 | ||
6206 | =item OS/2 Test Failures | |
6207 | ||
6208 | =item op/sprintf tests 91, 129, and 130 | |
6209 | ||
6210 | =item SCO | |
6211 | ||
6212 | =item Solaris 2.5 | |
6213 | ||
6214 | =item Solaris x86 Fails Tests With -Duse64bitint | |
6215 | ||
6216 | =item SUPER-UX (NEC SX) | |
6217 | ||
6218 | =item Term::ReadKey not working on Win32 | |
6219 | ||
6220 | =item UNICOS/mk | |
6221 | ||
6222 | =item UTS | |
6223 | ||
6224 | =item VOS (Stratus) | |
6225 | ||
6226 | =item VMS | |
6227 | ||
6228 | =item Win32 | |
6229 | ||
6230 | =item XML::Parser not working | |
6231 | ||
6232 | =item z/OS (OS/390) | |
6233 | ||
6234 | =item Unicode Support on EBCDIC Still Spotty | |
6235 | ||
6236 | =item Seen In Perl 5.7 But Gone Now | |
6237 | ||
6238 | =back | |
b6235c4f RGS |
6239 | |
6240 | =item Reporting Bugs | |
6241 | ||
6242 | =item SEE ALSO | |
6243 | ||
2e038148 NC |
6244 | =item HISTORY |
6245 | ||
b6235c4f RGS |
6246 | =back |
6247 | ||
2a551100 JH |
6248 | =head2 perl573delta - what's new for perl v5.7.3 |
6249 | ||
6250 | =over 4 | |
6251 | ||
6252 | =item DESCRIPTION | |
6253 | ||
6254 | =item Changes | |
6255 | ||
6256 | =item Reporting Bugs | |
6257 | ||
6258 | =item SEE ALSO | |
6259 | ||
6260 | =item HISTORY | |
6261 | ||
6262 | =back | |
6263 | ||
d6483fcc | 6264 | =head2 perl572delta - what's new for perl v5.7.2 |
245d750e JH |
6265 | |
6266 | =over 4 | |
6267 | ||
6268 | =item DESCRIPTION | |
6269 | ||
6270 | =item Security Vulnerability Closed | |
6271 | ||
6272 | =item Incompatible Changes | |
6273 | ||
cb5953d6 JH |
6274 | =over 4 |
6275 | ||
6276 | =item 64-bit platforms and malloc | |
6277 | ||
e0539f61 JH |
6278 | =item AIX Dynaloading |
6279 | ||
6280 | =item Socket Extension Dynamic in VMS | |
6281 | ||
fbe3d936 JH |
6282 | =item Different Definition of the Unicode Character Classes \p{In...} |
6283 | ||
e0539f61 | 6284 | =item Deprecations |
772ff3b9 | 6285 | |
cb5953d6 JH |
6286 | =back |
6287 | ||
245d750e JH |
6288 | =item Core Enhancements |
6289 | ||
6290 | =item Modules and Pragmata | |
6291 | ||
6292 | =over 4 | |
6293 | ||
389925df | 6294 | =item New Modules and Distributions |
245d750e JH |
6295 | |
6296 | =item Updated And Improved Modules and Pragmata | |
6297 | ||
6298 | =back | |
6299 | ||
245d750e JH |
6300 | =item Utility Changes |
6301 | ||
6302 | =item New Documentation | |
6303 | ||
6304 | =item Installation and Configuration Improvements | |
6305 | ||
6306 | =over 4 | |
6307 | ||
6308 | =item New Or Improved Platforms | |
6309 | ||
6310 | =item Generic Improvements | |
6311 | ||
6312 | =back | |
6313 | ||
6314 | =item Selected Bug Fixes | |
6315 | ||
6316 | =over 4 | |
6317 | ||
6318 | =item Platform Specific Changes and Fixes | |
6319 | ||
6320 | =back | |
6321 | ||
6322 | =item New or Changed Diagnostics | |
6323 | ||
354a27bf | 6324 | =item Source Code Enhancements |
245d750e JH |
6325 | |
6326 | =over 4 | |
6327 | ||
354a27bf JH |
6328 | =item MAGIC constants |
6329 | ||
6330 | =item Better commented code | |
6331 | ||
245d750e JH |
6332 | =item Regex pre-/post-compilation items matched up |
6333 | ||
354a27bf JH |
6334 | =item gcc -Wall |
6335 | ||
245d750e JH |
6336 | =back |
6337 | ||
6338 | =item New Tests | |
6339 | ||
6340 | =item Known Problems | |
6341 | ||
6342 | =over 4 | |
6343 | ||
e0539f61 JH |
6344 | =item AIX |
6345 | ||
6346 | =item Amiga Perl Invoking Mystery | |
245d750e JH |
6347 | |
6348 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
6349 | ||
e0539f61 | 6350 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 |
245d750e | 6351 | |
07fcf8ff | 6352 | =item HP-UX lib/io_multihomed Fails When LP64-Configured |
245d750e | 6353 | |
e0539f61 | 6354 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
245d750e JH |
6355 | |
6356 | =item Linux With Sfio Fails op/misc Test 48 | |
6357 | ||
fbe3d936 JH |
6358 | =item OS/390 |
6359 | ||
e0539f61 | 6360 | =item op/sprintf tests 129 and 130 |
245d750e JH |
6361 | |
6362 | =item Failure of Thread tests | |
6363 | ||
e0539f61 JH |
6364 | =item UNICOS |
6365 | ||
e0539f61 JH |
6366 | =item UTS |
6367 | ||
354a27bf JH |
6368 | =item VMS |
6369 | ||
d0363f02 JH |
6370 | =item Win32 |
6371 | ||
245d750e JH |
6372 | =item Localising a Tied Variable Leaks Memory |
6373 | ||
6374 | =item Self-tying of Arrays and Hashes Is Forbidden | |
6375 | ||
cb5953d6 JH |
6376 | =item Variable Attributes are not Currently Usable for Tieing |
6377 | ||
245d750e JH |
6378 | =item Building Extensions Can Fail Because Of Largefiles |
6379 | ||
6380 | =item The Compiler Suite Is Still Experimental | |
6381 | ||
e0539f61 JH |
6382 | =item The Long Double Support is Still Experimental |
6383 | ||
245d750e JH |
6384 | =back |
6385 | ||
6386 | =item Reporting Bugs | |
6387 | ||
6388 | =item SEE ALSO | |
6389 | ||
6390 | =item HISTORY | |
6391 | ||
6392 | =back | |
6393 | ||
603b90a8 JH |
6394 | =head2 perl571delta - what's new for perl v5.7.1 |
6395 | ||
6396 | =over 4 | |
6397 | ||
6398 | =item DESCRIPTION | |
6399 | ||
6400 | =item Security Vulnerability Closed | |
6401 | ||
6402 | =item Incompatible Changes | |
6403 | ||
6404 | =item Core Enhancements | |
6405 | ||
245d750e JH |
6406 | =over 4 |
6407 | ||
2ca5449f JH |
6408 | =item AUTOLOAD Is Now Lvaluable |
6409 | ||
245d750e JH |
6410 | =item PerlIO is Now The Default |
6411 | ||
6412 | =item Signals Are Now Safe | |
6413 | ||
6414 | =back | |
6415 | ||
bd28ded5 | 6416 | =item Modules and Pragmata |
603b90a8 JH |
6417 | |
6418 | =over 4 | |
6419 | ||
603b90a8 JH |
6420 | =item New Modules |
6421 | ||
6422 | =item Updated And Improved Modules and Pragmata | |
6423 | ||
6424 | =back | |
6425 | ||
6426 | =item Performance Enhancements | |
6427 | ||
6428 | =item Utility Changes | |
6429 | ||
6430 | =item New Documentation | |
6431 | ||
6432 | =over 4 | |
6433 | ||
6434 | =item perlclib | |
6435 | ||
6436 | =item perliol | |
6437 | ||
6438 | =item README.aix | |
6439 | ||
6440 | =item README.bs2000 | |
6441 | ||
6442 | =item README.macos | |
6443 | ||
6444 | =item README.mpeix | |
6445 | ||
6446 | =item README.solaris | |
6447 | ||
6448 | =item README.vos | |
6449 | ||
6450 | =item Porting/repository.pod | |
6451 | ||
6452 | =back | |
6453 | ||
603b90a8 JH |
6454 | =item Installation and Configuration Improvements |
6455 | ||
6456 | =over 4 | |
6457 | ||
6458 | =item New Or Improved Platforms | |
6459 | ||
6460 | =item Generic Improvements | |
6461 | ||
bd28ded5 JH |
6462 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, |
6463 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, | |
6464 | d_strtoq, d_u32align, d_ualarm, d_usleep | |
6465 | ||
603b90a8 JH |
6466 | =back |
6467 | ||
6468 | =item Selected Bug Fixes | |
6469 | ||
6470 | =over 4 | |
6471 | ||
6472 | =item Platform Specific Changes and Fixes | |
6473 | ||
6474 | =back | |
6475 | ||
6476 | =item New or Changed Diagnostics | |
6477 | ||
6478 | =item Changed Internals | |
6479 | ||
bd28ded5 JH |
6480 | =item New Tests |
6481 | ||
603b90a8 JH |
6482 | =item Known Problems |
6483 | ||
6484 | =over 4 | |
6485 | ||
bd28ded5 JH |
6486 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl |
6487 | ||
6488 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
6489 | ||
6490 | =item lib/io_multihomed Fails In LP64-Configured HP-UX | |
6491 | ||
6492 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
6493 | ||
603b90a8 JH |
6494 | =item lib/b test 19 |
6495 | ||
bd28ded5 | 6496 | =item Linux With Sfio Fails op/misc Test 48 |
603b90a8 JH |
6497 | |
6498 | =item sigaction test 13 in VMS | |
6499 | ||
6500 | =item sprintf tests 129 and 130 | |
6501 | ||
bd28ded5 JH |
6502 | =item Failure of Thread tests |
6503 | ||
6504 | =item Localising a Tied Variable Leaks Memory | |
6505 | ||
603b90a8 JH |
6506 | =item Self-tying of Arrays and Hashes Is Forbidden |
6507 | ||
bd28ded5 JH |
6508 | =item Building Extensions Can Fail Because Of Largefiles |
6509 | ||
6510 | =item The Compiler Suite Is Still Experimental | |
6511 | ||
603b90a8 JH |
6512 | =back |
6513 | ||
6514 | =item Reporting Bugs | |
6515 | ||
6516 | =item SEE ALSO | |
6517 | ||
6518 | =item HISTORY | |
6519 | ||
6520 | =back | |
6521 | ||
6522 | =head2 perl570delta - what's new for perl v5.7.0 | |
694468e3 | 6523 | |
d420ca49 | 6524 | =over 4 |
694468e3 | 6525 | |
7029d033 | 6526 | =item DESCRIPTION |
694468e3 | 6527 | |
a9ef4385 JH |
6528 | =item Security Vulnerability Closed |
6529 | ||
6530 | =item Incompatible Changes | |
6531 | ||
7029d033 | 6532 | =item Core Enhancements |
694468e3 | 6533 | |
7029d033 | 6534 | =item Modules and Pragmata |
694468e3 | 6535 | |
d420ca49 | 6536 | =over 4 |
a9ef4385 JH |
6537 | |
6538 | =item New Modules | |
6539 | ||
6540 | =item Updated And Improved Modules and Pragmata | |
6541 | ||
6542 | =back | |
6543 | ||
7029d033 | 6544 | =item Utility Changes |
694468e3 | 6545 | |
a9ef4385 | 6546 | =item New Documentation |
694468e3 | 6547 | |
a9ef4385 | 6548 | =item Performance Enhancements |
694468e3 | 6549 | |
7029d033 | 6550 | =item Installation and Configuration Improvements |
694468e3 | 6551 | |
d420ca49 | 6552 | =over 4 |
694468e3 | 6553 | |
a9ef4385 | 6554 | =item Generic Improvements |
694468e3 | 6555 | |
4755096e | 6556 | =back |
694468e3 | 6557 | |
a9ef4385 | 6558 | =item Selected Bug Fixes |
694468e3 | 6559 | |
d420ca49 | 6560 | =over 4 |
cb1a09d0 | 6561 | |
a9ef4385 | 6562 | =item Platform Specific Changes and Fixes |
cb1a09d0 | 6563 | |
a9ef4385 | 6564 | =back |
cb1a09d0 | 6565 | |
a9ef4385 JH |
6566 | =item New or Changed Diagnostics |
6567 | ||
6568 | =item Changed Internals | |
cb1a09d0 | 6569 | |
4755096e | 6570 | =item Known Problems |
cb1a09d0 | 6571 | |
d420ca49 | 6572 | =over 4 |
a9ef4385 JH |
6573 | |
6574 | =item Unicode Support Still Far From Perfect | |
6575 | ||
6576 | =item EBCDIC Still A Lost Platform | |
6577 | ||
6578 | =item Building Extensions Can Fail Because Of Largefiles | |
6579 | ||
93d73c42 JH |
6580 | =item ftmp-security tests warn 'system possibly insecure' |
6581 | ||
b3b6085d PP |
6582 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
6583 | ||
93d73c42 | 6584 | =item Long Doubles Still Don't Work In Solaris |
9fa7f388 | 6585 | |
b3b6085d PP |
6586 | =item Linux With Sfio Fails op/misc Test 48 |
6587 | ||
9fa7f388 | 6588 | =item Storable tests fail in some platforms |
a9ef4385 | 6589 | |
93d73c42 JH |
6590 | =item Threads Are Still Experimental |
6591 | ||
6592 | =item The Compiler Suite Is Still Experimental | |
6593 | ||
a9ef4385 | 6594 | =back |
193fb0af | 6595 | |
4755096e | 6596 | =item Reporting Bugs |
8ebc5c01 | 6597 | |
4755096e | 6598 | =item SEE ALSO |
8ebc5c01 | 6599 | |
4755096e | 6600 | =item HISTORY |
8ebc5c01 | 6601 | |
a45bd81d GS |
6602 | =back |
6603 | ||
f502af34 | 6604 | =head2 perl561delta - what's new for perl v5.6.x |
493a87da JH |
6605 | |
6606 | =over 4 | |
6607 | ||
6608 | =item DESCRIPTION | |
6609 | ||
6610 | =item Summary of changes between 5.6.0 and 5.6.1 | |
6611 | ||
6612 | =over 4 | |
6613 | ||
6614 | =item Security Issues | |
6615 | ||
6616 | =item Core bug fixes | |
6617 | ||
6618 | C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), | |
6619 | Bugs in regular expressions, "slurp" mode, Autovivification of symbolic | |
6620 | references to special variables, Lexical warnings, Spurious warnings and | |
6621 | errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, | |
6622 | map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, | |
6623 | Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no | |
6624 | Module;>, Tests | |
6625 | ||
6626 | =item Core features | |
6627 | ||
6628 | =item Configuration issues | |
6629 | ||
6630 | =item Documentation | |
6631 | ||
6632 | =item Bundled modules | |
6633 | ||
6634 | B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, | |
6635 | Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, | |
6636 | IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, | |
6637 | Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash | |
6638 | ||
6639 | =item Platform-specific improvements | |
6640 | ||
6641 | NCR MP-RAS, NonStop-UX | |
6642 | ||
04b01f78 JH |
6643 | =back |
6644 | ||
6645 | =item Core Enhancements | |
6646 | ||
6647 | =over 4 | |
6648 | ||
493a87da JH |
6649 | =item Interpreter cloning, threads, and concurrency |
6650 | ||
6651 | =item Lexically scoped warning categories | |
6652 | ||
6653 | =item Unicode and UTF-8 support | |
6654 | ||
6655 | =item Support for interpolating named characters | |
6656 | ||
6657 | =item "our" declarations | |
6658 | ||
6659 | =item Support for strings represented as a vector of ordinals | |
6660 | ||
6661 | =item Improved Perl version numbering system | |
6662 | ||
6663 | =item New syntax for declaring subroutine attributes | |
6664 | ||
6665 | =item File and directory handles can be autovivified | |
6666 | ||
6667 | =item open() with more than two arguments | |
6668 | ||
6669 | =item 64-bit support | |
6670 | ||
6671 | =item Large file support | |
6672 | ||
6673 | =item Long doubles | |
6674 | ||
6675 | =item "more bits" | |
6676 | ||
6677 | =item Enhanced support for sort() subroutines | |
6678 | ||
6679 | =item C<sort $coderef @foo> allowed | |
6680 | ||
6681 | =item File globbing implemented internally | |
6682 | ||
6683 | =item Support for CHECK blocks | |
6684 | ||
6685 | =item POSIX character class syntax [: :] supported | |
6686 | ||
6687 | =item Better pseudo-random number generator | |
6688 | ||
6689 | =item Improved C<qw//> operator | |
6690 | ||
6691 | =item Better worst-case behavior of hashes | |
6692 | ||
6693 | =item pack() format 'Z' supported | |
6694 | ||
6695 | =item pack() format modifier '!' supported | |
6696 | ||
6697 | =item pack() and unpack() support counted strings | |
6698 | ||
6699 | =item Comments in pack() templates | |
6700 | ||
6701 | =item Weak references | |
6702 | ||
6703 | =item Binary numbers supported | |
6704 | ||
6705 | =item Lvalue subroutines | |
6706 | ||
6707 | =item Some arrows may be omitted in calls through references | |
6708 | ||
6709 | =item Boolean assignment operators are legal lvalues | |
6710 | ||
6711 | =item exists() is supported on subroutine names | |
6712 | ||
6713 | =item exists() and delete() are supported on array elements | |
6714 | ||
6715 | =item Pseudo-hashes work better | |
6716 | ||
6717 | =item Automatic flushing of output buffers | |
6718 | ||
6719 | =item Better diagnostics on meaningless filehandle operations | |
6720 | ||
6721 | =item Where possible, buffered data discarded from duped input filehandle | |
6722 | ||
6723 | =item eof() has the same old magic as <> | |
6724 | ||
6725 | =item binmode() can be used to set :crlf and :raw modes | |
6726 | ||
6727 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" | |
6728 | ||
6729 | =item system(), backticks and pipe open now reflect exec() failure | |
6730 | ||
6731 | =item Improved diagnostics | |
6732 | ||
6733 | =item Diagnostics follow STDERR | |
6734 | ||
6735 | =item More consistent close-on-exec behavior | |
6736 | ||
6737 | =item syswrite() ease-of-use | |
6738 | ||
6739 | =item Better syntax checks on parenthesized unary operators | |
6740 | ||
6741 | =item Bit operators support full native integer width | |
6742 | ||
6743 | =item Improved security features | |
6744 | ||
6745 | =item More functional bareword prototype (*) | |
6746 | ||
6747 | =item C<require> and C<do> may be overridden | |
6748 | ||
6749 | =item $^X variables may now have names longer than one character | |
6750 | ||
6751 | =item New variable $^C reflects C<-c> switch | |
6752 | ||
6753 | =item New variable $^V contains Perl version as a string | |
6754 | ||
6755 | =item Optional Y2K warnings | |
6756 | ||
6757 | =item Arrays now always interpolate into double-quoted strings | |
6758 | ||
6759 | =back | |
6760 | ||
6761 | =item Modules and Pragmata | |
6762 | ||
6763 | =over 4 | |
6764 | ||
6765 | =item Modules | |
6766 | ||
6767 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, | |
6768 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
6769 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
6770 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
6771 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
6772 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
6773 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
6774 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
6775 | ||
6776 | =item Pragmata | |
6777 | ||
6778 | =back | |
6779 | ||
6780 | =item Utility Changes | |
6781 | ||
6782 | =over 4 | |
6783 | ||
6784 | =item dprofpp | |
6785 | ||
6786 | =item find2perl | |
6787 | ||
6788 | =item h2xs | |
6789 | ||
6790 | =item perlcc | |
6791 | ||
6792 | =item perldoc | |
6793 | ||
6794 | =item The Perl Debugger | |
6795 | ||
6796 | =back | |
6797 | ||
6798 | =item Improved Documentation | |
6799 | ||
6800 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, | |
6801 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
6802 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
6803 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
6804 | ||
6805 | =item Performance enhancements | |
6806 | ||
6807 | =over 4 | |
6808 | ||
6809 | =item Simple sort() using { $a <=> $b } and the like are optimized | |
6810 | ||
6811 | =item Optimized assignments to lexical variables | |
6812 | ||
6813 | =item Faster subroutine calls | |
6814 | ||
6815 | =item delete(), each(), values() and hash iteration are faster | |
6816 | ||
6817 | =back | |
6818 | ||
6819 | =item Installation and Configuration Improvements | |
6820 | ||
6821 | =over 4 | |
6822 | ||
6823 | =item -Dusethreads means something different | |
6824 | ||
6825 | =item New Configure flags | |
6826 | ||
6827 | =item Threadedness and 64-bitness now more daring | |
6828 | ||
6829 | =item Long Doubles | |
6830 | ||
6831 | =item -Dusemorebits | |
6832 | ||
6833 | =item -Duselargefiles | |
6834 | ||
6835 | =item installusrbinperl | |
6836 | ||
6837 | =item SOCKS support | |
6838 | ||
6839 | =item C<-A> flag | |
6840 | ||
6841 | =item Enhanced Installation Directories | |
6842 | ||
6843 | =item gcc automatically tried if 'cc' does not seem to be working | |
6844 | ||
6845 | =back | |
6846 | ||
6847 | =item Platform specific changes | |
6848 | ||
6849 | =over 4 | |
6850 | ||
6851 | =item Supported platforms | |
6852 | ||
6853 | =item DOS | |
6854 | ||
6855 | =item OS390 (OpenEdition MVS) | |
6856 | ||
6857 | =item VMS | |
6858 | ||
6859 | =item Win32 | |
6860 | ||
6861 | =back | |
6862 | ||
6863 | =item Significant bug fixes | |
6864 | ||
6865 | =over 4 | |
6866 | ||
6867 | =item <HANDLE> on empty files | |
6868 | ||
6869 | =item C<eval '...'> improvements | |
6870 | ||
6871 | =item All compilation errors are true errors | |
6872 | ||
6873 | =item Implicitly closed filehandles are safer | |
6874 | ||
6875 | =item Behavior of list slices is more consistent | |
6876 | ||
6877 | =item C<(\$)> prototype and C<$foo{a}> | |
6878 | ||
6879 | =item C<goto &sub> and AUTOLOAD | |
6880 | ||
6881 | =item C<-bareword> allowed under C<use integer> | |
6882 | ||
6883 | =item Failures in DESTROY() | |
6884 | ||
6885 | =item Locale bugs fixed | |
6886 | ||
6887 | =item Memory leaks | |
6888 | ||
6889 | =item Spurious subroutine stubs after failed subroutine calls | |
6890 | ||
6891 | =item Taint failures under C<-U> | |
6892 | ||
6893 | =item END blocks and the C<-c> switch | |
6894 | ||
6895 | =item Potential to leak DATA filehandles | |
6896 | ||
6897 | =back | |
6898 | ||
6899 | =item New or Changed Diagnostics | |
6900 | ||
6901 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet | |
6902 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
6903 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
6904 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
6905 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
6906 | passed through, /%s/ should probably be written as "%s", %s() called too | |
6907 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
6908 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
6909 | subroutine name, %s package attribute may clash with future reserved word: | |
6910 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
6911 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
6912 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
6913 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
6914 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
6915 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
6916 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
6917 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
6918 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
6919 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
6920 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
6921 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
6922 | "local" instead of "our"?), Document contains no data, entering effective | |
6923 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
6924 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
6925 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
6926 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
6927 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
6928 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
6929 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
6930 | separator character %s in attribute list, Invalid separator character %s in | |
6931 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
6932 | returning %s not implemented yet, Method %s not permitted, Missing | |
6933 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
6934 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
6935 | No space allowed after -%c, no UTC offset information; assuming local time | |
6936 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
6937 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
6938 | around "%s" list, Possible unintended interpolation of %s in string, | |
6939 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
6940 | instead, Premature end of script headers, Repeat count in pack overflows, | |
6941 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
6942 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
6943 | zero-length expression, switching effective %s is not implemented, This | |
6944 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
6945 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
6946 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
6947 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
6948 | list, Unterminated attribute list, Unterminated attribute parameter in | |
6949 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
6950 | CLI symbol "%s" too long, Version number must be a constant number | |
6951 | ||
6952 | =item New tests | |
6953 | ||
6954 | =item Incompatible Changes | |
6955 | ||
6956 | =over 4 | |
6957 | ||
6958 | =item Perl Source Incompatibilities | |
6959 | ||
6960 | CHECK is a new keyword, Treatment of list slices of undef has changed, | |
6961 | Format of $English::PERL_VERSION is different, Literals of the form | |
6962 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
6963 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
6964 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
6965 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), | |
6966 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
6967 | Text of some diagnostic output has changed, C<%@> has been removed, | |
6968 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
6969 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
6970 | on 64-bit platforms, More builtins taint their results | |
6971 | ||
6972 | =item C Source Incompatibilities | |
6973 | ||
6974 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> | |
6975 | ||
6976 | =item Compatible C Source API Changes | |
6977 | ||
6978 | C<PATCHLEVEL> is now C<PERL_VERSION> | |
6979 | ||
6980 | =item Binary Incompatibilities | |
6981 | ||
6982 | =back | |
6983 | ||
6984 | =item Known Problems | |
6985 | ||
6986 | =over 4 | |
6987 | ||
6988 | =item Localizing a tied hash element may leak memory | |
6989 | ||
6990 | =item Known test failures | |
6991 | ||
493a87da JH |
6992 | =item EBCDIC platforms not fully supported |
6993 | ||
6994 | =item UNICOS/mk CC failures during Configure run | |
6995 | ||
6996 | =item Arrow operator and arrays | |
6997 | ||
6998 | =item Experimental features | |
6999 | ||
7000 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The | |
7001 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
7002 | globbing, The DB module, The regular expression code constructs: | |
7003 | ||
7004 | =back | |
7005 | ||
7006 | =item Obsolete Diagnostics | |
7007 | ||
7008 | Character class syntax [: :] is reserved for future extensions, Ill-formed | |
7009 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
7010 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
7011 | to mean "${$}<digit>" is deprecated | |
7012 | ||
7013 | =item Reporting Bugs | |
7014 | ||
7015 | =item SEE ALSO | |
7016 | ||
7017 | =item HISTORY | |
7018 | ||
7019 | =back | |
7020 | ||
f502af34 | 7021 | =head2 perl56delta - what's new for perl v5.6.0 |
14218588 | 7022 | |
d420ca49 | 7023 | =over 4 |
a45bd81d | 7024 | |
14218588 GS |
7025 | =item DESCRIPTION |
7026 | ||
4755096e | 7027 | =item Core Enhancements |
14218588 | 7028 | |
d420ca49 | 7029 | =over 4 |
14218588 | 7030 | |
4755096e | 7031 | =item Interpreter cloning, threads, and concurrency |
14218588 | 7032 | |
4755096e | 7033 | =item Lexically scoped warning categories |
14218588 | 7034 | |
4755096e | 7035 | =item Unicode and UTF-8 support |
14218588 | 7036 | |
4755096e | 7037 | =item Support for interpolating named characters |
14218588 | 7038 | |
4755096e | 7039 | =item "our" declarations |
14218588 | 7040 | |
4755096e | 7041 | =item Support for strings represented as a vector of ordinals |
14218588 | 7042 | |
4755096e | 7043 | =item Improved Perl version numbering system |
14218588 | 7044 | |
4755096e | 7045 | =item New syntax for declaring subroutine attributes |
14218588 | 7046 | |
4755096e | 7047 | =item File and directory handles can be autovivified |
14218588 | 7048 | |
4755096e | 7049 | =item open() with more than two arguments |
14218588 | 7050 | |
4755096e | 7051 | =item 64-bit support |
14218588 | 7052 | |
4755096e | 7053 | =item Large file support |
14218588 | 7054 | |
4755096e | 7055 | =item Long doubles |
14218588 | 7056 | |
4755096e | 7057 | =item "more bits" |
14218588 | 7058 | |
4755096e | 7059 | =item Enhanced support for sort() subroutines |
14218588 | 7060 | |
4755096e | 7061 | =item C<sort $coderef @foo> allowed |
14218588 | 7062 | |
4755096e | 7063 | =item File globbing implemented internally |
14218588 | 7064 | |
4755096e | 7065 | =item Support for CHECK blocks |
14218588 | 7066 | |
4755096e | 7067 | =item POSIX character class syntax [: :] supported |
14218588 | 7068 | |
4755096e | 7069 | =item Better pseudo-random number generator |
a45bd81d | 7070 | |
4755096e | 7071 | =item Improved C<qw//> operator |
8ebc5c01 | 7072 | |
4755096e | 7073 | =item Better worst-case behavior of hashes |
a45bd81d | 7074 | |
4755096e | 7075 | =item pack() format 'Z' supported |
8ebc5c01 | 7076 | |
4755096e | 7077 | =item pack() format modifier '!' supported |
8ebc5c01 | 7078 | |
4755096e | 7079 | =item pack() and unpack() support counted strings |
8ebc5c01 | 7080 | |
4755096e | 7081 | =item Comments in pack() templates |
8ebc5c01 | 7082 | |
4755096e | 7083 | =item Weak references |
8ebc5c01 | 7084 | |
4755096e | 7085 | =item Binary numbers supported |
8ebc5c01 | 7086 | |
4755096e | 7087 | =item Lvalue subroutines |
14218588 | 7088 | |
4755096e | 7089 | =item Some arrows may be omitted in calls through references |
8ebc5c01 | 7090 | |
4755096e | 7091 | =item Boolean assignment operators are legal lvalues |
8ebc5c01 | 7092 | |
4755096e | 7093 | =item exists() is supported on subroutine names |
8ebc5c01 | 7094 | |
4755096e | 7095 | =item exists() and delete() are supported on array elements |
cb1a09d0 | 7096 | |
4755096e | 7097 | =item Pseudo-hashes work better |
cb1a09d0 | 7098 | |
4755096e | 7099 | =item Automatic flushing of output buffers |
cb1a09d0 | 7100 | |
4755096e | 7101 | =item Better diagnostics on meaningless filehandle operations |
cb1a09d0 | 7102 | |
4755096e | 7103 | =item Where possible, buffered data discarded from duped input filehandle |
a45bd81d | 7104 | |
4755096e | 7105 | =item eof() has the same old magic as <> |
cb1a09d0 | 7106 | |
4755096e | 7107 | =item binmode() can be used to set :crlf and :raw modes |
a45bd81d | 7108 | |
4755096e | 7109 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
cb1a09d0 | 7110 | |
4755096e | 7111 | =item system(), backticks and pipe open now reflect exec() failure |
cb1a09d0 | 7112 | |
4755096e | 7113 | =item Improved diagnostics |
cb1a09d0 | 7114 | |
4755096e | 7115 | =item Diagnostics follow STDERR |
cb1a09d0 | 7116 | |
4755096e | 7117 | =item More consistent close-on-exec behavior |
cb1a09d0 | 7118 | |
4755096e | 7119 | =item syswrite() ease-of-use |
cb1a09d0 | 7120 | |
4755096e | 7121 | =item Better syntax checks on parenthesized unary operators |
cb1a09d0 | 7122 | |
4755096e | 7123 | =item Bit operators support full native integer width |
cb1a09d0 | 7124 | |
4755096e | 7125 | =item Improved security features |
cb1a09d0 | 7126 | |
4755096e | 7127 | =item More functional bareword prototype (*) |
cb1a09d0 | 7128 | |
4755096e | 7129 | =item C<require> and C<do> may be overridden |
cb1a09d0 | 7130 | |
4755096e | 7131 | =item $^X variables may now have names longer than one character |
4fdae800 | 7132 | |
4755096e | 7133 | =item New variable $^C reflects C<-c> switch |
cb1a09d0 | 7134 | |
4755096e | 7135 | =item New variable $^V contains Perl version as a string |
cb1a09d0 | 7136 | |
4755096e | 7137 | =item Optional Y2K warnings |
cb1a09d0 | 7138 | |
4755096e | 7139 | =item Arrays now always interpolate into double-quoted strings |
cb1a09d0 | 7140 | |
a45bd81d GS |
7141 | =back |
7142 | ||
4755096e | 7143 | =item Modules and Pragmata |
cb1a09d0 | 7144 | |
d420ca49 | 7145 | =over 4 |
a45bd81d | 7146 | |
4755096e | 7147 | =item Modules |
cb1a09d0 | 7148 | |
4755096e GS |
7149 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
7150 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
7151 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
7152 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
7153 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
7154 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
7155 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
7156 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
cb1a09d0 | 7157 | |
4755096e | 7158 | =item Pragmata |
cb1a09d0 | 7159 | |
4755096e | 7160 | =back |
cb1a09d0 | 7161 | |
4755096e | 7162 | =item Utility Changes |
cb1a09d0 | 7163 | |
d420ca49 | 7164 | =over 4 |
cb1a09d0 | 7165 | |
4755096e | 7166 | =item dprofpp |
cb1a09d0 | 7167 | |
4755096e | 7168 | =item find2perl |
cb1a09d0 | 7169 | |
4755096e | 7170 | =item h2xs |
cb1a09d0 | 7171 | |
4755096e | 7172 | =item perlcc |
cb1a09d0 | 7173 | |
4755096e GS |
7174 | =item perldoc |
7175 | ||
7176 | =item The Perl Debugger | |
cb1a09d0 | 7177 | |
a45bd81d GS |
7178 | =back |
7179 | ||
4755096e | 7180 | =item Improved Documentation |
cb1a09d0 | 7181 | |
4755096e GS |
7182 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
7183 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
7184 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
7185 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
a45bd81d | 7186 | |
4755096e | 7187 | =item Performance enhancements |
cb1a09d0 | 7188 | |
d420ca49 | 7189 | =over 4 |
cb1a09d0 | 7190 | |
4755096e | 7191 | =item Simple sort() using { $a <=> $b } and the like are optimized |
cb1a09d0 | 7192 | |
4755096e | 7193 | =item Optimized assignments to lexical variables |
193fb0af | 7194 | |
4755096e GS |
7195 | =item Faster subroutine calls |
7196 | ||
7197 | =item delete(), each(), values() and hash iteration are faster | |
193fb0af GS |
7198 | |
7199 | =back | |
7200 | ||
4755096e | 7201 | =item Installation and Configuration Improvements |
cb1a09d0 | 7202 | |
d420ca49 | 7203 | =over 4 |
cb1a09d0 | 7204 | |
4755096e | 7205 | =item -Dusethreads means something different |
68dc0745 | 7206 | |
4755096e | 7207 | =item New Configure flags |
68dc0745 | 7208 | |
4755096e | 7209 | =item Threadedness and 64-bitness now more daring |
68dc0745 | 7210 | |
4755096e | 7211 | =item Long Doubles |
cb1a09d0 | 7212 | |
4755096e | 7213 | =item -Dusemorebits |
55497cff | 7214 | |
4755096e GS |
7215 | =item -Duselargefiles |
7216 | ||
7217 | =item installusrbinperl | |
7218 | ||
7219 | =item SOCKS support | |
7220 | ||
7221 | =item C<-A> flag | |
7222 | ||
7223 | =item Enhanced Installation Directories | |
193fb0af | 7224 | |
8ebc5c01 | 7225 | =back |
7226 | ||
4755096e | 7227 | =item Platform specific changes |
55497cff | 7228 | |
d420ca49 | 7229 | =over 4 |
cb1a09d0 | 7230 | |
4755096e | 7231 | =item Supported platforms |
193fb0af | 7232 | |
4755096e | 7233 | =item DOS |
55497cff | 7234 | |
4755096e GS |
7235 | =item OS390 (OpenEdition MVS) |
7236 | ||
7237 | =item VMS | |
7238 | ||
7239 | =item Win32 | |
55497cff | 7240 | |
c90c0ff4 | 7241 | =back |
7242 | ||
4755096e | 7243 | =item Significant bug fixes |
c90c0ff4 | 7244 | |
d420ca49 | 7245 | =over 4 |
c90c0ff4 | 7246 | |
4755096e | 7247 | =item <HANDLE> on empty files |
c90c0ff4 | 7248 | |
4755096e | 7249 | =item C<eval '...'> improvements |
c90c0ff4 | 7250 | |
4755096e | 7251 | =item All compilation errors are true errors |
c90c0ff4 | 7252 | |
4755096e | 7253 | =item Implicitly closed filehandles are safer |
cb1a09d0 | 7254 | |
4755096e | 7255 | =item Behavior of list slices is more consistent |
cb1a09d0 | 7256 | |
4755096e | 7257 | =item C<(\$)> prototype and C<$foo{a}> |
cb1a09d0 | 7258 | |
4755096e | 7259 | =item C<goto &sub> and AUTOLOAD |
c90c0ff4 | 7260 | |
4755096e | 7261 | =item C<-bareword> allowed under C<use integer> |
c90c0ff4 | 7262 | |
4755096e | 7263 | =item Failures in DESTROY() |
cb1a09d0 | 7264 | |
4755096e GS |
7265 | =item Locale bugs fixed |
7266 | ||
7267 | =item Memory leaks | |
7268 | ||
7269 | =item Spurious subroutine stubs after failed subroutine calls | |
cb1a09d0 | 7270 | |
4755096e | 7271 | =item Taint failures under C<-U> |
55497cff | 7272 | |
4755096e | 7273 | =item END blocks and the C<-c> switch |
55497cff | 7274 | |
4755096e | 7275 | =item Potential to leak DATA filehandles |
55497cff | 7276 | |
a45bd81d GS |
7277 | =back |
7278 | ||
4755096e | 7279 | =item New or Changed Diagnostics |
a45bd81d | 7280 | |
4755096e GS |
7281 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
7282 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
7283 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
7284 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
7285 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
7286 | passed through, /%s/ should probably be written as "%s", %s() called too | |
7287 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
7288 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
7289 | subroutine name, %s package attribute may clash with future reserved word: | |
7290 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
7291 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
7292 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
7293 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
7294 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
7295 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
7296 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
7297 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
7298 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
7299 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
7300 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
7301 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
7302 | "local" instead of "our"?), Document contains no data, entering effective | |
7303 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
7304 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
7305 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
7306 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
7307 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
7308 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
7309 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
7310 | separator character %s in attribute list, Invalid separator character %s in | |
7311 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
7312 | returning %s not implemented yet, Method %s not permitted, Missing | |
7313 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
7314 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
7315 | No space allowed after -%c, no UTC offset information; assuming local time | |
7316 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
7317 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
7318 | around "%s" list, Possible unintended interpolation of %s in string, | |
7319 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
7320 | instead, Premature end of script headers, Repeat count in pack overflows, | |
7321 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
7322 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
7323 | zero-length expression, switching effective %s is not implemented, This | |
7324 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
7325 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
7326 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
7327 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
7328 | list, Unterminated attribute list, Unterminated attribute parameter in | |
7329 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
7330 | CLI symbol "%s" too long, Version number must be a constant number | |
14218588 | 7331 | |
4755096e | 7332 | =item New tests |
14218588 | 7333 | |
4755096e | 7334 | =item Incompatible Changes |
14218588 | 7335 | |
d420ca49 | 7336 | =over 4 |
14218588 | 7337 | |
4755096e | 7338 | =item Perl Source Incompatibilities |
14218588 | 7339 | |
4755096e GS |
7340 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
7341 | Format of $English::PERL_VERSION is different, Literals of the form | |
7342 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
7343 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
7344 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
983dbef6 JH |
7345 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
7346 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
7347 | Text of some diagnostic output has changed, C<%@> has been removed, | |
7348 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
7349 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
7350 | on 64-bit platforms, More builtins taint their results | |
14218588 | 7351 | |
4755096e | 7352 | =item C Source Incompatibilities |
14218588 | 7353 | |
4755096e | 7354 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
14218588 | 7355 | |
4755096e | 7356 | =item Compatible C Source API Changes |
a45bd81d | 7357 | |
4755096e | 7358 | C<PATCHLEVEL> is now C<PERL_VERSION> |
55497cff | 7359 | |
4755096e | 7360 | =item Binary Incompatibilities |
a45bd81d | 7361 | |
4755096e | 7362 | =back |
55497cff | 7363 | |
4755096e | 7364 | =item Known Problems |
55497cff | 7365 | |
d420ca49 | 7366 | =over 4 |
55497cff | 7367 | |
4755096e | 7368 | =item Thread test failures |
b38f6a39 | 7369 | |
4755096e | 7370 | =item EBCDIC platforms not supported |
774d564b | 7371 | |
4755096e | 7372 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
774d564b | 7373 | |
4755096e | 7374 | =item NEXTSTEP 3.3 POSIX test failure |
774d564b | 7375 | |
4755096e GS |
7376 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
7377 | gcc | |
cb1a09d0 | 7378 | |
4755096e | 7379 | =item UNICOS/mk CC failures during Configure run |
cb1a09d0 | 7380 | |
4755096e | 7381 | =item Arrow operator and arrays |
cb1a09d0 | 7382 | |
4755096e | 7383 | =item Experimental features |
cb1a09d0 | 7384 | |
4755096e GS |
7385 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
7386 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
983dbef6 | 7387 | globbing, The DB module, The regular expression code constructs: |
cb1a09d0 | 7388 | |
b38f6a39 | 7389 | =back |
cb1a09d0 | 7390 | |
4755096e | 7391 | =item Obsolete Diagnostics |
b38f6a39 | 7392 | |
4755096e GS |
7393 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
7394 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
7395 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
7396 | to mean "${$}<digit>" is deprecated | |
7397 | ||
7398 | =item Reporting Bugs | |
cb1a09d0 | 7399 | |
b38f6a39 | 7400 | =item SEE ALSO |
cb1a09d0 | 7401 | |
4755096e | 7402 | =item HISTORY |
193fb0af | 7403 | |
8ebc5c01 | 7404 | =back |
cb1a09d0 | 7405 | |
f502af34 | 7406 | =head2 perl5005delta - what's new for perl5.005 |
193fb0af | 7407 | |
d420ca49 | 7408 | =over 4 |
193fb0af | 7409 | |
b38f6a39 | 7410 | =item DESCRIPTION |
193fb0af | 7411 | |
4755096e | 7412 | =item About the new versioning system |
193fb0af | 7413 | |
4755096e | 7414 | =item Incompatible Changes |
193fb0af | 7415 | |
d420ca49 | 7416 | =over 4 |
b38f6a39 | 7417 | |
4755096e | 7418 | =item WARNING: This version is not binary compatible with Perl 5.004. |
b38f6a39 | 7419 | |
4755096e | 7420 | =item Default installation structure has changed |
b38f6a39 | 7421 | |
4755096e | 7422 | =item Perl Source Compatibility |
193fb0af | 7423 | |
4755096e | 7424 | =item C Source Compatibility |
b38f6a39 | 7425 | |
4755096e | 7426 | =item Binary Compatibility |
b38f6a39 | 7427 | |
4755096e | 7428 | =item Security fixes may affect compatibility |
b38f6a39 | 7429 | |
4755096e | 7430 | =item Relaxed new mandatory warnings introduced in 5.004 |
b38f6a39 | 7431 | |
4755096e | 7432 | =item Licensing |
193fb0af GS |
7433 | |
7434 | =back | |
cb1a09d0 | 7435 | |
4755096e | 7436 | =item Core Changes |
fb9cefb4 | 7437 | |
d420ca49 | 7438 | =over 4 |
fb9cefb4 | 7439 | |
4755096e | 7440 | =item Threads |
fb9cefb4 | 7441 | |
4755096e | 7442 | =item Compiler |
fb9cefb4 | 7443 | |
4755096e | 7444 | =item Regular Expressions |
fb9cefb4 | 7445 | |
4755096e GS |
7446 | Many new and improved optimizations, Many bug fixes, New regular expression |
7447 | constructs, New operator for precompiled regular expressions, Other | |
7448 | improvements, Incompatible changes | |
fb9cefb4 | 7449 | |
4755096e | 7450 | =item Improved malloc() |
fb9cefb4 | 7451 | |
4755096e | 7452 | =item Quicksort is internally implemented |
ac65edd0 | 7453 | |
4755096e | 7454 | =item Reliable signals |
ac65edd0 | 7455 | |
4755096e | 7456 | =item Reliable stack pointers |
ac65edd0 | 7457 | |
4755096e | 7458 | =item More generous treatment of carriage returns |
ac65edd0 | 7459 | |
4755096e | 7460 | =item Memory leaks |
ac65edd0 | 7461 | |
4755096e | 7462 | =item Better support for multiple interpreters |
ac65edd0 | 7463 | |
4755096e | 7464 | =item Behavior of local() on array and hash elements is now well-defined |
ac65edd0 | 7465 | |
4755096e | 7466 | =item C<%!> is transparently tied to the L<Errno> module |
ac65edd0 | 7467 | |
4755096e | 7468 | =item Pseudo-hashes are supported |
b38f6a39 | 7469 | |
4755096e | 7470 | =item C<EXPR foreach EXPR> is supported |
ac65edd0 | 7471 | |
4755096e | 7472 | =item Keywords can be globally overridden |
ac65edd0 | 7473 | |
4755096e | 7474 | =item C<$^E> is meaningful on Win32 |
ac65edd0 | 7475 | |
4755096e | 7476 | =item C<foreach (1..1000000)> optimized |
cb1a09d0 | 7477 | |
d61fd583 | 7478 | =item C<Foo::> can be used as implicitly quoted package name |
639f8edf | 7479 | |
d61fd583 | 7480 | =item C<exists $Foo::{Bar::}> tests existence of a package |
639f8edf | 7481 | |
d61fd583 | 7482 | =item Better locale support |
639f8edf | 7483 | |
d61fd583 | 7484 | =item Experimental support for 64-bit platforms |
639f8edf | 7485 | |
d61fd583 | 7486 | =item prototype() returns useful results on builtins |
639f8edf | 7487 | |
f99d9048 RGS |
7488 | =item Extended support for exception handling |
7489 | ||
7490 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods | |
7491 | ||
7492 | =item All C<printf> format conversions are handled internally | |
7493 | ||
7494 | =item New C<INIT> keyword | |
7495 | ||
7496 | =item New C<lock> keyword | |
7497 | ||
7498 | =item New C<qr//> operator | |
7499 | ||
7500 | =item C<our> is now a reserved word | |
7501 | ||
7502 | =item Tied arrays are now fully supported | |
7503 | ||
7504 | =item Tied handles support is better | |
7505 | ||
7506 | =item 4th argument to substr | |
7507 | ||
7508 | =item Negative LENGTH argument to splice | |
7509 | ||
7510 | =item Magic lvalues are now more magical | |
7511 | ||
7512 | =item <> now reads in records | |
7513 | ||
7514 | =back | |
7515 | ||
7516 | =item Supported Platforms | |
7517 | ||
7518 | =over 4 | |
7519 | ||
7520 | =item New Platforms | |
7521 | ||
7522 | =item Changes in existing support | |
7523 | ||
7524 | =back | |
7525 | ||
7526 | =item Modules and Pragmata | |
7527 | ||
7528 | =over 4 | |
7529 | ||
7530 | =item New Modules | |
7531 | ||
7532 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, | |
7533 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
7534 | Thread, attrs, fields, re | |
7535 | ||
7536 | =item Changes in existing modules | |
7537 | ||
7538 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, | |
7539 | MakeMaker, CPAN, Cwd | |
7540 | ||
7541 | =back | |
7542 | ||
7543 | =item Utility Changes | |
7544 | ||
7545 | =item Documentation Changes | |
7546 | ||
7547 | =item New Diagnostics | |
7548 | ||
7549 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
7550 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
7551 | package, Can't call method "%s" on an undefined value, Can't check | |
7552 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
7553 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
7554 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
7555 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
7556 | Character class syntax [: :] is reserved for future extensions, Character | |
7557 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
7558 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
7559 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
7560 | package main), Illegal hex digit ignored, No such array field, No such | |
7561 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
7562 | large request, Range iterator outside integer range, Recursive inheritance | |
7563 | detected while looking for method '%s' %s, Reference found where even-sized | |
7564 | list expected, Undefined value assigned to typeglob, Use of reserved word | |
7565 | "%s" is deprecated, perl: warning: Setting locale failed | |
7566 | ||
7567 | =item Obsolete Diagnostics | |
7568 | ||
7569 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open | |
7570 | temporary file, regexp too big | |
7571 | ||
7572 | =item Configuration Changes | |
7573 | ||
7574 | =item BUGS | |
7575 | ||
7576 | =item SEE ALSO | |
7577 | ||
7578 | =item HISTORY | |
7579 | ||
7580 | =back | |
7581 | ||
7582 | =head2 perl5004delta - what's new for perl5.004 | |
7583 | ||
7584 | =over 4 | |
7585 | ||
7586 | =item DESCRIPTION | |
7587 | ||
7588 | =item Supported Environments | |
7589 | ||
7590 | =item Core Changes | |
7591 | ||
7592 | =over 4 | |
7593 | ||
7594 | =item List assignment to %ENV works | |
7595 | ||
7596 | =item Change to "Can't locate Foo.pm in @INC" error | |
7597 | ||
7598 | =item Compilation option: Binary compatibility with 5.003 | |
7599 | ||
7600 | =item $PERL5OPT environment variable | |
7601 | ||
7602 | =item Limitations on B<-M>, B<-m>, and B<-T> options | |
7603 | ||
7604 | =item More precise warnings | |
7605 | ||
7606 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods | |
7607 | ||
7608 | =item Previously deprecated %OVERLOAD is no longer usable | |
7609 | ||
7610 | =item Subroutine arguments created only when they're modified | |
7611 | ||
7612 | =item Group vector changeable with C<$)> | |
7613 | ||
7614 | =item Fixed parsing of $$<digit>, &$<digit>, etc. | |
7615 | ||
7616 | =item Fixed localization of $<digit>, $&, etc. | |
7617 | ||
7618 | =item No resetting of $. on implicit close | |
7619 | ||
7620 | =item C<wantarray> may return undef | |
7621 | ||
7622 | =item C<eval EXPR> determines value of EXPR in scalar context | |
7623 | ||
7624 | =item Changes to tainting checks | |
7625 | ||
7626 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No | |
7627 | spawning if tainted $TERM doesn't look like a terminal name | |
7628 | ||
7629 | =item New Opcode module and revised Safe module | |
7630 | ||
7631 | =item Embedding improvements | |
7632 | ||
7633 | =item Internal change: FileHandle class based on IO::* classes | |
7634 | ||
7635 | =item Internal change: PerlIO abstraction interface | |
7636 | ||
7637 | =item New and changed syntax | |
7638 | ||
7639 | $coderef->(PARAMS) | |
7640 | ||
7641 | =item New and changed builtin constants | |
7642 | ||
7643 | __PACKAGE__ | |
7644 | ||
7645 | =item New and changed builtin variables | |
7646 | ||
7647 | $^E, $^H, $^M | |
7648 | ||
7649 | =item New and changed builtin functions | |
7650 | ||
7651 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in | |
7652 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
7653 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
7654 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
7655 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
7656 | ||
7657 | =item New builtin methods | |
7658 | ||
7659 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
7660 | ||
7661 | =item TIEHANDLE now supported | |
7662 | ||
7663 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this | |
7664 | LIST, READLINE this, GETC this, DESTROY this | |
7665 | ||
7666 | =item Malloc enhancements | |
7667 | ||
7668 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE | |
7669 | ||
7670 | =item Miscellaneous efficiency enhancements | |
7671 | ||
7672 | =back | |
7673 | ||
7674 | =item Support for More Operating Systems | |
7675 | ||
7676 | =over 4 | |
7677 | ||
7678 | =item Win32 | |
7679 | ||
7680 | =item Plan 9 | |
7681 | ||
7682 | =item QNX | |
7683 | ||
7684 | =item AmigaOS | |
7685 | ||
7686 | =back | |
7687 | ||
7688 | =item Pragmata | |
7689 | ||
7690 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
7691 | constant NAME => VALUE, use locale, use ops, use vmsish | |
7692 | ||
7693 | =item Modules | |
7694 | ||
7695 | =over 4 | |
7696 | ||
7697 | =item Required Updates | |
7698 | ||
7699 | =item Installation directories | |
7700 | ||
7701 | =item Module information summary | |
7702 | ||
7703 | =item Fcntl | |
7704 | ||
7705 | =item IO | |
7706 | ||
7707 | =item Math::Complex | |
7708 | ||
7709 | =item Math::Trig | |
7710 | ||
7711 | =item DB_File | |
7712 | ||
7713 | =item Net::Ping | |
7714 | ||
7715 | =item Object-oriented overrides for builtin operators | |
7716 | ||
7717 | =back | |
7718 | ||
7719 | =item Utility Changes | |
7720 | ||
7721 | =over 4 | |
7722 | ||
7723 | =item pod2html | |
7724 | ||
7725 | Sends converted HTML to standard output | |
7726 | ||
7727 | =item xsubpp | |
7728 | ||
7729 | C<void> XSUBs now default to returning nothing | |
7730 | ||
7731 | =back | |
7732 | ||
7733 | =item C Language API Changes | |
7734 | ||
7735 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for | |
7736 | manipulating hashes | |
7737 | ||
7738 | =item Documentation Changes | |
7739 | ||
7740 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, | |
7741 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
7742 | ||
7743 | =item New Diagnostics | |
7744 | ||
7745 | "my" variable %s masks earlier declaration in same scope, %s argument is | |
7746 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
7747 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
7748 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
7749 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
7750 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
7751 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
7752 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
7753 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
7754 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
7755 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
7756 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
7757 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
7758 | possible typo, Null picture in formline, Offset outside string, Out of | |
7759 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
7760 | attempt to put comments in qw() list, Possible attempt to separate words | |
7761 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
7762 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" | |
7763 | option, untie attempted while %d inner references still exist, Unrecognized | |
7764 | character %s, Unsupported function fork, Use of "$$<digit>" to mean | |
7765 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), | |
7766 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, | |
7767 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, | |
7768 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too | |
7769 | long, Process terminated by SIG%s | |
7770 | ||
7771 | =item BUGS | |
7772 | ||
7773 | =item SEE ALSO | |
7774 | ||
7775 | =item HISTORY | |
7776 | ||
7777 | =back | |
7778 | ||
7779 | =head2 perlartistic - the Perl Artistic License | |
7780 | ||
7781 | =over 4 | |
7782 | ||
7783 | =item SYNOPSIS | |
7784 | ||
7785 | =item DESCRIPTION | |
7786 | ||
7787 | =item The "Artistic License" | |
7788 | ||
7789 | =over 4 | |
7790 | ||
7791 | =item Preamble | |
7792 | ||
7793 | =item Definitions | |
7794 | ||
7795 | "Package", "Standard Version", "Copyright Holder", "You", "Reasonable | |
7796 | copying fee", "Freely Available" | |
7797 | ||
7798 | =item Conditions | |
7799 | ||
7800 | a), b), c), d), a), b), c), d) | |
7801 | ||
7802 | =back | |
7803 | ||
7804 | =back | |
7805 | ||
7806 | =head2 perlgpl - the GNU General Public License, version 2 | |
7807 | ||
7808 | =over 4 | |
7809 | ||
7810 | =item SYNOPSIS | |
7811 | ||
7812 | =back | |
7813 | ||
7814 | =over 4 | |
7815 | ||
7816 | =item DESCRIPTION | |
7817 | ||
7818 | =item GNU GENERAL PUBLIC LICENSE | |
7819 | ||
7820 | =back | |
7821 | ||
7822 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems | |
7823 | ||
7824 | =over 4 | |
7825 | ||
7826 | =item DESCRIPTION | |
7827 | ||
7828 | =over 4 | |
7829 | ||
7830 | =item Compiling Perl 5 on AIX | |
7831 | ||
7832 | =item OS level | |
7833 | ||
7834 | =item Building Dynamic Extensions on AIX | |
7835 | ||
7836 | =item The IBM ANSI C Compiler | |
7837 | ||
7838 | =item The usenm option | |
7839 | ||
7840 | =item Using GNU's gcc for building perl | |
7841 | ||
7842 | =item Using Large Files with Perl | |
7843 | ||
7844 | =item Threaded Perl | |
7845 | ||
7846 | =item 64-bit Perl | |
7847 | ||
7848 | =item AIX 4.2 and extensions using C++ with statics | |
7849 | ||
7850 | =back | |
7851 | ||
7852 | =item AUTHOR | |
7853 | ||
7854 | =item DATE | |
7855 | ||
7856 | =back | |
7857 | ||
7858 | =head2 perlamiga - Perl under Amiga OS | |
7859 | ||
7860 | =over 4 | |
7861 | ||
7862 | =item NOTE | |
7863 | ||
7864 | =item SYNOPSIS | |
7865 | ||
7866 | =back | |
7867 | ||
7868 | =over 4 | |
7869 | ||
7870 | =item DESCRIPTION | |
7871 | ||
7872 | =over 4 | |
7873 | ||
7874 | =item Prerequisites for Compiling Perl on AmigaOS | |
7875 | ||
7876 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> | |
7877 | ||
7878 | =item Starting Perl programs under AmigaOS | |
7879 | ||
7880 | =item Shortcomings of Perl under AmigaOS | |
7881 | ||
7882 | =back | |
7883 | ||
7884 | =item INSTALLATION | |
7885 | ||
7886 | =item Accessing documentation | |
7887 | ||
7888 | =over 4 | |
7889 | ||
7890 | =item Manpages for Perl on AmigaOS | |
7891 | ||
7892 | =item Perl HTML Documentation on AmigaOS | |
7893 | ||
7894 | =item Perl GNU Info Files on AmigaOS | |
7895 | ||
7896 | =item Perl LaTeX Documentation on AmigaOS | |
7897 | ||
7898 | =back | |
7899 | ||
7900 | =item BUILDING PERL ON AMIGAOS | |
7901 | ||
7902 | =over 4 | |
7903 | ||
7904 | =item Build Prerequisites for Perl on AmigaOS | |
7905 | ||
7906 | =item Getting the Perl Source for AmigaOS | |
7907 | ||
7908 | =item Making Perl on AmigaOS | |
7909 | ||
7910 | =item Testing Perl on AmigaOS | |
7911 | ||
7912 | =item Installing the built Perl on AmigaOS | |
7913 | ||
7914 | =back | |
7915 | ||
7916 | =item PERL 5.8.0 BROKEN IN AMIGAOS | |
7917 | ||
7918 | =item AUTHORS | |
7919 | ||
7920 | =item SEE ALSO | |
7921 | ||
7922 | =back | |
7923 | ||
7924 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS | |
7925 | ||
7926 | =over 4 | |
7927 | ||
7928 | =item DESCRIPTION | |
7929 | ||
7930 | =item AUTHOR | |
7931 | ||
7932 | =back | |
7933 | ||
df344c0f | 7934 | =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS |
f99d9048 RGS |
7935 | |
7936 | =over 4 | |
7937 | ||
7938 | =item DESCRIPTION | |
7939 | ||
df344c0f | 7940 | =item BUILD AND INSTALL |
f99d9048 | 7941 | |
df344c0f | 7942 | =over 4 |
f99d9048 | 7943 | |
df344c0f | 7944 | =item Requirements |
f99d9048 | 7945 | |
df344c0f | 7946 | =item Configure |
f99d9048 | 7947 | |
df344c0f | 7948 | =item Build |
f99d9048 | 7949 | |
df344c0f | 7950 | =item Install |
f99d9048 RGS |
7951 | |
7952 | =back | |
7953 | ||
df344c0f NC |
7954 | =item KNOWN PROBLEMS |
7955 | ||
7956 | =item CONTACT | |
7957 | ||
f99d9048 RGS |
7958 | =back |
7959 | ||
7960 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. | |
7961 | ||
7962 | =over 4 | |
7963 | ||
7964 | =item SYNOPSIS | |
7965 | ||
7966 | =item DESCRIPTION | |
7967 | ||
7968 | =over 4 | |
7969 | ||
7970 | =item gzip on BS2000 | |
7971 | ||
7972 | =item bison on BS2000 | |
7973 | ||
7974 | =item Unpacking Perl Distribution on BS2000 | |
7975 | ||
7976 | =item Compiling Perl on BS2000 | |
7977 | ||
7978 | =item Testing Perl on BS2000 | |
7979 | ||
7980 | =item Installing Perl on BS2000 | |
7981 | ||
7982 | =item Using Perl in the Posix-Shell of BS2000 | |
7983 | ||
7984 | =item Using Perl in "native" BS2000 | |
7985 | ||
7986 | =item Floating point anomalies on BS2000 | |
7987 | ||
7988 | =item Using PerlIO and different encodings on ASCII and EBCDIC partitions | |
7989 | ||
7990 | =back | |
7991 | ||
7992 | =item AUTHORS | |
7993 | ||
7994 | =item SEE ALSO | |
7995 | ||
7996 | =over 4 | |
7997 | ||
7998 | =item Mailing list | |
7999 | ||
8000 | =back | |
8001 | ||
8002 | =item HISTORY | |
8003 | ||
8004 | =back | |
8005 | ||
8006 | =head2 perlce - Perl for WinCE | |
8007 | ||
8008 | =over 4 | |
8009 | ||
8010 | =item DESCRIPTION | |
8011 | ||
8012 | =item BUILD | |
8013 | ||
8014 | =over 4 | |
8015 | ||
8016 | =item Tools & SDK | |
8017 | ||
8018 | Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's | |
8019 | celib-sources, Rainer Keuchel's console-sources | |
8020 | ||
8021 | =item Make | |
8022 | ||
8023 | go to ./wince subdirectory, edit file compile.bat, run compile.bat, run | |
8024 | compile.bat dist | |
8025 | ||
8026 | =back | |
8027 | ||
8028 | =item ACKNOWLEDGEMENTS | |
8029 | ||
8030 | =item AUTHORS | |
8031 | ||
8032 | =back | |
8033 | ||
8034 | =head2 perlcygwin, README.cygwin - Perl for Cygwin | |
8035 | ||
8036 | =over 4 | |
8037 | ||
8038 | =item SYNOPSIS | |
8039 | ||
8040 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN | |
8041 | ||
8042 | =over 4 | |
8043 | ||
8044 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) | |
8045 | ||
8046 | =item Cygwin Configuration | |
8047 | ||
8048 | C<PATH>, I<nroff>, Permissions | |
8049 | ||
8050 | =back | |
8051 | ||
8052 | =item CONFIGURE PERL ON CYGWIN | |
8053 | ||
8054 | =over 4 | |
8055 | ||
8056 | =item Stripping Perl Binaries on Cygwin | |
8057 | ||
8058 | =item Optional Libraries for Perl on Cygwin | |
8059 | ||
8060 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), | |
8061 | C<-lcygipc> (C<use IPC::SysV>), C<-lutil> | |
8062 | ||
8063 | =item Configure-time Options for Perl on Cygwin | |
8064 | ||
8065 | C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, | |
8066 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, | |
8067 | C<-Dmksymlinks> | |
8068 | ||
8069 | =item Suspicious Warnings on Cygwin | |
8070 | ||
8071 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines | |
8072 | ||
8073 | =back | |
8074 | ||
8075 | =item MAKE ON CYGWIN | |
8076 | ||
8077 | =over 4 | |
8078 | ||
8079 | =item Errors on Cygwin | |
8080 | ||
8081 | =item ld2 on Cygwin | |
8082 | ||
8083 | =back | |
8084 | ||
8085 | =item TEST ON CYGWIN | |
8086 | ||
8087 | =over 4 | |
8088 | ||
8089 | =item File Permissions on Cygwin | |
8090 | ||
8091 | =item NDBM_File and ODBM_File do not work on FAT filesystems | |
8092 | ||
8093 | =item C<fork()> failures in io_* tests | |
8094 | ||
8095 | =item Script Portability on Cygwin | |
8096 | ||
8097 | Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous | |
8098 | ||
8099 | =back | |
8100 | ||
8101 | =item INSTALL PERL ON CYGWIN | |
8102 | ||
8103 | =item MANIFEST ON CYGWIN | |
8104 | ||
8105 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl | |
8106 | Source, Compiled Module Source, Perl Modules/Scripts | |
8107 | ||
8108 | =item BUGS ON CYGWIN | |
8109 | ||
8110 | =item AUTHORS | |
8111 | ||
8112 | =item HISTORY | |
8113 | ||
8114 | =back | |
8115 | ||
8116 | =head2 perldgux - Perl under DG/UX. | |
8117 | ||
8118 | =over 4 | |
8119 | ||
8120 | =item SYNOPSIS | |
8121 | ||
8122 | =back | |
8123 | ||
8124 | =over 4 | |
8125 | ||
8126 | =item DESCRIPTION | |
8127 | ||
8128 | =item BUILDING PERL ON DG/UX | |
8129 | ||
8130 | =over 4 | |
8131 | ||
8132 | =item Non-threaded Perl on DG/UX | |
8133 | ||
8134 | =item Threaded Perl on DG/UX | |
8135 | ||
8136 | =item Testing Perl on DG/UX | |
8137 | ||
8138 | =item Installing the built perl on DG/UX | |
8139 | ||
8140 | =back | |
8141 | ||
8142 | =item AUTHOR | |
8143 | ||
8144 | =item SEE ALSO | |
8145 | ||
8146 | =back | |
8147 | ||
8148 | =head2 perldos - Perl under DOS, W31, W95. | |
8149 | ||
8150 | =over 4 | |
8151 | ||
8152 | =item SYNOPSIS | |
8153 | ||
8154 | =item DESCRIPTION | |
8155 | ||
8156 | =over 4 | |
8157 | ||
8158 | =item Prerequisites for Compiling Perl on DOS | |
8159 | ||
8160 | DJGPP, Pthreads | |
8161 | ||
8162 | =item Shortcomings of Perl under DOS | |
8163 | ||
8164 | =item Building Perl on DOS | |
8165 | ||
8166 | =item Testing Perl on DOS | |
8167 | ||
8168 | =item Installation of Perl on DOS | |
8169 | ||
8170 | =back | |
8171 | ||
8172 | =item BUILDING AND INSTALLING MODULES ON DOS | |
8173 | ||
8174 | =over 4 | |
8175 | ||
8176 | =item Building Prerequisites for Perl on DOS | |
8177 | ||
8178 | =item Unpacking CPAN Modules on DOS | |
8179 | ||
8180 | =item Building Non-XS Modules on DOS | |
8181 | ||
8182 | =item Building XS Modules on DOS | |
8183 | ||
8184 | =back | |
8185 | ||
8186 | =item AUTHOR | |
8187 | ||
8188 | =item SEE ALSO | |
8189 | ||
8190 | =back | |
8191 | ||
8192 | =head2 perlepoc, README.epoc - Perl for EPOC | |
8193 | ||
8194 | =over 4 | |
8195 | ||
8196 | =item SYNOPSIS | |
8197 | ||
8198 | =item INTRODUCTION | |
8199 | ||
8200 | =item INSTALLING PERL ON EPOC | |
8201 | ||
8202 | =item STARTING PERL ON EPOC | |
8203 | ||
8204 | =over 4 | |
8205 | ||
8206 | =item Editors on Epoc | |
8207 | ||
8208 | =item Features of Perl on Epoc | |
8209 | ||
8210 | =item Restrictions of Perl on Epoc | |
8211 | ||
8212 | =item Compiling Perl 5 on the EPOC cross compiling environment | |
8213 | ||
8214 | =back | |
8215 | ||
8216 | =item SUPPORT STATUS OF PERL ON EPOC | |
8217 | ||
8218 | =item AUTHOR | |
8219 | ||
8220 | =item LAST UPDATE | |
8221 | ||
8222 | =back | |
8223 | ||
8224 | =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems | |
8225 | ||
8226 | =over 4 | |
8227 | ||
8228 | =item DESCRIPTION | |
8229 | ||
8230 | =over 4 | |
8231 | ||
8232 | =item FreeBSD core dumps from readdir_r with ithreads | |
8233 | ||
8234 | =item $^X doesn't always contain a full path in FreeBSD | |
8235 | ||
8236 | =item Perl will no longer be part of "base FreeBSD" | |
8237 | ||
8238 | =back | |
8239 | ||
8240 | =item AUTHOR | |
8241 | ||
8242 | =back | |
8243 | ||
8244 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix | |
8245 | (HP-UX) systems | |
8246 | ||
8247 | =over 4 | |
8248 | ||
8249 | =item DESCRIPTION | |
8250 | ||
8251 | =over 4 | |
8252 | ||
8253 | =item Using perl as shipped with HP-UX | |
8254 | ||
8255 | =item Using perl from HP's porting centre | |
8256 | ||
8257 | =item Compiling Perl 5 on HP-UX | |
8258 | ||
8259 | =item PA-RISC | |
8260 | ||
e4bb216d NC |
8261 | =item Portability Between PA-RISC Versions |
8262 | ||
f99d9048 RGS |
8263 | =item PA-RISC 1.0 |
8264 | ||
8265 | =item PA-RISC 1.1 | |
8266 | ||
8267 | =item PA-RISC 2.0 | |
8268 | ||
f99d9048 RGS |
8269 | =item Itanium Processor Family and HP-UX |
8270 | ||
e4bb216d NC |
8271 | =item Itanium & Itanium 2 |
8272 | ||
f99d9048 RGS |
8273 | =item Building Dynamic Extensions on HP-UX |
8274 | ||
8275 | =item The HP ANSI C Compiler | |
8276 | ||
8277 | =item The GNU C Compiler | |
8278 | ||
8279 | =item Using Large Files with Perl on HP-UX | |
8280 | ||
8281 | =item Threaded Perl on HP-UX | |
8282 | ||
8283 | =item 64-bit Perl on HP-UX | |
8284 | ||
8285 | =item Oracle on HP-UX | |
8286 | ||
8287 | =item GDBM and Threads on HP-UX | |
8288 | ||
8289 | =item NFS filesystems and utime(2) on HP-UX | |
8290 | ||
8291 | =item perl -P and // and HP-UX | |
8292 | ||
8293 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl | |
8294 | ||
8295 | =back | |
8296 | ||
8297 | =item nss_delete core dump from op/pwent or op/grent | |
8298 | ||
8299 | =item AUTHOR | |
8300 | ||
8301 | =item DATE | |
8302 | ||
8303 | =back | |
8304 | ||
8305 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd | |
8306 | ||
8307 | =over 4 | |
8308 | ||
8309 | =item DESCRIPTION | |
8310 | ||
8311 | =over 4 | |
8312 | ||
8313 | =item Known Problems with Perl on Hurd | |
8314 | ||
8315 | =back | |
8316 | ||
8317 | =item AUTHOR | |
8318 | ||
8319 | =back | |
8320 | ||
8321 | =head2 perlirix, README.irix - Perl version 5 on Irix systems | |
8322 | ||
8323 | =over 4 | |
8324 | ||
8325 | =item DESCRIPTION | |
8326 | ||
8327 | =over 4 | |
8328 | ||
8329 | =item Building 32-bit Perl in Irix | |
8330 | ||
8331 | =item Building 64-bit Perl in Irix | |
8332 | ||
8333 | =item About Compiler Versions of Irix | |
8334 | ||
8335 | =item Linker Problems in Irix | |
8336 | ||
8337 | =item Malloc in Irix | |
8338 | ||
8339 | =item Building with threads in Irix | |
8340 | ||
8341 | =item Irix 5.3 | |
8342 | ||
8343 | =back | |
8344 | ||
8345 | =item AUTHOR | |
8346 | ||
8347 | =back | |
8348 | ||
8349 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen | |
8350 | systems | |
8351 | ||
8352 | =over 4 | |
8353 | ||
8354 | =item DESCRIPTION | |
8355 | ||
8356 | =over 4 | |
8357 | ||
8358 | =item Perl version 5.8.x and greater not supported | |
8359 | ||
8360 | =item Compiling Perl 5.6.x on MachTen | |
8361 | ||
8362 | =item Failures during C<make test> on MachTen | |
8363 | ||
8364 | op/lexassign.t, pragma/warnings.t | |
8365 | ||
8366 | =item Building external modules on MachTen | |
8367 | ||
8368 | =back | |
8369 | ||
8370 | =item AUTHOR | |
8371 | ||
8372 | =item DATE | |
8373 | ||
8374 | =back | |
8375 | ||
8376 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) | |
8377 | ||
8378 | =over 4 | |
8379 | ||
8380 | =item SYNOPSIS | |
8381 | ||
8382 | =item DESCRIPTION | |
8383 | ||
8384 | =item AUTHOR | |
8385 | ||
8386 | =item DATE | |
8387 | ||
8388 | =back | |
8389 | ||
8390 | =head2 perlmacosx, README.macosx - Perl under Mac OS X | |
8391 | ||
8392 | =over 4 | |
8393 | ||
8394 | =item SYNOPSIS | |
8395 | ||
8396 | =item DESCRIPTION | |
8397 | ||
8398 | =over 4 | |
8399 | ||
8400 | =item Installation Prefix | |
8401 | ||
8402 | =item libperl and Prebinding | |
8403 | ||
8404 | =item Updating Panther | |
8405 | ||
8406 | =item Known problems | |
8407 | ||
8408 | =item MacPerl | |
8409 | ||
8410 | =item Carbon | |
8411 | ||
8412 | =item Cocoa | |
8413 | ||
8414 | =back | |
8415 | ||
8416 | =item Starting From Scratch | |
8417 | ||
8418 | =item AUTHOR | |
8419 | ||
8420 | =item DATE | |
8421 | ||
8422 | =back | |
8423 | ||
8424 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT | |
8425 | ||
8426 | =over 4 | |
8427 | ||
8428 | =item DESCRIPTION | |
8429 | ||
8430 | =item Known problems with Perl on MiNT | |
8431 | ||
8432 | =item AUTHOR | |
8433 | ||
8434 | =back | |
8435 | ||
8436 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE | |
8437 | ||
8438 | =over 4 | |
8439 | ||
8440 | =item SYNOPSIS | |
8441 | ||
8442 | =item NOTE | |
8443 | ||
8444 | =item Binary distribution from HP | |
8445 | ||
8446 | =item What's New in Perl for MPE/iX | |
8447 | ||
8448 | =item Welcome to Perl/iX | |
8449 | ||
8450 | =item System Requirements for Perl/iX | |
8451 | ||
8452 | =item How to Obtain Perl/iX | |
8453 | ||
8454 | =item Perl/iX Distribution Contents Highlights | |
8455 | ||
8456 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, | |
8457 | public_html/feedback.cgi, src/perl-5.6.0-mpe | |
8458 | ||
8459 | =item How to Compile Perl/iX | |
8460 | ||
8461 | 4, 6 | |
8462 | ||
8463 | =item Getting Started with Perl/iX | |
8464 | ||
8465 | =item MPE/iX Implementation Considerations | |
8466 | ||
8467 | =item Known Perl/iX Bugs Under Investigation | |
8468 | ||
8469 | =item Perl/iX To-Do List | |
8470 | ||
8471 | =item Perl/iX Change History | |
8472 | ||
8473 | =item AUTHOR | |
8474 | ||
8475 | =back | |
8476 | ||
8477 | =head2 perlnetware - Perl for NetWare | |
8478 | ||
8479 | =over 4 | |
8480 | ||
8481 | =item DESCRIPTION | |
8482 | ||
8483 | =item BUILD | |
8484 | ||
8485 | =over 4 | |
8486 | ||
8487 | =item Tools & SDK | |
8488 | ||
8489 | =item Setup | |
8490 | ||
8491 | SetNWBld.bat, Buildtype.bat | |
8492 | ||
8493 | =item Make | |
8494 | ||
8495 | =item Interpreter | |
8496 | ||
8497 | =item Extensions | |
8498 | ||
8499 | =back | |
8500 | ||
8501 | =item INSTALL | |
8502 | ||
8503 | =item BUILD NEW EXTENSIONS | |
8504 | ||
8505 | =item ACKNOWLEDGEMENTS | |
8506 | ||
8507 | =item AUTHORS | |
8508 | ||
8509 | =item DATE | |
8510 | ||
8511 | =back | |
8512 | ||
8513 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. | |
8514 | ||
8515 | =over 4 | |
8516 | ||
8517 | =item SYNOPSIS | |
8518 | ||
8519 | =back | |
8520 | ||
8521 | =over 4 | |
8522 | ||
8523 | =item DESCRIPTION | |
8524 | ||
8525 | =over 4 | |
8526 | ||
8527 | =item Target | |
8528 | ||
8529 | =item Other OSes | |
8530 | ||
8531 | =item Prerequisites | |
8532 | ||
8533 | EMX, RSX, HPFS, pdksh | |
8534 | ||
8535 | =item Starting Perl programs under OS/2 (and DOS and...) | |
8536 | ||
8537 | =item Starting OS/2 (and DOS) programs under Perl | |
8538 | ||
8539 | =back | |
8540 | ||
8541 | =item Frequently asked questions | |
8542 | ||
8543 | =over 4 | |
8544 | ||
8545 | =item "It does not work" | |
8546 | ||
8547 | =item I cannot run external programs | |
8548 | ||
8549 | =item I cannot embed perl into my program, or use F<perl.dll> from my | |
8550 | program. | |
8551 | ||
8552 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use | |
8553 | L<ExtUtils::Embed>? | |
8554 | ||
8555 | =item C<``> and pipe-C<open> do not work under DOS. | |
8556 | ||
8557 | =item Cannot start C<find.exe "pattern" file> | |
8558 | ||
8559 | =back | |
8560 | ||
8561 | =item INSTALLATION | |
8562 | ||
8563 | =over 4 | |
8564 | ||
8565 | =item Automatic binary installation | |
8566 | ||
8567 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> | |
8568 | ||
8569 | =item Manual binary installation | |
8570 | ||
8571 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable | |
8572 | (statically linked), Executables for Perl utilities, Main Perl library, | |
8573 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
8574 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
8575 | Perl manual in F<.INF> format, Pdksh | |
8576 | ||
8577 | =item B<Warning> | |
8578 | ||
8579 | =back | |
8580 | ||
8581 | =item Accessing documentation | |
8582 | ||
8583 | =over 4 | |
8584 | ||
8585 | =item OS/2 F<.INF> file | |
8586 | ||
8587 | =item Plain text | |
8588 | ||
8589 | =item Manpages | |
8590 | ||
8591 | =item HTML | |
8592 | ||
8593 | =item GNU C<info> files | |
8594 | ||
8595 | =item F<PDF> files | |
8596 | ||
8597 | =item C<LaTeX> docs | |
8598 | ||
8599 | =back | |
8600 | ||
8601 | =item BUILD | |
8602 | ||
8603 | =over 4 | |
8604 | ||
8605 | =item The short story | |
8606 | ||
8607 | =item Prerequisites | |
8608 | ||
8609 | =item Getting perl source | |
8610 | ||
8611 | =item Application of the patches | |
8612 | ||
8613 | =item Hand-editing | |
8614 | ||
8615 | =item Making | |
8616 | ||
8617 | =item Testing | |
8618 | ||
8619 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, | |
8620 | F<op/stat.t> | |
8621 | ||
8622 | =item Installing the built perl | |
8623 | ||
8624 | =item C<a.out>-style build | |
8625 | ||
8626 | =back | |
8627 | ||
8628 | =item Building a binary distribution | |
8629 | ||
8630 | =item Building custom F<.EXE> files | |
8631 | ||
8632 | =over 4 | |
8633 | ||
8634 | =item Making executables with a custom collection of statically loaded | |
8635 | extensions | |
8636 | ||
8637 | =item Making executables with a custom search-paths | |
8638 | ||
8639 | =back | |
8640 | ||
8641 | =item Build FAQ | |
8642 | ||
8643 | =over 4 | |
8644 | ||
8645 | =item Some C</> became C<\> in pdksh. | |
8646 | ||
8647 | =item C<'errno'> - unresolved external | |
8648 | ||
8649 | =item Problems with tr or sed | |
8650 | ||
8651 | =item Some problem (forget which ;-) | |
8652 | ||
8653 | =item Library ... not found | |
8654 | ||
8655 | =item Segfault in make | |
8656 | ||
8657 | =item op/sprintf test failure | |
8658 | ||
8659 | =back | |
8660 | ||
8661 | =item Specific (mis)features of OS/2 port | |
8662 | ||
8663 | =over 4 | |
8664 | ||
8665 | =item C<setpriority>, C<getpriority> | |
8666 | ||
8667 | =item C<system()> | |
8668 | ||
8669 | =item C<extproc> on the first line | |
8670 | ||
8671 | =item Additional modules: | |
8672 | ||
8673 | =item Prebuilt methods: | |
8674 | ||
8675 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, | |
8676 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
8677 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
8678 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
8679 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
8680 | C<Cwd::extLibpath_set( path [, type ] )>, | |
8681 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, | |
8682 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, | |
8683 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, | |
8684 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, | |
8685 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>, | |
8686 | C<OS2::DLLname([how [, \&xsub]])> | |
8687 | ||
8688 | =item Prebuilt variables: | |
8689 | ||
8690 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, | |
8691 | $OS2::nsyserror | |
8692 | ||
8693 | =item Misfeatures | |
8694 | ||
8695 | =item Modifications | |
8696 | ||
8697 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, | |
8698 | C<flock> | |
8699 | ||
8700 | =item Identifying DLLs | |
8701 | ||
8702 | =item Centralized management of resources | |
8703 | ||
8704 | C<HAB>, C<HMQ>, Treating errors reported by OS/2 API, | |
8705 | C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>, | |
8706 | C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>, | |
8707 | C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs | |
8708 | ||
8709 | =back | |
8710 | ||
8711 | =item Perl flavors | |
8712 | ||
8713 | =over 4 | |
8714 | ||
8715 | =item F<perl.exe> | |
8716 | ||
8717 | =item F<perl_.exe> | |
8718 | ||
8719 | =item F<perl__.exe> | |
8720 | ||
8721 | =item F<perl___.exe> | |
8722 | ||
8723 | =item Why strange names? | |
8724 | ||
8725 | =item Why dynamic linking? | |
8726 | ||
8727 | =item Why chimera build? | |
8728 | ||
8729 | =back | |
8730 | ||
8731 | =item ENVIRONMENT | |
8732 | ||
8733 | =over 4 | |
8734 | ||
8735 | =item C<PERLLIB_PREFIX> | |
8736 | ||
8737 | =item C<PERL_BADLANG> | |
8738 | ||
8739 | =item C<PERL_BADFREE> | |
8740 | ||
8741 | =item C<PERL_SH_DIR> | |
8742 | ||
8743 | =item C<USE_PERL_FLOCK> | |
8744 | ||
8745 | =item C<TMP> or C<TEMP> | |
8746 | ||
8747 | =back | |
8748 | ||
8749 | =item Evolution | |
8750 | ||
8751 | =over 4 | |
8752 | ||
8753 | =item Text-mode filehandles | |
8754 | ||
8755 | =item Priorities | |
8756 | ||
8757 | =item DLL name mangling: pre 5.6.2 | |
8758 | ||
8759 | =item DLL name mangling: 5.6.2 and beyond | |
8760 | ||
8761 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from | |
8762 | C<LIBPATH> | |
8763 | ||
8764 | =item DLL forwarder generation | |
8765 | ||
8766 | =item Threading | |
8767 | ||
8768 | =item Calls to external programs | |
8769 | ||
8770 | =item Memory allocation | |
8771 | ||
8772 | =item Threads | |
8773 | ||
8774 | C<COND_WAIT>, F<os2.c> | |
8775 | ||
8776 | =back | |
8777 | ||
8778 | =item BUGS | |
8779 | ||
8780 | =back | |
8781 | ||
8782 | =over 4 | |
8783 | ||
8784 | =item AUTHOR | |
8785 | ||
8786 | =item SEE ALSO | |
8787 | ||
8788 | =back | |
8789 | ||
8790 | =head2 perlos390, README.os390 - building and installing Perl for OS/390 | |
8791 | and z/OS | |
8792 | ||
8793 | =over 4 | |
8794 | ||
8795 | =item SYNOPSIS | |
8796 | ||
8797 | =item DESCRIPTION | |
8798 | ||
8799 | =over 4 | |
8800 | ||
8801 | =item Tools | |
8802 | ||
8803 | =item Unpacking Perl distribution on OS/390 | |
8804 | ||
8805 | =item Setup and utilities for Perl on OS/390 | |
8806 | ||
8807 | =item Configure Perl on OS/390 | |
8808 | ||
8809 | =item Build, Test, Install Perl on OS/390 | |
8810 | ||
8811 | =item Build Anomalies with Perl on OS/390 | |
8812 | ||
8813 | =item Testing Anomalies with Perl on OS/390 | |
8814 | ||
8815 | =item Installation Anomalies with Perl on OS/390 | |
8816 | ||
8817 | =item Usage Hints for Perl on OS/390 | |
8818 | ||
8819 | =item Floating Point Anomalies with Perl on OS/390 | |
8820 | ||
8821 | =item Modules and Extensions for Perl on OS/390 | |
8822 | ||
8823 | =back | |
8824 | ||
8825 | =item AUTHORS | |
8826 | ||
8827 | =item SEE ALSO | |
8828 | ||
8829 | =over 4 | |
8830 | ||
8831 | =item Mailing list for Perl on OS/390 | |
8832 | ||
8833 | =back | |
8834 | ||
8835 | =item HISTORY | |
8836 | ||
8837 | =back | |
8838 | ||
8839 | =head2 perlos400, README.os400 - Perl version 5 on OS/400 | |
8840 | ||
8841 | =over 4 | |
8842 | ||
8843 | =item DESCRIPTION | |
8844 | ||
8845 | =over 4 | |
8846 | ||
8847 | =item Compiling Perl for OS/400 PASE | |
8848 | ||
8849 | =item Installing Perl in OS/400 PASE | |
8850 | ||
8851 | =item Using Perl in OS/400 PASE | |
8852 | ||
8853 | =item Known Problems | |
8854 | ||
8855 | =item Perl on ILE | |
8856 | ||
8857 | =back | |
8858 | ||
8859 | =item AUTHORS | |
8860 | ||
8861 | =back | |
8862 | ||
8863 | =head2 perlplan9 - Plan 9-specific documentation for Perl | |
8864 | ||
8865 | =over 4 | |
8866 | ||
8867 | =item DESCRIPTION | |
8868 | ||
8869 | =over 4 | |
8870 | ||
8871 | =item Invoking Perl | |
8872 | ||
8873 | =item What's in Plan 9 Perl | |
8874 | ||
8875 | =item What's not in Plan 9 Perl | |
8876 | ||
8877 | =item Perl5 Functions not currently supported in Plan 9 Perl | |
8878 | ||
8879 | =item Signals in Plan 9 Perl | |
8880 | ||
8881 | =back | |
8882 | ||
8883 | =item COMPILING AND INSTALLING PERL ON PLAN 9 | |
8884 | ||
8885 | =over 4 | |
8886 | ||
8887 | =item Installing Perl Documentation on Plan 9 | |
8888 | ||
8889 | =back | |
8890 | ||
8891 | =item BUGS | |
8892 | ||
8893 | =item Revision date | |
8894 | ||
8895 | =item AUTHOR | |
8896 | ||
8897 | =back | |
8898 | ||
8899 | =head2 perlqnx, README.qnx - Perl version 5 on QNX | |
8900 | ||
8901 | =over 4 | |
8902 | ||
8903 | =item DESCRIPTION | |
8904 | ||
8905 | =over 4 | |
8906 | ||
8907 | =item Required Software for Compiling Perl on QNX4 | |
8908 | ||
8909 | /bin/sh, ar, nm, cpp, make | |
8910 | ||
8911 | =item Outstanding Issues with Perl on QNX4 | |
8912 | ||
8913 | =item QNX auxiliary files | |
8914 | ||
8915 | qnx/ar, qnx/cpp | |
8916 | ||
8917 | =item Outstanding issues with perl under QNX6 | |
8918 | ||
8919 | =back | |
8920 | ||
8921 | =item AUTHOR | |
8922 | ||
8923 | =back | |
8924 | ||
8925 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems | |
639f8edf | 8926 | |
f99d9048 | 8927 | =over 4 |
639f8edf | 8928 | |
f99d9048 | 8929 | =item DESCRIPTION |
639f8edf | 8930 | |
f99d9048 | 8931 | =over 4 |
639f8edf | 8932 | |
f99d9048 | 8933 | =item Solaris Version Numbers. |
639f8edf | 8934 | |
f99d9048 | 8935 | =back |
639f8edf | 8936 | |
f99d9048 | 8937 | =item RESOURCES |
639f8edf | 8938 | |
f99d9048 | 8939 | Solaris FAQ, Precompiled Binaries, Solaris Documentation |
639f8edf | 8940 | |
f99d9048 | 8941 | =item SETTING UP |
639f8edf | 8942 | |
f99d9048 | 8943 | =over 4 |
639f8edf | 8944 | |
f99d9048 | 8945 | =item File Extraction Problems on Solaris. |
639f8edf | 8946 | |
f99d9048 | 8947 | =item Compiler and Related Tools on Solaris. |
639f8edf | 8948 | |
f99d9048 | 8949 | =item Environment for Compiling perl on Solaris |
639f8edf | 8950 | |
d61fd583 | 8951 | =back |
639f8edf | 8952 | |
f99d9048 | 8953 | =item RUN CONFIGURE. |
639f8edf HS |
8954 | |
8955 | =over 4 | |
8956 | ||
f99d9048 | 8957 | =item 64-bit perl on Solaris. |
639f8edf | 8958 | |
f99d9048 RGS |
8959 | =item Threads in perl on Solaris. |
8960 | ||
8961 | =item Malloc Issues with perl on Solaris. | |
639f8edf HS |
8962 | |
8963 | =back | |
8964 | ||
f99d9048 RGS |
8965 | =item MAKE PROBLEMS. |
8966 | ||
8967 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: | |
8968 | relocation error:, dlopen: stub interception failed, #error "No | |
8969 | DATAMODEL_NATIVE specified", sh: ar: not found | |
8970 | ||
8971 | =item MAKE TEST | |
639f8edf HS |
8972 | |
8973 | =over 4 | |
8974 | ||
f99d9048 | 8975 | =item op/stat.t test 4 in Solaris |
d61fd583 | 8976 | |
f99d9048 | 8977 | =item nss_delete core dump from op/pwent or op/grent |
d61fd583 | 8978 | |
f99d9048 | 8979 | =back |
d61fd583 | 8980 | |
f99d9048 RGS |
8981 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. |
8982 | ||
8983 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. | |
8984 | ||
8985 | =over 4 | |
8986 | ||
8987 | =item Limits on Numbers of Open Files on Solaris. | |
639f8edf HS |
8988 | |
8989 | =back | |
8990 | ||
f99d9048 | 8991 | =item SOLARIS-SPECIFIC MODULES. |
639f8edf | 8992 | |
f99d9048 | 8993 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. |
639f8edf | 8994 | |
f99d9048 | 8995 | =over 4 |
639f8edf | 8996 | |
f99d9048 | 8997 | =item Proc::ProcessTable on Solaris |
639f8edf | 8998 | |
f99d9048 | 8999 | =item BSD::Resource on Solaris |
639f8edf | 9000 | |
f99d9048 | 9001 | =item Net::SSLeay on Solaris |
639f8edf | 9002 | |
f99d9048 | 9003 | =back |
639f8edf | 9004 | |
f99d9048 | 9005 | =item SunOS 4.x |
639f8edf | 9006 | |
f99d9048 | 9007 | =item AUTHOR |
639f8edf | 9008 | |
f99d9048 | 9009 | =item LAST MODIFIED |
639f8edf HS |
9010 | |
9011 | =back | |
9012 | ||
f99d9048 RGS |
9013 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as |
9014 | Digital UNIX formerly known as DEC OSF/1) systems | |
639f8edf HS |
9015 | |
9016 | =over 4 | |
9017 | ||
9018 | =item DESCRIPTION | |
9019 | ||
d61fd583 | 9020 | =over 4 |
639f8edf | 9021 | |
f99d9048 | 9022 | =item Compiling Perl 5 on Tru64 |
639f8edf | 9023 | |
f99d9048 | 9024 | =item Using Large Files with Perl on Tru64 |
639f8edf | 9025 | |
f99d9048 | 9026 | =item Threaded Perl on Tru64 |
639f8edf | 9027 | |
f99d9048 | 9028 | =item Long Doubles on Tru64 |
639f8edf | 9029 | |
f99d9048 | 9030 | =item DB_File tests failing on Tru64 |
639f8edf | 9031 | |
f99d9048 | 9032 | =item 64-bit Perl on Tru64 |
639f8edf | 9033 | |
f99d9048 | 9034 | =item Warnings about floating-point overflow when compiling Perl on Tru64 |
639f8edf | 9035 | |
f99d9048 | 9036 | =back |
639f8edf | 9037 | |
f99d9048 | 9038 | =item Testing Perl on Tru64 |
639f8edf | 9039 | |
f99d9048 | 9040 | =item ext/ODBM_File/odbm Test Failing With Static Builds |
639f8edf | 9041 | |
f99d9048 | 9042 | =item Perl Fails Because Of Unresolved Symbol sockatmark |
639f8edf | 9043 | |
f99d9048 | 9044 | =item AUTHOR |
639f8edf | 9045 | |
f99d9048 | 9046 | =back |
639f8edf | 9047 | |
f99d9048 | 9048 | =head2 perluts - Perl under UTS |
639f8edf | 9049 | |
f99d9048 | 9050 | =over 4 |
639f8edf | 9051 | |
f99d9048 | 9052 | =item SYNOPSIS |
639f8edf | 9053 | |
f99d9048 | 9054 | =item DESCRIPTION |
639f8edf | 9055 | |
f99d9048 | 9056 | =item BUILDING PERL ON UTS |
639f8edf | 9057 | |
f99d9048 | 9058 | =item Installing the built perl on UTS |
639f8edf | 9059 | |
f99d9048 | 9060 | =item AUTHOR |
639f8edf | 9061 | |
f99d9048 | 9062 | =back |
639f8edf | 9063 | |
f99d9048 | 9064 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. |
639f8edf | 9065 | |
f99d9048 | 9066 | =over 4 |
639f8edf | 9067 | |
f99d9048 | 9068 | =item SYNOPSIS |
639f8edf | 9069 | |
f99d9048 | 9070 | =item DESCRIPTION |
639f8edf | 9071 | |
f99d9048 | 9072 | =over 4 |
639f8edf | 9073 | |
f99d9048 | 9074 | =item Unpacking Perl Distribution on VM/ESA |
639f8edf | 9075 | |
f99d9048 | 9076 | =item Setup Perl and utilities on VM/ESA |
639f8edf | 9077 | |
f99d9048 | 9078 | =item Configure Perl on VM/ESA |
639f8edf | 9079 | |
f99d9048 | 9080 | =item Testing Anomalies of Perl on VM/ESA |
639f8edf | 9081 | |
f99d9048 | 9082 | =item Usage Hints for Perl on VM/ESA |
639f8edf | 9083 | |
f99d9048 | 9084 | =back |
639f8edf | 9085 | |
f99d9048 | 9086 | =item AUTHORS |
639f8edf | 9087 | |
f99d9048 | 9088 | =item SEE ALSO |
639f8edf | 9089 | |
f99d9048 | 9090 | =over 4 |
d61fd583 | 9091 | |
f99d9048 | 9092 | =item Mailing list for Perl on VM/ESA |
639f8edf HS |
9093 | |
9094 | =back | |
9095 | ||
f99d9048 RGS |
9096 | =back |
9097 | ||
9098 | =head2 perlvms - VMS-specific documentation for Perl | |
639f8edf HS |
9099 | |
9100 | =over 4 | |
9101 | ||
f99d9048 | 9102 | =item DESCRIPTION |
639f8edf | 9103 | |
f99d9048 | 9104 | =item Installation |
639f8edf | 9105 | |
f99d9048 | 9106 | =item Organization of Perl Images |
639f8edf | 9107 | |
f99d9048 | 9108 | =over 4 |
639f8edf | 9109 | |
f99d9048 | 9110 | =item Core Images |
639f8edf | 9111 | |
f99d9048 | 9112 | =item Perl Extensions |
639f8edf | 9113 | |
f99d9048 | 9114 | =item Installing static extensions |
639f8edf | 9115 | |
f99d9048 RGS |
9116 | =item Installing dynamic extensions |
9117 | ||
9118 | =back | |
9119 | ||
9120 | =item File specifications | |
639f8edf HS |
9121 | |
9122 | =over 4 | |
9123 | ||
f99d9048 | 9124 | =item Syntax |
639f8edf | 9125 | |
f99d9048 | 9126 | =item Wildcard expansion |
639f8edf | 9127 | |
f99d9048 | 9128 | =item Pipes |
639f8edf | 9129 | |
f99d9048 | 9130 | =back |
639f8edf | 9131 | |
f99d9048 | 9132 | =item PERL5LIB and PERLLIB |
639f8edf | 9133 | |
f99d9048 | 9134 | =item Command line |
639f8edf | 9135 | |
f99d9048 | 9136 | =over 4 |
639f8edf | 9137 | |
f99d9048 | 9138 | =item I/O redirection and backgrounding |
639f8edf | 9139 | |
f99d9048 | 9140 | =item Command line switches |
639f8edf | 9141 | |
f99d9048 | 9142 | -i, -S, -u |
639f8edf HS |
9143 | |
9144 | =back | |
9145 | ||
f99d9048 RGS |
9146 | =item Perl functions |
9147 | ||
9148 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
9149 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
9150 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
9151 | LIST, waitpid PID,FLAGS | |
9152 | ||
9153 | =item Perl variables | |
9154 | ||
9155 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| | |
9156 | ||
9157 | =item Standard modules with VMS-specific differences | |
639f8edf HS |
9158 | |
9159 | =over 4 | |
9160 | ||
f99d9048 | 9161 | =item SDBM_File |
639f8edf | 9162 | |
f99d9048 | 9163 | =back |
639f8edf | 9164 | |
f99d9048 | 9165 | =item Revision date |
639f8edf | 9166 | |
f99d9048 | 9167 | =item AUTHOR |
639f8edf HS |
9168 | |
9169 | =back | |
9170 | ||
f99d9048 | 9171 | =head2 perlvos, README.vos - Perl for Stratus VOS |
639f8edf | 9172 | |
f99d9048 | 9173 | =over 4 |
639f8edf | 9174 | |
f99d9048 | 9175 | =item SYNOPSIS |
639f8edf | 9176 | |
f99d9048 | 9177 | =item BUILDING PERL FOR VOS |
639f8edf | 9178 | |
f99d9048 | 9179 | =item INSTALLING PERL IN VOS |
639f8edf | 9180 | |
f99d9048 | 9181 | =item USING PERL IN VOS |
639f8edf | 9182 | |
f99d9048 | 9183 | =over 4 |
639f8edf | 9184 | |
f99d9048 | 9185 | =item Restrictions of Perl on VOS |
639f8edf | 9186 | |
f99d9048 | 9187 | =item Handling of underflow and overflow |
639f8edf HS |
9188 | |
9189 | =back | |
9190 | ||
f99d9048 RGS |
9191 | =item TEST STATUS |
9192 | ||
9193 | =item SUPPORT STATUS | |
9194 | ||
9195 | =item AUTHOR | |
9196 | ||
9197 | =item LAST UPDATE | |
9198 | ||
9199 | =back | |
9200 | ||
9201 | =head2 perlwin32 - Perl under Windows | |
639f8edf HS |
9202 | |
9203 | =over 4 | |
9204 | ||
9205 | =item SYNOPSIS | |
9206 | ||
9207 | =item DESCRIPTION | |
9208 | ||
d61fd583 | 9209 | =over 4 |
639f8edf | 9210 | |
f99d9048 | 9211 | =item Setting Up Perl on Win32 |
639f8edf | 9212 | |
e4bb216d NC |
9213 | Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual |
9214 | C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3 | |
9215 | with gcc, MinGW release 1 with gcc | |
639f8edf | 9216 | |
f99d9048 | 9217 | =item Building |
639f8edf | 9218 | |
f99d9048 | 9219 | =item Testing Perl on Win32 |
639f8edf | 9220 | |
f99d9048 | 9221 | =item Installation of Perl on Win32 |
639f8edf | 9222 | |
f99d9048 | 9223 | =item Usage Hints for Perl on Win32 |
639f8edf | 9224 | |
f99d9048 RGS |
9225 | Environment Variables, File Globbing, Using perl from the command line, |
9226 | Building Extensions, Command-line Wildcard Expansion, Win32 Specific | |
9227 | Extensions, Notes on 64-bit Windows | |
639f8edf | 9228 | |
f99d9048 | 9229 | =item Running Perl Scripts |
1400179b | 9230 | |
e4bb216d | 9231 | =item Miscellaneous Things |
639f8edf | 9232 | |
d61fd583 | 9233 | =back |
639f8edf | 9234 | |
f99d9048 | 9235 | =item BUGS AND CAVEATS |
639f8edf | 9236 | |
f99d9048 | 9237 | =item ACKNOWLEDGEMENTS |
d61fd583 | 9238 | |
f99d9048 RGS |
9239 | =item AUTHORS |
9240 | ||
9241 | Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy | |
9242 | E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons | |
9243 | E<lt>nick@ing-simmons.netE<gt> | |
9244 | ||
9245 | =item SEE ALSO | |
9246 | ||
9247 | =item HISTORY | |
639f8edf HS |
9248 | |
9249 | =back | |
9250 | ||
9251 | =head1 PRAGMA DOCUMENTATION | |
9252 | ||
9253 | =head2 attrs - set/get attributes of a subroutine (deprecated) | |
9254 | ||
9255 | =over 4 | |
9256 | ||
9257 | =item SYNOPSIS | |
9258 | ||
9259 | =item DESCRIPTION | |
9260 | ||
9261 | method, locked | |
9262 | ||
9263 | =back | |
9264 | ||
9265 | =head2 re - Perl pragma to alter regular expression behaviour | |
9266 | ||
9267 | =over 4 | |
9268 | ||
9269 | =item SYNOPSIS | |
9270 | ||
9271 | =item DESCRIPTION | |
9272 | ||
9273 | =back | |
9274 | ||
9275 | =head2 threadshared::shared, threads::shared - Perl extension for sharing | |
9276 | data structures between threads | |
9277 | ||
9278 | =over 4 | |
9279 | ||
9280 | =item SYNOPSIS | |
9281 | ||
9282 | =item DESCRIPTION | |
9283 | ||
9284 | =item EXPORT | |
9285 | ||
9286 | =item FUNCTIONS | |
9287 | ||
2e038148 NC |
9288 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, |
9289 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, | |
9290 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE | |
639f8edf HS |
9291 | |
9292 | =item NOTES | |
9293 | ||
9294 | =item BUGS | |
9295 | ||
9296 | =item AUTHOR | |
9297 | ||
9298 | =item SEE ALSO | |
9299 | ||
9300 | =back | |
9301 | ||
9302 | =head2 threads - Perl extension allowing use of interpreter based threads | |
9303 | from perl | |
9304 | ||
9305 | =over 4 | |
9306 | ||
9307 | =item SYNOPSIS | |
9308 | ||
9309 | =item DESCRIPTION | |
9310 | ||
9311 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, | |
9312 | threads->self, $thread->tid, threads->object( tid ), threads->yield();, | |
9313 | threads->list();, async BLOCK; | |
9314 | ||
9315 | =item WARNINGS | |
9316 | ||
9317 | A thread exited while %d other threads were still running | |
9318 | ||
9319 | =item TODO | |
9320 | ||
9321 | =item BUGS | |
9322 | ||
9323 | Parent-Child threads, Returning objects, Creating threads inside BEGIN | |
1400179b | 9324 | blocks, PERL_OLD_SIGNALS are not threadsafe, will not be |
639f8edf HS |
9325 | |
9326 | =item AUTHOR and COPYRIGHT | |
9327 | ||
9328 | =item SEE ALSO | |
9329 | ||
9330 | =back | |
9331 | ||
9332 | =head2 assertions - select assertions in blocks of code | |
9333 | ||
9334 | =over 4 | |
9335 | ||
9336 | =item SYNOPSIS | |
9337 | ||
9338 | =item DESCRIPTION | |
9339 | ||
9340 | =item SEE ALSO | |
9341 | ||
9342 | =item AUTHOR | |
9343 | ||
9344 | =item COPYRIGHT AND LICENSE | |
9345 | ||
9346 | =back | |
9347 | ||
9348 | =head2 assertions::activate - activate assertions | |
9349 | ||
9350 | =over 4 | |
9351 | ||
9352 | =item SYNOPSIS | |
9353 | ||
9354 | =item DESCRIPTION | |
9355 | ||
9356 | =item SEE ALSO | |
9357 | ||
9358 | =item AUTHOR | |
9359 | ||
9360 | =item COPYRIGHT AND LICENSE | |
9361 | ||
9362 | =back | |
9363 | ||
9364 | =head2 attributes - get/set subroutine or variable attributes | |
9365 | ||
9366 | =over 4 | |
9367 | ||
9368 | =item SYNOPSIS | |
9369 | ||
9370 | =item DESCRIPTION | |
9371 | ||
9372 | =over 4 | |
9373 | ||
9374 | =item Built-in Attributes | |
9375 | ||
9376 | locked, method, lvalue | |
9377 | ||
9378 | =item Available Subroutines | |
9379 | ||
9380 | get, reftype | |
9381 | ||
9382 | =item Package-specific Attribute Handling | |
9383 | ||
9384 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
9385 | ||
9386 | =item Syntax of Attribute Lists | |
9387 | ||
9388 | =back | |
9389 | ||
9390 | =item EXPORTS | |
9391 | ||
9392 | =over 4 | |
9393 | ||
9394 | =item Default exports | |
9395 | ||
9396 | =item Available exports | |
9397 | ||
9398 | =item Export tags defined | |
9399 | ||
9400 | =back | |
9401 | ||
9402 | =item EXAMPLES | |
9403 | ||
9404 | =item SEE ALSO | |
9405 | ||
9406 | =back | |
9407 | ||
9408 | =head2 autouse - postpone load of modules until a function is used | |
9409 | ||
9410 | =over 4 | |
9411 | ||
9412 | =item SYNOPSIS | |
9413 | ||
9414 | =item DESCRIPTION | |
9415 | ||
9416 | =item WARNING | |
9417 | ||
9418 | =item AUTHOR | |
9419 | ||
9420 | =item SEE ALSO | |
9421 | ||
9422 | =back | |
9423 | ||
2e038148 | 9424 | =head2 base - Establish IS-A relationship with base classes at compile time |
639f8edf HS |
9425 | |
9426 | =over 4 | |
9427 | ||
9428 | =item SYNOPSIS | |
9429 | ||
9430 | =item DESCRIPTION | |
9431 | ||
07e9b5fe NC |
9432 | =item DIAGNOSTICS |
9433 | ||
9434 | Base class package "%s" is empty | |
9435 | ||
639f8edf HS |
9436 | =item HISTORY |
9437 | ||
9438 | =item CAVEATS | |
9439 | ||
9440 | =item SEE ALSO | |
9441 | ||
9442 | =back | |
9443 | ||
9444 | =head2 bigint - Transparent BigInteger support for Perl | |
9445 | ||
9446 | =over 4 | |
9447 | ||
9448 | =item SYNOPSIS | |
9449 | ||
9450 | =item DESCRIPTION | |
9451 | ||
9452 | =over 4 | |
9453 | ||
df344c0f | 9454 | =item Options |
639f8edf HS |
9455 | |
9456 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
9457 | ||
df344c0f | 9458 | =item Math Library |
639f8edf | 9459 | |
df344c0f | 9460 | =item Internal Format |
639f8edf | 9461 | |
df344c0f | 9462 | =item Sign |
639f8edf | 9463 | |
df344c0f | 9464 | =item Methods |
639f8edf | 9465 | |
df344c0f | 9466 | =item Caveat |
639f8edf HS |
9467 | |
9468 | =back | |
9469 | ||
9470 | =item MODULES USED | |
9471 | ||
9472 | =item EXAMPLES | |
9473 | ||
9474 | =item LICENSE | |
9475 | ||
9476 | =item SEE ALSO | |
9477 | ||
9478 | =item AUTHORS | |
9479 | ||
9480 | =back | |
9481 | ||
9482 | =head2 bignum - Transparent BigNumber support for Perl | |
9483 | ||
9484 | =over 4 | |
9485 | ||
9486 | =item SYNOPSIS | |
9487 | ||
9488 | =item DESCRIPTION | |
9489 | ||
9490 | =over 4 | |
9491 | ||
df344c0f | 9492 | =item Options |
639f8edf HS |
9493 | |
9494 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
9495 | ||
df344c0f | 9496 | =item Methods |
639f8edf | 9497 | |
df344c0f | 9498 | =item Caveat |
a45bd81d | 9499 | |
b6235c4f | 9500 | inf(), NaN(), upgrade() |
2a551100 | 9501 | |
fa1c7b03 JH |
9502 | =item MATH LIBRARY |
9503 | ||
9504 | =item INTERNAL FORMAT | |
9505 | ||
9506 | =item SIGN | |
9507 | ||
fa1c7b03 JH |
9508 | =back |
9509 | ||
9510 | =item MODULES USED | |
9511 | ||
9512 | =item EXAMPLES | |
9513 | ||
9514 | =item LICENSE | |
9515 | ||
9516 | =item SEE ALSO | |
9517 | ||
9518 | =item AUTHORS | |
9519 | ||
9520 | =back | |
9521 | ||
82eec310 | 9522 | =head2 bigrat - Transparent BigNumber/BigRational support for Perl |
fa1c7b03 JH |
9523 | |
9524 | =over 4 | |
9525 | ||
9526 | =item SYNOPSIS | |
9527 | ||
9528 | =item DESCRIPTION | |
9529 | ||
9530 | =over 4 | |
9531 | ||
df344c0f | 9532 | =item Modules Used |
fa1c7b03 | 9533 | |
df344c0f | 9534 | =item Math Library |
fa1c7b03 | 9535 | |
df344c0f | 9536 | =item Sign |
fa1c7b03 | 9537 | |
df344c0f | 9538 | =item Methods |
fa1c7b03 | 9539 | |
df344c0f NC |
9540 | =item Cavaet |
9541 | ||
9542 | =item Options | |
9543 | ||
9544 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
0d53b15f | 9545 | |
fa1c7b03 JH |
9546 | =back |
9547 | ||
9548 | =item EXAMPLES | |
9549 | ||
9550 | perl -Mbigrat -le 'print sqrt(33)' | |
9551 | perl -Mbigrat -le 'print 2*255' | |
9552 | perl -Mbigrat -le 'print 4.5+2*255' | |
9553 | perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' | |
9554 | perl -Mbigrat -le 'print 12->is_odd()'; | |
9555 | ||
9556 | =item LICENSE | |
14218588 | 9557 | |
fb9cefb4 | 9558 | =item SEE ALSO |
d516a115 | 9559 | |
fa1c7b03 JH |
9560 | =item AUTHORS |
9561 | ||
a45bd81d GS |
9562 | =back |
9563 | ||
8ebc5c01 | 9564 | =head2 blib - Use MakeMaker's uninstalled version of a package |
cb1a09d0 | 9565 | |
d420ca49 | 9566 | =over 4 |
a45bd81d | 9567 | |
8ebc5c01 | 9568 | =item SYNOPSIS |
cb1a09d0 | 9569 | |
8ebc5c01 | 9570 | =item DESCRIPTION |
cb1a09d0 | 9571 | |
8ebc5c01 | 9572 | =item BUGS |
cb1a09d0 | 9573 | |
8ebc5c01 | 9574 | =item AUTHOR |
cb1a09d0 | 9575 | |
a45bd81d GS |
9576 | =back |
9577 | ||
694468e3 GS |
9578 | =head2 bytes - Perl pragma to force byte semantics rather than character |
9579 | semantics | |
a45bd81d | 9580 | |
d420ca49 | 9581 | =over 4 |
a45bd81d GS |
9582 | |
9583 | =item SYNOPSIS | |
9584 | ||
9585 | =item DESCRIPTION | |
9586 | ||
1e54db1a JH |
9587 | =item LIMITATIONS |
9588 | ||
694468e3 | 9589 | =item SEE ALSO |
a10cf691 | 9590 | |
a45bd81d GS |
9591 | =back |
9592 | ||
c76ac1ee | 9593 | =head2 charnames - define character names for C<\N{named}> string literal |
e993db8c | 9594 | escapes |
c76ac1ee | 9595 | |
d420ca49 | 9596 | =over 4 |
a45bd81d | 9597 | |
c76ac1ee GS |
9598 | =item SYNOPSIS |
9599 | ||
9600 | =item DESCRIPTION | |
9601 | ||
9602 | =item CUSTOM TRANSLATORS | |
9603 | ||
2a551100 JH |
9604 | =item CUSTOM ALIASES |
9605 | ||
9606 | =over 4 | |
9607 | ||
9608 | =item Anonymous hashes | |
9609 | ||
9610 | =item Alias file | |
9611 | ||
9612 | =item Alias shortcut | |
9613 | ||
9614 | =back | |
9615 | ||
ba62762e JH |
9616 | =item charnames::viacode(code) |
9617 | ||
23be5fc4 | 9618 | =item charnames::vianame(name) |
34babc16 | 9619 | |
e993db8c JH |
9620 | =item ALIASES |
9621 | ||
80637b95 JH |
9622 | =item ILLEGAL CHARACTERS |
9623 | ||
c76ac1ee GS |
9624 | =item BUGS |
9625 | ||
a45bd81d GS |
9626 | =back |
9627 | ||
54310121 | 9628 | =head2 constant - Perl pragma to declare constants |
9629 | ||
d420ca49 | 9630 | =over 4 |
a45bd81d | 9631 | |
54310121 | 9632 | =item SYNOPSIS |
9633 | ||
9634 | =item DESCRIPTION | |
9635 | ||
9636 | =item NOTES | |
9637 | ||
890a53b9 JH |
9638 | =over 4 |
9639 | ||
9640 | =item List constants | |
9641 | ||
9642 | =item Defining multiple constants at once | |
9643 | ||
9644 | =item Magic constants | |
9645 | ||
9646 | =back | |
9647 | ||
9648 | =item TECHNICAL NOTES | |
54310121 | 9649 | |
9650 | =item BUGS | |
9651 | ||
9652 | =item AUTHOR | |
9653 | ||
9654 | =item COPYRIGHT | |
9655 | ||
a45bd81d GS |
9656 | =back |
9657 | ||
f262848d | 9658 | =head2 diagnostics, splain - produce verbose warning diagnostics |
cb1a09d0 | 9659 | |
d420ca49 | 9660 | =over 4 |
a45bd81d | 9661 | |
8ebc5c01 | 9662 | =item SYNOPSIS |
cb1a09d0 | 9663 | |
8ebc5c01 | 9664 | =item DESCRIPTION |
cb1a09d0 | 9665 | |
d420ca49 | 9666 | =over 4 |
cb1a09d0 | 9667 | |
8ebc5c01 | 9668 | =item The C<diagnostics> Pragma |
cb1a09d0 | 9669 | |
8ebc5c01 | 9670 | =item The I<splain> Program |
cb1a09d0 | 9671 | |
8ebc5c01 | 9672 | =back |
cb1a09d0 | 9673 | |
8ebc5c01 | 9674 | =item EXAMPLES |
cb1a09d0 | 9675 | |
8ebc5c01 | 9676 | =item INTERNALS |
cb1a09d0 | 9677 | |
8ebc5c01 | 9678 | =item BUGS |
cb1a09d0 | 9679 | |
8ebc5c01 | 9680 | =item AUTHOR |
cb1a09d0 | 9681 | |
a45bd81d GS |
9682 | =back |
9683 | ||
639f8edf HS |
9684 | =head2 encoding - allows you to write your script in non-ascii or non-utf8 |
9685 | ||
9686 | =over 4 | |
9687 | ||
9688 | =item SYNOPSIS | |
9689 | ||
9690 | =item ABSTRACT | |
9691 | ||
9692 | =over 4 | |
9693 | ||
9694 | =item Literal Conversions | |
9695 | ||
9696 | =item PerlIO layers for C<STD(IN|OUT)> | |
9697 | ||
f262848d RGS |
9698 | =item Implicit upgrading for byte strings |
9699 | ||
639f8edf HS |
9700 | =back |
9701 | ||
9702 | =item FEATURES THAT REQUIRE 5.8.1 | |
9703 | ||
9704 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle | |
9705 | ||
9706 | =item USAGE | |
9707 | ||
9708 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> | |
9709 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; | |
9710 | ||
9711 | =item The Filter Option | |
9712 | ||
9713 | =over 4 | |
9714 | ||
9715 | =item Filter-related changes at Encode version 1.87 | |
9716 | ||
9717 | =back | |
9718 | ||
9719 | =item CAVEATS | |
9720 | ||
9721 | =over 4 | |
9722 | ||
9723 | =item NOT SCOPED | |
9724 | ||
9725 | =item DO NOT MIX MULTIPLE ENCODINGS | |
9726 | ||
9727 | =item tr/// with ranges | |
9728 | ||
9729 | Legend of characters above | |
9730 | ||
9731 | =back | |
9732 | ||
9733 | =item EXAMPLE - Greekperl | |
9734 | ||
9735 | =item KNOWN PROBLEMS | |
9736 | ||
9737 | literals in regex that are longer than 127 bytes, EBCDIC, format | |
9738 | ||
e4bb216d NC |
9739 | =over 4 |
9740 | ||
9741 | =item The Logic of :locale | |
9742 | ||
9743 | =back | |
9744 | ||
639f8edf HS |
9745 | =item HISTORY |
9746 | ||
9747 | =item SEE ALSO | |
9748 | ||
9749 | =back | |
9750 | ||
d516a115 JH |
9751 | =head2 fields - compile-time class fields |
9752 | ||
d420ca49 | 9753 | =over 4 |
a45bd81d | 9754 | |
d516a115 JH |
9755 | =item SYNOPSIS |
9756 | ||
9757 | =item DESCRIPTION | |
9758 | ||
694468e3 GS |
9759 | new, phash |
9760 | ||
fb9cefb4 GS |
9761 | =item SEE ALSO |
9762 | ||
a45bd81d GS |
9763 | =back |
9764 | ||
14218588 GS |
9765 | =head2 filetest - Perl pragma to control the filetest permission operators |
9766 | ||
d420ca49 | 9767 | =over 4 |
a45bd81d | 9768 | |
14218588 GS |
9769 | =item SYNOPSIS |
9770 | ||
14218588 GS |
9771 | =item DESCRIPTION |
9772 | ||
d420ca49 | 9773 | =over 4 |
14218588 GS |
9774 | |
9775 | =item subpragma access | |
9776 | ||
9777 | =back | |
9778 | ||
a45bd81d GS |
9779 | =back |
9780 | ||
12b7c5c7 JH |
9781 | =head2 if - C<use> a Perl module if a condition holds |
9782 | ||
9783 | =over 4 | |
9784 | ||
9785 | =item SYNOPSIS | |
9786 | ||
9787 | =item DESCRIPTION | |
9788 | ||
9789 | =item BUGS | |
9790 | ||
9791 | =item AUTHOR | |
9792 | ||
9793 | =back | |
9794 | ||
4d4e713d JH |
9795 | =head2 integer - Perl pragma to use integer arithmetic instead of floating |
9796 | point | |
cb1a09d0 | 9797 | |
d420ca49 | 9798 | =over 4 |
a45bd81d | 9799 | |
8ebc5c01 | 9800 | =item SYNOPSIS |
cb1a09d0 | 9801 | |
8ebc5c01 | 9802 | =item DESCRIPTION |
cb1a09d0 | 9803 | |
a45bd81d GS |
9804 | =back |
9805 | ||
8ebc5c01 | 9806 | =head2 less - perl pragma to request less of something from the compiler |
cb1a09d0 | 9807 | |
d420ca49 | 9808 | =over 4 |
a45bd81d | 9809 | |
8ebc5c01 | 9810 | =item SYNOPSIS |
cb1a09d0 | 9811 | |
8ebc5c01 | 9812 | =item DESCRIPTION |
cb1a09d0 | 9813 | |
a45bd81d GS |
9814 | =back |
9815 | ||
639f8edf HS |
9816 | =head2 lib - manipulate @INC at compile time |
9817 | ||
9818 | =over 4 | |
9819 | ||
9820 | =item SYNOPSIS | |
9821 | ||
9822 | =item DESCRIPTION | |
9823 | ||
9824 | =over 4 | |
9825 | ||
9826 | =item Adding directories to @INC | |
9827 | ||
9828 | =item Deleting directories from @INC | |
9829 | ||
9830 | =item Restoring original @INC | |
9831 | ||
9832 | =back | |
9833 | ||
9834 | =item CAVEATS | |
9835 | ||
9836 | =item NOTES | |
9837 | ||
9838 | =item SEE ALSO | |
9839 | ||
9840 | =item AUTHOR | |
9841 | ||
9842 | =back | |
9843 | ||
8ebc5c01 | 9844 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
9845 | operations | |
cb1a09d0 | 9846 | |
d420ca49 | 9847 | =over 4 |
a45bd81d | 9848 | |
8ebc5c01 | 9849 | =item SYNOPSIS |
cb1a09d0 AD |
9850 | |
9851 | =item DESCRIPTION | |
9852 | ||
a45bd81d GS |
9853 | =back |
9854 | ||
cb9c8b59 | 9855 | =head2 open - perl pragma to set default PerlIO layers for input and output |
b38f6a39 | 9856 | |
d420ca49 | 9857 | =over 4 |
b38f6a39 GS |
9858 | |
9859 | =item SYNOPSIS | |
9860 | ||
9861 | =item DESCRIPTION | |
9862 | ||
0d0e97a6 JH |
9863 | =item NONPERLIO FUNCTIONALITY |
9864 | ||
9865 | =item IMPLEMENTATION DETAILS | |
b38f6a39 GS |
9866 | |
9867 | =item SEE ALSO | |
9868 | ||
9869 | =back | |
9870 | ||
639f8edf HS |
9871 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
9872 | ||
9873 | =over 4 | |
9874 | ||
9875 | =item SYNOPSIS | |
9876 | ||
9877 | =item DESCRIPTION | |
9878 | ||
9879 | =item SEE ALSO | |
9880 | ||
9881 | =back | |
9882 | ||
8ebc5c01 | 9883 | =head2 overload - Package for overloading perl operations |
cb1a09d0 | 9884 | |
d420ca49 | 9885 | =over 4 |
a45bd81d | 9886 | |
8ebc5c01 | 9887 | =item SYNOPSIS |
cb1a09d0 | 9888 | |
8ebc5c01 | 9889 | =item DESCRIPTION |
cb1a09d0 | 9890 | |
d420ca49 | 9891 | =over 4 |
cb1a09d0 | 9892 | |
8ebc5c01 | 9893 | =item Declaration of overloaded functions |
cb1a09d0 | 9894 | |
8ebc5c01 | 9895 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 9896 | |
8ebc5c01 | 9897 | FALSE, TRUE, C<undef> |
cb1a09d0 | 9898 | |
8ebc5c01 | 9899 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 9900 | |
14218588 GS |
9901 | =item Calling Conventions for Mutators |
9902 | ||
9903 | C<++> and C<-->, C<x=> and other assignment versions | |
9904 | ||
8ebc5c01 | 9905 | =item Overloadable Operations |
cb1a09d0 | 9906 | |
8ebc5c01 | 9907 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
9908 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
14218588 | 9909 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
cb1a09d0 | 9910 | |
774d564b | 9911 | =item Inheritance and overloading |
9912 | ||
9913 | Strings as values of C<use overload> directive, Overloading of an operation | |
9914 | is inherited by derived classes | |
9915 | ||
8ebc5c01 | 9916 | =back |
cb1a09d0 | 9917 | |
8ebc5c01 | 9918 | =item SPECIAL SYMBOLS FOR C<use overload> |
cb1a09d0 | 9919 | |
d420ca49 | 9920 | =over 4 |
cb1a09d0 | 9921 | |
774d564b | 9922 | =item Last Resort |
cb1a09d0 | 9923 | |
91331b4f | 9924 | =item Fallback |
cb1a09d0 | 9925 | |
8ebc5c01 | 9926 | C<undef>, TRUE, defined, but FALSE |
cb1a09d0 | 9927 | |
8ebc5c01 | 9928 | =item Copy Constructor |
cb1a09d0 | 9929 | |
8ebc5c01 | 9930 | B<Example> |
cb1a09d0 | 9931 | |
8ebc5c01 | 9932 | =back |
cb1a09d0 | 9933 | |
8ebc5c01 | 9934 | =item MAGIC AUTOGENERATION |
cb1a09d0 | 9935 | |
8ebc5c01 | 9936 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
9937 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
14218588 GS |
9938 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
9939 | I<Copy operator> | |
cb1a09d0 | 9940 | |
14218588 | 9941 | =item Losing overloading |
cb1a09d0 | 9942 | |
8ebc5c01 | 9943 | =item Run-time Overloading |
cb1a09d0 | 9944 | |
8ebc5c01 | 9945 | =item Public functions |
cb1a09d0 | 9946 | |
8ebc5c01 | 9947 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 9948 | |
fb9cefb4 GS |
9949 | =item Overloading constants |
9950 | ||
9951 | integer, float, binary, q, qr | |
9952 | ||
8ebc5c01 | 9953 | =item IMPLEMENTATION |
cb1a09d0 | 9954 | |
14218588 GS |
9955 | =item Metaphor clash |
9956 | ||
9957 | =item Cookbook | |
9958 | ||
d420ca49 | 9959 | =over 4 |
14218588 GS |
9960 | |
9961 | =item Two-face scalars | |
9962 | ||
9963 | =item Two-face references | |
9964 | ||
9965 | =item Symbolic calculator | |
9966 | ||
9967 | =item I<Really> symbolic calculator | |
9968 | ||
4755096e | 9969 | =back |
497711e7 | 9970 | |
4755096e | 9971 | =item AUTHOR |
497711e7 | 9972 | |
4755096e | 9973 | =item DIAGNOSTICS |
497711e7 | 9974 | |
93d73c42 JH |
9975 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
9976 | type, `%s' is not a code reference | |
9977 | ||
4755096e | 9978 | =item BUGS |
497711e7 GS |
9979 | |
9980 | =back | |
9981 | ||
8ebc5c01 | 9982 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 9983 | |
d420ca49 | 9984 | =over 4 |
a45bd81d | 9985 | |
8ebc5c01 | 9986 | =item SYNOPSIS |
cb1a09d0 | 9987 | |
8ebc5c01 | 9988 | =item DESCRIPTION |
cb1a09d0 | 9989 | |
8ebc5c01 | 9990 | =item OPTIONS |
cb1a09d0 | 9991 | |
d420ca49 | 9992 | =over 4 |
cb1a09d0 | 9993 | |
8ebc5c01 | 9994 | =item SIGNAL HANDLERS |
cb1a09d0 | 9995 | |
8ebc5c01 | 9996 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
cb1a09d0 | 9997 | |
8ebc5c01 | 9998 | =item SIGNAL LISTS |
cb1a09d0 | 9999 | |
8ebc5c01 | 10000 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
cb1a09d0 | 10001 | |
8ebc5c01 | 10002 | =item OTHER |
cb1a09d0 | 10003 | |
8ebc5c01 | 10004 | B<untrapped>, B<any>, I<signal>, I<number> |
cb1a09d0 | 10005 | |
8ebc5c01 | 10006 | =back |
cb1a09d0 | 10007 | |
8ebc5c01 | 10008 | =item EXAMPLES |
cb1a09d0 | 10009 | |
a45bd81d GS |
10010 | =back |
10011 | ||
428dc699 JH |
10012 | =head2 sort - perl pragma to control sort() behaviour |
10013 | ||
10014 | =over 4 | |
10015 | ||
10016 | =item SYNOPSIS | |
10017 | ||
10018 | =item DESCRIPTION | |
10019 | ||
e993db8c JH |
10020 | =item CAVEATS |
10021 | ||
428dc699 JH |
10022 | =back |
10023 | ||
8ebc5c01 | 10024 | =head2 strict - Perl pragma to restrict unsafe constructs |
cb1a09d0 | 10025 | |
d420ca49 | 10026 | =over 4 |
a45bd81d | 10027 | |
8ebc5c01 | 10028 | =item SYNOPSIS |
cb1a09d0 | 10029 | |
8ebc5c01 | 10030 | =item DESCRIPTION |
cb1a09d0 | 10031 | |
8ebc5c01 | 10032 | C<strict refs>, C<strict vars>, C<strict subs> |
cb1a09d0 | 10033 | |
0d53b15f JH |
10034 | =item HISTORY |
10035 | ||
a45bd81d GS |
10036 | =back |
10037 | ||
8ebc5c01 | 10038 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 | 10039 | |
d420ca49 | 10040 | =over 4 |
a45bd81d | 10041 | |
cb1a09d0 AD |
10042 | =item SYNOPSIS |
10043 | ||
cb1a09d0 AD |
10044 | =item DESCRIPTION |
10045 | ||
a45bd81d GS |
10046 | =back |
10047 | ||
639f8edf HS |
10048 | =head2 threadshared, threads::shared - Perl extension for sharing data |
10049 | structures between threads | |
10050 | ||
10051 | =over 4 | |
10052 | ||
10053 | =item SYNOPSIS | |
10054 | ||
10055 | =item DESCRIPTION | |
10056 | ||
10057 | =item EXPORT | |
10058 | ||
10059 | =item FUNCTIONS | |
10060 | ||
2e038148 NC |
10061 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, |
10062 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, | |
10063 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE | |
639f8edf HS |
10064 | |
10065 | =item NOTES | |
10066 | ||
10067 | =item BUGS | |
10068 | ||
10069 | =item AUTHOR | |
10070 | ||
10071 | =item SEE ALSO | |
10072 | ||
10073 | =back | |
10074 | ||
bd28ded5 JH |
10075 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source |
10076 | code | |
14218588 | 10077 | |
d420ca49 | 10078 | =over 4 |
a45bd81d | 10079 | |
14218588 GS |
10080 | =item SYNOPSIS |
10081 | ||
10082 | =item DESCRIPTION | |
10083 | ||
4d4e713d JH |
10084 | =over 4 |
10085 | ||
10086 | =item Utility functions | |
10087 | ||
41630250 JH |
10088 | $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[, |
10089 | FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag = | |
0d53b15f | 10090 | utf8::is_utf8(STRING), $flag = utf8::valid(STRING) |
4d4e713d JH |
10091 | |
10092 | =back | |
10093 | ||
033348ab JH |
10094 | =item BUGS |
10095 | ||
694468e3 | 10096 | =item SEE ALSO |
14218588 | 10097 | |
a45bd81d GS |
10098 | =back |
10099 | ||
10100 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) | |
10101 | ||
d420ca49 | 10102 | =over 4 |
cb1a09d0 | 10103 | |
8ebc5c01 | 10104 | =item SYNOPSIS |
cb1a09d0 | 10105 | |
8ebc5c01 | 10106 | =item DESCRIPTION |
cb1a09d0 | 10107 | |
a45bd81d GS |
10108 | =back |
10109 | ||
2a551100 JH |
10110 | =head2 version - Perl extension for Version Objects |
10111 | ||
10112 | =over 4 | |
10113 | ||
10114 | =item SYNOPSIS | |
10115 | ||
10116 | =item DESCRIPTION | |
10117 | ||
10118 | =over 4 | |
10119 | ||
10120 | =item What IS a version | |
10121 | ||
d61fd583 RGS |
10122 | Numeric Versions, Quoted Versions |
10123 | ||
10124 | =item What about v-strings? | |
2a551100 JH |
10125 | |
10126 | =item Numeric Versions | |
10127 | ||
d61fd583 | 10128 | =item Quoted Versions |
2a551100 JH |
10129 | |
10130 | =item Object Methods | |
10131 | ||
5f15c94e NC |
10132 | New Operator, qv(), Normal Form, Numification, Stringification, Comparison |
10133 | operators, Logical Operators | |
2a551100 JH |
10134 | |
10135 | =item Quoting | |
10136 | ||
10137 | =item Types of Versions Objects | |
10138 | ||
d61fd583 | 10139 | Ordinary versions, Alpha versions |
2a551100 JH |
10140 | |
10141 | =item Replacement UNIVERSAL::VERSION | |
10142 | ||
10143 | =back | |
10144 | ||
10145 | =item EXPORT | |
10146 | ||
10147 | =item AUTHOR | |
10148 | ||
10149 | =item SEE ALSO | |
10150 | ||
10151 | =back | |
10152 | ||
ba62762e JH |
10153 | =head2 vmsish - Perl pragma to control VMS-specific language features |
10154 | ||
10155 | =over 4 | |
10156 | ||
10157 | =item SYNOPSIS | |
10158 | ||
10159 | =item DESCRIPTION | |
10160 | ||
10161 | C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> | |
10162 | ||
10163 | =back | |
10164 | ||
4438c4b7 | 10165 | =head2 warnings - Perl pragma to control optional warnings |
14218588 | 10166 | |
d420ca49 | 10167 | =over 4 |
a45bd81d | 10168 | |
14218588 GS |
10169 | =item SYNOPSIS |
10170 | ||
10171 | =item DESCRIPTION | |
10172 | ||
a9ef4385 JH |
10173 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
10174 | warnings::enabled($object), warnings::warn($message), | |
10175 | warnings::warn($category, $message), warnings::warn($object, $message), | |
10176 | warnings::warnif($message), warnings::warnif($category, $message), | |
10177 | warnings::warnif($object, $message) | |
694468e3 | 10178 | |
a45bd81d GS |
10179 | =back |
10180 | ||
4755096e GS |
10181 | =head2 warnings::register - warnings import function |
10182 | ||
890a53b9 JH |
10183 | =over 4 |
10184 | ||
10185 | =item SYNOPSIS | |
10186 | ||
10187 | =item DESCRIPTION | |
10188 | ||
10189 | =back | |
10190 | ||
8ebc5c01 | 10191 | =head1 MODULE DOCUMENTATION |
cb1a09d0 | 10192 | |
8ebc5c01 | 10193 | =head2 AnyDBM_File - provide framework for multiple DBMs |
cb1a09d0 | 10194 | |
d420ca49 | 10195 | =over 4 |
a45bd81d | 10196 | |
cb1a09d0 AD |
10197 | =item SYNOPSIS |
10198 | ||
cb1a09d0 AD |
10199 | =item DESCRIPTION |
10200 | ||
d420ca49 | 10201 | =over 4 |
cb1a09d0 | 10202 | |
8ebc5c01 | 10203 | =item DBM Comparisons |
cb1a09d0 | 10204 | |
8ebc5c01 | 10205 | [0], [1], [2], [3] |
cb1a09d0 | 10206 | |
8ebc5c01 | 10207 | =back |
cb1a09d0 | 10208 | |
8ebc5c01 | 10209 | =item SEE ALSO |
cb1a09d0 | 10210 | |
a45bd81d GS |
10211 | =back |
10212 | ||
0e9b9e0c JH |
10213 | =head2 Attribute::Handlers - Simpler definition of attribute handlers |
10214 | ||
10215 | =over 4 | |
10216 | ||
10217 | =item VERSION | |
10218 | ||
10219 | =item SYNOPSIS | |
10220 | ||
10221 | =item DESCRIPTION | |
10222 | ||
10223 | [0], [1], [2], [3], [4], [5] | |
10224 | ||
10225 | =over 4 | |
10226 | ||
10227 | =item Typed lexicals | |
10228 | ||
10229 | =item Type-specific attribute handlers | |
10230 | ||
10231 | =item Non-interpretive attribute handlers | |
10232 | ||
10233 | =item Phase-specific attribute handlers | |
10234 | ||
10235 | =item Attributes as C<tie> interfaces | |
10236 | ||
10237 | =back | |
10238 | ||
10239 | =item EXAMPLES | |
10240 | ||
10241 | =item DIAGNOSTICS | |
10242 | ||
10243 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s | |
10244 | attributes>, C<Declaration of %s attribute in package %s may clash with | |
10245 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, | |
fe9287c4 JH |
10246 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't |
10247 | be able to apply END handler> | |
0e9b9e0c JH |
10248 | |
10249 | =item AUTHOR | |
10250 | ||
10251 | =item BUGS | |
10252 | ||
10253 | =item COPYRIGHT | |
10254 | ||
10255 | =back | |
10256 | ||
4a6725af | 10257 | =head2 AutoLoader - load subroutines only on demand |
cb1a09d0 | 10258 | |
d420ca49 | 10259 | =over 4 |
a45bd81d | 10260 | |
8ebc5c01 | 10261 | =item SYNOPSIS |
cb1a09d0 | 10262 | |
8ebc5c01 | 10263 | =item DESCRIPTION |
cb1a09d0 | 10264 | |
d420ca49 | 10265 | =over 4 |
cb1a09d0 | 10266 | |
4a6725af NT |
10267 | =item Subroutine Stubs |
10268 | ||
10269 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
cb1a09d0 | 10270 | |
4a6725af | 10271 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
cb1a09d0 | 10272 | |
8ebc5c01 | 10273 | =item Package Lexicals |
cb1a09d0 | 10274 | |
7029d033 JH |
10275 | =item Not Using AutoLoader |
10276 | ||
4a6725af | 10277 | =item B<AutoLoader> vs. B<SelfLoader> |
cb1a09d0 | 10278 | |
8ebc5c01 | 10279 | =back |
cb1a09d0 | 10280 | |
4a6725af NT |
10281 | =item CAVEATS |
10282 | ||
10283 | =item SEE ALSO | |
cb1a09d0 | 10284 | |
a45bd81d GS |
10285 | =back |
10286 | ||
8ebc5c01 | 10287 | =head2 AutoSplit - split a package for autoloading |
cb1a09d0 | 10288 | |
d420ca49 | 10289 | =over 4 |
a45bd81d | 10290 | |
8ebc5c01 | 10291 | =item SYNOPSIS |
cb1a09d0 | 10292 | |
8ebc5c01 | 10293 | =item DESCRIPTION |
cb1a09d0 | 10294 | |
193fb0af GS |
10295 | $keep, $check, $modtime |
10296 | ||
d420ca49 | 10297 | =over 4 |
193fb0af GS |
10298 | |
10299 | =item Multiple packages | |
10300 | ||
10301 | =back | |
cb1a09d0 | 10302 | |
8ebc5c01 | 10303 | =item DIAGNOSTICS |
cb1a09d0 | 10304 | |
a45bd81d GS |
10305 | =back |
10306 | ||
fb9cefb4 | 10307 | =head2 B - The Perl Compiler |
193fb0af | 10308 | |
d420ca49 | 10309 | =over 4 |
a45bd81d | 10310 | |
193fb0af GS |
10311 | =item SYNOPSIS |
10312 | ||
10313 | =item DESCRIPTION | |
10314 | ||
2a551100 JH |
10315 | =item OVERVIEW |
10316 | ||
10317 | =item Utility Functions | |
10318 | ||
10319 | =over 4 | |
10320 | ||
10321 | =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV> | |
10322 | objects | |
10323 | ||
0d53b15f JH |
10324 | sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av, |
10325 | check_av, begin_av, end_av, comppadlist, regex_padav, main_cv | |
2a551100 JH |
10326 | |
10327 | =item Functions for Examining the Symbol Table | |
10328 | ||
10329 | walksymtable(SYMREF, METHOD, RECURSE, PREFIX) | |
10330 | ||
10331 | =item Functions Returning C<B::OP> objects or for walking op trees | |
10332 | ||
10333 | main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG) | |
10334 | ||
10335 | =item Miscellaneous Utility Functions | |
10336 | ||
10337 | ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), | |
10338 | perlstring(STR), class(OBJ), threadsv_names | |
10339 | ||
10340 | =back | |
10341 | ||
fb9cefb4 | 10342 | =item OVERVIEW OF CLASSES |
193fb0af | 10343 | |
d420ca49 | 10344 | =over 4 |
193fb0af | 10345 | |
fb9cefb4 | 10346 | =item SV-RELATED CLASSES |
193fb0af | 10347 | |
2a551100 | 10348 | =item B::SV Methods |
193fb0af | 10349 | |
0d53b15f | 10350 | REFCNT, FLAGS, object_2svref |
193fb0af | 10351 | |
2a551100 | 10352 | =item B::IV Methods |
193fb0af | 10353 | |
e42c74e1 | 10354 | IV, IVX, UVX, int_value, needs64bits, packiv |
193fb0af | 10355 | |
2a551100 | 10356 | =item B::NV Methods |
193fb0af | 10357 | |
fb9cefb4 | 10358 | NV, NVX |
193fb0af | 10359 | |
2a551100 | 10360 | =item B::RV Methods |
193fb0af | 10361 | |
fb9cefb4 | 10362 | RV |
193fb0af | 10363 | |
2a551100 | 10364 | =item B::PV Methods |
193fb0af | 10365 | |
f502af34 | 10366 | PV, RV, PVX |
193fb0af | 10367 | |
2a551100 | 10368 | =item B::PVMG Methods |
cb1a09d0 | 10369 | |
fb9cefb4 | 10370 | MAGIC, SvSTASH |
cb1a09d0 | 10371 | |
2a551100 | 10372 | =item B::MAGIC Methods |
cb1a09d0 | 10373 | |
f502af34 | 10374 | MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX |
cb1a09d0 | 10375 | |
2a551100 | 10376 | =item B::PVLV Methods |
cb1a09d0 | 10377 | |
fb9cefb4 | 10378 | TARGOFF, TARGLEN, TYPE, TARG |
cb1a09d0 | 10379 | |
2a551100 | 10380 | =item B::BM Methods |
cb1a09d0 | 10381 | |
fb9cefb4 | 10382 | USEFUL, PREVIOUS, RARE, TABLE |
cb1a09d0 | 10383 | |
2a551100 | 10384 | =item B::GV Methods |
cb1a09d0 | 10385 | |
e42c74e1 JH |
10386 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, |
10387 | LINE, FILE, FILEGV, GvREFCNT, FLAGS | |
54310121 | 10388 | |
2a551100 | 10389 | =item B::IO Methods |
cb1a09d0 | 10390 | |
fb9cefb4 | 10391 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
f502af34 | 10392 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD |
cb1a09d0 | 10393 | |
2a551100 | 10394 | =item B::AV Methods |
cb1a09d0 | 10395 | |
0d53b15f | 10396 | FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS |
cb1a09d0 | 10397 | |
2a551100 | 10398 | =item B::CV Methods |
cb1a09d0 | 10399 | |
2a551100 JH |
10400 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB, |
10401 | XSUBANY, CvFLAGS, const_sv | |
cb1a09d0 | 10402 | |
2a551100 | 10403 | =item B::HV Methods |
f86702cc | 10404 | |
fb9cefb4 | 10405 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
f86702cc | 10406 | |
fb9cefb4 | 10407 | =item OP-RELATED CLASSES |
f86702cc | 10408 | |
2a551100 | 10409 | =item B::OP Methods |
f86702cc | 10410 | |
e4bb216d NC |
10411 | next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private, |
10412 | spare | |
f86702cc | 10413 | |
fb9cefb4 | 10414 | =item B::UNOP METHOD |
54310121 | 10415 | |
fb9cefb4 | 10416 | first |
dc848c6f | 10417 | |
fb9cefb4 | 10418 | =item B::BINOP METHOD |
54310121 | 10419 | |
fb9cefb4 | 10420 | last |
54310121 | 10421 | |
fb9cefb4 | 10422 | =item B::LOGOP METHOD |
54310121 | 10423 | |
fb9cefb4 | 10424 | other |
54310121 | 10425 | |
fb9cefb4 | 10426 | =item B::LISTOP METHOD |
54310121 | 10427 | |
fb9cefb4 | 10428 | children |
54310121 | 10429 | |
2a551100 | 10430 | =item B::PMOP Methods |
54310121 | 10431 | |
f502af34 | 10432 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, |
0d53b15f | 10433 | pmpermflags, precomp, pmoffset |
54310121 | 10434 | |
fb9cefb4 | 10435 | =item B::SVOP METHOD |
54310121 | 10436 | |
a45bd81d | 10437 | sv, gv |
54310121 | 10438 | |
a45bd81d | 10439 | =item B::PADOP METHOD |
54310121 | 10440 | |
a45bd81d | 10441 | padix |
54310121 | 10442 | |
fb9cefb4 | 10443 | =item B::PVOP METHOD |
54310121 | 10444 | |
fb9cefb4 | 10445 | pv |
54310121 | 10446 | |
2a551100 | 10447 | =item B::LOOP Methods |
54310121 | 10448 | |
fb9cefb4 | 10449 | redoop, nextop, lastop |
54310121 | 10450 | |
2a551100 | 10451 | =item B::COP Methods |
54310121 | 10452 | |
2a551100 | 10453 | label, stash, stashpv, file, cop_seq, arybase, line, warnings, io |
54310121 | 10454 | |
fb9cefb4 | 10455 | =back |
54310121 | 10456 | |
fb9cefb4 | 10457 | =item AUTHOR |
54310121 | 10458 | |
a45bd81d GS |
10459 | =back |
10460 | ||
fb9cefb4 GS |
10461 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
10462 | bytecode | |
54310121 | 10463 | |
d420ca49 | 10464 | =over 4 |
a45bd81d | 10465 | |
fb9cefb4 | 10466 | =item SYNOPSIS |
54310121 | 10467 | |
fb9cefb4 | 10468 | =item DESCRIPTION |
54310121 | 10469 | |
80637b95 JH |
10470 | %insn_data, @insn_name, @optype, @specialsv_name |
10471 | ||
fb9cefb4 | 10472 | =item AUTHOR |
54310121 | 10473 | |
a45bd81d GS |
10474 | =back |
10475 | ||
fb9cefb4 | 10476 | =head2 B::Assembler - Assemble Perl bytecode |
54310121 | 10477 | |
d420ca49 | 10478 | =over 4 |
a45bd81d | 10479 | |
fb9cefb4 | 10480 | =item SYNOPSIS |
54310121 | 10481 | |
fb9cefb4 | 10482 | =item DESCRIPTION |
54310121 | 10483 | |
a9ef4385 | 10484 | =item AUTHORS |
54310121 | 10485 | |
a45bd81d GS |
10486 | =back |
10487 | ||
fb9cefb4 | 10488 | =head2 B::Bblock - Walk basic blocks |
54310121 | 10489 | |
d420ca49 | 10490 | =over 4 |
a45bd81d | 10491 | |
fb9cefb4 | 10492 | =item SYNOPSIS |
54310121 | 10493 | |
fb9cefb4 | 10494 | =item DESCRIPTION |
54310121 | 10495 | |
80637b95 JH |
10496 | =over 4 |
10497 | ||
10498 | =item Functions | |
10499 | ||
10500 | B<find_leaders> | |
10501 | ||
10502 | =back | |
10503 | ||
fb9cefb4 | 10504 | =item AUTHOR |
54310121 | 10505 | |
a45bd81d GS |
10506 | =back |
10507 | ||
fb9cefb4 | 10508 | =head2 B::Bytecode - Perl compiler's bytecode backend |
54310121 | 10509 | |
d420ca49 | 10510 | =over 4 |
a45bd81d | 10511 | |
fb9cefb4 | 10512 | =item SYNOPSIS |
54310121 | 10513 | |
fb9cefb4 GS |
10514 | =item DESCRIPTION |
10515 | ||
0d53b15f JH |
10516 | =item EXAMPLE |
10517 | ||
fb9cefb4 GS |
10518 | =item OPTIONS |
10519 | ||
0d53b15f | 10520 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> |
fb9cefb4 | 10521 | |
0d53b15f | 10522 | =item KNOWN BUGS |
14218588 | 10523 | |
0d53b15f | 10524 | =item NOTICE |
fb9cefb4 | 10525 | |
a9ef4385 | 10526 | =item AUTHORS |
fb9cefb4 | 10527 | |
a45bd81d GS |
10528 | =back |
10529 | ||
fb9cefb4 GS |
10530 | =head2 B::C - Perl compiler's C backend |
10531 | ||
d420ca49 | 10532 | =over 4 |
a45bd81d | 10533 | |
fb9cefb4 GS |
10534 | =item SYNOPSIS |
10535 | ||
10536 | =item DESCRIPTION | |
10537 | ||
10538 | =item OPTIONS | |
10539 | ||
10540 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
04b01f78 | 10541 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, |
f502af34 JH |
10542 | B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, |
10543 | B<-llimit> | |
fb9cefb4 GS |
10544 | |
10545 | =item EXAMPLES | |
10546 | ||
10547 | =item BUGS | |
10548 | ||
10549 | =item AUTHOR | |
10550 | ||
a45bd81d GS |
10551 | =back |
10552 | ||
fb9cefb4 GS |
10553 | =head2 B::CC - Perl compiler's optimized C translation backend |
10554 | ||
d420ca49 | 10555 | =over 4 |
a45bd81d | 10556 | |
fb9cefb4 GS |
10557 | =item SYNOPSIS |
10558 | ||
10559 | =item DESCRIPTION | |
10560 | ||
10561 | =item OPTIONS | |
10562 | ||
10563 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
10564 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
10565 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
10566 | ||
10567 | =item EXAMPLES | |
10568 | ||
10569 | =item BUGS | |
10570 | ||
10571 | =item DIFFERENCES | |
10572 | ||
d420ca49 | 10573 | =over 4 |
fb9cefb4 GS |
10574 | |
10575 | =item Loops | |
10576 | ||
10577 | =item Context of ".." | |
10578 | ||
10579 | =item Arithmetic | |
10580 | ||
10581 | =item Deprecated features | |
10582 | ||
10583 | =back | |
10584 | ||
10585 | =item AUTHOR | |
10586 | ||
a45bd81d GS |
10587 | =back |
10588 | ||
76d3c696 JH |
10589 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops |
10590 | ||
10591 | =over 4 | |
10592 | ||
10593 | =item SYNOPSIS | |
10594 | ||
10595 | =item DESCRIPTION | |
10596 | ||
ff426ff2 JH |
10597 | =item EXAMPLE |
10598 | ||
76d3c696 JH |
10599 | =item OPTIONS |
10600 | ||
5f15c94e NC |
10601 | =over 4 |
10602 | ||
10603 | =item Options for Opcode Ordering | |
10604 | ||
10605 | B<-basic>, B<-exec>, B<-tree> | |
10606 | ||
10607 | =item Options for Line-Style | |
10608 | ||
10609 | B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env> | |
10610 | ||
10611 | =item Options for tree-specific formatting | |
10612 | ||
10613 | B<-compact>, B<-loose>, B<-vt>, B<-ascii> | |
10614 | ||
10615 | =item Options controlling sequence numbering | |
10616 | ||
10617 | B<-base>I<n>, B<-bigendian>, B<-littleendian> | |
10618 | ||
10619 | =item Other options | |
10620 | ||
07e9b5fe | 10621 | B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref |
5f15c94e NC |
10622 | |
10623 | =item Option Stickiness | |
10624 | ||
10625 | =back | |
76d3c696 | 10626 | |
07e9b5fe NC |
10627 | =item ABBREVIATIONS |
10628 | ||
10629 | =over 4 | |
10630 | ||
10631 | =item OP class abbreviations | |
10632 | ||
10633 | =item OP flags abbreviations | |
10634 | ||
10635 | =back | |
10636 | ||
76d3c696 JH |
10637 | =item FORMATTING SPECIFICATIONS |
10638 | ||
07e9b5fe NC |
10639 | =over 4 |
10640 | ||
10641 | =item Special Patterns | |
10642 | ||
76d3c696 JH |
10643 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, |
10644 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, | |
07e9b5fe NC |
10645 | B<~> |
10646 | ||
10647 | =item # Variables | |
10648 | ||
10649 | B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>, | |
ff426ff2 JH |
10650 | B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, |
10651 | B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, | |
76d3c696 | 10652 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, |
e4bb216d NC |
10653 | B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, |
10654 | B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> | |
76d3c696 | 10655 | |
76d3c696 JH |
10656 | =back |
10657 | ||
1fa7ca25 JH |
10658 | =item Using B::Concise outside of the O framework |
10659 | ||
5f15c94e NC |
10660 | =over 4 |
10661 | ||
10662 | =item Example: Altering Concise Renderings | |
10663 | ||
10664 | =item set_style() | |
10665 | ||
10666 | =item set_style_standard($name) | |
10667 | ||
10668 | =item add_style() | |
10669 | ||
10670 | =item add_callback() | |
10671 | ||
10672 | =item Running B::Concise::compile() | |
10673 | ||
10674 | =item B::Concise::reset_sequence() | |
10675 | ||
10676 | =item Errors | |
10677 | ||
10678 | =back | |
10679 | ||
76d3c696 JH |
10680 | =item AUTHOR |
10681 | ||
10682 | =back | |
10683 | ||
fb9cefb4 GS |
10684 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops |
10685 | ||
d420ca49 | 10686 | =over 4 |
a45bd81d | 10687 | |
fb9cefb4 GS |
10688 | =item SYNOPSIS |
10689 | ||
10690 | =item DESCRIPTION | |
10691 | ||
10692 | =item AUTHOR | |
10693 | ||
a45bd81d GS |
10694 | =back |
10695 | ||
fb9cefb4 GS |
10696 | =head2 B::Deparse - Perl compiler backend to produce perl code |
10697 | ||
d420ca49 | 10698 | =over 4 |
a45bd81d | 10699 | |
fb9cefb4 GS |
10700 | =item SYNOPSIS |
10701 | ||
10702 | =item DESCRIPTION | |
10703 | ||
10704 | =item OPTIONS | |
10705 | ||
0d53b15f | 10706 | B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>, |
fe9287c4 | 10707 | B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> |
c76ac1ee GS |
10708 | |
10709 | =item USING B::Deparse AS A MODULE | |
10710 | ||
d420ca49 | 10711 | =over 4 |
c76ac1ee GS |
10712 | |
10713 | =item Synopsis | |
10714 | ||
10715 | =item Description | |
10716 | ||
10717 | =item new | |
10718 | ||
d2f2ce36 JH |
10719 | =item ambient_pragmas |
10720 | ||
10721 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits | |
10722 | ||
c76ac1ee GS |
10723 | =item coderef2text |
10724 | ||
10725 | =back | |
fb9cefb4 GS |
10726 | |
10727 | =item BUGS | |
10728 | ||
10729 | =item AUTHOR | |
10730 | ||
a45bd81d GS |
10731 | =back |
10732 | ||
fb9cefb4 GS |
10733 | =head2 B::Disassembler - Disassemble Perl bytecode |
10734 | ||
d420ca49 | 10735 | =over 4 |
a45bd81d | 10736 | |
fb9cefb4 GS |
10737 | =item SYNOPSIS |
10738 | ||
10739 | =item DESCRIPTION | |
10740 | ||
10741 | =item AUTHOR | |
10742 | ||
a45bd81d GS |
10743 | =back |
10744 | ||
fb9cefb4 GS |
10745 | =head2 B::Lint - Perl lint |
10746 | ||
d420ca49 | 10747 | =over 4 |
a45bd81d | 10748 | |
fb9cefb4 GS |
10749 | =item SYNOPSIS |
10750 | ||
10751 | =item DESCRIPTION | |
10752 | ||
10753 | =item OPTIONS AND LINT CHECKS | |
10754 | ||
2a551100 JH |
10755 | B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>, |
10756 | B<dollar-underscore>, B<private-names>, B<undefined-subs>, | |
10757 | B<regexp-variables>, B<all>, B<none> | |
fb9cefb4 GS |
10758 | |
10759 | =item NON LINT-CHECK OPTIONS | |
10760 | ||
10761 | B<-u Package> | |
10762 | ||
10763 | =item BUGS | |
10764 | ||
10765 | =item AUTHOR | |
10766 | ||
a45bd81d GS |
10767 | =back |
10768 | ||
fb9cefb4 GS |
10769 | =head2 B::O, O - Generic interface to Perl Compiler backends |
10770 | ||
d420ca49 | 10771 | =over 4 |
a45bd81d | 10772 | |
fb9cefb4 GS |
10773 | =item SYNOPSIS |
10774 | ||
10775 | =item DESCRIPTION | |
10776 | ||
10777 | =item CONVENTIONS | |
10778 | ||
10779 | =item IMPLEMENTATION | |
10780 | ||
95fb7f7f JH |
10781 | =item BUGS |
10782 | ||
fb9cefb4 GS |
10783 | =item AUTHOR |
10784 | ||
a45bd81d GS |
10785 | =back |
10786 | ||
fb9cefb4 GS |
10787 | =head2 B::Showlex - Show lexical variables used in functions or files |
10788 | ||
d420ca49 | 10789 | =over 4 |
a45bd81d | 10790 | |
fb9cefb4 GS |
10791 | =item SYNOPSIS |
10792 | ||
10793 | =item DESCRIPTION | |
10794 | ||
e4bb216d NC |
10795 | =item EXAMPLES |
10796 | ||
10797 | =over 4 | |
10798 | ||
10799 | =item OPTIONS | |
10800 | ||
10801 | =back | |
10802 | ||
10803 | =item SEE ALSO | |
10804 | ||
10805 | =item TODO | |
10806 | ||
fb9cefb4 GS |
10807 | =item AUTHOR |
10808 | ||
a45bd81d GS |
10809 | =back |
10810 | ||
fb9cefb4 GS |
10811 | =head2 B::Stackobj - Helper module for CC backend |
10812 | ||
d420ca49 | 10813 | =over 4 |
a45bd81d | 10814 | |
fb9cefb4 GS |
10815 | =item SYNOPSIS |
10816 | ||
10817 | =item DESCRIPTION | |
10818 | ||
10819 | =item AUTHOR | |
10820 | ||
a45bd81d GS |
10821 | =back |
10822 | ||
4755096e GS |
10823 | =head2 B::Stash - show what stashes are loaded |
10824 | ||
fb9cefb4 GS |
10825 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops |
10826 | ||
d420ca49 | 10827 | =over 4 |
a45bd81d | 10828 | |
fb9cefb4 GS |
10829 | =item SYNOPSIS |
10830 | ||
10831 | =item DESCRIPTION | |
10832 | ||
10833 | =item AUTHOR | |
10834 | ||
a45bd81d GS |
10835 | =back |
10836 | ||
fb9cefb4 GS |
10837 | =head2 B::Xref - Generates cross reference reports for Perl programs |
10838 | ||
d420ca49 | 10839 | =over 4 |
a45bd81d | 10840 | |
fb9cefb4 GS |
10841 | =item SYNOPSIS |
10842 | ||
10843 | =item DESCRIPTION | |
10844 | ||
10845 | =item OPTIONS | |
10846 | ||
b2deec1d | 10847 | C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> |
fb9cefb4 GS |
10848 | |
10849 | =item BUGS | |
10850 | ||
10851 | =item AUTHOR | |
10852 | ||
a45bd81d GS |
10853 | =back |
10854 | ||
639f8edf HS |
10855 | =head2 Bblock, B::Bblock - Walk basic blocks |
10856 | ||
10857 | =over 4 | |
10858 | ||
10859 | =item SYNOPSIS | |
10860 | ||
10861 | =item DESCRIPTION | |
10862 | ||
10863 | =over 4 | |
10864 | ||
10865 | =item Functions | |
10866 | ||
10867 | B<find_leaders> | |
10868 | ||
10869 | =back | |
10870 | ||
10871 | =item AUTHOR | |
10872 | ||
10873 | =back | |
10874 | ||
a45bd81d GS |
10875 | =head2 Benchmark - benchmark running times of Perl code |
10876 | ||
d420ca49 | 10877 | =over 4 |
fb9cefb4 GS |
10878 | |
10879 | =item SYNOPSIS | |
10880 | ||
10881 | =item DESCRIPTION | |
10882 | ||
d420ca49 | 10883 | =over 4 |
fb9cefb4 GS |
10884 | |
10885 | =item Methods | |
10886 | ||
c76ac1ee | 10887 | new, debug, iters |
fb9cefb4 GS |
10888 | |
10889 | =item Standard Exports | |
10890 | ||
10891 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
c76ac1ee GS |
10892 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( |
10893 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
fb9cefb4 GS |
10894 | |
10895 | =item Optional Exports | |
10896 | ||
2a551100 | 10897 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [ |
ba62762e JH |
10898 | STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), |
10899 | disablecache ( ), enablecache ( ), timesum ( T1, T2 ) | |
fb9cefb4 | 10900 | |
2a551100 JH |
10901 | =item :hireswallclock |
10902 | ||
fb9cefb4 GS |
10903 | =back |
10904 | ||
10905 | =item NOTES | |
10906 | ||
a45bd81d GS |
10907 | =item EXAMPLES |
10908 | ||
fb9cefb4 GS |
10909 | =item INHERITANCE |
10910 | ||
10911 | =item CAVEATS | |
10912 | ||
a45bd81d GS |
10913 | =item SEE ALSO |
10914 | ||
fb9cefb4 GS |
10915 | =item AUTHORS |
10916 | ||
10917 | =item MODIFICATION HISTORY | |
10918 | ||
a45bd81d GS |
10919 | =back |
10920 | ||
6f8d6a2d JH |
10921 | =head2 ByteLoader - load byte compiled perl code |
10922 | ||
10923 | =over 4 | |
10924 | ||
10925 | =item SYNOPSIS | |
10926 | ||
10927 | =item DESCRIPTION | |
10928 | ||
10929 | =item AUTHOR | |
10930 | ||
10931 | =item SEE ALSO | |
10932 | ||
10933 | =back | |
10934 | ||
639f8edf HS |
10935 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend |
10936 | ||
10937 | =over 4 | |
10938 | ||
10939 | =item SYNOPSIS | |
10940 | ||
10941 | =item DESCRIPTION | |
10942 | ||
10943 | =item EXAMPLE | |
10944 | ||
10945 | =item OPTIONS | |
10946 | ||
10947 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> | |
10948 | ||
10949 | =item KNOWN BUGS | |
10950 | ||
10951 | =item NOTICE | |
10952 | ||
10953 | =item AUTHORS | |
10954 | ||
10955 | =back | |
10956 | ||
fb9cefb4 GS |
10957 | =head2 CGI - Simple Common Gateway Interface Class |
10958 | ||
d420ca49 | 10959 | =over 4 |
a45bd81d | 10960 | |
fb9cefb4 GS |
10961 | =item SYNOPSIS |
10962 | ||
10963 | =item ABSTRACT | |
10964 | ||
10965 | =item DESCRIPTION | |
10966 | ||
d420ca49 | 10967 | =over 4 |
fb9cefb4 GS |
10968 | |
10969 | =item PROGRAMMING STYLE | |
10970 | ||
10971 | =item CALLING CGI.PM ROUTINES | |
10972 | ||
fb9cefb4 GS |
10973 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): |
10974 | ||
10975 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
10976 | ||
10977 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
10978 | ||
10979 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
10980 | ||
10981 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
10982 | ||
10983 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
10984 | ||
10985 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
10986 | ||
10987 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
10988 | ||
10989 | =item DELETING A PARAMETER COMPLETELY: | |
10990 | ||
10991 | =item DELETING ALL PARAMETERS: | |
10992 | ||
10993 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
10994 | ||
a10cf691 GS |
10995 | =item FETCHING THE PARAMETER LIST AS A HASH: |
10996 | ||
fb9cefb4 GS |
10997 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
10998 | ||
a10cf691 GS |
10999 | =item RETRIEVING CGI ERRORS |
11000 | ||
fb9cefb4 GS |
11001 | =item USING THE FUNCTION-ORIENTED INTERFACE |
11002 | ||
f502af34 | 11003 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, |
fb9cefb4 GS |
11004 | B<:standard>, B<:all> |
11005 | ||
11006 | =item PRAGMAS | |
11007 | ||
bd28ded5 JH |
11008 | -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, |
11009 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, | |
11010 | -private_tempfiles | |
fb9cefb4 | 11011 | |
14218588 GS |
11012 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
11013 | ||
f502af34 JH |
11014 | 1. start_table() (generates a <table> tag), 2. end_table() (generates a |
11015 | </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates | |
11016 | a </ul> tag) | |
14218588 GS |
11017 | |
11018 | =back | |
fb9cefb4 GS |
11019 | |
11020 | =item GENERATING DYNAMIC DOCUMENTS | |
11021 | ||
d420ca49 | 11022 | =over 4 |
fb9cefb4 GS |
11023 | |
11024 | =item CREATING A STANDARD HTTP HEADER: | |
11025 | ||
11026 | =item GENERATING A REDIRECTION HEADER | |
11027 | ||
11028 | =item CREATING THE HTML DOCUMENT HEADER | |
11029 | ||
11030 | B<Parameters:>, 4, 5, 6.. | |
11031 | ||
11032 | =item ENDING THE HTML DOCUMENT: | |
11033 | ||
11034 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
11035 | ||
11036 | =item OBTAINING THE SCRIPT'S URL | |
11037 | ||
11038 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
37d4d706 | 11039 | (B<-query_string>), B<-base> |
fb9cefb4 | 11040 | |
14218588 GS |
11041 | =item MIXING POST AND URL PARAMETERS |
11042 | ||
fb9cefb4 GS |
11043 | =back |
11044 | ||
11045 | =item CREATING STANDARD HTML ELEMENTS: | |
11046 | ||
d420ca49 | 11047 | =over 4 |
fb9cefb4 GS |
11048 | |
11049 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
11050 | ||
11051 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
11052 | ||
11053 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
11054 | ||
11055 | =item NON-STANDARD HTML SHORTCUTS | |
11056 | ||
d722968f JH |
11057 | =item AUTOESCAPING HTML |
11058 | ||
11059 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
11060 | charset([$charset]);, $flag = autoEscape([$flag]); | |
11061 | ||
14218588 GS |
11062 | =item PRETTY-PRINTING HTML |
11063 | ||
fb9cefb4 GS |
11064 | =back |
11065 | ||
11066 | =item CREATING FILL-OUT FORMS: | |
11067 | ||
d420ca49 | 11068 | =over 4 |
fb9cefb4 GS |
11069 | |
11070 | =item CREATING AN ISINDEX TAG | |
11071 | ||
11072 | =item STARTING AND ENDING A FORM | |
11073 | ||
11074 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
11075 | ||
11076 | =item CREATING A TEXT FIELD | |
11077 | ||
11078 | B<Parameters> | |
11079 | ||
11080 | =item CREATING A BIG TEXT FIELD | |
11081 | ||
11082 | =item CREATING A PASSWORD FIELD | |
11083 | ||
11084 | =item CREATING A FILE UPLOAD FIELD | |
11085 | ||
11086 | B<Parameters> | |
11087 | ||
11088 | =item CREATING A POPUP MENU | |
11089 | ||
2a551100 JH |
11090 | =item CREATING AN OPTION GROUP |
11091 | ||
fb9cefb4 GS |
11092 | =item CREATING A SCROLLING LIST |
11093 | ||
11094 | B<Parameters:> | |
11095 | ||
11096 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
54310121 | 11097 | |
11098 | B<Parameters:> | |
11099 | ||
11100 | =item CREATING A STANDALONE CHECKBOX | |
11101 | ||
11102 | B<Parameters:> | |
11103 | ||
11104 | =item CREATING A RADIO BUTTON GROUP | |
11105 | ||
11106 | B<Parameters:> | |
11107 | ||
11108 | =item CREATING A SUBMIT BUTTON | |
11109 | ||
11110 | B<Parameters:> | |
11111 | ||
11112 | =item CREATING A RESET BUTTON | |
11113 | ||
11114 | =item CREATING A DEFAULT BUTTON | |
11115 | ||
11116 | =item CREATING A HIDDEN FIELD | |
11117 | ||
11118 | B<Parameters:> | |
11119 | ||
11120 | =item CREATING A CLICKABLE IMAGE BUTTON | |
11121 | ||
0d53b15f JH |
11122 | B<Parameters:>, 3. The third option (-align, optional) is an alignment |
11123 | type, and may be TOP, BOTTOM or MIDDLE | |
54310121 | 11124 | |
11125 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
11126 | ||
11127 | =back | |
11128 | ||
14218588 | 11129 | =item HTTP COOKIES |
54310121 | 11130 | |
11131 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
11132 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
11133 | ||
14218588 | 11134 | =item WORKING WITH FRAMES |
54310121 | 11135 | |
11136 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
11137 | document in the HTTP header, 3. Specify the destination for the document in | |
f502af34 | 11138 | the <form> tag |
54310121 | 11139 | |
c90c0ff4 | 11140 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
11141 | ||
54310121 | 11142 | =item DEBUGGING |
11143 | ||
d420ca49 | 11144 | =over 4 |
54310121 | 11145 | |
11146 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
11147 | ||
11148 | =back | |
11149 | ||
11150 | =item FETCHING ENVIRONMENT VARIABLES | |
11151 | ||
14218588 | 11152 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
0d53b15f JH |
11153 | B<path_translated()>, B<remote_host()>, B<script_name()> Return the script |
11154 | name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type | |
11155 | ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, | |
2e038148 NC |
11156 | B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name |
11157 | ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
54310121 | 11158 | |
fb9cefb4 | 11159 | =item USING NPH SCRIPTS |
54310121 | 11160 | |
fb9cefb4 | 11161 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
ab648d5e | 11162 | parameters |
54310121 | 11163 | |
fb9cefb4 | 11164 | =item Server Push |
54310121 | 11165 | |
2d967e39 | 11166 | multipart_init(), multipart_start(), multipart_end(), multipart_final() |
54310121 | 11167 | |
fb9cefb4 | 11168 | =item Avoiding Denial of Service Attacks |
54310121 | 11169 | |
fb9cefb4 GS |
11170 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
11171 | basis>, B<2. Globally for all scripts> | |
54310121 | 11172 | |
fb9cefb4 | 11173 | =item COMPATIBILITY WITH CGI-LIB.PL |
54310121 | 11174 | |
11175 | =item AUTHOR INFORMATION | |
11176 | ||
11177 | =item CREDITS | |
11178 | ||
11179 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
11180 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
11181 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
14218588 GS |
11182 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
11183 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
11184 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
11185 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
11186 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
11187 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
11188 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
11189 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
11190 | ...and many many more.. | |
54310121 | 11191 | |
11192 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
11193 | ||
11194 | =item BUGS | |
11195 | ||
11196 | =item SEE ALSO | |
11197 | ||
a45bd81d GS |
11198 | =back |
11199 | ||
11200 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
11201 | ||
d420ca49 | 11202 | =over 4 |
54310121 | 11203 | |
11204 | =item SYNOPSIS | |
11205 | ||
a45bd81d GS |
11206 | =item ABSTRACT |
11207 | ||
54310121 | 11208 | =item DESCRIPTION |
11209 | ||
a45bd81d | 11210 | =item AUTHOR INFORMATION |
137443ea | 11211 | |
a45bd81d | 11212 | =item BUGS |
54310121 | 11213 | |
11214 | =item SEE ALSO | |
11215 | ||
a45bd81d | 11216 | =back |
54310121 | 11217 | |
11218 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
11219 | other) error log | |
11220 | ||
d420ca49 | 11221 | =over 4 |
a45bd81d | 11222 | |
54310121 | 11223 | =item SYNOPSIS |
11224 | ||
11225 | =item DESCRIPTION | |
11226 | ||
11227 | =item REDIRECTING ERROR MESSAGES | |
11228 | ||
11229 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
11230 | ||
d420ca49 | 11231 | =over 4 |
fb9cefb4 GS |
11232 | |
11233 | =item Changing the default message | |
11234 | ||
11235 | =back | |
11236 | ||
10862624 RF |
11237 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS |
11238 | ||
2a551100 | 11239 | =item OVERRIDING THE NAME OF THE PROGRAM |
54310121 | 11240 | |
11241 | =item AUTHORS | |
11242 | ||
11243 | =item SEE ALSO | |
11244 | ||
a45bd81d GS |
11245 | =back |
11246 | ||
fb9cefb4 GS |
11247 | =head2 CGI::Cookie - Interface to Netscape Cookies |
11248 | ||
d420ca49 | 11249 | =over 4 |
a45bd81d | 11250 | |
fb9cefb4 GS |
11251 | =item SYNOPSIS |
11252 | ||
11253 | =item DESCRIPTION | |
11254 | ||
11255 | =item USING CGI::Cookie | |
11256 | ||
11257 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
11258 | ||
d420ca49 | 11259 | =over 4 |
fb9cefb4 GS |
11260 | |
11261 | =item Creating New Cookies | |
11262 | ||
11263 | =item Sending the Cookie to the Browser | |
11264 | ||
11265 | =item Recovering Previous Cookies | |
11266 | ||
11267 | =item Manipulating Cookies | |
11268 | ||
11269 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
11270 | ||
11271 | =back | |
11272 | ||
11273 | =item AUTHOR INFORMATION | |
11274 | ||
11275 | =item BUGS | |
11276 | ||
11277 | =item SEE ALSO | |
11278 | ||
a45bd81d GS |
11279 | =back |
11280 | ||
54310121 | 11281 | =head2 CGI::Fast - CGI Interface for Fast CGI |
11282 | ||
d420ca49 | 11283 | =over 4 |
a45bd81d | 11284 | |
54310121 | 11285 | =item SYNOPSIS |
11286 | ||
11287 | =item DESCRIPTION | |
11288 | ||
11289 | =item OTHER PIECES OF THE PUZZLE | |
11290 | ||
11291 | =item WRITING FASTCGI PERL SCRIPTS | |
11292 | ||
11293 | =item INSTALLING FASTCGI SCRIPTS | |
11294 | ||
11295 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
11296 | ||
53d7eaa8 JH |
11297 | =item EXTERNAL FASTCGI SERVER INVOCATION |
11298 | ||
11299 | FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE | |
11300 | ||
54310121 | 11301 | =item CAVEATS |
11302 | ||
11303 | =item AUTHOR INFORMATION | |
11304 | ||
11305 | =item BUGS | |
11306 | ||
11307 | =item SEE ALSO | |
11308 | ||
a45bd81d GS |
11309 | =back |
11310 | ||
c76ac1ee GS |
11311 | =head2 CGI::Pretty - module to produce nicely formatted HTML code |
11312 | ||
d420ca49 | 11313 | =over 4 |
a45bd81d | 11314 | |
c76ac1ee GS |
11315 | =item SYNOPSIS |
11316 | ||
11317 | =item DESCRIPTION | |
11318 | ||
d420ca49 | 11319 | =over 4 |
c76ac1ee GS |
11320 | |
11321 | =item Tags that won't be formatted | |
11322 | ||
a45bd81d GS |
11323 | =item Customizing the Indenting |
11324 | ||
c76ac1ee GS |
11325 | =back |
11326 | ||
11327 | =item BUGS | |
11328 | ||
11329 | =item AUTHOR | |
11330 | ||
11331 | =item SEE ALSO | |
11332 | ||
a45bd81d GS |
11333 | =back |
11334 | ||
54310121 | 11335 | =head2 CGI::Push - Simple Interface to Server Push |
11336 | ||
d420ca49 | 11337 | =over 4 |
a45bd81d | 11338 | |
54310121 | 11339 | =item SYNOPSIS |
11340 | ||
11341 | =item DESCRIPTION | |
11342 | ||
11343 | =item USING CGI::Push | |
11344 | ||
2d967e39 | 11345 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph |
54310121 | 11346 | |
d420ca49 | 11347 | =over 4 |
fb9cefb4 GS |
11348 | |
11349 | =item Heterogeneous Pages | |
11350 | ||
11351 | =item Changing the Page Delay on the Fly | |
11352 | ||
11353 | =back | |
11354 | ||
54310121 | 11355 | =item INSTALLING CGI::Push SCRIPTS |
11356 | ||
54310121 | 11357 | =item AUTHOR INFORMATION |
11358 | ||
11359 | =item BUGS | |
11360 | ||
11361 | =item SEE ALSO | |
11362 | ||
a45bd81d GS |
11363 | =back |
11364 | ||
11365 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
11366 | ||
d420ca49 | 11367 | =over 4 |
54310121 | 11368 | |
11369 | =item SYNOPSIS | |
11370 | ||
a45bd81d GS |
11371 | =item ABSTRACT |
11372 | ||
54310121 | 11373 | =item DESCRIPTION |
11374 | ||
a45bd81d | 11375 | =item AUTHOR INFORMATION |
54310121 | 11376 | |
a45bd81d GS |
11377 | =item BUGS |
11378 | ||
11379 | =item SEE ALSO | |
11380 | ||
11381 | =back | |
54310121 | 11382 | |
2d967e39 JH |
11383 | =head2 CGI::Util - Internal utilities used by CGI module |
11384 | ||
11385 | =over 4 | |
11386 | ||
11387 | =item SYNOPSIS | |
11388 | ||
11389 | =item DESCRIPTION | |
11390 | ||
11391 | =item AUTHOR INFORMATION | |
11392 | ||
11393 | =item SEE ALSO | |
11394 | ||
11395 | =back | |
11396 | ||
8ebc5c01 | 11397 | =head2 CPAN - query, download and build perl modules from CPAN sites |
cb1a09d0 | 11398 | |
d420ca49 | 11399 | =over 4 |
a45bd81d | 11400 | |
8ebc5c01 | 11401 | =item SYNOPSIS |
cb1a09d0 | 11402 | |
2a551100 JH |
11403 | =item STATUS |
11404 | ||
8ebc5c01 | 11405 | =item DESCRIPTION |
cb1a09d0 | 11406 | |
d420ca49 | 11407 | =over 4 |
cb1a09d0 | 11408 | |
8ebc5c01 | 11409 | =item Interactive Mode |
cb1a09d0 | 11410 | |
8ebc5c01 | 11411 | Searching for authors, bundles, distribution files and modules, make, test, |
694468e3 | 11412 | install, clean modules or distributions, get, readme, look module or |
f40a6c71 | 11413 | distribution, ls author, Signals |
cb1a09d0 | 11414 | |
8ebc5c01 | 11415 | =item CPAN::Shell |
cb1a09d0 | 11416 | |
774d564b | 11417 | =item autobundle |
11418 | ||
11419 | =item recompile | |
11420 | ||
d516a115 | 11421 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
dc848c6f | 11422 | |
10862624 | 11423 | =item Programmer's interface |
cb1a09d0 | 11424 | |
165c0277 JH |
11425 | expand($type,@things), expandany(@things), Programming Examples |
11426 | ||
11427 | =item Methods in the other Classes | |
11428 | ||
11429 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), | |
11430 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), | |
11431 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), | |
11432 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), | |
11433 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), | |
11434 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), | |
11435 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), | |
11436 | CPAN::Bundle::readme(), CPAN::Bundle::test(), | |
11437 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), | |
11438 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), | |
11439 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), | |
11440 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), | |
11441 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), | |
11442 | CPAN::Distribution::look(), CPAN::Distribution::make(), | |
11443 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), | |
11444 | CPAN::Distribution::test(), CPAN::Distribution::uptodate(), | |
11445 | CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(), | |
11446 | CPAN::Module::as_glimpse(), CPAN::Module::as_string(), | |
11447 | CPAN::Module::clean(), CPAN::Module::cpan_file(), | |
11448 | CPAN::Module::cpan_version(), CPAN::Module::cvs_import(), | |
11449 | CPAN::Module::description(), CPAN::Module::force($method,@args), | |
11450 | CPAN::Module::get(), CPAN::Module::inst_file(), | |
11451 | CPAN::Module::inst_version(), CPAN::Module::install(), | |
11452 | CPAN::Module::look(), CPAN::Module::make(), | |
11453 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), | |
11454 | CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid() | |
d516a115 | 11455 | |
8ebc5c01 | 11456 | =item Cache Manager |
cb1a09d0 | 11457 | |
8ebc5c01 | 11458 | =item Bundles |
cb1a09d0 | 11459 | |
774d564b | 11460 | =item Prerequisites |
cb1a09d0 | 11461 | |
fb9cefb4 GS |
11462 | =item Finding packages and VERSION |
11463 | ||
774d564b | 11464 | =item Debugging |
11465 | ||
14218588 | 11466 | =item Floppy, Zip, Offline Mode |
cb1a09d0 AD |
11467 | |
11468 | =back | |
11469 | ||
8ebc5c01 | 11470 | =item CONFIGURATION |
cb1a09d0 | 11471 | |
694468e3 GS |
11472 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> |
11473 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
11474 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
11475 | [unshift|push|splice] E<lt>listE<gt>> | |
cb1a09d0 | 11476 | |
d420ca49 | 11477 | =over 4 |
d516a115 | 11478 | |
14218588 GS |
11479 | =item Note on urllist parameter's format |
11480 | ||
11481 | =item urllist parameter has CD-ROM support | |
d516a115 JH |
11482 | |
11483 | =back | |
11484 | ||
8ebc5c01 | 11485 | =item SECURITY |
cb1a09d0 | 11486 | |
8ebc5c01 | 11487 | =item EXPORT |
cb1a09d0 | 11488 | |
14218588 GS |
11489 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
11490 | ||
11491 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
11492 | ||
d420ca49 | 11493 | =over 4 |
10862624 RF |
11494 | |
11495 | =item Three basic types of firewalls | |
11496 | ||
14218588 GS |
11497 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade |
11498 | ||
93d73c42 | 11499 | =item Configuring lynx or ncftp for going through a firewall |
10862624 RF |
11500 | |
11501 | =back | |
11502 | ||
11503 | =item FAQ | |
11504 | ||
ab648d5e | 11505 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10) |
10862624 | 11506 | |
774d564b | 11507 | =item BUGS |
cb1a09d0 AD |
11508 | |
11509 | =item AUTHOR | |
11510 | ||
f40a6c71 SC |
11511 | =item TRANSLATIONS |
11512 | ||
8ebc5c01 | 11513 | =item SEE ALSO |
cb1a09d0 | 11514 | |
a45bd81d GS |
11515 | =back |
11516 | ||
8ebc5c01 | 11517 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
cb1a09d0 | 11518 | |
d420ca49 | 11519 | =over 4 |
a45bd81d | 11520 | |
cb1a09d0 AD |
11521 | =item SYNOPSIS |
11522 | ||
cb1a09d0 AD |
11523 | =item DESCRIPTION |
11524 | ||
a45bd81d GS |
11525 | =back |
11526 | ||
8ebc5c01 | 11527 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
11528 | module | |
cb1a09d0 | 11529 | |
d420ca49 | 11530 | =over 4 |
a45bd81d | 11531 | |
cb1a09d0 AD |
11532 | =item SYNOPSIS |
11533 | ||
cb1a09d0 AD |
11534 | =item DESCRIPTION |
11535 | ||
8ebc5c01 | 11536 | =item SEE ALSO |
cb1a09d0 | 11537 | |
a45bd81d GS |
11538 | =back |
11539 | ||
d516a115 | 11540 | =head2 Carp, carp - warn of errors (from perspective of caller) |
cb1a09d0 | 11541 | |
d420ca49 | 11542 | =over 4 |
a45bd81d | 11543 | |
8ebc5c01 | 11544 | =item SYNOPSIS |
cb1a09d0 | 11545 | |
8ebc5c01 | 11546 | =item DESCRIPTION |
cb1a09d0 | 11547 | |
d420ca49 | 11548 | =over 4 |
d516a115 JH |
11549 | |
11550 | =item Forcing a Stack Trace | |
11551 | ||
11552 | =back | |
11553 | ||
e4bb216d NC |
11554 | =back |
11555 | ||
11556 | =over 4 | |
11557 | ||
11558 | =item GLOBAL VARIABLES | |
11559 | ||
11560 | =over 4 | |
11561 | ||
11562 | =item $Carp::CarpLevel | |
11563 | ||
11564 | =item $Carp::MaxEvalLen | |
11565 | ||
11566 | =item $Carp::MaxArgLen | |
11567 | ||
11568 | =item $Carp::MaxArgNums | |
11569 | ||
11570 | =item $Carp::Verbose | |
11571 | ||
11572 | =back | |
11573 | ||
11574 | =back | |
11575 | ||
11576 | =over 4 | |
11577 | ||
14218588 GS |
11578 | =item BUGS |
11579 | ||
a45bd81d GS |
11580 | =back |
11581 | ||
d61fd583 | 11582 | =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside |
ab648d5e | 11583 | |
0d0e97a6 JH |
11584 | =head2 Class::ISA -- report the search path for a class's ISA tree |
11585 | ||
11586 | =over 4 | |
11587 | ||
11588 | =item SYNOPSIS | |
11589 | ||
11590 | =item DESCRIPTION | |
11591 | ||
11592 | =item FUNCTIONS | |
11593 | ||
11594 | the function Class::ISA::super_path($CLASS), the function | |
11595 | Class::ISA::self_and_super_path($CLASS), the function | |
11596 | Class::ISA::self_and_super_versions($CLASS) | |
11597 | ||
639f8edf HS |
11598 | =item CAUTIONARY NOTES |
11599 | ||
11600 | =item COPYRIGHT | |
11601 | ||
11602 | =item AUTHOR | |
11603 | ||
11604 | =back | |
11605 | ||
11606 | =head2 Class::Struct - declare struct-like datatypes as Perl classes | |
11607 | ||
11608 | =over 4 | |
11609 | ||
11610 | =item SYNOPSIS | |
11611 | ||
11612 | =item DESCRIPTION | |
11613 | ||
11614 | =over 4 | |
11615 | ||
11616 | =item The C<struct()> function | |
11617 | ||
11618 | =item Class Creation at Compile Time | |
11619 | ||
11620 | =item Element Types and Accessor Methods | |
11621 | ||
11622 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
11623 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
11624 | ||
11625 | =item Initializing with C<new> | |
11626 | ||
11627 | =back | |
11628 | ||
11629 | =item EXAMPLES | |
11630 | ||
11631 | Example 1, Example 2, Example 3 | |
11632 | ||
11633 | =item Author and Modification History | |
11634 | ||
11635 | =back | |
11636 | ||
11637 | =head2 Config - access Perl configuration information | |
11638 | ||
11639 | =over 4 | |
11640 | ||
11641 | =item SYNOPSIS | |
11642 | ||
11643 | =item DESCRIPTION | |
11644 | ||
11645 | myconfig(), config_sh(), config_re($regex), config_vars(@names) | |
11646 | ||
11647 | =item EXAMPLE | |
11648 | ||
11649 | =item WARNING | |
0d0e97a6 | 11650 | |
639f8edf HS |
11651 | =item GLOSSARY |
11652 | ||
11653 | =over 4 | |
11654 | ||
11655 | =item _ | |
11656 | ||
11657 | C<_a>, C<_exe>, C<_o> | |
11658 | ||
11659 | =item a | |
11660 | ||
11661 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, | |
11662 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, | |
11663 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, | |
11664 | C<asctime_r_proto>, C<awk> | |
11665 | ||
11666 | =item b | |
11667 | ||
11668 | C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> | |
11669 | ||
11670 | =item c | |
11671 | ||
11672 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
11673 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, | |
11674 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
11675 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, | |
11676 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, | |
11677 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, | |
11678 | C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> | |
11679 | ||
11680 | =item d | |
11681 | ||
11682 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, | |
11683 | C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, | |
11684 | C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, | |
11685 | C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, | |
11686 | C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, | |
11687 | C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>, | |
11688 | C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, | |
11689 | C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, | |
11690 | C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, | |
11691 | C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, | |
11692 | C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, | |
11693 | C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, | |
11694 | C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>, | |
11695 | C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, | |
11696 | C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, | |
11697 | C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, | |
11698 | C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, | |
11699 | C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, | |
11700 | C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>, | |
11701 | C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, | |
11702 | C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, | |
11703 | C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, | |
11704 | C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>, | |
11705 | C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, | |
11706 | C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, | |
11707 | C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, | |
11708 | C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, | |
11709 | C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, | |
11710 | C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, | |
11711 | C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, | |
11712 | C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, | |
11713 | C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, | |
11714 | C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, | |
11715 | C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, | |
11716 | C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, | |
11717 | C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, | |
11718 | C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, | |
11719 | C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, | |
11720 | C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, | |
11721 | C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, | |
11722 | C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, | |
11723 | C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, | |
11724 | C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, | |
11725 | C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, | |
11726 | C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, | |
11727 | C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>, | |
11728 | C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>, | |
11729 | C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>, | |
11730 | C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>, | |
11731 | C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>, | |
11732 | C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, | |
11733 | C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>, | |
11734 | C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, | |
11735 | C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, | |
11736 | C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, | |
11737 | C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, | |
11738 | C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, | |
11739 | C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, | |
11740 | C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, | |
11741 | C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, | |
11742 | C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, | |
11743 | C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, | |
11744 | C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, | |
11745 | C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, | |
11746 | C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, | |
11747 | C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, | |
11748 | C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, | |
11749 | C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, | |
11750 | C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, | |
11751 | C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, | |
11752 | C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, | |
11753 | C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>, | |
11754 | C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>, | |
11755 | C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, | |
11756 | C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>, | |
11757 | C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>, | |
11758 | C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>, | |
e4bb216d NC |
11759 | C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>, |
11760 | C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, | |
11761 | C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, | |
11762 | C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, | |
11763 | C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, | |
11764 | C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>, | |
11765 | C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>, | |
11766 | C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>, | |
11767 | C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, | |
11768 | C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, | |
11769 | C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>, | |
11770 | C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, | |
11771 | C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>, | |
11772 | C<db_version_major>, C<db_version_minor>, C<db_version_patch>, | |
11773 | C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>, | |
11774 | C<drand01>, C<drand48_r_proto>, C<dynamic_ext> | |
639f8edf HS |
11775 | |
11776 | =item e | |
11777 | ||
11778 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, | |
11779 | C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, | |
11780 | C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, | |
11781 | C<expr>, C<extensions>, C<extras> | |
11782 | ||
11783 | =item f | |
11784 | ||
11785 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
11786 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, | |
11787 | C<full_sed> | |
11788 | ||
11789 | =item g | |
11790 | ||
11791 | C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, | |
11792 | C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, | |
11793 | C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, | |
11794 | C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, | |
11795 | C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, | |
11796 | C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, | |
11797 | C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, | |
11798 | C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, | |
11799 | C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, | |
11800 | C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> | |
11801 | ||
11802 | =item h | |
11803 | ||
11804 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, | |
11805 | C<html3dir>, C<html3direxp> | |
11806 | ||
11807 | =item i | |
11808 | ||
11809 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, | |
11810 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, | |
11811 | C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, | |
11812 | C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, | |
11813 | C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, | |
11814 | C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, | |
11815 | C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, | |
11816 | C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, | |
11817 | C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, | |
11818 | C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, | |
11819 | C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, | |
11820 | C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, | |
11821 | C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, | |
11822 | C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, | |
11823 | C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, | |
11824 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, | |
11825 | C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, | |
11826 | C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, | |
11827 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>, | |
11828 | C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>, | |
11829 | C<installprefixexp>, C<installprivlib>, C<installscript>, | |
11830 | C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>, | |
11831 | C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>, | |
11832 | C<installsiteman3dir>, C<installsitescript>, C<installstyle>, | |
11833 | C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, | |
11834 | C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>, | |
11835 | C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>, | |
11836 | C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> | |
11837 | ||
11838 | =item k | |
11839 | ||
11840 | C<known_extensions>, C<ksh> | |
11841 | ||
11842 | =item l | |
11843 | ||
11844 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, | |
11845 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
11846 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
11847 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
11848 | C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, | |
11849 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, | |
11850 | C<lseektype> | |
11851 | ||
11852 | =item m | |
11853 | ||
11854 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
11855 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
11856 | C<man3direxp>, C<man3ext> | |
11857 | ||
11858 | =item M | |
11859 | ||
11860 | C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, | |
11861 | C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, | |
11862 | C<myuname> | |
11863 | ||
11864 | =item n | |
11865 | ||
11866 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, | |
11867 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, | |
11868 | C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, | |
11869 | C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, | |
11870 | C<nvsize>, C<nvtype> | |
11871 | ||
11872 | =item o | |
11873 | ||
11874 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
11875 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> | |
11876 | ||
11877 | =item p | |
11878 | ||
11879 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, | |
11880 | C<perl>, C<perl_patchlevel> | |
11881 | ||
11882 | =item P | |
11883 | ||
11884 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
11885 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, | |
f99d9048 RGS |
11886 | C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, |
11887 | C<procselfexe>, C<prototype>, C<ptrsize> | |
639f8edf HS |
11888 | |
11889 | =item q | |
11890 | ||
11891 | C<quadkind>, C<quadtype> | |
11892 | ||
11893 | =item r | |
11894 | ||
11895 | C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, | |
11896 | C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, | |
11897 | C<rmail>, C<run>, C<runnm> | |
0d0e97a6 | 11898 | |
639f8edf | 11899 | =item s |
0d0e97a6 | 11900 | |
639f8edf HS |
11901 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, |
11902 | C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, | |
11903 | C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, | |
11904 | C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, | |
11905 | C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, | |
11906 | C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, | |
11907 | C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, | |
11908 | C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, | |
11909 | C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, | |
11910 | C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, | |
11911 | C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, | |
11912 | C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, | |
11913 | C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, | |
11914 | C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, | |
11915 | C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, | |
11916 | C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, | |
11917 | C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, | |
11918 | C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, | |
11919 | C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, | |
11920 | C<submit>, C<subversion>, C<sysman> | |
0d0e97a6 | 11921 | |
639f8edf | 11922 | =item t |
cb1a09d0 | 11923 | |
639f8edf HS |
11924 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, |
11925 | C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, | |
11926 | C<ttyname_r_proto> | |
a45bd81d | 11927 | |
639f8edf | 11928 | =item u |
cb1a09d0 | 11929 | |
639f8edf HS |
11930 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, |
11931 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
11932 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, | |
11933 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, | |
e4bb216d NC |
11934 | C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>, |
11935 | C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, | |
df344c0f NC |
11936 | C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>, |
11937 | C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, | |
11938 | C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, | |
11939 | C<uvuformat>, C<uvxformat>, C<uvXUformat> | |
cb1a09d0 | 11940 | |
639f8edf | 11941 | =item v |
8cc95fdb | 11942 | |
639f8edf HS |
11943 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, |
11944 | C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, | |
11945 | C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, | |
11946 | C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, | |
11947 | C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, | |
11948 | C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, | |
11949 | C<versiononly>, C<vi>, C<voidflags> | |
8cc95fdb | 11950 | |
639f8edf | 11951 | =item x |
d420ca49 | 11952 | |
f99d9048 | 11953 | C<xlibpth> |
8cc95fdb | 11954 | |
639f8edf | 11955 | =item y |
8cc95fdb | 11956 | |
639f8edf | 11957 | C<yacc>, C<yaccflags> |
a10cf691 | 11958 | |
639f8edf | 11959 | =item z |
8cc95fdb | 11960 | |
639f8edf | 11961 | C<zcat>, C<zip> |
cb1a09d0 | 11962 | |
639f8edf | 11963 | =back |
cb1a09d0 | 11964 | |
639f8edf | 11965 | =item NOTE |
cb1a09d0 | 11966 | |
a45bd81d GS |
11967 | =back |
11968 | ||
df344c0f NC |
11969 | =over 4 |
11970 | ||
11971 | =item SYNOPSIS | |
11972 | ||
11973 | =item DESCRIPTION | |
11974 | ||
11975 | dynamic, nonxs, static | |
11976 | ||
11977 | =item AUTHOR | |
11978 | ||
11979 | =back | |
11980 | ||
ab1e085c | 11981 | =head2 Cwd - get pathname of current working directory |
cb1a09d0 | 11982 | |
d420ca49 | 11983 | =over 4 |
a45bd81d | 11984 | |
8ebc5c01 | 11985 | =item SYNOPSIS |
cb1a09d0 | 11986 | |
8ebc5c01 | 11987 | =item DESCRIPTION |
cb1a09d0 | 11988 | |
53d7eaa8 JH |
11989 | =over 4 |
11990 | ||
11991 | =item getcwd and friends | |
11992 | ||
07e9b5fe | 11993 | getcwd, cwd, fastcwd, fastgetcwd, getdcwd |
53d7eaa8 JH |
11994 | |
11995 | =item abs_path and friends | |
11996 | ||
11997 | abs_path, realpath, fast_abs_path | |
11998 | ||
11999 | =item $ENV{PWD} | |
12000 | ||
12001 | =back | |
12002 | ||
d0363f02 JH |
12003 | =item NOTES |
12004 | ||
f99d9048 RGS |
12005 | =item AUTHOR |
12006 | ||
53d7eaa8 JH |
12007 | =item SEE ALSO |
12008 | ||
a45bd81d GS |
12009 | =back |
12010 | ||
14218588 GS |
12011 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
12012 | subject to | |
12013 | change) | |
12014 | ||
d420ca49 | 12015 | =over 4 |
a45bd81d | 12016 | |
14218588 GS |
12017 | =item SYNOPSIS |
12018 | ||
12019 | =item DESCRIPTION | |
12020 | ||
d420ca49 | 12021 | =over 4 |
14218588 GS |
12022 | |
12023 | =item Global Variables | |
12024 | ||
12025 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
12026 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
12027 | $DB::lineno | |
12028 | ||
12029 | =item API Methods | |
12030 | ||
12031 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
12032 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
12033 | ||
12034 | =item Client Callback Methods | |
12035 | ||
12036 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
12037 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
12038 | CLIENT->output(LIST) | |
12039 | ||
12040 | =back | |
12041 | ||
12042 | =item BUGS | |
12043 | ||
12044 | =item AUTHOR | |
12045 | ||
a45bd81d GS |
12046 | =back |
12047 | ||
1400179b NC |
12048 | =head2 DBM_Filter -- Filter DBM keys/values |
12049 | ||
12050 | =over 4 | |
12051 | ||
12052 | =item SYNOPSIS | |
12053 | ||
12054 | =item DESCRIPTION | |
12055 | ||
12056 | =item What is a DBM Filter? | |
12057 | ||
12058 | =over 4 | |
12059 | ||
12060 | =item So what's new? | |
12061 | ||
12062 | =back | |
12063 | ||
12064 | =item METHODS | |
12065 | ||
12066 | =over 4 | |
12067 | ||
12068 | =item $db->Filter_Push() | |
12069 | ||
12070 | =item $db->Filter_Key_Push() | |
12071 | ||
12072 | =item $db->Filter_Value_Push() | |
12073 | ||
12074 | Filter_Push, Filter_Key_Push, Filter_Value_Push | |
12075 | ||
12076 | =item $db->Filter_Pop() | |
12077 | ||
12078 | =item $db->Filtered() | |
12079 | ||
12080 | =back | |
12081 | ||
12082 | =item Writing a Filter | |
12083 | ||
12084 | =over 4 | |
12085 | ||
12086 | =item Immediate Filters | |
12087 | ||
12088 | =item Canned Filters | |
12089 | ||
12090 | "name", params | |
12091 | ||
12092 | =back | |
12093 | ||
12094 | =item Filters Included | |
12095 | ||
12096 | utf8, encode, compress, int32, null | |
12097 | ||
12098 | =item NOTES | |
12099 | ||
12100 | =over 4 | |
12101 | ||
12102 | =item Maintain Round Trip Integrity | |
12103 | ||
12104 | =item Don't mix filtered & non-filtered data in the same database file. | |
12105 | ||
12106 | =back | |
12107 | ||
12108 | =item EXAMPLE | |
12109 | ||
12110 | =item SEE ALSO | |
12111 | ||
12112 | =item AUTHOR | |
12113 | ||
12114 | =back | |
12115 | ||
d516a115 | 12116 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
cb1a09d0 | 12117 | |
d420ca49 | 12118 | =over 4 |
a45bd81d | 12119 | |
cb1a09d0 AD |
12120 | =item SYNOPSIS |
12121 | ||
cb1a09d0 AD |
12122 | =item DESCRIPTION |
12123 | ||
8ebc5c01 | 12124 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
cb1a09d0 | 12125 | |
d420ca49 | 12126 | =over 4 |
cb1a09d0 | 12127 | |
1fdc5aa6 | 12128 | =item Using DB_File with Berkeley DB version 2 or greater |
d516a115 | 12129 | |
68dc0745 | 12130 | =item Interface to Berkeley DB |
cb1a09d0 | 12131 | |
8ebc5c01 | 12132 | =item Opening a Berkeley DB Database File |
cb1a09d0 | 12133 | |
8ebc5c01 | 12134 | =item Default Parameters |
cb1a09d0 | 12135 | |
8ebc5c01 | 12136 | =item In Memory Databases |
cb1a09d0 AD |
12137 | |
12138 | =back | |
12139 | ||
8ebc5c01 | 12140 | =item DB_HASH |
cb1a09d0 | 12141 | |
d420ca49 | 12142 | =over 4 |
cb1a09d0 | 12143 | |
68dc0745 | 12144 | =item A Simple Example |
cb1a09d0 | 12145 | |
8ebc5c01 | 12146 | =back |
cb1a09d0 | 12147 | |
8ebc5c01 | 12148 | =item DB_BTREE |
cb1a09d0 | 12149 | |
d420ca49 | 12150 | =over 4 |
cb1a09d0 | 12151 | |
8ebc5c01 | 12152 | =item Changing the BTREE sort order |
cb1a09d0 | 12153 | |
68dc0745 | 12154 | =item Handling Duplicate Keys |
cb1a09d0 | 12155 | |
68dc0745 | 12156 | =item The get_dup() Method |
cb1a09d0 | 12157 | |
14218588 GS |
12158 | =item The find_dup() Method |
12159 | ||
12160 | =item The del_dup() Method | |
12161 | ||
8ebc5c01 | 12162 | =item Matching Partial Keys |
cb1a09d0 | 12163 | |
8ebc5c01 | 12164 | =back |
cb1a09d0 | 12165 | |
8ebc5c01 | 12166 | =item DB_RECNO |
cb1a09d0 | 12167 | |
d420ca49 | 12168 | =over 4 |
cb1a09d0 | 12169 | |
68dc0745 | 12170 | =item The 'bval' Option |
cb1a09d0 | 12171 | |
8ebc5c01 | 12172 | =item A Simple Example |
cb1a09d0 | 12173 | |
14218588 | 12174 | =item Extra RECNO Methods |
cb1a09d0 | 12175 | |
8ebc5c01 | 12176 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
1fa7ca25 JH |
12177 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, |
12178 | length, elements);> | |
cb1a09d0 | 12179 | |
8ebc5c01 | 12180 | =item Another Example |
cb1a09d0 | 12181 | |
8ebc5c01 | 12182 | =back |
cb1a09d0 | 12183 | |
8ebc5c01 | 12184 | =item THE API INTERFACE |
cb1a09d0 | 12185 | |
8ebc5c01 | 12186 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
12187 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
12188 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
12189 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
cb1a09d0 | 12190 | |
c76ac1ee GS |
12191 | =item DBM FILTERS |
12192 | ||
12193 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
12194 | B<filter_fetch_value> | |
12195 | ||
d420ca49 | 12196 | =over 4 |
c76ac1ee GS |
12197 | |
12198 | =item The Filter | |
12199 | ||
12200 | =item An Example -- the NULL termination problem. | |
12201 | ||
12202 | =item Another Example -- Key is a C int. | |
12203 | ||
12204 | =back | |
12205 | ||
8ebc5c01 | 12206 | =item HINTS AND TIPS |
cb1a09d0 | 12207 | |
d420ca49 | 12208 | =over 4 |
8ebc5c01 | 12209 | |
a45bd81d GS |
12210 | =item Locking: The Trouble with fd |
12211 | ||
12212 | =item Safe ways to lock a database | |
12213 | ||
12214 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
cb1a09d0 | 12215 | |
68dc0745 | 12216 | =item Sharing Databases With C Applications |
cb1a09d0 | 12217 | |
68dc0745 | 12218 | =item The untie() Gotcha |
4fdae800 | 12219 | |
8ebc5c01 | 12220 | =back |
cb1a09d0 | 12221 | |
8ebc5c01 | 12222 | =item COMMON QUESTIONS |
cb1a09d0 | 12223 | |
d420ca49 | 12224 | =over 4 |
cb1a09d0 | 12225 | |
8ebc5c01 | 12226 | =item Why is there Perl source in my database? |
cb1a09d0 | 12227 | |
8ebc5c01 | 12228 | =item How do I store complex data structures with DB_File? |
cb1a09d0 | 12229 | |
8ebc5c01 | 12230 | =item What does "Invalid Argument" mean? |
cb1a09d0 | 12231 | |
8ebc5c01 | 12232 | =item What does "Bareword 'DB_File' not allowed" mean? |
cb1a09d0 | 12233 | |
8ebc5c01 | 12234 | =back |
cb1a09d0 | 12235 | |
c76ac1ee GS |
12236 | =item REFERENCES |
12237 | ||
8ebc5c01 | 12238 | =item HISTORY |
cb1a09d0 | 12239 | |
8ebc5c01 | 12240 | =item BUGS |
cb1a09d0 | 12241 | |
8ebc5c01 | 12242 | =item AVAILABILITY |
cb1a09d0 | 12243 | |
d516a115 JH |
12244 | =item COPYRIGHT |
12245 | ||
8ebc5c01 | 12246 | =item SEE ALSO |
cb1a09d0 | 12247 | |
8ebc5c01 | 12248 | =item AUTHOR |
cb1a09d0 | 12249 | |
a45bd81d GS |
12250 | =back |
12251 | ||
fb9cefb4 GS |
12252 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
12253 | printing and C<eval> | |
12254 | ||
d420ca49 | 12255 | =over 4 |
a45bd81d | 12256 | |
fb9cefb4 GS |
12257 | =item SYNOPSIS |
12258 | ||
12259 | =item DESCRIPTION | |
12260 | ||
d420ca49 | 12261 | =over 4 |
fb9cefb4 GS |
12262 | |
12263 | =item Methods | |
12264 | ||
14218588 | 12265 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
b38f6a39 GS |
12266 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), |
12267 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
12268 | I<$OBJ>->Reset | |
fb9cefb4 GS |
12269 | |
12270 | =item Functions | |
12271 | ||
b38f6a39 | 12272 | Dumper(I<LIST>) |
fb9cefb4 GS |
12273 | |
12274 | =item Configuration Variables or Methods | |
12275 | ||
fb9cefb4 GS |
12276 | =item Exports |
12277 | ||
12278 | Dumper | |
12279 | ||
12280 | =back | |
12281 | ||
12282 | =item EXAMPLES | |
12283 | ||
12284 | =item BUGS | |
12285 | ||
0d53b15f JH |
12286 | =over 4 |
12287 | ||
12288 | =item NOTE | |
12289 | ||
12290 | =back | |
12291 | ||
fb9cefb4 GS |
12292 | =item AUTHOR |
12293 | ||
12294 | =item VERSION | |
12295 | ||
12296 | =item SEE ALSO | |
12297 | ||
a45bd81d GS |
12298 | =back |
12299 | ||
c76ac1ee GS |
12300 | =head2 Devel::DProf - a Perl code profiler |
12301 | ||
d420ca49 | 12302 | =over 4 |
a45bd81d | 12303 | |
c76ac1ee GS |
12304 | =item SYNOPSIS |
12305 | ||
12306 | =item DESCRIPTION | |
12307 | ||
12308 | =item PROFILE FORMAT | |
12309 | ||
12310 | =item AUTOLOAD | |
12311 | ||
12312 | =item ENVIRONMENT | |
12313 | ||
12314 | =item BUGS | |
12315 | ||
12316 | =item SEE ALSO | |
12317 | ||
a45bd81d GS |
12318 | =back |
12319 | ||
2a551100 | 12320 | =head2 Devel::PPPort - Perl/Pollution/Portability |
428dc699 JH |
12321 | |
12322 | =over 4 | |
12323 | ||
12324 | =item SYNOPSIS | |
12325 | ||
12326 | =item DESCRIPTION | |
12327 | ||
12328 | =over 4 | |
12329 | ||
e4bb216d NC |
12330 | =item Why use ppport.h? |
12331 | ||
12332 | You should use F<ppport.h> in modern code so that your code will work | |
12333 | with the widest range of Perl interpreters possible, without significant | |
12334 | additional work. | |
12335 | ||
12336 | =item How to use ppport.h | |
12337 | ||
12338 | =item Running ppport.h | |
12339 | ||
12340 | =back | |
12341 | ||
12342 | =item FUNCTIONS | |
12343 | ||
12344 | =over 4 | |
12345 | ||
428dc699 JH |
12346 | =item WriteFile |
12347 | ||
12348 | =back | |
12349 | ||
e4bb216d | 12350 | =item COMPATIBILITY |
493a87da | 12351 | |
e4bb216d NC |
12352 | =over 4 |
12353 | ||
12354 | =item Provided Perl compatibility API | |
12355 | ||
12356 | =item Perl API not supported by ppport.h | |
12357 | ||
12358 | perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, | |
12359 | perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, | |
12360 | perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 | |
12361 | ||
12362 | =back | |
12363 | ||
12364 | =item BUGS | |
12365 | ||
12366 | =item AUTHORS | |
12367 | ||
12368 | =item COPYRIGHT | |
428dc699 JH |
12369 | |
12370 | =item SEE ALSO | |
12371 | ||
12372 | =back | |
12373 | ||
14218588 GS |
12374 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
12375 | ||
d420ca49 | 12376 | =over 4 |
a45bd81d | 12377 | |
14218588 GS |
12378 | =item SYNOPSIS |
12379 | ||
12380 | =item DESCRIPTION | |
12381 | ||
d420ca49 | 12382 | =over 4 |
37d4d706 | 12383 | |
07fcf8ff JH |
12384 | =item Runtime debugging |
12385 | ||
37d4d706 JH |
12386 | =item Memory footprint debugging |
12387 | ||
12388 | =back | |
12389 | ||
14218588 GS |
12390 | =item EXAMPLES |
12391 | ||
d420ca49 | 12392 | =over 4 |
14218588 GS |
12393 | |
12394 | =item A simple scalar string | |
12395 | ||
12396 | =item A simple scalar number | |
12397 | ||
12398 | =item A simple scalar with an extra reference | |
12399 | ||
12400 | =item A reference to a simple scalar | |
12401 | ||
12402 | =item A reference to an array | |
12403 | ||
12404 | =item A reference to a hash | |
12405 | ||
12406 | =item Dumping a large array or hash | |
12407 | ||
12408 | =item A reference to an SV which holds a C pointer | |
12409 | ||
12410 | =item A reference to a subroutine | |
12411 | ||
12412 | =back | |
12413 | ||
12414 | =item EXPORTS | |
12415 | ||
12416 | =item BUGS | |
12417 | ||
12418 | =item AUTHOR | |
12419 | ||
12420 | =item SEE ALSO | |
12421 | ||
a45bd81d GS |
12422 | =back |
12423 | ||
8ebc5c01 | 12424 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
cb1a09d0 | 12425 | |
d420ca49 | 12426 | =over 4 |
a45bd81d | 12427 | |
8ebc5c01 | 12428 | =item SYNOPSIS |
cb1a09d0 | 12429 | |
8ebc5c01 | 12430 | =item DESCRIPTION |
cb1a09d0 | 12431 | |
a45bd81d GS |
12432 | =back |
12433 | ||
2e038148 | 12434 | =head2 Digest - Modules that calculate message digests |
ab1e085c JH |
12435 | |
12436 | =over 4 | |
12437 | ||
12438 | =item SYNOPSIS | |
12439 | ||
12440 | =item DESCRIPTION | |
12441 | ||
12442 | I<binary>, I<hex>, I<base64> | |
12443 | ||
12444 | =item OO INTERFACE | |
12445 | ||
12446 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = | |
2a551100 | 12447 | Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, |
2e038148 NC |
12448 | $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( |
12449 | $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, | |
12450 | $ctx->hexdigest, $ctx->b64digest | |
12451 | ||
12452 | =item Digest speed | |
ab1e085c JH |
12453 | |
12454 | =item SEE ALSO | |
12455 | ||
12456 | =item AUTHOR | |
12457 | ||
12458 | =back | |
12459 | ||
12460 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm | |
12461 | ||
12462 | =over 4 | |
12463 | ||
12464 | =item SYNOPSIS | |
12465 | ||
12466 | =item DESCRIPTION | |
12467 | ||
12468 | =item FUNCTIONS | |
12469 | ||
12470 | md5($data,...), md5_hex($data,...), md5_base64($data,...) | |
12471 | ||
12472 | =item METHODS | |
12473 | ||
0d53b15f | 12474 | $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), |
f262848d RGS |
12475 | $md5->addfile($io_handle), $md5->add_bits($data, $nbits), |
12476 | $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest | |
ab1e085c JH |
12477 | |
12478 | =item EXAMPLES | |
12479 | ||
12480 | =item SEE ALSO | |
12481 | ||
12482 | =item COPYRIGHT | |
12483 | ||
12484 | =item AUTHORS | |
12485 | ||
12486 | =back | |
12487 | ||
f262848d RGS |
12488 | =head2 Digest::base - Digest base class |
12489 | ||
12490 | =over 4 | |
12491 | ||
12492 | =item SYNPOSIS | |
12493 | ||
12494 | =item DESCRIPTION | |
12495 | ||
12496 | =item SEE ALSO | |
12497 | ||
12498 | =back | |
12499 | ||
8ebc5c01 | 12500 | =head2 DirHandle - supply object methods for directory handles |
cb1a09d0 | 12501 | |
d420ca49 | 12502 | =over 4 |
a45bd81d | 12503 | |
8ebc5c01 | 12504 | =item SYNOPSIS |
cb1a09d0 | 12505 | |
8ebc5c01 | 12506 | =item DESCRIPTION |
cb1a09d0 | 12507 | |
ac4dd294 JH |
12508 | =item NOTES |
12509 | ||
a45bd81d GS |
12510 | =back |
12511 | ||
14218588 GS |
12512 | =head2 Dumpvalue - provides screen dump of Perl data. |
12513 | ||
d420ca49 | 12514 | =over 4 |
a45bd81d | 12515 | |
c76ac1ee | 12516 | =item SYNOPSIS |
14218588 GS |
12517 | |
12518 | =item DESCRIPTION | |
12519 | ||
d420ca49 | 12520 | =over 4 |
14218588 GS |
12521 | |
12522 | =item Creation | |
12523 | ||
12524 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
35bf961c JH |
12525 | C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, |
12526 | C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
14218588 GS |
12527 | stopDbSignal |
12528 | ||
12529 | =item Methods | |
12530 | ||
e993db8c JH |
12531 | dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, |
12532 | compactDump, veryCompact, set, get | |
14218588 | 12533 | |
b6235c4f | 12534 | =back |
a45bd81d GS |
12535 | |
12536 | =back | |
12537 | ||
639f8edf HS |
12538 | =head2 DynaLoader - Dynamically load C libraries into Perl code |
12539 | ||
12540 | =over 4 | |
12541 | ||
12542 | =item SYNOPSIS | |
12543 | ||
12544 | =item DESCRIPTION | |
12545 | ||
12546 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
1400179b NC |
12547 | @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), |
12548 | dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), | |
12549 | dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), | |
12550 | dl_install_xsub(), bootstrap() | |
639f8edf HS |
12551 | |
12552 | =item AUTHOR | |
12553 | ||
12554 | =back | |
12555 | ||
12556 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
12557 | Perl code | |
12558 | ||
12559 | =over 4 | |
12560 | ||
12561 | =item SYNOPSIS | |
12562 | ||
12563 | =item DESCRIPTION | |
12564 | ||
12565 | =over 4 | |
12566 | ||
12567 | =item Migration from C<DynaLoader> | |
12568 | ||
12569 | =item Backward compatible boilerplate | |
12570 | ||
12571 | =back | |
12572 | ||
12573 | =item Order of initialization: early load() | |
12574 | ||
12575 | =over 4 | |
12576 | ||
12577 | =item The most hairy case | |
12578 | ||
12579 | =back | |
12580 | ||
12581 | =item LIMITATIONS | |
12582 | ||
12583 | =item AUTHOR | |
12584 | ||
12585 | =back | |
12586 | ||
91331b4f JH |
12587 | =head2 Encode - character encodings |
12588 | ||
d420ca49 | 12589 | =over 4 |
91331b4f | 12590 | |
2d967e39 JH |
12591 | =item SYNOPSIS |
12592 | ||
e993db8c JH |
12593 | =over 4 |
12594 | ||
12595 | =item Table of Contents | |
12596 | ||
12597 | =back | |
12598 | ||
2d967e39 JH |
12599 | =item DESCRIPTION |
12600 | ||
e993db8c JH |
12601 | =over 4 |
12602 | ||
12603 | =item TERMINOLOGY | |
12604 | ||
12605 | =back | |
12606 | ||
2d967e39 JH |
12607 | =item PERL ENCODING API |
12608 | ||
95fb7f7f JH |
12609 | $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, |
12610 | $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, | |
12611 | CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, | |
12612 | CHECK]); | |
e993db8c | 12613 | |
2d967e39 JH |
12614 | =over 4 |
12615 | ||
e993db8c | 12616 | =item Listing available encodings |
91331b4f | 12617 | |
e993db8c JH |
12618 | =item Defining Aliases |
12619 | ||
12620 | =back | |
12621 | ||
95fb7f7f | 12622 | =item Encoding via PerlIO |
fa1c7b03 | 12623 | |
91331b4f JH |
12624 | =item Handling Malformed Data |
12625 | ||
e4bb216d NC |
12626 | B<NOTE:> Not all encoding suppport this feature, I<CHECK> = |
12627 | Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> = | |
12628 | Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> = | |
12629 | Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML | |
12630 | charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask | |
95fb7f7f JH |
12631 | |
12632 | =over 4 | |
12633 | ||
12634 | =item Unimplemented fallback schemes | |
12635 | ||
12636 | =back | |
12637 | ||
fc6a272d JH |
12638 | =item Defining Encodings |
12639 | ||
95fb7f7f JH |
12640 | =item The UTF-8 flag |
12641 | ||
12642 | Goal #1:, Goal #2:, Goal #3:, Goal #4: | |
12643 | ||
12644 | =over 4 | |
12645 | ||
2d967e39 JH |
12646 | =item Messing with Perl's Internals |
12647 | ||
fa1c7b03 | 12648 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) |
2d967e39 | 12649 | |
95fb7f7f JH |
12650 | =back |
12651 | ||
fa1c7b03 | 12652 | =item SEE ALSO |
2d967e39 | 12653 | |
95fb7f7f JH |
12654 | =item MAINTAINER |
12655 | ||
fa1c7b03 JH |
12656 | =back |
12657 | ||
639f8edf HS |
12658 | =head2 Encode::Alias - alias definitions to encodings |
12659 | ||
12660 | =over 4 | |
12661 | ||
12662 | =item SYNOPSIS | |
12663 | ||
12664 | =item DESCRIPTION | |
12665 | ||
12666 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
12667 | reference, e.g.: | |
12668 | ||
12669 | =over 4 | |
12670 | ||
12671 | =item Alias overloading | |
12672 | ||
12673 | =back | |
12674 | ||
12675 | =item SEE ALSO | |
12676 | ||
12677 | =back | |
12678 | ||
e993db8c | 12679 | =head2 Encode::Byte - Single Byte Encodings |
fe9287c4 | 12680 | |
80327a3d JH |
12681 | =over 4 |
12682 | ||
e993db8c | 12683 | =item SYNOPSIS |
fa1c7b03 | 12684 | |
e993db8c | 12685 | =item ABSTRACT |
80327a3d | 12686 | |
e993db8c | 12687 | =item DESCRIPTION |
80327a3d | 12688 | |
e993db8c | 12689 | =item SEE ALSO |
80327a3d | 12690 | |
e993db8c | 12691 | =back |
80327a3d | 12692 | |
639f8edf HS |
12693 | =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* |
12694 | ||
e993db8c | 12695 | =head2 Encode::CN - China-based Chinese Encodings |
80327a3d | 12696 | |
e993db8c | 12697 | =over 4 |
fa1c7b03 | 12698 | |
e993db8c | 12699 | =item SYNOPSIS |
fa1c7b03 | 12700 | |
e993db8c | 12701 | =item DESCRIPTION |
fa1c7b03 | 12702 | |
e993db8c | 12703 | =item NOTES |
fa1c7b03 | 12704 | |
e993db8c | 12705 | =item BUGS |
fa1c7b03 | 12706 | |
e993db8c | 12707 | =item SEE ALSO |
80327a3d JH |
12708 | |
12709 | =back | |
12710 | ||
639f8edf HS |
12711 | =head2 Encode::CN::HZ -- internally used by Encode::CN |
12712 | ||
12713 | =head2 Encode::Config -- internally used by Encode | |
12714 | ||
e993db8c | 12715 | =head2 Encode::EBCDIC - EBCDIC Encodings |
fe9287c4 | 12716 | |
e993db8c | 12717 | =over 4 |
80327a3d | 12718 | |
e993db8c | 12719 | =item SYNOPSIS |
80327a3d | 12720 | |
e993db8c | 12721 | =item ABSTRACT |
80327a3d | 12722 | |
e993db8c | 12723 | =item DESCRIPTION |
fa1c7b03 | 12724 | |
e993db8c | 12725 | =item SEE ALSO |
80327a3d JH |
12726 | |
12727 | =back | |
12728 | ||
639f8edf HS |
12729 | =head2 Encode::Encoding - Encode Implementation Base Class |
12730 | ||
12731 | =over 4 | |
12732 | ||
12733 | =item SYNOPSIS | |
12734 | ||
12735 | =item DESCRIPTION | |
12736 | ||
12737 | =over 4 | |
12738 | ||
12739 | =item Methods you should implement | |
12740 | ||
12741 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), | |
12742 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) | |
12743 | ||
12744 | =item Other methods defined in Encode::Encodings | |
12745 | ||
e4bb216d NC |
12746 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
12747 | -E<gt>needs_lines() | |
639f8edf HS |
12748 | |
12749 | =item Example: Encode::ROT13 | |
12750 | ||
12751 | =back | |
12752 | ||
12753 | =item Why the heck Encode API is different? | |
12754 | ||
12755 | =over 4 | |
12756 | ||
12757 | =item Compiled Encodings | |
12758 | ||
12759 | =back | |
12760 | ||
12761 | =item SEE ALSO | |
12762 | ||
12763 | Scheme 1, Scheme 2, Other Schemes | |
12764 | ||
12765 | =back | |
12766 | ||
12767 | =head2 Encode::Guess -- Guesses encoding from data | |
12768 | ||
12769 | =over 4 | |
12770 | ||
12771 | =item SYNOPSIS | |
12772 | ||
12773 | =item ABSTRACT | |
12774 | ||
12775 | =item DESCRIPTION | |
12776 | ||
12777 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
12778 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
12779 | guess_encoding($data, [, I<list of suspects>]) | |
12780 | ||
12781 | =item CAVEATS | |
12782 | ||
12783 | =item TO DO | |
12784 | ||
12785 | =item SEE ALSO | |
12786 | ||
12787 | =back | |
12788 | ||
e993db8c | 12789 | =head2 Encode::JP - Japanese Encodings |
80327a3d JH |
12790 | |
12791 | =over 4 | |
12792 | ||
12793 | =item SYNOPSIS | |
12794 | ||
e993db8c | 12795 | =item ABSTRACT |
80327a3d | 12796 | |
e993db8c | 12797 | =item DESCRIPTION |
fa1c7b03 | 12798 | |
e993db8c | 12799 | =item Note on ISO-2022-JP(-1)? |
fa1c7b03 | 12800 | |
e993db8c | 12801 | =item BUGS |
fa1c7b03 | 12802 | |
e993db8c | 12803 | =item SEE ALSO |
fa1c7b03 JH |
12804 | |
12805 | =back | |
80327a3d | 12806 | |
639f8edf HS |
12807 | =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* |
12808 | ||
12809 | =head2 Encode::JP::JIS7 -- internally used by Encode::JP | |
12810 | ||
95fb7f7f JH |
12811 | =head2 Encode::KR - Korean Encodings |
12812 | ||
12813 | =over 4 | |
12814 | ||
639f8edf HS |
12815 | =item SYNOPSIS |
12816 | ||
12817 | =item DESCRIPTION | |
12818 | ||
12819 | =item BUGS | |
12820 | ||
12821 | =item SEE ALSO | |
12822 | ||
12823 | =back | |
12824 | ||
12825 | =head2 Encode::KR::2022_KR -- internally used by Encode::KR | |
12826 | ||
12827 | =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding | |
12828 | ||
12829 | =over 4 | |
12830 | ||
12831 | =item SYNOPSIS | |
12832 | ||
12833 | =item ABSTRACT | |
12834 | ||
12835 | =item DESCRIPTION | |
12836 | ||
12837 | =item BUGS | |
12838 | ||
12839 | =item SEE ALSO | |
12840 | ||
12841 | =back | |
12842 | ||
12843 | =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO | |
12844 | ||
12845 | =over 4 | |
12846 | ||
12847 | =item Overview | |
12848 | ||
12849 | =item How does it work? | |
12850 | ||
12851 | =item Line Buffering | |
12852 | ||
12853 | =over 4 | |
12854 | ||
12855 | =item How can I tell whether my encoding fully supports PerlIO ? | |
12856 | ||
12857 | =back | |
12858 | ||
12859 | =item SEE ALSO | |
12860 | ||
12861 | =back | |
12862 | ||
12863 | =head2 Encode::Supported -- Encodings supported by Encode | |
12864 | ||
12865 | =over 4 | |
12866 | ||
12867 | =item DESCRIPTION | |
12868 | ||
12869 | =over 4 | |
12870 | ||
12871 | =item Encoding Names | |
12872 | ||
12873 | =back | |
12874 | ||
12875 | =item Supported Encodings | |
12876 | ||
12877 | =over 4 | |
12878 | ||
12879 | =item Built-in Encodings | |
12880 | ||
12881 | =item Encode::Unicode -- other Unicode encodings | |
12882 | ||
12883 | =item Encode::Byte -- Extended ASCII | |
12884 | ||
12885 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
12886 | the Cyrillic world, gsm0338 - Hentai Latin 1 | |
12887 | ||
12888 | =item CJK: Chinese, Japanese, Korean (Multibyte) | |
12889 | ||
12890 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
12891 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, | |
12892 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
12893 | ||
12894 | =item Miscellaneous encodings | |
12895 | ||
12896 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess | |
12897 | ||
12898 | =back | |
12899 | ||
12900 | =item Unsupported encodings | |
12901 | ||
12902 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, | |
12903 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
12904 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
12905 | Various Mac encodings, (Mac) Indic encodings | |
12906 | ||
12907 | =item Encoding vs. Charset -- terminology | |
12908 | ||
12909 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
12910 | ||
12911 | =over 4 | |
12912 | ||
12913 | =item Microsoft-related naming mess | |
12914 | ||
12915 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
12916 | ||
12917 | =back | |
12918 | ||
12919 | =item Glossary | |
12920 | ||
12921 | character repertoire, coded character set (CCS), character encoding scheme | |
12922 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, | |
12923 | UTF-16 | |
12924 | ||
12925 | =item See Also | |
12926 | ||
12927 | =item References | |
12928 | ||
12929 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, | |
12930 | RFC, UC, Unicode Glossary | |
12931 | ||
12932 | =over 4 | |
12933 | ||
12934 | =item Other Notable Sites | |
95fb7f7f | 12935 | |
639f8edf HS |
12936 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: |
12937 | "Introduction to i18n" | |
95fb7f7f | 12938 | |
639f8edf | 12939 | =item Offline sources |
95fb7f7f | 12940 | |
639f8edf HS |
12941 | C<CJKV Information Processing> by Ken Lunde |
12942 | ||
12943 | =back | |
95fb7f7f JH |
12944 | |
12945 | =back | |
12946 | ||
e993db8c JH |
12947 | =head2 Encode::Symbol - Symbol Encodings |
12948 | ||
12949 | =over 4 | |
12950 | ||
12951 | =item SYNOPSIS | |
12952 | ||
12953 | =item ABSTRACT | |
12954 | ||
12955 | =item DESCRIPTION | |
12956 | ||
12957 | =item SEE ALSO | |
12958 | ||
12959 | =back | |
12960 | ||
12961 | =head2 Encode::TW - Taiwan-based Chinese Encodings | |
12962 | ||
12963 | =over 4 | |
12964 | ||
12965 | =item SYNOPSIS | |
12966 | ||
12967 | =item DESCRIPTION | |
12968 | ||
12969 | =item NOTES | |
12970 | ||
12971 | =item BUGS | |
12972 | ||
12973 | =item SEE ALSO | |
12974 | ||
12975 | =back | |
12976 | ||
95fb7f7f | 12977 | =head2 Encode::Unicode -- Various Unicode Transformation Formats |
e993db8c | 12978 | |
d8416318 JH |
12979 | =over 4 |
12980 | ||
12981 | =item SYNOPSIS | |
12982 | ||
12983 | =item ABSTRACT | |
12984 | ||
12985 | L<http://www.unicode.org/glossary/> says:, Quick Reference | |
12986 | ||
12987 | =item Size, Endianness, and BOM | |
12988 | ||
12989 | =over 4 | |
e993db8c | 12990 | |
95fb7f7f | 12991 | =item by size |
e993db8c | 12992 | |
95fb7f7f | 12993 | =item by endianness |
d8416318 JH |
12994 | |
12995 | BOM as integer when fetched in network byte order | |
12996 | ||
12997 | =back | |
12998 | ||
12999 | =item Surrogate Pairs | |
13000 | ||
e4bb216d NC |
13001 | =item Error Checking |
13002 | ||
d8416318 JH |
13003 | =item SEE ALSO |
13004 | ||
13005 | =back | |
13006 | ||
639f8edf HS |
13007 | =head2 Encode::Unicode::UTF7 -- UTF-7 encoding |
13008 | ||
13009 | =over 4 | |
13010 | ||
13011 | =item SYNOPSIS | |
13012 | ||
13013 | =item ABSTRACT | |
13014 | ||
13015 | =item In Practice | |
13016 | ||
13017 | =item SEE ALSO | |
13018 | ||
13019 | =back | |
13020 | ||
d8416318 | 13021 | =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to |
e993db8c JH |
13022 | encodings |
13023 | ||
13024 | =over 4 | |
13025 | ||
13026 | =item SYNOPSIS | |
13027 | ||
13028 | =item DESCRIPTION | |
13029 | ||
13030 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
13031 | reference, e.g.: | |
13032 | ||
13033 | =over 4 | |
13034 | ||
95fb7f7f | 13035 | =item Alias overloading |
e993db8c JH |
13036 | |
13037 | =back | |
13038 | ||
13039 | =item SEE ALSO | |
13040 | ||
13041 | =back | |
13042 | ||
2a551100 | 13043 | =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- |
e993db8c JH |
13044 | Internally used by Encode::??::ISO_2022_* |
13045 | ||
13046 | =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by | |
13047 | Encode::CN | |
13048 | ||
95fb7f7f JH |
13049 | =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by |
13050 | Encode | |
13051 | ||
e993db8c JH |
13052 | =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode |
13053 | Implementation Base Class | |
13054 | ||
13055 | =over 4 | |
13056 | ||
13057 | =item SYNOPSIS | |
13058 | ||
13059 | =item DESCRIPTION | |
13060 | ||
95fb7f7f JH |
13061 | =over 4 |
13062 | ||
13063 | =item Methods you should implement | |
13064 | ||
2a551100 JH |
13065 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), |
13066 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) | |
95fb7f7f JH |
13067 | |
13068 | =item Other methods defined in Encode::Encodings | |
13069 | ||
e4bb216d NC |
13070 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
13071 | -E<gt>needs_lines() | |
95fb7f7f JH |
13072 | |
13073 | =item Example: Encode::ROT13 | |
13074 | ||
13075 | =back | |
13076 | ||
13077 | =item Why the heck Encode API is different? | |
e993db8c JH |
13078 | |
13079 | =over 4 | |
13080 | ||
13081 | =item Compiled Encodings | |
13082 | ||
13083 | =back | |
13084 | ||
13085 | =item SEE ALSO | |
13086 | ||
d8416318 | 13087 | Scheme 1, Scheme 2, Other Schemes |
e993db8c | 13088 | |
d8416318 | 13089 | =back |
e993db8c | 13090 | |
95fb7f7f JH |
13091 | =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from |
13092 | data | |
13093 | ||
13094 | =over 4 | |
13095 | ||
13096 | =item SYNOPSIS | |
13097 | ||
13098 | =item ABSTRACT | |
13099 | ||
13100 | =item DESCRIPTION | |
13101 | ||
13102 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
13103 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
13104 | guess_encoding($data, [, I<list of suspects>]) | |
13105 | ||
13106 | =item CAVEATS | |
13107 | ||
849d92fd JH |
13108 | =item TO DO |
13109 | ||
95fb7f7f JH |
13110 | =item SEE ALSO |
13111 | ||
13112 | =back | |
13113 | ||
e993db8c JH |
13114 | =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by |
13115 | Encode::JP::2022_JP* | |
13116 | ||
d8416318 JH |
13117 | =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used |
13118 | by Encode::JP | |
e993db8c | 13119 | |
95fb7f7f JH |
13120 | =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally |
13121 | used by Encode::KR | |
13122 | ||
13123 | =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' | |
13124 | and 'Q' header encoding | |
13125 | ||
13126 | =over 4 | |
13127 | ||
13128 | =item SYNOPSIS | |
13129 | ||
13130 | =item ABSTRACT | |
13131 | ||
13132 | =item DESCRIPTION | |
13133 | ||
13134 | =item BUGS | |
13135 | ||
13136 | =item SEE ALSO | |
13137 | ||
13138 | =back | |
13139 | ||
13140 | =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document | |
13141 | on Encode and PerlIO | |
13142 | ||
13143 | =over 4 | |
13144 | ||
13145 | =item Overview | |
13146 | ||
13147 | =item How does it work? | |
13148 | ||
2a551100 | 13149 | =item Line Buffering |
95fb7f7f JH |
13150 | |
13151 | =over 4 | |
13152 | ||
95fb7f7f JH |
13153 | =item How can I tell whether my encoding fully supports PerlIO ? |
13154 | ||
13155 | =back | |
13156 | ||
13157 | =item SEE ALSO | |
13158 | ||
13159 | =back | |
13160 | ||
13161 | =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings | |
13162 | supported by Encode | |
e993db8c JH |
13163 | |
13164 | =over 4 | |
13165 | ||
13166 | =item DESCRIPTION | |
13167 | ||
13168 | =over 4 | |
13169 | ||
13170 | =item Encoding Names | |
13171 | ||
13172 | =back | |
13173 | ||
13174 | =item Supported Encodings | |
13175 | ||
13176 | =over 4 | |
13177 | ||
13178 | =item Built-in Encodings | |
13179 | ||
d8416318 JH |
13180 | =item Encode::Unicode -- other Unicode encodings |
13181 | ||
e993db8c JH |
13182 | =item Encode::Byte -- Extended ASCII |
13183 | ||
13184 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
95fb7f7f | 13185 | the Cyrillic world, gsm0338 - Hentai Latin 1 |
e993db8c | 13186 | |
95fb7f7f | 13187 | =item CJK: Chinese, Japanese, Korean (Multibyte) |
e993db8c JH |
13188 | |
13189 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
849d92fd JH |
13190 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, |
13191 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
e993db8c JH |
13192 | |
13193 | =item Miscellaneous encodings | |
13194 | ||
849d92fd | 13195 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess |
e993db8c JH |
13196 | |
13197 | =back | |
13198 | ||
13199 | =item Unsupported encodings | |
13200 | ||
95fb7f7f JH |
13201 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, |
13202 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
13203 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
13204 | Various Mac encodings, (Mac) Indic encodings | |
e993db8c JH |
13205 | |
13206 | =item Encoding vs. Charset -- terminology | |
13207 | ||
13208 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
13209 | ||
13210 | =over 4 | |
13211 | ||
13212 | =item Microsoft-related naming mess | |
13213 | ||
13214 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
13215 | ||
13216 | =back | |
13217 | ||
13218 | =item Glossary | |
13219 | ||
13220 | character repertoire, coded character set (CCS), character encoding scheme | |
d8416318 JH |
13221 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, |
13222 | UTF-16 | |
e993db8c JH |
13223 | |
13224 | =item See Also | |
13225 | ||
13226 | =item References | |
13227 | ||
95fb7f7f | 13228 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, |
e993db8c JH |
13229 | RFC, UC, Unicode Glossary |
13230 | ||
13231 | =over 4 | |
13232 | ||
13233 | =item Other Notable Sites | |
13234 | ||
95fb7f7f JH |
13235 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: |
13236 | "Introduction to i18n" | |
d8416318 JH |
13237 | |
13238 | =item Offline sources | |
13239 | ||
13240 | C<CJKV Information Processing> by Ken Lunde | |
e993db8c JH |
13241 | |
13242 | =back | |
13243 | ||
13244 | =back | |
13245 | ||
8b9c797b JH |
13246 | =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 |
13247 | encoding | |
13248 | ||
13249 | =over 4 | |
13250 | ||
13251 | =item SYNOPSIS | |
13252 | ||
13253 | =item ABSTRACT | |
13254 | ||
13255 | =item In Practice | |
13256 | ||
13257 | =item SEE ALSO | |
13258 | ||
13259 | =back | |
13260 | ||
d8416318 JH |
13261 | =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder |
13262 | ||
13263 | =over 4 | |
13264 | ||
13265 | =item SYNOPSIS | |
13266 | ||
d8416318 JH |
13267 | =item ABSTRACT |
13268 | ||
13269 | =item Description | |
13270 | ||
13271 | =over 4 | |
e993db8c | 13272 | |
d8416318 | 13273 | =item Predefined Methods |
e993db8c | 13274 | |
d8416318 JH |
13275 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), |
13276 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
13277 | $e-E<gt>bytes([$encoding]) | |
13278 | ||
13279 | =item Example: base64 transcoder | |
13280 | ||
95fb7f7f | 13281 | =item Operator Overloading |
d8416318 JH |
13282 | |
13283 | =back | |
13284 | ||
13285 | =item SEE ALSO | |
13286 | ||
13287 | =back | |
e993db8c | 13288 | |
95fb7f7f JH |
13289 | =head2 Encodencoding, encoding - allows you to write your script in |
13290 | non-ascii or non-utf8 | |
e993db8c JH |
13291 | |
13292 | =over 4 | |
13293 | ||
13294 | =item SYNOPSIS | |
13295 | ||
13296 | =item ABSTRACT | |
13297 | ||
2a551100 JH |
13298 | =over 4 |
13299 | ||
13300 | =item Literal Conversions | |
13301 | ||
13302 | =item PerlIO layers for C<STD(IN|OUT)> | |
13303 | ||
f262848d RGS |
13304 | =item Implicit upgrading for byte strings |
13305 | ||
2a551100 JH |
13306 | =back |
13307 | ||
13308 | =item FEATURES THAT REQUIRE 5.8.1 | |
13309 | ||
13310 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle | |
13311 | ||
e993db8c JH |
13312 | =item USAGE |
13313 | ||
d8416318 | 13314 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> |
2a551100 JH |
13315 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; |
13316 | ||
13317 | =item The Filter Option | |
13318 | ||
13319 | =over 4 | |
13320 | ||
13321 | =item Filter-related changes at Encode version 1.87 | |
13322 | ||
13323 | =back | |
e993db8c JH |
13324 | |
13325 | =item CAVEATS | |
13326 | ||
13327 | =over 4 | |
13328 | ||
13329 | =item NOT SCOPED | |
13330 | ||
13331 | =item DO NOT MIX MULTIPLE ENCODINGS | |
13332 | ||
2a551100 | 13333 | =item tr/// with ranges |
e993db8c | 13334 | |
2a551100 | 13335 | Legend of characters above |
d8416318 | 13336 | |
2a551100 | 13337 | =back |
d8416318 | 13338 | |
e993db8c JH |
13339 | =item EXAMPLE - Greekperl |
13340 | ||
13341 | =item KNOWN PROBLEMS | |
13342 | ||
2a551100 JH |
13343 | literals in regex that are longer than 127 bytes, EBCDIC, format |
13344 | ||
e4bb216d NC |
13345 | =over 4 |
13346 | ||
13347 | =item The Logic of :locale | |
13348 | ||
13349 | =back | |
13350 | ||
2a551100 JH |
13351 | =item HISTORY |
13352 | ||
e993db8c | 13353 | =item SEE ALSO |
694468e3 | 13354 | |
a45bd81d GS |
13355 | =back |
13356 | ||
639f8edf HS |
13357 | =head2 Encoder, Encode::Encoder -- Object Oriented Encoder |
13358 | ||
13359 | =over 4 | |
13360 | ||
13361 | =item SYNOPSIS | |
13362 | ||
13363 | =item ABSTRACT | |
13364 | ||
13365 | =item Description | |
13366 | ||
13367 | =over 4 | |
13368 | ||
13369 | =item Predefined Methods | |
13370 | ||
13371 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), | |
13372 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
13373 | $e-E<gt>bytes([$encoding]) | |
13374 | ||
13375 | =item Example: base64 transcoder | |
13376 | ||
13377 | =item Operator Overloading | |
13378 | ||
13379 | =back | |
13380 | ||
13381 | =item SEE ALSO | |
13382 | ||
13383 | =back | |
13384 | ||
fa1c7b03 JH |
13385 | =head2 English - use nice English (or awk) names for ugly punctuation |
13386 | variables | |
cb1a09d0 | 13387 | |
d420ca49 | 13388 | =over 4 |
a45bd81d | 13389 | |
cb1a09d0 AD |
13390 | =item SYNOPSIS |
13391 | ||
cb1a09d0 AD |
13392 | =item DESCRIPTION |
13393 | ||
fa1c7b03 | 13394 | =item PERFORMANCE |
cb1a09d0 | 13395 | |
a45bd81d GS |
13396 | =back |
13397 | ||
b6235c4f RGS |
13398 | =head2 Env - perl module that imports environment variables as scalars or |
13399 | arrays | |
e993db8c JH |
13400 | |
13401 | =over 4 | |
13402 | ||
13403 | =item SYNOPSIS | |
13404 | ||
13405 | =item DESCRIPTION | |
13406 | ||
b6235c4f | 13407 | =item LIMITATIONS |
e993db8c JH |
13408 | |
13409 | =item AUTHOR | |
13410 | ||
e993db8c JH |
13411 | =back |
13412 | ||
639f8edf HS |
13413 | =head2 Errno - System errno constants |
13414 | ||
13415 | =over 4 | |
13416 | ||
13417 | =item SYNOPSIS | |
13418 | ||
13419 | =item DESCRIPTION | |
13420 | ||
13421 | =item CAVEATS | |
13422 | ||
13423 | =item AUTHOR | |
13424 | ||
13425 | =item COPYRIGHT | |
13426 | ||
13427 | =back | |
13428 | ||
8ebc5c01 | 13429 | =head2 Exporter - Implements default import method for modules |
cb1a09d0 | 13430 | |
d420ca49 | 13431 | =over 4 |
a45bd81d | 13432 | |
8ebc5c01 | 13433 | =item SYNOPSIS |
cb1a09d0 | 13434 | |
8ebc5c01 | 13435 | =item DESCRIPTION |
cb1a09d0 | 13436 | |
d420ca49 | 13437 | =over 4 |
cb1a09d0 | 13438 | |
c76ac1ee GS |
13439 | =item How to Export |
13440 | ||
8ebc5c01 | 13441 | =item Selecting What To Export |
cb1a09d0 | 13442 | |
f502af34 JH |
13443 | =item How to Import |
13444 | ||
13445 | C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> | |
13446 | ||
13447 | =back | |
13448 | ||
13449 | =item Advanced features | |
13450 | ||
13451 | =over 4 | |
13452 | ||
8ebc5c01 | 13453 | =item Specialised Import Lists |
cb1a09d0 | 13454 | |
f502af34 | 13455 | =item Exporting without using Exporter's import method |
d516a115 | 13456 | |
f262848d RGS |
13457 | =item Exporting without inheriting from Exporter |
13458 | ||
8ebc5c01 | 13459 | =item Module Version Checking |
cb1a09d0 | 13460 | |
8ebc5c01 | 13461 | =item Managing Unknown Symbols |
cb1a09d0 | 13462 | |
8ebc5c01 | 13463 | =item Tag Handling Utility Functions |
cb1a09d0 | 13464 | |
80637b95 JH |
13465 | =item Generating combined tags |
13466 | ||
248e172a JH |
13467 | =item C<AUTOLOAD>ed Constants |
13468 | ||
8ebc5c01 | 13469 | =back |
cb1a09d0 | 13470 | |
a45bd81d GS |
13471 | =back |
13472 | ||
c76ac1ee GS |
13473 | =head2 Exporter::Heavy - Exporter guts |
13474 | ||
d420ca49 | 13475 | =over 4 |
a45bd81d | 13476 | |
04b01f78 | 13477 | =item SYNOPSIS |
c76ac1ee GS |
13478 | |
13479 | =item DESCRIPTION | |
13480 | ||
a45bd81d GS |
13481 | =back |
13482 | ||
68dc0745 | 13483 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
13484 | Makefiles etc. | |
13485 | ||
d420ca49 | 13486 | =over 4 |
a45bd81d | 13487 | |
dc848c6f | 13488 | =item SYNOPSIS |
68dc0745 | 13489 | |
13490 | =item DESCRIPTION | |
13491 | ||
a45bd81d GS |
13492 | =back |
13493 | ||
13494 | cat | |
13495 | ||
13496 | eqtime src dst | |
13497 | ||
e61ecf27 | 13498 | rm_rf files... |
a45bd81d GS |
13499 | |
13500 | rm_f files... | |
13501 | ||
13502 | touch files .. | |
13503 | ||
13504 | mv source... destination | |
13505 | ||
13506 | cp source... destination | |
13507 | ||
13508 | chmod mode files.. | |
13509 | ||
13510 | mkpath directory.. | |
13511 | ||
13512 | test_f file | |
13513 | ||
2baadb76 RGS |
13514 | dos2unix |
13515 | ||
d420ca49 | 13516 | =over 4 |
68dc0745 | 13517 | |
13518 | =item BUGS | |
13519 | ||
13520 | =item SEE ALSO | |
13521 | ||
13522 | =item AUTHOR | |
13523 | ||
a45bd81d GS |
13524 | =back |
13525 | ||
e993db8c JH |
13526 | =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles |
13527 | ||
13528 | =over 4 | |
13529 | ||
13530 | =item SYNOPSIS | |
13531 | ||
13532 | =item DESCRIPTION | |
13533 | ||
13534 | B<test_harness> | |
13535 | ||
13536 | =back | |
13537 | ||
2a551100 JH |
13538 | B<pod2man> |
13539 | ||
13540 | B<warn_if_old_packlist> | |
13541 | ||
13542 | B<perllocal_install> | |
13543 | ||
13544 | B<uninstall> | |
13545 | ||
772ff3b9 JH |
13546 | =head2 ExtUtils::Constant - generate XS code to import C header constants |
13547 | ||
13548 | =over 4 | |
13549 | ||
13550 | =item SYNOPSIS | |
13551 | ||
13552 | =item DESCRIPTION | |
13553 | ||
13554 | =item USAGE | |
13555 | ||
35bf961c | 13556 | IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF |
772ff3b9 JH |
13557 | |
13558 | =item FUNCTIONS | |
13559 | ||
13560 | =back | |
13561 | ||
13562 | C_stringify NAME | |
13563 | ||
fa1c7b03 JH |
13564 | perl_stringify NAME |
13565 | ||
772ff3b9 JH |
13566 | constant_types |
13567 | ||
13568 | memEQ_clause NAME, CHECKED_AT, INDENT | |
13569 | ||
9038e305 | 13570 | assign INDENT, TYPE, PRE, POST, VALUE.. |
2ef53570 | 13571 | |
4f233aa4 | 13572 | return_clause |
772ff3b9 | 13573 | |
ac4dd294 JH |
13574 | switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. |
13575 | ||
772ff3b9 JH |
13576 | params WHAT |
13577 | ||
ac4dd294 | 13578 | dump_names |
2ef53570 | 13579 | |
35bf961c JH |
13580 | dogfood |
13581 | ||
9038e305 | 13582 | C_constant, name, type, value, macro, default, pre, post, def_pre =item |
fa1c7b03 | 13583 | def_post, utf8 |
772ff3b9 JH |
13584 | |
13585 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME | |
13586 | ||
2ef53570 | 13587 | autoload PACKAGE, VERSION, AUTOLOADER |
772ff3b9 | 13588 | |
35bf961c JH |
13589 | WriteMakefileSnippet |
13590 | ||
9038e305 JH |
13591 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, |
13592 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME | |
13593 | ||
772ff3b9 JH |
13594 | =over 4 |
13595 | ||
13596 | =item AUTHOR | |
13597 | ||
13598 | =back | |
13599 | ||
8ebc5c01 | 13600 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
cb1a09d0 | 13601 | |
d420ca49 | 13602 | =over 4 |
a45bd81d | 13603 | |
cb1a09d0 AD |
13604 | =item SYNOPSIS |
13605 | ||
cb1a09d0 AD |
13606 | =item DESCRIPTION |
13607 | ||
8ebc5c01 | 13608 | =item @EXPORT |
cb1a09d0 | 13609 | |
8ebc5c01 | 13610 | =item FUNCTIONS |
cb1a09d0 | 13611 | |
8ebc5c01 | 13612 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
13613 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
cb1a09d0 | 13614 | |
8ebc5c01 | 13615 | =item EXAMPLES |
cb1a09d0 | 13616 | |
8ebc5c01 | 13617 | =item SEE ALSO |
cb1a09d0 | 13618 | |
8ebc5c01 | 13619 | =item AUTHOR |
cb1a09d0 | 13620 | |
a45bd81d GS |
13621 | =back |
13622 | ||
8ebc5c01 | 13623 | =head2 ExtUtils::Install - install files from here to there |
cb1a09d0 | 13624 | |
d420ca49 | 13625 | =over 4 |
a45bd81d | 13626 | |
8ebc5c01 | 13627 | =item SYNOPSIS |
cb1a09d0 | 13628 | |
8ebc5c01 | 13629 | =item DESCRIPTION |
cb1a09d0 | 13630 | |
2a551100 JH |
13631 | =over 4 |
13632 | ||
13633 | =item Functions | |
13634 | ||
13635 | B<install> | |
13636 | ||
13637 | =back | |
13638 | ||
13639 | =back | |
13640 | ||
13641 | B<install_default> I<DISCOURAGED> | |
13642 | ||
13643 | B<uninstall> | |
13644 | ||
13645 | B<pm_to_blib> | |
13646 | ||
13647 | _autosplit | |
13648 | ||
13649 | =over 4 | |
13650 | ||
13651 | =item ENVIRONMENT | |
13652 | ||
13653 | B<PERL_INSTALL_ROOT> | |
13654 | ||
13655 | =item AUTHOR | |
13656 | ||
13657 | =item LICENSE | |
13658 | ||
a45bd81d GS |
13659 | =back |
13660 | ||
193fb0af GS |
13661 | =head2 ExtUtils::Installed - Inventory management of installed modules |
13662 | ||
d420ca49 | 13663 | =over 4 |
a45bd81d | 13664 | |
193fb0af GS |
13665 | =item SYNOPSIS |
13666 | ||
13667 | =item DESCRIPTION | |
13668 | ||
13669 | =item USAGE | |
13670 | ||
13671 | =item FUNCTIONS | |
13672 | ||
13673 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
13674 | packlist(), version() | |
13675 | ||
fb9cefb4 GS |
13676 | =item EXAMPLE |
13677 | ||
193fb0af GS |
13678 | =item AUTHOR |
13679 | ||
a45bd81d GS |
13680 | =back |
13681 | ||
8ebc5c01 | 13682 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
cb1a09d0 | 13683 | |
d420ca49 | 13684 | =over 4 |
a45bd81d | 13685 | |
8ebc5c01 | 13686 | =item SYNOPSIS |
cb1a09d0 | 13687 | |
8ebc5c01 | 13688 | =item DESCRIPTION |
cb1a09d0 | 13689 | |
e993db8c JH |
13690 | For static extensions, For dynamic extensions at build/link time, For |
13691 | dynamic extensions at load time | |
cb1a09d0 | 13692 | |
d420ca49 | 13693 | =over 4 |
cb1a09d0 | 13694 | |
8ebc5c01 | 13695 | =item EXTRALIBS |
cb1a09d0 | 13696 | |
8ebc5c01 | 13697 | =item LDLOADLIBS and LD_RUN_PATH |
cb1a09d0 | 13698 | |
8ebc5c01 | 13699 | =item BSLOADLIBS |
cb1a09d0 | 13700 | |
8ebc5c01 | 13701 | =back |
cb1a09d0 | 13702 | |
8ebc5c01 | 13703 | =item PORTABILITY |
cb1a09d0 | 13704 | |
d420ca49 | 13705 | =over 4 |
cb1a09d0 | 13706 | |
8ebc5c01 | 13707 | =item VMS implementation |
cb1a09d0 | 13708 | |
3e3baf6d TB |
13709 | =item Win32 implementation |
13710 | ||
8ebc5c01 | 13711 | =back |
cb1a09d0 | 13712 | |
8ebc5c01 | 13713 | =item SEE ALSO |
cb1a09d0 | 13714 | |
a45bd81d GS |
13715 | =back |
13716 | ||
e993db8c JH |
13717 | =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass |
13718 | ||
13719 | =over 4 | |
13720 | ||
13721 | =item SYNOPSIS | |
13722 | ||
13723 | =item DESCRIPTION | |
13724 | ||
13725 | =back | |
13726 | ||
5538b230 | 13727 | =head2 ExtUtils::MM_Any - Platform-agnostic MM methods |
e993db8c JH |
13728 | |
13729 | =over 4 | |
13730 | ||
13731 | =item SYNOPSIS | |
13732 | ||
13733 | =item DESCRIPTION | |
13734 | ||
13735 | =item Inherently Cross-Platform Methods | |
13736 | ||
0d53b15f | 13737 | installvars |
2a551100 JH |
13738 | |
13739 | =back | |
13740 | ||
0d53b15f JH |
13741 | os_flavor_is |
13742 | ||
df344c0f NC |
13743 | dir_target B<DEPRECATED> |
13744 | ||
2baadb76 RGS |
13745 | blibdirs_target (o) |
13746 | ||
e993db8c JH |
13747 | =over 4 |
13748 | ||
2a551100 | 13749 | =item File::Spec wrappers |
e993db8c | 13750 | |
2a551100 | 13751 | catfile |
e993db8c JH |
13752 | |
13753 | =back | |
13754 | ||
2a551100 JH |
13755 | =over 4 |
13756 | ||
13757 | =item Thought To Be Cross-Platform Methods | |
13758 | ||
13759 | B<split_command> | |
13760 | ||
e993db8c JH |
13761 | =back |
13762 | ||
2a551100 | 13763 | B<echo> |
e993db8c | 13764 | |
2a551100 | 13765 | init_VERSION |
e993db8c | 13766 | |
2a551100 | 13767 | wraplist |
e993db8c | 13768 | |
2a551100 | 13769 | manifypods |
e993db8c | 13770 | |
2a551100 | 13771 | manifypods_target |
e993db8c | 13772 | |
2a551100 | 13773 | makemakerdflt_target |
e993db8c | 13774 | |
2a551100 JH |
13775 | special_targets |
13776 | ||
30487ceb | 13777 | POD2MAN_macro |
2a551100 JH |
13778 | |
13779 | test_via_harness | |
13780 | ||
13781 | test_via_script | |
13782 | ||
13783 | libscan | |
13784 | ||
13785 | tool_autosplit | |
13786 | ||
13787 | all_target | |
13788 | ||
13789 | metafile_target | |
13790 | ||
639f8edf HS |
13791 | signature_target |
13792 | ||
2a551100 | 13793 | metafile_addtomanifest_target |
e993db8c | 13794 | |
639f8edf HS |
13795 | signature_addtomanifest_target |
13796 | ||
e993db8c JH |
13797 | =over 4 |
13798 | ||
2a551100 | 13799 | =item Abstract methods |
e993db8c | 13800 | |
2a551100 JH |
13801 | oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len, |
13802 | B<init_others>, init_DIRFILESEP, init_linker, init_platform, | |
13803 | platform_constants | |
e993db8c JH |
13804 | |
13805 | =back | |
13806 | ||
2a551100 | 13807 | os_flavor |
e993db8c JH |
13808 | |
13809 | =over 4 | |
13810 | ||
13811 | =item AUTHOR | |
13812 | ||
13813 | =back | |
13814 | ||
f502af34 JH |
13815 | =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in |
13816 | ExtUtils::MakeMaker | |
13817 | ||
13818 | =over 4 | |
13819 | ||
13820 | =item SYNOPSIS | |
13821 | ||
13822 | =item DESCRIPTION | |
13823 | ||
13824 | =back | |
13825 | ||
2a551100 JH |
13826 | os_flavor (o) |
13827 | ||
13828 | init_linker | |
f502af34 | 13829 | |
14218588 GS |
13830 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
13831 | ExtUtils::MakeMaker | |
13832 | ||
d420ca49 | 13833 | =over 4 |
a45bd81d | 13834 | |
14218588 GS |
13835 | =item SYNOPSIS |
13836 | ||
13837 | =item DESCRIPTION | |
13838 | ||
2a551100 | 13839 | os_flavor (o) |
14218588 | 13840 | |
a45bd81d GS |
13841 | =back |
13842 | ||
2a551100 JH |
13843 | cflags (o) |
13844 | ||
13845 | replace_manpage_separator (o) | |
13846 | ||
13847 | init_linker | |
13848 | ||
e993db8c | 13849 | =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix |
9038e305 JH |
13850 | |
13851 | =over 4 | |
13852 | ||
13853 | =item SYNOPSIS | |
13854 | ||
13855 | =item DESCRIPTION | |
13856 | ||
e993db8c | 13857 | =over 4 |
9038e305 | 13858 | |
e993db8c | 13859 | =item Overridden methods |
9038e305 | 13860 | |
2a551100 | 13861 | os_flavor |
9038e305 | 13862 | |
e993db8c | 13863 | =back |
9038e305 | 13864 | |
e993db8c | 13865 | =back |
9038e305 | 13866 | |
2a551100 JH |
13867 | B<replace_manpage_separator> |
13868 | ||
e993db8c | 13869 | =over 4 |
9038e305 | 13870 | |
e993db8c | 13871 | =item AUTHOR |
9038e305 | 13872 | |
e993db8c | 13873 | =item SEE ALSO |
9038e305 | 13874 | |
e993db8c | 13875 | =back |
9038e305 | 13876 | |
df344c0f | 13877 | =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic |
849d92fd JH |
13878 | |
13879 | =over 4 | |
13880 | ||
13881 | =item SYNOPSIS | |
13882 | ||
13883 | =item DESCRIPTION | |
13884 | ||
13885 | =back | |
13886 | ||
e993db8c JH |
13887 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in |
13888 | ExtUtils::MakeMaker | |
9038e305 | 13889 | |
e993db8c | 13890 | =over 4 |
9038e305 | 13891 | |
e993db8c | 13892 | =item SYNOPSIS |
9038e305 | 13893 | |
e993db8c | 13894 | =item DESCRIPTION |
9038e305 | 13895 | |
e993db8c | 13896 | =back |
9038e305 | 13897 | |
2a551100 JH |
13898 | os_flavor |
13899 | ||
13900 | init_platform (o), platform_constants | |
13901 | ||
13902 | const_cccmd (o) | |
9038e305 | 13903 | |
849d92fd JH |
13904 | static_lib (o) |
13905 | ||
e993db8c | 13906 | dynamic_lib (o) |
9038e305 | 13907 | |
8ebc5c01 | 13908 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
13909 | ExtUtils::MakeMaker | |
cb1a09d0 | 13910 | |
d420ca49 | 13911 | =over 4 |
a45bd81d | 13912 | |
8ebc5c01 | 13913 | =item SYNOPSIS |
cb1a09d0 | 13914 | |
8ebc5c01 | 13915 | =item DESCRIPTION |
cb1a09d0 | 13916 | |
4d4e713d JH |
13917 | =item METHODS |
13918 | ||
2a551100 JH |
13919 | init_dist (o) |
13920 | ||
a45bd81d GS |
13921 | =back |
13922 | ||
2a551100 JH |
13923 | init_linker |
13924 | ||
13925 | os_flavor | |
4d4e713d | 13926 | |
e993db8c | 13927 | =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix |
cb1a09d0 | 13928 | |
d420ca49 | 13929 | =over 4 |
a45bd81d | 13930 | |
8ebc5c01 | 13931 | =item SYNOPSIS |
cb1a09d0 | 13932 | |
8ebc5c01 | 13933 | =item DESCRIPTION |
cb1a09d0 | 13934 | |
d420ca49 | 13935 | =over 4 |
cb1a09d0 | 13936 | |
e993db8c | 13937 | =item Overridden methods |
cb1a09d0 | 13938 | |
2a551100 | 13939 | os_flavor |
cb1a09d0 | 13940 | |
8ebc5c01 | 13941 | =back |
cb1a09d0 | 13942 | |
a45bd81d | 13943 | =back |
cb1a09d0 | 13944 | |
2a551100 JH |
13945 | B<replace_manpage_separator> |
13946 | ||
e993db8c | 13947 | =over 4 |
cb1a09d0 | 13948 | |
e993db8c | 13949 | =item AUTHOR |
cb1a09d0 | 13950 | |
e993db8c | 13951 | =item SEE ALSO |
cb1a09d0 | 13952 | |
e993db8c | 13953 | =back |
cb1a09d0 | 13954 | |
e993db8c JH |
13955 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
13956 | ||
13957 | =over 4 | |
13958 | ||
13959 | =item SYNOPSIS | |
13960 | ||
13961 | =item DESCRIPTION | |
13962 | ||
13963 | =item METHODS | |
13964 | ||
13965 | =back | |
cb1a09d0 | 13966 | |
d420ca49 | 13967 | =over 4 |
cb1a09d0 | 13968 | |
2a551100 | 13969 | =item Methods |
cb1a09d0 | 13970 | |
2a551100 | 13971 | os_flavor (o) |
cb1a09d0 | 13972 | |
8ebc5c01 | 13973 | =back |
cb1a09d0 | 13974 | |
2a551100 JH |
13975 | c_o (o) |
13976 | ||
a45bd81d | 13977 | cflags (o) |
68dc0745 | 13978 | |
a45bd81d | 13979 | clean (o) |
68dc0745 | 13980 | |
2a551100 JH |
13981 | clean_subdirs_target |
13982 | ||
a45bd81d | 13983 | const_cccmd (o) |
68dc0745 | 13984 | |
a45bd81d | 13985 | const_config (o) |
68dc0745 | 13986 | |
a45bd81d | 13987 | const_loadlibs (o) |
cb1a09d0 | 13988 | |
a45bd81d | 13989 | constants (o) |
cb1a09d0 | 13990 | |
a45bd81d | 13991 | depend (o) |
cb1a09d0 | 13992 | |
0d53b15f JH |
13993 | init_DEST |
13994 | ||
2a551100 JH |
13995 | init_dist |
13996 | ||
a45bd81d | 13997 | dist (o) |
cb1a09d0 | 13998 | |
a45bd81d | 13999 | dist_basics (o) |
cb1a09d0 | 14000 | |
a45bd81d | 14001 | dist_ci (o) |
cb1a09d0 | 14002 | |
a45bd81d | 14003 | dist_core (o) |
7d2bfb28 | 14004 | |
2a551100 JH |
14005 | B<dist_target> |
14006 | ||
14007 | B<tardist_target> | |
14008 | ||
14009 | B<zipdist_target> | |
14010 | ||
14011 | B<tarfile_target> | |
14012 | ||
14013 | zipfile_target | |
14014 | ||
14015 | uutardist_target | |
14016 | ||
14017 | shdist_target | |
14018 | ||
14019 | distdir | |
7d2bfb28 | 14020 | |
e993db8c | 14021 | dist_test |
7d2bfb28 | 14022 | |
a45bd81d | 14023 | dlsyms (o) |
7d2bfb28 | 14024 | |
a45bd81d | 14025 | dynamic (o) |
7d2bfb28 | 14026 | |
a45bd81d | 14027 | dynamic_bs (o) |
7d2bfb28 | 14028 | |
a45bd81d | 14029 | dynamic_lib (o) |
7d2bfb28 | 14030 | |
a45bd81d | 14031 | exescan |
cb1a09d0 | 14032 | |
a45bd81d | 14033 | extliblist |
cb1a09d0 | 14034 | |
a45bd81d | 14035 | find_perl |
cb1a09d0 | 14036 | |
95fb7f7f JH |
14037 | find_tests |
14038 | ||
d420ca49 | 14039 | =over 4 |
cb1a09d0 | 14040 | |
a45bd81d | 14041 | =item Methods to actually produce chunks of text for the Makefile |
cb1a09d0 | 14042 | |
a45bd81d | 14043 | fixin |
cb1a09d0 | 14044 | |
a45bd81d | 14045 | =back |
cb1a09d0 | 14046 | |
a45bd81d | 14047 | force (o) |
d516a115 | 14048 | |
a45bd81d | 14049 | guess_name |
cb1a09d0 | 14050 | |
a45bd81d | 14051 | has_link_code |
14218588 | 14052 | |
a45bd81d | 14053 | init_dirscan |
cb1a09d0 | 14054 | |
2a551100 JH |
14055 | init_DIRFILESEP |
14056 | ||
a45bd81d | 14057 | init_main |
cb1a09d0 | 14058 | |
a45bd81d | 14059 | init_others |
cb1a09d0 | 14060 | |
e993db8c JH |
14061 | init_INST |
14062 | ||
14063 | init_INSTALL | |
14064 | ||
2a551100 JH |
14065 | init_linker |
14066 | ||
95fb7f7f JH |
14067 | init_lib2arch |
14068 | ||
e993db8c JH |
14069 | init_PERL |
14070 | ||
2a551100 JH |
14071 | init_platform (o), platform_constants (o) |
14072 | ||
e993db8c JH |
14073 | init_PERM |
14074 | ||
2a551100 JH |
14075 | init_xs |
14076 | ||
a45bd81d | 14077 | install (o) |
cb1a09d0 | 14078 | |
a45bd81d | 14079 | installbin (o) |
cb1a09d0 | 14080 | |
a45bd81d | 14081 | linkext (o) |
cb1a09d0 | 14082 | |
a45bd81d | 14083 | lsdir |
cb1a09d0 | 14084 | |
a45bd81d | 14085 | macro (o) |
cb1a09d0 | 14086 | |
a45bd81d | 14087 | makeaperl (o) |
cb1a09d0 | 14088 | |
a45bd81d | 14089 | makefile (o) |
cb1a09d0 | 14090 | |
a45bd81d | 14091 | maybe_command |
14218588 | 14092 | |
a45bd81d | 14093 | needs_linking (o) |
14218588 | 14094 | |
a45bd81d | 14095 | nicetext |
14218588 | 14096 | |
a45bd81d | 14097 | parse_abstract |
cb1a09d0 | 14098 | |
e993db8c | 14099 | parse_version |
cb1a09d0 | 14100 | |
e993db8c | 14101 | pasthru (o) |
cb1a09d0 | 14102 | |
a45bd81d | 14103 | perl_script |
cb1a09d0 | 14104 | |
a45bd81d | 14105 | perldepend (o) |
402d0d99 | 14106 | |
a45bd81d | 14107 | perm_rw (o) |
402d0d99 | 14108 | |
a45bd81d | 14109 | perm_rwx (o) |
402d0d99 | 14110 | |
a45bd81d | 14111 | pm_to_blib |
193fb0af | 14112 | |
a45bd81d | 14113 | post_constants (o) |
193fb0af | 14114 | |
a45bd81d | 14115 | post_initialize (o) |
193fb0af | 14116 | |
a45bd81d | 14117 | postamble (o) |
193fb0af | 14118 | |
e993db8c JH |
14119 | ppd |
14120 | ||
a45bd81d | 14121 | prefixify |
193fb0af | 14122 | |
a45bd81d | 14123 | processPL (o) |
193fb0af | 14124 | |
cb52f95f JH |
14125 | quote_paren |
14126 | ||
a45bd81d | 14127 | realclean (o) |
fb9cefb4 | 14128 | |
2a551100 JH |
14129 | realclean_subdirs_target |
14130 | ||
a45bd81d | 14131 | replace_manpage_separator |
193fb0af | 14132 | |
2a551100 JH |
14133 | oneliner (o) |
14134 | ||
14135 | quote_literal | |
14136 | ||
14137 | escape_newlines | |
14138 | ||
14139 | max_exec_len | |
14140 | ||
a45bd81d | 14141 | static (o) |
cb1a09d0 | 14142 | |
a45bd81d GS |
14143 | static_lib (o) |
14144 | ||
14145 | staticmake (o) | |
14146 | ||
14147 | subdir_x (o) | |
14148 | ||
14149 | subdirs (o) | |
14150 | ||
14151 | test (o) | |
14152 | ||
e993db8c | 14153 | test_via_harness (override) |
a45bd81d | 14154 | |
e993db8c | 14155 | test_via_script (override) |
a45bd81d | 14156 | |
a45bd81d GS |
14157 | tools_other (o) |
14158 | ||
14159 | tool_xsubpp (o) | |
14160 | ||
2a551100 JH |
14161 | all_target |
14162 | ||
a45bd81d GS |
14163 | top_targets (o) |
14164 | ||
14165 | writedoc | |
14166 | ||
14167 | xs_c (o) | |
14168 | ||
14169 | xs_cpp (o) | |
14170 | ||
14171 | xs_o (o) | |
14172 | ||
d420ca49 | 14173 | =over 4 |
a45bd81d GS |
14174 | |
14175 | =item SEE ALSO | |
14176 | ||
14177 | =back | |
14178 | ||
14179 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
14180 | ExtUtils::MakeMaker | |
14181 | ||
d420ca49 | 14182 | =over 4 |
a45bd81d GS |
14183 | |
14184 | =item SYNOPSIS | |
14185 | ||
14186 | =item DESCRIPTION | |
14187 | ||
d420ca49 | 14188 | =over 4 |
a45bd81d GS |
14189 | |
14190 | =item Methods always loaded | |
14191 | ||
14192 | wraplist | |
14193 | ||
14194 | =back | |
14195 | ||
14196 | =back | |
14197 | ||
d420ca49 | 14198 | =over 4 |
a45bd81d | 14199 | |
e993db8c | 14200 | =item Methods |
a45bd81d GS |
14201 | |
14202 | guess_name (override) | |
14203 | ||
14204 | =back | |
14205 | ||
14206 | find_perl (override) | |
14207 | ||
a45bd81d GS |
14208 | maybe_command (override) |
14209 | ||
a45bd81d GS |
14210 | perl_script (override) |
14211 | ||
a45bd81d GS |
14212 | replace_manpage_separator |
14213 | ||
0d53b15f JH |
14214 | init_DEST |
14215 | ||
2a551100 JH |
14216 | init_DIRFILESEP |
14217 | ||
e993db8c JH |
14218 | init_main (override) |
14219 | ||
a45bd81d GS |
14220 | init_others (override) |
14221 | ||
2a551100 JH |
14222 | init_platform (override) |
14223 | ||
14224 | platform_constants | |
14225 | ||
14226 | init_VERSION (override) | |
14227 | ||
a45bd81d GS |
14228 | constants (override) |
14229 | ||
2a551100 JH |
14230 | special_targets |
14231 | ||
a45bd81d GS |
14232 | cflags (override) |
14233 | ||
14234 | const_cccmd (override) | |
14235 | ||
a45bd81d GS |
14236 | tool_sxubpp (override) |
14237 | ||
a45bd81d GS |
14238 | tools_other (override) |
14239 | ||
2a551100 | 14240 | init_dist (override) |
a45bd81d GS |
14241 | |
14242 | c_o (override) | |
14243 | ||
14244 | xs_c (override) | |
14245 | ||
14246 | xs_o (override) | |
14247 | ||
a45bd81d GS |
14248 | dlsyms (override) |
14249 | ||
14250 | dynamic_lib (override) | |
14251 | ||
14252 | dynamic_bs (override) | |
14253 | ||
14254 | static_lib (override) | |
14255 | ||
a45bd81d GS |
14256 | processPL (override) |
14257 | ||
14258 | installbin (override) | |
14259 | ||
14260 | subdir_x (override) | |
14261 | ||
14262 | clean (override) | |
14263 | ||
2a551100 JH |
14264 | clean_subdirs_target |
14265 | ||
a45bd81d GS |
14266 | realclean (override) |
14267 | ||
2a551100 | 14268 | zipfile_target (o), tarfile_target (o), shdist_target (o) |
a45bd81d | 14269 | |
a45bd81d GS |
14270 | dist_test (override) |
14271 | ||
14272 | install (override) | |
14273 | ||
14274 | perldepend (override) | |
14275 | ||
14276 | makefile (override) | |
14277 | ||
95fb7f7f JH |
14278 | find_tests (override) |
14279 | ||
a45bd81d GS |
14280 | test (override) |
14281 | ||
a45bd81d GS |
14282 | makeaperl (override) |
14283 | ||
14284 | nicetext (override) | |
14285 | ||
95fb7f7f JH |
14286 | prefixify (override) |
14287 | ||
2a551100 JH |
14288 | oneliner (o) |
14289 | ||
14290 | B<echo> (o) | |
14291 | ||
14292 | quote_literal | |
14293 | ||
14294 | escape_newlines | |
14295 | ||
14296 | max_exec_len | |
14297 | ||
14298 | init_linker (o) | |
14299 | ||
14300 | eliminate_macros | |
14301 | ||
14302 | fixpath | |
14303 | ||
14304 | os_flavor | |
14305 | ||
a45bd81d GS |
14306 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in |
14307 | ExtUtils::MakeMaker | |
14308 | ||
d420ca49 | 14309 | =over 4 |
a45bd81d GS |
14310 | |
14311 | =item SYNOPSIS | |
14312 | ||
14313 | =item DESCRIPTION | |
14314 | ||
14315 | =back | |
14316 | ||
2a551100 | 14317 | =over 4 |
a45bd81d | 14318 | |
2a551100 | 14319 | =item Overridden methods |
a45bd81d | 14320 | |
2a551100 | 14321 | B<dlsyms> |
a45bd81d | 14322 | |
2a551100 | 14323 | =back |
a45bd81d | 14324 | |
2a551100 | 14325 | replace_manpage_separator |
a45bd81d | 14326 | |
2a551100 | 14327 | B<maybe_command> |
a45bd81d | 14328 | |
2a551100 | 14329 | B<find_tests> |
a45bd81d | 14330 | |
2a551100 | 14331 | B<init_DIRFILESEP> |
a45bd81d | 14332 | |
2a551100 | 14333 | B<init_others> |
a45bd81d | 14334 | |
2a551100 | 14335 | init_platform (o), platform_constants (o) |
a45bd81d | 14336 | |
2a551100 | 14337 | special_targets (o) |
a45bd81d | 14338 | |
2a551100 | 14339 | static_lib (o) |
a45bd81d | 14340 | |
2a551100 JH |
14341 | dynamic_lib (o) |
14342 | ||
14343 | clean | |
14344 | ||
14345 | init_linker | |
14346 | ||
14347 | perl_script | |
14348 | ||
14349 | xs_o (o) | |
a45bd81d GS |
14350 | |
14351 | pasthru (o) | |
14352 | ||
2a551100 JH |
14353 | oneliner (o) |
14354 | ||
14355 | max_exec_len | |
14356 | ||
14357 | os_flavor | |
14358 | ||
849d92fd JH |
14359 | =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X |
14360 | ||
14361 | =over 4 | |
14362 | ||
14363 | =item SYNOPSIS | |
14364 | ||
14365 | =item DESCRIPTION | |
14366 | ||
2a551100 JH |
14367 | =over 4 |
14368 | ||
14369 | =item Overriden methods | |
14370 | ||
14371 | dist_test | |
14372 | ||
14373 | =back | |
14374 | ||
14375 | =back | |
14376 | ||
14377 | subdir_x | |
14378 | ||
14379 | xs_c | |
14380 | ||
14381 | xs_cpp | |
14382 | ||
14383 | xs_o | |
14384 | ||
14385 | clean_subdirs_target | |
14386 | ||
14387 | realclean_subdirs_target | |
14388 | ||
2e038148 NC |
14389 | max_exec_len |
14390 | ||
2a551100 JH |
14391 | os_flavor |
14392 | ||
14393 | =over 4 | |
14394 | ||
14395 | =item AUTHOR | |
14396 | ||
849d92fd JH |
14397 | =back |
14398 | ||
e993db8c JH |
14399 | =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization |
14400 | ||
14401 | =over 4 | |
14402 | ||
14403 | =item SYNOPSIS | |
14404 | ||
14405 | =item DESCRIPTION | |
14406 | ||
14407 | =back | |
14408 | ||
2a551100 | 14409 | =head2 ExtUtils::MakeMaker - Create a module Makefile |
a45bd81d | 14410 | |
d420ca49 | 14411 | =over 4 |
a45bd81d GS |
14412 | |
14413 | =item SYNOPSIS | |
14414 | ||
14415 | =item DESCRIPTION | |
14416 | ||
d420ca49 | 14417 | =over 4 |
a45bd81d GS |
14418 | |
14419 | =item How To Write A Makefile.PL | |
14420 | ||
14421 | =item Default Makefile Behaviour | |
14422 | ||
14423 | =item make test | |
14424 | ||
14425 | =item make testdb | |
14426 | ||
14427 | =item make install | |
14428 | ||
14429 | =item PREFIX and LIB attribute | |
14430 | ||
14431 | =item AFS users | |
14432 | ||
14433 | =item Static Linking of a new Perl Binary | |
14434 | ||
14435 | =item Determination of Perl Library and Installation Locations | |
14436 | ||
14437 | =item Which architecture dependent directory? | |
14438 | ||
14439 | =item Using Attributes and Parameters | |
14440 | ||
53d7eaa8 | 14441 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, |
2a551100 JH |
14442 | CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, |
14443 | EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, | |
14444 | FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, | |
14445 | INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, | |
14446 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, | |
14447 | INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, | |
14448 | INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, | |
14449 | INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, | |
14450 | INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, | |
14451 | LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, | |
0d53b15f JH |
14452 | MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, |
14453 | OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, | |
14454 | PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, | |
14455 | PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, | |
14456 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, | |
639f8edf HS |
14457 | PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, |
14458 | VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION | |
a45bd81d GS |
14459 | |
14460 | =item Additional lowercase attributes | |
14461 | ||
0d53b15f JH |
14462 | clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, |
14463 | test, tool_autosplit | |
a45bd81d GS |
14464 | |
14465 | =item Overriding MakeMaker Methods | |
14466 | ||
033348ab JH |
14467 | =item The End Of Cargo Cult Programming |
14468 | ||
14469 | C<<MAN3PODS => ' '>> | |
14470 | ||
a45bd81d GS |
14471 | =item Hintsfile support |
14472 | ||
14473 | =item Distribution Support | |
14474 | ||
14475 | make distcheck, make skipcheck, make distclean, make manifest, | |
e993db8c JH |
14476 | make distdir, make disttest, make tardist, make dist, make |
14477 | uutardist, make shdist, make zipdist, make ci | |
a45bd81d | 14478 | |
0d53b15f JH |
14479 | =item Module Meta-Data |
14480 | ||
a45bd81d GS |
14481 | =item Disabling an extension |
14482 | ||
2a551100 JH |
14483 | =item Other Handy Functions |
14484 | ||
14485 | prompt | |
14486 | ||
a45bd81d GS |
14487 | =back |
14488 | ||
14489 | =item ENVIRONMENT | |
14490 | ||
1fdc5aa6 | 14491 | PERL_MM_OPT, PERL_MM_USE_DEFAULT |
a45bd81d GS |
14492 | |
14493 | =item SEE ALSO | |
14494 | ||
14495 | =item AUTHORS | |
14496 | ||
2a551100 JH |
14497 | =item LICENSE |
14498 | ||
a45bd81d GS |
14499 | =back |
14500 | ||
2a551100 JH |
14501 | =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About |
14502 | MakeMaker | |
14503 | ||
14504 | =over 4 | |
14505 | ||
14506 | =item DESCRIPTION | |
14507 | ||
14508 | =over 4 | |
14509 | ||
2e038148 NC |
14510 | =item Module Installation |
14511 | ||
14512 | How do I keep from installing man pages?, How do I use a module without | |
14513 | installing it? | |
14514 | ||
2a551100 JH |
14515 | =item Philosophy and History |
14516 | ||
2e038148 | 14517 | Why not just use <insert other build config tool here>?, What is |
2a551100 JH |
14518 | Module::Build and how does it relate to MakeMaker?, pure perl. no make, no |
14519 | shell commands, easier to customize, cleaner internals, less cruft | |
14520 | ||
8b9c797b JH |
14521 | =item Module Writing |
14522 | ||
0d53b15f JH |
14523 | How do I keep my $VERSION up to date without resetting it manually?, What's |
14524 | this F<META.yml> thing and how did it get in my F<MANIFEST>?! | |
8b9c797b | 14525 | |
2a551100 JH |
14526 | =item XS |
14527 | ||
14528 | How to I prevent "object version X.XX does not match bootstrap parameter | |
14529 | Y.YY" errors?, How do I make two or more XS files coexist in the same | |
14530 | directory? | |
14531 | ||
14532 | =back | |
14533 | ||
14534 | =item PATCHING | |
14535 | ||
14536 | =item AUTHOR | |
14537 | ||
14538 | =item SEE ALSO | |
14539 | ||
14540 | =back | |
14541 | ||
14542 | =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker | |
a45bd81d | 14543 | |
d420ca49 | 14544 | =over 4 |
a45bd81d GS |
14545 | |
14546 | =item SYNOPSIS | |
14547 | ||
14548 | =item DESCRIPTION | |
14549 | ||
2a551100 | 14550 | =over 4 |
a45bd81d | 14551 | |
2a551100 | 14552 | =item The Mantra |
a45bd81d | 14553 | |
2a551100 | 14554 | =item The Layout |
a45bd81d | 14555 | |
2a551100 JH |
14556 | Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, |
14557 | bin/ | |
a45bd81d | 14558 | |
2a551100 | 14559 | =back |
a45bd81d | 14560 | |
2a551100 | 14561 | =item SEE ALSO |
165c0277 | 14562 | |
2a551100 | 14563 | =back |
165c0277 | 14564 | |
2baadb76 | 14565 | =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm |
8b9c797b JH |
14566 | |
14567 | =over 4 | |
14568 | ||
14569 | =item SYNOPSIS | |
14570 | ||
14571 | =item DESCRIPTION | |
14572 | ||
14573 | =back | |
14574 | ||
2baadb76 | 14575 | =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm |
a45bd81d | 14576 | |
2a551100 JH |
14577 | =over 4 |
14578 | ||
14579 | =item SYNOPSIS | |
14580 | ||
14581 | =item DESCRIPTION | |
a45bd81d GS |
14582 | |
14583 | =back | |
14584 | ||
2a551100 | 14585 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file |
e993db8c JH |
14586 | |
14587 | =over 4 | |
14588 | ||
14589 | =item SYNOPSIS | |
14590 | ||
14591 | =item DESCRIPTION | |
14592 | ||
2a551100 JH |
14593 | =over 4 |
14594 | ||
14595 | =item Functions | |
14596 | ||
14597 | mkmanifest | |
14598 | ||
14599 | =back | |
14600 | ||
14601 | =back | |
14602 | ||
14603 | manifind | |
14604 | ||
14605 | manicheck | |
14606 | ||
14607 | filecheck | |
14608 | ||
14609 | fullcheck | |
14610 | ||
14611 | skipcheck | |
14612 | ||
14613 | maniread | |
14614 | ||
14615 | manicopy | |
14616 | ||
14617 | maniadd | |
14618 | ||
14619 | =over 4 | |
14620 | ||
14621 | =item MANIFEST | |
14622 | ||
14623 | =item MANIFEST.SKIP | |
14624 | ||
14625 | =item EXPORT_OK | |
14626 | ||
14627 | =item GLOBAL VARIABLES | |
14628 | ||
14629 | =back | |
14630 | ||
14631 | =over 4 | |
14632 | ||
14633 | =item DIAGNOSTICS | |
14634 | ||
14635 | C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, | |
14636 | C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> | |
14637 | ||
14638 | =item ENVIRONMENT | |
14639 | ||
14640 | B<PERL_MM_MANIFEST_DEBUG> | |
14641 | ||
e993db8c JH |
14642 | =item SEE ALSO |
14643 | ||
2a551100 JH |
14644 | =item AUTHOR |
14645 | ||
e993db8c JH |
14646 | =back |
14647 | ||
f99d9048 RGS |
14648 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c |
14649 | ||
14650 | =over 4 | |
14651 | ||
14652 | =item SYNOPSIS | |
14653 | ||
14654 | =item DESCRIPTION | |
14655 | ||
14656 | =item SEE ALSO | |
14657 | ||
14658 | =back | |
14659 | ||
a45bd81d GS |
14660 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader |
14661 | ||
d420ca49 | 14662 | =over 4 |
a45bd81d GS |
14663 | |
14664 | =item SYNOPSIS | |
cb1a09d0 | 14665 | |
8ebc5c01 | 14666 | =item DESCRIPTION |
402d0d99 | 14667 | |
a45bd81d GS |
14668 | =back |
14669 | ||
14670 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
14671 | extension | |
14672 | ||
d420ca49 | 14673 | =over 4 |
a45bd81d GS |
14674 | |
14675 | =item SYNOPSIS | |
14676 | ||
14677 | =item DESCRIPTION | |
14678 | ||
14679 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
14680 | ||
14681 | =item AUTHOR | |
14682 | ||
14683 | =item REVISION | |
14684 | ||
14685 | =back | |
14686 | ||
14687 | =head2 ExtUtils::Packlist - manage .packlist files | |
14688 | ||
d420ca49 | 14689 | =over 4 |
a45bd81d GS |
14690 | |
14691 | =item SYNOPSIS | |
14692 | ||
14693 | =item DESCRIPTION | |
14694 | ||
14695 | =item USAGE | |
14696 | ||
14697 | =item FUNCTIONS | |
14698 | ||
14699 | new(), read(), write(), validate(), packlist_file() | |
14700 | ||
14701 | =item EXAMPLE | |
14702 | ||
14703 | =item AUTHOR | |
14704 | ||
14705 | =back | |
14706 | ||
14707 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
14708 | ||
d420ca49 | 14709 | =over 4 |
a45bd81d GS |
14710 | |
14711 | =item SYNOPSIS | |
14712 | ||
14713 | =item DESCRIPTION | |
14714 | ||
14715 | =back | |
14716 | ||
d516a115 JH |
14717 | =head2 Fatal - replace functions with equivalents which succeed or die |
14718 | ||
d420ca49 | 14719 | =over 4 |
a45bd81d | 14720 | |
d516a115 JH |
14721 | =item SYNOPSIS |
14722 | ||
14723 | =item DESCRIPTION | |
14724 | ||
14725 | =item AUTHOR | |
14726 | ||
a45bd81d GS |
14727 | =back |
14728 | ||
8ebc5c01 | 14729 | =head2 Fcntl - load the C Fcntl.h defines |
cb1a09d0 | 14730 | |
d420ca49 | 14731 | =over 4 |
a45bd81d | 14732 | |
8ebc5c01 | 14733 | =item SYNOPSIS |
cb1a09d0 | 14734 | |
8ebc5c01 | 14735 | =item DESCRIPTION |
cb1a09d0 | 14736 | |
8ebc5c01 | 14737 | =item NOTE |
cb1a09d0 | 14738 | |
8ebc5c01 | 14739 | =item EXPORTED SYMBOLS |
cb1a09d0 | 14740 | |
a45bd81d GS |
14741 | =back |
14742 | ||
8ebc5c01 | 14743 | =head2 File::Basename, fileparse - split a pathname into pieces |
7d2bfb28 | 14744 | |
d420ca49 | 14745 | =over 4 |
a45bd81d | 14746 | |
7d2bfb28 | 14747 | =item SYNOPSIS |
14748 | ||
7d2bfb28 | 14749 | =item DESCRIPTION |
14750 | ||
8ebc5c01 | 14751 | fileparse_set_fstype, fileparse |
7d2bfb28 | 14752 | |
8ebc5c01 | 14753 | =item EXAMPLES |
7d2bfb28 | 14754 | |
8ebc5c01 | 14755 | C<basename>, C<dirname> |
7d2bfb28 | 14756 | |
a45bd81d GS |
14757 | =back |
14758 | ||
8ebc5c01 | 14759 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
cb1a09d0 | 14760 | |
d420ca49 | 14761 | =over 4 |
a45bd81d | 14762 | |
cb1a09d0 AD |
14763 | =item SYNOPSIS |
14764 | ||
cb1a09d0 AD |
14765 | =item DESCRIPTION |
14766 | ||
d8416318 JH |
14767 | =item AUTHOR |
14768 | ||
14769 | =item HISTORY | |
14770 | ||
a45bd81d GS |
14771 | =back |
14772 | ||
8ebc5c01 | 14773 | =head2 File::Compare - Compare files or filehandles |
cb1a09d0 | 14774 | |
d420ca49 | 14775 | =over 4 |
a45bd81d | 14776 | |
8ebc5c01 | 14777 | =item SYNOPSIS |
cb1a09d0 | 14778 | |
8ebc5c01 | 14779 | =item DESCRIPTION |
cb1a09d0 | 14780 | |
8ebc5c01 | 14781 | =item RETURN |
cb1a09d0 | 14782 | |
8ebc5c01 | 14783 | =item AUTHOR |
cb1a09d0 | 14784 | |
a45bd81d GS |
14785 | =back |
14786 | ||
8ebc5c01 | 14787 | =head2 File::Copy - Copy files or filehandles |
cb1a09d0 | 14788 | |
d420ca49 | 14789 | =over 4 |
a45bd81d | 14790 | |
8ebc5c01 | 14791 | =item SYNOPSIS |
cb1a09d0 | 14792 | |
8ebc5c01 | 14793 | =item DESCRIPTION |
cb1a09d0 | 14794 | |
d420ca49 | 14795 | =over 4 |
cb1a09d0 | 14796 | |
14218588 | 14797 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
cb1a09d0 | 14798 | |
8ebc5c01 | 14799 | rmscopy($from,$to[,$date_flag]) |
cb1a09d0 AD |
14800 | |
14801 | =back | |
14802 | ||
8ebc5c01 | 14803 | =item RETURN |
cb1a09d0 | 14804 | |
ac4dd294 JH |
14805 | =item NOTES |
14806 | ||
8ebc5c01 | 14807 | =item AUTHOR |
cb1a09d0 | 14808 | |
a45bd81d GS |
14809 | =back |
14810 | ||
3e3baf6d TB |
14811 | =head2 File::DosGlob - DOS like globbing and then some |
14812 | ||
d420ca49 | 14813 | =over 4 |
a45bd81d | 14814 | |
3e3baf6d TB |
14815 | =item SYNOPSIS |
14816 | ||
14817 | =item DESCRIPTION | |
14818 | ||
35bf961c JH |
14819 | =item NOTES |
14820 | ||
3e3baf6d TB |
14821 | =item EXPORTS (by request only) |
14822 | ||
14823 | =item BUGS | |
14824 | ||
14825 | =item AUTHOR | |
14826 | ||
14827 | =item HISTORY | |
14828 | ||
14829 | =item SEE ALSO | |
14830 | ||
a45bd81d GS |
14831 | =back |
14832 | ||
f502af34 | 14833 | =head2 File::Find - Traverse a directory tree. |
cb1a09d0 | 14834 | |
d420ca49 | 14835 | =over 4 |
a45bd81d | 14836 | |
8ebc5c01 | 14837 | =item SYNOPSIS |
cb1a09d0 | 14838 | |
8ebc5c01 | 14839 | =item DESCRIPTION |
cb1a09d0 | 14840 | |
f502af34 JH |
14841 | B<find>, B<finddepth> |
14842 | ||
14843 | =over 4 | |
14844 | ||
14845 | =item %options | |
14846 | ||
10862624 | 14847 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, |
5d80033a JH |
14848 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, |
14849 | C<untaint>, C<untaint_pattern>, C<untaint_skip> | |
a45bd81d | 14850 | |
f502af34 JH |
14851 | =item The wanted function |
14852 | ||
14853 | C<$File::Find::dir> is the current directory name,, C<$_> is the current | |
14854 | filename within that directory, C<$File::Find::name> is the complete | |
14855 | pathname to the file | |
14856 | ||
14857 | =back | |
14858 | ||
cb52f95f JH |
14859 | =item WARNINGS |
14860 | ||
a45bd81d GS |
14861 | =item CAVEAT |
14862 | ||
1fdc5aa6 JH |
14863 | $dont_use_nlink, symlinks |
14864 | ||
ac4dd294 JH |
14865 | =item NOTES |
14866 | ||
1400179b NC |
14867 | =item BUGS AND CAVEATS |
14868 | ||
9038e305 JH |
14869 | =item HISTORY |
14870 | ||
a45bd81d GS |
14871 | =back |
14872 | ||
14873 | =head2 File::Glob - Perl extension for BSD glob routine | |
d516a115 | 14874 | |
d420ca49 | 14875 | =over 4 |
a45bd81d GS |
14876 | |
14877 | =item SYNOPSIS | |
14878 | ||
14879 | =item DESCRIPTION | |
14880 | ||
41ca3a40 JH |
14881 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, |
14882 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, | |
14883 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> | |
a45bd81d GS |
14884 | |
14885 | =item DIAGNOSTICS | |
14886 | ||
14887 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
14888 | ||
14889 | =item NOTES | |
14890 | ||
14891 | =item AUTHOR | |
14892 | ||
14893 | =back | |
14894 | ||
14895 | =head2 File::Path - create or remove directory trees | |
14896 | ||
d420ca49 | 14897 | =over 4 |
cb1a09d0 | 14898 | |
8ebc5c01 | 14899 | =item SYNOPSIS |
7d2bfb28 | 14900 | |
14901 | =item DESCRIPTION | |
14902 | ||
8b9c797b JH |
14903 | =item DIAGNOSTICS |
14904 | ||
8ebc5c01 | 14905 | =item AUTHORS |
7d2bfb28 | 14906 | |
a45bd81d GS |
14907 | =back |
14908 | ||
fb9cefb4 GS |
14909 | =head2 File::Spec - portably perform operations on file names |
14910 | ||
d420ca49 | 14911 | =over 4 |
a45bd81d | 14912 | |
fb9cefb4 GS |
14913 | =item SYNOPSIS |
14914 | ||
14915 | =item DESCRIPTION | |
14916 | ||
53d7eaa8 JH |
14917 | =item METHODS |
14918 | ||
14919 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, | |
14920 | no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, | |
35bf961c | 14921 | splitdir, catpath(), abs2rel, rel2abs() |
53d7eaa8 | 14922 | |
fb9cefb4 GS |
14923 | =item SEE ALSO |
14924 | ||
e4bb216d | 14925 | =item AUTHOR |
fb9cefb4 | 14926 | |
a45bd81d GS |
14927 | =back |
14928 | ||
04b01f78 JH |
14929 | =head2 File::Spec::Cygwin - methods for Cygwin file specs |
14930 | ||
14931 | =over 4 | |
14932 | ||
14933 | =item SYNOPSIS | |
14934 | ||
14935 | =item DESCRIPTION | |
14936 | ||
14937 | =back | |
14938 | ||
2a551100 JH |
14939 | canonpath |
14940 | ||
14941 | file_name_is_absolute | |
14942 | ||
14943 | tmpdir (override) | |
14944 | ||
2cc61e15 DD |
14945 | =head2 File::Spec::Epoc - methods for Epoc file specs |
14946 | ||
14947 | =over 4 | |
14948 | ||
14949 | =item SYNOPSIS | |
14950 | ||
14951 | =item DESCRIPTION | |
14952 | ||
0d53b15f | 14953 | =item AUTHORS |
2cc61e15 | 14954 | |
fa1c7b03 | 14955 | =back |
2cc61e15 | 14956 | |
0d53b15f JH |
14957 | canonpath() |
14958 | ||
2cc61e15 DD |
14959 | =over 4 |
14960 | ||
14961 | =item SEE ALSO | |
14962 | ||
14963 | =back | |
14964 | ||
14218588 GS |
14965 | =head2 File::Spec::Functions - portably perform operations on file names |
14966 | ||
d420ca49 | 14967 | =over 4 |
a45bd81d | 14968 | |
14218588 GS |
14969 | =item SYNOPSIS |
14970 | ||
14971 | =item DESCRIPTION | |
14972 | ||
d420ca49 | 14973 | =over 4 |
14218588 GS |
14974 | |
14975 | =item Exports | |
14976 | ||
14977 | =back | |
14978 | ||
14979 | =item SEE ALSO | |
14980 | ||
a45bd81d GS |
14981 | =back |
14982 | ||
35bf961c | 14983 | =head2 File::Spec::Mac - File::Spec for Mac OS (Classic) |
fb9cefb4 | 14984 | |
d420ca49 | 14985 | =over 4 |
a45bd81d | 14986 | |
fb9cefb4 GS |
14987 | =item SYNOPSIS |
14988 | ||
14989 | =item DESCRIPTION | |
14990 | ||
14991 | =item METHODS | |
14992 | ||
a45bd81d GS |
14993 | canonpath |
14994 | ||
14995 | =back | |
14996 | ||
35bf961c | 14997 | catdir() |
a45bd81d GS |
14998 | |
14999 | catfile | |
15000 | ||
15001 | curdir | |
15002 | ||
15003 | devnull | |
15004 | ||
15005 | rootdir | |
15006 | ||
15007 | tmpdir | |
15008 | ||
15009 | updir | |
15010 | ||
15011 | file_name_is_absolute | |
15012 | ||
15013 | path | |
15014 | ||
694468e3 GS |
15015 | splitpath |
15016 | ||
15017 | splitdir | |
15018 | ||
1fdc5aa6 | 15019 | catpath |
694468e3 GS |
15020 | |
15021 | abs2rel | |
15022 | ||
15023 | rel2abs | |
15024 | ||
d420ca49 | 15025 | =over 4 |
fb9cefb4 | 15026 | |
35bf961c JH |
15027 | =item AUTHORS |
15028 | ||
fb9cefb4 GS |
15029 | =item SEE ALSO |
15030 | ||
a45bd81d GS |
15031 | =back |
15032 | ||
fb9cefb4 GS |
15033 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
15034 | ||
d420ca49 | 15035 | =over 4 |
a45bd81d | 15036 | |
fb9cefb4 GS |
15037 | =item SYNOPSIS |
15038 | ||
15039 | =item DESCRIPTION | |
15040 | ||
d53e588d JH |
15041 | tmpdir, splitpath |
15042 | ||
a45bd81d GS |
15043 | =back |
15044 | ||
53d7eaa8 JH |
15045 | =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec |
15046 | modules | |
fb9cefb4 | 15047 | |
d420ca49 | 15048 | =over 4 |
a45bd81d | 15049 | |
fb9cefb4 GS |
15050 | =item SYNOPSIS |
15051 | ||
15052 | =item DESCRIPTION | |
15053 | ||
15054 | =item METHODS | |
15055 | ||
35bf961c | 15056 | canonpath() |
a45bd81d GS |
15057 | |
15058 | =back | |
15059 | ||
35bf961c | 15060 | catdir() |
a45bd81d GS |
15061 | |
15062 | catfile | |
15063 | ||
15064 | curdir | |
15065 | ||
15066 | devnull | |
15067 | ||
15068 | rootdir | |
15069 | ||
15070 | tmpdir | |
15071 | ||
15072 | updir | |
15073 | ||
15074 | no_upwards | |
15075 | ||
694468e3 GS |
15076 | case_tolerant |
15077 | ||
a45bd81d GS |
15078 | file_name_is_absolute |
15079 | ||
15080 | path | |
15081 | ||
15082 | join | |
15083 | ||
15084 | splitpath | |
15085 | ||
15086 | splitdir | |
15087 | ||
35bf961c | 15088 | catpath() |
a45bd81d GS |
15089 | |
15090 | abs2rel | |
15091 | ||
35bf961c | 15092 | rel2abs() |
a45bd81d | 15093 | |
d420ca49 | 15094 | =over 4 |
fb9cefb4 GS |
15095 | |
15096 | =item SEE ALSO | |
15097 | ||
a45bd81d GS |
15098 | =back |
15099 | ||
fb9cefb4 GS |
15100 | =head2 File::Spec::VMS - methods for VMS file specs |
15101 | ||
d420ca49 | 15102 | =over 4 |
a45bd81d | 15103 | |
fb9cefb4 GS |
15104 | =item SYNOPSIS |
15105 | ||
15106 | =item DESCRIPTION | |
15107 | ||
a45bd81d GS |
15108 | eliminate_macros |
15109 | ||
15110 | =back | |
15111 | ||
15112 | fixpath | |
c76ac1ee | 15113 | |
d420ca49 | 15114 | =over 4 |
fb9cefb4 GS |
15115 | |
15116 | =item Methods always loaded | |
15117 | ||
694468e3 | 15118 | canonpath (override) |
fb9cefb4 GS |
15119 | |
15120 | =back | |
15121 | ||
694468e3 GS |
15122 | catdir |
15123 | ||
a45bd81d GS |
15124 | catfile |
15125 | ||
15126 | curdir (override) | |
15127 | ||
15128 | devnull (override) | |
15129 | ||
15130 | rootdir (override) | |
15131 | ||
15132 | tmpdir (override) | |
15133 | ||
15134 | updir (override) | |
15135 | ||
694468e3 GS |
15136 | case_tolerant (override) |
15137 | ||
a45bd81d GS |
15138 | path (override) |
15139 | ||
15140 | file_name_is_absolute (override) | |
15141 | ||
694468e3 GS |
15142 | splitpath (override) |
15143 | ||
15144 | splitdir (override) | |
15145 | ||
15146 | catpath (override) | |
15147 | ||
37590e52 GS |
15148 | abs2rel (override) |
15149 | ||
15150 | rel2abs (override) | |
15151 | ||
d420ca49 | 15152 | =over 4 |
a45bd81d | 15153 | |
14218588 GS |
15154 | =item SEE ALSO |
15155 | ||
a45bd81d GS |
15156 | =back |
15157 | ||
fb9cefb4 GS |
15158 | =head2 File::Spec::Win32 - methods for Win32 file specs |
15159 | ||
d420ca49 | 15160 | =over 4 |
a45bd81d | 15161 | |
fb9cefb4 GS |
15162 | =item SYNOPSIS |
15163 | ||
15164 | =item DESCRIPTION | |
15165 | ||
a45bd81d GS |
15166 | devnull |
15167 | ||
15168 | =back | |
15169 | ||
15170 | tmpdir | |
15171 | ||
15172 | catfile | |
15173 | ||
15174 | canonpath | |
15175 | ||
15176 | splitpath | |
15177 | ||
15178 | splitdir | |
15179 | ||
15180 | catpath | |
15181 | ||
d420ca49 | 15182 | =over 4 |
a45bd81d | 15183 | |
033348ab JH |
15184 | =item Note For File::Spec::Win32 Maintainers |
15185 | ||
15186 | =back | |
15187 | ||
15188 | =over 4 | |
15189 | ||
14218588 | 15190 | =item SEE ALSO |
fb9cefb4 | 15191 | |
a45bd81d GS |
15192 | =back |
15193 | ||
d722968f JH |
15194 | =head2 File::Temp - return name and handle of a temporary file safely |
15195 | ||
d420ca49 | 15196 | =over 4 |
d722968f | 15197 | |
a9ef4385 JH |
15198 | =item PORTABILITY |
15199 | ||
d722968f JH |
15200 | =item SYNOPSIS |
15201 | ||
15202 | =item DESCRIPTION | |
15203 | ||
15204 | =back | |
15205 | ||
d420ca49 | 15206 | =over 4 |
d722968f | 15207 | |
41630250 JH |
15208 | =item OO INTERFACE |
15209 | ||
15210 | B<new> | |
15211 | ||
15212 | =back | |
15213 | ||
15214 | B<filename> | |
15215 | ||
15216 | B<DESTROY> | |
15217 | ||
15218 | =over 4 | |
15219 | ||
d722968f JH |
15220 | =item FUNCTIONS |
15221 | ||
15222 | B<tempfile> | |
15223 | ||
15224 | =back | |
15225 | ||
15226 | B<tempdir> | |
15227 | ||
d420ca49 | 15228 | =over 4 |
d722968f JH |
15229 | |
15230 | =item MKTEMP FUNCTIONS | |
15231 | ||
15232 | B<mkstemp> | |
15233 | ||
15234 | =back | |
15235 | ||
15236 | B<mkstemps> | |
15237 | ||
15238 | B<mkdtemp> | |
15239 | ||
15240 | B<mktemp> | |
15241 | ||
d420ca49 | 15242 | =over 4 |
d722968f JH |
15243 | |
15244 | =item POSIX FUNCTIONS | |
15245 | ||
15246 | B<tmpnam> | |
15247 | ||
15248 | =back | |
15249 | ||
15250 | B<tmpfile> | |
15251 | ||
d420ca49 | 15252 | =over 4 |
d722968f JH |
15253 | |
15254 | =item ADDITIONAL FUNCTIONS | |
15255 | ||
15256 | B<tempnam> | |
15257 | ||
15258 | =back | |
15259 | ||
d420ca49 | 15260 | =over 4 |
d722968f JH |
15261 | |
15262 | =item UTILITY FUNCTIONS | |
15263 | ||
15264 | B<unlink0> | |
15265 | ||
15266 | =back | |
15267 | ||
41630250 JH |
15268 | B<cmpstat> |
15269 | ||
15270 | B<unlink1> | |
15271 | ||
d420ca49 | 15272 | =over 4 |
d722968f JH |
15273 | |
15274 | =item PACKAGE VARIABLES | |
15275 | ||
15276 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
15277 | ||
15278 | =back | |
15279 | ||
15280 | TopSystemUID | |
15281 | ||
d420ca49 | 15282 | =over 4 |
d722968f JH |
15283 | |
15284 | =item WARNING | |
15285 | ||
165c0277 JH |
15286 | =over 4 |
15287 | ||
15288 | =item Temporary files and NFS | |
15289 | ||
15290 | =back | |
15291 | ||
4755096e GS |
15292 | =item HISTORY |
15293 | ||
15294 | =item SEE ALSO | |
15295 | ||
15296 | =item AUTHOR | |
15297 | ||
15298 | =back | |
15299 | ||
15300 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
15301 | ||
d420ca49 | 15302 | =over 4 |
4755096e GS |
15303 | |
15304 | =item SYNOPSIS | |
15305 | ||
15306 | =item DESCRIPTION | |
15307 | ||
a44e0ddd JH |
15308 | =item BUGS |
15309 | ||
4755096e GS |
15310 | =item NOTE |
15311 | ||
15312 | =item AUTHOR | |
15313 | ||
15314 | =back | |
15315 | ||
15316 | =head2 FileCache - keep more files open than the system permits | |
15317 | ||
d420ca49 | 15318 | =over 4 |
4755096e GS |
15319 | |
15320 | =item SYNOPSIS | |
15321 | ||
15322 | =item DESCRIPTION | |
15323 | ||
d8416318 JH |
15324 | cacheout EXPR, cacheout MODE, EXPR |
15325 | ||
15326 | =item CAVEATS | |
15327 | ||
4755096e GS |
15328 | =item BUGS |
15329 | ||
15330 | =back | |
15331 | ||
15332 | =head2 FileHandle - supply object methods for filehandles | |
15333 | ||
d420ca49 | 15334 | =over 4 |
4755096e GS |
15335 | |
15336 | =item SYNOPSIS | |
15337 | ||
15338 | =item DESCRIPTION | |
15339 | ||
15340 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
15341 | ||
15342 | =item SEE ALSO | |
15343 | ||
15344 | =back | |
15345 | ||
165c0277 JH |
15346 | =head2 Filter::Simple - Simplified source filtering |
15347 | ||
15348 | =over 4 | |
15349 | ||
15350 | =item SYNOPSIS | |
15351 | ||
15352 | =item DESCRIPTION | |
15353 | ||
15354 | =over 4 | |
15355 | ||
15356 | =item The Problem | |
15357 | ||
15358 | =item A Solution | |
15359 | ||
1fa7ca25 JH |
15360 | =item Disabling or changing <no> behaviour |
15361 | ||
15362 | =item All-in-one interface | |
15363 | ||
07fcf8ff JH |
15364 | =item Filtering only specific components of source code |
15365 | ||
15366 | C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">, | |
15367 | C<"all"> | |
15368 | ||
15369 | =item Filtering only the code parts of source code | |
15370 | ||
15371 | Most source code ceases to be grammatically correct when it is broken up | |
15372 | into the pieces between string literals and regexes. So the C<'code'> | |
15373 | component filter behaves slightly differently from the other partial | |
15374 | filters | |
15375 | described in the previous section. | |
15376 | ||
34babc16 JH |
15377 | =item Using Filter::Simple with an explicit C<import> subroutine |
15378 | ||
53d7eaa8 JH |
15379 | =item Using Filter::Simple and Exporter together |
15380 | ||
165c0277 JH |
15381 | =item How it works |
15382 | ||
15383 | =back | |
15384 | ||
15385 | =item AUTHOR | |
15386 | ||
15387 | =item COPYRIGHT | |
15388 | ||
15389 | =back | |
15390 | ||
15391 | =head2 Filter::Util::Call - Perl Source Filter Utility Module | |
15392 | ||
15393 | =over 4 | |
15394 | ||
ab648d5e JH |
15395 | =item SYNOPSIS |
15396 | ||
165c0277 JH |
15397 | =item DESCRIPTION |
15398 | ||
15399 | =over 4 | |
15400 | ||
15401 | =item B<use Filter::Util::Call> | |
15402 | ||
15403 | =item B<import()> | |
15404 | ||
15405 | =item B<filter() and anonymous sub> | |
15406 | ||
15407 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> | |
15408 | ||
15409 | =back | |
15410 | ||
15411 | =item EXAMPLES | |
15412 | ||
15413 | =over 4 | |
15414 | ||
15415 | =item Example 1: A simple filter. | |
15416 | ||
15417 | =item Example 2: Using the context | |
15418 | ||
15419 | =item Example 3: Using the context within the filter | |
15420 | ||
15421 | =item Example 4: Using filter_del | |
15422 | ||
15423 | =back | |
15424 | ||
4d4e713d JH |
15425 | =item Filter::Simple |
15426 | ||
165c0277 JH |
15427 | =item AUTHOR |
15428 | ||
15429 | =item DATE | |
15430 | ||
15431 | =back | |
15432 | ||
4755096e GS |
15433 | =head2 FindBin - Locate directory of original perl script |
15434 | ||
d420ca49 | 15435 | =over 4 |
4755096e GS |
15436 | |
15437 | =item SYNOPSIS | |
15438 | ||
15439 | =item DESCRIPTION | |
15440 | ||
15441 | =item EXPORTABLE VARIABLES | |
15442 | ||
35bf961c JH |
15443 | =item KNOWN ISSUES |
15444 | ||
4755096e GS |
15445 | =item KNOWN BUGS |
15446 | ||
15447 | =item AUTHORS | |
15448 | ||
15449 | =item COPYRIGHT | |
15450 | ||
15451 | =back | |
15452 | ||
15453 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
15454 | ||
d420ca49 | 15455 | =over 4 |
4755096e GS |
15456 | |
15457 | =item SYNOPSIS | |
15458 | ||
15459 | =item DESCRIPTION | |
15460 | ||
15461 | =item AVAILABILITY | |
15462 | ||
15463 | =item BUGS | |
15464 | ||
15465 | =item SEE ALSO | |
15466 | ||
15467 | =back | |
15468 | ||
15469 | =head2 Getopt::Long - Extended processing of command line options | |
15470 | ||
d420ca49 | 15471 | =over 4 |
4755096e GS |
15472 | |
15473 | =item SYNOPSIS | |
15474 | ||
15475 | =item DESCRIPTION | |
15476 | ||
15477 | =item Command Line Options, an Introduction | |
15478 | ||
15479 | =item Getting Started with Getopt::Long | |
15480 | ||
d420ca49 | 15481 | =over 4 |
4755096e GS |
15482 | |
15483 | =item Simple options | |
15484 | ||
15485 | =item A little bit less simple options | |
15486 | ||
15487 | =item Mixing command line option with other arguments | |
15488 | ||
15489 | =item Options with values | |
15490 | ||
15491 | =item Options with multiple values | |
15492 | ||
15493 | =item Options with hash values | |
15494 | ||
15495 | =item User-defined subroutines to handle options | |
15496 | ||
15497 | =item Options with multiple names | |
15498 | ||
15499 | =item Case and abbreviations | |
15500 | ||
15501 | =item Summary of Option Specifications | |
15502 | ||
ff426ff2 JH |
15503 | !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : |
15504 | + [ I<desttype> ] | |
4755096e GS |
15505 | |
15506 | =back | |
15507 | ||
15508 | =item Advanced Possibilities | |
15509 | ||
d420ca49 | 15510 | =over 4 |
4755096e | 15511 | |
10862624 RF |
15512 | =item Object oriented interface |
15513 | ||
033348ab JH |
15514 | =item Thread Safety |
15515 | ||
4755096e GS |
15516 | =item Documentation and help texts |
15517 | ||
15518 | =item Storing options in a hash | |
15519 | ||
15520 | =item Bundling | |
15521 | ||
15522 | =item The lonesome dash | |
15523 | ||
1fdc5aa6 | 15524 | =item Argument callback |
4755096e GS |
15525 | |
15526 | =back | |
15527 | ||
15528 | =item Configuring Getopt::Long | |
15529 | ||
9fa7f388 JH |
15530 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, |
15531 | require_order, permute, bundling (default: disabled), bundling_override | |
15532 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
8b9c797b JH |
15533 | (default: disabled), auto_version (default:disabled), auto_help |
15534 | (default:disabled), pass_through (default: disabled), prefix, | |
9fa7f388 | 15535 | prefix_pattern, debug (default: disabled) |
4755096e | 15536 | |
8b9c797b JH |
15537 | =item Exportable Methods |
15538 | ||
15539 | VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage | |
15540 | ||
4755096e GS |
15541 | =item Return values and Errors |
15542 | ||
15543 | =item Legacy | |
15544 | ||
d420ca49 | 15545 | =over 4 |
4755096e GS |
15546 | |
15547 | =item Default destinations | |
15548 | ||
15549 | =item Alternative option starters | |
15550 | ||
15551 | =item Configuration variables | |
15552 | ||
15553 | =back | |
15554 | ||
10862624 RF |
15555 | =item Trouble Shooting |
15556 | ||
d420ca49 | 15557 | =over 4 |
10862624 | 15558 | |
10862624 RF |
15559 | =item GetOptions does not return a false result when an option is not |
15560 | supplied | |
15561 | ||
1fdc5aa6 JH |
15562 | =item GetOptions does not split the command line correctly |
15563 | ||
8b9c797b JH |
15564 | =item Undefined subroutine &main::GetOptions called |
15565 | ||
1fdc5aa6 JH |
15566 | =item How do I put a "-?" option into a Getopt::Long? |
15567 | ||
10862624 RF |
15568 | =back |
15569 | ||
4755096e GS |
15570 | =item AUTHOR |
15571 | ||
15572 | =item COPYRIGHT AND DISCLAIMER | |
15573 | ||
15574 | =back | |
15575 | ||
f262848d RGS |
15576 | =head2 Getopt::Std, getopt, getopts - Process single-character switches |
15577 | with switch clustering | |
4755096e | 15578 | |
d420ca49 | 15579 | =over 4 |
4755096e GS |
15580 | |
15581 | =item SYNOPSIS | |
15582 | ||
15583 | =item DESCRIPTION | |
15584 | ||
2a551100 JH |
15585 | =item C<--help> and C<--version> |
15586 | ||
4755096e GS |
15587 | =back |
15588 | ||
80327a3d JH |
15589 | =head2 Hash::Util - A selection of general-utility hash subroutines |
15590 | ||
15591 | =over 4 | |
15592 | ||
15593 | =item SYNOPSIS | |
15594 | ||
15595 | =item DESCRIPTION | |
15596 | ||
15597 | =over 4 | |
15598 | ||
15599 | =item Restricted hashes | |
15600 | ||
15601 | lock_keys, unlock_keys | |
15602 | ||
15603 | =back | |
15604 | ||
15605 | =back | |
15606 | ||
15607 | lock_value, unlock_value | |
15608 | ||
15609 | B<lock_hash>, B<unlock_hash> | |
15610 | ||
1e54db1a JH |
15611 | B<hash_seed> |
15612 | ||
80327a3d JH |
15613 | =over 4 |
15614 | ||
2a551100 JH |
15615 | =item CAVEATS |
15616 | ||
80327a3d JH |
15617 | =item AUTHOR |
15618 | ||
15619 | =item SEE ALSO | |
15620 | ||
15621 | =back | |
15622 | ||
4755096e GS |
15623 | =head2 I18N::Collate - compare 8-bit scalar data according to the current |
15624 | locale | |
15625 | ||
d420ca49 | 15626 | =over 4 |
4755096e GS |
15627 | |
15628 | =item SYNOPSIS | |
15629 | ||
15630 | =item DESCRIPTION | |
15631 | ||
15632 | =back | |
15633 | ||
772ff3b9 JH |
15634 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language |
15635 | tags | |
15636 | ||
15637 | =over 4 | |
15638 | ||
15639 | =item SYNOPSIS | |
15640 | ||
15641 | =item DESCRIPTION | |
15642 | ||
15643 | =back | |
15644 | ||
15645 | the function is_language_tag($lang1) | |
15646 | ||
15647 | the function extract_language_tags($whatever) | |
15648 | ||
15649 | the function same_language_tag($lang1, $lang2) | |
15650 | ||
15651 | the function similarity_language_tag($lang1, $lang2) | |
15652 | ||
15653 | the function is_dialect_of($lang1, $lang2) | |
15654 | ||
15655 | the function super_languages($lang1) | |
15656 | ||
15657 | the function locale2language_tag($locale_identifier) | |
15658 | ||
15659 | the function encode_language_tag($lang1) | |
15660 | ||
15661 | the function alternate_language_tags($lang1) | |
15662 | ||
4f233aa4 JH |
15663 | the function @langs = panic_languages(@accept_languages) |
15664 | ||
07e9b5fe NC |
15665 | the function implicate_supers( ...languages... ), the function |
15666 | implicate_supers_strictly( ...languages... ) | |
15667 | ||
772ff3b9 JH |
15668 | =over 4 |
15669 | ||
15670 | =item ABOUT LOWERCASING | |
15671 | ||
15672 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS | |
15673 | ||
15674 | =item SEE ALSO | |
15675 | ||
15676 | =item COPYRIGHT | |
15677 | ||
15678 | =item AUTHOR | |
15679 | ||
15680 | =back | |
15681 | ||
07e9b5fe NC |
15682 | =head2 I18N::LangTags::Detect - detect the user's language preferences |
15683 | ||
15684 | =over 4 | |
15685 | ||
15686 | =item SYNOPSIS | |
15687 | ||
15688 | =item DESCRIPTION | |
15689 | ||
15690 | =item FUNCTIONS | |
15691 | ||
15692 | =item ENVIRONMENT | |
15693 | ||
15694 | =item SEE ALSO | |
15695 | ||
15696 | =item COPYRIGHT | |
15697 | ||
15698 | =item AUTHOR | |
15699 | ||
15700 | =back | |
15701 | ||
4f233aa4 | 15702 | =head2 I18N::LangTags::List -- tags and names for human languages |
2ca5449f JH |
15703 | |
15704 | =over 4 | |
15705 | ||
15706 | =item SYNOPSIS | |
15707 | ||
4f233aa4 JH |
15708 | =item DESCRIPTION |
15709 | ||
2ca5449f JH |
15710 | =item ABOUT LANGUAGE TAGS |
15711 | ||
15712 | =item LIST OF LANGUAGES | |
15713 | ||
0d53b15f JH |
15714 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : |
15715 | Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : | |
15716 | Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, | |
15717 | {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], | |
15718 | {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, | |
15719 | {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} | |
15720 | : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : | |
15721 | Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : | |
15722 | Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} | |
15723 | : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : | |
15724 | Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} | |
15725 | : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : | |
15726 | Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : | |
15727 | Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber | |
15728 | (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, | |
15729 | {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : | |
15730 | Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : | |
15731 | Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian | |
15732 | (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central | |
15733 | American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], | |
15734 | {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} | |
15735 | : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : | |
15736 | Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : | |
15737 | Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, | |
15738 | {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} | |
15739 | : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based | |
15740 | Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : | |
15741 | Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : | |
15742 | Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) | |
15743 | Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, | |
15744 | {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, | |
15745 | {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} | |
15746 | : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : | |
15747 | English, {enm} : Old English (1100-1500), {ang} : Old English | |
15748 | (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : | |
15749 | Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} | |
15750 | : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : | |
15751 | Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French | |
15752 | (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : | |
15753 | Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, | |
15754 | {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, | |
15755 | {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High | |
15756 | German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} | |
15757 | : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient | |
15758 | Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : | |
15759 | Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, | |
4f233aa4 JH |
15760 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : |
15761 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, | |
0d53b15f JH |
15762 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, |
15763 | {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European | |
15764 | (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua | |
15765 | (International Auxiliary Language Association), {ie} : Interlingue, {iu} : | |
15766 | Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : | |
15767 | Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian | |
15768 | languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : | |
15769 | Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, | |
15770 | {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : | |
15771 | Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} | |
15772 | : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, | |
15773 | {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, | |
15774 | {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, | |
15775 | {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : | |
15776 | Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, | |
15777 | {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : | |
15778 | Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : | |
15779 | Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : | |
15780 | Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban | |
15781 | (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} | |
15782 | : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, | |
15783 | {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, | |
15784 | {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : | |
15785 | Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : | |
15786 | Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : | |
15787 | Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, | |
15788 | [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : | |
15789 | Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : | |
15790 | Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], | |
15791 | {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple | |
15792 | languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, | |
15793 | {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, | |
15794 | {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : | |
4f233aa4 | 15795 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, |
0d53b15f JH |
15796 | {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : |
15797 | Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : | |
15798 | Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} | |
15799 | : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : | |
15800 | Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian | |
4f233aa4 | 15801 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : |
b6235c4f RGS |
15802 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : |
15803 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian | |
15804 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} | |
15805 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], | |
15806 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : | |
15807 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, | |
15808 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : | |
15809 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan | |
15810 | languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : | |
15811 | Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, | |
15812 | [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : | |
15813 | Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, | |
15814 | {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, | |
15815 | {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign | |
15816 | Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : | |
15817 | Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave | |
15818 | (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, | |
15819 | {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : | |
15820 | Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : | |
15821 | South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : | |
15822 | Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, | |
15823 | {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : | |
15824 | Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, | |
15825 | {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : | |
15826 | Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : | |
15827 | Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, | |
15828 | {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, | |
15829 | {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : | |
15830 | Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} | |
15831 | : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : | |
15832 | Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, | |
15833 | {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : | |
15834 | Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} | |
15835 | : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} | |
15836 | : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private | |
15837 | Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : | |
15838 | Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} | |
15839 | : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, | |
15840 | {zun} : Zuni | |
e993db8c | 15841 | |
639f8edf HS |
15842 | =item SEE ALSO |
15843 | ||
15844 | =item COPYRIGHT AND DISCLAIMER | |
15845 | ||
15846 | =item AUTHOR | |
15847 | ||
15848 | =back | |
15849 | ||
15850 | =head2 I18N::Langinfo - query locale information | |
15851 | ||
15852 | =over 4 | |
15853 | ||
15854 | =item SYNOPSIS | |
15855 | ||
15856 | =item DESCRIPTION | |
15857 | ||
15858 | =over 4 | |
15859 | ||
15860 | =item EXPORT | |
15861 | ||
15862 | =back | |
15863 | ||
15864 | =item SEE ALSO | |
15865 | ||
15866 | =item AUTHOR | |
15867 | ||
15868 | =item COPYRIGHT AND LICENSE | |
15869 | ||
15870 | =back | |
15871 | ||
15872 | =head2 IO - load various IO modules | |
15873 | ||
15874 | =over 4 | |
15875 | ||
15876 | =item SYNOPSIS | |
15877 | ||
15878 | =item DESCRIPTION | |
15879 | ||
15880 | =item DEPRECATED | |
15881 | ||
15882 | =back | |
15883 | ||
15884 | =head2 IO::Dir - supply object methods for directory handles | |
15885 | ||
15886 | =over 4 | |
15887 | ||
15888 | =item SYNOPSIS | |
15889 | ||
15890 | =item DESCRIPTION | |
15891 | ||
15892 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
15893 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] | |
15894 | ||
15895 | =item SEE ALSO | |
15896 | ||
15897 | =item AUTHOR | |
15898 | ||
15899 | =item COPYRIGHT | |
15900 | ||
15901 | =back | |
15902 | ||
15903 | =head2 IO::File - supply object methods for filehandles | |
15904 | ||
15905 | =over 4 | |
15906 | ||
15907 | =item SYNOPSIS | |
15908 | ||
15909 | =item DESCRIPTION | |
15910 | ||
15911 | =item CONSTRUCTOR | |
15912 | ||
15913 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
15914 | ||
15915 | =item METHODS | |
15916 | ||
e4bb216d NC |
15917 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
15918 | [LAYER] ) | |
639f8edf HS |
15919 | |
15920 | =item SEE ALSO | |
15921 | ||
15922 | =item HISTORY | |
15923 | ||
15924 | =back | |
15925 | ||
15926 | =head2 IO::Handle - supply object methods for I/O handles | |
15927 | ||
15928 | =over 4 | |
15929 | ||
15930 | =item SYNOPSIS | |
15931 | ||
15932 | =item DESCRIPTION | |
15933 | ||
15934 | =item CONSTRUCTOR | |
15935 | ||
15936 | new (), new_from_fd ( FD, MODE ) | |
15937 | ||
15938 | =item METHODS | |
15939 | ||
15940 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
15941 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
15942 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
15943 | $io->blocking ( [ BOOL ] ), $io->untaint | |
15944 | ||
15945 | =item NOTE | |
15946 | ||
15947 | =item SEE ALSO | |
15948 | ||
15949 | =item BUGS | |
15950 | ||
15951 | =item HISTORY | |
15952 | ||
15953 | =back | |
15954 | ||
15955 | =head2 IO::Pipe - supply object methods for pipes | |
15956 | ||
15957 | =over 4 | |
15958 | ||
15959 | =item SYNOPSIS | |
15960 | ||
15961 | =item DESCRIPTION | |
15962 | ||
15963 | =item CONSTRUCTOR | |
15964 | ||
15965 | new ( [READER, WRITER] ) | |
15966 | ||
15967 | =item METHODS | |
15968 | ||
15969 | reader ([ARGS]), writer ([ARGS]), handles () | |
15970 | ||
15971 | =item SEE ALSO | |
15972 | ||
15973 | =item AUTHOR | |
15974 | ||
15975 | =item COPYRIGHT | |
15976 | ||
15977 | =back | |
15978 | ||
15979 | =head2 IO::Poll - Object interface to system poll call | |
15980 | ||
15981 | =over 4 | |
15982 | ||
15983 | =item SYNOPSIS | |
15984 | ||
15985 | =item DESCRIPTION | |
15986 | ||
15987 | =item METHODS | |
15988 | ||
15989 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
15990 | IO ), handles( [ EVENT_MASK ] ) | |
15991 | ||
15992 | =item SEE ALSO | |
15993 | ||
15994 | =item AUTHOR | |
15995 | ||
15996 | =item COPYRIGHT | |
15997 | ||
15998 | =back | |
15999 | ||
16000 | =head2 IO::Seekable - supply seek based methods for I/O objects | |
16001 | ||
16002 | =over 4 | |
16003 | ||
16004 | =item SYNOPSIS | |
16005 | ||
16006 | =item DESCRIPTION | |
16007 | ||
16008 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), | |
16009 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
16010 | $io->tell | |
16011 | ||
16012 | =item SEE ALSO | |
16013 | ||
16014 | =item HISTORY | |
16015 | ||
16016 | =back | |
16017 | ||
16018 | =head2 IO::Select - OO interface to the select system call | |
16019 | ||
16020 | =over 4 | |
16021 | ||
16022 | =item SYNOPSIS | |
16023 | ||
16024 | =item DESCRIPTION | |
16025 | ||
16026 | =item CONSTRUCTOR | |
16027 | ||
16028 | new ( [ HANDLES ] ) | |
e993db8c | 16029 | |
639f8edf HS |
16030 | =item METHODS |
16031 | ||
16032 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
16033 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
16034 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) | |
16035 | ||
16036 | =item EXAMPLE | |
e993db8c | 16037 | |
b6235c4f | 16038 | =item AUTHOR |
e993db8c | 16039 | |
639f8edf HS |
16040 | =item COPYRIGHT |
16041 | ||
e993db8c JH |
16042 | =back |
16043 | ||
639f8edf HS |
16044 | =head2 IO::Socket - Object interface to socket communications |
16045 | ||
16046 | =over 4 | |
16047 | ||
16048 | =item SYNOPSIS | |
16049 | ||
16050 | =item DESCRIPTION | |
16051 | ||
16052 | =item CONSTRUCTOR | |
16053 | ||
16054 | new ( [ARGS] ) | |
16055 | ||
16056 | =item METHODS | |
16057 | ||
16058 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, | |
16059 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
16060 | ||
16061 | =item SEE ALSO | |
16062 | ||
16063 | =item AUTHOR | |
16064 | ||
16065 | =item COPYRIGHT | |
16066 | ||
16067 | =back | |
16068 | ||
16069 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets | |
e993db8c | 16070 | |
d420ca49 | 16071 | =over 4 |
cb1a09d0 | 16072 | |
e993db8c JH |
16073 | =item SYNOPSIS |
16074 | ||
16075 | =item DESCRIPTION | |
16076 | ||
639f8edf HS |
16077 | =item CONSTRUCTOR |
16078 | ||
16079 | new ( [ARGS] ) | |
16080 | ||
e993db8c JH |
16081 | =over 4 |
16082 | ||
639f8edf HS |
16083 | =item METHODS |
16084 | ||
16085 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
16086 | () | |
b38f6a39 GS |
16087 | |
16088 | =back | |
cb1a09d0 | 16089 | |
4755096e GS |
16090 | =item SEE ALSO |
16091 | ||
d516a115 JH |
16092 | =item AUTHOR |
16093 | ||
639f8edf | 16094 | =item COPYRIGHT |
d516a115 | 16095 | |
a45bd81d GS |
16096 | =back |
16097 | ||
639f8edf | 16098 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets |
cb1a09d0 | 16099 | |
d420ca49 | 16100 | =over 4 |
a45bd81d | 16101 | |
8ebc5c01 | 16102 | =item SYNOPSIS |
cb1a09d0 | 16103 | |
8ebc5c01 | 16104 | =item DESCRIPTION |
cb1a09d0 | 16105 | |
639f8edf HS |
16106 | =item CONSTRUCTOR |
16107 | ||
16108 | new ( [ARGS] ) | |
16109 | ||
16110 | =item METHODS | |
16111 | ||
16112 | hostpath(), peerpath() | |
16113 | ||
16114 | =item SEE ALSO | |
16115 | ||
16116 | =item AUTHOR | |
16117 | ||
16118 | =item COPYRIGHT | |
e993db8c | 16119 | |
a45bd81d GS |
16120 | =back |
16121 | ||
14218588 GS |
16122 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory |
16123 | handles | |
fb9cefb4 | 16124 | |
d420ca49 | 16125 | =over 4 |
a45bd81d | 16126 | |
fb9cefb4 GS |
16127 | =item SYNOPSIS |
16128 | ||
16129 | =item DESCRIPTION | |
16130 | ||
14218588 | 16131 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
41630250 | 16132 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] |
fb9cefb4 GS |
16133 | |
16134 | =item SEE ALSO | |
16135 | ||
14218588 | 16136 | =item AUTHOR |
fb9cefb4 GS |
16137 | |
16138 | =item COPYRIGHT | |
16139 | ||
a45bd81d GS |
16140 | =back |
16141 | ||
14218588 | 16142 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
fb9cefb4 | 16143 | |
d420ca49 | 16144 | =over 4 |
a45bd81d | 16145 | |
fb9cefb4 GS |
16146 | =item SYNOPSIS |
16147 | ||
16148 | =item DESCRIPTION | |
16149 | ||
14218588 GS |
16150 | =item CONSTRUCTOR |
16151 | ||
16152 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
16153 | ||
fb9cefb4 GS |
16154 | =item METHODS |
16155 | ||
e4bb216d NC |
16156 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
16157 | [LAYER] ) | |
fb9cefb4 GS |
16158 | |
16159 | =item SEE ALSO | |
16160 | ||
14218588 | 16161 | =item HISTORY |
fb9cefb4 | 16162 | |
a45bd81d GS |
16163 | =back |
16164 | ||
14218588 GS |
16165 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
16166 | handles | |
16167 | ||
d420ca49 | 16168 | =over 4 |
a45bd81d | 16169 | |
14218588 GS |
16170 | =item SYNOPSIS |
16171 | ||
16172 | =item DESCRIPTION | |
16173 | ||
16174 | =item CONSTRUCTOR | |
16175 | ||
16176 | new (), new_from_fd ( FD, MODE ) | |
16177 | ||
16178 | =item METHODS | |
16179 | ||
16180 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
16181 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
16182 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
16183 | $io->blocking ( [ BOOL ] ), $io->untaint | |
16184 | ||
16185 | =item NOTE | |
16186 | ||
16187 | =item SEE ALSO | |
16188 | ||
16189 | =item BUGS | |
16190 | ||
16191 | =item HISTORY | |
16192 | ||
a45bd81d GS |
16193 | =back |
16194 | ||
14218588 GS |
16195 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes |
16196 | ||
d420ca49 | 16197 | =over 4 |
a45bd81d | 16198 | |
14218588 GS |
16199 | =item SYNOPSIS |
16200 | ||
16201 | =item DESCRIPTION | |
16202 | ||
16203 | =item CONSTRUCTOR | |
16204 | ||
16205 | new ( [READER, WRITER] ) | |
16206 | ||
16207 | =item METHODS | |
16208 | ||
16209 | reader ([ARGS]), writer ([ARGS]), handles () | |
16210 | ||
16211 | =item SEE ALSO | |
16212 | ||
16213 | =item AUTHOR | |
16214 | ||
16215 | =item COPYRIGHT | |
16216 | ||
a45bd81d GS |
16217 | =back |
16218 | ||
14218588 GS |
16219 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call |
16220 | ||
d420ca49 | 16221 | =over 4 |
a45bd81d | 16222 | |
14218588 GS |
16223 | =item SYNOPSIS |
16224 | ||
16225 | =item DESCRIPTION | |
16226 | ||
16227 | =item METHODS | |
16228 | ||
16229 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
16230 | IO ), handles( [ EVENT_MASK ] ) | |
16231 | ||
16232 | =item SEE ALSO | |
16233 | ||
16234 | =item AUTHOR | |
16235 | ||
16236 | =item COPYRIGHT | |
16237 | ||
a45bd81d GS |
16238 | =back |
16239 | ||
14218588 GS |
16240 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for |
16241 | I/O objects | |
16242 | ||
d420ca49 | 16243 | =over 4 |
a45bd81d | 16244 | |
14218588 GS |
16245 | =item SYNOPSIS |
16246 | ||
16247 | =item DESCRIPTION | |
16248 | ||
1fa7ca25 JH |
16249 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
16250 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
74cac757 | 16251 | $io->tell |
14218588 | 16252 | |
4d4e713d JH |
16253 | =item SEE ALSO |
16254 | ||
14218588 GS |
16255 | =item HISTORY |
16256 | ||
a45bd81d GS |
16257 | =back |
16258 | ||
14218588 GS |
16259 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system |
16260 | call | |
16261 | ||
d420ca49 | 16262 | =over 4 |
a45bd81d | 16263 | |
14218588 GS |
16264 | =item SYNOPSIS |
16265 | ||
16266 | =item DESCRIPTION | |
16267 | ||
16268 | =item CONSTRUCTOR | |
16269 | ||
16270 | new ( [ HANDLES ] ) | |
16271 | ||
16272 | =item METHODS | |
16273 | ||
16274 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
16275 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
2a551100 | 16276 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) |
14218588 GS |
16277 | |
16278 | =item EXAMPLE | |
16279 | ||
16280 | =item AUTHOR | |
16281 | ||
16282 | =item COPYRIGHT | |
16283 | ||
a45bd81d GS |
16284 | =back |
16285 | ||
14218588 GS |
16286 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket |
16287 | communications | |
16288 | ||
d420ca49 | 16289 | =over 4 |
a45bd81d | 16290 | |
14218588 GS |
16291 | =item SYNOPSIS |
16292 | ||
16293 | =item DESCRIPTION | |
16294 | ||
16295 | =item CONSTRUCTOR | |
16296 | ||
16297 | new ( [ARGS] ) | |
16298 | ||
16299 | =item METHODS | |
16300 | ||
ab1e085c JH |
16301 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, |
16302 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
14218588 GS |
16303 | |
16304 | =item SEE ALSO | |
16305 | ||
16306 | =item AUTHOR | |
16307 | ||
16308 | =item COPYRIGHT | |
16309 | ||
a45bd81d GS |
16310 | =back |
16311 | ||
14218588 GS |
16312 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for |
16313 | AF_INET domain sockets | |
16314 | ||
d420ca49 | 16315 | =over 4 |
a45bd81d | 16316 | |
14218588 GS |
16317 | =item SYNOPSIS |
16318 | ||
16319 | =item DESCRIPTION | |
16320 | ||
16321 | =item CONSTRUCTOR | |
16322 | ||
16323 | new ( [ARGS] ) | |
16324 | ||
d420ca49 | 16325 | =over 4 |
14218588 GS |
16326 | |
16327 | =item METHODS | |
16328 | ||
16329 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
16330 | () | |
16331 | ||
16332 | =back | |
16333 | ||
16334 | =item SEE ALSO | |
16335 | ||
16336 | =item AUTHOR | |
16337 | ||
16338 | =item COPYRIGHT | |
16339 | ||
a45bd81d GS |
16340 | =back |
16341 | ||
14218588 GS |
16342 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for |
16343 | AF_UNIX domain sockets | |
16344 | ||
d420ca49 | 16345 | =over 4 |
a45bd81d | 16346 | |
14218588 GS |
16347 | =item SYNOPSIS |
16348 | ||
16349 | =item DESCRIPTION | |
16350 | ||
16351 | =item CONSTRUCTOR | |
16352 | ||
16353 | new ( [ARGS] ) | |
16354 | ||
16355 | =item METHODS | |
16356 | ||
16357 | hostpath(), peerpath() | |
16358 | ||
16359 | =item SEE ALSO | |
16360 | ||
16361 | =item AUTHOR | |
16362 | ||
16363 | =item COPYRIGHT | |
16364 | ||
a45bd81d | 16365 | =back |
14218588 | 16366 | |
639f8edf HS |
16367 | =head2 IPC::Msg - SysV Msg IPC object class |
16368 | ||
16369 | =over 4 | |
16370 | ||
16371 | =item SYNOPSIS | |
16372 | ||
16373 | =item DESCRIPTION | |
16374 | ||
16375 | =item METHODS | |
16376 | ||
16377 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
16378 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
16379 | FLAGS ] ), stat | |
16380 | ||
16381 | =item SEE ALSO | |
16382 | ||
16383 | =item AUTHOR | |
16384 | ||
16385 | =item COPYRIGHT | |
16386 | ||
16387 | =back | |
16388 | ||
14218588 GS |
16389 | =head2 IPC::Open2, open2 - open a process for both reading and writing |
16390 | ||
d420ca49 | 16391 | =over 4 |
a45bd81d | 16392 | |
14218588 GS |
16393 | =item SYNOPSIS |
16394 | ||
16395 | =item DESCRIPTION | |
16396 | ||
16397 | =item WARNING | |
16398 | ||
16399 | =item SEE ALSO | |
16400 | ||
a45bd81d GS |
16401 | =back |
16402 | ||
14218588 GS |
16403 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error |
16404 | handling | |
16405 | ||
d420ca49 | 16406 | =over 4 |
14218588 GS |
16407 | |
16408 | =item SYNOPSIS | |
16409 | ||
16410 | =item DESCRIPTION | |
16411 | ||
a45bd81d | 16412 | =item WARNING |
14218588 | 16413 | |
a45bd81d | 16414 | =back |
14218588 | 16415 | |
639f8edf HS |
16416 | =head2 IPC::Semaphore - SysV Semaphore IPC object class |
16417 | ||
16418 | =over 4 | |
16419 | ||
16420 | =item SYNOPSIS | |
16421 | ||
16422 | =item DESCRIPTION | |
16423 | ||
16424 | =item METHODS | |
16425 | ||
16426 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
16427 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
16428 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
16429 | , VALUE ), stat | |
16430 | ||
16431 | =item SEE ALSO | |
16432 | ||
16433 | =item AUTHOR | |
16434 | ||
16435 | =item COPYRIGHT | |
16436 | ||
16437 | =back | |
16438 | ||
14218588 GS |
16439 | =head2 IPC::SysV - SysV IPC constants |
16440 | ||
d420ca49 | 16441 | =over 4 |
a45bd81d | 16442 | |
14218588 GS |
16443 | =item SYNOPSIS |
16444 | ||
16445 | =item DESCRIPTION | |
16446 | ||
16447 | ftok( PATH, ID ) | |
16448 | ||
16449 | =item SEE ALSO | |
16450 | ||
16451 | =item AUTHORS | |
16452 | ||
16453 | =item COPYRIGHT | |
16454 | ||
a45bd81d GS |
16455 | =back |
16456 | ||
14218588 GS |
16457 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class |
16458 | ||
d420ca49 | 16459 | =over 4 |
a45bd81d | 16460 | |
14218588 GS |
16461 | =item SYNOPSIS |
16462 | ||
16463 | =item DESCRIPTION | |
16464 | ||
16465 | =item METHODS | |
16466 | ||
16467 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
16468 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
16469 | FLAGS ] ), stat | |
16470 | ||
16471 | =item SEE ALSO | |
16472 | ||
16473 | =item AUTHOR | |
16474 | ||
16475 | =item COPYRIGHT | |
fb9cefb4 | 16476 | |
a45bd81d GS |
16477 | =back |
16478 | ||
fb9cefb4 GS |
16479 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object |
16480 | class | |
16481 | ||
d420ca49 | 16482 | =over 4 |
a45bd81d | 16483 | |
fb9cefb4 GS |
16484 | =item SYNOPSIS |
16485 | ||
16486 | =item DESCRIPTION | |
16487 | ||
16488 | =item METHODS | |
16489 | ||
16490 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
16491 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
16492 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
16493 | , VALUE ), stat | |
16494 | ||
16495 | =item SEE ALSO | |
16496 | ||
16497 | =item AUTHOR | |
16498 | ||
16499 | =item COPYRIGHT | |
16500 | ||
a45bd81d GS |
16501 | =back |
16502 | ||
639f8edf HS |
16503 | =head2 List::Util - A selection of general-utility list subroutines |
16504 | ||
16505 | =over 4 | |
16506 | ||
16507 | =item SYNOPSIS | |
16508 | ||
16509 | =item DESCRIPTION | |
16510 | ||
16511 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
16512 | BLOCK LIST, shuffle LIST, sum LIST | |
16513 | ||
16514 | =item KNOWN BUGS | |
16515 | ||
16516 | =item SUGGESTED ADDITIONS | |
16517 | ||
16518 | =item COPYRIGHT | |
16519 | ||
16520 | =back | |
16521 | ||
41ca3a40 JH |
16522 | =head2 List::Utilib::List::Util, List::Util - A selection of |
16523 | general-utility list subroutines | |
16524 | ||
16525 | =over 4 | |
16526 | ||
16527 | =item SYNOPSIS | |
16528 | ||
16529 | =item DESCRIPTION | |
16530 | ||
16531 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
53d7eaa8 | 16532 | BLOCK LIST, shuffle LIST, sum LIST |
41ca3a40 | 16533 | |
f502af34 JH |
16534 | =item KNOWN BUGS |
16535 | ||
41ca3a40 JH |
16536 | =item SUGGESTED ADDITIONS |
16537 | ||
16538 | =item COPYRIGHT | |
16539 | ||
16540 | =back | |
16541 | ||
16542 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of | |
16543 | general-utility scalar subroutines | |
16544 | ||
16545 | =over 4 | |
16546 | ||
16547 | =item SYNOPSIS | |
16548 | ||
16549 | =item DESCRIPTION | |
16550 | ||
2a551100 JH |
16551 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, |
16552 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, | |
16553 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF | |
41ca3a40 | 16554 | |
f502af34 JH |
16555 | =item KNOWN BUGS |
16556 | ||
41ca3a40 JH |
16557 | =item COPYRIGHT |
16558 | ||
16559 | =item BLATANT PLUG | |
16560 | ||
16561 | =back | |
16562 | ||
4d4e713d JH |
16563 | =head2 Locale::Constants - constants for Locale codes |
16564 | ||
16565 | =over 4 | |
16566 | ||
16567 | =item SYNOPSIS | |
16568 | ||
16569 | =item DESCRIPTION | |
16570 | ||
16571 | =item KNOWN BUGS AND LIMITATIONS | |
16572 | ||
16573 | =item SEE ALSO | |
16574 | ||
12b7c5c7 | 16575 | Locale::Language, Locale::Country, Locale::Script, Locale::Currency |
4d4e713d JH |
16576 | |
16577 | =item AUTHOR | |
16578 | ||
16579 | =item COPYRIGHT | |
16580 | ||
16581 | =back | |
16582 | ||
16583 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) | |
16584 | ||
16585 | =over 4 | |
16586 | ||
16587 | =item SYNOPSIS | |
16588 | ||
4d4e713d JH |
16589 | =item DESCRIPTION |
16590 | ||
16591 | B<alpha-2>, B<alpha-3>, B<numeric> | |
16592 | ||
4d4e713d JH |
16593 | =item CONVERSION ROUTINES |
16594 | ||
16595 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), | |
16596 | country_code2code( CODE, CODESET, CODESET ) | |
16597 | ||
4d4e713d JH |
16598 | =item QUERY ROUTINES |
16599 | ||
16600 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> | |
16601 | ||
80327a3d JH |
16602 | =item SEMI-PRIVATE ROUTINES |
16603 | ||
16604 | =over 4 | |
16605 | ||
16606 | =item alias_code | |
16607 | ||
16608 | =item rename_country | |
16609 | ||
16610 | =back | |
4d4e713d | 16611 | |
4d4e713d JH |
16612 | =item EXAMPLES |
16613 | ||
16614 | =item DOMAIN NAMES | |
16615 | ||
16616 | =item KNOWN BUGS AND LIMITATIONS | |
16617 | ||
16618 | =item SEE ALSO | |
16619 | ||
80327a3d JH |
16620 | Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO |
16621 | 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, | |
4d4e713d | 16622 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, |
28a2f804 | 16623 | http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html |
4d4e713d JH |
16624 | |
16625 | =item AUTHOR | |
16626 | ||
16627 | =item COPYRIGHT | |
16628 | ||
16629 | =back | |
16630 | ||
16631 | =head2 Locale::Currency - ISO three letter codes for currency | |
16632 | identification (ISO 4217) | |
16633 | ||
16634 | =over 4 | |
16635 | ||
16636 | =item SYNOPSIS | |
16637 | ||
4d4e713d JH |
16638 | =item DESCRIPTION |
16639 | ||
16640 | XTS, XXX | |
16641 | ||
4d4e713d JH |
16642 | =item CONVERSION ROUTINES |
16643 | ||
16644 | code2currency(), currency2code() | |
16645 | ||
4d4e713d JH |
16646 | =item QUERY ROUTINES |
16647 | ||
16648 | C<all_currency_codes()>, C<all_currency_names()> | |
16649 | ||
4d4e713d JH |
16650 | =item EXAMPLES |
16651 | ||
16652 | =item KNOWN BUGS AND LIMITATIONS | |
16653 | ||
16654 | =item SEE ALSO | |
16655 | ||
12b7c5c7 JH |
16656 | Locale::Country, Locale::Script, ISO 4217:1995, |
16657 | http://www.bsi-global.com/iso4217currency | |
4d4e713d JH |
16658 | |
16659 | =item AUTHOR | |
16660 | ||
16661 | =item COPYRIGHT | |
16662 | ||
16663 | =back | |
16664 | ||
16665 | =head2 Locale::Language - ISO two letter codes for language identification | |
16666 | (ISO 639) | |
16667 | ||
16668 | =over 4 | |
16669 | ||
16670 | =item SYNOPSIS | |
16671 | ||
4d4e713d JH |
16672 | =item DESCRIPTION |
16673 | ||
4d4e713d JH |
16674 | =item CONVERSION ROUTINES |
16675 | ||
16676 | code2language(), language2code() | |
16677 | ||
4d4e713d JH |
16678 | =item QUERY ROUTINES |
16679 | ||
16680 | C<all_language_codes()>, C<all_language_names()> | |
16681 | ||
4d4e713d JH |
16682 | =item EXAMPLES |
16683 | ||
16684 | =item KNOWN BUGS AND LIMITATIONS | |
16685 | ||
16686 | =item SEE ALSO | |
16687 | ||
12b7c5c7 | 16688 | Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), |
4d4e713d JH |
16689 | http://lcweb.loc.gov/standards/iso639-2/langhome.html |
16690 | ||
16691 | =item AUTHOR | |
16692 | ||
16693 | =item COPYRIGHT | |
16694 | ||
16695 | =back | |
16696 | ||
2a551100 | 16697 | =head2 Locale::Maketext - framework for localization |
772ff3b9 JH |
16698 | |
16699 | =over 4 | |
16700 | ||
16701 | =item SYNOPSIS | |
16702 | ||
16703 | =item DESCRIPTION | |
16704 | ||
16705 | =item QUICK OVERVIEW | |
16706 | ||
16707 | =item METHODS | |
16708 | ||
16709 | =over 4 | |
16710 | ||
16711 | =item Construction Methods | |
16712 | ||
772ff3b9 JH |
16713 | =item The "maketext" Method |
16714 | ||
16715 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto | |
16716 | ||
16717 | =item Utility Methods | |
16718 | ||
16719 | $language->quant($number, $singular), $language->quant($number, $singular, | |
16720 | $plural), $language->quant($number, $singular, $plural, $negative), | |
16721 | $language->numf($number), $language->sprintf($format, @items), | |
16722 | $language->language_tag(), $language->encoding() | |
16723 | ||
16724 | =item Language Handle Attributes and Internals | |
16725 | ||
16726 | =back | |
16727 | ||
16728 | =item LANGUAGE CLASS HIERARCHIES | |
16729 | ||
16730 | =item ENTRIES IN EACH LEXICON | |
16731 | ||
16732 | =item BRACKET NOTATION | |
16733 | ||
16734 | =item AUTO LEXICONS | |
16735 | ||
16736 | =item CONTROLLING LOOKUP FAILURE | |
16737 | ||
16738 | =item HOW TO USE MAKETEXT | |
16739 | ||
16740 | =item SEE ALSO | |
16741 | ||
16742 | =item COPYRIGHT AND DISCLAIMER | |
16743 | ||
16744 | =item AUTHOR | |
16745 | ||
16746 | =back | |
16747 | ||
16748 | =head2 Locale::Maketext::TPJ13 -- article about software localization | |
16749 | ||
16750 | =over 4 | |
16751 | ||
16752 | =item SYNOPSIS | |
16753 | ||
16754 | =item DESCRIPTION | |
16755 | ||
16756 | =item Localization and Perl: gettext breaks, Maketext fixes | |
16757 | ||
16758 | =over 4 | |
16759 | ||
16760 | =item A Localization Horror Story: It Could Happen To You | |
16761 | ||
16762 | =item The Linguistic View | |
16763 | ||
16764 | =item Breaking gettext | |
16765 | ||
16766 | =item Replacing gettext | |
16767 | ||
16768 | =item Buzzwords: Abstraction and Encapsulation | |
16769 | ||
16770 | =item Buzzword: Isomorphism | |
16771 | ||
16772 | =item Buzzword: Inheritance | |
16773 | ||
16774 | =item Buzzword: Concision | |
16775 | ||
16776 | =item The Devil in the Details | |
16777 | ||
16778 | =item The Proof in the Pudding: Localizing Web Sites | |
16779 | ||
16780 | =item References | |
16781 | ||
16782 | =back | |
16783 | ||
16784 | =back | |
16785 | ||
12b7c5c7 JH |
16786 | =head2 Locale::Script - ISO codes for script identification (ISO 15924) |
16787 | ||
16788 | =over 4 | |
16789 | ||
16790 | =item SYNOPSIS | |
16791 | ||
16792 | =item DESCRIPTION | |
16793 | ||
16794 | B<alpha-2>, B<alpha-3>, B<numeric> | |
16795 | ||
16796 | =over 4 | |
16797 | ||
16798 | =item SPECIAL CODES | |
16799 | ||
16800 | =back | |
16801 | ||
16802 | =item CONVERSION ROUTINES | |
16803 | ||
16804 | code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), | |
16805 | script_code2code( CODE, CODESET, CODESET ) | |
16806 | ||
16807 | =item QUERY ROUTINES | |
16808 | ||
16809 | C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> | |
16810 | ||
16811 | =item EXAMPLES | |
16812 | ||
16813 | =item KNOWN BUGS AND LIMITATIONS | |
16814 | ||
16815 | =item SEE ALSO | |
16816 | ||
16817 | Locale::Language, Locale::Currency, Locale::Country, ISO 15924, | |
16818 | http://www.evertype.com/standards/iso15924/ | |
16819 | ||
16820 | =item AUTHOR | |
16821 | ||
16822 | =item COPYRIGHT | |
16823 | ||
16824 | =back | |
16825 | ||
ab1e085c JH |
16826 | =head2 MIME::Base64 - Encoding and decoding of base64 strings |
16827 | ||
16828 | =over 4 | |
16829 | ||
16830 | =item SYNOPSIS | |
16831 | ||
16832 | =item DESCRIPTION | |
16833 | ||
2a551100 | 16834 | encode_base64($str), encode_base64($str, $eol);, decode_base64($str) |
ab1e085c JH |
16835 | |
16836 | =item DIAGNOSTICS | |
16837 | ||
16838 | Premature end of base64 data, Premature padding of base64 data | |
16839 | ||
16840 | =item EXAMPLES | |
16841 | ||
16842 | =item COPYRIGHT | |
16843 | ||
639f8edf HS |
16844 | =item SEE ALSO |
16845 | ||
ab1e085c JH |
16846 | =back |
16847 | ||
16848 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding | |
16849 | of quoted-printable strings | |
16850 | ||
16851 | =over 4 | |
16852 | ||
16853 | =item SYNOPSIS | |
16854 | ||
16855 | =item DESCRIPTION | |
16856 | ||
e4bb216d NC |
16857 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
16858 | decode_qp($str); | |
ab1e085c JH |
16859 | |
16860 | =item COPYRIGHT | |
16861 | ||
639f8edf HS |
16862 | =item SEE ALSO |
16863 | ||
16864 | =back | |
16865 | ||
16866 | =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable | |
16867 | strings | |
16868 | ||
16869 | =over 4 | |
16870 | ||
16871 | =item SYNOPSIS | |
16872 | ||
16873 | =item DESCRIPTION | |
16874 | ||
e4bb216d NC |
16875 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
16876 | decode_qp($str); | |
639f8edf HS |
16877 | |
16878 | =item COPYRIGHT | |
16879 | ||
16880 | =item SEE ALSO | |
16881 | ||
ab1e085c JH |
16882 | =back |
16883 | ||
9038e305 | 16884 | =head2 Math::BigFloat - Arbitrary size floating point math package |
cb1a09d0 | 16885 | |
d420ca49 | 16886 | =over 4 |
a45bd81d | 16887 | |
8ebc5c01 | 16888 | =item SYNOPSIS |
cb1a09d0 AD |
16889 | |
16890 | =item DESCRIPTION | |
16891 | ||
9038e305 JH |
16892 | =over 4 |
16893 | ||
16894 | =item Canonical notation | |
16895 | ||
16896 | =item Output | |
16897 | ||
16898 | =item C<mantissa()>, C<exponent()> and C<parts()> | |
16899 | ||
16900 | =item Accuracy vs. Precision | |
16901 | ||
16902 | =item Rounding | |
16903 | ||
4f233aa4 JH |
16904 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale |
16905 | ), fround ( -$scale ) and fround ( 0 ) | |
9038e305 JH |
16906 | |
16907 | =back | |
16908 | ||
16909 | =item EXAMPLES | |
16910 | ||
9038e305 | 16911 | # not ready yet |
9038e305 JH |
16912 | |
16913 | =item Autocreating constants | |
16914 | ||
fa1c7b03 JH |
16915 | =over 4 |
16916 | ||
16917 | =item Math library | |
16918 | ||
16919 | =item Using Math::BigInt::Lite | |
16920 | ||
16921 | =back | |
16922 | ||
b38f6a39 | 16923 | =item BUGS |
7d2bfb28 | 16924 | |
0d53b15f | 16925 | =item CAVEATS |
9038e305 JH |
16926 | |
16927 | stringify, bstr(), bdiv, Modifying and =, bpow | |
16928 | ||
0d53b15f JH |
16929 | =item SEE ALSO |
16930 | ||
9038e305 JH |
16931 | =item LICENSE |
16932 | ||
16933 | =item AUTHORS | |
7d2bfb28 | 16934 | |
b38f6a39 GS |
16935 | =back |
16936 | ||
16937 | =head2 Math::BigInt - Arbitrary size integer math package | |
16938 | ||
d420ca49 | 16939 | =over 4 |
8ebc5c01 | 16940 | |
b38f6a39 | 16941 | =item SYNOPSIS |
d516a115 | 16942 | |
b38f6a39 GS |
16943 | =item DESCRIPTION |
16944 | ||
1e54db1a | 16945 | Input, Output |
b38f6a39 | 16946 | |
ff426ff2 JH |
16947 | =item METHODS |
16948 | ||
16949 | =over 4 | |
16950 | ||
fa1c7b03 JH |
16951 | =item config |
16952 | ||
ff426ff2 JH |
16953 | =item accuracy |
16954 | ||
2a551100 JH |
16955 | =item precision |
16956 | ||
ff426ff2 JH |
16957 | =item brsft |
16958 | ||
16959 | =item new | |
16960 | ||
16961 | =item bnan | |
16962 | ||
16963 | =item bzero | |
16964 | ||
16965 | =item binf | |
16966 | ||
16967 | =item bone | |
16968 | ||
fa1c7b03 JH |
16969 | =item is_one()/is_zero()/is_nan()/is_inf() |
16970 | ||
2e038148 | 16971 | =item is_pos()/is_neg() |
ff426ff2 | 16972 | |
df344c0f NC |
16973 | $x->is_pos(); # true if > 0 |
16974 | $x->is_neg(); # true if < 0 | |
fa1c7b03 JH |
16975 | |
16976 | =item is_odd()/is_even()/is_int() | |
ff426ff2 JH |
16977 | |
16978 | =item bcmp | |
16979 | ||
16980 | =item bacmp | |
16981 | ||
16982 | =item sign | |
16983 | ||
f262848d | 16984 | =item digit |
ff426ff2 JH |
16985 | |
16986 | =item bneg | |
16987 | ||
16988 | =item babs | |
16989 | ||
16990 | =item bnorm | |
16991 | ||
16992 | =item bnot | |
16993 | ||
16994 | =item binc | |
16995 | ||
16996 | =item bdec | |
16997 | ||
16998 | =item badd | |
16999 | ||
17000 | =item bsub | |
17001 | ||
17002 | =item bmul | |
17003 | ||
17004 | =item bdiv | |
17005 | ||
17006 | =item bmod | |
17007 | ||
a6812a52 JH |
17008 | =item bmodinv |
17009 | ||
17010 | =item bmodpow | |
17011 | ||
ff426ff2 JH |
17012 | =item bpow |
17013 | ||
17014 | =item blsft | |
17015 | ||
17016 | =item brsft | |
17017 | ||
17018 | =item band | |
17019 | ||
17020 | =item bior | |
17021 | ||
17022 | =item bxor | |
17023 | ||
17024 | =item bnot | |
17025 | ||
17026 | =item bsqrt | |
17027 | ||
17028 | =item bfac | |
17029 | ||
17030 | =item round | |
17031 | ||
17032 | =item bround | |
17033 | ||
17034 | =item bfround | |
17035 | ||
17036 | =item bfloor | |
17037 | ||
17038 | =item bceil | |
17039 | ||
17040 | =item bgcd | |
17041 | ||
17042 | =item blcm | |
17043 | ||
17044 | =item exponent | |
17045 | ||
17046 | =item mantissa | |
17047 | ||
17048 | =item parts | |
17049 | ||
17050 | =item copy | |
17051 | ||
2e038148 | 17052 | =item as_int |
ff426ff2 JH |
17053 | |
17054 | =item bsstr | |
17055 | ||
17056 | =item as_hex | |
17057 | ||
17058 | =item as_bin | |
17059 | ||
17060 | =back | |
17061 | ||
d0363f02 JH |
17062 | =item ACCURACY and PRECISION |
17063 | ||
9038e305 JH |
17064 | =over 4 |
17065 | ||
d0363f02 JH |
17066 | =item Precision P |
17067 | ||
17068 | =item Accuracy A | |
9038e305 | 17069 | |
d0363f02 | 17070 | =item Fallback F |
9038e305 | 17071 | |
d0363f02 JH |
17072 | =item Rounding mode R |
17073 | ||
17074 | 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy | |
17075 | (significant digits), Setting/Accessing, Creating numbers, Usage, | |
17076 | Precedence, Overriding globals, Local settings, Rounding, Default values, | |
17077 | Remarks | |
17078 | ||
17079 | =back | |
17080 | ||
df344c0f NC |
17081 | =item Infinity and Not a Number |
17082 | ||
17083 | oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() | |
17084 | ||
d0363f02 JH |
17085 | =item INTERNALS |
17086 | ||
17087 | =over 4 | |
9038e305 | 17088 | |
758a5d79 JH |
17089 | =item MATH LIBRARY |
17090 | ||
17091 | =item SIGN | |
17092 | ||
9038e305 JH |
17093 | =item mantissa(), exponent() and parts() |
17094 | ||
17095 | =back | |
b38f6a39 | 17096 | |
d0363f02 JH |
17097 | =item EXAMPLES |
17098 | ||
3ecb3787 | 17099 | use Math::BigInt; |
d0363f02 | 17100 | |
b38f6a39 | 17101 | =item Autocreating constants |
4a6725af | 17102 | |
9038e305 JH |
17103 | =item PERFORMANCE |
17104 | ||
d0363f02 JH |
17105 | =over 4 |
17106 | ||
758a5d79 | 17107 | =item Alternative math libraries |
d0363f02 | 17108 | |
ff426ff2 JH |
17109 | =item SUBCLASSING |
17110 | ||
17111 | =back | |
17112 | ||
17113 | =item Subclassing Math::BigInt | |
17114 | ||
17115 | =item UPGRADING | |
17116 | ||
17117 | =over 4 | |
17118 | ||
17119 | =item Auto-upgrade | |
17120 | ||
17121 | bsqrt(), div(), blog() | |
17122 | ||
d0363f02 JH |
17123 | =back |
17124 | ||
8ebc5c01 | 17125 | =item BUGS |
7d2bfb28 | 17126 | |
0d53b15f JH |
17127 | broot() does not work, Out of Memory!, Fails to load Calc on Perl prior |
17128 | 5.6.0 | |
9038e305 JH |
17129 | |
17130 | =item CAVEATS | |
17131 | ||
f262848d RGS |
17132 | bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, |
17133 | Modifying and =, bpow, Overloading -$x, Mixing different object types, | |
17134 | bsqrt(), brsft() | |
9038e305 JH |
17135 | |
17136 | =item LICENSE | |
17137 | ||
d0363f02 JH |
17138 | =item SEE ALSO |
17139 | ||
9038e305 | 17140 | =item AUTHORS |
7d2bfb28 | 17141 | |
a45bd81d GS |
17142 | =back |
17143 | ||
d0363f02 JH |
17144 | =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt |
17145 | ||
17146 | =over 4 | |
17147 | ||
17148 | =item SYNOPSIS | |
17149 | ||
17150 | =item DESCRIPTION | |
17151 | ||
0d53b15f JH |
17152 | =item STORAGE |
17153 | ||
17154 | =item METHODS | |
d0363f02 | 17155 | |
758a5d79 JH |
17156 | =item WRAP YOUR OWN |
17157 | ||
d0363f02 JH |
17158 | =item LICENSE |
17159 | ||
17160 | This program is free software; you may redistribute it and/or modify it | |
17161 | under | |
17162 | the same terms as Perl itself. | |
17163 | ||
17164 | =item AUTHORS | |
17165 | ||
17166 | =item SEE ALSO | |
17167 | ||
17168 | =back | |
17169 | ||
2e038148 NC |
17170 | =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code |
17171 | ||
17172 | =over 4 | |
17173 | ||
17174 | =item SYNOPSIS | |
17175 | ||
17176 | =item DESCRIPTION | |
17177 | ||
17178 | =item METHODS | |
17179 | ||
df344c0f NC |
17180 | =over 4 |
17181 | ||
17182 | =item __emu_bxor | |
17183 | ||
17184 | =item __emu_band | |
17185 | ||
17186 | =item __emu_bior | |
17187 | ||
17188 | =back | |
17189 | ||
2e038148 NC |
17190 | =item LICENSE |
17191 | ||
17192 | This program is free software; you may redistribute it and/or modify it | |
17193 | under | |
17194 | the same terms as Perl itself. | |
17195 | ||
17196 | =item AUTHORS | |
17197 | ||
17198 | =item SEE ALSO | |
17199 | ||
17200 | =back | |
17201 | ||
df344c0f | 17202 | =head2 Math::BigRat - Arbitrary big rational numbers |
fa1c7b03 JH |
17203 | |
17204 | =over 4 | |
17205 | ||
17206 | =item SYNOPSIS | |
17207 | ||
17208 | =item DESCRIPTION | |
17209 | ||
17210 | =over 4 | |
17211 | ||
17212 | =item MATH LIBRARY | |
17213 | ||
17214 | =back | |
17215 | ||
17216 | =item METHODS | |
17217 | ||
17218 | =over 4 | |
17219 | ||
a6812a52 | 17220 | =item new() |
fa1c7b03 | 17221 | |
a6812a52 | 17222 | =item numerator() |
fa1c7b03 | 17223 | |
a6812a52 | 17224 | =item denominator() |
fa1c7b03 JH |
17225 | |
17226 | $d = $x->denominator(); | |
17227 | ||
a6812a52 JH |
17228 | =item parts() |
17229 | ||
df344c0f NC |
17230 | =item as_int() |
17231 | ||
17232 | =item as_hex() | |
17233 | ||
17234 | =item as_bin() | |
a6812a52 | 17235 | |
97f7c9df JH |
17236 | =item bfac() |
17237 | ||
17238 | =item blog() | |
a6812a52 JH |
17239 | |
17240 | =item bround()/round()/bfround() | |
fa1c7b03 | 17241 | |
0d53b15f JH |
17242 | =item bmod() |
17243 | ||
2a551100 JH |
17244 | =item is_one() |
17245 | ||
17246 | =item is_zero() | |
17247 | ||
df344c0f | 17248 | =item is_pos() |
2a551100 | 17249 | |
df344c0f | 17250 | =item is_neg() |
2a551100 JH |
17251 | |
17252 | =item is_int() | |
17253 | ||
17254 | =item is_odd() | |
17255 | ||
17256 | =item is_even() | |
17257 | ||
17258 | =item bceil() | |
17259 | ||
17260 | =item bfloor() | |
17261 | ||
17262 | $x->bfloor(); | |
17263 | ||
2e038148 NC |
17264 | =item bsqrt() |
17265 | ||
17266 | $x->bsqrt(); | |
17267 | ||
0d53b15f JH |
17268 | =item config |
17269 | ||
fa1c7b03 JH |
17270 | =back |
17271 | ||
17272 | =item BUGS | |
17273 | ||
2a551100 | 17274 | inf handling (partial), NaN handling (partial), rounding (not implemented |
2e038148 NC |
17275 | except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), |
17276 | blog(), bmodinv() and bmodpow() (partial) | |
2a551100 | 17277 | |
fa1c7b03 JH |
17278 | =item LICENSE |
17279 | ||
17280 | =item SEE ALSO | |
17281 | ||
17282 | =item AUTHORS | |
17283 | ||
17284 | =back | |
17285 | ||
d722968f JH |
17286 | =head2 Math::Complex - complex numbers and associated mathematical |
17287 | functions | |
17288 | ||
d420ca49 | 17289 | =over 4 |
d722968f JH |
17290 | |
17291 | =item SYNOPSIS | |
17292 | ||
17293 | =item DESCRIPTION | |
17294 | ||
17295 | =item OPERATIONS | |
17296 | ||
17297 | =item CREATION | |
17298 | ||
17299 | =item STRINGIFICATION | |
17300 | ||
d420ca49 | 17301 | =over 4 |
d722968f JH |
17302 | |
17303 | =item CHANGED IN PERL 5.6 | |
17304 | ||
17305 | =back | |
17306 | ||
17307 | =item USAGE | |
17308 | ||
17309 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
17310 | ||
17311 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
17312 | ||
17313 | =item BUGS | |
17314 | ||
17315 | =item AUTHORS | |
17316 | ||
17317 | =back | |
17318 | ||
4a6725af NT |
17319 | =head2 Math::Trig - trigonometric functions |
17320 | ||
d420ca49 | 17321 | =over 4 |
a45bd81d | 17322 | |
4a6725af NT |
17323 | =item SYNOPSIS |
17324 | ||
17325 | =item DESCRIPTION | |
17326 | ||
17327 | =item TRIGONOMETRIC FUNCTIONS | |
17328 | ||
fb9cefb4 GS |
17329 | B<tan> |
17330 | ||
d420ca49 | 17331 | =over 4 |
4a6725af | 17332 | |
5cd24f17 | 17333 | =item ERRORS DUE TO DIVISION BY ZERO |
17334 | ||
17335 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
4a6725af NT |
17336 | |
17337 | =back | |
17338 | ||
fb9cefb4 GS |
17339 | =item PLANE ANGLE CONVERSIONS |
17340 | ||
17341 | =item RADIAL COORDINATE CONVERSIONS | |
17342 | ||
d420ca49 | 17343 | =over 4 |
fb9cefb4 GS |
17344 | |
17345 | =item COORDINATE SYSTEMS | |
17346 | ||
17347 | =item 3-D ANGLE CONVERSIONS | |
17348 | ||
17349 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
17350 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
17351 | ||
17352 | =back | |
17353 | ||
0d0e97a6 | 17354 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS |
fb9cefb4 GS |
17355 | |
17356 | =item EXAMPLES | |
4a6725af | 17357 | |
0d0e97a6 JH |
17358 | =over 4 |
17359 | ||
17360 | =item CAVEAT FOR GREAT CIRCLE FORMULAS | |
17361 | ||
17362 | =back | |
17363 | ||
5cd24f17 | 17364 | =item BUGS |
17365 | ||
17366 | =item AUTHORS | |
17367 | ||
a45bd81d GS |
17368 | =back |
17369 | ||
e993db8c | 17370 | =head2 Memoize - Make functions faster by trading space for time |
9038e305 JH |
17371 | |
17372 | =over 4 | |
17373 | ||
17374 | =item SYNOPSIS | |
17375 | ||
17376 | =item DESCRIPTION | |
17377 | ||
17378 | =item DETAILS | |
17379 | ||
17380 | =item OPTIONS | |
17381 | ||
17382 | =over 4 | |
17383 | ||
17384 | =item INSTALL | |
17385 | ||
17386 | =item NORMALIZER | |
17387 | ||
17388 | =item C<SCALAR_CACHE>, C<LIST_CACHE> | |
17389 | ||
17390 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> | |
17391 | ||
17392 | =back | |
17393 | ||
17394 | =item OTHER FACILITIES | |
17395 | ||
17396 | =over 4 | |
17397 | ||
17398 | =item C<unmemoize> | |
17399 | ||
17400 | =item C<flush_cache> | |
17401 | ||
17402 | =back | |
17403 | ||
17404 | =item CAVEATS | |
17405 | ||
17406 | =item PERSISTENT CACHE SUPPORT | |
17407 | ||
17408 | =item EXPIRATION SUPPORT | |
17409 | ||
17410 | =item BUGS | |
17411 | ||
17412 | =item MAILING LIST | |
17413 | ||
17414 | =item AUTHOR | |
17415 | ||
7a49b635 JH |
17416 | =item COPYRIGHT AND LICENSE |
17417 | ||
9038e305 JH |
17418 | =item THANK YOU |
17419 | ||
17420 | =back | |
17421 | ||
17422 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for | |
17423 | Storable use | |
17424 | ||
17425 | =over 4 | |
17426 | ||
17427 | =item DESCRIPTION | |
17428 | ||
17429 | =back | |
17430 | ||
17431 | =head2 Memoize::Expire - Plug-in module for automatic expiration of | |
17432 | memoized values | |
17433 | ||
17434 | =over 4 | |
17435 | ||
17436 | =item SYNOPSIS | |
17437 | ||
17438 | =item DESCRIPTION | |
17439 | ||
17440 | =item INTERFACE | |
17441 | ||
17442 | TIEHASH, EXISTS, STORE | |
17443 | ||
17444 | =item ALTERNATIVES | |
17445 | ||
17446 | =item CAVEATS | |
17447 | ||
17448 | =item AUTHOR | |
17449 | ||
17450 | =item SEE ALSO | |
17451 | ||
17452 | =back | |
17453 | ||
17454 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics | |
17455 | ||
17456 | =over 4 | |
17457 | ||
17458 | =item DESCRIPTION | |
17459 | ||
17460 | =back | |
17461 | ||
17462 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics | |
17463 | ||
17464 | =over 4 | |
17465 | ||
17466 | =item DESCRIPTION | |
17467 | ||
17468 | =back | |
17469 | ||
17470 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for | |
17471 | Storable use | |
17472 | ||
17473 | =over 4 | |
17474 | ||
17475 | =item DESCRIPTION | |
17476 | ||
17477 | =back | |
17478 | ||
17479 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for | |
17480 | Storable use | |
17481 | ||
17482 | =over 4 | |
17483 | ||
17484 | =item DESCRIPTION | |
17485 | ||
17486 | =back | |
17487 | ||
9038e305 JH |
17488 | =head2 Memoize::Storable - store Memoized data in Storable database |
17489 | ||
17490 | =over 4 | |
17491 | ||
17492 | =item DESCRIPTION | |
17493 | ||
17494 | =back | |
17495 | ||
8ebc5c01 | 17496 | =head2 NDBM_File - Tied access to ndbm files |
7d2bfb28 | 17497 | |
d420ca49 | 17498 | =over 4 |
a45bd81d | 17499 | |
8ebc5c01 | 17500 | =item SYNOPSIS |
7d2bfb28 | 17501 | |
4d4e713d JH |
17502 | =item DESCRIPTION |
17503 | ||
a9ef4385 JH |
17504 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
17505 | ||
17506 | =item DIAGNOSTICS | |
17507 | ||
d420ca49 | 17508 | =over 4 |
a9ef4385 JH |
17509 | |
17510 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
17511 | ||
17512 | =back | |
17513 | ||
17514 | =item BUGS AND WARNINGS | |
7d2bfb28 | 17515 | |
a45bd81d GS |
17516 | =back |
17517 | ||
41630250 JH |
17518 | =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method |
17519 | redispatch | |
1fa7ca25 JH |
17520 | |
17521 | =over 4 | |
17522 | ||
17523 | =item SYNOPSIS | |
17524 | ||
17525 | =item DESCRIPTION | |
17526 | ||
428dc699 JH |
17527 | =over 4 |
17528 | ||
17529 | =item Enforcing redispatch | |
17530 | ||
17531 | =item Avoiding repetitions | |
17532 | ||
41630250 JH |
17533 | =item Invoking all versions of a method with a single call |
17534 | ||
17535 | =item Using C<EVERY> methods | |
17536 | ||
428dc699 JH |
17537 | =back |
17538 | ||
1fa7ca25 JH |
17539 | =item AUTHOR |
17540 | ||
17541 | =item BUGS AND IRRITATIONS | |
17542 | ||
17543 | =item COPYRIGHT | |
17544 | ||
17545 | =back | |
17546 | ||
5d80033a JH |
17547 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) |
17548 | ||
17549 | =over 4 | |
17550 | ||
17551 | =item SYNOPSIS | |
17552 | ||
17553 | =item DESCRIPTION | |
17554 | ||
17555 | =item USER METHODS | |
17556 | ||
17557 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), | |
17558 | dataend () | |
17559 | ||
17560 | =item CLASS METHODS | |
17561 | ||
17562 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... | |
17563 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), | |
0d53b15f | 17564 | ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh () |
5d80033a JH |
17565 | |
17566 | =item EXPORTS | |
17567 | ||
17568 | =item AUTHOR | |
17569 | ||
17570 | =item COPYRIGHT | |
17571 | ||
17572 | =back | |
17573 | ||
17574 | =head2 Net::Config - Local configuration data for libnet | |
17575 | ||
17576 | =over 4 | |
17577 | ||
17578 | =item SYNOPSYS | |
17579 | ||
17580 | =item DESCRIPTION | |
17581 | ||
17582 | =item METHODS | |
17583 | ||
17584 | requires_firewall HOST | |
17585 | ||
17586 | =item NetConfig VALUES | |
17587 | ||
17588 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, | |
53d7eaa8 JH |
17589 | time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, |
17590 | ftp_int_pasive, local_netmask, test_hosts, test_exists | |
5d80033a JH |
17591 | |
17592 | =back | |
17593 | ||
17594 | =head2 Net::Domain - Attempt to evaluate the current host's internet name | |
17595 | and domain | |
17596 | ||
17597 | =over 4 | |
17598 | ||
17599 | =item SYNOPSIS | |
17600 | ||
17601 | =item DESCRIPTION | |
17602 | ||
17603 | hostfqdn (), hostname (), hostdomain () | |
17604 | ||
17605 | =item AUTHOR | |
17606 | ||
17607 | =item COPYRIGHT | |
17608 | ||
17609 | =back | |
17610 | ||
5d80033a JH |
17611 | =head2 Net::FTP - FTP Client class |
17612 | ||
17613 | =over 4 | |
17614 | ||
17615 | =item SYNOPSIS | |
17616 | ||
17617 | =item DESCRIPTION | |
17618 | ||
17619 | =item OVERVIEW | |
17620 | ||
17621 | =item CONSTRUCTOR | |
17622 | ||
5f15c94e | 17623 | new ([ HOST ] [, OPTIONS ]) |
5d80033a JH |
17624 | |
17625 | =item METHODS | |
17626 | ||
17627 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), | |
b6235c4f RGS |
17628 | site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME |
17629 | ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [, | |
5f15c94e NC |
17630 | RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls ( |
17631 | [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), | |
17632 | put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE | |
17633 | ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), | |
17634 | size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[ | |
17635 | BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ), | |
17636 | stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (), | |
17637 | pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique ( | |
17638 | SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ), | |
17639 | abort (), quit () | |
5d80033a JH |
17640 | |
17641 | =over 4 | |
17642 | ||
17643 | =item Methods for the adventurous | |
17644 | ||
17645 | quot (CMD [,ARGS]) | |
17646 | ||
17647 | =back | |
17648 | ||
17649 | =item THE dataconn CLASS | |
17650 | ||
17651 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), | |
53d7eaa8 | 17652 | bytes_read (), abort (), close () |
5d80033a JH |
17653 | |
17654 | =item UNIMPLEMENTED | |
17655 | ||
0d53b15f | 17656 | B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> |
5d80033a JH |
17657 | |
17658 | =item REPORTING BUGS | |
17659 | ||
17660 | =item AUTHOR | |
17661 | ||
17662 | =item SEE ALSO | |
17663 | ||
53d7eaa8 JH |
17664 | =item USE EXAMPLES |
17665 | ||
b6235c4f | 17666 | http://www.csh.rit.edu/~adam/Progs/ |
53d7eaa8 | 17667 | |
5d80033a JH |
17668 | =item CREDITS |
17669 | ||
17670 | =item COPYRIGHT | |
17671 | ||
17672 | =back | |
17673 | ||
17674 | =head2 Net::NNTP - NNTP Client class | |
17675 | ||
17676 | =over 4 | |
17677 | ||
17678 | =item SYNOPSIS | |
17679 | ||
17680 | =item DESCRIPTION | |
17681 | ||
17682 | =item CONSTRUCTOR | |
17683 | ||
17684 | new ( [ HOST ] [, OPTIONS ]) | |
17685 | ||
17686 | =item METHODS | |
17687 | ||
17688 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( | |
ff426ff2 JH |
17689 | [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ |
17690 | MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] | |
17691 | ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), | |
17692 | postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, | |
17693 | DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), | |
17694 | post ( [ MESSAGE ] ), postfh (), slave (), quit () | |
5d80033a JH |
17695 | |
17696 | =over 4 | |
17697 | ||
17698 | =item Extension methods | |
17699 | ||
17700 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), | |
17701 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN | |
17702 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( | |
17703 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ | |
17704 | GROUP ] ), reader | |
17705 | ||
17706 | =back | |
17707 | ||
17708 | =item UNSUPPORTED | |
17709 | ||
17710 | =item DEFINITIONS | |
17711 | ||
17712 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> | |
17713 | ||
17714 | =item SEE ALSO | |
17715 | ||
17716 | =item AUTHOR | |
17717 | ||
17718 | =item COPYRIGHT | |
17719 | ||
17720 | =back | |
17721 | ||
ff426ff2 | 17722 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) |
5d80033a JH |
17723 | |
17724 | =over 4 | |
17725 | ||
17726 | =item SYNOPSIS | |
17727 | ||
17728 | =item DESCRIPTION | |
17729 | ||
5d80033a JH |
17730 | =item CONSTRUCTOR |
17731 | ||
5f15c94e | 17732 | new ( [ HOST ] [, OPTIONS ] 0 |
5d80033a JH |
17733 | |
17734 | =item METHODS | |
17735 | ||
5f15c94e NC |
17736 | auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER |
17737 | [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities | |
17738 | (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ] | |
17739 | ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] | |
17740 | ), delete ( MSGNUM ), reset (), quit () | |
5d80033a JH |
17741 | |
17742 | =item NOTES | |
17743 | ||
17744 | =item SEE ALSO | |
17745 | ||
17746 | =item AUTHOR | |
17747 | ||
17748 | =item COPYRIGHT | |
17749 | ||
17750 | =back | |
17751 | ||
8ebc5c01 | 17752 | =head2 Net::Ping - check a remote host for reachability |
7d2bfb28 | 17753 | |
d420ca49 | 17754 | =over 4 |
a45bd81d | 17755 | |
8ebc5c01 | 17756 | =item SYNOPSIS |
7d2bfb28 | 17757 | |
8ebc5c01 | 17758 | =item DESCRIPTION |
7d2bfb28 | 17759 | |
d420ca49 | 17760 | =over 4 |
8ebc5c01 | 17761 | |
17762 | =item Functions | |
7d2bfb28 | 17763 | |
0d53b15f JH |
17764 | Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos |
17765 | ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );, | |
2a551100 JH |
17766 | $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );, |
17767 | $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( | |
17768 | [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host | |
17769 | [, $timeout]); | |
7d2bfb28 | 17770 | |
8ebc5c01 | 17771 | =back |
17772 | ||
8ebc5c01 | 17773 | =item NOTES |
7d2bfb28 | 17774 | |
ea9fba97 JH |
17775 | =item INSTALL |
17776 | ||
2a551100 JH |
17777 | =item BUGS |
17778 | ||
04b01f78 | 17779 | =item AUTHORS |
493a87da JH |
17780 | |
17781 | =item COPYRIGHT | |
17782 | ||
a45bd81d GS |
17783 | =back |
17784 | ||
5d80033a JH |
17785 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client |
17786 | ||
17787 | =over 4 | |
17788 | ||
17789 | =item SYNOPSIS | |
17790 | ||
17791 | =item DESCRIPTION | |
17792 | ||
17793 | =item EXAMPLES | |
17794 | ||
17795 | =item CONSTRUCTOR | |
17796 | ||
5f15c94e | 17797 | new ( [ HOST ] [, OPTIONS ] ) |
5d80033a JH |
17798 | |
17799 | =item METHODS | |
17800 | ||
5f15c94e NC |
17801 | banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth ( |
17802 | USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), | |
17803 | send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( | |
17804 | ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] | |
17805 | ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), | |
17806 | data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ | |
17807 | $subject ] ), quit () | |
5d80033a | 17808 | |
a6812a52 JH |
17809 | =item ADDRESSES |
17810 | ||
5d80033a JH |
17811 | =item SEE ALSO |
17812 | ||
17813 | =item AUTHOR | |
17814 | ||
17815 | =item COPYRIGHT | |
17816 | ||
17817 | =back | |
17818 | ||
5d80033a JH |
17819 | =head2 Net::Time - time and daytime network client interface |
17820 | ||
17821 | =over 4 | |
17822 | ||
17823 | =item SYNOPSIS | |
17824 | ||
17825 | =item DESCRIPTION | |
17826 | ||
17827 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, | |
17828 | PROTOCOL [, TIMEOUT]]]) | |
17829 | ||
17830 | =item AUTHOR | |
17831 | ||
17832 | =item COPYRIGHT | |
17833 | ||
17834 | =back | |
17835 | ||
8ebc5c01 | 17836 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
17837 | functions | |
7d2bfb28 | 17838 | |
d420ca49 | 17839 | =over 4 |
a45bd81d | 17840 | |
8ebc5c01 | 17841 | =item SYNOPSIS |
7d2bfb28 | 17842 | |
8ebc5c01 | 17843 | =item DESCRIPTION |
7d2bfb28 | 17844 | |
cb1a09d0 AD |
17845 | =item EXAMPLES |
17846 | ||
8ebc5c01 | 17847 | =item NOTE |
cb1a09d0 | 17848 | |
8ebc5c01 | 17849 | =item AUTHOR |
cb1a09d0 | 17850 | |
a45bd81d GS |
17851 | =back |
17852 | ||
5d80033a JH |
17853 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions |
17854 | ||
17855 | =over 4 | |
17856 | ||
17857 | =item DESCRIPTION | |
17858 | ||
17859 | =over 4 | |
17860 | ||
17861 | =item Where to get this document | |
17862 | ||
17863 | =item How to contribute to this document | |
17864 | ||
17865 | =back | |
17866 | ||
17867 | =item Author and Copyright Information | |
17868 | ||
17869 | =over 4 | |
17870 | ||
17871 | =item Disclaimer | |
17872 | ||
17873 | =back | |
17874 | ||
17875 | =item Obtaining and installing libnet | |
17876 | ||
17877 | =over 4 | |
17878 | ||
17879 | =item What is libnet ? | |
17880 | ||
17881 | =item Which version of perl do I need ? | |
17882 | ||
17883 | =item What other modules do I need ? | |
17884 | ||
17885 | =item What machines support libnet ? | |
17886 | ||
17887 | =item Where can I get the latest libnet release | |
17888 | ||
17889 | =back | |
17890 | ||
17891 | =item Using Net::FTP | |
17892 | ||
17893 | =over 4 | |
17894 | ||
ba62762e | 17895 | =item How do I download files from an FTP server ? |
5d80033a JH |
17896 | |
17897 | =item How do I transfer files in binary mode ? | |
17898 | ||
17899 | =item How can I get the size of a file on a remote FTP server ? | |
17900 | ||
17901 | =item How can I get the modification time of a file on a remote FTP server | |
17902 | ? | |
17903 | ||
17904 | =item How can I change the permissions of a file on a remote server ? | |
17905 | ||
17906 | =item Can I do a reget operation like the ftp command ? | |
17907 | ||
ba62762e | 17908 | =item How do I get a directory listing from an FTP server ? |
5d80033a | 17909 | |
ba62762e | 17910 | =item Changing directory to "" does not fail ? |
5d80033a JH |
17911 | |
17912 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? | |
17913 | ||
ba62762e | 17914 | =item I am behind an FTP proxy firewall, but cannot access machines outside |
5d80033a JH |
17915 | ? |
17916 | ||
17917 | =item My ftp proxy firewall does not listen on port 21 | |
17918 | ||
17919 | =item Is it possible to change the file permissions of a file on an FTP | |
17920 | server ? | |
17921 | ||
17922 | =item I have seen scripts call a method message, but cannot find it | |
17923 | documented ? | |
17924 | ||
17925 | =item Why does Net::FTP not implement mput and mget methods | |
17926 | ||
17927 | =back | |
17928 | ||
17929 | =item Using Net::SMTP | |
17930 | ||
17931 | =over 4 | |
17932 | ||
17933 | =item Why can't the part of an Email address after the @ be used as the | |
17934 | hostname ? | |
17935 | ||
17936 | =item Why does Net::SMTP not do DNS MX lookups ? | |
17937 | ||
17938 | =item The verify method always returns true ? | |
17939 | ||
17940 | =back | |
17941 | ||
17942 | =item Debugging scripts | |
17943 | ||
17944 | =over 4 | |
17945 | ||
17946 | =item How can I debug my scripts that use Net::* modules ? | |
17947 | ||
17948 | =back | |
17949 | ||
17950 | =item AUTHOR AND COPYRIGHT | |
17951 | ||
17952 | =back | |
17953 | ||
8ebc5c01 | 17954 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
17955 | functions | |
cb1a09d0 | 17956 | |
d420ca49 | 17957 | =over 4 |
a45bd81d | 17958 | |
8ebc5c01 | 17959 | =item SYNOPSIS |
cb1a09d0 | 17960 | |
8ebc5c01 | 17961 | =item DESCRIPTION |
cb1a09d0 | 17962 | |
8ebc5c01 | 17963 | =item EXAMPLES |
cb1a09d0 | 17964 | |
8ebc5c01 | 17965 | =item NOTE |
cb1a09d0 | 17966 | |
8ebc5c01 | 17967 | =item AUTHOR |
cb1a09d0 | 17968 | |
a45bd81d GS |
17969 | =back |
17970 | ||
8ebc5c01 | 17971 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
17972 | functions | |
cb1a09d0 | 17973 | |
d420ca49 | 17974 | =over 4 |
a45bd81d | 17975 | |
8ebc5c01 | 17976 | =item SYNOPSIS |
cb1a09d0 AD |
17977 | |
17978 | =item DESCRIPTION | |
17979 | ||
8ebc5c01 | 17980 | =item NOTE |
cb1a09d0 | 17981 | |
8ebc5c01 | 17982 | =item AUTHOR |
cb1a09d0 | 17983 | |
a45bd81d GS |
17984 | =back |
17985 | ||
8ebc5c01 | 17986 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
17987 | functions | |
cb1a09d0 | 17988 | |
d420ca49 | 17989 | =over 4 |
a45bd81d | 17990 | |
cb1a09d0 AD |
17991 | =item SYNOPSIS |
17992 | ||
cb1a09d0 AD |
17993 | =item DESCRIPTION |
17994 | ||
8ebc5c01 | 17995 | =item EXAMPLES |
cb1a09d0 | 17996 | |
8ebc5c01 | 17997 | =item NOTE |
cb1a09d0 | 17998 | |
8ebc5c01 | 17999 | =item AUTHOR |
cb1a09d0 | 18000 | |
a45bd81d GS |
18001 | =back |
18002 | ||
5d80033a JH |
18003 | =head2 Netrc, Net::Netrc - OO interface to users netrc file |
18004 | ||
18005 | =over 4 | |
18006 | ||
18007 | =item SYNOPSIS | |
18008 | ||
18009 | =item DESCRIPTION | |
18010 | ||
18011 | =item THE .netrc FILE | |
18012 | ||
18013 | machine name, default, login name, password string, account string, macdef | |
18014 | name | |
18015 | ||
18016 | =item CONSTRUCTOR | |
18017 | ||
18018 | lookup ( MACHINE [, LOGIN ]) | |
18019 | ||
18020 | =item METHODS | |
18021 | ||
18022 | login (), password (), account (), lpa () | |
18023 | ||
18024 | =item AUTHOR | |
18025 | ||
18026 | =item SEE ALSO | |
18027 | ||
18028 | =item COPYRIGHT | |
18029 | ||
18030 | =back | |
18031 | ||
639f8edf HS |
18032 | =head2 O - Generic interface to Perl Compiler backends |
18033 | ||
18034 | =over 4 | |
18035 | ||
18036 | =item SYNOPSIS | |
18037 | ||
18038 | =item DESCRIPTION | |
18039 | ||
18040 | =item CONVENTIONS | |
18041 | ||
18042 | =item IMPLEMENTATION | |
18043 | ||
18044 | =item BUGS | |
18045 | ||
18046 | =item AUTHOR | |
18047 | ||
18048 | =back | |
18049 | ||
8ebc5c01 | 18050 | =head2 ODBM_File - Tied access to odbm files |
cb1a09d0 | 18051 | |
d420ca49 | 18052 | =over 4 |
a45bd81d | 18053 | |
cb1a09d0 AD |
18054 | =item SYNOPSIS |
18055 | ||
4d4e713d JH |
18056 | =item DESCRIPTION |
18057 | ||
a9ef4385 JH |
18058 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
18059 | ||
18060 | =item DIAGNOSTICS | |
18061 | ||
d420ca49 | 18062 | =over 4 |
a9ef4385 JH |
18063 | |
18064 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
18065 | ||
18066 | =back | |
18067 | ||
18068 | =item BUGS AND WARNINGS | |
cb1a09d0 | 18069 | |
a45bd81d GS |
18070 | =back |
18071 | ||
8ebc5c01 | 18072 | =head2 Opcode - Disable named opcodes when compiling perl code |
cb1a09d0 | 18073 | |
d420ca49 | 18074 | =over 4 |
a45bd81d | 18075 | |
8ebc5c01 | 18076 | =item SYNOPSIS |
cb1a09d0 | 18077 | |
8ebc5c01 | 18078 | =item DESCRIPTION |
cb1a09d0 | 18079 | |
8ebc5c01 | 18080 | =item NOTE |
cb1a09d0 | 18081 | |
8ebc5c01 | 18082 | =item WARNING |
cb1a09d0 | 18083 | |
8ebc5c01 | 18084 | =item Operator Names and Operator Lists |
cb1a09d0 | 18085 | |
8ebc5c01 | 18086 | an operator name (opname), an operator tag name (optag), a negated opname |
18087 | or optag, an operator set (opset) | |
cb1a09d0 | 18088 | |
8ebc5c01 | 18089 | =item Opcode Functions |
cb1a09d0 | 18090 | |
8ebc5c01 | 18091 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
18092 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
18093 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
18094 | opdump (PAT) | |
cb1a09d0 | 18095 | |
8ebc5c01 | 18096 | =item Manipulating Opsets |
cb1a09d0 | 18097 | |
8ebc5c01 | 18098 | =item TO DO (maybe) |
cb1a09d0 | 18099 | |
a45bd81d GS |
18100 | =back |
18101 | ||
d420ca49 | 18102 | =over 4 |
a45bd81d | 18103 | |
8ebc5c01 | 18104 | =item Predefined Opcode Tags |
cb1a09d0 | 18105 | |
8ebc5c01 | 18106 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
d516a115 JH |
18107 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
18108 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
18109 | :dangerous | |
cb1a09d0 | 18110 | |
8ebc5c01 | 18111 | =item SEE ALSO |
cb1a09d0 | 18112 | |
8ebc5c01 | 18113 | =item AUTHORS |
cb1a09d0 | 18114 | |
a45bd81d GS |
18115 | =back |
18116 | ||
8ebc5c01 | 18117 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
18118 | compartments | |
cb1a09d0 | 18119 | |
d420ca49 | 18120 | =over 4 |
a45bd81d | 18121 | |
cb1a09d0 AD |
18122 | =item SYNOPSIS |
18123 | ||
cb1a09d0 AD |
18124 | =item DESCRIPTION |
18125 | ||
8ebc5c01 | 18126 | a new namespace, an operator mask |
18127 | ||
18128 | =item WARNING | |
cb1a09d0 | 18129 | |
d420ca49 | 18130 | =over 4 |
cb1a09d0 | 18131 | |
8ebc5c01 | 18132 | =item RECENT CHANGES |
cb1a09d0 | 18133 | |
8ebc5c01 | 18134 | =item Methods in class Safe |
cb1a09d0 | 18135 | |
8ebc5c01 | 18136 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
18137 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
18138 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
18139 | root (NAMESPACE), mask (MASK) | |
cb1a09d0 | 18140 | |
8ebc5c01 | 18141 | =item Some Safety Issues |
cb1a09d0 | 18142 | |
8ebc5c01 | 18143 | Memory, CPU, Snooping, Signals, State Changes |
cb1a09d0 | 18144 | |
8ebc5c01 | 18145 | =item AUTHOR |
cb1a09d0 | 18146 | |
8ebc5c01 | 18147 | =back |
cb1a09d0 | 18148 | |
a45bd81d GS |
18149 | =back |
18150 | ||
8ebc5c01 | 18151 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
18152 | compiling | |
cb1a09d0 | 18153 | |
d420ca49 | 18154 | =over 4 |
a45bd81d | 18155 | |
14218588 | 18156 | =item SYNOPSIS |
cb1a09d0 | 18157 | |
8ebc5c01 | 18158 | =item DESCRIPTION |
cb1a09d0 | 18159 | |
8ebc5c01 | 18160 | =item SEE ALSO |
cb1a09d0 | 18161 | |
a45bd81d GS |
18162 | =back |
18163 | ||
cb1a09d0 AD |
18164 | =head2 POSIX - Perl interface to IEEE Std 1003.1 |
18165 | ||
d420ca49 | 18166 | =over 4 |
a45bd81d | 18167 | |
cb1a09d0 AD |
18168 | =item SYNOPSIS |
18169 | ||
cb1a09d0 AD |
18170 | =item DESCRIPTION |
18171 | ||
cb1a09d0 AD |
18172 | =item NOTE |
18173 | ||
8ebc5c01 | 18174 | =item CAVEATS |
cb1a09d0 AD |
18175 | |
18176 | =item FUNCTIONS | |
18177 | ||
8ebc5c01 | 18178 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
18179 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
18180 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
18181 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
18182 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
18183 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
18184 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
2a551100 JH |
18185 | fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, |
18186 | geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, | |
18187 | getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, | |
18188 | isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, | |
18189 | isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, | |
18190 | log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, | |
18191 | memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, | |
18192 | offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, | |
18193 | putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, | |
18194 | rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, | |
18195 | setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
8ebc5c01 | 18196 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, |
18197 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
4755096e GS |
18198 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, |
18199 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
18200 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
18201 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
18202 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
18203 | wctomb, write | |
cb1a09d0 AD |
18204 | |
18205 | =item CLASSES | |
18206 | ||
d420ca49 | 18207 | =over 4 |
cb1a09d0 | 18208 | |
cb1a09d0 AD |
18209 | =item POSIX::SigAction |
18210 | ||
0d53b15f | 18211 | new, handler, mask, flags, safe |
cb1a09d0 AD |
18212 | |
18213 | =item POSIX::SigSet | |
18214 | ||
cb1a09d0 AD |
18215 | new, addset, delset, emptyset, fillset, ismember |
18216 | ||
18217 | =item POSIX::Termios | |
18218 | ||
cb1a09d0 AD |
18219 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
18220 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
18221 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
18222 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
18223 | values, c_oflag field values | |
18224 | ||
cb1a09d0 AD |
18225 | =back |
18226 | ||
18227 | =item PATHNAME CONSTANTS | |
18228 | ||
cb1a09d0 AD |
18229 | Constants |
18230 | ||
18231 | =item POSIX CONSTANTS | |
18232 | ||
cb1a09d0 AD |
18233 | Constants |
18234 | ||
18235 | =item SYSTEM CONFIGURATION | |
18236 | ||
cb1a09d0 AD |
18237 | Constants |
18238 | ||
18239 | =item ERRNO | |
18240 | ||
cb1a09d0 AD |
18241 | Constants |
18242 | ||
18243 | =item FCNTL | |
18244 | ||
cb1a09d0 AD |
18245 | Constants |
18246 | ||
18247 | =item FLOAT | |
18248 | ||
cb1a09d0 AD |
18249 | Constants |
18250 | ||
18251 | =item LIMITS | |
18252 | ||
cb1a09d0 AD |
18253 | Constants |
18254 | ||
18255 | =item LOCALE | |
18256 | ||
cb1a09d0 AD |
18257 | Constants |
18258 | ||
18259 | =item MATH | |
18260 | ||
cb1a09d0 AD |
18261 | Constants |
18262 | ||
18263 | =item SIGNAL | |
18264 | ||
cb1a09d0 AD |
18265 | Constants |
18266 | ||
18267 | =item STAT | |
18268 | ||
cb1a09d0 AD |
18269 | Constants, Macros |
18270 | ||
18271 | =item STDLIB | |
18272 | ||
cb1a09d0 AD |
18273 | Constants |
18274 | ||
18275 | =item STDIO | |
18276 | ||
cb1a09d0 AD |
18277 | Constants |
18278 | ||
18279 | =item TIME | |
18280 | ||
cb1a09d0 AD |
18281 | Constants |
18282 | ||
18283 | =item UNISTD | |
18284 | ||
cb1a09d0 AD |
18285 | Constants |
18286 | ||
18287 | =item WAIT | |
18288 | ||
04b01f78 JH |
18289 | Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, |
18290 | WTERMSIG, WIFSTOPPED, WSTOPSIG | |
cb1a09d0 | 18291 | |
a45bd81d GS |
18292 | =back |
18293 | ||
0d0e97a6 JH |
18294 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* |
18295 | name space | |
18296 | ||
18297 | =over 4 | |
18298 | ||
18299 | =item SYNOPSIS | |
18300 | ||
18301 | =item DESCRIPTION | |
18302 | ||
2baadb76 | 18303 | :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32 |
0d0e97a6 JH |
18304 | |
18305 | =over 4 | |
18306 | ||
2a551100 JH |
18307 | =item Custom Layers |
18308 | ||
18309 | :encoding, :via | |
18310 | ||
033348ab JH |
18311 | =item Alternatives to raw |
18312 | ||
0d0e97a6 JH |
18313 | =item Defaults and how to override them |
18314 | ||
5538b230 | 18315 | =item Querying the layers of filehandles |
2a551100 | 18316 | |
0d0e97a6 JH |
18317 | =back |
18318 | ||
18319 | =item AUTHOR | |
18320 | ||
18321 | =item SEE ALSO | |
18322 | ||
18323 | =back | |
18324 | ||
e934609f JH |
18325 | =head2 PerlIO::encoding - encoding layer |
18326 | ||
18327 | =over 4 | |
18328 | ||
18329 | =item SYNOPSIS | |
18330 | ||
18331 | =item DESCRIPTION | |
18332 | ||
18333 | =item SEE ALSO | |
18334 | ||
18335 | =back | |
18336 | ||
1e54db1a | 18337 | =head2 PerlIO::scalar - in-memory IO, scalar IO |
0d0e97a6 JH |
18338 | |
18339 | =over 4 | |
18340 | ||
18341 | =item SYNOPSIS | |
18342 | ||
18343 | =item DESCRIPTION | |
18344 | ||
1e54db1a JH |
18345 | =item IMPLEMENTATION NOTE |
18346 | ||
0d0e97a6 JH |
18347 | =back |
18348 | ||
e934609f | 18349 | =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl |
0d0e97a6 JH |
18350 | |
18351 | =over 4 | |
18352 | ||
18353 | =item SYNOPSIS | |
18354 | ||
18355 | =item DESCRIPTION | |
18356 | ||
e934609f JH |
18357 | =item EXPECTED METHODS |
18358 | ||
34babc16 | 18359 | $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), |
e969ef56 JH |
18360 | $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]), |
18361 | $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]), | |
18362 | $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh), | |
18363 | $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), | |
18364 | $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), | |
18365 | $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), | |
18366 | $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) | |
0d0e97a6 | 18367 | |
e934609f JH |
18368 | =item EXAMPLES |
18369 | ||
428dc699 JH |
18370 | =over 4 |
18371 | ||
18372 | =item Example - a Hexadecimal Handle | |
18373 | ||
18374 | =back | |
18375 | ||
0d0e97a6 JH |
18376 | =back |
18377 | ||
e934609f | 18378 | =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings |
95fb7f7f JH |
18379 | |
18380 | =over 4 | |
18381 | ||
18382 | =item SYNOPSIS | |
18383 | ||
18384 | =item DESCRIPTION | |
18385 | ||
2e038148 NC |
18386 | =item REQUIRED MODULES |
18387 | ||
95fb7f7f JH |
18388 | =item SEE ALSO |
18389 | ||
41630250 JH |
18390 | =item ACKNOWLEDGEMENTS |
18391 | ||
e934609f JH |
18392 | =item COPYRIGHT |
18393 | ||
95fb7f7f JH |
18394 | =back |
18395 | ||
14218588 GS |
18396 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
18397 | ||
d420ca49 | 18398 | =over 4 |
a45bd81d | 18399 | |
14218588 GS |
18400 | =item SYNOPSIS |
18401 | ||
18402 | =item OPTIONS/ARGUMENTS | |
18403 | ||
d420ca49 | 18404 | =over 4 |
a45bd81d | 18405 | |
694468e3 | 18406 | =item podchecker() |
a45bd81d GS |
18407 | |
18408 | B<-warnings> =E<gt> I<val> | |
18409 | ||
18410 | =back | |
18411 | ||
14218588 GS |
18412 | =item DESCRIPTION |
18413 | ||
694468e3 GS |
18414 | =item DIAGNOSTICS |
18415 | ||
d420ca49 | 18416 | =over 4 |
a45bd81d | 18417 | |
694468e3 GS |
18418 | =item Errors |
18419 | ||
18420 | empty =headn, =over on line I<N> without closing =back, =item without | |
18421 | previous =over, =back without previous =over, No argument for =begin, =end | |
18422 | without =begin, Nested =begin's, =for without formatter specification, | |
18423 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
18424 | interior-sequence "I<SEQ>", nested commands | |
18425 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
18426 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
18427 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
18428 | after =back | |
18429 | ||
a45bd81d GS |
18430 | =item Warnings |
18431 | ||
fb8eeed8 | 18432 | multiple occurrence of link target I<name>, line containing nothing but |
4d4e713d JH |
18433 | whitespace in paragraph, file does not start with =head, previous =item has |
18434 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> | |
18435 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No | |
18436 | items in =over, No argument for =item, empty section in previous paragraph, | |
2a551100 JH |
18437 | Verbatim paragraph in NAME section, =headI<n> without preceding higher |
18438 | level | |
10862624 RF |
18439 | |
18440 | =item Hyperlinks | |
18441 | ||
4d4e713d JH |
18442 | ignoring leading/trailing whitespace in link, (section) in '$page' |
18443 | deprecated, alternative text/node '%s' contains non-escaped | or / | |
a45bd81d | 18444 | |
694468e3 | 18445 | =back |
a45bd81d GS |
18446 | |
18447 | =item RETURN VALUE | |
18448 | ||
14218588 GS |
18449 | =item EXAMPLES |
18450 | ||
694468e3 GS |
18451 | =item INTERFACE |
18452 | ||
18453 | =back | |
18454 | ||
10862624 RF |
18455 | C<Pod::Checker-E<gt>new( %options )> |
18456 | ||
694468e3 GS |
18457 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, |
18458 | @args )> | |
18459 | ||
18460 | C<$checker-E<gt>num_errors()> | |
18461 | ||
2a551100 JH |
18462 | C<$checker-E<gt>num_warnings()> |
18463 | ||
694468e3 GS |
18464 | C<$checker-E<gt>name()> |
18465 | ||
18466 | C<$checker-E<gt>node()> | |
18467 | ||
18468 | C<$checker-E<gt>idx()> | |
18469 | ||
18470 | C<$checker-E<gt>hyperlink()> | |
18471 | ||
d420ca49 | 18472 | =over 4 |
694468e3 | 18473 | |
14218588 GS |
18474 | =item AUTHOR |
18475 | ||
a45bd81d GS |
18476 | =back |
18477 | ||
694468e3 | 18478 | =head2 Pod::Find - find POD documents in directory trees |
a45bd81d | 18479 | |
d420ca49 | 18480 | =over 4 |
a45bd81d GS |
18481 | |
18482 | =item SYNOPSIS | |
18483 | ||
18484 | =item DESCRIPTION | |
18485 | ||
10862624 RF |
18486 | =back |
18487 | ||
d420ca49 | 18488 | =over 4 |
10862624 RF |
18489 | |
18490 | =item C<pod_find( { %opts } , @directories )> | |
a45bd81d | 18491 | |
10862624 RF |
18492 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> |
18493 | 1> | |
18494 | ||
18495 | =back | |
18496 | ||
d420ca49 | 18497 | =over 4 |
10862624 RF |
18498 | |
18499 | =item C<simplify_name( $str )> | |
18500 | ||
18501 | =back | |
18502 | ||
d420ca49 | 18503 | =over 4 |
10862624 RF |
18504 | |
18505 | =item C<pod_where( { %opts }, $pod )> | |
18506 | ||
18507 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
18508 | 1> | |
18509 | ||
18510 | =back | |
18511 | ||
d420ca49 | 18512 | =over 4 |
10862624 RF |
18513 | |
18514 | =item C<contains_pod( $file , $verbose )> | |
18515 | ||
18516 | =back | |
18517 | ||
d420ca49 | 18518 | =over 4 |
a45bd81d GS |
18519 | |
18520 | =item AUTHOR | |
18521 | ||
694468e3 GS |
18522 | =item SEE ALSO |
18523 | ||
a45bd81d GS |
18524 | =back |
18525 | ||
193fb0af | 18526 | =head2 Pod::Html - module to convert pod files to HTML |
54310121 | 18527 | |
d420ca49 | 18528 | =over 4 |
a45bd81d | 18529 | |
54310121 | 18530 | =item SYNOPSIS |
18531 | ||
18532 | =item DESCRIPTION | |
18533 | ||
18534 | =item ARGUMENTS | |
18535 | ||
f262848d RGS |
18536 | backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, |
18537 | htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, | |
18538 | quiet, recurse, title, verbose | |
54310121 | 18539 | |
18540 | =item EXAMPLE | |
18541 | ||
c76ac1ee GS |
18542 | =item ENVIRONMENT |
18543 | ||
54310121 | 18544 | =item AUTHOR |
18545 | ||
54310121 | 18546 | =item SEE ALSO |
18547 | ||
18548 | =item COPYRIGHT | |
18549 | ||
a45bd81d GS |
18550 | =back |
18551 | ||
14218588 GS |
18552 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
18553 | commands, etc. | |
18554 | ||
d420ca49 | 18555 | =over 4 |
a45bd81d | 18556 | |
14218588 GS |
18557 | =item SYNOPSIS |
18558 | ||
18559 | =item REQUIRES | |
18560 | ||
18561 | =item EXPORTS | |
18562 | ||
18563 | =item DESCRIPTION | |
18564 | ||
10862624 RF |
18565 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package |
18566 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
14218588 | 18567 | |
a45bd81d GS |
18568 | =back |
18569 | ||
d420ca49 | 18570 | =over 4 |
a45bd81d | 18571 | |
14218588 GS |
18572 | =item B<Pod::InputSource> |
18573 | ||
a45bd81d GS |
18574 | =back |
18575 | ||
d420ca49 | 18576 | =over 4 |
14218588 GS |
18577 | |
18578 | =item B<new()> | |
18579 | ||
a45bd81d GS |
18580 | =back |
18581 | ||
d420ca49 | 18582 | =over 4 |
a45bd81d | 18583 | |
14218588 GS |
18584 | =item B<name()> |
18585 | ||
a45bd81d GS |
18586 | =back |
18587 | ||
d420ca49 | 18588 | =over 4 |
a45bd81d | 18589 | |
14218588 GS |
18590 | =item B<handle()> |
18591 | ||
a45bd81d GS |
18592 | =back |
18593 | ||
d420ca49 | 18594 | =over 4 |
a45bd81d | 18595 | |
14218588 GS |
18596 | =item B<was_cutting()> |
18597 | ||
18598 | =back | |
18599 | ||
d420ca49 | 18600 | =over 4 |
a45bd81d | 18601 | |
14218588 GS |
18602 | =item B<Pod::Paragraph> |
18603 | ||
a45bd81d GS |
18604 | =back |
18605 | ||
d420ca49 | 18606 | =over 4 |
14218588 | 18607 | |
10862624 | 18608 | =item Pod::Paragraph-E<gt>B<new()> |
14218588 | 18609 | |
a45bd81d GS |
18610 | =back |
18611 | ||
d420ca49 | 18612 | =over 4 |
a45bd81d | 18613 | |
10862624 | 18614 | =item $pod_para-E<gt>B<cmd_name()> |
14218588 | 18615 | |
a45bd81d GS |
18616 | =back |
18617 | ||
d420ca49 | 18618 | =over 4 |
a45bd81d | 18619 | |
10862624 | 18620 | =item $pod_para-E<gt>B<text()> |
14218588 | 18621 | |
a45bd81d GS |
18622 | =back |
18623 | ||
d420ca49 | 18624 | =over 4 |
a45bd81d | 18625 | |
10862624 | 18626 | =item $pod_para-E<gt>B<raw_text()> |
14218588 | 18627 | |
a45bd81d GS |
18628 | =back |
18629 | ||
d420ca49 | 18630 | =over 4 |
a45bd81d | 18631 | |
10862624 | 18632 | =item $pod_para-E<gt>B<cmd_prefix()> |
14218588 | 18633 | |
a45bd81d GS |
18634 | =back |
18635 | ||
d420ca49 | 18636 | =over 4 |
a45bd81d | 18637 | |
10862624 | 18638 | =item $pod_para-E<gt>B<cmd_separator()> |
14218588 | 18639 | |
a45bd81d GS |
18640 | =back |
18641 | ||
d420ca49 | 18642 | =over 4 |
a45bd81d | 18643 | |
10862624 | 18644 | =item $pod_para-E<gt>B<parse_tree()> |
14218588 | 18645 | |
a45bd81d GS |
18646 | =back |
18647 | ||
d420ca49 | 18648 | =over 4 |
a45bd81d | 18649 | |
10862624 | 18650 | =item $pod_para-E<gt>B<file_line()> |
14218588 GS |
18651 | |
18652 | =back | |
18653 | ||
d420ca49 | 18654 | =over 4 |
a45bd81d | 18655 | |
14218588 GS |
18656 | =item B<Pod::InteriorSequence> |
18657 | ||
a45bd81d GS |
18658 | =back |
18659 | ||
d420ca49 | 18660 | =over 4 |
14218588 | 18661 | |
10862624 | 18662 | =item Pod::InteriorSequence-E<gt>B<new()> |
14218588 | 18663 | |
a45bd81d GS |
18664 | =back |
18665 | ||
d420ca49 | 18666 | =over 4 |
a45bd81d | 18667 | |
10862624 | 18668 | =item $pod_seq-E<gt>B<cmd_name()> |
14218588 | 18669 | |
a45bd81d GS |
18670 | =back |
18671 | ||
d420ca49 | 18672 | =over 4 |
a45bd81d | 18673 | |
10862624 | 18674 | =item $pod_seq-E<gt>B<prepend()> |
14218588 | 18675 | |
a45bd81d GS |
18676 | =back |
18677 | ||
d420ca49 | 18678 | =over 4 |
a45bd81d | 18679 | |
10862624 | 18680 | =item $pod_seq-E<gt>B<append()> |
14218588 | 18681 | |
a45bd81d GS |
18682 | =back |
18683 | ||
d420ca49 | 18684 | =over 4 |
a45bd81d | 18685 | |
10862624 | 18686 | =item $pod_seq-E<gt>B<nested()> |
14218588 | 18687 | |
a45bd81d GS |
18688 | =back |
18689 | ||
d420ca49 | 18690 | =over 4 |
a45bd81d | 18691 | |
10862624 | 18692 | =item $pod_seq-E<gt>B<raw_text()> |
14218588 | 18693 | |
a45bd81d GS |
18694 | =back |
18695 | ||
d420ca49 | 18696 | =over 4 |
a45bd81d | 18697 | |
10862624 | 18698 | =item $pod_seq-E<gt>B<left_delimiter()> |
14218588 | 18699 | |
a45bd81d GS |
18700 | =back |
18701 | ||
d420ca49 | 18702 | =over 4 |
a45bd81d | 18703 | |
10862624 | 18704 | =item $pod_seq-E<gt>B<right_delimiter()> |
14218588 | 18705 | |
a45bd81d GS |
18706 | =back |
18707 | ||
d420ca49 | 18708 | =over 4 |
a45bd81d | 18709 | |
10862624 | 18710 | =item $pod_seq-E<gt>B<parse_tree()> |
14218588 | 18711 | |
a45bd81d GS |
18712 | =back |
18713 | ||
d420ca49 | 18714 | =over 4 |
a45bd81d | 18715 | |
10862624 | 18716 | =item $pod_seq-E<gt>B<file_line()> |
14218588 | 18717 | |
a45bd81d GS |
18718 | =back |
18719 | ||
d420ca49 | 18720 | =over 4 |
a45bd81d | 18721 | |
10862624 | 18722 | =item Pod::InteriorSequence::B<DESTROY()> |
14218588 GS |
18723 | |
18724 | =back | |
18725 | ||
d420ca49 | 18726 | =over 4 |
a45bd81d | 18727 | |
14218588 GS |
18728 | =item B<Pod::ParseTree> |
18729 | ||
a45bd81d GS |
18730 | =back |
18731 | ||
d420ca49 | 18732 | =over 4 |
14218588 | 18733 | |
10862624 | 18734 | =item Pod::ParseTree-E<gt>B<new()> |
14218588 | 18735 | |
a45bd81d GS |
18736 | =back |
18737 | ||
d420ca49 | 18738 | =over 4 |
a45bd81d | 18739 | |
10862624 | 18740 | =item $ptree-E<gt>B<top()> |
14218588 | 18741 | |
a45bd81d GS |
18742 | =back |
18743 | ||
d420ca49 | 18744 | =over 4 |
a45bd81d | 18745 | |
10862624 | 18746 | =item $ptree-E<gt>B<children()> |
14218588 | 18747 | |
a45bd81d GS |
18748 | =back |
18749 | ||
d420ca49 | 18750 | =over 4 |
a45bd81d | 18751 | |
10862624 | 18752 | =item $ptree-E<gt>B<prepend()> |
14218588 | 18753 | |
a45bd81d GS |
18754 | =back |
18755 | ||
d420ca49 | 18756 | =over 4 |
a45bd81d | 18757 | |
10862624 | 18758 | =item $ptree-E<gt>B<append()> |
14218588 | 18759 | |
a45bd81d GS |
18760 | =back |
18761 | ||
d420ca49 | 18762 | =over 4 |
a45bd81d | 18763 | |
10862624 | 18764 | =item $ptree-E<gt>B<raw_text()> |
14218588 | 18765 | |
a45bd81d GS |
18766 | =back |
18767 | ||
d420ca49 | 18768 | =over 4 |
a45bd81d | 18769 | |
10862624 | 18770 | =item Pod::ParseTree::B<DESTROY()> |
14218588 GS |
18771 | |
18772 | =back | |
18773 | ||
d420ca49 | 18774 | =over 4 |
a45bd81d | 18775 | |
14218588 GS |
18776 | =item SEE ALSO |
18777 | ||
18778 | =item AUTHOR | |
18779 | ||
a45bd81d GS |
18780 | =back |
18781 | ||
497711e7 GS |
18782 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex |
18783 | ||
d420ca49 | 18784 | =over 4 |
497711e7 GS |
18785 | |
18786 | =item SYNOPSIS | |
18787 | ||
18788 | =item DESCRIPTION | |
18789 | ||
18790 | =back | |
18791 | ||
d420ca49 | 18792 | =over 4 |
497711e7 GS |
18793 | |
18794 | =item OBJECT METHODS | |
18795 | ||
18796 | C<initialize> | |
18797 | ||
18798 | =back | |
18799 | ||
d420ca49 | 18800 | =over 4 |
497711e7 GS |
18801 | |
18802 | =item Data Accessors | |
18803 | ||
18804 | B<AddPreamble> | |
18805 | ||
18806 | =back | |
18807 | ||
18808 | B<AddPostamble> | |
18809 | ||
18810 | B<Head1Level> | |
18811 | ||
18812 | B<Label> | |
18813 | ||
18814 | B<LevelNoNum> | |
18815 | ||
18816 | B<MakeIndex> | |
18817 | ||
18818 | B<ReplaceNAMEwithSection> | |
18819 | ||
18820 | B<StartWithNewPage> | |
18821 | ||
18822 | B<TableOfContents> | |
18823 | ||
18824 | B<UniqueLabels> | |
18825 | ||
18826 | B<UserPreamble> | |
18827 | ||
18828 | B<UserPostamble> | |
18829 | ||
18830 | B<Lists> | |
18831 | ||
d420ca49 | 18832 | =over 4 |
497711e7 GS |
18833 | |
18834 | =item Subclassed methods | |
18835 | ||
18836 | =back | |
18837 | ||
18838 | B<begin_pod> | |
18839 | ||
18840 | B<end_pod> | |
18841 | ||
18842 | B<command> | |
18843 | ||
18844 | B<verbatim> | |
18845 | ||
18846 | B<textblock> | |
18847 | ||
18848 | B<interior_sequence> | |
18849 | ||
d420ca49 | 18850 | =over 4 |
497711e7 GS |
18851 | |
18852 | =item List Methods | |
18853 | ||
18854 | B<begin_list> | |
18855 | ||
18856 | =back | |
18857 | ||
18858 | B<end_list> | |
18859 | ||
18860 | B<add_item> | |
18861 | ||
d420ca49 | 18862 | =over 4 |
497711e7 GS |
18863 | |
18864 | =item Methods for headings | |
18865 | ||
18866 | B<head> | |
18867 | ||
18868 | =back | |
18869 | ||
d420ca49 | 18870 | =over 4 |
497711e7 GS |
18871 | |
18872 | =item Internal methods | |
18873 | ||
18874 | B<_output> | |
18875 | ||
18876 | =back | |
18877 | ||
18878 | B<_replace_special_chars> | |
18879 | ||
428dc699 JH |
18880 | B<_replace_special_chars_late> |
18881 | ||
497711e7 GS |
18882 | B<_create_label> |
18883 | ||
18884 | B<_create_index> | |
18885 | ||
18886 | B<_clean_latex_commands> | |
18887 | ||
428dc699 JH |
18888 | B<_split_delimited> |
18889 | ||
d420ca49 | 18890 | =over 4 |
497711e7 GS |
18891 | |
18892 | =item NOTES | |
18893 | ||
18894 | =item SEE ALSO | |
18895 | ||
18896 | =item AUTHORS | |
18897 | ||
18898 | =item COPYRIGHT | |
18899 | ||
18900 | =item REVISION | |
18901 | ||
18902 | =back | |
18903 | ||
c76ac1ee GS |
18904 | =head2 Pod::Man - Convert POD data to formatted *roff input |
18905 | ||
d420ca49 | 18906 | =over 4 |
a45bd81d | 18907 | |
c76ac1ee GS |
18908 | =item SYNOPSIS |
18909 | ||
18910 | =item DESCRIPTION | |
18911 | ||
07fcf8ff | 18912 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, |
91331b4f | 18913 | release, section |
c76ac1ee GS |
18914 | |
18915 | =item DIAGNOSTICS | |
18916 | ||
91331b4f | 18917 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote |
9cd42e2a | 18918 | specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown |
34babc16 JH |
18919 | escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched |
18920 | =back | |
c76ac1ee GS |
18921 | |
18922 | =item BUGS | |
18923 | ||
34babc16 JH |
18924 | =item CAVEATS |
18925 | ||
c76ac1ee GS |
18926 | =item SEE ALSO |
18927 | ||
18928 | =item AUTHOR | |
18929 | ||
d0363f02 JH |
18930 | =item COPYRIGHT AND LICENSE |
18931 | ||
a45bd81d GS |
18932 | =back |
18933 | ||
69dc652e | 18934 | =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text |
07fcf8ff JH |
18935 | |
18936 | =over 4 | |
18937 | ||
18938 | =item SYNOPSIS | |
18939 | ||
18940 | =item DESCRIPTION | |
18941 | ||
69dc652e JH |
18942 | =item SEE ALSO |
18943 | ||
07fcf8ff JH |
18944 | =item AUTHOR |
18945 | ||
18946 | =item COPYRIGHT AND LICENSE | |
18947 | ||
18948 | =back | |
18949 | ||
694468e3 GS |
18950 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion |
18951 | ||
d420ca49 | 18952 | =over 4 |
694468e3 GS |
18953 | |
18954 | =item SYNOPSIS | |
18955 | ||
18956 | =item DESCRIPTION | |
18957 | ||
18958 | =back | |
18959 | ||
d420ca49 | 18960 | =over 4 |
694468e3 GS |
18961 | |
18962 | =item Pod::List | |
18963 | ||
10862624 | 18964 | Pod::List-E<gt>new() |
694468e3 GS |
18965 | |
18966 | =back | |
18967 | ||
10862624 | 18968 | $list-E<gt>file() |
694468e3 | 18969 | |
10862624 | 18970 | $list-E<gt>start() |
694468e3 | 18971 | |
10862624 | 18972 | $list-E<gt>indent() |
694468e3 | 18973 | |
10862624 | 18974 | $list-E<gt>type() |
694468e3 | 18975 | |
10862624 | 18976 | $list-E<gt>rx() |
694468e3 | 18977 | |
10862624 | 18978 | $list-E<gt>item() |
694468e3 | 18979 | |
10862624 | 18980 | $list-E<gt>parent() |
694468e3 | 18981 | |
10862624 | 18982 | $list-E<gt>tag() |
694468e3 | 18983 | |
d420ca49 | 18984 | =over 4 |
694468e3 GS |
18985 | |
18986 | =item Pod::Hyperlink | |
18987 | ||
10862624 | 18988 | Pod::Hyperlink-E<gt>new() |
694468e3 GS |
18989 | |
18990 | =back | |
18991 | ||
10862624 | 18992 | $link-E<gt>parse($string) |
694468e3 | 18993 | |
10862624 | 18994 | $link-E<gt>markup($string) |
694468e3 | 18995 | |
10862624 | 18996 | $link-E<gt>text() |
694468e3 | 18997 | |
10862624 | 18998 | $link-E<gt>warning() |
694468e3 | 18999 | |
10862624 | 19000 | $link-E<gt>file(), $link-E<gt>line() |
694468e3 | 19001 | |
10862624 | 19002 | $link-E<gt>page() |
694468e3 | 19003 | |
10862624 | 19004 | $link-E<gt>node() |
694468e3 | 19005 | |
10862624 | 19006 | $link-E<gt>alttext() |
694468e3 | 19007 | |
10862624 | 19008 | $link-E<gt>type() |
694468e3 | 19009 | |
10862624 | 19010 | $link-E<gt>link() |
694468e3 | 19011 | |
d420ca49 | 19012 | =over 4 |
694468e3 GS |
19013 | |
19014 | =item Pod::Cache | |
19015 | ||
10862624 | 19016 | Pod::Cache-E<gt>new() |
694468e3 GS |
19017 | |
19018 | =back | |
19019 | ||
10862624 | 19020 | $cache-E<gt>item() |
694468e3 | 19021 | |
10862624 | 19022 | $cache-E<gt>find_page($name) |
694468e3 | 19023 | |
d420ca49 | 19024 | =over 4 |
694468e3 GS |
19025 | |
19026 | =item Pod::Cache::Item | |
19027 | ||
10862624 | 19028 | Pod::Cache::Item-E<gt>new() |
694468e3 GS |
19029 | |
19030 | =back | |
19031 | ||
10862624 | 19032 | $cacheitem-E<gt>page() |
694468e3 | 19033 | |
10862624 | 19034 | $cacheitem-E<gt>description() |
694468e3 | 19035 | |
10862624 | 19036 | $cacheitem-E<gt>path() |
694468e3 | 19037 | |
10862624 | 19038 | $cacheitem-E<gt>file() |
694468e3 | 19039 | |
10862624 | 19040 | $cacheitem-E<gt>nodes() |
694468e3 | 19041 | |
10862624 | 19042 | $cacheitem-E<gt>find_node($name) |
694468e3 | 19043 | |
10862624 | 19044 | $cacheitem-E<gt>idx() |
694468e3 | 19045 | |
d420ca49 | 19046 | =over 4 |
694468e3 GS |
19047 | |
19048 | =item AUTHOR | |
19049 | ||
19050 | =item SEE ALSO | |
19051 | ||
19052 | =back | |
19053 | ||
14218588 GS |
19054 | =head2 Pod::Parser - base class for creating POD filters and translators |
19055 | ||
d420ca49 | 19056 | =over 4 |
a45bd81d | 19057 | |
14218588 GS |
19058 | =item SYNOPSIS |
19059 | ||
19060 | =item REQUIRES | |
19061 | ||
19062 | =item EXPORTS | |
19063 | ||
19064 | =item DESCRIPTION | |
19065 | ||
19066 | =item QUICK OVERVIEW | |
19067 | ||
c76ac1ee GS |
19068 | =item PARSING OPTIONS |
19069 | ||
b38f6a39 GS |
19070 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), |
19071 | B<-warnings> (default: unset) | |
c76ac1ee | 19072 | |
a45bd81d GS |
19073 | =back |
19074 | ||
d420ca49 | 19075 | =over 4 |
a45bd81d | 19076 | |
14218588 GS |
19077 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES |
19078 | ||
a45bd81d GS |
19079 | =back |
19080 | ||
d420ca49 | 19081 | =over 4 |
a45bd81d | 19082 | |
14218588 GS |
19083 | =item B<command()> |
19084 | ||
19085 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
19086 | ||
a45bd81d GS |
19087 | =back |
19088 | ||
d420ca49 | 19089 | =over 4 |
a45bd81d | 19090 | |
14218588 GS |
19091 | =item B<verbatim()> |
19092 | ||
19093 | C<$text>, C<$line_num>, C<$pod_para> | |
19094 | ||
a45bd81d GS |
19095 | =back |
19096 | ||
d420ca49 | 19097 | =over 4 |
a45bd81d | 19098 | |
14218588 GS |
19099 | =item B<textblock()> |
19100 | ||
19101 | C<$text>, C<$line_num>, C<$pod_para> | |
19102 | ||
a45bd81d GS |
19103 | =back |
19104 | ||
d420ca49 | 19105 | =over 4 |
a45bd81d | 19106 | |
14218588 GS |
19107 | =item B<interior_sequence()> |
19108 | ||
a45bd81d GS |
19109 | =back |
19110 | ||
d420ca49 | 19111 | =over 4 |
a45bd81d | 19112 | |
14218588 GS |
19113 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES |
19114 | ||
a45bd81d GS |
19115 | =back |
19116 | ||
d420ca49 | 19117 | =over 4 |
a45bd81d | 19118 | |
14218588 GS |
19119 | =item B<new()> |
19120 | ||
a45bd81d GS |
19121 | =back |
19122 | ||
d420ca49 | 19123 | =over 4 |
a45bd81d | 19124 | |
14218588 GS |
19125 | =item B<initialize()> |
19126 | ||
a45bd81d GS |
19127 | =back |
19128 | ||
d420ca49 | 19129 | =over 4 |
a45bd81d | 19130 | |
14218588 GS |
19131 | =item B<begin_pod()> |
19132 | ||
a45bd81d GS |
19133 | =back |
19134 | ||
d420ca49 | 19135 | =over 4 |
a45bd81d | 19136 | |
14218588 GS |
19137 | =item B<begin_input()> |
19138 | ||
a45bd81d GS |
19139 | =back |
19140 | ||
d420ca49 | 19141 | =over 4 |
a45bd81d | 19142 | |
14218588 GS |
19143 | =item B<end_input()> |
19144 | ||
a45bd81d GS |
19145 | =back |
19146 | ||
d420ca49 | 19147 | =over 4 |
a45bd81d | 19148 | |
14218588 GS |
19149 | =item B<end_pod()> |
19150 | ||
a45bd81d GS |
19151 | =back |
19152 | ||
d420ca49 | 19153 | =over 4 |
a45bd81d | 19154 | |
14218588 GS |
19155 | =item B<preprocess_line()> |
19156 | ||
a45bd81d GS |
19157 | =back |
19158 | ||
d420ca49 | 19159 | =over 4 |
a45bd81d | 19160 | |
14218588 GS |
19161 | =item B<preprocess_paragraph()> |
19162 | ||
a45bd81d GS |
19163 | =back |
19164 | ||
d420ca49 | 19165 | =over 4 |
a45bd81d | 19166 | |
14218588 GS |
19167 | =item METHODS FOR PARSING AND PROCESSING |
19168 | ||
a45bd81d GS |
19169 | =back |
19170 | ||
d420ca49 | 19171 | =over 4 |
a45bd81d | 19172 | |
14218588 GS |
19173 | =item B<parse_text()> |
19174 | ||
c76ac1ee GS |
19175 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> |
19176 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
14218588 GS |
19177 | I<code-ref>|I<method-name> |
19178 | ||
a45bd81d GS |
19179 | =back |
19180 | ||
d420ca49 | 19181 | =over 4 |
a45bd81d | 19182 | |
14218588 GS |
19183 | =item B<interpolate()> |
19184 | ||
a45bd81d GS |
19185 | =back |
19186 | ||
d420ca49 | 19187 | =over 4 |
a45bd81d | 19188 | |
14218588 GS |
19189 | =item B<parse_paragraph()> |
19190 | ||
a45bd81d GS |
19191 | =back |
19192 | ||
d420ca49 | 19193 | =over 4 |
a45bd81d | 19194 | |
14218588 GS |
19195 | =item B<parse_from_filehandle()> |
19196 | ||
a45bd81d GS |
19197 | =back |
19198 | ||
d420ca49 | 19199 | =over 4 |
a45bd81d | 19200 | |
14218588 GS |
19201 | =item B<parse_from_file()> |
19202 | ||
a45bd81d GS |
19203 | =back |
19204 | ||
d420ca49 | 19205 | =over 4 |
a45bd81d | 19206 | |
14218588 GS |
19207 | =item ACCESSOR METHODS |
19208 | ||
a45bd81d GS |
19209 | =back |
19210 | ||
d420ca49 | 19211 | =over 4 |
a45bd81d | 19212 | |
c76ac1ee GS |
19213 | =item B<errorsub()> |
19214 | ||
a45bd81d GS |
19215 | =back |
19216 | ||
d420ca49 | 19217 | =over 4 |
a45bd81d | 19218 | |
14218588 GS |
19219 | =item B<cutting()> |
19220 | ||
a45bd81d GS |
19221 | =back |
19222 | ||
d420ca49 | 19223 | =over 4 |
a45bd81d | 19224 | |
c76ac1ee GS |
19225 | =item B<parseopts()> |
19226 | ||
a45bd81d GS |
19227 | =back |
19228 | ||
d420ca49 | 19229 | =over 4 |
a45bd81d | 19230 | |
14218588 GS |
19231 | =item B<output_file()> |
19232 | ||
a45bd81d GS |
19233 | =back |
19234 | ||
d420ca49 | 19235 | =over 4 |
a45bd81d | 19236 | |
14218588 GS |
19237 | =item B<output_handle()> |
19238 | ||
a45bd81d GS |
19239 | =back |
19240 | ||
d420ca49 | 19241 | =over 4 |
a45bd81d | 19242 | |
14218588 GS |
19243 | =item B<input_file()> |
19244 | ||
a45bd81d GS |
19245 | =back |
19246 | ||
d420ca49 | 19247 | =over 4 |
a45bd81d | 19248 | |
14218588 GS |
19249 | =item B<input_handle()> |
19250 | ||
a45bd81d GS |
19251 | =back |
19252 | ||
d420ca49 | 19253 | =over 4 |
a45bd81d | 19254 | |
14218588 GS |
19255 | =item B<input_streams()> |
19256 | ||
a45bd81d GS |
19257 | =back |
19258 | ||
d420ca49 | 19259 | =over 4 |
a45bd81d GS |
19260 | |
19261 | =item B<top_stream()> | |
19262 | ||
19263 | =back | |
19264 | ||
d420ca49 | 19265 | =over 4 |
14218588 GS |
19266 | |
19267 | =item PRIVATE METHODS AND DATA | |
19268 | ||
a45bd81d GS |
19269 | =back |
19270 | ||
d420ca49 | 19271 | =over 4 |
a45bd81d | 19272 | |
14218588 GS |
19273 | =item B<_push_input_stream()> |
19274 | ||
a45bd81d GS |
19275 | =back |
19276 | ||
d420ca49 | 19277 | =over 4 |
a45bd81d | 19278 | |
14218588 GS |
19279 | =item B<_pop_input_stream()> |
19280 | ||
a45bd81d GS |
19281 | =back |
19282 | ||
d420ca49 | 19283 | =over 4 |
a45bd81d | 19284 | |
c76ac1ee | 19285 | =item TREE-BASED PARSING |
14218588 GS |
19286 | |
19287 | =item SEE ALSO | |
19288 | ||
19289 | =item AUTHOR | |
19290 | ||
a45bd81d GS |
19291 | =back |
19292 | ||
2a551100 JH |
19293 | =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors |
19294 | ||
19295 | =over 4 | |
19296 | ||
19297 | =item SYNOPSIS | |
19298 | ||
19299 | =item DESCRIPTION | |
19300 | ||
19301 | =item SEE ALSO | |
19302 | ||
19303 | =item COPYRIGHT AND DISCLAIMERS | |
19304 | ||
19305 | =item AUTHOR | |
19306 | ||
19307 | =back | |
19308 | ||
19309 | =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages | |
19310 | ||
19311 | =over 4 | |
19312 | ||
19313 | =item SYNOPSIS | |
19314 | ||
19315 | =item DESCRIPTION | |
19316 | ||
19317 | =item CAVEAT | |
19318 | ||
19319 | =item SEE ALSO | |
19320 | ||
19321 | =item COPYRIGHT AND DISCLAIMERS | |
19322 | ||
19323 | =item AUTHOR | |
19324 | ||
19325 | =back | |
19326 | ||
19327 | =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff | |
19328 | ||
19329 | =over 4 | |
19330 | ||
19331 | =item SYNOPSIS | |
19332 | ||
19333 | =item DESCRIPTION | |
19334 | ||
19335 | =item CAVEAT | |
19336 | ||
19337 | =item SEE ALSO | |
19338 | ||
19339 | =item COPYRIGHT AND DISCLAIMERS | |
19340 | ||
19341 | =item AUTHOR | |
19342 | ||
19343 | =back | |
19344 | ||
19345 | =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod! | |
19346 | ||
19347 | =over 4 | |
19348 | ||
19349 | =item SYNOPSIS | |
19350 | ||
19351 | =item DESCRIPTION | |
19352 | ||
19353 | =item SEE ALSO | |
19354 | ||
19355 | =item COPYRIGHT AND DISCLAIMERS | |
19356 | ||
19357 | =item AUTHOR | |
19358 | ||
19359 | =back | |
19360 | ||
19361 | =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF | |
19362 | ||
19363 | =over 4 | |
19364 | ||
19365 | =item SYNOPSIS | |
19366 | ||
19367 | =item DESCRIPTION | |
19368 | ||
19369 | =item SEE ALSO | |
19370 | ||
19371 | =item COPYRIGHT AND DISCLAIMERS | |
19372 | ||
19373 | =item AUTHOR | |
19374 | ||
19375 | =back | |
19376 | ||
19377 | =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext | |
19378 | ||
19379 | =over 4 | |
19380 | ||
19381 | =item SYNOPSIS | |
19382 | ||
19383 | =item DESCRIPTION | |
19384 | ||
19385 | =item CAVEAT | |
19386 | ||
19387 | =item SEE ALSO | |
19388 | ||
19389 | =item COPYRIGHT AND DISCLAIMERS | |
19390 | ||
19391 | =item AUTHOR | |
19392 | ||
19393 | =back | |
19394 | ||
19395 | =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod | |
19396 | ||
19397 | =over 4 | |
19398 | ||
19399 | =item SYNOPSIS | |
19400 | ||
19401 | =item DESCRIPTION | |
19402 | ||
19403 | =item SEE ALSO | |
19404 | ||
19405 | =item AUTHOR | |
19406 | ||
19407 | =back | |
19408 | ||
19409 | =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML | |
19410 | ||
19411 | =over 4 | |
19412 | ||
19413 | =item SYNOPSIS | |
19414 | ||
19415 | =item DESCRIPTION | |
19416 | ||
19417 | =item SEE ALSO | |
19418 | ||
19419 | =item COPYRIGHT AND DISCLAIMERS | |
19420 | ||
19421 | =item AUTHOR | |
19422 | ||
19423 | =back | |
19424 | ||
19425 | =head2 Pod::PlainText - Convert POD data to formatted ASCII text | |
19426 | ||
19427 | =over 4 | |
19428 | ||
19429 | =item SYNOPSIS | |
19430 | ||
19431 | =item DESCRIPTION | |
19432 | ||
19433 | alt, indent, loose, sentence, width | |
19434 | ||
19435 | =item DIAGNOSTICS | |
19436 | ||
19437 | Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s, | |
19438 | Unknown sequence: %s, Unmatched =back | |
19439 | ||
19440 | =item RESTRICTIONS | |
19441 | ||
19442 | =item NOTES | |
19443 | ||
19444 | =item SEE ALSO | |
19445 | ||
19446 | =item AUTHOR | |
19447 | ||
19448 | =back | |
19449 | ||
b38f6a39 GS |
19450 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. |
19451 | ||
d420ca49 | 19452 | =over 4 |
b38f6a39 GS |
19453 | |
19454 | =item SYNOPSIS | |
19455 | ||
19456 | =item DESCRIPTION | |
19457 | ||
d420ca49 | 19458 | =over 4 |
b38f6a39 GS |
19459 | |
19460 | =item EXPORT | |
19461 | ||
19462 | =back | |
19463 | ||
19464 | =item AUTHOR | |
19465 | ||
19466 | =item SEE ALSO | |
19467 | ||
19468 | =back | |
19469 | ||
14218588 GS |
19470 | =head2 Pod::Select, podselect() - extract selected sections of POD from |
19471 | input | |
19472 | ||
d420ca49 | 19473 | =over 4 |
a45bd81d | 19474 | |
14218588 GS |
19475 | =item SYNOPSIS |
19476 | ||
19477 | =item REQUIRES | |
19478 | ||
19479 | =item EXPORTS | |
19480 | ||
19481 | =item DESCRIPTION | |
19482 | ||
19483 | =item SECTION SPECIFICATIONS | |
19484 | ||
19485 | =item RANGE SPECIFICATIONS | |
19486 | ||
a45bd81d GS |
19487 | =back |
19488 | ||
d420ca49 | 19489 | =over 4 |
a45bd81d | 19490 | |
14218588 GS |
19491 | =item OBJECT METHODS |
19492 | ||
a45bd81d GS |
19493 | =back |
19494 | ||
d420ca49 | 19495 | =over 4 |
a45bd81d | 19496 | |
14218588 GS |
19497 | =item B<curr_headings()> |
19498 | ||
a45bd81d GS |
19499 | =back |
19500 | ||
d420ca49 | 19501 | =over 4 |
a45bd81d | 19502 | |
14218588 GS |
19503 | =item B<select()> |
19504 | ||
a45bd81d GS |
19505 | =back |
19506 | ||
d420ca49 | 19507 | =over 4 |
a45bd81d | 19508 | |
14218588 GS |
19509 | =item B<add_selection()> |
19510 | ||
a45bd81d GS |
19511 | =back |
19512 | ||
d420ca49 | 19513 | =over 4 |
a45bd81d | 19514 | |
14218588 GS |
19515 | =item B<clear_selections()> |
19516 | ||
a45bd81d GS |
19517 | =back |
19518 | ||
d420ca49 | 19519 | =over 4 |
a45bd81d | 19520 | |
14218588 GS |
19521 | =item B<match_section()> |
19522 | ||
a45bd81d GS |
19523 | =back |
19524 | ||
d420ca49 | 19525 | =over 4 |
a45bd81d | 19526 | |
14218588 GS |
19527 | =item B<is_selected()> |
19528 | ||
a45bd81d GS |
19529 | =back |
19530 | ||
d420ca49 | 19531 | =over 4 |
a45bd81d | 19532 | |
14218588 GS |
19533 | =item EXPORTED FUNCTIONS |
19534 | ||
a45bd81d GS |
19535 | =back |
19536 | ||
d420ca49 | 19537 | =over 4 |
a45bd81d | 19538 | |
14218588 GS |
19539 | =item B<podselect()> |
19540 | ||
19541 | B<-output>, B<-sections>, B<-ranges> | |
19542 | ||
a45bd81d GS |
19543 | =back |
19544 | ||
d420ca49 | 19545 | =over 4 |
a45bd81d | 19546 | |
14218588 GS |
19547 | =item PRIVATE METHODS AND DATA |
19548 | ||
a45bd81d GS |
19549 | =back |
19550 | ||
d420ca49 | 19551 | =over 4 |
a45bd81d | 19552 | |
14218588 GS |
19553 | =item B<_compile_section_spec()> |
19554 | ||
a45bd81d GS |
19555 | =back |
19556 | ||
d420ca49 | 19557 | =over 4 |
14218588 GS |
19558 | |
19559 | =item $self->{_SECTION_HEADINGS} | |
19560 | ||
a45bd81d GS |
19561 | =back |
19562 | ||
d420ca49 | 19563 | =over 4 |
a45bd81d | 19564 | |
14218588 GS |
19565 | =item $self->{_SELECTED_SECTIONS} |
19566 | ||
19567 | =back | |
19568 | ||
d420ca49 | 19569 | =over 4 |
a45bd81d | 19570 | |
14218588 GS |
19571 | =item SEE ALSO |
19572 | ||
19573 | =item AUTHOR | |
19574 | ||
a45bd81d GS |
19575 | =back |
19576 | ||
c76ac1ee | 19577 | =head2 Pod::Text - Convert POD data to formatted ASCII text |
402d0d99 | 19578 | |
d420ca49 | 19579 | =over 4 |
a45bd81d | 19580 | |
402d0d99 | 19581 | =item SYNOPSIS |
19582 | ||
402d0d99 | 19583 | =item DESCRIPTION |
19584 | ||
2a551100 | 19585 | alt, code, indent, loose, margin, quotes, sentence, width |
c76ac1ee GS |
19586 | |
19587 | =item DIAGNOSTICS | |
19588 | ||
1fdc5aa6 | 19589 | Bizarre space in item, Item called without tag, Can't open %s for reading: |
04b01f78 JH |
19590 | %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, |
19591 | %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: | |
1fdc5aa6 | 19592 | Unmatched =back |
c76ac1ee GS |
19593 | |
19594 | =item RESTRICTIONS | |
19595 | ||
19596 | =item NOTES | |
19597 | ||
19598 | =item SEE ALSO | |
19599 | ||
402d0d99 | 19600 | =item AUTHOR |
19601 | ||
d0363f02 JH |
19602 | =item COPYRIGHT AND LICENSE |
19603 | ||
a45bd81d GS |
19604 | =back |
19605 | ||
c76ac1ee GS |
19606 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text |
19607 | ||
d420ca49 | 19608 | =over 4 |
a45bd81d | 19609 | |
c76ac1ee GS |
19610 | =item SYNOPSIS |
19611 | ||
19612 | =item DESCRIPTION | |
19613 | ||
19614 | =item BUGS | |
19615 | ||
19616 | =item SEE ALSO | |
19617 | ||
19618 | =item AUTHOR | |
19619 | ||
d0363f02 JH |
19620 | =item COPYRIGHT AND LICENSE |
19621 | ||
a45bd81d GS |
19622 | =back |
19623 | ||
ab648d5e JH |
19624 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike |
19625 | text | |
19626 | ||
19627 | =over 4 | |
19628 | ||
19629 | =item SYNOPSIS | |
19630 | ||
19631 | =item DESCRIPTION | |
19632 | ||
19633 | =item BUGS | |
19634 | ||
19635 | =item SEE ALSO | |
19636 | ||
19637 | =item AUTHOR | |
19638 | ||
d0363f02 JH |
19639 | =item COPYRIGHT AND LICENSE |
19640 | ||
ab648d5e JH |
19641 | =back |
19642 | ||
69dc652e JH |
19643 | =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format |
19644 | escapes | |
c76ac1ee | 19645 | |
d420ca49 | 19646 | =over 4 |
a45bd81d | 19647 | |
c76ac1ee GS |
19648 | =item SYNOPSIS |
19649 | ||
19650 | =item DESCRIPTION | |
19651 | ||
34babc16 JH |
19652 | =item NOTES |
19653 | ||
c76ac1ee GS |
19654 | =item SEE ALSO |
19655 | ||
19656 | =item AUTHOR | |
402d0d99 | 19657 | |
d0363f02 JH |
19658 | =item COPYRIGHT AND LICENSE |
19659 | ||
a45bd81d GS |
19660 | =back |
19661 | ||
14218588 GS |
19662 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
19663 | documentation | |
19664 | ||
d420ca49 | 19665 | =over 4 |
a45bd81d | 19666 | |
14218588 GS |
19667 | =item SYNOPSIS |
19668 | ||
19669 | =item ARGUMENTS | |
19670 | ||
19671 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
19672 | C<-pathlist> | |
19673 | ||
19674 | =item DESCRIPTION | |
19675 | ||
19676 | =item EXAMPLES | |
19677 | ||
d420ca49 | 19678 | =over 4 |
14218588 GS |
19679 | |
19680 | =item Recommended Use | |
19681 | ||
19682 | =back | |
19683 | ||
19684 | =item CAVEATS | |
19685 | ||
19686 | =item AUTHOR | |
19687 | ||
19688 | =item ACKNOWLEDGEMENTS | |
19689 | ||
a45bd81d GS |
19690 | =back |
19691 | ||
fa1c7b03 | 19692 | =head2 SDBM_File - Tied access to sdbm files |
41ca3a40 JH |
19693 | |
19694 | =over 4 | |
19695 | ||
19696 | =item SYNOPSIS | |
19697 | ||
19698 | =item DESCRIPTION | |
19699 | ||
fa1c7b03 | 19700 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
41ca3a40 | 19701 | |
fa1c7b03 | 19702 | =item DIAGNOSTICS |
f502af34 | 19703 | |
fa1c7b03 | 19704 | =over 4 |
41ca3a40 | 19705 | |
fa1c7b03 JH |
19706 | =item C<sdbm store returned -1, errno 22, key "..." at ...> |
19707 | ||
19708 | =back | |
19709 | ||
19710 | =item BUGS AND WARNINGS | |
41ca3a40 JH |
19711 | |
19712 | =back | |
19713 | ||
639f8edf HS |
19714 | =head2 Safe - Compile and execute code in restricted compartments |
19715 | ||
19716 | =over 4 | |
19717 | ||
19718 | =item SYNOPSIS | |
19719 | ||
19720 | =item DESCRIPTION | |
19721 | ||
19722 | a new namespace, an operator mask | |
19723 | ||
19724 | =item WARNING | |
19725 | ||
19726 | =over 4 | |
19727 | ||
19728 | =item RECENT CHANGES | |
19729 | ||
19730 | =item Methods in class Safe | |
19731 | ||
19732 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
19733 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
19734 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
19735 | root (NAMESPACE), mask (MASK) | |
19736 | ||
19737 | =item Some Safety Issues | |
19738 | ||
19739 | Memory, CPU, Snooping, Signals, State Changes | |
19740 | ||
19741 | =item AUTHOR | |
19742 | ||
19743 | =back | |
19744 | ||
19745 | =back | |
19746 | ||
19747 | =head2 Scalar::Util - A selection of general-utility scalar subroutines | |
19748 | ||
19749 | =over 4 | |
19750 | ||
19751 | =item SYNOPSIS | |
19752 | ||
19753 | =item DESCRIPTION | |
19754 | ||
19755 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, | |
19756 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, | |
19757 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF | |
19758 | ||
19759 | =item KNOWN BUGS | |
19760 | ||
19761 | =item COPYRIGHT | |
19762 | ||
19763 | =item BLATANT PLUG | |
19764 | ||
19765 | =back | |
19766 | ||
7d2bfb28 | 19767 | =head2 Search::Dict, look - search for key in dictionary file |
19768 | ||
d420ca49 | 19769 | =over 4 |
a45bd81d | 19770 | |
7d2bfb28 | 19771 | =item SYNOPSIS |
19772 | ||
7d2bfb28 | 19773 | =item DESCRIPTION |
19774 | ||
a45bd81d GS |
19775 | =back |
19776 | ||
7d2bfb28 | 19777 | =head2 SelectSaver - save and restore selected file handle |
19778 | ||
d420ca49 | 19779 | =over 4 |
a45bd81d | 19780 | |
7d2bfb28 | 19781 | =item SYNOPSIS |
19782 | ||
7d2bfb28 | 19783 | =item DESCRIPTION |
19784 | ||
a45bd81d GS |
19785 | =back |
19786 | ||
cb1a09d0 AD |
19787 | =head2 SelfLoader - load functions only on demand |
19788 | ||
d420ca49 | 19789 | =over 4 |
a45bd81d | 19790 | |
cb1a09d0 AD |
19791 | =item SYNOPSIS |
19792 | ||
cb1a09d0 AD |
19793 | =item DESCRIPTION |
19794 | ||
d420ca49 | 19795 | =over 4 |
cb1a09d0 AD |
19796 | |
19797 | =item The __DATA__ token | |
19798 | ||
cb1a09d0 AD |
19799 | =item SelfLoader autoloading |
19800 | ||
cb1a09d0 AD |
19801 | =item Autoloading and package lexicals |
19802 | ||
cb1a09d0 AD |
19803 | =item SelfLoader and AutoLoader |
19804 | ||
cb1a09d0 AD |
19805 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
19806 | ||
cb1a09d0 AD |
19807 | =item Classes and inherited methods. |
19808 | ||
cb1a09d0 AD |
19809 | =back |
19810 | ||
19811 | =item Multiple packages and fully qualified subroutine names | |
19812 | ||
a45bd81d GS |
19813 | =back |
19814 | ||
8ebc5c01 | 19815 | =head2 Shell - run shell commands transparently within perl |
cb1a09d0 | 19816 | |
d420ca49 | 19817 | =over 4 |
a45bd81d | 19818 | |
cb1a09d0 AD |
19819 | =item SYNOPSIS |
19820 | ||
cb1a09d0 AD |
19821 | =item DESCRIPTION |
19822 | ||
d420ca49 | 19823 | =over 4 |
d396a558 | 19824 | |
07e9b5fe NC |
19825 | =item Caveats |
19826 | ||
19827 | =item Escaping Magic Characters | |
19828 | ||
19829 | =item Configuration | |
d396a558 JH |
19830 | |
19831 | =back | |
19832 | ||
07e9b5fe NC |
19833 | =item BUGS |
19834 | ||
8ebc5c01 | 19835 | =item AUTHOR |
cb1a09d0 | 19836 | |
a45bd81d GS |
19837 | =back |
19838 | ||
8ebc5c01 | 19839 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
19840 | socket.h defines and structure manipulators | |
cb1a09d0 | 19841 | |
d420ca49 | 19842 | =over 4 |
a45bd81d | 19843 | |
8ebc5c01 | 19844 | =item SYNOPSIS |
cb1a09d0 | 19845 | |
8ebc5c01 | 19846 | =item DESCRIPTION |
cb1a09d0 | 19847 | |
8ebc5c01 | 19848 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
f502af34 JH |
19849 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, |
19850 | ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, | |
19851 | unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un | |
19852 | SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
cb1a09d0 | 19853 | |
a45bd81d GS |
19854 | =back |
19855 | ||
849d92fd | 19856 | =head2 Storable - persistence for Perl data structures |
a9ef4385 | 19857 | |
d420ca49 | 19858 | =over 4 |
a9ef4385 JH |
19859 | |
19860 | =item SYNOPSIS | |
19861 | ||
19862 | =item DESCRIPTION | |
19863 | ||
19864 | =item MEMORY STORE | |
19865 | ||
91331b4f JH |
19866 | =item ADVISORY LOCKING |
19867 | ||
a9ef4385 JH |
19868 | =item SPEED |
19869 | ||
19870 | =item CANONICAL REPRESENTATION | |
19871 | ||
2a551100 JH |
19872 | =item CODE REFERENCES |
19873 | ||
849d92fd JH |
19874 | =item FORWARD COMPATIBILITY |
19875 | ||
19876 | utf8 data, restricted hashes, files from future versions of Storable | |
19877 | ||
a9ef4385 JH |
19878 | =item ERROR REPORTING |
19879 | ||
19880 | =item WIZARDS ONLY | |
19881 | ||
d420ca49 | 19882 | =over 4 |
a9ef4385 JH |
19883 | |
19884 | =item Hooks | |
19885 | ||
19886 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
19887 | I<serialized>, .. | |
19888 | ||
19889 | =item Predicates | |
19890 | ||
19891 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
19892 | C<Storable::is_retrieving> | |
19893 | ||
19894 | =item Recursion | |
19895 | ||
19896 | =item Deep Cloning | |
19897 | ||
19898 | =back | |
19899 | ||
f502af34 JH |
19900 | =item Storable magic |
19901 | ||
a9ef4385 JH |
19902 | =item EXAMPLES |
19903 | ||
19904 | =item WARNING | |
19905 | ||
19906 | =item BUGS | |
19907 | ||
a6812a52 JH |
19908 | =over 4 |
19909 | ||
19910 | =item 64 bit data in perl 5.6.0 and 5.6.1 | |
19911 | ||
19912 | =back | |
19913 | ||
a9ef4385 JH |
19914 | =item CREDITS |
19915 | ||
a9ef4385 JH |
19916 | =item AUTHOR |
19917 | ||
19918 | =item SEE ALSO | |
19919 | ||
19920 | =back | |
19921 | ||
4d4e713d JH |
19922 | =head2 Switch - A switch statement for Perl |
19923 | ||
19924 | =over 4 | |
19925 | ||
19926 | =item VERSION | |
19927 | ||
19928 | =item SYNOPSIS | |
19929 | ||
19930 | =item BACKGROUND | |
19931 | ||
19932 | =item DESCRIPTION | |
19933 | ||
19934 | =over 4 | |
19935 | ||
19936 | =item Allowing fall-through | |
19937 | ||
19938 | =item Automating fall-through | |
19939 | ||
9cd42e2a JH |
19940 | =item Alternative syntax |
19941 | ||
4d4e713d JH |
19942 | =item Higher-order Operations |
19943 | ||
19944 | =back | |
19945 | ||
19946 | =item DEPENDENCIES | |
19947 | ||
19948 | =item AUTHOR | |
19949 | ||
19950 | =item BUGS | |
19951 | ||
2e038148 | 19952 | =item LIMITATIONS |
ba62762e | 19953 | |
4d4e713d JH |
19954 | =item COPYRIGHT |
19955 | ||
19956 | =back | |
19957 | ||
7d2bfb28 | 19958 | =head2 Symbol - manipulate Perl symbols and their names |
19959 | ||
d420ca49 | 19960 | =over 4 |
a45bd81d | 19961 | |
7d2bfb28 | 19962 | =item SYNOPSIS |
19963 | ||
7d2bfb28 | 19964 | =item DESCRIPTION |
19965 | ||
1e54db1a JH |
19966 | =item BUGS |
19967 | ||
a45bd81d GS |
19968 | =back |
19969 | ||
cb1a09d0 AD |
19970 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
19971 | ||
d420ca49 | 19972 | =over 4 |
a45bd81d | 19973 | |
cb1a09d0 AD |
19974 | =item SYNOPSIS |
19975 | ||
cb1a09d0 AD |
19976 | =item DESCRIPTION |
19977 | ||
cb1a09d0 AD |
19978 | =item AUTHOR |
19979 | ||
a45bd81d GS |
19980 | =back |
19981 | ||
639f8edf HS |
19982 | =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl |
19983 | interface to the UNIX syslog(3) calls | |
19984 | ||
19985 | =over 4 | |
19986 | ||
19987 | =item SYNOPSIS | |
19988 | ||
19989 | =item DESCRIPTION | |
19990 | ||
19991 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
19992 | setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added | |
19993 | in 5.004_02), closelog | |
19994 | ||
19995 | =item EXAMPLES | |
19996 | ||
19997 | =item SEE ALSO | |
19998 | ||
19999 | =item AUTHOR | |
20000 | ||
20001 | =back | |
20002 | ||
694468e3 GS |
20003 | =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - |
20004 | Perl interface to the UNIX syslog(3) calls | |
20005 | ||
d420ca49 | 20006 | =over 4 |
694468e3 GS |
20007 | |
20008 | =item SYNOPSIS | |
20009 | ||
20010 | =item DESCRIPTION | |
20011 | ||
20012 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
fa1c7b03 JH |
20013 | setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added |
20014 | in 5.004_02), closelog | |
694468e3 GS |
20015 | |
20016 | =item EXAMPLES | |
7d2bfb28 | 20017 | |
7d2bfb28 | 20018 | =item SEE ALSO |
20019 | ||
7d2bfb28 | 20020 | =item AUTHOR |
20021 | ||
a45bd81d GS |
20022 | =back |
20023 | ||
b38f6a39 GS |
20024 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences |
20025 | ||
d420ca49 | 20026 | =over 4 |
b38f6a39 GS |
20027 | |
20028 | =item SYNOPSIS | |
20029 | ||
20030 | =item DESCRIPTION | |
20031 | ||
20032 | =item DIAGNOSTICS | |
20033 | ||
d0363f02 JH |
20034 | Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in |
20035 | use, Invalid attribute name %s, Name "%s" used only once: possible typo, No | |
20036 | comma allowed after filehandle, No name for escape sequence %s | |
20037 | ||
20038 | =item ENVIRONMENT | |
20039 | ||
20040 | ANSI_COLORS_DISABLED | |
b38f6a39 GS |
20041 | |
20042 | =item RESTRICTIONS | |
20043 | ||
10862624 RF |
20044 | =item NOTES |
20045 | ||
d0363f02 JH |
20046 | =item SEE ALSO |
20047 | ||
b38f6a39 GS |
20048 | =item AUTHORS |
20049 | ||
69dc652e | 20050 | =item COPYRIGHT AND LICENSE |
d0363f02 | 20051 | |
b38f6a39 GS |
20052 | =back |
20053 | ||
cb1a09d0 AD |
20054 | =head2 Term::Cap - Perl termcap interface |
20055 | ||
d420ca49 | 20056 | =over 4 |
a45bd81d | 20057 | |
cb1a09d0 AD |
20058 | =item SYNOPSIS |
20059 | ||
cb1a09d0 AD |
20060 | =item DESCRIPTION |
20061 | ||
428dc699 JH |
20062 | =over 4 |
20063 | ||
20064 | =item METHODS | |
20065 | ||
20066 | =back | |
20067 | ||
20068 | =back | |
20069 | ||
20070 | B<Tgetent>, OSPEED, TERM | |
20071 | ||
20072 | B<Tpad>, B<$string>, B<$cnt>, B<$FH> | |
20073 | ||
20074 | B<Tputs>, B<$cap>, B<$cnt>, B<$FH> | |
20075 | ||
20076 | B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> | |
20077 | ||
20078 | B<Trequire> | |
20079 | ||
20080 | =over 4 | |
20081 | ||
cb1a09d0 AD |
20082 | =item EXAMPLES |
20083 | ||
428dc699 JH |
20084 | =item COPYRIGHT AND LICENSE |
20085 | ||
20086 | =item AUTHOR | |
20087 | ||
20088 | =item SEE ALSO | |
20089 | ||
a45bd81d GS |
20090 | =back |
20091 | ||
cb1a09d0 AD |
20092 | =head2 Term::Complete - Perl word completion module |
20093 | ||
d420ca49 | 20094 | =over 4 |
a45bd81d | 20095 | |
cb1a09d0 AD |
20096 | =item SYNOPSIS |
20097 | ||
cb1a09d0 AD |
20098 | =item DESCRIPTION |
20099 | ||
3fe9a6f1 | 20100 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
cb1a09d0 AD |
20101 | |
20102 | =item DIAGNOSTICS | |
20103 | ||
cb1a09d0 AD |
20104 | =item BUGS |
20105 | ||
cb1a09d0 AD |
20106 | =item AUTHOR |
20107 | ||
a45bd81d GS |
20108 | =back |
20109 | ||
2a551100 JH |
20110 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. |
20111 | If no real package is found, substitutes stubs instead of basic functions. | |
7d2bfb28 | 20112 | |
d420ca49 | 20113 | =over 4 |
a45bd81d | 20114 | |
7d2bfb28 | 20115 | =item SYNOPSIS |
20116 | ||
7d2bfb28 | 20117 | =item DESCRIPTION |
20118 | ||
7d2bfb28 | 20119 | =item Minimal set of supported functions |
20120 | ||
2a551100 JH |
20121 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>, |
20122 | C<findConsole>, Attribs, C<Features> | |
9607fc9c | 20123 | |
20124 | =item Additional supported functions | |
7d2bfb28 | 20125 | |
d516a115 JH |
20126 | C<tkRunning>, C<ornaments>, C<newTTY> |
20127 | ||
7d2bfb28 | 20128 | =item EXPORTS |
20129 | ||
9607fc9c | 20130 | =item ENVIRONMENT |
20131 | ||
ab1e085c JH |
20132 | =item CAVEATS |
20133 | ||
a45bd81d GS |
20134 | =back |
20135 | ||
4d4e713d | 20136 | =head2 Test - provides a simple framework for writing test scripts |
193fb0af | 20137 | |
d420ca49 | 20138 | =over 4 |
a45bd81d | 20139 | |
193fb0af GS |
20140 | =item SYNOPSIS |
20141 | ||
20142 | =item DESCRIPTION | |
20143 | ||
2a551100 JH |
20144 | =item QUICK START GUIDE |
20145 | ||
640374d0 JH |
20146 | =over 4 |
20147 | ||
20148 | =item Functions | |
20149 | ||
2a551100 JH |
20150 | C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>, |
20151 | C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub> | |
640374d0 JH |
20152 | |
20153 | =back | |
20154 | ||
20155 | =back | |
20156 | ||
20157 | B<_to_value> | |
20158 | ||
2a551100 JH |
20159 | C<ok(...)> |
20160 | ||
20161 | C<skip(I<skip_if_true>, I<args...>)> | |
640374d0 JH |
20162 | |
20163 | =over 4 | |
20164 | ||
193fb0af GS |
20165 | =item TEST TYPES |
20166 | ||
20167 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
20168 | ||
20169 | =item ONFAIL | |
20170 | ||
640374d0 JH |
20171 | =item BUGS and CAVEATS |
20172 | ||
07e9b5fe NC |
20173 | =item ENVIRONMENT |
20174 | ||
80327a3d | 20175 | =item NOTE |
640374d0 | 20176 | |
193fb0af GS |
20177 | =item SEE ALSO |
20178 | ||
20179 | =item AUTHOR | |
20180 | ||
a45bd81d GS |
20181 | =back |
20182 | ||
10151d09 JH |
20183 | =head2 Test::Builder - Backend for building test libraries |
20184 | ||
20185 | =over 4 | |
20186 | ||
20187 | =item SYNOPSIS | |
20188 | ||
20189 | =item DESCRIPTION | |
20190 | ||
20191 | =over 4 | |
20192 | ||
20193 | =item Construction | |
20194 | ||
20195 | B<new> | |
20196 | ||
20197 | =back | |
20198 | ||
20199 | =back | |
20200 | ||
e4bb216d NC |
20201 | B<reset> |
20202 | ||
10151d09 JH |
20203 | =over 4 |
20204 | ||
20205 | =item Setting up tests | |
20206 | ||
20207 | B<exported_to> | |
20208 | ||
20209 | =back | |
20210 | ||
20211 | B<plan> | |
20212 | ||
20213 | B<expected_tests> | |
20214 | ||
20215 | B<no_plan> | |
20216 | ||
2a551100 JH |
20217 | B<has_plan> |
20218 | ||
10151d09 JH |
20219 | B<skip_all> |
20220 | ||
20221 | =over 4 | |
20222 | ||
20223 | =item Running tests | |
20224 | ||
20225 | B<ok> | |
20226 | ||
20227 | =back | |
20228 | ||
20229 | B<is_eq>, B<is_num> | |
20230 | ||
f502af34 JH |
20231 | B<isnt_eq>, B<isnt_num> |
20232 | ||
20233 | B<like>, B<unlike> | |
20234 | ||
95fb7f7f JH |
20235 | B<maybe_regex> |
20236 | ||
f502af34 JH |
20237 | B<cmp_ok> |
20238 | ||
20239 | B<BAILOUT> | |
10151d09 JH |
20240 | |
20241 | B<skip> | |
20242 | ||
f502af34 JH |
20243 | B<todo_skip> |
20244 | ||
10151d09 JH |
20245 | B<skip_rest> |
20246 | ||
20247 | =over 4 | |
20248 | ||
20249 | =item Test style | |
20250 | ||
20251 | B<level> | |
20252 | ||
20253 | =back | |
20254 | ||
20255 | B<use_numbers> | |
20256 | ||
20257 | B<no_header>, B<no_ending> | |
20258 | ||
20259 | =over 4 | |
20260 | ||
20261 | =item Output | |
20262 | ||
20263 | B<diag> | |
20264 | ||
20265 | =back | |
20266 | ||
20267 | B<_print> | |
20268 | ||
e4bb216d NC |
20269 | B<_print_diag> |
20270 | ||
10151d09 JH |
20271 | B<output>, B<failure_output>, B<todo_output> |
20272 | ||
20273 | =over 4 | |
20274 | ||
20275 | =item Test Status and Info | |
20276 | ||
20277 | B<current_test> | |
20278 | ||
20279 | =back | |
20280 | ||
20281 | B<summary> | |
20282 | ||
2a551100 JH |
20283 | B<details> |
20284 | ||
20285 | B<todo> | |
10151d09 JH |
20286 | |
20287 | B<caller> | |
20288 | ||
20289 | B<_sanity_check> | |
20290 | ||
20291 | B<_whoa> | |
20292 | ||
20293 | B<_my_exit> | |
20294 | ||
20295 | =over 4 | |
20296 | ||
e4bb216d NC |
20297 | =item EXIT CODES |
20298 | ||
033348ab JH |
20299 | =item THREADS |
20300 | ||
10151d09 JH |
20301 | =item EXAMPLES |
20302 | ||
10151d09 JH |
20303 | =item SEE ALSO |
20304 | ||
428dc699 JH |
20305 | =item AUTHORS |
20306 | ||
20307 | =item COPYRIGHT | |
20308 | ||
10151d09 JH |
20309 | =back |
20310 | ||
f262848d RGS |
20311 | =head2 Test::Harness - Run Perl standard test scripts with statistics |
20312 | ||
20313 | =over 4 | |
20314 | ||
20315 | =item VERSION | |
20316 | ||
20317 | =back | |
cb1a09d0 | 20318 | |
d420ca49 | 20319 | =over 4 |
a45bd81d | 20320 | |
cb1a09d0 AD |
20321 | =item SYNOPSIS |
20322 | ||
cb1a09d0 AD |
20323 | =item DESCRIPTION |
20324 | ||
d420ca49 | 20325 | =over 4 |
7d2bfb28 | 20326 | |
20327 | =item The test script output | |
20328 | ||
f502af34 JH |
20329 | B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>, |
20330 | B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything | |
20331 | else> | |
20332 | ||
20333 | =item Taint mode | |
20334 | ||
20335 | =item Configuration variables. | |
20336 | ||
f262848d | 20337 | B<$Test::Harness::Verbose>, B<$Test::Harness::switches> |
640374d0 JH |
20338 | |
20339 | =item Failure | |
20340 | ||
20341 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of | |
20342 | Failed> | |
20343 | ||
20344 | =item Functions | |
20345 | ||
20346 | B<runtests> | |
20347 | ||
20348 | =back | |
dc5c060f | 20349 | |
7d2bfb28 | 20350 | =back |
20351 | ||
53d7eaa8 JH |
20352 | B<_all_ok> |
20353 | ||
640374d0 JH |
20354 | B<_globdir> |
20355 | ||
20356 | B<_run_all_tests> | |
20357 | ||
20358 | B<_mk_leader> | |
20359 | ||
f502af34 JH |
20360 | B<_leader_width> |
20361 | ||
640374d0 JH |
20362 | =over 4 |
20363 | ||
cb1a09d0 AD |
20364 | =item EXPORT |
20365 | ||
cb1a09d0 AD |
20366 | =item DIAGNOSTICS |
20367 | ||
7d2bfb28 | 20368 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
8ebc5c01 | 20369 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
20370 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
c133c03f | 20371 | %s>, C<FAILED--Further testing stopped: %s> |
cb1a09d0 | 20372 | |
fb9cefb4 GS |
20373 | =item ENVIRONMENT |
20374 | ||
95fb7f7f | 20375 | C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, |
f262848d RGS |
20376 | C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, |
20377 | C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>, | |
20378 | C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> | |
2d967e39 | 20379 | |
640374d0 JH |
20380 | =item EXAMPLE |
20381 | ||
cb1a09d0 AD |
20382 | =item SEE ALSO |
20383 | ||
7d2bfb28 | 20384 | =item AUTHORS |
20385 | ||
2a551100 JH |
20386 | =item LICENSE |
20387 | ||
640374d0 JH |
20388 | =item TODO |
20389 | ||
cb1a09d0 AD |
20390 | =item BUGS |
20391 | ||
f262848d RGS |
20392 | =item AUTHORS |
20393 | ||
20394 | =item COPYRIGHT | |
20395 | ||
a45bd81d GS |
20396 | =back |
20397 | ||
f502af34 JH |
20398 | =head2 Test::Harness::Assert - simple assert |
20399 | ||
20400 | =over 4 | |
20401 | ||
20402 | =item SYNOPSIS | |
20403 | ||
20404 | =item DESCRIPTION | |
20405 | ||
f262848d | 20406 | =item FUNCTIONS |
f502af34 | 20407 | |
f262848d | 20408 | =over 4 |
f502af34 | 20409 | |
f262848d | 20410 | =item C<assert()> |
f502af34 JH |
20411 | |
20412 | =back | |
20413 | ||
20414 | =back | |
20415 | ||
20416 | =over 4 | |
20417 | ||
20418 | =item AUTHOR | |
20419 | ||
20420 | =item SEE ALSO | |
20421 | ||
20422 | =back | |
20423 | ||
20424 | =head2 Test::Harness::Iterator - Internal Test::Harness Iterator | |
20425 | ||
20426 | =over 4 | |
20427 | ||
20428 | =item SYNOPSIS | |
20429 | ||
20430 | =item DESCRIPTION | |
20431 | ||
2e038148 NC |
20432 | =over 4 |
20433 | ||
20434 | =item new() | |
20435 | ||
20436 | =item next() | |
20437 | ||
20438 | =back | |
20439 | ||
f502af34 JH |
20440 | =back |
20441 | ||
20442 | =head2 Test::Harness::Straps - detailed analysis of test results | |
20443 | ||
20444 | =over 4 | |
20445 | ||
20446 | =item SYNOPSIS | |
20447 | ||
20448 | =item DESCRIPTION | |
20449 | ||
f502af34 JH |
20450 | =item Construction |
20451 | ||
41630250 JH |
20452 | =over 4 |
20453 | ||
20454 | =item C<new> | |
f502af34 JH |
20455 | |
20456 | =back | |
20457 | ||
20458 | =back | |
20459 | ||
41630250 JH |
20460 | =over 4 |
20461 | ||
20462 | =item C<_init> | |
20463 | ||
20464 | =back | |
f502af34 JH |
20465 | |
20466 | =over 4 | |
20467 | ||
20468 | =item Analysis | |
20469 | ||
41630250 JH |
20470 | =over 4 |
20471 | ||
20472 | =item C<analyze> | |
20473 | ||
20474 | =back | |
20475 | ||
20476 | =back | |
20477 | ||
20478 | =over 4 | |
20479 | ||
20480 | =item C<analyze_fh> | |
20481 | ||
20482 | =back | |
20483 | ||
20484 | =over 4 | |
20485 | ||
20486 | =item C<analyze_file> | |
20487 | ||
20488 | =back | |
20489 | ||
20490 | =over 4 | |
20491 | ||
f262848d RGS |
20492 | =item C<_command_line( $file )> |
20493 | ||
20494 | =back | |
20495 | ||
20496 | =over 4 | |
20497 | ||
20498 | =item C<_command> | |
20499 | ||
20500 | =back | |
20501 | ||
20502 | =over 4 | |
20503 | ||
41630250 JH |
20504 | =item C<_switches> |
20505 | ||
20506 | =back | |
20507 | ||
20508 | =over 4 | |
20509 | ||
f262848d RGS |
20510 | =item C<_cleaned_switches> |
20511 | ||
20512 | =back | |
20513 | ||
20514 | =over 4 | |
20515 | ||
41630250 | 20516 | =item C<_INC2PERL5LIB> |
f502af34 JH |
20517 | |
20518 | =back | |
20519 | ||
41630250 | 20520 | =over 4 |
f502af34 | 20521 | |
41630250 | 20522 | =item C<_filtered_INC> |
f502af34 | 20523 | |
41630250 | 20524 | =back |
f502af34 | 20525 | |
41630250 | 20526 | =over 4 |
f502af34 | 20527 | |
41630250 | 20528 | =item C<_restore_PERL5LIB> |
f502af34 | 20529 | |
41630250 | 20530 | =back |
f502af34 JH |
20531 | |
20532 | =over 4 | |
20533 | ||
20534 | =item Parsing | |
20535 | ||
41630250 JH |
20536 | =over 4 |
20537 | ||
20538 | =item C<_is_comment> | |
20539 | ||
20540 | =back | |
20541 | ||
20542 | =back | |
20543 | ||
20544 | =over 4 | |
20545 | ||
20546 | =item C<_is_header> | |
20547 | ||
20548 | =back | |
20549 | ||
20550 | =over 4 | |
20551 | ||
20552 | =item C<_is_test> | |
f502af34 JH |
20553 | |
20554 | =back | |
20555 | ||
41630250 JH |
20556 | =over 4 |
20557 | ||
20558 | =item C<_is_bail_out> | |
f502af34 | 20559 | |
41630250 JH |
20560 | =back |
20561 | ||
20562 | =over 4 | |
f502af34 | 20563 | |
41630250 | 20564 | =item C<_reset_file_state> |
f502af34 | 20565 | |
41630250 | 20566 | =back |
f502af34 JH |
20567 | |
20568 | =over 4 | |
20569 | ||
20570 | =item Results | |
20571 | ||
41630250 JH |
20572 | =over 4 |
20573 | ||
20574 | =item C<_detailize> | |
20575 | ||
20576 | =back | |
f502af34 JH |
20577 | |
20578 | =back | |
20579 | ||
20580 | =over 4 | |
20581 | ||
20582 | =item EXAMPLES | |
20583 | ||
20584 | =item AUTHOR | |
20585 | ||
20586 | =item SEE ALSO | |
20587 | ||
20588 | =back | |
20589 | ||
7a49b635 JH |
20590 | =head2 Test::More - yet another framework for writing test scripts |
20591 | ||
20592 | =over 4 | |
20593 | ||
20594 | =item SYNOPSIS | |
20595 | ||
20596 | =item DESCRIPTION | |
20597 | ||
20598 | =over 4 | |
20599 | ||
20600 | =item I love it when a plan comes together | |
20601 | ||
10151d09 JH |
20602 | =back |
20603 | ||
20604 | =back | |
20605 | ||
20606 | =over 4 | |
20607 | ||
7a49b635 JH |
20608 | =item Test names |
20609 | ||
20610 | =item I'm ok, you're not ok. | |
20611 | ||
20612 | B<ok> | |
20613 | ||
20614 | =back | |
20615 | ||
7a49b635 JH |
20616 | B<is>, B<isnt> |
20617 | ||
20618 | B<like> | |
20619 | ||
f502af34 JH |
20620 | B<unlike> |
20621 | ||
20622 | B<cmp_ok> | |
20623 | ||
53d7eaa8 JH |
20624 | B<can_ok> |
20625 | ||
20626 | B<isa_ok> | |
20627 | ||
7a49b635 JH |
20628 | B<pass>, B<fail> |
20629 | ||
20630 | =over 4 | |
20631 | ||
f502af34 JH |
20632 | =item Diagnostics |
20633 | ||
20634 | B<diag> | |
20635 | ||
20636 | =back | |
20637 | ||
20638 | =over 4 | |
20639 | ||
7a49b635 JH |
20640 | =item Module tests |
20641 | ||
53d7eaa8 | 20642 | B<use_ok> |
7a49b635 JH |
20643 | |
20644 | =back | |
20645 | ||
53d7eaa8 JH |
20646 | B<require_ok> |
20647 | ||
7a49b635 JH |
20648 | =over 4 |
20649 | ||
20650 | =item Conditional tests | |
20651 | ||
53d7eaa8 | 20652 | B<SKIP: BLOCK> |
7a49b635 JH |
20653 | |
20654 | =back | |
20655 | ||
f502af34 | 20656 | B<TODO: BLOCK>, B<todo_skip> |
7a49b635 | 20657 | |
033348ab JH |
20658 | When do I use SKIP vs. TODO? |
20659 | ||
7a49b635 JH |
20660 | =over 4 |
20661 | ||
428dc699 | 20662 | =item Comparison functions |
7a49b635 | 20663 | |
10151d09 | 20664 | B<is_deeply> |
7a49b635 JH |
20665 | |
20666 | =back | |
20667 | ||
10151d09 JH |
20668 | B<eq_array> |
20669 | ||
7a49b635 JH |
20670 | B<eq_hash> |
20671 | ||
20672 | B<eq_set> | |
20673 | ||
20674 | =over 4 | |
20675 | ||
f502af34 JH |
20676 | =item Extending and Embedding Test::More |
20677 | ||
20678 | B<builder> | |
20679 | ||
20680 | =back | |
20681 | ||
20682 | =over 4 | |
20683 | ||
e4bb216d | 20684 | =item EXIT CODES |
53d7eaa8 | 20685 | |
e4bb216d | 20686 | =item CAVEATS and NOTES |
7a49b635 | 20687 | |
e4bb216d | 20688 | Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade |
53d7eaa8 | 20689 | |
7a49b635 JH |
20690 | =item HISTORY |
20691 | ||
20692 | =item SEE ALSO | |
20693 | ||
428dc699 JH |
20694 | =item AUTHORS |
20695 | ||
e4bb216d NC |
20696 | =item BUGS |
20697 | ||
428dc699 JH |
20698 | =item COPYRIGHT |
20699 | ||
7a49b635 JH |
20700 | =back |
20701 | ||
20702 | =head2 Test::Simple - Basic utilities for writing tests. | |
20703 | ||
20704 | =over 4 | |
20705 | ||
20706 | =item SYNOPSIS | |
20707 | ||
20708 | =item DESCRIPTION | |
20709 | ||
20710 | B<ok> | |
20711 | ||
20712 | =back | |
20713 | ||
7a49b635 JH |
20714 | =over 4 |
20715 | ||
20716 | =item EXAMPLE | |
20717 | ||
20718 | =item CAVEATS | |
20719 | ||
53d7eaa8 JH |
20720 | =item NOTES |
20721 | ||
7a49b635 JH |
20722 | =item HISTORY |
20723 | ||
7a49b635 JH |
20724 | =item SEE ALSO |
20725 | ||
428dc699 | 20726 | L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, |
7a49b635 JH |
20727 | L<Test::Harness> |
20728 | ||
428dc699 JH |
20729 | =item AUTHORS |
20730 | ||
20731 | =item COPYRIGHT | |
20732 | ||
7a49b635 JH |
20733 | =back |
20734 | ||
e61ecf27 JH |
20735 | =head2 Test::Tutorial - A tutorial about writing really basic tests |
20736 | ||
20737 | =over 4 | |
20738 | ||
20739 | =item DESCRIPTION | |
20740 | ||
20741 | =over 4 | |
20742 | ||
20743 | =item Nuts and bolts of testing. | |
20744 | ||
20745 | =item Where to start? | |
20746 | ||
20747 | =item Names | |
20748 | ||
20749 | =item Test the manual | |
20750 | ||
20751 | =item Sometimes the tests are wrong | |
20752 | ||
20753 | =item Testing lots of values | |
20754 | ||
20755 | =item Informative names | |
20756 | ||
20757 | =item Skipping tests | |
20758 | ||
20759 | =item Todo tests | |
20760 | ||
20761 | =item Testing with taint mode. | |
20762 | ||
20763 | =back | |
20764 | ||
20765 | =item FOOTNOTES | |
20766 | ||
428dc699 JH |
20767 | =item AUTHORS |
20768 | ||
20769 | =item COPYRIGHT | |
20770 | ||
e61ecf27 JH |
20771 | =back |
20772 | ||
cb1a09d0 AD |
20773 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
20774 | ||
d420ca49 | 20775 | =over 4 |
a45bd81d | 20776 | |
cb1a09d0 AD |
20777 | =item SYNOPSIS |
20778 | ||
cb1a09d0 AD |
20779 | =item DESCRIPTION |
20780 | ||
cb1a09d0 AD |
20781 | =item EXAMPLE |
20782 | ||
a45bd81d GS |
20783 | =back |
20784 | ||
4d4e713d JH |
20785 | =head2 Text::Balanced - Extract delimited text sequences from strings. |
20786 | ||
20787 | =over 4 | |
20788 | ||
20789 | =item SYNOPSIS | |
20790 | ||
20791 | =item DESCRIPTION | |
20792 | ||
20793 | =over 4 | |
20794 | ||
20795 | =item General behaviour in list contexts | |
20796 | ||
20797 | [0], [1], [2] | |
20798 | ||
20799 | =item General behaviour in scalar and void contexts | |
20800 | ||
20801 | =item A note about prefixes | |
20802 | ||
20803 | =item C<extract_delimited> | |
20804 | ||
20805 | =item C<extract_bracketed> | |
20806 | ||
0d53b15f JH |
20807 | =item C<extract_variable> |
20808 | ||
20809 | [0], [1], [2] | |
20810 | ||
4d4e713d JH |
20811 | =item C<extract_tagged> |
20812 | ||
20813 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, | |
20814 | [0], [1], [2], [3], [4], [5] | |
20815 | ||
20816 | =item C<gen_extract_tagged> | |
20817 | ||
20818 | =item C<extract_quotelike> | |
20819 | ||
20820 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] | |
20821 | ||
20822 | =item C<extract_quotelike> and "here documents" | |
20823 | ||
20824 | [0], [1], [2], [3], [4], [5], [6], [7..10] | |
20825 | ||
20826 | =item C<extract_codeblock> | |
20827 | ||
20828 | =item C<extract_multiple> | |
20829 | ||
20830 | =item C<gen_delimited_pat> | |
20831 | ||
20832 | =back | |
20833 | ||
20834 | =item DIAGNOSTICS | |
20835 | ||
20836 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, | |
20837 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike | |
20838 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, | |
20839 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, | |
20840 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing | |
20841 | bracket: expected "%c" but found "%s">, C<No block delimiter found after | |
20842 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier | |
20843 | after dereferencer>, C<Did not find expected opening bracket at %s>, | |
20844 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike | |
20845 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: | |
20846 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid | |
20847 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing | |
20848 | tag> | |
20849 | ||
20850 | =item AUTHOR | |
20851 | ||
20852 | =item BUGS AND IRRITATIONS | |
20853 | ||
20854 | =item COPYRIGHT | |
20855 | ||
20856 | =back | |
20857 | ||
193fb0af GS |
20858 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
20859 | arrays | |
cb1a09d0 | 20860 | |
d420ca49 | 20861 | =over 4 |
a45bd81d | 20862 | |
8ebc5c01 | 20863 | =item SYNOPSIS |
cb1a09d0 | 20864 | |
8ebc5c01 | 20865 | =item DESCRIPTION |
cb1a09d0 | 20866 | |
193fb0af GS |
20867 | =item EXAMPLES |
20868 | ||
8ebc5c01 | 20869 | =item AUTHORS |
cb1a09d0 | 20870 | |
a45bd81d GS |
20871 | =back |
20872 | ||
8ebc5c01 | 20873 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
20874 | by Knuth | |
cb1a09d0 | 20875 | |
d420ca49 | 20876 | =over 4 |
a45bd81d | 20877 | |
cb1a09d0 AD |
20878 | =item SYNOPSIS |
20879 | ||
cb1a09d0 AD |
20880 | =item DESCRIPTION |
20881 | ||
cb1a09d0 AD |
20882 | =item EXAMPLES |
20883 | ||
cb1a09d0 AD |
20884 | =item LIMITATIONS |
20885 | ||
cb1a09d0 AD |
20886 | =item AUTHOR |
20887 | ||
a45bd81d GS |
20888 | =back |
20889 | ||
8ebc5c01 | 20890 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
20891 | unexpand(1) | |
cb1a09d0 | 20892 | |
d420ca49 | 20893 | =over 4 |
a45bd81d | 20894 | |
8ebc5c01 | 20895 | =item SYNOPSIS |
cb1a09d0 | 20896 | |
8ebc5c01 | 20897 | =item DESCRIPTION |
cb1a09d0 | 20898 | |
8ebc5c01 | 20899 | =item BUGS |
cb1a09d0 | 20900 | |
8ebc5c01 | 20901 | =item AUTHOR |
cb1a09d0 | 20902 | |
a45bd81d GS |
20903 | =back |
20904 | ||
8ebc5c01 | 20905 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
cb1a09d0 | 20906 | |
d420ca49 | 20907 | =over 4 |
a45bd81d | 20908 | |
8ebc5c01 | 20909 | =item SYNOPSIS |
cb1a09d0 AD |
20910 | |
20911 | =item DESCRIPTION | |
20912 | ||
35bf961c JH |
20913 | =item OVERRIDES |
20914 | ||
8ebc5c01 | 20915 | =item EXAMPLE |
cb1a09d0 AD |
20916 | |
20917 | =item AUTHOR | |
20918 | ||
a45bd81d GS |
20919 | =back |
20920 | ||
97f7c9df | 20921 | =head2 Thread - manipulate threads in Perl (for old code only) |
d516a115 | 20922 | |
d420ca49 | 20923 | =over 4 |
a45bd81d | 20924 | |
bd28ded5 JH |
20925 | =item CAVEAT |
20926 | ||
d516a115 JH |
20927 | =item SYNOPSIS |
20928 | ||
20929 | =item DESCRIPTION | |
20930 | ||
193fb0af GS |
20931 | =item FUNCTIONS |
20932 | ||
07fcf8ff JH |
20933 | $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, |
20934 | LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, | |
20935 | cond_signal VARIABLE, cond_broadcast VARIABLE, yield | |
193fb0af GS |
20936 | |
20937 | =item METHODS | |
20938 | ||
d420ca49 | 20939 | join, eval, detach, equal, tid, flags, done |
193fb0af GS |
20940 | |
20941 | =item LIMITATIONS | |
20942 | ||
d516a115 JH |
20943 | =item SEE ALSO |
20944 | ||
a45bd81d GS |
20945 | =back |
20946 | ||
83272a45 | 20947 | =head2 Thread::Queue - thread-safe queues |
d516a115 | 20948 | |
d420ca49 | 20949 | =over 4 |
a45bd81d | 20950 | |
d516a115 JH |
20951 | =item SYNOPSIS |
20952 | ||
193fb0af GS |
20953 | =item DESCRIPTION |
20954 | ||
20955 | =item FUNCTIONS AND METHODS | |
20956 | ||
20957 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
20958 | ||
20959 | =item SEE ALSO | |
20960 | ||
a45bd81d GS |
20961 | =back |
20962 | ||
83272a45 | 20963 | =head2 Thread::Semaphore - thread-safe semaphores |
d516a115 | 20964 | |
d420ca49 | 20965 | =over 4 |
a45bd81d | 20966 | |
d516a115 JH |
20967 | =item SYNOPSIS |
20968 | ||
193fb0af GS |
20969 | =item DESCRIPTION |
20970 | ||
20971 | =item FUNCTIONS AND METHODS | |
20972 | ||
20973 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
20974 | ||
a45bd81d GS |
20975 | =back |
20976 | ||
193fb0af | 20977 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
e934609f | 20978 | (for old code) |
193fb0af | 20979 | |
d420ca49 | 20980 | =over 4 |
a45bd81d | 20981 | |
e934609f JH |
20982 | =item CAVEAT |
20983 | ||
193fb0af GS |
20984 | =item SYNOPSIS |
20985 | ||
20986 | =item DESCRIPTION | |
20987 | ||
20988 | =item BUGS | |
20989 | ||
a45bd81d GS |
20990 | =back |
20991 | ||
d516a115 JH |
20992 | =head2 Thread::Specific - thread-specific keys |
20993 | ||
d420ca49 | 20994 | =over 4 |
a45bd81d | 20995 | |
d516a115 JH |
20996 | =item SYNOPSIS |
20997 | ||
14218588 GS |
20998 | =item DESCRIPTION |
20999 | ||
a45bd81d GS |
21000 | =back |
21001 | ||
d516a115 JH |
21002 | =head2 Tie::Array - base class for tied arrays |
21003 | ||
d420ca49 | 21004 | =over 4 |
a45bd81d | 21005 | |
37d4d706 | 21006 | =item SYNOPSIS |
d516a115 | 21007 | |
37d4d706 | 21008 | =item DESCRIPTION |
d516a115 JH |
21009 | |
21010 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
a45bd81d GS |
21011 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
21012 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
21013 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
d516a115 JH |
21014 | |
21015 | =item CAVEATS | |
21016 | ||
37d4d706 | 21017 | =item AUTHOR |
d516a115 | 21018 | |
a45bd81d GS |
21019 | =back |
21020 | ||
ff426ff2 JH |
21021 | =head2 Tie::File - Access the lines of a disk file via a Perl array |
21022 | ||
21023 | =over 4 | |
21024 | ||
21025 | =item SYNOPSIS | |
21026 | ||
21027 | =item DESCRIPTION | |
21028 | ||
21029 | =over 4 | |
21030 | ||
21031 | =item C<recsep> | |
21032 | ||
b2deec1d JH |
21033 | =item C<autochomp> |
21034 | ||
ff426ff2 JH |
21035 | =item C<mode> |
21036 | ||
b2deec1d JH |
21037 | =item C<memory> |
21038 | ||
21039 | =item C<dw_size> | |
ff426ff2 JH |
21040 | |
21041 | =item Option Format | |
21042 | ||
21043 | =back | |
21044 | ||
21045 | =item Public Methods | |
21046 | ||
21047 | =over 4 | |
21048 | ||
21049 | =item C<flock> | |
21050 | ||
b2deec1d | 21051 | =item C<autochomp> |
ff426ff2 | 21052 | |
e993db8c | 21053 | =item C<defer>, C<flush>, C<discard>, and C<autodefer> |
ff426ff2 | 21054 | |
8b9c797b JH |
21055 | =item C<offset> |
21056 | ||
b2deec1d | 21057 | =back |
ff426ff2 | 21058 | |
b2deec1d | 21059 | =item Tying to an already-opened filehandle |
ff426ff2 | 21060 | |
b2deec1d | 21061 | =item Deferred Writing |
ff426ff2 | 21062 | |
e993db8c | 21063 | =over 4 |
ff426ff2 | 21064 | |
e993db8c JH |
21065 | =item Autodeferring |
21066 | ||
21067 | =back | |
21068 | ||
8b9c797b JH |
21069 | =item CONCURRENT ACCESS TO FILES |
21070 | ||
e993db8c | 21071 | =item CAVEATS |
ff426ff2 | 21072 | |
b2deec1d | 21073 | =item SUBCLASSING |
ff426ff2 | 21074 | |
b2deec1d | 21075 | =item WHAT ABOUT C<DB_File>? |
ff426ff2 JH |
21076 | |
21077 | =item AUTHOR | |
21078 | ||
21079 | =item LICENSE | |
21080 | ||
21081 | =item WARRANTY | |
21082 | ||
21083 | =item THANKS | |
21084 | ||
21085 | =item TODO | |
21086 | ||
21087 | =back | |
21088 | ||
14218588 GS |
21089 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
21090 | handles | |
193fb0af | 21091 | |
d420ca49 | 21092 | =over 4 |
a45bd81d | 21093 | |
193fb0af GS |
21094 | =item SYNOPSIS |
21095 | ||
21096 | =item DESCRIPTION | |
21097 | ||
21098 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
21099 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
14218588 GS |
21100 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
21101 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
193fb0af GS |
21102 | |
21103 | =item MORE INFORMATION | |
21104 | ||
37d4d706 JH |
21105 | =item COMPATIBILITY |
21106 | ||
a45bd81d GS |
21107 | =back |
21108 | ||
12b7c5c7 JH |
21109 | =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for |
21110 | tied hashes | |
8ebc5c01 | 21111 | |
d420ca49 | 21112 | =over 4 |
a45bd81d | 21113 | |
8ebc5c01 | 21114 | =item SYNOPSIS |
21115 | ||
21116 | =item DESCRIPTION | |
cb1a09d0 | 21117 | |
8ebc5c01 | 21118 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
f262848d RGS |
21119 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR |
21120 | this, SCALAR this | |
cb1a09d0 | 21121 | |
12b7c5c7 JH |
21122 | =item Inheriting from B<Tie::StdHash> |
21123 | ||
21124 | =item Inheriting from B<Tie::ExtraHash> | |
21125 | ||
f262848d | 21126 | =item C<SCALAR>, C<UNTIE> and C<DESTROY> |
cb1a09d0 | 21127 | |
8ebc5c01 | 21128 | =item MORE INFORMATION |
cb1a09d0 | 21129 | |
a45bd81d GS |
21130 | =back |
21131 | ||
12b7c5c7 JH |
21132 | =head2 Tie::Memoize - add data to hash when needed |
21133 | ||
21134 | =over 4 | |
21135 | ||
21136 | =item SYNOPSIS | |
21137 | ||
21138 | =item DESCRIPTION | |
21139 | ||
21140 | =item Inheriting from B<Tie::Memoize> | |
21141 | ||
21142 | =item EXAMPLE | |
21143 | ||
21144 | =item BUGS | |
21145 | ||
21146 | =item AUTHOR | |
21147 | ||
21148 | =back | |
21149 | ||
8ebc5c01 | 21150 | =head2 Tie::RefHash - use references as hash keys |
cb1a09d0 | 21151 | |
d420ca49 | 21152 | =over 4 |
a45bd81d | 21153 | |
cb1a09d0 AD |
21154 | =item SYNOPSIS |
21155 | ||
cb1a09d0 AD |
21156 | =item DESCRIPTION |
21157 | ||
8ebc5c01 | 21158 | =item EXAMPLE |
cb1a09d0 AD |
21159 | |
21160 | =item AUTHOR | |
21161 | ||
8ebc5c01 | 21162 | =item VERSION |
cb1a09d0 | 21163 | |
8ebc5c01 | 21164 | =item SEE ALSO |
cb1a09d0 | 21165 | |
a45bd81d GS |
21166 | =back |
21167 | ||
8ebc5c01 | 21168 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
21169 | scalars | |
cb1a09d0 | 21170 | |
d420ca49 | 21171 | =over 4 |
a45bd81d | 21172 | |
cb1a09d0 AD |
21173 | =item SYNOPSIS |
21174 | ||
cb1a09d0 AD |
21175 | =item DESCRIPTION |
21176 | ||
8ebc5c01 | 21177 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
cb1a09d0 | 21178 | |
8ebc5c01 | 21179 | =item MORE INFORMATION |
cb1a09d0 | 21180 | |
a45bd81d GS |
21181 | =back |
21182 | ||
8ebc5c01 | 21183 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
cb1a09d0 | 21184 | |
d420ca49 | 21185 | =over 4 |
a45bd81d | 21186 | |
8ebc5c01 | 21187 | =item SYNOPSIS |
cb1a09d0 | 21188 | |
8ebc5c01 | 21189 | =item DESCRIPTION |
cb1a09d0 | 21190 | |
8ebc5c01 | 21191 | =item CAVEATS |
cb1a09d0 | 21192 | |
a45bd81d GS |
21193 | =back |
21194 | ||
1fdc5aa6 JH |
21195 | =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval |
21196 | timers | |
41ca3a40 JH |
21197 | |
21198 | =over 4 | |
21199 | ||
21200 | =item SYNOPSIS | |
21201 | ||
21202 | =item DESCRIPTION | |
21203 | ||
21204 | gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, | |
245d750e | 21205 | $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), |
30487ceb RGS |
21206 | alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( |
21207 | $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer ( | |
21208 | $which ) | |
41ca3a40 JH |
21209 | |
21210 | =item EXAMPLES | |
21211 | ||
21212 | =item C API | |
21213 | ||
8b9c797b JH |
21214 | =item DIAGNOSTICS |
21215 | ||
21216 | =over 4 | |
21217 | ||
21218 | =item negative time not invented yet | |
21219 | ||
21220 | =item internal error: useconds < 0 (unsigned ... signed ...) | |
21221 | ||
21222 | =back | |
21223 | ||
245d750e JH |
21224 | =item CAVEATS |
21225 | ||
41ca3a40 JH |
21226 | =item AUTHORS |
21227 | ||
2a551100 | 21228 | =item COPYRIGHT AND LICENSE |
41ca3a40 JH |
21229 | |
21230 | =back | |
21231 | ||
8ebc5c01 | 21232 | =head2 Time::Local - efficiently compute time from local and GMT time |
cb1a09d0 | 21233 | |
d420ca49 | 21234 | =over 4 |
a45bd81d | 21235 | |
8ebc5c01 | 21236 | =item SYNOPSIS |
cb1a09d0 | 21237 | |
8ebc5c01 | 21238 | =item DESCRIPTION |
cb1a09d0 | 21239 | |
2e038148 NC |
21240 | =over 4 |
21241 | ||
21242 | =item Ambiguous Local Times (DST) | |
21243 | ||
5f15c94e NC |
21244 | =item Non-Existent Local Times (DST) |
21245 | ||
2e038148 NC |
21246 | =item Negative Epoch Values |
21247 | ||
21248 | =back | |
21249 | ||
14218588 GS |
21250 | =item IMPLEMENTATION |
21251 | ||
21252 | =item BUGS | |
21253 | ||
0d53b15f JH |
21254 | =item SUPPORT |
21255 | ||
21256 | =item AUTHOR | |
21257 | ||
a45bd81d GS |
21258 | =back |
21259 | ||
8ebc5c01 | 21260 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
21261 | function | |
7d2bfb28 | 21262 | |
d420ca49 | 21263 | =over 4 |
a45bd81d | 21264 | |
7d2bfb28 | 21265 | =item SYNOPSIS |
21266 | ||
7d2bfb28 | 21267 | =item DESCRIPTION |
21268 | ||
8ebc5c01 | 21269 | =item NOTE |
7d2bfb28 | 21270 | |
8ebc5c01 | 21271 | =item AUTHOR |
7d2bfb28 | 21272 | |
a45bd81d GS |
21273 | =back |
21274 | ||
8ebc5c01 | 21275 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
21276 | function | |
7d2bfb28 | 21277 | |
d420ca49 | 21278 | =over 4 |
a45bd81d | 21279 | |
8ebc5c01 | 21280 | =item SYNOPSIS |
7d2bfb28 | 21281 | |
8ebc5c01 | 21282 | =item DESCRIPTION |
7d2bfb28 | 21283 | |
8ebc5c01 | 21284 | =item NOTE |
7d2bfb28 | 21285 | |
8ebc5c01 | 21286 | =item AUTHOR |
7d2bfb28 | 21287 | |
a45bd81d GS |
21288 | =back |
21289 | ||
8ebc5c01 | 21290 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 21291 | |
d420ca49 | 21292 | =over 4 |
a45bd81d | 21293 | |
7d2bfb28 | 21294 | =item SYNOPSIS |
21295 | ||
8ebc5c01 | 21296 | =item DESCRIPTION |
21297 | ||
21298 | =item AUTHOR | |
21299 | ||
a45bd81d GS |
21300 | =back |
21301 | ||
8ebc5c01 | 21302 | =head2 UNIVERSAL - base class for ALL classes (blessed references) |
21303 | ||
d420ca49 | 21304 | =over 4 |
a45bd81d | 21305 | |
8ebc5c01 | 21306 | =item SYNOPSIS |
7d2bfb28 | 21307 | |
21308 | =item DESCRIPTION | |
21309 | ||
2a551100 JH |
21310 | C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>, |
21311 | C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<< | |
21312 | CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )> | |
21313 | ||
21314 | =item EXPORTS | |
7d2bfb28 | 21315 | |
a45bd81d GS |
21316 | =back |
21317 | ||
849d92fd | 21318 | =head2 Unicode::Collate - Unicode Collation Algorithm |
53d7eaa8 JH |
21319 | |
21320 | =over 4 | |
21321 | ||
21322 | =item SYNOPSIS | |
21323 | ||
21324 | =item DESCRIPTION | |
21325 | ||
21326 | =over 4 | |
21327 | ||
21328 | =item Constructor and Tailoring | |
21329 | ||
2baadb76 RGS |
21330 | UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar, |
21331 | level, normalization, overrideCJK, overrideHangul, preprocess, rearrange, | |
21332 | table, undefName, undefChar, katakana_before_hiragana, upper_before_lower, | |
21333 | variable, alternate | |
53d7eaa8 | 21334 | |
849d92fd | 21335 | =item Methods for Collation |
53d7eaa8 | 21336 | |
ba62762e JH |
21337 | C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = |
21338 | $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, | |
21339 | C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, | |
21340 | $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = | |
21341 | $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, | |
849d92fd | 21342 | C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm = |
2a551100 JH |
21343 | $Collator-E<gt>viewSortKey($string)> |
21344 | ||
21345 | =item Methods for Searching | |
21346 | ||
21347 | C<$position = $Collator-E<gt>index($string, $substring[, $position])>, | |
21348 | C<($position, $length) = $Collator-E<gt>index($string, $substring[, | |
21349 | $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>, | |
21350 | C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match = | |
21351 | $Collator-E<gt>gmatch($string, $substring)>, C<$count = | |
21352 | $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count = | |
21353 | $Collator-E<gt>gsubst($string, $substring, $replacement)> | |
53d7eaa8 | 21354 | |
849d92fd JH |
21355 | =item Other Methods |
21356 | ||
2baadb76 RGS |
21357 | C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version = |
21358 | $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()> | |
849d92fd | 21359 | |
53d7eaa8 JH |
21360 | =item EXPORT |
21361 | ||
21362 | =item CAVEAT | |
21363 | ||
2a551100 | 21364 | =item Conformance Test |
849d92fd | 21365 | |
53d7eaa8 JH |
21366 | =back |
21367 | ||
21368 | =item AUTHOR | |
21369 | ||
21370 | =item SEE ALSO | |
21371 | ||
2baadb76 RGS |
21372 | Unicode Collation Algorithm - UTS #10, The Default Unicode Collation |
21373 | Element Table (DUCET), The conformance test for the UCA, Hangul Syllable | |
21374 | Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize> | |
53d7eaa8 JH |
21375 | |
21376 | =back | |
21377 | ||
95fb7f7f | 21378 | =head2 Unicode::Normalize - Unicode Normalization Forms |
53d7eaa8 JH |
21379 | |
21380 | =over 4 | |
21381 | ||
21382 | =item SYNOPSIS | |
21383 | ||
21384 | =item DESCRIPTION | |
21385 | ||
f502af34 JH |
21386 | =over 4 |
21387 | ||
21388 | =item Normalization Forms | |
21389 | ||
b2deec1d JH |
21390 | C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, |
21391 | C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, | |
2baadb76 | 21392 | C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>, |
b2deec1d JH |
21393 | C<$normalized_string = normalize($form_name, $string)> |
21394 | ||
21395 | =item Decomposition and Composition | |
21396 | ||
21397 | C<$decomposed_string = decompose($string)>, C<$decomposed_string = | |
21398 | decompose($string, $useCompatMapping)>, C<$reordered_string = | |
21399 | reorder($string)>, C<$composed_string = compose($string)> | |
21400 | ||
21401 | =item Quick Check | |
21402 | ||
21403 | C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = | |
21404 | checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = | |
2baadb76 | 21405 | checkFCD($string)>, C<$result = checkFCC($string)>, C<$result = |
b2deec1d | 21406 | check($form_name, $string)> |
53d7eaa8 | 21407 | |
f502af34 JH |
21408 | =item Character Data |
21409 | ||
21410 | C<$canonical_decomposed = getCanon($codepoint)>, | |
b2deec1d JH |
21411 | C<$compatibility_decomposed = getCompat($codepoint)>, |
21412 | C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, | |
21413 | C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = | |
21414 | isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, | |
2a551100 | 21415 | C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, |
b2deec1d | 21416 | C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> |
53d7eaa8 JH |
21417 | |
21418 | =item EXPORT | |
21419 | ||
21420 | =back | |
21421 | ||
21422 | =item AUTHOR | |
21423 | ||
21424 | =item SEE ALSO | |
21425 | ||
f262848d | 21426 | http://www.unicode.org/reports/tr15/, |
2baadb76 RGS |
21427 | http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, |
21428 | http://www.unicode.org/notes/tn5/ | |
53d7eaa8 JH |
21429 | |
21430 | =back | |
21431 | ||
2a2bf5f4 | 21432 | =head2 Unicode::UCD - Unicode character database |
354a27bf JH |
21433 | |
21434 | =over 4 | |
21435 | ||
21436 | =item SYNOPSIS | |
21437 | ||
21438 | =item DESCRIPTION | |
21439 | ||
21440 | =back | |
21441 | ||
21442 | =over 4 | |
21443 | ||
21444 | =item charinfo | |
21445 | ||
21446 | =back | |
21447 | ||
21448 | =over 4 | |
21449 | ||
21450 | =item charblock | |
21451 | ||
21452 | =back | |
21453 | ||
21454 | =over 4 | |
21455 | ||
fbe3d936 JH |
21456 | =item charscript |
21457 | ||
21458 | =back | |
21459 | ||
21460 | =over 4 | |
21461 | ||
389925df | 21462 | =item charblocks |
fbe3d936 JH |
21463 | |
21464 | =back | |
21465 | ||
21466 | =over 4 | |
21467 | ||
389925df JH |
21468 | =item charscripts |
21469 | ||
21470 | =back | |
21471 | ||
21472 | =over 4 | |
21473 | ||
21474 | =item Blocks versus Scripts | |
21475 | ||
21476 | =item Matching Scripts and Blocks | |
21477 | ||
d0363f02 JH |
21478 | =item Code Point Arguments |
21479 | ||
389925df JH |
21480 | =item charinrange |
21481 | ||
21482 | =back | |
21483 | ||
21484 | =over 4 | |
21485 | ||
d0363f02 JH |
21486 | =item compexcl |
21487 | ||
21488 | =back | |
21489 | ||
21490 | =over 4 | |
21491 | ||
21492 | =item casefold | |
21493 | ||
21494 | =back | |
21495 | ||
21496 | =over 4 | |
21497 | ||
21498 | =item casespec | |
21499 | ||
21500 | =back | |
21501 | ||
21502 | =over 4 | |
21503 | ||
2a2bf5f4 | 21504 | =item Unicode::UCD::UnicodeVersion |
389925df JH |
21505 | |
21506 | =back | |
21507 | ||
21508 | =over 4 | |
21509 | ||
21510 | =item Implementation Note | |
21511 | ||
21512 | =back | |
21513 | ||
21514 | =over 4 | |
fbe3d936 | 21515 | |
cb52f95f JH |
21516 | =item BUGS |
21517 | ||
354a27bf JH |
21518 | =item AUTHOR |
21519 | ||
21520 | =back | |
21521 | ||
8ebc5c01 | 21522 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
21523 | functions | |
7d2bfb28 | 21524 | |
d420ca49 | 21525 | =over 4 |
a45bd81d | 21526 | |
8ebc5c01 | 21527 | =item SYNOPSIS |
7d2bfb28 | 21528 | |
8ebc5c01 | 21529 | =item DESCRIPTION |
7d2bfb28 | 21530 | |
8ebc5c01 | 21531 | =item NOTE |
7d2bfb28 | 21532 | |
8ebc5c01 | 21533 | =item AUTHOR |
7d2bfb28 | 21534 | |
a45bd81d GS |
21535 | =back |
21536 | ||
8ebc5c01 | 21537 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
21538 | functions | |
cb1a09d0 | 21539 | |
d420ca49 | 21540 | =over 4 |
a45bd81d | 21541 | |
cb1a09d0 AD |
21542 | =item SYNOPSIS |
21543 | ||
cb1a09d0 AD |
21544 | =item DESCRIPTION |
21545 | ||
d420ca49 | 21546 | =over 4 |
b38f6a39 | 21547 | |
37590e52 | 21548 | =item System Specifics |
b38f6a39 GS |
21549 | |
21550 | =back | |
21551 | ||
37590e52 | 21552 | =item NOTE |
b38f6a39 GS |
21553 | |
21554 | =item AUTHOR | |
21555 | ||
37590e52 | 21556 | =item HISTORY |
b38f6a39 | 21557 | |
37590e52 | 21558 | March 18th, 2000 |
b38f6a39 GS |
21559 | |
21560 | =back | |
21561 | ||
639f8edf HS |
21562 | =head2 XSLoader - Dynamically load C libraries into Perl code |
21563 | ||
21564 | =over 4 | |
21565 | ||
21566 | =item SYNOPSIS | |
21567 | ||
21568 | =item DESCRIPTION | |
21569 | ||
21570 | =over 4 | |
21571 | ||
21572 | =item Migration from C<DynaLoader> | |
21573 | ||
21574 | =item Backward compatible boilerplate | |
21575 | ||
21576 | =back | |
21577 | ||
21578 | =item Order of initialization: early load() | |
21579 | ||
21580 | =over 4 | |
21581 | ||
21582 | =item The most hairy case | |
21583 | ||
21584 | =back | |
21585 | ||
21586 | =item LIMITATIONS | |
21587 | ||
21588 | =item AUTHOR | |
21589 | ||
21590 | =back | |
21591 | ||
cb1a09d0 AD |
21592 | =head1 AUXILIARY DOCUMENTATION |
21593 | ||
8ebc5c01 | 21594 | Here should be listed all the extra programs' documentation, but they |
21595 | don't all have manual pages yet: | |
cb1a09d0 | 21596 | |
d420ca49 | 21597 | =over 4 |
a45bd81d | 21598 | |
cb1a09d0 AD |
21599 | =item a2p |
21600 | ||
41630250 | 21601 | =item c2ph |
cb1a09d0 | 21602 | |
41630250 | 21603 | =item dprofpp |
cb1a09d0 AD |
21604 | |
21605 | =item h2ph | |
21606 | ||
cb1a09d0 AD |
21607 | =item h2xs |
21608 | ||
41630250 JH |
21609 | =item perlbug |
21610 | ||
21611 | =item perldoc | |
21612 | ||
21613 | =item pl2pm | |
21614 | ||
21615 | =item pod2html | |
cb1a09d0 AD |
21616 | |
21617 | =item pod2man | |
21618 | ||
41630250 JH |
21619 | =item s2p |
21620 | ||
21621 | =item splain | |
21622 | ||
21623 | =item xsubpp | |
cb1a09d0 | 21624 | |
a45bd81d GS |
21625 | =back |
21626 | ||
cb1a09d0 AD |
21627 | =head1 AUTHOR |
21628 | ||
2ae324a7 | 21629 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
8ebc5c01 | 21630 | of other folks. |
cb1a09d0 | 21631 |