1Dist::Zilla::Plugin::GiUts:e:rCoCmomnittrBiubiultde(d3D)Piesrtl::DZoiclulmae:n:tPaltuigoinn::Git::CommitBuild(3)
2
3
4

NAME

6       Dist::Zilla::Plugin::Git::CommitBuild - Check in build results on
7       separate branch
8

VERSION

10       version 2.045
11

SYNOPSIS

13       In your dist.ini:
14
15           [Git::CommitBuild]
16               ; these are the defaults
17           branch = build/%b
18           message = Build results of %h (on %b)
19           multiple_inheritance = 0
20

DESCRIPTION

22       Once the build is done, this plugin will commit the results of the
23       build to a branch that is completely separate from your regular code
24       branches (i.e. with a different root commit).  This potentially makes
25       your repository more useful to those who may not have Dist::Zilla and
26       all of its dependencies installed.
27
28       The plugin accepts the following options:
29
30       ·   branch - String::Formatter string for where to commit the build
31           contents.
32
33           A single formatting code (%b) is defined for this attribute and
34           will be substituted with the name of the current branch in your git
35           repository.
36
37           Defaults to "build/%b", but if set explicitly to an empty string
38           causes no build contents checkin to be made.
39
40       ·   release_branch - String::Formatter string for where to commit the
41           build contents
42
43           Same as "branch", but commit the build content only after a
44           release. No default, meaning no release branch.
45
46       ·   message - String::Formatter string for what commit message to use
47           when committing the results of the build.
48
49           This option supports five formatting codes:
50
51           ·   %b - Name of the current branch
52
53           ·   %H - Commit hash
54
55           ·   %h - Abbreviated commit hash
56
57           ·   %v - The release version number
58
59           ·   %t - The string "-TRIAL" if this is a trial release
60
61       ·   release_message - String::Formatter string for what commit message
62           to use when committing the results of the release.
63
64           Defaults to the same as "message".
65
66       ·   multiple_inheritance - Indicates whether the commit containing the
67           build results should have the source commit as a parent.
68
69           If false (the default), the build branch will be completely
70           separate from the regular code branches.  If set to a true value,
71           commits on a build branch will have two parents: the previous build
72           commit and the source commit from which the build was generated.
73

SUPPORT

75       Bugs may be submitted through the RT bug tracker
76       <https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-
77       Git> (or bug-Dist-Zilla-Plugin-Git@rt.cpan.org <mailto:bug-Dist-Zilla-
78       Plugin-Git@rt.cpan.org>).
79
80       There is also a mailing list available for users of this distribution,
81       at <http://dzil.org/#mailing-list>.
82
83       There is also an irc channel available for users of this distribution,
84       at "#distzilla" on "irc.perl.org" <irc://irc.perl.org/#distzilla>.
85
86       I am also usually active on irc, as 'ether' at "irc.perl.org".
87

AUTHOR

89       Jerome Quelin
90

92       This software is copyright (c) 2009 by Jerome Quelin.
93
94       This is free software; you can redistribute it and/or modify it under
95       the same terms as the Perl 5 programming language system itself.
96
97
98
99perl v5.28.1                      2018-D0i6s-t0:3:Zilla::Plugin::Git::CommitBuild(3)
Impressum