update

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