1Dist::Zilla::Plugin::TeUsste:r:CChoanntgrDeiisbsHutat:se:CdZoinPlteleranl:t:(DP3ol)cuugmienn:t:aTteisotn::ChangesHasContent(3)
2
3
4
6 Dist::Zilla::Plugin::Test::ChangesHasContent - Release test to ensure
7 Changes has content
8
10 version 0.011
11
13 # in dist.ini
14
15 [Test::ChangesHasContent]
16
18 This plugin provides "xt/release/changes_has_content.t".
19
20 This test ensures ensures that your Changes file actually has some
21 content since the last release.
22
23 This can be contrasted to Dist::Zilla::Plugin::CheckChangesHasContent,
24 which performs the check at release time, halting the release process
25 if content is missing. Performing the check as a test makes it
26 possible to check more frequently, and closer to the point of
27 development.
28
29 The algorithm is very naive. It looks for an unindented line starting
30 with the version to be released. It then looks for any text from that
31 line until the next unindented line (or the end of the file), ignoring
32 whitespace.
33
34 For example, in the file below, algorithm will find "- blah blah blah":
35
36 Changes file for Foo-Bar
37
38 {{$NEXT}}
39
40 - blah blah blah
41
42 0.001 Wed May 12 13:49:13 EDT 2010
43
44 - the first release
45
46 If you had nothing but whitespace between "{{$NEXT}}" and 0.001, the
47 release would be halted.
48
49 If you name your change log something other than "Changes", you can
50 configure the name with the "changelog" argument:
51
52 [Test::ChangesHasContent]
53 changelog = ChangeLog
54
56 * Dist::Zilla::Plugin::CheckChangesHasContent * Dist::Zilla
57
59 • David Golden <dagolden@cpan.org>
60
61 • Karen Etheridge <ether@cpan.org>
62
64 This software is Copyright (c) 2017 by David Golden.
65
66 This is free software, licensed under:
67
68 The Apache License, Version 2.0, January 2004
69
70
71
72perl v5.36.0 Dis2t0:2:3Z-i0l1l-a2:0:Plugin::Test::ChangesHasContent(3)