SYNOPSIS

       git annex drop [path ...]

DESCRIPTION

       Drops the content of annexed files from this repository, when possible.

       git-annex  will  refuse  to  drop content if it cannot verify it is safe to do so. Usually
       this involves verifying that the content is stored in some other repository.

       Content that is required to be stored in the repository will not be dropped even if enough
       copies exist elsewhere. See git-annex-required(1).

OPTIONS

       --from=remote

              Rather  than dropping the content of files in the local repository, this option can
              specify a remote from which the files' contents should be removed.

       --auto Rather than trying to drop all specified  files,  drop  only  files  that  are  not
              preferred content of the repository.  See git-annex-preferred-content(1)

       --force
              Use  this  option  with  care!  It  bypasses safety checks, and forces git-annex to
              delete the content of the specified files, even from the last  repository  that  is
              storing their content. Data loss can result from using this option.

       --all -A
              Rather  than specifying a filename or path to drop, this option can be used to drop
              all available versions of all files.

              This is the default behavior when running git-annex drop in a bare repository.

              Note that this bypasses checking the  .gitattributes  annex.numcopies  setting  and
              required content settings.

       --branch=ref
              Drop files in the specified branch or treeish.

              Note  that  this  bypasses  checking the .gitattributes annex.numcopies setting and
              required content settings.

       --unused
              Drop files found by last run of git-annex unused.

              Note that this bypasses checking the  .gitattributes  annex.numcopies  setting  and
              required content settings.

       --key=keyname
              Use this option to drop a specified key.

              Note  that  this  bypasses  checking the .gitattributes annex.numcopies setting and
              required content settings.

       file matching options
              The git-annex-matching-options(1) can be used to specify files to drop.

       --jobs=N -JN
              Runs multiple drop jobs in parallel. This is particularly useful when git-annex has
              to contact remotes to check if it can drop files.  For example: -J4

              Setting this to "cpus" will run one job per CPU core.

       --batch
              Enables  batch mode, in which lines containing names of files to drop are read from
              stdin.

              As each specified file is processed, the usual output is  displayed.  If  a  file's
              content  is  not present, or it does not match specified matching options, or it is
              not an annexed file, a blank line is output in response instead.

       -z     Makes the --batch input be delimited by nulls instead of the usual newlines.

       --json Enable JSON output. This is intended to be parsed by programs that  use  git-annex.
              Each line of output is a JSON object.

       --json-error-messages
              Messages  that  would normally be output to standard error are included in the json
              instead.

SEE ALSO

       git-annex(1)

       git-annex-get(1)

       git-annex-move(1)

       git-annex-copy(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                git-annex-drop(1)