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: add detail to changeset chapter

Changeset 9c8f8913ee35…

Parent 1c0eeffd9910…

by Steve Borho

Changes to 2 files · Browse files at 9c8f8913ee35 Showing diff from parent 1c0eeffd9910 Diff from another changeset...

Change 1 of 1 Show Entire File doc/​TODO Stacked
 
1
2
3
4
5
 
1
 
2
3
4
@@ -1,5 +1,4 @@
 Update context menu screenshot -Changelog needs much more detail  Commit needs more detail  Add links to BB wiki and Mercurial wiki  Describe path editing and [auth] hgrc section
Change 1 of 8 Show Entire File doc/​source/​changelog.txt Stacked
 
25
26
27
28
29
 
 
30
31
 
 
 
 
32
33
34
 
49
50
51
 
 
 
52
53
54
 
86
87
88
89
90
 
 
 
91
92
93
 
106
107
108
109
 
110
111
112
 
131
132
133
134
 
135
136
 
137
138
139
140
141
142
 
 
 
 
 
 
143
144
145
 
147
148
149
150
151
152
153
 
 
 
 
 
 
 
 
154
155
156
157
158
159
160
161
162
163
 
189
190
191
192
 
193
194
195
 
203
204
205
206
 
207
208
209
210
211
212
 
213
 
25
26
27
 
 
28
29
30
 
31
32
33
34
35
36
37
 
52
53
54
55
56
57
58
59
60
 
92
93
94
 
 
95
96
97
98
99
100
 
113
114
115
 
116
117
118
119
 
138
139
140
 
141
142
 
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
160
161
162
 
 
 
 
163
164
165
166
167
168
169
170
171
172
173
174
 
 
 
175
176
177
 
203
204
205
 
206
207
208
209
 
217
218
219
 
220
221
222
223
224
225
 
226
227
@@ -25,10 +25,13 @@
 The changelog tool is primarily used to visualize the revision history  of your repository. It presents a graph of the revision history, showing  the parent/child relationship of each change. At each revision you can -view the files that it modified and the contents of those changes. These -are the obvious features that a revision history browser provides. +view the files that were modified and the contents of those changes. +These are the features that nearly all revision history browsers provide.   -This changelog browser offers much more. +The TortoiseHg changelog browser offers much more. Since it is our best +tool for viewing and selecting changesets, we use it to perform nearly +all our tasks that involve changeset manipulation. +    Revision Graph Details  ---------------------- @@ -49,6 +52,9 @@
 :guilabel:`all revisions`   load all remaining revisions into the graph   +The column visibility toggles are sticky settings. + +  Revision Context Menus  ----------------------   @@ -86,8 +92,9 @@
  repository [#rcm4]_     -If you right-click on a row other than the one that was currently selected, you get a different context menu. -This one is for visualizing diffs between two arbitrary revisions. +If you right-click on a row other than the one that was currently +selected, you get a different context menu. This context menu has +commands that deal with arbitrary revision ranges.    :guilabel:`diff with selected`   Description @@ -106,7 +113,7 @@
 .. [#rcm4] The strip command will store the stripped revisions in a bundle file   that can later be reapplied.   See `also <http://mercurial.selenic.com/wiki/EditingHistory>`_. -.. [#rcm5] :menuselection:`Settings --> Global --> TortoiseHg --> Visual Diff Command` +.. [#rcm5] :menuselection:`Global Settings --> TortoiseHg --> Visual Diff Command`  .. [#rcm6] Only sensitive if the selected revision is your current working   directory parent   @@ -131,15 +138,21 @@
 :guilabel:`revert file contents`   Checkout this specific revision of this file [#flcm3]_   -.. [#flcm1] :menuselection:`Settings --> Global --> TortoiseHg --> Visual Editor` +.. [#flcm1] :menuselection:`Global Settings --> TortoiseHg --> Visual Editor`  .. [#flcm2] Does not show revisions where a file was deleted, as this is only a - manifest change, it does not modify the file's history. + manifest change, it does not modify the file's history.  .. [#flcm3] The new contents will appear as local changes and must be committed.      Changeset browser  -----------------   +The changeset browser will only show a single file's diffs at a time, as +a performance optimization. If you would like to see all of the file +diffs at once, click on the :guilabel:`[All Files]` row. The changeset +browser will also skip displaying diffs for files which are above a +maximum limit. See :menuselection:`Global Settings --> TortoiseHg --> Max Diff Size` +  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  changeset browser is very similar to the commit and shelve tools. It has @@ -147,17 +160,18 @@
 pane on the right with the changes to each file.    In release 0.7 of TortoiseHg, the 'diff change with' changeset browser -now supports change selection. You can select files and hunks that you -wish to extract from the changeset(s) you are browsing and write them to -a patch file using the :guilabel:`Save as` toolbar button. This is a very -efficient way to cherry pick changes made to a repository. +acquired the same change selection feature as the commit tool. You can +select files and hunks that you wish to extract from the changeset(s) +you are browsing and write them to a patch file using the +:guilabel:`Save as` toolbar button. This is a very efficient way to +cherry pick changes from a repository. This changeset browser also +supports the :kbd:`Ctrl-C` keyboard accelerator to copy hightlighted +diff hunks to the clipboard. +  Unfortunately, TortoiseHg still does not have a dialog for importing  changes into a repository, so this must be done on the command line with  the :command:`hg import` command.   -This changeset browser also supports the :kbd:`Ctrl-C` keyboard -accelerator to copy hightlighted diff hunks to the clipboard. -  Configurables  -------------   @@ -189,7 +203,7 @@
 :guilabel:`Bottom Diffs`   Show diffs below file list   - +  From command line  -----------------   @@ -203,11 +217,11 @@
   The syntax is ::   - hgtk log [OPTIONS] + hgtk log [OPTIONS] [FILES]    Valid [OPTIONS] are:    ``-l``, ``--limit``   Specify the limit number of changes displayed. - +  .. vim: noet ts=4