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
>]]
</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 Provide the directory from which templates will be used. The default template
354 directory is
<tt>/usr/share/git-core/templates
</tt>.
356 <div class=
"para"><p>When specified,
<tt><template_directory
></tt> is used as the source of the template
357 files rather than the default. The template files include some directory
358 structure, some suggested
"exclude patterns", and copies of non-executing
359 "hook" files. The suggested patterns and hook files are all modifiable and
360 extensible.
</p></div>
363 --shared[={false|true|umask|group|all|world|everybody|
0xxx}]
367 Specify that the git repository is to be shared amongst several users. This
368 allows users belonging to the same group to push into that
369 repository. When specified, the config variable
"core.sharedRepository" is
370 set so that files and directories under
<tt>$GIT_DIR
</tt> are created with the
371 requested permissions. When not specified, git will use permissions reported
374 <div class=
"para"><p>The option can have the following values, defaulting to
<em>group
</em> if no value
376 <div class=
"ilist"><ul>
379 <em>umask
</em> (or
<em>false
</em>): Use permissions reported by umask(
2). The default,
380 when
<tt>--shared
</tt> is not specified.
385 <em>group
</em> (or
<em>true
</em>): Make the repository group-writable, (and g+sx, since
386 the git group may be not the primary group of all users).
387 This is used to loosen the permissions of an otherwise safe umask(
2) value.
388 Note that the umask still applies to the other permission bits (e.g. if
389 umask is
<em>0022</em>, using
<em>group
</em> will not remove read privileges from other
390 (non-group) users). See
<em>0xxx
</em> for how to exactly specify the repository
396 <em>all
</em> (or
<em>world
</em> or
<em>everybody
</em>): Same as
<em>group
</em>, but make the repository
397 readable by all users.
402 <em>0xxx
</em>:
<em>0xxx
</em> is an octal number and each file will have mode
<em>0xxx
</em>.
403 <em>0xxx
</em> will override users' umask(
2) value (and not only loosen permissions
404 as
<em>group
</em> and
<em>all
</em> does).
<em>0640</em> will create a repository which is
405 group-readable, but not group-writable or accessible to others.
<em>0660</em> will
406 create a repo that is readable and writable to the current user and group,
407 but inaccessible to others.
409 <div class=
"para"><p>By default, the configuration flag receive.denyNonFastForwards is enabled
410 in shared repositories, so that you cannot force a non fast-forwarding push
417 <h2 id=
"_description">DESCRIPTION
</h2>
418 <div class=
"sectionbody">
419 <div class=
"para"><p>This command creates an empty git repository - basically a
<tt>.git
</tt> directory
420 with subdirectories for
<tt>objects
</tt>,
<tt>refs/heads
</tt>,
<tt>refs/tags
</tt>, and
422 An initial
<tt>HEAD
</tt> file that references the HEAD of the master branch
423 is also created.
</p></div>
424 <div class=
"para"><p>If the
<tt>$GIT_DIR
</tt> environment variable is set then it specifies a path
425 to use instead of
<tt>./.git
</tt> for the base of the repository.
</p></div>
426 <div class=
"para"><p>If the object storage directory is specified via the
<tt>$GIT_OBJECT_DIRECTORY
</tt>
427 environment variable then the sha1 directories are created underneath -
428 otherwise the default
<tt>$GIT_DIR/objects
</tt> directory is used.
</p></div>
429 <div class=
"para"><p>Running
<em>git-init
</em> in an existing repository is safe. It will not overwrite
430 things that are already there. The primary reason for rerunning
<em>git-init
</em>
431 is to pick up newly added templates.
</p></div>
432 <div class=
"para"><p>Note that
<em>git-init
</em> is the same as
<em>git-init-db
</em>. The command
433 was primarily meant to initialize the object database, but over
434 time it has become responsible for setting up the other aspects
435 of the repository, such as installing the default hooks and
436 setting the configuration variables. The old name is retained
437 for backward compatibility reasons.
</p></div>
439 <h2 id=
"_examples">EXAMPLES
</h2>
440 <div class=
"sectionbody">
441 <div class=
"vlist"><dl>
443 Start a new git repository for an existing code base
446 <div class=
"listingblock">
447 <div class=
"content">
448 <pre><tt>$ cd /path/to/my/codebase
449 $ git init
<b>(
1)
</b>
450 $ git add .
<b>(
2)
</b></tt></pre>
452 <div class=
"colist"><ol>
455 prepare /path/to/my/codebase/.git directory
460 add all existing file to the index
467 <h2 id=
"_author">Author
</h2>
468 <div class=
"sectionbody">
469 <div class=
"para"><p>Written by Linus Torvalds
<torvalds@osdl.org
></p></div>
471 <h2 id=
"_documentation">Documentation
</h2>
472 <div class=
"sectionbody">
473 <div class=
"para"><p>Documentation by David Greaves, Junio C Hamano and the git-list
<git@vger.kernel.org
>.
</p></div>
475 <h2 id=
"_git">GIT
</h2>
476 <div class=
"sectionbody">
477 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
480 <div id=
"footer-text">
481 Last updated
2009-
07-
01 02:
30:
53 UTC