DOKK / manpages / debian 10 / libdist-zilla-plugin-podweaver-perl / Dist::Zilla::Plugin::PodWeaver.3pm.en
Dist::Zilla::Plugin::PodWeaver(3pm) User Contributed Perl Documentation Dist::Zilla::Plugin::PodWeaver(3pm)

Dist::Zilla::Plugin::PodWeaver - weave your Pod together from configuration and Dist::Zilla

version 4.008

[PodWeaver] is the bridge between Dist::Zilla and Pod::Weaver. It rips apart your kinda-Pod and reconstructs it as boring old real Pod.

[PodWeaver] is a Dist::Zilla::Role::FileFinderUser. The FileFinder given for its "finder" attribute is used to decide which files to munge. By default, it will munge:

  • ":InstallModules"
  • ":ExecFiles"

This method returns the Pod::Weaver object to be used. The current implementation builds a new weaver on each invocation, because one or two core Pod::Weaver plugins cannot be trusted to handle multiple documents per plugin instance. In the future, when that is fixed, this may become an accessor of an attribute with a builder. Until this is clearer, use caution when modifying this method in subclasses.

If the "config_plugin" attribute is given, it will be treated like a Pod::Weaver section heading. For example, @Default could be given. It may be given multiple times.

Otherwise, if a file matching "./weaver.*" exists, Pod::Weaver will be told to look for configuration in the current directory.

Otherwise, it will use the default configuration.

Ricardo SIGNES <rjbs@cpan.org>

  • David Golden <dagolden@cpan.org>
  • Florian Ragwitz <rafl@debian.org>
  • Karen Etheridge <ether@cpan.org>
  • Yasutaka ATARASHI <yakex@cpan.org>
  • Сергей Романов <sromanov-dev@yandex.ru>

This software is copyright (c) 2016 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

2016-05-25 perl v5.22.2