focal (3) Dist::Zilla::Plugin::Git::Init.3pm.gz

NAME

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

VERSION

       version 2.046

SYNOPSIS

       In your profile.ini:

           [Git::Init]
           commit_message = initial commit  ; this is the default
           commit = 1                       ; this is the default
           branch =                         ; this is the default (means master)
           remote = origin git@github.com:USERNAME/%{lc}N.git ; no default
           config = user.email USERID@cpan.org  ; there is no default

DESCRIPTION

       This plugin initializes a git repository when a new distribution is created with "dzil new".

   Plugin options
       The plugin accepts the following options:

       •   commit_message - the commit message to use when checking in the newly-minted dist. Defaults to
           "initial commit".

       •   commit - if true (the default), commit the newly-minted dist.  If set to a false value, add the files
           to the Git index but don't actually make a commit.

       •   branch - the branch name under which the newly-minted dist is checked in (if "commit" is true).
           Defaults to an empty string, which means that the Git default branch is used (master).

       •   config - a config setting to make in the repository.  No config entries are made by default.  A
           setting is specified as "OPTION VALUE".  This may be specified multiple times to add multiple
           entries.

       •   remote - a remote to add to the repository.  No remotes are added by default.  A remote is specified
           as "NAME URL".  This may be specified multiple times to add multiple remotes.

   Formatting options
       You can use the following codes in "commit_message", "config", or "remote":

       %n  A newline.

       %N  The distribution name.  You can also use "%{lc}N" or "%{uc}N" to get the name in lower case or upper
           case, respectively.

SUPPORT

       Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-
       Zilla-Plugin-Git> (or bug-Dist-Zilla-Plugin-Git@rt.cpan.org <mailto:bug-Dist-Zilla-Plugin-
       Git@rt.cpan.org>).

       There is also a mailing list available for users of this distribution, at
       <http://dzil.org/#mailing-list>.

       There is also an irc channel available for users of this distribution, at "#distzilla" on "irc.perl.org"
       <irc://irc.perl.org/#distzilla>.

AUTHOR

       Jerome Quelin

COPYRIGHT AND LICENCE

       This software is copyright (c) 2009 by Jerome Quelin.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5
       programming language system itself.