1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-merge-file(
1)
</title>
312 git-merge-file(
1) Manual Page
315 <div class=
"sectionbody">
317 Run a three-way file merge
322 <div class=
"sectionbody">
323 <div class=
"verseblock">
324 <div class=
"content"><em>git merge-file
</em> [-L
<current-name
> [-L
<base-name
> [-L
<other-name
>]]]
325 [--ours|--theirs|--union] [-p|--stdout] [-q|--quiet] [--marker-size=
<n
>]
326 <current-file
> <base-file
> <other-file
></div></div>
328 <h2 id=
"_description">DESCRIPTION
</h2>
329 <div class=
"sectionbody">
330 <div class=
"para"><p><em>git merge-file
</em> incorporates all changes that lead from the
<tt><base-file
></tt>
331 to
<tt><other-file
></tt> into
<tt><current-file
></tt>. The result ordinarily goes into
332 <tt><current-file
></tt>.
<em>git merge-file
</em> is useful for combining separate changes
333 to an original. Suppose
<tt><base-file
></tt> is the original, and both
334 <tt><current-file
></tt> and
<tt><other-file
></tt> are modifications of
<tt><base-file
></tt>,
335 then
<em>git merge-file
</em> combines both changes.
</p></div>
336 <div class=
"para"><p>A conflict occurs if both
<tt><current-file
></tt> and
<tt><other-file
></tt> have changes
337 in a common segment of lines. If a conflict is found,
<em>git merge-file
</em>
338 normally outputs a warning and brackets the conflict with lines containing
339 <<<<<<< and
>>>>>>> markers. A typical conflict will look like this:
</p></div>
340 <div class=
"literalblock">
341 <div class=
"content">
342 <pre><tt><<<<<<< A
346 >>>>>>> B
</tt></pre>
348 <div class=
"para"><p>If there are conflicts, the user should edit the result and delete one of
349 the alternatives. When
<tt>--ours
</tt>,
<tt>--theirs
</tt>, or
<tt>--union
</tt> option is in effect,
350 however, these conflicts are resolved favouring lines from
<tt><current-file
></tt>,
351 lines from
<tt><other-file
></tt>, or lines from both respectively. The length of the
352 conflict markers can be given with the
<tt>--marker-size
</tt> option.
</p></div>
353 <div class=
"para"><p>The exit value of this program is negative on error, and the number of
354 conflicts otherwise. If the merge was clean, the exit value is
0.
</p></div>
355 <div class=
"para"><p><em>git merge-file
</em> is designed to be a minimal clone of RCS
<em>merge
</em>; that is, it
356 implements all of RCS
<em>merge
</em>'s functionality which is needed by
357 <a href=
"git.html">git(
1)
</a>.
</p></div>
359 <h2 id=
"_options">OPTIONS
</h2>
360 <div class=
"sectionbody">
361 <div class=
"vlist"><dl>
367 This option may be given up to three times, and
368 specifies labels to be used in place of the
369 corresponding file names in conflict reports. That is,
370 <tt>git merge-file -L x -L y -L z a b c
</tt> generates output that
371 looks like it came from files x, y and z instead of
372 from files a, b and c.
380 Send results to standard output instead of overwriting
381 <tt><current-file
></tt>.
389 Quiet; do not warn about conflicts.
403 Instead of leaving conflicts in the file, resolve conflicts
404 favouring our (or their or both) side of the lines.
409 <h2 id=
"_examples">EXAMPLES
</h2>
410 <div class=
"sectionbody">
411 <div class=
"vlist"><dl>
413 git merge-file README.my README README.upstream
417 combines the changes of README.my and README.upstream since README,
418 tries to merge them and writes the result into README.my.
422 git merge-file -L a -L b -L c tmp/a123 tmp/b234 tmp/c345
426 merges tmp/a123 and tmp/c345 with the base tmp/b234, but uses labels
427 <tt>a
</tt> and
<tt>c
</tt> instead of
<tt>tmp/a123
</tt> and
<tt>tmp/c345
</tt>.
432 <h2 id=
"_author">Author
</h2>
433 <div class=
"sectionbody">
434 <div class=
"para"><p>Written by Johannes Schindelin
<johannes.schindelin@gmx.de
></p></div>
436 <h2 id=
"_documentation">Documentation
</h2>
437 <div class=
"sectionbody">
438 <div class=
"para"><p>Documentation by Johannes Schindelin and the git-list
<git@vger.kernel.org
>,
439 with parts copied from the original documentation of RCS
<em>merge
</em>.
</p></div>
441 <h2 id=
"_git">GIT
</h2>
442 <div class=
"sectionbody">
443 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
446 <div id=
"footer-text">
447 Last updated
2010-
03-
20 20:
59:
12 UTC