Select a fixed width font. (On some systems this dialog will also
present variable width fonts, but you should not use them.)
</p><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Italic Font for Deltas:</em></span></span></dt><dd><p> If you select this, then text differences
will be drawn with the italic version of the selected font. If the font
doesn't support italic, then this does nothing.</p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="id2566353"></a>Colors</h3></div></div></div><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Foreground color:</em></span></span></dt><dd><p> Usually black. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Background color:</em></span></span></dt><dd><p> Usually white. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Diff Background color:</em></span></span></dt><dd><p> Usually light gray. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Color A:</em></span></span></dt><dd><p> Usually dark blue. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Color B:</em></span></span></dt><dd><p> Usually dark green. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Color C:</em></span></span></dt><dd><p> Usually dark magenta. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Conflict Color:</em></span></span></dt><dd><p> Usually red.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Current range background color:</em></span></span></dt><dd><p> Usually light yellow.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Current range diff background color:</em></span></span></dt><dd><p> Usually dark yellow.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Color for manually selected diff ranges:</em></span></span></dt><dd><p> Usually orange.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Newest file color in directory comparison:</em></span></span></dt><dd><p> Usually green.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Oldest file color in directory comparison:</em></span></span></dt><dd><p> Usually red.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Middle age file color in directory comparison:</em></span></span></dt><dd><p> Usually dark yellow.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Color for missing files in directory comparison:</em></span></span></dt><dd><p> Usually black.</p></dd></dl></div><p>
Changing the colors for directory comparison will be effective only when starting the next directory comparison.
</p><p>
On systems with only 16 or 256 colors some colors are not available in pure
form. On such systems the "Defaults"-button will choose a pure color.
</p></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="id2566534"></a>Editor Settings</h3></div></div></div><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Tab inserts spaces:</em></span></span></dt><dd><p> If this is disabled and you press the
tabulator key, a tab-character is inserted, otherwise the appropriate
amount of characters is inserted.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em> Tab size:</em></span></span></dt><dd><p> Can be adjusted for your specific needs. Default is 8. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em> Auto indentation:</em></span></span></dt><dd><p> When pressing Enter or Return the indentation
of the previous line is used for the new line. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em> Auto copy selection:</em></span></span></dt><dd><p> Every selection is immediately copied
to the clipboard when active and you needn't explicitely copy it. </p></dd><dt><spanclass="term"><spanclass="emphasis"><em> Line end style:</em></span></span></dt><dd><p> When saving you can select what line
end style you prefer. The default setting is the common choice for the used operating system. </p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="diffoptions"></a>Diff Settings</h3></div></div></div><p>
When comparing files, <spanclass="application">KDiff3</span> first it tries to match lines that are equal
in all input files. Only during this step it might ignore white space. The
second step compares each line. In this step white space will not be ignored.
Also during the merge white space will not be ignored.
</p><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Preserve Carriage Return:</em></span></span></dt><dd><p> Some editors (on some systems) save
carriage return '\r' and linefeed '\n'-characters at the end of line, while
others will only save the linefeed '\n'. Usually <spanclass="application">KDiff3</span> ignores the carriage
return, but then files that don't have equal sizes, look equal in side by
side comparison. When this option is on, then the carriage return characters
are made visible but are treated as white space. This option must be off
during a merge. Default is off.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Ignore numbers:</em></span></span></dt><dd><p> Default is off. Number characters ('0'-'9', '.', '-')
will be ignored in the first part of the analysis in which the line matching is
done. In the result the differences will be shown nevertheless, but they are treated
as white space.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Ignore C/C++ comments:</em></span></span></dt><dd><p> Default is off.
Changes in comments will be treated like changes in white space.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Ignore case:</em></span></span></dt><dd><p> Default is off.
Case-differences of characters (like 'A' vs. 'a') will be treated like changes in white space.
Try hard to find an even smaller delta. (Default is on.) This will probably
be effective for complicated and big files. And slow for very big files.
</p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="mergeoptions"></a>Merge Settings</h3></div></div></div><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Auto Advance Delay (ms):</em></span></span></dt><dd><p> When in auto-advance-mode this setting specifies
how long to show the result of the selection before jumping to the next unsolved
conflict.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>White space 2/3-file merge default:</em></span></span></dt><dd><p>
Automatically solve all white-space conflict by choosing the specified file.
(Default is manual choice.) Useful if white space really isn't important in many files.
If you need this only occasionally better use "Choose A/B/C For All Unsolved Whitespace Conflicts"
in the merge menu. Note that if you enable either "Ignore numbers" or "Ignore C/C++ comments"
then this auto-choice also applies for conflicts in numbers or comments.
Regular expression for lines where <spanclass="application">KDiff3</span> should automatically choose one source. See also <ahref="merging.html#vcskeywordsmergesupport"title="Automatic Merge of Version Control Keywords and History (Log)">Automatic Merge ...</a>
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Run regular expression auto merge on merge start:</em></span></span></dt><dd><p>
If activated <spanclass="application">KDiff3</span> runs the automatic merge using the "Auto merge regular expression" when a merge is started.
These options are concerned with scanning the directory and handling the
merge: See the <ahref="dirmergeoptions.html"title="Options for Comparing and Merging Directories">Directory Comparison/Merge
Docs</a> for details.
</p><p>
Yet there is one option here that is also relevant for saving single files:
</p><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Backup files:</em></span></span></dt><dd><p> When a file is saved and an older version already
exists, then the original version will be renamed with an ".orig" extension.
If an old backup file with ".orig" extension already exists then this will
be deleted without backup.
</p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="id2567038"></a>Regional and Language Options</h3></div></div></div><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Language:</em></span></span></dt><dd><p>Adjust the language of the user interface. Changing this option doesn't affect the running program. You have to exit and restart <spanclass="application">KDiff3</span> so that the language is changed. (This option is not available in the KDE version of <spanclass="application">KDiff3</span> because the language is adjustable in the global KDE settings.)
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Use the same encoding for everything:</em></span></span></dt><dd><p> The following encoding options can be adjusted separately for each item or if this option is true, all values will take the first value.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Local Encoding:</em></span></span></dt><dd><p>Above the codec-selectors appears a note that tells you what the local encoding is. (This is not adjustable but for your information just in case you don't know your local encoding, but need to select it.)
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>File Encoding for A/B/C:</em></span></span></dt><dd><p> Adjust the file encoding for input files. This has an effect on how the special characters are interpreted. Since you can adjust each codec separately you can even compare and merge files that were saved using different codecs.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>File Encoding for Merge Output and Saving:</em></span></span></dt><dd><p> When you have edited a file, then you can adjust which encoding will be used when saving to disk.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>File Encoding for Preprocessor Files:</em></span></span></dt><dd><p>When you define preprocessors then they might not be able to operate on your codec. (e.g.: Your files are 16-bit-unicode and your preprocessor can only take 8-bit-ascii.) With this option you can define the encoding of preprocessor output.
</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Right To Left Language:</em></span></span></dt><dd><p>Some languages are written right to left. When this option is enabled, <spanclass="application">KDiff3</span> draws the text from right to left in the diff input windows and in the merge output window. Note that if you start <spanclass="application">KDiff3</span> with the command line option "--reverse" then all layouting will be done right to left too. (This is a feature provided by TQt.) This documentation was written assuming that "Right To Left Language" or reverse layout are disabled. So some references to "left" or "right" must be replaced by their respective counterpart if you use these options.
</p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="id2567171"></a>Miscellaneous</h3></div></div></div><p>(These options and actions are available in menus or the buttonbar.)</p><divclass="variablelist"><dl><dt><spanclass="term"><spanclass="emphasis"><em>Show line numbers:</em></span></span></dt><dd><p> You can select if line numbers should be
shown for the input files.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Show space and tabulator characters for differences:</em></span></span></dt><dd><p> Sometimes
the visible spaces and tabs are disturbing. You can turn this off.</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Show white space:</em></span></span></dt><dd><p> Turn this off to suppress
any highlighting of white-space-only changes in the text or overview-columns.
(Note that this also applies to changes in numbers or comments if the options "Ignore numbers"
or "Ignore C/C++ comments" are active.)</p></dd><dt><spanclass="term"><spanclass="emphasis"><em>Overview options:</em></span></span></dt><dd><p>
These choices are only available when you compare three files. In normal mode all
differences are shown in one color-coded overview-column. But sometimes you are
especially interested in the differences between only two of these three files.
Selecting "A vs. B", "A vs. C" or "B vs. C"-overview will show a second overview
column with the required information next to the normal overview.
"Merge current file" in the Directory-menu also works if you only compare
two files. A single click starts the merge and uses the filename of the last
input-file as the default output filename. (When this is used to restart
a merge, then the output filename will be preserved.)</p></dd></dl></div></div><divclass="sect2"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="shortcuts"></a>Configuring Keyboard-Shortcuts</h3></div></div></div><p>
Currently only the KDE-version supports user-configurable keyboard-shortcuts.
(Menu Settings->Configure Shortcuts...)
</p></div></div><divstyle="background-color: #white; color: black; margin-top: 20px; margin-left: 20px; margin-right: 20px;"><divstyle="position: absolute; left: 20px;"><aaccesskey="p"href="printing.html">Prev</a></div><divstyle="position: absolute; right: 20px;"><aaccesskey="n"href="preprocessors.html">Next</a></div><divalign="center"><aaccesskey="h"href="index.html">Home</a></div></div><divstyle="background-color: #white; color: black; margin-left: 20px; margin-right: 20px;"><divclass="navLeft">Printing</div><divclass="navRight">Preprocessor Commands</div><divclass="navCenter"><aaccesskey="u"href="documentation.html">Up</a></div></div><br><br><divclass="bannerBottom"style="background-image: url(help:/common/bottom-middle.png); background-repeat: x-repeat; width: 100%; height: 100px; bottom:0px;"><divclass="BannerBottomRight"><imgsrc="help:/common/bottom-right.png"style="margin: 0px"alt=""></div><divclass="bannerBottomLeft"><imgsrc="help:/common/bottom-left.png"style="margin: 0px;"alt=""></div><divid="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 <ahref="mailto:kde-docs@kdemail.net"style="background:transparent; color:#cfe1f6; text-decoration: underline;">KDE Docs Team</a></p></div></div></body></html>
