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

NAME

6       git-annex-add - adds files to the git annex
7

SYNOPSIS

9       git annex add [path ...]
10

DESCRIPTION

12       Adds  the  specified  files  to the annex. If a directory is specified,
13       acts on all files inside the directory and its subdirectories.   If  no
14       path is specified, adds files from the current directory and below.
15
16       Files that are already checked into git and are unmodified, or that git
17       has been configured to ignore will be silently skipped.
18
19       If annex.largefiles is configured, and does not match a file, git annex
20       add will behave the same as git add and add the non-large file directly
21       to the git repository, instead of to the annex.
22
23       Large files are added to the annex in locked form, which prevents  fur‐
24       ther   modification   of   their   content   unless  unlocked  by  git-
25       annex-unlock(1).  (This is not the case however when a repository is in
26       a  filesystem  not supporting symlinks.)  To add a file to the annex in
27       unlocked form, git add can be used instead.
28
29       This command can also be used to add symbolic links, both  symlinks  to
30       annexed content, and other symlinks.
31

OPTIONS

33       --include-dotfiles
34
35              Dotfiles  are  skipped  unless explicitly listed, or unless this
36              option is used.
37
38       --force
39              Add gitignored files.
40
41       --backend
42              Specifies which key-value backend to use.
43
44       file matching options
45              Many of the git-annex-matching-options(1) can be used to specify
46              files to add.
47
48              For example: --largerthan=1GB
49
50       --jobs=N -JN
51              Adds  multiple files in parallel. This may be faster.  For exam‐
52              ple: -J4
53
54              Setting this to "cpus" will run one job per CPU core.
55
56       --update -u
57              Like git add --update, this does not  add  new  files,  but  any
58              updates to tracked files will be added to the index.
59
60       --json Enable  JSON  output.  This is intended to be parsed by programs
61              that use git-annex. Each line of output is a JSON object.
62
63       --json-progress
64              Include progress objects in JSON output.
65
66       --json-error-messages
67              Messages that would normally be output  to  standard  error  are
68              included in the json instead.
69
70       --batch
71              Enables  batch  mode,  in  which a file to add is read in a line
72              from stdin, the file is added, and repeat.
73
74              Note that if a file is skipped (due to not existing, being  git‐
75              ignored,  already  being  in  git,  or doesn't meet the matching
76              options), an empty line will be output  instead  of  the  normal
77              output produced when adding a file.
78
79       -z     Makes  the  --batch  input  be delimited by nulls instead of the
80              usual newlines.
81

SEE ALSO

83       git-annex(1)
84
85       git-annex-unlock(1)
86
87       git-annex-lock(1)
88
89       git-annex-undo(1)
90
91       git-annex-import(1)
92
93       git-annex-unannex(1)
94
95       git-annex-reinject(1)
96

AUTHOR

98       Joey Hess <id@joeyh.name>
99
100                                                              git-annex-add(1)