cpan/perlfaq - Update to version 5.20250619

5.20250619  2025-06-19 00:43:39Z
  * fix reference to tty (PR#117, Jakub Wilk)
  * various typo fixes (numerous PRs: Elvin Aslanov, Dan Book, Dave Cross,
    vaitkus)
  * remove mention of TCP::Client (PR#139, vaitkus)
  * modernized references to random number modules (PR#143, Robert Rothenberg)
  * added "phaser" to glossary (PR#146, James E Keenan)

Author: karenetheridge

Porting/Maintainers.pl

@@ -916,7 +916,8 @@ package Maintainers;
     },
 
     'perlfaq' => {
-        'DISTRIBUTION' => 'ETHER/perlfaq-5.20240218.tar.gz',
+        'DISTRIBUTION' => 'ETHER/perlfaq-5.20250619.tar.gz',
+        'SYNCINFO'     => 'ether on Wed Jun 18 20:32:25 2025',
         'FILES'        => q[cpan/perlfaq],
         'EXCLUDED'     => [ qr/^inc/, qr/^xt/, qr{^t/00-} ],
     },

cpan/perlfaq/lib/perlfaq.pm

@@ -2,6 +2,6 @@ use strict;
 use warnings;
 package perlfaq;
 
-our $VERSION = '5.20240218';
+our $VERSION = '5.20250619';
 
 1;

cpan/perlfaq/lib/perlfaq.pod

@@ -4,7 +4,7 @@ perlfaq - Frequently asked questions about Perl
 
 =head1 VERSION
 
-version 5.20240218
+version 5.20250619
 
 =head1 DESCRIPTION
 
@@ -1380,7 +1380,7 @@ patches and corrections over the years.
 =head1 AUTHOR AND COPYRIGHT
 
 Tom Christiansen wrote the original version of this document.
-brian d foy C<< <[email protected]> >> wrote this version. See the
+brian d foy C<< <[email protected]> >> wrote this version. See the
 individual perlfaq documents for additional copyright information.
 
 This document is available under the same terms as Perl itself. Code

cpan/perlfaq/lib/perlfaq1.pod

@@ -1,10 +1,14 @@
+=pod
+
+=encoding UTF-8
+
 =head1 NAME
 
 perlfaq1 - General Questions About Perl
 
 =head1 VERSION
 
-version 5.20240218
+version 5.20250619
 
 =head1 DESCRIPTION
 
@@ -212,7 +216,7 @@ and L<community|http://www.perl.org/community.html> which surrounds it.
 For comparisons to a specific language it is often best to create
 a small project in both languages and compare the results, make sure
 to use all the L<resources|http://www.cpan.org/> of each language,
-as a language is far more than just it's syntax.
+as a language is far more than just its syntax.
 
 =head2 Can I do [task] in Perl?
 
@@ -327,3 +331,5 @@ domain. You are permitted and encouraged to use this code and any
 derivatives thereof in your own programs for fun or for profit as you
 see fit. A simple comment in the code giving credit to the FAQ would
 be courteous but is not required.
+
+=cut

cpan/perlfaq/lib/perlfaq2.pod

@@ -8,7 +8,7 @@ perlfaq2 - Obtaining and Learning about Perl
 
 =head1 VERSION
 
-version 5.20240218
+version 5.20250619
 
 =head1 DESCRIPTION
 
@@ -27,7 +27,7 @@ all known and current Unix derivatives are supported (perl's native
 platform), as are other systems like VMS, DOS, OS/2, Windows,
 QNX, BeOS, OS X, MPE/iX and the Amiga.
 
-Binary distributions for some proprietary platforms can be found
+Binary distributions for some proprietary platforms can be found in the
 L<http://www.cpan.org/ports/> directory. Because these are not part of
 the standard distribution, they may and in fact do differ from the
 base perl port in a variety of ways. You'll have to check their
@@ -120,8 +120,8 @@ L<view online|http://perldoc.perl.org/perl.html>.
 (Some operating system distributions may ship the documentation in a different
 package; for instance, on Debian, you need to install the C<perl-doc> package.)
 
-Many good books have been written about Perl--see the section later in
-L<perlfaq2> for more details.
+Many good books have been written about Perl--see the L</"Perl Books"> section
+for more details.
 
 =head2 What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
 
@@ -162,7 +162,7 @@ See L<What is CPAN?|/"What modules and extensions are available for Perl? What i
 
 =head2 Where can I post questions?
 
-There are many Perl L<mailing lists|lists.perl.org> for various
+There are many Perl L<mailing lists|https://lists.perl.org> for various
 topics, specifically the L<beginners list|http://lists.perl.org/list/beginners.html>
 may be of use.
 
@@ -229,13 +229,13 @@ To determine if a module came with your version of Perl, you can
 install and use L<Module::CoreList>. It knows the modules (with their
 versions) included with each release of Perl:
 
-	$ corelist File::Copy
-	Data for 2023-07-02
-	File::Copy was first released with perl 5.002
+    $ corelist File::Copy
+    Data for 2023-07-02
+    File::Copy was first released with perl 5.002
 
-	$ corelist Business::ISBN
-	Data for 2023-07-02
-	Business::ISBN was not in CORE (or so I think)
+    $ corelist Business::ISBN
+    Data for 2023-07-02
+    Business::ISBN was not in CORE (or so I think)
 
 If the module does not come with Perl, report its issues
 using the tool that the particular module author decided to use, such as
@@ -252,14 +252,14 @@ Use the directions you find.
 Sometimes the module author does not declare a bugtracker. For a long
 time, everyone assumed that the CPAN Request Tracker
 (L<https://rt.cpan.org>) was the bugtracker since every distribution had
-an RT queue generated automatically. In somes cases, the author might
+an RT queue generated automatically. In some cases, the author might
 use CPAN RT. They also might have not declared a different
 bugtracker but don't use CPAN RT.
 
 Submit bugs to RT either through its web interface,
 L<https://rt.cpan.org>, or by email. Send email to I<<
 bug-E<lt>distribution-nameE<gt>@rt.cpan.org >>. For example, if you
-wanted to report a bug in the example module L<Foo::Bar>, you could send
+wanted to report a bug in the example module C<Foo::Bar>, you could send
 a message to I<[email protected]>.
 
 =head1 AUTHOR AND COPYRIGHT

cpan/perlfaq/lib/perlfaq3.pod

@@ -1,10 +1,14 @@
+=pod
+
+=encoding UTF-8
+
 =head1 NAME
 
 perlfaq3 - Programming Tools
 
 =head1 VERSION
 
-version 5.20240218
+version 5.20250619
 
 =head1 DESCRIPTION
 
@@ -99,7 +103,7 @@ Have you read the appropriate manpages? Here's a brief index:
 
 =item L<perlre> - Perl regular expressions
 
-=item L<perlfunc> - Perl builtin functions>
+=item L<perlfunc> - Perl builtin functions
 
 =item L<perlop> - Perl operators and precedence
 
@@ -173,7 +177,7 @@ that C<CPAN.pm> understands and can use to re-install every module:
     $ cpan -a
 
 Inside a Perl program, you can use the L<ExtUtils::Installed> module to
-show all installed distributions, although it can take awhile to do
+show all installed distributions, although it can take a while to do
 its magic. The standard library which comes with Perl just shows up
 as "Perl" (although you can get those with L<Module::CoreList>).
 
@@ -296,8 +300,8 @@ or I<Mastering Perl>, chapter 5.
 L<perldebguts> documents creating a custom debugger if you need to
 create a special sort of profiler. brian d foy describes the process
 in I<The Perl Journal>, "Creating a Perl Debugger",
-L<http://www.ddj.com/184404522> , and "Profiling in Perl"
-L<http://www.ddj.com/184404580> .
+L<https://drdobbs.com/creating-a-perl-debugger/184404522> , and
+"Profiling in Perl" L<https://drdobbs.com/profiling-in-perl/184404580> .
 
 Perl.com has two interesting articles on profiling: "Profiling Perl",
 by Simon Cozens, L<https://www.perl.com/pub/2004/06/25/profiling.html/>
@@ -362,12 +366,12 @@ L<http://e-p-i-c.sf.net/>
 The Eclipse Perl Integration Project integrates Perl
 editing/debugging with Eclipse.
 
-=item Enginsite
+=item EngInSite
 
 L<http://www.enginsite.com/>
 
 Perl Editor by EngInSite is a complete integrated development
-environment (IDE) for creating, testing, and  debugging  Perl scripts;
+environment (IDE) for creating, testing, and debugging Perl scripts;
 the tool runs on Windows 9x/NT/2000/XP or later.
 
 =item IntelliJ IDEA
@@ -406,7 +410,7 @@ under Windows 95/98/NT/2000.
 
 =item OptiPerl
 
-L<http://www.optiperl.com/>
+L<https://www.uptiv.com/free/optiperl/>
 
 OptiPerl is a Windows IDE with simulated CGI environment, including
 debugger and syntax-highlighting editor.
@@ -575,7 +579,7 @@ Note that the perl-mode of emacs will have fits with C<"main'foo">
 are probably using C<"main::foo"> in new Perl code anyway, so this
 shouldn't be an issue.
 
-For CPerlMode, see L<http://www.emacswiki.org/cgi-bin/wiki/CPerlMode>
+For CPerlMode, see L<https://www.emacswiki.org/emacs/CPerlMode>
 
 =head2 How can I use curses with Perl?
 
@@ -1141,3 +1145,5 @@ domain. You are permitted and encouraged to use this code and any
 derivatives thereof in your own programs for fun or for profit as you
 see fit. A simple comment in the code giving credit to the FAQ would
 be courteous but is not required.
+
+=cut