summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/preferred_content.mdwn15
1 files changed, 10 insertions, 5 deletions
diff --git a/doc/preferred_content.mdwn b/doc/preferred_content.mdwn
index d3aa4fa47..9b9b399a1 100644
--- a/doc/preferred_content.mdwn
+++ b/doc/preferred_content.mdwn
@@ -55,7 +55,9 @@ from the command line options to keep in mind:
While --include and --exclude match files relative to the current
directory, preferred content expressions always match files relative to the
-top of the git repository. Perhaps you put files into `archive` directories
+top of the git repository.
+
+For example, suppose you put files into `archive` directories
when you're done with them. Then you could configure your laptop to prefer
to not retain those files, like this:
@@ -179,10 +181,13 @@ content expression won't match anything.
So when is `unused` useful in a preferred content expression?
-The git-annex assistant periodically scans for unused files, and
-moves them to some repository whose preferred content expression
-matches "unused". (Or, if annex.expireunused is set, it may just delete
-them.)
+* The git-annex assistant periodically scans for unused files, and
+ moves them to some repository whose preferred content expression
+ matches "unused". (Or, if annex.expireunused is set, it may just delete
+ them.)
+* Using `git annex sync --content --all` will operate on all files,
+ including unused ones, and take `unused` in preferred content expressions
+ into account.
## upgrades