On Fri, Feb 01, 2019 at 02:06:43PM +0700, Duy Nguyen wrote:
> worrying about races like this. The mkdir loop would be one way to go.
> But I'm going to add a new option to let the user control this
> directory name. This is necessary since this name is now exposed via
> "worktrees/<name>" reference space and should also be reported in "git
> worktree list". Avoiding the race is a nice bonus.
I'm not going to bother you with code yet (although if you want, you
can check out branch worktree-name on my gitlab repo), but this is
what the user facing changes look like. Looking good?
PS. I think this also calls for a command to rename working trees.
Sigh.. this worktree thingy never ends.
-- 8< --
diff --git a/Documentation/git-worktree.txt b/Documentation/git-worktree.txt
index 18469e202e..d5db69dec7 100644
--- a/Documentation/git-worktree.txt
+++ b/Documentation/git-worktree.txt
@@ -9,7 +9,7 @@ git-worktree - Manage multiple working trees
SYNOPSIS
--------
[verse]
-'git worktree add' [-f] [--detach] [--checkout] [--lock] [-b <new-branch>]
<path> [<commit-ish>]
+'git worktree add' [-f] [--detach] [--checkout] [--lock] [-b <new-branch>]
[--name <name>] <path> [<commit-ish>]
'git worktree list' [--porcelain]
'git worktree lock' [--reason <string>] <worktree>
'git worktree move' <worktree> <new-path>
@@ -195,6 +195,13 @@ This can also be set up as the default behaviour by using
the
--reason <string>::
With `lock`, an explanation why the working tree is locked.
+--name <name>::
+ Name of the working tree. Each working tree must have a unique
+ name. This is also the directory name containing all working
+ tree's specific information under `$GIT_COMMON_DIR/worktrees`.
+ If `--name` is not given, the name is based on basename(3)
+ optionally with a number suffix to make it unique.
+
<worktree>::
Working trees can be identified by path, either relative or
absolute.
@@ -323,11 +330,15 @@ details on a single line with columns. For example:
------------
$ git worktree list
-/path/to/bare-source (bare)
-/path/to/linked-worktree abcd1234 [master]
-/path/to/other-linked-worktree 1234abc (detached HEAD)
+(main) /path/to/bare-source (bare)
+linked /path/to/linked-worktree abcd1234 [master]
+other /path/to/other-linked-worktree 1234abc (detached HEAD)
------------
+The first column is the name of the working tree. The second column is
+the location of the working tree. The third column is the short commit
+name of the current branch. The branch name is put in square brackets.
+
Porcelain Format
~~~~~~~~~~~~~~~~
The porcelain format has a line per attribute. Attributes are listed with a
@@ -341,10 +352,12 @@ $ git worktree list --porcelain
worktree /path/to/bare-source
bare
+name linked
worktree /path/to/linked-worktree
HEAD abcd1234abcd1234abcd1234abcd1234abcd1234
branch refs/heads/master
+name other
worktree /path/to/other-linked-worktree
HEAD 1234abc1234abc1234abc1234abc1234abc1234a
detached
-- 8< --
--
Duy
