.\" 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::reset 3pm"
.TH App::Pinto::Command::reset 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::reset \- reset stack to a prior revision
.SH "VERSION"
.IX Header "VERSION"
version 0.14
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  pinto \-\-root=REPOSITORY_ROOT reset [OPTIONS] REVISION
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
!! \s-1THIS COMMAND IS EXPERIMENTAL\s0 !!
.PP
This command moves the head of the stack to a prior revision, thereby
discarding subsequent revisions.  See the
revert command to restore the stack to a prior
revision by creating a new revision.
.SH "COMMAND ARGUMENTS"
.IX Header "COMMAND ARGUMENTS"
The arguments are the name of the stack and the id of the revision to reset
to.  If the stack is not specified, then it defaults to whichever stack is
currently marked as the default.  The stack can also be specified using the
\&\f(CW\*(C`\-\-stack\*(C'\fR option.  Some examples:
.PP
.Vb 2
\&  pinto ... reset af01256e          # Reset default stack to revision af01256e
\&  pinto ... reset mystack af01256e  # Reset mystack to revision af0125e
.Ve
.SH "COMMAND OPTIONS"
.IX Header "COMMAND OPTIONS"
.IP "\-\-force" 4
.IX Item "--force"
Force reset even if the revision is not actually an ancestor.  Normally, you
can only reset to a revision that the stack has actually been at.
.IP "\-\-stack=NAME" 4
.IX Item "--stack=NAME"
.PD 0
.IP "\-s \s-1NAME\s0" 4
.IX Item "-s NAME"
.PD
Peform reset on the stack with the given \s-1NAME.\s0  Defaults to the name of
whichever stack is currently marked as the default stack.  Use the
stacks command to see the stacks in the
repository.  This option is silently ignored if the stack is specified as a
command argument instead.
.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.