.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 >0, 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
.\" ========================================================================
.\"
.IX Title "CORELIST 1p"
.TH CORELIST 1p 2023-09-25 "perl v5.38.0" "Perl Programmers Reference Guide"
.\" 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
corelist \- a commandline frontend to Module::CoreList
.SH DESCRIPTION
.IX Header "DESCRIPTION"
See Module::CoreList for one.
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 9
\&   corelist \-v
\&   corelist [\-a|\-d] <ModuleName> | /<ModuleRegex>/ [<ModuleVersion>] ...
\&   corelist [\-v <PerlVersion>] [ <ModuleName> | /<ModuleRegex>/ ] ...
\&   corelist [\-r <PerlVersion>] ...
\&   corelist \-\-utils [\-d] <UtilityName> [<UtilityName>] ...
\&   corelist \-\-utils \-v <PerlVersion>
\&   corelist \-\-feature <FeatureName> [<FeatureName>] ...
\&   corelist \-\-diff PerlVersion PerlVersion
\&   corelist \-\-upstream <ModuleName>
.Ve
.SH OPTIONS
.IX Header "OPTIONS"
.IP \-a 4
.IX Item "-a"
lists all versions of the given module (or the matching modules, in case you
used a module regexp) in the perls Module::CoreList knows about.
.Sp
.Vb 1
\&    corelist \-a Unicode
\&
\&    Unicode was first released with perl v5.6.2
\&      v5.6.2     3.0.1
\&      v5.8.0     3.2.0
\&      v5.8.1     4.0.0
\&      v5.8.2     4.0.0
\&      v5.8.3     4.0.0
\&      v5.8.4     4.0.1
\&      v5.8.5     4.0.1
\&      v5.8.6     4.0.1
\&      v5.8.7     4.1.0
\&      v5.8.8     4.1.0
\&      v5.8.9     5.1.0
\&      v5.9.0     4.0.0
\&      v5.9.1     4.0.0
\&      v5.9.2     4.0.1
\&      v5.9.3     4.1.0
\&      v5.9.4     4.1.0
\&      v5.9.5     5.0.0
\&      v5.10.0    5.0.0
\&      v5.10.1    5.1.0
\&      v5.11.0    5.1.0
\&      v5.11.1    5.1.0
\&      v5.11.2    5.1.0
\&      v5.11.3    5.2.0
\&      v5.11.4    5.2.0
\&      v5.11.5    5.2.0
\&      v5.12.0    5.2.0
\&      v5.12.1    5.2.0
\&      v5.12.2    5.2.0
\&      v5.12.3    5.2.0
\&      v5.12.4    5.2.0
\&      v5.13.0    5.2.0
\&      v5.13.1    5.2.0
\&      v5.13.2    5.2.0
\&      v5.13.3    5.2.0
\&      v5.13.4    5.2.0
\&      v5.13.5    5.2.0
\&      v5.13.6    5.2.0
\&      v5.13.7    6.0.0
\&      v5.13.8    6.0.0
\&      v5.13.9    6.0.0
\&      v5.13.10   6.0.0
\&      v5.13.11   6.0.0
\&      v5.14.0    6.0.0
\&      v5.14.1    6.0.0
\&      v5.15.0    6.0.0
.Ve
.IP \-d 4
.IX Item "-d"
finds the first perl version where a module has been released by
date, and not by version number (as is the default).
.IP \-\-diff 4
.IX Item "--diff"
Given two versions of perl, this prints a human-readable table of all module
changes between the two.  The output format may change in the future, and is
meant for \fIhumans\fR, not programs.  For programs, use the Module::CoreList
API.
.IP "\-? or \-help" 4
.IX Item "-? or -help"
help! help! help! to see more help, try \-\-man.
.IP \-man 4
.IX Item "-man"
all of the help
.IP \-v 4
.IX Item "-v"
lists all of the perl release versions we got the CoreList for.
.Sp
If you pass a version argument (value of \f(CW$]\fR, like \f(CW5.00503\fR or \f(CW5.008008\fR),
you get a list of all the modules and their respective versions.
(If you have the \f(CW\*(C`version\*(C'\fR module, you can also use new-style version numbers,
like \f(CW5.8.8\fR.)
.Sp
In module filtering context, it can be used as Perl version filter.
.IP \-r 4
.IX Item "-r"
lists all of the perl releases and when they were released
.Sp
If you pass a perl version you get the release date for that version only.
.IP \-\-utils 4
.IX Item "--utils"
lists the first version of perl each named utility program was released with
.Sp
May be used with \-d to modify the first release criteria.
.Sp
If used with \-v <version> then all utilities released with that version of perl
are listed, and any utility programs named on the command line are ignored.
.IP "\-\-feature, \-f" 4
.IX Item "--feature, -f"
lists the first version bundle of each named feature given
.IP "\-\-upstream, \-u" 4
.IX Item "--upstream, -u"
Shows if the given module is primarily maintained in perl core or on CPAN
and bug tracker URL.
.PP
As a special case, if you specify the module name \f(CW\*(C`Unicode\*(C'\fR, you'll get
the version number of the Unicode Character Database bundled with the
requested perl versions.
.SH EXAMPLES
.IX Header "EXAMPLES"
.Vb 1
\&    $ corelist File::Spec
\&
\&    File::Spec was first released with perl 5.005
\&
\&    $ corelist File::Spec 0.83
\&
\&    File::Spec 0.83 was released with perl 5.007003
\&
\&    $ corelist File::Spec 0.89
\&
\&    File::Spec 0.89 was not in CORE (or so I think)
\&
\&    $ corelist File::Spec::Aliens
\&
\&    File::Spec::Aliens  was not in CORE (or so I think)
\&
\&    $ corelist /IPC::Open/
\&
\&    IPC::Open2 was first released with perl 5
\&
\&    IPC::Open3 was first released with perl 5
\&
\&    $ corelist /MANIFEST/i
\&
\&    ExtUtils::Manifest was first released with perl 5.001
\&
\&    $ corelist /Template/
\&
\&    /Template/  has no match in CORE (or so I think)
\&
\&    $ corelist \-v 5.8.8 B
\&
\&    B                        1.09_01
\&
\&    $ corelist \-v 5.8.8 /^B::/
\&
\&    B::Asmdata               1.01
\&    B::Assembler             0.07
\&    B::Bblock                1.02_01
\&    B::Bytecode              1.01_01
\&    B::C                     1.04_01
\&    B::CC                    1.00_01
\&    B::Concise               0.66
\&    B::Debug                 1.02_01
\&    B::Deparse               0.71
\&    B::Disassembler          1.05
\&    B::Lint                  1.03
\&    B::O                     1.00
\&    B::Showlex               1.02
\&    B::Stackobj              1.00
\&    B::Stash                 1.00
\&    B::Terse                 1.03_01
\&    B::Xref                  1.01
.Ve
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (c) 2002\-2007 by D.H. aka PodMaster
.PP
Currently maintained by the perl 5 porters <perl5\-porters@perl.org>.
.PP
This program is distributed under the same terms as perl itself.
See http://perl.org/ or http://cpan.org/ for more info on that.
