docs for git-annex adjust

This commit is contained in:
Joey Hess 2016-03-29 11:33:26 -04:00
parent 1df62b43d1
commit 4c9ca98769
Failed to extract signature
5 changed files with 71 additions and 0 deletions

View file

@ -95,6 +95,8 @@ mode is used. To make them always use unlocked mode, run:
`git config annex.addunlocked true`
"""]]
## mixing locked and unlocked files
A v6 repository can contain both locked and unlocked files. You can switch
a file back and forth using the `git annex lock` and `git annex unlock`
commands. This changes what's stored in git between a git-annex symlink
@ -102,6 +104,12 @@ commands. This changes what's stored in git between a git-annex symlink
the repository in locked mode, use `git annex add`; to add a file in
unlocked mode, use `git add`.
If you want to mostly keep files locked, but be able to locally switch
to having them all unlocked, you can do so using `git annex adjust
--unlock`. See [[git-annex-adjust]] for details. This is particularly
useful when using filesystems like FAT, and OS's like Windows that don't
support symlinks.
## using less disk space
Unlocked files are handy, but they have one significant disadvantage