Re: PATCH: improve git switch documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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



[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux