NAME

       git-annex-adjust - enter an adjusted branch

SYNOPSIS

       git annex adjust --unlock|--lock|--fix|--hide-missing [--unlock|--lock|--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 commits from the adjusted branch back to the original branch, and to other repositories, as
       well as to merge in changes from other repositories, run git annex sync.

       When in an adjusted  branch,  using  git  merge  otherbranch  is  often  not  ideal,  because  merging  a
       non-adjusted  branch  may lead to unncessary merge conflicts, or add files in non-adjusted form. To avoid
       those problems, use git annex merge otherbranch.

       Re-running this command with the same options while inside the adjusted branch will update  the  adjusted
       branch as necessary (eg for --hide-missing), and will also propagate commits back to the original branch.

OPTIONS

       --unlock

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

              Normally, unlocking a file requires a copy to be made of its content, so that its original content
              is  preserved,  while  the copy can be modified.  To use less space, annex.thin can be set to true
              before running this command; this makes a hard link to the content be  made  instead  of  a  copy.
              (When supported by the file system.) While this can save considerable disk space, any modification
              made  to  a  file will cause the old version of the file to be lost from the local repository. So,
              enable annex.thin with care.

              When in an adjusted unlocked branch, git annex add will add files unlocked instead of the  default
              behavior of adding them locked.

       --lock Lock  all  annexed  file  in  the  adjusted branch. This may be preferred by those who like seeing
              broken symlinks when the content of an annexed file is not present.

              When in an adjusted locked branch, git annex add will add files locked, as usual. However, git add
              (and git commit -a etc) still add files unlocked. This is because it's not possible for those  git
              commands to add files locked.

       --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.

       --hide-missing
              Only include annexed files in the adjusted branch when their content is present.

              The  adjusted  branch  is not immediately changed when content availability changes, so if you git
              annex drop files, they will become broken links in the usual way. And when files that were missing
              are copied into the repository from elsewhere, they won't immediatly become visible in the branch.

              To update the adjusted branch to reflect changes to content availability,  run  git  annex  adjust
              --hide-missing again.

              Despite  missing  files being hidden, git annex sync --content will still operate on them, and can
              be used to download missing files from remotes.

              This option can be combined with --unlock, --lock, or --fix.

SEE ALSO

       git-annex(1)

       git-annex-unlock(1)

       git-annex-upgrade(1)

       git-annex-sync(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                             git-annex-adjust(1)