git@vger.kernel.org list mirror (unofficial, one of many)
 help / color / mirror / code / Atom feed
* git pull unclear manual
@ 2021-03-03 14:18 Sergey Organov
  2021-03-04  1:18 ` Junio C Hamano
  0 siblings, 1 reply; 5+ messages in thread
From: Sergey Organov @ 2021-03-03 14:18 UTC (permalink / raw)
  To: git

Hello,

Here is how "git help pull" begins:

<q>
NAME
       git-pull - Fetch from and integrate with another repository or a local
       branch

SYNOPSIS
       git pull [<options>] [<repository> [<refspec>...]]
</q>

From this, how do one figures how to "integrate with ... local branch"?

Is "git pull" useful to integrate with a local branch at all?

Thanks,
-- Sergey

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: git pull unclear manual
  2021-03-03 14:18 git pull unclear manual Sergey Organov
@ 2021-03-04  1:18 ` Junio C Hamano
  2021-03-04 11:52   ` Sergey Organov
  0 siblings, 1 reply; 5+ messages in thread
From: Junio C Hamano @ 2021-03-04  1:18 UTC (permalink / raw)
  To: Sergey Organov; +Cc: git

Sergey Organov <sorganov@gmail.com> writes:

> Here is how "git help pull" begins:
>
> <q>
> NAME
>        git-pull - Fetch from and integrate with another repository or a local
>        branch
>
> SYNOPSIS
>        git pull [<options>] [<repository> [<refspec>...]]
> </q>
>
> From this, how do one figures how to "integrate with ... local branch"?
>
> Is "git pull" useful to integrate with a local branch at all?

Yes, you can refer to your local repository as ".", so

	git pull . another-branch

will integrate the history of your local "another-branch" into
the history of the branch you have currently checked out.



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: git pull unclear manual
  2021-03-04  1:18 ` Junio C Hamano
@ 2021-03-04 11:52   ` Sergey Organov
  2021-03-04 23:24     ` Junio C Hamano
  0 siblings, 1 reply; 5+ messages in thread
From: Sergey Organov @ 2021-03-04 11:52 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git

Junio C Hamano <gitster@pobox.com> writes:

> Sergey Organov <sorganov@gmail.com> writes:
>
>> Here is how "git help pull" begins:
>>
>> <q>
>> NAME
>>        git-pull - Fetch from and integrate with another repository or a local
>>        branch
>>
>> SYNOPSIS
>>        git pull [<options>] [<repository> [<refspec>...]]
>> </q>
>>
>> From this, how do one figures how to "integrate with ... local branch"?
>>
>> Is "git pull" useful to integrate with a local branch at all?
>
> Yes, you can refer to your local repository as ".", so
>
> 	git pull . another-branch
>
> will integrate the history of your local "another-branch" into
> the history of the branch you have currently checked out.

Nice, thanks!

Do you think the manual needs some improvement still?

I mean, I'd then expect something like this as the SYNOPSIS:

"git-pull - Fetch from and integrate with another or current repository"

with further clarification in the DESCRIPTION of how integration with
current repository could be useful.

The present description, if we drop "another repository" for the sake of
the argument, reads:

"git-pull - Fetch from and integrate with a local branch"

that sounds plain wrong to me.

Also, I got confused further as the manual consistently uses "remote
repository" to describe <repository>, and that doesn't easily maps to
"current repository" in my mind.

Further, the manual says that <refspec> is simply passed to the "git
fetch", and "git help fetch" adds to the confusion, as it says:

  git-fetch - Download objects and refs from *another repository*
  
  Fetch branches and/or tags (collectively, "refs") from one or more
  *other repositories*, along with the objects necessary to complete
  their histories.

that doesn't suggest "current repository" in some form is allowed
either.

BTW, why are these "other", "remote", "another" attributes there in
the manual in the first place? Why don't just say:

  git-fetch - Download objects and refs from repositories
  
  Fetch branches and/or tags (collectively, "refs") from one or more
  repositories, along with the objects necessary to complete their
  histories, into the current repository.

Thanks,
-- Sergey

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: git pull unclear manual
  2021-03-04 11:52   ` Sergey Organov
@ 2021-03-04 23:24     ` Junio C Hamano
  2021-03-07 18:57       ` Sergey Organov
  0 siblings, 1 reply; 5+ messages in thread
From: Junio C Hamano @ 2021-03-04 23:24 UTC (permalink / raw)
  To: Sergey Organov; +Cc: git

Sergey Organov <sorganov@gmail.com> writes:

> Do you think the manual needs some improvement still?

My reading is already tainted by using Git for a long time, so I
won't be the best person to judge what's missing in the manual.

> I mean, I'd then expect something like this as the SYNOPSIS:
>
> "git-pull - Fetch from and integrate with another or current repository"
> ...
>   git-fetch - Download objects and refs from *another repository*

Just replacing "another repository" with "a repository", the latter
of which includes the current one, would be sufficient, perhaps?


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: git pull unclear manual
  2021-03-04 23:24     ` Junio C Hamano
@ 2021-03-07 18:57       ` Sergey Organov
  0 siblings, 0 replies; 5+ messages in thread
From: Sergey Organov @ 2021-03-07 18:57 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git

Junio C Hamano <gitster@pobox.com> writes:

> Sergey Organov <sorganov@gmail.com> writes:
>
>> Do you think the manual needs some improvement still?
>
> My reading is already tainted by using Git for a long time, so I
> won't be the best person to judge what's missing in the manual.
>
>> I mean, I'd then expect something like this as the SYNOPSIS:
>>
>> "git-pull - Fetch from and integrate with another or current repository"
>> ...
>>   git-fetch - Download objects and refs from *another repository*
>
> Just replacing "another repository" with "a repository", the latter
> of which includes the current one, would be sufficient, perhaps?

Yeah, just "a repository" is fine with me, perhaps followed by a note in
the DESCRIPTION that the current one is indeed included.

-- Sergey

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2021-03-07 18:58 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-03-03 14:18 git pull unclear manual Sergey Organov
2021-03-04  1:18 ` Junio C Hamano
2021-03-04 11:52   ` Sergey Organov
2021-03-04 23:24     ` Junio C Hamano
2021-03-07 18:57       ` Sergey Organov

Code repositories for project(s) associated with this inbox:

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).