1git-annex-adjust(1) General Commands Manual git-annex-adjust(1)
2
3
4
6 git-annex-adjust - enter an adjusted branch
7
9 git annex adjust --unlock|--lock|--fix|--hide-missing
10 [--unlock|--lock|--fix]
11
13 Enters an adjusted form of the current branch. The annexed files will
14 be treated differently. For example with --unlock all annexed files
15 will be unlocked.
16
17 The adjusted branch will have a name like "adjusted/master(unlocked)".
18 Since it's a regular git branch, you can use git checkout to switch
19 back to the original branch at any time.
20
21 While in the adjusted branch, you can use git-annex and git commands as
22 usual. Any commits that you make will initially only be made to the
23 adjusted branch.
24
25 To propagate commits from the adjusted branch back to the original
26 branch, and to other repositories, as well as to merge in changes from
27 other repositories, run git annex sync.
28
29 When in an adjusted branch, using git merge otherbranch is often not
30 ideal, because merging a non-adjusted branch may lead to unncessary
31 merge conflicts, or add files in non-adjusted form. To avoid those
32 problems, use git annex merge otherbranch.
33
34 Re-running this command with the same options while inside the adjusted
35 branch will update the adjusted branch as necessary (eg for
36 --hide-missing), and will also propagate commits back to the original
37 branch.
38
40 --unlock
41
42 Unlock all annexed files in the adjusted branch. This allows
43 annexed files to be modified.
44
45 Normally, unlocking a file requires a copy to be made of its
46 content, so that its original content is preserved, while the
47 copy can be modified. To use less space, annex.thin can be set
48 to true before running this command; this makes a hard link to
49 the content be made instead of a copy. (When supported by the
50 file system.) While this can save considerable disk space, any
51 modification made to a file will cause the old version of the
52 file to be lost from the local repository. So, enable annex.thin
53 with care.
54
55 When in an adjusted unlocked branch, git annex add will add
56 files unlocked instead of the default behavior of adding them
57 locked.
58
59 --lock Lock all annexed file in the adjusted branch. This may be pre‐
60 ferred by those who like seeing broken symlinks when the content
61 of an annexed file is not present.
62
63 When in an adjusted locked branch, git annex add will add files
64 locked, as usual. However, git add (and git commit -a etc) still
65 add files unlocked. This is because it's not possible for those
66 git commands to add files locked.
67
68 --fix Fix the symlinks to annexed files to point to the local git
69 annex object directory. This can be useful if a repository is
70 checked out in an unusual way that prevents the symlinks commit‐
71 ted to git from pointing at the annex objects.
72
73 --hide-missing
74 Only include annexed files in the adjusted branch when their
75 content is present.
76
77 The adjusted branch is not immediately changed when content
78 availability changes, so if you git annex drop files, they will
79 become broken links in the usual way. And when files that were
80 missing are copied into the repository from elsewhere, they
81 won't immediatly become visible in the branch.
82
83 To update the adjusted branch to reflect changes to content
84 availability, run git annex adjust --hide-missing again.
85
86 Despite missing files being hidden, git annex sync --content
87 will still operate on them, and can be used to download missing
88 files from remotes.
89
90 This option can be combined with --unlock, --lock, or --fix.
91
93 git-annex(1)
94
95 git-annex-unlock(1)
96
97 git-annex-upgrade(1)
98
99 git-annex-sync(1)
100
102 Joey Hess <id@joeyh.name>
103
104 git-annex-adjust(1)