summaryrefslogtreecommitdiffstats
path: root/gitattributes.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2007-04-23 07:27:05 +0000
committerJunio C Hamano <junio@hera.kernel.org>2007-04-23 07:27:05 +0000
commit9db95ca51bbcde0022088fa1dbbf7ac182d817fe (patch)
tree62221f02d997467ab74c11a769372bd5c424c2e7 /gitattributes.txt
parente08c339b86b96a2b66a3b555ca71c654bf677341 (diff)
downloadgit-htmldocs-9db95ca51bbcde0022088fa1dbbf7ac182d817fe.tar.gz
Autogenerated HTML docs for v1.5.2-rc0-1-g2cc31
Diffstat (limited to 'gitattributes.txt')
-rw-r--r--gitattributes.txt32
1 files changed, 29 insertions, 3 deletions
diff --git a/gitattributes.txt b/gitattributes.txt
index 126871756..d2edb9b14 100644
--- a/gitattributes.txt
+++ b/gitattributes.txt
@@ -151,8 +151,34 @@ Unspecified::
text, it is treated as text. Otherwise it would
generate `Binary files differ`.
-Any other value set to `diff` attribute is ignored and git acts
-as if the attribute is left unspecified.
+String::
+
+ Diff is shown using the specified custom diff driver.
+ The driver program is given its input using the same
+ calling convention as used for GIT_EXTERNAL_DIFF
+ program.
+
+
+Defining a custom diff driver
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The definition of a diff driver is done in `gitconfig`, not
+`gitattributes` file, so strictly speaking this manual page is a
+wrong place to talk about it. However...
+
+To define a custom diff driver `jcdiff`, add a section to your
+`$GIT_DIR/config` file (or `$HOME/.gitconfig` file) like this:
+
+----------------------------------------------------------------
+[diff "jcdiff"]
+ command = j-c-diff
+----------------------------------------------------------------
+
+When git needs to show you a diff for the path with `diff`
+attribute set to `jcdiff`, it calls the command you specified
+with the above configuration, i.e. `j-c-diff`, with 7
+parameters, just like `GIT_EXTERNAL_DIFF` program is called.
+See gitlink:git[7] for details.
Performing a three-way merge
@@ -183,7 +209,7 @@ Unspecified::
different merge driver to be used for paths to which the
`merge` attribute is unspecified.
-Any other string value::
+String::
3-way merge is performed using the specified custom
merge driver. The built-in 3-way merge driver can be