From: Felipe Contreras <felipe.contreras@gmail.com>
Date: Wed, 07 Jul 2021 18:54:37 GMT
Subject: Re: PATCH: improve git switch documentation
Message-ID: <60e5f86d8f907_30143720844@natae.notmuch>
In-Reply-To: <167b8fe6-0586-b980-dfb9-9fa3a29d48bb@mfriebe.de>

Martin wrote:
> Sergey made an excellent point:
> > On 01/07/2021 13:27, Sergey Organov wrote:
> >> For example:
> >>
> >> "branch": a chain of commits
> >>
> >> "branch tip": the most recent commit in a branch
> >>
> >> "branch name": specific type of symbolic reference pointing to a branch tip
> 
> A lot of people think of the "chain of commits" when the word "branch" 
> is used.
> 
> If we take the sentence from the current doc:
>     --force-create
>      Similar to |--create| except that if |<new-branch>| already exists, 
> it will be reset to |<start-point>|
> and replace "branch" with "chain of commits"
>      Similar to |--create| except that if |<new-||"chain of commits">| 
> already exists, it will be reset to |<start-point>|
> 
> What would you expect to happen?
> I would think the "chain of commits" is created at the new <start-point>
> 
> What we want to say is
>      The "branch name" will point to a new "branch tip" at <start-point>

Wouldn't this achieve everything we want?

  The branch head will now point the new <head>

-- 
Felipe Contreras