git-annex-unlock(1)         General Commands Manual        git-annex-unlock(1)

       git-annex-unlock - unlock files for modification

       git annex unlock [path ...]

       Normally, the content of annexed files is protected from being changed.
       Unlocking an annexed file allows it to be modified. This replaces the
       symlink for each specified file with the file's content.  You can then
       modify it and git annex add (or git commit) to save your changes.

       In v5 repositories, unlocking a file is local to the repository, and is
       temporary. In v7 repositories, unlocking a file changes how it is
       stored in the git repository (from a symlink to a pointer file), so you
       can commit it like any other change. Also in v7, you can use git add to
       add a file to the annex in unlocked form. This allows workflows where a
       file starts out unlocked, is modified as necessary, and is locked once
       it reaches its final version.

       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; this makes
       a hard link to the content be made instead of a copy. (Only when
       supported by the file system, and only in v7 and higher.) 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.

       file matching options

              The git-annex-matching-options(1) can be used to specify files
              to unlock.

       --json Enable JSON output. This is intended to be parsed by programs
              that use git-annex. Each line of output is a JSON object.

              Messages that would normally be output to standard error are
              included in the json instead.





       Joey Hess <>