.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "App::Pinto::Command::init 3pm" .TH App::Pinto::Command::init 3pm "2022-10-16" "perl v5.34.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" App::Pinto::Command::init \- create a new repository .SH "VERSION" .IX Header "VERSION" version 0.14 .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& pinto \-\-root=REPOSITORY_ROOT init [OPTIONS] .Ve .SH "DESCRIPTION" .IX Header "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. .SH "COMMAND ARGUMENTS" .IX Header "COMMAND ARGUMENTS" The path to the repository root directory can also be be given as an argument, which will silently override the \f(CW\*(C`\-\-root\*(C'\fR option. So the following are equivalent: .PP .Vb 2 \& pinto \-\-root=/some/directory init \& pinto init /some/directory .Ve .SH "COMMAND OPTIONS" .IX Header "COMMAND OPTIONS" .IP "\-\-description=TEXT" 4 .IX Item "--description=TEXT" A brief description of the initial stack. Defaults to \*(L"the initial stack\*(R". This option is only allowed if the \f(CW\*(C`STACK\*(C'\fR argument is given. .IP "\-\-no\-default" 4 .IX Item "--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 \f(CW\*(C`\-\-stack\*(C'\fR option for most commands. You can always mark (or unmark) the default stack at any time by using the default command. .IP "\-\-recurse" 4 .IX Item "--recurse" .PD 0 .IP "\-\-no\-recurse" 4 .IX Item "--no-recurse" .PD Sets the default recursion behavior for the pull add add commands. \f(CW\*(C`\-\-recurse\*(C'\fR means that commands will be recursive by default. \f(CW\*(C`\-\-no\-recurse\*(C'\fR means commands will not be recursive. If you do not specify either of these, it defaults to being recursive. However, each command can always override this default. .IP "\-\-source=URI" 4 .IX Item "--source=URI" The \s-1URI\s0 of the upstream repository where distributions will be pulled from. This is usually the \s-1URI\s0 of a \s-1CPAN\s0 mirror, and it defaults to and . But it could also be a CPAN::Mini mirror, or another Pinto repository. .Sp You can specify multiple repository URIs by repeating the \f(CW\*(C`\-\-source\*(C'\fR 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. .IP "\-\-stack=NAME" 4 .IX Item "--stack=NAME" Sets the name of the initial stack. Stack names must be alphanumeric plus hyphens, underscores, and periods, and are not case-sensitive. Defaults to \&\f(CW\*(C`master\*(C'\fR. .SH "AUTHOR" .IX Header "AUTHOR" Jeffrey Ryan Thalhammer .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer. .PP This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.