Commit | Line | Data |
---|---|---|
cb1a09d0 AD |
1 | |
2 | =head1 NAME | |
3 | ||
4 | perltoc - perl documentation table of contents | |
5 | ||
6 | =head1 DESCRIPTION | |
7 | ||
8 | This page provides a brief table of contents for the rest of the Perl | |
28757baa | 9 | documentation set. It is meant to be scanned quickly or grepped |
402d0d99 | 10 | through to locate the proper section you're looking for. |
cb1a09d0 AD |
11 | |
12 | =head1 BASIC DOCUMENTATION | |
13 | ||
cb1a09d0 AD |
14 | =head2 perl - Practical Extraction and Report Language |
15 | ||
d420ca49 | 16 | =over 4 |
a45bd81d | 17 | |
cb1a09d0 AD |
18 | =item SYNOPSIS |
19 | ||
cb1a09d0 AD |
20 | =item DESCRIPTION |
21 | ||
14218588 GS |
22 | modularity and reusability using innumerable modules, embeddable and |
23 | extensible, roll-your-own magic variables (including multiple simultaneous | |
24 | DBM implementations), subroutines can now be overridden, autoloaded, and | |
25 | prototyped, arbitrarily nested data structures and anonymous functions, | |
26 | object-oriented programming, compilability into C code or Perl bytecode, | |
27 | support for light-weight processes (threads), support for | |
28 | internationalization, localization, and Unicode, lexical scoping, regular | |
29 | expression enhancements, enhanced debugger and interactive Perl | |
30 | environment, with integrated editor support, POSIX 1003.1 compliant library | |
31 | ||
32 | =item AVAILABILITY | |
cb1a09d0 AD |
33 | |
34 | =item ENVIRONMENT | |
35 | ||
cb1a09d0 AD |
36 | =item AUTHOR |
37 | ||
cb1a09d0 AD |
38 | =item FILES |
39 | ||
cb1a09d0 AD |
40 | =item SEE ALSO |
41 | ||
cb1a09d0 AD |
42 | =item DIAGNOSTICS |
43 | ||
cb1a09d0 AD |
44 | =item BUGS |
45 | ||
cb1a09d0 AD |
46 | =item NOTES |
47 | ||
a45bd81d GS |
48 | =back |
49 | ||
14218588 GS |
50 | =head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 |
51 | 20:38:02 $) | |
68dc0745 | 52 | |
d420ca49 | 53 | =over 4 |
a45bd81d | 54 | |
68dc0745 | 55 | =item DESCRIPTION |
56 | ||
57 | perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions | |
14218588 GS |
58 | About Perl, What is Perl?, Who supports Perl? Who develops it? Why is it |
59 | free?, Which version of Perl should I use?, What are perl4 and perl5?, What | |
60 | is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl | |
61 | compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can | |
62 | I do [task] in Perl?, When shouldn't I program in Perl?, What's the | |
63 | difference between "perl" and "Perl"?, Is it a Perl program or a Perl | |
64 | script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?, | |
d420ca49 AD |
65 | How can I convince my sysadmin/supervisor/employees to use (version |
66 | 5/5.005/Perl) instead of some other language?, L<perlfaq2>: Obtaining and | |
14218588 GS |
67 | Learning about Perl, What machines support Perl? Where do I get it?, How |
68 | can I get a binary version of Perl?, I don't have a C compiler on my | |
69 | system. How can I compile perl?, I copied the Perl binary from one machine | |
70 | to another, but scripts don't work, I grabbed the sources and tried to | |
71 | compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make | |
72 | it work?, What modules and extensions are available for Perl? What is | |
73 | CPAN? What does CPAN/src/... mean?, Is there an ISO or ANSI certified | |
74 | version of Perl?, Where can I get information on Perl?, What are the Perl | |
75 | newsgroups on USENET? Where do I post questions?, Where should I post | |
76 | source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW | |
77 | Access, What mailing lists are there for perl?, Archives of | |
78 | comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where | |
79 | do I send bug reports?, What is perl.com?, L<perlfaq3>: Programming Tools, | |
80 | How do I do (anything)?, How can I use Perl interactively?, Is there a Perl | |
81 | shell?, How do I debug my Perl programs?, How do I profile my Perl | |
82 | programs?, How do I cross-reference my Perl programs?, Is there a | |
83 | pretty-printer (formatter) for Perl?, Is there a ctags for Perl?, Is there | |
84 | an IDE or Windows Perl Editor?, Where can I get Perl macros for vi?, Where | |
85 | can I get perl-mode for emacs?, How can I use curses with Perl?, How can I | |
86 | use X or Tk with Perl?, How can I generate simple menus without using CGI | |
87 | or Tk?, What is undump?, How can I make my Perl program run faster?, How | |
88 | can I make my Perl program take less memory?, Is it unsafe to return a | |
89 | pointer to local data?, How can I free an array or hash so my program | |
90 | shrinks?, How can I make my CGI script more efficient?, How can I hide the | |
91 | source for my Perl program?, How can I compile my Perl program into byte | |
92 | code or C?, How can I compile Perl into Java?, How can I get C<#!perl> to | |
93 | work on [MS-DOS,NT,...]?, Can I write useful perl programs on the command | |
94 | line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can | |
95 | I learn about CGI or Web programming in Perl?, Where can I learn about | |
96 | object-oriented Perl programming?, Where can I learn about linking C with | |
97 | Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't | |
d420ca49 | 98 | embed perl in my C program; what am I doing wrong?, When I tried to run my |
0e032a14 | 99 | script, I got this message. What does it mean?, What's MakeMaker?, |
14218588 GS |
100 | L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg, |
101 | 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?, | |
102 | Why isn't my octal data interpreted correctly?, Does Perl have a round() | |
103 | function? What about ceil() and floor()? Trig functions?, How do I | |
104 | convert bits into ints?, Why doesn't & work the way I want it to?, How do I | |
105 | multiply matrices?, How do I perform an operation on a series of integers?, | |
106 | How can I output Roman numerals?, Why aren't my random numbers random?, How | |
107 | do I find the week-of-the-year/day-of-the-year?, How do I find the current | |
108 | century or millennium?, How can I compare two dates and find the | |
109 | difference?, How can I take a string and turn it into epoch seconds?, How | |
110 | can I find the Julian Day?, How do I find yesterday's date?, Does Perl have | |
111 | a year 2000 problem? Is Perl Y2K compliant?, How do I validate input?, How | |
112 | do I unescape a string?, How do I remove consecutive pairs of characters?, | |
113 | How do I expand function calls in a string?, How do I find matching/nesting | |
114 | anything?, How do I reverse a string?, How do I expand tabs in a string?, | |
115 | How do I reformat a paragraph?, How can I access/change the first N letters | |
116 | of a string?, How do I change the Nth occurrence of something?, How can I | |
117 | count the number of occurrences of a substring within a string?, How do I | |
118 | capitalize all the words on one line?, How can I split a [character] | |
0e032a14 | 119 | delimited string except when inside [character]? (Comma-separated files), |
14218588 GS |
120 | How do I strip blank space from the beginning/end of a string?, How do I |
121 | pad a string with blanks or pad a number with zeroes?, How do I extract | |
122 | selected columns from a string?, How do I find the soundex value of a | |
123 | string?, How can I expand variables in text strings?, What's wrong with | |
b38f6a39 GS |
124 | always quoting "$vars"?, Why don't my <<HERE documents work?, What is the |
125 | difference between a list and an array?, What is the difference between | |
126 | $array[1] and @array[1]?, How can I remove duplicate elements from a list | |
127 | or array?, How can I tell whether a list or array contains a certain | |
14218588 GS |
128 | element?, How do I compute the difference of two arrays? How do I compute |
129 | the intersection of two arrays?, How do I test whether two arrays or hashes | |
130 | are equal?, How do I find the first array element for which a condition is | |
131 | true?, How do I handle linked lists?, How do I handle circular lists?, How | |
132 | do I shuffle an array randomly?, How do I process/modify each element of an | |
133 | array?, How do I select a random element from an array?, How do I permute N | |
134 | elements of a list?, How do I sort an array by (anything)?, How do I | |
135 | manipulate arrays of bits?, Why does defined() return true on empty arrays | |
136 | and hashes?, How do I process an entire hash?, What happens if I add or | |
137 | remove keys from a hash while iterating over it?, How do I look up a hash | |
138 | element by value?, How can I know how many entries are in a hash?, How do I | |
139 | sort a hash (optionally by value instead of key)?, How can I always keep my | |
140 | hash sorted?, What's the difference between "delete" and "undef" with | |
141 | hashes?, Why don't my tied hashes make the defined/exists distinction?, How | |
142 | do I reset an each() operation part-way through?, How can I get the unique | |
143 | keys from two hashes?, How can I store a multidimensional array in a DBM | |
144 | file?, How can I make my hash remember the order I put elements into it?, | |
145 | Why does passing a subroutine an undefined element in a hash create it?, | |
146 | How can I make the Perl equivalent of a C structure/C++ class/hash or array | |
147 | of hashes or arrays?, How can I use a reference as a hash key?, How do I | |
148 | handle binary data correctly?, How do I determine whether a scalar is a | |
149 | number/whole/integer/float?, How do I keep persistent data across program | |
150 | calls?, How do I print out or copy a recursive data structure?, How do I | |
151 | define methods for every class/object?, How do I verify a credit card | |
152 | checksum?, How do I pack arrays of doubles or floats for XS code?, | |
153 | L<perlfaq5>: Files and Formats, How do I flush/unbuffer an output | |
154 | filehandle? Why must I do this?, How do I change one line in a file/delete | |
155 | a line in a file/insert a line in the middle of a file/append to the | |
156 | beginning of a file?, How do I count the number of lines in a file?, How do | |
157 | I make a temporary file name?, How can I manipulate fixed-record-length | |
158 | files?, How can I make a filehandle local to a subroutine? How do I pass | |
159 | filehandles between subroutines? How do I make an array of filehandles?, | |
160 | How can I use a filehandle indirectly?, How can I set up a footer format to | |
161 | be used with write()?, How can I write() into a string?, How can I output | |
162 | my numbers with commas added?, How can I translate tildes (~) in a | |
163 | filename?, How come when I open a file read-write it wipes it out?, Why do | |
b38f6a39 GS |
164 | I sometimes get an "Argument list too long" when I use <*>?, Is there a |
165 | leak/bug in glob()?, How can I open a file with a leading ">" or trailing | |
166 | blanks?, How can I reliably rename a file?, How can I lock a file?, Why | |
167 | can't I just open(FH, ">file.lock")?, I still don't get locking. I just | |
168 | want to increment the number in the file. How can I do this?, How do I | |
169 | randomly update a binary file?, How do I get a file's timestamp in perl?, | |
170 | How do I set a file's timestamp in perl?, How do I print to more than one | |
171 | file at once?, How can I read in an entire file all at once?, How can I | |
172 | read in a file by paragraphs?, How can I read a single character from a | |
173 | file? From the keyboard?, How can I tell whether there's a character | |
14218588 GS |
174 | waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup() |
175 | a filehandle in Perl?, How do I close a file descriptor by number?, Why | |
176 | can't I use "C:\temp\foo" in DOS paths? What doesn't `C:\temp\foo.exe` | |
177 | work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me | |
178 | delete read-only files? Why does C<-i> clobber protected files? Isn't | |
179 | this a bug in Perl?, How do I select a random line from a file?, Why do I | |
180 | get weird spaces when I print an array of lines?, L<perlfaq6>: Regexps, How | |
181 | can I hope to use regular expressions without creating illegible and | |
182 | unmaintainable code?, I'm having trouble matching over more than one line. | |
183 | What's wrong?, How can I pull out lines between two patterns that are | |
184 | themselves on different lines?, I put a regular expression into $/ but it | |
185 | didn't work. What's wrong?, How do I substitute case insensitively on the | |
d420ca49 | 186 | LHS while preserving case on the RHS?, How can I make C<\w> match national |
14218588 GS |
187 | character sets?, How can I match a locale-smart version of C</[a-zA-Z]/>?, |
188 | How can I quote a variable to use in a regex?, What is C</o> really for?, | |
189 | How do I use a regular expression to strip C style comments from a file?, | |
190 | Can I use Perl regular expressions to match balanced text?, What does it | |
191 | mean that regexes are greedy? How can I get around it?, How do I process | |
192 | each word on each line?, How can I print out a word-frequency or | |
193 | line-frequency summary?, How can I do approximate matching?, How do I | |
194 | efficiently match many regular expressions at once?, Why don't | |
195 | word-boundary searches with C<\b> work for me?, Why does using $&, $`, or | |
196 | $' slow my program down?, What good is C<\G> in a regular expression?, Are | |
197 | Perl regexes DFAs or NFAs? Are they POSIX compliant?, What's wrong with | |
198 | using grep or map in a void context?, How can I match strings with | |
199 | multibyte characters?, How do I match a pattern that is supplied by the | |
200 | user?, L<perlfaq7>: General Perl Language Issues, Can I get a BNF/yacc/RE | |
201 | for the Perl language?, What are all these $@%&* punctuation signs, and how | |
202 | do I know when to use them?, Do I always/never have to quote my strings or | |
203 | use semicolons and commas?, How do I skip some return values?, How do I | |
204 | temporarily block warnings?, What's an extension?, Why do Perl operators | |
205 | have different precedence than C operators?, How do I declare/create a | |
206 | structure?, How do I create a module?, How do I create a class?, How can I | |
207 | tell if a variable is tainted?, What's a closure?, What is variable suicide | |
208 | and how can I prevent it?, How can I pass/return a {Function, FileHandle, | |
209 | Array, Hash, Method, Regex}?, How do I create a static variable?, What's | |
210 | the difference between dynamic and lexical (static) scoping? Between | |
211 | local() and my()?, How can I access a dynamic variable while a similarly | |
212 | named lexical is in scope?, What's the difference between deep and shallow | |
b38f6a39 GS |
213 | binding?, Why doesn't "my($foo) = <FILE>;" work right?, How do I redefine a |
214 | builtin function, operator, or method?, What's the difference between | |
215 | calling a function as &foo and foo()?, How do I create a switch or case | |
216 | statement?, How can I catch accesses to undefined | |
14218588 GS |
217 | variables/functions/methods?, Why can't a method included in this same file |
218 | be found?, How can I find out my current package?, How can I comment out a | |
219 | large block of perl code?, How do I clear a package?, How can I use a | |
220 | variable as a variable name?, L<perlfaq8>: System Interaction, How do I | |
221 | find out which operating system I'm running under?, How come exec() doesn't | |
222 | return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I | |
223 | print something out in color?, How do I read just one key without waiting | |
224 | for a return key?, How do I check whether input is ready on the keyboard?, | |
225 | How do I clear the screen?, How do I get the screen size?, How do I ask the | |
226 | user for a password?, How do I read and write the serial port?, How do I | |
227 | decode encrypted password files?, How do I start a process in the | |
228 | background?, How do I trap control characters/signals?, How do I modify the | |
229 | shadow password file on a Unix system?, How do I set the time and date?, | |
230 | How can I sleep() or alarm() for under a second?, How can I measure time | |
231 | under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception | |
d420ca49 | 232 | handling), Why doesn't my sockets program work under System V (Solaris)? |
14218588 GS |
233 | What does the error message "Protocol not supported" mean?, How can I call |
234 | my system's unique C functions from Perl?, Where do I get the include files | |
235 | to do ioctl() or syscall()?, Why do setuid perl scripts complain about | |
236 | kernel problems?, How can I open a pipe both to and from a command?, Why | |
237 | can't I get the output of a command with system()?, How can I capture | |
238 | STDERR from an external command?, Why doesn't open() return an error when a | |
239 | pipe open fails?, What's wrong with using backticks in a void context?, How | |
240 | can I call backticks without shell processing?, Why can't my script read | |
241 | from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I | |
242 | convert my shell script to perl?, Can I use perl to run a telnet or ftp | |
243 | session?, How can I write expect in Perl?, Is there a way to hide perl's | |
244 | command line from programs such as "ps"?, I {changed directory, modified my | |
245 | environment} in a perl script. How come the change disappeared when I | |
246 | exited the script? How do I get my changes to be visible?, How do I close | |
247 | a process's filehandle without waiting for it to complete?, How do I fork a | |
248 | daemon process?, How do I make my program run with sh and csh?, How do I | |
249 | find out if I'm running interactively or not?, How do I timeout a slow | |
250 | event?, How do I set CPU limits?, How do I avoid zombies on a Unix system?, | |
251 | How do I use an SQL database?, How do I make a system() exit on control-C?, | |
252 | How do I open a file without blocking?, How do I install a module from | |
253 | CPAN?, What's the difference between require and use?, How do I keep my own | |
254 | module/library directory?, How do I add the directory my program lives in | |
255 | to the module/library search path?, How do I add a directory to my include | |
256 | path at runtime?, What is socket.ph and where do I get it?, L<perlfaq9>: | |
d420ca49 | 257 | Networking, My CGI script runs from the command line but not the browser. |
14218588 GS |
258 | (500 Server Error), How can I get better error messages from a CGI |
259 | program?, How do I remove HTML from a string?, How do I extract URLs?, How | |
260 | do I download a file from the user's machine? How do I open a file on | |
261 | another machine?, How do I make a pop-up menu in HTML?, How do I fetch an | |
262 | HTML file?, How do I automate an HTML form submission?, How do I decode or | |
263 | create those %-encodings on the web?, How do I redirect to another page?, | |
264 | How do I put a password on my web pages?, How do I edit my .htpasswd and | |
265 | .htgroup files with Perl?, How do I make sure users can't enter values into | |
266 | a form that cause my CGI script to do bad things?, How do I parse a mail | |
267 | header?, How do I decode a CGI form?, How do I check a valid mail address?, | |
268 | How do I decode a MIME/BASE64 string?, How do I return the user's mail | |
269 | address?, How do I send mail?, How do I read mail?, How do I find out my | |
270 | hostname/domainname/IP address?, How do I fetch a news article or the | |
271 | active newsgroups?, How do I fetch/put an FTP file?, How can I do RPC in | |
272 | Perl? | |
68dc0745 | 273 | |
d420ca49 | 274 | =over 4 |
68dc0745 | 275 | |
276 | =item Where to get this document | |
277 | ||
278 | =item How to contribute to this document | |
279 | ||
280 | =item What will happen if you mail your Perl programming problems to the | |
281 | authors | |
282 | ||
283 | =back | |
284 | ||
285 | =item Credits | |
286 | ||
287 | =item Author and Copyright Information | |
288 | ||
d420ca49 | 289 | =over 4 |
68dc0745 | 290 | |
fb9cefb4 | 291 | =item Bundled Distributions |
68dc0745 | 292 | |
293 | =item Disclaimer | |
294 | ||
295 | =back | |
296 | ||
297 | =item Changes | |
298 | ||
d420ca49 AD |
299 | 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, |
300 | 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, | |
301 | Initial Release: 11/March/97 | |
68dc0745 | 302 | |
a45bd81d GS |
303 | =back |
304 | ||
4755096e | 305 | =head2 perltoc - perl documentation table of contents |
68dc0745 | 306 | |
d420ca49 | 307 | =over 4 |
a45bd81d | 308 | |
68dc0745 | 309 | =item DESCRIPTION |
310 | ||
4755096e | 311 | =item BASIC DOCUMENTATION |
68dc0745 | 312 | |
d420ca49 | 313 | =over 4 |
68dc0745 | 314 | |
4755096e | 315 | =item perl - Practical Extraction and Report Language |
68dc0745 | 316 | |
4755096e GS |
317 | SYNOPSIS, DESCRIPTION, AVAILABILITY, ENVIRONMENT, AUTHOR, FILES, SEE ALSO, |
318 | DIAGNOSTICS, BUGS, NOTES | |
68dc0745 | 319 | |
4755096e GS |
320 | =item perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 |
321 | 20:38:02 $) | |
68dc0745 | 322 | |
4755096e | 323 | DESCRIPTION |
68dc0745 | 324 | |
4755096e | 325 | =back |
68dc0745 | 326 | |
4755096e | 327 | =back |
68dc0745 | 328 | |
4755096e | 329 | =head2 perlbook - Perl book information |
68dc0745 | 330 | |
d420ca49 | 331 | =over 4 |
68dc0745 | 332 | |
4755096e | 333 | =item DESCRIPTION |
68dc0745 | 334 | |
a45bd81d GS |
335 | =back |
336 | ||
4755096e | 337 | =head2 perlsyn - Perl syntax |
a45bd81d | 338 | |
d420ca49 | 339 | =over 4 |
68dc0745 | 340 | |
341 | =item DESCRIPTION | |
342 | ||
d420ca49 | 343 | =over 4 |
68dc0745 | 344 | |
4755096e | 345 | =item Declarations |
68dc0745 | 346 | |
4755096e | 347 | =item Simple statements |
68dc0745 | 348 | |
4755096e | 349 | =item Compound statements |
3fe9a6f1 | 350 | |
4755096e | 351 | =item Loop Control |
68dc0745 | 352 | |
4755096e | 353 | =item For Loops |
68dc0745 | 354 | |
4755096e | 355 | =item Foreach Loops |
68dc0745 | 356 | |
4755096e | 357 | =item Basic BLOCKs and Switch Statements |
68dc0745 | 358 | |
4755096e | 359 | =item Goto |
68dc0745 | 360 | |
4755096e | 361 | =item PODs: Embedded Documentation |
68dc0745 | 362 | |
4755096e | 363 | =item Plain Old Comments (Not!) |
68dc0745 | 364 | |
4755096e | 365 | =back |
68dc0745 | 366 | |
4755096e | 367 | =back |
193fb0af | 368 | |
4755096e | 369 | =head2 perldata - Perl data types |
68dc0745 | 370 | |
d420ca49 | 371 | =over 4 |
68dc0745 | 372 | |
4755096e | 373 | =item DESCRIPTION |
68dc0745 | 374 | |
d420ca49 | 375 | =over 4 |
68dc0745 | 376 | |
4755096e | 377 | =item Variable names |
68dc0745 | 378 | |
4755096e | 379 | =item Context |
68dc0745 | 380 | |
4755096e GS |
381 | =item Scalar values |
382 | ||
383 | =item Scalar value constructors | |
384 | ||
385 | =item List value constructors | |
386 | ||
387 | =item Slices | |
388 | ||
389 | =item Typeglobs and Filehandles | |
68dc0745 | 390 | |
391 | =back | |
392 | ||
4755096e | 393 | =item SEE ALSO |
68dc0745 | 394 | |
a45bd81d GS |
395 | =back |
396 | ||
4755096e | 397 | =head2 perlop - Perl operators and precedence |
68dc0745 | 398 | |
d420ca49 | 399 | =over 4 |
a45bd81d | 400 | |
4755096e GS |
401 | =item SYNOPSIS |
402 | ||
68dc0745 | 403 | =item DESCRIPTION |
404 | ||
d420ca49 | 405 | =over 4 |
68dc0745 | 406 | |
4755096e | 407 | =item Terms and List Operators (Leftward) |
68dc0745 | 408 | |
4755096e | 409 | =item The Arrow Operator |
68dc0745 | 410 | |
4755096e | 411 | =item Auto-increment and Auto-decrement |
68dc0745 | 412 | |
4755096e | 413 | =item Exponentiation |
68dc0745 | 414 | |
4755096e | 415 | =item Symbolic Unary Operators |
68dc0745 | 416 | |
4755096e | 417 | =item Binding Operators |
68dc0745 | 418 | |
4755096e | 419 | =item Multiplicative Operators |
68dc0745 | 420 | |
4755096e | 421 | =item Additive Operators |
68dc0745 | 422 | |
4755096e | 423 | =item Shift Operators |
14218588 | 424 | |
4755096e | 425 | =item Named Unary Operators |
68dc0745 | 426 | |
4755096e | 427 | =item Relational Operators |
68dc0745 | 428 | |
4755096e | 429 | =item Equality Operators |
68dc0745 | 430 | |
4755096e | 431 | =item Bitwise And |
68dc0745 | 432 | |
4755096e | 433 | =item Bitwise Or and Exclusive Or |
68dc0745 | 434 | |
4755096e | 435 | =item C-style Logical And |
68dc0745 | 436 | |
4755096e | 437 | =item C-style Logical Or |
68dc0745 | 438 | |
4755096e | 439 | =item Range Operators |
68dc0745 | 440 | |
4755096e | 441 | =item Conditional Operator |
68dc0745 | 442 | |
4755096e | 443 | =item Assignment Operators |
68dc0745 | 444 | |
4755096e | 445 | =item Comma Operator |
68dc0745 | 446 | |
4755096e | 447 | =item List Operators (Rightward) |
68dc0745 | 448 | |
4755096e | 449 | =item Logical Not |
68dc0745 | 450 | |
4755096e | 451 | =item Logical And |
14218588 | 452 | |
4755096e | 453 | =item Logical or and Exclusive Or |
68dc0745 | 454 | |
4755096e | 455 | =item C Operators Missing From Perl |
68dc0745 | 456 | |
4755096e | 457 | unary &, unary *, (TYPE) |
68dc0745 | 458 | |
4755096e | 459 | =item Quote and Quote-like Operators |
68dc0745 | 460 | |
4755096e | 461 | =item Regexp Quote-Like Operators |
68dc0745 | 462 | |
4755096e GS |
463 | ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, |
464 | qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, | |
465 | s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, | |
466 | y/SEARCHLIST/REPLACEMENTLIST/cds | |
68dc0745 | 467 | |
4755096e | 468 | =item Gory details of parsing quoted constructs |
68dc0745 | 469 | |
4755096e GS |
470 | Finding the end, Removal of backslashes before delimiters, Interpolation, |
471 | C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">, | |
472 | C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>, | |
473 | C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of | |
474 | regular expressions | |
68dc0745 | 475 | |
4755096e | 476 | =item I/O Operators |
68dc0745 | 477 | |
4755096e | 478 | =item Constant Folding |
68dc0745 | 479 | |
4755096e GS |
480 | =item Bitwise String Operators |
481 | ||
482 | =item Integer Arithmetic | |
483 | ||
484 | =item Floating-point Arithmetic | |
485 | ||
486 | =item Bigger Numbers | |
68dc0745 | 487 | |
a45bd81d GS |
488 | =back |
489 | ||
4755096e GS |
490 | =back |
491 | ||
c2e66d9e GS |
492 | =head2 perlsub - Perl subroutines |
493 | ||
d420ca49 | 494 | =over 4 |
c2e66d9e GS |
495 | |
496 | =item SYNOPSIS | |
497 | ||
498 | =item DESCRIPTION | |
499 | ||
d420ca49 | 500 | =over 4 |
c2e66d9e GS |
501 | |
502 | =item Private Variables via my() | |
503 | ||
504 | =item Persistent Private Variables | |
505 | ||
506 | =item Temporary Values via local() | |
507 | ||
508 | =item Lvalue subroutines | |
509 | ||
510 | =item Passing Symbol Table Entries (typeglobs) | |
511 | ||
512 | =item When to Still Use local() | |
513 | ||
514 | 1. You need to give a global variable a temporary value, especially $_, 2. | |
515 | You need to create a local file or directory handle or a local function, 3. | |
516 | You want to temporarily change just one element of an array or hash | |
517 | ||
518 | =item Pass by Reference | |
519 | ||
520 | =item Prototypes | |
521 | ||
522 | =item Constant Functions | |
523 | ||
524 | =item Overriding Built-in Functions | |
525 | ||
526 | =item Autoloading | |
527 | ||
528 | =item Subroutine Attributes | |
529 | ||
530 | =back | |
531 | ||
532 | =item SEE ALSO | |
533 | ||
534 | =back | |
535 | ||
536 | =head2 perlfunc - Perl builtin functions | |
537 | ||
d420ca49 | 538 | =over 4 |
c2e66d9e GS |
539 | |
540 | =item DESCRIPTION | |
541 | ||
d420ca49 | 542 | =over 4 |
c2e66d9e GS |
543 | |
544 | =item Perl Functions by Category | |
545 | ||
546 | Functions for SCALARs or strings, Regular expressions and pattern matching, | |
547 | Numeric functions, Functions for real @ARRAYs, Functions for list data, | |
548 | Functions for real %HASHes, Input and output functions, Functions for fixed | |
549 | length data or records, Functions for filehandles, files, or directories, | |
550 | Keywords related to the control flow of your perl program, Keywords related | |
551 | to scoping, Miscellaneous functions, Functions for processes and process | |
552 | groups, Keywords related to perl modules, Keywords related to classes and | |
553 | object-orientedness, Low-level socket functions, System V interprocess | |
554 | communication functions, Fetching user and group info, Fetching network | |
555 | info, Time-related functions, Functions new in perl5, Functions obsoleted | |
556 | in perl5 | |
557 | ||
558 | =item Portability | |
559 | ||
560 | =item Alphabetical Listing of Perl Functions | |
561 | ||
562 | I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept | |
563 | NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, | |
564 | binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME, | |
565 | bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, | |
566 | chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER, | |
567 | chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE, | |
d396a558 | 568 | connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT, |
c2e66d9e GS |
569 | dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete |
570 | EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, | |
571 | each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST, | |
572 | exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl | |
573 | FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION, | |
574 | fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin, | |
575 | getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam | |
576 | NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname | |
577 | NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr | |
578 | ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, | |
579 | getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, | |
580 | getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent | |
581 | STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, | |
582 | endhostent, endnetent, endprotoent, endservent, getsockname SOCKET, | |
583 | getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, | |
584 | goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, | |
585 | import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl | |
586 | FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST, | |
587 | last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, | |
588 | link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, | |
91e74348 JH |
589 | lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, |
590 | mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, | |
591 | msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : | |
592 | ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open | |
593 | FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir | |
d396a558 JH |
594 | DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package |
595 | NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos | |
596 | SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE | |
597 | FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, | |
598 | q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, | |
599 | quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read | |
91e74348 JH |
600 | FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, |
601 | readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, | |
602 | ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, | |
603 | require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir | |
604 | DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, | |
605 | rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir | |
606 | DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, | |
607 | semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send | |
c2e66d9e GS |
608 | SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority |
609 | WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, | |
610 | shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, | |
611 | shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep | |
612 | EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair | |
613 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, | |
614 | sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, | |
615 | splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split | |
616 | /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, | |
617 | sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, | |
618 | study, sub BLOCK, sub NAME, sub NAME BLOCK, substr | |
619 | EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr | |
620 | EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
621 | FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread | |
622 | FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek | |
623 | FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite | |
624 | FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, | |
625 | syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie | |
626 | VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate | |
627 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, | |
628 | ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack | |
629 | TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST, | |
630 | use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST, | |
631 | values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn | |
632 | LIST, write FILEHANDLE, write EXPR, write, y/// | |
633 | ||
634 | =back | |
635 | ||
636 | =back | |
637 | ||
4755096e | 638 | =head2 perlreftut - Mark's very short tutorial about references |
68dc0745 | 639 | |
d420ca49 | 640 | =over 4 |
a45bd81d | 641 | |
68dc0745 | 642 | =item DESCRIPTION |
643 | ||
4755096e GS |
644 | =item Who Needs Complicated Data Structures? |
645 | ||
646 | =item The Solution | |
647 | ||
648 | =item Syntax | |
68dc0745 | 649 | |
d420ca49 | 650 | =over 4 |
68dc0745 | 651 | |
4755096e | 652 | =item Making References |
46fc3d4c | 653 | |
4755096e | 654 | =item Using References |
68dc0745 | 655 | |
4755096e | 656 | =back |
68dc0745 | 657 | |
4755096e | 658 | =item An Example |
68dc0745 | 659 | |
4755096e | 660 | =item Arrow Rule |
14218588 | 661 | |
4755096e | 662 | =item Solution |
68dc0745 | 663 | |
4755096e | 664 | =item The Rest |
68dc0745 | 665 | |
4755096e | 666 | =item Summary |
68dc0745 | 667 | |
4755096e GS |
668 | =item Credits |
669 | ||
d420ca49 | 670 | =over 4 |
4755096e GS |
671 | |
672 | =item Distribution Conditions | |
68dc0745 | 673 | |
674 | =back | |
675 | ||
4755096e GS |
676 | =back |
677 | ||
678 | =head2 perldsc - Perl Data Structures Cookbook | |
68dc0745 | 679 | |
d420ca49 | 680 | =over 4 |
68dc0745 | 681 | |
4755096e | 682 | =item DESCRIPTION |
68dc0745 | 683 | |
4755096e GS |
684 | arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes, |
685 | more elaborate constructs | |
14218588 | 686 | |
4755096e | 687 | =item REFERENCES |
68dc0745 | 688 | |
4755096e | 689 | =item COMMON MISTAKES |
68dc0745 | 690 | |
4755096e | 691 | =item CAVEAT ON PRECEDENCE |
68dc0745 | 692 | |
4755096e | 693 | =item WHY YOU SHOULD ALWAYS C<use strict> |
14218588 | 694 | |
4755096e | 695 | =item DEBUGGING |
68dc0745 | 696 | |
4755096e | 697 | =item CODE EXAMPLES |
68dc0745 | 698 | |
4755096e | 699 | =item ARRAYS OF ARRAYS |
68dc0745 | 700 | |
d420ca49 | 701 | =over 4 |
68dc0745 | 702 | |
4755096e | 703 | =item Declaration of a ARRAY OF ARRAYS |
68dc0745 | 704 | |
4755096e | 705 | =item Generation of a ARRAY OF ARRAYS |
68dc0745 | 706 | |
4755096e | 707 | =item Access and Printing of a ARRAY OF ARRAYS |
68dc0745 | 708 | |
4755096e | 709 | =back |
68dc0745 | 710 | |
4755096e | 711 | =item HASHES OF ARRAYS |
68dc0745 | 712 | |
d420ca49 | 713 | =over 4 |
68dc0745 | 714 | |
4755096e | 715 | =item Declaration of a HASH OF ARRAYS |
68dc0745 | 716 | |
4755096e | 717 | =item Generation of a HASH OF ARRAYS |
68dc0745 | 718 | |
4755096e | 719 | =item Access and Printing of a HASH OF ARRAYS |
68dc0745 | 720 | |
4755096e | 721 | =back |
68dc0745 | 722 | |
4755096e | 723 | =item ARRAYS OF HASHES |
68dc0745 | 724 | |
d420ca49 | 725 | =over 4 |
68dc0745 | 726 | |
4755096e | 727 | =item Declaration of a ARRAY OF HASHES |
68dc0745 | 728 | |
4755096e | 729 | =item Generation of a ARRAY OF HASHES |
68dc0745 | 730 | |
4755096e | 731 | =item Access and Printing of a ARRAY OF HASHES |
14218588 | 732 | |
4755096e | 733 | =back |
68dc0745 | 734 | |
4755096e | 735 | =item HASHES OF HASHES |
68dc0745 | 736 | |
d420ca49 | 737 | =over 4 |
68dc0745 | 738 | |
4755096e | 739 | =item Declaration of a HASH OF HASHES |
68dc0745 | 740 | |
4755096e | 741 | =item Generation of a HASH OF HASHES |
68dc0745 | 742 | |
4755096e | 743 | =item Access and Printing of a HASH OF HASHES |
68dc0745 | 744 | |
745 | =back | |
746 | ||
4755096e | 747 | =item MORE ELABORATE RECORDS |
68dc0745 | 748 | |
d420ca49 | 749 | =over 4 |
68dc0745 | 750 | |
4755096e | 751 | =item Declaration of MORE ELABORATE RECORDS |
14218588 | 752 | |
4755096e | 753 | =item Declaration of a HASH OF COMPLEX RECORDS |
68dc0745 | 754 | |
4755096e | 755 | =item Generation of a HASH OF COMPLEX RECORDS |
68dc0745 | 756 | |
4755096e | 757 | =back |
68dc0745 | 758 | |
4755096e | 759 | =item Database Ties |
68dc0745 | 760 | |
4755096e | 761 | =item SEE ALSO |
68dc0745 | 762 | |
4755096e | 763 | =item AUTHOR |
14218588 | 764 | |
4755096e | 765 | =back |
68dc0745 | 766 | |
4755096e | 767 | =head2 perlrequick - Perl regular expressions quick start |
68dc0745 | 768 | |
d420ca49 | 769 | =over 4 |
68dc0745 | 770 | |
4755096e | 771 | =item DESCRIPTION |
68dc0745 | 772 | |
4755096e | 773 | =item The Guide |
68dc0745 | 774 | |
d420ca49 | 775 | =over 4 |
68dc0745 | 776 | |
4755096e | 777 | =item Simple word matching |
68dc0745 | 778 | |
4755096e | 779 | =item Using character classes |
68dc0745 | 780 | |
4755096e GS |
781 | \d is a digit and represents [0-9], \s is a whitespace character and |
782 | represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and | |
783 | represents [0-9a-zA-Z_], \D is a negated \d; it represents any character | |
784 | but a digit [^0-9], \S is a negated \s; it represents any non-whitespace | |
785 | character [^\s], \W is a negated \w; it represents any non-word character | |
786 | [^\w], The period '.' matches any character but "\n" | |
68dc0745 | 787 | |
4755096e | 788 | =item Matching this or that |
68dc0745 | 789 | |
4755096e | 790 | =item Grouping things and hierarchical matching |
68dc0745 | 791 | |
4755096e | 792 | =item Extracting matches |
68dc0745 | 793 | |
4755096e | 794 | =item Matching repetitions |
68dc0745 | 795 | |
4755096e GS |
796 | C<a?> = match 'a' 1 or 0 times, C<a*> = match 'a' 0 or more times, i.e., |
797 | any number of times, C<a+> = match 'a' 1 or more times, i.e., at least | |
798 | once, C<a{n,m}> = match at least C<n> times, but not more than C<m> times, | |
799 | C<a{n,}> = match at least C<n> or more times, C<a{n}> = match exactly C<n> | |
800 | times | |
68dc0745 | 801 | |
4755096e | 802 | =item More matching |
68dc0745 | 803 | |
4755096e | 804 | =item Search and replace |
68dc0745 | 805 | |
4755096e | 806 | =item The split operator |
68dc0745 | 807 | |
808 | =back | |
809 | ||
4755096e | 810 | =item BUGS |
68dc0745 | 811 | |
4755096e | 812 | =item SEE ALSO |
68dc0745 | 813 | |
4755096e | 814 | =item AUTHOR AND COPYRIGHT |
68dc0745 | 815 | |
d420ca49 | 816 | =over 4 |
68dc0745 | 817 | |
4755096e | 818 | =item Acknowledgments |
14218588 | 819 | |
68dc0745 | 820 | =back |
821 | ||
a45bd81d GS |
822 | =back |
823 | ||
c2e66d9e | 824 | =head2 perlpod - plain old documentation |
68dc0745 | 825 | |
d420ca49 | 826 | =over 4 |
a45bd81d | 827 | |
68dc0745 | 828 | =item DESCRIPTION |
829 | ||
d420ca49 | 830 | =over 4 |
68dc0745 | 831 | |
c2e66d9e | 832 | =item Verbatim Paragraph |
68dc0745 | 833 | |
c2e66d9e | 834 | =item Command Paragraph |
68dc0745 | 835 | |
c2e66d9e | 836 | =item Ordinary Block of Text |
68dc0745 | 837 | |
c2e66d9e | 838 | =item The Intent |
68dc0745 | 839 | |
c2e66d9e | 840 | =item Embedding Pods in Perl Modules |
68dc0745 | 841 | |
c2e66d9e | 842 | =item Common Pod Pitfalls |
193fb0af | 843 | |
c2e66d9e | 844 | =back |
68dc0745 | 845 | |
c2e66d9e | 846 | =item SEE ALSO |
68dc0745 | 847 | |
c2e66d9e | 848 | =item AUTHOR |
68dc0745 | 849 | |
c2e66d9e | 850 | =back |
68dc0745 | 851 | |
c2e66d9e | 852 | =head2 perlstyle - Perl style guide |
68dc0745 | 853 | |
d420ca49 | 854 | =over 4 |
c2e66d9e GS |
855 | |
856 | =item DESCRIPTION | |
68dc0745 | 857 | |
4755096e | 858 | =back |
68dc0745 | 859 | |
c2e66d9e | 860 | =head2 perltrap - Perl traps for the unwary |
68dc0745 | 861 | |
d420ca49 | 862 | =over 4 |
68dc0745 | 863 | |
c2e66d9e | 864 | =item DESCRIPTION |
68dc0745 | 865 | |
d420ca49 | 866 | =over 4 |
68dc0745 | 867 | |
c2e66d9e | 868 | =item Awk Traps |
68dc0745 | 869 | |
c2e66d9e | 870 | =item C Traps |
4755096e | 871 | |
c2e66d9e | 872 | =item Sed Traps |
4755096e | 873 | |
c2e66d9e | 874 | =item Shell Traps |
4755096e | 875 | |
c2e66d9e | 876 | =item Perl Traps |
68dc0745 | 877 | |
c2e66d9e | 878 | =item Perl4 to Perl5 Traps |
68dc0745 | 879 | |
c2e66d9e GS |
880 | Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical |
881 | Traps, General data type traps, Context Traps - scalar, list contexts, | |
882 | Precedence Traps, General Regular Expression Traps using s///, etc, | |
883 | Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps | |
884 | ||
885 | =item Discontinuance, Deprecation, and BugFix traps | |
886 | ||
887 | Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance, | |
888 | Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix, | |
889 | Discontinuance, Deprecation, Discontinuance, Discontinuance | |
890 | ||
891 | =item Parsing Traps | |
892 | ||
893 | Parsing, Parsing, Parsing, Parsing | |
894 | ||
895 | =item Numerical Traps | |
896 | ||
897 | Numerical, Numerical, Numerical, Bitwise string ops | |
898 | ||
899 | =item General data type traps | |
900 | ||
901 | (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String), | |
902 | (Constants), (Scalars), (Variable Suicide) | |
903 | ||
904 | =item Context Traps - scalar, list contexts | |
905 | ||
906 | (list context), (scalar context), (scalar context), (list, builtin) | |
907 | ||
908 | =item Precedence Traps | |
909 | ||
910 | Precedence, Precedence, Precedence, Precedence, Precedence, Precedence, | |
911 | Precedence | |
912 | ||
913 | =item General Regular Expression Traps using s///, etc. | |
914 | ||
915 | Regular Expression, Regular Expression, Regular Expression, Regular | |
916 | Expression, Regular Expression, Regular Expression, Regular Expression, | |
917 | Regular Expression | |
918 | ||
919 | =item Subroutine, Signal, Sorting Traps | |
920 | ||
921 | (Signals), (Sort Subroutine), warn() won't let you specify a filehandle | |
922 | ||
923 | =item OS Traps | |
924 | ||
925 | (SysV), (SysV) | |
926 | ||
927 | =item Interpolation Traps | |
928 | ||
929 | Interpolation, Interpolation, Interpolation, Interpolation, Interpolation, | |
930 | Interpolation, Interpolation, Interpolation, Interpolation | |
931 | ||
932 | =item DBM Traps | |
933 | ||
934 | DBM, DBM | |
935 | ||
936 | =item Unclassified Traps | |
937 | ||
938 | C<require>/C<do> trap using returned value, C<split> on empty string with | |
939 | LIMIT specified | |
68dc0745 | 940 | |
4755096e | 941 | =back |
68dc0745 | 942 | |
c2e66d9e | 943 | =back |
14218588 | 944 | |
c2e66d9e | 945 | =head2 perlrun - how to execute the Perl interpreter |
68dc0745 | 946 | |
d420ca49 | 947 | =over 4 |
c2e66d9e GS |
948 | |
949 | =item SYNOPSIS | |
950 | ||
951 | =item DESCRIPTION | |
68dc0745 | 952 | |
d420ca49 | 953 | =over 4 |
68dc0745 | 954 | |
c2e66d9e GS |
955 | =item #! and quoting on non-Unix systems |
956 | ||
957 | OS/2, MS-DOS, Win95/NT, Macintosh, VMS | |
958 | ||
959 | =item Location of Perl | |
960 | ||
961 | =item Command Switches | |
962 | ||
91e74348 | 963 | B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, |
c2e66d9e GS |
964 | B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, |
965 | B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>], | |
966 | B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>, | |
967 | B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, | |
968 | B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>, | |
969 | B<-x> I<directory> | |
68dc0745 | 970 | |
4755096e | 971 | =back |
68dc0745 | 972 | |
c2e66d9e GS |
973 | =item ENVIRONMENT |
974 | ||
975 | HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL | |
976 | (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL, | |
977 | PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port) | |
978 | ||
979 | =back | |
980 | ||
981 | =head2 perldiag - various Perl diagnostics | |
982 | ||
d420ca49 | 983 | =over 4 |
c2e66d9e GS |
984 | |
985 | =item DESCRIPTION | |
986 | ||
4755096e | 987 | =back |
68dc0745 | 988 | |
4755096e | 989 | =head2 perllexwarn - Perl Lexical Warnings |
68dc0745 | 990 | |
d420ca49 | 991 | =over 4 |
68dc0745 | 992 | |
4755096e | 993 | =item DESCRIPTION |
68dc0745 | 994 | |
d420ca49 | 995 | =over 4 |
68dc0745 | 996 | |
4755096e | 997 | =item Default Warnings and Optional Warnings |
14218588 | 998 | |
4755096e | 999 | =item What's wrong with B<-w> and C<$^W> |
68dc0745 | 1000 | |
4755096e | 1001 | =item Controlling Warnings from the Command Line |
68dc0745 | 1002 | |
4755096e | 1003 | B<-w>, B<-W>, B<-X> |
a45bd81d | 1004 | |
4755096e | 1005 | =item Backward Compatibility |
68dc0745 | 1006 | |
4755096e | 1007 | =item Category Hierarchy |
a45bd81d | 1008 | |
4755096e | 1009 | =item Fatal Warnings |
68dc0745 | 1010 | |
4755096e | 1011 | =item Reporting Warnings from a Module |
68dc0745 | 1012 | |
4755096e | 1013 | =back |
68dc0745 | 1014 | |
4755096e | 1015 | =item TODO |
68dc0745 | 1016 | |
4755096e | 1017 | =item SEE ALSO |
68dc0745 | 1018 | |
4755096e | 1019 | =item AUTHOR |
68dc0745 | 1020 | |
4755096e | 1021 | =back |
68dc0745 | 1022 | |
10862624 RF |
1023 | =head2 perldebtut - Perl debugging tutorial |
1024 | ||
d420ca49 | 1025 | =over 4 |
10862624 RF |
1026 | |
1027 | =item DESCRIPTION | |
1028 | ||
1029 | =item use strict | |
1030 | ||
d396a558 JH |
1031 | =item Looking at data and -w and w |
1032 | ||
1033 | =item help | |
10862624 RF |
1034 | |
1035 | =item Stepping through code | |
1036 | ||
1037 | =item Placeholder for a, w, t, T | |
1038 | ||
d396a558 | 1039 | =item REGULAR EXPRESSIONS |
10862624 | 1040 | |
d396a558 | 1041 | =item OUTPUT TIPS |
10862624 RF |
1042 | |
1043 | =item CGI | |
1044 | ||
1045 | =item GUIs | |
1046 | ||
d396a558 | 1047 | =item SUMMARY |
10862624 RF |
1048 | |
1049 | =item SEE ALSO | |
1050 | ||
1051 | =item AUTHOR | |
1052 | ||
1053 | =item CONTRIBUTORS | |
1054 | ||
1055 | =back | |
1056 | ||
4755096e | 1057 | =head2 perldebug - Perl debugging |
68dc0745 | 1058 | |
d420ca49 | 1059 | =over 4 |
68dc0745 | 1060 | |
4755096e | 1061 | =item DESCRIPTION |
68dc0745 | 1062 | |
4755096e | 1063 | =item The Perl Debugger |
68dc0745 | 1064 | |
d420ca49 | 1065 | =over 4 |
68dc0745 | 1066 | |
4755096e | 1067 | =item Debugger Commands |
68dc0745 | 1068 | |
4755096e GS |
1069 | h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n |
1070 | [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname, | |
1071 | -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr, | |
1072 | b [line] [condition], b subname [condition], b postpone subname | |
1073 | [condition], b load filename, b compile subname, d [line], D, a [line] | |
1074 | command, a [line], A, W expr, W, O booloption .., O anyoption? .., O | |
1075 | option=value .., < ?, < [ command ], << command, > ?, > command, >> | |
1076 | command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !! | |
1077 | cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage] | |
68dc0745 | 1078 | |
4755096e | 1079 | =item Configurable Options |
68dc0745 | 1080 | |
4755096e GS |
1081 | C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, |
1082 | C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, | |
1083 | C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>, | |
1084 | C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>, | |
1085 | C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>, | |
1086 | C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop> | |
68dc0745 | 1087 | |
4755096e | 1088 | =item Debugger input/output |
68dc0745 | 1089 | |
4755096e GS |
1090 | Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame |
1091 | listing | |
68dc0745 | 1092 | |
4755096e | 1093 | =item Debugging compile-time statements |
68dc0745 | 1094 | |
4755096e | 1095 | =item Debugger Customization |
68dc0745 | 1096 | |
4755096e | 1097 | =item Readline Support |
68dc0745 | 1098 | |
4755096e | 1099 | =item Editor Support for Debugging |
68dc0745 | 1100 | |
4755096e | 1101 | =item The Perl Profiler |
68dc0745 | 1102 | |
4755096e | 1103 | =back |
68dc0745 | 1104 | |
4755096e | 1105 | =item Debugging regular expressions |
68dc0745 | 1106 | |
4755096e | 1107 | =item Debugging memory usage |
14218588 | 1108 | |
4755096e | 1109 | =item SEE ALSO |
68dc0745 | 1110 | |
4755096e | 1111 | =item BUGS |
68dc0745 | 1112 | |
a45bd81d GS |
1113 | =back |
1114 | ||
c2e66d9e | 1115 | =head2 perlvar - Perl predefined variables |
68dc0745 | 1116 | |
d420ca49 | 1117 | =over 4 |
a45bd81d | 1118 | |
68dc0745 | 1119 | =item DESCRIPTION |
1120 | ||
d420ca49 | 1121 | =over 4 |
68dc0745 | 1122 | |
c2e66d9e | 1123 | =item Predefined Names |
68dc0745 | 1124 | |
c2e66d9e GS |
1125 | $ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', |
1126 | $LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, | |
1127 | input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, | |
1128 | input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, | |
1129 | autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE | |
1130 | EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE | |
1131 | EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $", | |
1132 | $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE | |
1133 | EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR, | |
1134 | $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR, | |
1135 | $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, @-, C<$`> is the same as | |
1136 | C<substr($var, 0, $-[0])>, C<$&> is the same as C<substr($var, $-[0], $+[0] | |
1137 | - $-[0])>, C<$'> is the same as C<substr($var, $+[0])>, C<$1> is the same | |
1138 | as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> is the same as | |
1139 | C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as C<substr $var, | |
1140 | $-[3], $+[3] - $-[3])>, format_name HANDLE EXPR, $FORMAT_NAME, $~, | |
1141 | format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^, | |
1142 | format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS, | |
1143 | $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, | |
1144 | $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, | |
1145 | $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, | |
1146 | $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(, | |
1147 | $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, | |
1148 | $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, | |
1149 | $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, | |
1150 | 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, | |
1151 | $BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, | |
1152 | ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, | |
1153 | %ENV, $ENV{expr}, %SIG, $SIG{expr} | |
68dc0745 | 1154 | |
c2e66d9e | 1155 | =item Error Indicators |
68dc0745 | 1156 | |
c2e66d9e | 1157 | =item Technical Note on the Syntax of Variable Names |
4755096e | 1158 | |
c2e66d9e GS |
1159 | =back |
1160 | ||
1161 | =item BUGS | |
4755096e GS |
1162 | |
1163 | =back | |
1164 | ||
c2e66d9e | 1165 | =head2 perllol - Manipulating Arrays of Arrays in Perl |
4755096e | 1166 | |
d420ca49 | 1167 | =over 4 |
c2e66d9e GS |
1168 | |
1169 | =item DESCRIPTION | |
1170 | ||
1171 | =item Declaration and Access of Arrays of Arrays | |
1172 | ||
1173 | =item Growing Your Own | |
1174 | ||
1175 | =item Access and Printing | |
1176 | ||
1177 | =item Slices | |
1178 | ||
1179 | =item SEE ALSO | |
1180 | ||
1181 | =item AUTHOR | |
4755096e GS |
1182 | |
1183 | =back | |
1184 | ||
c2e66d9e | 1185 | =head2 perlopentut - tutorial on opening things in Perl |
4755096e | 1186 | |
d420ca49 | 1187 | =over 4 |
4755096e GS |
1188 | |
1189 | =item DESCRIPTION | |
1190 | ||
c2e66d9e GS |
1191 | =item Open E<agrave> la shell |
1192 | ||
d420ca49 | 1193 | =over 4 |
4755096e | 1194 | |
c2e66d9e | 1195 | =item Simple Opens |
4755096e | 1196 | |
c2e66d9e | 1197 | =item Pipe Opens |
4755096e | 1198 | |
c2e66d9e | 1199 | =item The Minus File |
4755096e | 1200 | |
c2e66d9e | 1201 | =item Mixing Reads and Writes |
4755096e GS |
1202 | |
1203 | =item Filters | |
1204 | ||
1205 | =back | |
1206 | ||
1207 | =item Open E<agrave> la C | |
1208 | ||
d420ca49 | 1209 | =over 4 |
4755096e GS |
1210 | |
1211 | =item Permissions E<agrave> la mode | |
1212 | ||
1213 | =back | |
1214 | ||
1215 | =item Obscure Open Tricks | |
1216 | ||
d420ca49 | 1217 | =over 4 |
4755096e GS |
1218 | |
1219 | =item Re-Opening Files (dups) | |
1220 | ||
1221 | =item Dispelling the Dweomer | |
1222 | ||
1223 | =item Paths as Opens | |
1224 | ||
1225 | =item Single Argument Open | |
1226 | ||
1227 | =item Playing with STDIN and STDOUT | |
1228 | ||
1229 | =back | |
1230 | ||
1231 | =item Other I/O Issues | |
1232 | ||
d420ca49 | 1233 | =over 4 |
4755096e GS |
1234 | |
1235 | =item Opening Non-File Files | |
1236 | ||
1237 | =item Binary Files | |
1238 | ||
1239 | =item File Locking | |
1240 | ||
1241 | =back | |
1242 | ||
1243 | =item SEE ALSO | |
1244 | ||
1245 | =item AUTHOR and COPYRIGHT | |
1246 | ||
1247 | =item HISTORY | |
1248 | ||
1249 | =back | |
1250 | ||
c2e66d9e | 1251 | =head2 perlretut - Perl regular expressions tutorial |
4755096e | 1252 | |
d420ca49 | 1253 | =over 4 |
4755096e GS |
1254 | |
1255 | =item DESCRIPTION | |
1256 | ||
c2e66d9e | 1257 | =item Part 1: The basics |
4755096e | 1258 | |
d420ca49 | 1259 | =over 4 |
4755096e | 1260 | |
c2e66d9e | 1261 | =item Simple word matching |
4755096e | 1262 | |
c2e66d9e | 1263 | =item Using character classes |
4755096e | 1264 | |
c2e66d9e GS |
1265 | \d is a digit and represents [0-9], \s is a whitespace character and |
1266 | represents [\ \t\r\n\f], \w is a word character (alphanumeric or _) and | |
1267 | represents [0-9a-zA-Z_], \D is a negated \d; it represents any character | |
1268 | but a digit [^0-9], \S is a negated \s; it represents any non-whitespace | |
1269 | character [^\s], \W is a negated \w; it represents any non-word character | |
1270 | [^\w], The period '.' matches any character but "\n", no modifiers (//): | |
1271 | Default behavior. C<'.'> matches any character except C<"\n">. C<^> | |
1272 | matches only at the beginning of the string and C<$> matches only at the | |
1273 | end or before a newline at the end, s modifier (//s): Treat string as a | |
1274 | single long line. C<'.'> matches any character, even C<"\n">. C<^> | |
1275 | matches only at the beginning of the string and C<$> matches only at the | |
1276 | end or before a newline at the end, m modifier (//m): Treat string as a set | |
1277 | of multiple lines. C<'.'> matches any character except C<"\n">. C<^> and | |
1278 | C<$> are able to match at the start or end of I<any> line within the | |
1279 | string, both s and m modifiers (//sm): Treat string as a single long line, | |
1280 | but detect multiple lines. C<'.'> matches any character, even C<"\n">. | |
1281 | C<^> and C<$>, however, are able to match at the start or end of I<any> | |
1282 | line within the string | |
4755096e | 1283 | |
c2e66d9e | 1284 | =item Matching this or that |
4755096e | 1285 | |
c2e66d9e | 1286 | =item Grouping things and hierarchical matching |
4755096e | 1287 | |
c2e66d9e GS |
1288 | 0 Start with the first letter in the string 'a', 1 Try the first |
1289 | alternative in the first group 'abd', 2 Match 'a' followed by 'b'. So far | |
1290 | so good, 3 'd' in the regexp doesn't match 'c' in the string - a dead end. | |
1291 | So backtrack two characters and pick the second alternative in the first | |
1292 | group 'abc', 4 Match 'a' followed by 'b' followed by 'c'. We are on a roll | |
1293 | and have satisfied the first group. Set $1 to 'abc', 5 Move on to the | |
1294 | second group and pick the first alternative 'df', 6 Match the 'd', 7 'f' in | |
1295 | the regexp doesn't match 'e' in the string, so a dead end. Backtrack one | |
1296 | character and pick the second alternative in the second group 'd', 8 'd' | |
1297 | matches. The second grouping is satisfied, so set $2 to 'd', 9 We are at | |
1298 | the end of the regexp, so we are done! We have matched 'abcd' out of the | |
1299 | string "abcde" | |
4755096e | 1300 | |
c2e66d9e | 1301 | =item Extracting matches |
4755096e | 1302 | |
c2e66d9e | 1303 | =item Matching repetitions |
4755096e | 1304 | |
c2e66d9e GS |
1305 | C<a?> = match 'a' 1 or 0 times, C<a*> = match 'a' 0 or more times, i.e., |
1306 | any number of times, C<a+> = match 'a' 1 or more times, i.e., at least | |
1307 | once, C<a{n,m}> = match at least C<n> times, but not more than C<m> times, | |
1308 | C<a{n,}> = match at least C<n> or more times, C<a{n}> = match exactly C<n> | |
1309 | times, Principle 0: Taken as a whole, any regexp will be matched at the | |
1310 | earliest possible position in the string, Principle 1: In an alternation | |
1311 | C<a|b|c...>, the leftmost alternative that allows a match for the whole | |
1312 | regexp will be the one used, Principle 2: The maximal matching quantifiers | |
1313 | C<?>, C<*>, C<+> and C<{n,m}> will in general match as much of the string | |
1314 | as possible while still allowing the whole regexp to match, Principle 3: If | |
1315 | there are two or more elements in a regexp, the leftmost greedy quantifier, | |
1316 | if any, will match as much of the string as possible while still allowing | |
1317 | the whole regexp to match. The next leftmost greedy quantifier, if any, | |
1318 | will try to match as much of the string remaining available to it as | |
1319 | possible, while still allowing the whole regexp to match. And so on, until | |
1320 | all the regexp elements are satisfied, C<a??> = match 'a' 0 or 1 times. Try | |
1321 | 0 first, then 1, C<a*?> = match 'a' 0 or more times, i.e., any number of | |
1322 | times, but as few times as possible, C<a+?> = match 'a' 1 or more times, | |
1323 | i.e., at least once, but as few times as possible, C<a{n,m}?> = match at | |
1324 | least C<n> times, not more than C<m> times, as few times as possible, | |
1325 | C<a{n,}?> = match at least C<n> times, but as few times as possible, | |
1326 | C<a{n}?> = match exactly C<n> times. Because we match exactly C<n> times, | |
1327 | C<a{n}?> is equivalent to C<a{n}> and is just there for notational | |
1328 | consistency, Principle 3: If there are two or more elements in a regexp, | |
1329 | the leftmost greedy (non-greedy) quantifier, if any, will match as much | |
1330 | (little) of the string as possible while still allowing the whole regexp to | |
1331 | match. The next leftmost greedy (non-greedy) quantifier, if any, will try | |
1332 | to match as much (little) of the string remaining available to it as | |
1333 | possible, while still allowing the whole regexp to match. And so on, until | |
1334 | all the regexp elements are satisfied, 0 Start with the first letter in the | |
1335 | string 't', 1 The first quantifier '.*' starts out by matching the whole | |
1336 | string 'the cat in the hat', 2 'a' in the regexp element 'at' doesn't match | |
1337 | the end of the string. Backtrack one character, 3 'a' in the regexp | |
1338 | element 'at' still doesn't match the last letter of the string 't', so | |
1339 | backtrack one more character, 4 Now we can match the 'a' and the 't', 5 | |
1340 | Move on to the third element '.*'. Since we are at the end of the string | |
1341 | and '.*' can match 0 times, assign it the empty string, 6 We are done! | |
4755096e | 1342 | |
c2e66d9e | 1343 | =item Building a regexp |
4755096e | 1344 | |
c2e66d9e GS |
1345 | specifying the task in detail,, breaking down the problem into smaller |
1346 | parts,, translating the small parts into regexps,, combining the regexps,, | |
1347 | and optimizing the final combined regexp | |
4755096e | 1348 | |
c2e66d9e | 1349 | =item Using regular expressions in Perl |
4755096e | 1350 | |
c2e66d9e | 1351 | =back |
4755096e | 1352 | |
c2e66d9e | 1353 | =item Part 2: Power tools |
4755096e | 1354 | |
d420ca49 | 1355 | =over 4 |
4755096e | 1356 | |
c2e66d9e | 1357 | =item More on characters, strings, and character classes |
4755096e | 1358 | |
c2e66d9e | 1359 | =item Compiling and saving regular expressions |
4755096e | 1360 | |
c2e66d9e | 1361 | =item Embedding comments and modifiers in a regular expression |
4755096e | 1362 | |
c2e66d9e | 1363 | =item Non-capturing groupings |
4755096e | 1364 | |
c2e66d9e | 1365 | =item Looking ahead and looking behind |
4755096e | 1366 | |
c2e66d9e | 1367 | =item Using independent subexpressions to prevent backtracking |
4755096e | 1368 | |
c2e66d9e | 1369 | =item Conditional expressions |
4755096e | 1370 | |
c2e66d9e | 1371 | =item A bit of magic: executing Perl code in a regular expression |
4755096e | 1372 | |
c2e66d9e | 1373 | =item Pragmas and debugging |
4755096e GS |
1374 | |
1375 | =back | |
1376 | ||
c2e66d9e | 1377 | =item BUGS |
4755096e | 1378 | |
c2e66d9e | 1379 | =item SEE ALSO |
4755096e | 1380 | |
c2e66d9e | 1381 | =item AUTHOR AND COPYRIGHT |
4755096e | 1382 | |
d420ca49 | 1383 | =over 4 |
4755096e | 1384 | |
c2e66d9e | 1385 | =item Acknowledgments |
4755096e GS |
1386 | |
1387 | =back | |
1388 | ||
4755096e GS |
1389 | =back |
1390 | ||
c2e66d9e | 1391 | =head2 perlre - Perl regular expressions |
4755096e | 1392 | |
d420ca49 | 1393 | =over 4 |
4755096e GS |
1394 | |
1395 | =item DESCRIPTION | |
1396 | ||
c2e66d9e | 1397 | i, m, s, x |
4755096e | 1398 | |
d420ca49 | 1399 | =over 4 |
4755096e | 1400 | |
c2e66d9e | 1401 | =item Regular Expressions |
4755096e | 1402 | |
c2e66d9e | 1403 | cntrl, graph, print, punct, xdigit |
4755096e | 1404 | |
c2e66d9e | 1405 | =item Extended Patterns |
4755096e | 1406 | |
c2e66d9e GS |
1407 | C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, |
1408 | C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{ | |
1409 | code })>, C<(??{ code })>, C<< (?>pattern) >>, | |
1410 | C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)> | |
4755096e | 1411 | |
c2e66d9e | 1412 | =item Backtracking |
4755096e | 1413 | |
c2e66d9e | 1414 | =item Version 8 Regular Expressions |
4755096e | 1415 | |
c2e66d9e | 1416 | =item Warning on \1 vs $1 |
4755096e | 1417 | |
c2e66d9e GS |
1418 | =item Repeated patterns matching zero-length substring |
1419 | ||
1420 | =item Combining pieces together | |
1421 | ||
1422 | C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>, | |
1423 | C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>, | |
1424 | C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, | |
1425 | C<(?(condition)yes-pattern|no-pattern)> | |
1426 | ||
1427 | =item Creating custom RE engines | |
4755096e GS |
1428 | |
1429 | =back | |
1430 | ||
c2e66d9e | 1431 | =item BUGS |
4755096e | 1432 | |
c2e66d9e | 1433 | =item SEE ALSO |
4755096e | 1434 | |
c2e66d9e GS |
1435 | =back |
1436 | ||
d396a558 JH |
1437 | =head2 perlref - Perl references and nested data structures |
1438 | ||
d420ca49 | 1439 | =over 4 |
d396a558 JH |
1440 | |
1441 | =item NOTE | |
1442 | ||
1443 | =item DESCRIPTION | |
1444 | ||
d420ca49 | 1445 | =over 4 |
d396a558 JH |
1446 | |
1447 | =item Making References | |
1448 | ||
1449 | =item Using References | |
1450 | ||
1451 | =item Symbolic references | |
1452 | ||
1453 | =item Not-so-symbolic references | |
1454 | ||
1455 | =item Pseudo-hashes: Using an array as a hash | |
1456 | ||
1457 | =item Function Templates | |
1458 | ||
1459 | =back | |
1460 | ||
1461 | =item WARNING | |
1462 | ||
1463 | =item SEE ALSO | |
1464 | ||
1465 | =back | |
1466 | ||
c2e66d9e | 1467 | =head2 perlform - Perl formats |
4755096e | 1468 | |
d420ca49 | 1469 | =over 4 |
4755096e | 1470 | |
c2e66d9e | 1471 | =item DESCRIPTION |
4755096e | 1472 | |
d420ca49 | 1473 | =over 4 |
4755096e | 1474 | |
c2e66d9e | 1475 | =item Format Variables |
4755096e | 1476 | |
c2e66d9e | 1477 | =back |
4755096e | 1478 | |
c2e66d9e | 1479 | =item NOTES |
4755096e | 1480 | |
d420ca49 | 1481 | =over 4 |
c2e66d9e GS |
1482 | |
1483 | =item Footers | |
1484 | ||
1485 | =item Accessing Formatting Internals | |
4755096e GS |
1486 | |
1487 | =back | |
1488 | ||
c2e66d9e | 1489 | =item WARNINGS |
4755096e GS |
1490 | |
1491 | =back | |
1492 | ||
d396a558 | 1493 | =head2 perlboot - Beginner's Object-Oriented Tutorial |
4755096e | 1494 | |
d420ca49 | 1495 | =over 4 |
4755096e GS |
1496 | |
1497 | =item DESCRIPTION | |
1498 | ||
d420ca49 | 1499 | =over 4 |
c2e66d9e | 1500 | |
d396a558 JH |
1501 | =item If we could talk to the animals... |
1502 | ||
1503 | =item Introducing the method invocation arrow | |
1504 | ||
1505 | =item Invoking a barnyard | |
1506 | ||
1507 | =item The extra parameter of method invocation | |
1508 | ||
1509 | =item Calling a second method to simplify things | |
1510 | ||
1511 | =item Inheriting the windpipes | |
1512 | ||
1513 | =item A few notes about @ISA | |
1514 | ||
1515 | =item Overriding the methods | |
1516 | ||
1517 | =item Starting the search from a different place | |
1518 | ||
1519 | =item The SUPER way of doing things | |
1520 | ||
1521 | =item Where we're at so far... | |
1522 | ||
1523 | =item A horse is a horse, of course of course -- or is it? | |
1524 | ||
1525 | =item Invoking an instance method | |
1526 | ||
1527 | =item Accessing the instance data | |
1528 | ||
1529 | =item How to build a horse | |
1530 | ||
1531 | =item Inheriting the constructor | |
1532 | ||
1533 | =item Making a method work with either classes or instances | |
1534 | ||
1535 | =item Adding parameters to a method | |
1536 | ||
1537 | =item More interesting instances | |
1538 | ||
1539 | =item A horse of a different color | |
1540 | ||
1541 | =item Summary | |
1542 | ||
1543 | =back | |
1544 | ||
1545 | =item SEE ALSO | |
1546 | ||
1547 | =item COPYRIGHT | |
1548 | ||
1549 | =back | |
1550 | ||
1551 | =head2 perltoot - Tom's object-oriented tutorial for perl | |
c2e66d9e | 1552 | |
d420ca49 | 1553 | =over 4 |
4755096e | 1554 | |
d396a558 | 1555 | =item DESCRIPTION |
4755096e | 1556 | |
d396a558 | 1557 | =item Creating a Class |
4755096e | 1558 | |
d420ca49 | 1559 | =over 4 |
4755096e | 1560 | |
d396a558 | 1561 | =item Object Representation |
4755096e | 1562 | |
d396a558 | 1563 | =item Class Interface |
4755096e | 1564 | |
d396a558 | 1565 | =item Constructors and Instance Methods |
c2e66d9e | 1566 | |
d396a558 | 1567 | =item Planning for the Future: Better Constructors |
c2e66d9e | 1568 | |
d396a558 | 1569 | =item Destructors |
c2e66d9e | 1570 | |
d396a558 | 1571 | =item Other Object Methods |
4755096e GS |
1572 | |
1573 | =back | |
1574 | ||
d396a558 | 1575 | =item Class Data |
4755096e | 1576 | |
d420ca49 | 1577 | =over 4 |
4755096e | 1578 | |
d396a558 | 1579 | =item Accessing Class Data |
4755096e | 1580 | |
d396a558 | 1581 | =item Debugging Methods |
4755096e | 1582 | |
d396a558 | 1583 | =item Class Destructors |
4755096e | 1584 | |
d396a558 | 1585 | =item Documenting the Interface |
4755096e | 1586 | |
d396a558 | 1587 | =back |
4755096e | 1588 | |
d396a558 JH |
1589 | =item Aggregation |
1590 | ||
1591 | =item Inheritance | |
1592 | ||
d420ca49 | 1593 | =over 4 |
d396a558 JH |
1594 | |
1595 | =item Overridden Methods | |
1596 | ||
1597 | =item Multiple Inheritance | |
1598 | ||
1599 | =item UNIVERSAL: The Root of All Objects | |
4755096e | 1600 | |
c2e66d9e | 1601 | =back |
4755096e | 1602 | |
d396a558 | 1603 | =item Alternate Object Representations |
4755096e | 1604 | |
d420ca49 | 1605 | =over 4 |
4755096e | 1606 | |
d396a558 | 1607 | =item Arrays as Objects |
4755096e | 1608 | |
d396a558 JH |
1609 | =item Closures as Objects |
1610 | ||
1611 | =back | |
1612 | ||
1613 | =item AUTOLOAD: Proxy Methods | |
1614 | ||
d420ca49 | 1615 | =over 4 |
d396a558 JH |
1616 | |
1617 | =item Autoloaded Data Methods | |
1618 | ||
1619 | =item Inherited Autoloaded Data Methods | |
1620 | ||
1621 | =back | |
1622 | ||
1623 | =item Metaclassical Tools | |
1624 | ||
d420ca49 | 1625 | =over 4 |
d396a558 JH |
1626 | |
1627 | =item Class::Struct | |
1628 | ||
1629 | =item Data Members as Variables | |
4755096e | 1630 | |
d420ca49 AD |
1631 | =back |
1632 | ||
c2e66d9e | 1633 | =item NOTES |
4755096e | 1634 | |
d420ca49 AD |
1635 | =over 4 |
1636 | ||
d396a558 JH |
1637 | =item Object Terminology |
1638 | ||
1639 | =back | |
1640 | ||
1641 | =item SEE ALSO | |
1642 | ||
1643 | =item AUTHOR AND COPYRIGHT | |
1644 | ||
1645 | =item COPYRIGHT | |
1646 | ||
d420ca49 | 1647 | =over 4 |
c2e66d9e | 1648 | |
d396a558 | 1649 | =item Acknowledgments |
c2e66d9e | 1650 | |
d396a558 | 1651 | =back |
c2e66d9e | 1652 | |
d396a558 | 1653 | =back |
c2e66d9e | 1654 | |
d396a558 | 1655 | =head2 perltootc - Tom's OO Tutorial for Class Data in Perl |
c2e66d9e | 1656 | |
d420ca49 | 1657 | =over 4 |
c2e66d9e | 1658 | |
d396a558 | 1659 | =item DESCRIPTION |
c2e66d9e | 1660 | |
d396a558 JH |
1661 | =item Class Data as Package Variables |
1662 | ||
d420ca49 | 1663 | =over 4 |
d396a558 JH |
1664 | |
1665 | =item Putting All Your Eggs in One Basket | |
1666 | ||
1667 | =item Inheritance Concerns | |
1668 | ||
1669 | =item The Eponymous Meta-Object | |
1670 | ||
1671 | =item Indirect References to Class Data | |
1672 | ||
1673 | =item Monadic Classes | |
1674 | ||
1675 | =item Translucent Attributes | |
4755096e GS |
1676 | |
1677 | =back | |
1678 | ||
d396a558 | 1679 | =item Class Data as Lexical Variables |
4755096e | 1680 | |
d420ca49 | 1681 | =over 4 |
4755096e | 1682 | |
d396a558 JH |
1683 | =item Privacy and Responsibility |
1684 | ||
1685 | =item File-Scoped Lexicals | |
1686 | ||
1687 | =item More Inheritance Concerns | |
1688 | ||
1689 | =item Locking the Door and Throwing Away the Key | |
1690 | ||
1691 | =item Translucency Revisited | |
4755096e | 1692 | |
c2e66d9e | 1693 | =back |
4755096e | 1694 | |
d396a558 JH |
1695 | =item NOTES |
1696 | ||
c2e66d9e | 1697 | =item SEE ALSO |
4755096e | 1698 | |
d396a558 JH |
1699 | =item AUTHOR AND COPYRIGHT |
1700 | ||
1701 | =item ACKNOWLEDGEMENTS | |
1702 | ||
c2e66d9e | 1703 | =item HISTORY |
4755096e | 1704 | |
c2e66d9e | 1705 | =back |
4755096e | 1706 | |
d396a558 | 1707 | =head2 perlobj - Perl objects |
4755096e | 1708 | |
d420ca49 | 1709 | =over 4 |
4755096e | 1710 | |
c2e66d9e | 1711 | =item DESCRIPTION |
4755096e | 1712 | |
d420ca49 | 1713 | =over 4 |
4755096e | 1714 | |
d396a558 | 1715 | =item An Object is Simply a Reference |
4755096e | 1716 | |
d396a558 | 1717 | =item A Class is Simply a Package |
4755096e | 1718 | |
d396a558 | 1719 | =item A Method is Simply a Subroutine |
4755096e | 1720 | |
d396a558 | 1721 | =item Method Invocation |
4755096e | 1722 | |
d396a558 JH |
1723 | =item WARNING |
1724 | ||
1725 | =item Default UNIVERSAL methods | |
1726 | ||
1727 | isa(CLASS), can(METHOD), VERSION( [NEED] ) | |
1728 | ||
1729 | =item Destructors | |
1730 | ||
1731 | =item Summary | |
1732 | ||
1733 | =item Two-Phased Garbage Collection | |
4755096e | 1734 | |
c2e66d9e | 1735 | =back |
4755096e | 1736 | |
d396a558 JH |
1737 | =item SEE ALSO |
1738 | ||
1739 | =back | |
1740 | ||
1741 | =head2 perlbot - Bag'o Object Tricks (the BOT) | |
1742 | ||
d420ca49 | 1743 | =over 4 |
d396a558 JH |
1744 | |
1745 | =item DESCRIPTION | |
1746 | ||
1747 | =item OO SCALING TIPS | |
1748 | ||
1749 | =item INSTANCE VARIABLES | |
1750 | ||
1751 | =item SCALAR INSTANCE VARIABLES | |
1752 | ||
1753 | =item INSTANCE VARIABLE INHERITANCE | |
1754 | ||
1755 | =item OBJECT RELATIONSHIPS | |
1756 | ||
1757 | =item OVERRIDING SUPERCLASS METHODS | |
1758 | ||
1759 | =item USING RELATIONSHIP WITH SDBM | |
1760 | ||
1761 | =item THINKING OF CODE REUSE | |
1762 | ||
1763 | =item CLASS CONTEXT AND THE OBJECT | |
1764 | ||
1765 | =item INHERITING A CONSTRUCTOR | |
1766 | ||
1767 | =item DELEGATION | |
1768 | ||
1769 | =back | |
1770 | ||
1771 | =head2 perltie - how to hide an object class in a simple variable | |
1772 | ||
d420ca49 | 1773 | =over 4 |
d396a558 JH |
1774 | |
1775 | =item SYNOPSIS | |
1776 | ||
1777 | =item DESCRIPTION | |
1778 | ||
d420ca49 | 1779 | =over 4 |
d396a558 JH |
1780 | |
1781 | =item Tying Scalars | |
1782 | ||
93d73c42 JH |
1783 | TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this, |
1784 | DESTROY this | |
d396a558 JH |
1785 | |
1786 | =item Tying Arrays | |
1787 | ||
1788 | TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value, | |
93d73c42 | 1789 | UNTIE this, DESTROY this |
d396a558 JH |
1790 | |
1791 | =item Tying Hashes | |
1792 | ||
1793 | USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE | |
1794 | this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY | |
93d73c42 | 1795 | this, NEXTKEY this, lastkey, UNTIE this, DESTROY this |
d396a558 JH |
1796 | |
1797 | =item Tying FileHandles | |
1798 | ||
1799 | TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this, | |
93d73c42 JH |
1800 | LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this, |
1801 | DESTROY this | |
d396a558 | 1802 | |
9fa7f388 JH |
1803 | =item UNTIE this |
1804 | ||
d396a558 JH |
1805 | =item The C<untie> Gotcha |
1806 | ||
1807 | =back | |
4755096e | 1808 | |
c2e66d9e | 1809 | =item SEE ALSO |
4755096e | 1810 | |
d396a558 JH |
1811 | =item BUGS |
1812 | ||
1813 | =item AUTHOR | |
1814 | ||
c2e66d9e | 1815 | =back |
4755096e | 1816 | |
c2e66d9e GS |
1817 | =head2 perlipc - Perl interprocess communication (signals, fifos, pipes, |
1818 | safe subprocesses, sockets, and semaphores) | |
4755096e | 1819 | |
d420ca49 | 1820 | =over 4 |
4755096e | 1821 | |
c2e66d9e | 1822 | =item DESCRIPTION |
4755096e | 1823 | |
c2e66d9e | 1824 | =item Signals |
4755096e | 1825 | |
c2e66d9e | 1826 | =item Named Pipes |
4755096e | 1827 | |
d420ca49 | 1828 | =over 4 |
4755096e | 1829 | |
c2e66d9e | 1830 | =item WARNING |
4755096e | 1831 | |
c2e66d9e | 1832 | =back |
4755096e | 1833 | |
c2e66d9e | 1834 | =item Using open() for IPC |
4755096e | 1835 | |
d420ca49 | 1836 | =over 4 |
4755096e | 1837 | |
c2e66d9e | 1838 | =item Filehandles |
4755096e | 1839 | |
c2e66d9e | 1840 | =item Background Processes |
4755096e | 1841 | |
c2e66d9e | 1842 | =item Complete Dissociation of Child from Parent |
4755096e | 1843 | |
c2e66d9e | 1844 | =item Safe Pipe Opens |
4755096e | 1845 | |
c2e66d9e | 1846 | =item Bidirectional Communication with Another Process |
4755096e | 1847 | |
c2e66d9e | 1848 | =item Bidirectional Communication with Yourself |
4755096e GS |
1849 | |
1850 | =back | |
1851 | ||
c2e66d9e | 1852 | =item Sockets: Client/Server Communication |
4755096e | 1853 | |
d420ca49 | 1854 | =over 4 |
4755096e | 1855 | |
c2e66d9e | 1856 | =item Internet Line Terminators |
4755096e | 1857 | |
c2e66d9e | 1858 | =item Internet TCP Clients and Servers |
4755096e | 1859 | |
c2e66d9e GS |
1860 | =item Unix-Domain TCP Clients and Servers |
1861 | ||
1862 | =back | |
1863 | ||
1864 | =item TCP Clients with IO::Socket | |
4755096e | 1865 | |
d420ca49 | 1866 | =over 4 |
4755096e | 1867 | |
c2e66d9e | 1868 | =item A Simple Client |
4755096e | 1869 | |
c2e66d9e | 1870 | C<Proto>, C<PeerAddr>, C<PeerPort> |
4755096e | 1871 | |
c2e66d9e | 1872 | =item A Webget Client |
4755096e | 1873 | |
c2e66d9e | 1874 | =item Interactive Client with IO::Socket |
4755096e | 1875 | |
c2e66d9e | 1876 | =back |
4755096e | 1877 | |
c2e66d9e | 1878 | =item TCP Servers with IO::Socket |
4755096e | 1879 | |
c2e66d9e | 1880 | Proto, LocalPort, Listen, Reuse |
4755096e | 1881 | |
c2e66d9e | 1882 | =item UDP: Message Passing |
4755096e | 1883 | |
c2e66d9e | 1884 | =item SysV IPC |
4755096e | 1885 | |
c2e66d9e | 1886 | =item NOTES |
4755096e | 1887 | |
c2e66d9e | 1888 | =item BUGS |
4755096e | 1889 | |
c2e66d9e | 1890 | =item AUTHOR |
4755096e | 1891 | |
c2e66d9e | 1892 | =item SEE ALSO |
4755096e GS |
1893 | |
1894 | =back | |
1895 | ||
c2e66d9e | 1896 | =head2 perlfork - Perl's fork() emulation |
4755096e | 1897 | |
d420ca49 | 1898 | =over 4 |
4755096e | 1899 | |
c2e66d9e GS |
1900 | =item SYNOPSIS |
1901 | ||
1902 | =item DESCRIPTION | |
4755096e | 1903 | |
d420ca49 | 1904 | =over 4 |
4755096e | 1905 | |
c2e66d9e | 1906 | =item Behavior of other Perl features in forked pseudo-processes |
4755096e | 1907 | |
c2e66d9e GS |
1908 | $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept |
1909 | filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to | |
1910 | files, directories and network sockets | |
4755096e | 1911 | |
c2e66d9e | 1912 | =item Resource limits |
4755096e | 1913 | |
c2e66d9e | 1914 | =item Killing the parent process |
4755096e | 1915 | |
c2e66d9e | 1916 | =item Lifetime of the parent process and pseudo-processes |
4755096e | 1917 | |
c2e66d9e | 1918 | =item CAVEATS AND LIMITATIONS |
4755096e | 1919 | |
c2e66d9e GS |
1920 | BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented, |
1921 | Global state maintained by XSUBs, Interpreter embedded in larger | |
1922 | application, Thread-safety of extensions | |
4755096e | 1923 | |
c2e66d9e | 1924 | =back |
4755096e | 1925 | |
c2e66d9e GS |
1926 | =item BUGS |
1927 | ||
1928 | =item AUTHOR | |
1929 | ||
1930 | =item SEE ALSO | |
4755096e GS |
1931 | |
1932 | =back | |
1933 | ||
c2e66d9e | 1934 | =head2 perlnumber - semantics of numbers and numeric operations in Perl |
4755096e | 1935 | |
d420ca49 | 1936 | =over 4 |
4755096e | 1937 | |
c2e66d9e | 1938 | =item SYNOPSIS |
4755096e | 1939 | |
c2e66d9e | 1940 | =item DESCRIPTION |
4755096e | 1941 | |
c2e66d9e | 1942 | =item Storing numbers |
4755096e | 1943 | |
c2e66d9e | 1944 | =item Numeric operators and numeric conversions |
4755096e | 1945 | |
c2e66d9e | 1946 | =item Flavors of Perl numeric operations |
4755096e | 1947 | |
c2e66d9e GS |
1948 | Arithmetic operators except, C<no integer>, Arithmetic operators except, |
1949 | C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use | |
1950 | integer>, Operators which expect an integer, Operators which expect a | |
1951 | string | |
4755096e | 1952 | |
c2e66d9e | 1953 | =item AUTHOR |
4755096e | 1954 | |
c2e66d9e | 1955 | =item SEE ALSO |
4755096e GS |
1956 | |
1957 | =back | |
1958 | ||
c2e66d9e | 1959 | =head2 perlthrtut - tutorial on threads in Perl |
4755096e | 1960 | |
d420ca49 | 1961 | =over 4 |
4755096e GS |
1962 | |
1963 | =item DESCRIPTION | |
1964 | ||
c2e66d9e | 1965 | =item What Is A Thread Anyway? |
4755096e | 1966 | |
c2e66d9e | 1967 | =item Threaded Program Models |
4755096e | 1968 | |
d420ca49 | 1969 | =over 4 |
4755096e | 1970 | |
c2e66d9e | 1971 | =item Boss/Worker |
4755096e | 1972 | |
c2e66d9e | 1973 | =item Work Crew |
4755096e | 1974 | |
c2e66d9e | 1975 | =item Pipeline |
4755096e GS |
1976 | |
1977 | =back | |
1978 | ||
c2e66d9e | 1979 | =item Native threads |
4755096e | 1980 | |
c2e66d9e | 1981 | =item What kind of threads are perl threads? |
4755096e | 1982 | |
c2e66d9e | 1983 | =item Threadsafe Modules |
4755096e | 1984 | |
c2e66d9e | 1985 | =item Thread Basics |
4755096e | 1986 | |
d420ca49 | 1987 | =over 4 |
4755096e | 1988 | |
c2e66d9e | 1989 | =item Basic Thread Support |
4755096e | 1990 | |
c2e66d9e | 1991 | =item Creating Threads |
4755096e | 1992 | |
c2e66d9e | 1993 | =item Giving up control |
4755096e | 1994 | |
c2e66d9e | 1995 | =item Waiting For A Thread To Exit |
4755096e | 1996 | |
c2e66d9e | 1997 | =item Errors In Threads |
4755096e | 1998 | |
c2e66d9e | 1999 | =item Ignoring A Thread |
4755096e GS |
2000 | |
2001 | =back | |
2002 | ||
c2e66d9e | 2003 | =item Threads And Data |
4755096e | 2004 | |
d420ca49 | 2005 | =over 4 |
4755096e | 2006 | |
c2e66d9e | 2007 | =item Shared And Unshared Data |
4755096e | 2008 | |
c2e66d9e | 2009 | =item Thread Pitfall: Races |
4755096e | 2010 | |
c2e66d9e | 2011 | =item Controlling access: lock() |
4755096e | 2012 | |
c2e66d9e | 2013 | =item Thread Pitfall: Deadlocks |
4755096e | 2014 | |
c2e66d9e | 2015 | =item Queues: Passing Data Around |
4755096e | 2016 | |
c2e66d9e | 2017 | =back |
4755096e | 2018 | |
c2e66d9e | 2019 | =item Threads And Code |
4755096e | 2020 | |
d420ca49 | 2021 | =over 4 |
4755096e | 2022 | |
c2e66d9e | 2023 | =item Semaphores: Synchronizing Data Access |
4755096e | 2024 | |
c2e66d9e | 2025 | Basic semaphores, Advanced Semaphores |
4755096e | 2026 | |
c2e66d9e | 2027 | =item Attributes: Restricting Access To Subroutines |
4755096e | 2028 | |
c2e66d9e | 2029 | =item Subroutine Locks |
4755096e | 2030 | |
c2e66d9e | 2031 | =item Methods |
4755096e | 2032 | |
c2e66d9e | 2033 | =item Locking A Subroutine |
4755096e GS |
2034 | |
2035 | =back | |
2036 | ||
c2e66d9e | 2037 | =item General Thread Utility Routines |
4755096e | 2038 | |
d420ca49 | 2039 | =over 4 |
4755096e | 2040 | |
c2e66d9e | 2041 | =item What Thread Am I In? |
4755096e | 2042 | |
c2e66d9e | 2043 | =item Thread IDs |
4755096e | 2044 | |
c2e66d9e | 2045 | =item Are These Threads The Same? |
4755096e | 2046 | |
c2e66d9e | 2047 | =item What Threads Are Running? |
4755096e | 2048 | |
c2e66d9e | 2049 | =back |
4755096e | 2050 | |
c2e66d9e | 2051 | =item A Complete Example |
4755096e | 2052 | |
c2e66d9e | 2053 | =item Conclusion |
4755096e | 2054 | |
c2e66d9e | 2055 | =item Bibliography |
4755096e | 2056 | |
d420ca49 | 2057 | =over 4 |
4755096e | 2058 | |
c2e66d9e | 2059 | =item Introductory Texts |
4755096e | 2060 | |
c2e66d9e | 2061 | =item OS-Related References |
4755096e | 2062 | |
c2e66d9e | 2063 | =item Other References |
4755096e GS |
2064 | |
2065 | =back | |
2066 | ||
c2e66d9e | 2067 | =item Acknowledgements |
4755096e | 2068 | |
c2e66d9e | 2069 | =item AUTHOR |
4755096e | 2070 | |
c2e66d9e | 2071 | =item Copyrights |
4755096e | 2072 | |
c2e66d9e | 2073 | =back |
4755096e | 2074 | |
c2e66d9e | 2075 | =head2 perlport - Writing portable Perl |
4755096e | 2076 | |
d420ca49 | 2077 | =over 4 |
4755096e | 2078 | |
c2e66d9e | 2079 | =item DESCRIPTION |
4755096e | 2080 | |
c2e66d9e GS |
2081 | Not all Perl programs have to be portable, Nearly all of Perl already I<is> |
2082 | portable | |
4755096e | 2083 | |
c2e66d9e | 2084 | =item ISSUES |
4755096e | 2085 | |
d420ca49 | 2086 | =over 4 |
4755096e | 2087 | |
c2e66d9e | 2088 | =item Newlines |
4755096e | 2089 | |
c2e66d9e | 2090 | =item Numbers endianness and Width |
4755096e | 2091 | |
c2e66d9e | 2092 | =item Files and Filesystems |
4755096e | 2093 | |
c2e66d9e | 2094 | =item System Interaction |
4755096e | 2095 | |
c2e66d9e | 2096 | =item Interprocess Communication (IPC) |
4755096e | 2097 | |
c2e66d9e | 2098 | =item External Subroutines (XS) |
4755096e | 2099 | |
c2e66d9e | 2100 | =item Standard Modules |
4755096e | 2101 | |
c2e66d9e | 2102 | =item Time and Date |
4755096e | 2103 | |
c2e66d9e | 2104 | =item Character sets and character encoding |
4755096e | 2105 | |
c2e66d9e | 2106 | =item Internationalisation |
4755096e | 2107 | |
c2e66d9e | 2108 | =item System Resources |
4755096e | 2109 | |
c2e66d9e | 2110 | =item Security |
4755096e | 2111 | |
c2e66d9e | 2112 | =item Style |
4755096e GS |
2113 | |
2114 | =back | |
2115 | ||
c2e66d9e | 2116 | =item CPAN Testers |
4755096e | 2117 | |
c2e66d9e GS |
2118 | Mailing list: cpan-testers@perl.org, Testing results: |
2119 | http://testers.cpan.org/ | |
4755096e | 2120 | |
c2e66d9e | 2121 | =item PLATFORMS |
4755096e | 2122 | |
d420ca49 | 2123 | =over 4 |
4755096e | 2124 | |
c2e66d9e | 2125 | =item Unix |
4755096e | 2126 | |
c2e66d9e | 2127 | =item DOS and Derivatives |
4755096e | 2128 | |
c2e66d9e | 2129 | Build instructions for OS/2, L<perlos2> |
4755096e | 2130 | |
c2e66d9e | 2131 | =item S<Mac OS> |
4755096e | 2132 | |
c2e66d9e | 2133 | =item VMS |
4755096e | 2134 | |
c2e66d9e | 2135 | =item VOS |
4755096e | 2136 | |
c2e66d9e | 2137 | =item EBCDIC Platforms |
4755096e | 2138 | |
c2e66d9e | 2139 | =item Acorn RISC OS |
4755096e | 2140 | |
c2e66d9e | 2141 | =item Other perls |
4755096e GS |
2142 | |
2143 | =back | |
2144 | ||
c2e66d9e | 2145 | =item FUNCTION IMPLEMENTATIONS |
4755096e | 2146 | |
d420ca49 | 2147 | =over 4 |
4755096e | 2148 | |
c2e66d9e GS |
2149 | =item Alphabetical Listing of Perl Functions |
2150 | ||
2151 | -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode | |
2152 | FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt | |
2153 | PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec | |
2154 | LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, | |
2155 | getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, | |
2156 | getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr | |
2157 | ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, | |
2158 | getgrent, gethostent, getnetent, getprotoent, getservent, setpwent, | |
2159 | setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, | |
2160 | setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent, | |
2161 | endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, | |
2162 | ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, | |
2163 | lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, | |
2164 | msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, | |
2165 | open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, | |
2166 | select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget | |
2167 | KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, | |
2168 | setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt | |
2169 | SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, | |
d396a558 JH |
2170 | shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, socketpair |
2171 | SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat, | |
2172 | symlink OLDFILE,NEWFILE, syscall LIST, sysopen | |
2173 | FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate | |
2174 | FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST, | |
2175 | wait, waitpid PID,FLAGS | |
4755096e | 2176 | |
d396a558 | 2177 | =back |
4755096e | 2178 | |
d396a558 | 2179 | =item CHANGES |
4755096e | 2180 | |
d396a558 JH |
2181 | v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999, |
2182 | v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May | |
2183 | 1999, v1.40, 11 April 1999, v1.39, 11 February 1999, v1.38, 31 December | |
2184 | 1998, v1.37, 19 December 1998, v1.36, 9 September 1998, v1.35, 13 August | |
2185 | 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, | |
2186 | v1.23, 10 July 1998 | |
4755096e | 2187 | |
d396a558 | 2188 | =item Supported Platforms |
4755096e | 2189 | |
d396a558 | 2190 | =item SEE ALSO |
4755096e | 2191 | |
d396a558 | 2192 | =item AUTHORS / CONTRIBUTORS |
4755096e | 2193 | |
d396a558 | 2194 | =item VERSION |
4755096e GS |
2195 | |
2196 | =back | |
2197 | ||
d396a558 JH |
2198 | =head2 perllocale - Perl locale handling (internationalization and |
2199 | localization) | |
4755096e | 2200 | |
d420ca49 | 2201 | =over 4 |
4755096e | 2202 | |
d396a558 | 2203 | =item DESCRIPTION |
4755096e | 2204 | |
d396a558 JH |
2205 | =item PREPARING TO USE LOCALES |
2206 | ||
2207 | =item USING LOCALES | |
4755096e | 2208 | |
d420ca49 | 2209 | =over 4 |
4755096e | 2210 | |
d396a558 | 2211 | =item The use locale pragma |
4755096e | 2212 | |
d396a558 | 2213 | =item The setlocale function |
4755096e | 2214 | |
d396a558 | 2215 | =item Finding locales |
4755096e | 2216 | |
d396a558 | 2217 | =item LOCALE PROBLEMS |
4755096e | 2218 | |
d396a558 | 2219 | =item Temporarily fixing locale problems |
4755096e | 2220 | |
d396a558 | 2221 | =item Permanently fixing locale problems |
4755096e | 2222 | |
d396a558 | 2223 | =item Permanently fixing your system's locale configuration |
4755096e | 2224 | |
d396a558 | 2225 | =item Fixing system locale configuration |
4755096e | 2226 | |
d396a558 | 2227 | =item The localeconv function |
4755096e GS |
2228 | |
2229 | =back | |
2230 | ||
d396a558 | 2231 | =item LOCALE CATEGORIES |
4755096e | 2232 | |
d420ca49 | 2233 | =over 4 |
4755096e | 2234 | |
d396a558 | 2235 | =item Category LC_COLLATE: Collation |
4755096e | 2236 | |
d396a558 | 2237 | =item Category LC_CTYPE: Character Types |
4755096e | 2238 | |
d396a558 | 2239 | =item Category LC_NUMERIC: Numeric Formatting |
4755096e | 2240 | |
d396a558 | 2241 | =item Category LC_MONETARY: Formatting of monetary amounts |
4755096e | 2242 | |
d396a558 | 2243 | =item LC_TIME |
4755096e | 2244 | |
d396a558 | 2245 | =item Other categories |
4755096e | 2246 | |
d396a558 | 2247 | =back |
4755096e | 2248 | |
d396a558 | 2249 | =item SECURITY |
4755096e | 2250 | |
d396a558 JH |
2251 | B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):, |
2252 | B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>), | |
2253 | B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):, | |
2254 | B<Output formatting functions> (printf() and write()):, B<Case-mapping | |
2255 | functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent | |
2256 | functions> (localeconv(), strcoll(), strftime(), strxfrm()):, B<POSIX | |
2257 | character class tests> (isalnum(), isalpha(), isdigit(), isgraph(), | |
2258 | islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()): | |
4755096e | 2259 | |
d396a558 | 2260 | =item ENVIRONMENT |
4755096e | 2261 | |
d396a558 JH |
2262 | PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, |
2263 | LC_NUMERIC, LC_TIME, LANG | |
4755096e | 2264 | |
d396a558 | 2265 | =item NOTES |
4755096e | 2266 | |
d420ca49 | 2267 | =over 4 |
4755096e | 2268 | |
d396a558 | 2269 | =item Backward compatibility |
4755096e | 2270 | |
d396a558 | 2271 | =item I18N:Collate obsolete |
4755096e | 2272 | |
d396a558 | 2273 | =item Sort speed and memory use impacts |
4755096e | 2274 | |
d396a558 | 2275 | =item write() and LC_NUMERIC |
4755096e | 2276 | |
d396a558 | 2277 | =item Freely available locale definitions |
4755096e | 2278 | |
d396a558 | 2279 | =item I18n and l10n |
4755096e | 2280 | |
d396a558 | 2281 | =item An imperfect standard |
4755096e GS |
2282 | |
2283 | =back | |
2284 | ||
d396a558 | 2285 | =item BUGS |
4755096e | 2286 | |
d420ca49 | 2287 | =over 4 |
4755096e | 2288 | |
d396a558 | 2289 | =item Broken systems |
4755096e GS |
2290 | |
2291 | =back | |
2292 | ||
2293 | =item SEE ALSO | |
2294 | ||
d396a558 | 2295 | =item HISTORY |
4755096e GS |
2296 | |
2297 | =back | |
2298 | ||
d396a558 | 2299 | =head2 perlunicode - Unicode support in Perl |
4755096e | 2300 | |
d420ca49 | 2301 | =over 4 |
4755096e GS |
2302 | |
2303 | =item DESCRIPTION | |
2304 | ||
d420ca49 | 2305 | =over 4 |
4755096e | 2306 | |
d396a558 | 2307 | =item Important Caveat |
4755096e | 2308 | |
d396a558 JH |
2309 | Input and Output Disciplines, Regular Expressions, C<use utf8> still needed |
2310 | to enable a few features | |
4755096e | 2311 | |
d396a558 | 2312 | =item Byte and Character semantics |
4755096e | 2313 | |
d396a558 | 2314 | =item Effects of character semantics |
4755096e | 2315 | |
d396a558 | 2316 | =item Character encodings for input and output |
4755096e | 2317 | |
d396a558 JH |
2318 | =back |
2319 | ||
2320 | =item CAVEATS | |
2321 | ||
2322 | =item SEE ALSO | |
4755096e GS |
2323 | |
2324 | =back | |
2325 | ||
d396a558 | 2326 | =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms |
4755096e | 2327 | |
d420ca49 | 2328 | =over 4 |
4755096e | 2329 | |
d396a558 | 2330 | =item DESCRIPTION |
4755096e | 2331 | |
d396a558 | 2332 | =item COMMON CHARACTER CODE SETS |
4755096e | 2333 | |
d420ca49 | 2334 | =over 4 |
4755096e | 2335 | |
d396a558 | 2336 | =item ASCII |
4755096e | 2337 | |
d396a558 | 2338 | =item ISO 8859 |
4755096e | 2339 | |
d396a558 | 2340 | =item Latin 1 (ISO 8859-1) |
4755096e | 2341 | |
d396a558 | 2342 | =item EBCDIC |
4755096e | 2343 | |
d396a558 | 2344 | =item 13 variant characters |
4755096e | 2345 | |
d396a558 | 2346 | =item 0037 |
4755096e | 2347 | |
d396a558 | 2348 | =item 1047 |
4755096e | 2349 | |
d396a558 | 2350 | =item POSIX-BC |
4755096e GS |
2351 | |
2352 | =back | |
2353 | ||
d396a558 | 2354 | =item SINGLE OCTET TABLES |
4755096e | 2355 | |
d396a558 | 2356 | recipe 0, recipe 1, recipe 2, recipe 3, recipe 4 |
4755096e | 2357 | |
d396a558 | 2358 | =item IDENTIFYING CHARACTER CODE SETS |
4755096e | 2359 | |
d396a558 | 2360 | =item CONVERSIONS |
4755096e | 2361 | |
d420ca49 | 2362 | =over 4 |
37d4d706 JH |
2363 | |
2364 | =item tr/// | |
2365 | ||
2366 | =item iconv | |
2367 | ||
2368 | =item C RTL | |
2369 | ||
2370 | =back | |
2371 | ||
d396a558 | 2372 | =item OPERATOR DIFFERENCES |
4755096e | 2373 | |
d396a558 | 2374 | =item FUNCTION DIFFERENCES |
4755096e | 2375 | |
d396a558 | 2376 | chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() |
4755096e | 2377 | |
d396a558 | 2378 | =item REGULAR EXPRESSION DIFFERENCES |
4755096e | 2379 | |
d396a558 | 2380 | =item SOCKETS |
4755096e | 2381 | |
d396a558 | 2382 | =item SORTING |
4755096e | 2383 | |
d420ca49 | 2384 | =over 4 |
4755096e | 2385 | |
9fa7f388 | 2386 | =item Ignore ASCII vs. EBCDIC sort differences. |
4755096e | 2387 | |
9fa7f388 | 2388 | =item MONO CASE then sort data. |
4755096e | 2389 | |
9fa7f388 | 2390 | =item Convert, sort data, then re convert. |
4755096e | 2391 | |
d396a558 | 2392 | =item Perform sorting on one type of machine only. |
4755096e GS |
2393 | |
2394 | =back | |
2395 | ||
37d4d706 JH |
2396 | =item TRANFORMATION FORMATS |
2397 | ||
d420ca49 | 2398 | =over 4 |
37d4d706 JH |
2399 | |
2400 | =item URL decoding and encoding | |
2401 | ||
2402 | =item uu encoding and decoding | |
2403 | ||
2404 | =item Quoted-Printable encoding and decoding | |
2405 | ||
2406 | =item Caesarian cyphers | |
2407 | ||
2408 | =back | |
2409 | ||
2410 | =item Hashing order and checksums | |
4755096e | 2411 | |
d396a558 | 2412 | =item I18N AND L10N |
4755096e | 2413 | |
d396a558 | 2414 | =item MULTI OCTET CHARACTER SETS |
4755096e | 2415 | |
d396a558 | 2416 | =item OS ISSUES |
4755096e | 2417 | |
d420ca49 | 2418 | =over 4 |
4755096e | 2419 | |
d396a558 | 2420 | =item OS/400 |
7029d033 | 2421 | |
d396a558 | 2422 | IFS access |
4755096e | 2423 | |
d396a558 | 2424 | =item OS/390 |
4755096e | 2425 | |
37d4d706 | 2426 | chcp, dataset access, OS/390 iconv, locales |
4755096e | 2427 | |
d396a558 | 2428 | =item VM/ESA? |
4755096e | 2429 | |
d396a558 | 2430 | =item POSIX-BC? |
4755096e | 2431 | |
d396a558 | 2432 | =back |
4755096e | 2433 | |
9fa7f388 JH |
2434 | =item BUGS |
2435 | ||
b3b6085d PP |
2436 | =item SEE ALSO |
2437 | ||
d396a558 | 2438 | =item REFERENCES |
c2e66d9e | 2439 | |
d396a558 | 2440 | =item AUTHOR |
4755096e GS |
2441 | |
2442 | =back | |
2443 | ||
d396a558 | 2444 | =head2 perlsec - Perl security |
4755096e | 2445 | |
d420ca49 | 2446 | =over 4 |
4755096e | 2447 | |
4755096e GS |
2448 | =item DESCRIPTION |
2449 | ||
d420ca49 | 2450 | =over 4 |
4755096e | 2451 | |
d396a558 | 2452 | =item Laundering and Detecting Tainted Data |
4755096e | 2453 | |
d396a558 | 2454 | =item Switches On the "#!" Line |
4755096e | 2455 | |
d396a558 | 2456 | =item Cleaning Up Your Path |
c2e66d9e | 2457 | |
d396a558 | 2458 | =item Security Bugs |
c2e66d9e | 2459 | |
d396a558 | 2460 | =item Protecting Your Programs |
4755096e GS |
2461 | |
2462 | =back | |
2463 | ||
c2e66d9e GS |
2464 | =item SEE ALSO |
2465 | ||
4755096e GS |
2466 | =back |
2467 | ||
c2e66d9e | 2468 | =head2 perlmod - Perl modules (packages and symbol tables) |
4755096e | 2469 | |
d420ca49 | 2470 | =over 4 |
4755096e GS |
2471 | |
2472 | =item DESCRIPTION | |
2473 | ||
d420ca49 | 2474 | =over 4 |
4755096e | 2475 | |
c2e66d9e | 2476 | =item Packages |
4755096e | 2477 | |
c2e66d9e | 2478 | =item Symbol Tables |
4755096e | 2479 | |
c2e66d9e | 2480 | =item Package Constructors and Destructors |
4755096e | 2481 | |
c2e66d9e | 2482 | =item Perl Classes |
4755096e | 2483 | |
c2e66d9e | 2484 | =item Perl Modules |
4755096e GS |
2485 | |
2486 | =back | |
2487 | ||
c2e66d9e | 2488 | =item SEE ALSO |
4755096e | 2489 | |
c2e66d9e | 2490 | =back |
4755096e | 2491 | |
c2e66d9e | 2492 | =head2 perlmodlib - constructing new Perl modules and finding existing ones |
4755096e | 2493 | |
d420ca49 | 2494 | =over 4 |
4755096e | 2495 | |
c2e66d9e | 2496 | =item DESCRIPTION |
4755096e | 2497 | |
c2e66d9e | 2498 | =item THE PERL MODULE LIBRARY |
4755096e | 2499 | |
d420ca49 | 2500 | =over 4 |
4755096e | 2501 | |
c2e66d9e | 2502 | =item Pragmatic Modules |
4755096e | 2503 | |
c2e66d9e | 2504 | attributes, attrs, autouse, base, blib, bytes, charnames, constant, |
d420ca49 AD |
2505 | diagnostics, fields, filetest, integer, less, locale, open, ops, overload, |
2506 | re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register | |
4755096e | 2507 | |
c2e66d9e | 2508 | =item Standard Modules |
4755096e | 2509 | |
c2e66d9e GS |
2510 | AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, |
2511 | B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint, | |
d420ca49 AD |
2512 | B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, |
2513 | ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, | |
2514 | CGI::Pretty, CGI::Push, CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, | |
2515 | Carp, Carp::Heavy, Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, | |
2516 | DirHandle, Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy, | |
2517 | ExtUtils::Command, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, | |
2518 | ExtUtils::Liblist, ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, | |
2519 | ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, | |
2520 | ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap, | |
2521 | ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, | |
2522 | File::Basename, File::CheckTree, File::Compare, File::Copy, File::DosGlob, | |
2523 | File::Find, File::Path, File::Spec, File::Spec::Functions, File::Spec::Mac, | |
2524 | File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, | |
2525 | File::Temp, File::stat, FileCache, FileHandle, FindBin, Getopt::Long, | |
2526 | Getopt::Std, I18N::Collate, IO, IPC::Open2, IPC::Open3, Math::BigFloat, | |
2527 | Math::BigInt, Math::Complex, Math::Trig, NDBM_File, Net::Ping, | |
2528 | Net::hostent, Net::netent, Net::protoent, Net::servent, O, ODBM_File, | |
2529 | Opcode, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, | |
2530 | Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, | |
2531 | Pod::Text, Pod::Text::Color, Pod::Text::Termcap, Pod::Usage, SDBM_File, | |
2532 | Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, | |
2533 | Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test, | |
2534 | Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex, Text::Wrap, | |
2535 | Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, | |
7029d033 JH |
2536 | Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm, |
2537 | UNIVERSAL, User::grent, User::pwent | |
4755096e | 2538 | |
c2e66d9e | 2539 | =item Extension Modules |
4755096e | 2540 | |
c2e66d9e | 2541 | =back |
4755096e | 2542 | |
c2e66d9e | 2543 | =item CPAN |
4755096e | 2544 | |
c2e66d9e GS |
2545 | Language Extensions and Documentation Tools, Development Support, Operating |
2546 | System Interfaces, Networking, Device Control (modems) and InterProcess | |
2547 | Communication, Data Types and Data Type Utilities, Database Interfaces, | |
2548 | User Interfaces, Interfaces to / Emulations of Other Programming Languages, | |
2549 | File Names, File Systems and File Locking (see also File Handles), String | |
2550 | Processing, Language Text Processing, Parsing, and Searching, Option, | |
2551 | Argument, Parameter, and Configuration File Processing, | |
2552 | Internationalization and Locale, Authentication, Security, and Encryption, | |
2553 | World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities, | |
2554 | Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing, | |
2555 | and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and | |
2556 | exceptions etc), File Handle and Input/Output Stream Utilities, | |
2557 | Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe, | |
2558 | North America, South America | |
4755096e | 2559 | |
c2e66d9e | 2560 | =item Modules: Creation, Use, and Abuse |
4755096e | 2561 | |
d420ca49 | 2562 | =over 4 |
4755096e | 2563 | |
c2e66d9e | 2564 | =item Guidelines for Module Creation |
4755096e | 2565 | |
c2e66d9e GS |
2566 | Do similar modules already exist in some form?, Try to design the new |
2567 | module to be easy to extend and reuse, Some simple style guidelines, Select | |
2568 | what to export, Select a name for the module, Have you got it right?, | |
2569 | README and other Additional Files, A description of the | |
2570 | module/package/extension etc, A copyright notice - see below, Prerequisites | |
2571 | - what else you may need to have, How to build it - possible changes to | |
2572 | Makefile.PL etc, How to install it, Recent changes in this release, | |
2573 | especially incompatibilities, Changes / enhancements you plan to make in | |
2574 | the future, Adding a Copyright Notice, Give the module a | |
2575 | version/issue/release number, How to release and distribute a module, Take | |
2576 | care when changing a released module | |
4755096e | 2577 | |
c2e66d9e | 2578 | =item Guidelines for Converting Perl 4 Library Scripts into Modules |
4755096e | 2579 | |
c2e66d9e GS |
2580 | There is no requirement to convert anything, Consider the implications, |
2581 | Make the most of the opportunity, The pl2pm utility will get you started, | |
2582 | Adds the standard Module prologue lines, Converts package specifiers from ' | |
2583 | to ::, Converts die(...) to croak(...), Several other minor changes | |
4755096e | 2584 | |
c2e66d9e | 2585 | =item Guidelines for Reusing Application Code |
4755096e | 2586 | |
c2e66d9e GS |
2587 | Complete applications rarely belong in the Perl Module Library, Many |
2588 | applications contain some Perl code that could be reused, Break-out the | |
2589 | reusable code into one or more separate module files, Take the opportunity | |
2590 | to reconsider and redesign the interfaces, In some cases the 'application' | |
2591 | can then be reduced to a small | |
4755096e | 2592 | |
c2e66d9e | 2593 | =back |
4755096e | 2594 | |
c2e66d9e | 2595 | =item NOTE |
4755096e | 2596 | |
c2e66d9e | 2597 | =back |
4755096e | 2598 | |
c2e66d9e | 2599 | =head2 perlmodinstall - Installing CPAN Modules |
4755096e | 2600 | |
d420ca49 | 2601 | =over 4 |
4755096e | 2602 | |
c2e66d9e | 2603 | =item DESCRIPTION |
4755096e | 2604 | |
d420ca49 | 2605 | =over 4 |
4755096e | 2606 | |
c2e66d9e | 2607 | =item PREAMBLE |
4755096e | 2608 | |
c2e66d9e GS |
2609 | B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the |
2610 | module (sometimes unnecessary), B<INSTALL> the module | |
4755096e | 2611 | |
c2e66d9e | 2612 | =back |
4755096e | 2613 | |
a9ef4385 JH |
2614 | =item PORTABILITY |
2615 | ||
c2e66d9e GS |
2616 | =item HEY |
2617 | ||
2618 | =item AUTHOR | |
2619 | ||
2620 | =item COPYRIGHT | |
4755096e GS |
2621 | |
2622 | =back | |
2623 | ||
c2e66d9e | 2624 | =head2 perlnewmod - preparing a new module for distribution |
4755096e | 2625 | |
d420ca49 | 2626 | =over 4 |
4755096e | 2627 | |
c2e66d9e | 2628 | =item DESCRIPTION |
4755096e | 2629 | |
d420ca49 | 2630 | =over 4 |
4755096e | 2631 | |
c2e66d9e | 2632 | =item Warning |
4755096e | 2633 | |
c2e66d9e | 2634 | =item What should I make into a module? |
4755096e | 2635 | |
c2e66d9e | 2636 | =item Step-by-step: Preparing the ground |
4755096e | 2637 | |
c2e66d9e | 2638 | Look around, Check it's new, Discuss the need, Choose a name, Check again |
4755096e | 2639 | |
c2e66d9e | 2640 | =item Step-by-step: Making the module |
4755096e | 2641 | |
c2e66d9e GS |
2642 | Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use |
2643 | L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old | |
2644 | documentation|perlpod>, Write tests, Write the README | |
4755096e | 2645 | |
c2e66d9e | 2646 | =item Step-by-step: Distributing your module |
4755096e | 2647 | |
c2e66d9e GS |
2648 | Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the |
2649 | tarball, Announce to the modules list, Announce to clpa, Fix bugs! | |
4755096e | 2650 | |
c2e66d9e | 2651 | =back |
4755096e | 2652 | |
c2e66d9e | 2653 | =item AUTHOR |
4755096e | 2654 | |
c2e66d9e | 2655 | =item SEE ALSO |
4755096e GS |
2656 | |
2657 | =back | |
2658 | ||
2659 | =head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date: | |
2660 | 1999/05/23 16:08:30 $) | |
2661 | ||
d420ca49 | 2662 | =over 4 |
4755096e GS |
2663 | |
2664 | =item DESCRIPTION | |
2665 | ||
d420ca49 | 2666 | =over 4 |
4755096e GS |
2667 | |
2668 | =item What is Perl? | |
2669 | ||
2670 | =item Who supports Perl? Who develops it? Why is it free? | |
2671 | ||
2672 | =item Which version of Perl should I use? | |
2673 | ||
2674 | =item What are perl4 and perl5? | |
2675 | ||
2676 | =item What is perl6? | |
2677 | ||
2678 | =item How stable is Perl? | |
2679 | ||
2680 | =item Is Perl difficult to learn? | |
2681 | ||
2682 | =item How does Perl compare with other languages like Java, Python, REXX, | |
2683 | Scheme, or Tcl? | |
2684 | ||
2685 | =item Can I do [task] in Perl? | |
2686 | ||
2687 | =item When shouldn't I program in Perl? | |
2688 | ||
2689 | =item What's the difference between "perl" and "Perl"? | |
2690 | ||
2691 | =item Is it a Perl program or a Perl script? | |
2692 | ||
2693 | =item What is a JAPH? | |
2694 | ||
2695 | =item Where can I get a list of Larry Wall witticisms? | |
2696 | ||
d420ca49 AD |
2697 | =item How can I convince my sysadmin/supervisor/employees to use (version |
2698 | 5/5.005/Perl) instead of some other language? | |
4755096e GS |
2699 | |
2700 | =back | |
2701 | ||
2702 | =item AUTHOR AND COPYRIGHT | |
2703 | ||
2704 | =back | |
2705 | ||
2706 | =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $, | |
2707 | $Date: 1999/10/14 18:46:09 $) | |
2708 | ||
d420ca49 | 2709 | =over 4 |
4755096e GS |
2710 | |
2711 | =item DESCRIPTION | |
2712 | ||
d420ca49 | 2713 | =over 4 |
4755096e GS |
2714 | |
2715 | =item What machines support Perl? Where do I get it? | |
2716 | ||
2717 | =item How can I get a binary version of Perl? | |
2718 | ||
2719 | =item I don't have a C compiler on my system. How can I compile perl? | |
2720 | ||
2721 | =item I copied the Perl binary from one machine to another, but scripts | |
2722 | don't work. | |
2723 | ||
2724 | =item I grabbed the sources and tried to compile but gdbm/dynamic | |
2725 | loading/malloc/linking/... failed. How do I make it work? | |
2726 | ||
2727 | =item What modules and extensions are available for Perl? What is CPAN? | |
2728 | What does CPAN/src/... mean? | |
2729 | ||
2730 | =item Is there an ISO or ANSI certified version of Perl? | |
2731 | ||
2732 | =item Where can I get information on Perl? | |
2733 | ||
2734 | =item What are the Perl newsgroups on Usenet? Where do I post questions? | |
2735 | ||
2736 | =item Where should I post source code? | |
2737 | ||
2738 | =item Perl Books | |
2739 | ||
2740 | References, Tutorials, Task-Oriented, Special Topics | |
2741 | ||
2742 | =item Perl in Magazines | |
2743 | ||
2744 | =item Perl on the Net: FTP and WWW Access | |
2745 | ||
2746 | =item What mailing lists are there for Perl? | |
2747 | ||
2748 | =item Archives of comp.lang.perl.misc | |
2749 | ||
2750 | =item Where can I buy a commercial version of Perl? | |
2751 | ||
2752 | =item Where do I send bug reports? | |
2753 | ||
2754 | =item What is perl.com? Perl Mongers? pm.org? perl.org? | |
2755 | ||
2756 | =back | |
2757 | ||
2758 | =item AUTHOR AND COPYRIGHT | |
2759 | ||
2760 | =back | |
2761 | ||
2762 | =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23 | |
2763 | 16:08:30 $) | |
2764 | ||
d420ca49 | 2765 | =over 4 |
4755096e GS |
2766 | |
2767 | =item DESCRIPTION | |
2768 | ||
d420ca49 | 2769 | =over 4 |
4755096e GS |
2770 | |
2771 | =item How do I do (anything)? | |
2772 | ||
2773 | =item How can I use Perl interactively? | |
2774 | ||
2775 | =item Is there a Perl shell? | |
2776 | ||
2777 | =item How do I debug my Perl programs? | |
2778 | ||
2779 | =item How do I profile my Perl programs? | |
2780 | ||
2781 | =item How do I cross-reference my Perl programs? | |
2782 | ||
2783 | =item Is there a pretty-printer (formatter) for Perl? | |
2784 | ||
2785 | =item Is there a ctags for Perl? | |
2786 | ||
2787 | =item Is there an IDE or Windows Perl Editor? | |
2788 | ||
2789 | =item Where can I get Perl macros for vi? | |
2790 | ||
2791 | =item Where can I get perl-mode for emacs? | |
2792 | ||
2793 | =item How can I use curses with Perl? | |
2794 | ||
2795 | =item How can I use X or Tk with Perl? | |
2796 | ||
2797 | =item How can I generate simple menus without using CGI or Tk? | |
2798 | ||
2799 | =item What is undump? | |
2800 | ||
2801 | =item How can I make my Perl program run faster? | |
2802 | ||
2803 | =item How can I make my Perl program take less memory? | |
2804 | ||
2805 | =item Is it unsafe to return a pointer to local data? | |
2806 | ||
2807 | =item How can I free an array or hash so my program shrinks? | |
2808 | ||
2809 | =item How can I make my CGI script more efficient? | |
2810 | ||
2811 | =item How can I hide the source for my Perl program? | |
2812 | ||
2813 | =item How can I compile my Perl program into byte code or C? | |
2814 | ||
2815 | =item How can I compile Perl into Java? | |
2816 | ||
2817 | =item How can I get C<#!perl> to work on [MS-DOS,NT,...]? | |
2818 | ||
2819 | =item Can I write useful Perl programs on the command line? | |
2820 | ||
2821 | =item Why don't Perl one-liners work on my DOS/Mac/VMS system? | |
2822 | ||
2823 | =item Where can I learn about CGI or Web programming in Perl? | |
2824 | ||
2825 | =item Where can I learn about object-oriented Perl programming? | |
2826 | ||
2827 | =item Where can I learn about linking C with Perl? [h2xs, xsubpp] | |
2828 | ||
2829 | =item I've read perlembed, perlguts, etc., but I can't embed perl in | |
d420ca49 | 2830 | my C program; what am I doing wrong? |
4755096e GS |
2831 | |
2832 | =item When I tried to run my script, I got this message. What does it | |
2833 | mean? | |
2834 | ||
2835 | =item What's MakeMaker? | |
2836 | ||
2837 | =back | |
2838 | ||
2839 | =item AUTHOR AND COPYRIGHT | |
2840 | ||
2841 | =back | |
2842 | ||
2843 | =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23 | |
2844 | 20:37:49 $) | |
2845 | ||
d420ca49 | 2846 | =over 4 |
4755096e GS |
2847 | |
2848 | =item DESCRIPTION | |
2849 | ||
2850 | =item Data: Numbers | |
2851 | ||
d420ca49 | 2852 | =over 4 |
4755096e GS |
2853 | |
2854 | =item Why am I getting long decimals (eg, 19.9499999999999) instead of the | |
2855 | numbers I should be getting (eg, 19.95)? | |
2856 | ||
2857 | =item Why isn't my octal data interpreted correctly? | |
2858 | ||
2859 | =item Does Perl have a round() function? What about ceil() and floor()? | |
2860 | Trig functions? | |
2861 | ||
2862 | =item How do I convert bits into ints? | |
2863 | ||
2864 | =item Why doesn't & work the way I want it to? | |
2865 | ||
2866 | =item How do I multiply matrices? | |
2867 | ||
2868 | =item How do I perform an operation on a series of integers? | |
2869 | ||
2870 | =item How can I output Roman numerals? | |
2871 | ||
2872 | =item Why aren't my random numbers random? | |
2873 | ||
2874 | =back | |
2875 | ||
2876 | =item Data: Dates | |
2877 | ||
d420ca49 | 2878 | =over 4 |
4755096e GS |
2879 | |
2880 | =item How do I find the week-of-the-year/day-of-the-year? | |
2881 | ||
2882 | =item How do I find the current century or millennium? | |
2883 | ||
2884 | =item How can I compare two dates and find the difference? | |
2885 | ||
2886 | =item How can I take a string and turn it into epoch seconds? | |
2887 | ||
2888 | =item How can I find the Julian Day? | |
2889 | ||
2890 | =item How do I find yesterday's date? | |
2891 | ||
2892 | =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant? | |
2893 | ||
2894 | =back | |
2895 | ||
2896 | =item Data: Strings | |
2897 | ||
d420ca49 | 2898 | =over 4 |
4755096e GS |
2899 | |
2900 | =item How do I validate input? | |
2901 | ||
2902 | =item How do I unescape a string? | |
2903 | ||
2904 | =item How do I remove consecutive pairs of characters? | |
2905 | ||
2906 | =item How do I expand function calls in a string? | |
2907 | ||
2908 | =item How do I find matching/nesting anything? | |
2909 | ||
2910 | =item How do I reverse a string? | |
2911 | ||
2912 | =item How do I expand tabs in a string? | |
2913 | ||
2914 | =item How do I reformat a paragraph? | |
2915 | ||
2916 | =item How can I access/change the first N letters of a string? | |
2917 | ||
2918 | =item How do I change the Nth occurrence of something? | |
2919 | ||
2920 | =item How can I count the number of occurrences of a substring within a | |
2921 | string? | |
2922 | ||
2923 | =item How do I capitalize all the words on one line? | |
2924 | ||
2925 | =item How can I split a [character] delimited string except when inside | |
2926 | [character]? (Comma-separated files) | |
2927 | ||
2928 | =item How do I strip blank space from the beginning/end of a string? | |
2929 | ||
2930 | =item How do I pad a string with blanks or pad a number with zeroes? | |
2931 | ||
2932 | =item How do I extract selected columns from a string? | |
2933 | ||
2934 | =item How do I find the soundex value of a string? | |
2935 | ||
2936 | =item How can I expand variables in text strings? | |
2937 | ||
2938 | =item What's wrong with always quoting "$vars"? | |
2939 | ||
2940 | =item Why don't my <<HERE documents work? | |
2941 | ||
2942 | 1. There must be no space after the << part, 2. There (probably) should be | |
2943 | a semicolon at the end, 3. You can't (easily) have any space in front of | |
2944 | the tag | |
2945 | ||
2946 | =back | |
2947 | ||
2948 | =item Data: Arrays | |
2949 | ||
d420ca49 | 2950 | =over 4 |
4755096e GS |
2951 | |
2952 | =item What is the difference between a list and an array? | |
2953 | ||
2954 | =item What is the difference between $array[1] and @array[1]? | |
2955 | ||
2956 | =item How can I remove duplicate elements from a list or array? | |
2957 | ||
2958 | a) If @in is sorted, and you want @out to be sorted: (this assumes all true | |
2959 | values in the array), b) If you don't know whether @in is sorted:, c) Like | |
2960 | (b), but @in contains only small integers:, d) A way to do (b) without any | |
2961 | loops or greps:, e) Like (d), but @in contains only small positive | |
2962 | integers: | |
2963 | ||
2964 | =item How can I tell whether a list or array contains a certain element? | |
2965 | ||
2966 | =item How do I compute the difference of two arrays? How do I compute the | |
2967 | intersection of two arrays? | |
2968 | ||
2969 | =item How do I test whether two arrays or hashes are equal? | |
2970 | ||
2971 | =item How do I find the first array element for which a condition is true? | |
2972 | ||
2973 | =item How do I handle linked lists? | |
2974 | ||
2975 | =item How do I handle circular lists? | |
2976 | ||
2977 | =item How do I shuffle an array randomly? | |
2978 | ||
2979 | =item How do I process/modify each element of an array? | |
2980 | ||
2981 | =item How do I select a random element from an array? | |
2982 | ||
2983 | =item How do I permute N elements of a list? | |
2984 | ||
2985 | =item How do I sort an array by (anything)? | |
2986 | ||
2987 | =item How do I manipulate arrays of bits? | |
2988 | ||
2989 | =item Why does defined() return true on empty arrays and hashes? | |
2990 | ||
2991 | =back | |
2992 | ||
2993 | =item Data: Hashes (Associative Arrays) | |
2994 | ||
d420ca49 | 2995 | =over 4 |
4755096e GS |
2996 | |
2997 | =item How do I process an entire hash? | |
2998 | ||
2999 | =item What happens if I add or remove keys from a hash while iterating over | |
3000 | it? | |
3001 | ||
3002 | =item How do I look up a hash element by value? | |
3003 | ||
3004 | =item How can I know how many entries are in a hash? | |
3005 | ||
3006 | =item How do I sort a hash (optionally by value instead of key)? | |
3007 | ||
3008 | =item How can I always keep my hash sorted? | |
3009 | ||
3010 | =item What's the difference between "delete" and "undef" with hashes? | |
3011 | ||
3012 | =item Why don't my tied hashes make the defined/exists distinction? | |
3013 | ||
3014 | =item How do I reset an each() operation part-way through? | |
3015 | ||
3016 | =item How can I get the unique keys from two hashes? | |
3017 | ||
3018 | =item How can I store a multidimensional array in a DBM file? | |
3019 | ||
3020 | =item How can I make my hash remember the order I put elements into it? | |
3021 | ||
3022 | =item Why does passing a subroutine an undefined element in a hash create | |
3023 | it? | |
3024 | ||
3025 | =item How can I make the Perl equivalent of a C structure/C++ class/hash or | |
3026 | array of hashes or arrays? | |
3027 | ||
3028 | =item How can I use a reference as a hash key? | |
3029 | ||
3030 | =back | |
3031 | ||
3032 | =item Data: Misc | |
3033 | ||
d420ca49 | 3034 | =over 4 |
4755096e GS |
3035 | |
3036 | =item How do I handle binary data correctly? | |
3037 | ||
3038 | =item How do I determine whether a scalar is a number/whole/integer/float? | |
3039 | ||
3040 | =item How do I keep persistent data across program calls? | |
3041 | ||
3042 | =item How do I print out or copy a recursive data structure? | |
3043 | ||
3044 | =item How do I define methods for every class/object? | |
3045 | ||
3046 | =item How do I verify a credit card checksum? | |
3047 | ||
3048 | =item How do I pack arrays of doubles or floats for XS code? | |
3049 | ||
3050 | =back | |
3051 | ||
3052 | =item AUTHOR AND COPYRIGHT | |
3053 | ||
3054 | =back | |
3055 | ||
3056 | =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23 | |
3057 | 16:08:30 $) | |
3058 | ||
d420ca49 | 3059 | =over 4 |
4755096e GS |
3060 | |
3061 | =item DESCRIPTION | |
3062 | ||
d420ca49 | 3063 | =over 4 |
4755096e GS |
3064 | |
3065 | =item How do I flush/unbuffer an output filehandle? Why must I do this? | |
3066 | ||
3067 | =item How do I change one line in a file/delete a line in a file/insert a | |
3068 | line in the middle of a file/append to the beginning of a file? | |
3069 | ||
3070 | =item How do I count the number of lines in a file? | |
3071 | ||
3072 | =item How do I make a temporary file name? | |
3073 | ||
3074 | =item How can I manipulate fixed-record-length files? | |
3075 | ||
3076 | =item How can I make a filehandle local to a subroutine? How do I pass | |
3077 | filehandles between subroutines? How do I make an array of filehandles? | |
3078 | ||
3079 | =item How can I use a filehandle indirectly? | |
3080 | ||
3081 | =item How can I set up a footer format to be used with write()? | |
3082 | ||
3083 | =item How can I write() into a string? | |
3084 | ||
3085 | =item How can I output my numbers with commas added? | |
3086 | ||
3087 | =item How can I translate tildes (~) in a filename? | |
3088 | ||
3089 | =item How come when I open a file read-write it wipes it out? | |
3090 | ||
3091 | =item Why do I sometimes get an "Argument list too long" when I use <*>? | |
3092 | ||
3093 | =item Is there a leak/bug in glob()? | |
3094 | ||
3095 | =item How can I open a file with a leading ">" or trailing blanks? | |
3096 | ||
3097 | =item How can I reliably rename a file? | |
3098 | ||
3099 | =item How can I lock a file? | |
3100 | ||
3101 | =item Why can't I just open(FH, ">file.lock")? | |
3102 | ||
3103 | =item I still don't get locking. I just want to increment the number in | |
3104 | the file. How can I do this? | |
3105 | ||
3106 | =item How do I randomly update a binary file? | |
3107 | ||
3108 | =item How do I get a file's timestamp in perl? | |
3109 | ||
3110 | =item How do I set a file's timestamp in perl? | |
3111 | ||
3112 | =item How do I print to more than one file at once? | |
3113 | ||
3114 | =item How can I read in an entire file all at once? | |
3115 | ||
3116 | =item How can I read in a file by paragraphs? | |
3117 | ||
3118 | =item How can I read a single character from a file? From the keyboard? | |
3119 | ||
3120 | =item How can I tell whether there's a character waiting on a filehandle? | |
3121 | ||
3122 | =item How do I do a C<tail -f> in perl? | |
3123 | ||
3124 | =item How do I dup() a filehandle in Perl? | |
3125 | ||
3126 | =item How do I close a file descriptor by number? | |
3127 | ||
3128 | =item Why can't I use "C:\temp\foo" in DOS paths? What doesn't | |
3129 | `C:\temp\foo.exe` work? | |
3130 | ||
3131 | =item Why doesn't glob("*.*") get all the files? | |
3132 | ||
3133 | =item Why does Perl let me delete read-only files? Why does C<-i> clobber | |
3134 | protected files? Isn't this a bug in Perl? | |
3135 | ||
3136 | =item How do I select a random line from a file? | |
3137 | ||
3138 | =item Why do I get weird spaces when I print an array of lines? | |
3139 | ||
3140 | =back | |
3141 | ||
3142 | =item AUTHOR AND COPYRIGHT | |
3143 | ||
3144 | =back | |
3145 | ||
3146 | =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $) | |
3147 | ||
d420ca49 | 3148 | =over 4 |
4755096e GS |
3149 | |
3150 | =item DESCRIPTION | |
3151 | ||
d420ca49 | 3152 | =over 4 |
4755096e GS |
3153 | |
3154 | =item How can I hope to use regular expressions without creating illegible | |
3155 | and unmaintainable code? | |
3156 | ||
3157 | Comments Outside the Regex, Comments Inside the Regex, Different Delimiters | |
3158 | ||
3159 | =item I'm having trouble matching over more than one line. What's wrong? | |
3160 | ||
3161 | =item How can I pull out lines between two patterns that are themselves on | |
3162 | different lines? | |
3163 | ||
3164 | =item I put a regular expression into $/ but it didn't work. What's wrong? | |
3165 | ||
d420ca49 | 3166 | =item How do I substitute case insensitively on the LHS while preserving |
4755096e GS |
3167 | case on the RHS? |
3168 | ||
3169 | =item How can I make C<\w> match national character sets? | |
3170 | ||
3171 | =item How can I match a locale-smart version of C</[a-zA-Z]/>? | |
3172 | ||
3173 | =item How can I quote a variable to use in a regex? | |
3174 | ||
3175 | =item What is C</o> really for? | |
3176 | ||
3177 | =item How do I use a regular expression to strip C style comments from a | |
3178 | file? | |
3179 | ||
3180 | =item Can I use Perl regular expressions to match balanced text? | |
3181 | ||
3182 | =item What does it mean that regexes are greedy? How can I get around it? | |
3183 | ||
3184 | =item How do I process each word on each line? | |
3185 | ||
3186 | =item How can I print out a word-frequency or line-frequency summary? | |
3187 | ||
3188 | =item How can I do approximate matching? | |
3189 | ||
3190 | =item How do I efficiently match many regular expressions at once? | |
3191 | ||
3192 | =item Why don't word-boundary searches with C<\b> work for me? | |
3193 | ||
3194 | =item Why does using $&, $`, or $' slow my program down? | |
3195 | ||
3196 | =item What good is C<\G> in a regular expression? | |
3197 | ||
3198 | =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant? | |
3199 | ||
3200 | =item What's wrong with using grep or map in a void context? | |
3201 | ||
3202 | =item How can I match strings with multibyte characters? | |
3203 | ||
3204 | =item How do I match a pattern that is supplied by the user? | |
3205 | ||
3206 | =back | |
3207 | ||
3208 | =item AUTHOR AND COPYRIGHT | |
3209 | ||
3210 | =back | |
3211 | ||
3212 | =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date: | |
3213 | 1999/05/23 20:36:18 $) | |
3214 | ||
d420ca49 | 3215 | =over 4 |
4755096e GS |
3216 | |
3217 | =item DESCRIPTION | |
3218 | ||
d420ca49 | 3219 | =over 4 |
4755096e GS |
3220 | |
3221 | =item Can I get a BNF/yacc/RE for the Perl language? | |
3222 | ||
3223 | =item What are all these $@%&* punctuation signs, and how do I know when to | |
3224 | use them? | |
3225 | ||
3226 | =item Do I always/never have to quote my strings or use semicolons and | |
3227 | commas? | |
3228 | ||
3229 | =item How do I skip some return values? | |
68dc0745 | 3230 | |
3231 | =item How do I temporarily block warnings? | |
3232 | ||
3233 | =item What's an extension? | |
3234 | ||
3235 | =item Why do Perl operators have different precedence than C operators? | |
3236 | ||
3237 | =item How do I declare/create a structure? | |
3238 | ||
3239 | =item How do I create a module? | |
3240 | ||
3241 | =item How do I create a class? | |
3242 | ||
3243 | =item How can I tell if a variable is tainted? | |
3244 | ||
3245 | =item What's a closure? | |
3246 | ||
46fc3d4c | 3247 | =item What is variable suicide and how can I prevent it? |
3248 | ||
68dc0745 | 3249 | =item How can I pass/return a {Function, FileHandle, Array, Hash, Method, |
14218588 | 3250 | Regex}? |
68dc0745 | 3251 | |
14218588 | 3252 | Passing Variables and Functions, Passing Filehandles, Passing Regexes, |
68dc0745 | 3253 | Passing Methods |
3254 | ||
3255 | =item How do I create a static variable? | |
3256 | ||
14218588 | 3257 | =item What's the difference between dynamic and lexical (static) scoping? |
68dc0745 | 3258 | Between local() and my()? |
3259 | ||
3260 | =item How can I access a dynamic variable while a similarly named lexical | |
3261 | is in scope? | |
3262 | ||
3263 | =item What's the difference between deep and shallow binding? | |
3264 | ||
b38f6a39 | 3265 | =item Why doesn't "my($foo) = <FILE>;" work right? |
68dc0745 | 3266 | |
54310121 | 3267 | =item How do I redefine a builtin function, operator, or method? |
68dc0745 | 3268 | |
3269 | =item What's the difference between calling a function as &foo and foo()? | |
3270 | ||
3271 | =item How do I create a switch or case statement? | |
3272 | ||
3273 | =item How can I catch accesses to undefined variables/functions/methods? | |
3274 | ||
3275 | =item Why can't a method included in this same file be found? | |
3276 | ||
3277 | =item How can I find out my current package? | |
3278 | ||
46fc3d4c | 3279 | =item How can I comment out a large block of perl code? |
3280 | ||
14218588 GS |
3281 | =item How do I clear a package? |
3282 | ||
3283 | =item How can I use a variable as a variable name? | |
3284 | ||
68dc0745 | 3285 | =back |
3286 | ||
3287 | =item AUTHOR AND COPYRIGHT | |
3288 | ||
a45bd81d GS |
3289 | =back |
3290 | ||
14218588 GS |
3291 | =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23 |
3292 | 18:37:57 $) | |
68dc0745 | 3293 | |
d420ca49 | 3294 | =over 4 |
a45bd81d | 3295 | |
68dc0745 | 3296 | =item DESCRIPTION |
3297 | ||
d420ca49 | 3298 | =over 4 |
68dc0745 | 3299 | |
3300 | =item How do I find out which operating system I'm running under? | |
3301 | ||
3302 | =item How come exec() doesn't return? | |
3303 | ||
3304 | =item How do I do fancy stuff with the keyboard/screen/mouse? | |
3305 | ||
3306 | Keyboard, Screen, Mouse | |
3307 | ||
fb9cefb4 GS |
3308 | =item How do I print something out in color? |
3309 | ||
3310 | =item How do I read just one key without waiting for a return key? | |
3311 | ||
3312 | =item How do I check whether input is ready on the keyboard? | |
3313 | ||
3314 | =item How do I clear the screen? | |
3315 | ||
3316 | =item How do I get the screen size? | |
3317 | ||
68dc0745 | 3318 | =item How do I ask the user for a password? |
3319 | ||
3320 | =item How do I read and write the serial port? | |
3321 | ||
3322 | lockfiles, open mode, end of line, flushing output, non-blocking input | |
3323 | ||
3324 | =item How do I decode encrypted password files? | |
3325 | ||
3326 | =item How do I start a process in the background? | |
3327 | ||
fb9cefb4 | 3328 | STDIN, STDOUT, and STDERR are shared, Signals, Zombies |
68dc0745 | 3329 | |
3330 | =item How do I trap control characters/signals? | |
3331 | ||
3332 | =item How do I modify the shadow password file on a Unix system? | |
3333 | ||
3334 | =item How do I set the time and date? | |
3335 | ||
3336 | =item How can I sleep() or alarm() for under a second? | |
3337 | ||
3338 | =item How can I measure time under a second? | |
3339 | ||
3340 | =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling) | |
3341 | ||
d420ca49 | 3342 | =item Why doesn't my sockets program work under System V (Solaris)? What |
68dc0745 | 3343 | does the error message "Protocol not supported" mean? |
3344 | ||
3345 | =item How can I call my system's unique C functions from Perl? | |
3346 | ||
3347 | =item Where do I get the include files to do ioctl() or syscall()? | |
3348 | ||
3349 | =item Why do setuid perl scripts complain about kernel problems? | |
3350 | ||
3351 | =item How can I open a pipe both to and from a command? | |
3352 | ||
3fe9a6f1 | 3353 | =item Why can't I get the output of a command with system()? |
3354 | ||
68dc0745 | 3355 | =item How can I capture STDERR from an external command? |
3356 | ||
3357 | =item Why doesn't open() return an error when a pipe open fails? | |
3358 | ||
3359 | =item What's wrong with using backticks in a void context? | |
3360 | ||
3361 | =item How can I call backticks without shell processing? | |
3362 | ||
3363 | =item Why can't my script read from STDIN after I gave it EOF (^D on Unix, | |
54310121 | 3364 | ^Z on MS-DOS)? |
68dc0745 | 3365 | |
3366 | =item How can I convert my shell script to perl? | |
3367 | ||
3368 | =item Can I use perl to run a telnet or ftp session? | |
3369 | ||
3370 | =item How can I write expect in Perl? | |
3371 | ||
3372 | =item Is there a way to hide perl's command line from programs such as | |
3373 | "ps"? | |
3374 | ||
3375 | =item I {changed directory, modified my environment} in a perl script. How | |
3376 | come the change disappeared when I exited the script? How do I get my | |
3377 | changes to be visible? | |
3378 | ||
fb9cefb4 | 3379 | Unix |
68dc0745 | 3380 | |
3381 | =item How do I close a process's filehandle without waiting for it to | |
3382 | complete? | |
3383 | ||
3384 | =item How do I fork a daemon process? | |
3385 | ||
68dc0745 | 3386 | =item How do I find out if I'm running interactively or not? |
3387 | ||
3388 | =item How do I timeout a slow event? | |
3389 | ||
3390 | =item How do I set CPU limits? | |
3391 | ||
3392 | =item How do I avoid zombies on a Unix system? | |
3393 | ||
3394 | =item How do I use an SQL database? | |
3395 | ||
3396 | =item How do I make a system() exit on control-C? | |
3397 | ||
3398 | =item How do I open a file without blocking? | |
3399 | ||
14218588 | 3400 | =item How do I install a module from CPAN? |
68dc0745 | 3401 | |
fb9cefb4 GS |
3402 | =item What's the difference between require and use? |
3403 | ||
46fc3d4c | 3404 | =item How do I keep my own module/library directory? |
3405 | ||
3406 | =item How do I add the directory my program lives in to the module/library | |
3407 | search path? | |
3408 | ||
3409 | =item How do I add a directory to my include path at runtime? | |
3410 | ||
14218588 GS |
3411 | =item What is socket.ph and where do I get it? |
3412 | ||
68dc0745 | 3413 | =back |
3414 | ||
fc36a67e | 3415 | =item AUTHOR AND COPYRIGHT |
3416 | ||
a45bd81d GS |
3417 | =back |
3418 | ||
14218588 | 3419 | =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30 |
3fe9a6f1 | 3420 | $) |
68dc0745 | 3421 | |
d420ca49 | 3422 | =over 4 |
a45bd81d | 3423 | |
68dc0745 | 3424 | =item DESCRIPTION |
3425 | ||
d420ca49 | 3426 | =over 4 |
68dc0745 | 3427 | |
d420ca49 | 3428 | =item My CGI script runs from the command line but not the browser. (500 |
fb9cefb4 GS |
3429 | Server Error) |
3430 | ||
3431 | =item How can I get better error messages from a CGI program? | |
68dc0745 | 3432 | |
3433 | =item How do I remove HTML from a string? | |
3434 | ||
3435 | =item How do I extract URLs? | |
3436 | ||
3437 | =item How do I download a file from the user's machine? How do I open a | |
3438 | file on another machine? | |
3439 | ||
3440 | =item How do I make a pop-up menu in HTML? | |
3441 | ||
3442 | =item How do I fetch an HTML file? | |
3443 | ||
fb9cefb4 GS |
3444 | =item How do I automate an HTML form submission? |
3445 | ||
3446 | =item How do I decode or create those %-encodings on the web? | |
68dc0745 | 3447 | |
3448 | =item How do I redirect to another page? | |
3449 | ||
3450 | =item How do I put a password on my web pages? | |
3451 | ||
3452 | =item How do I edit my .htpasswd and .htgroup files with Perl? | |
3453 | ||
46fc3d4c | 3454 | =item How do I make sure users can't enter values into a form that cause my |
3455 | CGI script to do bad things? | |
3456 | ||
193fb0af | 3457 | =item How do I parse a mail header? |
68dc0745 | 3458 | |
3459 | =item How do I decode a CGI form? | |
3460 | ||
193fb0af | 3461 | =item How do I check a valid mail address? |
68dc0745 | 3462 | |
3463 | =item How do I decode a MIME/BASE64 string? | |
3464 | ||
193fb0af | 3465 | =item How do I return the user's mail address? |
68dc0745 | 3466 | |
fb9cefb4 GS |
3467 | =item How do I send mail? |
3468 | ||
3469 | =item How do I read mail? | |
68dc0745 | 3470 | |
3471 | =item How do I find out my hostname/domainname/IP address? | |
3472 | ||
3473 | =item How do I fetch a news article or the active newsgroups? | |
3474 | ||
3475 | =item How do I fetch/put an FTP file? | |
3476 | ||
3477 | =item How can I do RPC in Perl? | |
3478 | ||
3479 | =back | |
3480 | ||
3481 | =item AUTHOR AND COPYRIGHT | |
3482 | ||
a45bd81d GS |
3483 | =back |
3484 | ||
4755096e | 3485 | =head2 perlcompile - Introduction to the Perl Compiler-Translator |
a45bd81d | 3486 | |
d420ca49 | 3487 | =over 4 |
cb1a09d0 | 3488 | |
8ebc5c01 | 3489 | =item DESCRIPTION |
cb1a09d0 | 3490 | |
d420ca49 | 3491 | =over 4 |
fb9cefb4 | 3492 | |
4755096e | 3493 | =item Layout |
a45bd81d | 3494 | |
4755096e | 3495 | B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref |
637e9122 | 3496 | |
4755096e | 3497 | =back |
c76ac1ee | 3498 | |
4755096e | 3499 | =item Using The Back Ends |
c76ac1ee | 3500 | |
d420ca49 | 3501 | =over 4 |
694468e3 | 3502 | |
4755096e | 3503 | =item The Cross Referencing Back End |
c76ac1ee | 3504 | |
4755096e | 3505 | i, &, s, r |
637e9122 | 3506 | |
4755096e | 3507 | =item The Decompiling Back End |
37590e52 | 3508 | |
4755096e | 3509 | =item The Lint Back End |
c76ac1ee | 3510 | |
4755096e | 3511 | =item The Simple C Back End |
37590e52 | 3512 | |
4755096e | 3513 | =item The Bytecode Back End |
a45bd81d | 3514 | |
4755096e | 3515 | =item The Optimized C Back End |
a45bd81d | 3516 | |
4755096e GS |
3517 | B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, |
3518 | B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, | |
3519 | B::Stash, B::Terse, B::Xref | |
c76ac1ee | 3520 | |
4755096e | 3521 | =back |
b38f6a39 | 3522 | |
4755096e | 3523 | =item KNOWN PROBLEMS |
fb9cefb4 | 3524 | |
4755096e | 3525 | =item AUTHOR |
c76ac1ee | 3526 | |
4755096e | 3527 | =back |
a45bd81d | 3528 | |
4755096e | 3529 | =head2 perlembed - how to embed perl in your C program |
c76ac1ee | 3530 | |
d420ca49 | 3531 | =over 4 |
a45bd81d | 3532 | |
4755096e | 3533 | =item DESCRIPTION |
fb9cefb4 | 3534 | |
d420ca49 | 3535 | =over 4 |
c76ac1ee | 3536 | |
4755096e | 3537 | =item PREAMBLE |
fb9cefb4 | 3538 | |
4755096e GS |
3539 | B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from |
3540 | Perl?>, B<Use C from C?>, B<Use Perl from C?> | |
fb9cefb4 | 3541 | |
4755096e | 3542 | =item ROADMAP |
fb9cefb4 | 3543 | |
d420ca49 AD |
3544 | Compiling your C program, Adding a Perl interpreter to your C program, |
3545 | Calling a Perl subroutine from your C program, Evaluating a Perl statement | |
3546 | from your C program, Performing Perl pattern matches and substitutions from | |
3547 | your C program, Fiddling with the Perl stack from your C program, | |
3548 | Maintaining a persistent interpreter, Maintaining multiple interpreter | |
3549 | instances, Using Perl modules, which themselves use C libraries, from your | |
3550 | C program, Embedding Perl under Win32 | |
3551 | ||
4755096e | 3552 | =item Compiling your C program |
c76ac1ee | 3553 | |
4755096e | 3554 | =item Adding a Perl interpreter to your C program |
c76ac1ee | 3555 | |
4755096e | 3556 | =item Calling a Perl subroutine from your C program |
fb9cefb4 | 3557 | |
4755096e | 3558 | =item Evaluating a Perl statement from your C program |
c76ac1ee | 3559 | |
4755096e | 3560 | =item Performing Perl pattern matches and substitutions from your C program |
c76ac1ee | 3561 | |
4755096e | 3562 | =item Fiddling with the Perl stack from your C program |
37590e52 | 3563 | |
4755096e | 3564 | =item Maintaining a persistent interpreter |
c76ac1ee | 3565 | |
4755096e | 3566 | =item Maintaining multiple interpreter instances |
694468e3 | 3567 | |
4755096e GS |
3568 | =item Using Perl modules, which themselves use C libraries, from your C |
3569 | program | |
c76ac1ee | 3570 | |
14218588 | 3571 | =back |
fb9cefb4 | 3572 | |
d420ca49 | 3573 | =item Embedding Perl under Win32 |
fb9cefb4 | 3574 | |
4755096e | 3575 | =item MORAL |
c76ac1ee | 3576 | |
4755096e | 3577 | =item AUTHOR |
fb9cefb4 | 3578 | |
4755096e | 3579 | =item COPYRIGHT |
c76ac1ee | 3580 | |
4755096e | 3581 | =back |
c76ac1ee | 3582 | |
4755096e | 3583 | =head2 perldebguts - Guts of Perl debugging |
a45bd81d | 3584 | |
d420ca49 | 3585 | =over 4 |
c76ac1ee | 3586 | |
4755096e | 3587 | =item DESCRIPTION |
c76ac1ee | 3588 | |
4755096e | 3589 | =item Debugger Internals |
c76ac1ee | 3590 | |
d420ca49 | 3591 | =over 4 |
c76ac1ee | 3592 | |
4755096e | 3593 | =item Writing Your Own Debugger |
c76ac1ee | 3594 | |
37590e52 | 3595 | =back |
c76ac1ee | 3596 | |
4755096e | 3597 | =item Frame Listing Output Examples |
c76ac1ee | 3598 | |
4755096e | 3599 | =item Debugging regular expressions |
c76ac1ee | 3600 | |
d420ca49 | 3601 | =over 4 |
c76ac1ee | 3602 | |
4755096e | 3603 | =item Compile-time output |
c76ac1ee | 3604 | |
4755096e GS |
3605 | C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at> |
3606 | I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass> | |
3607 | I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>, | |
3608 | C<anchored(TYPE)> | |
c76ac1ee | 3609 | |
4755096e | 3610 | =item Types of nodes |
c76ac1ee | 3611 | |
4755096e | 3612 | =item Run-time output |
c76ac1ee | 3613 | |
37590e52 | 3614 | =back |
c76ac1ee | 3615 | |
4755096e | 3616 | =item Debugging Perl memory usage |
c76ac1ee | 3617 | |
d420ca49 | 3618 | =over 4 |
c76ac1ee | 3619 | |
4755096e | 3620 | =item Using C<$ENV{PERL_DEBUG_MSTATS}> |
c76ac1ee | 3621 | |
4755096e GS |
3622 | C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk(): |
3623 | SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail: | |
3624 | 6144> | |
c76ac1ee | 3625 | |
4755096e | 3626 | =item Example of using B<-DL> switch |
c76ac1ee | 3627 | |
4755096e | 3628 | C<717>, C<002>, C<054>, C<602>, C<702>, C<704> |
c76ac1ee | 3629 | |
4755096e | 3630 | =item B<-DL> details |
37590e52 | 3631 | |
4755096e | 3632 | C<!!!>, C<!!>, C<!> |
37590e52 | 3633 | |
4755096e | 3634 | =item Limitations of B<-DL> statistics |
37590e52 | 3635 | |
4755096e | 3636 | =back |
37590e52 | 3637 | |
4755096e | 3638 | =item SEE ALSO |
c76ac1ee GS |
3639 | |
3640 | =back | |
3641 | ||
4755096e | 3642 | =head2 perlxstut, perlXStut - Tutorial for writing XSUBs |
c76ac1ee | 3643 | |
d420ca49 | 3644 | =over 4 |
c76ac1ee | 3645 | |
4755096e | 3646 | =item DESCRIPTION |
c76ac1ee | 3647 | |
4755096e | 3648 | =item SPECIAL NOTES |
c76ac1ee | 3649 | |
d420ca49 | 3650 | =over 4 |
c76ac1ee | 3651 | |
4755096e | 3652 | =item make |
c76ac1ee | 3653 | |
4755096e GS |
3654 | =item Version caveat |
3655 | ||
3656 | =item Dynamic Loading versus Static Loading | |
c76ac1ee GS |
3657 | |
3658 | =back | |
fb9cefb4 | 3659 | |
4755096e | 3660 | =item TUTORIAL |
cb1a09d0 | 3661 | |
d420ca49 | 3662 | =over 4 |
8ebc5c01 | 3663 | |
4755096e | 3664 | =item EXAMPLE 1 |
fb9cefb4 | 3665 | |
4755096e | 3666 | =item EXAMPLE 2 |
fb9cefb4 | 3667 | |
4755096e | 3668 | =item What has gone on? |
5cd24f17 | 3669 | |
4755096e | 3670 | =item Writing good test scripts |
cb1a09d0 | 3671 | |
4755096e | 3672 | =item EXAMPLE 3 |
774d564b | 3673 | |
4755096e | 3674 | =item What's new here? |
c76ac1ee | 3675 | |
4755096e | 3676 | =item Input and Output Parameters |
c76ac1ee | 3677 | |
4755096e | 3678 | =item The XSUBPP Program |
b38f6a39 | 3679 | |
4755096e | 3680 | =item The TYPEMAP file |
c76ac1ee | 3681 | |
4755096e | 3682 | =item Warning about Output Arguments |
37590e52 | 3683 | |
4755096e | 3684 | =item EXAMPLE 4 |
37590e52 | 3685 | |
4755096e | 3686 | =item What has happened here? |
c76ac1ee | 3687 | |
4755096e | 3688 | =item Anatomy of .xs file |
37590e52 | 3689 | |
4755096e | 3690 | =item Getting the fat out of XSUBs |
cb1a09d0 | 3691 | |
4755096e | 3692 | =item More about XSUB arguments |
37590e52 | 3693 | |
4755096e | 3694 | =item The Argument Stack |
a45bd81d | 3695 | |
4755096e | 3696 | =item Extending your Extension |
a45bd81d | 3697 | |
4755096e | 3698 | =item Documenting your Extension |
37590e52 | 3699 | |
4755096e | 3700 | =item Installing your Extension |
37590e52 | 3701 | |
4755096e | 3702 | =item EXAMPLE 5 |
37590e52 | 3703 | |
4755096e | 3704 | =item New Things in this Example |
37590e52 | 3705 | |
4755096e | 3706 | =item EXAMPLE 6 |
37590e52 | 3707 | |
4755096e | 3708 | =item New Things in this Example |
37590e52 | 3709 | |
4755096e | 3710 | =item EXAMPLE 7 (Coming Soon) |
37590e52 | 3711 | |
4755096e | 3712 | =item EXAMPLE 8 (Coming Soon) |
37590e52 | 3713 | |
4755096e | 3714 | =item EXAMPLE 9 (Coming Soon) |
37590e52 | 3715 | |
4755096e | 3716 | =item Troubleshooting these Examples |
37590e52 | 3717 | |
4755096e | 3718 | =back |
37590e52 | 3719 | |
4755096e | 3720 | =item See also |
37590e52 | 3721 | |
4755096e | 3722 | =item Author |
37590e52 | 3723 | |
d420ca49 | 3724 | =over 4 |
37590e52 | 3725 | |
4755096e | 3726 | =item Last Changed |
37590e52 GS |
3727 | |
3728 | =back | |
3729 | ||
4755096e GS |
3730 | =back |
3731 | ||
3732 | =head2 perlxs - XS language reference manual | |
37590e52 | 3733 | |
d420ca49 | 3734 | =over 4 |
37590e52 | 3735 | |
4755096e | 3736 | =item DESCRIPTION |
37590e52 | 3737 | |
d420ca49 | 3738 | =over 4 |
37590e52 | 3739 | |
4755096e | 3740 | =item Introduction |
37590e52 | 3741 | |
4755096e | 3742 | =item On The Road |
37590e52 | 3743 | |
4755096e | 3744 | =item The Anatomy of an XSUB |
37590e52 | 3745 | |
4755096e | 3746 | =item The Argument Stack |
37590e52 | 3747 | |
4755096e | 3748 | =item The RETVAL Variable |
37590e52 | 3749 | |
4755096e | 3750 | =item The MODULE Keyword |
37590e52 | 3751 | |
4755096e | 3752 | =item The PACKAGE Keyword |
37590e52 | 3753 | |
4755096e | 3754 | =item The PREFIX Keyword |
37590e52 | 3755 | |
4755096e | 3756 | =item The OUTPUT: Keyword |
fb9cefb4 | 3757 | |
91331b4f JH |
3758 | =item The NO_OUTPUT Keyword |
3759 | ||
4755096e GS |
3760 | =item The CODE: Keyword |
3761 | ||
3762 | =item The INIT: Keyword | |
3763 | ||
3764 | =item The NO_INIT Keyword | |
3765 | ||
3766 | =item Initializing Function Parameters | |
3767 | ||
3768 | =item Default Parameter Values | |
3769 | ||
3770 | =item The PREINIT: Keyword | |
3771 | ||
3772 | =item The SCOPE: Keyword | |
3773 | ||
3774 | =item The INPUT: Keyword | |
3775 | ||
91331b4f JH |
3776 | =item The IN/OUTLIST/IN_OUTLIST Keywords |
3777 | ||
4755096e GS |
3778 | =item Variable-length Parameter Lists |
3779 | ||
3780 | =item The C_ARGS: Keyword | |
3781 | ||
3782 | =item The PPCODE: Keyword | |
3783 | ||
3784 | =item Returning Undef And Empty Lists | |
3785 | ||
3786 | =item The REQUIRE: Keyword | |
fb9cefb4 | 3787 | |
4755096e | 3788 | =item The CLEANUP: Keyword |
fb9cefb4 | 3789 | |
91331b4f JH |
3790 | =item The POST_CALL: Keyword |
3791 | ||
4755096e | 3792 | =item The BOOT: Keyword |
cb1a09d0 | 3793 | |
4755096e | 3794 | =item The VERSIONCHECK: Keyword |
cb1a09d0 | 3795 | |
4755096e | 3796 | =item The PROTOTYPES: Keyword |
cb1a09d0 | 3797 | |
4755096e | 3798 | =item The PROTOTYPE: Keyword |
a45bd81d | 3799 | |
4755096e | 3800 | =item The ALIAS: Keyword |
cb1a09d0 | 3801 | |
4755096e | 3802 | =item The INTERFACE: Keyword |
a45bd81d | 3803 | |
4755096e | 3804 | =item The INTERFACE_MACRO: Keyword |
cb1a09d0 | 3805 | |
4755096e | 3806 | =item The INCLUDE: Keyword |
cb1a09d0 | 3807 | |
4755096e | 3808 | =item The CASE: Keyword |
cb1a09d0 | 3809 | |
4755096e | 3810 | =item The & Unary Operator |
cb1a09d0 | 3811 | |
4755096e | 3812 | =item Inserting Comments and C Preprocessor Directives |
cb1a09d0 | 3813 | |
4755096e | 3814 | =item Using XS With C++ |
cb1a09d0 | 3815 | |
4755096e | 3816 | =item Interface Strategy |
cb1a09d0 | 3817 | |
4755096e | 3818 | =item Perl Objects And C Structures |
14218588 | 3819 | |
4755096e | 3820 | =item The Typemap |
cb1a09d0 | 3821 | |
8ebc5c01 | 3822 | =back |
cb1a09d0 | 3823 | |
4755096e GS |
3824 | =item EXAMPLES |
3825 | ||
3826 | =item XS VERSION | |
3827 | ||
3828 | =item AUTHOR | |
14218588 | 3829 | |
a45bd81d GS |
3830 | =back |
3831 | ||
4755096e | 3832 | =head2 perlguts - Introduction to the Perl API |
cb1a09d0 | 3833 | |
d420ca49 | 3834 | =over 4 |
a45bd81d | 3835 | |
8ebc5c01 | 3836 | =item DESCRIPTION |
cb1a09d0 | 3837 | |
4755096e | 3838 | =item Variables |
cb1a09d0 | 3839 | |
d420ca49 | 3840 | =over 4 |
cb1a09d0 | 3841 | |
4755096e | 3842 | =item Datatypes |
cb1a09d0 | 3843 | |
4755096e | 3844 | =item What is an "IV"? |
cb1a09d0 | 3845 | |
4755096e | 3846 | =item Working with SVs |
cb1a09d0 | 3847 | |
37d4d706 JH |
3848 | =item Offsets |
3849 | ||
4755096e | 3850 | =item What's Really Stored in an SV? |
cb1a09d0 | 3851 | |
4755096e | 3852 | =item Working with AVs |
cb1a09d0 | 3853 | |
4755096e | 3854 | =item Working with HVs |
cb1a09d0 | 3855 | |
4755096e | 3856 | =item Hash API Extensions |
cb1a09d0 | 3857 | |
4755096e | 3858 | =item References |
cb1a09d0 | 3859 | |
4755096e | 3860 | =item Blessed References and Class Objects |
774d564b | 3861 | |
4755096e | 3862 | =item Creating New Variables |
cb1a09d0 | 3863 | |
4755096e | 3864 | =item Reference Counts and Mortality |
a45bd81d | 3865 | |
4755096e | 3866 | =item Stashes and Globs |
cb1a09d0 | 3867 | |
4755096e | 3868 | =item Double-Typed SVs |
a45bd81d | 3869 | |
4755096e | 3870 | =item Magic Variables |
cb1a09d0 | 3871 | |
4755096e | 3872 | =item Assigning Magic |
cb1a09d0 | 3873 | |
4755096e | 3874 | =item Magic Virtual Tables |
cb1a09d0 | 3875 | |
4755096e | 3876 | =item Finding Magic |
cb1a09d0 | 3877 | |
4755096e | 3878 | =item Understanding the Magic of Tied Hashes and Arrays |
cb1a09d0 | 3879 | |
4755096e | 3880 | =item Localizing changes |
cb1a09d0 | 3881 | |
4755096e GS |
3882 | C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>, |
3883 | C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP | |
3884 | *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char | |
3885 | *key, I32 length)>, C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void | |
3886 | *p)>, C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, | |
3887 | C<SV* save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV | |
3888 | *gv)>, C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 | |
3889 | maxsarg)>, C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, | |
3890 | C<void save_hptr(HV **hptr)> | |
cb1a09d0 | 3891 | |
4755096e | 3892 | =back |
cb1a09d0 | 3893 | |
4755096e | 3894 | =item Subroutines |
cb1a09d0 | 3895 | |
d420ca49 | 3896 | =over 4 |
cb1a09d0 | 3897 | |
4755096e | 3898 | =item XSUBs and the Argument Stack |
cb1a09d0 | 3899 | |
4755096e | 3900 | =item Calling Perl Routines from within C Programs |
cb1a09d0 | 3901 | |
4755096e | 3902 | =item Memory Allocation |
cb1a09d0 | 3903 | |
4755096e | 3904 | =item PerlIO |
cb1a09d0 | 3905 | |
4755096e | 3906 | =item Putting a C value on Perl stack |
cb1a09d0 | 3907 | |
4755096e | 3908 | =item Scratchpads |
cb1a09d0 | 3909 | |
4755096e | 3910 | =item Scratchpads and recursion |
cb1a09d0 | 3911 | |
4755096e | 3912 | =back |
cb1a09d0 | 3913 | |
4755096e | 3914 | =item Compiled code |
cb1a09d0 | 3915 | |
d420ca49 | 3916 | =over 4 |
cb1a09d0 | 3917 | |
4755096e | 3918 | =item Code tree |
cb1a09d0 | 3919 | |
4755096e | 3920 | =item Examining the tree |
cb1a09d0 | 3921 | |
4755096e | 3922 | =item Compile pass 1: check routines |
cb1a09d0 | 3923 | |
4755096e | 3924 | =item Compile pass 1a: constant folding |
cb1a09d0 | 3925 | |
4755096e | 3926 | =item Compile pass 2: context propagation |
cb1a09d0 | 3927 | |
4755096e | 3928 | =item Compile pass 3: peephole optimization |
cb1a09d0 | 3929 | |
4755096e | 3930 | =back |
cb1a09d0 | 3931 | |
4755096e | 3932 | =item How multiple interpreters and concurrency are supported |
cb1a09d0 | 3933 | |
d420ca49 | 3934 | =over 4 |
cb1a09d0 | 3935 | |
4755096e | 3936 | =item Background and PERL_IMPLICIT_CONTEXT |
cb1a09d0 | 3937 | |
4755096e | 3938 | =item How do I use all this in extensions? |
cb1a09d0 | 3939 | |
4755096e | 3940 | =item Future Plans and PERL_IMPLICIT_SYS |
cb1a09d0 | 3941 | |
4755096e | 3942 | =back |
fb9cefb4 | 3943 | |
7029d033 JH |
3944 | =item Internal Functions |
3945 | ||
3946 | A, p, d, s, n, r, f, m, o, j, x | |
3947 | ||
d420ca49 | 3948 | =over 4 |
7029d033 | 3949 | |
a9ef4385 | 3950 | =item Formatted Printing of IVs, UVs, and NVs |
91e74348 | 3951 | |
9fa7f388 JH |
3952 | =item Pointer-To-Integer and Integer-To-Pointer |
3953 | ||
7029d033 JH |
3954 | =item Source Documentation |
3955 | ||
3956 | =back | |
3957 | ||
3958 | =item Unicode Support | |
3959 | ||
d420ca49 | 3960 | =over 4 |
7029d033 JH |
3961 | |
3962 | =item What B<is> Unicode, anyway? | |
3963 | ||
3964 | =item How can I recognise a UTF8 string? | |
3965 | ||
3966 | =item How does UTF8 represent Unicode characters? | |
3967 | ||
3968 | =item How does Perl store UTF8 strings? | |
3969 | ||
3970 | =item How do I convert a string to UTF8? | |
3971 | ||
3972 | =item Is there anything else I need to know? | |
3973 | ||
3974 | =back | |
3975 | ||
4755096e | 3976 | =item AUTHORS |
fb9cefb4 | 3977 | |
4755096e | 3978 | =item SEE ALSO |
cb1a09d0 | 3979 | |
4755096e | 3980 | =back |
cb1a09d0 | 3981 | |
4755096e | 3982 | =head2 perlcall - Perl calling conventions from C |
193fb0af | 3983 | |
d420ca49 | 3984 | =over 4 |
cb1a09d0 | 3985 | |
4755096e | 3986 | =item DESCRIPTION |
68dc0745 | 3987 | |
4755096e | 3988 | An Error Handler, An Event Driven Program |
193fb0af | 3989 | |
4755096e | 3990 | =item THE CALL_ FUNCTIONS |
cb1a09d0 | 3991 | |
4755096e | 3992 | call_sv, call_pv, call_method, call_argv |
a45bd81d | 3993 | |
4755096e | 3994 | =item FLAG VALUES |
cb1a09d0 | 3995 | |
d420ca49 | 3996 | =over 4 |
a45bd81d | 3997 | |
4755096e | 3998 | =item G_VOID |
cb1a09d0 | 3999 | |
4755096e | 4000 | =item G_SCALAR |
55497cff | 4001 | |
4755096e | 4002 | =item G_ARRAY |
cb1a09d0 | 4003 | |
4755096e | 4004 | =item G_DISCARD |
cb1a09d0 | 4005 | |
4755096e | 4006 | =item G_NOARGS |
c76ac1ee | 4007 | |
4755096e | 4008 | =item G_EVAL |
14218588 | 4009 | |
4755096e | 4010 | =item G_KEEPERR |
cb1a09d0 | 4011 | |
4755096e | 4012 | =item Determining the Context |
7d2bfb28 | 4013 | |
4755096e | 4014 | =back |
cb1a09d0 | 4015 | |
4755096e | 4016 | =item KNOWN PROBLEMS |
cb1a09d0 | 4017 | |
4755096e | 4018 | =item EXAMPLES |
fb9cefb4 | 4019 | |
d420ca49 | 4020 | =over 4 |
a45bd81d | 4021 | |
4755096e | 4022 | =item No Parameters, Nothing returned |
a45bd81d | 4023 | |
4755096e | 4024 | =item Passing Parameters |
fb9cefb4 | 4025 | |
4755096e | 4026 | =item Returning a Scalar |
cb1a09d0 | 4027 | |
4755096e | 4028 | =item Returning a list of values |
14218588 | 4029 | |
4755096e | 4030 | =item Returning a list in a scalar context |
14218588 | 4031 | |
4755096e | 4032 | =item Returning Data from Perl via the parameter list |
a45bd81d | 4033 | |
4755096e | 4034 | =item Using G_EVAL |
cb1a09d0 | 4035 | |
4755096e | 4036 | =item Using G_KEEPERR |
a45bd81d | 4037 | |
4755096e | 4038 | =item Using call_sv |
cb1a09d0 | 4039 | |
4755096e | 4040 | =item Using call_argv |
cb1a09d0 | 4041 | |
4755096e | 4042 | =item Using call_method |
cb1a09d0 | 4043 | |
4755096e | 4044 | =item Using GIMME_V |
68dc0745 | 4045 | |
4755096e | 4046 | =item Using Perl to dispose of temporaries |
68dc0745 | 4047 | |
4755096e | 4048 | =item Strategies for storing Callback Context Information |
193fb0af | 4049 | |
4755096e GS |
4050 | 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of |
4051 | callbacks - hard wired limit, 3. Use a parameter to map to the Perl | |
4052 | callback | |
cb1a09d0 | 4053 | |
4755096e GS |
4054 | =item Alternate Stack Manipulation |
4055 | ||
4056 | =item Creating and calling an anonymous subroutine in C | |
cb1a09d0 AD |
4057 | |
4058 | =back | |
4059 | ||
4755096e | 4060 | =item SEE ALSO |
1e422769 | 4061 | |
4755096e GS |
4062 | =item AUTHOR |
4063 | ||
4064 | =item DATE | |
1e422769 | 4065 | |
a45bd81d GS |
4066 | =back |
4067 | ||
4755096e | 4068 | =head2 perlutil - utilities packaged with the Perl distribution |
cb1a09d0 | 4069 | |
d420ca49 | 4070 | =over 4 |
a45bd81d | 4071 | |
cb1a09d0 AD |
4072 | =item DESCRIPTION |
4073 | ||
d420ca49 | 4074 | =over 4 |
cb1a09d0 | 4075 | |
4755096e GS |
4076 | =item DOCUMENTATION |
4077 | ||
4078 | L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>, | |
4079 | L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>, | |
4080 | L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>, | |
4081 | L<roffitall|roffitall> | |
4082 | ||
4083 | =item CONVERTORS | |
cb1a09d0 | 4084 | |
4755096e | 4085 | L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl> |
cb1a09d0 | 4086 | |
4755096e | 4087 | =item Development |
14218588 | 4088 | |
4755096e GS |
4089 | L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>, |
4090 | L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc> | |
cb1a09d0 | 4091 | |
4755096e | 4092 | =item SEE ALSO |
cb1a09d0 AD |
4093 | |
4094 | =back | |
4095 | ||
a45bd81d GS |
4096 | =back |
4097 | ||
4755096e | 4098 | =head2 perlfilter - Source Filters |
cb1a09d0 | 4099 | |
d420ca49 | 4100 | =over 4 |
a45bd81d | 4101 | |
cb1a09d0 AD |
4102 | =item DESCRIPTION |
4103 | ||
4755096e | 4104 | =item CONCEPTS |
cb1a09d0 | 4105 | |
4755096e | 4106 | =item USING FILTERS |
cb1a09d0 | 4107 | |
4755096e | 4108 | =item WRITING A SOURCE FILTER |
cb1a09d0 | 4109 | |
4755096e | 4110 | =item WRITING A SOURCE FILTER IN C |
fb9cefb4 | 4111 | |
4755096e | 4112 | B<Decryption Filters> |
14218588 | 4113 | |
4755096e | 4114 | =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE |
cb1a09d0 | 4115 | |
4755096e GS |
4116 | =item WRITING A SOURCE FILTER IN PERL |
4117 | ||
4118 | =item USING CONTEXT: THE DEBUG FILTER | |
4119 | ||
4120 | =item CONCLUSION | |
4121 | ||
4122 | =item REQUIREMENTS | |
4123 | ||
4124 | =item AUTHOR | |
4125 | ||
4126 | =item Copyrights | |
14218588 | 4127 | |
a45bd81d GS |
4128 | =back |
4129 | ||
4755096e | 4130 | =head2 perldbmfilter - Perl DBM Filters |
cb1a09d0 | 4131 | |
d420ca49 | 4132 | =over 4 |
a45bd81d | 4133 | |
cb1a09d0 AD |
4134 | =item SYNOPSIS |
4135 | ||
cb1a09d0 AD |
4136 | =item DESCRIPTION |
4137 | ||
4755096e GS |
4138 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, |
4139 | B<filter_fetch_value> | |
cb1a09d0 | 4140 | |
d420ca49 | 4141 | =over 4 |
193fb0af | 4142 | |
4755096e | 4143 | =item The Filter |
cb1a09d0 | 4144 | |
4755096e | 4145 | =item An Example -- the NULL termination problem. |
c76ac1ee | 4146 | |
4755096e | 4147 | =item Another Example -- Key is a C int. |
cb1a09d0 | 4148 | |
4755096e | 4149 | =back |
193fb0af | 4150 | |
4755096e | 4151 | =item SEE ALSO |
193fb0af | 4152 | |
4755096e | 4153 | =item AUTHOR |
cb1a09d0 | 4154 | |
4755096e | 4155 | =back |
cb1a09d0 | 4156 | |
4755096e | 4157 | =head2 perlapi - autogenerated documentation for the perl public API |
44a8e56a | 4158 | |
d420ca49 | 4159 | =over 4 |
cb1a09d0 | 4160 | |
4755096e | 4161 | =item DESCRIPTION |
cb1a09d0 | 4162 | |
7029d033 JH |
4163 | AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, |
4164 | av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, | |
4165 | bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy, | |
a7ffa9b9 NC |
4166 | croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, |
4167 | eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, | |
4168 | get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod, | |
7029d033 JH |
4169 | gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, |
4170 | G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, | |
4171 | HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, | |
4172 | hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, | |
4173 | hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, | |
4174 | hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, | |
4175 | isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, | |
4176 | MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, | |
4177 | mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, | |
91331b4f JH |
4178 | NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, |
4179 | newSVrv, newSVsv, newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, | |
4180 | Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_construct, perl_destruct, | |
4181 | perl_free, perl_parse, perl_run, PL_DBsingle, PL_DBsub, PL_DBtrace, | |
4182 | PL_dowarn, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, | |
4183 | POPl, POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, | |
4184 | PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, | |
4185 | SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, | |
4186 | strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, | |
4187 | SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, | |
4188 | SvIOK_UV, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, | |
4189 | SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, | |
4190 | SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, | |
7029d033 JH |
4191 | SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, |
4192 | SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, | |
d420ca49 | 4193 | SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, |
91331b4f JH |
4194 | SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUTF8, |
4195 | SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, | |
4196 | sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, | |
4197 | sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec, | |
4198 | sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, | |
4199 | sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy, | |
4200 | sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, | |
4201 | sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, | |
4202 | sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, | |
4203 | sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, | |
4204 | sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_true, | |
4205 | sv_unmagic, sv_unref, sv_upgrade, sv_usepvn, sv_usepvn_mg, | |
7029d033 | 4206 | sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_vcatpvfn, |
91331b4f | 4207 | sv_vsetpvfn, THIS, toLOWER, toUPPER, U8 *s, utf8_to_bytes, utf8_to_uv, |
d420ca49 AD |
4208 | utf8_to_uv_simple, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, |
4209 | XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, | |
4210 | XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, | |
4211 | XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero | |
c76ac1ee | 4212 | |
4755096e | 4213 | =item AUTHORS |
cb1a09d0 AD |
4214 | |
4215 | =item SEE ALSO | |
4216 | ||
a45bd81d GS |
4217 | =back |
4218 | ||
91331b4f | 4219 | =head2 perlintern - autogenerated documentation of purely B<internal> |
4755096e | 4220 | Perl functions |
cb1a09d0 | 4221 | |
d420ca49 | 4222 | =over 4 |
a45bd81d | 4223 | |
cb1a09d0 AD |
4224 | =item DESCRIPTION |
4225 | ||
4755096e GS |
4226 | is_gv_magical |
4227 | ||
4228 | =item AUTHORS | |
4229 | ||
4230 | =item SEE ALSO | |
4231 | ||
4232 | =back | |
4233 | ||
4234 | =head2 perlapio - perl's IO abstraction interface. | |
4235 | ||
d420ca49 | 4236 | =over 4 |
cb1a09d0 | 4237 | |
4755096e | 4238 | =item SYNOPSIS |
cb1a09d0 | 4239 | |
4755096e | 4240 | =item DESCRIPTION |
cb1a09d0 | 4241 | |
4755096e GS |
4242 | B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>, |
4243 | B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>, | |
4244 | B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, | |
4245 | B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, | |
4246 | B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, | |
4247 | B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, | |
4248 | B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, | |
4249 | B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>, | |
4250 | B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, | |
4251 | B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()> | |
cb1a09d0 | 4252 | |
d420ca49 | 4253 | =over 4 |
cb1a09d0 | 4254 | |
4755096e | 4255 | =item Co-existence with stdio |
cb1a09d0 | 4256 | |
4755096e GS |
4257 | B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>, |
4258 | B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>, | |
4259 | B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>, | |
4260 | B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>, | |
4261 | B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, | |
4262 | B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)> | |
cb1a09d0 | 4263 | |
4755096e | 4264 | =back |
c635e13b | 4265 | |
a45bd81d GS |
4266 | =back |
4267 | ||
4755096e | 4268 | =head2 perltodo - Perl TO-DO List |
c635e13b | 4269 | |
d420ca49 | 4270 | =over 4 |
a45bd81d | 4271 | |
c635e13b | 4272 | =item DESCRIPTION |
cb1a09d0 | 4273 | |
4755096e | 4274 | =item Infrastructure |
cb1a09d0 | 4275 | |
d420ca49 | 4276 | =over 4 |
cb1a09d0 | 4277 | |
4755096e | 4278 | =item Mailing list archives |
cb1a09d0 | 4279 | |
4755096e | 4280 | =item Bug tracking system |
cb1a09d0 | 4281 | |
4755096e | 4282 | =item Regression Tests |
cb1a09d0 | 4283 | |
4755096e GS |
4284 | Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to |
4285 | perl5 | |
cb1a09d0 | 4286 | |
4755096e GS |
4287 | =back |
4288 | ||
4289 | =item Configure | |
4290 | ||
d420ca49 | 4291 | =over 4 |
4755096e GS |
4292 | |
4293 | =item Install HTML | |
cb1a09d0 | 4294 | |
cb1a09d0 AD |
4295 | =back |
4296 | ||
4755096e | 4297 | =item Perl Language |
cb1a09d0 | 4298 | |
d420ca49 | 4299 | =over 4 |
4755096e GS |
4300 | |
4301 | =item 64-bit Perl | |
4302 | ||
4303 | =item Prototypes | |
4304 | ||
4305 | Named prototypes, Indirect objects, Method calls, Context, Scoped subs | |
8ebc5c01 | 4306 | |
4755096e GS |
4307 | =back |
4308 | ||
4309 | =item Perl Internals | |
cb1a09d0 | 4310 | |
d420ca49 | 4311 | =over 4 |
cb1a09d0 | 4312 | |
4755096e | 4313 | =item magic_setisa |
cb1a09d0 | 4314 | |
4755096e | 4315 | =item Garbage Collection |
cb1a09d0 | 4316 | |
4755096e | 4317 | =item Reliable signals |
cb1a09d0 | 4318 | |
4755096e GS |
4319 | Alternate runops() for signal despatch, Figure out how to die() in delayed |
4320 | sighandler, Add tests for Thread::Signal, Automatic tests against CPAN | |
cb1a09d0 | 4321 | |
4755096e | 4322 | =item Interpolated regex performance bugs |
cb1a09d0 | 4323 | |
4755096e | 4324 | =item Memory leaks from failed eval/regcomp |
cb1a09d0 | 4325 | |
4755096e | 4326 | =item Make XS easier to use |
cb1a09d0 | 4327 | |
4755096e GS |
4328 | =item Make embedded Perl easier to use |
4329 | ||
4330 | =item Namespace cleanup | |
4331 | ||
4332 | =item MULTIPLICITY | |
4333 | ||
4334 | =item MacPerl | |
c635e13b | 4335 | |
a45bd81d GS |
4336 | =back |
4337 | ||
4755096e | 4338 | =item Documentation |
fb9cefb4 | 4339 | |
d420ca49 | 4340 | =over 4 |
a45bd81d | 4341 | |
4755096e | 4342 | =item A clear division into tutorial and reference |
fb9cefb4 | 4343 | |
4755096e | 4344 | =item Remove the artificial distinction between operators and functions |
fb9cefb4 | 4345 | |
4755096e | 4346 | =item More tutorials |
fb9cefb4 | 4347 | |
4755096e | 4348 | Regular expressions, I/O, pack/unpack, Debugging |
fb9cefb4 | 4349 | |
4755096e | 4350 | =item Include a search tool |
fb9cefb4 | 4351 | |
4755096e | 4352 | =item Include a locate tool |
fb9cefb4 | 4353 | |
4755096e | 4354 | =item Separate function manpages by default |
fb9cefb4 | 4355 | |
4755096e GS |
4356 | =item Users can't find the manpages |
4357 | ||
4358 | =item Install ALL Documentation | |
4359 | ||
4360 | =item Outstanding issues to be documented | |
4361 | ||
4362 | =item Adapt www.linuxhq.com for Perl | |
4363 | ||
4364 | =item Replace man with a perl program | |
4365 | ||
4366 | =item Unicode tutorial | |
fb9cefb4 | 4367 | |
a45bd81d GS |
4368 | =back |
4369 | ||
4755096e | 4370 | =item Modules |
a45bd81d | 4371 | |
d420ca49 | 4372 | =over 4 |
a45bd81d | 4373 | |
4755096e | 4374 | =item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2 |
a45bd81d | 4375 | |
4755096e | 4376 | =item Module versions |
a45bd81d | 4377 | |
4755096e | 4378 | =item New modules |
a45bd81d | 4379 | |
4755096e | 4380 | =item Profiler |
a45bd81d | 4381 | |
4755096e | 4382 | =item Tie Modules |
a45bd81d | 4383 | |
4755096e | 4384 | VecArray, SubstrArray, VirtualArray, ShiftSplice |
a45bd81d | 4385 | |
4755096e | 4386 | =item Procedural options |
a45bd81d | 4387 | |
4755096e | 4388 | =item RPC |
a45bd81d | 4389 | |
4755096e | 4390 | =item y2k localtime/gmtime |
a45bd81d | 4391 | |
4755096e | 4392 | =item Export File::Find variables |
a45bd81d | 4393 | |
4755096e | 4394 | =item Ioctl |
a45bd81d | 4395 | |
4755096e | 4396 | =item Debugger attach/detach |
a45bd81d | 4397 | |
4755096e | 4398 | =item Regular Expression debugger |
a45bd81d | 4399 | |
4755096e GS |
4400 | =item Alternative RE Syntax |
4401 | ||
4402 | =item Bundled modules | |
4403 | ||
4404 | =item Expect | |
4405 | ||
4406 | =item GUI::Native | |
4407 | ||
4408 | =item Update semibroken auxiliary tools; h2ph, a2p, etc. | |
4409 | ||
4755096e GS |
4410 | =item pod2html |
4411 | ||
4412 | =item Podchecker | |
a45bd81d GS |
4413 | |
4414 | =back | |
4415 | ||
4755096e | 4416 | =item Tom's Wishes |
cb1a09d0 | 4417 | |
d420ca49 | 4418 | =over 4 |
a45bd81d | 4419 | |
4755096e | 4420 | =item Webperl |
cb1a09d0 | 4421 | |
4755096e | 4422 | =item Mobile agents |
cb1a09d0 | 4423 | |
4755096e GS |
4424 | =item POSIX on non-POSIX |
4425 | ||
4426 | =item Portable installations | |
cb1a09d0 | 4427 | |
8ebc5c01 | 4428 | =back |
cb1a09d0 | 4429 | |
4755096e | 4430 | =item Win32 Stuff |
cb1a09d0 | 4431 | |
d420ca49 | 4432 | =over 4 |
cb1a09d0 | 4433 | |
4755096e | 4434 | =item Rename new headers to be consistent with the rest |
cb1a09d0 | 4435 | |
4755096e | 4436 | =item Sort out the spawnvp() mess |
cb1a09d0 | 4437 | |
4755096e | 4438 | =item Work out DLL versioning |
cb1a09d0 | 4439 | |
4755096e | 4440 | =item Style-check |
cb1a09d0 | 4441 | |
a45bd81d GS |
4442 | =back |
4443 | ||
4755096e GS |
4444 | =item Would be nice to have |
4445 | ||
4446 | C<pack "(stuff)*">, Contiguous bitfields in pack/unpack, lexperl, Bundled | |
4447 | perl preprocessor, Use posix calls internally where possible, format | |
4448 | BOTTOM, -i rename file only when successfully changed, All ARGV input | |
4449 | should act like <>, report HANDLE [formats], support in perlmain to rerun | |
4450 | debugger, lvalue functions | |
4451 | ||
4452 | =item Possible pragmas | |
cb1a09d0 | 4453 | |
d420ca49 | 4454 | =over 4 |
a45bd81d | 4455 | |
4755096e | 4456 | =item 'less' |
cb1a09d0 | 4457 | |
4755096e | 4458 | =back |
cb1a09d0 | 4459 | |
4755096e | 4460 | =item Optimizations |
cb1a09d0 | 4461 | |
d420ca49 | 4462 | =over 4 |
cb1a09d0 | 4463 | |
4755096e | 4464 | =item constant function cache |
cb1a09d0 | 4465 | |
4755096e | 4466 | =item foreach(reverse...) |
cb1a09d0 | 4467 | |
4755096e | 4468 | =item Cache eval tree |
193fb0af | 4469 | |
4755096e | 4470 | =item rcatmaybe |
193fb0af | 4471 | |
4755096e | 4472 | =item Shrink opcode tables |
193fb0af | 4473 | |
4755096e | 4474 | =item Cache hash value |
193fb0af | 4475 | |
4755096e | 4476 | =item Optimize away @_ where possible |
193fb0af | 4477 | |
4755096e | 4478 | =item Optimize sort by { $a <=> $b } |
193fb0af | 4479 | |
4755096e | 4480 | =item Rewrite regexp parser for better integrated optimization |
cb1a09d0 | 4481 | |
8ebc5c01 | 4482 | =back |
cb1a09d0 | 4483 | |
4755096e | 4484 | =item Vague possibilities |
cb1a09d0 | 4485 | |
4755096e GS |
4486 | ref function in list context, make tr/// return histogram in list context?, |
4487 | Loop control on do{} et al, Explicit switch statements, compile to real | |
4488 | threaded code, structured types, Modifiable $1 et al | |
cb1a09d0 | 4489 | |
4755096e | 4490 | =item To Do Or Not To Do |
cb1a09d0 | 4491 | |
d420ca49 | 4492 | =over 4 |
cb1a09d0 | 4493 | |
4755096e | 4494 | =item Making my() work on "package" variables |
cb1a09d0 | 4495 | |
4755096e | 4496 | =item "or" testing defined not truth |
cb1a09d0 | 4497 | |
4755096e | 4498 | =item "dynamic" lexicals |
cb1a09d0 | 4499 | |
4755096e | 4500 | =item "class"-based, rather than package-based "lexicals" |
cb1a09d0 | 4501 | |
8ebc5c01 | 4502 | =back |
cb1a09d0 | 4503 | |
4755096e | 4504 | =item Threading |
cb1a09d0 | 4505 | |
d420ca49 | 4506 | =over 4 |
cb1a09d0 | 4507 | |
4755096e | 4508 | =item Modules |
cb1a09d0 | 4509 | |
4755096e | 4510 | =item Testing |
cb1a09d0 | 4511 | |
4755096e GS |
4512 | =item $AUTOLOAD |
4513 | ||
4514 | =item exit/die | |
4515 | ||
4516 | =item External threads | |
4517 | ||
4518 | =item Thread::Pool | |
4519 | ||
4520 | =item thread-safety | |
4521 | ||
4522 | =item Per-thread GVs | |
4523 | ||
4524 | =back | |
4525 | ||
4526 | =item Compiler | |
cb1a09d0 | 4527 | |
d420ca49 | 4528 | =over 4 |
cb1a09d0 | 4529 | |
4755096e | 4530 | =item Optimization |
cb1a09d0 | 4531 | |
4755096e | 4532 | =item Byteperl |
cb1a09d0 | 4533 | |
4755096e | 4534 | =item Precompiled modules |
cb1a09d0 | 4535 | |
4755096e | 4536 | =item Executables |
cb1a09d0 | 4537 | |
4755096e | 4538 | =item Typed lexicals |
cb1a09d0 | 4539 | |
4755096e | 4540 | =item Win32 |
cb1a09d0 | 4541 | |
4755096e GS |
4542 | =item END blocks |
4543 | ||
4544 | =item _AUTOLOAD | |
4545 | ||
4546 | =item comppadlist | |
4547 | ||
4548 | =item Cached compilation | |
cb1a09d0 AD |
4549 | |
4550 | =back | |
4551 | ||
4755096e | 4552 | =item Recently Finished Tasks |
cb1a09d0 | 4553 | |
d420ca49 | 4554 | =over 4 |
cb1a09d0 | 4555 | |
4755096e | 4556 | =item Figure a way out of $^(capital letter) |
cb1a09d0 | 4557 | |
4755096e | 4558 | =item Filenames |
cb1a09d0 | 4559 | |
4755096e | 4560 | =item Foreign lines |
cb1a09d0 | 4561 | |
4755096e GS |
4562 | =item Namespace cleanup |
4563 | ||
4564 | =item ISA.pm | |
4565 | ||
4566 | =item gettimeofday | |
4567 | ||
4568 | =item autocroak? | |
cb1a09d0 | 4569 | |
a45bd81d GS |
4570 | =back |
4571 | ||
4755096e GS |
4572 | =back |
4573 | ||
4574 | =head2 perlhack - How to hack at the Perl internals | |
cb1a09d0 | 4575 | |
d420ca49 | 4576 | =over 4 |
a45bd81d | 4577 | |
4755096e GS |
4578 | =item DESCRIPTION |
4579 | ||
4580 | Does concept match the general goals of Perl?, Where is the | |
4581 | implementation?, Backwards compatibility, Could it be a module instead?, Is | |
4582 | the feature generic enough?, Does it potentially introduce new bugs?, Does | |
4583 | it preclude other desirable features?, Is the implementation robust?, Is | |
4584 | the implementation generic enough to be portable?, Is there enough | |
4585 | documentation?, Is there another way to do it?, Does it create too much | |
d420ca49 AD |
4586 | work?, Patches speak louder than words |
4587 | ||
4588 | =over 4 | |
4589 | ||
4590 | =item Keeping in sync | |
4591 | ||
4592 | rsync'ing the source tree, Using rsync over the LAN, Using pushing over the | |
4593 | NFS, rsync'ing the patches | |
4755096e | 4594 | |
d420ca49 AD |
4595 | =item Why rsync the source tree |
4596 | ||
4597 | It's easier, It's more recent, It's more reliable | |
4598 | ||
4599 | =item Why rsync the patches | |
4600 | ||
4601 | It's easier, It's a good reference, Finding a start point, Finding how to | |
4602 | fix a bug, Finding the source of misbehaviour | |
4603 | ||
4604 | =item Submitting patches | |
4605 | ||
4606 | L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>, | |
4607 | F<Porting/pumpkin.pod>, The perl5-porters FAQ | |
cb1a09d0 | 4608 | |
7029d033 | 4609 | =item Finding Your Way Around |
cb1a09d0 | 4610 | |
7029d033 | 4611 | Core modules, Documentation, Configure, Interpreter |
4755096e | 4612 | |
7029d033 | 4613 | =item Elements of the interpreter |
4755096e | 4614 | |
7029d033 | 4615 | Startup, Parsing, Optimization, Running |
4755096e | 4616 | |
7029d033 | 4617 | =item Internal Variable Types |
4755096e | 4618 | |
7029d033 | 4619 | =item Op Trees |
4755096e | 4620 | |
7029d033 | 4621 | =item Stacks |
4755096e | 4622 | |
7029d033 | 4623 | Argument stack, Mark stack, Save stack |
4755096e | 4624 | |
7029d033 | 4625 | =item Millions of Macros |
4755096e | 4626 | |
7029d033 | 4627 | =item Poking at Perl |
4755096e | 4628 | |
7029d033 | 4629 | =item Using a source-level debugger |
4755096e | 4630 | |
7029d033 | 4631 | run [args], break function_name, break source.c:xxx, step, next, continue, |
d420ca49 | 4632 | finish, 'enter', print |
4755096e | 4633 | |
7029d033 | 4634 | =item Dumping Perl Data Structures |
4755096e | 4635 | |
7029d033 | 4636 | =item Patching |
cb1a09d0 | 4637 | |
91331b4f JH |
4638 | =back |
4639 | ||
4640 | =item EXTERNAL TOOLS FOR DEBUGGING PERL | |
4641 | ||
d420ca49 | 4642 | =over 4 |
91331b4f JH |
4643 | |
4644 | =item Rational Software's Purify | |
4645 | ||
4646 | =item Purify on Unix | |
4647 | ||
4648 | -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity | |
4649 | ||
4650 | =item Purify on NT | |
4651 | ||
4652 | DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug | |
4653 | ||
7029d033 | 4654 | =item CONCLUSION |
cb1a09d0 | 4655 | |
7029d033 | 4656 | I<The Road goes ever on and on, down from the door where it began.> |
cb1a09d0 | 4657 | |
8ebc5c01 | 4658 | =back |
cb1a09d0 | 4659 | |
7029d033 | 4660 | =item AUTHOR |
cb1a09d0 AD |
4661 | |
4662 | =back | |
4663 | ||
7029d033 | 4664 | =head2 perlhist - the Perl history records |
7d2bfb28 | 4665 | |
d420ca49 | 4666 | =over 4 |
7d2bfb28 | 4667 | |
7029d033 | 4668 | =item DESCRIPTION |
cb1a09d0 | 4669 | |
7029d033 | 4670 | =item INTRODUCTION |
cb1a09d0 | 4671 | |
7029d033 | 4672 | =item THE KEEPERS OF THE PUMPKIN |
cb1a09d0 | 4673 | |
d420ca49 | 4674 | =over 4 |
cb1a09d0 | 4675 | |
7029d033 | 4676 | =item PUMPKIN? |
cb1a09d0 | 4677 | |
a45bd81d GS |
4678 | =back |
4679 | ||
7029d033 | 4680 | =item THE RECORDS |
cb1a09d0 | 4681 | |
d420ca49 | 4682 | =over 4 |
cb1a09d0 | 4683 | |
7029d033 | 4684 | =item SELECTED RELEASE SIZES |
cb1a09d0 | 4685 | |
7029d033 | 4686 | =item SELECTED PATCH SIZES |
cb1a09d0 | 4687 | |
7029d033 | 4688 | =back |
cb1a09d0 | 4689 | |
7029d033 | 4690 | =item THE KEEPERS OF THE RECORDS |
cb1a09d0 | 4691 | |
a45bd81d GS |
4692 | =back |
4693 | ||
a9ef4385 | 4694 | =head2 perldelta - what's new for perl v5.7.0 |
694468e3 | 4695 | |
d420ca49 | 4696 | =over 4 |
694468e3 | 4697 | |
7029d033 | 4698 | =item DESCRIPTION |
694468e3 | 4699 | |
a9ef4385 JH |
4700 | =item Security Vulnerability Closed |
4701 | ||
4702 | =item Incompatible Changes | |
4703 | ||
7029d033 | 4704 | =item Core Enhancements |
694468e3 | 4705 | |
7029d033 | 4706 | =item Modules and Pragmata |
694468e3 | 4707 | |
d420ca49 | 4708 | =over 4 |
a9ef4385 JH |
4709 | |
4710 | =item New Modules | |
4711 | ||
4712 | =item Updated And Improved Modules and Pragmata | |
4713 | ||
4714 | =back | |
4715 | ||
7029d033 | 4716 | =item Utility Changes |
694468e3 | 4717 | |
a9ef4385 | 4718 | =item New Documentation |
694468e3 | 4719 | |
a9ef4385 | 4720 | =item Performance Enhancements |
694468e3 | 4721 | |
d46b76b3 JH |
4722 | sort() has been changed to use mergesort internally as opposed to the |
4723 | earlier quicksort. For very small lists this may result in slightly slower | |
91331b4f | 4724 | sorting times, but in general the speedup should be at least 20%. |
d46b76b3 JH |
4725 | Additional bonuses are that the worst case behaviour of sort() is now |
4726 | better (in computer science terms it now runs in time O(N log N), as | |
91331b4f | 4727 | opposed to quicksort's Theta(N**2) worst-case run time behaviour), and that |
d46b76b3 JH |
4728 | sort() is now stable (meaning that elements with identical keys will stay |
4729 | ordered as they were before the sort) | |
4730 | ||
7029d033 | 4731 | =item Installation and Configuration Improvements |
694468e3 | 4732 | |
d420ca49 | 4733 | =over 4 |
694468e3 | 4734 | |
a9ef4385 | 4735 | =item Generic Improvements |
694468e3 | 4736 | |
4755096e | 4737 | =back |
694468e3 | 4738 | |
a9ef4385 | 4739 | =item Selected Bug Fixes |
694468e3 | 4740 | |
a9ef4385 JH |
4741 | sort() arguments are now compiled in the right wantarray context (they were |
4742 | accidentally using the context of the sort() itself) | |
694468e3 | 4743 | |
d420ca49 | 4744 | =over 4 |
cb1a09d0 | 4745 | |
a9ef4385 | 4746 | =item Platform Specific Changes and Fixes |
cb1a09d0 | 4747 | |
a9ef4385 | 4748 | =back |
cb1a09d0 | 4749 | |
a9ef4385 JH |
4750 | =item New or Changed Diagnostics |
4751 | ||
4752 | =item Changed Internals | |
cb1a09d0 | 4753 | |
4755096e | 4754 | =item Known Problems |
cb1a09d0 | 4755 | |
d420ca49 | 4756 | =over 4 |
a9ef4385 JH |
4757 | |
4758 | =item Unicode Support Still Far From Perfect | |
4759 | ||
4760 | =item EBCDIC Still A Lost Platform | |
4761 | ||
4762 | =item Building Extensions Can Fail Because Of Largefiles | |
4763 | ||
93d73c42 JH |
4764 | =item ftmp-security tests warn 'system possibly insecure' |
4765 | ||
b3b6085d PP |
4766 | =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX |
4767 | ||
93d73c42 | 4768 | =item Long Doubles Still Don't Work In Solaris |
9fa7f388 | 4769 | |
b3b6085d PP |
4770 | =item Linux With Sfio Fails op/misc Test 48 |
4771 | ||
9fa7f388 | 4772 | =item Storable tests fail in some platforms |
a9ef4385 | 4773 | |
93d73c42 JH |
4774 | =item Threads Are Still Experimental |
4775 | ||
4776 | =item The Compiler Suite Is Still Experimental | |
4777 | ||
a9ef4385 | 4778 | =back |
193fb0af | 4779 | |
4755096e | 4780 | =item Reporting Bugs |
8ebc5c01 | 4781 | |
4755096e | 4782 | =item SEE ALSO |
8ebc5c01 | 4783 | |
4755096e | 4784 | =item HISTORY |
8ebc5c01 | 4785 | |
a45bd81d GS |
4786 | =back |
4787 | ||
4755096e | 4788 | =head2 perl56delta, perldelta - what's new for perl v5.6.0 |
14218588 | 4789 | |
d420ca49 | 4790 | =over 4 |
a45bd81d | 4791 | |
14218588 GS |
4792 | =item DESCRIPTION |
4793 | ||
4755096e | 4794 | =item Core Enhancements |
14218588 | 4795 | |
d420ca49 | 4796 | =over 4 |
14218588 | 4797 | |
4755096e | 4798 | =item Interpreter cloning, threads, and concurrency |
14218588 | 4799 | |
4755096e | 4800 | =item Lexically scoped warning categories |
14218588 | 4801 | |
4755096e | 4802 | =item Unicode and UTF-8 support |
14218588 | 4803 | |
4755096e | 4804 | =item Support for interpolating named characters |
14218588 | 4805 | |
4755096e | 4806 | =item "our" declarations |
14218588 | 4807 | |
4755096e | 4808 | =item Support for strings represented as a vector of ordinals |
14218588 | 4809 | |
4755096e | 4810 | =item Improved Perl version numbering system |
14218588 | 4811 | |
4755096e | 4812 | =item New syntax for declaring subroutine attributes |
14218588 | 4813 | |
4755096e | 4814 | =item File and directory handles can be autovivified |
14218588 | 4815 | |
4755096e | 4816 | =item open() with more than two arguments |
14218588 | 4817 | |
4755096e | 4818 | =item 64-bit support |
14218588 | 4819 | |
4755096e | 4820 | =item Large file support |
14218588 | 4821 | |
4755096e | 4822 | =item Long doubles |
14218588 | 4823 | |
4755096e | 4824 | =item "more bits" |
14218588 | 4825 | |
4755096e | 4826 | =item Enhanced support for sort() subroutines |
14218588 | 4827 | |
4755096e | 4828 | =item C<sort $coderef @foo> allowed |
14218588 | 4829 | |
4755096e | 4830 | =item File globbing implemented internally |
14218588 | 4831 | |
4755096e | 4832 | =item Support for CHECK blocks |
14218588 | 4833 | |
4755096e | 4834 | =item POSIX character class syntax [: :] supported |
14218588 | 4835 | |
4755096e | 4836 | =item Better pseudo-random number generator |
a45bd81d | 4837 | |
4755096e | 4838 | =item Improved C<qw//> operator |
8ebc5c01 | 4839 | |
4755096e | 4840 | =item Better worst-case behavior of hashes |
a45bd81d | 4841 | |
4755096e | 4842 | =item pack() format 'Z' supported |
8ebc5c01 | 4843 | |
4755096e | 4844 | =item pack() format modifier '!' supported |
8ebc5c01 | 4845 | |
4755096e | 4846 | =item pack() and unpack() support counted strings |
8ebc5c01 | 4847 | |
4755096e | 4848 | =item Comments in pack() templates |
8ebc5c01 | 4849 | |
4755096e | 4850 | =item Weak references |
8ebc5c01 | 4851 | |
4755096e | 4852 | =item Binary numbers supported |
8ebc5c01 | 4853 | |
4755096e | 4854 | =item Lvalue subroutines |
14218588 | 4855 | |
4755096e | 4856 | =item Some arrows may be omitted in calls through references |
8ebc5c01 | 4857 | |
4755096e | 4858 | =item Boolean assignment operators are legal lvalues |
8ebc5c01 | 4859 | |
4755096e | 4860 | =item exists() is supported on subroutine names |
8ebc5c01 | 4861 | |
4755096e | 4862 | =item exists() and delete() are supported on array elements |
cb1a09d0 | 4863 | |
4755096e | 4864 | =item Pseudo-hashes work better |
cb1a09d0 | 4865 | |
4755096e | 4866 | =item Automatic flushing of output buffers |
cb1a09d0 | 4867 | |
4755096e | 4868 | =item Better diagnostics on meaningless filehandle operations |
cb1a09d0 | 4869 | |
4755096e | 4870 | =item Where possible, buffered data discarded from duped input filehandle |
a45bd81d | 4871 | |
4755096e | 4872 | =item eof() has the same old magic as <> |
cb1a09d0 | 4873 | |
4755096e | 4874 | =item binmode() can be used to set :crlf and :raw modes |
a45bd81d | 4875 | |
4755096e | 4876 | =item C<-T> filetest recognizes UTF-8 encoded files as "text" |
cb1a09d0 | 4877 | |
4755096e | 4878 | =item system(), backticks and pipe open now reflect exec() failure |
cb1a09d0 | 4879 | |
4755096e | 4880 | =item Improved diagnostics |
cb1a09d0 | 4881 | |
4755096e | 4882 | =item Diagnostics follow STDERR |
cb1a09d0 | 4883 | |
4755096e | 4884 | =item More consistent close-on-exec behavior |
cb1a09d0 | 4885 | |
4755096e | 4886 | =item syswrite() ease-of-use |
cb1a09d0 | 4887 | |
4755096e | 4888 | =item Better syntax checks on parenthesized unary operators |
cb1a09d0 | 4889 | |
4755096e | 4890 | =item Bit operators support full native integer width |
cb1a09d0 | 4891 | |
4755096e | 4892 | =item Improved security features |
cb1a09d0 | 4893 | |
4755096e | 4894 | =item More functional bareword prototype (*) |
cb1a09d0 | 4895 | |
4755096e | 4896 | =item C<require> and C<do> may be overridden |
cb1a09d0 | 4897 | |
4755096e | 4898 | =item $^X variables may now have names longer than one character |
4fdae800 | 4899 | |
4755096e | 4900 | =item New variable $^C reflects C<-c> switch |
cb1a09d0 | 4901 | |
4755096e | 4902 | =item New variable $^V contains Perl version as a string |
cb1a09d0 | 4903 | |
4755096e | 4904 | =item Optional Y2K warnings |
cb1a09d0 | 4905 | |
4755096e | 4906 | =item Arrays now always interpolate into double-quoted strings |
cb1a09d0 | 4907 | |
a45bd81d GS |
4908 | =back |
4909 | ||
4755096e | 4910 | =item Modules and Pragmata |
cb1a09d0 | 4911 | |
d420ca49 | 4912 | =over 4 |
a45bd81d | 4913 | |
4755096e | 4914 | =item Modules |
cb1a09d0 | 4915 | |
4755096e GS |
4916 | attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper, |
4917 | DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English, | |
4918 | Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec, | |
4919 | File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt, | |
4920 | Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker, | |
4921 | podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage, | |
4922 | pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, | |
4923 | Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters | |
cb1a09d0 | 4924 | |
4755096e | 4925 | =item Pragmata |
cb1a09d0 | 4926 | |
4755096e | 4927 | =back |
cb1a09d0 | 4928 | |
4755096e | 4929 | =item Utility Changes |
cb1a09d0 | 4930 | |
d420ca49 | 4931 | =over 4 |
cb1a09d0 | 4932 | |
4755096e | 4933 | =item dprofpp |
cb1a09d0 | 4934 | |
4755096e | 4935 | =item find2perl |
cb1a09d0 | 4936 | |
4755096e | 4937 | =item h2xs |
cb1a09d0 | 4938 | |
4755096e | 4939 | =item perlcc |
cb1a09d0 | 4940 | |
4755096e GS |
4941 | =item perldoc |
4942 | ||
4943 | =item The Perl Debugger | |
cb1a09d0 | 4944 | |
a45bd81d GS |
4945 | =back |
4946 | ||
4755096e | 4947 | =item Improved Documentation |
cb1a09d0 | 4948 | |
4755096e GS |
4949 | perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod, |
4950 | perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod, | |
4951 | perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod, | |
4952 | perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod | |
a45bd81d | 4953 | |
4755096e | 4954 | =item Performance enhancements |
cb1a09d0 | 4955 | |
d420ca49 | 4956 | =over 4 |
cb1a09d0 | 4957 | |
4755096e | 4958 | =item Simple sort() using { $a <=> $b } and the like are optimized |
cb1a09d0 | 4959 | |
4755096e | 4960 | =item Optimized assignments to lexical variables |
193fb0af | 4961 | |
4755096e GS |
4962 | =item Faster subroutine calls |
4963 | ||
4964 | =item delete(), each(), values() and hash iteration are faster | |
193fb0af GS |
4965 | |
4966 | =back | |
4967 | ||
4755096e | 4968 | =item Installation and Configuration Improvements |
cb1a09d0 | 4969 | |
d420ca49 | 4970 | =over 4 |
cb1a09d0 | 4971 | |
4755096e | 4972 | =item -Dusethreads means something different |
68dc0745 | 4973 | |
4755096e | 4974 | =item New Configure flags |
68dc0745 | 4975 | |
4755096e | 4976 | =item Threadedness and 64-bitness now more daring |
68dc0745 | 4977 | |
4755096e | 4978 | =item Long Doubles |
cb1a09d0 | 4979 | |
4755096e | 4980 | =item -Dusemorebits |
55497cff | 4981 | |
4755096e GS |
4982 | =item -Duselargefiles |
4983 | ||
4984 | =item installusrbinperl | |
4985 | ||
4986 | =item SOCKS support | |
4987 | ||
4988 | =item C<-A> flag | |
4989 | ||
4990 | =item Enhanced Installation Directories | |
193fb0af | 4991 | |
8ebc5c01 | 4992 | =back |
4993 | ||
4755096e | 4994 | =item Platform specific changes |
55497cff | 4995 | |
d420ca49 | 4996 | =over 4 |
cb1a09d0 | 4997 | |
4755096e | 4998 | =item Supported platforms |
193fb0af | 4999 | |
4755096e | 5000 | =item DOS |
55497cff | 5001 | |
4755096e GS |
5002 | =item OS390 (OpenEdition MVS) |
5003 | ||
5004 | =item VMS | |
5005 | ||
5006 | =item Win32 | |
55497cff | 5007 | |
c90c0ff4 | 5008 | =back |
5009 | ||
4755096e | 5010 | =item Significant bug fixes |
c90c0ff4 | 5011 | |
d420ca49 | 5012 | =over 4 |
c90c0ff4 | 5013 | |
4755096e | 5014 | =item <HANDLE> on empty files |
c90c0ff4 | 5015 | |
4755096e | 5016 | =item C<eval '...'> improvements |
c90c0ff4 | 5017 | |
4755096e | 5018 | =item All compilation errors are true errors |
c90c0ff4 | 5019 | |
4755096e | 5020 | =item Implicitly closed filehandles are safer |
cb1a09d0 | 5021 | |
4755096e | 5022 | =item Behavior of list slices is more consistent |
cb1a09d0 | 5023 | |
4755096e | 5024 | =item C<(\$)> prototype and C<$foo{a}> |
cb1a09d0 | 5025 | |
4755096e | 5026 | =item C<goto &sub> and AUTOLOAD |
c90c0ff4 | 5027 | |
4755096e | 5028 | =item C<-bareword> allowed under C<use integer> |
c90c0ff4 | 5029 | |
4755096e | 5030 | =item Failures in DESTROY() |
cb1a09d0 | 5031 | |
4755096e GS |
5032 | =item Locale bugs fixed |
5033 | ||
5034 | =item Memory leaks | |
5035 | ||
5036 | =item Spurious subroutine stubs after failed subroutine calls | |
cb1a09d0 | 5037 | |
4755096e | 5038 | =item Taint failures under C<-U> |
55497cff | 5039 | |
4755096e | 5040 | =item END blocks and the C<-c> switch |
55497cff | 5041 | |
4755096e | 5042 | =item Potential to leak DATA filehandles |
55497cff | 5043 | |
a45bd81d GS |
5044 | =back |
5045 | ||
4755096e | 5046 | =item New or Changed Diagnostics |
a45bd81d | 5047 | |
4755096e GS |
5048 | "%s" variable %s masks earlier declaration in same %s, "my sub" not yet |
5049 | implemented, "our" variable %s redeclared, '!' allowed only after types %s, | |
5050 | / cannot take a count, / must be followed by a, A or Z, / must be followed | |
5051 | by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape | |
5052 | \\%c passed through, /%s/: Unrecognized escape \\%c in character class | |
5053 | passed through, /%s/ should probably be written as "%s", %s() called too | |
5054 | early to check prototype, %s argument is not a HASH or ARRAY element, %s | |
5055 | argument is not a HASH or ARRAY element or slice, %s argument is not a | |
5056 | subroutine name, %s package attribute may clash with future reserved word: | |
5057 | %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled | |
5058 | substitution pattern, Bad realloc() ignored, Bareword found in conditional, | |
5059 | Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector | |
5060 | size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check | |
5061 | filesystem of script "%s", Can't declare class for non-scalar %s in "%s", | |
5062 | Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default, | |
5063 | Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't | |
5064 | remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't | |
5065 | weaken a nonreference, Character class [:%s:] unknown, Character class | |
5066 | syntax [%s] belongs inside character classes, Constant is not %s reference, | |
5067 | constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated, | |
5068 | defined(%hash) is deprecated, Did not produce a valid header, (Did you mean | |
5069 | "local" instead of "our"?), Document contains no data, entering effective | |
5070 | %s failed, false [] range "%s" in regexp, Filehandle %s opened only for | |
5071 | output, flock() on closed filehandle %s, Global symbol "%s" requires | |
5072 | explicit package name, Hexadecimal number > 0xffffffff non-portable, | |
5073 | Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter: | |
5074 | |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal | |
5075 | number of bits in vec, Integer overflow in %s number, Invalid %s attribute: | |
5076 | %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid | |
5077 | separator character %s in attribute list, Invalid separator character %s in | |
5078 | subroutine attribute list, leaving effective %s failed, Lvalue subs | |
5079 | returning %s not implemented yet, Method %s not permitted, Missing | |
5080 | %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub", | |
5081 | No %s specified for -%c, No package name allowed for variable %s in "our", | |
5082 | No space allowed after -%c, no UTC offset information; assuming local time | |
5083 | is UTC, Octal number > 037777777777 non-portable, panic: del_backref, | |
5084 | panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing | |
5085 | around "%s" list, Possible unintended interpolation of %s in string, | |
5086 | Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" | |
5087 | instead, Premature end of script headers, Repeat count in pack overflows, | |
5088 | Repeat count in unpack overflows, realloc() of freed memory ignored, | |
5089 | Reference is already weak, setpgrp can't take arguments, Strange *+?{} on | |
5090 | zero-length expression, switching effective %s is not implemented, This | |
5091 | Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL | |
5092 | environ elements (%s=%s), Too late to run %s block, Unknown open() mode | |
5093 | '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized | |
5094 | escape \\%c passed through, Unterminated attribute parameter in attribute | |
5095 | list, Unterminated attribute list, Unterminated attribute parameter in | |
5096 | subroutine attribute list, Unterminated subroutine attribute list, Value of | |
5097 | CLI symbol "%s" too long, Version number must be a constant number | |
14218588 | 5098 | |
4755096e | 5099 | =item New tests |
14218588 | 5100 | |
4755096e | 5101 | =item Incompatible Changes |
14218588 | 5102 | |
d420ca49 | 5103 | =over 4 |
14218588 | 5104 | |
4755096e | 5105 | =item Perl Source Incompatibilities |
14218588 | 5106 | |
4755096e GS |
5107 | CHECK is a new keyword, Treatment of list slices of undef has changed, |
5108 | Format of $English::PERL_VERSION is different, Literals of the form | |
5109 | C<1.2.3> parse differently, Possibly changed pseudo-random number | |
5110 | generator, Hashing function for hash keys has changed, C<undef> fails on | |
5111 | read only values, Close-on-exec bit may be set on pipe and socket handles, | |
5112 | Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), values() and | |
5113 | C<\(%h)> operate on aliases to values, not copies, vec(EXPR,OFFSET,BITS) | |
5114 | enforces powers-of-two BITS, Text of some diagnostic output has changed, | |
5115 | C<%@> has been removed, Parenthesized not() behaves like a list operator, | |
5116 | Semantics of bareword prototype C<(*)> have changed, Semantics of bit | |
5117 | operators may have changed on 64-bit platforms, More builtins taint their | |
5118 | results | |
14218588 | 5119 | |
4755096e | 5120 | =item C Source Incompatibilities |
14218588 | 5121 | |
4755096e | 5122 | C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC> |
14218588 | 5123 | |
4755096e | 5124 | =item Compatible C Source API Changes |
a45bd81d | 5125 | |
4755096e | 5126 | C<PATCHLEVEL> is now C<PERL_VERSION> |
55497cff | 5127 | |
4755096e | 5128 | =item Binary Incompatibilities |
a45bd81d | 5129 | |
4755096e | 5130 | =back |
55497cff | 5131 | |
4755096e | 5132 | =item Known Problems |
55497cff | 5133 | |
d420ca49 | 5134 | =over 4 |
55497cff | 5135 | |
4755096e | 5136 | =item Thread test failures |
b38f6a39 | 5137 | |
4755096e | 5138 | =item EBCDIC platforms not supported |
774d564b | 5139 | |
4755096e | 5140 | =item In 64-bit HP-UX the lib/io_multihomed test may hang |
774d564b | 5141 | |
4755096e | 5142 | =item NEXTSTEP 3.3 POSIX test failure |
774d564b | 5143 | |
4755096e GS |
5144 | =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with |
5145 | gcc | |
cb1a09d0 | 5146 | |
4755096e | 5147 | =item UNICOS/mk CC failures during Configure run |
cb1a09d0 | 5148 | |
4755096e | 5149 | =item Arrow operator and arrays |
cb1a09d0 | 5150 | |
4755096e | 5151 | =item Experimental features |
cb1a09d0 | 5152 | |
4755096e GS |
5153 | Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The |
5154 | pseudo-hash data type, The Compiler suite, Internal implementation of file | |
5155 | globbing, The DB module, The regular expression constructs C<(?{ code })> | |
5156 | and C<(??{ code })> | |
cb1a09d0 | 5157 | |
b38f6a39 | 5158 | =back |
cb1a09d0 | 5159 | |
4755096e | 5160 | =item Obsolete Diagnostics |
b38f6a39 | 5161 | |
4755096e GS |
5162 | Character class syntax [: :] is reserved for future extensions, Ill-formed |
5163 | logical name |%s| in prime_env_iter, In string, @%s now must be written as | |
5164 | \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>" | |
5165 | to mean "${$}<digit>" is deprecated | |
5166 | ||
5167 | =item Reporting Bugs | |
cb1a09d0 | 5168 | |
b38f6a39 | 5169 | =item SEE ALSO |
cb1a09d0 | 5170 | |
4755096e | 5171 | =item HISTORY |
193fb0af | 5172 | |
8ebc5c01 | 5173 | =back |
cb1a09d0 | 5174 | |
4755096e | 5175 | =head2 perl5005delta, perldelta - what's new for perl5.005 |
193fb0af | 5176 | |
d420ca49 | 5177 | =over 4 |
193fb0af | 5178 | |
b38f6a39 | 5179 | =item DESCRIPTION |
193fb0af | 5180 | |
4755096e | 5181 | =item About the new versioning system |
193fb0af | 5182 | |
4755096e | 5183 | =item Incompatible Changes |
193fb0af | 5184 | |
d420ca49 | 5185 | =over 4 |
b38f6a39 | 5186 | |
4755096e | 5187 | =item WARNING: This version is not binary compatible with Perl 5.004. |
b38f6a39 | 5188 | |
4755096e | 5189 | =item Default installation structure has changed |
b38f6a39 | 5190 | |
4755096e | 5191 | =item Perl Source Compatibility |
193fb0af | 5192 | |
4755096e | 5193 | =item C Source Compatibility |
b38f6a39 | 5194 | |
4755096e GS |
5195 | Core sources now require ANSI C compiler, All Perl global variables must |
5196 | now be referenced with an explicit prefix, Enabling threads has source | |
5197 | compatibility issues | |
b38f6a39 | 5198 | |
4755096e | 5199 | =item Binary Compatibility |
b38f6a39 | 5200 | |
4755096e | 5201 | =item Security fixes may affect compatibility |
b38f6a39 | 5202 | |
4755096e | 5203 | =item Relaxed new mandatory warnings introduced in 5.004 |
b38f6a39 | 5204 | |
4755096e | 5205 | =item Licensing |
193fb0af GS |
5206 | |
5207 | =back | |
cb1a09d0 | 5208 | |
4755096e | 5209 | =item Core Changes |
fb9cefb4 | 5210 | |
d420ca49 | 5211 | =over 4 |
fb9cefb4 | 5212 | |
4755096e | 5213 | =item Threads |
fb9cefb4 | 5214 | |
4755096e | 5215 | =item Compiler |
fb9cefb4 | 5216 | |
4755096e | 5217 | =item Regular Expressions |
fb9cefb4 | 5218 | |
4755096e GS |
5219 | Many new and improved optimizations, Many bug fixes, New regular expression |
5220 | constructs, New operator for precompiled regular expressions, Other | |
5221 | improvements, Incompatible changes | |
fb9cefb4 | 5222 | |
4755096e | 5223 | =item Improved malloc() |
fb9cefb4 | 5224 | |
4755096e | 5225 | =item Quicksort is internally implemented |
ac65edd0 | 5226 | |
4755096e | 5227 | =item Reliable signals |
ac65edd0 | 5228 | |
4755096e | 5229 | =item Reliable stack pointers |
ac65edd0 | 5230 | |
4755096e | 5231 | =item More generous treatment of carriage returns |
ac65edd0 | 5232 | |
4755096e | 5233 | =item Memory leaks |
ac65edd0 | 5234 | |
4755096e | 5235 | =item Better support for multiple interpreters |
ac65edd0 | 5236 | |
4755096e | 5237 | =item Behavior of local() on array and hash elements is now well-defined |
ac65edd0 | 5238 | |
4755096e | 5239 | =item C<%!> is transparently tied to the L<Errno> module |
ac65edd0 | 5240 | |
4755096e | 5241 | =item Pseudo-hashes are supported |
b38f6a39 | 5242 | |
4755096e | 5243 | =item C<EXPR foreach EXPR> is supported |
ac65edd0 | 5244 | |
4755096e | 5245 | =item Keywords can be globally overridden |
ac65edd0 | 5246 | |
4755096e | 5247 | =item C<$^E> is meaningful on Win32 |
ac65edd0 | 5248 | |
4755096e | 5249 | =item C<foreach (1..1000000)> optimized |
cb1a09d0 | 5250 | |
4755096e | 5251 | =item C<Foo::> can be used as implicitly quoted package name |
a45bd81d | 5252 | |
4755096e | 5253 | =item C<exists $Foo::{Bar::}> tests existence of a package |
cb1a09d0 | 5254 | |
4755096e | 5255 | =item Better locale support |
a45bd81d | 5256 | |
4755096e | 5257 | =item Experimental support for 64-bit platforms |
cb1a09d0 | 5258 | |
4755096e | 5259 | =item prototype() returns useful results on builtins |
a45bd81d | 5260 | |
4755096e | 5261 | =item Extended support for exception handling |
cb1a09d0 | 5262 | |
4755096e | 5263 | =item Re-blessing in DESTROY() supported for chaining DESTROY() methods |
cb1a09d0 | 5264 | |
4755096e | 5265 | =item All C<printf> format conversions are handled internally |
55497cff | 5266 | |
4755096e | 5267 | =item New C<INIT> keyword |
b971f6e4 | 5268 | |
4755096e | 5269 | =item New C<lock> keyword |
cb1a09d0 | 5270 | |
4755096e | 5271 | =item New C<qr//> operator |
a6006777 | 5272 | |
4755096e | 5273 | =item C<our> is now a reserved word |
68dc0745 | 5274 | |
4755096e | 5275 | =item Tied arrays are now fully supported |
cb1a09d0 | 5276 | |
4755096e GS |
5277 | =item Tied handles support is better |
5278 | ||
5279 | =item 4th argument to substr | |
5280 | ||
5281 | =item Negative LENGTH argument to splice | |
5282 | ||
5283 | =item Magic lvalues are now more magical | |
5284 | ||
5285 | =item <> now reads in records | |
193fb0af | 5286 | |
a45bd81d GS |
5287 | =back |
5288 | ||
4755096e | 5289 | =item Supported Platforms |
cb1a09d0 | 5290 | |
d420ca49 | 5291 | =over 4 |
a45bd81d | 5292 | |
4755096e | 5293 | =item New Platforms |
cb1a09d0 | 5294 | |
4755096e | 5295 | =item Changes in existing support |
cb1a09d0 | 5296 | |
4755096e | 5297 | =back |
cb1a09d0 | 5298 | |
4755096e | 5299 | =item Modules and Pragmata |
cb1a09d0 | 5300 | |
d420ca49 | 5301 | =over 4 |
cb1a09d0 | 5302 | |
4755096e | 5303 | =item New Modules |
cb1a09d0 | 5304 | |
4755096e GS |
5305 | B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, |
5306 | ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, | |
5307 | Thread, attrs, fields, re | |
cb1a09d0 | 5308 | |
4755096e | 5309 | =item Changes in existing modules |
cb1a09d0 | 5310 | |
4755096e GS |
5311 | Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, |
5312 | MakeMaker, CPAN, Cwd, Benchmark | |
cb1a09d0 | 5313 | |
4755096e | 5314 | =back |
cb1a09d0 | 5315 | |
4755096e | 5316 | =item Utility Changes |
cb1a09d0 | 5317 | |
4755096e GS |
5318 | =item Documentation Changes |
5319 | ||
5320 | =item New Diagnostics | |
5321 | ||
5322 | Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index | |
5323 | while coercing array into hash, Bareword "%s" refers to nonexistent | |
5324 | package, Can't call method "%s" on an undefined value, Can't check | |
5325 | filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't | |
5326 | goto subroutine from an eval-string, Can't localize pseudo-hash element, | |
5327 | Can't use %%! because Errno.pm is not available, Cannot find an opnumber | |
5328 | for "%s", Character class syntax [. .] is reserved for future extensions, | |
5329 | Character class syntax [: :] is reserved for future extensions, Character | |
5330 | class syntax [= =] is reserved for future extensions, %s: Eval-group in | |
5331 | insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: | |
5332 | Eval-group not allowed at run time, Explicit blessing to '' (assuming | |
5333 | package main), Illegal hex digit ignored, No such array field, No such | |
5334 | field "%s" in variable %s of type %s, Out of memory during ridiculously | |
5335 | large request, Range iterator outside integer range, Recursive inheritance | |
5336 | detected while looking for method '%s' in package '%s', Reference found | |
5337 | where even-sized list expected, Undefined value assigned to typeglob, Use | |
5338 | of reserved word "%s" is deprecated, perl: warning: Setting locale failed | |
cb1a09d0 | 5339 | |
4755096e | 5340 | =item Obsolete Diagnostics |
cb1a09d0 | 5341 | |
4755096e GS |
5342 | Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open |
5343 | temporary file, regexp too big | |
cb1a09d0 | 5344 | |
4755096e | 5345 | =item Configuration Changes |
cb1a09d0 | 5346 | |
4755096e | 5347 | =item BUGS |
cb1a09d0 | 5348 | |
4755096e | 5349 | =item SEE ALSO |
cb1a09d0 | 5350 | |
4755096e | 5351 | =item HISTORY |
cb1a09d0 | 5352 | |
4755096e | 5353 | =back |
cb1a09d0 | 5354 | |
4755096e | 5355 | =head2 perl5004delta, perldelta - what's new for perl5.004 |
cb1a09d0 | 5356 | |
d420ca49 | 5357 | =over 4 |
cb1a09d0 | 5358 | |
4755096e | 5359 | =item DESCRIPTION |
cb1a09d0 | 5360 | |
4755096e | 5361 | =item Supported Environments |
cb1a09d0 | 5362 | |
4755096e | 5363 | =item Core Changes |
cb1a09d0 | 5364 | |
d420ca49 | 5365 | =over 4 |
cb1a09d0 | 5366 | |
4755096e | 5367 | =item List assignment to %ENV works |
cb1a09d0 | 5368 | |
d420ca49 | 5369 | =item Change to "Can't locate Foo.pm in @INC" error |
cb1a09d0 | 5370 | |
4755096e | 5371 | =item Compilation option: Binary compatibility with 5.003 |
cb1a09d0 | 5372 | |
4755096e | 5373 | =item $PERL5OPT environment variable |
cb1a09d0 | 5374 | |
4755096e | 5375 | =item Limitations on B<-M>, B<-m>, and B<-T> options |
cb1a09d0 | 5376 | |
4755096e | 5377 | =item More precise warnings |
cb1a09d0 | 5378 | |
4755096e | 5379 | =item Deprecated: Inherited C<AUTOLOAD> for non-methods |
cb1a09d0 | 5380 | |
4755096e | 5381 | =item Previously deprecated %OVERLOAD is no longer usable |
cb1a09d0 | 5382 | |
4755096e | 5383 | =item Subroutine arguments created only when they're modified |
cb1a09d0 | 5384 | |
4755096e | 5385 | =item Group vector changeable with C<$)> |
a45bd81d | 5386 | |
4755096e | 5387 | =item Fixed parsing of $$<digit>, &$<digit>, etc. |
fb9cefb4 | 5388 | |
4755096e | 5389 | =item Fixed localization of $<digit>, $&, etc. |
a45bd81d | 5390 | |
4755096e | 5391 | =item No resetting of $. on implicit close |
fb9cefb4 | 5392 | |
4755096e | 5393 | =item C<wantarray> may return undef |
fb9cefb4 | 5394 | |
4755096e | 5395 | =item C<eval EXPR> determines value of EXPR in scalar context |
fb9cefb4 | 5396 | |
4755096e | 5397 | =item Changes to tainting checks |
fb9cefb4 | 5398 | |
4755096e GS |
5399 | No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No |
5400 | spawning if tainted $TERM doesn't look like a terminal name | |
fb9cefb4 | 5401 | |
4755096e | 5402 | =item New Opcode module and revised Safe module |
14218588 | 5403 | |
4755096e | 5404 | =item Embedding improvements |
fb9cefb4 | 5405 | |
4755096e | 5406 | =item Internal change: FileHandle class based on IO::* classes |
fb9cefb4 | 5407 | |
4755096e | 5408 | =item Internal change: PerlIO abstraction interface |
fb9cefb4 | 5409 | |
4755096e | 5410 | =item New and changed syntax |
fb9cefb4 | 5411 | |
4755096e | 5412 | $coderef->(PARAMS) |
fb9cefb4 | 5413 | |
4755096e | 5414 | =item New and changed builtin constants |
fb9cefb4 | 5415 | |
4755096e | 5416 | __PACKAGE__ |
14218588 | 5417 | |
4755096e | 5418 | =item New and changed builtin variables |
14218588 | 5419 | |
4755096e | 5420 | $^E, $^H, $^M |
fb9cefb4 | 5421 | |
4755096e | 5422 | =item New and changed builtin functions |
fb9cefb4 | 5423 | |
4755096e GS |
5424 | delete on slices, flock, printf and sprintf, keys as an lvalue, my() in |
5425 | Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module | |
5426 | VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not | |
5427 | reset search position on failure, C<m//x> ignores whitespace before ?*+{}, | |
5428 | nested C<sub{}> closures work now, formats work right on changing lexicals | |
fb9cefb4 | 5429 | |
4755096e | 5430 | =item New builtin methods |
fb9cefb4 | 5431 | |
4755096e | 5432 | isa(CLASS), can(METHOD), VERSION( [NEED] ) |
fb9cefb4 | 5433 | |
4755096e | 5434 | =item TIEHANDLE now supported |
fb9cefb4 | 5435 | |
4755096e GS |
5436 | TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this |
5437 | LIST, READLINE this, GETC this, DESTROY this | |
fb9cefb4 | 5438 | |
4755096e | 5439 | =item Malloc enhancements |
fb9cefb4 | 5440 | |
4755096e | 5441 | -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE |
fb9cefb4 | 5442 | |
4755096e | 5443 | =item Miscellaneous efficiency enhancements |
fb9cefb4 | 5444 | |
4755096e | 5445 | =back |
fb9cefb4 | 5446 | |
4755096e | 5447 | =item Support for More Operating Systems |
fb9cefb4 | 5448 | |
d420ca49 | 5449 | =over 4 |
fb9cefb4 | 5450 | |
4755096e | 5451 | =item Win32 |
14218588 | 5452 | |
4755096e | 5453 | =item Plan 9 |
fb9cefb4 | 5454 | |
4755096e | 5455 | =item QNX |
fb9cefb4 | 5456 | |
4755096e | 5457 | =item AmigaOS |
fb9cefb4 | 5458 | |
fb9cefb4 GS |
5459 | =back |
5460 | ||
4755096e GS |
5461 | =item Pragmata |
5462 | ||
5463 | use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use | |
5464 | constant NAME => VALUE, use locale, use ops, use vmsish | |
5465 | ||
5466 | =item Modules | |
fb9cefb4 | 5467 | |
d420ca49 | 5468 | =over 4 |
fb9cefb4 | 5469 | |
4755096e | 5470 | =item Required Updates |
fb9cefb4 | 5471 | |
4755096e | 5472 | =item Installation directories |
fb9cefb4 | 5473 | |
4755096e | 5474 | =item Module information summary |
fb9cefb4 | 5475 | |
4755096e | 5476 | =item Fcntl |
14218588 | 5477 | |
4755096e | 5478 | =item IO |
14218588 | 5479 | |
4755096e | 5480 | =item Math::Complex |
b38f6a39 | 5481 | |
4755096e | 5482 | =item Math::Trig |
37590e52 | 5483 | |
4755096e | 5484 | =item DB_File |
fb9cefb4 | 5485 | |
4755096e GS |
5486 | =item Net::Ping |
5487 | ||
5488 | =item Object-oriented overrides for builtin operators | |
fb9cefb4 | 5489 | |
a45bd81d GS |
5490 | =back |
5491 | ||
4755096e | 5492 | =item Utility Changes |
cb1a09d0 | 5493 | |
d420ca49 | 5494 | =over 4 |
a45bd81d | 5495 | |
4755096e | 5496 | =item pod2html |
a45bd81d | 5497 | |
4755096e | 5498 | Sends converted HTML to standard output |
cb1a09d0 | 5499 | |
4755096e | 5500 | =item xsubpp |
a45bd81d | 5501 | |
4755096e | 5502 | C<void> XSUBs now default to returning nothing |
cb1a09d0 | 5503 | |
4755096e | 5504 | =back |
d516a115 | 5505 | |
4755096e | 5506 | =item C Language API Changes |
d516a115 | 5507 | |
4755096e GS |
5508 | C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for |
5509 | manipulating hashes | |
d516a115 | 5510 | |
4755096e | 5511 | =item Documentation Changes |
d516a115 | 5512 | |
4755096e GS |
5513 | L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>, |
5514 | L<perlmodlib>, L<perldebug>, L<perlsec> | |
d516a115 | 5515 | |
4755096e | 5516 | =item New Diagnostics |
cb1a09d0 | 5517 | |
4755096e GS |
5518 | "my" variable %s masks earlier declaration in same scope, %s argument is |
5519 | not a HASH element or slice, Allocation too large: %lx, Allocation too | |
5520 | large, Applying %s to %s will act on scalar(%s), Attempt to free | |
5521 | nonexistent shared string, Attempt to use reference as lvalue in substr, | |
5522 | Bareword "%s" refers to nonexistent package, Can't redefine active sort | |
5523 | subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in | |
5524 | use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant | |
5525 | subroutine %s redefined, Constant subroutine %s undefined, Copy method did | |
5526 | not return a reference, Died, Exiting pseudo-block via %s, Identifier too | |
5527 | long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: | |
5528 | %s, Integer overflow in hex number, Integer overflow in octal number, | |
5529 | internal error: glob failed, Invalid conversion in %s: "%s", Invalid type | |
5530 | in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: | |
5531 | possible typo, Null picture in formline, Offset outside string, Out of | |
5532 | memory!, Out of memory during request for %s, panic: frexp, Possible | |
5533 | attempt to put comments in qw() list, Possible attempt to separate words | |
5534 | with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found | |
5535 | while resolving method `%s' overloading `%s' in package `%s', Too late for | |
5536 | "B<-T>" option, untie attempted while %d inner references still exist, | |
5537 | Unrecognized character %s, Unsupported function fork, Use of "$$<digit>" to | |
5538 | mean "${$}<digit>" is deprecated, Value of %s can be "0"; test with | |
5539 | defined(), Variable "%s" may be unavailable, Variable "%s" will not stay | |
5540 | shared, Warning: something's wrong, Ill-formed logical name |%s| in | |
5541 | prime_env_iter, Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, | |
5542 | PERL_SH_DIR too long, Process terminated by SIG%s | |
cb1a09d0 | 5543 | |
4755096e | 5544 | =item BUGS |
d516a115 | 5545 | |
8ebc5c01 | 5546 | =item SEE ALSO |
cb1a09d0 | 5547 | |
4755096e | 5548 | =item HISTORY |
cb1a09d0 | 5549 | |
a45bd81d GS |
5550 | =back |
5551 | ||
37d4d706 JH |
5552 | =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems |
5553 | ||
d420ca49 | 5554 | =over 4 |
37d4d706 JH |
5555 | |
5556 | =item DESCRIPTION | |
5557 | ||
d420ca49 | 5558 | =over 4 |
37d4d706 JH |
5559 | |
5560 | =item Compiling Perl 5 on AIX | |
5561 | ||
5562 | =item OS level | |
5563 | ||
5564 | =item Building Dynamic Extensions on AIX | |
5565 | ||
5566 | =item The IBM ANSI C Compiler | |
5567 | ||
5568 | =item Using GNU's gcc for building perl | |
5569 | ||
5570 | =item Using Large Files with Perl | |
5571 | ||
5572 | =item Threaded Perl | |
5573 | ||
5574 | =item 64-bit Perl | |
5575 | ||
5576 | =item GDBM and Threads | |
5577 | ||
5578 | =item NFS filesystems and utime(2) | |
5579 | ||
5580 | =back | |
5581 | ||
5582 | =item AUTHOR | |
5583 | ||
5584 | =item DATE | |
5585 | ||
5586 | =back | |
5587 | ||
4755096e | 5588 | =head2 perlamiga - Perl under Amiga OS (possibly very outdated information) |
cb1a09d0 | 5589 | |
d420ca49 | 5590 | =over 4 |
a45bd81d | 5591 | |
4755096e | 5592 | =item SYNOPSIS |
cb1a09d0 | 5593 | |
a45bd81d GS |
5594 | =back |
5595 | ||
d420ca49 | 5596 | =over 4 |
a45bd81d | 5597 | |
8ebc5c01 | 5598 | =item DESCRIPTION |
cb1a09d0 | 5599 | |
d420ca49 | 5600 | =over 4 |
cb1a09d0 | 5601 | |
4755096e | 5602 | =item Prerequisites |
cb1a09d0 | 5603 | |
4755096e | 5604 | B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS> |
cb1a09d0 | 5605 | |
4755096e | 5606 | =item Starting Perl programs under AmigaOS |
cb1a09d0 | 5607 | |
4755096e | 5608 | =item Shortcomings of Perl under AmigaOS |
cb1a09d0 | 5609 | |
4755096e GS |
5610 | fork(), some features of the UNIX filesystem regarding link count and file |
5611 | dates, inplace operation (the -i switch) without backup file, umask() | |
5612 | works, but the correct permissions are only set when the file is | |
5613 | finally close()d | |
cb1a09d0 | 5614 | |
4755096e | 5615 | =back |
cb1a09d0 | 5616 | |
4755096e | 5617 | =item INSTALLATION |
cb1a09d0 | 5618 | |
4755096e | 5619 | =item Accessing documentation |
cb1a09d0 | 5620 | |
d420ca49 | 5621 | =over 4 |
cb1a09d0 | 5622 | |
4755096e | 5623 | =item Manpages |
cb1a09d0 | 5624 | |
4755096e | 5625 | =item B<HTML> |
cb1a09d0 | 5626 | |
4755096e GS |
5627 | =item B<GNU> C<info> files |
5628 | ||
5629 | =item C<LaTeX> docs | |
cb1a09d0 | 5630 | |
8ebc5c01 | 5631 | =back |
cb1a09d0 | 5632 | |
4755096e | 5633 | =item BUILD |
3e3baf6d | 5634 | |
d420ca49 | 5635 | =over 4 |
4755096e GS |
5636 | |
5637 | =item Prerequisites | |
5638 | ||
5639 | =item Getting the perl source | |
5640 | ||
5641 | =item Making | |
5642 | ||
5643 | =item Testing | |
5644 | ||
5645 | =item Installing the built perl | |
5646 | ||
5647 | =back | |
cb1a09d0 | 5648 | |
8ebc5c01 | 5649 | =item AUTHOR |
cb1a09d0 | 5650 | |
4755096e | 5651 | =item SEE ALSO |
f86702cc | 5652 | |
a45bd81d GS |
5653 | =back |
5654 | ||
4755096e | 5655 | =head2 perlcygwin, README.cygwin - Perl for Cygwin |
cb1a09d0 | 5656 | |
d420ca49 | 5657 | =over 4 |
a45bd81d | 5658 | |
8ebc5c01 | 5659 | =item SYNOPSIS |
cb1a09d0 | 5660 | |
4755096e | 5661 | =item PREREQUISITES |
cb1a09d0 | 5662 | |
d420ca49 | 5663 | =over 4 |
cb1a09d0 | 5664 | |
4755096e | 5665 | =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) |
cb1a09d0 | 5666 | |
4755096e | 5667 | =item Cygwin Configuration |
cb1a09d0 | 5668 | |
4755096e | 5669 | C<PATH>, I<nroff>, Permissions |
cb1a09d0 | 5670 | |
a45bd81d GS |
5671 | =back |
5672 | ||
4755096e | 5673 | =item CONFIGURE |
cb1a09d0 | 5674 | |
d420ca49 | 5675 | =over 4 |
a45bd81d | 5676 | |
4755096e | 5677 | =item Strip Binaries |
cb1a09d0 | 5678 | |
4755096e | 5679 | =item Optional Libraries |
cb1a09d0 | 5680 | |
4755096e GS |
5681 | C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>), |
5682 | C<-lcygipc> (C<use IPC::SysV>) | |
cb1a09d0 | 5683 | |
4755096e | 5684 | =item Configure-time Options |
cb1a09d0 | 5685 | |
4755096e GS |
5686 | C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>, |
5687 | C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles> | |
cb1a09d0 | 5688 | |
4755096e | 5689 | =item Suspicious Warnings |
cb1a09d0 | 5690 | |
74cac757 | 5691 | I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines |
cb1a09d0 | 5692 | |
4755096e | 5693 | =back |
cb1a09d0 | 5694 | |
4755096e | 5695 | =item MAKE |
cb1a09d0 | 5696 | |
d420ca49 | 5697 | =over 4 |
cb1a09d0 | 5698 | |
4755096e | 5699 | =item Warnings |
cb1a09d0 | 5700 | |
4755096e | 5701 | =item ld2 |
7d2bfb28 | 5702 | |
4755096e | 5703 | =back |
cb1a09d0 | 5704 | |
4755096e | 5705 | =item TEST |
cb1a09d0 | 5706 | |
d420ca49 | 5707 | =over 4 |
cb1a09d0 | 5708 | |
4755096e | 5709 | =item File Permissions |
7d2bfb28 | 5710 | |
4755096e | 5711 | =item Hard Links |
7d2bfb28 | 5712 | |
4755096e | 5713 | =item Filetime Granularity |
7d2bfb28 | 5714 | |
4755096e | 5715 | =item Tainting Checks |
cb1a09d0 | 5716 | |
4755096e | 5717 | =item /etc/group |
193fb0af | 5718 | |
4755096e | 5719 | =item Script Portability |
cb1a09d0 | 5720 | |
4755096e | 5721 | Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous |
cb1a09d0 | 5722 | |
4755096e | 5723 | =back |
cb1a09d0 | 5724 | |
4755096e | 5725 | =item INSTALL |
cb1a09d0 | 5726 | |
4755096e | 5727 | =item MANIFEST |
cb1a09d0 | 5728 | |
4755096e GS |
5729 | Documentation, Build, Configure, Make, Install, Tests, Compiled Perl |
5730 | Source, Compiled Module Source, Perl Modules/Scripts | |
7d2bfb28 | 5731 | |
4755096e | 5732 | =item BUGS |
7d2bfb28 | 5733 | |
4755096e | 5734 | =item AUTHORS |
7d2bfb28 | 5735 | |
4755096e | 5736 | =item HISTORY |
7d2bfb28 | 5737 | |
4755096e | 5738 | =back |
193fb0af | 5739 | |
9a997319 JH |
5740 | =head2 perlepoc, README.epoc - Perl for EPOC |
5741 | ||
d420ca49 | 5742 | =over 4 |
9a997319 JH |
5743 | |
5744 | =item SYNOPSIS | |
5745 | ||
5746 | =item INTRODUCTION | |
5747 | ||
5748 | =item INSTALLING PERL ON EPOC | |
5749 | ||
5750 | =item USING PERL ON EPOC | |
5751 | ||
d420ca49 | 5752 | =over 4 |
9a997319 JH |
5753 | |
5754 | =item IO Redirection | |
5755 | ||
5756 | =item PATH Names | |
5757 | ||
5758 | =item Editors | |
5759 | ||
5760 | =item Features | |
5761 | ||
5762 | =item Restrictions | |
5763 | ||
5764 | =item Compiling Perl 5 on the EPOC cross compiling environment | |
5765 | ||
5766 | =back | |
5767 | ||
5768 | =item SUPPORT STATUS | |
5769 | ||
5770 | =item AUTHOR | |
5771 | ||
5772 | =item LAST UPDATE | |
5773 | ||
5774 | =back | |
5775 | ||
4755096e GS |
5776 | =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix |
5777 | (HP-UX) systems | |
cb1a09d0 | 5778 | |
d420ca49 | 5779 | =over 4 |
a45bd81d | 5780 | |
cb1a09d0 AD |
5781 | =item DESCRIPTION |
5782 | ||
d420ca49 | 5783 | =over 4 |
7d2bfb28 | 5784 | |
4755096e | 5785 | =item Compiling Perl 5 on HP-UX |
7d2bfb28 | 5786 | |
4755096e | 5787 | =item PA-RISC |
cb1a09d0 | 5788 | |
4755096e | 5789 | =item PA-RISC 1.0 |
cb1a09d0 | 5790 | |
4755096e | 5791 | =item PA-RISC 1.1 |
cb1a09d0 | 5792 | |
4755096e | 5793 | =item PA-RISC 2.0 |
cb1a09d0 | 5794 | |
4755096e | 5795 | =item Portability Between PA-RISC Versions |
cb1a09d0 | 5796 | |
4755096e | 5797 | =item Building Dynamic Extensions on HP-UX |
cb1a09d0 | 5798 | |
4755096e | 5799 | =item The HP ANSI C Compiler |
cb1a09d0 | 5800 | |
4755096e | 5801 | =item Using Large Files with Perl |
cb1a09d0 | 5802 | |
4755096e | 5803 | =item Threaded Perl |
cb1a09d0 | 5804 | |
4755096e | 5805 | =item 64-bit Perl |
cb1a09d0 | 5806 | |
4755096e | 5807 | =item GDBM and Threads |
cb1a09d0 | 5808 | |
4755096e | 5809 | =item NFS filesystems and utime(2) |
7d2bfb28 | 5810 | |
7029d033 JH |
5811 | =item perl -P and // |
5812 | ||
4755096e | 5813 | =back |
a45bd81d | 5814 | |
4755096e | 5815 | =item AUTHOR |
a45bd81d | 5816 | |
4755096e | 5817 | =item DATE |
7d2bfb28 | 5818 | |
4755096e | 5819 | =back |
7d2bfb28 | 5820 | |
4755096e GS |
5821 | =head2 perlmachten, README.machten - Perl version 5 on Power MachTen |
5822 | systems | |
7d2bfb28 | 5823 | |
d420ca49 | 5824 | =over 4 |
7d2bfb28 | 5825 | |
4755096e | 5826 | =item DESCRIPTION |
7d2bfb28 | 5827 | |
d420ca49 | 5828 | =over 4 |
c76ac1ee | 5829 | |
4755096e | 5830 | =item Compiling Perl 5 on MachTen |
c76ac1ee | 5831 | |
4755096e | 5832 | =item Failures during C<make test> |
2e1d04bc | 5833 | |
4755096e | 5834 | op/lexassign.t, pragma/warnings.t |
c76ac1ee | 5835 | |
4755096e | 5836 | =item Building external modules |
c76ac1ee | 5837 | |
4755096e | 5838 | =back |
c76ac1ee | 5839 | |
4755096e | 5840 | =item AUTHOR |
c76ac1ee | 5841 | |
4755096e | 5842 | =item DATE |
c76ac1ee GS |
5843 | |
5844 | =back | |
5845 | ||
4755096e | 5846 | =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. |
cb1a09d0 | 5847 | |
d420ca49 | 5848 | =over 4 |
c76ac1ee | 5849 | |
4755096e | 5850 | =item SYNOPSIS |
7d2bfb28 | 5851 | |
a45bd81d GS |
5852 | =back |
5853 | ||
d420ca49 AD |
5854 | =over 4 |
5855 | ||
5856 | =item DESCRIPTION | |
5857 | ||
5858 | =over 4 | |
a45bd81d | 5859 | |
4755096e | 5860 | =item Target |
cb1a09d0 | 5861 | |
4755096e | 5862 | =item Other OSes |
0a753a76 | 5863 | |
4755096e | 5864 | =item Prerequisites |
cb1a09d0 | 5865 | |
4755096e | 5866 | EMX, RSX, HPFS, pdksh |
cb1a09d0 | 5867 | |
4755096e | 5868 | =item Starting Perl programs under OS/2 (and DOS and...) |
cb1a09d0 | 5869 | |
4755096e | 5870 | =item Starting OS/2 (and DOS) programs under Perl |
cb1a09d0 | 5871 | |
4755096e | 5872 | =back |
cb1a09d0 | 5873 | |
4755096e | 5874 | =item Frequently asked questions |
cb1a09d0 | 5875 | |
d420ca49 | 5876 | =over 4 |
1e422769 | 5877 | |
4755096e | 5878 | =item I cannot run external programs |
cb1a09d0 | 5879 | |
4755096e GS |
5880 | =item I cannot embed perl into my program, or use F<perl.dll> from my |
5881 | program. | |
cb1a09d0 | 5882 | |
4755096e GS |
5883 | Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use |
5884 | L<ExtUtils::Embed>? | |
cb1a09d0 | 5885 | |
4755096e | 5886 | =item C<``> and pipe-C<open> do not work under DOS. |
cb1a09d0 | 5887 | |
4755096e | 5888 | =item Cannot start C<find.exe "pattern" file> |
cb1a09d0 | 5889 | |
4755096e | 5890 | =back |
0a753a76 | 5891 | |
4755096e | 5892 | =item INSTALLATION |
cb1a09d0 | 5893 | |
d420ca49 | 5894 | =over 4 |
cb1a09d0 | 5895 | |
4755096e | 5896 | =item Automatic binary installation |
cb1a09d0 | 5897 | |
4755096e | 5898 | C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm> |
cb1a09d0 | 5899 | |
4755096e | 5900 | =item Manual binary installation |
3e3baf6d | 5901 | |
4755096e GS |
5902 | Perl VIO and PM executables (dynamically linked), Perl_ VIO executable |
5903 | (statically linked), Executables for Perl utilities, Main Perl library, | |
5904 | Additional Perl modules, Tools to compile Perl modules, Manpages for Perl | |
5905 | and utilities, Manpages for Perl modules, Source for Perl documentation, | |
5906 | Perl manual in F<.INF> format, Pdksh | |
d516a115 | 5907 | |
4755096e | 5908 | =item B<Warning> |
d516a115 | 5909 | |
0a753a76 | 5910 | =back |
5911 | ||
4755096e | 5912 | =item Accessing documentation |
0a753a76 | 5913 | |
d420ca49 | 5914 | =over 4 |
cb1a09d0 | 5915 | |
4755096e | 5916 | =item OS/2 F<.INF> file |
cb1a09d0 | 5917 | |
4755096e | 5918 | =item Plain text |
cb1a09d0 | 5919 | |
4755096e | 5920 | =item Manpages |
cb1a09d0 | 5921 | |
4755096e | 5922 | =item HTML |
cb1a09d0 | 5923 | |
4755096e | 5924 | =item GNU C<info> files |
cb1a09d0 | 5925 | |
4755096e | 5926 | =item F<.PDF> files |
cb1a09d0 | 5927 | |
4755096e | 5928 | =item C<LaTeX> docs |
cb1a09d0 | 5929 | |
0a753a76 | 5930 | =back |
5931 | ||
4755096e | 5932 | =item BUILD |
0a753a76 | 5933 | |
d420ca49 | 5934 | =over 4 |
0a753a76 | 5935 | |
4755096e | 5936 | =item Prerequisites |
0a753a76 | 5937 | |
4755096e | 5938 | =item Getting perl source |
0a753a76 | 5939 | |
4755096e | 5940 | =item Application of the patches |
0a753a76 | 5941 | |
4755096e | 5942 | =item Hand-editing |
0a753a76 | 5943 | |
4755096e | 5944 | =item Making |
0a753a76 | 5945 | |
4755096e GS |
5946 | =item Testing |
5947 | ||
5948 | A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>, | |
5949 | F<lib/io_pipe.t>, F<lib/io_sock.t>, F<op/stat.t>, F<lib/io_udp.t> | |
5950 | ||
5951 | =item Installing the built perl | |
5952 | ||
5953 | =item C<a.out>-style build | |
0a753a76 | 5954 | |
5955 | =back | |
5956 | ||
4755096e | 5957 | =item Build FAQ |
c76ac1ee | 5958 | |
d420ca49 | 5959 | =over 4 |
c76ac1ee | 5960 | |
4755096e | 5961 | =item Some C</> became C<\> in pdksh. |
c76ac1ee | 5962 | |
4755096e | 5963 | =item C<'errno'> - unresolved external |
c76ac1ee | 5964 | |
4755096e | 5965 | =item Problems with tr or sed |
c76ac1ee | 5966 | |
4755096e | 5967 | =item Some problem (forget which ;-) |
c76ac1ee | 5968 | |
4755096e | 5969 | =item Library ... not found |
cb1a09d0 | 5970 | |
4755096e | 5971 | =item Segfault in make |
954c1994 | 5972 | |
d396a558 JH |
5973 | =item op/sprintf test failure |
5974 | ||
a45bd81d GS |
5975 | =back |
5976 | ||
4755096e | 5977 | =item Specific (mis)features of OS/2 port |
cb1a09d0 | 5978 | |
d420ca49 | 5979 | =over 4 |
a45bd81d | 5980 | |
4755096e | 5981 | =item C<setpriority>, C<getpriority> |
cb1a09d0 | 5982 | |
4755096e | 5983 | =item C<system()> |
cb1a09d0 | 5984 | |
4755096e | 5985 | =item C<extproc> on the first line |
cb1a09d0 | 5986 | |
4755096e | 5987 | =item Additional modules: |
cb1a09d0 | 5988 | |
4755096e GS |
5989 | =item Prebuilt methods: |
5990 | ||
5991 | C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>, | |
5992 | C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>, | |
5993 | C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, | |
5994 | C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, | |
5995 | C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>, | |
5996 | C<Cwd::extLibpath_set( path [, type ] )> | |
5997 | ||
5998 | =item Misfeatures | |
5999 | ||
6000 | =item Modifications | |
6001 | ||
6002 | C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<flock> | |
6003 | ||
6004 | =back | |
6005 | ||
6006 | =item Perl flavors | |
cb1a09d0 | 6007 | |
d420ca49 | 6008 | =over 4 |
cb1a09d0 | 6009 | |
4755096e | 6010 | =item F<perl.exe> |
54310121 | 6011 | |
4755096e | 6012 | =item F<perl_.exe> |
cb1a09d0 | 6013 | |
4755096e | 6014 | =item F<perl__.exe> |
cb1a09d0 | 6015 | |
4755096e | 6016 | =item F<perl___.exe> |
cb1a09d0 | 6017 | |
4755096e | 6018 | =item Why strange names? |
cb1a09d0 | 6019 | |
4755096e | 6020 | =item Why dynamic linking? |
cb1a09d0 | 6021 | |
4755096e | 6022 | =item Why chimera build? |
7d2bfb28 | 6023 | |
4755096e | 6024 | explicit fork(), open FH, "|-", open FH, "-|" |
cb1a09d0 AD |
6025 | |
6026 | =back | |
6027 | ||
4755096e | 6028 | =item ENVIRONMENT |
cb1a09d0 | 6029 | |
d420ca49 | 6030 | =over 4 |
cb1a09d0 | 6031 | |
4755096e | 6032 | =item C<PERLLIB_PREFIX> |
cb1a09d0 | 6033 | |
4755096e | 6034 | =item C<PERL_BADLANG> |
cb1a09d0 | 6035 | |
4755096e | 6036 | =item C<PERL_BADFREE> |
cb1a09d0 | 6037 | |
4755096e | 6038 | =item C<PERL_SH_DIR> |
cb1a09d0 | 6039 | |
4755096e | 6040 | =item C<USE_PERL_FLOCK> |
cb1a09d0 | 6041 | |
4755096e | 6042 | =item C<TMP> or C<TEMP> |
cb1a09d0 | 6043 | |
4755096e | 6044 | =back |
cb1a09d0 | 6045 | |
4755096e | 6046 | =item Evolution |
7d2bfb28 | 6047 | |
d420ca49 | 6048 | =over 4 |
cb1a09d0 | 6049 | |
4755096e | 6050 | =item Priorities |
cb1a09d0 | 6051 | |
4755096e | 6052 | =item DLL name mangling |
cb1a09d0 | 6053 | |
4755096e | 6054 | =item Threading |
cb1a09d0 | 6055 | |
4755096e | 6056 | =item Calls to external programs |
cb1a09d0 | 6057 | |
4755096e | 6058 | =item Memory allocation |
cb1a09d0 | 6059 | |
4755096e | 6060 | =item Threads |
cb1a09d0 | 6061 | |
4755096e | 6062 | C<COND_WAIT>, F<os2.c> |
cb1a09d0 | 6063 | |
4755096e | 6064 | =back |
5cd24f17 | 6065 | |
cb1a09d0 AD |
6066 | =back |
6067 | ||
d420ca49 | 6068 | =over 4 |
cb1a09d0 | 6069 | |
cb1a09d0 AD |
6070 | =item AUTHOR |
6071 | ||
4755096e | 6072 | =item SEE ALSO |
cb1a09d0 | 6073 | |
a45bd81d GS |
6074 | =back |
6075 | ||
4755096e | 6076 | =head2 perlos390, README.os390 - building and installing Perl for OS/390. |
c76ac1ee | 6077 | |
d420ca49 | 6078 | =over 4 |
a45bd81d | 6079 | |
4755096e GS |
6080 | =item SYNOPSIS |
6081 | ||
c76ac1ee GS |
6082 | =item DESCRIPTION |
6083 | ||
d420ca49 | 6084 | =over 4 |
c76ac1ee | 6085 | |
4755096e | 6086 | =item Unpacking |
c76ac1ee | 6087 | |
4755096e | 6088 | =item Setup and utilities |
c76ac1ee | 6089 | |
4755096e | 6090 | =item Configure |
c76ac1ee | 6091 | |
4755096e | 6092 | =item Build, test, install |
c76ac1ee | 6093 | |
74cac757 JH |
6094 | =item build anomalies |
6095 | ||
6096 | =item testing anomalies | |
6097 | ||
4755096e | 6098 | =item Usage Hints |
c76ac1ee | 6099 | |
74cac757 | 6100 | =item Modules and Extensions |
c76ac1ee | 6101 | |
4755096e | 6102 | =back |
c76ac1ee | 6103 | |
4755096e | 6104 | =item AUTHORS |
c76ac1ee | 6105 | |
4755096e | 6106 | =item SEE ALSO |
c76ac1ee | 6107 | |
d420ca49 | 6108 | =over 4 |
c76ac1ee | 6109 | |
4755096e | 6110 | =item Mailing list |
c76ac1ee | 6111 | |
4755096e | 6112 | =back |
c76ac1ee | 6113 | |
4755096e | 6114 | =item HISTORY |
c76ac1ee GS |
6115 | |
6116 | =back | |
6117 | ||
c2e66d9e GS |
6118 | =head2 perlposix-bc, README.posix-bc - building and installing Perl for |
6119 | BS2000 POSIX. | |
6120 | ||
d420ca49 | 6121 | =over 4 |
c2e66d9e GS |
6122 | |
6123 | =item SYNOPSIS | |
6124 | ||
6125 | =item DESCRIPTION | |
6126 | ||
d420ca49 | 6127 | =over 4 |
c2e66d9e GS |
6128 | |
6129 | =item gzip | |
6130 | ||
6131 | =item bison | |
6132 | ||
6133 | =item Unpacking | |
6134 | ||
6135 | =item Compiling | |
6136 | ||
6137 | =item Testing | |
6138 | ||
6139 | =item Install | |
6140 | ||
6141 | =item Using Perl | |
6142 | ||
6143 | =back | |
6144 | ||
6145 | =item AUTHORS | |
6146 | ||
6147 | =item SEE ALSO | |
6148 | ||
d420ca49 | 6149 | =over 4 |
c2e66d9e GS |
6150 | |
6151 | =item Mailing list | |
6152 | ||
6153 | =back | |
6154 | ||
6155 | =item HISTORY | |
6156 | ||
6157 | =back | |
6158 | ||
d420ca49 AD |
6159 | =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems |
6160 | ||
6161 | =over 4 | |
6162 | ||
6163 | =item DESCRIPTION | |
6164 | ||
6165 | =over 4 | |
6166 | ||
6167 | =item Solaris Version Numbers. | |
6168 | ||
6169 | =back | |
6170 | ||
6171 | =item RESOURCES | |
6172 | ||
6173 | Solaris FAQ, Precompiled Binaries, Solaris Documentation | |
6174 | ||
6175 | =item SETTING UP | |
6176 | ||
6177 | =over 4 | |
6178 | ||
6179 | =item File Extraction Problems. | |
6180 | ||
6181 | =item Compiler and Related Tools. | |
6182 | ||
6183 | =item Environment | |
6184 | ||
6185 | =back | |
6186 | ||
6187 | =item RUN CONFIGURE. | |
6188 | ||
6189 | =over 4 | |
6190 | ||
6191 | =item 64-bit Issues. | |
6192 | ||
6193 | =item Threads. | |
6194 | ||
6195 | =item Malloc Issues. | |
6196 | ||
6197 | =back | |
6198 | ||
6199 | =item MAKE PROBLEMS. | |
6200 | ||
6201 | Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: | |
6202 | relocation error:, dlopen: stub interception failed, #error "No | |
6203 | DATAMODEL_NATIVE specified", sh: ar: not found | |
6204 | ||
6205 | =item MAKE TEST | |
6206 | ||
6207 | =over 4 | |
6208 | ||
6209 | =item op/stat.t test 4 | |
6210 | ||
6211 | =back | |
6212 | ||
6213 | =item PREBUILT BINARIES. | |
6214 | ||
6215 | =item RUNTIME ISSUES. | |
6216 | ||
6217 | =over 4 | |
6218 | ||
6219 | =item Limits on Numbers of Open Files. | |
6220 | ||
6221 | =back | |
6222 | ||
6223 | =item SOLARIS-SPECIFIC MODULES. | |
6224 | ||
6225 | =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. | |
6226 | ||
6227 | =over 4 | |
6228 | ||
6229 | =item Proc::ProcessTable | |
6230 | ||
6231 | =item BSD::Resource | |
6232 | ||
74cac757 JH |
6233 | =item Net::SSLeay |
6234 | ||
d420ca49 AD |
6235 | =back |
6236 | ||
6237 | =item AUTHOR | |
6238 | ||
6239 | =item LAST MODIFIED | |
6240 | ||
6241 | =back | |
6242 | ||
4755096e | 6243 | =head2 perlvms - VMS-specific documentation for Perl |
954c1994 | 6244 | |
d420ca49 | 6245 | =over 4 |
954c1994 | 6246 | |
4755096e | 6247 | =item DESCRIPTION |
a45bd81d | 6248 | |
4755096e GS |
6249 | =item Installation |
6250 | ||
6251 | =item Organization of Perl Images | |
954c1994 | 6252 | |
d420ca49 | 6253 | =over 4 |
a45bd81d | 6254 | |
4755096e | 6255 | =item Core Images |
c76ac1ee | 6256 | |
4755096e | 6257 | =item Perl Extensions |
954c1994 | 6258 | |
4755096e | 6259 | =item Installing static extensions |
954c1994 | 6260 | |
4755096e | 6261 | =item Installing dynamic extensions |
954c1994 GS |
6262 | |
6263 | =back | |
6264 | ||
4755096e | 6265 | =item File specifications |
954c1994 | 6266 | |
d420ca49 | 6267 | =over 4 |
954c1994 | 6268 | |
4755096e | 6269 | =item Syntax |
2e1d04bc | 6270 | |
4755096e | 6271 | =item Wildcard expansion |
954c1994 | 6272 | |
4755096e | 6273 | =item Pipes |
c76ac1ee | 6274 | |
a45bd81d GS |
6275 | =back |
6276 | ||
4755096e GS |
6277 | =item PERL5LIB and PERLLIB |
6278 | ||
6279 | =item Command line | |
d516a115 | 6280 | |
d420ca49 | 6281 | =over 4 |
a45bd81d | 6282 | |
4755096e | 6283 | =item I/O redirection and backgrounding |
d516a115 | 6284 | |
4755096e | 6285 | =item Command line switches |
d516a115 | 6286 | |
4755096e GS |
6287 | -i, -S, -u |
6288 | ||
6289 | =back | |
6290 | ||
6291 | =item Perl functions | |
6292 | ||
6293 | File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, | |
6294 | exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select | |
6295 | (system call), stat EXPR, system LIST, time, times, unlink LIST, utime | |
6296 | LIST, waitpid PID,FLAGS | |
6297 | ||
6298 | =item Perl variables | |
6299 | ||
6300 | %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $| | |
6301 | ||
6302 | =item Standard modules with VMS-specific differences | |
d516a115 | 6303 | |
d420ca49 | 6304 | =over 4 |
d516a115 | 6305 | |
4755096e | 6306 | =item SDBM_File |
d516a115 JH |
6307 | |
6308 | =back | |
6309 | ||
4755096e GS |
6310 | =item Revision date |
6311 | ||
6312 | =item AUTHOR | |
6313 | ||
6314 | =back | |
6315 | ||
9a997319 JH |
6316 | =head2 perlvos, README.vos - Perl for Stratus VOS |
6317 | ||
d420ca49 | 6318 | =over 4 |
9a997319 JH |
6319 | |
6320 | =item SYNOPSIS | |
6321 | ||
d420ca49 | 6322 | =over 4 |
9a997319 JH |
6323 | |
6324 | =item Stratus POSIX Support | |
6325 | ||
6326 | =back | |
6327 | ||
6328 | =item INSTALLING PERL IN VOS | |
6329 | ||
d420ca49 | 6330 | =over 4 |
9a997319 JH |
6331 | |
6332 | =item Compiling Perl 5 on VOS | |
6333 | ||
6334 | =item Installing Perl 5 on VOS | |
6335 | ||
6336 | =back | |
6337 | ||
6338 | =item USING PERL IN VOS | |
6339 | ||
d420ca49 | 6340 | =over 4 |
9a997319 JH |
6341 | |
6342 | =item Unimplemented Features | |
6343 | ||
6344 | =item Restrictions | |
6345 | ||
6346 | =back | |
6347 | ||
6348 | =item SUPPORT STATUS | |
6349 | ||
6350 | =item AUTHOR | |
6351 | ||
6352 | =item LAST UPDATE | |
6353 | ||
6354 | =back | |
6355 | ||
8ebc5c01 | 6356 | =head1 PRAGMA DOCUMENTATION |
cb1a09d0 | 6357 | |
c76ac1ee | 6358 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
d516a115 | 6359 | |
d420ca49 | 6360 | =over 4 |
a45bd81d | 6361 | |
d516a115 JH |
6362 | =item SYNOPSIS |
6363 | ||
6364 | =item DESCRIPTION | |
6365 | ||
6366 | method, locked | |
6367 | ||
a45bd81d GS |
6368 | =back |
6369 | ||
fb9cefb4 GS |
6370 | =head2 re - Perl pragma to alter regular expression behaviour |
6371 | ||
d420ca49 | 6372 | =over 4 |
a45bd81d GS |
6373 | |
6374 | =item SYNOPSIS | |
fb9cefb4 GS |
6375 | |
6376 | =item DESCRIPTION | |
6377 | ||
a45bd81d GS |
6378 | =back |
6379 | ||
c76ac1ee GS |
6380 | =head2 attributes - get/set subroutine or variable attributes |
6381 | ||
d420ca49 | 6382 | =over 4 |
a45bd81d | 6383 | |
c76ac1ee GS |
6384 | =item SYNOPSIS |
6385 | ||
6386 | =item DESCRIPTION | |
6387 | ||
d420ca49 | 6388 | =over 4 |
c76ac1ee GS |
6389 | |
6390 | =item Built-in Attributes | |
6391 | ||
694468e3 | 6392 | locked, method, lvalue |
c76ac1ee GS |
6393 | |
6394 | =item Available Subroutines | |
6395 | ||
6396 | get, reftype | |
6397 | ||
6398 | =item Package-specific Attribute Handling | |
6399 | ||
6400 | FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES | |
6401 | ||
6402 | =item Syntax of Attribute Lists | |
6403 | ||
6404 | =back | |
6405 | ||
a45bd81d GS |
6406 | =item EXPORTS |
6407 | ||
d420ca49 | 6408 | =over 4 |
a45bd81d GS |
6409 | |
6410 | =item Default exports | |
6411 | ||
6412 | =item Available exports | |
6413 | ||
6414 | =item Export tags defined | |
6415 | ||
6416 | =back | |
6417 | ||
c76ac1ee GS |
6418 | =item EXAMPLES |
6419 | ||
6420 | =item SEE ALSO | |
6421 | ||
a45bd81d GS |
6422 | =back |
6423 | ||
d46b76b3 JH |
6424 | =head2 attrs - set/get attributes of a subroutine (deprecated) |
6425 | ||
d420ca49 | 6426 | =over 4 |
d46b76b3 JH |
6427 | |
6428 | =item SYNOPSIS | |
6429 | ||
6430 | =item DESCRIPTION | |
6431 | ||
6432 | method, locked | |
6433 | ||
6434 | =back | |
6435 | ||
68dc0745 | 6436 | =head2 autouse - postpone load of modules until a function is used |
6437 | ||
d420ca49 | 6438 | =over 4 |
a45bd81d | 6439 | |
68dc0745 | 6440 | =item SYNOPSIS |
6441 | ||
6442 | =item DESCRIPTION | |
6443 | ||
6444 | =item WARNING | |
6445 | ||
68dc0745 | 6446 | =item AUTHOR |
6447 | ||
6448 | =item SEE ALSO | |
6449 | ||
a45bd81d GS |
6450 | =back |
6451 | ||
d516a115 JH |
6452 | =head2 base - Establish IS-A relationship with base class at compile time |
6453 | ||
d420ca49 | 6454 | =over 4 |
a45bd81d | 6455 | |
d516a115 JH |
6456 | =item SYNOPSIS |
6457 | ||
6458 | =item DESCRIPTION | |
6459 | ||
14218588 GS |
6460 | =item HISTORY |
6461 | ||
fb9cefb4 | 6462 | =item SEE ALSO |
d516a115 | 6463 | |
a45bd81d GS |
6464 | =back |
6465 | ||
8ebc5c01 | 6466 | =head2 blib - Use MakeMaker's uninstalled version of a package |
cb1a09d0 | 6467 | |
d420ca49 | 6468 | =over 4 |
a45bd81d | 6469 | |
8ebc5c01 | 6470 | =item SYNOPSIS |
cb1a09d0 | 6471 | |
8ebc5c01 | 6472 | =item DESCRIPTION |
cb1a09d0 | 6473 | |
8ebc5c01 | 6474 | =item BUGS |
cb1a09d0 | 6475 | |
8ebc5c01 | 6476 | =item AUTHOR |
cb1a09d0 | 6477 | |
a45bd81d GS |
6478 | =back |
6479 | ||
694468e3 GS |
6480 | =head2 bytes - Perl pragma to force byte semantics rather than character |
6481 | semantics | |
a45bd81d | 6482 | |
d420ca49 | 6483 | =over 4 |
a45bd81d GS |
6484 | |
6485 | =item SYNOPSIS | |
6486 | ||
6487 | =item DESCRIPTION | |
6488 | ||
694468e3 | 6489 | =item SEE ALSO |
a10cf691 | 6490 | |
a45bd81d GS |
6491 | =back |
6492 | ||
c76ac1ee GS |
6493 | =head2 charnames - define character names for C<\N{named}> string literal |
6494 | escape. | |
6495 | ||
d420ca49 | 6496 | =over 4 |
a45bd81d | 6497 | |
c76ac1ee GS |
6498 | =item SYNOPSIS |
6499 | ||
6500 | =item DESCRIPTION | |
6501 | ||
6502 | =item CUSTOM TRANSLATORS | |
6503 | ||
6504 | =item BUGS | |
6505 | ||
a45bd81d GS |
6506 | =back |
6507 | ||
54310121 | 6508 | =head2 constant - Perl pragma to declare constants |
6509 | ||
d420ca49 | 6510 | =over 4 |
a45bd81d | 6511 | |
54310121 | 6512 | =item SYNOPSIS |
6513 | ||
6514 | =item DESCRIPTION | |
6515 | ||
6516 | =item NOTES | |
6517 | ||
6518 | =item TECHNICAL NOTE | |
6519 | ||
6520 | =item BUGS | |
6521 | ||
6522 | =item AUTHOR | |
6523 | ||
6524 | =item COPYRIGHT | |
6525 | ||
a45bd81d GS |
6526 | =back |
6527 | ||
8ebc5c01 | 6528 | =head2 diagnostics - Perl compiler pragma to force verbose warning |
6529 | diagnostics | |
cb1a09d0 | 6530 | |
d420ca49 | 6531 | =over 4 |
a45bd81d | 6532 | |
8ebc5c01 | 6533 | =item SYNOPSIS |
cb1a09d0 | 6534 | |
8ebc5c01 | 6535 | =item DESCRIPTION |
cb1a09d0 | 6536 | |
d420ca49 | 6537 | =over 4 |
cb1a09d0 | 6538 | |
8ebc5c01 | 6539 | =item The C<diagnostics> Pragma |
cb1a09d0 | 6540 | |
8ebc5c01 | 6541 | =item The I<splain> Program |
cb1a09d0 | 6542 | |
8ebc5c01 | 6543 | =back |
cb1a09d0 | 6544 | |
8ebc5c01 | 6545 | =item EXAMPLES |
cb1a09d0 | 6546 | |
8ebc5c01 | 6547 | =item INTERNALS |
cb1a09d0 | 6548 | |
8ebc5c01 | 6549 | =item BUGS |
cb1a09d0 | 6550 | |
8ebc5c01 | 6551 | =item AUTHOR |
cb1a09d0 | 6552 | |
a45bd81d GS |
6553 | =back |
6554 | ||
d516a115 JH |
6555 | =head2 fields - compile-time class fields |
6556 | ||
d420ca49 | 6557 | =over 4 |
a45bd81d | 6558 | |
d516a115 JH |
6559 | =item SYNOPSIS |
6560 | ||
6561 | =item DESCRIPTION | |
6562 | ||
694468e3 GS |
6563 | new, phash |
6564 | ||
fb9cefb4 GS |
6565 | =item SEE ALSO |
6566 | ||
a45bd81d GS |
6567 | =back |
6568 | ||
14218588 GS |
6569 | =head2 filetest - Perl pragma to control the filetest permission operators |
6570 | ||
d420ca49 | 6571 | =over 4 |
a45bd81d | 6572 | |
14218588 GS |
6573 | =item SYNOPSIS |
6574 | ||
14218588 GS |
6575 | =item DESCRIPTION |
6576 | ||
d420ca49 | 6577 | =over 4 |
14218588 GS |
6578 | |
6579 | =item subpragma access | |
6580 | ||
6581 | =back | |
6582 | ||
a45bd81d GS |
6583 | =back |
6584 | ||
8ebc5c01 | 6585 | =head2 integer - Perl pragma to compute arithmetic in integer instead of |
6586 | double | |
cb1a09d0 | 6587 | |
d420ca49 | 6588 | =over 4 |
a45bd81d | 6589 | |
8ebc5c01 | 6590 | =item SYNOPSIS |
cb1a09d0 | 6591 | |
8ebc5c01 | 6592 | =item DESCRIPTION |
cb1a09d0 | 6593 | |
a45bd81d GS |
6594 | =back |
6595 | ||
8ebc5c01 | 6596 | =head2 less - perl pragma to request less of something from the compiler |
cb1a09d0 | 6597 | |
d420ca49 | 6598 | =over 4 |
a45bd81d | 6599 | |
8ebc5c01 | 6600 | =item SYNOPSIS |
cb1a09d0 | 6601 | |
8ebc5c01 | 6602 | =item DESCRIPTION |
cb1a09d0 | 6603 | |
a45bd81d GS |
6604 | =back |
6605 | ||
8ebc5c01 | 6606 | =head2 lib - manipulate @INC at compile time |
cb1a09d0 | 6607 | |
d420ca49 | 6608 | =over 4 |
a45bd81d | 6609 | |
8ebc5c01 | 6610 | =item SYNOPSIS |
cb1a09d0 | 6611 | |
8ebc5c01 | 6612 | =item DESCRIPTION |
cb1a09d0 | 6613 | |
d420ca49 | 6614 | =over 4 |
8ebc5c01 | 6615 | |
c76ac1ee | 6616 | =item Adding directories to @INC |
cb1a09d0 | 6617 | |
c76ac1ee | 6618 | =item Deleting directories from @INC |
cb1a09d0 | 6619 | |
c76ac1ee | 6620 | =item Restoring original @INC |
cb1a09d0 | 6621 | |
8ebc5c01 | 6622 | =back |
cb1a09d0 | 6623 | |
8ebc5c01 | 6624 | =item SEE ALSO |
cb1a09d0 | 6625 | |
8ebc5c01 | 6626 | =item AUTHOR |
cb1a09d0 | 6627 | |
a45bd81d GS |
6628 | =back |
6629 | ||
8ebc5c01 | 6630 | =head2 locale - Perl pragma to use and avoid POSIX locales for built-in |
6631 | operations | |
cb1a09d0 | 6632 | |
d420ca49 | 6633 | =over 4 |
a45bd81d | 6634 | |
8ebc5c01 | 6635 | =item SYNOPSIS |
cb1a09d0 AD |
6636 | |
6637 | =item DESCRIPTION | |
6638 | ||
a45bd81d GS |
6639 | =back |
6640 | ||
b38f6a39 GS |
6641 | =head2 open - perl pragma to set default disciplines for input and output |
6642 | ||
d420ca49 | 6643 | =over 4 |
b38f6a39 GS |
6644 | |
6645 | =item SYNOPSIS | |
6646 | ||
6647 | =item DESCRIPTION | |
6648 | ||
6649 | =item UNIMPLEMENTED FUNCTIONALITY | |
6650 | ||
6651 | =item SEE ALSO | |
6652 | ||
6653 | =back | |
6654 | ||
d46b76b3 JH |
6655 | =head2 ops - Perl pragma to restrict unsafe operations when compiling |
6656 | ||
d420ca49 | 6657 | =over 4 |
d46b76b3 JH |
6658 | |
6659 | =item SYNOPSIS | |
6660 | ||
6661 | =item DESCRIPTION | |
6662 | ||
6663 | =item SEE ALSO | |
6664 | ||
6665 | =back | |
6666 | ||
8ebc5c01 | 6667 | =head2 overload - Package for overloading perl operations |
cb1a09d0 | 6668 | |
d420ca49 | 6669 | =over 4 |
a45bd81d | 6670 | |
8ebc5c01 | 6671 | =item SYNOPSIS |
cb1a09d0 | 6672 | |
8ebc5c01 | 6673 | =item DESCRIPTION |
cb1a09d0 | 6674 | |
d420ca49 | 6675 | =over 4 |
cb1a09d0 | 6676 | |
8ebc5c01 | 6677 | =item Declaration of overloaded functions |
cb1a09d0 | 6678 | |
8ebc5c01 | 6679 | =item Calling Conventions for Binary Operations |
cb1a09d0 | 6680 | |
8ebc5c01 | 6681 | FALSE, TRUE, C<undef> |
cb1a09d0 | 6682 | |
8ebc5c01 | 6683 | =item Calling Conventions for Unary Operations |
cb1a09d0 | 6684 | |
14218588 GS |
6685 | =item Calling Conventions for Mutators |
6686 | ||
6687 | C<++> and C<-->, C<x=> and other assignment versions | |
6688 | ||
8ebc5c01 | 6689 | =item Overloadable Operations |
cb1a09d0 | 6690 | |
8ebc5c01 | 6691 | I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>, |
6692 | I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string | |
14218588 | 6693 | and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special> |
cb1a09d0 | 6694 | |
774d564b | 6695 | =item Inheritance and overloading |
6696 | ||
6697 | Strings as values of C<use overload> directive, Overloading of an operation | |
6698 | is inherited by derived classes | |
6699 | ||
8ebc5c01 | 6700 | =back |
cb1a09d0 | 6701 | |
8ebc5c01 | 6702 | =item SPECIAL SYMBOLS FOR C<use overload> |
cb1a09d0 | 6703 | |
d420ca49 | 6704 | =over 4 |
cb1a09d0 | 6705 | |
774d564b | 6706 | =item Last Resort |
cb1a09d0 | 6707 | |
91331b4f | 6708 | =item Fallback |
cb1a09d0 | 6709 | |
8ebc5c01 | 6710 | C<undef>, TRUE, defined, but FALSE |
cb1a09d0 | 6711 | |
8ebc5c01 | 6712 | =item Copy Constructor |
cb1a09d0 | 6713 | |
8ebc5c01 | 6714 | B<Example> |
cb1a09d0 | 6715 | |
8ebc5c01 | 6716 | =back |
cb1a09d0 | 6717 | |
8ebc5c01 | 6718 | =item MAGIC AUTOGENERATION |
cb1a09d0 | 6719 | |
8ebc5c01 | 6720 | I<Assignment forms of arithmetic operations>, I<Conversion operations>, |
6721 | I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>, | |
14218588 GS |
6722 | I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>, |
6723 | I<Copy operator> | |
cb1a09d0 | 6724 | |
14218588 | 6725 | =item Losing overloading |
cb1a09d0 | 6726 | |
8ebc5c01 | 6727 | =item Run-time Overloading |
cb1a09d0 | 6728 | |
8ebc5c01 | 6729 | =item Public functions |
cb1a09d0 | 6730 | |
8ebc5c01 | 6731 | overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op) |
cb1a09d0 | 6732 | |
fb9cefb4 GS |
6733 | =item Overloading constants |
6734 | ||
6735 | integer, float, binary, q, qr | |
6736 | ||
8ebc5c01 | 6737 | =item IMPLEMENTATION |
cb1a09d0 | 6738 | |
14218588 GS |
6739 | =item Metaphor clash |
6740 | ||
6741 | =item Cookbook | |
6742 | ||
d420ca49 | 6743 | =over 4 |
14218588 GS |
6744 | |
6745 | =item Two-face scalars | |
6746 | ||
6747 | =item Two-face references | |
6748 | ||
6749 | =item Symbolic calculator | |
6750 | ||
6751 | =item I<Really> symbolic calculator | |
6752 | ||
4755096e | 6753 | =back |
497711e7 | 6754 | |
4755096e | 6755 | =item AUTHOR |
497711e7 | 6756 | |
4755096e | 6757 | =item DIAGNOSTICS |
497711e7 | 6758 | |
93d73c42 JH |
6759 | Odd number of arguments for overload::constant, `%s' is not an overloadable |
6760 | type, `%s' is not a code reference | |
6761 | ||
4755096e | 6762 | =item BUGS |
497711e7 GS |
6763 | |
6764 | =back | |
6765 | ||
d420ca49 AD |
6766 | =head2 perlio - perl pragma to configure C level IO |
6767 | ||
6768 | =over 4 | |
6769 | ||
6770 | =item SYNOPSIS | |
6771 | ||
6772 | =item DESCRIPTION | |
6773 | ||
6774 | unix, stdio, perlio | |
6775 | ||
6776 | =over 4 | |
6777 | ||
6778 | =item Defaults and how to override them | |
6779 | ||
6780 | =back | |
6781 | ||
6782 | =item AUTHOR | |
6783 | ||
6784 | =back | |
6785 | ||
14218588 GS |
6786 | =head2 re - Perl pragma to alter regular expression behaviour |
6787 | ||
d420ca49 | 6788 | =over 4 |
a45bd81d | 6789 | |
14218588 GS |
6790 | =item SYNOPSIS |
6791 | ||
6792 | =item DESCRIPTION | |
6793 | ||
a45bd81d GS |
6794 | =back |
6795 | ||
8ebc5c01 | 6796 | =head2 sigtrap - Perl pragma to enable simple signal handling |
cb1a09d0 | 6797 | |
d420ca49 | 6798 | =over 4 |
a45bd81d | 6799 | |
8ebc5c01 | 6800 | =item SYNOPSIS |
cb1a09d0 | 6801 | |
8ebc5c01 | 6802 | =item DESCRIPTION |
cb1a09d0 | 6803 | |
8ebc5c01 | 6804 | =item OPTIONS |
cb1a09d0 | 6805 | |
d420ca49 | 6806 | =over 4 |
cb1a09d0 | 6807 | |
8ebc5c01 | 6808 | =item SIGNAL HANDLERS |
cb1a09d0 | 6809 | |
8ebc5c01 | 6810 | B<stack-trace>, B<die>, B<handler> I<your-handler> |
cb1a09d0 | 6811 | |
8ebc5c01 | 6812 | =item SIGNAL LISTS |
cb1a09d0 | 6813 | |
8ebc5c01 | 6814 | B<normal-signals>, B<error-signals>, B<old-interface-signals> |
cb1a09d0 | 6815 | |
8ebc5c01 | 6816 | =item OTHER |
cb1a09d0 | 6817 | |
8ebc5c01 | 6818 | B<untrapped>, B<any>, I<signal>, I<number> |
cb1a09d0 | 6819 | |
8ebc5c01 | 6820 | =back |
cb1a09d0 | 6821 | |
8ebc5c01 | 6822 | =item EXAMPLES |
cb1a09d0 | 6823 | |
a45bd81d GS |
6824 | =back |
6825 | ||
8ebc5c01 | 6826 | =head2 strict - Perl pragma to restrict unsafe constructs |
cb1a09d0 | 6827 | |
d420ca49 | 6828 | =over 4 |
a45bd81d | 6829 | |
8ebc5c01 | 6830 | =item SYNOPSIS |
cb1a09d0 | 6831 | |
8ebc5c01 | 6832 | =item DESCRIPTION |
cb1a09d0 | 6833 | |
8ebc5c01 | 6834 | C<strict refs>, C<strict vars>, C<strict subs> |
cb1a09d0 | 6835 | |
a45bd81d GS |
6836 | =back |
6837 | ||
8ebc5c01 | 6838 | =head2 subs - Perl pragma to predeclare sub names |
cb1a09d0 | 6839 | |
d420ca49 | 6840 | =over 4 |
a45bd81d | 6841 | |
cb1a09d0 AD |
6842 | =item SYNOPSIS |
6843 | ||
cb1a09d0 AD |
6844 | =item DESCRIPTION |
6845 | ||
a45bd81d GS |
6846 | =back |
6847 | ||
694468e3 | 6848 | =head2 utf8 - Perl pragma to enable/disable UTF-8 in source code |
14218588 | 6849 | |
d420ca49 | 6850 | =over 4 |
a45bd81d | 6851 | |
14218588 GS |
6852 | =item SYNOPSIS |
6853 | ||
6854 | =item DESCRIPTION | |
6855 | ||
694468e3 | 6856 | =item SEE ALSO |
14218588 | 6857 | |
a45bd81d GS |
6858 | =back |
6859 | ||
6860 | =head2 vars - Perl pragma to predeclare global variable names (obsolete) | |
6861 | ||
d420ca49 | 6862 | =over 4 |
cb1a09d0 | 6863 | |
8ebc5c01 | 6864 | =item SYNOPSIS |
cb1a09d0 | 6865 | |
8ebc5c01 | 6866 | =item DESCRIPTION |
cb1a09d0 | 6867 | |
a45bd81d GS |
6868 | =back |
6869 | ||
4438c4b7 | 6870 | =head2 warnings - Perl pragma to control optional warnings |
14218588 | 6871 | |
d420ca49 | 6872 | =over 4 |
a45bd81d | 6873 | |
14218588 GS |
6874 | =item SYNOPSIS |
6875 | ||
6876 | =item DESCRIPTION | |
6877 | ||
a9ef4385 JH |
6878 | use warnings::register, warnings::enabled(), warnings::enabled($category), |
6879 | warnings::enabled($object), warnings::warn($message), | |
6880 | warnings::warn($category, $message), warnings::warn($object, $message), | |
6881 | warnings::warnif($message), warnings::warnif($category, $message), | |
6882 | warnings::warnif($object, $message) | |
694468e3 | 6883 | |
a45bd81d GS |
6884 | =back |
6885 | ||
4755096e GS |
6886 | =head2 warnings::register - warnings import function |
6887 | ||
8ebc5c01 | 6888 | =head1 MODULE DOCUMENTATION |
cb1a09d0 | 6889 | |
8ebc5c01 | 6890 | =head2 AnyDBM_File - provide framework for multiple DBMs |
cb1a09d0 | 6891 | |
d420ca49 | 6892 | =over 4 |
a45bd81d | 6893 | |
cb1a09d0 AD |
6894 | =item SYNOPSIS |
6895 | ||
cb1a09d0 AD |
6896 | =item DESCRIPTION |
6897 | ||
d420ca49 | 6898 | =over 4 |
cb1a09d0 | 6899 | |
8ebc5c01 | 6900 | =item DBM Comparisons |
cb1a09d0 | 6901 | |
8ebc5c01 | 6902 | [0], [1], [2], [3] |
cb1a09d0 | 6903 | |
8ebc5c01 | 6904 | =back |
cb1a09d0 | 6905 | |
8ebc5c01 | 6906 | =item SEE ALSO |
cb1a09d0 | 6907 | |
a45bd81d GS |
6908 | =back |
6909 | ||
4a6725af | 6910 | =head2 AutoLoader - load subroutines only on demand |
cb1a09d0 | 6911 | |
d420ca49 | 6912 | =over 4 |
a45bd81d | 6913 | |
8ebc5c01 | 6914 | =item SYNOPSIS |
cb1a09d0 | 6915 | |
8ebc5c01 | 6916 | =item DESCRIPTION |
cb1a09d0 | 6917 | |
d420ca49 | 6918 | =over 4 |
cb1a09d0 | 6919 | |
4a6725af NT |
6920 | =item Subroutine Stubs |
6921 | ||
6922 | =item Using B<AutoLoader>'s AUTOLOAD Subroutine | |
cb1a09d0 | 6923 | |
4a6725af | 6924 | =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine |
cb1a09d0 | 6925 | |
8ebc5c01 | 6926 | =item Package Lexicals |
cb1a09d0 | 6927 | |
7029d033 JH |
6928 | =item Not Using AutoLoader |
6929 | ||
4a6725af | 6930 | =item B<AutoLoader> vs. B<SelfLoader> |
cb1a09d0 | 6931 | |
8ebc5c01 | 6932 | =back |
cb1a09d0 | 6933 | |
4a6725af NT |
6934 | =item CAVEATS |
6935 | ||
6936 | =item SEE ALSO | |
cb1a09d0 | 6937 | |
a45bd81d GS |
6938 | =back |
6939 | ||
8ebc5c01 | 6940 | =head2 AutoSplit - split a package for autoloading |
cb1a09d0 | 6941 | |
d420ca49 | 6942 | =over 4 |
a45bd81d | 6943 | |
8ebc5c01 | 6944 | =item SYNOPSIS |
cb1a09d0 | 6945 | |
8ebc5c01 | 6946 | =item DESCRIPTION |
cb1a09d0 | 6947 | |
193fb0af GS |
6948 | $keep, $check, $modtime |
6949 | ||
d420ca49 | 6950 | =over 4 |
193fb0af GS |
6951 | |
6952 | =item Multiple packages | |
6953 | ||
6954 | =back | |
cb1a09d0 | 6955 | |
8ebc5c01 | 6956 | =item DIAGNOSTICS |
cb1a09d0 | 6957 | |
a45bd81d GS |
6958 | =back |
6959 | ||
fb9cefb4 | 6960 | =head2 B - The Perl Compiler |
193fb0af | 6961 | |
d420ca49 | 6962 | =over 4 |
a45bd81d | 6963 | |
193fb0af GS |
6964 | =item SYNOPSIS |
6965 | ||
6966 | =item DESCRIPTION | |
6967 | ||
fb9cefb4 | 6968 | =item OVERVIEW OF CLASSES |
193fb0af | 6969 | |
d420ca49 | 6970 | =over 4 |
193fb0af | 6971 | |
fb9cefb4 | 6972 | =item SV-RELATED CLASSES |
193fb0af | 6973 | |
fb9cefb4 | 6974 | =item B::SV METHODS |
193fb0af | 6975 | |
fb9cefb4 | 6976 | REFCNT, FLAGS |
193fb0af | 6977 | |
fb9cefb4 | 6978 | =item B::IV METHODS |
193fb0af | 6979 | |
fb9cefb4 | 6980 | IV, IVX, needs64bits, packiv |
193fb0af | 6981 | |
fb9cefb4 | 6982 | =item B::NV METHODS |
193fb0af | 6983 | |
fb9cefb4 | 6984 | NV, NVX |
193fb0af | 6985 | |
fb9cefb4 | 6986 | =item B::RV METHODS |
193fb0af | 6987 | |
fb9cefb4 | 6988 | RV |
193fb0af | 6989 | |
fb9cefb4 | 6990 | =item B::PV METHODS |
193fb0af | 6991 | |
fb9cefb4 | 6992 | PV |
193fb0af | 6993 | |
fb9cefb4 | 6994 | =item B::PVMG METHODS |
cb1a09d0 | 6995 | |
fb9cefb4 | 6996 | MAGIC, SvSTASH |
cb1a09d0 | 6997 | |
fb9cefb4 | 6998 | =item B::MAGIC METHODS |
cb1a09d0 | 6999 | |
fb9cefb4 | 7000 | MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR |
cb1a09d0 | 7001 | |
fb9cefb4 | 7002 | =item B::PVLV METHODS |
cb1a09d0 | 7003 | |
fb9cefb4 | 7004 | TARGOFF, TARGLEN, TYPE, TARG |
cb1a09d0 | 7005 | |
fb9cefb4 | 7006 | =item B::BM METHODS |
cb1a09d0 | 7007 | |
fb9cefb4 | 7008 | USEFUL, PREVIOUS, RARE, TABLE |
cb1a09d0 | 7009 | |
fb9cefb4 | 7010 | =item B::GV METHODS |
cb1a09d0 | 7011 | |
694468e3 GS |
7012 | is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE, |
7013 | FILEGV, GvREFCNT, FLAGS | |
54310121 | 7014 | |
fb9cefb4 | 7015 | =item B::IO METHODS |
cb1a09d0 | 7016 | |
fb9cefb4 GS |
7017 | LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV, |
7018 | BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS | |
cb1a09d0 | 7019 | |
fb9cefb4 | 7020 | =item B::AV METHODS |
cb1a09d0 | 7021 | |
fb9cefb4 | 7022 | FILL, MAX, OFF, ARRAY, AvFLAGS |
cb1a09d0 | 7023 | |
fb9cefb4 | 7024 | =item B::CV METHODS |
cb1a09d0 | 7025 | |
a45bd81d | 7026 | STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY, |
a7ffa9b9 | 7027 | CvFLAGS, const_sv |
cb1a09d0 | 7028 | |
fb9cefb4 | 7029 | =item B::HV METHODS |
f86702cc | 7030 | |
fb9cefb4 | 7031 | FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY |
f86702cc | 7032 | |
fb9cefb4 | 7033 | =item OP-RELATED CLASSES |
f86702cc | 7034 | |
fb9cefb4 | 7035 | =item B::OP METHODS |
f86702cc | 7036 | |
c76ac1ee | 7037 | next, sibling, name, ppaddr, desc, targ, type, seq, flags, private |
f86702cc | 7038 | |
fb9cefb4 | 7039 | =item B::UNOP METHOD |
54310121 | 7040 | |
fb9cefb4 | 7041 | first |
dc848c6f | 7042 | |
fb9cefb4 | 7043 | =item B::BINOP METHOD |
54310121 | 7044 | |
fb9cefb4 | 7045 | last |
54310121 | 7046 | |
fb9cefb4 | 7047 | =item B::LOGOP METHOD |
54310121 | 7048 | |
fb9cefb4 | 7049 | other |
54310121 | 7050 | |
fb9cefb4 | 7051 | =item B::LISTOP METHOD |
54310121 | 7052 | |
fb9cefb4 | 7053 | children |
54310121 | 7054 | |
fb9cefb4 | 7055 | =item B::PMOP METHODS |
54310121 | 7056 | |
fb9cefb4 | 7057 | pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp |
54310121 | 7058 | |
fb9cefb4 | 7059 | =item B::SVOP METHOD |
54310121 | 7060 | |
a45bd81d | 7061 | sv, gv |
54310121 | 7062 | |
a45bd81d | 7063 | =item B::PADOP METHOD |
54310121 | 7064 | |
a45bd81d | 7065 | padix |
54310121 | 7066 | |
fb9cefb4 | 7067 | =item B::PVOP METHOD |
54310121 | 7068 | |
fb9cefb4 | 7069 | pv |
54310121 | 7070 | |
fb9cefb4 | 7071 | =item B::LOOP METHODS |
54310121 | 7072 | |
fb9cefb4 | 7073 | redoop, nextop, lastop |
54310121 | 7074 | |
fb9cefb4 | 7075 | =item B::COP METHODS |
54310121 | 7076 | |
a45bd81d | 7077 | label, stash, file, cop_seq, arybase, line |
54310121 | 7078 | |
fb9cefb4 | 7079 | =back |
54310121 | 7080 | |
fb9cefb4 | 7081 | =item FUNCTIONS EXPORTED BY C<B> |
54310121 | 7082 | |
14218588 GS |
7083 | main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes, |
7084 | sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), | |
7085 | walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), | |
a10cf691 | 7086 | hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names |
54310121 | 7087 | |
fb9cefb4 | 7088 | =item AUTHOR |
54310121 | 7089 | |
a45bd81d GS |
7090 | =back |
7091 | ||
fb9cefb4 GS |
7092 | =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate |
7093 | bytecode | |
54310121 | 7094 | |
d420ca49 | 7095 | =over 4 |
a45bd81d | 7096 | |
fb9cefb4 | 7097 | =item SYNOPSIS |
54310121 | 7098 | |
fb9cefb4 | 7099 | =item DESCRIPTION |
54310121 | 7100 | |
fb9cefb4 | 7101 | =item AUTHOR |
54310121 | 7102 | |
a45bd81d GS |
7103 | =back |
7104 | ||
fb9cefb4 | 7105 | =head2 B::Assembler - Assemble Perl bytecode |
54310121 | 7106 | |
d420ca49 | 7107 | =over 4 |
a45bd81d | 7108 | |
fb9cefb4 | 7109 | =item SYNOPSIS |
54310121 | 7110 | |
fb9cefb4 | 7111 | =item DESCRIPTION |
54310121 | 7112 | |
a9ef4385 | 7113 | =item AUTHORS |
54310121 | 7114 | |
a45bd81d GS |
7115 | =back |
7116 | ||
fb9cefb4 | 7117 | =head2 B::Bblock - Walk basic blocks |
54310121 | 7118 | |
d420ca49 | 7119 | =over 4 |
a45bd81d | 7120 | |
fb9cefb4 | 7121 | =item SYNOPSIS |
54310121 | 7122 | |
fb9cefb4 | 7123 | =item DESCRIPTION |
54310121 | 7124 | |
fb9cefb4 | 7125 | =item AUTHOR |
54310121 | 7126 | |
a45bd81d GS |
7127 | =back |
7128 | ||
fb9cefb4 | 7129 | =head2 B::Bytecode - Perl compiler's bytecode backend |
54310121 | 7130 | |
d420ca49 | 7131 | =over 4 |
a45bd81d | 7132 | |
fb9cefb4 | 7133 | =item SYNOPSIS |
54310121 | 7134 | |
fb9cefb4 GS |
7135 | =item DESCRIPTION |
7136 | ||
7137 | =item OPTIONS | |
7138 | ||
a45bd81d | 7139 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, |
a9ef4385 | 7140 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, |
91331b4f | 7141 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the |
a9ef4385 | 7142 | output. =back |
fb9cefb4 | 7143 | |
14218588 GS |
7144 | =item EXAMPLES |
7145 | ||
fb9cefb4 GS |
7146 | =item BUGS |
7147 | ||
a9ef4385 | 7148 | =item AUTHORS |
fb9cefb4 | 7149 | |
a45bd81d GS |
7150 | =back |
7151 | ||
fb9cefb4 GS |
7152 | =head2 B::C - Perl compiler's C backend |
7153 | ||
d420ca49 | 7154 | =over 4 |
a45bd81d | 7155 | |
fb9cefb4 GS |
7156 | =item SYNOPSIS |
7157 | ||
7158 | =item DESCRIPTION | |
7159 | ||
7160 | =item OPTIONS | |
7161 | ||
7162 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>, | |
694468e3 | 7163 | B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit> |
fb9cefb4 GS |
7164 | |
7165 | =item EXAMPLES | |
7166 | ||
7167 | =item BUGS | |
7168 | ||
7169 | =item AUTHOR | |
7170 | ||
a45bd81d GS |
7171 | =back |
7172 | ||
fb9cefb4 GS |
7173 | =head2 B::CC - Perl compiler's optimized C translation backend |
7174 | ||
d420ca49 | 7175 | =over 4 |
a45bd81d | 7176 | |
fb9cefb4 GS |
7177 | =item SYNOPSIS |
7178 | ||
7179 | =item DESCRIPTION | |
7180 | ||
7181 | =item OPTIONS | |
7182 | ||
7183 | B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>, | |
7184 | B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>, | |
7185 | B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On> | |
7186 | ||
7187 | =item EXAMPLES | |
7188 | ||
7189 | =item BUGS | |
7190 | ||
7191 | =item DIFFERENCES | |
7192 | ||
d420ca49 | 7193 | =over 4 |
fb9cefb4 GS |
7194 | |
7195 | =item Loops | |
7196 | ||
7197 | =item Context of ".." | |
7198 | ||
7199 | =item Arithmetic | |
7200 | ||
7201 | =item Deprecated features | |
7202 | ||
7203 | =back | |
7204 | ||
7205 | =item AUTHOR | |
7206 | ||
a45bd81d GS |
7207 | =back |
7208 | ||
fb9cefb4 GS |
7209 | =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops |
7210 | ||
d420ca49 | 7211 | =over 4 |
a45bd81d | 7212 | |
fb9cefb4 GS |
7213 | =item SYNOPSIS |
7214 | ||
7215 | =item DESCRIPTION | |
7216 | ||
7217 | =item AUTHOR | |
7218 | ||
a45bd81d GS |
7219 | =back |
7220 | ||
fb9cefb4 GS |
7221 | =head2 B::Deparse - Perl compiler backend to produce perl code |
7222 | ||
d420ca49 | 7223 | =over 4 |
a45bd81d | 7224 | |
fb9cefb4 GS |
7225 | =item SYNOPSIS |
7226 | ||
7227 | =item DESCRIPTION | |
7228 | ||
7229 | =item OPTIONS | |
7230 | ||
c76ac1ee GS |
7231 | B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>, |
7232 | B<T>, B<v>I<STRING>B<.> | |
7233 | ||
7234 | =item USING B::Deparse AS A MODULE | |
7235 | ||
d420ca49 | 7236 | =over 4 |
c76ac1ee GS |
7237 | |
7238 | =item Synopsis | |
7239 | ||
7240 | =item Description | |
7241 | ||
7242 | =item new | |
7243 | ||
7244 | =item coderef2text | |
7245 | ||
7246 | =back | |
fb9cefb4 GS |
7247 | |
7248 | =item BUGS | |
7249 | ||
7250 | =item AUTHOR | |
7251 | ||
a45bd81d GS |
7252 | =back |
7253 | ||
fb9cefb4 GS |
7254 | =head2 B::Disassembler - Disassemble Perl bytecode |
7255 | ||
d420ca49 | 7256 | =over 4 |
a45bd81d | 7257 | |
fb9cefb4 GS |
7258 | =item SYNOPSIS |
7259 | ||
7260 | =item DESCRIPTION | |
7261 | ||
7262 | =item AUTHOR | |
7263 | ||
a45bd81d GS |
7264 | =back |
7265 | ||
fb9cefb4 GS |
7266 | =head2 B::Lint - Perl lint |
7267 | ||
d420ca49 | 7268 | =over 4 |
a45bd81d | 7269 | |
fb9cefb4 GS |
7270 | =item SYNOPSIS |
7271 | ||
7272 | =item DESCRIPTION | |
7273 | ||
7274 | =item OPTIONS AND LINT CHECKS | |
7275 | ||
7276 | B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>, | |
7277 | B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none> | |
7278 | ||
7279 | =item NON LINT-CHECK OPTIONS | |
7280 | ||
7281 | B<-u Package> | |
7282 | ||
7283 | =item BUGS | |
7284 | ||
7285 | =item AUTHOR | |
7286 | ||
a45bd81d GS |
7287 | =back |
7288 | ||
fb9cefb4 GS |
7289 | =head2 B::O, O - Generic interface to Perl Compiler backends |
7290 | ||
d420ca49 | 7291 | =over 4 |
a45bd81d | 7292 | |
fb9cefb4 GS |
7293 | =item SYNOPSIS |
7294 | ||
7295 | =item DESCRIPTION | |
7296 | ||
7297 | =item CONVENTIONS | |
7298 | ||
7299 | =item IMPLEMENTATION | |
7300 | ||
7301 | =item AUTHOR | |
7302 | ||
a45bd81d GS |
7303 | =back |
7304 | ||
fb9cefb4 GS |
7305 | =head2 B::Showlex - Show lexical variables used in functions or files |
7306 | ||
d420ca49 | 7307 | =over 4 |
a45bd81d | 7308 | |
fb9cefb4 GS |
7309 | =item SYNOPSIS |
7310 | ||
7311 | =item DESCRIPTION | |
7312 | ||
7313 | =item AUTHOR | |
7314 | ||
a45bd81d GS |
7315 | =back |
7316 | ||
fb9cefb4 GS |
7317 | =head2 B::Stackobj - Helper module for CC backend |
7318 | ||
d420ca49 | 7319 | =over 4 |
a45bd81d | 7320 | |
fb9cefb4 GS |
7321 | =item SYNOPSIS |
7322 | ||
7323 | =item DESCRIPTION | |
7324 | ||
7325 | =item AUTHOR | |
7326 | ||
a45bd81d GS |
7327 | =back |
7328 | ||
4755096e GS |
7329 | =head2 B::Stash - show what stashes are loaded |
7330 | ||
fb9cefb4 GS |
7331 | =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops |
7332 | ||
d420ca49 | 7333 | =over 4 |
a45bd81d | 7334 | |
fb9cefb4 GS |
7335 | =item SYNOPSIS |
7336 | ||
7337 | =item DESCRIPTION | |
7338 | ||
7339 | =item AUTHOR | |
7340 | ||
a45bd81d GS |
7341 | =back |
7342 | ||
fb9cefb4 GS |
7343 | =head2 B::Xref - Generates cross reference reports for Perl programs |
7344 | ||
d420ca49 | 7345 | =over 4 |
a45bd81d | 7346 | |
fb9cefb4 GS |
7347 | =item SYNOPSIS |
7348 | ||
7349 | =item DESCRIPTION | |
7350 | ||
7351 | =item OPTIONS | |
7352 | ||
7353 | C<-oFILENAME>, C<-r>, C<-D[tO]> | |
7354 | ||
7355 | =item BUGS | |
7356 | ||
7357 | =item AUTHOR | |
7358 | ||
a45bd81d GS |
7359 | =back |
7360 | ||
14218588 GS |
7361 | =head2 Bblock, B::Bblock - Walk basic blocks |
7362 | ||
d420ca49 | 7363 | =over 4 |
a45bd81d | 7364 | |
14218588 GS |
7365 | =item SYNOPSIS |
7366 | ||
7367 | =item DESCRIPTION | |
7368 | ||
7369 | =item AUTHOR | |
7370 | ||
a45bd81d GS |
7371 | =back |
7372 | ||
7373 | =head2 Benchmark - benchmark running times of Perl code | |
7374 | ||
d420ca49 | 7375 | =over 4 |
fb9cefb4 GS |
7376 | |
7377 | =item SYNOPSIS | |
7378 | ||
7379 | =item DESCRIPTION | |
7380 | ||
d420ca49 | 7381 | =over 4 |
fb9cefb4 GS |
7382 | |
7383 | =item Methods | |
7384 | ||
c76ac1ee | 7385 | new, debug, iters |
fb9cefb4 GS |
7386 | |
7387 | =item Standard Exports | |
7388 | ||
7389 | timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ), | |
c76ac1ee GS |
7390 | timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr ( |
7391 | TIMEDIFF, [ STYLE, [ FORMAT ] ] ) | |
fb9cefb4 GS |
7392 | |
7393 | =item Optional Exports | |
7394 | ||
c76ac1ee GS |
7395 | clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [ |
7396 | STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( | |
7397 | ), enablecache ( ), timesum ( T1, T2 ) | |
fb9cefb4 GS |
7398 | |
7399 | =back | |
7400 | ||
7401 | =item NOTES | |
7402 | ||
a45bd81d GS |
7403 | =item EXAMPLES |
7404 | ||
fb9cefb4 GS |
7405 | =item INHERITANCE |
7406 | ||
7407 | =item CAVEATS | |
7408 | ||
a45bd81d GS |
7409 | =item SEE ALSO |
7410 | ||
fb9cefb4 GS |
7411 | =item AUTHORS |
7412 | ||
7413 | =item MODIFICATION HISTORY | |
7414 | ||
a45bd81d GS |
7415 | =back |
7416 | ||
14218588 GS |
7417 | =head2 ByteLoader - load byte compiled perl code |
7418 | ||
d420ca49 | 7419 | =over 4 |
a45bd81d | 7420 | |
14218588 GS |
7421 | =item SYNOPSIS |
7422 | ||
7423 | =item DESCRIPTION | |
7424 | ||
7425 | =item AUTHOR | |
7426 | ||
7427 | =item SEE ALSO | |
7428 | ||
a45bd81d GS |
7429 | =back |
7430 | ||
14218588 GS |
7431 | =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend |
7432 | ||
d420ca49 | 7433 | =over 4 |
a45bd81d | 7434 | |
14218588 GS |
7435 | =item SYNOPSIS |
7436 | ||
7437 | =item DESCRIPTION | |
7438 | ||
7439 | =item OPTIONS | |
7440 | ||
a45bd81d | 7441 | B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, |
a9ef4385 | 7442 | B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, |
91331b4f | 7443 | B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the |
a9ef4385 | 7444 | output. =back |
14218588 GS |
7445 | |
7446 | =item EXAMPLES | |
7447 | ||
7448 | =item BUGS | |
7449 | ||
a9ef4385 | 7450 | =item AUTHORS |
14218588 | 7451 | |
a45bd81d GS |
7452 | =back |
7453 | ||
fb9cefb4 GS |
7454 | =head2 CGI - Simple Common Gateway Interface Class |
7455 | ||
d420ca49 | 7456 | =over 4 |
a45bd81d | 7457 | |
fb9cefb4 GS |
7458 | =item SYNOPSIS |
7459 | ||
7460 | =item ABSTRACT | |
7461 | ||
7462 | =item DESCRIPTION | |
7463 | ||
d420ca49 | 7464 | =over 4 |
fb9cefb4 GS |
7465 | |
7466 | =item PROGRAMMING STYLE | |
7467 | ||
7468 | =item CALLING CGI.PM ROUTINES | |
7469 | ||
0e032a14 | 7470 | 1. Use another name for the argument, if one is available. For example, |
fb9cefb4 GS |
7471 | -value is an alias for -values, 2. Change the capitalization, e.g. -Values, |
7472 | 3. Put quotes around the argument name, e.g. '-values' | |
7473 | ||
7474 | =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE): | |
7475 | ||
7476 | =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE | |
7477 | ||
7478 | =item FETCHING A LIST OF KEYWORDS FROM THE QUERY: | |
7479 | ||
7480 | =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT: | |
7481 | ||
7482 | =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER: | |
7483 | ||
7484 | =item SETTING THE VALUE(S) OF A NAMED PARAMETER: | |
7485 | ||
7486 | =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER: | |
7487 | ||
7488 | =item IMPORTING ALL PARAMETERS INTO A NAMESPACE: | |
7489 | ||
7490 | =item DELETING A PARAMETER COMPLETELY: | |
7491 | ||
7492 | =item DELETING ALL PARAMETERS: | |
7493 | ||
7494 | =item DIRECT ACCESS TO THE PARAMETER LIST: | |
7495 | ||
a10cf691 GS |
7496 | =item FETCHING THE PARAMETER LIST AS A HASH: |
7497 | ||
fb9cefb4 GS |
7498 | =item SAVING THE STATE OF THE SCRIPT TO A FILE: |
7499 | ||
a10cf691 GS |
7500 | =item RETRIEVING CGI ERRORS |
7501 | ||
fb9cefb4 GS |
7502 | =item USING THE FUNCTION-ORIENTED INTERFACE |
7503 | ||
7504 | B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>, | |
7505 | B<:standard>, B<:all> | |
7506 | ||
7507 | =item PRAGMAS | |
7508 | ||
10862624 RF |
7509 | -any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls, |
7510 | -autoload, -no_debug, -debug, -private_tempfiles | |
fb9cefb4 | 7511 | |
14218588 GS |
7512 | =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS |
7513 | ||
7514 | 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a | |
7515 | </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates | |
7516 | a </UL> tag) | |
7517 | ||
7518 | =back | |
fb9cefb4 GS |
7519 | |
7520 | =item GENERATING DYNAMIC DOCUMENTS | |
7521 | ||
d420ca49 | 7522 | =over 4 |
fb9cefb4 GS |
7523 | |
7524 | =item CREATING A STANDARD HTTP HEADER: | |
7525 | ||
7526 | =item GENERATING A REDIRECTION HEADER | |
7527 | ||
7528 | =item CREATING THE HTML DOCUMENT HEADER | |
7529 | ||
7530 | B<Parameters:>, 4, 5, 6.. | |
7531 | ||
7532 | =item ENDING THE HTML DOCUMENT: | |
7533 | ||
7534 | =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION: | |
7535 | ||
7536 | =item OBTAINING THE SCRIPT'S URL | |
7537 | ||
7538 | B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query> | |
37d4d706 | 7539 | (B<-query_string>), B<-base> |
fb9cefb4 | 7540 | |
14218588 GS |
7541 | =item MIXING POST AND URL PARAMETERS |
7542 | ||
fb9cefb4 GS |
7543 | =back |
7544 | ||
7545 | =item CREATING STANDARD HTML ELEMENTS: | |
7546 | ||
d420ca49 | 7547 | =over 4 |
fb9cefb4 GS |
7548 | |
7549 | =item PROVIDING ARGUMENTS TO HTML SHORTCUTS | |
7550 | ||
7551 | =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS | |
7552 | ||
7553 | =item HTML SHORTCUTS AND LIST INTERPOLATION | |
7554 | ||
7555 | =item NON-STANDARD HTML SHORTCUTS | |
7556 | ||
d722968f JH |
7557 | =item AUTOESCAPING HTML |
7558 | ||
7559 | $escaped_string = escapeHTML("unescaped string");, $charset = | |
7560 | charset([$charset]);, $flag = autoEscape([$flag]); | |
7561 | ||
14218588 GS |
7562 | =item PRETTY-PRINTING HTML |
7563 | ||
fb9cefb4 GS |
7564 | =back |
7565 | ||
7566 | =item CREATING FILL-OUT FORMS: | |
7567 | ||
d420ca49 | 7568 | =over 4 |
fb9cefb4 GS |
7569 | |
7570 | =item CREATING AN ISINDEX TAG | |
7571 | ||
7572 | =item STARTING AND ENDING A FORM | |
7573 | ||
7574 | B<application/x-www-form-urlencoded>, B<multipart/form-data> | |
7575 | ||
7576 | =item CREATING A TEXT FIELD | |
7577 | ||
7578 | B<Parameters> | |
7579 | ||
7580 | =item CREATING A BIG TEXT FIELD | |
7581 | ||
7582 | =item CREATING A PASSWORD FIELD | |
7583 | ||
7584 | =item CREATING A FILE UPLOAD FIELD | |
7585 | ||
7586 | B<Parameters> | |
7587 | ||
7588 | =item CREATING A POPUP MENU | |
7589 | ||
7590 | =item CREATING A SCROLLING LIST | |
7591 | ||
7592 | B<Parameters:> | |
7593 | ||
7594 | =item CREATING A GROUP OF RELATED CHECKBOXES | |
54310121 | 7595 | |
7596 | B<Parameters:> | |
7597 | ||
7598 | =item CREATING A STANDALONE CHECKBOX | |
7599 | ||
7600 | B<Parameters:> | |
7601 | ||
7602 | =item CREATING A RADIO BUTTON GROUP | |
7603 | ||
7604 | B<Parameters:> | |
7605 | ||
7606 | =item CREATING A SUBMIT BUTTON | |
7607 | ||
7608 | B<Parameters:> | |
7609 | ||
7610 | =item CREATING A RESET BUTTON | |
7611 | ||
7612 | =item CREATING A DEFAULT BUTTON | |
7613 | ||
7614 | =item CREATING A HIDDEN FIELD | |
7615 | ||
7616 | B<Parameters:> | |
7617 | ||
7618 | =item CREATING A CLICKABLE IMAGE BUTTON | |
7619 | ||
0e032a14 JH |
7620 | B<Parameters:>, 3. The third option (-align, optional) is an alignment |
7621 | type, and may be TOP, BOTTOM or MIDDLE | |
54310121 | 7622 | |
7623 | =item CREATING A JAVASCRIPT ACTION BUTTON | |
7624 | ||
7625 | =back | |
7626 | ||
14218588 | 7627 | =item HTTP COOKIES |
54310121 | 7628 | |
7629 | 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag, | |
7630 | B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure> | |
7631 | ||
14218588 | 7632 | =item WORKING WITH FRAMES |
54310121 | 7633 | |
7634 | 1. Create a <Frameset> document, 2. Specify the destination for the | |
7635 | document in the HTTP header, 3. Specify the destination for the document in | |
7636 | the <FORM> tag | |
7637 | ||
c90c0ff4 | 7638 | =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS |
7639 | ||
54310121 | 7640 | =item DEBUGGING |
7641 | ||
d420ca49 | 7642 | =over 4 |
54310121 | 7643 | |
7644 | =item DUMPING OUT ALL THE NAME/VALUE PAIRS | |
7645 | ||
7646 | =back | |
7647 | ||
7648 | =item FETCHING ENVIRONMENT VARIABLES | |
7649 | ||
14218588 | 7650 | B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>, |
0e032a14 JH |
7651 | B<path_translated()>, B<remote_host()>, B<script_name()> Return the script |
7652 | name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type | |
37d4d706 JH |
7653 | ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>, |
7654 | B<server_software ()>, B<remote_user ()>, B<user_name ()>, | |
7655 | B<request_method()>, B<content_type()>, B<http()>, B<https()> | |
54310121 | 7656 | |
fb9cefb4 | 7657 | =item USING NPH SCRIPTS |
54310121 | 7658 | |
fb9cefb4 GS |
7659 | In the B<use> statement, By calling the B<nph()> method:, By using B<-nph> |
7660 | parameters in the B<header()> and B<redirect()> statements: | |
54310121 | 7661 | |
fb9cefb4 | 7662 | =item Server Push |
54310121 | 7663 | |
b38f6a39 | 7664 | multipart_init(), multipart_start(), multipart_end() |
54310121 | 7665 | |
fb9cefb4 | 7666 | =item Avoiding Denial of Service Attacks |
54310121 | 7667 | |
fb9cefb4 GS |
7668 | B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script |
7669 | basis>, B<2. Globally for all scripts> | |
54310121 | 7670 | |
fb9cefb4 | 7671 | =item COMPATIBILITY WITH CGI-LIB.PL |
54310121 | 7672 | |
7673 | =item AUTHOR INFORMATION | |
7674 | ||
7675 | =item CREDITS | |
7676 | ||
7677 | Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor | |
7678 | (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell | |
7679 | (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg | |
14218588 GS |
7680 | (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick |
7681 | (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis | |
7682 | (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen | |
7683 | (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim | |
7684 | MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks | |
7685 | (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed | |
7686 | Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug | |
7687 | MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org), | |
7688 | ...and many many more.. | |
54310121 | 7689 | |
7690 | =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT | |
7691 | ||
7692 | =item BUGS | |
7693 | ||
7694 | =item SEE ALSO | |
7695 | ||
a45bd81d GS |
7696 | =back |
7697 | ||
7698 | =head2 CGI::Apache - Backward compatibility module for CGI.pm | |
7699 | ||
d420ca49 | 7700 | =over 4 |
54310121 | 7701 | |
7702 | =item SYNOPSIS | |
7703 | ||
a45bd81d GS |
7704 | =item ABSTRACT |
7705 | ||
54310121 | 7706 | =item DESCRIPTION |
7707 | ||
a45bd81d | 7708 | =item AUTHOR INFORMATION |
137443ea | 7709 | |
a45bd81d | 7710 | =item BUGS |
54310121 | 7711 | |
7712 | =item SEE ALSO | |
7713 | ||
a45bd81d | 7714 | =back |
54310121 | 7715 | |
7716 | =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or | |
7717 | other) error log | |
7718 | ||
d420ca49 | 7719 | =over 4 |
a45bd81d | 7720 | |
54310121 | 7721 | =item SYNOPSIS |
7722 | ||
7723 | =item DESCRIPTION | |
7724 | ||
7725 | =item REDIRECTING ERROR MESSAGES | |
7726 | ||
7727 | =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW | |
7728 | ||
d420ca49 | 7729 | =over 4 |
fb9cefb4 GS |
7730 | |
7731 | =item Changing the default message | |
7732 | ||
7733 | =back | |
7734 | ||
10862624 RF |
7735 | =item MAKING WARNINGS APPEAR AS HTML COMMENTS |
7736 | ||
54310121 | 7737 | =item CHANGE LOG |
7738 | ||
7739 | =item AUTHORS | |
7740 | ||
7741 | =item SEE ALSO | |
7742 | ||
a45bd81d GS |
7743 | =back |
7744 | ||
fb9cefb4 GS |
7745 | =head2 CGI::Cookie - Interface to Netscape Cookies |
7746 | ||
d420ca49 | 7747 | =over 4 |
a45bd81d | 7748 | |
fb9cefb4 GS |
7749 | =item SYNOPSIS |
7750 | ||
7751 | =item DESCRIPTION | |
7752 | ||
7753 | =item USING CGI::Cookie | |
7754 | ||
7755 | B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag> | |
7756 | ||
d420ca49 | 7757 | =over 4 |
fb9cefb4 GS |
7758 | |
7759 | =item Creating New Cookies | |
7760 | ||
7761 | =item Sending the Cookie to the Browser | |
7762 | ||
7763 | =item Recovering Previous Cookies | |
7764 | ||
7765 | =item Manipulating Cookies | |
7766 | ||
7767 | B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()> | |
7768 | ||
7769 | =back | |
7770 | ||
7771 | =item AUTHOR INFORMATION | |
7772 | ||
7773 | =item BUGS | |
7774 | ||
7775 | =item SEE ALSO | |
7776 | ||
a45bd81d GS |
7777 | =back |
7778 | ||
54310121 | 7779 | =head2 CGI::Fast - CGI Interface for Fast CGI |
7780 | ||
d420ca49 | 7781 | =over 4 |
a45bd81d | 7782 | |
54310121 | 7783 | =item SYNOPSIS |
7784 | ||
7785 | =item DESCRIPTION | |
7786 | ||
7787 | =item OTHER PIECES OF THE PUZZLE | |
7788 | ||
7789 | =item WRITING FASTCGI PERL SCRIPTS | |
7790 | ||
7791 | =item INSTALLING FASTCGI SCRIPTS | |
7792 | ||
7793 | =item USING FASTCGI SCRIPTS AS CGI SCRIPTS | |
7794 | ||
7795 | =item CAVEATS | |
7796 | ||
7797 | =item AUTHOR INFORMATION | |
7798 | ||
7799 | =item BUGS | |
7800 | ||
7801 | =item SEE ALSO | |
7802 | ||
a45bd81d GS |
7803 | =back |
7804 | ||
c76ac1ee GS |
7805 | =head2 CGI::Pretty - module to produce nicely formatted HTML code |
7806 | ||
d420ca49 | 7807 | =over 4 |
a45bd81d | 7808 | |
c76ac1ee GS |
7809 | =item SYNOPSIS |
7810 | ||
7811 | =item DESCRIPTION | |
7812 | ||
d420ca49 | 7813 | =over 4 |
c76ac1ee GS |
7814 | |
7815 | =item Tags that won't be formatted | |
7816 | ||
a45bd81d GS |
7817 | =item Customizing the Indenting |
7818 | ||
c76ac1ee GS |
7819 | =back |
7820 | ||
7821 | =item BUGS | |
7822 | ||
7823 | =item AUTHOR | |
7824 | ||
7825 | =item SEE ALSO | |
7826 | ||
a45bd81d GS |
7827 | =back |
7828 | ||
54310121 | 7829 | =head2 CGI::Push - Simple Interface to Server Push |
7830 | ||
d420ca49 | 7831 | =over 4 |
a45bd81d | 7832 | |
54310121 | 7833 | =item SYNOPSIS |
7834 | ||
7835 | =item DESCRIPTION | |
7836 | ||
7837 | =item USING CGI::Push | |
7838 | ||
d516a115 | 7839 | -next_page, -last_page, -type, -delay, -cookie, -target, -expires |
54310121 | 7840 | |
d420ca49 | 7841 | =over 4 |
fb9cefb4 GS |
7842 | |
7843 | =item Heterogeneous Pages | |
7844 | ||
7845 | =item Changing the Page Delay on the Fly | |
7846 | ||
7847 | =back | |
7848 | ||
54310121 | 7849 | =item INSTALLING CGI::Push SCRIPTS |
7850 | ||
54310121 | 7851 | =item AUTHOR INFORMATION |
7852 | ||
7853 | =item BUGS | |
7854 | ||
7855 | =item SEE ALSO | |
7856 | ||
a45bd81d GS |
7857 | =back |
7858 | ||
7859 | =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch | |
7860 | ||
d420ca49 | 7861 | =over 4 |
54310121 | 7862 | |
7863 | =item SYNOPSIS | |
7864 | ||
a45bd81d GS |
7865 | =item ABSTRACT |
7866 | ||
54310121 | 7867 | =item DESCRIPTION |
7868 | ||
a45bd81d | 7869 | =item AUTHOR INFORMATION |
54310121 | 7870 | |
a45bd81d GS |
7871 | =item BUGS |
7872 | ||
7873 | =item SEE ALSO | |
7874 | ||
7875 | =back | |
54310121 | 7876 | |
8ebc5c01 | 7877 | =head2 CPAN - query, download and build perl modules from CPAN sites |
cb1a09d0 | 7878 | |
d420ca49 | 7879 | =over 4 |
a45bd81d | 7880 | |
8ebc5c01 | 7881 | =item SYNOPSIS |
cb1a09d0 | 7882 | |
8ebc5c01 | 7883 | =item DESCRIPTION |
cb1a09d0 | 7884 | |
d420ca49 | 7885 | =over 4 |
cb1a09d0 | 7886 | |
8ebc5c01 | 7887 | =item Interactive Mode |
cb1a09d0 | 7888 | |
8ebc5c01 | 7889 | Searching for authors, bundles, distribution files and modules, make, test, |
694468e3 | 7890 | install, clean modules or distributions, get, readme, look module or |
fb9cefb4 | 7891 | distribution, Signals |
cb1a09d0 | 7892 | |
8ebc5c01 | 7893 | =item CPAN::Shell |
cb1a09d0 | 7894 | |
774d564b | 7895 | =item autobundle |
7896 | ||
7897 | =item recompile | |
7898 | ||
d516a115 | 7899 | =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution |
dc848c6f | 7900 | |
10862624 | 7901 | =item Programmer's interface |
cb1a09d0 | 7902 | |
dc848c6f | 7903 | expand($type,@things), Programming Examples |
7904 | ||
14218588 | 7905 | =item Methods in the four Classes |
d516a115 | 7906 | |
8ebc5c01 | 7907 | =item Cache Manager |
cb1a09d0 | 7908 | |
8ebc5c01 | 7909 | =item Bundles |
cb1a09d0 | 7910 | |
774d564b | 7911 | =item Prerequisites |
cb1a09d0 | 7912 | |
fb9cefb4 GS |
7913 | =item Finding packages and VERSION |
7914 | ||
774d564b | 7915 | =item Debugging |
7916 | ||
14218588 | 7917 | =item Floppy, Zip, Offline Mode |
cb1a09d0 AD |
7918 | |
7919 | =back | |
7920 | ||
8ebc5c01 | 7921 | =item CONFIGURATION |
cb1a09d0 | 7922 | |
694468e3 GS |
7923 | C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt> |
7924 | E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list | |
7925 | optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt> | |
7926 | [unshift|push|splice] E<lt>listE<gt>> | |
cb1a09d0 | 7927 | |
d420ca49 | 7928 | =over 4 |
d516a115 | 7929 | |
14218588 GS |
7930 | =item Note on urllist parameter's format |
7931 | ||
7932 | =item urllist parameter has CD-ROM support | |
d516a115 JH |
7933 | |
7934 | =back | |
7935 | ||
8ebc5c01 | 7936 | =item SECURITY |
cb1a09d0 | 7937 | |
8ebc5c01 | 7938 | =item EXPORT |
cb1a09d0 | 7939 | |
14218588 GS |
7940 | =item POPULATE AN INSTALLATION WITH LOTS OF MODULES |
7941 | ||
7942 | =item WORKING WITH CPAN.pm BEHIND FIREWALLS | |
7943 | ||
d420ca49 | 7944 | =over 4 |
10862624 RF |
7945 | |
7946 | =item Three basic types of firewalls | |
7947 | ||
14218588 GS |
7948 | http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade |
7949 | ||
93d73c42 | 7950 | =item Configuring lynx or ncftp for going through a firewall |
10862624 RF |
7951 | |
7952 | =back | |
7953 | ||
7954 | =item FAQ | |
7955 | ||
37d4d706 JH |
7956 | 1) I installed a new version of module X but CPAN keeps saying, I |
7957 | have the old version installed, 2) So why is UNINST=1 not the default?, 3) | |
d420ca49 AD |
7958 | I want to clean up my mess, and install a new perl along with all |
7959 | modules I have. How do I go about it?, 4) When I install bundles or | |
7960 | multiple modules with one command there is too much output to keep | |
7961 | track of, 5) I am not root, how can I install a module in a personal | |
7962 | directory?, 6) How to get a package, unwrap it, and make a change before | |
7963 | building it?, 7) I installed a Bundle and had a couple of fails. When I | |
7964 | retried, everything resolved nicely. Can this be fixed to work | |
7965 | on first try?, 8) In our intranet we have many modules for internal use. | |
7966 | How can I integrate these modules with CPAN.pm but without uploading | |
7967 | the modules to CPAN?, 9) When I run CPAN's shell, I get error msg | |
7968 | about line 1 to 4, setting meta input/output via the /etc/inputrc | |
7969 | file | |
10862624 | 7970 | |
774d564b | 7971 | =item BUGS |
cb1a09d0 AD |
7972 | |
7973 | =item AUTHOR | |
7974 | ||
8ebc5c01 | 7975 | =item SEE ALSO |
cb1a09d0 | 7976 | |
a45bd81d GS |
7977 | =back |
7978 | ||
8ebc5c01 | 7979 | =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization |
cb1a09d0 | 7980 | |
d420ca49 | 7981 | =over 4 |
a45bd81d | 7982 | |
cb1a09d0 AD |
7983 | =item SYNOPSIS |
7984 | ||
cb1a09d0 AD |
7985 | =item DESCRIPTION |
7986 | ||
a45bd81d GS |
7987 | =back |
7988 | ||
8ebc5c01 | 7989 | =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS |
7990 | module | |
cb1a09d0 | 7991 | |
d420ca49 | 7992 | =over 4 |
a45bd81d | 7993 | |
cb1a09d0 AD |
7994 | =item SYNOPSIS |
7995 | ||
cb1a09d0 AD |
7996 | =item DESCRIPTION |
7997 | ||
8ebc5c01 | 7998 | =item SEE ALSO |
cb1a09d0 | 7999 | |
a45bd81d GS |
8000 | =back |
8001 | ||
d516a115 | 8002 | =head2 Carp, carp - warn of errors (from perspective of caller) |
cb1a09d0 | 8003 | |
d420ca49 | 8004 | =over 4 |
a45bd81d | 8005 | |
8ebc5c01 | 8006 | =item SYNOPSIS |
cb1a09d0 | 8007 | |
8ebc5c01 | 8008 | =item DESCRIPTION |
cb1a09d0 | 8009 | |
d420ca49 | 8010 | =over 4 |
d516a115 JH |
8011 | |
8012 | =item Forcing a Stack Trace | |
8013 | ||
8014 | =back | |
8015 | ||
14218588 GS |
8016 | =item BUGS |
8017 | ||
a45bd81d GS |
8018 | =back |
8019 | ||
c76ac1ee GS |
8020 | =head2 Carp::Heavy - Carp guts |
8021 | ||
d420ca49 | 8022 | =over 4 |
a45bd81d | 8023 | |
c76ac1ee GS |
8024 | =item SYNOPIS |
8025 | ||
8026 | =item DESCRIPTION | |
8027 | ||
a45bd81d GS |
8028 | =back |
8029 | ||
8cc95fdb | 8030 | =head2 Class::Struct - declare struct-like datatypes as Perl classes |
cb1a09d0 | 8031 | |
d420ca49 | 8032 | =over 4 |
a45bd81d | 8033 | |
cb1a09d0 AD |
8034 | =item SYNOPSIS |
8035 | ||
cb1a09d0 AD |
8036 | =item DESCRIPTION |
8037 | ||
d420ca49 | 8038 | =over 4 |
8cc95fdb | 8039 | |
8040 | =item The C<struct()> function | |
8041 | ||
d420ca49 AD |
8042 | =item Class Creation at Compile Time |
8043 | ||
8cc95fdb | 8044 | =item Element Types and Accessor Methods |
8045 | ||
8046 | Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or | |
8047 | C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) | |
8048 | ||
a10cf691 GS |
8049 | =item Initializing with C<new> |
8050 | ||
8cc95fdb | 8051 | =back |
8052 | ||
8ebc5c01 | 8053 | =item EXAMPLES |
cb1a09d0 | 8054 | |
a10cf691 | 8055 | Example 1, Example 2, Example 3 |
cb1a09d0 | 8056 | |
8cc95fdb | 8057 | =item Author and Modification History |
cb1a09d0 | 8058 | |
a45bd81d GS |
8059 | =back |
8060 | ||
14218588 GS |
8061 | =head2 Config - access Perl configuration information |
8062 | ||
d420ca49 | 8063 | =over 4 |
a45bd81d | 8064 | |
14218588 GS |
8065 | =item SYNOPSIS |
8066 | ||
8067 | =item DESCRIPTION | |
8068 | ||
8069 | myconfig(), config_sh(), config_vars(@names) | |
8070 | ||
8071 | =item EXAMPLE | |
8072 | ||
8073 | =item WARNING | |
8074 | ||
8075 | =item GLOSSARY | |
8076 | ||
d420ca49 | 8077 | =over 4 |
14218588 GS |
8078 | |
8079 | =item _ | |
8080 | ||
8081 | C<_a>, C<_exe>, C<_o> | |
8082 | ||
8083 | =item a | |
8084 | ||
a45bd81d GS |
8085 | C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>, |
8086 | C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>, | |
8087 | C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk> | |
14218588 GS |
8088 | |
8089 | =item b | |
8090 | ||
c76ac1ee GS |
8091 | C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>, |
8092 | C<byacc>, C<byteorder> | |
14218588 GS |
8093 | |
8094 | =item c | |
8095 | ||
8096 | C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, | |
93d73c42 JH |
8097 | C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, |
8098 | C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, | |
8099 | C<clocktype>, C<comm>, C<compress> | |
a45bd81d GS |
8100 | |
8101 | =item C | |
8102 | ||
8103 | C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>, | |
8104 | C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>, | |
8105 | C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh> | |
14218588 GS |
8106 | |
8107 | =item d | |
8108 | ||
c76ac1ee GS |
8109 | C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_atolf>, |
8110 | C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>, C<d_bincompat5005>, | |
8111 | C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, | |
8112 | C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, | |
a45bd81d GS |
8113 | C<d_closedir>, C<d_const>, C<d_crypt>, C<d_csh>, C<d_cuserid>, |
8114 | C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, | |
8115 | C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, | |
8116 | C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, | |
d722968f | 8117 | C<d_endsent>, C<d_eofnblk>, C<d_eunice>, C<d_fchmod>, C<d_fchown>, |
d420ca49 AD |
8118 | C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, |
8119 | C<d_fds_bits>, C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_fork>, | |
8120 | C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, | |
74cac757 JH |
8121 | C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, |
8122 | C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, | |
8123 | C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, | |
8124 | C<d_gethent>, C<d_gethname>, C<d_gethostprotos>, C<d_getlogin>, | |
8125 | C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, | |
8126 | C<d_getnent>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, | |
8127 | C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, | |
8128 | C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, | |
8129 | C<d_getpwent>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, | |
8130 | C<d_getservprotos>, C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, | |
8131 | C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>, C<d_iconv>, C<d_index>, | |
8132 | C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isnan>, C<d_isnanl>, | |
8133 | C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, | |
8134 | C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, | |
8135 | C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, | |
8136 | C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, | |
8137 | C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, | |
8138 | C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, | |
8139 | C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>, | |
8140 | C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, | |
8141 | C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>, | |
497711e7 GS |
8142 | C<d_nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>, |
8143 | C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, | |
8144 | C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>, | |
93d73c42 JH |
8145 | C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, |
8146 | C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, | |
8147 | C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>, | |
497711e7 GS |
8148 | C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, |
8149 | C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>, | |
8150 | C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, | |
8151 | C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>, C<d_scm_rights>, | |
93d73c42 JH |
8152 | C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, |
8153 | C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>, | |
8154 | C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, | |
8155 | C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>, | |
8156 | C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, | |
8157 | C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>, | |
8158 | C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>, | |
8159 | C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, | |
8160 | C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>, | |
8161 | C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, | |
8162 | C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, | |
9a997319 JH |
8163 | C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>, |
8164 | C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>, | |
8165 | C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, | |
8166 | C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, | |
8167 | C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, | |
8168 | C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, | |
8169 | C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>, | |
93d73c42 JH |
8170 | C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>, |
8171 | C<d_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, C<d_vendorarch>, | |
8172 | C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, | |
8173 | C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>, | |
8174 | C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_xenix>, C<date>, | |
8175 | C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>, | |
8176 | C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext> | |
14218588 GS |
8177 | |
8178 | =item e | |
8179 | ||
8180 | C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>, | |
8181 | C<exe_ext>, C<expr>, C<extensions> | |
8182 | ||
8183 | =item f | |
8184 | ||
8185 | C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>, | |
a45bd81d | 8186 | C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed> |
14218588 GS |
8187 | |
8188 | =item g | |
8189 | ||
d396a558 JH |
8190 | C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, |
8191 | C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip> | |
14218588 GS |
8192 | |
8193 | =item h | |
8194 | ||
91331b4f | 8195 | C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat> |
14218588 GS |
8196 | |
8197 | =item i | |
8198 | ||
a45bd81d GS |
8199 | C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>, |
8200 | C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>, | |
8201 | C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>, | |
d396a558 JH |
8202 | C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>, |
8203 | C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>, | |
8204 | C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>, | |
8205 | C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>, | |
8206 | C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>, | |
8207 | C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>, | |
8208 | C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>, | |
8209 | C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>, | |
8210 | C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>, | |
8211 | C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>, | |
8212 | C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>, | |
8213 | C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>, | |
8214 | C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>, | |
8215 | C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>, | |
8216 | C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>, | |
8217 | C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>, | |
8218 | C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>, | |
37d4d706 JH |
8219 | C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>, |
8220 | C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>, | |
8221 | C<installvendorlib>, C<intsize>, C<ivdformat>, C<ivsize>, C<ivtype> | |
14218588 GS |
8222 | |
8223 | =item k | |
8224 | ||
8225 | C<known_extensions>, C<ksh> | |
8226 | ||
8227 | =item l | |
8228 | ||
91331b4f JH |
8229 | C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>, |
8230 | C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>, | |
8231 | C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>, | |
8232 | C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, | |
8233 | C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>, | |
8234 | C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype> | |
14218588 GS |
8235 | |
8236 | =item m | |
8237 | ||
8238 | C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>, | |
8239 | C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>, | |
8240 | C<man3direxp>, C<man3ext> | |
8241 | ||
8242 | =item M | |
8243 | ||
91331b4f JH |
8244 | C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>, |
8245 | C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname> | |
14218588 GS |
8246 | |
8247 | =item n | |
8248 | ||
8249 | C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>, | |
a45bd81d | 8250 | C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff>, |
93d73c42 JH |
8251 | C<nveformat>, C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, |
8252 | C<nvGUformat>, C<nvsize>, C<nvtype> | |
14218588 GS |
8253 | |
8254 | =item o | |
8255 | ||
8256 | C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>, | |
d722968f | 8257 | C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs> |
14218588 GS |
8258 | |
8259 | =item p | |
8260 | ||
694468e3 GS |
8261 | C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>, |
8262 | C<perl> | |
a45bd81d GS |
8263 | |
8264 | =item P | |
8265 | ||
8266 | C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>, | |
91331b4f JH |
8267 | C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, |
8268 | C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, | |
8269 | C<privlibexp>, C<prototype>, C<ptrsize> | |
a45bd81d GS |
8270 | |
8271 | =item q | |
8272 | ||
8273 | C<quadkind>, C<quadtype> | |
14218588 GS |
8274 | |
8275 | =item r | |
8276 | ||
694468e3 GS |
8277 | C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, |
8278 | C<revision>, C<rm>, C<rmail>, C<runnm> | |
14218588 GS |
8279 | |
8280 | =item s | |
8281 | ||
8282 | C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, | |
8283 | C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>, | |
8284 | C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>, | |
8285 | C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>, | |
a45bd81d | 8286 | C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>, |
b38f6a39 | 8287 | C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>, |
91331b4f JH |
8288 | C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, |
8289 | C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, | |
8290 | C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, | |
8291 | C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, | |
8292 | C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>, | |
8293 | C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, | |
8294 | C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>, | |
8295 | C<strings>, C<submit>, C<subversion>, C<sysman> | |
14218588 GS |
8296 | |
8297 | =item t | |
8298 | ||
8299 | C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>, | |
8300 | C<touch>, C<tr>, C<trnl>, C<troff> | |
8301 | ||
8302 | =item u | |
8303 | ||
a45bd81d GS |
8304 | C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>, |
8305 | C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>, | |
694468e3 GS |
8306 | C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>, |
8307 | C<use64bitint>, C<usedl>, C<useithreads>, C<uselargefiles>, | |
8308 | C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, | |
8309 | C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>, | |
8310 | C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, | |
8311 | C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, | |
93d73c42 | 8312 | C<uvxformat>, C<uvXUformat> |
14218588 GS |
8313 | |
8314 | =item v | |
8315 | ||
b38f6a39 GS |
8316 | C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>, |
8317 | C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>, | |
37d4d706 | 8318 | C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags> |
14218588 GS |
8319 | |
8320 | =item x | |
8321 | ||
694468e3 | 8322 | C<xlibpth>, C<xs_apiversion> |
14218588 GS |
8323 | |
8324 | =item z | |
8325 | ||
8326 | C<zcat>, C<zip> | |
8327 | ||
8328 | =back | |
8329 | ||
8330 | =item NOTE | |
8331 | ||
a45bd81d GS |
8332 | =back |
8333 | ||
8ebc5c01 | 8334 | =head2 Cwd, getcwd - get pathname of current working directory |
cb1a09d0 | 8335 | |
d420ca49 | 8336 | =over 4 |
a45bd81d | 8337 | |
8ebc5c01 | 8338 | =item SYNOPSIS |
cb1a09d0 | 8339 | |
8ebc5c01 | 8340 | =item DESCRIPTION |
cb1a09d0 | 8341 | |
a45bd81d GS |
8342 | =back |
8343 | ||
14218588 GS |
8344 | =head2 DB - programmatic interface to the Perl debugging API (draft, |
8345 | subject to | |
8346 | change) | |
8347 | ||
d420ca49 | 8348 | =over 4 |
a45bd81d | 8349 | |
14218588 GS |
8350 | =item SYNOPSIS |
8351 | ||
8352 | =item DESCRIPTION | |
8353 | ||
d420ca49 | 8354 | =over 4 |
14218588 GS |
8355 | |
8356 | =item Global Variables | |
8357 | ||
8358 | $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args, | |
8359 | @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname, | |
8360 | $DB::lineno | |
8361 | ||
8362 | =item API Methods | |
8363 | ||
8364 | CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'), | |
8365 | CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done() | |
8366 | ||
8367 | =item Client Callback Methods | |
8368 | ||
8369 | CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(), | |
8370 | CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(), | |
8371 | CLIENT->output(LIST) | |
8372 | ||
8373 | =back | |
8374 | ||
8375 | =item BUGS | |
8376 | ||
8377 | =item AUTHOR | |
8378 | ||
a45bd81d GS |
8379 | =back |
8380 | ||
d516a115 | 8381 | =head2 DB_File - Perl5 access to Berkeley DB version 1.x |
cb1a09d0 | 8382 | |
d420ca49 | 8383 | =over 4 |
a45bd81d | 8384 | |
cb1a09d0 AD |
8385 | =item SYNOPSIS |
8386 | ||
cb1a09d0 AD |
8387 | =item DESCRIPTION |
8388 | ||
8ebc5c01 | 8389 | B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO> |
cb1a09d0 | 8390 | |
d420ca49 | 8391 | =over 4 |
cb1a09d0 | 8392 | |
c76ac1ee | 8393 | =item Using DB_File with Berkeley DB version 2 or 3 |
d516a115 | 8394 | |
68dc0745 | 8395 | =item Interface to Berkeley DB |
cb1a09d0 | 8396 | |
8ebc5c01 | 8397 | =item Opening a Berkeley DB Database File |
cb1a09d0 | 8398 | |
8ebc5c01 | 8399 | =item Default Parameters |
cb1a09d0 | 8400 | |
8ebc5c01 | 8401 | =item In Memory Databases |
cb1a09d0 AD |
8402 | |
8403 | =back | |
8404 | ||
8ebc5c01 | 8405 | =item DB_HASH |
cb1a09d0 | 8406 | |
d420ca49 | 8407 | =over 4 |
cb1a09d0 | 8408 | |
68dc0745 | 8409 | =item A Simple Example |
cb1a09d0 | 8410 | |
8ebc5c01 | 8411 | =back |
cb1a09d0 | 8412 | |
8ebc5c01 | 8413 | =item DB_BTREE |
cb1a09d0 | 8414 | |
d420ca49 | 8415 | =over 4 |
cb1a09d0 | 8416 | |
8ebc5c01 | 8417 | =item Changing the BTREE sort order |
cb1a09d0 | 8418 | |
68dc0745 | 8419 | =item Handling Duplicate Keys |
cb1a09d0 | 8420 | |
68dc0745 | 8421 | =item The get_dup() Method |
cb1a09d0 | 8422 | |
14218588 GS |
8423 | =item The find_dup() Method |
8424 | ||
8425 | =item The del_dup() Method | |
8426 | ||
8ebc5c01 | 8427 | =item Matching Partial Keys |
cb1a09d0 | 8428 | |
8ebc5c01 | 8429 | =back |
cb1a09d0 | 8430 | |
8ebc5c01 | 8431 | =item DB_RECNO |
cb1a09d0 | 8432 | |
d420ca49 | 8433 | =over 4 |
cb1a09d0 | 8434 | |
68dc0745 | 8435 | =item The 'bval' Option |
cb1a09d0 | 8436 | |
8ebc5c01 | 8437 | =item A Simple Example |
cb1a09d0 | 8438 | |
14218588 | 8439 | =item Extra RECNO Methods |
cb1a09d0 | 8440 | |
8ebc5c01 | 8441 | B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>, |
8442 | B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length> | |
cb1a09d0 | 8443 | |
8ebc5c01 | 8444 | =item Another Example |
cb1a09d0 | 8445 | |
8ebc5c01 | 8446 | =back |
cb1a09d0 | 8447 | |
8ebc5c01 | 8448 | =item THE API INTERFACE |
cb1a09d0 | 8449 | |
8ebc5c01 | 8450 | B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status = |
8451 | $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [, | |
8452 | $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key, | |
8453 | $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;> | |
cb1a09d0 | 8454 | |
c76ac1ee GS |
8455 | =item DBM FILTERS |
8456 | ||
8457 | B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>, | |
8458 | B<filter_fetch_value> | |
8459 | ||
d420ca49 | 8460 | =over 4 |
c76ac1ee GS |
8461 | |
8462 | =item The Filter | |
8463 | ||
8464 | =item An Example -- the NULL termination problem. | |
8465 | ||
8466 | =item Another Example -- Key is a C int. | |
8467 | ||
8468 | =back | |
8469 | ||
8ebc5c01 | 8470 | =item HINTS AND TIPS |
cb1a09d0 | 8471 | |
d420ca49 | 8472 | =over 4 |
8ebc5c01 | 8473 | |
a45bd81d GS |
8474 | =item Locking: The Trouble with fd |
8475 | ||
8476 | =item Safe ways to lock a database | |
8477 | ||
8478 | B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock> | |
cb1a09d0 | 8479 | |
68dc0745 | 8480 | =item Sharing Databases With C Applications |
cb1a09d0 | 8481 | |
68dc0745 | 8482 | =item The untie() Gotcha |
4fdae800 | 8483 | |
8ebc5c01 | 8484 | =back |
cb1a09d0 | 8485 | |
8ebc5c01 | 8486 | =item COMMON QUESTIONS |
cb1a09d0 | 8487 | |
d420ca49 | 8488 | =over 4 |
cb1a09d0 | 8489 | |
8ebc5c01 | 8490 | =item Why is there Perl source in my database? |
cb1a09d0 | 8491 | |
8ebc5c01 | 8492 | =item How do I store complex data structures with DB_File? |
cb1a09d0 | 8493 | |
8ebc5c01 | 8494 | =item What does "Invalid Argument" mean? |
cb1a09d0 | 8495 | |
8ebc5c01 | 8496 | =item What does "Bareword 'DB_File' not allowed" mean? |
cb1a09d0 | 8497 | |
8ebc5c01 | 8498 | =back |
cb1a09d0 | 8499 | |
c76ac1ee GS |
8500 | =item REFERENCES |
8501 | ||
8ebc5c01 | 8502 | =item HISTORY |
cb1a09d0 | 8503 | |
8ebc5c01 | 8504 | =item BUGS |
cb1a09d0 | 8505 | |
8ebc5c01 | 8506 | =item AVAILABILITY |
cb1a09d0 | 8507 | |
d516a115 JH |
8508 | =item COPYRIGHT |
8509 | ||
8ebc5c01 | 8510 | =item SEE ALSO |
cb1a09d0 | 8511 | |
8ebc5c01 | 8512 | =item AUTHOR |
cb1a09d0 | 8513 | |
a45bd81d GS |
8514 | =back |
8515 | ||
fb9cefb4 GS |
8516 | =head2 Data::Dumper - stringified perl data structures, suitable for both |
8517 | printing and C<eval> | |
8518 | ||
d420ca49 | 8519 | =over 4 |
a45bd81d | 8520 | |
fb9cefb4 GS |
8521 | =item SYNOPSIS |
8522 | ||
8523 | =item DESCRIPTION | |
8524 | ||
d420ca49 | 8525 | =over 4 |
fb9cefb4 GS |
8526 | |
8527 | =item Methods | |
8528 | ||
14218588 | 8529 | I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or> |
b38f6a39 GS |
8530 | I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>), |
8531 | I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>), | |
8532 | I<$OBJ>->Reset | |
fb9cefb4 GS |
8533 | |
8534 | =item Functions | |
8535 | ||
b38f6a39 | 8536 | Dumper(I<LIST>) |
fb9cefb4 GS |
8537 | |
8538 | =item Configuration Variables or Methods | |
8539 | ||
8540 | $Data::Dumper::Indent I<or> I<$OBJ>->Indent(I<[NEWVAL]>), | |
8541 | $Data::Dumper::Purity I<or> I<$OBJ>->Purity(I<[NEWVAL]>), | |
8542 | $Data::Dumper::Pad I<or> I<$OBJ>->Pad(I<[NEWVAL]>), | |
8543 | $Data::Dumper::Varname I<or> I<$OBJ>->Varname(I<[NEWVAL]>), | |
8544 | $Data::Dumper::Useqq I<or> I<$OBJ>->Useqq(I<[NEWVAL]>), | |
8545 | $Data::Dumper::Terse I<or> I<$OBJ>->Terse(I<[NEWVAL]>), | |
8546 | $Data::Dumper::Freezer I<or> $I<OBJ>->Freezer(I<[NEWVAL]>), | |
8547 | $Data::Dumper::Toaster I<or> $I<OBJ>->Toaster(I<[NEWVAL]>), | |
8548 | $Data::Dumper::Deepcopy I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>), | |
8549 | $Data::Dumper::Quotekeys I<or> $I<OBJ>->Quotekeys(I<[NEWVAL]>), | |
c76ac1ee GS |
8550 | $Data::Dumper::Bless I<or> $I<OBJ>->Bless(I<[NEWVAL]>), |
8551 | $Data::Dumper::Maxdepth I<or> $I<OBJ>->Maxdepth(I<[NEWVAL]>) | |
fb9cefb4 GS |
8552 | |
8553 | =item Exports | |
8554 | ||
8555 | Dumper | |
8556 | ||
8557 | =back | |
8558 | ||
8559 | =item EXAMPLES | |
8560 | ||
8561 | =item BUGS | |
8562 | ||
8563 | =item AUTHOR | |
8564 | ||
8565 | =item VERSION | |
8566 | ||
8567 | =item SEE ALSO | |
8568 | ||
a45bd81d GS |
8569 | =back |
8570 | ||
c76ac1ee GS |
8571 | =head2 Devel::DProf - a Perl code profiler |
8572 | ||
d420ca49 | 8573 | =over 4 |
a45bd81d | 8574 | |
c76ac1ee GS |
8575 | =item SYNOPSIS |
8576 | ||
8577 | =item DESCRIPTION | |
8578 | ||
8579 | =item PROFILE FORMAT | |
8580 | ||
8581 | =item AUTOLOAD | |
8582 | ||
8583 | =item ENVIRONMENT | |
8584 | ||
8585 | =item BUGS | |
8586 | ||
8587 | =item SEE ALSO | |
8588 | ||
a45bd81d GS |
8589 | =back |
8590 | ||
14218588 GS |
8591 | =head2 Devel::Peek - A data debugging tool for the XS programmer |
8592 | ||
d420ca49 | 8593 | =over 4 |
a45bd81d | 8594 | |
14218588 GS |
8595 | =item SYNOPSIS |
8596 | ||
8597 | =item DESCRIPTION | |
8598 | ||
d420ca49 | 8599 | =over 4 |
37d4d706 JH |
8600 | |
8601 | =item Memory footprint debugging | |
8602 | ||
8603 | =back | |
8604 | ||
14218588 GS |
8605 | =item EXAMPLES |
8606 | ||
d420ca49 | 8607 | =over 4 |
14218588 GS |
8608 | |
8609 | =item A simple scalar string | |
8610 | ||
8611 | =item A simple scalar number | |
8612 | ||
8613 | =item A simple scalar with an extra reference | |
8614 | ||
8615 | =item A reference to a simple scalar | |
8616 | ||
8617 | =item A reference to an array | |
8618 | ||
8619 | =item A reference to a hash | |
8620 | ||
8621 | =item Dumping a large array or hash | |
8622 | ||
8623 | =item A reference to an SV which holds a C pointer | |
8624 | ||
8625 | =item A reference to a subroutine | |
8626 | ||
8627 | =back | |
8628 | ||
8629 | =item EXPORTS | |
8630 | ||
8631 | =item BUGS | |
8632 | ||
8633 | =item AUTHOR | |
8634 | ||
8635 | =item SEE ALSO | |
8636 | ||
a45bd81d GS |
8637 | =back |
8638 | ||
8ebc5c01 | 8639 | =head2 Devel::SelfStubber - generate stubs for a SelfLoading module |
cb1a09d0 | 8640 | |
d420ca49 | 8641 | =over 4 |
a45bd81d | 8642 | |
8ebc5c01 | 8643 | =item SYNOPSIS |
cb1a09d0 | 8644 | |
8ebc5c01 | 8645 | =item DESCRIPTION |
cb1a09d0 | 8646 | |
a45bd81d GS |
8647 | =back |
8648 | ||
8ebc5c01 | 8649 | =head2 DirHandle - supply object methods for directory handles |
cb1a09d0 | 8650 | |
d420ca49 | 8651 | =over 4 |
a45bd81d | 8652 | |
8ebc5c01 | 8653 | =item SYNOPSIS |
cb1a09d0 | 8654 | |
8ebc5c01 | 8655 | =item DESCRIPTION |
cb1a09d0 | 8656 | |
a45bd81d GS |
8657 | =back |
8658 | ||
14218588 GS |
8659 | =head2 Dumpvalue - provides screen dump of Perl data. |
8660 | ||
d420ca49 | 8661 | =over 4 |
a45bd81d | 8662 | |
c76ac1ee | 8663 | =item SYNOPSIS |
14218588 GS |
8664 | |
8665 | =item DESCRIPTION | |
8666 | ||
d420ca49 | 8667 | =over 4 |
14218588 GS |
8668 | |
8669 | =item Creation | |
8670 | ||
8671 | C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, | |
8672 | C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>, | |
8673 | C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit, | |
8674 | stopDbSignal | |
8675 | ||
8676 | =item Methods | |
8677 | ||
8678 | dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump, | |
8679 | veryCompact, set, get | |
8680 | ||
8681 | =back | |
8682 | ||
a45bd81d GS |
8683 | =back |
8684 | ||
14218588 GS |
8685 | =head2 DynaLoader - Dynamically load C libraries into Perl code |
8686 | ||
d420ca49 | 8687 | =over 4 |
a45bd81d | 8688 | |
14218588 GS |
8689 | =item SYNOPSIS |
8690 | ||
8691 | =item DESCRIPTION | |
8692 | ||
8693 | @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, | |
8694 | @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), | |
b38f6a39 | 8695 | dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(), |
14218588 GS |
8696 | dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), |
8697 | bootstrap() | |
8698 | ||
8699 | =item AUTHOR | |
8700 | ||
a45bd81d GS |
8701 | =back |
8702 | ||
8703 | =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into | |
8704 | Perl code | |
8705 | ||
d420ca49 | 8706 | =over 4 |
a45bd81d GS |
8707 | |
8708 | =item SYNOPSIS | |
8709 | ||
8710 | =item DESCRIPTION | |
8711 | ||
8712 | =item AUTHOR | |
8713 | ||
8714 | =back | |
8715 | ||
91331b4f JH |
8716 | =head2 Encode - character encodings |
8717 | ||
d420ca49 | 8718 | =over 4 |
91331b4f JH |
8719 | |
8720 | =item TERMINOLOGY | |
8721 | ||
8722 | =item bytes | |
8723 | ||
8724 | =item chars | |
8725 | ||
8726 | =item chars With Encoding | |
8727 | ||
8728 | =item Testing For UTF-8 | |
8729 | ||
8730 | =item Toggling UTF-8-ness | |
8731 | ||
8732 | =item UTF-16 and UTF-32 Encodings | |
8733 | ||
8734 | =item Handling Malformed Data | |
8735 | ||
8736 | =back | |
8737 | ||
8ebc5c01 | 8738 | =head2 English - use nice English (or awk) names for ugly punctuation |
8739 | variables | |
cb1a09d0 | 8740 | |
d420ca49 | 8741 | =over 4 |
a45bd81d | 8742 | |
8ebc5c01 | 8743 | =item SYNOPSIS |
cb1a09d0 | 8744 | |
8ebc5c01 | 8745 | =item DESCRIPTION |
cb1a09d0 | 8746 | |
497711e7 | 8747 | =item PERFORMANCE |
694468e3 | 8748 | |
a45bd81d GS |
8749 | =back |
8750 | ||
b38f6a39 GS |
8751 | =head2 Env - perl module that imports environment variables as scalars or |
8752 | arrays | |
cb1a09d0 | 8753 | |
d420ca49 | 8754 | =over 4 |
a45bd81d | 8755 | |
cb1a09d0 AD |
8756 | =item SYNOPSIS |
8757 | ||
cb1a09d0 AD |
8758 | =item DESCRIPTION |
8759 | ||
b38f6a39 GS |
8760 | =item LIMITATIONS |
8761 | ||
8ebc5c01 | 8762 | =item AUTHOR |
cb1a09d0 | 8763 | |
a45bd81d GS |
8764 | =back |
8765 | ||
d46b76b3 JH |
8766 | =head2 Errno - System errno constants |
8767 | ||
d420ca49 | 8768 | =over 4 |
d46b76b3 JH |
8769 | |
8770 | =item SYNOPSIS | |
8771 | ||
8772 | =item DESCRIPTION | |
8773 | ||
8774 | =item CAVEATS | |
8775 | ||
8776 | =item AUTHOR | |
8777 | ||
8778 | =item COPYRIGHT | |
8779 | ||
8780 | =back | |
8781 | ||
8ebc5c01 | 8782 | =head2 Exporter - Implements default import method for modules |
cb1a09d0 | 8783 | |
d420ca49 | 8784 | =over 4 |
a45bd81d | 8785 | |
8ebc5c01 | 8786 | =item SYNOPSIS |
cb1a09d0 | 8787 | |
8ebc5c01 | 8788 | =item DESCRIPTION |
cb1a09d0 | 8789 | |
d420ca49 | 8790 | =over 4 |
cb1a09d0 | 8791 | |
c76ac1ee GS |
8792 | =item How to Export |
8793 | ||
8ebc5c01 | 8794 | =item Selecting What To Export |
cb1a09d0 | 8795 | |
8ebc5c01 | 8796 | =item Specialised Import Lists |
cb1a09d0 | 8797 | |
d516a115 JH |
8798 | =item Exporting without using Export's import method |
8799 | ||
8ebc5c01 | 8800 | =item Module Version Checking |
cb1a09d0 | 8801 | |
8ebc5c01 | 8802 | =item Managing Unknown Symbols |
cb1a09d0 | 8803 | |
8ebc5c01 | 8804 | =item Tag Handling Utility Functions |
cb1a09d0 | 8805 | |
8ebc5c01 | 8806 | =back |
cb1a09d0 | 8807 | |
a45bd81d GS |
8808 | =back |
8809 | ||
c76ac1ee GS |
8810 | =head2 Exporter::Heavy - Exporter guts |
8811 | ||
d420ca49 | 8812 | =over 4 |
a45bd81d | 8813 | |
c76ac1ee GS |
8814 | =item SYNOPIS |
8815 | ||
8816 | =item DESCRIPTION | |
8817 | ||
a45bd81d GS |
8818 | =back |
8819 | ||
68dc0745 | 8820 | =head2 ExtUtils::Command - utilities to replace common UNIX commands in |
8821 | Makefiles etc. | |
8822 | ||
d420ca49 | 8823 | =over 4 |
a45bd81d | 8824 | |
dc848c6f | 8825 | =item SYNOPSIS |
68dc0745 | 8826 | |
8827 | =item DESCRIPTION | |
8828 | ||
a45bd81d GS |
8829 | =back |
8830 | ||
8831 | cat | |
8832 | ||
8833 | eqtime src dst | |
8834 | ||
8835 | rm_f files... | |
8836 | ||
8837 | rm_f files... | |
8838 | ||
8839 | touch files .. | |
8840 | ||
8841 | mv source... destination | |
8842 | ||
8843 | cp source... destination | |
8844 | ||
8845 | chmod mode files.. | |
8846 | ||
8847 | mkpath directory.. | |
8848 | ||
8849 | test_f file | |
8850 | ||
d420ca49 | 8851 | =over 4 |
68dc0745 | 8852 | |
8853 | =item BUGS | |
8854 | ||
8855 | =item SEE ALSO | |
8856 | ||
8857 | =item AUTHOR | |
8858 | ||
a45bd81d GS |
8859 | =back |
8860 | ||
8ebc5c01 | 8861 | =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications |
cb1a09d0 | 8862 | |
d420ca49 | 8863 | =over 4 |
a45bd81d | 8864 | |
cb1a09d0 AD |
8865 | =item SYNOPSIS |
8866 | ||
cb1a09d0 AD |
8867 | =item DESCRIPTION |
8868 | ||
8ebc5c01 | 8869 | =item @EXPORT |
cb1a09d0 | 8870 | |
8ebc5c01 | 8871 | =item FUNCTIONS |
cb1a09d0 | 8872 | |
8ebc5c01 | 8873 | xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(), |
8874 | ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) | |
cb1a09d0 | 8875 | |
8ebc5c01 | 8876 | =item EXAMPLES |
cb1a09d0 | 8877 | |
8ebc5c01 | 8878 | =item SEE ALSO |
cb1a09d0 | 8879 | |
8ebc5c01 | 8880 | =item AUTHOR |
cb1a09d0 | 8881 | |
a45bd81d GS |
8882 | =back |
8883 | ||
8ebc5c01 | 8884 | =head2 ExtUtils::Install - install files from here to there |
cb1a09d0 | 8885 | |
d420ca49 | 8886 | =over 4 |
a45bd81d | 8887 | |
8ebc5c01 | 8888 | =item SYNOPSIS |
cb1a09d0 | 8889 | |
8ebc5c01 | 8890 | =item DESCRIPTION |
cb1a09d0 | 8891 | |
a45bd81d GS |
8892 | =back |
8893 | ||
193fb0af GS |
8894 | =head2 ExtUtils::Installed - Inventory management of installed modules |
8895 | ||
d420ca49 | 8896 | =over 4 |
a45bd81d | 8897 | |
193fb0af GS |
8898 | =item SYNOPSIS |
8899 | ||
8900 | =item DESCRIPTION | |
8901 | ||
8902 | =item USAGE | |
8903 | ||
8904 | =item FUNCTIONS | |
8905 | ||
8906 | new(), modules(), files(), directories(), directory_tree(), validate(), | |
8907 | packlist(), version() | |
8908 | ||
fb9cefb4 GS |
8909 | =item EXAMPLE |
8910 | ||
193fb0af GS |
8911 | =item AUTHOR |
8912 | ||
a45bd81d GS |
8913 | =back |
8914 | ||
8ebc5c01 | 8915 | =head2 ExtUtils::Liblist - determine libraries to use and how to use them |
cb1a09d0 | 8916 | |
d420ca49 | 8917 | =over 4 |
a45bd81d | 8918 | |
8ebc5c01 | 8919 | =item SYNOPSIS |
cb1a09d0 | 8920 | |
8ebc5c01 | 8921 | =item DESCRIPTION |
cb1a09d0 | 8922 | |
8ebc5c01 | 8923 | For static extensions, For dynamic extensions, For dynamic extensions |
cb1a09d0 | 8924 | |
d420ca49 | 8925 | =over 4 |
cb1a09d0 | 8926 | |
8ebc5c01 | 8927 | =item EXTRALIBS |
cb1a09d0 | 8928 | |
8ebc5c01 | 8929 | =item LDLOADLIBS and LD_RUN_PATH |
cb1a09d0 | 8930 | |
8ebc5c01 | 8931 | =item BSLOADLIBS |
cb1a09d0 | 8932 | |
8ebc5c01 | 8933 | =back |
cb1a09d0 | 8934 | |
8ebc5c01 | 8935 | =item PORTABILITY |
cb1a09d0 | 8936 | |
d420ca49 | 8937 | =over 4 |
cb1a09d0 | 8938 | |
8ebc5c01 | 8939 | =item VMS implementation |
cb1a09d0 | 8940 | |
3e3baf6d TB |
8941 | =item Win32 implementation |
8942 | ||
8ebc5c01 | 8943 | =back |
cb1a09d0 | 8944 | |
8ebc5c01 | 8945 | =item SEE ALSO |
cb1a09d0 | 8946 | |
a45bd81d GS |
8947 | =back |
8948 | ||
14218588 GS |
8949 | =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in |
8950 | ExtUtils::MakeMaker | |
8951 | ||
d420ca49 | 8952 | =over 4 |
a45bd81d | 8953 | |
14218588 GS |
8954 | =item SYNOPSIS |
8955 | ||
8956 | =item DESCRIPTION | |
8957 | ||
8958 | canonpath, cflags, manifypods, perl_archive | |
8959 | ||
a45bd81d GS |
8960 | =back |
8961 | ||
8ebc5c01 | 8962 | =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in |
8963 | ExtUtils::MakeMaker | |
cb1a09d0 | 8964 | |
d420ca49 | 8965 | =over 4 |
a45bd81d | 8966 | |
8ebc5c01 | 8967 | =item SYNOPSIS |
cb1a09d0 | 8968 | |
8ebc5c01 | 8969 | =item DESCRIPTION |
cb1a09d0 | 8970 | |
a45bd81d GS |
8971 | =back |
8972 | ||
8ebc5c01 | 8973 | =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker |
cb1a09d0 | 8974 | |
d420ca49 | 8975 | =over 4 |
a45bd81d | 8976 | |
8ebc5c01 | 8977 | =item SYNOPSIS |
cb1a09d0 | 8978 | |
8ebc5c01 | 8979 | =item DESCRIPTION |
cb1a09d0 | 8980 | |
8ebc5c01 | 8981 | =item METHODS |
cb1a09d0 | 8982 | |
d420ca49 | 8983 | =over 4 |
cb1a09d0 | 8984 | |
8ebc5c01 | 8985 | =item Preloaded methods |
cb1a09d0 | 8986 | |
a45bd81d | 8987 | canonpath |
cb1a09d0 | 8988 | |
8ebc5c01 | 8989 | =back |
cb1a09d0 | 8990 | |
a45bd81d | 8991 | =back |
cb1a09d0 | 8992 | |
a45bd81d | 8993 | catdir |
cb1a09d0 | 8994 | |
a45bd81d | 8995 | catfile |
cb1a09d0 | 8996 | |
a45bd81d | 8997 | curdir |
cb1a09d0 | 8998 | |
a45bd81d | 8999 | rootdir |
cb1a09d0 | 9000 | |
a45bd81d | 9001 | updir |
cb1a09d0 | 9002 | |
d420ca49 | 9003 | =over 4 |
cb1a09d0 | 9004 | |
8ebc5c01 | 9005 | =item SelfLoaded methods |
cb1a09d0 | 9006 | |
a45bd81d | 9007 | c_o (o) |
cb1a09d0 | 9008 | |
8ebc5c01 | 9009 | =back |
cb1a09d0 | 9010 | |
a45bd81d | 9011 | cflags (o) |
68dc0745 | 9012 | |
a45bd81d | 9013 | clean (o) |
68dc0745 | 9014 | |
a45bd81d | 9015 | const_cccmd (o) |
68dc0745 | 9016 | |
a45bd81d | 9017 | const_config (o) |
68dc0745 | 9018 | |
a45bd81d | 9019 | const_loadlibs (o) |
cb1a09d0 | 9020 | |
a45bd81d | 9021 | constants (o) |
cb1a09d0 | 9022 | |
a45bd81d | 9023 | depend (o) |
cb1a09d0 | 9024 | |
a45bd81d | 9025 | dir_target (o) |
cb1a09d0 | 9026 | |
a45bd81d | 9027 | dist (o) |
cb1a09d0 | 9028 | |
a45bd81d | 9029 | dist_basics (o) |
cb1a09d0 | 9030 | |
a45bd81d | 9031 | dist_ci (o) |
cb1a09d0 | 9032 | |
a45bd81d | 9033 | dist_core (o) |
7d2bfb28 | 9034 | |
a45bd81d | 9035 | dist_dir (o) |
7d2bfb28 | 9036 | |
a45bd81d | 9037 | dist_test (o) |
7d2bfb28 | 9038 | |
a45bd81d | 9039 | dlsyms (o) |
7d2bfb28 | 9040 | |
a45bd81d | 9041 | dynamic (o) |
7d2bfb28 | 9042 | |
a45bd81d | 9043 | dynamic_bs (o) |
7d2bfb28 | 9044 | |
a45bd81d | 9045 | dynamic_lib (o) |
7d2bfb28 | 9046 | |
a45bd81d | 9047 | exescan |
cb1a09d0 | 9048 | |
a45bd81d | 9049 | extliblist |
cb1a09d0 | 9050 | |
a45bd81d | 9051 | file_name_is_absolute |
cb1a09d0 | 9052 | |
a45bd81d | 9053 | find_perl |
cb1a09d0 | 9054 | |
d420ca49 | 9055 | =over 4 |
cb1a09d0 | 9056 | |
a45bd81d | 9057 | =item Methods to actually produce chunks of text for the Makefile |
cb1a09d0 | 9058 | |
a45bd81d | 9059 | fixin |
cb1a09d0 | 9060 | |
a45bd81d | 9061 | =back |
cb1a09d0 | 9062 | |
a45bd81d | 9063 | force (o) |
d516a115 | 9064 | |
a45bd81d | 9065 | guess_name |
cb1a09d0 | 9066 | |
a45bd81d | 9067 | has_link_code |
14218588 | 9068 | |
a45bd81d | 9069 | htmlifypods (o) |
14218588 | 9070 | |
a45bd81d | 9071 | init_dirscan |
cb1a09d0 | 9072 | |
a45bd81d | 9073 | init_main |
cb1a09d0 | 9074 | |
a45bd81d | 9075 | init_others |
cb1a09d0 | 9076 | |
a45bd81d | 9077 | install (o) |
cb1a09d0 | 9078 | |
a45bd81d | 9079 | installbin (o) |
cb1a09d0 | 9080 | |
a45bd81d | 9081 | libscan (o) |
cb1a09d0 | 9082 | |
a45bd81d | 9083 | linkext (o) |
cb1a09d0 | 9084 | |
a45bd81d | 9085 | lsdir |
cb1a09d0 | 9086 | |
a45bd81d | 9087 | macro (o) |
cb1a09d0 | 9088 | |
a45bd81d | 9089 | makeaperl (o) |
cb1a09d0 | 9090 | |
a45bd81d | 9091 | makefile (o) |
cb1a09d0 | 9092 | |
a45bd81d | 9093 | manifypods (o) |
cb1a09d0 | 9094 | |
a45bd81d | 9095 | maybe_command |
14218588 | 9096 | |
a45bd81d | 9097 | maybe_command_in_dirs |
14218588 | 9098 | |
a45bd81d | 9099 | needs_linking (o) |
14218588 | 9100 | |
a45bd81d | 9101 | nicetext |
14218588 | 9102 | |
a45bd81d | 9103 | parse_version |
cb1a09d0 | 9104 | |
a45bd81d | 9105 | parse_abstract |
cb1a09d0 | 9106 | |
a45bd81d | 9107 | pasthru (o) |
cb1a09d0 | 9108 | |
a45bd81d | 9109 | path |
cb1a09d0 | 9110 | |
a45bd81d | 9111 | perl_script |
cb1a09d0 | 9112 | |
a45bd81d | 9113 | perldepend (o) |
402d0d99 | 9114 | |
a45bd81d | 9115 | ppd |
402d0d99 | 9116 | |
a45bd81d | 9117 | perm_rw (o) |
402d0d99 | 9118 | |
a45bd81d | 9119 | perm_rwx (o) |
402d0d99 | 9120 | |
a45bd81d | 9121 | pm_to_blib |
193fb0af | 9122 | |
a45bd81d | 9123 | post_constants (o) |
193fb0af | 9124 | |
a45bd81d | 9125 | post_initialize (o) |
193fb0af | 9126 | |
a45bd81d | 9127 | postamble (o) |
193fb0af | 9128 | |
a45bd81d | 9129 | prefixify |
193fb0af | 9130 | |
a45bd81d | 9131 | processPL (o) |
193fb0af | 9132 | |
a45bd81d | 9133 | realclean (o) |
fb9cefb4 | 9134 | |
a45bd81d | 9135 | replace_manpage_separator |
193fb0af | 9136 | |
a45bd81d | 9137 | static (o) |
cb1a09d0 | 9138 | |
a45bd81d GS |
9139 | static_lib (o) |
9140 | ||
9141 | staticmake (o) | |
9142 | ||
9143 | subdir_x (o) | |
9144 | ||
9145 | subdirs (o) | |
9146 | ||
9147 | test (o) | |
9148 | ||
9149 | test_via_harness (o) | |
9150 | ||
9151 | test_via_script (o) | |
9152 | ||
9153 | tool_autosplit (o) | |
9154 | ||
9155 | tools_other (o) | |
9156 | ||
9157 | tool_xsubpp (o) | |
9158 | ||
9159 | top_targets (o) | |
9160 | ||
9161 | writedoc | |
9162 | ||
9163 | xs_c (o) | |
9164 | ||
9165 | xs_cpp (o) | |
9166 | ||
9167 | xs_o (o) | |
9168 | ||
9169 | perl_archive | |
9170 | ||
9171 | export_list | |
9172 | ||
d420ca49 | 9173 | =over 4 |
a45bd81d GS |
9174 | |
9175 | =item SEE ALSO | |
9176 | ||
9177 | =back | |
9178 | ||
9179 | =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in | |
9180 | ExtUtils::MakeMaker | |
9181 | ||
d420ca49 | 9182 | =over 4 |
a45bd81d GS |
9183 | |
9184 | =item SYNOPSIS | |
9185 | ||
9186 | =item DESCRIPTION | |
9187 | ||
d420ca49 | 9188 | =over 4 |
a45bd81d GS |
9189 | |
9190 | =item Methods always loaded | |
9191 | ||
9192 | wraplist | |
9193 | ||
9194 | =back | |
9195 | ||
9196 | =back | |
9197 | ||
9198 | rootdir (override) | |
9199 | ||
d420ca49 | 9200 | =over 4 |
a45bd81d GS |
9201 | |
9202 | =item SelfLoaded methods | |
9203 | ||
9204 | guess_name (override) | |
9205 | ||
9206 | =back | |
9207 | ||
9208 | find_perl (override) | |
9209 | ||
9210 | path (override) | |
9211 | ||
9212 | maybe_command (override) | |
9213 | ||
9214 | maybe_command_in_dirs (override) | |
9215 | ||
9216 | perl_script (override) | |
9217 | ||
9218 | file_name_is_absolute (override) | |
9219 | ||
9220 | replace_manpage_separator | |
9221 | ||
9222 | init_others (override) | |
9223 | ||
9224 | constants (override) | |
9225 | ||
9226 | cflags (override) | |
9227 | ||
9228 | const_cccmd (override) | |
9229 | ||
9230 | pm_to_blib (override) | |
9231 | ||
9232 | tool_autosplit (override) | |
9233 | ||
9234 | tool_sxubpp (override) | |
9235 | ||
9236 | xsubpp_version (override) | |
9237 | ||
9238 | tools_other (override) | |
9239 | ||
9240 | dist (override) | |
9241 | ||
9242 | c_o (override) | |
9243 | ||
9244 | xs_c (override) | |
9245 | ||
9246 | xs_o (override) | |
9247 | ||
9248 | top_targets (override) | |
9249 | ||
9250 | dlsyms (override) | |
9251 | ||
9252 | dynamic_lib (override) | |
9253 | ||
9254 | dynamic_bs (override) | |
9255 | ||
9256 | static_lib (override) | |
9257 | ||
9258 | manifypods (override) | |
9259 | ||
9260 | processPL (override) | |
9261 | ||
9262 | installbin (override) | |
9263 | ||
9264 | subdir_x (override) | |
9265 | ||
9266 | clean (override) | |
9267 | ||
9268 | realclean (override) | |
9269 | ||
9270 | dist_basics (override) | |
9271 | ||
9272 | dist_core (override) | |
9273 | ||
9274 | dist_dir (override) | |
9275 | ||
9276 | dist_test (override) | |
9277 | ||
9278 | install (override) | |
9279 | ||
9280 | perldepend (override) | |
9281 | ||
9282 | makefile (override) | |
9283 | ||
9284 | test (override) | |
9285 | ||
9286 | test_via_harness (override) | |
9287 | ||
9288 | test_via_script (override) | |
9289 | ||
9290 | makeaperl (override) | |
9291 | ||
9292 | nicetext (override) | |
9293 | ||
9294 | =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in | |
9295 | ExtUtils::MakeMaker | |
9296 | ||
d420ca49 | 9297 | =over 4 |
a45bd81d GS |
9298 | |
9299 | =item SYNOPSIS | |
9300 | ||
9301 | =item DESCRIPTION | |
9302 | ||
9303 | =back | |
9304 | ||
9305 | catfile | |
9306 | ||
9307 | constants (o) | |
9308 | ||
9309 | static_lib (o) | |
9310 | ||
9311 | dynamic_bs (o) | |
9312 | ||
9313 | dynamic_lib (o) | |
9314 | ||
9315 | canonpath | |
9316 | ||
9317 | perl_script | |
9318 | ||
9319 | pm_to_blib | |
9320 | ||
9321 | test_via_harness (o) | |
9322 | ||
9323 | tool_autosplit (override) | |
9324 | ||
9325 | tools_other (o) | |
9326 | ||
9327 | xs_o (o) | |
9328 | ||
9329 | top_targets (o) | |
9330 | ||
9331 | htmlifypods (o) | |
9332 | ||
9333 | manifypods (o) | |
9334 | ||
9335 | dist_ci (o) | |
9336 | ||
9337 | dist_core (o) | |
9338 | ||
9339 | pasthru (o) | |
9340 | ||
9341 | =head2 ExtUtils::MakeMaker - create an extension Makefile | |
9342 | ||
d420ca49 | 9343 | =over 4 |
a45bd81d GS |
9344 | |
9345 | =item SYNOPSIS | |
9346 | ||
9347 | =item DESCRIPTION | |
9348 | ||
d420ca49 | 9349 | =over 4 |
a45bd81d GS |
9350 | |
9351 | =item How To Write A Makefile.PL | |
9352 | ||
9353 | =item Default Makefile Behaviour | |
9354 | ||
9355 | =item make test | |
9356 | ||
9357 | =item make testdb | |
9358 | ||
9359 | =item make install | |
9360 | ||
9361 | =item PREFIX and LIB attribute | |
9362 | ||
9363 | =item AFS users | |
9364 | ||
9365 | =item Static Linking of a new Perl Binary | |
9366 | ||
9367 | =item Determination of Perl Library and Installation Locations | |
9368 | ||
9369 | =item Which architecture dependent directory? | |
9370 | ||
9371 | =item Using Attributes and Parameters | |
9372 | ||
a7ffa9b9 | 9373 | ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG, |
a45bd81d GS |
9374 | CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, |
9375 | EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS, | |
9376 | HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, | |
9377 | INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR, | |
9378 | INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, | |
9379 | INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, | |
a7ffa9b9 NC |
9380 | INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR, |
9381 | INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, | |
9382 | MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, | |
9383 | NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC, | |
9384 | PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX, | |
9385 | PL_FILES, PM, PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, | |
9386 | PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, | |
9387 | XSPROTOARG, XS_VERSION | |
a45bd81d GS |
9388 | |
9389 | =item Additional lowercase attributes | |
9390 | ||
9391 | clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, | |
9392 | tool_autosplit | |
9393 | ||
9394 | =item Overriding MakeMaker Methods | |
9395 | ||
9396 | =item Hintsfile support | |
9397 | ||
9398 | =item Distribution Support | |
9399 | ||
9400 | make distcheck, make skipcheck, make distclean, make manifest, | |
9401 | make distdir, make tardist, make dist, make uutardist, make | |
9402 | shdist, make zipdist, make ci | |
9403 | ||
9404 | =item Disabling an extension | |
9405 | ||
9406 | =back | |
9407 | ||
9408 | =item ENVIRONMENT | |
9409 | ||
9410 | PERL_MM_OPT | |
9411 | ||
9412 | =item SEE ALSO | |
9413 | ||
9414 | =item AUTHORS | |
9415 | ||
9416 | =back | |
9417 | ||
9418 | =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file | |
9419 | ||
d420ca49 | 9420 | =over 4 |
a45bd81d GS |
9421 | |
9422 | =item SYNOPSIS | |
9423 | ||
9424 | =item DESCRIPTION | |
9425 | ||
9426 | =item MANIFEST.SKIP | |
9427 | ||
9428 | =item EXPORT_OK | |
9429 | ||
9430 | =item GLOBAL VARIABLES | |
9431 | ||
9432 | =item DIAGNOSTICS | |
9433 | ||
9434 | C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>, | |
9435 | C<Added to MANIFEST:> I<file> | |
9436 | ||
9437 | =item SEE ALSO | |
9438 | ||
9439 | =item AUTHOR | |
9440 | ||
9441 | =back | |
9442 | ||
9443 | =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c | |
9444 | ||
d420ca49 | 9445 | =over 4 |
a45bd81d GS |
9446 | |
9447 | =item SYNOPSIS | |
9448 | ||
9449 | =item DESCRIPTION | |
9450 | ||
9451 | =item SEE ALSO | |
9452 | ||
9453 | =back | |
9454 | ||
9455 | =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader | |
9456 | ||
d420ca49 | 9457 | =over 4 |
a45bd81d GS |
9458 | |
9459 | =item SYNOPSIS | |
cb1a09d0 | 9460 | |
8ebc5c01 | 9461 | =item DESCRIPTION |
402d0d99 | 9462 | |
a45bd81d GS |
9463 | =back |
9464 | ||
9465 | =head2 ExtUtils::Mksymlists - write linker options files for dynamic | |
9466 | extension | |
9467 | ||
d420ca49 | 9468 | =over 4 |
a45bd81d GS |
9469 | |
9470 | =item SYNOPSIS | |
9471 | ||
9472 | =item DESCRIPTION | |
9473 | ||
9474 | DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME | |
9475 | ||
9476 | =item AUTHOR | |
9477 | ||
9478 | =item REVISION | |
9479 | ||
9480 | =back | |
9481 | ||
9482 | =head2 ExtUtils::Packlist - manage .packlist files | |
9483 | ||
d420ca49 | 9484 | =over 4 |
a45bd81d GS |
9485 | |
9486 | =item SYNOPSIS | |
9487 | ||
9488 | =item DESCRIPTION | |
9489 | ||
9490 | =item USAGE | |
9491 | ||
9492 | =item FUNCTIONS | |
9493 | ||
9494 | new(), read(), write(), validate(), packlist_file() | |
9495 | ||
9496 | =item EXAMPLE | |
9497 | ||
9498 | =item AUTHOR | |
9499 | ||
9500 | =back | |
9501 | ||
9502 | =head2 ExtUtils::testlib - add blib/* directories to @INC | |
9503 | ||
d420ca49 | 9504 | =over 4 |
a45bd81d GS |
9505 | |
9506 | =item SYNOPSIS | |
9507 | ||
9508 | =item DESCRIPTION | |
9509 | ||
9510 | =back | |
9511 | ||
d516a115 JH |
9512 | =head2 Fatal - replace functions with equivalents which succeed or die |
9513 | ||
d420ca49 | 9514 | =over 4 |
a45bd81d | 9515 | |
d516a115 JH |
9516 | =item SYNOPSIS |
9517 | ||
9518 | =item DESCRIPTION | |
9519 | ||
9520 | =item AUTHOR | |
9521 | ||
a45bd81d GS |
9522 | =back |
9523 | ||
8ebc5c01 | 9524 | =head2 Fcntl - load the C Fcntl.h defines |
cb1a09d0 | 9525 | |
d420ca49 | 9526 | =over 4 |
a45bd81d | 9527 | |
8ebc5c01 | 9528 | =item SYNOPSIS |
cb1a09d0 | 9529 | |
8ebc5c01 | 9530 | =item DESCRIPTION |
cb1a09d0 | 9531 | |
8ebc5c01 | 9532 | =item NOTE |
cb1a09d0 | 9533 | |
8ebc5c01 | 9534 | =item EXPORTED SYMBOLS |
cb1a09d0 | 9535 | |
a45bd81d GS |
9536 | =back |
9537 | ||
8ebc5c01 | 9538 | =head2 File::Basename, fileparse - split a pathname into pieces |
7d2bfb28 | 9539 | |
d420ca49 | 9540 | =over 4 |
a45bd81d | 9541 | |
7d2bfb28 | 9542 | =item SYNOPSIS |
9543 | ||
7d2bfb28 | 9544 | =item DESCRIPTION |
9545 | ||
8ebc5c01 | 9546 | fileparse_set_fstype, fileparse |
7d2bfb28 | 9547 | |
8ebc5c01 | 9548 | =item EXAMPLES |
7d2bfb28 | 9549 | |
8ebc5c01 | 9550 | C<basename>, C<dirname> |
7d2bfb28 | 9551 | |
a45bd81d GS |
9552 | =back |
9553 | ||
8ebc5c01 | 9554 | =head2 File::CheckTree, validate - run many filetest checks on a tree |
cb1a09d0 | 9555 | |
d420ca49 | 9556 | =over 4 |
a45bd81d | 9557 | |
cb1a09d0 AD |
9558 | =item SYNOPSIS |
9559 | ||
cb1a09d0 AD |
9560 | =item DESCRIPTION |
9561 | ||
a45bd81d GS |
9562 | =back |
9563 | ||
8ebc5c01 | 9564 | =head2 File::Compare - Compare files or filehandles |
cb1a09d0 | 9565 | |
d420ca49 | 9566 | =over 4 |
a45bd81d | 9567 | |
8ebc5c01 | 9568 | =item SYNOPSIS |
cb1a09d0 | 9569 | |
8ebc5c01 | 9570 | =item DESCRIPTION |
cb1a09d0 | 9571 | |
8ebc5c01 | 9572 | =item RETURN |
cb1a09d0 | 9573 | |
8ebc5c01 | 9574 | =item AUTHOR |
cb1a09d0 | 9575 | |
a45bd81d GS |
9576 | =back |
9577 | ||
8ebc5c01 | 9578 | =head2 File::Copy - Copy files or filehandles |
cb1a09d0 | 9579 | |
d420ca49 | 9580 | =over 4 |
a45bd81d | 9581 | |
8ebc5c01 | 9582 | =item SYNOPSIS |
cb1a09d0 | 9583 | |
8ebc5c01 | 9584 | =item DESCRIPTION |
cb1a09d0 | 9585 | |
d420ca49 | 9586 | =over 4 |
cb1a09d0 | 9587 | |
14218588 | 9588 | =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32) |
cb1a09d0 | 9589 | |
8ebc5c01 | 9590 | rmscopy($from,$to[,$date_flag]) |
cb1a09d0 AD |
9591 | |
9592 | =back | |
9593 | ||
8ebc5c01 | 9594 | =item RETURN |
cb1a09d0 | 9595 | |
8ebc5c01 | 9596 | =item AUTHOR |
cb1a09d0 | 9597 | |
a45bd81d GS |
9598 | =back |
9599 | ||
3e3baf6d TB |
9600 | =head2 File::DosGlob - DOS like globbing and then some |
9601 | ||
d420ca49 | 9602 | =over 4 |
a45bd81d | 9603 | |
3e3baf6d TB |
9604 | =item SYNOPSIS |
9605 | ||
9606 | =item DESCRIPTION | |
9607 | ||
9608 | =item EXPORTS (by request only) | |
9609 | ||
9610 | =item BUGS | |
9611 | ||
9612 | =item AUTHOR | |
9613 | ||
9614 | =item HISTORY | |
9615 | ||
9616 | =item SEE ALSO | |
9617 | ||
a45bd81d GS |
9618 | =back |
9619 | ||
8ebc5c01 | 9620 | =head2 File::Find, find - traverse a file tree |
cb1a09d0 | 9621 | |
d420ca49 | 9622 | =over 4 |
a45bd81d | 9623 | |
8ebc5c01 | 9624 | =item SYNOPSIS |
cb1a09d0 | 9625 | |
8ebc5c01 | 9626 | =item DESCRIPTION |
cb1a09d0 | 9627 | |
10862624 RF |
9628 | C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>, |
9629 | C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>, | |
9630 | C<untaint_pattern>, C<untaint_skip> | |
a45bd81d GS |
9631 | |
9632 | =item CAVEAT | |
9633 | ||
9634 | =back | |
9635 | ||
9636 | =head2 File::Glob - Perl extension for BSD glob routine | |
d516a115 | 9637 | |
d420ca49 | 9638 | =over 4 |
a45bd81d GS |
9639 | |
9640 | =item SYNOPSIS | |
9641 | ||
9642 | =item DESCRIPTION | |
9643 | ||
9644 | C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>, | |
9645 | C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH> | |
9646 | ||
9647 | =item DIAGNOSTICS | |
9648 | ||
9649 | C<GLOB_NOSPACE>, C<GLOB_ABEND> | |
9650 | ||
9651 | =item NOTES | |
9652 | ||
9653 | =item AUTHOR | |
9654 | ||
9655 | =back | |
9656 | ||
9657 | =head2 File::Path - create or remove directory trees | |
9658 | ||
d420ca49 | 9659 | =over 4 |
cb1a09d0 | 9660 | |
8ebc5c01 | 9661 | =item SYNOPSIS |
7d2bfb28 | 9662 | |
9663 | =item DESCRIPTION | |
9664 | ||
8ebc5c01 | 9665 | =item AUTHORS |
7d2bfb28 | 9666 | |
a45bd81d GS |
9667 | =back |
9668 | ||
fb9cefb4 GS |
9669 | =head2 File::Spec - portably perform operations on file names |
9670 | ||
d420ca49 | 9671 | =over 4 |
a45bd81d | 9672 | |
fb9cefb4 GS |
9673 | =item SYNOPSIS |
9674 | ||
9675 | =item DESCRIPTION | |
9676 | ||
9677 | =item SEE ALSO | |
9678 | ||
9679 | =item AUTHORS | |
9680 | ||
a45bd81d GS |
9681 | =back |
9682 | ||
14218588 GS |
9683 | =head2 File::Spec::Functions - portably perform operations on file names |
9684 | ||
d420ca49 | 9685 | =over 4 |
a45bd81d | 9686 | |
14218588 GS |
9687 | =item SYNOPSIS |
9688 | ||
9689 | =item DESCRIPTION | |
9690 | ||
d420ca49 | 9691 | =over 4 |
14218588 GS |
9692 | |
9693 | =item Exports | |
9694 | ||
9695 | =back | |
9696 | ||
9697 | =item SEE ALSO | |
9698 | ||
a45bd81d GS |
9699 | =back |
9700 | ||
fb9cefb4 GS |
9701 | =head2 File::Spec::Mac - File::Spec for MacOS |
9702 | ||
d420ca49 | 9703 | =over 4 |
a45bd81d | 9704 | |
fb9cefb4 GS |
9705 | =item SYNOPSIS |
9706 | ||
9707 | =item DESCRIPTION | |
9708 | ||
9709 | =item METHODS | |
9710 | ||
a45bd81d GS |
9711 | canonpath |
9712 | ||
9713 | =back | |
9714 | ||
9715 | catdir | |
9716 | ||
9717 | catfile | |
9718 | ||
9719 | curdir | |
9720 | ||
9721 | devnull | |
9722 | ||
9723 | rootdir | |
9724 | ||
9725 | tmpdir | |
9726 | ||
9727 | updir | |
9728 | ||
9729 | file_name_is_absolute | |
9730 | ||
9731 | path | |
9732 | ||
694468e3 GS |
9733 | splitpath |
9734 | ||
9735 | splitdir | |
9736 | ||
9737 | catpath | |
9738 | ||
9739 | abs2rel | |
9740 | ||
9741 | rel2abs | |
9742 | ||
d420ca49 | 9743 | =over 4 |
fb9cefb4 GS |
9744 | |
9745 | =item SEE ALSO | |
9746 | ||
a45bd81d GS |
9747 | =back |
9748 | ||
fb9cefb4 GS |
9749 | =head2 File::Spec::OS2 - methods for OS/2 file specs |
9750 | ||
d420ca49 | 9751 | =over 4 |
a45bd81d | 9752 | |
fb9cefb4 GS |
9753 | =item SYNOPSIS |
9754 | ||
9755 | =item DESCRIPTION | |
9756 | ||
a45bd81d GS |
9757 | =back |
9758 | ||
fb9cefb4 GS |
9759 | =head2 File::Spec::Unix - methods used by File::Spec |
9760 | ||
d420ca49 | 9761 | =over 4 |
a45bd81d | 9762 | |
fb9cefb4 GS |
9763 | =item SYNOPSIS |
9764 | ||
9765 | =item DESCRIPTION | |
9766 | ||
9767 | =item METHODS | |
9768 | ||
a45bd81d GS |
9769 | canonpath |
9770 | ||
9771 | =back | |
9772 | ||
9773 | catdir | |
9774 | ||
9775 | catfile | |
9776 | ||
9777 | curdir | |
9778 | ||
9779 | devnull | |
9780 | ||
9781 | rootdir | |
9782 | ||
9783 | tmpdir | |
9784 | ||
9785 | updir | |
9786 | ||
9787 | no_upwards | |
9788 | ||
694468e3 GS |
9789 | case_tolerant |
9790 | ||
a45bd81d GS |
9791 | file_name_is_absolute |
9792 | ||
9793 | path | |
9794 | ||
9795 | join | |
9796 | ||
9797 | splitpath | |
9798 | ||
9799 | splitdir | |
9800 | ||
9801 | catpath | |
9802 | ||
9803 | abs2rel | |
9804 | ||
9805 | rel2abs | |
9806 | ||
d420ca49 | 9807 | =over 4 |
fb9cefb4 GS |
9808 | |
9809 | =item SEE ALSO | |
9810 | ||
a45bd81d GS |
9811 | =back |
9812 | ||
fb9cefb4 GS |
9813 | =head2 File::Spec::VMS - methods for VMS file specs |
9814 | ||
d420ca49 | 9815 | =over 4 |
a45bd81d | 9816 | |
fb9cefb4 GS |
9817 | =item SYNOPSIS |
9818 | ||
9819 | =item DESCRIPTION | |
9820 | ||
a45bd81d GS |
9821 | eliminate_macros |
9822 | ||
9823 | =back | |
9824 | ||
9825 | fixpath | |
c76ac1ee | 9826 | |
d420ca49 | 9827 | =over 4 |
fb9cefb4 GS |
9828 | |
9829 | =item Methods always loaded | |
9830 | ||
694468e3 | 9831 | canonpath (override) |
fb9cefb4 GS |
9832 | |
9833 | =back | |
9834 | ||
694468e3 GS |
9835 | catdir |
9836 | ||
a45bd81d GS |
9837 | catfile |
9838 | ||
9839 | curdir (override) | |
9840 | ||
9841 | devnull (override) | |
9842 | ||
9843 | rootdir (override) | |
9844 | ||
9845 | tmpdir (override) | |
9846 | ||
9847 | updir (override) | |
9848 | ||
694468e3 GS |
9849 | case_tolerant (override) |
9850 | ||
a45bd81d GS |
9851 | path (override) |
9852 | ||
9853 | file_name_is_absolute (override) | |
9854 | ||
694468e3 GS |
9855 | splitpath (override) |
9856 | ||
9857 | splitdir (override) | |
9858 | ||
9859 | catpath (override) | |
9860 | ||
37590e52 GS |
9861 | abs2rel (override) |
9862 | ||
9863 | rel2abs (override) | |
9864 | ||
d420ca49 | 9865 | =over 4 |
a45bd81d | 9866 | |
14218588 GS |
9867 | =item SEE ALSO |
9868 | ||
a45bd81d GS |
9869 | =back |
9870 | ||
fb9cefb4 GS |
9871 | =head2 File::Spec::Win32 - methods for Win32 file specs |
9872 | ||
d420ca49 | 9873 | =over 4 |
a45bd81d | 9874 | |
fb9cefb4 GS |
9875 | =item SYNOPSIS |
9876 | ||
9877 | =item DESCRIPTION | |
9878 | ||
a45bd81d GS |
9879 | devnull |
9880 | ||
9881 | =back | |
9882 | ||
9883 | tmpdir | |
9884 | ||
9885 | catfile | |
9886 | ||
9887 | canonpath | |
9888 | ||
9889 | splitpath | |
9890 | ||
9891 | splitdir | |
9892 | ||
9893 | catpath | |
9894 | ||
d420ca49 | 9895 | =over 4 |
a45bd81d | 9896 | |
14218588 | 9897 | =item SEE ALSO |
fb9cefb4 | 9898 | |
a45bd81d GS |
9899 | =back |
9900 | ||
d722968f JH |
9901 | =head2 File::Temp - return name and handle of a temporary file safely |
9902 | ||
d420ca49 | 9903 | =over 4 |
d722968f | 9904 | |
a9ef4385 JH |
9905 | =item PORTABILITY |
9906 | ||
d722968f JH |
9907 | =item SYNOPSIS |
9908 | ||
9909 | =item DESCRIPTION | |
9910 | ||
9911 | =back | |
9912 | ||
d420ca49 | 9913 | =over 4 |
d722968f JH |
9914 | |
9915 | =item FUNCTIONS | |
9916 | ||
9917 | B<tempfile> | |
9918 | ||
9919 | =back | |
9920 | ||
9921 | B<tempdir> | |
9922 | ||
d420ca49 | 9923 | =over 4 |
d722968f JH |
9924 | |
9925 | =item MKTEMP FUNCTIONS | |
9926 | ||
9927 | B<mkstemp> | |
9928 | ||
9929 | =back | |
9930 | ||
9931 | B<mkstemps> | |
9932 | ||
9933 | B<mkdtemp> | |
9934 | ||
9935 | B<mktemp> | |
9936 | ||
d420ca49 | 9937 | =over 4 |
d722968f JH |
9938 | |
9939 | =item POSIX FUNCTIONS | |
9940 | ||
9941 | B<tmpnam> | |
9942 | ||
9943 | =back | |
9944 | ||
9945 | B<tmpfile> | |
9946 | ||
d420ca49 | 9947 | =over 4 |
d722968f JH |
9948 | |
9949 | =item ADDITIONAL FUNCTIONS | |
9950 | ||
9951 | B<tempnam> | |
9952 | ||
9953 | =back | |
9954 | ||
d420ca49 | 9955 | =over 4 |
d722968f JH |
9956 | |
9957 | =item UTILITY FUNCTIONS | |
9958 | ||
9959 | B<unlink0> | |
9960 | ||
9961 | =back | |
9962 | ||
d420ca49 | 9963 | =over 4 |
d722968f JH |
9964 | |
9965 | =item PACKAGE VARIABLES | |
9966 | ||
9967 | B<safe_level>, STANDARD, MEDIUM, HIGH | |
9968 | ||
9969 | =back | |
9970 | ||
9971 | TopSystemUID | |
9972 | ||
d420ca49 | 9973 | =over 4 |
d722968f JH |
9974 | |
9975 | =item WARNING | |
9976 | ||
4755096e GS |
9977 | =item HISTORY |
9978 | ||
9979 | =item SEE ALSO | |
9980 | ||
9981 | =item AUTHOR | |
9982 | ||
9983 | =back | |
9984 | ||
9985 | =head2 File::stat - by-name interface to Perl's built-in stat() functions | |
9986 | ||
d420ca49 | 9987 | =over 4 |
4755096e GS |
9988 | |
9989 | =item SYNOPSIS | |
9990 | ||
9991 | =item DESCRIPTION | |
9992 | ||
9993 | =item NOTE | |
9994 | ||
9995 | =item AUTHOR | |
9996 | ||
9997 | =back | |
9998 | ||
9999 | =head2 FileCache - keep more files open than the system permits | |
10000 | ||
d420ca49 | 10001 | =over 4 |
4755096e GS |
10002 | |
10003 | =item SYNOPSIS | |
10004 | ||
10005 | =item DESCRIPTION | |
10006 | ||
10007 | =item BUGS | |
10008 | ||
10009 | =back | |
10010 | ||
10011 | =head2 FileHandle - supply object methods for filehandles | |
10012 | ||
d420ca49 | 10013 | =over 4 |
4755096e GS |
10014 | |
10015 | =item SYNOPSIS | |
10016 | ||
10017 | =item DESCRIPTION | |
10018 | ||
10019 | $fh->print, $fh->printf, $fh->getline, $fh->getlines | |
10020 | ||
10021 | =item SEE ALSO | |
10022 | ||
10023 | =back | |
10024 | ||
10025 | =head2 FindBin - Locate directory of original perl script | |
10026 | ||
d420ca49 | 10027 | =over 4 |
4755096e GS |
10028 | |
10029 | =item SYNOPSIS | |
10030 | ||
10031 | =item DESCRIPTION | |
10032 | ||
10033 | =item EXPORTABLE VARIABLES | |
10034 | ||
10035 | =item KNOWN BUGS | |
10036 | ||
10037 | =item AUTHORS | |
10038 | ||
10039 | =item COPYRIGHT | |
10040 | ||
10041 | =back | |
10042 | ||
10043 | =head2 GDBM_File - Perl5 access to the gdbm library. | |
10044 | ||
d420ca49 | 10045 | =over 4 |
4755096e GS |
10046 | |
10047 | =item SYNOPSIS | |
10048 | ||
10049 | =item DESCRIPTION | |
10050 | ||
10051 | =item AVAILABILITY | |
10052 | ||
10053 | =item BUGS | |
10054 | ||
10055 | =item SEE ALSO | |
10056 | ||
10057 | =back | |
10058 | ||
10059 | =head2 Getopt::Long - Extended processing of command line options | |
10060 | ||
d420ca49 | 10061 | =over 4 |
4755096e GS |
10062 | |
10063 | =item SYNOPSIS | |
10064 | ||
10065 | =item DESCRIPTION | |
10066 | ||
10067 | =item Command Line Options, an Introduction | |
10068 | ||
10069 | =item Getting Started with Getopt::Long | |
10070 | ||
d420ca49 | 10071 | =over 4 |
4755096e GS |
10072 | |
10073 | =item Simple options | |
10074 | ||
10075 | =item A little bit less simple options | |
10076 | ||
10077 | =item Mixing command line option with other arguments | |
10078 | ||
10079 | =item Options with values | |
10080 | ||
10081 | =item Options with multiple values | |
10082 | ||
10083 | =item Options with hash values | |
10084 | ||
10085 | =item User-defined subroutines to handle options | |
10086 | ||
10087 | =item Options with multiple names | |
10088 | ||
10089 | =item Case and abbreviations | |
10090 | ||
10091 | =item Summary of Option Specifications | |
10092 | ||
10093 | !, +, s, i, f, : I<type> [ I<desttype> ] | |
10094 | ||
10095 | =back | |
10096 | ||
10097 | =item Advanced Possibilities | |
10098 | ||
d420ca49 | 10099 | =over 4 |
4755096e | 10100 | |
10862624 RF |
10101 | =item Object oriented interface |
10102 | ||
4755096e GS |
10103 | =item Documentation and help texts |
10104 | ||
10105 | =item Storing options in a hash | |
10106 | ||
10107 | =item Bundling | |
10108 | ||
10109 | =item The lonesome dash | |
10110 | ||
10111 | =item Argument call-back | |
10112 | ||
10113 | =back | |
10114 | ||
10115 | =item Configuring Getopt::Long | |
10116 | ||
9fa7f388 JH |
10117 | default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, |
10118 | require_order, permute, bundling (default: disabled), bundling_override | |
10119 | (default: disabled), ignore_case (default: enabled), ignore_case_always | |
10120 | (default: disabled), pass_through (default: disabled), prefix, | |
10121 | prefix_pattern, debug (default: disabled) | |
4755096e GS |
10122 | |
10123 | =item Return values and Errors | |
10124 | ||
10125 | =item Legacy | |
10126 | ||
d420ca49 | 10127 | =over 4 |
4755096e GS |
10128 | |
10129 | =item Default destinations | |
10130 | ||
10131 | =item Alternative option starters | |
10132 | ||
10133 | =item Configuration variables | |
10134 | ||
10135 | =back | |
10136 | ||
10862624 RF |
10137 | =item Trouble Shooting |
10138 | ||
d420ca49 | 10139 | =over 4 |
10862624 RF |
10140 | |
10141 | =item Warning: Ignoring '!' modifier for short option | |
10142 | ||
10143 | =item GetOptions does not return a false result when an option is not | |
10144 | supplied | |
10145 | ||
10146 | =back | |
10147 | ||
4755096e GS |
10148 | =item AUTHOR |
10149 | ||
10150 | =item COPYRIGHT AND DISCLAIMER | |
10151 | ||
10152 | =back | |
10153 | ||
10154 | =head2 Getopt::Std, getopt - Process single-character switches with switch | |
10155 | clustering | |
10156 | ||
d420ca49 | 10157 | =over 4 |
4755096e GS |
10158 | |
10159 | =item SYNOPSIS | |
10160 | ||
10161 | =item DESCRIPTION | |
10162 | ||
10163 | =back | |
10164 | ||
10165 | =head2 I18N::Collate - compare 8-bit scalar data according to the current | |
10166 | locale | |
10167 | ||
d420ca49 | 10168 | =over 4 |
4755096e GS |
10169 | |
10170 | =item SYNOPSIS | |
10171 | ||
10172 | =item DESCRIPTION | |
10173 | ||
10174 | =back | |
10175 | ||
10176 | =head2 IO - load various IO modules | |
10177 | ||
d420ca49 | 10178 | =over 4 |
4755096e GS |
10179 | |
10180 | =item SYNOPSIS | |
10181 | ||
10182 | =item DESCRIPTION | |
10183 | ||
10184 | =back | |
10185 | ||
10186 | =head2 IO::Dir - supply object methods for directory handles | |
10187 | ||
d420ca49 | 10188 | =over 4 |
4755096e GS |
10189 | |
10190 | =item SYNOPSIS | |
10191 | ||
10192 | =item DESCRIPTION | |
10193 | ||
10194 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), | |
10195 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
10196 | ||
10197 | =item SEE ALSO | |
10198 | ||
10199 | =item AUTHOR | |
10200 | ||
10201 | =item COPYRIGHT | |
10202 | ||
10203 | =back | |
10204 | ||
10205 | =head2 IO::File - supply object methods for filehandles | |
10206 | ||
d420ca49 | 10207 | =over 4 |
4755096e GS |
10208 | |
10209 | =item SYNOPSIS | |
10210 | ||
10211 | =item DESCRIPTION | |
10212 | ||
10213 | =item CONSTRUCTOR | |
10214 | ||
10215 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
10216 | ||
10217 | =item METHODS | |
10218 | ||
10219 | open( FILENAME [,MODE [,PERMS]] ) | |
d722968f JH |
10220 | |
10221 | =item SEE ALSO | |
10222 | ||
4755096e | 10223 | =item HISTORY |
d722968f JH |
10224 | |
10225 | =back | |
10226 | ||
4755096e | 10227 | =head2 IO::Handle - supply object methods for I/O handles |
7d2bfb28 | 10228 | |
d420ca49 | 10229 | =over 4 |
a45bd81d | 10230 | |
7d2bfb28 | 10231 | =item SYNOPSIS |
10232 | ||
7d2bfb28 | 10233 | =item DESCRIPTION |
10234 | ||
4755096e | 10235 | =item CONSTRUCTOR |
7d2bfb28 | 10236 | |
4755096e | 10237 | new (), new_from_fd ( FD, MODE ) |
a45bd81d | 10238 | |
4755096e | 10239 | =item METHODS |
7d2bfb28 | 10240 | |
4755096e GS |
10241 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, |
10242 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
10243 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
10244 | $io->blocking ( [ BOOL ] ), $io->untaint | |
a45bd81d | 10245 | |
4755096e | 10246 | =item NOTE |
7d2bfb28 | 10247 | |
4755096e | 10248 | =item SEE ALSO |
7d2bfb28 | 10249 | |
8ebc5c01 | 10250 | =item BUGS |
7d2bfb28 | 10251 | |
4755096e GS |
10252 | =item HISTORY |
10253 | ||
a45bd81d GS |
10254 | =back |
10255 | ||
4755096e | 10256 | =head2 IO::Pipe - supply object methods for pipes |
7d2bfb28 | 10257 | |
d420ca49 | 10258 | =over 4 |
a45bd81d | 10259 | |
8ebc5c01 | 10260 | =item SYNOPSIS |
7d2bfb28 | 10261 | |
8ebc5c01 | 10262 | =item DESCRIPTION |
7d2bfb28 | 10263 | |
4755096e GS |
10264 | =item CONSTRUCTOR |
10265 | ||
10266 | new ( [READER, WRITER] ) | |
10267 | ||
10268 | =item METHODS | |
10269 | ||
10270 | reader ([ARGS]), writer ([ARGS]), handles () | |
7d2bfb28 | 10271 | |
8ebc5c01 | 10272 | =item SEE ALSO |
7d2bfb28 | 10273 | |
4755096e GS |
10274 | =item AUTHOR |
10275 | ||
10276 | =item COPYRIGHT | |
10277 | ||
a45bd81d GS |
10278 | =back |
10279 | ||
4755096e | 10280 | =head2 IO::Poll - Object interface to system poll call |
7d2bfb28 | 10281 | |
d420ca49 | 10282 | =over 4 |
a45bd81d | 10283 | |
8ebc5c01 | 10284 | =item SYNOPSIS |
7d2bfb28 | 10285 | |
8ebc5c01 | 10286 | =item DESCRIPTION |
7d2bfb28 | 10287 | |
4755096e | 10288 | =item METHODS |
7d2bfb28 | 10289 | |
4755096e GS |
10290 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( |
10291 | IO ), handles( [ EVENT_MASK ] ) | |
7d2bfb28 | 10292 | |
4755096e GS |
10293 | =item SEE ALSO |
10294 | ||
10295 | =item AUTHOR | |
7d2bfb28 | 10296 | |
8ebc5c01 | 10297 | =item COPYRIGHT |
7d2bfb28 | 10298 | |
a45bd81d GS |
10299 | =back |
10300 | ||
4755096e | 10301 | =head2 IO::Seekable - supply seek based methods for I/O objects |
7d2bfb28 | 10302 | |
d420ca49 | 10303 | =over 4 |
a45bd81d | 10304 | |
8ebc5c01 | 10305 | =item SYNOPSIS |
7d2bfb28 | 10306 | |
10307 | =item DESCRIPTION | |
10308 | ||
74cac757 JH |
10309 | $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
10310 | WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
10311 | $io->tell | |
7d2bfb28 | 10312 | |
4755096e GS |
10313 | =item HISTORY |
10314 | ||
a45bd81d GS |
10315 | =back |
10316 | ||
4755096e | 10317 | =head2 IO::Select - OO interface to the select system call |
cb1a09d0 | 10318 | |
d420ca49 | 10319 | =over 4 |
a45bd81d | 10320 | |
cb1a09d0 AD |
10321 | =item SYNOPSIS |
10322 | ||
cb1a09d0 AD |
10323 | =item DESCRIPTION |
10324 | ||
4755096e | 10325 | =item CONSTRUCTOR |
cb1a09d0 | 10326 | |
4755096e | 10327 | new ( [ HANDLES ] ) |
cb1a09d0 | 10328 | |
4755096e | 10329 | =item METHODS |
cb1a09d0 | 10330 | |
4755096e GS |
10331 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( |
10332 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
10333 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
cb1a09d0 | 10334 | |
4755096e | 10335 | =item EXAMPLE |
cb1a09d0 | 10336 | |
4755096e | 10337 | =item AUTHOR |
cb1a09d0 | 10338 | |
4755096e | 10339 | =item COPYRIGHT |
b38f6a39 | 10340 | |
4755096e | 10341 | =back |
b38f6a39 | 10342 | |
4755096e | 10343 | =head2 IO::Socket - Object interface to socket communications |
b38f6a39 | 10344 | |
d420ca49 | 10345 | =over 4 |
b38f6a39 | 10346 | |
4755096e | 10347 | =item SYNOPSIS |
b38f6a39 | 10348 | |
4755096e | 10349 | =item DESCRIPTION |
b38f6a39 | 10350 | |
4755096e | 10351 | =item CONSTRUCTOR |
cb1a09d0 | 10352 | |
4755096e | 10353 | new ( [ARGS] ) |
cb1a09d0 | 10354 | |
4755096e | 10355 | =item METHODS |
7d2bfb28 | 10356 | |
4755096e GS |
10357 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), |
10358 | sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected | |
b38f6a39 | 10359 | |
4755096e | 10360 | =item SEE ALSO |
b38f6a39 | 10361 | |
4755096e | 10362 | =item AUTHOR |
b38f6a39 | 10363 | |
4755096e | 10364 | =item COPYRIGHT |
b38f6a39 | 10365 | |
4755096e | 10366 | =back |
b38f6a39 | 10367 | |
4755096e | 10368 | =head2 IO::Socket::INET - Object interface for AF_INET domain sockets |
b38f6a39 | 10369 | |
d420ca49 | 10370 | =over 4 |
7d2bfb28 | 10371 | |
4755096e | 10372 | =item SYNOPSIS |
9607fc9c | 10373 | |
4755096e | 10374 | =item DESCRIPTION |
9607fc9c | 10375 | |
4755096e | 10376 | =item CONSTRUCTOR |
b38f6a39 | 10377 | |
4755096e | 10378 | new ( [ARGS] ) |
b38f6a39 | 10379 | |
d420ca49 | 10380 | =over 4 |
cb1a09d0 | 10381 | |
4755096e | 10382 | =item METHODS |
b38f6a39 | 10383 | |
4755096e GS |
10384 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost |
10385 | () | |
b38f6a39 GS |
10386 | |
10387 | =back | |
cb1a09d0 | 10388 | |
4755096e GS |
10389 | =item SEE ALSO |
10390 | ||
d516a115 JH |
10391 | =item AUTHOR |
10392 | ||
4755096e | 10393 | =item COPYRIGHT |
d516a115 | 10394 | |
a45bd81d GS |
10395 | =back |
10396 | ||
4755096e | 10397 | =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets |
cb1a09d0 | 10398 | |
d420ca49 | 10399 | =over 4 |
a45bd81d | 10400 | |
8ebc5c01 | 10401 | =item SYNOPSIS |
cb1a09d0 | 10402 | |
8ebc5c01 | 10403 | =item DESCRIPTION |
cb1a09d0 | 10404 | |
4755096e | 10405 | =item CONSTRUCTOR |
cb1a09d0 | 10406 | |
4755096e | 10407 | new ( [ARGS] ) |
cb1a09d0 | 10408 | |
4755096e | 10409 | =item METHODS |
a45bd81d | 10410 | |
4755096e | 10411 | hostpath(), peerpath() |
cb1a09d0 | 10412 | |
4755096e | 10413 | =item SEE ALSO |
a45bd81d | 10414 | |
4755096e | 10415 | =item AUTHOR |
cb1a09d0 | 10416 | |
4755096e | 10417 | =item COPYRIGHT |
cb1a09d0 | 10418 | |
a45bd81d GS |
10419 | =back |
10420 | ||
14218588 GS |
10421 | =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory |
10422 | handles | |
fb9cefb4 | 10423 | |
d420ca49 | 10424 | =over 4 |
a45bd81d | 10425 | |
fb9cefb4 GS |
10426 | =item SYNOPSIS |
10427 | ||
10428 | =item DESCRIPTION | |
10429 | ||
14218588 GS |
10430 | new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), |
10431 | rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ] | |
fb9cefb4 GS |
10432 | |
10433 | =item SEE ALSO | |
10434 | ||
14218588 | 10435 | =item AUTHOR |
fb9cefb4 GS |
10436 | |
10437 | =item COPYRIGHT | |
10438 | ||
a45bd81d GS |
10439 | =back |
10440 | ||
14218588 | 10441 | =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles |
fb9cefb4 | 10442 | |
d420ca49 | 10443 | =over 4 |
a45bd81d | 10444 | |
fb9cefb4 GS |
10445 | =item SYNOPSIS |
10446 | ||
10447 | =item DESCRIPTION | |
10448 | ||
14218588 GS |
10449 | =item CONSTRUCTOR |
10450 | ||
10451 | new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile | |
10452 | ||
fb9cefb4 GS |
10453 | =item METHODS |
10454 | ||
14218588 | 10455 | open( FILENAME [,MODE [,PERMS]] ) |
fb9cefb4 GS |
10456 | |
10457 | =item SEE ALSO | |
10458 | ||
14218588 | 10459 | =item HISTORY |
fb9cefb4 | 10460 | |
a45bd81d GS |
10461 | =back |
10462 | ||
14218588 GS |
10463 | =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O |
10464 | handles | |
10465 | ||
d420ca49 | 10466 | =over 4 |
a45bd81d | 10467 | |
14218588 GS |
10468 | =item SYNOPSIS |
10469 | ||
10470 | =item DESCRIPTION | |
10471 | ||
10472 | =item CONSTRUCTOR | |
10473 | ||
10474 | new (), new_from_fd ( FD, MODE ) | |
10475 | ||
10476 | =item METHODS | |
10477 | ||
10478 | $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, | |
10479 | $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, | |
10480 | $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), | |
10481 | $io->blocking ( [ BOOL ] ), $io->untaint | |
10482 | ||
10483 | =item NOTE | |
10484 | ||
10485 | =item SEE ALSO | |
10486 | ||
10487 | =item BUGS | |
10488 | ||
10489 | =item HISTORY | |
10490 | ||
a45bd81d GS |
10491 | =back |
10492 | ||
14218588 GS |
10493 | =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes |
10494 | ||
d420ca49 | 10495 | =over 4 |
a45bd81d | 10496 | |
14218588 GS |
10497 | =item SYNOPSIS |
10498 | ||
10499 | =item DESCRIPTION | |
10500 | ||
10501 | =item CONSTRUCTOR | |
10502 | ||
10503 | new ( [READER, WRITER] ) | |
10504 | ||
10505 | =item METHODS | |
10506 | ||
10507 | reader ([ARGS]), writer ([ARGS]), handles () | |
10508 | ||
10509 | =item SEE ALSO | |
10510 | ||
10511 | =item AUTHOR | |
10512 | ||
10513 | =item COPYRIGHT | |
10514 | ||
a45bd81d GS |
10515 | =back |
10516 | ||
14218588 GS |
10517 | =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call |
10518 | ||
d420ca49 | 10519 | =over 4 |
a45bd81d | 10520 | |
14218588 GS |
10521 | =item SYNOPSIS |
10522 | ||
10523 | =item DESCRIPTION | |
10524 | ||
10525 | =item METHODS | |
10526 | ||
10527 | mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( | |
10528 | IO ), handles( [ EVENT_MASK ] ) | |
10529 | ||
10530 | =item SEE ALSO | |
10531 | ||
10532 | =item AUTHOR | |
10533 | ||
10534 | =item COPYRIGHT | |
10535 | ||
a45bd81d GS |
10536 | =back |
10537 | ||
14218588 GS |
10538 | =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for |
10539 | I/O objects | |
10540 | ||
d420ca49 | 10541 | =over 4 |
a45bd81d | 10542 | |
14218588 GS |
10543 | =item SYNOPSIS |
10544 | ||
10545 | =item DESCRIPTION | |
10546 | ||
74cac757 JH |
10547 | $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), |
10548 | WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), | |
10549 | $io->tell | |
14218588 GS |
10550 | |
10551 | =item HISTORY | |
10552 | ||
a45bd81d GS |
10553 | =back |
10554 | ||
14218588 GS |
10555 | =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system |
10556 | call | |
10557 | ||
d420ca49 | 10558 | =over 4 |
a45bd81d | 10559 | |
14218588 GS |
10560 | =item SYNOPSIS |
10561 | ||
10562 | =item DESCRIPTION | |
10563 | ||
10564 | =item CONSTRUCTOR | |
10565 | ||
10566 | new ( [ HANDLES ] ) | |
10567 | ||
10568 | =item METHODS | |
10569 | ||
10570 | add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( | |
10571 | [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), | |
10572 | count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) | |
10573 | ||
10574 | =item EXAMPLE | |
10575 | ||
10576 | =item AUTHOR | |
10577 | ||
10578 | =item COPYRIGHT | |
10579 | ||
a45bd81d GS |
10580 | =back |
10581 | ||
14218588 GS |
10582 | =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket |
10583 | communications | |
10584 | ||
d420ca49 | 10585 | =over 4 |
a45bd81d | 10586 | |
14218588 GS |
10587 | =item SYNOPSIS |
10588 | ||
10589 | =item DESCRIPTION | |
10590 | ||
10591 | =item CONSTRUCTOR | |
10592 | ||
10593 | new ( [ARGS] ) | |
10594 | ||
10595 | =item METHODS | |
10596 | ||
c76ac1ee GS |
10597 | accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]), |
10598 | sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected | |
14218588 GS |
10599 | |
10600 | =item SEE ALSO | |
10601 | ||
10602 | =item AUTHOR | |
10603 | ||
10604 | =item COPYRIGHT | |
10605 | ||
a45bd81d GS |
10606 | =back |
10607 | ||
14218588 GS |
10608 | =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for |
10609 | AF_INET domain sockets | |
10610 | ||
d420ca49 | 10611 | =over 4 |
a45bd81d | 10612 | |
14218588 GS |
10613 | =item SYNOPSIS |
10614 | ||
10615 | =item DESCRIPTION | |
10616 | ||
10617 | =item CONSTRUCTOR | |
10618 | ||
10619 | new ( [ARGS] ) | |
10620 | ||
d420ca49 | 10621 | =over 4 |
14218588 GS |
10622 | |
10623 | =item METHODS | |
10624 | ||
10625 | sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost | |
10626 | () | |
10627 | ||
10628 | =back | |
10629 | ||
10630 | =item SEE ALSO | |
10631 | ||
10632 | =item AUTHOR | |
10633 | ||
10634 | =item COPYRIGHT | |
10635 | ||
a45bd81d GS |
10636 | =back |
10637 | ||
14218588 GS |
10638 | =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for |
10639 | AF_UNIX domain sockets | |
10640 | ||
d420ca49 | 10641 | =over 4 |
a45bd81d | 10642 | |
14218588 GS |
10643 | =item SYNOPSIS |
10644 | ||
10645 | =item DESCRIPTION | |
10646 | ||
10647 | =item CONSTRUCTOR | |
10648 | ||
10649 | new ( [ARGS] ) | |
10650 | ||
10651 | =item METHODS | |
10652 | ||
10653 | hostpath(), peerpath() | |
10654 | ||
10655 | =item SEE ALSO | |
10656 | ||
10657 | =item AUTHOR | |
10658 | ||
10659 | =item COPYRIGHT | |
10660 | ||
a45bd81d | 10661 | =back |
14218588 | 10662 | |
d46b76b3 JH |
10663 | =head2 IPC::Msg - SysV Msg IPC object class |
10664 | ||
d420ca49 | 10665 | =over 4 |
d46b76b3 JH |
10666 | |
10667 | =item SYNOPSIS | |
10668 | ||
10669 | =item DESCRIPTION | |
10670 | ||
10671 | =item METHODS | |
10672 | ||
10673 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
10674 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
10675 | FLAGS ] ), stat | |
10676 | ||
10677 | =item SEE ALSO | |
10678 | ||
10679 | =item AUTHOR | |
10680 | ||
10681 | =item COPYRIGHT | |
10682 | ||
10683 | =back | |
10684 | ||
14218588 GS |
10685 | =head2 IPC::Open2, open2 - open a process for both reading and writing |
10686 | ||
d420ca49 | 10687 | =over 4 |
a45bd81d | 10688 | |
14218588 GS |
10689 | =item SYNOPSIS |
10690 | ||
10691 | =item DESCRIPTION | |
10692 | ||
10693 | =item WARNING | |
10694 | ||
10695 | =item SEE ALSO | |
10696 | ||
a45bd81d GS |
10697 | =back |
10698 | ||
14218588 GS |
10699 | =head2 IPC::Open3, open3 - open a process for reading, writing, and error |
10700 | handling | |
10701 | ||
d420ca49 | 10702 | =over 4 |
14218588 GS |
10703 | |
10704 | =item SYNOPSIS | |
10705 | ||
10706 | =item DESCRIPTION | |
10707 | ||
a45bd81d | 10708 | =item WARNING |
14218588 | 10709 | |
a45bd81d | 10710 | =back |
14218588 | 10711 | |
d46b76b3 JH |
10712 | =head2 IPC::Semaphore - SysV Semaphore IPC object class |
10713 | ||
d420ca49 | 10714 | =over 4 |
d46b76b3 JH |
10715 | |
10716 | =item SYNOPSIS | |
10717 | ||
10718 | =item DESCRIPTION | |
10719 | ||
10720 | =item METHODS | |
10721 | ||
10722 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
10723 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
10724 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
10725 | , VALUE ), stat | |
10726 | ||
10727 | =item SEE ALSO | |
10728 | ||
10729 | =item AUTHOR | |
10730 | ||
10731 | =item COPYRIGHT | |
10732 | ||
10733 | =back | |
10734 | ||
14218588 GS |
10735 | =head2 IPC::SysV - SysV IPC constants |
10736 | ||
d420ca49 | 10737 | =over 4 |
a45bd81d | 10738 | |
14218588 GS |
10739 | =item SYNOPSIS |
10740 | ||
10741 | =item DESCRIPTION | |
10742 | ||
10743 | ftok( PATH, ID ) | |
10744 | ||
10745 | =item SEE ALSO | |
10746 | ||
10747 | =item AUTHORS | |
10748 | ||
10749 | =item COPYRIGHT | |
10750 | ||
a45bd81d GS |
10751 | =back |
10752 | ||
14218588 GS |
10753 | =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class |
10754 | ||
d420ca49 | 10755 | =over 4 |
a45bd81d | 10756 | |
14218588 GS |
10757 | =item SYNOPSIS |
10758 | ||
10759 | =item DESCRIPTION | |
10760 | ||
10761 | =item METHODS | |
10762 | ||
10763 | new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set | |
10764 | ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, | |
10765 | FLAGS ] ), stat | |
10766 | ||
10767 | =item SEE ALSO | |
10768 | ||
10769 | =item AUTHOR | |
10770 | ||
10771 | =item COPYRIGHT | |
fb9cefb4 | 10772 | |
a45bd81d GS |
10773 | =back |
10774 | ||
fb9cefb4 GS |
10775 | =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object |
10776 | class | |
10777 | ||
d420ca49 | 10778 | =over 4 |
a45bd81d | 10779 | |
fb9cefb4 GS |
10780 | =item SYNOPSIS |
10781 | ||
10782 | =item DESCRIPTION | |
10783 | ||
10784 | =item METHODS | |
10785 | ||
10786 | new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), | |
10787 | getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), | |
10788 | set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N | |
10789 | , VALUE ), stat | |
10790 | ||
10791 | =item SEE ALSO | |
10792 | ||
10793 | =item AUTHOR | |
10794 | ||
10795 | =item COPYRIGHT | |
10796 | ||
a45bd81d GS |
10797 | =back |
10798 | ||
b38f6a39 | 10799 | =head2 Math::BigFloat - Arbitrary length float math package |
cb1a09d0 | 10800 | |
d420ca49 | 10801 | =over 4 |
a45bd81d | 10802 | |
8ebc5c01 | 10803 | =item SYNOPSIS |
cb1a09d0 AD |
10804 | |
10805 | =item DESCRIPTION | |
10806 | ||
b38f6a39 GS |
10807 | number format, Error returns 'NaN', Division is computed to, Rounding is |
10808 | performed | |
cb1a09d0 | 10809 | |
b38f6a39 | 10810 | =item BUGS |
7d2bfb28 | 10811 | |
b38f6a39 | 10812 | =item AUTHOR |
7d2bfb28 | 10813 | |
b38f6a39 GS |
10814 | =back |
10815 | ||
10816 | =head2 Math::BigInt - Arbitrary size integer math package | |
10817 | ||
d420ca49 | 10818 | =over 4 |
8ebc5c01 | 10819 | |
b38f6a39 | 10820 | =item SYNOPSIS |
d516a115 | 10821 | |
b38f6a39 GS |
10822 | =item DESCRIPTION |
10823 | ||
10824 | Canonical notation, Input, Output | |
10825 | ||
10826 | =item EXAMPLES | |
10827 | ||
10828 | =item Autocreating constants | |
4a6725af | 10829 | |
8ebc5c01 | 10830 | =item BUGS |
7d2bfb28 | 10831 | |
b38f6a39 | 10832 | =item AUTHOR |
7d2bfb28 | 10833 | |
a45bd81d GS |
10834 | =back |
10835 | ||
d722968f JH |
10836 | =head2 Math::Complex - complex numbers and associated mathematical |
10837 | functions | |
10838 | ||
d420ca49 | 10839 | =over 4 |
d722968f JH |
10840 | |
10841 | =item SYNOPSIS | |
10842 | ||
10843 | =item DESCRIPTION | |
10844 | ||
10845 | =item OPERATIONS | |
10846 | ||
10847 | =item CREATION | |
10848 | ||
10849 | =item STRINGIFICATION | |
10850 | ||
d420ca49 | 10851 | =over 4 |
d722968f JH |
10852 | |
10853 | =item CHANGED IN PERL 5.6 | |
10854 | ||
10855 | =back | |
10856 | ||
10857 | =item USAGE | |
10858 | ||
10859 | =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO | |
10860 | ||
10861 | =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS | |
10862 | ||
10863 | =item BUGS | |
10864 | ||
10865 | =item AUTHORS | |
10866 | ||
10867 | =back | |
10868 | ||
4a6725af NT |
10869 | =head2 Math::Trig - trigonometric functions |
10870 | ||
d420ca49 | 10871 | =over 4 |
a45bd81d | 10872 | |
4a6725af NT |
10873 | =item SYNOPSIS |
10874 | ||
10875 | =item DESCRIPTION | |
10876 | ||
10877 | =item TRIGONOMETRIC FUNCTIONS | |
10878 | ||
fb9cefb4 GS |
10879 | B<tan> |
10880 | ||
d420ca49 | 10881 | =over 4 |
4a6725af | 10882 | |
5cd24f17 | 10883 | =item ERRORS DUE TO DIVISION BY ZERO |
10884 | ||
10885 | =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS | |
4a6725af NT |
10886 | |
10887 | =back | |
10888 | ||
fb9cefb4 GS |
10889 | =item PLANE ANGLE CONVERSIONS |
10890 | ||
10891 | =item RADIAL COORDINATE CONVERSIONS | |
10892 | ||
d420ca49 | 10893 | =over 4 |
fb9cefb4 GS |
10894 | |
10895 | =item COORDINATE SYSTEMS | |
10896 | ||
10897 | =item 3-D ANGLE CONVERSIONS | |
10898 | ||
10899 | cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, | |
10900 | cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical | |
10901 | ||
10902 | =back | |
10903 | ||
10904 | =item GREAT CIRCLE DISTANCES | |
10905 | ||
10906 | =item EXAMPLES | |
4a6725af | 10907 | |
5cd24f17 | 10908 | =item BUGS |
10909 | ||
10910 | =item AUTHORS | |
10911 | ||
a45bd81d GS |
10912 | =back |
10913 | ||
8ebc5c01 | 10914 | =head2 NDBM_File - Tied access to ndbm files |
7d2bfb28 | 10915 | |
d420ca49 | 10916 | =over 4 |
a45bd81d | 10917 | |
8ebc5c01 | 10918 | =item SYNOPSIS |
7d2bfb28 | 10919 | |
a9ef4385 JH |
10920 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
10921 | ||
10922 | =item DIAGNOSTICS | |
10923 | ||
d420ca49 | 10924 | =over 4 |
a9ef4385 JH |
10925 | |
10926 | =item C<ndbm store returned -1, errno 22, key "..." at ...> | |
10927 | ||
10928 | =back | |
10929 | ||
10930 | =item BUGS AND WARNINGS | |
7d2bfb28 | 10931 | |
a45bd81d GS |
10932 | =back |
10933 | ||
8ebc5c01 | 10934 | =head2 Net::Ping - check a remote host for reachability |
7d2bfb28 | 10935 | |
d420ca49 | 10936 | =over 4 |
a45bd81d | 10937 | |
8ebc5c01 | 10938 | =item SYNOPSIS |
7d2bfb28 | 10939 | |
8ebc5c01 | 10940 | =item DESCRIPTION |
7d2bfb28 | 10941 | |
d420ca49 | 10942 | =over 4 |
8ebc5c01 | 10943 | |
10944 | =item Functions | |
7d2bfb28 | 10945 | |
8ebc5c01 | 10946 | Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, |
10947 | $timeout]);, $p->close();, pingecho($host [, $timeout]); | |
7d2bfb28 | 10948 | |
8ebc5c01 | 10949 | =back |
10950 | ||
10951 | =item WARNING | |
7d2bfb28 | 10952 | |
8ebc5c01 | 10953 | =item NOTES |
7d2bfb28 | 10954 | |
a45bd81d GS |
10955 | =back |
10956 | ||
8ebc5c01 | 10957 | =head2 Net::hostent - by-name interface to Perl's built-in gethost*() |
10958 | functions | |
7d2bfb28 | 10959 | |
d420ca49 | 10960 | =over 4 |
a45bd81d | 10961 | |
8ebc5c01 | 10962 | =item SYNOPSIS |
7d2bfb28 | 10963 | |
8ebc5c01 | 10964 | =item DESCRIPTION |
7d2bfb28 | 10965 | |
cb1a09d0 AD |
10966 | =item EXAMPLES |
10967 | ||
8ebc5c01 | 10968 | =item NOTE |
cb1a09d0 | 10969 | |
8ebc5c01 | 10970 | =item AUTHOR |
cb1a09d0 | 10971 | |
a45bd81d GS |
10972 | =back |
10973 | ||
8ebc5c01 | 10974 | =head2 Net::netent - by-name interface to Perl's built-in getnet*() |
10975 | functions | |
cb1a09d0 | 10976 | |
d420ca49 | 10977 | =over 4 |
a45bd81d | 10978 | |
8ebc5c01 | 10979 | =item SYNOPSIS |
cb1a09d0 | 10980 | |
8ebc5c01 | 10981 | =item DESCRIPTION |
cb1a09d0 | 10982 | |
8ebc5c01 | 10983 | =item EXAMPLES |
cb1a09d0 | 10984 | |
8ebc5c01 | 10985 | =item NOTE |
cb1a09d0 | 10986 | |
8ebc5c01 | 10987 | =item AUTHOR |
cb1a09d0 | 10988 | |
a45bd81d GS |
10989 | =back |
10990 | ||
8ebc5c01 | 10991 | =head2 Net::protoent - by-name interface to Perl's built-in getproto*() |
10992 | functions | |
cb1a09d0 | 10993 | |
d420ca49 | 10994 | =over 4 |
a45bd81d | 10995 | |
8ebc5c01 | 10996 | =item SYNOPSIS |
cb1a09d0 AD |
10997 | |
10998 | =item DESCRIPTION | |
10999 | ||
8ebc5c01 | 11000 | =item NOTE |
cb1a09d0 | 11001 | |
8ebc5c01 | 11002 | =item AUTHOR |
cb1a09d0 | 11003 | |
a45bd81d GS |
11004 | =back |
11005 | ||
8ebc5c01 | 11006 | =head2 Net::servent - by-name interface to Perl's built-in getserv*() |
11007 | functions | |
cb1a09d0 | 11008 | |
d420ca49 | 11009 | =over 4 |
a45bd81d | 11010 | |
cb1a09d0 AD |
11011 | =item SYNOPSIS |
11012 | ||
cb1a09d0 AD |
11013 | =item DESCRIPTION |
11014 | ||
8ebc5c01 | 11015 | =item EXAMPLES |
cb1a09d0 | 11016 | |
8ebc5c01 | 11017 | =item NOTE |
cb1a09d0 | 11018 | |
8ebc5c01 | 11019 | =item AUTHOR |
cb1a09d0 | 11020 | |
a45bd81d GS |
11021 | =back |
11022 | ||
14218588 GS |
11023 | =head2 O - Generic interface to Perl Compiler backends |
11024 | ||
d420ca49 | 11025 | =over 4 |
a45bd81d | 11026 | |
14218588 GS |
11027 | =item SYNOPSIS |
11028 | ||
11029 | =item DESCRIPTION | |
11030 | ||
11031 | =item CONVENTIONS | |
11032 | ||
11033 | =item IMPLEMENTATION | |
11034 | ||
11035 | =item AUTHOR | |
11036 | ||
a45bd81d GS |
11037 | =back |
11038 | ||
8ebc5c01 | 11039 | =head2 ODBM_File - Tied access to odbm files |
cb1a09d0 | 11040 | |
d420ca49 | 11041 | =over 4 |
a45bd81d | 11042 | |
cb1a09d0 AD |
11043 | =item SYNOPSIS |
11044 | ||
a9ef4385 JH |
11045 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
11046 | ||
11047 | =item DIAGNOSTICS | |
11048 | ||
d420ca49 | 11049 | =over 4 |
a9ef4385 JH |
11050 | |
11051 | =item C<odbm store returned -1, errno 22, key "..." at ...> | |
11052 | ||
11053 | =back | |
11054 | ||
11055 | =item BUGS AND WARNINGS | |
cb1a09d0 | 11056 | |
a45bd81d GS |
11057 | =back |
11058 | ||
8ebc5c01 | 11059 | =head2 Opcode - Disable named opcodes when compiling perl code |
cb1a09d0 | 11060 | |
d420ca49 | 11061 | =over 4 |
a45bd81d | 11062 | |
8ebc5c01 | 11063 | =item SYNOPSIS |
cb1a09d0 | 11064 | |
8ebc5c01 | 11065 | =item DESCRIPTION |
cb1a09d0 | 11066 | |
8ebc5c01 | 11067 | =item NOTE |
cb1a09d0 | 11068 | |
8ebc5c01 | 11069 | =item WARNING |
cb1a09d0 | 11070 | |
8ebc5c01 | 11071 | =item Operator Names and Operator Lists |
cb1a09d0 | 11072 | |
8ebc5c01 | 11073 | an operator name (opname), an operator tag name (optag), a negated opname |
11074 | or optag, an operator set (opset) | |
cb1a09d0 | 11075 | |
8ebc5c01 | 11076 | =item Opcode Functions |
cb1a09d0 | 11077 | |
8ebc5c01 | 11078 | opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET), |
11079 | full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...), | |
11080 | define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...), | |
11081 | opdump (PAT) | |
cb1a09d0 | 11082 | |
8ebc5c01 | 11083 | =item Manipulating Opsets |
cb1a09d0 | 11084 | |
8ebc5c01 | 11085 | =item TO DO (maybe) |
cb1a09d0 | 11086 | |
a45bd81d GS |
11087 | =back |
11088 | ||
d420ca49 | 11089 | =over 4 |
a45bd81d | 11090 | |
8ebc5c01 | 11091 | =item Predefined Opcode Tags |
cb1a09d0 | 11092 | |
8ebc5c01 | 11093 | :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math, |
d516a115 JH |
11094 | :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open, |
11095 | :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided, | |
11096 | :dangerous | |
cb1a09d0 | 11097 | |
8ebc5c01 | 11098 | =item SEE ALSO |
cb1a09d0 | 11099 | |
8ebc5c01 | 11100 | =item AUTHORS |
cb1a09d0 | 11101 | |
a45bd81d GS |
11102 | =back |
11103 | ||
8ebc5c01 | 11104 | =head2 Opcode::Safe, Safe - Compile and execute code in restricted |
11105 | compartments | |
cb1a09d0 | 11106 | |
d420ca49 | 11107 | =over 4 |
a45bd81d | 11108 | |
cb1a09d0 AD |
11109 | =item SYNOPSIS |
11110 | ||
cb1a09d0 AD |
11111 | =item DESCRIPTION |
11112 | ||
8ebc5c01 | 11113 | a new namespace, an operator mask |
11114 | ||
11115 | =item WARNING | |
cb1a09d0 | 11116 | |
d420ca49 | 11117 | =over 4 |
cb1a09d0 | 11118 | |
8ebc5c01 | 11119 | =item RECENT CHANGES |
cb1a09d0 | 11120 | |
8ebc5c01 | 11121 | =item Methods in class Safe |
cb1a09d0 | 11122 | |
8ebc5c01 | 11123 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, |
11124 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
11125 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
11126 | root (NAMESPACE), mask (MASK) | |
cb1a09d0 | 11127 | |
8ebc5c01 | 11128 | =item Some Safety Issues |
cb1a09d0 | 11129 | |
8ebc5c01 | 11130 | Memory, CPU, Snooping, Signals, State Changes |
cb1a09d0 | 11131 | |
8ebc5c01 | 11132 | =item AUTHOR |
cb1a09d0 | 11133 | |
8ebc5c01 | 11134 | =back |
cb1a09d0 | 11135 | |
a45bd81d GS |
11136 | =back |
11137 | ||
8ebc5c01 | 11138 | =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when |
11139 | compiling | |
cb1a09d0 | 11140 | |
d420ca49 | 11141 | =over 4 |
a45bd81d | 11142 | |
14218588 | 11143 | =item SYNOPSIS |
cb1a09d0 | 11144 | |
8ebc5c01 | 11145 | =item DESCRIPTION |
cb1a09d0 | 11146 | |
8ebc5c01 | 11147 | =item SEE ALSO |
cb1a09d0 | 11148 | |
a45bd81d GS |
11149 | =back |
11150 | ||
cb1a09d0 AD |
11151 | =head2 POSIX - Perl interface to IEEE Std 1003.1 |
11152 | ||
d420ca49 | 11153 | =over 4 |
a45bd81d | 11154 | |
cb1a09d0 AD |
11155 | =item SYNOPSIS |
11156 | ||
cb1a09d0 AD |
11157 | =item DESCRIPTION |
11158 | ||
cb1a09d0 AD |
11159 | =item NOTE |
11160 | ||
8ebc5c01 | 11161 | =item CAVEATS |
cb1a09d0 AD |
11162 | |
11163 | =item FUNCTIONS | |
11164 | ||
8ebc5c01 | 11165 | _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2, |
11166 | atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown, | |
11167 | clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime, | |
11168 | cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, | |
11169 | execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, | |
11170 | fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, | |
11171 | fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, | |
11172 | fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, | |
11173 | getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, | |
11174 | getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, | |
11175 | iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, | |
11176 | isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, | |
11177 | longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, | |
11178 | memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, | |
11179 | opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, | |
11180 | qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, | |
11181 | rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, | |
11182 | setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, | |
11183 | sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, | |
11184 | strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, | |
4755096e GS |
11185 | strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, |
11186 | strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain, | |
11187 | tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile, | |
11188 | tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc, | |
11189 | unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs, | |
11190 | wctomb, write | |
cb1a09d0 AD |
11191 | |
11192 | =item CLASSES | |
11193 | ||
d420ca49 | 11194 | =over 4 |
cb1a09d0 | 11195 | |
cb1a09d0 AD |
11196 | =item POSIX::SigAction |
11197 | ||
cb1a09d0 AD |
11198 | new |
11199 | ||
11200 | =item POSIX::SigSet | |
11201 | ||
cb1a09d0 AD |
11202 | new, addset, delset, emptyset, fillset, ismember |
11203 | ||
11204 | =item POSIX::Termios | |
11205 | ||
cb1a09d0 AD |
11206 | new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag, |
11207 | getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag, | |
11208 | setoflag, setospeed, Baud rate values, Terminal interface values, c_cc | |
11209 | field values, c_cflag field values, c_iflag field values, c_lflag field | |
11210 | values, c_oflag field values | |
11211 | ||
cb1a09d0 AD |
11212 | =back |
11213 | ||
11214 | =item PATHNAME CONSTANTS | |
11215 | ||
cb1a09d0 AD |
11216 | Constants |
11217 | ||
11218 | =item POSIX CONSTANTS | |
11219 | ||
cb1a09d0 AD |
11220 | Constants |
11221 | ||
11222 | =item SYSTEM CONFIGURATION | |
11223 | ||
cb1a09d0 AD |
11224 | Constants |
11225 | ||
11226 | =item ERRNO | |
11227 | ||
cb1a09d0 AD |
11228 | Constants |
11229 | ||
11230 | =item FCNTL | |
11231 | ||
cb1a09d0 AD |
11232 | Constants |
11233 | ||
11234 | =item FLOAT | |
11235 | ||
cb1a09d0 AD |
11236 | Constants |
11237 | ||
11238 | =item LIMITS | |
11239 | ||
cb1a09d0 AD |
11240 | Constants |
11241 | ||
11242 | =item LOCALE | |
11243 | ||
cb1a09d0 AD |
11244 | Constants |
11245 | ||
11246 | =item MATH | |
11247 | ||
cb1a09d0 AD |
11248 | Constants |
11249 | ||
11250 | =item SIGNAL | |
11251 | ||
cb1a09d0 AD |
11252 | Constants |
11253 | ||
11254 | =item STAT | |
11255 | ||
cb1a09d0 AD |
11256 | Constants, Macros |
11257 | ||
11258 | =item STDLIB | |
11259 | ||
cb1a09d0 AD |
11260 | Constants |
11261 | ||
11262 | =item STDIO | |
11263 | ||
cb1a09d0 AD |
11264 | Constants |
11265 | ||
11266 | =item TIME | |
11267 | ||
cb1a09d0 AD |
11268 | Constants |
11269 | ||
11270 | =item UNISTD | |
11271 | ||
cb1a09d0 AD |
11272 | Constants |
11273 | ||
11274 | =item WAIT | |
11275 | ||
cb1a09d0 AD |
11276 | Constants, Macros |
11277 | ||
a45bd81d GS |
11278 | =back |
11279 | ||
14218588 GS |
11280 | =head2 Pod::Checker, podchecker() - check pod documents for syntax errors |
11281 | ||
d420ca49 | 11282 | =over 4 |
a45bd81d | 11283 | |
14218588 GS |
11284 | =item SYNOPSIS |
11285 | ||
11286 | =item OPTIONS/ARGUMENTS | |
11287 | ||
d420ca49 | 11288 | =over 4 |
a45bd81d | 11289 | |
694468e3 | 11290 | =item podchecker() |
a45bd81d GS |
11291 | |
11292 | B<-warnings> =E<gt> I<val> | |
11293 | ||
11294 | =back | |
11295 | ||
14218588 GS |
11296 | =item DESCRIPTION |
11297 | ||
694468e3 GS |
11298 | =item DIAGNOSTICS |
11299 | ||
d420ca49 | 11300 | =over 4 |
a45bd81d | 11301 | |
694468e3 GS |
11302 | =item Errors |
11303 | ||
11304 | empty =headn, =over on line I<N> without closing =back, =item without | |
11305 | previous =over, =back without previous =over, No argument for =begin, =end | |
11306 | without =begin, Nested =begin's, =for without formatter specification, | |
11307 | unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown | |
11308 | interior-sequence "I<SEQ>", nested commands | |
11309 | I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity | |
11310 | number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>, | |
11311 | empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s) | |
11312 | after =back | |
11313 | ||
a45bd81d GS |
11314 | =item Warnings |
11315 | ||
93d73c42 | 11316 | multiple occurence of link target I<name>, line containing nothing but |
694468e3 GS |
11317 | whitespace in paragraph, file does not start with =head, No numeric |
11318 | argument for =over, previous =item has no contents, preceding non-item | |
11319 | paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped | |
11320 | C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument | |
11321 | for =item, empty section in previous paragraph, Verbatim paragraph in NAME | |
10862624 RF |
11322 | section |
11323 | ||
11324 | =item Hyperlinks | |
11325 | ||
11326 | collapsing newlines to blanks, ignoring leading/trailing whitespace in | |
11327 | link, (section) in '$page' deprecated, alternative text/node '%s' contains | |
11328 | non-escaped | or / | |
a45bd81d | 11329 | |
694468e3 | 11330 | =back |
a45bd81d GS |
11331 | |
11332 | =item RETURN VALUE | |
11333 | ||
14218588 GS |
11334 | =item EXAMPLES |
11335 | ||
694468e3 GS |
11336 | =item INTERFACE |
11337 | ||
11338 | =back | |
11339 | ||
10862624 RF |
11340 | C<Pod::Checker-E<gt>new( %options )> |
11341 | ||
694468e3 GS |
11342 | C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts}, |
11343 | @args )> | |
11344 | ||
11345 | C<$checker-E<gt>num_errors()> | |
11346 | ||
11347 | C<$checker-E<gt>name()> | |
11348 | ||
11349 | C<$checker-E<gt>node()> | |
11350 | ||
11351 | C<$checker-E<gt>idx()> | |
11352 | ||
11353 | C<$checker-E<gt>hyperlink()> | |
11354 | ||
d420ca49 | 11355 | =over 4 |
694468e3 | 11356 | |
14218588 GS |
11357 | =item AUTHOR |
11358 | ||
a45bd81d GS |
11359 | =back |
11360 | ||
694468e3 | 11361 | =head2 Pod::Find - find POD documents in directory trees |
a45bd81d | 11362 | |
d420ca49 | 11363 | =over 4 |
a45bd81d GS |
11364 | |
11365 | =item SYNOPSIS | |
11366 | ||
11367 | =item DESCRIPTION | |
11368 | ||
10862624 RF |
11369 | =back |
11370 | ||
d420ca49 | 11371 | =over 4 |
10862624 RF |
11372 | |
11373 | =item C<pod_find( { %opts } , @directories )> | |
a45bd81d | 11374 | |
10862624 RF |
11375 | C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt> |
11376 | 1> | |
11377 | ||
11378 | =back | |
11379 | ||
d420ca49 | 11380 | =over 4 |
10862624 RF |
11381 | |
11382 | =item C<simplify_name( $str )> | |
11383 | ||
11384 | =back | |
11385 | ||
d420ca49 | 11386 | =over 4 |
10862624 RF |
11387 | |
11388 | =item C<pod_where( { %opts }, $pod )> | |
11389 | ||
11390 | C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt> | |
11391 | 1> | |
11392 | ||
11393 | =back | |
11394 | ||
d420ca49 | 11395 | =over 4 |
10862624 RF |
11396 | |
11397 | =item C<contains_pod( $file , $verbose )> | |
11398 | ||
11399 | =back | |
11400 | ||
d420ca49 | 11401 | =over 4 |
a45bd81d GS |
11402 | |
11403 | =item AUTHOR | |
11404 | ||
694468e3 GS |
11405 | =item SEE ALSO |
11406 | ||
a45bd81d GS |
11407 | =back |
11408 | ||
193fb0af | 11409 | =head2 Pod::Html - module to convert pod files to HTML |
54310121 | 11410 | |
d420ca49 | 11411 | =over 4 |
a45bd81d | 11412 | |
54310121 | 11413 | =item SYNOPSIS |
11414 | ||
11415 | =item DESCRIPTION | |
11416 | ||
11417 | =item ARGUMENTS | |
11418 | ||
b38f6a39 GS |
11419 | backlink, css, flush, header, help, htmldir, htmlroot, index, infile, |
11420 | libpods, netscape, outfile, podpath, podroot, quiet, recurse, title, | |
11421 | verbose | |
54310121 | 11422 | |
11423 | =item EXAMPLE | |
11424 | ||
c76ac1ee GS |
11425 | =item ENVIRONMENT |
11426 | ||
54310121 | 11427 | =item AUTHOR |
11428 | ||
54310121 | 11429 | =item SEE ALSO |
11430 | ||
11431 | =item COPYRIGHT | |
11432 | ||
a45bd81d GS |
11433 | =back |
11434 | ||
14218588 GS |
11435 | =head2 Pod::InputObjects - objects representing POD input paragraphs, |
11436 | commands, etc. | |
11437 | ||
d420ca49 | 11438 | =over 4 |
a45bd81d | 11439 | |
14218588 GS |
11440 | =item SYNOPSIS |
11441 | ||
11442 | =item REQUIRES | |
11443 | ||
11444 | =item EXPORTS | |
11445 | ||
11446 | =item DESCRIPTION | |
11447 | ||
10862624 RF |
11448 | package B<Pod::InputSource>, package B<Pod::Paragraph>, package |
11449 | B<Pod::InteriorSequence>, package B<Pod::ParseTree> | |
14218588 | 11450 | |
a45bd81d GS |
11451 | =back |
11452 | ||
d420ca49 | 11453 | =over 4 |
a45bd81d | 11454 | |
14218588 GS |
11455 | =item B<Pod::InputSource> |
11456 | ||
a45bd81d GS |
11457 | =back |
11458 | ||
d420ca49 | 11459 | =over 4 |
14218588 GS |
11460 | |
11461 | =item B<new()> | |
11462 | ||
a45bd81d GS |
11463 | =back |
11464 | ||
d420ca49 | 11465 | =over 4 |
a45bd81d | 11466 | |
14218588 GS |
11467 | =item B<name()> |
11468 | ||
a45bd81d GS |
11469 | =back |
11470 | ||
d420ca49 | 11471 | =over 4 |
a45bd81d | 11472 | |
14218588 GS |
11473 | =item B<handle()> |
11474 | ||
a45bd81d GS |
11475 | =back |
11476 | ||
d420ca49 | 11477 | =over 4 |
a45bd81d | 11478 | |
14218588 GS |
11479 | =item B<was_cutting()> |
11480 | ||
11481 | =back | |
11482 | ||
d420ca49 | 11483 | =over 4 |
a45bd81d | 11484 | |
14218588 GS |
11485 | =item B<Pod::Paragraph> |
11486 | ||
a45bd81d GS |
11487 | =back |
11488 | ||
d420ca49 | 11489 | =over 4 |
14218588 | 11490 | |
10862624 | 11491 | =item Pod::Paragraph-E<gt>B<new()> |
14218588 | 11492 | |
a45bd81d GS |
11493 | =back |
11494 | ||
d420ca49 | 11495 | =over 4 |
a45bd81d | 11496 | |
10862624 | 11497 | =item $pod_para-E<gt>B<cmd_name()> |
14218588 | 11498 | |
a45bd81d GS |
11499 | =back |
11500 | ||
d420ca49 | 11501 | =over 4 |
a45bd81d | 11502 | |
10862624 | 11503 | =item $pod_para-E<gt>B<text()> |
14218588 | 11504 | |
a45bd81d GS |
11505 | =back |
11506 | ||
d420ca49 | 11507 | =over 4 |
a45bd81d | 11508 | |
10862624 | 11509 | =item $pod_para-E<gt>B<raw_text()> |
14218588 | 11510 | |
a45bd81d GS |
11511 | =back |
11512 | ||
d420ca49 | 11513 | =over 4 |
a45bd81d | 11514 | |
10862624 | 11515 | =item $pod_para-E<gt>B<cmd_prefix()> |
14218588 | 11516 | |
a45bd81d GS |
11517 | =back |
11518 | ||
d420ca49 | 11519 | =over 4 |
a45bd81d | 11520 | |
10862624 | 11521 | =item $pod_para-E<gt>B<cmd_separator()> |
14218588 | 11522 | |
a45bd81d GS |
11523 | =back |
11524 | ||
d420ca49 | 11525 | =over 4 |
a45bd81d | 11526 | |
10862624 | 11527 | =item $pod_para-E<gt>B<parse_tree()> |
14218588 | 11528 | |
a45bd81d GS |
11529 | =back |
11530 | ||
d420ca49 | 11531 | =over 4 |
a45bd81d | 11532 | |
10862624 | 11533 | =item $pod_para-E<gt>B<file_line()> |
14218588 GS |
11534 | |
11535 | =back | |
11536 | ||
d420ca49 | 11537 | =over 4 |
a45bd81d | 11538 | |
14218588 GS |
11539 | =item B<Pod::InteriorSequence> |
11540 | ||
a45bd81d GS |
11541 | =back |
11542 | ||
d420ca49 | 11543 | =over 4 |
14218588 | 11544 | |
10862624 | 11545 | =item Pod::InteriorSequence-E<gt>B<new()> |
14218588 | 11546 | |
a45bd81d GS |
11547 | =back |
11548 | ||
d420ca49 | 11549 | =over 4 |
a45bd81d | 11550 | |
10862624 | 11551 | =item $pod_seq-E<gt>B<cmd_name()> |
14218588 | 11552 | |
a45bd81d GS |
11553 | =back |
11554 | ||
d420ca49 | 11555 | =over 4 |
a45bd81d | 11556 | |
10862624 | 11557 | =item $pod_seq-E<gt>B<prepend()> |
14218588 | 11558 | |
a45bd81d GS |
11559 | =back |
11560 | ||
d420ca49 | 11561 | =over 4 |
a45bd81d | 11562 | |
10862624 | 11563 | =item $pod_seq-E<gt>B<append()> |
14218588 | 11564 | |
a45bd81d GS |
11565 | =back |
11566 | ||
d420ca49 | 11567 | =over 4 |
a45bd81d | 11568 | |
10862624 | 11569 | =item $pod_seq-E<gt>B<nested()> |
14218588 | 11570 | |
a45bd81d GS |
11571 | =back |
11572 | ||
d420ca49 | 11573 | =over 4 |
a45bd81d | 11574 | |
10862624 | 11575 | =item $pod_seq-E<gt>B<raw_text()> |
14218588 | 11576 | |
a45bd81d GS |
11577 | =back |
11578 | ||
d420ca49 | 11579 | =over 4 |
a45bd81d | 11580 | |
10862624 | 11581 | =item $pod_seq-E<gt>B<left_delimiter()> |
14218588 | 11582 | |
a45bd81d GS |
11583 | =back |
11584 | ||
d420ca49 | 11585 | =over 4 |
a45bd81d | 11586 | |
10862624 | 11587 | =item $pod_seq-E<gt>B<right_delimiter()> |
14218588 | 11588 | |
a45bd81d GS |
11589 | =back |
11590 | ||
d420ca49 | 11591 | =over 4 |
a45bd81d | 11592 | |
10862624 | 11593 | =item $pod_seq-E<gt>B<parse_tree()> |
14218588 | 11594 | |
a45bd81d GS |
11595 | =back |
11596 | ||
d420ca49 | 11597 | =over 4 |
a45bd81d | 11598 | |
10862624 | 11599 | =item $pod_seq-E<gt>B<file_line()> |
14218588 | 11600 | |
a45bd81d GS |
11601 | =back |
11602 | ||
d420ca49 | 11603 | =over 4 |
a45bd81d | 11604 | |
10862624 | 11605 | =item Pod::InteriorSequence::B<DESTROY()> |
14218588 GS |
11606 | |
11607 | =back | |
11608 | ||
d420ca49 | 11609 | =over 4 |
a45bd81d | 11610 | |
14218588 GS |
11611 | =item B<Pod::ParseTree> |
11612 | ||
a45bd81d GS |
11613 | =back |
11614 | ||
d420ca49 | 11615 | =over 4 |
14218588 | 11616 | |
10862624 | 11617 | =item Pod::ParseTree-E<gt>B<new()> |
14218588 | 11618 | |
a45bd81d GS |
11619 | =back |
11620 | ||
d420ca49 | 11621 | =over 4 |
a45bd81d | 11622 | |
10862624 | 11623 | =item $ptree-E<gt>B<top()> |
14218588 | 11624 | |
a45bd81d GS |
11625 | =back |
11626 | ||
d420ca49 | 11627 | =over 4 |
a45bd81d | 11628 | |
10862624 | 11629 | =item $ptree-E<gt>B<children()> |
14218588 | 11630 | |
a45bd81d GS |
11631 | =back |
11632 | ||
d420ca49 | 11633 | =over 4 |
a45bd81d | 11634 | |
10862624 | 11635 | =item $ptree-E<gt>B<prepend()> |
14218588 | 11636 | |
a45bd81d GS |
11637 | =back |
11638 | ||
d420ca49 | 11639 | =over 4 |
a45bd81d | 11640 | |
10862624 | 11641 | =item $ptree-E<gt>B<append()> |
14218588 | 11642 | |
a45bd81d GS |
11643 | =back |
11644 | ||
d420ca49 | 11645 | =over 4 |
a45bd81d | 11646 | |
10862624 | 11647 | =item $ptree-E<gt>B<raw_text()> |
14218588 | 11648 | |
a45bd81d GS |
11649 | =back |
11650 | ||
d420ca49 | 11651 | =over 4 |
a45bd81d | 11652 | |
10862624 | 11653 | =item Pod::ParseTree::B<DESTROY()> |
14218588 GS |
11654 | |
11655 | =back | |
11656 | ||
d420ca49 | 11657 | =over 4 |
a45bd81d | 11658 | |
14218588 GS |
11659 | =item SEE ALSO |
11660 | ||
11661 | =item AUTHOR | |
11662 | ||
a45bd81d GS |
11663 | =back |
11664 | ||
497711e7 GS |
11665 | =head2 Pod::LaTeX - Convert Pod data to formatted Latex |
11666 | ||
d420ca49 | 11667 | =over 4 |
497711e7 GS |
11668 | |
11669 | =item SYNOPSIS | |
11670 | ||
11671 | =item DESCRIPTION | |
11672 | ||
11673 | =back | |
11674 | ||
d420ca49 | 11675 | =over 4 |
497711e7 GS |
11676 | |
11677 | =item OBJECT METHODS | |
11678 | ||
11679 | C<initialize> | |
11680 | ||
11681 | =back | |
11682 | ||
d420ca49 | 11683 | =over 4 |
497711e7 GS |
11684 | |
11685 | =item Data Accessors | |
11686 | ||
11687 | B<AddPreamble> | |
11688 | ||
11689 | =back | |
11690 | ||
11691 | B<AddPostamble> | |
11692 | ||
11693 | B<Head1Level> | |
11694 | ||
11695 | B<Label> | |
11696 | ||
11697 | B<LevelNoNum> | |
11698 | ||
11699 | B<MakeIndex> | |
11700 | ||
11701 | B<ReplaceNAMEwithSection> | |
11702 | ||
11703 | B<StartWithNewPage> | |
11704 | ||
11705 | B<TableOfContents> | |
11706 | ||
11707 | B<UniqueLabels> | |
11708 | ||
11709 | B<UserPreamble> | |
11710 | ||
11711 | B<UserPostamble> | |
11712 | ||
11713 | B<Lists> | |
11714 | ||
d420ca49 | 11715 | =over 4 |
497711e7 GS |
11716 | |
11717 | =item Subclassed methods | |
11718 | ||
11719 | =back | |
11720 | ||
11721 | B<begin_pod> | |
11722 | ||
11723 | B<end_pod> | |
11724 | ||
11725 | B<command> | |
11726 | ||
11727 | B<verbatim> | |
11728 | ||
11729 | B<textblock> | |
11730 | ||
11731 | B<interior_sequence> | |
11732 | ||
d420ca49 | 11733 | =over 4 |
497711e7 GS |
11734 | |
11735 | =item List Methods | |
11736 | ||
11737 | B<begin_list> | |
11738 | ||
11739 | =back | |
11740 | ||
11741 | B<end_list> | |
11742 | ||
11743 | B<add_item> | |
11744 | ||
d420ca49 | 11745 | =over 4 |
497711e7 GS |
11746 | |
11747 | =item Methods for headings | |
11748 | ||
11749 | B<head> | |
11750 | ||
11751 | =back | |
11752 | ||
d420ca49 | 11753 | =over 4 |
497711e7 GS |
11754 | |
11755 | =item Internal methods | |
11756 | ||
11757 | B<_output> | |
11758 | ||
11759 | =back | |
11760 | ||
11761 | B<_replace_special_chars> | |
11762 | ||
11763 | B<_create_label> | |
11764 | ||
11765 | B<_create_index> | |
11766 | ||
11767 | B<_clean_latex_commands> | |
11768 | ||
d420ca49 | 11769 | =over 4 |
497711e7 GS |
11770 | |
11771 | =item NOTES | |
11772 | ||
11773 | =item SEE ALSO | |
11774 | ||
11775 | =item AUTHORS | |
11776 | ||
11777 | =item COPYRIGHT | |
11778 | ||
11779 | =item REVISION | |
11780 | ||
11781 | =back | |
11782 | ||
c76ac1ee GS |
11783 | =head2 Pod::Man - Convert POD data to formatted *roff input |
11784 | ||
d420ca49 | 11785 | =over 4 |
a45bd81d | 11786 | |
c76ac1ee GS |
11787 | =item SYNOPSIS |
11788 | ||
11789 | =item DESCRIPTION | |
11790 | ||
91331b4f JH |
11791 | center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes, |
11792 | release, section | |
c76ac1ee GS |
11793 | |
11794 | =item DIAGNOSTICS | |
11795 | ||
91331b4f JH |
11796 | roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote |
11797 | specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape | |
9fa7f388 JH |
11798 | EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on |
11799 | line %d, Unmatched =back | |
c76ac1ee GS |
11800 | |
11801 | =item BUGS | |
11802 | ||
c76ac1ee GS |
11803 | =item SEE ALSO |
11804 | ||
11805 | =item AUTHOR | |
11806 | ||
a45bd81d GS |
11807 | =back |
11808 | ||
694468e3 GS |
11809 | =head2 Pod::ParseUtils - helpers for POD parsing and conversion |
11810 | ||
d420ca49 | 11811 | =over 4 |
694468e3 GS |
11812 | |
11813 | =item SYNOPSIS | |
11814 | ||
11815 | =item DESCRIPTION | |
11816 | ||
11817 | =back | |
11818 | ||
d420ca49 | 11819 | =over 4 |
694468e3 GS |
11820 | |
11821 | =item Pod::List | |
11822 | ||
10862624 | 11823 | Pod::List-E<gt>new() |
694468e3 GS |
11824 | |
11825 | =back | |
11826 | ||
10862624 | 11827 | $list-E<gt>file() |
694468e3 | 11828 | |
10862624 | 11829 | $list-E<gt>start() |
694468e3 | 11830 | |
10862624 | 11831 | $list-E<gt>indent() |
694468e3 | 11832 | |
10862624 | 11833 | $list-E<gt>type() |
694468e3 | 11834 | |
10862624 | 11835 | $list-E<gt>rx() |
694468e3 | 11836 | |
10862624 | 11837 | $list-E<gt>item() |
694468e3 | 11838 | |
10862624 | 11839 | $list-E<gt>parent() |
694468e3 | 11840 | |
10862624 | 11841 | $list-E<gt>tag() |
694468e3 | 11842 | |
d420ca49 | 11843 | =over 4 |
694468e3 GS |
11844 | |
11845 | =item Pod::Hyperlink | |
11846 | ||
10862624 | 11847 | Pod::Hyperlink-E<gt>new() |
694468e3 GS |
11848 | |
11849 | =back | |
11850 | ||
10862624 | 11851 | $link-E<gt>parse($string) |
694468e3 | 11852 | |
10862624 | 11853 | $link-E<gt>markup($string) |
694468e3 | 11854 | |
10862624 | 11855 | $link-E<gt>text() |
694468e3 | 11856 | |
10862624 | 11857 | $link-E<gt>warning() |
694468e3 | 11858 | |
10862624 | 11859 | $link-E<gt>file(), $link-E<gt>line() |
694468e3 | 11860 | |
10862624 | 11861 | $link-E<gt>page() |
694468e3 | 11862 | |
10862624 | 11863 | $link-E<gt>node() |
694468e3 | 11864 | |
10862624 | 11865 | $link-E<gt>alttext() |
694468e3 | 11866 | |
10862624 | 11867 | $link-E<gt>type() |
694468e3 | 11868 | |
10862624 | 11869 | $link-E<gt>link() |
694468e3 | 11870 | |
d420ca49 | 11871 | =over 4 |
694468e3 GS |
11872 | |
11873 | =item Pod::Cache | |
11874 | ||
10862624 | 11875 | Pod::Cache-E<gt>new() |
694468e3 GS |
11876 | |
11877 | =back | |
11878 | ||
10862624 | 11879 | $cache-E<gt>item() |
694468e3 | 11880 | |
10862624 | 11881 | $cache-E<gt>find_page($name) |
694468e3 | 11882 | |
d420ca49 | 11883 | =over 4 |
694468e3 GS |
11884 | |
11885 | =item Pod::Cache::Item | |
11886 | ||
10862624 | 11887 | Pod::Cache::Item-E<gt>new() |
694468e3 GS |
11888 | |
11889 | =back | |
11890 | ||
10862624 | 11891 | $cacheitem-E<gt>page() |
694468e3 | 11892 | |
10862624 | 11893 | $cacheitem-E<gt>description() |
694468e3 | 11894 | |
10862624 | 11895 | $cacheitem-E<gt>path() |
694468e3 | 11896 | |
10862624 | 11897 | $cacheitem-E<gt>file() |
694468e3 | 11898 | |
10862624 | 11899 | $cacheitem-E<gt>nodes() |
694468e3 | 11900 | |
10862624 | 11901 | $cacheitem-E<gt>find_node($name) |
694468e3 | 11902 | |
10862624 | 11903 | $cacheitem-E<gt>idx() |
694468e3 | 11904 | |
d420ca49 | 11905 | =over 4 |
694468e3 GS |
11906 | |
11907 | =item AUTHOR | |
11908 | ||
11909 | =item SEE ALSO | |
11910 | ||
11911 | =back | |
11912 | ||
14218588 GS |
11913 | =head2 Pod::Parser - base class for creating POD filters and translators |
11914 | ||
d420ca49 | 11915 | =over 4 |
a45bd81d | 11916 | |
14218588 GS |
11917 | =item SYNOPSIS |
11918 | ||
11919 | =item REQUIRES | |
11920 | ||
11921 | =item EXPORTS | |
11922 | ||
11923 | =item DESCRIPTION | |
11924 | ||
11925 | =item QUICK OVERVIEW | |
11926 | ||
c76ac1ee GS |
11927 | =item PARSING OPTIONS |
11928 | ||
b38f6a39 GS |
11929 | B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset), |
11930 | B<-warnings> (default: unset) | |
c76ac1ee | 11931 | |
a45bd81d GS |
11932 | =back |
11933 | ||
d420ca49 | 11934 | =over 4 |
a45bd81d | 11935 | |
14218588 GS |
11936 | =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES |
11937 | ||
a45bd81d GS |
11938 | =back |
11939 | ||
d420ca49 | 11940 | =over 4 |
a45bd81d | 11941 | |
14218588 GS |
11942 | =item B<command()> |
11943 | ||
11944 | C<$cmd>, C<$text>, C<$line_num>, C<$pod_para> | |
11945 | ||
a45bd81d GS |
11946 | =back |
11947 | ||
d420ca49 | 11948 | =over 4 |
a45bd81d | 11949 | |
14218588 GS |
11950 | =item B<verbatim()> |
11951 | ||
11952 | C<$text>, C<$line_num>, C<$pod_para> | |
11953 | ||
a45bd81d GS |
11954 | =back |
11955 | ||
d420ca49 | 11956 | =over 4 |
a45bd81d | 11957 | |
14218588 GS |
11958 | =item B<textblock()> |
11959 | ||
11960 | C<$text>, C<$line_num>, C<$pod_para> | |
11961 | ||
a45bd81d GS |
11962 | =back |
11963 | ||
d420ca49 | 11964 | =over 4 |
a45bd81d | 11965 | |
14218588 GS |
11966 | =item B<interior_sequence()> |
11967 | ||
a45bd81d GS |
11968 | =back |
11969 | ||
d420ca49 | 11970 | =over 4 |
a45bd81d | 11971 | |
14218588 GS |
11972 | =item OPTIONAL SUBROUTINE/METHOD OVERRIDES |
11973 | ||
a45bd81d GS |
11974 | =back |
11975 | ||
d420ca49 | 11976 | =over 4 |
a45bd81d | 11977 | |
14218588 GS |
11978 | =item B<new()> |
11979 | ||
a45bd81d GS |
11980 | =back |
11981 | ||
d420ca49 | 11982 | =over 4 |
a45bd81d | 11983 | |
14218588 GS |
11984 | =item B<initialize()> |
11985 | ||
a45bd81d GS |
11986 | =back |
11987 | ||
d420ca49 | 11988 | =over 4 |
a45bd81d | 11989 | |
14218588 GS |
11990 | =item B<begin_pod()> |
11991 | ||
a45bd81d GS |
11992 | =back |
11993 | ||
d420ca49 | 11994 | =over 4 |
a45bd81d | 11995 | |
14218588 GS |
11996 | =item B<begin_input()> |
11997 | ||
a45bd81d GS |
11998 | =back |
11999 | ||
d420ca49 | 12000 | =over 4 |
a45bd81d | 12001 | |
14218588 GS |
12002 | =item B<end_input()> |
12003 | ||
a45bd81d GS |
12004 | =back |
12005 | ||
d420ca49 | 12006 | =over 4 |
a45bd81d | 12007 | |
14218588 GS |
12008 | =item B<end_pod()> |
12009 | ||
a45bd81d GS |
12010 | =back |
12011 | ||
d420ca49 | 12012 | =over 4 |
a45bd81d | 12013 | |
14218588 GS |
12014 | =item B<preprocess_line()> |
12015 | ||
a45bd81d GS |
12016 | =back |
12017 | ||
d420ca49 | 12018 | =over 4 |
a45bd81d | 12019 | |
14218588 GS |
12020 | =item B<preprocess_paragraph()> |
12021 | ||
a45bd81d GS |
12022 | =back |
12023 | ||
d420ca49 | 12024 | =over 4 |
a45bd81d | 12025 | |
14218588 GS |
12026 | =item METHODS FOR PARSING AND PROCESSING |
12027 | ||
a45bd81d GS |
12028 | =back |
12029 | ||
d420ca49 | 12030 | =over 4 |
a45bd81d | 12031 | |
14218588 GS |
12032 | =item B<parse_text()> |
12033 | ||
c76ac1ee GS |
12034 | B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt> |
12035 | I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt> | |
14218588 GS |
12036 | I<code-ref>|I<method-name> |
12037 | ||
a45bd81d GS |
12038 | =back |
12039 | ||
d420ca49 | 12040 | =over 4 |
a45bd81d | 12041 | |
14218588 GS |
12042 | =item B<interpolate()> |
12043 | ||
a45bd81d GS |
12044 | =back |
12045 | ||
d420ca49 | 12046 | =over 4 |
a45bd81d | 12047 | |
14218588 GS |
12048 | =item B<parse_paragraph()> |
12049 | ||
a45bd81d GS |
12050 | =back |
12051 | ||
d420ca49 | 12052 | =over 4 |
a45bd81d | 12053 | |
14218588 GS |
12054 | =item B<parse_from_filehandle()> |
12055 | ||
a45bd81d GS |
12056 | =back |
12057 | ||
d420ca49 | 12058 | =over 4 |
a45bd81d | 12059 | |
14218588 GS |
12060 | =item B<parse_from_file()> |
12061 | ||
a45bd81d GS |
12062 | =back |
12063 | ||
d420ca49 | 12064 | =over 4 |
a45bd81d | 12065 | |
14218588 GS |
12066 | =item ACCESSOR METHODS |
12067 | ||
a45bd81d GS |
12068 | =back |
12069 | ||
d420ca49 | 12070 | =over 4 |
a45bd81d | 12071 | |
c76ac1ee GS |
12072 | =item B<errorsub()> |
12073 | ||
a45bd81d GS |
12074 | =back |
12075 | ||
d420ca49 | 12076 | =over 4 |
a45bd81d | 12077 | |
14218588 GS |
12078 | =item B<cutting()> |
12079 | ||
a45bd81d GS |
12080 | =back |
12081 | ||
d420ca49 | 12082 | =over 4 |
a45bd81d | 12083 | |
c76ac1ee GS |
12084 | =item B<parseopts()> |
12085 | ||
a45bd81d GS |
12086 | =back |
12087 | ||
d420ca49 | 12088 | =over 4 |
a45bd81d | 12089 | |
14218588 GS |
12090 | =item B<output_file()> |
12091 | ||
a45bd81d GS |
12092 | =back |
12093 | ||
d420ca49 | 12094 | =over 4 |
a45bd81d | 12095 | |
14218588 GS |
12096 | =item B<output_handle()> |
12097 | ||
a45bd81d GS |
12098 | =back |
12099 | ||
d420ca49 | 12100 | =over 4 |
a45bd81d | 12101 | |
14218588 GS |
12102 | =item B<input_file()> |
12103 | ||
a45bd81d GS |
12104 | =back |
12105 | ||
d420ca49 | 12106 | =over 4 |
a45bd81d | 12107 | |
14218588 GS |
12108 | =item B<input_handle()> |
12109 | ||
a45bd81d GS |
12110 | =back |
12111 | ||
d420ca49 | 12112 | =over 4 |
a45bd81d | 12113 | |
14218588 GS |
12114 | =item B<input_streams()> |
12115 | ||
a45bd81d GS |
12116 | =back |
12117 | ||
d420ca49 | 12118 | =over 4 |
a45bd81d GS |
12119 | |
12120 | =item B<top_stream()> | |
12121 | ||
12122 | =back | |
12123 | ||
d420ca49 | 12124 | =over 4 |
14218588 GS |
12125 | |
12126 | =item PRIVATE METHODS AND DATA | |
12127 | ||
a45bd81d GS |
12128 | =back |
12129 | ||
d420ca49 | 12130 | =over 4 |
a45bd81d | 12131 | |
14218588 GS |
12132 | =item B<_push_input_stream()> |
12133 | ||
a45bd81d GS |
12134 | =back |
12135 | ||
d420ca49 | 12136 | =over 4 |
a45bd81d | 12137 | |
14218588 GS |
12138 | =item B<_pop_input_stream()> |
12139 | ||
a45bd81d GS |
12140 | =back |
12141 | ||
d420ca49 | 12142 | =over 4 |
a45bd81d | 12143 | |
c76ac1ee | 12144 | =item TREE-BASED PARSING |
14218588 GS |
12145 | |
12146 | =item SEE ALSO | |
12147 | ||
12148 | =item AUTHOR | |
12149 | ||
a45bd81d GS |
12150 | =back |
12151 | ||
b38f6a39 GS |
12152 | =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. |
12153 | ||
d420ca49 | 12154 | =over 4 |
b38f6a39 GS |
12155 | |
12156 | =item SYNOPSIS | |
12157 | ||
12158 | =item DESCRIPTION | |
12159 | ||
d420ca49 | 12160 | =over 4 |
b38f6a39 GS |
12161 | |
12162 | =item EXPORT | |
12163 | ||
12164 | =back | |
12165 | ||
12166 | =item AUTHOR | |
12167 | ||
12168 | =item SEE ALSO | |
12169 | ||
12170 | =back | |
12171 | ||
14218588 GS |
12172 | =head2 Pod::Select, podselect() - extract selected sections of POD from |
12173 | input | |
12174 | ||
d420ca49 | 12175 | =over 4 |
a45bd81d | 12176 | |
14218588 GS |
12177 | =item SYNOPSIS |
12178 | ||
12179 | =item REQUIRES | |
12180 | ||
12181 | =item EXPORTS | |
12182 | ||
12183 | =item DESCRIPTION | |
12184 | ||
12185 | =item SECTION SPECIFICATIONS | |
12186 | ||
12187 | =item RANGE SPECIFICATIONS | |
12188 | ||
a45bd81d GS |
12189 | =back |
12190 | ||
d420ca49 | 12191 | =over 4 |
a45bd81d | 12192 | |
14218588 GS |
12193 | =item OBJECT METHODS |
12194 | ||
a45bd81d GS |
12195 | =back |
12196 | ||
d420ca49 | 12197 | =over 4 |
a45bd81d | 12198 | |
14218588 GS |
12199 | =item B<curr_headings()> |
12200 | ||
a45bd81d GS |
12201 | =back |
12202 | ||
d420ca49 | 12203 | =over 4 |
a45bd81d | 12204 | |
14218588 GS |
12205 | =item B<select()> |
12206 | ||
a45bd81d GS |
12207 | =back |
12208 | ||
d420ca49 | 12209 | =over 4 |
a45bd81d | 12210 | |
14218588 GS |
12211 | =item B<add_selection()> |
12212 | ||
a45bd81d GS |
12213 | =back |
12214 | ||
d420ca49 | 12215 | =over 4 |
a45bd81d | 12216 | |
14218588 GS |
12217 | =item B<clear_selections()> |
12218 | ||
a45bd81d GS |
12219 | =back |
12220 | ||
d420ca49 | 12221 | =over 4 |
a45bd81d | 12222 | |
14218588 GS |
12223 | =item B<match_section()> |
12224 | ||
a45bd81d GS |
12225 | =back |
12226 | ||
d420ca49 | 12227 | =over 4 |
a45bd81d | 12228 | |
14218588 GS |
12229 | =item B<is_selected()> |
12230 | ||
a45bd81d GS |
12231 | =back |
12232 | ||
d420ca49 | 12233 | =over 4 |
a45bd81d | 12234 | |
14218588 GS |
12235 | =item EXPORTED FUNCTIONS |
12236 | ||
a45bd81d GS |
12237 | =back |
12238 | ||
d420ca49 | 12239 | =over 4 |
a45bd81d | 12240 | |
14218588 GS |
12241 | =item B<podselect()> |
12242 | ||
12243 | B<-output>, B<-sections>, B<-ranges> | |
12244 | ||
a45bd81d GS |
12245 | =back |
12246 | ||
d420ca49 | 12247 | =over 4 |
a45bd81d | 12248 | |
14218588 GS |
12249 | =item PRIVATE METHODS AND DATA |
12250 | ||
a45bd81d GS |
12251 | =back |
12252 | ||
d420ca49 | 12253 | =over 4 |
a45bd81d | 12254 | |
14218588 GS |
12255 | =item B<_compile_section_spec()> |
12256 | ||
a45bd81d GS |
12257 | =back |
12258 | ||
d420ca49 | 12259 | =over 4 |
14218588 GS |
12260 | |
12261 | =item $self->{_SECTION_HEADINGS} | |
12262 | ||
a45bd81d GS |
12263 | =back |
12264 | ||
d420ca49 | 12265 | =over 4 |
a45bd81d | 12266 | |
14218588 GS |
12267 | =item $self->{_SELECTED_SECTIONS} |
12268 | ||
12269 | =back | |
12270 | ||
d420ca49 | 12271 | =over 4 |
a45bd81d | 12272 | |
14218588 GS |
12273 | =item SEE ALSO |
12274 | ||
12275 | =item AUTHOR | |
12276 | ||
a45bd81d GS |
12277 | =back |
12278 | ||
c76ac1ee | 12279 | =head2 Pod::Text - Convert POD data to formatted ASCII text |
402d0d99 | 12280 | |
d420ca49 | 12281 | =over 4 |
a45bd81d | 12282 | |
402d0d99 | 12283 | =item SYNOPSIS |
12284 | ||
402d0d99 | 12285 | =item DESCRIPTION |
12286 | ||
91331b4f | 12287 | alt, indent, loose, quotes, sentence, width |
c76ac1ee GS |
12288 | |
12289 | =item DIAGNOSTICS | |
12290 | ||
91331b4f JH |
12291 | Bizarre space in item, Can't open %s for reading: %s, Invalid quote |
12292 | specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: | |
12293 | %s, Unknown sequence: %s, Unmatched =back | |
c76ac1ee GS |
12294 | |
12295 | =item RESTRICTIONS | |
12296 | ||
12297 | =item NOTES | |
12298 | ||
12299 | =item SEE ALSO | |
12300 | ||
402d0d99 | 12301 | =item AUTHOR |
12302 | ||
a45bd81d GS |
12303 | =back |
12304 | ||
c76ac1ee GS |
12305 | =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text |
12306 | ||
d420ca49 | 12307 | =over 4 |
a45bd81d | 12308 | |
c76ac1ee GS |
12309 | =item SYNOPSIS |
12310 | ||
12311 | =item DESCRIPTION | |
12312 | ||
12313 | =item BUGS | |
12314 | ||
12315 | =item SEE ALSO | |
12316 | ||
12317 | =item AUTHOR | |
12318 | ||
a45bd81d GS |
12319 | =back |
12320 | ||
c76ac1ee GS |
12321 | =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII |
12322 | text with format escapes | |
12323 | ||
d420ca49 | 12324 | =over 4 |
a45bd81d | 12325 | |
c76ac1ee GS |
12326 | =item SYNOPSIS |
12327 | ||
12328 | =item DESCRIPTION | |
12329 | ||
12330 | =item SEE ALSO | |
12331 | ||
12332 | =item AUTHOR | |
402d0d99 | 12333 | |
a45bd81d GS |
12334 | =back |
12335 | ||
14218588 GS |
12336 | =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod |
12337 | documentation | |
12338 | ||
d420ca49 | 12339 | =over 4 |
a45bd81d | 12340 | |
14218588 GS |
12341 | =item SYNOPSIS |
12342 | ||
12343 | =item ARGUMENTS | |
12344 | ||
12345 | C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>, | |
12346 | C<-pathlist> | |
12347 | ||
12348 | =item DESCRIPTION | |
12349 | ||
12350 | =item EXAMPLES | |
12351 | ||
d420ca49 | 12352 | =over 4 |
14218588 GS |
12353 | |
12354 | =item Recommended Use | |
12355 | ||
12356 | =back | |
12357 | ||
12358 | =item CAVEATS | |
12359 | ||
12360 | =item AUTHOR | |
12361 | ||
12362 | =item ACKNOWLEDGEMENTS | |
12363 | ||
a45bd81d GS |
12364 | =back |
12365 | ||
8ebc5c01 | 12366 | =head2 SDBM_File - Tied access to sdbm files |
402d0d99 | 12367 | |
d420ca49 | 12368 | =over 4 |
a45bd81d | 12369 | |
8ebc5c01 | 12370 | =item SYNOPSIS |
402d0d99 | 12371 | |
8ebc5c01 | 12372 | =item DESCRIPTION |
402d0d99 | 12373 | |
7029d033 JH |
12374 | C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR> |
12375 | ||
12376 | =item DIAGNOSTICS | |
12377 | ||
d420ca49 | 12378 | =over 4 |
7029d033 JH |
12379 | |
12380 | =item C<sdbm store returned -1, errno 22, key "..." at ...> | |
12381 | ||
12382 | =back | |
12383 | ||
12384 | =item BUGS AND WARNINGS | |
12385 | ||
a45bd81d GS |
12386 | =back |
12387 | ||
d46b76b3 JH |
12388 | =head2 Safe - Compile and execute code in restricted compartments |
12389 | ||
d420ca49 | 12390 | =over 4 |
d46b76b3 JH |
12391 | |
12392 | =item SYNOPSIS | |
12393 | ||
12394 | =item DESCRIPTION | |
12395 | ||
12396 | a new namespace, an operator mask | |
12397 | ||
12398 | =item WARNING | |
12399 | ||
d420ca49 | 12400 | =over 4 |
d46b76b3 JH |
12401 | |
12402 | =item RECENT CHANGES | |
12403 | ||
12404 | =item Methods in class Safe | |
12405 | ||
12406 | permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, | |
12407 | ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from | |
12408 | (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), | |
12409 | root (NAMESPACE), mask (MASK) | |
12410 | ||
12411 | =item Some Safety Issues | |
12412 | ||
12413 | Memory, CPU, Snooping, Signals, State Changes | |
12414 | ||
12415 | =item AUTHOR | |
12416 | ||
12417 | =back | |
12418 | ||
12419 | =back | |
12420 | ||
7d2bfb28 | 12421 | =head2 Search::Dict, look - search for key in dictionary file |
12422 | ||
d420ca49 | 12423 | =over 4 |
a45bd81d | 12424 | |
7d2bfb28 | 12425 | =item SYNOPSIS |
12426 | ||
7d2bfb28 | 12427 | =item DESCRIPTION |
12428 | ||
a45bd81d GS |
12429 | =back |
12430 | ||
7d2bfb28 | 12431 | =head2 SelectSaver - save and restore selected file handle |
12432 | ||
d420ca49 | 12433 | =over 4 |
a45bd81d | 12434 | |
7d2bfb28 | 12435 | =item SYNOPSIS |
12436 | ||
7d2bfb28 | 12437 | =item DESCRIPTION |
12438 | ||
a45bd81d GS |
12439 | =back |
12440 | ||
cb1a09d0 AD |
12441 | =head2 SelfLoader - load functions only on demand |
12442 | ||
d420ca49 | 12443 | =over 4 |
a45bd81d | 12444 | |
cb1a09d0 AD |
12445 | =item SYNOPSIS |
12446 | ||
cb1a09d0 AD |
12447 | =item DESCRIPTION |
12448 | ||
d420ca49 | 12449 | =over 4 |
cb1a09d0 AD |
12450 | |
12451 | =item The __DATA__ token | |
12452 | ||
cb1a09d0 AD |
12453 | =item SelfLoader autoloading |
12454 | ||
cb1a09d0 AD |
12455 | =item Autoloading and package lexicals |
12456 | ||
cb1a09d0 AD |
12457 | =item SelfLoader and AutoLoader |
12458 | ||
cb1a09d0 AD |
12459 | =item __DATA__, __END__, and the FOOBAR::DATA filehandle. |
12460 | ||
cb1a09d0 AD |
12461 | =item Classes and inherited methods. |
12462 | ||
cb1a09d0 AD |
12463 | =back |
12464 | ||
12465 | =item Multiple packages and fully qualified subroutine names | |
12466 | ||
a45bd81d GS |
12467 | =back |
12468 | ||
8ebc5c01 | 12469 | =head2 Shell - run shell commands transparently within perl |
cb1a09d0 | 12470 | |
d420ca49 | 12471 | =over 4 |
a45bd81d | 12472 | |
cb1a09d0 AD |
12473 | =item SYNOPSIS |
12474 | ||
cb1a09d0 AD |
12475 | =item DESCRIPTION |
12476 | ||
d420ca49 | 12477 | =over 4 |
d396a558 JH |
12478 | |
12479 | =item OBJECT ORIENTED SYNTAX | |
12480 | ||
12481 | =back | |
12482 | ||
8ebc5c01 | 12483 | =item AUTHOR |
cb1a09d0 | 12484 | |
a45bd81d GS |
12485 | =back |
12486 | ||
8ebc5c01 | 12487 | =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C |
12488 | socket.h defines and structure manipulators | |
cb1a09d0 | 12489 | |
d420ca49 | 12490 | =over 4 |
a45bd81d | 12491 | |
8ebc5c01 | 12492 | =item SYNOPSIS |
cb1a09d0 | 12493 | |
8ebc5c01 | 12494 | =item DESCRIPTION |
cb1a09d0 | 12495 | |
8ebc5c01 | 12496 | inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST, |
12497 | INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in | |
12498 | SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in | |
12499 | SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN, | |
12500 | pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN | |
cb1a09d0 | 12501 | |
a45bd81d GS |
12502 | =back |
12503 | ||
a9ef4385 JH |
12504 | =head2 Storable - persistency for perl data structures |
12505 | ||
d420ca49 | 12506 | =over 4 |
a9ef4385 JH |
12507 | |
12508 | =item SYNOPSIS | |
12509 | ||
12510 | =item DESCRIPTION | |
12511 | ||
12512 | =item MEMORY STORE | |
12513 | ||
91331b4f JH |
12514 | =item ADVISORY LOCKING |
12515 | ||
a9ef4385 JH |
12516 | =item SPEED |
12517 | ||
12518 | =item CANONICAL REPRESENTATION | |
12519 | ||
12520 | =item ERROR REPORTING | |
12521 | ||
12522 | =item WIZARDS ONLY | |
12523 | ||
d420ca49 | 12524 | =over 4 |
a9ef4385 JH |
12525 | |
12526 | =item Hooks | |
12527 | ||
12528 | C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>, | |
12529 | I<serialized>, .. | |
12530 | ||
12531 | =item Predicates | |
12532 | ||
12533 | C<Storable::last_op_in_netorder>, C<Storable::is_storing>, | |
12534 | C<Storable::is_retrieving> | |
12535 | ||
12536 | =item Recursion | |
12537 | ||
12538 | =item Deep Cloning | |
12539 | ||
12540 | =back | |
12541 | ||
12542 | =item EXAMPLES | |
12543 | ||
12544 | =item WARNING | |
12545 | ||
12546 | =item BUGS | |
12547 | ||
12548 | =item CREDITS | |
12549 | ||
12550 | =item TRANSLATIONS | |
12551 | ||
12552 | =item AUTHOR | |
12553 | ||
12554 | =item SEE ALSO | |
12555 | ||
12556 | =back | |
12557 | ||
7d2bfb28 | 12558 | =head2 Symbol - manipulate Perl symbols and their names |
12559 | ||
d420ca49 | 12560 | =over 4 |
a45bd81d | 12561 | |
7d2bfb28 | 12562 | =item SYNOPSIS |
12563 | ||
7d2bfb28 | 12564 | =item DESCRIPTION |
12565 | ||
a45bd81d GS |
12566 | =back |
12567 | ||
cb1a09d0 AD |
12568 | =head2 Sys::Hostname - Try every conceivable way to get hostname |
12569 | ||
d420ca49 | 12570 | =over 4 |
a45bd81d | 12571 | |
cb1a09d0 AD |
12572 | =item SYNOPSIS |
12573 | ||
cb1a09d0 AD |
12574 | =item DESCRIPTION |
12575 | ||
cb1a09d0 AD |
12576 | =item AUTHOR |
12577 | ||
a45bd81d GS |
12578 | =back |
12579 | ||
d46b76b3 JH |
12580 | =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl |
12581 | interface to the UNIX syslog(3) calls | |
12582 | ||
d420ca49 | 12583 | =over 4 |
d46b76b3 JH |
12584 | |
12585 | =item SYNOPSIS | |
12586 | ||
12587 | =item DESCRIPTION | |
12588 | ||
12589 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
12590 | setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), | |
12591 | closelog | |
12592 | ||
12593 | =item EXAMPLES | |
12594 | ||
12595 | =item SEE ALSO | |
12596 | ||
12597 | =item AUTHOR | |
12598 | ||
12599 | =back | |
12600 | ||
694468e3 GS |
12601 | =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - |
12602 | Perl interface to the UNIX syslog(3) calls | |
12603 | ||
d420ca49 | 12604 | =over 4 |
694468e3 GS |
12605 | |
12606 | =item SYNOPSIS | |
12607 | ||
12608 | =item DESCRIPTION | |
12609 | ||
12610 | openlog $ident, $logopt, $facility, syslog $priority, $format, @args, | |
12611 | setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02), | |
12612 | closelog | |
12613 | ||
12614 | =item EXAMPLES | |
7d2bfb28 | 12615 | |
7d2bfb28 | 12616 | =item SEE ALSO |
12617 | ||
7d2bfb28 | 12618 | =item AUTHOR |
12619 | ||
a45bd81d GS |
12620 | =back |
12621 | ||
b38f6a39 GS |
12622 | =head2 Term::ANSIColor - Color screen output using ANSI escape sequences |
12623 | ||
d420ca49 | 12624 | =over 4 |
b38f6a39 GS |
12625 | |
12626 | =item SYNOPSIS | |
12627 | ||
12628 | =item DESCRIPTION | |
12629 | ||
12630 | =item DIAGNOSTICS | |
12631 | ||
10862624 RF |
12632 | Invalid attribute name %s, Name "%s" used only once: possible typo, No |
12633 | comma allowed after filehandle, Bareword "%s" not allowed while "strict | |
12634 | subs" in use | |
b38f6a39 GS |
12635 | |
12636 | =item RESTRICTIONS | |
12637 | ||
10862624 RF |
12638 | =item NOTES |
12639 | ||
b38f6a39 GS |
12640 | =item AUTHORS |
12641 | ||
12642 | =back | |
12643 | ||
cb1a09d0 AD |
12644 | =head2 Term::Cap - Perl termcap interface |
12645 | ||
d420ca49 | 12646 | =over 4 |
a45bd81d | 12647 | |
cb1a09d0 AD |
12648 | =item SYNOPSIS |
12649 | ||
cb1a09d0 AD |
12650 | =item DESCRIPTION |
12651 | ||
cb1a09d0 AD |
12652 | =item EXAMPLES |
12653 | ||
a45bd81d GS |
12654 | =back |
12655 | ||
cb1a09d0 AD |
12656 | =head2 Term::Complete - Perl word completion module |
12657 | ||
d420ca49 | 12658 | =over 4 |
a45bd81d | 12659 | |
cb1a09d0 AD |
12660 | =item SYNOPSIS |
12661 | ||
cb1a09d0 AD |
12662 | =item DESCRIPTION |
12663 | ||
3fe9a6f1 | 12664 | E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt> |
cb1a09d0 AD |
12665 | |
12666 | =item DIAGNOSTICS | |
12667 | ||
cb1a09d0 AD |
12668 | =item BUGS |
12669 | ||
cb1a09d0 AD |
12670 | =item AUTHOR |
12671 | ||
a45bd81d GS |
12672 | =back |
12673 | ||
8ebc5c01 | 12674 | =head2 Term::ReadLine - Perl interface to various C<readline> packages. If |
12675 | no real package is found, substitutes stubs instead of basic functions. | |
7d2bfb28 | 12676 | |
d420ca49 | 12677 | =over 4 |
a45bd81d | 12678 | |
7d2bfb28 | 12679 | =item SYNOPSIS |
12680 | ||
7d2bfb28 | 12681 | =item DESCRIPTION |
12682 | ||
7d2bfb28 | 12683 | =item Minimal set of supported functions |
12684 | ||
7d2bfb28 | 12685 | C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>, |
9607fc9c | 12686 | C<MinLine>, C<findConsole>, Attribs, C<Features> |
12687 | ||
12688 | =item Additional supported functions | |
7d2bfb28 | 12689 | |
d516a115 JH |
12690 | C<tkRunning>, C<ornaments>, C<newTTY> |
12691 | ||
7d2bfb28 | 12692 | =item EXPORTS |
12693 | ||
9607fc9c | 12694 | =item ENVIRONMENT |
12695 | ||
a45bd81d GS |
12696 | =back |
12697 | ||
14218588 | 12698 | =head2 Test - provides a simple framework for writing test scripts |
193fb0af | 12699 | |
d420ca49 | 12700 | =over 4 |
a45bd81d | 12701 | |
193fb0af GS |
12702 | =item SYNOPSIS |
12703 | ||
12704 | =item DESCRIPTION | |
12705 | ||
12706 | =item TEST TYPES | |
12707 | ||
12708 | NORMAL TESTS, SKIPPED TESTS, TODO TESTS | |
12709 | ||
14218588 GS |
12710 | =item RETURN VALUE |
12711 | ||
193fb0af GS |
12712 | =item ONFAIL |
12713 | ||
12714 | =item SEE ALSO | |
12715 | ||
12716 | =item AUTHOR | |
12717 | ||
a45bd81d GS |
12718 | =back |
12719 | ||
cb1a09d0 AD |
12720 | =head2 Test::Harness - run perl standard test scripts with statistics |
12721 | ||
d420ca49 | 12722 | =over 4 |
a45bd81d | 12723 | |
cb1a09d0 AD |
12724 | =item SYNOPSIS |
12725 | ||
cb1a09d0 AD |
12726 | =item DESCRIPTION |
12727 | ||
d420ca49 | 12728 | =over 4 |
7d2bfb28 | 12729 | |
12730 | =item The test script output | |
12731 | ||
7d2bfb28 | 12732 | =back |
12733 | ||
cb1a09d0 AD |
12734 | =item EXPORT |
12735 | ||
cb1a09d0 AD |
12736 | =item DIAGNOSTICS |
12737 | ||
7d2bfb28 | 12738 | C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests |
8ebc5c01 | 12739 | %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat |
12740 | %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay. | |
12741 | %s> | |
cb1a09d0 | 12742 | |
fb9cefb4 GS |
12743 | =item ENVIRONMENT |
12744 | ||
cb1a09d0 AD |
12745 | =item SEE ALSO |
12746 | ||
7d2bfb28 | 12747 | =item AUTHORS |
12748 | ||
cb1a09d0 AD |
12749 | =item BUGS |
12750 | ||
a45bd81d GS |
12751 | =back |
12752 | ||
cb1a09d0 AD |
12753 | =head2 Text::Abbrev, abbrev - create an abbreviation table from a list |
12754 | ||
d420ca49 | 12755 | =over 4 |
a45bd81d | 12756 | |
cb1a09d0 AD |
12757 | =item SYNOPSIS |
12758 | ||
cb1a09d0 AD |
12759 | =item DESCRIPTION |
12760 | ||
cb1a09d0 AD |
12761 | =item EXAMPLE |
12762 | ||
a45bd81d GS |
12763 | =back |
12764 | ||
193fb0af GS |
12765 | =head2 Text::ParseWords - parse text into an array of tokens or array of |
12766 | arrays | |
cb1a09d0 | 12767 | |
d420ca49 | 12768 | =over 4 |
a45bd81d | 12769 | |
8ebc5c01 | 12770 | =item SYNOPSIS |
cb1a09d0 | 12771 | |
8ebc5c01 | 12772 | =item DESCRIPTION |
cb1a09d0 | 12773 | |
193fb0af GS |
12774 | =item EXAMPLES |
12775 | ||
0e032a14 JH |
12776 | 0 a simple word, 1 multiple spaces are skipped because of our $delim, 2 use |
12777 | of quotes to include a space in a word, 3 use of a backslash to include a | |
12778 | space in a word, 4 use of a backslash to remove the special meaning of a | |
12779 | double-quote, 5 another simple word (note the lack of effect of the | |
193fb0af GS |
12780 | backslashed double-quote) |
12781 | ||
8ebc5c01 | 12782 | =item AUTHORS |
cb1a09d0 | 12783 | |
a45bd81d GS |
12784 | =back |
12785 | ||
8ebc5c01 | 12786 | =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described |
12787 | by Knuth | |
cb1a09d0 | 12788 | |
d420ca49 | 12789 | =over 4 |
a45bd81d | 12790 | |
cb1a09d0 AD |
12791 | =item SYNOPSIS |
12792 | ||
cb1a09d0 AD |
12793 | =item DESCRIPTION |
12794 | ||
cb1a09d0 AD |
12795 | =item EXAMPLES |
12796 | ||
cb1a09d0 AD |
12797 | =item LIMITATIONS |
12798 | ||
cb1a09d0 AD |
12799 | =item AUTHOR |
12800 | ||
a45bd81d GS |
12801 | =back |
12802 | ||
8ebc5c01 | 12803 | =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and |
12804 | unexpand(1) | |
cb1a09d0 | 12805 | |
d420ca49 | 12806 | =over 4 |
a45bd81d | 12807 | |
8ebc5c01 | 12808 | =item SYNOPSIS |
cb1a09d0 | 12809 | |
8ebc5c01 | 12810 | =item DESCRIPTION |
cb1a09d0 | 12811 | |
8ebc5c01 | 12812 | =item BUGS |
cb1a09d0 | 12813 | |
8ebc5c01 | 12814 | =item AUTHOR |
cb1a09d0 | 12815 | |
a45bd81d GS |
12816 | =back |
12817 | ||
8ebc5c01 | 12818 | =head2 Text::Wrap - line wrapping to form simple paragraphs |
cb1a09d0 | 12819 | |
d420ca49 | 12820 | =over 4 |
a45bd81d | 12821 | |
8ebc5c01 | 12822 | =item SYNOPSIS |
cb1a09d0 AD |
12823 | |
12824 | =item DESCRIPTION | |
12825 | ||
8ebc5c01 | 12826 | =item EXAMPLE |
cb1a09d0 AD |
12827 | |
12828 | =item AUTHOR | |
12829 | ||
a45bd81d GS |
12830 | =back |
12831 | ||
694468e3 GS |
12832 | =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to |
12833 | change) | |
d516a115 | 12834 | |
d420ca49 | 12835 | =over 4 |
a45bd81d | 12836 | |
d516a115 JH |
12837 | =item SYNOPSIS |
12838 | ||
12839 | =item DESCRIPTION | |
12840 | ||
193fb0af GS |
12841 | =item FUNCTIONS |
12842 | ||
12843 | new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;, | |
12844 | Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE, | |
14218588 | 12845 | cond_broadcast VARIABLE, yield |
193fb0af GS |
12846 | |
12847 | =item METHODS | |
12848 | ||
d420ca49 | 12849 | join, eval, detach, equal, tid, flags, done |
193fb0af GS |
12850 | |
12851 | =item LIMITATIONS | |
12852 | ||
d516a115 JH |
12853 | =item SEE ALSO |
12854 | ||
a45bd81d GS |
12855 | =back |
12856 | ||
d516a115 JH |
12857 | =head2 Thread::Queue - thread-safe queues |
12858 | ||
d420ca49 | 12859 | =over 4 |
a45bd81d | 12860 | |
d516a115 JH |
12861 | =item SYNOPSIS |
12862 | ||
193fb0af GS |
12863 | =item DESCRIPTION |
12864 | ||
12865 | =item FUNCTIONS AND METHODS | |
12866 | ||
12867 | new, enqueue LIST, dequeue, dequeue_nb, pending | |
12868 | ||
12869 | =item SEE ALSO | |
12870 | ||
a45bd81d GS |
12871 | =back |
12872 | ||
d516a115 JH |
12873 | =head2 Thread::Semaphore - thread-safe semaphores |
12874 | ||
d420ca49 | 12875 | =over 4 |
a45bd81d | 12876 | |
d516a115 JH |
12877 | =item SYNOPSIS |
12878 | ||
193fb0af GS |
12879 | =item DESCRIPTION |
12880 | ||
12881 | =item FUNCTIONS AND METHODS | |
12882 | ||
12883 | new, new NUMBER, down, down NUMBER, up, up NUMBER | |
12884 | ||
a45bd81d GS |
12885 | =back |
12886 | ||
193fb0af GS |
12887 | =head2 Thread::Signal - Start a thread which runs signal handlers reliably |
12888 | ||
d420ca49 | 12889 | =over 4 |
a45bd81d | 12890 | |
193fb0af GS |
12891 | =item SYNOPSIS |
12892 | ||
12893 | =item DESCRIPTION | |
12894 | ||
12895 | =item BUGS | |
12896 | ||
a45bd81d GS |
12897 | =back |
12898 | ||
d516a115 JH |
12899 | =head2 Thread::Specific - thread-specific keys |
12900 | ||
d420ca49 | 12901 | =over 4 |
a45bd81d | 12902 | |
d516a115 JH |
12903 | =item SYNOPSIS |
12904 | ||
14218588 GS |
12905 | =item DESCRIPTION |
12906 | ||
a45bd81d GS |
12907 | =back |
12908 | ||
d516a115 JH |
12909 | =head2 Tie::Array - base class for tied arrays |
12910 | ||
d420ca49 | 12911 | =over 4 |
a45bd81d | 12912 | |
37d4d706 | 12913 | =item SYNOPSIS |
d516a115 | 12914 | |
37d4d706 | 12915 | =item DESCRIPTION |
d516a115 JH |
12916 | |
12917 | TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index, | |
a45bd81d GS |
12918 | FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this, |
12919 | key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this, | |
12920 | SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST | |
d516a115 JH |
12921 | |
12922 | =item CAVEATS | |
12923 | ||
37d4d706 | 12924 | =item AUTHOR |
d516a115 | 12925 | |
a45bd81d GS |
12926 | =back |
12927 | ||
14218588 GS |
12928 | =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied |
12929 | handles | |
193fb0af | 12930 | |
d420ca49 | 12931 | =over 4 |
a45bd81d | 12932 | |
193fb0af GS |
12933 | =item SYNOPSIS |
12934 | ||
12935 | =item DESCRIPTION | |
12936 | ||
12937 | TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this, | |
12938 | LIST, PRINTF this, format, LIST, READ this, scalar, length, offset, | |
14218588 GS |
12939 | READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this, |
12940 | EOF this, TELL this, SEEK this, offset, whence, DESTROY this | |
193fb0af GS |
12941 | |
12942 | =item MORE INFORMATION | |
12943 | ||
37d4d706 JH |
12944 | =item COMPATIBILITY |
12945 | ||
a45bd81d GS |
12946 | =back |
12947 | ||
8ebc5c01 | 12948 | =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes |
12949 | ||
d420ca49 | 12950 | =over 4 |
a45bd81d | 12951 | |
8ebc5c01 | 12952 | =item SYNOPSIS |
12953 | ||
12954 | =item DESCRIPTION | |
cb1a09d0 | 12955 | |
8ebc5c01 | 12956 | TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY |
12957 | this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this | |
cb1a09d0 | 12958 | |
8ebc5c01 | 12959 | =item CAVEATS |
cb1a09d0 | 12960 | |
8ebc5c01 | 12961 | =item MORE INFORMATION |
cb1a09d0 | 12962 | |
a45bd81d GS |
12963 | =back |
12964 | ||
8ebc5c01 | 12965 | =head2 Tie::RefHash - use references as hash keys |
cb1a09d0 | 12966 | |
d420ca49 | 12967 | =over 4 |
a45bd81d | 12968 | |
cb1a09d0 AD |
12969 | =item SYNOPSIS |
12970 | ||
cb1a09d0 AD |
12971 | =item DESCRIPTION |
12972 | ||
8ebc5c01 | 12973 | =item EXAMPLE |
cb1a09d0 AD |
12974 | |
12975 | =item AUTHOR | |
12976 | ||
8ebc5c01 | 12977 | =item VERSION |
cb1a09d0 | 12978 | |
8ebc5c01 | 12979 | =item SEE ALSO |
cb1a09d0 | 12980 | |
a45bd81d GS |
12981 | =back |
12982 | ||
8ebc5c01 | 12983 | =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied |
12984 | scalars | |
cb1a09d0 | 12985 | |
d420ca49 | 12986 | =over 4 |
a45bd81d | 12987 | |
cb1a09d0 AD |
12988 | =item SYNOPSIS |
12989 | ||
cb1a09d0 AD |
12990 | =item DESCRIPTION |
12991 | ||
8ebc5c01 | 12992 | TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this |
cb1a09d0 | 12993 | |
8ebc5c01 | 12994 | =item MORE INFORMATION |
cb1a09d0 | 12995 | |
a45bd81d GS |
12996 | =back |
12997 | ||
8ebc5c01 | 12998 | =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing |
cb1a09d0 | 12999 | |
d420ca49 | 13000 | =over 4 |
a45bd81d | 13001 | |
8ebc5c01 | 13002 | =item SYNOPSIS |
cb1a09d0 | 13003 | |
8ebc5c01 | 13004 | =item DESCRIPTION |
cb1a09d0 | 13005 | |
8ebc5c01 | 13006 | =item CAVEATS |
cb1a09d0 | 13007 | |
a45bd81d GS |
13008 | =back |
13009 | ||
8ebc5c01 | 13010 | =head2 Time::Local - efficiently compute time from local and GMT time |
cb1a09d0 | 13011 | |
d420ca49 | 13012 | =over 4 |
a45bd81d | 13013 | |
8ebc5c01 | 13014 | =item SYNOPSIS |
cb1a09d0 | 13015 | |
8ebc5c01 | 13016 | =item DESCRIPTION |
cb1a09d0 | 13017 | |
14218588 GS |
13018 | =item IMPLEMENTATION |
13019 | ||
13020 | =item BUGS | |
13021 | ||
a45bd81d GS |
13022 | =back |
13023 | ||
8ebc5c01 | 13024 | =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() |
13025 | function | |
7d2bfb28 | 13026 | |
d420ca49 | 13027 | =over 4 |
a45bd81d | 13028 | |
7d2bfb28 | 13029 | =item SYNOPSIS |
13030 | ||
7d2bfb28 | 13031 | =item DESCRIPTION |
13032 | ||
8ebc5c01 | 13033 | =item NOTE |
7d2bfb28 | 13034 | |
8ebc5c01 | 13035 | =item AUTHOR |
7d2bfb28 | 13036 | |
a45bd81d GS |
13037 | =back |
13038 | ||
8ebc5c01 | 13039 | =head2 Time::localtime - by-name interface to Perl's built-in localtime() |
13040 | function | |
7d2bfb28 | 13041 | |
d420ca49 | 13042 | =over 4 |
a45bd81d | 13043 | |
8ebc5c01 | 13044 | =item SYNOPSIS |
7d2bfb28 | 13045 | |
8ebc5c01 | 13046 | =item DESCRIPTION |
7d2bfb28 | 13047 | |
8ebc5c01 | 13048 | =item NOTE |
7d2bfb28 | 13049 | |
8ebc5c01 | 13050 | =item AUTHOR |
7d2bfb28 | 13051 | |
a45bd81d GS |
13052 | =back |
13053 | ||
8ebc5c01 | 13054 | =head2 Time::tm - internal object used by Time::gmtime and Time::localtime |
7d2bfb28 | 13055 | |
d420ca49 | 13056 | =over 4 |
a45bd81d | 13057 | |
7d2bfb28 | 13058 | =item SYNOPSIS |
13059 | ||
8ebc5c01 | 13060 | =item DESCRIPTION |
13061 | ||
13062 | =item AUTHOR | |
13063 | ||
a45bd81d GS |
13064 | =back |
13065 | ||
8ebc5c01 | 13066 | =head2 UNIVERSAL - base class for ALL classes (blessed references) |
13067 | ||
d420ca49 | 13068 | =over 4 |
a45bd81d | 13069 | |
8ebc5c01 | 13070 | =item SYNOPSIS |
7d2bfb28 | 13071 | |
13072 | =item DESCRIPTION | |
13073 | ||
d516a115 JH |
13074 | isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa ( |
13075 | VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) | |
7d2bfb28 | 13076 | |
a45bd81d GS |
13077 | =back |
13078 | ||
8ebc5c01 | 13079 | =head2 User::grent - by-name interface to Perl's built-in getgr*() |
13080 | functions | |
7d2bfb28 | 13081 | |
d420ca49 | 13082 | =over 4 |
a45bd81d | 13083 | |
8ebc5c01 | 13084 | =item SYNOPSIS |
7d2bfb28 | 13085 | |
8ebc5c01 | 13086 | =item DESCRIPTION |
7d2bfb28 | 13087 | |
8ebc5c01 | 13088 | =item NOTE |
7d2bfb28 | 13089 | |
8ebc5c01 | 13090 | =item AUTHOR |
7d2bfb28 | 13091 | |
a45bd81d GS |
13092 | =back |
13093 | ||
8ebc5c01 | 13094 | =head2 User::pwent - by-name interface to Perl's built-in getpw*() |
13095 | functions | |
cb1a09d0 | 13096 | |
d420ca49 | 13097 | =over 4 |
a45bd81d | 13098 | |
cb1a09d0 AD |
13099 | =item SYNOPSIS |
13100 | ||
cb1a09d0 AD |
13101 | =item DESCRIPTION |
13102 | ||
d420ca49 | 13103 | =over 4 |
b38f6a39 | 13104 | |
37590e52 | 13105 | =item System Specifics |
b38f6a39 GS |
13106 | |
13107 | =back | |
13108 | ||
37590e52 | 13109 | =item NOTE |
b38f6a39 GS |
13110 | |
13111 | =item AUTHOR | |
13112 | ||
37590e52 | 13113 | =item HISTORY |
b38f6a39 | 13114 | |
37590e52 | 13115 | March 18th, 2000 |
b38f6a39 GS |
13116 | |
13117 | =back | |
13118 | ||
4755096e GS |
13119 | =head2 Win32 - Interfaces to some Win32 API Functions |
13120 | ||
d420ca49 | 13121 | =over 4 |
4755096e GS |
13122 | |
13123 | =item DESCRIPTION | |
13124 | ||
d420ca49 | 13125 | =over 4 |
4755096e GS |
13126 | |
13127 | =item Alphabetical Listing of Win32 Functions | |
13128 | ||
13129 | Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), | |
13130 | Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), | |
13131 | Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), | |
13132 | Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), | |
13133 | Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), | |
13134 | Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), | |
13135 | Win32::GetNextAvailDrive(), Win32::GetOSVersion(), | |
13136 | Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, | |
13137 | PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown(MACHINE, | |
13138 | MESSAGE, TIMEOUT, FORCECLOSE, REBOOT), Win32::IsWinNT(), Win32::IsWin95(), | |
13139 | Win32::LoadLibrary(LIBNAME), Win32::LoginName(), | |
13140 | Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE), | |
13141 | Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE), | |
13142 | Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(), | |
13143 | Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY), | |
13144 | Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, | |
13145 | PID), Win32::UnregisterServer(LIBRARYNAME) | |
13146 | ||
13147 | =back | |
13148 | ||
13149 | =back | |
13150 | ||
a45bd81d GS |
13151 | =head2 XSLoader - Dynamically load C libraries into Perl code |
13152 | ||
d420ca49 | 13153 | =over 4 |
a45bd81d GS |
13154 | |
13155 | =item SYNOPSIS | |
13156 | ||
13157 | =item DESCRIPTION | |
13158 | ||
13159 | =item AUTHOR | |
13160 | ||
13161 | =back | |
13162 | ||
cb1a09d0 AD |
13163 | =head1 AUXILIARY DOCUMENTATION |
13164 | ||
8ebc5c01 | 13165 | Here should be listed all the extra programs' documentation, but they |
13166 | don't all have manual pages yet: | |
cb1a09d0 | 13167 | |
d420ca49 | 13168 | =over 4 |
a45bd81d | 13169 | |
cb1a09d0 AD |
13170 | =item a2p |
13171 | ||
13172 | =item s2p | |
13173 | ||
13174 | =item find2perl | |
13175 | ||
13176 | =item h2ph | |
13177 | ||
13178 | =item c2ph | |
13179 | ||
13180 | =item h2xs | |
13181 | ||
13182 | =item xsubpp | |
13183 | ||
13184 | =item pod2man | |
13185 | ||
13186 | =item wrapsuid | |
13187 | ||
a45bd81d GS |
13188 | =back |
13189 | ||
cb1a09d0 AD |
13190 | =head1 AUTHOR |
13191 | ||
2ae324a7 | 13192 | Larry Wall <F<larry@wall.org>>, with the help of oodles |
8ebc5c01 | 13193 | of other folks. |
cb1a09d0 | 13194 |