NAME
Dist::Zilla::App::Command::new - start a new dist
VERSION
version 2.100862
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) 2010 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.