1git-annex-view(1)           General Commands Manual          git-annex-view(1)
2
3
4

NAME

6       git-annex-view - enter a view branch
7

SYNOPSIS

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

DESCRIPTION

13       Uses metadata to build a view  branch  of  the  files  in  the  current
14       branch,  and  checks  out  the  view  branch. Only files in the current
15       branch whose metadata matches all the specified field values  and  tags
16       will be shown in the view.
17
18       Multiple  values for a metadata field can be specified, either by using
19       a glob (field="*") or by listing each wanted value. The resulting  view
20       will  put  files  in  subdirectories  according  to  the value of their
21       fields.
22
23       Once within such a view, you can make additional directories, and  copy
24       or  move files into them. When you commit, the metadata will be updated
25       to correspond to your  changes.  Deleting  files  and  committing  also
26       updates the metadata.
27
28       There  are  fields  corresponding  to  the  path to the file. So a file
29       "foo/bar/baz/file" has fields "/=foo", "foo/=bar", and  "foo/bar/=baz".
30       These  location  fields  can be used the same as other metadata to con‐
31       struct the view.
32
33       For example, /=foo will only include files from the  foo  directory  in
34       the  view,  while  foo/=*  will  preserve the subdirectories of the foo
35       directory in the view.
36
37       To enter a view containing only files that lack a given metadata  field
38       or  tag,  specify field!=value or !tag. Globs can also be used here, so
39       field!="*" will enter a view containing only files that do not have the
40       field set to any value.
41

SEE ALSO

43       git-annex(1)
44
45       git-annex-metadata(1)
46
47       git-annex-vpop(1)
48
49       git-annex-vfilter(1)
50
51       git-annex-vadd(1)
52
53       git-annex-vcycle(1)
54

AUTHOR

56       Joey Hess <id@joeyh.name>
57
58                                                             git-annex-view(1)