From 623c04a7dd6e41089597a62f40f5746600c6729c Mon Sep 17 00:00:00 2001 From: Yaroslav Halchenko Date: Wed, 13 Nov 2024 13:03:07 -0500 Subject: [PATCH] Add FAQ with a question on git-annex and large files It would be my FAQ unless I do make it obviously available into my face in the documentation --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index c3fede9..b32dd4d 100644 --- a/README.md +++ b/README.md @@ -148,3 +148,11 @@ options: ``` + +## FAQs + +### git-annex add keeps adding duct logs directly into git + +By default, [git-annex](https://git-annex.branchable.com/) treats all dotfiles, and files under directories starting with a `.` as "small" regardless of `annex.largefiles` setting [[ref: an issue describing the logic](https://git-annex.branchable.com/bugs/add__58___inconsistently_treats_files_in_dotdirs_as_dotfiles/?updated#comment-efc1f2aa8f46e88a8be9837a56cfa6f7)]. +It is necessary to set `annex.dotfiles` variable to `true` to make git-annex treat them as regular files and thus subject to `annex.largefiles` setting [[ref: git-annex config](https://git-annex.branchable.com/git-annex-config/)]. +Could be done the repository (not just specific clone, but any instance since records in `git-annex` branch) wide using `git annex config --set annex.dotfiles true`.