<!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>6. Settings — 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="7. Patches" href="patches.html" />
<link rel="prev" title="5.13. Archiving" href="archive.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-settings.dialog">
<span id="settings"></span><h1>6. Settings<a class="headerlink" href="#module-settings.dialog" title="Permalink to this headline">¶</a></h1>
<div class="figure" id="id1">
<img alt="Settings dialog" src="_images/settings.png" />
<p class="caption"><span class="caption-text">Settings dialog</span></p>
</div>
<p>The Settings dialog is used to configure both TortoiseHg and the
underlying Mercurial DVCS. Since TortoiseHg uses Mercurial’s underlying
configuration system to store and retrieve its settings, these are
essentially the same thing.</p>
<p>Mercurial on Windows has a three-tier configuration system.</p>
<ol class="arabic simple">
<li>A site-wide configuration file in
<code class="file docutils literal notranslate"><span class="pre">C:\Program</span> <span class="pre">Files\TortoiseHg\Mercurial.ini</span></code>
This file is read first and thus has the lowest priority.</li>
<li>A per-user configuration file in
<code class="file docutils literal notranslate"><span class="pre">C:\Documents</span> <span class="pre">and</span> <span class="pre">Settings\username\Mercurial.ini</span></code>
This file is read second and thus can override settings in the
site-wide configuration file.</li>
<li>A per-repository configuration file in <code class="file docutils literal notranslate"><span class="pre">repo-root\.hg\hgrc</span></code> This
file is read last and can override site-wide and user global settings.</li>
</ol>
<p>The site-wide file can be overwritten on upgrades so it is recommended
that you do not make changes to this file. Instead, you should make
changes to your user <code class="file docutils literal notranslate"><span class="pre">Mercurial.ini</span></code> and/or the repository
<code class="file docutils literal notranslate"><span class="pre">hgrc</span></code> file. The TortoiseHg Settings dialog enforces this
suggestion by only operating in two modes:</p>
<dl class="docutils">
<dt>Global</dt>
<dd>edits your user <code class="file docutils literal notranslate"><span class="pre">Mercurial.ini</span></code> file</dd>
<dt>Repository</dt>
<dd>edits a repository <code class="file docutils literal notranslate"><span class="pre">.hg/hgrc</span></code> file</dd>
</dl>
<p>You may toggle between the two modes using the combo box at the top of
the dialog, or directly edit the file in your configured visual editor.</p>
<p>Most TortoiseHg users will want to store all configurables in their
global user settings, and only use the repository hgrc to store paths
(remote repository aliases) and web settings, though it is possible to
override many configurables per-repository (a common example is to
configure a username for use in a specific repository). Also note that
the user and repository configuration files may not exist until you run
the Settings dialog for the first time.</p>
<div class="section" id="tabs">
<h2>6.1. Tabs<a class="headerlink" href="#tabs" title="Permalink to this headline">¶</a></h2>
<p>The Settings tool is a tabbed application.</p>
<p>Each tab corresponds roughly to a section of your <code class="file docutils literal notranslate"><span class="pre">Mercurial.ini</span></code>
file, though there is a certain amount of overlap. Some sections were
split across multiple tabs for clarity.</p>
<p>Every tab but <span class="guilabel">Sync</span> has the same format, a list of
configurable options with a drop-down combo box with possible values and
a history of options you have used for that setting. The configurable
name (label) has a tooltip which describes in more detail what you are
configuring and its default value. The description of the currently
focused configurable is also shown in a text box at the bottom of the
dialog.</p>
<p>Please consult the Mercurial wiki for more detailed information about
these configurables (except for the first three tabs:
<span class="guilabel">TortoiseHg</span>, <span class="guilabel">Commit</span>, <span class="guilabel">Changelog</span>, which
are specific to TortoiseHg).</p>
<span class="target" id="module-TortoiseHg.settings"></span><div class="section" id="tortoisehg">
<h3>6.1.1. TortoiseHg<a class="headerlink" href="#tortoisehg" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">UI Language:</span></dt>
<dd>Specify your preferred user interface language (restart needed)</dd>
<dt><span class="guilabel">3-way Merge Tool:</span></dt>
<dd>Graphical merge program for resolving merge conflicts. If left
unspecified, Mercurial will use the first applicable tool it finds
on your system or use its internal merge tool that leaves conflict
markers in place. Chose <span class="guilabel">internal:merge</span> to force
conflict markers, <span class="guilabel">internal:prompt</span> to always select local
or other, or <span class="guilabel">internal:dump</span> to leave files in the working
directory for manual merging.</dd>
<dt><span class="guilabel">Visual Diff Tool:</span></dt>
<dd>Specify visual diff tool as described in the [merge-tools] section
of your Mercurial configuration files. If left unspecified,
TortoiseHg will use the selected merge tool. Failing that it uses
the first applicable tool it finds.</dd>
<dt><span class="guilabel">Visual Editor:</span></dt>
<dd>Specify visual editor, as described in the <code class="docutils literal notranslate"><span class="pre">[editor-tools]</span></code> section
of your Mercurial configuration files. If left unspecified, TortoiseHg
will use the first applicable tool it finds.</dd>
<dt><span class="guilabel">CLI Editor:</span></dt>
<dd>The editor used by Mercurial command line commands to collect
multiline input from the user. Most notably, commit messages.</dd>
<dt><span class="guilabel">Shell:</span></dt>
<dd><p class="first">Specify the command to launch your preferred terminal shell
application. If the value includes the string <code class="docutils literal notranslate"><span class="pre">%(reponame)s</span></code>, the
name of the repository will be substituted in place of
<code class="docutils literal notranslate"><span class="pre">%(reponame)s</span></code>. Similarly, <code class="docutils literal notranslate"><span class="pre">%(root)s</span></code> will be the full path to
the repository. (restart needed)</p>
<dl class="last docutils">
<dt>Default, Windows:</dt>
<dd><code class="docutils literal notranslate"><span class="pre">cmd.exe</span> <span class="pre">/K</span> <span class="pre">title</span> <span class="pre">%(reponame)s</span></code></dd>
<dt>Default, OS X:</dt>
<dd>not set</dd>
<dt>Default, other:</dt>
<dd><code class="docutils literal notranslate"><span class="pre">xterm</span> <span class="pre">-T</span> <span class="pre">"%(reponame)s"</span></code></dd>
</dl>
</dd>
<dt><span class="guilabel">Immediate Operations:</span></dt>
<dd>Space separated list of shell operations you would like to be
performed immediately, without user interaction. Commands are “add
remove revert forget”. Default: None (leave blank)</dd>
<dt><span class="guilabel">Tab Width:</span></dt>
<dd>Specify the number of spaces that tabs expand to in various
TortoiseHg windows. Default: 8</dd>
<dt><span class="guilabel">Force Repo Tab:</span></dt>
<dd>Always show repo tabs, even for a single repo. Default: False</dd>
<dt><span class="guilabel">Monitor Repo Changes:</span></dt>
<dd>Specify the target filesystem where TortoiseHg monitors changes.
Default: localonly</dd>
<dt><span class="guilabel">Max Diff Size:</span></dt>
<dd>The maximum size file (in KB) that TortoiseHg will
show changes for in the changelog, status, and commit windows.
A value of zero implies no limit. Default: 1024 (1MB).</dd>
<dt><span class="guilabel">Fork GUI:</span></dt>
<dd>When running thg from the command line, fork a background process
to run graphical dialogs. Default: True.</dd>
<dt><span class="guilabel">Full Path Title:</span></dt>
<dd>Show a full directory path of the repository in the dialog title
instead of just the root directory name. Default: False</dd>
<dt><span class="guilabel">Auto-resolve merges:</span></dt>
<dd>Indicates whether TortoiseHg should attempt to automatically resolve
changes from both sides to the same file, and only report merge
conflicts when this is not possible. When False, all files with
changes on both sides of the merge will report as conflicting, even
if the edits are to different parts of the file. In either case, when
conflicts occur, the user will be invited to review and resolve
changes manually. Default: True.</dd>
<dt><span class="guilabel">New Repo Skeleton:</span></dt>
<dd>If specified, files in the directory, e.g. <code class="docutils literal notranslate"><span class="pre">.hgignore</span></code>, are copied
to the newly-created repository.</dd>
</dl>
<span class="target" id="module-workbench.settings"></span></div>
<div class="section" id="workbench">
<h3>6.1.2. Workbench<a class="headerlink" href="#workbench" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Single Workbench Window:</span></dt>
<dd>Select whether you want to have a single workbench window. If you
disable this setting you will get a new workbench window everytime
that you use the “Hg Workbench” command on the explorer context menu.
Default: True</dd>
<dt><span class="guilabel">Default widget:</span></dt>
<dd>Select the initial widget that will be shown when opening a
repository. Default: revdetails</dd>
<dt><span class="guilabel">Initial revision:</span></dt>
<dd>Select the initial revision that will be selected when opening a
repository. You can select the “current” (i.e. the working directory
parent), the current “tip” or the working directory (“workingdir”).
Default: current</dd>
<dt><span class="guilabel">Open new tabs next to the current tab:</span></dt>
<dd>Should new tabs be open next to the current tab? If False new tabs
will be open after the last tab. Default: True</dd>
<dt><span class="guilabel">Author Coloring:</span></dt>
<dd>Color changesets by author name. Default: False</dd>
<dt><span class="guilabel">Full Authorname:</span></dt>
<dd>Show full authorname in Logview. If not enabled, only a short part,
usually name without email is shown. Default: False</dd>
<dt><span class="guilabel">Task Tabs:</span></dt>
<dd>Show tabs along the side of the bottom half of each repo widget
allowing one to switch task tabs without using the toolbar. Default:
off</dd>
<dt><span class="guilabel">Task Toolbar Order:</span></dt>
<dd>Specify which task buttons you want to show on the task toolbar and
in which order.
Type a list of the task button names. Add separators by putting “|”
between task button names.
Valid names are: log commit sync grep and pbranch.
Default: log commit grep pbranch | sync</dd>
<dt><span class="guilabel">Long Summary:</span></dt>
<dd>If true, concatenate multiple lines of changeset summary and truncate
them at 80 characters as necessary. Default: False</dd>
<dt><span class="guilabel">Log Batch Size:</span></dt>
<dd>The number of revisions to read and display in the changelog viewer
in a single batch. Default: 500</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. Default: None
(leave blank)</dd>
<dt><span class="guilabel">Branch Colors:</span></dt>
<dd>Space separated list of branch names and colors of the form
<code class="docutils literal notranslate"><span class="pre">branch:#XXXXXX</span></code>. Spaces and colons in the branch name must be
escaped using a backslash (<code class="docutils literal notranslate"><span class="pre">\</span></code>). Likewise some other characters can
be escaped in this way, e.g. <code class="docutils literal notranslate"><span class="pre">\u0040</span></code> will be decoded to the <code class="docutils literal notranslate"><span class="pre">@</span></code>
haracter, and <code class="docutils literal notranslate"><span class="pre">\n</span></code> to a linefeed. Default: None (leave blank)</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. Default: None (leave blank)</dd>
<dt><span class="guilabel">Activate Bookmarks:</span></dt>
<dd><p class="first">Select when TortoiseHg will show a prompt to activate a bookmark when
updating to a revision that has one or more
bookmarks.</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> :</dt>
<dd>Try to automatically activate bookmarks. When updating to a revision
that has a single bookmark it will be activated automatically. Show
a prompt if there is more than one bookmark on the revision that is
being updated to.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">prompt</span></code> :</dt>
<dd><dl class="first last docutils">
<dt>The default. Show a prompt when updating to a revision that has one</dt>
<dd>or more bookmarks.</dd>
</dl>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">never</span></code> :</dt>
<dd>Never show any prompt to activate any bookmarks.</dd>
</dl>
<p class="last">Default: prompt</p>
</dd>
<dt><span class="guilabel">Show Family Line:</span></dt>
<dd><p class="first">Show indirect revision dependency on the revision graph when filtered
by revset. Default: True</p>
<div class="last admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Calculating family line may be slow in some cases. This option is
expected to be removed if the performance issue is solved.</p>
</div>
</dd>
</dl>
<span class="target" id="module-commit.settings"></span></div>
<div class="section" id="commit">
<h3>6.1.3. Commit<a class="headerlink" href="#commit" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Username:</span></dt>
<dd>Name associated with commits. The common format is:
<code class="docutils literal notranslate"><span class="pre">Full</span> <span class="pre">Name</span> <span class="pre"><email@example.com></span></code></dd>
<dt><span class="guilabel">Ask Username:</span></dt>
<dd>If no username has been specified, the user will be prompted to enter
a username. Default: False</dd>
<dt><span class="guilabel">Summary Line Length:</span></dt>
<dd>Suggested length of commit message lines. A red vertical line will
mark this length. <span class="guilabel">CTRL-E</span> will reflow the current
paragraph to the specified line length. Default: 80</dd>
<dt><span class="guilabel">Close After Commit:</span></dt>
<dd>Close the commit tool after every successful commit. Default: False</dd>
<dt><span class="guilabel">Push After Commit:</span></dt>
<dd>Attempt to push to default push target after every successful
commit. Default: No push</dd>
<dt><span class="guilabel">Auto Commit List:</span></dt>
<dd>Comma separated list of files that are automatically included in
every commit. Intended for use only as a repository setting.
Default: None (leave blank)</dd>
<dt><span class="guilabel">Auto Exclude List:</span></dt>
<dd>Comma separated list of files that are automatically unchecked when
the status, and commit dialogs are opened. Default: None (leave
blank)</dd>
<dt><span class="guilabel">English Messages:</span></dt>
<dd>Generate English commit messages even if <span class="target" id="index-0"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LANGUAGE</span></code> or
<span class="target" id="index-1"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LANG</span></code> environment variables are set to a non-English
language. This setting is used by the Merge, Tag and Backout dialogs.
Default: False</dd>
<dt><span class="guilabel">New Commit Phase:</span></dt>
<dd>The phase of new commits. Default: draft</dd>
<dt><span class="guilabel">Secret MQ Patches:</span></dt>
<dd>Make MQ patches secret (instead of draft). Default: False</dd>
<dt><span class="guilabel">Check Subrepo Phase:</span></dt>
<dd>Check the phase of the current revision of each subrepository. For
settings other than “ignore”, the phase of the current revision of
each subrepository is checked before committing the parent
repository. Default: follow</dd>
<dt><span class="guilabel">Monitor working directory changes:</span></dt>
<dd><p class="first">Select when the working directory status list will be refreshed:</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> <span class="classifier-delimiter">:</span> <span class="classifier">default</span></dt>
<dd>let TortoiseHg decide when to refresh the working directory status
list. TortoiseHg will refresh the status list whenever it performs
an action that may potentially modify the working directory.
<em>This may miss any changes that happen outside of TortoiseHg’s
control</em>;</dd>
<dt><code class="docutils literal notranslate"><span class="pre">always</span></code> :</dt>
<dd>in addition to the automatic updates above, also refresh the status
list whenever the user clicks on the “working dir revision” or on
the “Commit icon” on the workbench task bar;</dd>
<dt><code class="docutils literal notranslate"><span class="pre">alwayslocal</span></code> :</dt>
<dd>same as <code class="docutils literal notranslate"><span class="pre">always</span></code> but restricts forced refreshes to <em>local repos</em>.</dd>
</dl>
<p class="last">Default: auto</p>
</dd>
<dt><span class="guilabel">Confirm adding unknown files:</span></dt>
<dd>Determines if TortoiseHg should show a confirmation dialog before
adding new files in a commit. If True, a confirmation dialog will be
shown. If False, selected new files will be included in the commit
with no confirmation dialog. Default: True</dd>
<dt><span class="guilabel">Confirm deleting files:</span></dt>
<dd>Determines if TortoiseHg should show a confirmation dialog before
removing files in a commit. If True, a confirmation dialog will be
shown. If False, selected deleted files will be included in the
commit with no confirmation dialog. Default: True</dd>
</dl>
<span class="target" id="module-sync.settings"></span></div>
<div class="section" id="sync">
<h3>6.1.4. Sync<a class="headerlink" href="#sync" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">After Pull Operation:</span></dt>
<dd>Operation which is performed directly after a successful pull. update
equates to <code class="docutils literal notranslate"><span class="pre">pull</span> <span class="pre">--update</span></code>, fetch equates to the fetch extension,
rebase equates to <code class="docutils literal notranslate"><span class="pre">pull</span> <span class="pre">--rebase</span></code>, updateorrebase equates to <code class="docutils literal notranslate"><span class="pre">pull</span>
<span class="pre">-u</span> <span class="pre">--rebase</span></code>. Default: none</dd>
<dt><span class="guilabel">Default Push:</span></dt>
<dd><p class="first">Select the revisions that will be pushed by default, whenever you
click the Push button.</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">all</span></code> :</dt>
<dd>The default. Push all changes in <em>all branches</em>.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">branch</span></code> :</dt>
<dd>Push all changes in the <em>current branch</em>.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">revision</span></code> :</dt>
<dd>Push the changes in the current branch <em>up to the current revision</em>.</dd>
</dl>
<p class="last">Default: all</p>
</dd>
<dt><span class="guilabel">Confirm Push:</span></dt>
<dd>Determines if TortoiseHg should show a confirmation dialog before
pushing changesets. If False, push will be performed without any
confirmation dialog. Default: True</dd>
<dt><span class="guilabel">Target Combo:</span></dt>
<dd><p class="first">Select if TortoiseHg will show a target combo in the sync toolbar.</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> :</dt>
<dd>The default. Show the combo if more than one target configured.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">always</span></code>:</dt>
<dd>Always show the combo.</dd>
</dl>
<p class="last">Default: auto</p>
</dd>
<dt><span class="guilabel">SSH Command:</span></dt>
<dd><p class="first">Command to use for SSH connections.</p>
<p class="last">Default: <code class="docutils literal notranslate"><span class="pre">ssh</span></code> or <code class="docutils literal notranslate"><span class="pre">TortoisePlink.exe</span> <span class="pre">-ssh</span> <span class="pre">-2</span></code> (Windows)</p>
</dd>
</dl>
<span class="target" id="module-server.settings"></span></div>
<div class="section" id="server">
<h3>6.1.5. Server<a class="headerlink" href="#server" title="Permalink to this headline">¶</a></h3>
<p><strong>Repository Details:</strong></p>
<dl class="docutils">
<dt><span class="guilabel">Name:</span></dt>
<dd>Repository name to use in the web interface, and by TortoiseHg as a
shorthand name. Default is the working directory.</dd>
<dt><span class="guilabel">Encoding:</span></dt>
<dd>Character encoding of files in the repository, used by the web
interface and TortoiseHg.</dd>
<dt><span class="guilabel">‘Publishing’ repository:</span></dt>
<dd>Controls draft phase behavior when working as a server. When true,
pushed changesets are set to public in both client and server and
pulled or cloned changesets are set to public in the client. Default:
True</dd>
</dl>
<p><strong>Web Server:</strong></p>
<dl class="docutils">
<dt><span class="guilabel">Description:</span></dt>
<dd>Textual description of the repository’s purpose or
contents.</dd>
<dt><span class="guilabel">Contact:</span></dt>
<dd>Name or email address of the person in charge of the
repository.</dd>
<dt><span class="guilabel">Style:</span></dt>
<dd>Which template map style to use.</dd>
<dt><span class="guilabel">Archive Formats:</span></dt>
<dd>Comma separated list of archive formats allowed for
downloading.</dd>
<dt><span class="guilabel">Port:</span></dt>
<dd>Port to listen on.</dd>
<dt><span class="guilabel">Push Requires SSL:</span></dt>
<dd>Whether to require that inbound pushes be transported
over SSL to prevent password sniffing.</dd>
<dt><span class="guilabel">Stripes:</span></dt>
<dd>How many lines a “zebra stripe” should span in multiline output.
Default is 1; set to 0 to disable.</dd>
<dt><span class="guilabel">Max Files:</span></dt>
<dd>Maximum number of files to list per changeset.</dd>
<dt><span class="guilabel">Max Changes:</span></dt>
<dd>Maximum number of changes to list on the changelog.</dd>
<dt><span class="guilabel">Allow Push:</span></dt>
<dd>Whether to allow pushing to the repository. If empty or not
set, push is not allowed. If the special value “*”, any remote
user can push, including unauthenticated users. Otherwise, the
remote user must have been authenticated, and the authenticated
user name must be present in this list (separated by whitespace
or “,”). The contents of the allow_push list are examined after
the deny_push list.</dd>
<dt><span class="guilabel">Deny Push:</span></dt>
<dd>Whether to deny pushing to the repository. If empty or not set,
push is not denied. If the special value “*”, all remote users
are denied push. Otherwise, unauthenticated users are all
denied, and any authenticated user name present in this list
(separated by whitespace or “,”) is also denied. The contents
of the deny_push list are examined before the allow_push list.</dd>
</dl>
<span class="target" id="module-proxy.settings"></span></div>
<div class="section" id="proxy">
<h3>6.1.6. Proxy<a class="headerlink" href="#proxy" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Host:</span></dt>
<dd>Host name and (optional) port of proxy server, for
example <code class="docutils literal notranslate"><span class="pre">myproxy:8000</span></code>.</dd>
<dt><span class="guilabel">Bypass List:</span></dt>
<dd>Optional. Comma-separated list of host names that
should bypass the proxy.</dd>
<dt><span class="guilabel">User:</span></dt>
<dd>Optional. User name to authenticate with at the
proxy server.</dd>
<dt><span class="guilabel">Password:</span></dt>
<dd>Optional. Password to authenticate with at the
proxy server.</dd>
</dl>
<span class="target" id="module-email.settings"></span></div>
<div class="section" id="email">
<h3>6.1.7. Email<a class="headerlink" href="#email" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">From:</span></dt>
<dd>Email address to use in the “From” header and for the SMTP envelope.</dd>
<dt><span class="guilabel">To:</span></dt>
<dd>Comma-separated list of recipient email addresses.</dd>
<dt><span class="guilabel">Cc:</span></dt>
<dd>Comma-separated list of carbon copy recipient email
addresses.</dd>
<dt><span class="guilabel">Bcc:</span></dt>
<dd>Comma-separated list of blind carbon copy recipient
email addresses.</dd>
<dt><span class="guilabel">method:</span></dt>
<dd>Optional. Method to use to send email messages. If value is “smtp” (default),
use SMTP (configured below). Otherwise, use as name of program to run that
acts like sendmail (takes <strong class="command">-f</strong> option for sender, list of recipients on
command line, message on stdin). Normally, setting this to <code class="docutils literal notranslate"><span class="pre">sendmail</span></code> or
<code class="docutils literal notranslate"><span class="pre">/usr/sbin/sendmail</span></code> is enough to use sendmail to send messages.</dd>
<dt><span class="guilabel">SMTP Host:</span></dt>
<dd>Host name of mail server.</dd>
<dt><span class="guilabel">SMTP Port:</span></dt>
<dd>Port to connect to on mail server.
Default: 25.</dd>
<dt><span class="guilabel">SMTP TLS:</span></dt>
<dd>Method to enable TLS when connecting to mail server. Default: none</dd>
<dt><span class="guilabel">SMTP Username:</span></dt>
<dd>Username to authenticate to mail server with.</dd>
<dt><span class="guilabel">SMTP Password:</span></dt>
<dd>Password to authenticate to mail server with.</dd>
<dt><span class="guilabel">Local Hostname:</span></dt>
<dd>Hostname the sender can use to identify itself to the mail server.</dd>
</dl>
<span class="target" id="module-diff.settings"></span></div>
<div class="section" id="diff-and-annotate">
<h3>6.1.8. Diff and Annotate<a class="headerlink" href="#diff-and-annotate" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Patch EOL:</span></dt>
<dd>Normalize file line endings during and after patch to lf or crlf.
Strict does no normalization. Auto does per-file detection, and is
the recommended setting. Default: strict</dd>
<dt><span class="guilabel">Git Format:</span></dt>
<dd>Use git extended diff header format.
Default: False.</dd>
<dt><span class="guilabel">MQ Git Format:</span></dt>
<dd>When set to <code class="docutils literal notranslate"><span class="pre">auto</span></code>, mq will automatically use git patches when
required to avoid losing changes to file modes, copy records or
binary files. If set to <code class="docutils literal notranslate"><span class="pre">keep</span></code>, mq will obey the <code class="docutils literal notranslate"><span class="pre">[diff]</span></code> section
configuration while preserving existing git patches upon qrefresh. If
set to <code class="docutils literal notranslate"><span class="pre">yes</span></code> or <code class="docutils literal notranslate"><span class="pre">no</span></code>, mq will override the <code class="docutils literal notranslate"><span class="pre">[diff]</span></code> section and
always generate git or regular patches, possibly losing data in the
second case. Default: auto</dd>
<dt><span class="guilabel">No Dates:</span></dt>
<dd>Do not include modification dates in diff headers.
Default: False.</dd>
<dt><span class="guilabel">Show Function:</span></dt>
<dd>Show which function each change is in.
Default: False.</dd>
<dt><span class="guilabel">Ignore White Space:</span></dt>
<dd>Ignore white space when comparing lines.
Default: False.</dd>
<dt><span class="guilabel">Ignore WS Amount:</span></dt>
<dd>Ignore changes in the amount of white space.
Default: False.</dd>
<dt><span class="guilabel">Ignore Blank Lines:</span></dt>
<dd>Ignore changes whose lines are all blank.
Default: False.</dd>
</dl>
<p><strong>Annotate:</strong></p>
<dl class="docutils">
<dt><span class="guilabel">Ignore White Space:</span></dt>
<dd>Ignore white space when comparing lines in the annotate view.
Default: False</dd>
<dt><span class="guilabel">Ignore WS Amount:</span></dt>
<dd>Ignore changes in the amount of white space in the annotate view.
Default: False</dd>
<dt><span class="guilabel">Ignore Blank Lines:</span></dt>
<dd>Ignore changes whose lines are all blank in the annotate view.
Default: False</dd>
</dl>
<span class="target" id="module-font.settings"></span></div>
<div class="section" id="font">
<h3>6.1.9. Font<a class="headerlink" href="#font" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Message Font:</span></dt>
<dd>Font used to display commit messages. Default: monospace 10</dd>
<dt><span class="guilabel">Diff Font:</span></dt>
<dd>Font used to display text differences. Default: monospace 10</dd>
<dt><span class="guilabel">List Font:</span></dt>
<dd>Font used to display file lists. Default: sans 9</dd>
<dt><span class="guilabel">ChangeLog Font:</span></dt>
<dd>Font used to display changelog data. Default: monospace 10</dd>
<dt><span class="guilabel">Output Font:</span></dt>
<dd>Font used to display output messages. Default: sans 8</dd>
</dl>
<span class="target" id="module-issue.settings"></span></div>
<div class="section" id="issue-tracking">
<h3>6.1.10. Issue Tracking<a class="headerlink" href="#issue-tracking" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Issue Regex:</span></dt>
<dd>Defines the regex to match when picking up issue numbers.</dd>
<dt><span class="guilabel">Issue Link:</span></dt>
<dd>Defines the command to run when an issue number is recognized. You
may include groups in issue.regex, and corresponding <code class="docutils literal notranslate"><span class="pre">{n}</span></code> tokens in
issue.link (where n is a non-negative integer). <code class="docutils literal notranslate"><span class="pre">{0}</span></code> refers to the
entire string matched by issue.regex, while <code class="docutils literal notranslate"><span class="pre">{1}</span></code> refers to the
first group and so on. If no <code class="docutils literal notranslate"><span class="pre">{n}</span></code> tokens are found in issue.link,
the entire matched string is appended instead.</dd>
<dt><span class="guilabel">Inline Tags:</span></dt>
<dd>Show tags at start of commit message.</dd>
<dt><span class="guilabel">Mandatory Issue Reference:</span></dt>
<dd>When committing, require that a reference to an issue be specified.
If enabled, the regex configured in ‘Issue Regex’ must find a match
in the commit message.</dd>
<dt><span class="guilabel">Issue Tracker Plugin:</span></dt>
<dd>Configures a COM <code class="docutils literal notranslate"><span class="pre">IBugTraqProvider</span></code> or <code class="docutils literal notranslate"><span class="pre">IBugTrackProvider2</span></code> issue
tracking plugin.</dd>
<dt><span class="guilabel">Configure Issue Tracker:</span></dt>
<dd>Configure the selected COM Bug Tracker plugin.</dd>
<dt><span class="guilabel">Issue Tracker Trigger:</span></dt>
<dd><p class="first">Determines when the issue tracker state will be updated by
TortoiseHg. Valid settings values are:</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">never</span></code> :</dt>
<dd>Do not update the Issue Tracker state automatically.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">commit</span></code> :</dt>
<dd>Update the Issue Tracker state after a successful commit.</dd>
</dl>
<p class="last">Default: never</p>
</dd>
<dt><span class="guilabel">Changeset Link:</span></dt>
<dd><p class="first">A “template string” that, when set, turns the revision number and
short hashes that are shown on the revision panels into links.
The “template string” uses a “mercurial template”-like syntax that
currently accepts two template expressions:</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">{node|short}</span></code> :</dt>
<dd>replaced by the 12 digit revision id (note that <code class="docutils literal notranslate"><span class="pre">{node}</span></code> on its
own is currently unsupported).</dd>
<dt><code class="docutils literal notranslate"><span class="pre">{rev}</span></code> :</dt>
<dd>replaced by the revision number.</dd>
</dl>
<p class="last">For example, in order to link to bitbucket commit pages you can set
this to: <code class="docutils literal notranslate"><span class="pre">https://bitbucket.org/tortoisehg/thg/commits/{node|short}</span></code></p>
</dd>
</dl>
<span class="target" id="module-reviewboard.settings"></span></div>
<div class="section" id="review-board">
<h3>6.1.11. Review Board<a class="headerlink" href="#review-board" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Server:</span></dt>
<dd>Path to review board example <code class="docutils literal notranslate"><span class="pre">http://demo.reviewboard.org</span></code></dd>
<dt><span class="guilabel">User:</span></dt>
<dd>User name to authenticate with review board</dd>
<dt><span class="guilabel">Password:</span></dt>
<dd>Password to authenticate with review board</dd>
<dt><span class="guilabel">Server Repository ID:</span></dt>
<dd>The default repository id for this repo on the review board server</dd>
<dt><span class="guilabel">Target Groups:</span></dt>
<dd>A comma separated list of target groups</dd>
<dt><span class="guilabel">Target People:</span></dt>
<dd>A comma separated list of target people</dd>
</dl>
<span class="target" id="module-largefiles.settings"></span></div>
<div class="section" id="largefiles">
<h3>6.1.12. Largefiles<a class="headerlink" href="#largefiles" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Patterns:</span></dt>
<dd>Files with names meeting the specified patterns will be automatically
added as largefiles</dd>
<dt><span class="guilabel">Minimum Size:</span></dt>
<dd>Files of at least the specified size (in megabytes) will be added as
largefiles</dd>
<dt><span class="guilabel">User Cache:</span></dt>
<dd>Path to the directory where a user’s cache of largefiles will be
stored</dd>
</dl>
<span class="target" id="module-projrc.settings"></span></div>
<div class="section" id="projrc">
<h3>6.1.13. Projrc<a class="headerlink" href="#projrc" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Require confirmation:</span></dt>
<dd><p class="first">When to ask the user to confirm the update of the local “projrc”
configuration file when the remote projrc file changes. Possible
values are:</p>
<dl class="last docutils">
<dt><code class="docutils literal notranslate"><span class="pre">always</span></code> <span class="classifier-delimiter">:</span> <span class="classifier">default</span></dt>
<dd>Always show a confirmation prompt before updating the local
<code class="docutils literal notranslate"><span class="pre">.hg/projrc</span></code> file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">first</span></code> :</dt>
<dd>Show a confirmation dialog when the repository is cloned or when a
remote projrc file is found for the first time.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">never</span></code> :</dt>
<dd>Update the local <code class="docutils literal notranslate"><span class="pre">.hg/projrc</span></code> file automatically, without
requiring any user confirmation.</dd>
</dl>
</dd>
<dt><span class="guilabel">Servers:</span></dt>
<dd>List of Servers from which “projrc” configuration files must be
pulled. Set it to “*” to pull from all servers. Set it to “default”
to pull from the default sync path. Default is pull from NO servers.</dd>
<dt><span class="guilabel">Include:</span></dt>
<dd>List of settings that will be pulled from the project configuration
file. Default is include NO settings.</dd>
<dt><span class="guilabel">Exclude:</span></dt>
<dd>List of settings that will NOT be pulled from the project
configuration file. Default is exclude none of the included settings.</dd>
<dt><span class="guilabel">Update on incoming:</span></dt>
<dd><p class="first">Let the user update the projrc on incoming:</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">never</span></code> <span class="classifier-delimiter">:</span> <span class="classifier">default</span></dt>
<dd>Show whether the remote projrc file has changed, but do not update
(nor ask to update) the local projrc file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">prompt</span></code> :</dt>
<dd>Look for changes to the projrc file. If there are changes <em>always</em>
show a confirmation prompt, asking the user if it wants to update
its local projrc file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">auto</span></code> :</dt>
<dd>Look for changes to the projrc file. Use the value of the
“projrc.confirm” configuration key to determine whether to show a
confirmation dialog or not before updating the local projrc file.</dd>
</dl>
<p class="last">Default: never</p>
</dd>
</dl>
<span class="target" id="module-gpg.settings"></span></div>
<div class="section" id="gnupg">
<h3>6.1.14. GnuPG<a class="headerlink" href="#gnupg" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt><span class="guilabel">Command:</span></dt>
<dd>Specify the path to GPG. Default: gpg</dd>
<dt><span class="guilabel">Key ID:</span></dt>
<dd>GPG key ID associated with user. Default: None (leave blank)</dd>
</dl>
</div>
</div>
<div class="section" id="keyboard-navigation">
<h2>6.2. Keyboard navigation<a class="headerlink" href="#keyboard-navigation" title="Permalink to this headline">¶</a></h2>
<dl class="docutils">
<dt><kbd class="kbd docutils literal notranslate">Ctrl-Enter</kbd></dt>
<dd>Apply changes and close the tool, the equivalent of pressing the
‘Ok’ button.</dd>
</dl>
</div>
<div class="section" id="from-command-line">
<h2>6.3. From command line<a class="headerlink" href="#from-command-line" title="Permalink to this headline">¶</a></h2>
<p>The setting dialog can be started from command line</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">thg</span> <span class="n">repoconfig</span>
</pre></div>
</div>
<p>for the repository settings (<code class="file docutils literal notranslate"><span class="pre">.hg/hgrc</span></code> file) or</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">thg</span> <span class="n">userconfig</span>
</pre></div>
</div>
<p>for the user configuration (<code class="file docutils literal notranslate"><span class="pre">Mercurial.ini</span></code> file).</p>
<p>The syntax is simple, no options or parameters are needed, except the global
options.</p>
</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"><a class="reference internal" href="daily.html">5. TortoiseHg in daily use</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">6. Settings</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#tabs">6.1. Tabs</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#tortoisehg">6.1.1. TortoiseHg</a></li>
<li class="toctree-l3"><a class="reference internal" href="#workbench">6.1.2. Workbench</a></li>
<li class="toctree-l3"><a class="reference internal" href="#commit">6.1.3. Commit</a></li>
<li class="toctree-l3"><a class="reference internal" href="#sync">6.1.4. Sync</a></li>
<li class="toctree-l3"><a class="reference internal" href="#server">6.1.5. Server</a></li>
<li class="toctree-l3"><a class="reference internal" href="#proxy">6.1.6. Proxy</a></li>
<li class="toctree-l3"><a class="reference internal" href="#email">6.1.7. Email</a></li>
<li class="toctree-l3"><a class="reference internal" href="#diff-and-annotate">6.1.8. Diff and Annotate</a></li>
<li class="toctree-l3"><a class="reference internal" href="#font">6.1.9. Font</a></li>
<li class="toctree-l3"><a class="reference internal" href="#issue-tracking">6.1.10. Issue Tracking</a></li>
<li class="toctree-l3"><a class="reference internal" href="#review-board">6.1.11. Review Board</a></li>
<li class="toctree-l3"><a class="reference internal" href="#largefiles">6.1.12. Largefiles</a></li>
<li class="toctree-l3"><a class="reference internal" href="#projrc">6.1.13. Projrc</a></li>
<li class="toctree-l3"><a class="reference internal" href="#gnupg">6.1.14. GnuPG</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#keyboard-navigation">6.2. Keyboard navigation</a></li>
<li class="toctree-l2"><a class="reference internal" href="#from-command-line">6.3. From command line</a></li>
</ul>
</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>Previous: <a href="archive.html" title="previous chapter">5.13. Archiving</a></li>
<li>Next: <a href="patches.html" title="next chapter">7. Patches</a></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/settings.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
67810d03ada515381702f7b70888f800
>
files
>
519
