From 31d4313d575a566a695d93e3e7ee34bddd41d705 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Wed, 2 Dec 2015 14:26:49 -0400 Subject: improve annex.largefiles documentation --- doc/git-annex.mdwn | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn index fca499a7e..8a624b507 100644 --- a/doc/git-annex.mdwn +++ b/doc/git-annex.mdwn @@ -789,16 +789,23 @@ Here are all the supported configuration settings. * `annex.largefiles` - Allows configuring which files `git annex add` and the assistant consider - to be large enough to need to be added to the annex. By default, - all files are added to the annex. + Allows configuring which files are considered to be large enough to + need to be added to the annex. By default, all specified files are added + to the annex, but configuring this can cause the small files to be + checked into git, without using the annex. The value is a preferred content expression. See [[git-annex-preferred-content]](1) for details. Example: - annex.largefiles = largerthan=100kb and not (include=*.c or include=*.h) + annex.largefiles = largerthan=100kb and not (include=*.c or include=*.h) + + This setting is used by `git annex add` and the assistant. + It can be useful to temporarily override it via -c at the command line. + For example: + + git annex add -c annex.largefiles='include=*' 99kbfile * `annex.numcopies` -- cgit v1.2.3