What does "!eol" in gitattributes do?
Recently I came across the following entry in a .gitattributes file:
"* text=auto !eol"
What does !eol do?
Answer
Git has 2 attributes that deal with end-of-lines:
- text
Documentation says:
This attribute enables and controls end-of-line normalization. When a text file is normalized, its line endings are converted to LF in the repository
This effectively means that when you commit to the repo, it will convert line-endings to LF
- eol
Documentation says:
This attribute sets a specific line-ending style to be used in the working directory. It enables end-of-line normalization without any content checks, effectively setting the text attribute.
So while the text attribute affects how the file will look like IN THE REPO, eol affects how the file looks like in the working directory.
Now, an attribute can have 4 states:
set with no value
example: * text
unset
example: * -text
set with specific value
example: * text=auto
unspecified
example: * !text
So, * text=auto !eol means this:
All files have the attribute text set to auto and the eol attribute unspecified. Reading the documentation we find out that text=auto means that you let git decide if a file is text and if it is it will normalize it (set line-endings in the repo to LF).
!eol means that the attribute eol is set to unspecified explicitly. In this case it is the same as not specifying it at all, instructing Git to look at the core.eol config setting to see how to deal with line-endings in the working directory. Note this:
The core.eol configuration variable controls which line endings Git will use for normalized files in your working directory; the default is to use the native line ending for your platform, or CRLF if core.autocrlf is set.
But you would use !eol in a situation like the following:
* text=auto eol=CRLF
test.txt !eol
basically overriding the eol attribute from CRLF to unspecified for test.txt. This means that for all files except test.txt, Git will convert on checkout EOLs to CRLF but will do nothing to test.txt.