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

[PATCH v2 2/2] docs/config: clarify "text property" in core.eol

From
Jeff King <peff@peff.net>
Date
Jan 29, 2019, 12:41 UTC
Message-ID
<20190129124112.GB21931@sigill.intra.peff.net>
In-Reply-To
<20190129124031.GA13084@sigill.intra.peff.net>

The word "property" is vague here. Let's spell out that we mean the path must be marked with the text attribute.

While we're here, let's make the paragraph a little easier to read by de-emphasizing the "when core.autocrlf is false" bit. Putting it in the first sentence obscures the main content, and many readers won't care about autocrlf (i.e., anyone who is just following the gitattributes(7) advice, which mainly discusses "text" and "core.eol").

Helped-by: Torsten Bögershausen <tboegi@web.de>
Signed-off-by: Jeff King <peff@peff.net>
---
 Documentation/config/core.txt | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/Documentation/config/core.txt b/Documentation/config/core.txt
index d0e6635fe0..7e9b6c8f4c 100644
--- a/Documentation/config/core.txt
+++ b/Documentation/config/core.txt
@@ -121,11 +121,14 @@ core.quotePath::
 
 core.eol::
 	Sets the line ending type to use in the working directory for
-	files that have the `text` property set when core.autocrlf is false.
+	files that are marked as text (either by having the `text`
+	attribute set, or by having `text=auto` and Git auto-detecting
+	the contents as text).
 	Alternatives are 'lf', 'crlf' and 'native', which uses the platform's
 	native line ending.  The default value is `native`.  See
 	linkgit:gitattributes[5] for more information on end-of-line
-	conversion.
+	conversion. Note that this value is ignored if `core.autocrlf`
+	is set to `true` or `input`.
 
 core.safecrlf::
 	If true, makes Git check if converting `CRLF` is reversible when
-- 
2.20.1.845.g57b86ca485
Previous: Jeff KingNext: Torsten Bögershausen
Message 10 of 16 in “unclear docs”
  1. Sergey LukashevJan 27, 2019
  2. Sergey LukashevJan 27, 2019
  3. Jeff KingJan 28, 2019
  4. Sergey LukashevJan 28, 2019
  5. Jeff KingJan 28, 2019
  6. Torsten BögershausenJan 29, 2019
  7. Sergey LukashevJan 29, 2019
  8. 0/2 eol/autocrlf doc clarificationsJeff King, Jan 29, 2019
  9. 1/2 doc/gitattributes: clarify "autocrlf overrides eol"Jeff King, Jan 29, 2019
  10. 2/2 docs/config: clarify "text property" in core.eolJeff King, Jan 29, 2019
  11. Torsten BögershausenJan 28, 2019
  12. Jeff KingJan 28, 2019
  13. Junio C HamanoJan 28, 2019
  14. Jeff KingJan 28, 2019
  15. Sergey LukashevJan 28, 2019
  16. Jeff KingJan 28, 2019

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.