NAME

App::PMUtils - Command line to manipulate Perl module files

VERSION

This document describes version 0.26 of App::PMUtils (from Perl distribution App-PMUtils), released on 2014-09-09.

SYNOPSIS

This distribution provides the following command-line utilities:

 pmbin
 pmcore
 pmcost
 pmdoc
 pmedit
 pminfo
 pmless
 pmlist
 pmman
 pmpath
 pmuninst
 pmversion
 podpath

These utilities have tab completion capability. To activate it, put these lines to your bash startup file (e.g. /etc/bash.bashrc, ~/.bash_profile, or ~/.bashrc):

 for p in \
   pmbin pmcore pmcost pmdoc pmedit pminfo pmless pmlist pmman pmpath \
   pmuninst pmversion podpath; do
     complete -C $p $p
 done

FAQ

What is the purpose of this distribution? Haven't other utilities existed?

For example, mpath in Module::Path distribution, mversion in Module::Version distribution, etc.

True. The main point of these utilities is shell tab completion, to save typing.

In shell completion, why do you use / (slash) instead of :: (double colon) as it should be?

If you type module name which doesn't contain any ::, / will be used as namespace separator. Otherwise if you already type ::, it will use ::.

Colon is problematic because by default it is a word breaking character in bash. This means, in this command:

 % pmpath Text:<tab>

bash is completing a new word (empty string), and in this:

 % pmpath Text::ANSITabl<tab>

bash is completing ANSITabl instead of what we want Text::ANSITabl.

The solution is to use quotes, e.g.

 % pmpath "Text:<tab>
 % pmpath 'Text:<tab>

or, use /.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-PMUtils.

SOURCE

Source repository is at https://github.com/perlancar/perl-App-PMUtils.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-PMUtils

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm App::PMUtils

perl -MCPAN -e shell
install App::PMUtils