summaryrefslogtreecommitdiffstats
path: root/doc/en/interpretinginformation.html
blob: 3cf531ee147a6dad458fe93605d3d82e57eef278 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
<html><head><title>Comparing Files And Interpreting The Information In The Input Windows</title><link rel="stylesheet" href="help:/common/tde-default.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.67.2"><meta name="keywords" content="KDE, kdeextragear, kdiff3, diff, merge, CVS, triplediff, compare, files, directories, version control, three-way-merge, in-line-differences, synchronise, kpart, tdeio, networktransparent, editor, white space, comments"><link rel="start" href="index.html" title="The KDiff3 Handbook"><link rel="up" href="documentation.html" title="Chapter 2. File Comparison And Merge"><link rel="prev" href="pasteinput.html" title="Paste and Drop Input"><link rel="next" href="merging.html" title="Merging And The Merge Output Editor Window"><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta name="GENERATOR" content="KDE XSL Stylesheet V1.13 using libxslt"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div style="background-image: url(help:/common/top-middle.png); width: 100%; height: 131px;"><div style="position: absolute;                      right: 0px;"><img src="help:/common/top-right-konqueror.png" style="margin: 0px" alt=""></div><div style="position: absolute;                         top: 25px;                          right: 100px;                          text-align: right;                          font-size: xx-large;                          font-weight: bold;                          text-shadow: #fff 0px 0px 5px;                          color: #444">Comparing Files And Interpreting The Information In The Input Windows</div></div><div style="margin-top: 20px; background-color: #white;                        color: black;                       margin-left: 20px;                        margin-right: 20px;"><div style="position: absolute;                          left: 20px;"><a accesskey="p" href="pasteinput.html">Prev</a></div><div style="position: absolute;                          right: 20px;"><a accesskey="n" href="merging.html">Next</a></div><div class="navCenter">File Comparison And Merge</div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="interpretinginformation"></a>Comparing Files And Interpreting The Information In The Input Windows</h2></div></div></div><div class="screenshot"><div xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="mediaobject"><hr><img src="screenshot_diff.png"><hr></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564410"></a>Info Line</h3></div></div></div><p>
   At the top of each text window is its "info line". The info lines of
   the input windows contain a letter "A", "B" or "C", the editable filename,
   a button for browsing, and the line number of the first visible line in the window. 
   (Note that window "C" is  optional.) Each info line appears in a different color.
</p><p>
   When you selected another file via browsing or finished editing the filename here 
   by pressing enter, the new file will be loaded and 
   compared with the already loaded file(s).
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564428"></a>Coloring</h3></div></div></div><p>
   The three input windows are assigned the letters "A", "B" and "C".
   "A"   has  color blue, "B" has green and "C" has magenta. (These are the
   defaults,   but  can be changed in the Settings-Menu.)
</p><p>
   When a difference is detected then the color shows which input file
   differs.   When both other input files differ then the color used to express
   this is   red by default ("Conflict color" in the Settings).
   This colorscheme is especially useful in the case of three input files, which will be
   seen in the next section (<a href="merging.html" title="Merging And The Merge Output Editor Window">Merging</a>).
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564454"></a>Summary Column</h3></div></div></div><p>
   Left of each text is the "summary column". If differences occurred on a
   line then the summary column shows the respective color. For a white-space-only
   difference the summary is chequered. For programming languages where white
   space is not so important this is useful to see at one glance if anything
   of importance was modified. (In C/C++ white space is only interesting within
   strings, comments, for the preprocessor, and some only very esoteric situations.)
</p><p>
   The vertical line separating the summary column and the text is interrupted
   if the input file had no lines there. When word-wrap is enabled then this vertical 
   line appears dotted for wrapped lines.
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564475"></a>Overview Column</h3></div></div></div><p>
   On the right side a "overview"-column is visible left of the vertical scrollbar.
   It shows the compressed summary column of input "A". All the differences
   and conflicts are visible at one glance. When only two input windows are
   used, then all differences appear red here because every difference is
   also   a conflict. A black rectangle frames the visible part of the inputs.
   For  very long input files, when the number of input lines is bigger than
   the height of the overview column in pixels, then several input lines share
   one overview line. A conflict then has top priority over simple differences,
   which have priority over no change, so that no difference or conflict is
   lost here.  By clicking into this overview column the corresponding text
   will be shown.
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="manualdiffhelp"></a>Manually Aligning Lines</h3></div></div></div><p>
   Sometimes the algorithm places the wrong lines next to each other. Or you want to compare 
   one piece of text with text at a completely different position in the other file.
   For these situations you can manually instruct <span class="application">KDiff3</span> to align certain lines. 
   Mark the text for which you want to improve the alignment with the mouse as you would 
   for copy and paste in the first diff view and then choose "Add Manual Diff Alignment" 
   in the "Diffview"-menu (keyboard shortcut "Ctrl-Y") . An orange bar will appear in 
   the summary column next to the chosen text. Repeat this for the second and 
   (if available) third diff view. <span class="application">KDiff3</span> will immediately recalculate the differences everytime you do this.
   and will align the chosen lines. Of course some of the previously matching lines in between 
   might not match anymore.
</p><p>
   Currently merging doesn't support the use of manual diff help.
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="joinsplitsections"></a>Manually Joining and Splitting Diff Sections</h3></div></div></div><p>
   In some cases <span class="application">KDiff3</span> will see too many or too few diff sections for merging. In such a 
   case you can join or split existing sections.
</p><p>
   Add new sections by first selecting text in the lines that belong together in either input window (as for copying to the clipboard). 
   Then choose "Split Diff At Selection" in the "Merge" menu.
   Splits will be added above the first line and below the last line of the selected text.
   If you only want to add one section, then select text beginning at another section-split.
</p><p>
   For joining sections in either input window select something in the lines from the sections to join.
   (You can join several sections in one step too.) Then choose "Join selected Diffs" in the "Merge"-menu.
</p></div></div><div style="background-color: #white; color: black;                  margin-top: 20px; margin-left: 20px;                  margin-right: 20px;"><div style="position: absolute; left: 20px;"><a accesskey="p" href="pasteinput.html">Prev</a></div><div style="position: absolute; right: 20px;"><a accesskey="n" href="merging.html">Next</a></div><div align="center"><a accesskey="h" href="index.html">Home</a></div></div><div style="background-color: #white;   color: black;         margin-left: 20px;   margin-right: 20px;"><div class="navLeft">Paste and Drop Input </div><div class="navRight"> Merging And The Merge Output Editor Window</div><div class="navCenter"><a accesskey="u" href="documentation.html">Up</a></div></div><br><br><div class="bannerBottom" style="background-image: url(help:/common/bottom-middle.png);                                        background-repeat: x-repeat;                                         width: 100%;                                         height: 100px;                                         bottom:0px;"><div class="BannerBottomRight"><img src="help:/common/bottom-right.png" style="margin: 0px" alt=""></div><div class="bannerBottomLeft"><img src="help:/common/bottom-left.png" style="margin: 0px;" alt=""></div><div id="comments" style="position:relative; top: 5px; left: 1em; height:85px; width: 50%; color: #cfe1f6"><p>Would you like to make a comment or contribute an update to this page?<br>
        Send feedback to the <a href="mailto:kde-docs@kdemail.net" style="background:transparent; color:#cfe1f6; text-decoration: underline;">KDE Docs Team</a></p></div></div></body></html>