SYNOPSIS

First create a config file ~/pause.conf containing:

username=<Your PAUSE ID>
password=<Your PAUSE password>

or if you have ~/.pause from cpan-upload, pause can read it too (encrypted .pause is currently not supported).

Then:

# upload one or more files
% pause upload Foo-Bar-0.12.tar.gz Baz-2.24.tar.gz
% pause upload Foo-Bar-0.12.tar.gz --subdir old/2014; # upload to a subdir

# list your files
% pause ls
% pause ls 'App-*'; # accept filenames/wildcard patterns, note: quote first
% pause ls -l     ; # see file sizes/mtimes/etc instead of just names

# list your dists
% pause ls-dists

# delete files
% pause rm Foo-Bar-0.12.tar.gz Foo-Bar-0.12.readme Foo-Bar-0.12.meta
% pause rm 'Foo-Bar-*'; # accept wildcard patterns, but quote first

# undelete files scheduled for deletion (but not actually deleted yet)
% pause undelete Foo-Bar-0.12.tar.gz Foo-Bar-0.12.readme Foo-Bar-0.12.meta
% pause undelete 'Foo-Bar-*'; # accept wildcard patterns, but quote first

# force reindexing
% pause reindex Foo-Bar-0.12.tar.gz Foo-Bar-0.12.meta
% pause reindex 'Foo-Bar-*'; # accept wildcard patterns, but quote first

# clean old releases, by default will only leave the newest non-dev version
% pause cleanup
% pause cleanup -n 3 ; # keep 3 versions (newest + previous two)

To view permissions:

# list all modules that you have permissions of
% pause ls-mods
% pause ls-mods -l ; # show detail

# list all modules matching a wildcard
% pause ls-mods -l 'Unix*'

# list all modules you have co-maint of
% pause ls-mods -l --type co-maint

To change permissions (not yet implemented):

...

To change your password (not yet implemented):

...

To view your account info (not yet implemented):

...

To change your email forwarding (not yet implemented):

...

append:FILES

~/.pause