Source

cointoss1973.bitbucket.org / thg / manual / 2.4 / workbench.html

  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
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>5.4. Workbench &mdash; TortoiseHg 2.4.0 documentation</title>
    
    <link rel="stylesheet" href="_static/default.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '',
        VERSION:     '2.4.0',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="TortoiseHg 2.4.0 documentation" href="index.html" />
    <link rel="up" title="5. TortoiseHg in daily use" href="daily.html" />
    <link rel="next" title="5.5. Create a new repository" href="init.html" />
    <link rel="prev" title="5.3. GNOME desktop integration" href="nautilus.html" /> 
  </head>
  <body>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="init.html" title="5.5. Create a new repository"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="nautilus.html" title="5.3. GNOME desktop integration"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">TortoiseHg 2.4.0 documentation</a> &raquo;</li>
          <li><a href="daily.html" accesskey="U">5. TortoiseHg in daily use</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="module-workbench.dialog">
<span id="workbench"></span><h1>5.4. Workbench<a class="headerlink" href="#module-workbench.dialog" title="Permalink to this headline"></a></h1>
<p>The Workbench is the primary TortoiseHg application.  It allows you
to browse your local repositories, make commits, perform searches,
synchronize with other repositories, and perform various maintenance
tasks.  Nearly every Mercurial feature is accessible from the Workbench.</p>
<div class="figure">
<img alt="Workbench" src="_images/workbench.png" />
<p class="caption">Workbench dialog.</p>
</div>
<p>Workbench Main Widgets are:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Revision History View</em></dt>
<dd>A tabbed widget to view multiple repositories at once. The different
columns show general information about each changeset in the graphlog.
You can configure the columns to show from the menu via
<em class="menuselection">View ‣ Choose Log Columns...</em>, and there you can reorder
the columns too. This is the main or central widget of the      Workbench
application.</dd>
<dt><em class="guilabel">Repository Registry</em></dt>
<dd>This widget, by default shown on the left, allows to manage multiple
repositories from the Workbench. You can show/hide it via
<em class="menuselection">View ‣ Show Repo Registry</em> or with the corresponding button
in the Dock Toolbar. It&#8217;s also a dockable widget.
The <em class="menuselection">View ‣ Show Paths</em> menu option allows to not only view
the names of the repositories but also their path in a second column.</dd>
<dt><em class="guilabel">Output Log</em></dt>
<dd>This dockable widget, which can be shown/hidden with
<em class="menuselection">View ‣ Show Output Log</em>, gives the user information about
the Mercurial commands that were executed during the current session.
You can also use it as a commandline by typing Mercurial commands at its
prompt  directly. It shows any error messages when appropriate. Content
is wiped when the Workbench is closed.</dd>
<dt><em class="guilabel">Task Tabs</em></dt>
<dd>The lower right part of the Workbench is occupied by a stack of widget
where you can perform various frequent tasks. It is a tabbed widget.
See further for more detail about each one.</dd>
</dl>
</div></blockquote>
<div class="section" id="workbench-menus">
<h2>5.4.1. Workbench Menus<a class="headerlink" href="#workbench-menus" title="Permalink to this headline"></a></h2>
<p>The Workbench has a menu bar for accessing tool functions and for
launching other tools.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">File</em></dt>
<dd><p class="first">Handle repositories and settings.</p>
<div class="last figure">
<img alt="File menu" src="_images/file-menu.png" />
<p class="caption">File Menu</p>
</div>
</dd>
<dt><em class="guilabel">View</em></dt>
<dd><p class="first">Manage the visibility of various parts of the Workbench.</p>
<div class="last figure">
<img alt="View menu" src="_images/view-menu.png" />
<p class="caption">View menu</p>
</div>
</dd>
<dt><em class="guilabel">Repository</em></dt>
<dd><p class="first">Perform special actions on the active repository.</p>
<div class="last figure">
<img alt="Repository menu" src="_images/repository-menu.png" />
<p class="caption">Repository menu</p>
</div>
</dd>
<dt><em class="guilabel">Help</em></dt>
<dd>About shows TortoiseHg version info.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="edit-toolbar">
<h2>5.4.2. Edit Toolbar<a class="headerlink" href="#edit-toolbar" title="Permalink to this headline"></a></h2>
<div class="figure">
<img alt="Edit Toolbar" src="_images/edit-toolbar.png" />
<p class="caption">Edit toolbar</p>
</div>
<p>Moving around in the revision history. All the buttons work on the current repository.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Refresh</em></dt>
<dd>Reload the revision history of the current repository.</dd>
<dt><em class="guilabel">Back</em></dt>
<dd>Go back to the previously selected revision.</dd>
<dt><em class="guilabel">Forward</em></dt>
<dd>Go forward to the next revision in your selection history or
most recent revision set query.</dd>
<dt><em class="guilabel">Filter toolbar</em></dt>
<dd>Show and activate the Filter Toolbar at the top of the revision
graph.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="dock-toolbar">
<h2>5.4.3. Dock Toolbar<a class="headerlink" href="#dock-toolbar" title="Permalink to this headline"></a></h2>
<div class="figure">
<img alt="Dock Toolbar" src="_images/dock-toolbar.png" />
<p class="caption">Dock toolbar</p>
</div>
<p>Show or hide some main widgets in the Workbench.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Show Repository Registry</em></dt>
<dd>Show/hide the Repository Registry widget.</dd>
<dt><em class="guilabel">Show Output Log</em></dt>
<dd>Show/hide the Output Log widget.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="sync-toolbar">
<h2>5.4.4. Sync Toolbar<a class="headerlink" href="#sync-toolbar" title="Permalink to this headline"></a></h2>
<div class="figure">
<img alt="Sync Toolbar" src="_images/sync-toolbar.png" />
<p class="caption">Sync toolbar</p>
</div>
<p>Synchronize your repository with other repositories.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Incoming</em></dt>
<dd>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 <em class="guilabel">Accept</em> and <em class="guilabel">Reject</em> are then
shown at the top of the revision graph.</dd>
<dt><em class="guilabel">Pull</em></dt>
<dd>Pull incoming changesets from the remote repository, then apply
after-pull effect (update, fetch, or rebase).</dd>
<dt><em class="guilabel">Outgoing</em></dt>
<dd>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.</dd>
<dt><em class="guilabel">Push</em></dt>
<dd>Push outgoing changesets to the remote repository.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="task-toolbar">
<h2>5.4.5. Task Toolbar<a class="headerlink" href="#task-toolbar" title="Permalink to this headline"></a></h2>
<div class="figure">
<img alt="Task Toolbar" src="_images/task-toolbar.png" />
<p class="caption">Task toolbar</p>
</div>
<p>Work with the various task tabs.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Revision Details</em></dt>
<dd>Shows information about the current revision : files added, removed,
renamed, or modified, file contents, changeset info.
See <span class="target" id="revision-details">Revision Details</span> for more detail.</dd>
</dl>
</div></blockquote>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Commit</em></dt>
<dd>Here you can add new files, and do your commits.
See <span class="target" id="commit">Commit</span> for more detail.</dd>
</dl>
</div></blockquote>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Synchronize</em></dt>
<dd>Gives you full control about how you let your repositories
communicate with any other repository.
See <span class="target" id="synchronize">Synchronize</span> for more detail.</dd>
</dl>
</div></blockquote>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Manifest</em></dt>
<dd>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.
See <span class="target" id="manifest">Manifest</span> for more detail.</dd>
</dl>
</div></blockquote>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Search</em></dt>
<dd>For performing text searches through file content.</dd>
</dl>
</div></blockquote>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Patch Queue</em></dt>
<dd>This widget implements the MQ extension functionality.
See <span class="target" id="patch-queue">Patch Queue</span> for more detail.</dd>
</dl>
</div></blockquote>
<p>There is some relation between the revision or patch selected in the graph pane,
and the task tabs.</p>
<ul class="simple">
<li>Clicking on the Working Directory automatically switches to the Commit task tab.</li>
<li>Clicking on any revision other than the Working Directory switches to the
Revision Details task tab.</li>
</ul>
<p>You can overrule this standard behaviour by doing an <tt class="kbd docutils literal"><span class="pre">ALT-Click</span></tt> for making
your selection. This preserves the current task tab, no matter what revision or
patch you select.  Cursor selection movements also do not switch task tabs.</p>
</div>
<div class="section" id="filter-toolbar">
<h2>5.4.6. Filter Toolbar<a class="headerlink" href="#filter-toolbar" title="Permalink to this headline"></a></h2>
<div class="figure">
<img alt="Filter Toolbar" src="_images/filter-toolbar.png" />
<p class="caption">Filter features for the Workbench.</p>
</div>
<p>The filter bar allows one to quickly filter the changesets panel. It is based
on the Revision Sets feature of Mercurial.
See <a class="reference external" href="http://www.selenic.com/mercurial/hg.1.html#revsets">hg.1.html#revsets</a>
for details on how to specify revision sets.
The toolbar can be toggled with <tt class="kbd docutils literal"><span class="pre">Ctrl-S</span></tt>. Parts from left to right:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Clear</em></dt>
<dd>Clears the search lineedit.  Essentially disables all filters.</dd>
<dt><em class="guilabel">Filter entry</em></dt>
<dd>Here you can type a filtering condition. The widget is a combobox,
holding a history of previous filtering conditions.</dd>
<dt><em class="guilabel">Trigger</em></dt>
<dd>Applies the condition set by the filter.</dd>
<dt><em class="guilabel">Open</em></dt>
<dd>Opens the RevSet dialog. There you can select and/or enter your
condition in a combined way via point-and-click and by typing.</dd>
<dt><em class="guilabel">Delete</em></dt>
<dd>Deletes the selected query.</dd>
<dt><em class="guilabel">Toggle filter</em></dt>
<dd>Applies the filter condition by sowing changesets that don&#8217;t conform
to it in a color suggesting insensitiveness, so the selected ones
stand out more.</dd>
<dt><em class="guilabel">Branch options</em></dt>
<dd>A few options for showing branches.
See <em class="menuselection">Repo Settings ‣ Workbench ‣ Dead Branches</em> for
a method to prune names from this combo box.</dd>
<dt><em class="guilabel">Branches combo</em></dt>
<dd>A combo box with the list of named branches in your repository.</dd>
<dt><em class="guilabel">Custom Filter Combo</em></dt>
<dd>Finally there is a combo box that selects among the various
filter types that can be manually specified.</dd>
</dl>
</div></blockquote>
<p>If the repository tab is previewing incoming changesets, a pair of
buttons are prepended to the start of the filter bar:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Accept</em></dt>
<dd>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.</dd>
<dt><em class="guilabel">Reject</em></dt>
<dd>Reject the changesets from the previewed bundle and exit preview
mode.  This button is only visible when previewing a changeset
bundle.</dd>
</dl>
</div></blockquote>
<p>The Workbench will attempt to lookup the entered search phrase in the
repository to see if it matches a tag, bookmark, branch name, changeset
hash, or revision number.  If no changeset match is found, the Workbench
checks if the search phrase has any parentheses.  If no parentheses are
found, the Workbench assumes the search is a keyword and performs a
<strong class="command">keyword()</strong> revision set search. If parentheses are found, the
Workbench assumes the search phrase is a revision set specification and
attempts to resolve the set.</p>
<p>If you need to perform a keyword search that includes parentheses, use
<strong class="command">keyword(&#8220;PHRASE(FOO)&#8221;)</strong>.</p>
</div>
<div class="section" id="revision-graph-details">
<h2>5.4.7. Revision Graph Details<a class="headerlink" href="#revision-graph-details" title="Permalink to this headline"></a></h2>
<p>The graph column shows the child-parent relationships between revisions
in your repository history.  This column auto-sizes for as many lines of
ancestry that are required to visualize the revisions you have loaded.
The column has an initial hard-limit width to prevent some degenerative
cases from breaking the viewer, but can be resized after refreshes.</p>
</div>
<div class="section" id="performance-implications">
<h2>5.4.8. Performance Implications<a class="headerlink" href="#performance-implications" title="Permalink to this headline"></a></h2>
<p>There are some Workbench features that could have performance implications in
large repositories.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="menuselection">View ‣ Choose Log columns...</em></dt>
<dd>Enabling the <em class="guilabel">Changes</em> column can be expensive to calculate
on repositories with large working copies, causing both refreshes and
scrolling to be slow.</dd>
<dt><em class="menuselection">View ‣ Load all</em></dt>
<dd>Normally, when the user scrolls through the history, chunks of changesets
are read as you scroll. This menu choice allows you to have the Workbench
read all the changesets from the repository, probably allowing smoother
moving through the history.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="revision-context-menus">
<h2>5.4.9. Revision Context Menus<a class="headerlink" href="#revision-context-menus" title="Permalink to this headline"></a></h2>
<p>Right-clicking on revisions in the graph pane brings up a different context menu
when one, two, or more revisions are selected. Context menus can also differ
according to the type of revision(s) (working dir, regular revision,
(un)applied mq patch). Here we give a list of all existing context menu entries.</p>
<p>Right-clicking on a selection of revisions in the (top) graph pane will bring up
the revision context menu.</p>
<dl class="docutils">
<dt>With only one revision selected:</dt>
<dd><div class="first figure">
<img alt="Single revision context menu" src="_images/single-revision-cmenu.png" />
</div>
<dl class="last docutils">
<dt><em class="guilabel">Update...</em></dt>
<dd>Update your working directory to this revision. Opens the
TortoiseHg update dialog with this revision selected.</dd>
<dt><em class="guilabel">Visual diff...</em></dt>
<dd>Open this change in your visual diff tool.</dd>
<dt><em class="guilabel">Diff to local...</em></dt>
<dd>Display changes (visual diff) between this revision and your
current working directory.</dd>
<dt><em class="guilabel">Browse at rev...</em></dt>
<dd>Brings up the Manifest window with the content of all files in the repo
at the selected revision.</dd>
<dt><em class="guilabel">Merge with local...</em></dt>
<dd>Merge the selected changeset with the Working Dir.  Opens the TortoiseHg
merge dialog with this revision selected.</dd>
<dt><em class="guilabel">Tag...</em></dt>
<dd>Allows to manage tags to the selected revision.</dd>
<dt><em class="guilabel">Bookmark...</em></dt>
<dd>Allows to manage bookmarks for the selected revision.
<em>This option requires the boomarks extension to be enabled.</em></dd>
<dt><em class="guilabel">Backout...</em></dt>
<dd>Create a backout changeset for selected revision.</dd>
<dt><em class="guilabel">Export</em></dt>
<dd><dl class="first last docutils">
<dt><em class="guilabel">Export patch</em></dt>
<dd>Generate a patch file containing this revision&#8217;s changes.</dd>
<dt><em class="guilabel">Email patch...</em></dt>
<dd>Send this revision&#8217;s changes to email recipient.  Opens the
TortoiseHg email dialog with this revision selected.</dd>
<dt><em class="guilabel">Archive...</em></dt>
<dd>Open the archive dialog for this revision, allowing user to
generate a backup copy of the repository at that revision.</dd>
<dt><em class="guilabel">Copy patch</em></dt>
<dd>todo
<em>Only visible when MQ is enabled.</em></dd>
</dl>
</dd>
<dt><em class="guilabel">Copy hash</em></dt>
<dd>Copy current revision&#8217;s full hash to the clipboard.</dd>
<dt><em class="guilabel">Modify history</em></dt>
<dd><dl class="first last docutils">
<dt><em class="guilabel">QGoto</em></dt>
<dd>Push/pop patches upto this one
<em>Only visible when MQ is enabled</em></dd>
<dt><em class="guilabel">Import to MQ</em></dt>
<dd>Import selected revision into the current patch queue.  Only
valid for qbase or checked out head revision.  <em>Only visible
when MQ is enabled</em></dd>
<dt><em class="guilabel">Finish patch</em></dt>
<dd>Transforms the MQ patch into a regular changeset.
<em>Only visible when MQ is enabled</em></dd>
<dt><em class="guilabel">Rebase...</em></dt>
<dd>Move the selected revision and all of its descendants onto the
current working parent revision.
<em>Only visible when rebase is enabled</em></dd>
<dt><em class="guilabel">Strip...</em></dt>
<dd>Remove the selected revision and all of its descendants from the
repository <a class="footnote-reference" href="#rcm1" id="id1">[1]</a> <em>Only visible when MQ is enabled</em></dd>
</dl>
</dd>
</dl>
</dd>
<dt>With two revisions selected:</dt>
<dd><dl class="first last docutils">
<dt><em class="guilabel">Visual diff...</em></dt>
<dd>Open this change in your visual diff tool.</dd>
<dt><em class="guilabel">Export selected</em></dt>
<dd>Creates a patch file for each changeset in selected range.</dd>
<dt><em class="guilabel">Email selected...</em></dt>
<dd>Opens email dialog with range of changesets.</dd>
<dt><em class="guilabel">Export DAG range</em></dt>
<dd>Creates a patch file for each changeset in selected range.</dd>
<dt><em class="guilabel">Email DAG range...</em></dt>
<dd>Opens email dialog with range of changesets.</dd>
<dt><em class="guilabel">Bisect - Good, Bad...</em></dt>
<dd>todo
See <a class="reference external" href="#id10">bisect</a> section below.</dd>
<dt><em class="guilabel">Bisect - Bad, Good...</em></dt>
<dd>todo
See <a class="reference external" href="#id10">bisect</a> section below.</dd>
<dt><em class="guilabel">Compress history...</em></dt>
<dd>Brings up a dialog where you can compress the youngest changeset into
the older one.</dd>
</dl>
</dd>
<dt>With more than two revisions selected:</dt>
<dd><dl class="first last docutils">
<dt><em class="guilabel">Export selected</em></dt>
<dd>Creates a patch file for each changeset in selected range.</dd>
<dt><em class="guilabel">Email selected...</em></dt>
<dd>Opens email dialog with range of changesets.</dd>
</dl>
</dd>
</dl>
<table class="docutils footnote" frame="void" id="rcm1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>The strip command will store the stripped revisions in a bundle file
that can later be reapplied.
See also <a class="reference external" href="http://mercurial.selenic.com/wiki/EditingHistory">EditingHistory</a>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="file-context-menus">
<h2>5.4.10. File Context Menus<a class="headerlink" href="#file-context-menus" title="Permalink to this headline"></a></h2>
<p>Right-clicking on filenames in the file list pane (bottom left of the RevDetails
and Manifest task tabs) will bring up a context menu for the selected file:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Visual Diff</em></dt>
<dd>Open this revision of the file in your visual diff tool.</dd>
<dt><em class="guilabel">Visual Diff to Local</em></dt>
<dd>Visualize differences between this revision and your checked
out version.</dd>
<dt><em class="guilabel">View at Revision</em></dt>
<dd>Open this revision of the file in your visual editor <a class="footnote-reference" href="#flcm1" id="id3">[2]</a>.</dd>
<dt><em class="guilabel">Edit Local</em></dt>
<dd>Open the checked out version of the file in your visual editor <a class="footnote-reference" href="#flcm1" id="id4">[2]</a>.</dd>
<dt><em class="guilabel">Revert to Revision</em></dt>
<dd>Checkout this specific revision of this file <a class="footnote-reference" href="#flcm3" id="id5">[4]</a>.</dd>
<dt><em class="guilabel">File History</em></dt>
<dd>Show revisions that modified this file <a class="footnote-reference" href="#flcm2" id="id6">[3]</a>.</dd>
<dt><em class="guilabel">Compare file revisions</em></dt>
<dd>Brings up a new dialog where you can compare any revision of the file
with any other revision in the history.</dd>
</dl>
</div></blockquote>
<table class="docutils footnote" frame="void" id="flcm1" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[2]</td><td><em>(<a class="fn-backref" href="#id3">1</a>, <a class="fn-backref" href="#id4">2</a>)</em> <em class="menuselection">Global Settings ‣ TortoiseHg ‣ Visual Editor</em></td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="flcm2" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id6">[3]</a></td><td>Does not show revisions where a file was deleted, as this is only a
manifest change, it does not modify the file&#8217;s history.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="flcm3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id5">[4]</a></td><td>The new contents will appear as local changes and must be committed.</td></tr>
</tbody>
</table>
<p>Right-clicking on filenames in the file list pane of the Commit task tab will
bring up a different context menu for the selected file:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Edit</em></dt>
<dd>Open this revision of the file in your visual diff tool.</dd>
<dt><em class="guilabel">Add</em></dt>
<dd>Add this file to the repository for versioning.</dd>
<dt><em class="guilabel">Detect Renames...</em></dt>
<dd>Brings up a dialog where you can try to detect renamed files.</dd>
<dt><em class="guilabel">Ignore</em></dt>
<dd>Adds the selected file to the .hgignore content.</dd>
<dt><em class="guilabel">Delete unversioned</em></dt>
<dd>Deletes unversioned files from disk.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="message-parsing">
<h2>5.4.11. Message Parsing<a class="headerlink" href="#message-parsing" title="Permalink to this headline"></a></h2>
<p>The changeset display pane will detect and underline changeset hashes,
HTTP(s) URLs, and bug report identifiers inside changeset messages.
These underlined phrases are clickable links.</p>
<p>Every word-boundary delimited string of 12 or 40 characters from the
range [0-9a-f] is considered a changeset link. Clicking on it in the
repository explorer will jump to the given changeset if possible.</p>
<p>HTTP and HTTPS URLs are similarly turned into clickable links which are
opened in your default web browser.</p>
<p>Issue tracker links are enabled when configured in the tortoisehg
section of your configuration files.  Since only a single issue tracker
can be configured at a time, it is typically configured in the
repository&#8217;s <tt class="file docutils literal"><span class="pre">.hg/hgrc</span></tt> file.  There are two keys: issue.regex and
issue.link. The first defines the regex to match when picking up issue
numbers, while the second defines the command to run when an issue
number is recognized.</p>
<p>You may include groups in issue.regex, and corresponding {n} tokens in
issue.link (where n is a non-negative integer). {0} refers to the entire
string matched by issue.regex, while {1} refers to the first group and
so on. If no {n} tokens are found in issue.link, the entire matched
string is appended instead.</p>
<p>Examples:</p>
<div class="highlight-python"><pre>BitBucket:
issue.regex = #(\d+)\b
issue.link = https://bitbucket.org/&lt;your project and repo&gt;/issue/{1}/

Mercurial:
issue.regex = \bissue\d+\b
issue.link = http://mercurial.selenic.com/bts/</pre>
</div>
</div>
<div class="section" id="output-log-console">
<h2>5.4.12. Output Log Console<a class="headerlink" href="#output-log-console" title="Permalink to this headline"></a></h2>
<p>The console built into the Workbench Output Log dock widget can run
Mercurial (hg) commands, TortoiseHg (thg) commands, a couple special
commands, and limited shell commands.  Commands are always executed in
the root of the current repository.  The prompt is updated to keep you
aware of the context.</p>
<p>If the command line begins with &#8216;hg&#8217;, the Mercurial command is run in
TortoiseHg&#8217;s execution environment; meaning output is sent to the log
widget and input requests are handled by dialog windows.</p>
<p>If the command line begins with &#8216;thg&#8217;, the requested command is run in a
new window but in the same process.  For instance &#8216;thg ci&#8217; will open a
new commit tool window for the current repository.</p>
<p>It the command is &#8216;clear&#8217; (or &#8216;cls&#8217;), the output log contents are
erased.</p>
<p>If the command is &#8216;exit&#8217;, the output log window is closed.</p>
<p>Otherwise, the command line is forwarded to your platform&#8217;s default
command shell with a limited execution context.  There is no stdin while
stdout and stderr are piped to the output log.</p>
</div>
<div class="section" id="keyboard-navigation">
<h2>5.4.13. Keyboard navigation<a class="headerlink" href="#keyboard-navigation" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt><tt class="kbd docutils literal"><span class="pre">Ctrl-P</span></tt></dt>
<dd>Zoom to the working directory parent revision</dd>
<dt><tt class="kbd docutils literal"><span class="pre">Ctrl-D</span></tt></dt>
<dd>Display visual diffs for selected changeset or file</dd>
<dt><tt class="kbd docutils literal"><span class="pre">Ctrl-S</span></tt></dt>
<dd>Toggle revision set / filter toolbar</dd>
</dl>
<p>See also <a class="reference external" href="https://bitbucket.org/tortoisehg/thg/wiki/KeySequences">KeySequences</a>
on the wiki pages.</p>
</div>
<div class="section" id="configurables">
<h2>5.4.14. Configurables<a class="headerlink" href="#configurables" title="Permalink to this headline"></a></h2>
<p>The Workbench has a few configurable options that can be set in
the TortoiseHg Settings dialog on the Workbench tab.</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Author coloring</em></dt>
<dd>If true, each author&#8217;s changeset will be given a unique color</dd>
<dt><em class="guilabel">Long Summary</em></dt>
<dd>Concatenate commit message lines until 80 chars are reached</dd>
<dt><em class="guilabel">Graph batch limit</em></dt>
<dd>Number of revisions to read in each batch load</dd>
<dt><em class="guilabel">Dead Branches</em></dt>
<dd>Comma separated list of branch names that should be ignored
when building a list of branch names for a repository.</dd>
<dt><em class="guilabel">Branch Colors</em></dt>
<dd>Space separated list of branch names and colors on the
form branch:#XXXXXX. Spaces and colons in the branch name must be
escaped using a backslash (\). Likewise some other characters
can be escaped in this way, e.g. \u0040 will be decoded to the
&#64; character, and \n to a linefeed.</dd>
<dt><em class="guilabel">Hide Tags</em></dt>
<dd>Space separated list of tags that will not be shown.  Useful
example: Specify &#8220;qbase qparent qtip&#8221; to hide the standard tags
inserted by the Mercurial Queues Extension.</dd>
</dl>
</div></blockquote>
<p>The exact colors given to particular users can be configured by adding
lines like these to your <tt class="file docutils literal"><span class="pre">Mercurial.ini</span></tt> file:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="p">[</span><span class="n">tortoisehg</span><span class="p">]</span>
<span class="n">authorcolor</span><span class="o">.</span><span class="n">USERNAME</span> <span class="o">=</span> <span class="n">color</span>
</pre></div>
</div>
<p>The Workbench also respects the following settings on the
TortoiseHg tab:</p>
<blockquote>
<div><dl class="docutils">
<dt><em class="guilabel">Tab Width</em></dt>
<dd>Number of spaces to expand tabs in diffs</dd>
<dt><em class="guilabel">Max Diff Size</em></dt>
<dd>Maximum size of file to be diffed</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="from-command-line">
<h2>5.4.15. From command line<a class="headerlink" href="#from-command-line" title="Permalink to this headline"></a></h2>
<p>The Workbench can be started from command line</p>
<div class="highlight-python"><pre>thg log [OPTIONS] [FILE]

aliases: history, explorer, workbench

workbench application

use "thg -v help log" to show global options</pre>
</div>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
            <p class="logo"><a href="index.html">
              <img class="logo" src="_static/thg_logo_92x50.png" alt="Logo"/>
            </a></p>
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">5.4. Workbench</a><ul>
<li><a class="reference internal" href="#workbench-menus">5.4.1. Workbench Menus</a></li>
<li><a class="reference internal" href="#edit-toolbar">5.4.2. Edit Toolbar</a></li>
<li><a class="reference internal" href="#dock-toolbar">5.4.3. Dock Toolbar</a></li>
<li><a class="reference internal" href="#sync-toolbar">5.4.4. Sync Toolbar</a></li>
<li><a class="reference internal" href="#task-toolbar">5.4.5. Task Toolbar</a></li>
<li><a class="reference internal" href="#filter-toolbar">5.4.6. Filter Toolbar</a></li>
<li><a class="reference internal" href="#revision-graph-details">5.4.7. Revision Graph Details</a></li>
<li><a class="reference internal" href="#performance-implications">5.4.8. Performance Implications</a></li>
<li><a class="reference internal" href="#revision-context-menus">5.4.9. Revision Context Menus</a></li>
<li><a class="reference internal" href="#file-context-menus">5.4.10. File Context Menus</a></li>
<li><a class="reference internal" href="#message-parsing">5.4.11. Message Parsing</a></li>
<li><a class="reference internal" href="#output-log-console">5.4.12. Output Log Console</a></li>
<li><a class="reference internal" href="#keyboard-navigation">5.4.13. Keyboard navigation</a></li>
<li><a class="reference internal" href="#configurables">5.4.14. Configurables</a></li>
<li><a class="reference internal" href="#from-command-line">5.4.15. From command line</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="nautilus.html"
                        title="previous chapter">5.3. GNOME desktop integration</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="init.html"
                        title="next chapter">5.5. Create a new repository</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="_sources/workbench.txt"
           rel="nofollow">Show Source</a></li>
  </ul>
<div id="searchbox" style="display: none">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="init.html" title="5.5. Create a new repository"
             >next</a> |</li>
        <li class="right" >
          <a href="nautilus.html" title="5.3. GNOME desktop integration"
             >previous</a> |</li>
        <li><a href="index.html">TortoiseHg 2.4.0 documentation</a> &raquo;</li>
          <li><a href="daily.html" >5. TortoiseHg in daily use</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; Copyright 2012, Steve Borho and others.
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
    </div>
  </body>
</html>