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

Re: which files are "known to git"?

From
Junio C Hamano <gitster@pobox.com>
Date
May 22, 2018, 02:14 UTC
Message-ID
<xmqqefi4zbaw.fsf@gitster-ct.c.googlers.com>
In-Reply-To
<20180521175335.GC10623@aiede.svl.corp.google.com>
Jonathan Nieder <jrnieder@gmail.com> writes:
> My understanding was the same as Elijah's.
>
> I would be in favor of a patch that replaces the phrase "known to Git"
> in Git's documentation with something less confusing.

One possible twist I recall was that normally we only pay attention to the index (i.e. the term "tracked files" means "paths shown in ls-files (no args) output"), but there was a desire to take a union of paths in the index and paths in the HEAD (the obvious difference is those that are removed from the index), and we may have called these "known to Git" in the discussion to distinguish them from "paths in the index".

Clearly the phrase we are discussing (e.g. the ones used in "git clean" documentation) has been used _without_ such a desire but merely is used carelessly and confusingly. So I am all for finding "known to Git" and replace them with "tracked" and/or "added to the index" when the phrase is not used to mean "union of paths in the index and in the HEAD".

Thanks.
Previous: Jonathan NiederNext: Robert P. J. Day
Message 12 of 16 in “which files are "known to git"?”
  1. Robert P. J. DayMay 21, 2018
  2. Randall S. BeckerMay 21, 2018
  3. Elijah NewrenMay 21, 2018
  4. Duy NguyenMay 21, 2018
  5. Robert P. J. DayMay 21, 2018
  6. Robert P. J. DayMay 21, 2018
  7. Junio C HamanoMay 21, 2018
  8. Robert P. J. DayMay 21, 2018
  9. Jonathan NiederMay 21, 2018
  10. Robert P. J. DayMay 21, 2018
  11. Jonathan NiederMay 21, 2018
  12. Junio C HamanoMay 22, 2018
  13. Robert P. J. DayMay 23, 2018
  14. Elijah NewrenMay 21, 2018
  15. Robert P. J. DayMay 21, 2018
  16. Stefan BellerMay 21, 2018

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.