Skip to content

Commit 3e681a7

Browse files
phillipwoodgitster
authored andcommitted
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 <[email protected]> Acked-by: Elijah Newren <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 54cf5d2 commit 3e681a7

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

Documentation/git-merge-tree.txt

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,11 @@ After the merge completes, a new toplevel tree object is created. See
4040
OPTIONS
4141
-------
4242

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+
4348
-z::
4449
Do not quote filenames in the <Conflicted file info> section,
4550
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:
116121

117122
0: merge had conflicts
118123
1: merge was clean
119-
<0: something prevented the merge from running (e.g. access to repository
120-
objects denied by filesystem)
121124

122125
[[OIDTLT]]
123126
OID of toplevel tree
@@ -235,6 +238,7 @@ with linkgit:git-merge[1]:
235238
* any messages that would have been printed to stdout (the
236239
<<IM,Informational messages>>)
237240

241+
[[INPUT]]
238242
INPUT FORMAT
239243
------------
240244
'git merge-tree --stdin' input format is fully text based. Each line

0 commit comments

Comments
 (0)