1Pod::Weaver::Section::CUosnetrriCbounttorrisb(u3t)ed PerPlodD:o:cWuemaevnetra:t:iSoenction::Contributors(3)
2
3
4

NAME

6       Pod::Weaver::Section::Contributors - a section listing contributors
7

VERSION

9       version 0.009
10

SYNOPSIS

12       on dist.ini:
13
14           [PodWeaver]
15           [%PodWeaver]
16           Contributors.head = 2
17           Contributors.contributors[0] = keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
18           Contributors.contributors[1] = carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>
19
20       and/or weaver.ini:
21
22           [Contributors]
23           head = 2
24           contributors = keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
25           contributors = carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>
26
27       and/or in the source of individual files:
28
29           # CONTRIBUTOR:  keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
30           # CONTRIBUTORS: carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>
31

DESCRIPTION

33       This section adds a listing of the documents contributors.  It expects
34       a "contributors" input parameter to be an arrayref of strings.  If no
35       "contributors" parameter is given, it will do nothing.  Otherwise, it
36       produces a hunk like this:
37
38           =head1 CONTRIBUTORS
39
40           Contributor One <a1@example.com>
41           Contributor Two <a2@example.com>
42
43       To support distributions with multiple modules, it is also able to
44       derive a list of contributors in a file basis by looking at comments on
45       each module. Names of contributors on the source, will only appear on
46       the POD of those modules.
47

ATTRIBUTES

49   head
50       The heading level of this section.  If 0, it inserts an ordinary piece
51       of text with no heading. Defaults to 1.
52
53       In case the value is passed both to Pod::Weaver and to the Pod::Weaver
54       stash, it uses the value found in the stash.
55
56   contributors
57       The list of contributors.
58
59       In case the value is passed to "weave_section()", to Pod::Weaver and to
60       the Pod::Weaver stash, it merges all contributors.
61
62   all_modules
63       Enable this if you want to add the CONTRIBUTOR/CONTRIBUTORS section to
64       all the modules in a dist, not only the main one. Defaults to false.
65
66       In case the value is passed both to Pod::Weaver and to the Pod::Weaver
67       stash, it uses the value found in the stash.
68

SEE ALSO

70       ·   dagolden's 'How I'm using Dist::Zilla to give credit to
71           contributors' <http://www.dagolden.com/index.php/1921/how-im-using-
72           distzilla-to-give-credit-to-contributors/>
73
74       ·   Dist::Zilla::Plugin::ContributorsFromGit
75
76       ·   Dist::Zilla::Stash::Contributors
77
78       ·   Dist::Zilla::Plugin::Meta::Contributors
79
80       ·   Dist::Zilla::Plugin::ContributorsFile
81
82       ·   Dist::Zilla
83
84       ·   Dist::Zilla::Stash::PodWeaver
85
86       ·   Pod::Weaver
87
88       ·   Pod::Weaver::Section::Authors
89

AUTHOR

91       Keedi Kim - 김도형 <keedi@cpan.org>
92

CONTRIBUTORS

94       ·   carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>
95
96       ·   ether - Karen Etheridge (cpan: ETHER) <ether@cpan.org>
97
98       ·   thaljef - Jeffrey Ryan Thalhammer (cpan: THALJEF)
99           <thaljef@cpan.org>
100
102       This software is copyright (c) 2014 by Keedi Kim.
103
104       This is free software; you can redistribute it and/or modify it under
105       the same terms as the Perl 5 programming language system itself.
106
107
108
109perl v5.28.0                      2014-12-P2o2d::Weaver::Section::Contributors(3)
Impressum