Dist::Zilla::Plugin::Bugtracker - Automatically sets the bugtracker URL and mailto
version 1.111080
In dist.ini:
dist.ini
[Bugtracker]
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.
web
mailto
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.
interpolate()
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.
bug-%l at rt.cpan.org
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.
Foo-Bar
Example 1:
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
web: http://github.com/me/Foo-Bar/issues mailto: bug-FOO-BAR@example.org
See CPAN::Meta::Spec for more information.
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
Sets the bugtracker URL and possibly email address in the distribution's metadata.
See perlmodinstall for information and options on installing Perl modules.
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.
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.
Marcel Gruenauer <marcel@cpan.org>
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.
To install Dist::Zilla::Plugin::Bugtracker, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::Bugtracker
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::Bugtracker
For more information on module installation, please visit the detailed CPAN module installation guide.