summaryrefslogtreecommitdiffstats
path: root/git-p4.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-06-01 16:13:44 +0900
committerJunio C Hamano <gitster@pobox.com>2018-06-01 16:13:44 +0900
commitc9cb517b2749cb836e12257460f85d440c93320d (patch)
tree5569b7a92ee1e0d500d481d64faa44f82c14ee73 /git-p4.txt
parent944ce257455780f7b55f49fd76c18ea6d0b77b0a (diff)
downloadgit-htmldocs-c9cb517b2749cb836e12257460f85d440c93320d.tar.gz
Autogenerated HTML docs for v2.18.0-rc0-42-gc2c7
Diffstat (limited to 'git-p4.txt')
-rw-r--r--git-p4.txt32
1 files changed, 32 insertions, 0 deletions
diff --git a/git-p4.txt b/git-p4.txt
index b0abe2cb0..6646d5e6c 100644
--- a/git-p4.txt
+++ b/git-p4.txt
@@ -164,6 +164,31 @@ $ git p4 submit --shelve
$ git p4 submit --update-shelve 1234 --update-shelve 2345
----
+
+Unshelve
+~~~~~~~~
+Unshelving will take a shelved P4 changelist, and produce the equivalent git commit
+in the branch refs/remotes/p4/unshelved/<changelist>.
+
+The git commit is created relative to the current origin revision (HEAD by default).
+If the shelved changelist's parent revisions differ, git-p4 will refuse to unshelve;
+you need to be unshelving onto an equivalent tree.
+
+The origin revision can be changed with the "--origin" option.
+
+If the target branch in refs/remotes/p4/unshelved already exists, the old one will
+be renamed.
+
+----
+$ git p4 sync
+$ git p4 unshelve 12345
+$ git show refs/remotes/p4/unshelved/12345
+<submit more changes via p4 to the same files>
+$ git p4 unshelve 12345
+<refuses to unshelve until git is in sync with p4 again>
+
+----
+
OPTIONS
-------
@@ -337,6 +362,13 @@ These options can be used to modify 'git p4 rebase' behavior.
--import-labels::
Import p4 labels.
+Unshelve options
+~~~~~~~~~~~~~~~~
+
+--origin::
+ Sets the git refspec against which the shelved P4 changelist is compared.
+ Defaults to p4/master.
+
DEPOT PATH SYNTAX
-----------------
The p4 depot path argument to 'git p4 sync' and 'git p4 clone' can