/ 
App-Pinto-0.065_03
/ App::Pinto::Command::init

NAME

App::Pinto::Command::init - create a new repository

VERSION

version 0.065_03

SYNOPSIS

pinto --root=REPOSITORY_ROOT init [OPTIONS] [STACK]

DESCRIPTION

This command creates a new repository. If the target directory does not exist, it will be created for you. If it does already exist, then it must be empty. You can set the configuration properties of the new repository using the command line options listed below.

COMMAND ARGUMENTS

The argument is the name of the initial stack. Stack names must be alphanumeric plus hyphens and underscores, and are not case-sensitive. Defaults to master.

COMMAND OPTIONS

--description=TEXT

A brief description of the initial stack. Defaults to "the initial stack". This option is only allowed if the STACK argument is given.

--no-default

Do not mark the initial stack as the default stack.

If you choose not to mark the default stack, then you'll be required to specify the --stack option for most commands. You can always mark (or unmark) the default stack by at any time by using the default command.

--no-history

!! THIS OPTION IS EXPERIMENTAL !!

Do not record the state of the stack at each revision. This makes the database smaller and faster. But it also means you'll never be able to revert, reset, or diff a stack with a prior revision. However, log messages will still be recorded and can be displayed as usual. This option should only be used if creating an archival repository where you don't really care about the changes in each revision (for example, tracking all of BackPAN or CPAN in a Pinto repository).

--source=URL

The URL of the upstream repository where distributions will be pulled from. This is usually the URL of a CPAN mirror, and it defaults to http://cpan.perl.org and http://backpan.perl.org. But it could also be a CPAN::Mini mirror, or another Pinto repository.

You can specify multiple repository URLs by repeating the --source option. Repositories that appear earlier in the list have priority over those that appear later. See Pinto::Manual for more information about using multiple upstream repositories.

AUTHOR

Jeffrey Ryan Thalhammer <jeff@stratopan.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Imaginative Software Systems.

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