NAME

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

VERSION

version 1.093000

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 configuration, or attempted to be detected from the environment/uid if not configured.

DIST-LICENSE

This is loaded from your "CONFIGURATION" in configuration, 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 software is copyright (c) 2009 by Ricardo SIGNES.

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

cpanm Dist::Zilla

perl -MCPAN -e shell
install Dist::Zilla