pod/perlfaq.pod

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