CPANPLUS::Shell::Default(3pm)				 Perl Programmers Reference Guide			     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 <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
	   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.12.1							    2010-04-26					     CPANPLUS::Shell::Default(3pm)