=pod
=encoding utf8
=head1 The PerlPowerTools module
This is the I
There are some other ways that might get you to the same thing (and are probably better supported):
=over 4
=item * With the L<Windows Subsytem for Linux|https://docs.microsoft.com/en-us/windows/wsl/> (WSL), you can run a linux right in a console
=item * The L<GNU coreutils|https://www.gnu.org/software/coreutils>
=item * L<Cygwin|https://www.cygwin.com>
=item * L<GNUWin|http://gnuwin32.sourceforge.net/summary.html>
=back
=head2 Documentation
To read about L
% perldoc lib/PerlPowerTools.pm
If you have already installed the module, you can specify the module name instead of the file location:
% perldoc PerlPowerTools
You can read the documentation and inspect the meta data at L<MetaCPAN|https://metacpan.org/pod/PerlPowerTools>.
The standard module documentation has example uses in the SYNOPSIS
section, but you can also look in the I
=head2 Installation
You can install this module with a CPAN client, which will resolve and install the dependencies:
% cpan PerlPowerTools
% cpanm PerlPowerTools
You can also install directly from the distribution directory, which will also install the dependencies:
% cpan .
% cpanm .
You could install just this module manually:
% perl Makefile.PL
% make
% make test
% make install
If you didn't specify INSTALL_BASE, the modules go into your home
directory under F
If you want to install them somewhere else, run the Makefile.PL with your installation location:
perl Makefile.PL INSTALL_BASE=/where/you/want/them/to/go
=head2 Source location
The meta data, such as the source repository and bug tracker, is in
I
If you find a problem, file a ticket in the L<issue tracker|https://github.com/briandfoy/PerlPowerTools/issues>/
Starting with v1.046, PerlPowerTools now uses L<GitHub Attestations|https://github.blog/2024-05-02-introducing-artifact-attestations-now-in-public-beta/>, which allow you to verify that the archive file you have was made from the official repo.
You need a GitHub account and the L<gh tool|https://github.com/larsks/ghcli>.
# download the distro file from GitHub, MetaCPAN, or a CPAN mirror
$ gh auth login
...follow instructions...
$ gh attestation verify PerlPowerTools-1.046.tar.gz --owner briandfoy
=head2 Getting help
Although I'm happy to hear from module users in private email, that's the best way for me to forget to do something.
Besides the issue trackers, you can find help at L<Perlmonks|http://www.perlmonks.org> or L<Stackoverflow|http://www.stackoverflow.com>, both of which have many competent Perlers who can answer your question, almost in real time. They might not know the particulars of this module, but they can help you diagnose your problem.
You might like to read L<brian's Guide to Solving Any Perl Problem|https://briandfoy.github.io/brians-guide-to-solving-any-perl-problem/>.
=head2 Copyright and License
You should have received a I
=head2 Good luck!
Enjoy,
brian d foy, briandfoy@pobox.com
=cut