<!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 — TortoiseHg 4.7.0 documentation</title> <link rel="stylesheet" href="_static/tortoisehg.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: './', VERSION: '4.7.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="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="top" title="TortoiseHg 4.7.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" /> <link rel="stylesheet" href="_static/custom.css" type="text/css" /> <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" /> </head> <body role="document"> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <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" id="id7"> <img alt="Workbench" src="_images/workbench.png" /> <p class="caption"><span class="caption-text">Workbench dialog.</span></p> </div> <p>Workbench Main Widgets are:</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Revision History View</span></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 <span class="menuselection">View ‣ Choose Log Columns...</span>, and there you can reorder the columns too. This is the main or central widget of the Workbench application.</dd> <dt><span class="guilabel">Repository Registry</span></dt> <dd>This widget, by default shown on the left, allows to manage multiple repositories from the Workbench. You can show/hide it via <span class="menuselection">View ‣ Show Repo Registry</span> or with the corresponding button in the Dock Toolbar. It’s also a dockable widget. The <span class="menuselection">View ‣ Show Paths</span> menu option allows to not only view the names of the repositories but also their path in a second column.</dd> <dt><span class="guilabel">Output Log</span></dt> <dd>This dockable widget, which can be shown/hidden with <span class="menuselection">View ‣ Show Output Log</span>, 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><span class="guilabel">Task Tabs</span></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><span class="guilabel">File</span></dt> <dd><p class="first">Handle repositories and settings.</p> <div class="last figure" id="id8"> <img alt="File menu" src="_images/file-menu.png" /> <p class="caption"><span class="caption-text">File Menu</span></p> </div> </dd> <dt><span class="guilabel">View</span></dt> <dd><p class="first">Manage the visibility of various parts of the Workbench.</p> <div class="last figure" id="id9"> <img alt="View menu" src="_images/view-menu.png" /> <p class="caption"><span class="caption-text">View menu</span></p> </div> </dd> </dl> </div></blockquote> <blockquote id="workbench-repository-label"> <div><dl class="docutils"> <dt><span class="guilabel">Repository</span></dt> <dd><p class="first">Perform special actions on the active repository.</p> <div class="last figure" id="id10"> <img alt="Repository menu" src="_images/repository-menu.png" /> <p class="caption"><span class="caption-text">Repository menu</span></p> </div> </dd> <dt><span class="guilabel">Help</span></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" id="id11"> <img alt="Edit Toolbar" src="_images/edit-toolbar.png" /> <p class="caption"><span class="caption-text">Edit toolbar</span></p> </div> <p>Moving around in the revision history. All the buttons work on the current repository.</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Refresh</span></dt> <dd>Reload the revision history of the current repository.</dd> <dt><span class="guilabel">Back</span></dt> <dd>Go back to the previously selected revision.</dd> <dt><span class="guilabel">Forward</span></dt> <dd>Go forward to the next revision in your selection history or most recent revision set query.</dd> <dt><span class="guilabel">Filter toolbar</span></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" id="id12"> <img alt="Dock Toolbar" src="_images/dock-toolbar.png" /> <p class="caption"><span class="caption-text">Dock toolbar</span></p> </div> <p>Show or hide some main widgets in the Workbench.</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Show Repository Registry</span></dt> <dd>Show/hide the Repository Registry widget.</dd> <dt><span class="guilabel">Show Output Log</span></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" id="id13"> <img alt="Sync Toolbar" src="_images/sync-toolbar.png" /> <p class="caption"><span class="caption-text">Sync toolbar</span></p> </div> <p>Synchronize your repository with other repositories.</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Incoming</span></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 <span class="guilabel">Accept</span> and <span class="guilabel">Reject</span> are then shown at the top of the revision graph.</dd> <dt><span class="guilabel">Pull</span></dt> <dd>Pull incoming changesets from the remote repository, then apply after-pull effect (update, fetch, or rebase).</dd> <dt><span class="guilabel">Outgoing</span></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><span class="guilabel">Push</span></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" id="id14"> <img alt="Task Toolbar" src="_images/task-toolbar.png" /> <p class="caption"><span class="caption-text">Task toolbar</span></p> </div> <p>Work with the various task tabs.</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Revision Details</span></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><span class="guilabel">Commit</span></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><span class="guilabel">Search</span></dt> <dd>For performing text searches through file content.</dd> </dl> </div></blockquote> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Synchronize</span></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> <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 <code class="kbd docutils literal"><span class="pre">ALT-Click</span></code> 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" id="id15"> <img alt="Filter Toolbar" src="_images/filter-toolbar.png" /> <p class="caption"><span class="caption-text">Filter features for the Workbench.</span></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="https://www.mercurial-scm.org/doc/hg.1.html#revsets">hg.1.html#revsets</a> for details on how to specify revision sets. The toolbar can be toggled with <code class="kbd docutils literal"><span class="pre">Ctrl-S</span></code>. Parts from left to right:</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Clear</span></dt> <dd>Clears the search lineedit. Essentially disables all filters.</dd> <dt><span class="guilabel">Filter entry</span></dt> <dd>Here you can type a filtering condition. The widget is a combobox, holding a history of previous filtering conditions.</dd> <dt><span class="guilabel">Trigger</span></dt> <dd>Applies the condition set by the filter.</dd> <dt><span class="guilabel">Open</span></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><span class="guilabel">Delete</span></dt> <dd>Deletes the selected query.</dd> <dt><span class="guilabel">Toggle filter</span></dt> <dd>Applies the filter condition by sowing changesets that don’t conform to it in a color suggesting insensitiveness, so the selected ones stand out more.</dd> <dt><span class="guilabel">Branch options</span></dt> <dd>A few options for showing branches. See <span class="menuselection">Repo Settings ‣ Workbench ‣ Dead Branches</span> for a method to prune names from this combo box.</dd> <dt><span class="guilabel">Branches combo</span></dt> <dd>A combo box with the list of named branches in your repository.</dd> <dt><span class="guilabel">Custom Filter Combo</span></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><span class="guilabel">Accept</span></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><span class="guilabel">Reject</span></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("PHRASE(FOO)")</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><span class="menuselection">View ‣ Choose Log columns...</span></dt> <dd>Enabling the <span class="guilabel">Changes</span> column can be expensive to calculate on repositories with large working copies, causing both refreshes and scrolling to be slow.</dd> <dt><span class="menuselection">View ‣ Load all</span></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><span class="guilabel">Update...</span></dt> <dd>Update your working directory to this revision. Opens the TortoiseHg update dialog with this revision selected.</dd> <dt><span class="guilabel">Diff to Parent</span></dt> <dd>Open this change in your visual diff tool.</dd> <dt><span class="guilabel">Diff to Local</span></dt> <dd>Display changes (visual diff) between this revision and your current working directory.</dd> <dt><span class="guilabel">Browse at Revision</span></dt> <dd>Brings up the Manifest window with the content of all files in the repo at the selected revision.</dd> <dt><span class="guilabel">Similar Revisions...</span></dt> <dd>Open the TortoiseHg dialog to search for similar revisions.</dd> <dt><span class="guilabel">Merge with local...</span></dt> <dd>Merge the selected changeset with the Working Dir. Opens the TortoiseHg merge dialog with this revision selected.</dd> <dt><span class="guilabel">Tag...</span></dt> <dd>Allows to manage tags to the selected revision.</dd> <dt><span class="guilabel">Bookmark...</span></dt> <dd>Allows to manage bookmarks for the selected revision.</dd> <dt><span class="guilabel">Backout...</span></dt> <dd>Create a backout changeset for selected revision.</dd> <dt><span class="guilabel">Copy Hash</span></dt> <dd><p class="first">Copies the revision hash to the clipboard. Copy current revision’s full hash to the clipboard.</p> <p class="last">Under X11, the short changeset hash is automatically copied to the primary selection when the revision is clicked, you paste it by pressing the middle mouse button.</p> </dd> <dt><span class="guilabel">Export</span></dt> <dd><dl class="first last docutils"> <dt><span class="guilabel">Export Patch...</span></dt> <dd>Generate a patch file containing this revision’s changes.</dd> <dt><span class="guilabel">Email Patch...</span></dt> <dd>Send this revision’s changes to email recipient. Opens the TortoiseHg email dialog with this revision selected.</dd> <dt><span class="guilabel">Archive...</span></dt> <dd>Open the archive dialog for this revision, allowing user to generate a backup copy of the repository at that revision.</dd> <dt><span class="guilabel">Bundle Rev and Descendants...</span></dt> <dd>Open a dialog for exporting this revision and its descendants to a bundle file.</dd> <dt><span class="guilabel">Copy Patch</span></dt> <dd>Copies this revision’s changes to the clipboard. <em>Only visible when MQ is enabled.</em></dd> </dl> </dd> <dt><span class="guilabel">Change Phase to</span></dt> <dd><dl class="first last docutils"> <dt><span class="guilabel">public</span></dt> <dd>Change the phase of this revision to public.</dd> <dt><span class="guilabel">draft</span></dt> <dd>Change the phase of this revision to draft.</dd> <dt><span class="guilabel">secret</span></dt> <dd>Change the phase of this revision to secret.</dd> </dl> </dd> <dt><span class="guilabel">Graft to Local...</span></dt> <dd>Open the graft dialog to copy the selected revision.</dd> <dt><span class="guilabel">Modify history</span></dt> <dd><dl class="first last docutils"> <dt><span class="guilabel">Unapply Patch</span></dt> <dd>Pop patches upto this one <em>Only visible when MQ is enabled</em></dd> <dt><span class="guilabel">Import to MQ</span></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><span class="guilabel">Finish patch</span></dt> <dd>Transforms the MQ patch into a regular changeset. <em>Only visible when MQ is enabled</em></dd> <dt><span class="guilabel">Rename Patch...</span></dt> <dd>Renames the MQ patch file. <em>Only visible when MQ is enabled</em></dd> <dt><span class="guilabel">MQ Options</span></dt> <dd>Open the MQ options dialog. <em>Only visible when MQ is enabled</em></dd> <dt><span class="guilabel">Rebase...</span></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><span class="guilabel">Prune...</span></dt> <dd>Mark the selected revision as obsolete. <em>Only visible when evolve is enabled</em></dd> <dt><span class="guilabel">Strip...</span></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><span class="guilabel">Visual diff...</span></dt> <dd>Open this change in your visual diff tool.</dd> <dt><span class="guilabel">Export selected</span></dt> <dd>Creates a patch file for each changeset in selected range.</dd> <dt><span class="guilabel">Email selected...</span></dt> <dd>Opens email dialog with range of changesets.</dd> <dt><span class="guilabel">Export DAG range</span></dt> <dd>Creates a patch file for each changeset in selected range.</dd> <dt><span class="guilabel">Email DAG range...</span></dt> <dd>Opens email dialog with range of changesets.</dd> <dt><span class="guilabel">Bisect - Good, Bad...</span></dt> <dd>todo See <a class="reference external" href="#id10">bisect</a> section below.</dd> <dt><span class="guilabel">Bisect - Bad, Good...</span></dt> <dd>todo See <a class="reference external" href="#id10">bisect</a> section below.</dd> <dt><span class="guilabel">Compress history...</span></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><span class="guilabel">Export selected</span></dt> <dd>Creates a patch file for each changeset in selected range.</dd> <dt><span class="guilabel">Email selected...</span></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="https://www.mercurial-scm.org/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 task tab) will bring up a context menu for the selected file:</p> <blockquote> <div><dl class="docutils"> <dt><span class="guilabel">Visual Diff</span></dt> <dd>Open this revision of the file in your visual diff tool.</dd> <dt><span class="guilabel">Visual Diff to Local</span></dt> <dd>Visualize differences between this revision and your checked out version.</dd> <dt><span class="guilabel">View at Revision</span></dt> <dd>Open this revision of the file in your visual editor <a class="footnote-reference" href="#flcm1" id="id3">[2]</a>.</dd> <dt><span class="guilabel">Edit Local</span></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><span class="guilabel">Revert to Revision</span></dt> <dd>Checkout this specific revision of this file <a class="footnote-reference" href="#flcm3" id="id5">[4]</a>.</dd> <dt><span class="guilabel">File History</span></dt> <dd>Show revisions that modified this file <a class="footnote-reference" href="#flcm2" id="id6">[3]</a>.</dd> <dt><span class="guilabel">Compare file revisions</span></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> <span class="menuselection">Global Settings ‣ TortoiseHg ‣ Visual Editor</span></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’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><span class="guilabel">Edit</span></dt> <dd>Open this revision of the file in your visual diff tool.</dd> <dt><span class="guilabel">Add</span></dt> <dd>Add this file to the repository for versioning.</dd> <dt><span class="guilabel">Detect Renames...</span></dt> <dd>Brings up a dialog where you can try to detect renamed files.</dd> <dt><span class="guilabel">Ignore</span></dt> <dd>Adds the selected file to the .hgignore content.</dd> <dt><span class="guilabel">Delete unversioned</span></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’s <code class="file docutils literal"><span class="pre">.hg/hgrc</span></code> 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-default"><div class="highlight"><pre><span></span>BitBucket: issue.regex = #(\d+)\b issue.link = https://bitbucket.org/<your project and repo>/issue/{1}/ Mercurial: issue.regex = \bissue(\d+)\b issue.link = https://bz.mercurial-scm.org/show_bug.cgi?id={1} </pre></div> </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 ‘hg’, the Mercurial command is run in TortoiseHg’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 ‘thg’, the requested command is run in a new window but in the same process. For instance ‘thg ci’ will open a new commit tool window for the current repository.</p> <p>It the command is ‘clear’ (or ‘cls’), the output log contents are erased.</p> <p>If the command is ‘exit’, the output log window is closed.</p> <p>Otherwise, the command line is forwarded to your platform’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><code class="kbd docutils literal"><span class="pre">Ctrl-P</span></code></dt> <dd>Zoom to the working directory parent revision</dd> <dt><code class="kbd docutils literal"><span class="pre">Ctrl-D</span></code></dt> <dd>Display visual diffs for selected changeset or file</dd> <dt><code class="kbd docutils literal"><span class="pre">Ctrl-S</span></code></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><span class="guilabel">Author coloring</span></dt> <dd>If true, each author’s changeset will be given a unique color</dd> <dt><span class="guilabel">Long Summary</span></dt> <dd>Concatenate commit message lines until 80 chars are reached</dd> <dt><span class="guilabel">Graph batch limit</span></dt> <dd>Number of revisions to read in each batch load</dd> <dt><span class="guilabel">Dead Branches</span></dt> <dd>Comma separated list of branch names that should be ignored when building a list of branch names for a repository.</dd> <dt><span class="guilabel">Branch Colors</span></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 @ character, and \n to a linefeed.</dd> <dt><span class="guilabel">Hide Tags</span></dt> <dd>Space separated list of tags that will not be shown. Useful example: Specify “qbase qparent qtip” 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 <code class="file docutils literal"><span class="pre">Mercurial.ini</span></code> file:</p> <div class="highlight-default"><div class="highlight"><pre><span></span><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><span class="guilabel">Tab Width</span></dt> <dd>Number of spaces to expand tabs in diffs</dd> <dt><span class="guilabel">Max Diff Size</span></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-default"><div class="highlight"><pre><span></span><span class="n">thg</span> <span class="n">log</span> <span class="p">[</span><span class="n">OPTIONS</span><span class="p">]</span> <span class="p">[</span><span class="n">FILE</span><span class="p">]</span> <span class="n">aliases</span><span class="p">:</span> <span class="n">history</span><span class="p">,</span> <span class="n">explorer</span><span class="p">,</span> <span class="n">workbench</span> <span class="n">workbench</span> <span class="n">application</span> <span class="n">use</span> <span class="s2">"thg -v help log"</span> <span class="n">to</span> <span class="n">show</span> <span class="k">global</span> <span class="n">options</span> </pre></div> </div> </div> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <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> <div class="relations"> <h3>Related Topics</h3> <ul> <li><a href="index.html">Documentation overview</a><ul> <li><a href="daily.html">5. TortoiseHg in daily use</a><ul> <li>Previous: <a href="nautilus.html" title="previous chapter">5.3. GNOME desktop integration</a></li> <li>Next: <a href="init.html" title="next chapter">5.5. Create a new repository</a></li> </ul></li> </ul></li> </ul> </div> <div role="note" aria-label="source link"> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="_sources/workbench.txt" rel="nofollow">Show Source</a></li> </ul> </div> <div id="searchbox" style="display: none" role="search"> <h3>Quick search</h3> <form class="search" action="search.html" method="get"> <div><input type="text" name="q" /></div> <div><input type="submit" value="Go" /></div> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="footer"> ©2010-2018, Steve Borho and others. | Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.9</a> & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a> | <a href="_sources/workbench.txt" rel="nofollow">Page source</a> </div> </body> </html>