git/Documentation/git-worktree.txt, branch v2.5.2

worktree: caution that this is still experimental

2015-07-16T22:59:48Z

Signed-off-by: Junio C Hamano

Documentation/git-worktree: fix stale "git checkout --to" references

2015-07-16T22:59:17Z

These should have been changed to "git worktree add" by fc56361 (worktree: introduce "add" command, 2015-07-06. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: add: auto-vivify new branch when is omitted

2015-07-07T21:34:32Z

As a convenience, when is omitted from "git worktree " and neither -b nor -B is used, automatically create a new branch named after , as if "-b $(basename )" was specified. Thus, "git worktree add ../hotfix" creates a new branch named "hotfix" and associates it with new worktree "../hotfix". Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: add: make -b/-B default to HEAD when is omitted

2015-07-06T18:07:48Z

As a convenience, like "git branch" and "git checkout -b", make "git worktree add -b " default to HEAD when is omitted. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: add -b/-B options

2015-07-06T18:07:47Z

One of git-worktree's roles is to populate the new worktree, much like git-checkout, and thus, for convenience, ought to support several of the same shortcuts. Toward this goal, add -b/-B options to create a new branch and check it out in the new worktree. (For brevity, only -b is mentioned in the synopsis; -B is omitted.) Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: add --detach option

2015-07-06T18:07:46Z

One of git-worktree's roles is to populate the new worktree, much like git-checkout, and thus, for convenience, ought to support several of the same shortcuts. Toward this goal, add a --detach option to detach HEAD in the new worktree. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: add --force option

2015-07-06T18:07:46Z

By default, "git worktree add" refuses to create a new worktree when the requested branch is already checked out elsewhere. Add a --force option to override this safeguard. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

worktree: introduce "add" command

2015-07-06T18:07:45Z

The plan is to relocate "git checkout --to" functionality to "git worktree add". As a first step, introduce a bare-bones git-worktree "add" command along with documentation. At this stage, "git worktree add" merely invokes "git checkout --to" behind the scenes, but an upcoming patch will move the actual functionality (checkout.c:prepare_linked_checkout() and its helpers) to worktree.c. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

Documentation/git-worktree: add EXAMPLES section

2015-07-06T18:07:44Z

Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano

Documentation/git-worktree: add high-level 'lock' overview

2015-07-06T18:07:43Z

Due to the (current) absence of a "git worktree lock" command, locking a worktree's administrative files to prevent automatic pruning is a manual task, necessarily requiring low-level understanding of linked worktree functionality. However, this level of detail does not belong in the high-level DESCRIPTION section, so add a generalized discussion of locking to DESCRIPTION and move the technical information to DETAILS. Signed-off-by: Eric Sunshine Signed-off-by: Junio C Hamano