1Dist::Zilla::Plugin::NeUxsteRrelCeoanster(i3b)uted PerlDDiosctu:m:eZnitlaltai:o:nPlugin::NextRelease(3)
2
3
4

NAME

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

VERSION

10       version 6.012
11

SYNOPSIS

13       In your dist.ini:
14
15         [NextRelease]
16
17       In your Changes file:
18
19         {{$NEXT}}
20

DESCRIPTION

22       Tired of having to update your Changes file by hand with the new
23       version and release date / time each time you release your
24       distribution?  Well, this plugin is for you.
25
26       Add this plugin to your dist.ini, and the following to your Changes
27       file:
28
29         {{$NEXT}}
30
31       The "NextRelease" plugin will then do 2 things:
32
33       ·   At build time, this special marker will be replaced with the
34           version and the build date, to form a standard changelog header.
35           This will be done to the in-memory file - the original Changes file
36           won't be updated.
37
38       ·   After release (when running "dzil release"), since the version and
39           build date are now part of your dist's history, the real Changes
40           file (not the in-memory one) will be updated with this piece of
41           information.
42
43       The module accepts the following options in its dist.ini section:
44
45       filename
46           the name of your changelog file;  defaults to Changes
47
48       update_filename
49           the file to which to write an updated changelog to; defaults to the
50           "filename"
51
52       format
53           sprintf-like string used to compute the next value of "{{$NEXT}}";
54           defaults to "%-9v %{yyyy-MM-dd HH:mm:ss VVVV}d"
55
56       time_zone
57           the timezone to use when generating the date;  defaults to local
58
59       user_stash
60           the name of the stash where the user's name and email address can
61           be found; defaults to %User
62
63       The module allows the following sprintf-like format codes in the
64       "format":
65
66       %v  The distribution version
67
68       "%{-TRIAL}T"
69           Expands to -TRIAL (or any other supplied string) if this is a trial
70           release, or the empty string if not.  A bare %T means "%{-TRIAL}T".
71
72       "%{-TRIAL}V"
73           Equivalent to "%v%{-TRIAL}T", to allow for the application of
74           modifiers such as space padding to the entire version string
75           produced.
76
77       "%{CLDR format}d"
78           The date of the release.  You can use any CLDR format supported by
79           DateTime.  You must specify the format; there is no default.
80
81       %U  The name of the user making this release (from "user_stash").
82
83       %E  The email address of the user making this release (from
84           "user_stash").
85
86       %P  The CPAN (PAUSE) id of the user making this release (from -Releaser
87           plugins; see [UploadToCPAN]).
88
89       %n  A newline
90
91       %t  A tab
92

SEE ALSO

94       Core Dist::Zilla plugins: AutoVersion, PkgVersion, PodVersion.
95
96       Dist::Zilla roles: AfterRelease, FileMunger, TextTemplate.
97

AUTHOR

99       Ricardo SIGNES 😏 <rjbs@cpan.org>
100

102       This software is copyright (c) 2018 by Ricardo SIGNES.
103
104       This is free software; you can redistribute it and/or modify it under
105       the same terms as the Perl 5 programming language system itself.
106
107
108
109perl v5.28.1                      2018-04-21Dist::Zilla::Plugin::NextRelease(3)
Impressum