Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-20 Thread Stefan Beller
On Mon, Jun 19, 2017 at 11:10 AM, Brandon Williams wrote: > I would probably change the first sentence to: > > A submodule is another Git repository tracked at an arbitrary place > inside the working tree. The tracking doesn't happen at an arbitrary place, but in the gitlink/.gitmodules file

Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-20 Thread Stefan Beller
On Tue, Jun 20, 2017 at 11:18 AM, Jonathan Tan wrote: >> +DESCRIPTION >> +--- >> + >> +A submodule is another Git repository tracked in a subdirectory of your >> +repository. The tracked repository has its own history, which does not >> +interfere with the history of the current repository

Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-20 Thread Jonathan Tan
On Wed, 7 Jun 2017 11:53:54 -0700 Stefan Beller wrote: [snip] > +DESCRIPTION > +--- > + > +A submodule is another Git repository tracked in a subdirectory of your > +repository. The tracked repository has its own history, which does not > +interfere with the history of the current repos

Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-19 Thread Brandon Williams
On 06/13, Stefan Beller wrote: > Adding two native speakers as we start word smithing. > > On Tue, Jun 13, 2017 at 12:29 PM, Junio C Hamano wrote: > > >> + > >> +A submodule is another Git repository tracked in a subdirectory of your > >> +repository. The tracked repository has its own history,

Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-13 Thread Stefan Beller
Adding two native speakers as we start word smithing. On Tue, Jun 13, 2017 at 12:29 PM, Junio C Hamano wrote: >> + >> +A submodule is another Git repository tracked in a subdirectory of your >> +repository. The tracked repository has its own history, which does not >> +interfere with the history

Re: [RFC/PATCH] submodules: overhaul documentation

2017-06-13 Thread Junio C Hamano
Stefan Beller writes: > @@ -149,15 +119,17 @@ deinit [-f|--force] (--all|[--] ...):: > tree. Further calls to `git submodule update`, `git submodule foreach` > and `git submodule sync` will skip any unregistered submodules until > they are initialized again, so use this command

[RFC/PATCH] submodules: overhaul documentation

2017-06-07 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