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

stable doc: fix section puntaction

Changeset 59979ef85be5

Parent ef6a0a326d32

by Giampaolo Fadel

Changes to 9 files · Browse files at 59979ef85be5 Showing diff from parent ef6a0a326d32 Diff from another changeset...

 
1
2
3
4
 
32
33
34
35
 
36
37
38
 
51
52
53
54
 
55
56
57
 
114
115
116
117
 
118
119
120
 
139
140
141
142
 
143
144
145
 
160
161
162
163
 
164
165
166
 
192
193
194
195
 
196
197
198
 
 
1
2
3
 
31
32
33
 
34
35
36
37
 
50
51
52
 
53
54
55
56
 
113
114
115
 
116
117
118
119
 
138
139
140
 
141
142
143
144
 
159
160
161
 
162
163
164
165
 
191
192
193
 
194
195
196
197
@@ -1,4 +1,3 @@
-===========================  TortoiseHg Changelog Viewer  ===========================   @@ -32,7 +31,7 @@
 This changelog browser offers much more.    Revision Graph Details -====================== +----------------------    The graph column shows the child-parent relationships between revisions  in your repository history. This column auto-sizes for as many lines of @@ -51,7 +50,7 @@
  load all remaining revisions into the graph    Revision Context Menus -====================== +----------------------    Right-clicking on a revision in the (top) graph pane will bring up the  revision context menu. @@ -114,7 +113,7 @@
     File List Context Menus -======================= +-----------------------    Right-clicking on filenames in the file list (bottom left) pane will  bring up a context menu for the selected file: @@ -139,7 +138,7 @@
     Changeset browser -================= +-----------------    The changelog and datamine tools can open the changeset browser to view  a single revision or the combined effect of a range of revisions. The @@ -160,7 +159,7 @@
 accelerator to copy hightlighted diff hunks to the clipboard.    Configurables -============= +-------------    The changelog browser has a few configurable options that can be set in  the TortoiseHg Settings dialog on the Changelog tab. @@ -192,7 +191,7 @@
     From command line -================= +-----------------    The changelog viewer can be started from command line ::  
 
1
2
3
4
 
24
25
26
27
 
28
29
30
 
81
82
83
84
 
85
86
87
 
92
93
94
95
 
96
97
98
 
102
103
104
105
 
106
107
108
 
119
120
121
122
 
123
124
125
 
145
146
147
148
 
149
150
151
 
163
164
165
166
 
167
168
169
 
177
178
179
180
 
181
182
183
 
203
204
205
206
 
207
208
209
 
212
213
214
215
 
216
217
218
 
243
244
245
246
 
247
248
249
 
272
273
274
275
 
276
277
278
 
290
291
292
293
 
294
295
296
 
323
324
325
326
 
327
328
329
 
349
350
351
352
 
353
354
355
 
 
1
2
3
 
23
24
25
 
26
27
28
29
 
80
81
82
 
83
84
85
86
 
91
92
93
 
94
95
96
97
 
101
102
103
 
104
105
106
107
 
118
119
120
 
121
122
123
124
 
144
145
146
 
147
148
149
150
 
162
163
164
 
165
166
167
168
 
176
177
178
 
179
180
181
182
 
202
203
204
 
205
206
207
208
 
211
212
213
 
214
215
216
217
 
242
243
244
 
245
246
247
248
 
271
272
273
 
274
275
276
277
 
289
290
291
 
292
293
294
295
 
322
323
324
 
325
326
327
328
 
348
349
350
 
351
352
353
354
@@ -1,4 +1,3 @@
-======================  TortoiseHg Commit Tool  ======================   @@ -24,7 +23,7 @@
  Commit dialog    Features -======== +--------    Walking across the toolbar, the buttons perform the following tasks:   @@ -81,7 +80,7 @@
 rename.    Change Selection (record) -========================= +-------------------------    So what does that mean when it says the commit button will commit the  selected diffs in checked files? Simple, the native TortoiseHg commit @@ -92,7 +91,7 @@
 Mercurial's record extension will recognize this immediately.    When is this necessary? ------------------------ +^^^^^^^^^^^^^^^^^^^^^^^    Most often, it is when you have made more than a single coherent change  to your source code and you would like to commit your changes piecemeal. @@ -102,7 +101,7 @@
 indespensable.    How does it work? ------------------ +^^^^^^^^^^^^^^^^^    By double-clicking on individual change hunks in the diff panel.  *Technically, any action which activates a change hunk row will toggle @@ -119,7 +118,7 @@
 partially included, or excluded entirely.    What happens at commit time? ----------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^    The short answer is that the selected files and hunks are committed to  the repository and the unselected changes are left in your working @@ -145,7 +144,7 @@
     Keyboard navigation -=================== +-------------------    :kbd:`Ctrl-Enter`   will trigger the commit @@ -163,7 +162,7 @@
     File Context Menus -================== +------------------    By right clicking on files in the file list, you will get a context menu  of commands that are applicable to the selected file. If you configure a @@ -177,7 +176,7 @@
     Merges -====== +------    The commit tool has a special mode when it is opened in a repository  that is in a merged state (technically, this means the current working @@ -203,7 +202,7 @@
     Commit Message Format -===================== +---------------------    If your project has guidelines for commit message format, you can  configure those in the settings tool. Once configured, the commit tool @@ -212,7 +211,7 @@
 on the commit message pane that will try to enforce your policy.    MQ patches -========== +----------    Many advanced Mercurial users use the MQ extension to manage a patch  queue. TortoiseHg does not offer much in the way of support for MQ, but @@ -243,7 +242,7 @@
 patches and take advantage of our excellent change selection support.    QNew Mode -========= +---------    Newly added in 0.8, the commit tool can be used to create a new patch  for your patch queue. If you have the MQ extension enabled, a text @@ -272,7 +271,7 @@
     Configurables -============= +-------------    :menuselection:`Commit --> Username`   Sets username associated with your commits @@ -290,7 +289,7 @@
 External tool configuration is deprecated and will be removed in 0.9    From command line -================= +-----------------    The commit tool can be started from command line ::   @@ -323,7 +322,7 @@
     Changes since 0.7 -================= +-----------------    * The :guilabel:`Show Diff` button has been removed. Diffs are always shown.  * The commit tool no longer shows all diffs at startup. Only the first @@ -349,7 +348,7 @@
     Changes since 0.6 -================= +-----------------    Large changes were made to the commit tool in the 0.7 release. The  previous default tool, Qct, was unbundled and TortoiseHg's native commit
 
1
2
3
4
 
9
10
11
12
 
13
14
15
 
22
23
24
25
 
26
27
28
 
47
48
49
50
 
51
52
53
 
61
62
63
64
 
65
66
67
 
82
83
84
85
 
86
87
88
 
 
1
2
3
 
8
9
10
 
11
12
13
14
 
21
22
23
 
24
25
26
27
 
46
47
48
 
49
50
51
52
 
60
61
62
 
63
64
65
66
 
81
82
83
 
84
85
86
87
@@ -1,4 +1,3 @@
-===============  Common Features  ===============   @@ -9,7 +8,7 @@
 here just once.    Geometry Restore -================ +----------------    Our primary applications like commit, changelog, and datamine will  restore their geometry and position from the last time they were run. @@ -22,7 +21,7 @@
 window manager to place them where it wishes.    Keyboard Accelerators -===================== +---------------------    We define a few keyboard accelerators that all of the TortoiseHg tools support.   @@ -47,7 +46,7 @@
 access cut-paste functionality, for instance.    Visual Diffs -============ +------------    0.8 introduced a visual diff dialog that solves four usability issues:   @@ -61,7 +60,7 @@
 dialog and :menuselection:`TortoiseHg --> Skip Diff Window`.    Treeview searches -================= +-----------------    Many TortoiseHg dialogs use treeviews to present lists of data to the  user. The file lists in the status, commit, shelve, and changelog tools @@ -82,7 +81,7 @@
  matching lines    HG command dialog -================= +-----------------    Many TortoiseHg tools use the *hgcmd* dialog to execute Mercurial  commands that could potentially be interactive. In release 0.8, the
 
1
2
3
4
 
11
12
13
14
 
15
16
17
 
55
56
57
58
 
59
60
61
 
69
70
71
72
 
73
74
75
 
94
95
96
97
 
98
99
100
 
106
107
108
109
 
110
111
112
 
117
118
119
120
 
121
122
123
 
 
1
2
3
 
10
11
12
 
13
14
15
16
 
54
55
56
 
57
58
59
60
 
68
69
70
 
71
72
73
74
 
93
94
95
 
96
97
98
99
 
105
106
107
 
108
109
110
111
 
116
117
118
 
119
120
121
122
@@ -1,4 +1,3 @@
-===================  TortoiseHg Datamine  ===================   @@ -11,7 +10,7 @@
     Search Tabs -=========== +-----------    .. figure:: figures/search.png   :alt: Search dialog @@ -55,7 +54,7 @@
 sensitive when a search is in progress).    Matches -======= +-------    Each match will be a link to a changeset and will have a descriptive  tooltip (author, date/time, summary). Right clicking on a matched line @@ -69,7 +68,7 @@
  open a changelog window with this file's revision history    Annotate Tabs -============= +-------------    .. figure:: figures/annotate.png   :alt: Annotate tabs @@ -94,7 +93,7 @@
 :guilabel:`filename` and :guilabel:`user`.    Following Renames ------------------ +^^^^^^^^^^^^^^^^^    The annotation data will automatically follow lines of code back through  copies and renames to find the initial changeset that introduced that @@ -106,7 +105,7 @@
 annotated at the same changeset.    Configurables -------------- +^^^^^^^^^^^^^    The annotate tabs support the following configurations defined primarily  for other tools: @@ -117,7 +116,7 @@
  Number of spaces to expand tabs in diffs and annotate output    From command line -================= +-----------------    The datamine tool can be started from command line ::  
 
1
2
3
 
4
5
6
7
8
9
 
10
11
12
 
35
36
37
38
 
39
40
41
 
55
56
57
58
 
59
60
61
 
 
1
 
2
3
4
5
6
7
 
8
9
10
11
 
34
35
36
 
37
38
39
40
 
54
55
56
 
57
58
59
60
@@ -1,12 +1,11 @@
-============================  Windows Explorer Integration -============================ +----------------------------    .. module:: explorer   :synopsis: Windows explorer integration    Overlay Icons -============= +-------------    TortoiseHg provides visual representation of the file status via overlay  icons in the MS-Explorer windows. This is similar to those that found on @@ -35,7 +34,7 @@
  @@noicons    Performance Issues -================== +------------------    When the repository being viewed contains a large number of folders or  files, the overlay icons may appear case a perceivable delay in @@ -55,7 +54,7 @@
 local disks only.    Context Menus -============= +-------------    The TortoiseHg commands (GUI window & dialogs) may be accessed via the  context menu of Explorer windows. The TortoiseHg context menu is
 
1
2
3
4
 
 
1
2
3
@@ -1,4 +1,3 @@
-===================  TortoiseHg Recovery  ===================  
 
1
2
3
4
 
47
48
49
50
 
51
52
53
 
65
66
67
68
 
69
70
71
 
 
1
2
3
 
46
47
48
 
49
50
51
52
 
64
65
66
 
67
68
69
70
@@ -1,4 +1,3 @@
-================  TortoiseHg Serve  ================   @@ -47,7 +46,7 @@
 shell context menu.    From command line -================= +-----------------    The server tool can be started from command line ::   @@ -65,7 +64,7 @@
     Changes since 0.7 -================= +-----------------    * Improved error handling  * i18n fixes
 
1
2
3
4
 
51
52
53
54
 
55
56
57
 
66
67
68
69
 
70
71
72
 
84
85
86
87
 
88
89
90
 
92
93
94
95
 
96
97
98
 
101
102
103
104
 
105
106
107
 
116
117
118
119
 
120
121
122
123
124
125
 
126
127
128
 
 
1
2
3
 
50
51
52
 
53
54
55
56
 
65
66
67
 
68
69
70
71
 
83
84
85
 
86
87
88
89
 
91
92
93
 
94
95
96
97
 
100
101
102
 
103
104
105
106
 
115
116
117
 
118
119
120
121
122
123
 
124
125
126
127
@@ -1,4 +1,3 @@
-======================  TortoiseHg Shelve Tool  ======================   @@ -51,7 +50,7 @@
 clean, ignored}.    Shelving Changes -================ +----------------      Just like the commit tool, this dialog uses TortoiseHg's integrated hunk @@ -66,7 +65,7 @@
 to the working directory.    How is this different from record/commit? ------------------------------------------ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^    Shelved changes are physically removed from the working directory until  you unshelve them. This means you can build your project and run tests @@ -84,7 +83,7 @@
 changes made to your code after the shelving.    How is this different from MQ? ------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^    A shelf is, in effect, a single unnamed MQ patch that is never converted  into a changeset. The shelve tool can be useful when you are @@ -92,7 +91,7 @@
 re-apply them to another patch (or an entirely new patch).    How is this different from attic? ---------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^    The attic extension is a super-set of the shelve feature. In particular,  attic allows you to have several named *shelves* which can be saved and @@ -101,7 +100,7 @@
 releases.    Keyboard navigation -=================== +-------------------    :guilabel:`Ctrl-C`   in the diff panel will copy the currently highlighted (not selected, @@ -116,13 +115,13 @@
 clipboard contents always be a valid patch.    Configurables -============= +-------------    * :menuselection:`TortoiseHg --> Bottom Diffs`  * :menuselection:`TortoiseHg --> Tab Width`    From command line -================= +-----------------    The shelve tool can be started from command line ::  
 
1
2
3
4
 
96
97
98
99
 
100
101
102
 
109
110
111
112
 
113
114
115
 
137
138
139
140
 
141
142
143
 
171
172
173
174
 
175
176
177
 
 
1
2
3
 
95
96
97
 
98
99
100
101
 
108
109
110
 
111
112
113
114
 
136
137
138
 
139
140
141
142
 
170
171
172
 
173
174
175
176
@@ -1,4 +1,3 @@
-======================  TortoiseHg Synchronize  ======================   @@ -96,7 +95,7 @@
     After Pull -========== +----------    After changesets are pulled into your repository, two buttons may appear  at the bottom of the dialog: @@ -109,7 +108,7 @@
 Either button may be hidden if it is not applicable.    Email -===== +-----    .. figure:: figures//email.png   :alt: Email dialog @@ -137,7 +136,7 @@
 plain patches, HG patches, Git patches, and bundles.    From command line -================= +-----------------    The synchronize tool can be started from command line ::   @@ -171,7 +170,7 @@
 path it finds.    Changes since 0.7 -================= +-----------------    * Path drop-down list no longer includes most-recently-used paths. It   only includes configured repository paths.