Skip to content

marcel-maint/Dist-Zilla-Plugin-Bugtracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 = [email protected]

    will produce:

        web:    http://rt.cpan.org/Public/Dist/Display.html?Name=Foo-Bar
        mailto: [email protected]

    Example 5:

        [Bugtracker]
        web = http://github.com/me/%s/issues
        mailto = bug-%[email protected]

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

        web:    http://github.com/me/Foo-Bar/issues
        mailto: [email protected]

    See CPAN::Meta::Spec
    <http://search.cpan.org/dist/CPAN-Meta/lib/CPAN/Meta/Spec.pm#resources>
    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-Bugt
    racker>.

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 <[email protected]>

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.