git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] Documentation: Move "git diff <blob> <blob>"

From
Kevin Bracey <kevin@bracey.fi>
Date
Jun 18, 2013, 14:58 UTC
Message-ID
<1371567530-21811-1-git-send-email-kevin@bracey.fi>

The section describing "git diff <blob> <blob>" had been placed in a position that disrupted the statement "This is synonymous to the previous form".

Reorder to place this form after all the <commit>-using forms, and the note applying to them. Also mention this form in the initial description paragraph.

Signed-off-by: Kevin Bracey <kevin@bracey.fi>
---
 Documentation/git-diff.txt | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt
index a7b4620..78d6d50 100644
--- a/Documentation/git-diff.txt
+++ b/Documentation/git-diff.txt
@@ -18,8 +18,8 @@ SYNOPSIS
 DESCRIPTION
 -----------
 Show changes between the working tree and the index or a tree, changes
-between the index and a tree, changes between two trees, or changes
-between two files on disk.
+between the index and a tree, changes between two trees, changes between
+two blob objects, or changes between two files on disk.
 
 'git diff' [--options] [--] [<path>...]::
 
@@ -56,11 +56,6 @@ directories. This behavior can be forced by --no-index.
 	This is to view the changes between two arbitrary
 	<commit>.
 
-'git diff' [options] <blob> <blob>::
-
-	This form is to view the differences between the raw
-	contents of two blob objects.
-
 'git diff' [--options] <commit>..<commit> [--] [<path>...]::
 
 	This is synonymous to the previous form.  If <commit> on
@@ -87,6 +82,11 @@ and the range notations ("<commit>..<commit>" and
 "<commit>\...<commit>") do not mean a range as defined in the
 "SPECIFYING RANGES" section in linkgit:gitrevisions[7].
 
+'git diff' [options] <blob> <blob>::
+
+	This form is to view the differences between the raw
+	contents of two blob objects.
+
 OPTIONS
 -------
 :git-diff: 1
-- 
1.8.3.rc0.28.g4b02ef5
Next: Junio C Hamano
Message 1 of 2 in “Documentation: Move "git diff <blob> <blob>"”
  1. Documentation: Move "git diff <blob> <blob>"Kevin Bracey, Jun 18, 2013
  2. Junio C HamanoJun 18, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.