The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

NAME

pcorelist - corelist with subcommands and shell completion

ABSTRACT

This is a wrapper around the corelist tool which adds shell completion

DESCRIPTION

corelist is a tool providing information about when a module was included in the perl core, and when a feature was added to perl.

pcorelist is a simple wrapper that adds subcommands. This makes it easier to add tab completion.

EXAMPLES

pcorelist features <TAB>
# shows all features
pcorelist module <TAB>
# shows all modules
pcorelist diff <TAB>
# shows all perl versions

GLOBAL OPTIONS

--help -h Show command help (flag)

SUBCOMMANDS

completion-dir

pcorelist completion-dir

Output the location of the shell completion files

For bash, just source the bash file.

source /path/to/completion/bash/pcorelist.bash

For zsh, put the following in your .zshrc:

# before the compinit call
fpath=('/path/to/completion/zsh' $fpath)

Then exec zsh.

diff

pcorelist diff [options] <perl1> <perl2>

Show diff between two Perl versions

Options:

--added Show only added modules (flag)
--removed Show only removed modules (flag)

Parameters:

perl1 * Perl version 1
perl2 * Perl version 2

features

pcorelist features [options] [<feature>+]

List features with perl versions

If given a feature name as a parameter, show the perl feature bundle it was first released with.

Options:

--raw List only feature names (flag)

Parameters:

feature [] feature name (multiple)

module

pcorelist module [options] <module>

Show for which perl version the module was first released

Options:

--all -a Show all perl and module versions (flag)
--date -d Show by date (flag)
--perl -p Show by Perl Version

Parameters:

module * Module name

modules

pcorelist modules

List all modules

perl

pcorelist perl [options]

Perl Versions

Options:

--raw -r Show raw output without header (flag)
--release Show perl releases with dates (flag)

help

pcorelist help <subcommands> [options]

Show command help

Options:

--all (flag)

_meta

pcorelist _meta <subcommands>

Information and utilities for this app

_meta completion

pcorelist _meta completion <subcommands>

Shell completion functions

_meta completion generate

pcorelist _meta completion generate [options]

Generate self completion

Options:

--name name of the program (optional, override name in spec)
--zsh for zsh (flag)
--bash for bash (flag)

_meta pod

pcorelist _meta pod <subcommands>

Pod documentation

_meta pod generate

pcorelist _meta pod generate

Generate self pod