NAME
Pod::Readme::Brief - A short simple README with just the essentials
SYNOPSIS
my $readme = Pod::Readme::Brief->new( do {
open my $fh, '<', __FILE__ or die $!;
readline $fh;
} );
my $installer
= -e 'Makefile.PL' ? 'eumm'
: -e 'Build.PL' ? 'mb'
: undef;
print $readme->render( installer => $installer );
DESCRIPTION
This module creates a brief README from a POD document (presumably the main module of a distribution) with just the information relevant to the audience who would even look inside such a README: non-Perl people. This is intended as a sensible boilerplate generated README, unlike the usual tick-the-box approaches that do not actually help anyone (such as just converting the entire documentation of the the main module to text, or putting in just the name and abstract of the distribution).
The following information goes into such a README:
The
NAME
of the moduleThe content of the
DESCRIPTION
sectionSimple installation instructions
The content of the
LICENSE
section
INTERFACE
new
Creates an instance of the class from a string or a list of lines, which must contain a well-formed full POD document, either by itself or embedded in Perl code.
render
Renders the README. Takes the following named arguments:
installer
-
Specifies what manual installation instructions should be included, if any. (Instructions involving a CPAN client are always included.)
The value may be one of
eumm
(for a distribution usingMakefile.PL
),mb
(for a distribution usingBuild.PL
), or a false value (to omit manual installation instructions). width
-
The number of columns to which output will be reflowed by Pod::Text.
Defaults to 73.
SEE ALSO
Dist::Zilla::Plugin::Readme::Brief
AUTHOR
Aristotle Pagaltzis <pagaltzis@gmx.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2022 by Aristotle Pagaltzis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.