Skip to contentSkip to conversation

Fix diff-options references in git-diff and git-format-patch

PATCH New Brian Gernhardt 1 participant 1 message Jun 15, 2016 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Fix diff-options references in git-diff and git-format-patch

Most of the git-diff-* documentation used [<common diff options>] instead of [--diff-options], so make that change in git-diff and git-format-patch.

In addition, git-format-patch didn't include the meanings of the diff options.

---

Quoted 3 lines · Johannes Schindelin

Actually, it is described briefly in the synopsis. But not in the options section. Care to provide a patch (see git-log.txt for an example how to include the diff options)?

Something like this?

 Documentation/git-diff.txt         |    2 +-
 Documentation/git-format-patch.txt |    6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)
Documentation/git-diff.txt +1 -1
index 12a531d..044cee9 100644
@@ -8,7 +8,7 @@ git-diff - Show changes between commits, commit and working tree, etc
 
 SYNOPSIS
 --------
-'git-diff' [ --diff-options ] <commit>{0,2} [--] [<path>...]
+'git-diff' [<common diff options>] <commit>{0,2} [--] [<path>...]
 
 DESCRIPTION
 -----------
Documentation/git-format-patch.txt +4 -2
index 59f34b9..84eabeb 100644
@@ -9,8 +9,8 @@ git-format-patch - Prepare patches for e-mail submission
 SYNOPSIS
 --------
 [verse]
-'git-format-patch' [-n | -k] [-o <dir> | --stdout] [--attach] [--thread]
-	           [-s | --signoff] [--diff-options] [--start-number <n>]
+'git-format-patch' [<common diff options>] [-n | -k] [-o <dir> | --stdout]
+		   [--attach] [--thread] [-s | --signoff] [--start-number <n>]
 		   [--in-reply-to=Message-Id] [--suffix=.<sfx>]
 		   [--ignore-if-in-upstream]
 		   <since>[..<until>]
@@ -46,6 +46,8 @@ reference.
 
 OPTIONS
 -------
+include::diff-options.txt[]
+
 -o|--output-directory <dir>::
 	Use <dir> to store the resulting files, instead of the
 	current working directory.
Signature · 1 line
1.5.0.3.271.g5ced