Home Explore Blog CI



git

Documentation/config/worktree.adoc
fb0c90dd4f6fc75b110d240d69256d79db8e4b3f46695de500000003000003cd
worktree.guessRemote::
	If no branch is specified and neither `-b` nor `-B` nor
	`--detach` is used, then `git worktree add` defaults to
	creating a new branch from HEAD.  If `worktree.guessRemote` is
	set to true, `worktree add` tries to find a remote-tracking
	branch whose name uniquely matches the new branch name.  If
	such a branch exists, it is checked out and set as "upstream"
	for the new branch.  If no such match can be found, it falls
	back to creating a new branch from the current HEAD.

worktree.useRelativePaths::
	Link worktrees using relative paths (when "true") or absolute
	paths (when "false"). This is particularly useful for setups
	where the repository and worktrees may be moved between
	different locations or environments. Defaults to "false".
+
Note that setting `worktree.useRelativePaths` to "true" implies enabling the
`extension.relativeWorktrees` config (see linkgit:git-config[1]),
thus making it incompatible with older versions of Git.

Chunks
847da884 (1st chunk of `Documentation/config/worktree.adoc`)
Title: Git Worktree Configuration Options
Summary
The worktree.guessRemote and worktree.useRelativePaths configuration options control how Git worktree adds new branches and sets up worktree links, with the latter option also affecting compatibility with older Git versions.