NAME
Dist::Zilla::Plugin::Git::DescribeVersion - Provide version using git-describe
VERSION
version 1.000010
SYNOPSIS
In your dist.ini:
[Git::DescribeVersion]
match_pattern = v[0-9]* ; this is the default
DESCRIPTION
This does the Dist::Zilla::Role::VersionProvider role. It uses Git::DescribeVersion to count the number of commits since the last tag (matching match_pattern) or since the initial commit, and uses the result as the version parameter for your distribution.
The plugin accepts the same options as Git::DescribeVersion->new(). See "OPTIONS" in Git::DescribeVersion.
You can also set the V
environment variable to override the new version. This is useful if you need to bump to a specific version. For example, if the last tag is 0.005 and you want to jump to 1.000 you can set V = 1.000.
$ V=1.000 dzil release
SEE ALSO
This code copied/modified from Dist::Zilla::Plugin::Git::NextVersion.
Thanks RJBS and JQUELIN (and many others)!
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Dist::Zilla::Plugin::Git::DescribeVersion
Websites
Search CPAN
http://search.cpan.org/dist/Dist-Zilla-Plugin-Git-DescribeVersion
RT: CPAN's Bug Tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dist-Zilla-Plugin-Git-DescribeVersion
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Dist-Zilla-Plugin-Git-DescribeVersion
CPAN Ratings
http://cpanratings.perl.org/d/Dist-Zilla-Plugin-Git-DescribeVersion
CPAN Forum
http://cpanforum.com/dist/Dist-Zilla-Plugin-Git-DescribeVersion
CPANTS Kwalitee
http://cpants.perl.org/dist/overview/Dist-Zilla-Plugin-Git-DescribeVersion
CPAN Testers Results
http://cpantesters.org/distro/D/Dist-Zilla-Plugin-Git-DescribeVersion.html
CPAN Testers Matrix
http://matrix.cpantesters.org/?dist=Dist-Zilla-Plugin-Git-DescribeVersion
Bugs
Please report any bugs or feature requests to bug-dist-zilla-plugin-git-describeversion at rt.cpan.org
, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dist-Zilla-Plugin-Git-DescribeVersion. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
Source Code
http://github.com/magnificent-tears/git-describeversion/tree
git clone git://github.com/magnificent-tears/git-describeversion.git
AUTHOR
Randy Stauner <rwstauner@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Randy Stauner.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.