summaryrefslogtreecommitdiff
path: root/doc/git-annex-adjust.mdwn
blob: 6f32f30298fb1b2795a3a25ccda7310b1991e5bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# NAME

git-annex adjust - enter an adjusted branch

# SYNOPSIS

git annex adjust `--unlock|--fix`

# DESCRIPTION

Enters an adjusted form of the current branch. The annexed files will
be treated differently. For example with --unlock all annexed files will
be unlocked.

The adjusted branch will have a name like "adjusted/master(unlocked)".
Since it's a regular git branch, you can use `git checkout` to switch
back to the original branch at any time.

While in the adjusted branch, you can use git-annex and git commands as
usual. Any commits that you make will initially only be made to the
adjusted branch. 

To propagate changes from the adjusted branch back to the original branch,
and to other repositories, as well as to merge in changes from other
repositories, use `git annex sync`.

This command can only be used in a v6 git-annex repository.

# OPTIONS

* `--unlock`

  Unlock all annexed files in the adjusted branch. This allows
  annexed files to be modified.

* `--fix`

  Fix the symlinks to annexed files to point to the local git annex
  object directory. This can be useful if a repository is checked out in an
  unusual way that prevents the symlinks committed to git from pointing at
  the annex objects.

# SEE ALSO

[[git-annex]](1)

[[git-annex-unlock]](1)

[[git-annex-upgrade]](1)

[[git-annex-sync]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.