Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  DIST::ZILLA::PLUGIN::NEXTRELEASE (3)

.ds Aq ’


Dist::Zilla::Plugin::NextRelease - update the next release number in your changelog



version 4.300030


In your dist.ini:


In your Changes file:



Tired of having to update your Changes file by hand with the new version and release date / time each time you release your distribution? Well, this plugin is for you.

Add this plugin to your dist.ini, and the following to your Changes file:


The NextRelease plugin will then do 2 things:
o At build time, this special marker will be replaced with the version and the build date, to form a standard changelog header. This will be done to the in-memory file - the original Changes file won’t be updated.
o After release (when running dzil release), since the version and build date are now part of your dist’s history, the real Changes file (not the in-memory one) will be updated with this piece of information.
The module accepts the following options in its dist.ini section:
filename the name of your changelog file; defaults to Changes
update_filename the file to which to write an updated changelog to; defaults to the filename
format sprintf-like string used to compute the next value of {{$NEXT}}; defaults to %-9v %{yyyy-MM-dd HH:mm:ss VVVV}d
time_zone the timezone to use when generating the date; defaults to local
user_stash the name of the stash where the user’s name and email address can be found; defaults to %User
The module allows the following sprintf-like format codes in the format:
%v The distribution version
%{-TRIAL}T 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.
%{-TRIAL}V Equivalent to %v%{-TRIAL}T, to allow for the application of modifiers such as space padding to the entire version string produced.
%{CLDR format}d The date of the release. You can use any CLDR format supported by DateTime. You must specify the format; there is no default.
%U The name of the user making this release (from user_stash).
%E The email address of the user making this release (from user_stash).
%n A newline
%t A tab


Core Dist::Zilla plugins: AutoVersion, PkgVersion, PodVersion.

Dist::Zilla roles: AfterRelease, FileMunger, TextTemplate.


Ricardo SIGNES <>


This software is copyright (c) 2013 by Ricardo SIGNES.

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

Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 DIST::ZILLA::PLUGIN::NEXTRELEASE (3) 2013-01-31

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.