<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter SYSTEM "../../dtd/dblite.dtd">
<sect1 id="tmerge-dug-settings">
	<title>Settings</title>
	<sect2 id="tmerge-dug-settings-main">
		<title>Main Settings Page</title>
		<?dbhh topicname="HIDD_SETMAINPAGE"?>
		<figure id="tmerge-dug-dia-setmain">
			<title>The Settings Main Page</title>
			<graphic fileref="images/TMerge_SettingsGeneral.png"/>
		</figure>
		<para>
			Most of the options here are self-explanatory, but a few
			points need clarifying.
		</para>
		<para>
			<guilabel>Backup original file</guilabel>
			renames the original file in the WC to <literal>filename.bak</literal>
			before saving the modified version.
		</para>
		<para>
			<guilabel>Default to UTF-8 encoding</guilabel>
			when set, ANSI files are loaded as UTF-8 encoded and saved as
			such when edited.
		</para>
		<para>
			<guilabel>Use ribbons</guilabel>
			when set, ribbons interface is used (looks like Office 2007).
			When unset, traditional toolbar interface is used.
			Default is set.
		</para>
		<para>
			<guilabel>Use spaces</guilabel>
			when set, pressing tab key inserts spaces.
			Default is unset (tab char is used).
		</para>
		<para>
			<guilabel>Smart tab char</guilabel>
			when set, pressing tab key inserts tab/spaces based on adjacent lines/characters.
			Default is unset.
		</para>
		<para>
			<guilabel>EditorConfig</guilabel>
			when set, it will detect <filename>.editorconfig</filename> files.
			Currently, it supports indent_style(space/tab) and indent_size properties.
			See <ulink url="https://editorconfig.org/"><citetitle>EditorConfig</citetitle></ulink> website for more details.
		</para>
		<para>
			<guilabel>Max line length for inline diffs</guilabel>
			TortoiseGitMerge can get slow when showing inline diffs for
			very long lines. Because of that only lines that are shorter
			than 3000 chars are shown with inline diffs. You can change
			this value here.
		</para>
		<para>
			<guilabel>Ignore line endings</guilabel>
			hides changes which are due solely to difference in line-end style.
		</para>
		<para>
			<guilabel>Ignore case changes</guilabel>
			hides changes which are due solely to case changes within the text.
			This can be useful with apps such as Visual Basic, which changes
			case in variables without warning.
		</para>
		<para>
			<guilabel>Context lines for patches</guilabel>
			specifies how many context lines for patch files generated from TortoiseGitMerge.
			The default value is -1, which means context lines number is controlled
			by git or <literal>diff.context</literal> config.
		</para>
	</sect2>
	<sect2 id="tmerge-dug-settings-color">
		<title>color Settings Page</title>
		<?dbhh topicname="HIDD_SETCOLORPAGE"?>
		<figure id="tmerge-dug-dia-setcolor">
			<title>The Settings Color Page</title>
			<graphic fileref="images/TMerge_SettingsColors.png"/>
		</figure>
		<para>
			This dialog allows you to select the background color coding
			used to highlight the different line changes.
		</para>
		<variablelist>
			<varlistentry>
				<term>Normal</term>
				<listitem>
					All lines which are unchanged, or where changes are hidden.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Added</term>
				<listitem>
					Lines which have been added.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Removed</term>
				<listitem>
					Lines which have been deleted.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Modified</term>
				<listitem>
					Lines which have relatively small changes, and are shown using inline diff.
					This color is used for the <emphasis>unchanged</emphasis> portion of
					the line content. Changed portions will be shown using the inline
					added and deleted colors described below.
					If <guilabel>color code in-line changes</guilabel> is not enabled,
					this color will not be used and changed lines will always be shown
					as replacements.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Conflicted</term>
				<listitem>
					Where the same line has been changed in both files.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Conflict resolved</term>
				<listitem>
					Where the same line has been changed in both files,
					and you have now selected which version should be used.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Empty</term>
				<listitem>
					Where lines have been added in the opposite pane,
					and no such line existed in this pane.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Inline added text</term>
				<listitem>
					When inline diffs are shown, added text is shown in this color.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Inline removed text</term>
				<listitem>
					When inline diffs are shown, deleted text is shown in this color.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Misc whitespaces</term>
				<listitem>
					Characters used to indicate Whitespace are shown in a different color
					from normal text.
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Use dark mode</term>
				<listitem>
					Enables a dark mode for the UI. This requires at least Windows 10 1809.
					This feature also requires that dark mode for applications is enabled in the Windows 10 settings.
				</listitem>
			</varlistentry>
		</variablelist>
	</sect2>
</sect1>
