diff options
| author |  Joey Hess <joeyh@joeyh.name> | 2015-12-27 15:59:59 -0400 |
|---|---|---|
| committer | Joey Hess <joeyh@joeyh.name> | 2015-12-27 15:59:59 -0400 |
| commit | 60c88820987596809091ee010e6be2a083888bc8 (patch) | |
| tree | dc2540c6deadfcf3efee1fd95948bcbd6f219db5 /doc/git-annex-unlock.mdwn | |
| parent | 17490f3685aee698e10555c5dc3e915a317c2250 (diff) | |
annex.thin
Decided it's too scary to make v6 unlocked files have 1 copy by default,
but that should be available to those who need it. This is consistent with
git-annex not dropping unused content without --force, etc.
* Added annex.thin setting, which makes unlocked files in v6 repositories
be hard linked to their content, instead of a copy. This saves disk
space but means any modification of an unlocked file will lose the local
(and possibly only) copy of the old version.
* Enable annex.thin by default on upgrade from direct mode to v6, since
direct mode made the same tradeoff.
* fix: Adjusts unlocked files as configured by annex.thin.
Diffstat (limited to 'doc/git-annex-unlock.mdwn')
| -rw-r--r-- | doc/git-annex-unlock.mdwn | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/doc/git-annex-unlock.mdwn b/doc/git-annex-unlock.mdwn index 123146836..4b2b809fd 100644 --- a/doc/git-annex-unlock.mdwn +++ b/doc/git-annex-unlock.mdwn @@ -10,7 +10,7 @@ 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 a copy of the file's content. +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. @@ -22,6 +22,14 @@ can use `git add` to add a fie 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 repository version 6.) 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. + # OPTIONS * file matching options |