Re: Draft of Git Rev News edition 5

On Mon, Jul 6, 2015 at 9:39 PM, Eric Sunshine [off-list ref] wrote:

On Mon, Jul 06, 2015 at 10:54:28AM -0700, Junio C Hamano wrote:

quoted

Eric Sunshine [off-list ref] writes:

quoted

How about this instead: prefixing with "As originally implemented",
with a couple s/is/was/ thrown in...

    As originally implemented, creation of linked-worktrees was
    accomplished via `git checkout --to <path> <branch>`, and cleanup
    of leftover administrative files, after `<path>` is deleted, was
    done with `git prune --worktrees`. However, a recent unrelated
    change to `git prune` led to a discussion that concluded that
    worktree-related maintenance functionality didn't belong in `git
    prune`.

Is that sufficient to clue in the reader that "checkout --to" is not
final form,...

Yeah, I think that is a good way to address my concern.

The current draft release notes to 2.5 mentions this feature as
experimental and warns that its UI is bound to change.  We will
ship the upcoming release with "checkout --to" and the more places
we advise the users that this UI is not final, the better.

Here it is in patch form. (I wouldn't be surprised if the non-ASCII
characters in Duy's name in the context line get botched again...)

Ok, the following is merged:

https://github.com/git/git.github.io/pull/87

Thanks both,
Christian.