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.048
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           •   %V - The release version number, but with a leading "v" removed
60               if it exists
61
62           •   %t - The string "-TRIAL" if this is a trial release
63
64       •   release_message - String::Formatter string for what commit message
65           to use when committing the results of the release.
66
67           Defaults to the same as "message".
68
69       •   multiple_inheritance - Indicates whether the commit containing the
70           build results should have the source commit as a parent.
71
72           If false (the default), the build branch will be completely
73           separate from the regular code branches.  If set to a true value,
74           commits on a build branch will have two parents: the previous build
75           commit and the source commit from which the build was generated.
76

SUPPORT

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

AUTHOR

90       Jerome Quelin
91

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