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)