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 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
412 <div class=
"para"><p>If you name a (possibly non-existent) directory at the end of the command
413 line, the command is run inside the directory (possibly after creating it).
</p></div>
419 <h2 id=
"_description">DESCRIPTION
</h2>
420 <div class=
"sectionbody">
421 <div class=
"para"><p>This command creates an empty git repository - basically a
<tt>.git
</tt> directory
422 with subdirectories for
<tt>objects
</tt>,
<tt>refs/heads
</tt>,
<tt>refs/tags
</tt>, and
424 An initial
<tt>HEAD
</tt> file that references the HEAD of the master branch
425 is also created.
</p></div>
426 <div class=
"para"><p>If the
<tt>$GIT_DIR
</tt> environment variable is set then it specifies a path
427 to use instead of
<tt>./.git
</tt> for the base of the repository.
</p></div>
428 <div class=
"para"><p>If the object storage directory is specified via the
<tt>$GIT_OBJECT_DIRECTORY
</tt>
429 environment variable then the sha1 directories are created underneath -
430 otherwise the default
<tt>$GIT_DIR/objects
</tt> directory is used.
</p></div>
431 <div class=
"para"><p>Running
<em>git-init
</em> in an existing repository is safe. It will not overwrite
432 things that are already there. The primary reason for rerunning
<em>git-init
</em>
433 is to pick up newly added templates.
</p></div>
434 <div class=
"para"><p>Note that
<em>git-init
</em> is the same as
<em>git-init-db
</em>. The command
435 was primarily meant to initialize the object database, but over
436 time it has become responsible for setting up the other aspects
437 of the repository, such as installing the default hooks and
438 setting the configuration variables. The old name is retained
439 for backward compatibility reasons.
</p></div>
441 <h2 id=
"_examples">EXAMPLES
</h2>
442 <div class=
"sectionbody">
443 <div class=
"vlist"><dl>
445 Start a new git repository for an existing code base
448 <div class=
"listingblock">
449 <div class=
"content">
450 <pre><tt>$ cd /path/to/my/codebase
451 $ git init
<b>(
1)
</b>
452 $ git add .
<b>(
2)
</b></tt></pre>
454 <div class=
"colist"><ol>
457 prepare /path/to/my/codebase/.git directory
462 add all existing file to the index
469 <h2 id=
"_author">Author
</h2>
470 <div class=
"sectionbody">
471 <div class=
"para"><p>Written by Linus Torvalds
<torvalds@osdl.org
></p></div>
473 <h2 id=
"_documentation">Documentation
</h2>
474 <div class=
"sectionbody">
475 <div class=
"para"><p>Documentation by David Greaves, Junio C Hamano and the git-list
<git@vger.kernel.org
>.
</p></div>
477 <h2 id=
"_git">GIT
</h2>
478 <div class=
"sectionbody">
479 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
482 <div id=
"footer-text">
483 Last updated
2009-
08-
05 21:
21:
14 UTC