The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

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

VERSION

version 0.002

SYNOPSIS

on dist.ini:

    [PodWeaver]
    [%PodWeaver]
    Contributors.contributors[0] = keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
    Contributors.contributors[1] = carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>

and/or weaver.ini:

    [Contributors]
    contributors = keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
    contributors = carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>

and/or in the source of individual files:

    # CONTRIBUTOR:  keedi - Keedi Kim - 김도형 (cpan: KEEDI) <keedi@cpan.org>
    # CONTRIBUTORS: carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>

DESCRIPTION

This section adds a listing of the documents contributors. It expects a contributors input parameter to be an arrayref of strings. If no contributors parameter is given, it will do nothing. Otherwise, it produces a hunk like this:

    =head1 CONTRIBUTORS

    Contributor One <a1@example.com>
    Contributor Two <a2@example.com>

To support distributions with multiple modules, it is also able to derive a list of contributors in a file basis by looking at comments on each module. Names of contributors on the source, will only appear on the POD of those modules.

SEE ALSO

Dist::Zilla
Dist::Zilla::Role::Stash::Plugins
Pod::Weaver
Pod::Weaver::Section::Authors

AUTHOR

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

CONTRIBUTOR

carandraug - Carnë Draug (cpan: CDRAUG) <cdraug@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Keedi Kim.

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