1CPAN(1)                Perl Programmers Reference Guide                CPAN(1)
2
3
4

NAME

6       cpan - easily interact with CPAN from the command line
7

SYNOPSIS

9               # with arguments, installs specified modules
10               cpan module_name [ module_name ... ]
11
12               # with switches, installs modules with extra behavior
13               cpan [-cimt] module_name [ module_name ... ]
14
15               # without arguments, starts CPAN shell
16               cpan
17
18               # without arguments, but some switches
19               cpan [-ahrv]
20

DESCRIPTION

22       This script provides a command interface (not a shell) to CPAN.pm.
23
24       Meta Options
25
26       These options are mutually exclusive, and the script processes them in
27       this order: [ahvr].  Once the script finds one, it ignores the others,
28       and then exits after it finishes the task.  The script ignores any
29       other command line options.
30
31       -a  Creates the CPAN.pm autobundle with CPAN::Shell->autobundle.
32
33       -h  Prints a help message.
34
35       -r  Recompiles dynamically loaded modules with CPAN::Shell->recompile.
36
37       -v  Print the script version and CPAN.pm version.
38
39       Module options
40
41       These options are mutually exclusive, and the script processes them in
42       alphabetical order.
43
44       c   Runs a `make clean` in the specified module's directories.
45
46       i   Installed the specified modules.
47
48       m   Makes the specified modules.
49
50       t   Runs a `make test` on the specified modules.
51
52       Examples
53
54               # print a help message
55               cpan -h
56
57               # print the version numbers
58               cpan -v
59
60               # create an autobundle
61               cpan -a
62
63               # recompile modules
64               cpan -r
65
66               # install modules
67               cpan -i Netscape::Booksmarks Business::ISBN
68

TO DO

70       * add options for other CPAN::Shell functions autobundle, clean, make,
71       recompile, test
72

BUGS

74       * none noted
75

SEE ALSO

77       Most behaviour, including environment variables and configuration,
78       comes directly from CPAN.pm.
79

AUTHOR

81       brian d foy <bdfoy@cpan.org>
82
83
84
85perl v5.8.8                       2008-05-05                           CPAN(1)