<!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.13. Archiving — 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="6. Settings" href="settings.html" />
<link rel="prev" title="5.12. Ignore Filter" href="ignore.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-archive.dialog">
<span id="archiving"></span><h1>5.13. Archiving<a class="headerlink" href="#module-archive.dialog" title="Permalink to this headline">¶</a></h1>
<p>You can choose from quite a lot of formats to make an archive of a repository.
There are the usual compressed formats, of course, but it’s also possible to make a
folder of the uncompressed files in a place other than the Working Directory (like a clone,
but without the .hg folder). Such archives, for example, can be useful for doing builds (similar
to ‘svn export’). Archives may also be useful for sending changes to external people
without access to the reposity, where only the effected files of a given revision or set
of revisions need be included in the archive.</p>
<div class="section" id="from-tortoisehg">
<h2>5.13.1. From TortoiseHg<a class="headerlink" href="#from-tortoisehg" title="Permalink to this headline">¶</a></h2>
<p>From the changelog context menu in the Workbench select
<span class="menuselection">Export ‣ Archive...</span> for the choosen changeset.</p>
<div class="figure" id="id1">
<img alt="Archive dialog" src="_images/archive.png" />
<p class="caption"><span class="caption-text">Repository Archive Dialog</span></p>
</div>
<dl class="docutils">
<dt><span class="guilabel">Revision</span></dt>
<dd>To select the revision you wish to archive or export.</dd>
<dt><span class="guilabel">Only files modified/created in this revision</span></dt>
<dd>To limit the number of files in the archive.</dd>
<dt><span class="guilabel">Destination path</span></dt>
<dd>The filename or directory where the archive will be created. The archive is filled
with the name of the current repository, suffixed with the revision number
of the selected revision, and has the appropriate extension of the selected
archive type.</dd>
<dt><span class="guilabel">Archive types</span></dt>
<dd>Here you can choose the type of archive to create, ranging from a plain
folder with files to a variety of standard archive type.</dd>
<dt><span class="guilabel">Hg command</span></dt>
<dd>This field displays the command that will be executed by the dialog.</dd>
<dt><span class="guilabel">Always show output</span></dt>
<dd>To have an logging output pane with the results of the command while it runs.</dd>
</dl>
<p>Archiving a repository means create an archive file or subdirectory with the
contents of the selected revision.</p>
</div>
<div class="section" id="from-command-line">
<h2>5.13.2. From command line<a class="headerlink" href="#from-command-line" title="Permalink to this headline">¶</a></h2>
<p>The archive tool 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">archive</span>
</pre></div>
</div>
<p>The syntax is</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">thg</span> <span class="n">archive</span> <span class="o">-</span><span class="n">r</span> <span class="p">[</span><span class="n">REV</span><span class="p">]</span> <span class="o">-</span><span class="n">t</span> <span class="p">[</span><span class="n">TYPE</span><span class="p">]</span> <span class="p">[</span><span class="n">DEST</span><span class="p">]</span>
</pre></div>
</div>
<p>where [REV] is the revision to archive, [TYPE] is the type of archive to create,
and [DEST] is the name of the file or folder to create.</p>
<p>See <a class="reference external" href="https://www.mercurial-scm.org/doc/hg.1.html#archive">hg.1.html#archive</a>
for details, or type <strong class="command">hg help archive</strong> at the command line or in the
Output Log of the Workbench.</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>
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">5.13. Archiving</a><ul>
<li><a class="reference internal" href="#from-tortoisehg">5.13.1. From TortoiseHg</a></li>
<li><a class="reference internal" href="#from-command-line">5.13.2. 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="ignore.html" title="previous chapter">5.12. Ignore Filter</a></li>
<li>Next: <a href="settings.html" title="next chapter">6. Settings</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/archive.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/archive.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
