From 221584ec7fbdfa5fa4814a22c22b7322d713769b Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Tue, 25 Dec 2012 14:25:47 -0400 Subject: [PATCH] document direct mode files --- doc/internals.mdwn | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/internals.mdwn b/doc/internals.mdwn index 34498b912a..3136993f09 100644 --- a/doc/internals.mdwn +++ b/doc/internals.mdwn @@ -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.