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

Re: [PATCHv2] submodules: overhaul documentation

From
Stefan Beller <sbeller@google.com>
Date
Jun 22, 2017, 21:09 UTC
Message-ID
<CAGZ79kbBO2NamPcO_G=AVFV5VRwVz9h_9h-cvOqw5UeMwiXTQg@mail.gmail.com>
In-Reply-To
<20170622210323.GC124061@google.com>
On Thu, Jun 22, 2017 at 2:03 PM, Brandon Williams <bmwill@google.com> wrote:
Show 38 quoted lines
> On 06/22, Stefan Beller wrote:
>> On Thu, Jun 22, 2017 at 1:20 PM, Junio C Hamano <gitster@pobox.com> wrote:
>> > Brandon Williams <bmwill@google.com> writes:
>> >
>> >> On 06/20, Stefan Beller wrote:
>> >> ...
>> >>> +The configuration of submodules
>> >>> +-------------------------------
>> >>> +
>> >>> +Submodule operations can be configured using the following mechanisms
>> >>> +(from highest to lowest precedence):
>> >>> +
>> >>> + * the command line for those commands that support taking submodule specs.
>> >>> +
>> >>> + * the configuration file `$GIT_DIR/config` in the superproject.
>> >>> +
>> >>> + * the `.gitmodules` file inside the superproject. A project usually
>> >>> +   includes this file to suggest defaults for the upstream collection
>> >>> +   of repositories.
>> >>
>> >> I dislike this last point.  Realistically we don't want this right?  So
>> >> perhaps we shouldn't include it?
>> >
>> > I am not sure if I follow.  Without .gitmodules, how would you, as a
>> > downstream developer, bootstrap the whole thing?
>> >
>>
>> I think Brandon eludes to our long term vision of having a separate
>> magic ref containing these informations instead of carrying it in tree.
>>
>> As urls change over time, it is better to keep the urls out of the
>> actual history, but still versioned so maybe we'll want to have
>> a ref/submodule-config/master ref that contains all the bootstrapping
>> information. The .gitmodules file would degenerate to a pure
>> name<->path mapping.
>
> I was more eluding to having fetch.recurse and the other similar bits
> stored in the gitmodules file.

Well yes, but these configurations would also go onto the new magic ref once implemented.

And to answer your question: Yes we (you and me) dislike it, but it is the best we can do given the current implementation. Once the implementation changes, we may want to adapt this man page.

>
> --
> Brandon Williams
Previous: Brandon WilliamsNext: Stefan Beller
Message 16 of 17 in “submodules: overhaul documentation”
  1. submodules: overhaul documentationStefan Beller, Jun 7, 2017
  2. Junio C HamanoJun 13, 2017
  3. Stefan BellerJun 13, 2017
  4. Brandon WilliamsJun 19, 2017
  5. Stefan BellerJun 20, 2017
  6. Jonathan TanJun 20, 2017
  7. Stefan BellerJun 20, 2017
  8. [PATCHv2] submodules: overhaul documentationStefan Beller, Jun 20, 2017
  9. Jonathan TanJun 21, 2017
  10. Stefan BellerJun 21, 2017
  11. Brandon WilliamsJun 22, 2017
  12. Stefan BellerJun 22, 2017
  13. Junio C HamanoJun 22, 2017
  14. Stefan BellerJun 22, 2017
  15. Brandon WilliamsJun 22, 2017
  16. Stefan BellerJun 22, 2017
  17. [PATCHv3] submodules: overhaul documentationStefan Beller, Jun 22, 2017

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.