Kiln » TortoiseHg » TortoiseHg
Clone URL:  
Pushed to one repository · View In Graph Contained in 2.0, 2.0.1, and 2.0.2

stable docs: adapt doc/source/workbench.txt for Qt port

This is a first draft.

Changeset cd361b176945

Parent 4a8536a0125b

by Johan Samyn

Changes to 15 files · Browse files at cd361b176945 Showing diff from parent 4a8536a0125b Diff from another changeset...

Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
Added image
 
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
 
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
@@ -5,41 +5,181 @@
  :synopsis: Dialog used to view log    The Workbench is used to visualize the revision history of your -repositories and to perform any maintenence tasks that involve +repositories and to perform any maintenance tasks that involve  changesets. 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 were modified and the contents of those changes.   -.. figure:: figures/log.png - :alt: Changelog +.. figure:: figures/workbench.png + :alt: Workbench   - Changelog viewer dialog with main toolbar hidden + Workbench dialog. + +Workbench Menus +---------------    The changelog tool has a menu bar for accessing tool functions and for  launching other tools.   - :guilabel:`Tools` - Launch other TortoiseHg tools as separate processes + :guilabel:`File` + Handle repositories and settings. + + .. figure:: figures/file-menu.png + :alt: File menu +   :guilabel:`View` - Toggle the visibility of various features, or refresh views - :guilabel:`Navigate` - Select specific changesets in your repository history - :guilabel:`Synchronize` - Access synchronization functions, more below + Manage the visibility of various parts of the Workbench. + + .. figure:: figures/view-menu.png + :alt: View menu + + :guilabel:`Repository` + Perform special actions on the active repository. + + .. figure:: figures/repository-menu.png + :alt: Repository menu +   :guilabel:`Help` - Help contents shows this web page. About shows TortoiseHg - version info + About shows TortoiseHg version info.   -The toolbar buttons from left to right: +Edit Toolbar +------------ + +.. figure:: figures/edit-toolbar.png + :alt: Edit Toolbar + + Moving around in the changelog.     :guilabel:`Refresh`   Reload the revision history (if you commit in another window, etc) + for all open repositories. + :guilabel:`Back` + Go back to the previous view. + :guilabel:`Forward` + Go forward to the next view. + :guilabel:`Filter toolbar` + Show and activate the Filter Toolbar at the top of the changelog. + :guilabel:`Goto toolbar` + Show and activatethe Goto Toolbar at the top of the changelog. + +Dock Toolbar +------------ + +.. figure:: figures/dock-toolbar.png + :alt: Dock Toolbar + + Show or hide some main widgets in the Workbench. + + :guilabel:`Show Repository Registry` + Show/hide the Repository Registry widget. + :guilabel:`Show Output Log` + Show/hide the Output Log widget. + +Sync Toolbar +------------ + +.. figure:: figures/sync-toolbar.png + :alt: Sync Toolbar + + Synchronize your repository with other repositories. + + :guilabel:`Incoming` + Download incoming changesets from the remote repository, store then in + a temporary bundle file, then enter bundle preview mode with the + incoming changes applied. Incoming changesets will be shown as normal, + while others will be shown grayed in the revision graph. + The buttons :guilabel:`Accept` and :guilabel:`Reject` are then + shown at the top of the changelog. + + :guilabel:`Accept` + Accept (pull) the changesets from the previewed bundle. This + button is only visible when previewing a changeset bundle. + The after-pull effect is respected after pulling from a bundle. + + :guilabel:`Reject` + Reject the changesets from the previewed bundle and exit preview + mode. This button is only visible when previewing a changeset + bundle. + + :guilabel:`Pull` + Pull incoming changesets from the remote repository, then apply + after-pull effect (update, fetch, or rebase). + :guilabel:`Outgoing` + Determine outgoing changesets that would be pushed to the + remote repository. Outgoing changesets will be shown as normal, while + others will be shown grayed in the revision graph. + :guilabel:`Push` + Push outgoing changesets to the remote repository. + +Task Toolbar +------------ + +.. figure:: figures/task-toolbar.png + :alt: Task Toolbar + +.. + + Work with the various tasktabs. + + :guilabel:`Revision Details` + Shows information about the current revision : files added, removed, + renamed, or modified, file contents, changelog info. + + TODO: screenshot +.. .. figure:: figures/revdetails-tasktab.png + :alt: Revision Details TaskTab + +.. +   :guilabel:`Commit` - Launch the commit tool in a separate process - :guilabel:`Web Server` - Launch the web server dialog in a separate process - :guilabel:`Shelve` - Launch the shelve tool in a separate process + Here you can add new files, and do your commits. + + TODO: screenshot +.. .. figure:: figures/commit-tasktab.png + :alt: Commit TaskTab + +.. + + :guilabel:`Manifest` + Shows information about the complete content of the repository as it + was for the current revision. Here you can view the raw content of + files or an Annotate view. There is a context menu on the filelist + to do further digging into the history data. You can even compare a + file between different revision from there. + + TODO: screenshot +.. .. figure:: figures/manifest-tasktab.png + :alt: Manifest TaskTab + +.. + + :guilabel:`Search` + For performing text searches through file content. + + TODO: screenshot +.. .. figure:: figures/search-tasktab.png + :alt: Search Tasktab + +.. + + :guilabel:`Synchronize` + Gives you full control about how you let your repositories + communicate with any other repository. + + TODO: screenshot +.. .. figure:: figures/sync-tasktab.png + :alt: Synchronise Tasktab + +.. + + :guilabel:`Patch Queue` + This widget implements the MQ extension functionality. + + TODO: screenshot +.. .. figure:: figures/mq-tasktab.png + :alt: Patch Queue TaskTab + +..    Sync Bar  ---------