Scroll to navigation

Dist::Zilla::Role::Git::StringFormatter(3pm) User Contributed Perl Documentation Dist::Zilla::Role::Git::StringFormatter(3pm)


Dist::Zilla::Role::Git::StringFormatter - Provide a String::Formatter for commit messages


version 2.046


This role is used within the Git plugins to format strings that may include the changes from the current release.

These formatting codes are available:

The list of changes in the just-released version (read from "changelog"). It will include lines between the current version and timestamp and the next non-indented line, except that blank lines at the beginning or end are removed. It always ends in a newline unless it is the empty string.
The current date. You can use any CLDR format supported by DateTime. A bare %d means "%{dd-MMM-yyyy}d".
a newline
the distribution name
Expands to -TRIAL (or any other supplied string) if this is a trial release, or the empty string if not. A bare %t means "%{-TRIAL}t".
the distribution version
The distribution version, but with a leading "v" removed if it exists.



The filename of your Changes file. (Must be provided by the class that consumes this role.)


The time zone used with the %d code. The default is "local".


Bugs may be submitted through the RT bug tracker <> (or <>).

There is also a mailing list available for users of this distribution, at <>.

There is also an irc channel available for users of this distribution, at "#distzilla" on "" <irc://>.


Jerome Quelin


This software is copyright (c) 2009 by Jerome Quelin.

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

2019-07-16 perl v5.28.1