In perl.git, the branch blead has been updated <https://perl5.git.perl.org/perl.git/commitdiff/d4e32ec55bb4cf73441c3c8749fd6545c9af4259?hp=136a1affb4e16f86a9eef08c9cf3a12fe9a157f7>
- Log ----------------------------------------------------------------- commit d4e32ec55bb4cf73441c3c8749fd6545c9af4259 Author: Karl Williamson <[email protected]> Date: Mon May 13 14:40:15 2019 -0600 Module-CoreList: Add some L<> to pod commit e1a97e0722bceddd1af47a8320c213b21f4d30a8 Author: Karl Williamson <[email protected]> Date: Sat May 11 13:46:21 2019 -0600 perlpodspec: Pod in heredocs is still pod A pod parser should not be expected to parse perl to make sure that what looks like pod isn't part of a quoted string. commit 3ceb517ba35be293af30c49c8602fb7713e85520 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:53:00 2018 -0600 utils/h2xs.PL: Use L</Foo Bar>, not L<Foo Bar> in pod commit 286e29d2760066cad1cf3e9f3caaf8400d0aa523 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:52:00 2018 -0600 perltie: Use L</Foo Bar>, not L<Foo Bar> commit 05a64c17c7f13b5ef702febe91e5962c94edd882 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:50:42 2018 -0600 lib/warnings.pm: Use L</Foo Bar>, not L<Foo Bar> commit bc801fb71eccb3a74c2d98eb3b0f768673ce92b2 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:50:15 2018 -0600 lib/overload.pm: Use L</Foo Bar>, not L<Foo Bar> commit 464867937fe839656941a55bd5c823fcade11b99 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:49:29 2018 -0600 Unicode::UCD: Use L</Foo Bar>, not L<Foo Bar> commit 53cb450350b86f88efc3a123b5d69975ee3297e6 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:48:39 2018 -0600 lib/Class/Struct.pm: Use L</Foo Bar>, not L<Foo Bar> commit 03c94503242bec08908a66bd7f44fc8551f7af71 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:47:28 2018 -0600 Tie::File: Use L</Foo>, not L<"Foo"> in pod commit 025d4ba4cf102879cef20b44a9a6146ca2cf7e2c Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:46:14 2018 -0600 perlxstut: Use L</Foo Bar>, not L<Foo Bar> commit c4eccd78b4da72c658a43337cc79b6dce788a239 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:44:45 2018 -0600 configpm: Remove extraneous =cut lines These were creating improper pod, though it hasn't been caught. commit b1b5ac27794b406d430e214924269e8f87e9a351 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:43:55 2018 -0600 README.os2: Use L</Foo Bar>, not L<Foo Bar> commit 13f502ed5b5469175dbed112419a7738cf05e182 Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:43:05 2018 -0600 Porting/release_managers_guide.pod: Use L</Foo Bar>, not L<Foo Bar> commit ef460fb9bf5e46f97b57c9532ad89475c3c879cb Author: Karl Williamson <[email protected]> Date: Fri Jun 1 10:41:52 2018 -0600 INTALL: Use L</Foo Bar>, not L<Foo Bar> commit 3eb2b47d438b092eee9d684b3d6a0039ac5b4256 Author: Karl Williamson <[email protected]> Date: Tue May 15 19:29:41 2018 -0600 Time::HiRes: Remove trailing blanks commit ee1ecd3850325b1288080b72b884d2c396151154 Author: Karl Williamson <[email protected]> Date: Tue May 15 19:29:12 2018 -0600 Time::HiRes: Add L<> to pod links commit b0a63d5860fa9c98df30cc2c8a7577c1fa01a9ba Author: Karl Williamson <[email protected]> Date: Wed May 9 19:03:49 2018 -0600 INSTALL: Add L<> and F<> pod directives commit e30d9667fa5c618863f9f7ce695b286cd351db7d Author: Karl Williamson <[email protected]> Date: Wed May 9 18:57:24 2018 -0600 PathTools::Win32.pm: Add L<> around link in pod commit 151ee2cb4c01308e2e75df85c442de68d5e0b8ad Author: Karl Williamson <[email protected]> Date: Wed May 9 18:56:38 2018 -0600 SelfLoader: Add L<> around link in pod commit 3877ffd899672c7a4e7b21e2e39d3fc59181e236 Author: Karl Williamson <[email protected]> Date: Wed May 9 18:53:04 2018 -0600 Locale::Maketext: Add L<> around links in pod commit 0a1b3cae3b10dadd3c2ac001c9bcb350c131cec7 Author: Karl Williamson <[email protected]> Date: Wed May 9 18:52:09 2018 -0600 I18N::LangTags: Add L<> around links in pod commit 7e28a79c36d1ea53f557b8346a19521f13f49cc3 Author: Karl Williamson <[email protected]> Date: Wed May 9 18:50:47 2018 -0600 Tie::File: Add L<> around link in pod commit 769bfbe89f3caedf4d9fad4c2c7e5470d6498228 Author: Karl Williamson <[email protected]> Date: Wed May 9 18:37:53 2018 -0600 lib/Unicode/UCD.t: Use standard Perl environment variable This test file invented its own environment variable, whereas everyone else uses a different one. Make this one comply. commit f420138f7a4a589f9cd97836ccb6f93368477611 Author: Karl Williamson <[email protected]> Date: Wed May 9 18:32:13 2018 -0600 perlrun: Add L<> to links commit 5d3db279f3a8edaeb0eeed8fb5ac65bd5a5c9327 Author: Karl Williamson <[email protected]> Date: Wed May 9 17:31:45 2018 -0600 IO: Add L<> around link in pod commit 633506a42d08bdb4fdbd0e7059d64b1b307a5920 Author: Karl Williamson <[email protected]> Date: Wed May 9 17:22:46 2018 -0600 ExtUtils::CBuilder: Add L<> around a link in the pod commit daa0a22aad3378c44f58f6114c1a71d5fc622c1a Author: Karl Williamson <[email protected]> Date: Wed May 9 17:18:34 2018 -0600 perlbug.PL: Add L<> around a link in the pod commit 1a2bd0846d7c7e7c3c770d7cac352957a5e93a5a Author: Karl Williamson <[email protected]> Date: Wed May 9 15:52:56 2018 -0600 Unicode::Normalize: Add L<> to links in pod ----------------------------------------------------------------------- Summary of changes: INSTALL | 60 +++++++++++----------- Porting/release_managers_guide.pod | 4 +- README.os2 | 8 +-- charclass_invlists.h | 2 +- configpm | 4 -- dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm | 4 +- dist/ExtUtils-ParseXS/lib/perlxstut.pod | 4 +- dist/I18N-LangTags/lib/I18N/LangTags.pm | 16 +++--- dist/IO/IO.pm | 4 +- dist/Locale-Maketext/lib/Locale/Maketext.pod | 6 +-- .../lib/Locale/Maketext/Cookbook.pod | 2 +- dist/Locale-Maketext/lib/Locale/Maketext/TPJ13.pod | 6 +-- dist/Module-CoreList/lib/Module/CoreList.pod | 4 +- dist/PathTools/lib/File/Spec/Win32.pm | 4 +- dist/SelfLoader/lib/SelfLoader.pm | 4 +- dist/Tie-File/lib/Tie/File.pm | 6 +-- dist/Tie-File/t/00_version.t | 2 +- dist/Time-HiRes/HiRes.pm | 31 ++++++----- dist/Unicode-Normalize/Normalize.pm | 14 ++--- lib/Class/Struct.pm | 4 +- lib/Unicode/UCD.pm | 4 +- lib/Unicode/UCD.t | 6 +-- lib/overload.pm | 30 +++++------ lib/unicore/uni_keywords.pl | 2 +- lib/warnings.pm | 4 +- pod/perlpodspec.pod | 3 ++ pod/perlrun.pod | 4 +- pod/perltie.pod | 10 ++-- regcharclass.h | 2 +- regen/warnings.pl | 4 +- t/porting/known_pod_issues.dat | 7 +++ uni_keywords.h | 2 +- utils/h2xs.PL | 2 +- utils/perlbug.PL | 2 +- 34 files changed, 141 insertions(+), 130 deletions(-) diff --git a/INSTALL b/INSTALL index b9712e8fa9..c3a456de4e 100644 --- a/INSTALL +++ b/INSTALL @@ -1,5 +1,5 @@ If you read this file _as_is_, just ignore the funny characters you see. -It is written in the POD format (see pod/perlpod.pod) which is specially +It is written in the POD format (see F<pod/perlpod.pod>) which is specially designed to be readable as is. =head1 NAME @@ -10,7 +10,7 @@ INSTALL - Build and Installation guide for perl 5. First, make sure you have an up-to-date version of Perl. If you didn't get your Perl source from CPAN, check the latest version at -http://www.cpan.org/src/. Perl uses a version scheme where even-numbered +L<http://www.cpan.org/src/>. Perl uses a version scheme where even-numbered subreleases (like 5.8.x and 5.10.x) are stable maintenance releases and odd-numbered subreleases (like 5.7.x and 5.9.x) are unstable development releases. Development releases should not be used in @@ -28,11 +28,11 @@ the defaults are to run, from a freshly unpacked source tree: Each of these is explained in further detail below. -The above commands will install Perl to /usr/local (or some other -platform-specific directory -- see the appropriate file in hints/.) +The above commands will install Perl to F</usr/local> (or some other +platform-specific directory -- see the appropriate file in F<hints/>.) If that's not okay with you, you can run Configure interactively, by just typing "sh Configure" (without the -de args). You can also specify -any prefix location by adding "-Dprefix='/some/dir'" to Configure's args. +any prefix location by adding C<"-Dprefix='/some/dir'"> to Configure's args. To explicitly name the perl binary, use the command "make install PERLNAME=myperl". @@ -44,20 +44,20 @@ rely on anything more than C89. These options, and many more, are explained in further detail below. If you're building perl from a git repository, you should also consult -the documentation in pod/perlgit.pod for information on that special +the documentation in F<pod/perlgit.pod> for information on that special circumstance. If you have problems, corrections, or questions, please see L<"Reporting Problems"> below. For information on what's new in this release, see the -pod/perldelta.pod file. For more information about how to find more +F<pod/perldelta.pod> file. For more information about how to find more specific detail about changes, see the Changes file. =head1 DESCRIPTION This document is written in pod format as an easy way to indicate its -structure. The pod format is described in pod/perlpod.pod, but you can +structure. The pod format is described in F<pod/perlpod.pod>, but you can read it as is with any pager or editor. Headings and items are marked by lines beginning with '='. The other mark-up used is @@ -73,21 +73,21 @@ proceeding. In addition to this file, check if there is a README file specific to your operating system, since it may provide additional or different instructions for building Perl. If there is a hint file for your -system (in the hints/ directory) you might also want to read it +system (in the F<hints/> directory) you might also want to read it for even more information. For additional information about porting Perl, see the section on -L<"Porting information"> below, and look at the files in the Porting/ +L<"Porting information"> below, and look at the files in the F<Porting/> directory. =head1 PRELIMINARIES =head2 Changes and Incompatibilities -Please see pod/perldelta.pod for a description of the changes and +Please see F<pod/perldelta.pod> for a description of the changes and potential incompatibilities introduced with this release. A few of the most important issues are listed below, but you should refer -to pod/perldelta.pod for more detailed information. +to F<pod/perldelta.pod> for more detailed information. B<WARNING:> This version is not binary compatible with earlier versions of Perl. If you have built extensions (i.e. modules that include C code) @@ -102,7 +102,7 @@ The standard extensions supplied with Perl will be handled automatically. On a related issue, old modules may possibly be affected by the changes in the Perl language in the current release. Please see -pod/perldelta.pod for a description of what's changed. See your +F<pod/perldelta.pod> for a description of what's changed. See your installed copy of the perllocal.pod file for a (possibly incomplete) list of locally installed modules. Also see the L<CPAN> module's C<autobundle> function for one way to make a "bundle" of your currently @@ -132,7 +132,7 @@ Configure supports a number of useful options. Run Configure -h -to get a listing. See the Porting/Glossary file for a complete list of +to get a listing. See the F<Porting/Glossary> file for a complete list of Configure variables you can set and their definitions. =over 4 @@ -150,32 +150,32 @@ compiler) so that the hints files can set appropriate defaults. =item Installation prefix By default, for most systems, perl will be installed in -/usr/local/{bin, lib, man}. (See L<"Installation Directories"> +F</usr/local/>{F<bin>, F<lib>, F<man>}. (See L<"Installation Directories"> and L<"Coexistence with earlier versions of perl 5"> below for further details.) You can specify a different 'prefix' for the default installation directory when Configure prompts you, or by using the Configure command -line option -Dprefix='/some/directory', e.g. +line option C<-Dprefix='/some/directory'>, e.g. sh Configure -Dprefix=/opt/perl If your prefix contains the string "perl", then the suggested directory structure is simplified. For example, if you use -prefix=/opt/perl, then Configure will suggest /opt/perl/lib instead of -/opt/perl/lib/perl5/. Again, see L<"Installation Directories"> below -for more details. Do not include a trailing slash, (i.e. /opt/perl/) +C<prefix=/opt/perl>, then Configure will suggest F</opt/perl/lib> instead of +F</opt/perl/lib/perl5/>. Again, see L<"Installation Directories"> below +for more details. Do not include a trailing slash, (i.e. F</opt/perl/>) or you may experience odd test failures. NOTE: You must not specify an installation directory that is the same as or below your perl source directory. If you do, installperl will attempt infinite recursion. -=item /usr/bin/perl +=item F</usr/bin/perl> It may seem obvious, but Perl is useful only when users can easily -find it. It's often a good idea to have both /usr/bin/perl and -/usr/local/bin/perl be symlinks to the actual binary. Be especially +find it. It's often a good idea to have both F</usr/bin/perl> and +F</usr/local/bin/perl> be symlinks to the actual binary. Be especially careful, however, not to overwrite a version of perl supplied by your vendor unless you are sure you know what you are doing. If you insist on replacing your vendor's perl, useful information on how it was @@ -187,7 +187,7 @@ configured may be found with spaces in arguments to Configure. For that, you have to look carefully at config_arg1, config_arg2, etc.) -By default, Configure will not try to link /usr/bin/perl to the current +By default, Configure will not try to link F</usr/bin/perl> to the current version of perl. You can turn on that behavior by running Configure -Dinstallusrbinperl @@ -1019,7 +1019,7 @@ Removes -g from optimize, and -DDEBUGGING from ccflags. =back If you are using a shared libperl, see the warnings about multiple -versions of perl under L<Building a shared Perl library>. +versions of perl under L</Building a shared Perl library>. Note that a perl built with -DDEBUGGING will be much bigger and will run much, much more slowly than a standard perl. @@ -1040,7 +1040,7 @@ simple D script that uses them: =head2 Extensions Perl ships with a number of standard extensions. These are contained -in the ext/ subdirectory. +in the F<ext/> subdirectory. By default, Configure will offer to build every extension which appears to be supported. For example, Configure will offer to build GDBM_File @@ -1415,7 +1415,7 @@ including a glossary of all those config.sh variables, is in the Porting subdirectory. Porting/Glossary should especially come in handy. Ports for other systems may also be available. You should check out -http://www.cpan.org/ports for current information on ports to +L<http://www.cpan.org/ports> for current information on ports to various other operating systems. If you plan to port Perl to a new architecture, study carefully the @@ -1854,11 +1854,11 @@ Packaging and transferring either the core Perl modules or CPAN modules to the target platform is also left up to the each cross-compilation environment. Often the cross-compilation target platforms are somewhat limited in diskspace: see the section -L<Minimizing the Perl installation> to learn more of the minimal set +L</Minimizing the Perl installation> to learn more of the minimal set of files required for a functional Perl installation. For some cross-compilation environments the Configure option -C<-Dinstallprefix=...> might be handy, see L<Changing the installation +C<-Dinstallprefix=...> might be handy, see L</Changing the installation directory>. About the cross-compilation support of Configure: There's two forms. @@ -2436,7 +2436,7 @@ for details of how to report the issue. If you are unsure what makes a good bug report please read "How to report Bugs Effectively" by Simon Tatham: -http://www.chiark.greenend.org.uk/~sgtatham/bugs.html +L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html> =head1 Coexistence with earlier versions of perl 5 @@ -2698,7 +2698,7 @@ perl will ignore the C<PERL_INTERNAL_RAND_SEED> environment variable. =head1 DOCUMENTATION Read the manual entries before running perl. The main documentation -is in the pod/ subdirectory and should have been installed during the +is in the F<pod/> subdirectory and should have been installed during the build process. Type B<man perl> to get started. Alternatively, you can type B<perldoc perl> to use the supplied perldoc script. This is sometimes useful for finding things in the library modules. diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index ceee9956ea..79f8b7c4dd 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -545,7 +545,7 @@ If necessary update the list and the indicated version number. =head3 check a readonly build -Even before other prep work, follow the steps in L<build the tarball> and test +Even before other prep work, follow the steps in L</build the tarball> and test it locally. Because a perl source tarballs sets many files read-only, it could test differently than tests run from the repository. After you're sure permissions aren't a problem, delete the generated directory and tarballs. @@ -689,7 +689,7 @@ action from the last commit.) Add a perldelta entry for the new Module::CoreList version. You only need to do this if you want to add notes about the changes included with this version of Module::CoreList. Otherwise, its version bump -will be automatically filled in below in L<finalize perldelta>. +will be automatically filled in below in L</finalize perldelta>. =for checklist skip RC diff --git a/README.os2 b/README.os2 index d3899609f3..5c84afcced 100644 --- a/README.os2 +++ b/README.os2 @@ -300,7 +300,7 @@ with perl ../../blah/foo.cmd arg1 arg2 arg3 (note that the argument C<-my_opts> is taken care of by the C<extproc> line -in your script, see L<C<extproc> on the first line>). +in your script, see L</C<extproc> on the first line>). To understand what the above I<magic> does, read perl docs about C<-S> switch - see L<perlrun>, and cmdref about C<extproc>: @@ -436,7 +436,7 @@ managed to goof. C<;-)> =item * Did you run your programs with C<-w> switch? See -L<Starting OSE<sol>2 (and DOS) programs under Perl>. +L</Starting OSE<sol>2 (and DOS) programs under Perl>. =item * @@ -2666,8 +2666,8 @@ I will include it into distribution. I have no need for such a module, so cannot test it. For the details of the current situation with calling external programs, -see L<Starting OSE<sol>2 (and DOS) programs under Perl>. Set us mention a couple -of features: +see L</Starting OSE<sol>2 (and DOS) programs under Perl>. Set us +mention a couple of features: =over 4 diff --git a/charclass_invlists.h b/charclass_invlists.h index cf5cc3f27d..566d22f4d4 100644 --- a/charclass_invlists.h +++ b/charclass_invlists.h @@ -395255,7 +395255,7 @@ static const U8 WB_table[23][23] = { #define MAX_FOLD_FROMS 3 /* Generated from: - * d34c77b7e7a94986cc82056919f4ffc1503b73091561e16bd8ef145ac0fd04c5 lib/Unicode/UCD.pm + * 73902d92e2f05c2b707351006727708a3dc043d118f05aee169f70c117489d61 lib/Unicode/UCD.pm * 5e91b649379ec79af7cfb6b09410a24557cba4c6d733cd0a2b8a78a1448736d2 lib/unicore/ArabicShaping.txt * f5feb19cd084b2b1568fbc0f94f4b4b54941406e7fb36c7570f8352fd5022dbe lib/unicore/BidiBrackets.txt * e6cbd8ffe94f2e0fbfa6695d6c06c1e72eef7d3aa93cb6329d111285198b5e62 lib/unicore/BidiMirroring.txt diff --git a/configpm b/configpm index 09c4a3b7a7..da446ef84b 100755 --- a/configpm +++ b/configpm @@ -1023,16 +1023,12 @@ sub process { print CONFIG_POD <<EOF if $text; =back -=cut - EOF print CONFIG_POD <<EOF; =head2 $c =over 4 -=cut - EOF $text = 1; } diff --git a/dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm b/dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm index e1a8b63f2a..9fdb41ca77 100644 --- a/dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm +++ b/dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm @@ -7,7 +7,7 @@ use Perl::OSType qw/os_type/; use warnings; use strict; -our $VERSION = '0.280231'; # VERSION +our $VERSION = '0.280232'; # VERSION our @ISA; # We only use this once - don't waste a symbol table entry on it. @@ -274,7 +274,7 @@ submit any bug reports via the F<perlbug> tool included with Perl 5. Bug reports will be included in the Perl 5 ticket system at L<http://rt.perl.org>. -The Perl 5 source code is available at <http://perl5.git.perl.org/perl.git> +The Perl 5 source code is available at L<http://perl5.git.perl.org/perl.git> and ExtUtils-CBuilder may be found in the F<dist/ExtUtils-CBuilder> directory of the repository. diff --git a/dist/ExtUtils-ParseXS/lib/perlxstut.pod b/dist/ExtUtils-ParseXS/lib/perlxstut.pod index ef154ad731..f9fe9e76fe 100644 --- a/dist/ExtUtils-ParseXS/lib/perlxstut.pod +++ b/dist/ExtUtils-ParseXS/lib/perlxstut.pod @@ -707,7 +707,7 @@ commands to build it. =head2 Anatomy of .xs file -The .xs file of L<"EXAMPLE 4"> contained some new elements. To understand +The .xs file of L</EXAMPLE 4> contained some new elements. To understand the meaning of these elements, pay attention to the line which reads MODULE = Mytest2 PACKAGE = Mytest2 @@ -737,7 +737,7 @@ somewhat of an exception rather than the rule. =head2 Getting the fat out of XSUBs -In L<"EXAMPLE 4"> the second part of .xs file contained the following +In L</EXAMPLE 4> the second part of .xs file contained the following description of an XSUB: double diff --git a/dist/I18N-LangTags/lib/I18N/LangTags.pm b/dist/I18N-LangTags/lib/I18N/LangTags.pm index 3358d60274..35751bce03 100644 --- a/dist/I18N-LangTags/lib/I18N/LangTags.pm +++ b/dist/I18N-LangTags/lib/I18N/LangTags.pm @@ -18,7 +18,7 @@ our @EXPORT_OK = qw(is_language_tag same_language_tag ); our %EXPORT_TAGS = ('ALL' => \@EXPORT_OK); -our $VERSION = "0.43"; +our $VERSION = "0.44"; our %Panic; sub uniq { my %seen; return grep(!($seen{$_}++), @_); } # a util function @@ -844,28 +844,28 @@ language tags with their ASCII characters shifted into Plane 14. * L<I18N::LangTags::List|I18N::LangTags::List> -* RFC 3066, C<http://www.ietf.org/rfc/rfc3066.txt>, "Tags for the +* RFC 3066, C<L<http://www.ietf.org/rfc/rfc3066.txt>>, "Tags for the Identification of Languages". (Obsoletes RFC 1766) -* RFC 2277, C<http://www.ietf.org/rfc/rfc2277.txt>, "IETF Policy on +* RFC 2277, C<L<http://www.ietf.org/rfc/rfc2277.txt>>, "IETF Policy on Character Sets and Languages". -* RFC 2231, C<http://www.ietf.org/rfc/rfc2231.txt>, "MIME Parameter +* RFC 2231, C<L<http://www.ietf.org/rfc/rfc2231.txt>>, "MIME Parameter Value and Encoded Word Extensions: Character Sets, Languages, and Continuations". -* RFC 2482, C<http://www.ietf.org/rfc/rfc2482.txt>, +* RFC 2482, C<L<http://www.ietf.org/rfc/rfc2482.txt>>, "Language Tagging in Unicode Plain Text". * Locale::Codes, in -C<http://www.perl.com/CPAN/modules/by-module/Locale/> +C<L<http://www.perl.com/CPAN/modules/by-module/Locale/>> * ISO 639-2, "Codes for the representation of names of languages", including two-letter and three-letter codes, -C<http://www.loc.gov/standards/iso639-2/php/code_list.php> +C<L<http://www.loc.gov/standards/iso639-2/php/code_list.php>> * The IANA list of registered languages (hopefully up-to-date), -C<http://www.iana.org/assignments/language-tags> +C<L<http://www.iana.org/assignments/language-tags>> =head1 COPYRIGHT diff --git a/dist/IO/IO.pm b/dist/IO/IO.pm index 44c4df8415..9df95ba20f 100644 --- a/dist/IO/IO.pm +++ b/dist/IO/IO.pm @@ -7,7 +7,7 @@ use Carp; use strict; use warnings; -our $VERSION = "1.40"; +our $VERSION = "1.41"; XSLoader::load 'IO', $VERSION; sub import { @@ -53,7 +53,7 @@ in one go. The IO modules belonging to the core are: Some other IO modules don't belong to the perl core but can be loaded as well if they have been installed from CPAN. You can discover which -ones exist by searching for "^IO::" on http://search.cpan.org. +ones exist by searching for "^IO::" on L<http://search.cpan.org>. For more information on any of these modules, please see its respective documentation. diff --git a/dist/Locale-Maketext/lib/Locale/Maketext.pod b/dist/Locale-Maketext/lib/Locale/Maketext.pod index 24c8f24d8f..26be348353 100644 --- a/dist/Locale-Maketext/lib/Locale/Maketext.pod +++ b/dist/Locale-Maketext/lib/Locale/Maketext.pod @@ -1387,16 +1387,16 @@ L<I18N::LangTags|I18N::LangTags>. L<Win32::Locale|Win32::Locale>. RFC 3066, I<Tags for the Identification of Languages>, -as at http://sunsite.dk/RFC/rfc/rfc3066.html +as at L<http://sunsite.dk/RFC/rfc/rfc3066.html> RFC 2277, I<IETF Policy on Character Sets and Languages> -is at http://sunsite.dk/RFC/rfc/rfc2277.html -- much of it is +is at L<http://sunsite.dk/RFC/rfc/rfc2277.html> -- much of it is just things of interest to protocol designers, but it explains some basic concepts, like the distinction between locales and language-tags. The manual for GNU C<gettext>. The gettext dist is available in -C<ftp://prep.ai.mit.edu/pub/gnu/> -- get +C<L<ftp://prep.ai.mit.edu/pub/gnu/>> -- get a recent gettext tarball and look in its "doc/" directory, there's an easily browsable HTML version in there. The gettext documentation asks lots of questions worth thinking diff --git a/dist/Locale-Maketext/lib/Locale/Maketext/Cookbook.pod b/dist/Locale-Maketext/lib/Locale/Maketext/Cookbook.pod index 3457f7ca12..51fad9528b 100644 --- a/dist/Locale-Maketext/lib/Locale/Maketext/Cookbook.pod +++ b/dist/Locale-Maketext/lib/Locale/Maketext/Cookbook.pod @@ -68,7 +68,7 @@ should be more time expensive as an option. =head1 DECIMAL PLACES IN NUMBER FORMATTING -I<After CPAN RT #36136 (https://rt.cpan.org/Ticket/Display.html?id=36136)> +I<After CPAN RT #36136 (L<https://rt.cpan.org/Ticket/Display.html?id=36136>)> The documentation of L<Locale::Maketext> advises that the standard bracket method C<numf> is limited and that diff --git a/dist/Locale-Maketext/lib/Locale/Maketext/TPJ13.pod b/dist/Locale-Maketext/lib/Locale/Maketext/TPJ13.pod index 7025b7f42c..761af6c18a 100644 --- a/dist/Locale-Maketext/lib/Locale/Maketext/TPJ13.pod +++ b/dist/Locale-Maketext/lib/Locale/Maketext/TPJ13.pod @@ -750,16 +750,16 @@ morphology and pedagogy of North American native languages. Alvestrand, Harald Tveit. 1995. I<RFC 1766: Tags for the Identification of Languages.> -C<http://www.ietf.org/rfc/rfc1766.txt> +C<L<http://www.ietf.org/rfc/rfc1766.txt>> [Now see RFC 3066.] Callon, Ross, editor. 1996. I<RFC 1925: The Twelve Networking Truths.> -C<http://www.ietf.org/rfc/rfc1925.txt> +C<L<http://www.ietf.org/rfc/rfc1925.txt>> Drepper, Ulrich, Peter Miller, and FranE<ccedil>ois Pinard. 1995-2001. GNU -C<gettext>. Available in C<ftp://prep.ai.mit.edu/pub/gnu/>, with +C<gettext>. Available in C<L<ftp://prep.ai.mit.edu/pub/gnu/>>, with extensive docs in the distribution tarball. [Since I wrote this article in 1998, I now see that the gettext docs are now trying more to come to terms with diff --git a/dist/Module-CoreList/lib/Module/CoreList.pod b/dist/Module-CoreList/lib/Module/CoreList.pod index 2b563ff9ac..102383e095 100644 --- a/dist/Module-CoreList/lib/Module/CoreList.pod +++ b/dist/Module-CoreList/lib/Module/CoreList.pod @@ -215,10 +215,10 @@ A hash that contains information on the appropriate bug tracker for each core module. BUGS is an email or url to post bug reports. For modules with -UPSTREAM => 'blead', use [email protected]. rt.cpan.org +UPSTREAM => 'blead', use L<mailto:[email protected]>. rt.cpan.org appears to automatically provide a URL for CPAN modules; any value given here overrides the default: -http://rt.cpan.org/Public/Dist/Display.html?Name=$ModuleName +L<http://rt.cpan.org/Public/Dist/Display.html?Name=$ModuleName> =back diff --git a/dist/PathTools/lib/File/Spec/Win32.pm b/dist/PathTools/lib/File/Spec/Win32.pm index 5934010439..a3b89c3ff6 100644 --- a/dist/PathTools/lib/File/Spec/Win32.pm +++ b/dist/PathTools/lib/File/Spec/Win32.pm @@ -5,7 +5,7 @@ use strict; use Cwd (); require File::Spec::Unix; -our $VERSION = '3.78'; +our $VERSION = '3.79'; $VERSION =~ tr/_//d; our @ISA = qw(File::Spec::Unix); @@ -84,7 +84,7 @@ sub tmpdir { MSWin32 case-tolerance depends on GetVolumeInformation() $ouFsFlags == FS_CASE_SENSITIVE, indicating the case significance when comparing file specifications. Since XP FS_CASE_SENSITIVE is effectively disabled for the NT subsubsystem. -See http://cygwin.com/ml/cygwin/2007-07/msg00891.html +See L<http://cygwin.com/ml/cygwin/2007-07/msg00891.html> Default: 1 =cut diff --git a/dist/SelfLoader/lib/SelfLoader.pm b/dist/SelfLoader/lib/SelfLoader.pm index 0034e5be33..daa3e6632c 100644 --- a/dist/SelfLoader/lib/SelfLoader.pm +++ b/dist/SelfLoader/lib/SelfLoader.pm @@ -2,7 +2,7 @@ package SelfLoader; use 5.008; use strict; use IO::Handle; -our $VERSION = "1.25"; +our $VERSION = "1.26"; # The following bit of eval-magic is necessary to make this work on # perls < 5.009005. @@ -428,7 +428,7 @@ You should also have received a copy of the GNU General Public License along with this program in the file named "Copying". If not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA or visit their web page on the internet at -http://www.gnu.org/copyleft/gpl.html. +L<http://www.gnu.org/copyleft/gpl.html>. For those of you that choose to use the GNU General Public License, my interpretation of the GNU General Public License is that no Perl diff --git a/dist/Tie-File/lib/Tie/File.pm b/dist/Tie-File/lib/Tie/File.pm index d546b81f44..2aefde7d80 100644 --- a/dist/Tie-File/lib/Tie/File.pm +++ b/dist/Tie-File/lib/Tie/File.pm @@ -7,7 +7,7 @@ use Fcntl 'O_CREAT', 'O_RDWR', 'LOCK_EX', 'LOCK_SH', 'O_WRONLY', 'O_RDONLY'; sub O_ACCMODE () { O_RDONLY | O_RDWR | O_WRONLY } -$VERSION = "1.02"; +$VERSION = "1.03"; my $DEFAULT_MEMORY_SIZE = 1<<21; # 2 megabytes my $DEFAULT_AUTODEFER_THRESHHOLD = 3; # 3 records my $DEFAULT_AUTODEFER_FILELEN_THRESHHOLD = 65536; # 16 disk blocksful @@ -2365,7 +2365,7 @@ will be rewritten in a single pass. (Actually, the preceding discussion is something of a fib. You don't need to enable deferred writing to get good performance for this common case, because C<Tie::File> will do it for you automatically -unless you specifically tell it not to. See L<"Autodeferring">, +unless you specifically tell it not to. See L</Autodeferring>, below.) Calling C<-E<gt>flush> returns the array to immediate-write mode. If @@ -2517,7 +2517,7 @@ People sometimes point out that L<DB_File> will do something similar, and ask why C<Tie::File> module is necessary. There are a number of reasons that you might prefer C<Tie::File>. -A list is available at C<http://perl.plover.com/TieFile/why-not-DB_File>. +A list is available at C<L<http://perl.plover.com/TieFile/why-not-DB_File>>. =head1 AUTHOR diff --git a/dist/Tie-File/t/00_version.t b/dist/Tie-File/t/00_version.t index 3a404ff38c..5d1863a4a3 100644 --- a/dist/Tie-File/t/00_version.t +++ b/dist/Tie-File/t/00_version.t @@ -2,7 +2,7 @@ print "1..1\n"; -my $testversion = "1.02"; +my $testversion = "1.03"; use Tie::File; if ($Tie::File::VERSION != $testversion) { diff --git a/dist/Time-HiRes/HiRes.pm b/dist/Time-HiRes/HiRes.pm index 08eefc851f..d33a28b2a9 100644 --- a/dist/Time-HiRes/HiRes.pm +++ b/dist/Time-HiRes/HiRes.pm @@ -50,7 +50,7 @@ our @EXPORT_OK = qw (usleep sleep ualarm alarm gettimeofday time tv_interval stat lstat utime ); -our $VERSION = '1.9760'; +our $VERSION = '1.9761'; our $XS_VERSION = $VERSION; $VERSION = eval $VERSION; @@ -221,8 +221,8 @@ Sleeps for the number of microseconds (millionths of a second) specified. Returns the number of microseconds actually slept. Can sleep for more than one second, unlike the C<usleep> system call. Can also sleep for zero seconds, which often works like a I<thread yield>. -See also C<Time::HiRes::usleep()>, C<Time::HiRes::sleep()>, and -C<Time::HiRes::clock_nanosleep()>. +See also L<C<Time::HiRes::sleep()>|/sleep ( $floating_seconds )>, and +L<C<clock_nanosleep()>|/clock_nanosleep ( $which, $nanoseconds, $flags = 0)>. Do not expect usleep() to be exact down to one microsecond. @@ -232,8 +232,10 @@ Sleeps for the number of nanoseconds (1e9ths of a second) specified. Returns the number of nanoseconds actually slept (accurate only to microseconds, the nearest thousand of them). Can sleep for more than one second. Can also sleep for zero seconds, which often works like -a I<thread yield>. See also C<Time::HiRes::sleep()>, -C<Time::HiRes::usleep()>, and C<Time::HiRes::clock_nanosleep()>. +a I<thread yield>. See also +L<C<Time::HiRes::sleep()>|/sleep ( $floating_seconds )>, +L<C<Time::HiRes::usleep()>|/usleep ( $useconds )>, and +L<C<clock_nanosleep()>|/clock_nanosleep ( $which, $nanoseconds, $flags = 0)>. Do not expect nanosleep() to be exact down to one nanosecond. Getting even accuracy of one thousand nanoseconds is good. @@ -250,7 +252,7 @@ ualarm(0) will cancel an outstanding ualarm(). Note that the interaction between alarms and sleeps is unspecified. -=item tv_interval +=item tv_interval tv_interval ( $ref_to_gettimeofday [, $ref_to_later_gettimeofday] ) @@ -356,7 +358,7 @@ delivered when the timer expires. C<SIGPROF> can interrupt system calls. The semantics of interval timers for multithreaded programs are system-specific, and some systems may support additional interval timers. For example, it is unspecified which thread gets the signals. -See your C<setitimer()> documentation. +See your L<C<setitimer(2)>> documentation. =item getitimer ( $which ) @@ -404,8 +406,10 @@ default to zero but C<TIMER_ABSTIME> can specified (must be exported explicitly) which means that C<$nanoseconds> is not a time interval (as is the default) but instead an absolute time. Can sleep for more than one second. Can also sleep for zero seconds, which often works -like a I<thread yield>. See also C<Time::HiRes::sleep()>, -C<Time::HiRes::usleep()>, and C<Time::HiRes::nanosleep()>. +like a I<thread yield>. See also +L<C<Time::HiRes::sleep()>|/sleep ( $floating_seconds )>, +L<C<Time::HiRes::usleep()>|/usleep ( $useconds )>, and +L<C<Time::HiRes::nanosleep()>|/nanosleep ( $nanoseconds )>. Do not expect clock_nanosleep() to be exact down to one nanosecond. Getting even accuracy of one thousand nanoseconds is good. @@ -515,7 +519,7 @@ Returns the number of files successfully changed. # get seconds and microseconds since the epoch ($s, $usec) = gettimeofday(); - # measure elapsed time + # measure elapsed time # (could also do by subtracting 2 gettimeofday return values) $t0 = [gettimeofday]; # do bunch of stuff here @@ -650,9 +654,10 @@ gnukfreebsd seems to have non-functional futimens() and utimensat() Perl modules L<BSD::Resource>, L<Time::TAI64>. -Your system documentation for C<clock>, C<clock_gettime>, -C<clock_getres>, C<clock_nanosleep>, C<clock_settime>, C<getitimer>, -C<gettimeofday>, C<setitimer>, C<sleep>, C<stat>, C<ualarm>. +Your system documentation for L<C<clock(3)>>, L<C<clock_gettime(2)>>, +L<C<clock_getres(3)>>, L<C<clock_nanosleep(3)>>, L<C<clock_settime(2)>>, +L<C<getitimer(2)>>, L<C<gettimeofday(2)>>, L<C<setitimer(2)>>, L<C<sleep(3)>>, +L<C<stat(2)>>, L<C<ualarm(3)>>. =head1 AUTHORS diff --git a/dist/Unicode-Normalize/Normalize.pm b/dist/Unicode-Normalize/Normalize.pm index adf3db50d8..d06fb8b56f 100644 --- a/dist/Unicode-Normalize/Normalize.pm +++ b/dist/Unicode-Normalize/Normalize.pm @@ -16,7 +16,7 @@ use Carp; no warnings 'utf8'; -our $VERSION = '1.26'; +our $VERSION = '1.27'; our $PACKAGE = __PACKAGE__; our @EXPORT = qw( NFC NFD NFKC NFKD ); @@ -606,27 +606,27 @@ and/or modify it under the same terms as Perl itself. =over 4 -=item http://www.unicode.org/reports/tr15/ +=item L<http://www.unicode.org/reports/tr15/> Unicode Normalization Forms - UAX #15 -=item http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt +=item L<http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt> Composition Exclusion Table -=item http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt +=item L<http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt> Derived Normalization Properties -=item http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt +=item L<http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt> Normalization Corrections -=item http://www.unicode.org/review/pr-29.html +=item L<http://www.unicode.org/review/pr-29.html> Public Review Issue #29: Normalization Issue -=item http://www.unicode.org/notes/tn5/ +=item L<http://www.unicode.org/notes/tn5/> Canonical Equivalence in Applications - UTN #5 diff --git a/lib/Class/Struct.pm b/lib/Class/Struct.pm index 0aaab519b7..c593dc7c39 100644 --- a/lib/Class/Struct.pm +++ b/lib/Class/Struct.pm @@ -14,7 +14,7 @@ require Exporter; @ISA = qw(Exporter); @EXPORT = qw(struct); -$VERSION = '0.65'; +$VERSION = '0.66'; my $print = 0; sub printem { @@ -375,7 +375,7 @@ on the declared type of the element. =item Scalar (C<'$'> or C<'*$'>) The element is a scalar, and by default is initialized to C<undef> -(but see L<Initializing with new>). +(but see L</Initializing with new>). The accessor's argument, if any, is assigned to the element. diff --git a/lib/Unicode/UCD.pm b/lib/Unicode/UCD.pm index 1f04bca038..115faa9785 100644 --- a/lib/Unicode/UCD.pm +++ b/lib/Unicode/UCD.pm @@ -5,7 +5,7 @@ use warnings; no warnings 'surrogate'; # surrogates can be inputs to this use charnames (); -our $VERSION = '0.72'; +our $VERSION = '0.73'; require Exporter; @@ -4025,7 +4025,7 @@ sub search_invlist { C<search_invlist> is used to search an inversion list returned by C<prop_invlist> or C<prop_invmap> for a particular L</code point argument>. C<undef> is returned if the code point is not found in the inversion list -(this happens only when it is not a legal L<code point argument>, or is less +(this happens only when it is not a legal L</code point argument>, or is less than the list's first element). A warning is raised in the first instance. Otherwise, it returns the index into the list of the range that contains the diff --git a/lib/Unicode/UCD.t b/lib/Unicode/UCD.t index b689de3950..0880fecdbd 100644 --- a/lib/Unicode/UCD.t +++ b/lib/Unicode/UCD.t @@ -1431,11 +1431,11 @@ sub fail_with_diff ($$$$) { # For use below to output better messages my ($prop, $official, $constructed, $tested_function_name) = @_; - if (! $ENV{PERL_DIFF_TOOL}) { + if (! $ENV{PERL_TEST_DIFF}) { is($constructed, $official, "$tested_function_name('$prop')"); - diag("Set environment variable PERL_DIFF_TOOL=diff_tool to see just " + diag("Set environment variable PERL_TEST_DIFF=diff_tool to see just " . "the differences."); return; } @@ -1455,7 +1455,7 @@ sub fail_with_diff ($$$$) { close $gend || die "Can't close gend"; my $diff = File::Temp->new(); - system("$ENV{PERL_DIFF_TOOL} $off $gend > $diff"); + system("$ENV{PERL_TEST_DIFF} $off $gend > $diff"); open my $fh, "<", $diff || die "Can't open $diff"; my @diffs = <$fh>; diff --git a/lib/overload.pm b/lib/overload.pm index f7d5d0f7cf..30f810b0a1 100644 --- a/lib/overload.pm +++ b/lib/overload.pm @@ -1,6 +1,6 @@ package overload; -our $VERSION = '1.30'; +our $VERSION = '1.31'; %ops = ( with_assign => "+ - * / % ** << >> x .", @@ -211,7 +211,7 @@ To overload built-in functions, see L<perlsub/Overriding Built-in Functions> ins =head3 Declaration Arguments of the C<use overload> directive are (key, value) pairs. -For the full set of legal keys, see L<Overloadable Operations> below. +For the full set of legal keys, see L</Overloadable Operations> below. Operator implementations (the values) can be subroutines, references to subroutines, or anonymous subroutines @@ -274,7 +274,7 @@ For example, if C<$x> and C<$y> are C<Number>s: Perl may also use C<minus()> to implement other operators which have not been specified in the C<use overload> directive, -according to the rules for L<Magic Autogeneration> described later. +according to the rules for L</Magic Autogeneration> described later. For example, the C<use overload> above declared no subroutine for any of the operators C<-->, C<neg> (the overload key for unary minus), or C<-=>. Thus @@ -300,7 +300,7 @@ only to return the result of the subtraction: Perl takes care of the assignment to $x. In fact, such methods should I<not> modify their operands, even if C<undef> is passed as the third argument -(see L<Overloadable Operations>). +(see L</Overloadable Operations>). The same is not true of implementations of C<++> and C<-->: these are expected to modify their operand. @@ -354,7 +354,7 @@ arithmetic metaphor. Note: the preceding paragraph describes what happens when Perl autogenerates the copy constructor for an object based on a scalar. -For other cases, see L<Copy Constructor>. +For other cases, see L</Copy Constructor>. =head2 Overloadable Operations @@ -417,7 +417,7 @@ evaluating an expression. &= |= ^= &.= |.= ^.= Simple assignment is not overloadable (the C<'='> key is used -for the L<Copy Constructor>). +for the L</Copy Constructor>). Perl does have a way to make assignments to an object do whatever you want, but this involves using tie(), not overload - see L<perlfunc/tie> and the L</COOKBOOK> examples below. @@ -575,7 +575,7 @@ then it will not be called again - avoiding infinite recursion. nomethod fallback = -See L<Special Keys for C<use overload>>. +See L</Special Keys for C<use overload>>. =back @@ -663,7 +663,7 @@ C<'+='> and C<'-='> (and similar to C<'.='> and C<'x='> above): Note also that the copy constructor (key C<'='>) may be autogenerated, but only for objects based on scalars. -See L<Copy Constructor>. +See L</Copy Constructor>. =head3 Minimal Set of Overloaded Operations @@ -709,7 +709,7 @@ C<'+'>) result in a call catch_all($a, 3, 1, '+') -See L<How Perl Chooses an Operator Implementation>. +See L</How Perl Chooses an Operator Implementation>. =head3 C<fallback> @@ -723,7 +723,7 @@ operator. use overload "fallback" => 0, # ... ; -This disables L<Magic Autogeneration>. +This disables L</Magic Autogeneration>. =item * C<undef> @@ -737,12 +737,12 @@ autogenerated then, instead of issuing an error message, Perl is allowed to revert to what it would have done for that operator if there had been no C<use overload> directive. -Note: in most cases, particularly the L<Copy Constructor>, +Note: in most cases, particularly the L</Copy Constructor>, this is unlikely to be appropriate behaviour. =back -See L<How Perl Chooses an Operator Implementation>. +See L</How Perl Chooses an Operator Implementation>. =head3 Copy Constructor @@ -890,7 +890,7 @@ on the type of their operands. As there is no way to instruct Perl to treat the operands as, e.g., numbers instead of strings, the result here may not be what you expect. -See L<BUGS AND PITFALLS>. +See L</BUGS AND PITFALLS>. =head2 Losing Overloading @@ -1413,12 +1413,12 @@ the tables of operations, and change the code which fills %subr to } Since subroutines implementing assignment operators are not required -to modify their operands (see L<Overloadable Operations> above), +to modify their operands (see L</Overloadable Operations> above), we do not need anything special to make C<+=> and friends work, besides adding these operators to %subr and defining a copy constructor (needed since Perl has no way to know that the implementation of C<'+='> does not mutate the argument - -see L<Copy Constructor>). +see L</Copy Constructor>). To implement a copy constructor, add C<< '=' => \&cpy >> to C<use overload> line, and code (this code assumes that mutators change things one level diff --git a/lib/unicore/uni_keywords.pl b/lib/unicore/uni_keywords.pl index fba605d697..22fd8c60cb 100644 --- a/lib/unicore/uni_keywords.pl +++ b/lib/unicore/uni_keywords.pl @@ -1215,7 +1215,7 @@ 1; # Generated from: -# d34c77b7e7a94986cc82056919f4ffc1503b73091561e16bd8ef145ac0fd04c5 lib/Unicode/UCD.pm +# 73902d92e2f05c2b707351006727708a3dc043d118f05aee169f70c117489d61 lib/Unicode/UCD.pm # 5e91b649379ec79af7cfb6b09410a24557cba4c6d733cd0a2b8a78a1448736d2 lib/unicore/ArabicShaping.txt # f5feb19cd084b2b1568fbc0f94f4b4b54941406e7fb36c7570f8352fd5022dbe lib/unicore/BidiBrackets.txt # e6cbd8ffe94f2e0fbfa6695d6c06c1e72eef7d3aa93cb6329d111285198b5e62 lib/unicore/BidiMirroring.txt diff --git a/lib/warnings.pm b/lib/warnings.pm index a77c1fc87e..ea067882b6 100644 --- a/lib/warnings.pm +++ b/lib/warnings.pm @@ -5,7 +5,7 @@ package warnings; -our $VERSION = "1.44"; +our $VERSION = "1.45"; # Verify that we're called correctly so that warnings will work. # Can't use Carp, since Carp uses us! @@ -719,7 +719,7 @@ X<-w> This is the existing flag. If the lexical warnings pragma is B<not> used in any of you code, or any of the modules that you use, this flag -will enable warnings everywhere. See L<Backward Compatibility> for +will enable warnings everywhere. See L</Backward Compatibility> for details of how this flag interacts with lexical warnings. =item B<-W> diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod index 3ae2cc56f4..c91665f035 100644 --- a/pod/perlpodspec.pod +++ b/pod/perlpodspec.pod @@ -98,6 +98,9 @@ no C<m/\A=cut/> line. it wouldn't be worth the confusion of having perl and pod2whatever actually disagree on what can constitute a Pod block. +Note that a parser is not expected to distinguish between something that +looks like pod, but is in a quoted string, such as a here document. + Within a Pod block, there are B<Pod paragraphs>. A Pod paragraph consists of non-blank lines of text, separated by one or more blank lines. diff --git a/pod/perlrun.pod b/pod/perlrun.pod index 77660ef17d..9a27fac655 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -1337,8 +1337,8 @@ B<Note> that any information about the hash function, especially the hash seed is B<sensitive information>: by knowing it, one can craft a denial-of-service attack against Perl code, even remotely; see L<perlsec/"Algorithmic Complexity Attacks"> for more information. B<Do not disclose the hash seed> to people who -don't need to know it. See also C<hash_seed()> and -C<key_traversal_mask()> in L<Hash::Util>. +don't need to know it. See also L<C<hash_seed()>|Hash::Util/hash_seed> and +L<C<hash_traversal_mask()>|Hash::Util/hash_traversal_mask>. An example output might be: diff --git a/pod/perltie.pod b/pod/perltie.pod index 5ee19c09ec..2d433e8204 100644 --- a/pod/perltie.pod +++ b/pod/perltie.pod @@ -171,7 +171,7 @@ X<UNTIE> This method will be triggered when the C<untie> occurs. This can be useful if the class needs to know when no further calls will be made. (Except DESTROY -of course.) See L<The C<untie> Gotcha> below for more details. +of course.) See L</The C<untie> Gotcha> below for more details. =item DESTROY this X<DESTROY> @@ -482,7 +482,7 @@ In our example, we'll use a little shortcut if there is a I<LIST>: =item UNTIE this X<UNTIE> -Will be called when C<untie> happens. (See L<The C<untie> Gotcha> below.) +Will be called when C<untie> happens. (See L</The C<untie> Gotcha> below.) =item DESTROY this X<DESTROY> @@ -838,7 +838,7 @@ L<Hash::Util/bucket_ratio> for a backwards compatibility path. =item UNTIE this X<UNTIE> -This is called when C<untie> occurs. See L<The C<untie> Gotcha> below. +This is called when C<untie> occurs. See L</The C<untie> Gotcha> below. =item DESTROY this X<DESTROY> @@ -1017,7 +1017,7 @@ X<UNTIE> As with the other types of ties, this method will be called when C<untie> happens. It may be appropriate to "auto CLOSE" when this occurs. See -L<The C<untie> Gotcha> below. +L</The C<untie> Gotcha> below. =item DESTROY this X<DESTROY> @@ -1042,7 +1042,7 @@ Here's how to use our little example: X<UNTIE> You can define for all tie types an UNTIE method that will be called -at untie(). See L<The C<untie> Gotcha> below. +at untie(). See L</The C<untie> Gotcha> below. =head2 The C<untie> Gotcha X<untie> diff --git a/regcharclass.h b/regcharclass.h index 1d9748037f..39d3a4b474 100644 --- a/regcharclass.h +++ b/regcharclass.h @@ -1855,7 +1855,7 @@ #endif /* PERL_REGCHARCLASS_H_ */ /* Generated from: - * d34c77b7e7a94986cc82056919f4ffc1503b73091561e16bd8ef145ac0fd04c5 lib/Unicode/UCD.pm + * 73902d92e2f05c2b707351006727708a3dc043d118f05aee169f70c117489d61 lib/Unicode/UCD.pm * 5e91b649379ec79af7cfb6b09410a24557cba4c6d733cd0a2b8a78a1448736d2 lib/unicore/ArabicShaping.txt * f5feb19cd084b2b1568fbc0f94f4b4b54941406e7fb36c7570f8352fd5022dbe lib/unicore/BidiBrackets.txt * e6cbd8ffe94f2e0fbfa6695d6c06c1e72eef7d3aa93cb6329d111285198b5e62 lib/unicore/BidiMirroring.txt diff --git a/regen/warnings.pl b/regen/warnings.pl index 255fb94732..d761e5d3d2 100644 --- a/regen/warnings.pl +++ b/regen/warnings.pl @@ -16,7 +16,7 @@ # # This script is normally invoked from regen.pl. -$VERSION = '1.44'; +$VERSION = '1.45'; BEGIN { require './regen/regen_lib.pl'; @@ -1027,7 +1027,7 @@ X<-w> This is the existing flag. If the lexical warnings pragma is B<not> used in any of you code, or any of the modules that you use, this flag -will enable warnings everywhere. See L<Backward Compatibility> for +will enable warnings everywhere. See L</Backward Compatibility> for details of how this flag interacts with lexical warnings. =item B<-W> diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat index d6e8b6af59..f402334324 100644 --- a/t/porting/known_pod_issues.dat +++ b/t/porting/known_pod_issues.dat @@ -53,6 +53,10 @@ Class::Tiny::Antlers Classic::Perl clearerr(3) clock(3) +clock_getres(3) +clock_gettime(2) +clock_nanosleep(3) +clock_settime(2) Clone closedir(2) connect(2) @@ -130,6 +134,7 @@ futimes(2) Future gcc(1) gdbm(3) +getitimer(2) Getopt::Std getpgrp(2) getpriority(2) @@ -277,6 +282,7 @@ sha1sum(1) shadow(3) Shell Shell::Command +sleep(3) sock_init(3) Socket socketpair(3) @@ -311,6 +317,7 @@ touch(1) tr(1) TryCatch tty(1) +ualarm(3) umask(2) Unicode::CaseFold Unicode::Casing diff --git a/uni_keywords.h b/uni_keywords.h index 8b629ae93f..6eebad3e26 100644 --- a/uni_keywords.h +++ b/uni_keywords.h @@ -7238,7 +7238,7 @@ MPH_VALt match_uniprop( const unsigned char * const key, const U16 key_len ) { } /* Generated from: - * d34c77b7e7a94986cc82056919f4ffc1503b73091561e16bd8ef145ac0fd04c5 lib/Unicode/UCD.pm + * 73902d92e2f05c2b707351006727708a3dc043d118f05aee169f70c117489d61 lib/Unicode/UCD.pm * 5e91b649379ec79af7cfb6b09410a24557cba4c6d733cd0a2b8a78a1448736d2 lib/unicore/ArabicShaping.txt * f5feb19cd084b2b1568fbc0f94f4b4b54941406e7fb36c7570f8352fd5022dbe lib/unicore/BidiBrackets.txt * e6cbd8ffe94f2e0fbfa6695d6c06c1e72eef7d3aa93cb6329d111285198b5e62 lib/unicore/BidiMirroring.txt diff --git a/utils/h2xs.PL b/utils/h2xs.PL index 92dce0d346..19f60e39d0 100644 --- a/utils/h2xs.PL +++ b/utils/h2xs.PL @@ -283,7 +283,7 @@ Note that some types of arguments/return-values for functions may result in XSUB-declarations/typemap-entries which need hand-editing. Such may be objects which cannot be converted from/to a pointer (like C<long long>), pointers to functions, or arrays. See -also the section on L<LIMITATIONS of B<-x>>. +also the section on L</LIMITATIONS of B<-x>>. =back diff --git a/utils/perlbug.PL b/utils/perlbug.PL index d1eb1e04a8..3181adee89 100644 --- a/utils/perlbug.PL +++ b/utils/perlbug.PL @@ -1313,7 +1313,7 @@ Type C<perl -v> at the command line to find out. =item Are you running the latest released version of perl? -Look at http://www.perl.org/ to find out. If you are not using the +Look at L<http://www.perl.org/> to find out. If you are not using the latest released version, please try to replicate your bug on the latest stable release. -- Perl5 Master Repository
