Add plumbing-level lookupkey examinekey command.

find --format: Added hashdirlower, hashdirmixed, keyname, and mtime format
variables.

1 files changed, 18 insertions, 1 deletions

diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn
index 5d61b8b40..692641caf 100644
--- a/doc/git-annex.mdwn
+++ b/doc/git-annex.mdwn
@@ -601,7 +601,7 @@ subdirectories).
   `--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
+  bytesize, humansize, keyname, hashdirlower, hashdirmixed, mtime.
 
 * `whereis [path ...]`
 
@@ -734,6 +734,23 @@ subdirectories).
   the file is not added to git, or is not a git-annex managed file),
   nothing is output, and it exits nonzero.
 
+* `examinekey [key ...]`
+
+  This plumbing-level command is given a key, and prints information
+  that can be determined purely by looking at the key.
+
+  To specify what information to print, use `--format`. Or use `--json`
+  to get all available information in JSON format.
+
+  The same variables can be used in the format string as can be used in
+  the format string of git annex find (except there is no file option
+  here).
+
+  For example, the location a key's value is stored (in indirect mode)
+  can be looked up by running:
+  
+        	git annex examinekey --format='.git/annex/objects/${hashdirmixed}${key}/${key}'
+
 * `fromkey key file`
 
   This plumbing-level command can be used to manually set up a file