The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Pod::Readme::Plugin::requires - include requirements in README

SYNOPSIS

  =for readme plugin requires

DESCRIPTION

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

ARGUMENTS

file

  =for readme plugin version 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.

no-omit-coree

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',
        ...
      );