Marcel Grünauer > Dist-Zilla-Plugin-Bugtracker-1.111080 > Dist::Zilla::Plugin::Bugtracker

Download:
Dist-Zilla-Plugin-Bugtracker-1.111080.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.111080   Source  

NAME ^

Dist::Zilla::Plugin::Bugtracker - Automatically sets the bugtracker URL and mailto

VERSION ^

version 1.111080

SYNOPSIS ^

In dist.ini:

    [Bugtracker]

DESCRIPTION ^

This plugin sets the distribution's bugtracker URL and possibly the email address as metadata. You can set the web and the mailto values independently in the plugin configuration.

METHODS ^

web

This is the bugtracker URL. It defaults to the CPAN RT URL, so it equivalent to:

    [Bugtracker]
    web = http://rt.cpan.org/Public/Dist/Display.html?Name=%s

See interpolate() for more information.

mailto

This is the optional email address to which bug reports can be sent. If the CPAN RT bugtracker is used, the email address defaults to bug-%l at rt.cpan.org - see interpolate() for what this means.

If a different bugtracker URL is used, the email address is only included in the metadata if it is explicitly given.

In the following examples, assume that the distribution is called Foo-Bar.

Example 1:

    [Bugtracker]

will produce the defaults:

    web:    http://rt.cpan.org/Public/Dist/Display.html?Name=Foo-Bar
    mailto: bug-foo-bar at rt.cpan.org

Example 2:

To suppress the mailto from example 1, use:

    [Bugtracker]
    mailto =

Example 3:

    [Bugtracker]
    web = http://github.com/me/%s/issues

will only produce a web entry, but not a mailto entry:

    web: http://github.com/me/Foo-Bar/issues

Example 4:

    [Bugtracker]
    mailto = me@example.org

will produce:

    web:    http://rt.cpan.org/Public/Dist/Display.html?Name=Foo-Bar
    mailto: me@example.org

Example 5:

    [Bugtracker]
    web = http://github.com/me/%s/issues
    mailto = bug-%U@example.org

will only produce a web entry, but not a mailto entry:

    web:    http://github.com/me/Foo-Bar/issues
    mailto: bug-FOO-BAR@example.org

See CPAN::Meta::Spec for more information.

interpolate

Both the web and mailto strings are interpolated as follows:

    %s  The distribution name as is (e.g., 'Foo-Bar')
    %l  The distribution name in lowercase (e.g., 'foo-bar')
    %U  The distribution name in uppercase (e.g., 'FOO-BAR')
    %%  A literal '%' sign

metadata

Sets the bugtracker URL and possibly email address in the distribution's metadata.

INSTALLATION ^

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS ^

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Bugtracker.

AVAILABILITY ^

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Dist-Zilla-Plugin-Bugtracker/.

The development version lives at http://github.com/hanekomu/Dist-Zilla-Plugin-Bugtracker and may be cloned from git://github.com/hanekomu/Dist-Zilla-Plugin-Bugtracker.git. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR ^

Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2010 by Marcel Gruenauer.

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

syntax highlighting: