git-annex-diffdriver(1) | General Commands Manual | git-annex-diffdriver(1) |
git-annex-diffdriver - external git diff driver shim
git annex diffdriver -- cmd --opts --
This is an external git diff driver shim. Normally, when using git diff with an external diff driver, it will not see the contents of annexed files, since git passes to it the git-annex symlinks or pointer files. This command works around the problem, by running the real external diff driver, and passing it the paths to the annexed content.
To use this, you will need to have installed some git external diff driver command. This is not the regular diff command; it takes a git-specific input. See git's documentation of GIT_EXTERNAL_DIFF and gitattributes(5)'s documentation of external diff drivers.
Configure git to use "git-annex diffdriver -- cmd params --" as the external diff driver, where cmd is the external diff driver you want it to run, and params are any extra parameters to pass to it. Note the trailing "--", which is required.
For example, set GIT_EXTERNAL_DIFF=git-annex diffdriver -- j-c-diff --
Normally "--" followed by the diff driver command, its options, and another "--"
Also the git-annex-common-options(1) can be used.
Joey Hess <id@joeyh.name>