merge-tree: improve docs for --stdin
Add a section for --stdin in the list of options and document that it implies -z so readers know how to parse the output. Also correct the merge status documentation for --stdin as if the status is less than zero "git merge-tree" dies before printing it. Signed-off-by: Phillip Wood <phillip.wood@dunelm.org.uk> Acked-by: Elijah Newren <newren@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Phillip Wood committed
Feb 18, 2025 at 16:24 UTC
3e681a7ccc97b81f9c93e5b4ca6d3a85d9817285
1 file changed
+6
-2
Documentation/git-merge-tree.txt
+6
-2
@@ -40,6 +40,11 @@ After the merge completes, a new toplevel tree object is created. See
40
OPTIONS
41
-------
42
43
+--stdin::
44
+ Read the commits to merge from the standard input rather than
45
+ the command-line. See <<INPUT,INPUT FORMAT>> below for more
46
+ information. Implies `-z`.
47
+
48
-z::
49
Do not quote filenames in the <Conflicted file info> section,
50
and end each filename with a NUL character rather than
@@ -116,8 +121,6 @@ This is an integer status followed by a NUL character. The integer status is:
121
122
0: merge had conflicts
123
1: merge was clean
119
- <0: something prevented the merge from running (e.g. access to repository
120
- objects denied by filesystem)
124
125
[[OIDTLT]]
126
OID of toplevel tree
@@ -235,6 +238,7 @@ with linkgit:git-merge[1]:
238
* any messages that would have been printed to stdout (the
239
<<IM,Informational messages>>)
240
241
+[[INPUT]]
242
INPUT FORMAT
243
------------
244
'git merge-tree --stdin' input format is fully text based. Each line