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

NAME

6       git-annex-adjust - enter an adjusted branch
7

SYNOPSIS

9       git annex adjust --unlock|--fix|--hide-missing [--unlock|--fix]
10

DESCRIPTION

12       Enters  an  adjusted form of the current branch. The annexed files will
13       be treated differently. For example with  --unlock  all  annexed  files
14       will be unlocked.
15
16       The  adjusted branch will have a name like "adjusted/master(unlocked)".
17       Since it's a regular git branch, you can use  git  checkout  to  switch
18       back to the original branch at any time.
19
20       While in the adjusted branch, you can use git-annex and git commands as
21       usual. Any commits that you make will initially only  be  made  to  the
22       adjusted branch.
23
24       To  propagate  commits  from  the  adjusted branch back to the original
25       branch, and to other repositories, as well as to merge in changes  from
26       other repositories, run git annex sync.
27
28       Re-running this command with the same options while inside the adjusted
29       branch  will  update  the  adjusted  branch  as   necessary   (eg   for
30       --hide-missing),  and  will also propagate commits back to the original
31       branch.
32
33       This command can only be used in a v6 git-annex repository.
34

OPTIONS

36       --unlock
37
38              Unlock all annexed files in the  adjusted  branch.  This  allows
39              annexed files to be modified.
40
41              Normally,  unlocking  a  file  requires a copy to be made of its
42              content, so that its original content is  preserved,  while  the
43              copy  can be modified.  To use less space, annex.thin can be set
44              to true before running this command; this makes a hard  link  to
45              the  content  be made instead of a copy.  (When supported by the
46              file system.) While this can save considerable disk  space,  any
47              modification  made  to  a file will cause the old version of the
48              file to be lost from the local repository. So, enable annex.thin
49              with care.
50
51       --fix  Fix  the  symlinks  to  annexed  files to point to the local git
52              annex object directory. This can be useful if  a  repository  is
53              checked out in an unusual way that prevents the symlinks commit‐
54              ted to git from pointing at the annex objects.
55
56       --hide-missing
57              Only include annexed files in the  adjusted  branch  when  their
58              content is present.
59
60              The  adjusted  branch  is  not  immediately changed when content
61              availability changes, so if you git annex drop files, they  will
62              become  broken  links in the usual way. And when files that were
63              missing are copied into  the  repository  from  elsewhere,  they
64              won't immediatly become visible in the branch.
65
66              To  update  the  adjusted  branch  to reflect changes to content
67              availability, run git annex adjust --hide-missing again.
68
69              Despite missing files being hidden,  git  annex  sync  --content
70              will  still operate on them, and can be used to download missing
71              files from remotes.
72
73              This option can be combined with --unlock or --fix.
74

SEE ALSO

76       git-annex(1)
77
78       git-annex-unlock(1)
79
80       git-annex-upgrade(1)
81
82       git-annex-sync(1)
83

AUTHOR

85       Joey Hess <id@joeyh.name>
86
87                                                           git-annex-adjust(1)
Impressum