X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=git-init-db.html;h=67e56214eeae282beef15e65a0f4118fd98fbc2a;hb=6112cadb5b8a815a65e9924344a663ee16c6723f;hp=dead1b6ec76d9fe215693180986f9dd66e96dddc;hpb=1a4e841b439ba014b365999c3a6b9e2be3740bd8;p=git.git

diff --git a/git-init-db.html b/git-init-db.html
index dead1b6e..67e56214 100644
--- a/git-init-db.html
+++ b/git-init-db.html
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 7.0.1" />
+<meta name="generator" content="AsciiDoc 7.0.2" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -272,7 +272,7 @@ git-init-db(1) Manual Page
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
-<p><em>git-init-db</em> [--template=&lt;template_directory&gt;]</p>
+<p><em>git-init-db</em> [--template=&lt;template_directory&gt;] [--shared]</p>
 </div>
 <h2>OPTIONS</h2>
 <div class="sectionbody">
@@ -282,22 +282,44 @@ git-init-db(1) Manual Page
 </dt>
 <dd>
 <p>
-        Provide the directory in from which templates will be used.
+        Provide the directory from which templates will be used.
+        The default template directory is <tt>/usr/share/git-core/templates</tt>.
+</p>
+</dd>
+<dt>
+--shared
+</dt>
+<dd>
+<p>
+        Specify that the git repository is to be shared amongst several users.
 </p>
 </dd>
 </dl>
 </div>
 <h2>DESCRIPTION</h2>
 <div class="sectionbody">
-<p>This simply creates an empty git repository - basically a <tt>.git</tt> directory
-and <tt>.git/object/??/</tt>, <tt>.git/refs/heads</tt> and <tt>.git/refs/tags</tt> directories,
-and links <tt>.git/HEAD</tt> symbolically to <tt>.git/refs/heads/master</tt>.</p>
+<p>This command creates an empty git repository - basically a <tt>.git</tt> directory
+with subdirectories for <tt>objects</tt>, <tt>refs/heads</tt>, <tt>refs/tags</tt>, and
+templated files.
+An initial <tt>HEAD</tt> file that references the HEAD of the master branch
+is also created.</p>
+<p>If <tt>--template=&lt;template_directory&gt;</tt> is specified, <tt>&lt;template_directory&gt;</tt>
+is used as the source of the template files rather than the default.
+The template files include some directory structure, some suggested
+"exclude patterns", and copies of non-executing "hook" files.  The
+suggested patterns and hook files are all modifiable and extensible.</p>
 <p>If the <tt>$GIT_DIR</tt> environment variable is set then it specifies a path
 to use instead of <tt>./.git</tt> for the base of the repository.</p>
 <p>If the object storage directory is specified via the <tt>$GIT_OBJECT_DIRECTORY</tt>
 environment variable then the sha1 directories are created underneath -
 otherwise the default <tt>$GIT_DIR/objects</tt> directory is used.</p>
-<p><tt>git-init-db</tt> won't hurt an existing repository.</p>
+<p>A shared repository allows users belonging to the same group to push into that
+repository. When specifying <tt>--shared</tt> the config variable "core.sharedRepository"
+is set to <em>true</em> so that directories under <tt>$GIT_DIR</tt> are made group writable
+(and g+sx, since the git group may be not the primary group of all users).</p>
+<p>Running <tt>git-init-db</tt> in an existing repository is safe. It will not overwrite
+things that are already there. The primary reason for rerunning <tt>git-init-db</tt>
+is to pick up newly added templates.</p>
 </div>
 <h2>EXAMPLES</h2>
 <div class="sectionbody">
@@ -309,12 +331,21 @@ Start a new git repository for an existing code base
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ cd /path/to/my/codebase
-$ git-init-db <b>(1)</b>
-$ git-add . <b>(2)</b>
-
-<b>(1)</b> prepare /path/to/my/codebase/.git directory
-<b>(2)</b> add all existing file to the index</tt></pre>
+$ git-init-db   <b>(1)</b>
+$ git-add .     <b>(2)</b></tt></pre>
 </div></div>
+<ol>
+<li>
+<p>
+prepare /path/to/my/codebase/.git directory
+</p>
+</li>
+<li>
+<p>
+add all existing file to the index
+</p>
+</li>
+</ol>
 </dd>
 </dl>
 </div>
@@ -332,7 +363,7 @@ $ git-add . <b>(2)</b>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 27-Dec-2005 00:16:13 PDT
+Last updated 29-Apr-2006 07:01:33 UTC
 </div>
 </div>
 </body>
