Skip to content

Commit c60ffc1

Browse files
committed
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.
1 parent eec4172 commit c60ffc1

26 files changed

+73
-73
lines changed

Porting/epigraphs.pod

+2-2
Original file line numberDiff line numberDiff line change
@@ -1088,7 +1088,7 @@ L<Announced on 2019-03-21 by Zak Elep|https://www.nntp.perl.org/group/perl.perl5
10881088

10891089
L<Announced on 2019-02-20 by Atoomic|https://www.nntp.perl.org/group/perl.perl5.porters/2019/02/msg253750.html>
10901090

1091-
=head2 v5.29.7 - Edsger W. Dijkstra: "Programming Considered as a Human Activity", IFIP Congress, New York, 1965.
1091+
=head2 v5.29.7 - Edsger W. Dijkstra: "Programming Considered as a Human Activity", IFIP Congress, New York, 1965
10921092

10931093
L<Announced on 2019-01-20 by Abigail|https://www.nntp.perl.org/group/perl.perl5.porters/2019/01/msg253444.html>
10941094

@@ -2425,7 +2425,7 @@ L<Announced on 2015-12-21 by David Golden|http://www.nntp.perl.org/group/perl.pe
24252425
that could splinter the Republic forever and usher in
24262426
a new Empire of gradual typing....
24272427

2428-
=head2 v5.23.5 - utastro!nather (Ed Nather), "The Story of Mel", in net.jokes, May 21, 1983.
2428+
=head2 v5.23.5 - utastro!nather (Ed Nather), "The Story of Mel", in net.jokes, May 21, 1983
24292429

24302430
L<Announced on 2015-11-20 by Abigail|http://www.nntp.perl.org/group/perl.perl5.porters/2015/11/msg232758.html>
24312431

Porting/pumpkin.pod

+1-1
Original file line numberDiff line numberDiff line change
@@ -272,7 +272,7 @@ should be updated?)]
272272
We should never release a main version without testing it as a
273273
subversion first.
274274

275-
=head2 Test popular applications and modules.
275+
=head2 Test popular applications and modules
276276

277277
We should never release a main version without testing whether or not
278278
it breaks various popular modules and applications. A partial list of

Porting/release_managers_guide.pod

+1-1
Original file line numberDiff line numberDiff line change
@@ -678,7 +678,7 @@ F<dist/Module-CoreList/lib/Module/CoreList/Utils.pm>
678678

679679
=back
680680

681-
=head4 Update C<Module::CoreList> with module version data for the new release.
681+
=head4 Update C<Module::CoreList> with module version data for the new release
682682

683683
Note that if this is a MAINT release, you should run the following actions
684684
from the maint branch, but commit the C<CoreList.pm> changes in

README.os2

+2-2
Original file line numberDiff line numberDiff line change
@@ -475,7 +475,7 @@ should be done "correctly".
475475

476476
=back
477477

478-
=head2 C<``> and pipe-C<open> do not work under DOS.
478+
=head2 C<``> and pipe-C<open> do not work under DOS
479479

480480
This may a variant of just L</"I cannot run external programs">, or a
481481
deeper problem. Basically: you I<need> RSX (see L</Prerequisites>)
@@ -1549,7 +1549,7 @@ Here is the sample C file:
15491549

15501550
=head1 Build FAQ
15511551

1552-
=head2 Some C</> became C<\> in pdksh.
1552+
=head2 Some C</> became C<\> in pdksh
15531553

15541554
You have a very old pdksh. See L</Prerequisites>.
15551555

README.solaris

+18-18
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ Note also that the perl command-line utilities (e.g. perldoc) and any
7575
that are added by modules that you install will be under
7676
/usr/perl5/bin, so that directory should be added to your PATH.
7777

78-
=head2 Solaris Version Numbers.
78+
=head2 Solaris Version Numbers
7979

8080
For consistency with common usage, perl's Configure script performs
8181
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/>.
122122

123123
=head1 SETTING UP
124124

125-
=head2 File Extraction Problems on Solaris.
125+
=head2 File Extraction Problems on Solaris
126126

127127
Be sure to use a tar program compiled under Solaris (not SunOS 4.x)
128128
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
134134
anyway, you must find the incorrectly renamed file and move it back
135135
to lib/locale.pm.
136136

137-
=head2 Compiler and Related Tools on Solaris.
137+
=head2 Compiler and Related Tools on Solaris
138138

139139
You must use an ANSI C compiler to build perl. Perl can be compiled
140140
with either Sun's add-on C compiler or with gcc. The C compiler that
141141
shipped with SunOS4 will not do.
142142

143-
=head3 Include /usr/ccs/bin/ in your PATH.
143+
=head3 Include /usr/ccs/bin/ in your PATH
144144

145145
Several tools needed to build perl are located in /usr/ccs/bin/: ar,
146146
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:
175175

176176
The last item listed (SUNWhea in this example) is the package you need.
177177

178-
=head3 Avoid /usr/ucb/cc.
178+
=head3 Avoid /usr/ucb/cc
179179

180180
You don't need to have /usr/ucb/ in your PATH to build perl. If you
181181
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
279279
that /usr/ccs/bin/make is before GNU make or else have the system
280280
administrator disable the set-group-id bit on GNU make.
281281

282-
=head3 Avoid libucb.
282+
=head3 Avoid libucb
283283

284284
Solaris provides some BSD-compatibility functions in /usr/ucblib/libucb.a.
285285
Perl will not build and run correctly if linked against -lucb since it
@@ -319,21 +319,21 @@ interception failed' errors! The runtime linker intercepts links to
319319
"/usr/lib/libdl.so.1.0" and links in internal implementations of those
320320
functions instead. [Thanks to Tim Bunce for this explanation.]
321321

322-
=head1 RUN CONFIGURE.
322+
=head1 RUN CONFIGURE
323323

324324
See the INSTALL file for general information regarding Configure.
325325
Only Solaris-specific issues are discussed here. Usually, the
326326
defaults should be fine.
327327

328-
=head2 64-bit perl on Solaris.
328+
=head2 64-bit perl on Solaris
329329

330330
See the INSTALL file for general information regarding 64-bit compiles.
331331
In general, the defaults should be fine for most people.
332332

333333
By default, perl-5.6.0 (or later) is compiled as a 32-bit application
334334
with largefile and long-long support.
335335

336-
=head3 General 32-bit vs. 64-bit issues.
336+
=head3 General 32-bit vs. 64-bit issues
337337

338338
Solaris 7 and above will run in either 32 bit or 64 bit mode on SPARC
339339
CPUs, via a reboot. You can build 64 bit apps whilst running 32 bit
@@ -450,17 +450,17 @@ in that release:
450450
All this should be handled automatically by the hints file, if
451451
requested.
452452

453-
=head3 Long Doubles.
453+
=head3 Long Doubles
454454

455455
As of 5.8.1, long doubles are working if you use the Sun compilers
456456
(needed for additional math routines not included in libm).
457457

458-
=head2 Threads in perl on Solaris.
458+
=head2 Threads in perl on Solaris
459459

460460
It is possible to build a threaded version of perl on Solaris. The entire
461461
perl thread implementation is still experimental, however, so beware.
462462

463-
=head2 Malloc Issues with perl on Solaris.
463+
=head2 Malloc Issues with perl on Solaris
464464

465465
Starting from perl 5.7.1 perl uses the Solaris malloc, since the perl
466466
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
478478
track down. Sun's compiler appears to be okay with or without perl's
479479
malloc. [XXX further investigation is needed here.]
480480

481-
=head1 MAKE PROBLEMS.
481+
=head1 MAKE PROBLEMS
482482

483483
=over 4
484484

@@ -546,7 +546,7 @@ Solaris x86 looks something like this:
546546

547547
The lddlflags addition is the only abnormal bit.
548548

549-
=head1 PREBUILT BINARIES OF PERL FOR SOLARIS.
549+
=head1 PREBUILT BINARIES OF PERL FOR SOLARIS
550550

551551
You can pick up prebuilt binaries for Solaris from
552552
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
556556
these sites are under the control of their respective owners, not the
557557
perl developers.
558558

559-
=head1 RUNTIME ISSUES FOR PERL ON SOLARIS.
559+
=head1 RUNTIME ISSUES FOR PERL ON SOLARIS
560560

561-
=head2 Limits on Numbers of Open Files on Solaris.
561+
=head2 Limits on Numbers of Open Files on Solaris
562562

563563
The stdio(3C) manpage notes that for LP32 applications, only 255
564564
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
571571
Solaris is 255, so you will have to modify your ulimit or rctl
572572
(Solaris 9 onwards) appropriately.
573573

574-
=head1 SOLARIS-SPECIFIC MODULES.
574+
=head1 SOLARIS-SPECIFIC MODULES
575575

576576
See the modules under the Solaris:: and Sun::Solaris namespaces on CPAN,
577577
see L<http://www.cpan.org/modules/by-module/Solaris/> and
578578
L<http://www.cpan.org/modules/by-module/Sun/>.
579579

580-
=head1 SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
580+
=head1 SOLARIS-SPECIFIC PROBLEMS WITH MODULES
581581

582582
=head2 Proc::ProcessTable on Solaris
583583

dist/SelfLoader/lib/SelfLoader.pm

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ package SelfLoader;
22
use 5.008;
33
use strict;
44
use IO::Handle;
5-
our $VERSION = "1.26";
5+
our $VERSION = "1.27";
66

77
# The following bit of eval-magic is necessary to make this work on
88
# perls < 5.009005.
@@ -294,7 +294,7 @@ to parse the code after the C<__DATA__>. Details of the B<AutoLoader> and
294294
another view of these distinctions can be found in that module's
295295
documentation.
296296
297-
=head2 __DATA__, __END__, and the FOOBAR::DATA filehandle.
297+
=head2 __DATA__, __END__, and the FOOBAR::DATA filehandle
298298
299299
This section is only relevant if you want to use
300300
the C<FOOBAR::DATA> together with the B<SelfLoader>.
@@ -328,7 +328,7 @@ declarations.
328328
329329
You could conceivably do both.
330330
331-
=head2 Classes and inherited methods.
331+
=head2 Classes and inherited methods
332332
333333
For modules which are not classes, this section is not relevant.
334334
This section is only relevant if you have methods which could

ext/Hash-Util/lib/Hash/Util.pm

+2-2
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ our @EXPORT_OK = qw(
4242
BEGIN {
4343
# make sure all our XS routines are available early so their prototypes
4444
# are correctly applied in the following code.
45-
our $VERSION = '0.30';
45+
our $VERSION = '0.31';
4646
require XSLoader;
4747
XSLoader::load();
4848
}
@@ -782,7 +782,7 @@ may not be allocated even though this value will be non-zero.)
782782
783783
=back
784784
785-
=head2 Operating on references to hashes.
785+
=head2 Operating on references to hashes
786786
787787
Most subroutines documented in this module have equivalent versions
788788
that operate on references to hashes instead of native hashes.

hints/README.hints

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ over from perl4.
1414
Please report any problems or suggested changes at
1515
L<https://github.com/Perl/perl5/issues>.
1616

17-
=head1 Hint file naming convention.
17+
=head1 Hint file naming convention
1818

1919
Each hint file name should have only
2020
one '.'. (This is for portability to non-unix file systems.) Names

lib/perl5db.pl

+9-9
Original file line numberDiff line numberDiff line change
@@ -532,7 +532,7 @@ BEGIN
532532
use vars qw($VERSION $header);
533533

534534
# bump to X.XX in blead, only use X.XX_XX in maint
535-
$VERSION = '1.79';
535+
$VERSION = '1.80';
536536

537537
$header = "perl5db.pl version $VERSION";
538538

@@ -3227,7 +3227,7 @@ =head4 C<f> - switch files
32273227
32283228
Switch to a different filename.
32293229
3230-
=head4 C<.> - return to last-executed line.
3230+
=head4 C<.> - return to last-executed line
32313231
32323232
We set C<$incr> to -1 to indicate that the debugger shouldn't move ahead,
32333233
and then we look up the line in the magical C<%dbline> hash.
@@ -3293,11 +3293,11 @@ =head4 C<T> - stack trace
32933293
32943294
Just calls C<DB::print_trace>.
32953295
3296-
=head4 C<w> - List window around current line.
3296+
=head4 C<w> - List window around current line
32973297
32983298
Just calls C<DB::cmd_w>.
32993299
3300-
=head4 C<W> - watch-expression processing.
3300+
=head4 C<W> - watch-expression processing
33013301
33023302
Just calls C<DB::cmd_W>.
33033303
@@ -3381,7 +3381,7 @@ =head4 C<=> - define command alias
33813381
33823382
Manipulates C<%alias> to add or list command aliases.
33833383
3384-
=head4 C<source> - read commands from a file.
3384+
=head4 C<source> - read commands from a file
33853385
33863386
Opens a lexical filehandle and stacks it on C<@cmdfhs>; C<DB::readline> will
33873387
pick it up.
@@ -3405,7 +3405,7 @@ =head4 C<rerun> - rerun the current session
34053405
34063406
Return to any given position in the B<true>-history list
34073407
3408-
=head4 C<|, ||> - pipe output through the pager.
3408+
=head4 C<|, ||> - pipe output through the pager
34093409
34103410
For C<|>, we save C<OUT> (the debugger's output filehandle) and C<STDOUT>
34113411
(the program's standard output). For C<||>, we only save C<OUT>. We open a
@@ -9413,7 +9413,7 @@ =head3 Scalar, array, and hash completion: partially qualified package
94139413
94149414
=back
94159415
9416-
=head3 Symbol completion: current package or package C<main>.
9416+
=head3 Symbol completion: current package or package C<main>
94179417
94189418
=cut
94199419

@@ -9973,7 +9973,7 @@ sub cmd_pre580_null {
99739973
# do nothing...
99749974
}
99759975

9976-
=head2 Old C<a> command.
9976+
=head2 Old C<a> command
99779977
99789978
This version added actions if you supplied them, and deleted them
99799979
if you didn't.
@@ -10082,7 +10082,7 @@ sub cmd_pre580_b {
1008210082
}
1008310083
} ## end sub cmd_pre580_b
1008410084

10085-
=head2 Old C<D> command.
10085+
=head2 Old C<D> command
1008610086
1008710087
Delete all breakpoints unconditionally.
1008810088

pod/perl5005delta.pod

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ scheme.
2121

2222
=head1 Incompatible Changes
2323

24-
=head2 WARNING: This version is not binary compatible with Perl 5.004.
24+
=head2 WARNING: This version is not binary compatible with Perl 5.004
2525

2626
Starting with Perl 5.004_50 there were many deep and far-reaching changes
2727
to the language internals. If you have dynamically loaded extensions

pod/perl5125delta.pod

+3-3
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ L<perl5124delta>, which describes differences between 5.12.3 and
2020
A bug in C<Encode> could, on certain inputs, cause the heap to overflow.
2121
This problem has been corrected. Bug reported by Robert Zacek.
2222

23-
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
23+
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
2424

2525
Calling C<File::Glob::bsd_glob> with the unsupported flag GLOB_ALTDIRFUNC would
2626
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
5959
C<charnames::viacode(0)> to return C<undef> instead of the string "NULL"
6060
[perl #72624].
6161

62-
=head3 L<Encode> has been upgraded from version 2.39 to version 2.39_01.
62+
=head3 L<Encode> has been upgraded from version 2.39 to version 2.39_01
6363

6464
See L</Security>.
6565

66-
=head3 L<File::Glob> has been upgraded from version 1.07 to version 1.07_01.
66+
=head3 L<File::Glob> has been upgraded from version 1.07 to version 1.07_01
6767

6868
See L</Security>.
6969

pod/perl5140delta.pod

+1-1
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ as the latter returns a single code point.
113113

114114
See L<charnames> for details on all these changes.
115115

116-
=head3 New warnings categories for problematic (non-)Unicode code points.
116+
=head3 New warnings categories for problematic (non-)Unicode code points
117117

118118
Three new warnings subcategories of "utf8" have been added. These
119119
allow you to turn off some "utf8" warnings, while allowing

pod/perl5142delta.pod

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ No changes since 5.14.0.
1919

2020
=head1 Security
2121

22-
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
22+
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
2323

2424
Calling C<File::Glob::bsd_glob> with the unsupported flag GLOB_ALTDIRFUNC would
2525
cause an access violation / segfault. A Perl program that accepts a flags value from

pod/perl5160delta.pod

+2-2
Original file line numberDiff line numberDiff line change
@@ -325,7 +325,7 @@ strings.
325325

326326
Full details are in L<perlfunc/fc>.
327327

328-
=head3 The Unicode C<Script_Extensions> property is now supported.
328+
=head3 The Unicode C<Script_Extensions> property is now supported
329329

330330
New in Unicode 6.0, this is an improved C<Script> property. Details
331331
are in L<perlunicode/Scripts>.
@@ -514,7 +514,7 @@ C<utf8_to_uvuni_buf()> are now available to prevent this, and the Perl
514514
core has been converted to use them.
515515
See L</Internal Changes>.
516516

517-
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
517+
=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728)
518518

519519
Calling C<File::Glob::bsd_glob> with the unsupported flag
520520
GLOB_ALTDIRFUNC would cause an access violation / segfault. A Perl

0 commit comments

Comments
 (0)