/ 
App-Pinto-0.054
/ App::Pinto::Command::merge

NAME

App::Pinto::Command::merge - merge one stack into another

VERSION

version 0.054

SYNOPSIS

pinto --root=REPOSITORY_ROOT merge [OPTIONS] SOURCE_STACK TARGET_STACK

DESCRIPTION

!! THIS COMMAND IS EXPERIMENTAL !!

This command merges the packages from one stack (the SOURCE) into another (the TARGET). Merge rules are as follows:

  • If a package in the SOURCE is newer than the corresponding package in the TARGET, then the package in the TARGET is upgraded to the same version as the package in the SOURCE.

  • If the package in the TARGET is pinned and the corresponding package in the SOURCE is newer, then a conflict occurrs.

  • If the package in the SOURCE is pinned and the corresponding package in the TARGET is newer, then a conflict occurrs.

Whenever there is a conflict, the merge is aborted. All the pins from the SOURCE are also placed on the TARGET. Both SOURCE and TARGET stacks must already exist before merging. Please see the copy or new commands to create stacks.

COMMAND ARGUMENTS

Required arguments are the name of the SOURCE stack and the name of the TARGET stack.

COMMAND OPTIONS

--dryrun

Go through all the motions, but do not actually commit any changes to the repository. Use this option to see potential conflicts that would prevent a real merge.

--message=TEXT
-m TEXT

Use TEXT as the revision history log message. If you do not use the --message option or --use-default-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.

--use-default-message
-M

Use the default value for the revision history log message. Pinto will generate a semi-informative log message just based on the command and its arguments. If you set an explicit message with --message, the --use-default-message option will be silently ignored.

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.