


CPANPLUS::Shell::PerluProgrammers RefCPANPLUS::Shell::Default(3p)


NAME
       CPANPLUS::Shell::Default - default CPANPLUS user interface

SYNOPSIS
           ### loading the shell:
           $ cpanp                     # run 'cpanp' from the command line
           $ perl -MCPANPLUS -eshell   # load the shell from the command line


           use CPANPLUS::Shell qw[Default];        # load this shell via the API
                                                   # always done via CPANPLUS::Shell

           my $ui = CPANPLUS::Shell->new;
           $ui->shell;                             # run the shell
           $ui->dispatch_on_input( input => 'x');  # update the source using the
                                                   # dispatch method

           ### when in the shell:
           ### Note that all commands can also take options.
           ### Look at their underlying CPANPLUS::Backend methods to see
           ### what options those are.
           cpanp> h                 # show help messages
           cpanp> ?                 # show help messages

           cpanp> m Acme            # find acme modules, allows regexes
           cpanp> a KANE            # find modules by kane, allows regexes
           cpanp> f Acme::Foo       # get a list of all releases of Acme::Foo

           cpanp> i Acme::Foo       # install Acme::Foo
           cpanp> i Acme-Foo-1.3    # install version 1.3 of Acme::Foo
           cpanp> i <URI>           # install from URI, like ftp://foo.com/X.tgz
           cpanp> i <DIR>           # install from an absolute or relative directory
           cpanp> i 1 3..5          # install search results 1, 3, 4 and 5
           cpanp> i *               # install all search results
           cpanp> a KANE; i *;      # find modules by kane, install all results
           cpanp> t Acme::Foo       # test Acme::Foo, without installing it
           cpanp> u Acme::Foo       # uninstall Acme::Foo
           cpanp> d Acme::Foo       # download Acme::Foo
           cpanp> z Acme::Foo       # download & extract Acme::Foo, then open a
                                    # shell in the extraction directory

           cpanp> c Acme::Foo       # get a list of test results for Acme::Foo
           cpanp> l Acme::Foo       # view details about the Acme::Foo package
           cpanp> r Acme::Foo       # view Acme::Foo's README file
           cpanp> o                 # get a list of all installed modules that
                                    # are out of date
           cpanp> o 1..3            # list uptodateness from a previous search

           cpanp> s conf            # show config settings
           cpanp> s conf md5 1      # enable md5 checks
           cpanp> s program         # show program settings
           cpanp> s edit            # edit config file
           cpanp> s reconfigure     # go through initial configuration again
           cpanp> s selfupdate      # update your CPANPLUS install



perl v5.10.1                2009-10-12                          1





CPANPLUS::Shell::PerluProgrammers RefCPANPLUS::Shell::Default(3p)


           cpanp> s save            # save config to disk
           cpanp> s mirrors         # show currently selected mirrors

           cpanp> ! [PERL CODE]     # execute the following perl code

           cpanp> b                 # create an autobundle for this computers
                                    # perl installation
           cpanp> x                 # reload index files (purges cache)
           cpanp> x --update_source # reload index files, get fresh source files
           cpanp> p [FILE]          # print error stack (to a file)
           cpanp> v                 # show the banner
           cpanp> w                 # show last search results again

           cpanp> q                 # quit the shell

           cpanp> /plugins          # list avialable plugins
           cpanp> /? PLUGIN         # list help test of <PLUGIN>

           ### common options:
           cpanp> i ... --skiptest # skip tests
           cpanp> i ... --force    # force all operations
           cpanp> i ... --verbose  # run in verbose mode

DESCRIPTION
       This module provides the default user interface to
       "CPANPLUS". You can start it via the "cpanp" binary, or as
       detailed in the SYNOPSIS.

BUG REPORTS
       Please report bugs or other issues to
       <bug-cpanplus@rt.cpan.org<gt>.

AUTHOR
       This module by Jos Boumans <kane@cpan.org>.

COPYRIGHT
       The CPAN++ interface (of which this module is a part of)
       is copyright (c) 2001 - 2007, Jos Boumans <kane@cpan.org>.
       All rights reserved.

       This library is free software; you may redistribute and/or
       modify it under the same terms as Perl itself.

SEE ALSO
       CPANPLUS::Shell::Classic, CPANPLUS::Shell, cpanp












perl v5.10.1                2009-10-12                          2


