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

NAME

6       git-annex-drop - remove content of files from repository
7

SYNOPSIS

9       git annex drop [path ...]
10

DESCRIPTION

12       Drops the content of annexed files from this repository, when possible.
13
14       git-annex will refuse to drop content if it cannot verify it is safe to
15       do so.
16

OPTIONS

18       --from=remote
19
20              Rather than dropping the content of files in the  local  reposi‐
21              tory,  this  option  can  specify a remote from which the files'
22              contents should be removed.
23
24       --auto Rather than trying to drop all specified files, drop only  files
25              that  are  not  preferred  content  of the repository.  See git-
26              annex-preferred-content(1)
27
28       --force
29              Use this option with care! It bypasses safety checks, and forces
30              git-annex  to  delete  the  content of the specified files, even
31              from the last repository that is  storing  their  content.  Data
32              loss can result from using this option.
33
34       --all -A
35              Rather  than  specifying a filename or path to drop, this option
36              can be used to drop all available versions of all files.
37
38              This is the default behavior when running git-annex  drop  in  a
39              bare repository.
40
41              Note  that  this bypasses checking the .gitattributes annex.num‐
42              copies setting.
43
44       --branch=ref
45              Drop files in the specified branch or treeish.
46
47              Note that this bypasses checking the  .gitattributes  annex.num‐
48              copies setting.
49
50       --unused
51              Drop files found by last run of git-annex unused.
52
53              Note  that  this bypasses checking the .gitattributes annex.num‐
54              copies setting.
55
56       --key=keyname
57              Use this option to drop a specified key.
58
59              Note that this bypasses checking the  .gitattributes  annex.num‐
60              copies setting.
61
62       file matching options
63              The  git-annex-matching-options(1)  can be used to specify files
64              to drop.
65
66       --jobs=N -JN
67              Runs multiple drop jobs in parallel. This is particularly useful
68              when  git-annex  has  to contact remotes to check if it can drop
69              files.  For example: -J4
70
71       --batch
72              Enables batch mode, in which lines containing names of files  to
73              drop are read from stdin.
74
75              As  each  specified  file is processed, the usual output is dis‐
76              played. If a file's content is not present, or it does not match
77              specified  matching  options,  or  it  is not an annexed file, a
78              blank line is output in response instead.
79
80       -z     Makes the --batch input be delimited by  nulls  instead  of  the
81              usual newlines.
82
83       --json Enable  JSON  output.  This is intended to be parsed by programs
84              that use git-annex. Each line of output is a JSON object.
85
86       --json-error-messages
87              Messages that would normally be output  to  standard  error  are
88              included in the json instead.
89

SEE ALSO

91       git-annex(1)
92
93       git-annex-get(1)
94
95       git-annex-move(1)
96
97       git-annex-copy(1)
98

AUTHOR

100       Joey Hess <id@joeyh.name>
101
102                                                             git-annex-drop(1)
Impressum