<!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.5. Create a new repository — 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="5.6. Clone a repository" href="clone.html" />
<link rel="prev" title="5.4. Workbench" href="workbench.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-init.dialog">
<span id="create-a-new-repository"></span><h1>5.5. Create a new repository<a class="headerlink" href="#module-init.dialog" title="Permalink to this headline">¶</a></h1>
<p>To create a new repository into an existing directory (project) you
have to run the init dialog. From the explorer context menu select
<span class="menuselection">TortoiseHg... ‣ Create Repository Here</span> over the directory, or, within
the folder, type <strong class="command">thg init</strong>.</p>
<div class="figure" id="id1">
<img alt="Init dialog" src="_images/init.png" />
<p class="caption"><span class="caption-text">Repository Init Dialog</span></p>
</div>
<dl class="docutils">
<dt><span class="guilabel">Destination</span></dt>
<dd>Is the directory where the repository will be created. It is
always filled with the current directory, so if you launch the
dialog from the right directory there is no reason to change it.</dd>
<dt><span class="guilabel">Create special files (.hgignore, ...)</span></dt>
<dd>If selected TortoiseHg creates an empty <code class="file docutils literal"><span class="pre">.hgignore</span></code> file
in the working directory.</dd>
<dt><span class="guilabel">Make repo compatible with Mercurial <1.7</span></dt>
<dd>If selected TortoiseHg creates an older format Mercurial repository.
Do not check unless you have a strong reason to do, and you know
what you are doing.</dd>
<dt><span class="guilabel">Show in Workbench after init</span></dt>
<dd>When the repository was successfully created, it is added to the RepoRegistry,
and opened in a new tab the Workbench.</dd>
<dt><span class="guilabel">Hg command</span></dt>
<dd>This field displays the command that will be executed by the dialog.</dd>
</dl>
<p>Creating a new repository means create a subdirectory called <code class="file docutils literal"><span class="pre">.hg</span></code>.
In this subdirectory Mercurial keeps all its versioning information.</p>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">It is dangerous to manually edit the files in <code class="file docutils literal"><span class="pre">.hg</span></code> directory,
repository corruption can occur. <code class="file docutils literal"><span class="pre">.hg/hgrc</span></code> is perhaps the
only exception to this rule.</p>
</div>
<div class="section" id="from-command-line">
<h2>5.5.1. From command line<a class="headerlink" href="#from-command-line" title="Permalink to this headline">¶</a></h2>
<p>The init 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">init</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">init</span> <span class="p">[</span><span class="n">DEST</span><span class="p">]</span>
</pre></div>
</div>
<p>where [DEST] is the path to destination folder.</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.5. Create a new repository</a><ul>
<li><a class="reference internal" href="#from-command-line">5.5.1. 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="workbench.html" title="previous chapter">5.4. Workbench</a></li>
<li>Next: <a href="clone.html" title="next chapter">5.6. Clone a repository</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/init.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/init.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
