File: git-annex-init.mdwn

package info (click to toggle)
git-annex 10.20230126-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 69,344 kB
  • sloc: haskell: 74,654; javascript: 9,103; sh: 1,304; makefile: 203; perl: 136; ansic: 44
file content (76 lines) | stat: -rw-r--r-- 2,016 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
# NAME

git-annex init - initialize git-annex

# SYNOPSIS

git annex init `[description]`

# DESCRIPTION

Until a repository (or one of its remotes) has been initialized,
git-annex will refuse to operate on it, to avoid accidentally
using it in a repository that was not intended to have an annex.

It's useful, but not mandatory, to initialize each new clone
of a repository with its own description. If you don't provide one,
one will be generated using the username, hostname and the path.

If any special remotes were configured with autoenable=true,
this will also attempt to enable them. See [[git-annex-initremote]](1).
To prevent that, re-enable a remote with "autoenable=false", or
mark it as dead (see [[git-annex-dead]](1)).

This command is entirely safe, although usually pointless, to run inside an
already initialized git-annex repository.
  
A top-level `.noannex` file will prevent git-annex init from being used
in a repository. This is useful for repositories that have a policy
reason not to use git-annex. The content of the file will be displayed
to the user who tries to run git-annex init.

# EXAMPLES

	# git annex add foo
	git-annex: First run: git-annex init
	# git annex init
	init ok
	# git annex add foo
	add foo ok

# OPTIONS

* `--version=N`

  Force the repository to be initialized using a different annex.version
  than the current default.

  When the version given is not supported, but can be automatically
  upgraded to a newer version, it will use the newer version instead.

* `--autoenable`

  Only enable any special remotes that were configured with
  autoenable=true, do not otherwise initialize anything.

* `--no-autoenable`

  Do not enable special remotes that were configured with autoenable=true.

* Also the [[git-annex-common-options]](1) can be used.

# SEE ALSO

[[git-annex]](1)

[[git-annex-describe]](1)

[[git-annex-reinit]](1)

git-init(1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.