<!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.8. Shelve — 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.9. Synchronize" href="sync.html" />
<link rel="prev" title="5.7. Commit" href="commit.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-shelve.dialog">
<span id="shelve"></span><h1>5.8. Shelve<a class="headerlink" href="#module-shelve.dialog" title="Permalink to this headline">¶</a></h1>
<p>The shelve tool can move changes between the working directory and shelf
patches. If the MQ extension has been enabled, it can also move
changes into and out of unapplied patches.</p>
<p>The shelve tool can be launched by the Workbench <span class="guilabel">Repository –>
Shelve</span> menu option, by a toolbar button on working file viewers, or
by <strong class="command">thg shelve</strong>.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">We highly recommend setting the patch eol configuration to auto if
you use the shelve tool with DOS eoln text files.</p>
</div>
<div class="figure" id="id1">
<img alt="Shelve dialog" src="_images/shelve.png" />
<p class="caption"><span class="caption-text">Shelve dialog</span></p>
</div>
<div class="section" id="features">
<h2>5.8.1. Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2>
<p>The shelve tool has three toolbars. A right and left toolbar for the
two side by side panels, and a central toolbar for refresh and creating
a new shelf patch. The right and left toolbars are mirrors of each
other, offering the same functionality in alternate directions.</p>
<p>The left toolbar has these actions:</p>
<blockquote>
<div><dl class="docutils">
<dt><span class="guilabel">Delete selected chunks</span></dt>
<dd>Remove, or revert, all selected (toggled) chunks in the
currently selected file.</dd>
<dt><span class="guilabel">Move all files right</span></dt>
<dd>Move all changes in all files to the patch selected in the
right pane.</dd>
<dt><span class="guilabel">Move selected file right</span></dt>
<dd>Move all changes in the currently selected file to the patch
selected in the right pane.</dd>
<dt><span class="guilabel">Edit selected file</span></dt>
<dd>If the working directory is being browsed, this button edits the
currently selected file. Else it edits the currently viewed
patch file.</dd>
<dt><span class="guilabel">Move selected chunks right</span></dt>
<dd>Move all selected (toggled) chunks to the patch selected in the
right pane.</dd>
</dl>
</div></blockquote>
<p>The central toolbar has two actions:</p>
<blockquote>
<div><dl class="docutils">
<dt><span class="guilabel">Refresh</span></dt>
<dd>Refreshes the patch drop down lists and the working copy view</dd>
<dt><span class="guilabel">New Shelf</span></dt>
<dd>Creates a new shelf file. You must enter a name, though a
reasonable default is provided.</dd>
</dl>
</div></blockquote>
<p>The right toolbar will move changes from the patch selected on the
left side to the patch selected on the right side, or the working
copy if it has been selected on the right.</p>
</div>
<div class="section" id="patch-panes">
<h2>5.8.2. Patch Panes<a class="headerlink" href="#patch-panes" title="Permalink to this headline">¶</a></h2>
<p>The right and the left patch panes are identical save for the working
copy changes are only available on the left. Selectable chunks are only
displayed if the file is text and is in a modified state. Added or
removed files can be shelved but parts of the file cannot be
individually selected.</p>
<p>The <span class="guilabel">Clear</span> button will empty the currently selected patch or
revert the entire working copy. The <span class="guilabel">Delete</span> button will
delete the currently selected shelf patch.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The <span class="guilabel">Delete</span> button is not sensitive when an MQ patch is
selected. MQ patches must be deleted via qdelete using the
Workbench context menu or the Patch Queue widget.</p>
</div>
<p>When right clicking on a file in the file list, you will get a context
menu of commands.</p>
<blockquote>
<div><dl class="docutils">
<dt><span class="guilabel">Visual Diff</span></dt>
<dd>Open the selected file in your default visual diff tool. Only
enabled for working copy files.</dd>
<dt><span class="guilabel">Edit Local</span></dt>
<dd>Open the working copy version of the selected file.</dd>
<dt><span class="guilabel">Revert to Revision</span></dt>
<dd>Revert all changes to the selected file. Only enabled for
working copy files.</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="trashcan">
<h2>5.8.3. Trashcan<a class="headerlink" href="#trashcan" title="Permalink to this headline">¶</a></h2>
<p>The shelve tool is very conservative with your source and patch files.
Before it modifies any file it makes a backup under
<code class="file docutils literal notranslate"><span class="pre">.hg/Trashcan</span></code>. This trashcan can be emptied by running the purge
dialog from the Workbench <span class="guilabel">Repository –> Purge</span> menu option.</p>
</div>
<div class="section" id="from-command-line">
<h2>5.8.4. From command line<a class="headerlink" href="#from-command-line" title="Permalink to this headline">¶</a></h2>
<p>The shelve tool 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">shelve</span>
<span class="n">aliases</span><span class="p">:</span> <span class="n">unshelve</span>
<span class="n">shelve</span> <span class="n">tool</span>
<span class="n">use</span> <span class="s2">"thg -v help shelve"</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>
<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"><a class="reference internal" href="explorer.html">5.2. Windows Explorer Integration</a></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 current"><a class="current reference internal" href="#">5.8. Shelve</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#features">5.8.1. Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#patch-panes">5.8.2. Patch Panes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#trashcan">5.8.3. Trashcan</a></li>
<li class="toctree-l3"><a class="reference internal" href="#from-command-line">5.8.4. From command line</a></li>
</ul>
</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="commit.html" title="previous chapter">5.7. Commit</a></li>
<li>Next: <a href="sync.html" title="next chapter">5.9. Synchronize</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/shelve.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
67810d03ada515381702f7b70888f800
>
files
>
520
