bionic (1) git-annex-view.1.gz

NAME

       git-annex-view - enter a view branch

SYNOPSIS

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

DESCRIPTION

       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 metadata.

       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 value.

SEE ALSO

       git-annex(1)

       git-annex-metadata(1)

       git-annex-vpop(1)

       git-annex-vfilter(1)

       git-annex-vadd(1)

       git-annex-vcycle(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                               git-annex-view(1)