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)
AUTHOR
Joey Hess id@joeyh.name
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
From git-annex-fix manual:
So what is the difference between that and git-annex adjust --fix?
git annex fix
fixes up the symlinks before they're committed. It's run by the pre-commit hook, so even when annexed files are manually moved around, the symlinks that get committed are always right.So then, if the symlinks committed are always right, how would
git annex adjust --fix
be useful? Well, there are ways to check out git repositories that make the .git directory not be in the usual place. For example, when using submodules, git puts that directory in a different place. And then the committed symlinks won't point to .git. So,git annex adjust --fix
is useful as a way to adjust the symlinks locally, without committing any changes to them, in that kind of situation.