Pod::Loom::Template::Default - Default template for Pod::Loom
This document describes version 0.05 of Pod::Loom::Template::Default, released March 23, 2014 as part of Pod-Loom version 0.08.
Pod::Loom::Template::Default is the default template for Pod::Loom. It places the sections in this order:
+ NAME + VERSION SYNOPSIS DESCRIPTION ++ ATTRIBUTES ++ METHODS ++ SUBROUTINES * ++ DIAGNOSTICS + CONFIGURATION AND ENVIRONMENT DEPENDENCIES + INCOMPATIBILITIES + BUGS AND LIMITATIONS + AUTHOR + COPYRIGHT AND LICENSE + DISCLAIMER OF WARRANTY
Sections marked with + will be provided by this template if they do not appear in the original document. Sections marked ++ will be appended to even if they do appear in the original document (if the document contains any entries that belong in that section).
+
++
See "Controlling the template" in Pod::Loom::Template for details on how to rearrange sections and sort entries.
The abstract for the module. Required by NAME.
An arrayref of author names (with optional email address in <>). Required by AUTHOR.
<>
An optional hashref giving the location of the distribution's public bugtracker. If not specified, defaults to the CPAN RT. If present, may have keys web and mailto.
web
mailto
The name of the distribution that contains this module. Required by AUTHOR.
The complete text of the COPYRIGHT AND LICENSE section. Required by COPYRIGHT AND LICENSE.
The name of the module. Required by NAME and CONFIGURATION AND ENVIRONMENT.
An optional string giving the location of the distribution's public source code repository.
This should be 0, 1, or an arrayref. If non 0, attributes will be sorted. An arrayref lists the attributes that should come first, with the remaining attributes in alphabetical order. See "Pod::Loom-sort_COMMAND" in Pod::Loom::Template.
Just like sort_attr, but for diagnostic messages.
sort_attr
Just like sort_attr, but for methods.
Just like sort_attr, but for subroutines.
The version number of the module. Used by VERSION.
The complete text of the VERSION section. Used by VERSION.
<module> - <abstract>
<version_desc>
Or, if "version_desc" is not set:
version <version>
If neither version_desc nor "version" is set, no VERSION section will be added.
If the original document contains any =attr commands, they will be converted to =head2 commands in this section. If there are no attributes, no ATTRIBUTES section will be added.
=attr
=head2
This is just like ATTRIBUTES, except it gathers =method entries.
=method
This is just like ATTRIBUTES, except it gathers =sub entries.
=sub
If the original document contains any =diag commands, they will be converted to an =item list in this section. If there are no diagnostics, no DIAGNOSTICS section will be added.
=diag
=item
<module> requires no configuration files or environment variables.
None reported.
No bugs have been reported.
First, it lists the authors from the "authors" attribute (converting @ to AT in email addresses). Then it directs bug reports to the distribution's queue at rt.cpan.org (using the "dist" attribute):
Please report any bugs or feature requests to S<C<< <bug-<dist> AT rt.cpan.org> >>>, or through the web interface at L<http://rt.cpan.org/Public/Bug/Report.html?Queue=<dist>>
And, if "repository" is set:
You can follow or contribute to <dist>'s development at <repository>.
<license_notice>
See "DISCLAIMER OF WARRANTY".
Pod::Loom::Template::Default requires no configuration files or environment variables.
Christopher J. Madsen <perl AT cjmweb.net>
<perl AT cjmweb.net>
Please report any bugs or feature requests to <bug-Pod-Loom AT rt.cpan.org> or through the web interface at http://rt.cpan.org/Public/Bug/Report.html?Queue=Pod-Loom.
<bug-Pod-Loom AT rt.cpan.org>
You can follow or contribute to Pod-Loom's development at https://github.com/madsen/pod-loom.
This software is copyright (c) 2014 by Christopher J. Madsen.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
To install Pod::Loom, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pod::Loom
CPAN shell
perl -MCPAN -e shell install Pod::Loom
For more information on module installation, please visit the detailed CPAN module installation guide.