diff-tree doc: correct & remove wrong documentation

The documentation saying that diff-tree didn't support anything except literal prefixes hasn't been true since d38f28093e ("tree_entry_interesting(): support wildcard matching", 2010-12-15), but this documentation was not updated at the time. Since this command uses pathspecs like most other commands, there's no need to show examples of how the various "cmd <revs> <paths>" invocations work. Furthermore, the "git diff-tree --abbrev 5319e4" example shown here never worked. We'd ended up with that through a combination of 62b42d3487 ("docs: fix some antique example output", 2011-05-26) and ac4e086929 ("Adjust core-git documentation to more recent Linus GIT.", 2005-05-05), but "git diff-tree <tree>" was always invalid. Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Ævar Arnfjörð Bjarmason committed Feb 4, 2019 at 11:36 UTC 9fce19a431d9fa9cbd8033a1961d3a1f579b6295
1 file changed +1 -50
Documentation/git-diff-tree.txt
+1 -50
@@ -31,10 +31,7 @@ include::diff-options.txt[]
31
32 <path>...::
33 If provided, the results are limited to a subset of files
34 - matching one of these prefix strings.
35 - i.e., file matches `/^<pattern1>|<pattern2>|.../`
36 - Note that this parameter does not provide any wildcard or regexp
37 - features.
34 + matching one of the provided pathspecs.
35
36 -r::
37 recurse into sub-trees
@@ -114,52 +111,6 @@ include::pretty-options.txt[]
111
112
113 include::pretty-formats.txt[]
117 -
118 -
119 -LIMITING OUTPUT
120 ----------------
121 -If you're only interested in differences in a subset of files, for
122 -example some architecture-specific files, you might do:
123 -
124 - git diff-tree -r <tree-ish> <tree-ish> arch/ia64 include/asm-ia64
125 -
126 -and it will only show you what changed in those two directories.
127 -
128 -Or if you are searching for what changed in just `kernel/sched.c`, just do
129 -
130 - git diff-tree -r <tree-ish> <tree-ish> kernel/sched.c
131 -
132 -and it will ignore all differences to other files.
133 -
134 -The pattern is always the prefix, and is matched exactly. There are no
135 -wildcards. Even stricter, it has to match a complete path component.
136 -I.e. "foo" does not pick up `foobar.h`. "foo" does match `foo/bar.h`
137 -so it can be used to name subdirectories.
138 -
139 -An example of normal usage is:
140 -
141 - torvalds@ppc970:~/git> git diff-tree --abbrev 5319e4
142 - :100664 100664 ac348b... a01513... git-fsck-objects.c
143 -
144 -which tells you that the last commit changed just one file (it's from
145 -this one:
146 -
147 ------------------------------------------------------------------------------
148 -commit 3c6f7ca19ad4043e9e72fa94106f352897e651a8
149 -tree 5319e4d609cdd282069cc4dce33c1db559539b03
150 -parent b4e628ea30d5ab3606119d2ea5caeab141d38df7
151 -author Linus Torvalds <torvalds@ppc970.osdl.org> Sat Apr 9 12:02:30 2005
152 -committer Linus Torvalds <torvalds@ppc970.osdl.org> Sat Apr 9 12:02:30 2005
153 -
154 -Make "git-fsck-objects" print out all the root commits it finds.
155 -
156 -Once I do the reference tracking, I'll also make it print out all the
157 -HEAD commits it finds, which is even more interesting.
158 ------------------------------------------------------------------------------
159 -
160 -in case you care).
161 -
162 -
114 include::diff-format.txt[]
115
116 GIT