Commit | Line | Data |
68dc0745 |
1 | =head1 NAME |
2 | |
90bb42f6 |
3 | perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $, $Date: 1999/10/14 18:46:09 $) |
68dc0745 |
4 | |
5 | =head1 DESCRIPTION |
6 | |
7 | This section of the FAQ answers questions about where to find |
92c2ed05 |
8 | source and documentation for Perl, support, and |
68dc0745 |
9 | related matters. |
10 | |
11 | =head2 What machines support Perl? Where do I get it? |
12 | |
13 | The standard release of Perl (the one maintained by the perl |
5e3006a4 |
14 | development team) is distributed only in source code form. You |
65acb1b1 |
15 | can find this at http://www.perl.com/CPAN/src/latest.tar.gz , which |
5e3006a4 |
16 | in standard Internet format (a gzipped archive in POSIX tar format). |
17 | |
18 | Perl builds and runs on a bewildering number of platforms. Virtually |
19 | all known and current Unix derivatives are supported (Perl's native |
87275199 |
20 | platform), as are other systems like VMS, DOS, OS/2, Windows, |
5e3006a4 |
21 | QNX, BeOS, and the Amiga. There are also the beginnings of support |
22 | for MPE/iX. |
23 | |
24 | Binary distributions for some proprietary platforms, including |
65acb1b1 |
25 | Apple systems, can be found http://www.perl.com/CPAN/ports/ directory. |
5e3006a4 |
26 | Because these are not part of the standard distribution, they may |
27 | and in fact do differ from the base Perl port in a variety of ways. |
28 | You'll have to check their respective release notes to see just |
29 | what the differences are. These differences can be either positive |
30 | (e.g. extensions for the features of the particular platform that |
31 | are not supported in the source release of perl) or negative (e.g. |
32 | might be based upon a less current source release of perl). |
92c2ed05 |
33 | |
68dc0745 |
34 | =head2 How can I get a binary version of Perl? |
35 | |
65acb1b1 |
36 | If you don't have a C compiler because your vendor for whatever |
37 | reasons did not include one with your system, the best thing to do is |
68dc0745 |
38 | grab a binary version of gcc from the net and use that to compile perl |
39 | with. CPAN only has binaries for systems that are terribly hard to |
40 | get free compilers for, not for Unix systems. |
41 | |
65acb1b1 |
42 | Some URLs that might help you are: |
43 | |
44 | http://language.perl.com/info/software.html |
6cecdcac |
45 | http://www.perl.com/pub/language/info/software.html#binary |
65acb1b1 |
46 | http://www.perl.com/CPAN/ports/ |
47 | |
87275199 |
48 | Someone looking for a Perl for Win16 might look to Laszlo Molnar's djgpp |
d92eb7b0 |
49 | port in http://www.perl.com/CPAN/ports/msdos/ , which comes with clear |
50 | installation instructions. A simple installation guide for MS-DOS using |
87275199 |
51 | Ilya Zakharevich's OS/2 port is available at |
52 | http://www.cs.ruu.nl/%7Epiet/perl5dos.html |
53 | and similarly for Windows 3.1 at http://www.cs.ruu.nl/%7Epiet/perlwin3.html . |
3fe9a6f1 |
54 | |
55 | =head2 I don't have a C compiler on my system. How can I compile perl? |
56 | |
57 | Since you don't have a C compiler, you're doomed and your vendor |
58 | should be sacrificed to the Sun gods. But that doesn't help you. |
59 | |
60 | What you need to do is get a binary version of gcc for your system |
61 | first. Consult the Usenet FAQs for your operating system for |
62 | information on where to get such a binary version. |
63 | |
68dc0745 |
64 | =head2 I copied the Perl binary from one machine to another, but scripts don't work. |
65 | |
66 | That's probably because you forgot libraries, or library paths differ. |
67 | You really should build the whole distribution on the machine it will |
68 | eventually live on, and then type C<make install>. Most other |
69 | approaches are doomed to failure. |
70 | |
71 | One simple way to check that things are in the right place is to print out |
46fc3d4c |
72 | the hard-coded @INC which perl is looking for. |
68dc0745 |
73 | |
65acb1b1 |
74 | % perl -e 'print join("\n",@INC)' |
68dc0745 |
75 | |
76 | If this command lists any paths which don't exist on your system, then you |
77 | may need to move the appropriate libraries to these locations, or create |
87275199 |
78 | symbolic links, aliases, or shortcuts appropriately. @INC is also printed as |
65acb1b1 |
79 | part of the output of |
80 | |
81 | % perl -V |
68dc0745 |
82 | |
3fe9a6f1 |
83 | You might also want to check out L<perlfaq8/"How do I keep my own |
84 | module/library directory?">. |
85 | |
68dc0745 |
86 | =head2 I grabbed the sources and tried to compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make it work? |
87 | |
88 | Read the F<INSTALL> file, which is part of the source distribution. |
65acb1b1 |
89 | It describes in detail how to cope with most idiosyncrasies that the |
68dc0745 |
90 | Configure script can't work around for any given system or |
91 | architecture. |
92 | |
93 | =head2 What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean? |
94 | |
95 | CPAN stands for Comprehensive Perl Archive Network, a huge archive |
96 | replicated on dozens of machines all over the world. CPAN contains |
46fc3d4c |
97 | source code, non-native ports, documentation, scripts, and many |
68dc0745 |
98 | third-party modules and extensions, designed for everything from |
99 | commercial database interfaces to keyboard/screen control to web |
100 | walking and CGI scripts. The master machine for CPAN is |
101 | ftp://ftp.funet.fi/pub/languages/perl/CPAN/, but you can use the |
102 | address http://www.perl.com/CPAN/CPAN.html to fetch a copy from a |
103 | "site near you". See http://www.perl.com/CPAN (without a slash at the |
104 | end) for how this process works. |
105 | |
106 | CPAN/path/... is a naming convention for files available on CPAN |
107 | sites. CPAN indicates the base directory of a CPAN mirror, and the |
108 | rest of the path is the path from that directory to the file. For |
109 | instance, if you're using ftp://ftp.funet.fi/pub/languages/perl/CPAN |
110 | as your CPAN site, the file CPAN/misc/japh file is downloadable as |
111 | ftp://ftp.funet.fi/pub/languages/perl/CPAN/misc/japh . |
112 | |
113 | Considering that there are hundreds of existing modules in the |
114 | archive, one probably exists to do nearly anything you can think of. |
87275199 |
115 | Current categories under CPAN/modules/by-category/ include Perl core |
68dc0745 |
116 | modules; development support; operating system interfaces; networking, |
117 | devices, and interprocess communication; data type utilities; database |
118 | interfaces; user interfaces; interfaces to other languages; filenames, |
119 | file systems, and file locking; internationalization and locale; world |
120 | wide web support; server and daemon utilities; archiving and |
121 | compression; image manipulation; mail and news; control flow |
122 | utilities; filehandle and I/O; Microsoft Windows modules; and |
123 | miscellaneous modules. |
124 | |
125 | =head2 Is there an ISO or ANSI certified version of Perl? |
126 | |
127 | Certainly not. Larry expects that he'll be certified before Perl is. |
128 | |
129 | =head2 Where can I get information on Perl? |
130 | |
87275199 |
131 | The complete Perl documentation is available with the Perl distribution. |
132 | If you have Perl installed locally, you probably have the documentation |
5a964f20 |
133 | installed as well: type C<man perl> if you're on a system resembling Unix. |
134 | This will lead you to other important man pages, including how to set your |
135 | $MANPATH. If you're not on a Unix system, access to the documentation |
136 | will be different; for example, it might be only in HTML format. But all |
87275199 |
137 | proper Perl installations have fully-accessible documentation. |
68dc0745 |
138 | |
139 | You might also try C<perldoc perl> in case your system doesn't |
140 | have a proper man command, or it's been misinstalled. If that doesn't |
141 | work, try looking in /usr/local/lib/perl5/pod for documentation. |
142 | |
143 | If all else fails, consult the CPAN/doc directory, which contains the |
144 | complete documentation in various formats, including native pod, |
145 | troff, html, and plain text. There's also a web page at |
146 | http://www.perl.com/perl/info/documentation.html that might help. |
147 | |
68dc0745 |
148 | Many good books have been written about Perl -- see the section below |
149 | for more details. |
150 | |
65acb1b1 |
151 | Tutorial documents are included in current or upcoming Perl releases |
152 | include L<perltoot> for objects, L<perlopentut> for file opening |
153 | semantics, L<perlreftut> for managing references, and L<perlxstut> |
154 | for linking C and Perl together. There may be more by the |
155 | time you read this. The following URLs might also be of |
156 | assistance: |
157 | |
158 | http://language.perl.com/info/documentation.html |
159 | http://reference.perl.com/query.cgi?tutorials |
160 | |
87275199 |
161 | =head2 What are the Perl newsgroups on Usenet? Where do I post questions? |
68dc0745 |
162 | |
163 | The now defunct comp.lang.perl newsgroup has been superseded by the |
164 | following groups: |
165 | |
166 | comp.lang.perl.announce Moderated announcement group |
167 | comp.lang.perl.misc Very busy group about Perl in general |
5a964f20 |
168 | comp.lang.perl.moderated Moderated discussion group |
68dc0745 |
169 | comp.lang.perl.modules Use and development of Perl modules |
170 | comp.lang.perl.tk Using Tk (and X) from Perl |
171 | |
172 | comp.infosystems.www.authoring.cgi Writing CGI scripts for the Web. |
173 | |
87275199 |
174 | There is also Usenet gateway to the mailing list used by the crack |
68dc0745 |
175 | Perl development team (perl5-porters) at |
5a964f20 |
176 | news://news.perl.com/perl.porters-gw/ . |
68dc0745 |
177 | |
178 | =head2 Where should I post source code? |
179 | |
65acb1b1 |
180 | You should post source code to whichever group is most appropriate, but |
181 | feel free to cross-post to comp.lang.perl.misc. If you want to cross-post |
182 | to alt.sources, please make sure it follows their posting standards, |
183 | including setting the Followup-To header line to NOT include alt.sources; |
184 | see their FAQ (http://www.faqs.org/faqs/alt-sources-intro/) for details. |
68dc0745 |
185 | |
87275199 |
186 | If you're just looking for software, first use AltaVista |
187 | (http://www.altavista.com), Deja (http://www.deja.com), and |
5a964f20 |
188 | search CPAN. This is faster and more productive than just posting |
189 | a request. |
190 | |
68dc0745 |
191 | =head2 Perl Books |
192 | |
7b8d334a |
193 | A number of books on Perl and/or CGI programming are available. A few of |
87275199 |
194 | these are good, some are OK, but many aren't worth your money. Tom |
68dc0745 |
195 | Christiansen maintains a list of these books, some with extensive |
196 | reviews, at http://www.perl.com/perl/critiques/index.html. |
197 | |
5e3006a4 |
198 | The incontestably definitive reference book on Perl, written by |
c2e66d9e |
199 | the creator of Perl, is now (July 2000) in its third edition: |
68dc0745 |
200 | |
201 | Programming Perl (the "Camel Book"): |
c2e66d9e |
202 | by Larry Wall, Tom Christiansen, and Jon Orwant |
203 | 0-596-00027-8 [3rd edition July 2000] |
204 | http://www.oreilly.com/catalog/pperl3/ |
205 | (English, translations to several languages are also available) |
68dc0745 |
206 | |
5e3006a4 |
207 | The companion volume to the Camel containing thousands |
208 | of real-world examples, mini-tutorials, and complete programs |
209 | (first premiering at the 1998 Perl Conference), is: |
210 | |
211 | The Perl Cookbook (the "Ram Book"): |
65acb1b1 |
212 | by Tom Christiansen and Nathan Torkington, |
c2e66d9e |
213 | with Foreword by Larry Wall |
214 | ISBN 1-56592-243-3 [1st Edition August 1998] |
215 | http://perl.oreilly.com/cookbook/ |
68dc0745 |
216 | |
5a964f20 |
217 | If you're already a hard-core systems programmer, then the Camel Book |
218 | might suffice for you to learn Perl from. But if you're not, check |
5e3006a4 |
219 | out: |
220 | |
221 | Learning Perl (the "Llama Book"): |
65acb1b1 |
222 | by Randal Schwartz and Tom Christiansen |
5e3006a4 |
223 | with Foreword by Larry Wall |
c2e66d9e |
224 | ISBN 1-56592-284-0 [2nd Edition July 1997] |
225 | http://www.oreilly.com/catalog/lperl2/ |
5e3006a4 |
226 | |
227 | Despite the picture at the URL above, the second edition of "Llama |
228 | Book" really has a blue cover, and is updated for the 5.004 release |
229 | of Perl. Various foreign language editions are available, including |
230 | I<Learning Perl on Win32 Systems> (the Gecko Book). |
5a964f20 |
231 | |
232 | If you're not an accidental programmer, but a more serious and possibly |
233 | even degreed computer scientist who doesn't need as much hand-holding as |
234 | we try to provide in the Llama or its defurred cousin the Gecko, please |
235 | check out the delightful book, I<Perl: The Programmer's Companion>, |
236 | written by Nigel Chapman. |
237 | |
c8db1d39 |
238 | You can order O'Reilly books directly from O'Reilly & Associates, |
5a964f20 |
239 | 1-800-998-9938. Local/overseas is 1-707-829-0515. If you can |
240 | locate an O'Reilly order form, you can also fax to 1-707-829-0104. |
241 | See http://www.ora.com/ on the Web. |
242 | |
68dc0745 |
243 | What follows is a list of the books that the FAQ authors found personally |
244 | useful. Your mileage may (but, we hope, probably won't) vary. |
245 | |
c2e66d9e |
246 | Recommended books on (or mostly on) Perl follow. |
68dc0745 |
247 | |
5a964f20 |
248 | =over |
68dc0745 |
249 | |
5a964f20 |
250 | =item References |
68dc0745 |
251 | |
c2e66d9e |
252 | Programming Perl |
253 | by Larry Wall, Tom Christiansen, and Jon Orwant |
254 | ISBN 0-596-00027-8 [3rd edition July 2000] |
255 | http://www.oreilly.com/catalog/pperl3/ |
68dc0745 |
256 | |
c2e66d9e |
257 | Perl 5 Pocket Reference |
87275199 |
258 | by Johan Vromans |
c2e66d9e |
259 | ISBN 0-596-00032-4 [3rd edition May 2000] |
260 | http://www.oreilly.com/catalog/perlpr3/ |
87275199 |
261 | |
c2e66d9e |
262 | Perl in a Nutshell |
87275199 |
263 | by Ellen Siever, Stephan Spainhour, and Nathan Patwardhan |
c2e66d9e |
264 | ISBN 1-56592-286-7 [1st edition December 1998] |
265 | http://www.oreilly.com/catalog/perlnut/ |
68dc0745 |
266 | |
5a964f20 |
267 | =item Tutorials |
c47ff5f1 |
268 | |
c2e66d9e |
269 | Elements of Programming with Perl |
270 | by Andrew L. Johnson |
271 | ISBN 1884777805 [1st edition October 1999] |
272 | http://www.manning.com/Johnson/ |
273 | |
274 | Learning Perl |
5a964f20 |
275 | by Randal L. Schwartz and Tom Christiansen |
5e3006a4 |
276 | with foreword by Larry Wall |
c2e66d9e |
277 | ISBN 1-56592-284-0 [2nd edition July 1997] |
278 | http://www.oreilly.com/catalog/lperl2/ |
68dc0745 |
279 | |
c2e66d9e |
280 | Learning Perl on Win32 Systems |
5a964f20 |
281 | by Randal L. Schwartz, Erik Olson, and Tom Christiansen, |
282 | with foreword by Larry Wall |
c2e66d9e |
283 | ISBN 1-56592-324-3 [1st edition August 1997] |
284 | http://www.oreilly.com/catalog/lperlwin/ |
68dc0745 |
285 | |
5a964f20 |
286 | Perl: The Programmer's Companion |
287 | by Nigel Chapman |
c2e66d9e |
288 | ISBN 0-471-97563-X [1st edition October 1997] |
289 | http://catalog.wiley.com/title.cgi?isbn=047197563X |
68dc0745 |
290 | |
c2e66d9e |
291 | Cross-Platform Perl |
292 | by Eric Foster-Johnson |
293 | ISBN 1-55851-483-X [2nd edition September 2000] |
294 | http://www.pconline.com/~erc/perlbook.htm |
68dc0745 |
295 | |
c2e66d9e |
296 | MacPerl: Power and Ease |
297 | by Vicki Brown and Chris Nandor, |
298 | with foreword by Matthias Neeracher |
299 | ISBN 1-881957-32-2 [1st edition May 1998] |
300 | http://www.macperl.com/ptf_book/ |
68dc0745 |
301 | |
65acb1b1 |
302 | =item Task-Oriented |
5a964f20 |
303 | |
c2e66d9e |
304 | The Perl Cookbook |
5a964f20 |
305 | by Tom Christiansen and Nathan Torkington |
306 | with foreword by Larry Wall |
c2e66d9e |
307 | ISBN 1-56592-243-3 [1st edition August 1998] |
308 | http://www.oreilly.com/catalog/cookbook/ |
5a964f20 |
309 | |
c2e66d9e |
310 | Perl5 Interactive Course |
5a964f20 |
311 | by Jon Orwant |
c2e66d9e |
312 | ISBN 1571690646 [1st edition June 1997] |
5a964f20 |
313 | |
c2e66d9e |
314 | Advanced Perl Programming |
5a964f20 |
315 | by Sriram Srinivasan |
c2e66d9e |
316 | ISBN 1-56592-220-4 [1st edition August 1997] |
317 | http://www.oreilly.com/catalog/advperl/ |
68dc0745 |
318 | |
5a964f20 |
319 | Effective Perl Programming |
320 | by Joseph Hall |
c2e66d9e |
321 | ISBN 0-201-41975-0 [1st edition 1998] |
322 | http://www.awl.com/ |
68dc0745 |
323 | |
5a964f20 |
324 | =item Special Topics |
325 | |
c2e66d9e |
326 | Mastering Regular Expressions |
327 | by Jeffrey E. F. Friedl |
328 | ISBN 1-56592-257-3 [1st edition January 1997] |
329 | http://www.oreilly.com/catalog/regex/ |
5a964f20 |
330 | |
c2e66d9e |
331 | How to Set up and Maintain a World Wide Web Site |
5a964f20 |
332 | by Lincoln Stein |
c2e66d9e |
333 | ISBN 0-201-63389-2 [1st edition 1995] |
334 | http://www.awl.com/ |
5a964f20 |
335 | |
c2e66d9e |
336 | Object Oriented Perl |
337 | Damian Conway |
338 | with foreword by Randal L. Schwartz |
339 | ISBN 1884777791 [1st edition August 1999] |
340 | http://www.manning.com/Conway/ |
341 | |
342 | Learning Perl/Tk |
87275199 |
343 | by Nancy Walsh |
c2e66d9e |
344 | ISBN 1-56592-314-6 [1st edition January 1999] |
345 | http://www.oreilly.com/catalog/lperltk/ |
87275199 |
346 | |
5a964f20 |
347 | =back |
348 | |
349 | =head2 Perl in Magazines |
350 | |
351 | The first and only periodical devoted to All Things Perl, I<The |
352 | Perl Journal> contains tutorials, demonstrations, case studies, |
353 | announcements, contests, and much more. TPJ has columns on web |
354 | development, databases, Win32 Perl, graphical programming, regular |
5e3006a4 |
355 | expressions, and networking, and sponsors the Obfuscated Perl |
356 | Contest. It is published quarterly under the gentle hand of its |
357 | editor, Jon Orwant. See http://www.tpj.com/ or send mail to |
65acb1b1 |
358 | subscriptions@tpj.com . |
5a964f20 |
359 | |
360 | Beyond this, magazines that frequently carry high-quality articles |
361 | on Perl are I<Web Techniques> (see http://www.webtechniques.com/), |
c8db1d39 |
362 | I<Performance Computing> (http://www.performance-computing.com/), and Usenix's |
5a964f20 |
363 | newsletter/magazine to its members, I<login:>, at http://www.usenix.org/. |
364 | Randal's Web Technique's columns are available on the web at |
365 | http://www.stonehenge.com/merlyn/WebTechniques/. |
68dc0745 |
366 | |
367 | =head2 Perl on the Net: FTP and WWW Access |
368 | |
369 | To get the best (and possibly cheapest) performance, pick a site from |
370 | the list below and use it to grab the complete list of mirror sites. |
87275199 |
371 | From there you can find the quickest site for you. Remember, the |
c2e66d9e |
372 | following list is I<not> the complete list of CPAN mirrors |
373 | (the complete list contains 136 sites as of July 2000): |
374 | |
375 | http://www.perl.com/CPAN/ |
376 | http://www.cpan.org/CPAN/ |
377 | http://download.sourceforge.net/mirrors/CPAN/ |
378 | ftp://ftp.digital.com/pub/plan/perl/CPAN/ |
379 | ftp://ftp.flirble.org/pub/languages/perl/CPAN/ |
380 | ftp://ftp.uvsq.fr/pub/perl/CPAN/ |
68dc0745 |
381 | ftp://ftp.funet.fi/pub/languages/perl/CPAN/ |
c2e66d9e |
382 | ftp://ftp.dti.ad.jp/pub/lang/CPAN/ |
383 | ftp://mirror.aarnet.edu.au/pub/perl/CPAN/ |
384 | ftp://cpan.if.usp.br/pub/mirror/CPAN/ |
68dc0745 |
385 | |
87275199 |
386 | =head2 What mailing lists are there for Perl? |
68dc0745 |
387 | |
87275199 |
388 | Most of the major modules (Tk, CGI, libwww-perl) have their own |
68dc0745 |
389 | mailing lists. Consult the documentation that came with the module for |
0b8d69e9 |
390 | subscription information. The Perl Mongers attempt to maintain a |
65acb1b1 |
391 | list of mailing lists at: |
68dc0745 |
392 | |
f6c51b38 |
393 | http://www.perl.org/support/online_support.html#mail |
68dc0745 |
394 | |
65acb1b1 |
395 | =head2 Archives of comp.lang.perl.misc |
68dc0745 |
396 | |
87275199 |
397 | Have you tried Deja or AltaVista? Those are the |
65acb1b1 |
398 | best archives. Just look up "*perl*" as a newsgroup. |
68dc0745 |
399 | |
87275199 |
400 | http://www.deja.com/dnquery.xp?QRY=&DBS=2&ST=PS&defaultOp=AND&LNG=ALL&format=terse&showsort=date&maxhits=25&subjects=&groups=*perl*&authors=&fromdate=&todate= |
68dc0745 |
401 | |
65acb1b1 |
402 | You'll probably want to trim that down a bit, though. |
68dc0745 |
403 | |
68dc0745 |
404 | You'll probably want more a sophisticated query and retrieval mechanism |
405 | than a file listing, preferably one that allows you to retrieve |
406 | articles using a fast-access indices, keyed on at least author, date, |
407 | subject, thread (as in "trn") and probably keywords. The best |
408 | solution the FAQ authors know of is the MH pick command, but it is |
409 | very slow to select on 18000 articles. |
410 | |
411 | If you have, or know where can be found, the missing sections, please |
412 | let perlfaq-suggestions@perl.com know. |
413 | |
68dc0745 |
414 | =head2 Where can I buy a commercial version of Perl? |
415 | |
d92eb7b0 |
416 | In a real sense, Perl already I<is> commercial software: It has a license |
65acb1b1 |
417 | that you can grab and carefully read to your manager. It is distributed |
418 | in releases and comes in well-defined packages. There is a very large |
419 | user community and an extensive literature. The comp.lang.perl.* |
420 | newsgroups and several of the mailing lists provide free answers to your |
421 | questions in near real-time. Perl has traditionally been supported by |
422 | Larry, scores of software designers and developers, and myriads of |
423 | programmers, all working for free to create a useful thing to make life |
424 | better for everyone. |
68dc0745 |
425 | |
426 | However, these answers may not suffice for managers who require a |
65acb1b1 |
427 | purchase order from a company whom they can sue should anything go awry. |
428 | Or maybe they need very serious hand-holding and contractual obligations. |
87275199 |
429 | Shrink-wrapped CDs with Perl on them are available from several sources if |
430 | that will help. For example, many Perl books carry a Perl distribution |
d92eb7b0 |
431 | on them, as do the O'Reilly Perl Resource Kits (in both the Unix flavor |
65acb1b1 |
432 | and in the proprietary Microsoft flavor); the free Unix distributions |
433 | also all come with Perl. |
68dc0745 |
434 | |
e28598cb |
435 | Or you can purchase commercial incidence based support through the Perl |
436 | Clinic. The following is a commercial from them: |
437 | |
438 | "The Perl Clinic is a commercial Perl support service operated by |
439 | ActiveState Tool Corp. and The Ingram Group. The operators have many |
440 | years of in-depth experience with Perl applications and Perl internals |
441 | on a wide range of platforms. |
442 | |
443 | "Through our group of highly experienced and well-trained support engineers, |
444 | we will put our best effort into understanding your problem, providing an |
445 | explanation of the situation, and a recommendation on how to proceed." |
446 | |
447 | Contact The Perl Clinic at: |
448 | |
449 | www.PerlClinic.com |
450 | |
451 | North America Pacific Standard Time (GMT-8) |
452 | Tel: 1 604 606-4611 hours 8am-6pm |
453 | Fax: 1 604 606-4640 |
454 | |
455 | Europe (GMT) |
456 | Tel: 00 44 1483 862814 |
457 | Fax: 00 44 1483 862801 |
68dc0745 |
458 | |
65acb1b1 |
459 | See also www.perl.com for updates on tutorials, training, and support. |
5e3006a4 |
460 | |
68dc0745 |
461 | =head2 Where do I send bug reports? |
462 | |
463 | If you are reporting a bug in the perl interpreter or the modules |
87275199 |
464 | shipped with Perl, use the I<perlbug> program in the Perl distribution or |
7f2de2d2 |
465 | mail your report to perlbug@perl.org . |
68dc0745 |
466 | |
46fc3d4c |
467 | If you are posting a bug with a non-standard port (see the answer to |
68dc0745 |
468 | "What platforms is Perl available for?"), a binary distribution, or a |
46fc3d4c |
469 | non-standard module (such as Tk, CGI, etc), then please see the |
68dc0745 |
470 | documentation that came with it to determine the correct place to post |
471 | bugs. |
472 | |
5a964f20 |
473 | Read the perlbug(1) man page (perl5.004 or later) for more information. |
68dc0745 |
474 | |
90bb42f6 |
475 | =head2 What is perl.com? Perl Mongers? pm.org? perl.org? |
68dc0745 |
476 | |
65acb1b1 |
477 | The perl.com domain is owned by Tom Christiansen, who created it as a |
5a964f20 |
478 | public service long before perl.org came about. Despite the name, it's a |
479 | pretty non-commercial site meant to be a clearinghouse for information |
480 | about all things Perlian, accepting no paid advertisements, bouncy |
87275199 |
481 | happy GIFs, or silly Java applets on its pages. The Perl Home Page at |
5a964f20 |
482 | http://www.perl.com/ is currently hosted on a T3 line courtesy of Songline |
483 | Systems, a software-oriented subsidiary of O'Reilly and Associates. |
65acb1b1 |
484 | Other starting points include |
5a964f20 |
485 | |
65acb1b1 |
486 | http://language.perl.com/ |
487 | http://conference.perl.com/ |
488 | http://reference.perl.com/ |
68dc0745 |
489 | |
90bb42f6 |
490 | Perl Mongers is an advocacy organization for the Perl language. For |
491 | details, see the Perl Mongers web site at http://www.perlmongers.org/. |
492 | |
493 | Perl Mongers uses the pm.org domain for services related to Perl user |
494 | groups. See the Perl user group web site at http://www.pm.org/ for more |
495 | information about joining, starting, or requesting services for a Perl |
496 | user group. |
497 | |
498 | Perl Mongers also maintains the perl.org domain to provide general |
499 | support services to the Perl community, including the hosting of mailing |
500 | lists, web sites, and other services. The web site |
501 | http://www.perl.org/ is a general advocacy site for the Perl language, |
502 | and there are many other sub-domains for special topics, such as |
503 | |
504 | http://history.perl.org/ |
505 | http://bugs.perl.org/ |
506 | http://www.news.perl.org/ |
507 | |
68dc0745 |
508 | =head1 AUTHOR AND COPYRIGHT |
509 | |
65acb1b1 |
510 | Copyright (c) 1997-1999 Tom Christiansen and Nathan Torkington. |
5a964f20 |
511 | All rights reserved. |
512 | |
c8db1d39 |
513 | When included as an integrated part of the Standard Distribution |
d92eb7b0 |
514 | of Perl or of its documentation (printed or otherwise), this works is |
515 | covered under Perl's Artistic License. For separate distributions of |
c8db1d39 |
516 | all or part of this FAQ outside of that, see L<perlfaq>. |
517 | |
87275199 |
518 | Irrespective of its distribution, all code examples here are in the public |
c8db1d39 |
519 | domain. You are permitted and encouraged to use this code and any |
520 | derivatives thereof in your own programs for fun or for profit as you |
521 | see fit. A simple comment in the code giving credit to the FAQ would |
522 | be courteous but is not required. |