From: Junio C Hamano Date: Thu, 19 Jan 2023 07:23:46 +0000 (-0800) Subject: branch: document `-f` and linked worktree behaviour X-Git-Tag: v2.40.0-rc0~49^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=bf08abac565fa64eeaa56d2eb21ce1a9d2371358;p=thirdparty%2Fgit.git branch: document `-f` and linked worktree behaviour "git branch -f name start" forces to recreate the named branch, but the forcing does not defeat the "do not touch a branch that is checked out elsewhere" safety valve. Signed-off-by: Junio C Hamano --- diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt index 12c5f84e3b..2aaf13b45d 100644 --- a/Documentation/git-branch.txt +++ b/Documentation/git-branch.txt @@ -123,6 +123,10 @@ OPTIONS points to a valid commit. In combination with `-m` (or `--move`), allow renaming the branch even if the new branch name already exists, the same applies for `-c` (or `--copy`). ++ +Note that 'git branch -f []', even with '-f', +refuses to change an existing branch `` that is checked out +in another worktree linked to the same repository. -m:: --move::