This patch introduces the `--[no-]relative-paths` CLI option for
`git worktree {add, move, repair}` commands, as well as the
`worktree.useRelativePaths` configuration setting. When enabled,
these options allow worktrees to be linked using relative paths,
enhancing portability across environments where absolute paths
may differ (e.g., containerized setups, shared network drives).
Using the `--relative-paths` option with `worktree {move, repair}`
will convert absolute paths to relative ones, if possible, while
`--no-relative-paths` does the reverse. For cases where users want
consistency in path handling, the config option
`worktree.useRelativePaths` provides a persistent setting.
A new extension, `relativeWorktrees`, is added to indicate that at least
one worktree in the repository has been linked with relative paths. This
extension is automatically set when a worktree is created or repaired
using the `--relative-paths` option, or when the
`worktree.useRelativePaths` config is set to `true`.
The `relativeWorktrees` extension ensures older Git versions do not
attempt to automatically prune worktrees with relative paths, as they
would not not recognize the paths as being valid.
Signed-off-by: Caleb White <cdwhite3@xxxxx>
---
The base for this patch series is obtained by applying the following
patch onto 6a11438f43:
- cw/config-extensions topic (doc: consolidate extensions in git-config
documentation, 2024-10-22, <20241021-cleanup-extension-docs-v1-1-ab02cece3132@xxxxx>)
Link to original patch series:
https://lore.kernel.org/git/20241007-wt_relative_paths-v3-0-622cf18c45eb@xxxxx
---
Caleb White (2):
worktree: add CLI/config options for relative path linking
worktree: add `relativeWorktrees` extension
Documentation/config/extensions.txt | 6 ++
Documentation/config/worktree.txt | 5 ++
Documentation/git-worktree.txt | 9 +++
builtin/worktree.c | 20 ++---
repository.c | 1 +
repository.h | 1 +
setup.c | 7 ++
setup.h | 1 +
t/t0001-init.sh | 17 ++++-
t/t2400-worktree-add.sh | 54 ++++++++++++++
t/t2401-worktree-prune.sh | 3 +-
t/t2402-worktree-list.sh | 22 ++++++
t/t2403-worktree-move.sh | 22 ++++++
t/t2406-worktree-repair.sh | 26 +++++++
worktree.c | 143 ++++++++++++++++++++----------------
worktree.h | 14 ++++
16 files changed, 272 insertions(+), 79 deletions(-)
---
base-commit: 6a11438f43469f3815f2f0fc997bd45792ff04c0
change-id: 20241025-wt_relative_options-afa41987bc32
prerequisite-change-id: 20241020-cleanup-extension-docs-f365868711bf:v1
prerequisite-patch-id: 60a443b24e92938b9b6f4a016a7bab87e13bf3ea
Best regards,
--
Caleb White <cdwhite3@xxxxx>
