Re: PATCH: improve git switch documentation
Show 26 quoted lines
> 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
Felipe Contreras <felipe.contreras@gmail.com>