Format strings can be specified using the new --find option, to control what is output by git annex find.

1 files changed, 13 insertions, 1 deletions

diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn
index f4eef5c4c..70e54a91f 100644
--- a/doc/git-annex.mdwn
+++ b/doc/git-annex.mdwn
@@ -250,7 +250,11 @@ subdirectories).
   annexed files whose content is not present, specify --not --in "."
 
   To output filenames terminated with nulls, for use with xargs -0,
-  specify --print0.
+  specify --print0. Or, a custom output formatting can be specified using
+  --format. The default output format is the same as --format='${file}\n'
+
+  These variables are available for use in formats: file, key, backend,
+  bytesize, humansize
 
 * whereis [path ...]
 
@@ -428,6 +432,14 @@ subdirectories).
   are in the annex, their backend is known and this option is not
   necessary.
 
+* --format=value
+
+  Specifies a custom output format. The value is a format string, 
+  in which '${var}' is expanded to the value of a variable. To right-align
+  a variable with whitespace, use '${var;width}' ; to left-align
+  a variable, use '${var;-width}'. Also, '\n' is a newline, '\0' is a NULL,
+  etc.
+
 * -c name=value
 
   Used to override git configuration settings. May be specified multiple times.