Remove the entry about removing Perl_deprecate()

[p5sagit/p5-mst-13.2.git] / pod / perlfaq.pod

diff --git a/pod/perlfaq.pod b/pod/perlfaq.pod
index 037268e..5862823 100644 (file)
--- a/pod/perlfaq.pod
+++ b/pod/perlfaq.pod
@@ -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
 
@@ -24,8 +24,8 @@ 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.
@@ -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
@@ -61,19 +67,22 @@ it, try the resources in L<perlfaq2>.
 
 Tom Christiansen wrote the original perlfaq then expanded it with the
 help of Nat Torkington.  The perlfaq-workers maintain current document
-and the dezinens of comp.lang.perl.misc regularly review and update the
+and the denizens 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
 
+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
 
@@ -123,7 +132,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 +140,7 @@ What was Ponie?
 
 =item *
 
-What is perl6?
+What is Perl 6?
 
 =item *
 
@@ -313,7 +322,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 *
 
@@ -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 *
@@ -747,6 +760,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 +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
 
 
@@ -876,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 *
@@ -1001,6 +1034,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,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 *