Skip to content

update-index doc: note new caveats in 2.17

Ævar Arnfjörð Bjarmason git 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest2 patches 6 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/2update-index doc: note a fixed bug in the untracked cacheDocumentation/git-update-index.txt+16 -04 replies
2/2update-index doc: note the caveat with "could not open..."Documentation/git-update-index.txt+10 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH 0/2] update-index doc: note new caveats in 2.17

On Fri, Feb 09 2018, Junio C. Hamano jotted:

Quoted 11 lines
Quoted 9 lines · Ævar Arnfjörð Bjarmason

I think you / Nguyễn may not have seen my
<[email protected]>
(https://public-inbox.org/git/[email protected]/)

As noted there I think it's best to proceed without the "dir.c: stop ignoring opendir[...]" patch.

It's going to be a bad regression in 2.17 if it ends up spewing pagefuls of warnings in previously working repos if the UC is on.

Quoted 6 lines

Well, I am not sure if it is a regression to diagnose problematic untracked cache information left by earlier version of the software with bugs. After all, this is still an experimental feature, and we do want to see the warning to serve its purpose to diagnose possible remaining bugs, and new similar ones when a newer iteration of the feature introduces, no?

Fair enough. I just wanted to make sure it had been seen. It wasn't obvious whether it had just been missed since there was no follow-up there or note in WC.

We were disagreeing to the extent that some of this should be documented in [email protected] and related, and I see you've ejected the doc patch I had in that series.

I really think we should be saying something like what this new doc series says, it's conceptually on top of Duy's series but applies on top of master.

I think there's room to quibble about whether to include 1/2 at all since it's a relatively obscure edge case.

2/2 however is something I think a *lot* of users are going to hit. I just skimmed the relevant bits of git-config and git-update-index now, and nothing describes the UC as an experimental feature, and it's been well-known to improve performance.

When users upgrade to 2.17 they're going to have git yelling at them (as my users did) on existing checkouts, with no indication whatsoever that it's due to the UC or how to fix it.

Let's at least documente it. I also wonder if the "dir.c: stop ignoring opendir() error in open_cached_dir()" change shouldn't have something in the warning itself about it being caused by the UC, doesn't it only warn under that mode? I.e.:

-"could not open directory '%s'") +"core.untrackedCache: could not open directory '%s'")

Ævar Arnfjörð Bjarmason (2):
update-index doc: note a fixed bug in the untracked cache update-index doc: note the caveat with "could not open..."

 Documentation/git-update-index.txt | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
Signature · 1 line
2.15.1.424.g9478a66081