NAME

App::Pinto::Command::revert - restore stack to a prior revision

VERSION

version 0.052

SYNOPSIS

pinto --root=REPOSITORY_ROOT revert [STACK[@REVISION]] [OPTIONS]

DESCRIPTION

!! THIS COMMAND IS EXPERIMENTAL !!

This command restores a stack to the state at a prior revision. That state becomes the new head revision of the stack.

COMMAND ARGUMENTS

As an alternative to the --stack and --revision options, you can also specify them as a single argument. So the following examples are equivalent:

pinto --root REPOSITORY_ROOT revert --stack=dev --revision=298
pinto --root REPOSITORY_ROOT revert dev@298

A STACK@REVISION argument will override anything specified with the --stack or --revision options.

If neither the stack nor revision is specified using neither arguments nor options, then the last revision of the default stack will be reverted. And if NUMBER is negative, it means to revert than many revisions back from the current head. So if the default stack is called dev then all the following would be equivalent:

pinto --root REPOSITORY_ROOT revert --stack=dev --revision=-1
pinto --root REPOSITORY_ROOT revert dev@-1
pinto --root REPOSITORY_ROOT revert dev
pinto --root REPOSITORY_ROOT revert @-1
pinto --root REPOSITORY_ROOT revert

COMMAND OPTIONS

--dryrun

Go through all the motions, but do not actually commit any changes to the repository. Use this option to see how the command would potentially impact the stack.

--message=TEXT

-m TEXT

Use TEXT as the revision history log message. If you do not use --message option, then you will be prompted to enter the message via your text editor. Use the EDITOR or VISUAL environment variables to control which editor is used. A log message is not required whenever the --dryrun option is set, or if the action did not yield any changes to the repository.

--revision=NUMBER

-R NUMBER

The number of the revision that the stack will be reverted to. If NUMBER is negative, it means to revert than many revisions back from the current head.

--stack NAME

-s NAME

Reverts the stack with the given NAME. 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.

AUTHOR

Jeffrey Thalhammer <jeff@imaginative-software.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.