NAME

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

VERSION

       version 2.043

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>.

       I am also usually active on irc, as 'ether' at "irc.perl.org".

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.