Hej Brian, thanks for digging into this. Could you be so kind to send the stackoverflow issue ? (You can send it to me only) I have some comments/questions, out of my head. On Tue, Jan 11, 2022 at 02:15:07AM +0000, brian m. carlson wrote: > The documentation for the eol attribute states that it is "effectively > setting the text attribute". > Let's avoid confusing users (and the present author when trying to > describe Git's behavior to others) by clearly documenting in which > cases the "eol" attribute has effect. > > Specifically, the attribute always has an effect unless the file is > explicitly set as -text, or the file is set as text=auto and the file is > detected as binary. > > Signed-off-by: brian m. carlson <sandals@xxxxxxxxxxxxxxxxxxxx> > --- > Documentation/gitattributes.txt | 11 ++++++----- > 1 file changed, 6 insertions(+), 5 deletions(-) > > diff --git a/Documentation/gitattributes.txt b/Documentation/gitattributes.txt > index 83fd4e19a4..60984a4682 100644 > --- a/Documentation/gitattributes.txt > +++ b/Documentation/gitattributes.txt > @@ -160,11 +160,12 @@ unspecified. > ^^^^^ > > This attribute sets a specific line-ending style to be used in the > -working directory. It enables end-of-line conversion without any > -content checks, effectively setting the `text` attribute. Note that > -setting this attribute on paths which are in the index with CRLF line > -endings may make the paths to be considered dirty. Adding the path to > -the index again will normalize the line endings in the index. > +working directory. This attribute has effect only if the `text` > +attribute is set or unspecified, or if it is set to `auto` and the file > +is detected as text. > Note that setting this attribute on paths which > +are in the index with CRLF line endings may make the paths to be > +considered dirty. Adding the path to the index again will normalize the > +line endings in the index. I think that this can be loosened as well. And, beside this, the "dirty" warning about setting attributes could be written as part of the "text" attribute as well. I dunno. Here is a possible suggestion: Note that setting this attribute on paths which are in the index with CRLF line endings may make the paths to be considered dirty - unless "text=auto" is set. `git ls-files --eol` can be used to check the "line ending status". Adding the path to the index again will normalize the line endings in the index. > > Set to string value "crlf":: >
