1. NAME▲
cpanp - The CPANPLUS launcher
2. SYNOPSIS ▲
cpanp
cpanp [-]a [ --[no-]option... ] author...\
cpanp [-]mfitulrcz [ --[no-]option... ] module...\
cpanp [-]d [ --[no-]option... ] [ --fetchdir=... ] module...\
cpanp [-]xb [ --[no-]option... ]
cpanp [-]o [ --[no-]option... ] [ module... ]
3. DESCRIPTION ▲
This script launches the CPANPLUS utility to perform various operations from the command line. If it's invoked without arguments, an interactive shell is executed by default.
Optionally, it can take a single-letter switch and one or more argument, to perform the associated action on each arguments. A summary of the available commands is listed below; \f(CW\*(C`cpanp -h\*(C'\fR provides a detailed list.
h # help information v # version information a AUTHOR ... # search by author(s) m MODULE ... # search by module(s) f MODULE ... # list all releases of a module i MODULE ... # install module(s) t MODULE ... # test module(s) u MODULE ... # uninstall module(s) d MODULE ... # download module(s) l MODULE ... # display detailed information about module(s) r MODULE ... # display README files of module(s) c MODULE ... # check for module report(s) from cpan-testers z MODULE ... # extract module(s) and open command prompt in it x # reload CPAN indices o [ MODULE ... ] # list installed module(s) that aren\*(Aqt up to date b # write a bundle file for your configuration
Each command may be followed by one or more options. If preceded by \f(CW\*(C`no\*(C'\fR, the corresponding option will be set to \f(CW0\fR, otherwise it's set to \f(CW1\fR.
Example: To skip a module's tests,
cpanp -i --skiptest MODULE ...
Valid options for most commands are \f(CW\*(C`cpantest\*(C'\fR, \f(CW\*(C`debug\*(C'\fR, \f(CW\*(C`flush\*(C'\fR, \f(CW\*(C`force\*(C'\fR, \f(CW\*(C`prereqs\*(C'\fR, \f(CW\*(C`storable\*(C'\fR, \f(CW\*(C`verbose\*(C'\fR, \f(CW\*(C`md5\*(C'\fR, \f(CW\*(C`signature\*(C'\fR, and \f(CW\*(C`skiptest\*(C'\fR; the 'd' command also accepts \f(CW\*(C`fetchdir\*(C'\fR. Please consult CPANPLUS::Configure for an explanation to their meanings.
Example: To download a module's tarball to the current directory,
cpanp -d --fetchdir=. MODULE ...