.\" 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 "Pinto::Manual::QuickStart 3pm"
.TH Pinto::Manual::QuickStart 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"
Pinto::Manual::QuickStart \- A condensed summary of Pinto
.SH "VERSION"
.IX Header "VERSION"
version 0.14
.SH "INSTALLING PINTO"
.IX Header "INSTALLING PINTO"
.Vb 2
\&  curl \-L http://getpinto.stratopan.com | bash
\&  source ~/opt/local/pinto/etc/bashrc
.Ve
.SH "CREATING A REPOSITORY"
.IX Header "CREATING A REPOSITORY"
.Vb 3
\&  # A new repository with default stack named "master"
\&  pinto \-r /repo/dir init
\&  pinto init /repo/dir
\&
\&  # A new repository with default stack named "dev"
\&  pinto \-r /repo/dir init \-\-stack dev
.Ve
.SH "BROWSING A REPOSITORY"
.IX Header "BROWSING A REPOSITORY"
.Vb 2
\&  # See all packages in the default stack
\&  pinto \-r /repo/dir list
\&
\&  # See all packages in the default stack matching m/Foo::Bar/i
\&  pinto \-r /repo/dir list \-P Foo::Bar
\&
\&  # See all packages in the default stack by author "JOE"
\&  pinto \-r /repo/dir list \-A JOE
\&
\&  # See all packages in the "dev" stack
\&  pinto \-r /repo/dir list \-\-stack dev
\&  pinto \-r /repo/dir list dev
.Ve
.SH "PULLING UPSTREAM DISTRIBUTIONS"
.IX Header "PULLING UPSTREAM DISTRIBUTIONS"
.Vb 2
\&  # Pull any version of Foo::Bar
\&  pinto \-r /repo/dir pull Foo::Bar
\&
\&  # Pull version 2.4 or newer of Foo::Bar
\&  pinto \-r /repo/dir pull Foo~2.4
\&
\&  # Pull exactly version 2.4 of Foo::Bar
\&  pinto \-r /repo/dir pull Foo==2.4
\&
\&  # Pull a specific distribution
\&  pinto \-r /repo/dir pull AUTHOR/Foo\-Bar\-1.9.tar.gz
\&
\&  # Pull and pin at the same time
\&  pinto \-r /repo/dir pull \-\-pin Foo::Bar~2.4
\&
\&  # Pull many packages or distributions
\&  pinto \-r /repo/dir pull Foo::Bar Baz::Qux ...
\&  pinto \-r /repo/dir pull < LIST_OF_PACKAGES
\&
\&  # Pull everything for a Dist::Zilla project
\&  dzil listdeps | pinto \-r /repo/dir pull
\&
\&  # Pull onto the "dev" stack
\&  pinto \-r /repo/dir pull \-\-stack dev Foo::Bar
.Ve
.SH "ADDING LOCAL DISTRIBUTIONS"
.IX Header "ADDING LOCAL DISTRIBUTIONS"
.Vb 2
\&  # Add a local dist to the default stack
\&  pinto \-r /repo/dir add My\-Dist\-1.0.tar.gz
\&
\&  # Assign to a different author
\&  pinto \-r /repo/dir add \-\-author SHAKESPEARE My\-Dist\-1.0.tar.gz
\&
\&  # Add and pin at the same time
\&  pinto \-r /repo/dir add \-\-pin My\-Dist\-1.0.tar.gz
\&
\&  # Add to the "dev" stack
\&  pinto \-r /repo/dir add \-\-stack dev My\-Dist\-1.0.tar.gz
.Ve
.SH "INSTALLING THINGS"
.IX Header "INSTALLING THINGS"
.Vb 2
\&  # Install from the default stack using cpanm
\&  cpanm \-\-mirror file:///repo/dir \-\-mirror\-only Foo::Bar
\&
\&  # Install from the "dev" stack using cpanm
\&  cpanm \-\-mirror file:///repo/dir/stacks/dev \-\-mirror\-only Foo::Bar
\&
\&  # Install from the default stack using pinto
\&  pinto \-r /repo/dir install Foo::Bar
\&
\&  # Install from the "dev" stack using pinto
\&  pinto \-r /repo/dir \-\-stack dev install Foo::Bar
\&
\&  # Install and populate the repository with missing prereqs
\&  pinto \-r /repo/dir install \-\-do\-pull Foo::Bar
.Ve
.SH "MANAGING STACKS"
.IX Header "MANAGING STACKS"
.Vb 2
\&  # Create an empty stack named "qa"
\&  pinto \-r /repo/dir new qa
\&
\&  # Create a stack by copying "dev" to "qa"
\&  pinto \-r /repo/dir copy dev qa
\&
\&  # Delete the dev stack
\&  pinto \-r /repo/dir kill dev
\&
\&  # Rename the "dev" stack to "prod"
\&  pinto \-r /repo/dir rename dev prod
\&
\&  # Mark the "qa" stack as the default
\&  pinto \-r /repo/dir default qa
\&
\&  # Show config properties of the default stack
\&  pinto \-r /repo/dir props
\&
\&  # Set config properties of the default stack
\&  pinto \-r /repo/dir props \-\-property NAME=VALUE
\&
\&  # Show all the existing stacks
\&  pinto \-r /repo/dir stacks
.Ve
.SH "USING PINS"
.IX Header "USING PINS"
.Vb 2
\&  # Pin a package on the default stack
\&  pinto \-r /repo/dir pin Foo::Bar
\&
\&  # Pin a package on the "dev" stack
\&  pinto \-r /repo/dir pin \-\-stack dev Foo::Bar
\&
\&  # Pin a distribution
\&  pinto \-r /repo/dir pin AUTHOR/Foo\-Bar\-1.0.tar.gz
\&
\&  # Unpin a package from the default stack
\&  pinto \-r /repo/dir unpin Fo::Bar
\&
\&  # Unpin a package from the "dev" stack
\&  pinto \-r /repo/dir unpin \-\-stack dev Foo::Bar
\&
\&  # Unpin a distribution
\&  pinto \-r /repo/dir unpin AUTHOR/Foo\-Bar\-1.0.tar.gz
.Ve
.SH "VERSION CONTROL"
.IX Header "VERSION CONTROL"
.Vb 2
\&  # View commit messages for the default stack
\&  pinto \-r /repo/dir log
\&
\&  # View commit messages for the "dev" stack
\&  pinto \-r /repo/dir log dev
\&
\&  # Compare the heads of the default and "qa" stacks
\&  pinto \-r /repo/dir diff qa
\&
\&  # Compare the heads of the "dev" and "qa" stacks
\&  pinto \-r /repo/dir diff dev qa
\&
\&  # Merge "dev" stack into the "qa" stack (fast\-forward only)
\&  pinto \-r /repo/dir merge dev qa
.Ve
.SH "MISCELLANY"
.IX Header "MISCELLANY"
.Vb 2
\&  # Report missing distribution archives
\&  pinto \-r /repo/dir verify
\&
\&  # Report repo statistics
\&  pinto \-r /repo/dir stats
\&
\&  # Remove orphan files and tune the database
\&  pinto \-r /repo/dir clean
\&
\&  # Report top\-level distributions of the default stack
\&  pinto \-r /repo/dir roots
.Ve
.SH "GETTING MORE HELP"
.IX Header "GETTING MORE HELP"
.Vb 2
\&  # Show a list of pinto commands
\&  pinto commands
\&
\&  # Show a brief summary of a COMMAND
\&  pinto help COMMAND
\&
\&  # Show the manual for a COMMAND
\&  pinto manual COMMAND
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Pinto::Manual::Tutorial
.PP
Pinto::Manual::Installing
.PP
Pinto (the library)
.PP
pinto (the command)
.SH "AUTHOR"
.IX Header "AUTHOR"
Jeffrey Ryan Thalhammer <jeff@stratopan.com>
.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.