1git-annex-init(1)           General Commands Manual          git-annex-init(1)
2
3
4

NAME

6       git-annex-init - initialize git-annex
7

SYNOPSIS

9       git annex init [description]
10

DESCRIPTION

12       Until  a  repository (or one of its remotes) has been initialized, git-
13       annex will refuse to operate on it, to avoid accidentally using it in a
14       repository that was not intended to have an annex.
15
16       It's  useful,  but  not  mandatory,  to  initialize each new clone of a
17       repository with its own description. If you don't provide one, one will
18       be generated using the username, hostname and the path.
19
20       If  any special remotes were configured with autoenable=true, this will
21       also attempt to enable them. See git-annex-initremote(1).   To  disable
22       this,  re-enable  a  remote with "autoenable=false", or mark it as dead
23       (see git-annex-dead(1)).
24
25       This command is entirely  safe,  although  usually  pointless,  to  run
26       inside an already initialized git-annex repository.
27
28       A  top-level  .noannex file will prevent git-annex init from being used
29       in a repository. This is useful for repositories  that  have  a  policy
30       reason  not to use git-annex. The content of the file will be displayed
31       to the user who tries to run git-annex init.
32

OPTIONS

34       --version=N
35
36              Force  the  repository  to  be  initialized  using  a  different
37              annex.version than the current default.
38
39              When  the  version given is one that automatically upgrades to a
40              newer version, it  will  automatically  use  the  newer  version
41              instead.
42

SEE ALSO

44       git-annex(1)
45
46       git-annex-describe(1)
47
48       git-annex-reinit(1)
49
50       git-init(1)
51

AUTHOR

53       Joey Hess <id@joeyh.name>
54
55                                                             git-annex-init(1)