Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Stefan Beller
On Thu, Jun 22, 2017 at 2:03 PM, Brandon Williams wrote: > On 06/22, Stefan Beller wrote: >> On Thu, Jun 22, 2017 at 1:20 PM, Junio C Hamano wrote: >> > Brandon Williams writes: >> > >> >> On 06/20, Stefan Beller wrote: >> >> ... >> >>> +The configuration of submodules >> >>> +--

Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Brandon Williams
On 06/22, Stefan Beller wrote: > On Thu, Jun 22, 2017 at 1:20 PM, Junio C Hamano wrote: > > Brandon Williams writes: > > > >> On 06/20, Stefan Beller wrote: > >> ... > >>> +The configuration of submodules > >>> +--- > >>> + > >>> +Submodule operations can be configured

Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Stefan Beller
On Thu, Jun 22, 2017 at 1:20 PM, Junio C Hamano wrote: > Brandon Williams writes: > >> On 06/20, Stefan Beller wrote: >> ... >>> +The configuration of submodules >>> +--- >>> + >>> +Submodule operations can be configured using the following mechanisms >>> +(from highes

Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Junio C Hamano
Brandon Williams 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 co

Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Stefan Beller
>> + * 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? Well, it describ

Re: [PATCHv2] submodules: overhaul documentation

2017-06-22 Thread Brandon Williams
On 06/20, Stefan Beller wrote: > This patch aims to detangle (a) the usage of `git-submodule` > from (b) the concept of submodules and (c) how the actual > implementation looks like, such as where they are configured > and (d) what the best practices are. > > To do so, move the conceptual parts of

Re: [PATCHv2] submodules: overhaul documentation

2017-06-21 Thread Stefan Beller
On Tue, Jun 20, 2017 at 8:45 PM, Jonathan Tan wrote: > Thanks, this looks like a good explanation. Some more nits, but > overall I feel like I understand this and have learned something from > it. > > On Tue, Jun 20, 2017 at 3:56 PM, Stefan Beller wrote: >> +A submodule is another Git repository

Re: [PATCHv2] submodules: overhaul documentation

2017-06-20 Thread Jonathan Tan
Thanks, this looks like a good explanation. Some more nits, but overall I feel like I understand this and have learned something from it. On Tue, Jun 20, 2017 at 3:56 PM, Stefan Beller wrote: > +A submodule is another Git repository tracked inside a repository. > +The tracked repository has its o

[PATCHv2] submodules: overhaul documentation

2017-06-20 Thread Stefan Beller
This patch aims to detangle (a) the usage of `git-submodule` from (b) the concept of submodules and (c) how the actual implementation looks like, such as where they are configured and (d) what the best practices are. To do so, move the conceptual parts of the 'git-submodule' man page to a new man