1App::Pinto::Command::reUvseerrt(C3o)ntributed Perl DocumAepnpt:a:tPiionnto::Command::revert(3)
2
3
4

NAME

6       App::Pinto::Command::revert - revert stack to a prior revision
7

VERSION

9       version 0.14
10

SYNOPSIS

12         pinto --root=REPOSITORY_ROOT revert [OPTIONS] [STACK] [REVISION]
13

DESCRIPTION

15       !! THIS COMMAND IS EXPERIMENTAL !!
16
17       This command restores the head of the stack to a prior state by
18       creating a new revision that matches the prior state.  See the reset
19       command to move the head back to a prior state and discard subsequent
20       revisions.
21

COMMAND ARGUMENTS

23       The arguments are the name of the stack and/or the id of the revision
24       to revert to.  If the revision id is not specified, it defaults to the
25       immediate parent of head revision of the stack.  If the stack is not
26       specified, then it defaults to whichever stack is currently marked as
27       the default.  The stack can also be specified using the "--stack"
28       option.  Some examples:
29
30         pinto ... revert                   # Revert default stack to previous revision
31         pinto ... revert af01256e          # Revert default stack to revision af01256e
32         pinto ... revert mystack af01256e  # Revert mystack to revision af0125e
33

COMMAND OPTIONS

35       --dry-run
36           Go through all the motions, but do not actually commit any changes
37           to the repository.  At the conclusion, a diff showing the changes
38           that would have been made will be displayed.  Use this option to
39           see how upgrades would potentially impact the stack.
40
41       --force
42           Force reversion even if the revision is not actually an ancestor.
43           Normally, you can only revert to a revision that the stack has
44           actually been at.  This option only has effect if you specify a
45           target revision argument.
46
47       --message=TEXT
48       -m TEXT
49           Use TEXT as the revision history log message.  If you do not use
50           the "--message" option or the "--use-default-message" option, then
51           you will be prompted to enter the message via your text editor.
52           Use the "PINTO_EDITOR" or "EDITOR" or "VISUAL" environment
53           variables to control which editor is used.  A log message is not
54           required whenever the "--dry-run" option is set, or if the action
55           did not yield any changes to the repository.
56
57       --stack=NAME
58       -s NAME
59           Peform reversion on the stack with the given NAME.  Defaults to the
60           name of whichever stack is currently marked as the default stack.
61           Use the stacks command to see the stacks in the repository.  This
62           option is silently ignored if the stack is specified as a command
63           argument instead.
64
65       --use-default-message
66       -M  Use the default value for the revision history log message.  Pinto
67           will generate a semi-informative log message just based on the
68           command and its arguments.  If you set an explicit message with
69           "--message", the "--use- default-message" option will be silently
70           ignored.
71

AUTHOR

73       Jeffrey Ryan Thalhammer <jeff@stratopan.com>
74
76       This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
77
78       This is free software; you can redistribute it and/or modify it under
79       the same terms as the Perl 5 programming language system itself.
80
81
82
83perl v5.34.0                      2022-01-21    App::Pinto::Command::revert(3)
Impressum