1Dist::Zilla::Plugin::GiUts:e:rInCiotn(t3r)ibuted Perl DoDciusmte:n:tZaitliloan::Plugin::Git::Init(3)
2
3
4

NAME

6       Dist::Zilla::Plugin::Git::Init - Initialize git repository on dzil new
7

VERSION

9       version 2.048
10

SYNOPSIS

12       In your profile.ini:
13
14           [Git::Init]
15           commit_message = initial commit  ; this is the default
16           commit = 1                       ; this is the default
17           branch =                         ; this is the default (means master)
18           remote = origin https://github.com/USERNAME/%N.git ; no default
19           push_url = origin git@github.com:USERNAME/%{lc}N.git ; no default
20           config = user.email USERID@cpan.org  ; there is no default
21

DESCRIPTION

23       This plugin initializes a git repository when a new distribution is
24       created with "dzil new".
25
26   Plugin options
27       The plugin accepts the following options:
28
29       •   commit_message - the commit message to use when checking in the
30           newly-minted dist. Defaults to "initial commit".
31
32       •   commit - if true (the default), commit the newly-minted dist.  If
33           set to a false value, add the files to the Git index but don't
34           actually make a commit.
35
36       •   branch - the branch name under which the newly-minted dist is
37           checked in (if "commit" is true). Defaults to an empty string,
38           which means that the Git default branch is used (master).
39
40       •   config - a config setting to make in the repository.  No config
41           entries are made by default.  A setting is specified as "OPTION
42           VALUE".  This may be specified multiple times to add multiple
43           entries.
44
45       •   remote - a remote to add to the repository.  No remotes are added
46           by default.  A remote is specified as "NAME URL".  This may be
47           specified multiple times to add multiple remotes.
48
49       •   push_url - the URL to use to push to a particular remote to add to
50           the repository.  No URLs are added by default.  A remote is
51           specified as "NAME URL".  This may be specified multiple times to
52           specify push URLs for multiple remotes, and is not required if the
53           URL is the same as the one already set for that remote.
54
55           Per the documentation for git-remote(1): Note that the push_url and
56           the corresponding URL specified with "remote", even though they can
57           be set differently, must still refer to the same place. What you
58           pushed to the push URL should be what you would see if you
59           immediately fetched from the fetch URL (the URL specified with
60           "remote".) If you are trying to fetch from one place (e.g. your
61           upstream) and push to another (e.g. your publishing repository),
62           use two separate remotes.
63
64           This, therefore, is best used in cases where pushing requires
65           authentication, but pulling does not, or if pulling is via git or
66           ssh, but pushing is via https, on the same repository.
67
68   Formatting options
69       You can use the following codes in "commit_message", "config",
70       "remote", or "push_url":
71
72       %n  A newline.
73
74       %N  The distribution name.  You can also use "%{lc}N" or "%{uc}N" to
75           get the name in lower case or upper case, respectively.
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.36.0                      2022-07-22 Dist::Zilla::Plugin::Git::Init(3)
Impressum