1git-annex-drop(1)           General Commands Manual          git-annex-drop(1)
2
3
4
5#a NAME
6
7       git-annex drop - remove content of files from repository
8

SYNOPSIS

10       git annex drop [path ...]
11

DESCRIPTION

13       Drops the content of annexed files from this repository, when possible.
14
15       git-annex will refuse to drop content if it cannot verify it is safe to
16       do so. Usually this involves verifying that the content  is  stored  in
17       some other repository.
18
19       Content  that  is  required  to be stored in the repository will not be
20       dropped   even   if   enough   copies   exist   elsewhere.   See   git-
21       annex-required(1).
22

OPTIONS

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

SEE ALSO

99       git-annex(1)
100
101       git-annex-get(1)
102
103       git-annex-move(1)
104
105       git-annex-copy(1)
106

AUTHOR

108       Joey Hess <id@joeyh.name>
109
110                                                             git-annex-drop(1)