Thread (16 messages) 16 messages, 5 authors, 2025-11-19

Re: [PATCH 2/2] doc: git-worktree: Add side by side branch checkout example

From: Kristoffer Haugsbakk <hidden>
Date: 2025-10-02 17:51:42

Possibly related (same subject, not in this thread)

On Thu, Oct 2, 2025, at 17:51, Michal Suchanek wrote:
Signed-off-by: Michal Suchanek <redacted>
I think this could do with more setup and motivation.

I’ve seen a lot of questions on worktrees where they introduce the
problem with “I use a bare repository with worktrees”.  And I was
puzzled that they kept using bare repositories all the time.  I’ve
forgotten some of those details but I do seem to remember that they were
motivated to go all-in on making a ton of worktrees, and using the the
“project root” to do it.

Is that what the bare-setup is getting at? ;)
quoted hunk ↗ jump to hunk
---
 Documentation/git-worktree.adoc | 10 ++++++++++
 1 file changed, 10 insertions(+)
diff --git a/Documentation/git-worktree.adoc b/Documentation/git-worktree.adoc
index ec31863aec..122b191ff9 100644
--- a/Documentation/git-worktree.adoc
+++ b/Documentation/git-worktree.adoc
@@ -525,6 +525,16 @@ $ popd
 $ git worktree remove ../temp
 ------------

+Side by side branch checkouts for a repository using multiple worktrees
+
+------------
+mkdir some-repository
+cd some-repository
+git clone --bare gitforge@someforge.example.com:some-org/some-repository .git
+git --git-dir=.git worktree add some-branch
+git --git-dir=.git worktree add another-branch
+------------
This works for me.  But why not this?

    git clone --bare <repo> some-repository
    cd some-repository
    git worktree add some-branch
    git worktree add another-branch
+
 BUGS
 ----
 Multiple checkout in general is still experimental, and the support
--
2.51.0
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help