git-merge-tree.html - external/gitster/git-htmldocs - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 10.2.0" />
 <title>git-merge-tree(1)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */

 /* Default font. */
 body {
  font-family: Georgia,serif;
 }

 /* Title font. */
 h1, h2, h3, h4, h5, h6,
 div.title, caption.title,
 thead, p.table.header,
 #toctitle,
 #author, #revnumber, #revdate, #revremark,
 #footer {
  font-family: Arial,Helvetica,sans-serif;
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a {
  color: blue;
  text-decoration: underline;
 }
 a:visited {
  color: fuchsia;
 }

 em {
  font-style: italic;
  color: navy;
 }

 strong {
  font-weight: bold;
  color: #083194;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1, h2, h3 {
  border-bottom: 2px solid silver;
 }
 h2 {
  padding-top: 0.5em;
 }
 h3 {
  float: left;
 }
 h3 + * {
  clear: left;
 }
 h5 {
  font-size: 1.0em;
 }

 div.sectionbody {
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 ul, ol, li > p {
  margin-top: 0;
 }
 ul > li { color: #aaa; }
 ul > li > * { color: black; }

 .monospaced, code, pre {
  font-family: "Courier New", Courier, monospace;
  font-size: inherit;
  color: navy;
  padding: 0;
  margin: 0;
 }
 pre {
  white-space: pre-wrap;
 }

 #author {
  color: #527bbd;
  font-weight: bold;
  font-size: 1.1em;
 }
 #email {
 }
 #revnumber, #revdate, #revremark {
 }

 #footer {
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 #footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 #footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 #preamble {
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.0em;
  margin-bottom: 2.0em;
  margin-right: 10%;
  color: #606060;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  color: #527bbd;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid #dddddd;
  border-left: 4px solid #f0f0f0;
  padding: 0.5em;
 }

 div.listingblock > div.content {
  border: 1px solid #dddddd;
  border-left: 5px solid #f0f0f0;
  background: #f8f8f8;
  padding: 0.5em;
 }

 div.quoteblock, div.verseblock {
  padding-left: 1.0em;
  margin-left: 1.0em;
  margin-right: 10%;
  border-left: 5px solid #f0f0f0;
  color: #888;
 }

 div.quoteblock > div.attribution {
  padding-top: 0.5em;
  text-align: right;
 }

 div.verseblock > pre.content {
  font-family: inherit;
  font-size: inherit;
 }
 div.verseblock > div.attribution {
  padding-top: 0.75em;
  text-align: left;
 }
 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
 div.verseblock + div.attribution {
  text-align: left;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 3px solid #dddddd;
 }

 div.exampleblock > div.content {
  border-left: 3px solid #dddddd;
  padding-left: 0.5em;
 }

 div.imageblock div.content { padding-left: 0; }
 span.image img { border-style: none; vertical-align: text-bottom; }
 a.image:visited { color: white; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: normal;
  color: navy;
 }
 dd > *:first-child {
  margin-top: 0.1em;
 }

 ul, ol {
  list-style-position: outside;
 }
 ol.arabic {
  list-style-type: decimal;
 }
 ol.loweralpha {
  list-style-type: lower-alpha;
 }
 ol.upperalpha {
  list-style-type: upper-alpha;
 }
 ol.lowerroman {
  list-style-type: lower-roman;
 }
 ol.upperroman {
  list-style-type: upper-roman;
 }

 div.compact ul, div.compact ol,
 div.compact p, div.compact p,
 div.compact div, div.compact div {
  margin-top: 0.1em;
  margin-bottom: 0.1em;
 }

 tfoot {
  font-weight: bold;
 }
 td > div.verse {
  white-space: pre;
 }

 div.hdlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 div.hdlist tr {
  padding-bottom: 15px;
 }
 dt.hdlist1.strong, td.hdlist1.strong {
  font-weight: bold;
 }
 td.hdlist1 {
  vertical-align: top;
  font-style: normal;
  padding-right: 0.8em;
  color: navy;
 }
 td.hdlist2 {
  vertical-align: top;
 }
 div.hdlist.compact tr {
  margin: 0;
  padding-bottom: 0;
 }

 .comment {
  background: yellow;
 }

 .footnote, .footnoteref {
  font-size: 0.8em;
 }

 span.footnote, span.footnoteref {
  vertical-align: super;
 }

 #footnotes {
  margin: 20px 0 20px 0;
  padding: 7px 0 0 0;
 }

 #footnotes div.footnote {
  margin: 0 0 5px 0;
 }

 #footnotes hr {
  border: none;
  border-top: 1px solid silver;
  height: 1px;
  text-align: left;
  margin-left: 0;
  width: 20%;
  min-width: 100px;
 }

 div.colist td {
  padding-right: 0.5em;
  padding-bottom: 0.3em;
  vertical-align: top;
 }
 div.colist td img {
  margin-top: 0.3em;
 }

 @media print {
  #footer-badges { display: none; }
 }

 #toc {
  margin-bottom: 2.5em;
 }

 #toctitle {
  color: #527bbd;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
 }

 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
 }
 div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
 }
 div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
 }
 div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
 }

 span.aqua { color: aqua; }
 span.black { color: black; }
 span.blue { color: blue; }
 span.fuchsia { color: fuchsia; }
 span.gray { color: gray; }
 span.green { color: green; }
 span.lime { color: lime; }
 span.maroon { color: maroon; }
 span.navy { color: navy; }
 span.olive { color: olive; }
 span.purple { color: purple; }
 span.red { color: red; }
 span.silver { color: silver; }
 span.teal { color: teal; }
 span.white { color: white; }
 span.yellow { color: yellow; }

 span.aqua-background { background: aqua; }
 span.black-background { background: black; }
 span.blue-background { background: blue; }
 span.fuchsia-background { background: fuchsia; }
 span.gray-background { background: gray; }
 span.green-background { background: green; }
 span.lime-background { background: lime; }
 span.maroon-background { background: maroon; }
 span.navy-background { background: navy; }
 span.olive-background { background: olive; }
 span.purple-background { background: purple; }
 span.red-background { background: red; }
 span.silver-background { background: silver; }
 span.teal-background { background: teal; }
 span.white-background { background: white; }
 span.yellow-background { background: yellow; }

 span.big { font-size: 2em; }
 span.small { font-size: 0.6em; }

 span.underline { text-decoration: underline; }
 span.overline { text-decoration: overline; }
 span.line-through { text-decoration: line-through; }

 div.unbreakable { page-break-inside: avoid; }


 /*
  * xhtml11 specific
  *
  * */

 div.tableblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
 }
 div.tableblock > table {
  border: 3px solid #527bbd;
 }
 thead, p.table.header {
  font-weight: bold;
  color: #527bbd;
 }
 p.table {
  margin-top: 0;
 }
 /* Because the table frame attribute is overridden by CSS in most browsers. */
 div.tableblock > table[frame="void"] {
  border-style: none;
 }
 div.tableblock > table[frame="hsides"] {
  border-left-style: none;
  border-right-style: none;
 }
 div.tableblock > table[frame="vsides"] {
  border-top-style: none;
  border-bottom-style: none;
 }


 /*
  * html5 specific
  *
  * */

 table.tableblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
 }
 thead, p.tableblock.header {
  font-weight: bold;
  color: #527bbd;
 }
 p.tableblock {
  margin-top: 0;
 }
 table.tableblock {
  border-width: 3px;
  border-spacing: 0px;
  border-style: solid;
  border-color: #527bbd;
  border-collapse: collapse;
 }
 th.tableblock, td.tableblock {
  border-width: 1px;
  padding: 4px;
  border-style: solid;
  border-color: #527bbd;
 }

 table.tableblock.frame-topbot {
  border-left-style: hidden;
  border-right-style: hidden;
 }
 table.tableblock.frame-sides {
  border-top-style: hidden;
  border-bottom-style: hidden;
 }
 table.tableblock.frame-none {
  border-style: hidden;
 }

 th.tableblock.halign-left, td.tableblock.halign-left {
  text-align: left;
 }
 th.tableblock.halign-center, td.tableblock.halign-center {
  text-align: center;
 }
 th.tableblock.halign-right, td.tableblock.halign-right {
  text-align: right;
 }

 th.tableblock.valign-top, td.tableblock.valign-top {
  vertical-align: top;
 }
 th.tableblock.valign-middle, td.tableblock.valign-middle {
  vertical-align: middle;
 }
 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
  vertical-align: bottom;
 }


 /*
  * manpage specific
  *
  * */

 body.manpage h1 {
  padding-top: 0.5em;
  padding-bottom: 0.5em;
  border-top: 2px solid silver;
  border-bottom: 2px solid silver;
 }
 body.manpage h2 {
  border-style: none;
 }
 body.manpage div.sectionbody {
  margin-left: 3em;
 }

 @media print {
  body.manpage div#toc { display: none; }
 }


 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
 var asciidoc = { // Namespace.

 /////////////////////////////////////////////////////////////////////
 // Table Of Contents generator
 /////////////////////////////////////////////////////////////////////

 /* Author: Mihai Bazon, September 2002
  * http://students.infoiasi.ro/~mishoo
  *
  * Table Of Content generator
  * Version: 0.4
  *
  * Feel free to use this script under the terms of the GNU General Public
  * License, as long as you do not remove or alter this notice.
  */

  /* modified by Troy D. Hanson, September 2006. License: GPL */
  /* modified by Stuart Rackham, 2006, 2009. License: GPL */

 // toclevels = 1..4.
 toc: function (toclevels) {

  function getText(el) {
  var text = "";
  for (var i = el.firstChild; i != null; i = i.nextSibling) {
  if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
  text += i.data;
  else if (i.firstChild != null)
  text += getText(i);
  }
  return text;
  }

  function TocEntry(el, text, toclevel) {
  this.element = el;
  this.text = text;
  this.toclevel = toclevel;
  }

  function tocEntries(el, toclevels) {
  var result = new Array;
  var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
  // Function that scans the DOM tree for header elements (the DOM2
  // nodeIterator API would be a better technique but not supported by all
  // browsers).
  var iterate = function (el) {
  for (var i = el.firstChild; i != null; i = i.nextSibling) {
  if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
  var mo = re.exec(i.tagName);
  if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
  result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
  }
  iterate(i);
  }
  }
  }
  iterate(el);
  return result;
  }

  var toc = document.getElementById("toc");
  if (!toc) {
  return;
  }

  // Delete existing TOC entries in case we're reloading the TOC.
  var tocEntriesToRemove = [];
  var i;
  for (i = 0; i < toc.childNodes.length; i++) {
  var entry = toc.childNodes[i];
  if (entry.nodeName.toLowerCase() == 'div'
  && entry.getAttribute("class")
  && entry.getAttribute("class").match(/^toclevel/))
  tocEntriesToRemove.push(entry);
  }
  for (i = 0; i < tocEntriesToRemove.length; i++) {
  toc.removeChild(tocEntriesToRemove[i]);
  }

  // Rebuild TOC entries.
  var entries = tocEntries(document.getElementById("content"), toclevels);
  for (var i = 0; i < entries.length; ++i) {
  var entry = entries[i];
  if (entry.element.id == "")
  entry.element.id = "_toc_" + i;
  var a = document.createElement("a");
  a.href = "#" + entry.element.id;
  a.appendChild(document.createTextNode(entry.text));
  var div = document.createElement("div");
  div.appendChild(a);
  div.className = "toclevel" + entry.toclevel;
  toc.appendChild(div);
  }
  if (entries.length == 0)
  toc.parentNode.removeChild(toc);
 },


 /////////////////////////////////////////////////////////////////////
 // Footnotes generator
 /////////////////////////////////////////////////////////////////////

 /* Based on footnote generation code from:
  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
  */

 footnotes: function () {
  // Delete existing footnote entries in case we're reloading the footnodes.
  var i;
  var noteholder = document.getElementById("footnotes");
  if (!noteholder) {
  return;
  }
  var entriesToRemove = [];
  for (i = 0; i < noteholder.childNodes.length; i++) {
  var entry = noteholder.childNodes[i];
  if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
  entriesToRemove.push(entry);
  }
  for (i = 0; i < entriesToRemove.length; i++) {
  noteholder.removeChild(entriesToRemove[i]);
  }

  // Rebuild footnote entries.
  var cont = document.getElementById("content");
  var spans = cont.getElementsByTagName("span");
  var refs = {};
  var n = 0;
  for (i=0; i<spans.length; i++) {
  if (spans[i].className == "footnote") {
  n++;
  var note = spans[i].getAttribute("data-note");
  if (!note) {
  // Use [\s\S] in place of . so multi-line matches work.
  // Because JavaScript has no s (dotall) regex flag.
  note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
  spans[i].innerHTML =
  "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
  "' title='View footnote' class='footnote'>" + n + "</a>]";
  spans[i].setAttribute("data-note", note);
  }
  noteholder.innerHTML +=
  "<div class='footnote' id='_footnote_" + n + "'>" +
  "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
  n + "</a>. " + note + "</div>";
  var id =spans[i].getAttribute("id");
  if (id != null) refs["#"+id] = n;
  }
  }
  if (n == 0)
  noteholder.parentNode.removeChild(noteholder);
  else {
  // Process footnoterefs.
  for (i=0; i<spans.length; i++) {
  if (spans[i].className == "footnoteref") {
  var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
  href = href.match(/#.*/)[0]; // Because IE return full URL.
  n = refs[href];
  spans[i].innerHTML =
  "[<a href='#_footnote_" + n +
  "' title='View footnote' class='footnote'>" + n + "</a>]";
  }
  }
  }
 },

 install: function(toclevels) {
  var timerId;

  function reinstall() {
  asciidoc.footnotes();
  if (toclevels) {
  asciidoc.toc(toclevels);
  }
  }

  function reinstallAndRemoveTimer() {
  clearInterval(timerId);
  reinstall();
  }

  timerId = setInterval(reinstall, 500);
  if (document.addEventListener)
  document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
  else
  window.onload = reinstallAndRemoveTimer;
 }

 }
 asciidoc.install();
 /*]]>*/
 </script>
 </head>
 <body class="manpage">
 <div id="header">
 <h1>
 git-merge-tree(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-merge-tree -
  Perform merge without touching index or working tree
 </p>
 </div>
 </div>
 <div id="content">
 <div class="sect1">
 <h2 id="_synopsis">SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="verseblock">
 <pre class="content"><em>git merge-tree</em> [--write-tree] [&lt;options&gt;] &lt;branch1&gt; &lt;branch2&gt;
 <em>git merge-tree</em> [--trivial-merge] &lt;base-tree&gt; &lt;branch1&gt; &lt;branch2&gt; (deprecated)</pre>
 <div class="attribution">
 </div></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="NEWMERGE">DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>This command has a modern <code>--write-tree</code> mode and a deprecated
 <code>--trivial-merge</code> mode. With the exception of the
 <a href="#DEPMERGE">DEPRECATED DESCRIPTION</a> section at the end, the rest of
 this documentation describes modern <code>--write-tree</code> mode.</p></div>
 <div class="paragraph"><p>Performs a merge, but does not make any new commits and does not read
 from or write to either the working tree or index.</p></div>
 <div class="paragraph"><p>The performed merge will use the same feature as the "real"
 <a href="git-merge.html">git-merge(1)</a>, including:</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
 three way content merges of individual files
 </p>
 </li>
 <li>
 <p>
 rename detection
 </p>
 </li>
 <li>
 <p>
 proper directory/file conflict handling
 </p>
 </li>
 <li>
 <p>
 recursive ancestor consolidation (i.e. when there is more than one
  merge base, creating a virtual merge base by merging the merge bases)
 </p>
 </li>
 <li>
 <p>
 etc.
 </p>
 </li>
 </ul></div>
 <div class="paragraph"><p>After the merge completes, a new toplevel tree object is created. See
 <code>OUTPUT</code> below for details.</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_options">OPTIONS</h2>
 <div class="sectionbody">
 <div class="dlist"><dl>
 <dt class="hdlist1">
 -z
 </dt>
 <dd>
 <p>
  Do not quote filenames in the &lt;Conflicted file info&gt; section,
  and end each filename with a NUL character rather than
  newline. Also begin the messages section with a NUL character
  instead of a newline. See <a href="#OUTPUT">[OUTPUT]</a> below for more information.
 </p>
 </dd>
 <dt class="hdlist1">
 --name-only
 </dt>
 <dd>
 <p>
  In the Conflicted file info section, instead of writing a list
  of (mode, oid, stage, path) tuples to output for conflicted
  files, just provide a list of filenames with conflicts (and
  do not list filenames multiple times if they have multiple
  conflicting stages).
 </p>
 </dd>
 <dt class="hdlist1">
 --[no-]messages
 </dt>
 <dd>
 <p>
  Write any informational messages such as "Auto-merging &lt;path&gt;"
  or CONFLICT notices to the end of stdout. If unspecified, the
  default is to include these messages if there are merge
  conflicts, and to omit them otherwise.
 </p>
 </dd>
 <dt class="hdlist1">
 --allow-unrelated-histories
 </dt>
 <dd>
 <p>
  merge-tree will by default error out if the two branches specified
  share no common history. This flag can be given to override that
  check and make the merge proceed anyway.
 </p>
 </dd>
 <dt class="hdlist1">
 --merge-base=&lt;commit&gt;
 </dt>
 <dd>
 <p>
  Instead of finding the merge-bases for &lt;branch1&gt; and &lt;branch2&gt;,
  specify a merge-base for the merge, and specifying multiple bases is
  currently not supported. This option is incompatible with <code>--stdin</code>.
 </p>
 </dd>
 </dl></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="OUTPUT">OUTPUT</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>For a successful merge, the output from git-merge-tree is simply one
 line:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;OID of toplevel tree&gt;</code></pre>
 </div></div>
 <div class="paragraph"><p>Whereas for a conflicted merge, the output is by default of the form:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;OID of toplevel tree&gt;
 &lt;Conflicted file info&gt;
 &lt;Informational messages&gt;</code></pre>
 </div></div>
 <div class="paragraph"><p>These are discussed individually below.</p></div>
 <div class="paragraph"><p>However, there is an exception. If <code>--stdin</code> is passed, then there is
 an extra section at the beginning, a NUL character at the end, and then
 all the sections repeat for each line of input. Thus, if the first merge
 is conflicted and the second is clean, the output would be of the form:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;Merge status&gt;
 &lt;OID of toplevel tree&gt;
 &lt;Conflicted file info&gt;
 &lt;Informational messages&gt;
 NUL
 &lt;Merge status&gt;
 &lt;OID of toplevel tree&gt;
 NUL</code></pre>
 </div></div>
 <div class="sect2">
 <h3 id="MS">Merge status</h3>
 <div class="paragraph"><p>This is an integer status followed by a NUL character. The integer status is:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>0: merge had conflicts
 1: merge was clean
 &lt;0: something prevented the merge from running (e.g. access to repository
  objects denied by filesystem)</code></pre>
 </div></div>
 </div>
 <div class="sect2">
 <h3 id="OIDTLT">OID of toplevel tree</h3>
 <div class="paragraph"><p>This is a tree object that represents what would be checked out in the
 working tree at the end of <code>git merge</code>. If there were conflicts, then
 files within this tree may have embedded conflict markers. This section
 is always followed by a newline (or NUL if <code>-z</code> is passed).</p></div>
 </div>
 <div class="sect2">
 <h3 id="CFI">Conflicted file info</h3>
 <div class="paragraph"><p>This is a sequence of lines with the format</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;mode&gt; &lt;object&gt; &lt;stage&gt; &lt;filename&gt;</code></pre>
 </div></div>
 <div class="paragraph"><p>The filename will be quoted as explained for the configuration
 variable <code>core.quotePath</code> (see <a href="git-config.html">git-config(1)</a>). However, if
 the <code>--name-only</code> option is passed, the mode, object, and stage will
 be omitted. If <code>-z</code> is passed, the "lines" are terminated by a NUL
 character instead of a newline character.</p></div>
 </div>
 <div class="sect2">
 <h3 id="IM">Informational messages</h3>
 <div class="paragraph"><p>This section provides informational messages, typically about
 conflicts. The format of the section varies significantly depending
 on whether <code>-z</code> is passed.</p></div>
 <div class="paragraph"><p>If <code>-z</code> is passed:</p></div>
 <div class="paragraph"><p>The output format is zero or more conflict informational records, each
 of the form:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;list-of-paths&gt;&lt;conflict-type&gt;NUL&lt;conflict-message&gt;NUL</code></pre>
 </div></div>
 <div class="paragraph"><p>where &lt;list-of-paths&gt; is of the form</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>&lt;number-of-paths&gt;NUL&lt;path1&gt;NUL&lt;path2&gt;NUL...&lt;pathN&gt;NUL</code></pre>
 </div></div>
 <div class="paragraph"><p>and includes paths (or branch names) affected by the conflict or
 informational message in &lt;conflict-message&gt;. Also, &lt;conflict-type&gt; is a
 stable string explaining the type of conflict, such as</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
 "Auto-merging"
 </p>
 </li>
 <li>
 <p>
 "CONFLICT (rename/delete)"
 </p>
 </li>
 <li>
 <p>
 "CONFLICT (submodule lacks merge base)"
 </p>
 </li>
 <li>
 <p>
 "CONFLICT (binary)"
 </p>
 </li>
 </ul></div>
 <div class="paragraph"><p>and &lt;conflict-message&gt; is a more detailed message about the conflict which often
 (but not always) embeds the &lt;stable-short-type-description&gt; within it. These
 strings may change in future Git versions. Some examples:</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
 "Auto-merging &lt;file&gt;"
 </p>
 </li>
 <li>
 <p>
 "CONFLICT (rename/delete): &lt;oldfile&gt; renamed&#8230;but deleted in&#8230;"
 </p>
 </li>
 <li>
 <p>
 "Failed to merge submodule &lt;submodule&gt; (no merge base)"
 </p>
 </li>
 <li>
 <p>
 "Warning: cannot merge binary files: &lt;filename&gt;"
 </p>
 </li>
 </ul></div>
 <div class="paragraph"><p>If <code>-z</code> is NOT passed:</p></div>
 <div class="paragraph"><p>This section starts with a blank line to separate it from the previous
 sections, and then only contains the &lt;conflict-message&gt; information
 from the previous section (separated by newlines). These are
 non-stable strings that should not be parsed by scripts, and are just
 meant for human consumption. Also, note that while &lt;conflict-message&gt;
 strings usually do not contain embedded newlines, they sometimes do.
 (However, the free-form messages will never have an embedded NUL
 character). So, the entire block of information is meant for human
 readers as an agglomeration of all conflict messages.</p></div>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_exit_status">EXIT STATUS</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>For a successful, non-conflicted merge, the exit status is 0. When the
 merge has conflicts, the exit status is 1. If the merge is not able to
 complete (or start) due to some kind of error, the exit status is
 something other than 0 or 1 (and the output is unspecified). When
 --stdin is passed, the return status is 0 for both successful and
 conflicted merges, and something other than 0 or 1 if it cannot complete
 all the requested merges.</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_usage_notes">USAGE NOTES</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>This command is intended as low-level plumbing, similar to
 <a href="git-hash-object.html">git-hash-object(1)</a>, <a href="git-mktree.html">git-mktree(1)</a>,
 <a href="git-commit-tree.html">git-commit-tree(1)</a>, <a href="git-write-tree.html">git-write-tree(1)</a>,
 <a href="git-update-ref.html">git-update-ref(1)</a>, and <a href="git-mktag.html">git-mktag(1)</a>. Thus, it can be
 used as a part of a series of steps such as:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>NEWTREE=$(git merge-tree --write-tree $BRANCH1 $BRANCH2)
 test $? -eq 0 || die "There were conflicts..."
 NEWCOMMIT=$(git commit-tree $NEWTREE -p $BRANCH1 -p $BRANCH2)
 git update-ref $BRANCH1 $NEWCOMMIT</code></pre>
 </div></div>
 <div class="paragraph"><p>Note that when the exit status is non-zero, <code>NEWTREE</code> in this sequence
 will contain a lot more output than just a tree.</p></div>
 <div class="paragraph"><p>For conflicts, the output includes the same information that you&#8217;d get
 with <a href="git-merge.html">git-merge(1)</a>:</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
 what would be written to the working tree (the
  <a href="#OIDTLT">OID of toplevel tree</a>)
 </p>
 </li>
 <li>
 <p>
 the higher order stages that would be written to the index (the
  <a href="#CFI">Conflicted file info</a>)
 </p>
 </li>
 <li>
 <p>
 any messages that would have been printed to stdout (the
  <a href="#IM">Informational messages</a>)
 </p>
 </li>
 </ul></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_input_format">INPUT FORMAT</h2>
 <div class="sectionbody">
 <div class="paragraph"><p><em>git merge-tree --stdin</em> input format is fully text based. Each line
 has this format:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>[&lt;base-commit&gt; -- ]&lt;branch1&gt; &lt;branch2&gt;</code></pre>
 </div></div>
 <div class="paragraph"><p>If one line is separated by <code>--</code>, the string before the separator is
 used for specifying a merge-base for the merge and the string after
 the separator describes the branches to be merged.</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_mistakes_to_avoid">MISTAKES TO AVOID</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Do NOT look through the resulting toplevel tree to try to find which
 files conflict; parse the <a href="#CFI">Conflicted file info</a> section instead.
 Not only would parsing an entire tree be horrendously slow in large
 repositories, there are numerous types of conflicts not representable by
 conflict markers (modify/delete, mode conflict, binary file changed on
 both sides, file/directory conflicts, various rename conflict
 permutations, etc.)</p></div>
 <div class="paragraph"><p>Do NOT interpret an empty <a href="#CFI">Conflicted file info</a> list as a clean
 merge; check the exit status. A merge can have conflicts without having
 individual files conflict (there are a few types of directory rename
 conflicts that fall into this category, and others might also be added
 in the future).</p></div>
 <div class="paragraph"><p>Do NOT attempt to guess or make the user guess the conflict types from
 the <a href="#CFI">Conflicted file info</a> list. The information there is
 insufficient to do so. For example: Rename/rename(1to2) conflicts (both
 sides renamed the same file differently) will result in three different
 file having higher order stages (but each only has one higher order
 stage), with no way (short of the <a href="#IM">Informational messages</a> section)
 to determine which three files are related. File/directory conflicts
 also result in a file with exactly one higher order stage.
 Possibly-involved-in-directory-rename conflicts (when
 "merge.directoryRenames" is unset or set to "conflicts") also result in
 a file with exactly one higher order stage. In all cases, the
 <a href="#IM">Informational messages</a> section has the necessary info, though it
 is not designed to be machine parseable.</p></div>
 <div class="paragraph"><p>Do NOT assume that each paths from <a href="#CFI">Conflicted file info</a>, and
 the logical conflicts in the <a href="#IM">Informational messages</a> have a
 one-to-one mapping, nor that there is a one-to-many mapping, nor a
 many-to-one mapping. Many-to-many mappings exist, meaning that each
 path can have many logical conflict types in a single merge, and each
 logical conflict type can affect many paths.</p></div>
 <div class="paragraph"><p>Do NOT assume all filenames listed in the <a href="#IM">Informational messages</a>
 section had conflicts. Messages can be included for files that have no
 conflicts, such as "Auto-merging &lt;file&gt;".</p></div>
 <div class="paragraph"><p>AVOID taking the OIDS from the <a href="#CFI">Conflicted file info</a> and
 re-merging them to present the conflicts to the user. This will lose
 information. Instead, look up the version of the file found within the
 <a href="#OIDTLT">OID of toplevel tree</a> and show that instead. In particular,
 the latter will have conflict markers annotated with the original
 branch/commit being merged and, if renames were involved, the original
 filename. While you could include the original branch/commit in the
 conflict marker annotations when re-merging, the original filename is
 not available from the <a href="#CFI">Conflicted file info</a> and thus you would
 be losing information that might help the user resolve the conflict.</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="DEPMERGE">DEPRECATED DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Per the <a href="#NEWMERGE">DESCRIPTION</a> and unlike the rest of this
 documentation, this section describes the deprecated <code>--trivial-merge</code>
 mode.</p></div>
 <div class="paragraph"><p>Other than the optional <code>--trivial-merge</code>, this mode accepts no
 options.</p></div>
 <div class="paragraph"><p>This mode reads three tree-ish, and outputs trivial merge results and
 conflicting stages to the standard output in a semi-diff format.
 Since this was designed for higher level scripts to consume and merge
 the results back into the index, it omits entries that match
 &lt;branch1&gt;. The result of this second form is similar to what
 three-way <em>git read-tree -m</em> does, but instead of storing the results
 in the index, the command outputs the entries to the standard output.</p></div>
 <div class="paragraph"><p>This form not only has limited applicability (a trivial merge cannot
 handle content merges of individual files, rename detection, proper
 directory/file conflict handling, etc.), the output format is also
 difficult to work with, and it will generally be less performant than
 the first form even on successful merges (especially if working in
 large repositories).</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_git">GIT</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
 </div>
 </div>
 </div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
 Last updated
  2023-03-19 15:16:41 PDT
 </div>
 </div>
 </body>
 </html>