From a7ae014eb63fa18ba0c387022bed8b3c85ab10a3 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 31 Jul 2023 13:28:02 -0400 Subject: [PATCH] mention --explain Sponsored-by: Dartmouth College's DANDI project --- doc/git-annex-preferred-content.mdwn | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/git-annex-preferred-content.mdwn b/doc/git-annex-preferred-content.mdwn index e12809f556..ea429228cf 100644 --- a/doc/git-annex-preferred-content.mdwn +++ b/doc/git-annex-preferred-content.mdwn @@ -283,6 +283,13 @@ For example, git annex find --want-get --not --in . will find all the files that git annex get --auto will want to get, and git annex find --want-drop --in . will find all the files that git annex drop --auto will want to drop. +The --explain option can be used to understand why a complex preferred +content expression matches or fails to match. The expression will +be displayed, with each term followed by "[TRUE]" or "[FALSE]" to indicate +the value. Irrelevant terms will be ommitted from the explanation, +for example "exclude=* and copies=1"` will be displayed as +`"exclude=*[FALSE]"` + # SEE ALSO [[git-annex]](1) -- 2.30.2