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 f63b84a..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
@@ -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,25 +172,38 @@ 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
-    perl5275delta      Perl changes in version 5.27.5
-    perl5274delta      Perl changes in version 5.27.4
-    perl5273delta      Perl changes in version 5.27.3
-    perl5272delta      Perl changes in version 5.27.2
-    perl5271delta      Perl changes in version 5.27.1
-    perl5270delta      Perl changes in version 5.27.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
@@ -238,6 +253,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
@@ -247,7 +269,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)
@@ -258,7 +280,6 @@ 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
@@ -278,7 +299,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
@@ -350,7 +370,7 @@ for a listing.
 
 =head1 ENVIRONMENT
 
-See L<perlrun>.
+See L<perlrun/ENVIRONMENT>.
 
 =head1 AUTHOR
 
@@ -370,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
 
@@ -419,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.