This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Promote v5.36 usage and feature bundles doc
[perl5.git] / pod / perl.pod
index ec00761..628d691 100644 (file)
@@ -21,7 +21,7 @@ For more information on these options, you can run C<perldoc perlrun>.
 
 The F<perldoc> program gives you access to all the documentation that comes
 with Perl.  You can get more documentation, tutorials and community support
-online at L<http://www.perl.org/>.
+online at L<https://www.perl.org/>.
 
 If you're new to Perl, you should start by running C<perldoc perlintro>,
 which is a general intro for beginners and provides some background to help
@@ -96,6 +96,7 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
       perlpacktut      Perl pack() and unpack() tutorial
     perlpod            Perl plain old documentation
     perlpodspec        Perl plain old documentation format specification
+    perldocstyle       Perl style guide for core docs
     perlpodstyle       Perl POD style guide
     perldiag           Perl diagnostic messages
     perldeprecation     Perl deprecations
@@ -129,6 +130,7 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
     perlebcdic         Considerations for running Perl on EBCDIC platforms
 
     perlsec            Perl security
+    perlsecpolicy      Perl security report handling policy
 
     perlmod            Perl modules: how they work
     perlmodlib         Perl modules: how to write and use
@@ -170,22 +172,31 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
     perlhacktut        Walk through the creation of a simple C code patch
     perlhacktips       Tips for Perl core C code hacking
     perlpolicy         Perl development policies
+    perlgov            Perl Rules of Governance
     perlgit            Using git with the Perl repository
 
-=head2 Miscellaneous
-
-    perlbook           Perl book information
-    perlcommunity      Perl community information
-
-    perldoc            Look up Perl documentation in Pod format
+=head2 History
 
     perlhist           Perl history records
     perldelta          Perl changes since previous version
-    perl5293delta      Perl changes in version 5.29.3
-    perl5292delta      Perl changes in version 5.29.2
-    perl5291delta      Perl changes in version 5.29.1
-    perl5290delta      Perl changes in version 5.29.0
+    perl5373delta      Perl changes in version 5.37.3
+    perl5372delta      Perl changes in version 5.37.2
+    perl5371delta      Perl changes in version 5.37.1
+    perl5370delta      Perl changes in version 5.37.0
+    perl5360delta      Perl changes in version 5.36.0
+    perl5341delta      Perl changes in version 5.34.1
+    perl5340delta      Perl changes in version 5.34.0
+    perl5321delta      Perl changes in version 5.32.1
+    perl5320delta      Perl changes in version 5.32.0
+    perl5303delta      Perl changes in version 5.30.3
+    perl5302delta      Perl changes in version 5.30.2
+    perl5301delta      Perl changes in version 5.30.1
+    perl5300delta      Perl changes in version 5.30.0
+    perl5283delta      Perl changes in version 5.28.3
+    perl5282delta      Perl changes in version 5.28.2
+    perl5281delta      Perl changes in version 5.28.1
     perl5280delta      Perl changes in version 5.28.0
+    perl5263delta      Perl changes in version 5.26.3
     perl5262delta      Perl changes in version 5.26.2
     perl5261delta      Perl changes in version 5.26.1
     perl5260delta      Perl changes in version 5.26.0
@@ -239,6 +250,13 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
     perl5005delta      Perl changes in version 5.005
     perl5004delta      Perl changes in version 5.004
 
+=head2 Miscellaneous
+
+    perlbook           Perl book information
+    perlcommunity      Perl community information
+
+    perldoc            Look up Perl documentation in Pod format
+
     perlexperiment     A listing of experimental features in Perl
 
     perlartistic       Perl Artistic License
@@ -248,7 +266,7 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
 
 =for buildtoc flag +r
 
-    perlcn             Perl for Simplified Chinese (in EUC-CN)
+    perlcn             Perl for Simplified Chinese (in UTF-8)
     perljp             Perl for Japanese (in EUC-JP)
     perlko             Perl for Korean (in EUC-KR)
     perltw             Perl for Traditional Chinese (in Big5)
@@ -259,18 +277,14 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
     perlamiga          Perl notes for AmigaOS
     perlandroid                Perl notes for Android
     perlbs2000         Perl notes for POSIX-BC BS2000
-    perlce             Perl notes for WinCE
     perlcygwin         Perl notes for Cygwin
-    perldos            Perl notes for DOS
     perlfreebsd        Perl notes for FreeBSD
     perlhaiku          Perl notes for Haiku
     perlhpux           Perl notes for HP-UX
     perlhurd           Perl notes for Hurd
     perlirix           Perl notes for Irix
     perllinux          Perl notes for Linux
-    perlmacos          Perl notes for Mac OS (Classic)
     perlmacosx         Perl notes for Mac OS X
-    perlnetware        Perl notes for NetWare
     perlopenbsd        Perl notes for OpenBSD
     perlos2            Perl notes for OS/2
     perlos390          Perl notes for OS/390
@@ -279,7 +293,6 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
     perlqnx            Perl notes for QNX
     perlriscos         Perl notes for RISC OS
     perlsolaris        Perl notes for Solaris
-    perlsymbian        Perl notes for Symbian
     perlsynology       Perl notes for Synology
     perltru64          Perl notes for Tru64
     perlvms            Perl notes for VMS
@@ -305,8 +318,8 @@ available as manpages for use with the F<man> program.
 Some documentation is not available as man pages, so if a
 cross-reference is not found by man, try it with L<perldoc>.  Perldoc can
 also take you directly to documentation for functions (with the B<-f>
-switch). See C<perldoc --help> (or C<perldoc perldoc> or C<man perldoc>)
-for other helpful options L<perldoc> has to offer.
+switch). See S<C<perldoc --help>> (or S<C<perldoc perldoc>> or
+S<C<man perldoc>>) for other helpful options L<perldoc> has to offer.
 
 In general, if something strange has gone wrong with your program and you're
 not sure where you should look for help, try making your code comply with
@@ -351,7 +364,7 @@ for a listing.
 
 =head1 ENVIRONMENT
 
-See L<perlrun>.
+See L<perlrun/ENVIRONMENT>.
 
 =head1 AUTHOR
 
@@ -371,19 +384,22 @@ see L<perlvar> for more information.
 
 =head1 SEE ALSO
 
- http://www.perl.org/       the Perl homepage
- http://www.perl.com/       Perl articles (O'Reilly)
- http://www.cpan.org/       the Comprehensive Perl Archive
- http://www.pm.org/         the Perl Mongers
+ https://www.perl.org/       the Perl homepage
+ https://www.perl.com/       Perl articles
+ https://www.cpan.org/       the Comprehensive Perl Archive
+ https://www.pm.org/         the Perl Mongers
 
 =head1 DIAGNOSTICS
 
 Using the C<use strict> pragma ensures that all variables are properly
 declared and prevents other misuses of legacy Perl features.
+These are enabled by default within the scope of
+C<L<use v5.12|perlfunc/use VERSION>> (or higher).
 
-The C<use warnings> pragma produces some lovely diagnostics. One can
-also use the B<-w> flag, but its use is normally discouraged, because
-it gets applied to all executed Perl code, including that not under
+The C<use warnings> pragma produces some lovely diagnostics.
+It is enabled by default when you say C<use v5.35> (or higher).
+One can also use the B<-w> flag, but its use is normally discouraged,
+because it gets applied to all executed Perl code, including that not under
 your control.
 
 See L<perldiag> for explanations of all Perl's diagnostics.  The C<use
@@ -420,11 +436,9 @@ displayed by diagnostics are internally stored as short integers,
 so they are limited to a maximum of 65535 (higher numbers usually being
 affected by wraparound).
 
-You may mail your bug reports (be sure to include full configuration
+You may submit your bug reports (be sure to include full configuration
 information as output by the myconfig program in the perl source
-tree, or by C<perl -V>) to perlbug@perl.org .  If you've succeeded
-in compiling perl, the L<perlbug> script in the F<utils/> subdirectory
-can be used to help mail in a bug report.
+tree, or by C<perl -V>) to L<https://github.com/Perl/perl5/issues>.
 
 Perl actually stands for Pathologically Eclectic Rubbish Lister, but
 don't tell anyone I said that.