Source

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

Full commit


<!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>10. Frequently Asked Questions &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="next" title="11. Debugging" href="debugging.html" />
    <link rel="prev" title="9. Use with other VCS systems" href="nonhg.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="debugging.html" title="11. Debugging"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="nonhg.html" title="9. Use with other VCS systems"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">TortoiseHg 2.4.0 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="frequently-asked-questions">
<h1>10. Frequently Asked Questions<a class="headerlink" href="#frequently-asked-questions" title="Permalink to this headline"></a></h1>
<p><em>What is TortoiseHg?</em></p>
<blockquote>
<div>A Windows shell extension for the Mercurial revision control system,
similar to the Tortoise clients for Subversion and CVS. It also
includes a thg application for command line use on many platforms.</div></blockquote>
<p><em>What comes included in the TortoiseHg binary installer for Windows?</em></p>
<blockquote>
<div><a class="reference external" href="http://mercurial.selenic.com/wiki/">Mercurial</a>,
<a class="reference external" href="http://kdiff3.sourceforge.net/">kdiff3</a>,
<a class="reference external" href="http://www.chiark.greenend.org.uk/%7Esgtatham/putty/">TortoisePlink</a>
bonus extensions: hgfold, perfarce, mercurial-keyring.  fixfrozenexts,
python-svn for hgsubversion and convert extensions, and dulwich for
hg-git use.
See <tt class="file docutils literal"><span class="pre">extension-versions.txt</span></tt> in the TortoiseHg folder for more
details on the exact versions packaged.</div></blockquote>
<p><em>Is Mercurial on Windows compatible with the index service and virus scanners?</em></p>
<blockquote>
<div>No. Like TortoiseSVN, <a class="reference external" href="http://www.selenic.com/pipermail/mercurial/2010-January/029680.html">we recommend</a>
to turn off the indexing service on the working copies and repositories,
and exclude them from virus scans.</div></blockquote>
<p><em>How can I get translations for the Explorer context menu?</em></p>
<blockquote>
<div>The available translations were stored by the installer under
<tt class="file docutils literal"><span class="pre">C:\Program</span> <span class="pre">Files\TortoiseHg\i18n\cmenu</span></tt>.  Select the
locale you would like to use, double-click on it, and confirm all
requests.</div></blockquote>
<p><em>How do I do merges and arbitrary version checkouts?</em></p>
<blockquote>
<div>Merges and updates are intended to be done within the
<em class="guilabel">Workbench</em>, using changeset context menus</div></blockquote>
<p><em>Why can&#8217;t I connect to an ssh server (remote: bash: &lt;server name&gt;: command not found)?</em></p>
<blockquote>
<div>TortoisePlink (and basic Plink) will try to use the <em class="guilabel">Host
Name</em> configured in Putty under the <em class="guilabel">Default Settings</em>.
It adds this host name to its command line parameters, causing the
hostname to be specified twice, causing this particular error.
Clearing the host name from the <em class="guilabel">Default Settings</em> is a
possible workaround.</div></blockquote>
<p><em>How can I use tool X as my visual diff tool?</em></p>
<blockquote>
<div>Since version 1.0, TortoiseHg should autodetect most popular visual
diff tools and make them available for selection from the
<em class="guilabel">Visual Diff Tool</em> item in the settings tool.</div></blockquote>
<p><em>How is TortoiseHg configured?</em></p>
<blockquote>
<div><p>TortoiseHg gets configuration settings from two systems.</p>
<ol class="arabic">
<li><dl class="first docutils">
<dt>The Mercurial configuration system, which is three-tiered</dt>
<dd><ol class="first last loweralpha simple">
<li>Site-wide <tt class="file docutils literal"><span class="pre">Mercurial.ini</span></tt> in <tt class="file docutils literal"><span class="pre">%ProgramFiles%\TortoiseHg</span></tt></li>
<li>Per-User <tt class="file docutils literal"><span class="pre">Mercurial.ini</span></tt> in <tt class="file docutils literal"><span class="pre">%UserProfile%</span></tt></li>
<li>Per-Repository <tt class="file docutils literal"><span class="pre">hgrc</span></tt> in <tt class="file docutils literal"><em><span class="pre">repo-root</span></em><span class="pre">\.hg</span></tt></li>
</ol>
</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt>The folder <tt class="file docutils literal"><span class="pre">%APPDATA%\TortoiseHg</span></tt>:</dt>
<dd><ol class="first last loweralpha simple">
<li>File <tt class="file docutils literal"><span class="pre">thg-reporegistry.xml</span></tt> holds the content of the RepoRegistry.</li>
<li>File <tt class="file docutils literal"><span class="pre">TortoiseHgQt.ini</span></tt> contains the settings for application state (window positions, etc).</li>
</ol>
</dd>
</dl>
</li>
</ol>
<p>These are some of the configurables that are stored in the Mercurial
configuration system.</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">vdiff</span> <span class="o">=</span> <span class="n">vdiff</span>
<span class="n">editor</span> <span class="o">=</span> <span class="n">gvim</span>
<span class="n">tabwidth</span> <span class="o">=</span> <span class="mi">4</span>
<span class="n">longsummary</span> <span class="o">=</span> <span class="bp">True</span>
<span class="n">authorcolor</span> <span class="o">=</span> <span class="bp">True</span>
<span class="n">authorcolor</span><span class="o">.</span><span class="n">steve</span> <span class="o">=</span> <span class="n">blue</span>
</pre></div>
</div>
</div></blockquote>
<p><em>Where do TortoiseHg extensions look for external Python modules on Windows?</em></p>
<blockquote>
<div><p>TortoiseHg includes an entire Python distribution bundled up as
DLLs. The standard library modules are all in the
<tt class="file docutils literal"><span class="pre">library.zip</span></tt> file in <tt class="file docutils literal"><span class="pre">C:\Program</span> <span class="pre">Files\TortoiseHg</span></tt>.</p>
<p>If you try to use an extension that imports a non-standard Python
module, you will find that the extension will fail to load because
it can&#8217;t find the module. For example the ReviewBoard extension
imports the simplejson module, which is not part of the standard
Python distribution.</p>
<p>In order to make it work you need to add a couple of lines to the
top of the extension&#8217;s .py file, before the line that imports the
foreign module:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">sys</span>
<span class="n">sys</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">r&#39;C:\path\to\module&#39;</span><span class="p">)</span>
</pre></div>
</div>
<p>Note that this will not work for modules distributed as .egg files;
the supplied path must contain the module&#8217;s .py or .pyc files.</p>
<p>If you have many extensions and/or hooks that all share the same
Python package, you can create an extension which explicitly
modifies sys.path for all the others.  Simply name the extension
such that it is loaded first (alphabetically).  Something like:</p>
<div class="highlight-python"><pre>[extensions]
00setSysPath = C:\path\to\setsyspath.py</pre>
</div>
</div></blockquote>
</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>
  <h4>Previous topic</h4>
  <p class="topless"><a href="nonhg.html"
                        title="previous chapter">9. Use with other VCS systems</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="debugging.html"
                        title="next chapter">11. Debugging</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="_sources/faq.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="debugging.html" title="11. Debugging"
             >next</a> |</li>
        <li class="right" >
          <a href="nonhg.html" title="9. Use with other VCS systems"
             >previous</a> |</li>
        <li><a href="index.html">TortoiseHg 2.4.0 documentation</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>