# [PATCH] diff: document diff-filter exclusion

2 messages from 2016-07-14 to 2016-07-14. Participants: Junio C Hamano, Stefan Beller.
Thread: https://gitlist.dev/t/42848

## Junio C Hamano, 2016-07-14 19:20

Subject: [PATCH] diff: document diff-filter exclusion
Message-ID: <xmqq7fcoqb5a.fsf@gitster.mtv.corp.google.com>
URL: https://gitlist.dev/e/xmqq7fcoqb5a.fsf%40gitster.mtv.corp.google.com

```
In v1.8.5 days, 7f2ea5f0 (diff: allow lowercase letter to specify
what change class to exclude, 2013-07-17) taught the "--diff-filter"
mechanism to take lowercase letters as exclusion, but we forgot to
document it.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
---
 Documentation/diff-options.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt
index 3ad6404..073c7e5 100644
--- a/Documentation/diff-options.txt
+++ b/Documentation/diff-options.txt
@@ -399,6 +399,9 @@ ifndef::git-format-patch[]
 	paths are selected if there is any file that matches
 	other criteria in the comparison; if there is no file
 	that matches other criteria, nothing is selected.
++
+Also, these upper-case letters can be downcased to exclude.  E.g.
+`--diff-filter=ad` excludes added and deleted paths.
 
 -S<string>::
 	Look for differences that change the number of occurrences of
-- 
2.9.1-545-g8c0a069


```

## Stefan Beller, 2016-07-14 19:27

Subject: Re: [PATCH] diff: document diff-filter exclusion
Message-ID: <CAGZ79ka5ZB=vL3j0Zm3vAvdZi7jA1gPAs61NhkVABZepfcuLvw@mail.gmail.com>
URL: https://gitlist.dev/e/CAGZ79ka5ZB%3DvL3j0Zm3vAvdZi7jA1gPAs61NhkVABZepfcuLvw%40mail.gmail.com
In-Reply-To: <xmqq7fcoqb5a.fsf@gitster.mtv.corp.google.com>

```
On Thu, Jul 14, 2016 at 12:20 PM, Junio C Hamano <gitster@pobox.com> wrote:
> In v1.8.5 days, 7f2ea5f0 (diff: allow lowercase letter to specify
> what change class to exclude, 2013-07-17) taught the "--diff-filter"
> mechanism to take lowercase letters as exclusion, but we forgot to
> document it.
>
> Signed-off-by: Junio C Hamano <gitster@pobox.com>
> ---
>  Documentation/diff-options.txt | 3 +++
>  1 file changed, 3 insertions(+)
>
> diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt
> index 3ad6404..073c7e5 100644
> --- a/Documentation/diff-options.txt
> +++ b/Documentation/diff-options.txt
> @@ -399,6 +399,9 @@ ifndef::git-format-patch[]
>         paths are selected if there is any file that matches
>         other criteria in the comparison; if there is no file
>         that matches other criteria, nothing is selected.
> ++
> +Also, these upper-case letters can be downcased to exclude.  E.g.
> +`--diff-filter=ad` excludes added and deleted paths.
>

This looks good for the neighboring thread. :)
http://thread.gmane.org/gmane.comp.version-control.git/299512

```