Implement facility to plug in syntax triggered by keywords

[perl5.git] / pod / perlfaq.pod

diff --git a/pod/perlfaq.pod b/pod/perlfaq.pod
index e0ec672..1612496 100644 (file)
--- a/pod/perlfaq.pod
+++ b/pod/perlfaq.pod
@@ -24,11 +24,11 @@ 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
+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.
+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,20 +66,23 @@ 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
-and the denizens of comp.lang.perl.misc regularly review and update the
+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.
 
 =head1 AUTHOR AND COPYRIGHT
 
-Tom Christiansen wrote the original version of this document.
+Copyright (c) 1997-2009 Tom Christiansen, Nathan Torkington, and
+other authors as noted. All rights reserved.
+
+Tom Christainsen wrote the original version of this document.
 brian d foy C<< <bdfoy@cpan.org> >> wrote this version. See the
 individual perlfaq documents for additional copyright information.
 
 This document is available under the same terms as Perl itself. Code
 examples in all the perlfaq documents are in the public domain. Use
-them as you see fit (and at your own risk with no warranty from anyone).
+them as you see fit and at your own risk with no warranty from anyone.
 
 =head1 Table of Contents
 
@@ -610,6 +619,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 *
@@ -857,6 +870,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
 
 
@@ -880,6 +905,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 *
@@ -1069,7 +1098,7 @@ 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 *