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

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Pod::Readme::Plugin::requires.3pm".)

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 .yml file.

Because this depends on the

.yml file, the 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

.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

.yml file may not exist.)

no-omit-core

By default, core modules for the version of Perl specified in the .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',
    ...
  );