.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CPAN-OUTDATED 1p"
.TH CPAN-OUTDATED 1p "2016-06-03" "perl v5.22.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
cpan\-outdated \- detect outdated CPAN modules in your environment
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&    # print the list of distribution that contains outdated modules
\&    % cpan\-outdated
\&
\&    # print the list of outdated modules in packages
\&    % cpan\-outdated \-p
\&
\&    # verbose
\&    % cpan\-outdated \-\-verbose
\&    

\&    # ignore core modules (do not update dual life modules)
\&    % cpan\-outdated \-\-exclude\-core
\&
\&    # alternate mirrors
\&    % cpan\-outdated \-\-mirror file:///home/user/minicpan/
\&
\&    # additional module path(same as cpanminus)
\&    % cpan\-outdated \-l extlib/
\&    % cpan\-outdated \-L extlib/
\&
\&    # install with cpan
\&    % cpan\-outdated | xargs cpan \-i
\&
\&    # install with cpanm
\&    % cpan\-outdated    | cpanm
\&    % cpan\-outdated \-p | cpanm
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This script prints the list of outdated \s-1CPAN\s0 modules in your machine.
.PP
It's same feature of 'CPAN::Shell\->r', but \f(CW\*(C`cpan\-outdated\*(C'\fR is much faster and uses less memory.
.PP
This script can be integrated with cpanm command.
.SH "PRINTING PACKAGES VS DISTRIBUTIONS"
.IX Header "PRINTING PACKAGES VS DISTRIBUTIONS"
This script by default prints the outdated distribution as in the \s-1CPAN\s0
distro format, i.e: \f(CW\*(C`A/AU/AUTHOR/Distribution\-Name\-0.10.tar.gz\*(C'\fR so
you can pipe into \s-1CPAN\s0 installers, but with \f(CW\*(C`\-p\*(C'\fR option it can be
tweaked to print the module's package names.
.PP
If you wish to manage a set of modules separately from your system
perl installation and not install newer versions of \*(L"dual life modules\*(R"
that are distributed with perl, the \f(CW\*(C`\-\-exclude\-core\*(C'\fR option will make
cpan-outdated ignore changes to core modules. Used with tools like
cpanm and its \f(CW\*(C`\-L \-\-local\-lib\-contained\*(C'\fR and \f(CW\*(C`\-\-self\-contained\*(C'\fR options,
this facilitates maintaining updates on standalone sets of modules.
.PP
For some tools such as cpanm installing from packages could be a
bit more useful since you can track to see the old version number
where you upgrade from.
.SH "AUTHOR"
.IX Header "AUTHOR"
Tokuhiro Matsuno
.SH "LICENSE"
.IX Header "LICENSE"
Copyright (C) 2009 Tokuhiro Matsuno.
.PP
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\s-1CPAN\s0
.PP
App::cpanminus
.PP
If you want to see what's changed for modules that require upgrades, use cpan-listchanges