asked questions about Perl and Perl programming. It's divided by topic
into nine major sections outlined in this document.
-=head2 Where to get the perlfaq
+=head2 Where to find the perlfaq
-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 lets you read the L<perlfaq>:
+The perlfaq is an evolving document. Read the latest version at
+L<http://learn.perl.org/faq/>. It is also included in the standard Perl
+distribution.
- $ perldoc perlfaq
-
-or search the perlfaq question headings:
+=head2 How to use the perlfaq
- $ perldoc -q open
+The C<perldoc> command line tool is part of the standard Perl distribution. To
+read the perlfaq:
-See L<perldoc> for more information.
+ $ perldoc perlfaq
-Besides your local system, you can find the perlfaq on the web, including
-at L<http://perldoc.perl.org/>.
+To search the perlfaq question headings:
-The perlfaq is an evolving document and you can read the latest version
-at L<http://faq.perl.org/>.
+ $ perldoc -q open
=head2 How to contribute to the perlfaq
-Please review L<https://github.com/perl-doc-cats/perlfaq/wiki>,
-if you do not find your suggestion please create an issue or pull request
-against L<https://github.com/perl-doc-cats/perlfaq>.
+Review L<https://github.com/perl-doc-cats/perlfaq/wiki>. If you don't find
+your suggestion create an issue or pull request against
+L<https://github.com/perl-doc-cats/perlfaq>.
-Once approved they will then be merged into
-L<https://github.com/tpf/perlfaq> which is the latest live version that
-drives L<http://faq.perl.org/> and will be distributed with the next
-release of Perl 5.
+Once approved, changes are merged into L<https://github.com/tpf/perlfaq>, the
+repository which drives L<http://learn.perl.org/faq/>, and they are
+distributed with the next Perl 5 release.
=head2 What if my question isn't answered in the FAQ?
-If you have a question that isn't in the FAQ and you would like help with
-it, try the resources in L<perlfaq2>.
-
-=head1 CREDITS
-
-Tom Christiansen wrote the original perlfaq then expanded it with the
-help of Nat Torkington. brian d foy substantialy edited and expanded
-the perlfaq. perlfaq-workers and others have also supplied feedback,
-patches and corrections over the years.
-
-=head1 AUTHOR AND COPYRIGHT
-
-Tom Christiansen 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).
+Try the resources in L<perlfaq2>.
-=head1 Table of Contents
+=head1 TABLE OF CONTENTS
=over 4
-=item perlfaq - this document
-
=item perlfaq1 - General Questions About Perl
=item perlfaq2 - Obtaining and Learning about Perl
=back
-=head1 The Questions
+=head1 THE QUESTIONS
=head2 L<perlfaq1>: General Questions About Perl
=item *
-How do I send mail?
+How do I send email?
=item *
=item *
-How do I read mail?
+How do I read email?
=item *
How can I do RPC in Perl?
=back
+
+
+=head1 CREDITS
+
+Tom Christiansen wrote the original perlfaq then expanded it with the
+help of Nat Torkington. brian d foy substantialy edited and expanded
+the perlfaq. perlfaq-workers and others have also supplied feedback,
+patches and corrections over the years.
+
+=head1 AUTHOR AND COPYRIGHT
+
+Tom Christiansen 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).
+