# Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF

2 messages from 2007-02-13 to 2007-02-14. Participants: Yann Dirson, Jakub Narebski.
Thread: https://gitlist.dev/t/6809

## Yann Dirson, 2007-02-13 22:36

Subject: Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF
Message-ID: <20070213223657.GC4266@nan92-1-81-57-214-146.fbx.proxad.net>
URL: https://gitlist.dev/e/20070213223657.GC4266%40nan92-1-81-57-214-146.fbx.proxad.net

```
I noticed today, after unsuccessfully trying GIT_DIFF_OPTS=-U2, that
1) it did not work, 2) the doc in 1.4.4.4 tells about using
"GIT_DIFF_OPTS=-c", which does not work either and 3) there is
virtually no more doc about it in HEAD.

It would be useful to document which flags are recognized, and notably
that -u<n> has to be used instead of GNU diff's -U<n>.

At the same time, I noticed that GIT_EXTERNAL_DIFF is not described in
the diff docs either, although it is described in the main git.txt
page (which may not be the place where users would look for it - at
least, only my grep aiming to be accurate before composing this mail
finally found it).

Best regards,
-- 
Yann.

```

## Jakub Narebski, 2007-02-14 01:27

Subject: Re: Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF
Message-ID: <eqtof8$8id$1@sea.gmane.org>
URL: https://gitlist.dev/e/eqtof8%248id%241%40sea.gmane.org
In-Reply-To: <20070213223657.GC4266@nan92-1-81-57-214-146.fbx.proxad.net>

```
Yann Dirson wrote:

> I noticed today, after unsuccessfully trying GIT_DIFF_OPTS=-U2, that
> 1) it did not work, 2) the doc in 1.4.4.4 tells about using
> "GIT_DIFF_OPTS=-c", which does not work either and 3) there is
> virtually no more doc about it in HEAD.
> 
> It would be useful to document which flags are recognized, and notably
> that -u<n> has to be used instead of GNU diff's -U<n>.
> 
> At the same time, I noticed that GIT_EXTERNAL_DIFF is not described in
> the diff docs either, although it is described in the main git.txt
> page (which may not be the place where users would look for it - at
> least, only my grep aiming to be accurate before composing this mail
> finally found it).

GIT_DIFF_OPTS are also described there.
-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git

```
