Fixed issue #1467: put remote branches at the bottom in "branches" dropdowns
[TortoiseGit.git] / doc / source / en / TortoiseGit / tsvn_dug / dug_settings_advanced.xml
blob0c5cc7c537fbc1e70c9baee22258fffc2cc9cd31
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect2 SYSTEM "../../../dtd/dblite.dtd">\r
3 <sect2 id="tsvn-dug-settings-registry">\r
4     <?dbhh topicname="HIDD_SETTINGS_CONFIG"?>\r
5     <title>Advanced Settings</title>\r
6     <indexterm>\r
7         <primary>registry</primary>\r
8     </indexterm>\r
9     <para>\r
10         A few infrequently used settings are available only in the advanced\r
11         page of the settings dialog. These settings modify the registry directly\r
12         and you have to know what each of these settings is used for and what\r
13         it does. Do not modify these settings unless you are sure you need to\r
14         change them.\r
15     </para>\r
16     <variablelist>\r
17         <varlistentry>\r
18             <term condition="pot">AutocompleteRemovesExtensions</term>\r
19             <listitem>\r
20                 <para>\r
21                     The auto-completion list shown in the commit message editor\r
22                     displays the names of files listed for commit.\r
23                     To also include these names with extensions removed,\r
24                     set this value to <literal>true</literal>.\r
25                 </para>\r
26             </listitem>\r
27         </varlistentry>\r
28         <varlistentry>\r
29             <term condition="pot">BlockStatus</term>\r
30             <listitem>\r
31                 <para>\r
32                     If you don't want the explorer to update the status overlays\r
33                     while another TortoiseGit command is running\r
34                     (e.g. Update, Commit, ...) then set this value to\r
35                     <literal>true</literal>.\r
36                 </para>\r
37             </listitem>\r
38         </varlistentry>\r
39         <varlistentry>\r
40             <term condition="pot">CacheTrayIcon</term>\r
41             <listitem>\r
42                 <para>\r
43                     To add a cache tray icon for the TGitCache program, set\r
44                     this value to <literal>true</literal>.\r
45                     This is really only useful for developers as it allows\r
46                     you to terminate the program gracefully.\r
47                 </para>\r
48             </listitem>\r
49         </varlistentry>\r
50         <varlistentry>\r
51             <term condition="pot">ColumnsEveryWhere</term>\r
52             <listitem>\r
53                 <para>\r
54                     The extra columns the TortoiseGit adds to the details view\r
55                     in Windows Explorer are normally only active in a working\r
56                     copy. If you want those to be accessible everywhere, not\r
57                     just in working trees, set this value to\r
58                     <literal>true</literal>.\r
59                     Note that the extra columns are only available in XP.\r
60                     Vista and later doesn't support that feature any more.\r
61                 </para>\r
62             </listitem>\r
63         </varlistentry>\r
64         <varlistentry>\r
65             <term condition="pot">Debug</term>\r
66             <listitem>\r
67                 <para>\r
68                     Set this to <literal>true</literal> if you want a dialog to\r
69                     pop up for every command showing the command line used to\r
70                     start TortoiseGitProc.exe.\r
71                 </para>\r
72             </listitem>\r
73         </varlistentry>\r
74         <varlistentry>\r
75             <term condition="pot">DiffBlamesWithTortoiseMerge</term>\r
76             <listitem>\r
77                 <para>\r
78                     TortoiseGit allows you to assign an external diff viewer.\r
79                     Most such viewers, however, are not suited for change blaming\r
80                     (<xref linkend="tsvn-dug-blame-diffs"/>),\r
81                     so you might wish to fall back to TortoiseMerge in this case.\r
82                     To do so, set this value to <literal>true</literal>.\r
83                 </para>\r
84             </listitem>\r
85         </varlistentry>\r
86         <varlistentry>\r
87             <term condition="pot">FullRowSelect</term>\r
88             <listitem>\r
89                 <para>\r
90                     The status list control which is used in various dialogs\r
91                     (e.g., commit, check-for-modifications, add, revert, ...)\r
92                     uses full row selection (i.e., if you select an entry, the\r
93                     full row is selected, not just the first column).\r
94                     This is fine, but the selected row then also covers the\r
95                     background image on the bottom right, which can look ugly.\r
96                     To disable full row select, set this value to\r
97                     <literal>false</literal>.\r
98                 </para>\r
99             </listitem>\r
100         </varlistentry>\r
101         <varlistentry>\r
102             <term condition="pot">NoSortLocalBranchesFirst</term>\r
103             <listitem>\r
104                 <para>\r
105                     This option toggles if the branches are sorted fully by name (<literal>true</literal>) or if local branches should appear above remote ones (git default, <literal>false</literal>).\r
106                     The default value is <literal>false</literal>.\r
107                 </para>\r
108             </listitem>\r
109         </varlistentry>\r
110         <varlistentry>\r
111             <term condition="pot">ReaddUnselectedAddedFilesAfterCommit</term>\r
112             <listitem>\r
113                 <para>\r
114                     This option toggles the re-adding of unselected added files after a commit. Up to\r
115                     TortoiseGit 1.7.10 added files which were not checked on a commit, were removed from\r
116                     the index and unversioned after the commit. Set this value to <literal>false</literal>\r
117                     to restore the old behavior.\r
118                     Set this value to <literal>true</literal> to readd these files again after the commit (default).\r
119                 </para>\r
120             </listitem>\r
121         </varlistentry>\r
122         <varlistentry>\r
123             <term condition="pot">ScintillaDirect2D</term>\r
124             <listitem>\r
125                 <para>\r
126                     This option enables the use of Direct2D accelerated\r
127                     drawing in the Scintilla control which is used\r
128                     as the edit box in e.g. the commit dialog (also for the attached patch window), the\r
129                     unified diff viewer and TortoiseGitBlame.\r
130                     With some graphic cards, however, this sometimes\r
131                     doesn't work properly so that the cursor to enter\r
132                     text isn't always visible, the redraw does not work\r
133                     or the background is flashing. It's disabled by default. You\r
134                     can turn this feature on by setting this value\r
135                     to <literal>true</literal>.\r
136                 </para>\r
137             </listitem>\r
138         </varlistentry>\r
139         <varlistentry>\r
140             <term condition="pot">ShowContextMenuIcons</term>\r
141             <listitem>\r
142                 <para>\r
143                     This can be useful if you use something other than the windows explorer\r
144                     or if you get problems with the context menu displaying incorrectly.\r
145                     Set this value to <literal>false</literal>\r
146                     if you don't want TortoiseGit to show icons for the\r
147                     shell context menu items.\r
148                     Set this value to <literal>true</literal> to show the icons again.\r
149                 </para>\r
150             </listitem>\r
151         </varlistentry>\r
152         <varlistentry>\r
153             <term condition="pot">ShowListBackgroundImage</term>\r
154             <listitem>\r
155                 <para>\r
156                     If you do not want to have a small background image in list controls (e.g. Commit Dialog)\r
157                     set this value to <literal>false</literal>.\r
158                     Set this value to <literal>true</literal> to show the images again (default).\r
159                 </para>\r
160             </listitem>\r
161         </varlistentry>\r
162         <varlistentry>\r
163             <term condition="pot">TGitCacheCheckContent</term>\r
164             <listitem>\r
165                 <para>\r
166                     This makes TGitCache check file contents if timestamps (to index) missmatch in order to\r
167                     calculate the file status.\r
168                     TortoiseGit 1.7.0 up to 1.7.12 calculated the file status based on the timestamp only.\r
169                     If do not you want TGitCache to check the file contents (this lowers disk access and CPU time), set this value to <literal>false</literal>.\r
170                 </para>\r
171             </listitem>\r
172         </varlistentry>\r
173         <varlistentry>\r
174             <term condition="pot">UseLibgit2</term>\r
175             <listitem>\r
176                 <para>\r
177                     This makes TortoiseGit to use libgit2 as much as possible (e.g. for\r
178                     adding files to the index).\r
179                     If you do not want TortoiseGit to use libgit2 for file operations, set this value to <literal>false</literal>.\r
180                 </para>\r
181             </listitem>\r
182         </varlistentry>\r
183         <varlistentry>\r
184             <term condition="pot">VersionCheck</term>\r
185             <listitem>\r
186                 <para>\r
187                     TortoiseGit checks whether there's a new version available\r
188                     about once a week. If you don't want TortoiseGit to do this\r
189                     check, set this value to <literal>false</literal>.\r
190                 </para>\r
191             </listitem>\r
192         </varlistentry>\r
193         <varlistentry>\r
194             <term condition="pot">VersionCheckPreview</term>\r
195             <listitem>\r
196                 <para>\r
197                     Set this to <literal>true</literal> to make TortoiseGit also check for new preview releases.\r
198                     The default in all stable releases is <literal>false</literal>.\r
199                 </para>\r
200             </listitem>\r
201         </varlistentry>\r
202     </variablelist>\r
203 </sect2>\r