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
23       With  no  parameters,  tries  to  drop all annexed files in the current
24       directory.  Paths of files or directories to drop can be specified.
25

EXAMPLES

27        # git annex drop *.jpeg
28        drop photo1.jpg (checking origin...) ok
29        drop photo2.jpg (unsafe)
30          Could only verify the existence of 0 out of 1 necessary copies
31
32          Rather than dropping this file, try using: git annex move
33
34          (Use --force to override this check, or adjust numcopies.)
35        failed
36        drop photo3.jpg (checking origin...) ok
37

OPTIONS

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

SEE ALSO

114       git-annex(1)
115
116       git-annex-get(1)
117
118       git-annex-move(1)
119
120       git-annex-copy(1)
121

AUTHOR

123       Joey Hess <id@joeyh.name>
124
125                                                             git-annex-drop(1)
Impressum