git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

From
Junio C Hamano <gitster@pobox.com>
Date
May 22, 2015, 14:36 UTC
Message-ID
<xmqqwq00fzlv.fsf@gitster.dls.corp.google.com>
In-Reply-To
<CAGZ79kZ5yxG7k++9QFRhnb=6A3HD64Kz3_B9UBrHA+Akht8tZw@mail.gmail.com>
Stefan Beller <sbeller@google.com> writes:
Show 6 quoted lines
> On Thu, May 21, 2015 at 1:03 PM, Philip Oakley <philipoakley@iee.org> wrote:
>>> +Submodules are not to be confused with remotes, which are meant
>>> +mainly for branches of the same project;
>>
>> This use of 'branches' didn't work for me. "remotes are meant mainly for
>> branches of the same project" ?

The "branch" in the original is used in a much wider sense than usual branch (i.e. ref/heads/ thing you have locally); it refers to forks of the same project but with a bit of twist. When you say repository A is a fork of the same project as my local repository, you would give an impression that A is not the authoritative copy of the project. But you can say my repository and that repository A are branches of the same project, you give zero information as to A's authoritativeness.

>     Submodules should not be confused with remote repositories, which are
>     meant to track the same repository, just at another location; ...

I do not think this is a great improvement. You now conflated "repository" to mean "project" in the latter half of the sentence, while you are trying to explain what a "remote repository" is.

Your copy of git.git is not the same repository as mine; they have different histories. Both repositories are used to work on the same project. "submoules are not remotes, which are other repositories of the same project", perhaps?

Previous: Philip OakleyNext: Stefan Beller
Message 8 of 13 in “submodule documentation: Reorder introductory paragraphs”
  1. submodule documentation: Reorder introductory paragraphsStefan Beller, May 20, 2015
  2. Heiko VoigtMay 21, 2015
  3. Junio C HamanoMay 21, 2015
  4. Stefan BellerMay 21, 2015
  5. Philip OakleyMay 21, 2015
  6. Stefan BellerMay 21, 2015
  7. Philip OakleyMay 22, 2015
  8. Junio C HamanoMay 22, 2015
  9. Stefan BellerMay 22, 2015
  10. Junio C HamanoMay 22, 2015
  11. Philip OakleyMay 22, 2015
  12. Stefan BellerMay 22, 2015
  13. Philip OakleyMay 22, 2015

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.