manpagez: man pages & more
man CPANPLUS::Shell::Default(3)
Home | html | info | man

CPANPLUS::Shell::Default(3pm)




NAME

       CPANPLUS::Shell::Default


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 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
           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(3), CPANPLUS::Shell(3), cpanp(3)



perl v5.10.0                      2007-12-18     CPANPLUS::Shell::Default(3pm)

Mac OS X 10.6 - Generated Thu Sep 17 20:11:10 CDT 2009
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.