git/list[1] front-page[2] threads[3] people[4] search[5] about
 

'eol' documentation confusion

From
RDRobert Dailey <rcdailey.lists@gmail.com>
Date
Jun 21, 2015, 14:04 UTC
Message-ID
<CAHd499CapqvC3pHszgmX2VexdmqiW4+N23YfkAP5jjXWDrbe0A@mail.gmail.com>

Upon inspection of the gitattributes documentation page here: https://git-scm.com/docs/gitattributes

When comparing the documentation for 'text' with 'eol', I see the following missing explanations for 'eol':

* eol
* -eol

Maybe the fact that these are missing means they are not valid to use. There is also the issue that `text` usually controls EOL anyway. Is there ever any reason to set eol in a way differently than explained in the documentation (that is, `eol=lf` or `eol=crlf`)?

For example, what if you want a file to be treated as text BUT you do not want it to perform EOL normalization at all. Could you do this?

    foo.txt text -eol

Just at first glance, this to me would mean line endings on checkin and checkout are not touched (CRLF could be checked in). Is this possible?

What about setting `eol` but not `text`?

Honestly it seems like `eol` is just a supplementary setting for `text` and was never intended to be used in ways that are undocumented. Some explanation to help uncloud this would help, or maybe I missed something in the documentation that explains this.

Next: Robert Dailey
Message 1 of 5 in “'eol' documentation confusion”
  1. Robert DaileyJun 21, 2015
  2. Robert DaileyJun 21, 2015
  3. Torsten BögershausenJun 22, 2015
  4. Junio C HamanoJun 22, 2015
  5. Torsten BögershausenJun 25, 2015

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.