NAME

Dist::Zilla::Plugin::Git::DescribeVersion - provide version using git-describe

VERSION

version 0.007006

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 the base module's constructor. 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

• Git::DescribeVersion

• Dist::Zilla

• Dist::Zilla::Plugin::Git::NextVersion

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

• 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

• RT: CPAN's Bug Tracker

  http://rt.cpan.org/NoAuth/Bugs.html?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

• Source Code Repository

  git://github.com/magnificent-tears/git-describeversion.git

  http://github.com/magnificent-tears/git-describeversion/tree

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.

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.