Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
git-annex-view(1)	    General Commands Manual	     git-annex-view(1)

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  up-
       dates 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 con-
       struct 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 di-
       rectory 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)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=git-annex-view&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help