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.017
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:ssZZZZZ VVVV}d%{ (TRIAL
55           RELEASE)}T"
56
57       time_zone
58           the timezone to use when generating the date;  defaults to local
59
60       user_stash
61           the name of the stash where the user's name and email address can
62           be found; defaults to %User
63
64       The module allows the following sprintf-like format codes in the
65       "format":
66
67       %v  The distribution version
68
69       "%{-TRIAL}T"
70           Expands to -TRIAL (or any other supplied string) if this is a trial
71           release, or the empty string if not.  A bare %T means "%{-TRIAL}T".
72
73       "%{-TRIAL}V"
74           Equivalent to "%v%{-TRIAL}T", to allow for the application of
75           modifiers such as space padding to the entire version string
76           produced.
77
78       "%{CLDR format}d"
79           The date of the release.  You can use any CLDR format supported by
80           DateTime.  You must specify the format; there is no default.
81
82       %U  The name of the user making this release (from "user_stash").
83
84       %E  The email address of the user making this release (from
85           "user_stash").
86
87       %P  The CPAN (PAUSE) id of the user making this release (from -Releaser
88           plugins; see [UploadToCPAN]).
89
90       %n  A newline
91
92       %t  A tab
93

SEE ALSO

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

AUTHOR

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

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