From 47fbe95a42bd6530bb368dab9faf0ccf074706ad Mon Sep 17 00:00:00 2001 From: shvvkz Date: Thu, 21 May 2026 16:12:06 +0200 Subject: [PATCH] doc: Document executable-bit behavior during checkout --- gix-worktree-state/src/checkout/mod.rs | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/gix-worktree-state/src/checkout/mod.rs b/gix-worktree-state/src/checkout/mod.rs index 57a0d3b5f2a..6b98fff47c4 100644 --- a/gix-worktree-state/src/checkout/mod.rs +++ b/gix-worktree-state/src/checkout/mod.rs @@ -55,6 +55,10 @@ pub struct Options { /// even if they appear to be changed. When creating directories that clash with existing worktree entries, /// these will try to delete the existing entry. /// This is similar in behaviour as `git checkout --force`. + /// + /// Note that when `destination_is_initially_empty` is `false`, existing files may still have their + /// executable bit updated to match the index. This option prevents overwriting file contents, but + /// does not necessarily prevent metadata updates. pub overwrite_existing: bool, /// If true, default false, try to checkout as much as possible and don't abort on first error which isn't /// due to a conflict.