This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
5.004_70 bug in perlfaq.pod
[perl5.git] / pod / perlfaq.pod
CommitLineData
68dc0745
PP
1=head1 NAME
2
c8db1d39 3perlfaq - frequently asked questions about Perl ($Date: 1998/06/22 15:15:57 $)
68dc0745
PP
4
5=head1 DESCRIPTION
6
7This document is structured into the following sections:
8
9=over
10
11=item perlfaq: Structural overview of the FAQ.
12
13This document.
14
15=item L<perlfaq1>: General Questions About Perl
16
17Very general, high-level information about Perl.
18
19=item L<perlfaq2>: Obtaining and Learning about Perl
20
21Where to find source and documentation to Perl, support and training,
22and related matters.
23
24=item L<perlfaq3>: Programming Tools
25
26Programmer tools and programming support.
27
28=item L<perlfaq4>: Data Manipulation
29
30Manipulating numbers, dates, strings, arrays, hashes, and
31miscellaneous data issues.
32
33=item L<perlfaq5>: Files and Formats
34
35I/O and the "f" issues: filehandles, flushing, formats and footers.
36
37=item L<perlfaq6>: Regexps
38
39Pattern matching and regular expressions.
40
41=item L<perlfaq7>: General Perl Language Issues
42
43General Perl language issues that don't clearly fit into any of the
44other sections.
45
46=item L<perlfaq8>: System Interaction
47
48Interprocess communication (IPC), control over the user-interface
49(keyboard, screen and pointing devices).
50
51=item L<perlfaq9>: Networking
52
53Networking, the Internet, and a few on the web.
54
55=back
56
57=head2 Where to get this document
58
59This document is posted regularly to comp.lang.perl.announce and
60several other related newsgroups. It is available in a variety of
61formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory, or on the web
62at http://www.perl.com/perl/faq/ .
63
64=head2 How to contribute to this document
65
66You may mail corrections, additions, and suggestions to
c8db1d39
TC
67perlfaq-suggestions@perl.com . This alias should not be
68used to I<ask> FAQs. It's for fixing the current FAQ.
68dc0745
PP
69
70=head2 What will happen if you mail your Perl programming problems to the authors
71
72Your questions will probably go unread, unless they're suggestions of
73new questions to add to the FAQ, in which case they should have gone
74to the perlfaq-suggestions@perl.com instead.
75
76You should have read section 2 of this faq. There you would have
77learned that comp.lang.perl.misc is the appropriate place to go for
78free advice. If your question is really important and you require a
79prompt and correct answer, you should hire a consultant.
80
81=head1 Credits
82
83When I first began the Perl FAQ in the late 80s, I never realized it
84would have grown to over a hundred pages, nor that Perl would ever become
85so popular and widespread. This document could not have been written
86without the tremendous help provided by Larry Wall and the rest of the
87Perl Porters.
88
89=head1 Author and Copyright Information
90
c8db1d39 91Copyright (c) 1997, 1998 Tom Christiansen and Nathan Torkington.
68dc0745
PP
92All rights reserved.
93
c8db1d39 94=head2 Bundled Distributions
68dc0745 95
c8db1d39
TC
96When included as part of the Standard Version of Perl, or as part of
97its complete documentation whether printed or otherwise, this work
98may be distributed only under the terms of Perl's Artistic License.
99Any distribution of this file or derivatives thereof I<outside>
100of that package require that special arrangements be made with
101copyright holder.
68dc0745 102
c8db1d39
TC
103Irrespective of its distribution, all code examples in these files
104are hereby placed into the public domain. You are permitted and
105encouraged to use this code in your own programs for fun
106or for profit as you see fit. A simple comment in the code giving
107credit would be courteous but is not required.
68dc0745
PP
108
109=head2 Disclaimer
110
111This information is offered in good faith and in the hope that it may
112be of use, but is not guaranteed to be correct, up to date, or suitable
113for any particular purpose whatsoever. The authors accept no liability
114in respect of this information or its use.
115
116=head1 Changes
117
118=over 4
119
970ed202 120=item 22/June/98
c8db1d39
TC
121
122Significant changes throughout in preparation for the 5.005
123release.
124
fc36a67e
PP
125=item 24/April/97
126
127Style and whitespace changes from Chip, new question on reading one
128character at a time from a terminal using POSIX from Tom.
129
46fc3d4c
PP
130=item 23/April/97
131
132Added http://www.oasis.leo.org/perl/ to L<perlfaq2>. Style fix to
133L<perlfaq3>. Added floating point precision, fixed complex number
134arithmetic, cross-references, caveat for Text::Wrap, alternative
135answer for initial capitalizing, fixed incorrect regexp, added example
136of Tie::IxHash to L<perlfaq4>. Added example of passing and storing
137filehandles, added commify to L<perlfaq5>. Restored variable suicide,
138and added mass commenting to L<perlfaq7>. Added Net::Telnet, fixed
139backticks, added reader/writer pair to telnet question, added FindBin,
140grouped module questions together in L<perlfaq8>. Expanded caveats
141for the simple URL extractor, gave LWP example, added CGI security
5a964f20 142question, expanded on the mail address answer in L<perlfaq9>.
46fc3d4c 143
3fe9a6f1
PP
144=item 25/March/97
145
146Added more info to the binary distribution section of L<perlfaq2>.
147Added Net::Telnet to L<perlfaq6>. Fixed typos in L<perlfaq8>. Added
148mail sending example to L<perlfaq9>. Added Merlyn's columns to
149L<perlfaq2>.
150
46fc3d4c 151=item 18/March/97
3fe9a6f1
PP
152
153Added the DATE to the NAME section, indicating which sections have
154changed.
155
156Mentioned SIGPIPE and L<perlipc> in the forking open answer in
157L<perlfaq8>.
158
159Fixed description of a regular expression in L<perlfaq4>.
160
68dc0745
PP
161=item 17/March/97 Version
162
163Various typos fixed throughout.
164
165Added new question on Perl BNF on L<perlfaq7>.
166
167=item Initial Release: 11/March/97
168
169This is the initial release of version 3 of the FAQ; consequently there
170have been no changes since its initial release.
171
172=back