NAME

Dist::Zilla::App::Command::stale - print your distribution's prerequisites and plugins that are out of date

VERSION

version 0.059

SYNOPSIS

  $ dzil stale --all | cpanm

DESCRIPTION

This is a command plugin for Dist::Zilla. It provides the stale command, which acts as [PromptIfStale] would during the build: compares the locally-installed version of a module(s) with the latest indexed version, and print all modules that are thus found to be stale. You could pipe that list to a CPAN client like cpanm to update all of the modules in one quick go.

When a [PromptIfStale] configuration is present in dist.ini, its configuration is honoured (unless --all is used); if there is no such configuration, behaviour is as for --all.

If not everything can be installed in one pass (typically, if a plugin used by dist.ini is missing), a message will be printed to STDERR and the exit code will be 1. This allows you to chain commands thusly:

    dzil stale --all | cpanm && dzil build && dzil test --release

OPTIONS

--all

Checks all plugins and prerequisites (as well as any additional modules listed in a local [PromptIfStale] configuration, if there is one).

I have a shell alias: alias unstale="dzil stale --all | cpanm" which I use quite regularly! You should do this too.

SEE ALSO

SUPPORT

Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-PromptIfStale@rt.cpan.org).

There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.

There is also an irc channel available for users of this distribution, at #distzilla on irc.perl.org.

I am also usually active on irc, as 'ether' at irc.perl.org and irc.libera.chat.

AUTHOR

Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENCE

This software is copyright (c) 2013 by Karen Etheridge.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.