summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/git-annex.mdwn14
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.