describe: when failing, tell the user about options that work

diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt
index c53eba557d0a242a0d8553d9569ce8b2eb86331b..0ac711230e24bf7238b2e3a215cdc3c4ce0d2087 100644 (file)
--- a/Documentation/git-diff.txt
+++ b/Documentation/git-diff.txt
@@ -33,6 +33,7 @@ forced by --no-index.
        commit relative to the named <commit>.  Typically you
        would want comparison with the latest commit, so if you
        do not give <commit>, it defaults to HEAD.
+       --staged is a synonym of --cached.
 
 'git diff' [--options] <commit> [--] [<path>...]::
 
@@ -83,8 +84,7 @@ include::diff-options.txt[]
        the diff to the named paths (you can give directory
        names and get diff for all files under them).
 
-Output format
--------------
+
 include::diff-format.txt[]
 
 EXAMPLES