“git diff”中的“diff --git”输出是指什么？

Question

当我运行git diff，输出始于：

diff --git a/foo/bar b/foo/bar 

如果我尝试运行普通的旧diff --git，我听说了--git选项不存在（很明显，我想，它会看起来很可笑要知道一个特定的DVCS的低级工具）。在man页面中也没有提及它。这是从哪里来的？

Answer 1

这是一个 “想象的diff选项”，用于指示它的不只是运行的输出读者diff命令。例如，在混帐自己的混帐回购协议：

$ git diff HEAD~1..HEAD | head 
diff --git Documentation/git.txt Documentation/git.txt 
index bd659c4..7913fc2 100644 
--- Documentation/git.txt 
+++ Documentation/git.txt 
@@ -43,6 +43,11 @@ unreleased) version of Git, that is available from the 'master' 
branch of the `git.git` repository. 
Documentation for older releases are available here: 

+* link:v2.10.0/git.html[documentation for release 2.10] 
+ 
$ 

的diff命令本身，如果你使用相同的文件名调用它两次，会显示无显着差异。 git大概会创建对应于Documentation/git.txt的两个不同版本的临时文件，并将它们提供给diff - 但这些临时文件的名称不会有用。我认为git diff按摩diff的输出使其对读者更有意义。

跳水到Git的源代码，diff.c有硬作为一个字符串字面量字符串"diff --git"：

strbuf_addf(&header, "%s%sdiff --git %s %s%s\n", line_prefix, meta, a_one, b_two, reset); 

而寻找到的diff.c的最早版本包含字符串的历史：

$ git log -n 1 b58f23b3 
commit b58f23b38a9a9f28d751311353819d3cdf6a86da 
Author: Junio C Hamano <junkio@cox.net> 
Date: 2005-05-18 09:10:47 -0700 

    [PATCH] Fix diff output take #4. 

    This implements the output format suggested by Linus in 
    <Pine.LNX.4.58.0505161556260.18337@ppc970.osdl.org>, except the 
    imaginary diff option is spelled "diff --git" with double dashes as 
    suggested by Matthias Urlichs. 

    Signed-off-by: Junio C Hamano <junkio@cox.net> 
    Signed-off-by: Linus Torvalds <torvalds@osdl.org> 
$ 

推测<Pine.LNX...>是某个邮件列表中某个电子邮件消息的消息标识。无论如何，这个提交信息表明diff --git是一个“虚构差异选项”。

This email message，在评论中被nos引用，似乎是导致这种情况的讨论的一部分。

Answer 2

--git是指diff是以“git”diff格式。它不涉及和选项/usr/bin/diff命令您可以找到diff format文档的列表。其他格式有：

• diff --combined
• diff --cc
• diff --summary