Commit | Line | Data |
---|---|---|
cb1a09d0 | 1 | |
7ba761b0 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. | |
7ba761b0 | 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 | ||
50e34432 | 110 | =head2 perlreftut - Mark's very short tutorial about references |
68dc0745 | 111 | |
d420ca49 | 112 | =over 4 |
a45bd81d | 113 | |
68dc0745 | 114 | =item DESCRIPTION |
115 | ||
50e34432 JH |
116 | =item Who Needs Complicated Data Structures? |
117 | ||
118 | =item The Solution | |
119 | ||
120 | =item Syntax | |
121 | ||
983dbef6 | 122 | =over 4 |
68dc0745 | 123 | |
50e34432 | 124 | =item Making References |
68dc0745 | 125 | |
50e34432 | 126 | =item Using References |
68dc0745 | 127 | |
50e34432 JH |
128 | =item An Example |
129 | ||
130 | =item Arrow Rule | |
68dc0745 | 131 | |
35c7d401 | 132 | =back |
68dc0745 | 133 | |
50e34432 | 134 | =item Solution |
68dc0745 | 135 | |
50e34432 JH |
136 | =item The Rest |
137 | ||
138 | =item Summary | |
139 | ||
140 | =item Credits | |
68dc0745 | 141 | |
35c7d401 | 142 | =over 4 |
68dc0745 | 143 | |
50e34432 | 144 | =item Distribution Conditions |
68dc0745 | 145 | |
50e34432 | 146 | =back |
68dc0745 | 147 | |
a45bd81d GS |
148 | =back |
149 | ||
50e34432 | 150 | =head2 perldsc - Perl Data Structures Cookbook |
68dc0745 | 151 | |
50e34432 | 152 | =over 4 |
a45bd81d | 153 | |
50e34432 | 154 | =item DESCRIPTION |
68dc0745 | 155 | |
50e34432 JH |
156 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
157 | more elaborate constructs | |
68dc0745 | 158 | |
50e34432 | 159 | =item REFERENCES |
b40eed9c | 160 | X<reference> X<dereference> X<dereferencing> X<pointer> |
68dc0745 | 161 | |
50e34432 | 162 | =item COMMON MISTAKES |
68dc0745 | 163 | |
50e34432 | 164 | =item CAVEAT ON PRECEDENCE |
b40eed9c | 165 | X<dereference, precedence> X<dereferencing, precedence> |
68dc0745 | 166 | |
50e34432 | 167 | =item WHY YOU SHOULD ALWAYS C<use strict> |
68dc0745 | 168 | |
50e34432 | 169 | =item DEBUGGING |
b40eed9c NC |
170 | X<data structure, debugging> X<complex data structure, debugging> |
171 | X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging> | |
172 | X<array of arrays, debugging> X<hash of arrays, debugging> | |
173 | X<array of hashes, debugging> X<hash of hashes, debugging> | |
983dbef6 | 174 | |
50e34432 | 175 | =item CODE EXAMPLES |
983dbef6 | 176 | |
50e34432 | 177 | =item ARRAYS OF ARRAYS |
b40eed9c | 178 | X<array of arrays> X<AoA> |
68dc0745 | 179 | |
50e34432 | 180 | =over 4 |
68dc0745 | 181 | |
50e34432 | 182 | =item Declaration of an ARRAY OF ARRAYS |
983dbef6 | 183 | |
50e34432 JH |
184 | =item Generation of an ARRAY OF ARRAYS |
185 | ||
186 | =item Access and Printing of an ARRAY OF ARRAYS | |
983dbef6 | 187 | |
4755096e | 188 | =back |
68dc0745 | 189 | |
50e34432 | 190 | =item HASHES OF ARRAYS |
b40eed9c | 191 | X<hash of arrays> X<HoA> |
68dc0745 | 192 | |
d420ca49 | 193 | =over 4 |
68dc0745 | 194 | |
50e34432 JH |
195 | =item Declaration of a HASH OF ARRAYS |
196 | ||
197 | =item Generation of a HASH OF ARRAYS | |
198 | ||
199 | =item Access and Printing of a HASH OF ARRAYS | |
68dc0745 | 200 | |
a45bd81d GS |
201 | =back |
202 | ||
50e34432 | 203 | =item ARRAYS OF HASHES |
b40eed9c | 204 | X<array of hashes> X<AoH> |
a45bd81d | 205 | |
d420ca49 | 206 | =over 4 |
68dc0745 | 207 | |
50e34432 | 208 | =item Declaration of an ARRAY OF HASHES |
68dc0745 | 209 | |
50e34432 | 210 | =item Generation of an ARRAY OF HASHES |
68dc0745 | 211 | |
50e34432 | 212 | =item Access and Printing of an ARRAY OF HASHES |
68dc0745 | 213 | |
50e34432 | 214 | =back |
73fba812 | 215 | |
50e34432 | 216 | =item HASHES OF HASHES |
b40eed9c | 217 | X<hass of hashes> X<HoH> |
68dc0745 | 218 | |
50e34432 | 219 | =over 4 |
3fe9a6f1 | 220 | |
50e34432 | 221 | =item Declaration of a HASH OF HASHES |
68dc0745 | 222 | |
50e34432 | 223 | =item Generation of a HASH OF HASHES |
68dc0745 | 224 | |
50e34432 | 225 | =item Access and Printing of a HASH OF HASHES |
68dc0745 | 226 | |
50e34432 | 227 | =back |
68dc0745 | 228 | |
50e34432 | 229 | =item MORE ELABORATE RECORDS |
b40eed9c | 230 | X<record> X<structure> X<struct> |
68dc0745 | 231 | |
50e34432 | 232 | =over 4 |
68dc0745 | 233 | |
50e34432 JH |
234 | =item Declaration of MORE ELABORATE RECORDS |
235 | ||
236 | =item Declaration of a HASH OF COMPLEX RECORDS | |
237 | ||
238 | =item Generation of a HASH OF COMPLEX RECORDS | |
68dc0745 | 239 | |
4755096e | 240 | =back |
68dc0745 | 241 | |
50e34432 JH |
242 | =item Database Ties |
243 | ||
244 | =item SEE ALSO | |
245 | ||
246 | =item AUTHOR | |
247 | ||
4755096e | 248 | =back |
193fb0af | 249 | |
50e34432 | 250 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
68dc0745 | 251 | |
d420ca49 | 252 | =over 4 |
68dc0745 | 253 | |
4755096e | 254 | =item DESCRIPTION |
68dc0745 | 255 | |
d420ca49 | 256 | =over 4 |
68dc0745 | 257 | |
50e34432 | 258 | =item Declaration and Access of Arrays of Arrays |
4755096e | 259 | |
50e34432 | 260 | =item Growing Your Own |
4755096e | 261 | |
50e34432 | 262 | =item Access and Printing |
1184f6df | 263 | |
4755096e GS |
264 | =item Slices |
265 | ||
68dc0745 | 266 | =back |
267 | ||
4755096e | 268 | =item SEE ALSO |
68dc0745 | 269 | |
50e34432 JH |
270 | =item AUTHOR |
271 | ||
a45bd81d GS |
272 | =back |
273 | ||
50e34432 | 274 | =head2 perlrequick - Perl regular expressions quick start |
68dc0745 | 275 | |
d420ca49 | 276 | =over 4 |
a45bd81d | 277 | |
68dc0745 | 278 | =item DESCRIPTION |
279 | ||
50e34432 | 280 | =item The Guide |
68dc0745 | 281 | |
50e34432 | 282 | =over 4 |
68dc0745 | 283 | |
50e34432 | 284 | =item Simple word matching |
14218588 | 285 | |
50e34432 | 286 | =item Using character classes |
68dc0745 | 287 | |
50e34432 | 288 | =item Matching this or that |
68dc0745 | 289 | |
50e34432 | 290 | =item Grouping things and hierarchical matching |
68dc0745 | 291 | |
50e34432 | 292 | =item Extracting matches |
68dc0745 | 293 | |
50e34432 | 294 | =item Matching repetitions |
68dc0745 | 295 | |
50e34432 | 296 | =item More matching |
68dc0745 | 297 | |
50e34432 | 298 | =item Search and replace |
68dc0745 | 299 | |
50e34432 | 300 | =item The split operator |
68dc0745 | 301 | |
50e34432 | 302 | =back |
68dc0745 | 303 | |
50e34432 | 304 | =item BUGS |
68dc0745 | 305 | |
50e34432 | 306 | =item SEE ALSO |
68dc0745 | 307 | |
50e34432 | 308 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 309 | |
50e34432 | 310 | =over 4 |
68dc0745 | 311 | |
50e34432 | 312 | =item Acknowledgments |
14218588 | 313 | |
50e34432 | 314 | =back |
68dc0745 | 315 | |
50e34432 | 316 | =back |
68dc0745 | 317 | |
50e34432 | 318 | =head2 perlretut - Perl regular expressions tutorial |
68dc0745 | 319 | |
50e34432 | 320 | =over 4 |
68dc0745 | 321 | |
50e34432 | 322 | =item DESCRIPTION |
68dc0745 | 323 | |
50e34432 | 324 | =item Part 1: The basics |
68dc0745 | 325 | |
50e34432 | 326 | =over 4 |
68dc0745 | 327 | |
50e34432 | 328 | =item Simple word matching |
68dc0745 | 329 | |
50e34432 | 330 | =item Using character classes |
68dc0745 | 331 | |
50e34432 | 332 | =item Matching this or that |
68dc0745 | 333 | |
50e34432 | 334 | =item Grouping things and hierarchical matching |
4755096e | 335 | |
50e34432 | 336 | =item Extracting matches |
4755096e | 337 | |
50e34432 | 338 | =item Matching repetitions |
4755096e | 339 | |
50e34432 | 340 | =item Building a regexp |
68dc0745 | 341 | |
50e34432 | 342 | =item Using regular expressions in Perl |
a45bd81d | 343 | |
4755096e GS |
344 | =back |
345 | ||
50e34432 | 346 | =item Part 2: Power tools |
c2e66d9e | 347 | |
d420ca49 | 348 | =over 4 |
c2e66d9e | 349 | |
50e34432 | 350 | =item More on characters, strings, and character classes |
c2e66d9e | 351 | |
50e34432 | 352 | =item Compiling and saving regular expressions |
c2e66d9e | 353 | |
50e34432 | 354 | =item Embedding comments and modifiers in a regular expression |
c2e66d9e | 355 | |
50e34432 | 356 | =item Non-capturing groupings |
c2e66d9e | 357 | |
50e34432 | 358 | =item Looking ahead and looking behind |
c2e66d9e | 359 | |
50e34432 | 360 | =item Using independent subexpressions to prevent backtracking |
c2e66d9e | 361 | |
50e34432 | 362 | =item Conditional expressions |
23be5fc4 | 363 | |
50e34432 | 364 | =item A bit of magic: executing Perl code in a regular expression |
c2e66d9e | 365 | |
50e34432 | 366 | =item Pragmas and debugging |
c2e66d9e | 367 | |
50e34432 | 368 | =back |
c2e66d9e | 369 | |
50e34432 | 370 | =item BUGS |
c2e66d9e | 371 | |
50e34432 | 372 | =item SEE ALSO |
c2e66d9e | 373 | |
50e34432 | 374 | =item AUTHOR AND COPYRIGHT |
c2e66d9e | 375 | |
50e34432 | 376 | =over 4 |
c2e66d9e | 377 | |
50e34432 | 378 | =item Acknowledgments |
c2e66d9e GS |
379 | |
380 | =back | |
381 | ||
c2e66d9e GS |
382 | =back |
383 | ||
50e34432 | 384 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
c2e66d9e | 385 | |
d420ca49 | 386 | =over 4 |
c2e66d9e GS |
387 | |
388 | =item DESCRIPTION | |
389 | ||
d420ca49 | 390 | =over 4 |
c2e66d9e | 391 | |
50e34432 | 392 | =item If we could talk to the animals... |
c2e66d9e | 393 | |
50e34432 | 394 | =item Introducing the method invocation arrow |
c2e66d9e | 395 | |
50e34432 | 396 | =item Invoking a barnyard |
c2e66d9e | 397 | |
50e34432 | 398 | =item The extra parameter of method invocation |
c2e66d9e | 399 | |
50e34432 | 400 | =item Calling a second method to simplify things |
c2e66d9e | 401 | |
50e34432 | 402 | =item Inheriting the windpipes |
c2e66d9e | 403 | |
50e34432 | 404 | =item A few notes about @ISA |
68dc0745 | 405 | |
50e34432 | 406 | =item Overriding the methods |
a45bd81d | 407 | |
50e34432 | 408 | =item Starting the search from a different place |
68dc0745 | 409 | |
50e34432 | 410 | =item The SUPER way of doing things |
4755096e | 411 | |
50e34432 | 412 | =item Where we're at so far... |
4755096e | 413 | |
50e34432 | 414 | =item A horse is a horse, of course of course -- or is it? |
68dc0745 | 415 | |
50e34432 | 416 | =item Invoking an instance method |
68dc0745 | 417 | |
50e34432 | 418 | =item Accessing the instance data |
46fc3d4c | 419 | |
50e34432 | 420 | =item How to build a horse |
68dc0745 | 421 | |
50e34432 | 422 | =item Inheriting the constructor |
68dc0745 | 423 | |
50e34432 | 424 | =item Making a method work with either classes or instances |
14218588 | 425 | |
50e34432 | 426 | =item Adding parameters to a method |
ee382f2f | 427 | |
50e34432 | 428 | =item More interesting instances |
68dc0745 | 429 | |
50e34432 | 430 | =item A horse of a different color |
68dc0745 | 431 | |
4755096e | 432 | =item Summary |
68dc0745 | 433 | |
50e34432 | 434 | =back |
4755096e | 435 | |
50e34432 | 436 | =item SEE ALSO |
68dc0745 | 437 | |
50e34432 | 438 | =item COPYRIGHT |
68dc0745 | 439 | |
4755096e GS |
440 | =back |
441 | ||
50e34432 | 442 | =head2 perltoot - Tom's object-oriented tutorial for perl |
68dc0745 | 443 | |
d420ca49 | 444 | =over 4 |
68dc0745 | 445 | |
4755096e | 446 | =item DESCRIPTION |
68dc0745 | 447 | |
50e34432 | 448 | =item Creating a Class |
14218588 | 449 | |
50e34432 | 450 | =over 4 |
68dc0745 | 451 | |
50e34432 | 452 | =item Object Representation |
68dc0745 | 453 | |
50e34432 | 454 | =item Class Interface |
68dc0745 | 455 | |
50e34432 | 456 | =item Constructors and Instance Methods |
14218588 | 457 | |
50e34432 | 458 | =item Planning for the Future: Better Constructors |
68dc0745 | 459 | |
50e34432 | 460 | =item Destructors |
68dc0745 | 461 | |
50e34432 JH |
462 | =item Other Object Methods |
463 | ||
464 | =back | |
465 | ||
466 | =item Class Data | |
68dc0745 | 467 | |
d420ca49 | 468 | =over 4 |
68dc0745 | 469 | |
50e34432 | 470 | =item Accessing Class Data |
68dc0745 | 471 | |
50e34432 | 472 | =item Debugging Methods |
68dc0745 | 473 | |
50e34432 JH |
474 | =item Class Destructors |
475 | ||
476 | =item Documenting the Interface | |
68dc0745 | 477 | |
4755096e | 478 | =back |
68dc0745 | 479 | |
50e34432 JH |
480 | =item Aggregation |
481 | ||
482 | =item Inheritance | |
68dc0745 | 483 | |
d420ca49 | 484 | =over 4 |
68dc0745 | 485 | |
50e34432 | 486 | =item Overridden Methods |
68dc0745 | 487 | |
50e34432 | 488 | =item Multiple Inheritance |
68dc0745 | 489 | |
50e34432 | 490 | =item UNIVERSAL: The Root of All Objects |
68dc0745 | 491 | |
4755096e | 492 | =back |
68dc0745 | 493 | |
50e34432 | 494 | =item Alternate Object Representations |
68dc0745 | 495 | |
d420ca49 | 496 | =over 4 |
68dc0745 | 497 | |
50e34432 | 498 | =item Arrays as Objects |
68dc0745 | 499 | |
50e34432 | 500 | =item Closures as Objects |
14218588 | 501 | |
4755096e | 502 | =back |
68dc0745 | 503 | |
50e34432 | 504 | =item AUTOLOAD: Proxy Methods |
68dc0745 | 505 | |
d420ca49 | 506 | =over 4 |
68dc0745 | 507 | |
50e34432 | 508 | =item Autoloaded Data Methods |
68dc0745 | 509 | |
50e34432 | 510 | =item Inherited Autoloaded Data Methods |
68dc0745 | 511 | |
512 | =back | |
513 | ||
50e34432 | 514 | =item Metaclassical Tools |
68dc0745 | 515 | |
d420ca49 | 516 | =over 4 |
68dc0745 | 517 | |
50e34432 | 518 | =item Class::Struct |
68dc0745 | 519 | |
50e34432 | 520 | =item Data Members as Variables |
68dc0745 | 521 | |
4755096e | 522 | =back |
68dc0745 | 523 | |
50e34432 | 524 | =item NOTES |
68dc0745 | 525 | |
50e34432 | 526 | =over 4 |
68dc0745 | 527 | |
50e34432 | 528 | =item Object Terminology |
14218588 | 529 | |
4755096e | 530 | =back |
68dc0745 | 531 | |
50e34432 | 532 | =item SEE ALSO |
68dc0745 | 533 | |
50e34432 | 534 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 535 | |
50e34432 | 536 | =item COPYRIGHT |
68dc0745 | 537 | |
d420ca49 | 538 | =over 4 |
68dc0745 | 539 | |
50e34432 | 540 | =item Acknowledgments |
68dc0745 | 541 | |
50e34432 | 542 | =back |
68dc0745 | 543 | |
50e34432 | 544 | =back |
68dc0745 | 545 | |
50e34432 | 546 | =head2 perltooc - Tom's OO Tutorial for Class Data in Perl |
68dc0745 | 547 | |
50e34432 | 548 | =over 4 |
68dc0745 | 549 | |
50e34432 | 550 | =item DESCRIPTION |
68dc0745 | 551 | |
50e34432 | 552 | =item Class Data in a Can |
68dc0745 | 553 | |
50e34432 | 554 | =item Class Data as Package Variables |
68dc0745 | 555 | |
50e34432 | 556 | =over 4 |
68dc0745 | 557 | |
50e34432 | 558 | =item Putting All Your Eggs in One Basket |
68dc0745 | 559 | |
50e34432 | 560 | =item Inheritance Concerns |
68dc0745 | 561 | |
50e34432 | 562 | =item The Eponymous Meta-Object |
68dc0745 | 563 | |
50e34432 | 564 | =item Indirect References to Class Data |
68dc0745 | 565 | |
50e34432 | 566 | =item Monadic Classes |
14218588 | 567 | |
50e34432 | 568 | =item Translucent Attributes |
68dc0745 | 569 | |
a45bd81d GS |
570 | =back |
571 | ||
50e34432 | 572 | =item Class Data as Lexical Variables |
68dc0745 | 573 | |
d420ca49 | 574 | =over 4 |
a45bd81d | 575 | |
50e34432 | 576 | =item Privacy and Responsibility |
68dc0745 | 577 | |
50e34432 | 578 | =item File-Scoped Lexicals |
68dc0745 | 579 | |
50e34432 | 580 | =item More Inheritance Concerns |
8a93676d | 581 | |
50e34432 | 582 | =item Locking the Door and Throwing Away the Key |
68dc0745 | 583 | |
50e34432 | 584 | =item Translucency Revisited |
68dc0745 | 585 | |
50e34432 | 586 | =back |
68dc0745 | 587 | |
50e34432 | 588 | =item NOTES |
68dc0745 | 589 | |
50e34432 | 590 | =item SEE ALSO |
8a93676d | 591 | |
50e34432 | 592 | =item AUTHOR AND COPYRIGHT |
8a93676d | 593 | |
50e34432 | 594 | =item ACKNOWLEDGEMENTS |
8a93676d | 595 | |
50e34432 | 596 | =item HISTORY |
193fb0af | 597 | |
c2e66d9e | 598 | =back |
68dc0745 | 599 | |
50e34432 | 600 | =head2 perlbot - Bag'o Object Tricks (the BOT) |
8a93676d SB |
601 | |
602 | =over 4 | |
603 | ||
604 | =item DESCRIPTION | |
605 | ||
50e34432 | 606 | =item OO SCALING TIPS |
8a93676d | 607 | |
50e34432 | 608 | =item INSTANCE VARIABLES |
8a93676d | 609 | |
50e34432 | 610 | =item SCALAR INSTANCE VARIABLES |
8a93676d | 611 | |
50e34432 | 612 | =item INSTANCE VARIABLE INHERITANCE |
8a93676d | 613 | |
50e34432 | 614 | =item OBJECT RELATIONSHIPS |
8a93676d | 615 | |
50e34432 | 616 | =item OVERRIDING SUPERCLASS METHODS |
8a93676d | 617 | |
50e34432 | 618 | =item USING RELATIONSHIP WITH SDBM |
8a93676d | 619 | |
50e34432 | 620 | =item THINKING OF CODE REUSE |
8a93676d | 621 | |
50e34432 | 622 | =item CLASS CONTEXT AND THE OBJECT |
8a93676d | 623 | |
50e34432 | 624 | =item INHERITING A CONSTRUCTOR |
8a93676d | 625 | |
50e34432 | 626 | =item DELEGATION |
68dc0745 | 627 | |
50e34432 | 628 | =item SEE ALSO |
68dc0745 | 629 | |
c2e66d9e | 630 | =back |
68dc0745 | 631 | |
c2e66d9e | 632 | =head2 perlstyle - Perl style guide |
68dc0745 | 633 | |
d420ca49 | 634 | =over 4 |
c2e66d9e GS |
635 | |
636 | =item DESCRIPTION | |
68dc0745 | 637 | |
4755096e | 638 | =back |
68dc0745 | 639 | |
50e34432 JH |
640 | =head2 perlcheat - Perl 5 Cheat Sheet |
641 | ||
642 | =over 4 | |
643 | ||
644 | =item DESCRIPTION | |
645 | ||
646 | =over 4 | |
647 | ||
648 | =item The sheet | |
649 | ||
650 | =back | |
651 | ||
652 | =item ACKNOWLEDGEMENTS | |
653 | ||
654 | =item AUTHOR | |
655 | ||
656 | =item SEE ALSO | |
657 | ||
658 | =back | |
659 | ||
c2e66d9e | 660 | =head2 perltrap - Perl traps for the unwary |
68dc0745 | 661 | |
d420ca49 | 662 | =over 4 |
68dc0745 | 663 | |
c2e66d9e | 664 | =item DESCRIPTION |
68dc0745 | 665 | |
d420ca49 | 666 | =over 4 |
68dc0745 | 667 | |
c2e66d9e | 668 | =item Awk Traps |
68dc0745 | 669 | |
1184f6df | 670 | =item C/C++ Traps |
4755096e | 671 | |
c2e66d9e | 672 | =item Sed Traps |
4755096e | 673 | |
c2e66d9e | 674 | =item Shell Traps |
4755096e | 675 | |
c2e66d9e | 676 | =item Perl Traps |
68dc0745 | 677 | |
c2e66d9e | 678 | =item Perl4 to Perl5 Traps |
68dc0745 | 679 | |
c2e66d9e GS |
680 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
681 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
682 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
683 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
684 | ||
685 | =item Discontinuance, Deprecation, and BugFix traps | |
686 | ||
b2a9ae16 NC |
687 | Symbols starting with "_" no longer forced into main, Double-colon valid |
688 | package separator in variable name, 2nd and 3rd args to C<splice()> are now | |
689 | in scalar context, Can't do C<goto> into a block that is optimized away, | |
690 | Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK | |
691 | BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when | |
692 | iterating over a list, C<split> with no args behavior changed, B<-e> | |
693 | behavior fixed, C<push> returns number of elements in resulting list, Some | |
694 | error messages differ, C<split()> honors subroutine args, Bugs removed | |
c2e66d9e GS |
695 | |
696 | =item Parsing Traps | |
697 | ||
b2a9ae16 NC |
698 | Space between . and = triggers syntax error, Better parsing in perl 5, |
699 | Function parsing, String interpolation of C<$#array> differs, Perl guesses | |
700 | on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref | |
c2e66d9e GS |
701 | |
702 | =item Numerical Traps | |
703 | ||
b2a9ae16 NC |
704 | Formatted output and significant digits, Auto-increment operator over |
705 | signed int limit deleted, Assignment of return values from numeric equality | |
706 | tests doesn't work, Bitwise string ops | |
c2e66d9e GS |
707 | |
708 | =item General data type traps | |
709 | ||
b2a9ae16 NC |
710 | Negative array subscripts now count from the end of array, Setting |
711 | C<$#array> lower now discards array elements, Hashes get defined before | |
712 | use, Glob assignment from localized variable to variable, Assigning | |
713 | C<undef> to glob, Changes in unary negation (of strings), Modifying of | |
714 | constants prohibited, C<defined $var> behavior changed, Variable Suicide | |
c2e66d9e GS |
715 | |
716 | =item Context Traps - scalar, list contexts | |
717 | ||
b2a9ae16 NC |
718 | Elements of argument lists for formats evaluated in list context, |
719 | C<caller()> returns false value in scalar context if no caller present, | |
720 | Comma operator in scalar context gives scalar context to args, C<sprintf()> | |
721 | prototyped as C<($;@)> | |
c2e66d9e GS |
722 | |
723 | =item Precedence Traps | |
724 | ||
b2a9ae16 NC |
725 | LHS vs. RHS of any assignment operator, Semantic errors introduced due to |
726 | precedence, Precedence of assignment operators same as the precedence of | |
727 | assignment, C<open> requires parentheses around filehandle, C<$:> | |
728 | precedence over C<$::> gone, Precedence of file test operators documented, | |
729 | C<keys>, C<each>, C<values> are regular named unary operators | |
c2e66d9e GS |
730 | |
731 | =item General Regular Expression Traps using s///, etc. | |
732 | ||
b2a9ae16 NC |
733 | C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to |
734 | the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set | |
735 | to whole match, Substitution now returns null string if it fails, | |
736 | C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables | |
737 | in regular expressions, C<m?x?> matches only once, Failed matches don't | |
738 | reset the match variables | |
c2e66d9e GS |
739 | |
740 | =item Subroutine, Signal, Sorting Traps | |
741 | ||
b2a9ae16 NC |
742 | Barewords that used to look like strings look like subroutine calls, |
743 | Reverse is no longer allowed as the name of a sort subroutine, C<warn()> | |
744 | won't let you specify a filehandle | |
c2e66d9e GS |
745 | |
746 | =item OS Traps | |
747 | ||
b2a9ae16 | 748 | SysV resets signal handler correctly, SysV C<seek()> appends correctly |
c2e66d9e GS |
749 | |
750 | =item Interpolation Traps | |
751 | ||
b2a9ae16 NC |
752 | C<@> always interpolates an array in double-quotish strings, Double-quoted |
753 | strings may no longer end with an unescaped $, Arbitrary expressions are | |
754 | evaluated inside braces within double quotes, C<$$x> now tries to | |
755 | dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires | |
756 | protection, Bugs in earlier perl versions, Array and hash brackets during | |
757 | interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to | |
758 | C<eval> will not find string terminator | |
c2e66d9e GS |
759 | |
760 | =item DBM Traps | |
761 | ||
b2a9ae16 NC |
762 | Perl5 must have been linked with same dbm/ndbm as the default for |
763 | C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to | |
764 | exit immediately | |
c2e66d9e GS |
765 | |
766 | =item Unclassified Traps | |
767 | ||
768 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
769 | LIMIT specified | |
68dc0745 | 770 | |
4755096e | 771 | =back |
68dc0745 | 772 | |
c2e66d9e | 773 | =back |
14218588 | 774 | |
50e34432 | 775 | =head2 perldebtut - Perl debugging tutorial |
7550e1ad JH |
776 | |
777 | =over 4 | |
778 | ||
779 | =item DESCRIPTION | |
780 | ||
50e34432 | 781 | =item use strict |
7550e1ad | 782 | |
50e34432 | 783 | =item Looking at data and -w and v |
7550e1ad | 784 | |
50e34432 | 785 | =item help |
7550e1ad | 786 | |
50e34432 | 787 | =item Stepping through code |
7550e1ad | 788 | |
50e34432 | 789 | =item Placeholder for a, w, t, T |
7550e1ad | 790 | |
50e34432 | 791 | =item REGULAR EXPRESSIONS |
7550e1ad | 792 | |
50e34432 | 793 | =item OUTPUT TIPS |
7550e1ad | 794 | |
50e34432 | 795 | =item CGI |
68dc0745 | 796 | |
50e34432 | 797 | =item GUIs |
c2e66d9e | 798 | |
50e34432 | 799 | =item SUMMARY |
c2e66d9e | 800 | |
50e34432 | 801 | =item SEE ALSO |
68dc0745 | 802 | |
50e34432 | 803 | =item AUTHOR |
68dc0745 | 804 | |
50e34432 | 805 | =item CONTRIBUTORS |
c2e66d9e | 806 | |
50e34432 | 807 | =back |
c2e66d9e | 808 | |
b40eed9c NC |
809 | =head2 perlfaq - frequently asked questions about Perl ($Date: 2005/12/30 |
810 | 15:04:07 $) | |
c2e66d9e | 811 | |
50e34432 | 812 | =over 4 |
c2e66d9e | 813 | |
50e34432 | 814 | =item DESCRIPTION |
68dc0745 | 815 | |
50e34432 | 816 | =over 4 |
68dc0745 | 817 | |
50e34432 | 818 | =item Where to get the perlfaq |
c2e66d9e | 819 | |
50e34432 JH |
820 | =item How to contribute to the perlfaq |
821 | ||
822 | =item What will happen if you mail your Perl programming problems to the | |
823 | authors | |
c2e66d9e | 824 | |
e993db8c JH |
825 | =back |
826 | ||
50e34432 JH |
827 | =item Credits |
828 | ||
829 | =item Author and Copyright Information | |
e993db8c JH |
830 | |
831 | =over 4 | |
c2e66d9e | 832 | |
50e34432 JH |
833 | =item Bundled Distributions |
834 | ||
835 | =item Disclaimer | |
ff426ff2 | 836 | |
4755096e | 837 | =back |
68dc0745 | 838 | |
50e34432 | 839 | =item Table of Contents |
68dc0745 | 840 | |
50e34432 JH |
841 | perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2 |
842 | - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4 | |
843 | - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular | |
844 | Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System | |
845 | Interaction, perlfaq9 - Networking | |
68dc0745 | 846 | |
50e34432 | 847 | =item The Questions |
68dc0745 | 848 | |
d420ca49 | 849 | =over 4 |
68dc0745 | 850 | |
50e34432 | 851 | =item L<perlfaq1>: General Questions About Perl |
68dc0745 | 852 | |
50e34432 | 853 | =item L<perlfaq2>: Obtaining and Learning about Perl |
a45bd81d | 854 | |
50e34432 | 855 | =item L<perlfaq3>: Programming Tools |
68dc0745 | 856 | |
50e34432 | 857 | =item L<perlfaq4>: Data Manipulation |
a45bd81d | 858 | |
50e34432 | 859 | =item L<perlfaq5>: Files and Formats |
68dc0745 | 860 | |
50e34432 | 861 | =item L<perlfaq6>: Regular Expressions |
68dc0745 | 862 | |
50e34432 | 863 | =item L<perlfaq7>: General Perl Language Issues |
68dc0745 | 864 | |
50e34432 | 865 | =item L<perlfaq8>: System Interaction |
68dc0745 | 866 | |
50e34432 | 867 | =item L<perlfaq9>: Networking |
68dc0745 | 868 | |
50e34432 | 869 | =back |
68dc0745 | 870 | |
4755096e | 871 | =back |
68dc0745 | 872 | |
b40eed9c NC |
873 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date: |
874 | 2005/12/31 00:54:37 $) | |
10862624 | 875 | |
d420ca49 | 876 | =over 4 |
10862624 RF |
877 | |
878 | =item DESCRIPTION | |
879 | ||
50e34432 | 880 | =over 4 |
10862624 | 881 | |
50e34432 | 882 | =item What is Perl? |
d396a558 | 883 | |
50e34432 | 884 | =item Who supports Perl? Who develops it? Why is it free? |
10862624 | 885 | |
50e34432 | 886 | =item Which version of Perl should I use? |
10862624 | 887 | |
b2a9ae16 | 888 | =item What are perl4, perl5, or perl6? |
10862624 | 889 | |
50e34432 | 890 | =item What is Ponie? |
10862624 | 891 | |
50e34432 | 892 | =item What is perl6? |
10862624 | 893 | |
50e34432 | 894 | =item How stable is Perl? |
10862624 | 895 | |
50e34432 | 896 | =item Is Perl difficult to learn? |
10862624 | 897 | |
50e34432 JH |
898 | =item How does Perl compare with other languages like Java, Python, REXX, |
899 | Scheme, or Tcl? | |
10862624 | 900 | |
50e34432 | 901 | =item Can I do [task] in Perl? |
10862624 | 902 | |
50e34432 | 903 | =item When shouldn't I program in Perl? |
10862624 | 904 | |
50e34432 | 905 | =item What's the difference between "perl" and "Perl"? |
10862624 | 906 | |
50e34432 | 907 | =item Is it a Perl program or a Perl script? |
10862624 | 908 | |
50e34432 | 909 | =item What is a JAPH? |
68dc0745 | 910 | |
50e34432 | 911 | =item Where can I get a list of Larry Wall witticisms? |
68dc0745 | 912 | |
50e34432 JH |
913 | =item How can I convince my sysadmin/supervisor/employees to use version |
914 | 5/5.6.1/Perl instead of some other language? | |
68dc0745 | 915 | |
50e34432 | 916 | =back |
68dc0745 | 917 | |
50e34432 | 918 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 919 | |
50e34432 | 920 | =back |
68dc0745 | 921 | |
b40eed9c NC |
922 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.38 $, |
923 | $Date: 2005/12/31 00:54:37 $) | |
68dc0745 | 924 | |
50e34432 | 925 | =over 4 |
68dc0745 | 926 | |
50e34432 | 927 | =item DESCRIPTION |
68dc0745 | 928 | |
50e34432 | 929 | =over 4 |
68dc0745 | 930 | |
e1114e52 | 931 | =item What machines support perl? Where do I get it? |
68dc0745 | 932 | |
e1114e52 | 933 | =item How can I get a binary version of perl? |
68dc0745 | 934 | |
e1114e52 | 935 | =item I don't have a C compiler. How can I build my own Perl interpreter? |
68dc0745 | 936 | |
e1114e52 | 937 | =item I copied the perl binary from one machine to another, but scripts |
50e34432 | 938 | don't work. |
68dc0745 | 939 | |
50e34432 JH |
940 | =item I grabbed the sources and tried to compile but gdbm/dynamic |
941 | loading/malloc/linking/... failed. How do I make it work? | |
68dc0745 | 942 | |
50e34432 JH |
943 | =item What modules and extensions are available for Perl? What is CPAN? |
944 | What does CPAN/src/... mean? | |
68dc0745 | 945 | |
50e34432 | 946 | =item Is there an ISO or ANSI certified version of Perl? |
68dc0745 | 947 | |
50e34432 | 948 | =item Where can I get information on Perl? |
14218588 | 949 | |
50e34432 | 950 | =item What are the Perl newsgroups on Usenet? Where do I post questions? |
68dc0745 | 951 | |
50e34432 | 952 | =item Where should I post source code? |
68dc0745 | 953 | |
50e34432 | 954 | =item Perl Books |
a45bd81d | 955 | |
50e34432 | 956 | References, Tutorials, Task-Oriented, Special Topics |
68dc0745 | 957 | |
50e34432 | 958 | =item Perl in Magazines |
a45bd81d | 959 | |
50e34432 | 960 | =item Perl on the Net: FTP and WWW Access |
68dc0745 | 961 | |
50e34432 | 962 | =item What mailing lists are there for Perl? |
68dc0745 | 963 | |
50e34432 | 964 | =item Archives of comp.lang.perl.misc |
68dc0745 | 965 | |
e1114e52 | 966 | =item Where can I buy a commercial version of perl? |
68dc0745 | 967 | |
50e34432 | 968 | =item Where do I send bug reports? |
68dc0745 | 969 | |
50e34432 | 970 | =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org? |
4755096e | 971 | |
c2e66d9e GS |
972 | =back |
973 | ||
50e34432 | 974 | =item AUTHOR AND COPYRIGHT |
4755096e GS |
975 | |
976 | =back | |
977 | ||
b40eed9c NC |
978 | =head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31 |
979 | 00:54:37 $) | |
4755096e | 980 | |
d420ca49 | 981 | =over 4 |
c2e66d9e GS |
982 | |
983 | =item DESCRIPTION | |
984 | ||
4d4e713d JH |
985 | =over 4 |
986 | ||
50e34432 | 987 | =item How do I do (anything)? |
4755096e | 988 | |
50e34432 | 989 | =item How can I use Perl interactively? |
4755096e | 990 | |
50e34432 | 991 | =item Is there a Perl shell? |
4755096e | 992 | |
50e34432 | 993 | =item How do I find which modules are installed on my system? |
4755096e | 994 | |
50e34432 | 995 | =item How do I debug my Perl programs? |
4755096e | 996 | |
50e34432 | 997 | =item How do I profile my Perl programs? |
c2e66d9e | 998 | |
50e34432 | 999 | =item How do I cross-reference my Perl programs? |
4755096e | 1000 | |
50e34432 | 1001 | =item Is there a pretty-printer (formatter) for Perl? |
4755096e | 1002 | |
50e34432 | 1003 | =item Is there a ctags for Perl? |
35c7d401 | 1004 | |
50e34432 | 1005 | =item Is there an IDE or Windows Perl Editor? |
4755096e | 1006 | |
e1114e52 NC |
1007 | Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, |
1008 | visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, | |
1009 | Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, | |
1010 | Alpha, BBEdit and BBEdit Lite | |
4755096e | 1011 | |
50e34432 | 1012 | =item Where can I get Perl macros for vi? |
4755096e | 1013 | |
50e34432 | 1014 | =item Where can I get perl-mode for emacs? |
4755096e | 1015 | |
50e34432 | 1016 | =item How can I use curses with Perl? |
4755096e | 1017 | |
50e34432 | 1018 | =item How can I use X or Tk with Perl? |
4755096e | 1019 | |
50e34432 | 1020 | =item How can I make my Perl program run faster? |
4755096e | 1021 | |
50e34432 | 1022 | =item How can I make my Perl program take less memory? |
4755096e | 1023 | |
50e34432 JH |
1024 | Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and |
1025 | stringification, Pass by reference, Tie large variables to disk | |
4755096e | 1026 | |
50e34432 | 1027 | =item Is it safe to return a reference to local or lexical data? |
4755096e | 1028 | |
50e34432 | 1029 | =item How can I free an array or hash so my program shrinks? |
4755096e | 1030 | |
50e34432 | 1031 | =item How can I make my CGI script more efficient? |
4755096e | 1032 | |
50e34432 | 1033 | =item How can I hide the source for my Perl program? |
4755096e | 1034 | |
50e34432 | 1035 | =item How can I compile my Perl program into byte code or C? |
4755096e | 1036 | |
50e34432 | 1037 | =item How can I compile Perl into Java? |
4755096e | 1038 | |
50e34432 | 1039 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? |
4755096e | 1040 | |
50e34432 | 1041 | =item Can I write useful Perl programs on the command line? |
4755096e | 1042 | |
50e34432 | 1043 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? |
4755096e | 1044 | |
50e34432 | 1045 | =item Where can I learn about CGI or Web programming in Perl? |
4755096e | 1046 | |
50e34432 | 1047 | =item Where can I learn about object-oriented Perl programming? |
35c7d401 | 1048 | |
e1114e52 | 1049 | =item Where can I learn about linking C with Perl? |
35c7d401 | 1050 | |
b2a9ae16 NC |
1051 | =item I've read perlembed, perlguts, etc., but I can't embed perl in my C |
1052 | program; what am I doing wrong? | |
4755096e | 1053 | |
50e34432 | 1054 | =item When I tried to run my script, I got this message. What does it mean? |
4755096e | 1055 | |
50e34432 | 1056 | =item What's MakeMaker? |
a9d2c496 | 1057 | |
4755096e GS |
1058 | =back |
1059 | ||
50e34432 | 1060 | =item AUTHOR AND COPYRIGHT |
4755096e GS |
1061 | |
1062 | =back | |
1063 | ||
b40eed9c NC |
1064 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31 |
1065 | 00:54:37 $) | |
34babc16 JH |
1066 | |
1067 | =over 4 | |
1068 | ||
1069 | =item DESCRIPTION | |
1070 | ||
50e34432 | 1071 | =item Data: Numbers |
34babc16 JH |
1072 | |
1073 | =over 4 | |
1074 | ||
50e34432 JH |
1075 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the |
1076 | numbers I should be getting (eg, 19.95)? | |
34babc16 | 1077 | |
6a5cae29 JH |
1078 | =item Why is int() broken? |
1079 | ||
50e34432 | 1080 | =item Why isn't my octal data interpreted correctly? |
34babc16 | 1081 | |
50e34432 JH |
1082 | =item Does Perl have a round() function? What about ceil() and floor()? |
1083 | Trig functions? | |
34babc16 | 1084 | |
ef7b71f0 | 1085 | =item How do I convert between numeric representations/bases/radixes? |
34babc16 | 1086 | |
50e34432 JH |
1087 | How do I convert hexadecimal into decimal, How do I convert from decimal to |
1088 | hexadecimal, How do I convert from octal to decimal, How do I convert from | |
1089 | decimal to octal, How do I convert from binary to decimal, How do I convert | |
1090 | from decimal to binary | |
34babc16 | 1091 | |
50e34432 | 1092 | =item Why doesn't & work the way I want it to? |
34babc16 | 1093 | |
50e34432 | 1094 | =item How do I multiply matrices? |
34babc16 | 1095 | |
50e34432 | 1096 | =item How do I perform an operation on a series of integers? |
34babc16 | 1097 | |
50e34432 | 1098 | =item How can I output Roman numerals? |
34babc16 | 1099 | |
50e34432 | 1100 | =item Why aren't my random numbers random? |
34babc16 | 1101 | |
50e34432 | 1102 | =item How do I get a random number between X and Y? |
493a87da | 1103 | |
34babc16 JH |
1104 | =back |
1105 | ||
50e34432 | 1106 | =item Data: Dates |
34babc16 JH |
1107 | |
1108 | =over 4 | |
1109 | ||
50e34432 | 1110 | =item How do I find the day or week of the year? |
34babc16 | 1111 | |
7ba761b0 JH |
1112 | =item How do I find the current century or millennium? |
1113 | ||
50e34432 | 1114 | =item How can I compare two dates and find the difference? |
34babc16 | 1115 | |
50e34432 JH |
1116 | =item How can I take a string and turn it into epoch seconds? |
1117 | ||
1118 | =item How can I find the Julian Day? | |
1119 | ||
1120 | =item How do I find yesterday's date? | |
1121 | ||
1122 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? | |
35c7d401 | 1123 | |
34babc16 JH |
1124 | =back |
1125 | ||
50e34432 | 1126 | =item Data: Strings |
34babc16 JH |
1127 | |
1128 | =over 4 | |
1129 | ||
50e34432 | 1130 | =item How do I validate input? |
34babc16 | 1131 | |
50e34432 | 1132 | =item How do I unescape a string? |
34babc16 | 1133 | |
50e34432 | 1134 | =item How do I remove consecutive pairs of characters? |
248e172a | 1135 | |
50e34432 | 1136 | =item How do I expand function calls in a string? |
34babc16 | 1137 | |
50e34432 | 1138 | =item How do I find matching/nesting anything? |
34babc16 | 1139 | |
50e34432 | 1140 | =item How do I reverse a string? |
34babc16 | 1141 | |
50e34432 | 1142 | =item How do I expand tabs in a string? |
493a87da | 1143 | |
50e34432 | 1144 | =item How do I reformat a paragraph? |
34babc16 | 1145 | |
50e34432 | 1146 | =item How can I access or change N characters of a string? |
34babc16 | 1147 | |
50e34432 | 1148 | =item How do I change the Nth occurrence of something? |
4755096e | 1149 | |
50e34432 JH |
1150 | =item How can I count the number of occurrences of a substring within a |
1151 | string? | |
4755096e | 1152 | |
50e34432 | 1153 | =item How do I capitalize all the words on one line? |
4755096e | 1154 | |
50e34432 JH |
1155 | =item How can I split a [character] delimited string except when inside |
1156 | [character]? | |
4755096e | 1157 | |
50e34432 | 1158 | =item How do I strip blank space from the beginning/end of a string? |
4755096e | 1159 | |
50e34432 | 1160 | =item How do I pad a string with blanks or pad a number with zeroes? |
4755096e | 1161 | |
50e34432 | 1162 | =item How do I extract selected columns from a string? |
4755096e | 1163 | |
50e34432 | 1164 | =item How do I find the soundex value of a string? |
4755096e | 1165 | |
50e34432 | 1166 | =item How can I expand variables in text strings? |
4755096e | 1167 | |
50e34432 | 1168 | =item What's wrong with always quoting "$vars"? |
4755096e | 1169 | |
50e34432 | 1170 | =item Why don't my E<lt>E<lt>HERE documents work? |
4755096e | 1171 | |
50e34432 JH |
1172 | There must be no space after the E<lt>E<lt> part, There (probably) should |
1173 | be a semicolon at the end, You can't (easily) have any space in front of | |
1174 | the tag | |
4755096e | 1175 | |
c2e66d9e | 1176 | =back |
4755096e | 1177 | |
50e34432 | 1178 | =item Data: Arrays |
4755096e | 1179 | |
d420ca49 | 1180 | =over 4 |
4755096e | 1181 | |
50e34432 | 1182 | =item What is the difference between a list and an array? |
4755096e | 1183 | |
50e34432 | 1184 | =item What is the difference between $array[1] and @array[1]? |
4755096e | 1185 | |
50e34432 | 1186 | =item How can I remove duplicate elements from a list or array? |
4755096e | 1187 | |
50e34432 JH |
1188 | =item How can I tell whether a certain element is contained in a list or |
1189 | array? | |
4755096e | 1190 | |
50e34432 JH |
1191 | =item How do I compute the difference of two arrays? How do I compute the |
1192 | intersection of two arrays? | |
4755096e | 1193 | |
50e34432 | 1194 | =item How do I test whether two arrays or hashes are equal? |
4755096e | 1195 | |
50e34432 | 1196 | =item How do I find the first array element for which a condition is true? |
4755096e | 1197 | |
50e34432 | 1198 | =item How do I handle linked lists? |
4755096e | 1199 | |
50e34432 | 1200 | =item How do I handle circular lists? |
4755096e | 1201 | |
50e34432 | 1202 | =item How do I shuffle an array randomly? |
4755096e | 1203 | |
50e34432 | 1204 | =item How do I process/modify each element of an array? |
4755096e | 1205 | |
50e34432 | 1206 | =item How do I select a random element from an array? |
4755096e | 1207 | |
50e34432 | 1208 | =item How do I permute N elements of a list? |
4755096e | 1209 | |
50e34432 | 1210 | =item How do I sort an array by (anything)? |
4755096e | 1211 | |
50e34432 JH |
1212 | =item How do I manipulate arrays of bits? |
1213 | ||
1214 | =item Why does defined() return true on empty arrays and hashes? | |
4755096e | 1215 | |
4755096e GS |
1216 | =back |
1217 | ||
50e34432 | 1218 | =item Data: Hashes (Associative Arrays) |
4755096e | 1219 | |
d420ca49 | 1220 | =over 4 |
4755096e | 1221 | |
50e34432 | 1222 | =item How do I process an entire hash? |
4755096e | 1223 | |
50e34432 JH |
1224 | =item What happens if I add or remove keys from a hash while iterating over |
1225 | it? | |
4755096e | 1226 | |
50e34432 | 1227 | =item How do I look up a hash element by value? |
4755096e | 1228 | |
50e34432 | 1229 | =item How can I know how many entries are in a hash? |
4755096e | 1230 | |
50e34432 | 1231 | =item How do I sort a hash (optionally by value instead of key)? |
4755096e | 1232 | |
50e34432 | 1233 | =item How can I always keep my hash sorted? |
4755096e | 1234 | |
50e34432 | 1235 | =item What's the difference between "delete" and "undef" with hashes? |
4755096e | 1236 | |
50e34432 | 1237 | =item Why don't my tied hashes make the defined/exists distinction? |
4755096e | 1238 | |
50e34432 | 1239 | =item How do I reset an each() operation part-way through? |
4755096e | 1240 | |
50e34432 | 1241 | =item How can I get the unique keys from two hashes? |
4755096e | 1242 | |
50e34432 | 1243 | =item How can I store a multidimensional array in a DBM file? |
c2e66d9e | 1244 | |
50e34432 | 1245 | =item How can I make my hash remember the order I put elements into it? |
c2e66d9e | 1246 | |
50e34432 JH |
1247 | =item Why does passing a subroutine an undefined element in a hash create |
1248 | it? | |
c2e66d9e | 1249 | |
50e34432 JH |
1250 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or |
1251 | array of hashes or arrays? | |
1252 | ||
1253 | =item How can I use a reference as a hash key? | |
4755096e GS |
1254 | |
1255 | =back | |
1256 | ||
50e34432 | 1257 | =item Data: Misc |
4755096e | 1258 | |
50e34432 JH |
1259 | =over 4 |
1260 | ||
1261 | =item How do I handle binary data correctly? | |
1262 | ||
1263 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
1264 | ||
1265 | =item How do I keep persistent data across program calls? | |
1266 | ||
1267 | =item How do I print out or copy a recursive data structure? | |
1268 | ||
1269 | =item How do I define methods for every class/object? | |
1270 | ||
1271 | =item How do I verify a credit card checksum? | |
1272 | ||
1273 | =item How do I pack arrays of doubles or floats for XS code? | |
4755096e | 1274 | |
c2e66d9e GS |
1275 | =back |
1276 | ||
50e34432 | 1277 | =item AUTHOR AND COPYRIGHT |
bb25ec9b | 1278 | |
50e34432 | 1279 | =back |
bb25ec9b | 1280 | |
b40eed9c NC |
1281 | =head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31 |
1282 | 00:54:37 $) | |
bb25ec9b | 1283 | |
7550e1ad JH |
1284 | =over 4 |
1285 | ||
50e34432 | 1286 | =item DESCRIPTION |
bb25ec9b | 1287 | |
50e34432 | 1288 | =over 4 |
bb25ec9b | 1289 | |
50e34432 | 1290 | =item How do I flush/unbuffer an output filehandle? Why must I do this? |
b40eed9c | 1291 | X<flush> X<buffer> X<unbuffer> X<autoflush> |
bb25ec9b | 1292 | |
50e34432 JH |
1293 | =item How do I change one line in a file/delete a line in a file/insert a |
1294 | line in the middle of a file/append to the beginning of a file? | |
b40eed9c | 1295 | X<file, editing> |
bb25ec9b | 1296 | |
50e34432 | 1297 | =item How do I count the number of lines in a file? |
b40eed9c | 1298 | X<file, counting lines> X<lines> X<line> |
bb25ec9b | 1299 | |
50e34432 | 1300 | =item How can I use Perl's C<-i> option from within a program? |
b40eed9c | 1301 | X<-i> X<in-place> |
bb25ec9b | 1302 | |
b2a9ae16 | 1303 | =item How can I copy a file? |
b40eed9c | 1304 | X<copy> X<file, copy> |
b2a9ae16 | 1305 | |
50e34432 | 1306 | =item How do I make a temporary file name? |
b40eed9c | 1307 | X<file, temporary> |
bb25ec9b | 1308 | |
50e34432 | 1309 | =item How can I manipulate fixed-record-length files? |
b40eed9c | 1310 | X<fixed-length> X<file, fixed-length records> |
bb25ec9b | 1311 | |
50e34432 JH |
1312 | =item How can I make a filehandle local to a subroutine? How do I pass |
1313 | filehandles between subroutines? How do I make an array of filehandles? | |
b40eed9c | 1314 | X<filehandle, local> X<filehandle, passing> X<filehandle, reference> |
7550e1ad | 1315 | |
50e34432 | 1316 | =item How can I use a filehandle indirectly? |
b40eed9c | 1317 | X<filehandle, indirect> |
7550e1ad | 1318 | |
50e34432 | 1319 | =item How can I set up a footer format to be used with write()? |
b40eed9c | 1320 | X<footer> |
bb25ec9b | 1321 | |
50e34432 | 1322 | =item How can I write() into a string? |
b40eed9c | 1323 | X<write, into a string> |
bb25ec9b | 1324 | |
50e34432 | 1325 | =item How can I output my numbers with commas added? |
b40eed9c | 1326 | X<number, commify> |
bb25ec9b | 1327 | |
50e34432 | 1328 | =item How can I translate tildes (~) in a filename? |
b40eed9c | 1329 | X<tilde> X<tilde expansion> |
bb25ec9b | 1330 | |
50e34432 | 1331 | =item How come when I open a file read-write it wipes it out? |
b40eed9c | 1332 | X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating> |
d396a558 | 1333 | |
50e34432 JH |
1334 | =item Why do I sometimes get an "Argument list too long" when I use |
1335 | E<lt>*E<gt>? | |
b40eed9c | 1336 | X<argument list too long> |
d396a558 | 1337 | |
50e34432 | 1338 | =item Is there a leak/bug in glob()? |
b40eed9c | 1339 | X<glob> |
d396a558 | 1340 | |
50e34432 | 1341 | =item How can I open a file with a leading ">" or trailing blanks? |
b40eed9c | 1342 | X<filename, special characters> |
d396a558 | 1343 | |
50e34432 | 1344 | =item How can I reliably rename a file? |
b40eed9c | 1345 | X<rename> X<mv> X<move> X<file, rename> X<ren> |
d396a558 | 1346 | |
50e34432 | 1347 | =item How can I lock a file? |
b40eed9c | 1348 | X<lock> X<file, lock> X<flock> |
d396a558 | 1349 | |
50e34432 | 1350 | =item Why can't I just open(FH, "E<gt>file.lock")? |
b40eed9c | 1351 | X<lock, lockfile race condition> |
d396a558 | 1352 | |
50e34432 JH |
1353 | =item I still don't get locking. I just want to increment the number in |
1354 | the file. How can I do this? | |
b40eed9c | 1355 | X<counter> X<file, counter> |
d396a558 | 1356 | |
50e34432 JH |
1357 | =item All I want to do is append a small amount of text to the end of a |
1358 | file. Do I still have to use locking? | |
b40eed9c | 1359 | X<append> X<file, append> |
d396a558 | 1360 | |
50e34432 | 1361 | =item How do I randomly update a binary file? |
b40eed9c | 1362 | X<file, binary patch> |
d396a558 | 1363 | |
50e34432 | 1364 | =item How do I get a file's timestamp in perl? |
b40eed9c | 1365 | X<timestamp> X<file, timestamp> |
d396a558 | 1366 | |
50e34432 | 1367 | =item How do I set a file's timestamp in perl? |
b40eed9c | 1368 | X<timestamp> X<file, timestamp> |
d396a558 | 1369 | |
50e34432 | 1370 | =item How do I print to more than one file at once? |
b40eed9c | 1371 | X<print, to multiple files> |
d396a558 | 1372 | |
50e34432 | 1373 | =item How can I read in an entire file all at once? |
b40eed9c | 1374 | X<slurp> X<file, slurping> |
d396a558 | 1375 | |
50e34432 | 1376 | =item How can I read in a file by paragraphs? |
b40eed9c | 1377 | X<file, reading by paragraphs> |
d396a558 | 1378 | |
50e34432 | 1379 | =item How can I read a single character from a file? From the keyboard? |
b40eed9c | 1380 | X<getc> X<file, reading one character at a time> |
4755096e | 1381 | |
50e34432 | 1382 | =item How can I tell whether there's a character waiting on a filehandle? |
4755096e | 1383 | |
50e34432 | 1384 | =item How do I do a C<tail -f> in perl? |
b40eed9c | 1385 | X<tail> |
4755096e | 1386 | |
50e34432 | 1387 | =item How do I dup() a filehandle in Perl? |
b40eed9c | 1388 | X<dup> |
4755096e | 1389 | |
50e34432 | 1390 | =item How do I close a file descriptor by number? |
b40eed9c | 1391 | X<file, closing file descriptors> |
4755096e | 1392 | |
50e34432 JH |
1393 | =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't |
1394 | `C:\temp\foo.exe` work? | |
b40eed9c | 1395 | X<filename, DOS issues> |
4755096e | 1396 | |
50e34432 | 1397 | =item Why doesn't glob("*.*") get all the files? |
b40eed9c | 1398 | X<glob> |
4755096e | 1399 | |
50e34432 JH |
1400 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber |
1401 | protected files? Isn't this a bug in Perl? | |
c2e66d9e | 1402 | |
50e34432 | 1403 | =item How do I select a random line from a file? |
b40eed9c | 1404 | X<file, selecting a random line> |
c2e66d9e | 1405 | |
50e34432 | 1406 | =item Why do I get weird spaces when I print an array of lines? |
4755096e GS |
1407 | |
1408 | =back | |
1409 | ||
50e34432 | 1410 | =item AUTHOR AND COPYRIGHT |
4755096e GS |
1411 | |
1412 | =back | |
1413 | ||
b40eed9c NC |
1414 | =head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31 |
1415 | 00:54:37 $) | |
4755096e | 1416 | |
d420ca49 | 1417 | =over 4 |
4755096e GS |
1418 | |
1419 | =item DESCRIPTION | |
1420 | ||
d420ca49 | 1421 | =over 4 |
c2e66d9e | 1422 | |
50e34432 JH |
1423 | =item How can I hope to use regular expressions without creating illegible |
1424 | and unmaintainable code? | |
b40eed9c NC |
1425 | X<regex, legibility> X<regexp, legibility> |
1426 | X<regular expression, legibility> X</x> | |
d396a558 | 1427 | |
50e34432 | 1428 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters |
d396a558 | 1429 | |
50e34432 | 1430 | =item I'm having trouble matching over more than one line. What's wrong? |
b40eed9c | 1431 | X<regex, multiline> X<regexp, multiline> X<regular expression, multiline> |
d396a558 | 1432 | |
50e34432 JH |
1433 | =item How can I pull out lines between two patterns that are themselves on |
1434 | different lines? | |
b40eed9c | 1435 | X<..> |
d396a558 | 1436 | |
50e34432 | 1437 | =item I put a regular expression into $/ but it didn't work. What's wrong? |
b40eed9c NC |
1438 | X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in> |
1439 | X<$RS, regexes in> | |
d396a558 | 1440 | |
50e34432 JH |
1441 | =item How do I substitute case insensitively on the LHS while preserving |
1442 | case on the RHS? | |
b40eed9c NC |
1443 | X<replace, case preserving> X<substitute, case preserving> |
1444 | X<substitution, case preserving> X<s, case preserving> | |
d396a558 | 1445 | |
50e34432 | 1446 | =item How can I make C<\w> match national character sets? |
b40eed9c | 1447 | X<\w> |
d396a558 | 1448 | |
50e34432 | 1449 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? |
b40eed9c | 1450 | X<alpha> |
d396a558 | 1451 | |
50e34432 | 1452 | =item How can I quote a variable to use in a regex? |
b40eed9c | 1453 | X<regex, escaping> X<regexp, escaping> X<regular expression, escaping> |
d396a558 | 1454 | |
50e34432 | 1455 | =item What is C</o> really for? |
b40eed9c | 1456 | X</o> |
d396a558 | 1457 | |
50e34432 JH |
1458 | =item How do I use a regular expression to strip C style comments from a |
1459 | file? | |
d396a558 | 1460 | |
50e34432 | 1461 | =item Can I use Perl regular expressions to match balanced text? |
b40eed9c NC |
1462 | X<regex, matching balanced test> X<regexp, matching balanced test> |
1463 | X<regular expression, matching balanced test> | |
d396a558 | 1464 | |
50e34432 | 1465 | =item What does it mean that regexes are greedy? How can I get around it? |
b40eed9c | 1466 | X<greedy> X<greediness> |
d396a558 | 1467 | |
50e34432 | 1468 | =item How do I process each word on each line? |
b40eed9c | 1469 | X<word> |
d396a558 | 1470 | |
50e34432 | 1471 | =item How can I print out a word-frequency or line-frequency summary? |
d396a558 | 1472 | |
50e34432 | 1473 | =item How can I do approximate matching? |
b40eed9c | 1474 | X<match, approximate> X<matching, approximate> |
d396a558 | 1475 | |
50e34432 | 1476 | =item How do I efficiently match many regular expressions at once? |
b40eed9c NC |
1477 | X<regex, efficiency> X<regexp, efficiency> |
1478 | X<regular expression, efficiency> | |
d396a558 | 1479 | |
50e34432 | 1480 | =item Why don't word-boundary searches with C<\b> work for me? |
b40eed9c | 1481 | X<\b> |
d396a558 | 1482 | |
50e34432 | 1483 | =item Why does using $&, $`, or $' slow my program down? |
b40eed9c | 1484 | X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`> |
d396a558 | 1485 | |
e1114e52 | 1486 | =item What good is C<\G> in a regular expression? |
b40eed9c | 1487 | X<\G> |
e1114e52 | 1488 | |
50e34432 | 1489 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? |
b40eed9c | 1490 | X<DFA> X<NFA> X<POSIX> |
d396a558 | 1491 | |
cd458e05 | 1492 | =item What's wrong with using grep in a void context? |
b40eed9c | 1493 | X<grep> |
d396a558 | 1494 | |
50e34432 | 1495 | =item How can I match strings with multibyte characters? |
b40eed9c NC |
1496 | X<regex, and multibyte characters> X<regexp, and multibyte characters> |
1497 | X<regular expression, and multibyte characters> | |
d396a558 | 1498 | |
50e34432 | 1499 | =item How do I match a pattern that is supplied by the user? |
d396a558 JH |
1500 | |
1501 | =back | |
1502 | ||
50e34432 JH |
1503 | =item AUTHOR AND COPYRIGHT |
1504 | ||
1505 | =back | |
1506 | ||
b40eed9c NC |
1507 | =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date: |
1508 | 2005/12/31 00:54:37 $) | |
c2e66d9e | 1509 | |
d420ca49 | 1510 | =over 4 |
4755096e | 1511 | |
d396a558 | 1512 | =item DESCRIPTION |
4755096e | 1513 | |
d420ca49 | 1514 | =over 4 |
4755096e | 1515 | |
50e34432 | 1516 | =item Can I get a BNF/yacc/RE for the Perl language? |
4755096e | 1517 | |
50e34432 JH |
1518 | =item What are all these $@%&* punctuation signs, and how do I know when to |
1519 | use them? | |
4755096e | 1520 | |
50e34432 JH |
1521 | =item Do I always/never have to quote my strings or use semicolons and |
1522 | commas? | |
c2e66d9e | 1523 | |
50e34432 | 1524 | =item How do I skip some return values? |
c2e66d9e | 1525 | |
50e34432 | 1526 | =item How do I temporarily block warnings? |
c2e66d9e | 1527 | |
50e34432 | 1528 | =item What's an extension? |
4755096e | 1529 | |
50e34432 | 1530 | =item Why do Perl operators have different precedence than C operators? |
4755096e | 1531 | |
50e34432 | 1532 | =item How do I declare/create a structure? |
4755096e | 1533 | |
50e34432 | 1534 | =item How do I create a module? |
4755096e | 1535 | |
50e34432 | 1536 | =item How do I create a class? |
4755096e | 1537 | |
50e34432 | 1538 | =item How can I tell if a variable is tainted? |
4755096e | 1539 | |
50e34432 | 1540 | =item What's a closure? |
4755096e | 1541 | |
50e34432 | 1542 | =item What is variable suicide and how can I prevent it? |
4755096e | 1543 | |
50e34432 JH |
1544 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
1545 | Regex}? | |
4755096e | 1546 | |
50e34432 JH |
1547 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
1548 | Passing Methods | |
d396a558 | 1549 | |
50e34432 | 1550 | =item How do I create a static variable? |
d396a558 | 1551 | |
50e34432 JH |
1552 | =item What's the difference between dynamic and lexical (static) scoping? |
1553 | Between local() and my()? | |
d396a558 | 1554 | |
50e34432 JH |
1555 | =item How can I access a dynamic variable while a similarly named lexical |
1556 | is in scope? | |
d396a558 | 1557 | |
50e34432 | 1558 | =item What's the difference between deep and shallow binding? |
d396a558 | 1559 | |
50e34432 | 1560 | =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right? |
4755096e | 1561 | |
50e34432 | 1562 | =item How do I redefine a builtin function, operator, or method? |
4755096e | 1563 | |
50e34432 | 1564 | =item What's the difference between calling a function as &foo and foo()? |
4755096e | 1565 | |
50e34432 | 1566 | =item How do I create a switch or case statement? |
4755096e | 1567 | |
50e34432 JH |
1568 | =item How can I catch accesses to undefined variables, functions, or |
1569 | methods? | |
4755096e | 1570 | |
50e34432 | 1571 | =item Why can't a method included in this same file be found? |
d396a558 | 1572 | |
50e34432 | 1573 | =item How can I find out my current package? |
d396a558 | 1574 | |
50e34432 | 1575 | =item How can I comment out a large block of perl code? |
d396a558 | 1576 | |
50e34432 | 1577 | =item How do I clear a package? |
d396a558 | 1578 | |
50e34432 | 1579 | =item How can I use a variable as a variable name? |
d396a558 | 1580 | |
50e34432 | 1581 | =item What does "bad interpreter" mean? |
d396a558 JH |
1582 | |
1583 | =back | |
1584 | ||
50e34432 JH |
1585 | =item AUTHOR AND COPYRIGHT |
1586 | ||
1587 | =back | |
1588 | ||
b40eed9c NC |
1589 | =head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31 |
1590 | 00:54:37 $) | |
d396a558 | 1591 | |
d420ca49 | 1592 | =over 4 |
d396a558 | 1593 | |
50e34432 | 1594 | =item DESCRIPTION |
d396a558 | 1595 | |
50e34432 | 1596 | =over 4 |
4755096e | 1597 | |
50e34432 | 1598 | =item How do I find out which operating system I'm running under? |
d420ca49 | 1599 | |
50e34432 | 1600 | =item How come exec() doesn't return? |
4755096e | 1601 | |
50e34432 | 1602 | =item How do I do fancy stuff with the keyboard/screen/mouse? |
d420ca49 | 1603 | |
50e34432 | 1604 | Keyboard, Screen, Mouse |
d396a558 | 1605 | |
50e34432 | 1606 | =item How do I print something out in color? |
d396a558 | 1607 | |
50e34432 | 1608 | =item How do I read just one key without waiting for a return key? |
d396a558 | 1609 | |
50e34432 | 1610 | =item How do I check whether input is ready on the keyboard? |
d396a558 | 1611 | |
50e34432 | 1612 | =item How do I clear the screen? |
d396a558 | 1613 | |
50e34432 | 1614 | =item How do I get the screen size? |
c2e66d9e | 1615 | |
50e34432 | 1616 | =item How do I ask the user for a password? |
c2e66d9e | 1617 | |
50e34432 | 1618 | =item How do I read and write the serial port? |
c2e66d9e | 1619 | |
50e34432 | 1620 | lockfiles, open mode, end of line, flushing output, non-blocking input |
c2e66d9e | 1621 | |
50e34432 | 1622 | =item How do I decode encrypted password files? |
c2e66d9e | 1623 | |
50e34432 | 1624 | =item How do I start a process in the background? |
c2e66d9e | 1625 | |
50e34432 | 1626 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
c2e66d9e | 1627 | |
50e34432 | 1628 | =item How do I trap control characters/signals? |
dc5c060f | 1629 | |
50e34432 | 1630 | =item How do I modify the shadow password file on a Unix system? |
d396a558 | 1631 | |
50e34432 | 1632 | =item How do I set the time and date? |
d396a558 | 1633 | |
50e34432 | 1634 | =item How can I sleep() or alarm() for under a second? |
d396a558 | 1635 | |
50e34432 | 1636 | =item How can I measure time under a second? |
d396a558 | 1637 | |
50e34432 | 1638 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) |
d396a558 | 1639 | |
50e34432 JH |
1640 | =item Why doesn't my sockets program work under System V (Solaris)? What |
1641 | does the error message "Protocol not supported" mean? | |
d396a558 | 1642 | |
50e34432 | 1643 | =item How can I call my system's unique C functions from Perl? |
d396a558 | 1644 | |
50e34432 | 1645 | =item Where do I get the include files to do ioctl() or syscall()? |
4755096e | 1646 | |
50e34432 | 1647 | =item Why do setuid perl scripts complain about kernel problems? |
4755096e | 1648 | |
50e34432 | 1649 | =item How can I open a pipe both to and from a command? |
4755096e | 1650 | |
50e34432 | 1651 | =item Why can't I get the output of a command with system()? |
4755096e | 1652 | |
50e34432 | 1653 | =item How can I capture STDERR from an external command? |
d396a558 | 1654 | |
50e34432 | 1655 | =item Why doesn't open() return an error when a pipe open fails? |
d396a558 | 1656 | |
50e34432 | 1657 | =item What's wrong with using backticks in a void context? |
d396a558 | 1658 | |
50e34432 | 1659 | =item How can I call backticks without shell processing? |
d396a558 | 1660 | |
50e34432 JH |
1661 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, |
1662 | ^Z on MS-DOS)? | |
4755096e | 1663 | |
50e34432 | 1664 | =item How can I convert my shell script to perl? |
4755096e | 1665 | |
50e34432 | 1666 | =item Can I use perl to run a telnet or ftp session? |
d396a558 | 1667 | |
50e34432 | 1668 | =item How can I write expect in Perl? |
4755096e | 1669 | |
50e34432 JH |
1670 | =item Is there a way to hide perl's command line from programs such as |
1671 | "ps"? | |
d396a558 | 1672 | |
50e34432 JH |
1673 | =item I {changed directory, modified my environment} in a perl script. How |
1674 | come the change disappeared when I exited the script? How do I get my | |
1675 | changes to be visible? | |
d396a558 | 1676 | |
50e34432 | 1677 | Unix |
4755096e | 1678 | |
50e34432 JH |
1679 | =item How do I close a process's filehandle without waiting for it to |
1680 | complete? | |
4755096e | 1681 | |
50e34432 | 1682 | =item How do I fork a daemon process? |
4755096e | 1683 | |
50e34432 | 1684 | =item How do I find out if I'm running interactively or not? |
4755096e | 1685 | |
50e34432 | 1686 | =item How do I timeout a slow event? |
4755096e | 1687 | |
50e34432 | 1688 | =item How do I set CPU limits? |
4755096e | 1689 | |
50e34432 | 1690 | =item How do I avoid zombies on a Unix system? |
4755096e | 1691 | |
50e34432 | 1692 | =item How do I use an SQL database? |
4755096e | 1693 | |
50e34432 | 1694 | =item How do I make a system() exit on control-C? |
4755096e | 1695 | |
50e34432 | 1696 | =item How do I open a file without blocking? |
4755096e | 1697 | |
55d31d93 NC |
1698 | =item How do I tell the difference between errors from the shell and perl? |
1699 | ||
50e34432 | 1700 | =item How do I install a module from CPAN? |
d396a558 | 1701 | |
50e34432 | 1702 | =item What's the difference between require and use? |
d396a558 | 1703 | |
50e34432 | 1704 | =item How do I keep my own module/library directory? |
d396a558 | 1705 | |
50e34432 JH |
1706 | =item How do I add the directory my program lives in to the module/library |
1707 | search path? | |
d396a558 | 1708 | |
ef7b71f0 | 1709 | =item How do I add a directory to my include path (@INC) at runtime? |
d396a558 | 1710 | |
50e34432 | 1711 | =item What is socket.ph and where do I get it? |
4755096e | 1712 | |
c2e66d9e | 1713 | =back |
4755096e | 1714 | |
50e34432 | 1715 | =item AUTHOR AND COPYRIGHT |
d396a558 JH |
1716 | |
1717 | =back | |
1718 | ||
b40eed9c | 1719 | =head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37 |
50e34432 | 1720 | $) |
d396a558 | 1721 | |
d420ca49 | 1722 | =over 4 |
d396a558 JH |
1723 | |
1724 | =item DESCRIPTION | |
1725 | ||
50e34432 | 1726 | =over 4 |
d396a558 | 1727 | |
50e34432 | 1728 | =item What is the correct form of response from a CGI script? |
d396a558 | 1729 | |
50e34432 JH |
1730 | =item My CGI script runs from the command line but not the browser. (500 |
1731 | Server Error) | |
d396a558 | 1732 | |
50e34432 | 1733 | =item How can I get better error messages from a CGI program? |
d396a558 | 1734 | |
50e34432 | 1735 | =item How do I remove HTML from a string? |
d396a558 | 1736 | |
50e34432 | 1737 | =item How do I extract URLs? |
d396a558 | 1738 | |
50e34432 JH |
1739 | =item How do I download a file from the user's machine? How do I open a |
1740 | file on another machine? | |
d396a558 | 1741 | |
50e34432 | 1742 | =item How do I make a pop-up menu in HTML? |
d396a558 | 1743 | |
50e34432 | 1744 | =item How do I fetch an HTML file? |
d396a558 | 1745 | |
50e34432 | 1746 | =item How do I automate an HTML form submission? |
d396a558 | 1747 | |
50e34432 | 1748 | =item How do I decode or create those %-encodings on the web? |
d396a558 | 1749 | |
50e34432 | 1750 | =item How do I redirect to another page? |
35c7d401 | 1751 | |
50e34432 | 1752 | =item How do I put a password on my web pages? |
d396a558 | 1753 | |
50e34432 | 1754 | =item How do I edit my .htpasswd and .htgroup files with Perl? |
d396a558 | 1755 | |
50e34432 JH |
1756 | =item How do I make sure users can't enter values into a form that cause my |
1757 | CGI script to do bad things? | |
d396a558 | 1758 | |
50e34432 | 1759 | =item How do I parse a mail header? |
d396a558 | 1760 | |
50e34432 | 1761 | =item How do I decode a CGI form? |
d396a558 | 1762 | |
50e34432 | 1763 | =item How do I check a valid mail address? |
d396a558 | 1764 | |
50e34432 | 1765 | =item How do I decode a MIME/BASE64 string? |
d396a558 | 1766 | |
50e34432 | 1767 | =item How do I return the user's mail address? |
d396a558 | 1768 | |
50e34432 | 1769 | =item How do I send mail? |
d396a558 | 1770 | |
50e34432 | 1771 | =item How do I use MIME to make an attachment to a mail message? |
d396a558 | 1772 | |
50e34432 | 1773 | =item How do I read mail? |
d396a558 | 1774 | |
b40eed9c NC |
1775 | =item How do I find out my hostname, domainname, or IP address? |
1776 | X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa, | |
1777 | gethostbyname, Socket, Net::Domain, Sys::Hostname> | |
d396a558 | 1778 | |
50e34432 | 1779 | =item How do I fetch a news article or the active newsgroups? |
d396a558 | 1780 | |
50e34432 | 1781 | =item How do I fetch/put an FTP file? |
9fa7f388 | 1782 | |
50e34432 | 1783 | =item How can I do RPC in Perl? |
d396a558 JH |
1784 | |
1785 | =back | |
4755096e | 1786 | |
50e34432 | 1787 | =item AUTHOR AND COPYRIGHT |
d396a558 | 1788 | |
c2e66d9e | 1789 | =back |
4755096e | 1790 | |
50e34432 | 1791 | =head2 perlsyn - Perl syntax |
4755096e | 1792 | |
d420ca49 | 1793 | =over 4 |
4755096e | 1794 | |
c2e66d9e | 1795 | =item DESCRIPTION |
4755096e | 1796 | |
a6812a52 JH |
1797 | =over 4 |
1798 | ||
50e34432 | 1799 | =item Declarations |
b40eed9c | 1800 | X<declaration> X<undef> X<undefined> X<uninitialized> |
23be5fc4 | 1801 | |
50e34432 | 1802 | =item Comments |
b40eed9c | 1803 | X<comment> X<#> |
4755096e | 1804 | |
50e34432 | 1805 | =item Simple Statements |
b40eed9c | 1806 | X<statement> X<semicolon> X<expression> X<;> |
4755096e | 1807 | |
91e033c7 | 1808 | =item Truth and Falsehood |
b40eed9c | 1809 | X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0> |
91e033c7 NC |
1810 | |
1811 | =item Statement Modifiers | |
b40eed9c NC |
1812 | X<statement modifier> X<modifier> X<if> X<unless> X<while> |
1813 | X<until> X<foreach> X<for> | |
91e033c7 | 1814 | |
50e34432 | 1815 | =item Compound Statements |
b40eed9c NC |
1816 | X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace> |
1817 | X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue> | |
4755096e | 1818 | |
50e34432 | 1819 | =item Loop Control |
b40eed9c | 1820 | X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue> |
4755096e | 1821 | |
50e34432 | 1822 | =item For Loops |
b40eed9c | 1823 | X<for> X<foreach> |
4755096e | 1824 | |
50e34432 | 1825 | =item Foreach Loops |
b40eed9c | 1826 | X<for> X<foreach> |
4755096e | 1827 | |
50e34432 | 1828 | =item Basic BLOCKs and Switch Statements |
b40eed9c | 1829 | X<switch> X<block> X<case> |
4755096e | 1830 | |
50e34432 | 1831 | =item Goto |
b40eed9c | 1832 | X<goto> |
4755096e | 1833 | |
50e34432 | 1834 | =item PODs: Embedded Documentation |
b40eed9c | 1835 | X<POD> X<documentation> |
4755096e | 1836 | |
50e34432 | 1837 | =item Plain Old Comments (Not!) |
b40eed9c | 1838 | X<comment> X<line> X<#> X<preprocessor> X<eval> |
4755096e GS |
1839 | |
1840 | =back | |
1841 | ||
c2e66d9e GS |
1842 | =back |
1843 | ||
50e34432 | 1844 | =head2 perldata - Perl data types |
4755096e | 1845 | |
d420ca49 | 1846 | =over 4 |
4755096e | 1847 | |
50e34432 | 1848 | =item DESCRIPTION |
4755096e | 1849 | |
50e34432 | 1850 | =over 4 |
4755096e | 1851 | |
50e34432 | 1852 | =item Variable names |
b40eed9c | 1853 | X<variable, name> X<variable name> X<data type> X<type> |
4755096e | 1854 | |
50e34432 | 1855 | =item Context |
b40eed9c | 1856 | X<context> X<scalar context> X<list context> |
4755096e | 1857 | |
50e34432 | 1858 | =item Scalar values |
b40eed9c | 1859 | X<scalar> X<number> X<string> X<reference> |
4755096e | 1860 | |
50e34432 | 1861 | =item Scalar value constructors |
b40eed9c | 1862 | X<scalar, literal> X<scalar, constant> |
4755096e | 1863 | |
50e34432 | 1864 | =item List value constructors |
b40eed9c | 1865 | X<list> |
4755096e | 1866 | |
50e34432 | 1867 | =item Subscripts |
4755096e | 1868 | |
50e34432 | 1869 | =item Slices |
b40eed9c | 1870 | X<slice> X<array, slice> X<hash, slice> |
4755096e | 1871 | |
50e34432 | 1872 | =item Typeglobs and Filehandles |
b40eed9c | 1873 | X<typeglob> X<filehandle> X<*> |
4755096e | 1874 | |
50e34432 | 1875 | =back |
4755096e | 1876 | |
c2e66d9e | 1877 | =item SEE ALSO |
4755096e GS |
1878 | |
1879 | =back | |
1880 | ||
50e34432 | 1881 | =head2 perlop - Perl operators and precedence |
4755096e | 1882 | |
d420ca49 | 1883 | =over 4 |
4755096e | 1884 | |
c2e66d9e | 1885 | =item DESCRIPTION |
4755096e | 1886 | |
d420ca49 | 1887 | =over 4 |
4755096e | 1888 | |
b40eed9c NC |
1889 | =item Operator Precedence and Associativity |
1890 | X<operator, precedence> X<precedence> X<associativity> | |
91e033c7 | 1891 | |
50e34432 | 1892 | =item Terms and List Operators (Leftward) |
b40eed9c | 1893 | X<list operator> X<operator, list> X<term> |
4755096e | 1894 | |
50e34432 | 1895 | =item The Arrow Operator |
b40eed9c | 1896 | X<arrow> X<dereference> X<< -> >> |
4755096e | 1897 | |
50e34432 | 1898 | =item Auto-increment and Auto-decrement |
b40eed9c | 1899 | X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<--> |
4755096e | 1900 | |
50e34432 | 1901 | =item Exponentiation |
b40eed9c | 1902 | X<**> X<exponentiation> X<power> |
c2e66d9e | 1903 | |
50e34432 | 1904 | =item Symbolic Unary Operators |
b40eed9c | 1905 | X<unary operator> X<operator, unary> |
c2e66d9e | 1906 | |
50e34432 | 1907 | =item Binding Operators |
b40eed9c | 1908 | X<binding> X<operator, binding> X<=~> X<!~> |
4755096e | 1909 | |
50e34432 | 1910 | =item Multiplicative Operators |
b40eed9c | 1911 | X<operator, multiplicative> |
4755096e | 1912 | |
50e34432 | 1913 | =item Additive Operators |
b40eed9c | 1914 | X<operator, additive> |
4755096e | 1915 | |
50e34432 | 1916 | =item Shift Operators |
b40eed9c NC |
1917 | X<shift operator> X<operator, shift> X<<< << >>> |
1918 | X<<< >> >>> X<right shift> X<left shift> X<bitwise shift> | |
1919 | X<shl> X<shr> X<shift, right> X<shift, left> | |
4755096e | 1920 | |
50e34432 | 1921 | =item Named Unary Operators |
b40eed9c | 1922 | X<operator, named unary> |
4755096e | 1923 | |
50e34432 | 1924 | =item Relational Operators |
b40eed9c | 1925 | X<relational operator> X<operator, relational> |
4755096e | 1926 | |
50e34432 | 1927 | =item Equality Operators |
b40eed9c | 1928 | X<equality> X<equal> X<equals> X<operator, equality> |
4755096e | 1929 | |
50e34432 | 1930 | =item Bitwise And |
b40eed9c | 1931 | X<operator, bitwise, and> X<bitwise and> X<&> |
4755096e | 1932 | |
50e34432 | 1933 | =item Bitwise Or and Exclusive Or |
b40eed9c NC |
1934 | X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor> |
1935 | X<bitwise xor> X<^> | |
4755096e | 1936 | |
50e34432 | 1937 | =item C-style Logical And |
b40eed9c | 1938 | X<&&> X<logical and> X<operator, logical, and> |
4755096e | 1939 | |
50e34432 | 1940 | =item C-style Logical Or |
b40eed9c | 1941 | X<||> X<operator, logical, or> |
4755096e | 1942 | |
50e34432 | 1943 | =item Range Operators |
b40eed9c | 1944 | X<operator, range> X<range> X<..> X<...> |
4755096e | 1945 | |
50e34432 | 1946 | =item Conditional Operator |
b40eed9c | 1947 | X<operator, conditional> X<operator, ternary> X<ternary> X<?:> |
4755096e | 1948 | |
50e34432 | 1949 | =item Assignment Operators |
b40eed9c NC |
1950 | X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=> |
1951 | X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<.=> | |
1952 | X<%=> X<^=> X<x=> | |
4755096e | 1953 | |
50e34432 | 1954 | =item Comma Operator |
b40eed9c | 1955 | X<comma> X<operator, comma> X<,> |
4755096e | 1956 | |
50e34432 | 1957 | =item List Operators (Rightward) |
b40eed9c | 1958 | X<operator, list, rightward> X<list operator> |
4755096e | 1959 | |
50e34432 | 1960 | =item Logical Not |
b40eed9c | 1961 | X<operator, logical, not> X<not> |
c133c03f | 1962 | |
50e34432 | 1963 | =item Logical And |
b40eed9c | 1964 | X<operator, logical, and> X<and> |
849d92fd | 1965 | |
50e34432 | 1966 | =item Logical or and Exclusive Or |
b40eed9c NC |
1967 | X<operator, logical, or> X<operator, logical, xor> X<operator, logical, |
1968 | err> | |
1969 | X<operator, logical, defined or> X<operator, logical, exclusive or> | |
1970 | X<or> X<xor> X<err> | |
849d92fd | 1971 | |
50e34432 | 1972 | =item C Operators Missing From Perl |
b40eed9c NC |
1973 | X<operator, missing from perl> X<&> X<*> |
1974 | X<typecasting> X<(TYPE)> | |
849d92fd | 1975 | |
50e34432 | 1976 | unary &, unary *, (TYPE) |
849d92fd | 1977 | |
50e34432 | 1978 | =item Quote and Quote-like Operators |
b40eed9c NC |
1979 | X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> |
1980 | X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>> | |
1981 | X<escape sequence> X<escape> | |
849d92fd | 1982 | |
50e34432 | 1983 | =item Regexp Quote-Like Operators |
b40eed9c NC |
1984 | X<operator, regexp> |
1985 | ||
1986 | ?PATTERN? X<?>, m/PATTERN/cgimosx X<m> X<operator, match> X<regexp, | |
1987 | options> X<regexp> X<regex, options> X<regex> X</c> X</i> X</m> X</o> | |
1988 | X</s> X</x>, /PATTERN/cgimosx, q/STRING/ X<q> X<quote, double> X<'> X<''>, | |
1989 | C<'STRING'>, qq/STRING/ X<qq> X<quote, double> X<"> X<"">, "STRING", | |
1990 | qr/STRING/imosx X<qr> X</i> X</m> X</o> X</s> X</x>, qx/STRING/ X<qx> X<`> | |
1991 | X<``> X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote, | |
1992 | words>, s/PATTERN/REPLACEMENT/egimosx X<substitute> X<substitution> | |
1993 | X<replace> X<regexp, replace> X<regexp, substitute> X</e> X</g> X</i> X</m> | |
1994 | X</o> X</s> X</x>, tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y> | |
1995 | X<transliterate> X</c> X</d> X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF | |
1996 | X<here-doc> X<heredoc> X<here-document> X<<< << >>> | |
849d92fd | 1997 | |
50e34432 | 1998 | =item Gory details of parsing quoted constructs |
b40eed9c | 1999 | X<quote, gory details> |
849d92fd | 2000 | |
b40eed9c NC |
2001 | Finding the end, Removal of backslashes before delimiters, Interpolation |
2002 | X<interpolation>, C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, | |
2003 | C<q//>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, | |
2004 | C</RE/>, C<m/RE/>, C<s/RE/foo/>,, Interpolation of regular expressions | |
2005 | X<regexp, interpolation>, Optimization of regular expressions X<regexp, | |
2006 | optimization> | |
849d92fd | 2007 | |
50e34432 | 2008 | =item I/O Operators |
b40eed9c NC |
2009 | X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle> |
2010 | X<< <> >> X<@ARGV> | |
849d92fd | 2011 | |
50e34432 | 2012 | =item Constant Folding |
b40eed9c | 2013 | X<constant folding> X<folding> |
849d92fd | 2014 | |
a2db77eb | 2015 | =item No-ops |
b40eed9c | 2016 | X<no-op> X<nop> |
a2db77eb | 2017 | |
50e34432 | 2018 | =item Bitwise String Operators |
b40eed9c | 2019 | X<operator, bitwise, string> |
849d92fd | 2020 | |
50e34432 | 2021 | =item Integer Arithmetic |
b40eed9c | 2022 | X<integer> |
97f7c9df | 2023 | |
50e34432 | 2024 | =item Floating-point Arithmetic |
b40eed9c | 2025 | X<floating-point> X<floating point> X<float> X<real> |
849d92fd | 2026 | |
50e34432 | 2027 | =item Bigger Numbers |
b40eed9c | 2028 | X<number, arbitrary precision> |
849d92fd | 2029 | |
50e34432 | 2030 | =back |
849d92fd JH |
2031 | |
2032 | =back | |
2033 | ||
50e34432 | 2034 | =head2 perlsub - Perl subroutines |
849d92fd JH |
2035 | |
2036 | =over 4 | |
2037 | ||
50e34432 | 2038 | =item SYNOPSIS |
849d92fd | 2039 | |
50e34432 | 2040 | =item DESCRIPTION |
849d92fd | 2041 | |
c133c03f | 2042 | =over 4 |
849d92fd | 2043 | |
50e34432 | 2044 | =item Private Variables via my() |
b40eed9c NC |
2045 | X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical> |
2046 | X<lexical scope> X<attributes, my> | |
849d92fd | 2047 | |
50e34432 | 2048 | =item Persistent Private Variables |
b40eed9c | 2049 | X<static> X<variable, persistent> X<variable, static> X<closure> |
849d92fd | 2050 | |
50e34432 | 2051 | =item Temporary Values via local() |
b40eed9c NC |
2052 | X<local> X<scope, dynamic> X<dynamic scope> X<variable, local> |
2053 | X<variable, temporary> | |
c133c03f | 2054 | |
50e34432 | 2055 | =item Lvalue subroutines |
b40eed9c | 2056 | X<lvalue> X<subroutine, lvalue> |
c133c03f | 2057 | |
50e34432 | 2058 | Lvalue subroutines are EXPERIMENTAL |
849d92fd | 2059 | |
50e34432 | 2060 | =item Passing Symbol Table Entries (typeglobs) |
b40eed9c | 2061 | X<typeglob> X<*> |
bb25ec9b | 2062 | |
50e34432 | 2063 | =item When to Still Use local() |
b40eed9c | 2064 | X<local> X<variable, local> |
849d92fd | 2065 | |
50e34432 | 2066 | =item Pass by Reference |
b40eed9c | 2067 | X<pass by reference> X<pass-by-reference> X<reference> |
849d92fd | 2068 | |
50e34432 | 2069 | =item Prototypes |
b40eed9c | 2070 | X<prototype> X<subroutine, prototype> |
849d92fd | 2071 | |
50e34432 | 2072 | =item Constant Functions |
b40eed9c | 2073 | X<constant> |
849d92fd | 2074 | |
50e34432 | 2075 | =item Overriding Built-in Functions |
b40eed9c | 2076 | X<built-in> X<override> X<CORE> X<CORE::GLOBAL> |
849d92fd | 2077 | |
50e34432 | 2078 | =item Autoloading |
b40eed9c | 2079 | X<autoloading> X<AUTOLOAD> |
849d92fd | 2080 | |
50e34432 | 2081 | =item Subroutine Attributes |
b40eed9c | 2082 | X<attribute> X<subroutine, attribute> X<attrs> |
849d92fd JH |
2083 | |
2084 | =back | |
2085 | ||
50e34432 | 2086 | =item SEE ALSO |
c133c03f | 2087 | |
50e34432 | 2088 | =back |
a44e0ddd | 2089 | |
50e34432 | 2090 | =head2 perlfunc - Perl builtin functions |
23be5fc4 | 2091 | |
50e34432 | 2092 | =over 4 |
849d92fd | 2093 | |
50e34432 | 2094 | =item DESCRIPTION |
849d92fd JH |
2095 | |
2096 | =over 4 | |
2097 | ||
50e34432 | 2098 | =item Perl Functions by Category |
b40eed9c NC |
2099 | X<function> |
2100 | ||
2101 | Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular | |
2102 | expressions and pattern matching X<regular expression> X<regex> X<regexp>, | |
2103 | Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>, | |
2104 | Functions for real @ARRAYs X<array>, Functions for list data X<list>, | |
2105 | Functions for real %HASHes X<hash>, Input and output functions X<I/O> | |
2106 | X<input> X<output> X<dbm>, Functions for fixed length data or records, | |
2107 | Functions for filehandles, files, or directories X<file> X<filehandle> | |
2108 | X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control | |
2109 | flow of your Perl program X<control flow>, Keywords related to scoping, | |
2110 | Miscellaneous functions, Functions for processes and process groups | |
2111 | X<process> X<pid> X<process id>, Keywords related to perl modules | |
2112 | X<module>, Keywords related to classes and object-orientedness X<object> | |
2113 | X<class> X<package>, Low-level socket functions X<socket> X<sock>, System V | |
2114 | interprocess communication functions X<IPC> X<System V> X<semaphore> | |
2115 | X<shared memory> X<memory> X<message>, Fetching user and group info X<user> | |
2116 | X<group> X<password> X<uid> X<gid> X<passwd> X</etc/passwd>, Fetching | |
2117 | network info X<network> X<protocol> X<host> X<hostname> X<IP> X<address> | |
2118 | X<service>, Time-related functions X<time> X<date>, Functions new in perl5 | |
2119 | X<perl5>, Functions obsoleted in perl5 | |
849d92fd | 2120 | |
50e34432 | 2121 | =item Portability |
b40eed9c | 2122 | X<portability> X<Unix> X<portable> |
849d92fd | 2123 | |
50e34432 | 2124 | =item Alphabetical Listing of Perl Functions |
849d92fd | 2125 | |
b40eed9c NC |
2126 | -I<X> FILEHANDLE |
2127 | X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p> | |
2128 | X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I<X> EXPR, | |
2129 | -I<X>, abs VALUE X<abs> X<absolute>, abs, accept NEWSOCKET,GENERICSOCKET | |
2130 | X<accept>, alarm SECONDS X<alarm> X<SIGALRM> X<timer>, alarm, atan2 Y,X | |
2131 | X<atan2> X<arctangent> X<tan> X<tangent>, bind SOCKET,NAME X<bind>, binmode | |
2132 | FILEHANDLE, LAYER X<binmode> X<binary> X<text> X<DOS> X<Windows>, binmode | |
2133 | FILEHANDLE, bless REF,CLASSNAME X<bless>, bless REF, caller EXPR X<caller> | |
2134 | X<call stack> X<stack> X<stack trace>, caller, chdir EXPR X<chdir> X<cd>, | |
2135 | chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> | |
2136 | X<mode>, chomp VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> | |
2137 | X<eol>, chomp( LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, | |
2138 | chown LIST X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> | |
2139 | X<character> X<ASCII> X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, | |
2140 | chroot, close FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, | |
2141 | connect SOCKET,NAME X<connect>, continue BLOCK X<continue>, cos EXPR X<cos> | |
2142 | X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt> | |
2143 | X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt> | |
2144 | X<cryptography> X<passwd>, dbmclose HASH X<dbmclose>, dbmopen | |
2145 | HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR | |
2146 | X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST | |
2147 | X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do> | |
2148 | X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump> | |
2149 | X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof | |
2150 | FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR | |
2151 | X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>, eval BLOCK, eval, | |
2152 | exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists EXPR X<exists> | |
2153 | X<autovivification>, exit EXPR X<exit> X<terminate> X<abort>, exit, exp | |
2154 | EXPR X<exp> X<exponential> X<antilog> X<antilogarithm> X<e>, exp, fcntl | |
2155 | FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE X<fileno>, flock | |
2156 | FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork X<fork> X<child> | |
2157 | X<parent>, format X<format>, formline PICTURE,LIST X<formline>, getc | |
2158 | FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin> X<login>, | |
2159 | getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>, | |
2160 | getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority> | |
2161 | X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname> | |
2162 | X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname> | |
2163 | X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport> | |
2164 | X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent> | |
2165 | X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent> | |
2166 | X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent> | |
2167 | X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME, gethostbyname | |
2168 | NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, | |
2169 | getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr | |
2170 | ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, | |
2171 | getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, | |
2172 | setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, | |
2173 | setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, | |
2174 | endprotoent, endservent, getsockname SOCKET X<getsockname>, getsockopt | |
2175 | SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard> | |
2176 | X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC> | |
2177 | X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto | |
2178 | &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex> | |
2179 | X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION | |
2180 | X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer> | |
2181 | X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join | |
2182 | EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill> | |
2183 | X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>, | |
2184 | lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length> | |
2185 | X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE | |
2186 | X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime, | |
2187 | lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log, | |
2188 | lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST, | |
2189 | mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME, | |
2190 | msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv | |
2191 | ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR | |
2192 | X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL | |
2193 | X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION, | |
2194 | no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal> | |
2195 | X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open> | |
2196 | X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open | |
2197 | FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR | |
2198 | X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>, | |
2199 | our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST | |
2200 | X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe | |
2201 | READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR | |
2202 | X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST, | |
2203 | print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST, | |
2204 | prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>, | |
2205 | q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR | |
2206 | X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>, | |
2207 | rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read | |
2208 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR | |
2209 | X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe | |
2210 | EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL | |
2211 | X<redo>, redo, ref EXPR X<ref> X<reference>, ref, rename OLDNAME,NEWNAME | |
2212 | X<rename> X<move> X<mv> X<ren>, require VERSION X<require>, require EXPR, | |
2213 | require, reset EXPR X<reset>, reset, return EXPR X<return>, return, reverse | |
2214 | LIST X<reverse> X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex | |
2215 | STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir> | |
2216 | X<rd> X<directory, remove>, rmdir, s///, scalar EXPR X<scalar> X<context>, | |
2217 | seek FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>, | |
2218 | seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle, | |
2219 | default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl | |
2220 | ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop | |
2221 | KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send | |
2222 | SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority | |
2223 | WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt | |
2224 | SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift, | |
2225 | shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread | |
2226 | ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE, | |
2227 | shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin> | |
2228 | X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket | |
2229 | SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair | |
2230 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST | |
2231 | X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST, | |
2232 | splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH, | |
2233 | splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>, | |
2234 | split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST | |
2235 | X<sprintf>, format parameter index, flags, vector flag, (minimum) width, | |
2236 | precision, or maximum width X<precision>, size, order of arguments, sqrt | |
2237 | EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed> | |
2238 | X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR, | |
2239 | stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO) | |
2240 | BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr | |
2241 | EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left> | |
2242 | X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink | |
2243 | OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>, | |
2244 | syscall NUMBER, LIST X<syscall> X<system call>, sysopen | |
2245 | FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen | |
2246 | FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET | |
2247 | X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
2248 | FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system> | |
2249 | X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET | |
2250 | X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, | |
2251 | tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie | |
2252 | VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time> | |
2253 | X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>, | |
2254 | truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst | |
2255 | EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef | |
2256 | EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove> | |
2257 | X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, untie VARIABLE X<untie>, | |
2258 | unshift ARRAY,LIST X<unshift>, use Module VERSION LIST X<use> X<module> | |
2259 | X<import>, use Module VERSION, use Module LIST, use Module, use VERSION, | |
2260 | utime LIST X<utime>, values HASH X<values>, vec EXPR,OFFSET,BITS X<vec> | |
2261 | X<bit> X<bit vector>, wait X<wait>, waitpid PID,FLAGS X<waitpid>, wantarray | |
2262 | X<wantarray> X<context>, warn LIST X<warn> X<warning> X<STDERR>, write | |
2263 | FILEHANDLE X<write>, write EXPR, write, y/// | |
849d92fd | 2264 | |
50e34432 | 2265 | =back |
849d92fd | 2266 | |
53d7eaa8 JH |
2267 | =back |
2268 | ||
50e34432 | 2269 | =head2 perlopentut - tutorial on opening things in Perl |
53d7eaa8 JH |
2270 | |
2271 | =over 4 | |
2272 | ||
2273 | =item DESCRIPTION | |
2274 | ||
50e34432 | 2275 | =item Open E<agrave> la shell |
4755096e | 2276 | |
d420ca49 | 2277 | =over 4 |
4755096e | 2278 | |
50e34432 | 2279 | =item Simple Opens |
4755096e | 2280 | |
50e34432 | 2281 | =item Indirect Filehandles |
4755096e | 2282 | |
50e34432 | 2283 | =item Pipe Opens |
4755096e | 2284 | |
50e34432 | 2285 | =item The Minus File |
4755096e | 2286 | |
50e34432 | 2287 | =item Mixing Reads and Writes |
4755096e | 2288 | |
50e34432 | 2289 | =item Filters |
4755096e | 2290 | |
50e34432 | 2291 | =back |
4755096e | 2292 | |
50e34432 | 2293 | =item Open E<agrave> la C |
4755096e | 2294 | |
d420ca49 | 2295 | =over 4 |
4755096e | 2296 | |
50e34432 | 2297 | =item Permissions E<agrave> la mode |
4755096e GS |
2298 | |
2299 | =back | |
2300 | ||
50e34432 | 2301 | =item Obscure Open Tricks |
4755096e | 2302 | |
d420ca49 | 2303 | =over 4 |
4755096e | 2304 | |
50e34432 | 2305 | =item Re-Opening Files (dups) |
4755096e | 2306 | |
50e34432 | 2307 | =item Dispelling the Dweomer |
4755096e | 2308 | |
50e34432 | 2309 | =item Paths as Opens |
4755096e | 2310 | |
50e34432 | 2311 | =item Single Argument Open |
4755096e | 2312 | |
50e34432 | 2313 | =item Playing with STDIN and STDOUT |
4755096e | 2314 | |
c2e66d9e | 2315 | =back |
4755096e | 2316 | |
50e34432 | 2317 | =item Other I/O Issues |
4755096e | 2318 | |
d420ca49 | 2319 | =over 4 |
4755096e | 2320 | |
50e34432 | 2321 | =item Opening Non-File Files |
4755096e | 2322 | |
50e34432 | 2323 | =item Opening Named Pipes |
4755096e | 2324 | |
50e34432 | 2325 | =item Opening Sockets |
4755096e | 2326 | |
50e34432 | 2327 | =item Binary Files |
4755096e | 2328 | |
50e34432 | 2329 | =item File Locking |
4755096e | 2330 | |
50e34432 | 2331 | =item IO Layers |
4755096e GS |
2332 | |
2333 | =back | |
2334 | ||
50e34432 | 2335 | =item SEE ALSO |
4755096e | 2336 | |
50e34432 | 2337 | =item AUTHOR and COPYRIGHT |
4755096e | 2338 | |
50e34432 | 2339 | =item HISTORY |
4755096e | 2340 | |
c2e66d9e | 2341 | =back |
4755096e | 2342 | |
50e34432 | 2343 | =head2 perlpacktut - tutorial on C<pack> and C<unpack> |
4755096e | 2344 | |
50e34432 | 2345 | =over 4 |
4755096e | 2346 | |
50e34432 | 2347 | =item DESCRIPTION |
4755096e | 2348 | |
50e34432 | 2349 | =item The Basic Principle |
4755096e | 2350 | |
50e34432 | 2351 | =item Packing Text |
4755096e | 2352 | |
50e34432 | 2353 | =item Packing Numbers |
4755096e | 2354 | |
50e34432 | 2355 | =over 4 |
4755096e | 2356 | |
50e34432 | 2357 | =item Integers |
4755096e | 2358 | |
50e34432 | 2359 | =item Unpacking a Stack Frame |
4755096e | 2360 | |
50e34432 | 2361 | =item How to Eat an Egg on a Net |
4755096e | 2362 | |
50e34432 | 2363 | =item Floating point Numbers |
4755096e | 2364 | |
c2e66d9e | 2365 | =back |
4755096e | 2366 | |
50e34432 | 2367 | =item Exotic Templates |
4755096e | 2368 | |
d420ca49 | 2369 | =over 4 |
4755096e | 2370 | |
50e34432 | 2371 | =item Bit Strings |
4755096e | 2372 | |
50e34432 | 2373 | =item Uuencoding |
4755096e | 2374 | |
50e34432 | 2375 | =item Doing Sums |
4755096e | 2376 | |
50e34432 | 2377 | =item Unicode |
4755096e | 2378 | |
50e34432 | 2379 | =item Another Portable Binary Encoding |
4755096e | 2380 | |
50e34432 | 2381 | =back |
4755096e | 2382 | |
50e34432 | 2383 | =item Template Grouping |
4755096e | 2384 | |
50e34432 | 2385 | =item Lengths and Widths |
4755096e | 2386 | |
50e34432 | 2387 | =over 4 |
a6812a52 | 2388 | |
50e34432 | 2389 | =item String Lengths |
6e76d345 | 2390 | |
50e34432 | 2391 | =item Dynamic Templates |
4755096e | 2392 | |
50e34432 | 2393 | =item Counting Repetitions |
4755096e | 2394 | |
50e34432 | 2395 | =back |
4755096e | 2396 | |
50e34432 | 2397 | =item Packing and Unpacking C Structures |
4755096e | 2398 | |
50e34432 | 2399 | =over 4 |
4755096e | 2400 | |
50e34432 | 2401 | =item The Alignment Pit |
4755096e | 2402 | |
50e34432 | 2403 | =item Alignment, Take 2 |
4755096e | 2404 | |
50e34432 | 2405 | =item Alignment, Take 3 |
4755096e | 2406 | |
50e34432 | 2407 | =item Pointers for How to Use Them |
4755096e GS |
2408 | |
2409 | =back | |
2410 | ||
50e34432 | 2411 | =item Pack Recipes |
4755096e | 2412 | |
50e34432 | 2413 | =item Funnies Section |
4755096e | 2414 | |
50e34432 | 2415 | =item Authors |
4755096e | 2416 | |
50e34432 | 2417 | =back |
4755096e | 2418 | |
50e34432 | 2419 | =head2 perlpod - the Plain Old Documentation format |
4755096e | 2420 | |
50e34432 | 2421 | =over 4 |
4755096e | 2422 | |
50e34432 | 2423 | =item DESCRIPTION |
4755096e | 2424 | |
50e34432 | 2425 | =over 4 |
4755096e | 2426 | |
50e34432 | 2427 | =item Ordinary Paragraph |
b40eed9c | 2428 | X<POD, ordinary paragraph> |
4755096e | 2429 | |
50e34432 | 2430 | =item Verbatim Paragraph |
b40eed9c | 2431 | X<POD, verbatim paragraph> X<verbatim> |
4755096e | 2432 | |
50e34432 | 2433 | =item Command Paragraph |
b40eed9c | 2434 | X<POD, command> |
4755096e | 2435 | |
b40eed9c NC |
2436 | C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1> |
2437 | X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading | |
2438 | Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over> | |
2439 | X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>, | |
2440 | C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>> | |
2441 | X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>, | |
2442 | C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding> | |
2443 | X<encoding> | |
4755096e | 2444 | |
50e34432 | 2445 | =item Formatting Codes |
b40eed9c NC |
2446 | X<POD, formatting code> X<formatting code> |
2447 | X<POD, interior sequence> X<interior sequence> | |
2448 | ||
2449 | C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting | |
2450 | code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >> | |
2451 | X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C> | |
2452 | X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> -- | |
2453 | a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink> | |
2454 | X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >> | |
2455 | X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used | |
2456 | for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename> | |
2457 | X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S> | |
2458 | X<< SZ<><> >> X<POD, formatting code, non-breaking space> X<non-breaking | |
2459 | space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >> | |
2460 | X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a | |
2461 | null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting | |
2462 | code, null> X<null> | |
4755096e | 2463 | |
50e34432 | 2464 | =item The Intent |
b40eed9c | 2465 | X<POD, intent of> |
4755096e | 2466 | |
50e34432 | 2467 | =item Embedding Pods in Perl Modules |
b40eed9c | 2468 | X<POD, embedding> |
c2e66d9e | 2469 | |
50e34432 | 2470 | =item Hints for Writing Pod |
4755096e | 2471 | |
b40eed9c NC |
2472 | X<podchecker> X<POD, validating> |
2473 | ||
d396a558 | 2474 | =back |
4755096e | 2475 | |
d396a558 | 2476 | =item SEE ALSO |
4755096e | 2477 | |
50e34432 | 2478 | =item AUTHOR |
4755096e | 2479 | |
4755096e GS |
2480 | =back |
2481 | ||
50e34432 JH |
2482 | =head2 perlpodspec - Plain Old Documentation: format specification and |
2483 | notes | |
4755096e | 2484 | |
d420ca49 | 2485 | =over 4 |
4755096e | 2486 | |
d396a558 | 2487 | =item DESCRIPTION |
4755096e | 2488 | |
50e34432 | 2489 | =item Pod Definitions |
4755096e | 2490 | |
50e34432 | 2491 | =item Pod Commands |
4755096e | 2492 | |
50e34432 | 2493 | "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item", |
cd458e05 JH |
2494 | "=back", "=begin formatname", "=end formatname", "=for formatname text...", |
2495 | "=encoding encodingname" | |
4755096e | 2496 | |
50e34432 | 2497 | =item Pod Formatting Codes |
4755096e | 2498 | |
50e34432 JH |
2499 | C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text, |
2500 | C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for | |
2501 | filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a | |
2502 | null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink, | |
2503 | C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text | |
2504 | contains non-breaking spaces | |
4755096e | 2505 | |
50e34432 | 2506 | =item Notes on Implementing Pod Processors |
4755096e | 2507 | |
50e34432 | 2508 | =item About LE<lt>...E<gt> Codes |
4755096e | 2509 | |
50e34432 | 2510 | First:, Second:, Third:, Fourth:, Fifth:, Sixth: |
4755096e | 2511 | |
50e34432 | 2512 | =item About =over...=back Regions |
4755096e | 2513 | |
50e34432 | 2514 | =item About Data Paragraphs and "=begin/=end" Regions |
4755096e | 2515 | |
50e34432 | 2516 | =item SEE ALSO |
4755096e | 2517 | |
50e34432 | 2518 | =item AUTHOR |
d0363f02 | 2519 | |
4755096e GS |
2520 | =back |
2521 | ||
50e34432 | 2522 | =head2 perlrun - how to execute the Perl interpreter |
4755096e | 2523 | |
d420ca49 | 2524 | =over 4 |
4755096e | 2525 | |
50e34432 | 2526 | =item SYNOPSIS |
4755096e | 2527 | |
50e34432 | 2528 | =item DESCRIPTION |
4755096e | 2529 | |
d420ca49 | 2530 | =over 4 |
4755096e | 2531 | |
50e34432 | 2532 | =item #! and quoting on non-Unix systems |
b40eed9c | 2533 | X<hashbang> X<#!> |
4755096e | 2534 | |
50e34432 | 2535 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS |
4755096e | 2536 | |
50e34432 | 2537 | =item Location of Perl |
b40eed9c | 2538 | X<perl, location of interpreter> |
4755096e | 2539 | |
50e34432 | 2540 | =item Command Switches |
b40eed9c | 2541 | X<perl, command switches> X<command switches> |
4755096e | 2542 | |
b40eed9c NC |
2543 | B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C |
2544 | [I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>, | |
2545 | B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>, | |
2546 | B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e> | |
2547 | I<commandline> X<-e>, B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, | |
2548 | B<-i>[I<extension>] X<-i> X<in-place>, B<-I>I<directory> X<-I> X<@INC>, | |
2549 | B<-l>[I<octnum>] X<-l> X<$/> X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, | |
2550 | B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
2551 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n> X<-n>, B<-p> X<-p>, B<-P> | |
2552 | X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>, B<-T> X<-T>, B<-u> X<-u>, | |
2553 | B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>, B<-V:>I<configvar>, B<-w> X<-w>, | |
2554 | B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>, B<-x> I<directory> | |
4755096e GS |
2555 | |
2556 | =back | |
2557 | ||
50e34432 | 2558 | =item ENVIRONMENT |
b40eed9c | 2559 | X<perl, environment variables> |
4755096e | 2560 | |
b40eed9c NC |
2561 | HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>, |
2562 | PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>, | |
2563 | :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio | |
2564 | X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG | |
2565 | X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED | |
2566 | X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>, | |
2567 | PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port) | |
2568 | X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>, | |
2569 | PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY | |
2570 | X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED | |
2571 | X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT | |
2572 | (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>, | |
2573 | PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port) | |
2574 | X<SYS$LOGIN> | |
4755096e GS |
2575 | |
2576 | =back | |
2577 | ||
50e34432 | 2578 | =head2 perldiag - various Perl diagnostics |
4755096e | 2579 | |
50e34432 JH |
2580 | =over 4 |
2581 | ||
2582 | =item DESCRIPTION | |
4755096e GS |
2583 | |
2584 | =back | |
2585 | ||
50e34432 | 2586 | =head2 perllexwarn - Perl Lexical Warnings |
ba62762e JH |
2587 | |
2588 | =over 4 | |
2589 | ||
2590 | =item DESCRIPTION | |
2591 | ||
2592 | =over 4 | |
2593 | ||
50e34432 | 2594 | =item Default Warnings and Optional Warnings |
ba62762e | 2595 | |
50e34432 | 2596 | =item What's wrong with B<-w> and C<$^W> |
3ecb3787 | 2597 | |
50e34432 | 2598 | =item Controlling Warnings from the Command Line |
ba62762e | 2599 | |
b40eed9c | 2600 | B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X> |
ba62762e | 2601 | |
50e34432 | 2602 | =item Backward Compatibility |
ba62762e | 2603 | |
50e34432 | 2604 | =item Category Hierarchy |
b40eed9c | 2605 | X<warning, categories> |
ba62762e | 2606 | |
50e34432 | 2607 | =item Fatal Warnings |
b40eed9c | 2608 | X<warning, fatal> |
ba62762e | 2609 | |
50e34432 | 2610 | =item Reporting Warnings from a Module |
b40eed9c | 2611 | X<warning, reporting> X<warning, registering> |
ba62762e JH |
2612 | |
2613 | =back | |
2614 | ||
50e34432 | 2615 | =item TODO |
34babc16 | 2616 | |
ba62762e JH |
2617 | =item SEE ALSO |
2618 | ||
50e34432 | 2619 | =item AUTHOR |
ba62762e JH |
2620 | |
2621 | =back | |
2622 | ||
50e34432 | 2623 | =head2 perldebug - Perl debugging |
4755096e | 2624 | |
d420ca49 | 2625 | =over 4 |
4755096e GS |
2626 | |
2627 | =item DESCRIPTION | |
2628 | ||
50e34432 JH |
2629 | =item The Perl Debugger |
2630 | ||
d420ca49 | 2631 | =over 4 |
4755096e | 2632 | |
50e34432 | 2633 | =item Debugger Commands |
4755096e | 2634 | |
b40eed9c NC |
2635 | h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>, |
2636 | x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger | |
2637 | command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger | |
2638 | command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s | |
2639 | [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r | |
2640 | X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l | |
2641 | X<debugger command, l>, l min+incr, l min-max, l line, l subname, - | |
2642 | X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger | |
2643 | command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L | |
2644 | [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t | |
2645 | X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint> | |
2646 | X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger | |
2647 | command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b | |
2648 | postpone subname [condition] X<breakpoint> X<debugger command, b>, b load | |
2649 | filename X<breakpoint> X<debugger command, b>, b compile subname | |
2650 | X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger | |
2651 | command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command | |
2652 | X<debugger command, a>, A line X<debugger command, A>, A * X<debugger | |
2653 | command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>, | |
2654 | W * X<debugger command, W>, o X<debugger command, o>, o booloption ... | |
2655 | X<debugger command, o>, o anyoption? ... X<debugger command, o>, o | |
2656 | option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, < | |
2657 | [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, << | |
2658 | command X<< debugger command, << >>, > ? X<< debugger command, > >>, > | |
2659 | command X<< debugger command, > >>, > * X<< debugger command, > >>, >> | |
2660 | command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [ | |
2661 | command ], { * X<debugger command, {>, {{ command X<debugger command, {{>, | |
2662 | ! number X<debugger command, !>, ! -number X<debugger command, !>, ! | |
2663 | pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file | |
2664 | X<debugger command, source>, H -number X<debugger command, H>, q or ^D | |
2665 | X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>, | |
2666 | |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m | |
2667 | expr X<debugger command, m>, M X<debugger command, M>, man [manpage] | |
2668 | X<debugger command, man> | |
4755096e | 2669 | |
50e34432 | 2670 | =item Configurable Options |
4755096e | 2671 | |
b40eed9c NC |
2672 | C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger |
2673 | option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning> | |
2674 | X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel> | |
2675 | X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger | |
2676 | option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo> | |
2677 | X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option, | |
2678 | inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments> | |
2679 | X<debugger option, ornaments>, C<frame> X<debugger option, frame>, | |
2680 | C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger | |
2681 | option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option, | |
2682 | arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option, | |
2683 | dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump> | |
2684 | X<debugger option, veryCompact>, C<globPrint> X<debugger option, | |
2685 | globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages> | |
2686 | X<debugger option, DumpPackages>, C<DumpReused> X<debugger option, | |
2687 | DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote> | |
2688 | X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly> | |
2689 | X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY> | |
2690 | X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>, | |
2691 | C<NonStop> X<debugger option, NonStop> | |
4755096e | 2692 | |
50e34432 | 2693 | =item Debugger input/output |
fbe3d936 | 2694 | |
b40eed9c NC |
2695 | Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack, |
2696 | backtrace>, Line Listing Format, Frame listing | |
fbe3d936 | 2697 | |
50e34432 | 2698 | =item Debugging compile-time statements |
95fb7f7f | 2699 | |
50e34432 | 2700 | =item Debugger Customization |
4755096e | 2701 | |
50e34432 | 2702 | =item Readline Support |
ba62762e | 2703 | |
50e34432 | 2704 | =item Editor Support for Debugging |
ba62762e | 2705 | |
50e34432 | 2706 | =item The Perl Profiler |
b40eed9c | 2707 | X<profile> X<profiling> X<profiler> |
ba62762e | 2708 | |
50e34432 | 2709 | =back |
ba62762e | 2710 | |
50e34432 | 2711 | =item Debugging regular expressions |
b40eed9c NC |
2712 | X<regular expression, debugging> |
2713 | X<regex, debugging> X<regexp, debugging> | |
b2deec1d | 2714 | |
50e34432 | 2715 | =item Debugging memory usage |
b40eed9c | 2716 | X<memory usage> |
1184f6df | 2717 | |
50e34432 | 2718 | =item SEE ALSO |
1184f6df | 2719 | |
50e34432 | 2720 | =item BUGS |
37b1fd75 | 2721 | |
ba62762e JH |
2722 | =back |
2723 | ||
50e34432 | 2724 | =head2 perlvar - Perl predefined variables |
4755096e | 2725 | |
d8416318 JH |
2726 | =over 4 |
2727 | ||
50e34432 | 2728 | =item DESCRIPTION |
d8416318 | 2729 | |
50e34432 | 2730 | =over 4 |
d8416318 | 2731 | |
50e34432 | 2732 | =item Predefined Names |
d8416318 | 2733 | |
50e34432 | 2734 | $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
6a5cae29 | 2735 | $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $*, |
50e34432 JH |
2736 | HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, |
2737 | IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, | |
2738 | HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, | |
2739 | IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, | |
2740 | IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, | |
cd458e05 | 2741 | $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#, |
50e34432 JH |
2742 | HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%, |
2743 | HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=, | |
2744 | HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, | |
2745 | @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as | |
2746 | C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var, | |
2747 | $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> | |
2748 | is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as | |
e1114e52 | 2749 | C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR), |
50e34432 JH |
2750 | $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^, |
2751 | IO::Handle->format_line_break_characters EXPR, | |
2752 | $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR, | |
2753 | $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING}, | |
2754 | $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, | |
2755 | $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, | |
2756 | $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), | |
2757 | $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, | |
2758 | $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, | |
2759 | ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, | |
2760 | 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, | |
2761 | $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, | |
e1114e52 NC |
2762 | ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, |
2763 | $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, | |
2764 | %ENV, $ENV{expr}, %SIG, $SIG{expr} | |
50e34432 JH |
2765 | |
2766 | =item Error Indicators | |
2767 | ||
2768 | =item Technical Note on the Syntax of Variable Names | |
35c7d401 | 2769 | |
d8416318 JH |
2770 | =back |
2771 | ||
50e34432 | 2772 | =item BUGS |
b2deec1d | 2773 | |
4755096e GS |
2774 | =back |
2775 | ||
50e34432 | 2776 | =head2 perlre - Perl regular expressions |
4755096e | 2777 | |
d420ca49 | 2778 | =over 4 |
4755096e | 2779 | |
d396a558 | 2780 | =item DESCRIPTION |
4755096e | 2781 | |
b40eed9c NC |
2782 | i X</i> X<regex, case-insensitive> X<regexp, case-insensitive> X<regular |
2783 | expression, case-insensitive>, m X</m> X<regex, multiline> X<regexp, | |
2784 | multiline> X<regular expression, multiline>, s X</s> X<regex, single-line> | |
2785 | X<regexp, single-line> X<regular expression, single-line>, x X</x> | |
4755096e | 2786 | |
d420ca49 | 2787 | =over 4 |
4755096e | 2788 | |
50e34432 | 2789 | =item Regular Expressions |
4755096e | 2790 | |
b40eed9c NC |
2791 | [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct |
2792 | X<punct>, xdigit X<xdigit> | |
4755096e | 2793 | |
50e34432 | 2794 | =item Extended Patterns |
4755096e | 2795 | |
b40eed9c NC |
2796 | C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>, |
2797 | C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X<look-ahead, positive> | |
2798 | X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead, negative> | |
2799 | X<lookahead, negative>, C<(?<=pattern)> X<(?<=)> X<look-behind, positive> | |
2800 | X<lookbehind, positive>, C<(?<!pattern)> X<(?<!)> X<look-behind, negative> | |
2801 | X<lookbehind, negative>, C<(?{ code })> X<(?{})> X<regex, code in> | |
2802 | X<regexp, code in> X<regular expression, code in>, C<(??{ code })> | |
2803 | X<(??{})> X<regex, postponed> X<regexp, postponed> X<regular expression, | |
2804 | postponed> X<regex, recursive> X<regexp, recursive> X<regular expression, | |
2805 | recursive>, C<< (?>pattern) >> X<backtrack> X<backtracking>, | |
2806 | C<(?(condition)yes-pattern|no-pattern)> X<(?()>, | |
2807 | C<(?(condition)yes-pattern)> | |
4755096e | 2808 | |
50e34432 | 2809 | =item Backtracking |
b40eed9c | 2810 | X<backtrack> X<backtracking> |
4755096e | 2811 | |
50e34432 | 2812 | =item Version 8 Regular Expressions |
b40eed9c | 2813 | X<regular expression, version 8> X<regex, version 8> X<regexp, version 8> |
4755096e | 2814 | |
50e34432 | 2815 | =item Warning on \1 vs $1 |
4755096e | 2816 | |
50e34432 | 2817 | =item Repeated patterns matching zero-length substring |
b2deec1d | 2818 | |
50e34432 | 2819 | =item Combining pieces together |
b2deec1d | 2820 | |
50e34432 JH |
2821 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, |
2822 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
2823 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
2824 | C<(?(condition)yes-pattern|no-pattern)> | |
41ca3a40 | 2825 | |
50e34432 | 2826 | =item Creating custom RE engines |
ff426ff2 | 2827 | |
4755096e GS |
2828 | =back |
2829 | ||
50e34432 | 2830 | =item BUGS |
4755096e | 2831 | |
50e34432 | 2832 | =item SEE ALSO |
4755096e | 2833 | |
50e34432 | 2834 | =back |
4755096e | 2835 | |
50e34432 | 2836 | =head2 perlreref - Perl Regular Expressions Reference |
4755096e | 2837 | |
d420ca49 | 2838 | =over 4 |
37d4d706 | 2839 | |
50e34432 | 2840 | =item DESCRIPTION |
37d4d706 | 2841 | |
50e34432 | 2842 | =over 4 |
37d4d706 | 2843 | |
50e34432 | 2844 | =item OPERATORS |
37d4d706 | 2845 | |
50e34432 | 2846 | =item SYNTAX |
37d4d706 | 2847 | |
50e34432 | 2848 | =item ESCAPE SEQUENCES |
4755096e | 2849 | |
50e34432 | 2850 | =item CHARACTER CLASSES |
4755096e | 2851 | |
50e34432 | 2852 | =item ANCHORS |
4755096e | 2853 | |
50e34432 | 2854 | =item QUANTIFIERS |
4755096e | 2855 | |
50e34432 | 2856 | =item EXTENDED CONSTRUCTS |
4755096e | 2857 | |
50e34432 | 2858 | =item VARIABLES |
4755096e | 2859 | |
50e34432 | 2860 | =item FUNCTIONS |
4755096e | 2861 | |
50e34432 | 2862 | =item TERMINOLOGY |
4755096e | 2863 | |
50e34432 | 2864 | =back |
4755096e | 2865 | |
50e34432 | 2866 | =item AUTHOR |
4755096e | 2867 | |
50e34432 JH |
2868 | =item SEE ALSO |
2869 | ||
2870 | =item THANKS | |
4755096e GS |
2871 | |
2872 | =back | |
2873 | ||
50e34432 | 2874 | =head2 perlref - Perl references and nested data structures |
37d4d706 | 2875 | |
d420ca49 | 2876 | =over 4 |
37d4d706 | 2877 | |
50e34432 | 2878 | =item NOTE |
37d4d706 | 2879 | |
50e34432 | 2880 | =item DESCRIPTION |
37d4d706 | 2881 | |
50e34432 | 2882 | =over 4 |
37d4d706 | 2883 | |
50e34432 | 2884 | =item Making References |
b40eed9c NC |
2885 | X<reference, creation> X<referencing> |
2886 | ||
2887 | 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket> | |
2888 | X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3. | |
2889 | X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace> | |
2890 | X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine, | |
2891 | anonymous> X<subroutine, reference> X<reference, subroutine> X<scope, | |
2892 | lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>, | |
2893 | 6. X<autovivification>, 7. X<*foo{THING}> X<*> | |
37d4d706 | 2894 | |
50e34432 | 2895 | =item Using References |
b40eed9c NC |
2896 | X<reference, use> X<dereferencing> X<dereference> |
2897 | ||
2898 | 2. X<${}> X<@{}> X<%{}>, 3. X<autovivification> X<< -> >> X<arrow>, 4. | |
2899 | X<encapsulation> | |
37d4d706 | 2900 | |
50e34432 | 2901 | =item Symbolic references |
b40eed9c NC |
2902 | X<reference, symbolic> X<reference, soft> |
2903 | X<symbolic reference> X<soft reference> | |
4755096e | 2904 | |
50e34432 | 2905 | =item Not-so-symbolic references |
4755096e | 2906 | |
50e34432 | 2907 | =item Pseudo-hashes: Using an array as a hash |
b40eed9c | 2908 | X<pseudo-hash> X<pseudo hash> X<pseudohash> |
4755096e | 2909 | |
50e34432 | 2910 | =item Function Templates |
b40eed9c NC |
2911 | X<scope, lexical> X<closure> X<lexical> X<lexical scope> |
2912 | X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local> | |
4755096e | 2913 | |
50e34432 | 2914 | =back |
4755096e | 2915 | |
50e34432 | 2916 | =item WARNING |
b40eed9c | 2917 | X<reference, string context> X<reference, use as hash key> |
7029d033 | 2918 | |
50e34432 | 2919 | =item SEE ALSO |
4755096e | 2920 | |
50e34432 | 2921 | =back |
4755096e | 2922 | |
50e34432 | 2923 | =head2 perlform - Perl formats |
4755096e | 2924 | |
50e34432 | 2925 | =over 4 |
4755096e | 2926 | |
50e34432 JH |
2927 | =item DESCRIPTION |
2928 | ||
2929 | =over 4 | |
2930 | ||
7f106169 | 2931 | =item Text Fields |
b40eed9c | 2932 | X<format, text field> |
7f106169 NC |
2933 | |
2934 | =item Numeric Fields | |
b40eed9c | 2935 | X<#> X<format, numeric field> |
7f106169 NC |
2936 | |
2937 | =item The Field @* for Variable Width Multi-Line Text | |
b40eed9c | 2938 | X<@*> |
7f106169 NC |
2939 | |
2940 | =item The Field ^* for Variable Width One-line-at-a-time Text | |
b40eed9c | 2941 | X<^*> |
7f106169 NC |
2942 | |
2943 | =item Specifying Values | |
b40eed9c | 2944 | X<format, specifying values> |
7f106169 NC |
2945 | |
2946 | =item Using Fill Mode | |
b40eed9c | 2947 | X<format, fill mode> |
7f106169 NC |
2948 | |
2949 | =item Suppressing Lines Where All Fields Are Void | |
b40eed9c | 2950 | X<format, suppressing lines> |
7f106169 NC |
2951 | |
2952 | =item Repeating Format Lines | |
b40eed9c | 2953 | X<format, repeating lines> |
7f106169 NC |
2954 | |
2955 | =item Top of Form Processing | |
b40eed9c | 2956 | X<format, top of form> X<top> X<header> |
7f106169 | 2957 | |
50e34432 | 2958 | =item Format Variables |
b40eed9c NC |
2959 | X<format variables> |
2960 | X<format, variables> | |
4755096e | 2961 | |
d396a558 | 2962 | =back |
4755096e | 2963 | |
50e34432 | 2964 | =item NOTES |
9fa7f388 | 2965 | |
50e34432 | 2966 | =over 4 |
b3b6085d | 2967 | |
50e34432 | 2968 | =item Footers |
b40eed9c | 2969 | X<format, footer> X<footer> |
c2e66d9e | 2970 | |
50e34432 | 2971 | =item Accessing Formatting Internals |
b40eed9c | 2972 | X<format, internals> |
41ca3a40 | 2973 | |
50e34432 JH |
2974 | =back |
2975 | ||
2976 | =item WARNINGS | |
4755096e GS |
2977 | |
2978 | =back | |
2979 | ||
50e34432 | 2980 | =head2 perlobj - Perl objects |
4755096e | 2981 | |
d420ca49 | 2982 | =over 4 |
4755096e | 2983 | |
4755096e GS |
2984 | =item DESCRIPTION |
2985 | ||
d420ca49 | 2986 | =over 4 |
4755096e | 2987 | |
50e34432 | 2988 | =item An Object is Simply a Reference |
b40eed9c | 2989 | X<object> X<bless> X<constructor> X<new> |
4755096e | 2990 | |
50e34432 | 2991 | =item A Class is Simply a Package |
b40eed9c | 2992 | X<class> X<package> X<@ISA> X<inheritance> |
4755096e | 2993 | |
50e34432 | 2994 | =item A Method is Simply a Subroutine |
b40eed9c | 2995 | X<method> |
c2e66d9e | 2996 | |
50e34432 | 2997 | =item Method Invocation |
b40eed9c | 2998 | X<invocation> X<method> X<arrow> X<< -> >> |
c2e66d9e | 2999 | |
50e34432 | 3000 | =item Indirect Object Syntax |
b40eed9c | 3001 | X<indirect object syntax> X<invocation, indirect> X<indirect> |
4755096e | 3002 | |
50e34432 | 3003 | =item Default UNIVERSAL methods |
b40eed9c | 3004 | X<UNIVERSAL> |
d8416318 | 3005 | |
b40eed9c | 3006 | isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION> |
50e34432 JH |
3007 | |
3008 | =item Destructors | |
b40eed9c | 3009 | X<destructor> X<DESTROY> |
50e34432 JH |
3010 | |
3011 | =item Summary | |
3012 | ||
3013 | =item Two-Phased Garbage Collection | |
b40eed9c NC |
3014 | X<garbage collection> X<GC> X<circular reference> |
3015 | X<reference, circular> X<DESTROY> X<destructor> | |
6e76d345 | 3016 | |
4755096e GS |
3017 | =back |
3018 | ||
c2e66d9e GS |
3019 | =item SEE ALSO |
3020 | ||
4755096e GS |
3021 | =back |
3022 | ||
50e34432 | 3023 | =head2 perltie - how to hide an object class in a simple variable |
4755096e | 3024 | |
d420ca49 | 3025 | =over 4 |
4755096e | 3026 | |
50e34432 JH |
3027 | =item SYNOPSIS |
3028 | ||
4755096e GS |
3029 | =item DESCRIPTION |
3030 | ||
d420ca49 | 3031 | =over 4 |
4755096e | 3032 | |
50e34432 | 3033 | =item Tying Scalars |
b40eed9c | 3034 | X<scalar, tying> |
4755096e | 3035 | |
b40eed9c NC |
3036 | TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this, |
3037 | value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY> | |
4755096e | 3038 | |
50e34432 | 3039 | =item Tying Arrays |
b40eed9c | 3040 | X<array, tying> |
4755096e | 3041 | |
b40eed9c NC |
3042 | TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE |
3043 | this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this, | |
3044 | count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key | |
3045 | X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST | |
3046 | X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST | |
3047 | X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this | |
3048 | X<UNTIE>, DESTROY this X<DESTROY> | |
4755096e | 3049 | |
50e34432 | 3050 | =item Tying Hashes |
b40eed9c | 3051 | X<hash, tying> |
4755096e | 3052 | |
b40eed9c NC |
3053 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this, |
3054 | key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>, | |
3055 | CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>, | |
3056 | NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this | |
3057 | X<UNTIE>, DESTROY this X<DESTROY> | |
50e34432 JH |
3058 | |
3059 | =item Tying FileHandles | |
b40eed9c | 3060 | X<filehandle, tying> |
50e34432 | 3061 | |
b40eed9c NC |
3062 | TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT |
3063 | this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>, | |
3064 | READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE | |
3065 | this X<UNTIE>, DESTROY this X<DESTROY> | |
50e34432 JH |
3066 | |
3067 | =item UNTIE this | |
b40eed9c | 3068 | X<UNTIE> |
50e34432 JH |
3069 | |
3070 | =item The C<untie> Gotcha | |
b40eed9c | 3071 | X<untie> |
a6fb92f1 | 3072 | |
4755096e GS |
3073 | =back |
3074 | ||
c2e66d9e | 3075 | =item SEE ALSO |
4755096e | 3076 | |
50e34432 JH |
3077 | =item BUGS |
3078 | ||
3079 | =item AUTHOR | |
3080 | ||
c2e66d9e | 3081 | =back |
4755096e | 3082 | |
50e34432 | 3083 | =head2 perldbmfilter - Perl DBM Filters |
35bf961c JH |
3084 | |
3085 | =over 4 | |
3086 | ||
50e34432 JH |
3087 | =item SYNOPSIS |
3088 | ||
35bf961c JH |
3089 | =item DESCRIPTION |
3090 | ||
50e34432 JH |
3091 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
3092 | B<filter_fetch_value> | |
3093 | ||
35bf961c JH |
3094 | =over 4 |
3095 | ||
50e34432 | 3096 | =item The Filter |
35bf961c | 3097 | |
50e34432 | 3098 | =item An Example -- the NULL termination problem. |
35bf961c | 3099 | |
50e34432 | 3100 | =item Another Example -- Key is a C int. |
35bf961c | 3101 | |
50e34432 | 3102 | =back |
35bf961c | 3103 | |
50e34432 | 3104 | =item SEE ALSO |
35bf961c JH |
3105 | |
3106 | =item AUTHOR | |
3107 | ||
35bf961c JH |
3108 | =back |
3109 | ||
50e34432 JH |
3110 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
3111 | safe subprocesses, sockets, and semaphores) | |
4755096e | 3112 | |
d420ca49 | 3113 | =over 4 |
4755096e | 3114 | |
50e34432 JH |
3115 | =item DESCRIPTION |
3116 | ||
3117 | =item Signals | |
4755096e | 3118 | |
d420ca49 | 3119 | =over 4 |
4755096e | 3120 | |
50e34432 | 3121 | =item Handling the SIGHUP Signal in Daemons |
4755096e | 3122 | |
50e34432 | 3123 | =back |
4755096e | 3124 | |
50e34432 | 3125 | =item Named Pipes |
4755096e | 3126 | |
50e34432 | 3127 | =over 4 |
4755096e | 3128 | |
7ba761b0 | 3129 | =item Deferred Signals (Safe Signals) |
50e34432 JH |
3130 | |
3131 | Long running opcodes, Interrupting IO, Restartable system calls, Signals as | |
3132 | "faults", Signals triggered by operating system state | |
4755096e | 3133 | |
c2e66d9e | 3134 | =back |
4755096e | 3135 | |
50e34432 | 3136 | =item Using open() for IPC |
4755096e | 3137 | |
603b90a8 JH |
3138 | =over 4 |
3139 | ||
50e34432 | 3140 | =item Filehandles |
603b90a8 | 3141 | |
50e34432 | 3142 | =item Background Processes |
5df44211 | 3143 | |
50e34432 | 3144 | =item Complete Dissociation of Child from Parent |
603b90a8 | 3145 | |
50e34432 | 3146 | =item Safe Pipe Opens |
5df44211 | 3147 | |
50e34432 | 3148 | =item Bidirectional Communication with Another Process |
603b90a8 | 3149 | |
50e34432 | 3150 | =item Bidirectional Communication with Yourself |
5df44211 | 3151 | |
50e34432 | 3152 | =back |
603b90a8 | 3153 | |
50e34432 | 3154 | =item Sockets: Client/Server Communication |
5df44211 | 3155 | |
50e34432 | 3156 | =over 4 |
603b90a8 | 3157 | |
50e34432 | 3158 | =item Internet Line Terminators |
5df44211 | 3159 | |
50e34432 | 3160 | =item Internet TCP Clients and Servers |
603b90a8 | 3161 | |
50e34432 | 3162 | =item Unix-Domain TCP Clients and Servers |
5df44211 | 3163 | |
50e34432 | 3164 | =back |
603b90a8 | 3165 | |
50e34432 | 3166 | =item TCP Clients with IO::Socket |
5df44211 | 3167 | |
50e34432 JH |
3168 | =over 4 |
3169 | ||
3170 | =item A Simple Client | |
3171 | ||
3172 | C<Proto>, C<PeerAddr>, C<PeerPort> | |
3173 | ||
3174 | =item A Webget Client | |
3175 | ||
3176 | =item Interactive Client with IO::Socket | |
5df44211 | 3177 | |
603b90a8 | 3178 | =back |
4755096e | 3179 | |
50e34432 | 3180 | =item TCP Servers with IO::Socket |
4755096e | 3181 | |
50e34432 | 3182 | Proto, LocalPort, Listen, Reuse |
4755096e | 3183 | |
50e34432 | 3184 | =item UDP: Message Passing |
4755096e | 3185 | |
50e34432 | 3186 | =item SysV IPC |
4755096e | 3187 | |
50e34432 | 3188 | =item NOTES |
4755096e | 3189 | |
50e34432 | 3190 | =item BUGS |
4755096e | 3191 | |
50e34432 JH |
3192 | =item AUTHOR |
3193 | ||
3194 | =item SEE ALSO | |
4755096e | 3195 | |
c2e66d9e | 3196 | =back |
4755096e | 3197 | |
50e34432 | 3198 | =head2 perlfork - Perl's fork() emulation |
4755096e | 3199 | |
d420ca49 | 3200 | =over 4 |
4755096e | 3201 | |
50e34432 | 3202 | =item SYNOPSIS |
35bf961c | 3203 | |
50e34432 | 3204 | =item DESCRIPTION |
4755096e | 3205 | |
d420ca49 | 3206 | =over 4 |
4755096e | 3207 | |
50e34432 | 3208 | =item Behavior of other Perl features in forked pseudo-processes |
4755096e | 3209 | |
50e34432 JH |
3210 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
3211 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
3212 | files, directories and network sockets | |
35bf961c | 3213 | |
50e34432 | 3214 | =item Resource limits |
35bf961c | 3215 | |
50e34432 | 3216 | =item Killing the parent process |
35bf961c | 3217 | |
50e34432 | 3218 | =item Lifetime of the parent process and pseudo-processes |
4755096e | 3219 | |
50e34432 | 3220 | =item CAVEATS AND LIMITATIONS |
4755096e | 3221 | |
50e34432 JH |
3222 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
3223 | Global state maintained by XSUBs, Interpreter embedded in larger | |
3224 | application, Thread-safety of extensions | |
a9ef4385 | 3225 | |
50e34432 | 3226 | =back |
c2e66d9e | 3227 | |
50e34432 | 3228 | =item BUGS |
c2e66d9e | 3229 | |
50e34432 | 3230 | =item AUTHOR |
35bf961c | 3231 | |
50e34432 | 3232 | =item SEE ALSO |
35bf961c JH |
3233 | |
3234 | =back | |
3235 | ||
50e34432 | 3236 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
35bf961c JH |
3237 | |
3238 | =over 4 | |
3239 | ||
50e34432 | 3240 | =item SYNOPSIS |
35bf961c | 3241 | |
50e34432 | 3242 | =item DESCRIPTION |
35bf961c | 3243 | |
50e34432 | 3244 | =item Storing numbers |
35bf961c | 3245 | |
50e34432 | 3246 | =item Numeric operators and numeric conversions |
35bf961c | 3247 | |
50e34432 | 3248 | =item Flavors of Perl numeric operations |
35bf961c | 3249 | |
50e34432 JH |
3250 | Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other |
3251 | mathematical operators, Bitwise operators, Bitwise operators during C<use | |
3252 | integer>, Operators which expect an integer, Operators which expect a | |
3253 | string | |
3254 | ||
3255 | =item AUTHOR | |
3256 | ||
3257 | =item SEE ALSO | |
35bf961c JH |
3258 | |
3259 | =back | |
3260 | ||
50e34432 | 3261 | =head2 perlthrtut - tutorial on threads in Perl |
35bf961c JH |
3262 | |
3263 | =over 4 | |
3264 | ||
50e34432 | 3265 | =item DESCRIPTION |
35bf961c | 3266 | |
50e34432 | 3267 | =item Status |
35c7d401 | 3268 | |
50e34432 | 3269 | =item What Is A Thread Anyway? |
35bf961c | 3270 | |
50e34432 | 3271 | =item Threaded Program Models |
35bf961c JH |
3272 | |
3273 | =over 4 | |
3274 | ||
50e34432 | 3275 | =item Boss/Worker |
35bf961c | 3276 | |
50e34432 | 3277 | =item Work Crew |
35bf961c | 3278 | |
50e34432 | 3279 | =item Pipeline |
35bf961c | 3280 | |
50e34432 | 3281 | =back |
35bf961c | 3282 | |
50e34432 | 3283 | =item What kind of threads are Perl threads? |
35bf961c | 3284 | |
50e34432 | 3285 | =item Thread-Safe Modules |
35bf961c | 3286 | |
50e34432 | 3287 | =item Thread Basics |
35bf961c JH |
3288 | |
3289 | =over 4 | |
3290 | ||
50e34432 | 3291 | =item Basic Thread Support |
35bf961c | 3292 | |
50e34432 | 3293 | =item A Note about the Examples |
35bf961c | 3294 | |
50e34432 JH |
3295 | =item Creating Threads |
3296 | ||
3297 | =item Waiting For A Thread To Exit | |
3298 | ||
3299 | =item Ignoring A Thread | |
35bf961c JH |
3300 | |
3301 | =back | |
3302 | ||
50e34432 | 3303 | =item Threads And Data |
35bf961c | 3304 | |
50e34432 | 3305 | =over 4 |
35bf961c | 3306 | |
50e34432 JH |
3307 | =item Shared And Unshared Data |
3308 | ||
3309 | =item Thread Pitfalls: Races | |
4755096e GS |
3310 | |
3311 | =back | |
3312 | ||
50e34432 | 3313 | =item Synchronization and control |
4755096e | 3314 | |
d420ca49 | 3315 | =over 4 |
4755096e | 3316 | |
50e34432 | 3317 | =item Controlling access: lock() |
4755096e | 3318 | |
50e34432 | 3319 | =item A Thread Pitfall: Deadlocks |
4755096e | 3320 | |
50e34432 | 3321 | =item Queues: Passing Data Around |
4755096e | 3322 | |
50e34432 | 3323 | =item Semaphores: Synchronizing Data Access |
4755096e | 3324 | |
50e34432 | 3325 | =item Basic semaphores |
4755096e | 3326 | |
50e34432 | 3327 | =item Advanced Semaphores |
4755096e | 3328 | |
50e34432 | 3329 | =item cond_wait() and cond_signal() |
4755096e | 3330 | |
50e34432 | 3331 | =item Giving up control |
4755096e | 3332 | |
50e34432 | 3333 | =back |
4755096e | 3334 | |
50e34432 | 3335 | =item General Thread Utility Routines |
4755096e | 3336 | |
50e34432 | 3337 | =over 4 |
4755096e | 3338 | |
50e34432 | 3339 | =item What Thread Am I In? |
4755096e | 3340 | |
50e34432 JH |
3341 | =item Thread IDs |
3342 | ||
3343 | =item Are These Threads The Same? | |
3344 | ||
3345 | =item What Threads Are Running? | |
4755096e GS |
3346 | |
3347 | =back | |
3348 | ||
50e34432 | 3349 | =item A Complete Example |
4755096e | 3350 | |
50e34432 | 3351 | =item Different implementations of threads |
4755096e | 3352 | |
50e34432 JH |
3353 | =item Performance considerations |
3354 | ||
3355 | =item Process-scope Changes | |
3356 | ||
3357 | =item Thread-Safety of System Libraries | |
3358 | ||
3359 | =item Conclusion | |
3360 | ||
3361 | =item Bibliography | |
4755096e | 3362 | |
d420ca49 | 3363 | =over 4 |
4755096e | 3364 | |
50e34432 | 3365 | =item Introductory Texts |
4755096e | 3366 | |
50e34432 | 3367 | =item OS-Related References |
4755096e | 3368 | |
50e34432 | 3369 | =item Other References |
4755096e | 3370 | |
50e34432 | 3371 | =back |
4755096e | 3372 | |
50e34432 | 3373 | =item Acknowledgements |
73fba812 | 3374 | |
50e34432 | 3375 | =item AUTHOR |
4755096e | 3376 | |
50e34432 | 3377 | =item Copyrights |
4755096e | 3378 | |
50e34432 | 3379 | =back |
4755096e | 3380 | |
50e34432 | 3381 | =head2 perlothrtut - old tutorial on threads in Perl |
4755096e | 3382 | |
50e34432 | 3383 | =over 4 |
4755096e | 3384 | |
50e34432 | 3385 | =item DESCRIPTION |
4755096e | 3386 | |
50e34432 | 3387 | =item What Is A Thread Anyway? |
4755096e | 3388 | |
50e34432 | 3389 | =item Threaded Program Models |
4755096e | 3390 | |
50e34432 | 3391 | =over 4 |
4755096e | 3392 | |
50e34432 | 3393 | =item Boss/Worker |
4755096e | 3394 | |
50e34432 JH |
3395 | =item Work Crew |
3396 | ||
3397 | =item Pipeline | |
4755096e GS |
3398 | |
3399 | =back | |
3400 | ||
50e34432 | 3401 | =item Native threads |
4755096e | 3402 | |
50e34432 | 3403 | =item What kind of threads are perl threads? |
4755096e | 3404 | |
50e34432 JH |
3405 | =item Threadsafe Modules |
3406 | ||
3407 | =item Thread Basics | |
4755096e | 3408 | |
d420ca49 | 3409 | =over 4 |
4755096e | 3410 | |
50e34432 | 3411 | =item Basic Thread Support |
4755096e | 3412 | |
50e34432 | 3413 | =item Creating Threads |
4755096e | 3414 | |
50e34432 | 3415 | =item Giving up control |
4755096e | 3416 | |
50e34432 | 3417 | =item Waiting For A Thread To Exit |
4755096e | 3418 | |
50e34432 | 3419 | =item Errors In Threads |
4755096e | 3420 | |
50e34432 | 3421 | =item Ignoring A Thread |
4755096e | 3422 | |
50e34432 | 3423 | =back |
4755096e | 3424 | |
50e34432 | 3425 | =item Threads And Data |
4755096e | 3426 | |
50e34432 | 3427 | =over 4 |
4755096e | 3428 | |
50e34432 | 3429 | =item Shared And Unshared Data |
4755096e | 3430 | |
50e34432 | 3431 | =item Thread Pitfall: Races |
4755096e | 3432 | |
50e34432 | 3433 | =item Controlling access: lock() |
4755096e | 3434 | |
50e34432 | 3435 | =item Thread Pitfall: Deadlocks |
4755096e | 3436 | |
50e34432 | 3437 | =item Queues: Passing Data Around |
4755096e | 3438 | |
50e34432 | 3439 | =back |
4755096e | 3440 | |
50e34432 | 3441 | =item Threads And Code |
4755096e | 3442 | |
50e34432 | 3443 | =over 4 |
4755096e | 3444 | |
50e34432 | 3445 | =item Semaphores: Synchronizing Data Access |
4755096e | 3446 | |
50e34432 | 3447 | Basic semaphores, Advanced Semaphores |
4755096e | 3448 | |
50e34432 | 3449 | =item Attributes: Restricting Access To Subroutines |
4755096e | 3450 | |
50e34432 | 3451 | =item Subroutine Locks |
4755096e | 3452 | |
50e34432 | 3453 | =item Methods |
4755096e | 3454 | |
50e34432 | 3455 | =item Locking A Subroutine |
4755096e GS |
3456 | |
3457 | =back | |
3458 | ||
50e34432 | 3459 | =item General Thread Utility Routines |
4755096e | 3460 | |
d420ca49 | 3461 | =over 4 |
4755096e | 3462 | |
50e34432 | 3463 | =item What Thread Am I In? |
4755096e | 3464 | |
50e34432 | 3465 | =item Thread IDs |
4755096e | 3466 | |
50e34432 | 3467 | =item Are These Threads The Same? |
4755096e | 3468 | |
50e34432 | 3469 | =item What Threads Are Running? |
4755096e | 3470 | |
50e34432 | 3471 | =back |
4755096e | 3472 | |
50e34432 | 3473 | =item A Complete Example |
35c7d401 | 3474 | |
50e34432 | 3475 | =item Conclusion |
4755096e | 3476 | |
50e34432 | 3477 | =item Bibliography |
4755096e | 3478 | |
50e34432 | 3479 | =over 4 |
4755096e | 3480 | |
50e34432 | 3481 | =item Introductory Texts |
4755096e | 3482 | |
50e34432 | 3483 | =item OS-Related References |
4755096e | 3484 | |
50e34432 | 3485 | =item Other References |
4755096e | 3486 | |
50e34432 | 3487 | =back |
603b90a8 | 3488 | |
50e34432 | 3489 | =item Acknowledgements |
4755096e | 3490 | |
50e34432 | 3491 | =item AUTHOR |
4755096e | 3492 | |
50e34432 | 3493 | =item Copyrights |
4755096e | 3494 | |
50e34432 | 3495 | =back |
4755096e | 3496 | |
50e34432 | 3497 | =head2 perlport - Writing portable Perl |
4755096e | 3498 | |
50e34432 | 3499 | =over 4 |
4755096e | 3500 | |
50e34432 | 3501 | =item DESCRIPTION |
4755096e | 3502 | |
50e34432 JH |
3503 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
3504 | portable | |
35bf961c | 3505 | |
50e34432 | 3506 | =item ISSUES |
4755096e | 3507 | |
50e34432 | 3508 | =over 4 |
4755096e | 3509 | |
50e34432 | 3510 | =item Newlines |
4755096e | 3511 | |
50e34432 | 3512 | =item Numbers endianness and Width |
4755096e | 3513 | |
50e34432 | 3514 | =item Files and Filesystems |
4755096e | 3515 | |
50e34432 | 3516 | =item System Interaction |
4755096e | 3517 | |
50e34432 | 3518 | =item Command names versus file pathnames |
4755096e | 3519 | |
50e34432 | 3520 | =item Networking |
4755096e | 3521 | |
50e34432 | 3522 | =item Interprocess Communication (IPC) |
4755096e | 3523 | |
50e34432 | 3524 | =item External Subroutines (XS) |
4755096e | 3525 | |
50e34432 | 3526 | =item Standard Modules |
cb52f95f | 3527 | |
50e34432 | 3528 | =item Time and Date |
4755096e | 3529 | |
50e34432 | 3530 | =item Character sets and character encoding |
4755096e | 3531 | |
50e34432 | 3532 | =item Internationalisation |
4755096e | 3533 | |
50e34432 | 3534 | =item System Resources |
4755096e | 3535 | |
50e34432 | 3536 | =item Security |
4755096e | 3537 | |
50e34432 | 3538 | =item Style |
4755096e GS |
3539 | |
3540 | =back | |
3541 | ||
50e34432 | 3542 | =item CPAN Testers |
4755096e | 3543 | |
50e34432 | 3544 | =item PLATFORMS |
4755096e | 3545 | |
d420ca49 | 3546 | =over 4 |
4755096e | 3547 | |
50e34432 | 3548 | =item Unix |
1fdc5aa6 | 3549 | |
50e34432 | 3550 | =item DOS and Derivatives |
4755096e | 3551 | |
50e34432 | 3552 | =item S<Mac OS> |
4755096e | 3553 | |
50e34432 | 3554 | =item VMS |
4755096e | 3555 | |
50e34432 | 3556 | =item VOS |
4755096e | 3557 | |
50e34432 | 3558 | =item EBCDIC Platforms |
4755096e | 3559 | |
50e34432 | 3560 | =item Acorn RISC OS |
4755096e | 3561 | |
50e34432 | 3562 | =item Other perls |
fa17183e | 3563 | |
4755096e GS |
3564 | =back |
3565 | ||
50e34432 | 3566 | =item FUNCTION IMPLEMENTATIONS |
4755096e | 3567 | |
d420ca49 | 3568 | =over 4 |
4755096e | 3569 | |
50e34432 | 3570 | =item Alphabetical Listing of Perl Functions |
4755096e | 3571 | |
b40eed9c NC |
3572 | -I<X>, atan2 Y,X, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, |
3573 | dbmopen, dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid, | |
e7f2ff80 NC |
3574 | getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid, |
3575 | getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent, | |
3576 | gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent, | |
3577 | setnetent, setprotoent, setservent, endpwent, endgrent, endhostent, | |
3578 | endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob, | |
3579 | gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat, | |
3580 | msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select, | |
3581 | semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent, | |
3582 | setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair, | |
3583 | stat, symlink, syscall, sysopen, system, times, truncate, umask, utime, | |
3584 | wait, waitpid | |
3585 | ||
3586 | =back | |
4755096e | 3587 | |
50e34432 JH |
3588 | =item Supported Platforms |
3589 | ||
3590 | =item SEE ALSO | |
3591 | ||
3592 | =item AUTHORS / CONTRIBUTORS | |
4755096e GS |
3593 | |
3594 | =back | |
3595 | ||
50e34432 JH |
3596 | =head2 perllocale - Perl locale handling (internationalization and |
3597 | localization) | |
4755096e | 3598 | |
d420ca49 | 3599 | =over 4 |
4755096e | 3600 | |
50e34432 | 3601 | =item DESCRIPTION |
4755096e | 3602 | |
50e34432 | 3603 | =item PREPARING TO USE LOCALES |
4755096e | 3604 | |
50e34432 | 3605 | =item USING LOCALES |
4755096e | 3606 | |
50e34432 | 3607 | =over 4 |
4755096e | 3608 | |
50e34432 | 3609 | =item The use locale pragma |
4755096e | 3610 | |
50e34432 | 3611 | =item The setlocale function |
4755096e | 3612 | |
50e34432 | 3613 | =item Finding locales |
4755096e | 3614 | |
50e34432 | 3615 | =item LOCALE PROBLEMS |
4755096e | 3616 | |
50e34432 | 3617 | =item Temporarily fixing locale problems |
4755096e | 3618 | |
50e34432 | 3619 | =item Permanently fixing locale problems |
4755096e | 3620 | |
50e34432 | 3621 | =item Permanently fixing your system's locale configuration |
4755096e | 3622 | |
50e34432 | 3623 | =item Fixing system locale configuration |
4755096e | 3624 | |
50e34432 | 3625 | =item The localeconv function |
4755096e | 3626 | |
50e34432 | 3627 | =item I18N::Langinfo |
4755096e | 3628 | |
50e34432 | 3629 | =back |
4755096e | 3630 | |
50e34432 | 3631 | =item LOCALE CATEGORIES |
4755096e | 3632 | |
50e34432 | 3633 | =over 4 |
4755096e | 3634 | |
50e34432 | 3635 | =item Category LC_COLLATE: Collation |
4755096e | 3636 | |
50e34432 | 3637 | =item Category LC_CTYPE: Character Types |
4755096e | 3638 | |
50e34432 | 3639 | =item Category LC_NUMERIC: Numeric Formatting |
4755096e | 3640 | |
50e34432 | 3641 | =item Category LC_MONETARY: Formatting of monetary amounts |
4755096e | 3642 | |
50e34432 | 3643 | =item LC_TIME |
4755096e | 3644 | |
50e34432 | 3645 | =item Other categories |
4755096e | 3646 | |
50e34432 | 3647 | =back |
4755096e | 3648 | |
50e34432 | 3649 | =item SECURITY |
4755096e | 3650 | |
50e34432 | 3651 | =item ENVIRONMENT |
4755096e | 3652 | |
50e34432 JH |
3653 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
3654 | LC_NUMERIC, LC_TIME, LANG | |
4755096e | 3655 | |
50e34432 | 3656 | =item NOTES |
4755096e | 3657 | |
50e34432 | 3658 | =over 4 |
4755096e | 3659 | |
50e34432 | 3660 | =item Backward compatibility |
4755096e | 3661 | |
50e34432 | 3662 | =item I18N:Collate obsolete |
4755096e | 3663 | |
50e34432 | 3664 | =item Sort speed and memory use impacts |
4755096e | 3665 | |
50e34432 | 3666 | =item write() and LC_NUMERIC |
4755096e | 3667 | |
50e34432 | 3668 | =item Freely available locale definitions |
4755096e | 3669 | |
50e34432 | 3670 | =item I18n and l10n |
4755096e | 3671 | |
50e34432 | 3672 | =item An imperfect standard |
4755096e | 3673 | |
50e34432 | 3674 | =back |
a6812a52 | 3675 | |
50e34432 | 3676 | =item Unicode and UTF-8 |
4755096e | 3677 | |
50e34432 | 3678 | =item BUGS |
4755096e | 3679 | |
50e34432 | 3680 | =over 4 |
4755096e | 3681 | |
50e34432 | 3682 | =item Broken systems |
4755096e GS |
3683 | |
3684 | =back | |
3685 | ||
50e34432 | 3686 | =item SEE ALSO |
4755096e | 3687 | |
50e34432 | 3688 | =item HISTORY |
4755096e | 3689 | |
50e34432 | 3690 | =back |
4755096e | 3691 | |
50e34432 | 3692 | =head2 perluniintro - Perl Unicode introduction |
4755096e | 3693 | |
50e34432 | 3694 | =over 4 |
4755096e | 3695 | |
50e34432 | 3696 | =item DESCRIPTION |
4755096e | 3697 | |
50e34432 | 3698 | =over 4 |
4755096e | 3699 | |
50e34432 | 3700 | =item Unicode |
4755096e | 3701 | |
50e34432 | 3702 | =item Perl's Unicode Support |
4755096e | 3703 | |
50e34432 | 3704 | =item Perl's Unicode Model |
4755096e | 3705 | |
50e34432 | 3706 | =item Unicode and EBCDIC |
4755096e | 3707 | |
50e34432 | 3708 | =item Creating Unicode |
4755096e | 3709 | |
50e34432 | 3710 | =item Handling Unicode |
4755096e | 3711 | |
50e34432 | 3712 | =item Legacy Encodings |
4755096e | 3713 | |
50e34432 | 3714 | =item Unicode I/O |
4755096e | 3715 | |
50e34432 | 3716 | =item Displaying Unicode As Text |
4755096e | 3717 | |
50e34432 | 3718 | =item Special Cases |
4755096e | 3719 | |
50e34432 | 3720 | =item Advanced Topics |
4755096e | 3721 | |
50e34432 | 3722 | =item Miscellaneous |
4755096e | 3723 | |
50e34432 | 3724 | =item Questions With Answers |
4755096e | 3725 | |
50e34432 | 3726 | =item Hexadecimal Notation |
4755096e | 3727 | |
50e34432 | 3728 | =item Further Resources |
4755096e | 3729 | |
50e34432 | 3730 | =back |
4755096e | 3731 | |
50e34432 | 3732 | =item UNICODE IN OLDER PERLS |
4755096e | 3733 | |
50e34432 | 3734 | =item SEE ALSO |
4755096e | 3735 | |
50e34432 | 3736 | =item ACKNOWLEDGMENTS |
4755096e | 3737 | |
50e34432 | 3738 | =item AUTHOR, COPYRIGHT, AND LICENSE |
4755096e GS |
3739 | |
3740 | =back | |
3741 | ||
50e34432 | 3742 | =head2 perlunicode - Unicode support in Perl |
4755096e | 3743 | |
d420ca49 | 3744 | =over 4 |
4755096e GS |
3745 | |
3746 | =item DESCRIPTION | |
3747 | ||
d420ca49 | 3748 | =over 4 |
4755096e | 3749 | |
50e34432 | 3750 | =item Important Caveats |
4755096e | 3751 | |
50e34432 | 3752 | Input and Output Layers, Regular Expressions, C<use utf8> still needed to |
d3ca9f77 NC |
3753 | enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts |
3754 | autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings | |
4755096e | 3755 | |
50e34432 | 3756 | =item Byte and Character Semantics |
4755096e | 3757 | |
50e34432 | 3758 | =item Effects of Character Semantics |
35c7d401 | 3759 | |
50e34432 | 3760 | =item Scripts |
4755096e | 3761 | |
50e34432 | 3762 | =item Blocks |
4755096e | 3763 | |
50e34432 | 3764 | =item User-Defined Character Properties |
4755096e | 3765 | |
50e34432 | 3766 | =item Character Encodings for Input and Output |
4755096e | 3767 | |
50e34432 | 3768 | =item Unicode Regular Expression Support Level |
4755096e | 3769 | |
50e34432 | 3770 | =item Unicode Encodings |
4755096e | 3771 | |
50e34432 | 3772 | =item Security Implications of Unicode |
4755096e | 3773 | |
50e34432 | 3774 | =item Unicode in Perl on EBCDIC |
4755096e | 3775 | |
50e34432 | 3776 | =item Locales |
4755096e | 3777 | |
50e34432 | 3778 | =item When Unicode Does Not Happen |
4755096e | 3779 | |
50e34432 | 3780 | =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl) |
4755096e | 3781 | |
50e34432 | 3782 | =item Using Unicode in XS |
4755096e | 3783 | |
50e34432 | 3784 | =back |
4755096e | 3785 | |
50e34432 | 3786 | =item BUGS |
4755096e | 3787 | |
50e34432 | 3788 | =over 4 |
4755096e | 3789 | |
50e34432 | 3790 | =item Interaction with Locales |
4755096e | 3791 | |
50e34432 | 3792 | =item Interaction with Extensions |
1fa7ca25 | 3793 | |
50e34432 | 3794 | =item Speed |
4755096e | 3795 | |
50e34432 | 3796 | =item Porting code from perl-5.6.X |
4755096e | 3797 | |
50e34432 | 3798 | =back |
4755096e | 3799 | |
50e34432 | 3800 | =item SEE ALSO |
4755096e | 3801 | |
50e34432 | 3802 | =back |
4755096e | 3803 | |
50e34432 | 3804 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms |
4755096e | 3805 | |
50e34432 | 3806 | =over 4 |
4755096e | 3807 | |
50e34432 | 3808 | =item DESCRIPTION |
4755096e | 3809 | |
50e34432 | 3810 | =item COMMON CHARACTER CODE SETS |
4755096e | 3811 | |
50e34432 | 3812 | =over 4 |
4755096e | 3813 | |
50e34432 | 3814 | =item ASCII |
4755096e | 3815 | |
50e34432 | 3816 | =item ISO 8859 |
4755096e | 3817 | |
50e34432 | 3818 | =item Latin 1 (ISO 8859-1) |
4755096e | 3819 | |
50e34432 | 3820 | =item EBCDIC |
4755096e | 3821 | |
50e34432 | 3822 | =item 13 variant characters |
4755096e | 3823 | |
50e34432 JH |
3824 | =item 0037 |
3825 | ||
3826 | =item 1047 | |
3827 | ||
3828 | =item POSIX-BC | |
3829 | ||
3830 | =item Unicode code points versus EBCDIC code points | |
3831 | ||
3832 | =item Remaining Perl Unicode problems in EBCDIC | |
3833 | ||
3834 | =item Unicode and UTF | |
3835 | ||
3836 | =item Using Encode | |
4755096e GS |
3837 | |
3838 | =back | |
3839 | ||
50e34432 JH |
3840 | =item SINGLE OCTET TABLES |
3841 | ||
3842 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 | |
3843 | ||
3844 | =item IDENTIFYING CHARACTER CODE SETS | |
3845 | ||
3846 | =item CONVERSIONS | |
3847 | ||
3848 | =over 4 | |
3849 | ||
3850 | =item tr/// | |
3851 | ||
3852 | =item iconv | |
3853 | ||
3854 | =item C RTL | |
4755096e GS |
3855 | |
3856 | =back | |
3857 | ||
50e34432 JH |
3858 | =item OPERATOR DIFFERENCES |
3859 | ||
3860 | =item FUNCTION DIFFERENCES | |
3861 | ||
3862 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() | |
3863 | ||
3864 | =item REGULAR EXPRESSION DIFFERENCES | |
3865 | ||
3866 | =item SOCKETS | |
3867 | ||
3868 | =item SORTING | |
4755096e | 3869 | |
d420ca49 | 3870 | =over 4 |
4755096e | 3871 | |
50e34432 JH |
3872 | =item Ignore ASCII vs. EBCDIC sort differences. |
3873 | ||
3874 | =item MONO CASE then sort data. | |
3875 | ||
3876 | =item Convert, sort data, then re convert. | |
3877 | ||
3878 | =item Perform sorting on one type of machine only. | |
3879 | ||
3880 | =back | |
3881 | ||
3882 | =item TRANSFORMATION FORMATS | |
4755096e | 3883 | |
d420ca49 | 3884 | =over 4 |
4755096e | 3885 | |
50e34432 | 3886 | =item URL decoding and encoding |
4755096e | 3887 | |
50e34432 | 3888 | =item uu encoding and decoding |
4755096e | 3889 | |
50e34432 | 3890 | =item Quoted-Printable encoding and decoding |
4755096e | 3891 | |
50e34432 | 3892 | =item Caesarian ciphers |
4755096e | 3893 | |
50e34432 | 3894 | =back |
4755096e | 3895 | |
50e34432 | 3896 | =item Hashing order and checksums |
4755096e | 3897 | |
50e34432 | 3898 | =item I18N AND L10N |
4755096e | 3899 | |
50e34432 | 3900 | =item MULTI OCTET CHARACTER SETS |
4755096e | 3901 | |
50e34432 | 3902 | =item OS ISSUES |
4755096e | 3903 | |
50e34432 | 3904 | =over 4 |
4755096e | 3905 | |
50e34432 | 3906 | =item OS/400 |
4755096e | 3907 | |
50e34432 | 3908 | PASE, IFS access |
4755096e | 3909 | |
50e34432 | 3910 | =item OS/390, z/OS |
4755096e | 3911 | |
50e34432 | 3912 | chcp, dataset access, OS/390, z/OS iconv, locales |
4755096e | 3913 | |
50e34432 | 3914 | =item VM/ESA? |
4755096e | 3915 | |
50e34432 | 3916 | =item POSIX-BC? |
4755096e | 3917 | |
50e34432 | 3918 | =back |
4755096e | 3919 | |
50e34432 | 3920 | =item BUGS |
4755096e | 3921 | |
50e34432 | 3922 | =item SEE ALSO |
4755096e | 3923 | |
50e34432 | 3924 | =item REFERENCES |
4755096e | 3925 | |
50e34432 | 3926 | =item HISTORY |
4755096e | 3927 | |
50e34432 | 3928 | =item AUTHOR |
4755096e | 3929 | |
50e34432 | 3930 | =back |
4755096e | 3931 | |
50e34432 JH |
3932 | =head2 perlsec - Perl security |
3933 | ||
3934 | =over 4 | |
3935 | ||
3936 | =item DESCRIPTION | |
3937 | ||
3938 | =over 4 | |
3939 | ||
3940 | =item Laundering and Detecting Tainted Data | |
3941 | ||
3942 | =item Switches On the "#!" Line | |
3943 | ||
7a5cdbdf AJ |
3944 | =item Taint mode and @INC |
3945 | ||
50e34432 JH |
3946 | =item Cleaning Up Your Path |
3947 | ||
3948 | =item Security Bugs | |
3949 | ||
3950 | =item Protecting Your Programs | |
3951 | ||
3952 | =item Unicode | |
3953 | ||
3954 | =item Algorithmic Complexity Attacks | |
4755096e GS |
3955 | |
3956 | =back | |
3957 | ||
50e34432 | 3958 | =item SEE ALSO |
4755096e GS |
3959 | |
3960 | =back | |
3961 | ||
50e34432 | 3962 | =head2 perlmod - Perl modules (packages and symbol tables) |
4755096e | 3963 | |
d420ca49 | 3964 | =over 4 |
4755096e GS |
3965 | |
3966 | =item DESCRIPTION | |
3967 | ||
d420ca49 | 3968 | =over 4 |
4755096e | 3969 | |
50e34432 | 3970 | =item Packages |
b40eed9c | 3971 | X<package> X<namespace> X<variable, global> X<global variable> X<global> |
4755096e | 3972 | |
50e34432 | 3973 | =item Symbol Tables |
b40eed9c | 3974 | X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias> |
4755096e | 3975 | |
7a5cdbdf | 3976 | =item BEGIN, CHECK, INIT and END |
b40eed9c | 3977 | X<BEGIN> X<CHECK> X<INIT> X<END> |
4755096e | 3978 | |
50e34432 | 3979 | =item Perl Classes |
b40eed9c | 3980 | X<class> X<@ISA> |
68dc0745 | 3981 | |
50e34432 | 3982 | =item Perl Modules |
b40eed9c | 3983 | X<module> |
68dc0745 | 3984 | |
50e34432 | 3985 | =item Making your module threadsafe |
b40eed9c NC |
3986 | X<threadsafe> X<thread safe> |
3987 | X<module, threadsafe> X<module, thread safe> | |
3988 | X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread> | |
68dc0745 | 3989 | |
50e34432 | 3990 | =back |
68dc0745 | 3991 | |
50e34432 | 3992 | =item SEE ALSO |
68dc0745 | 3993 | |
50e34432 | 3994 | =back |
68dc0745 | 3995 | |
50e34432 | 3996 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
68dc0745 | 3997 | |
50e34432 | 3998 | =over 4 |
68dc0745 | 3999 | |
50e34432 | 4000 | =item THE PERL MODULE LIBRARY |
68dc0745 | 4001 | |
50e34432 | 4002 | =over 4 |
46fc3d4c | 4003 | |
50e34432 | 4004 | =item Pragmatic Modules |
68dc0745 | 4005 | |
e1114e52 NC |
4006 | assertions::compat, attributes, attrs, autouse, base, bigint, bignum, |
4007 | bigrat, blib, bytes, charnames, constant, diagnostics, encoding, fields, | |
4008 | filetest, if, integer, less, lib, locale, open, ops, overload, re, sigtrap, | |
4009 | sort, strict, subs, threads, threads::shared, utf8, vars, vmsish, warnings, | |
4010 | warnings::register | |
68dc0745 | 4011 | |
50e34432 | 4012 | =item Standard Modules |
68dc0745 | 4013 | |
e1114e52 NC |
4014 | AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers, |
4015 | AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, | |
4016 | B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, | |
4017 | B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, | |
4018 | ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, | |
4019 | CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, | |
4020 | CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct, Compress::Zlib, | |
4021 | Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, | |
4022 | Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::base, | |
4023 | DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte, | |
4024 | Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config, | |
4025 | Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess, | |
4026 | Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, | |
6a5cae29 JH |
4027 | Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO, |
4028 | Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode, | |
4029 | Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy, | |
e1114e52 | 4030 | ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows, |
6a5cae29 JH |
4031 | ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, |
4032 | ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, | |
e1114e52 NC |
4033 | ExtUtils::MM, ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, |
4034 | ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, ExtUtils::MM_MacOS, | |
4035 | ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX, ExtUtils::MM_UWIN, | |
4036 | ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS, ExtUtils::MM_Win32, | |
50e34432 | 4037 | ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, |
e1114e52 NC |
4038 | ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ, |
4039 | ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes, | |
4040 | ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap, | |
4041 | ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS, | |
4042 | ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, | |
4043 | File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob, | |
4044 | File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, | |
50e34432 JH |
4045 | File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, |
4046 | File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, | |
4047 | FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File, | |
4048 | Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags, | |
4049 | I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle, | |
4050 | IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, | |
e1114e52 NC |
4051 | IO::Socket::UNIX, IO::Zlib, IPC::Open2, IPC::Open3, IPC::SysV, |
4052 | IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util, Locale::Constants, | |
4053 | Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, | |
50e34432 JH |
4054 | Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, |
4055 | MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, | |
e1114e52 NC |
4056 | Math::BigInt::Calc, Math::BigInt::FastCalc, Math::BigRat, Math::Complex, |
4057 | Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, | |
4058 | Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, | |
4059 | Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd, | |
4060 | Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, | |
4061 | Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, | |
4062 | Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, | |
4063 | PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, | |
4064 | Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, | |
4065 | Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, | |
50e34432 JH |
4066 | Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, |
4067 | Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, | |
4068 | Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, | |
4069 | Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, | |
4070 | Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, | |
4071 | Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, | |
4072 | Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap, | |
4073 | Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness, | |
e1114e52 NC |
4074 | Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point, |
4075 | Test::Harness::Straps, Test::More, Test::Simple, Test::Tutorial, | |
4076 | Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, | |
4077 | Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, | |
4078 | Thread::Specific, Tie::Array, Tie::File, Tie::Handle, Tie::Hash, | |
4079 | Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes, | |
4080 | Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, | |
4081 | Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent, | |
4082 | User::pwent, Win32, XS::APItest, XS::Typemap, XSLoader | |
68dc0745 | 4083 | |
50e34432 | 4084 | =item Extension Modules |
68dc0745 | 4085 | |
50e34432 | 4086 | =back |
68dc0745 | 4087 | |
50e34432 JH |
4088 | =item CPAN |
4089 | ||
4090 | =over 4 | |
4091 | ||
4092 | =item Africa | |
4093 | ||
4094 | South Africa | |
4095 | ||
4096 | =item Asia | |
4097 | ||
4098 | China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi | |
4ed3c8ae | 4099 | Arabia, Singapore, South Korea, Taiwan, Thailand |
50e34432 JH |
4100 | |
4101 | =item Central America | |
4102 | ||
4103 | Costa Rica | |
4104 | ||
4105 | =item Europe | |
4106 | ||
4ed3c8ae JH |
4107 | Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech |
4108 | Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, | |
4109 | Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland, | |
4110 | Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland, | |
4111 | Turkey, Ukraine, United Kingdom | |
50e34432 JH |
4112 | |
4113 | =item North America | |
4114 | ||
4115 | Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, | |
4116 | Alabama, California, Colorado, Delaware, District of Columbia, Florida, | |
4ed3c8ae JH |
4117 | Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York, |
4118 | North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah, | |
4119 | Virginia, Washington, Wisconsin | |
50e34432 JH |
4120 | |
4121 | =item Oceania | |
68dc0745 | 4122 | |
50e34432 | 4123 | Australia, New Zealand, United States |
68dc0745 | 4124 | |
50e34432 | 4125 | =item South America |
68dc0745 | 4126 | |
50e34432 | 4127 | Argentina, Brazil, Chile |
68dc0745 | 4128 | |
50e34432 | 4129 | =item RSYNC Mirrors |
68dc0745 | 4130 | |
50e34432 | 4131 | =back |
68dc0745 | 4132 | |
50e34432 | 4133 | =item Modules: Creation, Use, and Abuse |
68dc0745 | 4134 | |
50e34432 | 4135 | =over 4 |
46fc3d4c | 4136 | |
50e34432 | 4137 | =item Guidelines for Module Creation |
14218588 | 4138 | |
50e34432 | 4139 | =item Guidelines for Converting Perl 4 Library Scripts into Modules |
14218588 | 4140 | |
50e34432 | 4141 | =item Guidelines for Reusing Application Code |
35c7d401 | 4142 | |
68dc0745 | 4143 | =back |
4144 | ||
50e34432 | 4145 | =item NOTE |
68dc0745 | 4146 | |
a45bd81d GS |
4147 | =back |
4148 | ||
50e34432 | 4149 | =head2 perlmodstyle - Perl module style guide |
68dc0745 | 4150 | |
d420ca49 | 4151 | =over 4 |
a45bd81d | 4152 | |
50e34432 JH |
4153 | =item INTRODUCTION |
4154 | ||
4155 | =item QUICK CHECKLIST | |
68dc0745 | 4156 | |
d420ca49 | 4157 | =over 4 |
68dc0745 | 4158 | |
50e34432 | 4159 | =item Before you start |
68dc0745 | 4160 | |
50e34432 | 4161 | =item The API |
68dc0745 | 4162 | |
50e34432 | 4163 | =item Stability |
68dc0745 | 4164 | |
50e34432 | 4165 | =item Documentation |
68dc0745 | 4166 | |
50e34432 | 4167 | =item Release considerations |
fb9cefb4 | 4168 | |
50e34432 | 4169 | =back |
fb9cefb4 | 4170 | |
50e34432 | 4171 | =item BEFORE YOU START WRITING A MODULE |
fb9cefb4 | 4172 | |
50e34432 | 4173 | =over 4 |
fb9cefb4 | 4174 | |
50e34432 | 4175 | =item Has it been done before? |
fb9cefb4 | 4176 | |
50e34432 | 4177 | =item Do one thing and do it well |
68dc0745 | 4178 | |
50e34432 | 4179 | =item What's in a name? |
68dc0745 | 4180 | |
50e34432 | 4181 | =back |
68dc0745 | 4182 | |
50e34432 | 4183 | =item DESIGNING AND WRITING YOUR MODULE |
68dc0745 | 4184 | |
50e34432 | 4185 | =over 4 |
68dc0745 | 4186 | |
50e34432 | 4187 | =item To OO or not to OO? |
68dc0745 | 4188 | |
50e34432 | 4189 | =item Designing your API |
68dc0745 | 4190 | |
50e34432 JH |
4191 | Write simple routines to do simple things, Separate functionality from |
4192 | output, Provide sensible shortcuts and defaults, Naming conventions, | |
4193 | Parameter passing | |
68dc0745 | 4194 | |
50e34432 | 4195 | =item Strictness and warnings |
68dc0745 | 4196 | |
50e34432 | 4197 | =item Backwards compatibility |
68dc0745 | 4198 | |
50e34432 | 4199 | =item Error handling and messages |
68dc0745 | 4200 | |
50e34432 | 4201 | =back |
68dc0745 | 4202 | |
50e34432 | 4203 | =item DOCUMENTING YOUR MODULE |
68dc0745 | 4204 | |
50e34432 | 4205 | =over 4 |
68dc0745 | 4206 | |
50e34432 | 4207 | =item POD |
68dc0745 | 4208 | |
50e34432 | 4209 | =item README, INSTALL, release notes, changelogs |
68dc0745 | 4210 | |
50e34432 JH |
4211 | perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build, |
4212 | perl Build test, perl Build install | |
68dc0745 | 4213 | |
50e34432 | 4214 | =back |
3fe9a6f1 | 4215 | |
50e34432 | 4216 | =item RELEASE CONSIDERATIONS |
68dc0745 | 4217 | |
50e34432 | 4218 | =over 4 |
68dc0745 | 4219 | |
50e34432 | 4220 | =item Version numbering |
68dc0745 | 4221 | |
50e34432 | 4222 | =item Pre-requisites |
68dc0745 | 4223 | |
50e34432 | 4224 | =item Testing |
68dc0745 | 4225 | |
50e34432 | 4226 | =item Packaging |
68dc0745 | 4227 | |
50e34432 | 4228 | =item Licensing |
68dc0745 | 4229 | |
50e34432 | 4230 | =back |
68dc0745 | 4231 | |
50e34432 | 4232 | =item COMMON PITFALLS |
68dc0745 | 4233 | |
50e34432 | 4234 | =over 4 |
68dc0745 | 4235 | |
50e34432 | 4236 | =item Reinventing the wheel |
68dc0745 | 4237 | |
50e34432 | 4238 | =item Trying to do too much |
68dc0745 | 4239 | |
50e34432 | 4240 | =item Inappropriate documentation |
68dc0745 | 4241 | |
50e34432 | 4242 | =back |
68dc0745 | 4243 | |
50e34432 | 4244 | =item SEE ALSO |
68dc0745 | 4245 | |
50e34432 JH |
4246 | L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools, |
4247 | Testing tools, http://pause.perl.org/, Any good book on software | |
4248 | engineering | |
68dc0745 | 4249 | |
50e34432 | 4250 | =item AUTHOR |
68dc0745 | 4251 | |
50e34432 | 4252 | =back |
68dc0745 | 4253 | |
50e34432 | 4254 | =head2 perlmodinstall - Installing CPAN Modules |
68dc0745 | 4255 | |
50e34432 | 4256 | =over 4 |
68dc0745 | 4257 | |
50e34432 | 4258 | =item DESCRIPTION |
68dc0745 | 4259 | |
50e34432 | 4260 | =over 4 |
fb9cefb4 | 4261 | |
50e34432 | 4262 | =item PREAMBLE |
46fc3d4c | 4263 | |
50e34432 JH |
4264 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
4265 | module (sometimes unnecessary), B<INSTALL> the module | |
46fc3d4c | 4266 | |
50e34432 | 4267 | =back |
46fc3d4c | 4268 | |
50e34432 | 4269 | =item PORTABILITY |
14218588 | 4270 | |
50e34432 | 4271 | =item HEY |
68dc0745 | 4272 | |
50e34432 JH |
4273 | =item AUTHOR |
4274 | ||
4275 | =item COPYRIGHT | |
fc36a67e | 4276 | |
a45bd81d GS |
4277 | =back |
4278 | ||
50e34432 | 4279 | =head2 perlnewmod - preparing a new module for distribution |
68dc0745 | 4280 | |
d420ca49 | 4281 | =over 4 |
a45bd81d | 4282 | |
68dc0745 | 4283 | =item DESCRIPTION |
4284 | ||
d420ca49 | 4285 | =over 4 |
68dc0745 | 4286 | |
50e34432 | 4287 | =item Warning |
fb9cefb4 | 4288 | |
50e34432 | 4289 | =item What should I make into a module? |
68dc0745 | 4290 | |
50e34432 | 4291 | =item Step-by-step: Preparing the ground |
68dc0745 | 4292 | |
50e34432 | 4293 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
68dc0745 | 4294 | |
50e34432 | 4295 | =item Step-by-step: Making the module |
68dc0745 | 4296 | |
a2db77eb NC |
4297 | Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and |
4298 | L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, | |
4299 | Use L<plain old documentation|perlpod>, Write tests, Write the README | |
68dc0745 | 4300 | |
50e34432 | 4301 | =item Step-by-step: Distributing your module |
68dc0745 | 4302 | |
50e34432 JH |
4303 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
4304 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
fb9cefb4 | 4305 | |
50e34432 | 4306 | =back |
68dc0745 | 4307 | |
50e34432 | 4308 | =item AUTHOR |
68dc0745 | 4309 | |
50e34432 | 4310 | =item SEE ALSO |
68dc0745 | 4311 | |
50e34432 | 4312 | =back |
68dc0745 | 4313 | |
50e34432 | 4314 | =head2 perlutil - utilities packaged with the Perl distribution |
46fc3d4c | 4315 | |
50e34432 | 4316 | =over 4 |
68dc0745 | 4317 | |
50e34432 | 4318 | =item DESCRIPTION |
68dc0745 | 4319 | |
50e34432 | 4320 | =over 4 |
68dc0745 | 4321 | |
50e34432 | 4322 | =item DOCUMENTATION |
68dc0745 | 4323 | |
50e34432 JH |
4324 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, |
4325 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
4326 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
4327 | L<roffitall|roffitall> | |
68dc0745 | 4328 | |
50e34432 | 4329 | =item CONVERTORS |
fb9cefb4 | 4330 | |
50e34432 | 4331 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
2d967e39 | 4332 | |
50e34432 | 4333 | =item Administration |
68dc0745 | 4334 | |
50e34432 | 4335 | L<libnetcfg|libnetcfg> |
68dc0745 | 4336 | |
50e34432 | 4337 | =item Development |
68dc0745 | 4338 | |
50e34432 JH |
4339 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
4340 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
68dc0745 | 4341 | |
50e34432 | 4342 | =item SEE ALSO |
68dc0745 | 4343 | |
4344 | =back | |
4345 | ||
a45bd81d GS |
4346 | =back |
4347 | ||
4755096e | 4348 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
a45bd81d | 4349 | |
d420ca49 | 4350 | =over 4 |
cb1a09d0 | 4351 | |
8ebc5c01 | 4352 | =item DESCRIPTION |
cb1a09d0 | 4353 | |
d420ca49 | 4354 | =over 4 |
fb9cefb4 | 4355 | |
4755096e | 4356 | =item Layout |
a45bd81d | 4357 | |
4755096e | 4358 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
637e9122 | 4359 | |
4755096e | 4360 | =back |
c76ac1ee | 4361 | |
4755096e | 4362 | =item Using The Back Ends |
c76ac1ee | 4363 | |
d420ca49 | 4364 | =over 4 |
694468e3 | 4365 | |
4755096e | 4366 | =item The Cross Referencing Back End |
c76ac1ee | 4367 | |
4755096e | 4368 | i, &, s, r |
637e9122 | 4369 | |
4755096e | 4370 | =item The Decompiling Back End |
37590e52 | 4371 | |
4755096e | 4372 | =item The Lint Back End |
c76ac1ee | 4373 | |
4755096e | 4374 | =item The Simple C Back End |
37590e52 | 4375 | |
4755096e | 4376 | =item The Bytecode Back End |
a45bd81d | 4377 | |
4755096e | 4378 | =item The Optimized C Back End |
a45bd81d | 4379 | |
4755096e | 4380 | =back |
b38f6a39 | 4381 | |
e993db8c JH |
4382 | =item Module List for the Compiler Suite |
4383 | ||
4384 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, | |
4385 | B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, | |
4386 | B::Stackobj, B::Stash, B::Terse, B::Xref | |
4387 | ||
4755096e | 4388 | =item KNOWN PROBLEMS |
fb9cefb4 | 4389 | |
4755096e | 4390 | =item AUTHOR |
c76ac1ee | 4391 | |
4755096e | 4392 | =back |
a45bd81d | 4393 | |
50e34432 JH |
4394 | =head2 perlfilter - Source Filters |
4395 | ||
4396 | =over 4 | |
4397 | ||
4398 | =item DESCRIPTION | |
4399 | ||
4400 | =item CONCEPTS | |
4401 | ||
4402 | =item USING FILTERS | |
4403 | ||
4404 | =item WRITING A SOURCE FILTER | |
4405 | ||
4406 | =item WRITING A SOURCE FILTER IN C | |
4407 | ||
4408 | B<Decryption Filters> | |
4409 | ||
4410 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE | |
4411 | ||
4412 | =item WRITING A SOURCE FILTER IN PERL | |
4413 | ||
4414 | =item USING CONTEXT: THE DEBUG FILTER | |
4415 | ||
4416 | =item CONCLUSION | |
4417 | ||
4418 | =item THINGS TO LOOK OUT FOR | |
4419 | ||
4420 | Some Filters Clobber the C<DATA> Handle | |
4421 | ||
4422 | =item REQUIREMENTS | |
4423 | ||
4424 | =item AUTHOR | |
4425 | ||
4426 | =item Copyrights | |
4427 | ||
4428 | =back | |
4429 | ||
e1114e52 NC |
4430 | =head2 perlglossary - Perl Glossary |
4431 | ||
4432 | =over 4 | |
4433 | ||
4434 | =item DESCRIPTION | |
4435 | ||
4436 | =over 4 | |
4437 | ||
4438 | =item A | |
4439 | ||
4440 | accessor methods, actual arguments, address operator, algorithm, alias, | |
4441 | alternatives, anonymous, architecture, argument, ARGV, arithmetical | |
4442 | operator, array, array context, ASCII, assertion, assignment, assignment | |
4443 | operator, associative array, associativity, asynchronous, atom, atomic | |
4444 | operation, attribute, autogeneration, autoincrement, autoload, autosplit, | |
4445 | autovivification, AV, awk | |
4446 | ||
4447 | =item B | |
4448 | ||
4449 | backreference, backtracking, backward compatibility, bareword, base class, | |
4450 | big-endian, binary, binary operator, bind, bit, bit shift, bit string, | |
4451 | bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint, | |
4452 | broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode | |
4453 | ||
4454 | =item C | |
4455 | ||
4456 | C, C preprocessor, call by reference, call by value, callback, canonical, | |
4457 | capturing, character, character class, character property, circumfix | |
4458 | operator, class, class method, client, cloister, closure, cluster, CODE, | |
4459 | code generator, code subpattern, collating sequence, command, command | |
4460 | buffering, command name, command-line arguments, comment, compilation unit, | |
4461 | compile phase, compile time, compiler, composer, concatenation, | |
4462 | conditional, connection, construct, constructor, context, continuation, | |
4463 | core dump, CPAN, cracker, current package, current working directory, | |
4464 | currently selected output channel, CV | |
4465 | ||
4466 | =item D | |
4467 | ||
4468 | dangling statement, data structure, data type, datagram, DBM, declaration, | |
4469 | decrement, default, defined, delimiter, dereference, derived class, | |
4470 | descriptor, destroy, destructor, device, directive, directory, directory | |
4471 | handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping | |
4472 | ||
4473 | =item E | |
4474 | ||
4475 | eclectic, element, embedding, empty subclass test, en passant, | |
4476 | encapsulation, endian, environment, environment variable, EOF, errno, | |
4477 | error, escape sequence, exception, exception handling, exec, executable | |
4478 | file, execute, execute bit, exit status, export, expression, extension | |
4479 | ||
4480 | =item F | |
4481 | ||
4482 | false, FAQ, fatal error, field, FIFO, file, file descriptor, file test | |
4483 | operator, fileglob, filehandle, filename, filesystem, filter, flag, | |
4484 | floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely | |
4485 | available, freely redistributable, freeware, function, funny character, | |
4486 | garbage collection | |
4487 | ||
4488 | =item G | |
4489 | ||
4490 | GID, glob, global, global destruction, glue language, granularity, greedy, | |
4491 | grep, group, GV | |
4492 | ||
4493 | =item H | |
4494 | ||
4495 | hacker, handler, hard reference, hash, hash table, header file, here | |
4496 | document, hexadecimal, home directory, host, hubris, HV | |
4497 | ||
4498 | =item I | |
4499 | ||
4500 | identifier, impatience, implementation, import, increment, indexing, | |
4501 | indirect filehandle, indirect object, indirect object slot, indirection, | |
4502 | infix, inheritance, instance, instance variable, integer, interface, | |
4503 | interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a, | |
4504 | iteration, iterator, IV | |
4505 | ||
4506 | =item J | |
4507 | ||
4508 | JAPH | |
4509 | ||
4510 | =item K | |
4511 | ||
4512 | key, keyword | |
4513 | ||
4514 | =item L | |
4515 | ||
4516 | label, laziness, left shift, leftmost longest, lexeme, lexer, lexical | |
4517 | analysis, lexical scoping, lexical variable, library, LIFO, line, line | |
4518 | buffering, line number, link, LIST, list, list context, list operator, list | |
4519 | value, literal, little-endian, local, logical operator, lookahead, | |
4520 | lookbehind, loop, loop control statement, loop label, lvaluable, lvalue, | |
4521 | lvalue modifier | |
4522 | ||
4523 | =item M | |
4524 | ||
4525 | magic, magical increment, magical variables, Makefile, man, manpage, | |
4526 | matching, member data, memory, metacharacter, metasymbol, method, | |
4527 | minimalism, mode, modifier, module, modulus, monger, mortal, | |
4528 | multidimensional array, multiple inheritance | |
4529 | ||
4530 | =item N | |
4531 | ||
4532 | named pipe, namespace, network address, newline, NFS, null character, null | |
4533 | list, null string, numeric context, NV, nybble | |
4534 | ||
4535 | =item O | |
4536 | ||
4537 | object, octal, offset, one-liner, open source software, operand, operating | |
4538 | system, operator, operator overloading, options, overloading, overriding, | |
4539 | owner | |
4540 | ||
4541 | =item P | |
4542 | ||
4543 | package, pad, parameter, parent class, parse tree, parsing, patch, PATH, | |
4544 | pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline, | |
4545 | platform, pod, pointer, polymorphism, port, portable, porter, POSIX, | |
4546 | postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process, | |
4547 | program generator, progressive matching, property, protocol, prototype, | |
4548 | pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin, | |
4549 | pumpking, PV | |
4550 | ||
4551 | =item Q | |
4552 | ||
4553 | qualified, quantifier | |
4554 | ||
4555 | =item R | |
4556 | ||
4557 | readable, reaping, record, recursion, reference, referent, regex, regular | |
4558 | expression, regular expression modifier, regular file, relational operator, | |
4559 | reserved words, return value, RFC, right shift, root, RTFM, run phase, run | |
4560 | time, run-time pattern, RV, rvalue | |
4561 | ||
4562 | =item S | |
4563 | ||
4564 | scalar, scalar context, scalar literal, scalar value, scalar variable, | |
4565 | scope, scratchpad, script, script kiddie, sed, semaphore, separator, | |
4566 | serialization, server, service, setgid, setuid, shared memory, shebang, | |
4567 | shell, side effects, signal, signal handler, single inheritance, slice, | |
4568 | slurp, socket, soft reference, source filter, stack, standard, standard | |
4569 | error, standard I/O, standard input, standard output, stat structure, | |
4570 | statement, statement modifier, static, static method, static scoping, | |
4571 | static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string, | |
4572 | string context, stringification, struct, structure, subclass, subpattern, | |
4573 | subroutine, subscript, substitution, substring, superclass, superuser, SV, | |
4574 | switch, switch cluster, switch statement, symbol, symbol table, symbolic | |
4575 | debugger, symbolic link, symbolic reference, synchronous, syntactic sugar, | |
4576 | syntax, syntax tree, syscall | |
4577 | ||
4578 | =item T | |
4579 | ||
4580 | tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI, | |
4581 | token, tokener, tokenizing, toolbox approach, transliterate, trigger, | |
4582 | trinary, troff, true, truncating, type, type casting, typed lexical, | |
4583 | typedef, typeglob, typemap | |
4584 | ||
4585 | =item U | |
4586 | ||
4587 | UDP, UID, umask, unary operator, Unicode, Unix | |
4588 | ||
4589 | =item V | |
4590 | ||
4591 | value, variable, variable interpolation, variadic, vector, virtual, void | |
4592 | context, v-string | |
4593 | ||
4594 | =item W | |
4595 | ||
4596 | warning, watch expression, whitespace, word, working directory, wrapper, | |
4597 | WYSIWYG | |
4598 | ||
4599 | =item X | |
4600 | ||
4601 | XS, XSUB | |
4602 | ||
4603 | =item Y | |
4604 | ||
4605 | yacc | |
4606 | ||
4607 | =item Z | |
4608 | ||
4609 | zero width, zombie | |
4610 | ||
4611 | =back | |
4612 | ||
4613 | =item AUTHOR AND COPYRIGHT | |
4614 | ||
4615 | =back | |
4616 | ||
4755096e | 4617 | =head2 perlembed - how to embed perl in your C program |
c76ac1ee | 4618 | |
d420ca49 | 4619 | =over 4 |
a45bd81d | 4620 | |
4755096e | 4621 | =item DESCRIPTION |
fb9cefb4 | 4622 | |
d420ca49 | 4623 | =over 4 |
c76ac1ee | 4624 | |
4755096e | 4625 | =item PREAMBLE |
fb9cefb4 | 4626 | |
4755096e GS |
4627 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
4628 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
fb9cefb4 | 4629 | |
4755096e | 4630 | =item ROADMAP |
fb9cefb4 | 4631 | |
4755096e | 4632 | =item Compiling your C program |
c76ac1ee | 4633 | |
4755096e | 4634 | =item Adding a Perl interpreter to your C program |
c76ac1ee | 4635 | |
4755096e | 4636 | =item Calling a Perl subroutine from your C program |
fb9cefb4 | 4637 | |
4755096e | 4638 | =item Evaluating a Perl statement from your C program |
c76ac1ee | 4639 | |
4755096e | 4640 | =item Performing Perl pattern matches and substitutions from your C program |
c76ac1ee | 4641 | |
4755096e | 4642 | =item Fiddling with the Perl stack from your C program |
37590e52 | 4643 | |
4755096e | 4644 | =item Maintaining a persistent interpreter |
c76ac1ee | 4645 | |
53d7eaa8 JH |
4646 | =item Execution of END blocks |
4647 | ||
4755096e | 4648 | =item Maintaining multiple interpreter instances |
694468e3 | 4649 | |
4755096e GS |
4650 | =item Using Perl modules, which themselves use C libraries, from your C |
4651 | program | |
c76ac1ee | 4652 | |
14218588 | 4653 | =back |
fb9cefb4 | 4654 | |
d420ca49 | 4655 | =item Embedding Perl under Win32 |
fb9cefb4 | 4656 | |
35c7d401 JH |
4657 | =item Hiding Perl_ |
4658 | ||
4755096e | 4659 | =item MORAL |
c76ac1ee | 4660 | |
4755096e | 4661 | =item AUTHOR |
fb9cefb4 | 4662 | |
4755096e | 4663 | =item COPYRIGHT |
c76ac1ee | 4664 | |
4755096e | 4665 | =back |
c76ac1ee | 4666 | |
4755096e | 4667 | =head2 perldebguts - Guts of Perl debugging |
a45bd81d | 4668 | |
d420ca49 | 4669 | =over 4 |
c76ac1ee | 4670 | |
4755096e | 4671 | =item DESCRIPTION |
c76ac1ee | 4672 | |
4755096e | 4673 | =item Debugger Internals |
c76ac1ee | 4674 | |
d420ca49 | 4675 | =over 4 |
c76ac1ee | 4676 | |
4755096e | 4677 | =item Writing Your Own Debugger |
c76ac1ee | 4678 | |
37590e52 | 4679 | =back |
c76ac1ee | 4680 | |
4755096e | 4681 | =item Frame Listing Output Examples |
c76ac1ee | 4682 | |
4755096e | 4683 | =item Debugging regular expressions |
c76ac1ee | 4684 | |
d420ca49 | 4685 | =over 4 |
c76ac1ee | 4686 | |
4755096e | 4687 | =item Compile-time output |
c76ac1ee | 4688 | |
4755096e GS |
4689 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
4690 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
4691 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
4692 | C<anchored(TYPE)> | |
c76ac1ee | 4693 | |
4755096e | 4694 | =item Types of nodes |
c76ac1ee | 4695 | |
4755096e | 4696 | =item Run-time output |
c76ac1ee | 4697 | |
37590e52 | 4698 | =back |
c76ac1ee | 4699 | |
4755096e | 4700 | =item Debugging Perl memory usage |
c76ac1ee | 4701 | |
d420ca49 | 4702 | =over 4 |
c76ac1ee | 4703 | |
4755096e | 4704 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
c76ac1ee | 4705 | |
4755096e GS |
4706 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
4707 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
4708 | 6144> | |
c76ac1ee | 4709 | |
4755096e | 4710 | =back |
37590e52 | 4711 | |
4755096e | 4712 | =item SEE ALSO |
c76ac1ee GS |
4713 | |
4714 | =back | |
4715 | ||
4755096e | 4716 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
c76ac1ee | 4717 | |
d420ca49 | 4718 | =over 4 |
c76ac1ee | 4719 | |
4755096e | 4720 | =item DESCRIPTION |
c76ac1ee | 4721 | |
4755096e | 4722 | =item SPECIAL NOTES |
c76ac1ee | 4723 | |
d420ca49 | 4724 | =over 4 |
c76ac1ee | 4725 | |
4755096e | 4726 | =item make |
c76ac1ee | 4727 | |
4755096e GS |
4728 | =item Version caveat |
4729 | ||
4730 | =item Dynamic Loading versus Static Loading | |
c76ac1ee GS |
4731 | |
4732 | =back | |
fb9cefb4 | 4733 | |
4755096e | 4734 | =item TUTORIAL |
cb1a09d0 | 4735 | |
d420ca49 | 4736 | =over 4 |
8ebc5c01 | 4737 | |
4755096e | 4738 | =item EXAMPLE 1 |
fb9cefb4 | 4739 | |
4755096e | 4740 | =item EXAMPLE 2 |
fb9cefb4 | 4741 | |
4755096e | 4742 | =item What has gone on? |
5cd24f17 | 4743 | |
4755096e | 4744 | =item Writing good test scripts |
cb1a09d0 | 4745 | |
4755096e | 4746 | =item EXAMPLE 3 |
774d564b | 4747 | |
4755096e | 4748 | =item What's new here? |
c76ac1ee | 4749 | |
4755096e | 4750 | =item Input and Output Parameters |
c76ac1ee | 4751 | |
4755096e | 4752 | =item The XSUBPP Program |
b38f6a39 | 4753 | |
4755096e | 4754 | =item The TYPEMAP file |
c76ac1ee | 4755 | |
4755096e | 4756 | =item Warning about Output Arguments |
37590e52 | 4757 | |
4755096e | 4758 | =item EXAMPLE 4 |
37590e52 | 4759 | |
4755096e | 4760 | =item What has happened here? |
c76ac1ee | 4761 | |
4755096e | 4762 | =item Anatomy of .xs file |
37590e52 | 4763 | |
4755096e | 4764 | =item Getting the fat out of XSUBs |
cb1a09d0 | 4765 | |
4755096e | 4766 | =item More about XSUB arguments |
37590e52 | 4767 | |
4755096e | 4768 | =item The Argument Stack |
a45bd81d | 4769 | |
4755096e | 4770 | =item Extending your Extension |
a45bd81d | 4771 | |
4755096e | 4772 | =item Documenting your Extension |
37590e52 | 4773 | |
4755096e | 4774 | =item Installing your Extension |
37590e52 | 4775 | |
4755096e | 4776 | =item EXAMPLE 5 |
37590e52 | 4777 | |
4755096e | 4778 | =item New Things in this Example |
37590e52 | 4779 | |
4755096e | 4780 | =item EXAMPLE 6 |
37590e52 | 4781 | |
4755096e | 4782 | =item New Things in this Example |
37590e52 | 4783 | |
4755096e | 4784 | =item EXAMPLE 7 (Coming Soon) |
37590e52 | 4785 | |
4755096e | 4786 | =item EXAMPLE 8 (Coming Soon) |
37590e52 | 4787 | |
849d92fd | 4788 | =item EXAMPLE 9 Passing open files to XSes |
37590e52 | 4789 | |
4755096e | 4790 | =item Troubleshooting these Examples |
37590e52 | 4791 | |
4755096e | 4792 | =back |
37590e52 | 4793 | |
4755096e | 4794 | =item See also |
37590e52 | 4795 | |
4755096e | 4796 | =item Author |
37590e52 | 4797 | |
d420ca49 | 4798 | =over 4 |
37590e52 | 4799 | |
4755096e | 4800 | =item Last Changed |
37590e52 GS |
4801 | |
4802 | =back | |
4803 | ||
4755096e GS |
4804 | =back |
4805 | ||
4806 | =head2 perlxs - XS language reference manual | |
37590e52 | 4807 | |
d420ca49 | 4808 | =over 4 |
37590e52 | 4809 | |
4755096e | 4810 | =item DESCRIPTION |
37590e52 | 4811 | |
d420ca49 | 4812 | =over 4 |
37590e52 | 4813 | |
4755096e | 4814 | =item Introduction |
37590e52 | 4815 | |
4755096e | 4816 | =item On The Road |
37590e52 | 4817 | |
4755096e | 4818 | =item The Anatomy of an XSUB |
37590e52 | 4819 | |
4755096e | 4820 | =item The Argument Stack |
37590e52 | 4821 | |
4755096e | 4822 | =item The RETVAL Variable |
37590e52 | 4823 | |
7f106169 NC |
4824 | =item Returning SVs, AVs and HVs through RETVAL |
4825 | ||
4755096e | 4826 | =item The MODULE Keyword |
37590e52 | 4827 | |
4755096e | 4828 | =item The PACKAGE Keyword |
37590e52 | 4829 | |
4755096e | 4830 | =item The PREFIX Keyword |
37590e52 | 4831 | |
4755096e | 4832 | =item The OUTPUT: Keyword |
fb9cefb4 | 4833 | |
91331b4f JH |
4834 | =item The NO_OUTPUT Keyword |
4835 | ||
4755096e GS |
4836 | =item The CODE: Keyword |
4837 | ||
4838 | =item The INIT: Keyword | |
4839 | ||
4840 | =item The NO_INIT Keyword | |
4841 | ||
4842 | =item Initializing Function Parameters | |
4843 | ||
4844 | =item Default Parameter Values | |
4845 | ||
4846 | =item The PREINIT: Keyword | |
4847 | ||
4848 | =item The SCOPE: Keyword | |
4849 | ||
4850 | =item The INPUT: Keyword | |
4851 | ||
165c0277 | 4852 | =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords |
91331b4f | 4853 | |
ff426ff2 JH |
4854 | =item The C<length(NAME)> Keyword |
4855 | ||
4755096e GS |
4856 | =item Variable-length Parameter Lists |
4857 | ||
4858 | =item The C_ARGS: Keyword | |
4859 | ||
4860 | =item The PPCODE: Keyword | |
4861 | ||
4862 | =item Returning Undef And Empty Lists | |
4863 | ||
4864 | =item The REQUIRE: Keyword | |
fb9cefb4 | 4865 | |
4755096e | 4866 | =item The CLEANUP: Keyword |
fb9cefb4 | 4867 | |
354a27bf | 4868 | =item The POSTCALL: Keyword |
91331b4f | 4869 | |
4755096e | 4870 | =item The BOOT: Keyword |
cb1a09d0 | 4871 | |
4755096e | 4872 | =item The VERSIONCHECK: Keyword |
cb1a09d0 | 4873 | |
4755096e | 4874 | =item The PROTOTYPES: Keyword |
cb1a09d0 | 4875 | |
4755096e | 4876 | =item The PROTOTYPE: Keyword |
a45bd81d | 4877 | |
4755096e | 4878 | =item The ALIAS: Keyword |
cb1a09d0 | 4879 | |
940adb21 JH |
4880 | =item The OVERLOAD: Keyword |
4881 | ||
35c7d401 JH |
4882 | =item The FALLBACK: Keyword |
4883 | ||
4755096e | 4884 | =item The INTERFACE: Keyword |
a45bd81d | 4885 | |
4755096e | 4886 | =item The INTERFACE_MACRO: Keyword |
cb1a09d0 | 4887 | |
4755096e | 4888 | =item The INCLUDE: Keyword |
cb1a09d0 | 4889 | |
4755096e | 4890 | =item The CASE: Keyword |
cb1a09d0 | 4891 | |
4755096e | 4892 | =item The & Unary Operator |
cb1a09d0 | 4893 | |
2cc61e15 | 4894 | =item Inserting POD, Comments and C Preprocessor Directives |
cb1a09d0 | 4895 | |
4755096e | 4896 | =item Using XS With C++ |
cb1a09d0 | 4897 | |
4755096e | 4898 | =item Interface Strategy |
cb1a09d0 | 4899 | |
4755096e | 4900 | =item Perl Objects And C Structures |
14218588 | 4901 | |
4755096e | 4902 | =item The Typemap |
cb1a09d0 | 4903 | |
07fcf8ff JH |
4904 | =item Safely Storing Static Data in XS |
4905 | ||
4906 | MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT | |
4907 | ||
8ebc5c01 | 4908 | =back |
cb1a09d0 | 4909 | |
4755096e GS |
4910 | =item EXAMPLES |
4911 | ||
4912 | =item XS VERSION | |
4913 | ||
4914 | =item AUTHOR | |
14218588 | 4915 | |
a45bd81d GS |
4916 | =back |
4917 | ||
f40a6c71 SC |
4918 | =head2 perlclib - Internal replacements for standard C library functions |
4919 | ||
4920 | =over 4 | |
4921 | ||
4922 | =item DESCRIPTION | |
4923 | ||
4924 | =over 4 | |
4925 | ||
4926 | =item Conventions | |
4927 | ||
4928 | C<t>, C<p>, C<n>, C<s> | |
4929 | ||
4930 | =item File Operations | |
4931 | ||
4932 | =item File Input and Output | |
4933 | ||
4934 | =item File Positioning | |
4935 | ||
4936 | =item Memory Management and String Handling | |
4937 | ||
4938 | =item Character Class Tests | |
4939 | ||
4940 | =item F<stdlib.h> functions | |
4941 | ||
4942 | =item Miscellaneous functions | |
4943 | ||
4944 | =back | |
4945 | ||
4946 | =item SEE ALSO | |
4947 | ||
4948 | =back | |
4949 | ||
4755096e | 4950 | =head2 perlguts - Introduction to the Perl API |
cb1a09d0 | 4951 | |
d420ca49 | 4952 | =over 4 |
a45bd81d | 4953 | |
8ebc5c01 | 4954 | =item DESCRIPTION |
cb1a09d0 | 4955 | |
4755096e | 4956 | =item Variables |
cb1a09d0 | 4957 | |
d420ca49 | 4958 | =over 4 |
cb1a09d0 | 4959 | |
4755096e | 4960 | =item Datatypes |
cb1a09d0 | 4961 | |
4755096e | 4962 | =item What is an "IV"? |
cb1a09d0 | 4963 | |
4755096e | 4964 | =item Working with SVs |
cb1a09d0 | 4965 | |
37d4d706 JH |
4966 | =item Offsets |
4967 | ||
4755096e | 4968 | =item What's Really Stored in an SV? |
cb1a09d0 | 4969 | |
4755096e | 4970 | =item Working with AVs |
cb1a09d0 | 4971 | |
4755096e | 4972 | =item Working with HVs |
cb1a09d0 | 4973 | |
4755096e | 4974 | =item Hash API Extensions |
cb1a09d0 | 4975 | |
b0a5877c JH |
4976 | =item AVs, HVs and undefined values |
4977 | ||
4755096e | 4978 | =item References |
cb1a09d0 | 4979 | |
4755096e | 4980 | =item Blessed References and Class Objects |
774d564b | 4981 | |
4755096e | 4982 | =item Creating New Variables |
cb1a09d0 | 4983 | |
d8416318 JH |
4984 | GV_ADDMULTI, GV_ADDWARN |
4985 | ||
4755096e | 4986 | =item Reference Counts and Mortality |
a45bd81d | 4987 | |
4755096e | 4988 | =item Stashes and Globs |
cb1a09d0 | 4989 | |
4755096e | 4990 | =item Double-Typed SVs |
a45bd81d | 4991 | |
4755096e | 4992 | =item Magic Variables |
cb1a09d0 | 4993 | |
4755096e | 4994 | =item Assigning Magic |
cb1a09d0 | 4995 | |
4755096e | 4996 | =item Magic Virtual Tables |
cb1a09d0 | 4997 | |
4755096e | 4998 | =item Finding Magic |
cb1a09d0 | 4999 | |
4755096e | 5000 | =item Understanding the Magic of Tied Hashes and Arrays |
cb1a09d0 | 5001 | |
4755096e | 5002 | =item Localizing changes |
cb1a09d0 | 5003 | |
4755096e | 5004 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
e42c74e1 JH |
5005 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV |
5006 | *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, | |
5007 | C<SAVEDELETE(HV *hv, char *key, I32 length)>, | |
5008 | C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>, | |
5009 | C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV* | |
5010 | save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>, | |
5011 | C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>, | |
5012 | C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void | |
5013 | save_hptr(HV **hptr)> | |
cb1a09d0 | 5014 | |
4755096e | 5015 | =back |
cb1a09d0 | 5016 | |
4755096e | 5017 | =item Subroutines |
cb1a09d0 | 5018 | |
d420ca49 | 5019 | =over 4 |
cb1a09d0 | 5020 | |
4755096e | 5021 | =item XSUBs and the Argument Stack |
cb1a09d0 | 5022 | |
4755096e | 5023 | =item Calling Perl Routines from within C Programs |
cb1a09d0 | 5024 | |
4755096e | 5025 | =item Memory Allocation |
cb1a09d0 | 5026 | |
4755096e | 5027 | =item PerlIO |
cb1a09d0 | 5028 | |
4755096e | 5029 | =item Putting a C value on Perl stack |
cb1a09d0 | 5030 | |
4755096e | 5031 | =item Scratchpads |
cb1a09d0 | 5032 | |
4755096e | 5033 | =item Scratchpads and recursion |
cb1a09d0 | 5034 | |
4755096e | 5035 | =back |
cb1a09d0 | 5036 | |
4755096e | 5037 | =item Compiled code |
cb1a09d0 | 5038 | |
d420ca49 | 5039 | =over 4 |
cb1a09d0 | 5040 | |
4755096e | 5041 | =item Code tree |
cb1a09d0 | 5042 | |
4755096e | 5043 | =item Examining the tree |
cb1a09d0 | 5044 | |
4755096e | 5045 | =item Compile pass 1: check routines |
cb1a09d0 | 5046 | |
4755096e | 5047 | =item Compile pass 1a: constant folding |
cb1a09d0 | 5048 | |
4755096e | 5049 | =item Compile pass 2: context propagation |
cb1a09d0 | 5050 | |
4755096e | 5051 | =item Compile pass 3: peephole optimization |
cb1a09d0 | 5052 | |
27713a04 JH |
5053 | =item Pluggable runops |
5054 | ||
4755096e | 5055 | =back |
cb1a09d0 | 5056 | |
165c0277 JH |
5057 | =item Examining internal data structures with the C<dump> functions |
5058 | ||
4755096e | 5059 | =item How multiple interpreters and concurrency are supported |
cb1a09d0 | 5060 | |
d420ca49 | 5061 | =over 4 |
cb1a09d0 | 5062 | |
4755096e | 5063 | =item Background and PERL_IMPLICIT_CONTEXT |
cb1a09d0 | 5064 | |
0d0e97a6 JH |
5065 | =item So what happened to dTHR? |
5066 | ||
4755096e | 5067 | =item How do I use all this in extensions? |
cb1a09d0 | 5068 | |
0d0e97a6 JH |
5069 | =item Should I do anything special if I call perl from multiple threads? |
5070 | ||
4755096e | 5071 | =item Future Plans and PERL_IMPLICIT_SYS |
cb1a09d0 | 5072 | |
4755096e | 5073 | =back |
fb9cefb4 | 5074 | |
7029d033 JH |
5075 | =item Internal Functions |
5076 | ||
c66ca2ac | 5077 | A, p, d, s, n, r, f, M, o, x, m, X, E, b |
7029d033 | 5078 | |
d420ca49 | 5079 | =over 4 |
7029d033 | 5080 | |
a9ef4385 | 5081 | =item Formatted Printing of IVs, UVs, and NVs |
91e74348 | 5082 | |
9fa7f388 JH |
5083 | =item Pointer-To-Integer and Integer-To-Pointer |
5084 | ||
7029d033 JH |
5085 | =item Source Documentation |
5086 | ||
a563e516 NC |
5087 | =item Backwards compatibility |
5088 | ||
7029d033 JH |
5089 | =back |
5090 | ||
5091 | =item Unicode Support | |
5092 | ||
d420ca49 | 5093 | =over 4 |
7029d033 JH |
5094 | |
5095 | =item What B<is> Unicode, anyway? | |
5096 | ||
cd458e05 | 5097 | =item How can I recognise a UTF-8 string? |
7029d033 | 5098 | |
cd458e05 | 5099 | =item How does UTF-8 represent Unicode characters? |
7029d033 | 5100 | |
cd458e05 | 5101 | =item How does Perl store UTF-8 strings? |
7029d033 | 5102 | |
cd458e05 | 5103 | =item How do I convert a string to UTF-8? |
7029d033 JH |
5104 | |
5105 | =item Is there anything else I need to know? | |
5106 | ||
5107 | =back | |
5108 | ||
53d7eaa8 JH |
5109 | =item Custom Operators |
5110 | ||
4755096e | 5111 | =item AUTHORS |
fb9cefb4 | 5112 | |
4755096e | 5113 | =item SEE ALSO |
cb1a09d0 | 5114 | |
4755096e | 5115 | =back |
cb1a09d0 | 5116 | |
4755096e | 5117 | =head2 perlcall - Perl calling conventions from C |
193fb0af | 5118 | |
d420ca49 | 5119 | =over 4 |
cb1a09d0 | 5120 | |
4755096e | 5121 | =item DESCRIPTION |
68dc0745 | 5122 | |
4755096e | 5123 | An Error Handler, An Event Driven Program |
193fb0af | 5124 | |
4755096e | 5125 | =item THE CALL_ FUNCTIONS |
cb1a09d0 | 5126 | |
4755096e | 5127 | call_sv, call_pv, call_method, call_argv |
a45bd81d | 5128 | |
4755096e | 5129 | =item FLAG VALUES |
cb1a09d0 | 5130 | |
d420ca49 | 5131 | =over 4 |
a45bd81d | 5132 | |
4755096e | 5133 | =item G_VOID |
cb1a09d0 | 5134 | |
4755096e | 5135 | =item G_SCALAR |
55497cff | 5136 | |
4755096e | 5137 | =item G_ARRAY |
cb1a09d0 | 5138 | |
4755096e | 5139 | =item G_DISCARD |
cb1a09d0 | 5140 | |
4755096e | 5141 | =item G_NOARGS |
c76ac1ee | 5142 | |
4755096e | 5143 | =item G_EVAL |
14218588 | 5144 | |
4755096e | 5145 | =item G_KEEPERR |
cb1a09d0 | 5146 | |
4755096e | 5147 | =item Determining the Context |
7d2bfb28 | 5148 | |
4755096e | 5149 | =back |
cb1a09d0 | 5150 | |
4755096e | 5151 | =item EXAMPLES |
fb9cefb4 | 5152 | |
d420ca49 | 5153 | =over 4 |
a45bd81d | 5154 | |
4755096e | 5155 | =item No Parameters, Nothing returned |
a45bd81d | 5156 | |
4755096e | 5157 | =item Passing Parameters |
fb9cefb4 | 5158 | |
4755096e | 5159 | =item Returning a Scalar |
cb1a09d0 | 5160 | |
4755096e | 5161 | =item Returning a list of values |
14218588 | 5162 | |
4755096e | 5163 | =item Returning a list in a scalar context |
14218588 | 5164 | |
4755096e | 5165 | =item Returning Data from Perl via the parameter list |
a45bd81d | 5166 | |
4755096e | 5167 | =item Using G_EVAL |
cb1a09d0 | 5168 | |
4755096e | 5169 | =item Using G_KEEPERR |
a45bd81d | 5170 | |
4755096e | 5171 | =item Using call_sv |
cb1a09d0 | 5172 | |
4755096e | 5173 | =item Using call_argv |
cb1a09d0 | 5174 | |
4755096e | 5175 | =item Using call_method |
cb1a09d0 | 5176 | |
4755096e | 5177 | =item Using GIMME_V |
68dc0745 | 5178 | |
4755096e | 5179 | =item Using Perl to dispose of temporaries |
68dc0745 | 5180 | |
4755096e | 5181 | =item Strategies for storing Callback Context Information |
193fb0af | 5182 | |
4755096e GS |
5183 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
5184 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
5185 | callback | |
cb1a09d0 | 5186 | |
4755096e GS |
5187 | =item Alternate Stack Manipulation |
5188 | ||
5189 | =item Creating and calling an anonymous subroutine in C | |
cb1a09d0 AD |
5190 | |
5191 | =back | |
5192 | ||
4755096e | 5193 | =item SEE ALSO |
1e422769 | 5194 | |
4755096e GS |
5195 | =item AUTHOR |
5196 | ||
5197 | =item DATE | |
1e422769 | 5198 | |
a45bd81d GS |
5199 | =back |
5200 | ||
4755096e | 5201 | =head2 perlapi - autogenerated documentation for the perl public API |
44a8e56a | 5202 | |
d420ca49 | 5203 | =over 4 |
cb1a09d0 | 5204 | |
4755096e | 5205 | =item DESCRIPTION |
b40eed9c | 5206 | X<Perl API> X<API> X<api> |
cb1a09d0 | 5207 | |
04b01f78 JH |
5208 | =item "Gimme" Values |
5209 | ||
b40eed9c NC |
5210 | GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD |
5211 | X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>, | |
5212 | G_VOID X<G_VOID> | |
04b01f78 JH |
5213 | |
5214 | =item Array Manipulation Functions | |
5215 | ||
b40eed9c NC |
5216 | AvFILL X<AvFILL>, av_clear X<av_clear>, av_delete X<av_delete>, av_exists |
5217 | X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill | |
5218 | X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push | |
5219 | X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef | |
5220 | X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>, | |
5221 | sortsv X<sortsv> | |
04b01f78 JH |
5222 | |
5223 | =item Callback Functions | |
5224 | ||
b40eed9c NC |
5225 | call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>, |
5226 | call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>, | |
5227 | FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS> | |
04b01f78 JH |
5228 | |
5229 | =item Character classes | |
5230 | ||
b40eed9c NC |
5231 | isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER |
5232 | X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>, | |
5233 | toUPPER X<toUPPER> | |
04b01f78 JH |
5234 | |
5235 | =item Cloning an interpreter | |
5236 | ||
b40eed9c | 5237 | perl_clone X<perl_clone> |
04b01f78 JH |
5238 | |
5239 | =item CV Manipulation Functions | |
5240 | ||
b40eed9c | 5241 | CvSTASH X<CvSTASH>, get_cv X<get_cv> |
04b01f78 JH |
5242 | |
5243 | =item Embedding Functions | |
5244 | ||
b40eed9c NC |
5245 | cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook |
5246 | X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct | |
5247 | X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>, | |
5248 | perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv> | |
04b01f78 | 5249 | |
ff426ff2 JH |
5250 | =item Functions in file pp_pack.c |
5251 | ||
b40eed9c NC |
5252 | packlist X<packlist>, pack_cat X<pack_cat>, unpackstring X<unpackstring>, |
5253 | unpack_str X<unpack_str> | |
ff426ff2 | 5254 | |
04b01f78 JH |
5255 | =item Global Variables |
5256 | ||
b40eed9c NC |
5257 | PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>, |
5258 | PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes> | |
04b01f78 JH |
5259 | |
5260 | =item GV Functions | |
5261 | ||
b40eed9c NC |
5262 | GvSV X<GvSV>, gv_fetchmeth X<gv_fetchmeth>, gv_fetchmethod |
5263 | X<gv_fetchmethod>, gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, | |
5264 | gv_fetchmeth_autoload X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, | |
5265 | gv_stashpvn X<gv_stashpvn>, gv_stashsv X<gv_stashsv> | |
04b01f78 JH |
5266 | |
5267 | =item Handy Values | |
5268 | ||
b40eed9c NC |
5269 | Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>, |
5270 | Nullsv X<Nullsv> | |
04b01f78 JH |
5271 | |
5272 | =item Hash Manipulation Functions | |
5273 | ||
b40eed9c NC |
5274 | get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>, |
5275 | HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force | |
5276 | X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME | |
5277 | X<HvNAME>, hv_clear X<hv_clear>, hv_clear_placeholders | |
5278 | X<hv_clear_placeholders>, hv_delete X<hv_delete>, hv_delete_ent | |
5279 | X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent X<hv_exists_ent>, | |
5280 | hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>, hv_iterinit | |
5281 | X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, | |
5282 | hv_iternext X<hv_iternext>, hv_iternextsv X<hv_iternextsv>, | |
5283 | hv_iternext_flags X<hv_iternext_flags>, hv_iterval X<hv_iterval>, hv_magic | |
5284 | X<hv_magic>, hv_scalar X<hv_scalar>, hv_store X<hv_store>, hv_store_ent | |
5285 | X<hv_store_ent>, hv_undef X<hv_undef>, newHV X<newHV> | |
04b01f78 JH |
5286 | |
5287 | =item Magical Functions | |
5288 | ||
b40eed9c NC |
5289 | mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free |
5290 | X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical | |
5291 | X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK | |
5292 | X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>, | |
5293 | SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>, | |
5294 | SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK | |
5295 | X<SvUNLOCK> | |
04b01f78 JH |
5296 | |
5297 | =item Memory Management | |
5298 | ||
b40eed9c NC |
5299 | Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>, |
5300 | Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, Renew X<Renew>, Renewc | |
5301 | X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>, | |
5302 | savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, StructCopy | |
5303 | X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD> | |
04b01f78 JH |
5304 | |
5305 | =item Miscellaneous Functions | |
5306 | ||
b40eed9c NC |
5307 | fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv |
5308 | X<getcwd_sv>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE | |
5309 | X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE | |
5310 | X<strnNE>, sv_nolocking X<sv_nolocking>, sv_nosharing X<sv_nosharing>, | |
5311 | sv_nounlocking X<sv_nounlocking> | |
04b01f78 JH |
5312 | |
5313 | =item Numeric functions | |
5314 | ||
b40eed9c NC |
5315 | grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>, |
5316 | grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>, scan_bin | |
5317 | X<scan_bin>, scan_hex X<scan_hex>, scan_oct X<scan_oct> | |
04b01f78 JH |
5318 | |
5319 | =item Optree Manipulation Functions | |
5320 | ||
b40eed9c | 5321 | cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS> |
04b01f78 | 5322 | |
35c7d401 JH |
5323 | =item Pad Data Structures |
5324 | ||
b40eed9c | 5325 | pad_sv X<pad_sv> |
35c7d401 | 5326 | |
04b01f78 JH |
5327 | =item Stack Manipulation Macros |
5328 | ||
b40eed9c NC |
5329 | dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK |
5330 | X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu | |
5331 | X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>, | |
5332 | mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn | |
5333 | X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs | |
5334 | X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>, | |
5335 | PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK | |
5336 | X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal | |
5337 | X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>, | |
5338 | XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>, | |
5339 | XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV | |
5340 | X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF | |
5341 | X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES | |
5342 | X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV | |
5343 | X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES | |
5344 | X<XST_mYES> | |
04b01f78 JH |
5345 | |
5346 | =item SV Flags | |
5347 | ||
b40eed9c NC |
5348 | svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>, |
5349 | SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG | |
5350 | X<SVt_PVMG> | |
04b01f78 JH |
5351 | |
5352 | =item SV Manipulation Functions | |
5353 | ||
b40eed9c NC |
5354 | get_sv X<get_sv>, looks_like_number X<looks_like_number>, newRV_inc |
5355 | X<newRV_inc>, newRV_noinc X<newRV_noinc>, NEWSV X<NEWSV>, newSV X<newSV>, | |
5356 | newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, newSVpv | |
5357 | X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, newSVpvn_share | |
5358 | X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv | |
5359 | X<newSVuv>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>, SvEND X<SvEND>, SvGROW | |
5360 | X<SvGROW>, SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, | |
5361 | SvIOK_off X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, | |
5362 | SvIOK_only_UV X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>, | |
5363 | SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>, | |
5364 | SvIVx X<SvIVx>, SvIV_set X<SvIV_set>, SvLEN X<SvLEN>, SvLEN_set | |
5365 | X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK X<SvNIOK>, SvNIOKp | |
5366 | X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>, SvNOKp X<SvNOKp>, | |
5367 | SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only X<SvNOK_only>, | |
5368 | SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set X<SvNV_set>, SvOK | |
5369 | X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp X<SvPOKp>, SvPOK_off | |
5370 | X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only X<SvPOK_only>, | |
5371 | SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte X<SvPVbyte>, | |
5372 | SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>, SvPVbyte_force | |
5373 | X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>, SvPVutf8 X<SvPVutf8>, | |
5374 | SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force X<SvPVutf8x_force>, SvPVutf8_force | |
5375 | X<SvPVutf8_force>, SvPVutf8_nolen X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx | |
5376 | X<SvPVx>, SvPV_force X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, | |
5377 | SvPV_nolen X<SvPV_nolen>, SvPV_set X<SvPV_set>, SvREFCNT X<SvREFCNT>, | |
5378 | SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>, SvROK X<SvROK>, | |
5379 | SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>, SvRV_set | |
5380 | X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>, SvTAINT | |
5381 | X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>, | |
5382 | SvTAINTED_on X<SvTAINTED_on>, SvTRUE X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK | |
5383 | X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off | |
5384 | X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx | |
5385 | X<SvUVx>, SvUV_set X<SvUV_set>, sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, | |
5386 | sv_2io X<sv_2io>, sv_2iv X<sv_2iv>, sv_2mortal X<sv_2mortal>, sv_2nv | |
5387 | X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvbyte_nolen X<sv_2pvbyte_nolen>, | |
5388 | sv_2pvutf8 X<sv_2pvutf8>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, | |
5389 | sv_2pv_flags X<sv_2pv_flags>, sv_2pv_nolen X<sv_2pv_nolen>, sv_2uv | |
5390 | X<sv_2uv>, sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv | |
5391 | X<sv_catpv>, sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>, | |
5392 | sv_catpvn X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvn_mg | |
5393 | X<sv_catpvn_mg>, sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catpv_mg | |
5394 | X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>, | |
5395 | sv_catsv_mg X<sv_catsv_mg>, sv_catsv_nomg X<sv_catsv_nomg>, sv_chop | |
5396 | X<sv_chop>, sv_clear X<sv_clear>, sv_cmp X<sv_cmp>, sv_cmp_locale | |
5397 | X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>, sv_copypv X<sv_copypv>, | |
5398 | sv_dec X<sv_dec>, sv_derived_from X<sv_derived_from>, sv_eq X<sv_eq>, | |
5399 | sv_force_normal X<sv_force_normal>, sv_force_normal_flags | |
5400 | X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets X<sv_gets>, sv_grow | |
5401 | X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>, sv_isa X<sv_isa>, | |
5402 | sv_isobject X<sv_isobject>, sv_iv X<sv_iv>, sv_len X<sv_len>, sv_len_utf8 | |
5403 | X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>, | |
5404 | sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref | |
5405 | X<sv_newref>, sv_nv X<sv_nv>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b | |
5406 | X<sv_pos_u2b>, sv_pv X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten | |
5407 | X<sv_pvbyten>, sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn X<sv_pvn>, | |
5408 | sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags X<sv_pvn_force_flags>, | |
5409 | sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_pvutf8n_force | |
5410 | X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>, | |
5411 | sv_report_used X<sv_report_used>, sv_reset X<sv_reset>, sv_rvweaken | |
5412 | X<sv_rvweaken>, sv_setiv X<sv_setiv>, sv_setiv_mg X<sv_setiv_mg>, sv_setnv | |
5413 | X<sv_setnv>, sv_setnv_mg X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf | |
5414 | X<sv_setpvf>, sv_setpvf_mg X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, | |
5415 | sv_setpviv_mg X<sv_setpviv_mg>, sv_setpvn X<sv_setpvn>, sv_setpvn_mg | |
5416 | X<sv_setpvn_mg>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, | |
5417 | sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn | |
5418 | X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>, | |
5419 | sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setsv_nomg | |
5420 | X<sv_setsv_nomg>, sv_setuv X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, | |
5421 | sv_taint X<sv_taint>, sv_tainted X<sv_tainted>, sv_true X<sv_true>, | |
5422 | sv_unmagic X<sv_unmagic>, sv_unref X<sv_unref>, sv_unref_flags | |
5423 | X<sv_unref_flags>, sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, | |
5424 | sv_usepvn X<sv_usepvn>, sv_usepvn_mg X<sv_usepvn_mg>, sv_utf8_decode | |
5425 | X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode | |
5426 | X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>, | |
5427 | sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_uv X<sv_uv>, sv_vcatpvf | |
5428 | X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, | |
5429 | sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg | |
5430 | X<sv_vsetpvf_mg> | |
04b01f78 JH |
5431 | |
5432 | =item Unicode Support | |
5433 | ||
b40eed9c NC |
5434 | bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>, |
5435 | ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string | |
5436 | X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>, | |
5437 | is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display | |
5438 | X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8 | |
5439 | X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case | |
5440 | X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower | |
5441 | X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper | |
5442 | X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni | |
5443 | X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>, | |
5444 | utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr | |
5445 | X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8 | |
5446 | X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags> | |
04b01f78 JH |
5447 | |
5448 | =item Variables created by C<xsubpp> and C<xsubpp> internal functions | |
5449 | ||
b40eed9c NC |
5450 | ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>, |
5451 | dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items X<items>, ix X<ix>, newXSproto | |
5452 | X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>, THIS X<THIS>, XS X<XS>, | |
5453 | XS_VERSION X<XS_VERSION>, XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK> | |
04b01f78 JH |
5454 | |
5455 | =item Warning and Dieing | |
5456 | ||
b40eed9c | 5457 | croak X<croak>, warn X<warn> |
c76ac1ee | 5458 | |
4755096e | 5459 | =item AUTHORS |
cb1a09d0 AD |
5460 | |
5461 | =item SEE ALSO | |
5462 | ||
a45bd81d GS |
5463 | =back |
5464 | ||
91331b4f | 5465 | =head2 perlintern - autogenerated documentation of purely B<internal> |
4755096e | 5466 | Perl functions |
cb1a09d0 | 5467 | |
d420ca49 | 5468 | =over 4 |
a45bd81d | 5469 | |
cb1a09d0 | 5470 | =item DESCRIPTION |
b40eed9c | 5471 | X<internal Perl functions> X<interpreter functions> |
cb1a09d0 | 5472 | |
35c7d401 JH |
5473 | =item CV reference counts and CvOUTSIDE |
5474 | ||
b40eed9c | 5475 | CvWEAKOUTSIDE X<CvWEAKOUTSIDE> |
35c7d401 JH |
5476 | |
5477 | =item Functions in file pad.h | |
5478 | ||
b40eed9c NC |
5479 | CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV |
5480 | X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS | |
5481 | X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>, | |
5482 | PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH | |
5483 | X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>, | |
5484 | PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>, | |
5485 | PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>, | |
5486 | PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>, | |
5487 | PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>, | |
5488 | PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>, | |
5489 | SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV> | |
35c7d401 JH |
5490 | |
5491 | =item Functions in file pp_ctl.c | |
5492 | ||
b40eed9c | 5493 | find_runcv X<find_runcv> |
35c7d401 | 5494 | |
fe9287c4 JH |
5495 | =item Global Variables |
5496 | ||
b40eed9c NC |
5497 | PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>, |
5498 | PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv | |
5499 | X<PL_ofs_sv>, PL_rs X<PL_rs> | |
fe9287c4 JH |
5500 | |
5501 | =item GV Functions | |
5502 | ||
b40eed9c | 5503 | is_gv_magical X<is_gv_magical> |
fe9287c4 JH |
5504 | |
5505 | =item IO Functions | |
5506 | ||
b40eed9c | 5507 | start_glob X<start_glob> |
fe9287c4 JH |
5508 | |
5509 | =item Pad Data Structures | |
5510 | ||
b40eed9c NC |
5511 | CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>, |
5512 | do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon | |
5513 | X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>, | |
5514 | pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>, | |
5515 | pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons | |
5516 | X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>, | |
5517 | pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv | |
5518 | X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef | |
5519 | X<pad_undef> | |
fe9287c4 JH |
5520 | |
5521 | =item Stack Manipulation Macros | |
5522 | ||
b40eed9c | 5523 | djSP X<djSP>, LVRET X<LVRET> |
fe9287c4 JH |
5524 | |
5525 | =item SV Manipulation Functions | |
5526 | ||
b40eed9c NC |
5527 | report_uninit X<report_uninit>, sv_add_arena X<sv_add_arena>, sv_clean_all |
5528 | X<sv_clean_all>, sv_clean_objs X<sv_clean_objs>, sv_free_arenas | |
5529 | X<sv_free_arenas> | |
4755096e GS |
5530 | |
5531 | =item AUTHORS | |
5532 | ||
5533 | =item SEE ALSO | |
5534 | ||
5535 | =back | |
5536 | ||
dc5c060f JH |
5537 | =head2 perliol - C API for Perl's implementation of IO in Layers. |
5538 | ||
5539 | =over 4 | |
5540 | ||
5541 | =item SYNOPSIS | |
5542 | ||
5543 | =item DESCRIPTION | |
5544 | ||
5545 | =over 4 | |
5546 | ||
5547 | =item History and Background | |
5548 | ||
ef7b71f0 JH |
5549 | =item Basic Structure |
5550 | ||
dc5c060f JH |
5551 | =item Layers vs Disciplines |
5552 | ||
5553 | =item Data Structures | |
5554 | ||
dc5c060f JH |
5555 | =item Functions and Attributes |
5556 | ||
dc5c060f JH |
5557 | =item Per-instance Data |
5558 | ||
5559 | =item Layers in action. | |
5560 | ||
5561 | =item Per-instance flag bits | |
5562 | ||
5563 | PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, | |
5564 | PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, | |
5565 | PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, | |
5566 | PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS | |
5567 | ||
5568 | =item Methods in Detail | |
5569 | ||
cb9c8b59 | 5570 | fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF, |
033348ab JH |
5571 | PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode, |
5572 | Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, | |
5573 | Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, | |
5574 | Set_ptrcnt | |
dc5c060f | 5575 | |
5fc2b853 GM |
5576 | =item Utilities |
5577 | ||
1184f6df JH |
5578 | =item Implementing PerlIO Layers |
5579 | ||
bb25ec9b JH |
5580 | C implementations, Perl implementations |
5581 | ||
dc5c060f JH |
5582 | =item Core Layers |
5583 | ||
5584 | "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" | |
5585 | ||
5586 | =item Extension Layers | |
5587 | ||
c40f6c4a | 5588 | ":encoding", ":scalar", ":via" |
dc5c060f JH |
5589 | |
5590 | =back | |
5591 | ||
04b01f78 JH |
5592 | =item TODO |
5593 | ||
50e34432 JH |
5594 | =back |
5595 | ||
5596 | =head2 perlapio - perl's IO abstraction interface. | |
5597 | ||
5598 | =over 4 | |
5599 | ||
5600 | =item SYNOPSIS | |
5601 | ||
5602 | =item DESCRIPTION | |
5603 | ||
5604 | 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, | |
5605 | B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, | |
5606 | B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, | |
5607 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, | |
5608 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
5609 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
5610 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
5611 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
5612 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, | |
5613 | B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
5614 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> | |
5615 | ||
5616 | =over 4 | |
5617 | ||
5618 | =item Co-existence with stdio | |
5619 | ||
5620 | B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>, | |
5621 | B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)> | |
5622 | ||
5623 | =item "Fast gets" Functions | |
5624 | ||
5625 | B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, | |
5626 | B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, | |
5627 | B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, | |
5628 | B<PerlIO_get_bufsiz(f)> | |
5629 | ||
5630 | =item Other Functions | |
5631 | ||
5632 | PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), | |
5633 | 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) | |
5634 | ||
5635 | =back | |
5636 | ||
5637 | =back | |
5638 | ||
5639 | =head2 perlhack - How to hack at the Perl internals | |
5640 | ||
5641 | =over 4 | |
5642 | ||
5643 | =item DESCRIPTION | |
5644 | ||
5645 | Does concept match the general goals of Perl?, Where is the | |
5646 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
5647 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
5648 | it preclude other desirable features?, Is the implementation robust?, Is | |
5649 | the implementation generic enough to be portable?, Is the implementation | |
5650 | tested?, Is there enough documentation?, Is there another way to do it?, | |
5651 | Does it create too much work?, Patches speak louder than words | |
5652 | ||
5653 | =over 4 | |
5654 | ||
5655 | =item Keeping in sync | |
5656 | ||
5657 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
5658 | NFS, rsync'ing the patches | |
5659 | ||
5660 | =item Why rsync the source tree | |
5661 | ||
5662 | It's easier to rsync the source tree, It's more reliable | |
5663 | ||
5664 | =item Why rsync the patches | |
5665 | ||
5666 | It's easier to rsync the patches, It's a good reference, Finding a start | |
5667 | point, Finding how to fix a bug, Finding the source of misbehaviour | |
5668 | ||
d3ca9f77 NC |
5669 | =item Working with the source |
5670 | ||
50e34432 JH |
5671 | =item Perlbug administration |
5672 | ||
5673 | =item Submitting patches | |
5674 | ||
5675 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
5676 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
5677 | ||
5678 | =item Finding Your Way Around | |
5679 | ||
5680 | Core modules, Tests, Documentation, Configure, Interpreter | |
5681 | ||
5682 | =item Elements of the interpreter | |
5683 | ||
e7f2ff80 | 5684 | Startup, Parsing, Optimization, Running, Exception handing |
50e34432 JH |
5685 | |
5686 | =item Internal Variable Types | |
5687 | ||
5688 | =item Op Trees | |
5689 | ||
5690 | =item Stacks | |
5691 | ||
5692 | Argument stack, Mark stack, Save stack | |
5693 | ||
5694 | =item Millions of Macros | |
5695 | ||
5696 | =item The .i Targets | |
5697 | ||
5698 | =item Poking at Perl | |
5699 | ||
5700 | =item Using a source-level debugger | |
5701 | ||
5702 | run [args], break function_name, break source.c:xxx, step, next, continue, | |
5703 | finish, 'enter', print | |
5704 | ||
5705 | =item gdb macro support | |
5706 | ||
5707 | =item Dumping Perl Data Structures | |
5708 | ||
5709 | =item Patching | |
5710 | ||
5711 | =item Patching a core module | |
5712 | ||
5713 | =item Adding a new function to the core | |
5714 | ||
5715 | =item Writing a test | |
5716 | ||
5717 | F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>, | |
5718 | F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp, | |
5719 | t/cmd t/run t/io t/op, t/lib ext lib | |
5720 | ||
5721 | =item Special Make Test Targets | |
5722 | ||
91e033c7 NC |
5723 | coretest, test.deparse, test.taintwarn, minitest, test.valgrind |
5724 | check.valgrind utest.valgrind ucheck.valgrind, test.third check.third | |
5725 | utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 | |
b2a9ae16 | 5726 | check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty |
50e34432 JH |
5727 | |
5728 | =item Running tests by hand | |
5729 | ||
b2a9ae16 NC |
5730 | -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1, |
5731 | PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST | |
50e34432 JH |
5732 | |
5733 | =back | |
5734 | ||
5735 | =item EXTERNAL TOOLS FOR DEBUGGING PERL | |
5736 | ||
5737 | =over 4 | |
5738 | ||
5739 | =item Rational Software's Purify | |
5740 | ||
5741 | =item Purify on Unix | |
5742 | ||
5743 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity | |
5744 | ||
5745 | =item Purify on NT | |
5746 | ||
5747 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug | |
5748 | ||
5749 | =item valgrind | |
5750 | ||
5751 | =item Compaq's/Digital's/HP's Third Degree | |
5752 | ||
5753 | =item PERL_DESTRUCT_LEVEL | |
5754 | ||
5755 | =item Profiling | |
5756 | ||
5757 | =item Gprof Profiling | |
dc5c060f | 5758 | |
50e34432 | 5759 | -a, -b, -e routine, -f routine, -s, -z |
4755096e | 5760 | |
50e34432 | 5761 | =item GCC gcov Profiling |
cb1a09d0 | 5762 | |
50e34432 | 5763 | =item Pixie Profiling |
cb1a09d0 | 5764 | |
50e34432 JH |
5765 | -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, |
5766 | -z[ero] | |
cb1a09d0 | 5767 | |
50e34432 | 5768 | =item Miscellaneous tricks |
cb1a09d0 | 5769 | |
50e34432 | 5770 | =item CONCLUSION |
cb1a09d0 | 5771 | |
50e34432 | 5772 | I<The Road goes ever on and on, down from the door where it began.> |
cb1a09d0 | 5773 | |
50e34432 | 5774 | =back |
dc5c060f | 5775 | |
50e34432 | 5776 | =item AUTHOR |
dc5c060f | 5777 | |
50e34432 | 5778 | =back |
dc5c060f | 5779 | |
50e34432 | 5780 | =head2 perlbook - Perl book information |
dc5c060f | 5781 | |
50e34432 | 5782 | =over 4 |
cb1a09d0 | 5783 | |
50e34432 | 5784 | =item DESCRIPTION |
c635e13b | 5785 | |
a45bd81d GS |
5786 | =back |
5787 | ||
4755096e | 5788 | =head2 perltodo - Perl TO-DO List |
c635e13b | 5789 | |
d420ca49 | 5790 | =over 4 |
a45bd81d | 5791 | |
c635e13b | 5792 | =item DESCRIPTION |
cb1a09d0 | 5793 | |
b40eed9c | 5794 | =item The roadmap to 5.10 |
245d750e | 5795 | |
b40eed9c | 5796 | =over 4 |
245d750e | 5797 | |
b40eed9c | 5798 | =item Needed for a 5.9.4 release |
245d750e | 5799 | |
b40eed9c | 5800 | =item Needed for a 5.9.5 release |
4755096e | 5801 | |
b40eed9c | 5802 | Implement L</_ prototype character>, Implement L</state variables> |
4755096e | 5803 | |
b40eed9c | 5804 | =item Needed for a 5.9.6 release |
c635e13b | 5805 | |
a45bd81d GS |
5806 | =back |
5807 | ||
b40eed9c | 5808 | =item Tasks that only need Perl knowledge |
fb9cefb4 | 5809 | |
d420ca49 | 5810 | =over 4 |
a45bd81d | 5811 | |
b40eed9c | 5812 | =item common test code for timed bail out |
a45bd81d | 5813 | |
b40eed9c | 5814 | =item POD -> HTML conversion in the core still sucks |
245d750e | 5815 | |
b40eed9c | 5816 | =item Parallel testing |
245d750e | 5817 | |
b40eed9c | 5818 | =item Make Schwern poorer |
a45bd81d | 5819 | |
b40eed9c | 5820 | =item Improve the coverage of the core tests |
cb1a09d0 | 5821 | |
b40eed9c | 5822 | =item test B |
a45bd81d | 5823 | |
b40eed9c | 5824 | =item A decent benchmark |
cb1a09d0 | 5825 | |
b40eed9c | 5826 | =item fix tainting bugs |
cb1a09d0 | 5827 | |
b40eed9c | 5828 | =item Dual life everything |
cb1a09d0 | 5829 | |
b40eed9c NC |
5830 | =item Improving C<threads::shared> |
5831 | ||
5832 | =item POSIX memory footprint | |
cb1a09d0 | 5833 | |
a45bd81d GS |
5834 | =back |
5835 | ||
b40eed9c | 5836 | =item Tasks that need a little sysadmin-type knowledge |
4755096e | 5837 | |
245d750e | 5838 | =over 4 |
4755096e | 5839 | |
b40eed9c | 5840 | =item Relocatable perl |
cb1a09d0 | 5841 | |
b40eed9c | 5842 | =item make HTML install work |
cb1a09d0 | 5843 | |
b40eed9c | 5844 | =item compressed man pages |
cb1a09d0 | 5845 | |
b40eed9c NC |
5846 | =item Add a code coverage target to the Makefile |
5847 | ||
5848 | =item Make Config.pm cope with differences between build and installed perl | |
5849 | ||
5850 | =item make parallel builds work | |
cb1a09d0 | 5851 | |
b40eed9c | 5852 | =item linker specification files |
193fb0af | 5853 | |
b5a29516 | 5854 | =back |
cb1a09d0 | 5855 | |
b40eed9c | 5856 | =item Tasks that need a little C knowledge |
cb1a09d0 | 5857 | |
b5a29516 | 5858 | =over 4 |
cb1a09d0 | 5859 | |
b40eed9c | 5860 | =item Make it clear from -v if this is the exact official release |
cb1a09d0 | 5861 | |
b40eed9c | 5862 | =item Tidy up global variables |
cb1a09d0 | 5863 | |
b40eed9c | 5864 | =item Ordering of "global" variables. |
cb1a09d0 | 5865 | |
b40eed9c NC |
5866 | =item bincompat functions |
5867 | ||
5868 | =item am I hot or not? | |
5869 | ||
5870 | =item emulate the per-thread memory pool on Unix | |
5871 | ||
5872 | =item reduce duplication in sv_setsv_flags | |
cb1a09d0 | 5873 | |
b40eed9c NC |
5874 | =back |
5875 | ||
5876 | =item Tasks that need a knowledge of XS | |
5877 | ||
5878 | =over 4 | |
cb1a09d0 | 5879 | |
b5a29516 | 5880 | =item IPv6 |
cb1a09d0 | 5881 | |
b40eed9c | 5882 | =item shrink C<GV>s, C<CV>s |
cb1a09d0 | 5883 | |
b40eed9c | 5884 | =item merge Perl_sv_2[inpu]v |
cb1a09d0 | 5885 | |
b40eed9c | 5886 | =item UTF8 caching code |
cb1a09d0 | 5887 | |
b40eed9c | 5888 | =item Implicit Latin 1 => Unicode translation |
4755096e | 5889 | |
b40eed9c | 5890 | =item autovivification |
a563e516 | 5891 | |
b40eed9c | 5892 | =item Unicode in Filenames |
4755096e | 5893 | |
b40eed9c | 5894 | =item Unicode in %ENV |
4755096e | 5895 | |
b40eed9c | 5896 | =item use less 'memory' |
4755096e | 5897 | |
b40eed9c | 5898 | =item Re-implement C<:unique> in a way that is actually thread-safe |
4755096e | 5899 | |
b40eed9c | 5900 | =item Make tainting consistent |
4755096e | 5901 | |
b40eed9c | 5902 | =item readpipe(LIST) |
cb1a09d0 | 5903 | |
245d750e | 5904 | =back |
cb1a09d0 | 5905 | |
b40eed9c | 5906 | =item Tasks that need a knowledge of the interpreter |
cb1a09d0 | 5907 | |
245d750e | 5908 | =over 4 |
cb1a09d0 | 5909 | |
b40eed9c | 5910 | =item lexical pragmas |
3958b146 | 5911 | |
b40eed9c | 5912 | =item Attach/detach debugger from running program |
cb1a09d0 | 5913 | |
b40eed9c | 5914 | =item Constant folding |
3958b146 | 5915 | |
b40eed9c | 5916 | =item LVALUE functions for lists |
cb1a09d0 | 5917 | |
b40eed9c | 5918 | =item LVALUE functions in the debugger |
4755096e | 5919 | |
b40eed9c | 5920 | =item _ prototype character |
4755096e | 5921 | |
b40eed9c | 5922 | =item state variables |
4755096e | 5923 | |
b40eed9c | 5924 | =item @INC source filter to Filter::Simple |
cb1a09d0 | 5925 | |
b40eed9c | 5926 | =item regexp optimiser optional |
cb1a09d0 | 5927 | |
b40eed9c | 5928 | =item UNITCHECK |
cb1a09d0 | 5929 | |
b40eed9c | 5930 | =item optional optimizer |
cb1a09d0 | 5931 | |
b40eed9c | 5932 | =item You WANT *how* many |
cb1a09d0 | 5933 | |
b40eed9c | 5934 | =item lexical aliases |
cb1a09d0 | 5935 | |
b40eed9c | 5936 | =item entersub XS vs Perl |
cb1a09d0 | 5937 | |
b40eed9c | 5938 | =item Self ties |
4755096e | 5939 | |
b40eed9c | 5940 | =item Optimize away @_ |
4755096e | 5941 | |
b40eed9c | 5942 | =item What hooks would assertions need? |
4755096e | 5943 | |
b40eed9c | 5944 | =back |
cb1a09d0 | 5945 | |
b40eed9c | 5946 | =item Big projects |
a6fb92f1 | 5947 | |
b40eed9c | 5948 | =over 4 |
53d7eaa8 | 5949 | |
b40eed9c | 5950 | =item make ithreads more robust |
fe9287c4 | 5951 | |
b40eed9c | 5952 | =item iCOW |
a2db77eb | 5953 | |
b40eed9c NC |
5954 | =item (?{...}) closures in regexps |
5955 | ||
5956 | =item A re-entrant regexp engine | |
a563e516 | 5957 | |
a45bd81d GS |
5958 | =back |
5959 | ||
4755096e GS |
5960 | =back |
5961 | ||
ee382f2f JH |
5962 | =head2 perldoc - Look up Perl documentation in Pod format. |
5963 | ||
5964 | =over 4 | |
5965 | ||
5966 | =item SYNOPSIS | |
5967 | ||
5968 | =item DESCRIPTION | |
5969 | ||
5970 | =item OPTIONS | |
5971 | ||
5972 | B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f> | |
5973 | I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d> | |
5974 | I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>, | |
5975 | B<-w> I<option:value> or B<-w> I<option>, B<-X>, | |
5976 | B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>, | |
5977 | B<-V> | |
5978 | ||
5979 | =item SECURITY | |
5980 | ||
5981 | =item ENVIRONMENT | |
5982 | ||
5983 | =item AUTHOR | |
5984 | ||
5985 | =back | |
5986 | ||
7029d033 | 5987 | =head2 perlhist - the Perl history records |
7d2bfb28 | 5988 | |
d420ca49 | 5989 | =over 4 |
7d2bfb28 | 5990 | |
7029d033 | 5991 | =item DESCRIPTION |
cb1a09d0 | 5992 | |
7029d033 | 5993 | =item INTRODUCTION |
cb1a09d0 | 5994 | |
7029d033 | 5995 | =item THE KEEPERS OF THE PUMPKIN |
cb1a09d0 | 5996 | |
d420ca49 | 5997 | =over 4 |
cb1a09d0 | 5998 | |
7029d033 | 5999 | =item PUMPKIN? |
cb1a09d0 | 6000 | |
a45bd81d GS |
6001 | =back |
6002 | ||
7029d033 | 6003 | =item THE RECORDS |
cb1a09d0 | 6004 | |
d420ca49 | 6005 | =over 4 |
cb1a09d0 | 6006 | |
7029d033 | 6007 | =item SELECTED RELEASE SIZES |
cb1a09d0 | 6008 | |
7029d033 | 6009 | =item SELECTED PATCH SIZES |
cb1a09d0 | 6010 | |
7029d033 | 6011 | =back |
cb1a09d0 | 6012 | |
7029d033 | 6013 | =item THE KEEPERS OF THE RECORDS |
cb1a09d0 | 6014 | |
a45bd81d GS |
6015 | =back |
6016 | ||
e1114e52 | 6017 | =head2 perldelta - what is new for perl v5.8.8 |
28a44ba0 JH |
6018 | |
6019 | =over 4 | |
6020 | ||
6021 | =item DESCRIPTION | |
6022 | ||
6023 | =item Incompatible Changes | |
6024 | ||
6025 | =item Core Enhancements | |
6026 | ||
b5a29516 | 6027 | =item Modules and Pragmata |
7f106169 | 6028 | |
b5a29516 | 6029 | =item Utility Changes |
7f106169 | 6030 | |
e1114e52 | 6031 | =item New Documentation |
a563e516 | 6032 | |
b5a29516 | 6033 | =item Performance Enhancements |
7f106169 | 6034 | |
a563e516 NC |
6035 | =item Installation and Configuration Improvements |
6036 | ||
b5a29516 NC |
6037 | =item Selected Bug Fixes |
6038 | ||
6039 | =item New or Changed Diagnostics | |
6040 | ||
6041 | =item Changed Internals | |
6042 | ||
e1114e52 NC |
6043 | =item New Tests |
6044 | ||
a563e516 NC |
6045 | =item Known Problems |
6046 | ||
97fc8adf NC |
6047 | =item Platform Specific Problems |
6048 | ||
6049 | =item Reporting Bugs | |
6050 | ||
6051 | =item SEE ALSO | |
6052 | ||
6053 | =back | |
6054 | ||
6055 | =head2 perl588delta, perldelta - what is new for perl v5.8.8 | |
6056 | ||
6057 | =over 4 | |
6058 | ||
6059 | =item DESCRIPTION | |
6060 | ||
6061 | =item Incompatible Changes | |
6062 | ||
6063 | =item Core Enhancements | |
6064 | ||
6065 | =item Modules and Pragmata | |
6066 | ||
6067 | =item Utility Changes | |
6068 | ||
6069 | =item New Documentation | |
6070 | ||
6071 | =item Performance Enhancements | |
6072 | ||
6073 | =item Installation and Configuration Improvements | |
6074 | ||
6075 | =item Selected Bug Fixes | |
6076 | ||
6077 | =item New or Changed Diagnostics | |
6078 | ||
6079 | =item Changed Internals | |
6080 | ||
6081 | =item New Tests | |
6082 | ||
6083 | =item Known Problems | |
6084 | ||
6085 | =item Platform Specific Problems | |
6086 | ||
b5a29516 NC |
6087 | =item Reporting Bugs |
6088 | ||
6089 | =item SEE ALSO | |
7f106169 NC |
6090 | |
6091 | =back | |
6092 | ||
55d31d93 | 6093 | =head2 perl587delta, perldelta - what is new for perl v5.8.7 |
28a44ba0 | 6094 | |
7f106169 | 6095 | =over 4 |
4c64e75b | 6096 | |
b5a29516 | 6097 | =item DESCRIPTION |
28a44ba0 | 6098 | |
b5a29516 | 6099 | =item Incompatible Changes |
7f106169 | 6100 | |
b5a29516 | 6101 | =item Core Enhancements |
7f106169 | 6102 | |
e7f2ff80 NC |
6103 | =over 4 |
6104 | ||
6105 | =item Unicode Character Database 4.1.0 | |
6106 | ||
6107 | =item suidperl less insecure | |
6108 | ||
6109 | =item Optional site customization script | |
6110 | ||
6111 | =item C<Config.pm> is now much smaller. | |
6112 | ||
6113 | =back | |
6114 | ||
b5a29516 | 6115 | =item Modules and Pragmata |
28a44ba0 | 6116 | |
0a7d7656 NC |
6117 | =item Utility Changes |
6118 | ||
e7f2ff80 NC |
6119 | =over 4 |
6120 | ||
6121 | =item find2perl enhancements | |
6122 | ||
6123 | =back | |
b5a29516 NC |
6124 | |
6125 | =item Performance Enhancements | |
6126 | ||
28a44ba0 JH |
6127 | =item Installation and Configuration Improvements |
6128 | ||
6129 | =item Selected Bug Fixes | |
6130 | ||
6131 | =item New or Changed Diagnostics | |
6132 | ||
6133 | =item Changed Internals | |
6134 | ||
b5a29516 | 6135 | =item Known Problems |
98c2f95b | 6136 | |
97fc8adf NC |
6137 | =item Platform Specific Problems |
6138 | ||
28a44ba0 JH |
6139 | =item Reporting Bugs |
6140 | ||
6141 | =item SEE ALSO | |
6142 | ||
6143 | =back | |
6144 | ||
55d31d93 NC |
6145 | =head2 perl586delta - what is new for perl v5.8.6 |
6146 | ||
6147 | =over 4 | |
6148 | ||
6149 | =item DESCRIPTION | |
6150 | ||
6151 | =item Incompatible Changes | |
6152 | ||
6153 | =item Core Enhancements | |
6154 | ||
6155 | =item Modules and Pragmata | |
6156 | ||
6157 | =item Utility Changes | |
6158 | ||
6159 | =item Performance Enhancements | |
6160 | ||
6161 | =item Selected Bug Fixes | |
6162 | ||
6163 | =item New or Changed Diagnostics | |
6164 | ||
6165 | =item Changed Internals | |
6166 | ||
6167 | =item New Tests | |
6168 | ||
6169 | =item Reporting Bugs | |
6170 | ||
6171 | =item SEE ALSO | |
6172 | ||
6173 | =back | |
6174 | ||
b5a29516 | 6175 | =head2 perl585delta - what is new for perl v5.8.5 |
1598f199 NC |
6176 | |
6177 | =over 4 | |
6178 | ||
6179 | =item DESCRIPTION | |
6180 | ||
6181 | =item Incompatible Changes | |
6182 | ||
6183 | =item Core Enhancements | |
6184 | ||
6185 | =item Modules and Pragmata | |
6186 | ||
6187 | =item Utility Changes | |
6188 | ||
d3ca9f77 NC |
6189 | =over 4 |
6190 | ||
6191 | =item Perl's debugger | |
6192 | ||
6193 | =item h2ph | |
6194 | ||
6195 | =back | |
6196 | ||
1598f199 NC |
6197 | =item Installation and Configuration Improvements |
6198 | ||
6199 | =item Selected Bug Fixes | |
6200 | ||
6201 | =item New or Changed Diagnostics | |
6202 | ||
6203 | =item Changed Internals | |
6204 | ||
1598f199 NC |
6205 | =item Known Problems |
6206 | ||
6207 | =item Platform Specific Problems | |
6208 | ||
6209 | =item Reporting Bugs | |
6210 | ||
6211 | =item SEE ALSO | |
6212 | ||
6213 | =back | |
6214 | ||
d3ca9f77 | 6215 | =head2 perl584delta - what is new for perl v5.8.4 |
80bf0786 NC |
6216 | |
6217 | =over 4 | |
6218 | ||
6219 | =item DESCRIPTION | |
6220 | ||
6221 | =item Incompatible Changes | |
6222 | ||
6223 | =item Core Enhancements | |
6224 | ||
7f106169 NC |
6225 | =over 4 |
6226 | ||
6227 | =item Malloc wrapping | |
6228 | ||
6229 | =item Unicode Character Database 4.0.1 | |
6230 | ||
6231 | =item suidperl less insecure | |
6232 | ||
6233 | =item format | |
6234 | ||
6235 | =back | |
6236 | ||
80bf0786 NC |
6237 | =item Modules and Pragmata |
6238 | ||
7f106169 | 6239 | =over 4 |
80bf0786 | 6240 | |
7f106169 NC |
6241 | =item Updated modules |
6242 | ||
6243 | Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find, | |
6244 | IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt, | |
6245 | Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable, | |
0a7d7656 NC |
6246 | Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32, |
6247 | base, open, threads, utf8 | |
7f106169 NC |
6248 | |
6249 | =back | |
80bf0786 NC |
6250 | |
6251 | =item Performance Enhancements | |
6252 | ||
0a7d7656 NC |
6253 | =item Utility Changes |
6254 | ||
80bf0786 NC |
6255 | =item Installation and Configuration Improvements |
6256 | ||
6257 | =item Selected Bug Fixes | |
6258 | ||
6259 | =item New or Changed Diagnostics | |
6260 | ||
6261 | =item Changed Internals | |
6262 | ||
7f106169 | 6263 | =item Future Directions |
80bf0786 | 6264 | |
0a7d7656 NC |
6265 | =item Platform Specific Problems |
6266 | ||
80bf0786 NC |
6267 | =item Reporting Bugs |
6268 | ||
6269 | =item SEE ALSO | |
6270 | ||
6271 | =back | |
6272 | ||
6273 | =head2 perl583delta - what is new for perl v5.8.3 | |
f6722d80 NC |
6274 | |
6275 | =over 4 | |
6276 | ||
6277 | =item DESCRIPTION | |
6278 | ||
6279 | =item Incompatible Changes | |
6280 | ||
6281 | =item Core Enhancements | |
6282 | ||
6283 | =item Modules and Pragmata | |
6284 | ||
6285 | CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util, | |
6286 | Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate, | |
6287 | Unicode::Normalize, Test::Harness, threads::shared | |
6288 | ||
6289 | =item Utility Changes | |
6290 | ||
6291 | =item New Documentation | |
6292 | ||
f6722d80 NC |
6293 | =item Installation and Configuration Improvements |
6294 | ||
6295 | =item Selected Bug Fixes | |
6296 | ||
6297 | =item New or Changed Diagnostics | |
6298 | ||
6299 | =item Changed Internals | |
6300 | ||
6301 | =item Configuration and Building | |
6302 | ||
98c2f95b | 6303 | =item Platform Specific Problems |
f6722d80 NC |
6304 | |
6305 | =item Known Problems | |
6306 | ||
98c2f95b NC |
6307 | =item Future Directions |
6308 | ||
6309 | =item Obituary | |
f6722d80 NC |
6310 | |
6311 | =item Reporting Bugs | |
6312 | ||
6313 | =item SEE ALSO | |
6314 | ||
6315 | =back | |
6316 | ||
98c2f95b | 6317 | =head2 perl582delta - what is new for perl v5.8.2 |
c66ca2ac NC |
6318 | |
6319 | =over 4 | |
6320 | ||
6321 | =item DESCRIPTION | |
6322 | ||
6323 | =item Incompatible Changes | |
6324 | ||
6325 | =item Core Enhancements | |
6326 | ||
6327 | =over 4 | |
6328 | ||
6329 | =item Hash Randomisation | |
6330 | ||
6331 | =item Threading | |
6332 | ||
6333 | =back | |
6334 | ||
6335 | =item Modules and Pragmata | |
6336 | ||
6337 | =over 4 | |
6338 | ||
6339 | =item Updated Modules And Pragmata | |
6340 | ||
6341 | Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64, | |
6342 | Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate, | |
6343 | Unicode::Normalize, UNIVERSAL | |
6344 | ||
6345 | =back | |
6346 | ||
6347 | =item Selected Bug Fixes | |
6348 | ||
6349 | =item Changed Internals | |
6350 | ||
6351 | =item Platform Specific Problems | |
6352 | ||
6353 | =item Future Directions | |
6354 | ||
6355 | =item Reporting Bugs | |
6356 | ||
6357 | =item SEE ALSO | |
6358 | ||
6359 | =back | |
6360 | ||
98c2f95b | 6361 | =head2 perl581delta - what is new for perl v5.8.1 |
d4432bb5 | 6362 | |
603b90a8 JH |
6363 | =over 4 |
6364 | ||
6365 | =item DESCRIPTION | |
6366 | ||
428dc699 JH |
6367 | =item Incompatible Changes |
6368 | ||
6e76d345 JH |
6369 | =over 4 |
6370 | ||
6371 | =item Hash Randomisation | |
6372 | ||
73fba812 JH |
6373 | =item UTF-8 On Filehandles No Longer Activated By Locale |
6374 | ||
6375 | =item Single-number v-strings are no longer v-strings before "=>" | |
6376 | ||
6377 | =item (Win32) The -C Switch Has Been Repurposed | |
6378 | ||
6379 | =item (Win32) The /d Switch Of cmd.exe | |
6e76d345 JH |
6380 | |
6381 | =back | |
6382 | ||
428dc699 JH |
6383 | =item Core Enhancements |
6384 | ||
6385 | =over 4 | |
6386 | ||
6e76d345 | 6387 | =item UTF-8 no longer default under UTF-8 locales |
69dc652e | 6388 | |
35c7d401 | 6389 | =item Unsafe signals again available |
d8416318 | 6390 | |
35c7d401 | 6391 | =item Tied Arrays with Negative Array Indices |
428dc699 | 6392 | |
6e76d345 JH |
6393 | =item local ${$x} |
6394 | ||
73fba812 | 6395 | =item Unicode Character Database 4.0.0 |
6e76d345 | 6396 | |
73fba812 | 6397 | =item Deprecation Warnings |
97f7c9df | 6398 | |
73fba812 | 6399 | =item Miscellaneous Enhancements |
34babc16 | 6400 | |
428dc699 JH |
6401 | =back |
6402 | ||
6403 | =item Modules and Pragmata | |
6404 | ||
6405 | =over 4 | |
6406 | ||
6a5cae29 | 6407 | =item Updated Modules And Pragmata |
428dc699 | 6408 | |
5fc2b853 GM |
6409 | base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, |
6410 | CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, | |
6411 | Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, | |
6412 | PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, | |
6413 | Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, | |
6414 | Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, | |
6415 | Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, | |
6416 | Win32::GetOSVersion | |
6417 | ||
428dc699 JH |
6418 | =back |
6419 | ||
6420 | =item Utility Changes | |
6421 | ||
6422 | =item New Documentation | |
6423 | ||
428dc699 JH |
6424 | =item Installation and Configuration Improvements |
6425 | ||
73fba812 JH |
6426 | =over 4 |
6427 | ||
6428 | =item Platform-specific enhancements | |
6429 | ||
6430 | =back | |
6431 | ||
428dc699 JH |
6432 | =item Selected Bug Fixes |
6433 | ||
73fba812 JH |
6434 | =over 4 |
6435 | ||
6436 | =item Closures, eval and lexicals | |
6437 | ||
6438 | =item Generic fixes | |
6439 | ||
73fba812 JH |
6440 | =item Platform-specific fixes |
6441 | ||
6442 | =back | |
6443 | ||
428dc699 JH |
6444 | =item New or Changed Diagnostics |
6445 | ||
6e76d345 JH |
6446 | =over 4 |
6447 | ||
6448 | =item Changed "A thread exited while %d threads were running" | |
6449 | ||
6450 | =item Removed "Attempt to clear a restricted hash" | |
6451 | ||
6452 | =item New "Illegal declaration of anonymous subroutine" | |
6453 | ||
6454 | =item Changed "Invalid range "%s" in transliteration operator" | |
6455 | ||
6456 | =item New "Missing control char name in \c" | |
6457 | ||
6458 | =item New "Newline in left-justified string for %s" | |
6459 | ||
6460 | =item New "Possible precedence problem on bitwise %c operator" | |
6461 | ||
6462 | =item New "Pseudo-hashes are deprecated" | |
6463 | ||
6464 | =item New "read() on %s filehandle %s" | |
6465 | ||
6466 | =item New "5.005 threads are deprecated" | |
6467 | ||
6468 | =item New "Tied variable freed while still in use" | |
6469 | ||
6470 | =item New "To%s: illegal mapping '%s'" | |
6471 | ||
5fc2b853 | 6472 | =item New "Use of freed value in iteration" |
6e76d345 JH |
6473 | |
6474 | =back | |
6475 | ||
428dc699 JH |
6476 | =item Changed Internals |
6477 | ||
428dc699 JH |
6478 | =item New Tests |
6479 | ||
6480 | =item Known Problems | |
6481 | ||
73fba812 JH |
6482 | =over 4 |
6483 | ||
5fc2b853 | 6484 | =item Tied hashes in scalar context |
73fba812 | 6485 | |
5fc2b853 | 6486 | =item Net::Ping 450_service and 510_ping_udp failures |
73fba812 | 6487 | |
6a5cae29 JH |
6488 | =item B::C |
6489 | ||
73fba812 JH |
6490 | =back |
6491 | ||
35c7d401 | 6492 | =item Platform Specific Problems |
28a2f804 | 6493 | |
6e76d345 JH |
6494 | =over 4 |
6495 | ||
73fba812 JH |
6496 | =item EBCDIC Platforms |
6497 | ||
5fc2b853 | 6498 | =item Cygwin 1.5 problems |
ae60962e | 6499 | |
5fc2b853 | 6500 | =item HP-UX: HP cc warnings about sendfile and sendpath |
73fba812 JH |
6501 | |
6502 | =item IRIX: t/uni/tr_7jis.t falsely failing | |
6503 | ||
ae60962e JH |
6504 | =item Mac OS X: no usemymalloc |
6505 | ||
73fba812 JH |
6506 | =item Tru64: No threaded builds with GNU cc (gcc) |
6507 | ||
6508 | =item Win32: sysopen, sysread, syswrite | |
6e76d345 JH |
6509 | |
6510 | =back | |
6511 | ||
73fba812 JH |
6512 | =item Future Directions |
6513 | ||
35c7d401 | 6514 | =item Reporting Bugs |
28a2f804 | 6515 | |
35c7d401 | 6516 | =item SEE ALSO |
28a2f804 JH |
6517 | |
6518 | =back | |
6519 | ||
98c2f95b | 6520 | =head2 perl58delta - what is new for perl v5.8.0 |
ee382f2f JH |
6521 | |
6522 | =over 4 | |
6523 | ||
6524 | =item DESCRIPTION | |
6525 | ||
6526 | =item Highlights In 5.8.0 | |
6527 | ||
6528 | =item Incompatible Changes | |
6529 | ||
6530 | =over 4 | |
6531 | ||
6532 | =item Binary Incompatibility | |
6533 | ||
6534 | =item 64-bit platforms and malloc | |
6535 | ||
6536 | =item AIX Dynaloading | |
6537 | ||
6538 | =item Attributes for C<my> variables now handled at run-time | |
6539 | ||
6540 | =item Socket Extension Dynamic in VMS | |
6541 | ||
6542 | =item IEEE-format Floating Point Default on OpenVMS Alpha | |
6543 | ||
6544 | =item New Unicode Semantics (no more C<use utf8>, almost) | |
6545 | ||
6546 | =item New Unicode Properties | |
6547 | ||
6548 | =item REF(...) Instead Of SCALAR(...) | |
6549 | ||
6550 | =item pack/unpack D/F recycled | |
6551 | ||
6552 | =item glob() now returns filenames in alphabetical order | |
6553 | ||
6554 | =item Deprecations | |
6555 | ||
6556 | =back | |
6557 | ||
6558 | =item Core Enhancements | |
6559 | ||
6560 | =over 4 | |
6561 | ||
6562 | =item Unicode Overhaul | |
6563 | ||
6564 | =item PerlIO is Now The Default | |
6565 | ||
6566 | =item ithreads | |
6567 | ||
6568 | =item Restricted Hashes | |
6569 | ||
6570 | =item Safe Signals | |
6571 | ||
6572 | =item Understanding of Numbers | |
6573 | ||
6574 | =item Arrays now always interpolate into double-quoted strings [561] | |
6575 | ||
6576 | =item Miscellaneous Changes | |
6577 | ||
6578 | =back | |
6579 | ||
6580 | =item Modules and Pragmata | |
6581 | ||
6582 | =over 4 | |
6583 | ||
6584 | =item New Modules and Pragmata | |
6585 | ||
6586 | =item Updated And Improved Modules and Pragmata | |
6587 | ||
6588 | =back | |
6589 | ||
6590 | =item Utility Changes | |
6591 | ||
6592 | =item New Documentation | |
6593 | ||
6594 | =item Performance Enhancements | |
6595 | ||
6596 | =item Installation and Configuration Improvements | |
6597 | ||
6598 | =over 4 | |
6599 | ||
6600 | =item Generic Improvements | |
6601 | ||
6602 | =item New Or Improved Platforms | |
6603 | ||
6604 | =back | |
6605 | ||
6606 | =item Selected Bug Fixes | |
6607 | ||
6608 | =over 4 | |
6609 | ||
6610 | =item Platform Specific Changes and Fixes | |
6611 | ||
6612 | =back | |
6613 | ||
6614 | =item New or Changed Diagnostics | |
6615 | ||
6616 | =item Changed Internals | |
6617 | ||
6618 | =item Security Vulnerability Closed [561] | |
6619 | ||
6620 | =item New Tests | |
6621 | ||
6622 | =item Known Problems | |
6623 | ||
6624 | =over 4 | |
6625 | ||
6626 | =item The Compiler Suite Is Still Very Experimental | |
6627 | ||
6628 | =item Localising Tied Arrays and Hashes Is Broken | |
6629 | ||
6630 | =item Building Extensions Can Fail Because Of Largefiles | |
6631 | ||
6632 | =item Modifying $_ Inside for(..) | |
6633 | ||
6634 | =item mod_perl 1.26 Doesn't Build With Threaded Perl | |
6635 | ||
6636 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
6637 | ||
6638 | =item libwww-perl (LWP) fails base/date #51 | |
6639 | ||
6640 | =item PDL failing some tests | |
6641 | ||
6642 | =item Perl_get_sv | |
6643 | ||
6644 | =item Self-tying Problems | |
6645 | ||
6646 | =item ext/threads/t/libc | |
6647 | ||
6648 | =item Failure of Thread (5.005-style) tests | |
6649 | ||
6650 | =item Timing problems | |
6651 | ||
6652 | =item Tied/Magical Array/Hash Elements Do Not Autovivify | |
6653 | ||
6654 | =item Unicode in package/class and subroutine names does not work | |
6655 | ||
6656 | =back | |
6657 | ||
6658 | =item Platform Specific Problems | |
6659 | ||
6660 | =over 4 | |
6661 | ||
6662 | =item AIX | |
6663 | ||
6664 | =item Alpha systems with old gccs fail several tests | |
6665 | ||
6666 | =item AmigaOS | |
6667 | ||
6668 | =item BeOS | |
6669 | ||
6670 | =item Cygwin "unable to remap" | |
6671 | ||
6672 | =item Cygwin ndbm tests fail on FAT | |
6673 | ||
6674 | =item DJGPP Failures | |
6675 | ||
6676 | =item FreeBSD built with ithreads coredumps reading large directories | |
6677 | ||
6678 | =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales | |
6679 | ||
6680 | =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5 | |
6681 | ||
6682 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured | |
6683 | ||
6684 | =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint | |
6685 | ||
6686 | =item Linux With Sfio Fails op/misc Test 48 | |
6687 | ||
6688 | =item Mac OS X | |
6689 | ||
6690 | =item Mac OS X dyld undefined symbols | |
6691 | ||
6692 | =item OS/2 Test Failures | |
6693 | ||
6694 | =item op/sprintf tests 91, 129, and 130 | |
6695 | ||
6696 | =item SCO | |
6697 | ||
6698 | =item Solaris 2.5 | |
6699 | ||
6700 | =item Solaris x86 Fails Tests With -Duse64bitint | |
6701 | ||
6702 | =item SUPER-UX (NEC SX) | |
6703 | ||
6704 | =item Term::ReadKey not working on Win32 | |
6705 | ||
6706 | =item UNICOS/mk | |
6707 | ||
6708 | =item UTS | |
6709 | ||
6710 | =item VOS (Stratus) | |
6711 | ||
6712 | =item VMS | |
6713 | ||
6714 | =item Win32 | |
6715 | ||
6716 | =item XML::Parser not working | |
6717 | ||
6718 | =item z/OS (OS/390) | |
6719 | ||
6720 | =item Unicode Support on EBCDIC Still Spotty | |
6721 | ||
6722 | =item Seen In Perl 5.7 But Gone Now | |
6723 | ||
6724 | =back | |
6725 | ||
6726 | =item Reporting Bugs | |
6727 | ||
6728 | =item SEE ALSO | |
6729 | ||
6730 | =item HISTORY | |
6731 | ||
6732 | =back | |
6733 | ||
35c7d401 | 6734 | =head2 perl573delta - what's new for perl v5.7.3 |
28a2f804 JH |
6735 | |
6736 | =over 4 | |
6737 | ||
35c7d401 | 6738 | =item DESCRIPTION |
428dc699 | 6739 | |
35c7d401 | 6740 | =item Changes |
428dc699 | 6741 | |
603b90a8 JH |
6742 | =item Reporting Bugs |
6743 | ||
6744 | =item SEE ALSO | |
6745 | ||
6746 | =item HISTORY | |
6747 | ||
6748 | =back | |
6749 | ||
d6483fcc | 6750 | =head2 perl572delta - what's new for perl v5.7.2 |
245d750e JH |
6751 | |
6752 | =over 4 | |
6753 | ||
6754 | =item DESCRIPTION | |
6755 | ||
6756 | =item Security Vulnerability Closed | |
6757 | ||
6758 | =item Incompatible Changes | |
6759 | ||
cb5953d6 JH |
6760 | =over 4 |
6761 | ||
6762 | =item 64-bit platforms and malloc | |
6763 | ||
e0539f61 JH |
6764 | =item AIX Dynaloading |
6765 | ||
6766 | =item Socket Extension Dynamic in VMS | |
6767 | ||
fbe3d936 JH |
6768 | =item Different Definition of the Unicode Character Classes \p{In...} |
6769 | ||
e0539f61 | 6770 | =item Deprecations |
772ff3b9 | 6771 | |
cb5953d6 JH |
6772 | =back |
6773 | ||
245d750e JH |
6774 | =item Core Enhancements |
6775 | ||
6776 | =item Modules and Pragmata | |
6777 | ||
6778 | =over 4 | |
6779 | ||
389925df | 6780 | =item New Modules and Distributions |
245d750e JH |
6781 | |
6782 | =item Updated And Improved Modules and Pragmata | |
6783 | ||
6784 | =back | |
6785 | ||
245d750e JH |
6786 | =item Utility Changes |
6787 | ||
6788 | =item New Documentation | |
6789 | ||
6790 | =item Installation and Configuration Improvements | |
6791 | ||
6792 | =over 4 | |
6793 | ||
6794 | =item New Or Improved Platforms | |
6795 | ||
6796 | =item Generic Improvements | |
6797 | ||
6798 | =back | |
6799 | ||
6800 | =item Selected Bug Fixes | |
6801 | ||
6802 | =over 4 | |
6803 | ||
6804 | =item Platform Specific Changes and Fixes | |
6805 | ||
6806 | =back | |
6807 | ||
6808 | =item New or Changed Diagnostics | |
6809 | ||
354a27bf | 6810 | =item Source Code Enhancements |
245d750e JH |
6811 | |
6812 | =over 4 | |
6813 | ||
354a27bf JH |
6814 | =item MAGIC constants |
6815 | ||
6816 | =item Better commented code | |
6817 | ||
245d750e JH |
6818 | =item Regex pre-/post-compilation items matched up |
6819 | ||
354a27bf JH |
6820 | =item gcc -Wall |
6821 | ||
245d750e JH |
6822 | =back |
6823 | ||
6824 | =item New Tests | |
6825 | ||
6826 | =item Known Problems | |
6827 | ||
6828 | =over 4 | |
6829 | ||
e0539f61 JH |
6830 | =item AIX |
6831 | ||
6832 | =item Amiga Perl Invoking Mystery | |
245d750e JH |
6833 | |
6834 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
6835 | ||
e0539f61 | 6836 | =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 |
245d750e | 6837 | |
07fcf8ff | 6838 | =item HP-UX lib/io_multihomed Fails When LP64-Configured |
245d750e | 6839 | |
e0539f61 | 6840 | =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured |
245d750e JH |
6841 | |
6842 | =item Linux With Sfio Fails op/misc Test 48 | |
6843 | ||
fbe3d936 JH |
6844 | =item OS/390 |
6845 | ||
e0539f61 | 6846 | =item op/sprintf tests 129 and 130 |
245d750e JH |
6847 | |
6848 | =item Failure of Thread tests | |
6849 | ||
e0539f61 JH |
6850 | =item UNICOS |
6851 | ||
e0539f61 JH |
6852 | =item UTS |
6853 | ||
354a27bf JH |
6854 | =item VMS |
6855 | ||
d0363f02 JH |
6856 | =item Win32 |
6857 | ||
245d750e JH |
6858 | =item Localising a Tied Variable Leaks Memory |
6859 | ||
6860 | =item Self-tying of Arrays and Hashes Is Forbidden | |
6861 | ||
cb5953d6 JH |
6862 | =item Variable Attributes are not Currently Usable for Tieing |
6863 | ||
245d750e JH |
6864 | =item Building Extensions Can Fail Because Of Largefiles |
6865 | ||
6866 | =item The Compiler Suite Is Still Experimental | |
6867 | ||
e0539f61 JH |
6868 | =item The Long Double Support is Still Experimental |
6869 | ||
245d750e JH |
6870 | =back |
6871 | ||
6872 | =item Reporting Bugs | |
6873 | ||
6874 | =item SEE ALSO | |
6875 | ||
6876 | =item HISTORY | |
6877 | ||
6878 | =back | |
6879 | ||
603b90a8 JH |
6880 | =head2 perl571delta - what's new for perl v5.7.1 |
6881 | ||
6882 | =over 4 | |
6883 | ||
6884 | =item DESCRIPTION | |
6885 | ||
6886 | =item Security Vulnerability Closed | |
6887 | ||
6888 | =item Incompatible Changes | |
6889 | ||
6890 | =item Core Enhancements | |
6891 | ||
245d750e JH |
6892 | =over 4 |
6893 | ||
2ca5449f JH |
6894 | =item AUTOLOAD Is Now Lvaluable |
6895 | ||
245d750e JH |
6896 | =item PerlIO is Now The Default |
6897 | ||
6898 | =item Signals Are Now Safe | |
6899 | ||
6900 | =back | |
6901 | ||
bd28ded5 | 6902 | =item Modules and Pragmata |
603b90a8 JH |
6903 | |
6904 | =over 4 | |
6905 | ||
603b90a8 JH |
6906 | =item New Modules |
6907 | ||
6908 | =item Updated And Improved Modules and Pragmata | |
6909 | ||
6910 | =back | |
6911 | ||
6912 | =item Performance Enhancements | |
6913 | ||
6914 | =item Utility Changes | |
6915 | ||
6916 | =item New Documentation | |
6917 | ||
6918 | =over 4 | |
6919 | ||
6920 | =item perlclib | |
6921 | ||
6922 | =item perliol | |
6923 | ||
6924 | =item README.aix | |
6925 | ||
6926 | =item README.bs2000 | |
6927 | ||
6928 | =item README.macos | |
6929 | ||
6930 | =item README.mpeix | |
6931 | ||
6932 | =item README.solaris | |
6933 | ||
6934 | =item README.vos | |
6935 | ||
6936 | =item Porting/repository.pod | |
6937 | ||
6938 | =back | |
6939 | ||
603b90a8 JH |
6940 | =item Installation and Configuration Improvements |
6941 | ||
6942 | =over 4 | |
6943 | ||
6944 | =item New Or Improved Platforms | |
6945 | ||
6946 | =item Generic Improvements | |
6947 | ||
bd28ded5 JH |
6948 | d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, |
6949 | need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, | |
6950 | d_strtoq, d_u32align, d_ualarm, d_usleep | |
6951 | ||
603b90a8 JH |
6952 | =back |
6953 | ||
6954 | =item Selected Bug Fixes | |
6955 | ||
6956 | =over 4 | |
6957 | ||
6958 | =item Platform Specific Changes and Fixes | |
6959 | ||
6960 | =back | |
6961 | ||
6962 | =item New or Changed Diagnostics | |
6963 | ||
6964 | =item Changed Internals | |
6965 | ||
bd28ded5 JH |
6966 | =item New Tests |
6967 | ||
603b90a8 JH |
6968 | =item Known Problems |
6969 | ||
6970 | =over 4 | |
6971 | ||
bd28ded5 JH |
6972 | =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl |
6973 | ||
6974 | =item lib/ftmp-security tests warn 'system possibly insecure' | |
6975 | ||
6976 | =item lib/io_multihomed Fails In LP64-Configured HP-UX | |
6977 | ||
6978 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX | |
6979 | ||
603b90a8 JH |
6980 | =item lib/b test 19 |
6981 | ||
bd28ded5 | 6982 | =item Linux With Sfio Fails op/misc Test 48 |
603b90a8 JH |
6983 | |
6984 | =item sigaction test 13 in VMS | |
6985 | ||
6986 | =item sprintf tests 129 and 130 | |
6987 | ||
bd28ded5 JH |
6988 | =item Failure of Thread tests |
6989 | ||
6990 | =item Localising a Tied Variable Leaks Memory | |
6991 | ||
603b90a8 JH |
6992 | =item Self-tying of Arrays and Hashes Is Forbidden |
6993 | ||
bd28ded5 JH |
6994 | =item Building Extensions Can Fail Because Of Largefiles |
6995 | ||
6996 | =item The Compiler Suite Is Still Experimental | |
6997 | ||
603b90a8 JH |
6998 | =back |
6999 | ||
7000 | =item Reporting Bugs | |
7001 | ||
7002 | =item SEE ALSO | |
7003 | ||
7004 | =item HISTORY | |
7005 | ||
7006 | =back | |
7007 | ||
7008 | =head2 perl570delta - what's new for perl v5.7.0 | |
694468e3 | 7009 | |
d420ca49 | 7010 | =over 4 |
694468e3 | 7011 | |
7029d033 | 7012 | =item DESCRIPTION |
694468e3 | 7013 | |
a9ef4385 JH |
7014 | =item Security Vulnerability Closed |
7015 | ||
7016 | =item Incompatible Changes | |
7017 | ||
7029d033 | 7018 | =item Core Enhancements |
694468e3 | 7019 | |
7029d033 | 7020 | =item Modules and Pragmata |
694468e3 | 7021 | |
d420ca49 | 7022 | =over 4 |
a9ef4385 JH |
7023 | |
7024 | =item New Modules | |
7025 | ||
7026 | =item Updated And Improved Modules and Pragmata | |
7027 | ||
7028 | =back | |
7029 | ||
7029d033 | 7030 | =item Utility Changes |
694468e3 | 7031 | |
a9ef4385 | 7032 | =item New Documentation |
694468e3 | 7033 | |
a9ef4385 | 7034 | =item Performance Enhancements |
694468e3 | 7035 | |
7029d033 | 7036 | =item Installation and Configuration Improvements |
694468e3 | 7037 | |
d420ca49 | 7038 | =over 4 |
694468e3 | 7039 | |
a9ef4385 | 7040 | =item Generic Improvements |
694468e3 | 7041 | |
4755096e | 7042 | =back |
694468e3 | 7043 | |
a9ef4385 | 7044 | =item Selected Bug Fixes |
694468e3 | 7045 | |
d420ca49 | 7046 | =over 4 |
cb1a09d0 | 7047 | |
a9ef4385 | 7048 | =item Platform Specific Changes and Fixes |
cb1a09d0 | 7049 | |
a9ef4385 | 7050 | =back |
cb1a09d0 | 7051 | |
a9ef4385 JH |
7052 | =item New or Changed Diagnostics |
7053 | ||
7054 | =item Changed Internals | |
cb1a09d0 | 7055 | |
4755096e | 7056 | =item Known Problems |
cb1a09d0 | 7057 | |
d420ca49 | 7058 | =over 4 |
a9ef4385 JH |
7059 | |
7060 | =item Unicode Support Still Far From Perfect | |
7061 | ||
7062 | =item EBCDIC Still A Lost Platform | |
7063 | ||
7064 | =item Building Extensions Can Fail Because Of Largefiles | |
7065 | ||
93d73c42 JH |
7066 | =item ftmp-security tests warn 'system possibly insecure' |
7067 | ||
b3b6085d PP |
7068 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
7069 | ||
93d73c42 | 7070 | =item Long Doubles Still Don't Work In Solaris |
9fa7f388 | 7071 | |
b3b6085d PP |
7072 | =item Linux With Sfio Fails op/misc Test 48 |
7073 | ||
9fa7f388 | 7074 | =item Storable tests fail in some platforms |
a9ef4385 | 7075 | |
93d73c42 JH |
7076 | =item Threads Are Still Experimental |
7077 | ||
7078 | =item The Compiler Suite Is Still Experimental | |
7079 | ||
a9ef4385 | 7080 | =back |
193fb0af | 7081 | |
4755096e | 7082 | =item Reporting Bugs |
8ebc5c01 | 7083 | |
4755096e | 7084 | =item SEE ALSO |
8ebc5c01 | 7085 | |
4755096e | 7086 | =item HISTORY |
8ebc5c01 | 7087 | |
a45bd81d GS |
7088 | =back |
7089 | ||
f502af34 | 7090 | =head2 perl561delta - what's new for perl v5.6.x |
493a87da JH |
7091 | |
7092 | =over 4 | |
7093 | ||
7094 | =item DESCRIPTION | |
7095 | ||
7096 | =item Summary of changes between 5.6.0 and 5.6.1 | |
7097 | ||
7098 | =over 4 | |
7099 | ||
7100 | =item Security Issues | |
7101 | ||
7102 | =item Core bug fixes | |
7103 | ||
7104 | C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(), | |
7105 | Bugs in regular expressions, "slurp" mode, Autovivification of symbolic | |
7106 | references to special variables, Lexical warnings, Spurious warnings and | |
7107 | errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes, | |
7108 | map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support, | |
7109 | Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no | |
7110 | Module;>, Tests | |
7111 | ||
7112 | =item Core features | |
7113 | ||
7114 | =item Configuration issues | |
7115 | ||
7116 | =item Documentation | |
7117 | ||
7118 | =item Bundled modules | |
7119 | ||
7120 | B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN, | |
7121 | Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll, | |
7122 | IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser, | |
7123 | Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash | |
7124 | ||
7125 | =item Platform-specific improvements | |
7126 | ||
7127 | NCR MP-RAS, NonStop-UX | |
7128 | ||
04b01f78 JH |
7129 | =back |
7130 | ||
7131 | =item Core Enhancements | |
7132 | ||
7133 | =over 4 | |
7134 | ||
493a87da JH |
7135 | =item Interpreter cloning, threads, and concurrency |
7136 | ||
7137 | =item Lexically scoped warning categories | |
7138 | ||
7139 | =item Unicode and UTF-8 support | |
7140 | ||
7141 | =item Support for interpolating named characters | |
7142 | ||
7143 | =item "our" declarations | |
7144 | ||
7145 | =item Support for strings represented as a vector of ordinals | |
7146 | ||
7147 | =item Improved Perl version numbering system | |
7148 | ||
7149 | =item New syntax for declaring subroutine attributes | |
7150 | ||
7151 | =item File and directory handles can be autovivified | |
7152 | ||
7153 | =item open() with more than two arguments | |
7154 | ||
7155 | =item 64-bit support | |
7156 | ||
7157 | =item Large file support | |
7158 | ||
7159 | =item Long doubles | |
7160 | ||
7161 | =item "more bits" | |
7162 | ||
7163 | =item Enhanced support for sort() subroutines | |
7164 | ||
7165 | =item C<sort $coderef @foo> allowed | |
7166 | ||
7167 | =item File globbing implemented internally | |
7168 | ||
7169 | =item Support for CHECK blocks | |
7170 | ||
7171 | =item POSIX character class syntax [: :] supported | |
7172 | ||
7173 | =item Better pseudo-random number generator | |
7174 | ||
7175 | =item Improved C<qw//> operator | |
7176 | ||
7177 | =item Better worst-case behavior of hashes | |
7178 | ||
7179 | =item pack() format 'Z' supported | |
7180 | ||
7181 | =item pack() format modifier '!' supported | |
7182 | ||
7183 | =item pack() and unpack() support counted strings | |
7184 | ||
7185 | =item Comments in pack() templates | |
7186 | ||
7187 | =item Weak references | |
7188 | ||
7189 | =item Binary numbers supported | |
7190 | ||
7191 | =item Lvalue subroutines | |
7192 | ||
7193 | =item Some arrows may be omitted in calls through references | |
7194 | ||
7195 | =item Boolean assignment operators are legal lvalues | |
7196 | ||
7197 | =item exists() is supported on subroutine names | |
7198 | ||
7199 | =item exists() and delete() are supported on array elements | |
7200 | ||
7201 | =item Pseudo-hashes work better | |
7202 | ||
7203 | =item Automatic flushing of output buffers | |
7204 | ||
7205 | =item Better diagnostics on meaningless filehandle operations | |
7206 | ||
7207 | =item Where possible, buffered data discarded from duped input filehandle | |
7208 | ||
7209 | =item eof() has the same old magic as <> | |
7210 | ||
7211 | =item binmode() can be used to set :crlf and :raw modes | |
7212 | ||
7213 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" | |
7214 | ||
7215 | =item system(), backticks and pipe open now reflect exec() failure | |
7216 | ||
7217 | =item Improved diagnostics | |
7218 | ||
7219 | =item Diagnostics follow STDERR | |
7220 | ||
7221 | =item More consistent close-on-exec behavior | |
7222 | ||
7223 | =item syswrite() ease-of-use | |
7224 | ||
7225 | =item Better syntax checks on parenthesized unary operators | |
7226 | ||
7227 | =item Bit operators support full native integer width | |
7228 | ||
7229 | =item Improved security features | |
7230 | ||
7231 | =item More functional bareword prototype (*) | |
7232 | ||
7233 | =item C<require> and C<do> may be overridden | |
7234 | ||
7235 | =item $^X variables may now have names longer than one character | |
7236 | ||
7237 | =item New variable $^C reflects C<-c> switch | |
7238 | ||
7239 | =item New variable $^V contains Perl version as a string | |
7240 | ||
7241 | =item Optional Y2K warnings | |
7242 | ||
7243 | =item Arrays now always interpolate into double-quoted strings | |
7244 | ||
b40eed9c NC |
7245 | =item @- and @+ provide starting/ending offsets of regex submatches |
7246 | ||
493a87da JH |
7247 | =back |
7248 | ||
7249 | =item Modules and Pragmata | |
7250 | ||
7251 | =over 4 | |
7252 | ||
7253 | =item Modules | |
7254 | ||
7255 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, | |
7256 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
7257 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
7258 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
7259 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
7260 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
7261 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
7262 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
7263 | ||
7264 | =item Pragmata | |
7265 | ||
7266 | =back | |
7267 | ||
7268 | =item Utility Changes | |
7269 | ||
7270 | =over 4 | |
7271 | ||
7272 | =item dprofpp | |
7273 | ||
7274 | =item find2perl | |
7275 | ||
7276 | =item h2xs | |
7277 | ||
7278 | =item perlcc | |
7279 | ||
7280 | =item perldoc | |
7281 | ||
7282 | =item The Perl Debugger | |
7283 | ||
7284 | =back | |
7285 | ||
7286 | =item Improved Documentation | |
7287 | ||
7288 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, | |
7289 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
7290 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
7291 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
7292 | ||
7293 | =item Performance enhancements | |
7294 | ||
7295 | =over 4 | |
7296 | ||
7297 | =item Simple sort() using { $a <=> $b } and the like are optimized | |
7298 | ||
7299 | =item Optimized assignments to lexical variables | |
7300 | ||
7301 | =item Faster subroutine calls | |
7302 | ||
7303 | =item delete(), each(), values() and hash iteration are faster | |
7304 | ||
7305 | =back | |
7306 | ||
7307 | =item Installation and Configuration Improvements | |
7308 | ||
7309 | =over 4 | |
7310 | ||
7311 | =item -Dusethreads means something different | |
7312 | ||
7313 | =item New Configure flags | |
7314 | ||
7315 | =item Threadedness and 64-bitness now more daring | |
7316 | ||
7317 | =item Long Doubles | |
7318 | ||
7319 | =item -Dusemorebits | |
7320 | ||
7321 | =item -Duselargefiles | |
7322 | ||
7323 | =item installusrbinperl | |
7324 | ||
7325 | =item SOCKS support | |
7326 | ||
7327 | =item C<-A> flag | |
7328 | ||
7329 | =item Enhanced Installation Directories | |
7330 | ||
7331 | =item gcc automatically tried if 'cc' does not seem to be working | |
7332 | ||
7333 | =back | |
7334 | ||
7335 | =item Platform specific changes | |
7336 | ||
7337 | =over 4 | |
7338 | ||
7339 | =item Supported platforms | |
7340 | ||
7341 | =item DOS | |
7342 | ||
7343 | =item OS390 (OpenEdition MVS) | |
7344 | ||
7345 | =item VMS | |
7346 | ||
7347 | =item Win32 | |
7348 | ||
7349 | =back | |
7350 | ||
7351 | =item Significant bug fixes | |
7352 | ||
7353 | =over 4 | |
7354 | ||
7355 | =item <HANDLE> on empty files | |
7356 | ||
7357 | =item C<eval '...'> improvements | |
7358 | ||
7359 | =item All compilation errors are true errors | |
7360 | ||
7361 | =item Implicitly closed filehandles are safer | |
7362 | ||
7363 | =item Behavior of list slices is more consistent | |
7364 | ||
7365 | =item C<(\$)> prototype and C<$foo{a}> | |
7366 | ||
7367 | =item C<goto &sub> and AUTOLOAD | |
7368 | ||
7369 | =item C<-bareword> allowed under C<use integer> | |
7370 | ||
7371 | =item Failures in DESTROY() | |
7372 | ||
7373 | =item Locale bugs fixed | |
7374 | ||
7375 | =item Memory leaks | |
7376 | ||
7377 | =item Spurious subroutine stubs after failed subroutine calls | |
7378 | ||
7379 | =item Taint failures under C<-U> | |
7380 | ||
7381 | =item END blocks and the C<-c> switch | |
7382 | ||
7383 | =item Potential to leak DATA filehandles | |
7384 | ||
7385 | =back | |
7386 | ||
7387 | =item New or Changed Diagnostics | |
7388 | ||
7389 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet | |
7390 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
7391 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
7392 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
7393 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
7394 | passed through, /%s/ should probably be written as "%s", %s() called too | |
7395 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
7396 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
7397 | subroutine name, %s package attribute may clash with future reserved word: | |
7398 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
7399 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
7400 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
7401 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
7402 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
7403 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
7404 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
7405 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
7406 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
7407 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
7408 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
7409 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
7410 | "local" instead of "our"?), Document contains no data, entering effective | |
7411 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
7412 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
7413 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
7414 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
7415 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
7416 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
7417 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
7418 | separator character %s in attribute list, Invalid separator character %s in | |
7419 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
7420 | returning %s not implemented yet, Method %s not permitted, Missing | |
7421 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
7422 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
7423 | No space allowed after -%c, no UTC offset information; assuming local time | |
7424 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
7425 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
7426 | around "%s" list, Possible unintended interpolation of %s in string, | |
7427 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
7428 | instead, Premature end of script headers, Repeat count in pack overflows, | |
7429 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
7430 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
7431 | zero-length expression, switching effective %s is not implemented, This | |
7432 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
7433 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
7434 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
7435 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
7436 | list, Unterminated attribute list, Unterminated attribute parameter in | |
7437 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
7438 | CLI symbol "%s" too long, Version number must be a constant number | |
7439 | ||
7440 | =item New tests | |
7441 | ||
7442 | =item Incompatible Changes | |
7443 | ||
7444 | =over 4 | |
7445 | ||
7446 | =item Perl Source Incompatibilities | |
7447 | ||
7448 | CHECK is a new keyword, Treatment of list slices of undef has changed, | |
7449 | Format of $English::PERL_VERSION is different, Literals of the form | |
7450 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
7451 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
7452 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
7453 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), | |
7454 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
7455 | Text of some diagnostic output has changed, C<%@> has been removed, | |
7456 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
7457 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
7458 | on 64-bit platforms, More builtins taint their results | |
7459 | ||
7460 | =item C Source Incompatibilities | |
7461 | ||
7462 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> | |
7463 | ||
7464 | =item Compatible C Source API Changes | |
7465 | ||
7466 | C<PATCHLEVEL> is now C<PERL_VERSION> | |
7467 | ||
7468 | =item Binary Incompatibilities | |
7469 | ||
7470 | =back | |
7471 | ||
7472 | =item Known Problems | |
7473 | ||
7474 | =over 4 | |
7475 | ||
7476 | =item Localizing a tied hash element may leak memory | |
7477 | ||
7478 | =item Known test failures | |
7479 | ||
493a87da JH |
7480 | =item EBCDIC platforms not fully supported |
7481 | ||
7482 | =item UNICOS/mk CC failures during Configure run | |
7483 | ||
7484 | =item Arrow operator and arrays | |
7485 | ||
7486 | =item Experimental features | |
7487 | ||
7488 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The | |
7489 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
7490 | globbing, The DB module, The regular expression code constructs: | |
7491 | ||
7492 | =back | |
7493 | ||
7494 | =item Obsolete Diagnostics | |
7495 | ||
7496 | Character class syntax [: :] is reserved for future extensions, Ill-formed | |
7497 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
7498 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
7499 | to mean "${$}<digit>" is deprecated | |
7500 | ||
7501 | =item Reporting Bugs | |
7502 | ||
7503 | =item SEE ALSO | |
7504 | ||
7505 | =item HISTORY | |
7506 | ||
7507 | =back | |
7508 | ||
f502af34 | 7509 | =head2 perl56delta - what's new for perl v5.6.0 |
14218588 | 7510 | |
d420ca49 | 7511 | =over 4 |
a45bd81d | 7512 | |
14218588 GS |
7513 | =item DESCRIPTION |
7514 | ||
4755096e | 7515 | =item Core Enhancements |
14218588 | 7516 | |
d420ca49 | 7517 | =over 4 |
14218588 | 7518 | |
4755096e | 7519 | =item Interpreter cloning, threads, and concurrency |
14218588 | 7520 | |
4755096e | 7521 | =item Lexically scoped warning categories |
14218588 | 7522 | |
4755096e | 7523 | =item Unicode and UTF-8 support |
14218588 | 7524 | |
4755096e | 7525 | =item Support for interpolating named characters |
14218588 | 7526 | |
4755096e | 7527 | =item "our" declarations |
14218588 | 7528 | |
4755096e | 7529 | =item Support for strings represented as a vector of ordinals |
14218588 | 7530 | |
4755096e | 7531 | =item Improved Perl version numbering system |
14218588 | 7532 | |
4755096e | 7533 | =item New syntax for declaring subroutine attributes |
14218588 | 7534 | |
4755096e | 7535 | =item File and directory handles can be autovivified |
14218588 | 7536 | |
4755096e | 7537 | =item open() with more than two arguments |
14218588 | 7538 | |
4755096e | 7539 | =item 64-bit support |
14218588 | 7540 | |
4755096e | 7541 | =item Large file support |
14218588 | 7542 | |
4755096e | 7543 | =item Long doubles |
14218588 | 7544 | |
4755096e | 7545 | =item "more bits" |
14218588 | 7546 | |
4755096e | 7547 | =item Enhanced support for sort() subroutines |
14218588 | 7548 | |
4755096e | 7549 | =item C<sort $coderef @foo> allowed |
14218588 | 7550 | |
4755096e | 7551 | =item File globbing implemented internally |
14218588 | 7552 | |
4755096e | 7553 | =item Support for CHECK blocks |
14218588 | 7554 | |
4755096e | 7555 | =item POSIX character class syntax [: :] supported |
14218588 | 7556 | |
4755096e | 7557 | =item Better pseudo-random number generator |
a45bd81d | 7558 | |
4755096e | 7559 | =item Improved C<qw//> operator |
8ebc5c01 | 7560 | |
4755096e | 7561 | =item Better worst-case behavior of hashes |
a45bd81d | 7562 | |
4755096e | 7563 | =item pack() format 'Z' supported |
8ebc5c01 | 7564 | |
4755096e | 7565 | =item pack() format modifier '!' supported |
8ebc5c01 | 7566 | |
4755096e | 7567 | =item pack() and unpack() support counted strings |
8ebc5c01 | 7568 | |
4755096e | 7569 | =item Comments in pack() templates |
8ebc5c01 | 7570 | |
4755096e | 7571 | =item Weak references |
8ebc5c01 | 7572 | |
4755096e | 7573 | =item Binary numbers supported |
8ebc5c01 | 7574 | |
4755096e | 7575 | =item Lvalue subroutines |
14218588 | 7576 | |
4755096e | 7577 | =item Some arrows may be omitted in calls through references |
8ebc5c01 | 7578 | |
4755096e | 7579 | =item Boolean assignment operators are legal lvalues |
8ebc5c01 | 7580 | |
4755096e | 7581 | =item exists() is supported on subroutine names |
8ebc5c01 | 7582 | |
4755096e | 7583 | =item exists() and delete() are supported on array elements |
cb1a09d0 | 7584 | |
4755096e | 7585 | =item Pseudo-hashes work better |
cb1a09d0 | 7586 | |
4755096e | 7587 | =item Automatic flushing of output buffers |
cb1a09d0 | 7588 | |
4755096e | 7589 | =item Better diagnostics on meaningless filehandle operations |
cb1a09d0 | 7590 | |
4755096e | 7591 | =item Where possible, buffered data discarded from duped input filehandle |
a45bd81d | 7592 | |
4755096e | 7593 | =item eof() has the same old magic as <> |
cb1a09d0 | 7594 | |
4755096e | 7595 | =item binmode() can be used to set :crlf and :raw modes |
a45bd81d | 7596 | |
4755096e | 7597 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
cb1a09d0 | 7598 | |
4755096e | 7599 | =item system(), backticks and pipe open now reflect exec() failure |
cb1a09d0 | 7600 | |
4755096e | 7601 | =item Improved diagnostics |
cb1a09d0 | 7602 | |
4755096e | 7603 | =item Diagnostics follow STDERR |
cb1a09d0 | 7604 | |
4755096e | 7605 | =item More consistent close-on-exec behavior |
cb1a09d0 | 7606 | |
4755096e | 7607 | =item syswrite() ease-of-use |
cb1a09d0 | 7608 | |
4755096e | 7609 | =item Better syntax checks on parenthesized unary operators |
cb1a09d0 | 7610 | |
4755096e | 7611 | =item Bit operators support full native integer width |
cb1a09d0 | 7612 | |
4755096e | 7613 | =item Improved security features |
cb1a09d0 | 7614 | |
4755096e | 7615 | =item More functional bareword prototype (*) |
cb1a09d0 | 7616 | |
4755096e | 7617 | =item C<require> and C<do> may be overridden |
cb1a09d0 | 7618 | |
4755096e | 7619 | =item $^X variables may now have names longer than one character |
4fdae800 | 7620 | |
4755096e | 7621 | =item New variable $^C reflects C<-c> switch |
cb1a09d0 | 7622 | |
4755096e | 7623 | =item New variable $^V contains Perl version as a string |
cb1a09d0 | 7624 | |
4755096e | 7625 | =item Optional Y2K warnings |
cb1a09d0 | 7626 | |
4755096e | 7627 | =item Arrays now always interpolate into double-quoted strings |
cb1a09d0 | 7628 | |
b40eed9c NC |
7629 | =item @- and @+ provide starting/ending offsets of regex matches |
7630 | ||
a45bd81d GS |
7631 | =back |
7632 | ||
4755096e | 7633 | =item Modules and Pragmata |
cb1a09d0 | 7634 | |
d420ca49 | 7635 | =over 4 |
a45bd81d | 7636 | |
4755096e | 7637 | =item Modules |
cb1a09d0 | 7638 | |
4755096e GS |
7639 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
7640 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
7641 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
7642 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
7643 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
7644 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
7645 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
7646 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
cb1a09d0 | 7647 | |
4755096e | 7648 | =item Pragmata |
cb1a09d0 | 7649 | |
4755096e | 7650 | =back |
cb1a09d0 | 7651 | |
4755096e | 7652 | =item Utility Changes |
cb1a09d0 | 7653 | |
d420ca49 | 7654 | =over 4 |
cb1a09d0 | 7655 | |
4755096e | 7656 | =item dprofpp |
cb1a09d0 | 7657 | |
4755096e | 7658 | =item find2perl |
cb1a09d0 | 7659 | |
4755096e | 7660 | =item h2xs |
cb1a09d0 | 7661 | |
4755096e | 7662 | =item perlcc |
cb1a09d0 | 7663 | |
4755096e GS |
7664 | =item perldoc |
7665 | ||
7666 | =item The Perl Debugger | |
cb1a09d0 | 7667 | |
a45bd81d GS |
7668 | =back |
7669 | ||
4755096e | 7670 | =item Improved Documentation |
cb1a09d0 | 7671 | |
4755096e GS |
7672 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
7673 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
7674 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
7675 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
a45bd81d | 7676 | |
4755096e | 7677 | =item Performance enhancements |
cb1a09d0 | 7678 | |
d420ca49 | 7679 | =over 4 |
cb1a09d0 | 7680 | |
4755096e | 7681 | =item Simple sort() using { $a <=> $b } and the like are optimized |
cb1a09d0 | 7682 | |
4755096e | 7683 | =item Optimized assignments to lexical variables |
193fb0af | 7684 | |
4755096e GS |
7685 | =item Faster subroutine calls |
7686 | ||
7687 | =item delete(), each(), values() and hash iteration are faster | |
193fb0af GS |
7688 | |
7689 | =back | |
7690 | ||
4755096e | 7691 | =item Installation and Configuration Improvements |
cb1a09d0 | 7692 | |
d420ca49 | 7693 | =over 4 |
cb1a09d0 | 7694 | |
4755096e | 7695 | =item -Dusethreads means something different |
68dc0745 | 7696 | |
4755096e | 7697 | =item New Configure flags |
68dc0745 | 7698 | |
4755096e | 7699 | =item Threadedness and 64-bitness now more daring |
68dc0745 | 7700 | |
4755096e | 7701 | =item Long Doubles |
cb1a09d0 | 7702 | |
4755096e | 7703 | =item -Dusemorebits |
55497cff | 7704 | |
4755096e GS |
7705 | =item -Duselargefiles |
7706 | ||
7707 | =item installusrbinperl | |
7708 | ||
7709 | =item SOCKS support | |
7710 | ||
7711 | =item C<-A> flag | |
7712 | ||
7713 | =item Enhanced Installation Directories | |
193fb0af | 7714 | |
8ebc5c01 | 7715 | =back |
7716 | ||
4755096e | 7717 | =item Platform specific changes |
55497cff | 7718 | |
d420ca49 | 7719 | =over 4 |
cb1a09d0 | 7720 | |
4755096e | 7721 | =item Supported platforms |
193fb0af | 7722 | |
4755096e | 7723 | =item DOS |
55497cff | 7724 | |
4755096e GS |
7725 | =item OS390 (OpenEdition MVS) |
7726 | ||
7727 | =item VMS | |
7728 | ||
7729 | =item Win32 | |
55497cff | 7730 | |
c90c0ff4 | 7731 | =back |
7732 | ||
4755096e | 7733 | =item Significant bug fixes |
c90c0ff4 | 7734 | |
d420ca49 | 7735 | =over 4 |
c90c0ff4 | 7736 | |
4755096e | 7737 | =item <HANDLE> on empty files |
c90c0ff4 | 7738 | |
4755096e | 7739 | =item C<eval '...'> improvements |
c90c0ff4 | 7740 | |
4755096e | 7741 | =item All compilation errors are true errors |
c90c0ff4 | 7742 | |
4755096e | 7743 | =item Implicitly closed filehandles are safer |
cb1a09d0 | 7744 | |
4755096e | 7745 | =item Behavior of list slices is more consistent |
cb1a09d0 | 7746 | |
4755096e | 7747 | =item C<(\$)> prototype and C<$foo{a}> |
cb1a09d0 | 7748 | |
4755096e | 7749 | =item C<goto &sub> and AUTOLOAD |
c90c0ff4 | 7750 | |
4755096e | 7751 | =item C<-bareword> allowed under C<use integer> |
c90c0ff4 | 7752 | |
4755096e | 7753 | =item Failures in DESTROY() |
cb1a09d0 | 7754 | |
4755096e GS |
7755 | =item Locale bugs fixed |
7756 | ||
7757 | =item Memory leaks | |
7758 | ||
7759 | =item Spurious subroutine stubs after failed subroutine calls | |
cb1a09d0 | 7760 | |
4755096e | 7761 | =item Taint failures under C<-U> |
55497cff | 7762 | |
4755096e | 7763 | =item END blocks and the C<-c> switch |
55497cff | 7764 | |
4755096e | 7765 | =item Potential to leak DATA filehandles |
55497cff | 7766 | |
a45bd81d GS |
7767 | =back |
7768 | ||
4755096e | 7769 | =item New or Changed Diagnostics |
a45bd81d | 7770 | |
4755096e GS |
7771 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
7772 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
7773 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
7774 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
7775 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
7776 | passed through, /%s/ should probably be written as "%s", %s() called too | |
7777 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
7778 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
7779 | subroutine name, %s package attribute may clash with future reserved word: | |
7780 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
7781 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
7782 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
7783 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
7784 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
7785 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
7786 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
7787 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
7788 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
7789 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
7790 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
7791 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
7792 | "local" instead of "our"?), Document contains no data, entering effective | |
7793 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
7794 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
7795 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
7796 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
7797 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
7798 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
7799 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
7800 | separator character %s in attribute list, Invalid separator character %s in | |
7801 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
7802 | returning %s not implemented yet, Method %s not permitted, Missing | |
7803 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
7804 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
7805 | No space allowed after -%c, no UTC offset information; assuming local time | |
7806 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
7807 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
7808 | around "%s" list, Possible unintended interpolation of %s in string, | |
7809 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
7810 | instead, Premature end of script headers, Repeat count in pack overflows, | |
7811 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
7812 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
7813 | zero-length expression, switching effective %s is not implemented, This | |
7814 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
7815 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
7816 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
7817 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
7818 | list, Unterminated attribute list, Unterminated attribute parameter in | |
7819 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
7820 | CLI symbol "%s" too long, Version number must be a constant number | |
14218588 | 7821 | |
4755096e | 7822 | =item New tests |
14218588 | 7823 | |
4755096e | 7824 | =item Incompatible Changes |
14218588 | 7825 | |
d420ca49 | 7826 | =over 4 |
14218588 | 7827 | |
4755096e | 7828 | =item Perl Source Incompatibilities |
14218588 | 7829 | |
4755096e GS |
7830 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
7831 | Format of $English::PERL_VERSION is different, Literals of the form | |
7832 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
7833 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
7834 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
983dbef6 JH |
7835 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(), |
7836 | values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, | |
7837 | Text of some diagnostic output has changed, C<%@> has been removed, | |
7838 | Parenthesized not() behaves like a list operator, Semantics of bareword | |
7839 | prototype C<(*)> have changed, Semantics of bit operators may have changed | |
7840 | on 64-bit platforms, More builtins taint their results | |
14218588 | 7841 | |
4755096e | 7842 | =item C Source Incompatibilities |
14218588 | 7843 | |
4755096e | 7844 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
14218588 | 7845 | |
4755096e | 7846 | =item Compatible C Source API Changes |
a45bd81d | 7847 | |
4755096e | 7848 | C<PATCHLEVEL> is now C<PERL_VERSION> |
55497cff | 7849 | |
4755096e | 7850 | =item Binary Incompatibilities |
a45bd81d | 7851 | |
4755096e | 7852 | =back |
55497cff | 7853 | |
4755096e | 7854 | =item Known Problems |
55497cff | 7855 | |
d420ca49 | 7856 | =over 4 |
55497cff | 7857 | |
4755096e | 7858 | =item Thread test failures |
b38f6a39 | 7859 | |
4755096e | 7860 | =item EBCDIC platforms not supported |
774d564b | 7861 | |
4755096e | 7862 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
774d564b | 7863 | |
4755096e | 7864 | =item NEXTSTEP 3.3 POSIX test failure |
774d564b | 7865 | |
4755096e GS |
7866 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
7867 | gcc | |
cb1a09d0 | 7868 | |
4755096e | 7869 | =item UNICOS/mk CC failures during Configure run |
cb1a09d0 | 7870 | |
4755096e | 7871 | =item Arrow operator and arrays |
cb1a09d0 | 7872 | |
4755096e | 7873 | =item Experimental features |
cb1a09d0 | 7874 | |
4755096e GS |
7875 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
7876 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
983dbef6 | 7877 | globbing, The DB module, The regular expression code constructs: |
cb1a09d0 | 7878 | |
b38f6a39 | 7879 | =back |
cb1a09d0 | 7880 | |
4755096e | 7881 | =item Obsolete Diagnostics |
b38f6a39 | 7882 | |
4755096e GS |
7883 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
7884 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
7885 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
7886 | to mean "${$}<digit>" is deprecated | |
7887 | ||
7888 | =item Reporting Bugs | |
cb1a09d0 | 7889 | |
b38f6a39 | 7890 | =item SEE ALSO |
cb1a09d0 | 7891 | |
4755096e | 7892 | =item HISTORY |
193fb0af | 7893 | |
8ebc5c01 | 7894 | =back |
cb1a09d0 | 7895 | |
f502af34 | 7896 | =head2 perl5005delta - what's new for perl5.005 |
193fb0af | 7897 | |
d420ca49 | 7898 | =over 4 |
193fb0af | 7899 | |
b38f6a39 | 7900 | =item DESCRIPTION |
193fb0af | 7901 | |
4755096e | 7902 | =item About the new versioning system |
193fb0af | 7903 | |
4755096e | 7904 | =item Incompatible Changes |
193fb0af | 7905 | |
d420ca49 | 7906 | =over 4 |
b38f6a39 | 7907 | |
4755096e | 7908 | =item WARNING: This version is not binary compatible with Perl 5.004. |
b38f6a39 | 7909 | |
4755096e | 7910 | =item Default installation structure has changed |
b38f6a39 | 7911 | |
4755096e | 7912 | =item Perl Source Compatibility |
193fb0af | 7913 | |
4755096e | 7914 | =item C Source Compatibility |
b38f6a39 | 7915 | |
4755096e | 7916 | =item Binary Compatibility |
b38f6a39 | 7917 | |
4755096e | 7918 | =item Security fixes may affect compatibility |
b38f6a39 | 7919 | |
4755096e | 7920 | =item Relaxed new mandatory warnings introduced in 5.004 |
b38f6a39 | 7921 | |
4755096e | 7922 | =item Licensing |
193fb0af GS |
7923 | |
7924 | =back | |
cb1a09d0 | 7925 | |
4755096e | 7926 | =item Core Changes |
fb9cefb4 | 7927 | |
d420ca49 | 7928 | =over 4 |
fb9cefb4 | 7929 | |
4755096e | 7930 | =item Threads |
fb9cefb4 | 7931 | |
4755096e | 7932 | =item Compiler |
fb9cefb4 | 7933 | |
4755096e | 7934 | =item Regular Expressions |
fb9cefb4 | 7935 | |
4755096e GS |
7936 | Many new and improved optimizations, Many bug fixes, New regular expression |
7937 | constructs, New operator for precompiled regular expressions, Other | |
7938 | improvements, Incompatible changes | |
fb9cefb4 | 7939 | |
4755096e | 7940 | =item Improved malloc() |
fb9cefb4 | 7941 | |
4755096e | 7942 | =item Quicksort is internally implemented |
ac65edd0 | 7943 | |
4755096e | 7944 | =item Reliable signals |
ac65edd0 | 7945 | |
4755096e | 7946 | =item Reliable stack pointers |
ac65edd0 | 7947 | |
4755096e | 7948 | =item More generous treatment of carriage returns |
ac65edd0 | 7949 | |
4755096e | 7950 | =item Memory leaks |
ac65edd0 | 7951 | |
4755096e | 7952 | =item Better support for multiple interpreters |
ac65edd0 | 7953 | |
4755096e | 7954 | =item Behavior of local() on array and hash elements is now well-defined |
ac65edd0 | 7955 | |
4755096e | 7956 | =item C<%!> is transparently tied to the L<Errno> module |
ac65edd0 | 7957 | |
4755096e | 7958 | =item Pseudo-hashes are supported |
b38f6a39 | 7959 | |
4755096e | 7960 | =item C<EXPR foreach EXPR> is supported |
ac65edd0 | 7961 | |
4755096e | 7962 | =item Keywords can be globally overridden |
ac65edd0 | 7963 | |
4755096e | 7964 | =item C<$^E> is meaningful on Win32 |
ac65edd0 | 7965 | |
4755096e | 7966 | =item C<foreach (1..1000000)> optimized |
cb1a09d0 | 7967 | |
4755096e | 7968 | =item C<Foo::> can be used as implicitly quoted package name |
a45bd81d | 7969 | |
4755096e | 7970 | =item C<exists $Foo::{Bar::}> tests existence of a package |
cb1a09d0 | 7971 | |
4755096e | 7972 | =item Better locale support |
a45bd81d | 7973 | |
4755096e | 7974 | =item Experimental support for 64-bit platforms |
cb1a09d0 | 7975 | |
4755096e | 7976 | =item prototype() returns useful results on builtins |
a45bd81d | 7977 | |
4755096e | 7978 | =item Extended support for exception handling |
cb1a09d0 | 7979 | |
4755096e | 7980 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods |
cb1a09d0 | 7981 | |
4755096e | 7982 | =item All C<printf> format conversions are handled internally |
55497cff | 7983 | |
4755096e | 7984 | =item New C<INIT> keyword |
b971f6e4 | 7985 | |
4755096e | 7986 | =item New C<lock> keyword |
cb1a09d0 | 7987 | |
4755096e | 7988 | =item New C<qr//> operator |
a6006777 | 7989 | |
4755096e | 7990 | =item C<our> is now a reserved word |
68dc0745 | 7991 | |
4755096e | 7992 | =item Tied arrays are now fully supported |
cb1a09d0 | 7993 | |
4755096e GS |
7994 | =item Tied handles support is better |
7995 | ||
7996 | =item 4th argument to substr | |
7997 | ||
7998 | =item Negative LENGTH argument to splice | |
7999 | ||
8000 | =item Magic lvalues are now more magical | |
8001 | ||
8002 | =item <> now reads in records | |
193fb0af | 8003 | |
a45bd81d GS |
8004 | =back |
8005 | ||
4755096e | 8006 | =item Supported Platforms |
cb1a09d0 | 8007 | |
d420ca49 | 8008 | =over 4 |
a45bd81d | 8009 | |
4755096e | 8010 | =item New Platforms |
cb1a09d0 | 8011 | |
4755096e | 8012 | =item Changes in existing support |
cb1a09d0 | 8013 | |
4755096e | 8014 | =back |
cb1a09d0 | 8015 | |
4755096e | 8016 | =item Modules and Pragmata |
cb1a09d0 | 8017 | |
d420ca49 | 8018 | =over 4 |
cb1a09d0 | 8019 | |
4755096e | 8020 | =item New Modules |
cb1a09d0 | 8021 | |
4755096e GS |
8022 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, |
8023 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
8024 | Thread, attrs, fields, re | |
cb1a09d0 | 8025 | |
4755096e | 8026 | =item Changes in existing modules |
cb1a09d0 | 8027 | |
4755096e | 8028 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, |
4d4e713d | 8029 | MakeMaker, CPAN, Cwd |
cb1a09d0 | 8030 | |
4755096e | 8031 | =back |
cb1a09d0 | 8032 | |
4755096e | 8033 | =item Utility Changes |
cb1a09d0 | 8034 | |
4755096e GS |
8035 | =item Documentation Changes |
8036 | ||
8037 | =item New Diagnostics | |
8038 | ||
8039 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
8040 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
8041 | package, Can't call method "%s" on an undefined value, Can't check | |
8042 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
8043 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
8044 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
8045 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
8046 | Character class syntax [: :] is reserved for future extensions, Character | |
8047 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
8048 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
8049 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
8050 | package main), Illegal hex digit ignored, No such array field, No such | |
8051 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
8052 | large request, Range iterator outside integer range, Recursive inheritance | |
ab648d5e JH |
8053 | detected while looking for method '%s' %s, Reference found where even-sized |
8054 | list expected, Undefined value assigned to typeglob, Use of reserved word | |
8055 | "%s" is deprecated, perl: warning: Setting locale failed | |
cb1a09d0 | 8056 | |
4755096e | 8057 | =item Obsolete Diagnostics |
cb1a09d0 | 8058 | |
4755096e GS |
8059 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open |
8060 | temporary file, regexp too big | |
cb1a09d0 | 8061 | |
4755096e | 8062 | =item Configuration Changes |
cb1a09d0 | 8063 | |
4755096e | 8064 | =item BUGS |
cb1a09d0 | 8065 | |
4755096e | 8066 | =item SEE ALSO |
cb1a09d0 | 8067 | |
4755096e | 8068 | =item HISTORY |
cb1a09d0 | 8069 | |
4755096e | 8070 | =back |
cb1a09d0 | 8071 | |
f502af34 | 8072 | =head2 perl5004delta - what's new for perl5.004 |
cb1a09d0 | 8073 | |
d420ca49 | 8074 | =over 4 |
cb1a09d0 | 8075 | |
4755096e | 8076 | =item DESCRIPTION |
cb1a09d0 | 8077 | |
4755096e | 8078 | =item Supported Environments |
cb1a09d0 | 8079 | |
4755096e | 8080 | =item Core Changes |
cb1a09d0 | 8081 | |
d420ca49 | 8082 | =over 4 |
cb1a09d0 | 8083 | |
4755096e | 8084 | =item List assignment to %ENV works |
cb1a09d0 | 8085 | |
d420ca49 | 8086 | =item Change to "Can't locate Foo.pm in @INC" error |
cb1a09d0 | 8087 | |
4755096e | 8088 | =item Compilation option: Binary compatibility with 5.003 |
cb1a09d0 | 8089 | |
4755096e | 8090 | =item $PERL5OPT environment variable |
cb1a09d0 | 8091 | |
4755096e | 8092 | =item Limitations on B<-M>, B<-m>, and B<-T> options |
cb1a09d0 | 8093 | |
4755096e | 8094 | =item More precise warnings |
cb1a09d0 | 8095 | |
4755096e | 8096 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods |
cb1a09d0 | 8097 | |
4755096e | 8098 | =item Previously deprecated %OVERLOAD is no longer usable |
cb1a09d0 | 8099 | |
4755096e | 8100 | =item Subroutine arguments created only when they're modified |
cb1a09d0 | 8101 | |
4755096e | 8102 | =item Group vector changeable with C<$)> |
a45bd81d | 8103 | |
4755096e | 8104 | =item Fixed parsing of $$<digit>, &$<digit>, etc. |
fb9cefb4 | 8105 | |
4755096e | 8106 | =item Fixed localization of $<digit>, $&, etc. |
a45bd81d | 8107 | |
4755096e | 8108 | =item No resetting of $. on implicit close |
fb9cefb4 | 8109 | |
4755096e | 8110 | =item C<wantarray> may return undef |
fb9cefb4 | 8111 | |
4755096e | 8112 | =item C<eval EXPR> determines value of EXPR in scalar context |
fb9cefb4 | 8113 | |
4755096e | 8114 | =item Changes to tainting checks |
fb9cefb4 | 8115 | |
4755096e GS |
8116 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No |
8117 | spawning if tainted $TERM doesn't look like a terminal name | |
fb9cefb4 | 8118 | |
4755096e | 8119 | =item New Opcode module and revised Safe module |
14218588 | 8120 | |
4755096e | 8121 | =item Embedding improvements |
fb9cefb4 | 8122 | |
4755096e | 8123 | =item Internal change: FileHandle class based on IO::* classes |
fb9cefb4 | 8124 | |
4755096e | 8125 | =item Internal change: PerlIO abstraction interface |
fb9cefb4 | 8126 | |
4755096e | 8127 | =item New and changed syntax |
fb9cefb4 | 8128 | |
4755096e | 8129 | $coderef->(PARAMS) |
fb9cefb4 | 8130 | |
4755096e | 8131 | =item New and changed builtin constants |
fb9cefb4 | 8132 | |
4755096e | 8133 | __PACKAGE__ |
14218588 | 8134 | |
4755096e | 8135 | =item New and changed builtin variables |
14218588 | 8136 | |
4755096e | 8137 | $^E, $^H, $^M |
fb9cefb4 | 8138 | |
4755096e | 8139 | =item New and changed builtin functions |
fb9cefb4 | 8140 | |
4755096e GS |
8141 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in |
8142 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
8143 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
8144 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
8145 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
fb9cefb4 | 8146 | |
4755096e | 8147 | =item New builtin methods |
fb9cefb4 | 8148 | |
4755096e | 8149 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
fb9cefb4 | 8150 | |
4755096e | 8151 | =item TIEHANDLE now supported |
fb9cefb4 | 8152 | |
4755096e GS |
8153 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this |
8154 | LIST, READLINE this, GETC this, DESTROY this | |
fb9cefb4 | 8155 | |
4755096e | 8156 | =item Malloc enhancements |
fb9cefb4 | 8157 | |
4755096e | 8158 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE |
fb9cefb4 | 8159 | |
4755096e | 8160 | =item Miscellaneous efficiency enhancements |
fb9cefb4 | 8161 | |
4755096e | 8162 | =back |
fb9cefb4 | 8163 | |
4755096e | 8164 | =item Support for More Operating Systems |
fb9cefb4 | 8165 | |
d420ca49 | 8166 | =over 4 |
fb9cefb4 | 8167 | |
4755096e | 8168 | =item Win32 |
14218588 | 8169 | |
4755096e | 8170 | =item Plan 9 |
fb9cefb4 | 8171 | |
4755096e | 8172 | =item QNX |
fb9cefb4 | 8173 | |
4755096e | 8174 | =item AmigaOS |
fb9cefb4 | 8175 | |
fb9cefb4 GS |
8176 | =back |
8177 | ||
4755096e GS |
8178 | =item Pragmata |
8179 | ||
8180 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
8181 | constant NAME => VALUE, use locale, use ops, use vmsish | |
8182 | ||
8183 | =item Modules | |
fb9cefb4 | 8184 | |
d420ca49 | 8185 | =over 4 |
fb9cefb4 | 8186 | |
4755096e | 8187 | =item Required Updates |
fb9cefb4 | 8188 | |
4755096e | 8189 | =item Installation directories |
fb9cefb4 | 8190 | |
4755096e | 8191 | =item Module information summary |
fb9cefb4 | 8192 | |
4755096e | 8193 | =item Fcntl |
14218588 | 8194 | |
4755096e | 8195 | =item IO |
14218588 | 8196 | |
4755096e | 8197 | =item Math::Complex |
b38f6a39 | 8198 | |
4755096e | 8199 | =item Math::Trig |
37590e52 | 8200 | |
4755096e | 8201 | =item DB_File |
fb9cefb4 | 8202 | |
4755096e GS |
8203 | =item Net::Ping |
8204 | ||
8205 | =item Object-oriented overrides for builtin operators | |
fb9cefb4 | 8206 | |
a45bd81d GS |
8207 | =back |
8208 | ||
4755096e | 8209 | =item Utility Changes |
cb1a09d0 | 8210 | |
d420ca49 | 8211 | =over 4 |
a45bd81d | 8212 | |
4755096e | 8213 | =item pod2html |
a45bd81d | 8214 | |
4755096e | 8215 | Sends converted HTML to standard output |
cb1a09d0 | 8216 | |
4755096e | 8217 | =item xsubpp |
a45bd81d | 8218 | |
4755096e | 8219 | C<void> XSUBs now default to returning nothing |
cb1a09d0 | 8220 | |
4755096e | 8221 | =back |
d516a115 | 8222 | |
4755096e | 8223 | =item C Language API Changes |
d516a115 | 8224 | |
4755096e GS |
8225 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for |
8226 | manipulating hashes | |
d516a115 | 8227 | |
4755096e | 8228 | =item Documentation Changes |
d516a115 | 8229 | |
4755096e GS |
8230 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, |
8231 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
d516a115 | 8232 | |
4755096e | 8233 | =item New Diagnostics |
cb1a09d0 | 8234 | |
4755096e GS |
8235 | "my" variable %s masks earlier declaration in same scope, %s argument is |
8236 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
8237 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
8238 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
8239 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
8240 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
8241 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
8242 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
8243 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
8244 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
8245 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
8246 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
8247 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
8248 | possible typo, Null picture in formline, Offset outside string, Out of | |
8249 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
8250 | attempt to put comments in qw() list, Possible attempt to separate words | |
8251 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
ab648d5e JH |
8252 | while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" |
8253 | option, untie attempted while %d inner references still exist, Unrecognized | |
8254 | character %s, Unsupported function fork, Use of "$$<digit>" to mean | |
8255 | "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(), | |
8256 | Variable "%s" may be unavailable, Variable "%s" will not stay shared, | |
8257 | Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, | |
8258 | Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too | |
8259 | long, Process terminated by SIG%s | |
cb1a09d0 | 8260 | |
4755096e | 8261 | =item BUGS |
d516a115 | 8262 | |
8ebc5c01 | 8263 | =item SEE ALSO |
cb1a09d0 | 8264 | |
4755096e | 8265 | =item HISTORY |
cb1a09d0 | 8266 | |
1184f6df JH |
8267 | =back |
8268 | ||
50e34432 | 8269 | =head2 perlartistic - the Perl Artistic License |
1184f6df JH |
8270 | |
8271 | =over 4 | |
8272 | ||
8273 | =item SYNOPSIS | |
8274 | ||
8275 | =item DESCRIPTION | |
8276 | ||
ee382f2f | 8277 | =item The "Artistic License" |
37d4d706 | 8278 | |
d420ca49 | 8279 | =over 4 |
37d4d706 | 8280 | |
ee382f2f | 8281 | =item Preamble |
37d4d706 | 8282 | |
1184f6df JH |
8283 | =item Definitions |
8284 | ||
6e76d345 JH |
8285 | "Package", "Standard Version", "Copyright Holder", "You", "Reasonable |
8286 | copying fee", "Freely Available" | |
1184f6df JH |
8287 | |
8288 | =item Conditions | |
37d4d706 | 8289 | |
6e76d345 JH |
8290 | a), b), c), d), a), b), c), d) |
8291 | ||
ee382f2f | 8292 | =back |
37d4d706 | 8293 | |
35c7d401 | 8294 | =back |
37d4d706 | 8295 | |
50e34432 | 8296 | =head2 perlgpl - the GNU General Public License, version 2 |
1184f6df | 8297 | |
ee382f2f JH |
8298 | =over 4 |
8299 | ||
1184f6df JH |
8300 | =item SYNOPSIS |
8301 | ||
8302 | =back | |
37d4d706 | 8303 | |
35c7d401 | 8304 | =over 4 |
37d4d706 | 8305 | |
1184f6df | 8306 | =item DESCRIPTION |
37d4d706 | 8307 | |
1184f6df | 8308 | =item GNU GENERAL PUBLIC LICENSE |
37d4d706 | 8309 | |
35c7d401 | 8310 | =back |
37d4d706 | 8311 | |
ee382f2f | 8312 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems |
37d4d706 | 8313 | |
35c7d401 | 8314 | =over 4 |
37d4d706 | 8315 | |
35c7d401 | 8316 | =item DESCRIPTION |
37d4d706 | 8317 | |
ee382f2f | 8318 | =over 4 |
a83b6f46 | 8319 | |
ee382f2f | 8320 | =item Compiling Perl 5 on AIX |
a83b6f46 | 8321 | |
ee382f2f | 8322 | =item OS level |
a83b6f46 | 8323 | |
ee382f2f | 8324 | =item Building Dynamic Extensions on AIX |
a83b6f46 | 8325 | |
ee382f2f | 8326 | =item The IBM ANSI C Compiler |
35c7d401 | 8327 | |
cd458e05 JH |
8328 | =item The usenm option |
8329 | ||
ee382f2f | 8330 | =item Using GNU's gcc for building perl |
a83b6f46 | 8331 | |
ee382f2f | 8332 | =item Using Large Files with Perl |
cb1a09d0 | 8333 | |
ee382f2f | 8334 | =item Threaded Perl |
a45bd81d | 8335 | |
ee382f2f | 8336 | =item 64-bit Perl |
cb1a09d0 | 8337 | |
ee382f2f | 8338 | =item AIX 4.2 and extensions using C++ with statics |
a45bd81d | 8339 | |
ee382f2f | 8340 | =back |
a45bd81d | 8341 | |
ee382f2f | 8342 | =item AUTHOR |
cb1a09d0 | 8343 | |
ee382f2f | 8344 | =item DATE |
35c7d401 | 8345 | |
ee382f2f | 8346 | =back |
cb1a09d0 | 8347 | |
ee382f2f | 8348 | =head2 perlamiga - Perl under Amiga OS |
35c7d401 JH |
8349 | |
8350 | =over 4 | |
8351 | ||
ee382f2f JH |
8352 | =item NOTE |
8353 | ||
35c7d401 | 8354 | =item SYNOPSIS |
cb1a09d0 | 8355 | |
ee382f2f | 8356 | =back |
cb1a09d0 | 8357 | |
d420ca49 | 8358 | =over 4 |
cb1a09d0 | 8359 | |
ee382f2f | 8360 | =item DESCRIPTION |
35c7d401 | 8361 | |
ee382f2f | 8362 | =over 4 |
35c7d401 | 8363 | |
ee382f2f | 8364 | =item Prerequisites for Compiling Perl on AmigaOS |
cb1a09d0 | 8365 | |
ee382f2f | 8366 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> |
cb1a09d0 | 8367 | |
ee382f2f | 8368 | =item Starting Perl programs under AmigaOS |
4755096e | 8369 | |
ee382f2f | 8370 | =item Shortcomings of Perl under AmigaOS |
cb1a09d0 | 8371 | |
8ebc5c01 | 8372 | =back |
cb1a09d0 | 8373 | |
ee382f2f JH |
8374 | =item INSTALLATION |
8375 | ||
8376 | =item Accessing documentation | |
3e3baf6d | 8377 | |
d420ca49 | 8378 | =over 4 |
4755096e | 8379 | |
ee382f2f | 8380 | =item Manpages for Perl on AmigaOS |
4755096e | 8381 | |
ee382f2f | 8382 | =item Perl HTML Documentation on AmigaOS |
4755096e | 8383 | |
ee382f2f JH |
8384 | =item Perl GNU Info Files on AmigaOS |
8385 | ||
8386 | =item Perl LaTeX Documentation on AmigaOS | |
4755096e GS |
8387 | |
8388 | =back | |
cb1a09d0 | 8389 | |
ee382f2f | 8390 | =item BUILDING PERL ON AMIGAOS |
cb1a09d0 | 8391 | |
ee382f2f | 8392 | =over 4 |
a45bd81d | 8393 | |
ee382f2f | 8394 | =item Build Prerequisites for Perl on AmigaOS |
a83b6f46 | 8395 | |
ee382f2f | 8396 | =item Getting the Perl Source for AmigaOS |
a83b6f46 | 8397 | |
ee382f2f | 8398 | =item Making Perl on AmigaOS |
a83b6f46 | 8399 | |
ee382f2f | 8400 | =item Testing Perl on AmigaOS |
04b01f78 | 8401 | |
ee382f2f | 8402 | =item Installing the built Perl on AmigaOS |
a83b6f46 JH |
8403 | |
8404 | =back | |
8405 | ||
ee382f2f | 8406 | =item PERL 5.8.0 BROKEN IN AMIGAOS |
dc5c060f | 8407 | |
ee382f2f | 8408 | =item AUTHORS |
dc5c060f | 8409 | |
ee382f2f | 8410 | =item SEE ALSO |
dc5c060f | 8411 | |
ee382f2f | 8412 | =back |
dc5c060f | 8413 | |
50e34432 JH |
8414 | =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS |
8415 | ||
8416 | =over 4 | |
8417 | ||
8418 | =item DESCRIPTION | |
8419 | ||
8420 | =item AUTHOR | |
8421 | ||
8422 | =back | |
8423 | ||
a563e516 | 8424 | =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS |
dc5c060f | 8425 | |
ee382f2f | 8426 | =over 4 |
dc5c060f | 8427 | |
ee382f2f | 8428 | =item DESCRIPTION |
dc5c060f | 8429 | |
a563e516 | 8430 | =item BUILD AND INSTALL |
dc5c060f | 8431 | |
a563e516 | 8432 | =over 4 |
dc5c060f | 8433 | |
a563e516 | 8434 | =item Requirements |
dc5c060f | 8435 | |
a563e516 | 8436 | =item Configure |
dc5c060f | 8437 | |
a563e516 | 8438 | =item Build |
2d967e39 | 8439 | |
a563e516 | 8440 | =item Install |
dc5c060f | 8441 | |
ee382f2f | 8442 | =back |
dc5c060f | 8443 | |
a563e516 NC |
8444 | =item KNOWN PROBLEMS |
8445 | ||
8446 | =item CONTACT | |
8447 | ||
dc5c060f JH |
8448 | =back |
8449 | ||
ee382f2f | 8450 | =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. |
dc5c060f JH |
8451 | |
8452 | =over 4 | |
8453 | ||
35c7d401 | 8454 | =item SYNOPSIS |
dc5c060f | 8455 | |
35c7d401 | 8456 | =item DESCRIPTION |
dc5c060f | 8457 | |
a1f19229 JH |
8458 | =over 4 |
8459 | ||
ee382f2f | 8460 | =item gzip on BS2000 |
a1f19229 | 8461 | |
ee382f2f | 8462 | =item bison on BS2000 |
a1f19229 | 8463 | |
ee382f2f | 8464 | =item Unpacking Perl Distribution on BS2000 |
a1f19229 | 8465 | |
ee382f2f | 8466 | =item Compiling Perl on BS2000 |
a1f19229 | 8467 | |
ee382f2f | 8468 | =item Testing Perl on BS2000 |
a1f19229 | 8469 | |
ee382f2f | 8470 | =item Installing Perl on BS2000 |
a1f19229 | 8471 | |
ee382f2f | 8472 | =item Using Perl in the Posix-Shell of BS2000 |
a1f19229 | 8473 | |
ee382f2f | 8474 | =item Using Perl in "native" BS2000 |
a1f19229 | 8475 | |
ee382f2f | 8476 | =item Floating point anomalies on BS2000 |
35c7d401 | 8477 | |
cd458e05 JH |
8478 | =item Using PerlIO and different encodings on ASCII and EBCDIC partitions |
8479 | ||
ee382f2f JH |
8480 | =back |
8481 | ||
8482 | =item AUTHORS | |
35c7d401 JH |
8483 | |
8484 | =item SEE ALSO | |
8485 | ||
ee382f2f JH |
8486 | =over 4 |
8487 | ||
8488 | =item Mailing list | |
a1f19229 JH |
8489 | |
8490 | =back | |
8491 | ||
ee382f2f JH |
8492 | =item HISTORY |
8493 | ||
8494 | =back | |
8495 | ||
7a5cdbdf | 8496 | =head2 perlce - Perl for WinCE |
c66ca2ac | 8497 | |
7a5cdbdf | 8498 | =over 4 |
c66ca2ac | 8499 | |
7a5cdbdf | 8500 | =item DESCRIPTION |
c66ca2ac | 8501 | |
7a5cdbdf | 8502 | =item BUILD |
c66ca2ac NC |
8503 | |
8504 | =over 4 | |
8505 | ||
8506 | =item Tools & SDK | |
8507 | ||
8508 | Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's | |
8509 | celib-sources, Rainer Keuchel's console-sources | |
8510 | ||
8511 | =item Make | |
8512 | ||
8513 | go to ./wince subdirectory, edit file compile.bat, run compile.bat, run | |
8514 | compile.bat dist | |
8515 | ||
8516 | =back | |
8517 | ||
7a5cdbdf | 8518 | =item ACKNOWLEDGEMENTS |
c66ca2ac NC |
8519 | |
8520 | =item AUTHORS | |
8521 | ||
8522 | =back | |
8523 | ||
ee382f2f | 8524 | =head2 perlcygwin, README.cygwin - Perl for Cygwin |
cb1a09d0 | 8525 | |
d420ca49 | 8526 | =over 4 |
a45bd81d | 8527 | |
8ebc5c01 | 8528 | =item SYNOPSIS |
cb1a09d0 | 8529 | |
ee382f2f | 8530 | =item PREREQUISITES FOR COMPILING PERL ON CYGWIN |
cb1a09d0 | 8531 | |
d420ca49 | 8532 | =over 4 |
cb1a09d0 | 8533 | |
ee382f2f | 8534 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
cb1a09d0 | 8535 | |
ee382f2f | 8536 | =item Cygwin Configuration |
cb1a09d0 | 8537 | |
ee382f2f | 8538 | C<PATH>, I<nroff>, Permissions |
cb1a09d0 | 8539 | |
ee382f2f | 8540 | =back |
a45bd81d | 8541 | |
ee382f2f | 8542 | =item CONFIGURE PERL ON CYGWIN |
cb1a09d0 | 8543 | |
ee382f2f | 8544 | =over 4 |
a45bd81d | 8545 | |
ee382f2f | 8546 | =item Stripping Perl Binaries on Cygwin |
cb1a09d0 | 8547 | |
ee382f2f | 8548 | =item Optional Libraries for Perl on Cygwin |
cb1a09d0 | 8549 | |
ee382f2f JH |
8550 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), |
8551 | C<-lcygipc> (C<use IPC::SysV>), C<-lutil> | |
cb1a09d0 | 8552 | |
ee382f2f | 8553 | =item Configure-time Options for Perl on Cygwin |
cb1a09d0 | 8554 | |
ee382f2f JH |
8555 | C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, |
8556 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, | |
8557 | C<-Dmksymlinks> | |
cb1a09d0 | 8558 | |
ee382f2f | 8559 | =item Suspicious Warnings on Cygwin |
cb1a09d0 | 8560 | |
ee382f2f | 8561 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines |
cb1a09d0 | 8562 | |
4755096e | 8563 | =back |
cb1a09d0 | 8564 | |
ee382f2f | 8565 | =item MAKE ON CYGWIN |
cb1a09d0 | 8566 | |
d420ca49 | 8567 | =over 4 |
cb1a09d0 | 8568 | |
50e34432 | 8569 | =item Errors on Cygwin |
cb1a09d0 | 8570 | |
ee382f2f JH |
8571 | =item ld2 on Cygwin |
8572 | ||
8573 | =back | |
8574 | ||
8575 | =item TEST ON CYGWIN | |
cb1a09d0 | 8576 | |
d420ca49 | 8577 | =over 4 |
cb1a09d0 | 8578 | |
ee382f2f | 8579 | =item File Permissions on Cygwin |
7d2bfb28 | 8580 | |
ee382f2f | 8581 | =item NDBM_File and ODBM_File do not work on FAT filesystems |
c40f6c4a | 8582 | |
6e76d345 | 8583 | =item C<fork()> failures in io_* tests |
cb1a09d0 | 8584 | |
b2a9ae16 NC |
8585 | =back |
8586 | ||
8587 | =item Specific features of the Cygwin port | |
8588 | ||
8589 | =over 4 | |
8590 | ||
ee382f2f JH |
8591 | =item Script Portability on Cygwin |
8592 | ||
b2a9ae16 NC |
8593 | Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids, |
8594 | C<chown()>, Miscellaneous | |
8595 | ||
8596 | =item Prebuilt methods: | |
8597 | ||
8598 | C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid> | |
cb1a09d0 | 8599 | |
4755096e | 8600 | =back |
cb1a09d0 | 8601 | |
ee382f2f | 8602 | =item INSTALL PERL ON CYGWIN |
cb1a09d0 | 8603 | |
50e34432 | 8604 | =item MANIFEST ON CYGWIN |
245d750e | 8605 | |
50e34432 JH |
8606 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl |
8607 | Source, Compiled Module Source, Perl Modules/Scripts | |
245d750e | 8608 | |
50e34432 | 8609 | =item BUGS ON CYGWIN |
ee382f2f | 8610 | |
50e34432 | 8611 | =item AUTHORS |
245d750e | 8612 | |
50e34432 | 8613 | =item HISTORY |
245d750e JH |
8614 | |
8615 | =back | |
8616 | ||
50e34432 | 8617 | =head2 perldgux - Perl under DG/UX. |
73fba812 JH |
8618 | |
8619 | =over 4 | |
8620 | ||
8621 | =item SYNOPSIS | |
8622 | ||
50e34432 | 8623 | =back |
73fba812 JH |
8624 | |
8625 | =over 4 | |
8626 | ||
50e34432 | 8627 | =item DESCRIPTION |
73fba812 | 8628 | |
50e34432 | 8629 | =item BUILDING PERL ON DG/UX |
73fba812 JH |
8630 | |
8631 | =over 4 | |
8632 | ||
50e34432 | 8633 | =item Non-threaded Perl on DG/UX |
73fba812 | 8634 | |
50e34432 | 8635 | =item Threaded Perl on DG/UX |
73fba812 | 8636 | |
50e34432 | 8637 | =item Testing Perl on DG/UX |
73fba812 | 8638 | |
50e34432 | 8639 | =item Installing the built perl on DG/UX |
73fba812 JH |
8640 | |
8641 | =back | |
8642 | ||
8643 | =item AUTHOR | |
8644 | ||
8645 | =item SEE ALSO | |
8646 | ||
8647 | =back | |
8648 | ||
c66ca2ac NC |
8649 | =head2 perldos - Perl under DOS, W31, W95. |
8650 | ||
8651 | =over 4 | |
8652 | ||
8653 | =item SYNOPSIS | |
8654 | ||
8655 | =item DESCRIPTION | |
8656 | ||
8657 | =over 4 | |
8658 | ||
8659 | =item Prerequisites for Compiling Perl on DOS | |
8660 | ||
8661 | DJGPP, Pthreads | |
8662 | ||
8663 | =item Shortcomings of Perl under DOS | |
8664 | ||
8665 | =item Building Perl on DOS | |
8666 | ||
8667 | =item Testing Perl on DOS | |
8668 | ||
8669 | =item Installation of Perl on DOS | |
8670 | ||
8671 | =back | |
8672 | ||
8673 | =item BUILDING AND INSTALLING MODULES ON DOS | |
8674 | ||
8675 | =over 4 | |
8676 | ||
8677 | =item Building Prerequisites for Perl on DOS | |
8678 | ||
8679 | =item Unpacking CPAN Modules on DOS | |
8680 | ||
8681 | =item Building Non-XS Modules on DOS | |
8682 | ||
8683 | =item Building XS Modules on DOS | |
8684 | ||
8685 | =back | |
8686 | ||
8687 | =item AUTHOR | |
8688 | ||
8689 | =item SEE ALSO | |
8690 | ||
8691 | =back | |
8692 | ||
ee382f2f | 8693 | =head2 perlepoc, README.epoc - Perl for EPOC |
23be5fc4 JH |
8694 | |
8695 | =over 4 | |
8696 | ||
8697 | =item SYNOPSIS | |
8698 | ||
ee382f2f | 8699 | =item INTRODUCTION |
23be5fc4 | 8700 | |
ee382f2f | 8701 | =item INSTALLING PERL ON EPOC |
23be5fc4 | 8702 | |
ee382f2f | 8703 | =item STARTING PERL ON EPOC |
23be5fc4 | 8704 | |
35c7d401 | 8705 | =over 4 |
23be5fc4 | 8706 | |
ee382f2f | 8707 | =item Editors on Epoc |
23be5fc4 | 8708 | |
ee382f2f | 8709 | =item Features of Perl on Epoc |
23be5fc4 | 8710 | |
ee382f2f | 8711 | =item Restrictions of Perl on Epoc |
23be5fc4 | 8712 | |
ee382f2f | 8713 | =item Compiling Perl 5 on the EPOC cross compiling environment |
23be5fc4 | 8714 | |
ee382f2f | 8715 | =back |
23be5fc4 | 8716 | |
ee382f2f | 8717 | =item SUPPORT STATUS OF PERL ON EPOC |
23be5fc4 | 8718 | |
ee382f2f | 8719 | =item AUTHOR |
23be5fc4 | 8720 | |
ee382f2f | 8721 | =item LAST UPDATE |
23be5fc4 JH |
8722 | |
8723 | =back | |
8724 | ||
ee382f2f | 8725 | =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems |
9a997319 | 8726 | |
d420ca49 | 8727 | =over 4 |
9a997319 | 8728 | |
35c7d401 | 8729 | =item DESCRIPTION |
9a997319 | 8730 | |
d420ca49 | 8731 | =over 4 |
9a997319 | 8732 | |
ee382f2f | 8733 | =item FreeBSD core dumps from readdir_r with ithreads |
9a997319 | 8734 | |
ee382f2f | 8735 | =item $^X doesn't always contain a full path in FreeBSD |
9a997319 | 8736 | |
ee382f2f | 8737 | =item Perl will no longer be part of "base FreeBSD" |
9a997319 JH |
8738 | |
8739 | =back | |
8740 | ||
9a997319 JH |
8741 | =item AUTHOR |
8742 | ||
9a997319 JH |
8743 | =back |
8744 | ||
ee382f2f JH |
8745 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix |
8746 | (HP-UX) systems | |
97f7c9df JH |
8747 | |
8748 | =over 4 | |
8749 | ||
8750 | =item DESCRIPTION | |
8751 | ||
8752 | =over 4 | |
8753 | ||
ee382f2f | 8754 | =item Using perl as shipped with HP-UX |
97f7c9df | 8755 | |
ee382f2f | 8756 | =item Using perl from HP's porting centre |
97f7c9df | 8757 | |
ee382f2f | 8758 | =item Compiling Perl 5 on HP-UX |
97f7c9df | 8759 | |
ee382f2f | 8760 | =item PA-RISC |
35c7d401 | 8761 | |
a2db77eb NC |
8762 | =item Portability Between PA-RISC Versions |
8763 | ||
ee382f2f | 8764 | =item PA-RISC 1.0 |
35c7d401 | 8765 | |
ee382f2f | 8766 | =item PA-RISC 1.1 |
35c7d401 | 8767 | |
ee382f2f | 8768 | =item PA-RISC 2.0 |
97f7c9df | 8769 | |
ee382f2f | 8770 | =item Itanium Processor Family and HP-UX |
a45bd81d | 8771 | |
a2db77eb NC |
8772 | =item Itanium & Itanium 2 |
8773 | ||
ee382f2f | 8774 | =item Building Dynamic Extensions on HP-UX |
cb1a09d0 | 8775 | |
ee382f2f | 8776 | =item The HP ANSI C Compiler |
7d2bfb28 | 8777 | |
ee382f2f | 8778 | =item The GNU C Compiler |
35bf961c | 8779 | |
ee382f2f | 8780 | =item Using Large Files with Perl on HP-UX |
7d2bfb28 | 8781 | |
ee382f2f | 8782 | =item Threaded Perl on HP-UX |
cb1a09d0 | 8783 | |
ee382f2f | 8784 | =item 64-bit Perl on HP-UX |
cb1a09d0 | 8785 | |
ee382f2f | 8786 | =item Oracle on HP-UX |
cb1a09d0 | 8787 | |
ee382f2f | 8788 | =item GDBM and Threads on HP-UX |
cb1a09d0 | 8789 | |
ee382f2f | 8790 | =item NFS filesystems and utime(2) on HP-UX |
35bf961c | 8791 | |
ee382f2f | 8792 | =item perl -P and // and HP-UX |
cb1a09d0 | 8793 | |
ee382f2f | 8794 | =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl |
772ff3b9 | 8795 | |
ee382f2f | 8796 | =back |
cb1a09d0 | 8797 | |
ee382f2f JH |
8798 | =item nss_delete core dump from op/pwent or op/grent |
8799 | ||
8800 | =item AUTHOR | |
8801 | ||
8802 | =item DATE | |
cb1a09d0 | 8803 | |
35c7d401 | 8804 | =back |
95fb7f7f | 8805 | |
ee382f2f | 8806 | =head2 perlhurd, README.hurd - Perl version 5 on Hurd |
cb1a09d0 | 8807 | |
35c7d401 | 8808 | =over 4 |
cb1a09d0 | 8809 | |
ee382f2f | 8810 | =item DESCRIPTION |
a6812a52 | 8811 | |
ee382f2f | 8812 | =over 4 |
cb1a09d0 | 8813 | |
ee382f2f | 8814 | =item Known Problems with Perl on Hurd |
7d2bfb28 | 8815 | |
35c7d401 | 8816 | =back |
7029d033 | 8817 | |
ee382f2f | 8818 | =item AUTHOR |
772ff3b9 | 8819 | |
ee382f2f | 8820 | =back |
a45bd81d | 8821 | |
ee382f2f | 8822 | =head2 perlirix, README.irix - Perl version 5 on Irix systems |
35bf961c | 8823 | |
ee382f2f | 8824 | =over 4 |
a45bd81d | 8825 | |
ee382f2f | 8826 | =item DESCRIPTION |
7d2bfb28 | 8827 | |
ee382f2f | 8828 | =over 4 |
7d2bfb28 | 8829 | |
ee382f2f | 8830 | =item Building 32-bit Perl in Irix |
a83b6f46 | 8831 | |
ee382f2f | 8832 | =item Building 64-bit Perl in Irix |
a83b6f46 | 8833 | |
ee382f2f | 8834 | =item About Compiler Versions of Irix |
35c7d401 | 8835 | |
ee382f2f | 8836 | =item Linker Problems in Irix |
a83b6f46 | 8837 | |
ee382f2f | 8838 | =item Malloc in Irix |
35c7d401 | 8839 | |
ee382f2f | 8840 | =item Building with threads in Irix |
a83b6f46 | 8841 | |
ee382f2f | 8842 | =item Irix 5.3 |
a83b6f46 JH |
8843 | |
8844 | =back | |
8845 | ||
ee382f2f | 8846 | =item AUTHOR |
a83b6f46 JH |
8847 | |
8848 | =back | |
8849 | ||
b40eed9c NC |
8850 | =head2 perllinux, README.linux - Perl version 5 on Linux systems |
8851 | ||
8852 | =over 4 | |
8853 | ||
8854 | =item DESCRIPTION | |
8855 | ||
8856 | =over 4 | |
8857 | ||
8858 | =item Experimental Support for Sun Studio Compilers for Linux OS | |
8859 | ||
8860 | =back | |
8861 | ||
8862 | =item AUTHOR | |
8863 | ||
8864 | =back | |
8865 | ||
ee382f2f JH |
8866 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen |
8867 | systems | |
97f7c9df JH |
8868 | |
8869 | =over 4 | |
8870 | ||
8871 | =item DESCRIPTION | |
8872 | ||
8873 | =over 4 | |
8874 | ||
7f106169 NC |
8875 | =item Perl version 5.8.x and greater not supported |
8876 | ||
8877 | =item Compiling Perl 5.6.x on MachTen | |
ee382f2f JH |
8878 | |
8879 | =item Failures during C<make test> on MachTen | |
8880 | ||
8881 | op/lexassign.t, pragma/warnings.t | |
8882 | ||
8883 | =item Building external modules on MachTen | |
97f7c9df JH |
8884 | |
8885 | =back | |
8886 | ||
ee382f2f JH |
8887 | =item AUTHOR |
8888 | ||
8889 | =item DATE | |
8890 | ||
97f7c9df JH |
8891 | =back |
8892 | ||
ee382f2f | 8893 | =head2 perlmacos, README.macos - Perl under Mac OS (Classic) |
7d2bfb28 | 8894 | |
d420ca49 | 8895 | =over 4 |
c76ac1ee | 8896 | |
35c7d401 | 8897 | =item SYNOPSIS |
c76ac1ee | 8898 | |
35c7d401 | 8899 | =item DESCRIPTION |
c76ac1ee | 8900 | |
4755096e | 8901 | =item AUTHOR |
c76ac1ee | 8902 | |
ee382f2f JH |
8903 | =item DATE |
8904 | ||
c76ac1ee GS |
8905 | =back |
8906 | ||
b0a5877c JH |
8907 | =head2 perlmacosx, README.macosx - Perl under Mac OS X |
8908 | ||
8909 | =over 4 | |
8910 | ||
8911 | =item SYNOPSIS | |
8912 | ||
8913 | =item DESCRIPTION | |
8914 | ||
50e34432 JH |
8915 | =over 4 |
8916 | ||
8917 | =item Installation Prefix | |
8918 | ||
8919 | =item libperl and Prebinding | |
b0a5877c | 8920 | |
b40eed9c NC |
8921 | =item Updating Apple-supplied Perl |
8922 | ||
8923 | =item 64-bit Perl | |
8924 | ||
8925 | =item Intel processor support | |
8926 | ||
8927 | =item Universal binaries | |
b0a5877c | 8928 | |
50e34432 | 8929 | =item Known problems |
b0a5877c | 8930 | |
50e34432 | 8931 | =item MacPerl |
b0a5877c | 8932 | |
50e34432 | 8933 | =item Carbon |
b0a5877c | 8934 | |
50e34432 JH |
8935 | =item Cocoa |
8936 | ||
8937 | =back | |
b0a5877c | 8938 | |
cd458e05 JH |
8939 | =item Starting From Scratch |
8940 | ||
b0a5877c JH |
8941 | =item AUTHOR |
8942 | ||
8943 | =item DATE | |
8944 | ||
8945 | =back | |
8946 | ||
ee382f2f | 8947 | =head2 perlmint, README.mint - Perl version 5 on Atari MiNT |
e42c74e1 JH |
8948 | |
8949 | =over 4 | |
8950 | ||
e42c74e1 JH |
8951 | =item DESCRIPTION |
8952 | ||
ee382f2f JH |
8953 | =item Known problems with Perl on MiNT |
8954 | ||
8955 | =item AUTHOR | |
8956 | ||
e42c74e1 JH |
8957 | =back |
8958 | ||
ee382f2f | 8959 | =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE |
a83b6f46 JH |
8960 | |
8961 | =over 4 | |
8962 | ||
35c7d401 | 8963 | =item SYNOPSIS |
a83b6f46 | 8964 | |
ee382f2f | 8965 | =item NOTE |
a83b6f46 | 8966 | |
ee382f2f | 8967 | =item Binary distribution from HP |
a83b6f46 | 8968 | |
ee382f2f | 8969 | =item What's New in Perl for MPE/iX |
ab648d5e | 8970 | |
ee382f2f | 8971 | =item Welcome to Perl/iX |
ab648d5e | 8972 | |
ee382f2f | 8973 | =item System Requirements for Perl/iX |
772ff3b9 | 8974 | |
ee382f2f | 8975 | =item How to Obtain Perl/iX |
ab648d5e | 8976 | |
ee382f2f | 8977 | =item Perl/iX Distribution Contents Highlights |
772ff3b9 | 8978 | |
ee382f2f JH |
8979 | README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, |
8980 | public_html/feedback.cgi, src/perl-5.6.0-mpe | |
ab648d5e | 8981 | |
ee382f2f | 8982 | =item How to Compile Perl/iX |
ab648d5e | 8983 | |
ee382f2f | 8984 | 4, 6 |
ab648d5e | 8985 | |
ee382f2f | 8986 | =item Getting Started with Perl/iX |
772ff3b9 | 8987 | |
ee382f2f | 8988 | =item MPE/iX Implementation Considerations |
772ff3b9 | 8989 | |
ee382f2f | 8990 | =item Known Perl/iX Bugs Under Investigation |
ab648d5e | 8991 | |
ee382f2f JH |
8992 | =item Perl/iX To-Do List |
8993 | ||
8994 | =item Perl/iX Change History | |
ab648d5e | 8995 | |
35c7d401 | 8996 | =item AUTHOR |
ab648d5e | 8997 | |
7a5cdbdf | 8998 | =back |
772ff3b9 | 8999 | |
7a5cdbdf AJ |
9000 | =head2 perlnetware - Perl for NetWare |
9001 | ||
9002 | =over 4 | |
9003 | ||
9004 | =item DESCRIPTION | |
ee382f2f | 9005 | |
7a5cdbdf | 9006 | =item BUILD |
772ff3b9 | 9007 | |
35c7d401 | 9008 | =over 4 |
ab648d5e | 9009 | |
ee382f2f | 9010 | =item Tools & SDK |
772ff3b9 | 9011 | |
ee382f2f | 9012 | =item Setup |
9038e305 | 9013 | |
ee382f2f | 9014 | SetNWBld.bat, Buildtype.bat |
9038e305 | 9015 | |
ee382f2f | 9016 | =item Make |
9038e305 | 9017 | |
ee382f2f | 9018 | =item Interpreter |
9038e305 | 9019 | |
ee382f2f | 9020 | =item Extensions |
9038e305 | 9021 | |
ee382f2f | 9022 | =back |
9038e305 | 9023 | |
7a5cdbdf | 9024 | =item INSTALL |
9038e305 | 9025 | |
7a5cdbdf | 9026 | =item BUILD NEW EXTENSIONS |
9038e305 | 9027 | |
7a5cdbdf | 9028 | =item ACKNOWLEDGEMENTS |
9038e305 | 9029 | |
7a5cdbdf | 9030 | =item AUTHORS |
9038e305 | 9031 | |
7a5cdbdf | 9032 | =item DATE |
9038e305 | 9033 | |
ee382f2f | 9034 | =back |
5e1b1338 | 9035 | |
9185d7cc NC |
9036 | =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems |
9037 | ||
9038 | =over 4 | |
9039 | ||
9040 | =item DESCRIPTION | |
9041 | ||
9042 | =over 4 | |
9043 | ||
9044 | =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with | |
9045 | ithreads | |
9046 | ||
9047 | =back | |
9048 | ||
9049 | =item AUTHOR | |
9050 | ||
9051 | =back | |
9052 | ||
ee382f2f | 9053 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. |
9038e305 | 9054 | |
ee382f2f | 9055 | =over 4 |
9038e305 | 9056 | |
ee382f2f | 9057 | =item SYNOPSIS |
9038e305 | 9058 | |
ab648d5e JH |
9059 | =back |
9060 | ||
d420ca49 | 9061 | =over 4 |
c76ac1ee | 9062 | |
35c7d401 | 9063 | =item DESCRIPTION |
a45bd81d | 9064 | |
d420ca49 AD |
9065 | =over 4 |
9066 | ||
ee382f2f | 9067 | =item Target |
d420ca49 | 9068 | |
ee382f2f | 9069 | =item Other OSes |
35c7d401 | 9070 | |
ee382f2f | 9071 | =item Prerequisites |
a45bd81d | 9072 | |
ee382f2f | 9073 | EMX, RSX, HPFS, pdksh |
cb1a09d0 | 9074 | |
ee382f2f | 9075 | =item Starting Perl programs under OS/2 (and DOS and...) |
0a753a76 | 9076 | |
ee382f2f | 9077 | =item Starting OS/2 (and DOS) programs under Perl |
35c7d401 | 9078 | |
ee382f2f | 9079 | =back |
cb1a09d0 | 9080 | |
ee382f2f | 9081 | =item Frequently asked questions |
cb1a09d0 | 9082 | |
ee382f2f | 9083 | =over 4 |
cb1a09d0 | 9084 | |
ee382f2f JH |
9085 | =item "It does not work" |
9086 | ||
9087 | =item I cannot run external programs | |
9088 | ||
9089 | =item I cannot embed perl into my program, or use F<perl.dll> from my | |
9090 | program. | |
9091 | ||
9092 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use | |
9093 | L<ExtUtils::Embed>? | |
9094 | ||
9095 | =item C<``> and pipe-C<open> do not work under DOS. | |
9096 | ||
9097 | =item Cannot start C<find.exe "pattern" file> | |
cb1a09d0 | 9098 | |
4755096e | 9099 | =back |
cb1a09d0 | 9100 | |
ee382f2f | 9101 | =item INSTALLATION |
cb1a09d0 | 9102 | |
d420ca49 | 9103 | =over 4 |
1e422769 | 9104 | |
ee382f2f | 9105 | =item Automatic binary installation |
cb1a09d0 | 9106 | |
ee382f2f | 9107 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> |
cb1a09d0 | 9108 | |
ee382f2f | 9109 | =item Manual binary installation |
cb1a09d0 | 9110 | |
ee382f2f JH |
9111 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable |
9112 | (statically linked), Executables for Perl utilities, Main Perl library, | |
9113 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
9114 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
9115 | Perl manual in F<.INF> format, Pdksh | |
cb1a09d0 | 9116 | |
ee382f2f | 9117 | =item B<Warning> |
cb1a09d0 | 9118 | |
4755096e | 9119 | =back |
0a753a76 | 9120 | |
ee382f2f | 9121 | =item Accessing documentation |
cb1a09d0 | 9122 | |
ee382f2f | 9123 | =over 4 |
cb1a09d0 | 9124 | |
ee382f2f | 9125 | =item OS/2 F<.INF> file |
cb1a09d0 | 9126 | |
ee382f2f | 9127 | =item Plain text |
3e3baf6d | 9128 | |
ee382f2f | 9129 | =item Manpages |
d516a115 | 9130 | |
ee382f2f | 9131 | =item HTML |
d516a115 | 9132 | |
ee382f2f | 9133 | =item GNU C<info> files |
0a753a76 | 9134 | |
ee382f2f | 9135 | =item F<PDF> files |
0a753a76 | 9136 | |
ee382f2f | 9137 | =item C<LaTeX> docs |
cb1a09d0 | 9138 | |
ee382f2f | 9139 | =back |
cb1a09d0 | 9140 | |
ee382f2f | 9141 | =item BUILD |
cb1a09d0 | 9142 | |
35c7d401 | 9143 | =over 4 |
cb1a09d0 | 9144 | |
ee382f2f | 9145 | =item The short story |
cb1a09d0 | 9146 | |
ee382f2f | 9147 | =item Prerequisites |
cb1a09d0 | 9148 | |
ee382f2f | 9149 | =item Getting perl source |
cb1a09d0 | 9150 | |
ee382f2f | 9151 | =item Application of the patches |
cb1a09d0 | 9152 | |
ee382f2f | 9153 | =item Hand-editing |
0a753a76 | 9154 | |
ee382f2f | 9155 | =item Making |
0a753a76 | 9156 | |
ee382f2f | 9157 | =item Testing |
0a753a76 | 9158 | |
ee382f2f JH |
9159 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, |
9160 | F<op/stat.t> | |
4d4e713d | 9161 | |
ee382f2f JH |
9162 | =item Installing the built perl |
9163 | ||
9164 | =item C<a.out>-style build | |
0a753a76 | 9165 | |
35c7d401 | 9166 | =back |
0a753a76 | 9167 | |
4c64e75b NC |
9168 | =item Building a binary distribution |
9169 | ||
9170 | =item Building custom F<.EXE> files | |
9171 | ||
9172 | =over 4 | |
9173 | ||
9174 | =item Making executables with a custom collection of statically loaded | |
9175 | extensions | |
9176 | ||
9177 | =item Making executables with a custom search-paths | |
9178 | ||
9179 | =back | |
9180 | ||
ee382f2f | 9181 | =item Build FAQ |
0a753a76 | 9182 | |
35c7d401 | 9183 | =over 4 |
0a753a76 | 9184 | |
ee382f2f | 9185 | =item Some C</> became C<\> in pdksh. |
0a753a76 | 9186 | |
ee382f2f | 9187 | =item C<'errno'> - unresolved external |
4755096e | 9188 | |
ee382f2f | 9189 | =item Problems with tr or sed |
4755096e | 9190 | |
ee382f2f | 9191 | =item Some problem (forget which ;-) |
4755096e | 9192 | |
ee382f2f | 9193 | =item Library ... not found |
0a753a76 | 9194 | |
ee382f2f | 9195 | =item Segfault in make |
35c7d401 | 9196 | |
ee382f2f | 9197 | =item op/sprintf test failure |
0a753a76 | 9198 | |
ee382f2f JH |
9199 | =back |
9200 | ||
9201 | =item Specific (mis)features of OS/2 port | |
c76ac1ee | 9202 | |
d420ca49 | 9203 | =over 4 |
c76ac1ee | 9204 | |
ee382f2f | 9205 | =item C<setpriority>, C<getpriority> |
35c7d401 | 9206 | |
ee382f2f | 9207 | =item C<system()> |
c76ac1ee | 9208 | |
ee382f2f | 9209 | =item C<extproc> on the first line |
c76ac1ee | 9210 | |
ee382f2f | 9211 | =item Additional modules: |
c76ac1ee | 9212 | |
ee382f2f | 9213 | =item Prebuilt methods: |
c76ac1ee | 9214 | |
ee382f2f JH |
9215 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, |
9216 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
9217 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
9218 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
9219 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
9220 | C<Cwd::extLibpath_set( path [, type ] )>, | |
9221 | C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>, | |
9222 | OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>, | |
9223 | C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>, | |
9224 | C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>, | |
9225 | OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>, | |
9226 | C<OS2::DLLname([how [, \&xsub]])> | |
cb1a09d0 | 9227 | |
ee382f2f | 9228 | =item Prebuilt variables: |
954c1994 | 9229 | |
ee382f2f JH |
9230 | $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, |
9231 | $OS2::nsyserror | |
d396a558 | 9232 | |
ee382f2f | 9233 | =item Misfeatures |
a45bd81d | 9234 | |
ee382f2f | 9235 | =item Modifications |
cb1a09d0 | 9236 | |
ee382f2f JH |
9237 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>, |
9238 | C<flock> | |
a45bd81d | 9239 | |
ee382f2f | 9240 | =item Identifying DLLs |
cb1a09d0 | 9241 | |
ee382f2f | 9242 | =item Centralized management of resources |
cb1a09d0 | 9243 | |
ee382f2f JH |
9244 | C<HAB>, C<HMQ>, Treating errors reported by OS/2 API, |
9245 | C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>, | |
9246 | C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>, | |
9247 | C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs | |
cb1a09d0 | 9248 | |
35c7d401 | 9249 | =back |
cb1a09d0 | 9250 | |
ee382f2f | 9251 | =item Perl flavors |
4755096e | 9252 | |
35c7d401 | 9253 | =over 4 |
4d4e713d | 9254 | |
ee382f2f | 9255 | =item F<perl.exe> |
4755096e | 9256 | |
ee382f2f | 9257 | =item F<perl_.exe> |
4755096e | 9258 | |
ee382f2f | 9259 | =item F<perl__.exe> |
4755096e | 9260 | |
ee382f2f | 9261 | =item F<perl___.exe> |
4d4e713d | 9262 | |
ee382f2f | 9263 | =item Why strange names? |
4d4e713d | 9264 | |
ee382f2f | 9265 | =item Why dynamic linking? |
4d4e713d | 9266 | |
ee382f2f | 9267 | =item Why chimera build? |
4755096e GS |
9268 | |
9269 | =back | |
9270 | ||
ee382f2f | 9271 | =item ENVIRONMENT |
cb1a09d0 | 9272 | |
d420ca49 | 9273 | =over 4 |
cb1a09d0 | 9274 | |
ee382f2f | 9275 | =item C<PERLLIB_PREFIX> |
54310121 | 9276 | |
ee382f2f | 9277 | =item C<PERL_BADLANG> |
cb1a09d0 | 9278 | |
ee382f2f | 9279 | =item C<PERL_BADFREE> |
cb1a09d0 | 9280 | |
ee382f2f | 9281 | =item C<PERL_SH_DIR> |
cb1a09d0 | 9282 | |
ee382f2f | 9283 | =item C<USE_PERL_FLOCK> |
cb1a09d0 | 9284 | |
ee382f2f | 9285 | =item C<TMP> or C<TEMP> |
cb1a09d0 | 9286 | |
ee382f2f | 9287 | =back |
7d2bfb28 | 9288 | |
ee382f2f | 9289 | =item Evolution |
cb1a09d0 | 9290 | |
ee382f2f | 9291 | =over 4 |
cb1a09d0 | 9292 | |
ee382f2f | 9293 | =item Text-mode filehandles |
cb1a09d0 | 9294 | |
ee382f2f | 9295 | =item Priorities |
cb1a09d0 | 9296 | |
ee382f2f | 9297 | =item DLL name mangling: pre 5.6.2 |
cb1a09d0 | 9298 | |
ee382f2f | 9299 | =item DLL name mangling: 5.6.2 and beyond |
cb1a09d0 | 9300 | |
ee382f2f JH |
9301 | Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from |
9302 | C<LIBPATH> | |
cb1a09d0 | 9303 | |
ee382f2f | 9304 | =item DLL forwarder generation |
cb1a09d0 | 9305 | |
ee382f2f | 9306 | =item Threading |
cb1a09d0 | 9307 | |
ee382f2f | 9308 | =item Calls to external programs |
cb1a09d0 | 9309 | |
ee382f2f | 9310 | =item Memory allocation |
7d2bfb28 | 9311 | |
ee382f2f JH |
9312 | =item Threads |
9313 | ||
9314 | C<COND_WAIT>, F<os2.c> | |
9315 | ||
9316 | =back | |
cb1a09d0 | 9317 | |
35c7d401 | 9318 | =item BUGS |
ad716b8e | 9319 | |
ee382f2f JH |
9320 | =back |
9321 | ||
9322 | =over 4 | |
9323 | ||
35c7d401 | 9324 | =item AUTHOR |
cb1a09d0 | 9325 | |
35c7d401 | 9326 | =item SEE ALSO |
354a27bf | 9327 | |
35c7d401 | 9328 | =back |
354a27bf | 9329 | |
ee382f2f JH |
9330 | =head2 perlos390, README.os390 - building and installing Perl for OS/390 |
9331 | and z/OS | |
354a27bf | 9332 | |
35c7d401 | 9333 | =over 4 |
cb1a09d0 | 9334 | |
35c7d401 | 9335 | =item SYNOPSIS |
cb1a09d0 | 9336 | |
35c7d401 | 9337 | =item DESCRIPTION |
cb1a09d0 | 9338 | |
35c7d401 | 9339 | =over 4 |
cb1a09d0 | 9340 | |
ee382f2f | 9341 | =item Tools |
cb1a09d0 | 9342 | |
ee382f2f | 9343 | =item Unpacking Perl distribution on OS/390 |
cb1a09d0 | 9344 | |
ee382f2f | 9345 | =item Setup and utilities for Perl on OS/390 |
5cd24f17 | 9346 | |
ee382f2f | 9347 | =item Configure Perl on OS/390 |
354a27bf | 9348 | |
ee382f2f | 9349 | =item Build, Test, Install Perl on OS/390 |
cb1a09d0 | 9350 | |
ee382f2f | 9351 | =item Build Anomalies with Perl on OS/390 |
a45bd81d | 9352 | |
ee382f2f | 9353 | =item Testing Anomalies with Perl on OS/390 |
c76ac1ee | 9354 | |
ee382f2f | 9355 | =item Installation Anomalies with Perl on OS/390 |
a45bd81d | 9356 | |
ee382f2f | 9357 | =item Usage Hints for Perl on OS/390 |
4755096e | 9358 | |
ee382f2f JH |
9359 | =item Floating Point Anomalies with Perl on OS/390 |
9360 | ||
9361 | =item Modules and Extensions for Perl on OS/390 | |
c76ac1ee | 9362 | |
35c7d401 | 9363 | =back |
c76ac1ee | 9364 | |
ee382f2f JH |
9365 | =item AUTHORS |
9366 | ||
9367 | =item SEE ALSO | |
248e172a | 9368 | |
35c7d401 | 9369 | =over 4 |
c76ac1ee | 9370 | |
ee382f2f | 9371 | =item Mailing list for Perl on OS/390 |
c76ac1ee | 9372 | |
ee382f2f | 9373 | =back |
c76ac1ee | 9374 | |
ee382f2f | 9375 | =item HISTORY |
c76ac1ee | 9376 | |
35c7d401 | 9377 | =back |
74cac757 | 9378 | |
ee382f2f | 9379 | =head2 perlos400, README.os400 - Perl version 5 on OS/400 |
74cac757 | 9380 | |
35c7d401 | 9381 | =over 4 |
c2e66d9e | 9382 | |
35c7d401 | 9383 | =item DESCRIPTION |
c2e66d9e | 9384 | |
ee382f2f | 9385 | =over 4 |
c2e66d9e | 9386 | |
ee382f2f | 9387 | =item Compiling Perl for OS/400 PASE |
c2e66d9e | 9388 | |
ee382f2f | 9389 | =item Installing Perl in OS/400 PASE |
c2e66d9e | 9390 | |
ee382f2f | 9391 | =item Using Perl in OS/400 PASE |
c2e66d9e | 9392 | |
ee382f2f | 9393 | =item Known Problems |
c2e66d9e | 9394 | |
ee382f2f | 9395 | =item Perl on ILE |
c2e66d9e GS |
9396 | |
9397 | =back | |
9398 | ||
ee382f2f | 9399 | =item AUTHORS |
a83b6f46 | 9400 | |
ee382f2f | 9401 | =back |
a83b6f46 | 9402 | |
50e34432 | 9403 | =head2 perlplan9 - Plan 9-specific documentation for Perl |
a83b6f46 | 9404 | |
ee382f2f | 9405 | =over 4 |
a83b6f46 | 9406 | |
35c7d401 | 9407 | =item DESCRIPTION |
a83b6f46 | 9408 | |
35c7d401 | 9409 | =over 4 |
a83b6f46 | 9410 | |
50e34432 | 9411 | =item Invoking Perl |
a83b6f46 | 9412 | |
50e34432 | 9413 | =item What's in Plan 9 Perl |
27713a04 | 9414 | |
50e34432 | 9415 | =item What's not in Plan 9 Perl |
a83b6f46 | 9416 | |
50e34432 | 9417 | =item Perl5 Functions not currently supported in Plan 9 Perl |
ee382f2f | 9418 | |
50e34432 | 9419 | =item Signals in Plan 9 Perl |
ee382f2f | 9420 | |
50e34432 JH |
9421 | =back |
9422 | ||
9423 | =item COMPILING AND INSTALLING PERL ON PLAN 9 | |
9424 | ||
9425 | =over 4 | |
9426 | ||
9427 | =item Installing Perl Documentation on Plan 9 | |
a83b6f46 JH |
9428 | |
9429 | =back | |
9430 | ||
50e34432 JH |
9431 | =item BUGS |
9432 | ||
9433 | =item Revision date | |
9434 | ||
ee382f2f | 9435 | =item AUTHOR |
a83b6f46 | 9436 | |
ee382f2f | 9437 | =back |
a83b6f46 | 9438 | |
50e34432 | 9439 | =head2 perlqnx, README.qnx - Perl version 5 on QNX |
35c7d401 | 9440 | |
ee382f2f | 9441 | =over 4 |
35c7d401 | 9442 | |
a83b6f46 JH |
9443 | =item DESCRIPTION |
9444 | ||
9445 | =over 4 | |
9446 | ||
50e34432 | 9447 | =item Required Software for Compiling Perl on QNX4 |
a83b6f46 | 9448 | |
50e34432 | 9449 | /bin/sh, ar, nm, cpp, make |
a83b6f46 | 9450 | |
50e34432 | 9451 | =item Outstanding Issues with Perl on QNX4 |
a83b6f46 | 9452 | |
50e34432 | 9453 | =item QNX auxiliary files |
a83b6f46 | 9454 | |
50e34432 | 9455 | qnx/ar, qnx/cpp |
a83b6f46 | 9456 | |
50e34432 | 9457 | =item Outstanding issues with perl under QNX6 |
a83b6f46 | 9458 | |
ee382f2f | 9459 | =back |
a83b6f46 | 9460 | |
ee382f2f | 9461 | =item AUTHOR |
a83b6f46 JH |
9462 | |
9463 | =back | |
9464 | ||
ee382f2f | 9465 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems |
d420ca49 AD |
9466 | |
9467 | =over 4 | |
9468 | ||
9469 | =item DESCRIPTION | |
9470 | ||
9471 | =over 4 | |
9472 | ||
ee382f2f | 9473 | =item Solaris Version Numbers. |
d420ca49 | 9474 | |
ee382f2f | 9475 | =back |
d420ca49 | 9476 | |
ee382f2f | 9477 | =item RESOURCES |
d420ca49 | 9478 | |
ee382f2f | 9479 | Solaris FAQ, Precompiled Binaries, Solaris Documentation |
d420ca49 | 9480 | |
ee382f2f | 9481 | =item SETTING UP |
d420ca49 | 9482 | |
ee382f2f | 9483 | =over 4 |
d420ca49 | 9484 | |
ee382f2f | 9485 | =item File Extraction Problems on Solaris. |
d420ca49 | 9486 | |
ee382f2f | 9487 | =item Compiler and Related Tools on Solaris. |
d420ca49 | 9488 | |
73fba812 | 9489 | =item Environment for Compiling perl on Solaris |
d420ca49 AD |
9490 | |
9491 | =back | |
9492 | ||
ee382f2f | 9493 | =item RUN CONFIGURE. |
d420ca49 AD |
9494 | |
9495 | =over 4 | |
9496 | ||
73fba812 | 9497 | =item 64-bit perl on Solaris. |
35c7d401 | 9498 | |
73fba812 | 9499 | =item Threads in perl on Solaris. |
35c7d401 | 9500 | |
73fba812 | 9501 | =item Malloc Issues with perl on Solaris. |
d420ca49 | 9502 | |
ee382f2f | 9503 | =back |
d420ca49 | 9504 | |
ee382f2f | 9505 | =item MAKE PROBLEMS. |
d420ca49 | 9506 | |
ee382f2f JH |
9507 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: |
9508 | relocation error:, dlopen: stub interception failed, #error "No | |
b40eed9c NC |
9509 | DATAMODEL_NATIVE specified", sh: ar: not found, warning: dead part of |
9510 | constant expression is nonconstant | |
d420ca49 | 9511 | |
ee382f2f JH |
9512 | =item MAKE TEST |
9513 | ||
9514 | =over 4 | |
9515 | ||
9516 | =item op/stat.t test 4 in Solaris | |
9517 | ||
9518 | =item nss_delete core dump from op/pwent or op/grent | |
d420ca49 | 9519 | |
35c7d401 | 9520 | =back |
d420ca49 | 9521 | |
ee382f2f JH |
9522 | =item PREBUILT BINARIES OF PERL FOR SOLARIS. |
9523 | ||
9524 | =item RUNTIME ISSUES FOR PERL ON SOLARIS. | |
d420ca49 AD |
9525 | |
9526 | =over 4 | |
9527 | ||
ee382f2f | 9528 | =item Limits on Numbers of Open Files on Solaris. |
35bf961c | 9529 | |
ee382f2f | 9530 | =back |
d420ca49 | 9531 | |
ee382f2f | 9532 | =item SOLARIS-SPECIFIC MODULES. |
d420ca49 | 9533 | |
ee382f2f | 9534 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. |
d420ca49 AD |
9535 | |
9536 | =over 4 | |
9537 | ||
ee382f2f | 9538 | =item Proc::ProcessTable on Solaris |
d420ca49 | 9539 | |
ee382f2f | 9540 | =item BSD::Resource on Solaris |
d420ca49 | 9541 | |
ee382f2f | 9542 | =item Net::SSLeay on Solaris |
d420ca49 | 9543 | |
ee382f2f | 9544 | =back |
d420ca49 | 9545 | |
cd458e05 JH |
9546 | =item SunOS 4.x |
9547 | ||
ee382f2f | 9548 | =item AUTHOR |
d420ca49 | 9549 | |
ee382f2f | 9550 | =back |
d420ca49 | 9551 | |
ee382f2f JH |
9552 | =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as |
9553 | Digital UNIX formerly known as DEC OSF/1) systems | |
74cac757 | 9554 | |
ee382f2f | 9555 | =over 4 |
d420ca49 | 9556 | |
ee382f2f | 9557 | =item DESCRIPTION |
d420ca49 | 9558 | |
35c7d401 | 9559 | =over 4 |
d420ca49 | 9560 | |
ee382f2f | 9561 | =item Compiling Perl 5 on Tru64 |
d420ca49 | 9562 | |
ee382f2f | 9563 | =item Using Large Files with Perl on Tru64 |
772ff3b9 | 9564 | |
ee382f2f | 9565 | =item Threaded Perl on Tru64 |
772ff3b9 | 9566 | |
ee382f2f | 9567 | =item Long Doubles on Tru64 |
772ff3b9 | 9568 | |
ee382f2f | 9569 | =item DB_File tests failing on Tru64 |
772ff3b9 | 9570 | |
ee382f2f | 9571 | =item 64-bit Perl on Tru64 |
772ff3b9 | 9572 | |
ee382f2f | 9573 | =item Warnings about floating-point overflow when compiling Perl on Tru64 |
772ff3b9 | 9574 | |
ee382f2f | 9575 | =back |
772ff3b9 | 9576 | |
ee382f2f | 9577 | =item Testing Perl on Tru64 |
a83b6f46 | 9578 | |
ee382f2f | 9579 | =item ext/ODBM_File/odbm Test Failing With Static Builds |
772ff3b9 | 9580 | |
ee382f2f | 9581 | =item Perl Fails Because Of Unresolved Symbol sockatmark |
772ff3b9 | 9582 | |
ee382f2f | 9583 | =item AUTHOR |
772ff3b9 | 9584 | |
ee382f2f | 9585 | =back |
772ff3b9 | 9586 | |
ee382f2f | 9587 | =head2 perluts - Perl under UTS |
fa1c7b03 | 9588 | |
ee382f2f | 9589 | =over 4 |
23be5fc4 | 9590 | |
ee382f2f | 9591 | =item SYNOPSIS |
772ff3b9 | 9592 | |
ee382f2f | 9593 | =item DESCRIPTION |
772ff3b9 | 9594 | |
ee382f2f | 9595 | =item BUILDING PERL ON UTS |
91144103 | 9596 | |
ee382f2f | 9597 | =item Installing the built perl on UTS |
91144103 | 9598 | |
ee382f2f | 9599 | =item AUTHOR |
91144103 | 9600 | |
ee382f2f | 9601 | =back |
91144103 | 9602 | |
ee382f2f | 9603 | =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. |
91144103 | 9604 | |
ee382f2f | 9605 | =over 4 |
91144103 | 9606 | |
ee382f2f | 9607 | =item SYNOPSIS |
91144103 | 9608 | |
ee382f2f | 9609 | =item DESCRIPTION |
91144103 | 9610 | |
ee382f2f | 9611 | =over 4 |
dc5c060f | 9612 | |
ee382f2f | 9613 | =item Unpacking Perl Distribution on VM/ESA |
dc5c060f | 9614 | |
ee382f2f | 9615 | =item Setup Perl and utilities on VM/ESA |
dc5c060f | 9616 | |
ee382f2f | 9617 | =item Configure Perl on VM/ESA |
dc5c060f | 9618 | |
ee382f2f | 9619 | =item Testing Anomalies of Perl on VM/ESA |
dc5c060f | 9620 | |
ee382f2f | 9621 | =item Usage Hints for Perl on VM/ESA |
dc5c060f | 9622 | |
ee382f2f | 9623 | =back |
dc5c060f | 9624 | |
ee382f2f | 9625 | =item AUTHORS |
dc5c060f | 9626 | |
ee382f2f | 9627 | =item SEE ALSO |
dc5c060f | 9628 | |
ee382f2f | 9629 | =over 4 |
dc5c060f | 9630 | |
ee382f2f | 9631 | =item Mailing list for Perl on VM/ESA |
dc5c060f | 9632 | |
ee382f2f | 9633 | =back |
dc5c060f | 9634 | |
ee382f2f | 9635 | =back |
dc5c060f | 9636 | |
ee382f2f | 9637 | =head2 perlvms - VMS-specific documentation for Perl |
dc5c060f | 9638 | |
ee382f2f | 9639 | =over 4 |
dc5c060f | 9640 | |
ee382f2f | 9641 | =item DESCRIPTION |
dc5c060f | 9642 | |
ee382f2f | 9643 | =item Installation |
dc5c060f | 9644 | |
ee382f2f | 9645 | =item Organization of Perl Images |
954c1994 | 9646 | |
ee382f2f | 9647 | =over 4 |
954c1994 | 9648 | |
ee382f2f | 9649 | =item Core Images |
35c7d401 | 9650 | |
ee382f2f | 9651 | =item Perl Extensions |
a45bd81d | 9652 | |
ee382f2f | 9653 | =item Installing static extensions |
4755096e | 9654 | |
ee382f2f | 9655 | =item Installing dynamic extensions |
954c1994 | 9656 | |
ee382f2f | 9657 | =back |
a45bd81d | 9658 | |
ee382f2f | 9659 | =item File specifications |
35c7d401 | 9660 | |
ee382f2f | 9661 | =over 4 |
c76ac1ee | 9662 | |
ee382f2f JH |
9663 | =item Syntax |
9664 | ||
9665 | =item Wildcard expansion | |
9666 | ||
9667 | =item Pipes | |
954c1994 | 9668 | |
35c7d401 | 9669 | =back |
954c1994 | 9670 | |
ee382f2f JH |
9671 | =item PERL5LIB and PERLLIB |
9672 | ||
9673 | =item Command line | |
9674 | ||
9675 | =over 4 | |
9676 | ||
9677 | =item I/O redirection and backgrounding | |
9678 | ||
9679 | =item Command line switches | |
9680 | ||
9681 | -i, -S, -u | |
954c1994 GS |
9682 | |
9683 | =back | |
9684 | ||
ee382f2f JH |
9685 | =item Perl functions |
9686 | ||
9687 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
9688 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
9689 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
9690 | LIST, waitpid PID,FLAGS | |
9691 | ||
9692 | =item Perl variables | |
9693 | ||
9694 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| | |
9695 | ||
9696 | =item Standard modules with VMS-specific differences | |
954c1994 | 9697 | |
d420ca49 | 9698 | =over 4 |
954c1994 | 9699 | |
ee382f2f | 9700 | =item SDBM_File |
2e1d04bc | 9701 | |
ee382f2f | 9702 | =back |
954c1994 | 9703 | |
ee382f2f | 9704 | =item Revision date |
c76ac1ee | 9705 | |
35c7d401 | 9706 | =item AUTHOR |
a45bd81d | 9707 | |
35c7d401 | 9708 | =back |
4755096e | 9709 | |
ee382f2f | 9710 | =head2 perlvos, README.vos - Perl for Stratus VOS |
d516a115 | 9711 | |
d420ca49 | 9712 | =over 4 |
a45bd81d | 9713 | |
35c7d401 | 9714 | =item SYNOPSIS |
d516a115 | 9715 | |
ee382f2f | 9716 | =over 4 |
d516a115 | 9717 | |
ee382f2f JH |
9718 | =item Multiple methods to build perl for VOS |
9719 | ||
9720 | =item Stratus POSIX Support | |
4755096e GS |
9721 | |
9722 | =back | |
9723 | ||
ee382f2f | 9724 | =item INSTALLING PERL IN VOS |
4755096e | 9725 | |
35c7d401 | 9726 | =over 4 |
4755096e | 9727 | |
ee382f2f | 9728 | =item Compiling Perl 5 on VOS |
4755096e | 9729 | |
ee382f2f JH |
9730 | =item Installing Perl 5 on VOS |
9731 | ||
9732 | =back | |
9733 | ||
9734 | =item USING PERL IN VOS | |
d516a115 | 9735 | |
d420ca49 | 9736 | =over 4 |
d516a115 | 9737 | |
ee382f2f | 9738 | =item Unimplemented Features of Perl on VOS |
d516a115 | 9739 | |
ee382f2f JH |
9740 | =item Restrictions of Perl on VOS |
9741 | ||
9742 | =item Handling of underflow and overflow | |
d516a115 | 9743 | |
35c7d401 | 9744 | =back |
4755096e | 9745 | |
ee382f2f JH |
9746 | =item TEST STATUS |
9747 | ||
9748 | =item SUPPORT STATUS | |
9749 | ||
4755096e GS |
9750 | =item AUTHOR |
9751 | ||
ee382f2f JH |
9752 | =item LAST UPDATE |
9753 | ||
4755096e GS |
9754 | =back |
9755 | ||
c66ca2ac NC |
9756 | =head2 perlwin32 - Perl under Windows |
9757 | ||
9758 | =over 4 | |
9759 | ||
9760 | =item SYNOPSIS | |
9761 | ||
9762 | =item DESCRIPTION | |
9763 | ||
9764 | =over 4 | |
9765 | ||
9766 | =item Setting Up Perl on Win32 | |
9767 | ||
a2db77eb NC |
9768 | Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual |
9769 | C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3 | |
9770 | with gcc, MinGW release 1 with gcc | |
c66ca2ac NC |
9771 | |
9772 | =item Building | |
9773 | ||
9774 | =item Testing Perl on Win32 | |
9775 | ||
9776 | =item Installation of Perl on Win32 | |
9777 | ||
9778 | =item Usage Hints for Perl on Win32 | |
9779 | ||
9780 | Environment Variables, File Globbing, Using perl from the command line, | |
9781 | Building Extensions, Command-line Wildcard Expansion, Win32 Specific | |
9782 | Extensions, Notes on 64-bit Windows | |
9783 | ||
9784 | =item Running Perl Scripts | |
9785 | ||
a2db77eb | 9786 | =item Miscellaneous Things |
c66ca2ac NC |
9787 | |
9788 | =back | |
9789 | ||
9790 | =item BUGS AND CAVEATS | |
9791 | ||
7f106169 NC |
9792 | =item ACKNOWLEDGEMENTS |
9793 | ||
c66ca2ac NC |
9794 | =item AUTHORS |
9795 | ||
9796 | Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy | |
9797 | E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons | |
b2a9ae16 NC |
9798 | E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>, |
9799 | Steve Hay E<lt>steve.hay@uk.radan.comE<gt> | |
c66ca2ac NC |
9800 | |
9801 | =item SEE ALSO | |
9802 | ||
9803 | =item HISTORY | |
9804 | ||
9805 | =back | |
9806 | ||
ee382f2f JH |
9807 | =head1 PRAGMA DOCUMENTATION |
9808 | ||
9809 | =head2 attrs - set/get attributes of a subroutine (deprecated) | |
9a997319 | 9810 | |
d420ca49 | 9811 | =over 4 |
9a997319 JH |
9812 | |
9813 | =item SYNOPSIS | |
9814 | ||
35c7d401 | 9815 | =item DESCRIPTION |
9a997319 | 9816 | |
ee382f2f | 9817 | method, locked |
9a997319 | 9818 | |
ee382f2f | 9819 | =back |
9a997319 | 9820 | |
ee382f2f | 9821 | =head2 re - Perl pragma to alter regular expression behaviour |
9a997319 | 9822 | |
ee382f2f | 9823 | =over 4 |
9a997319 | 9824 | |
ee382f2f JH |
9825 | =item SYNOPSIS |
9826 | ||
9827 | =item DESCRIPTION | |
9a997319 JH |
9828 | |
9829 | =back | |
9830 | ||
ee382f2f JH |
9831 | =head2 threadshared::shared, threads::shared - Perl extension for sharing |
9832 | data structures between threads | |
9a997319 | 9833 | |
d420ca49 | 9834 | =over 4 |
9a997319 | 9835 | |
35c7d401 | 9836 | =item SYNOPSIS |
9a997319 | 9837 | |
35c7d401 | 9838 | =item DESCRIPTION |
9a997319 | 9839 | |
ee382f2f | 9840 | =item EXPORT |
23be5fc4 | 9841 | |
ee382f2f | 9842 | =item FUNCTIONS |
9a997319 | 9843 | |
4c64e75b NC |
9844 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, |
9845 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, | |
9846 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE | |
ee382f2f JH |
9847 | |
9848 | =item NOTES | |
23be5fc4 | 9849 | |
35c7d401 | 9850 | =item BUGS |
9a997319 JH |
9851 | |
9852 | =item AUTHOR | |
9853 | ||
ee382f2f JH |
9854 | =item SEE ALSO |
9855 | ||
9a997319 JH |
9856 | =back |
9857 | ||
ee382f2f JH |
9858 | =head2 threads - Perl extension allowing use of interpreter based threads |
9859 | from perl | |
23be5fc4 JH |
9860 | |
9861 | =over 4 | |
9862 | ||
9863 | =item SYNOPSIS | |
9864 | ||
9865 | =item DESCRIPTION | |
9866 | ||
ee382f2f JH |
9867 | $thread = threads->create(function, LIST), $thread->join, $thread->detach, |
9868 | threads->self, $thread->tid, threads->object( tid ), threads->yield();, | |
9869 | threads->list();, async BLOCK; | |
23be5fc4 | 9870 | |
ee382f2f | 9871 | =item WARNINGS |
23be5fc4 | 9872 | |
ee382f2f | 9873 | A thread exited while %d other threads were still running |
23be5fc4 | 9874 | |
ee382f2f | 9875 | =item TODO |
97f7c9df | 9876 | |
ee382f2f | 9877 | =item BUGS |
97f7c9df | 9878 | |
b40eed9c NC |
9879 | Parent-Child threads, tid is I32, Returning objects, Creating threads |
9880 | inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be | |
23be5fc4 | 9881 | |
ee382f2f | 9882 | =item AUTHOR and COPYRIGHT |
23be5fc4 | 9883 | |
ee382f2f | 9884 | =item SEE ALSO |
23be5fc4 | 9885 | |
35c7d401 | 9886 | =back |
23be5fc4 | 9887 | |
ee382f2f | 9888 | =head2 attributes - get/set subroutine or variable attributes |
23be5fc4 | 9889 | |
35c7d401 | 9890 | =over 4 |
23be5fc4 | 9891 | |
35c7d401 | 9892 | =item SYNOPSIS |
23be5fc4 | 9893 | |
35c7d401 | 9894 | =item DESCRIPTION |
23be5fc4 | 9895 | |
ee382f2f | 9896 | =over 4 |
cb1a09d0 | 9897 | |
ee382f2f | 9898 | =item Built-in Attributes |
35c7d401 | 9899 | |
ee382f2f | 9900 | locked, method, lvalue |
35c7d401 | 9901 | |
ee382f2f | 9902 | =item Available Subroutines |
35c7d401 | 9903 | |
ee382f2f | 9904 | get, reftype |
35c7d401 | 9905 | |
ee382f2f JH |
9906 | =item Package-specific Attribute Handling |
9907 | ||
9908 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
9909 | ||
9910 | =item Syntax of Attribute Lists | |
9911 | ||
9912 | =back | |
9913 | ||
9914 | =item EXPORTS | |
d516a115 | 9915 | |
d420ca49 | 9916 | =over 4 |
a45bd81d | 9917 | |
ee382f2f | 9918 | =item Default exports |
d516a115 | 9919 | |
ee382f2f JH |
9920 | =item Available exports |
9921 | ||
9922 | =item Export tags defined | |
d516a115 | 9923 | |
35c7d401 JH |
9924 | =back |
9925 | ||
ee382f2f | 9926 | =item EXAMPLES |
35c7d401 | 9927 | |
ee382f2f | 9928 | =item SEE ALSO |
d516a115 | 9929 | |
a45bd81d GS |
9930 | =back |
9931 | ||
ee382f2f | 9932 | =head2 autouse - postpone load of modules until a function is used |
1fdc5aa6 JH |
9933 | |
9934 | =over 4 | |
9935 | ||
9936 | =item SYNOPSIS | |
9937 | ||
9938 | =item DESCRIPTION | |
9939 | ||
ee382f2f | 9940 | =item WARNING |
cb52f95f | 9941 | |
ee382f2f | 9942 | =item AUTHOR |
1fdc5aa6 | 9943 | |
ee382f2f | 9944 | =item SEE ALSO |
04b01f78 | 9945 | |
ee382f2f | 9946 | =back |
1fdc5aa6 | 9947 | |
4c64e75b | 9948 | =head2 base - Establish IS-A relationship with base classes at compile time |
e61ecf27 | 9949 | |
ee382f2f | 9950 | =over 4 |
e61ecf27 | 9951 | |
ee382f2f | 9952 | =item SYNOPSIS |
e61ecf27 | 9953 | |
ee382f2f | 9954 | =item DESCRIPTION |
e61ecf27 | 9955 | |
d3ca9f77 NC |
9956 | =item DIAGNOSTICS |
9957 | ||
9958 | Base class package "%s" is empty | |
9959 | ||
ee382f2f | 9960 | =item HISTORY |
e61ecf27 | 9961 | |
cd458e05 JH |
9962 | =item CAVEATS |
9963 | ||
ee382f2f | 9964 | =item SEE ALSO |
e993db8c | 9965 | |
35c7d401 | 9966 | =back |
e993db8c | 9967 | |
ee382f2f | 9968 | =head2 bigint - Transparent BigInteger support for Perl |
5df44211 | 9969 | |
35c7d401 | 9970 | =over 4 |
e61ecf27 | 9971 | |
35c7d401 | 9972 | =item SYNOPSIS |
e61ecf27 | 9973 | |
35c7d401 | 9974 | =item DESCRIPTION |
e61ecf27 | 9975 | |
ee382f2f | 9976 | =over 4 |
e61ecf27 | 9977 | |
b2a9ae16 | 9978 | =item Options |
e61ecf27 | 9979 | |
ee382f2f | 9980 | a or accuracy, p or precision, t or trace, l or lib, v or version |
c76ac1ee | 9981 | |
b2a9ae16 | 9982 | =item Math Library |
a45bd81d | 9983 | |
b2a9ae16 | 9984 | =item Internal Format |
c76ac1ee | 9985 | |
b2a9ae16 | 9986 | =item Sign |
c76ac1ee | 9987 | |
b2a9ae16 | 9988 | =item Methods |
c76ac1ee | 9989 | |
b2a9ae16 | 9990 | =item Caveat |
73fba812 | 9991 | |
ee382f2f | 9992 | =back |
c76ac1ee | 9993 | |
ee382f2f | 9994 | =item MODULES USED |
c76ac1ee | 9995 | |
ee382f2f | 9996 | =item EXAMPLES |
c76ac1ee | 9997 | |
ee382f2f | 9998 | =item LICENSE |
c76ac1ee | 9999 | |
ee382f2f JH |
10000 | =item SEE ALSO |
10001 | ||
10002 | =item AUTHORS | |
c76ac1ee GS |
10003 | |
10004 | =back | |
10005 | ||
ee382f2f | 10006 | =head2 bignum - Transparent BigNumber support for Perl |
a45bd81d | 10007 | |
d420ca49 | 10008 | =over 4 |
a45bd81d | 10009 | |
35c7d401 | 10010 | =item SYNOPSIS |
a45bd81d | 10011 | |
35c7d401 | 10012 | =item DESCRIPTION |
a45bd81d | 10013 | |
ee382f2f | 10014 | =over 4 |
a45bd81d | 10015 | |
b2a9ae16 | 10016 | =item Options |
a45bd81d | 10017 | |
ee382f2f | 10018 | a or accuracy, p or precision, t or trace, l or lib, v or version |
c76ac1ee | 10019 | |
b2a9ae16 | 10020 | =item Methods |
ee382f2f | 10021 | |
b2a9ae16 | 10022 | =item Caveat |
73fba812 | 10023 | |
ee382f2f JH |
10024 | inf(), NaN(), upgrade() |
10025 | ||
10026 | =item MATH LIBRARY | |
10027 | ||
10028 | =item INTERNAL FORMAT | |
10029 | ||
10030 | =item SIGN | |
c76ac1ee | 10031 | |
a45bd81d GS |
10032 | =back |
10033 | ||
ee382f2f | 10034 | =item MODULES USED |
e993db8c | 10035 | |
ee382f2f | 10036 | =item EXAMPLES |
e993db8c | 10037 | |
ee382f2f | 10038 | =item LICENSE |
e993db8c | 10039 | |
ee382f2f | 10040 | =item SEE ALSO |
e993db8c | 10041 | |
ee382f2f | 10042 | =item AUTHORS |
e993db8c JH |
10043 | |
10044 | =back | |
10045 | ||
4ed3c8ae | 10046 | =head2 bigrat - Transparent BigNumber/BigRational support for Perl |
cb52f95f JH |
10047 | |
10048 | =over 4 | |
10049 | ||
10050 | =item SYNOPSIS | |
10051 | ||
10052 | =item DESCRIPTION | |
10053 | ||
ee382f2f | 10054 | =over 4 |
fa1c7b03 | 10055 | |
b2a9ae16 | 10056 | =item Modules Used |
cb52f95f | 10057 | |
b2a9ae16 | 10058 | =item Math Library |
35c7d401 | 10059 | |
b2a9ae16 | 10060 | =item Sign |
68dc0745 | 10061 | |
b2a9ae16 | 10062 | =item Methods |
a45bd81d | 10063 | |
b2a9ae16 NC |
10064 | =item Cavaet |
10065 | ||
10066 | =item Options | |
10067 | ||
10068 | a or accuracy, p or precision, t or trace, l or lib, v or version | |
73fba812 | 10069 | |
ee382f2f | 10070 | =back |
68dc0745 | 10071 | |
ee382f2f | 10072 | =item EXAMPLES |
68dc0745 | 10073 | |
ee382f2f JH |
10074 | perl -Mbigrat -le 'print sqrt(33)' |
10075 | perl -Mbigrat -le 'print 2*255' | |
10076 | perl -Mbigrat -le 'print 4.5+2*255' | |
10077 | perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3' | |
10078 | perl -Mbigrat -le 'print 12->is_odd()'; | |
10079 | ||
10080 | =item LICENSE | |
10081 | ||
10082 | =item SEE ALSO | |
10083 | ||
10084 | =item AUTHORS | |
fa1c7b03 JH |
10085 | |
10086 | =back | |
10087 | ||
ee382f2f | 10088 | =head2 blib - Use MakeMaker's uninstalled version of a package |
fa1c7b03 JH |
10089 | |
10090 | =over 4 | |
10091 | ||
10092 | =item SYNOPSIS | |
10093 | ||
10094 | =item DESCRIPTION | |
10095 | ||
35c7d401 | 10096 | =item BUGS |
fa1c7b03 | 10097 | |
35c7d401 | 10098 | =item AUTHOR |
fa1c7b03 | 10099 | |
35c7d401 | 10100 | =back |
fa1c7b03 | 10101 | |
ee382f2f JH |
10102 | =head2 bytes - Perl pragma to force byte semantics rather than character |
10103 | semantics | |
fa1c7b03 | 10104 | |
35c7d401 | 10105 | =over 4 |
fa1c7b03 | 10106 | |
35c7d401 | 10107 | =item SYNOPSIS |
fa1c7b03 | 10108 | |
35c7d401 | 10109 | =item DESCRIPTION |
fa1c7b03 | 10110 | |
cd458e05 JH |
10111 | =item LIMITATIONS |
10112 | ||
ee382f2f | 10113 | =item SEE ALSO |
35c7d401 JH |
10114 | |
10115 | =back | |
10116 | ||
ee382f2f JH |
10117 | =head2 charnames - define character names for C<\N{named}> string literal |
10118 | escapes | |
d516a115 | 10119 | |
d420ca49 | 10120 | =over 4 |
a45bd81d | 10121 | |
d516a115 JH |
10122 | =item SYNOPSIS |
10123 | ||
10124 | =item DESCRIPTION | |
10125 | ||
ee382f2f JH |
10126 | =item CUSTOM TRANSLATORS |
10127 | ||
10128 | =item CUSTOM ALIASES | |
10129 | ||
fa1c7b03 JH |
10130 | =over 4 |
10131 | ||
ee382f2f | 10132 | =item Anonymous hashes |
fa1c7b03 | 10133 | |
ee382f2f | 10134 | =item Alias file |
fa1c7b03 | 10135 | |
ee382f2f | 10136 | =item Alias shortcut |
fa1c7b03 | 10137 | |
ee382f2f | 10138 | =back |
fa1c7b03 | 10139 | |
ee382f2f | 10140 | =item charnames::viacode(code) |
fa1c7b03 | 10141 | |
ee382f2f | 10142 | =item charnames::vianame(name) |
35c7d401 | 10143 | |
ee382f2f JH |
10144 | =item ALIASES |
10145 | ||
10146 | =item ILLEGAL CHARACTERS | |
10147 | ||
10148 | =item BUGS | |
fa1c7b03 JH |
10149 | |
10150 | =back | |
10151 | ||
ee382f2f | 10152 | =head2 constant - Perl pragma to declare constants |
fa1c7b03 | 10153 | |
ee382f2f | 10154 | =over 4 |
fa1c7b03 | 10155 | |
ee382f2f | 10156 | =item SYNOPSIS |
35c7d401 | 10157 | |
ee382f2f | 10158 | =item DESCRIPTION |
fa1c7b03 | 10159 | |
ee382f2f | 10160 | =item NOTES |
fa1c7b03 | 10161 | |
ee382f2f | 10162 | =over 4 |
fa1c7b03 | 10163 | |
ee382f2f | 10164 | =item List constants |
35c7d401 | 10165 | |
ee382f2f | 10166 | =item Defining multiple constants at once |
fa1c7b03 | 10167 | |
ee382f2f | 10168 | =item Magic constants |
fa1c7b03 | 10169 | |
ee382f2f | 10170 | =back |
fa1c7b03 | 10171 | |
ee382f2f | 10172 | =item TECHNICAL NOTES |
fa1c7b03 | 10173 | |
ee382f2f | 10174 | =item BUGS |
fa1c7b03 | 10175 | |
35c7d401 | 10176 | =item AUTHOR |
fa1c7b03 | 10177 | |
ee382f2f | 10178 | =item COPYRIGHT |
fa1c7b03 | 10179 | |
35c7d401 | 10180 | =back |
fa1c7b03 | 10181 | |
7a5cdbdf | 10182 | =head2 diagnostics, splain - produce verbose warning diagnostics |
fa1c7b03 | 10183 | |
35c7d401 | 10184 | =over 4 |
fa1c7b03 | 10185 | |
35c7d401 | 10186 | =item SYNOPSIS |
fa1c7b03 | 10187 | |
35c7d401 | 10188 | =item DESCRIPTION |
fa1c7b03 | 10189 | |
ee382f2f | 10190 | =over 4 |
fa1c7b03 | 10191 | |
ee382f2f JH |
10192 | =item The C<diagnostics> Pragma |
10193 | ||
10194 | =item The I<splain> Program | |
10195 | ||
10196 | =back | |
14218588 | 10197 | |
35c7d401 JH |
10198 | =item EXAMPLES |
10199 | ||
ee382f2f JH |
10200 | =item INTERNALS |
10201 | ||
35c7d401 | 10202 | =item BUGS |
d516a115 | 10203 | |
ee382f2f | 10204 | =item AUTHOR |
fa1c7b03 | 10205 | |
a45bd81d GS |
10206 | =back |
10207 | ||
ee382f2f | 10208 | =head2 encoding - allows you to write your script in non-ascii or non-utf8 |
cb1a09d0 | 10209 | |
d420ca49 | 10210 | =over 4 |
a45bd81d | 10211 | |
8ebc5c01 | 10212 | =item SYNOPSIS |
cb1a09d0 | 10213 | |
35c7d401 JH |
10214 | =item ABSTRACT |
10215 | ||
35c7d401 | 10216 | =over 4 |
cb1a09d0 | 10217 | |
ee382f2f | 10218 | =item Literal Conversions |
cb1a09d0 | 10219 | |
ee382f2f | 10220 | =item PerlIO layers for C<STD(IN|OUT)> |
a45bd81d | 10221 | |
7a5cdbdf AJ |
10222 | =item Implicit upgrading for byte strings |
10223 | ||
ee382f2f | 10224 | =back |
a45bd81d | 10225 | |
ee382f2f | 10226 | =item FEATURES THAT REQUIRE 5.8.1 |
a45bd81d | 10227 | |
ee382f2f | 10228 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle |
a45bd81d | 10229 | |
ee382f2f | 10230 | =item USAGE |
a45bd81d | 10231 | |
ee382f2f JH |
10232 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> |
10233 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; | |
a10cf691 | 10234 | |
ee382f2f | 10235 | =item The Filter Option |
a45bd81d | 10236 | |
ee382f2f | 10237 | =over 4 |
c76ac1ee | 10238 | |
ee382f2f | 10239 | =item Filter-related changes at Encode version 1.87 |
a45bd81d | 10240 | |
ee382f2f | 10241 | =back |
c76ac1ee | 10242 | |
ee382f2f | 10243 | =item CAVEATS |
c76ac1ee | 10244 | |
ee382f2f | 10245 | =over 4 |
c76ac1ee | 10246 | |
ee382f2f | 10247 | =item NOT SCOPED |
ba62762e | 10248 | |
ee382f2f | 10249 | =item DO NOT MIX MULTIPLE ENCODINGS |
34babc16 | 10250 | |
ee382f2f | 10251 | =item tr/// with ranges |
e993db8c | 10252 | |
ee382f2f | 10253 | Legend of characters above |
80637b95 | 10254 | |
ee382f2f | 10255 | =back |
c76ac1ee | 10256 | |
ee382f2f | 10257 | =item EXAMPLE - Greekperl |
a45bd81d | 10258 | |
ee382f2f | 10259 | =item KNOWN PROBLEMS |
54310121 | 10260 | |
ee382f2f | 10261 | literals in regex that are longer than 127 bytes, EBCDIC, format |
a45bd81d | 10262 | |
a2db77eb NC |
10263 | =over 4 |
10264 | ||
10265 | =item The Logic of :locale | |
10266 | ||
10267 | =back | |
10268 | ||
ee382f2f JH |
10269 | =item HISTORY |
10270 | ||
10271 | =item SEE ALSO | |
54310121 | 10272 | |
35c7d401 | 10273 | =back |
54310121 | 10274 | |
ee382f2f | 10275 | =head2 fields - compile-time class fields |
54310121 | 10276 | |
890a53b9 JH |
10277 | =over 4 |
10278 | ||
ee382f2f | 10279 | =item SYNOPSIS |
890a53b9 | 10280 | |
ee382f2f | 10281 | =item DESCRIPTION |
54310121 | 10282 | |
ee382f2f | 10283 | new, phash |
54310121 | 10284 | |
ee382f2f | 10285 | =item SEE ALSO |
a45bd81d | 10286 | |
35c7d401 | 10287 | =back |
cb1a09d0 | 10288 | |
ee382f2f | 10289 | =head2 filetest - Perl pragma to control the filetest permission operators |
cb1a09d0 | 10290 | |
d420ca49 | 10291 | =over 4 |
cb1a09d0 | 10292 | |
ee382f2f | 10293 | =item SYNOPSIS |
cb1a09d0 | 10294 | |
ee382f2f | 10295 | =item DESCRIPTION |
cb1a09d0 | 10296 | |
ee382f2f | 10297 | =over 4 |
cb1a09d0 | 10298 | |
ee382f2f | 10299 | =item subpragma access |
cb1a09d0 | 10300 | |
ee382f2f | 10301 | =back |
cb1a09d0 | 10302 | |
a45bd81d GS |
10303 | =back |
10304 | ||
ee382f2f | 10305 | =head2 if - C<use> a Perl module if a condition holds |
cb52f95f JH |
10306 | |
10307 | =over 4 | |
10308 | ||
ee382f2f | 10309 | =item SYNOPSIS |
cb52f95f | 10310 | |
ee382f2f | 10311 | =item DESCRIPTION |
e993db8c | 10312 | |
ee382f2f | 10313 | =item BUGS |
e993db8c | 10314 | |
ee382f2f | 10315 | =item AUTHOR |
e993db8c | 10316 | |
ee382f2f | 10317 | =back |
e993db8c | 10318 | |
ee382f2f JH |
10319 | =head2 integer - Perl pragma to use integer arithmetic instead of floating |
10320 | point | |
e993db8c | 10321 | |
ee382f2f | 10322 | =over 4 |
e993db8c | 10323 | |
ee382f2f | 10324 | =item SYNOPSIS |
e993db8c | 10325 | |
ee382f2f | 10326 | =item DESCRIPTION |
e993db8c | 10327 | |
ee382f2f | 10328 | =back |
d8416318 | 10329 | |
ee382f2f | 10330 | =head2 less - perl pragma to request less of something from the compiler |
d8416318 | 10331 | |
ee382f2f | 10332 | =over 4 |
cb52f95f | 10333 | |
ee382f2f | 10334 | =item SYNOPSIS |
cb52f95f | 10335 | |
ee382f2f | 10336 | =item DESCRIPTION |
cb52f95f | 10337 | |
ee382f2f | 10338 | =back |
cb52f95f | 10339 | |
ee382f2f | 10340 | =head2 lib - manipulate @INC at compile time |
d516a115 | 10341 | |
ee382f2f | 10342 | =over 4 |
a45bd81d | 10343 | |
ee382f2f | 10344 | =item SYNOPSIS |
d516a115 | 10345 | |
ee382f2f | 10346 | =item DESCRIPTION |
d516a115 | 10347 | |
ee382f2f | 10348 | =over 4 |
694468e3 | 10349 | |
ee382f2f | 10350 | =item Adding directories to @INC |
fb9cefb4 | 10351 | |
ee382f2f | 10352 | =item Deleting directories from @INC |
a45bd81d | 10353 | |
ee382f2f | 10354 | =item Restoring original @INC |
14218588 | 10355 | |
ee382f2f | 10356 | =back |
a45bd81d | 10357 | |
ee382f2f | 10358 | =item CAVEATS |
14218588 | 10359 | |
ee382f2f | 10360 | =item NOTES |
14218588 | 10361 | |
ee382f2f | 10362 | =item SEE ALSO |
14218588 | 10363 | |
ee382f2f | 10364 | =item AUTHOR |
14218588 GS |
10365 | |
10366 | =back | |
10367 | ||
ee382f2f JH |
10368 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
10369 | operations | |
a45bd81d | 10370 | |
ee382f2f | 10371 | =over 4 |
12b7c5c7 | 10372 | |
ee382f2f | 10373 | =item SYNOPSIS |
12b7c5c7 | 10374 | |
ee382f2f | 10375 | =item DESCRIPTION |
12b7c5c7 | 10376 | |
ee382f2f | 10377 | =back |
12b7c5c7 | 10378 | |
ee382f2f | 10379 | =head2 open - perl pragma to set default PerlIO layers for input and output |
cb1a09d0 | 10380 | |
d420ca49 | 10381 | =over 4 |
a45bd81d | 10382 | |
ee382f2f | 10383 | =item SYNOPSIS |
cb1a09d0 | 10384 | |
ee382f2f | 10385 | =item DESCRIPTION |
a45bd81d | 10386 | |
ee382f2f | 10387 | =item NONPERLIO FUNCTIONALITY |
cb1a09d0 | 10388 | |
ee382f2f | 10389 | =item IMPLEMENTATION DETAILS |
cb1a09d0 | 10390 | |
ee382f2f | 10391 | =item SEE ALSO |
a45bd81d | 10392 | |
ee382f2f | 10393 | =back |
cb1a09d0 | 10394 | |
ee382f2f | 10395 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
a45bd81d | 10396 | |
ee382f2f | 10397 | =over 4 |
cb1a09d0 | 10398 | |
ee382f2f | 10399 | =item SYNOPSIS |
cb1a09d0 | 10400 | |
ee382f2f | 10401 | =item DESCRIPTION |
8ebc5c01 | 10402 | |
ee382f2f | 10403 | =item SEE ALSO |
cb1a09d0 | 10404 | |
ee382f2f | 10405 | =back |
cb1a09d0 | 10406 | |
e1114e52 | 10407 | =head2 overload - Package for overloading Perl operations |
cb1a09d0 | 10408 | |
ee382f2f | 10409 | =over 4 |
cb1a09d0 | 10410 | |
ee382f2f | 10411 | =item SYNOPSIS |
04b01f78 | 10412 | |
ee382f2f | 10413 | =item DESCRIPTION |
0d6290d3 | 10414 | |
ee382f2f | 10415 | =over 4 |
cb1a09d0 | 10416 | |
ee382f2f | 10417 | =item Declaration of overloaded functions |
a45bd81d | 10418 | |
ee382f2f | 10419 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 10420 | |
ee382f2f | 10421 | FALSE, TRUE, C<undef> |
a45bd81d | 10422 | |
ee382f2f | 10423 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 10424 | |
ee382f2f | 10425 | =item Calling Conventions for Mutators |
35c7d401 | 10426 | |
ee382f2f | 10427 | C<++> and C<-->, C<x=> and other assignment versions |
cb1a09d0 | 10428 | |
ee382f2f | 10429 | =item Overloadable Operations |
35c7d401 | 10430 | |
ee382f2f JH |
10431 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
10432 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
10433 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> | |
35c7d401 | 10434 | |
ee382f2f JH |
10435 | =item Inheritance and overloading |
10436 | ||
10437 | Strings as values of C<use overload> directive, Overloading of an operation | |
10438 | is inherited by derived classes | |
35c7d401 | 10439 | |
a45bd81d GS |
10440 | =back |
10441 | ||
ee382f2f | 10442 | =item SPECIAL SYMBOLS FOR C<use overload> |
b38f6a39 | 10443 | |
d420ca49 | 10444 | =over 4 |
b38f6a39 | 10445 | |
ee382f2f | 10446 | =item Last Resort |
b38f6a39 | 10447 | |
ee382f2f | 10448 | =item Fallback |
0d0e97a6 | 10449 | |
ee382f2f | 10450 | C<undef>, TRUE, defined, but FALSE |
b38f6a39 | 10451 | |
ee382f2f | 10452 | =item Copy Constructor |
b38f6a39 | 10453 | |
ee382f2f | 10454 | B<Example> |
b38f6a39 | 10455 | |
35c7d401 | 10456 | =back |
e993db8c | 10457 | |
ee382f2f | 10458 | =item MAGIC AUTOGENERATION |
e993db8c | 10459 | |
ee382f2f JH |
10460 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
10461 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
10462 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, | |
10463 | I<Copy operator> | |
e993db8c | 10464 | |
ee382f2f | 10465 | =item Losing overloading |
e993db8c | 10466 | |
ee382f2f | 10467 | =item Run-time Overloading |
e993db8c | 10468 | |
ee382f2f | 10469 | =item Public functions |
e993db8c | 10470 | |
ee382f2f | 10471 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 10472 | |
ee382f2f | 10473 | =item Overloading constants |
a45bd81d | 10474 | |
ee382f2f | 10475 | integer, float, binary, q, qr |
cb1a09d0 | 10476 | |
ee382f2f | 10477 | =item IMPLEMENTATION |
cb1a09d0 | 10478 | |
ee382f2f | 10479 | =item Metaphor clash |
cb1a09d0 | 10480 | |
ee382f2f | 10481 | =item Cookbook |
cb1a09d0 | 10482 | |
35c7d401 | 10483 | =over 4 |
cb1a09d0 | 10484 | |
ee382f2f | 10485 | =item Two-face scalars |
cb1a09d0 | 10486 | |
ee382f2f | 10487 | =item Two-face references |
14218588 | 10488 | |
ee382f2f | 10489 | =item Symbolic calculator |
14218588 | 10490 | |
ee382f2f | 10491 | =item I<Really> symbolic calculator |
cb1a09d0 | 10492 | |
35c7d401 | 10493 | =back |
cb1a09d0 | 10494 | |
ee382f2f | 10495 | =item AUTHOR |
774d564b | 10496 | |
ee382f2f | 10497 | =item DIAGNOSTICS |
35c7d401 | 10498 | |
ee382f2f JH |
10499 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
10500 | type, `%s' is not a code reference | |
10501 | ||
10502 | =item BUGS | |
774d564b | 10503 | |
8ebc5c01 | 10504 | =back |
cb1a09d0 | 10505 | |
ee382f2f | 10506 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 10507 | |
ee382f2f | 10508 | =over 4 |
cb1a09d0 | 10509 | |
ee382f2f | 10510 | =item SYNOPSIS |
cb1a09d0 | 10511 | |
ee382f2f | 10512 | =item DESCRIPTION |
cb1a09d0 | 10513 | |
ee382f2f | 10514 | =item OPTIONS |
fb9cefb4 | 10515 | |
35c7d401 | 10516 | =over 4 |
cb1a09d0 | 10517 | |
ee382f2f | 10518 | =item SIGNAL HANDLERS |
14218588 | 10519 | |
ee382f2f | 10520 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
14218588 | 10521 | |
ee382f2f | 10522 | =item SIGNAL LISTS |
14218588 | 10523 | |
ee382f2f | 10524 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
14218588 | 10525 | |
ee382f2f | 10526 | =item OTHER |
497711e7 | 10527 | |
ee382f2f | 10528 | B<untrapped>, B<any>, I<signal>, I<number> |
497711e7 | 10529 | |
ee382f2f | 10530 | =back |
14218588 | 10531 | |
ee382f2f | 10532 | =item EXAMPLES |
14218588 | 10533 | |
a45bd81d GS |
10534 | =back |
10535 | ||
ee382f2f | 10536 | =head2 sort - perl pragma to control sort() behaviour |
cb1a09d0 | 10537 | |
d420ca49 | 10538 | =over 4 |
a45bd81d | 10539 | |
8ebc5c01 | 10540 | =item SYNOPSIS |
cb1a09d0 | 10541 | |
8ebc5c01 | 10542 | =item DESCRIPTION |
cb1a09d0 | 10543 | |
ee382f2f | 10544 | =item CAVEATS |
cb1a09d0 | 10545 | |
a45bd81d GS |
10546 | =back |
10547 | ||
ee382f2f | 10548 | =head2 strict - Perl pragma to restrict unsafe constructs |
428dc699 JH |
10549 | |
10550 | =over 4 | |
10551 | ||
10552 | =item SYNOPSIS | |
10553 | ||
10554 | =item DESCRIPTION | |
10555 | ||
ee382f2f | 10556 | C<strict refs>, C<strict vars>, C<strict subs> |
e993db8c | 10557 | |
6e76d345 JH |
10558 | =item HISTORY |
10559 | ||
428dc699 JH |
10560 | =back |
10561 | ||
ee382f2f | 10562 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 | 10563 | |
d420ca49 | 10564 | =over 4 |
a45bd81d | 10565 | |
8ebc5c01 | 10566 | =item SYNOPSIS |
cb1a09d0 | 10567 | |
8ebc5c01 | 10568 | =item DESCRIPTION |
cb1a09d0 | 10569 | |
a45bd81d GS |
10570 | =back |
10571 | ||
a2db77eb NC |
10572 | =head2 threadshared, threads::shared - Perl extension for sharing data |
10573 | structures between threads | |
10574 | ||
10575 | =over 4 | |
10576 | ||
10577 | =item SYNOPSIS | |
10578 | ||
10579 | =item DESCRIPTION | |
10580 | ||
10581 | =item EXPORT | |
10582 | ||
10583 | =item FUNCTIONS | |
10584 | ||
10585 | share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR, | |
10586 | LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR, | |
10587 | ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE | |
10588 | ||
10589 | =item NOTES | |
10590 | ||
10591 | =item BUGS | |
10592 | ||
10593 | =item AUTHOR | |
10594 | ||
10595 | =item SEE ALSO | |
10596 | ||
10597 | =back | |
10598 | ||
ee382f2f JH |
10599 | =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source |
10600 | code | |
0e9b9e0c | 10601 | |
ee382f2f | 10602 | =over 4 |
0e9b9e0c | 10603 | |
ee382f2f | 10604 | =item SYNOPSIS |
0e9b9e0c | 10605 | |
ee382f2f | 10606 | =item DESCRIPTION |
0e9b9e0c JH |
10607 | |
10608 | =over 4 | |
10609 | ||
ee382f2f | 10610 | =item Utility functions |
0e9b9e0c | 10611 | |
50e34432 JH |
10612 | $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[, |
10613 | FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag = | |
6e76d345 | 10614 | utf8::is_utf8(STRING), $flag = utf8::valid(STRING) |
0e9b9e0c JH |
10615 | |
10616 | =back | |
10617 | ||
0e9b9e0c JH |
10618 | =item BUGS |
10619 | ||
4a6725af | 10620 | =item SEE ALSO |
cb1a09d0 | 10621 | |
a45bd81d GS |
10622 | =back |
10623 | ||
ee382f2f | 10624 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) |
193fb0af | 10625 | |
d420ca49 | 10626 | =over 4 |
a45bd81d | 10627 | |
193fb0af GS |
10628 | =item SYNOPSIS |
10629 | ||
35c7d401 | 10630 | =item DESCRIPTION |
cb1a09d0 | 10631 | |
a45bd81d GS |
10632 | =back |
10633 | ||
ee382f2f | 10634 | =head2 vmsish - Perl pragma to control VMS-specific language features |
cb1a09d0 | 10635 | |
d420ca49 | 10636 | =over 4 |
a45bd81d | 10637 | |
8ebc5c01 | 10638 | =item SYNOPSIS |
cb1a09d0 | 10639 | |
8ebc5c01 | 10640 | =item DESCRIPTION |
cb1a09d0 | 10641 | |
ee382f2f | 10642 | C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed> |
cb1a09d0 | 10643 | |
a45bd81d GS |
10644 | =back |
10645 | ||
ee382f2f | 10646 | =head2 warnings - Perl pragma to control optional warnings |
cb1a09d0 | 10647 | |
d420ca49 | 10648 | =over 4 |
a45bd81d | 10649 | |
35c7d401 | 10650 | =item SYNOPSIS |
cb1a09d0 AD |
10651 | |
10652 | =item DESCRIPTION | |
10653 | ||
ee382f2f JH |
10654 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
10655 | warnings::enabled($object), warnings::warn($message), | |
10656 | warnings::warn($category, $message), warnings::warn($object, $message), | |
10657 | warnings::warnif($message), warnings::warnif($category, $message), | |
10658 | warnings::warnif($object, $message) | |
cb1a09d0 | 10659 | |
35c7d401 JH |
10660 | =back |
10661 | ||
ee382f2f JH |
10662 | =head2 warnings::register - warnings import function |
10663 | ||
10664 | =over 4 | |
10665 | ||
10666 | =item SYNOPSIS | |
10667 | ||
10668 | =item DESCRIPTION | |
cb1a09d0 | 10669 | |
a45bd81d GS |
10670 | =back |
10671 | ||
ee382f2f | 10672 | =head1 MODULE DOCUMENTATION |
d516a115 | 10673 | |
ee382f2f | 10674 | =head2 AnyDBM_File - provide framework for multiple DBMs |
a45bd81d | 10675 | |
35c7d401 | 10676 | =over 4 |
bd28ded5 | 10677 | |
d516a115 JH |
10678 | =item SYNOPSIS |
10679 | ||
10680 | =item DESCRIPTION | |
10681 | ||
ee382f2f | 10682 | =over 4 |
193fb0af | 10683 | |
ee382f2f | 10684 | =item DBM Comparisons |
193fb0af | 10685 | |
ee382f2f | 10686 | [0], [1], [2], [3] |
193fb0af | 10687 | |
ee382f2f | 10688 | =back |
193fb0af | 10689 | |
ee382f2f | 10690 | =item SEE ALSO |
d516a115 | 10691 | |
a45bd81d GS |
10692 | =back |
10693 | ||
ee382f2f | 10694 | =head2 Attribute::Handlers - Simpler definition of attribute handlers |
d516a115 | 10695 | |
d420ca49 | 10696 | =over 4 |
a45bd81d | 10697 | |
ee382f2f JH |
10698 | =item VERSION |
10699 | ||
d516a115 JH |
10700 | =item SYNOPSIS |
10701 | ||
193fb0af GS |
10702 | =item DESCRIPTION |
10703 | ||
ee382f2f JH |
10704 | [0], [1], [2], [3], [4], [5] |
10705 | ||
35c7d401 | 10706 | =over 4 |
193fb0af | 10707 | |
ee382f2f | 10708 | =item Typed lexicals |
193fb0af | 10709 | |
ee382f2f | 10710 | =item Type-specific attribute handlers |
193fb0af | 10711 | |
ee382f2f | 10712 | =item Non-interpretive attribute handlers |
a45bd81d | 10713 | |
ee382f2f | 10714 | =item Phase-specific attribute handlers |
d516a115 | 10715 | |
ee382f2f | 10716 | =item Attributes as C<tie> interfaces |
a45bd81d | 10717 | |
35c7d401 | 10718 | =back |
d516a115 | 10719 | |
35c7d401 | 10720 | =item EXAMPLES |
193fb0af | 10721 | |
ee382f2f | 10722 | =item DIAGNOSTICS |
193fb0af | 10723 | |
ee382f2f JH |
10724 | C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s |
10725 | attributes>, C<Declaration of %s attribute in package %s may clash with | |
10726 | future reserved word>, C<Can't have two ATTR specifiers on one subroutine>, | |
10727 | C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't | |
10728 | be able to apply END handler> | |
10729 | ||
10730 | =item AUTHOR | |
10731 | ||
10732 | =item BUGS | |
10733 | ||
10734 | =item COPYRIGHT | |
193fb0af | 10735 | |
a45bd81d GS |
10736 | =back |
10737 | ||
ee382f2f | 10738 | =head2 AutoLoader - load subroutines only on demand |
193fb0af | 10739 | |
d420ca49 | 10740 | =over 4 |
a45bd81d | 10741 | |
193fb0af GS |
10742 | =item SYNOPSIS |
10743 | ||
10744 | =item DESCRIPTION | |
10745 | ||
ee382f2f | 10746 | =over 4 |
193fb0af | 10747 | |
ee382f2f JH |
10748 | =item Subroutine Stubs |
10749 | ||
10750 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
10751 | ||
10752 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine | |
10753 | ||
10754 | =item Package Lexicals | |
10755 | ||
10756 | =item Not Using AutoLoader | |
10757 | ||
10758 | =item B<AutoLoader> vs. B<SelfLoader> | |
10759 | ||
10760 | =back | |
10761 | ||
10762 | =item CAVEATS | |
10763 | ||
10764 | =item SEE ALSO | |
10765 | ||
10766 | =back | |
10767 | ||
10768 | =head2 AutoSplit - split a package for autoloading | |
10769 | ||
10770 | =over 4 | |
10771 | ||
10772 | =item SYNOPSIS | |
10773 | ||
10774 | =item DESCRIPTION | |
10775 | ||
10776 | $keep, $check, $modtime | |
10777 | ||
10778 | =over 4 | |
10779 | ||
10780 | =item Multiple packages | |
10781 | ||
10782 | =back | |
10783 | ||
10784 | =item DIAGNOSTICS | |
10785 | ||
10786 | =back | |
10787 | ||
10788 | =head2 B - The Perl Compiler | |
10789 | ||
10790 | =over 4 | |
10791 | ||
10792 | =item SYNOPSIS | |
10793 | ||
10794 | =item DESCRIPTION | |
10795 | ||
10796 | =item OVERVIEW | |
10797 | ||
10798 | =item Utility Functions | |
10799 | ||
10800 | =over 4 | |
10801 | ||
10802 | =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV> | |
10803 | objects | |
10804 | ||
6e76d345 JH |
10805 | sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av, |
10806 | check_av, begin_av, end_av, comppadlist, regex_padav, main_cv | |
ee382f2f JH |
10807 | |
10808 | =item Functions for Examining the Symbol Table | |
10809 | ||
10810 | walksymtable(SYMREF, METHOD, RECURSE, PREFIX) | |
10811 | ||
10812 | =item Functions Returning C<B::OP> objects or for walking op trees | |
10813 | ||
10814 | main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG) | |
10815 | ||
10816 | =item Miscellaneous Utility Functions | |
10817 | ||
10818 | ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), | |
10819 | perlstring(STR), class(OBJ), threadsv_names | |
10820 | ||
10821 | =back | |
10822 | ||
10823 | =item OVERVIEW OF CLASSES | |
10824 | ||
10825 | =over 4 | |
10826 | ||
10827 | =item SV-RELATED CLASSES | |
10828 | ||
10829 | =item B::SV Methods | |
10830 | ||
73fba812 | 10831 | REFCNT, FLAGS, object_2svref |
ee382f2f JH |
10832 | |
10833 | =item B::IV Methods | |
10834 | ||
10835 | IV, IVX, UVX, int_value, needs64bits, packiv | |
10836 | ||
10837 | =item B::NV Methods | |
10838 | ||
10839 | NV, NVX | |
10840 | ||
10841 | =item B::RV Methods | |
10842 | ||
10843 | RV | |
10844 | ||
10845 | =item B::PV Methods | |
10846 | ||
10847 | PV, RV, PVX | |
10848 | ||
10849 | =item B::PVMG Methods | |
10850 | ||
10851 | MAGIC, SvSTASH | |
10852 | ||
10853 | =item B::MAGIC Methods | |
10854 | ||
10855 | MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX | |
10856 | ||
10857 | =item B::PVLV Methods | |
10858 | ||
10859 | TARGOFF, TARGLEN, TYPE, TARG | |
10860 | ||
10861 | =item B::BM Methods | |
10862 | ||
10863 | USEFUL, PREVIOUS, RARE, TABLE | |
10864 | ||
10865 | =item B::GV Methods | |
10866 | ||
10867 | is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, | |
10868 | LINE, FILE, FILEGV, GvREFCNT, FLAGS | |
10869 | ||
10870 | =item B::IO Methods | |
10871 | ||
10872 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, | |
10873 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD | |
10874 | ||
10875 | =item B::AV Methods | |
10876 | ||
73fba812 | 10877 | FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS |
ee382f2f JH |
10878 | |
10879 | =item B::CV Methods | |
10880 | ||
10881 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB, | |
10882 | XSUBANY, CvFLAGS, const_sv | |
10883 | ||
10884 | =item B::HV Methods | |
10885 | ||
10886 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY | |
10887 | ||
10888 | =item OP-RELATED CLASSES | |
10889 | ||
10890 | =item B::OP Methods | |
10891 | ||
a2db77eb NC |
10892 | next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private, |
10893 | spare | |
ee382f2f JH |
10894 | |
10895 | =item B::UNOP METHOD | |
10896 | ||
10897 | first | |
10898 | ||
10899 | =item B::BINOP METHOD | |
10900 | ||
10901 | last | |
10902 | ||
10903 | =item B::LOGOP METHOD | |
10904 | ||
10905 | other | |
10906 | ||
10907 | =item B::LISTOP METHOD | |
10908 | ||
10909 | children | |
10910 | ||
10911 | =item B::PMOP Methods | |
10912 | ||
10913 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags, | |
6e76d345 | 10914 | pmpermflags, precomp, pmoffset |
ee382f2f JH |
10915 | |
10916 | =item B::SVOP METHOD | |
10917 | ||
10918 | sv, gv | |
10919 | ||
10920 | =item B::PADOP METHOD | |
10921 | ||
10922 | padix | |
10923 | ||
10924 | =item B::PVOP METHOD | |
10925 | ||
10926 | pv | |
10927 | ||
10928 | =item B::LOOP Methods | |
10929 | ||
10930 | redoop, nextop, lastop | |
10931 | ||
10932 | =item B::COP Methods | |
10933 | ||
10934 | label, stash, stashpv, file, cop_seq, arybase, line, warnings, io | |
10935 | ||
10936 | =back | |
10937 | ||
10938 | =item AUTHOR | |
10939 | ||
10940 | =back | |
10941 | ||
10942 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate | |
10943 | bytecode | |
10944 | ||
10945 | =over 4 | |
10946 | ||
10947 | =item SYNOPSIS | |
10948 | ||
10949 | =item DESCRIPTION | |
10950 | ||
10951 | %insn_data, @insn_name, @optype, @specialsv_name | |
10952 | ||
10953 | =item AUTHOR | |
10954 | ||
10955 | =back | |
10956 | ||
10957 | =head2 B::Assembler - Assemble Perl bytecode | |
10958 | ||
10959 | =over 4 | |
10960 | ||
10961 | =item SYNOPSIS | |
10962 | ||
10963 | =item DESCRIPTION | |
10964 | ||
10965 | =item AUTHORS | |
10966 | ||
10967 | =back | |
10968 | ||
10969 | =head2 B::Bblock - Walk basic blocks | |
10970 | ||
10971 | =over 4 | |
10972 | ||
10973 | =item SYNOPSIS | |
10974 | ||
10975 | =item DESCRIPTION | |
10976 | ||
10977 | =over 4 | |
10978 | ||
10979 | =item Functions | |
10980 | ||
10981 | B<find_leaders> | |
10982 | ||
10983 | =back | |
10984 | ||
10985 | =item AUTHOR | |
10986 | ||
10987 | =back | |
10988 | ||
10989 | =head2 B::Bytecode - Perl compiler's bytecode backend | |
10990 | ||
10991 | =over 4 | |
10992 | ||
10993 | =item SYNOPSIS | |
10994 | ||
10995 | =item DESCRIPTION | |
10996 | ||
73fba812 JH |
10997 | =item EXAMPLE |
10998 | ||
ee382f2f JH |
10999 | =item OPTIONS |
11000 | ||
73fba812 | 11001 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> |
ee382f2f | 11002 | |
73fba812 | 11003 | =item KNOWN BUGS |
ee382f2f | 11004 | |
73fba812 | 11005 | =item NOTICE |
ee382f2f JH |
11006 | |
11007 | =item AUTHORS | |
11008 | ||
11009 | =back | |
11010 | ||
11011 | =head2 B::C - Perl compiler's C backend | |
11012 | ||
11013 | =over 4 | |
11014 | ||
11015 | =item SYNOPSIS | |
11016 | ||
11017 | =item DESCRIPTION | |
11018 | ||
11019 | =item OPTIONS | |
11020 | ||
11021 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
11022 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>, | |
11023 | B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>, | |
11024 | B<-llimit> | |
11025 | ||
11026 | =item EXAMPLES | |
11027 | ||
11028 | =item BUGS | |
11029 | ||
11030 | =item AUTHOR | |
11031 | ||
11032 | =back | |
11033 | ||
11034 | =head2 B::CC - Perl compiler's optimized C translation backend | |
11035 | ||
11036 | =over 4 | |
11037 | ||
11038 | =item SYNOPSIS | |
11039 | ||
11040 | =item DESCRIPTION | |
11041 | ||
11042 | =item OPTIONS | |
11043 | ||
11044 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
11045 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
11046 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
11047 | ||
11048 | =item EXAMPLES | |
11049 | ||
11050 | =item BUGS | |
11051 | ||
11052 | =item DIFFERENCES | |
11053 | ||
11054 | =over 4 | |
11055 | ||
11056 | =item Loops | |
11057 | ||
11058 | =item Context of ".." | |
11059 | ||
11060 | =item Arithmetic | |
11061 | ||
11062 | =item Deprecated features | |
11063 | ||
11064 | =back | |
11065 | ||
11066 | =item AUTHOR | |
11067 | ||
11068 | =back | |
11069 | ||
11070 | =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops | |
11071 | ||
11072 | =over 4 | |
11073 | ||
11074 | =item SYNOPSIS | |
11075 | ||
11076 | =item DESCRIPTION | |
11077 | ||
11078 | =item EXAMPLE | |
11079 | ||
11080 | =item OPTIONS | |
11081 | ||
d3ca9f77 NC |
11082 | =over 4 |
11083 | ||
11084 | =item Options for Opcode Ordering | |
11085 | ||
11086 | B<-basic>, B<-exec>, B<-tree> | |
11087 | ||
11088 | =item Options for Line-Style | |
11089 | ||
11090 | B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env> | |
11091 | ||
11092 | =item Options for tree-specific formatting | |
11093 | ||
11094 | B<-compact>, B<-loose>, B<-vt>, B<-ascii> | |
11095 | ||
11096 | =item Options controlling sequence numbering | |
11097 | ||
11098 | B<-base>I<n>, B<-bigendian>, B<-littleendian> | |
11099 | ||
11100 | =item Other options | |
11101 | ||
a2db77eb | 11102 | B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref |
d3ca9f77 NC |
11103 | |
11104 | =item Option Stickiness | |
11105 | ||
11106 | =back | |
ee382f2f | 11107 | |
a2db77eb NC |
11108 | =item ABBREVIATIONS |
11109 | ||
11110 | =over 4 | |
11111 | ||
11112 | =item OP class abbreviations | |
11113 | ||
11114 | =item OP flags abbreviations | |
11115 | ||
11116 | =back | |
11117 | ||
ee382f2f JH |
11118 | =item FORMATTING SPECIFICATIONS |
11119 | ||
a2db77eb NC |
11120 | =over 4 |
11121 | ||
11122 | =item Special Patterns | |
11123 | ||
ee382f2f JH |
11124 | B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>, |
11125 | B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>, | |
a2db77eb NC |
11126 | B<~> |
11127 | ||
11128 | =item # Variables | |
11129 | ||
11130 | B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>, | |
ee382f2f JH |
11131 | B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, |
11132 | B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, | |
11133 | B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, | |
a2db77eb NC |
11134 | B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, |
11135 | B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> | |
ee382f2f JH |
11136 | |
11137 | =back | |
11138 | ||
11139 | =item Using B::Concise outside of the O framework | |
11140 | ||
7f106169 NC |
11141 | =over 4 |
11142 | ||
d3ca9f77 | 11143 | =item Example: Altering Concise Renderings |
7f106169 NC |
11144 | |
11145 | =item set_style() | |
11146 | ||
7f106169 NC |
11147 | =item set_style_standard($name) |
11148 | ||
d3ca9f77 NC |
11149 | =item add_style() |
11150 | ||
7f106169 NC |
11151 | =item add_callback() |
11152 | ||
d3ca9f77 | 11153 | =item Running B::Concise::compile() |
7f106169 NC |
11154 | |
11155 | =item B::Concise::reset_sequence() | |
11156 | ||
11157 | =item Errors | |
11158 | ||
11159 | =back | |
11160 | ||
ee382f2f JH |
11161 | =item AUTHOR |
11162 | ||
11163 | =back | |
11164 | ||
11165 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops | |
11166 | ||
11167 | =over 4 | |
11168 | ||
11169 | =item SYNOPSIS | |
11170 | ||
11171 | =item DESCRIPTION | |
11172 | ||
11173 | =item AUTHOR | |
11174 | ||
11175 | =back | |
11176 | ||
11177 | =head2 B::Deparse - Perl compiler backend to produce perl code | |
11178 | ||
11179 | =over 4 | |
11180 | ||
11181 | =item SYNOPSIS | |
11182 | ||
11183 | =item DESCRIPTION | |
11184 | ||
11185 | =item OPTIONS | |
11186 | ||
73fba812 | 11187 | B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>, |
ee382f2f JH |
11188 | B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL> |
11189 | ||
11190 | =item USING B::Deparse AS A MODULE | |
11191 | ||
11192 | =over 4 | |
11193 | ||
11194 | =item Synopsis | |
11195 | ||
11196 | =item Description | |
11197 | ||
11198 | =item new | |
11199 | ||
11200 | =item ambient_pragmas | |
11201 | ||
11202 | strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits | |
11203 | ||
11204 | =item coderef2text | |
11205 | ||
11206 | =back | |
11207 | ||
11208 | =item BUGS | |
11209 | ||
11210 | =item AUTHOR | |
11211 | ||
11212 | =back | |
11213 | ||
11214 | =head2 B::Disassembler - Disassemble Perl bytecode | |
11215 | ||
11216 | =over 4 | |
11217 | ||
11218 | =item SYNOPSIS | |
11219 | ||
11220 | =item DESCRIPTION | |
11221 | ||
11222 | =item AUTHOR | |
11223 | ||
11224 | =back | |
11225 | ||
11226 | =head2 B::Lint - Perl lint | |
11227 | ||
11228 | =over 4 | |
11229 | ||
11230 | =item SYNOPSIS | |
11231 | ||
11232 | =item DESCRIPTION | |
11233 | ||
11234 | =item OPTIONS AND LINT CHECKS | |
11235 | ||
11236 | B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>, | |
11237 | B<dollar-underscore>, B<private-names>, B<undefined-subs>, | |
11238 | B<regexp-variables>, B<all>, B<none> | |
11239 | ||
11240 | =item NON LINT-CHECK OPTIONS | |
11241 | ||
11242 | B<-u Package> | |
11243 | ||
11244 | =item BUGS | |
11245 | ||
11246 | =item AUTHOR | |
11247 | ||
11248 | =back | |
11249 | ||
11250 | =head2 B::O, O - Generic interface to Perl Compiler backends | |
11251 | ||
11252 | =over 4 | |
11253 | ||
11254 | =item SYNOPSIS | |
11255 | ||
11256 | =item DESCRIPTION | |
11257 | ||
11258 | =item CONVENTIONS | |
11259 | ||
11260 | =item IMPLEMENTATION | |
11261 | ||
11262 | =item BUGS | |
11263 | ||
11264 | =item AUTHOR | |
11265 | ||
11266 | =back | |
11267 | ||
11268 | =head2 B::Showlex - Show lexical variables used in functions or files | |
11269 | ||
11270 | =over 4 | |
11271 | ||
11272 | =item SYNOPSIS | |
11273 | ||
11274 | =item DESCRIPTION | |
11275 | ||
a2db77eb NC |
11276 | =item EXAMPLES |
11277 | ||
11278 | =over 4 | |
11279 | ||
11280 | =item OPTIONS | |
11281 | ||
11282 | =back | |
11283 | ||
11284 | =item SEE ALSO | |
11285 | ||
11286 | =item TODO | |
11287 | ||
ee382f2f JH |
11288 | =item AUTHOR |
11289 | ||
11290 | =back | |
11291 | ||
11292 | =head2 B::Stackobj - Helper module for CC backend | |
11293 | ||
11294 | =over 4 | |
11295 | ||
11296 | =item SYNOPSIS | |
11297 | ||
11298 | =item DESCRIPTION | |
11299 | ||
11300 | =item AUTHOR | |
11301 | ||
11302 | =back | |
11303 | ||
11304 | =head2 B::Stash - show what stashes are loaded | |
11305 | ||
11306 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops | |
11307 | ||
11308 | =over 4 | |
11309 | ||
11310 | =item SYNOPSIS | |
11311 | ||
11312 | =item DESCRIPTION | |
11313 | ||
11314 | =item AUTHOR | |
11315 | ||
11316 | =back | |
11317 | ||
11318 | =head2 B::Xref - Generates cross reference reports for Perl programs | |
11319 | ||
11320 | =over 4 | |
11321 | ||
11322 | =item SYNOPSIS | |
11323 | ||
11324 | =item DESCRIPTION | |
11325 | ||
11326 | =item OPTIONS | |
11327 | ||
11328 | C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> | |
11329 | ||
11330 | =item BUGS | |
11331 | ||
11332 | =item AUTHOR | |
11333 | ||
11334 | =back | |
11335 | ||
11336 | =head2 Bblock, B::Bblock - Walk basic blocks | |
11337 | ||
11338 | =over 4 | |
11339 | ||
11340 | =item SYNOPSIS | |
11341 | ||
11342 | =item DESCRIPTION | |
11343 | ||
11344 | =over 4 | |
11345 | ||
11346 | =item Functions | |
11347 | ||
11348 | B<find_leaders> | |
11349 | ||
11350 | =back | |
11351 | ||
11352 | =item AUTHOR | |
11353 | ||
11354 | =back | |
11355 | ||
11356 | =head2 Benchmark - benchmark running times of Perl code | |
11357 | ||
11358 | =over 4 | |
11359 | ||
11360 | =item SYNOPSIS | |
11361 | ||
11362 | =item DESCRIPTION | |
11363 | ||
11364 | =over 4 | |
11365 | ||
11366 | =item Methods | |
11367 | ||
11368 | new, debug, iters | |
11369 | ||
11370 | =item Standard Exports | |
11371 | ||
11372 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
11373 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( | |
11374 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
11375 | ||
11376 | =item Optional Exports | |
11377 | ||
11378 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [ | |
11379 | STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE), | |
11380 | disablecache ( ), enablecache ( ), timesum ( T1, T2 ) | |
11381 | ||
11382 | =item :hireswallclock | |
11383 | ||
11384 | =back | |
11385 | ||
11386 | =item NOTES | |
11387 | ||
11388 | =item EXAMPLES | |
11389 | ||
11390 | =item INHERITANCE | |
11391 | ||
11392 | =item CAVEATS | |
11393 | ||
11394 | =item SEE ALSO | |
11395 | ||
11396 | =item AUTHORS | |
11397 | ||
11398 | =item MODIFICATION HISTORY | |
11399 | ||
11400 | =back | |
11401 | ||
742c3d28 JH |
11402 | =head2 ByteLoader - load byte compiled perl code |
11403 | ||
11404 | =over 4 | |
11405 | ||
11406 | =item SYNOPSIS | |
11407 | ||
11408 | =item DESCRIPTION | |
11409 | ||
11410 | =item AUTHOR | |
11411 | ||
11412 | =item SEE ALSO | |
11413 | ||
11414 | =back | |
11415 | ||
ee382f2f JH |
11416 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend |
11417 | ||
11418 | =over 4 | |
11419 | ||
11420 | =item SYNOPSIS | |
11421 | ||
11422 | =item DESCRIPTION | |
11423 | ||
73fba812 JH |
11424 | =item EXAMPLE |
11425 | ||
ee382f2f JH |
11426 | =item OPTIONS |
11427 | ||
73fba812 | 11428 | B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s> |
ee382f2f | 11429 | |
73fba812 | 11430 | =item KNOWN BUGS |
ee382f2f | 11431 | |
73fba812 | 11432 | =item NOTICE |
ee382f2f JH |
11433 | |
11434 | =item AUTHORS | |
11435 | ||
11436 | =back | |
11437 | ||
11438 | =head2 CGI - Simple Common Gateway Interface Class | |
11439 | ||
11440 | =over 4 | |
11441 | ||
11442 | =item SYNOPSIS | |
11443 | ||
11444 | =item ABSTRACT | |
11445 | ||
11446 | =item DESCRIPTION | |
11447 | ||
11448 | =over 4 | |
11449 | ||
11450 | =item PROGRAMMING STYLE | |
11451 | ||
11452 | =item CALLING CGI.PM ROUTINES | |
11453 | ||
11454 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): | |
11455 | ||
11456 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
11457 | ||
11458 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
11459 | ||
11460 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
11461 | ||
11462 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
11463 | ||
11464 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
11465 | ||
11466 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
11467 | ||
11468 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
11469 | ||
11470 | =item DELETING A PARAMETER COMPLETELY: | |
11471 | ||
11472 | =item DELETING ALL PARAMETERS: | |
11473 | ||
b40eed9c NC |
11474 | =item HANDLING NON-URLENCODED ARGUMENTS |
11475 | ||
ee382f2f JH |
11476 | =item DIRECT ACCESS TO THE PARAMETER LIST: |
11477 | ||
11478 | =item FETCHING THE PARAMETER LIST AS A HASH: | |
11479 | ||
11480 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: | |
11481 | ||
11482 | =item RETRIEVING CGI ERRORS | |
11483 | ||
11484 | =item USING THE FUNCTION-ORIENTED INTERFACE | |
11485 | ||
11486 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>, | |
11487 | B<:standard>, B<:all> | |
11488 | ||
11489 | =item PRAGMAS | |
11490 | ||
b40eed9c | 11491 | -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph, |
ee382f2f JH |
11492 | -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, |
11493 | -private_tempfiles | |
11494 | ||
11495 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS | |
11496 | ||
11497 | 1. start_table() (generates a <table> tag), 2. end_table() (generates a | |
11498 | </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates | |
11499 | a </ul> tag) | |
11500 | ||
11501 | =back | |
11502 | ||
11503 | =item GENERATING DYNAMIC DOCUMENTS | |
11504 | ||
11505 | =over 4 | |
11506 | ||
11507 | =item CREATING A STANDARD HTTP HEADER: | |
11508 | ||
11509 | =item GENERATING A REDIRECTION HEADER | |
11510 | ||
11511 | =item CREATING THE HTML DOCUMENT HEADER | |
11512 | ||
11513 | B<Parameters:>, 4, 5, 6.. | |
11514 | ||
11515 | =item ENDING THE HTML DOCUMENT: | |
11516 | ||
11517 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
11518 | ||
11519 | =item OBTAINING THE SCRIPT'S URL | |
11520 | ||
11521 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
b40eed9c | 11522 | (B<-query_string>), B<-base>, B<-rewrite> |
ee382f2f JH |
11523 | |
11524 | =item MIXING POST AND URL PARAMETERS | |
11525 | ||
11526 | =back | |
11527 | ||
11528 | =item CREATING STANDARD HTML ELEMENTS: | |
11529 | ||
11530 | =over 4 | |
11531 | ||
11532 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
11533 | ||
11534 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
11535 | ||
11536 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
11537 | ||
11538 | =item NON-STANDARD HTML SHORTCUTS | |
11539 | ||
11540 | =item AUTOESCAPING HTML | |
11541 | ||
11542 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
11543 | charset([$charset]);, $flag = autoEscape([$flag]); | |
11544 | ||
11545 | =item PRETTY-PRINTING HTML | |
11546 | ||
11547 | =back | |
11548 | ||
11549 | =item CREATING FILL-OUT FORMS: | |
11550 | ||
11551 | =over 4 | |
11552 | ||
11553 | =item CREATING AN ISINDEX TAG | |
11554 | ||
11555 | =item STARTING AND ENDING A FORM | |
11556 | ||
11557 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
11558 | ||
b2a9ae16 NC |
11559 | =item FORM ELEMENTS |
11560 | ||
11561 | B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>, | |
11562 | B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>, | |
11563 | B<-onSelect> | |
11564 | ||
ee382f2f JH |
11565 | =item CREATING A TEXT FIELD |
11566 | ||
11567 | B<Parameters> | |
11568 | ||
11569 | =item CREATING A BIG TEXT FIELD | |
11570 | ||
11571 | =item CREATING A PASSWORD FIELD | |
11572 | ||
11573 | =item CREATING A FILE UPLOAD FIELD | |
11574 | ||
11575 | B<Parameters> | |
11576 | ||
11577 | =item CREATING A POPUP MENU | |
11578 | ||
11579 | =item CREATING AN OPTION GROUP | |
11580 | ||
11581 | =item CREATING A SCROLLING LIST | |
11582 | ||
11583 | B<Parameters:> | |
11584 | ||
11585 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
11586 | ||
11587 | B<Parameters:> | |
11588 | ||
11589 | =item CREATING A STANDALONE CHECKBOX | |
11590 | ||
11591 | B<Parameters:> | |
11592 | ||
11593 | =item CREATING A RADIO BUTTON GROUP | |
11594 | ||
11595 | B<Parameters:> | |
11596 | ||
11597 | =item CREATING A SUBMIT BUTTON | |
11598 | ||
11599 | B<Parameters:> | |
11600 | ||
11601 | =item CREATING A RESET BUTTON | |
11602 | ||
11603 | =item CREATING A DEFAULT BUTTON | |
11604 | ||
11605 | =item CREATING A HIDDEN FIELD | |
11606 | ||
11607 | B<Parameters:> | |
11608 | ||
11609 | =item CREATING A CLICKABLE IMAGE BUTTON | |
11610 | ||
6e76d345 JH |
11611 | B<Parameters:>, 3. The third option (-align, optional) is an alignment |
11612 | type, and may be TOP, BOTTOM or MIDDLE | |
ee382f2f JH |
11613 | |
11614 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
11615 | ||
11616 | =back | |
11617 | ||
11618 | =item HTTP COOKIES | |
11619 | ||
11620 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
11621 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
11622 | ||
11623 | =item WORKING WITH FRAMES | |
11624 | ||
11625 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
11626 | document in the HTTP header, 3. Specify the destination for the document in | |
11627 | the <form> tag | |
11628 | ||
b2a9ae16 NC |
11629 | =item SUPPORT FOR JAVASCRIPT |
11630 | ||
11631 | B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>, | |
11632 | B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut> | |
11633 | ||
ee382f2f JH |
11634 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
11635 | ||
11636 | =item DEBUGGING | |
11637 | ||
11638 | =over 4 | |
11639 | ||
11640 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
11641 | ||
11642 | =back | |
11643 | ||
11644 | =item FETCHING ENVIRONMENT VARIABLES | |
11645 | ||
11646 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, | |
73fba812 JH |
11647 | B<path_translated()>, B<remote_host()>, B<script_name()> Return the script |
11648 | name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type | |
11649 | ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, | |
4c64e75b NC |
11650 | B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name |
11651 | ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
ee382f2f JH |
11652 | |
11653 | =item USING NPH SCRIPTS | |
11654 | ||
11655 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> | |
11656 | parameters | |
11657 | ||
11658 | =item Server Push | |
11659 | ||
11660 | multipart_init(), multipart_start(), multipart_end(), multipart_final() | |
11661 | ||
11662 | =item Avoiding Denial of Service Attacks | |
11663 | ||
11664 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script | |
11665 | basis>, B<2. Globally for all scripts> | |
11666 | ||
11667 | =item COMPATIBILITY WITH CGI-LIB.PL | |
11668 | ||
11669 | =item AUTHOR INFORMATION | |
11670 | ||
11671 | =item CREDITS | |
11672 | ||
11673 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
11674 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
11675 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
11676 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick | |
11677 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
11678 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
11679 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
11680 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
11681 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
11682 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
11683 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
11684 | ...and many many more.. | |
11685 | ||
11686 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
11687 | ||
11688 | =item BUGS | |
11689 | ||
11690 | =item SEE ALSO | |
11691 | ||
11692 | =back | |
11693 | ||
11694 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
11695 | ||
11696 | =over 4 | |
11697 | ||
11698 | =item SYNOPSIS | |
11699 | ||
11700 | =item ABSTRACT | |
11701 | ||
11702 | =item DESCRIPTION | |
11703 | ||
11704 | =item AUTHOR INFORMATION | |
11705 | ||
11706 | =item BUGS | |
11707 | ||
11708 | =item SEE ALSO | |
11709 | ||
11710 | =back | |
11711 | ||
11712 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
11713 | other) error log | |
11714 | ||
11715 | =over 4 | |
11716 | ||
11717 | =item SYNOPSIS | |
11718 | ||
11719 | =item DESCRIPTION | |
11720 | ||
11721 | =item REDIRECTING ERROR MESSAGES | |
11722 | ||
11723 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
11724 | ||
11725 | =over 4 | |
11726 | ||
11727 | =item Changing the default message | |
11728 | ||
11729 | =back | |
11730 | ||
11731 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS | |
11732 | ||
11733 | =item OVERRIDING THE NAME OF THE PROGRAM | |
11734 | ||
11735 | =item AUTHORS | |
11736 | ||
11737 | =item SEE ALSO | |
11738 | ||
11739 | =back | |
11740 | ||
11741 | =head2 CGI::Cookie - Interface to Netscape Cookies | |
11742 | ||
11743 | =over 4 | |
11744 | ||
11745 | =item SYNOPSIS | |
11746 | ||
11747 | =item DESCRIPTION | |
11748 | ||
11749 | =item USING CGI::Cookie | |
11750 | ||
11751 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
11752 | ||
11753 | =over 4 | |
11754 | ||
11755 | =item Creating New Cookies | |
11756 | ||
11757 | =item Sending the Cookie to the Browser | |
11758 | ||
11759 | =item Recovering Previous Cookies | |
11760 | ||
11761 | =item Manipulating Cookies | |
11762 | ||
11763 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
11764 | ||
11765 | =back | |
11766 | ||
11767 | =item AUTHOR INFORMATION | |
11768 | ||
11769 | =item BUGS | |
11770 | ||
11771 | =item SEE ALSO | |
11772 | ||
11773 | =back | |
11774 | ||
11775 | =head2 CGI::Fast - CGI Interface for Fast CGI | |
11776 | ||
11777 | =over 4 | |
11778 | ||
11779 | =item SYNOPSIS | |
11780 | ||
11781 | =item DESCRIPTION | |
11782 | ||
11783 | =item OTHER PIECES OF THE PUZZLE | |
11784 | ||
11785 | =item WRITING FASTCGI PERL SCRIPTS | |
11786 | ||
11787 | =item INSTALLING FASTCGI SCRIPTS | |
11788 | ||
11789 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
11790 | ||
11791 | =item EXTERNAL FASTCGI SERVER INVOCATION | |
11792 | ||
11793 | FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE | |
11794 | ||
11795 | =item CAVEATS | |
11796 | ||
11797 | =item AUTHOR INFORMATION | |
11798 | ||
11799 | =item BUGS | |
11800 | ||
11801 | =item SEE ALSO | |
11802 | ||
11803 | =back | |
11804 | ||
11805 | =head2 CGI::Pretty - module to produce nicely formatted HTML code | |
11806 | ||
11807 | =over 4 | |
11808 | ||
11809 | =item SYNOPSIS | |
11810 | ||
11811 | =item DESCRIPTION | |
11812 | ||
11813 | =over 4 | |
11814 | ||
11815 | =item Tags that won't be formatted | |
11816 | ||
11817 | =item Customizing the Indenting | |
11818 | ||
11819 | =back | |
11820 | ||
11821 | =item BUGS | |
11822 | ||
11823 | =item AUTHOR | |
11824 | ||
11825 | =item SEE ALSO | |
11826 | ||
11827 | =back | |
11828 | ||
11829 | =head2 CGI::Push - Simple Interface to Server Push | |
11830 | ||
11831 | =over 4 | |
11832 | ||
11833 | =item SYNOPSIS | |
11834 | ||
11835 | =item DESCRIPTION | |
11836 | ||
11837 | =item USING CGI::Push | |
11838 | ||
11839 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph | |
11840 | ||
11841 | =over 4 | |
11842 | ||
11843 | =item Heterogeneous Pages | |
11844 | ||
11845 | =item Changing the Page Delay on the Fly | |
11846 | ||
11847 | =back | |
11848 | ||
11849 | =item INSTALLING CGI::Push SCRIPTS | |
11850 | ||
11851 | =item AUTHOR INFORMATION | |
11852 | ||
11853 | =item BUGS | |
11854 | ||
11855 | =item SEE ALSO | |
11856 | ||
11857 | =back | |
11858 | ||
11859 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
11860 | ||
11861 | =over 4 | |
11862 | ||
11863 | =item SYNOPSIS | |
11864 | ||
11865 | =item ABSTRACT | |
11866 | ||
11867 | =item DESCRIPTION | |
11868 | ||
11869 | =item AUTHOR INFORMATION | |
11870 | ||
11871 | =item BUGS | |
11872 | ||
11873 | =item SEE ALSO | |
11874 | ||
11875 | =back | |
11876 | ||
11877 | =head2 CGI::Util - Internal utilities used by CGI module | |
11878 | ||
11879 | =over 4 | |
11880 | ||
11881 | =item SYNOPSIS | |
11882 | ||
11883 | =item DESCRIPTION | |
11884 | ||
11885 | =item AUTHOR INFORMATION | |
11886 | ||
11887 | =item SEE ALSO | |
11888 | ||
11889 | =back | |
11890 | ||
11891 | =head2 CPAN - query, download and build perl modules from CPAN sites | |
11892 | ||
11893 | =over 4 | |
11894 | ||
11895 | =item SYNOPSIS | |
11896 | ||
11897 | =item STATUS | |
11898 | ||
11899 | =item DESCRIPTION | |
11900 | ||
11901 | =over 4 | |
11902 | ||
11903 | =item Interactive Mode | |
11904 | ||
11905 | Searching for authors, bundles, distribution files and modules, make, test, | |
b40eed9c NC |
11906 | install, clean modules or distributions, get, readme, perldoc, look module |
11907 | or distribution, ls author, ls globbing_expresion, Signals | |
ee382f2f JH |
11908 | |
11909 | =item CPAN::Shell | |
11910 | ||
11911 | =item autobundle | |
11912 | ||
11913 | =item recompile | |
11914 | ||
11915 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution | |
11916 | ||
11917 | =item Programmer's interface | |
11918 | ||
11919 | expand($type,@things), expandany(@things), Programming Examples | |
11920 | ||
11921 | =item Methods in the other Classes | |
11922 | ||
11923 | CPAN::Author::as_glimpse(), CPAN::Author::as_string(), | |
11924 | CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(), | |
11925 | CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(), | |
11926 | CPAN::Bundle::clean(), CPAN::Bundle::contains(), | |
11927 | CPAN::Bundle::force($method,@args), CPAN::Bundle::get(), | |
11928 | CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(), | |
11929 | CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(), | |
11930 | CPAN::Bundle::readme(), CPAN::Bundle::test(), | |
11931 | CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(), | |
11932 | CPAN::Distribution::clean(), CPAN::Distribution::containsmods(), | |
11933 | CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(), | |
11934 | CPAN::Distribution::force($method,@args), CPAN::Distribution::get(), | |
11935 | CPAN::Distribution::install(), CPAN::Distribution::isa_perl(), | |
11936 | CPAN::Distribution::look(), CPAN::Distribution::make(), | |
11937 | CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(), | |
b40eed9c NC |
11938 | CPAN::Distribution::perldoc(), CPAN::Distribution::test(), |
11939 | CPAN::Distribution::uptodate(), CPAN::Index::force_reload(), | |
11940 | CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(), | |
11941 | CPAN::Module::as_string(), CPAN::Module::clean(), | |
11942 | CPAN::Module::cpan_file(), CPAN::Module::cpan_version(), | |
11943 | CPAN::Module::cvs_import(), CPAN::Module::description(), | |
11944 | CPAN::Module::force($method,@args), CPAN::Module::get(), | |
11945 | CPAN::Module::inst_file(), CPAN::Module::inst_version(), | |
11946 | CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(), | |
ee382f2f | 11947 | CPAN::Module::manpage_headline(), CPAN::Module::readme(), |
b40eed9c NC |
11948 | CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(), |
11949 | CPAN::Module::userid() | |
ee382f2f JH |
11950 | |
11951 | =item Cache Manager | |
11952 | ||
11953 | =item Bundles | |
11954 | ||
11955 | =item Prerequisites | |
11956 | ||
11957 | =item Finding packages and VERSION | |
11958 | ||
11959 | =item Debugging | |
11960 | ||
11961 | =item Floppy, Zip, Offline Mode | |
11962 | ||
11963 | =back | |
11964 | ||
11965 | =item CONFIGURATION | |
11966 | ||
11967 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> | |
11968 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
11969 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
11970 | [unshift|push|splice] E<lt>listE<gt>> | |
11971 | ||
11972 | =over 4 | |
11973 | ||
11974 | =item Note on urllist parameter's format | |
11975 | ||
11976 | =item urllist parameter has CD-ROM support | |
11977 | ||
11978 | =back | |
11979 | ||
11980 | =item SECURITY | |
11981 | ||
b40eed9c NC |
11982 | =over 4 |
11983 | ||
11984 | =item Cryptographically signed modules | |
11985 | ||
11986 | =back | |
11987 | ||
ee382f2f JH |
11988 | =item EXPORT |
11989 | ||
11990 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES | |
11991 | ||
11992 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
11993 | ||
11994 | =over 4 | |
11995 | ||
11996 | =item Three basic types of firewalls | |
11997 | ||
11998 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade | |
11999 | ||
12000 | =item Configuring lynx or ncftp for going through a firewall | |
12001 | ||
12002 | =back | |
12003 | ||
12004 | =item FAQ | |
12005 | ||
b40eed9c | 12006 | 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11) |
ee382f2f JH |
12007 | |
12008 | =item BUGS | |
12009 | ||
12010 | =item AUTHOR | |
12011 | ||
12012 | =item TRANSLATIONS | |
12013 | ||
12014 | =item SEE ALSO | |
12015 | ||
12016 | =back | |
12017 | ||
12018 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization | |
12019 | ||
12020 | =over 4 | |
12021 | ||
12022 | =item SYNOPSIS | |
12023 | ||
12024 | =item DESCRIPTION | |
12025 | ||
12026 | =back | |
12027 | ||
b40eed9c NC |
12028 | =head2 CPAN::Version - utility functions to compare CPAN versions |
12029 | ||
12030 | =over 4 | |
12031 | ||
12032 | =item SYNOPSIS | |
12033 | ||
12034 | =item DESCRIPTION | |
12035 | ||
12036 | =back | |
12037 | ||
ee382f2f JH |
12038 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
12039 | module | |
12040 | ||
12041 | =over 4 | |
12042 | ||
12043 | =item SYNOPSIS | |
12044 | ||
12045 | =item DESCRIPTION | |
12046 | ||
12047 | =item SEE ALSO | |
12048 | ||
12049 | =back | |
12050 | ||
12051 | =head2 Carp, carp - warn of errors (from perspective of caller) | |
12052 | ||
12053 | =over 4 | |
12054 | ||
12055 | =item SYNOPSIS | |
12056 | ||
12057 | =item DESCRIPTION | |
12058 | ||
12059 | =over 4 | |
12060 | ||
12061 | =item Forcing a Stack Trace | |
12062 | ||
12063 | =back | |
12064 | ||
a2db77eb NC |
12065 | =back |
12066 | ||
12067 | =over 4 | |
12068 | ||
12069 | =item GLOBAL VARIABLES | |
12070 | ||
12071 | =over 4 | |
12072 | ||
12073 | =item $Carp::CarpLevel | |
12074 | ||
12075 | =item $Carp::MaxEvalLen | |
12076 | ||
12077 | =item $Carp::MaxArgLen | |
12078 | ||
12079 | =item $Carp::MaxArgNums | |
12080 | ||
12081 | =item $Carp::Verbose | |
12082 | ||
12083 | =back | |
12084 | ||
12085 | =back | |
12086 | ||
12087 | =over 4 | |
12088 | ||
ee382f2f JH |
12089 | =item BUGS |
12090 | ||
12091 | =back | |
12092 | ||
7f106169 | 12093 | =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside |
ee382f2f JH |
12094 | |
12095 | =head2 Class::ISA -- report the search path for a class's ISA tree | |
12096 | ||
12097 | =over 4 | |
12098 | ||
12099 | =item SYNOPSIS | |
12100 | ||
12101 | =item DESCRIPTION | |
12102 | ||
12103 | =item FUNCTIONS | |
12104 | ||
12105 | the function Class::ISA::super_path($CLASS), the function | |
12106 | Class::ISA::self_and_super_path($CLASS), the function | |
12107 | Class::ISA::self_and_super_versions($CLASS) | |
12108 | ||
12109 | =item CAUTIONARY NOTES | |
12110 | ||
12111 | =item COPYRIGHT | |
12112 | ||
12113 | =item AUTHOR | |
12114 | ||
12115 | =back | |
12116 | ||
12117 | =head2 Class::Struct - declare struct-like datatypes as Perl classes | |
12118 | ||
12119 | =over 4 | |
12120 | ||
12121 | =item SYNOPSIS | |
12122 | ||
12123 | =item DESCRIPTION | |
12124 | ||
12125 | =over 4 | |
12126 | ||
12127 | =item The C<struct()> function | |
12128 | ||
12129 | =item Class Creation at Compile Time | |
12130 | ||
12131 | =item Element Types and Accessor Methods | |
12132 | ||
12133 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
12134 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
12135 | ||
12136 | =item Initializing with C<new> | |
12137 | ||
12138 | =back | |
12139 | ||
12140 | =item EXAMPLES | |
12141 | ||
12142 | Example 1, Example 2, Example 3 | |
12143 | ||
12144 | =item Author and Modification History | |
12145 | ||
12146 | =back | |
12147 | ||
12148 | =head2 Config - access Perl configuration information | |
12149 | ||
12150 | =over 4 | |
12151 | ||
12152 | =item SYNOPSIS | |
12153 | ||
12154 | =item DESCRIPTION | |
12155 | ||
12156 | myconfig(), config_sh(), config_re($regex), config_vars(@names) | |
12157 | ||
12158 | =item EXAMPLE | |
12159 | ||
12160 | =item WARNING | |
12161 | ||
12162 | =item GLOSSARY | |
12163 | ||
12164 | =over 4 | |
12165 | ||
12166 | =item _ | |
12167 | ||
12168 | C<_a>, C<_exe>, C<_o> | |
12169 | ||
12170 | =item a | |
12171 | ||
12172 | C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>, | |
12173 | C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>, | |
12174 | C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, | |
12175 | C<asctime_r_proto>, C<awk> | |
12176 | ||
12177 | =item b | |
12178 | ||
12179 | C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder> | |
12180 | ||
12181 | =item c | |
12182 | ||
12183 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
12184 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, | |
12185 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
12186 | C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, | |
12187 | C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, | |
12188 | C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, | |
12189 | C<csh>, C<ctermid_r_proto>, C<ctime_r_proto> | |
12190 | ||
12191 | =item d | |
12192 | ||
12193 | C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>, | |
b40eed9c NC |
12194 | C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, |
12195 | C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>, | |
12196 | C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>, | |
12197 | C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>, | |
12198 | C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>, | |
12199 | C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>, | |
12200 | C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>, | |
12201 | C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>, | |
12202 | C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, | |
12203 | C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, | |
12204 | C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, | |
12205 | C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>, | |
12206 | C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>, | |
12207 | C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>, | |
12208 | C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, | |
12209 | C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, | |
12210 | C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, | |
12211 | C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, | |
12212 | C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, | |
12213 | C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, | |
12214 | C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>, | |
12215 | C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, | |
ee382f2f JH |
12216 | C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, |
12217 | C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>, | |
12218 | C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>, | |
12219 | C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, | |
12220 | C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, | |
12221 | C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>, | |
12222 | C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>, | |
12223 | C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, | |
12224 | C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>, | |
12225 | C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, | |
12226 | C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>, | |
12227 | C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>, | |
12228 | C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, | |
12229 | C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, | |
12230 | C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, | |
12231 | C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, | |
12232 | C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, | |
12233 | C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, | |
b40eed9c NC |
12234 | C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>, |
12235 | C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, | |
12236 | C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, | |
12237 | C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, | |
12238 | C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>, | |
12239 | C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, | |
12240 | C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, | |
12241 | C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nanosleep>, | |
12242 | C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, | |
12243 | C<d_nv_zero_is_allbits_zero>, C<d_off64_t>, | |
12244 | C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>, | |
12245 | C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>, | |
12246 | C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>, | |
12247 | C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>, | |
12248 | C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, | |
12249 | C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>, | |
12250 | C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, | |
12251 | C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, | |
12252 | C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>, | |
12253 | C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, | |
12254 | C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, | |
12255 | C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, | |
12256 | C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, | |
12257 | C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, | |
12258 | C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, | |
12259 | C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, | |
12260 | C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, | |
12261 | C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, | |
12262 | C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, | |
12263 | C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, | |
12264 | C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, | |
12265 | C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, | |
12266 | C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, | |
12267 | C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, | |
12268 | C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, | |
12269 | C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, | |
1184f6df JH |
12270 | C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, |
12271 | C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, | |
12272 | C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, | |
12273 | C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, | |
12274 | C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, | |
a563e516 NC |
12275 | C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, |
12276 | C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>, | |
12277 | C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, | |
12278 | C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>, | |
12279 | C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, | |
12280 | C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>, | |
12281 | C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, | |
12282 | C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>, | |
b40eed9c | 12283 | C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>, |
a563e516 NC |
12284 | C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, |
12285 | C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>, | |
12286 | C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, | |
12287 | C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, | |
12288 | C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>, | |
12289 | C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, | |
12290 | C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext> | |
ee382f2f JH |
12291 | |
12292 | =item e | |
12293 | ||
12294 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>, | |
12295 | C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>, | |
12296 | C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>, | |
12297 | C<expr>, C<extensions>, C<extras> | |
12298 | ||
12299 | =item f | |
12300 | ||
12301 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
12302 | C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>, | |
12303 | C<full_sed> | |
12304 | ||
12305 | =item g | |
12306 | ||
12307 | C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, | |
12308 | C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, | |
12309 | C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>, | |
12310 | C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>, | |
12311 | C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>, | |
12312 | C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>, | |
12313 | C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>, | |
12314 | C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>, | |
12315 | C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>, | |
12316 | C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> | |
12317 | ||
12318 | =item h | |
12319 | ||
12320 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>, | |
12321 | C<html3dir>, C<html3direxp> | |
12322 | ||
12323 | =item i | |
12324 | ||
12325 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, | |
12326 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>, | |
12327 | C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, | |
12328 | C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, | |
12329 | C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, | |
12330 | C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, | |
12331 | C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, | |
12332 | C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, | |
12333 | C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, | |
12334 | C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, | |
12335 | C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, | |
12336 | C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, | |
12337 | C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, | |
12338 | C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, | |
12339 | C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, | |
12340 | C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, | |
12341 | C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>, | |
12342 | C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>, | |
12343 | C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>, | |
12344 | C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>, | |
12345 | C<installprefixexp>, C<installprivlib>, C<installscript>, | |
742c3d28 JH |
12346 | C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>, |
12347 | C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>, | |
12348 | C<installsiteman3dir>, C<installsitescript>, C<installstyle>, | |
ee382f2f | 12349 | C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, |
742c3d28 JH |
12350 | C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>, |
12351 | C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>, | |
ee382f2f JH |
12352 | C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype> |
12353 | ||
12354 | =item k | |
12355 | ||
12356 | C<known_extensions>, C<ksh> | |
12357 | ||
12358 | =item l | |
12359 | ||
12360 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, | |
12361 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
12362 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
12363 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
12364 | C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>, | |
12365 | C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>, | |
12366 | C<lseektype> | |
12367 | ||
12368 | =item m | |
12369 | ||
12370 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
12371 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
12372 | C<man3direxp>, C<man3ext> | |
12373 | ||
12374 | =item M | |
12375 | ||
6e76d345 JH |
12376 | C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, |
12377 | C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, | |
12378 | C<myuname> | |
ee382f2f JH |
12379 | |
12380 | =item n | |
12381 | ||
12382 | C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>, | |
12383 | C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, | |
12384 | C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>, | |
12385 | C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>, | |
12386 | C<nvsize>, C<nvtype> | |
12387 | ||
12388 | =item o | |
12389 | ||
12390 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
12391 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> | |
12392 | ||
12393 | =item p | |
12394 | ||
12395 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, | |
6e76d345 | 12396 | C<perl>, C<perl_patchlevel> |
ee382f2f JH |
12397 | |
12398 | =item P | |
12399 | ||
12400 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
12401 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, | |
7f106169 NC |
12402 | C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, |
12403 | C<procselfexe>, C<prototype>, C<ptrsize> | |
ee382f2f JH |
12404 | |
12405 | =item q | |
12406 | ||
12407 | C<quadkind>, C<quadtype> | |
12408 | ||
12409 | =item r | |
12410 | ||
12411 | C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>, | |
12412 | C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>, | |
12413 | C<rmail>, C<run>, C<runnm> | |
12414 | ||
12415 | =item s | |
12416 | ||
12417 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
12418 | C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>, | |
12419 | C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>, | |
12420 | C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>, | |
12421 | C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, | |
12422 | C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, | |
12423 | C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, | |
742c3d28 JH |
12424 | C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>, |
12425 | C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, | |
12426 | C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>, | |
12427 | C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>, | |
12428 | C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, | |
12429 | C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, | |
12430 | C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, | |
12431 | C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, | |
12432 | C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>, | |
12433 | C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, | |
12434 | C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, | |
12435 | C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>, | |
12436 | C<submit>, C<subversion>, C<sysman> | |
ee382f2f JH |
12437 | |
12438 | =item t | |
12439 | ||
12440 | C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>, | |
12441 | C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>, | |
12442 | C<ttyname_r_proto> | |
12443 | ||
12444 | =item u | |
12445 | ||
12446 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, | |
12447 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
12448 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, | |
12449 | C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>, | |
a563e516 NC |
12450 | C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>, |
12451 | C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, | |
12452 | C<useperlio>, C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, | |
12453 | C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, | |
12454 | C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, | |
ee382f2f JH |
12455 | C<uvXUformat> |
12456 | ||
12457 | =item v | |
12458 | ||
12459 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, | |
742c3d28 JH |
12460 | C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>, |
12461 | C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, | |
12462 | C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>, | |
12463 | C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>, | |
12464 | C<vendorscriptexp>, C<version>, C<version_patchlevel_string>, | |
12465 | C<versiononly>, C<vi>, C<voidflags> | |
ee382f2f JH |
12466 | |
12467 | =item x | |
12468 | ||
7f106169 | 12469 | C<xlibpth> |
ee382f2f JH |
12470 | |
12471 | =item y | |
12472 | ||
6e76d345 | 12473 | C<yacc>, C<yaccflags> |
ee382f2f JH |
12474 | |
12475 | =item z | |
12476 | ||
12477 | C<zcat>, C<zip> | |
12478 | ||
12479 | =back | |
12480 | ||
12481 | =item NOTE | |
12482 | ||
12483 | =back | |
12484 | ||
12485 | =head2 Cwd - get pathname of current working directory | |
12486 | ||
12487 | =over 4 | |
12488 | ||
12489 | =item SYNOPSIS | |
12490 | ||
12491 | =item DESCRIPTION | |
12492 | ||
12493 | =over 4 | |
12494 | ||
12495 | =item getcwd and friends | |
12496 | ||
d3ca9f77 | 12497 | getcwd, cwd, fastcwd, fastgetcwd, getdcwd |
ee382f2f JH |
12498 | |
12499 | =item abs_path and friends | |
12500 | ||
12501 | abs_path, realpath, fast_abs_path | |
12502 | ||
12503 | =item $ENV{PWD} | |
12504 | ||
12505 | =back | |
12506 | ||
12507 | =item NOTES | |
12508 | ||
7f106169 NC |
12509 | =item AUTHOR |
12510 | ||
b2a9ae16 NC |
12511 | =item COPYRIGHT |
12512 | ||
ee382f2f JH |
12513 | =item SEE ALSO |
12514 | ||
12515 | =back | |
12516 | ||
12517 | =head2 DB - programmatic interface to the Perl debugging API (draft, | |
12518 | subject to | |
12519 | change) | |
12520 | ||
12521 | =over 4 | |
12522 | ||
12523 | =item SYNOPSIS | |
12524 | ||
12525 | =item DESCRIPTION | |
12526 | ||
12527 | =over 4 | |
12528 | ||
12529 | =item Global Variables | |
12530 | ||
12531 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
12532 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
12533 | $DB::lineno | |
12534 | ||
12535 | =item API Methods | |
12536 | ||
12537 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
12538 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
12539 | ||
12540 | =item Client Callback Methods | |
12541 | ||
12542 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
12543 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
12544 | CLIENT->output(LIST) | |
12545 | ||
12546 | =back | |
12547 | ||
12548 | =item BUGS | |
12549 | ||
12550 | =item AUTHOR | |
12551 | ||
12552 | =back | |
12553 | ||
7f106169 NC |
12554 | =head2 DBM_Filter -- Filter DBM keys/values |
12555 | ||
12556 | =over 4 | |
12557 | ||
12558 | =item SYNOPSIS | |
12559 | ||
12560 | =item DESCRIPTION | |
12561 | ||
12562 | =item What is a DBM Filter? | |
12563 | ||
12564 | =over 4 | |
12565 | ||
12566 | =item So what's new? | |
12567 | ||
12568 | =back | |
12569 | ||
12570 | =item METHODS | |
12571 | ||
12572 | =over 4 | |
12573 | ||
12574 | =item $db->Filter_Push() | |
12575 | ||
12576 | =item $db->Filter_Key_Push() | |
12577 | ||
12578 | =item $db->Filter_Value_Push() | |
12579 | ||
12580 | Filter_Push, Filter_Key_Push, Filter_Value_Push | |
12581 | ||
12582 | =item $db->Filter_Pop() | |
12583 | ||
12584 | =item $db->Filtered() | |
12585 | ||
12586 | =back | |
12587 | ||
12588 | =item Writing a Filter | |
12589 | ||
12590 | =over 4 | |
12591 | ||
12592 | =item Immediate Filters | |
12593 | ||
12594 | =item Canned Filters | |
12595 | ||
12596 | "name", params | |
12597 | ||
12598 | =back | |
12599 | ||
12600 | =item Filters Included | |
12601 | ||
12602 | utf8, encode, compress, int32, null | |
12603 | ||
12604 | =item NOTES | |
12605 | ||
12606 | =over 4 | |
12607 | ||
12608 | =item Maintain Round Trip Integrity | |
12609 | ||
12610 | =item Don't mix filtered & non-filtered data in the same database file. | |
12611 | ||
12612 | =back | |
12613 | ||
12614 | =item EXAMPLE | |
12615 | ||
12616 | =item SEE ALSO | |
12617 | ||
12618 | =item AUTHOR | |
12619 | ||
12620 | =back | |
12621 | ||
ee382f2f JH |
12622 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
12623 | ||
12624 | =over 4 | |
12625 | ||
12626 | =item SYNOPSIS | |
12627 | ||
12628 | =item DESCRIPTION | |
12629 | ||
12630 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> | |
12631 | ||
12632 | =over 4 | |
12633 | ||
12634 | =item Using DB_File with Berkeley DB version 2 or greater | |
12635 | ||
12636 | =item Interface to Berkeley DB | |
12637 | ||
12638 | =item Opening a Berkeley DB Database File | |
12639 | ||
12640 | =item Default Parameters | |
12641 | ||
12642 | =item In Memory Databases | |
12643 | ||
12644 | =back | |
12645 | ||
12646 | =item DB_HASH | |
12647 | ||
12648 | =over 4 | |
12649 | ||
12650 | =item A Simple Example | |
12651 | ||
12652 | =back | |
12653 | ||
12654 | =item DB_BTREE | |
12655 | ||
12656 | =over 4 | |
12657 | ||
12658 | =item Changing the BTREE sort order | |
12659 | ||
12660 | =item Handling Duplicate Keys | |
12661 | ||
12662 | =item The get_dup() Method | |
12663 | ||
12664 | =item The find_dup() Method | |
12665 | ||
12666 | =item The del_dup() Method | |
12667 | ||
12668 | =item Matching Partial Keys | |
12669 | ||
12670 | =back | |
12671 | ||
12672 | =item DB_RECNO | |
12673 | ||
12674 | =over 4 | |
12675 | ||
12676 | =item The 'bval' Option | |
12677 | ||
12678 | =item A Simple Example | |
12679 | ||
12680 | =item Extra RECNO Methods | |
12681 | ||
12682 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, | |
12683 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset, | |
12684 | length, elements);> | |
12685 | ||
12686 | =item Another Example | |
12687 | ||
12688 | =back | |
12689 | ||
12690 | =item THE API INTERFACE | |
12691 | ||
12692 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = | |
12693 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
12694 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
12695 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
12696 | ||
12697 | =item DBM FILTERS | |
12698 | ||
12699 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
12700 | B<filter_fetch_value> | |
12701 | ||
12702 | =over 4 | |
12703 | ||
12704 | =item The Filter | |
12705 | ||
12706 | =item An Example -- the NULL termination problem. | |
12707 | ||
12708 | =item Another Example -- Key is a C int. | |
12709 | ||
12710 | =back | |
12711 | ||
12712 | =item HINTS AND TIPS | |
12713 | ||
12714 | =over 4 | |
12715 | ||
12716 | =item Locking: The Trouble with fd | |
12717 | ||
12718 | =item Safe ways to lock a database | |
12719 | ||
12720 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
12721 | ||
12722 | =item Sharing Databases With C Applications | |
12723 | ||
12724 | =item The untie() Gotcha | |
12725 | ||
12726 | =back | |
12727 | ||
12728 | =item COMMON QUESTIONS | |
12729 | ||
12730 | =over 4 | |
12731 | ||
12732 | =item Why is there Perl source in my database? | |
12733 | ||
12734 | =item How do I store complex data structures with DB_File? | |
12735 | ||
12736 | =item What does "Invalid Argument" mean? | |
12737 | ||
12738 | =item What does "Bareword 'DB_File' not allowed" mean? | |
12739 | ||
12740 | =back | |
12741 | ||
12742 | =item REFERENCES | |
12743 | ||
12744 | =item HISTORY | |
12745 | ||
12746 | =item BUGS | |
12747 | ||
12748 | =item AVAILABILITY | |
12749 | ||
12750 | =item COPYRIGHT | |
12751 | ||
12752 | =item SEE ALSO | |
12753 | ||
12754 | =item AUTHOR | |
12755 | ||
12756 | =back | |
12757 | ||
12758 | =head2 Data::Dumper - stringified perl data structures, suitable for both | |
12759 | printing and C<eval> | |
12760 | ||
12761 | =over 4 | |
12762 | ||
12763 | =item SYNOPSIS | |
12764 | ||
12765 | =item DESCRIPTION | |
12766 | ||
12767 | =over 4 | |
12768 | ||
12769 | =item Methods | |
12770 | ||
12771 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> | |
12772 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), | |
12773 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
12774 | I<$OBJ>->Reset | |
12775 | ||
12776 | =item Functions | |
12777 | ||
12778 | Dumper(I<LIST>) | |
12779 | ||
12780 | =item Configuration Variables or Methods | |
12781 | ||
12782 | =item Exports | |
12783 | ||
12784 | Dumper | |
12785 | ||
12786 | =back | |
12787 | ||
12788 | =item EXAMPLES | |
12789 | ||
12790 | =item BUGS | |
12791 | ||
6e76d345 JH |
12792 | =over 4 |
12793 | ||
12794 | =item NOTE | |
12795 | ||
12796 | =back | |
12797 | ||
ee382f2f JH |
12798 | =item AUTHOR |
12799 | ||
12800 | =item VERSION | |
12801 | ||
12802 | =item SEE ALSO | |
12803 | ||
12804 | =back | |
12805 | ||
12806 | =head2 Devel::DProf - a Perl code profiler | |
12807 | ||
12808 | =over 4 | |
12809 | ||
12810 | =item SYNOPSIS | |
12811 | ||
12812 | =item DESCRIPTION | |
12813 | ||
12814 | =item PROFILE FORMAT | |
12815 | ||
12816 | =item AUTOLOAD | |
12817 | ||
12818 | =item ENVIRONMENT | |
12819 | ||
12820 | =item BUGS | |
12821 | ||
12822 | =item SEE ALSO | |
12823 | ||
12824 | =back | |
12825 | ||
12826 | =head2 Devel::PPPort - Perl/Pollution/Portability | |
12827 | ||
12828 | =over 4 | |
12829 | ||
12830 | =item SYNOPSIS | |
12831 | ||
12832 | =item DESCRIPTION | |
12833 | ||
12834 | =over 4 | |
12835 | ||
a2db77eb NC |
12836 | =item Why use ppport.h? |
12837 | ||
12838 | You should use F<ppport.h> in modern code so that your code will work | |
12839 | with the widest range of Perl interpreters possible, without significant | |
12840 | additional work. | |
12841 | ||
12842 | =item How to use ppport.h | |
12843 | ||
12844 | =item Running ppport.h | |
12845 | ||
12846 | =back | |
12847 | ||
12848 | =item FUNCTIONS | |
12849 | ||
12850 | =over 4 | |
12851 | ||
ee382f2f JH |
12852 | =item WriteFile |
12853 | ||
12854 | =back | |
12855 | ||
a2db77eb | 12856 | =item COMPATIBILITY |
ee382f2f | 12857 | |
a2db77eb NC |
12858 | =over 4 |
12859 | ||
12860 | =item Provided Perl compatibility API | |
12861 | ||
12862 | =item Perl API not supported by ppport.h | |
12863 | ||
12864 | perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, | |
12865 | perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, | |
12866 | perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004 | |
12867 | ||
12868 | =back | |
12869 | ||
12870 | =item BUGS | |
12871 | ||
12872 | =item AUTHORS | |
12873 | ||
12874 | =item COPYRIGHT | |
ee382f2f JH |
12875 | |
12876 | =item SEE ALSO | |
12877 | ||
12878 | =back | |
12879 | ||
12880 | =head2 Devel::Peek - A data debugging tool for the XS programmer | |
12881 | ||
12882 | =over 4 | |
12883 | ||
12884 | =item SYNOPSIS | |
12885 | ||
12886 | =item DESCRIPTION | |
12887 | ||
12888 | =over 4 | |
12889 | ||
12890 | =item Runtime debugging | |
12891 | ||
12892 | =item Memory footprint debugging | |
12893 | ||
12894 | =back | |
12895 | ||
12896 | =item EXAMPLES | |
12897 | ||
12898 | =over 4 | |
12899 | ||
12900 | =item A simple scalar string | |
12901 | ||
12902 | =item A simple scalar number | |
12903 | ||
12904 | =item A simple scalar with an extra reference | |
12905 | ||
12906 | =item A reference to a simple scalar | |
12907 | ||
12908 | =item A reference to an array | |
12909 | ||
12910 | =item A reference to a hash | |
12911 | ||
12912 | =item Dumping a large array or hash | |
12913 | ||
12914 | =item A reference to an SV which holds a C pointer | |
12915 | ||
12916 | =item A reference to a subroutine | |
12917 | ||
12918 | =back | |
12919 | ||
12920 | =item EXPORTS | |
12921 | ||
12922 | =item BUGS | |
12923 | ||
12924 | =item AUTHOR | |
12925 | ||
12926 | =item SEE ALSO | |
12927 | ||
12928 | =back | |
12929 | ||
12930 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module | |
12931 | ||
12932 | =over 4 | |
12933 | ||
12934 | =item SYNOPSIS | |
12935 | ||
12936 | =item DESCRIPTION | |
12937 | ||
12938 | =back | |
12939 | ||
b40eed9c NC |
12940 | =head2 Devel::Size - Perl extension for finding the memory usage of Perl |
12941 | variables | |
12942 | ||
12943 | =over 4 | |
12944 | ||
12945 | =item SYNOPSIS | |
12946 | ||
12947 | =item DESCRIPTION | |
12948 | ||
12949 | =item FUNCTIONS | |
12950 | ||
12951 | =over 4 | |
12952 | ||
12953 | =item size($ref) | |
12954 | ||
12955 | =item total_size($ref) | |
12956 | ||
12957 | =back | |
12958 | ||
12959 | =item EXPORT | |
12960 | ||
12961 | =item UNDERSTANDING MEMORY ALLOCATION | |
12962 | ||
12963 | =over 4 | |
12964 | ||
12965 | =item The C library | |
12966 | ||
12967 | =item Perl | |
12968 | ||
12969 | =back | |
12970 | ||
12971 | =item DANGERS | |
12972 | ||
12973 | =item Messages: texts originating from this module. | |
12974 | ||
12975 | =over 4 | |
12976 | ||
12977 | =item Errors | |
12978 | ||
12979 | =item warnings | |
12980 | ||
12981 | =back | |
12982 | ||
12983 | =item BUGS | |
12984 | ||
12985 | =item AUTHOR | |
12986 | ||
12987 | =item COPYRIGHT | |
12988 | ||
12989 | =item SEE ALSO | |
12990 | ||
12991 | =back | |
12992 | ||
4c64e75b | 12993 | =head2 Digest - Modules that calculate message digests |
ee382f2f JH |
12994 | |
12995 | =over 4 | |
12996 | ||
12997 | =item SYNOPSIS | |
12998 | ||
12999 | =item DESCRIPTION | |
13000 | ||
13001 | I<binary>, I<hex>, I<base64> | |
13002 | ||
13003 | =item OO INTERFACE | |
13004 | ||
13005 | $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = | |
13006 | Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, | |
4c64e75b NC |
13007 | $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits( |
13008 | $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest, | |
13009 | $ctx->hexdigest, $ctx->b64digest | |
13010 | ||
13011 | =item Digest speed | |
ee382f2f JH |
13012 | |
13013 | =item SEE ALSO | |
13014 | ||
13015 | =item AUTHOR | |
13016 | ||
13017 | =back | |
13018 | ||
13019 | =head2 Digest::MD5 - Perl interface to the MD5 Algorithm | |
13020 | ||
13021 | =over 4 | |
13022 | ||
13023 | =item SYNOPSIS | |
13024 | ||
13025 | =item DESCRIPTION | |
13026 | ||
13027 | =item FUNCTIONS | |
13028 | ||
13029 | md5($data,...), md5_hex($data,...), md5_base64($data,...) | |
13030 | ||
13031 | =item METHODS | |
13032 | ||
73fba812 | 13033 | $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), |
7a5cdbdf AJ |
13034 | $md5->addfile($io_handle), $md5->add_bits($data, $nbits), |
13035 | $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest | |
ee382f2f JH |
13036 | |
13037 | =item EXAMPLES | |
13038 | ||
13039 | =item SEE ALSO | |
13040 | ||
13041 | =item COPYRIGHT | |
13042 | ||
13043 | =item AUTHORS | |
13044 | ||
13045 | =back | |
13046 | ||
7a5cdbdf AJ |
13047 | =head2 Digest::base - Digest base class |
13048 | ||
13049 | =over 4 | |
13050 | ||
b2a9ae16 NC |
13051 | =item SYNOPSIS |
13052 | ||
13053 | =item DESCRIPTION | |
13054 | ||
13055 | =item SEE ALSO | |
13056 | ||
13057 | =back | |
13058 | ||
13059 | =head2 Digest::file - Calculate digests of files | |
13060 | ||
13061 | =over 4 | |
13062 | ||
13063 | =item SYNOPSIS | |
7a5cdbdf AJ |
13064 | |
13065 | =item DESCRIPTION | |
13066 | ||
b2a9ae16 NC |
13067 | digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file, |
13068 | $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...] | |
13069 | ) | |
13070 | ||
7a5cdbdf AJ |
13071 | =item SEE ALSO |
13072 | ||
13073 | =back | |
13074 | ||
ee382f2f JH |
13075 | =head2 DirHandle - supply object methods for directory handles |
13076 | ||
13077 | =over 4 | |
13078 | ||
13079 | =item SYNOPSIS | |
13080 | ||
13081 | =item DESCRIPTION | |
13082 | ||
13083 | =item NOTES | |
13084 | ||
13085 | =back | |
13086 | ||
13087 | =head2 Dumpvalue - provides screen dump of Perl data. | |
13088 | ||
13089 | =over 4 | |
13090 | ||
13091 | =item SYNOPSIS | |
13092 | ||
13093 | =item DESCRIPTION | |
13094 | ||
13095 | =over 4 | |
13096 | ||
13097 | =item Creation | |
13098 | ||
13099 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
13100 | C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>, | |
13101 | C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
13102 | stopDbSignal | |
13103 | ||
13104 | =item Methods | |
13105 | ||
13106 | dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl, | |
13107 | compactDump, veryCompact, set, get | |
13108 | ||
13109 | =back | |
13110 | ||
13111 | =back | |
13112 | ||
13113 | =head2 DynaLoader - Dynamically load C libraries into Perl code | |
13114 | ||
13115 | =over 4 | |
13116 | ||
13117 | =item SYNOPSIS | |
13118 | ||
13119 | =item DESCRIPTION | |
13120 | ||
13121 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
7f106169 NC |
13122 | @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(), |
13123 | dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(), | |
13124 | dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), | |
13125 | dl_install_xsub(), bootstrap() | |
ee382f2f JH |
13126 | |
13127 | =item AUTHOR | |
13128 | ||
13129 | =back | |
13130 | ||
13131 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
13132 | Perl code | |
13133 | ||
13134 | =over 4 | |
13135 | ||
b40eed9c NC |
13136 | =item VERSION |
13137 | ||
ee382f2f JH |
13138 | =item SYNOPSIS |
13139 | ||
13140 | =item DESCRIPTION | |
13141 | ||
7550e1ad JH |
13142 | =over 4 |
13143 | ||
13144 | =item Migration from C<DynaLoader> | |
13145 | ||
13146 | =item Backward compatible boilerplate | |
13147 | ||
13148 | =back | |
13149 | ||
13150 | =item Order of initialization: early load() | |
13151 | ||
13152 | =over 4 | |
13153 | ||
13154 | =item The most hairy case | |
13155 | ||
13156 | =back | |
13157 | ||
b40eed9c NC |
13158 | =item DIAGNOSTICS |
13159 | ||
13160 | Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined | |
13161 | symbols present after loading %s: %s, XSLoader::load('Your::Module', | |
13162 | $Your::Module::VERSION) | |
13163 | ||
7550e1ad JH |
13164 | =item LIMITATIONS |
13165 | ||
b40eed9c NC |
13166 | =item BUGS |
13167 | ||
13168 | =item SEE ALSO | |
13169 | ||
13170 | =item AUTHORS | |
13171 | ||
13172 | =item COPYRIGHT | |
ee382f2f JH |
13173 | |
13174 | =back | |
13175 | ||
13176 | =head2 Encode - character encodings | |
13177 | ||
13178 | =over 4 | |
13179 | ||
13180 | =item SYNOPSIS | |
13181 | ||
13182 | =over 4 | |
13183 | ||
13184 | =item Table of Contents | |
13185 | ||
13186 | =back | |
13187 | ||
13188 | =item DESCRIPTION | |
13189 | ||
13190 | =over 4 | |
13191 | ||
13192 | =item TERMINOLOGY | |
13193 | ||
13194 | =back | |
13195 | ||
13196 | =item PERL ENCODING API | |
13197 | ||
13198 | $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING, | |
13199 | $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [, | |
13200 | CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [, | |
13201 | CHECK]); | |
13202 | ||
13203 | =over 4 | |
13204 | ||
13205 | =item Listing available encodings | |
13206 | ||
13207 | =item Defining Aliases | |
13208 | ||
13209 | =back | |
13210 | ||
13211 | =item Encoding via PerlIO | |
13212 | ||
13213 | =item Handling Malformed Data | |
13214 | ||
b40eed9c | 13215 | B<NOTE:> Not all encoding support this feature, I<CHECK> = |
55d31d93 NC |
13216 | Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> = |
13217 | Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> = | |
13218 | Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML | |
13219 | charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask | |
ee382f2f JH |
13220 | |
13221 | =over 4 | |
13222 | ||
b40eed9c | 13223 | =item coderef for CHECK |
ee382f2f JH |
13224 | |
13225 | =back | |
13226 | ||
13227 | =item Defining Encodings | |
13228 | ||
13229 | =item The UTF-8 flag | |
13230 | ||
13231 | Goal #1:, Goal #2:, Goal #3:, Goal #4: | |
13232 | ||
13233 | =over 4 | |
13234 | ||
13235 | =item Messing with Perl's Internals | |
13236 | ||
13237 | is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) | |
13238 | ||
13239 | =back | |
13240 | ||
e7f2ff80 NC |
13241 | =item UTF-8 vs. utf8 |
13242 | ||
ee382f2f JH |
13243 | =item SEE ALSO |
13244 | ||
13245 | =item MAINTAINER | |
13246 | ||
13247 | =back | |
13248 | ||
13249 | =head2 Encode::Alias - alias definitions to encodings | |
13250 | ||
13251 | =over 4 | |
13252 | ||
13253 | =item SYNOPSIS | |
13254 | ||
13255 | =item DESCRIPTION | |
13256 | ||
13257 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
13258 | reference, e.g.: | |
13259 | ||
13260 | =over 4 | |
13261 | ||
13262 | =item Alias overloading | |
13263 | ||
13264 | =back | |
13265 | ||
13266 | =item SEE ALSO | |
13267 | ||
13268 | =back | |
13269 | ||
13270 | =head2 Encode::Byte - Single Byte Encodings | |
13271 | ||
13272 | =over 4 | |
13273 | ||
13274 | =item SYNOPSIS | |
13275 | ||
13276 | =item ABSTRACT | |
13277 | ||
13278 | =item DESCRIPTION | |
13279 | ||
13280 | =item SEE ALSO | |
13281 | ||
13282 | =back | |
13283 | ||
13284 | =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* | |
13285 | ||
13286 | =head2 Encode::CN - China-based Chinese Encodings | |
13287 | ||
13288 | =over 4 | |
13289 | ||
13290 | =item SYNOPSIS | |
13291 | ||
13292 | =item DESCRIPTION | |
13293 | ||
13294 | =item NOTES | |
13295 | ||
13296 | =item BUGS | |
13297 | ||
13298 | =item SEE ALSO | |
13299 | ||
13300 | =back | |
13301 | ||
13302 | =head2 Encode::CN::HZ -- internally used by Encode::CN | |
13303 | ||
13304 | =head2 Encode::Config -- internally used by Encode | |
13305 | ||
13306 | =head2 Encode::EBCDIC - EBCDIC Encodings | |
13307 | ||
13308 | =over 4 | |
13309 | ||
13310 | =item SYNOPSIS | |
13311 | ||
13312 | =item ABSTRACT | |
13313 | ||
13314 | =item DESCRIPTION | |
13315 | ||
13316 | =item SEE ALSO | |
13317 | ||
13318 | =back | |
13319 | ||
13320 | =head2 Encode::Encoding - Encode Implementation Base Class | |
13321 | ||
13322 | =over 4 | |
13323 | ||
13324 | =item SYNOPSIS | |
13325 | ||
13326 | =item DESCRIPTION | |
13327 | ||
13328 | =over 4 | |
13329 | ||
13330 | =item Methods you should implement | |
13331 | ||
13332 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), | |
13333 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) | |
13334 | ||
13335 | =item Other methods defined in Encode::Encodings | |
13336 | ||
55d31d93 NC |
13337 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
13338 | -E<gt>needs_lines() | |
ee382f2f JH |
13339 | |
13340 | =item Example: Encode::ROT13 | |
13341 | ||
13342 | =back | |
13343 | ||
13344 | =item Why the heck Encode API is different? | |
13345 | ||
13346 | =over 4 | |
13347 | ||
13348 | =item Compiled Encodings | |
13349 | ||
13350 | =back | |
13351 | ||
13352 | =item SEE ALSO | |
13353 | ||
13354 | Scheme 1, Scheme 2, Other Schemes | |
13355 | ||
13356 | =back | |
13357 | ||
13358 | =head2 Encode::Guess -- Guesses encoding from data | |
13359 | ||
13360 | =over 4 | |
13361 | ||
13362 | =item SYNOPSIS | |
13363 | ||
13364 | =item ABSTRACT | |
13365 | ||
13366 | =item DESCRIPTION | |
13367 | ||
13368 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
13369 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
13370 | guess_encoding($data, [, I<list of suspects>]) | |
13371 | ||
13372 | =item CAVEATS | |
13373 | ||
13374 | =item TO DO | |
13375 | ||
13376 | =item SEE ALSO | |
13377 | ||
13378 | =back | |
13379 | ||
13380 | =head2 Encode::JP - Japanese Encodings | |
13381 | ||
13382 | =over 4 | |
13383 | ||
13384 | =item SYNOPSIS | |
13385 | ||
13386 | =item ABSTRACT | |
13387 | ||
13388 | =item DESCRIPTION | |
13389 | ||
13390 | =item Note on ISO-2022-JP(-1)? | |
13391 | ||
13392 | =item BUGS | |
13393 | ||
13394 | =item SEE ALSO | |
13395 | ||
13396 | =back | |
13397 | ||
13398 | =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* | |
13399 | ||
13400 | =head2 Encode::JP::JIS7 -- internally used by Encode::JP | |
13401 | ||
13402 | =head2 Encode::KR - Korean Encodings | |
13403 | ||
13404 | =over 4 | |
13405 | ||
13406 | =item SYNOPSIS | |
13407 | ||
13408 | =item DESCRIPTION | |
13409 | ||
13410 | =item BUGS | |
13411 | ||
13412 | =item SEE ALSO | |
13413 | ||
13414 | =back | |
13415 | ||
13416 | =head2 Encode::KR::2022_KR -- internally used by Encode::KR | |
13417 | ||
13418 | =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding | |
13419 | ||
13420 | =over 4 | |
13421 | ||
13422 | =item SYNOPSIS | |
13423 | ||
13424 | =item ABSTRACT | |
13425 | ||
13426 | =item DESCRIPTION | |
13427 | ||
13428 | =item BUGS | |
13429 | ||
13430 | =item SEE ALSO | |
13431 | ||
13432 | =back | |
13433 | ||
13434 | =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO | |
13435 | ||
13436 | =over 4 | |
13437 | ||
13438 | =item Overview | |
13439 | ||
13440 | =item How does it work? | |
13441 | ||
13442 | =item Line Buffering | |
13443 | ||
13444 | =over 4 | |
13445 | ||
13446 | =item How can I tell whether my encoding fully supports PerlIO ? | |
13447 | ||
13448 | =back | |
13449 | ||
13450 | =item SEE ALSO | |
13451 | ||
13452 | =back | |
13453 | ||
13454 | =head2 Encode::Supported -- Encodings supported by Encode | |
13455 | ||
13456 | =over 4 | |
13457 | ||
13458 | =item DESCRIPTION | |
13459 | ||
13460 | =over 4 | |
13461 | ||
13462 | =item Encoding Names | |
13463 | ||
13464 | =back | |
13465 | ||
13466 | =item Supported Encodings | |
13467 | ||
13468 | =over 4 | |
13469 | ||
13470 | =item Built-in Encodings | |
13471 | ||
13472 | =item Encode::Unicode -- other Unicode encodings | |
13473 | ||
13474 | =item Encode::Byte -- Extended ASCII | |
13475 | ||
13476 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
13477 | the Cyrillic world, gsm0338 - Hentai Latin 1 | |
13478 | ||
13479 | =item CJK: Chinese, Japanese, Korean (Multibyte) | |
13480 | ||
13481 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
13482 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, | |
13483 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
13484 | ||
13485 | =item Miscellaneous encodings | |
13486 | ||
13487 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess | |
13488 | ||
13489 | =back | |
13490 | ||
13491 | =item Unsupported encodings | |
13492 | ||
13493 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, | |
13494 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
13495 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
13496 | Various Mac encodings, (Mac) Indic encodings | |
13497 | ||
13498 | =item Encoding vs. Charset -- terminology | |
13499 | ||
13500 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
13501 | ||
13502 | =over 4 | |
13503 | ||
13504 | =item Microsoft-related naming mess | |
13505 | ||
13506 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
13507 | ||
13508 | =back | |
13509 | ||
13510 | =item Glossary | |
13511 | ||
13512 | character repertoire, coded character set (CCS), character encoding scheme | |
13513 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, | |
13514 | UTF-16 | |
13515 | ||
13516 | =item See Also | |
13517 | ||
13518 | =item References | |
13519 | ||
13520 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, | |
13521 | RFC, UC, Unicode Glossary | |
13522 | ||
13523 | =over 4 | |
13524 | ||
13525 | =item Other Notable Sites | |
13526 | ||
13527 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: | |
13528 | "Introduction to i18n" | |
13529 | ||
13530 | =item Offline sources | |
13531 | ||
13532 | C<CJKV Information Processing> by Ken Lunde | |
13533 | ||
13534 | =back | |
13535 | ||
13536 | =back | |
13537 | ||
13538 | =head2 Encode::Symbol - Symbol Encodings | |
13539 | ||
13540 | =over 4 | |
13541 | ||
13542 | =item SYNOPSIS | |
13543 | ||
13544 | =item ABSTRACT | |
13545 | ||
13546 | =item DESCRIPTION | |
13547 | ||
13548 | =item SEE ALSO | |
13549 | ||
13550 | =back | |
13551 | ||
13552 | =head2 Encode::TW - Taiwan-based Chinese Encodings | |
13553 | ||
13554 | =over 4 | |
13555 | ||
13556 | =item SYNOPSIS | |
13557 | ||
13558 | =item DESCRIPTION | |
13559 | ||
13560 | =item NOTES | |
13561 | ||
13562 | =item BUGS | |
13563 | ||
13564 | =item SEE ALSO | |
13565 | ||
13566 | =back | |
13567 | ||
13568 | =head2 Encode::Unicode -- Various Unicode Transformation Formats | |
13569 | ||
13570 | =over 4 | |
13571 | ||
13572 | =item SYNOPSIS | |
13573 | ||
13574 | =item ABSTRACT | |
13575 | ||
13576 | L<http://www.unicode.org/glossary/> says:, Quick Reference | |
13577 | ||
13578 | =item Size, Endianness, and BOM | |
13579 | ||
13580 | =over 4 | |
13581 | ||
13582 | =item by size | |
13583 | ||
13584 | =item by endianness | |
13585 | ||
13586 | BOM as integer when fetched in network byte order | |
13587 | ||
13588 | =back | |
13589 | ||
13590 | =item Surrogate Pairs | |
13591 | ||
55d31d93 NC |
13592 | =item Error Checking |
13593 | ||
ee382f2f JH |
13594 | =item SEE ALSO |
13595 | ||
13596 | =back | |
13597 | ||
1184f6df JH |
13598 | =head2 Encode::Unicode::UTF7 -- UTF-7 encoding |
13599 | ||
13600 | =over 4 | |
13601 | ||
13602 | =item SYNOPSIS | |
13603 | ||
13604 | =item ABSTRACT | |
13605 | ||
13606 | =item In Practice | |
13607 | ||
13608 | =item SEE ALSO | |
13609 | ||
13610 | =back | |
13611 | ||
ee382f2f JH |
13612 | =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to |
13613 | encodings | |
13614 | ||
13615 | =over 4 | |
13616 | ||
13617 | =item SYNOPSIS | |
13618 | ||
13619 | =item DESCRIPTION | |
13620 | ||
13621 | As a simple string, As a qr// compiled regular expression, e.g.:, As a code | |
13622 | reference, e.g.: | |
13623 | ||
13624 | =over 4 | |
13625 | ||
13626 | =item Alias overloading | |
13627 | ||
13628 | =back | |
13629 | ||
13630 | =item SEE ALSO | |
13631 | ||
13632 | =back | |
13633 | ||
13634 | =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- | |
13635 | Internally used by Encode::??::ISO_2022_* | |
13636 | ||
13637 | =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by | |
13638 | Encode::CN | |
13639 | ||
13640 | =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by | |
13641 | Encode | |
13642 | ||
13643 | =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode | |
13644 | Implementation Base Class | |
13645 | ||
13646 | =over 4 | |
13647 | ||
13648 | =item SYNOPSIS | |
13649 | ||
13650 | =item DESCRIPTION | |
13651 | ||
13652 | =over 4 | |
13653 | ||
13654 | =item Methods you should implement | |
13655 | ||
13656 | -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]), | |
13657 | -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check]) | |
13658 | ||
13659 | =item Other methods defined in Encode::Encodings | |
13660 | ||
55d31d93 NC |
13661 | -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(), |
13662 | -E<gt>needs_lines() | |
ee382f2f JH |
13663 | |
13664 | =item Example: Encode::ROT13 | |
13665 | ||
13666 | =back | |
13667 | ||
13668 | =item Why the heck Encode API is different? | |
13669 | ||
13670 | =over 4 | |
13671 | ||
13672 | =item Compiled Encodings | |
13673 | ||
13674 | =back | |
13675 | ||
13676 | =item SEE ALSO | |
13677 | ||
13678 | Scheme 1, Scheme 2, Other Schemes | |
13679 | ||
13680 | =back | |
13681 | ||
13682 | =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from | |
13683 | data | |
13684 | ||
13685 | =over 4 | |
13686 | ||
13687 | =item SYNOPSIS | |
13688 | ||
13689 | =item ABSTRACT | |
13690 | ||
13691 | =item DESCRIPTION | |
13692 | ||
13693 | Encode::Guess->set_suspects, Encode::Guess->add_suspects, | |
13694 | Encode::decode("Guess" ...), Encode::Guess->guess($data), | |
13695 | guess_encoding($data, [, I<list of suspects>]) | |
13696 | ||
13697 | =item CAVEATS | |
13698 | ||
13699 | =item TO DO | |
13700 | ||
13701 | =item SEE ALSO | |
13702 | ||
13703 | =back | |
13704 | ||
13705 | =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by | |
13706 | Encode::JP::2022_JP* | |
13707 | ||
13708 | =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used | |
13709 | by Encode::JP | |
13710 | ||
13711 | =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally | |
13712 | used by Encode::KR | |
13713 | ||
13714 | =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B' | |
13715 | and 'Q' header encoding | |
13716 | ||
13717 | =over 4 | |
13718 | ||
13719 | =item SYNOPSIS | |
13720 | ||
13721 | =item ABSTRACT | |
13722 | ||
13723 | =item DESCRIPTION | |
13724 | ||
13725 | =item BUGS | |
13726 | ||
13727 | =item SEE ALSO | |
13728 | ||
13729 | =back | |
13730 | ||
13731 | =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document | |
13732 | on Encode and PerlIO | |
13733 | ||
13734 | =over 4 | |
13735 | ||
13736 | =item Overview | |
13737 | ||
13738 | =item How does it work? | |
13739 | ||
13740 | =item Line Buffering | |
13741 | ||
13742 | =over 4 | |
13743 | ||
13744 | =item How can I tell whether my encoding fully supports PerlIO ? | |
13745 | ||
13746 | =back | |
13747 | ||
13748 | =item SEE ALSO | |
13749 | ||
13750 | =back | |
13751 | ||
13752 | =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings | |
13753 | supported by Encode | |
13754 | ||
13755 | =over 4 | |
13756 | ||
13757 | =item DESCRIPTION | |
13758 | ||
13759 | =over 4 | |
13760 | ||
13761 | =item Encoding Names | |
13762 | ||
13763 | =back | |
13764 | ||
13765 | =item Supported Encodings | |
13766 | ||
13767 | =over 4 | |
13768 | ||
13769 | =item Built-in Encodings | |
13770 | ||
13771 | =item Encode::Unicode -- other Unicode encodings | |
13772 | ||
13773 | =item Encode::Byte -- Extended ASCII | |
13774 | ||
13775 | ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for | |
13776 | the Cyrillic world, gsm0338 - Hentai Latin 1 | |
13777 | ||
13778 | =item CJK: Chinese, Japanese, Korean (Multibyte) | |
13779 | ||
13780 | Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, | |
13781 | Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, | |
13782 | Encode::JIS2K -- JIS X 0213 encodings via CPAN | |
13783 | ||
13784 | =item Miscellaneous encodings | |
13785 | ||
13786 | Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess | |
13787 | ||
13788 | =back | |
13789 | ||
13790 | =item Unsupported encodings | |
13791 | ||
13792 | ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, | |
13793 | Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran | |
13794 | System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, | |
13795 | Various Mac encodings, (Mac) Indic encodings | |
13796 | ||
13797 | =item Encoding vs. Charset -- terminology | |
13798 | ||
13799 | =item Encoding Classification (by Anton Tagunov and Dan Kogai) | |
13800 | ||
13801 | =over 4 | |
13802 | ||
13803 | =item Microsoft-related naming mess | |
13804 | ||
13805 | KS_C_5601-1987, GB2312, Big5, Shift_JIS | |
13806 | ||
13807 | =back | |
13808 | ||
13809 | =item Glossary | |
13810 | ||
13811 | character repertoire, coded character set (CCS), character encoding scheme | |
13812 | (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, | |
13813 | UTF-16 | |
13814 | ||
13815 | =item See Also | |
13816 | ||
13817 | =item References | |
13818 | ||
13819 | ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO, | |
13820 | RFC, UC, Unicode Glossary | |
13821 | ||
13822 | =over 4 | |
13823 | ||
13824 | =item Other Notable Sites | |
13825 | ||
13826 | czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: | |
13827 | "Introduction to i18n" | |
13828 | ||
13829 | =item Offline sources | |
13830 | ||
13831 | C<CJKV Information Processing> by Ken Lunde | |
13832 | ||
13833 | =back | |
13834 | ||
13835 | =back | |
13836 | ||
1184f6df JH |
13837 | =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 |
13838 | encoding | |
13839 | ||
13840 | =over 4 | |
13841 | ||
13842 | =item SYNOPSIS | |
13843 | ||
13844 | =item ABSTRACT | |
13845 | ||
13846 | =item In Practice | |
13847 | ||
13848 | =item SEE ALSO | |
13849 | ||
13850 | =back | |
13851 | ||
ee382f2f JH |
13852 | =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder |
13853 | ||
13854 | =over 4 | |
13855 | ||
13856 | =item SYNOPSIS | |
13857 | ||
13858 | =item ABSTRACT | |
13859 | ||
13860 | =item Description | |
13861 | ||
13862 | =over 4 | |
13863 | ||
13864 | =item Predefined Methods | |
13865 | ||
13866 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), | |
13867 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
13868 | $e-E<gt>bytes([$encoding]) | |
13869 | ||
13870 | =item Example: base64 transcoder | |
13871 | ||
13872 | =item Operator Overloading | |
13873 | ||
13874 | =back | |
13875 | ||
13876 | =item SEE ALSO | |
13877 | ||
13878 | =back | |
13879 | ||
13880 | =head2 Encodencoding, encoding - allows you to write your script in | |
13881 | non-ascii or non-utf8 | |
13882 | ||
13883 | =over 4 | |
13884 | ||
13885 | =item SYNOPSIS | |
13886 | ||
13887 | =item ABSTRACT | |
13888 | ||
13889 | =over 4 | |
13890 | ||
13891 | =item Literal Conversions | |
13892 | ||
13893 | =item PerlIO layers for C<STD(IN|OUT)> | |
13894 | ||
7a5cdbdf AJ |
13895 | =item Implicit upgrading for byte strings |
13896 | ||
ee382f2f JH |
13897 | =back |
13898 | ||
13899 | =item FEATURES THAT REQUIRE 5.8.1 | |
13900 | ||
13901 | "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle | |
13902 | ||
13903 | =item USAGE | |
13904 | ||
13905 | use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt> | |
13906 | I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding; | |
13907 | ||
13908 | =item The Filter Option | |
13909 | ||
13910 | =over 4 | |
13911 | ||
13912 | =item Filter-related changes at Encode version 1.87 | |
13913 | ||
13914 | =back | |
13915 | ||
13916 | =item CAVEATS | |
13917 | ||
13918 | =over 4 | |
13919 | ||
13920 | =item NOT SCOPED | |
13921 | ||
13922 | =item DO NOT MIX MULTIPLE ENCODINGS | |
13923 | ||
13924 | =item tr/// with ranges | |
13925 | ||
13926 | Legend of characters above | |
13927 | ||
13928 | =back | |
13929 | ||
13930 | =item EXAMPLE - Greekperl | |
13931 | ||
13932 | =item KNOWN PROBLEMS | |
13933 | ||
13934 | literals in regex that are longer than 127 bytes, EBCDIC, format | |
13935 | ||
a2db77eb NC |
13936 | =over 4 |
13937 | ||
13938 | =item The Logic of :locale | |
13939 | ||
13940 | =back | |
13941 | ||
ee382f2f JH |
13942 | =item HISTORY |
13943 | ||
13944 | =item SEE ALSO | |
13945 | ||
13946 | =back | |
13947 | ||
13948 | =head2 Encoder, Encode::Encoder -- Object Oriented Encoder | |
13949 | ||
13950 | =over 4 | |
13951 | ||
13952 | =item SYNOPSIS | |
13953 | ||
13954 | =item ABSTRACT | |
13955 | ||
13956 | =item Description | |
13957 | ||
13958 | =over 4 | |
13959 | ||
13960 | =item Predefined Methods | |
13961 | ||
13962 | $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(), | |
13963 | $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]), | |
13964 | $e-E<gt>bytes([$encoding]) | |
13965 | ||
13966 | =item Example: base64 transcoder | |
13967 | ||
13968 | =item Operator Overloading | |
13969 | ||
13970 | =back | |
13971 | ||
13972 | =item SEE ALSO | |
13973 | ||
13974 | =back | |
13975 | ||
13976 | =head2 English - use nice English (or awk) names for ugly punctuation | |
13977 | variables | |
13978 | ||
13979 | =over 4 | |
13980 | ||
13981 | =item SYNOPSIS | |
13982 | ||
13983 | =item DESCRIPTION | |
13984 | ||
13985 | =item PERFORMANCE | |
13986 | ||
13987 | =back | |
13988 | ||
13989 | =head2 Env - perl module that imports environment variables as scalars or | |
13990 | arrays | |
13991 | ||
13992 | =over 4 | |
13993 | ||
13994 | =item SYNOPSIS | |
13995 | ||
13996 | =item DESCRIPTION | |
13997 | ||
13998 | =item LIMITATIONS | |
13999 | ||
14000 | =item AUTHOR | |
14001 | ||
14002 | =back | |
14003 | ||
a2db77eb NC |
14004 | =head2 Errno - System errno constants |
14005 | ||
14006 | =over 4 | |
14007 | ||
14008 | =item SYNOPSIS | |
14009 | ||
14010 | =item DESCRIPTION | |
14011 | ||
14012 | =item CAVEATS | |
14013 | ||
14014 | =item AUTHOR | |
14015 | ||
14016 | =item COPYRIGHT | |
14017 | ||
14018 | =back | |
14019 | ||
ee382f2f JH |
14020 | =head2 Exporter - Implements default import method for modules |
14021 | ||
14022 | =over 4 | |
14023 | ||
14024 | =item SYNOPSIS | |
14025 | ||
14026 | =item DESCRIPTION | |
14027 | ||
14028 | =over 4 | |
14029 | ||
14030 | =item How to Export | |
14031 | ||
14032 | =item Selecting What To Export | |
14033 | ||
14034 | =item How to Import | |
14035 | ||
14036 | C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);> | |
14037 | ||
14038 | =back | |
14039 | ||
14040 | =item Advanced features | |
14041 | ||
14042 | =over 4 | |
14043 | ||
14044 | =item Specialised Import Lists | |
14045 | ||
14046 | =item Exporting without using Exporter's import method | |
14047 | ||
4c64e75b NC |
14048 | =item Exporting without inheriting from Exporter |
14049 | ||
ee382f2f JH |
14050 | =item Module Version Checking |
14051 | ||
14052 | =item Managing Unknown Symbols | |
14053 | ||
14054 | =item Tag Handling Utility Functions | |
14055 | ||
14056 | =item Generating combined tags | |
14057 | ||
14058 | =item C<AUTOLOAD>ed Constants | |
14059 | ||
14060 | =back | |
14061 | ||
14062 | =back | |
14063 | ||
14064 | =head2 Exporter::Heavy - Exporter guts | |
14065 | ||
14066 | =over 4 | |
14067 | ||
14068 | =item SYNOPSIS | |
14069 | ||
14070 | =item DESCRIPTION | |
14071 | ||
14072 | =back | |
14073 | ||
14074 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in | |
14075 | Makefiles etc. | |
14076 | ||
14077 | =over 4 | |
14078 | ||
14079 | =item SYNOPSIS | |
14080 | ||
14081 | =item DESCRIPTION | |
14082 | ||
14083 | =back | |
14084 | ||
14085 | cat | |
14086 | ||
b40eed9c | 14087 | eqtime |
ee382f2f | 14088 | |
b40eed9c | 14089 | rm_rf |
ee382f2f | 14090 | |
b40eed9c | 14091 | rm_f |
ee382f2f | 14092 | |
b40eed9c | 14093 | touch |
ee382f2f | 14094 | |
b40eed9c | 14095 | mv |
ee382f2f | 14096 | |
b40eed9c | 14097 | cp |
ee382f2f | 14098 | |
b40eed9c | 14099 | chmod |
ee382f2f | 14100 | |
b40eed9c | 14101 | mkpath |
ee382f2f | 14102 | |
b40eed9c | 14103 | test_f |
ee382f2f | 14104 | |
b40eed9c | 14105 | dos2unix |
ee382f2f | 14106 | |
b40eed9c | 14107 | =over 4 |
ee382f2f JH |
14108 | |
14109 | =item SEE ALSO | |
14110 | ||
14111 | =item AUTHOR | |
14112 | ||
14113 | =back | |
14114 | ||
14115 | =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles | |
14116 | ||
14117 | =over 4 | |
14118 | ||
14119 | =item SYNOPSIS | |
14120 | ||
14121 | =item DESCRIPTION | |
14122 | ||
14123 | B<test_harness> | |
14124 | ||
14125 | =back | |
14126 | ||
14127 | B<pod2man> | |
14128 | ||
14129 | B<warn_if_old_packlist> | |
14130 | ||
14131 | B<perllocal_install> | |
14132 | ||
14133 | B<uninstall> | |
14134 | ||
14135 | =head2 ExtUtils::Constant - generate XS code to import C header constants | |
14136 | ||
14137 | =over 4 | |
14138 | ||
14139 | =item SYNOPSIS | |
14140 | ||
14141 | =item DESCRIPTION | |
14142 | ||
14143 | =item USAGE | |
14144 | ||
14145 | IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF | |
14146 | ||
14147 | =item FUNCTIONS | |
14148 | ||
14149 | =back | |
14150 | ||
b2a9ae16 | 14151 | constant_types |
ee382f2f | 14152 | |
b2a9ae16 | 14153 | XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME |
ee382f2f | 14154 | |
b2a9ae16 | 14155 | autoload PACKAGE, VERSION, AUTOLOADER |
ee382f2f | 14156 | |
b2a9ae16 NC |
14157 | WriteMakefileSnippet |
14158 | ||
14159 | WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE, | |
14160 | BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME | |
ee382f2f | 14161 | |
b2a9ae16 NC |
14162 | =over 4 |
14163 | ||
14164 | =item AUTHOR | |
ee382f2f | 14165 | |
b2a9ae16 | 14166 | =back |
ee382f2f | 14167 | |
b2a9ae16 NC |
14168 | =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects |
14169 | ||
14170 | =over 4 | |
14171 | ||
14172 | =item SYNOPSIS | |
14173 | ||
14174 | =item DESCRIPTION | |
14175 | ||
14176 | =item USAGE | |
14177 | ||
14178 | =back | |
14179 | ||
14180 | header | |
14181 | ||
14182 | memEQ_clause args_hashref | |
14183 | ||
14184 | dump_names arg_hashref, ITEM.. | |
14185 | ||
14186 | assign arg_hashref, VALUE.. | |
14187 | ||
14188 | return_clause arg_hashref, ITEM | |
14189 | ||
14190 | switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM.. | |
ee382f2f JH |
14191 | |
14192 | params WHAT | |
14193 | ||
b2a9ae16 | 14194 | dogfood arg_hashref, ITEM.. |
ee382f2f | 14195 | |
b2a9ae16 NC |
14196 | C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre, |
14197 | post, def_pre, def_post, utf8, weight | |
ee382f2f | 14198 | |
b2a9ae16 | 14199 | =over 4 |
ee382f2f | 14200 | |
b2a9ae16 | 14201 | =item BUGS |
ee382f2f | 14202 | |
b2a9ae16 | 14203 | =item AUTHOR |
ee382f2f | 14204 | |
b2a9ae16 | 14205 | =back |
ee382f2f | 14206 | |
b2a9ae16 NC |
14207 | =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant |
14208 | ||
14209 | =over 4 | |
14210 | ||
14211 | =item SYNOPSIS | |
14212 | ||
14213 | =item DESCRIPTION | |
14214 | ||
14215 | =item USAGE | |
14216 | ||
14217 | C_stringify NAME | |
14218 | ||
14219 | =back | |
14220 | ||
14221 | perl_stringify NAME | |
14222 | ||
14223 | =over 4 | |
14224 | ||
14225 | =item AUTHOR | |
14226 | ||
14227 | =back | |
14228 | ||
14229 | =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for | |
14230 | ExtUtils::Constant objects | |
ee382f2f JH |
14231 | |
14232 | =over 4 | |
14233 | ||
b2a9ae16 NC |
14234 | =item SYNOPSIS |
14235 | ||
14236 | =item DESCRIPTION | |
14237 | ||
14238 | =item BUGS | |
14239 | ||
ee382f2f JH |
14240 | =item AUTHOR |
14241 | ||
14242 | =back | |
14243 | ||
14244 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications | |
14245 | ||
14246 | =over 4 | |
14247 | ||
14248 | =item SYNOPSIS | |
14249 | ||
14250 | =item DESCRIPTION | |
14251 | ||
14252 | =item @EXPORT | |
14253 | ||
14254 | =item FUNCTIONS | |
14255 | ||
14256 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), | |
14257 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
14258 | ||
14259 | =item EXAMPLES | |
14260 | ||
14261 | =item SEE ALSO | |
14262 | ||
14263 | =item AUTHOR | |
14264 | ||
14265 | =back | |
14266 | ||
14267 | =head2 ExtUtils::Install - install files from here to there | |
14268 | ||
14269 | =over 4 | |
14270 | ||
14271 | =item SYNOPSIS | |
14272 | ||
14273 | =item DESCRIPTION | |
14274 | ||
14275 | =over 4 | |
14276 | ||
14277 | =item Functions | |
14278 | ||
14279 | B<install> | |
14280 | ||
14281 | =back | |
14282 | ||
14283 | =back | |
14284 | ||
14285 | B<install_default> I<DISCOURAGED> | |
14286 | ||
14287 | B<uninstall> | |
14288 | ||
14289 | B<pm_to_blib> | |
14290 | ||
14291 | _autosplit | |
14292 | ||
14293 | =over 4 | |
14294 | ||
14295 | =item ENVIRONMENT | |
14296 | ||
14297 | B<PERL_INSTALL_ROOT> | |
14298 | ||
14299 | =item AUTHOR | |
14300 | ||
14301 | =item LICENSE | |
14302 | ||
14303 | =back | |
14304 | ||
14305 | =head2 ExtUtils::Installed - Inventory management of installed modules | |
14306 | ||
14307 | =over 4 | |
14308 | ||
14309 | =item SYNOPSIS | |
14310 | ||
14311 | =item DESCRIPTION | |
14312 | ||
14313 | =item USAGE | |
14314 | ||
14315 | =item FUNCTIONS | |
14316 | ||
14317 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
14318 | packlist(), version() | |
14319 | ||
14320 | =item EXAMPLE | |
14321 | ||
14322 | =item AUTHOR | |
14323 | ||
14324 | =back | |
14325 | ||
14326 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them | |
14327 | ||
14328 | =over 4 | |
14329 | ||
14330 | =item SYNOPSIS | |
14331 | ||
14332 | =item DESCRIPTION | |
14333 | ||
14334 | For static extensions, For dynamic extensions at build/link time, For | |
14335 | dynamic extensions at load time | |
14336 | ||
14337 | =over 4 | |
14338 | ||
14339 | =item EXTRALIBS | |
14340 | ||
14341 | =item LDLOADLIBS and LD_RUN_PATH | |
14342 | ||
14343 | =item BSLOADLIBS | |
14344 | ||
14345 | =back | |
14346 | ||
14347 | =item PORTABILITY | |
14348 | ||
14349 | =over 4 | |
14350 | ||
14351 | =item VMS implementation | |
14352 | ||
14353 | =item Win32 implementation | |
14354 | ||
14355 | =back | |
14356 | ||
14357 | =item SEE ALSO | |
14358 | ||
14359 | =back | |
14360 | ||
14361 | =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass | |
14362 | ||
14363 | =over 4 | |
14364 | ||
14365 | =item SYNOPSIS | |
14366 | ||
14367 | =item DESCRIPTION | |
14368 | ||
14369 | =back | |
14370 | ||
b40eed9c | 14371 | =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix |
ee382f2f JH |
14372 | |
14373 | =over 4 | |
14374 | ||
14375 | =item SYNOPSIS | |
14376 | ||
14377 | =item DESCRIPTION | |
14378 | ||
b40eed9c | 14379 | =over 4 |
ee382f2f | 14380 | |
b40eed9c | 14381 | =item Overridden methods |
ee382f2f JH |
14382 | |
14383 | =back | |
14384 | ||
b40eed9c | 14385 | =back |
73fba812 | 14386 | |
ee382f2f JH |
14387 | =over 4 |
14388 | ||
b40eed9c | 14389 | =item AUTHOR |
ee382f2f | 14390 | |
b40eed9c | 14391 | =item SEE ALSO |
ee382f2f JH |
14392 | |
14393 | =back | |
14394 | ||
b40eed9c NC |
14395 | =head2 ExtUtils::MM_Any - Platform-agnostic MM methods |
14396 | ||
ee382f2f JH |
14397 | =over 4 |
14398 | ||
b40eed9c | 14399 | =item SYNOPSIS |
ee382f2f | 14400 | |
b40eed9c | 14401 | =item DESCRIPTION |
ee382f2f | 14402 | |
b40eed9c | 14403 | =item METHODS |
ee382f2f | 14404 | |
b40eed9c | 14405 | =over 4 |
ee382f2f | 14406 | |
b40eed9c | 14407 | =item Cross-platform helper methods |
ee382f2f | 14408 | |
b40eed9c | 14409 | =back |
ee382f2f | 14410 | |
b40eed9c | 14411 | =back |
ee382f2f | 14412 | |
b40eed9c | 14413 | =over 4 |
ee382f2f | 14414 | |
b40eed9c | 14415 | =item Targets |
ee382f2f | 14416 | |
b40eed9c | 14417 | =back |
ee382f2f | 14418 | |
b40eed9c NC |
14419 | =over 4 |
14420 | ||
14421 | =item Init methods | |
ee382f2f | 14422 | |
b40eed9c | 14423 | =back |
ee382f2f | 14424 | |
b40eed9c | 14425 | =over 4 |
ee382f2f | 14426 | |
b40eed9c | 14427 | =item Tools |
ee382f2f | 14428 | |
b40eed9c | 14429 | =back |
ee382f2f | 14430 | |
b40eed9c | 14431 | =over 4 |
ee382f2f | 14432 | |
b40eed9c | 14433 | =item File::Spec wrappers |
ee382f2f | 14434 | |
b40eed9c | 14435 | =back |
ee382f2f JH |
14436 | |
14437 | =over 4 | |
14438 | ||
b40eed9c | 14439 | =item Misc |
ee382f2f JH |
14440 | |
14441 | =back | |
14442 | ||
ee382f2f JH |
14443 | =over 4 |
14444 | ||
14445 | =item AUTHOR | |
14446 | ||
14447 | =back | |
14448 | ||
14449 | =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in | |
14450 | ExtUtils::MakeMaker | |
14451 | ||
14452 | =over 4 | |
14453 | ||
14454 | =item SYNOPSIS | |
14455 | ||
14456 | =item DESCRIPTION | |
14457 | ||
14458 | =back | |
14459 | ||
b40eed9c | 14460 | os_flavor |
ee382f2f JH |
14461 | |
14462 | init_linker | |
14463 | ||
14464 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in | |
14465 | ExtUtils::MakeMaker | |
14466 | ||
14467 | =over 4 | |
14468 | ||
14469 | =item SYNOPSIS | |
14470 | ||
14471 | =item DESCRIPTION | |
14472 | ||
b40eed9c | 14473 | os_flavor |
ee382f2f JH |
14474 | |
14475 | =back | |
14476 | ||
b40eed9c | 14477 | cflags |
ee382f2f | 14478 | |
b40eed9c | 14479 | replace_manpage_separator |
ee382f2f JH |
14480 | |
14481 | init_linker | |
14482 | ||
14483 | =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix | |
14484 | ||
14485 | =over 4 | |
14486 | ||
14487 | =item SYNOPSIS | |
14488 | ||
14489 | =item DESCRIPTION | |
14490 | ||
14491 | =over 4 | |
14492 | ||
14493 | =item Overridden methods | |
14494 | ||
14495 | os_flavor | |
14496 | ||
14497 | =back | |
14498 | ||
14499 | =back | |
14500 | ||
14501 | B<replace_manpage_separator> | |
14502 | ||
14503 | =over 4 | |
14504 | ||
14505 | =item AUTHOR | |
14506 | ||
14507 | =item SEE ALSO | |
14508 | ||
14509 | =back | |
14510 | ||
b40eed9c | 14511 | =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic |
ee382f2f JH |
14512 | |
14513 | =over 4 | |
14514 | ||
14515 | =item SYNOPSIS | |
14516 | ||
14517 | =item DESCRIPTION | |
14518 | ||
14519 | =back | |
14520 | ||
b40eed9c NC |
14521 | =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in |
14522 | ExtUtils::MakeMaker | |
ee382f2f | 14523 | |
b40eed9c | 14524 | =over 4 |
ee382f2f | 14525 | |
b40eed9c | 14526 | =item SYNOPSIS |
ee382f2f | 14527 | |
b40eed9c | 14528 | =item DESCRIPTION |
ee382f2f | 14529 | |
b40eed9c | 14530 | =back |
ee382f2f | 14531 | |
b40eed9c | 14532 | os_flavor |
ee382f2f JH |
14533 | |
14534 | init_platform, platform_constants | |
14535 | ||
b40eed9c | 14536 | const_cccmd |
ee382f2f | 14537 | |
b40eed9c | 14538 | static_lib |
ee382f2f | 14539 | |
b40eed9c | 14540 | dynamic_lib |
ee382f2f | 14541 | |
b40eed9c NC |
14542 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
14543 | ExtUtils::MakeMaker | |
ee382f2f | 14544 | |
b40eed9c | 14545 | =over 4 |
ee382f2f | 14546 | |
b40eed9c | 14547 | =item SYNOPSIS |
ee382f2f | 14548 | |
b40eed9c | 14549 | =item DESCRIPTION |
ee382f2f | 14550 | |
b40eed9c | 14551 | =item METHODS |
ee382f2f | 14552 | |
b40eed9c | 14553 | init_dist |
ee382f2f | 14554 | |
b40eed9c | 14555 | =back |
ee382f2f | 14556 | |
b40eed9c | 14557 | init_linker |
ee382f2f JH |
14558 | |
14559 | os_flavor | |
14560 | ||
b40eed9c | 14561 | =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix |
ee382f2f JH |
14562 | |
14563 | =over 4 | |
14564 | ||
14565 | =item SYNOPSIS | |
14566 | ||
14567 | =item DESCRIPTION | |
14568 | ||
b40eed9c | 14569 | =over 4 |
ee382f2f | 14570 | |
b40eed9c | 14571 | =item Overridden methods |
ee382f2f | 14572 | |
b40eed9c | 14573 | =back |
ee382f2f | 14574 | |
b40eed9c | 14575 | =back |
ee382f2f JH |
14576 | |
14577 | =over 4 | |
14578 | ||
b40eed9c | 14579 | =item AUTHOR |
ee382f2f | 14580 | |
b40eed9c | 14581 | =item SEE ALSO |
ee382f2f JH |
14582 | |
14583 | =back | |
14584 | ||
ee382f2f JH |
14585 | =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix |
14586 | ||
14587 | =over 4 | |
14588 | ||
14589 | =item SYNOPSIS | |
14590 | ||
14591 | =item DESCRIPTION | |
14592 | ||
14593 | =over 4 | |
14594 | ||
14595 | =item Overridden methods | |
14596 | ||
14597 | os_flavor | |
14598 | ||
14599 | =back | |
14600 | ||
14601 | =back | |
14602 | ||
14603 | B<replace_manpage_separator> | |
14604 | ||
14605 | =over 4 | |
14606 | ||
14607 | =item AUTHOR | |
14608 | ||
14609 | =item SEE ALSO | |
14610 | ||
14611 | =back | |
14612 | ||
14613 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker | |
14614 | ||
14615 | =over 4 | |
14616 | ||
14617 | =item SYNOPSIS | |
14618 | ||
14619 | =item DESCRIPTION | |
14620 | ||
14621 | =item METHODS | |
14622 | ||
14623 | =back | |
14624 | ||
14625 | =over 4 | |
14626 | ||
14627 | =item Methods | |
14628 | ||
b40eed9c | 14629 | os_flavor |
ee382f2f JH |
14630 | |
14631 | =back | |
14632 | ||
14633 | c_o (o) | |
14634 | ||
14635 | cflags (o) | |
14636 | ||
ee382f2f JH |
14637 | const_cccmd (o) |
14638 | ||
14639 | const_config (o) | |
14640 | ||
14641 | const_loadlibs (o) | |
14642 | ||
14643 | constants (o) | |
14644 | ||
14645 | depend (o) | |
14646 | ||
73fba812 JH |
14647 | init_DEST |
14648 | ||
ee382f2f JH |
14649 | init_dist |
14650 | ||
14651 | dist (o) | |
14652 | ||
14653 | dist_basics (o) | |
14654 | ||
14655 | dist_ci (o) | |
14656 | ||
14657 | dist_core (o) | |
14658 | ||
14659 | B<dist_target> | |
14660 | ||
14661 | B<tardist_target> | |
14662 | ||
14663 | B<zipdist_target> | |
14664 | ||
14665 | B<tarfile_target> | |
14666 | ||
14667 | zipfile_target | |
14668 | ||
14669 | uutardist_target | |
14670 | ||
14671 | shdist_target | |
14672 | ||
ee382f2f JH |
14673 | dlsyms (o) |
14674 | ||
ee382f2f JH |
14675 | dynamic_bs (o) |
14676 | ||
14677 | dynamic_lib (o) | |
14678 | ||
14679 | exescan | |
14680 | ||
14681 | extliblist | |
14682 | ||
14683 | find_perl | |
14684 | ||
ee382f2f JH |
14685 | fixin |
14686 | ||
ee382f2f JH |
14687 | force (o) |
14688 | ||
14689 | guess_name | |
14690 | ||
14691 | has_link_code | |
14692 | ||
14693 | init_dirscan | |
14694 | ||
14695 | init_DIRFILESEP | |
14696 | ||
14697 | init_main | |
14698 | ||
14699 | init_others | |
14700 | ||
ee382f2f JH |
14701 | init_linker |
14702 | ||
14703 | init_lib2arch | |
14704 | ||
14705 | init_PERL | |
14706 | ||
b40eed9c | 14707 | init_platform, platform_constants |
ee382f2f JH |
14708 | |
14709 | init_PERM | |
14710 | ||
14711 | init_xs | |
14712 | ||
14713 | install (o) | |
14714 | ||
14715 | installbin (o) | |
14716 | ||
14717 | linkext (o) | |
14718 | ||
14719 | lsdir | |
14720 | ||
14721 | macro (o) | |
14722 | ||
14723 | makeaperl (o) | |
14724 | ||
14725 | makefile (o) | |
14726 | ||
14727 | maybe_command | |
14728 | ||
14729 | needs_linking (o) | |
14730 | ||
14731 | nicetext | |
14732 | ||
14733 | parse_abstract | |
14734 | ||
14735 | parse_version | |
14736 | ||
14737 | pasthru (o) | |
14738 | ||
14739 | perl_script | |
14740 | ||
14741 | perldepend (o) | |
14742 | ||
14743 | perm_rw (o) | |
14744 | ||
14745 | perm_rwx (o) | |
14746 | ||
14747 | pm_to_blib | |
14748 | ||
14749 | post_constants (o) | |
14750 | ||
14751 | post_initialize (o) | |
14752 | ||
14753 | postamble (o) | |
14754 | ||
14755 | ppd | |
14756 | ||
14757 | prefixify | |
14758 | ||
14759 | processPL (o) | |
14760 | ||
14761 | quote_paren | |
14762 | ||
ee382f2f JH |
14763 | replace_manpage_separator |
14764 | ||
b40eed9c NC |
14765 | cd |
14766 | ||
14767 | oneliner | |
ee382f2f JH |
14768 | |
14769 | quote_literal | |
14770 | ||
14771 | escape_newlines | |
14772 | ||
14773 | max_exec_len | |
14774 | ||
14775 | static (o) | |
14776 | ||
14777 | static_lib (o) | |
14778 | ||
14779 | staticmake (o) | |
14780 | ||
14781 | subdir_x (o) | |
14782 | ||
14783 | subdirs (o) | |
14784 | ||
14785 | test (o) | |
14786 | ||
14787 | test_via_harness (override) | |
14788 | ||
14789 | test_via_script (override) | |
14790 | ||
14791 | tools_other (o) | |
14792 | ||
14793 | tool_xsubpp (o) | |
14794 | ||
14795 | all_target | |
14796 | ||
14797 | top_targets (o) | |
14798 | ||
14799 | writedoc | |
14800 | ||
14801 | xs_c (o) | |
14802 | ||
14803 | xs_cpp (o) | |
14804 | ||
14805 | xs_o (o) | |
14806 | ||
14807 | =over 4 | |
14808 | ||
14809 | =item SEE ALSO | |
14810 | ||
14811 | =back | |
14812 | ||
14813 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
14814 | ExtUtils::MakeMaker | |
14815 | ||
14816 | =over 4 | |
14817 | ||
14818 | =item SYNOPSIS | |
14819 | ||
14820 | =item DESCRIPTION | |
14821 | ||
14822 | =over 4 | |
14823 | ||
14824 | =item Methods always loaded | |
14825 | ||
14826 | wraplist | |
14827 | ||
14828 | =back | |
14829 | ||
14830 | =back | |
14831 | ||
14832 | =over 4 | |
14833 | ||
14834 | =item Methods | |
14835 | ||
14836 | guess_name (override) | |
14837 | ||
14838 | =back | |
14839 | ||
14840 | find_perl (override) | |
14841 | ||
14842 | maybe_command (override) | |
14843 | ||
b40eed9c NC |
14844 | pasthru (override) |
14845 | ||
14846 | pm_to_blib (override) | |
14847 | ||
ee382f2f JH |
14848 | perl_script (override) |
14849 | ||
14850 | replace_manpage_separator | |
14851 | ||
73fba812 JH |
14852 | init_DEST |
14853 | ||
ee382f2f JH |
14854 | init_DIRFILESEP |
14855 | ||
14856 | init_main (override) | |
14857 | ||
14858 | init_others (override) | |
14859 | ||
14860 | init_platform (override) | |
14861 | ||
14862 | platform_constants | |
14863 | ||
14864 | init_VERSION (override) | |
14865 | ||
14866 | constants (override) | |
14867 | ||
14868 | special_targets | |
14869 | ||
14870 | cflags (override) | |
14871 | ||
14872 | const_cccmd (override) | |
14873 | ||
ee382f2f JH |
14874 | tools_other (override) |
14875 | ||
14876 | init_dist (override) | |
14877 | ||
14878 | c_o (override) | |
14879 | ||
14880 | xs_c (override) | |
14881 | ||
14882 | xs_o (override) | |
14883 | ||
14884 | dlsyms (override) | |
14885 | ||
14886 | dynamic_lib (override) | |
14887 | ||
ee382f2f JH |
14888 | static_lib (override) |
14889 | ||
b40eed9c | 14890 | extra_clean_files |
ee382f2f | 14891 | |
b40eed9c | 14892 | zipfile_target, tarfile_target, shdist_target |
ee382f2f JH |
14893 | |
14894 | install (override) | |
14895 | ||
14896 | perldepend (override) | |
14897 | ||
ee382f2f JH |
14898 | makeaperl (override) |
14899 | ||
14900 | nicetext (override) | |
14901 | ||
14902 | prefixify (override) | |
14903 | ||
b40eed9c | 14904 | cd |
ee382f2f | 14905 | |
b40eed9c NC |
14906 | oneliner |
14907 | ||
14908 | B<echo> | |
ee382f2f JH |
14909 | |
14910 | quote_literal | |
14911 | ||
14912 | escape_newlines | |
14913 | ||
14914 | max_exec_len | |
14915 | ||
b40eed9c | 14916 | init_linker |
ee382f2f JH |
14917 | |
14918 | eliminate_macros | |
14919 | ||
14920 | fixpath | |
14921 | ||
14922 | os_flavor | |
14923 | ||
b40eed9c NC |
14924 | =over 4 |
14925 | ||
14926 | =item AUTHOR | |
14927 | ||
14928 | =back | |
14929 | ||
14930 | =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix | |
14931 | ||
14932 | =over 4 | |
14933 | ||
14934 | =item SYNOPSIS | |
14935 | ||
14936 | =item DESCRIPTION | |
14937 | ||
14938 | =over 4 | |
14939 | ||
14940 | =item Overridden methods | |
14941 | ||
14942 | =back | |
14943 | ||
14944 | =back | |
14945 | ||
14946 | =over 4 | |
14947 | ||
14948 | =item AUTHOR | |
14949 | ||
14950 | =item SEE ALSO | |
14951 | ||
14952 | =back | |
14953 | ||
ee382f2f JH |
14954 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in |
14955 | ExtUtils::MakeMaker | |
14956 | ||
14957 | =over 4 | |
14958 | ||
14959 | =item SYNOPSIS | |
14960 | ||
14961 | =item DESCRIPTION | |
14962 | ||
14963 | =back | |
14964 | ||
14965 | =over 4 | |
14966 | ||
14967 | =item Overridden methods | |
14968 | ||
14969 | B<dlsyms> | |
14970 | ||
14971 | =back | |
14972 | ||
14973 | replace_manpage_separator | |
14974 | ||
14975 | B<maybe_command> | |
14976 | ||
ee382f2f JH |
14977 | B<init_DIRFILESEP> |
14978 | ||
14979 | B<init_others> | |
14980 | ||
b40eed9c | 14981 | init_platform, platform_constants |
ee382f2f | 14982 | |
b40eed9c | 14983 | special_targets |
ee382f2f | 14984 | |
b40eed9c | 14985 | static_lib |
ee382f2f | 14986 | |
b40eed9c | 14987 | dynamic_lib |
ee382f2f | 14988 | |
b40eed9c | 14989 | extra_clean_files |
ee382f2f JH |
14990 | |
14991 | init_linker | |
14992 | ||
14993 | perl_script | |
14994 | ||
b40eed9c | 14995 | xs_o |
ee382f2f | 14996 | |
b40eed9c | 14997 | pasthru |
ee382f2f | 14998 | |
b40eed9c NC |
14999 | oneliner |
15000 | ||
15001 | cd | |
ee382f2f JH |
15002 | |
15003 | max_exec_len | |
15004 | ||
15005 | os_flavor | |
15006 | ||
15007 | =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X | |
15008 | ||
15009 | =over 4 | |
15010 | ||
15011 | =item SYNOPSIS | |
15012 | ||
15013 | =item DESCRIPTION | |
15014 | ||
15015 | =over 4 | |
15016 | ||
15017 | =item Overriden methods | |
15018 | ||
b40eed9c | 15019 | xs_c |
ee382f2f JH |
15020 | |
15021 | =back | |
15022 | ||
15023 | =back | |
15024 | ||
ee382f2f JH |
15025 | xs_cpp |
15026 | ||
15027 | xs_o | |
15028 | ||
b40eed9c | 15029 | max_exec_len |
ee382f2f | 15030 | |
ee382f2f JH |
15031 | os_flavor |
15032 | ||
15033 | =over 4 | |
15034 | ||
15035 | =item AUTHOR | |
15036 | ||
15037 | =back | |
15038 | ||
15039 | =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization | |
15040 | ||
15041 | =over 4 | |
15042 | ||
15043 | =item SYNOPSIS | |
15044 | ||
15045 | =item DESCRIPTION | |
15046 | ||
15047 | =back | |
15048 | ||
15049 | =head2 ExtUtils::MakeMaker - Create a module Makefile | |
15050 | ||
15051 | =over 4 | |
15052 | ||
15053 | =item SYNOPSIS | |
15054 | ||
15055 | =item DESCRIPTION | |
15056 | ||
15057 | =over 4 | |
15058 | ||
15059 | =item How To Write A Makefile.PL | |
15060 | ||
15061 | =item Default Makefile Behaviour | |
15062 | ||
15063 | =item make test | |
15064 | ||
15065 | =item make testdb | |
15066 | ||
15067 | =item make install | |
15068 | ||
15069 | =item PREFIX and LIB attribute | |
15070 | ||
15071 | =item AFS users | |
15072 | ||
15073 | =item Static Linking of a new Perl Binary | |
15074 | ||
15075 | =item Determination of Perl Library and Installation Locations | |
15076 | ||
15077 | =item Which architecture dependent directory? | |
15078 | ||
15079 | =item Using Attributes and Parameters | |
15080 | ||
15081 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, | |
15082 | CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, | |
15083 | EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, | |
15084 | FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, | |
15085 | INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, | |
15086 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, | |
15087 | INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, | |
15088 | INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, | |
15089 | INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, | |
15090 | INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, | |
15091 | LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, | |
6e76d345 JH |
15092 | MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, |
15093 | OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, | |
15094 | PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, | |
15095 | PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, | |
15096 | PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, | |
b40eed9c NC |
15097 | PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, |
15098 | VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION | |
ee382f2f JH |
15099 | |
15100 | =item Additional lowercase attributes | |
15101 | ||
73fba812 JH |
15102 | clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, |
15103 | test, tool_autosplit | |
ee382f2f JH |
15104 | |
15105 | =item Overriding MakeMaker Methods | |
15106 | ||
15107 | =item The End Of Cargo Cult Programming | |
15108 | ||
b40eed9c | 15109 | C<< MAN3PODS => ' ' >> |
ee382f2f JH |
15110 | |
15111 | =item Hintsfile support | |
15112 | ||
15113 | =item Distribution Support | |
15114 | ||
15115 | make distcheck, make skipcheck, make distclean, make manifest, | |
15116 | make distdir, make disttest, make tardist, make dist, make | |
15117 | uutardist, make shdist, make zipdist, make ci | |
15118 | ||
6e76d345 JH |
15119 | =item Module Meta-Data |
15120 | ||
ee382f2f JH |
15121 | =item Disabling an extension |
15122 | ||
15123 | =item Other Handy Functions | |
15124 | ||
15125 | prompt | |
15126 | ||
15127 | =back | |
15128 | ||
15129 | =item ENVIRONMENT | |
15130 | ||
b40eed9c | 15131 | PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE |
ee382f2f JH |
15132 | |
15133 | =item SEE ALSO | |
15134 | ||
15135 | =item AUTHORS | |
15136 | ||
15137 | =item LICENSE | |
15138 | ||
15139 | =back | |
15140 | ||
b40eed9c NC |
15141 | =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm |
15142 | ||
15143 | =over 4 | |
15144 | ||
15145 | =item SYNOPSIS | |
15146 | ||
15147 | =item DESCRIPTION | |
15148 | ||
15149 | =back | |
15150 | ||
ee382f2f JH |
15151 | =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About |
15152 | MakeMaker | |
15153 | ||
15154 | =over 4 | |
15155 | ||
15156 | =item DESCRIPTION | |
15157 | ||
15158 | =over 4 | |
15159 | ||
b40eed9c NC |
15160 | =item Module Installation |
15161 | ||
15162 | How do I keep from installing man pages?, How do I use a module without | |
15163 | installing it? | |
15164 | ||
ee382f2f JH |
15165 | =item Philosophy and History |
15166 | ||
b40eed9c | 15167 | Why not just use <insert other build config tool here>?, What is |
ee382f2f JH |
15168 | Module::Build and how does it relate to MakeMaker?, pure perl. no make, no |
15169 | shell commands, easier to customize, cleaner internals, less cruft | |
15170 | ||
1184f6df JH |
15171 | =item Module Writing |
15172 | ||
73fba812 JH |
15173 | How do I keep my $VERSION up to date without resetting it manually?, What's |
15174 | this F<META.yml> thing and how did it get in my F<MANIFEST>?! | |
15175 | ||
ee382f2f JH |
15176 | =item XS |
15177 | ||
73fba812 JH |
15178 | How to I prevent "object version X.XX does not match bootstrap parameter |
15179 | Y.YY" errors?, How do I make two or more XS files coexist in the same | |
15180 | directory? | |
15181 | ||
ee382f2f JH |
15182 | =back |
15183 | ||
15184 | =item PATCHING | |
15185 | ||
15186 | =item AUTHOR | |
15187 | ||
15188 | =item SEE ALSO | |
15189 | ||
15190 | =back | |
15191 | ||
15192 | =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker | |
15193 | ||
15194 | =over 4 | |
15195 | ||
15196 | =item SYNOPSIS | |
15197 | ||
15198 | =item DESCRIPTION | |
15199 | ||
15200 | =over 4 | |
15201 | ||
15202 | =item The Mantra | |
15203 | ||
15204 | =item The Layout | |
15205 | ||
15206 | Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, | |
15207 | bin/ | |
15208 | ||
15209 | =back | |
15210 | ||
15211 | =item SEE ALSO | |
15212 | ||
15213 | =back | |
15214 | ||
b40eed9c | 15215 | =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm |
1184f6df JH |
15216 | |
15217 | =over 4 | |
15218 | ||
15219 | =item SYNOPSIS | |
15220 | ||
15221 | =item DESCRIPTION | |
15222 | ||
15223 | =back | |
15224 | ||
b40eed9c | 15225 | =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm |
ee382f2f JH |
15226 | |
15227 | =over 4 | |
15228 | ||
15229 | =item SYNOPSIS | |
15230 | ||
15231 | =item DESCRIPTION | |
15232 | ||
15233 | =back | |
15234 | ||
15235 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file | |
15236 | ||
15237 | =over 4 | |
15238 | ||
15239 | =item SYNOPSIS | |
15240 | ||
15241 | =item DESCRIPTION | |
15242 | ||
15243 | =over 4 | |
15244 | ||
15245 | =item Functions | |
15246 | ||
15247 | mkmanifest | |
15248 | ||
15249 | =back | |
15250 | ||
15251 | =back | |
15252 | ||
15253 | manifind | |
15254 | ||
15255 | manicheck | |
15256 | ||
15257 | filecheck | |
15258 | ||
15259 | fullcheck | |
15260 | ||
15261 | skipcheck | |
15262 | ||
15263 | maniread | |
15264 | ||
15265 | manicopy | |
15266 | ||
15267 | maniadd | |
15268 | ||
15269 | =over 4 | |
15270 | ||
15271 | =item MANIFEST | |
15272 | ||
15273 | =item MANIFEST.SKIP | |
15274 | ||
15275 | =item EXPORT_OK | |
15276 | ||
15277 | =item GLOBAL VARIABLES | |
15278 | ||
15279 | =back | |
15280 | ||
15281 | =over 4 | |
15282 | ||
15283 | =item DIAGNOSTICS | |
15284 | ||
15285 | C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>, | |
15286 | C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file> | |
15287 | ||
15288 | =item ENVIRONMENT | |
15289 | ||
15290 | B<PERL_MM_MANIFEST_DEBUG> | |
15291 | ||
15292 | =item SEE ALSO | |
15293 | ||
15294 | =item AUTHOR | |
15295 | ||
15296 | =back | |
15297 | ||
91e033c7 NC |
15298 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c |
15299 | ||
15300 | =over 4 | |
15301 | ||
15302 | =item SYNOPSIS | |
15303 | ||
15304 | =item DESCRIPTION | |
15305 | ||
15306 | =item SEE ALSO | |
15307 | ||
15308 | =back | |
15309 | ||
ee382f2f JH |
15310 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader |
15311 | ||
15312 | =over 4 | |
15313 | ||
15314 | =item SYNOPSIS | |
15315 | ||
15316 | =item DESCRIPTION | |
15317 | ||
15318 | =back | |
15319 | ||
15320 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
15321 | extension | |
15322 | ||
15323 | =over 4 | |
15324 | ||
15325 | =item SYNOPSIS | |
15326 | ||
15327 | =item DESCRIPTION | |
15328 | ||
15329 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
15330 | ||
15331 | =item AUTHOR | |
15332 | ||
15333 | =item REVISION | |
15334 | ||
15335 | =back | |
15336 | ||
15337 | =head2 ExtUtils::Packlist - manage .packlist files | |
15338 | ||
15339 | =over 4 | |
15340 | ||
15341 | =item SYNOPSIS | |
15342 | ||
15343 | =item DESCRIPTION | |
15344 | ||
15345 | =item USAGE | |
15346 | ||
15347 | =item FUNCTIONS | |
15348 | ||
15349 | new(), read(), write(), validate(), packlist_file() | |
15350 | ||
15351 | =item EXAMPLE | |
15352 | ||
15353 | =item AUTHOR | |
15354 | ||
15355 | =back | |
15356 | ||
15357 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
15358 | ||
15359 | =over 4 | |
15360 | ||
15361 | =item SYNOPSIS | |
15362 | ||
15363 | =item DESCRIPTION | |
15364 | ||
15365 | =back | |
15366 | ||
15367 | =head2 Fatal - replace functions with equivalents which succeed or die | |
15368 | ||
15369 | =over 4 | |
15370 | ||
15371 | =item SYNOPSIS | |
15372 | ||
15373 | =item DESCRIPTION | |
15374 | ||
15375 | =item AUTHOR | |
15376 | ||
15377 | =back | |
15378 | ||
15379 | =head2 Fcntl - load the C Fcntl.h defines | |
15380 | ||
15381 | =over 4 | |
15382 | ||
15383 | =item SYNOPSIS | |
15384 | ||
15385 | =item DESCRIPTION | |
15386 | ||
15387 | =item NOTE | |
15388 | ||
15389 | =item EXPORTED SYMBOLS | |
15390 | ||
15391 | =back | |
15392 | ||
b40eed9c NC |
15393 | =head2 File::Basename - Parse file paths into directory, filename and |
15394 | suffix. | |
ee382f2f JH |
15395 | |
15396 | =over 4 | |
15397 | ||
15398 | =item SYNOPSIS | |
15399 | ||
15400 | =item DESCRIPTION | |
15401 | ||
b40eed9c | 15402 | =back |
ee382f2f | 15403 | |
b40eed9c NC |
15404 | C<fileparse> |
15405 | ||
15406 | C<basename> | |
15407 | ||
15408 | C<dirname> | |
15409 | ||
15410 | C<fileparse_set_fstype> | |
15411 | ||
15412 | =over 4 | |
ee382f2f | 15413 | |
b40eed9c | 15414 | =item SEE ALSO |
ee382f2f JH |
15415 | |
15416 | =back | |
15417 | ||
15418 | =head2 File::CheckTree, validate - run many filetest checks on a tree | |
15419 | ||
15420 | =over 4 | |
15421 | ||
15422 | =item SYNOPSIS | |
15423 | ||
15424 | =item DESCRIPTION | |
15425 | ||
15426 | =item AUTHOR | |
15427 | ||
15428 | =item HISTORY | |
15429 | ||
15430 | =back | |
15431 | ||
15432 | =head2 File::Compare - Compare files or filehandles | |
15433 | ||
15434 | =over 4 | |
15435 | ||
15436 | =item SYNOPSIS | |
15437 | ||
15438 | =item DESCRIPTION | |
15439 | ||
15440 | =item RETURN | |
15441 | ||
15442 | =item AUTHOR | |
15443 | ||
15444 | =back | |
15445 | ||
15446 | =head2 File::Copy - Copy files or filehandles | |
15447 | ||
15448 | =over 4 | |
15449 | ||
15450 | =item SYNOPSIS | |
15451 | ||
15452 | =item DESCRIPTION | |
15453 | ||
15454 | =over 4 | |
15455 | ||
15456 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) | |
15457 | ||
15458 | rmscopy($from,$to[,$date_flag]) | |
15459 | ||
15460 | =back | |
15461 | ||
15462 | =item RETURN | |
15463 | ||
15464 | =item NOTES | |
15465 | ||
15466 | =item AUTHOR | |
15467 | ||
15468 | =back | |
15469 | ||
15470 | =head2 File::DosGlob - DOS like globbing and then some | |
15471 | ||
15472 | =over 4 | |
15473 | ||
15474 | =item SYNOPSIS | |
15475 | ||
15476 | =item DESCRIPTION | |
15477 | ||
15478 | =item NOTES | |
15479 | ||
15480 | =item EXPORTS (by request only) | |
15481 | ||
15482 | =item BUGS | |
15483 | ||
15484 | =item AUTHOR | |
15485 | ||
15486 | =item HISTORY | |
15487 | ||
15488 | =item SEE ALSO | |
15489 | ||
15490 | =back | |
15491 | ||
15492 | =head2 File::Find - Traverse a directory tree. | |
15493 | ||
15494 | =over 4 | |
15495 | ||
15496 | =item SYNOPSIS | |
15497 | ||
15498 | =item DESCRIPTION | |
15499 | ||
15500 | B<find>, B<finddepth> | |
15501 | ||
15502 | =over 4 | |
15503 | ||
15504 | =item %options | |
15505 | ||
15506 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, | |
15507 | C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>, | |
15508 | C<untaint>, C<untaint_pattern>, C<untaint_skip> | |
15509 | ||
15510 | =item The wanted function | |
15511 | ||
15512 | C<$File::Find::dir> is the current directory name,, C<$_> is the current | |
15513 | filename within that directory, C<$File::Find::name> is the complete | |
15514 | pathname to the file | |
15515 | ||
15516 | =back | |
15517 | ||
15518 | =item WARNINGS | |
15519 | ||
15520 | =item CAVEAT | |
15521 | ||
15522 | $dont_use_nlink, symlinks | |
15523 | ||
15524 | =item NOTES | |
15525 | ||
7f106169 NC |
15526 | =item BUGS AND CAVEATS |
15527 | ||
ee382f2f JH |
15528 | =item HISTORY |
15529 | ||
15530 | =back | |
15531 | ||
15532 | =head2 File::Glob - Perl extension for BSD glob routine | |
15533 | ||
15534 | =over 4 | |
15535 | ||
15536 | =item SYNOPSIS | |
15537 | ||
15538 | =item DESCRIPTION | |
15539 | ||
b2a9ae16 NC |
15540 | =over 4 |
15541 | ||
15542 | =item META CHARACTERS | |
15543 | ||
15544 | =item POSIX FLAGS | |
15545 | ||
ee382f2f JH |
15546 | C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, |
15547 | C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, | |
15548 | C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT> | |
15549 | ||
b2a9ae16 NC |
15550 | =back |
15551 | ||
ee382f2f JH |
15552 | =item DIAGNOSTICS |
15553 | ||
15554 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
15555 | ||
15556 | =item NOTES | |
15557 | ||
b2a9ae16 NC |
15558 | =item SEE ALSO |
15559 | ||
ee382f2f JH |
15560 | =item AUTHOR |
15561 | ||
15562 | =back | |
15563 | ||
15564 | =head2 File::Path - create or remove directory trees | |
15565 | ||
15566 | =over 4 | |
15567 | ||
15568 | =item SYNOPSIS | |
15569 | ||
15570 | =item DESCRIPTION | |
15571 | ||
1184f6df JH |
15572 | =item DIAGNOSTICS |
15573 | ||
ee382f2f JH |
15574 | =item AUTHORS |
15575 | ||
15576 | =back | |
15577 | ||
15578 | =head2 File::Spec - portably perform operations on file names | |
15579 | ||
15580 | =over 4 | |
15581 | ||
15582 | =item SYNOPSIS | |
15583 | ||
15584 | =item DESCRIPTION | |
15585 | ||
15586 | =item METHODS | |
15587 | ||
15588 | canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir, | |
15589 | no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath, | |
15590 | splitdir, catpath(), abs2rel, rel2abs() | |
15591 | ||
15592 | =item SEE ALSO | |
15593 | ||
a2db77eb | 15594 | =item AUTHOR |
ee382f2f | 15595 | |
b2a9ae16 NC |
15596 | =item COPYRIGHT |
15597 | ||
ee382f2f JH |
15598 | =back |
15599 | ||
15600 | =head2 File::Spec::Cygwin - methods for Cygwin file specs | |
15601 | ||
15602 | =over 4 | |
15603 | ||
15604 | =item SYNOPSIS | |
15605 | ||
15606 | =item DESCRIPTION | |
15607 | ||
15608 | =back | |
15609 | ||
15610 | canonpath | |
15611 | ||
15612 | file_name_is_absolute | |
15613 | ||
15614 | tmpdir (override) | |
15615 | ||
b2a9ae16 NC |
15616 | =over 4 |
15617 | ||
15618 | =item COPYRIGHT | |
15619 | ||
15620 | =back | |
15621 | ||
ee382f2f JH |
15622 | =head2 File::Spec::Epoc - methods for Epoc file specs |
15623 | ||
15624 | =over 4 | |
15625 | ||
15626 | =item SYNOPSIS | |
15627 | ||
15628 | =item DESCRIPTION | |
15629 | ||
ee382f2f JH |
15630 | =back |
15631 | ||
73fba812 JH |
15632 | canonpath() |
15633 | ||
ee382f2f JH |
15634 | =over 4 |
15635 | ||
b2a9ae16 NC |
15636 | =item AUTHOR |
15637 | ||
15638 | =item COPYRIGHT | |
15639 | ||
ee382f2f JH |
15640 | =item SEE ALSO |
15641 | ||
15642 | =back | |
15643 | ||
15644 | =head2 File::Spec::Functions - portably perform operations on file names | |
15645 | ||
15646 | =over 4 | |
15647 | ||
15648 | =item SYNOPSIS | |
15649 | ||
15650 | =item DESCRIPTION | |
15651 | ||
15652 | =over 4 | |
15653 | ||
15654 | =item Exports | |
15655 | ||
15656 | =back | |
15657 | ||
b2a9ae16 NC |
15658 | =item COPYRIGHT |
15659 | ||
ee382f2f JH |
15660 | =item SEE ALSO |
15661 | ||
15662 | =back | |
15663 | ||
15664 | =head2 File::Spec::Mac - File::Spec for Mac OS (Classic) | |
15665 | ||
15666 | =over 4 | |
15667 | ||
15668 | =item SYNOPSIS | |
15669 | ||
15670 | =item DESCRIPTION | |
15671 | ||
15672 | =item METHODS | |
15673 | ||
15674 | canonpath | |
15675 | ||
15676 | =back | |
15677 | ||
15678 | catdir() | |
15679 | ||
15680 | catfile | |
15681 | ||
15682 | curdir | |
15683 | ||
15684 | devnull | |
15685 | ||
15686 | rootdir | |
15687 | ||
15688 | tmpdir | |
15689 | ||
15690 | updir | |
15691 | ||
15692 | file_name_is_absolute | |
15693 | ||
15694 | path | |
15695 | ||
15696 | splitpath | |
15697 | ||
15698 | splitdir | |
15699 | ||
15700 | catpath | |
15701 | ||
15702 | abs2rel | |
15703 | ||
15704 | rel2abs | |
15705 | ||
15706 | =over 4 | |
15707 | ||
15708 | =item AUTHORS | |
15709 | ||
b2a9ae16 NC |
15710 | =item COPYRIGHT |
15711 | ||
ee382f2f JH |
15712 | =item SEE ALSO |
15713 | ||
15714 | =back | |
15715 | ||
ee382f2f JH |
15716 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
15717 | ||
15718 | =over 4 | |
15719 | ||
15720 | =item SYNOPSIS | |
15721 | ||
15722 | =item DESCRIPTION | |
15723 | ||
7ba761b0 JH |
15724 | tmpdir, splitpath |
15725 | ||
b2a9ae16 NC |
15726 | =item COPYRIGHT |
15727 | ||
ee382f2f JH |
15728 | =back |
15729 | ||
15730 | =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec | |
15731 | modules | |
15732 | ||
15733 | =over 4 | |
15734 | ||
15735 | =item SYNOPSIS | |
15736 | ||
15737 | =item DESCRIPTION | |
15738 | ||
15739 | =item METHODS | |
15740 | ||
15741 | canonpath() | |
15742 | ||
15743 | =back | |
15744 | ||
15745 | catdir() | |
15746 | ||
15747 | catfile | |
15748 | ||
15749 | curdir | |
15750 | ||
15751 | devnull | |
15752 | ||
15753 | rootdir | |
15754 | ||
15755 | tmpdir | |
15756 | ||
15757 | updir | |
15758 | ||
15759 | no_upwards | |
15760 | ||
15761 | case_tolerant | |
15762 | ||
15763 | file_name_is_absolute | |
15764 | ||
15765 | path | |
15766 | ||
15767 | join | |
15768 | ||
15769 | splitpath | |
15770 | ||
15771 | splitdir | |
15772 | ||
15773 | catpath() | |
15774 | ||
15775 | abs2rel | |
15776 | ||
15777 | rel2abs() | |
15778 | ||
15779 | =over 4 | |
15780 | ||
b2a9ae16 NC |
15781 | =item COPYRIGHT |
15782 | ||
ee382f2f JH |
15783 | =item SEE ALSO |
15784 | ||
15785 | =back | |
15786 | ||
15787 | =head2 File::Spec::VMS - methods for VMS file specs | |
15788 | ||
15789 | =over 4 | |
15790 | ||
15791 | =item SYNOPSIS | |
15792 | ||
15793 | =item DESCRIPTION | |
15794 | ||
ee382f2f JH |
15795 | canonpath (override) |
15796 | ||
15797 | =back | |
15798 | ||
b40eed9c | 15799 | catdir (override) |
ee382f2f | 15800 | |
b40eed9c | 15801 | catfile (override) |
ee382f2f JH |
15802 | |
15803 | curdir (override) | |
15804 | ||
15805 | devnull (override) | |
15806 | ||
15807 | rootdir (override) | |
15808 | ||
15809 | tmpdir (override) | |
15810 | ||
15811 | updir (override) | |
15812 | ||
15813 | case_tolerant (override) | |
15814 | ||
15815 | path (override) | |
15816 | ||
15817 | file_name_is_absolute (override) | |
15818 | ||
15819 | splitpath (override) | |
15820 | ||
15821 | splitdir (override) | |
15822 | ||
15823 | catpath (override) | |
15824 | ||
15825 | abs2rel (override) | |
15826 | ||
15827 | rel2abs (override) | |
15828 | ||
15829 | =over 4 | |
15830 | ||
b2a9ae16 NC |
15831 | =item COPYRIGHT |
15832 | ||
ee382f2f JH |
15833 | =item SEE ALSO |
15834 | ||
15835 | =back | |
15836 | ||
15837 | =head2 File::Spec::Win32 - methods for Win32 file specs | |
15838 | ||
15839 | =over 4 | |
15840 | ||
15841 | =item SYNOPSIS | |
15842 | ||
15843 | =item DESCRIPTION | |
15844 | ||
15845 | devnull | |
15846 | ||
15847 | =back | |
15848 | ||
15849 | tmpdir | |
15850 | ||
15851 | catfile | |
15852 | ||
15853 | canonpath | |
15854 | ||
15855 | splitpath | |
15856 | ||
15857 | splitdir | |
15858 | ||
15859 | catpath | |
15860 | ||
15861 | =over 4 | |
15862 | ||
15863 | =item Note For File::Spec::Win32 Maintainers | |
15864 | ||
15865 | =back | |
15866 | ||
15867 | =over 4 | |
15868 | ||
b2a9ae16 NC |
15869 | =item COPYRIGHT |
15870 | ||
ee382f2f JH |
15871 | =item SEE ALSO |
15872 | ||
15873 | =back | |
15874 | ||
15875 | =head2 File::Temp - return name and handle of a temporary file safely | |
15876 | ||
15877 | =over 4 | |
15878 | ||
15879 | =item PORTABILITY | |
15880 | ||
15881 | =item SYNOPSIS | |
15882 | ||
15883 | =item DESCRIPTION | |
15884 | ||
15885 | =back | |
15886 | ||
15887 | =over 4 | |
15888 | ||
b2a9ae16 | 15889 | =item OBJECT-ORIENTED INTERFACE |
4ed3c8ae JH |
15890 | |
15891 | B<new> | |
15892 | ||
15893 | =back | |
15894 | ||
15895 | B<filename> | |
15896 | ||
b2a9ae16 NC |
15897 | B<unlink_on_destroy> |
15898 | ||
4ed3c8ae JH |
15899 | B<DESTROY> |
15900 | ||
15901 | =over 4 | |
15902 | ||
ee382f2f JH |
15903 | =item FUNCTIONS |
15904 | ||
15905 | B<tempfile> | |
15906 | ||
15907 | =back | |
15908 | ||
15909 | B<tempdir> | |
15910 | ||
15911 | =over 4 | |
15912 | ||
15913 | =item MKTEMP FUNCTIONS | |
15914 | ||
15915 | B<mkstemp> | |
15916 | ||
15917 | =back | |
15918 | ||
15919 | B<mkstemps> | |
15920 | ||
15921 | B<mkdtemp> | |
15922 | ||
15923 | B<mktemp> | |
15924 | ||
15925 | =over 4 | |
15926 | ||
15927 | =item POSIX FUNCTIONS | |
15928 | ||
15929 | B<tmpnam> | |
15930 | ||
15931 | =back | |
15932 | ||
15933 | B<tmpfile> | |
15934 | ||
15935 | =over 4 | |
15936 | ||
15937 | =item ADDITIONAL FUNCTIONS | |
15938 | ||
15939 | B<tempnam> | |
15940 | ||
15941 | =back | |
15942 | ||
15943 | =over 4 | |
15944 | ||
15945 | =item UTILITY FUNCTIONS | |
15946 | ||
15947 | B<unlink0> | |
15948 | ||
15949 | =back | |
15950 | ||
4ed3c8ae JH |
15951 | B<cmpstat> |
15952 | ||
15953 | B<unlink1> | |
15954 | ||
b2a9ae16 NC |
15955 | B<cleanup> |
15956 | ||
ee382f2f JH |
15957 | =over 4 |
15958 | ||
15959 | =item PACKAGE VARIABLES | |
15960 | ||
15961 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
15962 | ||
15963 | =back | |
15964 | ||
15965 | TopSystemUID | |
15966 | ||
b2a9ae16 NC |
15967 | B<$KEEP_ALL>, B<$DEBUG> |
15968 | ||
ee382f2f JH |
15969 | =over 4 |
15970 | ||
15971 | =item WARNING | |
15972 | ||
15973 | =over 4 | |
15974 | ||
15975 | =item Temporary files and NFS | |
15976 | ||
b2a9ae16 NC |
15977 | =item Forking |
15978 | ||
15979 | =item BINMODE | |
15980 | ||
ee382f2f JH |
15981 | =back |
15982 | ||
15983 | =item HISTORY | |
15984 | ||
15985 | =item SEE ALSO | |
15986 | ||
15987 | =item AUTHOR | |
15988 | ||
15989 | =back | |
15990 | ||
15991 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
15992 | ||
15993 | =over 4 | |
15994 | ||
15995 | =item SYNOPSIS | |
15996 | ||
15997 | =item DESCRIPTION | |
15998 | ||
15999 | =item BUGS | |
16000 | ||
16001 | =item NOTE | |
16002 | ||
16003 | =item AUTHOR | |
16004 | ||
16005 | =back | |
16006 | ||
16007 | =head2 FileCache - keep more files open than the system permits | |
16008 | ||
16009 | =over 4 | |
16010 | ||
16011 | =item SYNOPSIS | |
16012 | ||
16013 | =item DESCRIPTION | |
16014 | ||
16015 | cacheout EXPR, cacheout MODE, EXPR | |
16016 | ||
16017 | =item CAVEATS | |
16018 | ||
16019 | =item BUGS | |
16020 | ||
16021 | =back | |
16022 | ||
16023 | =head2 FileHandle - supply object methods for filehandles | |
16024 | ||
16025 | =over 4 | |
16026 | ||
16027 | =item SYNOPSIS | |
16028 | ||
16029 | =item DESCRIPTION | |
16030 | ||
16031 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
16032 | ||
16033 | =item SEE ALSO | |
16034 | ||
16035 | =back | |
16036 | ||
16037 | =head2 Filter::Simple - Simplified source filtering | |
16038 | ||
16039 | =over 4 | |
16040 | ||
16041 | =item SYNOPSIS | |
16042 | ||
16043 | =item DESCRIPTION | |
16044 | ||
16045 | =over 4 | |
16046 | ||
16047 | =item The Problem | |
16048 | ||
16049 | =item A Solution | |
16050 | ||
16051 | =item Disabling or changing <no> behaviour | |
16052 | ||
16053 | =item All-in-one interface | |
16054 | ||
16055 | =item Filtering only specific components of source code | |
16056 | ||
b40eed9c NC |
16057 | C<"code">, C<"code_no_comments">, C<"executable">, |
16058 | C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">, | |
ee382f2f JH |
16059 | C<"all"> |
16060 | ||
16061 | =item Filtering only the code parts of source code | |
16062 | ||
16063 | Most source code ceases to be grammatically correct when it is broken up | |
16064 | into the pieces between string literals and regexes. So the C<'code'> | |
b40eed9c NC |
16065 | and C<'code_no_comments'> component filter behave slightly differently |
16066 | from the other partial filters described in the previous section. | |
ee382f2f JH |
16067 | |
16068 | =item Using Filter::Simple with an explicit C<import> subroutine | |
16069 | ||
16070 | =item Using Filter::Simple and Exporter together | |
16071 | ||
16072 | =item How it works | |
16073 | ||
16074 | =back | |
16075 | ||
16076 | =item AUTHOR | |
16077 | ||
16078 | =item COPYRIGHT | |
16079 | ||
16080 | =back | |
16081 | ||
16082 | =head2 Filter::Util::Call - Perl Source Filter Utility Module | |
16083 | ||
16084 | =over 4 | |
16085 | ||
16086 | =item SYNOPSIS | |
16087 | ||
16088 | =item DESCRIPTION | |
16089 | ||
16090 | =over 4 | |
16091 | ||
16092 | =item B<use Filter::Util::Call> | |
16093 | ||
16094 | =item B<import()> | |
16095 | ||
16096 | =item B<filter() and anonymous sub> | |
16097 | ||
16098 | B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del> | |
16099 | ||
16100 | =back | |
16101 | ||
16102 | =item EXAMPLES | |
16103 | ||
16104 | =over 4 | |
16105 | ||
16106 | =item Example 1: A simple filter. | |
16107 | ||
16108 | =item Example 2: Using the context | |
16109 | ||
16110 | =item Example 3: Using the context within the filter | |
16111 | ||
16112 | =item Example 4: Using filter_del | |
16113 | ||
16114 | =back | |
16115 | ||
16116 | =item Filter::Simple | |
16117 | ||
16118 | =item AUTHOR | |
16119 | ||
16120 | =item DATE | |
16121 | ||
16122 | =back | |
16123 | ||
16124 | =head2 FindBin - Locate directory of original perl script | |
16125 | ||
16126 | =over 4 | |
16127 | ||
16128 | =item SYNOPSIS | |
16129 | ||
16130 | =item DESCRIPTION | |
16131 | ||
16132 | =item EXPORTABLE VARIABLES | |
16133 | ||
16134 | =item KNOWN ISSUES | |
16135 | ||
16136 | =item KNOWN BUGS | |
16137 | ||
16138 | =item AUTHORS | |
16139 | ||
16140 | =item COPYRIGHT | |
16141 | ||
16142 | =back | |
16143 | ||
16144 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
16145 | ||
16146 | =over 4 | |
16147 | ||
16148 | =item SYNOPSIS | |
16149 | ||
16150 | =item DESCRIPTION | |
16151 | ||
16152 | =item AVAILABILITY | |
16153 | ||
16154 | =item BUGS | |
16155 | ||
16156 | =item SEE ALSO | |
16157 | ||
16158 | =back | |
16159 | ||
16160 | =head2 Getopt::Long - Extended processing of command line options | |
16161 | ||
16162 | =over 4 | |
16163 | ||
16164 | =item SYNOPSIS | |
16165 | ||
16166 | =item DESCRIPTION | |
16167 | ||
16168 | =item Command Line Options, an Introduction | |
16169 | ||
16170 | =item Getting Started with Getopt::Long | |
16171 | ||
16172 | =over 4 | |
16173 | ||
16174 | =item Simple options | |
16175 | ||
16176 | =item A little bit less simple options | |
16177 | ||
16178 | =item Mixing command line option with other arguments | |
16179 | ||
16180 | =item Options with values | |
16181 | ||
16182 | =item Options with multiple values | |
16183 | ||
16184 | =item Options with hash values | |
16185 | ||
16186 | =item User-defined subroutines to handle options | |
16187 | ||
16188 | =item Options with multiple names | |
16189 | ||
16190 | =item Case and abbreviations | |
16191 | ||
16192 | =item Summary of Option Specifications | |
16193 | ||
16194 | !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], : | |
16195 | + [ I<desttype> ] | |
16196 | ||
16197 | =back | |
16198 | ||
16199 | =item Advanced Possibilities | |
16200 | ||
16201 | =over 4 | |
16202 | ||
16203 | =item Object oriented interface | |
16204 | ||
16205 | =item Thread Safety | |
16206 | ||
16207 | =item Documentation and help texts | |
16208 | ||
b40eed9c | 16209 | =item Storing option values in a hash |
ee382f2f JH |
16210 | |
16211 | =item Bundling | |
16212 | ||
16213 | =item The lonesome dash | |
16214 | ||
16215 | =item Argument callback | |
16216 | ||
16217 | =back | |
16218 | ||
16219 | =item Configuring Getopt::Long | |
16220 | ||
16221 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, | |
16222 | require_order, permute, bundling (default: disabled), bundling_override | |
16223 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
1184f6df JH |
16224 | (default: disabled), auto_version (default:disabled), auto_help |
16225 | (default:disabled), pass_through (default: disabled), prefix, | |
b40eed9c | 16226 | prefix_pattern, long_prefix_pattern, debug (default: disabled) |
ee382f2f | 16227 | |
1184f6df JH |
16228 | =item Exportable Methods |
16229 | ||
16230 | VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage | |
16231 | ||
ee382f2f JH |
16232 | =item Return values and Errors |
16233 | ||
16234 | =item Legacy | |
16235 | ||
16236 | =over 4 | |
16237 | ||
16238 | =item Default destinations | |
16239 | ||
16240 | =item Alternative option starters | |
16241 | ||
16242 | =item Configuration variables | |
16243 | ||
16244 | =back | |
16245 | ||
16246 | =item Trouble Shooting | |
16247 | ||
16248 | =over 4 | |
16249 | ||
ee382f2f JH |
16250 | =item GetOptions does not return a false result when an option is not |
16251 | supplied | |
16252 | ||
16253 | =item GetOptions does not split the command line correctly | |
16254 | ||
1184f6df JH |
16255 | =item Undefined subroutine &main::GetOptions called |
16256 | ||
ee382f2f JH |
16257 | =item How do I put a "-?" option into a Getopt::Long? |
16258 | ||
16259 | =back | |
16260 | ||
16261 | =item AUTHOR | |
16262 | ||
16263 | =item COPYRIGHT AND DISCLAIMER | |
16264 | ||
16265 | =back | |
16266 | ||
7a5cdbdf AJ |
16267 | =head2 Getopt::Std, getopt, getopts - Process single-character switches |
16268 | with switch clustering | |
ee382f2f JH |
16269 | |
16270 | =over 4 | |
16271 | ||
16272 | =item SYNOPSIS | |
16273 | ||
16274 | =item DESCRIPTION | |
16275 | ||
16276 | =item C<--help> and C<--version> | |
16277 | ||
16278 | =back | |
16279 | ||
16280 | =head2 Hash::Util - A selection of general-utility hash subroutines | |
16281 | ||
16282 | =over 4 | |
16283 | ||
16284 | =item SYNOPSIS | |
16285 | ||
16286 | =item DESCRIPTION | |
16287 | ||
16288 | =over 4 | |
16289 | ||
16290 | =item Restricted hashes | |
16291 | ||
16292 | lock_keys, unlock_keys | |
16293 | ||
16294 | =back | |
16295 | ||
16296 | =back | |
16297 | ||
16298 | lock_value, unlock_value | |
16299 | ||
16300 | B<lock_hash>, B<unlock_hash> | |
16301 | ||
cd458e05 JH |
16302 | B<hash_seed> |
16303 | ||
ee382f2f JH |
16304 | =over 4 |
16305 | ||
16306 | =item CAVEATS | |
16307 | ||
16308 | =item AUTHOR | |
16309 | ||
16310 | =item SEE ALSO | |
16311 | ||
16312 | =back | |
16313 | ||
16314 | =head2 I18N::Collate - compare 8-bit scalar data according to the current | |
16315 | locale | |
16316 | ||
16317 | =over 4 | |
16318 | ||
16319 | =item SYNOPSIS | |
16320 | ||
16321 | =item DESCRIPTION | |
16322 | ||
16323 | =back | |
16324 | ||
16325 | =head2 I18N::LangTags - functions for dealing with RFC3066-style language | |
16326 | tags | |
16327 | ||
16328 | =over 4 | |
16329 | ||
16330 | =item SYNOPSIS | |
16331 | ||
16332 | =item DESCRIPTION | |
16333 | ||
16334 | =back | |
16335 | ||
16336 | the function is_language_tag($lang1) | |
16337 | ||
16338 | the function extract_language_tags($whatever) | |
16339 | ||
16340 | the function same_language_tag($lang1, $lang2) | |
16341 | ||
16342 | the function similarity_language_tag($lang1, $lang2) | |
16343 | ||
16344 | the function is_dialect_of($lang1, $lang2) | |
16345 | ||
16346 | the function super_languages($lang1) | |
16347 | ||
16348 | the function locale2language_tag($locale_identifier) | |
16349 | ||
16350 | the function encode_language_tag($lang1) | |
16351 | ||
16352 | the function alternate_language_tags($lang1) | |
16353 | ||
16354 | the function @langs = panic_languages(@accept_languages) | |
16355 | ||
d3ca9f77 NC |
16356 | the function implicate_supers( ...languages... ), the function |
16357 | implicate_supers_strictly( ...languages... ) | |
16358 | ||
ee382f2f JH |
16359 | =over 4 |
16360 | ||
16361 | =item ABOUT LOWERCASING | |
16362 | ||
16363 | =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS | |
16364 | ||
16365 | =item SEE ALSO | |
16366 | ||
16367 | =item COPYRIGHT | |
16368 | ||
16369 | =item AUTHOR | |
16370 | ||
16371 | =back | |
16372 | ||
d3ca9f77 NC |
16373 | =head2 I18N::LangTags::Detect - detect the user's language preferences |
16374 | ||
16375 | =over 4 | |
16376 | ||
16377 | =item SYNOPSIS | |
16378 | ||
16379 | =item DESCRIPTION | |
16380 | ||
16381 | =item FUNCTIONS | |
16382 | ||
16383 | =item ENVIRONMENT | |
16384 | ||
16385 | =item SEE ALSO | |
16386 | ||
16387 | =item COPYRIGHT | |
16388 | ||
16389 | =item AUTHOR | |
16390 | ||
16391 | =back | |
16392 | ||
ee382f2f JH |
16393 | =head2 I18N::LangTags::List -- tags and names for human languages |
16394 | ||
16395 | =over 4 | |
16396 | ||
16397 | =item SYNOPSIS | |
16398 | ||
16399 | =item DESCRIPTION | |
16400 | ||
16401 | =item ABOUT LANGUAGE TAGS | |
16402 | ||
16403 | =item LIST OF LANGUAGES | |
16404 | ||
73fba812 JH |
16405 | {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : |
16406 | Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : | |
16407 | Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, | |
16408 | {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], | |
16409 | {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, | |
16410 | {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} | |
16411 | : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : | |
16412 | Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : | |
16413 | Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} | |
16414 | : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : | |
16415 | Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} | |
16416 | : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : | |
16417 | Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : | |
16418 | Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber | |
16419 | (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, | |
16420 | {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : | |
16421 | Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : | |
16422 | Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian | |
16423 | (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central | |
16424 | American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], | |
16425 | {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} | |
16426 | : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : | |
16427 | Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : | |
16428 | Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, | |
16429 | {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} | |
16430 | : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based | |
16431 | Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : | |
16432 | Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : | |
16433 | Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) | |
16434 | Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, | |
16435 | {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, | |
16436 | {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} | |
16437 | : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : | |
16438 | English, {enm} : Old English (1100-1500), {ang} : Old English | |
16439 | (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : | |
16440 | Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} | |
16441 | : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : | |
16442 | Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French | |
16443 | (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : | |
16444 | Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, | |
16445 | {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, | |
16446 | {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High | |
16447 | German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} | |
16448 | : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient | |
16449 | Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : | |
16450 | Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, | |
ee382f2f JH |
16451 | {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : |
16452 | Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, | |
73fba812 JH |
16453 | {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, |
16454 | {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European | |
16455 | (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua | |
16456 | (International Auxiliary Language Association), {ie} : Interlingue, {iu} : | |
16457 | Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : | |
16458 | Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian | |
16459 | languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : | |
16460 | Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, | |
16461 | {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : | |
16462 | Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} | |
16463 | : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, | |
16464 | {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, | |
16465 | {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, | |
16466 | {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : | |
16467 | Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, | |
16468 | {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : | |
16469 | Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : | |
16470 | Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : | |
16471 | Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban | |
16472 | (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} | |
16473 | : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, | |
16474 | {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, | |
16475 | {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : | |
16476 | Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : | |
16477 | Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : | |
16478 | Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, | |
16479 | [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : | |
16480 | Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : | |
16481 | Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], | |
16482 | {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple | |
16483 | languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, | |
16484 | {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, | |
16485 | {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : | |
ee382f2f | 16486 | Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, |
73fba812 JH |
16487 | {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : |
16488 | Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : | |
16489 | Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} | |
16490 | : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : | |
16491 | Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian | |
ee382f2f JH |
16492 | languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : |
16493 | Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : | |
16494 | Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian | |
16495 | (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} | |
16496 | : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], | |
16497 | {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : | |
16498 | Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, | |
16499 | [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : | |
16500 | Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan | |
73fba812 JH |
16501 | languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : |
16502 | Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, | |
16503 | [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : | |
16504 | Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, | |
16505 | {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, | |
16506 | {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign | |
16507 | Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : | |
16508 | Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave | |
16509 | (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, | |
16510 | {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : | |
16511 | Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : | |
16512 | South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : | |
16513 | Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, | |
16514 | {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : | |
16515 | Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, | |
16516 | {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : | |
16517 | Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : | |
16518 | Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, | |
16519 | {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, | |
16520 | {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : | |
16521 | Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} | |
16522 | : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : | |
16523 | Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, | |
16524 | {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : | |
16525 | Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} | |
16526 | : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} | |
16527 | : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private | |
16528 | Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : | |
16529 | Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} | |
16530 | : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, | |
16531 | {zun} : Zuni | |
ee382f2f JH |
16532 | |
16533 | =item SEE ALSO | |
16534 | ||
16535 | =item COPYRIGHT AND DISCLAIMER | |
16536 | ||
16537 | =item AUTHOR | |
16538 | ||
16539 | =back | |
16540 | ||
16541 | =head2 I18N::Langinfo - query locale information | |
16542 | ||
16543 | =over 4 | |
16544 | ||
16545 | =item SYNOPSIS | |
16546 | ||
16547 | =item DESCRIPTION | |
16548 | ||
16549 | =over 4 | |
16550 | ||
16551 | =item EXPORT | |
16552 | ||
16553 | =back | |
16554 | ||
16555 | =item SEE ALSO | |
16556 | ||
16557 | =item AUTHOR | |
16558 | ||
16559 | =item COPYRIGHT AND LICENSE | |
16560 | ||
16561 | =back | |
16562 | ||
16563 | =head2 IO - load various IO modules | |
16564 | ||
16565 | =over 4 | |
16566 | ||
16567 | =item SYNOPSIS | |
16568 | ||
16569 | =item DESCRIPTION | |
16570 | ||
16571 | =item DEPRECATED | |
16572 | ||
16573 | =back | |
16574 | ||
16575 | =head2 IO::Dir - supply object methods for directory handles | |
16576 | ||
16577 | =over 4 | |
16578 | ||
16579 | =item SYNOPSIS | |
16580 | ||
16581 | =item DESCRIPTION | |
16582 | ||
16583 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
50e34432 | 16584 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] |
ee382f2f JH |
16585 | |
16586 | =item SEE ALSO | |
16587 | ||
16588 | =item AUTHOR | |
16589 | ||
16590 | =item COPYRIGHT | |
16591 | ||
16592 | =back | |
16593 | ||
16594 | =head2 IO::File - supply object methods for filehandles | |
16595 | ||
16596 | =over 4 | |
16597 | ||
16598 | =item SYNOPSIS | |
16599 | ||
16600 | =item DESCRIPTION | |
16601 | ||
16602 | =item CONSTRUCTOR | |
16603 | ||
16604 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
16605 | ||
16606 | =item METHODS | |
16607 | ||
a563e516 NC |
16608 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
16609 | [LAYER] ) | |
ee382f2f | 16610 | |
b2a9ae16 NC |
16611 | =item NOTE |
16612 | ||
ee382f2f JH |
16613 | =item SEE ALSO |
16614 | ||
16615 | =item HISTORY | |
16616 | ||
16617 | =back | |
16618 | ||
16619 | =head2 IO::Handle - supply object methods for I/O handles | |
16620 | ||
16621 | =over 4 | |
16622 | ||
16623 | =item SYNOPSIS | |
16624 | ||
16625 | =item DESCRIPTION | |
16626 | ||
16627 | =item CONSTRUCTOR | |
16628 | ||
16629 | new (), new_from_fd ( FD, MODE ) | |
16630 | ||
16631 | =item METHODS | |
16632 | ||
16633 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
16634 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
16635 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
16636 | $io->blocking ( [ BOOL ] ), $io->untaint | |
16637 | ||
16638 | =item NOTE | |
16639 | ||
16640 | =item SEE ALSO | |
16641 | ||
16642 | =item BUGS | |
16643 | ||
16644 | =item HISTORY | |
16645 | ||
16646 | =back | |
16647 | ||
16648 | =head2 IO::Pipe - supply object methods for pipes | |
16649 | ||
16650 | =over 4 | |
16651 | ||
16652 | =item SYNOPSIS | |
16653 | ||
16654 | =item DESCRIPTION | |
16655 | ||
16656 | =item CONSTRUCTOR | |
16657 | ||
16658 | new ( [READER, WRITER] ) | |
16659 | ||
16660 | =item METHODS | |
16661 | ||
16662 | reader ([ARGS]), writer ([ARGS]), handles () | |
16663 | ||
16664 | =item SEE ALSO | |
16665 | ||
16666 | =item AUTHOR | |
16667 | ||
16668 | =item COPYRIGHT | |
16669 | ||
16670 | =back | |
16671 | ||
16672 | =head2 IO::Poll - Object interface to system poll call | |
16673 | ||
16674 | =over 4 | |
16675 | ||
16676 | =item SYNOPSIS | |
16677 | ||
16678 | =item DESCRIPTION | |
16679 | ||
16680 | =item METHODS | |
16681 | ||
16682 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
16683 | IO ), handles( [ EVENT_MASK ] ) | |
16684 | ||
16685 | =item SEE ALSO | |
16686 | ||
16687 | =item AUTHOR | |
16688 | ||
16689 | =item COPYRIGHT | |
16690 | ||
16691 | =back | |
16692 | ||
16693 | =head2 IO::Seekable - supply seek based methods for I/O objects | |
16694 | ||
16695 | =over 4 | |
16696 | ||
16697 | =item SYNOPSIS | |
16698 | ||
16699 | =item DESCRIPTION | |
16700 | ||
16701 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), | |
16702 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
16703 | $io->tell | |
16704 | ||
16705 | =item SEE ALSO | |
16706 | ||
16707 | =item HISTORY | |
16708 | ||
16709 | =back | |
16710 | ||
16711 | =head2 IO::Select - OO interface to the select system call | |
16712 | ||
16713 | =over 4 | |
16714 | ||
16715 | =item SYNOPSIS | |
16716 | ||
16717 | =item DESCRIPTION | |
16718 | ||
16719 | =item CONSTRUCTOR | |
16720 | ||
16721 | new ( [ HANDLES ] ) | |
16722 | ||
16723 | =item METHODS | |
16724 | ||
16725 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
16726 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
16727 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) | |
16728 | ||
16729 | =item EXAMPLE | |
16730 | ||
16731 | =item AUTHOR | |
16732 | ||
16733 | =item COPYRIGHT | |
16734 | ||
16735 | =back | |
16736 | ||
16737 | =head2 IO::Socket - Object interface to socket communications | |
16738 | ||
16739 | =over 4 | |
16740 | ||
16741 | =item SYNOPSIS | |
16742 | ||
16743 | =item DESCRIPTION | |
16744 | ||
16745 | =item CONSTRUCTOR | |
16746 | ||
16747 | new ( [ARGS] ) | |
16748 | ||
16749 | =item METHODS | |
16750 | ||
16751 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, | |
16752 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
16753 | ||
16754 | =item SEE ALSO | |
16755 | ||
16756 | =item AUTHOR | |
16757 | ||
16758 | =item COPYRIGHT | |
16759 | ||
16760 | =back | |
16761 | ||
16762 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets | |
16763 | ||
16764 | =over 4 | |
16765 | ||
16766 | =item SYNOPSIS | |
16767 | ||
16768 | =item DESCRIPTION | |
16769 | ||
16770 | =item CONSTRUCTOR | |
16771 | ||
16772 | new ( [ARGS] ) | |
16773 | ||
16774 | =over 4 | |
16775 | ||
16776 | =item METHODS | |
16777 | ||
16778 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
16779 | () | |
16780 | ||
16781 | =back | |
16782 | ||
16783 | =item SEE ALSO | |
16784 | ||
16785 | =item AUTHOR | |
16786 | ||
16787 | =item COPYRIGHT | |
16788 | ||
16789 | =back | |
16790 | ||
16791 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets | |
16792 | ||
16793 | =over 4 | |
16794 | ||
16795 | =item SYNOPSIS | |
16796 | ||
16797 | =item DESCRIPTION | |
16798 | ||
16799 | =item CONSTRUCTOR | |
16800 | ||
16801 | new ( [ARGS] ) | |
16802 | ||
16803 | =item METHODS | |
16804 | ||
16805 | hostpath(), peerpath() | |
16806 | ||
16807 | =item SEE ALSO | |
16808 | ||
16809 | =item AUTHOR | |
16810 | ||
16811 | =item COPYRIGHT | |
16812 | ||
16813 | =back | |
16814 | ||
16815 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory | |
16816 | handles | |
16817 | ||
16818 | =over 4 | |
16819 | ||
16820 | =item SYNOPSIS | |
16821 | ||
16822 | =item DESCRIPTION | |
16823 | ||
16824 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
50e34432 | 16825 | rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] |
ee382f2f JH |
16826 | |
16827 | =item SEE ALSO | |
16828 | ||
16829 | =item AUTHOR | |
16830 | ||
16831 | =item COPYRIGHT | |
16832 | ||
16833 | =back | |
16834 | ||
16835 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles | |
16836 | ||
16837 | =over 4 | |
16838 | ||
16839 | =item SYNOPSIS | |
16840 | ||
16841 | =item DESCRIPTION | |
16842 | ||
16843 | =item CONSTRUCTOR | |
16844 | ||
16845 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
16846 | ||
16847 | =item METHODS | |
16848 | ||
a563e516 NC |
16849 | open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode( |
16850 | [LAYER] ) | |
ee382f2f | 16851 | |
b2a9ae16 NC |
16852 | =item NOTE |
16853 | ||
ee382f2f JH |
16854 | =item SEE ALSO |
16855 | ||
16856 | =item HISTORY | |
16857 | ||
16858 | =back | |
16859 | ||
16860 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O | |
16861 | handles | |
16862 | ||
16863 | =over 4 | |
16864 | ||
16865 | =item SYNOPSIS | |
16866 | ||
16867 | =item DESCRIPTION | |
16868 | ||
16869 | =item CONSTRUCTOR | |
16870 | ||
16871 | new (), new_from_fd ( FD, MODE ) | |
16872 | ||
16873 | =item METHODS | |
16874 | ||
16875 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
16876 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
16877 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
16878 | $io->blocking ( [ BOOL ] ), $io->untaint | |
16879 | ||
16880 | =item NOTE | |
16881 | ||
16882 | =item SEE ALSO | |
16883 | ||
16884 | =item BUGS | |
16885 | ||
16886 | =item HISTORY | |
16887 | ||
16888 | =back | |
16889 | ||
16890 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes | |
16891 | ||
16892 | =over 4 | |
16893 | ||
16894 | =item SYNOPSIS | |
16895 | ||
16896 | =item DESCRIPTION | |
16897 | ||
16898 | =item CONSTRUCTOR | |
16899 | ||
16900 | new ( [READER, WRITER] ) | |
16901 | ||
16902 | =item METHODS | |
16903 | ||
16904 | reader ([ARGS]), writer ([ARGS]), handles () | |
16905 | ||
16906 | =item SEE ALSO | |
16907 | ||
16908 | =item AUTHOR | |
16909 | ||
16910 | =item COPYRIGHT | |
16911 | ||
16912 | =back | |
16913 | ||
16914 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call | |
16915 | ||
16916 | =over 4 | |
16917 | ||
16918 | =item SYNOPSIS | |
16919 | ||
16920 | =item DESCRIPTION | |
16921 | ||
16922 | =item METHODS | |
16923 | ||
16924 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
16925 | IO ), handles( [ EVENT_MASK ] ) | |
16926 | ||
16927 | =item SEE ALSO | |
16928 | ||
16929 | =item AUTHOR | |
16930 | ||
16931 | =item COPYRIGHT | |
16932 | ||
16933 | =back | |
16934 | ||
16935 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for | |
16936 | I/O objects | |
16937 | ||
16938 | =over 4 | |
16939 | ||
16940 | =item SYNOPSIS | |
16941 | ||
16942 | =item DESCRIPTION | |
16943 | ||
16944 | $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), | |
16945 | WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
16946 | $io->tell | |
16947 | ||
16948 | =item SEE ALSO | |
16949 | ||
16950 | =item HISTORY | |
16951 | ||
16952 | =back | |
16953 | ||
16954 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system | |
16955 | call | |
16956 | ||
16957 | =over 4 | |
16958 | ||
16959 | =item SYNOPSIS | |
16960 | ||
16961 | =item DESCRIPTION | |
16962 | ||
16963 | =item CONSTRUCTOR | |
16964 | ||
16965 | new ( [ HANDLES ] ) | |
16966 | ||
16967 | =item METHODS | |
16968 | ||
16969 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
16970 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
16971 | count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) | |
16972 | ||
16973 | =item EXAMPLE | |
16974 | ||
16975 | =item AUTHOR | |
16976 | ||
16977 | =item COPYRIGHT | |
16978 | ||
16979 | =back | |
16980 | ||
16981 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket | |
16982 | communications | |
16983 | ||
16984 | =over 4 | |
16985 | ||
16986 | =item SYNOPSIS | |
16987 | ||
16988 | =item DESCRIPTION | |
16989 | ||
16990 | =item CONSTRUCTOR | |
16991 | ||
16992 | new ( [ARGS] ) | |
16993 | ||
16994 | =item METHODS | |
16995 | ||
16996 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, | |
16997 | protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) | |
16998 | ||
16999 | =item SEE ALSO | |
17000 | ||
17001 | =item AUTHOR | |
17002 | ||
17003 | =item COPYRIGHT | |
17004 | ||
17005 | =back | |
17006 | ||
17007 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for | |
17008 | AF_INET domain sockets | |
17009 | ||
17010 | =over 4 | |
17011 | ||
17012 | =item SYNOPSIS | |
17013 | ||
17014 | =item DESCRIPTION | |
17015 | ||
17016 | =item CONSTRUCTOR | |
17017 | ||
17018 | new ( [ARGS] ) | |
17019 | ||
17020 | =over 4 | |
17021 | ||
17022 | =item METHODS | |
17023 | ||
17024 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
17025 | () | |
17026 | ||
17027 | =back | |
17028 | ||
17029 | =item SEE ALSO | |
17030 | ||
17031 | =item AUTHOR | |
17032 | ||
17033 | =item COPYRIGHT | |
17034 | ||
17035 | =back | |
17036 | ||
17037 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for | |
17038 | AF_UNIX domain sockets | |
17039 | ||
17040 | =over 4 | |
17041 | ||
17042 | =item SYNOPSIS | |
17043 | ||
17044 | =item DESCRIPTION | |
17045 | ||
17046 | =item CONSTRUCTOR | |
17047 | ||
17048 | new ( [ARGS] ) | |
17049 | ||
17050 | =item METHODS | |
17051 | ||
17052 | hostpath(), peerpath() | |
17053 | ||
17054 | =item SEE ALSO | |
17055 | ||
17056 | =item AUTHOR | |
17057 | ||
17058 | =item COPYRIGHT | |
17059 | ||
17060 | =back | |
17061 | ||
17062 | =head2 IPC::Msg - SysV Msg IPC object class | |
17063 | ||
17064 | =over 4 | |
17065 | ||
17066 | =item SYNOPSIS | |
17067 | ||
17068 | =item DESCRIPTION | |
17069 | ||
17070 | =item METHODS | |
17071 | ||
17072 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
17073 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
17074 | FLAGS ] ), stat | |
17075 | ||
17076 | =item SEE ALSO | |
17077 | ||
17078 | =item AUTHOR | |
17079 | ||
17080 | =item COPYRIGHT | |
17081 | ||
17082 | =back | |
17083 | ||
17084 | =head2 IPC::Open2, open2 - open a process for both reading and writing | |
17085 | ||
17086 | =over 4 | |
17087 | ||
17088 | =item SYNOPSIS | |
17089 | ||
17090 | =item DESCRIPTION | |
17091 | ||
17092 | =item WARNING | |
17093 | ||
17094 | =item SEE ALSO | |
17095 | ||
17096 | =back | |
17097 | ||
17098 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error | |
17099 | handling | |
17100 | ||
17101 | =over 4 | |
17102 | ||
17103 | =item SYNOPSIS | |
17104 | ||
17105 | =item DESCRIPTION | |
17106 | ||
17107 | =item WARNING | |
17108 | ||
17109 | =back | |
17110 | ||
17111 | =head2 IPC::Semaphore - SysV Semaphore IPC object class | |
17112 | ||
17113 | =over 4 | |
17114 | ||
17115 | =item SYNOPSIS | |
17116 | ||
17117 | =item DESCRIPTION | |
17118 | ||
17119 | =item METHODS | |
17120 | ||
17121 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
17122 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
17123 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
17124 | , VALUE ), stat | |
17125 | ||
17126 | =item SEE ALSO | |
17127 | ||
17128 | =item AUTHOR | |
17129 | ||
17130 | =item COPYRIGHT | |
17131 | ||
17132 | =back | |
17133 | ||
17134 | =head2 IPC::SysV - SysV IPC constants | |
17135 | ||
17136 | =over 4 | |
17137 | ||
17138 | =item SYNOPSIS | |
17139 | ||
17140 | =item DESCRIPTION | |
17141 | ||
17142 | ftok( PATH, ID ) | |
17143 | ||
17144 | =item SEE ALSO | |
17145 | ||
17146 | =item AUTHORS | |
17147 | ||
17148 | =item COPYRIGHT | |
17149 | ||
17150 | =back | |
17151 | ||
17152 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class | |
17153 | ||
17154 | =over 4 | |
17155 | ||
17156 | =item SYNOPSIS | |
17157 | ||
17158 | =item DESCRIPTION | |
17159 | ||
17160 | =item METHODS | |
17161 | ||
17162 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
17163 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
17164 | FLAGS ] ), stat | |
17165 | ||
17166 | =item SEE ALSO | |
17167 | ||
17168 | =item AUTHOR | |
17169 | ||
17170 | =item COPYRIGHT | |
17171 | ||
17172 | =back | |
17173 | ||
17174 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object | |
17175 | class | |
17176 | ||
17177 | =over 4 | |
17178 | ||
17179 | =item SYNOPSIS | |
17180 | ||
17181 | =item DESCRIPTION | |
17182 | ||
17183 | =item METHODS | |
17184 | ||
17185 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
17186 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
17187 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
17188 | , VALUE ), stat | |
17189 | ||
17190 | =item SEE ALSO | |
17191 | ||
17192 | =item AUTHOR | |
17193 | ||
17194 | =item COPYRIGHT | |
17195 | ||
17196 | =back | |
17197 | ||
17198 | =head2 List::Util - A selection of general-utility list subroutines | |
17199 | ||
17200 | =over 4 | |
17201 | ||
17202 | =item SYNOPSIS | |
17203 | ||
17204 | =item DESCRIPTION | |
17205 | ||
17206 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
17207 | BLOCK LIST, shuffle LIST, sum LIST | |
17208 | ||
17209 | =item KNOWN BUGS | |
17210 | ||
17211 | =item SUGGESTED ADDITIONS | |
17212 | ||
17213 | =item COPYRIGHT | |
17214 | ||
17215 | =back | |
17216 | ||
17217 | =head2 List::Utilib::List::Util, List::Util - A selection of | |
17218 | general-utility list subroutines | |
17219 | ||
17220 | =over 4 | |
17221 | ||
17222 | =item SYNOPSIS | |
17223 | ||
17224 | =item DESCRIPTION | |
17225 | ||
17226 | first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce | |
17227 | BLOCK LIST, shuffle LIST, sum LIST | |
17228 | ||
17229 | =item KNOWN BUGS | |
17230 | ||
17231 | =item SUGGESTED ADDITIONS | |
17232 | ||
17233 | =item COPYRIGHT | |
17234 | ||
17235 | =back | |
17236 | ||
17237 | =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of | |
17238 | general-utility scalar subroutines | |
17239 | ||
17240 | =over 4 | |
17241 | ||
17242 | =item SYNOPSIS | |
17243 | ||
17244 | =item DESCRIPTION | |
17245 | ||
17246 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, | |
17247 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, | |
17248 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF | |
17249 | ||
17250 | =item KNOWN BUGS | |
17251 | ||
17252 | =item COPYRIGHT | |
17253 | ||
17254 | =item BLATANT PLUG | |
17255 | ||
17256 | =back | |
17257 | ||
17258 | =head2 Locale::Constants - constants for Locale codes | |
17259 | ||
17260 | =over 4 | |
17261 | ||
17262 | =item SYNOPSIS | |
17263 | ||
17264 | =item DESCRIPTION | |
17265 | ||
17266 | =item KNOWN BUGS AND LIMITATIONS | |
17267 | ||
17268 | =item SEE ALSO | |
17269 | ||
17270 | Locale::Language, Locale::Country, Locale::Script, Locale::Currency | |
17271 | ||
17272 | =item AUTHOR | |
17273 | ||
17274 | =item COPYRIGHT | |
17275 | ||
17276 | =back | |
17277 | ||
17278 | =head2 Locale::Country - ISO codes for country identification (ISO 3166) | |
17279 | ||
17280 | =over 4 | |
17281 | ||
17282 | =item SYNOPSIS | |
17283 | ||
17284 | =item DESCRIPTION | |
17285 | ||
17286 | B<alpha-2>, B<alpha-3>, B<numeric> | |
17287 | ||
17288 | =item CONVERSION ROUTINES | |
17289 | ||
17290 | code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), | |
17291 | country_code2code( CODE, CODESET, CODESET ) | |
17292 | ||
17293 | =item QUERY ROUTINES | |
17294 | ||
17295 | C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )> | |
17296 | ||
17297 | =item SEMI-PRIVATE ROUTINES | |
17298 | ||
17299 | =over 4 | |
17300 | ||
17301 | =item alias_code | |
17302 | ||
17303 | =item rename_country | |
17304 | ||
17305 | =back | |
17306 | ||
17307 | =item EXAMPLES | |
17308 | ||
17309 | =item DOMAIN NAMES | |
17310 | ||
17311 | =item KNOWN BUGS AND LIMITATIONS | |
17312 | ||
17313 | =item SEE ALSO | |
17314 | ||
17315 | Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO | |
17316 | 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, | |
17317 | http://www.egt.ie/standards/iso3166/iso3166-1-en.html, | |
17318 | http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html | |
17319 | ||
17320 | =item AUTHOR | |
17321 | ||
17322 | =item COPYRIGHT | |
17323 | ||
17324 | =back | |
17325 | ||
17326 | =head2 Locale::Currency - ISO three letter codes for currency | |
17327 | identification (ISO 4217) | |
17328 | ||
17329 | =over 4 | |
17330 | ||
17331 | =item SYNOPSIS | |
17332 | ||
17333 | =item DESCRIPTION | |
17334 | ||
17335 | XTS, XXX | |
17336 | ||
17337 | =item CONVERSION ROUTINES | |
17338 | ||
17339 | code2currency(), currency2code() | |
17340 | ||
17341 | =item QUERY ROUTINES | |
17342 | ||
17343 | C<all_currency_codes()>, C<all_currency_names()> | |
17344 | ||
17345 | =item EXAMPLES | |
17346 | ||
17347 | =item KNOWN BUGS AND LIMITATIONS | |
17348 | ||
17349 | =item SEE ALSO | |
17350 | ||
17351 | Locale::Country, Locale::Script, ISO 4217:1995, | |
17352 | http://www.bsi-global.com/iso4217currency | |
17353 | ||
17354 | =item AUTHOR | |
17355 | ||
17356 | =item COPYRIGHT | |
17357 | ||
17358 | =back | |
17359 | ||
17360 | =head2 Locale::Language - ISO two letter codes for language identification | |
17361 | (ISO 639) | |
17362 | ||
17363 | =over 4 | |
17364 | ||
17365 | =item SYNOPSIS | |
17366 | ||
17367 | =item DESCRIPTION | |
17368 | ||
17369 | =item CONVERSION ROUTINES | |
17370 | ||
17371 | code2language(), language2code() | |
17372 | ||
17373 | =item QUERY ROUTINES | |
17374 | ||
17375 | C<all_language_codes()>, C<all_language_names()> | |
17376 | ||
17377 | =item EXAMPLES | |
17378 | ||
17379 | =item KNOWN BUGS AND LIMITATIONS | |
17380 | ||
17381 | =item SEE ALSO | |
17382 | ||
17383 | Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F), | |
17384 | http://lcweb.loc.gov/standards/iso639-2/langhome.html | |
17385 | ||
17386 | =item AUTHOR | |
17387 | ||
17388 | =item COPYRIGHT | |
17389 | ||
17390 | =back | |
17391 | ||
17392 | =head2 Locale::Maketext - framework for localization | |
17393 | ||
17394 | =over 4 | |
17395 | ||
17396 | =item SYNOPSIS | |
17397 | ||
17398 | =item DESCRIPTION | |
17399 | ||
17400 | =item QUICK OVERVIEW | |
17401 | ||
17402 | =item METHODS | |
17403 | ||
17404 | =over 4 | |
17405 | ||
17406 | =item Construction Methods | |
17407 | ||
17408 | =item The "maketext" Method | |
17409 | ||
17410 | $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto | |
17411 | ||
17412 | =item Utility Methods | |
17413 | ||
17414 | $language->quant($number, $singular), $language->quant($number, $singular, | |
17415 | $plural), $language->quant($number, $singular, $plural, $negative), | |
17416 | $language->numf($number), $language->sprintf($format, @items), | |
17417 | $language->language_tag(), $language->encoding() | |
17418 | ||
17419 | =item Language Handle Attributes and Internals | |
17420 | ||
17421 | =back | |
17422 | ||
17423 | =item LANGUAGE CLASS HIERARCHIES | |
17424 | ||
17425 | =item ENTRIES IN EACH LEXICON | |
17426 | ||
17427 | =item BRACKET NOTATION | |
17428 | ||
17429 | =item AUTO LEXICONS | |
17430 | ||
17431 | =item CONTROLLING LOOKUP FAILURE | |
17432 | ||
17433 | =item HOW TO USE MAKETEXT | |
17434 | ||
17435 | =item SEE ALSO | |
17436 | ||
17437 | =item COPYRIGHT AND DISCLAIMER | |
17438 | ||
17439 | =item AUTHOR | |
17440 | ||
17441 | =back | |
17442 | ||
17443 | =head2 Locale::Maketext::TPJ13 -- article about software localization | |
17444 | ||
17445 | =over 4 | |
17446 | ||
17447 | =item SYNOPSIS | |
17448 | ||
17449 | =item DESCRIPTION | |
17450 | ||
17451 | =item Localization and Perl: gettext breaks, Maketext fixes | |
17452 | ||
17453 | =over 4 | |
17454 | ||
17455 | =item A Localization Horror Story: It Could Happen To You | |
17456 | ||
17457 | =item The Linguistic View | |
17458 | ||
17459 | =item Breaking gettext | |
17460 | ||
17461 | =item Replacing gettext | |
17462 | ||
17463 | =item Buzzwords: Abstraction and Encapsulation | |
17464 | ||
17465 | =item Buzzword: Isomorphism | |
17466 | ||
17467 | =item Buzzword: Inheritance | |
17468 | ||
17469 | =item Buzzword: Concision | |
17470 | ||
17471 | =item The Devil in the Details | |
17472 | ||
17473 | =item The Proof in the Pudding: Localizing Web Sites | |
17474 | ||
17475 | =item References | |
17476 | ||
17477 | =back | |
17478 | ||
17479 | =back | |
17480 | ||
17481 | =head2 Locale::Script - ISO codes for script identification (ISO 15924) | |
17482 | ||
17483 | =over 4 | |
17484 | ||
17485 | =item SYNOPSIS | |
17486 | ||
17487 | =item DESCRIPTION | |
17488 | ||
17489 | B<alpha-2>, B<alpha-3>, B<numeric> | |
17490 | ||
17491 | =over 4 | |
17492 | ||
17493 | =item SPECIAL CODES | |
17494 | ||
17495 | =back | |
17496 | ||
17497 | =item CONVERSION ROUTINES | |
17498 | ||
17499 | code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ), | |
17500 | script_code2code( CODE, CODESET, CODESET ) | |
17501 | ||
17502 | =item QUERY ROUTINES | |
17503 | ||
17504 | C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )> | |
17505 | ||
17506 | =item EXAMPLES | |
17507 | ||
17508 | =item KNOWN BUGS AND LIMITATIONS | |
17509 | ||
17510 | =item SEE ALSO | |
17511 | ||
17512 | Locale::Language, Locale::Currency, Locale::Country, ISO 15924, | |
17513 | http://www.evertype.com/standards/iso15924/ | |
17514 | ||
17515 | =item AUTHOR | |
17516 | ||
17517 | =item COPYRIGHT | |
17518 | ||
17519 | =back | |
17520 | ||
17521 | =head2 MIME::Base64 - Encoding and decoding of base64 strings | |
17522 | ||
17523 | =over 4 | |
17524 | ||
17525 | =item SYNOPSIS | |
17526 | ||
17527 | =item DESCRIPTION | |
17528 | ||
17529 | encode_base64($str), encode_base64($str, $eol);, decode_base64($str) | |
17530 | ||
17531 | =item DIAGNOSTICS | |
17532 | ||
b40eed9c NC |
17533 | Premature end of base64 data, Premature padding of base64 data, Wide |
17534 | character in subroutine entry | |
ee382f2f JH |
17535 | |
17536 | =item EXAMPLES | |
17537 | ||
17538 | =item COPYRIGHT | |
17539 | ||
91e033c7 NC |
17540 | =item SEE ALSO |
17541 | ||
ee382f2f JH |
17542 | =back |
17543 | ||
17544 | =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding | |
17545 | of quoted-printable strings | |
17546 | ||
17547 | =over 4 | |
17548 | ||
17549 | =item SYNOPSIS | |
17550 | ||
17551 | =item DESCRIPTION | |
17552 | ||
a2db77eb NC |
17553 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
17554 | decode_qp($str); | |
ee382f2f JH |
17555 | |
17556 | =item COPYRIGHT | |
17557 | ||
91e033c7 NC |
17558 | =item SEE ALSO |
17559 | ||
ee382f2f JH |
17560 | =back |
17561 | ||
17562 | =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable | |
17563 | strings | |
17564 | ||
17565 | =over 4 | |
17566 | ||
17567 | =item SYNOPSIS | |
17568 | ||
17569 | =item DESCRIPTION | |
17570 | ||
a2db77eb NC |
17571 | encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode), |
17572 | decode_qp($str); | |
ee382f2f JH |
17573 | |
17574 | =item COPYRIGHT | |
17575 | ||
91e033c7 NC |
17576 | =item SEE ALSO |
17577 | ||
ee382f2f JH |
17578 | =back |
17579 | ||
17580 | =head2 Math::BigFloat - Arbitrary size floating point math package | |
17581 | ||
17582 | =over 4 | |
17583 | ||
17584 | =item SYNOPSIS | |
17585 | ||
17586 | =item DESCRIPTION | |
17587 | ||
17588 | =over 4 | |
17589 | ||
17590 | =item Canonical notation | |
17591 | ||
17592 | =item Output | |
17593 | ||
17594 | =item C<mantissa()>, C<exponent()> and C<parts()> | |
17595 | ||
17596 | =item Accuracy vs. Precision | |
17597 | ||
17598 | =item Rounding | |
17599 | ||
17600 | ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale | |
17601 | ), fround ( -$scale ) and fround ( 0 ) | |
17602 | ||
17603 | =back | |
17604 | ||
b2a9ae16 NC |
17605 | =item METHODS |
17606 | ||
17607 | =over 4 | |
17608 | ||
17609 | =item accuracy | |
ee382f2f | 17610 | |
b2a9ae16 NC |
17611 | =item precision() |
17612 | ||
17613 | =back | |
ee382f2f JH |
17614 | |
17615 | =item Autocreating constants | |
17616 | ||
17617 | =over 4 | |
17618 | ||
17619 | =item Math library | |
17620 | ||
17621 | =item Using Math::BigInt::Lite | |
17622 | ||
17623 | =back | |
17624 | ||
17625 | =item BUGS | |
17626 | ||
73fba812 | 17627 | =item CAVEATS |
ee382f2f | 17628 | |
b2a9ae16 | 17629 | stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy() |
ee382f2f | 17630 | |
73fba812 JH |
17631 | =item SEE ALSO |
17632 | ||
ee382f2f JH |
17633 | =item LICENSE |
17634 | ||
17635 | =item AUTHORS | |
17636 | ||
17637 | =back | |
17638 | ||
b2a9ae16 | 17639 | =head2 Math::BigInt - Arbitrary size integer/float math package |
ee382f2f JH |
17640 | |
17641 | =over 4 | |
17642 | ||
17643 | =item SYNOPSIS | |
17644 | ||
17645 | =item DESCRIPTION | |
17646 | ||
cd458e05 | 17647 | Input, Output |
ee382f2f JH |
17648 | |
17649 | =item METHODS | |
17650 | ||
17651 | =over 4 | |
17652 | ||
17653 | =item config | |
17654 | ||
17655 | =item accuracy | |
17656 | ||
17657 | =item precision | |
17658 | ||
17659 | =item brsft | |
17660 | ||
17661 | =item new | |
17662 | ||
17663 | =item bnan | |
17664 | ||
17665 | =item bzero | |
17666 | ||
17667 | =item binf | |
17668 | ||
17669 | =item bone | |
17670 | ||
17671 | =item is_one()/is_zero()/is_nan()/is_inf() | |
17672 | ||
4c64e75b | 17673 | =item is_pos()/is_neg() |
ee382f2f | 17674 | |
b2a9ae16 NC |
17675 | $x->is_pos(); # true if > 0 |
17676 | $x->is_neg(); # true if < 0 | |
ee382f2f JH |
17677 | |
17678 | =item is_odd()/is_even()/is_int() | |
17679 | ||
17680 | =item bcmp | |
17681 | ||
17682 | =item bacmp | |
17683 | ||
17684 | =item sign | |
17685 | ||
7a5cdbdf | 17686 | =item digit |
ee382f2f JH |
17687 | |
17688 | =item bneg | |
17689 | ||
17690 | =item babs | |
17691 | ||
17692 | =item bnorm | |
17693 | ||
17694 | =item bnot | |
17695 | ||
17696 | =item binc | |
17697 | ||
17698 | =item bdec | |
17699 | ||
17700 | =item badd | |
17701 | ||
17702 | =item bsub | |
17703 | ||
17704 | =item bmul | |
17705 | ||
17706 | =item bdiv | |
17707 | ||
17708 | =item bmod | |
17709 | ||
17710 | =item bmodinv | |
17711 | ||
17712 | =item bmodpow | |
17713 | ||
17714 | =item bpow | |
17715 | ||
17716 | =item blsft | |
17717 | ||
17718 | =item brsft | |
17719 | ||
17720 | =item band | |
17721 | ||
17722 | =item bior | |
17723 | ||
17724 | =item bxor | |
17725 | ||
17726 | =item bnot | |
17727 | ||
17728 | =item bsqrt | |
17729 | ||
17730 | =item bfac | |
17731 | ||
17732 | =item round | |
17733 | ||
17734 | =item bround | |
17735 | ||
17736 | =item bfround | |
17737 | ||
17738 | =item bfloor | |
17739 | ||
17740 | =item bceil | |
17741 | ||
17742 | =item bgcd | |
17743 | ||
17744 | =item blcm | |
17745 | ||
17746 | =item exponent | |
17747 | ||
17748 | =item mantissa | |
17749 | ||
17750 | =item parts | |
17751 | ||
17752 | =item copy | |
17753 | ||
4c64e75b | 17754 | =item as_int |
ee382f2f JH |
17755 | |
17756 | =item bsstr | |
17757 | ||
17758 | =item as_hex | |
17759 | ||
17760 | =item as_bin | |
17761 | ||
17762 | =back | |
17763 | ||
17764 | =item ACCURACY and PRECISION | |
17765 | ||
17766 | =over 4 | |
17767 | ||
17768 | =item Precision P | |
17769 | ||
17770 | =item Accuracy A | |
17771 | ||
17772 | =item Fallback F | |
17773 | ||
17774 | =item Rounding mode R | |
17775 | ||
17776 | 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy | |
17777 | (significant digits), Setting/Accessing, Creating numbers, Usage, | |
17778 | Precedence, Overriding globals, Local settings, Rounding, Default values, | |
17779 | Remarks | |
17780 | ||
17781 | =back | |
17782 | ||
b2a9ae16 NC |
17783 | =item Infinity and Not a Number |
17784 | ||
17785 | oct()/hex(), log(-inf), exp(), cos(), sin(), atan2() | |
17786 | ||
ee382f2f JH |
17787 | =item INTERNALS |
17788 | ||
17789 | =over 4 | |
17790 | ||
17791 | =item MATH LIBRARY | |
17792 | ||
17793 | =item SIGN | |
17794 | ||
17795 | =item mantissa(), exponent() and parts() | |
17796 | ||
17797 | =back | |
17798 | ||
17799 | =item EXAMPLES | |
17800 | ||
17801 | use Math::BigInt; | |
17802 | ||
17803 | =item Autocreating constants | |
17804 | ||
17805 | =item PERFORMANCE | |
17806 | ||
17807 | =over 4 | |
17808 | ||
17809 | =item Alternative math libraries | |
17810 | ||
17811 | =item SUBCLASSING | |
17812 | ||
17813 | =back | |
17814 | ||
17815 | =item Subclassing Math::BigInt | |
17816 | ||
17817 | =item UPGRADING | |
17818 | ||
17819 | =over 4 | |
17820 | ||
17821 | =item Auto-upgrade | |
17822 | ||
17823 | bsqrt(), div(), blog() | |
17824 | ||
17825 | =back | |
17826 | ||
17827 | =item BUGS | |
17828 | ||
73fba812 JH |
17829 | broot() does not work, Out of Memory!, Fails to load Calc on Perl prior |
17830 | 5.6.0 | |
ee382f2f JH |
17831 | |
17832 | =item CAVEATS | |
17833 | ||
7a5cdbdf AJ |
17834 | bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling, |
17835 | Modifying and =, bpow, Overloading -$x, Mixing different object types, | |
17836 | bsqrt(), brsft() | |
ee382f2f JH |
17837 | |
17838 | =item LICENSE | |
17839 | ||
17840 | =item SEE ALSO | |
17841 | ||
17842 | =item AUTHORS | |
17843 | ||
17844 | =back | |
17845 | ||
17846 | =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt | |
17847 | ||
17848 | =over 4 | |
17849 | ||
17850 | =item SYNOPSIS | |
17851 | ||
17852 | =item DESCRIPTION | |
17853 | ||
73fba812 JH |
17854 | =item STORAGE |
17855 | ||
17856 | =item METHODS | |
ee382f2f JH |
17857 | |
17858 | =item WRAP YOUR OWN | |
17859 | ||
17860 | =item LICENSE | |
17861 | ||
17862 | This program is free software; you may redistribute it and/or modify it | |
17863 | under | |
17864 | the same terms as Perl itself. | |
17865 | ||
17866 | =item AUTHORS | |
17867 | ||
17868 | =item SEE ALSO | |
17869 | ||
17870 | =back | |
17871 | ||
4c64e75b NC |
17872 | =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code |
17873 | ||
17874 | =over 4 | |
17875 | ||
17876 | =item SYNOPSIS | |
17877 | ||
17878 | =item DESCRIPTION | |
17879 | ||
17880 | =item METHODS | |
17881 | ||
b2a9ae16 NC |
17882 | =over 4 |
17883 | ||
17884 | =item __emu_bxor | |
17885 | ||
17886 | =item __emu_band | |
17887 | ||
17888 | =item __emu_bior | |
17889 | ||
17890 | =back | |
17891 | ||
4c64e75b NC |
17892 | =item LICENSE |
17893 | ||
17894 | This program is free software; you may redistribute it and/or modify it | |
17895 | under | |
17896 | the same terms as Perl itself. | |
17897 | ||
17898 | =item AUTHORS | |
17899 | ||
17900 | =item SEE ALSO | |
17901 | ||
17902 | =back | |
17903 | ||
b2a9ae16 | 17904 | =head2 Math::BigRat - Arbitrary big rational numbers |
ee382f2f JH |
17905 | |
17906 | =over 4 | |
17907 | ||
17908 | =item SYNOPSIS | |
17909 | ||
17910 | =item DESCRIPTION | |
17911 | ||
17912 | =over 4 | |
17913 | ||
17914 | =item MATH LIBRARY | |
17915 | ||
17916 | =back | |
17917 | ||
17918 | =item METHODS | |
17919 | ||
17920 | =over 4 | |
17921 | ||
17922 | =item new() | |
17923 | ||
17924 | =item numerator() | |
17925 | ||
17926 | =item denominator() | |
17927 | ||
17928 | $d = $x->denominator(); | |
17929 | ||
17930 | =item parts() | |
17931 | ||
b2a9ae16 NC |
17932 | =item as_int() |
17933 | ||
17934 | =item as_hex() | |
17935 | ||
17936 | =item as_bin() | |
ee382f2f JH |
17937 | |
17938 | =item bfac() | |
17939 | ||
17940 | =item blog() | |
17941 | ||
17942 | =item bround()/round()/bfround() | |
17943 | ||
73fba812 JH |
17944 | =item bmod() |
17945 | ||
ee382f2f JH |
17946 | =item is_one() |
17947 | ||
17948 | =item is_zero() | |
17949 | ||
b2a9ae16 | 17950 | =item is_pos() |
ee382f2f | 17951 | |
b2a9ae16 | 17952 | =item is_neg() |
ee382f2f JH |
17953 | |
17954 | =item is_int() | |
17955 | ||
17956 | =item is_odd() | |
17957 | ||
17958 | =item is_even() | |
17959 | ||
17960 | =item bceil() | |
17961 | ||
17962 | =item bfloor() | |
17963 | ||
17964 | $x->bfloor(); | |
17965 | ||
7f106169 NC |
17966 | =item bsqrt() |
17967 | ||
17968 | $x->bsqrt(); | |
17969 | ||
73fba812 JH |
17970 | =item config |
17971 | ||
ee382f2f JH |
17972 | =back |
17973 | ||
17974 | =item BUGS | |
17975 | ||
17976 | inf handling (partial), NaN handling (partial), rounding (not implemented | |
7f106169 NC |
17977 | except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(), |
17978 | blog(), bmodinv() and bmodpow() (partial) | |
ee382f2f JH |
17979 | |
17980 | =item LICENSE | |
17981 | ||
17982 | =item SEE ALSO | |
17983 | ||
17984 | =item AUTHORS | |
17985 | ||
17986 | =back | |
17987 | ||
17988 | =head2 Math::Complex - complex numbers and associated mathematical | |
17989 | functions | |
17990 | ||
17991 | =over 4 | |
17992 | ||
17993 | =item SYNOPSIS | |
17994 | ||
17995 | =item DESCRIPTION | |
17996 | ||
17997 | =item OPERATIONS | |
17998 | ||
17999 | =item CREATION | |
18000 | ||
b40eed9c | 18001 | =item DISPLAYING |
ee382f2f JH |
18002 | |
18003 | =over 4 | |
18004 | ||
18005 | =item CHANGED IN PERL 5.6 | |
18006 | ||
18007 | =back | |
18008 | ||
18009 | =item USAGE | |
18010 | ||
18011 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
18012 | ||
18013 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
18014 | ||
18015 | =item BUGS | |
18016 | ||
18017 | =item AUTHORS | |
18018 | ||
18019 | =back | |
18020 | ||
18021 | =head2 Math::Trig - trigonometric functions | |
18022 | ||
18023 | =over 4 | |
18024 | ||
18025 | =item SYNOPSIS | |
18026 | ||
18027 | =item DESCRIPTION | |
18028 | ||
18029 | =item TRIGONOMETRIC FUNCTIONS | |
18030 | ||
18031 | B<tan> | |
18032 | ||
18033 | =over 4 | |
18034 | ||
18035 | =item ERRORS DUE TO DIVISION BY ZERO | |
18036 | ||
18037 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
18038 | ||
18039 | =back | |
18040 | ||
18041 | =item PLANE ANGLE CONVERSIONS | |
18042 | ||
18043 | =item RADIAL COORDINATE CONVERSIONS | |
18044 | ||
18045 | =over 4 | |
18046 | ||
18047 | =item COORDINATE SYSTEMS | |
18048 | ||
18049 | =item 3-D ANGLE CONVERSIONS | |
18050 | ||
18051 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
18052 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
18053 | ||
18054 | =back | |
18055 | ||
18056 | =item GREAT CIRCLE DISTANCES AND DIRECTIONS | |
18057 | ||
18058 | =item EXAMPLES | |
18059 | ||
18060 | =over 4 | |
18061 | ||
18062 | =item CAVEAT FOR GREAT CIRCLE FORMULAS | |
18063 | ||
18064 | =back | |
18065 | ||
18066 | =item BUGS | |
18067 | ||
18068 | =item AUTHORS | |
18069 | ||
18070 | =back | |
18071 | ||
18072 | =head2 Memoize - Make functions faster by trading space for time | |
18073 | ||
18074 | =over 4 | |
18075 | ||
18076 | =item SYNOPSIS | |
18077 | ||
18078 | =item DESCRIPTION | |
18079 | ||
18080 | =item DETAILS | |
18081 | ||
18082 | =item OPTIONS | |
18083 | ||
18084 | =over 4 | |
18085 | ||
18086 | =item INSTALL | |
18087 | ||
18088 | =item NORMALIZER | |
18089 | ||
18090 | =item C<SCALAR_CACHE>, C<LIST_CACHE> | |
18091 | ||
18092 | C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE> | |
18093 | ||
18094 | =back | |
18095 | ||
18096 | =item OTHER FACILITIES | |
18097 | ||
18098 | =over 4 | |
18099 | ||
18100 | =item C<unmemoize> | |
18101 | ||
18102 | =item C<flush_cache> | |
18103 | ||
18104 | =back | |
18105 | ||
18106 | =item CAVEATS | |
18107 | ||
18108 | =item PERSISTENT CACHE SUPPORT | |
18109 | ||
18110 | =item EXPIRATION SUPPORT | |
18111 | ||
18112 | =item BUGS | |
18113 | ||
18114 | =item MAILING LIST | |
18115 | ||
18116 | =item AUTHOR | |
18117 | ||
18118 | =item COPYRIGHT AND LICENSE | |
18119 | ||
18120 | =item THANK YOU | |
18121 | ||
18122 | =back | |
18123 | ||
18124 | =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for | |
18125 | Storable use | |
18126 | ||
18127 | =over 4 | |
18128 | ||
18129 | =item DESCRIPTION | |
18130 | ||
18131 | =back | |
18132 | ||
18133 | =head2 Memoize::Expire - Plug-in module for automatic expiration of | |
18134 | memoized values | |
18135 | ||
18136 | =over 4 | |
18137 | ||
18138 | =item SYNOPSIS | |
18139 | ||
18140 | =item DESCRIPTION | |
18141 | ||
18142 | =item INTERFACE | |
18143 | ||
18144 | TIEHASH, EXISTS, STORE | |
18145 | ||
18146 | =item ALTERNATIVES | |
18147 | ||
18148 | =item CAVEATS | |
18149 | ||
18150 | =item AUTHOR | |
18151 | ||
18152 | =item SEE ALSO | |
18153 | ||
18154 | =back | |
18155 | ||
18156 | =head2 Memoize::ExpireFile - test for Memoize expiration semantics | |
18157 | ||
18158 | =over 4 | |
18159 | ||
18160 | =item DESCRIPTION | |
18161 | ||
18162 | =back | |
18163 | ||
18164 | =head2 Memoize::ExpireTest - test for Memoize expiration semantics | |
18165 | ||
18166 | =over 4 | |
18167 | ||
18168 | =item DESCRIPTION | |
18169 | ||
18170 | =back | |
18171 | ||
18172 | =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for | |
18173 | Storable use | |
18174 | ||
18175 | =over 4 | |
18176 | ||
18177 | =item DESCRIPTION | |
18178 | ||
18179 | =back | |
18180 | ||
18181 | =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for | |
18182 | Storable use | |
18183 | ||
18184 | =over 4 | |
18185 | ||
18186 | =item DESCRIPTION | |
18187 | ||
18188 | =back | |
18189 | ||
18190 | =head2 Memoize::Storable - store Memoized data in Storable database | |
18191 | ||
18192 | =over 4 | |
18193 | ||
18194 | =item DESCRIPTION | |
18195 | ||
18196 | =back | |
18197 | ||
18198 | =head2 NDBM_File - Tied access to ndbm files | |
18199 | ||
18200 | =over 4 | |
18201 | ||
18202 | =item SYNOPSIS | |
18203 | ||
18204 | =item DESCRIPTION | |
18205 | ||
18206 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
18207 | ||
18208 | =item DIAGNOSTICS | |
18209 | ||
18210 | =over 4 | |
18211 | ||
18212 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
18213 | ||
18214 | =back | |
18215 | ||
18216 | =item BUGS AND WARNINGS | |
18217 | ||
18218 | =back | |
18219 | ||
50e34432 JH |
18220 | =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method |
18221 | redispatch | |
ee382f2f JH |
18222 | |
18223 | =over 4 | |
18224 | ||
18225 | =item SYNOPSIS | |
18226 | ||
18227 | =item DESCRIPTION | |
18228 | ||
18229 | =over 4 | |
18230 | ||
18231 | =item Enforcing redispatch | |
18232 | ||
18233 | =item Avoiding repetitions | |
18234 | ||
50e34432 JH |
18235 | =item Invoking all versions of a method with a single call |
18236 | ||
18237 | =item Using C<EVERY> methods | |
18238 | ||
ee382f2f JH |
18239 | =back |
18240 | ||
18241 | =item AUTHOR | |
18242 | ||
18243 | =item BUGS AND IRRITATIONS | |
18244 | ||
18245 | =item COPYRIGHT | |
18246 | ||
18247 | =back | |
18248 | ||
18249 | =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) | |
18250 | ||
18251 | =over 4 | |
18252 | ||
18253 | =item SYNOPSIS | |
18254 | ||
18255 | =item DESCRIPTION | |
18256 | ||
18257 | =item USER METHODS | |
18258 | ||
18259 | debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), | |
18260 | dataend () | |
18261 | ||
18262 | =item CLASS METHODS | |
18263 | ||
18264 | debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... | |
18265 | ]), unsupported (), response (), parse_response ( TEXT ), getline (), | |
6e76d345 | 18266 | ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh () |
ee382f2f JH |
18267 | |
18268 | =item EXPORTS | |
18269 | ||
18270 | =item AUTHOR | |
18271 | ||
18272 | =item COPYRIGHT | |
18273 | ||
18274 | =back | |
18275 | ||
18276 | =head2 Net::Config - Local configuration data for libnet | |
18277 | ||
18278 | =over 4 | |
18279 | ||
18280 | =item SYNOPSYS | |
18281 | ||
18282 | =item DESCRIPTION | |
18283 | ||
18284 | =item METHODS | |
18285 | ||
18286 | requires_firewall HOST | |
18287 | ||
18288 | =item NetConfig VALUES | |
18289 | ||
18290 | nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, | |
18291 | time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive, | |
18292 | ftp_int_pasive, local_netmask, test_hosts, test_exists | |
18293 | ||
18294 | =back | |
18295 | ||
18296 | =head2 Net::Domain - Attempt to evaluate the current host's internet name | |
18297 | and domain | |
18298 | ||
18299 | =over 4 | |
18300 | ||
18301 | =item SYNOPSIS | |
18302 | ||
18303 | =item DESCRIPTION | |
18304 | ||
18305 | hostfqdn (), hostname (), hostdomain () | |
18306 | ||
18307 | =item AUTHOR | |
18308 | ||
18309 | =item COPYRIGHT | |
18310 | ||
18311 | =back | |
18312 | ||
18313 | =head2 Net::FTP - FTP Client class | |
18314 | ||
18315 | =over 4 | |
18316 | ||
18317 | =item SYNOPSIS | |
18318 | ||
18319 | =item DESCRIPTION | |
18320 | ||
18321 | =item OVERVIEW | |
18322 | ||
18323 | =item CONSTRUCTOR | |
18324 | ||
d3ca9f77 | 18325 | new ([ HOST ] [, OPTIONS ]) |
ee382f2f JH |
18326 | |
18327 | =item METHODS | |
18328 | ||
18329 | login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), | |
91e033c7 NC |
18330 | site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME |
18331 | ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [, | |
d3ca9f77 NC |
18332 | RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls ( |
18333 | [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), | |
18334 | put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE | |
18335 | ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), | |
18336 | size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[ | |
18337 | BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ), | |
18338 | stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (), | |
18339 | pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique ( | |
18340 | SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ), | |
18341 | abort (), quit () | |
ee382f2f JH |
18342 | |
18343 | =over 4 | |
18344 | ||
18345 | =item Methods for the adventurous | |
18346 | ||
18347 | quot (CMD [,ARGS]) | |
18348 | ||
18349 | =back | |
18350 | ||
18351 | =item THE dataconn CLASS | |
18352 | ||
18353 | read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), | |
18354 | bytes_read (), abort (), close () | |
18355 | ||
18356 | =item UNIMPLEMENTED | |
18357 | ||
6e76d345 | 18358 | B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN> |
ee382f2f JH |
18359 | |
18360 | =item REPORTING BUGS | |
18361 | ||
18362 | =item AUTHOR | |
18363 | ||
18364 | =item SEE ALSO | |
18365 | ||
18366 | =item USE EXAMPLES | |
18367 | ||
91e033c7 | 18368 | http://www.csh.rit.edu/~adam/Progs/ |
ee382f2f JH |
18369 | |
18370 | =item CREDITS | |
18371 | ||
18372 | =item COPYRIGHT | |
18373 | ||
18374 | =back | |
18375 | ||
18376 | =head2 Net::NNTP - NNTP Client class | |
18377 | ||
18378 | =over 4 | |
18379 | ||
18380 | =item SYNOPSIS | |
18381 | ||
18382 | =item DESCRIPTION | |
18383 | ||
18384 | =item CONSTRUCTOR | |
18385 | ||
18386 | new ( [ HOST ] [, OPTIONS ]) | |
18387 | ||
18388 | =item METHODS | |
18389 | ||
18390 | article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( | |
18391 | [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [ | |
18392 | MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ] | |
18393 | ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (), | |
18394 | postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [, | |
18395 | DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), | |
18396 | post ( [ MESSAGE ] ), postfh (), slave (), quit () | |
18397 | ||
18398 | =over 4 | |
18399 | ||
18400 | =item Extension methods | |
18401 | ||
18402 | newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), | |
18403 | overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN | |
18404 | ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( | |
18405 | MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ | |
18406 | GROUP ] ), reader | |
18407 | ||
18408 | =back | |
18409 | ||
18410 | =item UNSUPPORTED | |
18411 | ||
18412 | =item DEFINITIONS | |
18413 | ||
18414 | MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d> | |
18415 | ||
18416 | =item SEE ALSO | |
18417 | ||
18418 | =item AUTHOR | |
18419 | ||
18420 | =item COPYRIGHT | |
18421 | ||
18422 | =back | |
18423 | ||
18424 | =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939) | |
18425 | ||
18426 | =over 4 | |
18427 | ||
18428 | =item SYNOPSIS | |
18429 | ||
18430 | =item DESCRIPTION | |
18431 | ||
ee382f2f JH |
18432 | =item CONSTRUCTOR |
18433 | ||
d3ca9f77 | 18434 | new ( [ HOST ] [, OPTIONS ] 0 |
ee382f2f JH |
18435 | |
18436 | =item METHODS | |
18437 | ||
d3ca9f77 NC |
18438 | auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER |
18439 | [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities | |
18440 | (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ] | |
18441 | ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] | |
18442 | ), delete ( MSGNUM ), reset (), quit () | |
ee382f2f JH |
18443 | |
18444 | =item NOTES | |
18445 | ||
18446 | =item SEE ALSO | |
18447 | ||
18448 | =item AUTHOR | |
18449 | ||
18450 | =item COPYRIGHT | |
18451 | ||
18452 | =back | |
18453 | ||
18454 | =head2 Net::Ping - check a remote host for reachability | |
18455 | ||
18456 | =over 4 | |
18457 | ||
18458 | =item SYNOPSIS | |
18459 | ||
18460 | =item DESCRIPTION | |
18461 | ||
18462 | =over 4 | |
18463 | ||
18464 | =item Functions | |
18465 | ||
73fba812 JH |
18466 | Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos |
18467 | ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );, | |
ee382f2f JH |
18468 | $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );, |
18469 | $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( | |
18470 | [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host | |
18471 | [, $timeout]); | |
18472 | ||
18473 | =back | |
18474 | ||
18475 | =item NOTES | |
18476 | ||
18477 | =item INSTALL | |
18478 | ||
18479 | =item BUGS | |
18480 | ||
18481 | =item AUTHORS | |
18482 | ||
18483 | =item COPYRIGHT | |
18484 | ||
18485 | =back | |
18486 | ||
18487 | =head2 Net::SMTP - Simple Mail Transfer Protocol Client | |
18488 | ||
18489 | =over 4 | |
18490 | ||
18491 | =item SYNOPSIS | |
18492 | ||
18493 | =item DESCRIPTION | |
18494 | ||
18495 | =item EXAMPLES | |
18496 | ||
18497 | =item CONSTRUCTOR | |
18498 | ||
d3ca9f77 | 18499 | new ( [ HOST ] [, OPTIONS ] ) |
ee382f2f JH |
18500 | |
18501 | =item METHODS | |
18502 | ||
d3ca9f77 NC |
18503 | banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth ( |
18504 | USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), | |
18505 | send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( | |
18506 | ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] | |
18507 | ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), | |
18508 | data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ | |
18509 | $subject ] ), quit () | |
ee382f2f JH |
18510 | |
18511 | =item ADDRESSES | |
18512 | ||
18513 | =item SEE ALSO | |
18514 | ||
18515 | =item AUTHOR | |
18516 | ||
18517 | =item COPYRIGHT | |
18518 | ||
18519 | =back | |
18520 | ||
18521 | =head2 Net::Time - time and daytime network client interface | |
18522 | ||
18523 | =over 4 | |
18524 | ||
18525 | =item SYNOPSIS | |
18526 | ||
18527 | =item DESCRIPTION | |
18528 | ||
18529 | inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, | |
18530 | PROTOCOL [, TIMEOUT]]]) | |
18531 | ||
18532 | =item AUTHOR | |
18533 | ||
18534 | =item COPYRIGHT | |
18535 | ||
18536 | =back | |
18537 | ||
18538 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() | |
18539 | functions | |
18540 | ||
18541 | =over 4 | |
18542 | ||
18543 | =item SYNOPSIS | |
18544 | ||
18545 | =item DESCRIPTION | |
18546 | ||
18547 | =item EXAMPLES | |
18548 | ||
18549 | =item NOTE | |
18550 | ||
18551 | =item AUTHOR | |
18552 | ||
18553 | =back | |
18554 | ||
18555 | =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions | |
18556 | ||
18557 | =over 4 | |
18558 | ||
18559 | =item DESCRIPTION | |
18560 | ||
18561 | =over 4 | |
18562 | ||
18563 | =item Where to get this document | |
18564 | ||
18565 | =item How to contribute to this document | |
18566 | ||
18567 | =back | |
18568 | ||
18569 | =item Author and Copyright Information | |
18570 | ||
18571 | =over 4 | |
18572 | ||
18573 | =item Disclaimer | |
18574 | ||
18575 | =back | |
18576 | ||
18577 | =item Obtaining and installing libnet | |
18578 | ||
18579 | =over 4 | |
18580 | ||
18581 | =item What is libnet ? | |
18582 | ||
18583 | =item Which version of perl do I need ? | |
18584 | ||
18585 | =item What other modules do I need ? | |
18586 | ||
18587 | =item What machines support libnet ? | |
18588 | ||
18589 | =item Where can I get the latest libnet release | |
18590 | ||
18591 | =back | |
18592 | ||
18593 | =item Using Net::FTP | |
18594 | ||
18595 | =over 4 | |
18596 | ||
18597 | =item How do I download files from an FTP server ? | |
18598 | ||
18599 | =item How do I transfer files in binary mode ? | |
18600 | ||
18601 | =item How can I get the size of a file on a remote FTP server ? | |
18602 | ||
18603 | =item How can I get the modification time of a file on a remote FTP server | |
18604 | ? | |
18605 | ||
18606 | =item How can I change the permissions of a file on a remote server ? | |
18607 | ||
18608 | =item Can I do a reget operation like the ftp command ? | |
18609 | ||
18610 | =item How do I get a directory listing from an FTP server ? | |
18611 | ||
18612 | =item Changing directory to "" does not fail ? | |
18613 | ||
18614 | =item I am behind a SOCKS firewall, but the Firewall option does not work ? | |
18615 | ||
18616 | =item I am behind an FTP proxy firewall, but cannot access machines outside | |
18617 | ? | |
18618 | ||
18619 | =item My ftp proxy firewall does not listen on port 21 | |
18620 | ||
18621 | =item Is it possible to change the file permissions of a file on an FTP | |
18622 | server ? | |
18623 | ||
18624 | =item I have seen scripts call a method message, but cannot find it | |
18625 | documented ? | |
18626 | ||
18627 | =item Why does Net::FTP not implement mput and mget methods | |
18628 | ||
18629 | =back | |
18630 | ||
18631 | =item Using Net::SMTP | |
18632 | ||
18633 | =over 4 | |
18634 | ||
18635 | =item Why can't the part of an Email address after the @ be used as the | |
18636 | hostname ? | |
18637 | ||
18638 | =item Why does Net::SMTP not do DNS MX lookups ? | |
18639 | ||
18640 | =item The verify method always returns true ? | |
18641 | ||
18642 | =back | |
18643 | ||
18644 | =item Debugging scripts | |
18645 | ||
18646 | =over 4 | |
18647 | ||
18648 | =item How can I debug my scripts that use Net::* modules ? | |
18649 | ||
18650 | =back | |
18651 | ||
18652 | =item AUTHOR AND COPYRIGHT | |
18653 | ||
18654 | =back | |
18655 | ||
18656 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() | |
18657 | functions | |
18658 | ||
18659 | =over 4 | |
18660 | ||
18661 | =item SYNOPSIS | |
18662 | ||
18663 | =item DESCRIPTION | |
18664 | ||
18665 | =item EXAMPLES | |
18666 | ||
18667 | =item NOTE | |
18668 | ||
18669 | =item AUTHOR | |
18670 | ||
18671 | =back | |
18672 | ||
18673 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() | |
18674 | functions | |
18675 | ||
18676 | =over 4 | |
18677 | ||
18678 | =item SYNOPSIS | |
18679 | ||
18680 | =item DESCRIPTION | |
18681 | ||
18682 | =item NOTE | |
18683 | ||
18684 | =item AUTHOR | |
18685 | ||
18686 | =back | |
18687 | ||
18688 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() | |
18689 | functions | |
18690 | ||
18691 | =over 4 | |
18692 | ||
18693 | =item SYNOPSIS | |
18694 | ||
18695 | =item DESCRIPTION | |
18696 | ||
18697 | =item EXAMPLES | |
18698 | ||
18699 | =item NOTE | |
18700 | ||
18701 | =item AUTHOR | |
18702 | ||
18703 | =back | |
18704 | ||
18705 | =head2 Netrc, Net::Netrc - OO interface to users netrc file | |
18706 | ||
18707 | =over 4 | |
18708 | ||
18709 | =item SYNOPSIS | |
18710 | ||
18711 | =item DESCRIPTION | |
18712 | ||
18713 | =item THE .netrc FILE | |
18714 | ||
18715 | machine name, default, login name, password string, account string, macdef | |
18716 | name | |
18717 | ||
18718 | =item CONSTRUCTOR | |
18719 | ||
18720 | lookup ( MACHINE [, LOGIN ]) | |
18721 | ||
18722 | =item METHODS | |
18723 | ||
18724 | login (), password (), account (), lpa () | |
18725 | ||
18726 | =item AUTHOR | |
18727 | ||
18728 | =item SEE ALSO | |
18729 | ||
18730 | =item COPYRIGHT | |
18731 | ||
18732 | =back | |
18733 | ||
18734 | =head2 O - Generic interface to Perl Compiler backends | |
18735 | ||
18736 | =over 4 | |
18737 | ||
18738 | =item SYNOPSIS | |
18739 | ||
18740 | =item DESCRIPTION | |
18741 | ||
18742 | =item CONVENTIONS | |
18743 | ||
18744 | =item IMPLEMENTATION | |
18745 | ||
18746 | =item BUGS | |
18747 | ||
18748 | =item AUTHOR | |
18749 | ||
18750 | =back | |
18751 | ||
18752 | =head2 ODBM_File - Tied access to odbm files | |
18753 | ||
18754 | =over 4 | |
18755 | ||
18756 | =item SYNOPSIS | |
18757 | ||
18758 | =item DESCRIPTION | |
18759 | ||
18760 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
18761 | ||
18762 | =item DIAGNOSTICS | |
18763 | ||
18764 | =over 4 | |
18765 | ||
18766 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
18767 | ||
18768 | =back | |
18769 | ||
18770 | =item BUGS AND WARNINGS | |
18771 | ||
18772 | =back | |
18773 | ||
18774 | =head2 Opcode - Disable named opcodes when compiling perl code | |
18775 | ||
18776 | =over 4 | |
18777 | ||
18778 | =item SYNOPSIS | |
18779 | ||
18780 | =item DESCRIPTION | |
18781 | ||
18782 | =item NOTE | |
18783 | ||
18784 | =item WARNING | |
18785 | ||
18786 | =item Operator Names and Operator Lists | |
18787 | ||
18788 | an operator name (opname), an operator tag name (optag), a negated opname | |
18789 | or optag, an operator set (opset) | |
18790 | ||
18791 | =item Opcode Functions | |
18792 | ||
18793 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), | |
18794 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
18795 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
18796 | opdump (PAT) | |
18797 | ||
18798 | =item Manipulating Opsets | |
18799 | ||
18800 | =item TO DO (maybe) | |
18801 | ||
18802 | =back | |
18803 | ||
18804 | =over 4 | |
18805 | ||
18806 | =item Predefined Opcode Tags | |
18807 | ||
18808 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, | |
18809 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, | |
18810 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
18811 | :dangerous | |
18812 | ||
18813 | =item SEE ALSO | |
18814 | ||
18815 | =item AUTHORS | |
18816 | ||
18817 | =back | |
18818 | ||
18819 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted | |
18820 | compartments | |
18821 | ||
18822 | =over 4 | |
18823 | ||
18824 | =item SYNOPSIS | |
18825 | ||
18826 | =item DESCRIPTION | |
18827 | ||
18828 | a new namespace, an operator mask | |
18829 | ||
18830 | =item WARNING | |
18831 | ||
18832 | =over 4 | |
18833 | ||
18834 | =item RECENT CHANGES | |
18835 | ||
18836 | =item Methods in class Safe | |
18837 | ||
18838 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
18839 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
18840 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
18841 | root (NAMESPACE), mask (MASK) | |
18842 | ||
18843 | =item Some Safety Issues | |
18844 | ||
18845 | Memory, CPU, Snooping, Signals, State Changes | |
18846 | ||
18847 | =item AUTHOR | |
18848 | ||
18849 | =back | |
18850 | ||
18851 | =back | |
18852 | ||
18853 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when | |
18854 | compiling | |
18855 | ||
18856 | =over 4 | |
18857 | ||
18858 | =item SYNOPSIS | |
18859 | ||
18860 | =item DESCRIPTION | |
18861 | ||
18862 | =item SEE ALSO | |
18863 | ||
18864 | =back | |
18865 | ||
18866 | =head2 POSIX - Perl interface to IEEE Std 1003.1 | |
18867 | ||
18868 | =over 4 | |
18869 | ||
18870 | =item SYNOPSIS | |
18871 | ||
18872 | =item DESCRIPTION | |
18873 | ||
18874 | =item NOTE | |
18875 | ||
18876 | =item CAVEATS | |
18877 | ||
18878 | =item FUNCTIONS | |
18879 | ||
18880 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, | |
18881 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
18882 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
18883 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
18884 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
18885 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
18886 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
18887 | fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, | |
18888 | geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, | |
18889 | getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, | |
18890 | isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, | |
18891 | isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, | |
18892 | log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, | |
18893 | memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, | |
18894 | offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, | |
18895 | putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, | |
18896 | rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, | |
18897 | setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
18898 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
18899 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
18900 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, | |
18901 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
18902 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
18903 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
18904 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
18905 | wctomb, write | |
18906 | ||
18907 | =item CLASSES | |
18908 | ||
18909 | =over 4 | |
18910 | ||
18911 | =item POSIX::SigAction | |
18912 | ||
73fba812 | 18913 | new, handler, mask, flags, safe |
ee382f2f JH |
18914 | |
18915 | =item POSIX::SigSet | |
18916 | ||
18917 | new, addset, delset, emptyset, fillset, ismember | |
18918 | ||
18919 | =item POSIX::Termios | |
18920 | ||
18921 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, | |
18922 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
18923 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
18924 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
18925 | values, c_oflag field values | |
18926 | ||
18927 | =back | |
18928 | ||
18929 | =item PATHNAME CONSTANTS | |
18930 | ||
18931 | Constants | |
18932 | ||
18933 | =item POSIX CONSTANTS | |
18934 | ||
18935 | Constants | |
18936 | ||
18937 | =item SYSTEM CONFIGURATION | |
18938 | ||
18939 | Constants | |
18940 | ||
18941 | =item ERRNO | |
18942 | ||
18943 | Constants | |
18944 | ||
18945 | =item FCNTL | |
18946 | ||
18947 | Constants | |
18948 | ||
18949 | =item FLOAT | |
18950 | ||
18951 | Constants | |
18952 | ||
18953 | =item LIMITS | |
18954 | ||
18955 | Constants | |
18956 | ||
18957 | =item LOCALE | |
18958 | ||
18959 | Constants | |
18960 | ||
18961 | =item MATH | |
18962 | ||
18963 | Constants | |
18964 | ||
18965 | =item SIGNAL | |
18966 | ||
18967 | Constants | |
18968 | ||
18969 | =item STAT | |
18970 | ||
18971 | Constants, Macros | |
18972 | ||
18973 | =item STDLIB | |
18974 | ||
18975 | Constants | |
18976 | ||
18977 | =item STDIO | |
18978 | ||
18979 | Constants | |
18980 | ||
18981 | =item TIME | |
18982 | ||
18983 | Constants | |
18984 | ||
18985 | =item UNISTD | |
18986 | ||
18987 | Constants | |
18988 | ||
18989 | =item WAIT | |
18990 | ||
18991 | Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED, | |
18992 | WTERMSIG, WIFSTOPPED, WSTOPSIG | |
18993 | ||
18994 | =back | |
18995 | ||
18996 | =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::* | |
18997 | name space | |
18998 | ||
18999 | =over 4 | |
19000 | ||
19001 | =item SYNOPSIS | |
19002 | ||
19003 | =item DESCRIPTION | |
19004 | ||
c66ca2ac | 19005 | :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32 |
ee382f2f JH |
19006 | |
19007 | =over 4 | |
19008 | ||
19009 | =item Custom Layers | |
19010 | ||
19011 | :encoding, :via | |
19012 | ||
19013 | =item Alternatives to raw | |
19014 | ||
19015 | =item Defaults and how to override them | |
19016 | ||
ef7b71f0 | 19017 | =item Querying the layers of filehandles |
ee382f2f JH |
19018 | |
19019 | =back | |
19020 | ||
19021 | =item AUTHOR | |
19022 | ||
19023 | =item SEE ALSO | |
19024 | ||
19025 | =back | |
19026 | ||
19027 | =head2 PerlIO::encoding - encoding layer | |
19028 | ||
19029 | =over 4 | |
19030 | ||
19031 | =item SYNOPSIS | |
19032 | ||
19033 | =item DESCRIPTION | |
19034 | ||
19035 | =item SEE ALSO | |
19036 | ||
19037 | =back | |
19038 | ||
cd458e05 | 19039 | =head2 PerlIO::scalar - in-memory IO, scalar IO |
ee382f2f JH |
19040 | |
19041 | =over 4 | |
19042 | ||
19043 | =item SYNOPSIS | |
19044 | ||
19045 | =item DESCRIPTION | |
19046 | ||
cd458e05 JH |
19047 | =item IMPLEMENTATION NOTE |
19048 | ||
ee382f2f JH |
19049 | =back |
19050 | ||
19051 | =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl | |
19052 | ||
19053 | =over 4 | |
19054 | ||
19055 | =item SYNOPSIS | |
19056 | ||
19057 | =item DESCRIPTION | |
19058 | ||
19059 | =item EXPECTED METHODS | |
19060 | ||
19061 | $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]), | |
7550e1ad JH |
19062 | $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]), |
19063 | $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]), | |
19064 | $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh), | |
19065 | $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh), | |
19066 | $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh), | |
19067 | $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh), | |
19068 | $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh) | |
ee382f2f JH |
19069 | |
19070 | =item EXAMPLES | |
19071 | ||
19072 | =over 4 | |
19073 | ||
19074 | =item Example - a Hexadecimal Handle | |
19075 | ||
19076 | =back | |
19077 | ||
19078 | =back | |
19079 | ||
19080 | =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings | |
19081 | ||
19082 | =over 4 | |
19083 | ||
19084 | =item SYNOPSIS | |
19085 | ||
19086 | =item DESCRIPTION | |
19087 | ||
4c64e75b NC |
19088 | =item REQUIRED MODULES |
19089 | ||
ee382f2f JH |
19090 | =item SEE ALSO |
19091 | ||
50e34432 JH |
19092 | =item ACKNOWLEDGEMENTS |
19093 | ||
ee382f2f JH |
19094 | =item COPYRIGHT |
19095 | ||
19096 | =back | |
19097 | ||
19098 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors | |
19099 | ||
19100 | =over 4 | |
19101 | ||
19102 | =item SYNOPSIS | |
19103 | ||
19104 | =item OPTIONS/ARGUMENTS | |
19105 | ||
19106 | =over 4 | |
19107 | ||
19108 | =item podchecker() | |
19109 | ||
19110 | B<-warnings> =E<gt> I<val> | |
19111 | ||
19112 | =back | |
19113 | ||
19114 | =item DESCRIPTION | |
19115 | ||
19116 | =item DIAGNOSTICS | |
19117 | ||
19118 | =over 4 | |
19119 | ||
19120 | =item Errors | |
19121 | ||
19122 | empty =headn, =over on line I<N> without closing =back, =item without | |
19123 | previous =over, =back without previous =over, No argument for =begin, =end | |
19124 | without =begin, Nested =begin's, =for without formatter specification, | |
19125 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
19126 | interior-sequence "I<SEQ>", nested commands | |
19127 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
19128 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
19129 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
19130 | after =back | |
19131 | ||
19132 | =item Warnings | |
19133 | ||
19134 | multiple occurrence of link target I<name>, line containing nothing but | |
19135 | whitespace in paragraph, file does not start with =head, previous =item has | |
19136 | no contents, preceding non-item paragraph(s), =item type mismatch (I<one> | |
19137 | vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No | |
19138 | items in =over, No argument for =item, empty section in previous paragraph, | |
19139 | Verbatim paragraph in NAME section, =headI<n> without preceding higher | |
19140 | level | |
19141 | ||
19142 | =item Hyperlinks | |
19143 | ||
19144 | ignoring leading/trailing whitespace in link, (section) in '$page' | |
19145 | deprecated, alternative text/node '%s' contains non-escaped | or / | |
19146 | ||
19147 | =back | |
19148 | ||
19149 | =item RETURN VALUE | |
19150 | ||
19151 | =item EXAMPLES | |
19152 | ||
19153 | =item INTERFACE | |
19154 | ||
19155 | =back | |
19156 | ||
19157 | C<Pod::Checker-E<gt>new( %options )> | |
19158 | ||
19159 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, | |
19160 | @args )> | |
19161 | ||
19162 | C<$checker-E<gt>num_errors()> | |
19163 | ||
19164 | C<$checker-E<gt>num_warnings()> | |
19165 | ||
19166 | C<$checker-E<gt>name()> | |
19167 | ||
19168 | C<$checker-E<gt>node()> | |
19169 | ||
19170 | C<$checker-E<gt>idx()> | |
19171 | ||
19172 | C<$checker-E<gt>hyperlink()> | |
19173 | ||
19174 | =over 4 | |
19175 | ||
19176 | =item AUTHOR | |
19177 | ||
19178 | =back | |
19179 | ||
19180 | =head2 Pod::Find - find POD documents in directory trees | |
19181 | ||
19182 | =over 4 | |
19183 | ||
19184 | =item SYNOPSIS | |
19185 | ||
19186 | =item DESCRIPTION | |
19187 | ||
19188 | =back | |
19189 | ||
19190 | =over 4 | |
19191 | ||
19192 | =item C<pod_find( { %opts } , @directories )> | |
19193 | ||
19194 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> | |
19195 | 1> | |
19196 | ||
19197 | =back | |
19198 | ||
19199 | =over 4 | |
19200 | ||
19201 | =item C<simplify_name( $str )> | |
19202 | ||
19203 | =back | |
19204 | ||
19205 | =over 4 | |
19206 | ||
19207 | =item C<pod_where( { %opts }, $pod )> | |
19208 | ||
19209 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
19210 | 1> | |
19211 | ||
19212 | =back | |
19213 | ||
19214 | =over 4 | |
19215 | ||
19216 | =item C<contains_pod( $file , $verbose )> | |
19217 | ||
19218 | =back | |
19219 | ||
19220 | =over 4 | |
19221 | ||
19222 | =item AUTHOR | |
19223 | ||
19224 | =item SEE ALSO | |
19225 | ||
19226 | =back | |
19227 | ||
19228 | =head2 Pod::Html - module to convert pod files to HTML | |
19229 | ||
19230 | =over 4 | |
19231 | ||
19232 | =item SYNOPSIS | |
19233 | ||
19234 | =item DESCRIPTION | |
19235 | ||
19236 | =item ARGUMENTS | |
19237 | ||
7a5cdbdf AJ |
19238 | backlink, cachedir, css, flush, header, help, hiddendirs, htmldir, |
19239 | htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot, | |
19240 | quiet, recurse, title, verbose | |
ee382f2f JH |
19241 | |
19242 | =item EXAMPLE | |
19243 | ||
19244 | =item ENVIRONMENT | |
19245 | ||
19246 | =item AUTHOR | |
19247 | ||
19248 | =item SEE ALSO | |
19249 | ||
19250 | =item COPYRIGHT | |
19251 | ||
19252 | =back | |
19253 | ||
19254 | =head2 Pod::InputObjects - objects representing POD input paragraphs, | |
19255 | commands, etc. | |
19256 | ||
19257 | =over 4 | |
19258 | ||
19259 | =item SYNOPSIS | |
19260 | ||
19261 | =item REQUIRES | |
19262 | ||
19263 | =item EXPORTS | |
19264 | ||
19265 | =item DESCRIPTION | |
19266 | ||
19267 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package | |
19268 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
19269 | ||
19270 | =back | |
19271 | ||
19272 | =over 4 | |
19273 | ||
19274 | =item B<Pod::InputSource> | |
19275 | ||
19276 | =back | |
19277 | ||
19278 | =over 4 | |
19279 | ||
19280 | =item B<new()> | |
19281 | ||
19282 | =back | |
19283 | ||
19284 | =over 4 | |
19285 | ||
19286 | =item B<name()> | |
19287 | ||
19288 | =back | |
19289 | ||
19290 | =over 4 | |
19291 | ||
19292 | =item B<handle()> | |
19293 | ||
19294 | =back | |
19295 | ||
19296 | =over 4 | |
19297 | ||
19298 | =item B<was_cutting()> | |
19299 | ||
19300 | =back | |
19301 | ||
19302 | =over 4 | |
19303 | ||
19304 | =item B<Pod::Paragraph> | |
19305 | ||
19306 | =back | |
19307 | ||
19308 | =over 4 | |
19309 | ||
19310 | =item Pod::Paragraph-E<gt>B<new()> | |
19311 | ||
19312 | =back | |
19313 | ||
19314 | =over 4 | |
19315 | ||
19316 | =item $pod_para-E<gt>B<cmd_name()> | |
19317 | ||
19318 | =back | |
19319 | ||
19320 | =over 4 | |
19321 | ||
19322 | =item $pod_para-E<gt>B<text()> | |
19323 | ||
19324 | =back | |
19325 | ||
19326 | =over 4 | |
19327 | ||
19328 | =item $pod_para-E<gt>B<raw_text()> | |
19329 | ||
19330 | =back | |
19331 | ||
19332 | =over 4 | |
19333 | ||
19334 | =item $pod_para-E<gt>B<cmd_prefix()> | |
19335 | ||
19336 | =back | |
19337 | ||
19338 | =over 4 | |
19339 | ||
19340 | =item $pod_para-E<gt>B<cmd_separator()> | |
19341 | ||
19342 | =back | |
19343 | ||
19344 | =over 4 | |
19345 | ||
19346 | =item $pod_para-E<gt>B<parse_tree()> | |
19347 | ||
19348 | =back | |
19349 | ||
19350 | =over 4 | |
19351 | ||
19352 | =item $pod_para-E<gt>B<file_line()> | |
19353 | ||
19354 | =back | |
19355 | ||
19356 | =over 4 | |
19357 | ||
19358 | =item B<Pod::InteriorSequence> | |
19359 | ||
19360 | =back | |
19361 | ||
19362 | =over 4 | |
19363 | ||
19364 | =item Pod::InteriorSequence-E<gt>B<new()> | |
19365 | ||
19366 | =back | |
19367 | ||
19368 | =over 4 | |
19369 | ||
19370 | =item $pod_seq-E<gt>B<cmd_name()> | |
19371 | ||
19372 | =back | |
19373 | ||
19374 | =over 4 | |
19375 | ||
19376 | =item $pod_seq-E<gt>B<prepend()> | |
19377 | ||
19378 | =back | |
19379 | ||
19380 | =over 4 | |
19381 | ||
19382 | =item $pod_seq-E<gt>B<append()> | |
19383 | ||
19384 | =back | |
19385 | ||
19386 | =over 4 | |
19387 | ||
19388 | =item $pod_seq-E<gt>B<nested()> | |
19389 | ||
19390 | =back | |
19391 | ||
19392 | =over 4 | |
19393 | ||
19394 | =item $pod_seq-E<gt>B<raw_text()> | |
19395 | ||
19396 | =back | |
19397 | ||
19398 | =over 4 | |
19399 | ||
19400 | =item $pod_seq-E<gt>B<left_delimiter()> | |
19401 | ||
19402 | =back | |
19403 | ||
19404 | =over 4 | |
19405 | ||
19406 | =item $pod_seq-E<gt>B<right_delimiter()> | |
19407 | ||
19408 | =back | |
19409 | ||
19410 | =over 4 | |
19411 | ||
19412 | =item $pod_seq-E<gt>B<parse_tree()> | |
19413 | ||
19414 | =back | |
19415 | ||
19416 | =over 4 | |
19417 | ||
19418 | =item $pod_seq-E<gt>B<file_line()> | |
19419 | ||
19420 | =back | |
19421 | ||
19422 | =over 4 | |
19423 | ||
19424 | =item Pod::InteriorSequence::B<DESTROY()> | |
19425 | ||
19426 | =back | |
19427 | ||
19428 | =over 4 | |
19429 | ||
19430 | =item B<Pod::ParseTree> | |
19431 | ||
19432 | =back | |
19433 | ||
19434 | =over 4 | |
19435 | ||
19436 | =item Pod::ParseTree-E<gt>B<new()> | |
19437 | ||
19438 | =back | |
19439 | ||
19440 | =over 4 | |
19441 | ||
19442 | =item $ptree-E<gt>B<top()> | |
19443 | ||
19444 | =back | |
19445 | ||
19446 | =over 4 | |
19447 | ||
19448 | =item $ptree-E<gt>B<children()> | |
19449 | ||
19450 | =back | |
19451 | ||
19452 | =over 4 | |
19453 | ||
19454 | =item $ptree-E<gt>B<prepend()> | |
19455 | ||
19456 | =back | |
19457 | ||
19458 | =over 4 | |
19459 | ||
19460 | =item $ptree-E<gt>B<append()> | |
19461 | ||
19462 | =back | |
19463 | ||
19464 | =over 4 | |
19465 | ||
19466 | =item $ptree-E<gt>B<raw_text()> | |
19467 | ||
19468 | =back | |
19469 | ||
19470 | =over 4 | |
19471 | ||
19472 | =item Pod::ParseTree::B<DESTROY()> | |
19473 | ||
19474 | =back | |
19475 | ||
19476 | =over 4 | |
19477 | ||
19478 | =item SEE ALSO | |
19479 | ||
19480 | =item AUTHOR | |
19481 | ||
19482 | =back | |
19483 | ||
19484 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex | |
19485 | ||
19486 | =over 4 | |
19487 | ||
19488 | =item SYNOPSIS | |
19489 | ||
19490 | =item DESCRIPTION | |
19491 | ||
19492 | =back | |
19493 | ||
19494 | =over 4 | |
19495 | ||
19496 | =item OBJECT METHODS | |
19497 | ||
19498 | C<initialize> | |
19499 | ||
19500 | =back | |
19501 | ||
19502 | =over 4 | |
19503 | ||
19504 | =item Data Accessors | |
19505 | ||
19506 | B<AddPreamble> | |
19507 | ||
19508 | =back | |
19509 | ||
19510 | B<AddPostamble> | |
19511 | ||
19512 | B<Head1Level> | |
19513 | ||
19514 | B<Label> | |
19515 | ||
19516 | B<LevelNoNum> | |
19517 | ||
19518 | B<MakeIndex> | |
19519 | ||
19520 | B<ReplaceNAMEwithSection> | |
19521 | ||
19522 | B<StartWithNewPage> | |
19523 | ||
19524 | B<TableOfContents> | |
19525 | ||
19526 | B<UniqueLabels> | |
19527 | ||
19528 | B<UserPreamble> | |
19529 | ||
19530 | B<UserPostamble> | |
19531 | ||
19532 | B<Lists> | |
19533 | ||
19534 | =over 4 | |
19535 | ||
19536 | =item Subclassed methods | |
19537 | ||
19538 | =back | |
19539 | ||
19540 | B<begin_pod> | |
19541 | ||
19542 | B<end_pod> | |
19543 | ||
19544 | B<command> | |
19545 | ||
19546 | B<verbatim> | |
19547 | ||
19548 | B<textblock> | |
19549 | ||
19550 | B<interior_sequence> | |
19551 | ||
19552 | =over 4 | |
19553 | ||
19554 | =item List Methods | |
19555 | ||
19556 | B<begin_list> | |
19557 | ||
19558 | =back | |
19559 | ||
19560 | B<end_list> | |
19561 | ||
19562 | B<add_item> | |
19563 | ||
19564 | =over 4 | |
19565 | ||
19566 | =item Methods for headings | |
19567 | ||
19568 | B<head> | |
19569 | ||
19570 | =back | |
19571 | ||
19572 | =over 4 | |
19573 | ||
19574 | =item Internal methods | |
19575 | ||
19576 | B<_output> | |
19577 | ||
19578 | =back | |
19579 | ||
19580 | B<_replace_special_chars> | |
19581 | ||
19582 | B<_replace_special_chars_late> | |
19583 | ||
19584 | B<_create_label> | |
19585 | ||
19586 | B<_create_index> | |
19587 | ||
19588 | B<_clean_latex_commands> | |
19589 | ||
19590 | B<_split_delimited> | |
19591 | ||
19592 | =over 4 | |
19593 | ||
19594 | =item NOTES | |
19595 | ||
19596 | =item SEE ALSO | |
19597 | ||
19598 | =item AUTHORS | |
19599 | ||
19600 | =item COPYRIGHT | |
19601 | ||
19602 | =item REVISION | |
19603 | ||
19604 | =back | |
19605 | ||
19606 | =head2 Pod::Man - Convert POD data to formatted *roff input | |
19607 | ||
19608 | =over 4 | |
19609 | ||
19610 | =item SYNOPSIS | |
19611 | ||
19612 | =item DESCRIPTION | |
19613 | ||
19614 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes, | |
19615 | release, section | |
19616 | ||
19617 | =item DIAGNOSTICS | |
19618 | ||
19619 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote | |
19620 | specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown | |
19621 | escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched | |
19622 | =back | |
19623 | ||
19624 | =item BUGS | |
19625 | ||
19626 | =item CAVEATS | |
19627 | ||
19628 | =item SEE ALSO | |
19629 | ||
19630 | =item AUTHOR | |
19631 | ||
19632 | =item COPYRIGHT AND LICENSE | |
19633 | ||
19634 | =back | |
19635 | ||
19636 | =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text | |
19637 | ||
19638 | =over 4 | |
19639 | ||
19640 | =item SYNOPSIS | |
19641 | ||
19642 | =item DESCRIPTION | |
19643 | ||
19644 | =item SEE ALSO | |
19645 | ||
19646 | =item AUTHOR | |
19647 | ||
19648 | =item COPYRIGHT AND LICENSE | |
19649 | ||
19650 | =back | |
19651 | ||
19652 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion | |
19653 | ||
19654 | =over 4 | |
19655 | ||
19656 | =item SYNOPSIS | |
19657 | ||
19658 | =item DESCRIPTION | |
19659 | ||
19660 | =back | |
19661 | ||
19662 | =over 4 | |
19663 | ||
19664 | =item Pod::List | |
19665 | ||
19666 | Pod::List-E<gt>new() | |
19667 | ||
19668 | =back | |
19669 | ||
19670 | $list-E<gt>file() | |
19671 | ||
19672 | $list-E<gt>start() | |
19673 | ||
19674 | $list-E<gt>indent() | |
19675 | ||
19676 | $list-E<gt>type() | |
19677 | ||
19678 | $list-E<gt>rx() | |
19679 | ||
19680 | $list-E<gt>item() | |
19681 | ||
19682 | $list-E<gt>parent() | |
19683 | ||
19684 | $list-E<gt>tag() | |
19685 | ||
19686 | =over 4 | |
19687 | ||
19688 | =item Pod::Hyperlink | |
19689 | ||
19690 | Pod::Hyperlink-E<gt>new() | |
19691 | ||
19692 | =back | |
19693 | ||
19694 | $link-E<gt>parse($string) | |
19695 | ||
19696 | $link-E<gt>markup($string) | |
19697 | ||
19698 | $link-E<gt>text() | |
19699 | ||
19700 | $link-E<gt>warning() | |
19701 | ||
19702 | $link-E<gt>file(), $link-E<gt>line() | |
19703 | ||
19704 | $link-E<gt>page() | |
19705 | ||
19706 | $link-E<gt>node() | |
19707 | ||
19708 | $link-E<gt>alttext() | |
19709 | ||
19710 | $link-E<gt>type() | |
19711 | ||
19712 | $link-E<gt>link() | |
19713 | ||
19714 | =over 4 | |
19715 | ||
19716 | =item Pod::Cache | |
19717 | ||
19718 | Pod::Cache-E<gt>new() | |
19719 | ||
19720 | =back | |
19721 | ||
19722 | $cache-E<gt>item() | |
19723 | ||
19724 | $cache-E<gt>find_page($name) | |
19725 | ||
19726 | =over 4 | |
19727 | ||
19728 | =item Pod::Cache::Item | |
19729 | ||
19730 | Pod::Cache::Item-E<gt>new() | |
19731 | ||
19732 | =back | |
19733 | ||
19734 | $cacheitem-E<gt>page() | |
19735 | ||
19736 | $cacheitem-E<gt>description() | |
19737 | ||
19738 | $cacheitem-E<gt>path() | |
19739 | ||
19740 | $cacheitem-E<gt>file() | |
19741 | ||
19742 | $cacheitem-E<gt>nodes() | |
19743 | ||
19744 | $cacheitem-E<gt>find_node($name) | |
19745 | ||
19746 | $cacheitem-E<gt>idx() | |
19747 | ||
19748 | =over 4 | |
19749 | ||
19750 | =item AUTHOR | |
19751 | ||
19752 | =item SEE ALSO | |
19753 | ||
19754 | =back | |
19755 | ||
19756 | =head2 Pod::Parser - base class for creating POD filters and translators | |
19757 | ||
19758 | =over 4 | |
19759 | ||
19760 | =item SYNOPSIS | |
19761 | ||
19762 | =item REQUIRES | |
19763 | ||
19764 | =item EXPORTS | |
19765 | ||
19766 | =item DESCRIPTION | |
19767 | ||
19768 | =item QUICK OVERVIEW | |
19769 | ||
19770 | =item PARSING OPTIONS | |
19771 | ||
19772 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), | |
19773 | B<-warnings> (default: unset) | |
19774 | ||
19775 | =back | |
19776 | ||
19777 | =over 4 | |
19778 | ||
19779 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES | |
19780 | ||
19781 | =back | |
19782 | ||
19783 | =over 4 | |
19784 | ||
19785 | =item B<command()> | |
19786 | ||
19787 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
19788 | ||
19789 | =back | |
19790 | ||
19791 | =over 4 | |
19792 | ||
19793 | =item B<verbatim()> | |
19794 | ||
19795 | C<$text>, C<$line_num>, C<$pod_para> | |
19796 | ||
19797 | =back | |
19798 | ||
19799 | =over 4 | |
19800 | ||
19801 | =item B<textblock()> | |
19802 | ||
19803 | C<$text>, C<$line_num>, C<$pod_para> | |
19804 | ||
19805 | =back | |
19806 | ||
19807 | =over 4 | |
19808 | ||
19809 | =item B<interior_sequence()> | |
19810 | ||
19811 | =back | |
19812 | ||
19813 | =over 4 | |
19814 | ||
19815 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES | |
19816 | ||
19817 | =back | |
19818 | ||
19819 | =over 4 | |
19820 | ||
19821 | =item B<new()> | |
19822 | ||
19823 | =back | |
19824 | ||
19825 | =over 4 | |
19826 | ||
19827 | =item B<initialize()> | |
19828 | ||
19829 | =back | |
19830 | ||
19831 | =over 4 | |
19832 | ||
19833 | =item B<begin_pod()> | |
19834 | ||
19835 | =back | |
19836 | ||
19837 | =over 4 | |
19838 | ||
19839 | =item B<begin_input()> | |
19840 | ||
19841 | =back | |
19842 | ||
19843 | =over 4 | |
19844 | ||
19845 | =item B<end_input()> | |
19846 | ||
19847 | =back | |
19848 | ||
19849 | =over 4 | |
19850 | ||
19851 | =item B<end_pod()> | |
19852 | ||
19853 | =back | |
19854 | ||
19855 | =over 4 | |
19856 | ||
19857 | =item B<preprocess_line()> | |
19858 | ||
19859 | =back | |
19860 | ||
19861 | =over 4 | |
19862 | ||
19863 | =item B<preprocess_paragraph()> | |
19864 | ||
19865 | =back | |
19866 | ||
19867 | =over 4 | |
19868 | ||
19869 | =item METHODS FOR PARSING AND PROCESSING | |
19870 | ||
19871 | =back | |
19872 | ||
19873 | =over 4 | |
19874 | ||
19875 | =item B<parse_text()> | |
19876 | ||
19877 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> | |
19878 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
19879 | I<code-ref>|I<method-name> | |
19880 | ||
19881 | =back | |
19882 | ||
19883 | =over 4 | |
19884 | ||
19885 | =item B<interpolate()> | |
19886 | ||
19887 | =back | |
19888 | ||
19889 | =over 4 | |
19890 | ||
19891 | =item B<parse_paragraph()> | |
19892 | ||
19893 | =back | |
19894 | ||
19895 | =over 4 | |
19896 | ||
19897 | =item B<parse_from_filehandle()> | |
19898 | ||
19899 | =back | |
19900 | ||
19901 | =over 4 | |
19902 | ||
19903 | =item B<parse_from_file()> | |
19904 | ||
19905 | =back | |
19906 | ||
19907 | =over 4 | |
19908 | ||
19909 | =item ACCESSOR METHODS | |
19910 | ||
19911 | =back | |
19912 | ||
19913 | =over 4 | |
19914 | ||
19915 | =item B<errorsub()> | |
19916 | ||
19917 | =back | |
19918 | ||
19919 | =over 4 | |
19920 | ||
19921 | =item B<cutting()> | |
19922 | ||
19923 | =back | |
19924 | ||
19925 | =over 4 | |
19926 | ||
19927 | =item B<parseopts()> | |
19928 | ||
19929 | =back | |
19930 | ||
19931 | =over 4 | |
19932 | ||
19933 | =item B<output_file()> | |
19934 | ||
19935 | =back | |
19936 | ||
19937 | =over 4 | |
19938 | ||
19939 | =item B<output_handle()> | |
19940 | ||
19941 | =back | |
19942 | ||
19943 | =over 4 | |
19944 | ||
19945 | =item B<input_file()> | |
19946 | ||
19947 | =back | |
19948 | ||
19949 | =over 4 | |
19950 | ||
19951 | =item B<input_handle()> | |
19952 | ||
19953 | =back | |
19954 | ||
19955 | =over 4 | |
19956 | ||
19957 | =item B<input_streams()> | |
19958 | ||
19959 | =back | |
19960 | ||
19961 | =over 4 | |
19962 | ||
19963 | =item B<top_stream()> | |
19964 | ||
19965 | =back | |
19966 | ||
19967 | =over 4 | |
19968 | ||
19969 | =item PRIVATE METHODS AND DATA | |
19970 | ||
19971 | =back | |
19972 | ||
19973 | =over 4 | |
19974 | ||
19975 | =item B<_push_input_stream()> | |
19976 | ||
19977 | =back | |
19978 | ||
19979 | =over 4 | |
19980 | ||
19981 | =item B<_pop_input_stream()> | |
19982 | ||
19983 | =back | |
19984 | ||
19985 | =over 4 | |
19986 | ||
19987 | =item TREE-BASED PARSING | |
19988 | ||
19989 | =item SEE ALSO | |
19990 | ||
19991 | =item AUTHOR | |
19992 | ||
19993 | =back | |
19994 | ||
19995 | =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors | |
19996 | ||
19997 | =over 4 | |
19998 | ||
19999 | =item SYNOPSIS | |
20000 | ||
20001 | =item DESCRIPTION | |
20002 | ||
20003 | =item SEE ALSO | |
20004 | ||
20005 | =item COPYRIGHT AND DISCLAIMERS | |
20006 | ||
20007 | =item AUTHOR | |
20008 | ||
20009 | =back | |
20010 | ||
20011 | =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages | |
20012 | ||
20013 | =over 4 | |
20014 | ||
20015 | =item SYNOPSIS | |
20016 | ||
20017 | =item DESCRIPTION | |
20018 | ||
20019 | =item CAVEAT | |
20020 | ||
20021 | =item SEE ALSO | |
20022 | ||
20023 | =item COPYRIGHT AND DISCLAIMERS | |
20024 | ||
20025 | =item AUTHOR | |
20026 | ||
20027 | =back | |
20028 | ||
20029 | =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff | |
20030 | ||
20031 | =over 4 | |
20032 | ||
20033 | =item SYNOPSIS | |
20034 | ||
20035 | =item DESCRIPTION | |
20036 | ||
20037 | =item CAVEAT | |
20038 | ||
20039 | =item SEE ALSO | |
20040 | ||
20041 | =item COPYRIGHT AND DISCLAIMERS | |
20042 | ||
20043 | =item AUTHOR | |
20044 | ||
20045 | =back | |
20046 | ||
20047 | =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod! | |
20048 | ||
20049 | =over 4 | |
20050 | ||
20051 | =item SYNOPSIS | |
20052 | ||
20053 | =item DESCRIPTION | |
20054 | ||
20055 | =item SEE ALSO | |
20056 | ||
20057 | =item COPYRIGHT AND DISCLAIMERS | |
20058 | ||
20059 | =item AUTHOR | |
20060 | ||
20061 | =back | |
20062 | ||
20063 | =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF | |
20064 | ||
20065 | =over 4 | |
20066 | ||
20067 | =item SYNOPSIS | |
20068 | ||
20069 | =item DESCRIPTION | |
20070 | ||
20071 | =item SEE ALSO | |
20072 | ||
20073 | =item COPYRIGHT AND DISCLAIMERS | |
20074 | ||
20075 | =item AUTHOR | |
20076 | ||
20077 | =back | |
20078 | ||
20079 | =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext | |
20080 | ||
20081 | =over 4 | |
20082 | ||
20083 | =item SYNOPSIS | |
20084 | ||
20085 | =item DESCRIPTION | |
20086 | ||
20087 | =item CAVEAT | |
20088 | ||
20089 | =item SEE ALSO | |
20090 | ||
20091 | =item COPYRIGHT AND DISCLAIMERS | |
20092 | ||
20093 | =item AUTHOR | |
20094 | ||
20095 | =back | |
20096 | ||
20097 | =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod | |
20098 | ||
20099 | =over 4 | |
20100 | ||
20101 | =item SYNOPSIS | |
20102 | ||
20103 | =item DESCRIPTION | |
20104 | ||
20105 | =item SEE ALSO | |
20106 | ||
20107 | =item AUTHOR | |
20108 | ||
20109 | =back | |
20110 | ||
20111 | =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML | |
20112 | ||
20113 | =over 4 | |
20114 | ||
20115 | =item SYNOPSIS | |
20116 | ||
20117 | =item DESCRIPTION | |
20118 | ||
20119 | =item SEE ALSO | |
20120 | ||
20121 | =item COPYRIGHT AND DISCLAIMERS | |
20122 | ||
20123 | =item AUTHOR | |
20124 | ||
20125 | =back | |
20126 | ||
20127 | =head2 Pod::PlainText - Convert POD data to formatted ASCII text | |
20128 | ||
20129 | =over 4 | |
20130 | ||
20131 | =item SYNOPSIS | |
20132 | ||
20133 | =item DESCRIPTION | |
20134 | ||
20135 | alt, indent, loose, sentence, width | |
20136 | ||
20137 | =item DIAGNOSTICS | |
20138 | ||
20139 | Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s, | |
20140 | Unknown sequence: %s, Unmatched =back | |
20141 | ||
20142 | =item RESTRICTIONS | |
20143 | ||
20144 | =item NOTES | |
20145 | ||
20146 | =item SEE ALSO | |
20147 | ||
20148 | =item AUTHOR | |
20149 | ||
20150 | =back | |
20151 | ||
20152 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. | |
20153 | ||
20154 | =over 4 | |
20155 | ||
20156 | =item SYNOPSIS | |
20157 | ||
20158 | =item DESCRIPTION | |
20159 | ||
20160 | =over 4 | |
20161 | ||
20162 | =item EXPORT | |
20163 | ||
20164 | =back | |
20165 | ||
20166 | =item AUTHOR | |
20167 | ||
20168 | =item SEE ALSO | |
20169 | ||
20170 | =back | |
20171 | ||
20172 | =head2 Pod::Select, podselect() - extract selected sections of POD from | |
20173 | input | |
20174 | ||
20175 | =over 4 | |
20176 | ||
20177 | =item SYNOPSIS | |
20178 | ||
20179 | =item REQUIRES | |
20180 | ||
20181 | =item EXPORTS | |
20182 | ||
20183 | =item DESCRIPTION | |
20184 | ||
20185 | =item SECTION SPECIFICATIONS | |
20186 | ||
20187 | =item RANGE SPECIFICATIONS | |
20188 | ||
20189 | =back | |
20190 | ||
20191 | =over 4 | |
20192 | ||
20193 | =item OBJECT METHODS | |
20194 | ||
20195 | =back | |
20196 | ||
20197 | =over 4 | |
20198 | ||
20199 | =item B<curr_headings()> | |
20200 | ||
20201 | =back | |
20202 | ||
20203 | =over 4 | |
20204 | ||
20205 | =item B<select()> | |
20206 | ||
20207 | =back | |
20208 | ||
20209 | =over 4 | |
20210 | ||
20211 | =item B<add_selection()> | |
20212 | ||
20213 | =back | |
20214 | ||
20215 | =over 4 | |
20216 | ||
20217 | =item B<clear_selections()> | |
20218 | ||
20219 | =back | |
20220 | ||
20221 | =over 4 | |
20222 | ||
20223 | =item B<match_section()> | |
20224 | ||
20225 | =back | |
20226 | ||
20227 | =over 4 | |
20228 | ||
20229 | =item B<is_selected()> | |
20230 | ||
20231 | =back | |
20232 | ||
20233 | =over 4 | |
20234 | ||
20235 | =item EXPORTED FUNCTIONS | |
20236 | ||
20237 | =back | |
20238 | ||
20239 | =over 4 | |
20240 | ||
20241 | =item B<podselect()> | |
20242 | ||
20243 | B<-output>, B<-sections>, B<-ranges> | |
20244 | ||
20245 | =back | |
20246 | ||
20247 | =over 4 | |
20248 | ||
20249 | =item PRIVATE METHODS AND DATA | |
20250 | ||
20251 | =back | |
20252 | ||
20253 | =over 4 | |
20254 | ||
20255 | =item B<_compile_section_spec()> | |
20256 | ||
20257 | =back | |
20258 | ||
20259 | =over 4 | |
20260 | ||
20261 | =item $self->{_SECTION_HEADINGS} | |
20262 | ||
20263 | =back | |
20264 | ||
20265 | =over 4 | |
20266 | ||
20267 | =item $self->{_SELECTED_SECTIONS} | |
20268 | ||
20269 | =back | |
20270 | ||
20271 | =over 4 | |
20272 | ||
20273 | =item SEE ALSO | |
20274 | ||
20275 | =item AUTHOR | |
20276 | ||
20277 | =back | |
20278 | ||
20279 | =head2 Pod::Text - Convert POD data to formatted ASCII text | |
20280 | ||
20281 | =over 4 | |
20282 | ||
20283 | =item SYNOPSIS | |
20284 | ||
20285 | =item DESCRIPTION | |
20286 | ||
20287 | alt, code, indent, loose, margin, quotes, sentence, width | |
20288 | ||
20289 | =item DIAGNOSTICS | |
20290 | ||
20291 | Bizarre space in item, Item called without tag, Can't open %s for reading: | |
20292 | %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s, | |
20293 | %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d: | |
20294 | Unmatched =back | |
20295 | ||
20296 | =item RESTRICTIONS | |
20297 | ||
20298 | =item NOTES | |
20299 | ||
20300 | =item SEE ALSO | |
20301 | ||
20302 | =item AUTHOR | |
20303 | ||
20304 | =item COPYRIGHT AND LICENSE | |
20305 | ||
20306 | =back | |
20307 | ||
20308 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text | |
20309 | ||
20310 | =over 4 | |
20311 | ||
20312 | =item SYNOPSIS | |
20313 | ||
20314 | =item DESCRIPTION | |
20315 | ||
20316 | =item BUGS | |
20317 | ||
20318 | =item SEE ALSO | |
20319 | ||
20320 | =item AUTHOR | |
20321 | ||
20322 | =item COPYRIGHT AND LICENSE | |
20323 | ||
20324 | =back | |
20325 | ||
20326 | =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike | |
20327 | text | |
20328 | ||
20329 | =over 4 | |
20330 | ||
20331 | =item SYNOPSIS | |
20332 | ||
20333 | =item DESCRIPTION | |
20334 | ||
20335 | =item BUGS | |
20336 | ||
20337 | =item SEE ALSO | |
20338 | ||
20339 | =item AUTHOR | |
20340 | ||
20341 | =item COPYRIGHT AND LICENSE | |
20342 | ||
20343 | =back | |
20344 | ||
20345 | =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format | |
20346 | escapes | |
20347 | ||
20348 | =over 4 | |
20349 | ||
20350 | =item SYNOPSIS | |
20351 | ||
20352 | =item DESCRIPTION | |
20353 | ||
20354 | =item NOTES | |
20355 | ||
20356 | =item SEE ALSO | |
20357 | ||
20358 | =item AUTHOR | |
20359 | ||
20360 | =item COPYRIGHT AND LICENSE | |
20361 | ||
20362 | =back | |
20363 | ||
20364 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod | |
20365 | documentation | |
20366 | ||
20367 | =over 4 | |
20368 | ||
20369 | =item SYNOPSIS | |
20370 | ||
20371 | =item ARGUMENTS | |
20372 | ||
b2a9ae16 | 20373 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-section>, C<-output>, |
b40eed9c | 20374 | C<-input>, C<-pathlist>, C<-noperldoc> |
ee382f2f JH |
20375 | |
20376 | =item DESCRIPTION | |
20377 | ||
20378 | =item EXAMPLES | |
20379 | ||
20380 | =over 4 | |
20381 | ||
20382 | =item Recommended Use | |
20383 | ||
20384 | =back | |
20385 | ||
20386 | =item CAVEATS | |
20387 | ||
20388 | =item AUTHOR | |
20389 | ||
20390 | =item ACKNOWLEDGEMENTS | |
20391 | ||
20392 | =back | |
20393 | ||
20394 | =head2 SDBM_File - Tied access to sdbm files | |
20395 | ||
20396 | =over 4 | |
20397 | ||
20398 | =item SYNOPSIS | |
20399 | ||
20400 | =item DESCRIPTION | |
20401 | ||
20402 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> | |
20403 | ||
20404 | =item DIAGNOSTICS | |
20405 | ||
20406 | =over 4 | |
20407 | ||
20408 | =item C<sdbm store returned -1, errno 22, key "..." at ...> | |
20409 | ||
20410 | =back | |
20411 | ||
20412 | =item BUGS AND WARNINGS | |
20413 | ||
20414 | =back | |
20415 | ||
20416 | =head2 Safe - Compile and execute code in restricted compartments | |
20417 | ||
20418 | =over 4 | |
20419 | ||
20420 | =item SYNOPSIS | |
20421 | ||
20422 | =item DESCRIPTION | |
20423 | ||
20424 | a new namespace, an operator mask | |
20425 | ||
20426 | =item WARNING | |
20427 | ||
20428 | =over 4 | |
20429 | ||
20430 | =item RECENT CHANGES | |
20431 | ||
20432 | =item Methods in class Safe | |
20433 | ||
20434 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
20435 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
20436 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
20437 | root (NAMESPACE), mask (MASK) | |
20438 | ||
20439 | =item Some Safety Issues | |
20440 | ||
20441 | Memory, CPU, Snooping, Signals, State Changes | |
20442 | ||
20443 | =item AUTHOR | |
20444 | ||
20445 | =back | |
20446 | ||
20447 | =back | |
20448 | ||
20449 | =head2 Scalar::Util - A selection of general-utility scalar subroutines | |
20450 | ||
20451 | =over 4 | |
20452 | ||
20453 | =item SYNOPSIS | |
20454 | ||
20455 | =item DESCRIPTION | |
20456 | ||
20457 | blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, | |
20458 | looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, | |
20459 | set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF | |
20460 | ||
20461 | =item KNOWN BUGS | |
20462 | ||
20463 | =item COPYRIGHT | |
20464 | ||
20465 | =item BLATANT PLUG | |
20466 | ||
20467 | =back | |
20468 | ||
20469 | =head2 Search::Dict, look - search for key in dictionary file | |
20470 | ||
20471 | =over 4 | |
20472 | ||
20473 | =item SYNOPSIS | |
20474 | ||
20475 | =item DESCRIPTION | |
20476 | ||
20477 | =back | |
20478 | ||
20479 | =head2 SelectSaver - save and restore selected file handle | |
20480 | ||
20481 | =over 4 | |
20482 | ||
20483 | =item SYNOPSIS | |
20484 | ||
20485 | =item DESCRIPTION | |
20486 | ||
20487 | =back | |
20488 | ||
20489 | =head2 SelfLoader - load functions only on demand | |
20490 | ||
20491 | =over 4 | |
20492 | ||
20493 | =item SYNOPSIS | |
20494 | ||
20495 | =item DESCRIPTION | |
20496 | ||
20497 | =over 4 | |
20498 | ||
20499 | =item The __DATA__ token | |
20500 | ||
20501 | =item SelfLoader autoloading | |
20502 | ||
20503 | =item Autoloading and package lexicals | |
20504 | ||
20505 | =item SelfLoader and AutoLoader | |
20506 | ||
20507 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. | |
20508 | ||
20509 | =item Classes and inherited methods. | |
20510 | ||
20511 | =back | |
20512 | ||
20513 | =item Multiple packages and fully qualified subroutine names | |
20514 | ||
20515 | =back | |
20516 | ||
20517 | =head2 Shell - run shell commands transparently within perl | |
20518 | ||
20519 | =over 4 | |
20520 | ||
20521 | =item SYNOPSIS | |
20522 | ||
20523 | =item DESCRIPTION | |
20524 | ||
20525 | =over 4 | |
20526 | ||
d3ca9f77 NC |
20527 | =item Caveats |
20528 | ||
20529 | =item Escaping Magic Characters | |
20530 | ||
20531 | =item Configuration | |
ee382f2f JH |
20532 | |
20533 | =back | |
20534 | ||
d3ca9f77 NC |
20535 | =item BUGS |
20536 | ||
ee382f2f JH |
20537 | =item AUTHOR |
20538 | ||
20539 | =back | |
20540 | ||
20541 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C | |
20542 | socket.h defines and structure manipulators | |
20543 | ||
20544 | =over 4 | |
20545 | ||
20546 | =item SYNOPSIS | |
20547 | ||
20548 | =item DESCRIPTION | |
20549 | ||
20550 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, | |
20551 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT, | |
20552 | ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, | |
20553 | unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un | |
20554 | SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
20555 | ||
20556 | =back | |
20557 | ||
20558 | =head2 Storable - persistence for Perl data structures | |
20559 | ||
20560 | =over 4 | |
20561 | ||
20562 | =item SYNOPSIS | |
20563 | ||
20564 | =item DESCRIPTION | |
20565 | ||
20566 | =item MEMORY STORE | |
20567 | ||
20568 | =item ADVISORY LOCKING | |
20569 | ||
20570 | =item SPEED | |
20571 | ||
20572 | =item CANONICAL REPRESENTATION | |
20573 | ||
20574 | =item CODE REFERENCES | |
20575 | ||
20576 | =item FORWARD COMPATIBILITY | |
20577 | ||
20578 | utf8 data, restricted hashes, files from future versions of Storable | |
20579 | ||
20580 | =item ERROR REPORTING | |
20581 | ||
20582 | =item WIZARDS ONLY | |
20583 | ||
20584 | =over 4 | |
20585 | ||
20586 | =item Hooks | |
20587 | ||
20588 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
b40eed9c | 20589 | I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized> |
ee382f2f JH |
20590 | |
20591 | =item Predicates | |
20592 | ||
20593 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
20594 | C<Storable::is_retrieving> | |
20595 | ||
20596 | =item Recursion | |
20597 | ||
20598 | =item Deep Cloning | |
20599 | ||
20600 | =back | |
20601 | ||
20602 | =item Storable magic | |
20603 | ||
20604 | =item EXAMPLES | |
35c7d401 JH |
20605 | |
20606 | =item WARNING | |
a45bd81d | 20607 | |
ee382f2f JH |
20608 | =item BUGS |
20609 | ||
20610 | =over 4 | |
20611 | ||
20612 | =item 64 bit data in perl 5.6.0 and 5.6.1 | |
20613 | ||
20614 | =back | |
20615 | ||
20616 | =item CREDITS | |
20617 | ||
20618 | =item AUTHOR | |
20619 | ||
20620 | =item SEE ALSO | |
20621 | ||
20622 | =back | |
20623 | ||
20624 | =head2 Switch - A switch statement for Perl | |
20625 | ||
20626 | =over 4 | |
20627 | ||
20628 | =item VERSION | |
20629 | ||
20630 | =item SYNOPSIS | |
20631 | ||
20632 | =item BACKGROUND | |
20633 | ||
20634 | =item DESCRIPTION | |
20635 | ||
20636 | =over 4 | |
20637 | ||
20638 | =item Allowing fall-through | |
20639 | ||
20640 | =item Automating fall-through | |
20641 | ||
20642 | =item Alternative syntax | |
20643 | ||
20644 | =item Higher-order Operations | |
20645 | ||
20646 | =back | |
20647 | ||
20648 | =item DEPENDENCIES | |
20649 | ||
20650 | =item AUTHOR | |
20651 | ||
20652 | =item BUGS | |
20653 | ||
7f106169 | 20654 | =item LIMITATIONS |
ee382f2f JH |
20655 | |
20656 | =item COPYRIGHT | |
20657 | ||
20658 | =back | |
20659 | ||
20660 | =head2 Symbol - manipulate Perl symbols and their names | |
20661 | ||
20662 | =over 4 | |
20663 | ||
20664 | =item SYNOPSIS | |
20665 | ||
20666 | =item DESCRIPTION | |
20667 | ||
cd458e05 JH |
20668 | =item BUGS |
20669 | ||
ee382f2f JH |
20670 | =back |
20671 | ||
20672 | =head2 Sys::Hostname - Try every conceivable way to get hostname | |
20673 | ||
20674 | =over 4 | |
20675 | ||
20676 | =item SYNOPSIS | |
20677 | ||
20678 | =item DESCRIPTION | |
20679 | ||
20680 | =item AUTHOR | |
20681 | ||
20682 | =back | |
20683 | ||
b40eed9c | 20684 | =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls |
a2db77eb NC |
20685 | |
20686 | =over 4 | |
20687 | ||
b40eed9c NC |
20688 | =item VERSION |
20689 | ||
a2db77eb NC |
20690 | =item SYNOPSIS |
20691 | ||
20692 | =item DESCRIPTION | |
20693 | ||
b40eed9c NC |
20694 | =item EXPORTS |
20695 | ||
20696 | =item FUNCTIONS | |
20697 | ||
20698 | B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>, | |
20699 | B<syslog($priority, $format, @args)>, B<Note>, | |
20700 | B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>, | |
20701 | B<setlogsock($sock_type, $stream_location)> (added in 5.004_02), | |
20702 | B<closelog()> | |
a2db77eb NC |
20703 | |
20704 | =item EXAMPLES | |
20705 | ||
b40eed9c NC |
20706 | =item CONSTANTS |
20707 | ||
20708 | =over 4 | |
20709 | ||
20710 | =item Facilities | |
20711 | ||
20712 | =item Levels | |
20713 | ||
20714 | =back | |
20715 | ||
20716 | =item DIAGNOSTICS | |
20717 | ||
20718 | Invalid argument passed to setlogsock, no connection to syslog available, | |
20719 | stream passed to setlogsock, but %s is not writable, stream passed to | |
20720 | setlogsock, but could not find any device, tcp passed to setlogsock, but | |
20721 | tcp service unavailable, syslog: expecting argument %s, syslog: invalid | |
20722 | level/facility: %s, syslog: too many levels given: %s, syslog: too many | |
20723 | facilities given: %s, syslog: level must be given, udp passed to | |
20724 | setlogsock, but udp service unavailable, unix passed to setlogsock, but | |
20725 | path not available | |
20726 | ||
a2db77eb NC |
20727 | =item SEE ALSO |
20728 | ||
20729 | =item AUTHOR | |
20730 | ||
b40eed9c NC |
20731 | =item BUGS |
20732 | ||
20733 | =item SUPPORT | |
20734 | ||
20735 | AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request | |
20736 | tracker, Search CPAN | |
20737 | ||
20738 | =item LICENSE | |
20739 | ||
a2db77eb NC |
20740 | =back |
20741 | ||
b40eed9c NC |
20742 | =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) |
20743 | calls | |
ee382f2f JH |
20744 | |
20745 | =over 4 | |
20746 | ||
b40eed9c NC |
20747 | =item VERSION |
20748 | ||
ee382f2f JH |
20749 | =item SYNOPSIS |
20750 | ||
20751 | =item DESCRIPTION | |
20752 | ||
b40eed9c NC |
20753 | =item EXPORTS |
20754 | ||
20755 | =item FUNCTIONS | |
20756 | ||
20757 | B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>, | |
20758 | B<syslog($priority, $format, @args)>, B<Note>, | |
20759 | B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>, | |
20760 | B<setlogsock($sock_type, $stream_location)> (added in 5.004_02), | |
20761 | B<closelog()> | |
ee382f2f JH |
20762 | |
20763 | =item EXAMPLES | |
20764 | ||
b40eed9c NC |
20765 | =item CONSTANTS |
20766 | ||
20767 | =over 4 | |
20768 | ||
20769 | =item Facilities | |
20770 | ||
20771 | =item Levels | |
20772 | ||
20773 | =back | |
20774 | ||
20775 | =item DIAGNOSTICS | |
20776 | ||
20777 | Invalid argument passed to setlogsock, no connection to syslog available, | |
20778 | stream passed to setlogsock, but %s is not writable, stream passed to | |
20779 | setlogsock, but could not find any device, tcp passed to setlogsock, but | |
20780 | tcp service unavailable, syslog: expecting argument %s, syslog: invalid | |
20781 | level/facility: %s, syslog: too many levels given: %s, syslog: too many | |
20782 | facilities given: %s, syslog: level must be given, udp passed to | |
20783 | setlogsock, but udp service unavailable, unix passed to setlogsock, but | |
20784 | path not available | |
20785 | ||
ee382f2f JH |
20786 | =item SEE ALSO |
20787 | ||
20788 | =item AUTHOR | |
20789 | ||
b40eed9c NC |
20790 | =item BUGS |
20791 | ||
20792 | =item SUPPORT | |
20793 | ||
20794 | AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request | |
20795 | tracker, Search CPAN | |
20796 | ||
20797 | =item LICENSE | |
20798 | ||
ee382f2f JH |
20799 | =back |
20800 | ||
20801 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences | |
20802 | ||
20803 | =over 4 | |
20804 | ||
20805 | =item SYNOPSIS | |
20806 | ||
20807 | =item DESCRIPTION | |
20808 | ||
20809 | =item DIAGNOSTICS | |
20810 | ||
20811 | Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in | |
20812 | use, Invalid attribute name %s, Name "%s" used only once: possible typo, No | |
20813 | comma allowed after filehandle, No name for escape sequence %s | |
20814 | ||
20815 | =item ENVIRONMENT | |
20816 | ||
20817 | ANSI_COLORS_DISABLED | |
20818 | ||
20819 | =item RESTRICTIONS | |
20820 | ||
20821 | =item NOTES | |
20822 | ||
20823 | =item SEE ALSO | |
20824 | ||
20825 | =item AUTHORS | |
20826 | ||
20827 | =item COPYRIGHT AND LICENSE | |
20828 | ||
20829 | =back | |
20830 | ||
20831 | =head2 Term::Cap - Perl termcap interface | |
20832 | ||
20833 | =over 4 | |
20834 | ||
20835 | =item SYNOPSIS | |
20836 | ||
20837 | =item DESCRIPTION | |
20838 | ||
20839 | =over 4 | |
20840 | ||
20841 | =item METHODS | |
20842 | ||
20843 | =back | |
20844 | ||
20845 | =back | |
20846 | ||
20847 | B<Tgetent>, OSPEED, TERM | |
20848 | ||
20849 | B<Tpad>, B<$string>, B<$cnt>, B<$FH> | |
20850 | ||
20851 | B<Tputs>, B<$cap>, B<$cnt>, B<$FH> | |
20852 | ||
20853 | B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH> | |
20854 | ||
20855 | B<Trequire> | |
20856 | ||
20857 | =over 4 | |
20858 | ||
20859 | =item EXAMPLES | |
20860 | ||
20861 | =item COPYRIGHT AND LICENSE | |
20862 | ||
20863 | =item AUTHOR | |
20864 | ||
20865 | =item SEE ALSO | |
20866 | ||
20867 | =back | |
20868 | ||
20869 | =head2 Term::Complete - Perl word completion module | |
20870 | ||
20871 | =over 4 | |
20872 | ||
20873 | =item SYNOPSIS | |
20874 | ||
20875 | =item DESCRIPTION | |
20876 | ||
20877 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> | |
20878 | ||
20879 | =item DIAGNOSTICS | |
20880 | ||
20881 | =item BUGS | |
20882 | ||
20883 | =item AUTHOR | |
20884 | ||
20885 | =back | |
20886 | ||
20887 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. | |
20888 | If no real package is found, substitutes stubs instead of basic functions. | |
20889 | ||
20890 | =over 4 | |
20891 | ||
20892 | =item SYNOPSIS | |
20893 | ||
20894 | =item DESCRIPTION | |
20895 | ||
20896 | =item Minimal set of supported functions | |
20897 | ||
20898 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>, | |
20899 | C<findConsole>, Attribs, C<Features> | |
20900 | ||
20901 | =item Additional supported functions | |
20902 | ||
20903 | C<tkRunning>, C<ornaments>, C<newTTY> | |
20904 | ||
20905 | =item EXPORTS | |
20906 | ||
20907 | =item ENVIRONMENT | |
20908 | ||
20909 | =item CAVEATS | |
20910 | ||
20911 | =back | |
20912 | ||
20913 | =head2 Test - provides a simple framework for writing test scripts | |
20914 | ||
20915 | =over 4 | |
20916 | ||
20917 | =item SYNOPSIS | |
20918 | ||
20919 | =item DESCRIPTION | |
20920 | ||
20921 | =item QUICK START GUIDE | |
20922 | ||
20923 | =over 4 | |
20924 | ||
20925 | =item Functions | |
20926 | ||
20927 | C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>, | |
20928 | C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub> | |
20929 | ||
20930 | =back | |
20931 | ||
20932 | =back | |
20933 | ||
20934 | B<_to_value> | |
20935 | ||
20936 | C<ok(...)> | |
20937 | ||
20938 | C<skip(I<skip_if_true>, I<args...>)> | |
20939 | ||
20940 | =over 4 | |
20941 | ||
20942 | =item TEST TYPES | |
20943 | ||
20944 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
20945 | ||
20946 | =item ONFAIL | |
20947 | ||
20948 | =item BUGS and CAVEATS | |
20949 | ||
d3ca9f77 NC |
20950 | =item ENVIRONMENT |
20951 | ||
ee382f2f JH |
20952 | =item NOTE |
20953 | ||
20954 | =item SEE ALSO | |
20955 | ||
20956 | =item AUTHOR | |
20957 | ||
20958 | =back | |
20959 | ||
20960 | =head2 Test::Builder - Backend for building test libraries | |
20961 | ||
20962 | =over 4 | |
20963 | ||
20964 | =item SYNOPSIS | |
20965 | ||
20966 | =item DESCRIPTION | |
20967 | ||
20968 | =over 4 | |
20969 | ||
20970 | =item Construction | |
20971 | ||
20972 | B<new> | |
20973 | ||
20974 | =back | |
20975 | ||
20976 | =back | |
20977 | ||
b40eed9c NC |
20978 | B<create> |
20979 | ||
a563e516 NC |
20980 | B<reset> |
20981 | ||
ee382f2f JH |
20982 | =over 4 |
20983 | ||
20984 | =item Setting up tests | |
20985 | ||
20986 | B<exported_to> | |
20987 | ||
20988 | =back | |
20989 | ||
20990 | B<plan> | |
20991 | ||
20992 | B<expected_tests> | |
20993 | ||
20994 | B<no_plan> | |
20995 | ||
20996 | B<has_plan> | |
20997 | ||
20998 | B<skip_all> | |
20999 | ||
21000 | =over 4 | |
21001 | ||
21002 | =item Running tests | |
21003 | ||
21004 | B<ok> | |
21005 | ||
21006 | =back | |
21007 | ||
21008 | B<is_eq>, B<is_num> | |
21009 | ||
21010 | B<isnt_eq>, B<isnt_num> | |
21011 | ||
21012 | B<like>, B<unlike> | |
21013 | ||
21014 | B<maybe_regex> | |
21015 | ||
21016 | B<cmp_ok> | |
21017 | ||
b40eed9c | 21018 | B<BAIL_OUT> |
ee382f2f JH |
21019 | |
21020 | B<skip> | |
21021 | ||
21022 | B<todo_skip> | |
21023 | ||
21024 | B<skip_rest> | |
21025 | ||
21026 | =over 4 | |
21027 | ||
21028 | =item Test style | |
21029 | ||
21030 | B<level> | |
21031 | ||
21032 | =back | |
21033 | ||
21034 | B<use_numbers> | |
21035 | ||
b40eed9c | 21036 | B<no_diag>, B<no_ending>, B<no_header> |
ee382f2f JH |
21037 | |
21038 | =over 4 | |
21039 | ||
21040 | =item Output | |
21041 | ||
21042 | B<diag> | |
21043 | ||
21044 | =back | |
21045 | ||
21046 | B<_print> | |
21047 | ||
a563e516 NC |
21048 | B<_print_diag> |
21049 | ||
ee382f2f JH |
21050 | B<output>, B<failure_output>, B<todo_output> |
21051 | ||
21052 | =over 4 | |
21053 | ||
21054 | =item Test Status and Info | |
21055 | ||
21056 | B<current_test> | |
21057 | ||
21058 | =back | |
21059 | ||
21060 | B<summary> | |
21061 | ||
21062 | B<details> | |
21063 | ||
21064 | B<todo> | |
21065 | ||
21066 | B<caller> | |
21067 | ||
21068 | B<_sanity_check> | |
21069 | ||
21070 | B<_whoa> | |
21071 | ||
21072 | B<_my_exit> | |
21073 | ||
21074 | =over 4 | |
21075 | ||
a563e516 NC |
21076 | =item EXIT CODES |
21077 | ||
ee382f2f JH |
21078 | =item THREADS |
21079 | ||
21080 | =item EXAMPLES | |
21081 | ||
21082 | =item SEE ALSO | |
21083 | ||
21084 | =item AUTHORS | |
21085 | ||
21086 | =item COPYRIGHT | |
21087 | ||
21088 | =back | |
21089 | ||
b40eed9c NC |
21090 | =head2 Test::Builder::Module - Base class for test modules |
21091 | ||
21092 | =over 4 | |
21093 | ||
21094 | =item SYNOPSIS | |
21095 | ||
21096 | =item DESCRIPTION | |
21097 | ||
21098 | =over 4 | |
21099 | ||
21100 | =item Importing | |
21101 | ||
21102 | =back | |
21103 | ||
21104 | =back | |
21105 | ||
21106 | =over 4 | |
21107 | ||
21108 | =item Builder | |
21109 | ||
21110 | =back | |
21111 | ||
21112 | =head2 Test::Builder::Tester - test testsuites that have been built with | |
21113 | Test::Builder | |
21114 | ||
21115 | =over 4 | |
21116 | ||
21117 | =item SYNOPSIS | |
21118 | ||
21119 | =item DESCRIPTION | |
21120 | ||
21121 | =back | |
21122 | ||
21123 | =over 4 | |
21124 | ||
21125 | =item Methods | |
21126 | ||
21127 | test_out, test_err | |
21128 | ||
21129 | =back | |
21130 | ||
21131 | test_fail | |
21132 | ||
21133 | test_diag | |
21134 | ||
21135 | test_test, title (synonym 'name', 'label'), skip_out, skip_err | |
21136 | ||
21137 | line_num | |
21138 | ||
21139 | color | |
21140 | ||
21141 | =over 4 | |
21142 | ||
21143 | =item BUGS | |
21144 | ||
21145 | =item AUTHOR | |
21146 | ||
21147 | =item NOTES | |
21148 | ||
21149 | =item SEE ALSO | |
21150 | ||
21151 | =back | |
21152 | ||
21153 | =head2 Test::Builder::Tester::Color - turn on colour in | |
21154 | Test::Builder::Tester | |
21155 | ||
21156 | =over 4 | |
21157 | ||
21158 | =item SYNOPSIS | |
21159 | ||
21160 | =item DESCRIPTION | |
21161 | ||
21162 | =back | |
21163 | ||
21164 | =over 4 | |
21165 | ||
21166 | =item AUTHOR | |
21167 | ||
21168 | =item BUGS | |
21169 | ||
21170 | =item SEE ALSO | |
21171 | ||
21172 | =back | |
21173 | ||
7a5cdbdf AJ |
21174 | =head2 Test::Harness - Run Perl standard test scripts with statistics |
21175 | ||
21176 | =over 4 | |
21177 | ||
21178 | =item VERSION | |
21179 | ||
21180 | =back | |
ee382f2f JH |
21181 | |
21182 | =over 4 | |
21183 | ||
21184 | =item SYNOPSIS | |
21185 | ||
21186 | =item DESCRIPTION | |
21187 | ||
21188 | =over 4 | |
21189 | ||
ee382f2f JH |
21190 | =item Taint mode |
21191 | ||
21192 | =item Configuration variables. | |
21193 | ||
b40eed9c NC |
21194 | C<$Test::Harness::Verbose>, C<$Test::Harness::switches>, |
21195 | C<$Test::Harness::Timer> | |
ee382f2f JH |
21196 | |
21197 | =item Failure | |
21198 | ||
21199 | B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of | |
21200 | Failed> | |
21201 | ||
21202 | =item Functions | |
21203 | ||
21204 | B<runtests> | |
21205 | ||
21206 | =back | |
21207 | ||
21208 | =back | |
21209 | ||
21210 | B<_all_ok> | |
21211 | ||
21212 | B<_globdir> | |
21213 | ||
21214 | B<_run_all_tests> | |
21215 | ||
21216 | B<_mk_leader> | |
21217 | ||
21218 | B<_leader_width> | |
21219 | ||
21220 | =over 4 | |
21221 | ||
21222 | =item EXPORT | |
21223 | ||
21224 | =item DIAGNOSTICS | |
21225 | ||
21226 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests | |
21227 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat | |
21228 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
21229 | %s>, C<FAILED--Further testing stopped: %s> | |
21230 | ||
e7f2ff80 NC |
21231 | =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS |
21232 | ||
21233 | C<HARNESS_ACTIVE>, C<HARNESS_VERSION> | |
ee382f2f | 21234 | |
e7f2ff80 NC |
21235 | =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS |
21236 | ||
21237 | C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>, | |
21238 | C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, | |
21239 | C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE> | |
ee382f2f JH |
21240 | |
21241 | =item EXAMPLE | |
21242 | ||
21243 | =item SEE ALSO | |
21244 | ||
ee382f2f JH |
21245 | =item TODO |
21246 | ||
21247 | =item BUGS | |
21248 | ||
7a5cdbdf AJ |
21249 | =item AUTHORS |
21250 | ||
21251 | =item COPYRIGHT | |
21252 | ||
ee382f2f JH |
21253 | =back |
21254 | ||
21255 | =head2 Test::Harness::Assert - simple assert | |
21256 | ||
21257 | =over 4 | |
21258 | ||
21259 | =item SYNOPSIS | |
21260 | ||
21261 | =item DESCRIPTION | |
21262 | ||
7a5cdbdf | 21263 | =item FUNCTIONS |
ee382f2f | 21264 | |
7a5cdbdf | 21265 | =over 4 |
ee382f2f | 21266 | |
7a5cdbdf | 21267 | =item C<assert()> |
ee382f2f JH |
21268 | |
21269 | =back | |
21270 | ||
21271 | =back | |
21272 | ||
21273 | =over 4 | |
21274 | ||
21275 | =item AUTHOR | |
21276 | ||
21277 | =item SEE ALSO | |
21278 | ||
21279 | =back | |
21280 | ||
21281 | =head2 Test::Harness::Iterator - Internal Test::Harness Iterator | |
21282 | ||
21283 | =over 4 | |
21284 | ||
21285 | =item SYNOPSIS | |
21286 | ||
21287 | =item DESCRIPTION | |
21288 | ||
4c64e75b NC |
21289 | =over 4 |
21290 | ||
21291 | =item new() | |
21292 | ||
21293 | =item next() | |
21294 | ||
21295 | =back | |
21296 | ||
ee382f2f JH |
21297 | =back |
21298 | ||
e7f2ff80 NC |
21299 | =head2 Test::Harness::Point - object for tracking a single test point |
21300 | ||
21301 | =over 4 | |
21302 | ||
21303 | =item SYNOPSIS | |
21304 | ||
21305 | =item CONSTRUCTION | |
21306 | ||
21307 | =over 4 | |
21308 | ||
21309 | =item new() | |
21310 | ||
21311 | =back | |
21312 | ||
21313 | =back | |
21314 | ||
21315 | =over 4 | |
21316 | ||
21317 | =item from_test_line( $line ) | |
21318 | ||
21319 | =back | |
21320 | ||
21321 | =over 4 | |
21322 | ||
21323 | =item ACCESSORS | |
21324 | ||
21325 | ok, number | |
21326 | ||
21327 | =back | |
21328 | ||
ee382f2f JH |
21329 | =head2 Test::Harness::Straps - detailed analysis of test results |
21330 | ||
21331 | =over 4 | |
21332 | ||
21333 | =item SYNOPSIS | |
21334 | ||
21335 | =item DESCRIPTION | |
21336 | ||
e7f2ff80 | 21337 | =item CONSTRUCTION |
ee382f2f | 21338 | |
50e34432 JH |
21339 | =over 4 |
21340 | ||
e7f2ff80 | 21341 | =item new() |
ee382f2f JH |
21342 | |
21343 | =back | |
21344 | ||
21345 | =back | |
21346 | ||
50e34432 JH |
21347 | =over 4 |
21348 | ||
e7f2ff80 | 21349 | =item $strap->_init |
50e34432 JH |
21350 | |
21351 | =back | |
ee382f2f JH |
21352 | |
21353 | =over 4 | |
21354 | ||
e7f2ff80 | 21355 | =item ANALYSIS |
ee382f2f | 21356 | |
50e34432 JH |
21357 | =over 4 |
21358 | ||
b2a9ae16 | 21359 | =item $strap->analyze( $name, \@output_lines ) |
50e34432 JH |
21360 | |
21361 | =back | |
21362 | ||
21363 | =back | |
21364 | ||
21365 | =over 4 | |
21366 | ||
e7f2ff80 | 21367 | =item $strap->analyze_fh( $name, $test_filehandle ) |
50e34432 JH |
21368 | |
21369 | =back | |
21370 | ||
21371 | =over 4 | |
21372 | ||
e7f2ff80 | 21373 | =item $strap->analyze_file( $test_file ) |
50e34432 JH |
21374 | |
21375 | =back | |
21376 | ||
21377 | =over 4 | |
21378 | ||
e7f2ff80 | 21379 | =item $strap->_command_line( $file ) |
7a5cdbdf AJ |
21380 | |
21381 | =back | |
21382 | ||
21383 | =over 4 | |
21384 | ||
e7f2ff80 | 21385 | =item $strap->_command() |
7a5cdbdf AJ |
21386 | |
21387 | =back | |
21388 | ||
21389 | =over 4 | |
21390 | ||
e7f2ff80 | 21391 | =item $strap->_switches( $file ) |
50e34432 JH |
21392 | |
21393 | =back | |
21394 | ||
21395 | =over 4 | |
21396 | ||
e7f2ff80 | 21397 | =item $strap->_cleaned_switches( @switches_from_user ) |
7a5cdbdf AJ |
21398 | |
21399 | =back | |
21400 | ||
21401 | =over 4 | |
21402 | ||
e7f2ff80 | 21403 | =item $strap->_INC2PERL5LIB |
ee382f2f JH |
21404 | |
21405 | =back | |
21406 | ||
50e34432 | 21407 | =over 4 |
ee382f2f | 21408 | |
e7f2ff80 | 21409 | =item $strap->_filtered_INC() |
ee382f2f | 21410 | |
50e34432 | 21411 | =back |
ee382f2f | 21412 | |
50e34432 | 21413 | =over 4 |
ee382f2f | 21414 | |
e7f2ff80 | 21415 | =item $strap->_restore_PERL5LIB() |
ee382f2f | 21416 | |
50e34432 | 21417 | =back |
ee382f2f JH |
21418 | |
21419 | =over 4 | |
21420 | ||
21421 | =item Parsing | |
21422 | ||
50e34432 JH |
21423 | =over 4 |
21424 | ||
e7f2ff80 | 21425 | =item C<_is_diagnostic> |
50e34432 JH |
21426 | |
21427 | =back | |
21428 | ||
21429 | =back | |
21430 | ||
21431 | =over 4 | |
21432 | ||
21433 | =item C<_is_header> | |
21434 | ||
21435 | =back | |
21436 | ||
21437 | =over 4 | |
21438 | ||
50e34432 | 21439 | =item C<_is_bail_out> |
ee382f2f | 21440 | |
50e34432 JH |
21441 | =back |
21442 | ||
21443 | =over 4 | |
ee382f2f | 21444 | |
50e34432 | 21445 | =item C<_reset_file_state> |
ee382f2f | 21446 | |
50e34432 | 21447 | =back |
ee382f2f JH |
21448 | |
21449 | =over 4 | |
21450 | ||
21451 | =item Results | |
21452 | ||
b2a9ae16 | 21453 | =item EXAMPLES |
50e34432 | 21454 | |
b2a9ae16 | 21455 | =item AUTHOR |
50e34432 | 21456 | |
b2a9ae16 | 21457 | =item SEE ALSO |
ee382f2f JH |
21458 | |
21459 | =back | |
21460 | ||
b2a9ae16 NC |
21461 | =head2 Test::Harness::TAP - Documentation for the TAP format |
21462 | ||
ee382f2f JH |
21463 | =over 4 |
21464 | ||
b2a9ae16 | 21465 | =item SYNOPSIS |
ee382f2f | 21466 | |
e7f2ff80 | 21467 | =item TODO |
ee382f2f | 21468 | |
b2a9ae16 NC |
21469 | =item THE TAP FORMAT |
21470 | ||
e7f2ff80 NC |
21471 | =item HARNESS BEHAVIOR |
21472 | ||
21473 | =item TESTS LINES AND THE PLAN | |
21474 | ||
b2a9ae16 NC |
21475 | =over 4 |
21476 | ||
e7f2ff80 NC |
21477 | =item The plan |
21478 | ||
21479 | =item The test line | |
b2a9ae16 | 21480 | |
e7f2ff80 NC |
21481 | C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok |
21482 | (required), Test number (recommended), Description (recommended), Directive | |
21483 | (only when necessary) | |
b2a9ae16 NC |
21484 | |
21485 | =back | |
21486 | ||
e7f2ff80 | 21487 | =item DIRECTIVES |
b2a9ae16 | 21488 | |
e7f2ff80 | 21489 | =over 4 |
b2a9ae16 | 21490 | |
e7f2ff80 NC |
21491 | =item TODO tests |
21492 | ||
21493 | =item Skipping tests | |
21494 | ||
21495 | =back | |
21496 | ||
21497 | =item OTHER LINES | |
21498 | ||
21499 | =over 4 | |
21500 | ||
21501 | =item Bail out! | |
21502 | ||
21503 | =item Diagnostics | |
21504 | ||
21505 | =item Anything else | |
21506 | ||
21507 | =back | |
21508 | ||
21509 | =item EXAMPLES | |
21510 | ||
21511 | =over 4 | |
21512 | ||
21513 | =item Common with explanation | |
21514 | ||
21515 | =item Unknown amount and failures | |
21516 | ||
21517 | =item Giving up | |
21518 | ||
21519 | =item Skipping a few | |
21520 | ||
21521 | =item Skipping everything | |
21522 | ||
21523 | =item Got spare tuits? | |
21524 | ||
21525 | =item Creative liberties | |
21526 | ||
21527 | =back | |
b2a9ae16 NC |
21528 | |
21529 | =item AUTHORS | |
21530 | ||
e7f2ff80 NC |
21531 | =item ACKNOWLEDGEMENTS |
21532 | ||
b2a9ae16 | 21533 | =item COPYRIGHT |
ee382f2f JH |
21534 | |
21535 | =back | |
21536 | ||
21537 | =head2 Test::More - yet another framework for writing test scripts | |
21538 | ||
21539 | =over 4 | |
21540 | ||
21541 | =item SYNOPSIS | |
21542 | ||
21543 | =item DESCRIPTION | |
21544 | ||
21545 | =over 4 | |
21546 | ||
21547 | =item I love it when a plan comes together | |
21548 | ||
21549 | =back | |
21550 | ||
21551 | =back | |
21552 | ||
21553 | =over 4 | |
21554 | ||
21555 | =item Test names | |
21556 | ||
21557 | =item I'm ok, you're not ok. | |
21558 | ||
21559 | B<ok> | |
21560 | ||
21561 | =back | |
21562 | ||
21563 | B<is>, B<isnt> | |
21564 | ||
21565 | B<like> | |
21566 | ||
21567 | B<unlike> | |
21568 | ||
21569 | B<cmp_ok> | |
21570 | ||
21571 | B<can_ok> | |
21572 | ||
21573 | B<isa_ok> | |
21574 | ||
21575 | B<pass>, B<fail> | |
21576 | ||
21577 | =over 4 | |
21578 | ||
b40eed9c | 21579 | =item Module tests |
ee382f2f | 21580 | |
b40eed9c | 21581 | B<use_ok> |
ee382f2f JH |
21582 | |
21583 | =back | |
21584 | ||
b40eed9c NC |
21585 | B<require_ok> |
21586 | ||
ee382f2f JH |
21587 | =over 4 |
21588 | ||
b40eed9c | 21589 | =item Complex data structures |
ee382f2f | 21590 | |
b40eed9c | 21591 | B<is_deeply> |
ee382f2f JH |
21592 | |
21593 | =back | |
21594 | ||
b40eed9c NC |
21595 | =over 4 |
21596 | ||
21597 | =item Diagnostics | |
21598 | ||
21599 | B<diag> | |
21600 | ||
21601 | =back | |
ee382f2f JH |
21602 | |
21603 | =over 4 | |
21604 | ||
21605 | =item Conditional tests | |
21606 | ||
21607 | B<SKIP: BLOCK> | |
21608 | ||
21609 | =back | |
21610 | ||
21611 | B<TODO: BLOCK>, B<todo_skip> | |
21612 | ||
21613 | When do I use SKIP vs. TODO? | |
21614 | ||
21615 | =over 4 | |
21616 | ||
b40eed9c | 21617 | =item Test control |
ee382f2f | 21618 | |
b40eed9c | 21619 | B<BAIL_OUT> |
ee382f2f JH |
21620 | |
21621 | =back | |
21622 | ||
b40eed9c NC |
21623 | =over 4 |
21624 | ||
21625 | =item Discouraged comparison functions | |
21626 | ||
ee382f2f JH |
21627 | B<eq_array> |
21628 | ||
b40eed9c NC |
21629 | =back |
21630 | ||
ee382f2f JH |
21631 | B<eq_hash> |
21632 | ||
21633 | B<eq_set> | |
21634 | ||
21635 | =over 4 | |
21636 | ||
21637 | =item Extending and Embedding Test::More | |
21638 | ||
21639 | B<builder> | |
21640 | ||
21641 | =back | |
21642 | ||
21643 | =over 4 | |
21644 | ||
a563e516 | 21645 | =item EXIT CODES |
ee382f2f | 21646 | |
a563e516 | 21647 | =item CAVEATS and NOTES |
ee382f2f | 21648 | |
a563e516 | 21649 | Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade |
ee382f2f JH |
21650 | |
21651 | =item HISTORY | |
21652 | ||
21653 | =item SEE ALSO | |
21654 | ||
21655 | =item AUTHORS | |
21656 | ||
a563e516 NC |
21657 | =item BUGS |
21658 | ||
ee382f2f JH |
21659 | =item COPYRIGHT |
21660 | ||
21661 | =back | |
21662 | ||
21663 | =head2 Test::Simple - Basic utilities for writing tests. | |
21664 | ||
21665 | =over 4 | |
21666 | ||
21667 | =item SYNOPSIS | |
21668 | ||
21669 | =item DESCRIPTION | |
21670 | ||
21671 | B<ok> | |
21672 | ||
21673 | =back | |
21674 | ||
21675 | =over 4 | |
21676 | ||
21677 | =item EXAMPLE | |
21678 | ||
21679 | =item CAVEATS | |
21680 | ||
21681 | =item NOTES | |
21682 | ||
21683 | =item HISTORY | |
21684 | ||
21685 | =item SEE ALSO | |
21686 | ||
21687 | L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>, | |
21688 | L<Test::Harness> | |
21689 | ||
21690 | =item AUTHORS | |
21691 | ||
21692 | =item COPYRIGHT | |
21693 | ||
21694 | =back | |
21695 | ||
21696 | =head2 Test::Tutorial - A tutorial about writing really basic tests | |
d516a115 | 21697 | |
d420ca49 | 21698 | =over 4 |
a45bd81d | 21699 | |
ee382f2f | 21700 | =item DESCRIPTION |
d516a115 | 21701 | |
ee382f2f | 21702 | =over 4 |
14218588 | 21703 | |
ee382f2f | 21704 | =item Nuts and bolts of testing. |
35c7d401 | 21705 | |
ee382f2f | 21706 | =item Where to start? |
a45bd81d | 21707 | |
ee382f2f | 21708 | =item Names |
d516a115 | 21709 | |
ee382f2f | 21710 | =item Test the manual |
a45bd81d | 21711 | |
ee382f2f | 21712 | =item Sometimes the tests are wrong |
d516a115 | 21713 | |
ee382f2f | 21714 | =item Testing lots of values |
d516a115 | 21715 | |
ee382f2f | 21716 | =item Informative names |
d516a115 | 21717 | |
ee382f2f JH |
21718 | =item Skipping tests |
21719 | ||
21720 | =item Todo tests | |
21721 | ||
21722 | =item Testing with taint mode. | |
21723 | ||
21724 | =back | |
21725 | ||
21726 | =item FOOTNOTES | |
21727 | ||
21728 | =item AUTHORS | |
21729 | ||
21730 | =item COPYRIGHT | |
21731 | ||
21732 | =back | |
21733 | ||
21734 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list | |
21735 | ||
21736 | =over 4 | |
21737 | ||
21738 | =item SYNOPSIS | |
21739 | ||
21740 | =item DESCRIPTION | |
21741 | ||
21742 | =item EXAMPLE | |
21743 | ||
21744 | =back | |
21745 | ||
21746 | =head2 Text::Balanced - Extract delimited text sequences from strings. | |
21747 | ||
21748 | =over 4 | |
21749 | ||
21750 | =item SYNOPSIS | |
21751 | ||
21752 | =item DESCRIPTION | |
21753 | ||
21754 | =over 4 | |
21755 | ||
21756 | =item General behaviour in list contexts | |
21757 | ||
21758 | [0], [1], [2] | |
21759 | ||
21760 | =item General behaviour in scalar and void contexts | |
21761 | ||
21762 | =item A note about prefixes | |
21763 | ||
21764 | =item C<extract_delimited> | |
21765 | ||
21766 | =item C<extract_bracketed> | |
21767 | ||
73fba812 JH |
21768 | =item C<extract_variable> |
21769 | ||
21770 | [0], [1], [2] | |
21771 | ||
ee382f2f JH |
21772 | =item C<extract_tagged> |
21773 | ||
21774 | C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>, | |
21775 | [0], [1], [2], [3], [4], [5] | |
21776 | ||
21777 | =item C<gen_extract_tagged> | |
21778 | ||
21779 | =item C<extract_quotelike> | |
21780 | ||
21781 | [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] | |
21782 | ||
21783 | =item C<extract_quotelike> and "here documents" | |
21784 | ||
21785 | [0], [1], [2], [3], [4], [5], [6], [7..10] | |
21786 | ||
21787 | =item C<extract_codeblock> | |
21788 | ||
21789 | =item C<extract_multiple> | |
21790 | ||
21791 | =item C<gen_delimited_pat> | |
21792 | ||
21793 | =back | |
21794 | ||
21795 | =item DIAGNOSTICS | |
21796 | ||
21797 | C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>, | |
21798 | C<Did not find opening bracket after prefix: "%s">, C<No quotelike | |
21799 | operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">, | |
21800 | C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>, | |
21801 | C<Did not find closing delimiter to match '%s'>, C<Mismatched closing | |
21802 | bracket: expected "%c" but found "%s">, C<No block delimiter found after | |
21803 | quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier | |
21804 | after dereferencer>, C<Did not find expected opening bracket at %s>, | |
21805 | C<Improperly nested codeblock at %s>, C<Missing second block for quotelike | |
21806 | "%s">, C<No match found for opening bracket>, C<Did not find opening tag: | |
21807 | /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid | |
21808 | nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing | |
21809 | tag> | |
21810 | ||
21811 | =item AUTHOR | |
21812 | ||
21813 | =item BUGS AND IRRITATIONS | |
21814 | ||
21815 | =item COPYRIGHT | |
21816 | ||
21817 | =back | |
21818 | ||
21819 | =head2 Text::ParseWords - parse text into an array of tokens or array of | |
21820 | arrays | |
21821 | ||
21822 | =over 4 | |
21823 | ||
21824 | =item SYNOPSIS | |
21825 | ||
21826 | =item DESCRIPTION | |
21827 | ||
21828 | =item EXAMPLES | |
21829 | ||
21830 | =item AUTHORS | |
21831 | ||
21832 | =back | |
21833 | ||
21834 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described | |
21835 | by Knuth | |
21836 | ||
21837 | =over 4 | |
21838 | ||
21839 | =item SYNOPSIS | |
21840 | ||
21841 | =item DESCRIPTION | |
21842 | ||
21843 | =item EXAMPLES | |
21844 | ||
21845 | =item LIMITATIONS | |
21846 | ||
21847 | =item AUTHOR | |
21848 | ||
21849 | =back | |
21850 | ||
21851 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and | |
21852 | unexpand(1) | |
21853 | ||
21854 | =over 4 | |
21855 | ||
21856 | =item SYNOPSIS | |
21857 | ||
21858 | =item DESCRIPTION | |
21859 | ||
21860 | =item BUGS | |
21861 | ||
b40eed9c | 21862 | =item LICENSE |
ee382f2f JH |
21863 | |
21864 | =back | |
21865 | ||
21866 | =head2 Text::Wrap - line wrapping to form simple paragraphs | |
21867 | ||
21868 | =over 4 | |
21869 | ||
21870 | =item SYNOPSIS | |
21871 | ||
21872 | =item DESCRIPTION | |
21873 | ||
21874 | =item OVERRIDES | |
21875 | ||
21876 | =item EXAMPLE | |
21877 | ||
b40eed9c | 21878 | =item LICENSE |
ee382f2f JH |
21879 | |
21880 | =back | |
21881 | ||
21882 | =head2 Thread - manipulate threads in Perl (for old code only) | |
21883 | ||
21884 | =over 4 | |
21885 | ||
21886 | =item CAVEAT | |
21887 | ||
21888 | =item SYNOPSIS | |
21889 | ||
21890 | =item DESCRIPTION | |
21891 | ||
21892 | =item FUNCTIONS | |
21893 | ||
21894 | $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub, | |
21895 | LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE, | |
21896 | cond_signal VARIABLE, cond_broadcast VARIABLE, yield | |
21897 | ||
21898 | =item METHODS | |
21899 | ||
21900 | join, eval, detach, equal, tid, flags, done | |
21901 | ||
21902 | =item LIMITATIONS | |
21903 | ||
21904 | =item SEE ALSO | |
21905 | ||
21906 | =back | |
21907 | ||
21908 | =head2 Thread::Queue - thread-safe queues | |
21909 | ||
21910 | =over 4 | |
21911 | ||
21912 | =item SYNOPSIS | |
21913 | ||
21914 | =item DESCRIPTION | |
d516a115 | 21915 | |
ee382f2f | 21916 | =item FUNCTIONS AND METHODS |
d516a115 | 21917 | |
ee382f2f | 21918 | new, enqueue LIST, dequeue, dequeue_nb, pending |
a45bd81d | 21919 | |
ee382f2f | 21920 | =item SEE ALSO |
ff426ff2 | 21921 | |
ee382f2f | 21922 | =back |
ff426ff2 | 21923 | |
ee382f2f | 21924 | =head2 Thread::Semaphore - thread-safe semaphores |
ff426ff2 | 21925 | |
ee382f2f | 21926 | =over 4 |
ff426ff2 | 21927 | |
ee382f2f | 21928 | =item SYNOPSIS |
35c7d401 | 21929 | |
ee382f2f | 21930 | =item DESCRIPTION |
35c7d401 | 21931 | |
ee382f2f | 21932 | =item FUNCTIONS AND METHODS |
35c7d401 | 21933 | |
ee382f2f | 21934 | new, new NUMBER, down, down NUMBER, up, up NUMBER |
35c7d401 | 21935 | |
ee382f2f | 21936 | =back |
ff426ff2 | 21937 | |
ee382f2f JH |
21938 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
21939 | (for old code) | |
ff426ff2 | 21940 | |
ee382f2f | 21941 | =over 4 |
b2deec1d | 21942 | |
ee382f2f | 21943 | =item CAVEAT |
ff426ff2 | 21944 | |
ee382f2f | 21945 | =item SYNOPSIS |
b2deec1d | 21946 | |
ee382f2f | 21947 | =item DESCRIPTION |
ff426ff2 | 21948 | |
ee382f2f | 21949 | =item BUGS |
ff426ff2 | 21950 | |
ee382f2f | 21951 | =back |
ff426ff2 | 21952 | |
ee382f2f | 21953 | =head2 Thread::Specific - thread-specific keys |
ff426ff2 | 21954 | |
ee382f2f | 21955 | =over 4 |
ff426ff2 | 21956 | |
ee382f2f | 21957 | =item SYNOPSIS |
ff426ff2 | 21958 | |
ee382f2f | 21959 | =item DESCRIPTION |
ff426ff2 | 21960 | |
ee382f2f | 21961 | =back |
ff426ff2 | 21962 | |
ee382f2f | 21963 | =head2 Tie::Array - base class for tied arrays |
ff426ff2 | 21964 | |
ee382f2f | 21965 | =over 4 |
ff426ff2 | 21966 | |
ee382f2f | 21967 | =item SYNOPSIS |
ff426ff2 | 21968 | |
ee382f2f | 21969 | =item DESCRIPTION |
ff426ff2 | 21970 | |
ee382f2f JH |
21971 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, |
21972 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, | |
21973 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
21974 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
e993db8c | 21975 | |
ee382f2f | 21976 | =item CAVEATS |
e993db8c | 21977 | |
ee382f2f | 21978 | =item AUTHOR |
ff426ff2 | 21979 | |
ee382f2f | 21980 | =back |
ff426ff2 | 21981 | |
ee382f2f | 21982 | =head2 Tie::File - Access the lines of a disk file via a Perl array |
ff426ff2 | 21983 | |
ee382f2f | 21984 | =over 4 |
ff426ff2 | 21985 | |
ee382f2f | 21986 | =item SYNOPSIS |
ff426ff2 | 21987 | |
ee382f2f | 21988 | =item DESCRIPTION |
ff426ff2 | 21989 | |
ee382f2f | 21990 | =over 4 |
ff426ff2 | 21991 | |
ee382f2f | 21992 | =item C<recsep> |
ff426ff2 | 21993 | |
ee382f2f | 21994 | =item C<autochomp> |
ff426ff2 | 21995 | |
ee382f2f | 21996 | =item C<mode> |
193fb0af | 21997 | |
ee382f2f | 21998 | =item C<memory> |
a45bd81d | 21999 | |
ee382f2f | 22000 | =item C<dw_size> |
193fb0af | 22001 | |
ee382f2f | 22002 | =item Option Format |
193fb0af | 22003 | |
ee382f2f | 22004 | =back |
35c7d401 | 22005 | |
ee382f2f JH |
22006 | =item Public Methods |
22007 | ||
22008 | =over 4 | |
22009 | ||
22010 | =item C<flock> | |
22011 | ||
22012 | =item C<autochomp> | |
22013 | ||
22014 | =item C<defer>, C<flush>, C<discard>, and C<autodefer> | |
193fb0af | 22015 | |
1184f6df JH |
22016 | =item C<offset> |
22017 | ||
35c7d401 | 22018 | =back |
193fb0af | 22019 | |
ee382f2f JH |
22020 | =item Tying to an already-opened filehandle |
22021 | ||
22022 | =item Deferred Writing | |
22023 | ||
22024 | =over 4 | |
22025 | ||
22026 | =item Autodeferring | |
37d4d706 | 22027 | |
a45bd81d GS |
22028 | =back |
22029 | ||
1184f6df JH |
22030 | =item CONCURRENT ACCESS TO FILES |
22031 | ||
ee382f2f JH |
22032 | =item CAVEATS |
22033 | ||
22034 | =item SUBCLASSING | |
22035 | ||
22036 | =item WHAT ABOUT C<DB_File>? | |
22037 | ||
22038 | =item AUTHOR | |
22039 | ||
22040 | =item LICENSE | |
22041 | ||
22042 | =item WARRANTY | |
22043 | ||
22044 | =item THANKS | |
22045 | ||
22046 | =item TODO | |
22047 | ||
22048 | =back | |
22049 | ||
22050 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied | |
22051 | handles | |
8ebc5c01 | 22052 | |
d420ca49 | 22053 | =over 4 |
a45bd81d | 22054 | |
8ebc5c01 | 22055 | =item SYNOPSIS |
22056 | ||
22057 | =item DESCRIPTION | |
cb1a09d0 | 22058 | |
ee382f2f JH |
22059 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, |
22060 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
22061 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, | |
22062 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
22063 | ||
22064 | =item MORE INFORMATION | |
22065 | ||
22066 | =item COMPATIBILITY | |
22067 | ||
22068 | =back | |
22069 | ||
22070 | =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for | |
22071 | tied hashes | |
22072 | ||
35c7d401 JH |
22073 | =over 4 |
22074 | ||
ee382f2f | 22075 | =item SYNOPSIS |
cb1a09d0 | 22076 | |
ee382f2f | 22077 | =item DESCRIPTION |
12b7c5c7 | 22078 | |
ee382f2f | 22079 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
4c64e75b NC |
22080 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR |
22081 | this, SCALAR this | |
12b7c5c7 | 22082 | |
ee382f2f | 22083 | =item Inheriting from B<Tie::StdHash> |
cb1a09d0 | 22084 | |
ee382f2f JH |
22085 | =item Inheriting from B<Tie::ExtraHash> |
22086 | ||
4c64e75b | 22087 | =item C<SCALAR>, C<UNTIE> and C<DESTROY> |
ee382f2f JH |
22088 | |
22089 | =item MORE INFORMATION | |
cb1a09d0 | 22090 | |
a45bd81d GS |
22091 | =back |
22092 | ||
ee382f2f | 22093 | =head2 Tie::Memoize - add data to hash when needed |
12b7c5c7 | 22094 | |
ee382f2f JH |
22095 | =over 4 |
22096 | ||
22097 | =item SYNOPSIS | |
22098 | ||
22099 | =item DESCRIPTION | |
22100 | ||
22101 | =item Inheriting from B<Tie::Memoize> | |
22102 | ||
22103 | =item EXAMPLE | |
22104 | ||
22105 | =item BUGS | |
22106 | ||
22107 | =item AUTHOR | |
12b7c5c7 | 22108 | |
35c7d401 | 22109 | =back |
12b7c5c7 | 22110 | |
ee382f2f | 22111 | =head2 Tie::RefHash - use references as hash keys |
12b7c5c7 | 22112 | |
35c7d401 | 22113 | =over 4 |
12b7c5c7 | 22114 | |
35c7d401 | 22115 | =item SYNOPSIS |
12b7c5c7 | 22116 | |
35c7d401 | 22117 | =item DESCRIPTION |
12b7c5c7 | 22118 | |
ee382f2f | 22119 | =item EXAMPLE |
12b7c5c7 | 22120 | |
ee382f2f | 22121 | =item AUTHOR |
12b7c5c7 | 22122 | |
ee382f2f | 22123 | =item VERSION |
cb1a09d0 | 22124 | |
ee382f2f | 22125 | =item SEE ALSO |
a45bd81d | 22126 | |
ee382f2f | 22127 | =back |
cb1a09d0 | 22128 | |
ee382f2f JH |
22129 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
22130 | scalars | |
cb1a09d0 | 22131 | |
ee382f2f JH |
22132 | =over 4 |
22133 | ||
22134 | =item SYNOPSIS | |
22135 | ||
22136 | =item DESCRIPTION | |
22137 | ||
22138 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this | |
22139 | ||
22140 | =item MORE INFORMATION | |
cb1a09d0 | 22141 | |
35c7d401 | 22142 | =back |
cb1a09d0 | 22143 | |
ee382f2f JH |
22144 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
22145 | ||
22146 | =over 4 | |
22147 | ||
22148 | =item SYNOPSIS | |
22149 | ||
22150 | =item DESCRIPTION | |
cb1a09d0 | 22151 | |
ee382f2f | 22152 | =item CAVEATS |
cb1a09d0 | 22153 | |
a45bd81d GS |
22154 | =back |
22155 | ||
ee382f2f JH |
22156 | =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval |
22157 | timers | |
cb1a09d0 | 22158 | |
d420ca49 | 22159 | =over 4 |
a45bd81d | 22160 | |
cb1a09d0 AD |
22161 | =item SYNOPSIS |
22162 | ||
cb1a09d0 AD |
22163 | =item DESCRIPTION |
22164 | ||
b2a9ae16 NC |
22165 | gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm ( |
22166 | $useconds [, $interval_useconds ] ), tv_interval, time (), sleep ( | |
22167 | $floating_seconds ), alarm ( $floating_seconds [, | |
22168 | $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [, | |
b40eed9c NC |
22169 | $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime ( |
22170 | $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds, | |
22171 | $flags = 0), clock() | |
a45bd81d | 22172 | |
ee382f2f | 22173 | =item EXAMPLES |
cb1a09d0 | 22174 | |
ee382f2f | 22175 | =item C API |
a45bd81d | 22176 | |
1184f6df JH |
22177 | =item DIAGNOSTICS |
22178 | ||
22179 | =over 4 | |
22180 | ||
22181 | =item negative time not invented yet | |
22182 | ||
22183 | =item internal error: useconds < 0 (unsigned ... signed ...) | |
22184 | ||
22185 | =back | |
22186 | ||
ee382f2f | 22187 | =item CAVEATS |
cb1a09d0 | 22188 | |
b40eed9c NC |
22189 | =item SEE ALSO |
22190 | ||
ee382f2f | 22191 | =item AUTHORS |
cb1a09d0 | 22192 | |
ee382f2f | 22193 | =item COPYRIGHT AND LICENSE |
cb1a09d0 | 22194 | |
a45bd81d GS |
22195 | =back |
22196 | ||
ee382f2f | 22197 | =head2 Time::Local - efficiently compute time from local and GMT time |
41ca3a40 JH |
22198 | |
22199 | =over 4 | |
22200 | ||
ee382f2f | 22201 | =item SYNOPSIS |
41ca3a40 | 22202 | |
ee382f2f | 22203 | =item DESCRIPTION |
41ca3a40 | 22204 | |
d3ca9f77 NC |
22205 | =over 4 |
22206 | ||
22207 | =item Ambiguous Local Times (DST) | |
22208 | ||
22209 | =item Non-Existent Local Times (DST) | |
22210 | ||
22211 | =item Negative Epoch Values | |
22212 | ||
22213 | =back | |
22214 | ||
ee382f2f | 22215 | =item IMPLEMENTATION |
41ca3a40 | 22216 | |
ee382f2f | 22217 | =item BUGS |
41ca3a40 | 22218 | |
6e76d345 JH |
22219 | =item SUPPORT |
22220 | ||
22221 | =item AUTHOR | |
22222 | ||
ee382f2f | 22223 | =back |
41ca3a40 | 22224 | |
ee382f2f JH |
22225 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
22226 | function | |
245d750e | 22227 | |
ee382f2f | 22228 | =over 4 |
41ca3a40 | 22229 | |
ee382f2f | 22230 | =item SYNOPSIS |
41ca3a40 | 22231 | |
ee382f2f | 22232 | =item DESCRIPTION |
35c7d401 | 22233 | |
ee382f2f JH |
22234 | =item NOTE |
22235 | ||
22236 | =item AUTHOR | |
41ca3a40 JH |
22237 | |
22238 | =back | |
22239 | ||
ee382f2f JH |
22240 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
22241 | function | |
cb1a09d0 | 22242 | |
d420ca49 | 22243 | =over 4 |
a45bd81d | 22244 | |
ee382f2f | 22245 | =item SYNOPSIS |
cb1a09d0 | 22246 | |
ee382f2f | 22247 | =item DESCRIPTION |
14218588 | 22248 | |
ee382f2f | 22249 | =item NOTE |
35c7d401 | 22250 | |
ee382f2f | 22251 | =item AUTHOR |
14218588 | 22252 | |
a45bd81d GS |
22253 | =back |
22254 | ||
ee382f2f | 22255 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 22256 | |
ee382f2f | 22257 | =over 4 |
a45bd81d | 22258 | |
ee382f2f | 22259 | =item SYNOPSIS |
7d2bfb28 | 22260 | |
ee382f2f JH |
22261 | =item DESCRIPTION |
22262 | ||
22263 | =item AUTHOR | |
22264 | ||
22265 | =back | |
22266 | ||
22267 | =head2 UNIVERSAL - base class for ALL classes (blessed references) | |
7d2bfb28 | 22268 | |
35c7d401 | 22269 | =over 4 |
7d2bfb28 | 22270 | |
ee382f2f | 22271 | =item SYNOPSIS |
35c7d401 | 22272 | |
ee382f2f | 22273 | =item DESCRIPTION |
35c7d401 | 22274 | |
ee382f2f JH |
22275 | C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>, |
22276 | C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<< | |
22277 | CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )> | |
22278 | ||
22279 | =item EXPORTS | |
7d2bfb28 | 22280 | |
a45bd81d GS |
22281 | =back |
22282 | ||
ee382f2f | 22283 | =head2 Unicode::Collate - Unicode Collation Algorithm |
7d2bfb28 | 22284 | |
d420ca49 | 22285 | =over 4 |
a45bd81d | 22286 | |
ee382f2f | 22287 | =item SYNOPSIS |
7d2bfb28 | 22288 | |
ee382f2f | 22289 | =item DESCRIPTION |
7d2bfb28 | 22290 | |
ee382f2f | 22291 | =over 4 |
35c7d401 | 22292 | |
ee382f2f | 22293 | =item Constructor and Tailoring |
7d2bfb28 | 22294 | |
b40eed9c NC |
22295 | UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar, |
22296 | ignoreName, katakana_before_hiragana, level, normalization, overrideCJK, | |
22297 | overrideHangul, preprocess, rearrange, table, undefChar, undefName, | |
22298 | upper_before_lower, variable | |
a45bd81d | 22299 | |
ee382f2f | 22300 | =item Methods for Collation |
7d2bfb28 | 22301 | |
ee382f2f JH |
22302 | C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result = |
22303 | $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>, | |
22304 | C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a, | |
22305 | $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result = | |
22306 | $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>, | |
22307 | C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm = | |
22308 | $Collator-E<gt>viewSortKey($string)> | |
a45bd81d | 22309 | |
ee382f2f | 22310 | =item Methods for Searching |
7d2bfb28 | 22311 | |
ee382f2f JH |
22312 | C<$position = $Collator-E<gt>index($string, $substring[, $position])>, |
22313 | C<($position, $length) = $Collator-E<gt>index($string, $substring[, | |
22314 | $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>, | |
22315 | C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match = | |
22316 | $Collator-E<gt>gmatch($string, $substring)>, C<$count = | |
22317 | $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count = | |
22318 | $Collator-E<gt>gsubst($string, $substring, $replacement)> | |
8ebc5c01 | 22319 | |
ee382f2f | 22320 | =item Other Methods |
35c7d401 | 22321 | |
91e033c7 NC |
22322 | C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version = |
22323 | $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()> | |
8ebc5c01 | 22324 | |
b40eed9c NC |
22325 | =back |
22326 | ||
ee382f2f | 22327 | =item EXPORT |
a45bd81d | 22328 | |
b40eed9c | 22329 | =item INSTALL |
8ebc5c01 | 22330 | |
b40eed9c | 22331 | =item CAVEATS |
a45bd81d | 22332 | |
b40eed9c | 22333 | Normalization, Conformance Test |
7d2bfb28 | 22334 | |
b40eed9c | 22335 | =item AUTHOR, COPYRIGHT AND LICENSE |
7d2bfb28 | 22336 | |
35c7d401 JH |
22337 | =item SEE ALSO |
22338 | ||
91e033c7 NC |
22339 | Unicode Collation Algorithm - UTS #10, The Default Unicode Collation |
22340 | Element Table (DUCET), The conformance test for the UCA, Hangul Syllable | |
b40eed9c | 22341 | Type, Unicode Normalization Forms - UAX #15 |
7d2bfb28 | 22342 | |
a45bd81d GS |
22343 | =back |
22344 | ||
ee382f2f | 22345 | =head2 Unicode::Normalize - Unicode Normalization Forms |
53d7eaa8 JH |
22346 | |
22347 | =over 4 | |
22348 | ||
22349 | =item SYNOPSIS | |
22350 | ||
22351 | =item DESCRIPTION | |
22352 | ||
22353 | =over 4 | |
22354 | ||
ee382f2f | 22355 | =item Normalization Forms |
53d7eaa8 | 22356 | |
ee382f2f JH |
22357 | C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>, |
22358 | C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>, | |
91e033c7 | 22359 | C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>, |
ee382f2f | 22360 | C<$normalized_string = normalize($form_name, $string)> |
53d7eaa8 | 22361 | |
ee382f2f | 22362 | =item Decomposition and Composition |
53d7eaa8 | 22363 | |
ee382f2f JH |
22364 | C<$decomposed_string = decompose($string)>, C<$decomposed_string = |
22365 | decompose($string, $useCompatMapping)>, C<$reordered_string = | |
22366 | reorder($string)>, C<$composed_string = compose($string)> | |
53d7eaa8 | 22367 | |
ee382f2f | 22368 | =item Quick Check |
849d92fd | 22369 | |
ee382f2f JH |
22370 | C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result = |
22371 | checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result = | |
91e033c7 | 22372 | checkFCD($string)>, C<$result = checkFCC($string)>, C<$result = |
ee382f2f | 22373 | check($form_name, $string)> |
849d92fd | 22374 | |
ee382f2f | 22375 | =item Character Data |
53d7eaa8 | 22376 | |
ee382f2f JH |
22377 | C<$canonical_decomposed = getCanon($codepoint)>, |
22378 | C<$compatibility_decomposed = getCompat($codepoint)>, | |
22379 | C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, | |
22380 | C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = | |
22381 | isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, | |
22382 | C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, | |
22383 | C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> | |
ff426ff2 | 22384 | |
b2a9ae16 NC |
22385 | =back |
22386 | ||
ee382f2f | 22387 | =item EXPORT |
53d7eaa8 | 22388 | |
b2a9ae16 NC |
22389 | =item CAVEATS |
22390 | ||
22391 | Perl's version vs. Unicode version, Correction of decomposition mapping, | |
22392 | Revised definition of canonical composition | |
849d92fd | 22393 | |
53d7eaa8 JH |
22394 | =item AUTHOR |
22395 | ||
35c7d401 | 22396 | =item SEE ALSO |
53d7eaa8 | 22397 | |
7a5cdbdf | 22398 | http://www.unicode.org/reports/tr15/, |
91e033c7 | 22399 | http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt, |
b2a9ae16 NC |
22400 | http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt, |
22401 | http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/ | |
ee382f2f | 22402 | |
53d7eaa8 JH |
22403 | =back |
22404 | ||
ee382f2f | 22405 | =head2 Unicode::UCD - Unicode character database |
53d7eaa8 JH |
22406 | |
22407 | =over 4 | |
22408 | ||
22409 | =item SYNOPSIS | |
22410 | ||
22411 | =item DESCRIPTION | |
22412 | ||
ee382f2f | 22413 | =back |
f502af34 | 22414 | |
ee382f2f | 22415 | =over 4 |
f502af34 | 22416 | |
ee382f2f | 22417 | =item charinfo |
b2deec1d | 22418 | |
35c7d401 | 22419 | =back |
b2deec1d | 22420 | |
35c7d401 | 22421 | =over 4 |
b2deec1d | 22422 | |
ee382f2f | 22423 | =item charblock |
53d7eaa8 | 22424 | |
ee382f2f | 22425 | =back |
f502af34 | 22426 | |
35c7d401 | 22427 | =over 4 |
53d7eaa8 | 22428 | |
ee382f2f | 22429 | =item charscript |
53d7eaa8 JH |
22430 | |
22431 | =back | |
22432 | ||
ee382f2f | 22433 | =over 4 |
53d7eaa8 | 22434 | |
ee382f2f | 22435 | =item charblocks |
53d7eaa8 | 22436 | |
53d7eaa8 JH |
22437 | =back |
22438 | ||
354a27bf JH |
22439 | =over 4 |
22440 | ||
ee382f2f | 22441 | =item charscripts |
354a27bf | 22442 | |
ee382f2f | 22443 | =back |
354a27bf | 22444 | |
354a27bf JH |
22445 | =over 4 |
22446 | ||
ee382f2f | 22447 | =item Blocks versus Scripts |
354a27bf | 22448 | |
ee382f2f | 22449 | =item Matching Scripts and Blocks |
354a27bf | 22450 | |
ee382f2f | 22451 | =item Code Point Arguments |
fbe3d936 | 22452 | |
ee382f2f | 22453 | =item charinrange |
fbe3d936 | 22454 | |
ee382f2f | 22455 | =back |
fbe3d936 | 22456 | |
ee382f2f | 22457 | =over 4 |
fbe3d936 | 22458 | |
ee382f2f | 22459 | =item compexcl |
389925df | 22460 | |
ee382f2f | 22461 | =back |
389925df | 22462 | |
ee382f2f | 22463 | =over 4 |
389925df | 22464 | |
ee382f2f | 22465 | =item casefold |
389925df | 22466 | |
ee382f2f | 22467 | =back |
389925df | 22468 | |
ee382f2f | 22469 | =over 4 |
d0363f02 | 22470 | |
ee382f2f | 22471 | =item casespec |
389925df JH |
22472 | |
22473 | =back | |
22474 | ||
ee382f2f | 22475 | =over 4 |
d0363f02 | 22476 | |
b2a9ae16 NC |
22477 | =item namedseq() |
22478 | ||
22479 | =back | |
22480 | ||
22481 | =over 4 | |
22482 | ||
ee382f2f | 22483 | =item Unicode::UCD::UnicodeVersion |
d0363f02 | 22484 | |
ee382f2f | 22485 | =back |
d0363f02 | 22486 | |
ee382f2f | 22487 | =over 4 |
d0363f02 | 22488 | |
ee382f2f | 22489 | =item Implementation Note |
d0363f02 | 22490 | |
ee382f2f | 22491 | =back |
35c7d401 | 22492 | |
d0363f02 JH |
22493 | =over 4 |
22494 | ||
ee382f2f | 22495 | =item BUGS |
35c7d401 | 22496 | |
ee382f2f | 22497 | =item AUTHOR |
d0363f02 JH |
22498 | |
22499 | =back | |
22500 | ||
ee382f2f JH |
22501 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
22502 | functions | |
d0363f02 | 22503 | |
35c7d401 | 22504 | =over 4 |
389925df | 22505 | |
35c7d401 | 22506 | =item SYNOPSIS |
389925df | 22507 | |
35c7d401 | 22508 | =item DESCRIPTION |
389925df | 22509 | |
ee382f2f | 22510 | =item NOTE |
cb52f95f | 22511 | |
354a27bf JH |
22512 | =item AUTHOR |
22513 | ||
22514 | =back | |
22515 | ||
ee382f2f JH |
22516 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
22517 | functions | |
7d2bfb28 | 22518 | |
d420ca49 | 22519 | =over 4 |
a45bd81d | 22520 | |
8ebc5c01 | 22521 | =item SYNOPSIS |
7d2bfb28 | 22522 | |
8ebc5c01 | 22523 | =item DESCRIPTION |
7d2bfb28 | 22524 | |
ee382f2f | 22525 | =over 4 |
b38f6a39 | 22526 | |
ee382f2f | 22527 | =item System Specifics |
b38f6a39 GS |
22528 | |
22529 | =back | |
22530 | ||
ee382f2f | 22531 | =item NOTE |
b38f6a39 | 22532 | |
ee382f2f | 22533 | =item AUTHOR |
35c7d401 | 22534 | |
ee382f2f | 22535 | =item HISTORY |
b38f6a39 | 22536 | |
ee382f2f | 22537 | March 18th, 2000 |
b38f6a39 GS |
22538 | |
22539 | =back | |
22540 | ||
ee382f2f | 22541 | =head2 XSLoader - Dynamically load C libraries into Perl code |
a45bd81d | 22542 | |
d420ca49 | 22543 | =over 4 |
a45bd81d | 22544 | |
b40eed9c NC |
22545 | =item VERSION |
22546 | ||
a45bd81d GS |
22547 | =item SYNOPSIS |
22548 | ||
22549 | =item DESCRIPTION | |
22550 | ||
7550e1ad JH |
22551 | =over 4 |
22552 | ||
22553 | =item Migration from C<DynaLoader> | |
22554 | ||
22555 | =item Backward compatible boilerplate | |
22556 | ||
22557 | =back | |
22558 | ||
22559 | =item Order of initialization: early load() | |
22560 | ||
22561 | =over 4 | |
22562 | ||
22563 | =item The most hairy case | |
22564 | ||
22565 | =back | |
22566 | ||
b40eed9c NC |
22567 | =item DIAGNOSTICS |
22568 | ||
22569 | Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined | |
22570 | symbols present after loading %s: %s, XSLoader::load('Your::Module', | |
22571 | $Your::Module::VERSION) | |
22572 | ||
7550e1ad JH |
22573 | =item LIMITATIONS |
22574 | ||
b40eed9c NC |
22575 | =item BUGS |
22576 | ||
22577 | =item SEE ALSO | |
22578 | ||
22579 | =item AUTHORS | |
22580 | ||
22581 | =item COPYRIGHT | |
a45bd81d GS |
22582 | |
22583 | =back | |
22584 | ||
ee382f2f JH |
22585 | =head1 AUXILIARY DOCUMENTATION |
22586 | ||
22587 | Here should be listed all the extra programs' documentation, but they | |
22588 | don't all have manual pages yet: | |
cb1a09d0 | 22589 | |
d420ca49 | 22590 | =over 4 |
a45bd81d | 22591 | |
ee382f2f | 22592 | =item a2p |
cb1a09d0 | 22593 | |
50e34432 | 22594 | =item c2ph |
cb1a09d0 | 22595 | |
50e34432 | 22596 | =item dprofpp |
ee382f2f JH |
22597 | |
22598 | =item h2ph | |
22599 | ||
ee382f2f JH |
22600 | =item h2xs |
22601 | ||
50e34432 JH |
22602 | =item perlbug |
22603 | ||
22604 | =item perldoc | |
22605 | ||
22606 | =item pl2pm | |
22607 | ||
22608 | =item pod2html | |
ee382f2f JH |
22609 | |
22610 | =item pod2man | |
22611 | ||
50e34432 JH |
22612 | =item s2p |
22613 | ||
22614 | =item splain | |
22615 | ||
22616 | =item xsubpp | |
cb1a09d0 | 22617 | |
a45bd81d GS |
22618 | =back |
22619 | ||
ee382f2f | 22620 | =head1 AUTHOR |
cb1a09d0 | 22621 | |
ee382f2f JH |
22622 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
22623 | of other folks. | |
cb1a09d0 | 22624 |