1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-init(
1)
</title>
312 git-init(
1) Manual Page
315 <div class=
"sectionbody">
317 Create an empty git repository or reinitialize an existing one
322 <div class=
"sectionbody">
323 <div class=
"para"><p><em>git init
</em> [-q | --quiet] [--bare] [--template=
<template_directory
>] [--shared[=
<permissions
>]] [directory]
</p></div>
325 <h2 id=
"_options">OPTIONS
</h2>
326 <div class=
"sectionbody">
327 <div class=
"vlist"><dl>
336 Only print error and warning messages, all other output will be suppressed.
344 Create a bare repository. If GIT_DIR environment is not set, it is set to the
345 current working directory.
349 --template=
<template_directory
>
353 Specify the directory from which templates will be used. (See the
"TEMPLATE
354 DIRECTORY" section below.)
358 --shared[={false|true|umask|group|all|world|everybody|
0xxx}]
362 Specify that the git repository is to be shared amongst several users. This
363 allows users belonging to the same group to push into that
364 repository. When specified, the config variable
"core.sharedRepository" is
365 set so that files and directories under
<tt>$GIT_DIR
</tt> are created with the
366 requested permissions. When not specified, git will use permissions reported
369 <div class=
"para"><p>The option can have the following values, defaulting to
<em>group
</em> if no value
371 <div class=
"ilist"><ul>
374 <em>umask
</em> (or
<em>false
</em>): Use permissions reported by umask(
2). The default,
375 when
<tt>--shared
</tt> is not specified.
380 <em>group
</em> (or
<em>true
</em>): Make the repository group-writable, (and g+sx, since
381 the git group may be not the primary group of all users).
382 This is used to loosen the permissions of an otherwise safe umask(
2) value.
383 Note that the umask still applies to the other permission bits (e.g. if
384 umask is
<em>0022</em>, using
<em>group
</em> will not remove read privileges from other
385 (non-group) users). See
<em>0xxx
</em> for how to exactly specify the repository
391 <em>all
</em> (or
<em>world
</em> or
<em>everybody
</em>): Same as
<em>group
</em>, but make the repository
392 readable by all users.
397 <em>0xxx
</em>:
<em>0xxx
</em> is an octal number and each file will have mode
<em>0xxx
</em>.
398 <em>0xxx
</em> will override users' umask(
2) value (and not only loosen permissions
399 as
<em>group
</em> and
<em>all
</em> does).
<em>0640</em> will create a repository which is
400 group-readable, but not group-writable or accessible to others.
<em>0660</em> will
401 create a repo that is readable and writable to the current user and group,
402 but inaccessible to others.
404 <div class=
"para"><p>By default, the configuration flag receive.denyNonFastForwards is enabled
405 in shared repositories, so that you cannot force a non fast-forwarding push
407 <div class=
"para"><p>If you name a (possibly non-existent) directory at the end of the command
408 line, the command is run inside the directory (possibly after creating it).
</p></div>
414 <h2 id=
"_description">DESCRIPTION
</h2>
415 <div class=
"sectionbody">
416 <div class=
"para"><p>This command creates an empty git repository - basically a
<tt>.git
</tt> directory
417 with subdirectories for
<tt>objects
</tt>,
<tt>refs/heads
</tt>,
<tt>refs/tags
</tt>, and
419 An initial
<tt>HEAD
</tt> file that references the HEAD of the master branch
420 is also created.
</p></div>
421 <div class=
"para"><p>If the
<tt>$GIT_DIR
</tt> environment variable is set then it specifies a path
422 to use instead of
<tt>./.git
</tt> for the base of the repository.
</p></div>
423 <div class=
"para"><p>If the object storage directory is specified via the
<tt>$GIT_OBJECT_DIRECTORY
</tt>
424 environment variable then the sha1 directories are created underneath -
425 otherwise the default
<tt>$GIT_DIR/objects
</tt> directory is used.
</p></div>
426 <div class=
"para"><p>Running
<em>git init
</em> in an existing repository is safe. It will not overwrite
427 things that are already there. The primary reason for rerunning
<em>git init
</em>
428 is to pick up newly added templates.
</p></div>
429 <div class=
"para"><p>Note that
<em>git init
</em> is the same as
<em>git init-db
</em>. The command
430 was primarily meant to initialize the object database, but over
431 time it has become responsible for setting up the other aspects
432 of the repository, such as installing the default hooks and
433 setting the configuration variables. The old name is retained
434 for backward compatibility reasons.
</p></div>
436 <h2 id=
"_template_directory">TEMPLATE DIRECTORY
</h2>
437 <div class=
"sectionbody">
438 <div class=
"para"><p>The template directory contains files and directories that will be copied to
439 the
<tt>$GIT_DIR
</tt> after it is created.
</p></div>
440 <div class=
"para"><p>The template directory used will (in order):
</p></div>
441 <div class=
"ilist"><ul>
444 The argument given with the
<tt>--template
</tt> option.
449 The contents of the
<tt>$GIT_TEMPLATE_DIR
</tt> environment variable.
454 The
<tt>init.templatedir
</tt> configuration variable.
459 The default template directory:
<tt>/usr/share/git-core/templates
</tt>.
463 <div class=
"para"><p>The default template directory includes some directory structure, some
464 suggested
"exclude patterns", and copies of sample
"hook" files.
465 The suggested patterns and hook files are all modifiable and extensible.
</p></div>
467 <h2 id=
"_examples">EXAMPLES
</h2>
468 <div class=
"sectionbody">
469 <div class=
"vlist"><dl>
471 Start a new git repository for an existing code base
474 <div class=
"listingblock">
475 <div class=
"content">
476 <pre><tt>$ cd /path/to/my/codebase
477 $ git init
<b>(
1)
</b>
478 $ git add .
<b>(
2)
</b></tt></pre>
480 <div class=
"colist"><ol>
483 prepare /path/to/my/codebase/.git directory
488 add all existing file to the index
495 <h2 id=
"_author">Author
</h2>
496 <div class=
"sectionbody">
497 <div class=
"para"><p>Written by Linus Torvalds
<torvalds@osdl.org
></p></div>
499 <h2 id=
"_documentation">Documentation
</h2>
500 <div class=
"sectionbody">
501 <div class=
"para"><p>Documentation by David Greaves, Junio C Hamano and the git-list
<git@vger.kernel.org
>.
</p></div>
503 <h2 id=
"_git">GIT
</h2>
504 <div class=
"sectionbody">
505 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
508 <div id=
"footer-text">
509 Last updated
2010-
09-
03 21:
30:
20 UTC