NAME

Dist::Zilla::App::Command::new - start a new dist

VERSION

version 2.101151

SYNOPSIS

Creates a new Dist-Zilla based distribution in the current directory.

    dzil new NAME

EXAMPLE

    $ dzil new My::Module::Name
    $ dzil new .

ARGUMENTS

  NAME = PACKAGE | DOTDIR
  DOTDIR  = "."
  PACKAGE = "Your-Package-Name" | "Your::Module::Name"

NAME

Can be either the value '.' , or a main-module name ( ie: Foo::Bar )

DOTDIR

If the name given for the name is . it will assume the parent directory is the module name, ie:

  $ cd /tmp/foo-bar/
  $ dist new .

This will create /tmp/foo-bar/dist.ini

PACKAGE

:: tokens will be replaced with '-''s and a respective directory created.

ie:

  $ cd /tmp
  $ dist new Foo::Bar

creates

  $ /tmp/Foo-Bar/dist.ini

GENERATED FILE

The main purpose of the 'new' command is to generate a model dist.ini file that will do just the basics.

    name = <DIST-NAME>
    version = <DIST-VERSION>
    author  = <DIST-AUTHOR1>
    author  = <DIST-AUTHOR2>
    license = <DIST-LICENSE>
    copyright_holder = <DIST-AUTHOR1>

    [@Classic]

GENERATED FIELDS

DIST-NAME

This is the detected / provided name of the distribution. See NAME for how this is provided.

DIST-VERSION

This is loaded from your configuration, or 1.000 if not configured.

DIST-AUTHOR[n]

This is loaded from your CONFIGURATION in the configuration manpage, or attempted to be detected from the environment/uid if not configured.

DIST-LICENSE

This is loaded from your CONFIGURATION in the configuration manpage, or set to "Perl_5" if not configured.

CONFIGURATION

In ~/.dzil or ~/.dzil/config.ini

  [=Dist::Zilla::App::Command::new]
  author = authorname  # used for copyright owner
  author = author2name
  initial_version = 3.1415
  default_license = BSD

AUTHOR

  Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE

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

Dist::Zilla::App::Command::new - start a new dist