Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-26 Thread Heiko Voigt
On Tue, May 26, 2015 at 10:53:15AM -0700, Stefan Beller wrote: > On Mon, May 25, 2015 at 3:00 PM, Junio C Hamano wrote: > > Stefan Beller writes: > > On the other hand, I probably would not have felt such a strong > > "strangeness" if it were described like this: > > > > This command can help

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-26 Thread Stefan Beller
On Mon, May 25, 2015 at 3:00 PM, Junio C Hamano wrote: > Stefan Beller writes: > >> DESCRIPTION >> --- >> +This command will inspect, update and manage submodules. >> >> +Submodules allow you to keep another Git repository in a subdirectory >> +of your repository. The other repository h

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-25 Thread Junio C Hamano
Stefan Beller writes: > DESCRIPTION > --- > +This command will inspect, update and manage submodules. > > +Submodules allow you to keep another Git repository in a subdirectory > +of your repository. The other repository has its own history,... The first line somehow bothered me, so

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Philip Oakley
From: "Stefan Beller" It's better to start the man page with a description of what submodules actually are instead of saying what they are not. Reorder the paragraphs such that the first short paragraph introduces the submodule concept, the second paragraph highlights the usage of the submodul

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Philip Oakley
From: "Stefan Beller" On Fri, May 22, 2015 at 10:35 AM, Philip Oakley wrote: From: "Stefan Beller" On Fri, May 22, 2015 at 7:36 AM, Junio C Hamano wrote: Stefan Beller writes: On Thu, May 21, 2015 at 1:03 PM, Philip Oakley wrote: +Submodules are not to be confused with remotes, w

[PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Stefan Beller
It's better to start the man page with a description of what submodules actually are instead of saying what they are not. Reorder the paragraphs such that the first short paragraph introduces the submodule concept, the second paragraph highlights the usage of the submodule command, the third parag

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Stefan Beller
On Fri, May 22, 2015 at 10:35 AM, Philip Oakley wrote: > From: "Stefan Beller" >> >> On Fri, May 22, 2015 at 7:36 AM, Junio C Hamano wrote: >>> >>> Stefan Beller writes: >>> On Thu, May 21, 2015 at 1:03 PM, Philip Oakley wrote: >> >> +Submodules are not to be confused with re

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Philip Oakley
From: "Stefan Beller" On Fri, May 22, 2015 at 7:36 AM, Junio C Hamano wrote: Stefan Beller writes: On Thu, May 21, 2015 at 1:03 PM, Philip Oakley wrote: +Submodules are not to be confused with remotes, which are meant +mainly for branches of the same project; This use of 'branches' didn

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Junio C Hamano
Stefan Beller writes: > On Fri, May 22, 2015 at 7:36 AM, Junio C Hamano wrote: >> Stefan Beller writes: >> >>> On Thu, May 21, 2015 at 1:03 PM, Philip Oakley wrote: > +Submodules are not to be confused with remotes, which are meant > +mainly for branches of the same project;

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Stefan Beller
On Fri, May 22, 2015 at 7:36 AM, Junio C Hamano wrote: > Stefan Beller writes: > >> On Thu, May 21, 2015 at 1:03 PM, Philip Oakley 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 wor

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Junio C Hamano
Stefan Beller writes: > On Thu, May 21, 2015 at 1:03 PM, Philip Oakley 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

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-22 Thread Philip Oakley
From: "Stefan Beller" On Thu, May 21, 2015 at 1:03 PM, Philip Oakley 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" ?

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-21 Thread Stefan Beller
On Thu, May 21, 2015 at 1:03 PM, Philip Oakley 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" ? > Maybe Subm

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-21 Thread Philip Oakley
From: "Stefan Beller" It's better to start the man page with a description of what submodules actually are instead of saying what they are not. Reorder the paragraphs such that the first short paragraph introduces the submodule concept, the second paragraph highlights the usage of the submodul

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-21 Thread Stefan Beller
On Thu, May 21, 2015 at 10:24 AM, Junio C Hamano wrote: > Stefan Beller writes: > >> Reorder the paragraphs such that >> the first short paragraph introduces the submodule concept, >> the second paragraph highlights the usage of the submodule command, >> the third paragraph giving background info

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-21 Thread Junio C Hamano
Stefan Beller writes: > Reorder the paragraphs such that > the first short paragraph introduces the submodule concept, > the second paragraph highlights the usage of the submodule command, > the third paragraph giving background information, > and finally the fourth paragraph discusing alternativ

Re: [PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-21 Thread Heiko Voigt
On Wed, May 20, 2015 at 04:11:57PM -0700, Stefan Beller wrote: > It's better to start the man page with a description of what submodules > actually are instead of saying what they are not. > > Reorder the paragraphs such that > the first short paragraph introduces the submodule concept, > the seco

[PATCH] submodule documentation: Reorder introductory paragraphs

2015-05-20 Thread Stefan Beller
It's better to start the man page with a description of what submodules actually are instead of saying what they are not. Reorder the paragraphs such that the first short paragraph introduces the submodule concept, the second paragraph highlights the usage of the submodule command, the third parag