git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v3 18/19] apply: document --3way option

From
Junio C Hamano <gitster@pobox.com>
Date
Jun 13, 2012, 19:32 UTC
Message-ID
<1339615980-19727-19-git-send-email-gitster@pobox.com>
In-Reply-To
<1339615980-19727-1-git-send-email-gitster@pobox.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---
 Documentation/git-apply.txt | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-apply.txt b/Documentation/git-apply.txt
index afd2c9a..634b84e 100644
--- a/Documentation/git-apply.txt
+++ b/Documentation/git-apply.txt
@@ -9,7 +9,7 @@ git-apply - Apply a patch to files and/or to the index
 SYNOPSIS
 --------
 [verse]
-'git apply' [--stat] [--numstat] [--summary] [--check] [--index]
+'git apply' [--stat] [--numstat] [--summary] [--check] [--index] [--3way]
 	  [--apply] [--no-add] [--build-fake-ancestor=<file>] [-R | --reverse]
 	  [--allow-binary-replacement | --binary] [--reject] [-z]
 	  [-p<n>] [-C<n>] [--inaccurate-eof] [--recount] [--cached]
@@ -72,6 +72,15 @@ OPTIONS
 	cached data, apply the patch, and store the result in the index
 	without using the working tree. This implies `--index`.
 
+-3::
+--3way::
+	When the patch does not apply cleanly, fall back on 3-way merge if
+	the patch records the identity of blobs it is supposed to apply to,
+	and we have those blobs available locally, possibly leaving the
+	conflict markers in the files in the working tree for the user to
+	resolve.  This option implies the `--index` option, and is incompatible
+	with the `--reject` and the `--cached` options.
+
 --build-fake-ancestor=<file>::
 	Newer 'git diff' output has embedded 'index information'
 	for each blob to help identify the original version that
-- 
1.7.11.rc3.30.g3bdace2
Previous: Junio C HamanoNext: Junio C Hamano
Message 19 of 20 in “"git apply --3way"”
  1. 00/19 "git apply --3way"Junio C Hamano, Jun 13, 2012
  2. 01/19 apply: fix an incomplete comment in check_patch()Junio C Hamano, Jun 13, 2012
  3. 02/19 apply: a bit more comments on PATH_TO_BE_DELETEDJunio C Hamano, Jun 13, 2012
  4. 03/19 apply: clear_image() clears things a bit moreJunio C Hamano, Jun 13, 2012
  5. 04/19 apply: refactor read_file_or_gitlink()Junio C Hamano, Jun 13, 2012
  6. 05/19 apply: factor out checkout_target() helper functionJunio C Hamano, Jun 13, 2012
  7. 06/19 apply: split load_preimage() helper function outJunio C Hamano, Jun 13, 2012
  8. 07/19 apply: refactor "previous patch" logicJunio C Hamano, Jun 13, 2012
  9. 08/19 apply: further split load_preimage()Junio C Hamano, Jun 13, 2012
  10. 09/19 apply: move check_to_create_blob() closer to its sole callerJunio C Hamano, Jun 13, 2012
  11. 10/19 apply: move "already exists" logic to check_to_create()Junio C Hamano, Jun 13, 2012
  12. 11/19 apply: accept -3/--3way command line optionJunio C Hamano, Jun 13, 2012
  13. 12/19 apply: fall back on three-way mergeJunio C Hamano, Jun 13, 2012
  14. 13/19 apply: plug the three-way merge logic inJunio C Hamano, Jun 13, 2012
  15. 14/19 apply: move verify_index_match() higherJunio C Hamano, Jun 13, 2012
  16. 15/19 apply: --3way with add/add conflictJunio C Hamano, Jun 13, 2012
  17. 16/19 apply: register conflicted stages to the indexJunio C Hamano, Jun 13, 2012
  18. 17/19 apply: allow rerere() upon --3way resultsJunio C Hamano, Jun 13, 2012
  19. 18/19 apply: document --3way optionJunio C Hamano, Jun 13, 2012
  20. 19/19 apply --3way: testsJunio C Hamano, Jun 13, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.