Updated more docs
[TortoiseGit.git] / doc / source / en / TortoiseGit / tsvn_dug / dug_settings_advanced.xml
blob63b991fb203de6853f0f36042e94e9acf8a95f08
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 TortoiseProc.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">ReaddUnselectedAddedFilesAfterCommit</term>\r
103             <listitem>\r
104                 <para>\r
105                     This option toggles the re-adding of unselected added files after a commit. Up to\r
106                     TortoiseGit 1.7.10 added files which were not checked on a commit, were removed from\r
107                     the index and unversioned after the commit. Set this value to <literal>false</literal>\r
108                     to restore the old behavior.\r
109                     Set this value to <literal>true</literal> to readd these files again after the commit (default).\r
110                 </para>\r
111             </listitem>\r
112         </varlistentry>\r
113         <varlistentry>\r
114             <term condition="pot">ScintillaDirect2D</term>\r
115             <listitem>\r
116                 <para>\r
117                     This option enables the use of Direct2D accelerated\r
118                     drawing in the Scintilla control which is used\r
119                     as the edit box in e.g. the commit dialog (also for the attached patch window), the\r
120                     unified diff viewer and TortoiseGitBlame.\r
121                     With some graphic cards, however, this sometimes\r
122                     doesn't work properly so that the cursor to enter\r
123                     text isn't always visible, the redraw does not work\r
124                     or the background is flashing. It's disabled by default. You\r
125                     can turn this feature on by setting this value\r
126                     to <literal>true</literal>.\r
127                 </para>\r
128             </listitem>\r
129         </varlistentry>\r
130         <varlistentry>\r
131             <term condition="pot">ShowContextMenuIcons</term>\r
132             <listitem>\r
133                 <para>\r
134                     This can be useful if you use something other than the windows explorer\r
135                     or if you get problems with the context menu displaying incorrectly.\r
136                     Set this value to <literal>false</literal>\r
137                     if you don't want TortoiseGit to show icons for the\r
138                     shell context menu items.\r
139                     Set this value to <literal>true</literal> to show the icons again.\r
140                 </para>\r
141             </listitem>\r
142         </varlistentry>\r
143         <varlistentry>\r
144             <term condition="pot">ShowListBackgroundImage</term>\r
145             <listitem>\r
146                 <para>\r
147                     If you do not want to have a small background image in list controls (e.g. Commit Dialog)\r
148                     set this value to <literal>false</literal>.\r
149                     Set this value to <literal>true</literal> to show the images again (default).\r
150                 </para>\r
151             </listitem>\r
152         </varlistentry>\r
153         <varlistentry>\r
154             <term condition="pot">TGitCacheCheckContent</term>\r
155             <listitem>\r
156                 <para>\r
157                     This makes TGitCache check file contents if timestamps (to index) missmatch in order to\r
158                     calculate the file status.\r
159                     TortoiseGit 1.7.0 up to 1.7.12 calculated the file status based on the timestamp only.\r
160                     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
161                 </para>\r
162             </listitem>\r
163         </varlistentry>\r
164         <varlistentry>\r
165             <term condition="pot">UseLibgit2</term>\r
166             <listitem>\r
167                 <para>\r
168                     This makes TortoiseGit to use libgit2 as much as possible (e.g. for\r
169                     adding files to the index).\r
170                     If you do not want TortoiseGit to use libgit2 for file operations, set this value to <literal>false</literal>.\r
171                 </para>\r
172             </listitem>\r
173         </varlistentry>\r
174         <varlistentry>\r
175             <term condition="pot">VersionCheck</term>\r
176             <listitem>\r
177                 <para>\r
178                     TortoiseGit checks whether there's a new version available\r
179                     about once a week. If you don't want TortoiseGit to do this\r
180                     check, set this value to <literal>false</literal>.\r
181                 </para>\r
182             </listitem>\r
183         </varlistentry>\r
184         <varlistentry>\r
185             <term condition="pot">VersionCheckPreview</term>\r
186             <listitem>\r
187                 <para>\r
188                     Set this to <literal>true</literal> to make TortoiseGit also check for new preview releases.\r
189                     The default in all stable releases is <literal>false</literal>.\r
190                 </para>\r
191             </listitem>\r
192         </varlistentry>\r
193     </variablelist>\r
194 </sect2>\r