Make "git help" sort git commands in columns
[alt-git.git] / Documentation / git-init-db.txt
blob6deef92508417d32832766a683db213ad191256c
1 git-init-db(1)
2 ==============
4 NAME
5 ----
6 git-init-db - Creates an empty git repository
9 SYNOPSIS
10 --------
11 'git-init-db' [--template=<template_directory>]
14 OPTIONS
15 -------
16 --template=<template_directory>::
17         Provide the directory in from which templates will be used.
20 DESCRIPTION
21 -----------
22 This simply creates an empty git repository - basically a `.git` directory
23 and `.git/object/??/`, `.git/refs/heads` and `.git/refs/tags` directories,
24 and links `.git/HEAD` symbolically to `.git/refs/heads/master`.
26 If the `$GIT_DIR` environment variable is set then it specifies a path
27 to use instead of `./.git` for the base of the repository.
29 If the object storage directory is specified via the `$GIT_OBJECT_DIRECTORY`
30 environment variable then the sha1 directories are created underneath -
31 otherwise the default `$GIT_DIR/objects` directory is used.
33 `git-init-db` won't hurt an existing repository.
36 EXAMPLES
37 --------
39 Start a new git repository for an existing code base::
41 ----------------
42 $ cd /path/to/my/codebase
43 $ git-init-db <1>
44 $ git-add . <2>
46 <1> prepare /path/to/my/codebase/.git directory
47 <2> add all existing file to the index
48 ----------------
51 Author
52 ------
53 Written by Linus Torvalds <torvalds@osdl.org>
55 Documentation
56 --------------
57 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
59 GIT
60 ---
61 Part of the gitlink:git[7] suite