Pod::Readme::Plugin::requires(3pm)

Pod::Readme::Plugin::requires3pm

Include requirements in readme

Usage

  =for readme plugin requires

Overview

This is a plugin for Pod::Readme that includes module requirements from the META.yml file.

Because this depends on the META.yml file, the README should be generated after that file has been updated.

Arguments

"from-file"

  =for readme plugin version from-file='MYMETA.yml'

By default, it will extract the version from the META.yml file. If, for some reason, this file is in a non-standard location, then you should specify it here.

The file will be ignored if the "zilla" attribute is set, and instead obtain metadata from the Dist::Zilla object (since the META.yml file may not exist.)

"no-omit-core"

By default, core modules for the version of Perl specified in the META.yml file are omitted from this list. If you prefer to lise all requirements, then specify this option.

"title"

  =for readme plugin version title='REQUIREMENTS'

This argument allows you to change the title of the heading.

Known issues

•

Trailing zeros in module versions may be dropped.

If you specify a minimum version of a module with a trailing zero, e.g. "0.30", then it may be shown as "0.3". A workaround is to specify the module version in your Makefile.PL as a string instead of number:

  requires(
    'CPAN::Changes' => '0.30',
    ...
  );

Releases

5 releases since Debian 9 (Stretch); the text changed 1 time.

  1. 9
  2. 10–13

From libpod-readme-perl 1.2.3-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.