document direct mode files

This commit is contained in:
Joey Hess 2012-12-25 14:25:47 -04:00
parent 8a8380f1b7
commit 221584ec7f

View file

@ -17,6 +17,15 @@ This two-level structure is used because it allows the write bit to be removed
from the subdirectories as well as from the files. That prevents accidentially
deleting or changing the file contents.
In [[direct_mode]], file contents are not stored in here, and instead
are stored directly in the file. However, the same symlinks are still
committed to git, internally.
Also in [[direct_mode]], some additional data is stored in these directories.
`.cache` files contain cached file stats used in detecting when a file has
changed, and `.map` files contain a list of file(s) in the work directory
that contain the key.
## The git-annex branch
This branch is managed by git-annex, with the contents listed below.