This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlexperiment: document the private_use experiment
[perl5.git] / pod / perl.pod
index 09ee08f..116083e 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
@@ -44,7 +44,7 @@ path perlglossary            cpan/perlfaq/lib/
 path perlxs(?:tut|typemap)?  dist/ExtUtils-ParseXS/lib/
 path perldoc                 cpan/Pod-Perldoc/
 
-aux c2ph h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
+aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp
 
 =end buildtoc
 
@@ -96,8 +96,10 @@ aux c2ph 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
     perllexwarn        Perl warnings and their control
     perldebug          Perl debugging
     perlvar            Perl predefined variables
@@ -128,6 +130,7 @@ aux c2ph 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
@@ -169,23 +172,44 @@ aux c2ph 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
-    perl5254delta      Perl changes in version 5.25.4
-    perl5253delta      Perl changes in version 5.25.3
-    perl5252delta      Perl changes in version 5.25.2
-    perl5251delta      Perl changes in version 5.25.1
-    perl5250delta      Perl changes in version 5.25.0
+    perl5339delta      Perl changes in version 5.33.9
+    perl5338delta      Perl changes in version 5.33.8
+    perl5337delta      Perl changes in version 5.33.7
+    perl5336delta      Perl changes in version 5.33.6
+    perl5335delta      Perl changes in version 5.33.5
+    perl5334delta      Perl changes in version 5.33.4
+    perl5333delta      Perl changes in version 5.33.3
+    perl5332delta      Perl changes in version 5.33.2
+    perl5331delta      Perl changes in version 5.33.1
+    perl5330delta      Perl changes in version 5.33.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
+    perl5244delta      Perl changes in version 5.24.4
+    perl5243delta      Perl changes in version 5.24.3
+    perl5242delta      Perl changes in version 5.24.2
+    perl5241delta      Perl changes in version 5.24.1
     perl5240delta      Perl changes in version 5.24.0
+    perl5224delta      Perl changes in version 5.22.4
+    perl5223delta      Perl changes in version 5.22.3
     perl5222delta      Perl changes in version 5.22.2
     perl5221delta      Perl changes in version 5.22.1
     perl5220delta      Perl changes in version 5.22.0
@@ -229,6 +253,13 @@ aux c2ph 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
@@ -238,7 +269,7 @@ aux c2ph 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)
@@ -249,7 +280,6 @@ aux c2ph 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
@@ -269,7 +299,6 @@ aux c2ph 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
@@ -341,7 +370,7 @@ for a listing.
 
 =head1 ENVIRONMENT
 
-See L<perlrun>.
+See L<perlrun/ENVIRONMENT>.
 
 =head1 AUTHOR
 
@@ -361,10 +390,10 @@ 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
 
@@ -410,11 +439,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.