X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/7c2e2b3aad03ef0fd13998f12cbe69265287c7b4..80acf91d9c504eaa12c9836e2ac3768613c88ac2:/pod/perlutil.pod diff --git a/pod/perlutil.pod b/pod/perlutil.pod index 3f53ad0..b41a611 100644 --- a/pod/perlutil.pod +++ b/pod/perlutil.pod @@ -35,11 +35,10 @@ 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 and L +=item L -As well as these two, there are two other converters: F will -produce HTML pages from POD, and F, which produces LaTeX -files. +As well as these two, there is another converter: F will +produce HTML pages from POD. =item L @@ -77,66 +76,14 @@ typeset PostScript or text file of the whole lot. =head2 Converters -To help you convert legacy programs to Perl, we've included three -conversion filters: - -=over 3 - -=item L - -F converts F scripts to Perl programs; for example, C -on the simple F script C<{print $2}> will produce a Perl program -based around this code: - - while (<>) { - ($Fld1,$Fld2) = split(/[:\n]/, $_, -1); - print $Fld2; - } - -=item L and L - -Similarly, F converts F scripts to Perl programs. F run -on C will produce a Perl program based around this: - - while (<>) { - chomp; - s/foo/bar/g; - print if $printit; - } - -When invoked as F, it behaves as a F implementation, written in -Perl. - -=item L - -Finally, F translates C commands to Perl equivalents which -use the L module. As an example, -C produces the following callback -subroutine for C: - - sub wanted { - my ($dev,$ino,$mode,$nlink,$uid,$gid); - (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_)) && - $uid == $uid{'root'}) && - (($mode & 0777) == 04000); - print("$name\n"); - } - -=back - -As well as these filters for converting other languages, the -L utility will help you convert old-style Perl 4 libraries to -new-style Perl5 modules. +To help you convert legacy programs to more modern Perl, the +L utility will help you convert old-style Perl 4 libraries +to new-style Perl5 modules. =head2 Administration =over 3 -=item L - -Query or change configuration of Perl modules that use Module::Build-based -configuration files for features and config data. - =item L To display and change the libnet configuration run the libnetcfg command. @@ -179,13 +126,6 @@ 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 and L - -F and F, which are actually the same program but behave -differently depending on how they are called, provide another way of -getting at C with Perl - they'll convert C structures and union declarations -to Perl code. This is deprecated in favour of F these days. - =item L F converts C header files into XS modules, and will try and write @@ -278,18 +218,6 @@ a lot more. It is similar to the command line mode of the L module, perl -MCPAN -e shell -=item L - -F is, like F, a command-line interface to the CPAN, using -the C module as a back-end. It can be used interactively or -imperatively. - -=item L - -F is a tool to create distributions (or packages) from CPAN -modules, then suitable for your package manager of choice. Support for -specific formats are available from CPAN as C modules. - =item L A little interface to ExtUtils::Installed to examine installed modules, @@ -302,10 +230,9 @@ validate your packlists and even create a tarball from an installed module. L, 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 +C, L, L, +L, L, L, L, +L, L, L, L, L, L, L, +L, L, L =cut