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  prevent
22       that,  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

EXAMPLES

34        # git annex add foo
35        git-annex: First run: git-annex init
36        # git annex init
37        init ok
38        # git annex add foo
39        add foo ok
40

OPTIONS

42       --version=N
43
44              Force  the  repository  to  be  initialized  using  a  different
45              annex.version than the current default.
46
47              When  the  version given is one that automatically upgrades to a
48              newer version, it  will  automatically  use  the  newer  version
49              instead.
50
51       --autoenable
52              Only  enable  any  special  remotes  that  were  configured with
53              autoenable=true, do not otherwise initialize anything.
54

SEE ALSO

56       git-annex(1)
57
58       git-annex-describe(1)
59
60       git-annex-reinit(1)
61
62       git-init(1)
63

AUTHOR

65       Joey Hess <id@joeyh.name>
66
67                                                             git-annex-init(1)
Impressum