Module::Install::ReadmeFromPod - A Module::Install extension to automatically convert POD to a README
# In Makefile.PL use inc::Module::Install; author 'Vestan Pants'; license 'perl'; readme_from 'lib/Some/Module.pm';
A README file will be generated from the POD of the indicated module file.
README
Module::Install::ReadmeFromPod is a Module::Install extension that generates a README file automatically from an indicated file containing POD, whenever the author runs Makefile.PL.
Makefile.PL
This plugin adds the following Module::Install command:
readme_from
Does nothing on the user-side. On the author-side it will generate a README file using Pod::Text from the POD in the file passed as a parameter.
readme_from 'lib/Some/Module.pm';
If a second parameter is set to a true value then the README will be removed at make distclean.
make distclean
readme_from 'lib/Some/Module.pm' => 'clean';
Chris BinGOs Williams
BinGOs
Copyright © Chris Williams
This module may be used, modified, and distributed under the same terms as Perl itself. Please see the license that came with your Perl distribution for details.
Module::Install
Pod::Text
To install Module::Install::ReadmeFromPod, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Module::Install::ReadmeFromPod
CPAN shell
perl -MCPAN -e shell install Module::Install::ReadmeFromPod
For more information on module installation, please visit the detailed CPAN module installation guide.