threads / discuss / 6809

Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF

Subject: Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF

## tl;dr

2 messages between Feb 13, 2007 and Feb 14, 2007.

replies: 1people: 2as markdown or json

Yann Dirson· Feb 13, 2007, 22:36 UTC · lore

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· Feb 14, 2007, 01:27 UTC · re: Yann Dirson · lore

Re: Missing documentation for GIT_DIFF_OPTS and GIT_EXTERNAL_DIFF

Yann Dirson wrote:

Show 13 quoted lines

> 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