1CPAN-UPLOAD(1)        User Contributed Perl Documentation       CPAN-UPLOAD(1)
2
3
4

NAME

6       cpan-upload - upload a distribution to the CPAN
7

VERSION

9       version 0.103016
10

PERL VERSION

12       This library should run on perls released even a long time ago.  It
13       should work on any version of perl released in the last five years.
14
15       Although it may work on older versions of perl, no guarantee is made
16       that the minimum required version will not be increased.  The version
17       may be increased for any reason, and there is no promise that patches
18       will be accepted to lower the minimum required perl.
19

USAGE

21         usage: cpan-upload [options] file-to-upload-1 [ file-to-upload-2 ... ]
22           -v --verbose       enable verbose logging
23           -h --help          display this help message
24           --dry-run          do not actually upload anything
25
26           -u --user          your PAUSE username
27           -p --password      the password to your PAUSE account
28           -d --directory     a dir in your CPAN space in which to put the file
29           --http-proxy       URL of the http proxy to use in uploading
30           --ignore-errors    instead of aborting, continue to next file on error
31           -c --config        config file to use; defaults to ~/.pause
32           --md5              compute MD5 checksums of the files
33           --retries          number of retries to perform on upload failure
34           --retry-delay      number of seconds to wait between retries
35

CONFIGURATION

37       If you have a ".pause" file in your home directory, it will be checked
38       for a username and password.  It should look like this:
39
40         user EXAMPLE
41         password your-secret-password
42
43       You can GnuPG-encrypt this file if you wish, but you must install
44       Config::Identity and configure your gpg-agent as Config::Identity
45       currently doesn't prompt for a password at decryption time:
46
47           # Follow the prompts, setting your key as the "recipient"
48           # Use ^D once you've finished typing out your authentication information
49           gpg -ea > $HOME/.pause
50           # OR, encrypt a file you already created:
51           gpg -ea $HOME/.pause && mv $HOME/.pause{.asc,}
52

SEE ALSO

54       CPAN::Uploader
55       Config::Identity
56

AUTHOR

58       Ricardo SIGNES <rjbs@semiotic.systems>
59
61       This software is copyright (c) 2021 by Ricardo SIGNES.
62
63       This is free software; you can redistribute it and/or modify it under
64       the same terms as the Perl 5 programming language system itself.
65
66
67
68perl v5.36.0                      2022-07-22                    CPAN-UPLOAD(1)
Impressum