<!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="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>5.2. Windows Explorer Integration — 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" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></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>
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="5.3. GNOME desktop integration" href="nautilus.html" />
<link rel="prev" title="5.1. Common Features" href="common.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>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="module-explorer">
<span id="windows-explorer-integration"></span><h1>5.2. Windows Explorer Integration<a class="headerlink" href="#module-explorer" title="Permalink to this headline">¶</a></h1>
<div class="section" id="context-menus">
<span id="explorer-context-label"></span><h2>5.2.1. Context Menus<a class="headerlink" href="#context-menus" title="Permalink to this headline">¶</a></h2>
<p>TortoiseHg commands may be accessed via the context menu of Explorer
windows and other applications which use the standard File/Open dialogs.
Here is the context menu for a revisioned folder:</p>
<div class="figure" id="id1">
<img alt="Context menu" src="_images/cmenu-nofiles.png" />
<p class="caption"><span class="caption-text">Context menu for a folder under Mercurial revision control</span></p>
</div>
<p>And here is the context menu for selected files or folders:</p>
<div class="figure" id="id2">
<img alt="Context menu" src="_images/cmenu-files.png" />
<p class="caption"><span class="caption-text">Context menu for file or folder selection</span></p>
</div>
<p>TortoiseHg provides dialogs for the most regularly used Mercurial
commands. Less frequently used and newly added Mercurial commands
may be accessed from the CLI (command line interface) through
<code class="file docutils literal notranslate"><span class="pre">cmd.exe</span></code> on Windows.</p>
</div>
<div class="section" id="overlay-icons">
<h2>5.2.2. Overlay Icons<a class="headerlink" href="#overlay-icons" title="Permalink to this headline">¶</a></h2>
<p>TortoiseHg provides visual representation of the file status via overlay
icons in the MS-Explorer windows. This is similar to those that found on
other Tortoise client, such as TortoiseCVS and TortoiseSVN.</p>
<p>TortoiseHg shares the overlay icons with TortoiseSVN (version 1.5.x or
later) and the other “Tortoise” projects via the use of TortoiseOverlays
(another project created by TortoiseSVN team).</p>
<div class="figure" id="id3">
<img alt="Overlay icons" src="_images/overlayicons.png" />
<p class="caption"><span class="caption-text">Overlay icons in Icons view (XP)</span></p>
</div>
<p>The context menu has an <span class="guilabel">Update Icons</span> option which forces
TortoiseHg to refresh the icons in the currently browsed repository or
directory of repositories. The taskbar icon will turn green and the
directory icons will turn into question marks while this refresh is in
progress.</p>
</div>
<div class="section" id="shell-configuration">
<h2>5.2.3. Shell Configuration<a class="headerlink" href="#shell-configuration" title="Permalink to this headline">¶</a></h2>
<p>The overlay handler and context menus are configurable. From any folder
background (even the desktop), right click and select
<span class="menuselection">TortoiseHg ‣ Explorer Extension Settings</span>. This opens the
Explorer Extension Settings dialog.</p>
<p>On the tab “Context Menu” you can promote individual menu options to the
top level menu.</p>
<div class="figure" id="id4">
<img alt="Explorer Extension Settings dialog, Context Menu tab" src="_images/shell-config-cmenu.png" />
<p class="caption"><span class="caption-text">Explorer Extension Settings Dialog, Context Menu tab</span></p>
</div>
<p>On the “Icons” tab you configure settings related to the overlay icons and the
icon of the “Overlay Icons Server” in the taskbar (in the notification area of
Windows).</p>
<div class="figure" id="id5">
<img alt="Explorer Extension Settings dialog, Icons tab" src="_images/shell-config-icons.png" />
<p class="caption"><span class="caption-text">Explorer Extension Settings Dialog, Icons tab</span></p>
</div>
<dl class="docutils">
<dt><span class="guilabel">Enable overlays:</span></dt>
<dd>If checked, overlay icons are shown on folders and files in the
working directory (woking copy) of Mercurial repositories.
(Default: checked)</dd>
<dt><span class="guilabel">Local disks only:</span></dt>
<dd>If checked, overlay icons are only shown for volumes on local disks, not
on network shares. Scanning for Mercurial repositories over the network
may result in high latency in the user interface of explorer. Check this
option if browsing network shares becomes too slow and/or you do not need
overlay icons on non-local volumes.
(Default: not checked)</dd>
<dt><span class="guilabel">Enabled Overlay Handlers:</span></dt>
<dd>These (per user) settings provide the possibility to disable overlay
icon handlers in the shared TortoiseOverlays component.
The TortoiseOverlays component is shared by all Tortoises (TortoiseHg,
TortoiseSVN, etc), with the goal to avoid registering too many icon slots,
by using a common set of icons slots for all Tortoises (thus using the
same set of icons for all Tortoises).
The total number of overlay slots available on Windows is fairly limited and
depends on the exact Windows version. For example, on a pristine install
of Windows 7, there are only 8 free overlay handler slots available.
This section allows to disable certain non-essential overlay
handlers, to reduce icon handler slot consumption by the TortoiseOverlays
component. Unchecking handlers in this section increases the chances that
important handlers like “Normal” (green checkmark) or “Modifed” (red
exclamation mark) will still get an icon slot, even if there are too many
handlers registered on a computer.
Unchecking handlers that are not used by TortoiseHg (that is: Locked,
Readonly, Ignored, Deleted) is highly recommended, if you know that no
other Tortoises (e.g. TortoiseSVN) uses them.
Make sure the “Added” and “Unversioned” handlers are enabled, as these
are used by TortoiseHg.
(Default: all checked)</dd>
</dl>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">The “Enabled Overlay Handlers” settings affect all Tortoises for a user.
A logoff/login is required to make changes in that section effective.</p>
</div>
<dl class="docutils">
<dt><span class="guilabel">Taskbar:</span></dt>
<dd>Checkmark “Show Icon” to show the icon of the Overlay Icon Server in the
taskbar in the notification area. “Highlight Icon” highlights that icon
using a light green color while the icon server is busy updating cache files
in the repository (files <code class="file docutils literal notranslate"><span class="pre">.hg\dirstate</span></code> and <code class="file docutils literal notranslate"><span class="pre">.hg\thgstatus</span></code>).
(Default: both checked)</dd>
</dl>
<p>One can selectively disable overlay icons in a specific repository by
editing the <code class="file docutils literal notranslate"><span class="pre">.hg\thgstatus</span></code> file inside the repository and
replacing its contents with a single line containing:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">@</span><span class="nd">@noicons</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>
<h1 class="logo"><a href="index.html">TortoiseHg</a></h1>
<h3>Navigation</h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="preface.html">1. Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="intro.html">2. Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatsnew.html">3. What’s New</a></li>
<li class="toctree-l1"><a class="reference internal" href="quick.html">4. A Quick Start Guide to TortoiseHg</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="daily.html">5. TortoiseHg in daily use</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="common.html">5.1. Common Features</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">5.2. Windows Explorer Integration</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#context-menus">5.2.1. Context Menus</a></li>
<li class="toctree-l3"><a class="reference internal" href="#overlay-icons">5.2.2. Overlay Icons</a></li>
<li class="toctree-l3"><a class="reference internal" href="#shell-configuration">5.2.3. Shell Configuration</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="nautilus.html">5.3. GNOME desktop integration</a></li>
<li class="toctree-l2"><a class="reference internal" href="workbench.html">5.4. Workbench</a></li>
<li class="toctree-l2"><a class="reference internal" href="init.html">5.5. Create a new repository</a></li>
<li class="toctree-l2"><a class="reference internal" href="clone.html">5.6. Clone a repository</a></li>
<li class="toctree-l2"><a class="reference internal" href="commit.html">5.7. Commit</a></li>
<li class="toctree-l2"><a class="reference internal" href="shelve.html">5.8. Shelve</a></li>
<li class="toctree-l2"><a class="reference internal" href="sync.html">5.9. Synchronize</a></li>
<li class="toctree-l2"><a class="reference internal" href="serve.html">5.10. Serve</a></li>
<li class="toctree-l2"><a class="reference internal" href="guess.html">5.11. Detect Renames</a></li>
<li class="toctree-l2"><a class="reference internal" href="ignore.html">5.12. Ignore Filter</a></li>
<li class="toctree-l2"><a class="reference internal" href="archive.html">5.13. Archiving</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="settings.html">6. Settings</a></li>
<li class="toctree-l1"><a class="reference internal" href="patches.html">7. Patches</a></li>
<li class="toctree-l1"><a class="reference internal" href="extensions.html">8. Extensions</a></li>
<li class="toctree-l1"><a class="reference internal" href="nonhg.html">9. Use with other VCS systems</a></li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">10. Frequently Asked Questions</a></li>
<li class="toctree-l1"><a class="reference internal" href="debugging.html">11. Debugging</a></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="common.html" title="previous chapter">5.1. Common Features</a></li>
<li>Next: <a href="nautilus.html" title="next chapter">5.3. GNOME desktop integration</a></li>
</ul></li>
</ul></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<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>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©2010-2019, Steve Borho and others.
|
Powered by <a href="http://sphinx-doc.org/">Sphinx 1.8.4</a>
& <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
|
<a href="_sources/explorer.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
67810d03ada515381702f7b70888f800
>
files
>
500
