Dist::Zilla::App::Command::new - start a new dist
version 1.093000
Creates a new Dist-Zilla based distribution in the current directory.
dzil new NAME
$ dzil new My::Module::Name $ dzil new .
NAME = PACKAGE | DOTDIR DOTDIR = "." PACKAGE = "Your-Package-Name" | "Your::Module::Name"
Can be either the value '.' , or a main-module name ( ie: Foo::Bar )
Foo::Bar
If the name given for the name is . it will assume the parent directory is the module name, ie:
name
.
$ cd /tmp/foo-bar/ $ dist new .
This will create
$ /tmp/foo-bar/dist.ini
:: tokens will be replaced with '-''s and a respective directory created.
::
ie:
$ cd /tmp $ dist new Foo::Bar
creates
$ /tmp/Foo-Bar/dist.ini
The main purpose of the 'new' command is to generate a model dist.ini file that will do just the basics.
dist.ini
name = <DIST-NAME> version = <DIST-VERSION> author = <DIST-AUTHOR1> author = <DIST-AUTHOR2> license = <DIST-LICENSE> copyright_holder = <DIST-AUTHOR1> [@Classic]
This is the detected / provided name of the distribution. See "NAME" for how this is provided.
This is loaded from your configuration, or 1.000 if not configured.
This is loaded from your "CONFIGURATION" in configuration, or attempted to be detected from the environment/uid if not configured.
This is loaded from your "CONFIGURATION" in configuration, or set to "Perl_5" if not configured.
In ~/.dzil or ~/.dzil/config.ini
~/.dzil
~/.dzil/config.ini
[=Dist::Zilla::App::Command::new] author = authorname # used for copyright owner author = author2name initial_version = 3.1415 default_license = BSD
Ricardo SIGNES <rjbs@cpan.org>
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.
To install Dist::Zilla, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla
CPAN shell
perl -MCPAN -e shell install Dist::Zilla
For more information on module installation, please visit the detailed CPAN module installation guide.