Mention there are places /x modifier is ineffective
[p5sagit/p5-mst-13.2.git] / pod / perlfaq.pod
index 037268e..6eb7d25 100644 (file)
@@ -12,7 +12,7 @@ into nine major sections outlined in this document.
 
 The perlfaq comes with the standard Perl distribution, so if you have Perl
 you should have the perlfaq. You should also have the C<perldoc> tool
-that let's you read the L<perlfaq>:
+that lets you read the L<perlfaq>:
 
        $ perldoc perlfaq
 
@@ -23,12 +23,12 @@ The perlfaq is an evolving document and you can read the latest version
 at http://faq.perl.org/ . The perlfaq-workers periodically post extracts
 of the latest perlfaq to comp.lang.perl.misc.
 
-You can view the source tree at
-https://svn.perl.org/modules/perlfaq/trunk/ (which is outside of the
-main Perl source tree).  The SVN repository notes all changes to the FAQ
-and holds the latest version of the working documents and may vary
-significantly from the version distributed with the latest version of
-Perl. Check the repository before sending your corrections.
+You can view the source tree at https://github.com/briandfoy/perlfaq
+(which is outside of the main Perl source tree). The git repository
+notes all changes to the FAQ and holds the latest version of the
+working documents and may vary significantly from the version
+distributed with the latest version of Perl. Check the repository
+before sending your corrections.
 
 =head2 How to contribute to the perlfaq
 
@@ -43,6 +43,12 @@ The perlfaq server posts extracts of the perlfaq to that newsgroup every
 answers. If you'd like to help review and update the answers, check out
 comp.lang.perl.misc.
 
+You can also fork the git repository for the perlfaq and send a pull
+request so the main repository can pull your changes. The repository
+is at:
+
+       https://github.com/briandfoy/perlfaq
+
 =head2 What will happen if you mail your Perl programming problems to the authors?
 
 The perlfaq-workers like to keep all traffic on the perlfaq-workers list
@@ -60,7 +66,7 @@ it, try the resources in L<perlfaq2>.
 =head1 CREDITS
 
 Tom Christiansen wrote the original perlfaq then expanded it with the
-help of Nat Torkington.  The perlfaq-workers maintain current document
+help of Nat Torkington. The perlfaq-workers maintain current document
 and the dezinens of comp.lang.perl.misc regularly review and update the
 FAQ. Several people have contributed answers, corrections, and comments,
 and the perlfaq notes those contributions wherever appropriate.
@@ -123,7 +129,7 @@ Which version of Perl should I use?
 
 =item *
 
-What are perl4, perl5, or perl6?
+What are Perl 4, Perl 5, or Perl 6?
 
 =item *
 
@@ -131,7 +137,7 @@ What was Ponie?
 
 =item *
 
-What is perl6?
+What is Perl 6?
 
 =item *
 
@@ -313,7 +319,7 @@ How can I use curses with Perl?
 
 =item *
 
-How can I use X or Tk with Perl?
+How can I write a GUI (X, Tk, Gtk, etc.) in Perl?
 
 =item *
 
@@ -458,7 +464,7 @@ How do I find yesterday's date?
 
 =item *
 
-Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
+Does Perl have a Year 2000 or 2038 problem? Is Perl Y2K compliant?
 
 =item *
 
@@ -610,6 +616,10 @@ How do I process an entire hash?
 
 =item *
 
+How do I merge two hashes?
+
+=item *
+
 What happens if I add or remove keys from a hash while iterating over it?
 
 =item *
@@ -715,6 +725,10 @@ How do I count the number of lines in a file?
 
 =item *
 
+How do I delete the last N lines from a file?
+
+=item *
+
 How can I use Perl's C<-i> option from within a program?
 
 =item *
@@ -747,6 +761,10 @@ How can I write() into a string?
 
 =item *
 
+How can I open a filehandle to a string?
+
+=item *
+
 How can I output my numbers with commas added?
 
 =item *
@@ -853,6 +871,18 @@ How do I select a random line from a file?
 
 Why do I get weird spaces when I print an array of lines?
 
+=item *
+
+How do I traverse a directory tree?
+
+=item *
+
+How do I delete a directory tree?
+
+=item *
+
+How do I copy an entire directory?
+
 =back
 
 
@@ -876,6 +906,10 @@ How can I pull out lines between two patterns that are themselves on different l
 
 =item *
 
+How do I match XML, HTML, or other nasty, ugly things with a regex?
+
+=item *
+
 I put a regular expression into $/ but it didn't work. What's wrong?
 
 =item *
@@ -1001,6 +1035,10 @@ How do I create a module?
 
 =item *
 
+How do I adopt or take over a module already on CPAN?
+
+=item *
+
 How do I create a class?
 
 =item *
@@ -1061,11 +1099,11 @@ Why can't a method included in this same file be found?
 
 =item *
 
-How can I find out my current package?
+How can I find out my current or calling package?
 
 =item *
 
-How can I comment out a large block of perl code?
+How can I comment out a large block of Perl code?
 
 =item *