Differences

This shows you the differences between two versions of the page.

--- git_init [2019/02/18 10:34] – rpjday
+++ git_init [2019/02/21 12:57] (current) – [Overview (not quite done here)] rpjday
@@ Line 1: / Line 1: @@
-===== Overview (add Intro material) =====
+===== Overview (not quite done here) =====
-Basic operation of creating a new repo.
+Basic and advanced features for initializing a Git repository -- more content to be added.
 ===== Working with the template directory =====
-By default, ''git init'' will populate your new ''.git'' directory with the contents of ''/usr/share/git-core/templates/'', without overwriting existing content of the same name:
+By default, ''git init'' will populate your new ''.git'' directory with some auto-generated content, plus all of the content of the appropriate //template// directory.
+If you don't specify a template directory, the default used is ''/usr/share/git-core/templates'', which contains something like this:
 <code>
-├── branches
+.
+├── branches/
 ├── description
-├── hooks
+├── hooks/
-│   ├── applypatch-msg.sample
+│   ├── applypatch-msg.sample*
-│   ├── commit-msg.sample
+│   ├── commit-msg.sample*
-│   ├── fsmonitor-watchman.sample
+│   ├── fsmonitor-watchman.sample*
-│   ├── post-update.sample
+│   ├── post-update.sample*
-│   ├── pre-applypatch.sample
+│   ├── pre-applypatch.sample*
-│   ├── pre-commit.sample
+│   ├── pre-commit.sample*
-│   ├── prepare-commit-msg.sample
+│   ├── prepare-commit-msg.sample*
-│   ├── pre-push.sample
+│   ├── pre-push.sample*
-│   ├── pre-rebase.sample
+│   ├── pre-rebase.sample*
-│   ├── pre-receive.sample
+│   ├── pre-receive.sample*
-│   └── update.sample
+│   └── update.sample*
-└── info
+└── info/
     └── exclude
 </code>
-You have the option of selecting a different template directory when you run ''git init'':
+Rather than accepting the default directory and content, it's common for developers to want to immediately register their own hooks, which means setting up an alternate template directory.
+From the man page for "git init'':
 <code>
 TEMPLATE DIRECTORY
-       Files and directories in the template directory whose name do
+   Files and directories in the template directory whose name do
-       not start with a dot will be copied to the $GIT_DIR after it is
+   not start with a dot will be copied to the $GIT_DIR after it is
-       created.
+   created.
-       The template directory will be one of the following (in order):
+   The template directory will be one of the following (in order):
-       ·   the argument given with the --template option;
+   ·   the argument given with the --template option;
-       ·   the contents of the $GIT_TEMPLATE_DIR environment variable;
+   ·   the contents of the $GIT_TEMPLATE_DIR environment variable;
-       ·   the init.templateDir configuration variable; or
+   ·   the init.templateDir configuration variable; or
-       ·   the default template directory:
+   ·   the default template directory:
-           /usr/share/git-core/templates.
+       /usr/share/git-core/templates.
-       The default template directory includes some directory
+   The default template directory includes some directory
-       structure, suggested "exclude patterns" (see gitignore(5)), and
+   structure, suggested "exclude patterns" (see gitignore(5)), and
-       sample hook files.
+   sample hook files.
-       The sample hooks are all disabled by default, To enable one of
+   The sample hooks are all disabled by default, To enable one of
-       the sample hooks rename it by removing its .sample suffix.
+   the sample hooks rename it by removing its .sample suffix.
 </code>