Updated TortoiseMerge docs from TortoiseSVN source
[TortoiseGit.git] / doc / source / en / TortoiseMerge / tme_dug_open.xml
blob62dfcbd80f56637ca0a4778f523033432ac7767d
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE chapter SYSTEM "../../dtd/dblite.dtd">\r
3 <sect1 id="tmerge-dug-open">\r
4     <title>Open Files</title>\r
5     <?dbhh topicname="HIDD_OPENDLG"?>\r
6     <para>\r
7         When you start TortoiseGitMerge without any command line switches then\r
8         you have to open the files manually, using\r
9         <menuchoice>\r
10             <guimenu>File</guimenu>\r
11             <guimenuitem>Open</guimenuitem>\r
12         </menuchoice>.\r
13     </para>\r
14     <figure id="tmerge-dug-dia-open">\r
15         <title>The Open Dialog</title>\r
16         <graphic fileref="images/TMerge_Open.png"/>\r
17     </figure>\r
18     <para>\r
19         The first thing you have to do is to decide whether you just want\r
20         to compare/merge files, or whether you want to apply a patch file.\r
21         Depending on what you choose, the corresponding edit boxes and\r
22         browse buttons are activated.\r
23     </para>\r
24     <sect2 id="tmerge-dug-open-view">\r
25         <title>Viewing / Merging</title>\r
26         <para>\r
27             If you want to compare / merge files you have to set at least two\r
28             of the three possible paths for <literal>Base</literal>,\r
29             <literal>Mine</literal> and <literal>Theirs</literal>.\r
30             If you select only two files, then TortoiseGitMerge will show\r
31             you the differences between those two files, either in a two\r
32             pane view or in a one pane view.\r
33         </para>\r
34         <para>\r
35             If you want to merge three files, TortoiseGitMerge\r
36             will show you the differences in a three pane view. This view\r
37             is generally used if you need to resolve conflicted files.\r
38             The output file is not named in this case and you will have to\r
39             use the\r
40             <menuchoice>\r
41                 <guimenu>File</guimenu>\r
42                 <guimenuitem>Save As...</guimenuitem>\r
43             </menuchoice>.\r
44             to save the results.\r
45         </para>\r
46     </sect2>\r
47     <sect2 id="tmerge-dug-open-patch">\r
48         <title>Applying Patches</title>\r
49         <para>\r
50             If you want to apply a patch file you have to set both the path\r
51             to the patch file itself and the path to the folder where the\r
52             patch file should be applied.\r
53         </para>\r
54         <caution>\r
55             <para>\r
56                 Currently, only patch files in\r
57                 <emphasis>Unified Diff Format</emphasis> are supported.\r
58                 And only files which were generated from a Subversion\r
59                 working copy. Other formats like patch files generated by\r
60                 CVS are currently not supported!\r
61             </para>\r
62         </caution>\r
63     </sect2>\r
64 </sect1>\r