git‐annex‐view − enter a view branch

git annex view [tag ...] [field=value ...] [field=glob ...]
[!tag ...] [field!=value ...]

Uses metadata to build a view branch of the files in the
current branch, and checks out the view branch. Only files
in the current branch whose metadata matches all the
specified field values and tags will be shown in the view.

     Multiple values for a metadata field can be specified,
either by using a glob (field="*") or by listing each wanted
value. The resulting view will put files in subdirectories
according to the value of their fields.

     Once within such a view, you can make additional
directories, and copy or move files into them. When you
commit, the metadata will be updated to correspond to your
changes. Deleting files and committing also updates the

     There are fields corresponding to the path to the file.
So a file "foo/bar/baz/file" has fields "/=foo", "foo/=bar",
and "foo/bar/=baz".  These location fields can be used the
same as other metadata to construct the view.

     For example, /=foo will only include files from the foo
directory in the view, while foo/=* will preserve the
subdirectories of the foo directory in the view.

     To enter a view containing only files that lack a given
metadata field or tag, specify field!=value or !tag. Globs
can also be used here, so field!="*" will enter a view
containing only files that do not have the field set to any








Joey Hess <>