aboutsummaryrefslogtreecommitdiff
path: root/doc/tips/unlocked_files.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2016-03-29 11:33:26 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2016-03-29 11:39:43 -0400
commit4e12a0146f3d76282b2f406f4fcb377450085447 (patch)
tree94247bccb01634440af74373143d765c24d926af /doc/tips/unlocked_files.mdwn
parent34018982ccb3e78b71446b7cf91e6f45ef644b48 (diff)
docs for git-annex adjust
Diffstat (limited to 'doc/tips/unlocked_files.mdwn')
-rw-r--r--doc/tips/unlocked_files.mdwn8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/tips/unlocked_files.mdwn b/doc/tips/unlocked_files.mdwn
index fd103940e..cc9972f9e 100644
--- a/doc/tips/unlocked_files.mdwn
+++ b/doc/tips/unlocked_files.mdwn
@@ -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