From 43f856bae111d54f354ee7393baba1cf1617a769 Mon Sep 17 00:00:00 2001 From: Dan Book Date: Tue, 6 Oct 2020 19:34:33 -0400 Subject: perlutil updates and cleanup - Add missing encguess, json_pp, and streamzip utilities - Normalize item entries for utilities so they are equally visible and linkable - Normalize usage of F<> on unlinked executables - Normalize linking to referenced modules - Simplify links with duplicate text - Clean up SEE ALSO --- pod/perlutil.pod | 75 +++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 47 insertions(+), 28 deletions(-) (limited to 'pod/perlutil.pod') diff --git a/pod/perlutil.pod b/pod/perlutil.pod index 2703815464..c5b60e9d29 100644 --- a/pod/perlutil.pod +++ b/pod/perlutil.pod @@ -17,9 +17,9 @@ if appropriate. =over 3 -=item L +=item L -The main interface to Perl's documentation is C, although +The main interface to Perl's documentation is F, although if you're reading this, it's more than likely that you've already found it. F will extract and format the documentation from any file in the current directory, any Perl module installed on the system, or @@ -27,7 +27,9 @@ any of the standard documentation pages, such as this one. Use CnameE> to get information on any of the utilities described in this document. -=item L and L +=item L + +=item L If it's run from a terminal, F will usually call F to translate POD (Plain Old Documentation - see L for an @@ -35,31 +37,31 @@ explanation) into a manpage, and then run F to display it; if F isn't available, F will be used instead and the output piped through your favourite pager. -=item L +=item L As well as these two, there is another converter: F will produce HTML pages from POD. -=item L +=item L If you just want to know how to use the utilities described here, F will just extract the "USAGE" section; some of the utilities will automatically call F on themselves when you call them with C<-help>. -=item L +=item L If you're writing your own documentation in POD, the F utility will look for errors in your markup. -=item L +=item L F is an interface to L - paste in your error message to it, and it'll explain it for you. -=item C +=item F -The C utility is not installed on your system but lives in +The F utility is not installed on your system but lives in the F directory of your Perl source kit; it converts all the documentation from the distribution to F<*roff> format, and produces a typeset PostScript or text file of the whole lot. @@ -68,15 +70,21 @@ typeset PostScript or text file of the whole lot. =head2 Converters +=over 3 + +=item L + To help you convert legacy programs to more modern Perl, the -L utility will help you convert old-style Perl 4 libraries +F utility will help you convert old-style Perl 4 libraries to new-style Perl5 modules. +=back + =head2 Administration =over 3 -=item L +=item L To display and change the libnet configuration run the libnetcfg command. @@ -96,7 +104,7 @@ and in particular, extending Perl with C. =over 3 -=item L +=item L F used to be the recommended way to report bugs in the perl interpreter itself or any of the standard library modules back to the @@ -109,7 +117,7 @@ This program provides an easy way to send a thank-you message back to the authors and maintainers of perl. It's just F installed under another name. -=item L +=item L Back before Perl had the XS system for connecting with C libraries, programmers used to get library constants by reading through the C @@ -118,7 +126,7 @@ around - the F<.ph> file should be created by running F on the corresponding F<.h> file. See the F documentation for more on how to convert a whole bunch of header files at once. -=item L +=item L F converts C header files into XS modules, and will try and write as much glue between C libraries and Perl modules as it can. It's also @@ -144,11 +152,11 @@ necessary to let Perl access those functions. =item L F is a command-line interface to the test-running functionality -of F. It's an alternative to C. +of L. It's an alternative to C. =item L -A command-line front-end to C, to query what modules +A command-line front-end to L, to query what modules were shipped with given versions of perl. =back @@ -160,9 +168,17 @@ came along modules included in the perl distribution. =over 3 +=item L + +F will attempt to guess the character encoding of files. + +=item L + +F is a pure Perl JSON converter and formatter. + =item L -B is a Perl version of B, a character encoding converter +F is a Perl version of L, a character encoding converter widely available for various Unixen today. This script was primarily a technology demonstrator for Perl v5.8.0, but you can use piconv in the place of iconv for virtually any case. @@ -175,7 +191,7 @@ F is a tar-like program, written in pure Perl. F is a small utility that produces a diff between an extracted archive and an unextracted one. (Note that this utility requires the -C module to function properly; this module isn't distributed +L module to function properly; this module isn't distributed with perl, but is available from the CPAN.) =item L @@ -185,12 +201,16 @@ in a tar archive. =item L -This utility, that comes with the C module, is used to print +This utility, that comes with the L module, is used to print or verify SHA checksums. +=item L + +F compresses data streamed to STDIN into a streamed zip container. + =item L -L displays information about the internal record structure of the zip file. +F displays information about the internal record structure of the zip file. It is not concerned with displaying any details of the compressed data stored in the zip file. =back @@ -212,19 +232,18 @@ a lot more. It is similar to the command line mode of the L module, =item L -A little interface to ExtUtils::Installed to examine installed modules, +A little interface to L to examine installed modules, validate your packlists and even create a tarball from an installed module. =back =head1 SEE ALSO -L, L, L, -L, L, -L, L, L, -C, L, L, -L, L, L, L, -L, L, L, L, L, L, L, -L, L, L +L, L, L, L, L, +L, L, L, +L, L, L, L, +L, L, L, L, L, +L, L, L, L, +L, L, L, L =cut -- cgit v1.2.1