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  up‐
26       dates 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 di‐
35       rectory 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

OPTIONS

43       The git-annex-common-options(1) can be used.
44

SEE ALSO

46       git-annex(1)
47
48       git-annex-metadata(1)
49
50       git-annex-vpop(1)
51
52       git-annex-vfilter(1)
53
54       git-annex-vadd(1)
55
56       git-annex-vcycle(1)
57

AUTHOR

59       Joey Hess <id@joeyh.name>
60
61                                                             git-annex-view(1)
Impressum