[ID 20001005.006] Documentation -- description of qr//
[p5sagit/p5-mst-13.2.git] / pod / perlfaq.pod
index cb35493..ffa4a17 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-perlfaq - frequently asked questions about Perl ($Date: 1999/01/08 05:54:52 $)
+perlfaq - frequently asked questions about Perl ($Date: 1999/05/23 20:38:02 $)
 
 =head1 DESCRIPTION
 
@@ -46,7 +46,7 @@ Very general, high-level information about Perl.
 
 =item * Where can I get a list of Larry Wall witticisms?
 
-=item * How can I convince my sysadmin/supervisor/employees to use version (5/5.005/Perl instead of some other language)?
+=item * How can I convince my sysadmin/supervisor/employees to use (version 5/5.005/Perl) instead of some other language?
 
 =back
 
@@ -162,7 +162,7 @@ Programmer tools and programming support.
 =item * Where can I learn about linking C with Perl? [h2xs, xsubpp]
 
 =item * I've read perlembed, perlguts, etc., but I can't embed perl in
-my C program, what am I doing wrong?
+my C program; what am I doing wrong?
 
 =item * When I tried to run my script, I got this message. What does it
 mean?
@@ -199,6 +199,8 @@ miscellaneous data issues.
 
 =item * How do I find the week-of-the-year/day-of-the-year?
 
+=item * How do I find the current century or millennium?
+
 =item * How can I compare two dates and find the difference?
 
 =item * How can I take a string and turn it into epoch seconds?
@@ -248,13 +250,13 @@ miscellaneous data issues.
 
 =item * What's wrong with always quoting "$vars"?
 
-=item * Why don't my E<lt>E<lt>HERE documents work?
+=item * Why don't my <<HERE documents work?
 
 =item * What is the difference between a list and an array?
 
 =item * What is the difference between $array[1] and @array[1]?
 
-=item * How can I extract just the unique elements of an array?
+=item * How can I remove duplicate elements from a list or array?
 
 =item * How can I tell whether a list or array contains a certain element?
 
@@ -359,11 +361,11 @@ I/O and the "f" issues: filehandles, flushing, formats and footers.
 
 =item * How come when I open a file read-write it wipes it out?
 
-=item * Why do I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?
+=item * Why do I sometimes get an "Argument list too long" when I use <*>?
 
 =item * Is there a leak/bug in glob()?
 
-=item * How can I open a file with a leading "E<gt>" or trailing blanks?
+=item * How can I open a file with a leading ">" or trailing blanks?
 
 =item * How can I reliably rename a file?
 
@@ -381,6 +383,8 @@ I/O and the "f" issues: filehandles, flushing, formats and footers.
 
 =item * How do I print to more than one file at once?
 
+=item * How can I read in an entire file all at once?
+
 =item * How can I read in a file by paragraphs?
 
 =item * How can I read a single character from a file?  From the keyboard?
@@ -420,13 +424,13 @@ Pattern matching and regular expressions.
 
 =item * I put a regular expression into $/ but it didn't work. What's wrong?
 
-=item * How do I substitute case insensitively on the LHS, but preserving case on the RHS?
+=item * How do I substitute case insensitively on the LHS while preserving case on the RHS?
 
 =item * How can I make C<\w> match national character sets?
 
 =item * How can I match a locale-smart version of C</[a-zA-Z]/>?
 
-=item * How can I quote a variable to use in a regexp?
+=item * How can I quote a variable to use in a regex?
 
 =item * What is C</o> really for?
 
@@ -434,7 +438,7 @@ Pattern matching and regular expressions.
 
 =item * Can I use Perl regular expressions to match balanced text?
 
-=item * What does it mean that regexps are greedy?  How can I get around it?
+=item * What does it mean that regexes are greedy?  How can I get around it?
 
 =item * How do I process each word on each line?
 
@@ -450,7 +454,7 @@ Pattern matching and regular expressions.
 
 =item * What good is C<\G> in a regular expression?
 
-=item * Are Perl regexps DFAs or NFAs?  Are they POSIX compliant?
+=item * Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
 
 =item * What's wrong with using grep or map in a void context?
 
@@ -470,7 +474,7 @@ other sections.
 
 =item * Can I get a BNF/yacc/RE for the Perl language?
 
-=item * What are all these $@%* punctuation signs, and how do I know when to use them?
+=item * What are all these $@%&* punctuation signs, and how do I know when to use them?
 
 =item * Do I always/never have to quote my strings or use semicolons and commas?
 
@@ -494,7 +498,7 @@ other sections.
 
 =item * What is variable suicide and how can I prevent it?
 
-=item * How can I pass/return a {Function, FileHandle, Array, Hash, Method, Regexp}?
+=item * How can I pass/return a {Function, FileHandle, Array, Hash, Method, Regex}?
 
 =item * How do I create a static variable?
 
@@ -504,7 +508,7 @@ other sections.
 
 =item * What's the difference between deep and shallow binding?
 
-=item * Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
+=item * Why doesn't "my($foo) = <FILE>;" work right?
 
 =item * How do I redefine a builtin function, operator, or method?
 
@@ -522,6 +526,8 @@ other sections.
 
 =item * How do I clear a package?
 
+=item * How can I use a variable as a variable name?
+
 =back
 
 
@@ -568,7 +574,7 @@ Interprocess communication (IPC), control over the user-interface
 
 =item * How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
 
-=item * Why doesn't my sockets program work under System V (Solaris)? What does the error message "Protocol not supported" mean?
+=item * Why doesn't my sockets program work under System V (Solaris)?  What does the error message "Protocol not supported" mean?
 
 =item * How can I call my system's unique C functions from Perl?
 
@@ -620,7 +626,7 @@ Interprocess communication (IPC), control over the user-interface
 
 =item * How do I open a file without blocking?
 
-=item * How do I install a CPAN module?
+=item * How do I install a module from CPAN?
 
 =item * What's the difference between require and use?
 
@@ -641,7 +647,7 @@ Networking, the Internet, and a few on the web.
 
 =over 4
 
-=item * My CGI script runs from the command line but not the browser.   (500 Server Error)
+=item * My CGI script runs from the command line but not the browser.  (500 Server Error)
 
 =item * How can I get better error messages from a CGI program?
 
@@ -698,7 +704,7 @@ Networking, the Internet, and a few on the web.
 
 This document is posted regularly to comp.lang.perl.announce and
 several other related newsgroups.  It is available in a variety of
-formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory, or on the web
+formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory or on the web
 at http://www.perl.com/perl/faq/ .
 
 =head2 How to contribute to this document
@@ -734,11 +740,11 @@ All rights reserved.
 
 =head2 Bundled Distributions
 
-When included as part of the Standard Version of Perl, or as part of
+When included as part of the Standard Version of Perl or as part of
 its complete documentation whether printed or otherwise, this work
 may be distributed only under the terms of Perl's Artistic License.
 Any distribution of this file or derivatives thereof I<outside>
-of that package require that special arrangements be made with
+of that package requires that special arrangements be made with
 copyright holder.
 
 Irrespective of its distribution, all code examples in these files
@@ -758,6 +764,19 @@ in respect of this information or its use.
 
 =over 4
 
+=item 1/November/2000
+
+A few grammatical fixes and updates implemented by John Borwick.
+
+=item 23/May/99
+
+Extensive updates from the net in preparation for 5.6 release.
+
+=item 13/April/99
+
+More minor touch-ups.  Added new question at the end
+of perlfaq7 on variable names within variables.
+
 =item 7/January/99
 
 Small touchups here and there.  Added all questions in this 
@@ -816,4 +835,3 @@ This is the initial release of version 3 of the FAQ; consequently there
 have been no changes since its initial release.
 
 =back
-