mirror of
https://github.com/Perl/perl5.git
synced 2026-01-26 08:38:23 +00:00
Remove full stops from POD headings
Headings are not sentences and should not have a trailing full stop unless the last word is an abbreviation or as part of an ellipsis.
This commit is contained in:
parent
eec4172ad6
commit
c60ffc18d9
@ -1088,7 +1088,7 @@ L<Announced on 2019-03-21 by Zak Elep|https://www.nntp.perl.org/group/perl.perl5
|
||||
|
||||
L<Announced on 2019-02-20 by Atoomic|https://www.nntp.perl.org/group/perl.perl5.porters/2019/02/msg253750.html>
|
||||
|
||||
=head2 v5.29.7 - Edsger W. Dijkstra: "Programming Considered as a Human Activity", IFIP Congress, New York, 1965.
|
||||
=head2 v5.29.7 - Edsger W. Dijkstra: "Programming Considered as a Human Activity", IFIP Congress, New York, 1965
|
||||
|
||||
L<Announced on 2019-01-20 by Abigail|https://www.nntp.perl.org/group/perl.perl5.porters/2019/01/msg253444.html>
|
||||
|
||||
@ -2425,7 +2425,7 @@ L<Announced on 2015-12-21 by David Golden|http://www.nntp.perl.org/group/perl.pe
|
||||
that could splinter the Republic forever and usher in
|
||||
a new Empire of gradual typing....
|
||||
|
||||
=head2 v5.23.5 - utastro!nather (Ed Nather), "The Story of Mel", in net.jokes, May 21, 1983.
|
||||
=head2 v5.23.5 - utastro!nather (Ed Nather), "The Story of Mel", in net.jokes, May 21, 1983
|
||||
|
||||
L<Announced on 2015-11-20 by Abigail|http://www.nntp.perl.org/group/perl.perl5.porters/2015/11/msg232758.html>
|
||||
|
||||
|
||||
@ -272,7 +272,7 @@ should be updated?)]
|
||||
We should never release a main version without testing it as a
|
||||
subversion first.
|
||||
|
||||
=head2 Test popular applications and modules.
|
||||
=head2 Test popular applications and modules
|
||||
|
||||
We should never release a main version without testing whether or not
|
||||
it breaks various popular modules and applications. A partial list of
|
||||
|
||||
@ -678,7 +678,7 @@ F<dist/Module-CoreList/lib/Module/CoreList/Utils.pm>
|
||||
|
||||
=back
|
||||
|
||||
=head4 Update C<Module::CoreList> with module version data for the new release.
|
||||
=head4 Update C<Module::CoreList> with module version data for the new release
|
||||
|
||||
Note that if this is a MAINT release, you should run the following actions
|
||||
from the maint branch, but commit the C<CoreList.pm> changes in
|
||||
|
||||
@ -475,7 +475,7 @@ should be done "correctly".
|
||||
|
||||
=back
|
||||
|
||||
=head2 C<``> and pipe-C<open> do not work under DOS.
|
||||
=head2 C<``> and pipe-C<open> do not work under DOS
|
||||
|
||||
This may a variant of just L</"I cannot run external programs">, or a
|
||||
deeper problem. Basically: you I<need> RSX (see L</Prerequisites>)
|
||||
@ -1549,7 +1549,7 @@ Here is the sample C file:
|
||||
|
||||
=head1 Build FAQ
|
||||
|
||||
=head2 Some C</> became C<\> in pdksh.
|
||||
=head2 Some C</> became C<\> in pdksh
|
||||
|
||||
You have a very old pdksh. See L</Prerequisites>.
|
||||
|
||||
|
||||
@ -75,7 +75,7 @@ Note also that the perl command-line utilities (e.g. perldoc) and any
|
||||
that are added by modules that you install will be under
|
||||
/usr/perl5/bin, so that directory should be added to your PATH.
|
||||
|
||||
=head2 Solaris Version Numbers.
|
||||
=head2 Solaris Version Numbers
|
||||
|
||||
For consistency with common usage, perl's Configure script performs
|
||||
some minor manipulations on the operating system name and version
|
||||
@ -122,7 +122,7 @@ All Solaris documentation is available on-line at L<http://docs.sun.com/>.
|
||||
|
||||
=head1 SETTING UP
|
||||
|
||||
=head2 File Extraction Problems on Solaris.
|
||||
=head2 File Extraction Problems on Solaris
|
||||
|
||||
Be sure to use a tar program compiled under Solaris (not SunOS 4.x)
|
||||
to extract the perl-5.x.x.tar.gz file. Do not use GNU tar compiled
|
||||
@ -134,13 +134,13 @@ If you found this advice too late and used a SunOS4-compiled tar
|
||||
anyway, you must find the incorrectly renamed file and move it back
|
||||
to lib/locale.pm.
|
||||
|
||||
=head2 Compiler and Related Tools on Solaris.
|
||||
=head2 Compiler and Related Tools on Solaris
|
||||
|
||||
You must use an ANSI C compiler to build perl. Perl can be compiled
|
||||
with either Sun's add-on C compiler or with gcc. The C compiler that
|
||||
shipped with SunOS4 will not do.
|
||||
|
||||
=head3 Include /usr/ccs/bin/ in your PATH.
|
||||
=head3 Include /usr/ccs/bin/ in your PATH
|
||||
|
||||
Several tools needed to build perl are located in /usr/ccs/bin/: ar,
|
||||
as, ld, and make. Make sure that /usr/ccs/bin/ is in your PATH.
|
||||
@ -175,7 +175,7 @@ This will display a line like this:
|
||||
|
||||
The last item listed (SUNWhea in this example) is the package you need.
|
||||
|
||||
=head3 Avoid /usr/ucb/cc.
|
||||
=head3 Avoid /usr/ucb/cc
|
||||
|
||||
You don't need to have /usr/ucb/ in your PATH to build perl. If you
|
||||
want /usr/ucb/ in your PATH anyway, make sure that /usr/ucb/ is NOT
|
||||
@ -279,7 +279,7 @@ the set-group-id bit is not set. If it is, then arrange your PATH so
|
||||
that /usr/ccs/bin/make is before GNU make or else have the system
|
||||
administrator disable the set-group-id bit on GNU make.
|
||||
|
||||
=head3 Avoid libucb.
|
||||
=head3 Avoid libucb
|
||||
|
||||
Solaris provides some BSD-compatibility functions in /usr/ucblib/libucb.a.
|
||||
Perl will not build and run correctly if linked against -lucb since it
|
||||
@ -319,13 +319,13 @@ interception failed' errors! The runtime linker intercepts links to
|
||||
"/usr/lib/libdl.so.1.0" and links in internal implementations of those
|
||||
functions instead. [Thanks to Tim Bunce for this explanation.]
|
||||
|
||||
=head1 RUN CONFIGURE.
|
||||
=head1 RUN CONFIGURE
|
||||
|
||||
See the INSTALL file for general information regarding Configure.
|
||||
Only Solaris-specific issues are discussed here. Usually, the
|
||||
defaults should be fine.
|
||||
|
||||
=head2 64-bit perl on Solaris.
|
||||
=head2 64-bit perl on Solaris
|
||||
|
||||
See the INSTALL file for general information regarding 64-bit compiles.
|
||||
In general, the defaults should be fine for most people.
|
||||
@ -333,7 +333,7 @@ In general, the defaults should be fine for most people.
|
||||
By default, perl-5.6.0 (or later) is compiled as a 32-bit application
|
||||
with largefile and long-long support.
|
||||
|
||||
=head3 General 32-bit vs. 64-bit issues.
|
||||
=head3 General 32-bit vs. 64-bit issues
|
||||
|
||||
Solaris 7 and above will run in either 32 bit or 64 bit mode on SPARC
|
||||
CPUs, via a reboot. You can build 64 bit apps whilst running 32 bit
|
||||
@ -450,17 +450,17 @@ in that release:
|
||||
All this should be handled automatically by the hints file, if
|
||||
requested.
|
||||
|
||||
=head3 Long Doubles.
|
||||
=head3 Long Doubles
|
||||
|
||||
As of 5.8.1, long doubles are working if you use the Sun compilers
|
||||
(needed for additional math routines not included in libm).
|
||||
|
||||
=head2 Threads in perl on Solaris.
|
||||
=head2 Threads in perl on Solaris
|
||||
|
||||
It is possible to build a threaded version of perl on Solaris. The entire
|
||||
perl thread implementation is still experimental, however, so beware.
|
||||
|
||||
=head2 Malloc Issues with perl on Solaris.
|
||||
=head2 Malloc Issues with perl on Solaris
|
||||
|
||||
Starting from perl 5.7.1 perl uses the Solaris malloc, since the perl
|
||||
malloc breaks when dealing with more than 2GB of memory, and the Solaris
|
||||
@ -478,7 +478,7 @@ appears to go away under -DDEBUGGING, so it has been difficult to
|
||||
track down. Sun's compiler appears to be okay with or without perl's
|
||||
malloc. [XXX further investigation is needed here.]
|
||||
|
||||
=head1 MAKE PROBLEMS.
|
||||
=head1 MAKE PROBLEMS
|
||||
|
||||
=over 4
|
||||
|
||||
@ -546,7 +546,7 @@ Solaris x86 looks something like this:
|
||||
|
||||
The lddlflags addition is the only abnormal bit.
|
||||
|
||||
=head1 PREBUILT BINARIES OF PERL FOR SOLARIS.
|
||||
=head1 PREBUILT BINARIES OF PERL FOR SOLARIS
|
||||
|
||||
You can pick up prebuilt binaries for Solaris from
|
||||
L<http://www.sunfreeware.com/>, L<http://www.blastwave.org>,
|
||||
@ -556,9 +556,9 @@ page. There are probably other sources as well. Please note that
|
||||
these sites are under the control of their respective owners, not the
|
||||
perl developers.
|
||||
|
||||
=head1 RUNTIME ISSUES FOR PERL ON SOLARIS.
|
||||
=head1 RUNTIME ISSUES FOR PERL ON SOLARIS
|
||||
|
||||
=head2 Limits on Numbers of Open Files on Solaris.
|
||||
=head2 Limits on Numbers of Open Files on Solaris
|
||||
|
||||
The stdio(3C) manpage notes that for LP32 applications, only 255
|
||||
files may be opened using fopen(), and only file descriptors 0
|
||||
@ -571,13 +571,13 @@ also that the default resource limit for open file descriptors on
|
||||
Solaris is 255, so you will have to modify your ulimit or rctl
|
||||
(Solaris 9 onwards) appropriately.
|
||||
|
||||
=head1 SOLARIS-SPECIFIC MODULES.
|
||||
=head1 SOLARIS-SPECIFIC MODULES
|
||||
|
||||
See the modules under the Solaris:: and Sun::Solaris namespaces on CPAN,
|
||||
see L<http://www.cpan.org/modules/by-module/Solaris/> and
|
||||
L<http://www.cpan.org/modules/by-module/Sun/>.
|
||||
|
||||
=head1 SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
|
||||
=head1 SOLARIS-SPECIFIC PROBLEMS WITH MODULES
|
||||
|
||||
=head2 Proc::ProcessTable on Solaris
|
||||
|
||||
|
||||
6
dist/SelfLoader/lib/SelfLoader.pm
vendored
6
dist/SelfLoader/lib/SelfLoader.pm
vendored
@ -2,7 +2,7 @@ package SelfLoader;
|
||||
use 5.008;
|
||||
use strict;
|
||||
use IO::Handle;
|
||||
our $VERSION = "1.26";
|
||||
our $VERSION = "1.27";
|
||||
|
||||
# The following bit of eval-magic is necessary to make this work on
|
||||
# perls < 5.009005.
|
||||
@ -294,7 +294,7 @@ to parse the code after the C<__DATA__>. Details of the B<AutoLoader> and
|
||||
another view of these distinctions can be found in that module's
|
||||
documentation.
|
||||
|
||||
=head2 __DATA__, __END__, and the FOOBAR::DATA filehandle.
|
||||
=head2 __DATA__, __END__, and the FOOBAR::DATA filehandle
|
||||
|
||||
This section is only relevant if you want to use
|
||||
the C<FOOBAR::DATA> together with the B<SelfLoader>.
|
||||
@ -328,7 +328,7 @@ declarations.
|
||||
|
||||
You could conceivably do both.
|
||||
|
||||
=head2 Classes and inherited methods.
|
||||
=head2 Classes and inherited methods
|
||||
|
||||
For modules which are not classes, this section is not relevant.
|
||||
This section is only relevant if you have methods which could
|
||||
|
||||
@ -42,7 +42,7 @@ our @EXPORT_OK = qw(
|
||||
BEGIN {
|
||||
# make sure all our XS routines are available early so their prototypes
|
||||
# are correctly applied in the following code.
|
||||
our $VERSION = '0.30';
|
||||
our $VERSION = '0.31';
|
||||
require XSLoader;
|
||||
XSLoader::load();
|
||||
}
|
||||
@ -782,7 +782,7 @@ may not be allocated even though this value will be non-zero.)
|
||||
|
||||
=back
|
||||
|
||||
=head2 Operating on references to hashes.
|
||||
=head2 Operating on references to hashes
|
||||
|
||||
Most subroutines documented in this module have equivalent versions
|
||||
that operate on references to hashes instead of native hashes.
|
||||
|
||||
@ -14,7 +14,7 @@ over from perl4.
|
||||
Please report any problems or suggested changes at
|
||||
L<https://github.com/Perl/perl5/issues>.
|
||||
|
||||
=head1 Hint file naming convention.
|
||||
=head1 Hint file naming convention
|
||||
|
||||
Each hint file name should have only
|
||||
one '.'. (This is for portability to non-unix file systems.) Names
|
||||
|
||||
@ -532,7 +532,7 @@ BEGIN {
|
||||
use vars qw($VERSION $header);
|
||||
|
||||
# bump to X.XX in blead, only use X.XX_XX in maint
|
||||
$VERSION = '1.79';
|
||||
$VERSION = '1.80';
|
||||
|
||||
$header = "perl5db.pl version $VERSION";
|
||||
|
||||
@ -3227,7 +3227,7 @@ Just uses C<DB::methods> to determine what methods are available.
|
||||
|
||||
Switch to a different filename.
|
||||
|
||||
=head4 C<.> - return to last-executed line.
|
||||
=head4 C<.> - return to last-executed line
|
||||
|
||||
We set C<$incr> to -1 to indicate that the debugger shouldn't move ahead,
|
||||
and then we look up the line in the magical C<%dbline> hash.
|
||||
@ -3293,11 +3293,11 @@ appropriately, and force us out of the command loop.
|
||||
|
||||
Just calls C<DB::print_trace>.
|
||||
|
||||
=head4 C<w> - List window around current line.
|
||||
=head4 C<w> - List window around current line
|
||||
|
||||
Just calls C<DB::cmd_w>.
|
||||
|
||||
=head4 C<W> - watch-expression processing.
|
||||
=head4 C<W> - watch-expression processing
|
||||
|
||||
Just calls C<DB::cmd_W>.
|
||||
|
||||
@ -3381,7 +3381,7 @@ the bottom of the loop.
|
||||
|
||||
Manipulates C<%alias> to add or list command aliases.
|
||||
|
||||
=head4 C<source> - read commands from a file.
|
||||
=head4 C<source> - read commands from a file
|
||||
|
||||
Opens a lexical filehandle and stacks it on C<@cmdfhs>; C<DB::readline> will
|
||||
pick it up.
|
||||
@ -3405,7 +3405,7 @@ Restart the debugger session.
|
||||
|
||||
Return to any given position in the B<true>-history list
|
||||
|
||||
=head4 C<|, ||> - pipe output through the pager.
|
||||
=head4 C<|, ||> - pipe output through the pager
|
||||
|
||||
For C<|>, we save C<OUT> (the debugger's output filehandle) and C<STDOUT>
|
||||
(the program's standard output). For C<||>, we only save C<OUT>. We open a
|
||||
@ -9413,7 +9413,7 @@ If there's only one hit, and it's a package qualifier, and it's not equal to the
|
||||
|
||||
=back
|
||||
|
||||
=head3 Symbol completion: current package or package C<main>.
|
||||
=head3 Symbol completion: current package or package C<main>
|
||||
|
||||
=cut
|
||||
|
||||
@ -9973,7 +9973,7 @@ sub cmd_pre580_null {
|
||||
# do nothing...
|
||||
}
|
||||
|
||||
=head2 Old C<a> command.
|
||||
=head2 Old C<a> command
|
||||
|
||||
This version added actions if you supplied them, and deleted them
|
||||
if you didn't.
|
||||
@ -10082,7 +10082,7 @@ sub cmd_pre580_b {
|
||||
}
|
||||
} ## end sub cmd_pre580_b
|
||||
|
||||
=head2 Old C<D> command.
|
||||
=head2 Old C<D> command
|
||||
|
||||
Delete all breakpoints unconditionally.
|
||||
|
||||
|
||||
@ -21,7 +21,7 @@ scheme.
|
||||
|
||||
=head1 Incompatible Changes
|
||||
|
||||
=head2 WARNING: This version is not binary compatible with Perl 5.004.
|
||||
=head2 WARNING: This version is not binary compatible with Perl 5.004
|
||||
|
||||
Starting with Perl 5.004_50 there were many deep and far-reaching changes
|
||||
to the language internals. If you have dynamically loaded extensions
|
||||
|
||||
@ -20,7 +20,7 @@ L<perl5124delta>, which describes differences between 5.12.3 and
|
||||
A bug in C<Encode> could, on certain inputs, cause the heap to overflow.
|
||||
This problem has been corrected. Bug reported by Robert Zacek.
|
||||
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
|
||||
|
||||
Calling C<File::Glob::bsd_glob> with the unsupported flag GLOB_ALTDIRFUNC would
|
||||
cause an access violation / segfault. A Perl program that accepts a flags value from
|
||||
@ -59,11 +59,11 @@ A regression introduced in Perl 5.8.8 has been fixed, that caused
|
||||
C<charnames::viacode(0)> to return C<undef> instead of the string "NULL"
|
||||
[perl #72624].
|
||||
|
||||
=head3 L<Encode> has been upgraded from version 2.39 to version 2.39_01.
|
||||
=head3 L<Encode> has been upgraded from version 2.39 to version 2.39_01
|
||||
|
||||
See L</Security>.
|
||||
|
||||
=head3 L<File::Glob> has been upgraded from version 1.07 to version 1.07_01.
|
||||
=head3 L<File::Glob> has been upgraded from version 1.07 to version 1.07_01
|
||||
|
||||
See L</Security>.
|
||||
|
||||
|
||||
@ -113,7 +113,7 @@ as the latter returns a single code point.
|
||||
|
||||
See L<charnames> for details on all these changes.
|
||||
|
||||
=head3 New warnings categories for problematic (non-)Unicode code points.
|
||||
=head3 New warnings categories for problematic (non-)Unicode code points
|
||||
|
||||
Three new warnings subcategories of "utf8" have been added. These
|
||||
allow you to turn off some "utf8" warnings, while allowing
|
||||
|
||||
@ -19,7 +19,7 @@ No changes since 5.14.0.
|
||||
|
||||
=head1 Security
|
||||
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
|
||||
|
||||
Calling C<File::Glob::bsd_glob> with the unsupported flag GLOB_ALTDIRFUNC would
|
||||
cause an access violation / segfault. A Perl program that accepts a flags value from
|
||||
|
||||
@ -325,7 +325,7 @@ strings.
|
||||
|
||||
Full details are in L<perlfunc/fc>.
|
||||
|
||||
=head3 The Unicode C<Script_Extensions> property is now supported.
|
||||
=head3 The Unicode C<Script_Extensions> property is now supported
|
||||
|
||||
New in Unicode 6.0, this is an improved C<Script> property. Details
|
||||
are in L<perlunicode/Scripts>.
|
||||
@ -514,7 +514,7 @@ C<utf8_to_uvuni_buf()> are now available to prevent this, and the Perl
|
||||
core has been converted to use them.
|
||||
See L</Internal Changes>.
|
||||
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
|
||||
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
|
||||
|
||||
Calling C<File::Glob::bsd_glob> with the unsupported flag
|
||||
GLOB_ALTDIRFUNC would cause an access violation / segfault. A Perl
|
||||
|
||||
@ -290,7 +290,7 @@ behaviors, and since the REPLACEMENT CHARACTER has no use other than as
|
||||
a stand-in for some unknown character, any code that has this problem is
|
||||
buggy.
|
||||
|
||||
=head2 Formerly deprecated characters in C<\N{}> character name aliases are now errors.
|
||||
=head2 Formerly deprecated characters in C<\N{}> character name aliases are now errors
|
||||
|
||||
Since v5.12.0, it has been deprecated to use certain characters in
|
||||
user-defined C<\N{...}> character names. These now cause a syntax
|
||||
|
||||
@ -297,7 +297,7 @@ allowed.
|
||||
|
||||
In prior releases, failure to do this raised a deprecation warning.
|
||||
|
||||
=head2 Splitting the tokens C<(?> and C<(*> in regular expressions is now a fatal compilation error.
|
||||
=head2 Splitting the tokens C<(?> and C<(*> in regular expressions is now a fatal compilation error
|
||||
|
||||
These had been deprecated since v5.18.
|
||||
|
||||
|
||||
@ -205,7 +205,7 @@ L<[GH #14799]|https://github.com/Perl/perl5/issues/14799>
|
||||
|
||||
L<[GH #13548]|https://github.com/Perl/perl5/issues/13548>
|
||||
|
||||
=head2 The C</\C/> character class has been removed.
|
||||
=head2 The C</\C/> character class has been removed
|
||||
|
||||
This regular expression character class was deprecated in v5.20.0 and has
|
||||
produced a deprecation warning since v5.22.0. It is now a compile-time
|
||||
@ -241,7 +241,7 @@ C<$Carp::MaxArgNums> is supposed to be the number of arguments to display.
|
||||
Prior to this version, it was instead showing C<$Carp::MaxArgNums> + 1 arguments,
|
||||
contrary to the documentation.
|
||||
|
||||
=head2 Only blanks and tabs are now allowed within C<[...]> within C<(?[...])>.
|
||||
=head2 Only blanks and tabs are now allowed within C<[...]> within C<(?[...])>
|
||||
|
||||
The experimental Extended Bracketed Character Classes can contain regular
|
||||
bracketed character classes within them. These differ from regular ones in
|
||||
|
||||
@ -450,7 +450,7 @@ The fundamentally unsafe C<tmpnam()> interface was deprecated in
|
||||
Perl 5.22 and has now been removed. In its place, you can use,
|
||||
for example, the L<File::Temp> interfaces.
|
||||
|
||||
=head2 require ::Foo::Bar is now illegal.
|
||||
=head2 require ::Foo::Bar is now illegal
|
||||
|
||||
Formerly, C<require ::Foo::Bar> would try to read F</Foo/Bar.pm>. Now any
|
||||
bareword require which starts with a double colon dies instead.
|
||||
|
||||
@ -90,7 +90,7 @@ rules for use with Turkic languages. Previously, Perl ignored these,
|
||||
but now, it uses them when it detects that it is operating under a
|
||||
Turkic UTF-8 locale.
|
||||
|
||||
=head2 It is now possible to compile perl to always use thread-safe locale operations.
|
||||
=head2 It is now possible to compile perl to always use thread-safe locale operations
|
||||
|
||||
Previously, these calls were only used when the perl was compiled to be
|
||||
multi-threaded. To always enable them, add
|
||||
@ -211,7 +211,7 @@ by default, JSON::PP also enabled allow_nonref by default.
|
||||
|
||||
=head1 Deprecations
|
||||
|
||||
=head2 In XS code, use of various macros dealing with UTF-8.
|
||||
=head2 In XS code, use of various macros dealing with UTF-8
|
||||
|
||||
This deprecation was scheduled to become fatal in 5.30, but has been
|
||||
delayed to 5.32 due to problems that showed up with some CPAN modules.
|
||||
|
||||
@ -35,7 +35,7 @@ script. By default this is not enabled, to be consistent with previous perl
|
||||
releases. To use this, add C<-Dusesitecustomize> to the command line flags
|
||||
when running the C<Configure> script. See also L<perlrun/-f>.
|
||||
|
||||
=head2 C<Config.pm> is now much smaller.
|
||||
=head2 C<Config.pm> is now much smaller
|
||||
|
||||
C<Config.pm> is now about 3K rather than 32K, with the infrequently used
|
||||
code and C<%Config> values loaded on demand. This is transparent to the
|
||||
|
||||
@ -27,7 +27,7 @@ If any exist, they are bugs and reports are welcome.
|
||||
|
||||
=head1 Core Enhancements
|
||||
|
||||
=head2 Unicode Character Database 5.1.0.
|
||||
=head2 Unicode Character Database 5.1.0
|
||||
|
||||
The copy of the Unicode Character Database included in Perl 5.8 has
|
||||
been updated to 5.1.0 from 4.1.0. See
|
||||
@ -1378,7 +1378,7 @@ F<g++> support has been tuned, especially for FreeBSD.
|
||||
F<mkppport> has been integrated, and all F<ppport.h> files in the core will now
|
||||
be autogenerated at build time (and removed during cleanup).
|
||||
|
||||
=head2 Installation improvements.
|
||||
=head2 Installation improvements
|
||||
|
||||
F<installman> now works with C<-Duserelocatableinc> and C<DESTDIR>.
|
||||
|
||||
@ -1954,7 +1954,7 @@ C<PerlIO::scalar>.
|
||||
New error, introduced as part of the fix to RT #40641 to handle encoding
|
||||
of Unicode characters in regular expression comments.
|
||||
|
||||
=head2 Your machine doesn't support dump/undump.
|
||||
=head2 Your machine doesn't support dump/undump
|
||||
|
||||
A more informative fatal error issued when calling C<dump> on Win32 and
|
||||
Cygwin. (Given that the purpose of C<dump> is to abort with a core dump,
|
||||
|
||||
@ -60,7 +60,7 @@ When each filter is called by Perl, a local copy of C<$_> will contain
|
||||
the key or value to be filtered. Filtering is achieved by modifying
|
||||
the contents of C<$_>. The return code from the filter is ignored.
|
||||
|
||||
=head2 An Example: the NULL termination problem.
|
||||
=head2 An Example: the NULL termination problem
|
||||
|
||||
DBM Filters are useful for a class of problems where you I<always>
|
||||
want to make the same transformation to all keys, all values or both.
|
||||
@ -116,7 +116,7 @@ self-explanatory. Both "fetch" filters remove the terminating NULL,
|
||||
and both "store" filters add a terminating NULL.
|
||||
|
||||
|
||||
=head2 Another Example: Key is a C int.
|
||||
=head2 Another Example: Key is a C int
|
||||
|
||||
Here is another real-life example. By default, whenever Perl writes to
|
||||
a DBM database it always writes the key and value as strings. So when
|
||||
|
||||
@ -86,7 +86,7 @@ Perl 5.42.0 production release.
|
||||
|
||||
Category: "deprecated::smartmatch"
|
||||
|
||||
=head3 Use of C<'> as a global name separator.
|
||||
=head3 Use of C<'> as a global name separator
|
||||
|
||||
Perl allows use of C<'> instead of C<::> to replace the parts of a
|
||||
package or global variable name, for example C<A::B> and C<A'B> are
|
||||
@ -230,7 +230,7 @@ C<{> got a deprecation warning. Some cases started warning in Perl 5.26,
|
||||
and were made fatal in Perl 5.30. Other cases started in Perl 5.28,
|
||||
and were made fatal in 5.32.
|
||||
|
||||
=head3 In XS code, use of various macros dealing with UTF-8.
|
||||
=head3 In XS code, use of various macros dealing with UTF-8
|
||||
|
||||
The macros below now require an extra parameter than in versions prior
|
||||
to Perl 5.32. The final parameter in each one is a pointer into the
|
||||
@ -353,7 +353,7 @@ and an unqualified C<dump()> is no longer available as of Perl 5.30.
|
||||
See L<perlfunc/dump>.
|
||||
|
||||
|
||||
=head3 Using my() in false conditional.
|
||||
=head3 Using my() in false conditional
|
||||
|
||||
There has been a long-standing bug in Perl that causes a lexical variable
|
||||
not to be cleared at scope exit when its declaration includes a false
|
||||
@ -384,7 +384,7 @@ The use of C<my()> in a false conditional has been deprecated in
|
||||
Perl 5.10, and became a fatal error in Perl 5.30.
|
||||
|
||||
|
||||
=head3 Reading/writing bytes from/to :utf8 handles.
|
||||
=head3 Reading/writing bytes from/to :utf8 handles
|
||||
|
||||
The sysread(), recv(), syswrite() and send() operators are
|
||||
deprecated on handles that have the C<:utf8> layer, either explicitly, or
|
||||
@ -408,7 +408,7 @@ As of Perl 5.30, it is no longer be possible to use sysread(), recv(),
|
||||
syswrite() or send() to read or send bytes from/to :utf8 handles.
|
||||
|
||||
|
||||
=head3 Use of unassigned code point or non-standalone grapheme for a delimiter.
|
||||
=head3 Use of unassigned code point or non-standalone grapheme for a delimiter
|
||||
|
||||
A grapheme is what appears to a native-speaker of a language to be a
|
||||
character. In Unicode (and hence Perl) a grapheme may actually be
|
||||
@ -480,7 +480,7 @@ You are recommended to change your code to set C<$/> to C<undef> explicitly
|
||||
if you wish to slurp the file.
|
||||
|
||||
|
||||
=head3 Limit on the value of Unicode code points.
|
||||
=head3 Limit on the value of Unicode code points
|
||||
|
||||
Unicode only allows code points up to 0x10FFFF, but Perl allows
|
||||
much larger ones. Up till Perl 5.28, it was allowed to use code
|
||||
@ -501,7 +501,7 @@ than 32-bit ones. For 32-bit integers, C<IV_MAX> equals C<0x7FFFFFFF>,
|
||||
for 64-bit integers, C<IV_MAX> equals C<0x7FFFFFFFFFFFFFFF>.
|
||||
|
||||
|
||||
=head3 Use of comma-less variable list in formats.
|
||||
=head3 Use of comma-less variable list in formats
|
||||
|
||||
It was allowed to use a list of variables in a format, without
|
||||
separating them with commas. This usage has been deprecated
|
||||
@ -527,7 +527,7 @@ throws a fatal error as of Perl 5.28.
|
||||
|
||||
You should be using two different symbols instead.
|
||||
|
||||
=head3 ${^ENCODING} is no longer supported.
|
||||
=head3 ${^ENCODING} is no longer supported
|
||||
|
||||
The special variable C<${^ENCODING}> was used to implement
|
||||
the C<encoding> pragma. Setting this variable to anything other
|
||||
@ -600,7 +600,7 @@ These old, perl3-era utilities have been deprecated in favour of
|
||||
C<< h2xs >> for a long time. As of Perl 5.26, they have been removed.
|
||||
|
||||
|
||||
=head3 Trapping C<< $SIG {__DIE__} >> other than during program exit.
|
||||
=head3 Trapping C<< $SIG {__DIE__} >> other than during program exit
|
||||
|
||||
The C<$SIG{__DIE__}> hook is called even inside an C<eval()>. It was
|
||||
never intended to happen this way, but an implementation glitch made
|
||||
|
||||
@ -1518,7 +1518,7 @@ The sort order will cause differences between results obtained on
|
||||
ASCII platforms versus EBCDIC platforms. What follows are some suggestions
|
||||
on how to deal with these differences.
|
||||
|
||||
=head2 Ignore ASCII vs. EBCDIC sort differences.
|
||||
=head2 Ignore ASCII vs. EBCDIC sort differences
|
||||
|
||||
This is the least computationally expensive strategy. It may require
|
||||
some user education.
|
||||
@ -1587,7 +1587,7 @@ Unicode-enabled Perl, do:
|
||||
tr/ÿ/\x{178}/;
|
||||
tr/µ/\x{39C}/;
|
||||
|
||||
=head2 Perform sorting on one type of platform only.
|
||||
=head2 Perform sorting on one type of platform only
|
||||
|
||||
This strategy can employ a network connection. As such
|
||||
it would be computationally expensive.
|
||||
|
||||
@ -233,7 +233,7 @@ thus:
|
||||
In this way (as for perl's scalars) a pointer to a PerlIOBuf can be
|
||||
treated as a pointer to a PerlIOl.
|
||||
|
||||
=head2 Layers in action.
|
||||
=head2 Layers in action
|
||||
|
||||
table perlio unix
|
||||
| |
|
||||
|
||||
@ -106,7 +106,7 @@ exact science, and why we love using Perl so much - TMTOWTDI.
|
||||
|
||||
Here are a few examples to demonstrate usage of Perl's benchmarking tools.
|
||||
|
||||
=head2 Assigning and Dereferencing Variables.
|
||||
=head2 Assigning and Dereferencing Variables
|
||||
|
||||
I'm sure most of us have seen code which looks like, (or worse than), this:
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user