delta/git.git/Documentation/git-worktree.txt, branch sb/parse-options-codeformat

worktree: caution that this is still experimental

2015-07-16T22:59:48+00:00

Signed-off-by: Junio C Hamano

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

2015-07-16T22:59:17+00:00

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:32+00:00

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:48+00:00

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:47+00:00

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:46+00:00

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:46+00:00

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:45+00:00

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:44+00:00

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

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

2015-07-06T18:07:43+00:00

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