Thanks for the clarification! I also didn't realize that diff-files -R will show added files. You learn something new everyday ;) On Thu, Jan 4, 2018 at 11:09 AM, Junio C Hamano <gitster@xxxxxxxxx> wrote: > Jeff King <peff@xxxxxxxx> writes: > >> diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt >> index 9d1586b956..743af97b06 100644 >> --- a/Documentation/diff-options.txt >> +++ b/Documentation/diff-options.txt >> @@ -469,6 +469,12 @@ ifndef::git-format-patch[] >> + >> Also, these upper-case letters can be downcased to exclude. E.g. >> `--diff-filter=ad` excludes added and deleted paths. >> ++ >> +Note that not all diffs can feature all types. For instance, diffs >> +from the index to the working tree can never have Added entries >> +(because the set of paths included in the diff is limited by what is in >> +the index). Similarly, copied and renamed entries cannot appear if >> +detection for those types is disabled. > > Makes sense; thanks. -- --- John L Cheng