/ 
Dist-Zilla-PluginBundle-Author-ETHER-0.169
River stage zero No dependents
/ Pod::Weaver::PluginBundle::Author::ETHER

NAME

Pod::Weaver::PluginBundle::Author::ETHER - A plugin bundle for pod woven by ETHER

VERSION

version 0.169

SYNOPSIS

In your weaver.ini:

[@Author::ETHER]

Or in your dist.ini

[PodWeaver]
config_plugin = @Author::ETHER

It is also used automatically when your dist.ini contains:

[@Author::ETHER]
:version = 0.094    ; or any higher version

DESCRIPTION

This is a Pod::Weaver plugin bundle. It is approximately equal to the following weaver.ini, minus some optimizations:

[-EnsurePod5]
[-H1Nester]
[-SingleEncoding]

[-Transformer / List]
transformer = List

[-Transformer / Verbatim]
transformer = Verbatim

[Region / header]
[Name]
[Version]

[Region / prelude]

[Generic / SYNOPSIS]
[Generic / DESCRIPTION]
[Generic / OVERVIEW]

[Collect / ATTRIBUTES]
command = attr

[Collect / METHODS]
command = method

[Collect / FUNCTIONS]
command = func

[Collect / TYPES]
command = type

[Leftovers]

[Region / postlude]

[GenerateSection / generate GIVING THANKS]
title = GIVING THANkS
main_module_only = 0
text = <template>

[GenerateSection / generate SUPPORT]
title = SUPPORT
main_module_only = 0
text = <template>

[Authors]
[AllowOverride / allow override AUTHOR]
header_re = ^AUTHORS?\b
action = replace
match_anywhere = 0

[Contributors]
:version = 0.008

[Legal]
:version = 4.011
header = COPYRIGHT AND <licence filename>

[Region / footer]

This is also equivalent (other than section ordering) to:

[-Transformer / List]
transformer = List
[-Transformer / Verbatim]
transformer = Verbatim

[Region / header]
[@Default]

[Collect / TYPES]
command = type

[GenerateSection / generate GIVING THANKS]
title = GIVING THANKS
main_module_only = 0
text = <template>

[GenerateSection / generate SUPPORT]
title = SUPPORT
main_module_only = 0
text = <template>

[Authors]
[Contributors]
:version = 0.008

[Region / footer]

OPTIONS

None at this time. (The bundle is never instantiated, so this doesn't seem to be possible without updates to Pod::Weaver.)

OVERRIDING A SPECIFIC SECTION

This weaver.ini will let you use a custom COPYRIGHT AND LICENCE section and still use the plugin bundle:

[@Author::ETHER]
[AllowOverride / OverrideLegal]
header_re = ^COPYRIGHT
match_anywhere = 1
action = append

ADDING STOPWORDS FOR SPELLING TESTS

As noted in Dist::Zilla::PluginBundle::Author::ETHER, stopwords for spelling tests can be added by adding a directive to pod:

=for stopwords foo bar baz

However, if the stopword appears in the module's abstract, it is moved to the NAME section, which will be above your stopword directive. You can handle this by declaring the stopword in the special header section, which will be woven ahead of everything else:

=for :header
=for stopwords foo bar baz

SEE ALSO

NAMING SCHEME

This distribution follows best practices for author-oriented plugin bundles; for more information, see KENTNL's distribution.

GIVING THANKS

If you found this module to be useful, please show your appreciation by adding a +1 in MetaCPAN and a star in GitHub.

SUPPORT

Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-PluginBundle-Author-ETHER@rt.cpan.org).

There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.

There is also an irc channel available for users of this distribution, at #distzilla on irc.perl.org.

I am also usually active on irc, as 'ether' at irc.perl.org and irc.libera.chat.

AUTHOR

Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENCE

This software is copyright (c) 2013 by Karen Etheridge.

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