1CPANPLUS::Shell::DefaulUts(e3r)Contributed Perl DocumentCaPtAiNoPnLUS::Shell::Default(3)
2
3
4

NAME

6       CPANPLUS::Shell::Default - the default CPANPLUS shell
7

SYNOPSIS

9           ### loading the shell:
10           $ cpanp                     # run 'cpanp' from the command line
11           $ perl -MCPANPLUS -eshell   # load the shell from the command line
12
13
14           use CPANPLUS::Shell qw[Default];        # load this shell via the API
15                                                   # always done via CPANPLUS::Shell
16
17           my $ui = CPANPLUS::Shell->new;
18           $ui->shell;                             # run the shell
19           $ui->dispatch_on_input( input => 'x');  # update the source using the
20                                                   # dispatch method
21
22           ### when in the shell:
23           ### Note that all commands can also take options.
24           ### Look at their underlying CPANPLUS::Backend methods to see
25           ### what options those are.
26           cpanp> h                 # show help messages
27           cpanp> ?                 # show help messages
28
29           cpanp> m Acme            # find acme modules, allows regexes
30           cpanp> a KANE            # find modules by kane, allows regexes
31           cpanp> f Acme::Foo       # get a list of all releases of Acme::Foo
32
33           cpanp> i Acme::Foo       # install Acme::Foo
34           cpanp> i Acme-Foo-1.3    # install version 1.3 of Acme::Foo
35           cpanp> i <URI>           # install from URI, like ftp://foo.com/X.tgz
36           cpanp> i <DIR>           # install from an absolute or relative directory
37           cpanp> i 1 3..5          # install search results 1, 3, 4 and 5
38           cpanp> i *               # install all search results
39           cpanp> a KANE; i *;      # find modules by kane, install all results
40           cpanp> t Acme::Foo       # test Acme::Foo, without installing it
41           cpanp> u Acme::Foo       # uninstall Acme::Foo
42           cpanp> d Acme::Foo       # download Acme::Foo
43           cpanp> z Acme::Foo       # download & extract Acme::Foo, then open a
44                                    # shell in the extraction directory
45
46           cpanp> c Acme::Foo       # get a list of test results for Acme::Foo
47           cpanp> l Acme::Foo       # view details about the Acme::Foo package
48           cpanp> r Acme::Foo       # view Acme::Foo's README file
49           cpanp> o                 # get a list of all installed modules that
50                                    # are out of date
51           cpanp> o 1..3            # list uptodateness from a previous search
52
53           cpanp> s conf            # show config settings
54           cpanp> s conf md5 1      # enable md5 checks
55           cpanp> s program         # show program settings
56           cpanp> s edit            # edit config file
57           cpanp> s reconfigure     # go through initial configuration again
58           cpanp> s selfupdate      # update your CPANPLUS install
59           cpanp> s save            # save config to disk
60           cpanp> s mirrors         # show currently selected mirrors
61
62           cpanp> ! [PERL CODE]     # execute the following perl code
63
64           cpanp> b                 # create an autobundle for this computers
65                                    # perl installation
66           cpanp> x                 # reload index files (purges cache)
67           cpanp> x --update_source # reload index files, get fresh source files
68           cpanp> p [FILE]          # print error stack (to a file)
69           cpanp> v                 # show the banner
70           cpanp> w                 # show last search results again
71
72           cpanp> q                 # quit the shell
73           cpanp> e                 # exit the shell and reload
74
75           cpanp> /plugins          # list available plugins
76           cpanp> /? PLUGIN         # list help test of <PLUGIN>
77
78           ### common options:
79           cpanp> i ... --skiptest # skip tests
80           cpanp> i ... --force    # force all operations
81           cpanp> i ... --verbose  # run in verbose mode
82

DESCRIPTION

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

BUG REPORTS

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

AUTHOR

91       This module by Jos Boumans <kane@cpan.org>.
92
94       The CPAN++ interface (of which this module is a part of) is copyright
95       (c) 2001 - 2007, Jos Boumans <kane@cpan.org>. All rights reserved.
96
97       This library is free software; you may redistribute and/or modify it
98       under the same terms as Perl itself.
99

SEE ALSO

101       CPANPLUS::Shell::Classic, CPANPLUS::Shell, cpanp
102
103
104
105perl v5.16.3                      2013-05-20       CPANPLUS::Shell::Default(3)
Impressum