Package : perl-Pod-Weaver-Plugin-EnsureUniqueSections

Package details

Summary: Ensure that POD has no duplicate section headers

Description:
This plugin simply ensures that the POD after weaving has no duplicate
top-level section headers. This can help you if you are converting from
writing all your own POD to generating it with the Pod::Weaver manpage. If
you begin generating a section with the Pod::Weaver manpage but you forget
to delete the manually written section of the same name, this plugin will
warn you.

By default, this module does some tricks to detect similar headers, such as
'AUTHOR' and 'AUTHORS'. You can turn this off by setting 'strict = 1' in
_weaver.ini_, in which case only _exactly identical_ headers will be
considered duplicates of each other.

DIAGNOSTIC MESSAGES
If any similar (or identical if 'strict' is 1) section headers are
found, all of their names will be listed on STDERR. Generally, you
should take this list of modules and remove each from your POD. Then
you should ensure that the sections generated by the Pod::Weaver
manpage are suitable substitutes for those sections. In the case of
similar names, only the first instance in each set of similar names
will be listed.


URL: http://search.cpan.org/dist/Pod-Weaver-Plugin-EnsureUniqueSections
License: GPLv1+ or Artistic

Maintainer: nobody

List of RPMs