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

Re: [PATCH] doc: improve grammar in git-update-index

From
Philip Oakley <philipoakley@iee.org>
Date
Dec 15, 2018, 17:06 UTC
Message-ID
<bfe22381-864a-4a6b-8dd9-78e268e52c36@iee.org>
In-Reply-To
<20181214212504.3164-1-asottile@umich.edu>
On 14/12/2018 21:25, Anthony Sottile wrote:
Show 18 quoted lines
> Signed-off-by: Anthony Sottile <asottile@umich.edu>
> ---
>   Documentation/git-update-index.txt | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt
> index 1c4d146a4..9c03ca167 100644
> --- a/Documentation/git-update-index.txt
> +++ b/Documentation/git-update-index.txt
> @@ -326,7 +326,7 @@ inefficient `lstat(2)`.  If your filesystem is one of them, you
>   can set "assume unchanged" bit to paths you have not changed to
>   cause Git not to do this check.  Note that setting this bit on a
>   path does not mean Git will check the contents of the file to
> -see if it has changed -- it makes Git to omit any checking and
> +see if it has changed -- it means Git will skip any checking and
>   assume it has *not* changed.  When you make changes to working
>   tree files, you have to explicitly tell Git about it by dropping
>   "assume unchanged" bit, either before or after you modify them.

Doesn't this also need the caveat that it is _a promise by the user_ that they will not change the file, such that Git doesn't need to keep checking, and that occasionally Git will check, or may perform unexpected actions if the user has the wrong mental model.

-- 
Philip
Previous: Anthony SottileNext: Anthony Sottile
Message 2 of 4 in “doc: improve grammar in git-update-index”
  1. doc: improve grammar in git-update-indexAnthony Sottile, Dec 14, 2018
  2. Philip OakleyDec 15, 2018
  3. Anthony SottileDec 16, 2018
  4. Junio C HamanoDec 26, 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.