1git-annex-diffdriver(1) General Commands Manual git-annex-diffdriver(1)
2
3
4
6 git-annex-diffdriver - external git diff driver shim
7
9 git annex diffdriver -- cmd --opts --
10
12 This is an external git diff driver shim. Normally, when using git diff
13 with an external diff driver, it will not see the contents of annexed
14 files, since git passes to it the git-annex symlinks or pointer files.
15 This command works around the problem, by running the real external
16 diff driver, and passing it the paths to the annexed content.
17
18 To use this, you will need to have installed some git external diff
19 driver command. This is not the regular diff command; it takes a
20 git-specific input. See git's documentation of GIT_EXTERNAL_DIFF and
21 gitattributes(5)'s documentation of external diff drivers.
22
23 Configure git to use "git-annex diffdriver -- cmd params --" as the ex‐
24 ternal diff driver, where cmd is the external diff driver you want it
25 to run, and params are any extra parameters to pass to it. Note the
26 trailing "--", which is required.
27
28 For example, set GIT_EXTERNAL_DIFF=git-annex diffdriver -- j-c-diff --
29
31 Normally "--" followed by the diff driver command, its options, and an‐
32 other "--"
33
34 Also the git-annex-common-options(1) can be used.
35
37 git-annex(1)
38
40 Joey Hess <id@joeyh.name>
41
42 git-annex-diffdriver(1)