Kiln » TortoiseHg » TortoiseHg
Clone URL:  
Pushed to one repository · View In Graph Contained in 0.8.2, 0.8.3, and 0.9

doc: fill settings of commit and changelog

Changeset 2650302b0d5f…

Parent 5c89e29e4676…

by Giampaolo Fadel

Changes to one file · Browse files at 2650302b0d5f Showing diff from parent 5c89e29e4676 Diff from another changeset...

Change 1 of 1 Show Changes Only doc/​source/​settings.txt Stacked
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
130
131
132
 
 
 
133
134
135
 
 
 
 
136
137
138
 
 
 
 
 
139
140
141
142
143
144
 
 
 
 
145
146
147
 
 
 
148
149
150
 
 
 
151
152
153
 
 
 
154
155
156
157
158
159
 
 
 
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
 
129
130
131
 
132
133
134
135
136
 
137
138
139
140
141
142
 
143
144
145
146
147
148
149
150
151
152
 
153
154
155
156
157
158
 
159
160
161
162
163
 
164
165
166
167
168
 
169
170
171
172
173
174
175
176
 
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
 ===================  TortoiseHg Settings  ===================    .. module:: settings.dialog   :synopsis: Dialog used to set preferences    .. figure:: figures/settings.png   :alt: Settings dialog     Settings dialog    The Settings dialog is used to configure both TortoiseHg and the  underlying Mercurial DVCS. Since TortoiseHg uses Mercurial's underlying  configuration system to store and retrieve its settings, these are  essentially the same thing.    Mercurial on Windows has a three-tier configuration system.    1) A site-wide configuration file in   :file:`C:\\Program Files\\TortoiseHg\\Mercurial.ini`   This file is read first and thus has the lowest priority.  2) A per-user configuration file in   :file:`C:\\Documents and Settings\\username\\Mercurial.ini`   This file is read second and thus can override settings in the   site-wide configuration file.  3) A per-repository configuration file in :file:`repo-root\\.hg\\hgrc` This   file is read last and can override site-wide and user global settings.    The site-wide file can be overwritten on upgrades so it is recommended  that you do not make changes to this file. Instead, you should make  changes to your user :file:`Mercurial.ini` and/or the repository  :file:`hgrc` file. The TortoiseHg Settings dialog enforces this  suggestion by only operating in two modes:    Global   edits your user :file:`Mercurial.ini` file  Repository   edits a repository :file:`.hg/hgrc` file    In TortoiseHg 0.8, you may toggle between the two modes using the combo  box at the top of the dialog.    Most TortoiseHg users will want to store all configurables in their  global user settings, and only use the repository hgrc to store paths  (remote repository aliases) and web settings, though it is possible to  override many configurables per-repository (a common example is to  configure a different username for use in a repository). Also note that  the user and repository configuration files may not exist until you run  the Settings dialog for the first time.    Tabs  ====    The Settings tool is a tabbed application.    Each tab corresponds roughly to a section of your :file:`Mercurial.ini`  file, though there is a certain amount of overlap. Some sections were  split across multiple tabs for clarity.    Every tab except of the :guilabel:`Paths` tab has the same format, a list of  configurable options with a drop-down combo box with possible values and  a history of options you have used for that setting. The configurable  name (label) has a tooltip which describes in more detail what you are  configuring and its default value.    The :guilabel:`Paths` tab is where you can store URLs (paths) to related  repositories. It is rare to store paths in the site-wide or user  configuration files, most of the time you will only store these in a  repository configuration file. Mercurial has two special path names that  can be used as default targets for some operations.    default   the default URL to pull from, usually clone source  default-push   the default push target when using the command line    Please consult the Mercurial wiki for more detailed information about  these configurables (except for the first three tabs:  :guilabel:`TortoiseHg`, :guilabel:`Commit`, :guilabel:`Changelog`, which  are specifically for TortoiseHg).    TortoiseHg  ----------    :guilabel:`3-way Merge Tool:`   Graphical merge program for resolving merge conflicts. If left   unspecified, Mercurial will use the first applicable tool it finds   on your system or use its internal merge tool that leaves conflict   markers in place. Chose internal:merge to force conflict markers,   internal:prompt to always select local or other, or internal:dump   to leave files in the working directory for manual merging.    :guilabel:`Visual Diff Command:`   Specify visual diff tool; must be an extdiff command.    :guilabel:`Skip Diff Window:`   Bypass the builtin visual diff dialog and directly use your   visual diff tool's directory diff feature. Only enable this   feature if you know your diff tool has a valid extdiff   configuration. Default: False.    :guilabel:`Visual Editor:`   Specify the visual editor used to view files, etc.    :guilabel:`CLI Editor:`   The editor to use during a commit and other   instances where Mercurial needs multiline input from   the user. Only used by command line interface commands.    :guilabel:`Tab Width:`   Specify the number of spaces that tabs expand to in various.   TortoiseHg windows. Default: Not expanded.    :guilabel:`Max Diff Size:`   The maximum size file (in KB) that TortoiseHg will   show changes for in the changelog, status, and commit windows.   A value of zero implies no limit. Default: 1024 (1MB).    :guilabel:`Bottom Diffs:`   Show the diff panel below the file list in status, shelve, and   commit dialogs.   Default: False (show diffs to right of file list).    Commit  ------    :guilabel:`Username:` - TODO + Name associated with commits.    :guilabel:`External Commit Tool:` - TODO + Select commit tool launched by TortoiseHg. (Qct is no longer + distributed as part of TortoiseHg). + Default: None (use the builtin tool). [DEPRECATED]    :guilabel:`Summary Line Length:` - TODO + Maximum length of the commit message summary line. + If set, TortoiseHg will issue a warning if the + summary line is too long or not separated by a + blank line. Default: 0 (unenforced).    :guilabel:`Message Line Length:` - TODO + Word wrap length of the commit message. If + set, the popup menu can be used to format + the message and a warning will be issued + if any lines are too long at commit. + Default: 0 (unenforced).    Changelog  ---------    :guilabel:`Author Coloring:` - TODO + Color changesets by author name. If not enabled, + the changes are colored green for merge, red for + non-trivial parents, black for normal. + Default: False.    :guilabel:`Long Summary:` - TODO + If true, concatenate multiple lines of changeset summary + until they reach 80 characters. + Default: False.    :guilabel:`Log Batch Size:` - TODO + The number of revisions to read and display in the + changelog viewer in a single batch. + Default: 500.    :guilabel:`Copy Hash:` - TODO + Allow the changelog viewer to copy the changeset hash + of the currently selected changeset into the clipboard. + Default: False.    Sync  ----    :guilabel:`After pull operation:` - TODO + Operation which is performed directly after a successful pull. + update equates to pull --update, fetch equates to the fetch + extension, rebase equates to pull --rebase. Default: none.    :guilabel:`Remote repository paths`   TODO    Web  ---    :guilabel:`Name:`   TODO    :guilabel:`Description:`   TODO    :guilabel:`Contact:`   TODO    :guilabel:`Style:`   TODO    :guilabel:`Archive Formats:`   TODO    :guilabel:`Port:`   TODO    :guilabel:`Push Requires SSL:`   TODO    :guilabel:`Stripes:`   TODO    :guilabel:`Max Files:`   TODO    :guilabel:`Max Changes:`   TODO    :guilabel:`Allow Push:`   TODO    :guilabel:`Deny Push:`   TODO    :guilabel:`Encoding:`   TODO    Proxy  -----    :guilabel:`Host:`   TODO    :guilabel:`Bypass List:`   TODO    :guilabel:`Password:`   TODO    :guilabel:`User:`   TODO    Email  -----    :guilabel:`From:`   TODO    :guilabel:`To:`   TODO    :guilabel:`Cc:`   TODO    :guilabel:`Bcc:`   TODO    :guilabel:`method:`   TODO    :guilabel:`SMTP Host:`   TODO    :guilabel:`SMTP Port:`   TODO    :guilabel:`SMTP TLS:`   TODO    :guilabel:`SMTP Username:`   TODO    :guilabel:`SMTP Password:`   TODO    :guilabel:`Local Hostname:`   TODO    Diff  ----    :guilabel:`Git Format:`   TODO    :guilabel:`No Dates:`   TODO    :guilabel:`Show Function:`   TODO    :guilabel:`Ignore White Space:`   TODO    :guilabel:`Ignore WS Amount:`   TODO    :guilabel:`Ignore Blank Lines:`   TODO        From command line  -----------------    The setting dialog can be started from command line ::     hgtk repoconfig    for the repository settings or ::     hgtk userconfig    for the user configuration.    The syntax is simple, no options or parameters are needed, except the global options.    .. vim: noet ts=4